@gonvex/local-runtime 0.5.2-staging.12 → 0.5.2-staging.14

package/dist/native-bridge.d.ts

@@ -0,0 +1,32 @@
+import { type LocalExecutor, type LocalWorkerEndpoint } from './worker-client.js';
+/** The native view is only an execution sandbox. Durable state stays in the SDK replica/outbox. */
+export declare class NativeReducerBridge implements LocalWorkerEndpoint {
+    readonly id: number;
+    private readonly onClose;
+    private listeners;
+    private sender?;
+    private stopped;
+    readonly executor: LocalExecutor;
+    constructor(id: number, onClose: () => void);
+    addEventListener(type: string, listener: (event: any) => void): void;
+    private emit;
+    attach(sender: (message: unknown) => void): void;
+    receive(encoded: string): void;
+    fail(message: string): void;
+    postMessage(message: unknown): void;
+    terminate(): void;
+}
+/** Generated bindings create this registry; generated UI mounts one sandbox per client. */
+export declare function nativeReducerHosts(): {
+    snapshot: () => readonly NativeReducerBridge[];
+    subscribe(listener: () => void): () => void;
+    create(): LocalExecutor;
+};
+/** Serialize the bridge envelope as data for WebView's script injection transport. */
+export declare function nativeMessageScript(message: unknown): string;
+/** Called by generated Expo bindings before constructing the client. */
+export declare function installNativeRuntimeGlobals(random: {
+    getRandomValues(array: Uint8Array): Uint8Array;
+    randomUUID(): string;
+    digest?(data: BufferSource): Promise<ArrayBuffer>;
+}): void;

package/dist/native-bridge.js

@@ -0,0 +1,93 @@
+import clone from '@ungap/structured-clone';
+import { createLocalReducerWorker } from './worker-client.js';
+/** The native view is only an execution sandbox. Durable state stays in the SDK replica/outbox. */
+export class NativeReducerBridge {
+    id;
+    onClose;
+    listeners = new Map();
+    sender;
+    stopped = false;
+    executor;
+    constructor(id, onClose) {
+        this.id = id;
+        this.onClose = onClose;
+        this.executor = createLocalReducerWorker(this);
+    }
+    addEventListener(type, listener) {
+        this.listeners.set(type, [...this.listeners.get(type) ?? [], listener]);
+    }
+    emit(type, event) {
+        for (const listener of this.listeners.get(type) ?? [])
+            listener(event);
+    }
+    attach(sender) { this.sender = sender; }
+    receive(encoded) {
+        if (this.stopped)
+            return;
+        try {
+            const message = JSON.parse(encoded);
+            if (Array.isArray(message.result?.rejected)) {
+                for (const rejected of message.result.rejected) {
+                    if (rejected.error)
+                        rejected.error = Object.assign(new Error(rejected.error.message), { name: rejected.error.name });
+                }
+            }
+            this.emit('message', { data: message });
+        }
+        catch {
+            this.emit('messageerror', {});
+        }
+    }
+    fail(message) { this.emit('error', { message }); }
+    postMessage(message) {
+        if (this.stopped || !this.sender)
+            throw new Error('Native Reducer host is unavailable');
+        this.sender(message);
+    }
+    terminate() {
+        if (this.stopped)
+            return;
+        this.stopped = true;
+        this.sender = undefined;
+        this.onClose();
+    }
+}
+/** Generated bindings create this registry; generated UI mounts one sandbox per client. */
+export function nativeReducerHosts() {
+    let nextId = 0;
+    let hosts = [];
+    const listeners = new Set();
+    const emit = () => { for (const listener of listeners)
+        listener(); };
+    return {
+        snapshot: () => hosts,
+        subscribe(listener) { listeners.add(listener); return () => { listeners.delete(listener); }; },
+        create() {
+            const id = ++nextId;
+            const host = new NativeReducerBridge(id, () => { hosts = hosts.filter(entry => entry.id !== id); emit(); });
+            hosts = [...hosts, host];
+            emit();
+            return host.executor;
+        },
+    };
+}
+/** Serialize the bridge envelope as data for WebView's script injection transport. */
+export function nativeMessageScript(message) {
+    const encoded = JSON.stringify(JSON.stringify(message)).replaceAll('\u2028', '\\u2028').replaceAll('\u2029', '\\u2029');
+    return `window.dispatchEvent(new MessageEvent('message',{data:JSON.parse(${encoded})}));true;`;
+}
+/** Called by generated Expo bindings before constructing the client. */
+export function installNativeRuntimeGlobals(random) {
+    if (typeof globalThis.structuredClone !== 'function')
+        Object.defineProperty(globalThis, 'structuredClone', { value: (value) => clone(value, { lossy: false }), configurable: true });
+    if (typeof globalThis.crypto?.getRandomValues !== 'function') {
+        Object.defineProperty(globalThis, 'crypto', { value: { getRandomValues: random.getRandomValues, randomUUID: random.randomUUID }, configurable: true });
+    }
+    if (!globalThis.crypto.subtle && random.digest)
+        Object.defineProperty(globalThis.crypto, 'subtle', { value: { digest: (algorithm, data) => {
+                    if (algorithm !== 'SHA-256')
+                        throw new Error('Unsupported native digest');
+                    return random.digest(data);
+                } }, configurable: true });
+}
+//# sourceMappingURL=native-bridge.js.map

