@interocitor/core 0.0.0-beta.2

package/dist/adapters/webdav.js

@@ -0,0 +1,247 @@
+/**
+ * WebDAV Storage Adapter
+ *
+ * For self-hosted clouds: Nextcloud, ownCloud, or any WebDAV server.
+ * "My own cloud" option — user runs their own server.
+ *
+ * WebDAV is HTTP-based, works from any browser.
+ * Most implementations support Basic auth or Bearer tokens.
+ */
+/**
+ * Browser-friendly WebDAV adapter for Nextcloud, ownCloud, and compatible DAV servers.
+ *
+ * @example
+ * ```ts
+ * const adapter = new WebDAVAdapter({
+ *   baseUrl: 'https://cloud.example.com/remote.php/dav/files/alice',
+ *   auth: { username: 'alice', password: 'APP_PASSWORD' },
+ * });
+ * ```
+ */
+export class WebDAVAdapter {
+    constructor(config) {
+        this.name = 'webdav';
+        this.authenticated = false;
+        this.config = config;
+    }
+    url(path) {
+        const base = this.config.baseUrl.replace(/\/$/, '');
+        const clean = path.startsWith('/') ? path : '/' + path;
+        return base + clean;
+    }
+    authHeader() {
+        const auth = this.config.auth;
+        if ('token' in auth) {
+            return `Bearer ${auth.token}`;
+        }
+        return `Basic ${btoa(`${auth.username}:${auth.password}`)}`;
+    }
+    headers(extra) {
+        return {
+            Authorization: this.authHeader(),
+            ...extra,
+        };
+    }
+    async authenticate() {
+        // Verify credentials by doing a PROPFIND on root
+        const res = await fetch(this.url('/'), {
+            method: 'PROPFIND',
+            headers: this.headers({ Depth: '0' }),
+        });
+        if (res.status === 207 || res.ok) {
+            this.authenticated = true;
+        }
+        else if (res.status === 401) {
+            throw new Error('WebDAV authentication failed');
+        }
+        else {
+            throw new Error(`WebDAV error: ${res.status}`);
+        }
+    }
+    /**
+     * Returns the WebDAV base URL (without credentials) for embedding in a QR payload.
+     * The scanner uses this to point their WebDAVAdapter at the same server.
+     * Auth (username/password or token) must be configured separately by the user.
+     */
+    getHandshakeConfig() {
+        return JSON.stringify({ baseUrl: this.config.baseUrl });
+    }
+    isAuthenticated() {
+        return this.authenticated;
+    }
+    async ensureFolder(path) {
+        const parts = path.split('/').filter(Boolean);
+        let current = '';
+        for (const part of parts) {
+            current += '/' + part;
+            const res = await fetch(this.url(current), {
+                method: 'MKCOL',
+                headers: this.headers(),
+            });
+            // 201 Created, 405 Already Exists — both fine
+            if (!res.ok && res.status !== 405) {
+                throw new Error(`Failed to create folder ${current}: ${res.status}`);
+            }
+        }
+    }
+    async listFiles(folderPath) {
+        const res = await fetch(this.url(folderPath), {
+            method: 'PROPFIND',
+            headers: this.headers({
+                Depth: '1',
+                'Content-Type': 'application/xml',
+            }),
+            body: `<?xml version="1.0" encoding="UTF-8"?>
+        <d:propfind xmlns:d="DAV:">
+          <d:prop>
+            <d:getcontentlength/>
+            <d:getlastmodified/>
+            <d:resourcetype/>
+            <d:getetag/>
+          </d:prop>
+        </d:propfind>`,
+        });
+        if (res.status !== 207) {
+            throw new Error(`PROPFIND failed: ${res.status}`);
+        }
+        const xml = await res.text();
+        return this.parsePropfindResponse(xml, folderPath);
+    }
+    parsePropfindResponse(xml, basePath) {
+        const parser = new DOMParser();
+        const doc = parser.parseFromString(xml, 'application/xml');
+        const responses = doc.getElementsByTagNameNS('DAV:', 'response');
+        const entries = [];
+        for (let i = 0; i < responses.length; i++) {
+            const response = responses[i];
+            const href = response.getElementsByTagNameNS('DAV:', 'href')[0]?.textContent || '';
+            // Skip the folder itself (first response)
+            if (i === 0)
+                continue;
+            // Skip sub-folders
+            const resourceType = response.getElementsByTagNameNS('DAV:', 'collection');
+            if (resourceType.length > 0)
+                continue;
+            const size = response.getElementsByTagNameNS('DAV:', 'getcontentlength')[0]?.textContent || '0';
+            const modified = response.getElementsByTagNameNS('DAV:', 'getlastmodified')[0]?.textContent || '';
+            const etag = response.getElementsByTagNameNS('DAV:', 'getetag')[0]?.textContent || undefined;
+            // Extract filename from href
+            const name = decodeURIComponent(href.split('/').filter(Boolean).pop() || '');
+            entries.push({
+                name,
+                path: `${basePath}/${name}`,
+                size: parseInt(size, 10),
+                modifiedTime: modified ? new Date(modified).toISOString() : '',
+                etag,
+            });
+        }
+        return entries;
+    }
+    async listFolders(folderPath) {
+        const res = await fetch(this.url(folderPath), {
+            method: 'PROPFIND',
+            headers: this.headers({
+                Depth: '1',
+                'Content-Type': 'application/xml',
+            }),
+            body: `<?xml version="1.0" encoding="UTF-8"?>
+        <d:propfind xmlns:d="DAV:">
+          <d:prop>
+            <d:resourcetype/>
+          </d:prop>
+        </d:propfind>`,
+        });
+        if (res.status !== 207)
+            return [];
+        const xml = await res.text();
+        const parser = new DOMParser();
+        const doc = parser.parseFromString(xml, 'application/xml');
+        const responses = doc.getElementsByTagNameNS('DAV:', 'response');
+        const folders = [];
+        for (let i = 1; i < responses.length; i++) {
+            const response = responses[i];
+            const isCollection = response.getElementsByTagNameNS('DAV:', 'collection').length > 0;
+            if (!isCollection)
+                continue;
+            const href = response.getElementsByTagNameNS('DAV:', 'href')[0]?.textContent || '';
+            const name = decodeURIComponent(href.split('/').filter(Boolean).pop() || '');
+            if (name)
+                folders.push(name);
+        }
+        return folders;
+    }
+    async readFile(path) {
+        const res = await fetch(this.url(path), {
+            method: 'GET',
+            headers: this.headers(),
+        });
+        if (!res.ok)
+            throw new Error(`Failed to read ${path}: ${res.status}`);
+        const buffer = await res.arrayBuffer();
+        return new Uint8Array(buffer);
+    }
+    async writeFile(path, data) {
+        const body = typeof data === 'string'
+            ? new TextEncoder().encode(data)
+            : data;
+        const res = await fetch(this.url(path), {
+            method: 'PUT',
+            headers: this.headers({ 'Content-Type': 'application/octet-stream' }),
+            body: body,
+        });
+        if (!res.ok && res.status !== 201 && res.status !== 204) {
+            throw new Error(`Failed to write ${path}: ${res.status}`);
+        }
+    }
+    async deleteFile(path) {
+        const res = await fetch(this.url(path), {
+            method: 'DELETE',
+            headers: this.headers(),
+        });
+        // 204 No Content or 404 Not Found — both acceptable
+        if (!res.ok && res.status !== 404) {
+            throw new Error(`Failed to delete ${path}: ${res.status}`);
+        }
+    }
+    async getFileMetadata(path) {
+        const res = await fetch(this.url(path), {
+            method: 'PROPFIND',
+            headers: this.headers({
+                Depth: '0',
+                'Content-Type': 'application/xml',
+            }),
+            body: `<?xml version="1.0" encoding="UTF-8"?>
+        <d:propfind xmlns:d="DAV:">
+          <d:prop>
+            <d:getcontentlength/>
+            <d:getlastmodified/>
+            <d:getetag/>
+          </d:prop>
+        </d:propfind>`,
+        });
+        if (res.status === 404)
+            return null;
+        if (res.status !== 207)
+            return null;
+        const xml = await res.text();
+        // PROPFIND with Depth:0 on a file returns one entry for itself
+        // but our parser skips index 0, so we handle it differently
+        const parser = new DOMParser();
+        const doc = parser.parseFromString(xml, 'application/xml');
+        const response = doc.getElementsByTagNameNS('DAV:', 'response')[0];
+        if (!response)
+            return null;
+        const size = response.getElementsByTagNameNS('DAV:', 'getcontentlength')[0]?.textContent || '0';
+        const modified = response.getElementsByTagNameNS('DAV:', 'getlastmodified')[0]?.textContent || '';
+        const etag = response.getElementsByTagNameNS('DAV:', 'getetag')[0]?.textContent || undefined;
+        const name = path.split('/').filter(Boolean).pop() || '';
+        return {
+            name,
+            path,
+            size: parseInt(size, 10),
+            modifiedTime: modified ? new Date(modified).toISOString() : '',
+            etag,
+        };
+    }
+}
+//# sourceMappingURL=webdav.js.map

