@statewalker/cellb 0.0.0-stage → 0.1.0

package/dist/core/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/core/state.ts"],"names":[],"mappings":"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","sourcesContent":["import type { InputGate } from \"./gates.js\";\nimport type { DurableObjectId } from \"./id.js\";\nimport type { DurableObjectStorage } from \"./storage.js\";\n\n/** `ctx` passed to a Durable Object constructor. */\nexport class DurableObjectState {\n  /** Not readonly: an object woken by id alone gets its recorded name back (celld). */\n  id: DurableObjectId;\n  readonly storage: DurableObjectStorage;\n  readonly #gate: InputGate;\n  readonly #waitUntil: (p: Promise<unknown>) => void;\n\n  readonly #onBlockFailure: (e: unknown) => void;\n  constructor(\n    id: DurableObjectId,\n    storage: DurableObjectStorage,\n    gate: InputGate,\n    waitUntil: (p: Promise<unknown>) => void,\n    onBlockFailure: (e: unknown) => void = () => {},\n  ) {\n    this.#onBlockFailure = onBlockFailure;\n    this.id = id;\n    this.storage = storage;\n    this.#gate = gate;\n    this.#waitUntil = waitUntil;\n  }\n  /** Open blockConcurrencyWhile() sections (nested ones are open together). */\n  #blockDepth = 0;\n  /** No event is delivered to the object until `fn` settles. */\n  blockConcurrencyWhile<T>(fn: () => Promise<T>): Promise<T> {\n    // As workerd (io-context.h) and celld: at most 64 nested sections; the next throws at once.\n    if (this.#blockDepth >= 64)\n      throw new Error(\"blockConcurrencyWhile() calls are nested too deeply.\");\n    this.#blockDepth++;\n    const p = this.#gate.runClosed(fn).finally(() => this.#blockDepth--);\n    // A failure resets the object even when the caller (typically the\n    // constructor) does not await the promise; the rejection is then observed.\n    p.catch((e) => this.#onBlockFailure(e));\n    return p;\n  }\n  waitUntil(p: Promise<unknown>): void {\n    this.#waitUntil(p);\n  }\n\n  /** `ctx.exports`: loopback handles of the Worker's exports (set by the host). */\n  exports: Record<string, unknown> = {};\n  /** `ctx.props`: what a facet's class handle was given as `{ props }` (set by the host). */\n  props: unknown;\n  /** `ctx.facets`: child objects with their own SQLite (set by the host). */\n  facets!: {\n    get(name: string, start: () => unknown): Record<string, any>;\n    abort(name: string, reason?: unknown): void;\n    delete(name: string): Promise<void>;\n  };\n\n  // ---- WebSocket hibernation API ------------------------------------------------\n  // Sockets accepted here belong to the RUNTIME, not to the object instance: their\n  // events are delivered as object events (through the input gate) to\n  // webSocketMessage / webSocketClose / webSocketError on whatever instance is live.\n\n  #dispatch?: (fn: (instance: any) => unknown) => Promise<unknown>;\n  readonly #sockets = new Map<WebSocketLike, string[]>();\n  #autoResponse?: { request: string; response: string };\n\n  /** Set by the ObjectHost: delivers an event to the live instance. */\n  attachDispatcher(dispatch: (fn: (instance: any) => unknown) => Promise<unknown>): void {\n    this.#dispatch = dispatch;\n  }\n\n  acceptWebSocket(ws: WebSocketLike, tags: string[] = []): void {\n    if (this.#sockets.has(ws)) throw new Error(\"WebSocket already accepted\");\n    if (tags.length > 10) throw new Error(\"A WebSocket can have at most 10 tags\");\n    this.#sockets.set(ws, [...tags]);\n    (ws as { hibernatable?: boolean }).hibernatable = true;\n    // webSocketMessage() gets string | ArrayBuffer, whatever the pair's default binaryType.\n    (ws as { binaryType?: string }).binaryType = \"arraybuffer\";\n    ws.accept();\n    const deliver = (fn: (o: any) => unknown) => this.#dispatch?.(fn).catch(() => {});\n    ws.addEventListener(\"message\", (e: MessageEvent) => {\n      const auto = this.#autoResponse;\n      if (auto && e.data === auto.request) {\n        ws.send(auto.response);\n        return;\n      }\n      void deliver((o) => o.webSocketMessage?.(ws, e.data));\n    });\n    ws.addEventListener(\"close\", (e: CloseEvent) => {\n      this.#sockets.delete(ws);\n      void deliver((o) => o.webSocketClose?.(ws, e.code, e.reason, e.wasClean));\n    });\n    ws.addEventListener(\n      \"error\",\n      (e: Event) => void deliver((o) => o.webSocketError?.(ws, (e as ErrorEvent).error ?? e)),\n    );\n  }\n\n  getWebSockets(tag?: string): WebSocketLike[] {\n    return [...this.#sockets]\n      .filter(([, tags]) => tag === undefined || tags.includes(tag))\n      .map(([ws]) => ws);\n  }\n\n  getTags(ws: WebSocketLike): string[] {\n    const tags = this.#sockets.get(ws);\n    if (!tags) throw new Error(\"WebSocket was not accepted with acceptWebSocket()\");\n    return [...tags];\n  }\n\n  setWebSocketAutoResponse(pair?: { request: string; response: string }): void {\n    this.#autoResponse = pair;\n  }\n  getWebSocketAutoResponse(): { request: string; response: string } | null {\n    return this.#autoResponse ?? null;\n  }\n}\n\n/** The server end of a WebSocketPair, as seen by the hibernation API. */\nexport interface WebSocketLike {\n  accept(): void;\n  send(data: string | ArrayBuffer | ArrayBufferView): void;\n  close(code?: number, reason?: string): void;\n  addEventListener(type: string, fn: (e: any) => void): void;\n}\n"]}

package/dist/core/storage.d.ts

