@deepgram/sdk 5.0.0-beta.3 → 5.0.0-beta.4

package/README.md

@@ -214,9 +214,9 @@ const deepgramClient = new DeepgramClient({
 });
 ```
 
-#### Proxy requests in the browser
+#### Proxy requests in the browser (Required)
 
-This SDK now works in the browser. If you'd like to make REST-based requests (pre-recorded transcription, on-premise, and management requests), then you'll need to use a proxy as we do not support custom CORS origins on our API. To set up your proxy, you configure the SDK like so:
+Due to CORS header restrictions in the Deepgram API, you must use a proxy server when making REST API calls from browsers. To set up your proxy, you configure the SDK like so:
 
 ```js
 import { DeepgramClient } from "@deepgram/sdk";
@@ -233,6 +233,8 @@ Your proxy service should replace the Authorization header with `Authorization:
 
 Check out our example Node-based proxy here: [Deepgram Node Proxy](https://github.com/deepgram-devs/deepgram-node-proxy).
 
+**Why is a proxy required?** The SDK sends custom headers (`X-Fern-Runtime-Version`, etc.) that are not whitelisted by the Deepgram API's CORS configuration, causing preflight requests to fail. A proxy bypasses this limitation while also keeping your API key secure.
+
 #### Set custom headers for fetch
 
 Useful for many things.
@@ -258,9 +260,11 @@ The SDK works in modern browsers with some considerations:
 
 ### REST API Features (Proxy Required)
 
-- **Pre-recorded Transcription**: ⚠️ Requires proxy due to CORS
-- **Text Intelligence**: ⚠️ Requires proxy due to CORS
-- **Management APIs**: ⚠️ Requires proxy due to CORS
+- **Pre-recorded Transcription**: ⚠️ Requires proxy due to CORS header restrictions
+- **Text Intelligence**: ⚠️ Requires proxy due to CORS header restrictions
+- **Management APIs**: ⚠️ Requires proxy due to CORS header restrictions
+
+> **Important:** The SDK sends custom headers that are not allowed by the Deepgram API's CORS policy. You must use a proxy server (see setup instructions above) to make REST API calls from browsers.
 
 ### Setup Options
 
@@ -328,7 +332,7 @@ const deepgramClient = new DeepgramClient({ apiKey: "YOUR_API_KEY" });
 
 #### Option 4: Proxy for REST APIs
 
-See [proxy requests in the browser](#proxy-requests-in-the-browser) for REST API access.
+See [proxy requests in the browser](#proxy-requests-in-the-browser-optional) to hide your API key from client-side code.
 
 ## Transcription
 
@@ -984,17 +988,54 @@ project, let us know! You can either:
 
 ## Request And Response Types
 
-The SDK exports all request and response types as TypeScript interfaces. Simply import them with the
-following namespace:
+The SDK exports all request and response types as TypeScript interfaces. You can import them in two ways:
+
+### Direct Import (Recommended)
+
+Import types directly for better IDE autocomplete and discoverability:
+
+```typescript
+import {
+  ListenV1Response,
+  SpeakV1Response,
+  ReadV1Response,
+  GetProjectV1Response,
+  CreateKeyV1Response,
+  UsageV1Response,
+} from "@deepgram/sdk";
+
+// Use types directly
+async function handleTranscription(response: ListenV1Response) {
+  console.log(response.metadata);
+  console.log(response.results);
+}
+
+async function handleProject(project: GetProjectV1Response) {
+  console.log(project.projectId);
+  console.log(project.name);
+}
+```
+
+### Namespace Import
+
+Alternatively, import types via the `Deepgram` namespace:
 
 ```typescript
 import { Deepgram } from "@deepgram/sdk";
 
