@deepgram/sdk 5.1.0 → 5.2.0

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

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

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

@@ -6,6 +6,8 @@ export interface OpenAiThinkProvider {
     model: OpenAiThinkProvider.Model;
     /** OpenAI temperature (0-2) */
     temperature?: number | undefined;
+    /** OpenAI reasoning_effort */
+    reasoning_mode?: OpenAiThinkProvider.ReasoningMode | undefined;
 }
 export declare namespace OpenAiThinkProvider {
     /** OpenAI model to use */
@@ -20,4 +22,13 @@ export declare namespace OpenAiThinkProvider {
         readonly Gpt4OMini: "gpt-4o-mini";
     };
     type Model = (typeof Model)[keyof typeof Model] | string;
+    /** OpenAI reasoning_effort */
+    const ReasoningMode: {
+        readonly None: "none";
+        readonly Minimal: "minimal";
+        readonly Low: "low";
+        readonly Medium: "medium";
+        readonly High: "high";
+    };
+    type ReasoningMode = (typeof ReasoningMode)[keyof typeof ReasoningMode] | string;
 }

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

@@ -12,4 +12,12 @@ export var OpenAiThinkProvider;
         Gpt4O: "gpt-4o",
         Gpt4OMini: "gpt-4o-mini",
     };
+    /** OpenAI reasoning_effort */
+    OpenAiThinkProvider.ReasoningMode = {
+        None: "none",
+        Minimal: "minimal",
+        Low: "low",
+        Medium: "medium",
+        High: "high",
+    };
 })(OpenAiThinkProvider || (OpenAiThinkProvider = {}));

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

@@ -7,7 +7,7 @@ export * from "./AwsPollySpeakProvider.mjs";
 export * from "./BillingBreakdownV1Response.mjs";
 export * from "./Cartesia.mjs";
 export * from "./CreateAgentConfigurationV1Response.mjs";
-export * from "./CreateKeyV1RequestOne.mjs";
+export * from "./CreateKeyV1Request.mjs";
 export * from "./CreateKeyV1Response.mjs";
 export * from "./CreateProjectDistributionCredentialsV1Response.mjs";
 export * from "./CreateProjectInviteV1Response.mjs";
@@ -79,6 +79,7 @@ export * from "./ListenV2Encoding.mjs";
 export * from "./ListenV2EotThreshold.mjs";
 export * from "./ListenV2EotTimeoutMs.mjs";
 export * from "./ListenV2Keyterm.mjs";
+export * from "./ListenV2LanguageHint.mjs";
 export * from "./ListenV2MipOptOut.mjs";
 export * from "./ListenV2Model.mjs";
 export * from "./ListenV2SampleRate.mjs";

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

@@ -7,7 +7,7 @@ export * from "./AwsPollySpeakProvider.mjs";
 export * from "./BillingBreakdownV1Response.mjs";
 export * from "./Cartesia.mjs";
 export * from "./CreateAgentConfigurationV1Response.mjs";
-export * from "./CreateKeyV1RequestOne.mjs";
+export * from "./CreateKeyV1Request.mjs";
 export * from "./CreateKeyV1Response.mjs";
 export * from "./CreateProjectDistributionCredentialsV1Response.mjs";
 export * from "./CreateProjectInviteV1Response.mjs";
@@ -79,6 +79,7 @@ export * from "./ListenV2Encoding.mjs";
 export * from "./ListenV2EotThreshold.mjs";
 export * from "./ListenV2EotTimeoutMs.mjs";
 export * from "./ListenV2Keyterm.mjs";
+export * from "./ListenV2LanguageHint.mjs";
 export * from "./ListenV2MipOptOut.mjs";
 export * from "./ListenV2Model.mjs";
 export * from "./ListenV2SampleRate.mjs";

package/dist/esm/transport.d.mts