@@ -0,0 +1,103 @@
+import type { ValueCodec } from "../ports.js";
+import type { InputGate } from "./gates.js";
+import type { SqlStorage } from "./sql-storage.js";
+export interface ListOptions {
+    start?: string;
+    startAfter?: string;
+    end?: string;
+    prefix?: string;
+    reverse?: boolean;
+    limit?: number;
+}
+/**
+ * Synchronous KV API of SQLite-backed objects (`ctx.storage.kv`), stored as celld stores it:
+ * `_cf_KV(scope, k, v)` with the cell's scope and V8-serialized values (celld-schema.ts).
+ */
+export declare class SyncKvStorage {
+    #private;
+    readonly scope: string;
+    /** The name the object was addressed by: recorded as celld's _cf_METADATA.actor_name. */
+    actorName: string | undefined;
+    constructor(sql: SqlStorage, codec: ValueCodec, scope?: string);
+    get<T = unknown>(key: string): T | undefined;
+    put(key: string, value: unknown): void;
+    delete(key: string): boolean;
+    /**
+     * Only one list() iterator is live at a time, as in workerd: a new call invalidates the
+     * previous one, which throws on its next step.
+     */
+    list<T = unknown>(opts?: ListOptions): IterableIterator<[string, T]>;
+    deleteAll(): void;
+}
+/** Methods shared by `ctx.storage` and the `txn` object of `transaction()`. */
+export declare class AsyncKvApi {
+    protected kv: SyncKvStorage;
+    protected gate: InputGate;
+    constructor(kv: SyncKvStorage, gate: InputGate);
+    /** Every async storage op closes the input gate until it (and its continuation) completes. */
+    protected op<T>(fn: () => T): Promise<T>;
+    get<T = unknown>(key: string): Promise<T | undefined>;
+    get<T = unknown>(keys: string[]): Promise<Map<string, T>>;
+    put(key: string, value: unknown): Promise<void>;
+    put(entries: Record<string, unknown>): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    delete(keys: string[]): Promise<number>;
+    list<T = unknown>(opts?: ListOptions): Promise<Map<string, T>>;
+}
+export declare class DurableObjectTransaction extends AsyncKvApi {
+    rolledBack: boolean;
+    rollback(): void;
+}
+/** `ctx.storage` of a SQLite-backed Durable Object. */
+export declare class DurableObjectStorage extends AsyncKvApi {
+    #private;
+    readonly sql: SqlStorage;
+    readonly kv: SyncKvStorage;
+    constructor(sql: SqlStorage, kv: SyncKvStorage, gate: InputGate, sync: () => Promise<void>);
+    deleteAll(): Promise<void>;
+    transactionSync<T>(fn: () => T): T;
+    /**
+     * Async transaction spanning awaits: the input gate stays closed (no other
+     * event can interleave writes into the savepoint) and auto-commit is held.
+     */
+    transaction<T>(closure: (txn: DurableObjectTransaction) => Promise<T>): Promise<T>;
+    /** Resolves once all writes so far are durable (the output gate barrier). */
+    sync(): Promise<void>;
+    /** `delete_all_preserves_alarm`: deleteAll() leaves the alarm in place. */
+    deleteAllPreservesAlarm: boolean;
+    /** celld's harness hands its storage "scope" to engine ops; here it is the storage itself. */
+    get _scope(): this;
+    /** Called whenever the stored alarm changes (the runtime schedules it). */
+    onAlarmChange: (at: number | null) => void;
+    /**
+     * The alarm row as celld keeps it (storage.rs): due time, failure counters, and a random
+     * generation that changes with every setAlarm() — so a handler's own change is detected.
+     */
+    alarmRowSync(): {
+        at: number;
+        retry: number;
+        counted: number;
+        generation: string;
+    } | null;
+    beginAlarm(row: {
+        generation: string;
+    }): void;
+    /**
+     * After the handler (celld's finish_alarm_handler): unless the handler changed the alarm,
+     * success deletes it and failure reschedules it with backoff (2 s << min(retry, 6)) —
+     * abandoned after 6 counted failures. Returns the alarm now stored.
+     */
+    finishAlarm(fired: {
+        at: number;
+        generation: string;
+    }, succeeded: boolean, now: number): number | null;
+    /** Synchronous read of the stored alarm (ms since epoch) or null (null while it is handled). */
+    alarmSync(): number | null;
+    /** One alarm per object, in celld's `_cf_ALARM` (same transaction as the event's writes). */
+    getAlarm(_opts?: unknown): Promise<number | null>;
+    setAlarm(scheduledTime: number | Date, _opts?: unknown): Promise<void>;
+    /** setAlarm() inside a synchronous transaction (celld's harness ops). */
+    setAlarmSync(at: number): void;
+    deleteAlarm(_opts?: unknown): Promise<void>;
+    clearAlarmSync(): void;
+}

package/dist/core/storage.js

