realtime-avatar 0.1.0

package/dist/browser/audio.js

@@ -0,0 +1,154 @@
+const ADAPTIVE_LEAD_MS = 75;
+const ADAPTIVE_MAX_HOLD_MS = 400;
+export class Pcm16AudioScheduler {
+    sourceSampleRate;
+    extraDestination;
+    context = null;
+    nextStartTime = 0;
+    mediaStartTime = null;
+    minLeadSeconds = 0.045;
+    /** When the context is owned externally (shared/unlocked on a gesture), we
+     *  must not close it on per-turn cleanup. */
+    ownsContext;
+    adaptive;
+    fixedDelayMs;
+    leadMs;
+    maxHoldMs;
+    /** False only while adaptive playout is holding buffered audio. */
+    released;
+    pending = [];
+    pendingMs = 0;
+    holdTimer = null;
+    constructor(sourceSampleRate = 16_000, playoutDelay = "adaptive", sharedContext, adaptiveOptions = {}, 
+    /** Optional extra sink (e.g. a MediaStreamAudioDestinationNode recording
+     *  tap) that every scheduled buffer also connects to. Additive — speaker
+     *  output through `context.destination` is unchanged. */
+    extraDestination = null) {
+        this.sourceSampleRate = sourceSampleRate;
+        this.extraDestination = extraDestination;
+        this.context = sharedContext ?? null;
+        this.ownsContext = !sharedContext;
+        this.adaptive = playoutDelay === "adaptive";
+        this.fixedDelayMs = typeof playoutDelay === "number" ? playoutDelay : 0;
+        this.leadMs = adaptiveOptions.leadMs ?? ADAPTIVE_LEAD_MS;
+        this.maxHoldMs = adaptiveOptions.maxHoldMs ?? ADAPTIVE_MAX_HOLD_MS;
+        this.released = !this.adaptive;
+    }
+    async prepare() {
+        const AudioContextCtor = window.AudioContext ||
+            window.webkitAudioContext;
+        if (!AudioContextCtor)
+            throw new Error("WebAudio is not available in this browser");
+        this.context ??= new AudioContextCtor({ latencyHint: "interactive" });
+        if (this.context.state !== "running")
+            await this.context.resume();
+    }
+    get mediaTimeSeconds() {
+        if (!this.context || this.mediaStartTime === null)
+            return null;
+        return Math.max(0, this.context.currentTime - this.mediaStartTime);
+    }
+    get queuedMs() {
+        if (!this.released)
+            return this.pendingMs;
+        if (!this.context)
+            return 0;
+        return Math.max(0, (this.nextStartTime - this.context.currentTime) * 1000);
+    }
+    /**
+     * Release held audio (adaptive mode): anchor the media clock a small lead
+     * from now and start every buffered chunk back-to-back. The player calls
+     * this when the first video frame is decodable, so audio and video begin
+     * together at the earliest moment both exist. Idempotent; no-op in fixed
+     * mode (fixed playout self-starts on the first scheduled chunk).
+     */
+    startPlayout() {
+        if (this.released)
+            return;
+        this.released = true;
+        if (this.holdTimer !== null) {
+            clearTimeout(this.holdTimer);
+            this.holdTimer = null;
+        }
+        const context = this.context;
+        if (!context || this.pending.length === 0) {
+            this.pending = [];
+            this.pendingMs = 0;
+            return; // nothing buffered yet: the next schedule() anchors the clock
+        }
+        this.mediaStartTime = context.currentTime + this.leadMs / 1000;
+        this.nextStartTime = this.mediaStartTime;
+        for (const buffer of this.pending)
+            this.startBuffer(context, buffer);
+        this.pending = [];
+        this.pendingMs = 0;
+    }
+    async schedule(pcm) {
+        await this.prepare();
+        const context = this.context;
+        if (!context)
+            throw new Error("AudioContext did not initialize");
+        const samples = Math.floor(pcm.byteLength / 2);
+        const audioBuffer = context.createBuffer(1, samples, this.sourceSampleRate);
+        const channel = audioBuffer.getChannelData(0);
+        const view = new DataView(pcm.buffer, pcm.byteOffset, pcm.byteLength);
+        for (let i = 0; i < samples; i += 1) {
+            channel[i] = Math.max(-1, Math.min(1, view.getInt16(i * 2, true) / 32768));
+        }
+        const durationMs = audioBuffer.duration * 1000;
+        if (!this.released) {
+            this.pending.push(audioBuffer);
+            this.pendingMs += durationMs;
+            // Video may never come (audio-only turn, decoder fault): don't hold forever.
+            this.holdTimer ??= setTimeout(() => this.startPlayout(), this.maxHoldMs);
+            return { durationMs, queuedMs: this.queuedMs, underrunMs: 0 };
+        }
+        if (this.mediaStartTime === null) {
+            const delayMs = this.adaptive ? this.leadMs : this.fixedDelayMs;
+            this.mediaStartTime = context.currentTime + delayMs / 1000;
+            this.nextStartTime = this.mediaStartTime;
+        }
+        let underrunMs = 0;
+        const minimumStartTime = context.currentTime + this.minLeadSeconds;
+        if (this.nextStartTime < minimumStartTime) {
+            const correctionSeconds = minimumStartTime - this.nextStartTime;
+            this.nextStartTime = minimumStartTime;
+            this.mediaStartTime += correctionSeconds;
+            underrunMs = correctionSeconds * 1000;
+        }
+        this.startBuffer(context, audioBuffer);
+        return { durationMs, queuedMs: this.queuedMs, underrunMs };
+    }
+    startBuffer(context, audioBuffer) {
+        const source = context.createBufferSource();
+        source.buffer = audioBuffer;
+        source.connect(context.destination);
+        if (this.extraDestination) {
+            try {
+                source.connect(this.extraDestination);
+            }
+            catch {
+                // A tap from a different/closed context must never break playback.
+            }
+        }
+        source.start(this.nextStartTime);
+        this.nextStartTime += audioBuffer.duration;
+    }
+    close() {
+        if (this.holdTimer !== null) {
+            clearTimeout(this.holdTimer);
+            this.holdTimer = null;
+        }
+        this.pending = [];
+        this.pendingMs = 0;
+        const context = this.context;
+        this.context = null;
+        this.mediaStartTime = null;
+        this.nextStartTime = 0;
+        // Only tear down a context this scheduler created. A shared/unlocked context
+        // is owned by the player and reused across turns.
+        if (this.ownsContext && context && context.state !== "closed")
+            void context.close();
+    }
+}
+//# sourceMappingURL=audio.js.map

