@statewalker/cellb 0.0.0-stage → 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser-cookies.js","sourceRoot":"","sources":["../../src/project/browser-cookies.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Cookies for Workers served through a ServiceWorker. A browser hands a ServiceWorker no\n * `Cookie` header and ignores `Set-Cookie` on the responses it builds, so the router does what\n * the browser's network stack would: it sends the page's cookies to the Worker under\n * `x-cellb-cookie` (an ingress that carries it gets the Worker's `Set-Cookie` values back under\n * `x-cellb-set-cookie`, cells-http.ts), and stores those through the Cookie Store API.\n *\n * What differs from a server's cookies: they are written by script, so `HttpOnly` cannot be set\n * and they are readable by the page's own scripts; `Domain` is ignored (the origin's host); and\n * every cookie is stored with `Path=/` and sent with every request. Chromium lets a\n * ServiceWorker read cookies only for its default URL (`getAll({ url })` throws \"URL must be\n * within Service Worker scope\" for any URL), so a cookie scoped to `/_emdash/` could not be read\n * back at all.\n */\nimport { H } from \"../transport/cells-link.js\";\n\ninterface CookieStoreLike {\n  getAll(options?: { url?: string }): Promise<{ name: string; value: string }[]>;\n  set(options: {\n    name: string;\n    value: string;\n    path?: string;\n    expires?: number | null;\n    sameSite?: \"strict\" | \"lax\" | \"none\";\n    partitioned?: boolean;\n  }): Promise<void>;\n  delete(options: { name: string; path?: string }): Promise<void>;\n}\n\nconst storeOf = (scope: unknown): CookieStoreLike | undefined =>\n  (scope as { cookieStore?: CookieStoreLike }).cookieStore;\n\n/** Headers for an ingress request: the request's own, plus the cookies its URL would carry. */\nexport async function withPageCookies(scope: unknown, req: Request): Promise<Headers> {\n  const headers = new Headers(req.headers);\n  const store = storeOf(scope);\n  if (!store) return headers; // no Cookie Store API: no cookies either way\n  const cookies = await store.getAll().catch(() => []);\n  headers.set(H.cookie, cookies.map((c) => `${c.name}=${c.value}`).join(\"; \"));\n  return headers;\n}\n\n/** One `Set-Cookie` value as Cookie Store options; `expires: 0` deletes. */\nexport function parseSetCookie(value: string, now = Date.now()) {\n  const [pair, ...attrs] = value.split(\";\");\n  const eq = pair.indexOf(\"=\");\n  const cookie: {\n    name: string;\n    value: string;\n    path?: string;\n    expires?: number;\n    sameSite?: \"strict\" | \"lax\" | \"none\";\n  } = {\n    name: (eq < 0 ? \"\" : pair.slice(0, eq)).trim(),\n    value: (eq < 0 ? pair : pair.slice(eq + 1)).trim(),\n  };\n  let maxAge: number | undefined;\n  for (const attr of attrs) {\n    const i = attr.indexOf(\"=\");\n    const key = (i < 0 ? attr : attr.slice(0, i)).trim().toLowerCase();\n    const val = i < 0 ? \"\" : attr.slice(i + 1).trim();\n    if (key === \"path\") cookie.path = val || \"/\";\n    else if (key === \"expires\") {\n      const t = Date.parse(val);\n      if (!Number.isNaN(t)) cookie.expires = t;\n    } else if (key === \"max-age\" && /^-?\\d+$/.test(val)) maxAge = Number(val);\n    else if (key === \"samesite\") {\n      const s = val.toLowerCase();\n      if (s === \"strict\" || s === \"lax\" || s === \"none\") cookie.sameSite = s;\n    }\n  }\n  // Max-Age wins over Expires (RFC 6265); zero or less deletes.\n  if (maxAge !== undefined) cookie.expires = maxAge <= 0 ? 0 : now + maxAge * 1000;\n  return cookie;\n}\n\n/** Stores the Worker's tunneled Set-Cookie values and returns the response without them. */\nexport async function applyWorkerCookies(scope: unknown, res: Response): Promise<Response> {\n  const tunneled = res.headers.get(H.setCookie);\n  if (tunneled === null) return res;\n  const store = storeOf(scope);\n  for (const raw of tunneled.split(\",\").filter(Boolean)) {\n    const c = parseSetCookie(decodeURIComponent(raw));\n    if (!c.name || !store) continue;\n    try {\n      if (c.expires !== undefined && c.expires <= Date.now())\n        await store.delete({ name: c.name, path: \"/\" });\n      else\n        await store.set({\n          name: c.name,\n          value: c.value,\n          path: \"/\",\n          expires: c.expires ?? null,\n          sameSite: c.sameSite ?? \"lax\",\n        });\n    } catch (err) {\n      console.warn(`cellb: cookie ${c.name} not stored: ${(err as Error)?.message ?? err}`);\n    }\n  }\n  const headers = new Headers(res.headers);\n  headers.delete(H.setCookie);\n  return new Response(res.body, { status: res.status, statusText: res.statusText, headers });\n}\n"]}

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

