@statewalker/cellb 0.0.0-stage → 0.1.1

package/dist/project/workerd-message-channel.js

@@ -0,0 +1,137 @@
+/**
+ * workerd's `MessageChannel` on a Node host. In workerd an open port does not keep anything
+ * alive; on Node a port with a `message` handler is ref'd and holds the event loop open until it
+ * is closed. Libraries create such ports at module scope and never close them (React DOM's
+ * server renderer schedules its work over one), so a Worker bundle that imports them would keep
+ * the Node process alive after its runtime is closed.
+ *
+ * The ports of this channel are unref'd and hold the loop open only while a message posted to
+ * one of them waits for its handler, so a pending render still completes. Messages, transfers
+ * and `close()` are the real ports'. Where ports have no `unref` (browsers), it is the plain
+ * `MessageChannel`.
+ */
+/** Makes `port` unref'd except while messages posted to it wait for a handler. */
+function weakPort(port, peer) {
+    const realRef = port.ref.bind(port);
+    const realUnref = port.unref.bind(port);
+    let pending = 0; // messages posted to this port, not yet dispatched
+    let handlers = 0; // `onmessage` and `message` listeners
+    let held = false;
+    const sync = () => {
+        const hold = pending > 0 && handlers > 0;
+        if (hold === held)
+            return;
+        held = hold;
+        if (hold)
+            realRef();
+        else
+            realUnref();
+    };
+    // Node refs a port when a handler is attached: keep that to `sync`.
+    port.ref = () => port;
+    port.unref = () => port;
+    const dispatched = new WeakSet();
+    const delivered = (event) => {
+        if (dispatched.has(event))
+            return;
+        dispatched.add(event);
+        pending = Math.max(0, pending - 1);
+        sync();
+    };
+    const wrappers = new WeakMap();
+    const wrap = (listener) => {
+        let wrapped = wrappers.get(listener);
+        if (!wrapped) {
+            wrapped = function (event) {
+                delivered(event);
+                return typeof listener === "function"
+                    ? listener.call(this, event)
+                    : listener.handleEvent(event);
+            };
+            wrappers.set(listener, wrapped);
+        }
+        return wrapped;
+    };
+    const proto = Object.getPrototypeOf(port);
+    const onmessage = findAccessor(proto, "onmessage");
+    let current = null;
+    if (onmessage?.set && onmessage.get) {
+        Object.defineProperty(port, "onmessage", {
+            configurable: true,
+            enumerable: true,
+            get: () => current,
+            set: (fn) => {
+                if (typeof fn === "function" && !current)
+                    handlers++;
+                if (typeof fn !== "function" && current)
+                    handlers--;
+                current = typeof fn === "function" ? fn : null;
+                onmessage.set?.call(port, current && wrap(current));
+                realUnref();
+                held = false;
+                sync();
+            },
+        });
+    }
+    const add = port.addEventListener.bind(port);
+    const remove = port.removeEventListener.bind(port);
+    const registered = new Set();
+    port.addEventListener = ((type, listener, options) => {
+        if (type !== "message" || !listener)
+            return add(type, listener, options);
+        add(type, wrap(listener), options);
+        if (!registered.has(listener)) {
+            registered.add(listener);
+            handlers++;
+        }
+        realUnref();
+        held = false;
+        sync();
+    });
+    port.removeEventListener = ((type, listener, options) => {
+        if (type !== "message" || !listener)
+            return remove(type, listener, options);
+        remove(type, wrappers.get(listener) ?? listener, options);
+        if (registered.delete(listener))
+            handlers--;
+        sync();
+    });
+    // Posting from the peer: one more message waits on this port.
+    const post = peer.postMessage.bind(peer);
+    peer.postMessage = ((...args) => {
+        post(...args);
+        pending++;
+        sync();
+    });
+    const close = port.close.bind(port);
+    port.close = () => {
+        pending = 0;
+        handlers = 0;
+        sync();
+        close();
+    };
+    realUnref();
+}
+function findAccessor(proto, name) {
+    for (let p = proto; p; p = Object.getPrototypeOf(p)) {
+        const d = Object.getOwnPropertyDescriptor(p, name);
+        if (d)
+            return d;
+    }
+    return undefined;
+}
+const Base = globalThis.MessageChannel;
+export const WorkerdMessageChannel = typeof Base === "function"
+    ? class MessageChannel extends Base {
+        constructor() {
+            super();
+            const port1 = this.port1;
+            const port2 = this.port2;
+            if (typeof port1.unref !== "function" || typeof port1.ref !== "function")
+                return;
+            weakPort(port1, port2);
+            weakPort(port2, port1);
+        }
+    }
+    : Base;
+//# sourceMappingURL=workerd-message-channel.js.map

