livekit-server-sdk 2.14.2 → 2.15.0

package/dist/ConnectorClient.cjs

@@ -0,0 +1,183 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var ConnectorClient_exports = {};
+__export(ConnectorClient_exports, {
+  ConnectorClient: () => ConnectorClient
+});
+module.exports = __toCommonJS(ConnectorClient_exports);
+var import_protocol = require("@livekit/protocol");
+var import_ServiceBase = require("./ServiceBase.cjs");
+var import_TwirpRPC = require("./TwirpRPC.cjs");
+const svc = "Connector";
+class ConnectorClient extends import_ServiceBase.ServiceBase {
+  /**
+   * @param host - hostname including protocol. i.e. 'https://<project>.livekit.cloud'
+   * @param apiKey - API Key, can be set in env var LIVEKIT_API_KEY
+   * @param secret - API Secret, can be set in env var LIVEKIT_API_SECRET
+   * @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);
+  }
+  /**
+   * Initiate an outbound WhatsApp call
+   *
+   * @param options - WhatsApp call options
+   * @returns Promise containing the WhatsApp call ID and room name
+   */
+  async dialWhatsAppCall(options) {
+    const whatsappBizOpaqueCallbackData = options.whatsappBizOpaqueCallbackData || "";
+    const roomName = options.roomName || "";
+    const participantIdentity = options.participantIdentity || "";
+    const participantName = options.participantName || "";
+    const participantMetadata = options.participantMetadata || "";
+    const destinationCountry = options.destinationCountry || "";
+    const req = new import_protocol.DialWhatsAppCallRequest({
+      whatsappPhoneNumberId: options.whatsappPhoneNumberId,
+      whatsappToPhoneNumber: options.whatsappToPhoneNumber,
+      whatsappApiKey: options.whatsappApiKey,
+      whatsappCloudApiVersion: options.whatsappCloudApiVersion,
+      whatsappBizOpaqueCallbackData,
+      roomName,
+      agents: options.agents,
+      participantIdentity,
+      participantName,
+      participantMetadata,
+      participantAttributes: options.participantAttributes,
+      destinationCountry
+    }).toJson();
+    const data = await this.rpc.request(
+      svc,
+      "DialWhatsAppCall",
+      req,
+      await this.authHeader({ roomCreate: true })
+    );
+    return import_protocol.DialWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });
+  }
+  /**
+   * Accept an inbound WhatsApp call
+   *
+   * @param options - WhatsApp call accept options
+   * @returns Promise containing the room name
+   */
+  async acceptWhatsAppCall(options) {
+    const whatsappBizOpaqueCallbackData = options.whatsappBizOpaqueCallbackData || "";
+    const roomName = options.roomName || "";
+    const participantIdentity = options.participantIdentity || "";
+    const participantName = options.participantName || "";
+    const participantMetadata = options.participantMetadata || "";
+    const destinationCountry = options.destinationCountry || "";
+    const req = new import_protocol.AcceptWhatsAppCallRequest({
+      whatsappPhoneNumberId: options.whatsappPhoneNumberId,
+      whatsappApiKey: options.whatsappApiKey,
+      whatsappCloudApiVersion: options.whatsappCloudApiVersion,
+      whatsappCallId: options.whatsappCallId,
+      whatsappBizOpaqueCallbackData,
+      sdp: options.sdp,
+      roomName,
+      agents: options.agents,
+      participantIdentity,
+      participantName,
+      participantMetadata,
+      participantAttributes: options.participantAttributes,
+      destinationCountry
+    }).toJson();
+    const data = await this.rpc.request(
+      svc,
+      "AcceptWhatsAppCall",
+      req,
+      await this.authHeader({ roomCreate: true })
+    );
+    return import_protocol.AcceptWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });
+  }
+  /**
+   * Connect an established WhatsApp call (used for business-initiated calls)
+   *
+   * @param whatsappCallId - Call ID sent by Meta
+   * @param sdp - Session description from Meta
+   */
+  async connectWhatsAppCall(whatsappCallId, sdp) {
+    const req = new import_protocol.ConnectWhatsAppCallRequest({
+      whatsappCallId,
+      sdp
+    }).toJson();
+    const data = await this.rpc.request(
+      svc,
+      "ConnectWhatsAppCall",
+      req,
+      await this.authHeader({ roomCreate: true })
+    );
+    return import_protocol.ConnectWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });
+  }
+  /**
+   * Disconnect an active WhatsApp call
+   *
+   * @param whatsappCallId - Call ID sent by Meta
+   * @param whatsappApiKey - The API key of the business that is disconnecting the call
+   */
+  async disconnectWhatsAppCall(whatsappCallId, whatsappApiKey) {
+    const req = new import_protocol.DisconnectWhatsAppCallRequest({
+      whatsappCallId,
+      whatsappApiKey
+    }).toJson();
+    const data = await this.rpc.request(
+      svc,
+      "DisconnectWhatsAppCall",
+      req,
+      await this.authHeader({ roomCreate: true })
+    );
+    return import_protocol.DisconnectWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });
+  }
+  /**
+   * Connect a Twilio call to a LiveKit room
+   *
+   * @param options - Twilio call connection options
+   * @returns Promise containing the WebSocket connect URL for Twilio media stream
+   */
+  async connectTwilioCall(options) {
+    const participantIdentity = options.participantIdentity || "";
+    const participantName = options.participantName || "";
+    const participantMetadata = options.participantMetadata || "";
+    const destinationCountry = options.destinationCountry || "";
+    const req = new import_protocol.ConnectTwilioCallRequest({
+      twilioCallDirection: options.twilioCallDirection,
+      roomName: options.roomName,
+      agents: options.agents,
+      participantIdentity,
+      participantName,
+      participantMetadata,
+      participantAttributes: options.participantAttributes,
+      destinationCountry
+    }).toJson();
+    const data = await this.rpc.request(
+      svc,
+      "ConnectTwilioCall",
+      req,
+      await this.authHeader({ roomCreate: true })
+    );
+    return import_protocol.ConnectTwilioCallResponse.fromJson(data, { ignoreUnknownFields: true });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ConnectorClient
+});
+//# sourceMappingURL=ConnectorClient.cjs.map

