@feltdb/core 0.2.0

package/dist/execution.d.ts

@@ -0,0 +1,148 @@
+/**
+ * FeltDB Execution API
+ *
+ * Event-driven execution runtime for triggering capabilities based on
+ * operations or scheduled events.
+ */
+import type { StateFirstDB } from './db.js';
+/**
+ * Execution status
+ */
+export declare enum ExecutionStatus {
+    Pending = "Pending",
+    Running = "Running",
+    Succeeded = "Succeeded",
+    Failed = "Failed",
+    RetryScheduled = "RetryScheduled",
+    DeadLettered = "DeadLettered"
+}
+/**
+ * Retry policy for execution
+ */
+export interface RetryPolicy {
+    /** Maximum number of retry attempts */
+    maxAttempts: number;
+    /** Initial backoff in milliseconds */
+    initialBackoffMs: number;
+    /** Maximum backoff in milliseconds */
+    maxBackoffMs: number;
+    /** Backoff multiplier for exponential backoff */
+    backoffMultiplier: number;
+    /** Timeout per attempt in milliseconds */
+    timeoutMs: number;
+}
+/**
+ * A durable execution record
+ * Tracks the execution of a capability triggered by an operation
+ */
+export interface Execution {
+    /** Unique execution identifier */
+    executionId: string;
+    /** The trigger that caused this execution */
+    triggerId: string;
+    /** Source operation that triggered this execution */
+    sourceOperation: {
+        op_id: number;
+        instance_id: string;
+        sequence: number;
+        op_type: 'Insert' | 'Update' | 'Delete';
+        key: string;
+        value?: any;
+        timestamp_ms: number;
+        rust_type: string;
+        capability: string;
+    };
+    /** Capability to execute */
+    capability: string;
+    /** Attempt number (1-based) */
+    attempt: number;
+    /** Current status */
+    status: ExecutionStatus;
+    /** Optional result value */
+    result?: any;
+    /** Optional error message */
+    error?: string;
+    /** Timestamp when execution was created */
+    created_ms: number;
+    /** Timestamp when execution started */
+    started_ms?: number;
+    /** Timestamp when execution completed */
+    completed_ms?: number;
+    /** Claim token for single-owner execution semantics */
+    claimed_by?: string;
+    /** Retry policy settings */
+    retry_policy: RetryPolicy;
+}
+/**
+ * Capability-scoped execution runtime
+ * Provides restricted execution context for a capability
+ */
+export interface ExecutionContext {
+    /** Execution being performed */
+    execution: Execution;
+    /** Database reference (scoped to capability permissions) */
+    db: StateFirstDB;
+    /** Whether this is a retry attempt */
+    isRetry: boolean;
+    /** Attempt number */
+    attempt: number;
+}
+/**
+ * Execution handler function
+ * Called when an execution event is triggered
+ */
+export type ExecutionHandler = (context: ExecutionContext) => Promise<any>;
+/**
+ * Execution manager for a StateFirstDB instance
+ */
+export interface ExecutionManager {
+    /**
+     * Register a handler for a capability
+     *
+     * @example
+     * execManager.handle("process_order", async (ctx) => {
+     *   const { execution, db } = ctx;
+     *   // Execute capability logic
+     *   return { success: true };
+     * });
+     */
+    handle(capability: string, handler: ExecutionHandler): void;
+    /**
+     * Unregister a handler for a capability
+     */
+    unhandle(capability: string): void;
+    /**
+     * Get pending executions for a capability
+     */
+    getPending(capability?: string): Promise<Execution[]>;
+    /**
+     * Get execution by ID
+     */
+    get(executionId: string): Promise<Execution | null>;
+    /**
+     * Get all executions
+     */
+    all(): Promise<Execution[]>;
+    /**
+     * Mark execution as running
+     */
+    markRunning(executionId: string): Promise<void>;
+    /**
+     * Mark execution as succeeded
+     */
+    markSucceeded(executionId: string, result: any): Promise<void>;
+    /**
+     * Mark execution as failed
+     */
+    markFailed(executionId: string, error: string): Promise<void>;
+    /**
+     * Schedule retry for a failed execution
+     */
+    scheduleRetry(executionId: string): Promise<void>;
+    /**
+     * Process all pending executions
+     * Runs handlers for matched capabilities
+     */
+    processPending(): Promise<number>;
+}
+//# sourceMappingURL=execution.d.ts.map

