@band-ai/band-sdk-core 0.0.0-dev.0

package/bandcore.js

@@ -0,0 +1,843 @@
+/* @ts-self-types="./index.d.ts" */
+
+/**
+ * Ownership ledger for the inbound message-delivery lifecycle: in-flight,
+ * ack-pending, and completed states, each scoped by `(roomId,
+ * messageId)`.
+ */
+class ClaimRegistry {
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        ClaimRegistryFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_claimregistry_free(ptr, 0);
+    }
+    /**
+     * @param {any} room_id
+     * @returns {string[]}
+     */
+    completedIds(room_id) {
+        const ret = wasm.claimregistry_completedIds(this.__wbg_ptr, room_id);
+        if (ret[3]) {
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]);
+        wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+        return v1;
+    }
+    /**
+     * @param {any} room_id
+     */
+    discardCompleted(room_id) {
+        const ret = wasm.claimregistry_discardCompleted(this.__wbg_ptr, room_id);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+    /**
+     * @param {any} room_id
+     * @returns {string[]}
+     */
+    inflightIds(room_id) {
+        const ret = wasm.claimregistry_inflightIds(this.__wbg_ptr, room_id);
+        if (ret[3]) {
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]);
+        wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+        return v1;
+    }
+    /**
+     * @param {any} room_id
+     * @param {any} message_id
+     * @returns {boolean}
+     */
+    isAckPending(room_id, message_id) {
+        const ret = wasm.claimregistry_isAckPending(this.__wbg_ptr, room_id, message_id);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] !== 0;
+    }
+    /**
+     * @param {any} room_id
+     * @param {any} message_id
+     * @returns {boolean}
+     */
+    isCompleted(room_id, message_id) {
+        const ret = wasm.claimregistry_isCompleted(this.__wbg_ptr, room_id, message_id);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] !== 0;
+    }
+    /**
+     * @returns {number}
+     */
+    get maxCompleted() {
+        const ret = wasm.claimregistry_maxCompleted(this.__wbg_ptr);
+        return ret >>> 0;
+    }
+    /**
+     * @param {number | null} [maxCompleted]
+     */
+    constructor(maxCompleted) {
+        const ret = wasm.claimregistry_new(!isLikeNone(maxCompleted), isLikeNone(maxCompleted) ? 0 : maxCompleted);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        this.__wbg_ptr = ret[0];
+        ClaimRegistryFinalization.register(this, this.__wbg_ptr, this);
+        return this;
+    }
+    /**
+     * @param {any} room_id
+     * @returns {string[]}
+     */
+    pendingAckIds(room_id) {
+        const ret = wasm.claimregistry_pendingAckIds(this.__wbg_ptr, room_id);
+        if (ret[3]) {
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]);
+        wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+        return v1;
+    }
+    /**
+     * @param {any} room_id
+     * @param {any} message_id
+     * @returns {number}
+     */
+    recordAckRetry(room_id, message_id) {
+        const ret = wasm.claimregistry_recordAckRetry(this.__wbg_ptr, room_id, message_id);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] >>> 0;
+    }
+    /**
+     * @param {any} room_id
+     * @param {any} message_id
+     */
+    release(room_id, message_id) {
+        const ret = wasm.claimregistry_release(this.__wbg_ptr, room_id, message_id);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+    /**
+     * @param {any} room_id
+     * @param {any} message_id
+     */
+    rememberAckPending(room_id, message_id) {
+        const ret = wasm.claimregistry_rememberAckPending(this.__wbg_ptr, room_id, message_id);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+    /**
+     * @param {any} room_id
+     * @param {any} message_id
+     */
+    rememberCompleted(room_id, message_id) {
+        const ret = wasm.claimregistry_rememberCompleted(this.__wbg_ptr, room_id, message_id);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+    /**
+     * @param {any} room_id
+     * @param {any} message_id
+     * @returns {boolean}
+     */
+    tryClaim(room_id, message_id) {
+        const ret = wasm.claimregistry_tryClaim(this.__wbg_ptr, room_id, message_id);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] !== 0;
+    }
+}
+if (Symbol.dispose) ClaimRegistry.prototype[Symbol.dispose] = ClaimRegistry.prototype.free;
+exports.ClaimRegistry = ClaimRegistry;
+
+/**
+ * The always-injected passive participant roster. A participant is any
+ * plain object; `add`/`setAll` read `id`, `name`, `type`, `handle`,
+ * `description` from it and returned by [`list`](Self::list) -- every
+ * other key is dropped, matching the platform's own `participant_added`/
+ * `participant_removed` field set. `id` is required and must be a string;
+ * the other four are each a string or `null`/absent.
+ */
+class ParticipantRoster {
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        ParticipantRosterFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_participantroster_free(ptr, 0);
+    }
+    /**
+     * Add a participant, or merge it into the existing entry with the
+     * same `id`. Returns `true` if newly added, `false` if an existing id
+     * was refreshed in place.
+     * @param {any} participant
+     * @returns {boolean}
+     */
+    add(participant) {
+        const ret = wasm.participantroster_add(this.__wbg_ptr, participant);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] !== 0;
+    }
+    /**
+     * Whether membership or any tracked field changed since the last
+     * `markSent()`.
+     * @returns {boolean}
+     */
+    changed() {
+        const ret = wasm.participantroster_changed(this.__wbg_ptr);
+        return ret !== 0;
+    }
+    /**
+     * The current roster, in add order, as an array of plain objects.
+     * @returns {Array<any>}
+     */
+    list() {
+        const ret = wasm.participantroster_list(this.__wbg_ptr);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
+    markSent() {
+        wasm.participantroster_markSent(this.__wbg_ptr);
+    }
+    constructor() {
+        const ret = wasm.participantroster_new();
+        this.__wbg_ptr = ret;
+        ParticipantRosterFinalization.register(this, this.__wbg_ptr, this);
+        return this;
+    }
+    /**
+     * Remove the participant with this id. Returns `true` if one was
+     * removed.
+     * @param {any} participantId
+     * @returns {boolean}
+     */
+    remove(participantId) {
+        const ret = wasm.participantroster_remove(this.__wbg_ptr, participantId);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] !== 0;
+    }
+    /**
+     * Replace the roster from an authoritative array of participants.
+     * Rejects the whole snapshot -- leaving the roster unchanged -- if any
+     * id appears in it more than once, throwing a native `Error` with
+     * `.issues` and `.traceContext`.
+     * @param {any} participants
+     * @param {any} traceContext
+     */
+    setAll(participants, traceContext) {
+        const ret = wasm.participantroster_setAll(this.__wbg_ptr, participants, traceContext);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+}
+if (Symbol.dispose) ParticipantRoster.prototype[Symbol.dispose] = ParticipantRoster.prototype.free;
+exports.ParticipantRoster = ParticipantRoster;
+
+/**
+ * Per-message retry budget: bounded attempt/failure tracking plus
+ * `discardAttempt` for a cycle the caller's own control signal aborted
+ * before it ran the handler.
+ */
+class RetryTracker {
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        RetryTrackerFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_retrytracker_free(ptr, 0);
+    }
+    /**
+     * @param {any} message_id
+     */
+    discardAttempt(message_id) {
+        const ret = wasm.retrytracker_discardAttempt(this.__wbg_ptr, message_id);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+    /**
+     * @param {any} message_id
+     * @returns {boolean}
+     */
+    isPermanentlyFailed(message_id) {
+        const ret = wasm.retrytracker_isPermanentlyFailed(this.__wbg_ptr, message_id);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] !== 0;
+    }
+    /**
+     * @param {any} message_id
+     */
+    markPermanentlyFailed(message_id) {
+        const ret = wasm.retrytracker_markPermanentlyFailed(this.__wbg_ptr, message_id);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+    /**
+     * @param {any} message_id
+     */
+    markSuccess(message_id) {
+        const ret = wasm.retrytracker_markSuccess(this.__wbg_ptr, message_id);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+    /**
+     * @returns {number}
+     */
+    get maxRetries() {
+        const ret = wasm.retrytracker_maxRetries(this.__wbg_ptr);
+        return ret >>> 0;
+    }
+    /**
+     * @param {number | null} [maxRetries]
+     * @param {number | null} [maxTracked]
+     */
+    constructor(maxRetries, maxTracked) {
+        const ret = wasm.retrytracker_new(!isLikeNone(maxRetries), isLikeNone(maxRetries) ? 0 : maxRetries, !isLikeNone(maxTracked), isLikeNone(maxTracked) ? 0 : maxTracked);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        this.__wbg_ptr = ret[0];
+        RetryTrackerFinalization.register(this, this.__wbg_ptr, this);
+        return this;
+    }
+    /**
+     * Returns `[attemptCount, exceeded]`.
+     * @param {any} message_id
+     * @returns {Array<any>}
+     */
+    recordAttempt(message_id) {
+        const ret = wasm.retrytracker_recordAttempt(this.__wbg_ptr, message_id);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
+}
+if (Symbol.dispose) RetryTracker.prototype[Symbol.dispose] = RetryTracker.prototype.free;
+exports.RetryTracker = RetryTracker;
+
+/**
+ * Validate and normalize an inbound platform event payload.
+ *
+ * On failure throws a native `Error` with `.issues` (an array of
+ * `{path, code, message}` objects) and `.traceContext`. A non-string
+ * `eventType` or `traceContext` throws a plain `Error` without `.issues`.
+ * @param {any} event_type
+ * @param {any} raw
+ * @param {any} traceContext
+ * @returns {any}
+ */
+function validateEventPayload(event_type, raw, traceContext) {
+    const ret = wasm.validateEventPayload(event_type, raw, traceContext);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+exports.validateEventPayload = validateEventPayload;
+
+/**
+ * Validate that `type` belongs to `system`'s allowed type set.
+ *
+ * On failure throws a native `Error` with `.issues` (an array of
+ * `{path, code, message}` objects) and `.traceContext`. An unrecognized
+ * `system` and an unrecognized `type` are independent issues and both are
+ * reported when both strings are invalid. A non-string `system`, `type`,
+ * or `traceContext` throws a plain `Error` without `.issues`, matching
+ * this crate's contract for a value that cannot be converted.
+ * @param {any} system
+ * @param {any} memoryType
+ * @param {any} traceContext
+ */
+function validateMemoryTypeForSystem(system, memoryType, traceContext) {
+    const ret = wasm.validateMemoryTypeForSystem(system, memoryType, traceContext);
+    if (ret[1]) {
+        throw takeFromExternrefTable0(ret[0]);
+    }
+}
+exports.validateMemoryTypeForSystem = validateMemoryTypeForSystem;
+function __wbg_get_imports() {
+    const import0 = {
+        __proto__: null,
+        __wbg_Error_408e67f47ca7b58b: function(arg0, arg1) {
+            const ret = Error(getStringFromWasm0(arg0, arg1));
+            return ret;
+        },
+        __wbg_String_8564e559799eccda: function(arg0, arg1) {
+            const ret = String(arg1);
+            const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            const len1 = WASM_VECTOR_LEN;
+            getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+        },
+        __wbg___wbindgen_bigint_get_as_i64_c4ecf48528083721: function(arg0, arg1) {
+            const v = arg1;
+            const ret = typeof(v) === 'bigint' ? v : undefined;
+            getDataViewMemory0().setBigInt64(arg0 + 8 * 1, isLikeNone(ret) ? BigInt(0) : ret, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
+        },
+        __wbg___wbindgen_boolean_get_c9c83ebd41b34df3: function(arg0) {
+            const v = arg0;
+            const ret = typeof(v) === 'boolean' ? v : undefined;
+            return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
+        },
+        __wbg___wbindgen_debug_string_a57024b9c6e4a48b: function(arg0, arg1) {
+            const ret = debugString(arg1);
+            const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            const len1 = WASM_VECTOR_LEN;
+            getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+        },
+        __wbg___wbindgen_in_ac983077f137f2e6: function(arg0, arg1) {
+            const ret = arg0 in arg1;
+            return ret;
+        },
+        __wbg___wbindgen_is_bigint_8ffbbef442139384: function(arg0) {
+            const ret = typeof(arg0) === 'bigint';
+            return ret;
+        },
+        __wbg___wbindgen_is_function_5e4570eb24ffa122: function(arg0) {
+            const ret = typeof(arg0) === 'function';
+            return ret;
+        },
+        __wbg___wbindgen_is_null_7d13f41e1a2d5140: function(arg0) {
+            const ret = arg0 === null;
+            return ret;
+        },
+        __wbg___wbindgen_is_object_a2790eb24c211ea0: function(arg0) {
+            const val = arg0;
+            const ret = typeof(val) === 'object' && val !== null;
+            return ret;
+        },
+        __wbg___wbindgen_is_string_e6f02f0ea5f20a32: function(arg0) {
+            const ret = typeof(arg0) === 'string';
+            return ret;
+        },
+        __wbg___wbindgen_is_undefined_6cff064c44e0d823: function(arg0) {
+            const ret = arg0 === undefined;
+            return ret;
+        },
+        __wbg___wbindgen_jsval_eq_0a18949a61670320: function(arg0, arg1) {
+            const ret = arg0 === arg1;
+            return ret;
+        },
+        __wbg___wbindgen_jsval_loose_eq_acf2776254a8d832: function(arg0, arg1) {
+            const ret = arg0 == arg1;
+            return ret;
+        },
+        __wbg___wbindgen_number_get_136b9679cab35cfb: function(arg0, arg1) {
+            const obj = arg1;
+            const ret = typeof(obj) === 'number' ? obj : undefined;
+            getDataViewMemory0().setFloat64(arg0 + 8 * 1, isLikeNone(ret) ? 0 : ret, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
+        },
+        __wbg___wbindgen_string_get_d154f1e671052120: function(arg0, arg1) {
+            const obj = arg1;
+            const ret = typeof(obj) === 'string' ? obj : undefined;
+            var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            var len1 = WASM_VECTOR_LEN;
+            getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+        },
+        __wbg___wbindgen_throw_bb96b2010945f0bc: function(arg0, arg1) {
+            throw new Error(getStringFromWasm0(arg0, arg1));
+        },
+        __wbg_call_1c5886ab9c57d1c7: function() { return handleError(function (arg0, arg1) {
+            const ret = arg0.call(arg1);
+            return ret;
+        }, arguments); },
+        __wbg_done_669171204c3dcae2: function(arg0) {
+            const ret = arg0.done;
+            return ret;
+        },
+        __wbg_entries_7774d489e1da5f4f: function(arg0) {
+            const ret = Object.entries(arg0);
+            return ret;
+        },
+        __wbg_get_c0c8f8d7da0c03dd: function(arg0, arg1) {
+            const ret = arg0[arg1 >>> 0];
+            return ret;
+        },
+        __wbg_get_d173c0308df22d37: function() { return handleError(function (arg0, arg1) {
+            const ret = Reflect.get(arg0, arg1);
+            return ret;
+        }, arguments); },
+        __wbg_get_unchecked_e20b893aeafc3fca: function(arg0, arg1) {
+            const ret = arg0[arg1 >>> 0];
+            return ret;
+        },
+        __wbg_instanceof_ArrayBuffer_993d02d2d254cad1: function(arg0) {
+            let result;
+            try {
+                result = arg0 instanceof ArrayBuffer;
+            } catch (_) {
+                result = false;
+            }
+            const ret = result;
+            return ret;
+        },
+        __wbg_instanceof_Map_9a4d6ead180ae3a9: function(arg0) {
+            let result;
+            try {
+                result = arg0 instanceof Map;
+            } catch (_) {
+                result = false;
+            }
+            const ret = result;
+            return ret;
+        },
+        __wbg_instanceof_Uint8Array_f935dbb0aa7cdeed: function(arg0) {
+            let result;
+            try {
+                result = arg0 instanceof Uint8Array;
+            } catch (_) {
+                result = false;
+            }
+            const ret = result;
+            return ret;
+        },
+        __wbg_isArray_6339f732981044bf: function(arg0) {
+            const ret = Array.isArray(arg0);
+            return ret;
+        },
+        __wbg_isSafeInteger_f3d6cd19ccfe4512: function(arg0) {
+            const ret = Number.isSafeInteger(arg0);
+            return ret;
+        },
+        __wbg_iterator_5cebbb86e33c6dd6: function() {
+            const ret = Symbol.iterator;
+            return ret;
+        },
+        __wbg_length_36bd29c6848c2144: function(arg0) {
+            const ret = arg0.length;
+            return ret;
+        },
+        __wbg_length_ecfa2c63d3d0d82c: function(arg0) {
+            const ret = arg0.length;
+            return ret;
+        },
+        __wbg_new_116be93542d39019: function() {
+            const ret = new Array();
+            return ret;
+        },
+        __wbg_new_358857d90afd5a2d: function(arg0, arg1) {
+            const ret = new Error(getStringFromWasm0(arg0, arg1));
+            return ret;
+        },
+        __wbg_new_77cc4f4f472aeb81: function(arg0) {
+            const ret = new Uint8Array(arg0);
+            return ret;
+        },
+        __wbg_new_cdf041679ded4c5f: function() {
+            const ret = new Map();
+            return ret;
+        },
+        __wbg_new_ebe3e0f6837f0879: function() {
+            const ret = new Object();
+            return ret;
+        },
+        __wbg_next_42cf16ee0dafc9e2: function() { return handleError(function (arg0) {
+            const ret = arg0.next();
+            return ret;
+        }, arguments); },
+        __wbg_next_8f26b64fa5e9f64b: function(arg0) {
+            const ret = arg0.next;
+            return ret;
+        },
+        __wbg_of_598c0ff0cd48a890: function(arg0, arg1) {
+            const ret = Array.of(arg0, arg1);
+            return ret;
+        },
+        __wbg_prototypesetcall_de8e0d9553586985: function(arg0, arg1, arg2) {
+            Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
+        },
+        __wbg_push_adb0107829f02d75: function(arg0, arg1) {
+            const ret = arg0.push(arg1);
+            return ret;
+        },
+        __wbg_set_014226dfeca53178: function(arg0, arg1, arg2) {
+            const ret = arg0.set(arg1, arg2);
+            return ret;
+        },
+        __wbg_set_6be42768c690e380: function(arg0, arg1, arg2) {
+            arg0[arg1] = arg2;
+        },
+        __wbg_set_8155bb79a948541b: function() { return handleError(function (arg0, arg1, arg2) {
+            const ret = Reflect.set(arg0, arg1, arg2);
+            return ret;
+        }, arguments); },
+        __wbg_set_a80955eb93b145c6: function(arg0, arg1, arg2) {
+            arg0[arg1 >>> 0] = arg2;
+        },
+        __wbg_value_1e2369fab29b420e: function(arg0) {
+            const ret = arg0.value;
+            return ret;
+        },
+        __wbindgen_cast_0000000000000001: function(arg0) {
+            // Cast intrinsic for `F64 -> Externref`.
+            const ret = arg0;
+            return ret;
+        },
+        __wbindgen_cast_0000000000000002: function(arg0) {
+            // Cast intrinsic for `I64 -> Externref`.
+            const ret = arg0;
+            return ret;
+        },
+        __wbindgen_cast_0000000000000003: function(arg0, arg1) {
+            // Cast intrinsic for `Ref(String) -> Externref`.
+            const ret = getStringFromWasm0(arg0, arg1);
+            return ret;
+        },
+        __wbindgen_cast_0000000000000004: function(arg0) {
+            // Cast intrinsic for `U64 -> Externref`.
+            const ret = BigInt.asUintN(64, arg0);
+            return ret;
+        },
+        __wbindgen_init_externref_table: function() {
+            const table = wasm.__wbindgen_externrefs;
+            const offset = table.grow(4);
+            table.set(0, undefined);
+            table.set(offset + 0, undefined);
+            table.set(offset + 1, null);
+            table.set(offset + 2, true);
+            table.set(offset + 3, false);
+        },
+    };
+    return {
+        __proto__: null,
+        "./bandcore_bg.js": import0,
+    };
+}
+
+const ClaimRegistryFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_claimregistry_free(ptr, 1));
+const ParticipantRosterFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_participantroster_free(ptr, 1));
+const RetryTrackerFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_retrytracker_free(ptr, 1));
+
+function addToExternrefTable0(obj) {
+    const idx = wasm.__externref_table_alloc();
+    wasm.__wbindgen_externrefs.set(idx, obj);
+    return idx;
+}
+
+function debugString(val) {
+    // primitive types
+    const type = typeof val;
+    if (type == 'number' || type == 'boolean' || val == null) {
+        return  `${val}`;
+    }
+    if (type == 'string') {
+        return `"${val}"`;
+    }
+    if (type == 'symbol') {
+        const description = val.description;
+        if (description == null) {
+            return 'Symbol';
+        } else {
+            return `Symbol(${description})`;
+        }
+    }
+    if (type == 'function') {
+        const name = val.name;
+        if (typeof name == 'string' && name.length > 0) {
+            return `Function(${name})`;
+        } else {
+            return 'Function';
+        }
+    }
+    // objects
+    if (Array.isArray(val)) {
+        const length = val.length;
+        let debug = '[';
+        if (length > 0) {
+            debug += debugString(val[0]);
+        }
+        for(let i = 1; i < length; i++) {
+            debug += ', ' + debugString(val[i]);
+        }
+        debug += ']';
+        return debug;
+    }
+    // Test for built-in
+    const builtInMatches = /\[object ([^\]]+)\]/.exec(toString.call(val));
+    let className;
+    if (builtInMatches && builtInMatches.length > 1) {
+        className = builtInMatches[1];
+    } else {
+        // Failed to match the standard '[object ClassName]'
+        return toString.call(val);
+    }
+    if (className == 'Object') {
+        // we're a user defined class or Object
+        // JSON.stringify avoids problems with cycles, and is generally much
+        // easier than looping through ownProperties of `val`.
+        try {
+            return 'Object(' + JSON.stringify(val) + ')';
+        } catch (_) {
+            return 'Object';
+        }
+    }
+    // errors
+    if (val instanceof Error) {
+        return `${val.name}: ${val.message}\n${val.stack}`;
+    }
+    // TODO we could test for more things here, like `Set`s and `Map`s.
+    return className;
+}
+
+function getArrayJsValueFromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    const mem = getDataViewMemory0();
+    const result = [];
+    for (let i = ptr; i < ptr + 4 * len; i += 4) {
+        result.push(wasm.__wbindgen_externrefs.get(mem.getUint32(i, true)));
+    }
+    wasm.__externref_drop_slice(ptr, len);
+    return result;
+}
+
+function getArrayU8FromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
+}
+
+let cachedDataViewMemory0 = null;
+function getDataViewMemory0() {
+    if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
+        cachedDataViewMemory0 = new DataView(wasm.memory.buffer);
+    }
+    return cachedDataViewMemory0;
+}
+
+function getStringFromWasm0(ptr, len) {
+    return decodeText(ptr >>> 0, len);
+}
+
+let cachedUint8ArrayMemory0 = null;
+function getUint8ArrayMemory0() {
+    if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
+        cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);
+    }
+    return cachedUint8ArrayMemory0;
+}
+
+function handleError(f, args) {
+    try {
+        return f.apply(this, args);
+    } catch (e) {
+        const idx = addToExternrefTable0(e);
+        wasm.__wbindgen_exn_store(idx);
+    }
+}
+
+function isLikeNone(x) {
+    return x === undefined || x === null;
+}
+
+function passStringToWasm0(arg, malloc, realloc) {
+    if (realloc === undefined) {
+        const buf = cachedTextEncoder.encode(arg);
+        const ptr = malloc(buf.length, 1) >>> 0;
+        getUint8ArrayMemory0().subarray(ptr, ptr + buf.length).set(buf);
+        WASM_VECTOR_LEN = buf.length;
+        return ptr;
+    }
+
+    let len = arg.length;
+    let ptr = malloc(len, 1) >>> 0;
+
+    const mem = getUint8ArrayMemory0();
+
+    let offset = 0;
+
+    for (; offset < len; offset++) {
+        const code = arg.charCodeAt(offset);
+        if (code > 0x7F) break;
+        mem[ptr + offset] = code;
+    }
+    if (offset !== len) {
+        if (offset !== 0) {
+            arg = arg.slice(offset);
+        }
+        ptr = realloc(ptr, len, len = offset + arg.length * 3, 1) >>> 0;
+        const view = getUint8ArrayMemory0().subarray(ptr + offset, ptr + len);
+        const ret = cachedTextEncoder.encodeInto(arg, view);
+
+        offset += ret.written;
+        ptr = realloc(ptr, len, offset, 1) >>> 0;
+    }
+
+    WASM_VECTOR_LEN = offset;
+    return ptr;
+}
+
+function takeFromExternrefTable0(idx) {
+    const value = wasm.__wbindgen_externrefs.get(idx);
+    wasm.__externref_table_dealloc(idx);
+    return value;
+}
+
+let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+cachedTextDecoder.decode();
+function decodeText(ptr, len) {
+    return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
+}
+
+const cachedTextEncoder = new TextEncoder();
+
+if (!('encodeInto' in cachedTextEncoder)) {
+    cachedTextEncoder.encodeInto = function (arg, view) {
+        const buf = cachedTextEncoder.encode(arg);
+        view.set(buf);
+        return {
+            read: arg.length,
+            written: buf.length
+        };
+    };
+}
+
+let WASM_VECTOR_LEN = 0;
+
+const wasmPath = `${__dirname}/bandcore_bg.wasm`;
+const wasmBytes = require('fs').readFileSync(wasmPath);
+const wasmModule = new WebAssembly.Module(wasmBytes);
+let wasmInstance = new WebAssembly.Instance(wasmModule, __wbg_get_imports());
+let wasm = wasmInstance.exports;
+wasm.__wbindgen_start();

