livekit-server-sdk 2.15.5 → 2.17.0

package/dist/failover.js

@@ -0,0 +1,107 @@
+const FAILOVER_MAX_ATTEMPTS = 3;
+const FAILOVER_BACKOFF_BASE_MS = 200;
+const MIN_FAILOVER_TIMEOUT_SECONDS = 5;
+function failoverAttempts(enabled, hostname, force = false, timeoutSeconds = 0) {
+  if (!enabled || !(force || isCloud(hostname))) {
+    return 1;
+  }
+  if (timeoutSeconds > 0 && timeoutSeconds < MIN_FAILOVER_TIMEOUT_SECONDS) {
+    return 1;
+  }
+  return FAILOVER_MAX_ATTEMPTS;
+}
+function isCloud(hostname) {
+  return hostname.endsWith(".livekit.cloud");
+}
+function toHttp(url) {
+  return url.startsWith("ws") ? `http${url.slice(2)}` : url;
+}
+function hostKey(url) {
+  return url.host.toLowerCase();
+}
+function pickNext(regionOrigins2, attempted) {
+  for (const origin of regionOrigins2) {
+    try {
+      if (!attempted.has(hostKey(new URL(origin)))) {
+        return origin;
+      }
+    } catch {
+    }
+  }
+  return void 0;
+}
+function sleep(ms) {
+  return ms > 0 ? new Promise((resolve) => setTimeout(resolve, ms)) : Promise.resolve();
+}
+const regionCache = /* @__PURE__ */ new Map();
+const inflight = /* @__PURE__ */ new Map();
+async function regionOrigins(origin, headers) {
+  const key = hostKey(origin);
+  const cached = regionCache.get(key);
+  if (cached && Date.now() - cached.fetchedAt < cached.ttl) {
+    return cached.origins;
+  }
+  const existing = inflight.get(key);
+  if (existing) {
+    return existing;
+  }
+  const request = (async () => {
+    try {
+      const { origins, ttl } = await fetchRegions(origin, headers);
+      if (ttl > 0) {
+        regionCache.set(key, { origins, fetchedAt: Date.now(), ttl });
+      }
+      return origins;
+    } catch {
+      return (cached == null ? void 0 : cached.origins) ?? [];
+    } finally {
+      inflight.delete(key);
+    }
+  })();
+  inflight.set(key, request);
+  return request;
+}
+async function fetchRegions(origin, headers) {
+  const fetchHeaders = {};
+  for (const [k, v] of Object.entries(headers ?? {})) {
+    if (k.toLowerCase() === "content-type" || k.toLowerCase() === "content-length") continue;
+    fetchHeaders[k] = v;
+  }
+  const response = await fetch(new URL("/settings/regions", origin.origin), {
+    method: "GET",
+    headers: fetchHeaders,
+    // Short timeout so a slow/unreachable discovery endpoint doesn't stall the
+    // failover path.
+    signal: AbortSignal.timeout(2e3)
+  });
+  if (!response.ok) {
+    throw new Error(`region discovery failed: ${response.status}`);
+  }
+  const ttl = parseMaxAge(response.headers.get("cache-control"));
+  const body = await response.json();
+  const origins = (body.regions ?? []).filter((r) => !!r.url).map((r) => new URL(toHttp(r.url)).origin);
+  return { origins, ttl };
+}
+function parseMaxAge(cacheControl) {
+  if (!cacheControl) return 0;
+  for (const directive of cacheControl.split(",")) {
+    const trimmed = directive.trim().toLowerCase();
+    if (trimmed.startsWith("max-age=")) {
+      const secs = parseInt(trimmed.slice("max-age=".length), 10);
+      return Number.isFinite(secs) && secs > 0 ? secs * 1e3 : 0;
+    }
+  }
+  return 0;
+}
+export {
+  FAILOVER_BACKOFF_BASE_MS,
+  FAILOVER_MAX_ATTEMPTS,
+  MIN_FAILOVER_TIMEOUT_SECONDS,
+  failoverAttempts,
+  hostKey,
+  parseMaxAge,
+  pickNext,
+  regionOrigins,
+  sleep
+};
+//# sourceMappingURL=failover.js.map

