@statewalker/cellb 0.6.0 → 0.8.0

package/dist/project/site-compiler.js

@@ -0,0 +1,134 @@
+import { HostedSiteBuilder } from "@statewalker/webrun-site-host";
+import { linkOverPort, serveHandlerOverPort } from "../transport/port.js";
+import { createProjectSite } from "./site.js";
+/** The default host: a ServiceWorker registered from this realm. */
+function serviceWorkerHost(serviceWorkerUrl) {
+    return async (handler) => {
+        if (!globalThis.navigator?.serviceWorker)
+            throw new Error("siteCompiler: this realm cannot register a ServiceWorker (a Dedicated Worker cannot): " +
+                "pass `host: siteHostOverPort(port)` and call `hostSitesForWorker(port)` in the page");
+        const builder = new HostedSiteBuilder().setHandler(handler);
+        if (serviceWorkerUrl)
+            builder.setServiceWorkerUrl(serviceWorkerUrl);
+        const site = await builder.build();
+        return { baseUrl: site.baseUrl, stop: () => site.stop() };
+    };
+}
+/**
+ * A compiler for `loadProject(files, { compile })` that serves the project's modules from an
+ * in-browser HTTP server (`createProjectSite`): `main` and Worker Loader code are imported from
+ * it, so a change can rebuild one module. The site stops when the project closes.
+ */
+export function siteCompiler(options = {}) {
+    const host = options.host ?? serviceWorkerHost(options.serviceWorkerUrl);
+    return {
+        kind: "site",
+        async compile({ files, nodeCompat }) {
+            let nodeModules;
+            if (nodeCompat) {
+                // The served `node:*` proxies take their export names from the registry entries, which
+                // the browser host binds in this realm; the npm `util` polyfill reads `process` when it
+                // is imported.
+                (await import("../node-compat/install.js")).installNodeGlobals();
+                nodeModules = (await import("../node-compat/browser-registry.js")).nodeRegistryEntries;
+            }
+            const handler = createProjectSite({
+                projectFiles: files,
+                nodeCompat,
+                nodeModules,
+                lowerAwait: options.lowerAwait,
+            });
+            const site = await host(handler);
+            const baseUrl = site.baseUrl.endsWith("/") ? site.baseUrl : `${site.baseUrl}/`;
+            return { code: { site: baseUrl }, close: () => site.stop() };
+        },
+    };
+}
+const HOST_SITE = "cellb:host-site";
+const STOP_SITE = "cellb:stop-site";
+/** The next message on `port`, or `{ error }` after `timeoutMs` (a page that never answers). */
+const once = (port, timeoutMs) => new Promise((resolve) => {
+    const timer = setTimeout(() => resolve({ error: `no answer in ${timeoutMs} ms (does the page run hostSitesForWorker?)` }), timeoutMs);
+    port.onmessage = (e) => {
+        clearTimeout(timer);
+        resolve(e.data);
+    };
+});
+/**
+ * Worker side: hosts each site through the page at the other end of `control`, which runs
+ * `hostSitesForWorker`. The handler stays in this worker; the page's ServiceWorker forwards each
+ * request to it.
+ */
+export function siteHostOverPort(control, 
+/**
+ * How long the page may take to host the site (default 30 s; a ServiceWorker's first install
+ * can be slow), and to confirm it stopped one (default 2 s; the worker stops serving anyway).
+ */
+{ timeoutMs = 30_000, stopTimeoutMs = 2_000, } = {}) {
+    return async (handler) => {
+        const link = new MessageChannel();
+        const reply = new MessageChannel();
+        const stopServing = await serveHandlerOverPort(link.port1, handler);
+        const answered = once(reply.port1, timeoutMs);
+        const request = { type: HOST_SITE, link: link.port2, reply: reply.port2 };
+        control.postMessage(request, [link.port2, reply.port2]);
+        const { baseUrl, error } = await answered;
+        if (!baseUrl) {
+            // A page that hosts the site after all finds this stop waiting for it, and takes the site
+            // down (its port stays open for that).
+            reply.port1.onmessage = null;
+            reply.port1.postMessage({ type: STOP_SITE });
+            await stopServing();
+            throw new Error(`the page did not host the site: ${error}`);
+        }
+        return {
+            baseUrl,
+            stop: async () => {
+                // A page that does not answer stops nothing: the worker stops serving all the same.
+                const stopped = once(reply.port1, stopTimeoutMs);
+                reply.port1.postMessage({ type: STOP_SITE });
+                await stopped;
+                reply.port1.close();
+                await stopServing();
+            },
+        };
+    };
+}
+/**
+ * Page side: hosts in this page's ServiceWorker the sites a worker asks for over `control`
+ * (`siteHostOverPort`). Returns a function that stops listening; the sites stop when the worker
+ * stops them.
+ */
+export function hostSitesForWorker(control, options = {}) {
+    const listener = async (e) => {
+        const req = e.data;
+        if (req?.type !== HOST_SITE)
+            return;
+        try {
+            // The worker may give up waiting (`timeoutMs`) and ask to stop before the site is up: the
+            // stop then waits on `reply` until the handler below reads it.
+            const link = await linkOverPort(req.link);
+            const builder = new HostedSiteBuilder().setHandler(link.send);
+            if (options.serviceWorkerUrl)
+                builder.setServiceWorkerUrl(options.serviceWorkerUrl);
+            const site = await builder.build();
+            req.reply.onmessage = async (m) => {
+                if (m.data?.type !== STOP_SITE)
+                    return;
+                await site.stop().catch(() => { });
+                await link.close().catch(() => { });
+                req.reply.postMessage({ stopped: true });
+                req.reply.close();
+            };
+            req.reply.postMessage({ baseUrl: site.baseUrl });
+        }
+        catch (err) {
+            req.reply.postMessage({ error: String(err?.message ?? err) });
+            req.reply.close();
+        }
+    };
+    control.addEventListener("message", listener);
+    control.start?.();
+    return () => control.removeEventListener("message", listener);
+}
+//# sourceMappingURL=site-compiler.js.map

