@statewalker/cellb 0.6.0 → 0.8.0

package/dist/node-compat/browser-registry.js

@@ -3,6 +3,9 @@
 // An entry is the module's default export, carrying its named exports as properties: the
 // module server's proxy serves the entry itself as `default` (so `import assert from
 // "node:assert"` must be callable) and its keys as the named exports.
+// First: `util` reads `process` while it loads (util-guard.ts). A side-effect import is never
+// reordered, and the imports after it are evaluated after it.
+import "./util-guard.js";
 import assert from "assert";
 import { Buffer } from "buffer";
 import EventEmitter from "events";
@@ -15,6 +18,8 @@ import * as fs from "./fs.js";
 import nodeModule from "./module.js";
 import * as os from "./os.js";
 import { process } from "./process.js";
+import { releaseUtilGuard } from "./util-guard.js";
+releaseUtilGuard();
 const modules = {
     "node:assert": assert,
     "node:buffer": { Buffer, default: { Buffer } },

package/dist/node-compat/browser-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-registry.js","sourceRoot":"","sources":["../../src/node-compat/browser-registry.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,4FAA4F;AAC5F,yFAAyF;AACzF,qFAAqF;AACrF,sEAAsE;AACtE,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,YAAY,MAAM,QAAQ,CAAC;AAClC,OAAO,IAAI,MAAM,iBAAiB,CAAC;AACnC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,mBAAmB,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,OAAO,GAA4B;IACvC,aAAa,EAAE,MAAM;IACrB,aAAa,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE;IAC9C,aAAa,EAAE,YAAY,EAAE,6DAA6D;IAC1F,WAAW,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;IACvC,WAAW,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;IACvC,aAAa,EAAE,EAAE,GAAG,MAAM,EAAE;IAC5B,kBAAkB,EAAE,EAAE,GAAG,WAAW,EAAE;IACtC,cAAc,EAAE,OAAO;IACvB,0BAA0B,EAAE,EAAE,GAAG,mBAAmB,EAAE;IACtD,SAAS,EAAE,EAAE,GAAG,EAAE,EAAE;IACpB,SAAS,EAAE,EAAE,GAAG,EAAE,EAAE;IACpB,aAAa,EAAE,UAAU;CAC1B,CAAC;AAEF;sEACsE;AACtE,MAAM,CAAC,MAAM,mBAAmB,GAA4B;IAC1D,GAAG,OAAO;IACV,MAAM;IACN,OAAO;CACR,CAAC","sourcesContent":["// nodejs_compat for the in-browser module server: the polyfill modules as registry entries\n// (imported here so the browser bundler includes them in the worker that runs Worker code).\n// An entry is the module's default export, carrying its named exports as properties: the\n// module server's proxy serves the entry itself as `default` (so `import assert from\n// \"node:assert\"` must be callable) and its keys as the named exports.\nimport assert from \"assert\";\nimport { Buffer } from \"buffer\";\nimport EventEmitter from \"events\";\nimport path from \"path-browserify\";\nimport util from \"util\";\nimport * as async_hooks from \"./async_hooks.js\";\nimport * as crypto from \"./crypto.js\";\nimport * as diagnostics_channel from \"./diagnostics_channel.js\";\nimport * as fs from \"./fs.js\";\nimport nodeModule from \"./module.js\";\nimport * as os from \"./os.js\";\nimport { process } from \"./process.js\";\n\nconst modules: Record<string, unknown> = {\n  \"node:assert\": assert,\n  \"node:buffer\": { Buffer, default: { Buffer } },\n  \"node:events\": EventEmitter, // npm `events`: EventEmitter.EventEmitter, EventEmitter.once\n  \"node:path\": { ...path, default: path },\n  \"node:util\": { ...util, default: util },\n  \"node:crypto\": { ...crypto },\n  \"node:async_hooks\": { ...async_hooks },\n  \"node:process\": process,\n  \"node:diagnostics_channel\": { ...diagnostics_channel },\n  \"node:os\": { ...os },\n  \"node:fs\": { ...fs },\n  \"node:module\": nodeModule,\n};\n\n/** Registry entries: each module under its `node:*` name (a provided name wins over\n *  webrun-modules' own polyfill), plus the Buffer/process globals. */\nexport const nodeRegistryEntries: Record<string, unknown> = {\n  ...modules,\n  Buffer,\n  process,\n};\n"]}
+{"version":3,"file":"browser-registry.js","sourceRoot":"","sources":["../../src/node-compat/browser-registry.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,4FAA4F;AAC5F,yFAAyF;AACzF,qFAAqF;AACrF,sEAAsE;AACtE,8FAA8F;AAC9F,8DAA8D;AAC9D,OAAO,iBAAiB,CAAC;AACzB,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,YAAY,MAAM,QAAQ,CAAC;AAClC,OAAO,IAAI,MAAM,iBAAiB,CAAC;AACnC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,mBAAmB,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,gBAAgB,EAAE,CAAC;AAEnB,MAAM,OAAO,GAA4B;IACvC,aAAa,EAAE,MAAM;IACrB,aAAa,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE;IAC9C,aAAa,EAAE,YAAY,EAAE,6DAA6D;IAC1F,WAAW,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;IACvC,WAAW,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;IACvC,aAAa,EAAE,EAAE,GAAG,MAAM,EAAE;IAC5B,kBAAkB,EAAE,EAAE,GAAG,WAAW,EAAE;IACtC,cAAc,EAAE,OAAO;IACvB,0BAA0B,EAAE,EAAE,GAAG,mBAAmB,EAAE;IACtD,SAAS,EAAE,EAAE,GAAG,EAAE,EAAE;IACpB,SAAS,EAAE,EAAE,GAAG,EAAE,EAAE;IACpB,aAAa,EAAE,UAAU;CAC1B,CAAC;AAEF;sEACsE;AACtE,MAAM,CAAC,MAAM,mBAAmB,GAA4B;IAC1D,GAAG,OAAO;IACV,MAAM;IACN,OAAO;CACR,CAAC","sourcesContent":["// nodejs_compat for the in-browser module server: the polyfill modules as registry entries\n// (imported here so the browser bundler includes them in the worker that runs Worker code).\n// An entry is the module's default export, carrying its named exports as properties: the\n// module server's proxy serves the entry itself as `default` (so `import assert from\n// \"node:assert\"` must be callable) and its keys as the named exports.\n// First: `util` reads `process` while it loads (util-guard.ts). A side-effect import is never\n// reordered, and the imports after it are evaluated after it.\nimport \"./util-guard.js\";\nimport assert from \"assert\";\nimport { Buffer } from \"buffer\";\nimport EventEmitter from \"events\";\nimport path from \"path-browserify\";\nimport util from \"util\";\nimport * as async_hooks from \"./async_hooks.js\";\nimport * as crypto from \"./crypto.js\";\nimport * as diagnostics_channel from \"./diagnostics_channel.js\";\nimport * as fs from \"./fs.js\";\nimport nodeModule from \"./module.js\";\nimport * as os from \"./os.js\";\nimport { process } from \"./process.js\";\nimport { releaseUtilGuard } from \"./util-guard.js\";\n\nreleaseUtilGuard();\n\nconst modules: Record<string, unknown> = {\n  \"node:assert\": assert,\n  \"node:buffer\": { Buffer, default: { Buffer } },\n  \"node:events\": EventEmitter, // npm `events`: EventEmitter.EventEmitter, EventEmitter.once\n  \"node:path\": { ...path, default: path },\n  \"node:util\": { ...util, default: util },\n  \"node:crypto\": { ...crypto },\n  \"node:async_hooks\": { ...async_hooks },\n  \"node:process\": process,\n  \"node:diagnostics_channel\": { ...diagnostics_channel },\n  \"node:os\": { ...os },\n  \"node:fs\": { ...fs },\n  \"node:module\": nodeModule,\n};\n\n/** Registry entries: each module under its `node:*` name (a provided name wins over\n *  webrun-modules' own polyfill), plus the Buffer/process globals. */\nexport const nodeRegistryEntries: Record<string, unknown> = {\n  ...modules,\n  Buffer,\n  process,\n};\n"]}

package/dist/node-compat/util-guard.d.ts

@@ -0,0 +1,2 @@
+/** Removes the placeholder `process`, unless something replaced it since. */
+export declare function releaseUtilGuard(): void;

package/dist/node-compat/util-guard.js

@@ -0,0 +1,14 @@
+// The npm `util` polyfill (and `assert`, which imports it) reads `process.env.NODE_DEBUG` while it
+// is evaluated. A realm without nodejs_compat has no `process`, and must not get one: until
+// `browser-registry.ts` has loaded, `process` is a placeholder, which it then removes
+// (`releaseUtilGuard`). A realm that has `process` keeps it.
+const g = globalThis;
+const placeholder = g.process === undefined ? { env: {} } : undefined;
+if (placeholder)
+    g.process = placeholder;
+/** Removes the placeholder `process`, unless something replaced it since. */
+export function releaseUtilGuard() {
+    if (placeholder && g.process === placeholder)
+        delete g.process;
+}
+//# sourceMappingURL=util-guard.js.map

package/dist/node-compat/util-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util-guard.js","sourceRoot":"","sources":["../../src/node-compat/util-guard.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,4FAA4F;AAC5F,sFAAsF;AACtF,6DAA6D;AAC7D,MAAM,CAAC,GAAG,UAAmC,CAAC;AAC9C,MAAM,WAAW,GAAG,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACtE,IAAI,WAAW;IAAE,CAAC,CAAC,OAAO,GAAG,WAAW,CAAC;AAEzC,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB;IAC9B,IAAI,WAAW,IAAI,CAAC,CAAC,OAAO,KAAK,WAAW;QAAE,OAAO,CAAC,CAAC,OAAO,CAAC;AACjE,CAAC","sourcesContent":["// The npm `util` polyfill (and `assert`, which imports it) reads `process.env.NODE_DEBUG` while it\n// is evaluated. A realm without nodejs_compat has no `process`, and must not get one: until\n// `browser-registry.ts` has loaded, `process` is a placeholder, which it then removes\n// (`releaseUtilGuard`). A realm that has `process` keeps it.\nconst g = globalThis as { process?: unknown };\nconst placeholder = g.process === undefined ? { env: {} } : undefined;\nif (placeholder) g.process = placeholder;\n\n/** Removes the placeholder `process`, unless something replaced it since. */\nexport function releaseUtilGuard(): void {\n  if (placeholder && g.process === placeholder) delete g.process;\n}\n"]}

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

@@ -4,6 +4,7 @@
  * Workers globals (`Response` with status 101, `WebSocketPair`) from what that runtime installs;
  * with nodejs_compat, `node:*` modules (and their bare names) become browser polyfills.
  */
+import { type ModuleRule } from "./module-rules.js";
 /** Bundles the Worker module at `entry` into one ES module for `browserProjectRuntime`. */
 export declare function bundleWorkerForBrowser(entry: string, opts?: {
     nodeCompat?: boolean;
@@ -14,4 +15,6 @@ export declare function bundleWorkerForBrowser(entry: string, opts?: {
      * too.
      */
     lowerAwait?: boolean;
+    /** wrangler `rules` for non-JS imports (the defaults: `.wasm`, `.bin`, `.txt`…, as wrangler). */
+    rules?: ModuleRule[];
 }): Promise<string>;

package/dist/project/browser-bundle.js

@@ -10,6 +10,7 @@ import { build } from "esbuild";
 import { NODE_POLYFILL_FILES, NODE_POLYFILL_PACKAGES } from "../node-compat/modules.js";
 import { PROJECT_WORKERS_MODULE_SHIM } from "./browser-modules.js";
 import { lowerAwait } from "./lower-await.js";
+import { moduleRulesPlugin } from "./module-rules.js";
 import { ownModule } from "./own-module.js";
 import { SCHEDULER_EXPRESSION } from "./scheduler.js";
 import { WORKERS_GLOBAL_NAMES } from "./workers-global-names.js";
@@ -107,6 +108,7 @@ export async function bundleWorkerForBrowser(entry, opts = {}) {
                     }));
                 },
             },