package/dist/adapters/webdav.js.map

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

package/dist/core/codec.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Codec — encryption/decryption of change and snapshot payloads.
+ *
+ * Extracted from SyncEngine to keep the orchestrator lean.
+ * Not part of the public API.
+ */
+import type { ChangeEntry, Manifest, Snapshot, LocalStoreAdapter } from './types.ts';
+export interface CodecState {
+    encryptionKey: CryptoKey | null;
+    encrypted: boolean;
+    manifest: Manifest | null;
+}
+export declare function encodeForCloud(state: CodecState, plaintext: string): Promise<string>;
+export declare function decodeFromCloud(state: CodecState, data: string): Promise<string>;
+export declare function assertExpectedMeshId(local: LocalStoreAdapter, manifest: Manifest | null, meshId: string): Promise<void>;
+export declare function encodeChangePayload(state: CodecState, entry: ChangeEntry): Promise<string>;
+export declare function decodeChangePayload(state: CodecState, local: LocalStoreAdapter, data: string, path: string): Promise<ChangeEntry>;
+export declare function encodeSnapshotPayload(state: CodecState, snapshot: Snapshot): Promise<string>;
+export declare function decodeSnapshotPayload(state: CodecState, local: LocalStoreAdapter, data: string, path: string): Promise<Snapshot>;
+//# sourceMappingURL=codec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../src/core/codec.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EACR,QAAQ,EAGR,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,SAAS,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG1F;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGtF;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,iBAAiB,EACxB,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAQhG;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,CAAC,CAUtB;AAED,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlG;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,QAAQ,CAAC,CAUnB"}