package/dist/execution.d.ts.map

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

package/dist/execution.js

@@ -0,0 +1,18 @@
+/**
+ * FeltDB Execution API
+ *
+ * Event-driven execution runtime for triggering capabilities based on
+ * operations or scheduled events.
+ */
+/**
+ * Execution status
+ */
+export var ExecutionStatus;
+(function (ExecutionStatus) {
+    ExecutionStatus["Pending"] = "Pending";
+    ExecutionStatus["Running"] = "Running";
+    ExecutionStatus["Succeeded"] = "Succeeded";
+    ExecutionStatus["Failed"] = "Failed";
+    ExecutionStatus["RetryScheduled"] = "RetryScheduled";
+    ExecutionStatus["DeadLettered"] = "DeadLettered";
+})(ExecutionStatus || (ExecutionStatus = {}));

package/dist/feltdb.d.ts

@@ -0,0 +1,82 @@
+/**
+ * WASM FeltDB Binding
+ *
+ * This is the FFI interface to the Rust WASM implementation.
+ */
+/**
+ * WASM database instance
+ */
+export interface JsDb {
+    /**
+     * Execute an operation
+     */
+    execute_op(operation: any): any;
+    /**
+     * Get sync info
+     */
+    sync_info(): any;
+    /**
+     * Add a peer
+     */
+    add_peer(peer_id: string): any;
+    /**
+     * Add sync peer
+     */
+    add_sync_peer(peer_id: string): any;
+    /**
+     * Remove sync peer
+     */
+    remove_sync_peer(peer_id: string): any;
+    /**
+     * Get pending operations for peer
+     */
+    get_pending_for_peer(peer_id: string, since_sequence: number): any;
+    /**
+     * Acknowledge peer operations
+     */
+    acknowledge_peer_operations(peer_id: string, sequence: number): any;
+    /**
+     * Query data
+     */
+    query(query: string): any | Promise<any>;
+    /**
+     * Get a record
+     */
+    get(key: string): any | Promise<any>;
+    /**
+     * Insert a record
+     */
+    insert(key: string, value: string): any | Promise<any>;
+    /** Update a record without changing collection semantics. */
+    update?(key: string, value: string): any | Promise<any>;
+    /** Delete a record when supported by the runtime. */
+    delete?(key: string): any | Promise<any>;
+    /** Subscribe to runtime-originated changes, including remote mutations. */
+    subscribe_changes?(callback: (collection: string) => void): () => void;
+    close?(): void | Promise<void>;
+    /**
+     * Get capability records
+     */
+    get_capability_records(capability: string): any;
+    /**
+     * Get instance ID
+     */
+    instance_id(): string;
+    /**
+     * Get sequence number
+     */
+    get_sequence(): number;
+    /** Read durable mutation events when the runtime exposes an audit log. */
+    audit_events?(): any | Promise<any>;
+    /** Export and merge portable embedded-runtime operations. */
+    export_operations?(since_sequence: number): any | Promise<any>;
+    apply_remote_operations?(operations: any[]): any | Promise<any>;
+}
+/**
+ * A row stored in the database
+ */
+export interface StoredRow {
+    id: string | number;
+    [key: string]: any;
+}
+//# sourceMappingURL=feltdb.d.ts.map

