@statewalker/cellb 0.0.0-stage → 0.1.0

package/dist/core/runtime.js

@@ -0,0 +1,366 @@
+import { systemClock, } from "../ports.js";
+import { httpEndpoint, postVia } from "../transport/cells-link.js";
+import { v8Codec, v8CodecWith } from "../v8/codec.js";
+import { takeClientPort } from "../ws/server.js";
+import { withUpgrade } from "../ws/upgrade.js";
+import { AlarmScheduler } from "./alarms.js";
+import { asyncRoot } from "./async-context.js";
+import { ctxExports, storedExports } from "./handles.js";
+import { DurableObjectId, namespaceKey } from "./id.js";
+import { DurableObjectNamespace, localEndpoint } from "./namespace.js";
+import { CellOwnedElsewhereError, ObjectHost } from "./object-host.js";
+import { installRequestBody } from "./request-body.js";
+import { rejectionScope, reportToStderr } from "./worker-rejections.js";
+export function createCellRuntime(opts) {
+    installRequestBody(); // Firefox: `request.body` for the Worker code (and for the retry below)
+    const storage = opts.storage ?? {};
+    const { backup, ownership } = storage;
+    const durability = storage.durability ?? { committed: () => Promise.resolve() };
+    // V8 serialization: storage values in celld's (and workerd's) format.
+    const codec = opts.codec ?? v8Codec;
+    const hosts = new Map();
+    const background = new Set();
+    // Events start in the context the runtime was made in, not their caller's (Cloudflare).
+    // …and in a scope that keeps the Worker's unhandled rejections its own (Node).
+    const rejections = rejectionScope(opts.onUnhandledRejection ?? reportToStderr(opts.scriptName ?? "worker"));
+    const root = asyncRoot();
+    const eventsRoot = (fn) => root(() => rejections(fn));
+    const waitUntil = (p) => {
+        const t = p.catch(() => { }).finally(() => background.delete(t));
+        background.add(t);
+    };
+    const env = { ...opts.vars };
+    const bindingClasses = {};
+    const exportsObj = ctxExports(opts.worker, env);
+    // Storage values: V8 serialization; ctx.exports stubs are stored too (workerd).
+    const storageCodec = opts.codec ?? v8CodecWith(storedExports(exportsObj));
+    const clock = opts.clock ?? systemClock;
+    // Hosts by class name: the alarm scheduler wakes objects that nobody is calling.
+    const hostsByClass = new Map();
+    const alarms = new AlarmScheduler({
+        clock,
+        openIndex: () => opts.openSql("__cellb/alarms"),
+        fire: (e) => fireAlarm(e),
+    });
+    // One alarm() at a time per object (as on Cloudflare): a re-armed alarm that comes due
+    // while the previous handler still runs waits for it.
+    const alarmRuns = new Map();
+    const ownedRetries = new Map();
+    function fireAlarm(e) {
+        const prev = alarmRuns.get(e.cellKey) ?? Promise.resolve();
+        const next = prev.then(() => fireAlarmNow(e));
+        alarmRuns.set(e.cellKey, next);
+        void next.finally(() => {
+            if (alarmRuns.get(e.cellKey) === next)
+                alarmRuns.delete(e.cellKey);
+        });
+        return next;
+    }
+    /**
+     * celld's alarm lifecycle, in the cell's own storage (so it survives restarts and moves
+     * between nodes, celld included): the row stays while its handler runs (getAlarm() reads
+     * null meanwhile); success deletes it, failure reschedules it with backoff and counts the
+     * failure in the row (`retry`, `counted_retry`) — alarmInfo.retryCount is that count.
+     */
+    async function fireAlarmNow(e) {
+        const hostFor = hostsByClass.get(e.className);
+        if (!hostFor)
+            return;
+        const host = hostFor(new DurableObjectId(e.idHex));
+        try {
+            await host.deliver(async (obj, state) => {
+                // A wake (local timer, or an entry of the shared wake index) is a hint: the stored
+                // alarm decides. Gone → nothing to do; moved later → wait for that time.
+                const row = state.storage.alarmRowSync();
+                if (!row)
+                    return;
+                if (row.at > clock.now()) {
+                    alarms.set(e, row.at);
+                    return;
+                }
+                state.storage.beginAlarm(row);
+                let ok = true;
+                try {
+                    if (typeof obj.alarm === "function")
+                        await obj.alarm({
+                            retryCount: row.retry,
+                            isRetry: row.retry > 0,
+                            scheduledTime: row.at, // alarmInfo.scheduledTime, as in workerd
+                        });
+                }
+                catch {
+                    ok = false;
+                }
+                state.storage.finishAlarm(row, ok, clock.now());
+            });
+            ownedRetries.delete(e.cellKey);
+        }
+        catch (err) {
+            // Owned by another node (celld or cellb): its owner fires the alarm.
+            if (isOwnedElsewhere(err)) {
+                hosts.get(e.cellKey)?.close();
+                hosts.delete(e.cellKey);
+                // A live owner fires it. A stopped one's lease expires within its TTL: look again a
+                // few times before leaving it to the next poll of the wake index.
+                const n = (ownedRetries.get(e.cellKey) ?? 0) + 1;
+                if (n <= 15) {
+                    ownedRetries.set(e.cellKey, n);
+                    alarms.set(e, clock.now() + 2_000);
+                }
+                else
+                    ownedRetries.delete(e.cellKey);
+            }
+            // Any other failure (broken object, storage error): the row is unchanged; it fires again
+            // when the object is next opened or the index is polled.
+        }
+    }
+    for (const [binding, { className }] of Object.entries(opts.durableObjects ?? {})) {
+        const cls = opts.worker[className];
+        if (typeof cls !== "function")
+            throw new Error(`Durable Object class "${className}" is not exported by the worker`);
+        const hostFor = (id) => {
+            const cellKey = `${className}/${id.toString()}`;
+            let h = hosts.get(cellKey);
+            if (!h || h.broken) {
+                h?.close();
+                h = new ObjectHost({
+                    cellKey,
+                    id,
+                    cls,
+                    env,
+                    openSql: opts.openSql,
+                    durability,
+                    codec: storageCodec,
+                    waitUntil,
+                    backup,
+                    onAlarmChange: (at) => alarms.set({ cellKey, className, idHex: id.toString() }, at),
+                    exports: exportsObj,
+                    facet: opts.facets,
+                    asyncRoot: eventsRoot,
+                    acquire: ownership ? (key) => ownership.tryAcquire(key) : undefined,
+                    sqlExtensions: opts.sqlExtensions,
+                    deleteAllPreservesAlarm: opts.deleteAllPreservesAlarm,
+                });
+                hosts.set(cellKey, h);
+            }
+            return h;
+        };
+        hostsByClass.set(className, hostFor);
+        const nsKey = opts.namespaceKeys?.[className] ?? namespaceKey(opts.scriptName ?? "worker", className);
+        env[binding] = new DurableObjectNamespace(nsKey, (id) => {
+            const remote = opts.route?.(`${className}/${id.toString()}`, id);
+            if (remote)
+                return () => httpEndpoint(postVia(remote), codec, binding, className, id);
+            const cellKey = `${className}/${id.toString()}`;
+            // A cell not open yet waits for room in its store before its first event (OPFS pool).
+            const ready = () => (hosts.has(cellKey) ? undefined : opts.openSql.room?.(cellKey));
+            const local = localEndpoint(() => hostFor(id), ready);
+            const peers = opts.peers;
+            if (!peers)
+                return local;
+            // Local first; a cell owned by another node is reached through that node.
+            const viaOwner = async () => {
+                const owner = await peers.ownerOf(cellKey);
+                if (!owner)
+                    throw new CellOwnedElsewhereError(cellKey);
+                const direct = await peers.endpoint?.(owner, cellKey, id.name);
+                if (direct)
+                    return direct;
+                return httpEndpoint(postVia(peers.link(owner)), codec, binding, className, id);
+            };
+            // The host reports a failed open as a broken object; the cause tells why.
+            const elsewhere = (e) => {
+                for (let x = e, i = 0; x && i < 5; x = x.cause, i++)
+                    if (x.name === "CellOwnedElsewhereError")
+                        return true;
+                return false;
+            };
+            return () => {
+                const l = local();
+                return {
+                    get local() {
+                        return l.local; // not copied: reading it opens the cell
+                    },
+                    fetch: async (req) => {
+                        const spare = req.body ? req.clone() : req;
+                        try {
+                            return await l.fetch(req);
+                        }
+                        catch (e) {
+                            if (!elsewhere(e))
+                                throw e;
+                            hosts.get(cellKey)?.close();
+                            hosts.delete(cellKey);
+                            return (await viaOwner()).fetch(spare);
+                        }
+                    },
+                    call: async (method, args) => {
+                        try {
+                            return await l.call(method, args);
+                        }
+                        catch (e) {
+                            if (!elsewhere(e))
+                                throw e;
+                            hosts.get(cellKey)?.close();
+                            hosts.delete(cellKey);
+                            return (await viaOwner()).call(method, args);
+                        }
+                    },
+                };
+            };
+        });
+        bindingClasses[binding] = className;
+        // ctx.exports.<Class> of a class with a namespace is also that namespace, as in workerd
+        // (`ctx.exports.MyActor.getByName("a")`); it stays usable as a facet class handle.
+        const ns = env[binding];
+        const exported = exportsObj[className];
+        if (exported && !("getByName" in exported))
+            for (const [m, d] of Object.entries(Object.getOwnPropertyDescriptors(DurableObjectNamespace.prototype)))
+                if (m !== "constructor" && typeof d.value === "function")
+                    exported[m] = d.value.bind(ns);
+    }
+    alarms.restore();
+    // Alarms published by any node in a shared wake index (celld's): this node fires them too.
+    // An entry is only a hint: firing opens the cell and runs alarm() only if its stored alarm
+    // is still due at that time.
+    // The index is read at start and then every `wakePollMs` (default 30 s), so alarms of cells
+    // whose owner went away are picked up — celld's waker does the same.
+    const wakes = storage.durability?.wakes;
+    let wakeTimer;
+    let wakesStopped = false;
+    if (wakes) {
+        const known = new Set(Object.values(bindingClasses));
+        const poll = async () => {
+            try {
+                for (const w of await wakes.call(storage.durability))
+                    if (known.has(w.className) && !alarmRuns.has(w.cellKey))
+                        alarms.set({ cellKey: w.cellKey, className: w.className, idHex: w.cellKey.split("/")[1] }, w.at);
+            }
+            catch {
+                // the index is unavailable for now: next poll
+            }
+            if (!wakesStopped)
+                wakeTimer = clock.setTimeout(() => void poll(), opts.wakePollMs ?? 30_000);
+        };
+        void poll();
+    }
+    // Idle sweep for hibernation (opt-in).
+    let hibernationTimer;
+    if (opts.hibernateAfterMs !== undefined) {
+        const every = Math.max(1_000, opts.hibernateAfterMs / 2);
+        const sweep = () => {
+            runtime.hibernateIdle();
+            hibernationTimer = clock.setTimeout(sweep, every);
+        };
+        hibernationTimer = clock.setTimeout(sweep, every);
+    }
+    const backupAll = (reason) => Promise.all([...hosts.values()].map((h) => h.backupIfDirty(reason, clock.now()))).then(() => { });
+    let timer;
+    let closed = false;
+    const schedule = () => {
+        if (!backup || closed)
+            return;
+        timer = clock.setTimeout(() => {
+            void backupAll("interval").finally(schedule);
+        }, backup.intervalMs ?? 30_000);
+    };
+    schedule();
+    const runtime = {
+        env,
+        exports: exportsObj,
+        durableObjectBindings: bindingClasses,
+        backupNow: () => backupAll("manual"),
+        async connectWebSocket(url, protocols = [], headers) {
+            const h = new Headers(headers);
+            h.set("Upgrade", "websocket");
+            if (protocols.length)
+                h.set("Sec-WebSocket-Protocol", protocols.join(", "));
+            const httpUrl = url.replace(/^ws(s?):/, "http$1:");
+            const res = (await this.fetch(withUpgrade(new Request(httpUrl, { headers: h }), "websocket", protocols.length ? { "Sec-WebSocket-Protocol": protocols.join(", ") } : undefined)));
+            if (res.status !== 101 || !res.webSocket)
+                throw new Error(`WebSocket upgrade refused: HTTP ${res.status}`);
+            return {
+                port: takeClientPort(res.webSocket),
+                protocol: res.headers.get("Sec-WebSocket-Protocol") ?? undefined,
+            };
+        },
+        restartObject(cellKey) {
+            hosts.get(cellKey)?.restart();
+        },
+        hibernateIdle(idleMs = opts.hibernateAfterMs ?? 0) {
+            const now = Date.now();
+            let n = 0;
+            const closeMs = opts.closeDatabaseAfterMs;
+            for (const h of hosts.values()) {
+                const idle = now - h.lastActive;
+                if (idle >= idleMs && h.hibernate())
+                    n++;
+                if (closeMs !== undefined && idle >= closeMs)
+                    h.closeDatabase();
+            }
+            return n;
+        },
+        async close() {
+            if (hibernationTimer !== undefined)
+                clock.clearTimeout(hibernationTimer);
+            closed = true;
+            wakesStopped = true;
+            if (wakeTimer !== undefined)
+                clock.clearTimeout(wakeTimer);
+            alarms.stop();
+            clock.clearTimeout(timer);
+            timer = undefined;
+            await backupAll("close");
+            // The releases reach the store before it closes.
+            await Promise.all([...hosts.values()].map((h) => h.close()));
+            hosts.clear();
+            alarms.close(); // every database of the runtime is closed now
+            await storage.close?.();
+        },
+        async fetch(req) {
+            const handler = opts.worker.default?.fetch;
+            if (!handler)
+                return new Response("Worker has no fetch handler", { status: 500 });
+            const ctx = {
+                waitUntil,
+                passThroughOnException() { },
+                exports: exportsObj,
+            };
+            // celld's ingress: an inbound request has a `cf` object (no edge fields).
+            if (req.cf === undefined)
+                Object.defineProperty(req, "cf", { value: {}, enumerable: true });
+            try {
+                const r = await rejections(() => handler.call(opts.worker.default, req, env, ctx));
+                // A non-Response is sent as text (celld), not a failure.
+                return r instanceof Response ? r : new Response(String(r));
+            }
+            catch (e) {
+                const err = e;
+                return new Response(`Worker failed: rejected: ${err?.name ?? "Error"}: ${err?.message ?? String(e)}`, {
+                    status: 500,
+                    headers: { "content-type": "application/json" },
+                });
+            }
+        },
+        runEvent: (fn) => rejections(fn),
+        evictAll() {
+            for (const h of hosts.values())
+                h.close();
+            hosts.clear();
+        },
+        async drain() {
+            while (background.size)
+                await Promise.all([...background]);
+        },
+        waitUntil,
+    };
+    return runtime;
+}
+/** The error (or its cause chain) says another node owns the cell. */
+export function isOwnedElsewhere(e) {
+    for (let x = e, i = 0; x && i < 5; x = x.cause, i++)
+        if (x.name === "CellOwnedElsewhereError")
+            return true;
+    return false;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/core/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/core/runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  type CellDurability,\n  type CellStorage,\n  type Clock,\n  type OpenCellSql,\n  systemClock,\n  type ValueCodec,\n} from \"../ports.js\";\nimport { httpEndpoint, postVia, type Send } from \"../transport/cells-link.js\";\nimport { v8Codec, v8CodecWith } from \"../v8/codec.js\";\nimport { type CfWebSocket, takeClientPort } from \"../ws/server.js\";\nimport { withUpgrade } from \"../ws/upgrade.js\";\nimport { type AlarmEntry, AlarmScheduler } from \"./alarms.js\";\nimport { type AsyncRoot, asyncRoot } from \"./async-context.js\";\nimport type { ExecutionContext } from \"./durable-object.js\";\nimport { ctxExports, type DurableObjectClass, storedExports } from \"./handles.js\";\nimport { DurableObjectId, namespaceKey } from \"./id.js\";\nimport { DurableObjectNamespace, localEndpoint, type ObjectEndpoint } from \"./namespace.js\";\nimport { CellOwnedElsewhereError, ObjectHost } from \"./object-host.js\";\nimport { installRequestBody } from \"./request-body.js\";\nimport { type RejectionHandler, rejectionScope, reportToStderr } from \"./worker-rejections.js\";\n\nexport interface WorkerModule {\n  default: { fetch?(req: Request, env: any, ctx: ExecutionContext): Response | Promise<Response> };\n  [exportName: string]: unknown;\n}\n\nexport interface CellRuntimeOptions {\n  /**\n   * A promise the Worker's code leaves rejected (Node: the Worker shares the host's process).\n   * It is the Worker's, as on workerd and celld: it reaches this handler, not the process's\n   * `unhandledRejection` listeners. Default: one line on stderr, outside the Worker's console.\n   */\n  onUnhandledRejection?: RejectionHandler;\n  /** The Worker's module namespace (what wrangler/celld bundle as main module). */\n  worker: WorkerModule;\n  /** Durable Object bindings: env name → exported class name (wrangler `durable_objects.bindings`). */\n  durableObjects?: Record<string, { className: string }>;\n  /** Plain vars / other bindings merged into env. */\n  vars?: Record<string, unknown>;\n  openSql: OpenCellSql;\n  /** Durability, backup and ownership of the cells; closed by `close()`, after the runtime. */\n  storage?: CellStorage;\n  codec?: ValueCodec;\n  /**\n   * Placement: return a `send` when the cell lives elsewhere (another shard\n   * worker, tab or peer); `undefined` means \"host it here\". Default: all local.\n   */\n  route?: (cellKey: string, id: DurableObjectId) => Send | undefined;\n  /** How often to re-read a shared alarm wake index (durability.wakes), in ms. Default 30 s. */\n  wakePollMs?: number;\n  /** Every object of this runtime is a facet of an outer cell (an isolate's runtime). */\n  facets?: boolean;\n  /** The Worker script's name (wrangler `name`): object ids derive from it, as on celld. */\n  scriptName?: string;\n  /** Namespace keys overriding the script-scoped default, per class (celld's fleet-wide ones). */\n  namespaceKeys?: Record<string, string>;\n  /**\n   * Routing between nodes (celld's peer routing): when this node cannot own a cell\n   * (`CellOwnedElsewhereError`), the call goes to the owner's node over an internal link\n   * (`cellsHttpHandler` on the far side). `ownerOf` reads the cell's lease holder.\n   */\n  peers?: {\n    ownerOf(cellKey: string): Promise<string | undefined>;\n    link(owner: string): Send;\n    /**\n     * Talks to an owner directly, for owners that do not speak cellsHttpHandler (a celld node,\n     * reached through celld's peer tunnel). Takes precedence over `link` when it returns one.\n     */\n    endpoint?(\n      owner: string,\n      cellKey: string,\n      name: string | undefined,\n    ): Promise<ObjectEndpoint | undefined>;\n  };\n  /** Hibernate objects idle this long (ms); swept every max(1 s, half of it). Off by default. */\n  hibernateAfterMs?: number;\n  /**\n   * Close the SQLite database of a hibernated object idle this long (ms); the next event reopens\n   * it. Swept with `hibernateAfterMs`, so it needs that too. Off by default: the database must\n   * come back, so use local SQLite that persists (a directory, an OPFS pool) or storage that\n   * restores the cell (a log or a backup).\n   */\n  closeDatabaseAfterMs?: number;\n  /** SQLite extensions loaded into every cell database (celld's `sqlite_vec` flag). */\n  sqlExtensions?: string[];\n  /** `delete_all_preserves_alarm`: storage.deleteAll() keeps the alarm (default: deletes it). */\n  deleteAllPreservesAlarm?: boolean;\n  /** Timers of the runtime (backups); injectable for tests. */\n  clock?: Clock;\n}\n\nexport interface CellRuntime {\n  /** Ingress: a (Request) ⇒ Response handler — exactly what webrun-http-browser / node:http mount. */\n  fetch(req: Request): Promise<Response>;\n  readonly env: Record<string, unknown>;\n  /** The Worker's `ctx.exports` (also `exports` of `cloudflare:workers`). */\n  readonly exports: Record<string, unknown>;\n  /**\n   * Runs Worker code the host dispatches itself (a cron trigger's `scheduled()`) as the Worker's\n   * event: a promise it leaves rejected goes to `onUnhandledRejection`, not to the process.\n   */\n  runEvent<R>(fn: () => R): R;\n  /** Drops live instances (simulates eviction / hibernation); storage survives if openSql persists it. */\n  evictAll(): void;\n  /** Settles all waitUntil() promises. */\n  drain(): Promise<void>;\n  /**\n   * Keeps `p` running in the background until `drain()` (what `waitUntil` of\n   * `cloudflare:workers` does: on Cloudflare it extends the current event).\n   */\n  waitUntil(p: Promise<unknown>): void;\n  /** Durable Object binding → class name (the namespace key used by idFromName). */\n  readonly durableObjectBindings: Readonly<Record<string, string>>;\n  /**\n   * WebSocket ingress: runs the Worker's fetch with an Upgrade request; on a 101\n   * with `webSocket`, returns the client end's MessagePort (to be transferred to\n   * the real client, e.g. a page's CellsWebSocket).\n   */\n  connectWebSocket(\n    url: string,\n    protocols?: string[],\n    headers?: HeadersInit,\n  ): Promise<{ port: MessagePort; protocol?: string }>;\n  /** Backs up every live cell that changed since its last successful save. */\n  backupNow(): Promise<void>;\n  /**\n   * Hibernates every object idle for at least `idleMs` (default: `hibernateAfterMs`):\n   * instances are dropped, storage and hibernatable WebSockets stay. Returns how many slept.\n   * Hibernated objects idle for `closeDatabaseAfterMs` also close their database.\n   */\n  hibernateIdle(idleMs?: number): number;\n  /** Replaces one object's instance with a fresh one on the same storage (facet abort). */\n  restartObject(cellKey: string): void;\n  /** Final backup of changed cells, then stops timers, closes every database and the storage. */\n  close(): Promise<void>;\n}\n\nexport function createCellRuntime(opts: CellRuntimeOptions): CellRuntime {\n  installRequestBody(); // Firefox: `request.body` for the Worker code (and for the retry below)\n  const storage = opts.storage ?? {};\n  const { backup, ownership } = storage;\n  const durability: CellDurability = storage.durability ?? { committed: () => Promise.resolve() };\n  // V8 serialization: storage values in celld's (and workerd's) format.\n  const codec = opts.codec ?? v8Codec;\n  const hosts = new Map<string, ObjectHost>();\n  const background = new Set<Promise<unknown>>();\n  // Events start in the context the runtime was made in, not their caller's (Cloudflare).\n  // …and in a scope that keeps the Worker's unhandled rejections its own (Node).\n  const rejections = rejectionScope(\n    opts.onUnhandledRejection ?? reportToStderr(opts.scriptName ?? \"worker\"),\n  );\n  const root = asyncRoot();\n  const eventsRoot: AsyncRoot = (fn) => root(() => rejections(fn));\n  const waitUntil = (p: Promise<unknown>) => {\n    const t = p.catch(() => {}).finally(() => background.delete(t));\n    background.add(t);\n  };\n  const env: Record<string, unknown> = { ...opts.vars };\n  const bindingClasses: Record<string, string> = {};\n  const exportsObj = ctxExports(opts.worker, env);\n  // Storage values: V8 serialization; ctx.exports stubs are stored too (workerd).\n  const storageCodec = opts.codec ?? v8CodecWith(storedExports(exportsObj));\n  const clock = opts.clock ?? systemClock;\n  // Hosts by class name: the alarm scheduler wakes objects that nobody is calling.\n  const hostsByClass = new Map<string, (id: DurableObjectId) => ObjectHost>();\n  const alarms = new AlarmScheduler({\n    clock,\n    openIndex: () => opts.openSql(\"__cellb/alarms\"),\n    fire: (e) => fireAlarm(e),\n  });\n  // One alarm() at a time per object (as on Cloudflare): a re-armed alarm that comes due\n  // while the previous handler still runs waits for it.\n  const alarmRuns = new Map<string, Promise<void>>();\n  const ownedRetries = new Map<string, number>();\n  function fireAlarm(e: AlarmEntry): Promise<void> {\n    const prev = alarmRuns.get(e.cellKey) ?? Promise.resolve();\n    const next = prev.then(() => fireAlarmNow(e));\n    alarmRuns.set(e.cellKey, next);\n    void next.finally(() => {\n      if (alarmRuns.get(e.cellKey) === next) alarmRuns.delete(e.cellKey);\n    });\n    return next;\n  }\n  /**\n   * celld's alarm lifecycle, in the cell's own storage (so it survives restarts and moves\n   * between nodes, celld included): the row stays while its handler runs (getAlarm() reads\n   * null meanwhile); success deletes it, failure reschedules it with backoff and counts the\n   * failure in the row (`retry`, `counted_retry`) — alarmInfo.retryCount is that count.\n   */\n  async function fireAlarmNow(e: AlarmEntry): Promise<void> {\n    const hostFor = hostsByClass.get(e.className);\n    if (!hostFor) return;\n    const host = hostFor(new DurableObjectId(e.idHex));\n    try {\n      await host.deliver(async (obj, state) => {\n        // A wake (local timer, or an entry of the shared wake index) is a hint: the stored\n        // alarm decides. Gone → nothing to do; moved later → wait for that time.\n        const row = state.storage.alarmRowSync();\n        if (!row) return;\n        if (row.at > clock.now()) {\n          alarms.set(e, row.at);\n          return;\n        }\n        state.storage.beginAlarm(row);\n        let ok = true;\n        try {\n          if (typeof obj.alarm === \"function\")\n            await obj.alarm({\n              retryCount: row.retry,\n              isRetry: row.retry > 0,\n              scheduledTime: row.at, // alarmInfo.scheduledTime, as in workerd\n            });\n        } catch {\n          ok = false;\n        }\n        state.storage.finishAlarm(row, ok, clock.now());\n      });\n      ownedRetries.delete(e.cellKey);\n    } catch (err) {\n      // Owned by another node (celld or cellb): its owner fires the alarm.\n      if (isOwnedElsewhere(err)) {\n        hosts.get(e.cellKey)?.close();\n        hosts.delete(e.cellKey);\n        // A live owner fires it. A stopped one's lease expires within its TTL: look again a\n        // few times before leaving it to the next poll of the wake index.\n        const n = (ownedRetries.get(e.cellKey) ?? 0) + 1;\n        if (n <= 15) {\n          ownedRetries.set(e.cellKey, n);\n          alarms.set(e, clock.now() + 2_000);\n        } else ownedRetries.delete(e.cellKey);\n      }\n      // Any other failure (broken object, storage error): the row is unchanged; it fires again\n      // when the object is next opened or the index is polled.\n    }\n  }\n\n  for (const [binding, { className }] of Object.entries(opts.durableObjects ?? {})) {\n    const cls = opts.worker[className] as DurableObjectClass | undefined;\n    if (typeof cls !== \"function\")\n      throw new Error(`Durable Object class \"${className}\" is not exported by the worker`);\n    const hostFor = (id: DurableObjectId): ObjectHost => {\n      const cellKey = `${className}/${id.toString()}`;\n      let h = hosts.get(cellKey);\n      if (!h || h.broken) {\n        h?.close();\n        h = new ObjectHost({\n          cellKey,\n          id,\n          cls,\n          env,\n          openSql: opts.openSql,\n          durability,\n          codec: storageCodec,\n          waitUntil,\n          backup,\n          onAlarmChange: (at) => alarms.set({ cellKey, className, idHex: id.toString() }, at),\n          exports: exportsObj,\n          facet: opts.facets,\n          asyncRoot: eventsRoot,\n          acquire: ownership ? (key) => ownership.tryAcquire(key) : undefined,\n          sqlExtensions: opts.sqlExtensions,\n          deleteAllPreservesAlarm: opts.deleteAllPreservesAlarm,\n        });\n        hosts.set(cellKey, h);\n      }\n      return h;\n    };\n    hostsByClass.set(className, hostFor);\n    const nsKey =\n      opts.namespaceKeys?.[className] ?? namespaceKey(opts.scriptName ?? \"worker\", className);\n    env[binding] = new DurableObjectNamespace(nsKey, (id) => {\n      const remote = opts.route?.(`${className}/${id.toString()}`, id);\n      if (remote) return () => httpEndpoint(postVia(remote), codec, binding, className, id);\n      const cellKey = `${className}/${id.toString()}`;\n      // A cell not open yet waits for room in its store before its first event (OPFS pool).\n      const ready = () => (hosts.has(cellKey) ? undefined : opts.openSql.room?.(cellKey));\n      const local = localEndpoint(() => hostFor(id), ready);\n      const peers = opts.peers;\n      if (!peers) return local;\n      // Local first; a cell owned by another node is reached through that node.\n      const viaOwner = async () => {\n        const owner = await peers.ownerOf(cellKey);\n        if (!owner) throw new CellOwnedElsewhereError(cellKey);\n        const direct = await peers.endpoint?.(owner, cellKey, id.name);\n        if (direct) return direct;\n        return httpEndpoint(postVia(peers.link(owner)), codec, binding, className, id);\n      };\n      // The host reports a failed open as a broken object; the cause tells why.\n      const elsewhere = (e: unknown): boolean => {\n        for (\n          let x = e as { name?: string; cause?: unknown } | undefined, i = 0;\n          x && i < 5;\n          x = x.cause as never, i++\n        )\n          if (x.name === \"CellOwnedElsewhereError\") return true;\n        return false;\n      };\n      return () => {\n        const l = local();\n        return {\n          get local() {\n            return l.local; // not copied: reading it opens the cell\n          },\n          fetch: async (req: Request) => {\n            const spare = req.body ? req.clone() : req;\n            try {\n              return await l.fetch(req);\n            } catch (e) {\n              if (!elsewhere(e)) throw e;\n              hosts.get(cellKey)?.close();\n              hosts.delete(cellKey);\n              return (await viaOwner()).fetch(spare);\n            }\n          },\n          call: async (method: string, args: unknown[]) => {\n            try {\n              return await l.call(method, args);\n            } catch (e) {\n              if (!elsewhere(e)) throw e;\n              hosts.get(cellKey)?.close();\n              hosts.delete(cellKey);\n              return (await viaOwner()).call(method, args);\n            }\n          },\n        };\n      };\n    });\n    bindingClasses[binding] = className;\n    // ctx.exports.<Class> of a class with a namespace is also that namespace, as in workerd\n    // (`ctx.exports.MyActor.getByName(\"a\")`); it stays usable as a facet class handle.\n    const ns = env[binding] as DurableObjectNamespace;\n    const exported = exportsObj[className] as Record<string, unknown> | undefined;\n    if (exported && !(\"getByName\" in exported))\n      for (const [m, d] of Object.entries(\n        Object.getOwnPropertyDescriptors(DurableObjectNamespace.prototype),\n      ))\n        if (m !== \"constructor\" && typeof d.value === \"function\") exported[m] = d.value.bind(ns);\n  }\n\n  alarms.restore();\n  // Alarms published by any node in a shared wake index (celld's): this node fires them too.\n  // An entry is only a hint: firing opens the cell and runs alarm() only if its stored alarm\n  // is still due at that time.\n  // The index is read at start and then every `wakePollMs` (default 30 s), so alarms of cells\n  // whose owner went away are picked up — celld's waker does the same.\n  const wakes = storage.durability?.wakes;\n  let wakeTimer: unknown;\n  let wakesStopped = false;\n  if (wakes) {\n    const known = new Set(Object.values(bindingClasses));\n    const poll = async () => {\n      try {\n        for (const w of await wakes.call(storage.durability))\n          if (known.has(w.className) && !alarmRuns.has(w.cellKey))\n            alarms.set(\n              { cellKey: w.cellKey, className: w.className, idHex: w.cellKey.split(\"/\")[1] },\n              w.at,\n            );\n      } catch {\n        // the index is unavailable for now: next poll\n      }\n      if (!wakesStopped) wakeTimer = clock.setTimeout(() => void poll(), opts.wakePollMs ?? 30_000);\n    };\n    void poll();\n  }\n  // Idle sweep for hibernation (opt-in).\n  let hibernationTimer: unknown;\n  if (opts.hibernateAfterMs !== undefined) {\n    const every = Math.max(1_000, opts.hibernateAfterMs / 2);\n    const sweep = () => {\n      runtime.hibernateIdle();\n      hibernationTimer = clock.setTimeout(sweep, every);\n    };\n    hibernationTimer = clock.setTimeout(sweep, every);\n  }\n  const backupAll = (reason: \"interval\" | \"manual\" | \"close\") =>\n    Promise.all([...hosts.values()].map((h) => h.backupIfDirty(reason, clock.now()))).then(\n      () => {},\n    );\n  let timer: unknown;\n  let closed = false;\n  const schedule = () => {\n    if (!backup || closed) return;\n    timer = clock.setTimeout(() => {\n      void backupAll(\"interval\").finally(schedule);\n    }, backup.intervalMs ?? 30_000);\n  };\n  schedule();\n\n  const runtime: CellRuntime = {\n    env,\n    exports: exportsObj,\n    durableObjectBindings: bindingClasses,\n    backupNow: () => backupAll(\"manual\"),\n    async connectWebSocket(url, protocols = [], headers) {\n      const h = new Headers(headers);\n      h.set(\"Upgrade\", \"websocket\");\n      if (protocols.length) h.set(\"Sec-WebSocket-Protocol\", protocols.join(\", \"));\n      const httpUrl = url.replace(/^ws(s?):/, \"http$1:\");\n      const res = (await this.fetch(\n        withUpgrade(\n          new Request(httpUrl, { headers: h }),\n          \"websocket\",\n          protocols.length ? { \"Sec-WebSocket-Protocol\": protocols.join(\", \") } : undefined,\n        ),\n      )) as Response & {\n        webSocket?: CfWebSocket | null;\n      };\n      if (res.status !== 101 || !res.webSocket)\n        throw new Error(`WebSocket upgrade refused: HTTP ${res.status}`);\n      return {\n        port: takeClientPort(res.webSocket),\n        protocol: res.headers.get(\"Sec-WebSocket-Protocol\") ?? undefined,\n      };\n    },\n    restartObject(cellKey: string) {\n      hosts.get(cellKey)?.restart();\n    },\n    hibernateIdle(idleMs = opts.hibernateAfterMs ?? 0) {\n      const now = Date.now();\n      let n = 0;\n      const closeMs = opts.closeDatabaseAfterMs;\n      for (const h of hosts.values()) {\n        const idle = now - h.lastActive;\n        if (idle >= idleMs && h.hibernate()) n++;\n        if (closeMs !== undefined && idle >= closeMs) h.closeDatabase();\n      }\n      return n;\n    },\n    async close() {\n      if (hibernationTimer !== undefined) clock.clearTimeout(hibernationTimer);\n      closed = true;\n      wakesStopped = true;\n      if (wakeTimer !== undefined) clock.clearTimeout(wakeTimer);\n      alarms.stop();\n      clock.clearTimeout(timer);\n      timer = undefined;\n      await backupAll(\"close\");\n      // The releases reach the store before it closes.\n      await Promise.all([...hosts.values()].map((h) => h.close()));\n      hosts.clear();\n      alarms.close(); // every database of the runtime is closed now\n      await storage.close?.();\n    },\n    async fetch(req) {\n      const handler = opts.worker.default?.fetch;\n      if (!handler) return new Response(\"Worker has no fetch handler\", { status: 500 });\n      const ctx = {\n        waitUntil,\n        passThroughOnException() {},\n        exports: exportsObj,\n      } as ExecutionContext;\n      // celld's ingress: an inbound request has a `cf` object (no edge fields).\n      if ((req as { cf?: unknown }).cf === undefined)\n        Object.defineProperty(req, \"cf\", { value: {}, enumerable: true });\n      try {\n        const r = await rejections(() => handler.call(opts.worker.default, req, env, ctx));\n        // A non-Response is sent as text (celld), not a failure.\n        return r instanceof Response ? r : new Response(String(r));\n      } catch (e) {\n        const err = e as Error;\n        return new Response(\n          `Worker failed: rejected: ${err?.name ?? \"Error\"}: ${err?.message ?? String(e)}`,\n          {\n            status: 500,\n            headers: { \"content-type\": \"application/json\" },\n          },\n        );\n      }\n    },\n    runEvent: (fn) => rejections(fn),\n    evictAll() {\n      for (const h of hosts.values()) h.close();\n      hosts.clear();\n    },\n    async drain() {\n      while (background.size) await Promise.all([...background]);\n    },\n    waitUntil,\n  };\n  return runtime;\n}\n\n/** The error (or its cause chain) says another node owns the cell. */\nexport function isOwnedElsewhere(e: unknown): boolean {\n  for (\n    let x = e as { name?: string; cause?: unknown } | undefined, i = 0;\n    x && i < 5;\n    x = x.cause as never, i++\n  )\n    if (x.name === \"CellOwnedElsewhereError\") return true;\n  return false;\n}\n"]}

