@deepgram/sdk 5.0.0-alpha.1 → 5.0.0-alpha.2

package/dist/cjs/BaseClient.js

@@ -42,6 +42,9 @@ const core = __importStar(require("./core/index.js"));
 function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
+        "X-Fern-SDK-Name": "",
+        "X-Fern-SDK-Version": "0.0.219",
+        "User-Agent": "/0.0.219",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/cjs/CustomClient.js

@@ -60,6 +60,19 @@ const headers_js_1 = require("./core/headers.js");
 const json_js_1 = require("./core/json.js");
 const core = __importStar(require("./core/index.js"));
 const environments = __importStar(require("./environments.js"));
+const index_js_1 = require("./core/runtime/index.js");
+// Import ws library for Node.js (will be undefined in browser)
+let NodeWebSocket;
+try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    NodeWebSocket = require("ws");
+    // Handle both default export and named export
+    NodeWebSocket = NodeWebSocket.WebSocket || NodeWebSocket.default || NodeWebSocket;
+}
+catch (_a) {
+    // ws not available (e.g., in browser)
+    NodeWebSocket = undefined;
+}
 /**
  * Custom wrapper around DeepgramClient that ensures the custom websocket implementation
  * from ws.ts is always used, even if the auto-generated code changes.
@@ -130,24 +143,78 @@ class WrappedSpeakClient extends Client_js_3.SpeakClient {
         return new WrappedSpeakV1Client(this._options);
     }
 }
+/**
+ * Helper function to get WebSocket class and handle headers/protocols based on runtime.
+ * In Node.js, use the 'ws' library which supports headers.
+ * In browser, use Sec-WebSocket-Protocol for authentication since headers aren't supported.
+ */
+function getWebSocketOptions(headers) {
+    const options = {};
+    // Check if we're in a browser environment (browser or web-worker)
+    const isBrowser = index_js_1.RUNTIME.type === "browser" || index_js_1.RUNTIME.type === "web-worker";
+    // In Node.js, ensure we use the 'ws' library which supports headers
+    if (index_js_1.RUNTIME.type === "node" && NodeWebSocket) {
+        options.WebSocket = NodeWebSocket;
+        options.headers = headers;
+    }
+    else if (isBrowser) {
+        // In browser, native WebSocket doesn't support custom headers
+        // Extract Authorization header and use Sec-WebSocket-Protocol instead
+        const authHeader = headers.Authorization || headers.authorization;
+        const browserHeaders = Object.assign({}, headers);
+        // Remove Authorization from headers since it won't work in browser
+        delete browserHeaders.Authorization;
+        delete browserHeaders.authorization;
+        options.headers = browserHeaders;
+        // If we have an Authorization header, extract the token and format as protocols
+        // Deepgram expects:
+        // - For API keys: Sec-WebSocket-Protocol: token,API_KEY_GOES_HERE
+        // - For Bearer tokens: Sec-WebSocket-Protocol: bearer,TOKEN_GOES_HERE
+        // The comma separates multiple protocols, so we pass them as an array
+        if (authHeader && typeof authHeader === "string") {
+            if (authHeader.startsWith("Token ")) {
+                // API key: "Token API_KEY" -> ["token", "API_KEY"]
+                const apiKey = authHeader.substring(6); // Remove "Token " prefix
+                options.protocols = ["token", apiKey];
+            }
+            else if (authHeader.startsWith("Bearer ")) {
+                // Access token: "Bearer TOKEN" -> ["bearer", "TOKEN"]
+                const token = authHeader.substring(7); // Remove "Bearer " prefix
+                options.protocols = ["bearer", token];
+            }
+            else {
+                // Fallback: use the entire header value if it doesn't match expected format
+                options.protocols = [authHeader];
+            }
+        }
+    }
+    else {
+        // Fallback for other environments
+        options.headers = headers;
+    }
+    return options;
+}
 /**
  * Wrapper for Agent V1Client that overrides connect to use custom websocket.
  */
 class WrappedAgentV1Client extends Client_js_4.V1Client {
     connect() {
         return __awaiter(this, arguments, void 0, function* (args = {}) {
-            var _a, _b, _c, _d;
+            var _a, _b, _c, _d, _e;
             const { headers, debug, reconnectAttempts } = args;
             // Get Authorization from authProvider (matching the working version)
             const authRequest = yield ((_a = this._options.authProvider) === null || _a === void 0 ? void 0 : _a.getAuthRequest());
             const _headers = (0, headers_js_1.mergeHeaders)((_b = authRequest === null || authRequest === void 0 ? void 0 : authRequest.headers) !== null && _b !== void 0 ? _b : {}, headers);
+            // Get WebSocket options with proper header handling
+            const wsOptions = getWebSocketOptions(_headers);
             // Explicitly use the custom ReconnectingWebSocket from ws.ts
             const socket = new ws_js_1.ReconnectingWebSocket({
                 url: core.url.join((_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : ((_d = (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.DeepgramEnvironment.Production).agent, "/v1/agent/converse"),
-                protocols: [],
+                protocols: (_e = wsOptions.protocols) !== null && _e !== void 0 ? _e : [],
                 queryParameters: {},
-                headers: _headers,
+                headers: wsOptions.headers,
                 options: {
+                    WebSocket: wsOptions.WebSocket,
                     debug: debug !== null && debug !== void 0 ? debug : false,
                     maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30,
                     startClosed: true,
@@ -203,6 +270,13 @@ class WrappedAgentV1Socket extends Socket_js_1.V1Socket {
         }
     }
     connect() {
+        // Ensure socket is ready to connect - if _connectLock is stuck, force reconnect
+        // by closing and reconnecting
+        if (this.socket.readyState === this.socket.CLOSED) {
+            // Force a fresh reconnect to ensure _connectLock is reset
+            this.socket._connectLock = false;
+            this.socket._shouldReconnect = true;
+        }
         // Call parent connect, but then ensure our binary handler is still active
         super.connect();
         // Re-setup binary handling in case connect() re-registered handlers
@@ -216,7 +290,7 @@ class WrappedAgentV1Socket extends Socket_js_1.V1Socket {
 class WrappedListenV1Client extends Client_js_5.V1Client {
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            var _a, _b, _c;
             // Extract all the args (same as the original implementation)
             const { callback, callback_method: callbackMethod, channels, diarize, dictation, encoding, endpointing, extra, interim_results: interimResults, keyterm, keywords, language, mip_opt_out: mipOptOut, model, multichannel, numerals, profanity_filter: profanityFilter, punctuate, redact, replace, sample_rate: sampleRate, search, smart_format: smartFormat, tag, utterance_end_ms: utteranceEndMs, vad_events: vadEvents, version, headers, debug, reconnectAttempts, } = args;
             // Build query params (same as original)
@@ -277,13 +351,16 @@ class WrappedListenV1Client extends Client_js_5.V1Client {
             // Get Authorization from authProvider (matching the working version)
             const authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = (0, headers_js_1.mergeHeaders)(authRequest.headers, headers);
+            // Get WebSocket options with proper header handling
+            const wsOptions = getWebSocketOptions(_headers);
             // Explicitly use the custom ReconnectingWebSocket from ws.ts
             const socket = new ws_js_1.ReconnectingWebSocket({
                 url: core.url.join((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.DeepgramEnvironment.Production).production, "/v1/listen"),
-                protocols: [],
+                protocols: (_c = wsOptions.protocols) !== null && _c !== void 0 ? _c : [],
                 queryParameters: _queryParams,
-                headers: _headers,
+                headers: wsOptions.headers,
                 options: {
+                    WebSocket: wsOptions.WebSocket,
                     debug: debug !== null && debug !== void 0 ? debug : false,
                     maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30,
                     startClosed: true,
@@ -335,6 +412,12 @@ class WrappedListenV1Socket extends Socket_js_2.V1Socket {
         }
     }
     connect() {
+        // Ensure socket is ready to connect - if _connectLock is stuck, force reconnect
+        if (this.socket.readyState === this.socket.CLOSED) {
+            // Force a fresh reconnect to ensure _connectLock is reset
+            this.socket._connectLock = false;
+            this.socket._shouldReconnect = true;
+        }
         super.connect();
         this.setupBinaryHandling();
         return this;
@@ -346,7 +429,7 @@ class WrappedListenV1Socket extends Socket_js_2.V1Socket {
 class WrappedListenV2Client extends Client_js_6.V2Client {
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d;
+            var _a, _b, _c, _d, _e;
             const { model, encoding, sample_rate: sampleRate, eager_eot_threshold: eagerEotThreshold, eot_threshold: eotThreshold, eot_timeout_ms: eotTimeoutMs, keyterm, mip_opt_out: mipOptOut, tag, headers, debug, reconnectAttempts, } = args;
             const _queryParams = {};
             _queryParams.model = model;
@@ -369,13 +452,16 @@ class WrappedListenV2Client extends Client_js_6.V2Client {
             // Get Authorization from authProvider (matching the working version)
             const authRequest = yield ((_a = this._options.authProvider) === null || _a === void 0 ? void 0 : _a.getAuthRequest());
             const _headers = (0, headers_js_1.mergeHeaders)((_b = authRequest === null || authRequest === void 0 ? void 0 : authRequest.headers) !== null && _b !== void 0 ? _b : {}, headers);
+            // Get WebSocket options with proper header handling
+            const wsOptions = getWebSocketOptions(_headers);
             // Explicitly use the custom ReconnectingWebSocket from ws.ts
             const socket = new ws_js_1.ReconnectingWebSocket({
                 url: core.url.join((_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : ((_d = (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.DeepgramEnvironment.Production).production, "/v2/listen"),
-                protocols: [],
+                protocols: (_e = wsOptions.protocols) !== null && _e !== void 0 ? _e : [],
                 queryParameters: _queryParams,
-                headers: _headers,
+                headers: wsOptions.headers,
                 options: {
+                    WebSocket: wsOptions.WebSocket,
                     debug: debug !== null && debug !== void 0 ? debug : false,
                     maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30,
                     startClosed: true,
@@ -427,6 +513,12 @@ class WrappedListenV2Socket extends Socket_js_3.V2Socket {
         }
     }
     connect() {
+        // Ensure socket is ready to connect - if _connectLock is stuck, force reconnect
+        if (this.socket.readyState === this.socket.CLOSED) {
+            // Force a fresh reconnect to ensure _connectLock is reset
+            this.socket._connectLock = false;
+            this.socket._shouldReconnect = true;
+        }
         super.connect();
         this.setupBinaryHandling();
         return this;
@@ -438,7 +530,7 @@ class WrappedListenV2Socket extends Socket_js_3.V2Socket {
 class WrappedSpeakV1Client extends Client_js_7.V1Client {
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            var _a, _b, _c;
             const { encoding, mip_opt_out: mipOptOut, model, sample_rate: sampleRate, headers, debug, reconnectAttempts, } = args;
             const _queryParams = {};
             if (encoding != null)
@@ -452,13 +544,16 @@ class WrappedSpeakV1Client extends Client_js_7.V1Client {
             // Get Authorization from authProvider (matching the working version)
             const authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = (0, headers_js_1.mergeHeaders)(authRequest.headers, headers);
+            // Get WebSocket options with proper header handling
+            const wsOptions = getWebSocketOptions(_headers);
             // Explicitly use the custom ReconnectingWebSocket from ws.ts
             const socket = new ws_js_1.ReconnectingWebSocket({
                 url: core.url.join((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.DeepgramEnvironment.Production).production, "/v1/speak"),
-                protocols: [],
+                protocols: (_c = wsOptions.protocols) !== null && _c !== void 0 ? _c : [],
                 queryParameters: _queryParams,
-                headers: _headers,
+                headers: wsOptions.headers,
                 options: {
+                    WebSocket: wsOptions.WebSocket,
                     debug: debug !== null && debug !== void 0 ? debug : false,
                     maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30,
                     startClosed: true,
@@ -510,6 +605,12 @@ class WrappedSpeakV1Socket extends Socket_js_4.V1Socket {
         }
     }
     connect() {
+        // Ensure socket is ready to connect - if _connectLock is stuck, force reconnect
+        if (this.socket.readyState === this.socket.CLOSED) {
+            // Force a fresh reconnect to ensure _connectLock is reset
+            this.socket._connectLock = false;
+            this.socket._shouldReconnect = true;
+        }
         super.connect();
         this.setupBinaryHandling();
         return this;

package/dist/cjs/core/websocket/ws.d.ts

@@ -42,7 +42,6 @@ export declare class ReconnectingWebSocket {
     private _binaryType;
     private _closeCalled;
     private _messageQueue;
-    private _nodeMessageHandler?;
     private readonly _url;
     private readonly _protocols?;
     private readonly _options;

package/dist/cjs/core/websocket/ws.js

@@ -39,14 +39,13 @@ const index_js_1 = require("../runtime/index.js");
 const qs_js_1 = require("../url/qs.js");
 const Events = __importStar(require("./events.js"));
 const getGlobalWebSocket = () => {
-    // In Node.js, prefer the ws library over the built-in WebSocket for better header support
-    if (index_js_1.RUNTIME.type === "node") {
-        return ws_1.WebSocket;
-    }
-    else if (typeof WebSocket !== "undefined") {
+    if (typeof WebSocket !== "undefined") {
         // @ts-ignore
         return WebSocket;
     }
+    else if (index_js_1.RUNTIME.type === "node") {
+        return ws_1.WebSocket;
+    }
     return undefined;
 };
 /**
@@ -122,14 +121,12 @@ class ReconnectingWebSocket {
         };
         this._handleError = (event) => {
             this._debug("error event", event.message);
-            // Use a non-1000 close code so _shouldReconnect remains true for retries
-            this._disconnect(1006, event.message === "TIMEOUT" ? "timeout" : undefined);
+            this._disconnect(undefined, event.message === "TIMEOUT" ? "timeout" : undefined);
             if (this.onerror) {
                 this.onerror(event);
             }
+            this._debug("exec error listeners");
             this._listeners.error.forEach((listener) => this._callEventListener(event, listener));
-            // Ensure we can retry by setting _shouldReconnect to true
-            this._shouldReconnect = true;
             this._connect();
         };
         this._handleClose = (event) => {
@@ -366,18 +363,7 @@ class ReconnectingWebSocket {
             }
             const options = {};
             if (this._headers) {
-                // Ensure all header values are strings for ws library
-                const stringHeaders = {};
-                for (const [key, value] of Object.entries(this._headers)) {
-                    if (typeof value === "string") {
-                        stringHeaders[key] = value;
-                    }
-                    else if (value != null) {
-                        // Convert non-string values to strings
-                        stringHeaders[key] = String(value);
-                    }
-                }
-                options.headers = stringHeaders;
+                options.headers = this._headers;
             }
             if (this._queryParameters && Object.keys(this._queryParameters).length > 0) {
                 const queryString = (0, qs_js_1.toQueryString)(this._queryParameters, { arrayFormat: "repeat" });
@@ -431,14 +417,7 @@ class ReconnectingWebSocket {
         this._debug("removeListeners");
         this._ws.removeEventListener("open", this._handleOpen);
         this._ws.removeEventListener("close", this._handleClose);
-        if (index_js_1.RUNTIME.type === "node" && this._nodeMessageHandler) {
-            // Remove the message listener we added with .on()
-            this._ws.off("message", this._nodeMessageHandler);
-            this._nodeMessageHandler = undefined;
-        }
-        else {
-            this._ws.removeEventListener("message", this._handleMessage);
-        }
+        this._ws.removeEventListener("message", this._handleMessage);
         // @ts-ignore
         this._ws.removeEventListener("error", this._handleError);
     }
@@ -449,24 +428,7 @@ class ReconnectingWebSocket {
         this._debug("addListeners");
         this._ws.addEventListener("open", this._handleOpen);
         this._ws.addEventListener("close", this._handleClose);
-        // For ws library, we need to wrap the message data in a MessageEvent-like object
-        if (index_js_1.RUNTIME.type === "node") {
-            // ws library emits data directly via .on(), not as MessageEvent
-            // Convert Buffer to string for text messages
-            this._nodeMessageHandler = (data, isBinary) => {
-                // Convert Buffer to string if it's a text message
-                let messageData = data;
-                if (!isBinary && Buffer.isBuffer(data)) {
-                    messageData = data.toString("utf8");
-                }
-                const event = { data: messageData, type: "message", target: this._ws };
-                this._handleMessage(event);
-            };
-            this._ws.on("message", this._nodeMessageHandler);
-        }
-        else {
-            this._ws.addEventListener("message", this._handleMessage);
-        }
+        this._ws.addEventListener("message", this._handleMessage);
         // @ts-ignore
         this._ws.addEventListener("error", this._handleError);
     }

package/dist/cjs/version.d.ts

@@ -0,0 +1 @@
+export declare const SDK_VERSION = "0.0.219";

package/dist/cjs/version.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SDK_VERSION = void 0;
+exports.SDK_VERSION = "0.0.219";

package/dist/esm/BaseClient.mjs

@@ -5,6 +5,9 @@ import * as core from "./core/index.mjs";
 export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
+        "X-Fern-SDK-Name": "",
+        "X-Fern-SDK-Version": "0.0.219",
+        "User-Agent": "/0.0.219",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/esm/CustomClient.mjs

@@ -24,6 +24,19 @@ import { mergeHeaders, mergeOnlyDefinedHeaders } from "./core/headers.mjs";
 import { fromJson } from "./core/json.mjs";
 import * as core from "./core/index.mjs";
 import * as environments from "./environments.mjs";
+import { RUNTIME } from "./core/runtime/index.mjs";
+// Import ws library for Node.js (will be undefined in browser)
+let NodeWebSocket;
+try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    NodeWebSocket = require("ws");
+    // Handle both default export and named export
+    NodeWebSocket = NodeWebSocket.WebSocket || NodeWebSocket.default || NodeWebSocket;
+}
+catch (_a) {
+    // ws not available (e.g., in browser)
+    NodeWebSocket = undefined;
+}
 /**
  * Custom wrapper around DeepgramClient that ensures the custom websocket implementation
  * from ws.ts is always used, even if the auto-generated code changes.
@@ -93,24 +106,78 @@ class WrappedSpeakClient extends SpeakClientImpl {
         return new WrappedSpeakV1Client(this._options);
     }
 }
+/**
+ * Helper function to get WebSocket class and handle headers/protocols based on runtime.
+ * In Node.js, use the 'ws' library which supports headers.
+ * In browser, use Sec-WebSocket-Protocol for authentication since headers aren't supported.
+ */
+function getWebSocketOptions(headers) {
+    const options = {};
+    // Check if we're in a browser environment (browser or web-worker)
+    const isBrowser = RUNTIME.type === "browser" || RUNTIME.type === "web-worker";
+    // In Node.js, ensure we use the 'ws' library which supports headers
+    if (RUNTIME.type === "node" && NodeWebSocket) {
+        options.WebSocket = NodeWebSocket;
+        options.headers = headers;
+    }
+    else if (isBrowser) {
+        // In browser, native WebSocket doesn't support custom headers
+        // Extract Authorization header and use Sec-WebSocket-Protocol instead
+        const authHeader = headers.Authorization || headers.authorization;
+        const browserHeaders = Object.assign({}, headers);
+        // Remove Authorization from headers since it won't work in browser
+        delete browserHeaders.Authorization;
+        delete browserHeaders.authorization;
+        options.headers = browserHeaders;
+        // If we have an Authorization header, extract the token and format as protocols
+        // Deepgram expects:
+        // - For API keys: Sec-WebSocket-Protocol: token,API_KEY_GOES_HERE
+        // - For Bearer tokens: Sec-WebSocket-Protocol: bearer,TOKEN_GOES_HERE
+        // The comma separates multiple protocols, so we pass them as an array
+        if (authHeader && typeof authHeader === "string") {
+            if (authHeader.startsWith("Token ")) {
+                // API key: "Token API_KEY" -> ["token", "API_KEY"]
+                const apiKey = authHeader.substring(6); // Remove "Token " prefix
+                options.protocols = ["token", apiKey];
+            }
+            else if (authHeader.startsWith("Bearer ")) {
+                // Access token: "Bearer TOKEN" -> ["bearer", "TOKEN"]
+                const token = authHeader.substring(7); // Remove "Bearer " prefix
+                options.protocols = ["bearer", token];
+            }
+            else {
+                // Fallback: use the entire header value if it doesn't match expected format
+                options.protocols = [authHeader];
+            }
+        }
+    }
+    else {
+        // Fallback for other environments
+        options.headers = headers;
+    }
+    return options;
+}
 /**
  * Wrapper for Agent V1Client that overrides connect to use custom websocket.
  */
 class WrappedAgentV1Client extends AgentV1Client {
     connect() {
         return __awaiter(this, arguments, void 0, function* (args = {}) {
-            var _a, _b, _c, _d;
+            var _a, _b, _c, _d, _e;
             const { headers, debug, reconnectAttempts } = args;
             // Get Authorization from authProvider (matching the working version)
             const authRequest = yield ((_a = this._options.authProvider) === null || _a === void 0 ? void 0 : _a.getAuthRequest());
             const _headers = mergeHeaders((_b = authRequest === null || authRequest === void 0 ? void 0 : authRequest.headers) !== null && _b !== void 0 ? _b : {}, headers);
+            // Get WebSocket options with proper header handling
+            const wsOptions = getWebSocketOptions(_headers);
             // Explicitly use the custom ReconnectingWebSocket from ws.ts
             const socket = new ReconnectingWebSocket({
                 url: core.url.join((_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : ((_d = (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.DeepgramEnvironment.Production).agent, "/v1/agent/converse"),
-                protocols: [],
+                protocols: (_e = wsOptions.protocols) !== null && _e !== void 0 ? _e : [],
                 queryParameters: {},
-                headers: _headers,
+                headers: wsOptions.headers,
                 options: {
+                    WebSocket: wsOptions.WebSocket,
                     debug: debug !== null && debug !== void 0 ? debug : false,
                     maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30,
                     startClosed: true,
@@ -166,6 +233,13 @@ class WrappedAgentV1Socket extends AgentV1Socket {
         }
     }
     connect() {
+        // Ensure socket is ready to connect - if _connectLock is stuck, force reconnect
+        // by closing and reconnecting
+        if (this.socket.readyState === this.socket.CLOSED) {
+            // Force a fresh reconnect to ensure _connectLock is reset
+            this.socket._connectLock = false;
+            this.socket._shouldReconnect = true;
+        }
         // Call parent connect, but then ensure our binary handler is still active
         super.connect();
         // Re-setup binary handling in case connect() re-registered handlers
@@ -179,7 +253,7 @@ class WrappedAgentV1Socket extends AgentV1Socket {
 class WrappedListenV1Client extends ListenV1Client {
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            var _a, _b, _c;
             // Extract all the args (same as the original implementation)
             const { callback, callback_method: callbackMethod, channels, diarize, dictation, encoding, endpointing, extra, interim_results: interimResults, keyterm, keywords, language, mip_opt_out: mipOptOut, model, multichannel, numerals, profanity_filter: profanityFilter, punctuate, redact, replace, sample_rate: sampleRate, search, smart_format: smartFormat, tag, utterance_end_ms: utteranceEndMs, vad_events: vadEvents, version, headers, debug, reconnectAttempts, } = args;
             // Build query params (same as original)
@@ -240,13 +314,16 @@ class WrappedListenV1Client extends ListenV1Client {
             // Get Authorization from authProvider (matching the working version)
             const authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = mergeHeaders(authRequest.headers, headers);
+            // Get WebSocket options with proper header handling
+            const wsOptions = getWebSocketOptions(_headers);
             // Explicitly use the custom ReconnectingWebSocket from ws.ts
             const socket = new ReconnectingWebSocket({
                 url: core.url.join((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.DeepgramEnvironment.Production).production, "/v1/listen"),
-                protocols: [],
+                protocols: (_c = wsOptions.protocols) !== null && _c !== void 0 ? _c : [],
                 queryParameters: _queryParams,
-                headers: _headers,
+                headers: wsOptions.headers,
                 options: {
+                    WebSocket: wsOptions.WebSocket,
                     debug: debug !== null && debug !== void 0 ? debug : false,
                     maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30,
                     startClosed: true,
@@ -298,6 +375,12 @@ class WrappedListenV1Socket extends ListenV1Socket {
         }
     }
     connect() {
+        // Ensure socket is ready to connect - if _connectLock is stuck, force reconnect
+        if (this.socket.readyState === this.socket.CLOSED) {
+            // Force a fresh reconnect to ensure _connectLock is reset
+            this.socket._connectLock = false;
+            this.socket._shouldReconnect = true;
+        }
         super.connect();
         this.setupBinaryHandling();
         return this;
@@ -309,7 +392,7 @@ class WrappedListenV1Socket extends ListenV1Socket {
 class WrappedListenV2Client extends ListenV2Client {
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d;
+            var _a, _b, _c, _d, _e;
             const { model, encoding, sample_rate: sampleRate, eager_eot_threshold: eagerEotThreshold, eot_threshold: eotThreshold, eot_timeout_ms: eotTimeoutMs, keyterm, mip_opt_out: mipOptOut, tag, headers, debug, reconnectAttempts, } = args;
             const _queryParams = {};
             _queryParams.model = model;
@@ -332,13 +415,16 @@ class WrappedListenV2Client extends ListenV2Client {
             // Get Authorization from authProvider (matching the working version)
             const authRequest = yield ((_a = this._options.authProvider) === null || _a === void 0 ? void 0 : _a.getAuthRequest());
             const _headers = mergeHeaders((_b = authRequest === null || authRequest === void 0 ? void 0 : authRequest.headers) !== null && _b !== void 0 ? _b : {}, headers);
+            // Get WebSocket options with proper header handling
+            const wsOptions = getWebSocketOptions(_headers);
             // Explicitly use the custom ReconnectingWebSocket from ws.ts
             const socket = new ReconnectingWebSocket({
                 url: core.url.join((_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : ((_d = (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.DeepgramEnvironment.Production).production, "/v2/listen"),
-                protocols: [],
+                protocols: (_e = wsOptions.protocols) !== null && _e !== void 0 ? _e : [],
                 queryParameters: _queryParams,
-                headers: _headers,
+                headers: wsOptions.headers,
                 options: {
+                    WebSocket: wsOptions.WebSocket,
                     debug: debug !== null && debug !== void 0 ? debug : false,
                     maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30,
                     startClosed: true,
@@ -390,6 +476,12 @@ class WrappedListenV2Socket extends ListenV2Socket {
         }
     }
     connect() {
+        // Ensure socket is ready to connect - if _connectLock is stuck, force reconnect
+        if (this.socket.readyState === this.socket.CLOSED) {
+            // Force a fresh reconnect to ensure _connectLock is reset
+            this.socket._connectLock = false;
+            this.socket._shouldReconnect = true;
+        }
         super.connect();
         this.setupBinaryHandling();
         return this;
@@ -401,7 +493,7 @@ class WrappedListenV2Socket extends ListenV2Socket {
 class WrappedSpeakV1Client extends SpeakV1Client {
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            var _a, _b, _c;
             const { encoding, mip_opt_out: mipOptOut, model, sample_rate: sampleRate, headers, debug, reconnectAttempts, } = args;
             const _queryParams = {};
             if (encoding != null)
@@ -415,13 +507,16 @@ class WrappedSpeakV1Client extends SpeakV1Client {
             // Get Authorization from authProvider (matching the working version)
             const authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = mergeHeaders(authRequest.headers, headers);
+            // Get WebSocket options with proper header handling
+            const wsOptions = getWebSocketOptions(_headers);
             // Explicitly use the custom ReconnectingWebSocket from ws.ts
             const socket = new ReconnectingWebSocket({
                 url: core.url.join((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.DeepgramEnvironment.Production).production, "/v1/speak"),
-                protocols: [],
+                protocols: (_c = wsOptions.protocols) !== null && _c !== void 0 ? _c : [],
                 queryParameters: _queryParams,
-                headers: _headers,
+                headers: wsOptions.headers,
                 options: {
+                    WebSocket: wsOptions.WebSocket,
                     debug: debug !== null && debug !== void 0 ? debug : false,
                     maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30,
                     startClosed: true,
@@ -473,6 +568,12 @@ class WrappedSpeakV1Socket extends SpeakV1Socket {
         }
     }
     connect() {
+        // Ensure socket is ready to connect - if _connectLock is stuck, force reconnect
+        if (this.socket.readyState === this.socket.CLOSED) {
+            // Force a fresh reconnect to ensure _connectLock is reset
+            this.socket._connectLock = false;
+            this.socket._shouldReconnect = true;
+        }
         super.connect();
         this.setupBinaryHandling();
         return this;

package/dist/esm/core/websocket/ws.d.mts

@@ -42,7 +42,6 @@ export declare class ReconnectingWebSocket {
     private _binaryType;
     private _closeCalled;
     private _messageQueue;
-    private _nodeMessageHandler?;
     private readonly _url;
     private readonly _protocols?;
     private readonly _options;