@statewalker/cellb 0.0.0-stage → 0.1.1

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

@@ -0,0 +1,53 @@
+import type { CommitChanges, SqlResult, SyncSqlDriver } from "../ports.js";
+/** `ctx.storage.sql.exec()` cursor (iterable, one-shot like the CF one). */
+export declare class SqlStorageCursor<T = Record<string, unknown>> implements Iterable<T> {
+    #private;
+    readonly columnNames: string[];
+    readonly rowsRead: number;
+    readonly rowsWritten: number;
+    constructor(r: SqlResult);
+    next(): IteratorResult<T>;
+    [Symbol.iterator](): Iterator<T>;
+    toArray(): T[];
+    one(): T;
+    raw(): IterableIterator<unknown[]>;
+}
+export declare class SqlStorage {
+    #private;
+    constructor(driver: SyncSqlDriver, onCommit: (changes?: CommitChanges) => void, opts?: {
+        capture?: boolean;
+    });
+    exec<T = Record<string, unknown>>(query: string, ...bindings: unknown[]): SqlStorageCursor<T>;
+    /**
+     * workerd's `sql.prepare(query)`: a reusable statement, called with bindings.
+     * Not in Cloudflare's public docs, but used by Miniflare's simulator objects.
+     */
+    prepare<T = Record<string, unknown>>(query: string): (...bindings: unknown[]) => SqlStorageCursor<T>;
+    /**
+     * workerd's experimental `sql.ingest(text)`, for SQL that arrives in pieces: runs the complete
+     * statements at the start of `text` and returns the rest, to be prefixed to the next piece.
+     * As celld: errors read `prepare ingested SQL: …` (refused, or not valid SQL) or `step ingested
+     * SQL: …` (failed while running); statements before a failing one stay applied; `rowsWritten`
+     * includes trigger writes; there is no `rowsRead`.
+     */
+    ingest(text: string): {
+        remainder: string;
+        statementCount: number;
+        rowsWritten: number;
+    };
+    get databaseSize(): number;
+    /** Unguarded path for the runtime's own tables (_cf_KV, _cf_METADATA). */
+    internalExec(query: string, bindings?: unknown[]): SqlResult;
+    transactionSync<T>(fn: () => T): T;
+    /** Suspends auto-commit (used by the async `transaction()` which spans awaits). */
+    hold(): () => void;
+    /** True while an async transaction() holds auto-commit (no consistent snapshot possible). */
+    get held(): boolean;
+    /** Commits the implicit transaction now (no-op if none, or if held). */
+    commit(): void;
+    /** Called after a rollback (lazily created internal tables may be gone). */
+    readonly rolledBack: Set<() => void>;
+    rollback(): void;
+}
+/** Parameters a statement expects: anonymous `?` count, highest `?NNN`, distinct named ones. */
+export declare function countParameters(sql: string): number;

package/dist/core/sql-storage.js