package/dist/failover.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/failover.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\n// Region failover for the Twirp API clients.\n//\n// On a retryable failure (any transport error or HTTP 5xx) the client discovers\n// alternative LiveKit Cloud regions via /settings/regions and replays the\n// request against the next region, with exponential backoff. 4xx responses are\n// returned immediately.\n\n// Total attempts (the original request + fallback regions) and the base retry\n// backoff are fixed, not user-configurable, so retries can't be tuned to values\n// that could overwhelm the server.\nexport const FAILOVER_MAX_ATTEMPTS = 3;\nexport const FAILOVER_BACKOFF_BASE_MS = 200;\n// Below this per-request timeout, a retry is unlikely to help and many clients\n// would retry in lockstep across regions, so a short request gets a single\n// attempt (thundering-herd guard).\nexport const MIN_FAILOVER_TIMEOUT_SECONDS = 5;\n\n/**\n * Total request attempts for a host; 1 means no failover. Failover only engages\n * when enabled, the host is a LiveKit Cloud domain, and the request timeout is\n * long enough to retry. `force` bypasses the cloud-host check (test-only).\n */\nexport function failoverAttempts(\n  enabled: boolean,\n  hostname: string,\n  force = false,\n  timeoutSeconds = 0,\n): number {\n  if (!enabled || !(force || isCloud(hostname))) {\n    return 1;\n  }\n  if (timeoutSeconds > 0 && timeoutSeconds < MIN_FAILOVER_TIMEOUT_SECONDS) {\n    return 1;\n  }\n  return FAILOVER_MAX_ATTEMPTS;\n}\n\n// Failover only engages for LiveKit Cloud project domains.\nfunction isCloud(hostname: string): boolean {\n  return hostname.endsWith('.livekit.cloud');\n}\n\n/** Normalizes a region URL to an http(s) scheme (ws -> http, wss -> https). */\nfunction toHttp(url: string): string {\n  return url.startsWith('ws') ? `http${url.slice(2)}` : url;\n}\n\n/** A stable key identifying a host (including port) for dedup across attempts. */\nexport function hostKey(url: URL): string {\n  return url.host.toLowerCase();\n}\n\n/** Returns the first region origin whose host has not yet been attempted. */\nexport function pickNext(regionOrigins: string[], attempted: Set<string>): string | undefined {\n  for (const origin of regionOrigins) {\n    try {\n      if (!attempted.has(hostKey(new URL(origin)))) {\n        return origin;\n      }\n    } catch {\n      // skip malformed URLs\n    }\n  }\n  return undefined;\n}\n\nexport function sleep(ms: number): Promise<void> {\n  return ms > 0 ? new Promise((resolve) => setTimeout(resolve, ms)) : Promise.resolve();\n}\n\ntype CacheEntry = {\n  origins: string[];\n  fetchedAt: number;\n  ttl: number; // ms\n};\n\n// Shared across all clients in the process so the region list is fetched once.\nconst regionCache = new Map<string, CacheEntry>();\n// Coalesces concurrent discovery fetches per origin: while one /settings/regions\n// request is in flight, other callers for the same origin await its result\n// rather than issuing their own (avoids a thundering herd when many requests\n// fail over at once).\nconst inflight = new Map<string, Promise<string[]>>();\n\n/**\n * Returns alternative region origins for `origin`, fetching /settings/regions\n * if the cache is stale. Best-effort: on a fetch failure it serves a stale\n * cached list when available, otherwise an empty list. Forwards `headers` so a\n * valid token — and any test directives — reach the discovery endpoint.\n */\nexport async function regionOrigins(origin: URL, headers: unknown): Promise<string[]> {\n  const key = hostKey(origin);\n  const cached = regionCache.get(key);\n  if (cached && Date.now() - cached.fetchedAt < cached.ttl) {\n    return cached.origins;\n  }\n\n  const existing = inflight.get(key);\n  if (existing) {\n    return existing;\n  }\n  const request = (async () => {\n    try {\n      const { origins, ttl } = await fetchRegions(origin, headers);\n      // A zero TTL (e.g. Cache-Control: max-age=0) means \"do not cache\".\n      if (ttl > 0) {\n        regionCache.set(key, { origins, fetchedAt: Date.now(), ttl });\n      }\n      return origins;\n    } catch {\n      return cached?.origins ?? [];\n    } finally {\n      inflight.delete(key);\n    }\n  })();\n\n  inflight.set(key, request);\n  return request;\n}\n\nasync function fetchRegions(\n  origin: URL,\n  headers: unknown,\n): Promise<{ origins: string[]; ttl: number }> {\n  // Forward the caller's headers (auth + any custom), minus body-specific ones.\n  const fetchHeaders: Record<string, string> = {};\n  for (const [k, v] of Object.entries((headers as Record<string, string>) ?? {})) {\n    if (k.toLowerCase() === 'content-type' || k.toLowerCase() === 'content-length') continue;\n    fetchHeaders[k] = v;\n  }\n\n  const response = await fetch(new URL('/settings/regions', origin.origin), {\n    method: 'GET',\n    headers: fetchHeaders,\n    // Short timeout so a slow/unreachable discovery endpoint doesn't stall the\n    // failover path.\n    signal: AbortSignal.timeout(2000),\n  });\n  if (!response.ok) {\n    throw new Error(`region discovery failed: ${response.status}`);\n  }\n  const ttl = parseMaxAge(response.headers.get('cache-control'));\n  const body = (await response.json()) as { regions?: Array<{ url?: string }> };\n  const origins = (body.regions ?? [])\n    .filter((r) => !!r.url)\n    .map((r) => new URL(toHttp(r.url!)).origin);\n  return { origins, ttl };\n}\n\n/**\n * Returns the `max-age` from a Cache-Control header in milliseconds, or 0 when\n * absent, non-positive, or unparseable (meaning \"do not cache\"). Only `max-age`\n * is honored; other directives (including `s-maxage`, which targets shared\n * proxies) are ignored.\n */\nexport function parseMaxAge(cacheControl: string | null): number {\n  if (!cacheControl) return 0;\n  for (const directive of cacheControl.split(',')) {\n    const trimmed = directive.trim().toLowerCase();\n    if (trimmed.startsWith('max-age=')) {\n      const secs = parseInt(trimmed.slice('max-age='.length), 10);\n      return Number.isFinite(secs) && secs > 0 ? secs * 1000 : 0;\n    }\n  }\n  return 0;\n}\n"],"mappings":"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","names":["regionOrigins"]}

