realtime-avatar 0.1.0

package/dist/react/session.js

@@ -0,0 +1,322 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { AvatarPlayer } from "../browser/player";
+import { connectAvatarSessionMedia, } from "../browser/media-session";
+const EMPTY_METRICS = {
+    frames: 0,
+    droppedFrames: 0,
+    firstAudioMs: null,
+    firstVideoMs: null,
+    firstFrameDrawnMs: null,
+    audioQueueMs: 0,
+    audioUnderrunMs: 0,
+    width: null,
+    height: null,
+};
+/**
+ * Drop-in realtime avatar session for React. Owns prepare lifecycle + audio-
+ * clocked playback; bind `canvasRef` to a `<canvas>` and call `send`.
+ *
+ *     const avatar = useAvatarSession({ client, avatarId });
+ *     return <>
+ *       <canvas ref={avatar.canvasRef} />
+ *       <button onClick={() => avatar.send("hi")} disabled={!avatar.ready}>Send</button>
+ *     </>;
+ */
+export function useAvatarSession(options) {
+    const { client, autoPrepare = true, transport: transportMode = "auto", media = "auto", whep, waitForMedia, waitForMediaMs, connectTimeoutMs = 5_000, playoutDelayMs, avatarId, sourceKind, portraitUrl, sourceVideoUrl, videoCacheId, voiceId, backgroundId, turnDefaults, } = options;
+    const canvasRef = useRef(null);
+    const videoElementRef = useRef(null);
+    const playerRef = useRef(null);
+    const mediaConnectionRef = useRef(null);
+    const abortRef = useRef(null);
+    const prepareSeqRef = useRef(0);
+    const [status, setStatus] = useState("idle");
+    const [error, setError] = useState(null);
+    const [lastError, setLastError] = useState(null);
+    const [text, setText] = useState("");
+    const [prepared, setPrepared] = useState(null);
+    const [metrics, setMetrics] = useState(EMPTY_METRICS);
+    const [lastSummary, setLastSummary] = useState(null);
+    const [transport, setTransport] = useState("http");
+    const [mediaPlan, setMediaPlan] = useState(null);
+    const [mediaState, setMediaState] = useState("disabled");
+    const [mediaError, setMediaError] = useState(null);
+    const session = useMemo(() => client.session({
+        avatarId,
+        sourceKind,
+        portraitUrl,
+        sourceVideoUrl,
+        videoCacheId,
+        voiceId,
+        backgroundId,
+        turnDefaults,
+    }), [client, avatarId, sourceKind, portraitUrl, sourceVideoUrl, videoCacheId, voiceId, backgroundId, turnDefaults]);
+    function getPlayer() {
+        playerRef.current ??= new AvatarPlayer(playoutDelayMs ? { playoutDelayMs } : {});
+        playerRef.current.attach(canvasRef.current);
+        return playerRef.current;
+    }
+    const attachWhepPlaybackToCurrentVideo = useCallback((playback) => {
+        const video = videoElementRef.current;
+        if (!video)
+            return;
+        if (video.srcObject !== playback.stream)
+            video.srcObject = playback.stream;
+        video.muted = true;
+        video.playsInline = true;
+        void video.play().catch(() => undefined);
+        if (video.readyState >= HTMLMediaElement.HAVE_CURRENT_DATA)
+            setMediaState("playing");
+    }, []);
+    const videoRef = useCallback((node) => {
+        const previous = videoElementRef.current;
+        const playback = mediaConnectionRef.current?.mediaPlayback;
+        if (previous && previous !== node && playback && previous.srcObject === playback.stream) {
+            previous.srcObject = null;
+        }
+        videoElementRef.current = node;
+        if (node && playback)
+            attachWhepPlaybackToCurrentVideo(playback);
+    }, [attachWhepPlaybackToCurrentVideo]);
+    const closeMediaConnection = useCallback(async () => {
+        const connection = mediaConnectionRef.current;
+        mediaConnectionRef.current = null;
+        const playback = connection?.mediaPlayback;
+        const video = videoElementRef.current;
+        if (playback && video?.srcObject === playback.stream)
+            video.srcObject = null;
+        await connection?.close();
+    }, []);
+    const prepare = useCallback(async (prepareOptions = {}) => {
+        const seq = (prepareSeqRef.current += 1);
+        const isCurrent = () => seq === prepareSeqRef.current && !prepareOptions.signal?.aborted;
+        setStatus("preparing");
+        setError(null);
+        setLastError(null);
+        setMediaError(null);
+        setLastSummary(null);
+        setPrepared(null);
+        await closeMediaConnection();
+        try {
+            let preparedResponse;
+            if (transportMode === "auto") {
+                // Socket first (one GPU container for the whole session); HTTP turns
+                // remain the costless fallback when the socket cannot be established.
+                try {
+                    const connection = await withAbortableDeadline((signal) => connectAvatarSessionMedia(session, {
+                        video: videoElementRef.current,
+                        media,
+                        signal,
+                        whep,
+                        waitForMedia,
+                        waitForMediaMs,
+                        onMediaState: (event) => {
+                            if (!isCurrent())
+                                return;
+                            setMediaState(event.state);
+                            setMediaError(event.error?.message ?? null);
+                        },
+                    }), connectTimeoutMs, prepareOptions.signal);
+                    if (!isCurrent()) {
+                        await connection.close();
+                        return;
+                    }
+                    mediaConnectionRef.current = connection;
+                    preparedResponse = connection.prepared;
+                    setMediaPlan(connection.media);
+                    void connection.mediaReady
+                        .then((playback) => {
+                        if (isCurrent() && mediaConnectionRef.current === connection && playback) {
+                            attachWhepPlaybackToCurrentVideo(playback);
+                        }
+                    })
+                        .catch(() => undefined);
+                }
+                catch {
+                    if (!isCurrent())
+                        return;
+                    session.disconnect();
+                    preparedResponse = await session.prepare({ signal: prepareOptions.signal });
+                    setMediaPlan(null);
+                    setMediaState("disabled");
+                }
+            }
+            else {
+                preparedResponse = await session.prepare({ signal: prepareOptions.signal });
+                setMediaPlan(null);
+                setMediaState("disabled");
+            }
+            if (!isCurrent())
+                return;
+            setPrepared(preparedResponse);
+            setTransport(session.transport);
+            setStatus("ready");
+        }
+        catch (err) {
+            if (!isCurrent())
+                return;
+            setStatus("error");
+            setLastError(err);
+            setError(err instanceof Error ? err.message : "Avatar prepare failed");
+        }
+    }, [attachWhepPlaybackToCurrentVideo, closeMediaConnection, connectTimeoutMs, media, session, transportMode, waitForMedia, waitForMediaMs, whep]);
+    useEffect(() => {
+        if (!autoPrepare)
+            return;
+        void prepare();
+        return () => {
+            prepareSeqRef.current += 1;
+            void closeMediaConnection();
+            session.disconnect();
+        };
+    }, [autoPrepare, closeMediaConnection, prepare, session]);
+    useEffect(() => {
+        return () => {
+            prepareSeqRef.current += 1;
+            abortRef.current?.abort();
+            playerRef.current?.stop();
+            void closeMediaConnection();
+        };
+    }, [closeMediaConnection]);
+    const runTurn = useCallback(async (stream, signal) => {
+        setText("");
+        setMetrics(EMPTY_METRICS);
+        setLastSummary(null);
+        setStatus("thinking");
+        setError(null);
+        setLastError(null);
+        try {
+            const player = getPlayer();
+            const summary = await player.play(await stream, {
+                signal,
+                onText: (_delta, full) => setText(full),
+                onState: (state) => {
+                    if (state === "speaking")
+                        setStatus("speaking");
+                },
+                onMetrics: setMetrics,
+            });
+            if (!signal.aborted) {
+                setLastSummary(summary);
+                setMetrics(summary.metrics);
+                setStatus("ready");
+                return summary;
+            }
+            return null;
+        }
+        catch (err) {
+            if (signal.aborted)
+                return null;
+            setStatus("error");
+            setLastError(err);
+            setError(err instanceof Error ? err.message : "Realtime stream failed");
+            throw err;
+        }
+        finally {
+            setTransport(session.transport);
+        }
+    }, [session]);
+    const startTurn = useCallback((make) => {
+        abortRef.current?.abort();
+        const controller = new AbortController();
+        abortRef.current = controller;
+        return runTurn(make({ signal: controller.signal }), controller.signal);
+    }, [runTurn]);
+    const send = useCallback((message, turnOptions = {}) => startTurn((opts) => session.chat(message, {
+        ...opts,
+        history: turnOptions.history,
+        turn: turnOptions.turn,
+    })), [session, startTurn]);
+    const speak = useCallback((message, turnOptions = {}) => startTurn((opts) => session.speak(message, { ...opts, turn: turnOptions.turn })), [session, startTurn]);
+    const unlockAudio = useCallback(() => getPlayer().unlock(), []);
+    const captureAudioStream = useCallback(() => getPlayer().captureAudioStream(), []);
+    const stop = useCallback(() => {
+        abortRef.current?.abort();
+        abortRef.current = null;
+        // On the socket path this also tells the GPU to stop rendering frames
+        // nobody will play, while keeping the socket warm for the next turn.
+        void session.cancel();
+        playerRef.current?.stop();
+        setStatus((current) => (current === "thinking" || current === "speaking" ? "ready" : current));
+    }, [session]);
+    const disconnect = useCallback(() => {
+        prepareSeqRef.current += 1;
+        abortRef.current?.abort();
+        abortRef.current = null;
+        playerRef.current?.stop();
+        void closeMediaConnection();
+        session.disconnect();
+        setTransport("http");
+        setMediaState("disabled");
+        setPrepared(null);
+        setLastError(null);
+        setStatus("idle");
+    }, [closeMediaConnection, session]);
+    // A media provider may prewarm with black/silent frames so WHEP can finish
+    // SDP+ICE before the first turn. Do not let that idle media hide the poster:
+    // only consider WebRTC visually live once the mux/canvas path has drawn a
+    // real turn frame.
+    const webrtcLive = mediaState === "playing" && metrics.firstFrameDrawnMs !== null;
+    const canvasLive = metrics.firstFrameDrawnMs !== null && !webrtcLive;
+    return {
+        canvasRef,
+        videoRef,
+        videoElementRef,
+        status,
+        ready: status === "ready",
+        busy: status === "thinking" || status === "speaking",
+        error,
+        lastError,
+        text,
+        prepared,
+        metrics,
+        transport,
+        mediaPlan,
+        mediaState,
+        mediaError,
+        canvasLive,
+        webrtcLive,
+        lastSummary,
+        unlockAudio,
+        captureAudioStream,
+        send,
+        speak,
+        prepare,
+        stop,
+        disconnect,
+    };
+}
+function withAbortableDeadline(start, timeoutMs, parent) {
+    if (!timeoutMs || timeoutMs <= 0)
+        return start(parent ?? new AbortController().signal);
+    const controller = new AbortController();
+    const cleanupParent = linkAbort(parent, controller);
+    const work = start(controller.signal);
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            controller.abort();
+            cleanupParent();
+            reject(new Error("Realtime avatar session timed out"));
+        }, timeoutMs);
+        void work.then((value) => {
+            clearTimeout(timer);
+            cleanupParent();
+            resolve(value);
+        }, (error) => {
+            clearTimeout(timer);
+            cleanupParent();
+            reject(error);
+        });
+    });
+}
+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);
+}
+//# sourceMappingURL=session.js.map