package/dist/feltdb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feltdb.d.ts","sourceRoot":"","sources":["../src/feltdb.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,GAAG,GAAG,GAAG,CAAC;IAEhC;;OAEG;IACH,SAAS,IAAI,GAAG,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC;IAE/B;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC;IAEpC;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC;IAEvC;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,GAAG,CAAC;IAEnE;;OAEG;IACH,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;IAEpE;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEzC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAErC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEvD,6DAA6D;IAC7D,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAExD,qDAAqD;IACrD,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEzC,2EAA2E;IAC3E,iBAAiB,CAAC,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACvE,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B;;OAEG;IACH,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC;IAEhD;;OAEG;IACH,WAAW,IAAI,MAAM,CAAC;IAEtB;;OAEG;IACH,YAAY,IAAI,MAAM,CAAC;IAEvB,0EAA0E;IAC1E,YAAY,CAAC,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEpC,6DAA6D;IAC7D,iBAAiB,CAAC,CAAC,cAAc,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/D,uBAAuB,CAAC,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB"}

package/dist/feltdb.js

@@ -0,0 +1,6 @@
+/**
+ * WASM FeltDB Binding
+ *
+ * This is the FFI interface to the Rust WASM implementation.
+ */
+export {};

package/dist/flowspec.d.ts

@@ -0,0 +1,64 @@
+export interface FlowField {
+    name: string;
+    type: string;
+    optional: boolean;
+}
+export interface FlowIndex {
+    name: string;
+    kind: string;
+    expression: string;
+}
+export interface FlowCollection {
+    name: string;
+    fields: FlowField[];
+    indexes: FlowIndex[];
+}
+export interface FlowBlock {
+    name: string;
+    statements: string[];
+}
+export interface FlowStep extends FlowBlock {
+}
+export interface FlowWorkflow {
+    name: string;
+    parameters: string;
+    steps: FlowStep[];
+}
+export interface FlowTrigger {
+    event: string;
+    statements: string[];
+}
+export interface FlowSpec {
+    version: 1;
+    app: string;
+    collections: FlowCollection[];
+    capabilities: FlowBlock[];
+    agents: FlowBlock[];
+    workflows: FlowWorkflow[];
+    triggers: FlowTrigger[];
+    policies: FlowBlock[];
+    schedules: FlowBlock[];
+}
+export interface FlowDiagnostic {
+    severity: 'error' | 'warning';
+    message: string;
+    path?: string;
+}
+export interface FlowSpecDiff {
+    added: string[];
+    removed: string[];
+    changed: string[];
+}
+export interface FlowMigrationOperation {
+    kind: 'add' | 'change' | 'remove';
+    target: string;
+    safety: 'safe' | 'requires_transform' | 'destructive';
+    detail: string;
+}
+export declare function parseFlowSpec(source: string): FlowSpec;
+export declare function validateFlowSpec(spec: FlowSpec): FlowDiagnostic[];
+export declare function formatFlowSpec(spec: FlowSpec): string;
+export declare function diffFlowSpec(before: FlowSpec, after: FlowSpec): FlowSpecDiff;
+export declare function planFlowSpecMigration(before: FlowSpec, after: FlowSpec): FlowMigrationOperation[];
+export declare function emptyFlowSpec(app?: string): FlowSpec;
+//# sourceMappingURL=flowspec.d.ts.map

package/dist/flowspec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowspec.d.ts","sourceRoot":"","sources":["../src/flowspec.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE;AAC5E,MAAM,WAAW,SAAS;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AAC7E,MAAM,WAAW,cAAc;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,EAAE,CAAC;IAAC,OAAO,EAAE,SAAS,EAAE,CAAA;CAAE;AAC3F,MAAM,WAAW,SAAS;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE;AACjE,MAAM,WAAW,QAAS,SAAQ,SAAS;CAAG;AAC9C,MAAM,WAAW,YAAY;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,QAAQ,EAAE,CAAA;CAAE;AACrF,MAAM,WAAW,WAAW;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE;AACpE,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,CAAC,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,SAAS,EAAE,SAAS,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAAG,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AACjG,MAAM,WAAW,YAAY;IAAG,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE;AACvF,MAAM,WAAW,sBAAsB;IAAG,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,GAAG,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAyFpK,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAA4C;AAEnG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,EAAE,CAWjE;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAUrD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,GAAG,YAAY,CAQ5E;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,GAAG,sBAAsB,EAAE,CAsBjG;AAED,wBAAgB,aAAa,CAAC,GAAG,SAAU,GAAG,QAAQ,CAAyI"}

