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

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

@@ -15,15 +15,21 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./AgentThinkModelsV1Response.js"), exports);
+__exportStar(require("./Anthropic.js"), exports);
+__exportStar(require("./AwsBedrockThinkProvider.js"), exports);
+__exportStar(require("./AwsPollySpeakProvider.js"), exports);
 __exportStar(require("./BillingBreakdownV1Response.js"), exports);
+__exportStar(require("./Cartesia.js"), exports);
 __exportStar(require("./CreateKeyV1RequestOne.js"), exports);
 __exportStar(require("./CreateKeyV1Response.js"), exports);
 __exportStar(require("./CreateProjectDistributionCredentialsV1Response.js"), exports);
 __exportStar(require("./CreateProjectInviteV1Response.js"), exports);
+__exportStar(require("./Deepgram.js"), exports);
 __exportStar(require("./DeleteProjectInviteV1Response.js"), exports);
 __exportStar(require("./DeleteProjectKeyV1Response.js"), exports);
 __exportStar(require("./DeleteProjectMemberV1Response.js"), exports);
 __exportStar(require("./DeleteProjectV1Response.js"), exports);
+__exportStar(require("./ElevenLabsSpeakProvider.js"), exports);
 __exportStar(require("./ErrorResponse.js"), exports);
 __exportStar(require("./ErrorResponseLegacyError.js"), exports);
 __exportStar(require("./ErrorResponseModernError.js"), exports);
@@ -34,13 +40,16 @@ __exportStar(require("./GetProjectDistributionCredentialsV1Response.js"), export
 __exportStar(require("./GetProjectKeyV1Response.js"), exports);
 __exportStar(require("./GetProjectRequestV1Response.js"), exports);
 __exportStar(require("./GetProjectV1Response.js"), exports);
+__exportStar(require("./Google.js"), exports);
 __exportStar(require("./GrantV1Response.js"), exports);
+__exportStar(require("./Groq.js"), exports);
 __exportStar(require("./LeaveProjectV1Response.js"), exports);
 __exportStar(require("./ListBillingFieldsV1Response.js"), exports);
 __exportStar(require("./ListenV1AcceptedResponse.js"), exports);
 __exportStar(require("./ListenV1Callback.js"), exports);
 __exportStar(require("./ListenV1CallbackMethod.js"), exports);
 __exportStar(require("./ListenV1Channels.js"), exports);
+__exportStar(require("./ListenV1DetectEntities.js"), exports);
 __exportStar(require("./ListenV1Diarize.js"), exports);
 __exportStar(require("./ListenV1Dictation.js"), exports);
 __exportStar(require("./ListenV1Encoding.js"), exports);
@@ -95,6 +104,8 @@ __exportStar(require("./ListProjectMembersV1Response.js"), exports);
 __exportStar(require("./ListProjectPurchasesV1Response.js"), exports);
 __exportStar(require("./ListProjectRequestsV1Response.js"), exports);
 __exportStar(require("./ListProjectsV1Response.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);
@@ -106,11 +117,15 @@ __exportStar(require("./ReadV1ResponseResultsSummary.js"), exports);
 __exportStar(require("./SharedIntents.js"), exports);
 __exportStar(require("./SharedSentiments.js"), exports);
 __exportStar(require("./SharedTopics.js"), exports);
+__exportStar(require("./SpeakSettingsV1.js"), exports);
+__exportStar(require("./SpeakSettingsV1Provider.js"), exports);
 __exportStar(require("./SpeakV1Encoding.js"), exports);
 __exportStar(require("./SpeakV1MipOptOut.js"), exports);
 __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;
+};

package/dist/cjs/middleware/adapters/express.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * 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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDeepgramProxy = createDeepgramProxy;
+exports.createWebSocketHandler = createWebSocketHandler;
+exports.createDeepgramMiddleware = createDeepgramMiddleware;
+const ProxyHandler_js_1 = require("../core/ProxyHandler.js");
+const TokenManager_js_1 = require("../core/TokenManager.js");
+const WebSocketProxy_js_1 = require("../core/WebSocketProxy.js");
+/**
+ * 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));
+ * ```
+ */
+function createDeepgramProxy(options) {
+    const proxyHandler = new ProxyHandler_js_1.ProxyHandler(options);
+    const tokenManager = options.enableTokenAuth
+        ? new TokenManager_js_1.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!
+ * }));
+ * ```
+ */
+function createWebSocketHandler(options) {
+    const wsProxy = new WebSocketProxy_js_1.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);
+ * ```
+ */
+function createDeepgramMiddleware(options) {
+    const middleware = createDeepgramProxy(options);
+    const upgradeHandler = createWebSocketHandler(options);
+    return {
+        middleware,
+        upgradeHandler,
+        server: (httpServer) => {
+            httpServer.on("upgrade", upgradeHandler);
+        },
+    };
+}

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

