@loro-dev/flock-sqlite 0.5.0 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loro-dev/flock-sqlite",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "SQLite-backed Flock CRDT replica for Node, browsers, and Cloudflare Workers.",
   "type": "module",
   "exports": {
@@ -62,7 +62,7 @@
     "tsdown": "^0.15.4",
     "typescript": "^5.9.2",
     "vitest": "^3.2.4",
-    "@loro-dev/flock": "4.3.0"
+    "@loro-dev/flock": "4.4.0"
   },
   "scripts": {
     "build": "tsdown",

package/src/index.ts

@@ -635,7 +635,9 @@ export class FlockSQLite {
   private debounceState:
     | {
         timeout: number;
+        maxDebounceTime: number;
         timerId: ReturnType<typeof setTimeout> | undefined;
+        maxTimerId: ReturnType<typeof setTimeout> | undefined;
         pendingEvents: Array<{
           key: KeyPart[];
           payload: ExportPayload;
@@ -969,6 +971,17 @@ export class FlockSQLite {
     this.debounceState.timerId = setTimeout(() => {
       this.commit();
     }, this.debounceState.timeout);
+
+    // Start max debounce timer on first pending event
+    // Note: this is called after the event is pushed, so length === 1 means first event
+    if (
+      this.debounceState.maxTimerId === undefined &&
+      this.debounceState.pendingEvents.length === 1
+    ) {
+      this.debounceState.maxTimerId = setTimeout(() => {
+        this.commit();
+      }, this.debounceState.maxDebounceTime);
+    }
   }
 
   private emitEvents(
@@ -1740,6 +1753,7 @@ export class FlockSQLite {
    * Import operations will automatically call `commit()` before proceeding.
    *
    * @param timeout - Debounce timeout in milliseconds
+   * @param options - Optional configuration object with maxDebounceTime (default: 10000ms)
    * @throws Error if called while a transaction is active
    * @throws Error if autoDebounceCommit is already active
    *
@@ -1750,9 +1764,13 @@ export class FlockSQLite {
    * await flock.put(["b"], 2);
    * // No events emitted yet...
    * // After 100ms of inactivity, subscribers receive single EventBatch
+   * // If operations keep coming, commit happens after maxDebounceTime (10s default)
    * ```
    */
-  autoDebounceCommit(timeout: number): void {
+  autoDebounceCommit(
+    timeout: number,
+    options?: { maxDebounceTime?: number },
+  ): void {
     if (this.txnEventSink !== undefined) {
       throw new Error(
         "Cannot enable autoDebounceCommit while transaction is active",
@@ -1762,9 +1780,13 @@ export class FlockSQLite {
       throw new Error("autoDebounceCommit is already active");
     }
 
+    const maxDebounceTime = options?.maxDebounceTime ?? 10000;
+
     this.debounceState = {
       timeout,
+      maxDebounceTime,
       timerId: undefined,
+      maxTimerId: undefined,
       pendingEvents: [],
     };
   }
@@ -1778,10 +1800,13 @@ export class FlockSQLite {
       return;
     }
 
-    const { timerId, pendingEvents } = this.debounceState;
+    const { timerId, maxTimerId, pendingEvents } = this.debounceState;
     if (timerId !== undefined) {
       clearTimeout(timerId);
     }
+    if (maxTimerId !== undefined) {
+      clearTimeout(maxTimerId);
+    }
     this.debounceState = undefined;
 
     if (pendingEvents.length > 0) {
@@ -1799,11 +1824,15 @@ export class FlockSQLite {
       return;
     }
 
-    const { timerId, pendingEvents } = this.debounceState;
+    const { timerId, maxTimerId, pendingEvents } = this.debounceState;
     if (timerId !== undefined) {
       clearTimeout(timerId);
       this.debounceState.timerId = undefined;
     }
+    if (maxTimerId !== undefined) {
+      clearTimeout(maxTimerId);
+      this.debounceState.maxTimerId = undefined;
+    }
 
     if (pendingEvents.length > 0) {
       this.emitEvents("local", pendingEvents);