fix(wa-sqlite): allow long OPFS database paths

.changeset/wa-sqlite-opfs-path-capacity.md

@@ -0,0 +1,5 @@
+---
+'@treecrdt/wa-sqlite': patch
+---
+
+Allow OPFS database paths longer than wa-sqlite's 64-byte VFS default.

packages/treecrdt-wa-sqlite/e2e/tests/lifecycle.spec.ts

@@ -107,9 +107,11 @@ test.describe('browser OPFS lifecycle', () => {
         page.on('console', (msg) => console.log(`[page][${msg.type()}] ${msg.text()}`));
 
         const suffix = `${Date.now().toString(36)}-${Math.random().toString(16).slice(2, 8)}`;
+        const filename = `/lifecycle-${'p'.repeat(48)}-${scenario.runtime}-${suffix}.db`;
+        expect(new TextEncoder().encode(`${filename}-journal`).byteLength).toBeGreaterThan(64);
         const opts = {
           docId: `lifecycle-${scenario.runtime}-${suffix}`,
-          filename: `/lifecycle-${scenario.runtime}-${suffix}.db`,
+          filename,
           runtime: scenario.runtime,
         };
 

packages/treecrdt-wa-sqlite/src/opfs.ts

@@ -124,6 +124,14 @@ export type OpfsVfsOptions = {
   kind?: OpfsVfsKind;
 };
 
+const OPFS_MAX_PATHNAME = 512;
+
+function withOpfsPathCapacity(vfs: any): any {
+  // SQLite appends sidecar suffixes such as "-journal" after checking this capacity.
+  vfs.mxPathname = Math.max(vfs.mxPathname ?? 0, OPFS_MAX_PATHNAME);
+  return vfs;
+}
+
 /**
  * Create an OPFS VFS bound to the provided wa-sqlite Module.
  * Uses local copies of wa-sqlite's example VFS implementations to avoid reaching into vendor paths.
@@ -133,12 +141,14 @@ export async function createOpfsVfs(module: any, opts: OpfsVfsOptions = {}): Pro
   if (opts.kind === 'any-context') {
     // @ts-ignore vendored module lacks type declarations
     const { OPFSAnyContextVFS } = await import('./vendor/OPFSAnyContextVFS.js');
-    return OPFSAnyContextVFS.create(name, module, { lockPolicy: 'exclusive' });
+    return withOpfsPathCapacity(
+      await OPFSAnyContextVFS.create(name, module, { lockPolicy: 'exclusive' }),
+    );
   }
 
   // @ts-ignore vendored module lacks type declarations
   const { OPFSCoopSyncVFS } = await import('./vendor/OPFSCoopSyncVFS.js');
-  return OPFSCoopSyncVFS.create(name, module);
+  return withOpfsPathCapacity(await OPFSCoopSyncVFS.create(name, module));
 }
 
 export type OpenOptions = {