@voice-ai-labs/web-sdk 0.2.0 → 0.4.0

package/dist/index.esm.js

@@ -4130,6 +4130,12 @@ const ParticipantInfo = /* @__PURE__ */proto3.makeMessageType("livekit.Participa
   kind: "enum",
   T: proto3.getEnumType(ParticipantInfo_KindDetail),
   repeated: true
+}, {
+  no: 19,
+  name: "data_tracks",
+  kind: "message",
+  T: DataTrackInfo,
+  repeated: true
 }]);
 const ParticipantInfo_State = /* @__PURE__ */proto3.makeEnum("livekit.ParticipantInfo.State", [{
   no: 0,
@@ -4162,6 +4168,9 @@ const ParticipantInfo_Kind = /* @__PURE__ */proto3.makeEnum("livekit.Participant
 }, {
   no: 7,
   name: "CONNECTOR"
+}, {
+  no: 8,
+  name: "BRIDGE"
 }]);
 const ParticipantInfo_KindDetail = /* @__PURE__ */proto3.makeEnum("livekit.ParticipantInfo.KindDetail", [{
   no: 0,
@@ -4169,6 +4178,15 @@ const ParticipantInfo_KindDetail = /* @__PURE__ */proto3.makeEnum("livekit.Parti
 }, {
   no: 1,
   name: "FORWARDED"
+}, {
+  no: 2,
+  name: "CONNECTOR_WHATSAPP"
+}, {
+  no: 3,
+  name: "CONNECTOR_TWILIO"
+}, {
+  no: 4,
+  name: "BRIDGE_RTSP"
 }]);
 const Encryption_Type = /* @__PURE__ */proto3.makeEnum("livekit.Encryption.Type", [{
   no: 0,
@@ -4332,6 +4350,37 @@ const TrackInfo = /* @__PURE__ */proto3.makeMessageType("livekit.TrackInfo", ()
   kind: "enum",
   T: proto3.getEnumType(BackupCodecPolicy$1)
 }]);
+const DataTrackInfo = /* @__PURE__ */proto3.makeMessageType("livekit.DataTrackInfo", () => [{
+  no: 1,
+  name: "pub_handle",
+  kind: "scalar",
+  T: 13
+  /* ScalarType.UINT32 */
+}, {
+  no: 2,
+  name: "sid",
+  kind: "scalar",
+  T: 9
+  /* ScalarType.STRING */
+}, {
+  no: 3,
+  name: "name",
+  kind: "scalar",
+  T: 9
+  /* ScalarType.STRING */
+}, {
+  no: 4,
+  name: "encryption",
+  kind: "enum",
+  T: proto3.getEnumType(Encryption_Type)
+}]);
+const DataTrackSubscriptionOptions = /* @__PURE__ */proto3.makeMessageType("livekit.DataTrackSubscriptionOptions", () => [{
+  no: 1,
+  name: "target_fps",
+  kind: "scalar",
+  T: 13,
+  opt: true
+}]);
 const VideoLayer = /* @__PURE__ */proto3.makeMessageType("livekit.VideoLayer", () => [{
   no: 1,
   name: "quality",
@@ -4373,6 +4422,12 @@ const VideoLayer = /* @__PURE__ */proto3.makeMessageType("livekit.VideoLayer", (
   kind: "scalar",
   T: 9
   /* ScalarType.STRING */
+}, {
+  no: 8,
+  name: "repair_ssrc",
+  kind: "scalar",
+  T: 13
+  /* ScalarType.UINT32 */
 }]);
 const VideoLayer_Mode = /* @__PURE__ */proto3.makeEnum("livekit.VideoLayer.Mode", [{
   no: 0,
@@ -5387,6 +5442,24 @@ const SignalRequest = /* @__PURE__ */proto3.makeMessageType("livekit.SignalReque
   kind: "message",
   T: UpdateLocalVideoTrack,
   oneof: "message"
+}, {
+  no: 19,
+  name: "publish_data_track_request",
+  kind: "message",
+  T: PublishDataTrackRequest,
+  oneof: "message"
+}, {
+  no: 20,
+  name: "unpublish_data_track_request",
+  kind: "message",
+  T: UnpublishDataTrackRequest,
+  oneof: "message"
+}, {
+  no: 21,
+  name: "update_data_subscription",
+  kind: "message",
+  T: UpdateDataSubscription,
+  oneof: "message"
 }]);
 const SignalResponse = /* @__PURE__ */proto3.makeMessageType("livekit.SignalResponse", () => [{
   no: 1,
@@ -5538,6 +5611,24 @@ const SignalResponse = /* @__PURE__ */proto3.makeMessageType("livekit.SignalResp
   kind: "message",
   T: SubscribedAudioCodecUpdate,
   oneof: "message"
+}, {
+  no: 27,
+  name: "publish_data_track_response",
+  kind: "message",
+  T: PublishDataTrackResponse,
+  oneof: "message"
+}, {
+  no: 28,
+  name: "unpublish_data_track_response",
+  kind: "message",
+  T: UnpublishDataTrackResponse,
+  oneof: "message"
+}, {
+  no: 29,
+  name: "data_track_subscriber_handles",
+  kind: "message",
+  T: DataTrackSubscriberHandles,
+  oneof: "message"
 }]);
 const SimulcastCodec = /* @__PURE__ */proto3.makeMessageType("livekit.SimulcastCodec", () => [{
   no: 1,
@@ -5662,6 +5753,74 @@ const AddTrackRequest = /* @__PURE__ */proto3.makeMessageType("livekit.AddTrackR
   T: proto3.getEnumType(AudioTrackFeature),
   repeated: true
 }]);
+const PublishDataTrackRequest = /* @__PURE__ */proto3.makeMessageType("livekit.PublishDataTrackRequest", () => [{
+  no: 1,
+  name: "pub_handle",
+  kind: "scalar",
+  T: 13
+  /* ScalarType.UINT32 */
+}, {
+  no: 2,
+  name: "name",
+  kind: "scalar",
+  T: 9
+  /* ScalarType.STRING */
+}, {
+  no: 3,
+  name: "encryption",
+  kind: "enum",
+  T: proto3.getEnumType(Encryption_Type)
+}]);
+const PublishDataTrackResponse = /* @__PURE__ */proto3.makeMessageType("livekit.PublishDataTrackResponse", () => [{
+  no: 1,
+  name: "info",
+  kind: "message",
+  T: DataTrackInfo
+}]);
+const UnpublishDataTrackRequest = /* @__PURE__ */proto3.makeMessageType("livekit.UnpublishDataTrackRequest", () => [{
+  no: 1,
+  name: "pub_handle",
+  kind: "scalar",
+  T: 13
+  /* ScalarType.UINT32 */
+}]);
+const UnpublishDataTrackResponse = /* @__PURE__ */proto3.makeMessageType("livekit.UnpublishDataTrackResponse", () => [{
+  no: 1,
+  name: "info",
+  kind: "message",
+  T: DataTrackInfo
+}]);
+const DataTrackSubscriberHandles = /* @__PURE__ */proto3.makeMessageType("livekit.DataTrackSubscriberHandles", () => [{
+  no: 1,
+  name: "sub_handles",
+  kind: "map",
+  K: 13,
+  V: {
+    kind: "message",
+    T: DataTrackSubscriberHandles_PublishedDataTrack
+  }
+}]);
+const DataTrackSubscriberHandles_PublishedDataTrack = /* @__PURE__ */proto3.makeMessageType("livekit.DataTrackSubscriberHandles.PublishedDataTrack", () => [{
+  no: 1,
+  name: "publisher_identity",
+  kind: "scalar",
+  T: 9
+  /* ScalarType.STRING */
+}, {
+  no: 2,
+  name: "publisher_sid",
+  kind: "scalar",
+  T: 9
+  /* ScalarType.STRING */
+}, {
+  no: 3,
+  name: "track_sid",
+  kind: "scalar",
+  T: 9
+  /* ScalarType.STRING */
+}], {
+  localName: "DataTrackSubscriberHandles_PublishedDataTrack"
+});
 const TrickleRequest = /* @__PURE__ */proto3.makeMessageType("livekit.TrickleRequest", () => [{
   no: 1,
   name: "candidateInit",
@@ -5877,6 +6036,33 @@ const UpdateSubscription = /* @__PURE__ */proto3.makeMessageType("livekit.Update
   T: ParticipantTracks,
   repeated: true
 }]);
+const UpdateDataSubscription = /* @__PURE__ */proto3.makeMessageType("livekit.UpdateDataSubscription", () => [{
+  no: 1,
+  name: "updates",
+  kind: "message",
+  T: UpdateDataSubscription_Update,
+  repeated: true
+}]);
+const UpdateDataSubscription_Update = /* @__PURE__ */proto3.makeMessageType("livekit.UpdateDataSubscription.Update", () => [{
+  no: 1,
+  name: "track_sid",
+  kind: "scalar",
+  T: 9
+  /* ScalarType.STRING */
+}, {
+  no: 2,
+  name: "subscribe",
+  kind: "scalar",
+  T: 8
+  /* ScalarType.BOOL */
+}, {
+  no: 3,
+  name: "options",
+  kind: "message",
+  T: DataTrackSubscriptionOptions
+}], {
+  localName: "UpdateDataSubscription_Update"
+});
 const UpdateTrackSettings = /* @__PURE__ */proto3.makeMessageType("livekit.UpdateTrackSettings", () => [{
   no: 1,
   name: "track_sids",
@@ -6283,6 +6469,12 @@ const SyncState = /* @__PURE__ */proto3.makeMessageType("livekit.SyncState", ()
   kind: "message",
   T: DataChannelReceiveState,
   repeated: true
+}, {
+  no: 8,
+  name: "publish_data_tracks",
+  kind: "message",
+  T: PublishDataTrackResponse,
+  repeated: true
 }]);
 const DataChannelReceiveState = /* @__PURE__ */proto3.makeMessageType("livekit.DataChannelReceiveState", () => [{
   no: 1,
@@ -6487,6 +6679,18 @@ const RequestResponse = /* @__PURE__ */proto3.makeMessageType("livekit.RequestRe
   kind: "message",
   T: UpdateLocalVideoTrack,
   oneof: "request"
+}, {
+  no: 10,
+  name: "publish_data_track",
+  kind: "message",
+  T: PublishDataTrackRequest,
+  oneof: "request"
+}, {
+  no: 11,
+  name: "unpublish_data_track",
+  kind: "message",
+  T: UnpublishDataTrackRequest,
+  oneof: "request"
 }]);
 const RequestResponse_Reason = /* @__PURE__ */proto3.makeEnum("livekit.RequestResponse.Reason", [{
   no: 0,
@@ -6509,6 +6713,18 @@ const RequestResponse_Reason = /* @__PURE__ */proto3.makeEnum("livekit.RequestRe
 }, {
   no: 6,
   name: "UNCLASSIFIED_ERROR"
+}, {
+  no: 7,
+  name: "INVALID_HANDLE"
+}, {
+  no: 8,
+  name: "INVALID_NAME"
+}, {
+  no: 9,
+  name: "DUPLICATE_HANDLE"
+}, {
+  no: 10,
+  name: "DUPLICATE_NAME"
 }]);
 const TrackSubscribed = /* @__PURE__ */proto3.makeMessageType("livekit.TrackSubscribed", () => [{
   no: 1,
@@ -6541,6 +6757,12 @@ const ConnectionSettings = /* @__PURE__ */proto3.makeMessageType("livekit.Connec
   kind: "scalar",
   T: 8
   /* ScalarType.BOOL */
+}, {
+  no: 5,
+  name: "auto_subscribe_data_track",
+  kind: "scalar",
+  T: 8,
+  opt: true
 }]);
 const JoinRequest = /* @__PURE__ */proto3.makeMessageType("livekit.JoinRequest", () => [{
   no: 1,
@@ -10391,7 +10613,8 @@ function adapterFactory() {
 
 adapterFactory({
   window: typeof window === 'undefined' ? undefined : window
-});class TypedPromise extends Promise {
+});var _a, _b;
+class TypedPromise extends (_b = Promise) {
   // eslint-disable-next-line @typescript-eslint/no-useless-constructor
   constructor(executor) {
     super(executor);
@@ -10408,7 +10631,11 @@ adapterFactory({
   static race(values) {
     return super.race(values);
   }
-}// tiny, simplified version of https://github.com/lancedikson/bowser/blob/master/src/parser-browsers.js
+}
+_a = TypedPromise;
+TypedPromise.resolve = value => {
+  return Reflect.get(_b, "resolve", _a).call(_a, value);
+};// tiny, simplified version of https://github.com/lancedikson/bowser/blob/master/src/parser-browsers.js
 // reduced to only differentiate Chrome(ium) based browsers / Firefox / Safari
 const commonVersionIdentifier = /version\/(\d+(\.?_?\d+)+)/i;
 let browserDetails;
@@ -10474,14 +10701,23 @@ function getMatch(exp, ua) {
 }
 function getOSVersion(ua) {
   return ua.includes('mac os') ? getMatch(/\(.+?(\d+_\d+(:?_\d+)?)/, ua, 1).replace(/_/g, '.') : undefined;
-}var version$1 = "2.17.0";const version = version$1;
-const protocolVersion = 16;class LivekitError extends Error {
-  constructor(code, message) {
-    super(message || 'an error has occured');
+}var version$1 = "2.17.1";const version = version$1;
+const protocolVersion = 16;/** Base error that all LiveKit specific custom errors inherit from. */
+class LivekitError extends Error {
+  constructor(code, message, options) {
+    super(message || 'an error has occurred');
     this.name = 'LiveKitError';
     this.code = code;
+    if (typeof (options === null || options === void 0 ? void 0 : options.cause) !== 'undefined') {
+      this.cause = options === null || options === void 0 ? void 0 : options.cause;
+    }
   }
 }
+/**
+ * LiveKit specific error type representing an error with an associated set of reasons.
+ * Use this to represent an error with multiple different but contextually related variants.
+ * */
+class LivekitReasonedError extends LivekitError {}
 var ConnectionErrorReason;
 (function (ConnectionErrorReason) {
   ConnectionErrorReason[ConnectionErrorReason["NotAllowed"] = 0] = "NotAllowed";
@@ -10493,7 +10729,7 @@ var ConnectionErrorReason;
   ConnectionErrorReason[ConnectionErrorReason["WebSocket"] = 6] = "WebSocket";
   ConnectionErrorReason[ConnectionErrorReason["ServiceNotFound"] = 7] = "ServiceNotFound";
 })(ConnectionErrorReason || (ConnectionErrorReason = {}));
-class ConnectionError extends LivekitError {
+class ConnectionError extends LivekitReasonedError {
   constructor(message, reason, status, context) {
     super(1, message);
     this.name = 'ConnectionError';
@@ -10564,7 +10800,7 @@ class PublishTrackError extends LivekitError {
     this.status = status;
   }
 }
-class SignalRequestError extends LivekitError {
+class SignalRequestError extends LivekitReasonedError {
   constructor(message, reason) {
     super(15, message);
     this.name = 'SignalRequestError';
@@ -10590,7 +10826,7 @@ var DataStreamErrorReason;
   // Encryption type mismatch.
   DataStreamErrorReason[DataStreamErrorReason["EncryptionTypeMismatch"] = 8] = "EncryptionTypeMismatch";
 })(DataStreamErrorReason || (DataStreamErrorReason = {}));
-class DataStreamError extends LivekitError {
+class DataStreamError extends LivekitReasonedError {
   constructor(message, reason) {
     super(16, message);
     this.name = 'DataStreamError';
@@ -20117,7 +20353,8 @@ class TextStreamReader extends BaseStreamReader {
           topic: streamHeader.topic,
           timestamp: Number(streamHeader.timestamp),
           attributes: streamHeader.attributes,
-          encryptionType
+          encryptionType,
+          attachedStreamIds: streamHeader.contentHeader.value.attachedStreamIds
         };
         const stream = new ReadableStream({
           start: controller => {
@@ -20270,7 +20507,8 @@ class OutgoingDataStreamManager {
         topic: (_b = options === null || options === void 0 ? void 0 : options.topic) !== null && _b !== void 0 ? _b : '',
         size: options === null || options === void 0 ? void 0 : options.totalSize,
         attributes: options === null || options === void 0 ? void 0 : options.attributes,
-        encryptionType: ((_c = this.engine.e2eeManager) === null || _c === void 0 ? void 0 : _c.isDataChannelEncryptionEnabled) ? Encryption_Type.GCM : Encryption_Type.NONE
+        encryptionType: ((_c = this.engine.e2eeManager) === null || _c === void 0 ? void 0 : _c.isDataChannelEncryptionEnabled) ? Encryption_Type.GCM : Encryption_Type.NONE,
+        attachedStreamIds: options === null || options === void 0 ? void 0 : options.attachedStreamIds
       };
       const header = new DataStream_Header({
         streamId,
@@ -20283,7 +20521,7 @@ class OutgoingDataStreamManager {
           case: 'textHeader',
           value: new DataStream_TextHeader({
             version: options === null || options === void 0 ? void 0 : options.version,
-            attachedStreamIds: options === null || options === void 0 ? void 0 : options.attachedStreamIds,
+            attachedStreamIds: info.attachedStreamIds,
             replyToStreamId: options === null || options === void 0 ? void 0 : options.replyToStreamId,
             operationType: (options === null || options === void 0 ? void 0 : options.type) === 'update' ? DataStream_OperationType.UPDATE : DataStream_OperationType.CREATE
           })
@@ -26893,17 +27131,54 @@ class JWSSignatureVerificationFailed extends JOSEError {
     _defineProperty(this, "code", 'ERR_JWS_SIGNATURE_VERIFICATION_FAILED');
   }
 }
-_defineProperty(JWSSignatureVerificationFailed, "code", 'ERR_JWS_SIGNATURE_VERIFICATION_FAILED');
+_defineProperty(JWSSignatureVerificationFailed, "code", 'ERR_JWS_SIGNATURE_VERIFICATION_FAILED');var DataTrackHandleErrorReason;
+(function (DataTrackHandleErrorReason) {
+  DataTrackHandleErrorReason[DataTrackHandleErrorReason["Reserved"] = 0] = "Reserved";
+  DataTrackHandleErrorReason[DataTrackHandleErrorReason["TooLarge"] = 1] = "TooLarge";
+})(DataTrackHandleErrorReason || (DataTrackHandleErrorReason = {}));
+var DataTrackDeserializeErrorReason;
+(function (DataTrackDeserializeErrorReason) {
+  DataTrackDeserializeErrorReason[DataTrackDeserializeErrorReason["TooShort"] = 0] = "TooShort";
+  DataTrackDeserializeErrorReason[DataTrackDeserializeErrorReason["HeaderOverrun"] = 1] = "HeaderOverrun";
+  DataTrackDeserializeErrorReason[DataTrackDeserializeErrorReason["MissingExtWords"] = 2] = "MissingExtWords";
+  DataTrackDeserializeErrorReason[DataTrackDeserializeErrorReason["UnsupportedVersion"] = 3] = "UnsupportedVersion";
+  DataTrackDeserializeErrorReason[DataTrackDeserializeErrorReason["InvalidHandle"] = 4] = "InvalidHandle";
+  DataTrackDeserializeErrorReason[DataTrackDeserializeErrorReason["MalformedExt"] = 5] = "MalformedExt";
+})(DataTrackDeserializeErrorReason || (DataTrackDeserializeErrorReason = {}));
+var DataTrackSerializeErrorReason;
+(function (DataTrackSerializeErrorReason) {
+  DataTrackSerializeErrorReason[DataTrackSerializeErrorReason["TooSmallForHeader"] = 0] = "TooSmallForHeader";
+  DataTrackSerializeErrorReason[DataTrackSerializeErrorReason["TooSmallForPayload"] = 1] = "TooSmallForPayload";
+})(DataTrackSerializeErrorReason || (DataTrackSerializeErrorReason = {}));
+var DataTrackExtensionTag;
+(function (DataTrackExtensionTag) {
+  DataTrackExtensionTag[DataTrackExtensionTag["UserTimestamp"] = 2] = "UserTimestamp";
+  DataTrackExtensionTag[DataTrackExtensionTag["E2ee"] = 1] = "E2ee";
+})(DataTrackExtensionTag || (DataTrackExtensionTag = {}));
+DataTrackExtensionTag.UserTimestamp;
+DataTrackExtensionTag.E2ee;
+/** Marker indicating a packet's position in relation to a frame. */
+var FrameMarker;
+(function (FrameMarker) {
+  /** Packet is the first in a frame. */
+  FrameMarker[FrameMarker["Start"] = 0] = "Start";
+  /** Packet is within a frame. */
+  FrameMarker[FrameMarker["Inter"] = 1] = "Inter";
+  /** Packet is the last in a frame. */
+  FrameMarker[FrameMarker["Final"] = 2] = "Final";
+  /** Packet is the only one in a frame. */
+  FrameMarker[FrameMarker["Single"] = 3] = "Single";
+})(FrameMarker || (FrameMarker = {}));
 
 /**
- * Base HTTP Client for Voice.AI API
+ * Base HTTP Client for Voice.ai API
  *
  * Provides common functionality for all API clients including:
  * - Authentication via Bearer token
  * - Error handling and response parsing
  * - Common HTTP methods (GET, POST, PUT, PATCH, DELETE)
  */
-/** Error thrown by Voice.AI API client */
+/** Error thrown by Voice.ai API client */
 class VoiceAIError extends Error {
     constructor(message, status, code, detail) {
         super(message);
@@ -27699,7 +27974,7 @@ class PhoneNumberClient extends BaseClient {
 }
 
 /**
- * VoiceAgentWidget - UI widget for Voice.AI
+ * VoiceAgentWidget - UI widget for Voice.ai
  *
  * Features:
  * - Click to connect/disconnect
@@ -28106,9 +28381,9 @@ VoiceAgentWidget.DEFAULT_THEME = {
 };
 
 /**
- * Voice.AI Web SDK
+ * Voice.ai Web SDK
  *
- * A single, unified SDK for Voice.AI services.
+ * A single, unified SDK for Voice.ai services.
  *
  * @example
  * ```typescript
@@ -28130,7 +28405,7 @@ VoiceAgentWidget.DEFAULT_THEME = {
 /** Default API URL */
 const DEFAULT_API_URL = 'https://dev.voice.ai/api/v1';
 /**
- * VoiceAI - The unified Voice.AI SDK
+ * VoiceAI - The unified Voice.ai SDK
  *
  * Provides both real-time voice agent connections and REST API access
  * through a single, easy-to-use interface.
@@ -28158,7 +28433,7 @@ class VoiceAI {
      * Create a new VoiceAI client
      *
      * @param config - Configuration options
-     * @param config.apiKey - Your Voice.AI API key (required)
+     * @param config.apiKey - Your Voice.ai API key (required)
      * @param config.apiUrl - Custom API URL (optional, defaults to production)
      */
     constructor(config) {
@@ -28198,10 +28473,15 @@ class VoiceAI {
      * @param options - Connection options
      * @param options.agentId - ID of the agent to connect to
      * @param options.autoPublishMic - Auto-enable microphone (default: true)
+     * @param options.testMode - Test mode to preview paused/undeployed agents (default: false)
      *
      * @example
      * ```typescript
+     * // Connect to a deployed agent
      * await voiceai.connect({ agentId: 'agent-123' });
+     *
+     * // Test a paused agent before deploying
+     * await voiceai.connect({ agentId: 'agent-123', testMode: true });
      * ```
      */
     async connect(options) {
@@ -28427,7 +28707,11 @@ class VoiceAI {
     }
     async getConnectionDetails(options) {
         const url = options.apiUrl || this.apiUrl;
-        const endpoint = `${url}/connection/connection-details`;
+        // Use test-connection-details for testMode (allows testing paused/undeployed agents)
+        const endpointPath = options.testMode
+            ? '/connection/test-connection-details'
+            : '/connection/connection-details';
+        const endpoint = `${url}${endpointPath}`;
         const requestData = {};
         if (options.agentId)
             requestData.agent_id = options.agentId;