@slimr/dbsync 0.0.3

package/cjs/internal/SyncEngine.js

@@ -0,0 +1,191 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SyncEngine = void 0;
+const promiseWithResolvers_js_1 = require("../util/promiseWithResolvers.js");
+class SyncEngine {
+    config;
+    syncInterval;
+    events;
+    storage;
+    auth;
+    adapter;
+    onSchemaChange;
+    syncSetInterval = null;
+    constructor(config, syncInterval, events, storage, auth, adapter, onSchemaChange) {
+        this.config = config;
+        this.syncInterval = syncInterval;
+        this.events = events;
+        this.storage = storage;
+        this.auth = auth;
+        this.adapter = adapter;
+        this.onSchemaChange = onSchemaChange;
+    }
+    enable() {
+        if (!this.syncSetInterval) {
+            this.syncSetInterval = setInterval(() => this.sync(), this.syncInterval);
+        }
+    }
+    disable() {
+        if (this.syncSetInterval) {
+            clearInterval(this.syncSetInterval);
+            this.syncSetInterval = null;
+        }
+    }
+    get isEnabled() {
+        return !!this.syncSetInterval;
+    }
+    get isLive() {
+        const lastSuccess = localStorage.getItem("dbsync-lastSuccessAt");
+        if (!lastSuccess)
+            return false;
+        return Date.now() - new Date(lastSuccess).getTime() < this.syncInterval * 4;
+    }
+    async waitForLive() {
+        const { promise, resolve, reject } = (0, promiseWithResolvers_js_1.promiseWithResolvers)();
+        if (!this.isEnabled) {
+            reject(new Error("Sync disabled"));
+            return promise;
+        }
+        const check = setInterval(() => {
+            if (this.isLive) {
+                clearInterval(check);
+                resolve();
+            }
+        }, this.syncInterval);
+        return promise;
+    }
+    async triggerSync() {
+        await this.sync();
+    }
+    async sync() {
+        if (typeof navigator !== "undefined" && navigator.locks) {
+            await navigator.locks.request("dbsync-leader", async () => {
+                await this.performSync();
+            });
+        }
+        else {
+            await this.performSync();
+        }
+    }
+    async performSync() {
+        this.events.setState("syncing");
+        try {
+            await this.syncPull();
+            await this.syncPush();
+            this.events.setState("idle");
+            this.auth.isAuth = true;
+            localStorage.setItem("dbsync-lastSuccessAt", new Date().toISOString());
+        }
+        catch (err) {
+            if (err.status === 401) {
+                this.auth.isAuth = false;
+                this.disable();
+            }
+            this.events.setState("error");
+        }
+    }
+    get schemaSignature() {
+        const tables = Object.keys(this.config.tables)
+            .sort()
+            .map((table) => {
+            return {
+                table,
+                indexes: this.config.tables[table].indexes?.slice().sort() || [],
+            };
+        });
+        return JSON.stringify(tables);
+    }
+    async syncPull() {
+        let hasMore = true;
+        while (hasMore) {
+            const cursor = localStorage.getItem("dbsync-pullSyncedUpTo") || "";
+            const data = await this.adapter.pull(cursor);
+            if (data.items && data.items.length > 0) {
+                const tx = this.storage.getTransaction();
+                data.items.forEach((post) => {
+                    if (post.variant === "__dbsync_system" && post.id === "version") {
+                        const remoteContent = JSON.parse(post.content);
+                        if (this.config.version !== undefined) {
+                            if (remoteContent.version && remoteContent.version > this.config.version) {
+                                this.onSchemaChange();
+                            }
+                        }
+                        else {
+                            const currentSignature = this.schemaSignature;
+                            if (remoteContent.signature && remoteContent.signature !== currentSignature) {
+                                this.onSchemaChange();
+                            }
+                        }
+                        return;
+                    }
+                    const storeName = post.variant;
+                    if (post.isDeleted)
+                        tx.delete(storeName, post.id);
+                    else
+                        tx.put(storeName, { id: post.id, ...JSON.parse(post.content) });
+                });
+                await tx.commit();
+                localStorage.setItem("dbsync-pullSyncedUpTo", data.items[data.items.length - 1].updatedAt);
+            }
+            hasMore = data.hasMore;
+        }
+    }
+    async syncPush() {
+        const dirty = await this.storage.findAll("dirtyQueue");
+        const deleted = await this.storage.findAll("deletedQueue");
+        const payload = [
+            ...dirty.map((d) => ({
+                id: d.id,
+                variant: d.table,
+                content: JSON.stringify(d.payload),
+                isDeleted: false,
+                updatedAt: new Date(d.timestamp).toISOString(),
+            })),
+            ...deleted.map((d) => ({
+                id: d.id,
+                variant: d.table,
+                content: "{}",
+                isDeleted: true,
+                updatedAt: new Date(d.timestamp).toISOString(),
+            })),
+        ];
+        if (this.config.version !== undefined) {
+            const localVersion = Number(localStorage.getItem("dbsync-version") || "0");
+            if (this.config.version > localVersion) {
+                payload.push({
+                    id: "version",
+                    variant: "__dbsync_system",
+                    content: JSON.stringify({ version: this.config.version }),
+                    isDeleted: false,
+                    updatedAt: new Date().toISOString(),
+                });
+            }
+        }
+        else {
+            const currentSignature = this.schemaSignature;
+            const storedSyncSig = localStorage.getItem("dbsync-sync-signature") || "";
+            if (currentSignature !== storedSyncSig) {
+                payload.push({
+                    id: "version",
+                    variant: "__dbsync_system",
+                    content: JSON.stringify({ signature: currentSignature }),
+                    isDeleted: false,
+                    updatedAt: new Date().toISOString(),
+                });
+            }
+        }
+        if (payload.length > 0) {
+            await this.adapter.push(payload);
+            if (this.config.version !== undefined)
+                localStorage.setItem("dbsync-version", String(this.config.version));
+            else
+                localStorage.setItem("dbsync-sync-signature", this.schemaSignature);
+            const tx = this.storage.getTransaction();
+            dirty.forEach((d) => tx.delete("dirtyQueue", d.id));
+            deleted.forEach((d) => tx.delete("deletedQueue", d.id));
+            await tx.commit();
+        }
+    }
+}
+exports.SyncEngine = SyncEngine;
+//# sourceMappingURL=SyncEngine.js.map