@@ -0,0 +1,73 @@
+/**
+ * Message payloads exchanged over Deepgram streaming transports.
+ *
+ * A transport can carry JSON control messages as strings and audio or synthesized
+ * audio as binary payloads.
+ */
+export type DeepgramTransportMessage = string | ArrayBuffer | Blob | ArrayBufferView;
+/** Close metadata reported by a custom transport. */
+export interface DeepgramTransportCloseEvent {
+    code?: number;
+    reason?: string;
+}
+/**
+ * Metadata passed to a transport factory when a streaming connection is created.
+ *
+ * The first two factory arguments intentionally match the Python and Java SDKs:
+ * `factory(url, headers)`. JavaScript also passes this third metadata object so
+ * custom transports can inspect the target streaming API and connection settings.
+ */
+export interface DeepgramTransportRequest {
+    /** Full Deepgram websocket URL including query parameters. */
+    url: string;
+    /** Resolved request headers including auth and session headers. */
+    headers: Record<string, string>;
+    /** Requested websocket subprotocols, if any. */
+    protocols: string[];
+    /** Deepgram websocket path (for example `/v1/listen`). */
+    path: string;
+    /** Streaming API being targeted. */
+    service: "agent.v1" | "listen.v1" | "listen.v2" | "speak.v1";
+    /** Query parameters before they are encoded into the URL. */
+    queryParams: Record<string, unknown>;
+    /** Whether debug logging was requested for the connection. */
+    debug: boolean;
+    /** Requested reconnect attempts for this connection. */
+    reconnectAttempts: number;
+    /** Optional connection timeout in seconds. */
+    connectionTimeoutInSeconds?: number;
+    /** Optional abort signal for the connection attempt. */
+    abortSignal?: AbortSignal;
+}
+/**
+ * Transport interface for replacing the SDK's default websocket transport.
+ *
+ * This is the seam used by SageMaker support and other non-websocket streaming
+ * implementations. The SDK adapts this transport to its existing socket APIs, so
+ * callers still use `client.listen.v1.createConnection()` and related methods.
+ */
+export interface DeepgramTransport {
+    /** Send either a JSON string or binary payload to the transport. */
+    send(data: DeepgramTransportMessage): void | Promise<void>;
+    /** Register a listener fired once the transport is ready to exchange messages. */
+    onOpen(listener: () => void): void;
+    /** Register a listener for inbound text or binary messages. */
+    onMessage(listener: (message: DeepgramTransportMessage) => void): void;
+    /** Register a listener for transport-level errors. */
+    onError(listener: (error: Error) => void): void;
+    /** Register a listener for transport close events. */
+    onClose(listener: (event: DeepgramTransportCloseEvent) => void): void;
+    /** Returns true while the transport is open and able to send data. */
+    isOpen(): boolean;
+    /** Close the transport gracefully. */
+    close(code?: number, reason?: string): void | Promise<void>;
+    /** Optional ping hook for transports that expose an explicit keepalive primitive. */
+    ping?(data?: string | ArrayBuffer | Blob | ArrayBufferView): void | Promise<void>;
+}
+/**
+ * Factory for creating custom streaming transports.
+ *
+ * The first two arguments mirror the Python and Java SDKs. JavaScript also passes
+ * a third metadata argument for transports that need more connection context.
+ */
+export type DeepgramTransportFactory = (url: string, headers: Record<string, string>, request: DeepgramTransportRequest) => DeepgramTransport | Promise<DeepgramTransport>;

package/dist/esm/transport.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "5.0.1";
+export declare const SDK_VERSION = "5.1.1";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "5.0.1";
+export const SDK_VERSION = "5.1.1";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@deepgram/sdk",
-    "version": "5.1.0",
+    "version": "5.2.0",
     "private": false,
     "repository": {
         "type": "git",
@@ -511,20 +511,20 @@
         "ws": "^8.20.0"
     },
     "devDependencies": {
+        "webpack": "^5.105.4",
+        "ts-loader": "^9.5.4",
+        "@types/ws": "^8.18.1",
+        "vitest": "^4.1.1",
+        "msw": "2.11.2",
+        "@types/node": "^20.17.57",
+        "typescript": "~5.9.3",
         "@biomejs/biome": "2.4.10",
         "@commitlint/cli": "20.5.0",
         "@commitlint/config-conventional": "20.0.0",
-        "@types/node": "^20.17.57",
-        "@types/ws": "^8.18.1",
-        "msw": "2.11.2",
-        "playwright": "1.59.1",
-        "terser": "5.46.1",
-        "ts-loader": "^9.5.4",
         "tsx": "4.20.6",
-        "typescript": "~5.9.3",
+        "playwright": "1.59.1",
         "vite": "6.4.2",
-        "vitest": "^4.1.1",
-        "webpack": "^5.105.4"
+        "terser": "5.46.1"
     },
     "browser": {
         "fs": false,

package/reference.md

@@ -875,7 +875,7 @@ await client.manage.v1.projects.keys.create("project_id", {
 <dl>
 <dd>
 
-**request:** `Deepgram.CreateKeyV1RequestOne` 
+**request:** `Deepgram.CreateKeyV1Request` 
     
 </dd>
 </dl>