@band-ai/band-sdk-core 1.0.1 → 1.1.0

package/band_sdk_core.js

@@ -676,11 +676,16 @@ class SessionOutcome {
         return ret[0] === 0 ? undefined : ret[1];
     }
     /**
-     * @returns {boolean}
+     * @returns {string | undefined}
      */
-    get stale() {
-        const ret = wasm.sessionoutcome_stale(this.__wbg_ptr);
-        return ret !== 0;
+    get staleReason() {
+        const ret = wasm.sessionoutcome_staleReason(this.__wbg_ptr);
+        let v1;
+        if (ret[0] !== 0) {
+            v1 = getStringFromWasm0(ret[0], ret[1]);
+            wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        }
+        return v1;
     }
     /**
      * @returns {string}
@@ -901,6 +906,17 @@ class SubscriptionTracker {
         }
         return ret[0] !== 0;
     }
+    /**
+     * @param {any} topic
+     * @returns {boolean}
+     */
+    markAgentTopicRejoinFailed(topic) {
+        const ret = wasm.subscriptiontracker_markAgentTopicRejoinFailed(this.__wbg_ptr, topic);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] !== 0;
+    }
     /**
      * @param {any} room_id
      * @param {bigint} ticket
@@ -914,6 +930,17 @@ class SubscriptionTracker {
         }
         return ret[0] !== 0;
     }
+    /**
+     * @param {any} room_id
+     * @returns {boolean}
+     */
+    markRoomRejoinFailed(room_id) {
+        const ret = wasm.subscriptiontracker_markRoomRejoinFailed(this.__wbg_ptr, room_id);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] !== 0;
+    }
     constructor() {
         const ret = wasm.subscriptiontracker_new();
         this.__wbg_ptr = ret;

package/index.d.ts

@@ -173,6 +173,12 @@ export type SessionState = "connecting" | "up" | "reconnecting" | "dead";
 
 export type DeadReason = "classified" | "rapid_disconnect";
 
+export type StaleReason =
+  | "wrong_epoch"
+  | "clock_regression"
+  | "duplicate_connected"
+  | "supersede_predates_epoch";
+
 export type RoomMembership = "unadmitted" | "admitting" | "admitted";
 
 /**
@@ -199,7 +205,7 @@ export class SessionOutcome {
   readonly state: SessionState;
   readonly retryAfterS: number | undefined;
   readonly deadReason: DeadReason | undefined;
-  readonly stale: boolean;
+  readonly staleReason: StaleReason | undefined;
 }
 
 /** {@link SessionPolicy}'s constructor fields. */
@@ -285,6 +291,7 @@ export class SubscriptionTracker {
   unsubscribeRoom(roomId: string): bigint | undefined;
   markRoomLeaveComplete(roomId: string, ticket: bigint, outcome: LeaveOutcome): boolean;
   acknowledgeRoomReconciled(roomId: string): boolean;
+  markRoomRejoinFailed(roomId: string): boolean;
   subscribedRoomIds(): string[];
   onReconnected(): void;
   endSession(): void;
@@ -296,6 +303,7 @@ export class SubscriptionTracker {
   leaveAgentTopic(topic: string): bigint | undefined;
   markAgentTopicLeaveComplete(topic: string, ticket: bigint, outcome: LeaveOutcome): boolean;
   acknowledgeAgentTopicReconciled(topic: string): boolean;
+  markAgentTopicRejoinFailed(topic: string): boolean;
   joinedAgentTopics(): string[];
 }
 

package/package.json

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