package/dist/project/workerd-message-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerd-message-channel.js","sourceRoot":"","sources":["../../src/project/workerd-message-channel.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * workerd's `MessageChannel` on a Node host. In workerd an open port does not keep anything\n * alive; on Node a port with a `message` handler is ref'd and holds the event loop open until it\n * is closed. Libraries create such ports at module scope and never close them (React DOM's\n * server renderer schedules its work over one), so a Worker bundle that imports them would keep\n * the Node process alive after its runtime is closed.\n *\n * The ports of this channel are unref'd and hold the loop open only while a message posted to\n * one of them waits for its handler, so a pending render still completes. Messages, transfers\n * and `close()` are the real ports'. Where ports have no `unref` (browsers), it is the plain\n * `MessageChannel`.\n */\n\ntype NodePort = MessagePort & { ref(): NodePort; unref(): NodePort };\ntype Listener = EventListenerOrEventListenerObject;\n\n/** Makes `port` unref'd except while messages posted to it wait for a handler. */\nfunction weakPort(port: NodePort, peer: NodePort): void {\n  const realRef = port.ref.bind(port);\n  const realUnref = port.unref.bind(port);\n  let pending = 0; // messages posted to this port, not yet dispatched\n  let handlers = 0; // `onmessage` and `message` listeners\n  let held = false;\n  const sync = () => {\n    const hold = pending > 0 && handlers > 0;\n    if (hold === held) return;\n    held = hold;\n    if (hold) realRef();\n    else realUnref();\n  };\n  // Node refs a port when a handler is attached: keep that to `sync`.\n  port.ref = () => port;\n  port.unref = () => port;\n\n  const dispatched = new WeakSet<Event>();\n  const delivered = (event: Event) => {\n    if (dispatched.has(event)) return;\n    dispatched.add(event);\n    pending = Math.max(0, pending - 1);\n    sync();\n  };\n  const wrappers = new WeakMap<Listener, Listener>();\n  const wrap = (listener: Listener): Listener => {\n    let wrapped = wrappers.get(listener);\n    if (!wrapped) {\n      wrapped = function (this: unknown, event: Event) {\n        delivered(event);\n        return typeof listener === \"function\"\n          ? listener.call(this, event)\n          : listener.handleEvent(event);\n      };\n      wrappers.set(listener, wrapped);\n    }\n    return wrapped;\n  };\n\n  const proto = Object.getPrototypeOf(port) as object;\n  const onmessage = findAccessor(proto, \"onmessage\");\n  let current: ((event: MessageEvent) => unknown) | null = null;\n  if (onmessage?.set && onmessage.get) {\n    Object.defineProperty(port, \"onmessage\", {\n      configurable: true,\n      enumerable: true,\n      get: () => current,\n      set: (fn: ((event: MessageEvent) => unknown) | null) => {\n        if (typeof fn === \"function\" && !current) handlers++;\n        if (typeof fn !== \"function\" && current) handlers--;\n        current = typeof fn === \"function\" ? fn : null;\n        onmessage.set?.call(port, current && wrap(current as EventListener));\n        realUnref();\n        held = false;\n        sync();\n      },\n    });\n  }\n  const add = port.addEventListener.bind(port);\n  const remove = port.removeEventListener.bind(port);\n  const registered = new Set<Listener>();\n  port.addEventListener = ((type: string, listener: Listener | null, options?: unknown) => {\n    if (type !== \"message\" || !listener) return add(type, listener as Listener, options as never);\n    add(type, wrap(listener), options as never);\n    if (!registered.has(listener)) {\n      registered.add(listener);\n      handlers++;\n    }\n    realUnref();\n    held = false;\n    sync();\n  }) as typeof port.addEventListener;\n  port.removeEventListener = ((type: string, listener: Listener | null, options?: unknown) => {\n    if (type !== \"message\" || !listener)\n      return remove(type, listener as Listener, options as never);\n    remove(type, wrappers.get(listener) ?? listener, options as never);\n    if (registered.delete(listener)) handlers--;\n    sync();\n  }) as typeof port.removeEventListener;\n\n  // Posting from the peer: one more message waits on this port.\n  const post = peer.postMessage.bind(peer) as (...args: unknown[]) => void;\n  peer.postMessage = ((...args: unknown[]) => {\n    post(...args);\n    pending++;\n    sync();\n  }) as typeof peer.postMessage;\n  const close = port.close.bind(port);\n  port.close = () => {\n    pending = 0;\n    handlers = 0;\n    sync();\n    close();\n  };\n  realUnref();\n}\n\nfunction findAccessor(proto: object | null, name: string): PropertyDescriptor | undefined {\n  for (let p = proto; p; p = Object.getPrototypeOf(p)) {\n    const d = Object.getOwnPropertyDescriptor(p, name);\n    if (d) return d;\n  }\n  return undefined;\n}\n\nconst Base = globalThis.MessageChannel;\n\nexport const WorkerdMessageChannel: typeof MessageChannel | undefined =\n  typeof Base === \"function\"\n    ? class MessageChannel extends Base {\n        constructor() {\n          super();\n          const port1 = this.port1 as NodePort;\n          const port2 = this.port2 as NodePort;\n          if (typeof port1.unref !== \"function\" || typeof port1.ref !== \"function\") return;\n          weakPort(port1, port2);\n          weakPort(port2, port1);\n        }\n      }\n    : Base;\n"]}

package/dist/project/workers-global-names.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The Workers globals substituted into browser bundles (`scheduler` aside, which is an
+ * expression): each is read from the realm that runs the code. workers-globals.ts spells the
+ * same list as static re-exports, because esbuild `inject` needs a literal module.
+ */
+export declare const WORKERS_GLOBAL_NAMES: readonly ["Request", "Response", "WebSocketPair", "caches", "HTMLRewriter", "WebSocketRequestResponsePair", "WebSocket"];

package/dist/project/workers-global-names.js

@@ -0,0 +1,15 @@
+/**
+ * The Workers globals substituted into browser bundles (`scheduler` aside, which is an
+ * expression): each is read from the realm that runs the code. workers-globals.ts spells the
+ * same list as static re-exports, because esbuild `inject` needs a literal module.
+ */
+export const WORKERS_GLOBAL_NAMES = [
+    "Request",
+    "Response",
+    "WebSocketPair",
+    "caches",
+    "HTMLRewriter",
+    "WebSocketRequestResponsePair",
+    "WebSocket",
+];
+//# sourceMappingURL=workers-global-names.js.map

package/dist/project/workers-global-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers-global-names.js","sourceRoot":"","sources":["../../src/project/workers-global-names.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,SAAS;IACT,UAAU;IACV,eAAe;IACf,QAAQ;IACR,cAAc;IACd,8BAA8B;IAC9B,WAAW;CACH,CAAC","sourcesContent":["/**\n * The Workers globals substituted into browser bundles (`scheduler` aside, which is an\n * expression): each is read from the realm that runs the code. workers-globals.ts spells the\n * same list as static re-exports, because esbuild `inject` needs a literal module.\n */\nexport const WORKERS_GLOBAL_NAMES = [\n  \"Request\",\n  \"Response\",\n  \"WebSocketPair\",\n  \"caches\",\n  \"HTMLRewriter\",\n  \"WebSocketRequestResponsePair\",\n  \"WebSocket\",\n] as const;\n"]}

package/dist/project/workers-globals-module.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The "cellb:ws" module that workers-globals.ts imports: the runtime's own
+ * Workers globals, loaded as an external module so user bundles share these instances.
+ */
+export { cellsCaches as caches } from "../bindings/cache.js";
+export { HTMLRewriter } from "../bindings/html-rewriter.js";
+export { CellsResponse, StandardWebSocketPair, WebSocketPair, WebSocketRequestResponsePair, WorkersWebSocket as WebSocket, } from "../ws/server.js";
+export { CellsRequest } from "../ws/upgrade.js";

package/dist/project/workers-globals-module.js

@@ -0,0 +1,9 @@
+/**
+ * The "cellb:ws" module that workers-globals.ts imports: the runtime's own
+ * Workers globals, loaded as an external module so user bundles share these instances.
+ */
+export { cellsCaches as caches } from "../bindings/cache.js";
+export { HTMLRewriter } from "../bindings/html-rewriter.js";
+export { CellsResponse, StandardWebSocketPair, WebSocketPair, WebSocketRequestResponsePair, WorkersWebSocket as WebSocket, } from "../ws/server.js";
+export { CellsRequest } from "../ws/upgrade.js";
+//# sourceMappingURL=workers-globals-module.js.map

package/dist/project/workers-globals-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers-globals-module.js","sourceRoot":"","sources":["../../src/project/workers-globals-module.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,IAAI,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,4BAA4B,EAC5B,gBAAgB,IAAI,SAAS,GAC9B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC","sourcesContent":["/**\n * The \"cellb:ws\" module that workers-globals.ts imports: the runtime's own\n * Workers globals, loaded as an external module so user bundles share these instances.\n */\nexport { cellsCaches as caches } from \"../bindings/cache.js\";\nexport { HTMLRewriter } from \"../bindings/html-rewriter.js\";\nexport {\n  CellsResponse,\n  StandardWebSocketPair,\n  WebSocketPair,\n  WebSocketRequestResponsePair,\n  WorkersWebSocket as WebSocket,\n} from \"../ws/server.js\";\nexport { CellsRequest } from \"../ws/upgrade.js\";\n"]}