@@ -0,0 +1,173 @@
+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 WranglerConfig } from "./wrangler.js";
+/**
+ * Where a browser-hosted project keeps its cells when they must outlive the page or move to
+ * other nodes: a celld fleet bucket. Cells, facets and alarms are then exactly celld's
+ * (ownership in `own.json`, LTX logs, wake index) and R2 objects live in it too, so the same
+ * cells can be served by this browser, by other browsers and by celld nodes, in turn.
+ *
+ * - `s3`: an S3-compatible bucket, reached directly (the bucket must allow CORS for the page's
+ *   origin: methods GET/PUT/DELETE/HEAD, request headers `authorization`, `content-type`,
+ *   `x-amz-*`, `if-match`, `if-none-match`; exposed headers `etag`, `last-modified`,
+ *   `x-amz-meta-celld-r2`) or through a same-origin proxy (`endpoint` = the proxy,
+ *   `signAs` = the real endpoint: SigV4 signs the real host and path).
+ * - `opfs`: a bucket in this origin's OPFS — persistence without a server. Conditional writes
+ *   are atomic only within one writer, so one tab or worker at a time should own its cells.
+ * - `store`: any ObjectStore.
+ */
+export type BrowserBucket = {
+    s3: {
+        endpoint: string;
+        signAs?: string;
+        bucket: string;
+        prefix?: string;
+        region?: string;
+        accessKeyId: string;
+        secretAccessKey: string;
+    };
+    node: string;
+    leaseTtlMs?: number;
+} | {
+    opfs: string;
+    node: string;
+    leaseTtlMs?: number;
+}
+/**
+ * `idb`: a bucket in this origin's IndexedDB (atomic conditional writes across tabs and
+ * workers). Cells then run SQLite in memory and persist through the bucket's page-level logs:
+ * no OPFS pool, so any number of workers can serve cells at once.
+ */
+ | {
+    idb: string;
+    node: string;
+    leaseTtlMs?: number;
+}
+/**
+ * `ltx`: cells as celld keeps them, LTX files (a snapshot and one file per commit) in an OPFS
+ * directory, read page by page (a SQLite VFS over a store worker): no OPFS pool, and a
+ * cell's memory is its page cache, not its database. A cell is folded into one snapshot
+ * (streamed) past `compactAfter` files (default 64), or once the files after its snapshot hold
+ * more than half of it. See docs/browser-host.md.
+ */
+ | {
+    ltx: string;
+    node: string;
+    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).
+     */
+    files?: "opfs" | "opfs-sync" | "memory";
+} | {
+    store: ObjectStore;
+    node: string;
+    leaseTtlMs?: number;
+};
+export interface BrowserProjectOptions {
+    config: WranglerConfig;
+    /**
+     * The project's Worker code, imported in this realm once its Workers globals (and with
+     * nodejs_compat `Buffer` and `process`) are installed:
+     * - `bundle`: one ES module built for browsers (`bundleWorkerForBrowser`), whose
+     *   `cloudflare:workers` is `PROJECT_WORKERS_MODULE_SHIM` and whose Workers globals read
+     *   `globalThis.__cellsGlobals`
+     *   (`null`: the project has no `main`). Worker Loader code becomes Blob-URL modules.
+     * - `site`: the base URL of the project's site (`createProjectSite`, hosted by
+     *   webrun-site-host). `main` and Worker Loader code are imported from it.
+     */
+    code: {
+        bundle: string | null;
+    } | {
+        site: string;
+    };
+    /**
+     * A Dedicated Worker script that serves one loaded Worker (`serveIsolate`): Worker Loader
+     * code then runs isolated, one Dedicated Worker per loaded Worker, as celld's isolates.
+     * The package ships one: `@statewalker/cellb/isolate-worker`.
+     */
+    isolateScript?: URL;
+    /** An initialized SQLite WASM module (`@sqlite.org/sqlite-wasm`). */
+    sqlite3: unknown;
+    /** OPFS sahpool name for this host's SQLite files (one pool per worker). */
+    pool: string;
+    /** OPFS directory for the project's FilesApi (Workers' fs-like bindings, R2 without bucket). */
+    filesDir: string;
+    assetFiles?: AssetFiles;
+    bucket?: BrowserBucket;
+    /**
+     * Cells this runtime does not host: where to send their events (a `Send` over a MessagePort
+     * to the runtime that hosts them, `linkOverPort`), or undefined to host the cell here. With
+     * one runtime per worker and `shardOf` as the placement, cells run in parallel threads.
+     */
+    route?: CellRuntimeOptions["route"];
+    /** The OpenAI-compatible endpoint behind the project's `ai` binding (Workers AI). */
+    ai?: WorkersAiOptions;
+}
+/**
+ * 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.
+ */
+export declare function browserProjectRuntime(opts: BrowserProjectOptions): Promise<{
+    runtime: import("../core/runtime.js").CellRuntime;
+    unsupported: string[];
+    bucket: {
+        ownership: {
+            tryAcquire(cellKey: string): Promise<{
+                name: string;
+                epoch: number;
+                lost: AbortSignal;
+                release: () => Promise<void>;
+            } | undefined>;
+        };
+        durability: import("../ports.js").CellDurability & import("../ports.js").CellBackup & {
+            logCommit: import("../ports.js").CellDurability["committed"];
+        } & {
+            begin(cellKey: string, epoch: number): void;
+            forget(cellKey: string): void;
+        } & {
+            wakes(): Promise<{
+                cellKey: string;
+                className: string;
+                at: number;
+            }[]>;
+        };
+        backup: import("../ports.js").CellDurability & import("../ports.js").CellBackup & {
+            logCommit: import("../ports.js").CellDurability["committed"];
+        } & {
+            begin(cellKey: string, epoch: number): void;
+            forget(cellKey: string): void;
+        } & {
+            wakes(): Promise<{
+                cellKey: string;
+                className: string;
+                at: number;
+            }[]>;
+        };
+        objects: ObjectStore & {
+            close?(): void;
+        };
+        probe(challenge: string): Promise<{
+            version: number;
+            node: string;
+            advertise: string;
+            challenge: string;
+            signature: string;
+        }>;
+        advertise(address: string): Promise<void>;
+        close(): Promise<void>;
+    } | undefined;
+    close: () => Promise<void>;
+}>;
+/**
+ * workerd fills `process.env` with the project's text `vars` under nodejs_compat from
+ * compatibility date 2025-04-01 (`nodejs_compat_populate_process_env`), unless
+ * `nodejs_compat_do_not_populate_process_env` is set. Frameworks read their settings there
+ * (EmDash's `EMDASH_SITE_URL`, for one).
+ */
+export declare function populatesProcessEnv(config: WranglerConfig): boolean;
+/** The text `vars` of a project, as `process.env` holds them. */
+export declare function processEnvOf(config: WranglerConfig): Record<string, string>;