package/dist/ConnectorClient.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ConnectorClient.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type {\n  ConnectTwilioCallRequest_TwilioCallDirection,\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}\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}\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    }).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    }).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   */\n  async disconnectWhatsAppCall(\n    whatsappCallId: string,\n    whatsappApiKey: string,\n  ): Promise<DisconnectWhatsAppCallResponse> {\n    const req = new DisconnectWhatsAppCallRequest({\n      whatsappCallId,\n      whatsappApiKey,\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/ConnectorClient.d.cts

@@ -0,0 +1,134 @@
+import { RoomAgentDispatch, SessionDescription, ConnectTwilioCallRequest_TwilioCallDirection, DialWhatsAppCallResponse, AcceptWhatsAppCallResponse, ConnectWhatsAppCallResponse, DisconnectWhatsAppCallResponse, ConnectTwilioCallResponse } from '@livekit/protocol';
+import { ClientOptions } from './ClientOptions.cjs';
+import { ServiceBase } from './ServiceBase.cjs';
+import './grants.cjs';
+import 'jose';
+
+interface DialWhatsAppCallOptions {
+    /** Required - The identifier of the WhatsApp phone number that is initiating the call */
+    whatsappPhoneNumberId: string;
+    /** Required - The number of the user that is supposed to receive the call */
+    whatsappToPhoneNumber: string;
+    /** Required - The API key of the business that is initiating the call */
+    whatsappApiKey: string;
+    /** Required - WhatsApp Cloud API version, eg: 23.0, 24.0, etc. */
+    whatsappCloudApiVersion: string;
+    /** Optional - An arbitrary string you can pass in that is useful for tracking and logging purposes */
+    whatsappBizOpaqueCallbackData?: string;
+    /** Optional - What LiveKit room should this participant be connected to */
+    roomName?: string;
+    /** Optional - Agents to dispatch the call to */
+    agents?: RoomAgentDispatch[];
+    /** Optional - Identity of the participant in LiveKit room */
+    participantIdentity?: string;
+    /** Optional - Name of the participant in LiveKit room */
+    participantName?: string;
+    /** Optional - User-defined metadata. Will be attached to a created Participant in the room. */
+    participantMetadata?: string;
+    /** Optional - User-defined attributes. Will be attached to a created Participant in the room. */
+    participantAttributes?: {
+        [key: string]: string;
+    };
+    /** Optional - Country where the call terminates as ISO 3166-1 alpha-2 */
+    destinationCountry?: string;
+}
+interface AcceptWhatsAppCallOptions {
+    /** Required - The identifier of the WhatsApp phone number that is connecting the call */
+    whatsappPhoneNumberId: string;
+    /** Required - The API key of the business that is connecting the call */
+    whatsappApiKey: string;
+    /** Required - WhatsApp Cloud API version, eg: 23.0, 24.0, etc. */
+    whatsappCloudApiVersion: string;
+    /** Required - Call ID sent by Meta */
+    whatsappCallId: string;
+    /** Optional - An arbitrary string you can pass in that is useful for tracking and logging purposes */
+    whatsappBizOpaqueCallbackData?: string;
+    /** Required - The call accept webhook comes with SDP from Meta */
+    sdp: SessionDescription;
+    /** Optional - What LiveKit room should this participant be connected to */
+    roomName?: string;
+    /** Optional - Agents to dispatch the call to */
+    agents?: RoomAgentDispatch[];
+    /** Optional - Identity of the participant in LiveKit room */
+    participantIdentity?: string;
+    /** Optional - Name of the participant in LiveKit room */
+    participantName?: string;
+    /** Optional - User-defined metadata. Will be attached to a created Participant in the room. */
+    participantMetadata?: string;
+    /** Optional - User-defined attributes. Will be attached to a created Participant in the room. */
+    participantAttributes?: {
+        [key: string]: string;
+    };
+    /** Optional - Country where the call terminates as ISO 3166-1 alpha-2 */
+    destinationCountry?: string;
+}
+interface ConnectTwilioCallOptions {
+    /** The direction of the call */
+    twilioCallDirection: ConnectTwilioCallRequest_TwilioCallDirection;
+    /** What LiveKit room should this call be connected to */
+    roomName: string;
+    /** Optional agents to dispatch the call to */
+    agents?: RoomAgentDispatch[];
+    /** Optional identity of the participant in LiveKit room */
+    participantIdentity?: string;
+    /** Optional name of the participant in LiveKit room */
+    participantName?: string;
+    /** Optional user-defined metadata. Will be attached to a created Participant in the room. */
+    participantMetadata?: string;
+    /** Optional user-defined attributes. Will be attached to a created Participant in the room. */
+    participantAttributes?: {
+        [key: string]: string;
+    };
+    /** Country where the call terminates as ISO 3166-1 alpha-2 */
+    destinationCountry?: string;
+}
+/**
+ * Client to access Connector APIs for WhatsApp and Twilio integrations
+ */
+declare class ConnectorClient extends ServiceBase {
+    private readonly rpc;
+    /**
+     * @param host - hostname including protocol. i.e. 'https://<project>.livekit.cloud'
+     * @param apiKey - API Key, can be set in env var LIVEKIT_API_KEY
+     * @param secret - API Secret, can be set in env var LIVEKIT_API_SECRET
+     * @param options - client options
+     */
+    constructor(host: string, apiKey?: string, secret?: string, options?: ClientOptions);
+    /**
+     * Initiate an outbound WhatsApp call
+     *
+     * @param options - WhatsApp call options
+     * @returns Promise containing the WhatsApp call ID and room name
+     */
+    dialWhatsAppCall(options: DialWhatsAppCallOptions): Promise<DialWhatsAppCallResponse>;
+    /**
+     * Accept an inbound WhatsApp call
+     *
+     * @param options - WhatsApp call accept options
+     * @returns Promise containing the room name
+     */
+    acceptWhatsAppCall(options: AcceptWhatsAppCallOptions): Promise<AcceptWhatsAppCallResponse>;
+    /**
+     * Connect an established WhatsApp call (used for business-initiated calls)
+     *
+     * @param whatsappCallId - Call ID sent by Meta
+     * @param sdp - Session description from Meta
+     */
+    connectWhatsAppCall(whatsappCallId: string, sdp: SessionDescription): Promise<ConnectWhatsAppCallResponse>;
+    /**
+     * Disconnect an active WhatsApp call
+     *
+     * @param whatsappCallId - Call ID sent by Meta
+     * @param whatsappApiKey - The API key of the business that is disconnecting the call
+     */
+    disconnectWhatsAppCall(whatsappCallId: string, whatsappApiKey: string): Promise<DisconnectWhatsAppCallResponse>;
+    /**
+     * Connect a Twilio call to a LiveKit room
+     *
+     * @param options - Twilio call connection options
+     * @returns Promise containing the WebSocket connect URL for Twilio media stream
+     */
+    connectTwilioCall(options: ConnectTwilioCallOptions): Promise<ConnectTwilioCallResponse>;
+}
+
+export { type AcceptWhatsAppCallOptions, type ConnectTwilioCallOptions, ConnectorClient, type DialWhatsAppCallOptions };

package/dist/ConnectorClient.d.ts

@@ -0,0 +1,131 @@
+import type { ConnectTwilioCallRequest_TwilioCallDirection, RoomAgentDispatch, SessionDescription } from '@livekit/protocol';
+import { AcceptWhatsAppCallResponse, ConnectTwilioCallResponse, ConnectWhatsAppCallResponse, DialWhatsAppCallResponse, DisconnectWhatsAppCallResponse } from '@livekit/protocol';
+import type { ClientOptions } from './ClientOptions.js';
+import { ServiceBase } from './ServiceBase.js';
+export interface DialWhatsAppCallOptions {
+    /** Required - The identifier of the WhatsApp phone number that is initiating the call */
+    whatsappPhoneNumberId: string;
+    /** Required - The number of the user that is supposed to receive the call */
+    whatsappToPhoneNumber: string;
+    /** Required - The API key of the business that is initiating the call */
+    whatsappApiKey: string;
+    /** Required - WhatsApp Cloud API version, eg: 23.0, 24.0, etc. */
+    whatsappCloudApiVersion: string;
+    /** Optional - An arbitrary string you can pass in that is useful for tracking and logging purposes */
+    whatsappBizOpaqueCallbackData?: string;
+    /** Optional - What LiveKit room should this participant be connected to */
+    roomName?: string;
+    /** Optional - Agents to dispatch the call to */
+    agents?: RoomAgentDispatch[];
+    /** Optional - Identity of the participant in LiveKit room */
+    participantIdentity?: string;
+    /** Optional - Name of the participant in LiveKit room */
+    participantName?: string;
+    /** Optional - User-defined metadata. Will be attached to a created Participant in the room. */
+    participantMetadata?: string;
+    /** Optional - User-defined attributes. Will be attached to a created Participant in the room. */
+    participantAttributes?: {
+        [key: string]: string;
+    };
+    /** Optional - Country where the call terminates as ISO 3166-1 alpha-2 */
+    destinationCountry?: string;
+}
+export interface AcceptWhatsAppCallOptions {
+    /** Required - The identifier of the WhatsApp phone number that is connecting the call */
+    whatsappPhoneNumberId: string;
+    /** Required - The API key of the business that is connecting the call */
+    whatsappApiKey: string;
+    /** Required - WhatsApp Cloud API version, eg: 23.0, 24.0, etc. */
+    whatsappCloudApiVersion: string;
+    /** Required - Call ID sent by Meta */
+    whatsappCallId: string;
+    /** Optional - An arbitrary string you can pass in that is useful for tracking and logging purposes */
+    whatsappBizOpaqueCallbackData?: string;
+    /** Required - The call accept webhook comes with SDP from Meta */
+    sdp: SessionDescription;
+    /** Optional - What LiveKit room should this participant be connected to */
+    roomName?: string;
+    /** Optional - Agents to dispatch the call to */
+    agents?: RoomAgentDispatch[];
+    /** Optional - Identity of the participant in LiveKit room */
+    participantIdentity?: string;
+    /** Optional - Name of the participant in LiveKit room */
+    participantName?: string;
+    /** Optional - User-defined metadata. Will be attached to a created Participant in the room. */
+    participantMetadata?: string;
+    /** Optional - User-defined attributes. Will be attached to a created Participant in the room. */
+    participantAttributes?: {
+        [key: string]: string;
+    };
+    /** Optional - Country where the call terminates as ISO 3166-1 alpha-2 */
+    destinationCountry?: string;
+}
+export interface ConnectTwilioCallOptions {
+    /** The direction of the call */
+    twilioCallDirection: ConnectTwilioCallRequest_TwilioCallDirection;
+    /** What LiveKit room should this call be connected to */
+    roomName: string;
+    /** Optional agents to dispatch the call to */
+    agents?: RoomAgentDispatch[];
+    /** Optional identity of the participant in LiveKit room */
+    participantIdentity?: string;
+    /** Optional name of the participant in LiveKit room */
+    participantName?: string;
+    /** Optional user-defined metadata. Will be attached to a created Participant in the room. */
+    participantMetadata?: string;
+    /** Optional user-defined attributes. Will be attached to a created Participant in the room. */
+    participantAttributes?: {
+        [key: string]: string;
+    };
+    /** Country where the call terminates as ISO 3166-1 alpha-2 */
+    destinationCountry?: string;
+}
+/**
+ * Client to access Connector APIs for WhatsApp and Twilio integrations
+ */
+export declare class ConnectorClient extends ServiceBase {
+    private readonly rpc;
+    /**
+     * @param host - hostname including protocol. i.e. 'https://<project>.livekit.cloud'
+     * @param apiKey - API Key, can be set in env var LIVEKIT_API_KEY
+     * @param secret - API Secret, can be set in env var LIVEKIT_API_SECRET
+     * @param options - client options
+     */
+    constructor(host: string, apiKey?: string, secret?: string, options?: ClientOptions);
+    /**
+     * Initiate an outbound WhatsApp call
+     *
+     * @param options - WhatsApp call options
+     * @returns Promise containing the WhatsApp call ID and room name
+     */
+    dialWhatsAppCall(options: DialWhatsAppCallOptions): Promise<DialWhatsAppCallResponse>;
+    /**
+     * Accept an inbound WhatsApp call
+     *
+     * @param options - WhatsApp call accept options
+     * @returns Promise containing the room name
+     */
+    acceptWhatsAppCall(options: AcceptWhatsAppCallOptions): Promise<AcceptWhatsAppCallResponse>;
+    /**
+     * Connect an established WhatsApp call (used for business-initiated calls)
+     *
+     * @param whatsappCallId - Call ID sent by Meta
+     * @param sdp - Session description from Meta
+     */
+    connectWhatsAppCall(whatsappCallId: string, sdp: SessionDescription): Promise<ConnectWhatsAppCallResponse>;
+    /**
+     * Disconnect an active WhatsApp call
+     *
+     * @param whatsappCallId - Call ID sent by Meta
+     * @param whatsappApiKey - The API key of the business that is disconnecting the call
+     */
+    disconnectWhatsAppCall(whatsappCallId: string, whatsappApiKey: string): Promise<DisconnectWhatsAppCallResponse>;
+    /**
+     * Connect a Twilio call to a LiveKit room
+     *
+     * @param options - Twilio call connection options
+     * @returns Promise containing the WebSocket connect URL for Twilio media stream
+     */
+    connectTwilioCall(options: ConnectTwilioCallOptions): Promise<ConnectTwilioCallResponse>;
+}
+//# sourceMappingURL=ConnectorClient.d.ts.map

package/dist/ConnectorClient.d.ts.map

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

package/dist/ConnectorClient.js

@@ -0,0 +1,170 @@
+import {
+  AcceptWhatsAppCallRequest,
+  AcceptWhatsAppCallResponse,
+  ConnectTwilioCallRequest,
+  ConnectTwilioCallResponse,
+  ConnectWhatsAppCallRequest,
+  ConnectWhatsAppCallResponse,
+  DialWhatsAppCallRequest,
+  DialWhatsAppCallResponse,
+  DisconnectWhatsAppCallRequest,
+  DisconnectWhatsAppCallResponse
+} from "@livekit/protocol";
+import { ServiceBase } from "./ServiceBase.js";
+import { TwirpRpc, livekitPackage } from "./TwirpRPC.js";
+const svc = "Connector";
+class ConnectorClient extends ServiceBase {
+  /**
+   * @param host - hostname including protocol. i.e. 'https://<project>.livekit.cloud'
+   * @param apiKey - API Key, can be set in env var LIVEKIT_API_KEY
+   * @param secret - API Secret, can be set in env var LIVEKIT_API_SECRET
+   * @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);
+  }
+  /**
+   * Initiate an outbound WhatsApp call
+   *
+   * @param options - WhatsApp call options
+   * @returns Promise containing the WhatsApp call ID and room name
+   */
+  async dialWhatsAppCall(options) {
+    const whatsappBizOpaqueCallbackData = options.whatsappBizOpaqueCallbackData || "";
+    const roomName = options.roomName || "";
+    const participantIdentity = options.participantIdentity || "";
+    const participantName = options.participantName || "";
+    const participantMetadata = options.participantMetadata || "";
+    const destinationCountry = options.destinationCountry || "";
+    const req = new DialWhatsAppCallRequest({
+      whatsappPhoneNumberId: options.whatsappPhoneNumberId,
+      whatsappToPhoneNumber: options.whatsappToPhoneNumber,
+      whatsappApiKey: options.whatsappApiKey,
+      whatsappCloudApiVersion: options.whatsappCloudApiVersion,
+      whatsappBizOpaqueCallbackData,
+      roomName,
+      agents: options.agents,
+      participantIdentity,
+      participantName,
+      participantMetadata,
+      participantAttributes: options.participantAttributes,
+      destinationCountry
+    }).toJson();
+    const data = await this.rpc.request(
+      svc,
+      "DialWhatsAppCall",
+      req,
+      await this.authHeader({ roomCreate: true })
+    );
+    return DialWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });
+  }
+  /**
+   * Accept an inbound WhatsApp call
+   *
+   * @param options - WhatsApp call accept options
+   * @returns Promise containing the room name
+   */
+  async acceptWhatsAppCall(options) {
+    const whatsappBizOpaqueCallbackData = options.whatsappBizOpaqueCallbackData || "";
+    const roomName = options.roomName || "";
+    const participantIdentity = options.participantIdentity || "";
+    const participantName = options.participantName || "";
+    const participantMetadata = options.participantMetadata || "";
+    const destinationCountry = options.destinationCountry || "";
+    const req = new AcceptWhatsAppCallRequest({
+      whatsappPhoneNumberId: options.whatsappPhoneNumberId,
+      whatsappApiKey: options.whatsappApiKey,
+      whatsappCloudApiVersion: options.whatsappCloudApiVersion,
+      whatsappCallId: options.whatsappCallId,
+      whatsappBizOpaqueCallbackData,
+      sdp: options.sdp,
+      roomName,
+      agents: options.agents,
+      participantIdentity,
+      participantName,
+      participantMetadata,
+      participantAttributes: options.participantAttributes,
+      destinationCountry
+    }).toJson();
+    const data = await this.rpc.request(
+      svc,
+      "AcceptWhatsAppCall",
+      req,
+      await this.authHeader({ roomCreate: true })
+    );
+    return AcceptWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });
+  }
+  /**
+   * Connect an established WhatsApp call (used for business-initiated calls)
+   *
+   * @param whatsappCallId - Call ID sent by Meta
+   * @param sdp - Session description from Meta
+   */
+  async connectWhatsAppCall(whatsappCallId, sdp) {
+    const req = new ConnectWhatsAppCallRequest({
+      whatsappCallId,
+      sdp
+    }).toJson();
+    const data = await this.rpc.request(
+      svc,
+      "ConnectWhatsAppCall",
+      req,
+      await this.authHeader({ roomCreate: true })
+    );
+    return ConnectWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });
+  }
+  /**
+   * Disconnect an active WhatsApp call
+   *
+   * @param whatsappCallId - Call ID sent by Meta
+   * @param whatsappApiKey - The API key of the business that is disconnecting the call
+   */
+  async disconnectWhatsAppCall(whatsappCallId, whatsappApiKey) {
+    const req = new DisconnectWhatsAppCallRequest({
+      whatsappCallId,
+      whatsappApiKey
+    }).toJson();
+    const data = await this.rpc.request(
+      svc,
+      "DisconnectWhatsAppCall",
+      req,
+      await this.authHeader({ roomCreate: true })
+    );
+    return DisconnectWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });
+  }
+  /**
+   * Connect a Twilio call to a LiveKit room
+   *
+   * @param options - Twilio call connection options
+   * @returns Promise containing the WebSocket connect URL for Twilio media stream
+   */
+  async connectTwilioCall(options) {
+    const participantIdentity = options.participantIdentity || "";
+    const participantName = options.participantName || "";
+    const participantMetadata = options.participantMetadata || "";
+    const destinationCountry = options.destinationCountry || "";
+    const req = new ConnectTwilioCallRequest({
+      twilioCallDirection: options.twilioCallDirection,
+      roomName: options.roomName,
+      agents: options.agents,
+      participantIdentity,
+      participantName,
+      participantMetadata,
+      participantAttributes: options.participantAttributes,
+      destinationCountry
+    }).toJson();
+    const data = await this.rpc.request(
+      svc,
+      "ConnectTwilioCall",
+      req,
+      await this.authHeader({ roomCreate: true })
+    );
+    return ConnectTwilioCallResponse.fromJson(data, { ignoreUnknownFields: true });
+  }
+}
+export {
+  ConnectorClient
+};
+//# sourceMappingURL=ConnectorClient.js.map

