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

package/dist/cjs/version.js

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

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = 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/esm/CustomClient.mjs

@@ -797,6 +797,13 @@ class WrappedSpeakV1Client extends SpeakV1Client {
 class WrappedSpeakV1Socket extends SpeakV1Socket {
     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/esm/api/resources/agent/resources/v1/client/Client.d.mts

@@ -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/esm/api/resources/agent/resources/v1/client/Client.mjs

@@ -25,12 +25,12 @@ export 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 = mergeHeaders(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/esm/api/resources/agent/resources/v1/types/AgentV1Settings.d.mts

@@ -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/esm/api/resources/agent/resources/v1/types/AgentV1UpdateSpeak.d.mts

@@ -1,18 +1,9 @@
+import type * as Deepgram from "../../../../../index.mjs";
 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/esm/api/resources/listen/resources/v1/client/Client.d.mts

@@ -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/esm/api/resources/listen/resources/v1/client/Client.mjs

@@ -25,7 +25,7 @@ export 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,
@@ -60,7 +60,7 @@ export 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/esm/api/resources/listen/resources/v2/client/Client.d.mts

@@ -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/esm/api/resources/listen/resources/v2/client/Client.mjs

@@ -20,7 +20,7 @@ export 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,
@@ -36,7 +36,7 @@ export 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/esm/api/resources/speak/resources/v1/client/Client.d.mts

@@ -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/esm/api/resources/speak/resources/v1/client/Client.mjs

@@ -25,7 +25,7 @@ export 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,
@@ -36,7 +36,7 @@ export 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/esm/api/types/OpenAiSpeakProvider.d.mts

@@ -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/esm/api/types/OpenAiSpeakProvider.mjs

@@ -0,0 +1,18 @@
+// This file was auto-generated by Fern from our API Definition.
+export 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 || (OpenAiSpeakProvider = {}));

package/dist/esm/api/types/OpenAiThinkProvider.d.mts

@@ -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/esm/api/types/OpenAiThinkProvider.mjs

@@ -0,0 +1,15 @@
+// This file was auto-generated by Fern from our API Definition.
+export 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 || (OpenAiThinkProvider = {}));

package/dist/esm/api/types/SpeakSettingsV1Provider.d.mts

@@ -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/esm/api/types/ThinkSettingsV1.d.mts

@@ -1,6 +1,6 @@
+import type * as Deepgram from "../index.mjs";
 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/esm/api/types/ThinkSettingsV1Provider.d.mts

@@ -0,0 +1,19 @@
+import type * as Deepgram from "../index.mjs";
+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/esm/api/types/ThinkSettingsV1Provider.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/index.d.mts

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

package/dist/esm/api/types/index.mjs

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

package/dist/esm/index.d.mts

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

package/dist/esm/index.mjs

@@ -1,4 +1,10 @@
+// Export everything under Deepgram namespace for backwards compatibility
 export * as Deepgram from "./api/index.mjs";
+// 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;
+export * from "./api/types/index.mjs";
+export * from "./api/resources/index.mjs";
 export { DeepgramClient as DefaultDeepgramClient } from "./Client.mjs";
 export { CustomDeepgramClient as DeepgramClient } from "./CustomClient.mjs";
 export { DeepgramEnvironment } from "./environments.mjs";

package/dist/esm/middleware/adapters/express.d.mts

@@ -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.mjs";
+/**
+ * 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;
+};

package/dist/esm/middleware/adapters/express.mjs

@@ -0,0 +1,136 @@
+/**
+ * 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.
+ */
+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 { ProxyHandler } from "../core/ProxyHandler.mjs";
+import { TokenManager } from "../core/TokenManager.mjs";
+import { WebSocketProxy } from "../core/WebSocketProxy.mjs";
+/**
+ * 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 function createDeepgramProxy(options) {
+    const proxyHandler = new ProxyHandler(options);
+    const tokenManager = options.enableTokenAuth
+        ? new TokenManager(options)
+        : null;
+    return (req, res, next) => __awaiter(this, void 0, void 0, function* () {
+        try {
+            // Handle token generation requests
+            if (options.enableTokenAuth &&
+                req.url === "/token" &&
+                req.method === "GET") {
+                yield tokenManager.handleTokenRequest(req, res);
+                return;
+            }
+            // Handle all other requests (proxy to Deepgram)
+            yield proxyHandler.handleRequest(req, res);
+        }
+        catch (error) {
+            next(error instanceof Error ? error : new Error(String(error)));
+        }
+    });
+}
+/**
+ * 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 function createWebSocketHandler(options) {
+    const wsProxy = new WebSocketProxy(options);
+    return (req, socket, head) => {
+        wsProxy.handleUpgrade(req, socket, head);
+    };
+}
+/**
+ * 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 function createDeepgramMiddleware(options) {
+    const middleware = createDeepgramProxy(options);
+    const upgradeHandler = createWebSocketHandler(options);
+    return {
+        middleware,
+        upgradeHandler,
+        server: (httpServer) => {
+            httpServer.on("upgrade", upgradeHandler);
+        },
+    };
+}