package/cjs/internal/SyncEngine.js.map

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

package/cjs/internal/utils.d.ts

@@ -0,0 +1 @@
+export declare function genUuid(): `${string}-${string}-${string}-${string}-${string}`;

package/cjs/internal/utils.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genUuid = genUuid;
+function genUuid() {
+    return crypto.randomUUID();
+}
+//# sourceMappingURL=utils.js.map

package/cjs/internal/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/internal/utils.ts"],"names":[],"mappings":";;AAAA,0BAEC;AAFD,SAAgB,OAAO;IACtB,OAAO,MAAM,CAAC,UAAU,EAAE,CAAA;AAC3B,CAAC"}

package/cjs/react.d.ts

@@ -0,0 +1 @@
+export * from "./useDbQuery.js";

package/cjs/react.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./useDbQuery.js"), exports);
+//# sourceMappingURL=react.js.map

package/cjs/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAA+B"}

package/cjs/useDbQuery.d.ts

@@ -0,0 +1,13 @@
+import type { DbSync } from "./DbSync.js";
+/**
+ * A React hook that subscribes to one or more `DbSync` tables and natively
+ * re-evaluates a strictly typed query function whenever local mutations or
+ * background sync events alter the underlying data.
+ *
+ * @param db The initialized `DbSync` instance.
+ * @param stores A string or array of strings containing the table names the query function reads from.
+ * @param queryFn An asynchronous function invoked to pull data from IndexedDB.
+ * @param deps A standard React dependency array for parameters referenced inside the `queryFn`.
+ * @returns The resolved data of the `queryFn`, or `undefined` while the initial fetch evaluates.
+ */
+export declare function useDbQuery<T>(db: DbSync, stores: string | string[], queryFn: () => Promise<T>, deps?: any[]): T | undefined;