package/dist/project/browser-host.js

@@ -0,0 +1,200 @@
+import { BrowserFilesApi } from "@statewalker/webrun-files-browser";
+import { installLtxVfs } from "../adapters/ltx-vfs.js";
+import { sahpoolOpener, WasmSqliteDriver, wasmMemoryOpener } from "../adapters/wasm-sqlite.js";
+import { celldBucket } from "../bucket/celld-cells.js";
+import { idbObjectStore } from "../bucket/idb-object-store.js";
+import { filesApiObjectStore } from "../bucket/object-store.js";
+import { s3ObjectStore } from "../bucket/s3-object-store.js";
+import { browserIsolatedLoader } from "../isolate/browser.js";
+import { installAsyncContext } from "../node-compat/async_hooks.js";
+import { installNodeGlobals } from "../node-compat/install.js";
+import { browserModuleLoader } from "./browser-modules.js";
+import * as workersModule from "./cloudflare-workers.js";
+import { siteModuleLoader, workersHostRegistry } from "./site.js";
+import { workerScope } from "./worker-scope.js";
+import * as workersGlobals from "./workers-globals-module.js";
+import { createProjectRuntime, loadTimeEnv } from "./wrangler.js";
+async function bucketStore(b) {
+    if ("store" in b)
+        return b.store;
+    if ("s3" in b)
+        return s3ObjectStore({ region: "us-east-1", ...b.s3 });
+    if ("idb" in b)
+        return idbObjectStore(b.idb);
+    if ("ltx" in b)
+        throw new Error("an ltx directory is cell storage, not a bucket");
+    const root = await navigator.storage.getDirectory();
+    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).
+ */
+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) });
+    const s3 = sqlite3;
+    const open = (cellKey) => {
+        const db = new s3.oo1.DB({ filename: cellKey, vfs: name, flags: "c" });
+        db.exec("PRAGMA journal_mode=MEMORY; PRAGMA synchronous=FULL;");
+        // SQLite's C API for inTransaction() only (no page hook or session capture on this VFS).
+        return new WasmSqliteDriver(db, undefined, undefined, sqlite3.capi);
+    };
+    return Object.assign(open, {
+        release() {
+            store.terminate();
+        },
+        reserve: async (n) => n,
+    });
+}
+/** Installs the Workers globals the code reads, then imports its `main`. */
+async function importWorkerCode(config, code, scope) {
+    const flags = config.compatibility_flags ?? [];
+    const nodeCompat = flags.some((f) => f.startsWith("nodejs_compat"));
+    if (nodeCompat) {
+        installNodeGlobals();
+        // node:* for bundles built with cellbHostModule (another bundler than bundleWorkerForBrowser);
+        // loaded after installNodeGlobals(), as the npm `util` polyfill reads `process`.
+        globalThis.__cellsNodeModules = (await import("../node-compat/browser-registry.js")).nodeRegistryEntries;
+        if (populatesProcessEnv(config)) {
+            const env = processEnvOf(config);
+            // The bundle's own `process` reads it when evaluated; a site's modules use this realm's.
+            globalThis.__cellsProcessEnv = env;
+            Object.assign(globalThis.process.env, env);
+        }
+        // node:async_hooks: continuations carry their AsyncLocalStorage stores (with AsyncContext
+        // the engine does, and this installs nothing). The code's awaits are lowered so that they go
+        // through them: by bundleWorkerForBrowser for a bundle, by createProjectSite (nodeCompat) for
+        // a site's modules.
+        installAsyncContext();
+    }
+    const globals = {
+        ...workersGlobals,
+        Request: workersGlobals.CellsRequest,
+        Response: workersGlobals.CellsResponse,
+        WebSocketPair: flags.includes("websocket_standard_binary_type")
+            ? workersGlobals.StandardWebSocketPair
+            : workersGlobals.WebSocketPair,
+    };
+    if ("site" in code) {
+        workersHostRegistry({
+            workersModule,
+            projectWorkersModule: {
+                ...workersModule,
+                env: scope.env,
+                exports: scope.exports,
+                waitUntil: scope.waitUntil,
+            },
+            loadedPrefix: `${code.site}loaded/`,
+            emailModule: await import("./cloudflare-email.js"),
+            ...globals,
+            // Loaded on demand, after installNodeGlobals(): the npm `util` polyfill reads `process`
+            // when it is imported.
+            node: nodeCompat
+                ? (await import("../node-compat/browser-registry.js")).nodeRegistryEntries
+                : undefined,
+        });
+        return config.main
+            ? await import(/* @vite-ignore */ `${code.site}modules/~/${config.main}`)
+            : { default: {} };
+    }
+    const g = globalThis;
+    g.__cellsWorkersModule = workersModule;
+    g.__cellsProjectScope = scope; // `env` and `exports` of the bundle's cloudflare:workers
+    g.__cellsGlobals = globals;
+    return code.bundle
+        ? await import(
+        /* @vite-ignore */ URL.createObjectURL(new Blob([code.bundle], { type: "text/javascript" })))
+        : { default: {} };
+}
+/**
+ * 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.
+ */
+export async function browserProjectRuntime(opts) {
+    const scope = workerScope(loadTimeEnv(opts.config, opts.ai));
+    const module = await importWorkerCode(opts.config, opts.code, scope);
+    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)
+        : opts.bucket && "idb" in opts.bucket
+            ? Object.assign(wasmMemoryOpener(opts.sqlite3), {
+                release() { },
+                reserve: async (n) => n,
+            })
+            : await sahpoolOpener(opts.sqlite3, {
+                name: opts.pool,
+                initialCapacity: 64, // grows on demand (sahpoolOpener)
+            });
+    const root = await navigator.storage.getDirectory();
+    const files = new BrowserFilesApi({
+        rootHandle: await root.getDirectoryHandle(opts.filesDir, { create: true }),
+    });
+    // An `ltx` directory is the cells' own storage (the VFS), not a fleet bucket.
+    const store = opts.bucket && !("ltx" in opts.bucket) ? await bucketStore(opts.bucket) : undefined;
+    const shared = opts.bucket && store
+        ? celldBucket(store, { node: opts.bucket.node, leaseTtlMs: opts.bucket.leaseTtlMs })
+        : undefined;
+    const { runtime, unsupported } = createProjectRuntime(opts.config, module, {
+        openSql,
+        files,
+        assetFiles: opts.assetFiles,
+        loadModules: site ? siteModuleLoader(site) : browserModuleLoader(),
+        isolatedModules: opts.isolateScript
+            ? browserIsolatedLoader({
+                isolateScript: opts.isolateScript,
+                siteBaseUrl: site,
+                storagePrefix: `${opts.pool}-iso`,
+                storage: () => shared, // facets of loaded code are logged like the root's own
+            })
+            : undefined,
+        storage: shared, // R2 objects in the fleet bucket too, as celld keeps them
+        route: opts.route,
+        ai: opts.ai,
+    });
+    scope.bind(runtime);
+    return {
+        runtime,
+        unsupported,
+        bucket: shared,
+        close: async () => {
+            await runtime.close();
+            openSql.release(); // the pool's files, for the next worker that opens it
+        },
+    };
+}
+/**
+ * workerd fills `process.env` with the project's text `vars` under nodejs_compat from
+ * compatibility date 2025-04-01 (`nodejs_compat_populate_process_env`), unless
+ * `nodejs_compat_do_not_populate_process_env` is set. Frameworks read their settings there
+ * (EmDash's `EMDASH_SITE_URL`, for one).
+ */
+export function populatesProcessEnv(config) {
+    const flags = config.compatibility_flags ?? [];
+    if (!flags.some((f) => f.startsWith("nodejs_compat")))
+        return false;
+    if (flags.includes("nodejs_compat_do_not_populate_process_env"))
+        return false;
+    if (flags.includes("nodejs_compat_populate_process_env"))
+        return true;
+    return (config.compatibility_date ?? "") >= "2025-04-01";
+}
+/** The text `vars` of a project, as `process.env` holds them. */
+export function processEnvOf(config) {
+    const env = {};
+    for (const [k, v] of Object.entries(config.vars ?? {}))
+        if (typeof v === "string")
+            env[k] = v;
+    return env;
+}
+//# sourceMappingURL=browser-host.js.map

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