package/dist/core/codec.js

@@ -0,0 +1,66 @@
+/**
+ * Codec — encryption/decryption of change and snapshot payloads.
+ *
+ * Extracted from SyncEngine to keep the orchestrator lean.
+ * Not part of the public API.
+ */
+import { encryptEntry, decryptEntry } from "../crypto/encryption.js";
+export async function encodeForCloud(state, plaintext) {
+    if (!state.encrypted || !state.encryptionKey)
+        return plaintext;
+    return encryptEntry(state.encryptionKey, plaintext);
+}
+export async function decodeFromCloud(state, data) {
+    if (!state.encrypted || !state.encryptionKey)
+        return data;
+    return decryptEntry(state.encryptionKey, data);
+}
+export async function assertExpectedMeshId(local, manifest, meshId) {
+    if (!meshId) {
+        throw new Error('Remote mesh is missing meshId');
+    }
+    const manifestMeshId = manifest?.meshId;
+    if (manifestMeshId && manifestMeshId !== meshId) {
+        throw new Error(`Remote mesh mismatch: expected ${manifestMeshId}, got ${meshId}`);
+    }
+    const storedMeshId = await local.getMeta('meshId');
+    if (typeof storedMeshId === 'string' && storedMeshId && storedMeshId !== meshId) {
+        throw new Error(`Remote mesh mismatch: expected ${storedMeshId}, got ${meshId}`);
+    }
+    await local.setMeta('meshId', meshId);
+}
+export async function encodeChangePayload(state, entry) {
+    const meshId = state.manifest?.meshId;
+    if (!meshId) {
+        throw new Error('Cannot encode change payload before manifest is loaded');
+    }
+    const payload = { meshId, kind: 'change', entry };
+    return encodeForCloud(state, JSON.stringify(payload));
+}
+export async function decodeChangePayload(state, local, data, path) {
+    const decoded = await decodeFromCloud(state, data);
+    const payload = JSON.parse(decoded);
+    if (payload.kind !== 'change' || !payload.entry) {
+        throw new Error(`Remote change payload has invalid shape: ${path}`);
+    }
+    await assertExpectedMeshId(local, state.manifest, String(payload.meshId || ''));
+    return payload.entry;
+}
+export async function encodeSnapshotPayload(state, snapshot) {
+    const meshId = state.manifest?.meshId;
+    if (!meshId) {
+        throw new Error('Cannot encode snapshot payload before manifest is loaded');
+    }
+    const payload = { meshId, kind: 'snapshot', snapshot };
+    return encodeForCloud(state, JSON.stringify(payload));
+}
+export async function decodeSnapshotPayload(state, local, data, path) {
+    const decoded = await decodeFromCloud(state, data);
+    const payload = JSON.parse(decoded);
+    if (payload.kind !== 'snapshot' || !payload.snapshot) {
+        throw new Error(`Remote snapshot payload has invalid shape: ${path}`);
+    }
+    await assertExpectedMeshId(local, state.manifest, String(payload.meshId || ''));
+    return payload.snapshot;
+}
+//# sourceMappingURL=codec.js.map