package/dist/project/site-compiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-compiler.js","sourceRoot":"","sources":["../../src/project/site-compiler.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `siteCompiler`: a project's sources served by an in-browser HTTP server (`createProjectSite`,\n * hosted in a ServiceWorker by webrun-site-host), for `loadProject(files, { compile })`. Modules\n * are compiled one by one as the browser imports them; nothing is bundled.\n *\n * `loadProject` runs in a Dedicated Worker, which cannot register a ServiceWorker: the site is\n * hosted by a page. `siteHostOverPort` (worker) and `hostSitesForWorker` (page) do that over a\n * MessagePort: the worker serves the site's handler, the page mounts it in its ServiceWorker.\n */\nimport type { SiteHandler } from \"@statewalker/webrun-site-builder\";\nimport { HostedSiteBuilder } from \"@statewalker/webrun-site-host\";\nimport { linkOverPort, serveHandlerOverPort } from \"../transport/port.js\";\nimport { createProjectSite } from \"./site.js\";\nimport type { ProjectCompiler } from \"./source-project.js\";\n\n/** A site, hosted: its base URL (ending in \"/\") and how to take it down. */\nexport interface HostedProjectSite {\n  baseUrl: string;\n  stop(): Promise<void>;\n}\n\n/** Hosts a site handler where this realm's code can `import()` from it. */\nexport type SiteHost = (handler: SiteHandler) => Promise<HostedProjectSite>;\n\nexport interface SiteCompilerOptions {\n  /**\n   * Where the site is hosted. Default: a ServiceWorker this realm registers (`HostedSiteBuilder`),\n   * which a page can do and a Dedicated Worker cannot; in a worker, pass `siteHostOverPort(port)`\n   * and call `hostSitesForWorker(port)` in the page.\n   */\n  host?: SiteHost;\n  /** The ServiceWorker script for the default host (default: `/sw-worker.js`). */\n  serviceWorkerUrl?: string;\n  /** `createProjectSite`'s `lowerAwait` (default: with nodejs_compat, unless AsyncContext). */\n  lowerAwait?: boolean;\n}\n\n/** The default host: a ServiceWorker registered from this realm. */\nfunction serviceWorkerHost(serviceWorkerUrl?: string): SiteHost {\n  return async (handler) => {\n    if (!(globalThis as { navigator?: { serviceWorker?: unknown } }).navigator?.serviceWorker)\n      throw new Error(\n        \"siteCompiler: this realm cannot register a ServiceWorker (a Dedicated Worker cannot): \" +\n          \"pass `host: siteHostOverPort(port)` and call `hostSitesForWorker(port)` in the page\",\n      );\n    const builder = new HostedSiteBuilder().setHandler(handler);\n    if (serviceWorkerUrl) builder.setServiceWorkerUrl(serviceWorkerUrl);\n    const site = await builder.build();\n    return { baseUrl: site.baseUrl, stop: () => site.stop() };\n  };\n}\n\n/**\n * A compiler for `loadProject(files, { compile })` that serves the project's modules from an\n * in-browser HTTP server (`createProjectSite`): `main` and Worker Loader code are imported from\n * it, so a change can rebuild one module. The site stops when the project closes.\n */\nexport function siteCompiler(options: SiteCompilerOptions = {}): ProjectCompiler {\n  const host = options.host ?? serviceWorkerHost(options.serviceWorkerUrl);\n  return {\n    kind: \"site\",\n    async compile({ files, nodeCompat }) {\n      let nodeModules: Record<string, unknown> | undefined;\n      if (nodeCompat) {\n        // The served `node:*` proxies take their export names from the registry entries, which\n        // the browser host binds in this realm; the npm `util` polyfill reads `process` when it\n        // is imported.\n        (await import(\"../node-compat/install.js\")).installNodeGlobals();\n        nodeModules = (await import(\"../node-compat/browser-registry.js\")).nodeRegistryEntries;\n      }\n      const handler = createProjectSite({\n        projectFiles: files,\n        nodeCompat,\n        nodeModules,\n        lowerAwait: options.lowerAwait,\n      });\n      const site = await host(handler);\n      const baseUrl = site.baseUrl.endsWith(\"/\") ? site.baseUrl : `${site.baseUrl}/`;\n      return { code: { site: baseUrl }, close: () => site.stop() };\n    },\n  };\n}\n\nconst HOST_SITE = \"cellb:host-site\";\nconst STOP_SITE = \"cellb:stop-site\";\n\n/**\n * Where a worker and its page talk about sites: a MessagePort, the `Worker` (page side) or the\n * worker's own scope (`self`). Other messages on it are left alone.\n */\nexport interface SiteControl {\n  postMessage(message: unknown, transfer: Transferable[]): void;\n  addEventListener(type: \"message\", listener: (e: MessageEvent) => void): void;\n  removeEventListener(type: \"message\", listener: (e: MessageEvent) => void): void;\n}\n\n/** What a worker asks its page for, on the control port. */\ninterface HostSiteRequest {\n  type: typeof HOST_SITE;\n  /** The worker serves the site's handler on this port's other end. */\n  link: MessagePort;\n  /** The page answers here, and the worker asks to stop here. */\n  reply: MessagePort;\n}\n\n/** The next message on `port`, or `{ error }` after `timeoutMs` (a page that never answers). */\nconst once = (port: MessagePort, timeoutMs: number) =>\n  new Promise<{ baseUrl?: string; error?: string }>((resolve) => {\n    const timer = setTimeout(\n      () =>\n        resolve({ error: `no answer in ${timeoutMs} ms (does the page run hostSitesForWorker?)` }),\n      timeoutMs,\n    );\n    port.onmessage = (e) => {\n      clearTimeout(timer);\n      resolve(e.data);\n    };\n  });\n\n/**\n * Worker side: hosts each site through the page at the other end of `control`, which runs\n * `hostSitesForWorker`. The handler stays in this worker; the page's ServiceWorker forwards each\n * request to it.\n */\nexport function siteHostOverPort(\n  control: SiteControl,\n  /**\n   * How long the page may take to host the site (default 30 s; a ServiceWorker's first install\n   * can be slow), and to confirm it stopped one (default 2 s; the worker stops serving anyway).\n   */\n  {\n    timeoutMs = 30_000,\n    stopTimeoutMs = 2_000,\n  }: { timeoutMs?: number; stopTimeoutMs?: number } = {},\n): SiteHost {\n  return async (handler) => {\n    const link = new MessageChannel();\n    const reply = new MessageChannel();\n    const stopServing = await serveHandlerOverPort(link.port1, handler);\n    const answered = once(reply.port1, timeoutMs);\n    const request: HostSiteRequest = { type: HOST_SITE, link: link.port2, reply: reply.port2 };\n    control.postMessage(request, [link.port2, reply.port2]);\n    const { baseUrl, error } = await answered;\n    if (!baseUrl) {\n      // A page that hosts the site after all finds this stop waiting for it, and takes the site\n      // down (its port stays open for that).\n      reply.port1.onmessage = null;\n      reply.port1.postMessage({ type: STOP_SITE });\n      await stopServing();\n      throw new Error(`the page did not host the site: ${error}`);\n    }\n    return {\n      baseUrl,\n      stop: async () => {\n        // A page that does not answer stops nothing: the worker stops serving all the same.\n        const stopped = once(reply.port1, stopTimeoutMs);\n        reply.port1.postMessage({ type: STOP_SITE });\n        await stopped;\n        reply.port1.close();\n        await stopServing();\n      },\n    };\n  };\n}\n\n/**\n * Page side: hosts in this page's ServiceWorker the sites a worker asks for over `control`\n * (`siteHostOverPort`). Returns a function that stops listening; the sites stop when the worker\n * stops them.\n */\nexport function hostSitesForWorker(\n  control: SiteControl,\n  options: { serviceWorkerUrl?: string } = {},\n): () => void {\n  const listener = async (e: MessageEvent) => {\n    const req = e.data as HostSiteRequest | undefined;\n    if (req?.type !== HOST_SITE) return;\n    try {\n      // The worker may give up waiting (`timeoutMs`) and ask to stop before the site is up: the\n      // stop then waits on `reply` until the handler below reads it.\n      const link = await linkOverPort(req.link);\n      const builder = new HostedSiteBuilder().setHandler(link.send);\n      if (options.serviceWorkerUrl) builder.setServiceWorkerUrl(options.serviceWorkerUrl);\n      const site = await builder.build();\n      req.reply.onmessage = async (m) => {\n        if ((m.data as { type?: string })?.type !== STOP_SITE) return;\n        await site.stop().catch(() => {});\n        await link.close().catch(() => {});\n        req.reply.postMessage({ stopped: true });\n        req.reply.close();\n      };\n      req.reply.postMessage({ baseUrl: site.baseUrl });\n    } catch (err) {\n      req.reply.postMessage({ error: String((err as Error)?.message ?? err) });\n      req.reply.close();\n    }\n  };\n  control.addEventListener(\"message\", listener);\n  (control as { start?: () => void }).start?.();\n  return () => control.removeEventListener(\"message\", listener);\n}\n"]}

