@dabble/patches 0.2.3 → 0.2.5

package/dist/client/PatchesDoc.d.ts

@@ -1,3 +1,4 @@
+import { type Unsubscriber } from '../event-signal.js';
 import type { JSONPatch } from '../json-patch/JSONPatch.js';
 import type { Change, PatchesSnapshot } from '../types.js';
 /**
@@ -29,12 +30,16 @@ export declare class PatchesDoc<T extends object = object> {
     get id(): string | null;
     /** Current local state (committed + sending + pending). */
     get state(): T;
+    /** Alias for state. */
+    get value(): T;
     /** Last committed revision number from the server. */
     get committedRev(): number;
     /** Are there changes currently awaiting server confirmation? */
     get isSending(): boolean;
     /** Are there local changes that haven't been sent yet? */
     get hasPending(): boolean;
+    /** Subscribe to be notified whenever value changes. */
+    subscribe(onUpdate: (newValue: T) => void): Unsubscriber;
     /**
      * Exports the document state for persistence.
      * NOTE: Any changes currently marked as `sending` are included in the

package/dist/client/PatchesDoc.js

@@ -37,6 +37,10 @@ export class PatchesDoc {
     get state() {
         return this._state;
     }
+    /** Alias for state. */
+    get value() {
+        return this._state;
+    }
     /** Last committed revision number from the server. */
     get committedRev() {
         return this._committedRev;
@@ -49,6 +53,12 @@ export class PatchesDoc {
     get hasPending() {
         return this._pendingChanges.length > 0;
     }
+    /** Subscribe to be notified whenever value changes. */
+    subscribe(onUpdate) {
+        const unsub = this.onUpdate(onUpdate);
+        onUpdate(this._state);
+        return unsub;
+    }
     /**
      * Exports the document state for persistence.
      * NOTE: Any changes currently marked as `sending` are included in the

package/dist/persist/IndexedDBStore.d.ts

@@ -14,13 +14,18 @@ import type { PatchesStore, TrackedDoc } from './PatchesStore.js';
  */
 export declare class IndexedDBStore implements PatchesStore {
     private db;
-    private dbName;
+    private dbName?;
     private dbPromise;
     /** Subscribe to be notified after local state changes are saved to the database. */
     readonly onPendingChanges: import("../event-signal.js").Signal<(docId: string, changes: Change[]) => void>;
-    constructor(dbName: string);
+    constructor(dbName?: string);
     private initDB;
     private getDB;
+    /**
+     * Set the name of the database, loads a new database connection.
+     * @param dbName - The new name of the database.
+     */
+    setName(dbName: string): void;
     /**
      * Closes the database connection. After calling this method, the store
      * will no longer be usable. A new instance must be created to reopen

package/dist/persist/IndexedDBStore.js

@@ -1,6 +1,6 @@
 import { signal } from '../event-signal.js';
 import { transformPatch } from '../json-patch/transformPatch.js';
-import { applyChanges } from '../utils.js';
+import { applyChanges, deferred } from '../utils.js';
 const DB_VERSION = 1;
 const SNAPSHOT_INTERVAL = 200;
 /**
@@ -21,36 +21,52 @@ export class IndexedDBStore {
         /** Subscribe to be notified after local state changes are saved to the database. */
         this.onPendingChanges = signal();
         this.dbName = dbName;
-        this.dbPromise = this.initDB();
+        this.dbPromise = deferred();
+        if (this.dbName) {
+            this.initDB();
+        }
     }
     async initDB() {
-        return new Promise((resolve, reject) => {
-            const request = indexedDB.open(this.dbName, DB_VERSION);
-            request.onerror = () => reject(request.error);
-            request.onsuccess = () => {
-                this.db = request.result;
-                resolve(this.db);
-            };
-            request.onupgradeneeded = event => {
-                const db = event.target.result;
-                // Create stores
-                if (!db.objectStoreNames.contains('snapshots')) {
-                    db.createObjectStore('snapshots', { keyPath: 'docId' });
-                }
-                if (!db.objectStoreNames.contains('committedChanges')) {
-                    db.createObjectStore('committedChanges', { keyPath: ['docId', 'rev'] });
-                }
-                if (!db.objectStoreNames.contains('pendingChanges')) {
-                    db.createObjectStore('pendingChanges', { keyPath: ['docId', 'rev'] });
-                }
-                if (!db.objectStoreNames.contains('docs')) {
-                    db.createObjectStore('docs', { keyPath: 'docId' });
-                }
-            };
-        });
+        if (!this.dbName)
+            return;
+        const request = indexedDB.open(this.dbName, DB_VERSION);
+        request.onerror = () => this.dbPromise.reject(request.error);
+        request.onsuccess = () => {
+            this.db = request.result;
+            this.dbPromise.resolve(this.db);
+        };
+        request.onupgradeneeded = event => {
+            const db = event.target.result;
+            // Create stores
+            if (!db.objectStoreNames.contains('snapshots')) {
+                db.createObjectStore('snapshots', { keyPath: 'docId' });
+            }
+            if (!db.objectStoreNames.contains('committedChanges')) {
+                db.createObjectStore('committedChanges', { keyPath: ['docId', 'rev'] });
+            }
+            if (!db.objectStoreNames.contains('pendingChanges')) {
+                db.createObjectStore('pendingChanges', { keyPath: ['docId', 'rev'] });
+            }
+            if (!db.objectStoreNames.contains('docs')) {
+                db.createObjectStore('docs', { keyPath: 'docId' });
+            }
+        };
     }
     getDB() {
-        return this.dbPromise;
+        return this.dbPromise.promise;
+    }
+    /**
+     * Set the name of the database, loads a new database connection.
+     * @param dbName - The new name of the database.
+     */
+    setName(dbName) {
+        this.dbName = dbName;
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+            this.dbPromise = deferred();
+        }
+        this.initDB();
     }
     /**
      * Closes the database connection. After calling this method, the store
@@ -58,14 +74,17 @@ export class IndexedDBStore {
      * the database.
      */
     async close() {
-        await this.dbPromise;
+        await this.dbPromise.promise;
         if (this.db) {
             this.db.close();
             this.db = null;
-            this.dbPromise = Promise.resolve(null);
+            this.dbPromise = deferred();
+            this.dbPromise.resolve(null);
         }
     }
     async deleteDB() {
+        if (!this.dbName)
+            return;
         await this.close();
         await new Promise((resolve, reject) => {
             const request = indexedDB.deleteDatabase(this.dbName);

package/dist/types.d.ts

@@ -160,4 +160,5 @@ export interface Deferred<T = void> {
     promise: Promise<T>;
     resolve: (value: T) => void;
     reject: (reason?: any) => void;
+    status: 'pending' | 'fulfilled' | 'rejected';
 }

package/dist/utils.js

@@ -81,9 +81,23 @@ export function rebaseChanges(serverChanges, localChanges) {
 export function deferred() {
     let resolve;
     let reject;
+    let _status = 'pending';
     const promise = new Promise((_resolve, _reject) => {
-        resolve = _resolve;
-        reject = _reject;
+        resolve = (value) => {
+            _resolve(value);
+            _status = 'fulfilled';
+        };
+        reject = (reason) => {
+            _reject(reason);
+            _status = 'rejected';
+        };
     });
-    return { promise, resolve, reject };
+    return {
+        promise,
+        resolve,
+        reject,
+        get status() {
+            return _status;
+        },
+    };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dabble/patches",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Immutable JSON Patch implementation based on RFC 6902 supporting operational transformation and last-writer-wins",
   "author": "Jacob Wright <jacwright@gmail.com>",
   "bugs": {