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

package/README.md

@@ -50,6 +50,44 @@ await voiceai.connect({
 });
 ```
 
+### Error Handling
+
+The `connect()` method throws an `Error` if connection fails. Common error cases:
+
+```typescript
+try {
+  await voiceai.connect({ agentId: 'agent-123' });
+} catch (error) {
+  if (error.message.includes('insufficient_credits')) {
+    // User is out of credits
+    console.error('Out of credits. Please add more credits to continue.');
+  } else if (error.message.includes('Authentication failed')) {
+    // Invalid API key
+    console.error('Invalid API key');
+  } else if (error.message.includes('agent_not_deployed')) {
+    // Agent is paused or disabled
+    console.error('Agent is not deployed');
+  } else {
+    console.error('Connection failed:', error.message);
+  }
+}
+```
+
+Errors are also emitted via the `onError` handler and reflected in `onStatusChange`:
+
+```typescript
+voiceai.onError((error) => {
+  console.error('Error:', error.message);
+});
+
+voiceai.onStatusChange((status) => {
+  if (status.error) {
+    // status.error contains the error message string
+    console.error('Connection error:', status.error);
+  }
+});
+```
+
 ### Events
 
 ```typescript
@@ -285,8 +323,8 @@ function verifyWebhook(body: string, headers: Headers, secret: string): boolean
 
 ```typescript
 import type {
+  WebhookEventType,
   WebhookEventsConfig,
-  PublicWebhookEventsConfig,
   WebhooksConfig,
   WebhookEvent,
   WebhookTestResponse,

package/dist/index.d.ts

@@ -86,10 +86,15 @@ export declare 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 });
      * ```
      */
     connect(options: ConnectionOptions): Promise<void>;

package/dist/index.d.ts.map

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

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,7 +27131,44 @@ 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
@@ -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;