package/dist/ConnectorClient.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ConnectorClient.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type {\n  ConnectTwilioCallRequest_TwilioCallDirection,\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}\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}\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    }).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    }).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   */\n  async disconnectWhatsAppCall(\n    whatsappCallId: string,\n    whatsappApiKey: string,\n  ): Promise<DisconnectWhatsAppCallResponse> {\n    const req = new DisconnectWhatsAppCallRequest({\n      whatsappCallId,\n      whatsappApiKey,\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/index.cjs

@@ -19,14 +19,20 @@ var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "defau
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var index_exports = {};
 __export(index_exports, {
+  AcceptWhatsAppCallResponse: () => import_protocol.AcceptWhatsAppCallResponse,
   AgentDispatch: () => import_protocol.AgentDispatch,
   AliOSSUpload: () => import_protocol.AliOSSUpload,
   AudioCodec: () => import_protocol.AudioCodec,
   AutoParticipantEgress: () => import_protocol.AutoParticipantEgress,
   AutoTrackEgress: () => import_protocol.AutoTrackEgress,
   AzureBlobUpload: () => import_protocol.AzureBlobUpload,
+  ConnectTwilioCallRequest_TwilioCallDirection: () => import_protocol.ConnectTwilioCallRequest_TwilioCallDirection,
+  ConnectTwilioCallResponse: () => import_protocol.ConnectTwilioCallResponse,
+  ConnectWhatsAppCallResponse: () => import_protocol.ConnectWhatsAppCallResponse,
   DataPacket_Kind: () => import_protocol.DataPacket_Kind,
+  DialWhatsAppCallResponse: () => import_protocol.DialWhatsAppCallResponse,
   DirectFileOutput: () => import_protocol.DirectFileOutput,
+  DisconnectWhatsAppCallResponse: () => import_protocol.DisconnectWhatsAppCallResponse,
   EgressInfo: () => import_protocol.EgressInfo,
   EgressStatus: () => import_protocol.EgressStatus,
   EncodedFileOutput: () => import_protocol.EncodedFileOutput,
@@ -67,6 +73,7 @@ __export(index_exports, {
   SIPTrunkInfo: () => import_protocol.SIPTrunkInfo,
   SegmentedFileOutput: () => import_protocol.SegmentedFileOutput,
   SegmentedFileProtocol: () => import_protocol.SegmentedFileProtocol,
+  SessionDescription: () => import_protocol.SessionDescription,
   StreamOutput: () => import_protocol.StreamOutput,
   StreamProtocol: () => import_protocol.StreamProtocol,
   TrackCompositeEgressRequest: () => import_protocol.TrackCompositeEgressRequest,
@@ -83,6 +90,7 @@ module.exports = __toCommonJS(index_exports);
 var import_protocol = require("@livekit/protocol");
 __reExport(index_exports, require("./AccessToken.cjs"), module.exports);
 __reExport(index_exports, require("./AgentDispatchClient.cjs"), module.exports);
+__reExport(index_exports, require("./ConnectorClient.cjs"), module.exports);
 __reExport(index_exports, require("./EgressClient.cjs"), module.exports);
 __reExport(index_exports, require("./grants.cjs"), module.exports);
 __reExport(index_exports, require("./IngressClient.cjs"), module.exports);
@@ -92,14 +100,20 @@ var import_TwirpRPC = require("./TwirpRPC.cjs");
 __reExport(index_exports, require("./WebhookReceiver.cjs"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AcceptWhatsAppCallResponse,
   AgentDispatch,
   AliOSSUpload,
   AudioCodec,
   AutoParticipantEgress,
   AutoTrackEgress,
   AzureBlobUpload,
+  ConnectTwilioCallRequest_TwilioCallDirection,
+  ConnectTwilioCallResponse,
+  ConnectWhatsAppCallResponse,
   DataPacket_Kind,
+  DialWhatsAppCallResponse,
   DirectFileOutput,
+  DisconnectWhatsAppCallResponse,
   EgressInfo,
   EgressStatus,
   EncodedFileOutput,
@@ -140,6 +154,7 @@ __reExport(index_exports, require("./WebhookReceiver.cjs"), module.exports);
   SIPTrunkInfo,
   SegmentedFileOutput,
   SegmentedFileProtocol,
+  SessionDescription,
   StreamOutput,
   StreamProtocol,
   TrackCompositeEgressRequest,
@@ -153,6 +168,7 @@ __reExport(index_exports, require("./WebhookReceiver.cjs"), module.exports);
   WebhookConfig,
   ...require("./AccessToken.cjs"),
   ...require("./AgentDispatchClient.cjs"),
+  ...require("./ConnectorClient.cjs"),
   ...require("./EgressClient.cjs"),
   ...require("./grants.cjs"),
   ...require("./IngressClient.cjs"),

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\nexport {\n  AliOSSUpload,\n  AgentDispatch,\n  AudioCodec,\n  AutoParticipantEgress,\n  AutoTrackEgress,\n  AzureBlobUpload,\n  DataPacket_Kind,\n  DirectFileOutput,\n  EgressInfo,\n  EgressStatus,\n  EncodedFileOutput,\n  EncodedFileType,\n  EncodingOptions,\n  EncodingOptionsPreset,\n  GCPUpload,\n  ImageCodec,\n  ImageFileSuffix,\n  ImageOutput,\n  IngressAudioEncodingOptions,\n  IngressAudioEncodingPreset,\n  IngressAudioOptions,\n  IngressInfo,\n  IngressInput,\n  IngressState,\n  IngressVideoEncodingOptions,\n  IngressVideoEncodingPreset,\n  IngressVideoOptions,\n  ParticipantEgressRequest,\n  ParticipantInfo,\n  ParticipantInfo_State,\n  ParticipantPermission,\n  Room,\n  RoomAgentDispatch,\n  RoomCompositeEgressRequest,\n  RoomConfiguration,\n  RoomEgress,\n  S3Upload,\n  SIPDispatchRule,\n  SIPDispatchRuleInfo,\n  SIPDispatchRuleDirect,\n  SIPDispatchRuleIndividual,\n  SIPParticipantInfo,\n  SIPOutboundTrunkInfo,\n  SIPInboundTrunkInfo,\n  SIPTrunkInfo,\n  SIPCallStatus,\n  SegmentedFileOutput,\n  SegmentedFileProtocol,\n  StreamOutput,\n  StreamProtocol,\n  TrackCompositeEgressRequest,\n  TrackEgressRequest,\n  TrackInfo,\n  TrackSource,\n  TrackType,\n  WebEgressRequest,\n  VideoCodec,\n  WebhookConfig,\n} from '@livekit/protocol';\nexport * from './AccessToken.js';\nexport * from './AgentDispatchClient.js';\nexport * from './EgressClient.js';\nexport * from './grants.js';\nexport * from './IngressClient.js';\nexport * from './RoomServiceClient.js';\nexport * from './SipClient.js';\nexport { TwirpError } from './TwirpRPC.js';\nexport * from './WebhookReceiver.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,sBA2DO;AACP,0BAAc,6BAhEd;AAiEA,0BAAc,qCAjEd;AAkEA,0BAAc,8BAlEd;AAmEA,0BAAc,wBAnEd;AAoEA,0BAAc,+BApEd;AAqEA,0BAAc,mCArEd;AAsEA,0BAAc,2BAtEd;AAuEA,sBAA2B;AAC3B,0BAAc,iCAxEd;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\nexport {\n  AcceptWhatsAppCallResponse,\n  AliOSSUpload,\n  AgentDispatch,\n  AudioCodec,\n  AutoParticipantEgress,\n  AutoTrackEgress,\n  AzureBlobUpload,\n  ConnectTwilioCallRequest_TwilioCallDirection,\n  ConnectTwilioCallResponse,\n  ConnectWhatsAppCallResponse,\n  DataPacket_Kind,\n  DialWhatsAppCallResponse,\n  DirectFileOutput,\n  DisconnectWhatsAppCallResponse,\n  EgressInfo,\n  EgressStatus,\n  EncodedFileOutput,\n  EncodedFileType,\n  EncodingOptions,\n  EncodingOptionsPreset,\n  GCPUpload,\n  ImageCodec,\n  ImageFileSuffix,\n  ImageOutput,\n  IngressAudioEncodingOptions,\n  IngressAudioEncodingPreset,\n  IngressAudioOptions,\n  IngressInfo,\n  IngressInput,\n  IngressState,\n  IngressVideoEncodingOptions,\n  IngressVideoEncodingPreset,\n  IngressVideoOptions,\n  ParticipantEgressRequest,\n  ParticipantInfo,\n  ParticipantInfo_State,\n  ParticipantPermission,\n  Room,\n  RoomAgentDispatch,\n  RoomCompositeEgressRequest,\n  RoomConfiguration,\n  RoomEgress,\n  S3Upload,\n  SessionDescription,\n  SIPDispatchRule,\n  SIPDispatchRuleInfo,\n  SIPDispatchRuleDirect,\n  SIPDispatchRuleIndividual,\n  SIPParticipantInfo,\n  SIPOutboundTrunkInfo,\n  SIPInboundTrunkInfo,\n  SIPTrunkInfo,\n  SIPCallStatus,\n  SegmentedFileOutput,\n  SegmentedFileProtocol,\n  StreamOutput,\n  StreamProtocol,\n  TrackCompositeEgressRequest,\n  TrackEgressRequest,\n  TrackInfo,\n  TrackSource,\n  TrackType,\n  WebEgressRequest,\n  VideoCodec,\n  WebhookConfig,\n} from '@livekit/protocol';\nexport * from './AccessToken.js';\nexport * from './AgentDispatchClient.js';\nexport * from './ConnectorClient.js';\nexport * from './EgressClient.js';\nexport * from './grants.js';\nexport * from './IngressClient.js';\nexport * from './RoomServiceClient.js';\nexport * from './SipClient.js';\nexport { TwirpError } from './TwirpRPC.js';\nexport * from './WebhookReceiver.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,sBAkEO;AACP,0BAAc,6BAvEd;AAwEA,0BAAc,qCAxEd;AAyEA,0BAAc,iCAzEd;AA0EA,0BAAc,8BA1Ed;AA2EA,0BAAc,wBA3Ed;AA4EA,0BAAc,+BA5Ed;AA6EA,0BAAc,mCA7Ed;AA8EA,0BAAc,2BA9Ed;AA+EA,sBAA2B;AAC3B,0BAAc,iCAhFd;","names":[]}

package/dist/index.d.cts

@@ -1,6 +1,7 @@
-export { AgentDispatch, AliOSSUpload, AudioCodec, AutoParticipantEgress, AutoTrackEgress, AzureBlobUpload, DataPacket_Kind, DirectFileOutput, EgressInfo, EgressStatus, EncodedFileOutput, EncodedFileType, EncodingOptions, EncodingOptionsPreset, GCPUpload, ImageCodec, ImageFileSuffix, ImageOutput, IngressAudioEncodingOptions, IngressAudioEncodingPreset, IngressAudioOptions, IngressInfo, IngressInput, IngressState, IngressVideoEncodingOptions, IngressVideoEncodingPreset, IngressVideoOptions, ParticipantEgressRequest, ParticipantInfo, ParticipantInfo_State, ParticipantPermission, Room, RoomAgentDispatch, RoomCompositeEgressRequest, RoomConfiguration, RoomEgress, S3Upload, SIPCallStatus, SIPDispatchRule, SIPDispatchRuleDirect, SIPDispatchRuleIndividual, SIPDispatchRuleInfo, SIPInboundTrunkInfo, SIPOutboundTrunkInfo, SIPParticipantInfo, SIPTrunkInfo, SegmentedFileOutput, SegmentedFileProtocol, StreamOutput, StreamProtocol, TrackCompositeEgressRequest, TrackEgressRequest, TrackInfo, TrackSource, TrackType, VideoCodec, WebEgressRequest, WebhookConfig } from '@livekit/protocol';
+export { AcceptWhatsAppCallResponse, AgentDispatch, AliOSSUpload, AudioCodec, AutoParticipantEgress, AutoTrackEgress, AzureBlobUpload, ConnectTwilioCallRequest_TwilioCallDirection, ConnectTwilioCallResponse, ConnectWhatsAppCallResponse, DataPacket_Kind, DialWhatsAppCallResponse, DirectFileOutput, DisconnectWhatsAppCallResponse, EgressInfo, EgressStatus, EncodedFileOutput, EncodedFileType, EncodingOptions, EncodingOptionsPreset, GCPUpload, ImageCodec, ImageFileSuffix, ImageOutput, IngressAudioEncodingOptions, IngressAudioEncodingPreset, IngressAudioOptions, IngressInfo, IngressInput, IngressState, IngressVideoEncodingOptions, IngressVideoEncodingPreset, IngressVideoOptions, ParticipantEgressRequest, ParticipantInfo, ParticipantInfo_State, ParticipantPermission, Room, RoomAgentDispatch, RoomCompositeEgressRequest, RoomConfiguration, RoomEgress, S3Upload, SIPCallStatus, SIPDispatchRule, SIPDispatchRuleDirect, SIPDispatchRuleIndividual, SIPDispatchRuleInfo, SIPInboundTrunkInfo, SIPOutboundTrunkInfo, SIPParticipantInfo, SIPTrunkInfo, SegmentedFileOutput, SegmentedFileProtocol, SessionDescription, StreamOutput, StreamProtocol, TrackCompositeEgressRequest, TrackEgressRequest, TrackInfo, TrackSource, TrackType, VideoCodec, WebEgressRequest, WebhookConfig } from '@livekit/protocol';
 export { AccessToken, AccessTokenOptions, TokenVerifier } from './AccessToken.cjs';
 export { AgentDispatchClient } from './AgentDispatchClient.cjs';
+export { AcceptWhatsAppCallOptions, ConnectTwilioCallOptions, ConnectorClient, DialWhatsAppCallOptions } from './ConnectorClient.cjs';
 export { BaseOptions, EgressClient, EncodedOutputs, ListEgressOptions, ParticipantEgressOptions, RoomCompositeOptions, TrackCompositeOptions, WebOptions } from './EgressClient.cjs';
 export { ClaimGrants, InferenceGrant, ObservabilityGrant, SIPGrant, VideoGrant, claimsToJwtPayload, trackSourceToString } from './grants.cjs';
 export { CreateIngressOptions, IngressClient, ListIngressOptions, UpdateIngressOptions } from './IngressClient.cjs';

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-export { AliOSSUpload, AgentDispatch, AudioCodec, AutoParticipantEgress, AutoTrackEgress, AzureBlobUpload, DataPacket_Kind, DirectFileOutput, EgressInfo, EgressStatus, EncodedFileOutput, EncodedFileType, EncodingOptions, EncodingOptionsPreset, GCPUpload, ImageCodec, ImageFileSuffix, ImageOutput, IngressAudioEncodingOptions, IngressAudioEncodingPreset, IngressAudioOptions, IngressInfo, IngressInput, IngressState, IngressVideoEncodingOptions, IngressVideoEncodingPreset, IngressVideoOptions, ParticipantEgressRequest, ParticipantInfo, ParticipantInfo_State, ParticipantPermission, Room, RoomAgentDispatch, RoomCompositeEgressRequest, RoomConfiguration, RoomEgress, S3Upload, SIPDispatchRule, SIPDispatchRuleInfo, SIPDispatchRuleDirect, SIPDispatchRuleIndividual, SIPParticipantInfo, SIPOutboundTrunkInfo, SIPInboundTrunkInfo, SIPTrunkInfo, SIPCallStatus, SegmentedFileOutput, SegmentedFileProtocol, StreamOutput, StreamProtocol, TrackCompositeEgressRequest, TrackEgressRequest, TrackInfo, TrackSource, TrackType, WebEgressRequest, VideoCodec, WebhookConfig, } from '@livekit/protocol';
+export { AcceptWhatsAppCallResponse, AliOSSUpload, AgentDispatch, AudioCodec, AutoParticipantEgress, AutoTrackEgress, AzureBlobUpload, ConnectTwilioCallRequest_TwilioCallDirection, ConnectTwilioCallResponse, ConnectWhatsAppCallResponse, DataPacket_Kind, DialWhatsAppCallResponse, DirectFileOutput, DisconnectWhatsAppCallResponse, EgressInfo, EgressStatus, EncodedFileOutput, EncodedFileType, EncodingOptions, EncodingOptionsPreset, GCPUpload, ImageCodec, ImageFileSuffix, ImageOutput, IngressAudioEncodingOptions, IngressAudioEncodingPreset, IngressAudioOptions, IngressInfo, IngressInput, IngressState, IngressVideoEncodingOptions, IngressVideoEncodingPreset, IngressVideoOptions, ParticipantEgressRequest, ParticipantInfo, ParticipantInfo_State, ParticipantPermission, Room, RoomAgentDispatch, RoomCompositeEgressRequest, RoomConfiguration, RoomEgress, S3Upload, SessionDescription, SIPDispatchRule, SIPDispatchRuleInfo, SIPDispatchRuleDirect, SIPDispatchRuleIndividual, SIPParticipantInfo, SIPOutboundTrunkInfo, SIPInboundTrunkInfo, SIPTrunkInfo, SIPCallStatus, SegmentedFileOutput, SegmentedFileProtocol, StreamOutput, StreamProtocol, TrackCompositeEgressRequest, TrackEgressRequest, TrackInfo, TrackSource, TrackType, WebEgressRequest, VideoCodec, WebhookConfig, } from '@livekit/protocol';
 export * from './AccessToken.js';
 export * from './AgentDispatchClient.js';
+export * from './ConnectorClient.js';
 export * from './EgressClient.js';
 export * from './grants.js';
 export * from './IngressClient.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,YAAY,EACZ,aAAa,EACb,UAAU,EACV,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,SAAS,EACT,UAAU,EACV,eAAe,EACf,WAAW,EACX,2BAA2B,EAC3B,0BAA0B,EAC1B,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,2BAA2B,EAC3B,0BAA0B,EAC1B,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,IAAI,EACJ,iBAAiB,EACjB,0BAA0B,EAC1B,iBAAiB,EACjB,UAAU,EACV,QAAQ,EACR,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,2BAA2B,EAC3B,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,0BAA0B,EAC1B,YAAY,EACZ,aAAa,EACb,UAAU,EACV,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,4CAA4C,EAC5C,yBAAyB,EACzB,2BAA2B,EAC3B,eAAe,EACf,wBAAwB,EACxB,gBAAgB,EAChB,8BAA8B,EAC9B,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,SAAS,EACT,UAAU,EACV,eAAe,EACf,WAAW,EACX,2BAA2B,EAC3B,0BAA0B,EAC1B,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,2BAA2B,EAC3B,0BAA0B,EAC1B,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,IAAI,EACJ,iBAAiB,EACjB,0BAA0B,EAC1B,iBAAiB,EACjB,UAAU,EACV,QAAQ,EACR,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,2BAA2B,EAC3B,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,12 +1,18 @@
 import {
+  AcceptWhatsAppCallResponse,
   AliOSSUpload,
   AgentDispatch,
   AudioCodec,
   AutoParticipantEgress,
   AutoTrackEgress,
   AzureBlobUpload,
+  ConnectTwilioCallRequest_TwilioCallDirection,
+  ConnectTwilioCallResponse,
+  ConnectWhatsAppCallResponse,
   DataPacket_Kind,
+  DialWhatsAppCallResponse,
   DirectFileOutput,
+  DisconnectWhatsAppCallResponse,
   EgressInfo,
   EgressStatus,
   EncodedFileOutput,
@@ -36,6 +42,7 @@ import {
   RoomConfiguration,
   RoomEgress,
   S3Upload,
+  SessionDescription,
   SIPDispatchRule,
   SIPDispatchRuleInfo,
   SIPDispatchRuleDirect,
@@ -60,6 +67,7 @@ import {
 } from "@livekit/protocol";
 export * from "./AccessToken.js";
 export * from "./AgentDispatchClient.js";
+export * from "./ConnectorClient.js";
 export * from "./EgressClient.js";
 export * from "./grants.js";
 export * from "./IngressClient.js";
@@ -68,14 +76,20 @@ export * from "./SipClient.js";
 import { TwirpError } from "./TwirpRPC.js";
 export * from "./WebhookReceiver.js";
 export {
+  AcceptWhatsAppCallResponse,
   AgentDispatch,
   AliOSSUpload,
   AudioCodec,
   AutoParticipantEgress,
   AutoTrackEgress,
   AzureBlobUpload,
+  ConnectTwilioCallRequest_TwilioCallDirection,
+  ConnectTwilioCallResponse,
+  ConnectWhatsAppCallResponse,
   DataPacket_Kind,
+  DialWhatsAppCallResponse,
   DirectFileOutput,
+  DisconnectWhatsAppCallResponse,
   EgressInfo,
   EgressStatus,
   EncodedFileOutput,
@@ -116,6 +130,7 @@ export {
   SIPTrunkInfo,
   SegmentedFileOutput,
   SegmentedFileProtocol,
+  SessionDescription,
   StreamOutput,
   StreamProtocol,
   TrackCompositeEgressRequest,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\nexport {\n  AliOSSUpload,\n  AgentDispatch,\n  AudioCodec,\n  AutoParticipantEgress,\n  AutoTrackEgress,\n  AzureBlobUpload,\n  DataPacket_Kind,\n  DirectFileOutput,\n  EgressInfo,\n  EgressStatus,\n  EncodedFileOutput,\n  EncodedFileType,\n  EncodingOptions,\n  EncodingOptionsPreset,\n  GCPUpload,\n  ImageCodec,\n  ImageFileSuffix,\n  ImageOutput,\n  IngressAudioEncodingOptions,\n  IngressAudioEncodingPreset,\n  IngressAudioOptions,\n  IngressInfo,\n  IngressInput,\n  IngressState,\n  IngressVideoEncodingOptions,\n  IngressVideoEncodingPreset,\n  IngressVideoOptions,\n  ParticipantEgressRequest,\n  ParticipantInfo,\n  ParticipantInfo_State,\n  ParticipantPermission,\n  Room,\n  RoomAgentDispatch,\n  RoomCompositeEgressRequest,\n  RoomConfiguration,\n  RoomEgress,\n  S3Upload,\n  SIPDispatchRule,\n  SIPDispatchRuleInfo,\n  SIPDispatchRuleDirect,\n  SIPDispatchRuleIndividual,\n  SIPParticipantInfo,\n  SIPOutboundTrunkInfo,\n  SIPInboundTrunkInfo,\n  SIPTrunkInfo,\n  SIPCallStatus,\n  SegmentedFileOutput,\n  SegmentedFileProtocol,\n  StreamOutput,\n  StreamProtocol,\n  TrackCompositeEgressRequest,\n  TrackEgressRequest,\n  TrackInfo,\n  TrackSource,\n  TrackType,\n  WebEgressRequest,\n  VideoCodec,\n  WebhookConfig,\n} from '@livekit/protocol';\nexport * from './AccessToken.js';\nexport * from './AgentDispatchClient.js';\nexport * from './EgressClient.js';\nexport * from './grants.js';\nexport * from './IngressClient.js';\nexport * from './RoomServiceClient.js';\nexport * from './SipClient.js';\nexport { TwirpError } from './TwirpRPC.js';\nexport * from './WebhookReceiver.js';\n"],"mappings":"AAIA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,SAAS,kBAAkB;AAC3B,cAAc;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\nexport {\n  AcceptWhatsAppCallResponse,\n  AliOSSUpload,\n  AgentDispatch,\n  AudioCodec,\n  AutoParticipantEgress,\n  AutoTrackEgress,\n  AzureBlobUpload,\n  ConnectTwilioCallRequest_TwilioCallDirection,\n  ConnectTwilioCallResponse,\n  ConnectWhatsAppCallResponse,\n  DataPacket_Kind,\n  DialWhatsAppCallResponse,\n  DirectFileOutput,\n  DisconnectWhatsAppCallResponse,\n  EgressInfo,\n  EgressStatus,\n  EncodedFileOutput,\n  EncodedFileType,\n  EncodingOptions,\n  EncodingOptionsPreset,\n  GCPUpload,\n  ImageCodec,\n  ImageFileSuffix,\n  ImageOutput,\n  IngressAudioEncodingOptions,\n  IngressAudioEncodingPreset,\n  IngressAudioOptions,\n  IngressInfo,\n  IngressInput,\n  IngressState,\n  IngressVideoEncodingOptions,\n  IngressVideoEncodingPreset,\n  IngressVideoOptions,\n  ParticipantEgressRequest,\n  ParticipantInfo,\n  ParticipantInfo_State,\n  ParticipantPermission,\n  Room,\n  RoomAgentDispatch,\n  RoomCompositeEgressRequest,\n  RoomConfiguration,\n  RoomEgress,\n  S3Upload,\n  SessionDescription,\n  SIPDispatchRule,\n  SIPDispatchRuleInfo,\n  SIPDispatchRuleDirect,\n  SIPDispatchRuleIndividual,\n  SIPParticipantInfo,\n  SIPOutboundTrunkInfo,\n  SIPInboundTrunkInfo,\n  SIPTrunkInfo,\n  SIPCallStatus,\n  SegmentedFileOutput,\n  SegmentedFileProtocol,\n  StreamOutput,\n  StreamProtocol,\n  TrackCompositeEgressRequest,\n  TrackEgressRequest,\n  TrackInfo,\n  TrackSource,\n  TrackType,\n  WebEgressRequest,\n  VideoCodec,\n  WebhookConfig,\n} from '@livekit/protocol';\nexport * from './AccessToken.js';\nexport * from './AgentDispatchClient.js';\nexport * from './ConnectorClient.js';\nexport * from './EgressClient.js';\nexport * from './grants.js';\nexport * from './IngressClient.js';\nexport * from './RoomServiceClient.js';\nexport * from './SipClient.js';\nexport { TwirpError } from './TwirpRPC.js';\nexport * from './WebhookReceiver.js';\n"],"mappings":"AAIA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,SAAS,kBAAkB;AAC3B,cAAc;","names":[]}

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "livekit-server-sdk",
-  "version": "2.14.2",
+  "version": "2.15.0",
   "description": "Server-side SDK for LiveKit",
   "main": "dist/index.js",
   "require": "dist/index.cjs",
   "types": "dist/index.d.ts",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/livekit/server-sdk-js.git"
+    "url": "https://github.com/livekit/node-sdks.git",
+    "directory": "packages/livekit-server-sdk"
   },
   "author": "David Zhao <david@davidzhao.com>",
   "license": "Apache-2.0",
@@ -30,7 +31,7 @@
   ],
   "dependencies": {
     "@bufbuild/protobuf": "^1.10.1",
-    "@livekit/protocol": "^1.42.0",
+    "@livekit/protocol": "^1.43.1",
     "camelcase-keys": "^9.0.0",
     "jose": "^5.1.2"
   },

package/src/ConnectorClient.ts

@@ -0,0 +1,282 @@
+// SPDX-FileCopyrightText: 2025 LiveKit, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+import type {
+  ConnectTwilioCallRequest_TwilioCallDirection,
+  RoomAgentDispatch,
+  SessionDescription,
+} from '@livekit/protocol';
+import {
+  AcceptWhatsAppCallRequest,
+  AcceptWhatsAppCallResponse,
+  ConnectTwilioCallRequest,
+  ConnectTwilioCallResponse,
+  ConnectWhatsAppCallRequest,
+  ConnectWhatsAppCallResponse,
+  DialWhatsAppCallRequest,
+  DialWhatsAppCallResponse,
+  DisconnectWhatsAppCallRequest,
+  DisconnectWhatsAppCallResponse,
+} from '@livekit/protocol';
+import type { ClientOptions } from './ClientOptions.js';
+import { ServiceBase } from './ServiceBase.js';
+import { type Rpc, TwirpRpc, livekitPackage } from './TwirpRPC.js';
+
+const svc = 'Connector';
+
+// WhatsApp types
+export interface DialWhatsAppCallOptions {
+  /** Required - The identifier of the WhatsApp phone number that is initiating the call */
+  whatsappPhoneNumberId: string;
+  /** Required - The number of the user that is supposed to receive the call */
+  whatsappToPhoneNumber: string;
+  /** Required - The API key of the business that is initiating the call */
+  whatsappApiKey: string;
+  /** Required - WhatsApp Cloud API version, eg: 23.0, 24.0, etc. */
+  whatsappCloudApiVersion: string;
+  /** Optional - An arbitrary string you can pass in that is useful for tracking and logging purposes */
+  whatsappBizOpaqueCallbackData?: string;
+  /** Optional - What LiveKit room should this participant be connected to */
+  roomName?: string;
+  /** Optional - Agents to dispatch the call to */
+  agents?: RoomAgentDispatch[];
+  /** Optional - Identity of the participant in LiveKit room */
+  participantIdentity?: string;
+  /** Optional - Name of the participant in LiveKit room */
+  participantName?: string;
+  /** Optional - User-defined metadata. Will be attached to a created Participant in the room. */
+  participantMetadata?: string;
+  /** Optional - User-defined attributes. Will be attached to a created Participant in the room. */
+  participantAttributes?: { [key: string]: string };
+  /** Optional - Country where the call terminates as ISO 3166-1 alpha-2 */
+  destinationCountry?: string;
+}
+
+export interface AcceptWhatsAppCallOptions {
+  /** Required - The identifier of the WhatsApp phone number that is connecting the call */
+  whatsappPhoneNumberId: string;
+  /** Required - The API key of the business that is connecting the call */
+  whatsappApiKey: string;
+  /** Required - WhatsApp Cloud API version, eg: 23.0, 24.0, etc. */
+  whatsappCloudApiVersion: string;
+  /** Required - Call ID sent by Meta */
+  whatsappCallId: string;
+  /** Optional - An arbitrary string you can pass in that is useful for tracking and logging purposes */
+  whatsappBizOpaqueCallbackData?: string;
+  /** Required - The call accept webhook comes with SDP from Meta */
+  sdp: SessionDescription;
+  /** Optional - What LiveKit room should this participant be connected to */
+  roomName?: string;
+  /** Optional - Agents to dispatch the call to */
+  agents?: RoomAgentDispatch[];
+  /** Optional - Identity of the participant in LiveKit room */
+  participantIdentity?: string;
+  /** Optional - Name of the participant in LiveKit room */
+  participantName?: string;
+  /** Optional - User-defined metadata. Will be attached to a created Participant in the room. */
+  participantMetadata?: string;
+  /** Optional - User-defined attributes. Will be attached to a created Participant in the room. */
+  participantAttributes?: { [key: string]: string };
+  /** Optional - Country where the call terminates as ISO 3166-1 alpha-2 */
+  destinationCountry?: string;
+}
+
+// Twilio types
+export interface ConnectTwilioCallOptions {
+  /** The direction of the call */
+  twilioCallDirection: ConnectTwilioCallRequest_TwilioCallDirection;
+  /** What LiveKit room should this call be connected to */
+  roomName: string;
+  /** Optional agents to dispatch the call to */
+  agents?: RoomAgentDispatch[];
+  /** Optional identity of the participant in LiveKit room */
+  participantIdentity?: string;
+  /** Optional name of the participant in LiveKit room */
+  participantName?: string;
+  /** Optional user-defined metadata. Will be attached to a created Participant in the room. */
+  participantMetadata?: string;
+  /** Optional user-defined attributes. Will be attached to a created Participant in the room. */
+  participantAttributes?: { [key: string]: string };
+  /** Country where the call terminates as ISO 3166-1 alpha-2 */
+  destinationCountry?: string;
+}
+
+/**
+ * Client to access Connector APIs for WhatsApp and Twilio integrations
+ */
+export class ConnectorClient extends ServiceBase {
+  private readonly rpc: Rpc;
+
+  /**
+   * @param host - hostname including protocol. i.e. 'https://<project>.livekit.cloud'
+   * @param apiKey - API Key, can be set in env var LIVEKIT_API_KEY
+   * @param secret - API Secret, can be set in env var LIVEKIT_API_SECRET
+   * @param options - client options
+   */
+  constructor(host: string, apiKey?: string, secret?: string, options?: ClientOptions) {
+    super(apiKey, secret);
+    const rpcOptions = options?.requestTimeout
+      ? { requestTimeout: options.requestTimeout }
+      : undefined;
+    this.rpc = new TwirpRpc(host, livekitPackage, rpcOptions);
+  }
+
+  /**
+   * Initiate an outbound WhatsApp call
+   *
+   * @param options - WhatsApp call options
+   * @returns Promise containing the WhatsApp call ID and room name
+   */
+  async dialWhatsAppCall(options: DialWhatsAppCallOptions): Promise<DialWhatsAppCallResponse> {
+    const whatsappBizOpaqueCallbackData = options.whatsappBizOpaqueCallbackData || '';
+    const roomName = options.roomName || '';
+    const participantIdentity = options.participantIdentity || '';
+    const participantName = options.participantName || '';
+    const participantMetadata = options.participantMetadata || '';
+    const destinationCountry = options.destinationCountry || '';
+
+    const req = new DialWhatsAppCallRequest({
+      whatsappPhoneNumberId: options.whatsappPhoneNumberId,
+      whatsappToPhoneNumber: options.whatsappToPhoneNumber,
+      whatsappApiKey: options.whatsappApiKey,
+      whatsappCloudApiVersion: options.whatsappCloudApiVersion,
+      whatsappBizOpaqueCallbackData,
+      roomName,
+      agents: options.agents,
+      participantIdentity,
+      participantName,
+      participantMetadata,
+      participantAttributes: options.participantAttributes,
+      destinationCountry,
+    }).toJson();
+
+    const data = await this.rpc.request(
+      svc,
+      'DialWhatsAppCall',
+      req,
+      await this.authHeader({ roomCreate: true }),
+    );
+    return DialWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });
+  }
+
+  /**
+   * Accept an inbound WhatsApp call
+   *
+   * @param options - WhatsApp call accept options
+   * @returns Promise containing the room name
+   */
+  async acceptWhatsAppCall(
+    options: AcceptWhatsAppCallOptions,
+  ): Promise<AcceptWhatsAppCallResponse> {
+    const whatsappBizOpaqueCallbackData = options.whatsappBizOpaqueCallbackData || '';
+    const roomName = options.roomName || '';
+    const participantIdentity = options.participantIdentity || '';
+    const participantName = options.participantName || '';
+    const participantMetadata = options.participantMetadata || '';
+    const destinationCountry = options.destinationCountry || '';
+
+    const req = new AcceptWhatsAppCallRequest({
+      whatsappPhoneNumberId: options.whatsappPhoneNumberId,
+      whatsappApiKey: options.whatsappApiKey,
+      whatsappCloudApiVersion: options.whatsappCloudApiVersion,
+      whatsappCallId: options.whatsappCallId,
+      whatsappBizOpaqueCallbackData,
+      sdp: options.sdp,
+      roomName,
+      agents: options.agents,
+      participantIdentity,
+      participantName,
+      participantMetadata,
+      participantAttributes: options.participantAttributes,
+      destinationCountry,
+    }).toJson();
+
+    const data = await this.rpc.request(
+      svc,
+      'AcceptWhatsAppCall',
+      req,
+      await this.authHeader({ roomCreate: true }),
+    );
+    return AcceptWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });
+  }
+
+  /**
+   * Connect an established WhatsApp call (used for business-initiated calls)
+   *
+   * @param whatsappCallId - Call ID sent by Meta
+   * @param sdp - Session description from Meta
+   */
+  async connectWhatsAppCall(
+    whatsappCallId: string,
+    sdp: SessionDescription,
+  ): Promise<ConnectWhatsAppCallResponse> {
+    const req = new ConnectWhatsAppCallRequest({
+      whatsappCallId,
+      sdp,
+    }).toJson();
+
+    const data = await this.rpc.request(
+      svc,
+      'ConnectWhatsAppCall',
+      req,
+      await this.authHeader({ roomCreate: true }),
+    );
+    return ConnectWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });
+  }
+
+  /**
+   * Disconnect an active WhatsApp call
+   *
+   * @param whatsappCallId - Call ID sent by Meta
+   * @param whatsappApiKey - The API key of the business that is disconnecting the call
+   */
+  async disconnectWhatsAppCall(
+    whatsappCallId: string,
+    whatsappApiKey: string,
+  ): Promise<DisconnectWhatsAppCallResponse> {
+    const req = new DisconnectWhatsAppCallRequest({
+      whatsappCallId,
+      whatsappApiKey,
+    }).toJson();
+
+    const data = await this.rpc.request(
+      svc,
+      'DisconnectWhatsAppCall',
+      req,
+      await this.authHeader({ roomCreate: true }),
+    );
+    return DisconnectWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });
+  }
+
+  /**
+   * Connect a Twilio call to a LiveKit room
+   *
+   * @param options - Twilio call connection options
+   * @returns Promise containing the WebSocket connect URL for Twilio media stream
+   */
+  async connectTwilioCall(options: ConnectTwilioCallOptions): Promise<ConnectTwilioCallResponse> {
+    const participantIdentity = options.participantIdentity || '';
+    const participantName = options.participantName || '';
+    const participantMetadata = options.participantMetadata || '';
+    const destinationCountry = options.destinationCountry || '';
+
+    const req = new ConnectTwilioCallRequest({
+      twilioCallDirection: options.twilioCallDirection,
+      roomName: options.roomName,
+      agents: options.agents,
+      participantIdentity,
+      participantName,
+      participantMetadata,
+      participantAttributes: options.participantAttributes,
+      destinationCountry,
+    }).toJson();
+
+    const data = await this.rpc.request(
+      svc,
+      'ConnectTwilioCall',
+      req,
+      await this.authHeader({ roomCreate: true }),
+    );
+    return ConnectTwilioCallResponse.fromJson(data, { ignoreUnknownFields: true });
+  }
+}

package/src/index.ts

@@ -3,14 +3,20 @@
 // SPDX-License-Identifier: Apache-2.0
 
 export {
+  AcceptWhatsAppCallResponse,
   AliOSSUpload,
   AgentDispatch,
   AudioCodec,
   AutoParticipantEgress,
   AutoTrackEgress,
   AzureBlobUpload,
+  ConnectTwilioCallRequest_TwilioCallDirection,
+  ConnectTwilioCallResponse,
+  ConnectWhatsAppCallResponse,
   DataPacket_Kind,
+  DialWhatsAppCallResponse,
   DirectFileOutput,
+  DisconnectWhatsAppCallResponse,
   EgressInfo,
   EgressStatus,
   EncodedFileOutput,
@@ -40,6 +46,7 @@ export {
   RoomConfiguration,
   RoomEgress,
   S3Upload,
+  SessionDescription,
   SIPDispatchRule,
   SIPDispatchRuleInfo,
   SIPDispatchRuleDirect,
@@ -64,6 +71,7 @@ export {
 } from '@livekit/protocol';
 export * from './AccessToken.js';
 export * from './AgentDispatchClient.js';
+export * from './ConnectorClient.js';
 export * from './EgressClient.js';
 export * from './grants.js';
 export * from './IngressClient.js';