@deepgram/sdk 5.4.0 → 5.5.0

package/dist/esm/api/resources/listen/resources/v1/types/index.mjs

@@ -1,3 +1,4 @@
+export * from "./DiarizeModel.mjs";
 export * from "./ListenV1CloseStream.mjs";
 export * from "./ListenV1Finalize.mjs";
 export * from "./ListenV1KeepAlive.mjs";

package/dist/esm/api/resources/listen/resources/v2/client/Client.d.mts

@@ -13,6 +13,7 @@ export declare namespace V2Client {
         eot_timeout_ms?: Deepgram.ListenV2EotTimeoutMs | undefined;
         keyterm?: Deepgram.ListenV2Keyterm;
         language_hint?: Deepgram.ListenV2LanguageHint;
+        profanity_filter?: Deepgram.ListenV2ProfanityFilter;
         mip_opt_out?: Deepgram.ListenV2MipOptOut | undefined;
         tag?: Deepgram.ListenV2Tag | undefined;
         Authorization: string;

package/dist/esm/api/resources/listen/resources/v2/client/Client.mjs

@@ -21,7 +21,7 @@ export class V2Client {
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c;
-            const { model, encoding, sample_rate: sampleRate, eager_eot_threshold: eagerEotThreshold, eot_threshold: eotThreshold, eot_timeout_ms: eotTimeoutMs, keyterm, language_hint: languageHint, mip_opt_out: mipOptOut, tag, protocols, queryParams, headers, debug, reconnectAttempts, connectionTimeoutInSeconds, abortSignal, } = args;
+            const { model, encoding, sample_rate: sampleRate, eager_eot_threshold: eagerEotThreshold, eot_threshold: eotThreshold, eot_timeout_ms: eotTimeoutMs, keyterm, language_hint: languageHint, profanity_filter: profanityFilter, mip_opt_out: mipOptOut, tag, protocols, queryParams, headers, debug, reconnectAttempts, connectionTimeoutInSeconds, abortSignal, } = args;
             const _queryParams = {
                 model,
                 encoding: encoding != null ? encoding : undefined,
@@ -55,6 +55,7 @@ export class V2Client {
                             ? languageHint
                             : toJson(languageHint)
                         : undefined,
+                profanity_filter: profanityFilter != null ? profanityFilter : undefined,
                 mip_opt_out: mipOptOut != null ? (typeof mipOptOut === "string" ? mipOptOut : toJson(mipOptOut)) : undefined,
                 tag: tag != null ? (typeof tag === "string" ? tag : toJson(tag)) : undefined,
             };

package/dist/esm/api/resources/listen/resources/v2/types/ListenV2CloseStream.d.mts

@@ -3,10 +3,11 @@ export interface ListenV2CloseStream {
     type: ListenV2CloseStream.Type;
 }
 export declare namespace ListenV2CloseStream {
-    /** Message type identifier */
     const Type: {
+        /** @deprecated Use "CloseStream". Retained for backward compatibility. */
         readonly Finalize: "Finalize";
         readonly CloseStream: "CloseStream";
+        /** @deprecated Use "CloseStream". Retained for backward compatibility. */
         readonly KeepAlive: "KeepAlive";
     };
     type Type = (typeof Type)[keyof typeof Type] | string;

package/dist/esm/api/resources/listen/resources/v2/types/ListenV2CloseStream.mjs

@@ -1,10 +1,14 @@
 // This file was auto-generated by Fern from our API Definition.
 export var ListenV2CloseStream;
 (function (ListenV2CloseStream) {
-    /** Message type identifier */
+    // A CloseStream message's `type` is always "CloseStream". `Finalize`/`KeepAlive` are
+    // deprecated and retained only for backward compatibility; they will be removed in the
+    // next major. Frozen in .fernignore.
     ListenV2CloseStream.Type = {
+        /** @deprecated Use "CloseStream". Retained for backward compatibility. */
         Finalize: "Finalize",
         CloseStream: "CloseStream",
+        /** @deprecated Use "CloseStream". Retained for backward compatibility. */
         KeepAlive: "KeepAlive",
     };
 })(ListenV2CloseStream || (ListenV2CloseStream = {}));

package/dist/esm/api/resources/listen/resources/v2/types/ListenV2TurnInfo.d.mts

@@ -66,6 +66,10 @@ export declare namespace ListenV2TurnInfo {
             word: string;
             /** Confidence that this word was transcribed correctly */
             confidence: number;
+            /** The start time of the word */
+            start?: number | undefined;
+            /** The end time of the word */
+            end?: number | undefined;
         }
     }
 }

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

@@ -5,7 +5,13 @@ export interface DeepgramListenProviderV2 {
     version?: "v2" | undefined;
     /** Model to use for speech to text using the V2 API (e.g. flux-general-en, flux-general-multi) */
     model: string;
-    /** One or more BCP-47 language codes to bias the model toward specific languages. Only supported when model is flux-general-multi. Without hints, the model auto-detects the spoken language. See the Language Prompting guide for details. */
+    /** An array of one or more BCP-47 language codes to bias the model toward specific languages. Only supported when model is flux-general-multi. Without hints, the model auto-detects the spoken language. See the Language Prompting guide for details. */
+    language_hints?: string[] | undefined;
+    /**
+     * @deprecated Use `language_hints` instead. Backward-compat shim: the 2026-06-16 regen
+     * renamed this field to `language_hints`. The singular `language_hint` was never honored
+     * by the API, so this is kept only so existing call sites keep compiling; prefer `language_hints`.
+     */
     language_hint?: DeepgramListenProviderV2.LanguageHint | undefined;
     /** Prompt keyterm recognition to improve Keyword Recall Rate */
     keyterms?: string[] | undefined;

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

@@ -1,4 +1,4 @@
-/** Defaults to `false`. Recognize speaker changes. Each word in the transcript will be assigned a speaker number starting at 0 */
+/** Deprecated. Use `diarize_model` instead. Defaults to `false`. Recognize speaker changes. Each word in the transcript will be assigned a speaker number starting at 0 */
 export declare const ListenV1Diarize: {
     readonly True: "true";
     readonly False: "false";

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

@@ -1,5 +1,5 @@
 // This file was auto-generated by Fern from our API Definition.
-/** Defaults to `false`. Recognize speaker changes. Each word in the transcript will be assigned a speaker number starting at 0 */
+/** Deprecated. Use `diarize_model` instead. Defaults to `false`. Recognize speaker changes. Each word in the transcript will be assigned a speaker number starting at 0 */
 export const ListenV1Diarize = {
     True: "true",
     False: "false",

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

@@ -0,0 +1,6 @@
+/** Profanity Filter looks for recognized profanity and converts it to the nearest recognized non-profane word or removes it from the transcript completely. */
+export declare const ListenV2ProfanityFilter: {
+    readonly True: "true";
+    readonly False: "false";
+};
+export type ListenV2ProfanityFilter = (typeof ListenV2ProfanityFilter)[keyof typeof ListenV2ProfanityFilter] | string;

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

@@ -0,0 +1,6 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Profanity Filter looks for recognized profanity and converts it to the nearest recognized non-profane word or removes it from the transcript completely. */
+export const ListenV2ProfanityFilter = {
+    True: "true",
+    False: "false",
+};

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

@@ -84,6 +84,7 @@ export * from "./ListenV2Keyterm.mjs";
 export * from "./ListenV2LanguageHint.mjs";
 export * from "./ListenV2MipOptOut.mjs";
 export * from "./ListenV2Model.mjs";
+export * from "./ListenV2ProfanityFilter.mjs";
 export * from "./ListenV2SampleRate.mjs";
 export * from "./ListenV2Tag.mjs";
 export * from "./ListModelsV1Response.mjs";

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

@@ -84,6 +84,7 @@ export * from "./ListenV2Keyterm.mjs";
 export * from "./ListenV2LanguageHint.mjs";
 export * from "./ListenV2MipOptOut.mjs";
 export * from "./ListenV2Model.mjs";
+export * from "./ListenV2ProfanityFilter.mjs";
 export * from "./ListenV2SampleRate.mjs";
 export * from "./ListenV2Tag.mjs";
 export * from "./ListModelsV1Response.mjs";

package/dist/esm/auth/HeaderAuthProvider.mjs

@@ -13,6 +13,7 @@ import * as errors from "../errors/index.mjs";
 const PARAM_KEY = "apiKey";
 const ENV_HEADER_KEY = "DEEPGRAM_API_KEY";
 const HEADER_NAME = "Authorization";
+const HEADER_PREFIX = "Token ";
 export class HeaderAuthProvider {
     constructor(options) {
         this.options = options;
@@ -31,7 +32,7 @@ export class HeaderAuthProvider {
                 });
             }
             return {
-                headers: { [HEADER_NAME]: headerValue },
+                headers: { [HEADER_NAME]: `${HEADER_PREFIX}${headerValue}` },
             };
         });
     }

package/dist/esm/core/auth/AuthProvider.d.mts

@@ -5,3 +5,4 @@ export interface AuthProvider {
         endpointMetadata?: EndpointMetadata;
     }): Promise<AuthRequest>;
 }