package/dist/browser/audio.js.map

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

package/dist/browser/boomerang.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Ping-pong (boomerang) playback for idle/ambient clips.
+ *
+ * Idle videos are plain image-to-video generations (start frame != end
+ * frame), so a hard `loop` visibly jumps at the wrap. Playing forward, then
+ * scrubbing back to the start, makes ANY clip loop seamlessly — no seamless
+ * A==B generation required. Reverse is done by stepping `currentTime` on a
+ * requestAnimationFrame clock because `playbackRate < 0` is unsupported in
+ * most browsers.
+ */
+export type BoomerangPlaybackOptions = {
+    /** Reverse-phase speed relative to real time. Default 1 (same pace as forward). */
+    reverseRate?: number;
+    /** Seconds from each end at which the direction flips. Default 0.05. */
+    edgeEpsilonSeconds?: number;
+};
+export type BoomerangPlayback = {
+    /** Stop driving the element (leaves the video itself untouched). */
+    stop(): void;
+    /** Current loop state, e.g. to hand playback position to a live renderer. */
+    position(): {
+        timeSeconds: number;
+        direction: "forward" | "reverse";
+    };
+    /** Jump the loop to a position+direction (seamless handback from a live render). */
+    alignTo(timeSeconds: number, direction: "forward" | "reverse"): void;
+};
+/**
+ * Drive a `<video>` element in a forward-then-reverse loop. The element should
+ * be muted + playsInline (autoplay policies). Idempotent per call; returns a
+ * handle whose `stop()` cancels the drive loop. Safe with elements whose
+ * metadata has not loaded yet.
+ *
+ *     const playback = attachBoomerangPlayback(videoEl);
+ *     // later: playback.stop();
+ */
+export declare function attachBoomerangPlayback(video: HTMLVideoElement, options?: BoomerangPlaybackOptions): BoomerangPlayback;
+//# sourceMappingURL=boomerang.d.ts.map