package/dist/core/shard.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Fixed sharding of cells: a cell lives in shard `shardOf(id, n)` for the
+ * lifetime of the deployment. A shard is the unit of ownership (one Web Lock /
+ * lease), of storage (one opfs-sahpool — pools are exclusive per worker) and of
+ * placement (one worker). Changing `n` requires migration.
+ */
+export declare function shardOf(idHex: string, shards: number): number;

package/dist/core/shard.js

@@ -0,0 +1,10 @@
+/**
+ * Fixed sharding of cells: a cell lives in shard `shardOf(id, n)` for the
+ * lifetime of the deployment. A shard is the unit of ownership (one Web Lock /
+ * lease), of storage (one opfs-sahpool — pools are exclusive per worker) and of
+ * placement (one worker). Changing `n` requires migration.
+ */
+export function shardOf(idHex, shards) {
+    return parseInt(idHex.slice(0, 8), 16) % shards;
+}
+//# sourceMappingURL=shard.js.map

package/dist/core/shard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shard.js","sourceRoot":"","sources":["../../src/core/shard.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,MAAc;IACnD,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC;AAClD,CAAC","sourcesContent":["/**\n * Fixed sharding of cells: a cell lives in shard `shardOf(id, n)` for the\n * lifetime of the deployment. A shard is the unit of ownership (one Web Lock /\n * lease), of storage (one opfs-sahpool — pools are exclusive per worker) and of\n * placement (one worker). Changing `n` requires migration.\n */\nexport function shardOf(idHex: string, shards: number): number {\n  return parseInt(idHex.slice(0, 8), 16) % shards;\n}\n"]}

