feat: opfs vfs checker

Author: subframe7536

src/io/common.ts

@@ -16,6 +16,6 @@ export async function getHandleFromPath(path: string, create?: boolean): Promise
   return await root.getFileHandle(path, { create })
 }
 
-export function isOpfsVFS(vfs: FacadeVFS): boolean {
+export function defaultIsOpfsVFS(vfs: FacadeVFS): boolean {
   return 'releaser' in vfs
 }

src/io/export.ts

@@ -6,7 +6,7 @@ import {
   SQLITE_OPEN_MAIN_DB,
   SQLITE_OPEN_READONLY,
 } from '../constant'
-import { check, getHandleFromPath, ignoredDataView, isOpfsVFS } from './common'
+import { check, defaultIsOpfsVFS, getHandleFromPath, ignoredDataView } from './common'
 
 export function dumpReadableStream(vfs: FacadeVFS, path: string): ReadableStream {
   const source = getExistDataSource(vfs, path)
@@ -109,8 +109,13 @@ export async function streamToUint8Array(stream: ReadableStream): Promise<Uint8A
  * Export database to `Uint8Array`
  * @param vfs SQLite VFS
  * @param path database path
+ * @param isOpfsVFS check if vfs is on OPFS, {@link defaultIsOpfsVFS} by default
  */
-export async function exportDatabase(vfs: FacadeVFS, path: string): Promise<Uint8Array> {
+export async function exportDatabase(
+  vfs: FacadeVFS,
+  path: string,
+  isOpfsVFS = defaultIsOpfsVFS,
+): Promise<Uint8Array> {
   return isOpfsVFS(vfs)
     ? await getHandleFromPath(path)
       .then(handle => handle.getFile())

src/io/import.ts

@@ -14,7 +14,7 @@ import {
   SQLITE_OPEN_READWRITE,
   SQLITE_SYNC_NORMAL,
 } from '../constant'
-import { check, getHandleFromPath, ignoredDataView, isOpfsVFS } from './common'
+import { check, defaultIsOpfsVFS, getHandleFromPath, ignoredDataView } from './common'
 
 const SQLITE_BINARY_HEADER = new Uint8Array([
   0x53, 0x51, 0x4C, 0x69, 0x74, 0x65, 0x20, 0x66, // SQLite f
@@ -139,11 +139,13 @@ async function importDatabaseToOpfs(
  * @param vfs SQLite VFS
  * @param path db path
  * @param data existing database
+ * @param isOpfsVFS check if vfs is on OPFS, {@link defaultIsOpfsVFS} by default
  */
 export async function importDatabase(
   vfs: FacadeVFS,
   path: string,
   data: File | ReadableStream<Uint8Array>,
+  isOpfsVFS = defaultIsOpfsVFS,
 ): Promise<void> {
   const stream = data instanceof globalThis.File ? data.stream() : data
   // is `OPFSCoopSyncVFS`