@slimr/dbsync 0.0.5 → 0.0.7

package/README.md

@@ -23,7 +23,7 @@ npm install @slimr/dbsync
 ```
 
 ## Quick Start
-You instantiate `dbsync` by supplying your backend [adapter](./src/adapters/Adapters.md) and your table/index definitions. Afterwards, you must call `.init()` to safely generate the database.
+You instantiate `dbsync` by supplying your backend [adapter](./docs/Adapters.md) and your table/index definitions. Afterwards, you must call `.init()` to safely generate the database.
 
 ```typescript
 import { DbSync } from '@slimr/dbsync';
@@ -39,8 +39,8 @@ const db = new DbSync({
     }
 });
 
-// Await init before usage
-await db.init();
+// Init the db and boot up the background sync engine!
+await db.start();
 ```
 
 > **Local-Only No-Sync Database:** If you want all the IndexedDB ORM and reactive features, but completely lack a remote database to sync to, simply import `LocalAdapter` from `@slimr/dbsync/adapters` and pass that into the constructor instead. It acts as an empty black box so your operations succeed cleanly entirely on the client.
@@ -164,10 +164,10 @@ To boot up the network synchronizer to clear those queues and fetch server updat
 
 ```typescript
 // Start polling the swift-crud backend every 5 seconds
-db.enable();
+await db.start();
 
 // Stop polling