+            moduleRulesPlugin(opts.rules),
         ],
     });
     try {

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

@@ -1 +1 @@
-{"version":3,"file":"browser-bundle.js","sourceRoot":"","sources":["../../src/project/browser-bundle.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Node side of a browser-hosted project: bundles Worker code for a browser realm, for\n * `browserProjectRuntime({ code: { bundle } })`. The bundle reads `cloudflare:workers` and the\n * Workers globals (`Response` with status 101, `WebSocketPair`) from what that runtime installs;\n * with nodejs_compat, `node:*` modules (and their bare names) become browser polyfills.\n */\n\nimport { builtinModules, createRequire } from \"node:module\";\nimport { resolve } from \"node:path\";\nimport { type BuildOptions, build } from \"esbuild\";\nimport { NODE_POLYFILL_FILES, NODE_POLYFILL_PACKAGES } from \"../node-compat/modules.js\";\nimport { PROJECT_WORKERS_MODULE_SHIM } from \"./browser-modules.js\";\nimport { lowerAwait } from \"./lower-await.js\";\nimport { ownModule } from \"./own-module.js\";\nimport { SCHEDULER_EXPRESSION } from \"./scheduler.js\";\nimport { WORKERS_GLOBAL_NAMES } from \"./workers-global-names.js\";\n\nconst pkg = resolve(import.meta.dirname, \"../..\");\nconst requireFromPkg = createRequire(resolve(pkg, \"package.json\"));\n\n/**\n * A Node.js module with no browser polyfill, as an ES module: every export the module has on\n * this Node.js (the bundler runs on it) is a function that throws when called (a class to extend\n * too), and the default export answers any member the same way.\n */\nfunction nodeStub(name: string): string {\n  let names: string[] = [];\n  try {\n    names = Object.keys(requireFromPkg(name)).filter((n) => n !== \"default\");\n  } catch {\n    // not a module of this Node.js: the default export only\n  }\n  const what = JSON.stringify(name);\n  return [\n    `const fail = (key) => { throw new Error(${what} + \".\" + key + \" is not available in browsers (nodejs_compat)\"); };`,\n    \"const stub = (key) => function () { fail(key); };\",\n    ...names.map(\n      (n, i) =>\n        `const s${i} = stub(${JSON.stringify(n)}); export { s${i} as ${JSON.stringify(n)} };`,\n    ),\n    \"export default new Proxy(Object.create(null), {\",\n    \"  get(target, key) {\",\n    '    if (typeof key === \"symbol\" || key === \"then\" || key === \"__esModule\") return undefined;',\n    \"    if (!Object.hasOwn(target, key)) target[key] = stub(String(key));\",\n    \"    return target[key];\",\n    \"  },\",\n    \"});\",\n  ].join(\"\\n\");\n}\n\nconst GLOBALS_SHIM = `${WORKERS_GLOBAL_NAMES.map((n) => `export const ${n} = globalThis.__cellsGlobals.${n};`).join(\" \")} export const scheduler = ${SCHEDULER_EXPRESSION};`;\n\n/** A bare Node.js built-in name (\"path\", \"fs/promises\"): nodejs_compat takes it as `node:…`. */\nconst bareBuiltin = new Set(builtinModules.filter((m) => !m.startsWith(\"_\") && !m.includes(\":\")));\n\n/** Bundles the Worker module at `entry` into one ES module for `browserProjectRuntime`. */\nexport async function bundleWorkerForBrowser(\n  entry: string,\n  opts: {\n    nodeCompat?: boolean;\n    /**\n     * Lower `await` to generators (default: with `nodeCompat`), so that the node:async_hooks\n     * polyfill carries AsyncLocalStorage stores through it. `false` only for browsers with TC39\n     * AsyncContext, whose engine carries them through native awaits; a lowered bundle runs there\n     * too.\n     */\n    lowerAwait?: boolean;\n  } = {},\n): Promise<string> {\n  const lower = opts.lowerAwait ?? opts.nodeCompat;\n  const options = (esbuildLowers: boolean): BuildOptions & { write: false } => ({\n    entryPoints: [entry],\n    write: false,\n    bundle: true,\n    format: \"esm\",\n    platform: \"browser\",\n    target: \"es2022\",\n    // Function names are observable (the npm assert polyfill reports its caller's name as the\n    // operator); bundling must not rename them.\n    keepNames: true,\n    // nodejs_compat: `await` lowered to generators, so that each one resumes through\n    // Promise.prototype.then and carries its AsyncLocalStorage stores (node-compat/async_hooks.ts).\n    ...(esbuildLowers\n      ? { supported: { \"async-await\": false, \"async-generator\": false, \"for-await\": false } }\n      : {}),\n    logLevel: \"silent\",\n    inject: [\n      \"cells:globals\",\n      ...(opts.nodeCompat ? [ownModule(import.meta.dirname, \"../node-compat/globals\")] : []),\n    ],\n    plugins: [\n      {\n        name: \"cells-browser\",\n        setup(b) {\n          // nodejs_compat: node:* → browser polyfills, bundled in.\n          if (opts.nodeCompat)\n            b.onResolve({ filter: /^(node:)?[a-z_/]+$/ }, (a) => {\n              const name = a.path.startsWith(\"node:\") ? a.path : `node:${a.path}`;\n              if (!a.path.startsWith(\"node:\") && !bareBuiltin.has(a.path)) return undefined;\n              const file = NODE_POLYFILL_FILES[name];\n              if (file) return { path: ownModule(import.meta.dirname, `../node-compat/${file}`) };\n              const polyfill = NODE_POLYFILL_PACKAGES[name];\n              // \"buffer/\" (trailing slash): the npm package, not the Node.js built-in of that name\n              if (polyfill) return { path: requireFromPkg.resolve(`${polyfill}/`) };\n              // No browser polyfill: a stub that loads and throws when used, as wrangler's\n              // nodejs_compat stubs do on Cloudflare (libraries import such modules in code\n              // paths a Worker never takes, e.g. a CLI's login).\n              return { path: name, namespace: \"cells-node-stub\" };\n            });\n          b.onLoad({ filter: /.*/, namespace: \"cells-node-stub\" }, (a) => ({\n            contents: nodeStub(a.path),\n            loader: \"js\",\n          }));\n          b.onResolve({ filter: /^cloudflare:email$/ }, () => ({\n            path: ownModule(import.meta.dirname, \"cloudflare-email\"),\n          }));\n          b.onResolve({ filter: /^cloudflare:workers$|^cells:globals$/ }, (a) => ({\n            path: a.path,\n            namespace: \"cells\",\n          }));\n          b.onLoad({ filter: /.*/, namespace: \"cells\" }, (a) => ({\n            contents: a.path === \"cloudflare:workers\" ? PROJECT_WORKERS_MODULE_SHIM : GLOBALS_SHIM,\n            loader: \"js\",\n          }));\n        },\n      },\n    ],\n  });\n  try {\n    return (await build(options(!!lower))).outputFiles[0].text;\n  } catch (err) {\n    // esbuild cannot lower a top-level await, and refuses to keep one while it lowers the rest\n    // (Astro's builds have one: `await import(…)` of the live content config). Such code is\n    // bundled as it is, then lowered by lowerAwait, which leaves top-level awaits native: module\n    // evaluation runs in no request's context, so they carry no store anyway.\n    if (!lower || !/Top-level await is not available/.test(String(err))) throw err;\n    return lowerAwait((await build(options(false))).outputFiles[0].text);\n  }\n}\n"]}
+{"version":3,"file":"browser-bundle.js","sourceRoot":"","sources":["../../src/project/browser-bundle.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Node side of a browser-hosted project: bundles Worker code for a browser realm, for\n * `browserProjectRuntime({ code: { bundle } })`. The bundle reads `cloudflare:workers` and the\n * Workers globals (`Response` with status 101, `WebSocketPair`) from what that runtime installs;\n * with nodejs_compat, `node:*` modules (and their bare names) become browser polyfills.\n */\n\nimport { builtinModules, createRequire } from \"node:module\";\nimport { resolve } from \"node:path\";\nimport { type BuildOptions, build } from \"esbuild\";\nimport { NODE_POLYFILL_FILES, NODE_POLYFILL_PACKAGES } from \"../node-compat/modules.js\";\nimport { PROJECT_WORKERS_MODULE_SHIM } from \"./browser-modules.js\";\nimport { lowerAwait } from \"./lower-await.js\";\nimport { type ModuleRule, moduleRulesPlugin } from \"./module-rules.js\";\nimport { ownModule } from \"./own-module.js\";\nimport { SCHEDULER_EXPRESSION } from \"./scheduler.js\";\nimport { WORKERS_GLOBAL_NAMES } from \"./workers-global-names.js\";\n\nconst pkg = resolve(import.meta.dirname, \"../..\");\nconst requireFromPkg = createRequire(resolve(pkg, \"package.json\"));\n\n/**\n * A Node.js module with no browser polyfill, as an ES module: every export the module has on\n * this Node.js (the bundler runs on it) is a function that throws when called (a class to extend\n * too), and the default export answers any member the same way.\n */\nfunction nodeStub(name: string): string {\n  let names: string[] = [];\n  try {\n    names = Object.keys(requireFromPkg(name)).filter((n) => n !== \"default\");\n  } catch {\n    // not a module of this Node.js: the default export only\n  }\n  const what = JSON.stringify(name);\n  return [\n    `const fail = (key) => { throw new Error(${what} + \".\" + key + \" is not available in browsers (nodejs_compat)\"); };`,\n    \"const stub = (key) => function () { fail(key); };\",\n    ...names.map(\n      (n, i) =>\n        `const s${i} = stub(${JSON.stringify(n)}); export { s${i} as ${JSON.stringify(n)} };`,\n    ),\n    \"export default new Proxy(Object.create(null), {\",\n    \"  get(target, key) {\",\n    '    if (typeof key === \"symbol\" || key === \"then\" || key === \"__esModule\") return undefined;',\n    \"    if (!Object.hasOwn(target, key)) target[key] = stub(String(key));\",\n    \"    return target[key];\",\n    \"  },\",\n    \"});\",\n  ].join(\"\\n\");\n}\n\nconst GLOBALS_SHIM = `${WORKERS_GLOBAL_NAMES.map((n) => `export const ${n} = globalThis.__cellsGlobals.${n};`).join(\" \")} export const scheduler = ${SCHEDULER_EXPRESSION};`;\n\n/** A bare Node.js built-in name (\"path\", \"fs/promises\"): nodejs_compat takes it as `node:…`. */\nconst bareBuiltin = new Set(builtinModules.filter((m) => !m.startsWith(\"_\") && !m.includes(\":\")));\n\n/** Bundles the Worker module at `entry` into one ES module for `browserProjectRuntime`. */\nexport async function bundleWorkerForBrowser(\n  entry: string,\n  opts: {\n    nodeCompat?: boolean;\n    /**\n     * Lower `await` to generators (default: with `nodeCompat`), so that the node:async_hooks\n     * polyfill carries AsyncLocalStorage stores through it. `false` only for browsers with TC39\n     * AsyncContext, whose engine carries them through native awaits; a lowered bundle runs there\n     * too.\n     */\n    lowerAwait?: boolean;\n    /** wrangler `rules` for non-JS imports (the defaults: `.wasm`, `.bin`, `.txt`…, as wrangler). */\n    rules?: ModuleRule[];\n  } = {},\n): Promise<string> {\n  const lower = opts.lowerAwait ?? opts.nodeCompat;\n  const options = (esbuildLowers: boolean): BuildOptions & { write: false } => ({\n    entryPoints: [entry],\n    write: false,\n    bundle: true,\n    format: \"esm\",\n    platform: \"browser\",\n    target: \"es2022\",\n    // Function names are observable (the npm assert polyfill reports its caller's name as the\n    // operator); bundling must not rename them.\n    keepNames: true,\n    // nodejs_compat: `await` lowered to generators, so that each one resumes through\n    // Promise.prototype.then and carries its AsyncLocalStorage stores (node-compat/async_hooks.ts).\n    ...(esbuildLowers\n      ? { supported: { \"async-await\": false, \"async-generator\": false, \"for-await\": false } }\n      : {}),\n    logLevel: \"silent\",\n    inject: [\n      \"cells:globals\",\n      ...(opts.nodeCompat ? [ownModule(import.meta.dirname, \"../node-compat/globals\")] : []),\n    ],\n    plugins: [\n      {\n        name: \"cells-browser\",\n        setup(b) {\n          // nodejs_compat: node:* → browser polyfills, bundled in.\n          if (opts.nodeCompat)\n            b.onResolve({ filter: /^(node:)?[a-z_/]+$/ }, (a) => {\n              const name = a.path.startsWith(\"node:\") ? a.path : `node:${a.path}`;\n              if (!a.path.startsWith(\"node:\") && !bareBuiltin.has(a.path)) return undefined;\n              const file = NODE_POLYFILL_FILES[name];\n              if (file) return { path: ownModule(import.meta.dirname, `../node-compat/${file}`) };\n              const polyfill = NODE_POLYFILL_PACKAGES[name];\n              // \"buffer/\" (trailing slash): the npm package, not the Node.js built-in of that name\n              if (polyfill) return { path: requireFromPkg.resolve(`${polyfill}/`) };\n              // No browser polyfill: a stub that loads and throws when used, as wrangler's\n              // nodejs_compat stubs do on Cloudflare (libraries import such modules in code\n              // paths a Worker never takes, e.g. a CLI's login).\n              return { path: name, namespace: \"cells-node-stub\" };\n            });\n          b.onLoad({ filter: /.*/, namespace: \"cells-node-stub\" }, (a) => ({\n            contents: nodeStub(a.path),\n            loader: \"js\",\n          }));\n          b.onResolve({ filter: /^cloudflare:email$/ }, () => ({\n            path: ownModule(import.meta.dirname, \"cloudflare-email\"),\n          }));\n          b.onResolve({ filter: /^cloudflare:workers$|^cells:globals$/ }, (a) => ({\n            path: a.path,\n            namespace: \"cells\",\n          }));\n          b.onLoad({ filter: /.*/, namespace: \"cells\" }, (a) => ({\n            contents: a.path === \"cloudflare:workers\" ? PROJECT_WORKERS_MODULE_SHIM : GLOBALS_SHIM,\n            loader: \"js\",\n          }));\n        },\n      },\n      moduleRulesPlugin(opts.rules),\n    ],\n  });\n  try {\n    return (await build(options(!!lower))).outputFiles[0].text;\n  } catch (err) {\n    // esbuild cannot lower a top-level await, and refuses to keep one while it lowers the rest\n    // (Astro's builds have one: `await import(…)` of the live content config). Such code is\n    // bundled as it is, then lowered by lowerAwait, which leaves top-level awaits native: module\n    // evaluation runs in no request's context, so they carry no store anyway.\n    if (!lower || !/Top-level await is not available/.test(String(err))) throw err;\n    return lowerAwait((await build(options(false))).outputFiles[0].text);\n  }\n}\n"]}

package/dist/project/browser-host.js

@@ -13,7 +13,7 @@ import * as workersModule from "./cloudflare-workers.js";
 import { siteModuleLoader, workersHostRegistry } from "./site-loader.js";
 import { workerScope } from "./worker-scope.js";
 import * as workersGlobals from "./workers-globals-module.js";
-import { createProjectRuntime, loadTimeEnv, populatesProcessEnv, processEnvOf, } from "./wrangler.js";
+import { createProjectRuntime, hasNodeCompat, loadProjectBindings, loadTimeEnv, populatesProcessEnv, processEnvOf, } from "./wrangler.js";
 export { populatesProcessEnv, processEnvOf };
 async function bucketStore(b) {
     if ("store" in b)
@@ -88,7 +88,7 @@ export async function ltxOpener(sqlite3, dir, compactAfter, files, ltxStore) {
 /** 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"));
+    const nodeCompat = hasNodeCompat(config);
     if (nodeCompat) {
         installNodeGlobals();
         // node:* for bundles built with cellbHostModule (another bundler than bundleWorkerForBrowser);
@@ -175,6 +175,7 @@ export async function browserProjectRuntime(opts) {
         ? celldBucket(store, { node: opts.bucket.node, leaseTtlMs: opts.bucket.leaseTtlMs })
         : undefined;
     const { runtime, unsupported } = createProjectRuntime(opts.config, module, {
+        bindings: await loadProjectBindings(opts.config),
         openSql,
         files,
         assetFiles: opts.assetFiles,

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

@@ -1 +1 @@
-{"version":3,"file":"browser-host.js","sourceRoot":"","sources":["../../src/project/browser-host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAoB,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,aAAa,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAoB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,cAAc,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,mBAAmB,EACnB,YAAY,GAEb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,CAAC;AA4G7C,KAAK,UAAU,WAAW,CAAC,CAAgB;IACzC,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC,KAAK,CAAC;IACjC,IAAI,IAAI,IAAI,CAAC;QAAE,OAAO,aAAa,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtE,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,KAAK,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAClF,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;IACpD,OAAO,mBAAmB,CACxB,IAAI,eAAe,CAAC,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAC5F,EAAE,CACH,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAAgB,EAChB,GAAW,EACX,YAAqB,EACrB,KAAqB,EACrB,QAAwD;IAExD,IAAI,GAAsB,CAAC;IAC3B,IAAI,IAA0B,CAAC;IAC/B,IAAI,OAAmB,CAAC;IACxB,IAAI,QAAQ,EAAE,CAAC;QACb,+DAA+D;QAC/D,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC;QACnB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC3B,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAClC,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,IAAI,MAAM,CACtB,IAAI,GAAG,CACL,4BAA4B,EAC5B,OAAO,IAAI,CAAC,GAAG,CAChB,CAAC,wCAAwC,EAC1C,EAAE,IAAI,EAAE,QAAQ,EAAE,CACnB,CAAC;QACF,GAAG,GAAG,IAAI,iBAAiB,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,4CAA4C;QACzF,2FAA2F;QAC3F,yFAAyF;QACzF,MAAM,KAAK,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAClD,KAAK,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;gBACtC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,OAAO;oBAAE,OAAO,EAAE,CAAC;qBACjC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,QAAQ;oBAC9B,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,KAAe,EAAE,CAAC,CAAC,CAAC;YACrE,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9F,CAAC,CAAC,CAAC;QACH,6DAA6D;QAC7D,MAAM,QAAQ,GAAG,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3F,IAAI,CAAC;YACH,KAAK,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,QAAQ,CAAC,CAAC;YAC3E,MAAM,KAAK,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,uDAAuD;YAC1E,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACnC,OAAO,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;IACpC,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,EAAE,GAAG,OAAmE,CAAC;IAC/E,MAAM,IAAI,GAAG,CAAC,OAAe,EAAE,EAAE;QAC/B,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACvE,kBAAkB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAChC,EAAE,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;QAChE,yFAAyF;QACzF,OAAO,IAAI,gBAAgB,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,EAAG,OAA2B,CAAC,IAAI,CAAC,CAAC;IAC3F,CAAC,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QACzB,OAAO;QACP,OAAO,EAAE,KAAK,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC;KAChC,CAAC,CAAC;AACL,CAAC;AAED,4EAA4E;AAC5E,KAAK,UAAU,gBAAgB,CAC7B,MAAsB,EACtB,IAAmC,EACnC,KAAkB;IAElB,MAAM,KAAK,GAAG,MAAM,CAAC,mBAAmB,IAAI,EAAE,CAAC;IAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC;IACpE,IAAI,UAAU,EAAE,CAAC;QACf,kBAAkB,EAAE,CAAC;QACrB,+FAA+F;QAC/F,iFAAiF;QAChF,UAAsC,CAAC,kBAAkB,GAAG,CAC3D,MAAM,MAAM,CAAC,oCAAoC,CAAC,CACnD,CAAC,mBAAmB,CAAC;QACtB,IAAI,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;YACjC,yFAAyF;YACxF,UAAsC,CAAC,iBAAiB,GAAG,GAAG,CAAC;YAChE,MAAM,CAAC,MAAM,CAAE,UAA2D,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC/F,CAAC;QACD,0FAA0F;QAC1F,6FAA6F;QAC7F,8FAA8F;QAC9F,oBAAoB;QACpB,mBAAmB,EAAE,CAAC;IACxB,CAAC;IACD,MAAM,OAAO,GAAG;QACd,GAAG,cAAc;QACjB,OAAO,EAAE,cAAc,CAAC,YAAY;QACpC,QAAQ,EAAE,cAAc,CAAC,aAAa;QACtC,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,gCAAgC,CAAC;YAC7D,CAAC,CAAC,cAAc,CAAC,qBAAqB;YACtC,CAAC,CAAC,cAAc,CAAC,aAAa;KACjC,CAAC;IACF,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,mBAAmB,CAAC;YAClB,aAAa;YACb,oBAAoB,EAAE;gBACpB,GAAG,aAAa;gBAChB,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B;YACD,YAAY,EAAE,GAAG,IAAI,CAAC,IAAI,SAAS;YACnC,WAAW,EAAE,MAAM,MAAM,CAAC,uBAAuB,CAAC;YAClD,GAAG,OAAO;YACV,wFAAwF;YACxF,uBAAuB;YACvB,IAAI,EAAE,UAAU;gBACd,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,oCAAoC,CAAC,CAAC,CAAC,mBAAmB;gBAC1E,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI;YAChB,CAAC,CAAC,MAAM,MAAM,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC,IAAI,aAAa,MAAM,CAAC,IAAI,EAAE,CAAC;YACzE,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACtB,CAAC;IACD,MAAM,CAAC,GAAG,UAAqC,CAAC;IAChD,CAAC,CAAC,oBAAoB,GAAG,aAAa,CAAC;IACvC,CAAC,CAAC,mBAAmB,GAAG,KAAK,CAAC,CAAC,yDAAyD;IACxF,CAAC,CAAC,cAAc,GAAG,OAAO,CAAC;IAC3B,OAAO,IAAI,CAAC,MAAM;QAChB,CAAC,CAAC,MAAM,MAAM;QACV,kBAAkB,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAC7F;QACH,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAA2B;IACrE,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9D,0FAA0F;IAC1F,MAAM,OAAO,GACX,IAAI,CAAC,MAAM,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM;QACjC,CAAC,CAAC,MAAM,SAAS,CACb,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,MAAM,CAAC,GAAG,EACf,IAAI,CAAC,MAAM,CAAC,YAAY,EACxB,IAAI,CAAC,MAAM,CAAC,KAAK,EACjB,IAAI,CAAC,MAAM,CAAC,QAAQ,CACrB;QACH,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM;YACnC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAgB,CAAC,EAAE;gBACrD,OAAO,KAAI,CAAC;gBACZ,OAAO,EAAE,KAAK,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC;aAChC,CAAC;YACJ,CAAC,CAAC,MAAM,aAAa,CAAC,IAAI,CAAC,OAAgB,EAAE;gBACzC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,eAAe,EAAE,EAAE,EAAE,kCAAkC;aACxD,CAAC,CAAC;IACX,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;IACpD,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC;QAChC,UAAU,EAAE,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;KAC3E,CAAC,CAAC;IACH,8EAA8E;IAC9E,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClG,MAAM,MAAM,GACV,IAAI,CAAC,MAAM,IAAI,KAAK;QAClB,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACpF,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,oBAAoB,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE;QACzE,OAAO;QACP,KAAK;QACL,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,mBAAmB,EAAE;QAClE,eAAe,EAAE,IAAI,CAAC,aAAa;YACjC,CAAC,CAAC,qBAAqB,CAAC;gBACpB,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,WAAW,EAAE,IAAI;gBACjB,aAAa,EAAE,GAAG,IAAI,CAAC,IAAI,MAAM;gBACjC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,uDAAuD;aAC/E,CAAC;YACJ,CAAC,CAAC,SAAS;QACb,OAAO,EAAE,MAAM,EAAE,0DAA0D;QAC3E,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,EAAE,EAAE,IAAI,CAAC,EAAE;KACZ,CAAC,CAAC;IACH,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,OAAO;QACL,OAAO;QACP,WAAW;QACX,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,sDAAsD;QAC3E,CAAC;KACF,CAAC;AACJ,CAAC","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"]}
+{"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  hasNodeCompat,\n  loadProjectBindings,\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 = hasNodeCompat(config);\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    bindings: await loadProjectBindings(opts.config),\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/dist/project/browser-load.d.ts

@@ -1,9 +1,11 @@
 /**
  * `loadProject` in a browser (`@statewalker/cellb/browser`), in a Dedicated Worker: fetches a
- * folder written by `cellb build` and runs it with `browserProjectRuntime`.
+ * folder written by `cellb build`, or compiles a source folder with the `compile` it is given,
+ * and runs it with `browserProjectRuntime`.
  */
 import { type BrowserBucket } from "./browser-host.js";
 import { type LoadedProject, type LoadProjectOptions, type ProjectSource } from "./built-project.js";
+import { type ProjectCompiler } from "./source-project.js";
 export interface BrowserLoadProjectOptions extends LoadProjectOptions<BrowserBucket> {
     /**
      * Where loaded Workers (Worker Loader) run: the package's own isolate worker by default; a
@@ -11,12 +13,22 @@ export interface BrowserLoadProjectOptions extends LoadProjectOptions<BrowserBuc
      * realm.
      */
     isolateScript?: URL | (() => Worker) | false;
+    /**
+     * How a source folder (`wrangler.jsonc`, `main`, `package.json`, assets) becomes code, for a
+     * FilesApi that holds one: `bundleCompiler` (`@statewalker/cellb/bundle`: webrun-bundler and
+     * esbuild-wasm, one ES module) or `siteCompiler` (`@statewalker/cellb/site`: modules compiled
+     * one by one and served from a ServiceWorker). Without it, only `cellb build` folders load.
+     * A folder written by `cellb build` loads as built either way.
+     */
+    compile?: ProjectCompiler;
 }
 /**
- * Loads a built project and runs it in this worker.
+ * Loads a project and runs it in this worker.
  *
  * `source`: the URL of a `cellb build` folder (relative URLs resolve against the page or
- * worker), or a FilesApi holding one. `options.data` names the OPFS pool (`<data>`) and the
- * project's files directory (`<data>-files`); it defaults to the project's `name`.
+ * worker), or a FilesApi holding one — or, with `options.compile`, a FilesApi holding the
+ * project's sources (`wrangler.jsonc` and `main` at its root, `package.json`, assets).
+ * `options.data` names the OPFS pool (`<data>`) and the project's files directory
+ * (`<data>-files`); it defaults to the project's `name`.
  */
 export declare function loadProject(source: ProjectSource, options?: BrowserLoadProjectOptions): Promise<LoadedProject>;

package/dist/project/browser-load.js

@@ -1,17 +1,21 @@
 /**
  * `loadProject` in a browser (`@statewalker/cellb/browser`), in a Dedicated Worker: fetches a
- * folder written by `cellb build` and runs it with `browserProjectRuntime`.
+ * folder written by `cellb build`, or compiles a source folder with the `compile` it is given,
+ * and runs it with `browserProjectRuntime`.
  */
 import { browserProjectRuntime } from "./browser-host.js";
 import { BUILD_MANIFEST, filesApiReader, isFilesApi, readBuildManifest, readBuiltProject, urlReader, } from "./built-project.js";
+import { hasNodeCompat, readSourceProject, WRANGLER_FILES, } from "./source-project.js";
 /** The isolate worker this package ships (bundlers follow the `new Worker(new URL(…))` form). */
 const ownIsolate = () => new Worker(new URL("../isolate/isolate-worker.js", import.meta.url), { type: "module" });
 /**
- * Loads a built project and runs it in this worker.
+ * Loads a project and runs it in this worker.
  *
  * `source`: the URL of a `cellb build` folder (relative URLs resolve against the page or
- * worker), or a FilesApi holding one. `options.data` names the OPFS pool (`<data>`) and the
- * project's files directory (`<data>-files`); it defaults to the project's `name`.
+ * worker), or a FilesApi holding one — or, with `options.compile`, a FilesApi holding the
+ * project's sources (`wrangler.jsonc` and `main` at its root, `package.json`, assets).
+ * `options.data` names the OPFS pool (`<data>`) and the project's files directory
+ * (`<data>-files`); it defaults to the project's `name`.
  */
 export async function loadProject(source, options = {}) {
     let reader;
@@ -28,15 +32,41 @@ export async function loadProject(source, options = {}) {
         where = url.href;
     }
     const manifest = await readBuildManifest(reader);
-    if (!manifest)
-        throw new Error(`${where} has no ${BUILD_MANIFEST}: browsers load folders written by \`cellb build\``);
-    const built = await readBuiltProject(reader, manifest);
+    let built;
+    let compiled;
+    if (manifest)
+        built = await readBuiltProject(reader, manifest);
+    else if (isFilesApi(source) && options.compile) {
+        const project = await readSourceProject(source);
+        if (!project)
+            throw new Error(`the FilesApi has neither ${BUILD_MANIFEST} nor ${WRANGLER_FILES.join(" nor ")}`);
+        const { config } = project;
+        compiled = config.main
+            ? await options.compile.compile({ files: source, config, nodeCompat: hasNodeCompat(config) })
+            : { code: { bundle: null } };
+        built = { config, code: null, assets: project.assets ?? new Map() };
+    }
+    else
+        throw new Error(isFilesApi(source)
+            ? `${where} has no ${BUILD_MANIFEST}: pass \`compile\` to load a source folder, or load a folder written by \`cellb build\``
+            : `${where} has no ${BUILD_MANIFEST}: browsers load folders written by \`cellb build\` by URL (a source folder loads from a FilesApi, with \`compile\`)`);
+    try {
+        const close = compiled?.close?.bind(compiled);
+        const release = close && (() => close());
+        return await run(built, compiled?.code ?? { bundle: built.code }, options, release);
+    }
+    catch (err) {
+        await compiled?.close?.().catch(() => { });
+        throw err;
+    }
+}
+async function run(built, code, options, release) {
     const data = options.data ?? built.config.name ?? "cellb";
     const sqlite3 = options.sqlite3 ?? (await defaultSqlite3());
     const isolateScript = options.isolateScript === false ? undefined : (options.isolateScript ?? ownIsolate);
     const project = await browserProjectRuntime({
         config: built.config,
-        code: { bundle: built.code },
+        code,
         assetFiles: built.assets,
         sqlite3,
         pool: data,
@@ -51,7 +81,14 @@ export async function loadProject(source, options = {}) {
         runtime,
         unsupported: project.unsupported,
         fetch: (req) => runtime.fetch(req),
-        close: project.close,
+        close: async () => {
+            try {
+                await project.close();
+            }
+            finally {
+                await release?.();
+            }
+        },
     };
 }
 let sqlite3Module;

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

@@ -1 +1 @@
-{"version":3,"file":"browser-load.js","sourceRoot":"","sources":["../../src/project/browser-load.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAsB,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EACL,cAAc,EACd,cAAc,EACd,UAAU,EAIV,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,GACV,MAAM,oBAAoB,CAAC;AAW5B,iGAAiG;AACjG,MAAM,UAAU,GAAG,GAAG,EAAE,CACtB,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,8BAA8B,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;AAE3F;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAqB,EACrB,OAAO,GAA8B,EAAE;IAEvC,IAAI,MAAoC,CAAC;IACzC,IAAI,KAAa,CAAC;IAClB,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAChC,KAAK,GAAG,cAAc,CAAC;IACzB,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAG,UAAsC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC5F,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC;QACrD,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QACxB,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC;IACnB,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,CAAC,QAAQ;QACX,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,WAAW,cAAc,oDAAoD,CACtF,CAAC;IACJ,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC;IAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,MAAM,cAAc,EAAE,CAAC,CAAC;IAC5D,MAAM,aAAa,GACjB,OAAO,CAAC,aAAa,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,IAAI,UAAU,CAAC,CAAC;IACtF,MAAM,OAAO,GAAG,MAAM,qBAAqB,CAAC;QAC1C,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE;QAC5B,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,OAAO;QACP,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,GAAG,IAAI,QAAQ;QACzB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,aAAa;KACd,CAAC,CAAC;IACH,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC5B,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO;QACP,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC;AACJ,CAAC;AAED,IAAI,aAA2C,CAAC;AAChD,8DAA8D;AAC9D,SAAS,cAAc;IACrB,aAAa,KAAK,MAAM,CAAC,yBAAyB,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAC5E,IAAwC,CAAC,EAAE,KAAK,KAAI,CAAC,EAAE,QAAQ,KAAI,CAAC,EAAE,CAAC,CACzE,CAAC;IACF,OAAO,aAAa,CAAC;AACvB,CAAC","sourcesContent":["/**\n * `loadProject` in a browser (`@statewalker/cellb/browser`), in a Dedicated Worker: fetches a\n * folder written by `cellb build` and runs it with `browserProjectRuntime`.\n */\n\nimport { type BrowserBucket, browserProjectRuntime } from \"./browser-host.js\";\nimport {\n  BUILD_MANIFEST,\n  filesApiReader,\n  isFilesApi,\n  type LoadedProject,\n  type LoadProjectOptions,\n  type ProjectSource,\n  readBuildManifest,\n  readBuiltProject,\n  urlReader,\n} from \"./built-project.js\";\n\nexport interface BrowserLoadProjectOptions extends LoadProjectOptions<BrowserBucket> {\n  /**\n   * Where loaded Workers (Worker Loader) run: the package's own isolate worker by default; a\n   * script URL or a function starting a Dedicated Worker instead; `false` to run them in this\n   * realm.\n   */\n  isolateScript?: URL | (() => Worker) | false;\n}\n\n/** The isolate worker this package ships (bundlers follow the `new Worker(new URL(…))` form). */\nconst ownIsolate = () =>\n  new Worker(new URL(\"../isolate/isolate-worker.ts\", import.meta.url), { type: \"module\" });\n\n/**\n * Loads a built project and runs it in this worker.\n *\n * `source`: the URL of a `cellb build` folder (relative URLs resolve against the page or\n * worker), or a FilesApi holding one. `options.data` names the OPFS pool (`<data>`) and the\n * project's files directory (`<data>-files`); it defaults to the project's `name`.\n */\nexport async function loadProject(\n  source: ProjectSource,\n  options: BrowserLoadProjectOptions = {},\n): Promise<LoadedProject> {\n  let reader: ReturnType<typeof urlReader>;\n  let where: string;\n  if (isFilesApi(source)) {\n    reader = filesApiReader(source);\n    where = \"the FilesApi\";\n  } else {\n    const url = new URL(String(source), (globalThis as { location?: Location }).location?.href);\n    if (!url.pathname.endsWith(\"/\")) url.pathname += \"/\";\n    reader = urlReader(url);\n    where = url.href;\n  }\n  const manifest = await readBuildManifest(reader);\n  if (!manifest)\n    throw new Error(\n      `${where} has no ${BUILD_MANIFEST}: browsers load folders written by \\`cellb build\\``,\n    );\n  const built = await readBuiltProject(reader, manifest);\n  const data = options.data ?? built.config.name ?? \"cellb\";\n  const sqlite3 = options.sqlite3 ?? (await defaultSqlite3());\n  const isolateScript =\n    options.isolateScript === false ? undefined : (options.isolateScript ?? ownIsolate);\n  const project = await browserProjectRuntime({\n    config: built.config,\n    code: { bundle: built.code },\n    assetFiles: built.assets,\n    sqlite3,\n    pool: data,\n    filesDir: `${data}-files`,\n    bucket: options.bucket,\n    ai: options.ai,\n    isolateScript,\n  });\n  const { runtime } = project;\n  return {\n    config: built.config,\n    runtime,\n    unsupported: project.unsupported,\n    fetch: (req) => runtime.fetch(req),\n    close: project.close,\n  };\n}\n\nlet sqlite3Module: Promise<unknown> | undefined;\n/** `@sqlite.org/sqlite-wasm`, initialized once per worker. */\nfunction defaultSqlite3(): Promise<unknown> {\n  sqlite3Module ??= import(\"@sqlite.org/sqlite-wasm\").then(({ default: init }) =>\n    (init as (o: object) => Promise<unknown>)({ print() {}, printErr() {} }),\n  );\n  return sqlite3Module;\n}\n"]}
+{"version":3,"file":"browser-load.js","sourceRoot":"","sources":["../../src/project/browser-load.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `loadProject` in a browser (`@statewalker/cellb/browser`), in a Dedicated Worker: fetches a\n * folder written by `cellb build`, or compiles a source folder with the `compile` it is given,\n * and runs it with `browserProjectRuntime`.\n */\n\nimport { type BrowserBucket, browserProjectRuntime } from \"./browser-host.js\";\nimport {\n  BUILD_MANIFEST,\n  type BuiltProject,\n  filesApiReader,\n  isFilesApi,\n  type LoadedProject,\n  type LoadProjectOptions,\n  type ProjectSource,\n  readBuildManifest,\n  readBuiltProject,\n  urlReader,\n} from \"./built-project.js\";\nimport {\n  type CompiledProject,\n  hasNodeCompat,\n  type ProjectCompiler,\n  readSourceProject,\n  WRANGLER_FILES,\n} from \"./source-project.js\";\n\nexport interface BrowserLoadProjectOptions extends LoadProjectOptions<BrowserBucket> {\n  /**\n   * Where loaded Workers (Worker Loader) run: the package's own isolate worker by default; a\n   * script URL or a function starting a Dedicated Worker instead; `false` to run them in this\n   * realm.\n   */\n  isolateScript?: URL | (() => Worker) | false;\n  /**\n   * How a source folder (`wrangler.jsonc`, `main`, `package.json`, assets) becomes code, for a\n   * FilesApi that holds one: `bundleCompiler` (`@statewalker/cellb/bundle`: webrun-bundler and\n   * esbuild-wasm, one ES module) or `siteCompiler` (`@statewalker/cellb/site`: modules compiled\n   * one by one and served from a ServiceWorker). Without it, only `cellb build` folders load.\n   * A folder written by `cellb build` loads as built either way.\n   */\n  compile?: ProjectCompiler;\n}\n\n/** The isolate worker this package ships (bundlers follow the `new Worker(new URL(…))` form). */\nconst ownIsolate = () =>\n  new Worker(new URL(\"../isolate/isolate-worker.ts\", import.meta.url), { type: \"module\" });\n\n/**\n * Loads a project and runs it in this worker.\n *\n * `source`: the URL of a `cellb build` folder (relative URLs resolve against the page or\n * worker), or a FilesApi holding one — or, with `options.compile`, a FilesApi holding the\n * project's sources (`wrangler.jsonc` and `main` at its root, `package.json`, assets).\n * `options.data` names the OPFS pool (`<data>`) and the project's files directory\n * (`<data>-files`); it defaults to the project's `name`.\n */\nexport async function loadProject(\n  source: ProjectSource,\n  options: BrowserLoadProjectOptions = {},\n): Promise<LoadedProject> {\n  let reader: ReturnType<typeof urlReader>;\n  let where: string;\n  if (isFilesApi(source)) {\n    reader = filesApiReader(source);\n    where = \"the FilesApi\";\n  } else {\n    const url = new URL(String(source), (globalThis as { location?: Location }).location?.href);\n    if (!url.pathname.endsWith(\"/\")) url.pathname += \"/\";\n    reader = urlReader(url);\n    where = url.href;\n  }\n  const manifest = await readBuildManifest(reader);\n  let built: BuiltProject;\n  let compiled: CompiledProject | undefined;\n  if (manifest) built = await readBuiltProject(reader, manifest);\n  else if (isFilesApi(source) && options.compile) {\n    const project = await readSourceProject(source);\n    if (!project)\n      throw new Error(\n        `the FilesApi has neither ${BUILD_MANIFEST} nor ${WRANGLER_FILES.join(\" nor \")}`,\n      );\n    const { config } = project;\n    compiled = config.main\n      ? await options.compile.compile({ files: source, config, nodeCompat: hasNodeCompat(config) })\n      : { code: { bundle: null } };\n    built = { config, code: null, assets: project.assets ?? new Map() };\n  } else\n    throw new Error(\n      isFilesApi(source)\n        ? `${where} has no ${BUILD_MANIFEST}: pass \\`compile\\` to load a source folder, or load a folder written by \\`cellb build\\``\n        : `${where} has no ${BUILD_MANIFEST}: browsers load folders written by \\`cellb build\\` by URL (a source folder loads from a FilesApi, with \\`compile\\`)`,\n    );\n  try {\n    const close = compiled?.close?.bind(compiled);\n    const release = close && (() => close());\n    return await run(built, compiled?.code ?? { bundle: built.code }, options, release);\n  } catch (err) {\n    await compiled?.close?.().catch(() => {});\n    throw err;\n  }\n}\n\nasync function run(\n  built: BuiltProject,\n  code: CompiledProject[\"code\"],\n  options: BrowserLoadProjectOptions,\n  release?: () => Promise<void>,\n): Promise<LoadedProject> {\n  const data = options.data ?? built.config.name ?? \"cellb\";\n  const sqlite3 = options.sqlite3 ?? (await defaultSqlite3());\n  const isolateScript =\n    options.isolateScript === false ? undefined : (options.isolateScript ?? ownIsolate);\n  const project = await browserProjectRuntime({\n    config: built.config,\n    code,\n    assetFiles: built.assets,\n    sqlite3,\n    pool: data,\n    filesDir: `${data}-files`,\n    bucket: options.bucket,\n    ai: options.ai,\n    isolateScript,\n  });\n  const { runtime } = project;\n  return {\n    config: built.config,\n    runtime,\n    unsupported: project.unsupported,\n    fetch: (req) => runtime.fetch(req),\n    close: async () => {\n      try {\n        await project.close();\n      } finally {\n        await release?.();\n      }\n    },\n  };\n}\n\nlet sqlite3Module: Promise<unknown> | undefined;\n/** `@sqlite.org/sqlite-wasm`, initialized once per worker. */\nfunction defaultSqlite3(): Promise<unknown> {\n  sqlite3Module ??= import(\"@sqlite.org/sqlite-wasm\").then(({ default: init }) =>\n    (init as (o: object) => Promise<unknown>)({ print() {}, printErr() {} }),\n  );\n  return sqlite3Module;\n}\n"]}

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

@@ -1,28 +1,7 @@
 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`): it serves through
- * the ServiceWorker's router (webrun-http-browser's `serveHttpInWorker`), which the tab attaches
- * it to, and reaches the other shards through it.
- */
-export declare const TAB_INIT = "cellb:tab-shard";
-/** The host calls between shards go to through the router: `http://cellb.internal/<project>/`. */
-export declare const INTERNAL_ORIGIN = "http://cellb.internal";
-/** 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;
-}
+import { INTERNAL_ORIGIN, TAB_INIT, type TabShardInit } from "./browser-tab-protocol.js";
+export { INTERNAL_ORIGIN, TAB_INIT, type TabShardInit };
 /**
  * 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).

package/dist/project/browser-shards.js

@@ -18,16 +18,10 @@ import { H, keepUpgrade } from "../transport/cells-link.js";
 import { connectRuntime, linkOverPort, serveRuntime } from "../transport/port.js";
 import { CellsResponse, CfWebSocket, takeClientPort } from "../ws/server.js";
 import { browserProjectRuntime, } from "./browser-host.js";
+import { INTERNAL_ORIGIN, TAB_INIT } from "./browser-tab-protocol.js";
+export { INTERNAL_ORIGIN, TAB_INIT };
 const INIT = "cellb:shard";
 const CLOSE = "cellb:shard-close";
-/**
- * A shard of a project shared by the tabs of an origin (`joinProjectShards`): it serves through
- * the ServiceWorker's router (webrun-http-browser's `serveHttpInWorker`), which the tab attaches
- * it to, and reaches the other shards through it.
- */
-export const TAB_INIT = "cellb:tab-shard";
-/** The host calls between shards go to through the router: `http://cellb.internal/<project>/`. */
-export const INTERNAL_ORIGIN = "http://cellb.internal";
 /**
  * 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).