package/dist/react/session.js.map

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

package/dist/react/stage.d.ts

@@ -0,0 +1,23 @@
+import type { CSSProperties, ReactElement, ReactNode } from "react";
+import type { UseAvatarSessionResult } from "./session";
+export type AvatarStageProps = {
+    session: UseAvatarSessionResult;
+    /** Idle loop shown until the first rendered frame (e.g. the FLF video). */
+    idleVideoUrl?: string | null;
+    /** Static poster shown when there is no idle video. */
+    portraitUrl?: string | null;
+    /** CSS object-fit for every visual layer. Default `cover`. */
+    fit?: CSSProperties["objectFit"];
+    objectPosition?: CSSProperties["objectPosition"];
+    className?: string;
+    style?: CSSProperties;
+    canvasStyle?: CSSProperties;
+    videoStyle?: CSSProperties;
+    posterStyle?: CSSProperties;
+    /** Quick transport/status chip while integrating; leave off in production UI. */
+    showDebugBadge?: boolean;
+    children?: ReactNode;
+};
+/** Minimal layered stage: idle video / portrait poster with live canvas + optional WHEP on top. */
+export declare function AvatarStage(props: AvatarStageProps): ReactElement;
+//# sourceMappingURL=stage.d.ts.map

package/dist/react/stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage.d.ts","sourceRoot":"","sources":["../../src/react/stage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACpE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAExD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,sBAAsB,CAAC;IAChC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,8DAA8D;IAC9D,GAAG,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IACjC,cAAc,CAAC,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,iFAAiF;IACjF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF,mGAAmG;AACnG,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,YAAY,CAiFjE"}