package/dist/native-bridge.js.map

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

package/dist/portable-client.d.ts

@@ -0,0 +1,4 @@
+import type { LocalExecutor } from "./worker-client.js";
+import { type PortableReducerOptions } from "./portable.js";
+/** Native JS and browsers use the same executor; no SQL engine or WebView. */
+export declare function createPortableReducer(options: PortableReducerOptions): LocalExecutor;

package/dist/portable-client.js

@@ -0,0 +1,71 @@
+import { PortableReducerRuntime, } from "./portable.js";
+import { memoryReadView, overlayReadView } from "./read-view.js";
+/** Native JS and browsers use the same executor; no SQL engine or WebView. */
+export function createPortableReducer(options) {
+    const runtime = new PortableReducerRuntime(options);
+    let closed = false;
+    const execute = (...args) => {
+        if (closed)
+            return Promise.reject(new Error("Local reducer executor is closed"));
+        return runtime.execute(...args);
+    };
+    const coverage = (snapshot) => Object.fromEntries(Object.entries(snapshot.tables).map(([table, data]) => [
+        table,
+        {
+            key: options.schema[table]?.key ?? "_id",
+            complete: data.complete,
+            columns: data.columns,
+        },
+    ]));
+    const view = (snapshot) => memoryReadView(new Map(Object.entries(snapshot.tables).map(([table, data]) => [
+        table,
+        new Map(data.rows.map((row) => [
+            String(row[options.schema[table]?.key ?? "_id"]),
+            row,
+        ])),
+    ])), coverage(snapshot));
+    return {
+        ready: Promise.resolve(),
+        prepare: path => closed ? Promise.reject(new Error("Local reducer executor is closed")) : runtime.prepare(path),
+        executeRead: execute,
+        execute: (path, args, snapshot, execution) => execute(path, args, view(snapshot), execution),
+        replay: async (snapshot, intents) => {
+            let source = view(snapshot);
+            const transactions = [];
+            const rejected = [];
+            const ids = new Set();
+            for (const intent of intents) {
+                if (intent.execution.scope !== snapshot.scope)
+                    throw new Error("Local reducer scope mismatch");
+                if (intent.execution.artifactHash !== 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);
+            }
+            for (const intent of intents) {
+                try {
+                    const transaction = await execute(intent.path, intent.args, source, intent.execution);
+                    transactions.push({
+                        commandId: intent.execution.commandId,
+                        transaction,
+                    });
+                    source = overlayReadView(source, coverage(snapshot), transaction.patches);
+                }
+                catch (error) {
+                    if (error instanceof Error && error.name === "IncompleteReplicaError")
+                        throw error;
+                    rejected.push({
+                        commandId: intent.execution.commandId,
+                        error: error instanceof Error ? error : new Error(String(error)),
+                    });
+                }
+            }
+            return { transactions, rejected };
+        },
+        close: () => {
+            closed = true;
+        },
+    };
+}
+//# sourceMappingURL=portable-client.js.map