package/dist/project/source-project.d.ts

@@ -0,0 +1,46 @@
+/**
+ * A project's sources (`wrangler.jsonc`, `main`, `package.json`, assets) in a FilesApi, and the
+ * compilers that turn them into code `browserProjectRuntime` runs (`loadProject`'s `compile`).
+ *
+ * Platform-neutral and free of compilers: a compiler is made by the entry point that owns it
+ * (`bundleCompiler` in `@statewalker/cellb/bundle`, `siteCompiler` in `@statewalker/cellb/site`),
+ * so a plain `loadProject` ships neither esbuild-wasm nor webrun-modules.
+ */
+import type { FilesApi } from "@statewalker/webrun-files";
+import type { AssetFiles } from "../bindings/assets.js";
+import { hasNodeCompat, WRANGLER_FILES, type WranglerConfig } from "./wrangler.js";
+export { hasNodeCompat, WRANGLER_FILES };
+/** A source project read from a FilesApi: what a compiler needs besides the files. */
+export interface SourceProject {
+    config: WranglerConfig;
+    /** The files of `assets.directory` ("/index.html" → bytes), or undefined without assets. */
+    assets?: AssetFiles;
+}
+/** What a compiler gives `browserProjectRuntime`: the project's code, and what to stop after. */
+export interface CompiledProject {
+    /** `browserProjectRuntime`'s `code`. */
+    code: {
+        bundle: string | null;
+    } | {
+        site: string;
+    };
+    /** Releases what the compiler holds (a site's ServiceWorker registration); after `close()`. */
+    close?(): Promise<void>;
+}
+/** Turns a source project into code for `browserProjectRuntime` (`loadProject`'s `compile`). */
+export interface ProjectCompiler {
+    /** A name for messages ("bundle", "site"). */
+    readonly kind: string;
+    compile(project: {
+        /** The project's files, its configuration at the root. */
+        files: FilesApi;
+        config: WranglerConfig;
+        /** Whether the project has `nodejs_compat` (or a `nodejs_compat_*` flag). */
+        nodeCompat: boolean;
+    }): Promise<CompiledProject>;
+}
+/**
+ * Reads a source folder at the root of `files`: its `wrangler.jsonc` (or `wrangler.json`) and the
+ * files of its `assets.directory`. Undefined when there is no configuration.
+ */
+export declare function readSourceProject(files: FilesApi): Promise<SourceProject | undefined>;