package/dist/react/stage.js

@@ -0,0 +1,62 @@
+import { createElement } from "react";
+/** Minimal layered stage: idle video / portrait poster with live canvas + optional WHEP on top. */
+export function AvatarStage(props) {
+    const { session, idleVideoUrl, portraitUrl, fit = "cover", objectPosition = "center", className, style, canvasStyle, videoStyle, posterStyle, showDebugBadge, children, } = props;
+    const live = session.canvasLive || session.webrtcLive;
+    const layerStyle = {
+        position: "absolute",
+        inset: 0,
+        width: "100%",
+        height: "100%",
+        objectFit: fit,
+        objectPosition,
+    };
+    const nodes = [];
+    if (idleVideoUrl) {
+        nodes.push(createElement("video", {
+            key: "idle",
+            src: idleVideoUrl,
+            autoPlay: true,
+            muted: true,
+            loop: true,
+            playsInline: true,
+            style: { ...layerStyle, opacity: live ? 0 : 1, transition: "opacity 200ms", ...videoStyle },
+        }));
+    }
+    else if (portraitUrl) {
+        nodes.push(createElement("img", { key: "portrait", src: portraitUrl, alt: "", style: { ...layerStyle, opacity: live ? 0 : 1, ...posterStyle } }));
+    }
+    nodes.push(createElement("canvas", {
+        key: "canvas",
+        ref: session.canvasRef,
+        style: { ...layerStyle, zIndex: 1, opacity: session.canvasLive ? 1 : 0, ...canvasStyle },
+    }));
+    nodes.push(createElement("video", {
+        key: "webrtc",
+        ref: session.videoRef,
+        autoPlay: true,
+        muted: true,
+        playsInline: true,
+        style: { ...layerStyle, zIndex: 2, opacity: session.webrtcLive ? 1 : 0, pointerEvents: "none", ...videoStyle },
+    }));
+    if (showDebugBadge) {
+        nodes.push(createElement("div", {
+            key: "debug",
+            style: {
+                position: "absolute",
+                right: 8,
+                bottom: 8,
+                zIndex: 3,
+                borderRadius: 999,
+                padding: "4px 8px",
+                background: "rgba(0,0,0,0.65)",
+                color: "white",
+                font: "12px/1.2 ui-monospace, SFMono-Regular, Menlo, monospace",
+            },
+        }, `${session.status} · ${session.transport}${session.mediaState !== "disabled" ? ` · ${session.mediaState}` : ""}`));
+    }
+    if (children)
+        nodes.push(createElement("div", { key: "children", style: { position: "absolute", inset: 0, zIndex: 4 } }, children));
+    return createElement("div", { className, style: { position: "relative", overflow: "hidden", ...style } }, nodes);
+}
+//# sourceMappingURL=stage.js.map