package/dist/flowspec.js

@@ -0,0 +1,272 @@
+function lex(source) {
+    const tokens = [];
+    let line = 1;
+    for (let index = 0; index < source.length;) {
+        const char = source[index];
+        if (char === '\n') {
+            tokens.push({ value: '\n', line });
+            line++;
+            index++;
+            continue;
+        }
+        if (/\s/.test(char)) {
+            index++;
+            continue;
+        }
+        if (source.startsWith('//', index)) {
+            while (index < source.length && source[index] !== '\n')
+                index++;
+            continue;
+        }
+        if (char === '"') {
+            let value = '"';
+            index++;
+            while (index < source.length) {
+                const next = source[index++];
+                value += next;
+                if (next === '\\' && index < source.length)
+                    value += source[index++];
+                else if (next === '"')
+                    break;
+            }
+            tokens.push({ value, line });
+            continue;
+        }
+        const arrow = source.slice(index, index + 2);
+        if (arrow === '->') {
+            tokens.push({ value: arrow, line });
+            index += 2;
+            continue;
+        }
+        if ('{}():?,'.includes(char)) {
+            tokens.push({ value: char, line });
+            index++;
+            continue;
+        }
+        let value = '';
+        while (index < source.length && !/\s/.test(source[index]) && !'{}():?,'.includes(source[index]))
+            value += source[index++];
+        tokens.push({ value, line });
+    }
+    return tokens;
+}
+class Parser {
+    constructor(tokens) {
+        this.tokens = tokens;
+        this.index = 0;
+    }
+    peek(value) { return this.index < this.tokens.length && (value === undefined || this.tokens[this.index].value === value); }
+    take(value) { const token = this.tokens[this.index++]; if (!token || (value && token.value !== value))
+        throw new Error(`Expected ${value ?? 'token'} at line ${token?.line ?? 'EOF'}`); return token; }
+    newlines() { while (this.peek('\n'))
+        this.take(); }
+    identifier() { const token = this.take(); if (!/^[A-Za-z_][A-Za-z0-9_-]*$/.test(token.value))
+        throw new Error(`Invalid identifier ${token.value} at line ${token.line}`); return token.value; }
+    line() {
+        const values = [];
+        while (this.peek() && !this.peek('\n') && !this.peek('}'))
+            values.push(this.take().value);
+        this.newlines();
+        return values.join(' ').replace(/\s+([,?)])/g, '$1').replace(/([(])\s+/g, '$1').trim();
+    }
+    statements() {
+        this.take('{');
+        this.newlines();
+        const output = [];
+        while (!this.peek('}')) {
+            const statement = this.line();
+            if (statement)
+                output.push(statement);
+            else if (!this.peek())
+                throw new Error('Unclosed block');
+        }
+        this.take('}');
+        this.newlines();
+        return output;
+    }
+    parse() {
+        this.newlines();
+        this.take('app');
+        const app = this.identifier();
+        this.take('{');
+        this.newlines();
+        const spec = { version: 1, app, collections: [], capabilities: [], agents: [], workflows: [], triggers: [], policies: [], schedules: [] };
+        while (!this.peek('}')) {
+            const kind = this.take().value;
+            if (kind === 'collection')
+                spec.collections.push(this.collection());
+            else if (kind === 'workflow')
+                spec.workflows.push(this.workflow());
+            else if (kind === 'trigger')
+                spec.triggers.push(this.trigger());
+            else if (['capability', 'agent', 'policy', 'schedule'].includes(kind)) {
+                const block = { name: this.identifier(), statements: this.statements() };
+                if (kind === 'capability')
+                    spec.capabilities.push(block);
+                else if (kind === 'agent')
+                    spec.agents.push(block);
+                else if (kind === 'policy')
+                    spec.policies.push(block);
+                else
+                    spec.schedules.push(block);
+            }
+            else
+                throw new Error(`Unknown declaration ${kind} at line ${this.tokens[this.index - 1].line}`);
+            this.newlines();
+        }
+        this.take('}');
+        this.newlines();
+        if (this.peek())
+            throw new Error(`Unexpected token ${this.take().value}`);
+        return spec;
+    }
+    collection() {
+        const name = this.identifier();
+        this.take('{');
+        this.newlines();
+        const fields = [];
+        const indexes = [];
+        while (!this.peek('}')) {
+            const first = this.identifier();
+            if (first === 'index') {
+                const indexName = this.identifier();
+                this.take('using');
+                const kind = this.identifier();
+                const expression = this.line();
+                indexes.push({ name: indexName, kind, expression });
+            }
+            else {
+                this.take(':');
+                const typeParts = [];
+                while (this.peek() && !this.peek('\n') && !this.peek('}'))
+                    typeParts.push(this.take().value);
+                this.newlines();
+                let optional = false;
+                if (typeParts.at(-1) === '?') {
+                    optional = true;
+                    typeParts.pop();
+                }
+                fields.push({ name: first, type: typeParts.join(' ').replace(/\s+([,)])/g, '$1').replace(/([(])\s+/g, '$1'), optional });
+            }
+        }
+        this.take('}');
+        this.newlines();
+        return { name, fields, indexes };
+    }
+    workflow() {
+        const name = this.identifier();
+        let parameters = '';
+        if (this.peek('(')) {
+            this.take();
+            const values = [];
+            while (!this.peek(')'))
+                values.push(this.take().value);
+            this.take(')');
+            parameters = values.join(' ').replace(/\s+([,])/g, '$1');
+        }
+        this.take('{');
+        this.newlines();
+        const steps = [];
+        while (!this.peek('}')) {
+            this.take('step');
+            const step = this.identifier();
+            steps.push({ name: step, statements: this.statements() });
+        }
+        this.take('}');
+        this.newlines();
+        return { name, parameters, steps };
+    }
+    trigger() {
+        this.take('on');
+        const eventParts = [];
+        while (!this.peek('{'))
+            eventParts.push(this.take().value);
+        return { event: eventParts.join(' '), statements: this.statements() };
+    }
+}
+export function parseFlowSpec(source) { return new Parser(lex(source)).parse(); }
+export function validateFlowSpec(spec) {
+    const diagnostics = [];
+    const duplicate = (kind, values) => values.filter((value, index) => values.indexOf(value) !== index).forEach(value => diagnostics.push({ severity: 'error', message: `Duplicate ${kind}: ${value}` }));
+    duplicate('collection', spec.collections.map(value => value.name));
+    duplicate('capability', spec.capabilities.map(value => value.name));
+    duplicate('agent', spec.agents.map(value => value.name));
+    duplicate('workflow', spec.workflows.map(value => value.name));
+    const collections = new Set(spec.collections.map(value => value.name));
+    for (const collection of spec.collections) {
+        duplicate(`field in ${collection.name}`, collection.fields.map(value => value.name));
+        for (const field of collection.fields)
+            if (field.type.startsWith('ref ') && !collections.has(field.type.slice(4)))
+                diagnostics.push({ severity: 'error', path: `${collection.name}.${field.name}`, message: `Unknown referenced collection ${field.type.slice(4)}` });
+    }
+    for (const workflow of spec.workflows) {
+        duplicate(`step in ${workflow.name}`, workflow.steps.map(value => value.name));
+        if (!workflow.steps.length)
+            diagnostics.push({ severity: 'error', message: `Workflow ${workflow.name} has no steps` });
+    }
+    return diagnostics;
+}
+function block(kind, value, indent = '  ') { return `${indent}${kind} ${value.name} {\n${value.statements.map(line => `${indent}  ${line}`).join('\n')}\n${indent}}`; }
+export function formatFlowSpec(spec) {
+    const declarations = [];
+    for (const value of spec.collections)
+        declarations.push(`  collection ${value.name} {\n${value.fields.map(field => `    ${field.name}: ${field.type}${field.optional ? '?' : ''}`).concat(value.indexes.map(index => `    index ${index.name} using ${index.kind} ${index.expression}`)).join('\n')}\n  }`);
+    for (const value of spec.capabilities)
+        declarations.push(block('capability', value));
+    for (const value of spec.agents)
+        declarations.push(block('agent', value));
+    for (const value of spec.workflows)
+        declarations.push(`  workflow ${value.name}${value.parameters ? `(${value.parameters})` : ''} {\n${value.steps.map(step => `    step ${step.name} {\n${step.statements.map(line => `      ${line}`).join('\n')}\n    }`).join('\n')}\n  }`);
+    for (const value of spec.triggers)
+        declarations.push(`  trigger on ${value.event} {\n${value.statements.map(line => `    ${line}`).join('\n')}\n  }`);
+    for (const value of spec.policies)
+        declarations.push(block('policy', value));
+    for (const value of spec.schedules)
+        declarations.push(block('schedule', value));
+    return `app ${spec.app} {\n${declarations.join('\n\n')}\n}\n`;
+}
+export function diffFlowSpec(before, after) {
+    const flatten = (spec) => new Map([
+        ...spec.collections.map(value => [`collection ${value.name}`, JSON.stringify(value)]), ...spec.capabilities.map(value => [`capability ${value.name}`, JSON.stringify(value)]),
+        ...spec.agents.map(value => [`agent ${value.name}`, JSON.stringify(value)]), ...spec.workflows.map(value => [`workflow ${value.name}`, JSON.stringify(value)]),
+        ...spec.triggers.map(value => [`trigger ${value.event}`, JSON.stringify(value)]), ...spec.policies.map(value => [`policy ${value.name}`, JSON.stringify(value)]), ...spec.schedules.map(value => [`schedule ${value.name}`, JSON.stringify(value)]),
+    ]);
+    const left = flatten(before), right = flatten(after);
+    return { added: [...right.keys()].filter(key => !left.has(key)), removed: [...left.keys()].filter(key => !right.has(key)), changed: [...right.keys()].filter(key => left.has(key) && left.get(key) !== right.get(key)) };
+}
+export function planFlowSpecMigration(before, after) {
+    const operations = [];
+    const oldCollections = new Map(before.collections.map(value => [value.name, value]));
+    const newCollections = new Map(after.collections.map(value => [value.name, value]));
+    for (const [name, collection] of newCollections) {
+        const previous = oldCollections.get(name);
+        if (!previous) {
+            operations.push({ kind: 'add', target: `collection ${name}`, safety: 'safe', detail: 'Create collection model' });
+            continue;
+        }
+        const oldFields = new Map(previous.fields.map(value => [value.name, value]));
+        const newFields = new Map(collection.fields.map(value => [value.name, value]));
+        for (const [field, definition] of newFields) {
+            const old = oldFields.get(field);
+            if (!old)
+                operations.push({ kind: 'add', target: `${name}.${field}`, safety: definition.optional ? 'safe' : 'requires_transform', detail: definition.optional ? 'Add optional field' : 'Required field needs a backfill' });
+            else if (old.type !== definition.type || old.optional !== definition.optional)
+                operations.push({ kind: 'change', target: `${name}.${field}`, safety: 'requires_transform', detail: `${old.type}${old.optional ? '?' : ''} → ${definition.type}${definition.optional ? '?' : ''}` });
+        }
+        for (const field of oldFields.keys())
+            if (!newFields.has(field))
+                operations.push({ kind: 'remove', target: `${name}.${field}`, safety: 'destructive', detail: 'Field is no longer declared' });
+    }
+    for (const name of oldCollections.keys())
+        if (!newCollections.has(name))
+            operations.push({ kind: 'remove', target: `collection ${name}`, safety: 'destructive', detail: 'Collection model is no longer declared' });
+    const diff = diffFlowSpec(before, after);
+    for (const target of diff.added.filter(value => !value.startsWith('collection ')))
+        operations.push({ kind: 'add', target, safety: 'safe', detail: 'Deploy application primitive' });
+    for (const target of diff.changed.filter(value => !value.startsWith('collection ')))
+        operations.push({ kind: 'change', target, safety: 'safe', detail: 'Version application primitive' });
+    for (const target of diff.removed.filter(value => !value.startsWith('collection ')))
+        operations.push({ kind: 'remove', target, safety: 'destructive', detail: 'Application primitive is no longer declared' });
+    return operations;
+}
+export function emptyFlowSpec(app = 'MyApp') { return { version: 1, app, collections: [], capabilities: [], agents: [], workflows: [], triggers: [], policies: [], schedules: [] }; }

