@dabble/patches 0.7.6 → 0.7.8

package/dist/{BaseDoc-DkP3tUhT.d.ts → BaseDoc-_Rsau70J.d.ts}

@@ -8,7 +8,7 @@ import { Change, PatchesSnapshot, SyncingState, ChangeMutator } from './types.js
  * for handling concurrent edits.
  *
  * The `change()` method (inherited from BaseDoc) captures ops and emits them
- * via `onChange` - it does NOT apply locally. The OTStrategy handles packaging
+ * via `onChange` - it does NOT apply locally. The OTAlgorithm handles packaging
  * ops into Changes, persisting them, and calling `applyChanges()` to update state.
  *
  * ## State Model
@@ -90,7 +90,7 @@ interface PatchesDocOptions {
  * Interface for a document synchronized using JSON patches.
  *
  * This is the app-facing interface. The doc captures user changes as JSON Patch
- * ops and emits them via onChange. The strategy handles packaging ops into Changes,
+ * ops and emits them via onChange. The algorithm handles packaging ops into Changes,
  * persisting them, and updating the doc's state.
  *
  * This interface is implemented by both OTDoc (Operational Transformation)
@@ -112,7 +112,7 @@ interface PatchesDoc<T extends object = object> {
     /**
      * Subscribe to be notified when the user makes local changes.
      * Emits the JSON Patch ops captured from the change() call.
-     * The strategy handles packaging these into Changes.
+     * The algorithm handles packaging these into Changes.
      */
     readonly onChange: Signal<(ops: JSONPatchOp[]) => void>;
     /** Subscribe to be notified whenever state changes from any source. */
@@ -123,7 +123,7 @@ interface PatchesDoc<T extends object = object> {
     subscribe(onUpdate: (newValue: T) => void): Unsubscriber;
     /**
      * Captures an update to the document, emitting JSON Patch ops via onChange.
-     * Does NOT apply locally - the strategy handles state updates.
+     * Does NOT apply locally - the algorithm handles state updates.
      * @param mutator Function that uses JSONPatch methods with type-safe paths.
      */
     change(mutator: ChangeMutator<T>): void;
@@ -134,11 +134,11 @@ interface PatchesDoc<T extends object = object> {
  * Contains shared state and methods used by both OTDoc and LWWDoc.
  *
  * The `change()` method captures ops and emits them via `onChange` - it does NOT
- * apply locally. The strategy handles packaging ops, persisting them, and updating
+ * apply locally. The algorithm handles packaging ops, persisting them, and updating
  * the doc's state via `applyChanges()`.
  *
  * Internal methods (updateSyncing, applyChanges, import) are on this class but not
- * on the PatchesDoc interface, as they're only used by Strategy and PatchesSync.
+ * on the PatchesDoc interface, as they're only used by Algorithm and PatchesSync.
  */
 declare abstract class BaseDoc<T extends object = object> implements PatchesDoc<T> {
     protected _id: string;
@@ -147,7 +147,7 @@ declare abstract class BaseDoc<T extends object = object> implements PatchesDoc<
     /**
      * Subscribe to be notified when the user makes local changes.
      * Emits the JSON Patch ops captured from the change() call.
-     * The strategy handles packaging these into Changes.
+     * The algorithm handles packaging these into Changes.
      */
     readonly onChange: Signal<(ops: JSONPatchOp[]) => void>;
     /** Subscribe to be notified whenever state changes from any source. */
@@ -174,7 +174,7 @@ declare abstract class BaseDoc<T extends object = object> implements PatchesDoc<
     subscribe(onUpdate: (newValue: T) => void): Unsubscriber;
     /**
      * Captures an update to the document, emitting JSON Patch ops via onChange.
-     * Does NOT apply locally - the strategy handles state updates via applyChanges.
+     * Does NOT apply locally - the algorithm handles state updates via applyChanges.
      * @param mutator Function that uses JSONPatch methods with type-safe paths.
      */
     change(mutator: ChangeMutator<T>): void;
@@ -186,7 +186,7 @@ declare abstract class BaseDoc<T extends object = object> implements PatchesDoc<
     updateSyncing(newSyncing: SyncingState): void;
     /**
      * Applies changes to the document state.
-     * Called by Strategy for local changes and broadcasts - not part of PatchesDoc interface.
+     * Called by Algorithm for local changes and broadcasts - not part of PatchesDoc interface.
      *
      * For OT: Distinguishes committed (committedAt > 0) vs pending (committedAt === 0) changes.
      * For LWW: Applies all ops from changes and updates metadata.

package/dist/algorithms/lww/consolidateOps.d.ts

@@ -33,7 +33,7 @@ declare function consolidateOps(existingOps: JSONPatchOp[], newOps: JSONPatchOp[
     opsToReturn: JSONPatchOp[];
 };
 /**
- * Any delta ops that aren't combined in consolidateOps need to be converted to replace ops.
+ * Any delta ops that aren't combined in consolidateOps need to be converted to replace/remove ops.
  */
 declare function convertDeltaOps(ops: JSONPatchOp[]): JSONPatchOp[];
 

package/dist/algorithms/lww/consolidateOps.js

@@ -1,5 +1,6 @@
 import "../../chunk-IZ2YBCUP.js";
 import { applyBitmask, combineBitmasks } from "../../json-patch/ops/bitmask.js";
+import { isEmptyContainer } from "../../json-patch/utils/softWrites.js";
 const combinableOps = {
   "@inc": {
     apply: (a, b) => a + b,
@@ -33,6 +34,9 @@ function consolidateFieldOp(existing, incoming) {
     }
     return { ...incoming, op, value };
   }
+  if (isSoftOp(incoming)) {
+    return null;
+  }
   if (isExistingNewer(existing.ts, incoming.ts)) {
     return null;
   }
@@ -58,6 +62,19 @@ function consolidateOps(existingOps, newOps) {
         opsToSave.push(consolidated);
       }
     } else {
+      if (isSoftOp(newOp)) {
+        let dataExists = false;
+        for (const existingPath of existingByPath.keys()) {
+          if (existingPath.startsWith(newOp.path + "/")) {
+            dataExists = true;
+            break;
+          }
+        }
+        if (!dataExists) {
+          dataExists = pathExistsInParentOp(newOp.path, existingByPath);
+        }
+        if (dataExists) continue;
+      }
       for (const existingPath of existingByPath.keys()) {
         if (existingPath.startsWith(newOp.path + "/")) {
           pathsToDelete.add(existingPath);
@@ -70,6 +87,7 @@ function consolidateOps(existingOps, newOps) {
 }
 function convertDeltaOps(ops) {
   return ops.map((op) => {
+    if (op.op === "remove") return op;
     const combiner = combinableOps[op.op];
     const value = typeof op.value === "string" ? "" : 0;
     if (combiner) return { ...op, op: "replace", value: combiner.apply(value, op.value) };
@@ -92,6 +110,30 @@ function parentFixes(path, existing) {
   }
   return pathsToDelete;
 }
+function pathExistsInParentOp(path, existingByPath) {
+  let parent = path;
+  while (parent.lastIndexOf("/") > 0) {
+    parent = parent.substring(0, parent.lastIndexOf("/"));
+    const parentOp = existingByPath.get(parent);
+    if (parentOp && isObject(parentOp.value)) {
+      const remainingKeys = path.substring(parent.length + 1).split("/");
+      let current = parentOp.value;
+      let found = true;
+      for (const key of remainingKeys) {
+        if (!isObject(current) || !(key in current)) {
+          found = false;
+          break;
+        }
+        current = current[key];
+      }
+      if (found) return true;
+    }
+  }
+  return false;
+}
+function isSoftOp(op) {
+  return op.soft === true || op.op === "add" && isEmptyContainer(op.value);
+}
 function isObject(value) {
   return value !== null && typeof value === "object";
 }

package/dist/client/BaseDoc.d.ts

@@ -1,6 +1,6 @@
 import '../event-signal.js';
 import '../json-patch/types.js';
 import '../types.js';
-export { B as BaseDoc } from '../BaseDoc-DkP3tUhT.js';
+export { B as BaseDoc } from '../BaseDoc-_Rsau70J.js';
 import '../json-patch/JSONPatch.js';
 import '@dabble/delta';

package/dist/client/BaseDoc.js

@@ -8,7 +8,7 @@ class BaseDoc {
   /**
    * Subscribe to be notified when the user makes local changes.
    * Emits the JSON Patch ops captured from the change() call.
-   * The strategy handles packaging these into Changes.
+   * The algorithm handles packaging these into Changes.
    */
   onChange = signal();
   /** Subscribe to be notified whenever state changes from any source. */
@@ -44,7 +44,7 @@ class BaseDoc {
   }
   /**
    * Captures an update to the document, emitting JSON Patch ops via onChange.
-   * Does NOT apply locally - the strategy handles state updates via applyChanges.
+   * Does NOT apply locally - the algorithm handles state updates via applyChanges.
    * @param mutator Function that uses JSONPatch methods with type-safe paths.
    */
   change(mutator) {

package/dist/client/ClientAlgorithm.d.ts

@@ -1,6 +1,6 @@
 import { JSONPatchOp } from '../json-patch/types.js';
 import { PatchesSnapshot, Change } from '../types.js';
-import { a as PatchesDoc } from '../BaseDoc-DkP3tUhT.js';
+import { a as PatchesDoc } from '../BaseDoc-_Rsau70J.js';
 import { PatchesStore, TrackedDoc } from './PatchesStore.js';
 import '../json-patch/JSONPatch.js';
 import '@dabble/delta';

package/dist/client/IndexedDBStore.d.ts

@@ -7,10 +7,10 @@ import '@dabble/delta';
 import '../json-patch/types.js';
 
 /**
- * IndexedDB store providing common database operations for all sync strategies.
+ * IndexedDB store providing common database operations for all sync algorithms.
  *
  * Can be used as a standalone store or as a shared database connection
- * for multiple strategy-specific stores (OT, LWW).
+ * for multiple algorithm-specific stores (OT, LWW).
  *
  * Provides:
  * - Database lifecycle management (open, close, delete)
@@ -18,7 +18,7 @@ import '../json-patch/types.js';
  * - Document tracking (listDocs, trackDocs, untrackDocs)
  * - Basic document operations (deleteDoc, confirmDeleteDoc)
  * - Revision tracking
- * - Extensibility via onUpgrade signal for strategy-specific stores
+ * - Extensibility via onUpgrade signal for algorithm-specific stores
  */
 declare class IndexedDBStore implements PatchesStore {
     private static readonly DB_VERSION;
@@ -26,13 +26,13 @@ declare class IndexedDBStore implements PatchesStore {
     protected dbName?: string;
     protected dbPromise: Deferred<IDBDatabase>;
     /**
-     * Signal emitted during database upgrade, allowing strategy-specific stores
+     * Signal emitted during database upgrade, allowing algorithm-specific stores
      * to create their object stores.
      */
     readonly onUpgrade: Signal<(db: IDBDatabase, oldVersion: number, transaction: IDBTransaction) => void>;
     constructor(dbName?: string);
     /**
-     * Creates shared object stores used by all sync strategies.
+     * Creates shared object stores used by all sync algorithms.
      */
     protected createSharedStores(db: IDBDatabase, _oldVersion: number, _transaction: IDBTransaction): void;
     protected initDB(): Promise<void>;
@@ -52,19 +52,19 @@ declare class IndexedDBStore implements PatchesStore {
     transaction(storeNames: string[], mode: IDBTransactionMode): Promise<[IDBTransactionWrapper, ...IDBStoreWrapper[]]>;
     /**
      * Retrieves the current document snapshot from storage.
-     * Implementation varies by sync strategy (OT vs LWW).
-     * This base implementation throws an error - override in strategy-specific stores.
+     * Implementation varies by sync algorithm (OT vs LWW).
+     * This base implementation throws an error - override in algorithm-specific stores.
      */
     getDoc(_docId: string): Promise<PatchesSnapshot | undefined>;
     /**
      * Saves the current document state to persistent storage.
-     * Implementation varies by sync strategy.
-     * This base implementation throws an error - override in strategy-specific stores.
+     * Implementation varies by sync algorithm.
+     * This base implementation throws an error - override in algorithm-specific stores.
      */
     saveDoc(_docId: string, _docState: PatchesState): Promise<void>;
     /**
      * Completely remove all data for this docId and mark it as deleted (tombstone).
-     * This base implementation throws an error - override in strategy-specific stores.
+     * This base implementation throws an error - override in algorithm-specific stores.
      */
     deleteDoc(_docId: string): Promise<void>;
     /**
@@ -88,7 +88,7 @@ declare class IndexedDBStore implements PatchesStore {
     /**
      * Untrack a document.
      * @param docIds - The IDs of the documents to untrack.
-     * This base implementation throws an error - override in strategy-specific stores.
+     * This base implementation throws an error - override in algorithm-specific stores.
      */
     untrackDocs(_docIds: string[]): Promise<void>;
     /**

package/dist/client/IndexedDBStore.js

@@ -7,7 +7,7 @@ class IndexedDBStore {
   dbName;
   dbPromise;
   /**
-   * Signal emitted during database upgrade, allowing strategy-specific stores
+   * Signal emitted during database upgrade, allowing algorithm-specific stores
    * to create their object stores.
    */
   onUpgrade = signal();
@@ -22,7 +22,7 @@ class IndexedDBStore {
     }
   }
   /**
-   * Creates shared object stores used by all sync strategies.
+   * Creates shared object stores used by all sync algorithms.
    */
   createSharedStores(db, _oldVersion, _transaction) {
     if (!db.objectStoreNames.contains("docs")) {
@@ -94,30 +94,30 @@ class IndexedDBStore {
     const stores = storeNames.map((name) => tx.getStore(name));
     return [tx, ...stores];
   }
-  // ─── Strategy-Specific Methods ───────────────────────────────────────────
-  // These are implemented by strategy-specific stores (OT, LWW)
+  // ─── Algorithm-Specific Methods ──────────────────────────────────────────
+  // These are implemented by algorithm-specific stores (OT, LWW)
   /**
    * Retrieves the current document snapshot from storage.
-   * Implementation varies by sync strategy (OT vs LWW).
-   * This base implementation throws an error - override in strategy-specific stores.
+   * Implementation varies by sync algorithm (OT vs LWW).
+   * This base implementation throws an error - override in algorithm-specific stores.
    */
   async getDoc(_docId) {
-    throw new Error("getDoc must be implemented by strategy-specific store");
+    throw new Error("getDoc must be implemented by algorithm-specific store");
   }
   /**
    * Saves the current document state to persistent storage.
-   * Implementation varies by sync strategy.
-   * This base implementation throws an error - override in strategy-specific stores.
+   * Implementation varies by sync algorithm.
+   * This base implementation throws an error - override in algorithm-specific stores.
    */
   async saveDoc(_docId, _docState) {
-    throw new Error("saveDoc must be implemented by strategy-specific store");
+    throw new Error("saveDoc must be implemented by algorithm-specific store");
   }
   /**
    * Completely remove all data for this docId and mark it as deleted (tombstone).
-   * This base implementation throws an error - override in strategy-specific stores.
+   * This base implementation throws an error - override in algorithm-specific stores.
    */
   async deleteDoc(_docId) {
-    throw new Error("deleteDoc must be implemented by strategy-specific store");
+    throw new Error("deleteDoc must be implemented by algorithm-specific store");
   }
   /**
    * Confirm the deletion of a document.
@@ -180,10 +180,10 @@ class IndexedDBStore {
   /**
    * Untrack a document.
    * @param docIds - The IDs of the documents to untrack.
-   * This base implementation throws an error - override in strategy-specific stores.
+   * This base implementation throws an error - override in algorithm-specific stores.
    */
   async untrackDocs(_docIds) {
-    throw new Error("untrackDocs must be implemented by strategy-specific store");
+    throw new Error("untrackDocs must be implemented by algorithm-specific store");
   }
   /**
    * Returns the last committed revision for a document.

package/dist/client/LWWAlgorithm.d.ts

@@ -2,7 +2,7 @@ import { JSONPatchOp } from '../json-patch/types.js';
 import { PatchesSnapshot, Change } from '../types.js';
 import { ClientAlgorithm } from './ClientAlgorithm.js';
 import { LWWClientStore } from './LWWClientStore.js';
-import { a as PatchesDoc } from '../BaseDoc-DkP3tUhT.js';
+import { a as PatchesDoc } from '../BaseDoc-_Rsau70J.js';
 import { TrackedDoc } from './PatchesStore.js';
 import '../json-patch/JSONPatch.js';
 import '@dabble/delta';

package/dist/client/LWWDoc.d.ts

@@ -1,5 +1,5 @@
 import { PatchesSnapshot, Change } from '../types.js';
-import { B as BaseDoc } from '../BaseDoc-DkP3tUhT.js';
+import { B as BaseDoc } from '../BaseDoc-_Rsau70J.js';
 import '../json-patch/JSONPatch.js';
 import '@dabble/delta';
 import '../json-patch/types.js';
@@ -9,13 +9,13 @@ import '../event-signal.js';
  * LWW (Last-Write-Wins) document implementation.
  *
  * The `change()` method (inherited from BaseDoc) captures ops and emits them
- * via `onChange` - it does NOT apply locally. The LWWStrategy handles:
+ * via `onChange` - it does NOT apply locally. The LWWAlgorithm handles:
  * - Packaging ops with timestamps
  * - Merging with pending fields
  * - Updating the doc's state via `applyChanges()`
  *
  * Unlike OTDoc, LWWDoc doesn't need to track committed vs pending state
- * separately - the strategy handles all conflict resolution by timestamp.
+ * separately - the algorithm handles all conflict resolution by timestamp.
  *
  * ## Wire Efficiency
  * For Worker-Tab communication, `applyChanges()` sends only changes over the wire,

package/dist/client/LWWIndexedDBStore.d.ts

@@ -9,7 +9,7 @@ import '../event-signal.js';
 import '../utils/deferred.js';
 
 /**
- * IndexedDB store implementation for Last-Writer-Wins (LWW) sync strategy.
+ * IndexedDB store implementation for Last-Writer-Wins (LWW) sync algorithm.
  *
  * Creates stores:
  * - docs<{ docId: string; committedRev: number; deleted?: boolean }> (primary key: docId) [shared with OT]

package/dist/client/OTAlgorithm.d.ts

@@ -2,7 +2,7 @@ import { JSONPatchOp } from '../json-patch/types.js';
 import { PatchesSnapshot, Change } from '../types.js';
 import { ClientAlgorithm } from './ClientAlgorithm.js';
 import { OTClientStore } from './OTClientStore.js';
-import { P as PatchesDocOptions, a as PatchesDoc } from '../BaseDoc-DkP3tUhT.js';
+import { P as PatchesDocOptions, a as PatchesDoc } from '../BaseDoc-_Rsau70J.js';
 import { TrackedDoc } from './PatchesStore.js';
 import '../json-patch/JSONPatch.js';
 import '@dabble/delta';

package/dist/client/OTDoc.d.ts

@@ -1,5 +1,5 @@
 import '../types.js';
-export { O as OTDoc } from '../BaseDoc-DkP3tUhT.js';
+export { O as OTDoc } from '../BaseDoc-_Rsau70J.js';
 import '../json-patch/JSONPatch.js';
 import '@dabble/delta';
 import '../json-patch/types.js';

package/dist/client/OTIndexedDBStore.d.ts

@@ -9,7 +9,7 @@ import '../event-signal.js';
 import '../utils/deferred.js';
 
 /**
- * IndexedDB store implementation for Operational Transformation (OT) sync strategy.
+ * IndexedDB store implementation for Operational Transformation (OT) sync algorithm.
  *
  * Creates stores:
  * - snapshots<{ docId: string; rev: number; state: any }> (primary key: docId) [shared]

package/dist/client/Patches.d.ts

@@ -2,11 +2,20 @@ import { Unsubscriber, Signal } from '../event-signal.js';
 import { JSONPatchOp } from '../json-patch/types.js';
 import { Change } from '../types.js';
 import { ClientAlgorithm } from './ClientAlgorithm.js';
-import { P as PatchesDocOptions, a as PatchesDoc } from '../BaseDoc-DkP3tUhT.js';
+import { P as PatchesDocOptions, a as PatchesDoc } from '../BaseDoc-_Rsau70J.js';
 import { AlgorithmName } from './PatchesStore.js';
 import '../json-patch/JSONPatch.js';
 import '@dabble/delta';
 
+/**
+ * Options for opening a document, passed through to `patches.openDoc()`.
+ */
+interface OpenDocOptions {
+    /** Optional metadata to attach to the document. */
+    metadata?: Record<string, any>;
+    /** Override the algorithm for this document (defaults to the Patches instance default). */
+    algorithm?: AlgorithmName;
+}
 /**
  * Options for creating a Patches instance.
  * Provides algorithms map and optional default algorithm.
@@ -85,10 +94,7 @@ declare class Patches {
      * @param opts - Optional metadata and algorithm override.
      * @returns The opened PatchesDoc instance.
      */
-    openDoc<T extends object>(docId: string, opts?: {
-        metadata?: Record<string, any>;
-        algorithm?: AlgorithmName;
-    }): Promise<PatchesDoc<T>>;
+    openDoc<T extends object>(docId: string, opts?: OpenDocOptions): Promise<PatchesDoc<T>>;
     /**
      * Closes an open document by ID, removing listeners and optionally untracking it.
      * @param docId - The document ID to close.
@@ -122,4 +128,4 @@ declare class Patches {
     protected _handleDocChange<T extends object>(docId: string, ops: JSONPatchOp[], doc: PatchesDoc<T>, algorithm: ClientAlgorithm, metadata: Record<string, any>): Promise<void>;
 }
 
-export { Patches, type PatchesOptions };
+export { type OpenDocOptions, Patches, type PatchesOptions };

package/dist/client/PatchesDoc.d.ts

@@ -1,6 +1,6 @@
 import '../event-signal.js';
 import '../json-patch/types.js';
 import '../types.js';
-export { O as OTDoc, a as PatchesDoc, O as PatchesDocClass, P as PatchesDocOptions } from '../BaseDoc-DkP3tUhT.js';
+export { O as OTDoc, a as PatchesDoc, O as PatchesDocClass, P as PatchesDocOptions } from '../BaseDoc-_Rsau70J.js';
 import '../json-patch/JSONPatch.js';
 import '@dabble/delta';

package/dist/client/factories.d.ts

@@ -1,6 +1,6 @@
 import { AlgorithmName } from './PatchesStore.js';
 import { Patches } from './Patches.js';
-import { P as PatchesDocOptions } from '../BaseDoc-DkP3tUhT.js';
+import { P as PatchesDocOptions } from '../BaseDoc-_Rsau70J.js';
 import '../types.js';
 import '../json-patch/JSONPatch.js';
 import '@dabble/delta';

package/dist/client/index.d.ts

@@ -1,4 +1,4 @@
-export { B as BaseDoc, O as OTDoc, a as PatchesDoc, O as PatchesDocClass, P as PatchesDocOptions } from '../BaseDoc-DkP3tUhT.js';
+export { B as BaseDoc, O as OTDoc, a as PatchesDoc, O as PatchesDocClass, P as PatchesDocOptions } from '../BaseDoc-_Rsau70J.js';
 export { IndexedDBFactoryOptions, MultiAlgorithmFactoryOptions, MultiAlgorithmIndexedDBFactoryOptions, PatchesFactoryOptions, createLWWIndexedDBPatches, createLWWPatches, createMultiAlgorithmIndexedDBPatches, createMultiAlgorithmPatches, createOTIndexedDBPatches, createOTPatches } from './factories.js';
 export { IDBStoreWrapper, IDBTransactionWrapper, IndexedDBStore } from './IndexedDBStore.js';
 export { OTIndexedDBStore } from './OTIndexedDBStore.js';
@@ -9,7 +9,7 @@ export { LWWDoc } from './LWWDoc.js';
 export { LWWAlgorithm } from './LWWAlgorithm.js';
 export { LWWBatcher } from './LWWBatcher.js';
 export { OTAlgorithm } from './OTAlgorithm.js';
-export { Patches, PatchesOptions } from './Patches.js';
+export { OpenDocOptions, Patches, PatchesOptions } from './Patches.js';
 export { PatchesHistoryClient } from './PatchesHistoryClient.js';
 export { AlgorithmName, PatchesStore, TrackedDoc } from './PatchesStore.js';
 export { OTClientStore } from './OTClientStore.js';

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { Delta } from '@dabble/delta';
-export { B as BaseDoc, O as OTDoc, a as PatchesDoc, O as PatchesDocClass, P as PatchesDocOptions } from './BaseDoc-DkP3tUhT.js';
+export { B as BaseDoc, O as OTDoc, a as PatchesDoc, O as PatchesDocClass, P as PatchesDocOptions } from './BaseDoc-_Rsau70J.js';
 export { IndexedDBFactoryOptions, MultiAlgorithmFactoryOptions, MultiAlgorithmIndexedDBFactoryOptions, PatchesFactoryOptions, createLWWIndexedDBPatches, createLWWPatches, createMultiAlgorithmIndexedDBPatches, createMultiAlgorithmPatches, createOTIndexedDBPatches, createOTPatches } from './client/factories.js';
 export { IDBStoreWrapper, IDBTransactionWrapper, IndexedDBStore } from './client/IndexedDBStore.js';
 export { OTIndexedDBStore } from './client/OTIndexedDBStore.js';
@@ -10,7 +10,7 @@ export { LWWDoc } from './client/LWWDoc.js';
 export { LWWAlgorithm } from './client/LWWAlgorithm.js';
 export { LWWBatcher } from './client/LWWBatcher.js';
 export { OTAlgorithm } from './client/OTAlgorithm.js';
-export { Patches, PatchesOptions } from './client/Patches.js';
+export { OpenDocOptions, Patches, PatchesOptions } from './client/Patches.js';
 export { PatchesHistoryClient } from './client/PatchesHistoryClient.js';
 export { AlgorithmName, PatchesStore, TrackedDoc } from './client/PatchesStore.js';
 export { OTClientStore } from './client/OTClientStore.js';

package/dist/net/PatchesClient.d.ts

@@ -42,7 +42,7 @@ declare class PatchesClient implements PatchesAPI {
      * @param docId - The ID of the document.
      * @returns A promise resolving with the document snapshot.
      */
-    getDoc<T = any>(docId: string, atRev?: number): Promise<PatchesState<T>>;
+    getDoc<T = any>(docId: string): Promise<PatchesState<T>>;
     /**
      * Gets changes that occurred for a document after a specific revision number.
      * @param docId - The ID of the document.

package/dist/net/PatchesClient.js

@@ -49,8 +49,8 @@ class PatchesClient {
    * @param docId - The ID of the document.
    * @returns A promise resolving with the document snapshot.
    */
-  async getDoc(docId, atRev) {
-    return this.rpc.call("getDoc", docId, atRev);
+  async getDoc(docId) {
+    return this.rpc.call("getDoc", docId);
   }
   /**
    * Gets changes that occurred for a document after a specific revision number.

package/dist/net/PatchesSync.d.ts

@@ -13,7 +13,7 @@ import '@dabble/delta';
 import '../json-patch/types.js';
 import './PatchesClient.js';
 import '../utils/deferred.js';
-import '../BaseDoc-DkP3tUhT.js';
+import '../BaseDoc-_Rsau70J.js';
 
 interface PatchesSyncState {
     online: boolean;

package/dist/net/index.d.ts

@@ -18,7 +18,7 @@ import '../algorithms/ot/shared/changeBatching.js';
 import '../client/Patches.js';
 import '../json-patch/types.js';
 import '../client/ClientAlgorithm.js';
-import '../BaseDoc-DkP3tUhT.js';
+import '../BaseDoc-_Rsau70J.js';
 import '../client/PatchesStore.js';
 import '../server/types.js';
 import '../utils/deferred.js';

package/dist/net/protocol/JSONRPCClient.js

@@ -24,6 +24,7 @@ class JSONRPCClient {
    */
   async call(method, ...args) {
     const id = this.nextId++;
+    while (args.length > 0 && args[args.length - 1] === void 0) args.pop();
     const params = args.length > 0 ? args : void 0;
     const message = { jsonrpc: "2.0", id, method, params };
     return new Promise((resolve, reject) => {
@@ -38,6 +39,7 @@ class JSONRPCClient {
    * @param args - The arguments to pass to the remote procedure (sent as array)
    */
   notify(method, ...args) {
+    while (args.length > 0 && args[args.length - 1] === void 0) args.pop();
     const params = args.length > 0 ? args : void 0;
     const message = { jsonrpc: "2.0", method, params };
     this.transport.send(JSON.stringify(message));

package/dist/net/protocol/JSONRPCServer.js

@@ -52,6 +52,10 @@ class JSONRPCServer {
         throw new Error(`Method '${method}' not found on object`);
       }
       this.registerMethod(method, async (...args) => {
+        const docId = args[0];
+        if (typeof docId !== "string" || !docId) {
+          throw new StatusError(400, `INVALID_REQUEST: docId is required (got ${docId === "" ? "empty string" : String(docId)})`);
+        }
         const ctx = getAuthContext();
         await this.assertAccess(access, ctx, method, args);
         return obj[method](...args);
@@ -132,7 +136,9 @@ class JSONRPCServer {
   async assertAccess(access, ctx, method, args) {
     if (!this.auth) return;
     const docId = args?.[0];
-    if (typeof docId !== "string") return;
+    if (typeof docId !== "string" || !docId) {
+      throw new StatusError(400, `INVALID_REQUEST: docId is required (got ${docId === "" ? "empty string" : String(docId)})`);
+    }
     const ok = await this.auth.canAccess(ctx, docId, access, method);
     if (!ok) {
       throw new StatusError(401, `${access.toUpperCase()}_FORBIDDEN:${docId}`);

package/dist/net/protocol/types.d.ts

@@ -119,7 +119,7 @@ interface PatchesAPI {
      */
     unsubscribe(ids: string | string[]): Promise<void>;
     /** Get the latest version of a document and changes since the last version. */
-    getDoc(docId: string, atRev?: number): Promise<PatchesState>;
+    getDoc(docId: string): Promise<PatchesState>;
     /** Get changes that occurred after a specific revision. */
     getChangesSince(docId: string, rev: number): Promise<Change[]>;
     /** Apply a set of changes from the client to a document. Returns the committed changes. */

package/dist/net/websocket/WebSocketServer.d.ts

@@ -42,20 +42,14 @@ declare class WebSocketServer {
     /**
      * Subscribes the client to one or more documents to receive real-time updates.
      * If a document has been deleted (tombstone exists), sends immediate docDeleted notification.
-     * @param params - The subscription parameters
-     * @param params.ids - Document ID or IDs to subscribe to
+     * @param ids - Document ID or IDs to subscribe to
      */
-    subscribe(params: {
-        ids: string | string[];
-    }): Promise<string[]>;
+    subscribe(ids: string | string[]): Promise<string[]>;
     /**
      * Unsubscribes the client from one or more documents.
-     * @param params - The unsubscription parameters
-     * @param params.ids - Document ID or IDs to unsubscribe from
+     * @param ids - Document ID or IDs to unsubscribe from
      */
-    unsubscribe(params: {
-        ids: string | string[];
-    }): Promise<string[]>;
+    unsubscribe(ids: string | string[]): Promise<string[]>;
 }
 
 export { WebSocketServer, type WebSocketServerOptions };