package/dist/react/stage.js.map

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

package/dist/schemas.d.ts

@@ -0,0 +1,59 @@
+import { z } from "zod";
+export declare const videoAvatarCacheManifestSchema: z.ZodObject<{
+    cache_id: z.ZodString;
+    source_video_url: z.ZodString;
+    storage_path: z.ZodString;
+    status: z.ZodOptional<z.ZodEnum<{
+        queued: "queued";
+        failed: "failed";
+        ready: "ready";
+        registering: "registering";
+        stale: "stale";
+    }>>;
+    n_frames: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    width: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    height: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    duration_seconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$loose>;
+export declare const realtimePrepareResponseSchema: z.ZodObject<{
+    avatar_id: z.ZodString;
+    status: z.ZodOptional<z.ZodLiteral<"ready">>;
+    source_kind: z.ZodOptional<z.ZodEnum<{
+        portrait: "portrait";
+        source_video: "source_video";
+    }>>;
+    registered: z.ZodOptional<z.ZodBoolean>;
+    timings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    video_cache: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        cache_id: z.ZodString;
+        source_video_url: z.ZodString;
+        storage_path: z.ZodString;
+        status: z.ZodOptional<z.ZodEnum<{
+            queued: "queued";
+            failed: "failed";
+            ready: "ready";
+            registering: "registering";
+            stale: "stale";
+        }>>;
+        n_frames: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        width: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        height: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        duration_seconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$loose>>>;
+    runtime: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        cold_start: z.ZodOptional<z.ZodBoolean>;
+        container_age_seconds: z.ZodOptional<z.ZodNumber>;
+        engine_load_seconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+export declare const artifactStatusSchema: z.ZodObject<{
+    artifacts_ready: z.ZodBoolean;
+    engines_ready: z.ZodBoolean;
+    manifest_exists: z.ZodBoolean;
+    manifest_path: z.ZodString;
+    storage_root: z.ZodString;
+}, z.core.$loose>;
+export declare const videoCachePlanResponseSchema: z.ZodObject<{}, z.core.$loose>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;iBAY3B,CAAC;AAEjB,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkB1B,CAAC;AAEjB,eAAO,MAAM,oBAAoB;;;;;;iBAQjB,CAAC;AAEjB,eAAO,MAAM,4BAA4B,gCAA6B,CAAC"}

package/dist/schemas.js

@@ -0,0 +1,58 @@
+// Runtime boundary validators for the JSON responses the client returns.
+//
+// SSOT note: the *types* still come from the generated OpenAPI schema
+// (`./generated/openapi`, derived from the Modal FastAPI/Pydantic app). These
+// Zod schemas only add a runtime check at the network boundary so a
+// contract-breaking response is caught instead of being blindly cast.
+//
+// To avoid re-creating a second source of truth, each schema:
+//   - validates only the *load-bearing* fields the client/consumers rely on,
+//   - `.passthrough()`es everything else so the full typed object flows through,
+//   - is pinned to the generated type via `assertConforms` below, so if the
+//     Pydantic contract changes a load-bearing field the TypeScript build breaks.
+import { z } from "zod";
+export const videoAvatarCacheManifestSchema = z
+    .object({
+    cache_id: z.string(),
+    source_video_url: z.string(),
+    storage_path: z.string(),
+    status: z.enum(["queued", "registering", "ready", "failed", "stale"]).optional(),
+    n_frames: z.number().nullable().optional(),
+    width: z.number().nullable().optional(),
+    height: z.number().nullable().optional(),
+    duration_seconds: z.number().nullable().optional(),
+    error: z.string().nullable().optional(),
+})
+    .passthrough();
+export const realtimePrepareResponseSchema = z
+    .object({
+    avatar_id: z.string(),
+    status: z.literal("ready").optional(),
+    source_kind: z.enum(["portrait", "source_video"]).optional(),
+    registered: z.boolean().optional(),
+    timings: z.record(z.string(), z.number()).optional(),
+    video_cache: videoAvatarCacheManifestSchema.nullable().optional(),
+    runtime: z
+        .object({
+        cold_start: z.boolean().optional(),
+        container_age_seconds: z.number().optional(),
+        engine_load_seconds: z.number().nullable().optional(),
+    })
+        .passthrough()
+        .nullable()
+        .optional(),
+})
+    .passthrough();
+export const artifactStatusSchema = z
+    .object({
+    artifacts_ready: z.boolean(),
+    engines_ready: z.boolean(),
+    manifest_exists: z.boolean(),
+    manifest_path: z.string(),
+    storage_root: z.string(),
+})
+    .passthrough();
+export const videoCachePlanResponseSchema = z.object({}).passthrough();
+const _pins = { manifest: true, prepare: true, artifacts: true, plan: true };
+void _pins;
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+export { RealtimeAvatarApiKeyError, assertRealtimeAvatarApiKeyActive, hashRealtimeAvatarApiKey, parseRealtimeAvatarApiKey, redactRealtimeAvatarApiKey, verifyRealtimeAvatarApiKeyHash, type ParsedRealtimeAvatarApiKey, type RealtimeAvatarApiKeyEnvironment, } from "./api-keys";
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,yBAAyB,EACzB,gCAAgC,EAChC,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,8BAA8B,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,+BAA+B,GACrC,MAAM,YAAY,CAAC"}

package/dist/server.js

@@ -0,0 +1,8 @@
+// Server-only entry. These helpers hash/verify API keys with a secret pepper
+// and are meant to run on YOUR backend (the platform), never shipped to a
+// browser or handed to API consumers. They are deliberately kept out of the
+// default client entry so the published SDK exposes no key-verification logic.
+//
+//   import { hashRealtimeAvatarApiKey } from "realtime-avatar/server";
+export { RealtimeAvatarApiKeyError, assertRealtimeAvatarApiKeyActive, hashRealtimeAvatarApiKey, parseRealtimeAvatarApiKey, redactRealtimeAvatarApiKey, verifyRealtimeAvatarApiKeyHash, } from "./api-keys";
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,0EAA0E;AAC1E,4EAA4E;AAC5E,+EAA+E;AAC/E,EAAE;AACF,uEAAuE;AACvE,OAAO,EACL,yBAAyB,EACzB,gCAAgC,EAChC,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,8BAA8B,GAG/B,MAAM,YAAY,CAAC"}