package/dist/browser/boomerang.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boomerang.d.ts","sourceRoot":"","sources":["../../src/browser/boomerang.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,wBAAwB,GAAG;IACrC,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,oEAAoE;IACpE,IAAI,IAAI,IAAI,CAAC;IACb,6EAA6E;IAC7E,QAAQ,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAAA;KAAE,CAAC;IACtE,oFAAoF;IACpF,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC;CACtE,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE,wBAA6B,GACrC,iBAAiB,CA4DnB"}

package/dist/browser/boomerang.js

@@ -0,0 +1,85 @@
+/**
+ * Ping-pong (boomerang) playback for idle/ambient clips.
+ *
+ * Idle videos are plain image-to-video generations (start frame != end
+ * frame), so a hard `loop` visibly jumps at the wrap. Playing forward, then
+ * scrubbing back to the start, makes ANY clip loop seamlessly — no seamless
+ * A==B generation required. Reverse is done by stepping `currentTime` on a
+ * requestAnimationFrame clock because `playbackRate < 0` is unsupported in
+ * most browsers.
+ */
+/**
+ * Drive a `<video>` element in a forward-then-reverse loop. The element should
+ * be muted + playsInline (autoplay policies). Idempotent per call; returns a
+ * handle whose `stop()` cancels the drive loop. Safe with elements whose
+ * metadata has not loaded yet.
+ *
+ *     const playback = attachBoomerangPlayback(videoEl);
+ *     // later: playback.stop();
+ */
+export function attachBoomerangPlayback(video, options = {}) {
+    const reverseRate = options.reverseRate ?? 1;
+    const edge = options.edgeEpsilonSeconds ?? 0.05;
+    let raf = null;
+    let direction = 1;
+    let last = now();
+    const step = (nowMs) => {
+        raf = requestAnimationFrame(step);
+        const duration = video.duration;
+        if (!Number.isFinite(duration) || duration <= 0) {
+            last = nowMs;
+            return;
+        }
+        if (direction === 1) {
+            // Forward playback is native; just watch for the end to flip direction.
+            if (video.paused)
+                void video.play().catch(() => { });
+            if (video.currentTime >= duration - edge) {
+                direction = -1;
+                video.pause();
+                last = nowMs;
+            }
+            return;
+        }
+        // Reverse: manually rewind currentTime using the wall-clock delta. The
+        // delta is clamped so a background-tab pause (rAF suspension) resumes
+        // smoothly instead of teleporting.
+        const dt = Math.min(0.1, (nowMs - last) / 1000) * reverseRate;
+        last = nowMs;
+        const next = video.currentTime - dt;
+        if (next <= edge) {
+            video.currentTime = 0;
+            direction = 1;
+        }
+        else {
+            video.currentTime = next;
+        }
+    };
+    raf = requestAnimationFrame(step);
+    return {
+        stop() {
+            if (raf !== null) {
+                cancelAnimationFrame(raf);
+                raf = null;
+            }
+        },
+        position() {
+            return { timeSeconds: video.currentTime, direction: direction === 1 ? "forward" : "reverse" };
+        },
+        alignTo(timeSeconds, nextDirection) {
+            const duration = video.duration;
+            const clamped = Number.isFinite(duration) && duration > 0
+                ? Math.min(Math.max(timeSeconds, 0), duration - edge)
+                : Math.max(timeSeconds, 0);
+            video.currentTime = clamped;
+            direction = nextDirection === "reverse" ? -1 : 1;
+            last = now();
+            if (direction === -1)
+                video.pause();
+        },
+    };
+}
+function now() {
+    return typeof performance !== "undefined" ? performance.now() : Date.now();
+}
+//# sourceMappingURL=boomerang.js.map