@@ -0,0 +1,351 @@
+import { serialize } from "../v8/serialize.js";
+import { CELLD_SCHEMA } from "./celld-schema.js";
+/** `EXPORT` of core/handles.ts, by its registered name: importing handles.ts here is a cycle. */
+const EXPORT = Symbol.for("cellb.export");
+const withoutStoredStubs = (v) => v && typeof v === "object" && v[EXPORT]
+    ? null
+    : Array.isArray(v)
+        ? v.map(withoutStoredStubs)
+        : v && Object.getPrototypeOf(v) === Object.prototype
+            ? Object.fromEntries(Object.entries(v).map(([k, x]) => [k, withoutStoredStubs(x)]))
+            : v;
+/**
+ * Synchronous KV API of SQLite-backed objects (`ctx.storage.kv`), stored as celld stores it:
+ * `_cf_KV(scope, k, v)` with the cell's scope and V8-serialized values (celld-schema.ts).
+ */
+export class SyncKvStorage {
+    #sql;
+    #codec;
+    #ready = false;
+    scope;
+    /** The name the object was addressed by: recorded as celld's _cf_METADATA.actor_name. */
+    actorName;
+    constructor(sql, codec, scope = "") {
+        this.#sql = sql;
+        this.#codec = codec;
+        this.scope = scope;
+        sql.rolledBack.add(() => {
+            this.#ready = false; // the table may have been created inside the rolled-back transaction
+        });
+    }
+    #init() {
+        if (this.#ready)
+            return;
+        for (const ddl of CELLD_SCHEMA)
+            this.#sql.internalExec(ddl);
+        if (this.actorName !== undefined)
+            this.#sql.internalExec("INSERT OR IGNORE INTO _cf_METADATA (scope, actor_name) VALUES (?, ?)", [this.scope, this.actorName]);
+        this.#ready = true;
+    }
+    get(key) {
+        this.#init();
+        const r = this.#sql.internalExec("SELECT v FROM _cf_KV WHERE scope = ? AND k = ?", [
+            this.scope,
+            key,
+        ]);
+        if (!r.rows.length)
+            return undefined;
+        return this.#codec.decode(new Uint8Array(r.rows[0][0]));
+    }
+    put(key, value) {
+        this.#init();
+        // As celld: `undefined` is a storable value; what structured clone refuses is a TypeError.
+        // ctx.exports.X({ props }) stubs are left to the codec, which stores them (workerd).
+        try {
+            structuredClone(withoutStoredStubs(value));
+        }
+        catch (e) {
+            // Worded as V8 (workerd, celld) words it, by cellb's V8 serializer: SpiderMonkey says
+            // "Function object could not be cloned." for V8's "() => 1 could not be cloned.".
+            try {
+                serialize(withoutStoredStubs(value));
+            }
+            catch (v8) {
+                throw new TypeError(v8.message);
+            }
+            // Browsers prefix the engine message ("Failed to execute 'structuredClone' on …: ").
+            throw new TypeError(e.message.replace(/^Failed to execute '[^']+' on '[^']+': /, ""));
+        }
+        this.#sql.internalExec("INSERT OR REPLACE INTO _cf_KV (scope, k, v) VALUES (?, ?, ?)", [
+            this.scope,
+            key,
+            this.#codec.encode(value),
+        ]);
+    }
+    delete(key) {
+        this.#init();
+        return (this.#sql.internalExec("DELETE FROM _cf_KV WHERE scope = ? AND k = ?", [this.scope, key])
+            .rowsWritten > 0);
+    }
+    /**
+     * Only one list() iterator is live at a time, as in workerd: a new call invalidates the
+     * previous one, which throws on its next step.
+     */
+    list(opts = {}) {
+        const generation = ++this.#listGeneration;
+        const live = () => {
+            if (generation !== this.#listGeneration)
+                throw new Error("kv.list() iterator was invalidated because a new call to kv.list() was started. " +
+                    "Only one kv.list() iterator can exist at a time.");
+        };
+        const rows = this.#rows(opts);
+        return (function* () {
+            live();
+            for (const row of rows) {
+                yield row;
+                live();
+            }
+        })();
+    }
+    #listGeneration = 0;
+    *#rows(opts) {
+        this.#init();
+        const where = ["scope = ?"];
+        const params = [this.scope];
+        if (opts.start !== undefined)
+            where.push("k >= ?"), params.push(opts.start);
+        if (opts.startAfter !== undefined)
+            where.push("k > ?"), params.push(opts.startAfter);
+        if (opts.end !== undefined)
+            where.push("k < ?"), params.push(opts.end);
+        if (opts.prefix !== undefined)
+            where.push("substr(k, 1, ?) = ?"), params.push(opts.prefix.length, opts.prefix);
+        let q = "SELECT k, v FROM _cf_KV";
+        q += ` WHERE ${where.join(" AND ")}`;
+        q += ` ORDER BY k ${opts.reverse ? "DESC" : "ASC"}`;
+        if (opts.limit !== undefined)
+            (q += " LIMIT ?"), params.push(opts.limit);
+        for (const [k, v] of this.#sql.internalExec(q, params).rows)
+            yield [k, this.#codec.decode(new Uint8Array(v))];
+    }
+    deleteAll() {
+        this.#init();
+        this.#sql.internalExec("DELETE FROM _cf_KV WHERE scope = ?", [this.scope]);
+    }
+}
+/** Methods shared by `ctx.storage` and the `txn` object of `transaction()`. */
+export class AsyncKvApi {
+    kv;
+    gate;
+    constructor(kv, gate) {
+        this.kv = kv;
+        this.gate = gate;
+    }
+    /** Every async storage op closes the input gate until it (and its continuation) completes. */
+    op(fn) {
+        return this.gate.runClosed(async () => {
+            await Promise.resolve();
+            return fn();
+        });
+    }
+    get(keyOrKeys) {
+        return this.op(() => {
+            if (!Array.isArray(keyOrKeys))
+                return this.kv.get(keyOrKeys);
+            checkKeys(keyOrKeys);
+            const m = new Map();
+            for (const k of [...keyOrKeys].sort()) {
+                const v = this.kv.get(k);
+                if (v !== undefined)
+                    m.set(k, v);
+            }
+            return m;
+        });
+    }
+    put(keyOrEntries, value) {
+        return this.op(() => {
+            if (typeof keyOrEntries === "string")
+                return this.kv.put(keyOrEntries, value);
+            const entries = Object.entries(keyOrEntries);
+            checkKeys(entries.map(([k]) => k));
+            for (const [k, v] of entries)
+                this.kv.put(k, v);
+        });
+    }
+    delete(keyOrKeys) {
+        return this.op(() => {
+            if (!Array.isArray(keyOrKeys))
+                return this.kv.delete(keyOrKeys);
+            checkKeys(keyOrKeys);
+            return keyOrKeys.filter((k) => this.kv.delete(k)).length;
+        });
+    }
+    list(opts) {
+        return this.op(() => new Map(this.kv.list(opts)));
+    }
+}
+// celld sets no limit on the number of keys of one get/put/delete (storage-details).
+function checkKeys(_keys) { }
+export class DurableObjectTransaction extends AsyncKvApi {
+    rolledBack = false;
+    rollback() {
+        this.rolledBack = true;
+    }
+}
+/** `ctx.storage` of a SQLite-backed Durable Object. */
+export class DurableObjectStorage extends AsyncKvApi {
+    sql;
+    kv;
+    #sync;
+    constructor(sql, kv, gate, sync) {
+        super(kv, gate);
+        this.sql = sql;
+        sql.rolledBack.add(() => {
+            this.#metaReady = false;
+        });
+        this.kv = kv;
+        this.#sync = sync;
+    }
+    deleteAll() {
+        return this.op(() => {
+            this.kv.deleteAll();
+            // deleteAll() also deletes the alarm, as on Cloudflare, unless `delete_all_preserves_alarm`.
+            if (!this.deleteAllPreservesAlarm)
+                this.clearAlarmSync();
+            const tables = this.sql.internalExec("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE '\\_cf\\_%' ESCAPE '\\' AND name NOT LIKE 'sqlite\\_%' ESCAPE '\\'").rows;
+            for (const [name] of tables)
+                this.sql.internalExec(`DROP TABLE IF EXISTS "${String(name).replace(/"/g, '""')}"`);
+        });
+    }
+    transactionSync(fn) {
+        return this.sql.transactionSync(fn);
+    }
+    /**
+     * Async transaction spanning awaits: the input gate stays closed (no other
+     * event can interleave writes into the savepoint) and auto-commit is held.
+     */
+    transaction(closure) {
+        return this.gate.runClosed(async () => {
+            const release = this.sql.hold();
+            const sp = "_cf_atx";
+            this.sql.internalExec(`SAVEPOINT ${sp}`);
+            const txn = new DurableObjectTransaction(this.kv, this.gate);
+            try {
+                const r = await closure(txn);
+                if (txn.rolledBack)
+                    this.#rollbackTo(sp);
+                else
+                    this.sql.internalExec(`RELEASE ${sp}`);
+                return r;
+            }
+            catch (e) {
+                this.#rollbackTo(sp);
+                throw e;
+            }
+            finally {
+                release();
+            }
+        });
+    }
+    #rollbackTo(sp) {
+        this.sql.internalExec(`ROLLBACK TO ${sp}`);
+        this.sql.internalExec(`RELEASE ${sp}`);
+        for (const f of this.sql.rolledBack)
+            f(); // tables created inside may be gone
+    }
+    /** Resolves once all writes so far are durable (the output gate barrier). */
+    sync() {
+        return this.#sync();
+    }
+    /** `delete_all_preserves_alarm`: deleteAll() leaves the alarm in place. */
+    deleteAllPreservesAlarm = false;
+    /** celld's harness hands its storage "scope" to engine ops; here it is the storage itself. */
+    get _scope() {
+        return this;
+    }
+    /** Called whenever the stored alarm changes (the runtime schedules it). */
+    onAlarmChange = () => { };
+    #metaReady = false;
+    #meta() {
+        if (this.#metaReady)
+            return;
+        for (const ddl of CELLD_SCHEMA)
+            this.sql.internalExec(ddl);
+        if (this.kv.actorName !== undefined)
+            this.sql.internalExec("INSERT OR IGNORE INTO _cf_METADATA (scope, actor_name) VALUES (?, ?)", [this.kv.scope, this.kv.actorName]);
+        this.#metaReady = true;
+    }
+    /**
+     * The alarm row as celld keeps it (storage.rs): due time, failure counters, and a random
+     * generation that changes with every setAlarm() — so a handler's own change is detected.
+     */
+    alarmRowSync() {
+        this.#meta();
+        const r = this.sql.internalExec(
+        // generation is a 64-bit random(): read as text (beyond JS's safe integers)
+        "SELECT at_ms, retry, counted_retry, CAST(generation AS TEXT) FROM _cf_ALARM WHERE scope = ?", [this.kv.scope]).rows[0];
+        return r
+            ? { at: Number(r[0]), retry: Number(r[1]), counted: Number(r[2]), generation: String(r[3]) }
+            : null;
+    }
+    /** The alarm being handled: getAlarm() reads null until the handler changes the alarm. */
+    #active;
+    beginAlarm(row) {
+        this.#active = { generation: row.generation };
+    }
+    /**
+     * After the handler (celld's finish_alarm_handler): unless the handler changed the alarm,
+     * success deletes it and failure reschedules it with backoff (2 s << min(retry, 6)) —
+     * abandoned after 6 counted failures. Returns the alarm now stored.
+     */
+    finishAlarm(fired, succeeded, now) {
+        this.#active = undefined;
+        const cur = this.alarmRowSync();
+        if (!cur || cur.generation !== fired.generation)
+            return cur?.at ?? null;
+        if (succeeded) {
+            this.sql.internalExec("DELETE FROM _cf_ALARM WHERE scope = ? AND at_ms = ?", [
+                this.kv.scope,
+                fired.at,
+            ]);
+        }
+        else if (cur.counted >= 6) {
+            this.sql.internalExec("DELETE FROM _cf_ALARM WHERE scope = ?", [this.kv.scope]);
+        }
+        else {
+            const at = now + 2_000 * 2 ** Math.min(Math.max(cur.retry, 0), 6);
+            this.sql.internalExec("UPDATE _cf_ALARM SET at_ms = ?, retry = retry + 1, counted_retry = counted_retry + 1 WHERE scope = ?", [at, this.kv.scope]);
+        }
+        const after = this.alarmRowSync()?.at ?? null;
+        this.onAlarmChange(after);
+        return after;
+    }
+    /** Synchronous read of the stored alarm (ms since epoch) or null (null while it is handled). */
+    alarmSync() {
+        const row = this.alarmRowSync();
+        if (row && this.#active && this.#active.generation === row.generation)
+            return null;
+        return row ? row.at : null;
+    }
+    /** One alarm per object, in celld's `_cf_ALARM` (same transaction as the event's writes). */
+    getAlarm(_opts) {
+        return this.op(() => this.alarmSync());
+    }
+    setAlarm(scheduledTime, _opts) {
+        // As celld: the time is coerced to a number and a non-number becomes 0 (due at once).
+        const n = scheduledTime instanceof Date ? scheduledTime.getTime() : Number(scheduledTime);
+        const at = Number.isNaN(n) ? 0 : n;
+        return this.op(() => {
+            this.#meta();
+            this.sql.internalExec(
+            // celld's statement: counters reset, a new random generation
+            "INSERT INTO _cf_ALARM(scope,at_ms,retry,counted_retry,generation) VALUES(?,?,0,0,random()) ON CONFLICT(scope) DO UPDATE SET at_ms=excluded.at_ms, retry=0, counted_retry=0, generation=random()", [this.kv.scope, at]);
+            this.onAlarmChange(at);
+        });
+    }
+    /** setAlarm() inside a synchronous transaction (celld's harness ops). */
+    setAlarmSync(at) {
+        this.#meta();
+        this.sql.internalExec("INSERT INTO _cf_ALARM(scope,at_ms,retry,counted_retry,generation) VALUES(?,?,0,0,random()) ON CONFLICT(scope) DO UPDATE SET at_ms=excluded.at_ms, retry=0, counted_retry=0, generation=random()", [this.kv.scope, at]);
+        this.onAlarmChange(at);
+    }
+    deleteAlarm(_opts) {
+        return this.op(() => this.clearAlarmSync());
+    }
+    clearAlarmSync() {
+        this.#meta();
+        this.sql.internalExec("DELETE FROM _cf_ALARM WHERE scope = ?", [this.kv.scope]);
+        this.onAlarmChange(null);
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/core/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/core/storage.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ValueCodec } from \"../ports.js\";\nimport { serialize } from \"../v8/serialize.js\";\nimport { CELLD_SCHEMA } from \"./celld-schema.js\";\nimport type { InputGate } from \"./gates.js\";\nimport type { SqlStorage } from \"./sql-storage.js\";\n\nexport interface ListOptions {\n  start?: string;\n  startAfter?: string;\n  end?: string;\n  prefix?: string;\n  reverse?: boolean;\n  limit?: number;\n}\n\n/** `EXPORT` of core/handles.ts, by its registered name: importing handles.ts here is a cycle. */\nconst EXPORT = Symbol.for(\"cellb.export\");\nconst withoutStoredStubs = (v: unknown): unknown =>\n  v && typeof v === \"object\" && (v as Record<symbol, unknown>)[EXPORT]\n    ? null\n    : Array.isArray(v)\n      ? v.map(withoutStoredStubs)\n      : v && Object.getPrototypeOf(v) === Object.prototype\n        ? Object.fromEntries(Object.entries(v).map(([k, x]) => [k, withoutStoredStubs(x)]))\n        : v;\n\n/**\n * Synchronous KV API of SQLite-backed objects (`ctx.storage.kv`), stored as celld stores it:\n * `_cf_KV(scope, k, v)` with the cell's scope and V8-serialized values (celld-schema.ts).\n */\nexport class SyncKvStorage {\n  #sql: SqlStorage;\n  #codec: ValueCodec;\n  #ready = false;\n  readonly scope: string;\n  /** The name the object was addressed by: recorded as celld's _cf_METADATA.actor_name. */\n  actorName: string | undefined;\n\n  constructor(sql: SqlStorage, codec: ValueCodec, scope = \"\") {\n    this.#sql = sql;\n    this.#codec = codec;\n    this.scope = scope;\n    sql.rolledBack.add(() => {\n      this.#ready = false; // the table may have been created inside the rolled-back transaction\n    });\n  }\n  #init(): void {\n    if (this.#ready) return;\n    for (const ddl of CELLD_SCHEMA) this.#sql.internalExec(ddl);\n    if (this.actorName !== undefined)\n      this.#sql.internalExec(\n        \"INSERT OR IGNORE INTO _cf_METADATA (scope, actor_name) VALUES (?, ?)\",\n        [this.scope, this.actorName],\n      );\n    this.#ready = true;\n  }\n  get<T = unknown>(key: string): T | undefined {\n    this.#init();\n    const r = this.#sql.internalExec(\"SELECT v FROM _cf_KV WHERE scope = ? AND k = ?\", [\n      this.scope,\n      key,\n    ]);\n    if (!r.rows.length) return undefined;\n    return this.#codec.decode(new Uint8Array(r.rows[0][0] as ArrayBuffer)) as T;\n  }\n  put(key: string, value: unknown): void {\n    this.#init();\n    // As celld: `undefined` is a storable value; what structured clone refuses is a TypeError.\n    // ctx.exports.X({ props }) stubs are left to the codec, which stores them (workerd).\n    try {\n      structuredClone(withoutStoredStubs(value));\n    } catch (e) {\n      // Worded as V8 (workerd, celld) words it, by cellb's V8 serializer: SpiderMonkey says\n      // \"Function object could not be cloned.\" for V8's \"() => 1 could not be cloned.\".\n      try {\n        serialize(withoutStoredStubs(value));\n      } catch (v8) {\n        throw new TypeError((v8 as Error).message);\n      }\n      // Browsers prefix the engine message (\"Failed to execute 'structuredClone' on …: \").\n      throw new TypeError(\n        (e as Error).message.replace(/^Failed to execute '[^']+' on '[^']+': /, \"\"),\n      );\n    }\n    this.#sql.internalExec(\"INSERT OR REPLACE INTO _cf_KV (scope, k, v) VALUES (?, ?, ?)\", [\n      this.scope,\n      key,\n      this.#codec.encode(value),\n    ]);\n  }\n  delete(key: string): boolean {\n    this.#init();\n    return (\n      this.#sql.internalExec(\"DELETE FROM _cf_KV WHERE scope = ? AND k = ?\", [this.scope, key])\n        .rowsWritten > 0\n    );\n  }\n  /**\n   * Only one list() iterator is live at a time, as in workerd: a new call invalidates the\n   * previous one, which throws on its next step.\n   */\n  list<T = unknown>(opts: ListOptions = {}): IterableIterator<[string, T]> {\n    const generation = ++this.#listGeneration;\n    const live = () => {\n      if (generation !== this.#listGeneration)\n        throw new Error(\n          \"kv.list() iterator was invalidated because a new call to kv.list() was started. \" +\n            \"Only one kv.list() iterator can exist at a time.\",\n        );\n    };\n    const rows = this.#rows<T>(opts);\n    return (function* () {\n      live();\n      for (const row of rows) {\n        yield row;\n        live();\n      }\n    })();\n  }\n  #listGeneration = 0;\n  *#rows<T>(opts: ListOptions): IterableIterator<[string, T]> {\n    this.#init();\n    const where: string[] = [\"scope = ?\"];\n    const params: unknown[] = [this.scope];\n    if (opts.start !== undefined) where.push(\"k >= ?\"), params.push(opts.start);\n    if (opts.startAfter !== undefined) where.push(\"k > ?\"), params.push(opts.startAfter);\n    if (opts.end !== undefined) where.push(\"k < ?\"), params.push(opts.end);\n    if (opts.prefix !== undefined)\n      where.push(\"substr(k, 1, ?) = ?\"), params.push(opts.prefix.length, opts.prefix);\n    let q = \"SELECT k, v FROM _cf_KV\";\n    q += ` WHERE ${where.join(\" AND \")}`;\n    q += ` ORDER BY k ${opts.reverse ? \"DESC\" : \"ASC\"}`;\n    if (opts.limit !== undefined) (q += \" LIMIT ?\"), params.push(opts.limit);\n    for (const [k, v] of this.#sql.internalExec(q, params).rows)\n      yield [k as string, this.#codec.decode(new Uint8Array(v as ArrayBuffer)) as T];\n  }\n  deleteAll(): void {\n    this.#init();\n    this.#sql.internalExec(\"DELETE FROM _cf_KV WHERE scope = ?\", [this.scope]);\n  }\n}\n\n/** Methods shared by `ctx.storage` and the `txn` object of `transaction()`. */\nexport class AsyncKvApi {\n  protected kv: SyncKvStorage;\n  protected gate: InputGate;\n  constructor(kv: SyncKvStorage, gate: InputGate) {\n    this.kv = kv;\n    this.gate = gate;\n  }\n  /** Every async storage op closes the input gate until it (and its continuation) completes. */\n  protected op<T>(fn: () => T): Promise<T> {\n    return this.gate.runClosed(async () => {\n      await Promise.resolve();\n      return fn();\n    });\n  }\n  get<T = unknown>(key: string): Promise<T | undefined>;\n  get<T = unknown>(keys: string[]): Promise<Map<string, T>>;\n  get(keyOrKeys: string | string[]): Promise<unknown> {\n    return this.op(() => {\n      if (!Array.isArray(keyOrKeys)) return this.kv.get(keyOrKeys);\n      checkKeys(keyOrKeys);\n      const m = new Map<string, unknown>();\n      for (const k of [...keyOrKeys].sort()) {\n        const v = this.kv.get(k);\n        if (v !== undefined) m.set(k, v);\n      }\n      return m;\n    });\n  }\n  put(key: string, value: unknown): Promise<void>;\n  put(entries: Record<string, unknown>): Promise<void>;\n  put(keyOrEntries: string | Record<string, unknown>, value?: unknown): Promise<void> {\n    return this.op(() => {\n      if (typeof keyOrEntries === \"string\") return this.kv.put(keyOrEntries, value);\n      const entries = Object.entries(keyOrEntries);\n      checkKeys(entries.map(([k]) => k));\n      for (const [k, v] of entries) this.kv.put(k, v);\n    });\n  }\n  delete(key: string): Promise<boolean>;\n  delete(keys: string[]): Promise<number>;\n  delete(keyOrKeys: string | string[]): Promise<boolean | number> {\n    return this.op(() => {\n      if (!Array.isArray(keyOrKeys)) return this.kv.delete(keyOrKeys);\n      checkKeys(keyOrKeys);\n      return keyOrKeys.filter((k) => this.kv.delete(k)).length;\n    });\n  }\n  list<T = unknown>(opts?: ListOptions): Promise<Map<string, T>> {\n    return this.op(() => new Map(this.kv.list<T>(opts)));\n  }\n}\n\n// celld sets no limit on the number of keys of one get/put/delete (storage-details).\nfunction checkKeys(_keys: string[]): void {}\n\nexport class DurableObjectTransaction extends AsyncKvApi {\n  rolledBack = false;\n  rollback(): void {\n    this.rolledBack = true;\n  }\n}\n\n/** `ctx.storage` of a SQLite-backed Durable Object. */\nexport class DurableObjectStorage extends AsyncKvApi {\n  readonly sql: SqlStorage;\n  readonly kv: SyncKvStorage;\n  #sync: () => Promise<void>;\n\n  constructor(sql: SqlStorage, kv: SyncKvStorage, gate: InputGate, sync: () => Promise<void>) {\n    super(kv, gate);\n    this.sql = sql;\n    sql.rolledBack.add(() => {\n      this.#metaReady = false;\n    });\n    this.kv = kv;\n    this.#sync = sync;\n  }\n  deleteAll(): Promise<void> {\n    return this.op(() => {\n      this.kv.deleteAll();\n      // deleteAll() also deletes the alarm, as on Cloudflare, unless `delete_all_preserves_alarm`.\n      if (!this.deleteAllPreservesAlarm) this.clearAlarmSync();\n      const tables = this.sql.internalExec(\n        \"SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE '\\\\_cf\\\\_%' ESCAPE '\\\\' AND name NOT LIKE 'sqlite\\\\_%' ESCAPE '\\\\'\",\n      ).rows;\n      for (const [name] of tables)\n        this.sql.internalExec(`DROP TABLE IF EXISTS \"${String(name).replace(/\"/g, '\"\"')}\"`);\n    });\n  }\n  transactionSync<T>(fn: () => T): T {\n    return this.sql.transactionSync(fn);\n  }\n  /**\n   * Async transaction spanning awaits: the input gate stays closed (no other\n   * event can interleave writes into the savepoint) and auto-commit is held.\n   */\n  transaction<T>(closure: (txn: DurableObjectTransaction) => Promise<T>): Promise<T> {\n    return this.gate.runClosed(async () => {\n      const release = this.sql.hold();\n      const sp = \"_cf_atx\";\n      this.sql.internalExec(`SAVEPOINT ${sp}`);\n      const txn = new DurableObjectTransaction(this.kv, this.gate);\n      try {\n        const r = await closure(txn);\n        if (txn.rolledBack) this.#rollbackTo(sp);\n        else this.sql.internalExec(`RELEASE ${sp}`);\n        return r;\n      } catch (e) {\n        this.#rollbackTo(sp);\n        throw e;\n      } finally {\n        release();\n      }\n    });\n  }\n  #rollbackTo(sp: string): void {\n    this.sql.internalExec(`ROLLBACK TO ${sp}`);\n    this.sql.internalExec(`RELEASE ${sp}`);\n    for (const f of this.sql.rolledBack) f(); // tables created inside may be gone\n  }\n  /** Resolves once all writes so far are durable (the output gate barrier). */\n  sync(): Promise<void> {\n    return this.#sync();\n  }\n  /** `delete_all_preserves_alarm`: deleteAll() leaves the alarm in place. */\n  deleteAllPreservesAlarm = false;\n  /** celld's harness hands its storage \"scope\" to engine ops; here it is the storage itself. */\n  get _scope(): this {\n    return this;\n  }\n  /** Called whenever the stored alarm changes (the runtime schedules it). */\n  onAlarmChange: (at: number | null) => void = () => {};\n\n  #metaReady = false;\n  #meta(): void {\n    if (this.#metaReady) return;\n    for (const ddl of CELLD_SCHEMA) this.sql.internalExec(ddl);\n    if (this.kv.actorName !== undefined)\n      this.sql.internalExec(\n        \"INSERT OR IGNORE INTO _cf_METADATA (scope, actor_name) VALUES (?, ?)\",\n        [this.kv.scope, this.kv.actorName],\n      );\n    this.#metaReady = true;\n  }\n  /**\n   * The alarm row as celld keeps it (storage.rs): due time, failure counters, and a random\n   * generation that changes with every setAlarm() — so a handler's own change is detected.\n   */\n  alarmRowSync(): { at: number; retry: number; counted: number; generation: string } | null {\n    this.#meta();\n    const r = this.sql.internalExec(\n      // generation is a 64-bit random(): read as text (beyond JS's safe integers)\n      \"SELECT at_ms, retry, counted_retry, CAST(generation AS TEXT) FROM _cf_ALARM WHERE scope = ?\",\n      [this.kv.scope],\n    ).rows[0];\n    return r\n      ? { at: Number(r[0]), retry: Number(r[1]), counted: Number(r[2]), generation: String(r[3]) }\n      : null;\n  }\n  /** The alarm being handled: getAlarm() reads null until the handler changes the alarm. */\n  #active: { generation: string } | undefined;\n  beginAlarm(row: { generation: string }): void {\n    this.#active = { generation: row.generation };\n  }\n  /**\n   * After the handler (celld's finish_alarm_handler): unless the handler changed the alarm,\n   * success deletes it and failure reschedules it with backoff (2 s << min(retry, 6)) —\n   * abandoned after 6 counted failures. Returns the alarm now stored.\n   */\n  finishAlarm(\n    fired: { at: number; generation: string },\n    succeeded: boolean,\n    now: number,\n  ): number | null {\n    this.#active = undefined;\n    const cur = this.alarmRowSync();\n    if (!cur || cur.generation !== fired.generation) return cur?.at ?? null;\n    if (succeeded) {\n      this.sql.internalExec(\"DELETE FROM _cf_ALARM WHERE scope = ? AND at_ms = ?\", [\n        this.kv.scope,\n        fired.at,\n      ]);\n    } else if (cur.counted >= 6) {\n      this.sql.internalExec(\"DELETE FROM _cf_ALARM WHERE scope = ?\", [this.kv.scope]);\n    } else {\n      const at = now + 2_000 * 2 ** Math.min(Math.max(cur.retry, 0), 6);\n      this.sql.internalExec(\n        \"UPDATE _cf_ALARM SET at_ms = ?, retry = retry + 1, counted_retry = counted_retry + 1 WHERE scope = ?\",\n        [at, this.kv.scope],\n      );\n    }\n    const after = this.alarmRowSync()?.at ?? null;\n    this.onAlarmChange(after);\n    return after;\n  }\n  /** Synchronous read of the stored alarm (ms since epoch) or null (null while it is handled). */\n  alarmSync(): number | null {\n    const row = this.alarmRowSync();\n    if (row && this.#active && this.#active.generation === row.generation) return null;\n    return row ? row.at : null;\n  }\n  /** One alarm per object, in celld's `_cf_ALARM` (same transaction as the event's writes). */\n  getAlarm(_opts?: unknown): Promise<number | null> {\n    return this.op(() => this.alarmSync());\n  }\n  setAlarm(scheduledTime: number | Date, _opts?: unknown): Promise<void> {\n    // As celld: the time is coerced to a number and a non-number becomes 0 (due at once).\n    const n = scheduledTime instanceof Date ? scheduledTime.getTime() : Number(scheduledTime);\n    const at = Number.isNaN(n) ? 0 : n;\n    return this.op(() => {\n      this.#meta();\n      this.sql.internalExec(\n        // celld's statement: counters reset, a new random generation\n        \"INSERT INTO _cf_ALARM(scope,at_ms,retry,counted_retry,generation) VALUES(?,?,0,0,random()) ON CONFLICT(scope) DO UPDATE SET at_ms=excluded.at_ms, retry=0, counted_retry=0, generation=random()\",\n        [this.kv.scope, at],\n      );\n      this.onAlarmChange(at);\n    });\n  }\n  /** setAlarm() inside a synchronous transaction (celld's harness ops). */\n  setAlarmSync(at: number): void {\n    this.#meta();\n    this.sql.internalExec(\n      \"INSERT INTO _cf_ALARM(scope,at_ms,retry,counted_retry,generation) VALUES(?,?,0,0,random()) ON CONFLICT(scope) DO UPDATE SET at_ms=excluded.at_ms, retry=0, counted_retry=0, generation=random()\",\n      [this.kv.scope, at],\n    );\n    this.onAlarmChange(at);\n  }\n  deleteAlarm(_opts?: unknown): Promise<void> {\n    return this.op(() => this.clearAlarmSync());\n  }\n  clearAlarmSync(): void {\n    this.#meta();\n    this.sql.internalExec(\"DELETE FROM _cf_ALARM WHERE scope = ?\", [this.kv.scope]);\n    this.onAlarmChange(null);\n  }\n}\n"]}

