@nexus_js/sync 0.7.1 → 0.7.4

package/README.md

@@ -1,6 +1,43 @@
 # @nexus_js/sync
 
-Nexus Local-First Sync Engine — IndexedDB-backed optimistic mutations with conflict resolution.
+Nexus Local-First Sync — two tracks:
+
+1. **`$localSync` / `syncEngine`** — IndexedDB + JSON ops queue + `fetch` flush (production-ready baseline).
+2. **Byte-Mirror (prototype)** — SQLite WASM inside a **dedicated Web Worker**, with **OPFS** persistence when the host sends COOP/COEP headers (otherwise `:memory:` fallback).
+
+## Byte-Mirror (SQLite worker)
+
+```ts
+import {
+  ByteMirrorBridge,
+  resolveSqliteSyncWorkerUrl,
+} from '@nexus_js/sync';
+
+const bridge = new ByteMirrorBridge(resolveSqliteSyncWorkerUrl());
+await bridge.init();
+await bridge.upsertNode({
+  id: 'n1',
+  flowId: 'f1',
+  x: 120,
+  y: 40,
+  data: { label: 'Start' },
+});
+const rows = await bridge.listNodes('f1');
+const outbox = await bridge.drainOutbox(20);
+// POST `outbox[].frame_json` to your Server Action, then:
+await bridge.markOutboxSynced(outbox.map((r) => r.id));
+```
+
+**Security:** the worker never executes arbitrary SQL from the page — only whitelisted ops (`UPSERT_NODE`, `DELETE_NODE`, …).
+
+**OPFS:** for durable local SQLite, serve your app with:
+
+- `Cross-Origin-Opener-Policy: same-origin`
+- `Cross-Origin-Embedder-Policy: require-corp` (or `credentialless` if compatible with your assets)
+
+**Bundlers:** prefer `new Worker(new URL('@nexus_js/sync/workers/sqlite-sync.worker.js', import.meta.url), { type: 'module' })` or Vite’s `?worker` so `@sqlite.org/sqlite-wasm` and `.wasm` resolve correctly.
+
+Next steps (not in this package yet): binary ChangeSet protocol, server-side merge / LWW, AES-GCM at rest, and a compiler-backed `$mirror` rune.
 
 ## Documentation
 

package/dist/byte-mirror-bridge.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Main-thread bridge to the SQLite WASM sync worker (`workers/sqlite-sync.worker.ts`).
+ */
+import type { ByteMirrorStorageMode, FlowNodePayload, FlowNodeRow, OutboxRow } from './byte-mirror-protocol.js';
+/** Resolve the bundled worker script URL (works from `dist/index.js` in the published package). */
+export declare function resolveSqliteSyncWorkerUrl(): URL;
+/**
+ * Typed façade over the SQLite WASM worker. Instantiate with
+ * `new ByteMirrorBridge(resolveSqliteSyncWorkerUrl())` or a Vite `?worker` URL.
+ */
+export declare class ByteMirrorBridge {
+    #private;
+    private readonly worker;
+    private readonly pending;
+    constructor(workerUrl: URL | string);
+    /** Boot SQLite + schema. Call once before other methods. */
+    init(opts?: {
+        dbFilename?: string;
+    }): Promise<{
+        storage: ByteMirrorStorageMode;
+    }>;
+    upsertNode(payload: FlowNodePayload): Promise<void>;
+    deleteNode(id: string): Promise<void>;
+    listNodes(flowId: string): Promise<FlowNodeRow[]>;
+    /** Pull pending sync frames (JSON) to POST to your Server Action. */
+    drainOutbox(limit?: number): Promise<OutboxRow[]>;
+    /** After the server ACKs frames, remove them from the local outbox. */
+    markOutboxSynced(ids: number[]): Promise<void>;
+    terminate(): void;
+}
+//# sourceMappingURL=byte-mirror-bridge.d.ts.map

