@interocitor/core 0.0.0-beta.2

package/dist/core/crdt.js

@@ -0,0 +1,188 @@
+/**
+ * CRDT Merge Engine — configurable per-column merge strategy.
+ *
+ * Each column in each row carries its own HLC.
+ * The merge strategy determines which value wins on conflict:
+ *
+ *  - `'remote-wins'` — Remote always overwrites local. (Default)
+ *  - `'lww'`         — Last-Writer-Wins. Highest HLC wins.
+ *  - `'local-wins'`  — Keep local value when both exist.
+ *  - custom function  — `(local, remote, ctx) => ColumnEntry`
+ *
+ * Deletes are soft (tombstone with HLC) and always use LWW.
+ */
+import { hlcCompareStr } from "./hlc.js";
+/** Reserved keys that are not user columns */
+const META_KEYS = new Set(['_table', '_rowId', '_deleted', '_deletedHlc', '_schemaVersion']);
+/**
+ * Resolve the merge strategy for a specific column.
+ *
+ * Resolution order (first defined wins):
+ *   field-level → table-level → database-level → 'lww'
+ */
+function resolveStrategy(schema, table, field) {
+    const tableDef = schema?.tables[table];
+    if (tableDef?.merge) {
+        const m = tableDef.merge;
+        if (typeof m === 'object' && 'fields' in m) {
+            // TableMergeConfig
+            const config = m;
+            if (config.fields?.[field])
+                return config.fields[field];
+            if (config.strategy)
+                return config.strategy;
+        }
+        else {
+            // bare MergeStrategy (string or function) on the table
+            return m;
+        }
+    }
+    // No schema at all → LWW (backwards compat for raw applyOp callers).
+    // Schema present but no mergeStrategy → remote-wins (sensible default).
+    if (!schema)
+        return 'lww';
+    return schema.mergeStrategy ?? 'remote-wins';
+}
+/**
+ * Decide which column entry wins given a strategy.
+ *
+ * `local` may be undefined (new column). In that case, remote always wins
+ * regardless of strategy — there's no conflict.
+ */
+function mergeColumn(local, remote, strategy, table, rowId, field) {
+    // No local value → accept remote unconditionally
+    if (!local || !local.hlc)
+        return remote;
+    if (typeof strategy === 'function') {
+        const result = strategy(local, remote, { table, rowId, field });
+        // Only count as changed if the result differs from local
+        return result.hlc !== local.hlc || result.value !== local.value ? result : null;
+    }
+    switch (strategy) {
+        case 'remote-wins':
+            return remote;
+        case 'local-wins':
+            // Only accept remote if it's strictly newer (no conflict — local
+            // hasn't written this column yet at this HLC).
+            // When both have values, local keeps its value.
+            return null;
+        default:
+            return hlcCompareStr(remote.hlc, local.hlc) > 0 ? remote : null;
+    }
+}
+/**
+ * Apply a single op to the in-memory state.
+ * Returns the affected row (mutated in place) or null if no change.
+ */
+export function applyOp(tables, op, schemaVersion, schema) {
+    if (!tables[op.table]) {
+        tables[op.table] = {};
+    }
+    const table = tables[op.table];
+    if (op.type === 'delete') {
+        const existing = table[op.rowId];
+        if (existing) {
+            // Only apply delete if its HLC is newer than all column HLCs
+            if (existing._deletedHlc && hlcCompareStr(op.hlc, existing._deletedHlc) <= 0) {
+                return null; // stale delete
+            }
+            // Check if any column has a newer HLC than this delete
+            const hasNewerColumn = Object.entries(existing).some(([key, val]) => {
+                if (META_KEYS.has(key))
+                    return false;
+                const entry = val;
+                return entry?.hlc && hlcCompareStr(entry.hlc, op.hlc) > 0;
+            });
+            if (hasNewerColumn)
+                return null;
+            existing._deleted = true;
+            existing._deletedHlc = op.hlc;
+            return existing;
+        }
+        // Tombstone for a row we haven't seen — create it
+        const row = {
+            _table: op.table,
+            _rowId: op.rowId,
+            _deleted: true,
+            _deletedHlc: op.hlc,
+            _schemaVersion: schemaVersion,
+        };
+        table[op.rowId] = row;
+        return row;
+    }
+    // Upsert
+    let row = table[op.rowId];
+    let changed = false;
+    if (!row) {
+        row = {
+            _table: op.table,
+            _rowId: op.rowId,
+            _deleted: false,
+            _schemaVersion: schemaVersion,
+        };
+        table[op.rowId] = row;
+        changed = true;
+    }
+    for (const [col, entry] of Object.entries(op.columns)) {
+        const existing = row[col];
+        const strategy = resolveStrategy(schema, op.table, col);
+        const winner = mergeColumn(existing, entry, strategy, op.table, op.rowId, col);
+        if (winner) {
+            row[col] = winner;
+            changed = true;
+        }
+    }
+    // An upsert that's newer than a delete revives the row
+    if (row._deleted && row._deletedHlc) {
+        const newestOpHlc = Object.values(op.columns).reduce((max, entry) => {
+            return !max || hlcCompareStr(entry.hlc, max) > 0 ? entry.hlc : max;
+        }, '');
+        if (newestOpHlc && hlcCompareStr(newestOpHlc, row._deletedHlc) > 0) {
+            row._deleted = false;
+            changed = true;
+        }
+    }
+    return changed ? row : null;
+}
+/**
+ * Apply a full change entry (potentially multiple ops).
+ * Returns list of affected rows.
+ */
+export function applyChangeEntry(tables, entry, schemaVersion, schema) {
+    const affected = [];
+    for (const op of entry.ops) {
+        const row = applyOp(tables, op, schemaVersion, schema);
+        if (row)
+            affected.push(row);
+    }
+    return affected;
+}
+/**
+ * Read a column value from a row, unwrapping the ColumnEntry.
+ */
+export function readColumn(row, column) {
+    const entry = row[column];
+    if (entry && typeof entry === 'object' && 'value' in entry && 'hlc' in entry) {
+        return entry.value;
+    }
+    return undefined;
+}
+/**
+ * Build a plain object from a row (strip HLC metadata).
+ */
+export function rowToPlain(row) {
+    const result = {
+        _table: row._table,
+        _rowId: row._rowId,
+        _deleted: row._deleted,
+    };
+    for (const [key, val] of Object.entries(row)) {
+        if (META_KEYS.has(key))
+            continue;
+        if (val && typeof val === 'object' && 'value' in val && 'hlc' in val) {
+            result[key] = val.value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=crdt.js.map

package/dist/core/crdt.js.map

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

package/dist/core/flush.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Flush — push queued local outbox entries to remote cloud.
+ *
+ * Extracted from SyncEngine. Not part of the public API.
+ */
+import type { StorageAdapter, ChangeEntry } from './types.ts';
+import type { CodecState } from './codec.ts';
+export declare function flushToAdapter(adapter: StorageAdapter, remotePath: string, entries: ChangeEntry[], isPrimary: boolean, codecState: CodecState, deviceId: string): Promise<void>;
+//# sourceMappingURL=flush.d.ts.map

package/dist/core/flush.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flush.d.ts","sourceRoot":"","sources":["../../src/core/flush.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EAEZ,MAAM,YAAY,CAAC;AAIpB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,WAAW,EAAE,EACtB,SAAS,EAAE,OAAO,EAClB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAsCf"}

package/dist/core/flush.js

@@ -0,0 +1,41 @@
+/**
+ * Flush — push queued local outbox entries to remote cloud.
+ *
+ * Extracted from SyncEngine. Not part of the public API.
+ */
+import { hlcCompareStr } from "./hlc.js";
+import { paths, textEncoder, textDecoder } from "./internals.js";
+import { encodeChangePayload } from "./codec.js";
+import { upsertDeviceMetadata } from "./manifest.js";
+export async function flushToAdapter(adapter, remotePath, entries, isPrimary, codecState, deviceId) {
+    const p = paths(remotePath);
+    await adapter.ensureFolder(p.changesFolder);
+    let lastWrittenHlc = '';
+    for (const entry of entries) {
+        const fileName = `${entry.hlc}-${entry.id}.json`;
+        const payload = await encodeChangePayload(codecState, entry);
+        await adapter.writeFile(p.changeFile(fileName), textEncoder.encode(payload));
+        if (!lastWrittenHlc || hlcCompareStr(entry.hlc, lastWrittenHlc) > 0) {
+            lastWrittenHlc = entry.hlc;
+        }
+    }
+    // Update global head — monotonic HLC hint for fast poll skipping.
+    const readHeadIfExists = async () => {
+        try {
+            const data = await adapter.readFile(p.changesHead);
+            return JSON.parse(textDecoder.decode(data));
+        }
+        catch {
+            return null;
+        }
+    };
+    const priorHead = await readHeadIfExists();
+    const bestHlc = (priorHead?.latestHlc && hlcCompareStr(priorHead.latestHlc, lastWrittenHlc) > 0)
+        ? priorHead.latestHlc
+        : lastWrittenHlc;
+    await adapter.writeFile(p.changesHead, textEncoder.encode(JSON.stringify({ latestHlc: bestHlc }, null, 2)));
+    if (isPrimary) {
+        await upsertDeviceMetadata(adapter, remotePath, deviceId);
+    }
+}
+//# sourceMappingURL=flush.js.map

package/dist/core/flush.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flush.js","sourceRoot":"","sources":["../../src/core/flush.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAuB,EACvB,UAAkB,EAClB,OAAsB,EACtB,SAAkB,EAClB,UAAsB,EACtB,QAAgB;IAEhB,MAAM,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5B,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAE5C,IAAI,cAAc,GAAG,EAAE,CAAC;IAExB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,EAAE,OAAO,CAAC;QACjD,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC7D,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAE7E,IAAI,CAAC,cAAc,IAAI,aAAa,CAAC,KAAK,CAAC,GAAG,EAAE,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACpE,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,MAAM,gBAAgB,GAAG,KAAK,IAAiC,EAAE;QAC/D,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAgB,CAAC;QAC7D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,MAAM,gBAAgB,EAAE,CAAC;IAC3C,MAAM,OAAO,GAAG,CAAC,SAAS,EAAE,SAAS,IAAI,aAAa,CAAC,SAAS,CAAC,SAAS,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;QAC9F,CAAC,CAAC,SAAS,CAAC,SAAS;QACrB,CAAC,CAAC,cAAc,CAAC;IACnB,MAAM,OAAO,CAAC,SAAS,CACrB,CAAC,CAAC,WAAW,EACb,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO,EAAwB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAC1F,CAAC;IAEF,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC"}

package/dist/core/hlc.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Hybrid Logical Clock
+ *
+ * Combines wall-clock time with a logical counter to produce
+ * a total order across distributed devices without coordination.
+ *
+ * Format when serialized: "{ts}-{counter:04x}-{nodeId}"
+ * Example: "1711785600000-0000-dev_x1"
+ */
+import type { HLC } from './types.ts';
+export declare const HLC_MAX_FUTURE_SKEW_MS: number;
+export declare function hlcInit(nodeId: string): HLC;
+/** Tick the local clock forward for a new local event. */
+export declare function hlcNow(local: HLC): HLC;
+/** Merge a remote HLC into the local clock (called on receive). */
+export declare function hlcReceive(local: HLC, remote: HLC): HLC;
+/** Total ordering: -1 if a < b, 0 if equal, 1 if a > b */
+export declare function hlcCompare(a: HLC, b: HLC): number;
+/** Compare two serialized HLC strings without parsing (fast path). */
+export declare function hlcCompareStr(a: string, b: string): number;
+/** Serialize HLC to a string that sorts lexicographically. */
+export declare function hlcSerialize(hlc: HLC): string;
+/** Parse a serialized HLC string back to an HLC object. */
+export declare function hlcParse(s: string): HLC;
+//# sourceMappingURL=hlc.d.ts.map

package/dist/core/hlc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hlc.d.ts","sourceRoot":"","sources":["../../src/core/hlc.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAGtC,eAAO,MAAM,sBAAsB,QAAgB,CAAC;AAEpD,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAE3C;AAED,0DAA0D;AAC1D,wBAAgB,MAAM,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,CAMtC;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,CAiBvD;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,MAAM,CAMjD;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAK7C;AAED,2DAA2D;AAC3D,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAQvC"}

package/dist/core/hlc.js

@@ -0,0 +1,76 @@
+/**
+ * Hybrid Logical Clock
+ *
+ * Combines wall-clock time with a logical counter to produce
+ * a total order across distributed devices without coordination.
+ *
+ * Format when serialized: "{ts}-{counter:04x}-{nodeId}"
+ * Example: "1711785600000-0000-dev_x1"
+ */
+// Guard against poisoned/misconfigured peers that report far-future clocks.
+export const HLC_MAX_FUTURE_SKEW_MS = 5 * 60 * 1000;
+export function hlcInit(nodeId) {
+    return { ts: Date.now(), counter: 0, nodeId };
+}
+/** Tick the local clock forward for a new local event. */
+export function hlcNow(local) {
+    const wall = Date.now();
+    if (wall > local.ts) {
+        return { ts: wall, counter: 0, nodeId: local.nodeId };
+    }
+    return { ts: local.ts, counter: local.counter + 1, nodeId: local.nodeId };
+}
+/** Merge a remote HLC into the local clock (called on receive). */
+export function hlcReceive(local, remote) {
+    const wall = Date.now();
+    const safeRemoteTs = Math.min(remote.ts, wall + HLC_MAX_FUTURE_SKEW_MS);
+    const maxTs = Math.max(wall, local.ts, safeRemoteTs);
+    let counter;
+    if (maxTs === local.ts && maxTs === remote.ts) {
+        counter = Math.max(local.counter, remote.counter) + 1;
+    }
+    else if (maxTs === local.ts) {
+        counter = local.counter + 1;
+    }
+    else if (maxTs === safeRemoteTs) {
+        counter = remote.counter + 1;
+    }
+    else {
+        counter = 0;
+    }
+    return { ts: maxTs, counter, nodeId: local.nodeId };
+}
+/** Total ordering: -1 if a < b, 0 if equal, 1 if a > b */
+export function hlcCompare(a, b) {
+    if (a.ts !== b.ts)
+        return a.ts - b.ts;
+    if (a.counter !== b.counter)
+        return a.counter - b.counter;
+    if (a.nodeId < b.nodeId)
+        return -1;
+    if (a.nodeId > b.nodeId)
+        return 1;
+    return 0;
+}
+/** Compare two serialized HLC strings without parsing (fast path). */
+export function hlcCompareStr(a, b) {
+    return hlcCompare(hlcParse(a), hlcParse(b));
+}
+/** Serialize HLC to a string that sorts lexicographically. */
+export function hlcSerialize(hlc) {
+    // Zero-pad ts to 15 digits (covers until year 2286)
+    const ts = hlc.ts.toString().padStart(15, '0');
+    const counter = hlc.counter.toString(16).padStart(4, '0');
+    return `${ts}-${counter}-${hlc.nodeId}`;
+}
+/** Parse a serialized HLC string back to an HLC object. */
+export function hlcParse(s) {
+    const firstDash = s.indexOf('-');
+    const secondDash = s.indexOf('-', firstDash + 1);
+    return {
+        ts: parseInt(s.slice(0, firstDash), 10),
+        counter: parseInt(s.slice(firstDash + 1, secondDash), 16),
+        nodeId: s.slice(secondDash + 1),
+    };
+}
+//# sourceMappingURL=hlc.js.map

package/dist/core/hlc.js.map

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

package/dist/core/internals.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Internal helpers shared across sync-engine modules.
+ *
+ * Not part of the public API.
+ */
+export interface CloudPaths {
+    manifestPointer: string;
+    manifestFile: (generation: number) => string;
+    devicesFolder: string;
+    deviceFile: (deviceId: string) => string;
+    mainlineFolder: string;
+    changesFolder: string;
+    changesHead: string;
+    changeFile: (fileName: string) => string;
+}
+export declare function paths(root: string): CloudPaths;
+export declare function log(level: 'debug' | 'info' | 'warn' | 'error', ...args: unknown[]): void;
+export declare function generateId(prefix: string): string;
+export declare function getDeviceId(override?: string): string;
+export declare const textEncoder: TextEncoder;
+export declare const textDecoder: TextDecoder;
+export declare const ROW_META_KEYS: Set<string>;
+export declare function hexFromBytes(bytes: Uint8Array): string;
+export declare function computeContentHash(payload: unknown): Promise<string>;
+//# sourceMappingURL=internals.d.ts.map

package/dist/core/internals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internals.d.ts","sourceRoot":"","sources":["../../src/core/internals.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;CAC1C;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAY9C;AAMD,wBAAgB,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAGxF;AAID,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CASrD;AAID,eAAO,MAAM,WAAW,aAAoB,CAAC;AAC7C,eAAO,MAAM,WAAW,aAAoB,CAAC;AAE7C,eAAO,MAAM,aAAa,aAA6E,CAAC;AAExG,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEtD;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAI1E"}

package/dist/core/internals.js

@@ -0,0 +1,54 @@
+/**
+ * Internal helpers shared across sync-engine modules.
+ *
+ * Not part of the public API.
+ */
+export function paths(root) {
+    const changesFolder = `${root}/changes`;
+    return {
+        manifestPointer: `${root}/manifest.json`,
+        manifestFile: (generation) => `${root}/manifest-${generation}.json`,
+        devicesFolder: `${root}/devices`,
+        deviceFile: (deviceId) => `${root}/devices/${deviceId}.json`,
+        mainlineFolder: `${root}/mainline`,
+        changesFolder,
+        changesHead: `${changesFolder}/head.json`,
+        changeFile: (fileName) => `${changesFolder}/${fileName}`,
+    };
+}
+// ─── Logger ──────────────────────────────────────────────────────────
+const LOG_PREFIX = '[interocitor]';
+export function log(level, ...args) {
+    // eslint-disable-next-line no-console
+    console[level](LOG_PREFIX, ...args);
+}
+// ─── ID generation ───────────────────────────────────────────────────
+export function generateId(prefix) {
+    const rand = crypto.getRandomValues(new Uint8Array(8));
+    const hex = Array.from(rand).map(b => b.toString(16).padStart(2, '0')).join('');
+    return `${prefix}_${hex}`;
+}
+export function getDeviceId(override) {
+    if (override)
+        return override;
+    const KEY = 'interocitor-device-id';
+    let id = localStorage.getItem(KEY);
+    if (!id) {
+        id = generateId('dev');
+        localStorage.setItem(KEY, id);
+    }
+    return id;
+}
+// ─── Encoding / Hashing ─────────────────────────────────────────────
+export const textEncoder = new TextEncoder();
+export const textDecoder = new TextDecoder();
+export const ROW_META_KEYS = new Set(['_table', '_rowId', '_deleted', '_deletedHlc', '_schemaVersion']);
+export function hexFromBytes(bytes) {
+    return Array.from(bytes).map(b => b.toString(16).padStart(2, '0')).join('');
+}
+export async function computeContentHash(payload) {
+    const json = JSON.stringify(payload);
+    const digest = await crypto.subtle.digest('SHA-256', textEncoder.encode(json));
+    return `sha256:${hexFromBytes(new Uint8Array(digest))}`;
+}
+//# sourceMappingURL=internals.js.map

package/dist/core/internals.js.map

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

package/dist/core/manifest.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Manifest — reading, writing, creating, and validating cloud manifests.
+ *
+ * Extracted from SyncEngine. Not part of the public API.
+ */
+import type { StorageAdapter, Manifest, DatabaseSchemaDefinition, SyncEvent } from './types.ts';
+import type { CodecState } from './codec.ts';
+export interface ManifestContext {
+    adapter: StorageAdapter;
+    remotePath: string;
+    serverId: string;
+    serverManaged: boolean;
+    deviceId: string;
+    encrypted: boolean;
+    schema?: DatabaseSchemaDefinition;
+    emit: (event: SyncEvent) => void;
+}
+export declare function readJson<T>(adapter: StorageAdapter, path: string): Promise<T>;
+export declare function readJsonIfExists<T>(adapter: StorageAdapter, path: string): Promise<T | null>;
+export declare function assertServerAuth(manifest: {
+    writtenBy: string;
+}, serverId: string): void;
+export declare function validateManifestHash(manifest: {
+    contentHash: string;
+    [key: string]: unknown;
+}): Promise<void>;
+export declare function writeJson(adapter: StorageAdapter, path: string, value: unknown): Promise<void>;
+export declare function createBootstrapManifest(ctx: ManifestContext): Promise<void>;
+export declare function loadOrCreateManifest(ctx: ManifestContext, codecState: CodecState, local: import('./types.ts').LocalStoreAdapter, poisonRemote: (error: unknown, path?: string) => Promise<Error>): Promise<Manifest>;
+export declare function upsertDeviceMetadata(adapter: StorageAdapter, remotePath: string, deviceId: string): Promise<void>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/core/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/core/manifest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EAGR,wBAAwB,EACxB,SAAS,EACV,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CAClC;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAGnF;AAED,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAMlG;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAIxF;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GACxD,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpG;AAED,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCjF;AAED,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,eAAe,EACpB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,OAAO,YAAY,EAAE,iBAAiB,EAC7C,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,GAC9D,OAAO,CAAC,QAAQ,CAAC,CA8BnB;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/dist/core/manifest.js

@@ -0,0 +1,111 @@
+/**
+ * Manifest — reading, writing, creating, and validating cloud manifests.
+ *
+ * Extracted from SyncEngine. Not part of the public API.
+ */
+import { paths, textEncoder, textDecoder, generateId, computeContentHash } from "./internals.js";
+import { assertExpectedMeshId } from "./codec.js";
+export async function readJson(adapter, path) {
+    const data = await adapter.readFile(path);
+    return JSON.parse(textDecoder.decode(data));
+}
+export async function readJsonIfExists(adapter, path) {
+    try {
+        return await readJson(adapter, path);
+    }
+    catch {
+        return null;
+    }
+}
+export function assertServerAuth(manifest, serverId) {
+    if (manifest.writtenBy !== serverId) {
+        throw new Error(`Unauthorized manifest writer: ${manifest.writtenBy}`);
+    }
+}
+export async function validateManifestHash(manifest) {
+    const { contentHash, ...payload } = manifest;
+    const expected = await computeContentHash(payload);
+    if (contentHash !== expected) {
+        throw new Error('Manifest content hash mismatch');
+    }
+}
+export async function writeJson(adapter, path, value) {
+    await adapter.writeFile(path, textEncoder.encode(JSON.stringify(value, null, 2)));
+}
+export async function createBootstrapManifest(ctx) {
+    const p = paths(ctx.remotePath);
+    const now = new Date().toISOString();
+    const payload = {
+        generation: 1,
+        parentGeneration: 0,
+        writtenBy: ctx.serverId,
+        writtenAt: now,
+        version: 3,
+        meshId: generateId('mesh'),
+        schema: ctx.schema?.version ?? 1,
+        encrypted: ctx.encrypted,
+        server: {
+            managed: ctx.serverManaged,
+            relayUrl: null,
+            serverId: ctx.serverId,
+        },
+        createdAt: now,
+        epoch: 0,
+        watermarkHlc: '',
+        snapshotPath: null,
+        deltaPath: null,
+    };
+    const manifest = {
+        ...payload,
+        contentHash: await computeContentHash(payload),
+    };
+    const manifestFile = `manifest-${manifest.generation}.json`;
+    await writeJson(ctx.adapter, p.manifestFile(manifest.generation), manifest);
+    await writeJson(ctx.adapter, p.manifestPointer, {
+        currentGeneration: manifest.generation,
+        file: manifestFile,
+    });
+}
+export async function loadOrCreateManifest(ctx, codecState, local, poisonRemote) {
+    const p = paths(ctx.remotePath);
+    const globalPointer = await readJsonIfExists(ctx.adapter, p.manifestPointer);
+    if (!globalPointer) {
+        await createBootstrapManifest(ctx);
+    }
+    const pointer = await readJson(ctx.adapter, p.manifestPointer);
+    const manifestPath = `${ctx.remotePath}/${pointer.file}`;
+    const manifest = await readJson(ctx.adapter, manifestPath);
+    await validateManifestHash(manifest);
+    try {
+        await assertExpectedMeshId(local, codecState.manifest, manifest.meshId);
+    }
+    catch (err) {
+        throw await poisonRemote(err, manifestPath);
+    }
+    if (manifest.version !== 3) {
+        throw new Error(`Unsupported manifest version ${manifest.version} (expected 3).`);
+    }
+    if (ctx.schema && manifest.schema !== ctx.schema.version) {
+        ctx.emit({ type: 'schema:mismatch', local: ctx.schema.version, remote: manifest.schema });
+        throw new Error(`Schema version mismatch: local=${ctx.schema.version}, remote=${manifest.schema}`);
+    }
+    if (manifest.server.managed) {
+        assertServerAuth(manifest, ctx.serverId);
+    }
+    return manifest;
+}
+export async function upsertDeviceMetadata(adapter, remotePath, deviceId) {
+    const p = paths(remotePath);
+    const now = new Date().toISOString();
+    const existing = await readJsonIfExists(adapter, p.deviceFile(deviceId));
+    const next = {
+        deviceId,
+        registeredAt: existing?.registeredAt ?? now,
+        lastSeenAt: now,
+        userId: existing?.userId,
+        name: existing?.name,
+        retired: existing?.retired,
+    };
+    await writeJson(adapter, p.deviceFile(deviceId), next);
+}
+//# sourceMappingURL=manifest.js.map

package/dist/core/manifest.js.map

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

package/dist/core/pull.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Pull — download remote changes and merge into local state.
+ *
+ * Extracted from SyncEngine. Not part of the public API.
+ */
+import type { StorageAdapter, LocalStoreAdapter, Row, Op, SyncEvent, DatabaseSchemaDefinition } from './types.ts';
+import type { HLC } from './types.ts';
+import type { CodecState } from './codec.ts';
+export interface PullContext {
+    adapter: StorageAdapter;
+    local: LocalStoreAdapter;
+    remotePath: string;
+    codecState: CodecState;
+    hlc: HLC;
+    deviceId: string;
+    tables: Record<string, Record<string, Row>>;
+    knownTables: Set<string>;
+    schema?: DatabaseSchemaDefinition;
+    emit: (event: SyncEvent) => void;
+    ensureRowsCached: (ops: Op[]) => Promise<void>;
+    poisonRemote: (error: unknown, path?: string) => Promise<Error>;
+    loadOrCreateManifest: () => Promise<void>;
+}
+/** Returns the updated HLC after pull. */
+export declare function pull(ctx: PullContext): Promise<HLC>;
+//# sourceMappingURL=pull.d.ts.map