package/dist/project/workers-globals.d.ts

@@ -0,0 +1,9 @@
+export { CellsRequest as Request, CellsResponse as Response, caches, HTMLRewriter, WebSocket, WebSocketRequestResponsePair, } from "cellb:ws";
+/** The project's `websocket_standard_binary_type` flag ("cellb:compat", one per bundle). */
+export declare const WebSocketPair: any;
+/** workerd's `MessageChannel`: an idle port does not keep the Node host alive. */
+export { WorkerdMessageChannel as MessageChannel } from "./workerd-message-channel.js";
+/** workerd's `scheduler`:`await scheduler.wait(ms)` is a promise-based setTimeout. */
+export declare const scheduler: {
+    wait: (ms: number) => Promise<void>;
+};

package/dist/project/workers-globals.js

@@ -0,0 +1,19 @@
+/**
+ * Globals of the Workers runtime that browsers/Node lack or implement differently,
+ * substituted into user bundles (esbuild `inject` on the server, webrun-modules `~deps`
+ * in the browser) — the real globals are untouched. "cellb:ws" is resolved as an
+ * EXTERNAL module (workers-globals-module.ts): if it were bundled, the injected `Response` would
+ * also replace the `Response` that CellsResponse itself extends.
+ */
+import { standardBinaryType } from "cellb:compat";
+import { WebSocketPair as LegacyWebSocketPair, StandardWebSocketPair } from "cellb:ws";
+export { CellsRequest as Request, CellsResponse as Response, caches, HTMLRewriter, WebSocket, WebSocketRequestResponsePair, } from "cellb:ws";
+/** The project's `websocket_standard_binary_type` flag ("cellb:compat", one per bundle). */
+export const WebSocketPair = standardBinaryType ? StandardWebSocketPair : LegacyWebSocketPair;
+/** workerd's `MessageChannel`: an idle port does not keep the Node host alive. */
+export { WorkerdMessageChannel as MessageChannel } from "./workerd-message-channel.js";
+/** workerd's `scheduler`:`await scheduler.wait(ms)` is a promise-based setTimeout. */
+export const scheduler = {
+    wait: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+};
+//# sourceMappingURL=workers-globals.js.map