package/dist/browser/boomerang.js.map

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

package/dist/browser/index.d.ts

@@ -0,0 +1,8 @@
+export { Pcm16AudioScheduler } from "./audio";
+export { attachBoomerangPlayback, type BoomerangPlayback, type BoomerangPlaybackOptions, } from "./boomerang";
+export { I420CanvasRenderer, drawI420Frame } from "./yuv-canvas";
+export { AvatarPlayer, type AvatarPlayerState, type AvatarPlayerMetrics, type AvatarPlayerOptions, type AvatarPlayHandlers, type AvatarPlaySummary, type AvatarSourceVideoState, } from "./player";
+export { CanvasView, type AvatarView, type AvatarViewMetrics } from "./view";
+export { attachCloudflareWhepPlayback, type CloudflareWhepPlayback, type CloudflareWhepPlaybackOptions, } from "./webrtc";
+export { connectAvatarSessionMedia, type AvatarSessionMediaConnection, type AvatarSessionMediaState, type AvatarSessionMediaStateEvent, type ConnectAvatarSessionMediaOptions, } from "./media-session";
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EACL,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,GAC9B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,GAC5B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC7E,OAAO,EACL,4BAA4B,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,GACnC,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,yBAAyB,EACzB,KAAK,4BAA4B,EACjC,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EACjC,KAAK,gCAAgC,GACtC,MAAM,iBAAiB,CAAC"}

package/dist/browser/index.js

@@ -0,0 +1,8 @@
+export { Pcm16AudioScheduler } from "./audio";
+export { attachBoomerangPlayback, } from "./boomerang";
+export { I420CanvasRenderer, drawI420Frame } from "./yuv-canvas";
+export { AvatarPlayer, } from "./player";
+export { CanvasView } from "./view";
+export { attachCloudflareWhepPlayback, } from "./webrtc";
+export { connectAvatarSessionMedia, } from "./media-session";
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EACL,uBAAuB,GAGxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EACL,YAAY,GAOb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,UAAU,EAA2C,MAAM,QAAQ,CAAC;AAC7E,OAAO,EACL,4BAA4B,GAG7B,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,yBAAyB,GAK1B,MAAM,iBAAiB,CAAC"}

package/dist/browser/media-session.d.ts

@@ -0,0 +1,43 @@
+import { type RealtimeMediaPlan } from "../media";
+import type { AvatarSession, AvatarSessionConnectResult } from "../session";
+import { type CloudflareWhepPlayback, type CloudflareWhepPlaybackOptions } from "./webrtc";
+export type AvatarSessionMediaState = "disabled" | "unsupported" | "connecting" | "connected" | "playing" | "error";
+export type AvatarSessionMediaStateEvent = {
+    state: AvatarSessionMediaState;
+    media: RealtimeMediaPlan | null;
+    playback?: CloudflareWhepPlayback;
+    error?: Error;
+};
+export type ConnectAvatarSessionMediaOptions = {
+    /** Optional WHEP video target. If omitted, the control socket still connects and WS mux remains the media fallback. */
+    video?: HTMLVideoElement | null;
+    /** Keep the existing make-before-break fallback only. */
+    media?: "auto" | "off";
+    signal?: AbortSignal;
+    WebSocketImpl?: typeof WebSocket;
+    whep?: CloudflareWhepPlaybackOptions;
+    /** Default false: media-plane failures are reported but do not fail the realtime session. */
+    throwOnMediaError?: boolean;
+    /** Default false: resolve as soon as prepare succeeds; WHEP connects in the background. */
+    waitForMedia?: boolean;
+    /** Optional deadline used only when `waitForMedia` is true. */
+    waitForMediaMs?: number;
+    onMediaState?: (event: AvatarSessionMediaStateEvent) => void;
+};
+export type AvatarSessionMediaConnection = AvatarSessionConnectResult & {
+    media: RealtimeMediaPlan | null;
+    /** Resolves to the WHEP playback when available, or null when disabled/failed without strict media errors. */
+    mediaReady: Promise<CloudflareWhepPlayback | null>;
+    readonly mediaState: AvatarSessionMediaState;
+    readonly mediaPlayback: CloudflareWhepPlayback | null;
+    close: () => Promise<void>;
+};
+/**
+ * Browser-friendly session bootstrap: connect the low-latency control socket,
+ * attach Cloudflare WHEP as soon as the grant exists, then prepare the avatar.
+ * That lets SDP/ICE and Cloudflare viewer join latency overlap GPU warmup.
+ * WHEP never blocks the fallback canvas/mux path unless `waitForMedia` or
+ * `throwOnMediaError` is explicitly requested.
+ */
+export declare function connectAvatarSessionMedia(session: AvatarSession, options?: ConnectAvatarSessionMediaOptions): Promise<AvatarSessionMediaConnection>;
+//# sourceMappingURL=media-session.d.ts.map