@@ -0,0 +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 { sahpoolOpener, WasmSqliteDriver, wasmMemoryOpener } 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.js\";\nimport { type WorkerScope, workerScope } from \"./worker-scope.js\";\nimport * as workersGlobals from \"./workers-globals-module.js\";\nimport { createProjectRuntime, loadTimeEnv, type WranglerConfig } from \"./wrangler.js\";\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`.\n   */\n  isolateScript?: URL;\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    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\n/**\n * workerd fills `process.env` with the project's text `vars` under nodejs_compat from\n * compatibility date 2025-04-01 (`nodejs_compat_populate_process_env`), unless\n * `nodejs_compat_do_not_populate_process_env` is set. Frameworks read their settings there\n * (EmDash's `EMDASH_SITE_URL`, for one).\n */\nexport function populatesProcessEnv(config: WranglerConfig): boolean {\n  const flags = config.compatibility_flags ?? [];\n  if (!flags.some((f) => f.startsWith(\"nodejs_compat\"))) return false;\n  if (flags.includes(\"nodejs_compat_do_not_populate_process_env\")) return false;\n  if (flags.includes(\"nodejs_compat_populate_process_env\")) return true;\n  return (config.compatibility_date ?? \"\") >= \"2025-04-01\";\n}\n\n/** The text `vars` of a project, as `process.env` holds them. */\nexport function processEnvOf(config: WranglerConfig): Record<string, string> {\n  const env: Record<string, string> = {};\n  for (const [k, v] of Object.entries(config.vars ?? {})) if (typeof v === \"string\") env[k] = v;\n  return env;\n}\n"]}

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

