@band-ai/band-sdk-core 1.0.1 → 1.2.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;
@@ -1008,6 +1035,106 @@ class SubscriptionTracker {
 if (Symbol.dispose) SubscriptionTracker.prototype[Symbol.dispose] = SubscriptionTracker.prototype.free;
 exports.SubscriptionTracker = SubscriptionTracker;
 
+/**
+ * This platform's Phoenix Channels topic for the `agent_contacts` channel.
+ * @param {any} agentId
+ * @returns {string}
+ */
+function agentContactsTopic(agentId) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const ret = wasm.agentContactsTopic(agentId);
+        var ptr1 = ret[0];
+        var len1 = ret[1];
+        if (ret[3]) {
+            ptr1 = 0; len1 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred2_0 = ptr1;
+        deferred2_1 = len1;
+        return getStringFromWasm0(ptr1, len1);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+exports.agentContactsTopic = agentContactsTopic;
+
+/**
+ * This platform's Phoenix Channels topic for the `agent_control` channel.
+ * @param {any} agentId
+ * @returns {string}
+ */
+function agentControlTopic(agentId) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const ret = wasm.agentControlTopic(agentId);
+        var ptr1 = ret[0];
+        var len1 = ret[1];
+        if (ret[3]) {
+            ptr1 = 0; len1 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred2_0 = ptr1;
+        deferred2_1 = len1;
+        return getStringFromWasm0(ptr1, len1);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+exports.agentControlTopic = agentControlTopic;
+
+/**
+ * This platform's Phoenix Channels topic for the `agent_rooms` channel.
+ * @param {any} agentId
+ * @returns {string}
+ */
+function agentRoomsTopic(agentId) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const ret = wasm.agentRoomsTopic(agentId);
+        var ptr1 = ret[0];
+        var len1 = ret[1];
+        if (ret[3]) {
+            ptr1 = 0; len1 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred2_0 = ptr1;
+        deferred2_1 = len1;
+        return getStringFromWasm0(ptr1, len1);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+exports.agentRoomsTopic = agentRoomsTopic;
+
+/**
+ * This platform's Phoenix Channels topic for a room's `chat_room` channel.
+ * @param {any} roomId
+ * @returns {string}
+ */
+function chatRoomTopic(roomId) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const ret = wasm.chatRoomTopic(roomId);
+        var ptr1 = ret[0];
+        var len1 = ret[1];
+        if (ret[3]) {
+            ptr1 = 0; len1 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred2_0 = ptr1;
+        deferred2_1 = len1;
+        return getStringFromWasm0(ptr1, len1);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+exports.chatRoomTopic = chatRoomTopic;
+
 /**
  * Classify a WebSocket close code. Returns `[terminal, delayRange]`.
  * @param {number | null} [closeCode]
@@ -1037,6 +1164,32 @@ function classifyUpgrade(status) {
 }
 exports.classifyUpgrade = classifyUpgrade;
 
+/**
+ * This platform's Phoenix Channels topic for a room's `room_participants`
+ * channel.
+ * @param {any} roomId
+ * @returns {string}
+ */
+function roomParticipantsTopic(roomId) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const ret = wasm.roomParticipantsTopic(roomId);
+        var ptr1 = ret[0];
+        var len1 = ret[1];
+        if (ret[3]) {
+            ptr1 = 0; len1 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred2_0 = ptr1;
+        deferred2_1 = len1;
+        return getStringFromWasm0(ptr1, len1);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+exports.roomParticipantsTopic = roomParticipantsTopic;
+
 /**
  * Validate and normalize an inbound platform event payload.
  *

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";
 
 /**
@@ -193,13 +199,31 @@ export function classifyUpgrade(
   status: number,
 ): [boolean, [number, number] | undefined];
 
+/** This platform's Phoenix Channels topic for the `agent_control` channel. */
+export function agentControlTopic(agentId: string): string;
+
+/** This platform's Phoenix Channels topic for the `agent_rooms` channel. */
+export function agentRoomsTopic(agentId: string): string;
+
+/** This platform's Phoenix Channels topic for the `agent_contacts` channel. */
+export function agentContactsTopic(agentId: string): string;
+
+/** This platform's Phoenix Channels topic for a room's `chat_room` channel. */
+export function chatRoomTopic(roomId: string): string;
+
+/**
+ * This platform's Phoenix Channels topic for a room's `room_participants`
+ * channel.
+ */
+export function roomParticipantsTopic(roomId: string): string;
+
 /** The settled outcome of one {@link Session} call. */
 export class SessionOutcome {
   private constructor();
   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 +309,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 +321,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.2.0",
   "description": "Shared Band event-payload validation",
   "license": "MIT",
   "repository": {