@runwayml/avatars-react 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RunwayML
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICES

@@ -0,0 +1,41 @@
+This project includes the following third-party dependencies:
+
+================================================================================
+livekit-client
+https://github.com/livekit/client-sdk-js
+--------------------------------------------------------------------------------
+Licensed under the Apache License, Version 2.0
+
+Copyright 2023 LiveKit, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+================================================================================
+@livekit/components-react
+https://github.com/livekit/components-js
+--------------------------------------------------------------------------------
+Licensed under the Apache License, Version 2.0
+
+Copyright 2023 LiveKit, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,328 @@
+# @runwayml/avatars-react
+
+React SDK for real-time AI avatar interactions with GWM-1.
+
+## Requirements
+
+- React 18+
+- A Runway API secret ([get one here](https://dev.runwayml.com/))
+- A server-side endpoint to create sessions (API secrets must not be exposed to the client)
+
+## Installation
+
+```bash
+npm install @runwayml/avatars-react
+```
+
+## Quick Start
+
+Add an avatar call to your app with just a few lines:
+
+```tsx
+import { AvatarCall } from '@runwayml/avatars-react';
+
+function App() {
+  return (
+    <AvatarCall
+      avatarId="game-host"
+      connectUrl="/api/avatar/connect"
+    />
+  );
+}
+```
+
+That's it! The component handles session creation, WebRTC connection, and renders a default UI with the avatar video and controls.
+
+You can use preset avatars like `game-host`, `coding-teacher`, `language-tutor`, and more. See the [Runway Developer Portal](https://dev.runwayml.com/) for the full list and creating custom avatars.
+
+### Optional: Add Default Styles
+
+Import the optional stylesheet for a polished look out of the box:
+
+```tsx
+import '@runwayml/avatars-react/styles.css';
+```
+
+The styles use CSS custom properties for easy customization:
+
+```css
+:root {
+  --avatar-bg: #a78bfa;           /* Video background color */
+  --avatar-radius: 16px;          /* Container border radius */
+  --avatar-control-size: 48px;    /* Control button size */
+  --avatar-end-call-bg: #ef4444;  /* End call button color */
+}
+```
+
+See [`examples/`](./examples) for complete working examples:
+- [`nextjs`](./examples/nextjs) - Next.js App Router
+- [`react-router`](./examples/react-router) - React Router v7 framework mode
+- [`express`](./examples/express) - Express + Vite
+
+## How It Works
+
+1. **Client** calls your server endpoint with the `avatarId`
+2. **Server** uses your Runway API secret to create a session via `@runwayml/sdk`
+3. **Server** returns connection credentials (token, URL) to the client
+4. **Client** establishes a WebRTC connection for real-time video/audio
+
+This flow keeps your API secret secure on the server while enabling low-latency communication.
+
+## Server Setup
+
+Your server endpoint receives the `avatarId` and returns session credentials. Use `@runwayml/sdk` to create the session:
+
+```ts
+// /api/avatar/connect (Next.js App Router example)
+import Runway from '@runwayml/sdk';
+
+const runway = new Runway(); // Uses RUNWAYML_API_SECRET env var
+
+export async function POST(req: Request) {
+  const { avatarId } = await req.json();
+
+  const session = await runway.realtime.sessions.create({
+    model: 'gwm1_avatars',
+    options: { avatar: avatarId },
+  });
+
+  return Response.json({
+    sessionId: session.id,
+    serverUrl: session.url,
+    token: session.token,
+    roomName: session.room_name,
+  });
+}
+```
+
+## Customization
+
+### Custom Connect Function
+
+For more control over the connection flow:
+
+```tsx
+<AvatarCall
+  avatarId="game-host"
+  connect={async (avatarId) => {
+    const res = await fetch('/api/avatar/connect', {
+      method: 'POST',
+      headers: {
+        'Authorization': `Bearer ${token}`,
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({ avatarId }),
+    });
+    return res.json();
+  }}
+/>
+```
+
+### Custom UI with Child Components
+
+Use the built-in components for custom layouts:
+
+```tsx
+import { AvatarCall, AvatarVideo, ControlBar, UserVideo } from '@runwayml/avatars-react';
+
+<AvatarCall avatarId="game-host" connectUrl="/api/avatar/connect">
+  <div className="call-layout">
+    <AvatarVideo className="avatar" />
+    <UserVideo className="self-view" />
+    <ControlBar className="controls" />
+  </div>
+</AvatarCall>
+```
+
+### Render Props
+
+All components support render props for complete control:
+
+```tsx
+<AvatarVideo>
+  {({ hasVideo, isConnecting, isSpeaking, trackRef }) => (
+    <div className={isSpeaking ? 'speaking' : ''}>
+      {isConnecting && <Spinner />}
+      {hasVideo && <VideoTrack trackRef={trackRef} />}
+    </div>
+  )}
+</AvatarVideo>
+```
+
+### CSS Styling with Data Attributes
+
+Style connection states with CSS:
+
+```tsx
+<AvatarCall avatarId="game-host" connectUrl="/api/avatar/connect" className="my-avatar" />
+```
+
+```css
+.my-avatar[data-state="connecting"] {
+  opacity: 0.5;
+}
+
+.my-avatar[data-state="error"] {
+  border: 2px solid red;
+}
+
+.my-avatar[data-state="connected"] {
+  border: 2px solid green;
+}
+```
+
+## Callbacks
+
+```tsx
+<AvatarCall
+  avatarId="game-host"
+  connectUrl="/api/avatar/connect"
+  onEnd={() => console.log('Call ended')}
+  onError={(error) => console.error('Error:', error)}
+/>
+```
+
+## Hooks
+
+Use hooks for custom components within an `AvatarCall` or `AvatarSession`:
+
+### useAvatarSession
+
+Access session state and controls:
+
+```tsx
+function MyComponent() {
+  const { state, sessionId, error, end } = useAvatarSession();
+
+  if (state === 'connecting') return <Loading />;
+  if (state === 'error') return <Error message={error.message} />;
+
+  return <button onClick={end}>End Call</button>;
+}
+```
+
+### useAvatar
+
+Access the remote avatar's video/audio:
+
+```tsx
+function CustomAvatar() {
+  const { videoTrackRef, isSpeaking, hasVideo, hasAudio } = useAvatar();
+
+  return (
+    <div data-speaking={isSpeaking}>
+      {hasVideo && <VideoTrack trackRef={videoTrackRef} />}
+    </div>
+  );
+}
+```
+
+### useLocalMedia
+
+Control local camera and microphone:
+
+```tsx
+function MediaControls() {
+  const {
+    isMicEnabled,
+    isCameraEnabled,
+    toggleMic,
+    toggleCamera,
+    toggleScreenShare,
+  } = useLocalMedia();
+
+  return (
+    <div>
+      <button onClick={toggleMic}>{isMicEnabled ? 'Mute' : 'Unmute'}</button>
+      <button onClick={toggleCamera}>{isCameraEnabled ? 'Hide' : 'Show'}</button>
+    </div>
+  );
+}
+```
+
+## Advanced: AvatarSession
+
+For full control over session management, use `AvatarSession` directly with pre-fetched credentials:
+
+```tsx
+import { AvatarSession, AvatarVideo, ControlBar } from '@runwayml/avatars-react';
+
+function AdvancedUsage({ credentials }) {
+  return (
+    <AvatarSession
+      credentials={credentials}
+      audio={true}
+      video={true}
+      onEnd={() => console.log('Ended')}
+      onError={(err) => console.error(err)}
+    >
+      <AvatarVideo />
+      <ControlBar />
+    </AvatarSession>
+  );
+}
+```
+
+## Components Reference
+
+| Component | Description |
+|-----------|-------------|
+| `AvatarCall` | High-level component that handles session creation |
+| `AvatarSession` | Low-level wrapper that requires credentials |
+| `AvatarVideo` | Renders the remote avatar video |
+| `UserVideo` | Renders the local user's camera |
+| `ControlBar` | Media control buttons (mic, camera, end call) |
+| `ScreenShareVideo` | Renders screen share content |
+| `AudioRenderer` | Handles avatar audio playback |
+
+## TypeScript
+
+All components and hooks are fully typed:
+
+```tsx
+import type {
+  AvatarCallProps,
+  SessionCredentials,
+  SessionState,
+} from '@runwayml/avatars-react';
+```
+
+## Browser Support
+
+This SDK uses WebRTC for real-time communication. Supported browsers:
+
+- Chrome 74+
+- Firefox 78+
+- Safari 14.1+
+- Edge 79+
+
+Users must grant camera and microphone permissions when prompted.
+
+## Troubleshooting
+
+**"Failed to connect" or timeout errors**
+- Verify your server endpoint is returning the correct credential format
+- Check that `RUNWAYML_API_SECRET` is set correctly on your server
+
+**No video/audio**
+- Ensure the user has granted camera/microphone permissions
+- Check browser console for WebRTC errors
+- Verify the device has a working camera/microphone
+
+**CORS errors**
+- Your server endpoint must accept requests from your client's origin
+- For local development, ensure both client and server are on compatible origins
+
+## Agent Skill
+
+This SDK includes an [Agent Skill](https://agentskills.io/) that teaches AI agents how to use the Runway Avatar SDK effectively. Install it with:
+
+```bash
+npx skills add runwayml/avatars-sdk-react
+```
+
+Once installed, AI coding assistants like Claude Code, Cursor, Cline, and others will have access to SDK documentation, patterns, and best practices when helping you build avatar-powered applications.
+
+## License
+
+MIT

package/dist/api.cjs

@@ -0,0 +1,52 @@
+'use strict';
+
+// src/api/config.ts
+var DEFAULT_BASE_URL = "https://api.dev.runwayml.com";
+function getBaseUrl() {
+  try {
+    const envUrl = process.env.RUNWAYML_BASE_URL;
+    if (envUrl) return envUrl;
+  } catch {
+  }
+  return DEFAULT_BASE_URL;
+}
+var config = null;
+function configure(options) {
+  config = { ...getConfig(), ...options };
+}
+function getConfig() {
+  if (!config) {
+    config = { baseUrl: getBaseUrl() };
+  }
+  return config;
+}
+function resetConfig() {
+  config = null;
+}
+
+// src/api/consume.ts
+async function consumeSession(options) {
+  const { sessionId, sessionKey, baseUrl = getConfig().baseUrl } = options;
+  const url = `${baseUrl}/v1/realtime_sessions/${sessionId}/consume`;
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${sessionKey}`
+    }
+  });
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(
+      `Failed to consume session: ${response.status} ${errorText}`
+    );
+  }
+  return response.json();
+}
+
+exports.configure = configure;
+exports.consumeSession = consumeSession;
+exports.getConfig = getConfig;
+exports.resetConfig = resetConfig;
+//# sourceMappingURL=api.cjs.map
+//# sourceMappingURL=api.cjs.map

package/dist/api.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/api/config.ts","../src/api/consume.ts"],"names":[],"mappings":";;;AAIA,IAAM,gBAAA,GAAmB,8BAAA;AAEzB,SAAS,UAAA,GAAqB;AAC5B,EAAA,IAAI;AACF,IAAA,MAAM,MAAA,GAAS,QAAQ,GAAA,CAAI,iBAAA;AAC3B,IAAA,IAAI,QAAQ,OAAO,MAAA;AAAA,EACrB,CAAA,CAAA,MAAQ;AAAA,EAER;AACA,EAAA,OAAO,gBAAA;AACT;AAEA,IAAI,MAAA,GAA2B,IAAA;AAExB,SAAS,UAAU,OAAA,EAAmC;AAC3D,EAAA,MAAA,GAAS,EAAE,GAAG,SAAA,EAAU,EAAG,GAAG,OAAA,EAAQ;AACxC;AAEO,SAAS,SAAA,GAAuB;AACrC,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAA,GAAS,EAAE,OAAA,EAAS,UAAA,EAAW,EAAE;AAAA,EACnC;AACA,EAAA,OAAO,MAAA;AACT;AAEO,SAAS,WAAA,GAAoB;AAClC,EAAA,MAAA,GAAS,IAAA;AACX;;;AC5BA,eAAsB,eACpB,OAAA,EACiC;AACjC,EAAA,MAAM,EAAE,SAAA,EAAW,UAAA,EAAY,UAAU,SAAA,EAAU,CAAE,SAAQ,GAAI,OAAA;AAEjE,EAAA,MAAM,GAAA,GAAM,CAAA,EAAG,OAAO,CAAA,sBAAA,EAAyB,SAAS,CAAA,QAAA,CAAA;AACxD,EAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,IAChC,MAAA,EAAQ,MAAA;AAAA,IACR,OAAA,EAAS;AAAA,MACP,cAAA,EAAgB,kBAAA;AAAA,MAChB,aAAA,EAAe,UAAU,UAAU,CAAA;AAAA;AACrC,GACD,CAAA;AAED,EAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,IAAA,MAAM,SAAA,GAAY,MAAM,QAAA,CAAS,IAAA,EAAK;AACtC,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,2BAAA,EAA8B,QAAA,CAAS,MAAM,CAAA,CAAA,EAAI,SAAS,CAAA;AAAA,KAC5D;AAAA,EACF;AAEA,EAAA,OAAO,SAAS,IAAA,EAAK;AACvB","file":"api.cjs","sourcesContent":["export interface ApiConfig {\n  baseUrl: string;\n}\n\nconst DEFAULT_BASE_URL = 'https://api.dev.runwayml.com';\n\nfunction getBaseUrl(): string {\n  try {\n    const envUrl = process.env.RUNWAYML_BASE_URL;\n    if (envUrl) return envUrl;\n  } catch {\n    // process not available in browser\n  }\n  return DEFAULT_BASE_URL;\n}\n\nlet config: ApiConfig | null = null;\n\nexport function configure(options: Partial<ApiConfig>): void {\n  config = { ...getConfig(), ...options };\n}\n\nexport function getConfig(): ApiConfig {\n  if (!config) {\n    config = { baseUrl: getBaseUrl() };\n  }\n  return config;\n}\n\nexport function resetConfig(): void {\n  config = null;\n}\n","import type { ConsumeSessionOptions, ConsumeSessionResponse } from '../types';\nimport { getConfig } from './config';\n\nexport async function consumeSession(\n  options: ConsumeSessionOptions,\n): Promise<ConsumeSessionResponse> {\n  const { sessionId, sessionKey, baseUrl = getConfig().baseUrl } = options;\n\n  const url = `${baseUrl}/v1/realtime_sessions/${sessionId}/consume`;\n  const response = await fetch(url, {\n    method: 'POST',\n    headers: {\n      'Content-Type': 'application/json',\n      Authorization: `Bearer ${sessionKey}`,\n    },\n  });\n\n  if (!response.ok) {\n    const errorText = await response.text();\n    throw new Error(\n      `Failed to consume session: ${response.status} ${errorText}`,\n    );\n  }\n\n  return response.json();\n}\n"]}

package/dist/api.d.cts

@@ -0,0 +1,33 @@
+/**
+ * Connection credentials returned from the Runway API consume endpoint
+ */
+interface ConsumeSessionResponse {
+    /** WebRTC server URL */
+    url: string;
+    /** Authentication token */
+    token: string;
+    /** Room name for the session */
+    roomName: string;
+}
+/**
+ * Options for consuming a session from the Runway API
+ */
+interface ConsumeSessionOptions {
+    /** The session ID to consume */
+    sessionId: string;
+    /** The session key for authentication (from GET session response when READY) */
+    sessionKey: string;
+    /** Optional base URL for the Runway API (defaults to production) */
+    baseUrl?: string;
+}
+
+interface ApiConfig {
+    baseUrl: string;
+}
+declare function configure(options: Partial<ApiConfig>): void;
+declare function getConfig(): ApiConfig;
+declare function resetConfig(): void;
+
+declare function consumeSession(options: ConsumeSessionOptions): Promise<ConsumeSessionResponse>;
+
+export { type ApiConfig, type ConsumeSessionOptions, type ConsumeSessionResponse, configure, consumeSession, getConfig, resetConfig };

package/dist/api.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Connection credentials returned from the Runway API consume endpoint
+ */
+interface ConsumeSessionResponse {
+    /** WebRTC server URL */
+    url: string;
+    /** Authentication token */
+    token: string;
+    /** Room name for the session */
+    roomName: string;
+}
+/**
+ * Options for consuming a session from the Runway API
+ */
+interface ConsumeSessionOptions {
+    /** The session ID to consume */
+    sessionId: string;
+    /** The session key for authentication (from GET session response when READY) */
+    sessionKey: string;
+    /** Optional base URL for the Runway API (defaults to production) */
+    baseUrl?: string;
+}
+
+interface ApiConfig {
+    baseUrl: string;
+}
+declare function configure(options: Partial<ApiConfig>): void;
+declare function getConfig(): ApiConfig;
+declare function resetConfig(): void;
+
+declare function consumeSession(options: ConsumeSessionOptions): Promise<ConsumeSessionResponse>;
+
+export { type ApiConfig, type ConsumeSessionOptions, type ConsumeSessionResponse, configure, consumeSession, getConfig, resetConfig };

package/dist/api.js

@@ -0,0 +1,47 @@
+// src/api/config.ts
+var DEFAULT_BASE_URL = "https://api.dev.runwayml.com";
+function getBaseUrl() {
+  try {
+    const envUrl = process.env.RUNWAYML_BASE_URL;
+    if (envUrl) return envUrl;
+  } catch {
+  }
+  return DEFAULT_BASE_URL;
+}
+var config = null;
+function configure(options) {
+  config = { ...getConfig(), ...options };
+}
+function getConfig() {
+  if (!config) {
+    config = { baseUrl: getBaseUrl() };
+  }
+  return config;
+}
+function resetConfig() {
+  config = null;
+}
+
+// src/api/consume.ts
+async function consumeSession(options) {
+  const { sessionId, sessionKey, baseUrl = getConfig().baseUrl } = options;
+  const url = `${baseUrl}/v1/realtime_sessions/${sessionId}/consume`;
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${sessionKey}`
+    }
+  });
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(
+      `Failed to consume session: ${response.status} ${errorText}`
+    );
+  }
+  return response.json();
+}
+
+export { configure, consumeSession, getConfig, resetConfig };
+//# sourceMappingURL=api.js.map
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/api/config.ts","../src/api/consume.ts"],"names":[],"mappings":";AAIA,IAAM,gBAAA,GAAmB,8BAAA;AAEzB,SAAS,UAAA,GAAqB;AAC5B,EAAA,IAAI;AACF,IAAA,MAAM,MAAA,GAAS,QAAQ,GAAA,CAAI,iBAAA;AAC3B,IAAA,IAAI,QAAQ,OAAO,MAAA;AAAA,EACrB,CAAA,CAAA,MAAQ;AAAA,EAER;AACA,EAAA,OAAO,gBAAA;AACT;AAEA,IAAI,MAAA,GAA2B,IAAA;AAExB,SAAS,UAAU,OAAA,EAAmC;AAC3D,EAAA,MAAA,GAAS,EAAE,GAAG,SAAA,EAAU,EAAG,GAAG,OAAA,EAAQ;AACxC;AAEO,SAAS,SAAA,GAAuB;AACrC,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAA,GAAS,EAAE,OAAA,EAAS,UAAA,EAAW,EAAE;AAAA,EACnC;AACA,EAAA,OAAO,MAAA;AACT;AAEO,SAAS,WAAA,GAAoB;AAClC,EAAA,MAAA,GAAS,IAAA;AACX;;;AC5BA,eAAsB,eACpB,OAAA,EACiC;AACjC,EAAA,MAAM,EAAE,SAAA,EAAW,UAAA,EAAY,UAAU,SAAA,EAAU,CAAE,SAAQ,GAAI,OAAA;AAEjE,EAAA,MAAM,GAAA,GAAM,CAAA,EAAG,OAAO,CAAA,sBAAA,EAAyB,SAAS,CAAA,QAAA,CAAA;AACxD,EAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,IAChC,MAAA,EAAQ,MAAA;AAAA,IACR,OAAA,EAAS;AAAA,MACP,cAAA,EAAgB,kBAAA;AAAA,MAChB,aAAA,EAAe,UAAU,UAAU,CAAA;AAAA;AACrC,GACD,CAAA;AAED,EAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,IAAA,MAAM,SAAA,GAAY,MAAM,QAAA,CAAS,IAAA,EAAK;AACtC,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,2BAAA,EAA8B,QAAA,CAAS,MAAM,CAAA,CAAA,EAAI,SAAS,CAAA;AAAA,KAC5D;AAAA,EACF;AAEA,EAAA,OAAO,SAAS,IAAA,EAAK;AACvB","file":"api.js","sourcesContent":["export interface ApiConfig {\n  baseUrl: string;\n}\n\nconst DEFAULT_BASE_URL = 'https://api.dev.runwayml.com';\n\nfunction getBaseUrl(): string {\n  try {\n    const envUrl = process.env.RUNWAYML_BASE_URL;\n    if (envUrl) return envUrl;\n  } catch {\n    // process not available in browser\n  }\n  return DEFAULT_BASE_URL;\n}\n\nlet config: ApiConfig | null = null;\n\nexport function configure(options: Partial<ApiConfig>): void {\n  config = { ...getConfig(), ...options };\n}\n\nexport function getConfig(): ApiConfig {\n  if (!config) {\n    config = { baseUrl: getBaseUrl() };\n  }\n  return config;\n}\n\nexport function resetConfig(): void {\n  config = null;\n}\n","import type { ConsumeSessionOptions, ConsumeSessionResponse } from '../types';\nimport { getConfig } from './config';\n\nexport async function consumeSession(\n  options: ConsumeSessionOptions,\n): Promise<ConsumeSessionResponse> {\n  const { sessionId, sessionKey, baseUrl = getConfig().baseUrl } = options;\n\n  const url = `${baseUrl}/v1/realtime_sessions/${sessionId}/consume`;\n  const response = await fetch(url, {\n    method: 'POST',\n    headers: {\n      'Content-Type': 'application/json',\n      Authorization: `Bearer ${sessionKey}`,\n    },\n  });\n\n  if (!response.ok) {\n    const errorText = await response.text();\n    throw new Error(\n      `Failed to consume session: ${response.status} ${errorText}`,\n    );\n  }\n\n  return response.json();\n}\n"]}