package/dist/byte-mirror-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"byte-mirror-bridge.d.ts","sourceRoot":"","sources":["../src/byte-mirror-bridge.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,SAAS,EAGV,MAAM,2BAA2B,CAAC;AAEnC,mGAAmG;AACnG,wBAAgB,0BAA0B,IAAI,GAAG,CAEhD;AAID;;;GAGG;AACH,qBAAa,gBAAgB;;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;gBAE1C,SAAS,EAAE,GAAG,GAAG,MAAM;IAqCnC,4DAA4D;IACtD,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,qBAAqB,CAAA;KAAE,CAAC;IAWjF,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAOvD,qEAAqE;IAC/D,WAAW,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAOnD,uEAAuE;IACjE,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpD,SAAS,IAAI,IAAI;CAIlB"}

package/dist/byte-mirror-bridge.js

@@ -0,0 +1,100 @@
+/**
+ * Main-thread bridge to the SQLite WASM sync worker (`workers/sqlite-sync.worker.ts`).
+ */
+/** Resolve the bundled worker script URL (works from `dist/index.js` in the published package). */
+export function resolveSqliteSyncWorkerUrl() {
+    return new URL('./workers/sqlite-sync.worker.js', import.meta.url);
+}
+/**
+ * Typed façade over the SQLite WASM worker. Instantiate with
+ * `new ByteMirrorBridge(resolveSqliteSyncWorkerUrl())` or a Vite `?worker` URL.
+ */
+export class ByteMirrorBridge {
+    worker;
+    pending = new Map();
+    constructor(workerUrl) {
+        const url = typeof workerUrl === 'string' ? workerUrl : workerUrl.href;
+        this.worker = new Worker(url, { type: 'module' });
+        this.worker.onmessage = (ev) => {
+            const data = ev.data;
+            const p = this.pending.get(data.requestId);
+            if (!p)
+                return;
+            this.pending.delete(data.requestId);
+            if (data.type === 'ERROR') {
+                p.reject(new Error(data.message));
+                return;
+            }
+            p.resolve(data);
+        };
+        this.worker.onmessageerror = () => {
+            this.#rejectAll(new Error('Worker message deserialization error'));
+        };
+        this.worker.addEventListener('error', (e) => {
+            const err = e.error instanceof Error ? e.error : new Error('Worker crashed');
+            this.#rejectAll(err);
+        });
+    }
+    #rejectAll(err) {
+        for (const [, p] of this.pending) {
+            p.reject(err);
+        }
+        this.pending.clear();
+    }
+    #post(msg) {
+        return new Promise((resolve, reject) => {
+            this.pending.set(msg.requestId, { resolve, reject });
+            this.worker.postMessage(msg);
+        });
+    }
+    /** Boot SQLite + schema. Call once before other methods. */
+    async init(opts) {
+        const requestId = crypto.randomUUID();
+        const initMsg = opts?.dbFilename !== undefined
+            ? { type: 'INIT', requestId, dbFilename: opts.dbFilename }
+            : { type: 'INIT', requestId };
+        const res = await this.#post(initMsg);
+        if (res.type !== 'READY')
+            throw new Error(`[ByteMirror] expected READY, got ${res.type}`);
+        return { storage: res.storage };
+    }
+    async upsertNode(payload) {
+        const requestId = crypto.randomUUID();
+        const res = await this.#post({ type: 'UPSERT_NODE', requestId, payload });
+        if (res.type !== 'ACK')
+            throw new Error(`[ByteMirror] expected ACK, got ${res.type}`);
+    }
+    async deleteNode(id) {
+        const requestId = crypto.randomUUID();
+        const res = await this.#post({ type: 'DELETE_NODE', requestId, payload: { id } });
+        if (res.type !== 'ACK')
+            throw new Error(`[ByteMirror] expected ACK, got ${res.type}`);
+    }
+    async listNodes(flowId) {
+        const requestId = crypto.randomUUID();
+        const res = await this.#post({ type: 'LIST_NODES', requestId, payload: { flowId } });
+        if (res.type !== 'NODES')
+            throw new Error(`[ByteMirror] expected NODES, got ${res.type}`);
+        return res.rows;
+    }
+    /** Pull pending sync frames (JSON) to POST to your Server Action. */
+    async drainOutbox(limit = 50) {
+        const requestId = crypto.randomUUID();
+        const res = await this.#post({ type: 'DRAIN_OUTBOX', requestId, payload: { limit } });
+        if (res.type !== 'OUTBOX')
+            throw new Error(`[ByteMirror] expected OUTBOX, got ${res.type}`);
+        return res.rows;
+    }
+    /** After the server ACKs frames, remove them from the local outbox. */
+    async markOutboxSynced(ids) {
+        const requestId = crypto.randomUUID();
+        const res = await this.#post({ type: 'MARK_OUTBOX_SYNCED', requestId, payload: { ids } });
+        if (res.type !== 'ACK')
+            throw new Error(`[ByteMirror] expected ACK, got ${res.type}`);
+    }
+    terminate() {
+        this.worker.terminate();
+        this.pending.clear();
+    }
+}
+//# sourceMappingURL=byte-mirror-bridge.js.map