package/dist/project/source-project.js

@@ -0,0 +1,45 @@
+import { filesApiReader, readJson } from "./built-project.js";
+import { hasNodeCompat, WRANGLER_FILES } from "./wrangler.js";
+export { hasNodeCompat, WRANGLER_FILES };
+/**
+ * Reads a source folder at the root of `files`: its `wrangler.jsonc` (or `wrangler.json`) and the
+ * files of its `assets.directory`. Undefined when there is no configuration.
+ */
+export async function readSourceProject(files) {
+    const reader = filesApiReader(files);
+    let config;
+    for (const name of WRANGLER_FILES) {
+        config = await readJson(reader, name);
+        if (config)
+            break;
+    }
+    if (!config)
+        return undefined;
+    if (!config.main && !config.assets)
+        throw new Error("wrangler config has neither `main` nor `assets`");
+    if (!config.assets?.directory)
+        return { config };
+    const dir = folderPath(config.assets.directory);
+    const paths = await reader.list(dir || "/");
+    const assets = new Map();
+    await Promise.all(paths.map(async (path) => {
+        const bytes = await reader.bytes(`${dir}${path}`);
+        if (bytes)
+            assets.set(path, bytes);
+    }));
+    return { config, assets };
+}
+/**
+ * A folder of the project as a path from its root, "" for the root itself: "./public/" →
+ * "/public", "." → "", "a/../b" → "/b" (as `path.resolve` takes `assets.directory` on Node).
+ */
+function folderPath(dir) {
+    const parts = [];
+    for (const part of dir.split("/"))
+        if (part === "..")
+            parts.pop();
+        else if (part && part !== ".")
+            parts.push(part);
+    return parts.map((p) => `/${p}`).join("");
+}
+//# sourceMappingURL=source-project.js.map