package/dist/browser/media-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-session.d.ts","sourceRoot":"","sources":["../../src/browser/media-session.ts"],"names":[],"mappings":"AACA,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAgC,KAAK,sBAAsB,EAAE,KAAK,6BAA6B,EAAE,MAAM,UAAU,CAAC;AAEzH,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,aAAa,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpH,MAAM,MAAM,4BAA4B,GAAG;IACzC,KAAK,EAAE,uBAAuB,CAAC;IAC/B,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,uHAAuH;IACvH,KAAK,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChC,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,SAAS,CAAC;IACjC,IAAI,CAAC,EAAE,6BAA6B,CAAC;IACrC,6FAA6F;IAC7F,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,2FAA2F;IAC3F,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,4BAA4B,KAAK,IAAI,CAAC;CAC9D,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,0BAA0B,GAAG;IACtE,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAChC,8GAA8G;IAC9G,UAAU,EAAE,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtD,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,gCAAqC,GAC7C,OAAO,CAAC,4BAA4B,CAAC,CA4EvC"}

package/dist/browser/media-session.js

@@ -0,0 +1,169 @@
+import { isCloudflareWhepMediaPlan } from "../media";
+import { attachCloudflareWhepPlayback } from "./webrtc";
+/**
+ * Browser-friendly session bootstrap: connect the low-latency control socket,
+ * attach Cloudflare WHEP as soon as the grant exists, then prepare the avatar.
+ * That lets SDP/ICE and Cloudflare viewer join latency overlap GPU warmup.
+ * WHEP never blocks the fallback canvas/mux path unless `waitForMedia` or
+ * `throwOnMediaError` is explicitly requested.
+ */
+export async function connectAvatarSessionMedia(session, options = {}) {
+    let state = "disabled";
+    let playback = null;
+    let closed = false;
+    let media = null;
+    const mediaReadyRef = { current: null };
+    const mediaAbort = new AbortController();
+    const cleanupParentAbort = linkAbort(options.signal, mediaAbort);
+    const emit = (event) => {
+        state = event.state;
+        options.onMediaState?.(event);
+    };
+    const startMedia = (grant) => {
+        if (mediaReadyRef.current)
+            return;
+        media = grant.media ?? null;
+        mediaReadyRef.current = startMediaPlayback({
+            media,
+            video: options.video ?? null,
+            mode: options.media ?? "auto",
+            signal: mediaAbort.signal,
+            whep: options.whep,
+            throwOnMediaError: options.throwOnMediaError ?? false,
+            emit,
+        }).then((result) => {
+            if (closed && result)
+                void result.close();
+            if (!closed)
+                playback = result;
+            return closed ? null : result;
+        });
+    };
+    let connected;
+    try {
+        connected = await session.connectWithGrant({
+            signal: options.signal,
+            WebSocketImpl: options.WebSocketImpl,
+            onGrant: startMedia,
+        });
+    }
+    catch (error) {
+        closed = true;
+        cleanupParentAbort();
+        mediaAbort.abort();
+        const pendingMediaReady = mediaReadyRef.current;
+        const currentPlayback = playback ?? (pendingMediaReady ? await pendingMediaReady.catch(() => null) : null);
+        await currentPlayback?.close();
+        throw error;
+    }
+    startMedia(connected.grant);
+    const ready = mediaReadyRef.current ?? Promise.resolve(null);
+    if (options.waitForMedia) {
+        await withOptionalTimeout(ready, options.waitForMediaMs ?? 8_000);
+    }
+    return {
+        ...connected,
+        media,
+        mediaReady: ready,
+        get mediaState() {
+            return state;
+        },
+        get mediaPlayback() {
+            return playback;
+        },
+        close: async () => {
+            if (closed)
+                return;
+            closed = true;
+            cleanupParentAbort();
+            mediaAbort.abort();
+            const currentPlayback = playback ?? (await ready.catch(() => null));
+            await currentPlayback?.close();
+            session.disconnect();
+        },
+    };
+}
+async function startMediaPlayback(options) {
+    if (options.mode === "off" || !options.media) {
+        options.emit({ state: "disabled", media: options.media });
+        return null;
+    }
+    if (!isCloudflareWhepMediaPlan(options.media)) {
+        options.emit({ state: "disabled", media: options.media });
+        return null;
+    }
+    if (!options.video) {
+        options.emit({ state: "unsupported", media: options.media });
+        return null;
+    }
+    try {
+        options.emit({ state: "connecting", media: options.media });
+        const playback = await attachCloudflareWhepPlayback(options.media, options.video, {
+            // Cloudflare WHEP may return 409 until the paired WHIP publisher has
+            // started sending media. Keep probing in the background; the mux/canvas
+            // path is already live and this promise is non-blocking by default.
+            retries: 20,
+            retryDelayMs: 500,
+            iceGatheringTimeoutMs: 800,
+            ...options.whep,
+            signal: options.signal,
+        });
+        options.emit({ state: "connected", media: options.media, playback });
+        armFirstFrameState(options.video, options.signal, () => {
+            options.emit({ state: "playing", media: options.media, playback });
+        });
+        return playback;
+    }
+    catch (error) {
+        const normalized = error instanceof Error ? error : new Error(String(error));
+        options.emit({ state: "error", media: options.media, error: normalized });
+        if (options.throwOnMediaError)
+            throw normalized;
+        return null;
+    }
+}
+function linkAbort(parent, child) {
+    if (!parent)
+        return () => undefined;
+    const abort = () => child.abort();
+    if (parent.aborted)
+        abort();
+    else
+        parent.addEventListener("abort", abort, { once: true });
+    return () => parent.removeEventListener("abort", abort);
+}
+function withOptionalTimeout(work, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error("Realtime media did not become ready in time")), timeoutMs);
+        void work.then((value) => {
+            clearTimeout(timer);
+            resolve(value);
+        }, (error) => {
+            clearTimeout(timer);
+            reject(error);
+        });
+    });
+}
+function armFirstFrameState(video, signal, onFrame) {
+    if (video.readyState >= HTMLMediaElement.HAVE_CURRENT_DATA) {
+        onFrame();
+        return;
+    }
+    const events = ["loadeddata", "canplay", "playing", "timeupdate"];
+    const cleanup = () => {
+        for (const event of events)
+            video.removeEventListener(event, done);
+        signal.removeEventListener("abort", cleanup);
+    };
+    const done = () => {
+        cleanup();
+        onFrame();
+    };
+    for (const event of events)
+        video.addEventListener(event, done, { once: true });
+    signal.addEventListener("abort", cleanup, { once: true });
+}
+// Compile-time guard: SDK users can pass the exact grant from `createSessionGrant()`.
+const _grantMediaPin = undefined;
+void _grantMediaPin;
+//# sourceMappingURL=media-session.js.map

package/dist/browser/media-session.js.map

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