@deepgram/sdk 4.5.1 → 4.7.0

package/dist/main/lib/errors.d.ts

@@ -19,4 +19,37 @@ export declare class DeepgramUnknownError extends DeepgramError {
 export declare class DeepgramVersionError extends DeepgramError {
     constructor();
 }
+/**
+ * Enhanced WebSocket error that captures additional debugging information
+ * including status codes, request IDs, and response headers when available.
+ */
+export declare class DeepgramWebSocketError extends DeepgramError {
+    originalEvent?: ErrorEvent | Event;
+    statusCode?: number;
+    requestId?: string;
+    responseHeaders?: Record<string, string>;
+    url?: string;
+    readyState?: number;
+    constructor(message: string, options?: {
+        originalEvent?: ErrorEvent | Event;
+        statusCode?: number;
+        requestId?: string;
+        responseHeaders?: Record<string, string>;
+        url?: string;
+        readyState?: number;
+    });
+    toJSON(): {
+        name: string;
+        message: string;
+        statusCode: number | undefined;
+        requestId: string | undefined;
+        responseHeaders: Record<string, string> | undefined;
+        url: string | undefined;
+        readyState: number | undefined;
+        originalEvent: {
+            type: string;
+            timeStamp: number;
+        } | undefined;
+    };
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/main/lib/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAS,CAAC,SAAS,UAAQ;gBAEf,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAED,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,MAAM,EAAE,MAAM,CAAC;gBAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAM3C,MAAM;;;;;CAOP;AAED,qBAAa,oBAAqB,SAAQ,aAAa;IACrD,aAAa,EAAE,OAAO,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO;CAKpD;AAED,qBAAa,oBAAqB,SAAQ,aAAa;;CAQtD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAS,CAAC,SAAS,UAAQ;gBAEf,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAED,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,MAAM,EAAE,MAAM,CAAC;gBAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAM3C,MAAM;;;;;CAOP;AAED,qBAAa,oBAAqB,SAAQ,aAAa;IACrD,aAAa,EAAE,OAAO,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO;CAKpD;AAED,qBAAa,oBAAqB,SAAQ,aAAa;;CAQtD;AAED;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,aAAa,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;gBAGlB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,aAAa,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;QACnC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzC,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;KAChB;IAYR,MAAM;;;;;;;;;;;;;CAiBP"}

package/dist/main/lib/errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DeepgramVersionError = exports.DeepgramUnknownError = exports.DeepgramApiError = exports.isDeepgramError = exports.DeepgramError = void 0;
+exports.DeepgramWebSocketError = exports.DeepgramVersionError = exports.DeepgramUnknownError = exports.DeepgramApiError = exports.isDeepgramError = exports.DeepgramError = void 0;
 class DeepgramError extends Error {
     constructor(message) {
         super(message);
@@ -43,4 +43,38 @@ class DeepgramVersionError extends DeepgramError {
     }
 }
 exports.DeepgramVersionError = DeepgramVersionError;
+/**
+ * Enhanced WebSocket error that captures additional debugging information
+ * including status codes, request IDs, and response headers when available.
+ */
+class DeepgramWebSocketError extends DeepgramError {
+    constructor(message, options = {}) {
+        super(message);
+        this.name = "DeepgramWebSocketError";
+        this.originalEvent = options.originalEvent;
+        this.statusCode = options.statusCode;
+        this.requestId = options.requestId;
+        this.responseHeaders = options.responseHeaders;
+        this.url = options.url;
+        this.readyState = options.readyState;
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            statusCode: this.statusCode,
+            requestId: this.requestId,
+            responseHeaders: this.responseHeaders,
+            url: this.url,
+            readyState: this.readyState,
+            originalEvent: this.originalEvent
+                ? {
+                    type: this.originalEvent.type,
+                    timeStamp: this.originalEvent.timeStamp,
+                }
+                : undefined,
+        };
+    }
+}
+exports.DeepgramWebSocketError = DeepgramWebSocketError;
 //# sourceMappingURL=errors.js.map

package/dist/main/lib/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/lib/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,aAAc,SAAQ,KAAK;IAGtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHP,cAAS,GAAG,IAAI,CAAC;QAIzB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAPD,sCAOC;AAED,SAAgB,eAAe,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,WAAW,IAAI,KAAK,CAAC;AAC7E,CAAC;AAFD,0CAEC;AAED,MAAa,gBAAiB,SAAQ,aAAa;IAGjD,YAAY,OAAe,EAAE,MAAc;QACzC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;CACF;AAhBD,4CAgBC;AAED,MAAa,oBAAqB,SAAQ,aAAa;IAGrD,YAAY,OAAe,EAAE,aAAsB;QACjD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF;AARD,oDAQC;AAED,MAAa,oBAAqB,SAAQ,aAAa;IACrD;QACE,KAAK,CACH,wGAAwG,CACzG,CAAC;QAEF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AARD,oDAQC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/lib/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,aAAc,SAAQ,KAAK;IAGtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHP,cAAS,GAAG,IAAI,CAAC;QAIzB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAPD,sCAOC;AAED,SAAgB,eAAe,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,WAAW,IAAI,KAAK,CAAC;AAC7E,CAAC;AAFD,0CAEC;AAED,MAAa,gBAAiB,SAAQ,aAAa;IAGjD,YAAY,OAAe,EAAE,MAAc;QACzC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;CACF;AAhBD,4CAgBC;AAED,MAAa,oBAAqB,SAAQ,aAAa;IAGrD,YAAY,OAAe,EAAE,aAAsB;QACjD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF;AARD,oDAQC;AAED,MAAa,oBAAqB,SAAQ,aAAa;IACrD;QACE,KAAK,CACH,wGAAwG,CACzG,CAAC;QAEF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AARD,oDAQC;AAED;;;GAGG;AACH,MAAa,sBAAuB,SAAQ,aAAa;IAQvD,YACE,OAAe,EACf,UAOI,EAAE;QAEN,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC3C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QAC/C,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACvC,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,aAAa,EAAE,IAAI,CAAC,aAAa;gBAC/B,CAAC,CAAC;oBACE,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI;oBAC7B,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,SAAS;iBACxC;gBACH,CAAC,CAAC,SAAS;SACd,CAAC;IACJ,CAAC;CACF;AA9CD,wDA8CC"}

package/dist/main/lib/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "4.5.1";
+export declare const version = "4.7.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/main/lib/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.version = void 0;
-exports.version = "4.5.1";
+exports.version = "4.7.0";
 //# sourceMappingURL=version.js.map

package/dist/main/packages/AbstractClient.d.ts

@@ -26,6 +26,7 @@ export declare abstract class AbstractClient extends EventEmitter {
      *
      * @param options - The options to configure the DeepgramClient instance.
      * @param options.key - The Deepgram API key to use for authentication. If not provided, the `DEEPGRAM_API_KEY` environment variable will be used.
+     * @param options.accessToken - The Deepgram access token to use for authentication. If not provided, the `DEEPGRAM_ACCESS_TOKEN` environment variable will be used.
      * @param options.global - Global options that apply to all requests made by the DeepgramClient instance.
      * @param options.global.fetch - Options to configure the fetch requests made by the DeepgramClient instance.
      * @param options.global.fetch.options - Additional options to pass to the fetch function, such as `url` and `headers`.

package/dist/main/packages/AbstractClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AbstractClient.d.ts","sourceRoot":"","sources":["../../../src/packages/AbstractClient.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EAExB,MAAM,cAAc,CAAC;AAEtB,eAAO,MAAM,IAAI,YAAW,CAAC;AAE7B;;;;;;;;;GASG;AACH,8BAAsB,cAAe,SAAQ,YAAY;IACvD,SAAS,CAAC,OAAO,EAAE,QAAQ,GAAG,SAAS,CAAa;IACpD,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAa;IAC9C,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAa;IACtD,SAAS,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAY;IAC7B,OAAO,EAAE,MAAM,CAAQ;IACvB,OAAO,EAAE,MAAM,CAAe;IAC9B,MAAM,EAAE,QAAQ,CAAQ;IAE/B;;;;;;;;;OASG;gBACS,OAAO,EAAE,qBAAqB;IAwC1C;;;;;OAKG;IACI,CAAC,CAAC,OAAO,GAAE,MAAa,GAAG,IAAI;IAMtC;;;;;;OAMG;IACH,IAAI,gBAAgB,IAAI,uBAAuB,CAU9C;IAED;;;;;;;OAOG;IACI,aAAa,CAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAA8B,EAC7D,oBAAoB,CAAC,EAAE;QACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,GACA,GAAG;IA4BN;;;;OAIG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;CAGjD"}
+{"version":3,"file":"AbstractClient.d.ts","sourceRoot":"","sources":["../../../src/packages/AbstractClient.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EAExB,MAAM,cAAc,CAAC;AAEtB,eAAO,MAAM,IAAI,YAAW,CAAC;AAE7B;;;;;;;;;GASG;AACH,8BAAsB,cAAe,SAAQ,YAAY;IACvD,SAAS,CAAC,OAAO,EAAE,QAAQ,GAAG,SAAS,CAAa;IACpD,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAa;IAC9C,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAa;IACtD,SAAS,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAY;IAC7B,OAAO,EAAE,MAAM,CAAQ;IACvB,OAAO,EAAE,MAAM,CAAe;IAC9B,MAAM,EAAE,QAAQ,CAAQ;IAE/B;;;;;;;;;;OAUG;gBACS,OAAO,EAAE,qBAAqB;IA8C1C;;;;;OAKG;IACI,CAAC,CAAC,OAAO,GAAE,MAAa,GAAG,IAAI;IAMtC;;;;;;OAMG;IACH,IAAI,gBAAgB,IAAI,uBAAuB,CAU9C;IAED;;;;;;;OAOG;IACI,aAAa,CAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAA8B,EAC7D,oBAAoB,CAAC,EAAE;QACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,GACA,GAAG;IA4BN;;;;OAIG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;CAGjD"}

package/dist/main/packages/AbstractClient.js

@@ -23,6 +23,7 @@ class AbstractClient extends events_1.EventEmitter {
      *
      * @param options - The options to configure the DeepgramClient instance.
      * @param options.key - The Deepgram API key to use for authentication. If not provided, the `DEEPGRAM_API_KEY` environment variable will be used.
+     * @param options.accessToken - The Deepgram access token to use for authentication. If not provided, the `DEEPGRAM_ACCESS_TOKEN` environment variable will be used.
      * @param options.global - Global options that apply to all requests made by the DeepgramClient instance.
      * @param options.global.fetch - Options to configure the fetch requests made by the DeepgramClient instance.
      * @param options.global.fetch.options - Additional options to pass to the fetch function, such as `url` and `headers`.
@@ -53,13 +54,18 @@ class AbstractClient extends events_1.EventEmitter {
         else {
             this.key = options.key;
         }
-        // if we still have neither, try to use the DEEPGRAM_API_KEY environment variable
+        // implement priority-based credential resolution for environment variables
         if (!this.key && !this.accessToken) {
-            this.key = process.env.DEEPGRAM_API_KEY;
+            // check for DEEPGRAM_ACCESS_TOKEN first (higher priority)
+            this.accessToken = process.env.DEEPGRAM_ACCESS_TOKEN;
+            // if still no access token, fall back to DEEPGRAM_API_KEY (lower priority)
+            if (!this.accessToken) {
+                this.key = process.env.DEEPGRAM_API_KEY;
+            }
         }
         // if we STILL have neither, throw an error
         if (!this.key && !this.accessToken) {
-            throw new errors_1.DeepgramError("A deepgram API key or temporary auth token is required.");
+            throw new errors_1.DeepgramError("A deepgram API key or access token is required.");
         }
         options = (0, helpers_1.convertLegacyOptions)(options);
         /**

package/dist/main/packages/AbstractClient.js.map

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

package/dist/main/packages/AbstractLiveClient.d.ts

@@ -2,6 +2,7 @@ import { AbstractClient } from "./AbstractClient";
 import { CONNECTION_STATE, SOCKET_STATES } from "../lib/constants";
 import type { DeepgramClientOptions, LiveSchema } from "../lib/types";
 import type { WebSocket as WSWebSocket } from "ws";
+import { DeepgramWebSocketError } from "../lib/errors";
 /**
  * Represents a constructor for a WebSocket-like object that can be used in the application.
  * The constructor takes the following parameters:
@@ -89,6 +90,168 @@ export declare abstract class AbstractLiveClient extends AbstractClient {
      * @returns {boolean} true if the current instance should proxy requests; otherwise, false
      */
     get proxy(): boolean;
+    /**
+     * Extracts enhanced error information from a WebSocket error event.
+     * This method attempts to capture additional debugging information such as
+     * status codes, request IDs, and response headers when available.
+     *
+     * @example
+     * ```typescript
+     * // Enhanced error information is now available in error events:
+     * connection.on(LiveTranscriptionEvents.Error, (err) => {
+     *   console.error("WebSocket Error:", err.message);
+     *
+     *   // Access HTTP status code (e.g., 502, 403, etc.)
+     *   if (err.statusCode) {
+     *     console.error(`HTTP Status Code: ${err.statusCode}`);
+     *   }
+     *
+     *   // Access Deepgram request ID for support tickets
+     *   if (err.requestId) {
+     *     console.error(`Deepgram Request ID: ${err.requestId}`);
+     *   }
+     *
+     *   // Access WebSocket URL and connection state
+     *   if (err.url) {
+     *     console.error(`WebSocket URL: ${err.url}`);
+     *   }
+     *
+     *   if (err.readyState !== undefined) {
+     *     const stateNames = ['CONNECTING', 'OPEN', 'CLOSING', 'CLOSED'];
+     *     console.error(`Connection State: ${stateNames[err.readyState]}`);
+     *   }
+     *
+     *   // Access response headers for additional debugging
+     *   if (err.responseHeaders) {
+     *     console.error("Response Headers:", err.responseHeaders);
+     *   }
+     *
+     *   // Access the enhanced error object for detailed debugging
+     *   if (err.error?.name === 'DeepgramWebSocketError') {
+     *     console.error("Enhanced Error Details:", err.error.toJSON());
+     *   }
+     * });
+     * ```
+     *
+     * @param event - The error event from the WebSocket
+     * @param conn - The WebSocket connection object
+     * @returns Enhanced error information object
+     */
+    protected extractErrorInformation(event: ErrorEvent | Event, conn?: WebSocketLike): {
+        statusCode?: number;
+        requestId?: string;
+        responseHeaders?: Record<string, string>;
+        url?: string;
+        readyState?: number;
+    };
+    /**
+     * Creates an enhanced error object with additional debugging information.
+     * This method provides backward compatibility by including both the original
+     * error event and enhanced error information.
+     *
+     * @param event - The original error event
+     * @param enhancedInfo - Additional error information extracted from the connection
+     * @returns An object containing both original and enhanced error information
+     */
+    protected createEnhancedError(event: ErrorEvent | Event, enhancedInfo: {
+        statusCode?: number;
+        requestId?: string;
+        responseHeaders?: Record<string, string>;
+        url?: string;
+        readyState?: number;
+    }): {
+        error: DeepgramWebSocketError;
+        statusCode: number | undefined;
+        requestId: string | undefined;
+        responseHeaders: Record<string, string> | undefined;
+        url: string | undefined;
+        readyState: number | undefined;
+        message: string;
+        bubbles: boolean;
+        cancelBubble: boolean;
+        cancelable: boolean;
+        composed: boolean;
+        currentTarget: EventTarget | null;
+        defaultPrevented: boolean;
+        eventPhase: number;
+        isTrusted: boolean;
+        returnValue: boolean;
+        srcElement: EventTarget | null;
+        target: EventTarget | null;
+        timeStamp: number;
+        type: string;
+        composedPath(): EventTarget[];
+        initEvent(type: string, bubbles?: boolean | undefined, cancelable?: boolean | undefined): void;
+        preventDefault(): void;
+        stopImmediatePropagation(): void;
+        stopPropagation(): void;
+        AT_TARGET: number;
+        BUBBLING_PHASE: number;
+        CAPTURING_PHASE: number;
+        NONE: number;
+    } | {
+        error: DeepgramWebSocketError;
+        statusCode: number | undefined;
+        requestId: string | undefined;
+        responseHeaders: Record<string, string> | undefined;
+        url: string | undefined;
+        readyState: number | undefined;
+        message: string;
+        colno: number;
+        filename: string;
+        lineno: number;
+        bubbles: boolean;
+        cancelBubble: boolean;
+        cancelable: boolean;
+        composed: boolean;
+        currentTarget: EventTarget | null;
+        defaultPrevented: boolean;
+        eventPhase: number;
+        isTrusted: boolean;
+        returnValue: boolean;
+        srcElement: EventTarget | null;
+        target: EventTarget | null;
+        timeStamp: number;
+        type: string;
+        composedPath(): EventTarget[];
+        initEvent(type: string, bubbles?: boolean | undefined, cancelable?: boolean | undefined): void;
+        preventDefault(): void;
+        stopImmediatePropagation(): void;
+        stopPropagation(): void;
+        AT_TARGET: number;
+        BUBBLING_PHASE: number;
+        CAPTURING_PHASE: number;
+        NONE: number;
+    };
+    /**
+     * Builds an enhanced error message with additional context information.
+     *
+     * @param event - The original error event
+     * @param enhancedInfo - Additional error information
+     * @returns A more descriptive error message
+     */
+    protected buildEnhancedErrorMessage(event: ErrorEvent | Event, enhancedInfo: {
+        statusCode?: number;
+        requestId?: string;
+        responseHeaders?: Record<string, string>;
+        url?: string;
+        readyState?: number;
+    }): string;
+    /**
+     * Sets up the standard connection event handlers (open, close, error) for WebSocket connections.
+     * This method abstracts the common connection event registration pattern used across all live clients.
+     *
+     * @param events - Object containing the event constants for the specific client type
+     * @param events.Open - Event constant for connection open
+     * @param events.Close - Event constant for connection close
+     * @param events.Error - Event constant for connection error
+     * @protected
+     */
+    protected setupConnectionEvents(events: {
+        Open: string;
+        Close: string;
+        Error: string;
+    }): void;
     /**
      * Sets up the connection event handlers.
      *

package/dist/main/packages/AbstractLiveClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AbstractLiveClient.d.ts","sourceRoot":"","sources":["../../../src/packages/AbstractLiveClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAQ,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,IAAI,CAAC;AAGnD;;;;;;;GAOG;AACH,UAAU,wBAAwB;IAChC,KACE,OAAO,EAAE,MAAM,GAAG,GAAG,EACrB,QAAQ,CAAC,EAAE,GAAG,EACd,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GACxC,aAAa,CAAC;CAClB;AAED;;;;;GAKG;AACH,aAAK,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,gBAAgB,CAAC;AAEhE;;GAEG;AACH,aAAK,cAAc,GAAG,MAAM,GAAG,eAAe,GAAG,IAAI,CAAC;AAmBtD;;;;;;GAMG;AACH,8BAAsB,kBAAmB,SAAQ,cAAc;IACtD,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACnC,SAAS,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAC3C,IAAI,EAAE,aAAa,GAAG,IAAI,CAAQ;IAClC,UAAU,EAAE,QAAQ,EAAE,CAAM;gBAEvB,OAAO,EAAE,qBAAqB;IAmC1C;;;;OAIG;IACH,SAAS,CAAC,OAAO,CAAC,oBAAoB,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IA8E3E;;;;OAIG;IACI,SAAS,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAQ;IAEvD;;;;;OAKG;IACI,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAYvD;;;;OAIG;IACI,eAAe,IAAI,gBAAgB;IAa1C;;;;OAIG;IACI,aAAa,IAAI,aAAa;IAIrC;;OAEG;IACI,WAAW,IAAI,OAAO;IAI7B;;;;;;OAMG;IACH,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IA8BhC;;;OAGG;IACH,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED;;;;OAIG;IACH,QAAQ,CAAC,eAAe,IAAI,IAAI;CACjC;AAED,cAAM,gBAAgB;IACpB,UAAU,EAAE,MAAM,CAAiB;IACnC,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,QAAQ,CAAY;IAC7B,OAAO,EAAE,QAAQ,CAAY;IAC7B,SAAS,EAAE,QAAQ,CAAY;IAC/B,MAAM,EAAE,QAAQ,CAAY;IAC5B,UAAU,EAAE,MAAM,CAA4B;IAC9C,IAAI,EAAE,QAAQ,CAAY;IAC1B,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAQ;gBAEpB,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE;QAAE,KAAK,EAAE,QAAQ,CAAA;KAAE;CAI9E;AAED,OAAO,EAAE,kBAAkB,IAAI,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"AbstractLiveClient.d.ts","sourceRoot":"","sources":["../../../src/packages/AbstractLiveClient.ts"],"names":[],"mappings":"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"}

package/dist/main/packages/AbstractLiveClient.js

@@ -36,6 +36,7 @@ exports.AbstractWsClient = exports.AbstractLiveClient = void 0;
 const AbstractClient_1 = require("./AbstractClient");
 const constants_1 = require("../lib/constants");
 const runtime_1 = require("../lib/runtime");
+const errors_1 = require("../lib/errors");
 /**
  * Represents an error that occurred in a WebSocket-like connection.
  * @property {any} error - The underlying error object.
@@ -257,6 +258,167 @@ class AbstractLiveClient extends AbstractClient_1.AbstractClient {
         var _a;
         return this.key === "proxy" && !!((_a = this.namespaceOptions.websocket.options.proxy) === null || _a === void 0 ? void 0 : _a.url);
     }
+    /**
+     * Extracts enhanced error information from a WebSocket error event.
+     * This method attempts to capture additional debugging information such as
+     * status codes, request IDs, and response headers when available.
+     *
+     * @example
+     * ```typescript
+     * // Enhanced error information is now available in error events:
+     * connection.on(LiveTranscriptionEvents.Error, (err) => {
+     *   console.error("WebSocket Error:", err.message);
+     *
+     *   // Access HTTP status code (e.g., 502, 403, etc.)
+     *   if (err.statusCode) {
+     *     console.error(`HTTP Status Code: ${err.statusCode}`);
+     *   }
+     *
+     *   // Access Deepgram request ID for support tickets
+     *   if (err.requestId) {
+     *     console.error(`Deepgram Request ID: ${err.requestId}`);
+     *   }
+     *
+     *   // Access WebSocket URL and connection state
+     *   if (err.url) {
+     *     console.error(`WebSocket URL: ${err.url}`);
+     *   }
+     *
+     *   if (err.readyState !== undefined) {
+     *     const stateNames = ['CONNECTING', 'OPEN', 'CLOSING', 'CLOSED'];
+     *     console.error(`Connection State: ${stateNames[err.readyState]}`);
+     *   }
+     *
+     *   // Access response headers for additional debugging
+     *   if (err.responseHeaders) {
+     *     console.error("Response Headers:", err.responseHeaders);
+     *   }
+     *
+     *   // Access the enhanced error object for detailed debugging
+     *   if (err.error?.name === 'DeepgramWebSocketError') {
+     *     console.error("Enhanced Error Details:", err.error.toJSON());
+     *   }
+     * });
+     * ```
+     *
+     * @param event - The error event from the WebSocket
+     * @param conn - The WebSocket connection object
+     * @returns Enhanced error information object
+     */
+    extractErrorInformation(event, conn) {
+        var _a;
+        const errorInfo = {};
+        // Extract basic connection information
+        if (conn) {
+            errorInfo.readyState = conn.readyState;
+            errorInfo.url = typeof conn.url === "string" ? conn.url : (_a = conn.url) === null || _a === void 0 ? void 0 : _a.toString();
+        }
+        // Try to extract additional information from the WebSocket connection
+        // This works with the 'ws' package which exposes more detailed error information
+        if (conn && typeof conn === "object") {
+            const wsConn = conn;
+            // Extract status code if available (from 'ws' package)
+            if (wsConn._req && wsConn._req.res) {
+                errorInfo.statusCode = wsConn._req.res.statusCode;
+                // Extract response headers if available
+                if (wsConn._req.res.headers) {
+                    errorInfo.responseHeaders = Object.assign({}, wsConn._req.res.headers);
+                    // Extract request ID from Deepgram response headers
+                    const requestId = wsConn._req.res.headers["dg-request-id"] || wsConn._req.res.headers["x-dg-request-id"];
+                    if (requestId) {
+                        errorInfo.requestId = requestId;
+                    }
+                }
+            }
+            // For native WebSocket, try to extract information from the event
+            if (event && "target" in event && event.target) {
+                const target = event.target;
+                if (target.url) {
+                    errorInfo.url = target.url;
+                }
+                if (target.readyState !== undefined) {
+                    errorInfo.readyState = target.readyState;
+                }
+            }
+        }
+        return errorInfo;
+    }
+    /**
+     * Creates an enhanced error object with additional debugging information.
+     * This method provides backward compatibility by including both the original
+     * error event and enhanced error information.
+     *
+     * @param event - The original error event
+     * @param enhancedInfo - Additional error information extracted from the connection
+     * @returns An object containing both original and enhanced error information
+     */
+    createEnhancedError(event, enhancedInfo) {
+        // Create the enhanced error for detailed debugging
+        const enhancedError = new errors_1.DeepgramWebSocketError(event.message || "WebSocket connection error", Object.assign({ originalEvent: event }, enhancedInfo));
+        // Return an object that maintains backward compatibility
+        // while providing enhanced information
+        return Object.assign(Object.assign({}, event), { 
+            // Enhanced error information
+            error: enhancedError, 
+            // Additional fields for easier access
+            statusCode: enhancedInfo.statusCode, requestId: enhancedInfo.requestId, responseHeaders: enhancedInfo.responseHeaders, url: enhancedInfo.url, readyState: enhancedInfo.readyState, 
+            // Enhanced message with more context
+            message: this.buildEnhancedErrorMessage(event, enhancedInfo) });
+    }
+    /**
+     * Builds an enhanced error message with additional context information.
+     *
+     * @param event - The original error event
+     * @param enhancedInfo - Additional error information
+     * @returns A more descriptive error message
+     */
+    buildEnhancedErrorMessage(event, enhancedInfo) {
+        let message = event.message || "WebSocket connection error";
+        const details = [];
+        if (enhancedInfo.statusCode) {
+            details.push(`Status: ${enhancedInfo.statusCode}`);
+        }
+        if (enhancedInfo.requestId) {
+            details.push(`Request ID: ${enhancedInfo.requestId}`);
+        }
+        if (enhancedInfo.readyState !== undefined) {
+            const stateNames = ["CONNECTING", "OPEN", "CLOSING", "CLOSED"];
+            const stateName = stateNames[enhancedInfo.readyState] || `Unknown(${enhancedInfo.readyState})`;
+            details.push(`Ready State: ${stateName}`);
+        }
+        if (enhancedInfo.url) {
+            details.push(`URL: ${enhancedInfo.url}`);
+        }
+        if (details.length > 0) {
+            message += ` (${details.join(", ")})`;
+        }
+        return message;
+    }
+    /**
+     * Sets up the standard connection event handlers (open, close, error) for WebSocket connections.
+     * This method abstracts the common connection event registration pattern used across all live clients.
+     *
+     * @param events - Object containing the event constants for the specific client type
+     * @param events.Open - Event constant for connection open
+     * @param events.Close - Event constant for connection close
+     * @param events.Error - Event constant for connection error
+     * @protected
+     */
+    setupConnectionEvents(events) {
+        if (this.conn) {
+            this.conn.onopen = () => {
+                this.emit(events.Open, this);
+            };
+            this.conn.onclose = (event) => {
+                this.emit(events.Close, event);
+            };
+            this.conn.onerror = (event) => {
+                const enhancedInfo = this.extractErrorInformation(event, this.conn || undefined);
+                const enhancedError = this.createEnhancedError(event, enhancedInfo);
+                this.emit(events.Error, enhancedError);
+            };
+        }
+    }
 }
 exports.AbstractLiveClient = AbstractLiveClient;
 exports.AbstractWsClient = AbstractLiveClient;

package/dist/main/packages/AbstractLiveClient.js.map

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

package/dist/main/packages/AgentLiveClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentLiveClient.d.ts","sourceRoot":"","sources":["../../../src/packages/AgentLiveClient.ts"],"names":[],"mappings":";AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACjG,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,qBAAa,eAAgB,SAAQ,kBAAkB;IAC9C,SAAS,EAAE,MAAM,CAAW;gBAEvB,OAAO,EAAE,qBAAqB,EAAE,QAAQ,GAAE,MAAmC;IAOzF;;;;;;;OAOG;IACI,eAAe,IAAI,IAAI;IAoB9B;;;OAGG;IACH,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IA8BlD;;;OAGG;IACH,SAAS,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIjD;;;OAGG;IACH,SAAS,CAAC,iBAAiB,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAQ5C;;;;OAIG;IACI,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAQhD;;;OAGG;IACI,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIzC;;;OAGG;IACI,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,GAAG,IAAI;IAI5F;;;;;;;;OAQG;IACI,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhD;;;OAGG;IACI,oBAAoB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAIjE;;;;OAIG;IACI,SAAS,IAAI,IAAI;CAGzB"}
+{"version":3,"file":"AgentLiveClient.d.ts","sourceRoot":"","sources":["../../../src/packages/AgentLiveClient.ts"],"names":[],"mappings":";AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACjG,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,qBAAa,eAAgB,SAAQ,kBAAkB;IAC9C,SAAS,EAAE,MAAM,CAAW;gBAEvB,OAAO,EAAE,qBAAqB,EAAE,QAAQ,GAAE,MAAmC;IAOzF;;;;;;;OAOG;IACI,eAAe,IAAI,IAAI;IAgB9B;;;OAGG;IACH,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAqClD;;;OAGG;IACH,SAAS,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIjD;;;OAGG;IACH,SAAS,CAAC,iBAAiB,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAQ5C;;;;OAIG;IACI,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAQhD;;;OAGG;IACI,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIzC;;;OAGG;IACI,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,GAAG,IAAI;IAI5F;;;;;;;;OAQG;IACI,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhD;;;OAGG;IACI,oBAAoB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAIjE;;;;OAIG;IACI,SAAS,IAAI,IAAI;CAGzB"}

package/dist/main/packages/AgentLiveClient.js

@@ -21,16 +21,14 @@ class AgentLiveClient extends AbstractLiveClient_1.AbstractLiveClient {
      * - When a message is received, it parses the message and emits the appropriate event based on the message type.
      */
     setupConnection() {
+        // Set up standard connection events (open, close, error) using abstracted method
+        this.setupConnectionEvents({
+            Open: AgentEvents_1.AgentEvents.Open,
+            Close: AgentEvents_1.AgentEvents.Close,
+            Error: AgentEvents_1.AgentEvents.Error,
+        });
+        // Set up message handling specific to agent conversations
         if (this.conn) {
-            this.conn.onopen = () => {
-                this.emit(AgentEvents_1.AgentEvents.Open, this);
-            };
-            this.conn.onclose = (event) => {
-                this.emit(AgentEvents_1.AgentEvents.Close, event);
-            };
-            this.conn.onerror = (event) => {
-                this.emit(AgentEvents_1.AgentEvents.Error, event);
-            };
             this.conn.onmessage = (event) => {
                 this.handleMessage(event);
             };
@@ -41,6 +39,7 @@ class AgentLiveClient extends AbstractLiveClient_1.AbstractLiveClient {
      * @param event - The MessageEvent object representing the received message.
      */
     handleMessage(event) {
+        var _a, _b, _c, _d, _e, _f;
         if (typeof event.data === "string") {
             try {
                 const data = JSON.parse(event.data);
@@ -49,9 +48,12 @@ class AgentLiveClient extends AbstractLiveClient_1.AbstractLiveClient {
             catch (error) {
                 this.emit(AgentEvents_1.AgentEvents.Error, {
                     event,
-                    data: event.data,
+                    data: ((_a = event.data) === null || _a === void 0 ? void 0 : _a.toString().substring(0, 200)) +
+                        (((_b = event.data) === null || _b === void 0 ? void 0 : _b.toString().length) > 200 ? "..." : ""),
                     message: "Unable to parse `data` as JSON.",
                     error,
+                    url: (_c = this.conn) === null || _c === void 0 ? void 0 : _c.url,
+                    readyState: (_d = this.conn) === null || _d === void 0 ? void 0 : _d.readyState,
                 });
             }
         }
@@ -71,6 +73,9 @@ class AgentLiveClient extends AbstractLiveClient_1.AbstractLiveClient {
             this.emit(AgentEvents_1.AgentEvents.Error, {
                 event,
                 message: "Received unknown data type.",
+                url: (_e = this.conn) === null || _e === void 0 ? void 0 : _e.url,
+                readyState: (_f = this.conn) === null || _f === void 0 ? void 0 : _f.readyState,
+                dataType: typeof event.data,
             });
         }
     }