@@ -0,0 +1,17 @@
+import { type ModuleLoader } from "../bindings/worker-loader.js";
+/**
+ * `cloudflare:workers` for a project's own bundle: the classes, and the project's `env` and
+ * `exports` from `globalThis.__cellsProjectScope` (set by `browserProjectRuntime`, and by
+ * `serveIsolate` for the loaded Worker an isolate runs). The shim is
+ * bundled with the Worker, so it declares no names beyond its exports: esbuild would rename the
+ * Worker's own variables of the same name, and those names show in error messages.
+ */
+export declare const PROJECT_WORKERS_MODULE_SHIM = "const m = globalThis.__cellsWorkersModule; export const DurableObject = m.DurableObject, WorkerEntrypoint = m.WorkerEntrypoint, WorkflowEntrypoint = m.WorkflowEntrypoint, RpcTarget = m.RpcTarget; export default m; export const env = globalThis.__cellsProjectScope?.env ?? {}, exports = globalThis.__cellsProjectScope?.exports ?? {}, waitUntil = (p) => globalThis.__cellsProjectScope?.waitUntil(p);";
+/**
+ * Worker Loader in a browser realm: each module of a WorkerCode becomes a Blob-URL ES
+ * module. `cloudflare:workers` resolves to a shim reading the runtime's own classes from
+ * `globalThis.__cellsWorkersModule` and the loaded code's own `env` and `exports` (or to
+ * `workersModuleShim`, the same for every load); relative imports resolve to the Blob URLs of
+ * sibling modules; with a log sink the module gets a module-scoped `console` (Tail Workers).
+ */
+export declare function browserModuleLoader(workersModuleShim?: string): ModuleLoader;

package/dist/project/browser-modules.js

