@lark-sh/client 0.1.7 → 0.1.8

package/dist/index.mjs

@@ -1777,8 +1777,15 @@ var DatabaseReference = class _DatabaseReference {
   // ============================================
   /**
    * Set the data at this location, overwriting any existing data.
+   *
+   * For volatile paths (high-frequency updates), this is fire-and-forget
+   * and resolves immediately without waiting for server confirmation.
    */
   async set(value) {
+    if (this._db.isVolatilePath(this._path)) {
+      this._db._sendVolatileSet(this._path, value);
+      return;
+    }
     await this._db._sendSet(this._path, value);
   }
   /**
@@ -1815,13 +1822,23 @@ var DatabaseReference = class _DatabaseReference {
       }
       await this._db._sendTransaction(ops);
     } else {
+      if (this._db.isVolatilePath(this._path)) {
+        this._db._sendVolatileUpdate(this._path, values);
+        return;
+      }
       await this._db._sendUpdate(this._path, values);
     }
   }
   /**
    * Remove the data at this location.
+   *
+   * For volatile paths, this is fire-and-forget.
    */
   async remove() {
+    if (this._db.isVolatilePath(this._path)) {
+      this._db._sendVolatileDelete(this._path);
+      return;
+    }
     await this._db._sendDelete(this._path);
   }
   /**
@@ -2274,6 +2291,28 @@ function decodeJwtPayload(token) {
   return JSON.parse(decoded);
 }
 
+// src/utils/volatile.ts
+function isVolatilePath(path, patterns) {
+  if (!patterns || patterns.length === 0) {
+    return false;
+  }
+  const segments = path.replace(/^\//, "").split("/").filter((s) => s.length > 0);
+  return patterns.some((pattern) => {
+    const patternSegments = pattern.replace(/^\//, "").split("/").filter((s) => s.length > 0);
+    if (segments.length < patternSegments.length) {
+      return false;
+    }
+    for (let i = 0; i < patternSegments.length; i++) {
+      const p = patternSegments[i];
+      const s = segments[i];
+      if (p !== "*" && p !== s) {
+        return false;
+      }
+    }
+    return true;
+  });
+}
+
 // src/LarkDatabase.ts
 var RECONNECT_BASE_DELAY_MS = 1e3;
 var RECONNECT_MAX_DELAY_MS = 3e4;
@@ -2897,6 +2936,62 @@ var LarkDatabase = class {
     this.send(message);
     await this.messageQueue.registerRequest(requestId);
   }
+  // ============================================
+  // Volatile Write Operations (Fire-and-Forget)
+  // ============================================
+  /**
+   * @internal Send a volatile set operation (fire-and-forget).
+   *
+   * Volatile writes skip:
+   * - Recovery checks (volatile paths don't participate in recovery)
+   * - Request ID generation (no ack expected)
+   * - Pending write tracking (no retry on reconnect)
+   * - pw field (no dependency tracking)
+   *
+   * The write is applied optimistically to local cache for UI feedback,
+   * but we don't await server confirmation.
+   */
+  _sendVolatileSet(path, value) {
+    const normalizedPath = normalizePath(path) || "/";
+    this.subscriptionManager.applyOptimisticWrite(normalizedPath, value, "", "set");
+    const message = {
+      o: "s",
+      p: normalizedPath,
+      v: value
+    };
+    this.send(message);
+  }
+  /**
+   * @internal Send a volatile update operation (fire-and-forget).
+   */
+  _sendVolatileUpdate(path, values) {
+    const normalizedPath = normalizePath(path) || "/";
+    this.subscriptionManager.applyOptimisticWrite(normalizedPath, values, "", "update");
+    const message = {
+      o: "u",
+      p: normalizedPath,
+      v: values
+    };
+    this.send(message);
+  }
+  /**
+   * @internal Send a volatile delete operation (fire-and-forget).
+   */
+  _sendVolatileDelete(path) {
+    const normalizedPath = normalizePath(path) || "/";
+    this.subscriptionManager.applyOptimisticWrite(normalizedPath, null, "", "delete");
+    const message = {
+      o: "d",
+      p: normalizedPath
+    };
+    this.send(message);
+  }
+  /**
+   * Check if a path is a volatile path (high-frequency, fire-and-forget).
+   */
+  isVolatilePath(path) {
+    return isVolatilePath(path, this._volatilePaths);
+  }
   /**
    * @internal Send a once (read) operation.
    *
@@ -3005,21 +3100,6 @@ var LarkDatabase = class {
     this.subscriptionManager.unsubscribeAll(path);
   }
 };
-
-// src/utils/volatile.ts
-function isVolatilePath(path, patterns) {
-  if (!patterns || patterns.length === 0) {
-    return false;
-  }
-  const segments = path.replace(/^\//, "").split("/");
-  return patterns.some((pattern) => {
-    const patternSegments = pattern.split("/");
-    if (segments.length !== patternSegments.length) {
-      return false;
-    }
-    return patternSegments.every((p, i) => p === "*" || p === segments[i]);
-  });
-}
 export {
   DataSnapshot,
   DatabaseReference,