@statewalker/cellb 0.5.2 → 0.6.0

package/dist/ltx/ltx-store-worker.js

@@ -1,35 +1,48 @@
-/// <reference lib="webworker" />
-/**
- * The LTX store as a worker of its own (spawned by a shard worker that runs cells on the LTX
- * VFS): cells' LTX files in an OPFS directory, in celld's layout. The shard connects with
- * `{ op: "init", sab, dir, compactAfter }`, then sends the VFS's requests; answers go into
- * the shared buffer.
- */
 import { BrowserFilesApi } from "@statewalker/webrun-files-browser";
 import { MemFilesApi } from "@statewalker/webrun-files-mem";
+import { rpcFilesClient } from "./files-rpc.js";
 import { ltxCellStore } from "./ltx-page-server.js";
 import { opfsSyncFiles } from "./opfs-sync-files.js";
+async function open(m) {
+    const f = m.files ?? "opfs-sync";
+    if (f === "memory")
+        return { files: new MemFilesApi() };
+    if (typeof f === "object" && "port" in f)
+        // Free space of a FilesApi elsewhere is unknown here: compactions are not held back.
+        return { files: rpcFilesClient(f.port), room: async () => undefined };
+    if (typeof f === "object" && "module" in f) {
+        const mod = (await import(/* @vite-ignore */ f.module));
+        const create = mod.createFilesApi ?? mod.default;
+        if (typeof create !== "function")
+            throw new Error(`ltx store: ${f.module} exports no createFilesApi (or default) function`);
+        const room = mod.room;
+        return {
+            files: await create(f.args),
+            room: room ? () => room(f.args) : async () => undefined,
+        };
+    }
+    const root = await navigator.storage.getDirectory();
+    const dir = await root.getDirectoryHandle(m.dir, { create: true });
+    return { files: f === "opfs" ? new BrowserFilesApi({ rootHandle: dir }) : opfsSyncFiles(dir) };
+}
 let store;
 let ready;
 self.onmessage = (e) => {
     const m = e.data;
     if (m?.op === "init") {
         ready = (async () => {
-            // The cells' FilesApi, by name (an instance cannot cross to this worker): "opfs-sync"
-            // (default: synchronous handles; each file written under a temporary name and moved into
-            // place, so a file being written is never read), "opfs" (OPFS's asynchronous API),
-            // "memory" (nothing kept).
-            const files = m.files === "memory"
-                ? new MemFilesApi()
-                : await (async () => {
-                    const root = await navigator.storage.getDirectory();
-                    const dir = await root.getDirectoryHandle(m.dir, { create: true });
-                    return m.files === "opfs"
-                        ? new BrowserFilesApi({ rootHandle: dir })
-                        : opfsSyncFiles(dir);
-                })();
-            store = ltxCellStore(files, m.sab, { compactAfter: m.compactAfter, lockScope: m.dir });
-            postMessage({ op: "ready" });
+            try {
+                const { files, room } = await open(m);
+                store = ltxCellStore(files, m.sab, {
+                    compactAfter: m.compactAfter,
+                    lockScope: m.dir,
+                    room,
+                });
+                postMessage({ op: "ready" });
+            }
+            catch (err) {
+                postMessage({ op: "failed", error: String(err?.message ?? err) });
+            }
         })();
         return;
     }

package/dist/ltx/ltx-store-worker.js.map

@@ -1 +1 @@
-{"version":3,"file":"ltx-store-worker.js","sourceRoot":"","sources":["../../src/ltx/ltx-store-worker.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,IAAI,KAAkD,CAAC;AACvD,IAAI,KAAgC,CAAC;AACrC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAe,EAAE,EAAE;IACnC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IACjB,IAAI,CAAC,EAAE,EAAE,KAAK,MAAM,EAAE,CAAC;QACrB,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE;YAClB,sFAAsF;YACtF,yFAAyF;YACzF,mFAAmF;YACnF,2BAA2B;YAC3B,MAAM,KAAK,GACT,CAAC,CAAC,KAAK,KAAK,QAAQ;gBAClB,CAAC,CAAC,IAAI,WAAW,EAAE;gBACnB,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;oBAChB,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;oBACpD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;oBACnE,OAAO,CAAC,CAAC,KAAK,KAAK,MAAM;wBACvB,CAAC,CAAC,IAAI,eAAe,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;wBAC1C,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;gBACzB,CAAC,CAAC,EAAE,CAAC;YACX,KAAK,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACvF,WAAW,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/B,CAAC,CAAC,EAAE,CAAC;QACL,OAAO;IACT,CAAC;IACD,KAAK,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3C,CAAC,CAAC","sourcesContent":["/// <reference lib=\"webworker\" />\n/**\n * The LTX store as a worker of its own (spawned by a shard worker that runs cells on the LTX\n * VFS): cells' LTX files in an OPFS directory, in celld's layout. The shard connects with\n * `{ op: \"init\", sab, dir, compactAfter }`, then sends the VFS's requests; answers go into\n * the shared buffer.\n */\nimport { BrowserFilesApi } from \"@statewalker/webrun-files-browser\";\nimport { MemFilesApi } from \"@statewalker/webrun-files-mem\";\nimport { ltxCellStore } from \"./ltx-page-server.js\";\nimport { opfsSyncFiles } from \"./opfs-sync-files.js\";\n\nlet store: ReturnType<typeof ltxCellStore> | undefined;\nlet ready: Promise<void> | undefined;\nself.onmessage = (e: MessageEvent) => {\n  const m = e.data;\n  if (m?.op === \"init\") {\n    ready = (async () => {\n      // The cells' FilesApi, by name (an instance cannot cross to this worker): \"opfs-sync\"\n      // (default: synchronous handles; each file written under a temporary name and moved into\n      // place, so a file being written is never read), \"opfs\" (OPFS's asynchronous API),\n      // \"memory\" (nothing kept).\n      const files =\n        m.files === \"memory\"\n          ? new MemFilesApi()\n          : await (async () => {\n              const root = await navigator.storage.getDirectory();\n              const dir = await root.getDirectoryHandle(m.dir, { create: true });\n              return m.files === \"opfs\"\n                ? new BrowserFilesApi({ rootHandle: dir })\n                : opfsSyncFiles(dir);\n            })();\n      store = ltxCellStore(files, m.sab, { compactAfter: m.compactAfter, lockScope: m.dir });\n      postMessage({ op: \"ready\" });\n    })();\n    return;\n  }\n  void ready?.then(() => store?.handle(m));\n};\n"]}
+{"version":3,"file":"ltx-store-worker.js","sourceRoot":"","sources":["../../src/ltx/ltx-store-worker.ts"],"names":[],"mappings":"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","sourcesContent":["/// <reference lib=\"webworker\" />\n/**\n * The LTX store as a worker of its own (spawned by a shard worker that runs cells on the LTX\n * VFS): cells' LTX files on a FilesApi, in celld's layout. The shard connects with\n * `{ op: \"init\", sab, dir, compactAfter, files, … }` (an `LtxStoreInit`), then sends the VFS's\n * requests; answers go into the shared buffer.\n */\nimport type { FilesApi } from \"@statewalker/webrun-files\";\nimport { BrowserFilesApi } from \"@statewalker/webrun-files-browser\";\nimport { MemFilesApi } from \"@statewalker/webrun-files-mem\";\nimport { rpcFilesClient } from \"./files-rpc.js\";\nimport { type LtxStoreInit, ltxCellStore } from \"./ltx-page-server.js\";\nimport { opfsSyncFiles } from \"./opfs-sync-files.js\";\n\nasync function open(\n  m: LtxStoreInit,\n): Promise<{ files: FilesApi; room?: () => Promise<number | undefined> }> {\n  const f = m.files ?? \"opfs-sync\";\n  if (f === \"memory\") return { files: new MemFilesApi() };\n  if (typeof f === \"object\" && \"port\" in f)\n    // Free space of a FilesApi elsewhere is unknown here: compactions are not held back.\n    return { files: rpcFilesClient(f.port), room: async () => undefined };\n  if (typeof f === \"object\" && \"module\" in f) {\n    const mod = (await import(/* @vite-ignore */ f.module)) as {\n      default?: (args: unknown) => FilesApi | Promise<FilesApi>;\n      createFilesApi?: (args: unknown) => FilesApi | Promise<FilesApi>;\n      room?: (args: unknown) => Promise<number | undefined>;\n    };\n    const create = mod.createFilesApi ?? mod.default;\n    if (typeof create !== \"function\")\n      throw new Error(`ltx store: ${f.module} exports no createFilesApi (or default) function`);\n    const room = mod.room;\n    return {\n      files: await create(f.args),\n      room: room ? () => room(f.args) : async () => undefined,\n    };\n  }\n  const root = await navigator.storage.getDirectory();\n  const dir = await root.getDirectoryHandle(m.dir, { create: true });\n  return { files: f === \"opfs\" ? new BrowserFilesApi({ rootHandle: dir }) : opfsSyncFiles(dir) };\n}\n\nlet store: ReturnType<typeof ltxCellStore> | undefined;\nlet ready: Promise<void> | undefined;\nself.onmessage = (e: MessageEvent) => {\n  const m = e.data;\n  if (m?.op === \"init\") {\n    ready = (async () => {\n      try {\n        const { files, room } = await open(m as LtxStoreInit);\n        store = ltxCellStore(files, m.sab, {\n          compactAfter: m.compactAfter,\n          lockScope: m.dir,\n          room,\n        });\n        postMessage({ op: \"ready\" });\n      } catch (err) {\n        postMessage({ op: \"failed\", error: String((err as Error)?.message ?? err) });\n      }\n    })();\n    return;\n  }\n  void ready?.then(() => store?.handle(m));\n};\n"]}

package/dist/project/browser-host.d.ts

@@ -1,7 +1,9 @@
+import { WasmSqliteDriver } from "../adapters/wasm-sqlite.js";
 import type { AssetFiles } from "../bindings/assets.js";
 import type { WorkersAiOptions } from "../bindings/workers-ai.js";
 import { type ObjectStore } from "../bucket/object-store.js";
 import type { CellRuntimeOptions } from "../core/runtime.js";
+import type { LtxStoreFiles } from "../ltx/ltx-page-server.js";
 import { populatesProcessEnv, processEnvOf, type WranglerConfig } from "./wrangler.js";
 export { populatesProcessEnv, processEnvOf };
 /**
@@ -59,10 +61,24 @@ export type BrowserBucket = {
     leaseTtlMs?: number;
     compactAfter?: number;
     /**
-     * The cells' FilesApi in the store worker: OPFS through synchronous handles (default,
-     * `opfs-sync`), OPFS through its asynchronous API (`opfs`), or memory (nothing kept).
+     * The cells' FilesApi in the store worker. A preset on OPFS directory `ltx`: synchronous
+     * handles (default, `opfs-sync`), OPFS's asynchronous API (`opfs`), or memory (nothing
+     * kept). Or the app's own FilesApi, opened before cellb starts: `{ port }` from
+     * `filesApiPort(files)` (served where the app opened it), or `{ module, args }` (built in
+     * the store worker). `ltx` then names the storage (the scope of the cells' Web Locks).
+     * A port is transferred to the store worker, so it serves one runtime: give each
+     * `browserProjectRuntime` a new `filesApiPort`.
      */
-    files?: "opfs" | "opfs-sync" | "memory";
+    files?: LtxStoreFiles;
+    /**
+     * A store already running elsewhere (`serveLtxStore(files)`, on the page): no store
+     * worker; the VFS sends its reads and commits there. `files` is then ignored. One store
+     * per runtime; the app calls its `close()` when the runtime ends.
+     */
+    ltxStore?: {
+        sab: SharedArrayBuffer;
+        port: MessagePort;
+    };
 } | {
     store: ObjectStore;
     node: string;
@@ -110,6 +126,19 @@ export interface BrowserProjectOptions {
     /** The OpenAI-compatible endpoint behind the project's `ai` binding (Workers AI). */
     ai?: WorkersAiOptions;
 }
+/**
+ * Cells on the LTX VFS: each cell is a SQLite database whose main file is its LTX files, read
+ * page by page (src/adapters/ltx-vfs.ts) from a store: a store worker of this worker's own (on
+ * OPFS, memory, or the app's FilesApi through a port or a module), or a store the app runs
+ * elsewhere (`ltxStore`).
+ */
+export declare function ltxOpener(sqlite3: unknown, dir: string, compactAfter?: number, files?: LtxStoreFiles, ltxStore?: {
+    sab: SharedArrayBuffer;
+    port: MessagePort;
+}): Promise<((cellKey: string) => WasmSqliteDriver) & {
+    release: () => void;
+    reserve: (n: number) => Promise<number>;
+}>;
 /**
  * A project's runtime in this worker: installs the Workers globals, imports the code and
  * builds its Worker Loader; `close()` also releases the node's bucket lease.

package/dist/project/browser-host.js

@@ -28,21 +28,50 @@ async function bucketStore(b) {
     return filesApiObjectStore(new BrowserFilesApi({ rootHandle: await root.getDirectoryHandle(b.opfs, { create: true }) }), "");
 }
 /**
- * Cells on the LTX VFS: a store worker owns the OPFS directory; each cell is a SQLite database
- * whose main file is its LTX files, read page by page (src/adapters/ltx-vfs.ts).
+ * Cells on the LTX VFS: each cell is a SQLite database whose main file is its LTX files, read
+ * page by page (src/adapters/ltx-vfs.ts) from a store: a store worker of this worker's own (on
+ * OPFS, memory, or the app's FilesApi through a port or a module), or a store the app runs
+ * elsewhere (`ltxStore`).
  */
-async function ltxOpener(sqlite3, dir, compactAfter, files) {
-    const store = new Worker(new URL("../ltx/ltx-store-worker.js", import.meta.url) /* `.js` in dist/ (scripts/build.mjs) */, { type: "module" });
-    const sab = new SharedArrayBuffer(8 + 16 * 65536); // room for a read-ahead run of 64 KiB pages
-    // Wait until the store worker runs before any synchronous call: a nested worker is started
-    // (its script fetched) through this worker's event loop, which Atomics.wait would block.
-    const ready = new Promise((resolve, reject) => {
-        store.addEventListener("message", (e) => e.data?.op === "ready" && resolve(), { once: false });
-        store.addEventListener("error", (e) => reject(new Error(`ltx store worker: ${e.message}`)));
-    });
-    store.postMessage({ op: "init", sab, dir, compactAfter, files });
-    await ready;
-    const { name } = installLtxVfs(sqlite3, { sab, post: (m) => store.postMessage(m) });
+export async function ltxOpener(sqlite3, dir, compactAfter, files, ltxStore) {
+    let sab;
+    let post;
+    let release;
+    if (ltxStore) {
+        // The store runs elsewhere (serveLtxStore): only the VFS here.
+        sab = ltxStore.sab;
+        const port = ltxStore.port;
+        post = (m) => port.postMessage(m);
+        release = () => port.close();
+    }
+    else {
+        const store = new Worker(new URL("../ltx/ltx-store-worker.js", import.meta.url) /* `.js` in dist/ (scripts/build.mjs) */, { type: "module" });
+        sab = new SharedArrayBuffer(8 + 16 * 65536); // room for a read-ahead run of 64 KiB pages
+        // Wait until the store worker runs before any synchronous call: a nested worker is started
+        // (its script fetched) through this worker's event loop, which Atomics.wait would block.
+        const ready = new Promise((resolve, reject) => {
+            store.addEventListener("message", (e) => {
+                if (e.data?.op === "ready")
+                    resolve();
+                else if (e.data?.op === "failed")
+                    reject(new Error(`ltx store worker: ${e.data.error}`));
+            });
+            store.addEventListener("error", (e) => reject(new Error(`ltx store worker: ${e.message}`)));
+        });
+        // A port to the app's FilesApi moves on to the store worker.
+        const transfer = files && typeof files === "object" && "port" in files ? [files.port] : [];
+        try {
+            store.postMessage({ op: "init", sab, dir, compactAfter, files }, transfer);
+            await ready;
+        }
+        catch (err) {
+            store.terminate(); // a store worker that did not start is not left behind
+            throw err;
+        }
+        post = (m) => store.postMessage(m);
+        release = () => store.terminate();
+    }
+    const { name } = installLtxVfs(sqlite3, { sab, post });
     const s3 = sqlite3;
     const open = (cellKey) => {
         const db = new s3.oo1.DB({ filename: cellKey, vfs: name, flags: "c" });
@@ -52,9 +81,7 @@ async function ltxOpener(sqlite3, dir, compactAfter, files) {
         return new WasmSqliteDriver(db, undefined, undefined, sqlite3.capi);
     };
     return Object.assign(open, {
-        release() {
-            store.terminate();
-        },
+        release,
         reserve: async (n) => n,
     });
 }
@@ -128,7 +155,7 @@ export async function browserProjectRuntime(opts) {
     const site = "site" in opts.code ? opts.code.site : undefined;
     // With an IndexedDB bucket, cells live in memory and in the bucket's logs (no OPFS pool).
     const openSql = opts.bucket && "ltx" in opts.bucket
-        ? await ltxOpener(opts.sqlite3, opts.bucket.ltx, opts.bucket.compactAfter, opts.bucket.files)
+        ? await ltxOpener(opts.sqlite3, opts.bucket.ltx, opts.bucket.compactAfter, opts.bucket.files, opts.bucket.ltxStore)
         : opts.bucket && "idb" in opts.bucket
             ? Object.assign(wasmMemoryOpener(opts.sqlite3), {
                 release() { },

package/dist/project/browser-host.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-host.js","sourceRoot":"","sources":["../../src/project/browser-host.ts"],"names":[],"mappings":"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","sourcesContent":["import { BrowserFilesApi } from \"@statewalker/webrun-files-browser\";\nimport { installLtxVfs } from \"../adapters/ltx-vfs.js\";\nimport {\n  sahpoolOpener,\n  tuneCellConnection,\n  WasmSqliteDriver,\n  wasmMemoryOpener,\n} from \"../adapters/wasm-sqlite.js\";\nimport type { AssetFiles } from \"../bindings/assets.js\";\nimport type { WorkersAiOptions } from \"../bindings/workers-ai.js\";\nimport { celldBucket } from \"../bucket/celld-cells.js\";\nimport { idbObjectStore } from \"../bucket/idb-object-store.js\";\nimport { filesApiObjectStore, type ObjectStore } from \"../bucket/object-store.js\";\nimport { s3ObjectStore } from \"../bucket/s3-object-store.js\";\nimport type { CellRuntimeOptions, WorkerModule } from \"../core/runtime.js\";\nimport { browserIsolatedLoader } from \"../isolate/browser.js\";\nimport { installAsyncContext } from \"../node-compat/async_hooks.js\";\nimport { installNodeGlobals } from \"../node-compat/install.js\";\nimport { browserModuleLoader } from \"./browser-modules.js\";\nimport * as workersModule from \"./cloudflare-workers.js\";\nimport { siteModuleLoader, workersHostRegistry } from \"./site-loader.js\";\nimport { type WorkerScope, workerScope } from \"./worker-scope.js\";\nimport * as workersGlobals from \"./workers-globals-module.js\";\nimport {\n  createProjectRuntime,\n  loadTimeEnv,\n  populatesProcessEnv,\n  processEnvOf,\n  type WranglerConfig,\n} from \"./wrangler.js\";\n\nexport { populatesProcessEnv, processEnvOf };\n\n/**\n * Where a browser-hosted project keeps its cells when they must outlive the page or move to\n * other nodes: a celld fleet bucket. Cells, facets and alarms are then exactly celld's\n * (ownership in `own.json`, LTX logs, wake index) and R2 objects live in it too, so the same\n * cells can be served by this browser, by other browsers and by celld nodes, in turn.\n *\n * - `s3`: an S3-compatible bucket, reached directly (the bucket must allow CORS for the page's\n *   origin: methods GET/PUT/DELETE/HEAD, request headers `authorization`, `content-type`,\n *   `x-amz-*`, `if-match`, `if-none-match`; exposed headers `etag`, `last-modified`,\n *   `x-amz-meta-celld-r2`) or through a same-origin proxy (`endpoint` = the proxy,\n *   `signAs` = the real endpoint: SigV4 signs the real host and path).\n * - `opfs`: a bucket in this origin's OPFS — persistence without a server. Conditional writes\n *   are atomic only within one writer, so one tab or worker at a time should own its cells.\n * - `store`: any ObjectStore.\n */\nexport type BrowserBucket =\n  | {\n      s3: {\n        endpoint: string;\n        signAs?: string;\n        bucket: string;\n        prefix?: string;\n        region?: string;\n        accessKeyId: string;\n        secretAccessKey: string;\n      };\n      node: string;\n      leaseTtlMs?: number;\n    }\n  | { opfs: string; node: string; leaseTtlMs?: number }\n  /**\n   * `idb`: a bucket in this origin's IndexedDB (atomic conditional writes across tabs and\n   * workers). Cells then run SQLite in memory and persist through the bucket's page-level logs:\n   * no OPFS pool, so any number of workers can serve cells at once.\n   */\n  | { idb: string; node: string; leaseTtlMs?: number }\n  /**\n   * `ltx`: cells as celld keeps them, LTX files (a snapshot and one file per commit) in an OPFS\n   * directory, read page by page (a SQLite VFS over a store worker): no OPFS pool, and a\n   * cell's memory is its page cache, not its database. A cell is folded into one snapshot\n   * (streamed) past `compactAfter` files (default 64), or once the files after its snapshot hold\n   * more than half of it. See docs/browser-host.md.\n   */\n  | {\n      ltx: string;\n      node: string;\n      leaseTtlMs?: number;\n      compactAfter?: number;\n      /**\n       * The cells' FilesApi in the store worker: OPFS through synchronous handles (default,\n       * `opfs-sync`), OPFS through its asynchronous API (`opfs`), or memory (nothing kept).\n       */\n      files?: \"opfs\" | \"opfs-sync\" | \"memory\";\n    }\n  | { store: ObjectStore; node: string; leaseTtlMs?: number };\n\nexport interface BrowserProjectOptions {\n  config: WranglerConfig;\n  /**\n   * The project's Worker code, imported in this realm once its Workers globals (and with\n   * nodejs_compat `Buffer` and `process`) are installed:\n   * - `bundle`: one ES module built for browsers (`bundleWorkerForBrowser`), whose\n   *   `cloudflare:workers` is `PROJECT_WORKERS_MODULE_SHIM` and whose Workers globals read\n   *   `globalThis.__cellsGlobals`\n   *   (`null`: the project has no `main`). Worker Loader code becomes Blob-URL modules.\n   * - `site`: the base URL of the project's site (`createProjectSite`, hosted by\n   *   webrun-site-host). `main` and Worker Loader code are imported from it.\n   */\n  code: { bundle: string | null } | { site: string };\n  /**\n   * A Dedicated Worker script that serves one loaded Worker (`serveIsolate`): Worker Loader\n   * code then runs isolated, one Dedicated Worker per loaded Worker, as celld's isolates.\n   * The package ships one: `@statewalker/cellb/isolate-worker`. A function instead starts the\n   * Dedicated Worker itself (`() => new Worker(new URL(…, import.meta.url), { type: \"module\" })`,\n   * a form bundlers follow).\n   */\n  isolateScript?: URL | (() => Worker);\n  /** An initialized SQLite WASM module (`@sqlite.org/sqlite-wasm`). */\n  sqlite3: unknown;\n  /** OPFS sahpool name for this host's SQLite files (one pool per worker). */\n  pool: string;\n  /** OPFS directory for the project's FilesApi (Workers' fs-like bindings, R2 without bucket). */\n  filesDir: string;\n  assetFiles?: AssetFiles;\n  bucket?: BrowserBucket;\n  /**\n   * Cells this runtime does not host: where to send their events (a `Send` over a MessagePort\n   * to the runtime that hosts them, `linkOverPort`), or undefined to host the cell here. With\n   * one runtime per worker and `shardOf` as the placement, cells run in parallel threads.\n   */\n  route?: CellRuntimeOptions[\"route\"];\n  /** The OpenAI-compatible endpoint behind the project's `ai` binding (Workers AI). */\n  ai?: WorkersAiOptions;\n}\n\nasync function bucketStore(b: BrowserBucket): Promise<ObjectStore> {\n  if (\"store\" in b) return b.store;\n  if (\"s3\" in b) return s3ObjectStore({ region: \"us-east-1\", ...b.s3 });\n  if (\"idb\" in b) return idbObjectStore(b.idb);\n  if (\"ltx\" in b) throw new Error(\"an ltx directory is cell storage, not a bucket\");\n  const root = await navigator.storage.getDirectory();\n  return filesApiObjectStore(\n    new BrowserFilesApi({ rootHandle: await root.getDirectoryHandle(b.opfs, { create: true }) }),\n    \"\",\n  );\n}\n\n/**\n * Cells on the LTX VFS: a store worker owns the OPFS directory; each cell is a SQLite database\n * whose main file is its LTX files, read page by page (src/adapters/ltx-vfs.ts).\n */\nasync function ltxOpener(sqlite3: unknown, dir: string, compactAfter?: number, files?: string) {\n  const store = new Worker(\n    new URL(\"../ltx/ltx-store-worker.ts\", import.meta.url) /* `.js` in dist/ (scripts/build.mjs) */,\n    { type: \"module\" },\n  );\n  const sab = new SharedArrayBuffer(8 + 16 * 65536); // room for a read-ahead run of 64 KiB pages\n  // Wait until the store worker runs before any synchronous call: a nested worker is started\n  // (its script fetched) through this worker's event loop, which Atomics.wait would block.\n  const ready = new Promise<void>((resolve, reject) => {\n    store.addEventListener(\"message\", (e) => e.data?.op === \"ready\" && resolve(), { once: false });\n    store.addEventListener(\"error\", (e) => reject(new Error(`ltx store worker: ${e.message}`)));\n  });\n  store.postMessage({ op: \"init\", sab, dir, compactAfter, files });\n  await ready;\n  const { name } = installLtxVfs(sqlite3, { sab, post: (m) => store.postMessage(m) });\n  const s3 = sqlite3 as { oo1: { DB: new (o: Record<string, unknown>) => any } };\n  const open = (cellKey: string) => {\n    const db = new s3.oo1.DB({ filename: cellKey, vfs: name, flags: \"c\" });\n    tuneCellConnection(sqlite3, db);\n    db.exec(\"PRAGMA journal_mode=MEMORY; PRAGMA synchronous=FULL;\");\n    // SQLite's C API for inTransaction() only (no page hook or session capture on this VFS).\n    return new WasmSqliteDriver(db, undefined, undefined, (sqlite3 as { capi: never }).capi);\n  };\n  return Object.assign(open, {\n    release() {\n      store.terminate();\n    },\n    reserve: async (n: number) => n,\n  });\n}\n\n/** Installs the Workers globals the code reads, then imports its `main`. */\nasync function importWorkerCode(\n  config: WranglerConfig,\n  code: BrowserProjectOptions[\"code\"],\n  scope: WorkerScope,\n): Promise<WorkerModule> {\n  const flags = config.compatibility_flags ?? [];\n  const nodeCompat = flags.some((f) => f.startsWith(\"nodejs_compat\"));\n  if (nodeCompat) {\n    installNodeGlobals();\n    // node:* for bundles built with cellbHostModule (another bundler than bundleWorkerForBrowser);\n    // loaded after installNodeGlobals(), as the npm `util` polyfill reads `process`.\n    (globalThis as Record<string, unknown>).__cellsNodeModules = (\n      await import(\"../node-compat/browser-registry.js\")\n    ).nodeRegistryEntries;\n    if (populatesProcessEnv(config)) {\n      const env = processEnvOf(config);\n      // The bundle's own `process` reads it when evaluated; a site's modules use this realm's.\n      (globalThis as Record<string, unknown>).__cellsProcessEnv = env;\n      Object.assign((globalThis as { process: { env: Record<string, string> } }).process.env, env);\n    }\n    // node:async_hooks: continuations carry their AsyncLocalStorage stores (with AsyncContext\n    // the engine does, and this installs nothing). The code's awaits are lowered so that they go\n    // through them: by bundleWorkerForBrowser for a bundle, by createProjectSite (nodeCompat) for\n    // a site's modules.\n    installAsyncContext();\n  }\n  const globals = {\n    ...workersGlobals,\n    Request: workersGlobals.CellsRequest,\n    Response: workersGlobals.CellsResponse,\n    WebSocketPair: flags.includes(\"websocket_standard_binary_type\")\n      ? workersGlobals.StandardWebSocketPair\n      : workersGlobals.WebSocketPair,\n  };\n  if (\"site\" in code) {\n    workersHostRegistry({\n      workersModule,\n      projectWorkersModule: {\n        ...workersModule,\n        env: scope.env,\n        exports: scope.exports,\n        waitUntil: scope.waitUntil,\n      },\n      loadedPrefix: `${code.site}loaded/`,\n      emailModule: await import(\"./cloudflare-email.js\"),\n      ...globals,\n      // Loaded on demand, after installNodeGlobals(): the npm `util` polyfill reads `process`\n      // when it is imported.\n      node: nodeCompat\n        ? (await import(\"../node-compat/browser-registry.js\")).nodeRegistryEntries\n        : undefined,\n    });\n    return config.main\n      ? await import(/* @vite-ignore */ `${code.site}modules/~/${config.main}`)\n      : { default: {} };\n  }\n  const g = globalThis as Record<string, unknown>;\n  g.__cellsWorkersModule = workersModule;\n  g.__cellsProjectScope = scope; // `env` and `exports` of the bundle's cloudflare:workers\n  g.__cellsGlobals = globals;\n  return code.bundle\n    ? await import(\n        /* @vite-ignore */ URL.createObjectURL(new Blob([code.bundle], { type: \"text/javascript\" }))\n      )\n    : { default: {} };\n}\n\n/**\n * A project's runtime in this worker: installs the Workers globals, imports the code and\n * builds its Worker Loader; `close()` also releases the node's bucket lease.\n */\nexport async function browserProjectRuntime(opts: BrowserProjectOptions) {\n  const scope = workerScope(loadTimeEnv(opts.config, opts.ai));\n  const module = await importWorkerCode(opts.config, opts.code, scope);\n  const site = \"site\" in opts.code ? opts.code.site : undefined;\n  // With an IndexedDB bucket, cells live in memory and in the bucket's logs (no OPFS pool).\n  const openSql =\n    opts.bucket && \"ltx\" in opts.bucket\n      ? await ltxOpener(opts.sqlite3, opts.bucket.ltx, opts.bucket.compactAfter, opts.bucket.files)\n      : opts.bucket && \"idb\" in opts.bucket\n        ? Object.assign(wasmMemoryOpener(opts.sqlite3 as never), {\n            release() {},\n            reserve: async (n: number) => n,\n          })\n        : await sahpoolOpener(opts.sqlite3 as never, {\n            name: opts.pool,\n            initialCapacity: 64, // grows on demand (sahpoolOpener)\n          });\n  const root = await navigator.storage.getDirectory();\n  const files = new BrowserFilesApi({\n    rootHandle: await root.getDirectoryHandle(opts.filesDir, { create: true }),\n  });\n  // An `ltx` directory is the cells' own storage (the VFS), not a fleet bucket.\n  const store = opts.bucket && !(\"ltx\" in opts.bucket) ? await bucketStore(opts.bucket) : undefined;\n  const shared =\n    opts.bucket && store\n      ? celldBucket(store, { node: opts.bucket.node, leaseTtlMs: opts.bucket.leaseTtlMs })\n      : undefined;\n  const { runtime, unsupported } = createProjectRuntime(opts.config, module, {\n    openSql,\n    files,\n    assetFiles: opts.assetFiles,\n    loadModules: site ? siteModuleLoader(site) : browserModuleLoader(),\n    isolatedModules: opts.isolateScript\n      ? browserIsolatedLoader({\n          isolateScript: opts.isolateScript,\n          siteBaseUrl: site,\n          storagePrefix: `${opts.pool}-iso`,\n          storage: () => shared, // facets of loaded code are logged like the root's own\n        })\n      : undefined,\n    storage: shared, // R2 objects in the fleet bucket too, as celld keeps them\n    route: opts.route,\n    ai: opts.ai,\n  });\n  scope.bind(runtime);\n  return {\n    runtime,\n    unsupported,\n    bucket: shared,\n    close: async () => {\n      await runtime.close();\n      openSql.release(); // the pool's files, for the next worker that opens it\n    },\n  };\n}\n"]}
+{"version":3,"file":"browser-host.js","sourceRoot":"","sources":["../../src/project/browser-host.ts"],"names":[],"mappings":"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","sourcesContent":["import { BrowserFilesApi } from \"@statewalker/webrun-files-browser\";\nimport { installLtxVfs } from \"../adapters/ltx-vfs.js\";\nimport {\n  sahpoolOpener,\n  tuneCellConnection,\n  WasmSqliteDriver,\n  wasmMemoryOpener,\n} from \"../adapters/wasm-sqlite.js\";\nimport type { AssetFiles } from \"../bindings/assets.js\";\nimport type { WorkersAiOptions } from \"../bindings/workers-ai.js\";\nimport { celldBucket } from \"../bucket/celld-cells.js\";\nimport { idbObjectStore } from \"../bucket/idb-object-store.js\";\nimport { filesApiObjectStore, type ObjectStore } from \"../bucket/object-store.js\";\nimport { s3ObjectStore } from \"../bucket/s3-object-store.js\";\nimport type { CellRuntimeOptions, WorkerModule } from \"../core/runtime.js\";\nimport { browserIsolatedLoader } from \"../isolate/browser.js\";\nimport type { LtxStoreFiles } from \"../ltx/ltx-page-server.js\";\nimport { installAsyncContext } from \"../node-compat/async_hooks.js\";\nimport { installNodeGlobals } from \"../node-compat/install.js\";\nimport { browserModuleLoader } from \"./browser-modules.js\";\nimport * as workersModule from \"./cloudflare-workers.js\";\nimport { siteModuleLoader, workersHostRegistry } from \"./site-loader.js\";\nimport { type WorkerScope, workerScope } from \"./worker-scope.js\";\nimport * as workersGlobals from \"./workers-globals-module.js\";\nimport {\n  createProjectRuntime,\n  loadTimeEnv,\n  populatesProcessEnv,\n  processEnvOf,\n  type WranglerConfig,\n} from \"./wrangler.js\";\n\nexport { populatesProcessEnv, processEnvOf };\n\n/**\n * Where a browser-hosted project keeps its cells when they must outlive the page or move to\n * other nodes: a celld fleet bucket. Cells, facets and alarms are then exactly celld's\n * (ownership in `own.json`, LTX logs, wake index) and R2 objects live in it too, so the same\n * cells can be served by this browser, by other browsers and by celld nodes, in turn.\n *\n * - `s3`: an S3-compatible bucket, reached directly (the bucket must allow CORS for the page's\n *   origin: methods GET/PUT/DELETE/HEAD, request headers `authorization`, `content-type`,\n *   `x-amz-*`, `if-match`, `if-none-match`; exposed headers `etag`, `last-modified`,\n *   `x-amz-meta-celld-r2`) or through a same-origin proxy (`endpoint` = the proxy,\n *   `signAs` = the real endpoint: SigV4 signs the real host and path).\n * - `opfs`: a bucket in this origin's OPFS — persistence without a server. Conditional writes\n *   are atomic only within one writer, so one tab or worker at a time should own its cells.\n * - `store`: any ObjectStore.\n */\nexport type BrowserBucket =\n  | {\n      s3: {\n        endpoint: string;\n        signAs?: string;\n        bucket: string;\n        prefix?: string;\n        region?: string;\n        accessKeyId: string;\n        secretAccessKey: string;\n      };\n      node: string;\n      leaseTtlMs?: number;\n    }\n  | { opfs: string; node: string; leaseTtlMs?: number }\n  /**\n   * `idb`: a bucket in this origin's IndexedDB (atomic conditional writes across tabs and\n   * workers). Cells then run SQLite in memory and persist through the bucket's page-level logs:\n   * no OPFS pool, so any number of workers can serve cells at once.\n   */\n  | { idb: string; node: string; leaseTtlMs?: number }\n  /**\n   * `ltx`: cells as celld keeps them, LTX files (a snapshot and one file per commit) in an OPFS\n   * directory, read page by page (a SQLite VFS over a store worker): no OPFS pool, and a\n   * cell's memory is its page cache, not its database. A cell is folded into one snapshot\n   * (streamed) past `compactAfter` files (default 64), or once the files after its snapshot hold\n   * more than half of it. See docs/browser-host.md.\n   */\n  | {\n      ltx: string;\n      node: string;\n      leaseTtlMs?: number;\n      compactAfter?: number;\n      /**\n       * The cells' FilesApi in the store worker. A preset on OPFS directory `ltx`: synchronous\n       * handles (default, `opfs-sync`), OPFS's asynchronous API (`opfs`), or memory (nothing\n       * kept). Or the app's own FilesApi, opened before cellb starts: `{ port }` from\n       * `filesApiPort(files)` (served where the app opened it), or `{ module, args }` (built in\n       * the store worker). `ltx` then names the storage (the scope of the cells' Web Locks).\n       * A port is transferred to the store worker, so it serves one runtime: give each\n       * `browserProjectRuntime` a new `filesApiPort`.\n       */\n      files?: LtxStoreFiles;\n      /**\n       * A store already running elsewhere (`serveLtxStore(files)`, on the page): no store\n       * worker; the VFS sends its reads and commits there. `files` is then ignored. One store\n       * per runtime; the app calls its `close()` when the runtime ends.\n       */\n      ltxStore?: { sab: SharedArrayBuffer; port: MessagePort };\n    }\n  | { store: ObjectStore; node: string; leaseTtlMs?: number };\n\nexport interface BrowserProjectOptions {\n  config: WranglerConfig;\n  /**\n   * The project's Worker code, imported in this realm once its Workers globals (and with\n   * nodejs_compat `Buffer` and `process`) are installed:\n   * - `bundle`: one ES module built for browsers (`bundleWorkerForBrowser`), whose\n   *   `cloudflare:workers` is `PROJECT_WORKERS_MODULE_SHIM` and whose Workers globals read\n   *   `globalThis.__cellsGlobals`\n   *   (`null`: the project has no `main`). Worker Loader code becomes Blob-URL modules.\n   * - `site`: the base URL of the project's site (`createProjectSite`, hosted by\n   *   webrun-site-host). `main` and Worker Loader code are imported from it.\n   */\n  code: { bundle: string | null } | { site: string };\n  /**\n   * A Dedicated Worker script that serves one loaded Worker (`serveIsolate`): Worker Loader\n   * code then runs isolated, one Dedicated Worker per loaded Worker, as celld's isolates.\n   * The package ships one: `@statewalker/cellb/isolate-worker`. A function instead starts the\n   * Dedicated Worker itself (`() => new Worker(new URL(…, import.meta.url), { type: \"module\" })`,\n   * a form bundlers follow).\n   */\n  isolateScript?: URL | (() => Worker);\n  /** An initialized SQLite WASM module (`@sqlite.org/sqlite-wasm`). */\n  sqlite3: unknown;\n  /** OPFS sahpool name for this host's SQLite files (one pool per worker). */\n  pool: string;\n  /** OPFS directory for the project's FilesApi (Workers' fs-like bindings, R2 without bucket). */\n  filesDir: string;\n  assetFiles?: AssetFiles;\n  bucket?: BrowserBucket;\n  /**\n   * Cells this runtime does not host: where to send their events (a `Send` over a MessagePort\n   * to the runtime that hosts them, `linkOverPort`), or undefined to host the cell here. With\n   * one runtime per worker and `shardOf` as the placement, cells run in parallel threads.\n   */\n  route?: CellRuntimeOptions[\"route\"];\n  /** The OpenAI-compatible endpoint behind the project's `ai` binding (Workers AI). */\n  ai?: WorkersAiOptions;\n}\n\nasync function bucketStore(b: BrowserBucket): Promise<ObjectStore> {\n  if (\"store\" in b) return b.store;\n  if (\"s3\" in b) return s3ObjectStore({ region: \"us-east-1\", ...b.s3 });\n  if (\"idb\" in b) return idbObjectStore(b.idb);\n  if (\"ltx\" in b) throw new Error(\"an ltx directory is cell storage, not a bucket\");\n  const root = await navigator.storage.getDirectory();\n  return filesApiObjectStore(\n    new BrowserFilesApi({ rootHandle: await root.getDirectoryHandle(b.opfs, { create: true }) }),\n    \"\",\n  );\n}\n\n/**\n * Cells on the LTX VFS: each cell is a SQLite database whose main file is its LTX files, read\n * page by page (src/adapters/ltx-vfs.ts) from a store: a store worker of this worker's own (on\n * OPFS, memory, or the app's FilesApi through a port or a module), or a store the app runs\n * elsewhere (`ltxStore`).\n */\nexport async function ltxOpener(\n  sqlite3: unknown,\n  dir: string,\n  compactAfter?: number,\n  files?: LtxStoreFiles,\n  ltxStore?: { sab: SharedArrayBuffer; port: MessagePort },\n) {\n  let sab: SharedArrayBuffer;\n  let post: (m: unknown) => void;\n  let release: () => void;\n  if (ltxStore) {\n    // The store runs elsewhere (serveLtxStore): only the VFS here.\n    sab = ltxStore.sab;\n    const port = ltxStore.port;\n    post = (m) => port.postMessage(m);\n    release = () => port.close();\n  } else {\n    const store = new Worker(\n      new URL(\n        \"../ltx/ltx-store-worker.ts\",\n        import.meta.url,\n      ) /* `.js` in dist/ (scripts/build.mjs) */,\n      { type: \"module\" },\n    );\n    sab = new SharedArrayBuffer(8 + 16 * 65536); // room for a read-ahead run of 64 KiB pages\n    // Wait until the store worker runs before any synchronous call: a nested worker is started\n    // (its script fetched) through this worker's event loop, which Atomics.wait would block.\n    const ready = new Promise<void>((resolve, reject) => {\n      store.addEventListener(\"message\", (e) => {\n        if (e.data?.op === \"ready\") resolve();\n        else if (e.data?.op === \"failed\")\n          reject(new Error(`ltx store worker: ${e.data.error as string}`));\n      });\n      store.addEventListener(\"error\", (e) => reject(new Error(`ltx store worker: ${e.message}`)));\n    });\n    // A port to the app's FilesApi moves on to the store worker.\n    const transfer = files && typeof files === \"object\" && \"port\" in files ? [files.port] : [];\n    try {\n      store.postMessage({ op: \"init\", sab, dir, compactAfter, files }, transfer);\n      await ready;\n    } catch (err) {\n      store.terminate(); // a store worker that did not start is not left behind\n      throw err;\n    }\n    post = (m) => store.postMessage(m);\n    release = () => store.terminate();\n  }\n  const { name } = installLtxVfs(sqlite3, { sab, post });\n  const s3 = sqlite3 as { oo1: { DB: new (o: Record<string, unknown>) => any } };\n  const open = (cellKey: string) => {\n    const db = new s3.oo1.DB({ filename: cellKey, vfs: name, flags: \"c\" });\n    tuneCellConnection(sqlite3, db);\n    db.exec(\"PRAGMA journal_mode=MEMORY; PRAGMA synchronous=FULL;\");\n    // SQLite's C API for inTransaction() only (no page hook or session capture on this VFS).\n    return new WasmSqliteDriver(db, undefined, undefined, (sqlite3 as { capi: never }).capi);\n  };\n  return Object.assign(open, {\n    release,\n    reserve: async (n: number) => n,\n  });\n}\n\n/** Installs the Workers globals the code reads, then imports its `main`. */\nasync function importWorkerCode(\n  config: WranglerConfig,\n  code: BrowserProjectOptions[\"code\"],\n  scope: WorkerScope,\n): Promise<WorkerModule> {\n  const flags = config.compatibility_flags ?? [];\n  const nodeCompat = flags.some((f) => f.startsWith(\"nodejs_compat\"));\n  if (nodeCompat) {\n    installNodeGlobals();\n    // node:* for bundles built with cellbHostModule (another bundler than bundleWorkerForBrowser);\n    // loaded after installNodeGlobals(), as the npm `util` polyfill reads `process`.\n    (globalThis as Record<string, unknown>).__cellsNodeModules = (\n      await import(\"../node-compat/browser-registry.js\")\n    ).nodeRegistryEntries;\n    if (populatesProcessEnv(config)) {\n      const env = processEnvOf(config);\n      // The bundle's own `process` reads it when evaluated; a site's modules use this realm's.\n      (globalThis as Record<string, unknown>).__cellsProcessEnv = env;\n      Object.assign((globalThis as { process: { env: Record<string, string> } }).process.env, env);\n    }\n    // node:async_hooks: continuations carry their AsyncLocalStorage stores (with AsyncContext\n    // the engine does, and this installs nothing). The code's awaits are lowered so that they go\n    // through them: by bundleWorkerForBrowser for a bundle, by createProjectSite (nodeCompat) for\n    // a site's modules.\n    installAsyncContext();\n  }\n  const globals = {\n    ...workersGlobals,\n    Request: workersGlobals.CellsRequest,\n    Response: workersGlobals.CellsResponse,\n    WebSocketPair: flags.includes(\"websocket_standard_binary_type\")\n      ? workersGlobals.StandardWebSocketPair\n      : workersGlobals.WebSocketPair,\n  };\n  if (\"site\" in code) {\n    workersHostRegistry({\n      workersModule,\n      projectWorkersModule: {\n        ...workersModule,\n        env: scope.env,\n        exports: scope.exports,\n        waitUntil: scope.waitUntil,\n      },\n      loadedPrefix: `${code.site}loaded/`,\n      emailModule: await import(\"./cloudflare-email.js\"),\n      ...globals,\n      // Loaded on demand, after installNodeGlobals(): the npm `util` polyfill reads `process`\n      // when it is imported.\n      node: nodeCompat\n        ? (await import(\"../node-compat/browser-registry.js\")).nodeRegistryEntries\n        : undefined,\n    });\n    return config.main\n      ? await import(/* @vite-ignore */ `${code.site}modules/~/${config.main}`)\n      : { default: {} };\n  }\n  const g = globalThis as Record<string, unknown>;\n  g.__cellsWorkersModule = workersModule;\n  g.__cellsProjectScope = scope; // `env` and `exports` of the bundle's cloudflare:workers\n  g.__cellsGlobals = globals;\n  return code.bundle\n    ? await import(\n        /* @vite-ignore */ URL.createObjectURL(new Blob([code.bundle], { type: \"text/javascript\" }))\n      )\n    : { default: {} };\n}\n\n/**\n * A project's runtime in this worker: installs the Workers globals, imports the code and\n * builds its Worker Loader; `close()` also releases the node's bucket lease.\n */\nexport async function browserProjectRuntime(opts: BrowserProjectOptions) {\n  const scope = workerScope(loadTimeEnv(opts.config, opts.ai));\n  const module = await importWorkerCode(opts.config, opts.code, scope);\n  const site = \"site\" in opts.code ? opts.code.site : undefined;\n  // With an IndexedDB bucket, cells live in memory and in the bucket's logs (no OPFS pool).\n  const openSql =\n    opts.bucket && \"ltx\" in opts.bucket\n      ? await ltxOpener(\n          opts.sqlite3,\n          opts.bucket.ltx,\n          opts.bucket.compactAfter,\n          opts.bucket.files,\n          opts.bucket.ltxStore,\n        )\n      : opts.bucket && \"idb\" in opts.bucket\n        ? Object.assign(wasmMemoryOpener(opts.sqlite3 as never), {\n            release() {},\n            reserve: async (n: number) => n,\n          })\n        : await sahpoolOpener(opts.sqlite3 as never, {\n            name: opts.pool,\n            initialCapacity: 64, // grows on demand (sahpoolOpener)\n          });\n  const root = await navigator.storage.getDirectory();\n  const files = new BrowserFilesApi({\n    rootHandle: await root.getDirectoryHandle(opts.filesDir, { create: true }),\n  });\n  // An `ltx` directory is the cells' own storage (the VFS), not a fleet bucket.\n  const store = opts.bucket && !(\"ltx\" in opts.bucket) ? await bucketStore(opts.bucket) : undefined;\n  const shared =\n    opts.bucket && store\n      ? celldBucket(store, { node: opts.bucket.node, leaseTtlMs: opts.bucket.leaseTtlMs })\n      : undefined;\n  const { runtime, unsupported } = createProjectRuntime(opts.config, module, {\n    openSql,\n    files,\n    assetFiles: opts.assetFiles,\n    loadModules: site ? siteModuleLoader(site) : browserModuleLoader(),\n    isolatedModules: opts.isolateScript\n      ? browserIsolatedLoader({\n          isolateScript: opts.isolateScript,\n          siteBaseUrl: site,\n          storagePrefix: `${opts.pool}-iso`,\n          storage: () => shared, // facets of loaded code are logged like the root's own\n        })\n      : undefined,\n    storage: shared, // R2 objects in the fleet bucket too, as celld keeps them\n    route: opts.route,\n    ai: opts.ai,\n  });\n  scope.bind(runtime);\n  return {\n    runtime,\n    unsupported,\n    bucket: shared,\n    close: async () => {\n      await runtime.close();\n      openSql.release(); // the pool's files, for the next worker that opens it\n    },\n  };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statewalker/cellb",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "cellb: isomorphic Durable Objects runtime (celld/Cloudflare-compatible surface) for browsers and servers",
   "type": "module",
   "license": "MIT",