@@ -0,0 +1,89 @@
+import { moduleText, outboundFetch, } from "../bindings/worker-loader.js";
+import { ctxExports } from "../core/handles.js";
+import { workerScope } from "./worker-scope.js";
+const WORKERS_CLASSES = "const m = globalThis.__cellsWorkersModule; export const DurableObject = m.DurableObject, WorkerEntrypoint = m.WorkerEntrypoint, WorkflowEntrypoint = m.WorkflowEntrypoint, RpcTarget = m.RpcTarget; export default m;";
+/**
+ * `cloudflare:workers` for a project's own bundle: the classes, and the project's `env` and
+ * `exports` from `globalThis.__cellsProjectScope` (set by `browserProjectRuntime`, and by
+ * `serveIsolate` for the loaded Worker an isolate runs). The shim is
+ * bundled with the Worker, so it declares no names beyond its exports: esbuild would rename the
+ * Worker's own variables of the same name, and those names show in error messages.
+ */
+export const PROJECT_WORKERS_MODULE_SHIM = `${WORKERS_CLASSES} export const env = globalThis.__cellsProjectScope?.env ?? {}, exports = globalThis.__cellsProjectScope?.exports ?? {}, waitUntil = (p) => globalThis.__cellsProjectScope?.waitUntil(p);`;
+/**
+ * Worker Loader in a browser realm: each module of a WorkerCode becomes a Blob-URL ES
+ * module. `cloudflare:workers` resolves to a shim reading the runtime's own classes from
+ * `globalThis.__cellsWorkersModule` and the loaded code's own `env` and `exports` (or to
+ * `workersModuleShim`, the same for every load); relative imports resolve to the Blob URLs of
+ * sibling modules; with a log sink the module gets a module-scoped `console` (Tail Workers).
+ */
+export function browserModuleLoader(workersModuleShim) {
+    const blob = (text) => URL.createObjectURL(new Blob([text], { type: "text/javascript" }));
+    const fixedShimUrl = workersModuleShim && blob(workersModuleShim);
+    return async (_id, code, logs) => {
+        const env = code.env ?? {};
+        const scope = fixedShimUrl ? undefined : workerScope(env);
+        let shimUrl = fixedShimUrl;
+        if (scope) {
+            const key = `s${Math.random().toString(36).slice(2)}`;
+            const g = globalThis;
+            g.__cellsWorkerScopes ??= {};
+            g.__cellsWorkerScopes[key] = scope;
+            shimUrl = blob(`${WORKERS_CLASSES} const s = globalThis.__cellsWorkerScopes[${JSON.stringify(key)}]; export const env = s.env, exports = s.exports, waitUntil = s.waitUntil;`);
+        }
+        let consolePrelude = "";
+        if (logs) {
+            const key = `c${Math.random().toString(36).slice(2)}`;
+            const g = globalThis;
+            g.__cellsConsoles ??= {};
+            const real = globalThis.console;
+            const wrap = (level) => (...args) => {
+                logs(level, args);
+                real[level](...args);
+            };
+            g.__cellsConsoles[key] = Object.assign(Object.create(real), {
+                log: wrap("log"),
+                info: wrap("info"),
+                warn: wrap("warn"),
+                error: wrap("error"),
+                debug: wrap("debug"),
+            });
+            consolePrelude = `const console = globalThis.__cellsConsoles[${JSON.stringify(key)}];\n`;
+        }
+        const outbound = outboundFetch(code);
+        if (outbound) {
+            const key = `o${Math.random().toString(36).slice(2)}`;
+            const g = globalThis;
+            g.__cellsOutbound ??= {};
+            g.__cellsOutbound[key] = outbound;
+            consolePrelude += `const fetch = globalThis.__cellsOutbound[${JSON.stringify(key)}];\n`;
+        }
+        const urls = new Map();
+        const source = (name) => {
+            const m = code.modules[name];
+            if (m === undefined)
+                throw new Error(`Worker Loader: module "${name}" not found`);
+            return moduleText(m);
+        };
+        const urlOf = (name) => {
+            const known = urls.get(name);
+            if (known)
+                return known;
+            const base = name.includes("/") ? name.slice(0, name.lastIndexOf("/") + 1) : "";
+            const text = source(name).replace(/(\bfrom\s*|\bimport\s*\(?\s*)(["'])([^"']+)\2/g, (all, pre, q, spec) => {
+                if (spec === "cloudflare:workers")
+                    return `${pre}${q}${shimUrl}${q}`;
+                if (spec.startsWith("./") || spec.startsWith("../"))
+                    return `${pre}${q}${urlOf(new URL(spec, `file:///${base}`).pathname.slice(1))}${q}`;
+                return all;
+            });
+            const url = URL.createObjectURL(new Blob([consolePrelude + text], { type: "text/javascript" }));
+            urls.set(name, url);
+            return url;
+        };
+        const module = (await import(/* @vite-ignore */ urlOf(code.mainModule)));
+        scope?.bind({ env, exports: ctxExports(module, env) });
+        return module;
+    };
+}
+//# sourceMappingURL=browser-modules.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser-modules.js","sourceRoot":"","sources":["../../src/project/browser-modules.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  type LogSink,\n  type ModuleLoader,\n  moduleText,\n  outboundFetch,\n  type WorkerCode,\n} from \"../bindings/worker-loader.js\";\nimport { ctxExports } from \"../core/handles.js\";\nimport { workerScope } from \"./worker-scope.js\";\n\nconst WORKERS_CLASSES =\n  \"const m = globalThis.__cellsWorkersModule; export const DurableObject = m.DurableObject, WorkerEntrypoint = m.WorkerEntrypoint, WorkflowEntrypoint = m.WorkflowEntrypoint, RpcTarget = m.RpcTarget; export default m;\";\n\n/**\n * `cloudflare:workers` for a project's own bundle: the classes, and the project's `env` and\n * `exports` from `globalThis.__cellsProjectScope` (set by `browserProjectRuntime`, and by\n * `serveIsolate` for the loaded Worker an isolate runs). The shim is\n * bundled with the Worker, so it declares no names beyond its exports: esbuild would rename the\n * Worker's own variables of the same name, and those names show in error messages.\n */\nexport const PROJECT_WORKERS_MODULE_SHIM = `${WORKERS_CLASSES} export const env = globalThis.__cellsProjectScope?.env ?? {}, exports = globalThis.__cellsProjectScope?.exports ?? {}, waitUntil = (p) => globalThis.__cellsProjectScope?.waitUntil(p);`;\n\n/**\n * Worker Loader in a browser realm: each module of a WorkerCode becomes a Blob-URL ES\n * module. `cloudflare:workers` resolves to a shim reading the runtime's own classes from\n * `globalThis.__cellsWorkersModule` and the loaded code's own `env` and `exports` (or to\n * `workersModuleShim`, the same for every load); relative imports resolve to the Blob URLs of\n * sibling modules; with a log sink the module gets a module-scoped `console` (Tail Workers).\n */\nexport function browserModuleLoader(workersModuleShim?: string): ModuleLoader {\n  const blob = (text: string) => URL.createObjectURL(new Blob([text], { type: \"text/javascript\" }));\n  const fixedShimUrl = workersModuleShim && blob(workersModuleShim);\n  return async (_id: string, code: WorkerCode, logs?: LogSink) => {\n    const env = code.env ?? {};\n    const scope = fixedShimUrl ? undefined : workerScope(env);\n    let shimUrl = fixedShimUrl;\n    if (scope) {\n      const key = `s${Math.random().toString(36).slice(2)}`;\n      const g = globalThis as Record<string, unknown>;\n      g.__cellsWorkerScopes ??= {};\n      (g.__cellsWorkerScopes as Record<string, unknown>)[key] = scope;\n      shimUrl = blob(\n        `${WORKERS_CLASSES} const s = globalThis.__cellsWorkerScopes[${JSON.stringify(key)}]; export const env = s.env, exports = s.exports, waitUntil = s.waitUntil;`,\n      );\n    }\n    let consolePrelude = \"\";\n    if (logs) {\n      const key = `c${Math.random().toString(36).slice(2)}`;\n      const g = globalThis as Record<string, unknown>;\n      g.__cellsConsoles ??= {};\n      const real = globalThis.console;\n      const wrap =\n        (level: \"log\" | \"info\" | \"warn\" | \"error\" | \"debug\") =>\n        (...args: unknown[]) => {\n          logs(level, args);\n          real[level](...args);\n        };\n      (g.__cellsConsoles as Record<string, unknown>)[key] = Object.assign(Object.create(real), {\n        log: wrap(\"log\"),\n        info: wrap(\"info\"),\n        warn: wrap(\"warn\"),\n        error: wrap(\"error\"),\n        debug: wrap(\"debug\"),\n      });\n      consolePrelude = `const console = globalThis.__cellsConsoles[${JSON.stringify(key)}];\\n`;\n    }\n    const outbound = outboundFetch(code);\n    if (outbound) {\n      const key = `o${Math.random().toString(36).slice(2)}`;\n      const g = globalThis as Record<string, unknown>;\n      g.__cellsOutbound ??= {};\n      (g.__cellsOutbound as Record<string, unknown>)[key] = outbound;\n      consolePrelude += `const fetch = globalThis.__cellsOutbound[${JSON.stringify(key)}];\\n`;\n    }\n    const urls = new Map<string, string>();\n    const source = (name: string) => {\n      const m = code.modules[name];\n      if (m === undefined) throw new Error(`Worker Loader: module \"${name}\" not found`);\n      return moduleText(m);\n    };\n    const urlOf = (name: string): string => {\n      const known = urls.get(name);\n      if (known) return known;\n      const base = name.includes(\"/\") ? name.slice(0, name.lastIndexOf(\"/\") + 1) : \"\";\n      const text = source(name).replace(\n        /(\\bfrom\\s*|\\bimport\\s*\\(?\\s*)([\"'])([^\"']+)\\2/g,\n        (all, pre, q, spec: string) => {\n          if (spec === \"cloudflare:workers\") return `${pre}${q}${shimUrl}${q}`;\n          if (spec.startsWith(\"./\") || spec.startsWith(\"../\"))\n            return `${pre}${q}${urlOf(new URL(spec, `file:///${base}`).pathname.slice(1))}${q}`;\n          return all;\n        },\n      );\n      const url = URL.createObjectURL(\n        new Blob([consolePrelude + text], { type: \"text/javascript\" }),\n      );\n      urls.set(name, url);\n      return url;\n    };\n    const module = (await import(/* @vite-ignore */ urlOf(code.mainModule))) as Record<\n      string,\n      unknown\n    >;\n    scope?.bind({ env, exports: ctxExports(module, env) });\n    return module;\n  };\n}\n"]}

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

@@ -0,0 +1,62 @@
+import type { RemoteRuntime } from "../transport/cells-http.js";
+import { type BrowserBucket, type BrowserProjectOptions } from "./browser-host.js";
+/** A shard of a project shared by the tabs of an origin (`joinProjectShards`): linked to a router. */
+export declare const TAB_INIT = "cellb:tab-shard";
+export declare const TAB_LINK = "cellb:tab-shard-link";
+/** The router the shard was just linked to: the Web Lock its ServiceWorker holds while alive. */
+export declare const TAB_WATCH = "cellb:tab-shard-watch";
+/** From a shard worker to its tab: a call waits for a router that is gone; wake the ServiceWorker. */
+export declare const SHARD_WAKE = "cellb:tab-shard-wake";
+/** From a shard worker to its tab: calls into other shards are in flight; keep the ServiceWorker up. */
+export declare const SHARD_KEEPALIVE = "cellb:tab-shard-keepalive";
+/** What a shard worker shared by tabs is told: no peers, it reaches them through the router. */
+export interface TabShardInit {
+    type: typeof TAB_INIT;
+    name: string;
+    shard: number;
+    shards: number;
+    config: BrowserProjectOptions["config"];
+    code: BrowserProjectOptions["code"];
+    assetFiles?: BrowserProjectOptions["assetFiles"];
+    /** The OpenAI-compatible endpoint behind the project's `ai` binding. */
+    ai?: BrowserProjectOptions["ai"];
+    bucket?: BrowserBucket;
+    pool: string;
+    filesDir: string;
+}
+/**
+ * The worker side: hosts one shard when a page says so — of `startProjectShards` (peers wired
+ * directly) or of `joinProjectShards` (shared by the tabs, linked to the ServiceWorker's router).
+ * Messages of other types are left to the worker's own listeners.
+ */
+export declare function serveProjectShard(opts: {
+    /** An initialized SQLite WASM module, or a function that makes one. */
+    sqlite3: unknown | (() => Promise<unknown>);
+    /** `browserProjectRuntime`'s `isolateScript`. */
+    isolateScript?: URL;
+}): void;
+export interface ProjectShards {
+    /** Ingress: a request to the project's Worker, in the next shard (round robin). */
+    fetch(req: Request): Promise<Response>;
+    /** The shards' runtimes, by shard number. */
+    readonly shards: RemoteRuntime[];
+    /** Configuration entries the runtime does not support (as `browserProjectRuntime` reports). */
+    readonly unsupported: string[];
+    /** Closes every shard's runtime (releasing bucket leases), then its worker. */
+    close(): Promise<void>;
+}
+/** The page side: starts `shards` workers that each run `serveProjectShard`, wired together. */
+export declare function startProjectShards(opts: {
+    shards: number;
+    /** Starts one worker whose script calls `serveProjectShard`. */
+    spawn: (shard: number) => Worker;
+    config: BrowserProjectOptions["config"];
+    code: BrowserProjectOptions["code"];
+    assetFiles?: BrowserProjectOptions["assetFiles"];
+    /** The OpenAI-compatible endpoint behind the project's `ai` binding. */
+    ai?: BrowserProjectOptions["ai"];
+    /** Each shard is its own fleet node, named `<node>-s<shard>`. */
+    bucket?: BrowserBucket;
+    /** Prefix of the shards' OPFS pools and files directories (`<name>-<shard>`). */
+    name: string;
+}): Promise<ProjectShards>;