@lark-sh/client 0.1.21 → 0.1.23

package/dist/fb-v8/index.mjs

@@ -7,7 +7,7 @@ import {
   ServerValue,
   generatePushId,
   isVolatilePath
-} from "../chunk-HHBHX2EM.mjs";
+} from "../chunk-3MBKCYWV.mjs";
 
 // src/fb-v8/index.ts
 var DatabaseReference = class _DatabaseReference {

package/dist/index.d.mts

@@ -728,6 +728,7 @@ declare class LarkDatabase {
     private infoSubscriptions;
     private _connectionPromise;
     private _serverTimeOffset;
+    private _pingInterval;
     /**
      * Create a new LarkDatabase instance.
      *
@@ -849,6 +850,10 @@ declare class LarkDatabase {
      * Used for unexpected disconnect.
      */
     private cleanupForReconnect;
+    private static _realSetInterval;
+    private static _realClearInterval;
+    private startPingInterval;
+    private stopPingInterval;
     /**
      * Check if a path is a .info path (handled locally).
      */

package/dist/index.d.ts

@@ -728,6 +728,7 @@ declare class LarkDatabase {
     private infoSubscriptions;
     private _connectionPromise;
     private _serverTimeOffset;
+    private _pingInterval;
     /**
      * Create a new LarkDatabase instance.
      *
@@ -849,6 +850,10 @@ declare class LarkDatabase {
      * Used for unexpected disconnect.
      */
     private cleanupForReconnect;
+    private static _realSetInterval;
+    private static _realClearInterval;
+    private startPingInterval;
+    private stopPingInterval;
     /**
      * Check if a path is a .info path (handled locally).
      */

package/dist/index.js

@@ -413,9 +413,6 @@ function isEventMessage(msg) {
 function isOnceResponseMessage(msg) {
   return "oc" in msg;
 }
-function isPingMessage(msg) {
-  return "o" in msg && msg.o === "pi";
-}
 
 // src/connection/MessageQueue.ts
 var MessageQueue = class {
@@ -1710,15 +1707,14 @@ var SubscriptionManager = class {
   }
   /**
    * Handle an incoming event message from the server.
-   * Server sends 'put', 'patch', or 'vb' (volatile batch) events; we generate child_* events client-side.
+   * Server sends 'put' or 'patch' events; we generate child_* events client-side.
+   * Volatile events use `x: true` flag on patch events.
    */
   handleEvent(message) {
     if (message.ev === "put") {
       this.handlePutEvent(message);
     } else if (message.ev === "patch") {
       this.handlePatchEvent(message);
-    } else if (message.ev === "vb") {
-      this.handleVolatileBatchEvent(message);
     } else {
       console.warn("Unknown event type:", message.ev);
     }
@@ -1791,28 +1787,6 @@ var SubscriptionManager = class {
       this.applyServerUpdateToView(view, updates, isVolatile, serverTimestamp);
     }
   }
-  /**
-   * Handle a 'vb' (volatile batch) event - batched volatile updates across subscriptions.
-   * Server batches volatile events in 50ms intervals to reduce message overhead.
-   * Format: { ev: 'vb', b: { subscriptionPath: { relativePath: value } }, ts: timestamp }
-   * Dispatches to ALL Views at each subscription path.
-   */
-  handleVolatileBatchEvent(message) {
-    const batch = message.b;
-    const serverTimestamp = message.ts;
-    if (!batch) return;
-    for (const [subscriptionPath, updates] of Object.entries(batch)) {
-      const views = this.getViewsAtPath(subscriptionPath);
-      if (views.length === 0) continue;
-      const updatesList = [];
-      for (const [relativePath, value] of Object.entries(updates)) {
-        updatesList.push({ relativePath, value });
-      }
-      for (const view of views) {
-        this.applyServerUpdateToView(view, updatesList, true, serverTimestamp);
-      }
-    }
-  }
   /**
    * Detect and fire child_moved events for children that changed position OR sort value.
    *
@@ -4278,7 +4252,7 @@ var ServerValue = {
    */
   increment: (delta) => ({ ".sv": { increment: delta } })
 };
-var LarkDatabase = class {
+var _LarkDatabase = class _LarkDatabase {
   /**
    * Create a new LarkDatabase instance.
    *
@@ -4321,6 +4295,7 @@ var LarkDatabase = class {
     // Connection promise - shared by connect() and lazy operations
     this._connectionPromise = null;
     this._serverTimeOffset = 0;
+    this._pingInterval = null;
     this.messageQueue = new MessageQueue();
     this.subscriptionManager = new SubscriptionManager();
     this.pendingWrites = new PendingWriteManager();
@@ -4518,6 +4493,7 @@ var LarkDatabase = class {
       };
       this._state = "authenticated";
       this._reconnectAttempt = 0;
+      this.startPingInterval();
       this.fireConnectionStateChange();
       if (isReconnect) {
         await this.restoreAfterReconnect();
@@ -4607,6 +4583,7 @@ var LarkDatabase = class {
    */
   cleanupFull() {
     const wasAuthenticated = this._state === "authenticated";
+    this.stopPingInterval();
     this.transport?.close();
     this.transport = null;
     this._state = "disconnected";
@@ -4629,6 +4606,7 @@ var LarkDatabase = class {
    * Used for unexpected disconnect.
    */
   cleanupForReconnect() {
+    this.stopPingInterval();
     this.transport?.close();
     this.transport = null;
     this._auth = null;
@@ -4636,6 +4614,21 @@ var LarkDatabase = class {
     this.messageQueue.rejectAll(new Error("Connection closed"));
     this.fireConnectionStateChange();
   }
+  startPingInterval() {
+    this.stopPingInterval();
+    this._pingInterval = _LarkDatabase._realSetInterval(() => {
+      this.transport?.send(JSON.stringify({ o: "pi" }));
+    }, 1e4);
+    if (typeof this._pingInterval === "object" && "unref" in this._pingInterval) {
+      this._pingInterval.unref();
+    }
+  }
+  stopPingInterval() {
+    if (this._pingInterval) {
+      _LarkDatabase._realClearInterval(this._pingInterval);
+      this._pingInterval = null;
+    }
+  }
   // ============================================
   // .info Path Handling
   // ============================================
@@ -5018,10 +5011,6 @@ var LarkDatabase = class {
     if (process.env.LARK_DEBUG) {
       console.log("[LARK] <<< SERVER:", JSON.stringify(message, null, 2));
     }
-    if (isPingMessage(message)) {
-      this.transport?.send(JSON.stringify({ o: "po" }));
-      return;
-    }
     if (isAckMessage(message)) {
       this.pendingWrites.onAck(message.a);
       this.subscriptionManager.clearPendingWrite(message.a);
@@ -5375,7 +5364,11 @@ var LarkDatabase = class {
  * Server values that are resolved by the server when a write is committed.
  * Alias for the exported ServerValue object.
  */
-LarkDatabase.ServerValue = ServerValue;
+_LarkDatabase.ServerValue = ServerValue;
+// Use real timers for ping so fake timers in tests don't cause infinite loops
+_LarkDatabase._realSetInterval = globalThis.setInterval;
+_LarkDatabase._realClearInterval = globalThis.clearInterval;
+var LarkDatabase = _LarkDatabase;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DataSnapshot,