livekit-server-sdk 2.14.2 → 2.15.1

package/dist/ConnectorClient.d.ts

@@ -0,0 +1,134 @@
+import { RoomAgentDispatch, SessionDescription, ConnectTwilioCallRequest_TwilioCallDirection, DialWhatsAppCallResponse, AcceptWhatsAppCallResponse, ConnectWhatsAppCallResponse, DisconnectWhatsAppCallResponse, ConnectTwilioCallResponse } from '@livekit/protocol';
+import { ClientOptions } from './ClientOptions.js';
+import { ServiceBase } from './ServiceBase.js';
+import './grants.js';
+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.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/EgressClient.d.ts

@@ -1,14 +1,16 @@
-import type { DirectFileOutput, EncodedFileOutput, EncodingOptions, EncodingOptionsPreset, ImageOutput, SegmentedFileOutput, StreamOutput, WebhookConfig } from '@livekit/protocol';
-import { AudioMixing, EgressInfo } from '@livekit/protocol';
-import type { ClientOptions } from './ClientOptions.js';
+import { WebhookConfig, EncodingOptionsPreset, EncodingOptions, AudioMixing, EncodedFileOutput, StreamOutput, SegmentedFileOutput, ImageOutput, EgressInfo, DirectFileOutput } from '@livekit/protocol';
+import { ClientOptions } from './ClientOptions.js';
 import { ServiceBase } from './ServiceBase.js';