package/dist/core/worker-rejections.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Unhandled rejections of Worker code, on Node: the Worker's, not the host process's.
+ *
+ * On workerd and celld a promise the Worker leaves rejected is the Worker's affair: workerd logs
+ * it, celld ignores it, and neither stops anything. On Node the Worker runs in the host's
+ * process, so such a rejection reached the process's own `unhandledRejection` listeners (a test
+ * runner reports it as an error; Node's default ends the process). Each Worker event now runs in
+ * a scope that names its runtime, and a rejection raised in that scope goes to the runtime's
+ * handler instead: Node calls `unhandledRejection` listeners in the async context of the
+ * rejected promise, so the scope is found there.
+ *
+ * Browsers need none of this: a Worker runs in a worker of its own there.
+ */
+/** Receives a Worker's unhandled rejection. */
+export type RejectionHandler = (reason: unknown, promise: Promise<unknown>) => void;
+/** Runs `fn` in a scope whose unhandled rejections go to `handler`. */
+export type RejectionScope = <R>(fn: () => R) => R;
+/** The default handler: one line on the host's stderr, outside the Worker's own console. */
+export declare function reportToStderr(name: string): RejectionHandler;
+/** A scope routing unhandled rejections to `handler` (on Node; elsewhere `fn` runs as is). */
+export declare function rejectionScope(handler: RejectionHandler): RejectionScope;

