orez-lite 0.9.7

package/dist/cf-deploy/wrangler.js

@@ -0,0 +1,48 @@
+export const CLOUDFLARE_COMPATIBILITY_DATE = '2026-03-29';
+function record(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function stringArray(value) {
+    return Array.isArray(value)
+        ? value.filter((item) => typeof item === 'string')
+        : [];
+}
+/**
+ * Add the current Orez Lite Durable Object contract to a Wrangler config.
+ *
+ * The caller owns routes, assets, services, and every app-specific binding.
+ */
+export function configureCloudflareWorker(config) {
+    config.compatibility_date = CLOUDFLARE_COMPATIBILITY_DATE;
+    config.compatibility_flags = [
+        ...new Set([...stringArray(config.compatibility_flags), 'enable_request_signal']),
+    ];
+    const durableObjects = record(config.durable_objects) ?? {};
+    const bindings = Array.isArray(durableObjects.bindings)
+        ? durableObjects.bindings.filter((binding) => Boolean(record(binding)))
+        : [];
+    if (!bindings.some((binding) => binding.name === 'ZERO_SQL_DO' && binding.class_name === 'ZeroSqlDO')) {
+        bindings.push({ name: 'ZERO_SQL_DO', class_name: 'ZeroSqlDO' });
+    }
+    durableObjects.bindings = bindings;
+    config.durable_objects = durableObjects;
+    const migrations = Array.isArray(config.migrations)
+        ? config.migrations.filter((migration) => Boolean(record(migration)))
+        : [];
+    const hasZeroSqlMigration = migrations.some((migration) => stringArray(migration.new_sqlite_classes).includes('ZeroSqlDO'));
+    if (!hasZeroSqlMigration) {
+        const tags = new Set(migrations
+            .map((migration) => migration.tag)
+            .filter((tag) => typeof tag === 'string'));
+        let tag = 'orez-lite-v1';
+        let suffix = 2;
+        while (tags.has(tag))
+            tag = `orez-lite-v${suffix++}`;
+        migrations.push({ tag, new_sqlite_classes: ['ZeroSqlDO'] });
+    }
+    config.migrations = migrations;
+    return config;
+}
+//# sourceMappingURL=wrangler.js.map

package/dist/cf-deploy/wrangler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrangler.js","sourceRoot":"","sources":["../../src/cf-deploy/wrangler.ts"],"names":[],"mappings":"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"}

package/dist/cf-do/application-sql.d.ts

@@ -0,0 +1,49 @@
+import type { CompiledTransactionQueryPlan, TransactionQueryBudget } from 'orez-sync-cf-host/transaction-query';
+import type { ExecResult, SqlStatementMetadata, TransactionQueryFormat } from 'orez-sync-executor';
+export type ApplicationSqlQueryCompiler = (ast: unknown, format: TransactionQueryFormat) => CompiledTransactionQueryPlan | Promise<CompiledTransactionQueryPlan>;
+export type ApplicationSqlTable = Pick<SqlStatementMetadata, 'table' | 'publicTable'> & {
+    /** capture rollback images without publishing this table to Zero clients */
+    publish?: boolean;
+};
+export type ApplicationSqlExecResult = ExecResult;
+export type ApplicationSqlTransaction = {
+    exec(sql: string, params?: readonly unknown[], metadata?: SqlStatementMetadata): Promise<ApplicationSqlExecResult>;
+    query<Row extends Record<string, unknown> = Record<string, unknown>>(sql: string, params?: readonly unknown[]): Promise<Row[]>;
+    queryAst<Result = unknown>(ast: unknown, format: TransactionQueryFormat, queryName?: string): Promise<Result>;
+    registerTables(tables: readonly ApplicationSqlTable[]): Promise<void>;
+};
+export type ApplicationSqlTransactionWork<Value> = (tx: ApplicationSqlTransaction) => Value | Promise<Value>;
+/**
+ * private durable object RPC protocol. the session capability is returned
+ * before it asks for ownership. waiting retries hold no durable object state,
+ * and a cancellation signal closes a queued session or rolls back an active
+ * session before rejecting work.
+ */
+export type ApplicationSqlSessionRpc = Disposable & {
+    begin(): Promise<boolean>;
+    query<Row extends Record<string, unknown> = Record<string, unknown>>(sql: string, params?: readonly unknown[]): Promise<Row[]>;
+    exec(sql: string, params?: readonly unknown[], metadata?: SqlStatementMetadata): Promise<ApplicationSqlExecResult>;
+    queryPlan<Result = unknown>(plan: CompiledTransactionQueryPlan, queryName?: string, queryBudget?: Partial<TransactionQueryBudget>): Promise<Result>;
+    registerTables(tables: readonly ApplicationSqlTable[]): Promise<void>;
+    commit(): Promise<void>;
+    rollback(): Promise<void>;
+};
+export type ApplicationSqlRpc = {
+    applicationSqlSession(sessionID: string): Promise<ApplicationSqlSessionRpc>;
+};
+export type ApplicationSqlDurableObjectNamespace = {
+    idFromName(name: string): unknown;
+    get(id: unknown): ApplicationSqlRpc;
+};
+export type ApplicationSqlClient = {
+    readonly namespace: string;
+    query<Row extends Record<string, unknown> = Record<string, unknown>>(sql: string, params?: readonly unknown[]): Promise<Row[]>;
+    exec(sql: string, params?: readonly unknown[], metadata?: SqlStatementMetadata): Promise<ApplicationSqlExecResult>;
+    registerTables(tables: readonly ApplicationSqlTable[]): Promise<void>;
+    transaction<Value>(compileQuery: ApplicationSqlQueryCompiler, work: ApplicationSqlTransactionWork<Value>, queryBudget?: Partial<TransactionQueryBudget>): Promise<Value>;
+};
+export type ApplicationSqlClientOptions = {
+    signal?: AbortSignal;
+};
+export declare function createApplicationSqlClient(durableObjects: ApplicationSqlDurableObjectNamespace, namespace: string, options?: ApplicationSqlClientOptions): ApplicationSqlClient;
+//# sourceMappingURL=application-sql.d.ts.map

package/dist/cf-do/application-sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-sql.d.ts","sourceRoot":"","sources":["../../src/cf-do/application-sql.ts"],"names":[],"mappings":"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"}

package/dist/cf-do/application-sql.js

@@ -0,0 +1,124 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+async function withApplicationSqlSession(target, signal, work) {
+    const env_1 = { stack: [], error: void 0, hasError: false };
+    try {
+        const session = __addDisposableResource(env_1, await target.applicationSqlSession(crypto.randomUUID()), false);
+        let rejectAbort;
+        const aborted = signal
+            ? new Promise((_resolve, reject) => {
+                rejectAbort = reject;
+            })
+            : undefined;
+        void aborted?.catch(() => { });
+        const abort = () => {
+            rejectAbort?.(signal?.reason ??
+                new DOMException('application SQLite request was canceled', 'AbortError'));
+        };
+        signal?.addEventListener('abort', abort, { once: true });
+        try {
+            signal?.throwIfAborted();
+            while (!(await session.begin())) {
+                await new Promise((resolve) => setTimeout(resolve, 25));
+                signal?.throwIfAborted();
+            }
+            const pendingWork = work(session);
+            const value = aborted
+                ? await Promise.race([Promise.resolve(pendingWork), aborted])
+                : await pendingWork;
+            signal?.throwIfAborted();
+            await session.commit();
+            return value;
+        }
+        catch (error) {
+            await session.rollback().catch(() => { });
+            throw error;
+        }
+        finally {
+            signal?.removeEventListener('abort', abort);
+        }
+    }
+    catch (e_1) {
+        env_1.error = e_1;
+        env_1.hasError = true;
+    }
+    finally {
+        __disposeResources(env_1);
+    }
+}
+export function createApplicationSqlClient(durableObjects, namespace, options = {}) {
+    if (!namespace)
+        throw new TypeError('application SQLite namespace is required');
+    const target = durableObjects.get(durableObjects.idFromName(namespace));
+    return {
+        namespace,
+        query: (sql, params = []) => withApplicationSqlSession(target, options.signal, (session) => session.query(sql, params)),
+        exec: (sql, params = [], metadata) => withApplicationSqlSession(target, options.signal, (session) => session.exec(sql, params, metadata)),
+        registerTables: (tables) => withApplicationSqlSession(target, options.signal, (session) => session.registerTables(tables)),
+        async transaction(compileQuery, work, queryBudget) {
+            return withApplicationSqlSession(target, options.signal, async (session) => {
+                const tx = {
+                    exec: (sql, params = [], metadata) => session.exec(sql, params, metadata),
+                    query: (sql, params = []) => session.query(sql, params),
+                    async queryAst(ast, format, queryName) {
+                        const plan = await compileQuery(ast, format);
+                        return session.queryPlan(plan, queryName, queryBudget);
+                    },
+                    registerTables: (tables) => session.registerTables(tables),
+                };
+                return work(tx);
+            });
+        },
+    };
+}
+//# sourceMappingURL=application-sql.js.map

package/dist/cf-do/application-sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-sql.js","sourceRoot":"","sources":["../../src/cf-do/application-sql.ts"],"names":[],"mappings":"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"}

package/dist/cf-do/cdc.d.ts

@@ -0,0 +1,155 @@
+import type { DurableSqlStorage } from './watermark.js';
+/** Bump whenever the generated trigger bodies or buffer shape change. */
+export declare const CDC_SCHEMA_VERSION = 2;
+export interface CdcTableRegistration {
+    /** Physical, flattened SQLite table name. */
+    physicalTableName: string;
+    /** Schema-qualified identity exposed in `_zero_changes`. */
+    tableName: string;
+    /** Optional known column list. The live SQLite schema remains authoritative. */
+    columns?: string[];
+    /** False captures before/after images for transaction rollback only. */
+    publish?: boolean;
+}
+/**
+ * A row image in storage-journal form: one tagged string per column, carrying
+ * the value's SQLite storage class and an exact, lossless payload. This is the
+ * undo encoding, deliberately separate from the Zero wire encoding that
+ * `journalToWire` derives.
+ */
+export type JournalRecord = Record<string, string>;
+export interface CapturedRowChange {
+    physicalTableName: string;
+    tableName: string;
+    op: 'INSERT' | 'UPDATE' | 'DELETE';
+    /** Zero wire image (JSON-safe; blobs as postgres bytea text). */
+    rowData: Record<string, unknown> | null;
+    oldData: Record<string, unknown> | null;
+    /** Lossless storage-journal image used only for undo. */
+    rowJournal: JournalRecord | null;
+    oldJournal: JournalRecord | null;
+    /** Exact decimal rowid text, or null for WITHOUT ROWID tables. */
+    newRowid: string | null;
+    oldRowid: string | null;
+    /** Omitted for normal published changes; false means rollback-only. */
+    publish?: boolean;
+}
+export interface SuspendedCdcTable {
+    physicalTableName: string;
+    tableName: string;
+    publish?: boolean;
+}
+/** Stable-identity and writability metadata read from the live SQLite schema. */
+export interface TableIdentity {
+    /** rowid alias usable in SQL, or null for a WITHOUT ROWID table. */
+    rowidAlias: string | null;
+    /** The INTEGER PRIMARY KEY column, which *is* the rowid, when one exists. */
+    rowidColumn: string | null;
+    /** Declared primary-key columns in key order. */
+    keyColumns: string[];
+    /** Columns undo may write. Excludes generated columns. */
+    writableColumns: string[];
+    /** Every column captured in a row image, generated columns included. */
+    columns: string[];
+}
+/**
+ * Rebuild the exact SQLite value for an undo statement. Integers and reals go
+ * back through CAST so the full int64 range and every double survive without
+ * depending on the driver's numeric binding.
+ */
+export declare function journalValueSqlBinding(encoded: string): {
+    expr: string;
+    params: unknown[];
+};
+export declare function parseJournalRecord(value: unknown): JournalRecord | null;
+/**
+ * Read stable-identity metadata from the live schema. Returns null when the
+ * table cannot be undone row-by-row (no rowid and no primary key), which keeps
+ * capture off it entirely so the caller falls back to table snapshots.
+ */
+export declare function tableIdentity(sql: DurableSqlStorage, table: string): TableIdentity | null;
+export interface TriggerDefinition {
+    name: string;
+    sql: string;
+}
+/**
+ * Drop every trigger on these tables and return their definitions.
+ *
+ * A restore must not fire the table's own business triggers. Undoing an INSERT
+ * with a DELETE would run its AFTER DELETE trigger and write side effects the
+ * original transaction never made, and if that side effect lands on a captured
+ * table, its CDC trigger stages a phantom change on top. Dropping only the
+ * generated CDC triggers leaves both holes open, so every trigger goes.
+ */
+export declare function suspendTriggers(sql: DurableSqlStorage, tables: Iterable<string>): TriggerDefinition[];
+/** Recreate triggers suspended for a restore, verbatim. */
+export declare function restoreTriggers(sql: DurableSqlStorage, triggers: TriggerDefinition[]): void;
+/** The columns a restore is allowed to write. Empty when the table is gone. */
+export declare function writableColumns(sql: DurableSqlStorage, table: string): string[];
+/**
+ * Return physical tables whose SQLite schema may be changed by this statement.
+ * The DO compiler emits one SQLite DDL statement at a time and quotes physical
+ * names, but accepting every SQLite identifier form also covers direct /exec
+ * callers and keeps CDC independent of the compiler.
+ */
+export declare function schemaChangeTargets(sql: string): string[];
+/**
+ * Transactional logical-row capture for the authoritative SQLite database.
+ *
+ * Generated AFTER triggers write full before/after row images to a staging
+ * table in the same SQLite statement as the application write. The owner
+ * drains that staging table before its storage transaction returns and moves
+ * the rows to either `_zero_changes` or `_zero_pending_changes`. Consequently
+ * a failed statement or storage transaction cannot leave an orphaned change.
+ *
+ * Every mutator of the in-memory registration cache runs inside the owner's
+ * storage transaction, so the cache can outlive an abort that rolled its SQLite
+ * side back. `reload()` re-derives the whole cache from SQLite and MUST be
+ * called on any aborted transaction; see `atomically` in worker.ts.
+ */
+export declare class TransactionalCdc {
+    #private;
+    private readonly sql;
+    constructor(sql: DurableSqlStorage);
+    get active(): boolean;
+    /** Force the next per-table ensure to re-read SQLite's live schema. */
+    invalidateSchema(): void;
+    /**
+     * Re-derive every cached decision from SQLite. Called after an aborted
+     * storage transaction, where SQLite rolled back the trigger and metadata
+     * writes but this object still remembers making them. Without it a table can
+     * stay "registered and verified" in memory with no trigger on disk, and every
+     * later write to it is silently uncaptured.
+     */
+    reload(): void;
+    private loadRegistrations;
+    private ensureTables;
+    private tableExists;
+    private triggersExist;
+    private registered;
+    capturesTable(tableName: string): boolean;
+    /** True when a DDL statement must atomically suspend and rebuild CDC triggers. */
+    capturesSchemaChange(sql: string): boolean;
+    private dropTriggers;
+    /**
+     * Drop generated triggers before SQLite rewrites a captured table. SQLite
+     * refuses DROP/RENAME COLUMN while any trigger still references the old row
+     * shape. The caller must run this, the DDL, and finishSchemaChange in one
+     * storage transaction so capture is never observably disabled.
+     */
+    beginSchemaChange(sql: string): SuspendedCdcTable[];
+    /** Re-introspect changed tables and rebuild their triggers from the live shape. */
+    finishSchemaChange(suspended: SuspendedCdcTable[]): void;
+    private installTriggers;
+    /**
+     * Ensure one table is captured. Returns false when the table does not exist
+     * or cannot be undone row-by-row, which leaves the caller on its table
+     * snapshot path rather than capturing changes it could never roll back.
+     */
+    ensureTable(registration: CdcTableRegistration, refresh?: boolean): boolean;
+    /** Replace the captured-table set with the caller's authoritative list. */
+    syncTables(registrations: CdcTableRegistration[]): void;
+    /** Drain all changes captured by the just-completed SQLite statement. */
+    drain(): CapturedRowChange[];
+}
+//# sourceMappingURL=cdc.d.ts.map

package/dist/cf-do/cdc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdc.d.ts","sourceRoot":"","sources":["../../src/cf-do/cdc.ts"],"names":[],"mappings":"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"}