package/dist/project/workers-globals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers-globals.js","sourceRoot":"","sources":["../../src/project/workers-globals.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEvF,OAAO,EACL,YAAY,IAAI,OAAO,EACvB,aAAa,IAAI,QAAQ,EACzB,MAAM,EACN,YAAY,EACZ,SAAS,EACT,4BAA4B,GAC7B,MAAM,UAAU,CAAC;AAElB,4FAA4F;AAC5F,MAAM,CAAC,MAAM,aAAa,GAAG,kBAAkB,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,mBAAmB,CAAC;AAE9F,kFAAkF;AAClF,OAAO,EAAE,qBAAqB,IAAI,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEvF,sFAAsF;AACtF,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,IAAI,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;CAC9E,CAAC","sourcesContent":["/**\n * Globals of the Workers runtime that browsers/Node lack or implement differently,\n * substituted into user bundles (esbuild `inject` on the server, webrun-modules `~deps`\n * in the browser) — the real globals are untouched. \"cellb:ws\" is resolved as an\n * EXTERNAL module (workers-globals-module.ts): if it were bundled, the injected `Response` would\n * also replace the `Response` that CellsResponse itself extends.\n */\nimport { standardBinaryType } from \"cellb:compat\";\nimport { WebSocketPair as LegacyWebSocketPair, StandardWebSocketPair } from \"cellb:ws\";\n\nexport {\n  CellsRequest as Request,\n  CellsResponse as Response,\n  caches,\n  HTMLRewriter,\n  WebSocket,\n  WebSocketRequestResponsePair,\n} from \"cellb:ws\";\n\n/** The project's `websocket_standard_binary_type` flag (\"cellb:compat\", one per bundle). */\nexport const WebSocketPair = standardBinaryType ? StandardWebSocketPair : LegacyWebSocketPair;\n\n/** workerd's `MessageChannel`: an idle port does not keep the Node host alive. */\nexport { WorkerdMessageChannel as MessageChannel } from \"./workerd-message-channel.js\";\n\n/** workerd's `scheduler`:`await scheduler.wait(ms)` is a promise-based setTimeout. */\nexport const scheduler = {\n  wait: (ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms)),\n};\n"]}