+// Use types via namespace
+async function handleTranscription(response: Deepgram.ListenV1Response) {
+  console.log(response.metadata);
+  console.log(response.results);
+}
+
 const request: Deepgram.GrantV1Request = {
-    ...
+  // ...
 };
 ```
 
+Both import styles refer to the same types and can be used interchangeably or mixed in the same file.
+
 ## Exception Handling
 
 When the API returns a non-success status code (4xx or 5xx response), a subclass of the following error

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "",
-        "X-Fern-SDK-Version": "0.0.283",
-        "User-Agent": "/0.0.283",
+        "X-Fern-SDK-Version": "0.0.320",
+        "User-Agent": "/0.0.320",
         "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

@@ -834,6 +834,13 @@ class WrappedSpeakV1Client extends Client_js_8.V1Client {
 class WrappedSpeakV1Socket extends Socket_js_4.V1Socket {
     constructor(args) {
         super(args);
+        // CRITICAL: Remove the autogenerated handleMessage that tries to parse EVERYTHING as JSON!
+        // The autogenerated Socket class assumes all messages are text/JSON, but TTS sends binary audio.
+        // We must remove that broken handler immediately after the parent constructor runs.
+        const socketAny = this;
+        if (socketAny.handleMessage) {
+            this.socket.removeEventListener("message", socketAny.handleMessage);
+        }
         this.setupBinaryHandling();
     }
     setupBinaryHandling() {

package/dist/cjs/api/resources/agent/resources/v1/client/Client.d.ts

@@ -6,6 +6,8 @@ export declare namespace V1Client {
     type Options = BaseClientOptions;
     interface ConnectArgs {
         Authorization: string;
+        /** Additional query parameters to send with the websocket connect request. */
+        queryParams?: Record<string, unknown>;
         /** Arbitrary headers to send with the websocket connect request. */
         headers?: Record<string, string>;
         /** Enable debug mode on the websocket. Defaults to false. */

package/dist/cjs/api/resources/agent/resources/v1/client/Client.js

@@ -61,12 +61,12 @@ class V1Client {
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b;
-            const { headers, debug, reconnectAttempts } = args;
+            const { queryParams, headers, debug, reconnectAttempts } = args;
             const _headers = (0, headers_js_1.mergeHeaders)((0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: args.Authorization }), headers);
             const socket = new core.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).agent, "/v1/agent/converse"),
                 protocols: [],
-                queryParameters: {},
+                queryParameters: queryParams !== null && queryParams !== void 0 ? queryParams : {},
                 headers: _headers,
                 options: { debug: debug !== null && debug !== void 0 ? debug : false, maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30 },
             });

package/dist/cjs/api/resources/agent/resources/v1/types/AgentV1Settings.d.ts

@@ -122,37 +122,7 @@ export declare namespace AgentV1Settings {
         interface Listen {
             provider?: Deepgram.agent.AgentV1SettingsAgentListenProvider;
         }
-        type Think = {
-            provider: Record<string, unknown>;
-            endpoint?: {
-                url?: string | undefined;
-                headers?: Record<string, string> | undefined;
-            } | undefined;
-            functions?: Record<string, unknown>[] | undefined;
-            prompt?: string | undefined;
-            context_length?: ("max" | number) | undefined;
-        } | {
-            provider: Record<string, unknown>;
-            endpoint?: {
-                url?: string | undefined;
-                headers?: Record<string, string> | undefined;
-            } | undefined;
-            functions?: Record<string, unknown>[] | undefined;
-            prompt?: string | undefined;
-            context_length?: ("max" | number) | undefined;
-        }[];
-        type Speak = {
-            provider: Record<string, unknown>;
-            endpoint?: {
-                url?: string | undefined;
-                headers?: Record<string, string> | undefined;
-            } | undefined;
-        } | {
-            provider: Record<string, unknown>;
-            endpoint?: {
-                url?: string | undefined;
-                headers?: Record<string, string> | undefined;
-            } | undefined;
-        }[];
+        type Think = Deepgram.ThinkSettingsV1 | Deepgram.ThinkSettingsV1[];
+        type Speak = Deepgram.SpeakSettingsV1 | Deepgram.SpeakSettingsV1[];
     }
 }

package/dist/cjs/api/resources/agent/resources/v1/types/AgentV1UpdateSpeak.d.ts

@@ -1,18 +1,9 @@
+import type * as Deepgram from "../../../../../index.js";
 export interface AgentV1UpdateSpeak {
     /** Message type identifier for updating the speak model */
     type: "UpdateSpeak";
     speak: AgentV1UpdateSpeak.Speak;
 }
 export declare namespace AgentV1UpdateSpeak {
-    interface Speak {
-        /** TTS provider configuration (Deepgram, ElevenLabs, Cartesia, OpenAI, or AWS Polly) */
-        provider: Record<string, unknown>;
-        endpoint?: Speak.Endpoint;
-    }
-    namespace Speak {
-        interface Endpoint {
-            url?: string;
-            headers?: Record<string, string>;
-        }
-    }
+    type Speak = Deepgram.SpeakSettingsV1 | Deepgram.SpeakSettingsV1[];
 }

package/dist/cjs/api/resources/listen/resources/v1/client/Client.d.ts

@@ -34,6 +34,8 @@ export declare namespace V1Client {
         vad_events?: string;
         version?: string;
         Authorization: string;
+        /** Additional query parameters to send with the websocket connect request. */
+        queryParams?: Record<string, unknown>;
         /** Arbitrary headers to send with the websocket connect request. */
         headers?: Record<string, string>;
         /** Enable debug mode on the websocket. Defaults to false. */

package/dist/cjs/api/resources/listen/resources/v1/client/Client.js

@@ -61,7 +61,7 @@ class V1Client {
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b;
-            const { callback, callback_method: callbackMethod, channels, detect_entities: detectEntities, 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;
+            const { callback, callback_method: callbackMethod, channels, detect_entities: detectEntities, 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, queryParams, headers, debug, reconnectAttempts, } = args;
             const _queryParams = {
                 callback,
                 callback_method: callbackMethod,
@@ -96,7 +96,7 @@ class V1Client {
             const socket = new core.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: [],
-                queryParameters: _queryParams,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), queryParams),
                 headers: _headers,
                 options: { debug: debug !== null && debug !== void 0 ? debug : false, maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30 },
             });

package/dist/cjs/api/resources/listen/resources/v2/client/Client.d.ts

@@ -14,6 +14,8 @@ export declare namespace V2Client {
         mip_opt_out?: string;
         tag?: string;
         Authorization: string;
+        /** Additional query parameters to send with the websocket connect request. */
+        queryParams?: Record<string, unknown>;
         /** Arbitrary headers to send with the websocket connect request. */
         headers?: Record<string, string>;
         /** Enable debug mode on the websocket. Defaults to false. */

package/dist/cjs/api/resources/listen/resources/v2/client/Client.js

@@ -56,7 +56,7 @@ class V2Client {
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b;
-            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 { model, encoding, sample_rate: sampleRate, eager_eot_threshold: eagerEotThreshold, eot_threshold: eotThreshold, eot_timeout_ms: eotTimeoutMs, keyterm, mip_opt_out: mipOptOut, tag, queryParams, headers, debug, reconnectAttempts, } = args;
             const _queryParams = {
                 model,
                 encoding,
@@ -72,7 +72,7 @@ class V2Client {
             const socket = new core.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, "/v2/listen"),
                 protocols: [],
-                queryParameters: _queryParams,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), queryParams),
                 headers: _headers,
                 options: { debug: debug !== null && debug !== void 0 ? debug : false, maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30 },
             });

package/dist/cjs/api/resources/speak/resources/v1/client/Client.d.ts

@@ -10,6 +10,8 @@ export declare namespace V1Client {
         model?: string;
         sample_rate?: string;
         Authorization: string;
+        /** Additional query parameters to send with the websocket connect request. */
+        queryParams?: Record<string, unknown>;
         /** Arbitrary headers to send with the websocket connect request. */
         headers?: Record<string, string>;
         /** Enable debug mode on the websocket. Defaults to false. */

package/dist/cjs/api/resources/speak/resources/v1/client/Client.js

@@ -61,7 +61,7 @@ class V1Client {
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b;
-            const { encoding, mip_opt_out: mipOptOut, model, sample_rate: sampleRate, headers, debug, reconnectAttempts, } = args;
+            const { encoding, mip_opt_out: mipOptOut, model, sample_rate: sampleRate, queryParams, headers, debug, reconnectAttempts, } = args;
             const _queryParams = {
                 encoding,
                 mip_opt_out: mipOptOut,
@@ -72,7 +72,7 @@ class V1Client {
             const socket = new core.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: [],
-                queryParameters: _queryParams,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), queryParams),
                 headers: _headers,
                 options: { debug: debug !== null && debug !== void 0 ? debug : false, maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30 },
             });

package/dist/cjs/api/types/OpenAiSpeakProvider.d.ts

@@ -0,0 +1,27 @@
+export interface OpenAiSpeakProvider {
+    type: "open_ai";
+    /** The REST API version for the OpenAI text-to-speech API */
+    version?: "v1";
+    /** OpenAI TTS model */
+    model: OpenAiSpeakProvider.Model;
+    /** OpenAI voice */
+    voice: OpenAiSpeakProvider.Voice;
+}
+export declare namespace OpenAiSpeakProvider {
+    /** OpenAI TTS model */
+    const Model: {
+        readonly Tts1: "tts-1";
+        readonly Tts1Hd: "tts-1-hd";
+    };
+    type Model = (typeof Model)[keyof typeof Model] | string;
+    /** OpenAI voice */
+    const Voice: {
+        readonly Alloy: "alloy";
+        readonly Echo: "echo";
+        readonly Fable: "fable";
+        readonly Onyx: "onyx";
+        readonly Nova: "nova";
+        readonly Shimmer: "shimmer";
+    };
+    type Voice = (typeof Voice)[keyof typeof Voice] | string;
+}

package/dist/cjs/api/types/OpenAiSpeakProvider.js

@@ -0,0 +1,21 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAiSpeakProvider = void 0;
+var OpenAiSpeakProvider;
+(function (OpenAiSpeakProvider) {
+    /** OpenAI TTS model */
+    OpenAiSpeakProvider.Model = {
+        Tts1: "tts-1",
+        Tts1Hd: "tts-1-hd",
+    };
+    /** OpenAI voice */
+    OpenAiSpeakProvider.Voice = {
+        Alloy: "alloy",
+        Echo: "echo",
+        Fable: "fable",
+        Onyx: "onyx",
+        Nova: "nova",
+        Shimmer: "shimmer",
+    };
+})(OpenAiSpeakProvider || (exports.OpenAiSpeakProvider = OpenAiSpeakProvider = {}));

package/dist/cjs/api/types/OpenAiThinkProvider.d.ts

@@ -0,0 +1,23 @@
+export interface OpenAiThinkProvider {
+    type: "open_ai";
+    /** The REST API version for the OpenAI chat completions API */
+    version?: "v1";
+    /** OpenAI model to use */
+    model: OpenAiThinkProvider.Model;
+    /** OpenAI temperature (0-2) */
+    temperature?: number;
+}
+export declare namespace OpenAiThinkProvider {
+    /** OpenAI model to use */
+    const Model: {
+        readonly Gpt5: "gpt-5";
+        readonly Gpt5Mini: "gpt-5-mini";
+        readonly Gpt5Nano: "gpt-5-nano";
+        readonly Gpt41: "gpt-4.1";
+        readonly Gpt41Mini: "gpt-4.1-mini";
+        readonly Gpt41Nano: "gpt-4.1-nano";
+        readonly Gpt4O: "gpt-4o";
+        readonly Gpt4OMini: "gpt-4o-mini";
+    };
+    type Model = (typeof Model)[keyof typeof Model] | string;
+}

package/dist/cjs/api/types/OpenAiThinkProvider.js

@@ -0,0 +1,18 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAiThinkProvider = void 0;
+var OpenAiThinkProvider;
+(function (OpenAiThinkProvider) {
+    /** OpenAI model to use */
+    OpenAiThinkProvider.Model = {
+        Gpt5: "gpt-5",
+        Gpt5Mini: "gpt-5-mini",
+        Gpt5Nano: "gpt-5-nano",
+        Gpt41: "gpt-4.1",
+        Gpt41Mini: "gpt-4.1-mini",
+        Gpt41Nano: "gpt-4.1-nano",
+        Gpt4O: "gpt-4o",
+        Gpt4OMini: "gpt-4o-mini",
+    };
+})(OpenAiThinkProvider || (exports.OpenAiThinkProvider = OpenAiThinkProvider = {}));

package/dist/cjs/api/types/SpeakSettingsV1Provider.d.ts

@@ -10,7 +10,7 @@ export declare namespace SpeakSettingsV1Provider {
     interface Cartesia extends Deepgram.Cartesia {
         type: "cartesia";
     }
-    interface OpenAi extends Deepgram.OpenAi {
+    interface OpenAi extends Deepgram.OpenAiSpeakProvider {
         type: "open_ai";
     }
     interface AwsPolly extends Deepgram.AwsPollySpeakProvider {

package/dist/cjs/api/types/ThinkSettingsV1.d.ts

@@ -1,6 +1,6 @@
+import type * as Deepgram from "../index.js";
 export interface ThinkSettingsV1 {
-    /** Think provider configuration (OpenAI, AWS Bedrock, Anthropic, Google, or Groq) */
-    provider: Record<string, unknown>;
+    provider: Deepgram.ThinkSettingsV1Provider;
     /** Optional for non-Deepgram LLM providers. When present, must include url field and headers object */
     endpoint?: ThinkSettingsV1.Endpoint;
     functions?: ThinkSettingsV1.Functions.Item[];

package/dist/cjs/api/types/ThinkSettingsV1Provider.d.ts

@@ -0,0 +1,19 @@
+import type * as Deepgram from "../index.js";
+export type ThinkSettingsV1Provider = Deepgram.ThinkSettingsV1Provider.OpenAi | Deepgram.ThinkSettingsV1Provider.AwsBedrock | Deepgram.ThinkSettingsV1Provider.Anthropic | Deepgram.ThinkSettingsV1Provider.Google | Deepgram.ThinkSettingsV1Provider.Groq;
+export declare namespace ThinkSettingsV1Provider {
+    interface OpenAi extends Deepgram.OpenAiThinkProvider {
+        type: "open_ai";
+    }
+    interface AwsBedrock extends Deepgram.AwsBedrockThinkProvider {
+        type: "aws_bedrock";
+    }
+    interface Anthropic extends Deepgram.Anthropic {
+        type: "anthropic";
+    }
+    interface Google extends Deepgram.Google {
+        type: "google";
+    }
+    interface Groq extends Deepgram.Groq {
+        type: "groq";
+    }
+}

package/dist/cjs/api/types/ThinkSettingsV1Provider.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/index.d.ts

@@ -88,7 +88,8 @@ export * from "./ListProjectMembersV1Response.js";
 export * from "./ListProjectPurchasesV1Response.js";
 export * from "./ListProjectRequestsV1Response.js";
 export * from "./ListProjectsV1Response.js";
-export * from "./OpenAi.js";
+export * from "./OpenAiSpeakProvider.js";
+export * from "./OpenAiThinkProvider.js";
 export * from "./ProjectRequestResponse.js";
 export * from "./ReadV1Request.js";
 export * from "./ReadV1RequestText.js";
@@ -108,6 +109,7 @@ export * from "./SpeakV1Model.js";
 export * from "./SpeakV1Response.js";
 export * from "./SpeakV1SampleRate.js";
 export * from "./ThinkSettingsV1.js";
+export * from "./ThinkSettingsV1Provider.js";
 export * from "./UpdateProjectMemberScopesV1Response.js";
 export * from "./UpdateProjectV1Response.js";
 export * from "./UsageBreakdownV1Response.js";

package/dist/cjs/api/types/index.js

@@ -104,7 +104,8 @@ __exportStar(require("./ListProjectMembersV1Response.js"), exports);
 __exportStar(require("./ListProjectPurchasesV1Response.js"), exports);
 __exportStar(require("./ListProjectRequestsV1Response.js"), exports);
 __exportStar(require("./ListProjectsV1Response.js"), exports);
-__exportStar(require("./OpenAi.js"), exports);
+__exportStar(require("./OpenAiSpeakProvider.js"), exports);
+__exportStar(require("./OpenAiThinkProvider.js"), exports);
 __exportStar(require("./ProjectRequestResponse.js"), exports);
 __exportStar(require("./ReadV1Request.js"), exports);
 __exportStar(require("./ReadV1RequestText.js"), exports);
@@ -124,6 +125,7 @@ __exportStar(require("./SpeakV1Model.js"), exports);
 __exportStar(require("./SpeakV1Response.js"), exports);
 __exportStar(require("./SpeakV1SampleRate.js"), exports);
 __exportStar(require("./ThinkSettingsV1.js"), exports);
+__exportStar(require("./ThinkSettingsV1Provider.js"), exports);
 __exportStar(require("./UpdateProjectMemberScopesV1Response.js"), exports);
 __exportStar(require("./UpdateProjectV1Response.js"), exports);
 __exportStar(require("./UsageBreakdownV1Response.js"), exports);

package/dist/cjs/index.d.ts

@@ -1,4 +1,6 @@
 export * as Deepgram from "./api/index.js";
+export * from "./api/types/index.js";
+export * from "./api/resources/index.js";
 export type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
 export { DeepgramClient as DefaultDeepgramClient } from "./Client.js";
 export { CustomDeepgramClient as DeepgramClient } from "./CustomClient.js";

package/dist/cjs/index.js

@@ -37,7 +37,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DeepgramTimeoutError = exports.DeepgramError = exports.DeepgramEnvironment = exports.DeepgramClient = exports.DefaultDeepgramClient = exports.Deepgram = void 0;
+// Export everything under Deepgram namespace for backwards compatibility
 exports.Deepgram = __importStar(require("./api/index.js"));
+// ALSO export all types directly for better discoverability and IDE autocomplete
+// This allows: import { ListenV1Response } from "@deepgram/sdk"
+// While still supporting: import { Deepgram } from "@deepgram/sdk"; type Response = Deepgram.ListenV1Response;
+__exportStar(require("./api/types/index.js"), exports);
+__exportStar(require("./api/resources/index.js"), exports);
 var Client_js_1 = require("./Client.js");
 Object.defineProperty(exports, "DefaultDeepgramClient", { enumerable: true, get: function () { return Client_js_1.DeepgramClient; } });
 var CustomClient_js_1 = require("./CustomClient.js");

package/dist/cjs/middleware/adapters/express.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Express middleware for proxying Deepgram API requests.
+ *
+ * @packageDocumentation
+ *
+ * **Peer Dependencies Required:**
+ * ```bash
+ * npm install express
+ * # or
+ * pnpm add express
+ * ```
+ *
+ * This module provides Express-compatible middleware for proxying requests to the
+ * Deepgram API, including REST endpoints and WebSocket connections.
+ */
+import type { IncomingMessage, Server, ServerResponse } from "node:http";
+import type { Duplex } from "node:stream";
+import type { MiddlewareOptions } from "../core/types.js";
+/**
+ * Express middleware type
+ */
+export type ExpressMiddleware = (req: IncomingMessage, res: ServerResponse, next: (error?: Error) => void) => void | Promise<void>;
+/**
+ * WebSocket upgrade handler type
+ */
+export type UpgradeHandler = (req: IncomingMessage, socket: Duplex, head: Buffer) => void;
+/**
+ * Create Express middleware for proxying Deepgram API requests
+ *
+ * @param options - Middleware configuration options
+ * @returns Express middleware function
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createDeepgramProxy, createWebSocketHandler } from '@deepgram/sdk';
+ *
+ * const app = express();
+ * const proxyOptions = {
+ *   apiKey: process.env.DEEPGRAM_API_KEY!,
+ *   enableTokenAuth: true
+ * };
+ *
+ * // REST API proxy
+ * app.use('/api/deepgram', createDeepgramProxy(proxyOptions));
+ *
+ * // WebSocket upgrade handler
+ * const server = app.listen(3000);
+ * server.on('upgrade', createWebSocketHandler(proxyOptions));
+ * ```
+ */
+export declare function createDeepgramProxy(options: MiddlewareOptions): ExpressMiddleware;
+/**
+ * Create WebSocket upgrade handler for Express
+ *
+ * This must be registered on the HTTP server, not the Express app.
+ *
+ * @param options - Middleware configuration options
+ * @returns Upgrade handler function
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createWebSocketHandler } from '@deepgram/sdk';
+ *
+ * const app = express();
+ * const server = app.listen(3000);
+ *
+ * // Register WebSocket handler on the server
+ * server.on('upgrade', createWebSocketHandler({
+ *   apiKey: process.env.DEEPGRAM_API_KEY!
+ * }));
+ * ```
+ */
+export declare function createWebSocketHandler(options: MiddlewareOptions): UpgradeHandler;
+/**
+ * Combined helper that returns both middleware and upgrade handler
+ *
+ * @param options - Middleware configuration options
+ * @returns Object with middleware and upgrade handler
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createDeepgramMiddleware } from '@deepgram/sdk';
+ *
+ * const app = express();
+ * const { middleware, upgradeHandler } = createDeepgramMiddleware({
+ *   apiKey: process.env.DEEPGRAM_API_KEY!,
+ *   enableTokenAuth: true
+ * });
+ *
+ * app.use('/api/deepgram', middleware);
+ *
+ * const server = app.listen(3000);
+ * server.on('upgrade', upgradeHandler);
+ * ```
+ */
+export declare function createDeepgramMiddleware(options: MiddlewareOptions): {
+    middleware: ExpressMiddleware;
+    upgradeHandler: UpgradeHandler;
+    server: (httpServer: Server) => void;
+};