package/dist/project/source-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-project.js","sourceRoot":"","sources":["../../src/project/source-project.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAuB,MAAM,eAAe,CAAC;AAEnF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC;AA8BzC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAe;IACrD,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,MAAkC,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,MAAM,GAAG,MAAM,QAAQ,CAAiB,MAAM,EAAE,IAAI,CAAC,CAAC;QACtD,IAAI,MAAM;YAAE,MAAM;IACpB,CAAC;IACD,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM;QAChC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACjD,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,MAAO,MAAM,CAAC,IAAwC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;IACjF,MAAM,MAAM,GAAe,IAAI,GAAG,EAAE,CAAC;IACrC,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACvB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,IAAI,EAAE,CAAC,CAAC;QAClD,IAAI,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CACH,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,SAAS,UAAU,CAAC,GAAW;IAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC;QAC/B,IAAI,IAAI,KAAK,IAAI;YAAE,KAAK,CAAC,GAAG,EAAE,CAAC;aAC1B,IAAI,IAAI,IAAI,IAAI,KAAK,GAAG;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC5C,CAAC","sourcesContent":["/**\n * A project's sources (`wrangler.jsonc`, `main`, `package.json`, assets) in a FilesApi, and the\n * compilers that turn them into code `browserProjectRuntime` runs (`loadProject`'s `compile`).\n *\n * Platform-neutral and free of compilers: a compiler is made by the entry point that owns it\n * (`bundleCompiler` in `@statewalker/cellb/bundle`, `siteCompiler` in `@statewalker/cellb/site`),\n * so a plain `loadProject` ships neither esbuild-wasm nor webrun-modules.\n */\nimport type { FilesApi } from \"@statewalker/webrun-files\";\nimport type { AssetFiles } from \"../bindings/assets.js\";\nimport { filesApiReader, readJson } from \"./built-project.js\";\nimport { hasNodeCompat, WRANGLER_FILES, type WranglerConfig } from \"./wrangler.js\";\n\nexport { hasNodeCompat, WRANGLER_FILES };\n\n/** A source project read from a FilesApi: what a compiler needs besides the files. */\nexport interface SourceProject {\n  config: WranglerConfig;\n  /** The files of `assets.directory` (\"/index.html\" → bytes), or undefined without assets. */\n  assets?: AssetFiles;\n}\n\n/** What a compiler gives `browserProjectRuntime`: the project's code, and what to stop after. */\nexport interface CompiledProject {\n  /** `browserProjectRuntime`'s `code`. */\n  code: { bundle: string | null } | { site: string };\n  /** Releases what the compiler holds (a site's ServiceWorker registration); after `close()`. */\n  close?(): Promise<void>;\n}\n\n/** Turns a source project into code for `browserProjectRuntime` (`loadProject`'s `compile`). */\nexport interface ProjectCompiler {\n  /** A name for messages (\"bundle\", \"site\"). */\n  readonly kind: string;\n  compile(project: {\n    /** The project's files, its configuration at the root. */\n    files: FilesApi;\n    config: WranglerConfig;\n    /** Whether the project has `nodejs_compat` (or a `nodejs_compat_*` flag). */\n    nodeCompat: boolean;\n  }): Promise<CompiledProject>;\n}\n\n/**\n * Reads a source folder at the root of `files`: its `wrangler.jsonc` (or `wrangler.json`) and the\n * files of its `assets.directory`. Undefined when there is no configuration.\n */\nexport async function readSourceProject(files: FilesApi): Promise<SourceProject | undefined> {\n  const reader = filesApiReader(files);\n  let config: WranglerConfig | undefined;\n  for (const name of WRANGLER_FILES) {\n    config = await readJson<WranglerConfig>(reader, name);\n    if (config) break;\n  }\n  if (!config) return undefined;\n  if (!config.main && !config.assets)\n    throw new Error(\"wrangler config has neither `main` nor `assets`\");\n  if (!config.assets?.directory) return { config };\n  const dir = folderPath(config.assets.directory);\n  const paths = await (reader.list as NonNullable<typeof reader.list>)(dir || \"/\");\n  const assets: AssetFiles = new Map();\n  await Promise.all(\n    paths.map(async (path) => {\n      const bytes = await reader.bytes(`${dir}${path}`);\n      if (bytes) assets.set(path, bytes);\n    }),\n  );\n  return { config, assets };\n}\n\n/**\n * A folder of the project as a path from its root, \"\" for the root itself: \"./public/\" →\n * \"/public\", \".\" → \"\", \"a/../b\" → \"/b\" (as `path.resolve` takes `assets.directory` on Node).\n */\nfunction folderPath(dir: string): string {\n  const parts: string[] = [];\n  for (const part of dir.split(\"/\"))\n    if (part === \"..\") parts.pop();\n    else if (part && part !== \".\") parts.push(part);\n  return parts.map((p) => `/${p}`).join(\"\");\n}\n"]}