package/dist/core/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","sourceRoot":"","sources":["../../src/core/codec.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAQrE,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAiB,EAAE,SAAiB;IACvE,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,aAAa;QAAE,OAAO,SAAS,CAAC;IAC/D,OAAO,YAAY,CAAC,KAAK,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAiB,EAAE,IAAY;IACnE,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC;IAC1D,OAAO,YAAY,CAAC,KAAK,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAwB,EACxB,QAAyB,EACzB,MAAc;IAEd,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,cAAc,GAAG,QAAQ,EAAE,MAAM,CAAC;IACxC,IAAI,cAAc,IAAI,cAAc,KAAK,MAAM,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,kCAAkC,cAAc,SAAS,MAAM,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;QAChF,MAAM,IAAI,KAAK,CAAC,kCAAkC,YAAY,SAAS,MAAM,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAiB,EAAE,KAAkB;IAC7E,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC;IACtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,OAAO,GAAsB,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACrE,OAAO,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAAiB,EACjB,KAAwB,EACxB,IAAY,EACZ,IAAY;IAEZ,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAsB,CAAC;IAEzD,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;IAChF,OAAO,OAAO,CAAC,KAAK,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAAiB,EAAE,QAAkB;IAC/E,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC;IACtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,OAAO,GAAwB,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC5E,OAAO,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAiB,EACjB,KAAwB,EACxB,IAAY,EACZ,IAAY;IAEZ,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAwB,CAAC;IAE3D,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,8CAA8C,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;IAChF,OAAO,OAAO,CAAC,QAAQ,CAAC;AAC1B,CAAC"}

package/dist/core/compaction.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Compaction — snapshot + manifest rotation + change file pruning.
+ *
+ * Extracted from SyncEngine. Not part of the public API.
+ */
+import type { StorageAdapter, LocalStoreAdapter, Manifest, Row, SyncEvent } from './types.ts';
+import type { HLC } from './types.ts';
+import type { CodecState } from './codec.ts';
+export interface CompactContext {
+    adapter: StorageAdapter;
+    local: LocalStoreAdapter;
+    remotePath: string;
+    manifest: Manifest;
+    codecState: CodecState;
+    hlc: HLC;
+    deviceId: string;
+    serverId: string;
+    emit: (event: SyncEvent) => void;
+    pull: () => Promise<void>;
+}
+export declare function compact(ctx: CompactContext): Promise<Manifest>;
+export interface RehydrateContext {
+    adapter: StorageAdapter;
+    local: LocalStoreAdapter;
+    codecState: CodecState;
+    manifest: Manifest | null;
+    hlc: HLC;
+    deviceId: string;
+    tables: Record<string, Record<string, Row>>;
+    knownTables: Set<string>;
+    emit: (event: SyncEvent) => void;
+    poisonRemote: (error: unknown, path?: string) => Promise<Error>;
+    pull: () => Promise<void>;
+}
+/** Returns the updated HLC after rehydration. */
+export declare function rehydrate(ctx: RehydrateContext): Promise<HLC>;
+//# sourceMappingURL=compaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../src/core/compaction.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,QAAQ,EAGR,GAAG,EACH,SAAS,EACV,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAItC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,iBAAiB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,GAAG,EAAE,GAAG,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACjC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,wBAAsB,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,CAuFpE;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,iBAAiB,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,GAAG,EAAE,GAAG,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAC5C,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACjC,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IAChE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,iDAAiD;AACjD,wBAAsB,SAAS,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAgDnE"}