package/dist/core/sql-split.d.ts

@@ -0,0 +1,15 @@
+/** Splits a param-less SQL script on top-level `;` (respects quotes, comments, triggers). */
+export declare function splitSqlStatements(sql: string): string[];
+/**
+ * The complete statements at the start of a chunk of SQL text (each ended by a top-level `;`,
+ * as `sqlite3_complete` sees it) and the text after the last of them, untouched.
+ */
+export declare function completeSqlStatements(sql: string): {
+    statements: string[];
+    remainder: string;
+};
+/**
+ * Whether `sql` holds no statement to run (workerd and celld: "SQL code did not contain a
+ * statement"): nothing but whitespace, comments and `;`, or a last statement of comments alone.
+ */
+export declare function lacksStatement(sql: string): boolean;

package/dist/core/sql-split.js

@@ -0,0 +1,101 @@
+/** A trigger's creation, also under EXPLAIN (`sql.ingest()` prepares each statement so). */
+const TRIGGER = /^\s*(?:EXPLAIN\s+)?CREATE\s+(?:TEMP\s+|TEMPORARY\s+)?TRIGGER\b/i;
+/**
+ * Whether a trigger's text so far ends its body: its `BEGIN` closed by an `END` that does not
+ * close a `CASE` (a body's statements may hold `CASE … END`, as in `SELECT CASE WHEN … THEN
+ * RAISE(ABORT, …) END;`). Quoted text and identifiers are left out of the count.
+ */
+function triggerEnded(text) {
+    const words = text
+        .replace(/'[^']*'|"[^"]*"|`[^`]*`|\[[^\]]*\]/g, " ")
+        .match(/\b(BEGIN|CASE|END)\b/gi);
+    if (!words)
+        return false;
+    let depth = 0;
+    let begun = false;
+    for (const w of words) {
+        const u = w.toUpperCase();
+        if (u === "BEGIN") {
+            begun = true;
+            depth++;
+        }
+        else if (u === "CASE")
+            depth++;
+        else
+            depth--;
+    }
+    return begun && depth <= 0 && /\bEND\s*$/i.test(text);
+}
+/**
+ * The statements of a SQL script ended by a top-level `;` (quotes, comments and trigger bodies
+ * respected), each without its comments, with the offset just past its `;`; then the text after
+ * the last one, with `end` undefined.
+ */
+function* scanSql(sql) {
+    let cur = "";
+    for (let i = 0; i < sql.length; i++) {
+        const c = sql[i];
+        if (c === "'" || c === '"' || c === "`") {
+            const end = sql.indexOf(c, i + 1);
+            const j = end < 0 ? sql.length : end;
+            cur += sql.slice(i, j + 1);
+            i = j;
+        }
+        else if (c === "-" && sql[i + 1] === "-") {
+            const end = sql.indexOf("\n", i);
+            i = end < 0 ? sql.length : end;
+        }
+        else if (c === "/" && sql[i + 1] === "*") {
+            const end = sql.indexOf("*/", i + 2);
+            i = end < 0 ? sql.length : end + 1;
+        }
+        else if (c === ";") {
+            // A trigger body (CREATE TRIGGER … BEGIN …; …; END) is one statement.
+            if (TRIGGER.test(cur) && !triggerEnded(cur)) {
+                cur += c;
+                continue;
+            }
+            yield { text: cur, end: i + 1 };
+            cur = "";
+        }
+        else
+            cur += c;
+    }
+    yield { text: cur };
+}
+/** Splits a param-less SQL script on top-level `;` (respects quotes, comments, triggers). */
+export function splitSqlStatements(sql) {
+    const out = [];
+    for (const { text } of scanSql(sql))
+        if (text.trim())
+            out.push(text.trim());
+    return out.length ? out : [sql];
+}
+/**
+ * The complete statements at the start of a chunk of SQL text (each ended by a top-level `;`,
+ * as `sqlite3_complete` sees it) and the text after the last of them, untouched.
+ */
+export function completeSqlStatements(sql) {
+    const statements = [];
+    let rest = 0;
+    for (const { text, end } of scanSql(sql)) {
+        if (end === undefined)
+            break;
+        if (text.trim())
+            statements.push(text.trim());
+        rest = end;
+    }
+    return { statements, remainder: sql.slice(rest) };
+}
+const COMMENTS = /--[^\n]*(\n|$)|\/\*[\s\S]*?(\*\/|$)/g;
+/**
+ * Whether `sql` holds no statement to run (workerd and celld: "SQL code did not contain a
+ * statement"): nothing but whitespace, comments and `;`, or a last statement of comments alone.
+ */
+export function lacksStatement(sql) {
+    if (sql.replace(COMMENTS, " ").replace(/;/g, " ").trim() === "")
+        return true;
+    const { remainder } = completeSqlStatements(sql);
+    return remainder.trim() !== "" && remainder.replace(COMMENTS, " ").trim() === "";
+}
+//# sourceMappingURL=sql-split.js.map