+export declare function isAuthProvider(value: unknown): value is AuthProvider;

package/dist/esm/core/auth/AuthProvider.mjs

@@ -1 +1,6 @@
-export {};
+export function isAuthProvider(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "getAuthRequest" in value &&
+        typeof value.getAuthRequest === "function");
+}

package/dist/esm/core/auth/index.d.mts

@@ -1,4 +1,4 @@
-export type { AuthProvider } from "./AuthProvider.mjs";
+export { type AuthProvider, isAuthProvider } from "./AuthProvider.mjs";
 export type { AuthRequest } from "./AuthRequest.mjs";
 export { BasicAuth } from "./BasicAuth.mjs";
 export { BearerToken } from "./BearerToken.mjs";

package/dist/esm/core/auth/index.mjs

@@ -1,3 +1,4 @@
+export { isAuthProvider } from "./AuthProvider.mjs";
 export { BasicAuth } from "./BasicAuth.mjs";
 export { BearerToken } from "./BearerToken.mjs";
 export { NoOpAuthProvider } from "./NoOpAuthProvider.mjs";

package/dist/esm/core/fetcher/getResponseBody.mjs

@@ -9,6 +9,15 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { fromJson } from "../json.mjs";
 import { getBinaryResponse } from "./BinaryResponse.mjs";