package/dist/portable-client.js.map

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

package/dist/portable.d.ts

@@ -0,0 +1,37 @@
+import type { DataRead, JsonObject, JsonValue, ReducerDefinition } from "@gonvex/module-sdk";
+import type { LocalExecution, LocalTransactionResult } from "./index.js";
+import type { LocalSchema } from "./schema.js";
+/** A transaction-consistent SDK read view. Implementations may use RAM or disk.
+ * Rows are detached values; complete describes this read, not the whole database.
+ */
+export type ReducerReadView = {
+    readonly keepAliveFor?: <T>(promise: Promise<T>) => Promise<T>;
+    select(read: DataRead, 
+    /** Base rows fully replaced or removed by the SDK's pending journal. */
+    excludedRowIds?: readonly string[]): Promise<{
+        rows: readonly JsonObject[];
+        complete: boolean;
+    }>;
+};
+export declare class MissingReducerDataError extends Error {
+    readonly read: DataRead;
+    constructor(read: DataRead);
+}
+export declare class UnsupportedLocalOperationError extends Error {
+    constructor(message: string);
+}
+export type PortableReducerOptions = {
+    schema: LocalSchema;
+    reducers: Readonly<Record<string, ReducerDefinition<any, any> | (() => Promise<ReducerDefinition<any, any>>)>>;
+    artifactHash: string;
+};
+export declare function orderDataRows(rows: JsonObject[], read: DataRead): void;
+/** Shared reducer execution with no SQL engine and no collection snapshot copies. */
+export declare class PortableReducerRuntime {
+    private readonly options;
+    private readonly definitions;
+    constructor(options: PortableReducerOptions);
+    private definition;
+    prepare(path: string): Promise<void>;
+    execute(path: string, args: JsonValue, source: ReducerReadView, execution: LocalExecution): Promise<LocalTransactionResult>;
+}

package/dist/portable.js