package/index.d.ts

@@ -0,0 +1,147 @@
+/** Canonical inbound wire-event names `validateEventPayload` accepts. */
+export type EventType =
+  | "message_created"
+  | "message_updated"
+  | "room_added"
+  | "room_removed"
+  | "room_deleted"
+  | "participant_added"
+  | "participant_removed"
+  | "contact_request_received"
+  | "contact_request_updated"
+  | "contact_added"
+  | "contact_removed"
+  | "supersede"
+  | "agent.control"
+  | "event_created";
+
+export interface ValidationIssue {
+  path: string;
+  code: "missing" | "wrong_type" | "invalid_value";
+  message: string;
+}
+
+/**
+ * Validates and normalizes an inbound platform event payload.
+ *
+ * On failure throws a native `Error` with `.issues` (an array of
+ * `{path, code, message}` objects) and `.traceContext`. A non-string
+ * `eventType` or `traceContext` throws a plain `Error` without `.issues`.
+ */
+export function validateEventPayload(
+  eventType: string,
+  raw: unknown,
+  traceContext?: string | null,
+): unknown;
+
+/** Memory tier; constrains which `type` values are valid for it. */
+export type MemorySystem = "sensory" | "working" | "long_term";
+
+/** Content kind; must match the chosen {@link MemorySystem} tier. */
+export type MemoryType =
+  | "iconic"
+  | "echoic"
+  | "haptic"
+  | "episodic"
+  | "semantic"
+  | "procedural";
+
+/**
+ * Validates that `type` belongs to `system`'s allowed type set.
+ *
+ * On failure throws a native `Error` with `.issues` (an array of
+ * `{path, code, message}` objects) and `.traceContext`. An unrecognized
+ * `system` and an unrecognized `type` are independent issues and both are
+ * reported when both strings are invalid. A non-string `system`, `type`,
+ * or `traceContext` throws a plain `Error` without `.issues`.
+ */
+export function validateMemoryTypeForSystem(
+  system: string,
+  type: string,
+  traceContext?: string | null,
+): void;
+
+/** A roster entry read by `ParticipantRoster`; every other key is ignored. */
+export interface ParticipantFields {
+  id: string;
+  name?: string | null;
+  type?: string | null;
+  handle?: string | null;
+  description?: string | null;
+}
+
+/**
+ * Ownership ledger for the inbound message-delivery lifecycle: in-flight,
+ * ack-pending, and completed states, each scoped by `(roomId, messageId)`.
+ *
+ * Throws if `maxCompleted` is not a non-negative integer in range, or is
+ * `0` -- a zero capacity would evict every completed entry the instant it
+ * is recorded. Every `roomId`/`messageId` argument below throws a plain
+ * `Error` if it is not a string.
+ */
+export class ClaimRegistry {
+  constructor(maxCompleted?: number);
+  readonly maxCompleted: number;
+  tryClaim(roomId: string, messageId: string): boolean;
+  release(roomId: string, messageId: string): void;
+  inflightIds(roomId: string): string[];
+  isCompleted(roomId: string, messageId: string): boolean;
+  completedIds(roomId: string): string[];
+  discardCompleted(roomId: string): void;
+  rememberCompleted(roomId: string, messageId: string): void;
+  isAckPending(roomId: string, messageId: string): boolean;
+  rememberAckPending(roomId: string, messageId: string): void;
+  pendingAckIds(roomId: string): string[];
+  recordAckRetry(roomId: string, messageId: string): number;
+}
+
+/**
+ * Per-message retry budget: bounded attempt/failure tracking plus
+ * `discardAttempt` for a cycle the caller's own control signal aborted
+ * before it ran the handler.
+ *
+ * Throws if `maxRetries` or `maxTracked` is not a non-negative integer in
+ * range, or if `maxTracked` is `0` -- a zero capacity would evict every
+ * attempt the instant it is recorded. Every `messageId` argument below
+ * throws a plain `Error` if it is not a string.
+ */
+export class RetryTracker {
+  constructor(maxRetries?: number, maxTracked?: number);
+  readonly maxRetries: number;
+  /**
+   * Bounded at maxTracked distinct IDs, oldest-first -- a message can stop
+   * reporting permanently failed once enough newer IDs have failed too.
+   */
+  isPermanentlyFailed(messageId: string): boolean;
+  /** Returns `[attemptCount, exceeded]`. */
+  recordAttempt(messageId: string): [number, boolean];
+  markSuccess(messageId: string): void;
+  discardAttempt(messageId: string): void;
+  markPermanentlyFailed(messageId: string): void;
+}
+
+/**
+ * The always-injected passive participant roster. `add`/`setAll` read only
+ * `id`, `name`, `type`, `handle`, `description` from each participant --
+ * every other key is dropped.
+ */
+export class ParticipantRoster {
+  constructor();
+  /**
+   * Throws a native `Error` if `participant` is not a plain object, its
+   * `id` is missing/not a string, or another tracked field is not a
+   * string or `null`.
+   */
+  add(participant: ParticipantFields): boolean;
+  /** Throws a plain `Error` if `participantId` is not a string. */
+  remove(participantId: string): boolean;
+  /**
+   * Throws a native `Error` with `.issues` and `.traceContext`, leaving the
+   * roster unchanged, if `participants` names an id twice. Throws a plain
+   * `Error` without `.issues` if `traceContext` is not a string or `null`.
+   */
+  setAll(participants: ParticipantFields[], traceContext?: string | null): void;
+  list(): ParticipantFields[];
+  changed(): boolean;
+  markSent(): void;
+}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@band-ai/band-sdk-core",
+  "version": "0.0.0-dev.0",
+  "description": "Shared Band event-payload validation",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/band-ai/band-sdk-core"
+  },
+  "files": [
+    "bandcore.js",
+    "bandcore_bg.wasm",
+    "index.d.ts"
+  ],
+  "main": "./bandcore.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./bandcore.js"
+    }
+  }
+}