package/dist/core/worker-rejections.js

@@ -0,0 +1,55 @@
+/**
+ * Unhandled rejections of Worker code, on Node: the Worker's, not the host process's.
+ *
+ * On workerd and celld a promise the Worker leaves rejected is the Worker's affair: workerd logs
+ * it, celld ignores it, and neither stops anything. On Node the Worker runs in the host's
+ * process, so such a rejection reached the process's own `unhandledRejection` listeners (a test
+ * runner reports it as an error; Node's default ends the process). Each Worker event now runs in
+ * a scope that names its runtime, and a rejection raised in that scope goes to the runtime's
+ * handler instead: Node calls `unhandledRejection` listeners in the async context of the
+ * rejected promise, so the scope is found there.
+ *
+ * Browsers need none of this: a Worker runs in a worker of its own there.
+ */
+const KEY = Symbol.for("cellb.workerRejections");
+/** The scope store, installed once per process (its `process.emit` hook routes by it). */
+function install() {
+    const g = globalThis;
+    if (g[KEY])
+        return g[KEY];
+    const proc = g.process;
+    const hooks = proc?.getBuiltinModule?.("node:async_hooks");
+    if (!proc || !hooks)
+        return undefined;
+    const scope = new hooks.AsyncLocalStorage();
+    const emit = proc.emit;
+    // `unhandledRejection` is emitted, not dispatched another way: a Worker's goes to its runtime
+    // and no further; everything else reaches the process's listeners as before.
+    proc.emit = function (event, ...args) {
+        if (event === "unhandledRejection") {
+            const handler = scope.getStore();
+            if (handler) {
+                handler(args[0], args[1]);
+                return true;
+            }
+        }
+        return emit.call(this, event, ...args);
+    };
+    g[KEY] = scope;
+    return scope;
+}
+/** The default handler: one line on the host's stderr, outside the Worker's own console. */
+export function reportToStderr(name) {
+    return (reason) => {
+        const err = reason;
+        const text = typeof err?.stack === "string" ? err.stack : String(reason);
+        const out = globalThis.process?.stderr;
+        out?.write(`[cellb] ${name}: unhandled rejection in Worker code: ${text}\n`);
+    };
+}
+/** A scope routing unhandled rejections to `handler` (on Node; elsewhere `fn` runs as is). */
+export function rejectionScope(handler) {
+    const scope = install();
+    return scope ? (fn) => scope.run(handler, fn) : (fn) => fn();
+}
+//# sourceMappingURL=worker-rejections.js.map

