@band-ai/band-sdk-core 1.2.0 → 2.0.0

package/band_sdk_core.js

@@ -727,6 +727,13 @@ class SessionPolicy {
         const ptr = this.__destroy_into_raw();
         wasm.__wbg_sessionpolicy_free(ptr, 0);
     }
+    /**
+     * @returns {number}
+     */
+    get deadThresholdS() {
+        const ret = wasm.sessionpolicy_deadThresholdS(this.__wbg_ptr);
+        return ret;
+    }
     /**
      * A recommended, not final, default.
      * @returns {SessionPolicy}
@@ -735,6 +742,13 @@ class SessionPolicy {
         const ret = wasm.sessionpolicy_default();
         return SessionPolicy.__wrap(ret);
     }
+    /**
+     * @returns {number}
+     */
+    get heartbeatIntervalS() {
+        const ret = wasm.sessionpolicy_heartbeatIntervalS(this.__wbg_ptr);
+        return ret;
+    }
     /**
      * `config` is any plain object with the fields declared in
      * `index.d.ts`'s `SessionPolicyConfig`; grouped into one value rather
@@ -791,6 +805,13 @@ class SubscriptionTracker {
         }
         return ret[0] !== 0;
     }
+    /**
+     * @returns {Array<any>}
+     */
+    agentTopicRejoinCandidates() {
+        const ret = wasm.subscriptiontracker_agentTopicRejoinCandidates(this.__wbg_ptr);
+        return ret;
+    }
     /**
      * @param {any} topic
      * @returns {string}
@@ -908,10 +929,11 @@ class SubscriptionTracker {
     }
     /**
      * @param {any} topic
+     * @param {bigint} ticket
      * @returns {boolean}
      */
-    markAgentTopicRejoinFailed(topic) {
-        const ret = wasm.subscriptiontracker_markAgentTopicRejoinFailed(this.__wbg_ptr, topic);
+    markAgentTopicRejoinFailed(topic, ticket) {
+        const ret = wasm.subscriptiontracker_markAgentTopicRejoinFailed(this.__wbg_ptr, topic, ticket);
         if (ret[2]) {
             throw takeFromExternrefTable0(ret[1]);
         }
@@ -932,10 +954,11 @@ class SubscriptionTracker {
     }
     /**
      * @param {any} room_id
+     * @param {bigint} ticket
      * @returns {boolean}
      */
-    markRoomRejoinFailed(room_id) {
-        const ret = wasm.subscriptiontracker_markRoomRejoinFailed(this.__wbg_ptr, room_id);
+    markRoomRejoinFailed(room_id, ticket) {
+        const ret = wasm.subscriptiontracker_markRoomRejoinFailed(this.__wbg_ptr, room_id, ticket);
         if (ret[2]) {
             throw takeFromExternrefTable0(ret[1]);
         }
@@ -963,6 +986,18 @@ class SubscriptionTracker {
         }
         return ret[0] !== 0;
     }
+    /**
+     * @param {any} topic
+     * @param {bigint} ticket
+     * @returns {boolean}
+     */
+    recordAgentTopicJoinAmbiguous(topic, ticket) {
+        const ret = wasm.subscriptiontracker_recordAgentTopicJoinAmbiguous(this.__wbg_ptr, topic, ticket);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] !== 0;
+    }
     /**
      * @param {any} room_id
      * @param {bigint} ticket
@@ -1000,6 +1035,13 @@ class SubscriptionTracker {
         }
         return getStringFromWasm0(ret[0], ret[1]);
     }
+    /**
+     * @returns {Array<any>}
+     */
+    roomRejoinCandidates() {
+        const ret = wasm.subscriptiontracker_roomRejoinCandidates(this.__wbg_ptr);
+        return ret;
+    }
     /**
      * @param {any} room_id
      * @returns {string}

package/index.d.ts

@@ -240,21 +240,26 @@ export interface SessionPolicyConfig {
   rapidCooldownStepS: number;
   rapidCooldownMaxS: number;
   rapidThreshold: number;
+  heartbeatIntervalS: number;
+  deadThresholdS: number;
 }
 
 /**
  * Reconnect backoff/jitter policy, plus the graduated rapid-disconnect
  * cooldown ladder. A recommended, not final, starting design.
  *
- * Throws a native `Error` with `.issues`/`.traceContext` if `factor < 1.0`
- * or `baseDelayS > maxDelayS`. Throws a plain `Error` if `config` is
- * missing a field or a field is not a finite, non-negative number
- * (`rapidThreshold` must also be an integer).
+ * Throws a native `Error` with `.issues`/`.traceContext` if `factor < 1.0`,
+ * `baseDelayS > maxDelayS`, `heartbeatIntervalS == 0`, or
+ * `deadThresholdS <= heartbeatIntervalS`. Throws a plain `Error` if
+ * `config` is missing a field or a field is not a finite, non-negative
+ * number (`rapidThreshold` must also be an integer).
  */
 export class SessionPolicy {
   constructor(config: SessionPolicyConfig, traceContext?: string | null);
   /** A recommended, not final, default. */
   static default(): SessionPolicy;
+  readonly heartbeatIntervalS: number;
+  readonly deadThresholdS: number;
 }
 
 /**
@@ -309,19 +314,22 @@ export class SubscriptionTracker {
   unsubscribeRoom(roomId: string): bigint | undefined;
   markRoomLeaveComplete(roomId: string, ticket: bigint, outcome: LeaveOutcome): boolean;
   acknowledgeRoomReconciled(roomId: string): boolean;
-  markRoomRejoinFailed(roomId: string): boolean;
+  roomRejoinCandidates(): Array<[string, bigint]>;
+  markRoomRejoinFailed(roomId: string, ticket: bigint): boolean;
   subscribedRoomIds(): string[];
   onReconnected(): void;
   endSession(): void;
   beginAgentTopicJoin(topic: string): bigint | undefined;
   recordAgentTopicJoin(topic: string, ticket: bigint, joined: boolean): boolean;
+  recordAgentTopicJoinAmbiguous(topic: string, ticket: bigint): boolean;
   isAgentTopicJoined(topic: string): boolean;
   isAgentTopicClaimCurrent(topic: string, ticket: bigint): boolean;
   agentTopicStatus(topic: string): AgentTopicStatus;
   leaveAgentTopic(topic: string): bigint | undefined;
   markAgentTopicLeaveComplete(topic: string, ticket: bigint, outcome: LeaveOutcome): boolean;
   acknowledgeAgentTopicReconciled(topic: string): boolean;
-  markAgentTopicRejoinFailed(topic: string): boolean;
+  agentTopicRejoinCandidates(): Array<[string, bigint]>;
+  markAgentTopicRejoinFailed(topic: string, ticket: bigint): boolean;
   joinedAgentTopics(): string[];
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@band-ai/band-sdk-core",
-  "version": "1.2.0",
+  "version": "2.0.0",
   "description": "Shared Band event-payload validation",
   "license": "MIT",
   "repository": {