@deepgram/sdk 3.3.5 → 3.4.0

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

@@ -1,16 +1,69 @@
-import { DeepgramClientOptions } from "../lib/types";
+/// <reference types="node" />
+import EventEmitter from "events";
+import type { DeepgramClientOptions, DefaultClientOptions, DefaultNamespaceOptions } from "../lib/types";
+export declare const noop: () => void;
 /**
- * Deepgram Client.
+ * Represents an abstract Deepgram client that provides a base implementation for interacting with the Deepgram API.
  *
- * An isomorphic Javascript client for interacting with the Deepgram API.
- * @see https://developers.deepgram.com
+ * The `AbstractClient` class is responsible for:
+ * - Initializing the Deepgram API key
+ * - Applying default options for the client and namespace
+ * - Providing a namespace for organizing API requests
+ *
+ * Subclasses of `AbstractClient` should implement the specific functionality for interacting with the Deepgram API.
  */
-export declare abstract class AbstractClient {
+export declare abstract class AbstractClient extends EventEmitter {
+    protected factory: Function | undefined;
     protected key: string;
-    protected options: DeepgramClientOptions;
-    protected baseUrl: URL;
-    constructor(key: string, options: DeepgramClientOptions);
-    protected resolveBaseUrl(url: string): URL;
-    protected willProxy(): boolean;
+    protected options: DefaultClientOptions;
+    namespace: string;
+    version: string;
+    baseUrl: string;
+    logger: Function;
+    /**
+     * Constructs a new instance of the DeepgramClient class with the provided options.
+     *
+     * @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.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`.
+     * @param options.namespace - Options specific to a particular namespace within the DeepgramClient instance.
+     */
+    constructor(options: DeepgramClientOptions);
+    /**
+     * Sets the version for the current instance of the Deepgram API and returns the instance.
+     *
+     * @param version - The version to set for the Deepgram API instance. Defaults to "v1" if not provided.
+     * @returns The current instance of the AbstractClient with the updated version.
+     */
+    v(version?: string): this;
+    /**
+     * Gets the namespace options for the current instance of the AbstractClient.
+     * The namespace options include the default options merged with the global options,
+     * and the API key for the current instance.
+     *
+     * @returns The namespace options for the current instance.
+     */
+    get namespaceOptions(): DefaultNamespaceOptions;
+    /**
+     * Generates a URL for an API endpoint with optional query parameters and transcription options.
+     *
+     * @param endpoint - The API endpoint URL, which may contain placeholders for fields.
+     * @param fields - An optional object containing key-value pairs to replace placeholders in the endpoint URL.
+     * @param transcriptionOptions - Optional transcription options to include as query parameters in the URL.
+     * @returns A URL object representing the constructed API request URL.
+     */
+    getRequestUrl(endpoint: string, fields?: {
+        [key: string]: string;
+    }, transcriptionOptions?: {
+        [key: string]: unknown;
+    }): URL;
+    /**
+     * Logs the message.
+     *
+     * For customized logging, `this.logger` can be overridden.
+     */
+    log(kind: string, msg: string, data?: any): void;
 }
 //# sourceMappingURL=AbstractClient.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AbstractClient.d.ts","sourceRoot":"","sources":["../../../src/packages/AbstractClient.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;GAKG;AACH,8BAAsB,cAAc;IAGtB,SAAS,CAAC,GAAG,EAAE,MAAM;IAAE,SAAS,CAAC,OAAO,EAAE,qBAAqB;IAF3E,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC;gBAED,GAAG,EAAE,MAAM,EAAY,OAAO,EAAE,qBAAqB;IA6D3E,SAAS,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM;IAQpC,SAAS,CAAC,SAAS;CAKpB"}
+{"version":3,"file":"AbstractClient.d.ts","sourceRoot":"","sources":["../../../src/packages/AbstractClient.ts"],"names":[],"mappings":";AAAA,OAAO,YAAY,MAAM,QAAQ,CAAC;AAIlC,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,CAAC;IACtB,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;IAiC1C;;;;;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/module/packages/AbstractClient.js

@@ -1,67 +1,116 @@
+import EventEmitter from "events";
 import { DEFAULT_OPTIONS, DEFAULT_URL } from "../lib/constants";
 import { DeepgramError } from "../lib/errors";
-import { applySettingDefaults, stripTrailingSlash } from "../lib/helpers";
+import { appendSearchParams, applyDefaults, convertLegacyOptions } from "../lib/helpers";
+export const noop = () => { };
 /**
- * Deepgram Client.
+ * Represents an abstract Deepgram client that provides a base implementation for interacting with the Deepgram API.
  *
- * An isomorphic Javascript client for interacting with the Deepgram API.
- * @see https://developers.deepgram.com
+ * The `AbstractClient` class is responsible for:
+ * - Initializing the Deepgram API key
+ * - Applying default options for the client and namespace
+ * - Providing a namespace for organizing API requests
+ *
+ * Subclasses of `AbstractClient` should implement the specific functionality for interacting with the Deepgram API.
  */
-export class AbstractClient {
-    constructor(key, options) {
-        var _a, _b;
-        this.key = key;
-        this.options = options;
-        this.key = key;
-        if (!key) {
-            this.key = process.env.DEEPGRAM_API_KEY;
+export class AbstractClient extends EventEmitter {
+    /**
+     * Constructs a new instance of the DeepgramClient class with the provided options.
+     *
+     * @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.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`.
+     * @param options.namespace - Options specific to a particular namespace within the DeepgramClient instance.
+     */
+    constructor(options) {
+        super();
+        this.factory = undefined;
+        this.namespace = "global";
+        this.version = "v1";
+        this.baseUrl = DEFAULT_URL;
+        this.logger = noop;
+        let key;
+        if (typeof options.key === "function") {
+            this.factory = options.key;
+            key = this.factory();
         }
-        if (!this.key) {
-            throw new DeepgramError("A deepgram API key is required");
+        else {
+            key = options.key;
         }
-        this.options = applySettingDefaults(options, DEFAULT_OPTIONS);
-        if (!((_a = this.options.global) === null || _a === void 0 ? void 0 : _a.url)) {
-            throw new DeepgramError(`An API URL is required. It should be set to ${DEFAULT_URL} by default. No idea what happened!`);
+        if (!key) {
+            key = process.env.DEEPGRAM_API_KEY;
         }
-        let baseUrlString = this.options.global.url;
-        let proxyUrlString;
-        /**
-         * Check if the base URL provided is missing a protocol and warn in the console.
-         */
-        if (!baseUrlString.startsWith("http") && !baseUrlString.startsWith("ws")) {
-            console.warn(`The base URL provided does not begin with http, https, ws, or wss and will default to https as standard.`);
+        if (!key) {
+            throw new DeepgramError("A deepgram API key is required.");
         }
+        this.key = key;
+        options = convertLegacyOptions(options);
         /**
-         * Applying proxy to base URL.
+         * Apply default options.
          */
-        if ((_b = this.options.restProxy) === null || _b === void 0 ? void 0 : _b.url) {
-            /**
-             * Prevent client using a real API key when using a proxy configuration.
-             */
-            if (this.key !== "proxy") {
-                throw new DeepgramError(`Do not attempt to pass any other API key than the string "proxy" when making proxied REST requests. Please ensure your proxy application is responsible for writing our API key to the Authorization header.`);
-            }
-            proxyUrlString = this.options.restProxy.url;
-            /**
-             * Check if the proxy URL provided is missing a protocol and warn in the console.
-             */
-            if (!proxyUrlString.startsWith("http") && !proxyUrlString.startsWith("ws")) {
-                console.warn(`The proxy URL provided does not begin with http, https, ws, or wss and will default to https as standard.`);
-            }
-            baseUrlString = proxyUrlString;
-        }
-        this.baseUrl = this.resolveBaseUrl(baseUrlString);
+        this.options = applyDefaults(options, DEFAULT_OPTIONS);
     }
-    resolveBaseUrl(url) {
-        if (!/^https?:\/\//i.test(url)) {
-            url = "https://" + url;
+    /**
+     * Sets the version for the current instance of the Deepgram API and returns the instance.
+     *
+     * @param version - The version to set for the Deepgram API instance. Defaults to "v1" if not provided.
+     * @returns The current instance of the AbstractClient with the updated version.
+     */
+    v(version = "v1") {
+        this.version = version;
+        return this;
+    }
+    /**
+     * Gets the namespace options for the current instance of the AbstractClient.
+     * The namespace options include the default options merged with the global options,
+     * and the API key for the current instance.
+     *
+     * @returns The namespace options for the current instance.
+     */
+    get namespaceOptions() {
+        const defaults = applyDefaults(this.options[this.namespace], this.options.global);
+        return Object.assign(Object.assign({}, defaults), { key: this.key });
+    }
+    /**
+     * Generates a URL for an API endpoint with optional query parameters and transcription options.
+     *
+     * @param endpoint - The API endpoint URL, which may contain placeholders for fields.
+     * @param fields - An optional object containing key-value pairs to replace placeholders in the endpoint URL.
+     * @param transcriptionOptions - Optional transcription options to include as query parameters in the URL.
+     * @returns A URL object representing the constructed API request URL.
+     */
+    getRequestUrl(endpoint, fields = { version: this.version }, transcriptionOptions) {
+        /**
+         * If we pass in fields without a version, set a version.
+         */
+        fields.version = this.version;
+        /**
+         * Version and template the endpoint for input argument..
+         */
+        endpoint = endpoint.replace(/:(\w+)/g, function (_, key) {
+            return fields[key];
+        });
+        /**
+         * Create a URL object.
+         */
+        const url = new URL(endpoint, this.baseUrl);
+        /**
+         * If there are transcription options, append them to the request as URL querystring parameters
+         */
+        if (transcriptionOptions) {
+            appendSearchParams(url.searchParams, transcriptionOptions);
         }
-        return new URL(stripTrailingSlash(url));
+        return url;
     }
-    willProxy() {
-        var _a;
-        const proxyUrl = (_a = this.options.restProxy) === null || _a === void 0 ? void 0 : _a.url;
-        return !!proxyUrl;
+    /**
+     * Logs the message.
+     *
+     * For customized logging, `this.logger` can be overridden.
+     */
+    log(kind, msg, data) {
+        this.logger(kind, msg, data);
     }
 }
 //# sourceMappingURL=AbstractClient.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"AbstractClient.js","sourceRoot":"","sources":["../../../src/packages/AbstractClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAG1E;;;;;GAKG;AACH,MAAM,OAAgB,cAAc;IAGlC,YAAsB,GAAW,EAAY,OAA8B;;QAArD,QAAG,GAAH,GAAG,CAAQ;QAAY,YAAO,GAAP,OAAO,CAAuB;QACzE,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QAEf,IAAI,CAAC,GAAG,EAAE;YACR,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAA0B,CAAC;SACnD;QAED,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;YACb,MAAM,IAAI,aAAa,CAAC,gCAAgC,CAAC,CAAC;SAC3D;QAED,IAAI,CAAC,OAAO,GAAG,oBAAoB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAE9D,IAAI,CAAC,CAAA,MAAA,IAAI,CAAC,OAAO,CAAC,MAAM,0CAAE,GAAG,CAAA,EAAE;YAC7B,MAAM,IAAI,aAAa,CACrB,+CAA+C,WAAW,qCAAqC,CAChG,CAAC;SACH;QAED,IAAI,aAAa,GAAW,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;QACpD,IAAI,cAAsB,CAAC;QAE3B;;WAEG;QACH,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE;YACxE,OAAO,CAAC,IAAI,CACV,0GAA0G,CAC3G,CAAC;SACH;QAED;;WAEG;QACH,IAAI,MAAA,IAAI,CAAC,OAAO,CAAC,SAAS,0CAAE,GAAG,EAAE;YAC/B;;eAEG;YACH,IAAI,IAAI,CAAC,GAAG,KAAK,OAAO,EAAE;gBACxB,MAAM,IAAI,aAAa,CACrB,8MAA8M,CAC/M,CAAC;aACH;YAED,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC;YAE5C;;eAEG;YACH,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE;gBAC1E,OAAO,CAAC,IAAI,CACV,2GAA2G,CAC5G,CAAC;aACH;YAED,aAAa,GAAG,cAAc,CAAC;SAChC;QAED,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;IACpD,CAAC;IAES,cAAc,CAAC,GAAW;QAClC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YAC9B,GAAG,GAAG,UAAU,GAAG,GAAG,CAAC;SACxB;QAED,OAAO,IAAI,GAAG,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1C,CAAC;IAES,SAAS;;QACjB,MAAM,QAAQ,GAAG,MAAA,IAAI,CAAC,OAAO,CAAC,SAAS,0CAAE,GAAG,CAAC;QAE7C,OAAO,CAAC,CAAC,QAAQ,CAAC;IACpB,CAAC;CACF"}
+{"version":3,"file":"AbstractClient.js","sourceRoot":"","sources":["../../../src/packages/AbstractClient.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAQzF,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;AAE7B;;;;;;;;;GASG;AACH,MAAM,OAAgB,cAAe,SAAQ,YAAY;IASvD;;;;;;;;;OASG;IACH,YAAY,OAA8B;QACxC,KAAK,EAAE,CAAC;QAnBA,YAAO,GAAyB,SAAS,CAAC;QAG7C,cAAS,GAAW,QAAQ,CAAC;QAC7B,YAAO,GAAW,IAAI,CAAC;QACvB,YAAO,GAAW,WAAW,CAAC;QAC9B,WAAM,GAAa,IAAI,CAAC;QAe7B,IAAI,GAAG,CAAC;QAER,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,UAAU,EAAE;YACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;YAC3B,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;SACtB;aAAM;YACL,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;SACnB;QAED,IAAI,CAAC,GAAG,EAAE;YACR,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAA0B,CAAC;SAC9C;QAED,IAAI,CAAC,GAAG,EAAE;YACR,MAAM,IAAI,aAAa,CAAC,iCAAiC,CAAC,CAAC;SAC5D;QAED,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QAEf,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAExC;;WAEG;QACH,IAAI,CAAC,OAAO,GAAG,aAAa,CAC1B,OAAO,EACP,eAAe,CAChB,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACI,CAAC,CAAC,UAAkB,IAAI;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,IAAI,gBAAgB;QAClB,MAAM,QAAQ,GAAG,aAAa,CAC3B,IAAI,CAAC,OAAe,CAAC,IAAI,CAAC,SAAS,CAAC,EACrC,IAAI,CAAC,OAAO,CAAC,MAAM,CACpB,CAAC;QAEF,uCACK,QAAQ,KACX,GAAG,EAAE,IAAI,CAAC,GAAG,IACb;IACJ,CAAC;IAED;;;;;;;OAOG;IACI,aAAa,CAClB,QAAgB,EAChB,SAAoC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAC7D,oBAEC;QAED;;WAEG;QACH,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE9B;;WAEG;QACH,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,GAAG;YACrD,OAAO,MAAO,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QAEH;;WAEG;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAkB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAEtD;;WAEG;QACH,IAAI,oBAAoB,EAAE;YACxB,kBAAkB,CAAC,GAAG,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAC;SAC5D;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,IAAY,EAAE,GAAW,EAAE,IAAU;QAC9C,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;CACF"}

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

@@ -0,0 +1,114 @@
+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";
+/**
+ * Represents a constructor for a WebSocket-like object that can be used in the application.
+ * The constructor takes the following parameters:
+ * @param address - The URL or address of the WebSocket server.
+ * @param _ignored - An optional parameter that is ignored.
+ * @param options - An optional object containing headers to be included in the WebSocket connection.
+ * @returns A WebSocket-like object that implements the WebSocketLike interface.
+ */
+interface WebSocketLikeConstructor {
+    new (address: string | URL, _ignored?: any, options?: {
+        headers: Object | undefined;
+    }): WebSocketLike;
+}
+/**
+ * Represents the types of WebSocket-like connections that can be used in the application.
+ * This type is used to provide a common interface for different WebSocket implementations,
+ * such as the native WebSocket API, a WebSocket wrapper library, or a dummy implementation
+ * for testing purposes.
+ */
+declare type WebSocketLike = WebSocket | WSWebSocket | WSWebSocketDummy;
+/**
+ * Represents the types of data that can be sent or received over a WebSocket-like connection.
+ */
+declare type SocketDataLike = string | ArrayBufferLike | Blob;
+/**
+ * Represents an abstract live client that extends the AbstractClient class.
+ * The AbstractLiveClient class provides functionality for connecting, reconnecting, and disconnecting a WebSocket connection, as well as sending data over the connection.
+ * Subclasses of this class are responsible for setting up the connection event handlers.
+ *
+ * @abstract
+ */
+export declare abstract class AbstractLiveClient extends AbstractClient {
+    headers: {
+        [key: string]: string;
+    };
+    transport: WebSocketLikeConstructor | null;
+    conn: WebSocketLike | null;
+    sendBuffer: Function[];
+    constructor(options: DeepgramClientOptions);
+    /**
+     * Connects the socket, unless already connected.
+     *
+     * @protected Can only be called from within the class.
+     */
+    protected connect(transcriptionOptions: LiveSchema, endpoint: string): void;
+    /**
+     * Reconnects the socket using new or existing transcription options.
+     *
+     * @param options - The transcription options to use when reconnecting the socket.
+     */
+    reconnect: (options: LiveSchema) => void;
+    /**
+     * Disconnects the socket from the client.
+     *
+     * @param code A numeric status code to send on disconnect.
+     * @param reason A custom reason for the disconnect.
+     */
+    disconnect(code?: number, reason?: string): void;
+    /**
+     * Returns the current connection state of the WebSocket connection.
+     *
+     * @returns The current connection state of the WebSocket connection.
+     */
+    connectionState(): CONNECTION_STATE;
+    /**
+     * Returns the current ready state of the WebSocket connection.
+     *
+     * @returns The current ready state of the WebSocket connection.
+     */
+    getReadyState(): SOCKET_STATES;
+    /**
+     * Returns `true` is the connection is open.
+     */
+    isConnected(): boolean;
+    /**
+     * Sends data to the Deepgram API via websocket connection
+     * @param data Audio data to send to Deepgram
+     *
+     * Conforms to RFC #146 for Node.js - does not send an empty byte.
+     * @see https://github.com/deepgram/deepgram-python-sdk/issues/146
+     */
+    send(data: SocketDataLike): void;
+    /**
+     * Determines whether the current instance should proxy requests.
+     * @returns {boolean} true if the current instance should proxy requests; otherwise, false
+     */
+    get proxy(): boolean;
+    /**
+     * Sets up the connection event handlers.
+     *
+     * @abstract Requires subclasses to set up context aware event handlers.
+     */
+    abstract setupConnection(): void;
+}
+declare class WSWebSocketDummy {
+    binaryType: string;
+    close: Function;
+    onclose: Function;
+    onerror: Function;
+    onmessage: Function;
+    onopen: Function;
+    readyState: number;
+    send: Function;
+    url: string | URL | null;
+    constructor(address: URL, _protocols: undefined, options: {
+        close: Function;
+    });
+}
+export { AbstractLiveClient as AbstractWsClient };
+//# sourceMappingURL=AbstractLiveClient.d.ts.map

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

@@ -0,0 +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;AAEnD;;;;;;;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;IA+B1C;;;;OAIG;IACH,SAAS,CAAC,OAAO,CAAC,oBAAoB,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAkD3E;;;;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"}

package/dist/module/packages/AbstractLiveClient.js

@@ -0,0 +1,211 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { AbstractClient, noop } from "./AbstractClient";
+import { CONNECTION_STATE, SOCKET_STATES } from "../lib/constants";
+/**
+ * Indicates whether a native WebSocket implementation is available in the current environment.
+ */
+const NATIVE_WEBSOCKET_AVAILABLE = typeof WebSocket !== "undefined";
+/**
+ * Represents an abstract live client that extends the AbstractClient class.
+ * The AbstractLiveClient class provides functionality for connecting, reconnecting, and disconnecting a WebSocket connection, as well as sending data over the connection.
+ * Subclasses of this class are responsible for setting up the connection event handlers.
+ *
+ * @abstract
+ */
+export class AbstractLiveClient extends AbstractClient {
+    constructor(options) {
+        super(options);
+        this.conn = null;
+        this.sendBuffer = [];
+        /**
+         * Reconnects the socket using new or existing transcription options.
+         *
+         * @param options - The transcription options to use when reconnecting the socket.
+         */
+        this.reconnect = noop;
+        const { key, websocket: { options: websocketOptions, client }, } = this.namespaceOptions;
+        if (this.proxy) {
+            this.baseUrl = websocketOptions.proxy.url;
+        }
+        else {
+            this.baseUrl = websocketOptions.url;
+        }
+        if (client) {
+            this.transport = client;
+        }
+        else {
+            this.transport = null;
+        }
+        if (websocketOptions._nodeOnlyHeaders) {
+            this.headers = websocketOptions._nodeOnlyHeaders;
+        }
+        else {
+            this.headers = {};
+        }
+        if (!("Authorization" in this.headers)) {
+            this.headers["Authorization"] = `Token ${key}`; // Add default token
+        }
+    }
+    /**
+     * Connects the socket, unless already connected.
+     *
+     * @protected Can only be called from within the class.
+     */
+    connect(transcriptionOptions, endpoint) {
+        if (this.conn) {
+            return;
+        }
+        this.reconnect = (options = transcriptionOptions) => {
+            this.connect(options, endpoint);
+        };
+        const requestUrl = this.getRequestUrl(endpoint, {}, transcriptionOptions);
+        /**
+         * Custom websocket transport
+         */
+        if (this.transport) {
+            this.conn = new this.transport(requestUrl, undefined, {
+                headers: this.headers,
+            });
+            return;
+        }
+        /**
+         * Native websocket transport (browser)
+         */
+        if (NATIVE_WEBSOCKET_AVAILABLE) {
+            this.conn = new WebSocket(requestUrl, ["token", this.namespaceOptions.key]);
+            this.setupConnection();
+            return;
+        }
+        /**
+         * Dummy websocket
+         */
+        this.conn = new WSWebSocketDummy(requestUrl, undefined, {
+            close: () => {
+                this.conn = null;
+            },
+        });
+        /**
+         * WS package for node environment
+         */
+        import("ws").then(({ default: WS }) => {
+            this.conn = new WS(requestUrl, undefined, {
+                headers: this.headers,
+            });
+            this.setupConnection();
+        });
+    }
+    /**
+     * Disconnects the socket from the client.
+     *
+     * @param code A numeric status code to send on disconnect.
+     * @param reason A custom reason for the disconnect.
+     */
+    disconnect(code, reason) {
+        if (this.conn) {
+            this.conn.onclose = function () { }; // noop
+            if (code) {
+                this.conn.close(code, reason !== null && reason !== void 0 ? reason : "");
+            }
+            else {
+                this.conn.close();
+            }
+            this.conn = null;
+        }
+    }
+    /**
+     * Returns the current connection state of the WebSocket connection.
+     *
+     * @returns The current connection state of the WebSocket connection.
+     */
+    connectionState() {
+        switch (this.conn && this.conn.readyState) {
+            case SOCKET_STATES.connecting:
+                return CONNECTION_STATE.Connecting;
+            case SOCKET_STATES.open:
+                return CONNECTION_STATE.Open;
+            case SOCKET_STATES.closing:
+                return CONNECTION_STATE.Closing;
+            default:
+                return CONNECTION_STATE.Closed;
+        }
+    }
+    /**
+     * Returns the current ready state of the WebSocket connection.
+     *
+     * @returns The current ready state of the WebSocket connection.
+     */
+    getReadyState() {
+        var _a, _b;
+        return (_b = (_a = this.conn) === null || _a === void 0 ? void 0 : _a.readyState) !== null && _b !== void 0 ? _b : SOCKET_STATES.closed;
+    }
+    /**
+     * Returns `true` is the connection is open.
+     */
+    isConnected() {
+        return this.connectionState() === CONNECTION_STATE.Open;
+    }
+    /**
+     * Sends data to the Deepgram API via websocket connection
+     * @param data Audio data to send to Deepgram
+     *
+     * Conforms to RFC #146 for Node.js - does not send an empty byte.
+     * @see https://github.com/deepgram/deepgram-python-sdk/issues/146
+     */
+    send(data) {
+        const callback = () => __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            if (data instanceof Blob) {
+                if (data.size === 0) {
+                    this.log("warn", "skipping `send` for zero-byte blob", data);
+                    return;
+                }
+                data = yield data.arrayBuffer();
+            }
+            if (typeof data !== "string") {
+                if (data.byteLength === 0) {
+                    this.log("warn", "skipping `send` for zero-byte blob", data);
+                    return;
+                }
+            }
+            (_a = this.conn) === null || _a === void 0 ? void 0 : _a.send(data);
+        });
+        if (this.isConnected()) {
+            callback();
+        }
+        else {
+            this.sendBuffer.push(callback);
+        }
+    }
+    /**
+     * Determines whether the current instance should proxy requests.
+     * @returns {boolean} true if the current instance should proxy requests; otherwise, false
+     */
+    get proxy() {
+        var _a;
+        return this.key === "proxy" && !!((_a = this.namespaceOptions.websocket.options.proxy) === null || _a === void 0 ? void 0 : _a.url);
+    }
+}
+class WSWebSocketDummy {
+    constructor(address, _protocols, options) {
+        this.binaryType = "arraybuffer";
+        this.onclose = () => { };
+        this.onerror = () => { };
+        this.onmessage = () => { };
+        this.onopen = () => { };
+        this.readyState = SOCKET_STATES.connecting;
+        this.send = () => { };
+        this.url = null;
+        this.url = address.toString();
+        this.close = options.close;
+    }
+}
+export { AbstractLiveClient as AbstractWsClient };
+//# sourceMappingURL=AbstractLiveClient.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractLiveClient.js","sourceRoot":"","sources":["../../../src/packages/AbstractLiveClient.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AA6CnE;;GAEG;AACH,MAAM,0BAA0B,GAAG,OAAO,SAAS,KAAK,WAAW,CAAC;AAEpE;;;;;;GAMG;AACH,MAAM,OAAgB,kBAAmB,SAAQ,cAAc;IAM7D,YAAY,OAA8B;QACxC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJV,SAAI,GAAyB,IAAI,CAAC;QAClC,eAAU,GAAe,EAAE,CAAC;QAwFnC;;;;WAIG;QACI,cAAS,GAAkC,IAAI,CAAC;QAxFrD,MAAM,EACJ,GAAG,EACH,SAAS,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,GACjD,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAE1B,IAAI,IAAI,CAAC,KAAK,EAAE;YACd,IAAI,CAAC,OAAO,GAAG,gBAAgB,CAAC,KAAM,CAAC,GAAG,CAAC;SAC5C;aAAM;YACL,IAAI,CAAC,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC;SACrC;QAED,IAAI,MAAM,EAAE;YACV,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC;SACzB;aAAM;YACL,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;SACvB;QAED,IAAI,gBAAgB,CAAC,gBAAgB,EAAE;YACrC,IAAI,CAAC,OAAO,GAAG,gBAAgB,CAAC,gBAAgB,CAAC;SAClD;aAAM;YACL,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;SACnB;QAED,IAAI,CAAC,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE;YACtC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,GAAG,EAAE,CAAC,CAAC,oBAAoB;SACrE;IACH,CAAC;IAED;;;;OAIG;IACO,OAAO,CAAC,oBAAgC,EAAE,QAAgB;QAClE,IAAI,IAAI,CAAC,IAAI,EAAE;YACb,OAAO;SACR;QAED,IAAI,CAAC,SAAS,GAAG,CAAC,OAAO,GAAG,oBAAoB,EAAE,EAAE;YAClD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,EAAE,oBAAoB,CAAC,CAAC;QAE1E;;WAEG;QACH,IAAI,IAAI,CAAC,SAAS,EAAE;YAClB,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,EAAE;gBACpD,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAC;YACH,OAAO;SACR;QAED;;WAEG;QACH,IAAI,0BAA0B,EAAE;YAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5E,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,OAAO;SACR;QAED;;WAEG;QACH,IAAI,CAAC,IAAI,GAAG,IAAI,gBAAgB,CAAC,UAAU,EAAE,SAAS,EAAE;YACtD,KAAK,EAAE,GAAG,EAAE;gBACV,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACnB,CAAC;SACF,CAAC,CAAC;QAEH;;WAEG;QACH,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE;YACpC,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE;gBACxC,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAC;YACH,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC;IASD;;;;;OAKG;IACI,UAAU,CAAC,IAAa,EAAE,MAAe;QAC9C,IAAI,IAAI,CAAC,IAAI,EAAE;YACb,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,cAAa,CAAC,CAAC,CAAC,OAAO;YAC3C,IAAI,IAAI,EAAE;gBACR,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC,CAAC;aACrC;iBAAM;gBACL,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;aACnB;YACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;SAClB;IACH,CAAC;IAED;;;;OAIG;IACI,eAAe;QACpB,QAAQ,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;YACzC,KAAK,aAAa,CAAC,UAAU;gBAC3B,OAAO,gBAAgB,CAAC,UAAU,CAAC;YACrC,KAAK,aAAa,CAAC,IAAI;gBACrB,OAAO,gBAAgB,CAAC,IAAI,CAAC;YAC/B,KAAK,aAAa,CAAC,OAAO;gBACxB,OAAO,gBAAgB,CAAC,OAAO,CAAC;YAClC;gBACE,OAAO,gBAAgB,CAAC,MAAM,CAAC;SAClC;IACH,CAAC;IAED;;;;OAIG;IACI,aAAa;;QAClB,OAAO,MAAA,MAAA,IAAI,CAAC,IAAI,0CAAE,UAAU,mCAAI,aAAa,CAAC,MAAM,CAAC;IACvD,CAAC;IAED;;OAEG;IACI,WAAW;QAChB,OAAO,IAAI,CAAC,eAAe,EAAE,KAAK,gBAAgB,CAAC,IAAI,CAAC;IAC1D,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,IAAoB;QACvB,MAAM,QAAQ,GAAG,GAAS,EAAE;;YAC1B,IAAI,IAAI,YAAY,IAAI,EAAE;gBACxB,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,EAAE;oBACnB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,oCAAoC,EAAE,IAAI,CAAC,CAAC;oBAE7D,OAAO;iBACR;gBAED,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;aACjC;YAED,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;gBAC5B,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC,EAAE;oBACzB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,oCAAoC,EAAE,IAAI,CAAC,CAAC;oBAE7D,OAAO;iBACR;aACF;YAED,MAAA,IAAI,CAAC,IAAI,0CAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC,CAAA,CAAC;QAEF,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE;YACtB,QAAQ,EAAE,CAAC;SACZ;aAAM;YACL,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;SAChC;IACH,CAAC;IAED;;;OAGG;IACH,IAAI,KAAK;;QACP,OAAO,IAAI,CAAC,GAAG,KAAK,OAAO,IAAI,CAAC,CAAC,CAAA,MAAA,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,0CAAE,GAAG,CAAA,CAAC;IACtF,CAAC;CAQF;AAED,MAAM,gBAAgB;IAWpB,YAAY,OAAY,EAAE,UAAqB,EAAE,OAA4B;QAV7E,eAAU,GAAW,aAAa,CAAC;QAEnC,YAAO,GAAa,GAAG,EAAE,GAAE,CAAC,CAAC;QAC7B,YAAO,GAAa,GAAG,EAAE,GAAE,CAAC,CAAC;QAC7B,cAAS,GAAa,GAAG,EAAE,GAAE,CAAC,CAAC;QAC/B,WAAM,GAAa,GAAG,EAAE,GAAE,CAAC,CAAC;QAC5B,eAAU,GAAW,aAAa,CAAC,UAAU,CAAC;QAC9C,SAAI,GAAa,GAAG,EAAE,GAAE,CAAC,CAAC;QAC1B,QAAG,GAAwB,IAAI,CAAC;QAG9B,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC7B,CAAC;CACF;AAED,OAAO,EAAE,kBAAkB,IAAI,gBAAgB,EAAE,CAAC"}