@@ -0,0 +1,407 @@
+import { LOG_SEQ_READ, LOG_SEQ_WRITE, LOG_TABLE } from "./celld-schema.js";
+import { completeSqlStatements, lacksStatement } from "./sql-split.js";
+const FORBIDDEN_TXN = /^\s*(BEGIN|COMMIT|END|ROLLBACK|SAVEPOINT|RELEASE)\b/i;
+const FORBIDDEN_INTERNAL = /\b_cf_\w*/i;
+/** Creating or dropping an object with an internal name (any case): celld refuses it outright. */
+const FORBIDDEN_DDL = /^\s*(CREATE|DROP)\b[^(]*?\b_cf_/i;
+/**
+ * Runs `fn` after the current macrotask, as workerd commits an implicit transaction after the
+ * current turn of its event loop: the writes of every microtask until then share one commit.
+ * `setImmediate` on Node; a MessageChannel message in browsers (no timer clamping).
+ */
+const afterTurn = (() => {
+    const g = globalThis;
+    if (typeof g.setImmediate === "function")
+        return (fn) => void g.setImmediate(fn);
+    if (typeof MessageChannel === "function") {
+        const queue = [];
+        const channel = new MessageChannel();
+        channel.port1.onmessage = () => {
+            for (const f of queue.splice(0))
+                f();
+        };
+        return (fn) => {
+            if (queue.push(fn) === 1)
+                channel.port2.postMessage(null);
+        };
+    }
+    return (fn) => void setTimeout(fn, 0);
+})();
+/** The SQL text with string literals and comments blanked out (quoted identifiers stay). */
+function withoutLiterals(sql) {
+    return sql.replace(/'(?:[^']|'')*'|--[^\n]*|\/\*[\s\S]*?\*\//g, " ");
+}
+/**
+ * Why celld's authorizer refuses a statement at prepare time, or undefined: transaction
+ * statements and internal tables. Names inside string literals and comments are values, not
+ * tables: `WHERE callback = '_cf_x'` is allowed (the Agents SDK writes one).
+ */
+function refusal(query) {
+    const code = withoutLiterals(query);
+    if (FORBIDDEN_TXN.test(code) || FORBIDDEN_DDL.test(code))
+        return "not authorized";
+    const internal = FORBIDDEN_INTERNAL.exec(code);
+    if (!internal)
+        return undefined;
+    const table = internal[0];
+    // celld names the first column of its own internal schema (_cf_KV starts with `scope`).
+    return `access to ${table}.${table.toLowerCase() === "_cf_kv" ? "scope" : "key"} is prohibited`;
+}
+/** SQLite's own message, without the prefix SQLite WASM adds to it. */
+const sqliteMessage = (e) => String(e?.message ?? e).replace(/^SQLITE_\w+: sqlite3 result code \d+: /, "");
+/** `ctx.storage.sql.exec()` cursor (iterable, one-shot like the CF one). */
+export class SqlStorageCursor {
+    columnNames;
+    rowsRead;
+    rowsWritten;
+    #rows;
+    #pos = 0;
+    constructor(r) {
+        this.columnNames = r.columnNames;
+        this.#rows = r.rows;
+        this.rowsRead = r.rows.length;
+        this.rowsWritten = r.rowsWritten;
+    }
+    next() {
+        // As workerd: the final result has no `value` key ({ done: true }).
+        if (this.#pos >= this.#rows.length)
+            return { done: true };
+        return { done: false, value: this.#obj(this.#rows[this.#pos++]) };
+    }
+    [Symbol.iterator]() {
+        return this;
+    }
+    toArray() {
+        return [...this];
+    }
+    one() {
+        const rest = this.toArray();
+        if (rest.length !== 1)
+            throw new Error(`Expected exactly one result from SQL query, but got ${rest.length === 0 ? "no" : "multiple"} results`);
+        return rest[0];
+    }
+    *raw() {
+        while (this.#pos < this.#rows.length)
+            yield this.#rows[this.#pos++];
+    }
+    #obj(row) {
+        const o = {};
+        for (const [i, c] of this.columnNames.entries())
+            o[c] = row[i];
+        return o;
+    }
+}
+/**
+ * `ctx.storage.sql` with SQLite-backed-DO semantics: every write opens an
+ * IMPLICIT transaction that commits on the next microtask (i.e. when the
+ * handler yields). Sync writes therefore coalesce atomically, and the
+ * output gate only has to await durability of the commit.
+ */
+const DDL = /^\s*(CREATE|ALTER|DROP)\b/i;
+/** Errors after which SQLite may roll the whole transaction back by itself. */
+const ROLLS_BACK = /SQLITE_(IOERR|FULL|NOMEM|BUSY|INTERRUPT|CORRUPT)|disk I\/O error|database or disk is full|out of memory|interrupted/i;
+/** Statements that may write (a conservative test: WITH … and PRAGMAs count as writes). */
+const WRITES = /^\s*(INSERT|REPLACE|UPDATE|DELETE|CREATE|ALTER|DROP|WITH|PRAGMA)\b/i;
+const WRITE_TARGET = /^\s*(?:INSERT|REPLACE)(?:\s+OR\s+\w+)?\s+INTO\s+["`[]?([\w$]+)|^\s*UPDATE(?:\s+OR\s+\w+)?\s+["`[]?([\w$]+)|^\s*DELETE\s+FROM\s+["`[]?([\w$]+)/i;
+export class SqlStorage {
+    #driver;
+    #onCommit;
+    #inTxn = false;
+    /** The implicit transaction has written (its loss must fail the commit, not pass silently). */
+    #wrote = false;
+    /** Why SQLite rolled the implicit transaction back by itself (after an I/O error), if it did. */
+    #lost;
+    #holds = 0;
+    #depth = 0;
+    // Transaction-log capture (only when the durability port asks for it).
+    #capture;
+    #ddl = [];
+    #statements = [];
+    #noPk = new Map();
+    #changesAtBegin = 0;
+    #schemaAtBegin = 0;
+    #schemaVersion() {
+        return Number(this.#driver.exec("PRAGMA schema_version", []).rows[0]?.[0] ?? 0);
+    }
+    #totalChanges() {
+        return Number(this.#driver.exec("SELECT total_changes()", []).rows[0]?.[0] ?? 0);
+    }
+    constructor(driver, onCommit, opts = {}) {
+        this.#driver = driver;
+        this.#onCommit = onCommit;
+        this.#capture = !!opts.capture;
+        if (this.#capture && !driver.captureStart)
+            throw new Error("This SyncSqlDriver cannot capture changes: no transaction-log durability");
+    }
+    /** Records what the changeset cannot carry: schema changes, and writes to PK-less tables. */
+    #record(query, bindings) {
+        if (!this.#capture)
+            return;
+        if (DDL.test(query)) {
+            this.#ddl.push(query);
+            this.#noPk.clear();
+            return;
+        }
+        if (this.#driver.captureCoversRowidTables !== false)
+            return;
+        const m = WRITE_TARGET.exec(query);
+        const table = m?.[1] ?? m?.[2] ?? m?.[3];
+        if (table && this.#tableHasNoPk(table))
+            this.#statements.push([query, bindings]);
+    }
+    #tableHasNoPk(table) {
+        let v = this.#noPk.get(table);
+        if (v === undefined) {
+            const info = this.#driver.exec(`SELECT count(*) FROM pragma_table_info(?) WHERE pk > 0`, [
+                table,
+            ]);
+            v = Number(info.rows[0]?.[0] ?? 0) === 0;
+            this.#noPk.set(table, v);
+        }
+        return v;
+    }
+    exec(query, ...bindings) {
+        // Messages as celld words them (storage-details project).
+        const refused = refusal(query);
+        if (refused)
+            throw new Error(`SQL error: prepare SQL cursor: ${refused}`);
+        if (bindings.length && countParameters(query) !== bindings.length)
+            throw new Error("SQL error: Wrong number of parameter bindings for SQL query.");
+        // Statement after statement, as workerd and celld prepare them: none at all, or a last one
+        // of comments alone, is refused.
+        if (lacksStatement(query))
+            throw new Error("SQL code did not contain a statement.");
+        return new SqlStorageCursor(this.internalExec(query, bindings));
+    }
+    /**
+     * workerd's `sql.prepare(query)`: a reusable statement, called with bindings.
+     * Not in Cloudflare's public docs, but used by Miniflare's simulator objects.
+     */
+    prepare(query) {
+        return (...bindings) => this.exec(query, ...bindings);
+    }
+    /**
+     * workerd's experimental `sql.ingest(text)`, for SQL that arrives in pieces: runs the complete
+     * statements at the start of `text` and returns the rest, to be prefixed to the next piece.
+     * As celld: errors read `prepare ingested SQL: …` (refused, or not valid SQL) or `step ingested
+     * SQL: …` (failed while running); statements before a failing one stay applied; `rowsWritten`
+     * includes trigger writes; there is no `rowsRead`.
+     */
+    ingest(text) {
+        const { statements, remainder } = completeSqlStatements(String(text));
+        const before = this.#totalChanges();
+        for (const statement of statements) {
+            const refused = refusal(statement);
+            if (refused)
+                throw new Error(`SQL error: prepare ingested SQL: ${refused}`);
+            try {
+                this.#driver.exec(`EXPLAIN ${statement}`, []); // prepares it without running it
+            }
+            catch (e) {
+                throw new Error(`SQL error: prepare ingested SQL: ${sqliteMessage(e)}`);
+            }
+            try {
+                this.internalExec(statement);
+            }
+            catch (e) {
+                throw new Error(`SQL error: step ingested SQL: ${sqliteMessage(e)}`);
+            }
+        }
+        return {
+            remainder,
+            statementCount: statements.length,
+            rowsWritten: this.#totalChanges() - before,
+        };
+    }
+    get databaseSize() {
+        return this.#driver.databaseSize();
+    }
+    /** Unguarded path for the runtime's own tables (_cf_KV, _cf_METADATA). */
+    internalExec(query, bindings = []) {
+        this.#ensureTxn();
+        let r;
+        try {
+            r = this.#driver.exec(query, bindings);
+        }
+        catch (e) {
+            this.#afterFailure(e);
+            throw e;
+        }
+        if (!this.#wrote && WRITES.test(query))
+            this.#wrote = true;
+        this.#record(query, bindings);
+        return r;
+    }
+    /**
+     * After a failed statement: SQLite rolls the whole transaction back by itself on some errors
+     * (I/O, disk full, out of memory). A read-only transaction lost nothing: the statement's error
+     * fails the request, and the next one starts afresh. One that had written lost those writes:
+     * its commit fails with the cause (the object resets, as workerd's does).
+     */
+    #afterFailure(e) {
+        if (!this.#inTxn)
+            return;
+        const open = this.#driver.inTransaction?.();
+        if (open === true)
+            return; // only the statement failed
+        if (open === undefined) {
+            // No way to ask the driver: only errors after which SQLite rolls back are checked, with a
+            // statement (one that fails, and is logged by some builds, while the transaction is open).
+            if (!ROLLS_BACK.test(String(e?.message ?? e)))
+                return;
+            try {
+                this.#driver.exec("BEGIN", []); // succeeds only outside a transaction
+            }
+            catch {
+                return;
+            }
+            this.#driver.exec("ROLLBACK", []); // the probe's own transaction
+        }
+        const wrote = this.#wrote;
+        this.#inTxn = false;
+        this.#wrote = false;
+        this.#driver.discardDirtyPages?.();
+        for (const f of this.rolledBack)
+            f();
+        if (this.#capture) {
+            this.#driver.captureDiscard?.();
+            this.#ddl = [];
+            this.#statements = [];
+        }
+        if (wrote)
+            this.#lost = e;
+    }
+    transactionSync(fn) {
+        this.#ensureTxn();
+        const sp = `_cf_sp${++this.#depth}`;
+        this.#driver.exec(`SAVEPOINT ${sp}`, []);
+        const marks = [this.#ddl.length, this.#statements.length];
+        try {
+            const r = fn();
+            this.#driver.exec(`RELEASE ${sp}`, []);
+            return r;
+        }
+        catch (e) {
+            // SQLite rolled the whole transaction back by itself (#afterFailure): no savepoint left.
+            if (!this.#inTxn)
+                throw e;
+            this.#driver.exec(`ROLLBACK TO ${sp}`, []);
+            for (const f of this.rolledBack)
+                f();
+            this.#ddl.length = marks[0];
+            this.#statements.length = marks[1];
+            this.#driver.exec(`RELEASE ${sp}`, []);
+            throw e;
+        }
+        finally {
+            this.#depth--;
+        }
+    }
+    /** Suspends auto-commit (used by the async `transaction()` which spans awaits). */
+    hold() {
+        this.#holds++;
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            released = true;
+            if (--this.#holds === 0)
+                afterTurn(() => this.commit());
+        };
+    }
+    /** True while an async transaction() holds auto-commit (no consistent snapshot possible). */
+    get held() {
+        return this.#holds > 0;
+    }
+    /** Commits the implicit transaction now (no-op if none, or if held). */
+    commit() {
+        if (this.#lost !== undefined && this.#holds === 0) {
+            const cause = this.#lost;
+            this.#lost = undefined;
+            throw new Error(`the transaction's writes were rolled back after: ${sqliteMessage(cause)}`, {
+                cause,
+            });
+        }
+        if (!this.#inTxn || this.#holds > 0)
+            return;
+        let changes;
+        // Read-only transactions produce no log segment ("IF NOT EXISTS" DDL that changed
+        // nothing included: the schema version tells).
+        if (this.#capture && this.#ddl.length && this.#schemaVersion() === this.#schemaAtBegin)
+            this.#ddl = [];
+        if (this.#capture && (this.#ddl.length || this.#totalChanges() !== this.#changesAtBegin)) {
+            // The log sequence number lives in the database, inside the same transaction.
+            this.#driver.exec(LOG_TABLE, []);
+            const row = this.#driver.exec(LOG_SEQ_READ, []).rows[0];
+            const logSeq = Number(row?.[0] ?? 0) + 1;
+            this.#driver.exec(LOG_SEQ_WRITE, [logSeq]);
+            changes = {
+                logSeq,
+                ddl: this.#ddl,
+                changeset: new Uint8Array(),
+                statements: this.#statements,
+            };
+        }
+        this.#inTxn = false;
+        this.#wrote = false;
+        this.#driver.exec("COMMIT", []);
+        if (this.#capture) {
+            const changeset = this.#driver.captureTake();
+            if (changes)
+                changes.changeset = changeset;
+            this.#ddl = [];
+            this.#statements = [];
+        }
+        this.#onCommit(changes);
+    }
+    /** Called after a rollback (lazily created internal tables may be gone). */
+    rolledBack = new Set();
+    rollback() {
+        this.#lost = undefined;
+        if (!this.#inTxn)
+            return;
+        this.#inTxn = false;
+        this.#wrote = false;
+        this.#driver.exec("ROLLBACK", []);
+        this.#driver.discardDirtyPages?.(); // pages a rolled-back transaction spilled are not a commit
+        for (const f of this.rolledBack)
+            f();
+        if (this.#capture) {
+            this.#driver.captureDiscard?.();
+            this.#ddl = [];
+            this.#statements = [];
+        }
+    }
+    #ensureTxn() {
+        if (this.#inTxn)
+            return;
+        this.#driver.exec("BEGIN", []);
+        if (this.#capture) {
+            this.#driver.captureStart();
+            this.#changesAtBegin = this.#totalChanges();
+            this.#schemaAtBegin = this.#schemaVersion();
+        }
+        this.#inTxn = true;
+        afterTurn(() => this.commit());
+    }
+}
+/** Parameters a statement expects: anonymous `?` count, highest `?NNN`, distinct named ones. */
+export function countParameters(sql) {
+    let anon = 0;
+    let maxNumbered = 0;
+    const named = new Set();
+    const re = /'(?:[^']|'')*'|"(?:[^"]|"")*"|--[^\n]*|\/\*[\s\S]*?\*\/|\?(\d*)|([:@$][A-Za-z_]\w*)/g;
+    for (let m = re.exec(sql); m; m = re.exec(sql)) {
+        if (m[1] !== undefined) {
+            if (m[1] === "")
+                anon++;
+            else
+                maxNumbered = Math.max(maxNumbered, Number(m[1]));
+        }
+        else if (m[2])
+            named.add(m[2]);
+    }
+    const positional = maxNumbered ? Math.max(maxNumbered, anon) : anon;
+    return positional + named.size;
+}
+//# sourceMappingURL=sql-storage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sql-storage.js","sourceRoot":"","sources":["../../src/core/sql-storage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEvE,MAAM,aAAa,GAAG,sDAAsD,CAAC;AAC7E,MAAM,kBAAkB,GAAG,YAAY,CAAC;AACxC,kGAAkG;AAClG,MAAM,aAAa,GAAG,kCAAkC,CAAC;AAEzD;;;;GAIG;AACH,MAAM,SAAS,GAA6B,CAAC,GAAG,EAAE;IAChD,MAAM,CAAC,GAAG,UAA4D,CAAC;IACvE,IAAI,OAAO,CAAC,CAAC,YAAY,KAAK,UAAU;QAAE,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,YAAa,CAAC,EAAE,CAAC,CAAC;IAClF,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;QACzC,MAAM,KAAK,GAAmB,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC;QACrC,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,EAAE;YAC7B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;gBAAE,CAAC,EAAE,CAAC;QACvC,CAAC,CAAC;QACF,OAAO,CAAC,EAAE,EAAE,EAAE;YACZ,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC;gBAAE,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC5D,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC,CAAC,EAAE,CAAC;AAEL,4FAA4F;AAC5F,SAAS,eAAe,CAAC,GAAW;IAClC,OAAO,GAAG,CAAC,OAAO,CAAC,2CAA2C,EAAE,GAAG,CAAC,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,SAAS,OAAO,CAAC,KAAa;IAC5B,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,gBAAgB,CAAC;IAClF,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC1B,wFAAwF;IACxF,OAAO,aAAa,KAAK,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,gBAAgB,CAAC;AAClG,CAAC;AAED,uEAAuE;AACvE,MAAM,aAAa,GAAG,CAAC,CAAU,EAAE,EAAE,CACnC,MAAM,CAAE,CAAW,EAAE,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,wCAAwC,EAAE,EAAE,CAAC,CAAC;AAE3F,4EAA4E;AAC5E,MAAM,OAAO,gBAAgB;IAClB,WAAW,CAAW;IACtB,QAAQ,CAAS;IACjB,WAAW,CAAS;IAC7B,KAAK,CAAc;IACnB,IAAI,GAAG,CAAC,CAAC;IACT,YAAY,CAAY;QACtB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC;QACpB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QAC9B,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC;IACnC,CAAC;IACD,IAAI;QACF,oEAAoE;QACpE,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAqC,CAAC;QAC7F,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;IACpE,CAAC;IACD,CAAC,MAAM,CAAC,QAAQ,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,GAAG;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YACnB,MAAM,IAAI,KAAK,CACb,uDAAuD,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,UAAU,CACvG,CAAC;QACJ,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IACD,CAAC,GAAG;QACF,OAAO,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,CAAC,GAAc;QACjB,MAAM,CAAC,GAA4B,EAAE,CAAC;QACtC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE;YAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAC/D,OAAO,CAAM,CAAC;IAChB,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,GAAG,GAAG,4BAA4B,CAAC;AACzC,+EAA+E;AAC/E,MAAM,UAAU,GACd,sHAAsH,CAAC;AACzH,2FAA2F;AAC3F,MAAM,MAAM,GAAG,qEAAqE,CAAC;AACrF,MAAM,YAAY,GAChB,gJAAgJ,CAAC;AAEnJ,MAAM,OAAO,UAAU;IACrB,OAAO,CAAgB;IACvB,SAAS,CAAoC;IAC7C,MAAM,GAAG,KAAK,CAAC;IACf,+FAA+F;IAC/F,MAAM,GAAG,KAAK,CAAC;IACf,iGAAiG;IACjG,KAAK,CAAU;IACf,MAAM,GAAG,CAAC,CAAC;IACX,MAAM,GAAG,CAAC,CAAC;IACX,uEAAuE;IAC9D,QAAQ,CAAU;IAC3B,IAAI,GAAa,EAAE,CAAC;IACpB,WAAW,GAA0B,EAAE,CAAC;IAC/B,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC5C,eAAe,GAAG,CAAC,CAAC;IACpB,cAAc,GAAG,CAAC,CAAC;IACnB,cAAc;QACZ,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAClF,CAAC;IACD,aAAa;QACX,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,YACE,MAAqB,EACrB,QAA2C,EAC3C,IAAI,GAA0B,EAAE;QAEhC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QAC/B,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,YAAY;YACvC,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAChG,CAAC;IAED,6FAA6F;IAC7F,OAAO,CAAC,KAAa,EAAE,QAAmB;QACxC,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC3B,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,wBAAwB,KAAK,KAAK;YAAE,OAAO;QAC5D,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACzC,IAAI,KAAK,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,aAAa,CAAC,KAAa;QACzB,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,wDAAwD,EAAE;gBACvF,KAAK;aACN,CAAC,CAAC;YACH,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;YACzC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAA8B,KAAa,EAAE,GAAG,QAAmB;QACrE,0DAA0D;QAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;QAC1E,IAAI,QAAQ,CAAC,MAAM,IAAI,eAAe,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,MAAM;YAC/D,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAClF,2FAA2F;QAC3F,iCAAiC;QACjC,IAAI,cAAc,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QACpF,OAAO,IAAI,gBAAgB,CAAI,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrE,CAAC;IAED;;;OAGG;IACH,OAAO,CACL,KAAa;QAEb,OAAO,CAAC,GAAG,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAI,KAAK,EAAE,GAAG,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,IAAY;QACjB,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACpC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;YACnC,IAAI,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,OAAO,EAAE,CAAC,CAAC;YAC5E,IAAI,CAAC;gBACH,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,iCAAiC;YAClF,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,oCAAoC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC1E,CAAC;YACD,IAAI,CAAC;gBACH,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YAC/B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,iCAAiC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;QACD,OAAO;YACL,SAAS;YACT,cAAc,EAAE,UAAU,CAAC,MAAM;YACjC,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE,GAAG,MAAM;SAC3C,CAAC;IACJ,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;IACrC,CAAC;IAED,0EAA0E;IAC1E,YAAY,CAAC,KAAa,EAAE,QAAQ,GAAc,EAAE;QAClD,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAY,CAAC;QACjB,IAAI,CAAC;YACH,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,CAAC,CAAC;QACV,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QAC3D,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC9B,OAAO,CAAC,CAAC;IACX,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,CAAU;QACtB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;QAC5C,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,CAAC,4BAA4B;QACvD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,0FAA0F;YAC1F,2FAA2F;YAC3F,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAE,CAAW,EAAE,OAAO,IAAI,CAAC,CAAC,CAAC;gBAAE,OAAO;YACjE,IAAI,CAAC;gBACH,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,sCAAsC;YACxE,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;YACT,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,8BAA8B;QACnE,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC;QACnC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU;YAAE,CAAC,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACxB,CAAC;QACD,IAAI,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,eAAe,CAAI,EAAW;QAC5B,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,MAAM,EAAE,GAAG,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QACpC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAU,CAAC;QACnE,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YACvC,OAAO,CAAC,CAAC;QACX,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,yFAAyF;YACzF,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,MAAM,CAAC,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YAC3C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU;gBAAE,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACnC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YACvC,MAAM,CAAC,CAAC;QACV,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED,mFAAmF;IACnF,IAAI;QACF,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,OAAO,GAAG,EAAE;YACV,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,IAAI,EAAE,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1D,CAAC,CAAC;IACJ,CAAC;IAED,6FAA6F;IAC7F,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,wEAAwE;IACxE,MAAM;QACJ,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,oDAAoD,aAAa,CAAC,KAAK,CAAC,EAAE,EAAE;gBAC1F,KAAK;aACN,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO;QAC5C,IAAI,OAAkC,CAAC;QACvC,kFAAkF;QAClF,+CAA+C;QAC/C,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,cAAc,EAAE,KAAK,IAAI,CAAC,cAAc;YACpF,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;QACjB,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,aAAa,EAAE,KAAK,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;YACzF,8EAA8E;YAC9E,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YACjC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACxD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;YAC3C,OAAO,GAAG;gBACR,MAAM;gBACN,GAAG,EAAE,IAAI,CAAC,IAAI;gBACd,SAAS,EAAE,IAAI,UAAU,EAAE;gBAC3B,UAAU,EAAE,IAAI,CAAC,WAAW;aAC7B,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,WAAY,EAAE,CAAC;YAC9C,IAAI,OAAO;gBAAE,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;YAC3C,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,4EAA4E;IACnE,UAAU,GAAG,IAAI,GAAG,EAAc,CAAC;IAE5C,QAAQ;QACN,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,2DAA2D;QAC/F,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU;YAAE,CAAC,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED,UAAU;QACR,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,CAAC,YAAa,EAAE,CAAC;YAC7B,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YAC5C,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC,CAAC;CACF;AAED,gGAAgG;AAChG,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,EAAE,GAAG,sFAAsF,CAAC;IAClG,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE;gBAAE,IAAI,EAAE,CAAC;;gBACnB,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,CAAC;aAAM,IAAI,CAAC,CAAC,CAAC,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IACD,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,OAAO,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC;AACjC,CAAC","sourcesContent":["import type { CommitChanges, SqlResult, SyncSqlDriver } from \"../ports.js\";\nimport { LOG_SEQ_READ, LOG_SEQ_WRITE, LOG_TABLE } from \"./celld-schema.js\";\nimport { completeSqlStatements, lacksStatement } from \"./sql-split.js\";\n\nconst FORBIDDEN_TXN = /^\\s*(BEGIN|COMMIT|END|ROLLBACK|SAVEPOINT|RELEASE)\\b/i;\nconst FORBIDDEN_INTERNAL = /\\b_cf_\\w*/i;\n/** Creating or dropping an object with an internal name (any case): celld refuses it outright. */\nconst FORBIDDEN_DDL = /^\\s*(CREATE|DROP)\\b[^(]*?\\b_cf_/i;\n\n/**\n * Runs `fn` after the current macrotask, as workerd commits an implicit transaction after the\n * current turn of its event loop: the writes of every microtask until then share one commit.\n * `setImmediate` on Node; a MessageChannel message in browsers (no timer clamping).\n */\nconst afterTurn: (fn: () => void) => void = (() => {\n  const g = globalThis as { setImmediate?: (fn: () => void) => unknown };\n  if (typeof g.setImmediate === \"function\") return (fn) => void g.setImmediate!(fn);\n  if (typeof MessageChannel === \"function\") {\n    const queue: (() => void)[] = [];\n    const channel = new MessageChannel();\n    channel.port1.onmessage = () => {\n      for (const f of queue.splice(0)) f();\n    };\n    return (fn) => {\n      if (queue.push(fn) === 1) channel.port2.postMessage(null);\n    };\n  }\n  return (fn) => void setTimeout(fn, 0);\n})();\n\n/** The SQL text with string literals and comments blanked out (quoted identifiers stay). */\nfunction withoutLiterals(sql: string): string {\n  return sql.replace(/'(?:[^']|'')*'|--[^\\n]*|\\/\\*[\\s\\S]*?\\*\\//g, \" \");\n}\n\n/**\n * Why celld's authorizer refuses a statement at prepare time, or undefined: transaction\n * statements and internal tables. Names inside string literals and comments are values, not\n * tables: `WHERE callback = '_cf_x'` is allowed (the Agents SDK writes one).\n */\nfunction refusal(query: string): string | undefined {\n  const code = withoutLiterals(query);\n  if (FORBIDDEN_TXN.test(code) || FORBIDDEN_DDL.test(code)) return \"not authorized\";\n  const internal = FORBIDDEN_INTERNAL.exec(code);\n  if (!internal) return undefined;\n  const table = internal[0];\n  // celld names the first column of its own internal schema (_cf_KV starts with `scope`).\n  return `access to ${table}.${table.toLowerCase() === \"_cf_kv\" ? \"scope\" : \"key\"} is prohibited`;\n}\n\n/** SQLite's own message, without the prefix SQLite WASM adds to it. */\nconst sqliteMessage = (e: unknown) =>\n  String((e as Error)?.message ?? e).replace(/^SQLITE_\\w+: sqlite3 result code \\d+: /, \"\");\n\n/** `ctx.storage.sql.exec()` cursor (iterable, one-shot like the CF one). */\nexport class SqlStorageCursor<T = Record<string, unknown>> implements Iterable<T> {\n  readonly columnNames: string[];\n  readonly rowsRead: number;\n  readonly rowsWritten: number;\n  #rows: unknown[][];\n  #pos = 0;\n  constructor(r: SqlResult) {\n    this.columnNames = r.columnNames;\n    this.#rows = r.rows;\n    this.rowsRead = r.rows.length;\n    this.rowsWritten = r.rowsWritten;\n  }\n  next(): IteratorResult<T> {\n    // As workerd: the final result has no `value` key ({ done: true }).\n    if (this.#pos >= this.#rows.length) return { done: true } as IteratorReturnResult<undefined>;\n    return { done: false, value: this.#obj(this.#rows[this.#pos++]) };\n  }\n  [Symbol.iterator](): Iterator<T> {\n    return this;\n  }\n  toArray(): T[] {\n    return [...this];\n  }\n  one(): T {\n    const rest = this.toArray();\n    if (rest.length !== 1)\n      throw new Error(\n        `Expected exactly one result from SQL query, but got ${rest.length === 0 ? \"no\" : \"multiple\"} results`,\n      );\n    return rest[0];\n  }\n  *raw(): IterableIterator<unknown[]> {\n    while (this.#pos < this.#rows.length) yield this.#rows[this.#pos++];\n  }\n  #obj(row: unknown[]): T {\n    const o: Record<string, unknown> = {};\n    for (const [i, c] of this.columnNames.entries()) o[c] = row[i];\n    return o as T;\n  }\n}\n\n/**\n * `ctx.storage.sql` with SQLite-backed-DO semantics: every write opens an\n * IMPLICIT transaction that commits on the next microtask (i.e. when the\n * handler yields). Sync writes therefore coalesce atomically, and the\n * output gate only has to await durability of the commit.\n */\nconst DDL = /^\\s*(CREATE|ALTER|DROP)\\b/i;\n/** Errors after which SQLite may roll the whole transaction back by itself. */\nconst ROLLS_BACK =\n  /SQLITE_(IOERR|FULL|NOMEM|BUSY|INTERRUPT|CORRUPT)|disk I\\/O error|database or disk is full|out of memory|interrupted/i;\n/** Statements that may write (a conservative test: WITH … and PRAGMAs count as writes). */\nconst WRITES = /^\\s*(INSERT|REPLACE|UPDATE|DELETE|CREATE|ALTER|DROP|WITH|PRAGMA)\\b/i;\nconst WRITE_TARGET =\n  /^\\s*(?:INSERT|REPLACE)(?:\\s+OR\\s+\\w+)?\\s+INTO\\s+[\"`[]?([\\w$]+)|^\\s*UPDATE(?:\\s+OR\\s+\\w+)?\\s+[\"`[]?([\\w$]+)|^\\s*DELETE\\s+FROM\\s+[\"`[]?([\\w$]+)/i;\n\nexport class SqlStorage {\n  #driver: SyncSqlDriver;\n  #onCommit: (changes?: CommitChanges) => void;\n  #inTxn = false;\n  /** The implicit transaction has written (its loss must fail the commit, not pass silently). */\n  #wrote = false;\n  /** Why SQLite rolled the implicit transaction back by itself (after an I/O error), if it did. */\n  #lost: unknown;\n  #holds = 0;\n  #depth = 0;\n  // Transaction-log capture (only when the durability port asks for it).\n  readonly #capture: boolean;\n  #ddl: string[] = [];\n  #statements: [string, unknown[]][] = [];\n  readonly #noPk = new Map<string, boolean>();\n  #changesAtBegin = 0;\n  #schemaAtBegin = 0;\n  #schemaVersion(): number {\n    return Number(this.#driver.exec(\"PRAGMA schema_version\", []).rows[0]?.[0] ?? 0);\n  }\n  #totalChanges(): number {\n    return Number(this.#driver.exec(\"SELECT total_changes()\", []).rows[0]?.[0] ?? 0);\n  }\n\n  constructor(\n    driver: SyncSqlDriver,\n    onCommit: (changes?: CommitChanges) => void,\n    opts: { capture?: boolean } = {},\n  ) {\n    this.#driver = driver;\n    this.#onCommit = onCommit;\n    this.#capture = !!opts.capture;\n    if (this.#capture && !driver.captureStart)\n      throw new Error(\"This SyncSqlDriver cannot capture changes: no transaction-log durability\");\n  }\n\n  /** Records what the changeset cannot carry: schema changes, and writes to PK-less tables. */\n  #record(query: string, bindings: unknown[]): void {\n    if (!this.#capture) return;\n    if (DDL.test(query)) {\n      this.#ddl.push(query);\n      this.#noPk.clear();\n      return;\n    }\n    if (this.#driver.captureCoversRowidTables !== false) return;\n    const m = WRITE_TARGET.exec(query);\n    const table = m?.[1] ?? m?.[2] ?? m?.[3];\n    if (table && this.#tableHasNoPk(table)) this.#statements.push([query, bindings]);\n  }\n\n  #tableHasNoPk(table: string): boolean {\n    let v = this.#noPk.get(table);\n    if (v === undefined) {\n      const info = this.#driver.exec(`SELECT count(*) FROM pragma_table_info(?) WHERE pk > 0`, [\n        table,\n      ]);\n      v = Number(info.rows[0]?.[0] ?? 0) === 0;\n      this.#noPk.set(table, v);\n    }\n    return v;\n  }\n\n  exec<T = Record<string, unknown>>(query: string, ...bindings: unknown[]): SqlStorageCursor<T> {\n    // Messages as celld words them (storage-details project).\n    const refused = refusal(query);\n    if (refused) throw new Error(`SQL error: prepare SQL cursor: ${refused}`);\n    if (bindings.length && countParameters(query) !== bindings.length)\n      throw new Error(\"SQL error: Wrong number of parameter bindings for SQL query.\");\n    // Statement after statement, as workerd and celld prepare them: none at all, or a last one\n    // of comments alone, is refused.\n    if (lacksStatement(query)) throw new Error(\"SQL code did not contain a statement.\");\n    return new SqlStorageCursor<T>(this.internalExec(query, bindings));\n  }\n\n  /**\n   * workerd's `sql.prepare(query)`: a reusable statement, called with bindings.\n   * Not in Cloudflare's public docs, but used by Miniflare's simulator objects.\n   */\n  prepare<T = Record<string, unknown>>(\n    query: string,\n  ): (...bindings: unknown[]) => SqlStorageCursor<T> {\n    return (...bindings) => this.exec<T>(query, ...bindings);\n  }\n\n  /**\n   * workerd's experimental `sql.ingest(text)`, for SQL that arrives in pieces: runs the complete\n   * statements at the start of `text` and returns the rest, to be prefixed to the next piece.\n   * As celld: errors read `prepare ingested SQL: …` (refused, or not valid SQL) or `step ingested\n   * SQL: …` (failed while running); statements before a failing one stay applied; `rowsWritten`\n   * includes trigger writes; there is no `rowsRead`.\n   */\n  ingest(text: string): { remainder: string; statementCount: number; rowsWritten: number } {\n    const { statements, remainder } = completeSqlStatements(String(text));\n    const before = this.#totalChanges();\n    for (const statement of statements) {\n      const refused = refusal(statement);\n      if (refused) throw new Error(`SQL error: prepare ingested SQL: ${refused}`);\n      try {\n        this.#driver.exec(`EXPLAIN ${statement}`, []); // prepares it without running it\n      } catch (e) {\n        throw new Error(`SQL error: prepare ingested SQL: ${sqliteMessage(e)}`);\n      }\n      try {\n        this.internalExec(statement);\n      } catch (e) {\n        throw new Error(`SQL error: step ingested SQL: ${sqliteMessage(e)}`);\n      }\n    }\n    return {\n      remainder,\n      statementCount: statements.length,\n      rowsWritten: this.#totalChanges() - before,\n    };\n  }\n\n  get databaseSize(): number {\n    return this.#driver.databaseSize();\n  }\n\n  /** Unguarded path for the runtime's own tables (_cf_KV, _cf_METADATA). */\n  internalExec(query: string, bindings: unknown[] = []): SqlResult {\n    this.#ensureTxn();\n    let r: SqlResult;\n    try {\n      r = this.#driver.exec(query, bindings);\n    } catch (e) {\n      this.#afterFailure(e);\n      throw e;\n    }\n    if (!this.#wrote && WRITES.test(query)) this.#wrote = true;\n    this.#record(query, bindings);\n    return r;\n  }\n\n  /**\n   * After a failed statement: SQLite rolls the whole transaction back by itself on some errors\n   * (I/O, disk full, out of memory). A read-only transaction lost nothing: the statement's error\n   * fails the request, and the next one starts afresh. One that had written lost those writes:\n   * its commit fails with the cause (the object resets, as workerd's does).\n   */\n  #afterFailure(e: unknown): void {\n    if (!this.#inTxn) return;\n    const open = this.#driver.inTransaction?.();\n    if (open === true) return; // only the statement failed\n    if (open === undefined) {\n      // No way to ask the driver: only errors after which SQLite rolls back are checked, with a\n      // statement (one that fails, and is logged by some builds, while the transaction is open).\n      if (!ROLLS_BACK.test(String((e as Error)?.message ?? e))) return;\n      try {\n        this.#driver.exec(\"BEGIN\", []); // succeeds only outside a transaction\n      } catch {\n        return;\n      }\n      this.#driver.exec(\"ROLLBACK\", []); // the probe's own transaction\n    }\n    const wrote = this.#wrote;\n    this.#inTxn = false;\n    this.#wrote = false;\n    this.#driver.discardDirtyPages?.();\n    for (const f of this.rolledBack) f();\n    if (this.#capture) {\n      this.#driver.captureDiscard?.();\n      this.#ddl = [];\n      this.#statements = [];\n    }\n    if (wrote) this.#lost = e;\n  }\n\n  transactionSync<T>(fn: () => T): T {\n    this.#ensureTxn();\n    const sp = `_cf_sp${++this.#depth}`;\n    this.#driver.exec(`SAVEPOINT ${sp}`, []);\n    const marks = [this.#ddl.length, this.#statements.length] as const;\n    try {\n      const r = fn();\n      this.#driver.exec(`RELEASE ${sp}`, []);\n      return r;\n    } catch (e) {\n      // SQLite rolled the whole transaction back by itself (#afterFailure): no savepoint left.\n      if (!this.#inTxn) throw e;\n      this.#driver.exec(`ROLLBACK TO ${sp}`, []);\n      for (const f of this.rolledBack) f();\n      this.#ddl.length = marks[0];\n      this.#statements.length = marks[1];\n      this.#driver.exec(`RELEASE ${sp}`, []);\n      throw e;\n    } finally {\n      this.#depth--;\n    }\n  }\n\n  /** Suspends auto-commit (used by the async `transaction()` which spans awaits). */\n  hold(): () => void {\n    this.#holds++;\n    let released = false;\n    return () => {\n      if (released) return;\n      released = true;\n      if (--this.#holds === 0) afterTurn(() => this.commit());\n    };\n  }\n\n  /** True while an async transaction() holds auto-commit (no consistent snapshot possible). */\n  get held(): boolean {\n    return this.#holds > 0;\n  }\n\n  /** Commits the implicit transaction now (no-op if none, or if held). */\n  commit(): void {\n    if (this.#lost !== undefined && this.#holds === 0) {\n      const cause = this.#lost;\n      this.#lost = undefined;\n      throw new Error(`the transaction's writes were rolled back after: ${sqliteMessage(cause)}`, {\n        cause,\n      });\n    }\n    if (!this.#inTxn || this.#holds > 0) return;\n    let changes: CommitChanges | undefined;\n    // Read-only transactions produce no log segment (\"IF NOT EXISTS\" DDL that changed\n    // nothing included: the schema version tells).\n    if (this.#capture && this.#ddl.length && this.#schemaVersion() === this.#schemaAtBegin)\n      this.#ddl = [];\n    if (this.#capture && (this.#ddl.length || this.#totalChanges() !== this.#changesAtBegin)) {\n      // The log sequence number lives in the database, inside the same transaction.\n      this.#driver.exec(LOG_TABLE, []);\n      const row = this.#driver.exec(LOG_SEQ_READ, []).rows[0];\n      const logSeq = Number(row?.[0] ?? 0) + 1;\n      this.#driver.exec(LOG_SEQ_WRITE, [logSeq]);\n      changes = {\n        logSeq,\n        ddl: this.#ddl,\n        changeset: new Uint8Array(),\n        statements: this.#statements,\n      };\n    }\n    this.#inTxn = false;\n    this.#wrote = false;\n    this.#driver.exec(\"COMMIT\", []);\n    if (this.#capture) {\n      const changeset = this.#driver.captureTake!();\n      if (changes) changes.changeset = changeset;\n      this.#ddl = [];\n      this.#statements = [];\n    }\n    this.#onCommit(changes);\n  }\n\n  /** Called after a rollback (lazily created internal tables may be gone). */\n  readonly rolledBack = new Set<() => void>();\n\n  rollback(): void {\n    this.#lost = undefined;\n    if (!this.#inTxn) return;\n    this.#inTxn = false;\n    this.#wrote = false;\n    this.#driver.exec(\"ROLLBACK\", []);\n    this.#driver.discardDirtyPages?.(); // pages a rolled-back transaction spilled are not a commit\n    for (const f of this.rolledBack) f();\n    if (this.#capture) {\n      this.#driver.captureDiscard?.();\n      this.#ddl = [];\n      this.#statements = [];\n    }\n  }\n\n  #ensureTxn(): void {\n    if (this.#inTxn) return;\n    this.#driver.exec(\"BEGIN\", []);\n    if (this.#capture) {\n      this.#driver.captureStart!();\n      this.#changesAtBegin = this.#totalChanges();\n      this.#schemaAtBegin = this.#schemaVersion();\n    }\n    this.#inTxn = true;\n    afterTurn(() => this.commit());\n  }\n}\n\n/** Parameters a statement expects: anonymous `?` count, highest `?NNN`, distinct named ones. */\nexport function countParameters(sql: string): number {\n  let anon = 0;\n  let maxNumbered = 0;\n  const named = new Set<string>();\n  const re = /'(?:[^']|'')*'|\"(?:[^\"]|\"\")*\"|--[^\\n]*|\\/\\*[\\s\\S]*?\\*\\/|\\?(\\d*)|([:@$][A-Za-z_]\\w*)/g;\n  for (let m = re.exec(sql); m; m = re.exec(sql)) {\n    if (m[1] !== undefined) {\n      if (m[1] === \"\") anon++;\n      else maxNumbered = Math.max(maxNumbered, Number(m[1]));\n    } else if (m[2]) named.add(m[2]);\n  }\n  const positional = maxNumbered ? Math.max(maxNumbered, anon) : anon;\n  return positional + named.size;\n}\n"]}

package/dist/core/state.d.ts

@@ -0,0 +1,44 @@
+import type { InputGate } from "./gates.js";
+import type { DurableObjectId } from "./id.js";
+import type { DurableObjectStorage } from "./storage.js";
+/** `ctx` passed to a Durable Object constructor. */
+export declare class DurableObjectState {
+    #private;
+    /** Not readonly: an object woken by id alone gets its recorded name back (celld). */
+    id: DurableObjectId;
+    readonly storage: DurableObjectStorage;
+    constructor(id: DurableObjectId, storage: DurableObjectStorage, gate: InputGate, waitUntil: (p: Promise<unknown>) => void, onBlockFailure?: (e: unknown) => void);
+    /** No event is delivered to the object until `fn` settles. */
+    blockConcurrencyWhile<T>(fn: () => Promise<T>): Promise<T>;
+    waitUntil(p: Promise<unknown>): void;
+    /** `ctx.exports`: loopback handles of the Worker's exports (set by the host). */
+    exports: Record<string, unknown>;
+    /** `ctx.props`: what a facet's class handle was given as `{ props }` (set by the host). */
+    props: unknown;
+    /** `ctx.facets`: child objects with their own SQLite (set by the host). */
+    facets: {
+        get(name: string, start: () => unknown): Record<string, any>;
+        abort(name: string, reason?: unknown): void;
+        delete(name: string): Promise<void>;
+    };
+    /** Set by the ObjectHost: delivers an event to the live instance. */
+    attachDispatcher(dispatch: (fn: (instance: any) => unknown) => Promise<unknown>): void;
+    acceptWebSocket(ws: WebSocketLike, tags?: string[]): void;
+    getWebSockets(tag?: string): WebSocketLike[];
+    getTags(ws: WebSocketLike): string[];
+    setWebSocketAutoResponse(pair?: {
+        request: string;
+        response: string;
+    }): void;
+    getWebSocketAutoResponse(): {
+        request: string;
+        response: string;
+    } | null;
+}
+/** The server end of a WebSocketPair, as seen by the hibernation API. */
+export interface WebSocketLike {
+    accept(): void;
+    send(data: string | ArrayBuffer | ArrayBufferView): void;
+    close(code?: number, reason?: string): void;
+    addEventListener(type: string, fn: (e: any) => void): void;
+}

package/dist/core/state.js

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