package/dist/index.cjs

@@ -66,6 +66,7 @@ __export(index_exports, {
   S3Upload: () => import_protocol.S3Upload,
   SIPCallStatus: () => import_protocol.SIPCallStatus,
   SIPDispatchRule: () => import_protocol.SIPDispatchRule,
+  SIPDispatchRuleCallee: () => import_protocol.SIPDispatchRuleCallee,
   SIPDispatchRuleDirect: () => import_protocol.SIPDispatchRuleDirect,
   SIPDispatchRuleIndividual: () => import_protocol.SIPDispatchRuleIndividual,
   SIPDispatchRuleInfo: () => import_protocol.SIPDispatchRuleInfo,
@@ -75,7 +76,9 @@ __export(index_exports, {
   SIPTrunkInfo: () => import_protocol.SIPTrunkInfo,
   SegmentedFileOutput: () => import_protocol.SegmentedFileOutput,
   SegmentedFileProtocol: () => import_protocol.SegmentedFileProtocol,
+  ServerError: () => import_TwirpRPC.ServerError,
   SessionDescription: () => import_protocol.SessionDescription,
+  SipCallError: () => import_TwirpRPC.SipCallError,
   StreamOutput: () => import_protocol.StreamOutput,
   StreamProtocol: () => import_protocol.StreamProtocol,
   TrackCompositeEgressRequest: () => import_protocol.TrackCompositeEgressRequest,
@@ -96,6 +99,7 @@ __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);
+__reExport(index_exports, require("./LiveKitAPI.cjs"), module.exports);
 __reExport(index_exports, require("./RoomServiceClient.cjs"), module.exports);
 __reExport(index_exports, require("./SipClient.cjs"), module.exports);
 var import_TwirpRPC = require("./TwirpRPC.cjs");
@@ -149,6 +153,7 @@ __reExport(index_exports, require("./WebhookReceiver.cjs"), module.exports);
   S3Upload,
   SIPCallStatus,
   SIPDispatchRule,
+  SIPDispatchRuleCallee,
   SIPDispatchRuleDirect,
   SIPDispatchRuleIndividual,
   SIPDispatchRuleInfo,
@@ -158,7 +163,9 @@ __reExport(index_exports, require("./WebhookReceiver.cjs"), module.exports);
   SIPTrunkInfo,
   SegmentedFileOutput,
   SegmentedFileProtocol,
+  ServerError,
   SessionDescription,
+  SipCallError,
   StreamOutput,
   StreamProtocol,
   TrackCompositeEgressRequest,
@@ -176,6 +183,7 @@ __reExport(index_exports, require("./WebhookReceiver.cjs"), module.exports);
   ...require("./EgressClient.cjs"),
   ...require("./grants.cjs"),
   ...require("./IngressClient.cjs"),
+  ...require("./LiveKitAPI.cjs"),
   ...require("./RoomServiceClient.cjs"),
   ...require("./SipClient.cjs"),
   ...require("./WebhookReceiver.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  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  DisconnectWhatsAppCallRequest_DisconnectReason,\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  JobRestartPolicy,\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;AAAA;AAAA;AAIA,sBAoEO;AACP,0BAAc,6BAzEd;AA0EA,0BAAc,qCA1Ed;AA2EA,0BAAc,iCA3Ed;AA4EA,0BAAc,8BA5Ed;AA6EA,0BAAc,wBA7Ed;AA8EA,0BAAc,+BA9Ed;AA+EA,0BAAc,mCA/Ed;AAgFA,0BAAc,2BAhFd;AAiFA,sBAA2B;AAC3B,0BAAc,iCAlFd;","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  DisconnectWhatsAppCallRequest_DisconnectReason,\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  JobRestartPolicy,\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  SIPDispatchRuleCallee,\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 './LiveKitAPI.js';\nexport * from './RoomServiceClient.js';\nexport * from './SipClient.js';\nexport { ServerError, SipCallError, TwirpError } from './TwirpRPC.js';\nexport type { ClientOptions } from './ClientOptions.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;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,sBAqEO;AACP,0BAAc,6BA1Ed;AA2EA,0BAAc,qCA3Ed;AA4EA,0BAAc,iCA5Ed;AA6EA,0BAAc,8BA7Ed;AA8EA,0BAAc,wBA9Ed;AA+EA,0BAAc,+BA/Ed;AAgFA,0BAAc,4BAhFd;AAiFA,0BAAc,mCAjFd;AAkFA,0BAAc,2BAlFd;AAmFA,sBAAsD;AAEtD,0BAAc,iCArFd;","names":[]}

package/dist/index.d.cts

@@ -1,15 +1,16 @@
-export { AcceptWhatsAppCallResponse, AgentDispatch, AliOSSUpload, AudioCodec, AutoParticipantEgress, AutoTrackEgress, AzureBlobUpload, ConnectTwilioCallRequest_TwilioCallDirection, ConnectTwilioCallResponse, ConnectWhatsAppCallResponse, DataPacket_Kind, DialWhatsAppCallResponse, DirectFileOutput, DisconnectWhatsAppCallRequest_DisconnectReason, DisconnectWhatsAppCallResponse, EgressInfo, EgressStatus, EncodedFileOutput, EncodedFileType, EncodingOptions, EncodingOptionsPreset, GCPUpload, ImageCodec, ImageFileSuffix, ImageOutput, IngressAudioEncodingOptions, IngressAudioEncodingPreset, IngressAudioOptions, IngressInfo, IngressInput, IngressState, IngressVideoEncodingOptions, IngressVideoEncodingPreset, IngressVideoOptions, JobRestartPolicy, 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 { AcceptWhatsAppCallResponse, AgentDispatch, AliOSSUpload, AudioCodec, AutoParticipantEgress, AutoTrackEgress, AzureBlobUpload, ConnectTwilioCallRequest_TwilioCallDirection, ConnectTwilioCallResponse, ConnectWhatsAppCallResponse, DataPacket_Kind, DialWhatsAppCallResponse, DirectFileOutput, DisconnectWhatsAppCallRequest_DisconnectReason, DisconnectWhatsAppCallResponse, EgressInfo, EgressStatus, EncodedFileOutput, EncodedFileType, EncodingOptions, EncodingOptionsPreset, GCPUpload, ImageCodec, ImageFileSuffix, ImageOutput, IngressAudioEncodingOptions, IngressAudioEncodingPreset, IngressAudioOptions, IngressInfo, IngressInput, IngressState, IngressVideoEncodingOptions, IngressVideoEncodingPreset, IngressVideoOptions, JobRestartPolicy, ParticipantEgressRequest, ParticipantInfo, ParticipantInfo_State, ParticipantPermission, Room, RoomAgentDispatch, RoomCompositeEgressRequest, RoomConfiguration, RoomEgress, S3Upload, SIPCallStatus, SIPDispatchRule, SIPDispatchRuleCallee, 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';
+export { LiveKitAPI, LiveKitAPIOptions } from './LiveKitAPI.cjs';
 export { CreateOptions, RemoveParticipantOptions, RoomServiceClient, SendDataOptions, UpdateParticipantOptions } from './RoomServiceClient.cjs';
-export { CreateSipDispatchRuleOptions, CreateSipInboundTrunkOptions, CreateSipOutboundTrunkOptions, CreateSipParticipantOptions, CreateSipTrunkOptions, ListSipDispatchRuleOptions, ListSipTrunkOptions, SipClient, SipDispatchRuleDirect, SipDispatchRuleIndividual, SipDispatchRuleUpdateOptions, SipInboundTrunkUpdateOptions, SipOutboundTrunkUpdateOptions, TransferSipParticipantOptions } from './SipClient.cjs';
-export { TwirpError } from './TwirpRPC.cjs';
+export { CreateSipDispatchRuleOptions, CreateSipInboundTrunkOptions, CreateSipOutboundTrunkOptions, CreateSipParticipantOptions, CreateSipTrunkOptions, ListSipDispatchRuleOptions, ListSipTrunkOptions, SipClient, SipDispatchRuleCallee, SipDispatchRuleDirect, SipDispatchRuleIndividual, SipDispatchRuleUpdateOptions, SipInboundTrunkUpdateOptions, SipOutboundTrunkUpdateOptions, TransferSipParticipantOptions } from './SipClient.cjs';
+export { ServerError, SipCallError, TwirpError } from './TwirpRPC.cjs';
+export { ClientOptions } from './ClientOptions.cjs';
 export { WebhookEvent, WebhookEventNames, WebhookReceiver, authorizeHeader } from './WebhookReceiver.cjs';
-import './ClientOptions.cjs';
 import './ServiceBase.cjs';
 import 'jose';
 import '@bufbuild/protobuf';

package/dist/index.d.ts

@@ -1,15 +1,16 @@
-export { AcceptWhatsAppCallResponse, AgentDispatch, AliOSSUpload, AudioCodec, AutoParticipantEgress, AutoTrackEgress, AzureBlobUpload, ConnectTwilioCallRequest_TwilioCallDirection, ConnectTwilioCallResponse, ConnectWhatsAppCallResponse, DataPacket_Kind, DialWhatsAppCallResponse, DirectFileOutput, DisconnectWhatsAppCallRequest_DisconnectReason, DisconnectWhatsAppCallResponse, EgressInfo, EgressStatus, EncodedFileOutput, EncodedFileType, EncodingOptions, EncodingOptionsPreset, GCPUpload, ImageCodec, ImageFileSuffix, ImageOutput, IngressAudioEncodingOptions, IngressAudioEncodingPreset, IngressAudioOptions, IngressInfo, IngressInput, IngressState, IngressVideoEncodingOptions, IngressVideoEncodingPreset, IngressVideoOptions, JobRestartPolicy, 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 { AcceptWhatsAppCallResponse, AgentDispatch, AliOSSUpload, AudioCodec, AutoParticipantEgress, AutoTrackEgress, AzureBlobUpload, ConnectTwilioCallRequest_TwilioCallDirection, ConnectTwilioCallResponse, ConnectWhatsAppCallResponse, DataPacket_Kind, DialWhatsAppCallResponse, DirectFileOutput, DisconnectWhatsAppCallRequest_DisconnectReason, DisconnectWhatsAppCallResponse, EgressInfo, EgressStatus, EncodedFileOutput, EncodedFileType, EncodingOptions, EncodingOptionsPreset, GCPUpload, ImageCodec, ImageFileSuffix, ImageOutput, IngressAudioEncodingOptions, IngressAudioEncodingPreset, IngressAudioOptions, IngressInfo, IngressInput, IngressState, IngressVideoEncodingOptions, IngressVideoEncodingPreset, IngressVideoOptions, JobRestartPolicy, ParticipantEgressRequest, ParticipantInfo, ParticipantInfo_State, ParticipantPermission, Room, RoomAgentDispatch, RoomCompositeEgressRequest, RoomConfiguration, RoomEgress, S3Upload, SIPCallStatus, SIPDispatchRule, SIPDispatchRuleCallee, 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.js';
 export { AgentDispatchClient } from './AgentDispatchClient.js';
 export { AcceptWhatsAppCallOptions, ConnectTwilioCallOptions, ConnectorClient, DialWhatsAppCallOptions } from './ConnectorClient.js';
 export { BaseOptions, EgressClient, EncodedOutputs, ListEgressOptions, ParticipantEgressOptions, RoomCompositeOptions, TrackCompositeOptions, WebOptions } from './EgressClient.js';
 export { ClaimGrants, InferenceGrant, ObservabilityGrant, SIPGrant, VideoGrant, claimsToJwtPayload, trackSourceToString } from './grants.js';
 export { CreateIngressOptions, IngressClient, ListIngressOptions, UpdateIngressOptions } from './IngressClient.js';
+export { LiveKitAPI, LiveKitAPIOptions } from './LiveKitAPI.js';
 export { CreateOptions, RemoveParticipantOptions, RoomServiceClient, SendDataOptions, UpdateParticipantOptions } from './RoomServiceClient.js';
-export { CreateSipDispatchRuleOptions, CreateSipInboundTrunkOptions, CreateSipOutboundTrunkOptions, CreateSipParticipantOptions, CreateSipTrunkOptions, ListSipDispatchRuleOptions, ListSipTrunkOptions, SipClient, SipDispatchRuleDirect, SipDispatchRuleIndividual, SipDispatchRuleUpdateOptions, SipInboundTrunkUpdateOptions, SipOutboundTrunkUpdateOptions, TransferSipParticipantOptions } from './SipClient.js';
-export { TwirpError } from './TwirpRPC.js';
+export { CreateSipDispatchRuleOptions, CreateSipInboundTrunkOptions, CreateSipOutboundTrunkOptions, CreateSipParticipantOptions, CreateSipTrunkOptions, ListSipDispatchRuleOptions, ListSipTrunkOptions, SipClient, SipDispatchRuleCallee, SipDispatchRuleDirect, SipDispatchRuleIndividual, SipDispatchRuleUpdateOptions, SipInboundTrunkUpdateOptions, SipOutboundTrunkUpdateOptions, TransferSipParticipantOptions } from './SipClient.js';
+export { ServerError, SipCallError, TwirpError } from './TwirpRPC.js';
+export { ClientOptions } from './ClientOptions.js';
 export { WebhookEvent, WebhookEventNames, WebhookReceiver, authorizeHeader } from './WebhookReceiver.js';
-import './ClientOptions.js';
 import './ServiceBase.js';
 import 'jose';
 import '@bufbuild/protobuf';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"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,8CAA8C,EAC9C,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,gBAAgB,EAChB,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"}
+{"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,8CAA8C,EAC9C,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,gBAAgB,EAChB,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,qBAAqB,EACrB,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,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACtE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -49,6 +49,7 @@ import {
   SIPDispatchRuleInfo,
   SIPDispatchRuleDirect,
   SIPDispatchRuleIndividual,
+  SIPDispatchRuleCallee,
   SIPParticipantInfo,
   SIPOutboundTrunkInfo,
   SIPInboundTrunkInfo,
@@ -73,9 +74,10 @@ export * from "./ConnectorClient.js";
 export * from "./EgressClient.js";
 export * from "./grants.js";
 export * from "./IngressClient.js";
+export * from "./LiveKitAPI.js";
 export * from "./RoomServiceClient.js";
 export * from "./SipClient.js";
-import { TwirpError } from "./TwirpRPC.js";
+import { ServerError, SipCallError, TwirpError } from "./TwirpRPC.js";
 export * from "./WebhookReceiver.js";
 export {
   AcceptWhatsAppCallResponse,
@@ -125,6 +127,7 @@ export {
   S3Upload,
   SIPCallStatus,
   SIPDispatchRule,
+  SIPDispatchRuleCallee,
   SIPDispatchRuleDirect,
   SIPDispatchRuleIndividual,
   SIPDispatchRuleInfo,
@@ -134,7 +137,9 @@ export {
   SIPTrunkInfo,
   SegmentedFileOutput,
   SegmentedFileProtocol,
+  ServerError,
   SessionDescription,
+  SipCallError,
   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  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  DisconnectWhatsAppCallRequest_DisconnectReason,\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  JobRestartPolicy,\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,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":[]}
+{"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  DisconnectWhatsAppCallRequest_DisconnectReason,\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  JobRestartPolicy,\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  SIPDispatchRuleCallee,\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 './LiveKitAPI.js';\nexport * from './RoomServiceClient.js';\nexport * from './SipClient.js';\nexport { ServerError, SipCallError, TwirpError } from './TwirpRPC.js';\nexport type { ClientOptions } from './ClientOptions.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,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,SAAS,aAAa,cAAc,kBAAkB;AAEtD,cAAc;","names":[]}

package/dist/version.cjs

@@ -0,0 +1,29 @@
+"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 version_exports = {};
+__export(version_exports, {
+  SDK_VERSION: () => SDK_VERSION
+});
+module.exports = __toCommonJS(version_exports);
+const SDK_VERSION = "2.17.0";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SDK_VERSION
+});
+//# sourceMappingURL=version.cjs.map

package/dist/version.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/version.ts"],"sourcesContent":["export const SDK_VERSION = \"2.17.0\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,MAAM,cAAc;","names":[]}

package/dist/version.d.cts

@@ -0,0 +1,3 @@
+declare const SDK_VERSION = "2.17.0";
+
+export { SDK_VERSION };

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+declare const SDK_VERSION = "2.17.0";
+
+export { SDK_VERSION };

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,WAAW,CAAC"}

package/dist/version.js

@@ -0,0 +1,5 @@
+const SDK_VERSION = "2.17.0";
+export {
+  SDK_VERSION
+};
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/version.ts"],"sourcesContent":["export const SDK_VERSION = \"2.17.0\";\n"],"mappings":"AAAO,MAAM,cAAc;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "livekit-server-sdk",
-  "version": "2.15.5",
+  "version": "2.17.0",
   "description": "Server-side SDK for LiveKit",
   "main": "dist/index.js",
   "require": "dist/index.cjs",
@@ -31,8 +31,7 @@
   ],
   "dependencies": {
     "@bufbuild/protobuf": "^1.10.1",
-    "@livekit/protocol": "^1.46.6",
-    "camelcase-keys": "^9.0.0",
+    "@livekit/protocol": "^1.48.0",
     "jose": "^5.1.2"
   },
   "devDependencies": {
@@ -52,6 +51,7 @@
     "node": ">=18"
   },
   "scripts": {
+    "prebuild": "node -p \"'export const SDK_VERSION = ' + JSON.stringify(require('./package.json').version) + ';'\" > src/version.ts",
     "build": "tsup --onSuccess \"tsc -p tsconfig.json --declaration --emitDeclarationOnly --skipLibCheck\"",
     "build:watch": "tsc --watch",
     "build-docs": "typedoc",

package/src/AgentDispatchClient.ts

@@ -39,11 +39,11 @@ export class AgentDispatchClient extends ServiceBase {
    * @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);
+    super({ apiKey, secret, token: options?.token });
+    this.rpc = new TwirpRpc(host, livekitPackage, {
+      requestTimeout: options?.requestTimeout,
+      failover: options?.failover,
+    });
   }
 
   /**

package/src/ClientOptions.ts

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

package/src/ConnectorClient.ts

@@ -23,6 +23,7 @@ import {
 import type { ClientOptions } from './ClientOptions.js';
 import { ServiceBase } from './ServiceBase.js';
 import { type Rpc, TwirpRpc, livekitPackage } from './TwirpRPC.js';
+import { DEFAULT_RINGING_TIMEOUT_SECONDS } from './dialTimeout.js';
 
 const svc = 'Connector';
 
@@ -83,10 +84,13 @@ export interface AcceptWhatsAppCallOptions {
   participantAttributes?: { [key: string]: string };
   /** Optional - Country where the call terminates as ISO 3166-1 alpha-2 */
   destinationCountry?: string;
-  /** Optional - Max time in seconds for the callee to answer the call */
-  ringingTimeout?: number;
-  /** Optional - Wait for the call to be answered before returning */
+  /** Optional - Wait until the inbound party joins before returning. */
   waitUntilAnswered?: boolean;
+  /**
+   * Optional - Request timeout in seconds. When `waitUntilAnswered` is set it
+   * defaults to the standard ring window; otherwise the client default applies.
+   */
+  timeout?: number;
 }
 
 // Twilio types
@@ -122,11 +126,11 @@ export class ConnectorClient extends ServiceBase {
    * @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);
+    super({ apiKey, secret, token: options?.token });
+    this.rpc = new TwirpRpc(host, livekitPackage, {
+      requestTimeout: options?.requestTimeout,
+      failover: options?.failover,
+    });
   }
 
   /**
@@ -200,17 +204,22 @@ export class ConnectorClient extends ServiceBase {
       participantMetadata,
       participantAttributes: options.participantAttributes,
       destinationCountry,
-      ringingTimeout: options.ringingTimeout
-        ? new Duration({ seconds: BigInt(options.ringingTimeout) })
-        : undefined,
       waitUntilAnswered: options.waitUntilAnswered,
     }).toJson();
 
+    // When waiting for the inbound party to join, the request can block, so
+    // default the timeout to the standard ring window; otherwise the client
+    // default applies.
+    const timeout = options.waitUntilAnswered
+      ? (options.timeout ?? DEFAULT_RINGING_TIMEOUT_SECONDS)
+      : options.timeout;
+
     const data = await this.rpc.request(
       svc,
       'AcceptWhatsAppCall',
       req,
       await this.authHeader({ roomCreate: true }),
+      timeout,
     );
     return AcceptWhatsAppCallResponse.fromJson(data, { ignoreUnknownFields: true });
   }

package/src/EgressClient.ts

@@ -141,11 +141,11 @@ export class EgressClient extends ServiceBase {
    * @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);
+    super({ apiKey, secret, token: options?.token });
+    this.rpc = new TwirpRpc(host, livekitPackage, {
+      requestTimeout: options?.requestTimeout,
+      failover: options?.failover,
+    });
   }
 
   /**

package/src/IngressClient.ts

@@ -128,11 +128,11 @@ export class IngressClient extends ServiceBase {
    * @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);
+    super({ apiKey, secret, token: options?.token });
+    this.rpc = new TwirpRpc(host, livekitPackage, {
+      requestTimeout: options?.requestTimeout,
+      failover: options?.failover,
+    });
   }
 
   /**