-db.disable();
+await db.stop();
 ```
 
 Only one tab on a user's device will act as the "Leader" and poll the network at any time using **Web Locks**. All other tabs remain completely idle and rely on `BroadcastChannel` messages from the Leader tab to reactively update their UI when fresh data drops.

package/cjs/DbSync.d.ts

@@ -2,50 +2,94 @@ import type { BackendAdapter } from "./adapters/types.js";
 import { type SyncState } from "./internal/EventBus.js";
 import { StorageManager } from "./internal/StorageManager.js";
 export interface DbSyncConfig {
+    /** The backend adapter used for authentication and synchronization. */
     adapter: BackendAdapter;
+    /** Optional fixed IndexedDB version. */
     version?: number;
+    /** The object stores and their index definitions. */
     tables: Record<string, {
         indexes?: string[];
     }>;
 }
 export type { SyncState };
+/**
+ * The public facade for the dbsync engine.
+ */
 export declare class DbSync {
+    /** The polling interval used by the sync engine in milliseconds. */
     syncInterval: number;
+    /** The active configuration passed by the consumer. */
     config: DbSyncConfig;
+    /** The event bus used for local and cross-tab notifications. */
     private events;
+    /** The storage manager handling IndexedDB state and transactions. */
     storage: StorageManager;
+    /** The engine responsible for network synchronization. */
     private syncEngine;
+    /** The manager handling authentication and logout/reset behavior. */
     private authManager;
+    /**
+     * Creates a new `DbSync` instance using the supplied configuration.
+     *
+     * @param config The backend adapter, schema version, and table definitions.
+     */
     constructor(config: DbSyncConfig);
+    /** Returns a fresh RFC-4122 UUID. */
     genUuid(): `${string}-${string}-${string}-${string}-${string}`;
+    /** Whether the storage layer has finished initializing. */
     get initted(): boolean;
+    /** Initializes the underlying IndexedDB stores. */
     init(): Promise<void>;
+    /** Returns a queued transaction object for batched writes. */
     getTransaction(): import("./internal/DbTransaction.js").DbTransaction;
+    /** Reads a typed record by primary key. */
     get<T>(storeName: string, id: string | number): Promise<T | undefined>;
+    /** Reads all records from the given object store. */
     findAll<T>(storeName: string): Promise<T[]>;
+    /** Inserts a new record into the given object store. */
     add<T>(storeName: string, value: any, key?: string | number): Promise<T>;
+    /** Upserts a record into the given object store. */
     put<T>(storeName: string, value: any, key?: string | number): Promise<T>;
+    /** Deletes a record from the given object store. */
     delete(storeName: string, key: string | number): Promise<void>;
+    /** Clears all records from the given object store. */
     clear(storeName: string): Promise<void>;
+    /** Subscribes to store update notifications. */
     subscribe(callback: (stores: string[]) => void): {
         close: () => boolean;
     };
+    /** Subscribes to sync state changes. */
     onSyncStateChange(callback: (state: SyncState) => void): {
         close: () => boolean;
     };
+    /** Whether the current backend session is authenticated. */
     get isAuth(): boolean;
+    /** Verifies authentication against the backend adapter. */
     checkAuth(): Promise<boolean>;
+    /** Logs in with the given credentials. */
     login(email: string, code: string): Promise<void>;
+    /** Logs out and clears auth state. */
     logout(): Promise<void>;
+    /** Logs out and clears the local database. */
     reset(): Promise<void>;
-    get isEnabled(): boolean;
+    /** Whether background sync is currently enabled. */
+    get isStarted(): boolean;
+    /** Whether the sync engine has recently connected successfully. */
     get isLive(): boolean;
-    enable(): void;
-    disable(): void;
+    /** Starts periodic background synchronization. */
+    start(): Promise<void>;
+    /** Stops periodic background synchronization. */
+    stop(): Promise<void>;
+    /** Waits until the sync engine reports a live connection. */
     waitForLive(): Promise<void>;
+    /** Triggers a single sync cycle immediately. */
     triggerSync(): Promise<void>;
+    /** Legacy alias for `enable()`. */
     startSyncInterval(): void;
+    /** Legacy alias for `disable()`. */
     stopSyncInterval(): void;
+    /** Responds to schema changes by disposing state and reloading the page. */
     protected onSchemaChangeDetected(): void;
+    /** Disposes all background resources and event listeners. */
     dispose(): void;
 }

package/cjs/DbSync.js

@@ -6,115 +6,151 @@ const EventBus_js_1 = require("./internal/EventBus.js");
 const StorageManager_js_1 = require("./internal/StorageManager.js");
 const SyncEngine_js_1 = require("./internal/SyncEngine.js");
 const utils_js_1 = require("./internal/utils.js");
+/**
+ * The public facade for the dbsync engine.
+ */
 class DbSync {
+    /** The polling interval used by the sync engine in milliseconds. */
     syncInterval = 5000;
+    /** The active configuration passed by the consumer. */
     config;
-    // Internal managers
+    /** The event bus used for local and cross-tab notifications. */
     events;
+    /** The storage manager handling IndexedDB state and transactions. */
     storage; // Public for tests currently (we can wrap it later)
+    /** The engine responsible for network synchronization. */
     syncEngine;
+    /** The manager handling authentication and logout/reset behavior. */
     authManager;
+    /**
+     * Creates a new `DbSync` instance using the supplied configuration.
+     *
+     * @param config The backend adapter, schema version, and table definitions.
+     */
     constructor(config) {
         this.config = config;
         this.events = new EventBus_js_1.EventBus();
         const adapter = config.adapter;
         const onSchemaChange = () => this.onSchemaChangeDetected();
         this.storage = new StorageManager_js_1.StorageManager(config, this.events, onSchemaChange);
-        this.authManager = new AuthManager_js_1.AuthManager(adapter, this.storage, () => this.disable());
+        this.authManager = new AuthManager_js_1.AuthManager(adapter, this.storage, () => { void this.stop(); });
         this.syncEngine = new SyncEngine_js_1.SyncEngine(config, this.syncInterval, this.events, this.storage, this.authManager, adapter, onSchemaChange);
     }
-    // Facade to Utils
+    /** Returns a fresh RFC-4122 UUID. */
     genUuid() {
         return (0, utils_js_1.genUuid)();
     }
-    // Facade to StorageManager
+    /** Whether the storage layer has finished initializing. */
     get initted() {
         return this.storage.initted;
     }
+    /** Initializes the underlying IndexedDB stores. */
     async init() {
         return this.storage.init();
     }
+    /** Returns a queued transaction object for batched writes. */
     getTransaction() {
         return this.storage.getTransaction();
     } // Exported temporarily for tests
+    /** Reads a typed record by primary key. */
     async get(storeName, id) {
         return this.storage.get(storeName, id);
     }
+    /** Reads all records from the given object store. */
     async findAll(storeName) {
         return this.storage.findAll(storeName);
     }
+    /** Inserts a new record into the given object store. */
     async add(storeName, value, key) {
         await this.storage.executeTransaction([{ type: "add", storeName, value, key }]);
         return value;
     }
+    /** Upserts a record into the given object store. */
     async put(storeName, value, key) {
         await this.storage.executeTransaction([{ type: "put", storeName, value, key }]);
         return value;
     }
+    /** Deletes a record from the given object store. */
     async delete(storeName, key) {
         await this.storage.executeTransaction([{ type: "delete", storeName, key }]);
     }
+    /** Clears all records from the given object store. */
     async clear(storeName) {
         await this.storage.executeTransaction([{ type: "clear", storeName }]);
     }
-    // Facade to EventBus
+    /** Subscribes to store update notifications. */
     subscribe(callback) {
         return this.events.subscribe(callback);
     }
+    /** Subscribes to sync state changes. */
     onSyncStateChange(callback) {
         return this.events.onSyncStateChange(callback);
     }
-    // Facade to AuthManager
+    /** Whether the current backend session is authenticated. */
     get isAuth() {
         return this.authManager.isAuth;
     }
+    /** Verifies authentication against the backend adapter. */
     async checkAuth() {
         return this.authManager.checkAuth();
     }
+    /** Logs in with the given credentials. */
     async login(email, code) {
         return this.authManager.login(email, code);
     }
+    /** Logs out and clears auth state. */
     async logout() {
         return this.authManager.logout();
     }
+    /** Logs out and clears the local database. */
     async reset() {
         return this.authManager.reset();
     }
-    // Facade to SyncEngine
-    get isEnabled() {
-        return this.syncEngine.isEnabled;
+    /** Whether background sync is currently enabled. */
+    get isStarted() {
+        return this.syncEngine.isStarted;
     }
+    /** Whether the sync engine has recently connected successfully. */
     get isLive() {
         return this.syncEngine.isLive;
     }
-    enable() {
-        this.syncEngine.enable();
+    /** Starts periodic background synchronization. */
+    async start() {
+        if (!this.initted)
+            await this.init();
+        this.syncEngine.start();
     }
-    disable() {
-        this.syncEngine.disable();
+    /** Stops periodic background synchronization. */
+    async stop() {
+        this.syncEngine.stop();
     }
+    /** Waits until the sync engine reports a live connection. */
     async waitForLive() {
         return this.syncEngine.waitForLive();
     }
+    /** Triggers a single sync cycle immediately. */
     async triggerSync() {
         return this.syncEngine.triggerSync();
     }
-    // Legacy aliases
+    /** Legacy alias for `enable()`. */
     startSyncInterval() {
-        this.enable();
+        this.start();
     }
+    /** Legacy alias for `disable()`. */
     stopSyncInterval() {
-        this.disable();
+        this.stop();
     }
+    /** Responds to schema changes by disposing state and reloading the page. */
     onSchemaChangeDetected() {
         this.storage.dispose();
-        this.disable();
+        this.stop();
         if (typeof window !== "undefined") {
             window.location.reload();
         }
     }
+    /** Disposes all background resources and event listeners. */
     dispose() {
-        this.disable();
+        this.stop();
         this.events.dispose();
         this.storage.dispose();
     }

package/cjs/DbSync.js.map

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

package/cjs/adapters/RestAdapter.d.ts

@@ -1,13 +1,30 @@
 import type { BackendAdapter, SyncPullResult } from "./types.js";
+/**
+ * Configuration for the built-in REST adapter.
+ */
 export interface RestAdapterConfig {
+    /** The base URL of the remote API. */
     url: string;
 }
+/**
+ * A REST-backed implementation of the backend adapter contract.
+ */
 export declare class RestAdapter implements BackendAdapter {
     private config;
+    /**
+     * Stores the adapter configuration, including the API base URL.
+     *
+     * @param config The REST adapter configuration.
+     */
     constructor(config: RestAdapterConfig);
+    /** Checks whether the server session cookie is currently authenticated. */
     checkAuth(): Promise<boolean>;
+    /** Logs the user in using an email/code pair. */
     login(email: string, code: string): Promise<boolean>;
+    /** Logs the current user out of the remote session. */
     logout(): Promise<void>;
+    /** Pulls remote records from the REST backend using the provided cursor. */
     pull(cursor: string): Promise<SyncPullResult>;
+    /** Pushes queued local mutations to the REST backend. */
     push(payload: any[]): Promise<void>;
 }

package/cjs/adapters/RestAdapter.js

@@ -1,15 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RestAdapter = void 0;
+/**
+ * A REST-backed implementation of the backend adapter contract.
+ */
 class RestAdapter {
     config;
+    /**
+     * Stores the adapter configuration, including the API base URL.
+     *
+     * @param config The REST adapter configuration.
+     */
     constructor(config) {
         this.config = config;
     }
+    /** Checks whether the server session cookie is currently authenticated. */
     async checkAuth() {
         const res = await fetch(`${this.config.url}/api/session`, { credentials: "include" });
         return res.ok;
     }
+    /** Logs the user in using an email/code pair. */
     async login(email, code) {
         const res = await fetch(`${this.config.url}/api/session/login`, {
             method: "POST",
@@ -21,9 +31,11 @@ class RestAdapter {
             throw new Error("Login failed");
         return true;
     }
+    /** Logs the current user out of the remote session. */
     async logout() {
         await fetch(`${this.config.url}/api/session/logout`, { method: "POST", credentials: "include" });
     }
+    /** Pulls remote records from the REST backend using the provided cursor. */
     async pull(cursor) {
         const res = await fetch(`${this.config.url}/api/posts?after=${cursor}&limit=40`, {
             credentials: "include",
@@ -32,6 +44,7 @@ class RestAdapter {
             throw { status: res.status };
         return await res.json();
     }
+    /** Pushes queued local mutations to the REST backend. */
     async push(payload) {
         const res = await fetch(`${this.config.url}/api/posts/upsert-many`, {
             method: "POST",

package/cjs/adapters/RestAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"RestAdapter.js","sourceRoot":"","sources":["../../src/adapters/RestAdapter.ts"],"names":[],"mappings":";;;AAMA,MAAa,WAAW;IACH;IAApB,YAAoB,MAAyB;QAAzB,WAAM,GAAN,MAAM,CAAmB;IAAG,CAAC;IAE1C,KAAK,CAAC,SAAS;QACrB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,cAAc,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAA;QACrF,OAAO,GAAG,CAAC,EAAE,CAAA;IACd,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,KAAa,EAAE,IAAY;QAC7C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,oBAAoB,EAAE;YAC/D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,WAAW,EAAE,SAAS;YACtB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;SACrC,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAA;QAC5C,OAAO,IAAI,CAAA;IACZ,CAAC;IAEM,KAAK,CAAC,MAAM;QAClB,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,qBAAqB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAA;IACjG,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,MAAc;QAC/B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,oBAAoB,MAAM,WAAW,EAAE;YAChF,WAAW,EAAE,SAAS;SACtB,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAA;QACzC,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;IACxB,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,OAAc;QAC/B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,wBAAwB,EAAE;YACnE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,WAAW,EAAE,SAAS;YACtB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC7B,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAA;IAC1C,CAAC;CACD;AAxCD,kCAwCC"}
+{"version":3,"file":"RestAdapter.js","sourceRoot":"","sources":["../../src/adapters/RestAdapter.ts"],"names":[],"mappings":";;;AAUA;;GAEG;AACH,MAAa,WAAW;IAMH;IALpB;;;;OAIG;IACH,YAAoB,MAAyB;QAAzB,WAAM,GAAN,MAAM,CAAmB;IAAG,CAAC;IAEjD,2EAA2E;IACpE,KAAK,CAAC,SAAS;QACrB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,cAAc,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAA;QACrF,OAAO,GAAG,CAAC,EAAE,CAAA;IACd,CAAC;IAED,iDAAiD;IAC1C,KAAK,CAAC,KAAK,CAAC,KAAa,EAAE,IAAY;QAC7C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,oBAAoB,EAAE;YAC/D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,WAAW,EAAE,SAAS;YACtB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;SACrC,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAA;QAC5C,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,uDAAuD;IAChD,KAAK,CAAC,MAAM;QAClB,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,qBAAqB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAA;IACjG,CAAC;IAED,4EAA4E;IACrE,KAAK,CAAC,IAAI,CAAC,MAAc;QAC/B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,oBAAoB,MAAM,WAAW,EAAE;YAChF,WAAW,EAAE,SAAS;SACtB,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAA;QACzC,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;IACxB,CAAC;IAED,yDAAyD;IAClD,KAAK,CAAC,IAAI,CAAC,OAAc;QAC/B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,wBAAwB,EAAE;YACnE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,WAAW,EAAE,SAAS;YACtB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC7B,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAA;IAC1C,CAAC;CACD;AAlDD,kCAkDC"}

package/cjs/adapters/types.d.ts

@@ -1,11 +1,24 @@
+/**
+ * The standard response shape returned by a backend pull request.
+ */
 export interface SyncPullResult {
+    /** The records fetched from the remote backend. */
     items: any[];
+    /** Whether more results remain to be fetched for the current cursor. */
     hasMore: boolean;
 }
+/**
+ * The contract implemented by all sync backends.
+ */
 export interface BackendAdapter {
+    /** Checks whether the current session is authenticated. */
     checkAuth(): Promise<boolean>;
+    /** Logs the current user in against the backend. */
     login(email: string, code: string): Promise<boolean>;
+    /** Logs the current user out of the backend. */
     logout(): Promise<void>;
+    /** Pulls remote changes since the provided cursor. */
     pull(cursor: string): Promise<SyncPullResult>;
+    /** Pushes queued local mutations to the backend. */
     push(payload: any[]): Promise<void>;
 }

package/cjs/internal/AuthManager.d.ts

@@ -1,13 +1,28 @@
 import type { BackendAdapter } from "../adapters/types.js";
 import type { StorageManager } from "./StorageManager.js";
+/**
+ * Coordinates authentication state and logout/reset behavior for `DbSync`.
+ */
 export declare class AuthManager {
     private adapter;
     private storage;
-    private disableSync;
+    private stopSync;
+    /** Tracks whether the current backend session is authenticated. */
     isAuth: boolean;
-    constructor(adapter: BackendAdapter, storage: StorageManager, disableSync: () => void);
+    /**
+     * Creates a new auth manager for the provided backend adapter and storage layer.
+     *
+     * @param adapter The backend adapter used for auth requests.
+     * @param storage The storage manager used for reset operations.
+     * @param stopSync The callback used to stop background sync.
+     */
+    constructor(adapter: BackendAdapter, storage: StorageManager, stopSync: () => Promise<void> | void);
+    /** Checks authentication against the backend adapter and stores the result. */
     checkAuth(): Promise<boolean>;
+    /** Logs in through the backend adapter and updates auth state. */
     login(email: string, code: string): Promise<void>;
+    /** Logs out, stops sync, and clears auth state. */
     logout(): Promise<void>;
+    /** Logs out and clears all local IndexedDB stores and auth markers. */
     reset(): Promise<void>;
 }

package/cjs/internal/AuthManager.js

@@ -1,28 +1,43 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AuthManager = void 0;
+/**
+ * Coordinates authentication state and logout/reset behavior for `DbSync`.
+ */
 class AuthManager {
     adapter;
     storage;
-    disableSync;
+    stopSync;
+    /** Tracks whether the current backend session is authenticated. */
     isAuth = false;
-    constructor(adapter, storage, disableSync) {
+    /**
+     * Creates a new auth manager for the provided backend adapter and storage layer.
+     *
+     * @param adapter The backend adapter used for auth requests.
+     * @param storage The storage manager used for reset operations.
+     * @param stopSync The callback used to stop background sync.
+     */
+    constructor(adapter, storage, stopSync) {
         this.adapter = adapter;
         this.storage = storage;
-        this.disableSync = disableSync;
+        this.stopSync = stopSync;
     }
+    /** Checks authentication against the backend adapter and stores the result. */
     async checkAuth() {
         this.isAuth = await this.adapter.checkAuth();
         return this.isAuth;
     }
+    /** Logs in through the backend adapter and updates auth state. */
     async login(email, code) {
         this.isAuth = await this.adapter.login(email, code);
     }
+    /** Logs out, stops sync, and clears auth state. */
     async logout() {
-        this.disableSync();
+        await this.stopSync();
         this.isAuth = false;
         await this.adapter.logout();
     }
+    /** Logs out and clears all local IndexedDB stores and auth markers. */
     async reset() {
         await this.logout();
         await this.storage.clearAllStores();

package/cjs/internal/AuthManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"AuthManager.js","sourceRoot":"","sources":["../../src/internal/AuthManager.ts"],"names":[],"mappings":";;;AAGA,MAAa,WAAW;IAId;IACA;IACA;IALF,MAAM,GAAG,KAAK,CAAA;IAErB,YACS,OAAuB,EACvB,OAAuB,EACvB,WAAuB;QAFvB,YAAO,GAAP,OAAO,CAAgB;QACvB,YAAO,GAAP,OAAO,CAAgB;QACvB,gBAAW,GAAX,WAAW,CAAY;IAC7B,CAAC;IAEG,KAAK,CAAC,SAAS;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAA;QAC5C,OAAO,IAAI,CAAC,MAAM,CAAA;IACnB,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,KAAa,EAAE,IAAY;QAC7C,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IACpD,CAAC;IAEM,KAAK,CAAC,MAAM;QAClB,IAAI,CAAC,WAAW,EAAE,CAAA;QAClB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;QACnB,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAA;IAC5B,CAAC;IAEM,KAAK,CAAC,KAAK;QACjB,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;QACnB,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAA;QACnC,YAAY,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAA;QAC/C,YAAY,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAA;IACjD,CAAC;CACD;AA9BD,kCA8BC"}
+{"version":3,"file":"AuthManager.js","sourceRoot":"","sources":["../../src/internal/AuthManager.ts"],"names":[],"mappings":";;;AAGA;;GAEG;AACH,MAAa,WAAW;IAYd;IACA;IACA;IAbT,mEAAmE;IAC5D,MAAM,GAAG,KAAK,CAAA;IAErB;;;;;;OAMG;IACH,YACS,OAAuB,EACvB,OAAuB,EACvB,QAAoC;QAFpC,YAAO,GAAP,OAAO,CAAgB;QACvB,YAAO,GAAP,OAAO,CAAgB;QACvB,aAAQ,GAAR,QAAQ,CAA4B;IAC1C,CAAC;IAEJ,+EAA+E;IACxE,KAAK,CAAC,SAAS;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAA;QAC5C,OAAO,IAAI,CAAC,MAAM,CAAA;IACnB,CAAC;IAED,kEAAkE;IAC3D,KAAK,CAAC,KAAK,CAAC,KAAa,EAAE,IAAY;QAC7C,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IACpD,CAAC;IAED,mDAAmD;IAC5C,KAAK,CAAC,MAAM;QAClB,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAA;QACrB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;QACnB,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAA;IAC5B,CAAC;IAED,uEAAuE;IAChE,KAAK,CAAC,KAAK;QACjB,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;QACnB,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAA;QACnC,YAAY,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAA;QAC/C,YAAY,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAA;IACjD,CAAC;CACD;AA1CD,kCA0CC"}

package/cjs/internal/EventBus.d.ts

@@ -1,16 +1,28 @@
 export type SyncState = "idle" | "syncing" | "offline" | "error";
+/**
+ * Broadcasts store updates and sync state changes to local subscribers.
+ */
 export declare class EventBus {
+    /** Subscribers that listen for store updates. */
     private subscribers;
+    /** Subscribers that listen for sync state transitions. */
     private stateListeners;
+    /** Broadcast channel used to mirror updates across tabs. */
     private bc;
+    /** Initializes the broadcast listener for cross-tab update propagation. */
     constructor();
+    /** Adds a store-update subscriber and returns a handle for removing it. */
     subscribe(callback: (stores: string[]) => void): {
         close: () => boolean;
     };
+    /** Notifies all store subscribers and mirrors the update to other tabs. */
     notifySubscribers(stores: string[]): void;
+    /** Adds a sync-state subscriber and returns a handle for removing it. */
     onSyncStateChange(callback: (state: SyncState) => void): {
         close: () => boolean;
     };
+    /** Broadcasts a sync-state transition to all subscribers. */
     setState(state: SyncState): void;
+    /** Tears down the broadcast channel and stops cross-tab propagation. */
     dispose(): void;
 }

package/cjs/internal/EventBus.js

@@ -1,10 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EventBus = void 0;
+/**
+ * Broadcasts store updates and sync state changes to local subscribers.
+ */
 class EventBus {
+    /** Subscribers that listen for store updates. */
     subscribers = new Set();
+    /** Subscribers that listen for sync state transitions. */
     stateListeners = new Set();
+    /** Broadcast channel used to mirror updates across tabs. */
     bc = typeof BroadcastChannel !== "undefined" ? new BroadcastChannel("dbsync_events") : null;
+    /** Initializes the broadcast listener for cross-tab update propagation. */
     constructor() {
         if (this.bc) {
             this.bc.onmessage = (e) => {
@@ -14,22 +21,27 @@ class EventBus {
             };
         }
     }
+    /** Adds a store-update subscriber and returns a handle for removing it. */
     subscribe(callback) {
         this.subscribers.add(callback);
         return { close: () => this.subscribers.delete(callback) };
     }
+    /** Notifies all store subscribers and mirrors the update to other tabs. */
     notifySubscribers(stores) {
         this.subscribers.forEach((cb) => cb(stores));
         if (this.bc)
             this.bc.postMessage({ type: "DATA_UPDATED", stores });
     }
+    /** Adds a sync-state subscriber and returns a handle for removing it. */
     onSyncStateChange(callback) {
         this.stateListeners.add(callback);
         return { close: () => this.stateListeners.delete(callback) };
     }
+    /** Broadcasts a sync-state transition to all subscribers. */
     setState(state) {
         this.stateListeners.forEach((cb) => cb(state));
     }
+    /** Tears down the broadcast channel and stops cross-tab propagation. */
     dispose() {
         if (this.bc) {
             this.bc.close();

package/cjs/internal/EventBus.js.map

@@ -1 +1 @@
-{"version":3,"file":"EventBus.js","sourceRoot":"","sources":["../../src/internal/EventBus.ts"],"names":[],"mappings":";;;AAEA,MAAa,QAAQ;IACZ,WAAW,GAAG,IAAI,GAAG,EAA8B,CAAA;IACnD,cAAc,GAAG,IAAI,GAAG,EAA8B,CAAA;IACtD,EAAE,GACT,OAAO,gBAAgB,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAEvF;QACC,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,IAAI,CAAC,EAAE,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,EAAE;gBACzB,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;oBACpC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;gBACtC,CAAC;YACF,CAAC,CAAA;QACF,CAAC;IACF,CAAC;IAEM,SAAS,CAAC,QAAoC;QACpD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC9B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAA;IAC1D,CAAC;IAEM,iBAAiB,CAAC,MAAgB;QACxC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;QAC5C,IAAI,IAAI,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAAA;IACnE,CAAC;IAEM,iBAAiB,CAAC,QAAoC;QAC5D,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACjC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAA;IAC7D,CAAC;IAEM,QAAQ,CAAC,KAAgB;QAC/B,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IAC/C,CAAC;IAEM,OAAO;QACb,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAA;YACf,IAAI,CAAC,EAAE,GAAG,IAAI,CAAA;QACf,CAAC;IACF,CAAC;CACD;AAzCD,4BAyCC"}
+{"version":3,"file":"EventBus.js","sourceRoot":"","sources":["../../src/internal/EventBus.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AACH,MAAa,QAAQ;IACpB,iDAAiD;IACzC,WAAW,GAAG,IAAI,GAAG,EAA8B,CAAA;IAC3D,0DAA0D;IAClD,cAAc,GAAG,IAAI,GAAG,EAA8B,CAAA;IAC9D,4DAA4D;IACpD,EAAE,GACT,OAAO,gBAAgB,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAEvF,2EAA2E;IAC3E;QACC,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,IAAI,CAAC,EAAE,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,EAAE;gBACzB,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;oBACpC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;gBACtC,CAAC;YACF,CAAC,CAAA;QACF,CAAC;IACF,CAAC;IAED,2EAA2E;IACpE,SAAS,CAAC,QAAoC;QACpD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC9B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAA;IAC1D,CAAC;IAED,2EAA2E;IACpE,iBAAiB,CAAC,MAAgB;QACxC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;QAC5C,IAAI,IAAI,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAAA;IACnE,CAAC;IAED,yEAAyE;IAClE,iBAAiB,CAAC,QAAoC;QAC5D,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACjC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAA;IAC7D,CAAC;IAED,6DAA6D;IACtD,QAAQ,CAAC,KAAgB;QAC/B,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IAC/C,CAAC;IAED,wEAAwE;IACjE,OAAO;QACb,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAA;YACf,IAAI,CAAC,EAAE,GAAG,IAAI,CAAA;QACf,CAAC;IACF,CAAC;CACD;AAlDD,4BAkDC"}