livekit-server-sdk 2.16.0 → 2.18.0

package/README.md

@@ -42,6 +42,8 @@ You may store credentials in environment variables. If api-key or api-secret is
 - `LIVEKIT_API_KEY`
 - `LIVEKIT_API_SECRET`
 
+`LiveKitAPI` additionally falls back to `LIVEKIT_URL` for the host and `LIVEKIT_TOKEN` for a pre-signed token. Values you pass explicitly take precedence; the environment variables are used only as a fallback for arguments you omit — an ambient `LIVEKIT_TOKEN`, for example, won't override an explicitly-provided API key and secret.
+
 ### Creating Access Tokens
 
 Creating a token for participant to join a room.
@@ -86,36 +88,101 @@ at.addGrant({
 
 This will allow the participant to subscribe to tracks, but not publish their own to the room.
 
+### Authentication
+
+Every request to the server APIs is authenticated. `LiveKitAPI` (and each service client) supports two modes:
+
+- **API key & secret** — recommended for backend use. The SDK signs a short-lived token per request from your key and secret. Keep your API secret on the server; never ship it to a client.
+- **Access token** — for frontend / client-side use, where the API secret must not be exposed. Pass a pre-signed [access token](https://docs.livekit.io/frontends/reference/tokens-grants/) that already carries the grants for the operations you'll perform; the SDK sends it verbatim. Mint it on your backend and hand it to the client.
+
+```typescript
+import { LiveKitAPI } from 'livekit-server-sdk';
+
+// Backend (API key & secret): set LIVEKIT_URL, LIVEKIT_API_KEY, and
+// LIVEKIT_API_SECRET as env vars, then construct with no arguments:
+const api = new LiveKitAPI();
+
+// ...or pass any of them explicitly to override the corresponding env var:
+const api = new LiveKitAPI({ host: 'https://my.livekit.host', apiKey: 'api-key', secret: 'secret-key' });
+
+// Frontend (pre-signed access token): with LIVEKIT_URL set, pass just the token
+// (or override the host too). Its grants must cover the calls you make.
+const api = new LiveKitAPI({ token });
+```
+
 ### Managing Rooms
 
-`RoomServiceClient` gives you APIs to list, create, and delete rooms. It also requires a pair of api key/secret key to operate.
+`LiveKitAPI` is a single entry point to every server API, exposing each service as a property: `room`, `egress`, `ingress`, `sip`, `agentDispatch`, and `connector`. Construct it with your credentials (see [Authentication](#authentication)).
+
+`RoomServiceClient`, reached via `api.room`, gives you APIs to list, create, and delete rooms and to moderate their participants.
 
 ```typescript
-import { Room, RoomServiceClient } from 'livekit-server-sdk';
+import { LiveKitAPI } from 'livekit-server-sdk';
 
-const livekitHost = 'https://my.livekit.host';
-const svc = new RoomServiceClient(livekitHost, 'api-key', 'secret-key');
+// authenticate with an API key and secret, or `{ token }` for a pre-signed token
+const api = new LiveKitAPI({
+  host: 'https://my.livekit.host',
+  apiKey: 'api-key',
+  secret: 'secret-key',
+});
 
 // list rooms
-svc.listRooms().then((rooms: Room[]) => {
-  console.log('existing rooms', rooms);
-});
+const rooms = await api.room.listRooms();
+console.log('existing rooms', rooms);
 
 // create a new room
-const opts = {
+const room = await api.room.createRoom({
   name: 'myroom',
-  // timeout in seconds
-  emptyTimeout: 10 * 60,
+  emptyTimeout: 10 * 60, // timeout in seconds
   maxParticipants: 20,
-};
-svc.createRoom(opts).then((room: Room) => {
-  console.log('room created', room);
 });
+console.log('room created', room);
 
 // delete a room
-svc.deleteRoom('myroom').then(() => {
-  console.log('room deleted');
+await api.room.deleteRoom('myroom');
+
+// other services are reached the same way, e.g. api.egress, api.sip
+await api.egress.listEgress({});
+```
+
+### Agent dispatch
+
+[Agent dispatch](https://docs.livekit.io/agents/server/agent-dispatch/) assigns an agent to a room. Explicit dispatch, via `api.agentDispatch`, gives you full control over when and how agents join and lets you pass job-specific metadata. The target agent is selected by its `agentName`, and the room is created if it doesn't exist. The example below reuses the `api` from above.
+
+```typescript
+// dispatch an agent into a room
+const dispatch = await api.agentDispatch.createDispatch('myroom', 'my-agent', {
+  metadata: '{}',
 });
+
+// list dispatches in a room
+const dispatches = await api.agentDispatch.listDispatch('myroom');
+
+// delete a dispatch
+await api.agentDispatch.deleteDispatch(dispatch.id, 'myroom');
+```
+
+### Error handling
+
+A failed server API call throws a `ServerError`, which carries the error `code`, `message`, and any server-provided `metadata`. SIP dialing calls throw a `SipCallError` (a `ServerError` subclass) that also exposes the SIP response status:
+
+```typescript
+import { ServerError, SipCallError } from 'livekit-server-sdk';
+
+try {
+  await api.sip.createSipParticipant('trunk-id', '+15105550100', 'my-room', {
+    waitUntilAnswered: true,
+  });
+} catch (e) {
+  if (e instanceof SipCallError) {
+    console.log(e.message); // e.g. "SIP call failed: 486 Busy Here (resource_exhausted)"
+    if (e.sipStatusCode === 486) {
+      // callee is busy
+    }
+  } else if (e instanceof ServerError) {
+    console.log(e.code, e.message); // any other API error
+  }
+}
 ```
 
 ## Webhooks

package/dist/AgentDispatchClient.cjs

@@ -33,9 +33,11 @@ class AgentDispatchClient extends import_ServiceBase.ServiceBase {
    * @param options - client options
    */
   constructor(host, apiKey, secret, options) {
-    super(apiKey, secret);
-    const rpcOptions = (options == null ? void 0 : options.requestTimeout) ? { requestTimeout: options.requestTimeout } : void 0;
-    this.rpc = new import_TwirpRPC.TwirpRpc(host, import_TwirpRPC.livekitPackage, rpcOptions);
+    super({ apiKey, secret, token: options == null ? void 0 : options.token });
+    this.rpc = new import_TwirpRPC.TwirpRpc(host, import_TwirpRPC.livekitPackage, {
+      requestTimeout: options == null ? void 0 : options.requestTimeout,
+      failover: options == null ? void 0 : options.failover
+    });
   }
   /**
    * Create an explicit dispatch for an agent to join a room. To use explicit

package/dist/AgentDispatchClient.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/AgentDispatchClient.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport {\n  AgentDispatch,\n  CreateAgentDispatchRequest,\n  DeleteAgentDispatchRequest,\n  type JobRestartPolicy,\n  ListAgentDispatchRequest,\n  ListAgentDispatchResponse,\n} from '@livekit/protocol';\nimport type { ClientOptions } from './ClientOptions.js';\nimport { ServiceBase } from './ServiceBase.js';\nimport { type Rpc, TwirpRpc, livekitPackage } from './TwirpRPC.js';\n\ninterface CreateDispatchOptions {\n  /** any custom data to send along with the job.\n   * note: this is different from room and participant metadata\n   */\n  metadata?: string;\n  /** controls whether the job should be restarted when it fails (cloud only) */\n  restartPolicy?: JobRestartPolicy;\n  /** optional deployment to dispatch to. Leave empty to target the production deployment. */\n  deployment?: string;\n}\n\nconst svc = 'AgentDispatchService';\n\n/**\n * Client to access Agent APIs\n */\nexport class AgentDispatchClient extends ServiceBase {\n  private readonly rpc: Rpc;\n\n  /**\n   * @param host - hostname including protocol. i.e. 'https://<project>.livekit.cloud'\n   * @param apiKey - API Key, can be set in env var LIVEKIT_API_KEY\n   * @param secret - API Secret, can be set in env var LIVEKIT_API_SECRET\n   * @param options - client options\n   */\n  constructor(host: string, apiKey?: string, secret?: string, options?: ClientOptions) {\n    super(apiKey, secret);\n    const rpcOptions = options?.requestTimeout\n      ? { requestTimeout: options.requestTimeout }\n      : undefined;\n    this.rpc = new TwirpRpc(host, livekitPackage, rpcOptions);\n  }\n\n  /**\n   * Create an explicit dispatch for an agent to join a room. To use explicit\n   * dispatch, your agent must be registered with an `agentName`.\n   * @param roomName - name of the room to dispatch to\n   * @param agentName - name of the agent to dispatch\n   * @param options - optional metadata to send along with the dispatch\n   * @returns the dispatch that was created\n   */\n  async createDispatch(\n    roomName: string,\n    agentName: string,\n    options?: CreateDispatchOptions,\n  ): Promise<AgentDispatch> {\n    const req = new CreateAgentDispatchRequest({\n      room: roomName,\n      agentName,\n      metadata: options?.metadata,\n      restartPolicy: options?.restartPolicy,\n      deployment: options?.deployment,\n    }).toJson();\n    const data = await this.rpc.request(\n      svc,\n      'CreateDispatch',\n      req,\n      await this.authHeader({ roomAdmin: true, room: roomName }),\n    );\n    return AgentDispatch.fromJson(data, { ignoreUnknownFields: true });\n  }\n\n  /**\n   * Delete an explicit dispatch for an agent in a room.\n   * @param dispatchId - id of the dispatch to delete\n   * @param roomName - name of the room the dispatch is for\n   */\n  async deleteDispatch(dispatchId: string, roomName: string): Promise<void> {\n    const req = new DeleteAgentDispatchRequest({\n      dispatchId,\n      room: roomName,\n    }).toJson();\n    await this.rpc.request(\n      svc,\n      'DeleteDispatch',\n      req,\n      await this.authHeader({ roomAdmin: true, room: roomName }),\n    );\n  }\n\n  /**\n   * Get an Agent dispatch by ID\n   * @param dispatchId - id of the dispatch to get\n   * @param roomName - name of the room the dispatch is for\n   * @returns the dispatch that was found, or undefined if not found\n   */\n  async getDispatch(dispatchId: string, roomName: string): Promise<AgentDispatch | undefined> {\n    const req = new ListAgentDispatchRequest({\n      dispatchId,\n      room: roomName,\n    }).toJson();\n    const data = await this.rpc.request(\n      svc,\n      'ListDispatch',\n      req,\n      await this.authHeader({ roomAdmin: true, room: roomName }),\n    );\n    const res = ListAgentDispatchResponse.fromJson(data, { ignoreUnknownFields: true });\n    if (res.agentDispatches.length === 0) {\n      return undefined;\n    }\n    return res.agentDispatches[0];\n  }\n\n  /**\n   * List all agent dispatches for a room\n   * @param roomName - name of the room to list dispatches for\n   * @returns the list of dispatches\n   */\n  async listDispatch(roomName: string): Promise<AgentDispatch[]> {\n    const req = new ListAgentDispatchRequest({\n      room: roomName,\n    }).toJson();\n    const data = await this.rpc.request(\n      svc,\n      'ListDispatch',\n      req,\n      await this.authHeader({ roomAdmin: true, room: roomName }),\n    );\n    const res = ListAgentDispatchResponse.fromJson(data, { ignoreUnknownFields: true });\n    return res.agentDispatches;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,sBAOO;AAEP,yBAA4B;AAC5B,sBAAmD;AAanD,MAAM,MAAM;AAKL,MAAM,4BAA4B,+BAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASnD,YAAY,MAAc,QAAiB,QAAiB,SAAyB;AACnF,UAAM,QAAQ,MAAM;AACpB,UAAM,cAAa,mCAAS,kBACxB,EAAE,gBAAgB,QAAQ,eAAe,IACzC;AACJ,SAAK,MAAM,IAAI,yBAAS,MAAM,gCAAgB,UAAU;AAAA,EAC1D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,eACJ,UACA,WACA,SACwB;AACxB,UAAM,MAAM,IAAI,2CAA2B;AAAA,MACzC,MAAM;AAAA,MACN;AAAA,MACA,UAAU,mCAAS;AAAA,MACnB,eAAe,mCAAS;AAAA,MACxB,YAAY,mCAAS;AAAA,IACvB,CAAC,EAAE,OAAO;AACV,UAAM,OAAO,MAAM,KAAK,IAAI;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AAAA,IAC3D;AACA,WAAO,8BAAc,SAAS,MAAM,EAAE,qBAAqB,KAAK,CAAC;AAAA,EACnE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,eAAe,YAAoB,UAAiC;AACxE,UAAM,MAAM,IAAI,2CAA2B;AAAA,MACzC;AAAA,MACA,MAAM;AAAA,IACR,CAAC,EAAE,OAAO;AACV,UAAM,KAAK,IAAI;AAAA,MACb;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AAAA,IAC3D;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,YAAY,YAAoB,UAAsD;AAC1F,UAAM,MAAM,IAAI,yCAAyB;AAAA,MACvC;AAAA,MACA,MAAM;AAAA,IACR,CAAC,EAAE,OAAO;AACV,UAAM,OAAO,MAAM,KAAK,IAAI;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AAAA,IAC3D;AACA,UAAM,MAAM,0CAA0B,SAAS,MAAM,EAAE,qBAAqB,KAAK,CAAC;AAClF,QAAI,IAAI,gBAAgB,WAAW,GAAG;AACpC,aAAO;AAAA,IACT;AACA,WAAO,IAAI,gBAAgB,CAAC;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,aAAa,UAA4C;AAC7D,UAAM,MAAM,IAAI,yCAAyB;AAAA,MACvC,MAAM;AAAA,IACR,CAAC,EAAE,OAAO;AACV,UAAM,OAAO,MAAM,KAAK,IAAI;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AAAA,IAC3D;AACA,UAAM,MAAM,0CAA0B,SAAS,MAAM,EAAE,qBAAqB,KAAK,CAAC;AAClF,WAAO,IAAI;AAAA,EACb;AACF;","names":[]}
+{"version":3,"sources":["../src/AgentDispatchClient.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport {\n  AgentDispatch,\n  CreateAgentDispatchRequest,\n  DeleteAgentDispatchRequest,\n  type JobRestartPolicy,\n  ListAgentDispatchRequest,\n  ListAgentDispatchResponse,\n} from '@livekit/protocol';\nimport type { ClientOptions } from './ClientOptions.js';\nimport { ServiceBase } from './ServiceBase.js';\nimport { type Rpc, TwirpRpc, livekitPackage } from './TwirpRPC.js';\n\ninterface CreateDispatchOptions {\n  /** any custom data to send along with the job.\n   * note: this is different from room and participant metadata\n   */\n  metadata?: string;\n  /** controls whether the job should be restarted when it fails (cloud only) */\n  restartPolicy?: JobRestartPolicy;\n  /** optional deployment to dispatch to. Leave empty to target the production deployment. */\n  deployment?: string;\n}\n\nconst svc = 'AgentDispatchService';\n\n/**\n * Client to access Agent APIs\n */\nexport class AgentDispatchClient extends ServiceBase {\n  private readonly rpc: Rpc;\n\n  /**\n   * @param host - hostname including protocol. i.e. 'https://<project>.livekit.cloud'\n   * @param apiKey - API Key, can be set in env var LIVEKIT_API_KEY\n   * @param secret - API Secret, can be set in env var LIVEKIT_API_SECRET\n   * @param options - client options\n   */\n  constructor(host: string, apiKey?: string, secret?: string, options?: ClientOptions) {\n    super({ apiKey, secret, token: options?.token });\n    this.rpc = new TwirpRpc(host, livekitPackage, {\n      requestTimeout: options?.requestTimeout,\n      failover: options?.failover,\n    });\n  }\n\n  /**\n   * Create an explicit dispatch for an agent to join a room. To use explicit\n   * dispatch, your agent must be registered with an `agentName`.\n   * @param roomName - name of the room to dispatch to\n   * @param agentName - name of the agent to dispatch\n   * @param options - optional metadata to send along with the dispatch\n   * @returns the dispatch that was created\n   */\n  async createDispatch(\n    roomName: string,\n    agentName: string,\n    options?: CreateDispatchOptions,\n  ): Promise<AgentDispatch> {\n    const req = new CreateAgentDispatchRequest({\n      room: roomName,\n      agentName,\n      metadata: options?.metadata,\n      restartPolicy: options?.restartPolicy,\n      deployment: options?.deployment,\n    }).toJson();\n    const data = await this.rpc.request(\n      svc,\n      'CreateDispatch',\n      req,\n      await this.authHeader({ roomAdmin: true, room: roomName }),\n    );\n    return AgentDispatch.fromJson(data, { ignoreUnknownFields: true });\n  }\n\n  /**\n   * Delete an explicit dispatch for an agent in a room.\n   * @param dispatchId - id of the dispatch to delete\n   * @param roomName - name of the room the dispatch is for\n   */\n  async deleteDispatch(dispatchId: string, roomName: string): Promise<void> {\n    const req = new DeleteAgentDispatchRequest({\n      dispatchId,\n      room: roomName,\n    }).toJson();\n    await this.rpc.request(\n      svc,\n      'DeleteDispatch',\n      req,\n      await this.authHeader({ roomAdmin: true, room: roomName }),\n    );\n  }\n\n  /**\n   * Get an Agent dispatch by ID\n   * @param dispatchId - id of the dispatch to get\n   * @param roomName - name of the room the dispatch is for\n   * @returns the dispatch that was found, or undefined if not found\n   */\n  async getDispatch(dispatchId: string, roomName: string): Promise<AgentDispatch | undefined> {\n    const req = new ListAgentDispatchRequest({\n      dispatchId,\n      room: roomName,\n    }).toJson();\n    const data = await this.rpc.request(\n      svc,\n      'ListDispatch',\n      req,\n      await this.authHeader({ roomAdmin: true, room: roomName }),\n    );\n    const res = ListAgentDispatchResponse.fromJson(data, { ignoreUnknownFields: true });\n    if (res.agentDispatches.length === 0) {\n      return undefined;\n    }\n    return res.agentDispatches[0];\n  }\n\n  /**\n   * List all agent dispatches for a room\n   * @param roomName - name of the room to list dispatches for\n   * @returns the list of dispatches\n   */\n  async listDispatch(roomName: string): Promise<AgentDispatch[]> {\n    const req = new ListAgentDispatchRequest({\n      room: roomName,\n    }).toJson();\n    const data = await this.rpc.request(\n      svc,\n      'ListDispatch',\n      req,\n      await this.authHeader({ roomAdmin: true, room: roomName }),\n    );\n    const res = ListAgentDispatchResponse.fromJson(data, { ignoreUnknownFields: true });\n    return res.agentDispatches;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,sBAOO;AAEP,yBAA4B;AAC5B,sBAAmD;AAanD,MAAM,MAAM;AAKL,MAAM,4BAA4B,+BAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASnD,YAAY,MAAc,QAAiB,QAAiB,SAAyB;AACnF,UAAM,EAAE,QAAQ,QAAQ,OAAO,mCAAS,MAAM,CAAC;AAC/C,SAAK,MAAM,IAAI,yBAAS,MAAM,gCAAgB;AAAA,MAC5C,gBAAgB,mCAAS;AAAA,MACzB,UAAU,mCAAS;AAAA,IACrB,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,eACJ,UACA,WACA,SACwB;AACxB,UAAM,MAAM,IAAI,2CAA2B;AAAA,MACzC,MAAM;AAAA,MACN;AAAA,MACA,UAAU,mCAAS;AAAA,MACnB,eAAe,mCAAS;AAAA,MACxB,YAAY,mCAAS;AAAA,IACvB,CAAC,EAAE,OAAO;AACV,UAAM,OAAO,MAAM,KAAK,IAAI;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AAAA,IAC3D;AACA,WAAO,8BAAc,SAAS,MAAM,EAAE,qBAAqB,KAAK,CAAC;AAAA,EACnE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,eAAe,YAAoB,UAAiC;AACxE,UAAM,MAAM,IAAI,2CAA2B;AAAA,MACzC;AAAA,MACA,MAAM;AAAA,IACR,CAAC,EAAE,OAAO;AACV,UAAM,KAAK,IAAI;AAAA,MACb;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AAAA,IAC3D;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,YAAY,YAAoB,UAAsD;AAC1F,UAAM,MAAM,IAAI,yCAAyB;AAAA,MACvC;AAAA,MACA,MAAM;AAAA,IACR,CAAC,EAAE,OAAO;AACV,UAAM,OAAO,MAAM,KAAK,IAAI;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AAAA,IAC3D;AACA,UAAM,MAAM,0CAA0B,SAAS,MAAM,EAAE,qBAAqB,KAAK,CAAC;AAClF,QAAI,IAAI,gBAAgB,WAAW,GAAG;AACpC,aAAO;AAAA,IACT;AACA,WAAO,IAAI,gBAAgB,CAAC;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,aAAa,UAA4C;AAC7D,UAAM,MAAM,IAAI,yCAAyB;AAAA,MACvC,MAAM;AAAA,IACR,CAAC,EAAE,OAAO;AACV,UAAM,OAAO,MAAM,KAAK,IAAI;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AAAA,IAC3D;AACA,UAAM,MAAM,0CAA0B,SAAS,MAAM,EAAE,qBAAqB,KAAK,CAAC;AAClF,WAAO,IAAI;AAAA,EACb;AACF;","names":[]}

package/dist/AgentDispatchClient.js

@@ -16,9 +16,11 @@ class AgentDispatchClient extends ServiceBase {
    * @param options - client options
    */
   constructor(host, apiKey, secret, options) {
-    super(apiKey, secret);
-    const rpcOptions = (options == null ? void 0 : options.requestTimeout) ? { requestTimeout: options.requestTimeout } : void 0;
-    this.rpc = new TwirpRpc(host, livekitPackage, rpcOptions);
+    super({ apiKey, secret, token: options == null ? void 0 : options.token });
+    this.rpc = new TwirpRpc(host, livekitPackage, {
+      requestTimeout: options == null ? void 0 : options.requestTimeout,
+      failover: options == null ? void 0 : options.failover
+    });
   }
   /**
    * Create an explicit dispatch for an agent to join a room. To use explicit

package/dist/AgentDispatchClient.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/AgentDispatchClient.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport {\n  AgentDispatch,\n  CreateAgentDispatchRequest,\n  DeleteAgentDispatchRequest,\n  type JobRestartPolicy,\n  ListAgentDispatchRequest,\n  ListAgentDispatchResponse,\n} from '@livekit/protocol';\nimport type { ClientOptions } from './ClientOptions.js';\nimport { ServiceBase } from './ServiceBase.js';\nimport { type Rpc, TwirpRpc, livekitPackage } from './TwirpRPC.js';\n\ninterface CreateDispatchOptions {\n  /** any custom data to send along with the job.\n   * note: this is different from room and participant metadata\n   */\n  metadata?: string;\n  /** controls whether the job should be restarted when it fails (cloud only) */\n  restartPolicy?: JobRestartPolicy;\n  /** optional deployment to dispatch to. Leave empty to target the production deployment. */\n  deployment?: string;\n}\n\nconst svc = 'AgentDispatchService';\n\n/**\n * Client to access Agent APIs\n */\nexport class AgentDispatchClient extends ServiceBase {\n  private readonly rpc: Rpc;\n\n  /**\n   * @param host - hostname including protocol. i.e. 'https://<project>.livekit.cloud'\n   * @param apiKey - API Key, can be set in env var LIVEKIT_API_KEY\n   * @param secret - API Secret, can be set in env var LIVEKIT_API_SECRET\n   * @param options - client options\n   */\n  constructor(host: string, apiKey?: string, secret?: string, options?: ClientOptions) {\n    super(apiKey, secret);\n    const rpcOptions = options?.requestTimeout\n      ? { requestTimeout: options.requestTimeout }\n      : undefined;\n    this.rpc = new TwirpRpc(host, livekitPackage, rpcOptions);\n  }\n\n  /**\n   * Create an explicit dispatch for an agent to join a room. To use explicit\n   * dispatch, your agent must be registered with an `agentName`.\n   * @param roomName - name of the room to dispatch to\n   * @param agentName - name of the agent to dispatch\n   * @param options - optional metadata to send along with the dispatch\n   * @returns the dispatch that was created\n   */\n  async createDispatch(\n    roomName: string,\n    agentName: string,\n    options?: CreateDispatchOptions,\n  ): Promise<AgentDispatch> {\n    const req = new CreateAgentDispatchRequest({\n      room: roomName,\n      agentName,\n      metadata: options?.metadata,\n      restartPolicy: options?.restartPolicy,\n      deployment: options?.deployment,\n    }).toJson();\n    const data = await this.rpc.request(\n      svc,\n      'CreateDispatch',\n      req,\n      await this.authHeader({ roomAdmin: true, room: roomName }),\n    );\n    return AgentDispatch.fromJson(data, { ignoreUnknownFields: true });\n  }\n\n  /**\n   * Delete an explicit dispatch for an agent in a room.\n   * @param dispatchId - id of the dispatch to delete\n   * @param roomName - name of the room the dispatch is for\n   */\n  async deleteDispatch(dispatchId: string, roomName: string): Promise<void> {\n    const req = new DeleteAgentDispatchRequest({\n      dispatchId,\n      room: roomName,\n    }).toJson();\n    await this.rpc.request(\n      svc,\n      'DeleteDispatch',\n      req,\n      await this.authHeader({ roomAdmin: true, room: roomName }),\n    );\n  }\n\n  /**\n   * Get an Agent dispatch by ID\n   * @param dispatchId - id of the dispatch to get\n   * @param roomName - name of the room the dispatch is for\n   * @returns the dispatch that was found, or undefined if not found\n   */\n  async getDispatch(dispatchId: string, roomName: string): Promise<AgentDispatch | undefined> {\n    const req = new ListAgentDispatchRequest({\n      dispatchId,\n      room: roomName,\n    }).toJson();\n    const data = await this.rpc.request(\n      svc,\n      'ListDispatch',\n      req,\n      await this.authHeader({ roomAdmin: true, room: roomName }),\n    );\n    const res = ListAgentDispatchResponse.fromJson(data, { ignoreUnknownFields: true });\n    if (res.agentDispatches.length === 0) {\n      return undefined;\n    }\n    return res.agentDispatches[0];\n  }\n\n  /**\n   * List all agent dispatches for a room\n   * @param roomName - name of the room to list dispatches for\n   * @returns the list of dispatches\n   */\n  async listDispatch(roomName: string): Promise<AgentDispatch[]> {\n    const req = new ListAgentDispatchRequest({\n      room: roomName,\n    }).toJson();\n    const data = await this.rpc.request(\n      svc,\n      'ListDispatch',\n      req,\n      await this.authHeader({ roomAdmin: true, room: roomName }),\n    );\n    const res = ListAgentDispatchResponse.fromJson(data, { ignoreUnknownFields: true });\n    return res.agentDispatches;\n  }\n}\n"],"mappings":"AAGA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,mBAAmB;AAC5B,SAAmB,UAAU,sBAAsB;AAanD,MAAM,MAAM;AAKL,MAAM,4BAA4B,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASnD,YAAY,MAAc,QAAiB,QAAiB,SAAyB;AACnF,UAAM,QAAQ,MAAM;AACpB,UAAM,cAAa,mCAAS,kBACxB,EAAE,gBAAgB,QAAQ,eAAe,IACzC;AACJ,SAAK,MAAM,IAAI,SAAS,MAAM,gBAAgB,UAAU;AAAA,EAC1D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,eACJ,UACA,WACA,SACwB;AACxB,UAAM,MAAM,IAAI,2BAA2B;AAAA,MACzC,MAAM;AAAA,MACN;AAAA,MACA,UAAU,mCAAS;AAAA,MACnB,eAAe,mCAAS;AAAA,MACxB,YAAY,mCAAS;AAAA,IACvB,CAAC,EAAE,OAAO;AACV,UAAM,OAAO,MAAM,KAAK,IAAI;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AAAA,IAC3D;AACA,WAAO,cAAc,SAAS,MAAM,EAAE,qBAAqB,KAAK,CAAC;AAAA,EACnE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,eAAe,YAAoB,UAAiC;AACxE,UAAM,MAAM,IAAI,2BAA2B;AAAA,MACzC;AAAA,MACA,MAAM;AAAA,IACR,CAAC,EAAE,OAAO;AACV,UAAM,KAAK,IAAI;AAAA,MACb;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AAAA,IAC3D;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,YAAY,YAAoB,UAAsD;AAC1F,UAAM,MAAM,IAAI,yBAAyB;AAAA,MACvC;AAAA,MACA,MAAM;AAAA,IACR,CAAC,EAAE,OAAO;AACV,UAAM,OAAO,MAAM,KAAK,IAAI;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AAAA,IAC3D;AACA,UAAM,MAAM,0BAA0B,SAAS,MAAM,EAAE,qBAAqB,KAAK,CAAC;AAClF,QAAI,IAAI,gBAAgB,WAAW,GAAG;AACpC,aAAO;AAAA,IACT;AACA,WAAO,IAAI,gBAAgB,CAAC;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,aAAa,UAA4C;AAC7D,UAAM,MAAM,IAAI,yBAAyB;AAAA,MACvC,MAAM;AAAA,IACR,CAAC,EAAE,OAAO;AACV,UAAM,OAAO,MAAM,KAAK,IAAI;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AAAA,IAC3D;AACA,UAAM,MAAM,0BAA0B,SAAS,MAAM,EAAE,qBAAqB,KAAK,CAAC;AAClF,WAAO,IAAI;AAAA,EACb;AACF;","names":[]}
+{"version":3,"sources":["../src/AgentDispatchClient.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport {\n  AgentDispatch,\n  CreateAgentDispatchRequest,\n  DeleteAgentDispatchRequest,\n  type JobRestartPolicy,\n  ListAgentDispatchRequest,\n  ListAgentDispatchResponse,\n} from '@livekit/protocol';\nimport type { ClientOptions } from './ClientOptions.js';\nimport { ServiceBase } from './ServiceBase.js';\nimport { type Rpc, TwirpRpc, livekitPackage } from './TwirpRPC.js';\n\ninterface CreateDispatchOptions {\n  /** any custom data to send along with the job.\n   * note: this is different from room and participant metadata\n   */\n  metadata?: string;\n  /** controls whether the job should be restarted when it fails (cloud only) */\n  restartPolicy?: JobRestartPolicy;\n  /** optional deployment to dispatch to. Leave empty to target the production deployment. */\n  deployment?: string;\n}\n\nconst svc = 'AgentDispatchService';\n\n/**\n * Client to access Agent APIs\n */\nexport class AgentDispatchClient extends ServiceBase {\n  private readonly rpc: Rpc;\n\n  /**\n   * @param host - hostname including protocol. i.e. 'https://<project>.livekit.cloud'\n   * @param apiKey - API Key, can be set in env var LIVEKIT_API_KEY\n   * @param secret - API Secret, can be set in env var LIVEKIT_API_SECRET\n   * @param options - client options\n   */\n  constructor(host: string, apiKey?: string, secret?: string, options?: ClientOptions) {\n    super({ apiKey, secret, token: options?.token });\n    this.rpc = new TwirpRpc(host, livekitPackage, {\n      requestTimeout: options?.requestTimeout,\n      failover: options?.failover,\n    });\n  }\n\n  /**\n   * Create an explicit dispatch for an agent to join a room. To use explicit\n   * dispatch, your agent must be registered with an `agentName`.\n   * @param roomName - name of the room to dispatch to\n   * @param agentName - name of the agent to dispatch\n   * @param options - optional metadata to send along with the dispatch\n   * @returns the dispatch that was created\n   */\n  async createDispatch(\n    roomName: string,\n    agentName: string,\n    options?: CreateDispatchOptions,\n  ): Promise<AgentDispatch> {\n    const req = new CreateAgentDispatchRequest({\n      room: roomName,\n      agentName,\n      metadata: options?.metadata,\n      restartPolicy: options?.restartPolicy,\n      deployment: options?.deployment,\n    }).toJson();\n    const data = await this.rpc.request(\n      svc,\n      'CreateDispatch',\n      req,\n      await this.authHeader({ roomAdmin: true, room: roomName }),\n    );\n    return AgentDispatch.fromJson(data, { ignoreUnknownFields: true });\n  }\n\n  /**\n   * Delete an explicit dispatch for an agent in a room.\n   * @param dispatchId - id of the dispatch to delete\n   * @param roomName - name of the room the dispatch is for\n   */\n  async deleteDispatch(dispatchId: string, roomName: string): Promise<void> {\n    const req = new DeleteAgentDispatchRequest({\n      dispatchId,\n      room: roomName,\n    }).toJson();\n    await this.rpc.request(\n      svc,\n      'DeleteDispatch',\n      req,\n      await this.authHeader({ roomAdmin: true, room: roomName }),\n    );\n  }\n\n  /**\n   * Get an Agent dispatch by ID\n   * @param dispatchId - id of the dispatch to get\n   * @param roomName - name of the room the dispatch is for\n   * @returns the dispatch that was found, or undefined if not found\n   */\n  async getDispatch(dispatchId: string, roomName: string): Promise<AgentDispatch | undefined> {\n    const req = new ListAgentDispatchRequest({\n      dispatchId,\n      room: roomName,\n    }).toJson();\n    const data = await this.rpc.request(\n      svc,\n      'ListDispatch',\n      req,\n      await this.authHeader({ roomAdmin: true, room: roomName }),\n    );\n    const res = ListAgentDispatchResponse.fromJson(data, { ignoreUnknownFields: true });\n    if (res.agentDispatches.length === 0) {\n      return undefined;\n    }\n    return res.agentDispatches[0];\n  }\n\n  /**\n   * List all agent dispatches for a room\n   * @param roomName - name of the room to list dispatches for\n   * @returns the list of dispatches\n   */\n  async listDispatch(roomName: string): Promise<AgentDispatch[]> {\n    const req = new ListAgentDispatchRequest({\n      room: roomName,\n    }).toJson();\n    const data = await this.rpc.request(\n      svc,\n      'ListDispatch',\n      req,\n      await this.authHeader({ roomAdmin: true, room: roomName }),\n    );\n    const res = ListAgentDispatchResponse.fromJson(data, { ignoreUnknownFields: true });\n    return res.agentDispatches;\n  }\n}\n"],"mappings":"AAGA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,mBAAmB;AAC5B,SAAmB,UAAU,sBAAsB;AAanD,MAAM,MAAM;AAKL,MAAM,4BAA4B,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASnD,YAAY,MAAc,QAAiB,QAAiB,SAAyB;AACnF,UAAM,EAAE,QAAQ,QAAQ,OAAO,mCAAS,MAAM,CAAC;AAC/C,SAAK,MAAM,IAAI,SAAS,MAAM,gBAAgB;AAAA,MAC5C,gBAAgB,mCAAS;AAAA,MACzB,UAAU,mCAAS;AAAA,IACrB,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,eACJ,UACA,WACA,SACwB;AACxB,UAAM,MAAM,IAAI,2BAA2B;AAAA,MACzC,MAAM;AAAA,MACN;AAAA,MACA,UAAU,mCAAS;AAAA,MACnB,eAAe,mCAAS;AAAA,MACxB,YAAY,mCAAS;AAAA,IACvB,CAAC,EAAE,OAAO;AACV,UAAM,OAAO,MAAM,KAAK,IAAI;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AAAA,IAC3D;AACA,WAAO,cAAc,SAAS,MAAM,EAAE,qBAAqB,KAAK,CAAC;AAAA,EACnE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,eAAe,YAAoB,UAAiC;AACxE,UAAM,MAAM,IAAI,2BAA2B;AAAA,MACzC;AAAA,MACA,MAAM;AAAA,IACR,CAAC,EAAE,OAAO;AACV,UAAM,KAAK,IAAI;AAAA,MACb;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AAAA,IAC3D;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,YAAY,YAAoB,UAAsD;AAC1F,UAAM,MAAM,IAAI,yBAAyB;AAAA,MACvC;AAAA,MACA,MAAM;AAAA,IACR,CAAC,EAAE,OAAO;AACV,UAAM,OAAO,MAAM,KAAK,IAAI;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AAAA,IAC3D;AACA,UAAM,MAAM,0BAA0B,SAAS,MAAM,EAAE,qBAAqB,KAAK,CAAC;AAClF,QAAI,IAAI,gBAAgB,WAAW,GAAG;AACpC,aAAO;AAAA,IACT;AACA,WAAO,IAAI,gBAAgB,CAAC;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,aAAa,UAA4C;AAC7D,UAAM,MAAM,IAAI,yBAAyB;AAAA,MACvC,MAAM;AAAA,IACR,CAAC,EAAE,OAAO;AACV,UAAM,OAAO,MAAM,KAAK,IAAI;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AAAA,IAC3D;AACA,UAAM,MAAM,0BAA0B,SAAS,MAAM,EAAE,qBAAqB,KAAK,CAAC;AAClF,WAAO,IAAI;AAAA,EACb;AACF;","names":[]}

package/dist/ClientOptions.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/ClientOptions.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Options common to all clients\n */\nexport type ClientOptions = {\n  /**\n   * Optional timeout, in seconds, for all server requests\n   */\n  requestTimeout?: number;\n};\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../src/ClientOptions.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Options common to all clients\n */\nexport type ClientOptions = {\n  /**\n   * Optional timeout, in seconds, for all server requests\n   */\n  requestTimeout?: number;\n  /**\n   * Whether to fail over to alternative regions on retryable errors (LiveKit\n   * Cloud hosts only). Defaults to true; set to false to disable.\n   */\n  failover?: boolean;\n  /**\n   * A pre-signed access token, sent verbatim as the Authorization header on\n   * every request instead of signing one per call from an API key and secret.\n   * The token must already carry the grants for the calls it's used with; since\n   * it needs no secret, the client can run client-side.\n   */\n  token?: string;\n};\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/ClientOptions.d.cts

@@ -6,6 +6,18 @@ type ClientOptions = {
      * Optional timeout, in seconds, for all server requests
      */
     requestTimeout?: number;
+    /**
+     * Whether to fail over to alternative regions on retryable errors (LiveKit
+     * Cloud hosts only). Defaults to true; set to false to disable.
+     */
+    failover?: boolean;
+    /**
+     * A pre-signed access token, sent verbatim as the Authorization header on
+     * every request instead of signing one per call from an API key and secret.
+     * The token must already carry the grants for the calls it's used with; since
+     * it needs no secret, the client can run client-side.
+     */
+    token?: string;
 };
 
 export type { ClientOptions };

package/dist/ClientOptions.d.ts

@@ -6,6 +6,18 @@ type ClientOptions = {
      * Optional timeout, in seconds, for all server requests
      */
     requestTimeout?: number;
+    /**
+     * Whether to fail over to alternative regions on retryable errors (LiveKit
+     * Cloud hosts only). Defaults to true; set to false to disable.
+     */
+    failover?: boolean;
+    /**
+     * A pre-signed access token, sent verbatim as the Authorization header on
+     * every request instead of signing one per call from an API key and secret.
+     * The token must already carry the grants for the calls it's used with; since
+     * it needs no secret, the client can run client-side.
+     */
+    token?: string;
 };
 
 export type { ClientOptions };

package/dist/ClientOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClientOptions.d.ts","sourceRoot":"","sources":["../src/ClientOptions.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC"}
+{"version":3,"file":"ClientOptions.d.ts","sourceRoot":"","sources":["../src/ClientOptions.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/dist/ConnectorClient.cjs

@@ -25,6 +25,7 @@ var import_protobuf = require("@bufbuild/protobuf");
 var import_protocol = require("@livekit/protocol");
 var import_ServiceBase = require("./ServiceBase.cjs");
 var import_TwirpRPC = require("./TwirpRPC.cjs");
+var import_dialTimeout = require("./dialTimeout.cjs");
 const svc = "Connector";
 class ConnectorClient extends import_ServiceBase.ServiceBase {
   /**
@@ -34,9 +35,11 @@ class ConnectorClient extends import_ServiceBase.ServiceBase {
    * @param options - client options
    */
   constructor(host, apiKey, secret, options) {
-    super(apiKey, secret);
-    const rpcOptions = (options == null ? void 0 : options.requestTimeout) ? { requestTimeout: options.requestTimeout } : void 0;
-    this.rpc = new import_TwirpRPC.TwirpRpc(host, import_TwirpRPC.livekitPackage, rpcOptions);
+    super({ apiKey, secret, token: options == null ? void 0 : options.token });
+    this.rpc = new import_TwirpRPC.TwirpRpc(host, import_TwirpRPC.livekitPackage, {
+      requestTimeout: options == null ? void 0 : options.requestTimeout,
+      failover: options == null ? void 0 : options.failover
+    });
   }
   /**
    * Initiate an outbound WhatsApp call
@@ -101,14 +104,15 @@ class ConnectorClient extends import_ServiceBase.ServiceBase {
       participantMetadata,
       participantAttributes: options.participantAttributes,
       destinationCountry,
-      ringingTimeout: options.ringingTimeout ? new import_protobuf.Duration({ seconds: BigInt(options.ringingTimeout) }) : void 0,
       waitUntilAnswered: options.waitUntilAnswered
     }).toJson();
+    const timeout = options.waitUntilAnswered ? options.timeout ?? import_dialTimeout.DEFAULT_RINGING_TIMEOUT_SECONDS : options.timeout;
     const data = await this.rpc.request(
       svc,
       "AcceptWhatsAppCall",
       req,
-      await this.authHeader({ roomCreate: true })
+      await this.authHeader({ roomCreate: true }),
+      timeout
     );
     return import_protocol.AcceptWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });
   }

package/dist/ConnectorClient.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/ConnectorClient.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { Duration } from '@bufbuild/protobuf';\nimport type {\n  ConnectTwilioCallRequest_TwilioCallDirection,\n  DisconnectWhatsAppCallRequest_DisconnectReason,\n  RoomAgentDispatch,\n  SessionDescription,\n} from '@livekit/protocol';\nimport {\n  AcceptWhatsAppCallRequest,\n  AcceptWhatsAppCallResponse,\n  ConnectTwilioCallRequest,\n  ConnectTwilioCallResponse,\n  ConnectWhatsAppCallRequest,\n  ConnectWhatsAppCallResponse,\n  DialWhatsAppCallRequest,\n  DialWhatsAppCallResponse,\n  DisconnectWhatsAppCallRequest,\n  DisconnectWhatsAppCallResponse,\n} from '@livekit/protocol';\nimport type { ClientOptions } from './ClientOptions.js';\nimport { ServiceBase } from './ServiceBase.js';\nimport { type Rpc, TwirpRpc, livekitPackage } from './TwirpRPC.js';\n\nconst svc = 'Connector';\n\n// WhatsApp types\nexport interface DialWhatsAppCallOptions {\n  /** Required - The identifier of the WhatsApp phone number that is initiating the call */\n  whatsappPhoneNumberId: string;\n  /** Required - The number of the user that is supposed to receive the call */\n  whatsappToPhoneNumber: string;\n  /** Required - The API key of the business that is initiating the call */\n  whatsappApiKey: string;\n  /** Required - WhatsApp Cloud API version, eg: 23.0, 24.0, etc. */\n  whatsappCloudApiVersion: string;\n  /** Optional - An arbitrary string you can pass in that is useful for tracking and logging purposes */\n  whatsappBizOpaqueCallbackData?: string;\n  /** Optional - What LiveKit room should this participant be connected to */\n  roomName?: string;\n  /** Optional - Agents to dispatch the call to */\n  agents?: RoomAgentDispatch[];\n  /** Optional - Identity of the participant in LiveKit room */\n  participantIdentity?: string;\n  /** Optional - Name of the participant in LiveKit room */\n  participantName?: string;\n  /** Optional - User-defined metadata. Will be attached to a created Participant in the room. */\n  participantMetadata?: string;\n  /** Optional - User-defined attributes. Will be attached to a created Participant in the room. */\n  participantAttributes?: { [key: string]: string };\n  /** Optional - Country where the call terminates as ISO 3166-1 alpha-2 */\n  destinationCountry?: string;\n  /** Optional - Max time in seconds for the callee to answer the call */\n  ringingTimeout?: number;\n}\n\nexport interface AcceptWhatsAppCallOptions {\n  /** Required - The identifier of the WhatsApp phone number that is connecting the call */\n  whatsappPhoneNumberId: string;\n  /** Required - The API key of the business that is connecting the call */\n  whatsappApiKey: string;\n  /** Required - WhatsApp Cloud API version, eg: 23.0, 24.0, etc. */\n  whatsappCloudApiVersion: string;\n  /** Required - Call ID sent by Meta */\n  whatsappCallId: string;\n  /** Optional - An arbitrary string you can pass in that is useful for tracking and logging purposes */\n  whatsappBizOpaqueCallbackData?: string;\n  /** Required - The call accept webhook comes with SDP from Meta */\n  sdp: SessionDescription;\n  /** Optional - What LiveKit room should this participant be connected to */\n  roomName?: string;\n  /** Optional - Agents to dispatch the call to */\n  agents?: RoomAgentDispatch[];\n  /** Optional - Identity of the participant in LiveKit room */\n  participantIdentity?: string;\n  /** Optional - Name of the participant in LiveKit room */\n  participantName?: string;\n  /** Optional - User-defined metadata. Will be attached to a created Participant in the room. */\n  participantMetadata?: string;\n  /** Optional - User-defined attributes. Will be attached to a created Participant in the room. */\n  participantAttributes?: { [key: string]: string };\n  /** Optional - Country where the call terminates as ISO 3166-1 alpha-2 */\n  destinationCountry?: string;\n  /** Optional - Max time in seconds for the callee to answer the call */\n  ringingTimeout?: number;\n  /** Optional - Wait for the call to be answered before returning */\n  waitUntilAnswered?: boolean;\n}\n\n// Twilio types\nexport interface ConnectTwilioCallOptions {\n  /** The direction of the call */\n  twilioCallDirection: ConnectTwilioCallRequest_TwilioCallDirection;\n  /** What LiveKit room should this call be connected to */\n  roomName: string;\n  /** Optional agents to dispatch the call to */\n  agents?: RoomAgentDispatch[];\n  /** Optional identity of the participant in LiveKit room */\n  participantIdentity?: string;\n  /** Optional name of the participant in LiveKit room */\n  participantName?: string;\n  /** Optional user-defined metadata. Will be attached to a created Participant in the room. */\n  participantMetadata?: string;\n  /** Optional user-defined attributes. Will be attached to a created Participant in the room. */\n  participantAttributes?: { [key: string]: string };\n  /** Country where the call terminates as ISO 3166-1 alpha-2 */\n  destinationCountry?: string;\n}\n\n/**\n * Client to access Connector APIs for WhatsApp and Twilio integrations\n */\nexport class ConnectorClient extends ServiceBase {\n  private readonly rpc: Rpc;\n\n  /**\n   * @param host - hostname including protocol. i.e. 'https://<project>.livekit.cloud'\n   * @param apiKey - API Key, can be set in env var LIVEKIT_API_KEY\n   * @param secret - API Secret, can be set in env var LIVEKIT_API_SECRET\n   * @param options - client options\n   */\n  constructor(host: string, apiKey?: string, secret?: string, options?: ClientOptions) {\n    super(apiKey, secret);\n    const rpcOptions = options?.requestTimeout\n      ? { requestTimeout: options.requestTimeout }\n      : undefined;\n    this.rpc = new TwirpRpc(host, livekitPackage, rpcOptions);\n  }\n\n  /**\n   * Initiate an outbound WhatsApp call\n   *\n   * @param options - WhatsApp call options\n   * @returns Promise containing the WhatsApp call ID and room name\n   */\n  async dialWhatsAppCall(options: DialWhatsAppCallOptions): Promise<DialWhatsAppCallResponse> {\n    const whatsappBizOpaqueCallbackData = options.whatsappBizOpaqueCallbackData || '';\n    const roomName = options.roomName || '';\n    const participantIdentity = options.participantIdentity || '';\n    const participantName = options.participantName || '';\n    const participantMetadata = options.participantMetadata || '';\n    const destinationCountry = options.destinationCountry || '';\n\n    const req = new DialWhatsAppCallRequest({\n      whatsappPhoneNumberId: options.whatsappPhoneNumberId,\n      whatsappToPhoneNumber: options.whatsappToPhoneNumber,\n      whatsappApiKey: options.whatsappApiKey,\n      whatsappCloudApiVersion: options.whatsappCloudApiVersion,\n      whatsappBizOpaqueCallbackData,\n      roomName,\n      agents: options.agents,\n      participantIdentity,\n      participantName,\n      participantMetadata,\n      participantAttributes: options.participantAttributes,\n      destinationCountry,\n      ringingTimeout: options.ringingTimeout\n        ? new Duration({ seconds: BigInt(options.ringingTimeout) })\n        : undefined,\n    }).toJson();\n\n    const data = await this.rpc.request(\n      svc,\n      'DialWhatsAppCall',\n      req,\n      await this.authHeader({ roomCreate: true }),\n    );\n    return DialWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });\n  }\n\n  /**\n   * Accept an inbound WhatsApp call\n   *\n   * @param options - WhatsApp call accept options\n   * @returns Promise containing the room name\n   */\n  async acceptWhatsAppCall(\n    options: AcceptWhatsAppCallOptions,\n  ): Promise<AcceptWhatsAppCallResponse> {\n    const whatsappBizOpaqueCallbackData = options.whatsappBizOpaqueCallbackData || '';\n    const roomName = options.roomName || '';\n    const participantIdentity = options.participantIdentity || '';\n    const participantName = options.participantName || '';\n    const participantMetadata = options.participantMetadata || '';\n    const destinationCountry = options.destinationCountry || '';\n\n    const req = new AcceptWhatsAppCallRequest({\n      whatsappPhoneNumberId: options.whatsappPhoneNumberId,\n      whatsappApiKey: options.whatsappApiKey,\n      whatsappCloudApiVersion: options.whatsappCloudApiVersion,\n      whatsappCallId: options.whatsappCallId,\n      whatsappBizOpaqueCallbackData,\n      sdp: options.sdp,\n      roomName,\n      agents: options.agents,\n      participantIdentity,\n      participantName,\n      participantMetadata,\n      participantAttributes: options.participantAttributes,\n      destinationCountry,\n      ringingTimeout: options.ringingTimeout\n        ? new Duration({ seconds: BigInt(options.ringingTimeout) })\n        : undefined,\n      waitUntilAnswered: options.waitUntilAnswered,\n    }).toJson();\n\n    const data = await this.rpc.request(\n      svc,\n      'AcceptWhatsAppCall',\n      req,\n      await this.authHeader({ roomCreate: true }),\n    );\n    return AcceptWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });\n  }\n\n  /**\n   * Connect an established WhatsApp call (used for business-initiated calls)\n   *\n   * @param whatsappCallId - Call ID sent by Meta\n   * @param sdp - Session description from Meta\n   */\n  async connectWhatsAppCall(\n    whatsappCallId: string,\n    sdp: SessionDescription,\n  ): Promise<ConnectWhatsAppCallResponse> {\n    const req = new ConnectWhatsAppCallRequest({\n      whatsappCallId,\n      sdp,\n    }).toJson();\n\n    const data = await this.rpc.request(\n      svc,\n      'ConnectWhatsAppCall',\n      req,\n      await this.authHeader({ roomCreate: true }),\n    );\n    return ConnectWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });\n  }\n\n  /**\n   * Disconnect an active WhatsApp call\n   *\n   * @param whatsappCallId - Call ID sent by Meta\n   * @param whatsappApiKey - The API key of the business that is disconnecting the call.\n   *   Required when `disconnectReason` is BUSINESS_INITIATED, optional for USER_INITIATED.\n   * @param disconnectReason - Optional reason for disconnecting the call. Defaults to BUSINESS_INITIATED.\n   */\n  async disconnectWhatsAppCall(\n    whatsappCallId: string,\n    whatsappApiKey: string,\n    disconnectReason?: DisconnectWhatsAppCallRequest_DisconnectReason,\n  ): Promise<DisconnectWhatsAppCallResponse> {\n    const req = new DisconnectWhatsAppCallRequest({\n      whatsappCallId,\n      whatsappApiKey,\n      disconnectReason,\n    }).toJson();\n\n    const data = await this.rpc.request(\n      svc,\n      'DisconnectWhatsAppCall',\n      req,\n      await this.authHeader({ roomCreate: true }),\n    );\n    return DisconnectWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });\n  }\n\n  /**\n   * Connect a Twilio call to a LiveKit room\n   *\n   * @param options - Twilio call connection options\n   * @returns Promise containing the WebSocket connect URL for Twilio media stream\n   */\n  async connectTwilioCall(options: ConnectTwilioCallOptions): Promise<ConnectTwilioCallResponse> {\n    const participantIdentity = options.participantIdentity || '';\n    const participantName = options.participantName || '';\n    const participantMetadata = options.participantMetadata || '';\n    const destinationCountry = options.destinationCountry || '';\n\n    const req = new ConnectTwilioCallRequest({\n      twilioCallDirection: options.twilioCallDirection,\n      roomName: options.roomName,\n      agents: options.agents,\n      participantIdentity,\n      participantName,\n      participantMetadata,\n      participantAttributes: options.participantAttributes,\n      destinationCountry,\n    }).toJson();\n\n    const data = await this.rpc.request(\n      svc,\n      'ConnectTwilioCall',\n      req,\n      await this.authHeader({ roomCreate: true }),\n    );\n    return ConnectTwilioCallResponse.fromJson(data, { ignoreUnknownFields: true });\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/ConnectorClient.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { Duration } from '@bufbuild/protobuf';\nimport type {\n  ConnectTwilioCallRequest_TwilioCallDirection,\n  DisconnectWhatsAppCallRequest_DisconnectReason,\n  RoomAgentDispatch,\n  SessionDescription,\n} from '@livekit/protocol';\nimport {\n  AcceptWhatsAppCallRequest,\n  AcceptWhatsAppCallResponse,\n  ConnectTwilioCallRequest,\n  ConnectTwilioCallResponse,\n  ConnectWhatsAppCallRequest,\n  ConnectWhatsAppCallResponse,\n  DialWhatsAppCallRequest,\n  DialWhatsAppCallResponse,\n  DisconnectWhatsAppCallRequest,\n  DisconnectWhatsAppCallResponse,\n} from '@livekit/protocol';\nimport type { ClientOptions } from './ClientOptions.js';\nimport { ServiceBase } from './ServiceBase.js';\nimport { type Rpc, TwirpRpc, livekitPackage } from './TwirpRPC.js';\nimport { DEFAULT_RINGING_TIMEOUT_SECONDS } from './dialTimeout.js';\n\nconst svc = 'Connector';\n\n// WhatsApp types\nexport interface DialWhatsAppCallOptions {\n  /** Required - The identifier of the WhatsApp phone number that is initiating the call */\n  whatsappPhoneNumberId: string;\n  /** Required - The number of the user that is supposed to receive the call */\n  whatsappToPhoneNumber: string;\n  /** Required - The API key of the business that is initiating the call */\n  whatsappApiKey: string;\n  /** Required - WhatsApp Cloud API version, eg: 23.0, 24.0, etc. */\n  whatsappCloudApiVersion: string;\n  /** Optional - An arbitrary string you can pass in that is useful for tracking and logging purposes */\n  whatsappBizOpaqueCallbackData?: string;\n  /** Optional - What LiveKit room should this participant be connected to */\n  roomName?: string;\n  /** Optional - Agents to dispatch the call to */\n  agents?: RoomAgentDispatch[];\n  /** Optional - Identity of the participant in LiveKit room */\n  participantIdentity?: string;\n  /** Optional - Name of the participant in LiveKit room */\n  participantName?: string;\n  /** Optional - User-defined metadata. Will be attached to a created Participant in the room. */\n  participantMetadata?: string;\n  /** Optional - User-defined attributes. Will be attached to a created Participant in the room. */\n  participantAttributes?: { [key: string]: string };\n  /** Optional - Country where the call terminates as ISO 3166-1 alpha-2 */\n  destinationCountry?: string;\n  /** Optional - Max time in seconds for the callee to answer the call */\n  ringingTimeout?: number;\n}\n\nexport interface AcceptWhatsAppCallOptions {\n  /** Required - The identifier of the WhatsApp phone number that is connecting the call */\n  whatsappPhoneNumberId: string;\n  /** Required - The API key of the business that is connecting the call */\n  whatsappApiKey: string;\n  /** Required - WhatsApp Cloud API version, eg: 23.0, 24.0, etc. */\n  whatsappCloudApiVersion: string;\n  /** Required - Call ID sent by Meta */\n  whatsappCallId: string;\n  /** Optional - An arbitrary string you can pass in that is useful for tracking and logging purposes */\n  whatsappBizOpaqueCallbackData?: string;\n  /** Required - The call accept webhook comes with SDP from Meta */\n  sdp: SessionDescription;\n  /** Optional - What LiveKit room should this participant be connected to */\n  roomName?: string;\n  /** Optional - Agents to dispatch the call to */\n  agents?: RoomAgentDispatch[];\n  /** Optional - Identity of the participant in LiveKit room */\n  participantIdentity?: string;\n  /** Optional - Name of the participant in LiveKit room */\n  participantName?: string;\n  /** Optional - User-defined metadata. Will be attached to a created Participant in the room. */\n  participantMetadata?: string;\n  /** Optional - User-defined attributes. Will be attached to a created Participant in the room. */\n  participantAttributes?: { [key: string]: string };\n  /** Optional - Country where the call terminates as ISO 3166-1 alpha-2 */\n  destinationCountry?: string;\n  /** Optional - Wait until the inbound party joins before returning. */\n  waitUntilAnswered?: boolean;\n  /**\n   * Optional - Request timeout in seconds. When `waitUntilAnswered` is set it\n   * defaults to the standard ring window; otherwise the client default applies.\n   */\n  timeout?: number;\n}\n\n// Twilio types\nexport interface ConnectTwilioCallOptions {\n  /** The direction of the call */\n  twilioCallDirection: ConnectTwilioCallRequest_TwilioCallDirection;\n  /** What LiveKit room should this call be connected to */\n  roomName: string;\n  /** Optional agents to dispatch the call to */\n  agents?: RoomAgentDispatch[];\n  /** Optional identity of the participant in LiveKit room */\n  participantIdentity?: string;\n  /** Optional name of the participant in LiveKit room */\n  participantName?: string;\n  /** Optional user-defined metadata. Will be attached to a created Participant in the room. */\n  participantMetadata?: string;\n  /** Optional user-defined attributes. Will be attached to a created Participant in the room. */\n  participantAttributes?: { [key: string]: string };\n  /** Country where the call terminates as ISO 3166-1 alpha-2 */\n  destinationCountry?: string;\n}\n\n/**\n * Client to access Connector APIs for WhatsApp and Twilio integrations\n */\nexport class ConnectorClient extends ServiceBase {\n  private readonly rpc: Rpc;\n\n  /**\n   * @param host - hostname including protocol. i.e. 'https://<project>.livekit.cloud'\n   * @param apiKey - API Key, can be set in env var LIVEKIT_API_KEY\n   * @param secret - API Secret, can be set in env var LIVEKIT_API_SECRET\n   * @param options - client options\n   */\n  constructor(host: string, apiKey?: string, secret?: string, options?: ClientOptions) {\n    super({ apiKey, secret, token: options?.token });\n    this.rpc = new TwirpRpc(host, livekitPackage, {\n      requestTimeout: options?.requestTimeout,\n      failover: options?.failover,\n    });\n  }\n\n  /**\n   * Initiate an outbound WhatsApp call\n   *\n   * @param options - WhatsApp call options\n   * @returns Promise containing the WhatsApp call ID and room name\n   */\n  async dialWhatsAppCall(options: DialWhatsAppCallOptions): Promise<DialWhatsAppCallResponse> {\n    const whatsappBizOpaqueCallbackData = options.whatsappBizOpaqueCallbackData || '';\n    const roomName = options.roomName || '';\n    const participantIdentity = options.participantIdentity || '';\n    const participantName = options.participantName || '';\n    const participantMetadata = options.participantMetadata || '';\n    const destinationCountry = options.destinationCountry || '';\n\n    const req = new DialWhatsAppCallRequest({\n      whatsappPhoneNumberId: options.whatsappPhoneNumberId,\n      whatsappToPhoneNumber: options.whatsappToPhoneNumber,\n      whatsappApiKey: options.whatsappApiKey,\n      whatsappCloudApiVersion: options.whatsappCloudApiVersion,\n      whatsappBizOpaqueCallbackData,\n      roomName,\n      agents: options.agents,\n      participantIdentity,\n      participantName,\n      participantMetadata,\n      participantAttributes: options.participantAttributes,\n      destinationCountry,\n      ringingTimeout: options.ringingTimeout\n        ? new Duration({ seconds: BigInt(options.ringingTimeout) })\n        : undefined,\n    }).toJson();\n\n    const data = await this.rpc.request(\n      svc,\n      'DialWhatsAppCall',\n      req,\n      await this.authHeader({ roomCreate: true }),\n    );\n    return DialWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });\n  }\n\n  /**\n   * Accept an inbound WhatsApp call\n   *\n   * @param options - WhatsApp call accept options\n   * @returns Promise containing the room name\n   */\n  async acceptWhatsAppCall(\n    options: AcceptWhatsAppCallOptions,\n  ): Promise<AcceptWhatsAppCallResponse> {\n    const whatsappBizOpaqueCallbackData = options.whatsappBizOpaqueCallbackData || '';\n    const roomName = options.roomName || '';\n    const participantIdentity = options.participantIdentity || '';\n    const participantName = options.participantName || '';\n    const participantMetadata = options.participantMetadata || '';\n    const destinationCountry = options.destinationCountry || '';\n\n    const req = new AcceptWhatsAppCallRequest({\n      whatsappPhoneNumberId: options.whatsappPhoneNumberId,\n      whatsappApiKey: options.whatsappApiKey,\n      whatsappCloudApiVersion: options.whatsappCloudApiVersion,\n      whatsappCallId: options.whatsappCallId,\n      whatsappBizOpaqueCallbackData,\n      sdp: options.sdp,\n      roomName,\n      agents: options.agents,\n      participantIdentity,\n      participantName,\n      participantMetadata,\n      participantAttributes: options.participantAttributes,\n      destinationCountry,\n      waitUntilAnswered: options.waitUntilAnswered,\n    }).toJson();\n\n    // When waiting for the inbound party to join, the request can block, so\n    // default the timeout to the standard ring window; otherwise the client\n    // default applies.\n    const timeout = options.waitUntilAnswered\n      ? (options.timeout ?? DEFAULT_RINGING_TIMEOUT_SECONDS)\n      : options.timeout;\n\n    const data = await this.rpc.request(\n      svc,\n      'AcceptWhatsAppCall',\n      req,\n      await this.authHeader({ roomCreate: true }),\n      timeout,\n    );\n    return AcceptWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });\n  }\n\n  /**\n   * Connect an established WhatsApp call (used for business-initiated calls)\n   *\n   * @param whatsappCallId - Call ID sent by Meta\n   * @param sdp - Session description from Meta\n   */\n  async connectWhatsAppCall(\n    whatsappCallId: string,\n    sdp: SessionDescription,\n  ): Promise<ConnectWhatsAppCallResponse> {\n    const req = new ConnectWhatsAppCallRequest({\n      whatsappCallId,\n      sdp,\n    }).toJson();\n\n    const data = await this.rpc.request(\n      svc,\n      'ConnectWhatsAppCall',\n      req,\n      await this.authHeader({ roomCreate: true }),\n    );\n    return ConnectWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });\n  }\n\n  /**\n   * Disconnect an active WhatsApp call\n   *\n   * @param whatsappCallId - Call ID sent by Meta\n   * @param whatsappApiKey - The API key of the business that is disconnecting the call.\n   *   Required when `disconnectReason` is BUSINESS_INITIATED, optional for USER_INITIATED.\n   * @param disconnectReason - Optional reason for disconnecting the call. Defaults to BUSINESS_INITIATED.\n   */\n  async disconnectWhatsAppCall(\n    whatsappCallId: string,\n    whatsappApiKey: string,\n    disconnectReason?: DisconnectWhatsAppCallRequest_DisconnectReason,\n  ): Promise<DisconnectWhatsAppCallResponse> {\n    const req = new DisconnectWhatsAppCallRequest({\n      whatsappCallId,\n      whatsappApiKey,\n      disconnectReason,\n    }).toJson();\n\n    const data = await this.rpc.request(\n      svc,\n      'DisconnectWhatsAppCall',\n      req,\n      await this.authHeader({ roomCreate: true }),\n    );\n    return DisconnectWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });\n  }\n\n  /**\n   * Connect a Twilio call to a LiveKit room\n   *\n   * @param options - Twilio call connection options\n   * @returns Promise containing the WebSocket connect URL for Twilio media stream\n   */\n  async connectTwilioCall(options: ConnectTwilioCallOptions): Promise<ConnectTwilioCallResponse> {\n    const participantIdentity = options.participantIdentity || '';\n    const participantName = options.participantName || '';\n    const participantMetadata = options.participantMetadata || '';\n    const destinationCountry = options.destinationCountry || '';\n\n    const req = new ConnectTwilioCallRequest({\n      twilioCallDirection: options.twilioCallDirection,\n      roomName: options.roomName,\n      agents: options.agents,\n      participantIdentity,\n      participantName,\n      participantMetadata,\n      participantAttributes: options.participantAttributes,\n      destinationCountry,\n    }).toJson();\n\n    const data = await this.rpc.request(\n      svc,\n      'ConnectTwilioCall',\n      req,\n      await this.authHeader({ roomCreate: true }),\n    );\n    return ConnectTwilioCallResponse.fromJson(data, { ignoreUnknownFields: true });\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,sBAAyB;AAOzB,sBAWO;AAEP,yBAA4B;AAC5B,sBAAmD;AACnD,yBAAgD;AAEhD,MAAM,MAAM;AA2FL,MAAM,wBAAwB,+BAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAS/C,YAAY,MAAc,QAAiB,QAAiB,SAAyB;AACnF,UAAM,EAAE,QAAQ,QAAQ,OAAO,mCAAS,MAAM,CAAC;AAC/C,SAAK,MAAM,IAAI,yBAAS,MAAM,gCAAgB;AAAA,MAC5C,gBAAgB,mCAAS;AAAA,MACzB,UAAU,mCAAS;AAAA,IACrB,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,iBAAiB,SAAqE;AAC1F,UAAM,gCAAgC,QAAQ,iCAAiC;AAC/E,UAAM,WAAW,QAAQ,YAAY;AACrC,UAAM,sBAAsB,QAAQ,uBAAuB;AAC3D,UAAM,kBAAkB,QAAQ,mBAAmB;AACnD,UAAM,sBAAsB,QAAQ,uBAAuB;AAC3D,UAAM,qBAAqB,QAAQ,sBAAsB;AAEzD,UAAM,MAAM,IAAI,wCAAwB;AAAA,MACtC,uBAAuB,QAAQ;AAAA,MAC/B,uBAAuB,QAAQ;AAAA,MAC/B,gBAAgB,QAAQ;AAAA,MACxB,yBAAyB,QAAQ;AAAA,MACjC;AAAA,MACA;AAAA,MACA,QAAQ,QAAQ;AAAA,MAChB;AAAA,MACA;AAAA,MACA;AAAA,MACA,uBAAuB,QAAQ;AAAA,MAC/B;AAAA,MACA,gBAAgB,QAAQ,iBACpB,IAAI,yBAAS,EAAE,SAAS,OAAO,QAAQ,cAAc,EAAE,CAAC,IACxD;AAAA,IACN,CAAC,EAAE,OAAO;AAEV,UAAM,OAAO,MAAM,KAAK,IAAI;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,YAAY,KAAK,CAAC;AAAA,IAC5C;AACA,WAAO,yCAAyB,SAAS,MAAM,EAAE,qBAAqB,KAAK,CAAC;AAAA,EAC9E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,mBACJ,SACqC;AACrC,UAAM,gCAAgC,QAAQ,iCAAiC;AAC/E,UAAM,WAAW,QAAQ,YAAY;AACrC,UAAM,sBAAsB,QAAQ,uBAAuB;AAC3D,UAAM,kBAAkB,QAAQ,mBAAmB;AACnD,UAAM,sBAAsB,QAAQ,uBAAuB;AAC3D,UAAM,qBAAqB,QAAQ,sBAAsB;AAEzD,UAAM,MAAM,IAAI,0CAA0B;AAAA,MACxC,uBAAuB,QAAQ;AAAA,MAC/B,gBAAgB,QAAQ;AAAA,MACxB,yBAAyB,QAAQ;AAAA,MACjC,gBAAgB,QAAQ;AAAA,MACxB;AAAA,MACA,KAAK,QAAQ;AAAA,MACb;AAAA,MACA,QAAQ,QAAQ;AAAA,MAChB;AAAA,MACA;AAAA,MACA;AAAA,MACA,uBAAuB,QAAQ;AAAA,MAC/B;AAAA,MACA,mBAAmB,QAAQ;AAAA,IAC7B,CAAC,EAAE,OAAO;AAKV,UAAM,UAAU,QAAQ,oBACnB,QAAQ,WAAW,qDACpB,QAAQ;AAEZ,UAAM,OAAO,MAAM,KAAK,IAAI;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,YAAY,KAAK,CAAC;AAAA,MAC1C;AAAA,IACF;AACA,WAAO,2CAA2B,SAAS,MAAM,EAAE,qBAAqB,KAAK,CAAC;AAAA,EAChF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,oBACJ,gBACA,KACsC;AACtC,UAAM,MAAM,IAAI,2CAA2B;AAAA,MACzC;AAAA,MACA;AAAA,IACF,CAAC,EAAE,OAAO;AAEV,UAAM,OAAO,MAAM,KAAK,IAAI;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,YAAY,KAAK,CAAC;AAAA,IAC5C;AACA,WAAO,4CAA4B,SAAS,MAAM,EAAE,qBAAqB,KAAK,CAAC;AAAA,EACjF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,uBACJ,gBACA,gBACA,kBACyC;AACzC,UAAM,MAAM,IAAI,8CAA8B;AAAA,MAC5C;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC,EAAE,OAAO;AAEV,UAAM,OAAO,MAAM,KAAK,IAAI;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,YAAY,KAAK,CAAC;AAAA,IAC5C;AACA,WAAO,+CAA+B,SAAS,MAAM,EAAE,qBAAqB,KAAK,CAAC;AAAA,EACpF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,kBAAkB,SAAuE;AAC7F,UAAM,sBAAsB,QAAQ,uBAAuB;AAC3D,UAAM,kBAAkB,QAAQ,mBAAmB;AACnD,UAAM,sBAAsB,QAAQ,uBAAuB;AAC3D,UAAM,qBAAqB,QAAQ,sBAAsB;AAEzD,UAAM,MAAM,IAAI,yCAAyB;AAAA,MACvC,qBAAqB,QAAQ;AAAA,MAC7B,UAAU,QAAQ;AAAA,MAClB,QAAQ,QAAQ;AAAA,MAChB;AAAA,MACA;AAAA,MACA;AAAA,MACA,uBAAuB,QAAQ;AAAA,MAC/B;AAAA,IACF,CAAC,EAAE,OAAO;AAEV,UAAM,OAAO,MAAM,KAAK,IAAI;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,YAAY,KAAK,CAAC;AAAA,IAC5C;AACA,WAAO,0CAA0B,SAAS,MAAM,EAAE,qBAAqB,KAAK,CAAC;AAAA,EAC/E;AACF;","names":[]}

package/dist/ConnectorClient.d.cts

@@ -63,10 +63,13 @@ interface AcceptWhatsAppCallOptions {
     };
     /** Optional - Country where the call terminates as ISO 3166-1 alpha-2 */
     destinationCountry?: string;
-    /** Optional - Max time in seconds for the callee to answer the call */
-    ringingTimeout?: number;
-    /** Optional - Wait for the call to be answered before returning */
+    /** Optional - Wait until the inbound party joins before returning. */
     waitUntilAnswered?: boolean;
+    /**
+     * Optional - Request timeout in seconds. When `waitUntilAnswered` is set it
+     * defaults to the standard ring window; otherwise the client default applies.
+     */
+    timeout?: number;
 }
 interface ConnectTwilioCallOptions {
     /** The direction of the call */

package/dist/ConnectorClient.d.ts

@@ -63,10 +63,13 @@ interface AcceptWhatsAppCallOptions {
     };
     /** Optional - Country where the call terminates as ISO 3166-1 alpha-2 */
     destinationCountry?: string;
-    /** Optional - Max time in seconds for the callee to answer the call */
-    ringingTimeout?: number;
-    /** Optional - Wait for the call to be answered before returning */
+    /** Optional - Wait until the inbound party joins before returning. */
     waitUntilAnswered?: boolean;
+    /**
+     * Optional - Request timeout in seconds. When `waitUntilAnswered` is set it
+     * defaults to the standard ring window; otherwise the client default applies.
+     */
+    timeout?: number;
 }
 interface ConnectTwilioCallOptions {
     /** The direction of the call */

package/dist/ConnectorClient.d.ts.map

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

package/dist/ConnectorClient.js

@@ -13,6 +13,7 @@ import {
 } from "@livekit/protocol";
 import { ServiceBase } from "./ServiceBase.js";
 import { TwirpRpc, livekitPackage } from "./TwirpRPC.js";
+import { DEFAULT_RINGING_TIMEOUT_SECONDS } from "./dialTimeout.js";
 const svc = "Connector";
 class ConnectorClient extends ServiceBase {
   /**
@@ -22,9 +23,11 @@ class ConnectorClient extends ServiceBase {
    * @param options - client options
    */
   constructor(host, apiKey, secret, options) {
-    super(apiKey, secret);
-    const rpcOptions = (options == null ? void 0 : options.requestTimeout) ? { requestTimeout: options.requestTimeout } : void 0;
-    this.rpc = new TwirpRpc(host, livekitPackage, rpcOptions);
+    super({ apiKey, secret, token: options == null ? void 0 : options.token });
+    this.rpc = new TwirpRpc(host, livekitPackage, {
+      requestTimeout: options == null ? void 0 : options.requestTimeout,
+      failover: options == null ? void 0 : options.failover
+    });
   }
   /**
    * Initiate an outbound WhatsApp call
@@ -89,14 +92,15 @@ class ConnectorClient extends ServiceBase {
       participantMetadata,
       participantAttributes: options.participantAttributes,
       destinationCountry,
-      ringingTimeout: options.ringingTimeout ? new Duration({ seconds: BigInt(options.ringingTimeout) }) : void 0,
       waitUntilAnswered: options.waitUntilAnswered
     }).toJson();
+    const timeout = options.waitUntilAnswered ? options.timeout ?? DEFAULT_RINGING_TIMEOUT_SECONDS : options.timeout;
     const data = await this.rpc.request(
       svc,
       "AcceptWhatsAppCall",
       req,
-      await this.authHeader({ roomCreate: true })
+      await this.authHeader({ roomCreate: true }),
+      timeout
     );
     return AcceptWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });
   }

package/dist/ConnectorClient.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/ConnectorClient.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { Duration } from '@bufbuild/protobuf';\nimport type {\n  ConnectTwilioCallRequest_TwilioCallDirection,\n  DisconnectWhatsAppCallRequest_DisconnectReason,\n  RoomAgentDispatch,\n  SessionDescription,\n} from '@livekit/protocol';\nimport {\n  AcceptWhatsAppCallRequest,\n  AcceptWhatsAppCallResponse,\n  ConnectTwilioCallRequest,\n  ConnectTwilioCallResponse,\n  ConnectWhatsAppCallRequest,\n  ConnectWhatsAppCallResponse,\n  DialWhatsAppCallRequest,\n  DialWhatsAppCallResponse,\n  DisconnectWhatsAppCallRequest,\n  DisconnectWhatsAppCallResponse,\n} from '@livekit/protocol';\nimport type { ClientOptions } from './ClientOptions.js';\nimport { ServiceBase } from './ServiceBase.js';\nimport { type Rpc, TwirpRpc, livekitPackage } from './TwirpRPC.js';\n\nconst svc = 'Connector';\n\n// WhatsApp types\nexport interface DialWhatsAppCallOptions {\n  /** Required - The identifier of the WhatsApp phone number that is initiating the call */\n  whatsappPhoneNumberId: string;\n  /** Required - The number of the user that is supposed to receive the call */\n  whatsappToPhoneNumber: string;\n  /** Required - The API key of the business that is initiating the call */\n  whatsappApiKey: string;\n  /** Required - WhatsApp Cloud API version, eg: 23.0, 24.0, etc. */\n  whatsappCloudApiVersion: string;\n  /** Optional - An arbitrary string you can pass in that is useful for tracking and logging purposes */\n  whatsappBizOpaqueCallbackData?: string;\n  /** Optional - What LiveKit room should this participant be connected to */\n  roomName?: string;\n  /** Optional - Agents to dispatch the call to */\n  agents?: RoomAgentDispatch[];\n  /** Optional - Identity of the participant in LiveKit room */\n  participantIdentity?: string;\n  /** Optional - Name of the participant in LiveKit room */\n  participantName?: string;\n  /** Optional - User-defined metadata. Will be attached to a created Participant in the room. */\n  participantMetadata?: string;\n  /** Optional - User-defined attributes. Will be attached to a created Participant in the room. */\n  participantAttributes?: { [key: string]: string };\n  /** Optional - Country where the call terminates as ISO 3166-1 alpha-2 */\n  destinationCountry?: string;\n  /** Optional - Max time in seconds for the callee to answer the call */\n  ringingTimeout?: number;\n}\n\nexport interface AcceptWhatsAppCallOptions {\n  /** Required - The identifier of the WhatsApp phone number that is connecting the call */\n  whatsappPhoneNumberId: string;\n  /** Required - The API key of the business that is connecting the call */\n  whatsappApiKey: string;\n  /** Required - WhatsApp Cloud API version, eg: 23.0, 24.0, etc. */\n  whatsappCloudApiVersion: string;\n  /** Required - Call ID sent by Meta */\n  whatsappCallId: string;\n  /** Optional - An arbitrary string you can pass in that is useful for tracking and logging purposes */\n  whatsappBizOpaqueCallbackData?: string;\n  /** Required - The call accept webhook comes with SDP from Meta */\n  sdp: SessionDescription;\n  /** Optional - What LiveKit room should this participant be connected to */\n  roomName?: string;\n  /** Optional - Agents to dispatch the call to */\n  agents?: RoomAgentDispatch[];\n  /** Optional - Identity of the participant in LiveKit room */\n  participantIdentity?: string;\n  /** Optional - Name of the participant in LiveKit room */\n  participantName?: string;\n  /** Optional - User-defined metadata. Will be attached to a created Participant in the room. */\n  participantMetadata?: string;\n  /** Optional - User-defined attributes. Will be attached to a created Participant in the room. */\n  participantAttributes?: { [key: string]: string };\n  /** Optional - Country where the call terminates as ISO 3166-1 alpha-2 */\n  destinationCountry?: string;\n  /** Optional - Max time in seconds for the callee to answer the call */\n  ringingTimeout?: number;\n  /** Optional - Wait for the call to be answered before returning */\n  waitUntilAnswered?: boolean;\n}\n\n// Twilio types\nexport interface ConnectTwilioCallOptions {\n  /** The direction of the call */\n  twilioCallDirection: ConnectTwilioCallRequest_TwilioCallDirection;\n  /** What LiveKit room should this call be connected to */\n  roomName: string;\n  /** Optional agents to dispatch the call to */\n  agents?: RoomAgentDispatch[];\n  /** Optional identity of the participant in LiveKit room */\n  participantIdentity?: string;\n  /** Optional name of the participant in LiveKit room */\n  participantName?: string;\n  /** Optional user-defined metadata. Will be attached to a created Participant in the room. */\n  participantMetadata?: string;\n  /** Optional user-defined attributes. Will be attached to a created Participant in the room. */\n  participantAttributes?: { [key: string]: string };\n  /** Country where the call terminates as ISO 3166-1 alpha-2 */\n  destinationCountry?: string;\n}\n\n/**\n * Client to access Connector APIs for WhatsApp and Twilio integrations\n */\nexport class ConnectorClient extends ServiceBase {\n  private readonly rpc: Rpc;\n\n  /**\n   * @param host - hostname including protocol. i.e. 'https://<project>.livekit.cloud'\n   * @param apiKey - API Key, can be set in env var LIVEKIT_API_KEY\n   * @param secret - API Secret, can be set in env var LIVEKIT_API_SECRET\n   * @param options - client options\n   */\n  constructor(host: string, apiKey?: string, secret?: string, options?: ClientOptions) {\n    super(apiKey, secret);\n    const rpcOptions = options?.requestTimeout\n      ? { requestTimeout: options.requestTimeout }\n      : undefined;\n    this.rpc = new TwirpRpc(host, livekitPackage, rpcOptions);\n  }\n\n  /**\n   * Initiate an outbound WhatsApp call\n   *\n   * @param options - WhatsApp call options\n   * @returns Promise containing the WhatsApp call ID and room name\n   */\n  async dialWhatsAppCall(options: DialWhatsAppCallOptions): Promise<DialWhatsAppCallResponse> {\n    const whatsappBizOpaqueCallbackData = options.whatsappBizOpaqueCallbackData || '';\n    const roomName = options.roomName || '';\n    const participantIdentity = options.participantIdentity || '';\n    const participantName = options.participantName || '';\n    const participantMetadata = options.participantMetadata || '';\n    const destinationCountry = options.destinationCountry || '';\n\n    const req = new DialWhatsAppCallRequest({\n      whatsappPhoneNumberId: options.whatsappPhoneNumberId,\n      whatsappToPhoneNumber: options.whatsappToPhoneNumber,\n      whatsappApiKey: options.whatsappApiKey,\n      whatsappCloudApiVersion: options.whatsappCloudApiVersion,\n      whatsappBizOpaqueCallbackData,\n      roomName,\n      agents: options.agents,\n      participantIdentity,\n      participantName,\n      participantMetadata,\n      participantAttributes: options.participantAttributes,\n      destinationCountry,\n      ringingTimeout: options.ringingTimeout\n        ? new Duration({ seconds: BigInt(options.ringingTimeout) })\n        : undefined,\n    }).toJson();\n\n    const data = await this.rpc.request(\n      svc,\n      'DialWhatsAppCall',\n      req,\n      await this.authHeader({ roomCreate: true }),\n    );\n    return DialWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });\n  }\n\n  /**\n   * Accept an inbound WhatsApp call\n   *\n   * @param options - WhatsApp call accept options\n   * @returns Promise containing the room name\n   */\n  async acceptWhatsAppCall(\n    options: AcceptWhatsAppCallOptions,\n  ): Promise<AcceptWhatsAppCallResponse> {\n    const whatsappBizOpaqueCallbackData = options.whatsappBizOpaqueCallbackData || '';\n    const roomName = options.roomName || '';\n    const participantIdentity = options.participantIdentity || '';\n    const participantName = options.participantName || '';\n    const participantMetadata = options.participantMetadata || '';\n    const destinationCountry = options.destinationCountry || '';\n\n    const req = new AcceptWhatsAppCallRequest({\n      whatsappPhoneNumberId: options.whatsappPhoneNumberId,\n      whatsappApiKey: options.whatsappApiKey,\n      whatsappCloudApiVersion: options.whatsappCloudApiVersion,\n      whatsappCallId: options.whatsappCallId,\n      whatsappBizOpaqueCallbackData,\n      sdp: options.sdp,\n      roomName,\n      agents: options.agents,\n      participantIdentity,\n      participantName,\n      participantMetadata,\n      participantAttributes: options.participantAttributes,\n      destinationCountry,\n      ringingTimeout: options.ringingTimeout\n        ? new Duration({ seconds: BigInt(options.ringingTimeout) })\n        : undefined,\n      waitUntilAnswered: options.waitUntilAnswered,\n    }).toJson();\n\n    const data = await this.rpc.request(\n      svc,\n      'AcceptWhatsAppCall',\n      req,\n      await this.authHeader({ roomCreate: true }),\n    );\n    return AcceptWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });\n  }\n\n  /**\n   * Connect an established WhatsApp call (used for business-initiated calls)\n   *\n   * @param whatsappCallId - Call ID sent by Meta\n   * @param sdp - Session description from Meta\n   */\n  async connectWhatsAppCall(\n    whatsappCallId: string,\n    sdp: SessionDescription,\n  ): Promise<ConnectWhatsAppCallResponse> {\n    const req = new ConnectWhatsAppCallRequest({\n      whatsappCallId,\n      sdp,\n    }).toJson();\n\n    const data = await this.rpc.request(\n      svc,\n      'ConnectWhatsAppCall',\n      req,\n      await this.authHeader({ roomCreate: true }),\n    );\n    return ConnectWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });\n  }\n\n  /**\n   * Disconnect an active WhatsApp call\n   *\n   * @param whatsappCallId - Call ID sent by Meta\n   * @param whatsappApiKey - The API key of the business that is disconnecting the call.\n   *   Required when `disconnectReason` is BUSINESS_INITIATED, optional for USER_INITIATED.\n   * @param disconnectReason - Optional reason for disconnecting the call. Defaults to BUSINESS_INITIATED.\n   */\n  async disconnectWhatsAppCall(\n    whatsappCallId: string,\n    whatsappApiKey: string,\n    disconnectReason?: DisconnectWhatsAppCallRequest_DisconnectReason,\n  ): Promise<DisconnectWhatsAppCallResponse> {\n    const req = new DisconnectWhatsAppCallRequest({\n      whatsappCallId,\n      whatsappApiKey,\n      disconnectReason,\n    }).toJson();\n\n    const data = await this.rpc.request(\n      svc,\n      'DisconnectWhatsAppCall',\n      req,\n      await this.authHeader({ roomCreate: true }),\n    );\n    return DisconnectWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });\n  }\n\n  /**\n   * Connect a Twilio call to a LiveKit room\n   *\n   * @param options - Twilio call connection options\n   * @returns Promise containing the WebSocket connect URL for Twilio media stream\n   */\n  async connectTwilioCall(options: ConnectTwilioCallOptions): Promise<ConnectTwilioCallResponse> {\n    const participantIdentity = options.participantIdentity || '';\n    const participantName = options.participantName || '';\n    const participantMetadata = options.participantMetadata || '';\n    const destinationCountry = options.destinationCountry || '';\n\n    const req = new ConnectTwilioCallRequest({\n      twilioCallDirection: options.twilioCallDirection,\n      roomName: options.roomName,\n      agents: options.agents,\n      participantIdentity,\n      participantName,\n      participantMetadata,\n      participantAttributes: options.participantAttributes,\n      destinationCountry,\n    }).toJson();\n\n    const data = await this.rpc.request(\n      svc,\n      'ConnectTwilioCall',\n      req,\n      await this.authHeader({ roomCreate: true }),\n    );\n    return ConnectTwilioCallResponse.fromJson(data, { ignoreUnknownFields: true });\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/ConnectorClient.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { Duration } from '@bufbuild/protobuf';\nimport type {\n  ConnectTwilioCallRequest_TwilioCallDirection,\n  DisconnectWhatsAppCallRequest_DisconnectReason,\n  RoomAgentDispatch,\n  SessionDescription,\n} from '@livekit/protocol';\nimport {\n  AcceptWhatsAppCallRequest,\n  AcceptWhatsAppCallResponse,\n  ConnectTwilioCallRequest,\n  ConnectTwilioCallResponse,\n  ConnectWhatsAppCallRequest,\n  ConnectWhatsAppCallResponse,\n  DialWhatsAppCallRequest,\n  DialWhatsAppCallResponse,\n  DisconnectWhatsAppCallRequest,\n  DisconnectWhatsAppCallResponse,\n} from '@livekit/protocol';\nimport type { ClientOptions } from './ClientOptions.js';\nimport { ServiceBase } from './ServiceBase.js';\nimport { type Rpc, TwirpRpc, livekitPackage } from './TwirpRPC.js';\nimport { DEFAULT_RINGING_TIMEOUT_SECONDS } from './dialTimeout.js';\n\nconst svc = 'Connector';\n\n// WhatsApp types\nexport interface DialWhatsAppCallOptions {\n  /** Required - The identifier of the WhatsApp phone number that is initiating the call */\n  whatsappPhoneNumberId: string;\n  /** Required - The number of the user that is supposed to receive the call */\n  whatsappToPhoneNumber: string;\n  /** Required - The API key of the business that is initiating the call */\n  whatsappApiKey: string;\n  /** Required - WhatsApp Cloud API version, eg: 23.0, 24.0, etc. */\n  whatsappCloudApiVersion: string;\n  /** Optional - An arbitrary string you can pass in that is useful for tracking and logging purposes */\n  whatsappBizOpaqueCallbackData?: string;\n  /** Optional - What LiveKit room should this participant be connected to */\n  roomName?: string;\n  /** Optional - Agents to dispatch the call to */\n  agents?: RoomAgentDispatch[];\n  /** Optional - Identity of the participant in LiveKit room */\n  participantIdentity?: string;\n  /** Optional - Name of the participant in LiveKit room */\n  participantName?: string;\n  /** Optional - User-defined metadata. Will be attached to a created Participant in the room. */\n  participantMetadata?: string;\n  /** Optional - User-defined attributes. Will be attached to a created Participant in the room. */\n  participantAttributes?: { [key: string]: string };\n  /** Optional - Country where the call terminates as ISO 3166-1 alpha-2 */\n  destinationCountry?: string;\n  /** Optional - Max time in seconds for the callee to answer the call */\n  ringingTimeout?: number;\n}\n\nexport interface AcceptWhatsAppCallOptions {\n  /** Required - The identifier of the WhatsApp phone number that is connecting the call */\n  whatsappPhoneNumberId: string;\n  /** Required - The API key of the business that is connecting the call */\n  whatsappApiKey: string;\n  /** Required - WhatsApp Cloud API version, eg: 23.0, 24.0, etc. */\n  whatsappCloudApiVersion: string;\n  /** Required - Call ID sent by Meta */\n  whatsappCallId: string;\n  /** Optional - An arbitrary string you can pass in that is useful for tracking and logging purposes */\n  whatsappBizOpaqueCallbackData?: string;\n  /** Required - The call accept webhook comes with SDP from Meta */\n  sdp: SessionDescription;\n  /** Optional - What LiveKit room should this participant be connected to */\n  roomName?: string;\n  /** Optional - Agents to dispatch the call to */\n  agents?: RoomAgentDispatch[];\n  /** Optional - Identity of the participant in LiveKit room */\n  participantIdentity?: string;\n  /** Optional - Name of the participant in LiveKit room */\n  participantName?: string;\n  /** Optional - User-defined metadata. Will be attached to a created Participant in the room. */\n  participantMetadata?: string;\n  /** Optional - User-defined attributes. Will be attached to a created Participant in the room. */\n  participantAttributes?: { [key: string]: string };\n  /** Optional - Country where the call terminates as ISO 3166-1 alpha-2 */\n  destinationCountry?: string;\n  /** Optional - Wait until the inbound party joins before returning. */\n  waitUntilAnswered?: boolean;\n  /**\n   * Optional - Request timeout in seconds. When `waitUntilAnswered` is set it\n   * defaults to the standard ring window; otherwise the client default applies.\n   */\n  timeout?: number;\n}\n\n// Twilio types\nexport interface ConnectTwilioCallOptions {\n  /** The direction of the call */\n  twilioCallDirection: ConnectTwilioCallRequest_TwilioCallDirection;\n  /** What LiveKit room should this call be connected to */\n  roomName: string;\n  /** Optional agents to dispatch the call to */\n  agents?: RoomAgentDispatch[];\n  /** Optional identity of the participant in LiveKit room */\n  participantIdentity?: string;\n  /** Optional name of the participant in LiveKit room */\n  participantName?: string;\n  /** Optional user-defined metadata. Will be attached to a created Participant in the room. */\n  participantMetadata?: string;\n  /** Optional user-defined attributes. Will be attached to a created Participant in the room. */\n  participantAttributes?: { [key: string]: string };\n  /** Country where the call terminates as ISO 3166-1 alpha-2 */\n  destinationCountry?: string;\n}\n\n/**\n * Client to access Connector APIs for WhatsApp and Twilio integrations\n */\nexport class ConnectorClient extends ServiceBase {\n  private readonly rpc: Rpc;\n\n  /**\n   * @param host - hostname including protocol. i.e. 'https://<project>.livekit.cloud'\n   * @param apiKey - API Key, can be set in env var LIVEKIT_API_KEY\n   * @param secret - API Secret, can be set in env var LIVEKIT_API_SECRET\n   * @param options - client options\n   */\n  constructor(host: string, apiKey?: string, secret?: string, options?: ClientOptions) {\n    super({ apiKey, secret, token: options?.token });\n    this.rpc = new TwirpRpc(host, livekitPackage, {\n      requestTimeout: options?.requestTimeout,\n      failover: options?.failover,\n    });\n  }\n\n  /**\n   * Initiate an outbound WhatsApp call\n   *\n   * @param options - WhatsApp call options\n   * @returns Promise containing the WhatsApp call ID and room name\n   */\n  async dialWhatsAppCall(options: DialWhatsAppCallOptions): Promise<DialWhatsAppCallResponse> {\n    const whatsappBizOpaqueCallbackData = options.whatsappBizOpaqueCallbackData || '';\n    const roomName = options.roomName || '';\n    const participantIdentity = options.participantIdentity || '';\n    const participantName = options.participantName || '';\n    const participantMetadata = options.participantMetadata || '';\n    const destinationCountry = options.destinationCountry || '';\n\n    const req = new DialWhatsAppCallRequest({\n      whatsappPhoneNumberId: options.whatsappPhoneNumberId,\n      whatsappToPhoneNumber: options.whatsappToPhoneNumber,\n      whatsappApiKey: options.whatsappApiKey,\n      whatsappCloudApiVersion: options.whatsappCloudApiVersion,\n      whatsappBizOpaqueCallbackData,\n      roomName,\n      agents: options.agents,\n      participantIdentity,\n      participantName,\n      participantMetadata,\n      participantAttributes: options.participantAttributes,\n      destinationCountry,\n      ringingTimeout: options.ringingTimeout\n        ? new Duration({ seconds: BigInt(options.ringingTimeout) })\n        : undefined,\n    }).toJson();\n\n    const data = await this.rpc.request(\n      svc,\n      'DialWhatsAppCall',\n      req,\n      await this.authHeader({ roomCreate: true }),\n    );\n    return DialWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });\n  }\n\n  /**\n   * Accept an inbound WhatsApp call\n   *\n   * @param options - WhatsApp call accept options\n   * @returns Promise containing the room name\n   */\n  async acceptWhatsAppCall(\n    options: AcceptWhatsAppCallOptions,\n  ): Promise<AcceptWhatsAppCallResponse> {\n    const whatsappBizOpaqueCallbackData = options.whatsappBizOpaqueCallbackData || '';\n    const roomName = options.roomName || '';\n    const participantIdentity = options.participantIdentity || '';\n    const participantName = options.participantName || '';\n    const participantMetadata = options.participantMetadata || '';\n    const destinationCountry = options.destinationCountry || '';\n\n    const req = new AcceptWhatsAppCallRequest({\n      whatsappPhoneNumberId: options.whatsappPhoneNumberId,\n      whatsappApiKey: options.whatsappApiKey,\n      whatsappCloudApiVersion: options.whatsappCloudApiVersion,\n      whatsappCallId: options.whatsappCallId,\n      whatsappBizOpaqueCallbackData,\n      sdp: options.sdp,\n      roomName,\n      agents: options.agents,\n      participantIdentity,\n      participantName,\n      participantMetadata,\n      participantAttributes: options.participantAttributes,\n      destinationCountry,\n      waitUntilAnswered: options.waitUntilAnswered,\n    }).toJson();\n\n    // When waiting for the inbound party to join, the request can block, so\n    // default the timeout to the standard ring window; otherwise the client\n    // default applies.\n    const timeout = options.waitUntilAnswered\n      ? (options.timeout ?? DEFAULT_RINGING_TIMEOUT_SECONDS)\n      : options.timeout;\n\n    const data = await this.rpc.request(\n      svc,\n      'AcceptWhatsAppCall',\n      req,\n      await this.authHeader({ roomCreate: true }),\n      timeout,\n    );\n    return AcceptWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });\n  }\n\n  /**\n   * Connect an established WhatsApp call (used for business-initiated calls)\n   *\n   * @param whatsappCallId - Call ID sent by Meta\n   * @param sdp - Session description from Meta\n   */\n  async connectWhatsAppCall(\n    whatsappCallId: string,\n    sdp: SessionDescription,\n  ): Promise<ConnectWhatsAppCallResponse> {\n    const req = new ConnectWhatsAppCallRequest({\n      whatsappCallId,\n      sdp,\n    }).toJson();\n\n    const data = await this.rpc.request(\n      svc,\n      'ConnectWhatsAppCall',\n      req,\n      await this.authHeader({ roomCreate: true }),\n    );\n    return ConnectWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });\n  }\n\n  /**\n   * Disconnect an active WhatsApp call\n   *\n   * @param whatsappCallId - Call ID sent by Meta\n   * @param whatsappApiKey - The API key of the business that is disconnecting the call.\n   *   Required when `disconnectReason` is BUSINESS_INITIATED, optional for USER_INITIATED.\n   * @param disconnectReason - Optional reason for disconnecting the call. Defaults to BUSINESS_INITIATED.\n   */\n  async disconnectWhatsAppCall(\n    whatsappCallId: string,\n    whatsappApiKey: string,\n    disconnectReason?: DisconnectWhatsAppCallRequest_DisconnectReason,\n  ): Promise<DisconnectWhatsAppCallResponse> {\n    const req = new DisconnectWhatsAppCallRequest({\n      whatsappCallId,\n      whatsappApiKey,\n      disconnectReason,\n    }).toJson();\n\n    const data = await this.rpc.request(\n      svc,\n      'DisconnectWhatsAppCall',\n      req,\n      await this.authHeader({ roomCreate: true }),\n    );\n    return DisconnectWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });\n  }\n\n  /**\n   * Connect a Twilio call to a LiveKit room\n   *\n   * @param options - Twilio call connection options\n   * @returns Promise containing the WebSocket connect URL for Twilio media stream\n   */\n  async connectTwilioCall(options: ConnectTwilioCallOptions): Promise<ConnectTwilioCallResponse> {\n    const participantIdentity = options.participantIdentity || '';\n    const participantName = options.participantName || '';\n    const participantMetadata = options.participantMetadata || '';\n    const destinationCountry = options.destinationCountry || '';\n\n    const req = new ConnectTwilioCallRequest({\n      twilioCallDirection: options.twilioCallDirection,\n      roomName: options.roomName,\n      agents: options.agents,\n      participantIdentity,\n      participantName,\n      participantMetadata,\n      participantAttributes: options.participantAttributes,\n      destinationCountry,\n    }).toJson();\n\n    const data = await this.rpc.request(\n      svc,\n      'ConnectTwilioCall',\n      req,\n      await this.authHeader({ roomCreate: true }),\n    );\n    return ConnectTwilioCallResponse.fromJson(data, { ignoreUnknownFields: true });\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/EgressClient.cjs

@@ -33,9 +33,11 @@ class EgressClient extends import_ServiceBase.ServiceBase {
    * @param options - client options
    */
   constructor(host, apiKey, secret, options) {
-    super(apiKey, secret);
-    const rpcOptions = (options == null ? void 0 : options.requestTimeout) ? { requestTimeout: options.requestTimeout } : void 0;
-    this.rpc = new import_TwirpRPC.TwirpRpc(host, import_TwirpRPC.livekitPackage, rpcOptions);
+    super({ apiKey, secret, token: options == null ? void 0 : options.token });
+    this.rpc = new import_TwirpRPC.TwirpRpc(host, import_TwirpRPC.livekitPackage, {
+      requestTimeout: options == null ? void 0 : options.requestTimeout,
+      failover: options == null ? void 0 : options.failover
+    });
   }
   async startRoomCompositeEgress(roomName, output, optsOrLayout, options, audioOnly, videoOnly, customBaseUrl, audioMixing) {
     let layout;
@@ -321,6 +323,20 @@ class EgressClient extends import_ServiceBase.ServiceBase {
     );
     return import_protocol.EgressInfo.fromJson(data, { ignoreUnknownFields: true });
   }
+  /**
+   * Starts an egress using the unified v2 request.
+   *
+   * @param request - the egress request
+   */
+  async startEgress(request) {
+    const data = await this.rpc.request(
+      svc,
+      "StartEgress",
+      request.toJson(),
+      await this.authHeader({ roomRecord: true })
+    );
+    return import_protocol.EgressInfo.fromJson(data, { ignoreUnknownFields: true });
+  }
   /**
    * @param egressId -
    * @param layout -