package/dist/core/compaction.js

@@ -0,0 +1,134 @@
+/**
+ * Compaction — snapshot + manifest rotation + change file pruning.
+ *
+ * Extracted from SyncEngine. Not part of the public API.
+ */
+import { hlcSerialize, hlcCompareStr } from "./hlc.js";
+import { paths, textEncoder, textDecoder, generateId, computeContentHash, log } from "./internals.js";
+import { encodeSnapshotPayload, decodeSnapshotPayload } from "./codec.js";
+import { writeJson } from "./manifest.js";
+import { hlcParse } from "./hlc.js";
+export async function compact(ctx) {
+    const { adapter, local, remotePath, manifest, codecState, deviceId, serverId } = ctx;
+    if (manifest.server.managed && deviceId !== serverId) {
+        throw new Error('Compaction is allowed only for the authorized server writer');
+    }
+    // Ensure the compactor has merged latest remote changes before snapshotting.
+    await ctx.pull();
+    const p = paths(remotePath);
+    const now = new Date().toISOString();
+    const nextEpoch = manifest.epoch + 1;
+    const nextGeneration = manifest.generation + 1;
+    const snapshotPath = `${p.mainlineFolder}/snapshot-${nextEpoch}-${serverId}.json`;
+    // Build a full snapshot from IDB — the in-memory cache is partial.
+    const allRows = await local.getAllRows();
+    const snapshotTables = {};
+    for (const row of allRows) {
+        if (!snapshotTables[row._table])
+            snapshotTables[row._table] = {};
+        snapshotTables[row._table][row._rowId] = row;
+    }
+    const snapshot = {
+        snapshotId: generateId('snap'),
+        timestamp: now,
+        hlc: hlcSerialize(ctx.hlc),
+        epoch: nextEpoch,
+        schemaVersion: manifest.schema,
+        tables: snapshotTables,
+    };
+    const snapshotPayload = await encodeSnapshotPayload(codecState, snapshot);
+    await adapter.writeFile(snapshotPath, textEncoder.encode(snapshotPayload));
+    const manifestPayload = {
+        generation: nextGeneration,
+        parentGeneration: manifest.generation,
+        writtenBy: serverId,
+        writtenAt: now,
+        version: 3,
+        meshId: manifest.meshId,
+        schema: manifest.schema,
+        encrypted: manifest.encrypted,
+        server: manifest.server,
+        createdAt: manifest.createdAt,
+        epoch: nextEpoch,
+        watermarkHlc: hlcSerialize(ctx.hlc),
+        snapshotPath,
+        deltaPath: null,
+    };
+    const nextManifest = {
+        ...manifestPayload,
+        contentHash: await computeContentHash(manifestPayload),
+    };
+    const manifestFile = `manifest-${nextGeneration}.json`;
+    await writeJson(adapter, p.manifestFile(nextGeneration), nextManifest);
+    await writeJson(adapter, p.manifestPointer, {
+        currentGeneration: nextGeneration,
+        file: manifestFile,
+    });
+    await local.setMeta('epoch', nextEpoch);
+    // Prune all change files captured in the snapshot.
+    const watermarkHlc = nextManifest.watermarkHlc;
+    log('debug', 'compact() — pruning change files ≤ watermark', { watermarkHlc });
+    try {
+        const files = await adapter.listFiles(p.changesFolder);
+        for (const file of files) {
+            if (file.name === 'head.json')
+                continue;
+            const chgIdx = file.name.lastIndexOf('-chg_');
+            if (chgIdx === -1)
+                continue;
+            const fileHlc = file.name.slice(0, chgIdx);
+            if (hlcCompareStr(fileHlc, watermarkHlc) <= 0) {
+                await adapter.deleteFile(file.path);
+            }
+        }
+        log('debug', 'compact() — pruning complete');
+    }
+    catch (err) {
+        log('warn', 'compact() — pruning failed (non-fatal, snapshot is still valid)', err);
+    }
+    return nextManifest;
+}
+/** Returns the updated HLC after rehydration. */
+export async function rehydrate(ctx) {
+    let hlc = ctx.hlc;
+    ctx.emit({ type: 'rehydrate:start' });
+    const snapshotPath = ctx.manifest?.snapshotPath;
+    if (!snapshotPath) {
+        ctx.emit({ type: 'rehydrate:complete', rowCount: 0 });
+        await ctx.pull();
+        return hlc;
+    }
+    try {
+        const data = await ctx.adapter.readFile(snapshotPath);
+        const snapshot = await decodeSnapshotPayload(ctx.codecState, ctx.local, textDecoder.decode(data), snapshotPath);
+        // Clear local state
+        await ctx.local.clearAll();
+        ctx.tables = {};
+        ctx.knownTables.clear();
+        // Write snapshot rows to IDB
+        let rowCount = 0;
+        for (const [tableName, rows] of Object.entries(snapshot.tables)) {
+            ctx.knownTables.add(tableName);
+            for (const row of Object.values(rows)) {
+                await ctx.local.putRow(row);
+                rowCount++;
+            }
+        }
+        // Restore HLC
+        if (snapshot.hlc) {
+            hlc = hlcParse(snapshot.hlc);
+            hlc.nodeId = ctx.deviceId;
+        }
+        await ctx.local.setMeta('epoch', snapshot.epoch);
+        ctx.emit({ type: 'rehydrate:complete', rowCount });
+    }
+    catch (err) {
+        const poisoned = await ctx.poisonRemote(err, snapshotPath);
+        ctx.emit({ type: 'sync:error', error: poisoned });
+        throw poisoned;
+    }
+    // Pull any changes since the snapshot
+    await ctx.pull();
+    return hlc;
+}
+//# sourceMappingURL=compaction.js.map