package/dist/core/worker-rejections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-rejections.js","sourceRoot":"","sources":["../../src/core/worker-rejections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAmBH,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAEjD,0FAA0F;AAC1F,SAAS,OAAO;IACd,MAAM,CAAC,GAAG,UAAiE,CAAC;IAC5E,IAAI,CAAC,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC,GAAG,CAA0B,CAAC;IACnD,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC;IACvB,MAAM,KAAK,GAAG,IAAI,EAAE,gBAAgB,EAAE,CAAC,kBAAkB,CAE5C,CAAC;IACd,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,iBAAiB,EAAoB,CAAC;IAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,8FAA8F;IAC9F,6EAA6E;IAC7E,IAAI,CAAC,IAAI,GAAG,UAAyB,KAAsB,EAAE,GAAG,IAAe;QAC7E,IAAI,KAAK,KAAK,oBAAoB,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;YACjC,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAqB,CAAC,CAAC;gBAC9C,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IACzC,CAAC,CAAC;IACF,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACf,OAAO,KAAK,CAAC;AACf,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,MAAM,GAAG,GAAG,MAA4B,CAAC;QACzC,MAAM,IAAI,GAAG,OAAO,GAAG,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzE,MAAM,GAAG,GAAI,UAAwC,CAAC,OAAO,EAAE,MAAM,CAAC;QACtE,GAAG,EAAE,KAAK,CAAC,WAAW,IAAI,yCAAyC,IAAI,IAAI,CAAC,CAAC;IAC/E,CAAC,CAAC;AACJ,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,cAAc,CAAC,OAAyB;IACtD,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC;IACxB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;AAC/D,CAAC","sourcesContent":["/**\n * Unhandled rejections of Worker code, on Node: the Worker's, not the host process's.\n *\n * On workerd and celld a promise the Worker leaves rejected is the Worker's affair: workerd logs\n * it, celld ignores it, and neither stops anything. On Node the Worker runs in the host's\n * process, so such a rejection reached the process's own `unhandledRejection` listeners (a test\n * runner reports it as an error; Node's default ends the process). Each Worker event now runs in\n * a scope that names its runtime, and a rejection raised in that scope goes to the runtime's\n * handler instead: Node calls `unhandledRejection` listeners in the async context of the\n * rejected promise, so the scope is found there.\n *\n * Browsers need none of this: a Worker runs in a worker of its own there.\n */\n\n/** Receives a Worker's unhandled rejection. */\nexport type RejectionHandler = (reason: unknown, promise: Promise<unknown>) => void;\n\n/** Runs `fn` in a scope whose unhandled rejections go to `handler`. */\nexport type RejectionScope = <R>(fn: () => R) => R;\n\ninterface Als<T> {\n  run<R>(store: T, fn: () => R): R;\n  getStore(): T | undefined;\n}\n\ntype NodeProcess = {\n  getBuiltinModule?(id: string): unknown;\n  emit: (event: string | symbol, ...args: unknown[]) => boolean;\n  stderr?: { write(s: string): unknown };\n};\n\nconst KEY = Symbol.for(\"cellb.workerRejections\");\n\n/** The scope store, installed once per process (its `process.emit` hook routes by it). */\nfunction install(): Als<RejectionHandler> | undefined {\n  const g = globalThis as { process?: NodeProcess } & Record<symbol, unknown>;\n  if (g[KEY]) return g[KEY] as Als<RejectionHandler>;\n  const proc = g.process;\n  const hooks = proc?.getBuiltinModule?.(\"node:async_hooks\") as\n    | { AsyncLocalStorage: new <T>() => Als<T> }\n    | undefined;\n  if (!proc || !hooks) return undefined;\n  const scope = new hooks.AsyncLocalStorage<RejectionHandler>();\n  const emit = proc.emit;\n  // `unhandledRejection` is emitted, not dispatched another way: a Worker's goes to its runtime\n  // and no further; everything else reaches the process's listeners as before.\n  proc.emit = function (this: unknown, event: string | symbol, ...args: unknown[]) {\n    if (event === \"unhandledRejection\") {\n      const handler = scope.getStore();\n      if (handler) {\n        handler(args[0], args[1] as Promise<unknown>);\n        return true;\n      }\n    }\n    return emit.call(this, event, ...args);\n  };\n  g[KEY] = scope;\n  return scope;\n}\n\n/** The default handler: one line on the host's stderr, outside the Worker's own console. */\nexport function reportToStderr(name: string): RejectionHandler {\n  return (reason) => {\n    const err = reason as { stack?: string };\n    const text = typeof err?.stack === \"string\" ? err.stack : String(reason);\n    const out = (globalThis as { process?: NodeProcess }).process?.stderr;\n    out?.write(`[cellb] ${name}: unhandled rejection in Worker code: ${text}\\n`);\n  };\n}\n\n/** A scope routing unhandled rejections to `handler` (on Node; elsewhere `fn` runs as is). */\nexport function rejectionScope(handler: RejectionHandler): RejectionScope {\n  const scope = install();\n  return scope ? (fn) => scope.run(handler, fn) : (fn) => fn();\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+export { type FilesApiBackupOptions, filesApiBackup } from "./adapters/files-backup.js";
+export { type ChangeLogOptions, filesApiChangeLog } from "./adapters/files-changelog.js";
+export { type FilesApiLtxLogOptions, filesApiLtxLog } from "./adapters/files-ltx.js";
+export { wasmMemoryOpener } from "./adapters/wasm-sqlite.js";
+export { AiError, type AiRunOptions, type WorkersAiOptions, workersAi, } from "./bindings/workers-ai.js";
+export { type CelldBucketOptions, celldBucket } from "./bucket/celld-cells.js";
+export { filesApiObjectStore, memoryObjectStore, type ObjectStore, PreconditionFailedError, } from "./bucket/object-store.js";
+export { type S3Options, s3ObjectStore } from "./bucket/s3-object-store.js";
+export { DurableObject, type ExecutionContext, WorkerEntrypoint } from "./core/durable-object.js";
+export { DurableObjectNamespace, type DurableObjectStub, runInDurableObject, } from "./core/namespace.js";
+export { BrokenObjectError, CellOwnedElsewhereError } from "./core/object-host.js";
+export { type CellRuntime, type CellRuntimeOptions, createCellRuntime, type WorkerModule, } from "./core/runtime.js";
+export { shardOf } from "./core/shard.js";
+export { DurableObjectState } from "./core/state.js";
+export * from "./ports.js";
+export { createProjectRuntime, type ProjectHost, type ProjectRuntime, type WranglerConfig, } from "./project/wrangler.js";
+export { CellRouter, type CellRouterOptions, ShardOwnerLostError } from "./router/cell-router.js";
+export { createShardWorker, type ShardWorker, type ShardWorkerOptions, shardRouting, } from "./router/shard-worker.js";
+export { type CellsHttpOptions, cellsHttpHandler, type RemoteRuntime, remoteRuntime, } from "./transport/cells-http.js";
+export { type CellPort, connectRuntime, linkOverPort, serveHandlerOverPort, serveRuntime, } from "./transport/port.js";
+export { type CellsWebSocketClass, createWebSocketClass, type WebSocketConnector, } from "./ws/client.js";
+export { CellsResponse, takeClientPort, WebSocketPair } from "./ws/server.js";