@gonvex/local-runtime 0.5.2-staging.11

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,58 @@
+# Local Reducer execution
+
+The generated Gonvex client executes an interactive Reducer's existing TypeScript
+body in a browser worker. Applications define argument/result schemas and `run`;
+they do not maintain a separate optimistic handler or effects list.
+
+The CLI compiles a local SQL schema from tenant migrations and bundles the public
+Reducer exports. Unused Action declarations are removed from that bundle. The
+worker uses PGlite as disposable execution memory, seeded from the SDK Local
+Replica. It does not persist another database or become a second source of server
+state. It captures typed database writes and SQL write CTEs as one transaction.
+Both seed rows and writes are rolled back after execution.
+
+The client persists the intent, arguments, command ID, artifact hash and local
+transaction in its existing durable outbox before publishing the predicted rows.
+A successful local call returns the Reducer's result without waiting for a server.
+On reconnect the SDK sends the same intent and idempotency key. The Rust runtime
+executes the Reducer in an authoritative PostgreSQL transaction, checking the
+artifact and current permissions. A retry of an already committed command returns
+its stored result and commit barrier. It does not execute the write twice.
+
+A server rejection removes the command's entire prediction and recomputes later
+pending intents against the remaining base. The SDK publishes that replacement
+atomically and emits `onReducerRejection`. Transport failures retain the intent.
+The queue and cached session are partitioned by project, tenant and account.
+
+Generated replica subscriptions reuse the declared visibility plans and only
+columns already exposed by application reads. The runtime refuses to interpret
+an incomplete collection or an omitted column as an empty/NULL value. A known
+primary-key row can be read from a partial large collection. If required input is
+unavailable, the intent remains queued without a guessed result or transaction.
+First-time authentication and data never downloaded cannot be fabricated offline.
+
+Database inserts use the same intent-owned ID allocator in the server module and
+the local module. Explicit IDs remain supported. Action and scheduler calls are
+recorded locally but only the authoritative server commits and executes their
+outbox work. The worker denies ambient network access after loading its WASM.
+Server timestamps, constraints, hidden data and concurrent writes remain
+server-authoritative and reconcile through the change feed.
+
+The default host targets browser workers. Other hosts can implement the exported
+`LocalExecutor` interface; this package does not claim a native PGlite host.
+The IndexedDB and Expo SQLite adapters both persist SDK session metadata.
+
+## Verification
+
+```sh
+pnpm --filter @gonvex/local-runtime test
+pnpm --filter @gonvex/client test
+pnpm --filter @gonvex/module-sdk test
+pnpm --filter @gonvex/cli test
+```
+
+Host tests cover atomic writes, SQL CTE capture, incomplete reads, ordered replay,
+stable IDs, validation and scope isolation. Client tests cover durable admission,
+restart, server rejection, dependent edits, concurrent admission, lost responses,
+account switching and argument capture. CLI tests cover generated execution and
+ensure unexposed columns and unused external Actions do not enter local delivery.

package/dist/index.d.ts

@@ -0,0 +1,105 @@
+import type { JsonObject, JsonValue, ReducerContext, ReducerDefinition } from "@gonvex/module-sdk";
+import type { LocalSchema } from "./schema.js";
+export type { LocalSchema, LocalTableSchema, LocalColumn } from "./schema.js";
+/** Schema emitted by code generation, never inferred from possibly empty rows. */
+export type LocalColumnType = "text" | "boolean" | "bigint" | "integer" | "double precision" | "jsonb" | "uuid";
+export type LocalTables = Readonly<Record<string, Readonly<Record<string, LocalColumnType>>>>;
+export type LocalSnapshot = {
+    scope: string;
+    tables: Record<string, {
+        complete: boolean;
+        rows: JsonObject[];
+        columns?: readonly string[];
+    }>;
+};
+export type LocalExecution = {
+    scope: string;
+    commandId: string;
+    intentEntropy?: string;
+    now: number;
+    artifactHash: string;
+    identity: Pick<ReducerContext, "auth" | "tenant" | "member">;
+};
+export type LocalPatch = {
+    entity: string;
+    rowId: string;
+    op: "patch" | "insert";
+    fields: JsonObject;
+} | {
+    entity: string;
+    rowId: string;
+    op: "delete";
+};
+export type DeferredWork = {
+    id: string;
+    kind: "action";
+    path: string;
+    args: JsonValue;
+} | {
+    id: string;
+    kind: "schedule";
+    path: string;
+    args: JsonValue;
+    at: number;
+};
+export type LocalTransactionResult = {
+    result: JsonValue;
+    patches: LocalPatch[];
+    deferred: DeferredWork[];
+    readTables: string[];
+};
+export type LocalRuntimeOptions = {
+    tables?: LocalTables;
+    schema?: LocalSchema;
+    reducers: Readonly<Record<string, ReducerDefinition<any, any>>>;
+    artifactHash: string;
+};
+/** Persist these envelopes in the SDK outbox, never application state. */
+export type LocalIntent = {
+    path: string;
+    args: JsonValue;
+    execution: LocalExecution;
+};
+export type LocalReplay = {
+    transactions: {
+        commandId: string;
+        transaction: LocalTransactionResult;
+    }[];
+    rejected: {
+        commandId: string;
+        error: Error;
+    }[];
+};
+export declare class IncompleteReplicaError extends Error {
+    readonly table: string;
+    constructor(table: string);
+}
+/**
+ * Executes an existing module reducer against an isolated PostgreSQL workspace.
+ * This database is disposable execution memory, never a second durable cache.
+ * The caller supplies one immutable Local Replica snapshot. Only a successful
+ * execution returns a transaction for the SDK's existing outbox/overlay path.
+ */
+export declare class LocalReducerRuntime {
+    private readonly options;
+    private readonly schema;
+    private readonly database;
+    private readonly ready;
+    private tail;
+    private closed;
+    constructor(options: LocalRuntimeOptions);
+    initializeReady(): Promise<void>;
+    execute(path: string, args: JsonValue, snapshot: LocalSnapshot, execution: LocalExecution): Promise<LocalTransactionResult>;
+    /**
+     * Rebuild pending transactions in intent order after hydration or a changed
+     * authoritative base. Failed intent contributes no rows to later execution.
+     * The SDK publishes the returned overlays together, after replay completes.
+     */
+    replay(snapshot: LocalSnapshot, intents: readonly LocalIntent[]): Promise<LocalReplay>;
+    close(): Promise<void>;
+    private initialize;
+    private run;
+    private insertRow;
+}
+/** Stable per-intent IDs. The server host must use the identical seed contract. */
+export declare function deterministicId(scope: string, commandId: string, kind: string, ordinal: number): Promise<string>;