-export interface BaseOptions {
+import './grants.js';
+import 'jose';
+
+interface BaseOptions {
     /**
      * webhooks to call for this request, optional.
      */
     webhooks?: WebhookConfig[];
 }
-export interface RoomCompositeOptions extends BaseOptions {
+interface RoomCompositeOptions extends BaseOptions {
     /**
      * egress layout. optional
      */
@@ -34,7 +36,7 @@ export interface RoomCompositeOptions extends BaseOptions {
      */
     audioMixing?: AudioMixing;
 }
-export interface WebOptions extends BaseOptions {
+interface WebOptions extends BaseOptions {
     /**
      * encoding options or preset. optional
      */
@@ -52,7 +54,7 @@ export interface WebOptions extends BaseOptions {
      */
     awaitStartSignal?: boolean;
 }
-export interface ParticipantEgressOptions extends BaseOptions {
+interface ParticipantEgressOptions extends BaseOptions {
     /**
      * true to capture source screenshare and screenshare_audio
      * false to capture camera and microphone
@@ -63,7 +65,7 @@ export interface ParticipantEgressOptions extends BaseOptions {
      */
     encodingOptions?: EncodingOptionsPreset | EncodingOptions;
 }
-export interface TrackCompositeOptions extends BaseOptions {
+interface TrackCompositeOptions extends BaseOptions {
     /**
      * audio track ID
      */
@@ -80,13 +82,13 @@ export interface TrackCompositeOptions extends BaseOptions {
 /**
  * Used to supply multiple outputs with an egress request
  */
-export interface EncodedOutputs {
+interface EncodedOutputs {
     file?: EncodedFileOutput | undefined;
     stream?: StreamOutput | undefined;
     segments?: SegmentedFileOutput | undefined;
     images?: ImageOutput | undefined;
 }
-export interface ListEgressOptions {
+interface ListEgressOptions {
     roomName?: string;
     egressId?: string;
     active?: boolean;
@@ -94,7 +96,7 @@ export interface ListEgressOptions {
 /**
  * Client to access Egress APIs
  */
-export declare class EgressClient extends ServiceBase {
+declare class EgressClient extends ServiceBase {
     private readonly rpc;
     /**
      * @param host - hostname including protocol. i.e. 'https://<project>.livekit.cloud'
@@ -174,4 +176,5 @@ export declare class EgressClient extends ServiceBase {
      */
     stopEgress(egressId: string): Promise<EgressInfo>;
 }
-//# sourceMappingURL=EgressClient.d.ts.map
+
+export { type BaseOptions, EgressClient, type EncodedOutputs, type ListEgressOptions, type ParticipantEgressOptions, type RoomCompositeOptions, type TrackCompositeOptions, type WebOptions };

package/dist/IngressClient.d.ts

@@ -1,8 +1,10 @@
-import type { IngressAudioOptions, IngressInput, IngressVideoOptions } from '@livekit/protocol';
-import { IngressInfo } from '@livekit/protocol';
-import type { ClientOptions } from './ClientOptions.js';
+import { IngressAudioOptions, IngressVideoOptions, IngressInput, IngressInfo } from '@livekit/protocol';
+import { ClientOptions } from './ClientOptions.js';
 import { ServiceBase } from './ServiceBase.js';
-export interface CreateIngressOptions {
+import './grants.js';
+import 'jose';
+
+interface CreateIngressOptions {
     /**
      * ingress name. optional
      */
@@ -46,7 +48,7 @@ export interface CreateIngressOptions {
      */
     video?: IngressVideoOptions;
 }
-export interface UpdateIngressOptions {
+interface UpdateIngressOptions {
     /**
      * ingress name. optional
      */
@@ -86,7 +88,7 @@ export interface UpdateIngressOptions {
      */
     video?: IngressVideoOptions;
 }
-export interface ListIngressOptions {
+interface ListIngressOptions {
     /**
      * list ingress for one room only
      */
@@ -99,7 +101,7 @@ export interface ListIngressOptions {
 /**
  * Client to access Ingress APIs
  */
-export declare class IngressClient extends ServiceBase {
+declare class IngressClient extends ServiceBase {
     private readonly rpc;
     /**
      * @param host - hostname including protocol. i.e. 'https://<project>.livekit.cloud'
@@ -132,4 +134,5 @@ export declare class IngressClient extends ServiceBase {
      */
     deleteIngress(ingressId: string): Promise<IngressInfo>;
 }
-//# sourceMappingURL=IngressClient.d.ts.map
+
+export { type CreateIngressOptions, IngressClient, type ListIngressOptions, type UpdateIngressOptions };

package/dist/RoomServiceClient.d.ts

@@ -1,11 +1,13 @@
-import type { DataPacket_Kind, RoomAgentDispatch, RoomEgress, TrackInfo } from '@livekit/protocol';
-import { ParticipantInfo, ParticipantPermission, Room } from '@livekit/protocol';
-import type { ClientOptions } from './ClientOptions.js';
+import { RoomEgress, RoomAgentDispatch, ParticipantPermission, Room, ParticipantInfo, TrackInfo, DataPacket_Kind } from '@livekit/protocol';
+import { ClientOptions } from './ClientOptions.js';
 import { ServiceBase } from './ServiceBase.js';
+import './grants.js';
+import 'jose';
+
 /**
  * Options for when creating a room
  */
-export interface CreateOptions {
+interface CreateOptions {
     /**
      * name of the room. required
      */
@@ -55,13 +57,13 @@ export interface CreateOptions {
      */
     nodeId?: string;
 }
-export type SendDataOptions = {
+type SendDataOptions = {
     /** If set, only deliver to listed participant identities */
     destinationIdentities?: string[];
     destinationSids?: string[];
     topic?: string;
 };
-export type UpdateParticipantOptions = {
+type UpdateParticipantOptions = {
     /** only attributes you'd want to update should be set, set value to empty string to remove it */
     attributes?: {
         [key: string]: string;
@@ -74,7 +76,7 @@ export type UpdateParticipantOptions = {
 /**
  * Client to access Room APIs
  */
-export declare class RoomServiceClient extends ServiceBase {
+declare class RoomServiceClient extends ServiceBase {
     private readonly rpc;
     /**
      *
@@ -195,4 +197,5 @@ export declare class RoomServiceClient extends ServiceBase {
      */
     sendData(room: string, data: Uint8Array, kind: DataPacket_Kind, destinationSids?: string[]): Promise<void>;
 }
-//# sourceMappingURL=RoomServiceClient.d.ts.map
+
+export { type CreateOptions, RoomServiceClient, type SendDataOptions, type UpdateParticipantOptions };

package/dist/ServiceBase.d.ts

@@ -1,8 +1,11 @@
-import type { SIPGrant, VideoGrant } from './grants.js';
+import { VideoGrant, SIPGrant } from './grants.js';
+import '@livekit/protocol';
+import 'jose';
+
 /**
  * Utilities to handle authentication
  */
-export declare class ServiceBase {
+declare class ServiceBase {
     private readonly apiKey?;
     private readonly secret?;
     private readonly ttl;
@@ -14,4 +17,5 @@ export declare class ServiceBase {
     constructor(apiKey?: string, secret?: string, ttl?: string);
     authHeader(grant: VideoGrant, sip?: SIPGrant): Promise<Record<string, string>>;
 }
-//# sourceMappingURL=ServiceBase.d.ts.map
+
+export { ServiceBase };

package/dist/SipClient.cjs

@@ -506,7 +506,8 @@ class SipClient extends import_ServiceBase.ServiceBase {
       roomName,
       transferTo,
       playDialtone: opts.playDialtone,
-      headers: opts.headers
+      headers: opts.headers,
+      ringingTimeout: opts.ringingTimeout ? new import_protobuf.Duration({ seconds: BigInt(opts.ringingTimeout) }) : void 0
     }).toJson();
     await this.rpc.request(
       svc,