@band-ai/band-sdk-core 0.6.0 → 0.7.0

package/band_sdk_core.js

@@ -348,6 +348,170 @@ class RetryTracker {
 if (Symbol.dispose) RetryTracker.prototype[Symbol.dispose] = RetryTracker.prototype.free;
 exports.RetryTracker = RetryTracker;
 
+/**
+ * One reconnect's reconciliation against an authoritative room snapshot.
+ * `removed` and `admitting` are already applied by the time this is
+ * returned.
+ */
+class RoomReconciliation {
+    static __wrap(ptr) {
+        const obj = Object.create(RoomReconciliation.prototype);
+        obj.__wbg_ptr = ptr;
+        RoomReconciliationFinalization.register(obj, obj.__wbg_ptr, obj);
+        return obj;
+    }
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        RoomReconciliationFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_roomreconciliation_free(ptr, 0);
+    }
+    /**
+     * @returns {Array<any>}
+     */
+    get admitting() {
+        const ret = wasm.roomreconciliation_admitting(this.__wbg_ptr);
+        return ret;
+    }
+    /**
+     * @returns {string[]}
+     */
+    get removed() {
+        const ret = wasm.roomreconciliation_removed(this.__wbg_ptr);
+        var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]);
+        wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+        return v1;
+    }
+    /**
+     * @returns {string[]}
+     */
+    get resync() {
+        const ret = wasm.roomreconciliation_resync(this.__wbg_ptr);
+        var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]);
+        wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+        return v1;
+    }
+}
+if (Symbol.dispose) RoomReconciliation.prototype[Symbol.dispose] = RoomReconciliation.prototype.free;
+exports.RoomReconciliation = RoomReconciliation;
+
+/**
+ * Room admission and membership decisions for one agent session, separate
+ * from `SubscriptionTracker`'s two-topic transport join.
+ */
+class RoomRoster {
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        RoomRosterFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_roomroster_free(ptr, 0);
+    }
+    /**
+     * @param {any} room_id
+     * @param {boolean} passesFilter
+     * @returns {bigint | undefined}
+     */
+    beginRoomAdmission(room_id, passesFilter) {
+        const ret = wasm.roomroster_beginRoomAdmission(this.__wbg_ptr, room_id, passesFilter);
+        if (ret[3]) {
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        return ret[0] === 0 ? undefined : BigInt.asUintN(64, ret[1]);
+    }
+    /**
+     * @returns {string[]}
+     */
+    clear() {
+        const ret = wasm.roomroster_clear(this.__wbg_ptr);
+        var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]);
+        wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+        return v1;
+    }
+    /**
+     * @param {any} room_id
+     * @param {bigint} ticket
+     * @returns {boolean}
+     */
+    isRoomAdmissionCurrent(room_id, ticket) {
+        const ret = wasm.roomroster_isRoomAdmissionCurrent(this.__wbg_ptr, room_id, ticket);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] !== 0;
+    }
+    constructor() {
+        const ret = wasm.roomroster_new();
+        this.__wbg_ptr = ret;
+        RoomRosterFinalization.register(this, this.__wbg_ptr, this);
+        return this;
+    }
+    /**
+     * @param {any} current_room_ids
+     * @returns {RoomReconciliation}
+     */
+    reconcile(current_room_ids) {
+        const ret = wasm.roomroster_reconcile(this.__wbg_ptr, current_room_ids);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return RoomReconciliation.__wrap(ret[0]);
+    }
+    /**
+     * @param {any} room_id
+     * @param {bigint} ticket
+     * @param {boolean} succeeded
+     * @returns {boolean}
+     */
+    recordRoomAdmission(room_id, ticket, succeeded) {
+        const ret = wasm.roomroster_recordRoomAdmission(this.__wbg_ptr, room_id, ticket, succeeded);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] !== 0;
+    }
+    /**
+     * @param {any} room_id
+     * @returns {boolean}
+     */
+    recordRoomRemoved(room_id) {
+        const ret = wasm.roomroster_recordRoomRemoved(this.__wbg_ptr, room_id);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] !== 0;
+    }
+    /**
+     * @param {any} room_id
+     * @returns {string}
+     */
+    roomMembership(room_id) {
+        const ret = wasm.roomroster_roomMembership(this.__wbg_ptr, room_id);
+        if (ret[3]) {
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        return getStringFromWasm0(ret[0], ret[1]);
+    }
+    /**
+     * @returns {string[]}
+     */
+    trackedRoomIds() {
+        const ret = wasm.roomroster_trackedRoomIds(this.__wbg_ptr);
+        var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]);
+        wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+        return v1;
+    }
+}
+if (Symbol.dispose) RoomRoster.prototype[Symbol.dispose] = RoomRoster.prototype.free;
+exports.RoomRoster = RoomRoster;
+
 /**
  * One WebSocket session's state machine. Behavior contract:
  * `docs/runtime-state-policy.md`'s `## Session` section.
@@ -1181,6 +1345,12 @@ const ParticipantRosterFinalization = (typeof FinalizationRegistry === 'undefine
 const RetryTrackerFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_retrytracker_free(ptr, 1));
+const RoomReconciliationFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_roomreconciliation_free(ptr, 1));
+const RoomRosterFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_roomroster_free(ptr, 1));
 const SessionFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_session_free(ptr, 1));

package/index.d.ts

@@ -173,6 +173,8 @@ export type SessionState = "connecting" | "up" | "reconnecting" | "dead";
 
 export type DeadReason = "classified" | "rapid_disconnect";
 
+export type RoomMembership = "unadmitted" | "admitting" | "admitted";
+
 /**
  * Classify a WebSocket close code. Returns `[terminal, delayRange]`.
  * Throws a plain `Error` if `closeCode` is not an integer in `0..=65535`
@@ -297,3 +299,35 @@ export class SubscriptionTracker {
   acknowledgeAgentTopicReconciled(topic: string): boolean;
   joinedAgentTopics(): string[];
 }
+
+/**
+ * One reconnect's reconciliation against an authoritative room snapshot.
+ * `removed` and `admitting` are already applied by the time this is
+ * returned.
+ */
+export class RoomReconciliation {
+  private constructor();
+  readonly removed: string[];
+  readonly admitting: Array<[string, bigint]>;
+  readonly resync: string[];
+}
+
+/**
+ * Room admission and membership decisions for one agent session, separate
+ * from {@link SubscriptionTracker}'s two-topic transport join.
+ *
+ * Every `roomId` argument below throws a plain `Error` if it is not a
+ * string. `reconcile` throws a plain `Error` if `currentRoomIds` is not an
+ * array of strings.
+ */
+export class RoomRoster {
+  constructor();
+  roomMembership(roomId: string): RoomMembership;
+  beginRoomAdmission(roomId: string, passesFilter: boolean): bigint | undefined;
+  recordRoomAdmission(roomId: string, ticket: bigint, succeeded: boolean): boolean;
+  isRoomAdmissionCurrent(roomId: string, ticket: bigint): boolean;
+  recordRoomRemoved(roomId: string): boolean;
+  trackedRoomIds(): string[];
+  reconcile(currentRoomIds: string[]): RoomReconciliation;
+  clear(): string[];
+}

package/package.json

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