@deepgram/sdk 5.0.0-beta.4 → 5.1.0

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

@@ -1,5 +1,5 @@
 export interface ListenV1ResponseMetadata {
-    transaction_key?: string;
+    transaction_key?: string | undefined;
     request_id: string;
     sha256: string;
     created: string;
@@ -7,31 +7,31 @@ export interface ListenV1ResponseMetadata {
     channels: number;
     models: string[];
     model_info: Record<string, unknown>;
-    summary_info?: ListenV1ResponseMetadata.SummaryInfo;
-    sentiment_info?: ListenV1ResponseMetadata.SentimentInfo;
-    topics_info?: ListenV1ResponseMetadata.TopicsInfo;
-    intents_info?: ListenV1ResponseMetadata.IntentsInfo;
-    tags?: string[];
+    summary_info?: ListenV1ResponseMetadata.SummaryInfo | undefined;
+    sentiment_info?: ListenV1ResponseMetadata.SentimentInfo | undefined;
+    topics_info?: ListenV1ResponseMetadata.TopicsInfo | undefined;
+    intents_info?: ListenV1ResponseMetadata.IntentsInfo | undefined;
+    tags?: string[] | undefined;
 }
 export declare namespace ListenV1ResponseMetadata {
     interface SummaryInfo {
-        model_uuid?: string;
-        input_tokens?: number;
-        output_tokens?: number;
+        model_uuid?: string | undefined;
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
     }
     interface SentimentInfo {
-        model_uuid?: string;
-        input_tokens?: number;
-        output_tokens?: number;
+        model_uuid?: string | undefined;
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
     }
     interface TopicsInfo {
-        model_uuid?: string;
-        input_tokens?: number;
-        output_tokens?: number;
+        model_uuid?: string | undefined;
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
     }
     interface IntentsInfo {
-        model_uuid?: string;
-        input_tokens?: number;
-        output_tokens?: number;
+        model_uuid?: string | undefined;
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
     }
 }

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

@@ -1,9 +1,9 @@
 import type * as Deepgram from "../index.mjs";
 export interface ListenV1ResponseResults {
     channels: Deepgram.ListenV1ResponseResultsChannels;
-    utterances?: Deepgram.ListenV1ResponseResultsUtterances;
-    summary?: Deepgram.ListenV1ResponseResultsSummary;
-    topics?: Deepgram.SharedTopics;
-    intents?: Deepgram.SharedIntents;
-    sentiments?: Deepgram.SharedSentiments;
+    utterances?: Deepgram.ListenV1ResponseResultsUtterances | undefined;
+    summary?: Deepgram.ListenV1ResponseResultsSummary | undefined;
+    topics?: Deepgram.SharedTopics | undefined;
+    intents?: Deepgram.SharedIntents | undefined;
+    sentiments?: Deepgram.SharedSentiments | undefined;
 }

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

@@ -1,23 +1,23 @@
 export interface ListenV1ResponseResultsChannelsItem {
-    search?: ListenV1ResponseResultsChannelsItem.Search.Item[];
-    alternatives?: ListenV1ResponseResultsChannelsItem.Alternatives.Item[];
-    detected_language?: string;
+    search?: ListenV1ResponseResultsChannelsItem.Search.Item[] | undefined;
+    alternatives?: ListenV1ResponseResultsChannelsItem.Alternatives.Item[] | undefined;
+    detected_language?: string | undefined;
 }
 export declare namespace ListenV1ResponseResultsChannelsItem {
     type Search = Search.Item[];
     namespace Search {
         interface Item {
-            query?: string;
-            hits?: Item.Hits.Item[];
+            query?: string | undefined;
+            hits?: Item.Hits.Item[] | undefined;
         }
         namespace Item {
             type Hits = Hits.Item[];
             namespace Hits {
                 interface Item {
-                    confidence?: number;
-                    start?: number;
-                    end?: number;
-                    snippet?: string;
+                    confidence?: number | undefined;
+                    start?: number | undefined;
+                    end?: number | undefined;
+                    snippet?: string | undefined;
                 }
             }
         }
@@ -25,45 +25,45 @@ export declare namespace ListenV1ResponseResultsChannelsItem {
     type Alternatives = Alternatives.Item[];
     namespace Alternatives {
         interface Item {
-            transcript?: string;
-            confidence?: number;
-            words?: Item.Words.Item[];
-            paragraphs?: Item.Paragraphs;
-            entities?: Item.Entities.Item[];
-            summaries?: Item.Summaries.Item[];
-            topics?: Item.Topics.Item[];
+            transcript?: string | undefined;
+            confidence?: number | undefined;
+            words?: Item.Words.Item[] | undefined;
+            paragraphs?: Item.Paragraphs | undefined;
+            entities?: Item.Entities.Item[] | undefined;
+            summaries?: Item.Summaries.Item[] | undefined;
+            topics?: Item.Topics.Item[] | undefined;
         }
         namespace Item {
             type Words = Words.Item[];
             namespace Words {
                 interface Item {
-                    word?: string;
-                    start?: number;
-                    end?: number;
-                    confidence?: number;
+                    word?: string | undefined;
+                    start?: number | undefined;
+                    end?: number | undefined;
+                    confidence?: number | undefined;
                 }
             }
             interface Paragraphs {
-                transcript?: string;
-                paragraphs?: Paragraphs.Paragraphs.Item[];
+                transcript?: string | undefined;
+                paragraphs?: Paragraphs.Paragraphs.Item[] | undefined;
             }
             namespace Paragraphs {
                 type Paragraphs = Paragraphs.Item[];
                 namespace Paragraphs {
                     interface Item {
-                        sentences?: Item.Sentences.Item[];
-                        speaker?: number;
-                        num_words?: number;
-                        start?: number;
-                        end?: number;
+                        sentences?: Item.Sentences.Item[] | undefined;
+                        speaker?: number | undefined;
+                        num_words?: number | undefined;
+                        start?: number | undefined;
+                        end?: number | undefined;
                     }
                     namespace Item {
                         type Sentences = Sentences.Item[];
                         namespace Sentences {
                             interface Item {
-                                text?: string;
-                                start?: number;
-                                end?: number;
+                                text?: string | undefined;
+                                start?: number | undefined;
+                                end?: number | undefined;
                             }
                         }
                     }
@@ -72,29 +72,29 @@ export declare namespace ListenV1ResponseResultsChannelsItem {
             type Entities = Entities.Item[];
             namespace Entities {
                 interface Item {
-                    label?: string;
-                    value?: string;
-                    raw_value?: string;
-                    confidence?: number;
-                    start_word?: number;
-                    end_word?: number;
+                    label?: string | undefined;
+                    value?: string | undefined;
+                    raw_value?: string | undefined;
+                    confidence?: number | undefined;
+                    start_word?: number | undefined;
+                    end_word?: number | undefined;
                 }
             }
             type Summaries = Summaries.Item[];
             namespace Summaries {
                 interface Item {
-                    summary?: string;
-                    start_word?: number;
-                    end_word?: number;
+                    summary?: string | undefined;
+                    start_word?: number | undefined;
+                    end_word?: number | undefined;
                 }
             }
             type Topics = Topics.Item[];
             namespace Topics {
                 interface Item {
-                    text?: string;
-                    start_word?: number;
-                    end_word?: number;
-                    topics?: string[];
+                    text?: string | undefined;
+                    start_word?: number | undefined;
+                    end_word?: number | undefined;
+                    topics?: string[] | undefined;
                 }
             }
         }

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

@@ -1,4 +1,4 @@
 export interface ListenV1ResponseResultsSummary {
-    result?: string;
-    short?: string;
+    result?: string | undefined;
+    short?: string | undefined;
 }

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

@@ -1,24 +1,24 @@
 export interface ListenV1ResponseResultsUtterancesItem {
-    start?: number;
-    end?: number;
-    confidence?: number;
-    channel?: number;
-    transcript?: string;
-    words?: ListenV1ResponseResultsUtterancesItem.Words.Item[];
-    speaker?: number;
-    id?: string;
+    start?: number | undefined;
+    end?: number | undefined;
+    confidence?: number | undefined;
+    channel?: number | undefined;
+    transcript?: string | undefined;
+    words?: ListenV1ResponseResultsUtterancesItem.Words.Item[] | undefined;
+    speaker?: number | undefined;
+    id?: string | undefined;
 }
 export declare namespace ListenV1ResponseResultsUtterancesItem {
     type Words = Words.Item[];
     namespace Words {
         interface Item {
-            word?: string;
-            start?: number;
-            end?: number;
-            confidence?: number;
-            speaker?: number;
-            speaker_confidence?: number;
-            punctuated_word?: string;
+            word?: string | undefined;
+            start?: number | undefined;
+            end?: number | undefined;
+            confidence?: number | undefined;
+            speaker?: number | undefined;
+            speaker_confidence?: number | undefined;
+            punctuated_word?: string | undefined;
         }
     }
 }

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

@@ -1 +1,4 @@
+/**
+ * Sample rate of submitted audio. Required (and only read) when a value is provided for encoding
+ */
 export type ListenV1SampleRate = unknown;

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

@@ -1 +1,4 @@
+/**
+ * Search for terms or phrases in submitted audio
+ */
 export type ListenV1Search = unknown;

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

@@ -1 +1,4 @@
+/**
+ * Label your requests for the purpose of identification during usage reporting
+ */
 export type ListenV1Tag = unknown;

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

@@ -1 +1,4 @@
+/**
+ * Indicates how long Deepgram will wait to send an UtteranceEnd message after a word has been transcribed. Use with interim_results
+ */
 export type ListenV1UtteranceEndMs = unknown;

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

@@ -1 +1,4 @@
+/**
+ * Version of an AI model to use
+ */
 export type ListenV1Version = unknown;

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

@@ -1 +1,6 @@
+/**
+ * End-of-turn confidence required to fire an eager end-of-turn event.
+ * When set, enables `EagerEndOfTurn` and `TurnResumed` events. Valid
+ * Values 0.3 - 0.9.
+ */
 export type ListenV2EagerEotThreshold = unknown;

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

@@ -1 +1,5 @@
+/**
+ * End-of-turn confidence required to finish a turn. Valid Values 0.5 -
+ * 0.9.
+ */
 export type ListenV2EotThreshold = unknown;

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

@@ -1 +1,5 @@
+/**
+ * A turn will be finished when this much time has passed after speech,
+ * regardless of EOT confidence.
+ */
 export type ListenV2EotTimeoutMs = unknown;

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

@@ -1 +1,6 @@
+/**
+ * Opts out requests from the Deepgram Model Improvement Program. Refer
+ * to our Docs for pricing impacts before setting this to true.
+ * https://dpgr.am/deepgram-mip
+ */
 export type ListenV2MipOptOut = unknown;

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

@@ -1,4 +1,6 @@
-/**
- * Defines the AI model used to process submitted audio.
- */
-export type ListenV2Model = "flux-general-en";
+/** Defines the AI model used to process submitted audio. */
+export declare const ListenV2Model: {
+    readonly FluxGeneralEn: "flux-general-en";
+    readonly FluxGeneralMulti: "flux-general-multi";
+};
+export type ListenV2Model = (typeof ListenV2Model)[keyof typeof ListenV2Model] | string;

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

@@ -1,2 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
-export {};
+/** Defines the AI model used to process submitted audio. */
+export const ListenV2Model = {
+    FluxGeneralEn: "flux-general-en",
+    FluxGeneralMulti: "flux-general-multi",
+};

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

@@ -1 +1,4 @@
+/**
+ * Sample rate of the audio stream in Hz. Required if sending non-containerized/raw audio. If sending containerized audio, this parameter should be omitted.
+ */
 export type ListenV2SampleRate = unknown;

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

@@ -1 +1,5 @@
+/**
+ * Label your requests for the purpose of identification during usage
+ * reporting
+ */
 export type ListenV2Tag = unknown;

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

@@ -1,7 +1,7 @@
 export interface OpenAiSpeakProvider {
     type: "open_ai";
     /** The REST API version for the OpenAI text-to-speech API */
-    version?: "v1";
+    version?: "v1" | undefined;
     /** OpenAI TTS model */
     model: OpenAiSpeakProvider.Model;
     /** OpenAI voice */

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

@@ -1,11 +1,11 @@
 export interface OpenAiThinkProvider {
     type: "open_ai";
     /** The REST API version for the OpenAI chat completions API */
-    version?: "v1";
+    version?: "v1" | undefined;
     /** OpenAI model to use */
     model: OpenAiThinkProvider.Model;
     /** OpenAI temperature (0-2) */
-    temperature?: number;
+    temperature?: number | undefined;
 }
 export declare namespace OpenAiThinkProvider {
     /** OpenAI model to use */

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

@@ -3,21 +3,21 @@
  */
 export interface ProjectRequestResponse {
     /** The unique identifier of the request */
-    request_id?: string;
+    request_id?: string | undefined;
     /** The unique identifier of the project */
-    project_uuid?: string;
+    project_uuid?: string | undefined;
     /** The date and time the request was created */
-    created?: string;
+    created?: string | undefined;
     /** The API path of the request */
-    path?: string;
+    path?: string | undefined;
     /** The unique identifier of the API key */
-    api_key_id?: string;
+    api_key_id?: string | undefined;
     /** The response of the request */
-    response?: Record<string, unknown>;
+    response?: Record<string, unknown> | undefined;
     /** The response code of the request */
-    code?: number;
+    code?: number | undefined;
     /** The deployment type */
-    deployment?: string;
+    deployment?: string | undefined;
     /** The callback URL for the request */
-    callback?: string;
+    callback?: string | undefined;
 }

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

@@ -1,36 +1,36 @@
 export interface ReadV1ResponseMetadata {
-    metadata?: ReadV1ResponseMetadata.Metadata;
+    metadata?: ReadV1ResponseMetadata.Metadata | undefined;
 }
 export declare namespace ReadV1ResponseMetadata {
     interface Metadata {
-        request_id?: string;
-        created?: string;
-        language?: string;
-        summary_info?: Metadata.SummaryInfo;
-        sentiment_info?: Metadata.SentimentInfo;
-        topics_info?: Metadata.TopicsInfo;
-        intents_info?: Metadata.IntentsInfo;
+        request_id?: string | undefined;
+        created?: string | undefined;
+        language?: string | undefined;
+        summary_info?: Metadata.SummaryInfo | undefined;
+        sentiment_info?: Metadata.SentimentInfo | undefined;
+        topics_info?: Metadata.TopicsInfo | undefined;
+        intents_info?: Metadata.IntentsInfo | undefined;
     }
     namespace Metadata {
         interface SummaryInfo {
-            model_uuid?: string;
-            input_tokens?: number;
-            output_tokens?: number;
+            model_uuid?: string | undefined;
+            input_tokens?: number | undefined;
+            output_tokens?: number | undefined;
         }
         interface SentimentInfo {
-            model_uuid?: string;
-            input_tokens?: number;
-            output_tokens?: number;
+            model_uuid?: string | undefined;
+            input_tokens?: number | undefined;
+            output_tokens?: number | undefined;
         }
         interface TopicsInfo {
-            model_uuid?: string;
-            input_tokens?: number;
-            output_tokens?: number;
+            model_uuid?: string | undefined;
+            input_tokens?: number | undefined;
+            output_tokens?: number | undefined;
         }
         interface IntentsInfo {
-            model_uuid?: string;
-            input_tokens?: number;
-            output_tokens?: number;
+            model_uuid?: string | undefined;
+            input_tokens?: number | undefined;
+            output_tokens?: number | undefined;
         }
     }
 }

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

@@ -1,7 +1,7 @@
 import type * as Deepgram from "../index.mjs";
 export interface ReadV1ResponseResults {
-    summary?: Deepgram.ReadV1ResponseResultsSummary;
-    topics?: Deepgram.SharedTopics;
-    intents?: Deepgram.SharedIntents;
-    sentiments?: Deepgram.SharedSentiments;
+    summary?: Deepgram.ReadV1ResponseResultsSummary | undefined;
+    topics?: Deepgram.SharedTopics | undefined;
+    intents?: Deepgram.SharedIntents | undefined;
+    sentiments?: Deepgram.SharedSentiments | undefined;
 }

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

@@ -2,15 +2,15 @@
  * Output whenever `summary=true` is used
  */
 export interface ReadV1ResponseResultsSummary {
-    results?: ReadV1ResponseResultsSummary.Results;
+    results?: ReadV1ResponseResultsSummary.Results | undefined;
 }
 export declare namespace ReadV1ResponseResultsSummary {
     interface Results {
-        summary?: Results.Summary;
+        summary?: Results.Summary | undefined;
     }
     namespace Results {
         interface Summary {
-            text?: string;
+            text?: string | undefined;
         }
     }
 }

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

@@ -2,31 +2,31 @@
  * Output whenever `intents=true` is used
  */
 export interface SharedIntents {
-    results?: SharedIntents.Results;
+    results?: SharedIntents.Results | undefined;
 }
 export declare namespace SharedIntents {
     interface Results {
-        intents?: Results.Intents;
+        intents?: Results.Intents | undefined;
     }
     namespace Results {
         interface Intents {
-            segments?: Intents.Segments.Item[];
+            segments?: Intents.Segments.Item[] | undefined;
         }
         namespace Intents {
             type Segments = Segments.Item[];
             namespace Segments {
                 interface Item {
-                    text?: string;
-                    start_word?: number;
-                    end_word?: number;
-                    intents?: Item.Intents.Item[];
+                    text?: string | undefined;
+                    start_word?: number | undefined;
+                    end_word?: number | undefined;
+                    intents?: Item.Intents.Item[] | undefined;
                 }
                 namespace Item {
                     type Intents = Intents.Item[];
                     namespace Intents {
                         interface Item {
-                            intent?: string;
-                            confidence_score?: number;
+                            intent?: string | undefined;
+                            confidence_score?: number | undefined;
                         }
                     }
                 }

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

@@ -2,22 +2,22 @@
  * Output whenever `sentiment=true` is used
  */
 export interface SharedSentiments {
-    segments?: SharedSentiments.Segments.Item[];
-    average?: SharedSentiments.Average;
+    segments?: SharedSentiments.Segments.Item[] | undefined;
+    average?: SharedSentiments.Average | undefined;
 }
 export declare namespace SharedSentiments {
     type Segments = Segments.Item[];
     namespace Segments {
         interface Item {
-            text?: string;
-            start_word?: number;
-            end_word?: number;
-            sentiment?: string;
-            sentiment_score?: number;
+            text?: string | undefined;
+            start_word?: number | undefined;
+            end_word?: number | undefined;
+            sentiment?: string | undefined;
+            sentiment_score?: number | undefined;
         }
     }
     interface Average {
-        sentiment?: string;
-        sentiment_score?: number;
+        sentiment?: string | undefined;
+        sentiment_score?: number | undefined;
     }
 }

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

@@ -2,31 +2,31 @@
  * Output whenever `topics=true` is used
  */
 export interface SharedTopics {
-    results?: SharedTopics.Results;
+    results?: SharedTopics.Results | undefined;
 }
 export declare namespace SharedTopics {
     interface Results {
-        topics?: Results.Topics;
+        topics?: Results.Topics | undefined;
     }
     namespace Results {
         interface Topics {
-            segments?: Topics.Segments.Item[];
+            segments?: Topics.Segments.Item[] | undefined;
         }
         namespace Topics {
             type Segments = Segments.Item[];
             namespace Segments {
                 interface Item {
-                    text?: string;
-                    start_word?: number;
-                    end_word?: number;
-                    topics?: Item.Topics.Item[];
+                    text?: string | undefined;
+                    start_word?: number | undefined;
+                    end_word?: number | undefined;
+                    topics?: Item.Topics.Item[] | undefined;
                 }
                 namespace Item {
                     type Topics = Topics.Item[];
                     namespace Topics {
                         interface Item {
-                            topic?: string;
-                            confidence_score?: number;
+                            topic?: string | undefined;
+                            confidence_score?: number | undefined;
                         }
                     }
                 }

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

@@ -5,7 +5,7 @@ export interface SpeakSettingsV1 {
      * Optional if provider is Deepgram. Required for non-Deepgram TTS providers.
      * When present, must include url field and headers object. Valid schemes are https and wss with wss only supported for Eleven Labs.
      */
-    endpoint?: SpeakSettingsV1.Endpoint;
+    endpoint?: SpeakSettingsV1.Endpoint | undefined;
 }
 export declare namespace SpeakSettingsV1 {
     /**
@@ -14,7 +14,7 @@ export declare namespace SpeakSettingsV1 {
      */
     interface Endpoint {
         /** Custom TTS endpoint URL. Cannot contain `output_format` or `model_id` query parameters when the provider is Eleven Labs. */
-        url?: string;
-        headers?: Record<string, string>;
+        url?: string | undefined;
+        headers?: Record<string, string> | undefined;
     }
 }

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

@@ -1 +1,4 @@
+/**
+ * Opts out requests from the Deepgram Model Improvement Program. Refer to our Docs for pricing impacts before setting this to true. https://dpgr.am/deepgram-mip
+ */
 export type SpeakV1MipOptOut = unknown;