hci-atrium 0.1.0

package/dist/rooms/sse.js

@@ -0,0 +1,347 @@
+/**
+ * The room's **SSE-receive + POST-send** transport — the fallback the {@link ./room.Room} uses when
+ * the WebSocket ({@link ./transport.RoomSocket}) can't come up (a reverse proxy that strips WS
+ * upgrades, like the production HULK edge, looks exactly like a WS that never reaches ``ready``).
+ *
+ * This is the port of the Python SDK's SSE dispatcher (``aio.py``'s ``_RoomDispatcher`` +
+ * ``rooms.py``'s ``_events`` / ``_stream_params``): receive live signals over
+ * ``GET /v1/rooms/{id}/events`` (SSE), send over ``POST /v1/rooms/{id}/signal``. Both directions
+ * authorize with the **connect code** — the SSE read passes ``?code=``, the signal POST passes it in
+ * the ``X-Session-Code`` header — so it works for a host (its own room's code) and a loginless
+ * participant alike, and needs no bearer/streaming-auth plumbing (mirror of the WS route's code-only
+ * auth). Native ``EventSource`` can't set headers or read a POST body, so this uses streaming
+ * ``fetch`` (``res.body`` reader), which handles code-auth uniformly in browser and Node.
+ *
+ * Limits vs. WS (documented, same as Python): **signals only** — a room's ephemeral *binary* audio
+ * stream rides the WS exclusively, so {@link sendBinary} is a no-op and audio consumers
+ * (``audioSignals`` / ``audioClips``) stay WS-only. Rooms have **no replay** (the events stream
+ * carries no ``id:`` cursor), so a dropped stream reconnects with backoff and misses the gap — there
+ * is nothing to resume with ``Last-Event-ID`` (that cursor is a session-stream feature, not a room's).
+ * A ``room.code_rotated`` signal (or the terminal 403/404) ends the stream for good.
+ */
+import { httpFetch } from "../http.js";
+import { buildRoomSignal } from "../shaping/rooms.js";
+import { backoffDelay, CONNECT_TIMEOUT_MS, ReadyWaiters } from "./transport-shared.js";
+const ROOM_CODE_ROTATED = "room.code_rotated";
+function eventsUrl(o) {
+    const base = o.baseUrl.replace(/\/+$/, "");
+    const params = new URLSearchParams({ code: o.code });
+    if (o.observe) {
+        // An observer taps the feed silently — no presence identity/announce, just the observe flag.
+        params.set("observe", "1");
+    }
+    else {
+        if (o.identity)
+            params.set("identity", o.identity);
+        if (o.announce)
+            params.set("announce", JSON.stringify(o.announce));
+    }
+    return `${base}/v1/rooms/${o.roomId}/events?${params.toString()}`;
+}
+function mapRosterEntry(raw) {
+    return {
+        connectionId: raw.connection_id ?? "",
+        identity: raw.identity,
+        announce: raw.announce,
+        connectedAt: raw.connected_at,
+    };
+}
+/**
+ * Parse a byte stream of Server-Sent Events into ``{event, data}`` frames (one per blank-line
+ * boundary) — the async-generator mirror of Python's ``_aparse_sse``. Comment lines (``:`` — the
+ * keepalives) are skipped; multiple ``data:`` lines join with newlines; ``id:`` is ignored (a room
+ * stream has no replay cursor).
+ */
+export async function* sseFrames(reader) {
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let event = "message";
+    let data = [];
+    while (true) {
+        const { value, done } = await reader.read();
+        if (done)
+            break;
+        buffer += decoder.decode(value, { stream: true });
+        // Scan line-by-line with a moving cursor, slicing only each line out (not the whole tail per
+        // line) — the old ``buffer = buffer.slice(nl + 1)`` re-copied the remaining buffer on every line,
+        // going quadratic on a burst. The consumed prefix is dropped once, after the chunk is scanned.
+        let start = 0;
+        let nl = buffer.indexOf("\n", start);
+        while (nl >= 0) {
+            let end = nl;
+            if (end > start && buffer.charCodeAt(end - 1) === 13)
+                end -= 1; // strip a trailing \r
+            const line = buffer.slice(start, end);
+            if (line === "") {
+                if (data.length > 0)
+                    yield { event, data: data.join("\n") };
+                event = "message";
+                data = [];
+            }
+            else if (line.startsWith(":")) {
+                // keepalive / comment — ignore
+            }
+            else if (line.startsWith("event:")) {
+                event = line.slice("event:".length).trim();
+            }
+            else if (line.startsWith("data:")) {
+                data.push(line.slice("data:".length).replace(/^ /, ""));
+            }
+            // `id:` deliberately ignored — rooms have no replay.
+            start = nl + 1;
+            nl = buffer.indexOf("\n", start);
+        }
+        if (start > 0)
+            buffer = buffer.slice(start);
+    }
+}
+export class RoomEventStream {
+    opts;
+    connId = null;
+    roster = [];
+    closed = false;
+    attempt = 0;
+    everReady = false;
+    controller = null;
+    retryTimer = null;
+    // True while runLoop is alive — connect() restarts a *dead* loop instead of adding a waiter that
+    // would never resolve (the double-open guard ported from the WS transport). A live loop just gets
+    // the new waiter.
+    looping = false;
+    readyWaiters = new ReadyWaiters();
+    fetchImpl;
+    constructor(opts) {
+        this.opts = opts;
+        this.fetchImpl = opts.fetchImpl ?? httpFetch;
+    }
+    connectionId() {
+        return this.connId;
+    }
+    participants() {
+        return [...this.roster];
+    }
+    connect() {
+        if (this.everReady)
+            return Promise.resolve();
+        // A closed stream never reopens — reject at once (the connect-after-close race, mirror of
+        // RoomSocket.connect) rather than start a loop that a set ``closed`` flag would abandon.
+        if (this.closed)
+            return Promise.reject(new Error("room closed"));
+        const promise = new Promise((resolve, reject) => {
+            this.readyWaiters.add(resolve, reject);
+        });
+        if (!this.looping) {
+            void this.runLoop();
+            const timer = setTimeout(() => {
+                this.readyWaiters.rejectAll(new Error(`room stream not ready within ${CONNECT_TIMEOUT_MS / 1000}s`));
+            }, CONNECT_TIMEOUT_MS);
+            void promise.finally(() => clearTimeout(timer)).catch(() => { });
+        }
+        return promise;
+    }
+    /** Send a text signal over ``POST /v1/rooms/{id}/signal`` — fire-and-forget (mirror of the WS
+     * ``sendSignal``: a failure is swallowed, like a WS send dropped while momentarily down). */
+    sendSignal(sig) {
+        const { json } = buildRoomSignal(this.opts.roomId, {
+            type: sig.type,
+            payload: sig.payload,
+            to: sig.to,
+            includeSelf: sig.includeSelf,
+            source: sig.source,
+            ackId: sig.ackId,
+            replyTo: sig.replyTo,
+            connectionId: this.connId,
+        });
+        const base = this.opts.baseUrl.replace(/\/+$/, "");
+        void this.fetchImpl(`${base}/v1/rooms/${this.opts.roomId}/signal`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json", "X-Session-Code": this.opts.code },
+            body: JSON.stringify(json),
+        }).catch(() => { });
+    }
+    /** SSE carries no binary — audio consumers stay WS-only. A no-op, so a Room in SSE fallback never
+     * throws on the (unused) binary path. */
+    sendBinary(_data) { }
+    close() {
+        this.closed = true;
+        if (this.retryTimer)
+            clearTimeout(this.retryTimer);
+        this.retryTimer = null;
+        this.controller?.abort();
+        this.controller = null;
+        this.readyWaiters.rejectAll(new Error("room closed"));
+    }
+    async runLoop() {
+        this.looping = true;
+        try {
+            await this.loop();
+        }
+        finally {
+            this.looping = false;
+        }
+    }
+    async loop() {
+        while (!this.closed) {
+            const controller = new AbortController();
+            this.controller = controller;
+            let rotationSeen = false;
+            try {
+                const res = await this.fetchImpl(eventsUrl(this.opts), {
+                    method: "GET",
+                    headers: { Accept: "text/event-stream" },
+                    signal: controller.signal,
+                });
+                if (!res.ok) {
+                    if (this.handleHttpError(res.status))
+                        return; // terminal (403/404) — stop
+                    // else fall through to backoff (429 / 5xx / transient)
+                }
+                else if (res.body) {
+                    const reader = res.body.getReader();
+                    for await (const frame of sseFrames(reader)) {
+                        if (this.closed)
+                            return;
+                        if (frame.event === "ready") {
+                            this.onReadyFrame(frame.data);
+                        }
+                        else if (frame.event === "signal") {
+                            // Await the dispatch inline — a promise-returning onSignal (the recorder's inline
+                            // session-event write) throttles the reader here, so recorded events can't lag
+                            // unboundedly. A rejection falls through to the catch below (backoff + reconnect).
+                            rotationSeen = (await this.onSignalFrame(frame.data)) || rotationSeen;
+                        }
+                    }
+                    // The stream ended. A code rotation is the one clean terminal end (the server broadcasts
+                    // ``room.code_rotated`` then closes the stream — there is no SSE close code, so the signal
+                    // is the in-band 4410 equivalent). Otherwise the stream just dropped: reconnect (no replay).
+                    if (rotationSeen) {
+                        this.opts.onEnd?.("code-rotated");
+                        return;
+                    }
+                }
+            }
+            catch (err) {
+                if (this.closed || err?.name === "AbortError")
+                    return;
+                // network/transient error — fall through to backoff
+            }
+            this.everReady = false;
+            if (this.opts.reconnect === false) {
+                this.readyWaiters.rejectAll(new Error("room stream closed before ready"));
+                return;
+            }
+            await this.backoff();
+        }
+    }
+    // Map an HTTP error to a terminal reason (mirror of the WS 4404/4403 close codes + Python's blanket
+    // rule: any status < 500 except 429 is terminal — the server refused us and no retry will heal it).
+    // Returns true if terminal (stop the loop); 429 (the code-throttle window) and 5xx are transient.
+    handleHttpError(status) {
+        if (status >= 500 || status === 429)
+            return false; // transient — backoff + retry
+        // A gone room reads as room-gone; every other refusal (401/403/400/410/…) as a rejected code.
+        this.terminate(status === 404 ? "room-gone" : "bad-code");
+        return true;
+    }
+    terminate(reason) {
+        if (!this.everReady)
+            this.readyWaiters.rejectAll(new Error(`room connection ended: ${reason}`));
+        this.opts.onEnd?.(reason);
+    }
+    onReadyFrame(data) {
+        let msg;
+        try {
+            msg = JSON.parse(data);
+        }
+        catch {
+            return;
+        }
+        this.connId = msg.connection_id ?? null;
+        this.attempt = 0;
+        this.everReady = true;
+        this.roster = (msg.participants ?? []).map(mapRosterEntry);
+        this.opts.onParticipants?.(this.participants());
+        this.readyWaiters.resolveAll();
+        if (this.connId)
+            this.opts.onReady?.(this.connId);
+    }
+    // Dispatch one signal frame; returns true if it was the code-rotation advance signal. Awaits
+    // onSignal so a consumer's inline write (the recorder) backpressures the read loop.
+    async onSignalFrame(data) {
+        let sig;
+        try {
+            sig = JSON.parse(data);
+        }
+        catch {
+            return false;
+        }
+        this.updateRoster(sig);
+        await this.opts.onSignal?.(sig);
+        return sig.type === ROOM_CODE_ROTATED;
+    }
+    updateRoster(sig) {
+        const p = sig.payload;
+        if (sig.type === "presence.join") {
+            if (p?.connection_id && !this.roster.some((x) => x.connectionId === p.connection_id)) {
+                this.roster = [...this.roster, mapRosterEntry(p)];
+                this.opts.onParticipants?.(this.participants());
+            }
+        }
+        else if (sig.type === "presence.leave") {
+            if (p?.connection_id && this.roster.some((x) => x.connectionId === p.connection_id)) {
+                this.roster = this.roster.filter((x) => x.connectionId !== p.connection_id);
+                this.opts.onParticipants?.(this.participants());
+            }
+        }
+    }
+    backoff() {
+        const delay = backoffDelay(this.attempt);
+        this.attempt += 1;
+        return new Promise((resolve) => {
+            this.retryTimer = setTimeout(resolve, delay);
+        });
+    }
+}
+/**
+ * Read a room's presence roster off one short **observe** SSE stream and return it parsed — the
+ * transport behind ``room.participants()`` / ``room.has()`` (mirror of Python's ``_read_participants``
+ * / ``AsyncRoom.participants``). ``observe=1`` taps the feed without minting a presence connection
+ * (no phantom join/leave), reads the first ``ready`` frame's roster, then closes. SSE (not WS) because
+ * the WS route has no observe mode, and SSE works behind a WS-stripping proxy.
+ */
+export async function readObserveRoster(opts) {
+    const fetchImpl = opts.fetchImpl ?? httpFetch;
+    const base = opts.baseUrl.replace(/\/+$/, "");
+    const url = `${base}/v1/rooms/${opts.roomId}/events?${new URLSearchParams({
+        code: opts.code,
+        observe: "1",
+    }).toString()}`;
+    const controller = new AbortController();
+    const res = await fetchImpl(url, {
+        method: "GET",
+        headers: { Accept: "text/event-stream" },
+        signal: controller.signal,
+    });
+    if (!res.ok) {
+        const detail = await res.text().catch(() => "");
+        controller.abort();
+        throw new Error(`room roster read failed (${res.status})${detail ? `: ${detail}` : ""}`);
+    }
+    if (!res.body) {
+        return [];
+    }
+    const reader = res.body.getReader();
+    try {
+        for await (const frame of sseFrames(reader)) {
+            if (frame.event === "ready") {
+                const msg = JSON.parse(frame.data);
+                return msg.participants ?? [];
+            }
+        }
+        return [];
+    }
+    finally {
+        controller.abort();
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/rooms/sse.js.map

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

package/dist/rooms/standing-source.d.ts

@@ -0,0 +1,190 @@
+/**
+ * The shared harness for the two peer-toggleable standing offers (``offerTranscription`` /
+ * ``offerAudioCapture``) — the TypeScript port of Python's ``_StandingSource`` (aio.py). Everything
+ * the multi-mic scoping needs that isn't specific to *what* a source's frames do (transcribe vs
+ * record):
+ *
+ * * the {@link ArmedSet} and the ``maxSources`` cap admission ({@link StandingSource.tryArm}) plus
+ *   warn-once cap logging;
+ * * the ``active`` roster + {@link StandingSource.status}, built on the **armed set** (not on audio
+ *   flow — a source appears the moment it is armed; an all-arm enumerates every currently-connected
+ *   ``capture-source`` from the presence roster, kept current on join/leave);
+ * * broadcast dedup + fire-and-forget spawn, over the REST ``/signal`` POST (the WS inbound path
+ *   forces ``ephemeral: false``, so an ephemeral ``*.available`` broadcast must ride REST);
+ * * the departed-source grace bookkeeping and the **single** periodic sweeper (one timer — not a
+ *   timer per departure) that finalizes/expires grace;
+ * * arm **migration** on a same-name reconnect so a per-source-armed device that drops and returns
+ *   within grace stays admitted;
+ * * the generic scoped ``start`` / ``stopRequest`` shells, dispatching to per-offer hooks.
+ *
+ * Subclasses provide ``signal`` / ``logName`` / ``identityPrefix`` and override the hooks:
+ * {@link StandingSource.run}, {@link StandingSource.stop}, {@link StandingSource.stopSource},
+ * {@link StandingSource.beforeArm}, {@link StandingSource.onEngage}, {@link StandingSource.activeExtra},
+ * {@link StandingSource.onPresenceSource}, {@link StandingSource.onGraceExpired}.
+ */
+import { ArmedSet } from "./armed-set.js";
+import { RoomSocket, type WebSocketCtor } from "./transport.js";
+/** Max clips buffered per source before an offered transcription's demux drops the *oldest* (live
+ * captions favour recency; a stalled engine must not grow memory without bound). */
+export declare const OFFER_CLIP_QUEUE_MAX = 8;
+/** Safety bound on the pre-demux frame queue — only BINARY frames are dropped (oldest-first) past
+ * this; control/presence/end frames are never dropped (they carry roster + teardown state). Generous
+ * because the demux normally drains it at once; it exists to cap a pathological producer flood. */
+export declare const OFFER_EVENT_QUEUE_MAX = 256;
+/** Consecutive failed recording-creates for one capture source before it is dropped. */
+export declare const CAPTURE_CREATE_MAX_FAILURES = 3;
+/** Default cap on concurrently-active sources per offer (multi-mic safety). */
+export declare const OFFER_MAX_SOURCES = 8;
+/** Grace window (seconds) an offered-capture recording stays open after its source departs, so a
+ * same-name reconnect within it resumes the very same file. Elapsed with no return → it finalizes. */
+export declare const SOURCE_GRACE_SECONDS = 120;
+/** How often the single grace sweeper wakes to scan departure timestamps (coarse — grace is minutes). */
+export declare const GRACE_SWEEP_SECONDS = 5;
+/** One entry of a standing offer's ``active`` roster: an armed source, human-labelled if known. */
+export interface ActiveSource {
+    source: string | null;
+    name: string | null;
+}
+/** What every standing offer is wired with (filled by {@link ./room.Room}). */
+export interface OfferDeps {
+    roomId: string;
+    /** Read the room's current connect code (it can rotate) — the snippet socket's ``?code=`` auth. */
+    getCode(): string;
+    baseUrl: string;
+    reconnect?: boolean;
+    WebSocketCtor?: WebSocketCtor;
+    /** Publish a room signal over the REST ``/signal`` POST — preserves ``ephemeral`` (unlike the WS
+     * inbound path, which forces ``ephemeral: false``). Used for ``*.available`` broadcasts and the
+     * per-source ``transcript.*`` publishes. */
+    publishSignal(type: string, payload: Record<string, unknown>, opts: {
+        source?: string | null;
+        ephemeral?: boolean;
+    }): Promise<void>;
+    /** Refuse fast (throw {@link ../errors.AtriumError}) if the room handle latched onto the SSE
+     * transport — binary audio is WS-only, so the offer must not open a doomed snippet socket that
+     * spins a WS reconnect forever. Consulted at engage time (before the frame loop launches). */
+    requireWsAudio?(): void;
+}
+/** A minimal async mutex — serializes state transitions (start / stop / grace-finalize / disengage),
+ * the port of the offers' ``asyncio.Lock``. */
+export declare class Mutex {
+    private tail;
+    run<T>(fn: () => Promise<T>): Promise<T>;
+}
+export declare abstract class StandingSource {
+    protected readonly signal: string;
+    protected readonly logName: string;
+    protected readonly identityPrefix: string;
+    protected readonly deps: OfferDeps;
+    protected readonly maxSources: number;
+    protected readonly armed: ArmedSet;
+    protected readonly lock: Mutex;
+    /** Grace window (seconds) — a per-instance override of {@link SOURCE_GRACE_SECONDS} (tests set 0). */
+    graceSeconds: number;
+    /** Sweeper interval (seconds) — overridable for tests. */
+    sweepSeconds: number;
+    protected ws: RoomSocket | null;
+    protected runPromise: Promise<void> | null;
+    protected settled: boolean;
+    protected err: Error | null;
+    /** Set when the offer wound down because the room rotated its connect code (a controlled end, not
+     * an error — {@link error} stays ``null``). */
+    stoppedReason: string | null;
+    /** True once the frame stream ended via a ``room.code_rotated`` advance-signal / close. */
+    protected codeRotated: boolean;
+    /** Connection ids refused admission by the source cap — warned once each. */
+    protected readonly cappedWarned: Set<string | null>;
+    /** Background broadcast promises spun off the (sync) presence hook — settled at teardown. */
+    protected readonly bg: Promise<void>[];
+    /** The last ``(available, active)`` broadcast — dedupes the ``*.available`` signal. */
+    private lastBroadcast;
+    /** connection id → last-known announced name, kept across a leave for the grace window. */
+    protected readonly sourceNames: Map<string, string | null>;
+    /** departed connection id → leave time (ms) — the grace window a same-name return resumes within. */
+    protected readonly departed: Map<string, number>;
+    /** The offer's OWN point-in-time roster (name + roles), seeded from the ready snapshot and folded
+     * in loop order by {@link onPresence} — the port of ``RoomWebSocket``'s own ``_names`` / ``_roles``.
+     * Read (not the transport's live roster) so a burst of presence + binary resolves each frame's
+     * source against the roster *as it was when that frame was processed*. */
+    private readonly roster;
+    private rosterSeeded;
+    private eventQueue;
+    private binaryQueued;
+    private eventWake;
+    private sweepTimer;
+    constructor(deps: OfferDeps, maxSources?: number);
+    /** True while the offer is engaged (the snippet subscription loop runs). */
+    get alive(): boolean;
+    /** The error that ended the offer for good (``null`` while armed or after ``stop()``). */
+    get error(): Error | null;
+    /** Availability as it rides ``<service>.status`` / ``<service>.available``. The default
+     * (transcription) is available unless the loop died on a terminal error; capture overrides to also
+     * require an active recorder. */
+    available(): boolean;
+    protected isDeparted(cid: string): boolean;
+    protected nameFor(cid: string): string | null;
+    protected connectionIdsWithRole(role: string): string[];
+    private armedActive;
+    /** Per-offer additions to the armed roster (the honesty entry for a v1 id-less source). */
+    protected activeExtra(): ActiveSource[];
+    protected active(): ActiveSource[];
+    /** The ``<service>.status`` reply payload (sans the outer ``ok``). */
+    status(): {
+        available: boolean;
+        active: ActiveSource[];
+    };
+    protected broadcast(): Promise<void>;
+    protected clearLastBroadcast(): void;
+    protected spawnBroadcast(): void;
+    protected tryArm(source: string | null, armAll: boolean): void;
+    protected warnCapped(cid: string | null): void;
+    /** Open the snippet-subscription WebSocket, seed the departed-name roster, and launch the single
+     * grace sweeper. Each ``run`` calls this at its top. */
+    protected openWs(): Promise<RoomSocket>;
+    private seedRoster;
+    private foldPresence;
+    private pushEvent;
+    /** Yield the snippet-consumer socket's binary frames while folding ``presence.join`` /
+     * ``presence.leave`` into the live roster + arm migration (the port of Python's
+     * ``RoomWebSocket.frames(on_presence=...)``). Ends when the socket ends. */
+    protected frames(): AsyncGenerator<ArrayBuffer>;
+    protected startSweeper(): void;
+    protected stopSweeper(): void;
+    /** One grace pass: finalize/expire each source whose grace window elapsed with no return. Public
+     * so a test can drive a pass directly (mirror of Python's ``_sweep_once``). */
+    sweepOnce(): Promise<void>;
+    /** Per-offer grace-expiry action (capture finalizes the departed recording; default: none). */
+    protected onGraceExpired(_cid: string): Promise<void>;
+    protected onPresence(event: "join" | "leave", cid: string, announce?: Record<string, unknown>): void;
+    private migrateArmOnRejoin;
+    /** Per-offer presence bookkeeping (transcription reaps the source's engine on leave; capture
+     * leans on the shared grace machinery, so it's a no-op). Default: none. */
+    protected onPresenceSource(_event: "join" | "leave", _cid: string): void;
+    /** Arm a source (idempotent) and launch the frame loop on the first arm. Scoped to ``source``
+     * unless ``all`` (or an unscoped ``source=null`` — the v1 rule). Refuses a new per-source arm past
+     * the cap; a per-offer {@link beforeArm} may refuse for another reason (capture: no recorder).
+     * Broadcasts the armed-set change immediately, so a device sees itself active before a frame. */
+    start({ source, all, }?: {
+        source?: string | null;
+        all?: boolean;
+    }): Promise<void>;
+    /** Per-offer pre-arm check, returning a context passed to {@link onEngage} on first launch. */
+    protected beforeArm(_armAll: boolean): Promise<unknown>;
+    /** Per-offer first-launch setup under the lock (capture binds the recorder; else none). */
+    protected onEngage(_ctx: unknown): void;
+    /** The wire ``<service>.stop``. ``all`` (or an unscoped call) is the full teardown; otherwise
+     * disarm ``source`` alone, leaving the rest. */
+    stopRequest({ source, all, }?: {
+        source?: string | null;
+        all?: boolean;
+    }): Promise<void>;
+    /** Per-offer single-source stop — provided by the subclass. */
+    protected abstract stopSource(source: string): Promise<void>;
+    /** Per-offer full teardown — provided by the subclass. */
+    abstract stop(): Promise<void>;
+    /** Per-offer frame loop — provided by the subclass. */
+    protected abstract run(): Promise<void>;
+    [Symbol.dispose]: () => void;
+    [Symbol.asyncDispose]: () => Promise<void>;
+}
+//# sourceMappingURL=standing-source.d.ts.map

package/dist/rooms/standing-source.d.ts.map

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