package/dist/project/wrangler.d.ts

@@ -1,9 +1,10 @@
 import type { FilesApi } from "@statewalker/webrun-files";
-import { type AssetFiles, type AssetsConfig } from "../bindings/assets.js";
-import { type QueueConsumerConfig } from "../bindings/celld-queues.js";
-import { type ModuleLoader } from "../bindings/worker-loader.js";
+import type { AssetFiles, AssetsConfig } from "../bindings/assets.js";
+import type { QueueConsumerConfig } from "../bindings/celld-queues.js";
+import type { ModuleLoader } from "../bindings/worker-loader.js";
 import { type WorkersAiOptions } from "../bindings/workers-ai.js";
 import { type CellRuntime, type CellRuntimeOptions, type WorkerModule } from "../core/runtime.js";
+import type { ModuleRule } from "./module-rules.js";
 /** The subset of wrangler.json(c) that celld deploys (and cellb reads). */
 export interface WranglerConfig {
     name?: string;
@@ -67,6 +68,8 @@ export interface WranglerConfig {
     ai?: {
         binding: string;
     };
+    /** Module rules: how imports of non-JS files load (`CompiledWasm`, `Data`, `Text`). */
+    rules?: ModuleRule[];
     /** Containers (celld runs them with Docker or Podman): not supported, reported. */
     containers?: {
         class_name: string;
@@ -90,7 +93,28 @@ export interface ProjectHost extends Pick<CellRuntimeOptions, "openSql" | "stora
     files: FilesApi;
     /** The OpenAI-compatible endpoint behind the `ai` binding; without it the binding is unsupported. */
     ai?: WorkersAiOptions;
+    /** The binding implementations the config needs: `await loadProjectBindings(config)`. */
+    bindings?: ProjectBindings;
 }
+/**
+ * The implementations of the bindings a project declares, loaded on demand: a project with
+ * Durable Objects only loads none of them (Miniflare's D1 simulator, celld's KV, queue and
+ * workflow code, R2, assets, cron and Worker Loaders), and a browser bundle keeps them in chunks
+ * of their own.
+ */
+export interface ProjectBindings {
+    kv?: typeof import("../bindings/celld-kv.js");
+    d1?: typeof import("../miniflare-compat/vendored.js");
+    queues?: typeof import("../bindings/celld-queues.js");
+    workflows?: typeof import("../bindings/celld-workflows.js");
+    r2?: typeof import("../bindings/r2.js");
+    r2Celld?: typeof import("../bindings/r2-celld.js");
+    cron?: typeof import("../bindings/cron.js");
+    assets?: typeof import("../bindings/assets.js");
+    workerLoader?: typeof import("../bindings/worker-loader.js");
+}
+/** Loads the binding implementations `config` declares, for `createProjectRuntime`'s host. */
+export declare function loadProjectBindings(config: WranglerConfig): Promise<ProjectBindings>;
 export interface ProjectRuntime {
     runtime: CellRuntime;
     /** Configuration entries cellb does not support yet (reported, not silently ignored). */
@@ -120,6 +144,10 @@ export declare function withResourceIds(config: WranglerConfig): WranglerConfig;
  * `nodejs_compat_do_not_populate_process_env` is set. Frameworks read their settings there
  * (EmDash's `EMDASH_SITE_URL`, for one).
  */
+/** Whether `config` asks for nodejs_compat (the flag, or a `nodejs_compat_*` one). */
+export declare function hasNodeCompat(config: WranglerConfig): boolean;
+/** The configuration files of a project folder, in the order celld reads them. */
+export declare const WRANGLER_FILES: string[];
 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/wrangler.js

@@ -1,19 +1,33 @@
-import { createAssets } from "../bindings/assets.js";
-import { celldKv } from "../bindings/celld-kv.js";
-import { celldQueues } from "../bindings/celld-queues.js";
-import { celldWorkflows } from "../bindings/celld-workflows.js";
-import { startCronTriggers } from "../bindings/cron.js";
-import { r2Bucket, r2BucketOn } from "../bindings/r2.js";
-import { celldR2Backend } from "../bindings/r2-celld.js";
-import { workerLoader } from "../bindings/worker-loader.js";
 import { workersAi } from "../bindings/workers-ai.js";
 import { entrypointStub } from "../core/handles.js";
 import { createCellRuntime, } from "../core/runtime.js";
 import { splitSqlStatements } from "../core/sql-split.js";
 import { filesApiBlobService } from "../miniflare-compat/blob-service.js";
 import { simulatorFetcher } from "../miniflare-compat/simulator-fetcher.js";
-import { D1DatabaseObject, makeD1Binding } from "../miniflare-compat/vendored.js";
 import { systemClock } from "../ports.js";
+/** Loads the binding implementations `config` declares, for `createProjectRuntime`'s host. */
+export async function loadProjectBindings(config) {
+    const when = (cond, load) => cond ? load() : Promise.resolve(undefined);
+    const [kv, d1, queues, workflows, r2, r2Celld, cron, assets, workerLoader] = await Promise.all([
+        when(config.kv_namespaces?.length, () => import("../bindings/celld-kv.js")),
+        when(config.d1_databases?.length, () => import("../miniflare-compat/vendored.js")),
+        when(config.queues?.producers?.length || config.queues?.consumers?.length, () => import("../bindings/celld-queues.js")),
+        when(config.workflows?.length, () => import("../bindings/celld-workflows.js")),
+        when(config.r2_buckets?.length, () => import("../bindings/r2.js")),
+        when(config.r2_buckets?.length, () => import("../bindings/r2-celld.js")),
+        when(config.triggers?.crons?.length, () => import("../bindings/cron.js")),
+        when(config.assets, () => import("../bindings/assets.js")),
+        when(config.worker_loaders?.length, () => import("../bindings/worker-loader.js")),
+    ]);
+    return { kv, d1, queues, workflows, r2, r2Celld, cron, assets, workerLoader };
+}
+/** The loaded implementation of a binding the config declares, or an error saying how to load it. */
+function binding(host, key, what) {
+    const m = host.bindings?.[key];
+    if (!m)
+        throw new Error(`${what}: the host has no implementation loaded; pass \`bindings: await loadProjectBindings(config)\``);
+    return m;
+}
 /**
  * What `env` of `cloudflare:workers` holds while the Worker's module is evaluated, before the
  * runtime exists: the vars, and the bindings that need no runtime (`ai`; Flue's entry reads
@@ -47,6 +61,10 @@ export function createProjectRuntime(config, module, host) {
         for (const r of m.renamed_classes ?? [])
             unsupported.push(`migrations.renamed_classes (${r.from} → ${r.to})`);
     }
+    // wrangler's module rule types: the bundles apply CompiledWasm, Data and Text (module-rules.ts)
+    for (const [i, r] of (config.rules ?? []).entries())
+        if (!["ESModule", "CommonJS", "CompiledWasm", "Data", "Text"].includes(r.type))
+            unsupported.push(`rules[${i}].type "${r.type}"`);
     for (const c of config.containers ?? [])
         unsupported.push(`containers[${c.class_name}] (cellb runs no containers)`);
     for (const b of config.durable_objects?.bindings ?? []) {
@@ -57,12 +75,12 @@ export function createProjectRuntime(config, module, host) {
     const worker = { ...module };
     let kv;
     if (config.kv_namespaces?.length) {
-        kv = celldKv(host.files);
+        kv = binding(host, "kv", "kv_namespaces").celldKv(host.files);
         worker.__KvNamespace = kv.KvNamespaceCell;
         durableObjects[KV_OBJECTS] = { className: "__KvNamespace" };
     }
     if (config.d1_databases?.length) {
-        worker.__D1Database = D1DatabaseObject;
+        worker.__D1Database = binding(host, "d1", "d1_databases").D1DatabaseObject;
         durableObjects[D1_OBJECTS] = { className: "__D1Database" };
     }
     // Queues: every queue is a cell of a runtime-supplied class (as on celld).
@@ -72,7 +90,7 @@ export function createProjectRuntime(config, module, host) {
     let queueDispatcher;
     let queues;
     if (config.queues?.producers?.length || consumers.size) {
-        queues = celldQueues({
+        queues = binding(host, "queues", "queues").celldQueues({
             namespace: () => runtime.env[QUEUE_OBJECTS],
             consumers: [...consumers.values()],
             compatibilityDate: config.compatibility_date,
@@ -85,7 +103,7 @@ export function createProjectRuntime(config, module, host) {
     // celld's own workflow code (vendor/celld/workflows.js): its instance cell and binding.
     let workflows;
     if (config.workflows?.length) {
-        workflows = celldWorkflows({
+        workflows = binding(host, "workflows", "workflows").celldWorkflows({
             script: config.name ?? "worker",
             workflows: Object.fromEntries(config.workflows.map((w) => [w.name, w.class_name])),
             exports: () => module,
@@ -170,12 +188,14 @@ export function createProjectRuntime(config, module, host) {
         };
     }
     for (const l of config.worker_loaders ?? []) {
-        if (!host.loadModules)
+        if (!host.loadModules) {
             unsupported.push(`worker_loaders[${l.binding}] (the host provides no module loader)`);
-        else
-            env[l.binding] = host.isolatedModules
-                ? workerLoader(host.isolatedModules) // facets of loaded code run in the isolate as well
-                : workerLoader(host.loadModules);
+            continue;
+        }
+        const { workerLoader } = binding(host, "workerLoader", "worker_loaders");
+        env[l.binding] = host.isolatedModules
+            ? workerLoader(host.isolatedModules) // facets of loaded code run in the isolate as well
+            : workerLoader(host.loadModules);
     }
     // Cron Triggers (validated at load time like `celld deploy` does).
     const crons = config.triggers?.crons ?? [];
@@ -185,7 +205,7 @@ export function createProjectRuntime(config, module, host) {
             unsupported.push("triggers.crons without a scheduled() handler");
         else {
             const db = host.openSql("__cellb/cron");
-            const stop = startCronTriggers(crons, (c, x) => runtime.runEvent(() => scheduled.call(module.default, c, env, x)), host.clock ?? systemClock, cronState(db));
+            const stop = binding(host, "cron", "triggers.crons").startCronTriggers(crons, (c, x) => runtime.runEvent(() => scheduled.call(module.default, c, env, x)), host.clock ?? systemClock, cronState(db));
             const close = runtime.close.bind(runtime);
             runtime.close = async () => {
                 stop();
@@ -199,7 +219,7 @@ export function createProjectRuntime(config, module, host) {
         const hasWorker = typeof module.default?.fetch === "function";
         if (host.assetFiles?.has("/.assetsignore"))
             throw new Error(`${config.assets.directory ?? "assets"}/.assetsignore is not supported by celld; remove it`);
-        const assets = createAssets(host.assetFiles ?? new Map(), config.assets, hasWorker);
+        const assets = binding(host, "assets", "assets").createAssets(host.assetFiles ?? new Map(), config.assets, hasWorker);
         if (config.assets.binding)
             env[config.assets.binding] = assets.binding;
         const workerFetch = runtime.fetch.bind(runtime);
@@ -221,12 +241,15 @@ export function createProjectRuntime(config, module, host) {
     }
     // R2 objects live directly in the host's store, as celld keeps them in the fleet bucket.
     // With a celld fleet bucket, R2 objects live in it as celld keeps them; else in the FilesApi.
-    for (const r2 of config.r2_buckets ?? [])
+    for (const r2 of config.r2_buckets ?? []) {
+        const { r2Bucket, r2BucketOn } = binding(host, "r2", "r2_buckets");
+        const { celldR2Backend } = binding(host, "r2Celld", "r2_buckets");
         env[r2.binding] = host.storage?.objects
             ? r2BucketOn(celldR2Backend(host.storage.objects, r2.bucket_name), r2.binding)
             : r2Bucket(host.files, `/r2/${r2.bucket_name}`, r2.binding);
+    }
     for (const d1 of config.d1_databases ?? [])
-        env[d1.binding] = celldExec(makeD1Binding({
+        env[d1.binding] = celldExec(binding(host, "d1", "d1_databases").makeD1Binding({
             fetcher: simulatorFetcher(env[D1_OBJECTS], d1.database_id),
         }));
     for (const name of [...sqliteClasses])
@@ -355,9 +378,15 @@ export function withResourceIds(config) {
  * `nodejs_compat_do_not_populate_process_env` is set. Frameworks read their settings there
  * (EmDash's `EMDASH_SITE_URL`, for one).
  */
+/** Whether `config` asks for nodejs_compat (the flag, or a `nodejs_compat_*` one). */
+export function hasNodeCompat(config) {
+    return (config.compatibility_flags ?? []).some((f) => f.startsWith("nodejs_compat"));
+}
+/** The configuration files of a project folder, in the order celld reads them. */
+export const WRANGLER_FILES = ["wrangler.jsonc", "wrangler.json"];
 export function populatesProcessEnv(config) {
     const flags = config.compatibility_flags ?? [];
-    if (!flags.some((f) => f.startsWith("nodejs_compat")))
+    if (!hasNodeCompat(config))
         return false;
     if (flags.includes("nodejs_compat_do_not_populate_process_env"))
         return false;