package/dist/core/compaction.js.map

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

package/dist/core/crdt.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 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 type { Row, Op, ChangeEntry, DatabaseSchemaDefinition } from './types.ts';
+/**
+ * Apply a single op to the in-memory state.
+ * Returns the affected row (mutated in place) or null if no change.
+ */
+export declare function applyOp(tables: Record<string, Record<string, Row>>, op: Op, schemaVersion: number, schema?: DatabaseSchemaDefinition): Row | null;
+/**
+ * Apply a full change entry (potentially multiple ops).
+ * Returns list of affected rows.
+ */
+export declare function applyChangeEntry(tables: Record<string, Record<string, Row>>, entry: ChangeEntry, schemaVersion: number, schema?: DatabaseSchemaDefinition): Row[];
+/**
+ * Read a column value from a row, unwrapping the ColumnEntry.
+ */
+export declare function readColumn(row: Row, column: string): unknown;
+/**
+ * Build a plain object from a row (strip HLC metadata).
+ */
+export declare function rowToPlain(row: Row): Record<string, unknown>;
+//# sourceMappingURL=crdt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"crdt.d.ts","sourceRoot":"","sources":["../../src/core/crdt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,GAAG,EACH,EAAE,EAEF,WAAW,EACX,wBAAwB,EAGzB,MAAM,YAAY,CAAC;AA0EpB;;;GAGG;AACH,wBAAgB,OAAO,CACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAC3C,EAAE,EAAE,EAAE,EACN,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,wBAAwB,GAChC,GAAG,GAAG,IAAI,CA4EZ;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAC3C,KAAK,EAAE,WAAW,EAClB,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,wBAAwB,GAChC,GAAG,EAAE,CAOP;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAM5D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAa5D"}