@loro-dev/flock 4.4.0 → 4.4.2

package/dist/index.d.mts

@@ -122,8 +122,7 @@ declare class Flock {
   private inner;
   private listeners;
   private nativeUnsubscribe;
-  /** Debounce state for autoDebounceCommit */
-  private debounceState;
+  private readonly eventBatcher;
   constructor(peerId?: string);
   private static fromInner;
   static fromJson(bundle: ExportBundle, peerId: string): Flock;
@@ -159,8 +158,15 @@ declare class Flock {
   merge(other: Flock): void;
   /**
    * Returns the exclusive version vector, which only includes peers that have
-   * at least one entry in the current state. This is consistent with the state
-   * after export and re-import.
+   * at least one entry in the current state.
+   *
+   * Complexity: O(M + V log M + R (log L + log S)).
+   * - M = memtablePeerCount
+   * - V = vvPeerCount
+   * - L = memtableLen
+   * - R = scanned candidate rows in KV_BY_PEER_CLOCK
+   * - S = storage key count in KV_BY_KEY
+   * No full O(memtableSize) pre-scan is performed.
    *
    * Use this version when sending to other peers for incremental sync.
    */
@@ -192,8 +198,7 @@ declare class Flock {
   scan(options?: ScanOptions): ScanRow[];
   private ensureNativeSubscription;
   private handleBatch;
-  private emitBatch;
-  private resetDebounceTimer;
+  private deliverBatch;
   subscribe(listener: (batch: EventBatch) => void): () => void;
   /**
    * Enable auto-debounce mode. Events will be accumulated and emitted after
@@ -250,6 +255,7 @@ declare class Flock {
    * @returns The return value of the callback
    * @throws Error if nested transaction attempted
    * @throws Error if import is called during the transaction (auto-commits first)
+   * @throws Error if called while autoDebounceCommit is active
    *
    * @example
    * ```ts

package/dist/index.d.ts

@@ -122,8 +122,7 @@ declare class Flock {
   private inner;
   private listeners;
   private nativeUnsubscribe;
-  /** Debounce state for autoDebounceCommit */
-  private debounceState;
+  private readonly eventBatcher;
   constructor(peerId?: string);
   private static fromInner;
   static fromJson(bundle: ExportBundle, peerId: string): Flock;
@@ -159,8 +158,15 @@ declare class Flock {
   merge(other: Flock): void;
   /**
    * Returns the exclusive version vector, which only includes peers that have
-   * at least one entry in the current state. This is consistent with the state
-   * after export and re-import.
+   * at least one entry in the current state.
+   *
+   * Complexity: O(M + V log M + R (log L + log S)).
+   * - M = memtablePeerCount
+   * - V = vvPeerCount
+   * - L = memtableLen
+   * - R = scanned candidate rows in KV_BY_PEER_CLOCK
+   * - S = storage key count in KV_BY_KEY
+   * No full O(memtableSize) pre-scan is performed.
    *
    * Use this version when sending to other peers for incremental sync.
    */
@@ -192,8 +198,7 @@ declare class Flock {
   scan(options?: ScanOptions): ScanRow[];
   private ensureNativeSubscription;
   private handleBatch;
-  private emitBatch;
-  private resetDebounceTimer;
+  private deliverBatch;
   subscribe(listener: (batch: EventBatch) => void): () => void;
   /**
    * Enable auto-debounce mode. Events will be accumulated and emitted after
@@ -250,6 +255,7 @@ declare class Flock {
    * @returns The return value of the callback
    * @throws Error if nested transaction attempted
    * @throws Error if import is called during the transaction (auto-commits first)
+   * @throws Error if called while autoDebounceCommit is active
    *
    * @example
    * ```ts