@@ -0,0 +1,32 @@
+/**
+ * Fastify plugin for proxying Deepgram API requests.
+ *
+ * @packageDocumentation
+ *
+ * **Peer Dependencies Required:**
+ * ```bash
+ * npm install fastify fastify-plugin
+ * # or
+ * pnpm add fastify fastify-plugin
+ * ```
+ *
+ * This module provides a Fastify plugin for proxying requests to the Deepgram API,
+ * including REST endpoints and WebSocket connections.
+ */
+import type { FastifyPluginAsync, FastifyPluginOptions } from "fastify";
+import type { MiddlewareOptions } from "../core/types.js";
+/**
+ * Fastify plugin options
+ */
+export interface FastifyDeepgramProxyOptions extends MiddlewareOptions, FastifyPluginOptions {
+    /** URL prefix for the proxy routes (default: "") */
+    prefix?: string;
+}
+/**
+ * Export as Fastify plugin with proper typing
+ */
+export declare const fastifyDeepgramProxy: FastifyPluginAsync<FastifyDeepgramProxyOptions>;
+/**
+ * Alternative export for direct usage (without fastify-plugin wrapper)
+ */
+export declare const deepgramProxyPlugin: FastifyPluginAsync<FastifyDeepgramProxyOptions>;

package/dist/cjs/middleware/adapters/fastify.js

