@tribe-nest/media-client 0.1.0

package/build/core/signal.js

@@ -0,0 +1,416 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MediaSignal = void 0;
+exports.assertTokenNotInUrl = assertTokenNotInUrl;
+exports.causeFromError = causeFromError;
+const media_protocol_1 = require("@tribe-nest/media-protocol");
+const socket_1 = require("./socket");
+const DEFAULT_REQUEST_TIMEOUT_MS = 10_000;
+const DEFAULT_JOIN_TIMEOUT_MS = 10_000;
+/**
+ * A join ticket in a URL is a join ticket in every access log between the
+ * client and the node, and load balancers log query strings by default. The
+ * contract puts the token in the first frame; this refuses a URL that looks
+ * like someone routed around that.
+ */
+function assertTokenNotInUrl(mediaUrl) {
+    let url;
+    try {
+        url = new URL(mediaUrl);
+    }
+    catch {
+        throw new Error(`mediaUrl is not a URL: ${mediaUrl}`);
+    }
+    for (const key of url.searchParams.keys()) {
+        if (/token|jwt|ticket|auth/i.test(key)) {
+            throw new Error(`refusing to connect: mediaUrl carries "${key}" in the query string. The token goes in the first frame.`);
+        }
+    }
+}
+/** Maps a thrown error back to the cause the reconnect policy decides on. */
+function causeFromError(error) {
+    if (error instanceof media_protocol_1.MediaError) {
+        return { type: "refused", code: error.code, message: error.message };
+    }
+    return { type: "socket_closed", reason: error instanceof Error ? error.message : String(error) };
+}
+class MediaSignal {
+    options;
+    socket = null;
+    nextId = 0;
+    pending = new Map();
+    handlers = new Map();
+    anyHandlers = new Set();
+    closeHandlers = new Set();
+    /** Set by the events that explain a close BEFORE the socket goes away. */
+    terminalCause = null;
+    phaseValue = "idle";
+    identityValue = null;
+    joinedResolve = null;
+    connectReject = null;
+    /**
+     * Which connection attempt is the current one.
+     *
+     * `connect()` awaits `getCredentials()` before it has a socket, and until that
+     * socket exists there is nothing for `close()` to close: it flips the phase
+     * and returns. So the attempt is stamped and re-checked, and an attempt that
+     * is no longer the current one abandons itself instead of opening a socket
+     * and JOINING with a live token that nothing then holds a reference to.
+     */
+    attempt = 0;
+    boundClose = null;
+    constructor(options) {
+        this.options = options;
+    }
+    get phase() {
+        return this.phaseValue;
+    }
+    /** Our own identity, as the node reported it in `joined`. */
+    get identity() {
+        return this.identityValue;
+    }
+    /**
+     * Opens the socket, sends `join` as the first frame, and resolves once BOTH
+     * the join reply and the `joined` event have arrived.
+     *
+     * Waiting for both is deliberate. The reply says the node accepted the token;
+     * the event carries `routerRtpCapabilities`, the peer snapshot and the
+     * recording flag. A caller that resolved on the reply alone would be handed a
+     * room it knows nothing about, and the contract fixes no order between the
+     * two frames, so neither may be assumed to arrive first.
+     */
+    async connect() {
+        if (this.phaseValue === "connecting" || this.phaseValue === "joining" || this.phaseValue === "joined") {
+            throw new Error("connect() called on a signal that is already connecting or connected");
+        }
+        this.resetForConnect();
+        const attempt = ++this.attempt;
+        this.phaseValue = "connecting";
+        const credentials = await this.options.getCredentials();
+        // Fetching a ticket is a network round trip of its own, so this window is
+        // seconds wide and a caller giving up inside it is ordinary. Every later
+        // step has a socket and is cancelled by `handleClose`; this one is the only
+        // part of a connect that a `close()` could not reach.
+        this.assertAttemptIsCurrent(attempt);
+        assertTokenNotInUrl(credentials.mediaUrl);
+        const factory = this.options.webSocket ?? socket_1.defaultWebSocketFactory;
+        const socket = factory(credentials.mediaUrl);
+        this.socket = socket;
+        this.bind(socket);
+        try {
+            await this.waitForOpen(socket);
+            this.phaseValue = "joining";
+            const joined = await this.performJoin(credentials.token);
+            this.phaseValue = "joined";
+            this.identityValue = joined.identity;
+            return joined;
+        }
+        catch (error) {
+            // A failed handshake leaves nothing worth keeping open, and the cause is
+            // recorded first so close handlers see the refusal rather than a bare
+            // socket close.
+            if (!this.terminalCause)
+                this.terminalCause = causeFromError(error);
+            this.closeSocket();
+            throw error;
+        }
+    }
+    /**
+     * Sends a request and resolves with its `data`.
+     *
+     * `unknown`, not a guessed shape: the wire declares `data: unknown` because
+     * most of it is mediasoup's, and a client that pretends otherwise is asserting
+     * a contract this package does not hold.
+     */
+    request(frame, timeoutMs) {
+        const socket = this.socket;
+        if (!socket || this.phaseValue === "closed" || this.phaseValue === "idle") {
+            return Promise.reject(new media_protocol_1.MediaError("internal", `cannot send ${frame.method}: the signal connection is ${this.phaseValue}`));
+        }
+        const id = this.nextId++;
+        const promise = this.track(id, frame.method, timeoutMs ?? this.options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS);
+        try {
+            this.send({ ...frame, id });
+        }
+        catch (error) {
+            // A socket that died between the check and the send must reject this
+            // call, not throw past a `.catch()` the caller reasonably attached.
+            this.settle(id, error);
+        }
+        return promise;
+    }
+    /**
+     * Best-effort `leave` then close.
+     *
+     * Best-effort because the node tears the session down on socket close anyway.
+     * A leave that hangs must not stop a user closing a tab.
+     */
+    async leave() {
+        if (this.phaseValue === "joined") {
+            try {
+                await this.request({ method: "leave" });
+            }
+            catch (error) {
+                this.log("debug", "leave was not acknowledged; closing anyway", error);
+            }
+        }
+        this.close();
+    }
+    /** Closes the socket. Idempotent. */
+    close() {
+        if (!this.terminalCause)
+            this.terminalCause = { type: "closed_by_client" };
+        this.closeSocket();
+    }
+    on(event, handler) {
+        const set = this.handlers.get(event) ?? new Set();
+        const erased = handler;
+        set.add(erased);
+        this.handlers.set(event, set);
+        return () => {
+            set.delete(erased);
+        };
+    }
+    /** Every event, in arrival order. This is what the state reducer is fed. */
+    onAny(handler) {
+        this.anyHandlers.add(handler);
+        return () => {
+            this.anyHandlers.delete(handler);
+        };
+    }
+    onClose(handler) {
+        this.closeHandlers.add(handler);
+        return () => {
+            this.closeHandlers.delete(handler);
+        };
+    }
+    // ---------------------------------------------------------------- internals
+    /**
+     * Throws when this attempt has been overtaken: either `close()` ran, or a
+     * second `connect()` started (which the entry guard permits once the phase is
+     * `closed`, so an abandoned attempt must not go on to open a second socket).
+     */
+    assertAttemptIsCurrent(attempt) {
+        if (attempt === this.attempt && this.phaseValue !== "closed")
+            return;
+        throw new media_protocol_1.MediaError("internal", "connect() was abandoned: the connection was closed before the socket was opened");
+    }
+    resetForConnect() {
+        this.terminalCause = null;
+        this.identityValue = null;
+        this.joinedResolve = null;
+        this.connectReject = null;
+        this.pending.clear();
+        this.nextId = 0;
+    }
+    bind(socket) {
+        socket.addEventListener("message", (event) => this.handleMessage(event.data));
+        socket.addEventListener("error", (event) => this.log("warn", "signal socket error", event.error));
+        const onClose = (event) => this.handleClose(event);
+        this.boundClose = onClose;
+        socket.addEventListener("close", onClose);
+    }
+    waitForOpen(socket) {
+        if (socket.readyState === socket_1.SOCKET_OPEN)
+            return Promise.resolve();
+        return new Promise((resolve, reject) => {
+            this.connectReject = reject;
+            const onOpen = () => {
+                socket.removeEventListener("open", onOpen);
+                this.connectReject = null;
+                resolve();
+            };
+            socket.addEventListener("open", onOpen);
+        });
+    }
+    async performJoin(token) {
+        const id = this.nextId++;
+        const timeoutMs = this.options.joinTimeoutMs ?? DEFAULT_JOIN_TIMEOUT_MS;
+        const reply = this.track(id, "join", timeoutMs);
+        const joined = new Promise((resolve, reject) => {
+            this.joinedResolve = resolve;
+            // The same rejection path as the reply: a socket that dies mid-handshake
+            // must not leave `connect()` hanging until the join timeout.
+            const previous = this.connectReject;
+            this.connectReject = (error) => {
+                previous?.(error);
+                reject(error);
+            };
+        });
+        this.send({
+            method: "join",
+            id,
+            protocolVersion: this.options.protocolVersion ?? media_protocol_1.MEDIA_PROTOCOL_VERSION,
+            token,
+        });
+        const [, joinedFrame] = await Promise.all([reply, this.withDeadline(joined, timeoutMs, "joined")]);
+        return joinedFrame;
+    }
+    withDeadline(promise, ms, what) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                // No `timeout` code exists in the frozen error union, so this reports
+                // `internal` and says what timed out in the message.
+                reject(new media_protocol_1.MediaError("internal", `timed out waiting for ${what} after ${ms}ms`));
+            }, ms);
+            promise.then((value) => {
+                clearTimeout(timer);
+                resolve(value);
+            }, (error) => {
+                clearTimeout(timer);
+                reject(error);
+            });
+        });
+    }
+    track(id, method, timeoutMs) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new media_protocol_1.MediaError("internal", `no reply to ${method} (id ${id}) after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this.pending.set(id, { resolve, reject, timer, method });
+        });
+    }
+    settle(id, error) {
+        const pending = this.pending.get(id);
+        if (!pending)
+            return;
+        this.pending.delete(id);
+        if (pending.timer)
+            clearTimeout(pending.timer);
+        pending.reject(error);
+    }
+    send(frame) {
+        const socket = this.socket;
+        if (!socket)
+            throw new media_protocol_1.MediaError("internal", "no socket");
+        socket.send(JSON.stringify(frame));
+    }
+    handleMessage(data) {
+        const text = toText(data);
+        if (text === null) {
+            this.log("warn", "dropping a non-text signal frame");
+            return;
+        }
+        let raw;
+        try {
+            raw = JSON.parse(text);
+        }
+        catch {
+            this.log("warn", "dropping an unparseable signal frame");
+            return;
+        }
+        const parsed = media_protocol_1.serverFrameSchema.safeParse(raw);
+        if (!parsed.success) {
+            // Dropped, not thrown: a node that gains a frame in a later protocol
+            // version must not kill an older client's live call. A real mismatch is
+            // caught by the version handshake, loudly, at join.
+            this.log("warn", "dropping a frame that does not match the protocol", raw);
+            return;
+        }
+        this.dispatch(parsed.data);
+    }
+    dispatch(frame) {
+        if ((0, media_protocol_1.isEvent)(frame)) {
+            this.handleEvent(frame);
+            return;
+        }
+        const pending = this.pending.get(frame.id);
+        if (!pending) {
+            // Either a second reply to one id or a reply to a request that already
+            // timed out. Both are protocol violations by the node, so they are said
+            // out loud rather than absorbed.
+            this.log("warn", `reply for unknown request id ${frame.id}`, frame);
+            return;
+        }
+        this.pending.delete(frame.id);
+        if (pending.timer)
+            clearTimeout(pending.timer);
+        if (frame.ok) {
+            pending.resolve(frame.data);
+        }
+        else {
+            pending.reject(new media_protocol_1.MediaError(frame.code, frame.message ?? `${pending.method} refused: ${frame.code}`));
+        }
+    }
+    handleEvent(frame) {
+        switch (frame.event) {
+            case "joined":
+                this.identityValue = frame.identity;
+                this.joinedResolve?.(frame);
+                this.joinedResolve = null;
+                break;
+            case "draining":
+                // Recorded now because the node closes the socket next, and by then the
+                // reason is gone. Reconnecting to this node is precisely wrong.
+                this.terminalCause = { type: "draining", reconnectAfterMs: frame.reconnectAfterMs };
+                break;
+            case "roomClosed":
+                this.terminalCause = { type: "room_closed", reason: frame.reason };
+                break;
+            default:
+                break;
+        }
+        for (const handler of this.handlers.get(frame.event) ?? [])
+            handler(frame);
+        for (const handler of this.anyHandlers)
+            handler(frame);
+    }
+    handleClose(event) {
+        if (this.phaseValue === "closed")
+            return;
+        this.phaseValue = "closed";
+        const cause = this.terminalCause ?? {
+            type: "socket_closed",
+            ...(event.code === undefined ? {} : { code: event.code }),
+            ...(event.reason === undefined ? {} : { reason: event.reason }),
+        };
+        const closedError = new media_protocol_1.MediaError("internal", `signal connection closed before a reply arrived (${cause.type})`);
+        for (const [, pending] of this.pending) {
+            if (pending.timer)
+                clearTimeout(pending.timer);
+            pending.reject(closedError);
+        }
+        this.pending.clear();
+        this.connectReject?.(closedError);
+        this.connectReject = null;
+        this.joinedResolve = null;
+        for (const handler of this.closeHandlers)
+            handler(cause);
+    }
+    closeSocket() {
+        const socket = this.socket;
+        if (!socket) {
+            // Nothing was ever opened, so no close event will arrive to settle
+            // pending work. Settle it here.
+            if (this.phaseValue !== "closed")
+                this.handleClose({});
+            return;
+        }
+        this.socket = null;
+        try {
+            socket.close(1000, "client");
+        }
+        catch (error) {
+            this.log("debug", "socket.close threw", error);
+        }
+        if (this.boundClose)
+            socket.removeEventListener("close", this.boundClose);
+        this.boundClose = null;
+        this.handleClose({ code: 1000 });
+    }
+    log(level, message, detail) {
+        this.options.onLog?.(level, message, detail);
+    }
+}
+exports.MediaSignal = MediaSignal;
+function toText(data) {
+    if (typeof data === "string")
+        return data;
+    if (data instanceof Uint8Array)
+        return new TextDecoder().decode(data);
+    if (data instanceof ArrayBuffer)
+        return new TextDecoder().decode(new Uint8Array(data));
+    return null;
+}
+//# sourceMappingURL=signal.js.map

package/build/core/signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.js","sourceRoot":"","sources":["../../src/core/signal.ts"],"names":[],"mappings":"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"}

package/build/core/socket.d.ts

@@ -0,0 +1,57 @@
+/**
+ * The one WebSocket shape `core/` knows about.
+ *
+ * Four hosts have to drive this client and no two of them have the same socket:
+ * a browser has the DOM one, Node 24 has a global `WebSocket`, older Node
+ * services carry `ws`, and the load harness may want a socket that lies about
+ * latency. Rather than branch on the environment, `core/` takes a factory and
+ * never constructs anything itself.
+ *
+ * The listener style is `addEventListener`, because that is the intersection:
+ * the browser, Node's global and the `ws` package all provide it, while only
+ * `ws` provides `.on()`.
+ */
+export declare const SOCKET_CONNECTING = 0;
+export declare const SOCKET_OPEN = 1;
+export declare const SOCKET_CLOSING = 2;
+export declare const SOCKET_CLOSED = 3;
+export type SocketOpenEvent = {
+    type: "open";
+};
+export type SocketMessageEvent = {
+    type: "message";
+    data: unknown;
+};
+export type SocketErrorEvent = {
+    type: "error";
+    error?: unknown;
+};
+export type SocketCloseEvent = {
+    type: "close";
+    code?: number;
+    reason?: string;
+};
+export type SocketEventMap = {
+    open: SocketOpenEvent;
+    message: SocketMessageEvent;
+    error: SocketErrorEvent;
+    close: SocketCloseEvent;
+};
+export interface WebSocketLike {
+    readonly readyState: number;
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+    addEventListener<K extends keyof SocketEventMap>(type: K, listener: (event: SocketEventMap[K]) => void): void;
+    removeEventListener<K extends keyof SocketEventMap>(type: K, listener: (event: SocketEventMap[K]) => void): void;
+}
+export type MediaWebSocketFactory = (url: string) => WebSocketLike;
+/**
+ * Resolves `globalThis.WebSocket` at CALL time, never at module load.
+ *
+ * Reading it at module scope would make importing this package fail outright in
+ * a host that has no global socket but was going to pass its own factory, and
+ * "importing a type broke my service" is the class of problem the isomorphic
+ * split exists to prevent.
+ */
+export declare function defaultWebSocketFactory(url: string): WebSocketLike;
+//# sourceMappingURL=socket.d.ts.map

package/build/core/socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../src/core/socket.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,MAAM,MAAM,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/C,MAAM,MAAM,kBAAkB,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAClE,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,EAAE,gBAAgB,CAAC;CACzB,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,gBAAgB,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;IAC9G,mBAAmB,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;CAClH;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,aAAa,CAAC;AAEnE;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAQlE"}

package/build/core/socket.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * The one WebSocket shape `core/` knows about.
+ *
+ * Four hosts have to drive this client and no two of them have the same socket:
+ * a browser has the DOM one, Node 24 has a global `WebSocket`, older Node
+ * services carry `ws`, and the load harness may want a socket that lies about
+ * latency. Rather than branch on the environment, `core/` takes a factory and
+ * never constructs anything itself.
+ *
+ * The listener style is `addEventListener`, because that is the intersection:
+ * the browser, Node's global and the `ws` package all provide it, while only
+ * `ws` provides `.on()`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SOCKET_CLOSED = exports.SOCKET_CLOSING = exports.SOCKET_OPEN = exports.SOCKET_CONNECTING = void 0;
+exports.defaultWebSocketFactory = defaultWebSocketFactory;
+exports.SOCKET_CONNECTING = 0;
+exports.SOCKET_OPEN = 1;
+exports.SOCKET_CLOSING = 2;
+exports.SOCKET_CLOSED = 3;
+/**
+ * Resolves `globalThis.WebSocket` at CALL time, never at module load.
+ *
+ * Reading it at module scope would make importing this package fail outright in
+ * a host that has no global socket but was going to pass its own factory, and
+ * "importing a type broke my service" is the class of problem the isomorphic
+ * split exists to prevent.
+ */
+function defaultWebSocketFactory(url) {
+    const ctor = globalThis.WebSocket;
+    if (!ctor) {
+        throw new Error("no global WebSocket in this runtime. Pass `webSocket: (url) => new WS(url)` to the signal client.");
+    }
+    return new ctor(url);
+}
+//# sourceMappingURL=socket.js.map

package/build/core/socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.js","sourceRoot":"","sources":["../../src/core/socket.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAqCH,0DAQC;AA3CY,QAAA,iBAAiB,GAAG,CAAC,CAAC;AACtB,QAAA,WAAW,GAAG,CAAC,CAAC;AAChB,QAAA,cAAc,GAAG,CAAC,CAAC;AACnB,QAAA,aAAa,GAAG,CAAC,CAAC;AAwB/B;;;;;;;GAOG;AACH,SAAgB,uBAAuB,CAAC,GAAW;IACjD,MAAM,IAAI,GAAI,UAA2D,CAAC,SAAS,CAAC;IACpF,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,mGAAmG,CACpG,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,IAAI,CAAC,GAAG,CAA6B,CAAC;AACnD,CAAC"}

package/build/core/state.d.ts

@@ -0,0 +1,67 @@
+import { type EventFrame, type Peer, type SubscribeRule } from "@tribe-nest/media-protocol";
+/**
+ * The room as the event frames describe it, as a pure reducer.
+ *
+ * Pure because this is the part that is worth testing exhaustively and the part
+ * a socket makes untestable. Every ordering that matters (a peer leaving before
+ * its producers close, an active-speaker set naming a producer that has just
+ * gone, a rule narrowing mid-call) is a two-line test here and a flaky
+ * integration run anywhere else.
+ *
+ * It holds no tracks, no consumers and no mediasoup objects. Those belong to
+ * P3b's room API, keyed by the `producerId` this state carries.
+ */
+export type ProducerEntry = {
+    producerId: string;
+    identity: string;
+    kind: "audio" | "video";
+    paused: boolean;
+};
+export type RoomState = {
+    phase: "idle" | "joined" | "closed";
+    /** Our own identity, as the node reported it. */
+    identity: string | null;
+    room: string | null;
+    /** In arrival order, which is the only order the wire gives. */
+    peers: readonly Peer[];
+    /**
+     * EVERY producer the node has announced, whether or not the current
+     * subscribe rule permits it. Visibility is derived by `visibleProducers`;
+     * see the note on `subscribeRuleChanged` for why this is not pruned.
+     */
+    producers: readonly ProducerEntry[];
+    /** The set the NODE decided we should consume, in its order. */
+    activeSpeakers: readonly string[];
+    /** True while any `kind: "egress"` participant is present. A consent flag. */
+    recording: boolean;
+    /** The latest rule pushed for us, if one ever was. */
+    subscribeRule: SubscribeRule | null;
+    /** Set by `draining`, cleared by the next `joined`. */
+    draining: {
+        reconnectAfterMs: number;
+    } | null;
+    closedReason: string | null;
+};
+export declare const initialRoomState: RoomState;
+/**
+ * Apply one event frame.
+ *
+ * Never throws and never mutates. An event it does not recognise returns the
+ * SAME reference, so a caller can use identity to skip a re-render.
+ */
+export declare function reduceRoomState(state: RoomState, frame: EventFrame): RoomState;
+/** Convenience for a caller feeding a stream of frames, e.g. `signal.onAny`. */
+export declare function reduceRoomStateAll(state: RoomState, frames: readonly EventFrame[]): RoomState;
+export declare function producerById(state: RoomState, producerId: string): ProducerEntry | undefined;
+export declare function producersOf(state: RoomState, identity: string): readonly ProducerEntry[];
+/** The active set intersected with what we actually know about, in the node's order. */
+export declare function activeProducers(state: RoomState): readonly ProducerEntry[];
+/**
+ * What this participant may actually receive.
+ *
+ * Derived rather than stored, so a barrier that narrows and later widens is
+ * reversible. The reducer keeps every producer it has been told about; this is
+ * what a UI should render and what a client should consume from.
+ */
+export declare function visibleProducers(state: RoomState): readonly ProducerEntry[];
+//# sourceMappingURL=state.d.ts.map

package/build/core/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/core/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,UAAU,EAAoB,KAAK,IAAI,EAAE,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE5H;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACpC,iDAAiD;IACjD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,gEAAgE;IAChE,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IACvB;;;;OAIG;IACH,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;IACpC,gEAAgE;IAChE,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,8EAA8E;IAC9E,SAAS,EAAE,OAAO,CAAC;IACnB,sDAAsD;IACtD,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,uDAAuD;IACvD,QAAQ,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,SAW9B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,GAAG,SAAS,CAkH9E;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,CAE7F;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE5F;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE,CAExF;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,aAAa,EAAE,CAO1E;AAYD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,aAAa,EAAE,CAE3E"}