+// Pins the upstream Response so undici's FinalizationRegistry can't GC it and cancel the body stream.
+function retainResponse(target, response) {
+    Object.defineProperty(target, "__fern_response_ref", {
+        value: response,
+        enumerable: false,
+        configurable: true,
+        writable: false,
+    });
+}
 export function getResponseBody(response, responseType) {
     return __awaiter(this, void 0, void 0, function* () {
         switch (responseType) {
@@ -28,6 +37,7 @@ export function getResponseBody(response, responseType) {
                         },
                     };
                 }
+                retainResponse(response.body, response);
                 return response.body;
             case "streaming":
                 if (response.body == null) {
@@ -39,6 +49,7 @@ export function getResponseBody(response, responseType) {
                         },
                     };
                 }
+                retainResponse(response.body, response);
                 return response.body;
             case "text":
                 return yield response.text();

package/dist/esm/core/fetcher/requestWithRetries.mjs

@@ -11,6 +11,9 @@ const INITIAL_RETRY_DELAY = 1000; // in milliseconds
 const MAX_RETRY_DELAY = 60000; // in milliseconds
 const DEFAULT_MAX_RETRIES = 2;
 const JITTER_FACTOR = 0.2; // 20% random jitter
+function isRetryableStatusCode(statusCode) {
+    return [408, 429].includes(statusCode) || statusCode >= 500;
+}
 function addPositiveJitter(delay) {
     const jitterMultiplier = 1 + Math.random() * JITTER_FACTOR;
     return delay * jitterMultiplier;
@@ -50,7 +53,7 @@ export function requestWithRetries(requestFn_1) {
     return __awaiter(this, arguments, void 0, function* (requestFn, maxRetries = DEFAULT_MAX_RETRIES) {
         let response = yield requestFn();
         for (let i = 0; i < maxRetries; ++i) {
-            if ([408, 429].includes(response.status) || response.status >= 500) {
+            if (isRetryableStatusCode(response.status)) {
                 const delay = getRetryDelayFromHeaders(response, i);
                 yield new Promise((resolve) => setTimeout(resolve, delay));
                 response = yield requestFn();

package/dist/esm/core/fetcher/signals.mjs

@@ -10,11 +10,19 @@ export function anySignal(...args) {
     for (const signal of signals) {
         if (signal.aborted) {
             controller.abort(signal === null || signal === void 0 ? void 0 : signal.reason);
-            break;
+            return controller.signal;
         }
         signal.addEventListener("abort", () => controller.abort(signal === null || signal === void 0 ? void 0 : signal.reason), {
             signal: controller.signal,
         });
+        // Re-check after adding listener: the signal may have aborted
+        // between the initial `signal.aborted` check and the `addEventListener`
+        // call above. If it did, the abort event was already dispatched and
+        // the listener will never fire — we must manually abort.
+        if (signal.aborted) {
+            controller.abort(signal === null || signal === void 0 ? void 0 : signal.reason);
+            return controller.signal;
+        }
     }
     return controller.signal;
 }

package/dist/esm/errors/DeepgramError.mjs

@@ -7,7 +7,7 @@ export class DeepgramError extends Error {
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, this.constructor);
         }
-        this.name = this.constructor.name;
+        this.name = "DeepgramError";
         this.statusCode = statusCode;
         this.body = body;
         this.rawResponse = rawResponse;

package/dist/esm/errors/DeepgramTimeoutError.mjs

@@ -6,7 +6,7 @@ export class DeepgramTimeoutError extends Error {
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, this.constructor);
         }
-        this.name = this.constructor.name;
+        this.name = "DeepgramTimeoutError";
         if ((opts === null || opts === void 0 ? void 0 : opts.cause) != null) {
             this.cause = opts.cause;
         }

package/dist/esm/index.d.mts

@@ -4,6 +4,8 @@ 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";
+export type { CustomDeepgramClientOptions } from "./CustomClient.mjs";
 export { DeepgramEnvironment, type DeepgramEnvironmentUrls } from "./environments.mjs";
 export { DeepgramError, DeepgramTimeoutError } from "./errors/index.mjs";
+export * from "./transport.mjs";
 export * from "./exports.mjs";

package/dist/esm/index.mjs

@@ -9,4 +9,5 @@ export { DeepgramClient as DefaultDeepgramClient } from "./Client.mjs";
 export { CustomDeepgramClient as DeepgramClient } from "./CustomClient.mjs";
 export { DeepgramEnvironment } from "./environments.mjs";
 export { DeepgramError, DeepgramTimeoutError } from "./errors/index.mjs";
+export * from "./transport.mjs";
 export * from "./exports.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "5.2.1";
+export declare const SDK_VERSION = "5.5.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "5.2.1";
+export const SDK_VERSION = "5.5.0"; // x-release-please-version

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@deepgram/sdk",
-    "version": "5.4.0",
+    "version": "5.5.0",
     "private": false,
     "repository": {
         "type": "git",

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

@@ -1 +0,0 @@
-export type CreateKeyV1RequestOne = unknown;

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

@@ -1 +0,0 @@
-export type CreateKeyV1RequestOne = unknown;

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

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