package/dist/http-db.d.ts

@@ -0,0 +1,50 @@
+import type { JsDb } from './feltdb.js';
+interface JsResult {
+    success: boolean;
+    data?: string;
+    error?: string;
+}
+interface HttpRuntimeOptions {
+    url: string;
+    token: string;
+}
+/** Network adapter implementing the same collection runtime contract as WASM. */
+export declare class HttpJsDb implements JsDb {
+    private readonly url;
+    private readonly token;
+    constructor(options: HttpRuntimeOptions);
+    private headers;
+    private splitKey;
+    get(key: string): Promise<JsResult>;
+    query(collection: string): Promise<JsResult>;
+    insert(key: string, value: string): Promise<JsResult>;
+    update(key: string, value: string): Promise<JsResult>;
+    delete(key: string): Promise<JsResult>;
+    /** Acquire a reference through the server's causal peer fabric. */
+    acquire(collection: string, id: string): Promise<unknown | null>;
+    /** Execute the built-in state-derived search capability remotely. */
+    search(collection: string, query: string, limit?: number): Promise<unknown[]>;
+    provenance(collection: string, id: string): Promise<any>;
+    storeContent(content: Uint8Array): Promise<{
+        hash: string;
+        bytes: number;
+        ref: string;
+    }>;
+    acquireContent(hash: string): Promise<Uint8Array | null>;
+    command(path: string, body: unknown): Promise<any>;
+    subscribe_changes(callback: (collection: string) => void): () => void;
+    private consumeEvents;
+    private failure;
+    get_capability_records(capability: string): Promise<JsResult>;
+    execute_op(): JsResult;
+    sync_info(): JsResult;
+    add_peer(): JsResult;
+    add_sync_peer(): JsResult;
+    remove_sync_peer(): JsResult;
+    get_pending_for_peer(): JsResult;
+    acknowledge_peer_operations(): JsResult;
+    instance_id(): string;
+    get_sequence(): number;
+}
+export {};
+//# sourceMappingURL=http-db.d.ts.map

package/dist/http-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-db.d.ts","sourceRoot":"","sources":["../src/http-db.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC,UAAU,QAAQ;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,kBAAkB;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,iFAAiF;AACjF,qBAAa,QAAS,YAAW,IAAI;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,EAAE,kBAAkB;IAKvC,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,QAAQ;IAQV,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAenC,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAa5C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAgBrD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAerD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAa5C,mEAAmE;IAC7D,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAOtE,qEAAqE;IAC/D,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAQzE,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAMxD,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAMxF,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAOxD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;IAQxD,iBAAiB,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;YAMvD,aAAa;YA+Bb,OAAO;IASrB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC7D,UAAU,IAAI,QAAQ;IACtB,SAAS,IAAI,QAAQ;IACrB,QAAQ,IAAI,QAAQ;IACpB,aAAa,IAAI,QAAQ;IACzB,gBAAgB,IAAI,QAAQ;IAC5B,oBAAoB,IAAI,QAAQ;IAChC,2BAA2B,IAAI,QAAQ;IACvC,WAAW,IAAI,MAAM;IACrB,YAAY,IAAI,MAAM;CACvB"}