package/dist/byte-mirror-bridge.js.map

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

package/dist/byte-mirror-protocol.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Byte-Mirror — typed messages between the main thread and the SQLite sync worker.
+ * No arbitrary SQL crosses this boundary: only whitelisted mutation kinds (see worker).
+ */
+export type ByteMirrorStorageMode = 'opfs' | 'memory';
+/** Payload for flow-editor style nodes (NexusFlow-oriented). */
+export interface FlowNodePayload {
+    id: string;
+    flowId: string;
+    x: number;
+    y: number;
+    /** Extra JSON-serializable fields (ports, label, etc.) */
+    data?: Record<string, unknown>;
+}
+export type SqliteSyncWorkerInboundMessage = {
+    type: 'INIT';
+    requestId: string;
+    dbFilename?: string;
+} | {
+    type: 'UPSERT_NODE';
+    requestId: string;
+    payload: FlowNodePayload;
+} | {
+    type: 'DELETE_NODE';
+    requestId: string;
+    payload: {
+        id: string;
+    };
+} | {
+    type: 'LIST_NODES';
+    requestId: string;
+    payload: {
+        flowId: string;
+    };
+} | {
+    type: 'DRAIN_OUTBOX';
+    requestId: string;
+    payload: {
+        limit: number;
+    };
+} | {
+    type: 'MARK_OUTBOX_SYNCED';
+    requestId: string;
+    payload: {
+        ids: number[];
+    };
+};
+export type FlowNodeRow = {
+    id: string;
+    flow_id: string;
+    x: number;
+    y: number;
+    data_json: string;
+    updated_at: number;
+};
+export type OutboxRow = {
+    id: number;
+    frame_json: string;
+    created_at: number;
+};
+export type SqliteSyncWorkerOutboundMessage = {
+    type: 'READY';
+    requestId: string;
+    storage: ByteMirrorStorageMode;
+} | {
+    type: 'ACK';
+    requestId: string;
+} | {
+    type: 'NODES';
+    requestId: string;
+    rows: FlowNodeRow[];
+} | {
+    type: 'OUTBOX';
+    requestId: string;
+    rows: OutboxRow[];
+} | {
+    type: 'ERROR';
+    requestId: string;
+    message: string;
+};
+//# sourceMappingURL=byte-mirror-protocol.d.ts.map