package/dist/core/sql-split.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-split.js","sourceRoot":"","sources":["../../src/core/sql-split.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,MAAM,OAAO,GAAG,iEAAiE,CAAC;AAElF;;;;GAIG;AACH,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,KAAK,GAAG,IAAI;SACf,OAAO,CAAC,qCAAqC,EAAE,GAAG,CAAC;SACnD,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;YAClB,KAAK,GAAG,IAAI,CAAC;YACb,KAAK,EAAE,CAAC;QACV,CAAC;aAAM,IAAI,CAAC,KAAK,MAAM;YAAE,KAAK,EAAE,CAAC;;YAC5B,KAAK,EAAE,CAAC;IACf,CAAC;IACD,OAAO,KAAK,IAAI,KAAK,IAAI,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAW;IAC3B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAClC,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;YACrC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3B,CAAC,GAAG,CAAC,CAAC;QACR,CAAC;aAAM,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAC3C,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACjC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;QACjC,CAAC;aAAM,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAC3C,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACrC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;QACrC,CAAC;aAAM,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YACrB,sEAAsE;YACtE,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC5C,GAAG,IAAI,CAAC,CAAC;gBACT,SAAS;YACX,CAAC;YACD,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,GAAG,GAAG,EAAE,CAAC;QACX,CAAC;;YAAM,GAAG,IAAI,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AACtB,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC;QAAE,IAAI,IAAI,CAAC,IAAI,EAAE;YAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5E,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,IAAI,GAAG,KAAK,SAAS;YAAE,MAAM;QAC7B,IAAI,IAAI,CAAC,IAAI,EAAE;YAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9C,IAAI,GAAG,GAAG,CAAC;IACb,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,QAAQ,GAAG,sCAAsC,CAAC;AAExD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7E,MAAM,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACjD,OAAO,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AACnF,CAAC","sourcesContent":["/** A trigger's creation, also under EXPLAIN (`sql.ingest()` prepares each statement so). */\nconst TRIGGER = /^\\s*(?:EXPLAIN\\s+)?CREATE\\s+(?:TEMP\\s+|TEMPORARY\\s+)?TRIGGER\\b/i;\n\n/**\n * Whether a trigger's text so far ends its body: its `BEGIN` closed by an `END` that does not\n * close a `CASE` (a body's statements may hold `CASE … END`, as in `SELECT CASE WHEN … THEN\n * RAISE(ABORT, …) END;`). Quoted text and identifiers are left out of the count.\n */\nfunction triggerEnded(text: string): boolean {\n  const words = text\n    .replace(/'[^']*'|\"[^\"]*\"|`[^`]*`|\\[[^\\]]*\\]/g, \" \")\n    .match(/\\b(BEGIN|CASE|END)\\b/gi);\n  if (!words) return false;\n  let depth = 0;\n  let begun = false;\n  for (const w of words) {\n    const u = w.toUpperCase();\n    if (u === \"BEGIN\") {\n      begun = true;\n      depth++;\n    } else if (u === \"CASE\") depth++;\n    else depth--;\n  }\n  return begun && depth <= 0 && /\\bEND\\s*$/i.test(text);\n}\n\n/**\n * The statements of a SQL script ended by a top-level `;` (quotes, comments and trigger bodies\n * respected), each without its comments, with the offset just past its `;`; then the text after\n * the last one, with `end` undefined.\n */\nfunction* scanSql(sql: string): Generator<{ text: string; end?: number }> {\n  let cur = \"\";\n  for (let i = 0; i < sql.length; i++) {\n    const c = sql[i];\n    if (c === \"'\" || c === '\"' || c === \"`\") {\n      const end = sql.indexOf(c, i + 1);\n      const j = end < 0 ? sql.length : end;\n      cur += sql.slice(i, j + 1);\n      i = j;\n    } else if (c === \"-\" && sql[i + 1] === \"-\") {\n      const end = sql.indexOf(\"\\n\", i);\n      i = end < 0 ? sql.length : end;\n    } else if (c === \"/\" && sql[i + 1] === \"*\") {\n      const end = sql.indexOf(\"*/\", i + 2);\n      i = end < 0 ? sql.length : end + 1;\n    } else if (c === \";\") {\n      // A trigger body (CREATE TRIGGER … BEGIN …; …; END) is one statement.\n      if (TRIGGER.test(cur) && !triggerEnded(cur)) {\n        cur += c;\n        continue;\n      }\n      yield { text: cur, end: i + 1 };\n      cur = \"\";\n    } else cur += c;\n  }\n  yield { text: cur };\n}\n\n/** Splits a param-less SQL script on top-level `;` (respects quotes, comments, triggers). */\nexport function splitSqlStatements(sql: string): string[] {\n  const out: string[] = [];\n  for (const { text } of scanSql(sql)) if (text.trim()) out.push(text.trim());\n  return out.length ? out : [sql];\n}\n\n/**\n * The complete statements at the start of a chunk of SQL text (each ended by a top-level `;`,\n * as `sqlite3_complete` sees it) and the text after the last of them, untouched.\n */\nexport function completeSqlStatements(sql: string): { statements: string[]; remainder: string } {\n  const statements: string[] = [];\n  let rest = 0;\n  for (const { text, end } of scanSql(sql)) {\n    if (end === undefined) break;\n    if (text.trim()) statements.push(text.trim());\n    rest = end;\n  }\n  return { statements, remainder: sql.slice(rest) };\n}\n\nconst COMMENTS = /--[^\\n]*(\\n|$)|\\/\\*[\\s\\S]*?(\\*\\/|$)/g;\n\n/**\n * Whether `sql` holds no statement to run (workerd and celld: \"SQL code did not contain a\n * statement\"): nothing but whitespace, comments and `;`, or a last statement of comments alone.\n */\nexport function lacksStatement(sql: string): boolean {\n  if (sql.replace(COMMENTS, \" \").replace(/;/g, \" \").trim() === \"\") return true;\n  const { remainder } = completeSqlStatements(sql);\n  return remainder.trim() !== \"\" && remainder.replace(COMMENTS, \" \").trim() === \"\";\n}\n"]}