@@ -0,0 +1,389 @@
+import { executionReadColumns } from './read-view.js';
+import { compileDataRead, orderedDataRead, matchesDataPredicate, reducerRowId, } from "@gonvex/module-sdk";
+import { validateValue } from "./validation.js";
+export class MissingReducerDataError extends Error {
+    read;
+    constructor(read) {
+        super(`Local replica for ${read.table} is incomplete; this reducer cannot decide from missing rows.`);
+        this.read = read;
+        this.name = "IncompleteReplicaError";
+    }
+}
+export class UnsupportedLocalOperationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "UnsupportedLocalOperationError";
+    }
+}
+const copy = (value) => structuredClone(value);
+function defaultValue(column, now) {
+    const expression = column.default?.trim();
+    if (!expression || /^NULL(?:::.*)?$/i.test(expression))
+        return null;
+    if (column.type === "timestamp with time zone" &&
+        /^(?:clock_timestamp|now)\(\)$/i.test(expression))
+        return new Date(now).toISOString();
+    if (/^(true|false)$/i.test(expression))
+        return expression.toLowerCase() === "true";
+    if (/^-?\d+(?:\.\d+)?$/.test(expression))
+        return Number(expression);
+    const literal = /^'((?:[^']|'')*)'(?:::(?:[a-z ]+)(?:\[\])?)?$/i.exec(expression);
+    if (literal) {
+        const text = literal[1].replaceAll("''", "'");
+        if (column.type === "jsonb" || column.type === "json")
+            return JSON.parse(text);
+        if (column.type === "boolean")
+            return text === "true";
+        if ([
+            "integer",
+            "bigint",
+            "smallint",
+            "numeric",
+            "double precision",
+            "real",
+        ].includes(column.type))
+            return Number(text);
+        return text;
+    }
+    throw new UnsupportedLocalOperationError(`Default ${expression} must be supplied explicitly by the shared reducer`);
+}
+function columnValue(table, name, column, value) {
+    if (value == null) {
+        if (!column.nullable)
+            throw new Error(`Required field ${table}.${name} is missing`);
+        return null;
+    }
+    const type = column.type;
+    if (["integer", "bigint", "smallint"].includes(type)) {
+        const number = typeof value === "string" && /^[-+]?\d+$/.test(value.trim())
+            ? Number(value)
+            : value;
+        if (typeof number !== "number" || !Number.isSafeInteger(number))
+            throw new Error(`Invalid integer for ${table}.${name}`);
+        if (type === "integer" && (number < -2147483648 || number > 2147483647))
+            throw new Error(`Integer out of range for ${table}.${name}`);
+        if (type === "smallint" && (number < -32768 || number > 32767))
+            throw new Error(`Integer out of range for ${table}.${name}`);
+        return number;
+    }
+    if (["double precision", "real", "numeric"].includes(type)) {
+        const number = typeof value === "string" && value.trim() ? Number(value) : value;
+        if (typeof number !== "number" || !Number.isFinite(number))
+            throw new Error(`Invalid number for ${table}.${name}`);
+        return number;
+    }
+    if (type === "boolean") {
+        if (typeof value !== "boolean")
+            throw new Error(`Invalid boolean for ${table}.${name}`);
+        return value;
+    }
+    if (type === "uuid") {
+        if (typeof value !== "string" ||
+            !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value))
+            throw new Error(`Invalid UUID for ${table}.${name}`);
+        return value.toLowerCase();
+    }
+    if (type === "text" || type.startsWith("character varying")) {
+        if (typeof value !== "string")
+            throw new Error(`Invalid text for ${table}.${name}`);
+        return value;
+    }
+    if (type === "jsonb" || type === "json")
+        return copy(value);
+    if (type === "timestamp with time zone") {
+        if (typeof value !== "string" || !Number.isFinite(Date.parse(value)))
+            throw new Error(`Invalid timestamp for ${table}.${name}`);
+        return new Date(value).toISOString();
+    }
+    throw new UnsupportedLocalOperationError(`Column type ${type} requires a portable adapter`);
+}
+export function orderDataRows(rows, read) {
+    if (!read.orderBy?.length)
+        return;
+    rows.sort((a, b) => {
+        for (const order of read.orderBy) {
+            const sortValue = (row) => {
+                const value = row[order.column];
+                if (order.transform !== "numericSuffix" || value == null)
+                    return value;
+                if (typeof value !== "string")
+                    throw new Error("Numeric suffix requires text");
+                const suffix = value.match(/[0-9]+$/)?.[0];
+                return suffix === undefined ? null : BigInt(suffix);
+            };
+            const left = sortValue(a), right = sortValue(b);
+            if (left === right)
+                continue;
+            const direction = order.direction === "desc" ? -1 : 1;
+            const nullFirst = (order.nulls ?? (direction === 1 ? "last" : "first")) === "first";
+            if (left == null)
+                return nullFirst ? -1 : 1;
+            if (right == null)
+                return nullFirst ? 1 : -1;
+            if (typeof left !== typeof right || typeof left === "object")
+                throw new Error(`Incompatible ordering for ${order.column}`);
+            return (left < right ? -1 : 1) * direction;
+        }
+        return 0;
+    });
+}
+/** Shared reducer execution with no SQL engine and no collection snapshot copies. */
+export class PortableReducerRuntime {
+    options;
+    definitions = new Map();
+    constructor(options) {
+        this.options = options;
+    }
+    definition(path) {
+        const entry = this.options.reducers[path];
+        if (!entry)
+            return Promise.reject(new Error(`No public local reducer registered for ${path}`));
+        if (typeof entry !== 'function')
+            return Promise.resolve(entry);
+        let pending = this.definitions.get(path);
+        if (!pending) {
+            pending = Promise.resolve().then(entry).catch(error => { this.definitions.delete(path); throw error; });
+            this.definitions.set(path, pending);
+        }
+        return pending;
+    }
+    async prepare(path) { await this.definition(path); }
+    async execute(path, args, source, execution) {
+        if (execution.artifactHash !== this.options.artifactHash)
+            throw new Error("Local reducer artifact mismatch");
+        const definition = await this.definition(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 changes = new Map();
+        const patches = [];
+        const deferred = [];
+        const reads = new Set();
+        const primaryReads = new Map();
+        const tableSchema = (table) => {
+            const schema = this.options.schema[table];
+            if (!schema)
+                throw new Error(`Unknown local table ${table}`);
+            return schema;
+        };
+        const changed = (table) => {
+            let rows = changes.get(table);
+            if (!rows) {
+                rows = new Map();
+                changes.set(table, rows);
+            }
+            return rows;
+        };
+        const select = async (read) => {
+            read = orderedDataRead({
+                ...read,
+                key: read.key ?? tableSchema(read.table).key,
+            });
+            compileDataRead(read);
+            const schema = tableSchema(read.table);
+            const columns = new Set(read.columns ?? []);
+            const collect = (predicate) => {
+                if ("and" in predicate)
+                    predicate.and.forEach(collect);
+                else if ("or" in predicate)
+                    predicate.or.forEach(collect);
+                else
+                    columns.add(predicate.column);
+            };
+            if (read.where)
+                collect(read.where);
+            for (const order of read.orderBy ?? [])
+                columns.add(order.column);
+            for (const column of columns)
+                if (!schema.columns[column])
+                    throw new Error(`Unknown column ${read.table}.${column}`);
+            reads.add(read.table);
+            if (read.limit === 0)
+                return [];
+            const staged = changes.get(read.table);
+            // Fetch enough ordered candidates to replace rows removed by this transaction.
+            const result = await source.select({
+                ...read,
+                columns: executionReadColumns(read, schema.key),
+                limit: read.limit === undefined
+                    ? undefined
+                    : read.limit + (staged?.size ?? 0),
+            });
+            if (!result.complete)
+                throw new MissingReducerDataError(read);
+            const rows = new Map(result.rows.map((row) => [String(row[schema.key]), row]));
+            for (const [id, row] of staged ?? []) {
+                rows.delete(id);
+                if (row && (!read.where || matchesDataPredicate(row, read.where)))
+                    rows.set(id, row);
+            }
+            const ordered = [...rows.values()];
+            orderDataRows(ordered, read);
+            const window = read.limit === undefined ? ordered : ordered.slice(0, read.limit);
+            return window.map((row) => copy(read.columns
+                ? Object.fromEntries(read.columns.map((column) => [column, row[column] ?? null]))
+                : row));
+        };
+        const get = async (table, id) => {
+            const schema = tableSchema(table);
+            const staged = changes.get(table);
+            if (staged?.has(id))
+                return copy(staged.get(id) ?? undefined);
+            let tableReads = primaryReads.get(table);
+            if (!tableReads) {
+                tableReads = new Map();
+                primaryReads.set(table, tableReads);
+            }
+            let pending = tableReads.get(id);
+            if (!pending) {
+                pending = select({
+                    table,
+                    key: schema.key,
+                    where: { column: schema.key, op: "eq", value: id },
+                    limit: 1,
+                }).then((rows) => rows[0]);
+                tableReads.set(id, pending);
+            }
+            return copy(await pending);
+        };
+        const context = {
+            ...copy(execution.identity),
+            now: execution.now,
+            intentEntropy: execution.intentEntropy,
+            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: {
+                keepAliveFor: source.keepAliveFor,
+                tables: Object.keys(this.options.schema),
+                select,
+                lock: async () => {
+                    /* The SDK serializes local intent execution. */
+                },
+                atomic: async (run) => {
+                    const prior = new Map([...changes].map(([table, rows]) => [table, new Map(rows)]));
+                    const length = patches.length;
+                    try {
+                        return await run();
+                    }
+                    catch (error) {
+                        changes.clear();
+                        for (const [table, rows] of prior)
+                            changes.set(table, rows);
+                        patches.length = length;
+                        throw error;
+                    }
+                },
+                query: async () => {
+                    throw new UnsupportedLocalOperationError("Raw SQL is not available in portable reducers; use structured database reads");
+                },
+                insert: async (table, input, allocation) => {
+                    const schema = tableSchema(table);
+                    const row = copy(input);
+                    const allocated = allocation?.generatedId !== undefined &&
+                        (row[schema.key] == null ||
+                            row[schema.key] === allocation.generatedId);
+                    if (row[schema.key] == null)
+                        row[schema.key] =
+                            allocation?.generatedId ??
+                                (await reducerRowId(context, table, 0));
+                    if (schema.columns._creationTime && row._creationTime == null)
+                        row._creationTime = execution.now;
+                    for (const name of Object.keys(row))
+                        if (!schema.columns[name])
+                            throw new Error(`Unknown column ${table}.${name}`);
+                    for (const [name, column] of Object.entries(schema.columns))
+                        row[name] = columnValue(table, name, column, row[name] === undefined
+                            ? defaultValue(column, execution.now)
+                            : row[name]);
+                    const id = String(row[schema.key]);
+                    // An intent-owned ID is new by construction. Requiring a complete
+                    // history/log collection to prove its absence defeats bounded offline
+                    // storage. Authoritative replay still enforces uniqueness.
+                    if (allocated ? changed(table).has(id) : await get(table, id))
+                        throw new Error(`Row ${table}/${id} already exists`);
+                    changed(table).set(id, row);
+                    patches.push({
+                        entity: table,
+                        rowId: id,
+                        op: "insert",
+                        fields: copy(row),
+                    });
+                    return copy(row);
+                },
+                update: async (table, id, input) => {
+                    const schema = tableSchema(table);
+                    if (Object.hasOwn(input, schema.key))
+                        throw new Error("Reducer update cannot change a row id");
+                    const before = await get(table, id);
+                    if (!before)
+                        throw new Error(`Row ${table}/${id} not found`);
+                    const fields = {};
+                    for (const [name, value] of Object.entries(input)) {
+                        if (value === undefined)
+                            continue;
+                        const column = schema.columns[name];
+                        if (!column)
+                            throw new Error(`Unknown column ${table}.${name}`);
+                        fields[name] = columnValue(table, name, column, value);
+                    }
+                    const row = { ...before, ...fields };
+                    if (Object.keys(fields).length) {
+                        changed(table).set(id, row);
+                        patches.push({ entity: table, rowId: id, op: "patch", fields });
+                    }
+                    return copy(row);
+                },
+                delete: async (table, id) => {
+                    if ((await select({ table, columns: [tableSchema(table).key], where: { column: tableSchema(table).key, op: "eq", value: id }, limit: 1 })).length) {
+                        changed(table).set(id, null);
+                        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");
+                        if ((await select({ table, columns: [tableSchema(table).key], where: { column: tableSchema(table).key, op: "eq", value: id }, limit: 1 })).length) {
+                            await context.db.delete(table, id);
+                            deleted++;
+                        }
+                    }
+                    return { deleted };
+                },
+            },
+            actions: {
+                enqueue: async (path, args) => {
+                    const id = await reducerRowId(context, "deferred:action", deferred.filter((d) => d.kind === "action").length);
+                    deferred.push({ id, kind: "action", path, args: copy(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 id = `job_${await reducerRowId(context, "deferred:schedule", deferred.filter((d) => d.kind === "schedule").length)}`;
+                    deferred.push({ id, kind: "schedule", path, args: copy(args), at });
+                    return id;
+                },
+            },
+        };
+        const result = copy(await definition.handler(context, copy(args)));
+        validateValue(definition.options.result, result);
+        return { result, patches, deferred, readTables: [...reads].sort() };
+    }
+}
+//# sourceMappingURL=portable.js.map