package/dist/byte-mirror-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"byte-mirror-protocol.d.ts","sourceRoot":"","sources":["../src/byte-mirror-protocol.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEtD,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,MAAM,8BAA8B,GACtC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;CAAE,CAAC;AAElF,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,MAAM,MAAM,+BAA+B,GACvC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,qBAAqB,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,EAAE,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,EAAE,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/byte-mirror-protocol.js

@@ -0,0 +1,6 @@
+/**
+ * Byte-Mirror — typed messages between the main thread and the SQLite sync worker.
+ * No arbitrary SQL crosses this boundary: only whitelisted mutation kinds (see worker).
+ */
+export {};
+//# sourceMappingURL=byte-mirror-protocol.js.map

package/dist/byte-mirror-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"byte-mirror-protocol.js","sourceRoot":"","sources":["../src/byte-mirror-protocol.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/byte-mirror-protocol.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=byte-mirror-protocol.test.d.ts.map

package/dist/byte-mirror-protocol.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"byte-mirror-protocol.test.d.ts","sourceRoot":"","sources":["../src/byte-mirror-protocol.test.ts"],"names":[],"mappings":""}

package/dist/byte-mirror-protocol.test.js

@@ -0,0 +1,49 @@
+import { describe, it, expect } from 'vitest';
+describe('byte-mirror-protocol', () => {
+    it('round-trips representative inbound messages as JSON', () => {
+        const messages = [
+            { type: 'INIT', requestId: 'r1' },
+            { type: 'INIT', requestId: 'r2', dbFilename: '/custom.sqlite' },
+            {
+                type: 'UPSERT_NODE',
+                requestId: 'r3',
+                payload: { id: 'n1', flowId: 'f1', x: 1, y: 2, data: { label: 'a' } },
+            },
+            { type: 'DELETE_NODE', requestId: 'r4', payload: { id: 'n1' } },
+            { type: 'LIST_NODES', requestId: 'r5', payload: { flowId: 'f1' } },
+            { type: 'DRAIN_OUTBOX', requestId: 'r6', payload: { limit: 10 } },
+            { type: 'MARK_OUTBOX_SYNCED', requestId: 'r7', payload: { ids: [1, 2] } },
+        ];
+        for (const m of messages) {
+            const copy = JSON.parse(JSON.stringify(m));
+            expect(copy).toEqual(m);
+        }
+    });
+    it('round-trips representative outbound messages', () => {
+        const out = [
+            { type: 'READY', requestId: 'a', storage: 'memory' },
+            { type: 'READY', requestId: 'b', storage: 'opfs' },
+            { type: 'ACK', requestId: 'c' },
+            {
+                type: 'NODES',
+                requestId: 'd',
+                rows: [
+                    {
+                        id: '1',
+                        flow_id: 'f',
+                        x: 0,
+                        y: 0,
+                        data_json: '{}',
+                        updated_at: 1,
+                    },
+                ],
+            },
+            { type: 'OUTBOX', requestId: 'e', rows: [{ id: 1, frame_json: '{}', created_at: 2 }] },
+            { type: 'ERROR', requestId: 'f', message: 'x' },
+        ];
+        for (const m of out) {
+            expect(JSON.parse(JSON.stringify(m))).toEqual(m);
+        }
+    });
+});
+//# sourceMappingURL=byte-mirror-protocol.test.js.map

package/dist/byte-mirror-protocol.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"byte-mirror-protocol.test.js","sourceRoot":"","sources":["../src/byte-mirror-protocol.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAM9C,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,QAAQ,GAAqC;YACjD,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE;YACjC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,gBAAgB,EAAE;YAC/D;gBACE,IAAI,EAAU,aAAa;gBAC3B,SAAS,EAAK,IAAI;gBAClB,OAAO,EAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;aAC3E;YACD,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;YAC/D,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YAClE,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YACjE,EAAE,IAAI,EAAE,oBAAoB,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;SAC1E,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAmC,CAAC;YAC7E,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,GAAG,GAAsC;YAC7C,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE;YACpD,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE;YAClD,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE;YAC/B;gBACE,IAAI,EAAO,OAAO;gBAClB,SAAS,EAAE,GAAG;gBACd,IAAI,EAAO;oBACT;wBACE,EAAE,EAAU,GAAG;wBACf,OAAO,EAAK,GAAG;wBACf,CAAC,EAAW,CAAC;wBACb,CAAC,EAAW,CAAC;wBACb,SAAS,EAAG,IAAI;wBAChB,UAAU,EAAE,CAAC;qBACd;iBACF;aACF;YACD,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,EAAE;YACtF,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE;SAChD,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -8,6 +8,9 @@ export { syncEngine, NexusSyncEngine } from './engine.js';
 export type { SyncOp, SyncStatus, SyncCollectionOpts, ConflictInfo } from './engine.js';
 export { $localSync } from './rune.js';
 export type { LocalSyncState, LocalSyncOpts } from './rune.js';
+/** Byte-Mirror — SQLite WASM in a worker (OPFS / memory fallback). */
+export { ByteMirrorBridge, resolveSqliteSyncWorkerUrl, } from './byte-mirror-bridge.js';
+export type { ByteMirrorStorageMode, FlowNodePayload, FlowNodeRow, OutboxRow, SqliteSyncWorkerInboundMessage, SqliteSyncWorkerOutboundMessage, } from './byte-mirror-protocol.js';
 /** Convenience: check if the browser is currently online. */
 export declare const isOnline: () => boolean;
 /** Returns a promise that resolves when the browser comes back online. */

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExF,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/D,6DAA6D;AAC7D,eAAO,MAAM,QAAQ,QAAO,OACgC,CAAC;AAE7D,0EAA0E;AAC1E,wBAAgB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAM7C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExF,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/D,sEAAsE;AACtE,OAAO,EACL,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,SAAS,EACT,8BAA8B,EAC9B,+BAA+B,GAChC,MAAM,2BAA2B,CAAC;AAEnC,6DAA6D;AAC7D,eAAO,MAAM,QAAQ,QAAO,OAG3B,CAAC;AAEF,0EAA0E;AAC1E,wBAAgB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAM7C"}

package/dist/index.js

@@ -6,8 +6,14 @@
  */
 export { syncEngine, NexusSyncEngine } from './engine.js';
 export { $localSync } from './rune.js';
+/** Byte-Mirror — SQLite WASM in a worker (OPFS / memory fallback). */
+export { ByteMirrorBridge, resolveSqliteSyncWorkerUrl, } from './byte-mirror-bridge.js';
 /** Convenience: check if the browser is currently online. */
-export const isOnline = () => typeof navigator !== 'undefined' ? navigator.onLine : true;
+export const isOnline = () => {
+    if (typeof navigator === 'undefined')
+        return true;
+    return navigator.onLine !== false;
+};
 /** Returns a promise that resolves when the browser comes back online. */
 export function waitForOnline() {
     if (isOnline())

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG1D,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,6DAA6D;AAC7D,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAY,EAAE,CACpC,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAE7D,0EAA0E;AAC1E,MAAM,UAAU,aAAa;IAC3B,IAAI,QAAQ,EAAE;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IACzC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,MAAM,OAAO,GAAG,GAAG,EAAE,GAAG,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QACpF,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG1D,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,sEAAsE;AACtE,OAAO,EACL,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC;AAUjC,6DAA6D;AAC7D,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAY,EAAE;IACpC,IAAI,OAAO,SAAS,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAClD,OAAO,SAAS,CAAC,MAAM,KAAK,KAAK,CAAC;AACpC,CAAC,CAAC;AAEF,0EAA0E;AAC1E,MAAM,UAAU,aAAa;IAC3B,IAAI,QAAQ,EAAE;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IACzC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,MAAM,OAAO,GAAG,GAAG,EAAE,GAAG,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QACpF,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/sync-index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sync-index.test.d.ts.map

package/dist/sync-index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-index.test.d.ts","sourceRoot":"","sources":["../src/sync-index.test.ts"],"names":[],"mappings":""}

package/dist/sync-index.test.js

@@ -0,0 +1,8 @@
+import { describe, it, expect } from 'vitest';
+import { isOnline } from './index.js';
+describe('@nexus_js/sync entry', () => {
+    it('isOnline is true when navigator is undefined (Node)', () => {
+        expect(isOnline()).toBe(true);
+    });
+});
+//# sourceMappingURL=sync-index.test.js.map

package/dist/sync-index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-index.test.js","sourceRoot":"","sources":["../src/sync-index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/workers/sqlite-sync.worker.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Nexus Byte-Mirror — SQLite WASM worker (OPFS when COOP/COEP allow it, else :memory:).
+ *
+ * Security: accepts only structured mutation messages — never raw SQL strings from the UI.
+ */
+export {};
+//# sourceMappingURL=sqlite-sync.worker.d.ts.map

package/dist/workers/sqlite-sync.worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-sync.worker.d.ts","sourceRoot":"","sources":["../../src/workers/sqlite-sync.worker.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/workers/sqlite-sync.worker.js

@@ -0,0 +1,210 @@
+/**
+ * Nexus Byte-Mirror — SQLite WASM worker (OPFS when COOP/COEP allow it, else :memory:).
+ *
+ * Security: accepts only structured mutation messages — never raw SQL strings from the UI.
+ */
+/// <reference lib="webworker" />
+import sqlite3InitModule from '@sqlite.org/sqlite-wasm';
+let db = null;
+function reply(msg) {
+    self.postMessage(msg);
+}
+function ensureDb() {
+    if (!db)
+        throw new Error('[Nexus Byte-Mirror] Worker not initialized (send INIT first)');
+    return db;
+}
+function runSchema(d) {
+    d.exec(`
+    CREATE TABLE IF NOT EXISTS nexus_flow_nodes (
+      id TEXT PRIMARY KEY NOT NULL,
+      flow_id TEXT NOT NULL,
+      x REAL NOT NULL,
+      y REAL NOT NULL,
+      data_json TEXT NOT NULL DEFAULT '{}',
+      updated_at INTEGER NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_nexus_flow_nodes_flow ON nexus_flow_nodes(flow_id);
+  `);
+    d.exec(`
+    CREATE TABLE IF NOT EXISTS nexus_sync_outbox (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      frame_json TEXT NOT NULL,
+      created_at INTEGER NOT NULL
+    );
+  `);
+}
+function enqueueOutbox(frame) {
+    const d = ensureDb();
+    const stmt = d.prepare(`INSERT INTO nexus_sync_outbox (frame_json, created_at) VALUES (?1, ?2)`);
+    try {
+        stmt.bind(1, JSON.stringify(frame));
+        stmt.bind(2, Date.now());
+        while (stmt.step()) {
+            /* drain */
+        }
+    }
+    finally {
+        stmt.finalize();
+    }
+}
+function upsertNode(payload) {
+    const d = ensureDb();
+    const dataJson = JSON.stringify(payload.data ?? {});
+    const stmt = d.prepare(`
+    INSERT INTO nexus_flow_nodes (id, flow_id, x, y, data_json, updated_at)
+    VALUES (?1, ?2, ?3, ?4, ?5, ?6)
+    ON CONFLICT(id) DO UPDATE SET
+      flow_id = excluded.flow_id,
+      x = excluded.x,
+      y = excluded.y,
+      data_json = excluded.data_json,
+      updated_at = excluded.updated_at
+  `);
+    try {
+        stmt.bind(1, payload.id);
+        stmt.bind(2, payload.flowId);
+        stmt.bind(3, payload.x);
+        stmt.bind(4, payload.y);
+        stmt.bind(5, dataJson);
+        stmt.bind(6, Date.now());
+        while (stmt.step()) {
+            /* drain */
+        }
+    }
+    finally {
+        stmt.finalize();
+    }
+    enqueueOutbox({ kind: 'upsert_node', ...payload, data: payload.data ?? {} });
+}
+function deleteNode(id) {
+    const d = ensureDb();
+    const stmt = d.prepare(`DELETE FROM nexus_flow_nodes WHERE id = ?1`);
+    try {
+        stmt.bind(1, id);
+        while (stmt.step()) {
+            /* drain */
+        }
+    }
+    finally {
+        stmt.finalize();
+    }
+    enqueueOutbox({ kind: 'delete_node', id });
+}
+function listNodes(flowId) {
+    const d = ensureDb();
+    const rows = d.exec({
+        sql: `SELECT id, flow_id, x, y, data_json, updated_at FROM nexus_flow_nodes WHERE flow_id = ?1 ORDER BY id`,
+        bind: [flowId],
+        returnValue: 'resultRows',
+        rowMode: 'object',
+    });
+    return rows ?? [];
+}
+function drainOutbox(limit) {
+    const d = ensureDb();
+    const rows = d.exec({
+        sql: `SELECT id, frame_json, created_at FROM nexus_sync_outbox ORDER BY id ASC LIMIT ?1`,
+        bind: [limit],
+        returnValue: 'resultRows',
+        rowMode: 'object',
+    });
+    return rows ?? [];
+}
+function markOutboxSynced(ids) {
+    if (ids.length === 0)
+        return;
+    const d = ensureDb();
+    const placeholders = ids.map((_, i) => `?${i + 1}`).join(',');
+    const stmt = d.prepare(`DELETE FROM nexus_sync_outbox WHERE id IN (${placeholders})`);
+    try {
+        for (let i = 0; i < ids.length; i++) {
+            stmt.bind(i + 1, ids[i]);
+        }
+        while (stmt.step()) {
+            /* drain */
+        }
+    }
+    finally {
+        stmt.finalize();
+    }
+}
+async function handleInit(requestId, dbFilename) {
+    const sqlite3 = await sqlite3InitModule({
+        print: () => undefined,
+        printErr: (m) => console.error('[sqlite-wasm]', m),
+    });
+    const oo1 = sqlite3.oo1;
+    const file = dbFilename ?? '/nexus_byte_mirror.sqlite';
+    let storage = 'memory';
+    try {
+        const OpfsDb = oo1.OpfsDb;
+        if (OpfsDb) {
+            db = new OpfsDb(file, 'c');
+            storage = 'opfs';
+        }
+        else {
+            db = new oo1.DB(':memory:');
+        }
+    }
+    catch {
+        db = new oo1.DB(':memory:');
+        storage = 'memory';
+    }
+    runSchema(db);
+    reply({ type: 'READY', requestId, storage });
+}
+self.onmessage = async (ev) => {
+    const msg = ev.data;
+    const requestId = msg.requestId;
+    try {
+        switch (msg.type) {
+            case 'INIT':
+                await handleInit(requestId, msg.dbFilename);
+                break;
+            case 'UPSERT_NODE':
+                ensureDb();
+                upsertNode(msg.payload);
+                reply({ type: 'ACK', requestId });
+                break;
+            case 'DELETE_NODE':
+                ensureDb();
+                deleteNode(msg.payload.id);
+                reply({ type: 'ACK', requestId });
+                break;
+            case 'LIST_NODES': {
+                ensureDb();
+                const raw = listNodes(msg.payload.flowId);
+                const rows = raw.map((r) => ({
+                    id: String(r.id),
+                    flow_id: String(r.flow_id),
+                    x: Number(r.x),
+                    y: Number(r.y),
+                    data_json: String(r.data_json ?? '{}'),
+                    updated_at: Number(r.updated_at),
+                }));
+                reply({ type: 'NODES', requestId, rows });
+                break;
+            }
+            case 'DRAIN_OUTBOX': {
+                ensureDb();
+                const rows = drainOutbox(Math.max(1, Math.min(500, msg.payload.limit)));
+                reply({ type: 'OUTBOX', requestId, rows });
+                break;
+            }
+            case 'MARK_OUTBOX_SYNCED': {
+                ensureDb();
+                markOutboxSynced(msg.payload.ids);
+                reply({ type: 'ACK', requestId });
+                break;
+            }
+            default:
+                reply({ type: 'ERROR', requestId, message: 'Unknown worker message type' });
+        }
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        reply({ type: 'ERROR', requestId, message });
+    }
+};
+//# sourceMappingURL=sqlite-sync.worker.js.map

package/dist/workers/sqlite-sync.worker.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nexus_js/sync",
-  "version": "0.7.1",
-  "description": "Nexus Local-First Sync Engine — IndexedDB-backed optimistic mutations with conflict resolution",
+  "version": "0.7.4",
+  "description": "Nexus Local-First Sync — IndexedDB engine ($localSync) + Byte-Mirror prototype (SQLite WASM worker / OPFS)",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -9,7 +9,8 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
-    }
+    },
+    "./workers/sqlite-sync.worker.js": "./dist/workers/sqlite-sync.worker.js"
   },
   "keywords": [
     "nexus",
@@ -37,7 +38,8 @@
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "typescript": "^5.5.0"
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
   },
   "files": [
     "dist",
@@ -47,9 +49,13 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
+  "dependencies": {
+    "@sqlite.org/sqlite-wasm": "3.48.0-build1"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "dev": "tsc -p tsconfig.json --watch",
+    "test": "vitest run",
     "clean": "rm -rf dist"
   }
 }