package/dist/project/wrangler.d.ts

@@ -0,0 +1,116 @@
+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 WorkersAiOptions } from "../bindings/workers-ai.js";
+import { type CellRuntime, type CellRuntimeOptions, type WorkerModule } from "../core/runtime.js";
+/** The subset of wrangler.json(c) that celld deploys (and cellb reads). */
+export interface WranglerConfig {
+    name?: string;
+    main?: string;
+    compatibility_date?: string;
+    compatibility_flags?: string[];
+    vars?: Record<string, unknown>;
+    durable_objects?: {
+        bindings?: {
+            name: string;
+            class_name: string;
+            script_name?: string;
+        }[];
+    };
+    migrations?: {
+        tag: string;
+        new_sqlite_classes?: string[];
+        new_classes?: string[];
+        renamed_classes?: {
+            from: string;
+            to: string;
+        }[];
+        deleted_classes?: string[];
+    }[];
+    kv_namespaces?: {
+        binding: string;
+        id?: string;
+    }[];
+    d1_databases?: {
+        binding: string;
+        database_name?: string;
+        database_id?: string;
+    }[];
+    r2_buckets?: {
+        binding: string;
+        bucket_name: string;
+    }[];
+    queues?: {
+        producers?: {
+            binding: string;
+            queue: string;
+            delivery_delay?: number;
+        }[];
+        consumers?: QueueConsumerConfig[];
+    };
+    workflows?: WorkflowConfig[];
+    triggers?: {
+        crons?: string[];
+    };
+    assets?: AssetsConfig;
+    services?: {
+        binding: string;
+        service: string;
+        entrypoint?: string;
+        props?: unknown;
+    }[];
+    worker_loaders?: {
+        binding: string;
+    }[];
+    /** Workers AI: served by the host's OpenAI-compatible endpoint (`ProjectHost.ai`), if any. */
+    ai?: {
+        binding: string;
+    };
+    /** Containers (celld runs them with Docker or Podman): not supported, reported. */
+    containers?: {
+        class_name: string;
+        image?: string;
+    }[];
+}
+/** wrangler `workflows` entries. */
+export interface WorkflowConfig {
+    binding: string;
+    name: string;
+    class_name: string;
+}
+export interface ProjectHost extends Pick<CellRuntimeOptions, "openSql" | "storage" | "clock" | "peers" | "route"> {
+    /** Files of `assets.directory` (path "/a/b.html" → bytes), loaded by the host. */
+    assetFiles?: AssetFiles;
+    /** Runs each loaded Worker in its own realm (celld isolates); classes still use `loadModules`. */
+    isolatedModules?: ModuleLoader;
+    /** Compiles code given to a Worker Loader binding (esbuild on Node, webrun-modules in browsers). */
+    loadModules?: ModuleLoader;
+    /** Blob store of the KV simulator (large values): OPFS in a browser, a directory or S3 on a server. */
+    files: FilesApi;
+    /** The OpenAI-compatible endpoint behind the `ai` binding; without it the binding is unsupported. */
+    ai?: WorkersAiOptions;
+}
+export interface ProjectRuntime {
+    runtime: CellRuntime;
+    /** Configuration entries cellb does not support yet (reported, not silently ignored). */
+    unsupported: string[];
+}
+/**
+ * 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
+ * `env.AI` at load).
+ */
+export declare function loadTimeEnv(config: WranglerConfig, ai?: WorkersAiOptions): Record<string, unknown>;
+/**
+ * Builds a runtime from a wrangler config and the Worker's module namespace — the same
+ * inputs celld deploys. Hosts differ only in `host` (storage) and in how they load `main`.
+ */
+export declare function createProjectRuntime(config: WranglerConfig, module: WorkerModule, host: ProjectHost): ProjectRuntime;
+/**
+ * KV namespaces and D1 databases may omit their ids: wrangler provisions them on deploy, and
+ * framework builds (Astro's Cloudflare adapter, for one) emit such entries. A KV namespace
+ * then takes its binding name as id; a D1 database its `database_name`, else its binding name.
+ * Entries with ids are kept as they are, so storage shared with celld keeps its names.
+ */
+export declare function withResourceIds(config: WranglerConfig): WranglerConfig;