@sync-subscribe/client 0.3.2

package/dist/idbLocalStore.js

@@ -0,0 +1,282 @@
+import { resolveConflict, matchesFilter, encodeSyncToken, EMPTY_SYNC_TOKEN, } from "@sync-subscribe/core";
+/**
+ * IndexedDB-backed local store. Records survive page reloads.
+ *
+ * Pass a unique `dbName` per logical collection (or per user if you need
+ * data isolation on the same origin).
+ *
+ * Usage:
+ *   const store = new IdbLocalStore<NoteRecord>("notes-db");
+ *   const client = new SyncClient(transport, store);
+ */
+export class IdbLocalStore {
+    dbName;
+    storeName;
+    db = null;
+    constructor(dbName, storeName = "records") {
+        this.dbName = dbName;
+        this.storeName = storeName;
+    }
+    getDb() {
+        if (this.db)
+            return Promise.resolve(this.db);
+        return new Promise((resolve, reject) => {
+            const req = indexedDB.open(this.dbName, 2);
+            req.onupgradeneeded = () => {
+                const db = req.result;
+                if (!db.objectStoreNames.contains(this.storeName)) {
+                    db.createObjectStore(this.storeName, { keyPath: "recordId" });
+                }
+                if (!db.objectStoreNames.contains("meta")) {
+                    db.createObjectStore("meta");
+                }
+            };
+            req.onsuccess = () => {
+                this.db = req.result;
+                resolve(req.result);
+            };
+            req.onerror = () => reject(req.error);
+        });
+    }
+    /**
+     * Apply a batch of patches inside a single readwrite transaction.
+     * Copies `record.updatedAt` into `record.serverUpdatedAt` on upsert (server clock is authoritative).
+     * Conflict resolution mirrors InMemoryStore: server patch wins only when its
+     * revisionCount is higher (or equal with an older updatedAt).
+     */
+    async applyPatches(patches) {
+        if (patches.length === 0)
+            return [];
+        const db = await this.getDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(this.storeName, "readwrite");
+            const store = tx.objectStore(this.storeName);
+            const applied = [];
+            let pending = patches.length;
+            function onPatchDone() {
+                if (--pending === 0)
+                    tx.commit?.();
+            }
+            for (const patch of patches) {
+                if (patch.op === "delete") {
+                    const req = store.delete(patch.recordId);
+                    req.onsuccess = () => {
+                        applied.push(patch);
+                        onPatchDone();
+                    };
+                    req.onerror = () => onPatchDone();
+                }
+                else {
+                    const getReq = store.get(patch.record.recordId);
+                    getReq.onsuccess = () => {
+                        const existing = getReq.result;
+                        if (!existing || resolveConflict(patch.record, existing) === "a") {
+                            // Stamp serverUpdatedAt from the server's updatedAt
+                            const withServerTs = {
+                                ...patch.record,
+                                serverUpdatedAt: patch.record.updatedAt,
+                            };
+                            store.put(withServerTs);
+                            applied.push({ op: "upsert", record: withServerTs });
+                        }
+                        onPatchDone();
+                    };
+                    getReq.onerror = () => onPatchDone();
+                }
+            }
+            tx.oncomplete = () => resolve(applied);
+            tx.onerror = () => reject(tx.error);
+            tx.onabort = () => reject(tx.error);
+        });
+    }
+    async write(record) {
+        const db = await this.getDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(this.storeName, "readwrite");
+            tx.objectStore(this.storeName).put(record);
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    async getAll() {
+        const db = await this.getDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(this.storeName, "readonly");
+            const req = tx.objectStore(this.storeName).getAll();
+            req.onsuccess = () => resolve(req.result);
+            req.onerror = () => reject(req.error);
+        });
+    }
+    async query(filter) {
+        const all = await this.getAll();
+        return all.filter((r) => matchesFilter(r, filter));
+    }
+    async count(filter) {
+        return (await this.query(filter)).length;
+    }
+    async getById(recordId) {
+        const db = await this.getDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(this.storeName, "readonly");
+            const req = tx.objectStore(this.storeName).get(recordId);
+            req.onsuccess = () => resolve(req.result);
+            req.onerror = () => reject(req.error);
+        });
+    }
+    async clear() {
+        const db = await this.getDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(this.storeName, "readwrite");
+            tx.objectStore(this.storeName).clear();
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    async delete(filter) {
+        const db = await this.getDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(this.storeName, "readwrite");
+            const store = tx.objectStore(this.storeName);
+            const req = store.openCursor();
+            let deleted = 0;
+            req.onsuccess = () => {
+                const cursor = req.result;
+                if (!cursor) {
+                    if (deleted > 0)
+                        console.log(`[IdbLocalStore] evicted ${deleted} records`);
+                    return;
+                }
+                if (matchesFilter(cursor.value, filter)) {
+                    cursor.delete();
+                    deleted++;
+                }
+                cursor.continue();
+            };
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+            tx.onabort = () => reject(tx.error);
+        });
+    }
+    async evict(evictFilter) {
+        return this.delete(evictFilter);
+    }
+    async reconstructSyncToken(filter) {
+        const all = await this.getAll();
+        let best;
+        for (const record of all) {
+            if (record.serverUpdatedAt === undefined)
+                continue;
+            if (!matchesFilter(record, filter))
+                continue;
+            if (!best ||
+                record.serverUpdatedAt > best.serverUpdatedAt ||
+                (record.serverUpdatedAt === best.serverUpdatedAt &&
+                    record.revisionCount > best.revisionCount) ||
+                (record.serverUpdatedAt === best.serverUpdatedAt &&
+                    record.revisionCount === best.revisionCount &&
+                    record.recordId > best.recordId)) {
+                best = record;
+            }
+        }
+        if (!best || best.serverUpdatedAt === undefined)
+            return EMPTY_SYNC_TOKEN;
+        return encodeSyncToken({
+            updatedAt: best.serverUpdatedAt,
+            revisionCount: best.revisionCount,
+            recordId: best.recordId,
+        });
+    }
+    async setServerUpdatedAt(recordId, serverUpdatedAt) {
+        const record = await this.getById(recordId);
+        if (record) {
+            await this.write({ ...record, serverUpdatedAt });
+        }
+    }
+    async setSyncToken(subscriptionId, token) {
+        const db = await this.getDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction("meta", "readwrite");
+            tx.objectStore("meta").put(token, `syncToken:${subscriptionId}`);
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    async getSyncToken(subscriptionId) {
+        const db = await this.getDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction("meta", "readonly");
+            const req = tx.objectStore("meta").get(`syncToken:${subscriptionId}`);
+            req.onsuccess = () => resolve(req.result);
+            req.onerror = () => reject(req.error);
+        });
+    }
+    async setSubscription(name, sub) {
+        if (sub.filter === undefined) {
+            throw new Error("Missing filter");
+        }
+        if (sub.syncToken === undefined) {
+            throw new Error("Missing syncToken");
+        }
+        const db = await this.getDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction("meta", "readwrite");
+            tx.objectStore("meta").put(sub, `subscription:${name}`);
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    async getSubscription(name) {
+        const db = await this.getDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction("meta", "readonly");
+            const req = tx.objectStore("meta").get(`subscription:${name}`);
+            req.onsuccess = () => resolve(req.result);
+            req.onerror = () => reject(req.error);
+        });
+    }
+    async getSubscriptionById(id) {
+        const subs = await this.listSubscriptions();
+        return subs.find((s) => s.subscriptionId === id);
+    }
+    async listSubscriptions() {
+        const db = await this.getDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction("meta", "readonly");
+            const store = tx.objectStore("meta");
+            const subs = [];
+            const req = store.openCursor();
+            req.onsuccess = () => {
+                const cursor = req.result;
+                if (cursor) {
+                    if (String(cursor.key).startsWith("subscription:")) {
+                        subs.push(cursor.value);
+                    }
+                    cursor.continue();
+                }
+                else {
+                    resolve(subs);
+                }
+            };
+            req.onerror = () => reject(req.error);
+        });
+    }
+    async removeSubscription(name) {
+        const db = await this.getDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction("meta", "readwrite");
+            tx.objectStore("meta").delete(`subscription:${name}`);
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    async clearSubscriptions() {
+        const db = await this.getDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction("meta", "readwrite");
+            tx.objectStore("meta").clear();
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+}
+//# sourceMappingURL=idbLocalStore.js.map

package/dist/idbLocalStore.js.map

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

package/dist/inMemoryStore.d.ts

@@ -0,0 +1,36 @@
+import type { SyncRecord, SyncPatch, SyncToken, SubscriptionFilter } from "@sync-subscribe/core";
+import type { ILocalStore, PersistedSubscription } from "./types.js";
+/**
+ * Minimal in-memory local store. State is lost on page reload.
+ * Use IdbLocalStore for persistent storage across sessions.
+ */
+export declare class InMemoryStore<T extends SyncRecord> implements ILocalStore<T> {
+    private records;
+    private syncTokens;
+    private subscriptions;
+    /**
+     * Apply a batch of patches from the server.
+     * Copies `record.updatedAt` into `record.serverUpdatedAt` on upsert (server clock is authoritative).
+     * Returns the patches that were actually applied.
+     */
+    applyPatches(patches: SyncPatch<T>[]): Promise<SyncPatch<T>[]>;
+    write(record: T): Promise<void>;
+    getAll(): Promise<T[]>;
+    query(filter: SubscriptionFilter): Promise<T[]>;
+    count(filter: SubscriptionFilter): Promise<number>;
+    getById(recordId: string): Promise<T | undefined>;
+    clear(): Promise<void>;
+    delete(filter: SubscriptionFilter): Promise<void>;
+    evict(evictFilter: SubscriptionFilter): Promise<void>;
+    reconstructSyncToken(filter: SubscriptionFilter<T>): Promise<SyncToken>;
+    setServerUpdatedAt(recordId: string, serverUpdatedAt: number): Promise<void>;
+    setSyncToken(subscriptionId: string, token: SyncToken): Promise<void>;
+    getSyncToken(subscriptionId: string): Promise<SyncToken | undefined>;
+    setSubscription(name: string, sub: PersistedSubscription): Promise<void>;
+    getSubscription(name: string): Promise<PersistedSubscription | undefined>;
+    getSubscriptionById(id: string): Promise<PersistedSubscription | undefined>;
+    listSubscriptions(): Promise<PersistedSubscription[]>;
+    removeSubscription(name: string): Promise<void>;
+    clearSubscriptions(): Promise<void>;
+}
+//# sourceMappingURL=inMemoryStore.d.ts.map

package/dist/inMemoryStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inMemoryStore.d.ts","sourceRoot":"","sources":["../src/inMemoryStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,SAAS,EACT,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAO9B,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAErE;;;GAGG;AACH,qBAAa,aAAa,CAAC,CAAC,SAAS,UAAU,CAAE,YAAW,WAAW,CAAC,CAAC,CAAC;IACxE,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,aAAa,CAA4C;IAEjE;;;;OAIG;IACG,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAwB9D,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/B,MAAM,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAItB,KAAK,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAM/C,KAAK,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAIjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjD,KAAK,CAAC,WAAW,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,oBAAoB,CACxB,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC,SAAS,CAAC;IA6Bf,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC;IAOV,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAIpE,eAAe,CACnB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,IAAI,CAAC;IAIV,eAAe,CACnB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC;IAIvC,mBAAmB,CACvB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC;IAOvC,iBAAiB,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAIrD,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;CAI1C"}

package/dist/inMemoryStore.js

@@ -0,0 +1,127 @@
+import { resolveConflict, matchesFilter, encodeSyncToken, EMPTY_SYNC_TOKEN, } from "@sync-subscribe/core";
+/**
+ * Minimal in-memory local store. State is lost on page reload.
+ * Use IdbLocalStore for persistent storage across sessions.
+ */
+export class InMemoryStore {
+    records = new Map();
+    syncTokens = new Map();
+    subscriptions = new Map();
+    /**
+     * Apply a batch of patches from the server.
+     * Copies `record.updatedAt` into `record.serverUpdatedAt` on upsert (server clock is authoritative).
+     * Returns the patches that were actually applied.
+     */
+    async applyPatches(patches) {
+        const applied = [];
+        for (const patch of patches) {
+            if (patch.op === "delete") {
+                this.records.delete(patch.recordId);
+                applied.push(patch);
+            }
+            else {
+                const existing = this.records.get(patch.record.recordId);
+                if (!existing || resolveConflict(patch.record, existing) === "a") {
+                    // Stamp serverUpdatedAt from the server's updatedAt
+                    const withServerTs = {
+                        ...patch.record,
+                        serverUpdatedAt: patch.record.updatedAt,
+                    };
+                    this.records.set(withServerTs.recordId, withServerTs);
+                    applied.push({ op: "upsert", record: withServerTs });
+                }
+            }
+        }
+        return applied;
+    }
+    async write(record) {
+        this.records.set(record.recordId, record);
+    }
+    async getAll() {
+        return [...this.records.values()];
+    }
+    async query(filter) {
+        return [...this.records.values()].filter((r) => matchesFilter(r, filter));
+    }
+    async count(filter) {
+        return (await this.query(filter)).length;
+    }
+    async getById(recordId) {
+        return this.records.get(recordId);
+    }
+    async clear() {
+        this.records.clear();
+        this.syncTokens.clear();
+    }
+    async delete(filter) {
+        for (const [id, record] of this.records) {
+            if (matchesFilter(record, filter)) {
+                this.records.delete(id);
+            }
+        }
+    }
+    async evict(evictFilter) {
+        return this.delete(evictFilter);
+    }
+    async reconstructSyncToken(filter) {
+        let best;
+        for (const record of this.records.values()) {
+            if (record.serverUpdatedAt === undefined)
+                continue;
+            if (!matchesFilter(record, filter))
+                continue;
+            if (!best ||
+                record.serverUpdatedAt > best.serverUpdatedAt ||
+                (record.serverUpdatedAt === best.serverUpdatedAt &&
+                    record.revisionCount > best.revisionCount) ||
+                (record.serverUpdatedAt === best.serverUpdatedAt &&
+                    record.revisionCount === best.revisionCount &&
+                    record.recordId > best.recordId)) {
+                best = record;
+            }
+        }
+        if (!best || best.serverUpdatedAt === undefined)
+            return EMPTY_SYNC_TOKEN;
+        return encodeSyncToken({
+            updatedAt: best.serverUpdatedAt,
+            revisionCount: best.revisionCount,
+            recordId: best.recordId,
+        });
+    }
+    async setServerUpdatedAt(recordId, serverUpdatedAt) {
+        const record = this.records.get(recordId);
+        if (record) {
+            this.records.set(recordId, { ...record, serverUpdatedAt });
+        }
+    }
+    async setSyncToken(subscriptionId, token) {
+        this.syncTokens.set(subscriptionId, token);
+    }
+    async getSyncToken(subscriptionId) {
+        return this.syncTokens.get(subscriptionId);
+    }
+    async setSubscription(name, sub) {
+        this.subscriptions.set(name, sub);
+    }
+    async getSubscription(name) {
+        return this.subscriptions.get(name);
+    }
+    async getSubscriptionById(id) {
+        for (const sub of this.subscriptions.values()) {
+            if (sub.subscriptionId === id)
+                return sub;
+        }
+        return undefined;
+    }
+    async listSubscriptions() {
+        return [...this.subscriptions.values()];
+    }
+    async removeSubscription(name) {
+        this.subscriptions.delete(name);
+    }
+    async clearSubscriptions() {
+        this.subscriptions.clear();
+        this.syncTokens.clear();
+    }
+}
+//# sourceMappingURL=inMemoryStore.js.map

package/dist/inMemoryStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inMemoryStore.js","sourceRoot":"","sources":["../src/inMemoryStore.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,eAAe,EACf,aAAa,EACb,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAG9B;;;GAGG;AACH,MAAM,OAAO,aAAa;IAChB,OAAO,GAAG,IAAI,GAAG,EAAa,CAAC;IAC/B,UAAU,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC1C,aAAa,GAAG,IAAI,GAAG,EAAiC,CAAC;IAEjE;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,OAAuB;QACxC,MAAM,OAAO,GAAmB,EAAE,CAAC;QAEnC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;gBAC1B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACpC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACzD,IAAI,CAAC,QAAQ,IAAI,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,GAAG,EAAE,CAAC;oBACjE,oDAAoD;oBACpD,MAAM,YAAY,GAAM;wBACtB,GAAG,KAAK,CAAC,MAAM;wBACf,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS;qBACxC,CAAC;oBACF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;oBACtD,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAS;QACnB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,MAAM;QACV,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAA0B;QACpC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC7C,aAAa,CAAC,CAA4B,EAAE,MAAM,CAAC,CACpD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAA0B;QACpC,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAA0B;QACrC,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACxC,IAAI,aAAa,CAAC,MAAiC,EAAE,MAAM,CAAC,EAAE,CAAC;gBAC7D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,WAA+B;QACzC,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,oBAAoB,CACxB,MAA6B;QAE7B,IAAI,IAAmB,CAAC;QAExB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS;gBAAE,SAAS;YACnD,IAAI,CAAC,aAAa,CAAC,MAAiC,EAAE,MAAM,CAAC;gBAAE,SAAS;YAExE,IACE,CAAC,IAAI;gBACL,MAAM,CAAC,eAAe,GAAG,IAAI,CAAC,eAAgB;gBAC9C,CAAC,MAAM,CAAC,eAAe,KAAK,IAAI,CAAC,eAAe;oBAC9C,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;gBAC5C,CAAC,MAAM,CAAC,eAAe,KAAK,IAAI,CAAC,eAAe;oBAC9C,MAAM,CAAC,aAAa,KAAK,IAAI,CAAC,aAAa;oBAC3C,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,EAClC,CAAC;gBACD,IAAI,GAAG,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS;YAAE,OAAO,gBAAgB,CAAC;QAEzE,OAAO,eAAe,CAAC;YACrB,SAAS,EAAE,IAAI,CAAC,eAAe;YAC/B,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,kBAAkB,CACtB,QAAgB,EAChB,eAAuB;QAEvB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,GAAG,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,cAAsB,EAAE,KAAgB;QACzD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,cAAsB;QACvC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,IAAY,EACZ,GAA0B;QAE1B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,IAAY;QAEZ,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,EAAU;QAEV,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;YAC9C,IAAI,GAAG,CAAC,cAAc,KAAK,EAAE;gBAAE,OAAO,GAAG,CAAC;QAC5C,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,OAAO,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,IAAY;QACnC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,kBAAkB;QACtB,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { SyncClient } from "./syncClient.js";
+export { InMemoryStore } from "./inMemoryStore.js";
+export { IdbLocalStore } from "./idbLocalStore.js";
+export { createFetchTransport } from "./fetchTransport.js";
+export type { FetchTransportOptions } from "./fetchTransport.js";
+export type { ClientSubscription, ClientSubscriptionOptions, ILocalStore, PatchListener, PersistedSubscription, SyncQuery, SyncTransport, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjE,YAAY,EACV,kBAAkB,EAClB,yBAAyB,EACzB,WAAW,EACX,aAAa,EACb,qBAAqB,EACrB,SAAS,EACT,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { SyncClient } from "./syncClient.js";
+export { InMemoryStore } from "./inMemoryStore.js";
+export { IdbLocalStore } from "./idbLocalStore.js";
+export { createFetchTransport } from "./fetchTransport.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/syncClient.d.ts

@@ -0,0 +1,111 @@
+import { type SyncRecord, type SubscriptionFilter, type TableSchema } from "@sync-subscribe/core";
+import type { ClientSubscription, ClientSubscriptionOptions, ILocalStore, PatchListener, SyncQuery, SyncTransport } from "./types.js";
+/**
+ * High-level client that manages subscriptions, local state, and sync cycles.
+ *
+ * Pass a custom `store` to use IndexedDB persistence:
+ *   new SyncClient(transport, new IdbLocalStore("my-db"))
+ *
+ * Omit `store` to use the default in-memory store.
+ */
+export declare class SyncClient<T extends SyncRecord> {
+    private readonly transport;
+    private readonly schema?;
+    private listeners;
+    private activeSubs;
+    private subActiveListeners;
+    private _stopStream;
+    private _streamTimer;
+    private pendingPull;
+    readonly store: ILocalStore<T>;
+    constructor(transport: SyncTransport, store?: ILocalStore<T>, schema?: TableSchema<T> | undefined);
+    /** Serial queue — subscribe() calls run one at a time to prevent races. */
+    private subscribeQueue;
+    subscribe(options: ClientSubscriptionOptions): Promise<ClientSubscription>;
+    private _subscribe;
+    private checkForEviction;
+    /** Checks if the new inputFilter results in a gap we need to fill */
+    private checkForGap;
+    /**
+     * Update an existing subscription to use a new filter.
+     * Delegates to subscribe() with previousSubscriptionId set.
+     */
+    updateSubscription(subscriptionId: string, newFilter: SubscriptionFilter): Promise<ClientSubscription>;
+    /**
+     * Pull patches for all subscriptions.
+     * - ACTIVE subscriptions are included directly.
+     * - PENDING subscriptions are excluded; their gap sub is included instead.
+     * When a gap sub's token appears in the response the gap is complete:
+     * the gap sub is removed, the parent subscription reconstructs its token
+     * and transitions to active.
+     */
+    pull(): Promise<void>;
+    /**
+     * Debounced pull — collapses multiple rapid calls (e.g. several hooks mounting
+     * at the same time) into a single transport request. All callers share the same
+     * promise and receive the result of the one batched pull.
+     *
+     * @param delayMs - How long to wait before issuing the pull (default 20 ms).
+     */
+    schedulePull(delayMs?: number): Promise<void>;
+    private _flushPull;
+    /**
+     * Write a record locally (read-your-own-writes) then push to server.
+     * Returns true on success, false if a conflict was detected (server wins).
+     */
+    mutate(record: T): Promise<boolean>;
+    /**
+     * Returns a reactive handle to a filtered view of the local store.
+     * Does NOT register a sync subscription — use this when data is already
+     * being synced via a separate `subscribe()` call (e.g. a background sync).
+     *
+     * Loading starts `true`, becomes `false` after the first local read.
+     * Re-runs whenever the store changes (pull patches, mutations).
+     */
+    query(options: {
+        filter: SubscriptionFilter<T>;
+    }): SyncQuery<T>;
+    /**
+     * Returns a reactive handle that also manages its own sync subscription.
+     * The sync subscription is registered when the first caller subscribes and
+     * removed when the last caller unsubscribes.
+     *
+     * Use this when the sync filter and the query filter are the same.
+     * For a narrower in-memory view of a broader background sync, use `query()`.
+     */
+    liveQuery(options: {
+        filter: SubscriptionFilter<T>;
+        name?: string;
+    }): SyncQuery<T>;
+    /**
+     * Debounced (re)start of the SSE stream. Collapses multiple rapid calls
+     * (e.g. several hooks subscribing at once) into a single connection open.
+     * Called automatically by subscribe(), unsubscribe(), and gap-fill completion.
+     */
+    private _syncStream;
+    private _applyStreamState;
+    /**
+     * Remove a subscription and restart the stream without it.
+     * If no active subscriptions remain the stream is stopped.
+     */
+    unsubscribe(subscriptionId: string): Promise<void>;
+    onPatches(listener: PatchListener<T>): () => void;
+    /**
+     * Register a one-shot listener that fires when the given subscription
+     * transitions from pending_gap_fill → active. Useful for restarting the
+     * SSE stream to include the newly-active subscription.
+     * Returns an unsubscribe function.
+     */
+    onSubscriptionActive(subscriptionId: string, listener: () => void): () => void;
+    private _emitSubscriptionActive;
+    private emit;
+    /**
+     * Look up a subscription by name (for named subs) or by subscriptionId
+     * (for unnamed subs, where the key IS the subscriptionId).
+     */
+    getSubscription(key: string): ClientSubscription | undefined;
+    getSubscriptionById(id: string): ClientSubscription | undefined;
+    /** Resets sync state (useful for logout / account switch). */
+    reset(): Promise<void>;
+}
+//# sourceMappingURL=syncClient.d.ts.map

package/dist/syncClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncClient.d.ts","sourceRoot":"","sources":["../src/syncClient.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EAGf,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAOjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,kBAAkB,EAClB,yBAAyB,EACzB,WAAW,EACX,aAAa,EAIb,SAAS,EACT,aAAa,EACd,MAAM,YAAY,CAAC;AAGpB;;;;;;;GAOG;AACH,qBAAa,UAAU,CAAC,CAAC,SAAS,UAAU;IAiBxC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAG1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAnB1B,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,UAAU,CAA4C;IAC9D,OAAO,CAAC,kBAAkB,CAAsC;IAChE,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,YAAY,CAA8C;IAElE,OAAO,CAAC,WAAW,CAKH;IAEhB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;gBAGZ,SAAS,EAAE,aAAa,EACzC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EAEL,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,YAAA;IAS1C,2EAA2E;IAC3E,OAAO,CAAC,cAAc,CAAuC;IAE7D,SAAS,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAO5D,UAAU;YAuFV,gBAAgB;IAmB9B,qEAAqE;YACvD,WAAW;IAqDzB;;;OAGG;IACG,kBAAkB,CACtB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,kBAAkB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;IAiB9B;;;;;;;OAOG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA8E3B;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC;YAkB3B,UAAU;IAYxB;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAuCzC;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAA;KAAE,GAAG,SAAS,CAAC,CAAC,CAAC;IA0B/D;;;;;;;OAOG;IACH,SAAS,CAAC,OAAO,EAAE;QACjB,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,SAAS,CAAC,CAAC,CAAC;IAgEhB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,iBAAiB;IAwCzB;;;OAGG;IACG,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBxD,SAAS,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAOjD;;;;;OAKG;IACH,oBAAoB,CAClB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,IAAI,GACnB,MAAM,IAAI;IAUb,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,IAAI;IAQZ;;;OAGG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAW5D,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI/D,8DAA8D;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAa7B"}