@@ -0,0 +1,194 @@
+"use strict";
+/**
+ * Fastify plugin for proxying Deepgram API requests.
+ *
+ * @packageDocumentation
+ *
+ * **Peer Dependencies Required:**
+ * ```bash
+ * npm install fastify fastify-plugin
+ * # or
+ * pnpm add fastify fastify-plugin
+ * ```
+ *
+ * This module provides a Fastify plugin for proxying requests to the Deepgram API,
+ * including REST endpoints and WebSocket connections.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deepgramProxyPlugin = exports.fastifyDeepgramProxy = void 0;
+const ProxyHandler_js_1 = require("../core/ProxyHandler.js");
+const TokenManager_js_1 = require("../core/TokenManager.js");
+const WebSocketProxy_js_1 = require("../core/WebSocketProxy.js");
+// Lazy-load fastify-plugin
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Dynamic loading
+let fp = null;
+function loadFastifyPlugin() {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (fp) {
+            return fp;
+        }
+        try {
+            const module = yield Promise.resolve().then(() => __importStar(require("fastify-plugin")));
+            fp = module.default || module;
+            return fp;
+        }
+        catch (_a) {
+            throw new Error("fastify-plugin is required for Fastify middleware. Install it with: npm install fastify-plugin");
+        }
+    });
+}
+/**
+ * Fastify plugin for proxying Deepgram API requests
+ *
+ * @param fastify - Fastify instance
+ * @param options - Plugin configuration options
+ *
+ * @example
+ * ```typescript
+ * import Fastify from 'fastify';
+ * import { fastifyDeepgramProxy } from '@deepgram/sdk';
+ *
+ * const fastify = Fastify();
+ *
+ * fastify.register(fastifyDeepgramProxy, {
+ *   prefix: '/api/deepgram',
+ *   apiKey: process.env.DEEPGRAM_API_KEY!,
+ *   enableTokenAuth: true
+ * });
+ *
+ * fastify.listen({ port: 3000 });
+ * ```
+ */
+const fastifyDeepgramProxyPlugin = (fastify, options) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const proxyHandler = new ProxyHandler_js_1.ProxyHandler(options);
+    const tokenManager = options.enableTokenAuth
+        ? new TokenManager_js_1.TokenManager(options)
+        : null;
+    const wsProxy = new WebSocketProxy_js_1.WebSocketProxy(options);
+    // NOTE: We do NOT add a custom content type parser here because:
+    // 1. fastify-plugin breaks encapsulation, so it would affect ALL routes
+    // 2. We handle body reconstruction in our route handlers instead
+    // This allows users to use their own body parsers for their routes
+    // Register token endpoint if token auth is enabled
+    if (tokenManager) {
+        fastify.get("/token", (request, reply) => {
+            reply.hijack();
+            tokenManager.handleTokenRequest(request.raw, reply.raw).catch((error) => {
+                console.error("Token generation error:", error);
+            });
+        });
+    }
+    // Register wildcard route to catch ALL paths
+    // This must match any path depth: /, /v1, /v1/listen, /v1/listen/more/paths
+    fastify.all("/*", (request, reply) => {
+        reply.hijack();
+        // Fastify has already consumed the request body stream, so we need to
+        // write the parsed body back to the raw request
+        if (request.body && (request.method === 'POST' || request.method === 'PUT' || request.method === 'PATCH')) {
+            const bodyString = typeof request.body === 'string' ? request.body : JSON.stringify(request.body);
+            // Write the body to the raw request stream
+            process.nextTick(() => {
+                request.raw.emit('data', Buffer.from(bodyString));
+                request.raw.emit('end');
+            });
+        }
+        proxyHandler.handleRequest(request.raw, reply.raw).catch((error) => {
+            console.error("[Fastify] Proxy error:", error);
+        });
+    });
+    // Also catch root path explicitly
+    fastify.all("/", (request, reply) => {
+        reply.hijack();
+        // Reconstruct body if needed
+        if (request.body && (request.method === 'POST' || request.method === 'PUT' || request.method === 'PATCH')) {
+            const bodyString = typeof request.body === 'string' ? request.body : JSON.stringify(request.body);
+            process.nextTick(() => {
+                request.raw.emit('data', Buffer.from(bodyString));
+                request.raw.emit('end');
+            });
+        }
+        proxyHandler.handleRequest(request.raw, reply.raw).catch((error) => {
+            console.error("[Fastify] Root proxy error:", error);
+        });
+    });
+    // Register WebSocket upgrade handler
+    if (fastify.server) {
+        const prefix = (_a = options.prefix) !== null && _a !== void 0 ? _a : "";
+        fastify.server.on("upgrade", (req, socket, head) => {
+            var _a;
+            // Only handle requests matching our prefix
+            if ((_a = req.url) === null || _a === void 0 ? void 0 : _a.startsWith(prefix)) {
+                // Remove prefix from URL before proxying
+                const originalUrl = req.url;
+                req.url = originalUrl.slice(prefix.length);
+                wsProxy.handleUpgrade(req, socket, head);
+            }
+        });
+    }
+});
+/**
+ * Lazy-loaded Fastify plugin (only loads fastify-plugin when called)
+ */
+let _fastifyDeepgramProxy = null;
+/**
+ * Export as Fastify plugin with proper typing
+ */
+const fastifyDeepgramProxy = (fastify, options) => __awaiter(void 0, void 0, void 0, function* () {
+    if (!_fastifyDeepgramProxy) {
+        const pluginWrapper = yield loadFastifyPlugin();
+        _fastifyDeepgramProxy = pluginWrapper(fastifyDeepgramProxyPlugin, {
+            fastify: ">=4.0.0",
+            name: "@deepgram/sdk-middleware",
+        });
+    }
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- Guaranteed to be set above
+    return _fastifyDeepgramProxy(fastify, options);
+});
+exports.fastifyDeepgramProxy = fastifyDeepgramProxy;
+/**
+ * Alternative export for direct usage (without fastify-plugin wrapper)
+ */
+exports.deepgramProxyPlugin = fastifyDeepgramProxyPlugin;