package/cjs/useDbQuery.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useDbQuery = useDbQuery;
+const react_1 = require("react");
+/**
+ * A React hook that subscribes to one or more `DbSync` tables and natively
+ * re-evaluates a strictly typed query function whenever local mutations or
+ * background sync events alter the underlying data.
+ *
+ * @param db The initialized `DbSync` instance.
+ * @param stores A string or array of strings containing the table names the query function reads from.
+ * @param queryFn An asynchronous function invoked to pull data from IndexedDB.
+ * @param deps A standard React dependency array for parameters referenced inside the `queryFn`.
+ * @returns The resolved data of the `queryFn`, or `undefined` while the initial fetch evaluates.
+ */
+function useDbQuery(db, stores, queryFn, deps = []) {
+    const [data, setData] = (0, react_1.useState)(undefined);
+    const storeArray = Array.isArray(stores) ? stores : [stores];
+    (0, react_1.useEffect)(() => {
+        let isMounted = true;
+        const fetchData = async () => {
+            if (!db.initted) {
+                // If attempting to query before init(), safely wait
+                await new Promise((resolve) => {
+                    const check = setInterval(() => {
+                        if (!isMounted || db.initted) {
+                            clearInterval(check);
+                            resolve();
+                        }
+                    }, 50);
+                });
+            }
+            try {
+                const result = await queryFn();
+                if (isMounted)
+                    setData(result);
+            }
+            catch (err) {
+                console.error("[dbsync useDbQuery]: Query failed", err);
+            }
+        };
+        // Initial fetch
+        fetchData();
+        // Subscribe to relevant stores
+        const sub = db.subscribe((updatedStores) => {
+            const shouldUpdate = updatedStores.some((s) => storeArray.includes(s));
+            if (shouldUpdate) {
+                fetchData();
+            }
+        });
+        return () => {
+            isMounted = false;
+            sub.close();
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [db, JSON.stringify(storeArray), ...deps]);
+    return data;
+}
+//# sourceMappingURL=useDbQuery.js.map

package/cjs/useDbQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDbQuery.js","sourceRoot":"","sources":["../src/useDbQuery.ts"],"names":[],"mappings":";;AAcA,gCAmDC;AAjED,iCAA2C;AAG3C;;;;;;;;;;GAUG;AACH,SAAgB,UAAU,CACzB,EAAU,EACV,MAAyB,EACzB,OAAyB,EACzB,OAAc,EAAE;IAEhB,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,IAAA,gBAAQ,EAAgB,SAAS,CAAC,CAAA;IAC1D,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;IAE5D,IAAA,iBAAS,EAAC,GAAG,EAAE;QACd,IAAI,SAAS,GAAG,IAAI,CAAA;QAEpB,MAAM,SAAS,GAAG,KAAK,IAAI,EAAE;YAC5B,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;gBACjB,oDAAoD;gBACpD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;oBACnC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;wBAC9B,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;4BAC9B,aAAa,CAAC,KAAK,CAAC,CAAA;4BACpB,OAAO,EAAE,CAAA;wBACV,CAAC;oBACF,CAAC,EAAE,EAAE,CAAC,CAAA;gBACP,CAAC,CAAC,CAAA;YACH,CAAC;YACD,IAAI,CAAC;gBACJ,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAA;gBAC9B,IAAI,SAAS;oBAAE,OAAO,CAAC,MAAM,CAAC,CAAA;YAC/B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACd,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,GAAG,CAAC,CAAA;YACxD,CAAC;QACF,CAAC,CAAA;QAED,gBAAgB;QAChB,SAAS,EAAE,CAAA;QAEX,+BAA+B;QAC/B,MAAM,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,aAAa,EAAE,EAAE;YAC1C,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;YACtE,IAAI,YAAY,EAAE,CAAC;gBAClB,SAAS,EAAE,CAAA;YACZ,CAAC;QACF,CAAC,CAAC,CAAA;QAEF,OAAO,GAAG,EAAE;YACX,SAAS,GAAG,KAAK,CAAA;YACjB,GAAG,CAAC,KAAK,EAAE,CAAA;QACZ,CAAC,CAAA;QACD,uDAAuD;IACxD,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAA;IAE7C,OAAO,IAAI,CAAA;AACZ,CAAC"}

package/cjs/util/promiseWithResolvers.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Creates a promise together with its external resolve and reject handlers.
+ *
+ * This mirrors `Promise.withResolvers()` in environments that do not provide
+ * the built-in helper yet.
+ */
+export declare function promiseWithResolvers<T>(): {
+    promise: Promise<T>;
+    resolve: (value: T | PromiseLike<T>) => void;
+    reject: (reason?: any) => void;
+};

package/cjs/util/promiseWithResolvers.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.promiseWithResolvers = promiseWithResolvers;
+/**
+ * Creates a promise together with its external resolve and reject handlers.
+ *
+ * This mirrors `Promise.withResolvers()` in environments that do not provide
+ * the built-in helper yet.
+ */
+function promiseWithResolvers() {
+    let resolve;
+    let reject;
+    const promise = new Promise((res, rej) => {
+        resolve = res;
+        reject = rej;
+    });
+    return { promise, resolve, reject };
+}
+//# sourceMappingURL=promiseWithResolvers.js.map

package/cjs/util/promiseWithResolvers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promiseWithResolvers.js","sourceRoot":"","sources":["../../src/util/promiseWithResolvers.ts"],"names":[],"mappings":";;AAMA,oDAQC;AAdD;;;;;GAKG;AACH,SAAgB,oBAAoB;IACnC,IAAI,OAA6C,CAAA;IACjD,IAAI,MAA+B,CAAA;IACnC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC3C,OAAO,GAAG,GAAG,CAAA;QACb,MAAM,GAAG,GAAG,CAAA;IACb,CAAC,CAAC,CAAA;IACF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;AACpC,CAAC"}

package/esm/DbRepository.d.ts

@@ -0,0 +1,59 @@
+import type { DbSync } from "./DbSync.js";
+/**
+ * A typed repository wrapper for a single `DbSync` object store.
+ * Provides a localized CRUD interface to minimize boilerplate and
+ * enforce consistent data types for a specific table.
+ */
+export declare class DbRepository<T> {
+    protected db: DbSync;
+    readonly storeName: string;
+    /**
+     * Initializes a new repository tied to a specific object store.
+     *
+     * @param db The centralized `DbSync` instance.
+     * @param storeName The name of the object store this repository will manage.
+     */
+    constructor(db: DbSync, storeName: string);
+    /**
+     * Retrieves a single record by its primary key.
+     *
+     * @param id The primary key of the record to retrieve.
+     * @returns A promise resolving to the typed record, or `undefined` if not found.
+     */
+    findById(id: string | number): Promise<T | undefined>;
+    /**
+     * Retrieves all records currently held in the object store.
+     *
+     * @returns A promise resolving to an array of all typed records.
+     */
+    findAll(): Promise<T[]>;
+    /**
+     * Inserts a new record into the object store.
+     *
+     * @param value The object payload to insert.
+     * @param key An optional explicit primary key.
+     * @returns A promise resolving to the newly inserted record.
+     */
+    add(value: Partial<T>, key?: string | number): Promise<T>;
+    /**
+     * Inserts or updates an existing record in the object store.
+     *
+     * @param value The complete object to upsert.
+     * @param key An optional explicit primary key.
+     * @returns A promise resolving to the upserted record.
+     */
+    put(value: T, key?: string | number): Promise<T>;
+    /**
+     * Removes a record from the object store by its primary key.
+     *
+     * @param key The primary key of the record to delete.
+     * @returns A promise resolving when the deletion is complete.
+     */
+    delete(key: string | number): Promise<void>;
+    /**
+     * Discards all records present in the object store.
+     *
+     * @returns A promise resolving when the store has been completely cleared.
+     */
+    clear(): Promise<void>;
+}

package/esm/DbRepository.js

@@ -0,0 +1,74 @@
+/**
+ * A typed repository wrapper for a single `DbSync` object store.
+ * Provides a localized CRUD interface to minimize boilerplate and
+ * enforce consistent data types for a specific table.
+ */
+export class DbRepository {
+    db;
+    storeName;
+    /**
+     * Initializes a new repository tied to a specific object store.
+     *
+     * @param db The centralized `DbSync` instance.
+     * @param storeName The name of the object store this repository will manage.
+     */
+    constructor(db, storeName) {
+        this.db = db;
+        this.storeName = storeName;
+    }
+    /**
+     * Retrieves a single record by its primary key.
+     *
+     * @param id The primary key of the record to retrieve.
+     * @returns A promise resolving to the typed record, or `undefined` if not found.
+     */
+    async findById(id) {
+        return this.db.get(this.storeName, id);
+    }
+    /**
+     * Retrieves all records currently held in the object store.
+     *
+     * @returns A promise resolving to an array of all typed records.
+     */
+    async findAll() {
+        return this.db.findAll(this.storeName);
+    }
+    /**
+     * Inserts a new record into the object store.
+     *
+     * @param value The object payload to insert.
+     * @param key An optional explicit primary key.
+     * @returns A promise resolving to the newly inserted record.
+     */
+    async add(value, key) {
+        return this.db.add(this.storeName, value, key);
+    }
+    /**
+     * Inserts or updates an existing record in the object store.
+     *
+     * @param value The complete object to upsert.
+     * @param key An optional explicit primary key.
+     * @returns A promise resolving to the upserted record.
+     */
+    async put(value, key) {
+        return this.db.put(this.storeName, value, key);
+    }
+    /**
+     * Removes a record from the object store by its primary key.
+     *
+     * @param key The primary key of the record to delete.
+     * @returns A promise resolving when the deletion is complete.
+     */
+    async delete(key) {
+        return this.db.delete(this.storeName, key);
+    }
+    /**
+     * Discards all records present in the object store.
+     *
+     * @returns A promise resolving when the store has been completely cleared.
+     */
+    async clear() {
+        return this.db.clear(this.storeName);
+    }
+}
+//# sourceMappingURL=DbRepository.js.map

package/esm/DbRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DbRepository.js","sourceRoot":"","sources":["../src/DbRepository.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,YAAY;IAQb;IACM;IARjB;;;;;OAKG;IACH,YACW,EAAU,EACJ,SAAiB;QADvB,OAAE,GAAF,EAAE,CAAQ;QACJ,cAAS,GAAT,SAAS,CAAQ;IAC/B,CAAC;IAEJ;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,EAAmB;QACjC,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;IAC1C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO;QACZ,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,CAAI,IAAI,CAAC,SAAS,CAAC,CAAA;IAC1C,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,CAAC,KAAiB,EAAE,GAAqB;QACjD,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAI,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;IAClD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,CAAC,KAAQ,EAAE,GAAqB;QACxC,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAI,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;IAClD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,GAAoB;QAChC,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;IAC3C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK;QACV,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACrC,CAAC;CACD"}

package/esm/DbSync.d.ts

@@ -0,0 +1,51 @@
+import type { BackendAdapter } from "./adapters/types.js";
+import { type SyncState } from "./internal/EventBus.js";
+import { StorageManager } from "./internal/StorageManager.js";
+export interface DbSyncConfig {
+    adapter: BackendAdapter;
+    version?: number;
+    tables: Record<string, {
+        indexes?: string[];
+    }>;
+}
+export type { SyncState };
+export declare class DbSync {
+    syncInterval: number;
+    config: DbSyncConfig;
+    private events;
+    storage: StorageManager;
+    private syncEngine;
+    private authManager;
+    constructor(config: DbSyncConfig);
+    genUuid(): `${string}-${string}-${string}-${string}-${string}`;
+    get initted(): boolean;
+    init(): Promise<void>;
+    getTransaction(): import("./internal/DbTransaction.js").DbTransaction;
+    get<T>(storeName: string, id: string | number): Promise<T | undefined>;
+    findAll<T>(storeName: string): Promise<T[]>;
+    add<T>(storeName: string, value: any, key?: string | number): Promise<T>;
+    put<T>(storeName: string, value: any, key?: string | number): Promise<T>;
+    delete(storeName: string, key: string | number): Promise<void>;
+    clear(storeName: string): Promise<void>;
+    subscribe(callback: (stores: string[]) => void): {
+        close: () => boolean;
+    };
+    onSyncStateChange(callback: (state: SyncState) => void): {
+        close: () => boolean;
+    };
+    get isAuth(): boolean;
+    checkAuth(): Promise<boolean>;
+    login(email: string, code: string): Promise<void>;
+    logout(): Promise<void>;
+    reset(): Promise<void>;
+    get isEnabled(): boolean;
+    get isLive(): boolean;
+    enable(): void;
+    disable(): void;
+    waitForLive(): Promise<void>;
+    triggerSync(): Promise<void>;
+    startSyncInterval(): void;
+    stopSyncInterval(): void;
+    protected onSchemaChangeDetected(): void;
+    dispose(): void;
+}

package/esm/DbSync.js

@@ -0,0 +1,119 @@
+import { AuthManager } from "./internal/AuthManager.js";
+import { EventBus } from "./internal/EventBus.js";
+import { StorageManager } from "./internal/StorageManager.js";
+import { SyncEngine } from "./internal/SyncEngine.js";
+import { genUuid } from "./internal/utils.js";
+export class DbSync {
+    syncInterval = 5000;
+    config;
+    // Internal managers
+    events;
+    storage; // Public for tests currently (we can wrap it later)
+    syncEngine;
+    authManager;
+    constructor(config) {
+        this.config = config;
+        this.events = new EventBus();
+        const adapter = config.adapter;
+        const onSchemaChange = () => this.onSchemaChangeDetected();
+        this.storage = new StorageManager(config, this.events, onSchemaChange);
+        this.authManager = new AuthManager(adapter, this.storage, () => this.disable());
+        this.syncEngine = new SyncEngine(config, this.syncInterval, this.events, this.storage, this.authManager, adapter, onSchemaChange);
+    }
+    // Facade to Utils
+    genUuid() {
+        return genUuid();
+    }
+    // Facade to StorageManager
+    get initted() {
+        return this.storage.initted;
+    }
+    async init() {
+        return this.storage.init();
+    }
+    getTransaction() {
+        return this.storage.getTransaction();
+    } // Exported temporarily for tests
+    async get(storeName, id) {
+        return this.storage.get(storeName, id);
+    }
+    async findAll(storeName) {
+        return this.storage.findAll(storeName);
+    }
+    async add(storeName, value, key) {
+        await this.storage.executeTransaction([{ type: "add", storeName, value, key }]);
+        return value;
+    }
+    async put(storeName, value, key) {
+        await this.storage.executeTransaction([{ type: "put", storeName, value, key }]);
+        return value;
+    }
+    async delete(storeName, key) {
+        await this.storage.executeTransaction([{ type: "delete", storeName, key }]);
+    }
+    async clear(storeName) {
+        await this.storage.executeTransaction([{ type: "clear", storeName }]);
+    }
+    // Facade to EventBus
+    subscribe(callback) {
+        return this.events.subscribe(callback);
+    }
+    onSyncStateChange(callback) {
+        return this.events.onSyncStateChange(callback);
+    }
+    // Facade to AuthManager
+    get isAuth() {
+        return this.authManager.isAuth;
+    }
+    async checkAuth() {
+        return this.authManager.checkAuth();
+    }
+    async login(email, code) {
+        return this.authManager.login(email, code);
+    }
+    async logout() {
+        return this.authManager.logout();
+    }
+    async reset() {
+        return this.authManager.reset();
+    }
+    // Facade to SyncEngine
+    get isEnabled() {
+        return this.syncEngine.isEnabled;
+    }
+    get isLive() {
+        return this.syncEngine.isLive;
+    }
+    enable() {
+        this.syncEngine.enable();
+    }
+    disable() {
+        this.syncEngine.disable();
+    }
+    async waitForLive() {
+        return this.syncEngine.waitForLive();
+    }
+    async triggerSync() {
+        return this.syncEngine.triggerSync();
+    }
+    // Legacy aliases
+    startSyncInterval() {
+        this.enable();
+    }
+    stopSyncInterval() {
+        this.disable();
+    }
+    onSchemaChangeDetected() {
+        this.storage.dispose();
+        this.disable();
+        if (typeof window !== "undefined") {
+            window.location.reload();
+        }
+    }
+    dispose() {
+        this.disable();
+        this.events.dispose();
+        this.storage.dispose();
+    }
+}
+//# sourceMappingURL=DbSync.js.map