package/dist/index.js

@@ -0,0 +1,382 @@
+import { validateValue } from "./validation.js";
+import { PGlite } from "@electric-sql/pglite";
+import { reducerRowId } from "@gonvex/module-sdk";
+export class IncompleteReplicaError extends Error {
+    table;
+    constructor(table) {
+        super(`Local replica for ${table} is incomplete; this reducer cannot decide from missing rows.`);
+        this.table = table;
+        this.name = "IncompleteReplicaError";
+    }
+}
+const quote = (identifier) => `"${identifier.replaceAll('"', '""')}"`;
+const columnTypes = new Set(["text", "boolean", "bigint", "integer", "double precision", "jsonb", "uuid"]);
+const clone = (value) => structuredClone(value);
+const parseInteger = (value) => {
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed))
+        throw new Error("Local reducer read an integer outside the JSON safe range");
+    return parsed;
+};
+const queryOptions = { parsers: { 20: parseInteger } };
+/**
+ * Executes an existing module reducer against an isolated PostgreSQL workspace.
+ * This database is disposable execution memory, never a second durable cache.
+ * The caller supplies one immutable Local Replica snapshot. Only a successful
+ * execution returns a transaction for the SDK's existing outbox/overlay path.
+ */
+export class LocalReducerRuntime {
+    options;
+    schema;
+    database = new PGlite();
+    ready;
+    tail = Promise.resolve();
+    closed = false;
+    constructor(options) {
+        this.options = options;
+        this.schema = clone(options.schema ?? Object.fromEntries(Object.entries(options.tables ?? {}).map(([table, columns]) => [table, {
+                key: "_id", columns: Object.fromEntries(Object.entries(columns).map(([name, type]) => [name, { type, nullable: name !== "_id" }])),
+            }])));
+        this.ready = this.initialize();
+    }
+    async initializeReady() { await this.ready; }
+    execute(path, args, snapshot, execution) {
+        // Capture at admission: the caller may receive a new server transaction or
+        // switch tenants while another reducer awaits its database turn.
+        const input = clone({ args, snapshot, execution });
+        const job = this.tail.then(async () => {
+            if (this.closed)
+                throw new Error("Local reducer runtime is closed");
+            await this.ready;
+            return this.run(path, input.args, input.snapshot, input.execution);
+        });
+        this.tail = job.catch(() => undefined);
+        return job;
+    }
+    /**
+     * Rebuild pending transactions in intent order after hydration or a changed
+     * authoritative base. Failed intent contributes no rows to later execution.
+     * The SDK publishes the returned overlays together, after replay completes.
+     */
+    async replay(snapshot, intents) {
+        const working = clone(snapshot);
+        const queue = clone(intents);
+        const ids = new Set();
+        // These are journal integrity errors, not business rejections. Do not
+        // silently drop an intent belonging to another artifact or identity.
+        for (const intent of queue) {
+            if (intent.execution.scope !== working.scope)
+                throw new Error("Local reducer scope mismatch");
+            if (intent.execution.artifactHash !== this.options.artifactHash)
+                throw new Error("Local reducer artifact mismatch");
+            if (ids.has(intent.execution.commandId))
+                throw new Error("Duplicate local command id");
+            ids.add(intent.execution.commandId);
+        }
+        const transactions = [];
+        const rejected = [];
+        for (const intent of queue) {
+            let transaction;
+            try {
+                transaction = await this.execute(intent.path, intent.args, working, intent.execution);
+            }
+            catch (error) {
+                // A missing cache dependency must keep the journal pending. It is not
+                // evidence that the server will reject the business operation.
+                if (error instanceof IncompleteReplicaError)
+                    throw error;
+                rejected.push({ commandId: intent.execution.commandId, error: error instanceof Error ? error : new Error(String(error)) });
+                continue;
+            }
+            // Invariant failures in the transaction output abort the whole replay;
+            // they must never be downgraded to a user/business rejection.
+            for (const patch of transaction.patches) {
+                const table = working.tables[patch.entity] ??= { complete: false, rows: [] };
+                const key = this.schema[patch.entity]?.key ?? "_id";
+                const index = table.rows.findIndex((row) => (row[key] ?? row._id) === patch.rowId);
+                if (patch.op === "delete") {
+                    if (index >= 0)
+                        table.rows.splice(index, 1);
+                }
+                else if (patch.op === "insert") {
+                    if (index >= 0)
+                        throw new Error("Local replay insert refers to an existing row");
+                    table.rows.push(clone(patch.fields));
+                }
+                else {
+                    if (index < 0)
+                        throw new Error("Local replay patch refers to a missing row");
+                    table.rows[index] = { ...table.rows[index], ...clone(patch.fields) };
+                }
+            }
+            transactions.push({ commandId: intent.execution.commandId, transaction });
+        }
+        return { transactions, rejected };
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        await this.tail;
+        await this.ready.catch(() => undefined);
+        await this.database.close();
+    }
+    async initialize() {
+        for (const [table, definition] of Object.entries(this.schema)) {
+            const { columns, key } = definition;
+            if (!table || !columns[key])
+                throw new Error(`Local table ${table} requires its primary key column`);
+            const definitions = Object.entries(columns).map(([column, spec]) => {
+                // Types/defaults come only from the generated, build-time schema.
+                return `${quote(column)} ${spec.type}${column === key ? " PRIMARY KEY" : ""}${spec.default ? ` DEFAULT ${spec.default}` : ""}`;
+            });
+            await this.database.exec(`CREATE TABLE ${quote(table)} (${definitions.join(", ")})`);
+        }
+    }
+    async run(path, args, snapshot, execution) {
+        if (!execution.scope || execution.scope !== snapshot.scope)
+            throw new Error("Local reducer scope mismatch");
+        if (!execution.commandId || !Number.isSafeInteger(execution.now))
+            throw new Error("Invalid local execution envelope");
+        if (execution.artifactHash !== this.options.artifactHash)
+            throw new Error("Local reducer artifact mismatch");
+        const definition = this.options.reducers[path];
+        if (!definition || definition.kind !== "reducer" || definition.internal || !definition.handler) {
+            throw new Error(`No public local reducer registered for ${path}`);
+        }
+        validateValue(definition.options.args, args);
+        const patches = [];
+        const deferred = [];
+        const reads = new Set();
+        let ordinal = 0;
+        const deferredOrdinals = new Map();
+        const nextId = (kind) => deterministicId(execution.scope, execution.commandId, kind, ordinal++);
+        const requireTable = (table) => {
+            const definition = this.schema[table];
+            if (!definition)
+                throw new Error(`Unknown local table ${table}`);
+            return definition.columns;
+        };
+        const requireColumns = (table) => {
+            const columns = snapshot.tables[table]?.columns;
+            if (columns && Object.keys(requireTable(table)).some(column => !columns.includes(column)))
+                throw new IncompleteReplicaError(table);
+        };
+        const requireComplete = (table) => {
+            requireTable(table);
+            reads.add(table);
+            requireColumns(table);
+            if (!snapshot.tables[table]?.complete)
+                throw new IncompleteReplicaError(table);
+        };
+        return this.database.transaction(async (tx) => {
+            // Both the input rows and reducer writes are rolled back on success. The
+            // only published output is the returned transaction, applied by the SDK.
+            const seeded = new Set();
+            const seed = async (table) => {
+                requireTable(table);
+                if (seeded.has(table))
+                    return;
+                seeded.add(table);
+                for (const row of snapshot.tables[table]?.rows ?? [])
+                    await this.insertRow(tx, table, row, true);
+            };
+            const readRow = async (table, id) => {
+                requireTable(table);
+                reads.add(table);
+                requireColumns(table);
+                await seed(table);
+                const result = await tx.query(`SELECT * FROM ${quote(table)} WHERE ${quote(this.schema[table].key)} = $1`, [id], queryOptions);
+                if (!result.rows.length && !snapshot.tables[table]?.complete)
+                    throw new IncompleteReplicaError(table);
+                return result.rows[0];
+            };
+            const query = async (statement, parameters = []) => {
+                // PostgreSQL parses the actual statement and reports every scanned
+                // relation, including joins/subqueries. Never infer completeness using
+                // a regex that could silently miss a nested relation.
+                const explain = await tx.query(`EXPLAIN (FORMAT JSON) ${statement}`, [...parameters], queryOptions);
+                const tables = new Set();
+                const written = new Set();
+                const inspect = (value) => {
+                    if (Array.isArray(value)) {
+                        value.forEach(inspect);
+                        return;
+                    }
+                    if (!value || typeof value !== "object")
+                        return;
+                    const node = value;
+                    if (node["Node Type"] === "ModifyTable" && typeof node["Relation Name"] === "string")
+                        written.add(node["Relation Name"]);
+                    if (typeof node["Relation Name"] === "string") {
+                        tables.add(node["Relation Name"]);
+                    }
+                    Object.values(node).forEach(inspect);
+                };
+                inspect(explain.rows);
+                for (const table of tables) {
+                    // Only a proven primary-key lookup can use a partial collection.
+                    // PostgreSQL still discovers all relations above; joins, counts,
+                    // subqueries and range reads must have complete input coverage.
+                    const key = this.schema[table]?.key;
+                    const exact = /^SELECT (?:\*|"[A-Za-z_][A-Za-z0-9_]*"(?:,\s*"[A-Za-z_][A-Za-z0-9_]*")*) FROM "([A-Za-z_][A-Za-z0-9_]*)" WHERE "([A-Za-z_][A-Za-z0-9_]*)" = \$(\d+)(?: AND "deletedAt" IS NULL)?(?: LIMIT 1)?\s*;?$/i.exec(statement.trim());
+                    const id = exact ? parameters[Number(exact[3]) - 1] : undefined;
+                    if (tables.size === 1 && exact?.[1] === table && exact[2] === key && snapshot.tables[table]?.rows.some(row => row[key] === id)) {
+                        requireColumns(table);
+                        reads.add(table);
+                    }
+                    else
+                        requireComplete(table);
+                    await seed(table);
+                }
+                const before = new Map();
+                for (const table of written) {
+                    const rows = (await tx.query(`SELECT * FROM ${quote(table)}`, [], queryOptions)).rows;
+                    before.set(table, new Map(rows.map(row => [String(row[this.schema[table].key]), row])));
+                }
+                const result = await tx.query(statement, [...parameters], queryOptions);
+                // Reducer SQL (including data-modifying CTEs) is part of the same
+                // transaction. Capture its row delta just like typed database writes.
+                for (const table of written) {
+                    const prior = before.get(table);
+                    const key = this.schema[table].key;
+                    for (const row of (await tx.query(`SELECT * FROM ${quote(table)}`, [], queryOptions)).rows) {
+                        const id = String(row[key]);
+                        const old = prior.get(id);
+                        prior.delete(id);
+                        if (!old)
+                            patches.push({ entity: table, rowId: id, op: "insert", fields: clone(row) });
+                        else {
+                            const fields = Object.fromEntries(Object.entries(row).filter(([column, value]) => JSON.stringify(value) !== JSON.stringify(old[column])));
+                            if (Object.keys(fields).length)
+                                patches.push({ entity: table, rowId: id, op: "patch", fields });
+                        }
+                    }
+                    for (const id of prior.keys())
+                        patches.push({ entity: table, rowId: id, op: "delete" });
+                }
+                return result.rows;
+            };
+            const context = {
+                intentEntropy: execution.intentEntropy,
+                ...clone(execution.identity), now: execution.now,
+                invocation: {
+                    channel: "ui", rootChannel: "ui", commandId: execution.commandId,
+                    rootCommandId: execution.commandId, artifactHash: execution.artifactHash,
+                    actorAccountId: execution.identity.auth.account?.id ?? null,
+                    actorMemberId: execution.identity.member?.id ?? null, onBehalfOfMemberId: null,
+                },
+                db: {
+                    query,
+                    insert: async (table, row, allocation) => {
+                        const columns = requireTable(table);
+                        await seed(table);
+                        const value = clone(row);
+                        const key = this.schema[table].key;
+                        if (value[key] == null)
+                            value[key] = allocation?.generatedId ?? await nextId(`insert:${table}`);
+                        if (typeof value[key] !== "string" || !value[key])
+                            throw new Error("Insert requires a non-empty string id");
+                        if (columns._creationTime && value._creationTime == null)
+                            value._creationTime = execution.now;
+                        const inserted = await this.insertRow(tx, table, value);
+                        patches.push({ entity: table, rowId: value[key], op: "insert", fields: clone(inserted) });
+                        return clone(inserted);
+                    },
+                    update: async (table, id, patch) => {
+                        const columns = requireTable(table);
+                        const key = this.schema[table].key;
+                        if (Object.hasOwn(patch, key))
+                            throw new Error("Reducer update cannot change a row id");
+                        const before = await readRow(table, id);
+                        if (!before)
+                            throw new Error(`Row ${table}/${id} not found`);
+                        const keys = Object.keys(patch);
+                        keys.forEach((key) => { if (!columns[key])
+                            throw new Error(`Unknown column ${table}.${key}`); });
+                        for (const name of keys) {
+                            if (!columns[name].nullable && patch[name] == null)
+                                throw new Error(`Required field ${table}.${name} is missing`);
+                        }
+                        if (!keys.length)
+                            return clone(before);
+                        const updated = await tx.query(`UPDATE ${quote(table)} SET ${keys.map((key, index) => `${quote(key)} = $${index + 1}`).join(", ")} WHERE ${quote(key)} = $${keys.length + 1} RETURNING *`, [...keys.map((key) => patch[key]), id], queryOptions);
+                        patches.push({ entity: table, rowId: id, op: "patch", fields: clone(patch) });
+                        return clone(updated.rows[0]);
+                    },
+                    delete: async (table, id) => {
+                        const before = await readRow(table, id);
+                        if (!before)
+                            return;
+                        await tx.query(`DELETE FROM ${quote(table)} WHERE ${quote(this.schema[table].key)} = $1`, [id]);
+                        patches.push({ entity: table, rowId: id, op: "delete" });
+                    },
+                    deleteMany: async (table, ids) => {
+                        let deleted = 0;
+                        for (const id of new Set(ids)) {
+                            if (typeof id !== "string")
+                                throw new Error("Delete requires a string id");
+                            const before = await readRow(table, id);
+                            if (before) {
+                                await context.db.delete(table, id);
+                                deleted++;
+                            }
+                        }
+                        return { deleted };
+                    },
+                },
+                actions: { enqueue: async (path, args) => {
+                        const ordinal = deferredOrdinals.get("action") ?? 0;
+                        deferredOrdinals.set("action", ordinal + 1);
+                        const id = await reducerRowId(context, "deferred:action", ordinal);
+                        deferred.push({ id, kind: "action", path, args: clone(args) });
+                        return id;
+                    } },
+                scheduler: {
+                    runAfter: async (delay, path, args = {}) => context.scheduler.runAt(execution.now + delay, path, args),
+                    runAt: async (at, path, args = {}) => {
+                        if (!Number.isSafeInteger(at))
+                            throw new Error("Invalid schedule time");
+                        const ordinal = deferredOrdinals.get("schedule") ?? 0;
+                        deferredOrdinals.set("schedule", ordinal + 1);
+                        const id = `job_${await reducerRowId(context, "deferred:schedule", ordinal)}`;
+                        deferred.push({ id, kind: "schedule", path, args: clone(args), at });
+                        return id;
+                    },
+                },
+            };
+            const result = clone(await definition.handler(context, args));
+            validateValue(definition.options.result, result);
+            await tx.rollback();
+            return { result, patches, deferred, readTables: [...reads].sort() };
+        });
+    }
+    async insertRow(tx, table, row, seed = false) {
+        const { columns, key } = this.schema[table];
+        if (seed) {
+            row = Object.fromEntries(Object.entries(row).filter(([name]) => !!columns[name]));
+        }
+        const keys = Object.keys(row);
+        keys.forEach((key) => { if (!columns[key])
+            throw new Error(`Unknown column ${table}.${key}`); });
+        if (!keys.length)
+            throw new Error("Cannot insert an empty local row");
+        const result = await tx.query(`INSERT INTO ${quote(table)} (${keys.map(quote).join(", ")}) VALUES (${keys.map((_, index) => `$${index + 1}`).join(", ")}) RETURNING *`, keys.map((key) => row[key]), queryOptions);
+        const value = result.rows[0];
+        if (!seed)
+            for (const [name, column] of Object.entries(columns)) {
+                if (!column.nullable && value[name] == null)
+                    throw new Error(`Required field ${table}.${name} is missing`);
+            }
+        return JSON.parse(JSON.stringify(value));
+    }
+}
+/** Stable per-intent IDs. The server host must use the identical seed contract. */
+export async function deterministicId(scope, commandId, kind, ordinal) {
+    const bytes = new Uint8Array(await crypto.subtle.digest("SHA-256", new TextEncoder().encode(JSON.stringify([scope, commandId, kind, ordinal]))));
+    bytes[6] = (bytes[6] & 0x0f) | 0x80;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = Array.from(bytes.subarray(0, 16), (byte) => byte.toString(16).padStart(2, "0")).join("");
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,15 @@
+export type LocalColumn = {
+    type: string;
+    nullable: boolean;
+    default?: string;
+};
+export type LocalTableSchema = {
+    key: string;
+    columns: Record<string, LocalColumn>;
+};
+export type LocalSchema = Record<string, LocalTableSchema>;
+/** Compile schema using PostgreSQL itself, without connecting to a service. */
+export declare function compileLocalSchema(migrations: readonly {
+    name: string;
+    sql: string;
+}[]): Promise<LocalSchema>;

package/dist/schema.js

@@ -0,0 +1,55 @@
+import { PGlite } from "@electric-sql/pglite";
+import { pg_trgm } from "@electric-sql/pglite/contrib/pg_trgm";
+// The framework's tenant identity table exists before application migrations.
+// Keep this in parity with TENANT_IDENTITY_SQL in postgres/src/provision.rs.
+const identitySchema = `CREATE TABLE members (
+  id text PRIMARY KEY, account_id text NOT NULL UNIQUE, status text NOT NULL DEFAULT 'active',
+  display_name text NOT NULL DEFAULT '', avatar_url text NOT NULL DEFAULT '',
+  role text NOT NULL DEFAULT 'member', permissions jsonb NOT NULL DEFAULT '{}'::jsonb,
+  membership_revision bigint NOT NULL DEFAULT 1,
+  created_at timestamptz NOT NULL DEFAULT now(), updated_at timestamptz NOT NULL DEFAULT now()
+)`;
+/** Compile schema using PostgreSQL itself, without connecting to a service. */
+export async function compileLocalSchema(migrations) {
+    const db = new PGlite({ extensions: { pg_trgm } });
+    try {
+        await db.exec(identitySchema);
+        for (const migration of migrations) {
+            // gen_random_uuid is built into modern PostgreSQL. PGlite does not ship
+            // pgcrypto's OpenSSL extension; remaining references fail explicitly.
+            const sql = migration.sql.replace(/CREATE\s+EXTENSION\s+(?:IF\s+NOT\s+EXISTS\s+)?["']?pgcrypto["']?\s*;/gi, "");
+            try {
+                await db.exec(sql);
+            }
+            catch (error) {
+                throw new Error(`Local schema compilation failed in ${migration.name}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+            }
+        }
+        const { rows } = await db.query(`SELECT c.relname AS table_name, a.attname AS column_name,
+      format_type(a.atttypid, a.atttypmod) AS type, NOT a.attnotnull AS nullable,
+      pg_get_expr(d.adbin, d.adrelid) AS column_default,
+      EXISTS (SELECT 1 FROM pg_index i WHERE i.indrelid=c.oid AND i.indisprimary AND a.attnum=ANY(i.indkey)) AS primary_key
+      FROM pg_class c JOIN pg_namespace n ON c.relnamespace=n.oid
+      JOIN pg_attribute a ON a.attrelid=c.oid AND a.attnum>0 AND NOT a.attisdropped
+      LEFT JOIN pg_attrdef d ON d.adrelid=c.oid AND d.adnum=a.attnum
+      WHERE n.nspname='public' AND c.relkind='r'
+      ORDER BY c.relname, a.attnum`);
+        const schema = {};
+        for (const row of rows) {
+            if (row.table_name.startsWith("_gonvex"))
+                continue;
+            const table = schema[row.table_name] ??= { key: "_id", columns: {} };
+            if (row.primary_key)
+                table.key = row.column_name;
+            table.columns[row.column_name] = {
+                type: row.type, nullable: row.nullable,
+                ...(row.column_default ? { default: row.column_default } : {}),
+            };
+        }
+        return schema;
+    }
+    finally {
+        await db.close();
+    }
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AAM/D,8EAA8E;AAC9E,6EAA6E;AAC7E,MAAM,cAAc,GAAG;;;;;;EAMrB,CAAC;AAEH,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,UAAoD;IAC3F,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,wEAAwE;YACxE,sEAAsE;YACtE,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,wEAAwE,EAAE,EAAE,CAAC,CAAC;YAChH,IAAI,CAAC;gBAAC,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAAC,CAAC;YAC3B,OAAO,KAAK,EAAE,CAAC;gBAAC,MAAM,IAAI,KAAK,CAAC,sCAAsC,SAAS,CAAC,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YAAC,CAAC;QACzK,CAAC;QACD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,KAAK,CAG5B;;;;;;;;mCAQ4B,CAAC,CAAC;QACjC,MAAM,MAAM,GAAgB,EAAE,CAAC;QAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC;gBAAE,SAAS;YACnD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YACrE,IAAI,GAAG,CAAC,WAAW;gBAAE,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC;YACjD,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG;gBAC/B,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/D,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;YAAS,CAAC;QAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;IAAC,CAAC;AACjC,CAAC"}

package/dist/validation.d.ts

@@ -0,0 +1,3 @@
+import type { PortableSchema } from "@gonvex/module-sdk";
+/** Mirrors the Rust portable schema validator, including Unicode lengths. */
+export declare function validateValue(schema: PortableSchema | undefined, value: unknown, path?: string, optional?: boolean): void;

package/dist/validation.js

@@ -0,0 +1,86 @@
+/** Mirrors the Rust portable schema validator, including Unicode lengths. */
+export function validateValue(schema, value, path = "$", optional = false) {
+    if (!schema)
+        return;
+    const fail = (message) => { throw new Error(`${path}: ${message}`); };
+    const object = () => { if (value === null || typeof value !== "object" || Array.isArray(value))
+        fail("expected object"); return value; };
+    switch (schema.kind) {
+        case "any": return;
+        case "string": {
+            if (typeof value !== "string")
+                fail("expected string");
+            const length = [...value].length;
+            if (schema.minLength !== undefined && length < schema.minLength)
+                fail(`string length must be at least ${schema.minLength}`);
+            if (schema.maxLength !== undefined && length > schema.maxLength)
+                fail(`string length must be at most ${schema.maxLength}`);
+            return;
+        }
+        case "id":
+            if (typeof value !== "string")
+                fail("expected entity id string");
+            return;
+        case "number": {
+            if (typeof value !== "number" || !Number.isFinite(value))
+                fail("expected number");
+            if (schema.integer && !Number.isInteger(value))
+                fail("expected integer");
+            if (schema.minimum !== undefined && value < schema.minimum)
+                fail(`number must be at least ${schema.minimum}`);
+            if (schema.maximum !== undefined && value > schema.maximum)
+                fail(`number must be at most ${schema.maximum}`);
+            return;
+        }
+        case "boolean":
+            if (typeof value !== "boolean")
+                fail("expected boolean");
+            return;
+        case "null":
+            if (value !== null)
+                fail("expected null");
+            return;
+        case "literal":
+            if (!equal(schema.value, value))
+                fail("expected literal");
+            return;
+        case "array":
+            if (!Array.isArray(value))
+                fail("expected array");
+            value.forEach((item, index) => validateValue(schema.items, item, `${path}[${index}]`));
+            return;
+        case "record":
+            Object.entries(object()).forEach(([key, item]) => validateValue(schema.values, item, `${path}.${key}`));
+            return;
+        case "object": {
+            const input = object();
+            for (const [key, field] of Object.entries(schema.fields)) {
+                if (!Object.hasOwn(input, key)) {
+                    if (field.kind !== "optional")
+                        fail(`${key}: required field is missing`);
+                    continue;
+                }
+                validateValue(field, input[key], `${path}.${key}`, true);
+            }
+            if (!schema.allowUnknown)
+                for (const key of Object.keys(input))
+                    if (!Object.hasOwn(schema.fields, key))
+                        fail(`${key}: unknown field`);
+            return;
+        }
+        case "optional":
+            if (!optional)
+                fail("optional is only valid on object fields");
+            validateValue(schema.value, value, path);
+            return;
+    }
+}
+function equal(left, right) {
+    if (left === right)
+        return true;
+    if (!left || !right || typeof left !== "object" || typeof right !== "object" || Array.isArray(left) !== Array.isArray(right))
+        return false;
+    const a = Object.keys(left), b = Object.keys(right);
+    return a.length === b.length && a.every(key => Object.hasOwn(right, key) && equal(left[key], right[key]));
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,MAAM,UAAU,aAAa,CAAC,MAAkC,EAAE,KAAc,EAAE,IAAI,GAAG,GAAG,EAAE,QAAQ,GAAG,KAAK;IAC5G,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,IAAI,GAAG,CAAC,OAAe,EAAS,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACrF,MAAM,MAAM,GAAG,GAAG,EAAE,GAAG,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,KAAgC,CAAC,CAAC,CAAC,CAAC;IACpK,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,KAAK,CAAC,CAAC,OAAO;QACnB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,CAAC,GAAG,KAAe,CAAC,CAAC,MAAM,CAAC;YAC3C,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,MAAM,GAAG,MAAM,CAAC,SAAS;gBAAE,IAAI,CAAC,kCAAkC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;YAC5H,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,MAAM,GAAG,MAAM,CAAC,SAAS;gBAAE,IAAI,CAAC,iCAAiC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;YAC3H,OAAO;QACT,CAAC;QACD,KAAK,IAAI;YAAE,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,IAAI,CAAC,2BAA2B,CAAC,CAAC;YAAC,OAAO;QACpF,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAClF,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;gBAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;YACzE,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAK,KAAgB,GAAG,MAAM,CAAC,OAAO;gBAAE,IAAI,CAAC,2BAA2B,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1H,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAK,KAAgB,GAAG,MAAM,CAAC,OAAO;gBAAE,IAAI,CAAC,0BAA0B,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YACzH,OAAO;QACT,CAAC;QACD,KAAK,SAAS;YAAE,IAAI,OAAO,KAAK,KAAK,SAAS;gBAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAAC,OAAO;QACjF,KAAK,MAAM;YAAE,IAAI,KAAK,KAAK,IAAI;gBAAE,IAAI,CAAC,eAAe,CAAC,CAAC;YAAC,OAAO;QAC/D,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC;gBAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAAC,OAAO;QAClF,KAAK,OAAO;YACV,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACjD,KAAmB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;YAAC,OAAO;QAChH,KAAK,QAAQ;YACX,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;YAAC,OAAO;QAClH,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;YACvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;oBAAC,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;wBAAE,IAAI,CAAC,GAAG,GAAG,6BAA6B,CAAC,CAAC;oBAAC,SAAS;gBAAC,CAAC;gBACvH,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;YAC3D,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,YAAY;gBAAE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;oBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;wBAAE,IAAI,CAAC,GAAG,GAAG,iBAAiB,CAAC,CAAC;YACtI,OAAO;QACT,CAAC;QACD,KAAK,UAAU;YAAE,IAAI,CAAC,QAAQ;gBAAE,IAAI,CAAC,yCAAyC,CAAC,CAAC;YAAC,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YAAC,OAAO;IACpI,CAAC;AACH,CAAC;AACD,SAAS,KAAK,CAAC,IAAa,EAAE,KAAc;IAC1C,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3I,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,KAAK,CAAE,IAAY,CAAC,GAAG,CAAC,EAAG,KAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC9H,CAAC"}

package/dist/worker-client.d.ts

@@ -0,0 +1,15 @@
+import type { JsonValue } from "@gonvex/module-sdk";
+import type { LocalExecution, LocalIntent, LocalReplay, LocalSnapshot, LocalTransactionResult } from "./index.js";
+export type LocalExecutor = {
+    ready: Promise<void>;
+    execute(path: string, args: JsonValue, snapshot: LocalSnapshot, execution: LocalExecution): Promise<LocalTransactionResult>;
+    replay(snapshot: LocalSnapshot, intents: readonly LocalIntent[]): Promise<LocalReplay>;
+    close(): void;
+};
+export type LocalRuntimeBinding = {
+    artifactHash: string;
+    tables: readonly string[];
+    create(): LocalExecutor;
+};
+/** Worker lifetime and RPC are SDK-owned; applications only import generated bindings. */
+export declare function createLocalReducerWorker(worker: Worker): LocalExecutor;

package/dist/worker-client.js

@@ -0,0 +1,54 @@
+/** Worker lifetime and RPC are SDK-owned; applications only import generated bindings. */
+export function createLocalReducerWorker(worker) {
+    let sequence = 0;
+    let closed = false;
+    let failure;
+    const pending = new Map();
+    const ready = new Promise((resolve, reject) => { pending.set(0, { resolve, reject }); });
+    // An eager worker can fail before the first reducer is called.
+    void ready.catch(() => undefined);
+    const fail = (error) => {
+        failure = error;
+        for (const callback of pending.values())
+            callback.reject(error);
+        pending.clear();
+    };
+    worker.addEventListener("error", (event) => fail(new Error(event.message || "Local reducer worker failed")));
+    worker.addEventListener("messageerror", () => fail(new Error("Local reducer worker response could not be decoded")));
+    worker.addEventListener("message", (event) => {
+        const message = event.data;
+        const callback = pending.get(message?.id);
+        if (!callback)
+            return;
+        pending.delete(message.id);
+        if (message.error)
+            callback.reject(Object.assign(new Error(message.error.message), { name: message.error.name }));
+        else
+            callback.resolve(message.result);
+    });
+    const call = async (method, args) => {
+        await ready;
+        if (failure)
+            throw failure;
+        if (closed)
+            throw new Error("Local reducer worker is closed");
+        const id = ++sequence;
+        return new Promise((resolve, reject) => {
+            pending.set(id, { resolve, reject });
+            try {
+                worker.postMessage({ id, method, args });
+            }
+            catch (error) {
+                pending.delete(id);
+                reject(error);
+            }
+        });
+    };
+    return {
+        ready,
+        execute: (...args) => call("execute", args),
+        replay: (...args) => call("replay", args),
+        close: () => { closed = true; worker.terminate(); fail(new Error("Local reducer worker closed")); },
+    };
+}
+//# sourceMappingURL=worker-client.js.map

package/dist/worker-client.js.map

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

package/dist/worker.d.ts

@@ -0,0 +1,3 @@
+import { type LocalRuntimeOptions } from "./index.js";
+/** Generated worker entrypoint calls this exactly once. */
+export declare function serveLocalReducerWorker(options: LocalRuntimeOptions): void;

package/dist/worker.js

@@ -0,0 +1,35 @@
+import { LocalReducerRuntime } from "./index.js";
+/** Generated worker entrypoint calls this exactly once. */
+export function serveLocalReducerWorker(options) {
+    const host = new LocalReducerRuntime(options);
+    const endpoint = globalThis;
+    const respond = async (id, run) => {
+        try {
+            endpoint.postMessage({ id, result: await run() });
+        }
+        catch (error) {
+            endpoint.postMessage({ id, error: { name: error instanceof Error ? error.name : "Error", message: error instanceof Error ? error.message : String(error) } });
+        }
+    };
+    void respond(0, async () => {
+        await host.initializeReady();
+        // WASM is loaded before closing ambient network access. Reducers enqueue
+        // external work through ctx.actions; they cannot send it during prediction.
+        const denied = () => { throw new Error("External I/O is unavailable in a local Reducer; enqueue an Action"); };
+        Object.defineProperty(globalThis, "fetch", { value: denied, writable: false, configurable: false });
+        Object.defineProperty(globalThis, "WebSocket", { value: denied, writable: false, configurable: false });
+        Object.defineProperty(globalThis, "XMLHttpRequest", { value: denied, writable: false, configurable: false });
+    });
+    endpoint.addEventListener("message", ({ data }) => {
+        if (!data || !Number.isSafeInteger(data.id) || !Array.isArray(data.args))
+            return;
+        void respond(data.id, async () => {
+            if (data.method === "execute")
+                return host.execute(data.args[0], data.args[1], data.args[2], data.args[3]);
+            if (data.method === "replay")
+                return host.replay(data.args[0], data.args[1]);
+            throw new Error("Unknown local reducer operation");
+        });
+    });
+}
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAA4B,MAAM,YAAY,CAAC;AAE3E,2DAA2D;AAC3D,MAAM,UAAU,uBAAuB,CAAC,OAA4B;IAClE,MAAM,IAAI,GAAG,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,UAGhB,CAAC;IACF,MAAM,OAAO,GAAG,KAAK,EAAE,EAAU,EAAE,GAA2B,EAAE,EAAE;QAChE,IAAI,CAAC;YAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,CAAC,CAAC;QAAC,CAAC;QAC1D,OAAO,KAAK,EAAE,CAAC;YAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAAC,CAAC;IAClL,CAAC,CAAC;IACF,KAAK,OAAO,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE;QACzB,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC7B,yEAAyE;QACzE,4EAA4E;QAC5E,MAAM,MAAM,GAAG,GAAG,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/G,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;QACpG,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;QACxG,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,gBAAgB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/G,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;QAChD,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO;QACjF,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE;YAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3G,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7E,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@gonvex/local-runtime",
+  "version": "0.5.2-staging.11",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./schema": {
+      "types": "./dist/schema.d.ts",
+      "default": "./dist/schema.js"
+    },
+    "./worker": {
+      "types": "./dist/worker.d.ts",
+      "default": "./dist/worker.js"
+    },
+    "./worker-client": {
+      "types": "./dist/worker-client.d.ts",
+      "default": "./dist/worker-client.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@electric-sql/pglite": "0.5.8",
+    "@gonvex/module-sdk": "0.5.2-staging.11"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --maxWorkers=1"
+  }
+}