@deepgram/sdk 4.3.0 → 4.5.0

package/README.md

@@ -4,9 +4,11 @@
 
 Official JavaScript SDK for [Deepgram](https://www.deepgram.com/). Power your apps with world-class speech and Language AI models.
 
+- [Documentation](#documentation)
 - [Migrating from earlier versions](#migrating-from-earlier-versions)
   - [V2 to V3](#v2-to-v3)
   - [V3.\* to V3.4](#v3-to-v34)
+  - [V3.\* to V4](#v3-to-v4)
 - [Installation](#installation)
   - [UMD](#umd)
   - [ESM](#esm)
@@ -23,17 +25,19 @@ Official JavaScript SDK for [Deepgram](https://www.deepgram.com/). Power your ap
     - [Override fetch transmitter](#override-fetch-transmitter)
     - [Proxy requests in the browser](#proxy-requests-in-the-browser)
     - [Set custom headers for fetch](#set-custom-headers-for-fetch)
-- [Transcription (Synchronous)](#transcription-synchronous)
+- [Pre-Recorded (Synchronous)](#pre-recorded-synchronous)
   - [Remote Files](#remote-files)
   - [Local Files](#local-files)
-- [Transcription (Asynchronous / Callbacks)](#transcription-asynchronous--callbacks)
+  - [Browser](#browser)
+- [Pre-Recorded (Asynchronous / Callbacks)](#pre-recorded-asynchronous--callbacks)
   - [Remote Files](#remote-files-1)
   - [Local Files](#local-files-1)
-- [Transcription (Live / Streaming)](#transcription-live--streaming)
-  - [Live Audio](#live-audio)
+  - [Browser](#browser-1)
+- [Streaming Audio](#streaming-audio)
 - [Transcribing to captions](#transcribing-to-captions)
 - [Voice Agent](#voice-agent)
-- [Text to Speech](#text-to-speech)
+- [Text to Speech Rest](#text-to-speech-rest)
+- [Text to Speech Streaming](#text-to-speech-streaming)
 - [Text Intelligence](#text-intelligence)
 - [Authentication](#authentication)
   - [Get Token Details](#get-token-details)
@@ -67,7 +71,7 @@ Official JavaScript SDK for [Deepgram](https://www.deepgram.com/). Power your ap
   - [Get All Balances](#get-all-balances)
   - [Get Balance](#get-balance)
 - [Models](#models)
-  - [Get All Models](#get-all-models)
+  - [Get All Project Models](#get-all-project-models)
   - [Get Model](#get-model)
 - [On-Prem APIs](#on-prem-apis)
   - [List On-Prem credentials](#list-on-prem-credentials)
@@ -79,6 +83,10 @@ Official JavaScript SDK for [Deepgram](https://www.deepgram.com/). Power your ap
   - [Debugging and making changes locally](#debugging-and-making-changes-locally)
 - [Getting Help](#getting-help)
 
+## Documentation
+
+You can learn more about the Deepgram API at [developers.deepgram.com](https://developers.deepgram.com/docs).
+
 ## Migrating from earlier versions
 
 ### V2 to V3
@@ -89,7 +97,9 @@ We have published [a migration guide on our docs](https://developers.deepgram.co
 
 We recommend using only documented interfaces, as we strictly follow semantic versioning (semver) and breaking changes may occur for undocumented interfaces. To ensure compatibility, consider pinning your versions if you need to use undocumented interfaces.
 
-The Agent interfaces have been updated to use the new Voice Agent V1 API.
+### V3.\* to V4
+
+The Voice Agent interfaces have been updated to use the new Voice Agent V1 API. Please refer to our [Documentation](https://developers.deepgram.com/docs/voice-agent-v1-migration) on Migration to new V1 Agent API.
 
 ## Installation
 
@@ -143,6 +153,8 @@ You can now use type="module" `<script>`s to import deepgram from CDNs, like:
 
 ## Initialization
 
+All of the examples below will require createClient.
+
 ```js
 import { createClient } from "@deepgram/sdk";
 // - or -
@@ -270,10 +282,12 @@ const deepgram = createClient("proxy", {
 });
 ```
 
-## Transcription (Synchronous)
+## Pre-Recorded (Synchronous)
 
 ### Remote Files
 
+Transcribe audio from a URL.
+
 ```js
 const { result, error } = await deepgram.listen.prerecorded.transcribeUrl(
   {
@@ -285,10 +299,12 @@ const { result, error } = await deepgram.listen.prerecorded.transcribeUrl(
 );
 ```
 
-[See our API reference for more info](https://developers.deepgram.com/reference/pre-recorded).
+[See our API reference for more info](https://developers.deepgram.com/reference/speech-to-text-api/listen).
 
 ### Local Files
 
+Transcribe audio from a file.
+
 ```js
 const { result, error } = await deepgram.listen.prerecorded.transcribeFile(
   fs.createReadStream("./examples/spacewalk.wav"),
@@ -309,12 +325,33 @@ const { result, error } = await deepgram.listen.prerecorded.transcribeFile(
 );
 ```
 
-[See our API reference for more info](https://developers.deepgram.com/reference/pre-recorded).
+[See our API reference for more info](https://developers.deepgram.com/reference/speech-to-text-api/listen).
+
+### Browser
 
-## Transcription (Asynchronous / Callbacks)
+Transcribe audio from a file in the browser.
+
+```js
+const transcribeFile = async () => {
+  const { result, error } = await _deepgram.listen.prerecorded.transcribeFile(
+    fs.readFileSync("./examples/nasa.mp4"),
+    {
+      model: "nova",
+    }
+  );
+};
+```
+
+[See our API reference for more info](https://developers.deepgram.com/reference/speech-to-text-api/listen).
+
+[See our Example for more info](./examples/browser-prerecorded/index.html).
+
+## Pre-Recorded (Asynchronous / Callbacks)
 
 ### Remote Files
 
+Transcribe audio from a URL.
+
 ```js
 import { CallbackUrl } from "@deepgram/sdk";
 
@@ -329,10 +366,14 @@ const { result, error } = await deepgram.listen.prerecorded.transcribeUrlCallbac
 );
 ```
 
-[See our API reference for more info](https://developers.deepgram.com/reference/pre-recorded).
+[See our API reference for more info](https://developers.deepgram.com/reference/speech-to-text-api/listen).
+
+[See our Example for more info](./examples/node-prerecorded/index.js).
 
 ### Local Files
 
+Transcribe audio from a file.
+
 ```js
 import { CallbackUrl } from "@deepgram/sdk";
 
@@ -359,11 +400,34 @@ const { result, error } = await deepgram.listen.prerecorded.transcribeFileCallba
 );
 ```
 
-[See our API reference for more info](https://developers.deepgram.com/reference/pre-recorded).
+[See our API reference for more info](https://developers.deepgram.com/reference/speech-to-text-api/listen).
 
-## Transcription (Live / Streaming)
+### Browser
 
-### Live Audio
+Transcribe audio from a URL in the browser.
+
+```js
+// browser code
+const transcribeUrl = async () => {
+  const { result, error } = await _deepgram.listen.prerecorded.transcribeUrl(
+    {
+      url: "https://dpgr.am/spacewalk.wav",
+    },
+    {
+      model: "nova",
+    }
+  );
+};
+// browser code
+```
+
+[See our API reference for more info](https://developers.deepgram.com/reference/speech-to-text-api/listen).
+
+[See our Example for more info](./examples/browser-prerecorded/index.html).
+
+## Streaming Audio
+
+Transcribe streaming audio.
 
 ```js
 const dgConnection = deepgram.listen.live({ model: "nova" });
@@ -379,12 +443,38 @@ dgConnection.on(LiveTranscriptionEvents.Open, () => {
 });
 ```
 
-To see an example, [check out our Node.js example](https://github.com/deepgram-devs/node-live-example) or our [Browser example](https://github.com/deepgram-devs/js-live-example).
+[See our API reference for more info](https://developers.deepgram.com/reference/speech-to-text-api/listen-streaming).
+
+[See our Example for more info](https://github.com/deepgram-devs/node-live-example).
+
+### Browser
+
+Transcribe streaming audio in the browser.
+
+```js
+// browser code
+
+const connection = deepgram.listen.live({
+  model: "nova-3",
+  language: "en-US",
+  smart_format: true,
+  interim_results: true,
+  utterance_end_ms: 1000,
+  vad_events: true,
+  endpointing: 300,
+});
+
+// browser code
+```
+
+[See our API reference for more info](https://developers.deepgram.com/reference/speech-to-text-api/listen-streaming).
 
-[See our API reference for more info](https://developers.deepgram.com/reference/streaming).
+[See Our Example for more info](https://github.com/deepgram-devs/js-live-example).
 
 ## Transcribing to captions
 
+Transcribe audio to captions.
+
 ```js
 import { webvtt /* , srt */ } from "@deepgram/captions";
 
@@ -405,6 +495,8 @@ const vttOutput = webvtt(result);
 
 ## Voice Agent
 
+Configure a Voice Agent.
+
 ```js
 import { createClient } from "@deepgram/sdk";
 import { AgentEvents } from "@deepgram/sdk";
@@ -423,27 +515,36 @@ agent.on(AgentEvents.Open, () => {
     audio: {
       input: {
         encoding: "linear16",
-        sampleRate: 16000,
+        sampleRate: 24000,
       },
       output: {
-        encoding: "linear16",
-        container: "wav",
-        sampleRate: 24000,
+        encoding: "mp3",
+        sample_rate: 24000,
+        bitrate: 48000,
+        container: "none",
       },
     },
     agent: {
+      language: "en",
       listen: {
-        model: "nova-3",
-      },
-      speak: {
-        model: "aura-2-thalia-en",
+        provider: {
+          type: "deepgram",
+          model: "nova-3",
+        },
       },
       think: {
         provider: {
-          type: "anthropic",
+          type: "open_ai",
+          model: "gpt-4-mini",
+          temperature: 0.7,
+        },
+        prompt: "You are a helpful AI assistant. Keep responses brief and friendly.",
+      },
+      speak: {
+        provider: {
+          type: "deepgram",
+          model: "aura-2-thalia-en",
         },
-        model: "claude-3-haiku-20240307",
-        instructions: "You are a helpful AI assistant. Keep responses brief and friendly.",
       },
     },
   });
@@ -496,17 +597,23 @@ For a complete implementation, you would need to:
 3. Handle any function calls if your agent uses them
 4. Add proper error handling and connection management
 
-[See our API reference for more info](https://developers.deepgram.com/reference/voice-agent-api/agent)
+[See our API reference for more info](https://developers.deepgram.com/reference/voice-agent-api/agent).
+
+[See our Example for more info](./examples/node-agent-live/index.js).
 
-## Text to Speech
+## Text to Speech Rest
 
-### Rest
+Convert text into speech using the REST API.
 
 ```js
 const { result } = await deepgram.speak.request({ text }, { model: "aura-2-thalia-en" });
 ```
 
-### Websocket
+[See our API reference for more info](https://developers.deepgram.com/reference/text-to-speech-api/speak).
+
+[See our Example for info](./examples/node-speak/index.js)
+
+## Text to Speech Streaming
 
 ```js
 const dgConnection = deepgram.speak.live({ model: "aura-2-thalia-en" });
@@ -526,10 +633,14 @@ dgConnection.on(LiveTTSEvents.Open, () => {
 });
 ```
 
-[See our API reference for more info](https://developers.deepgram.com/reference/text-to-speech-api).
+[See our API reference for more info](https://developers.deepgram.com/reference/text-to-speech-api/speak-streaming).
+
+[See our Example for info](./examples/node-speak-live/index.js).
 
 ## Text Intelligence
 
+Analyze Text.
+
 ```js
 const text = `The history of the phrase 'The quick brown fox jumps over the
 lazy dog'. The earliest known appearance of the phrase was in The Boston
@@ -550,7 +661,9 @@ const { result, error } = await deepgram.read.analyzeText(
 );
 ```
 
-[See our API reference for more info](https://developers.deepgram.com/reference/analyze-text).
+[See our API reference for more info](https://developers.deepgram.com/reference/text-intelligence-api/text-read).
+
+[See our Example for info](./examples/node-read/index.js).
 
 ## Authentication
 
@@ -564,6 +677,19 @@ const { result, error } = await deepgram.manage.getTokenDetails();
 
 [See our API reference for more info](https://developers.deepgram.com/reference/authentication)
 
+### Grant Token
+
+Creates a temporary token with a 30-second TTL.
+
+```js
+const { result, error } = await deepgram.auth.grantToken();
+const deepgramWithToken = createClient({ accessToken: result.access_token });
+```
+
+This example shows how to use the temporary token to authenticate a client instance. Note that you _must_ pass an `accessToken` property to use a temporary token. Passing the token as a raw string will error, as the SDK will treat it as an API key and use the incorrect header prefix.
+
+[See our API reference for more info](https://developers.deepgram.com/reference/token-based-auth-api/grant-token).
+
 ## Projects
 
 ### Get Projects
@@ -596,7 +722,7 @@ const { result, error } = await deepgram.manage.updateProject(projectId, options
 
 [See our API reference for more info](https://developers.deepgram.com/reference/update-project).
 
-## Delete Project
+### Delete Project
 
 Delete a project.
 
@@ -778,6 +904,16 @@ const { result, error } = await deepgram.manage.getProjectUsageFields(projectId,
 
 [See our API reference for more info](https://developers.deepgram.com/reference/get-fields).
 
+### Summarize Usage
+
+`Deprecated` Retrieves the usage for a specific project. Use Get Project Usage Breakdown for a more comprehensive usage summary.
+
+```js
+const { result, error } = await deepgram.manage.getProjectUsage(projectId, options);
+```
+
+[See our API reference for more info](https://developers.deepgram.com/reference/management-api/usage/get).
+
 ## Billing
 
 ### Get All Balances
@@ -802,7 +938,7 @@ const { result, error } = await deepgram.manage.getProjectBalance(projectId, bal
 
 ## Models
 
-### Get All Models
+### Get All Project Models
 
 Retrieves all models available for a given project.
 
@@ -810,7 +946,7 @@ Retrieves all models available for a given project.
 const { result, error } = await deepgram.manage.getAllModels(projectId, {});
 ```
 
-[See our API reference for more info](https://developers.deepgram.com/reference/management-api/models/list)
+[See our API reference for more info](https://developers.deepgram.com/reference/management-api/projects/list-models).
 
 ### Get Model
 
@@ -826,6 +962,8 @@ const { result, error } = await deepgram.manage.getModel(projectId, modelId);
 
 ### List On-Prem credentials
 
+Lists sets of distribution credentials for the specified project.
+
 ```js
 const { result, error } = await deepgram.onprem.listCredentials(projectId);
 ```
@@ -834,6 +972,8 @@ const { result, error } = await deepgram.onprem.listCredentials(projectId);
 
 ### Get On-Prem credentials
 
+Returns a set of distribution credentials for the specified project.
+
 ```js
 const { result, error } = await deepgram.onprem.getCredentials(projectId, credentialId);
 ```
@@ -842,6 +982,8 @@ const { result, error } = await deepgram.onprem.getCredentials(projectId, creden
 
 ### Create On-Prem credentials
 
+Creates a set of distribution credentials for the specified project.
+
 ```js
 const { result, error } = await deepgram.onprem.createCredentials(projectId, options);
 ```
@@ -850,6 +992,8 @@ const { result, error } = await deepgram.onprem.createCredentials(projectId, opt
 
 ### Delete On-Prem credentials
 
+Deletes a set of distribution credentials for the specified project.
+
 ```js
 const { result, error } = await deepgram.onprem.deleteCredentials(projectId, credentialId);
 ```
@@ -858,9 +1002,9 @@ const { result, error } = await deepgram.onprem.deleteCredentials(projectId, cre
 
 ## Backwards Compatibility
 
-Older SDK versions will receive Priority 1 (P1) bug support only. Security issues, both in our code and dependencies, are promptly addressed. Significant bugs without clear workarounds are also given priority attention.
+We follow semantic versioning (semver) to ensure a smooth upgrade experience. Within a major version (like 4._), we will maintain backward compatibility so your code will continue to work without breaking changes. When we release a new major version (like moving from 3._ to 4.\*), we may introduce breaking changes to improve the SDK. We'll always document these changes clearly in our release notes to help you upgrade smoothly.
 
-We strictly follow semver, and will not introduce breaking changes to the publicly documented interfaces of the SDK. **Use internal and undocumented interfaces without pinning your version, at your own risk.**
+Older SDK versions will receive Priority 1 (P1) bug support only. Security issues, both in our code and dependencies, are promptly addressed. Significant bugs without clear workarounds are also given priority attention.
 
 ## Development and Contributing
 

package/dist/main/lib/fetch.d.ts

@@ -6,6 +6,11 @@ import type { Fetch } from "./types";
  * @returns A fetch function that can be used to make HTTP requests.
  */
 export declare const resolveFetch: (customFetch?: Fetch) => Fetch;
+interface FetchWithAuthOptions {
+    apiKey?: string;
+    customFetch?: Fetch;
+    accessToken?: string;
+}
 /**
  * Resolves a fetch function that includes an "Authorization" header with the provided API key.
  *
@@ -13,7 +18,7 @@ export declare const resolveFetch: (customFetch?: Fetch) => Fetch;
  * @param customFetch - An optional custom fetch function to use instead of the global fetch function.
  * @returns A fetch function that can be used to make HTTP requests with the provided API key in the "Authorization" header.
  */
-export declare const fetchWithAuth: (apiKey: string, customFetch?: Fetch) => Fetch;
+export declare const fetchWithAuth: ({ apiKey, customFetch, accessToken, }: Readonly<FetchWithAuthOptions>) => Fetch;
 /**
  * Resolves the appropriate Response object to use, either the global Response object if available, or the Response object from the cross-fetch library if the global Response object is not available.
  *
@@ -25,4 +30,5 @@ export declare const resolveResponse: () => Promise<{
     error(): Response;
     redirect(url: string | URL, status?: number | undefined): Response;
 }>;
+export {};
 //# sourceMappingURL=fetch.d.ts.map

package/dist/main/lib/fetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../src/lib/fetch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC;;;;;GAKG;AACH,eAAO,MAAM,YAAY,iBAAkB,KAAK,KAAG,KAYlD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,WAAY,MAAM,gBAAgB,KAAK,KAAG,KAanE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;EAM3B,CAAC"}
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../src/lib/fetch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC;;;;;GAKG;AACH,eAAO,MAAM,YAAY,iBAAkB,KAAK,KAAG,KAYlD,CAAC;AAEF,UAAU,oBAAoB;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,0CAIvB,SAAS,oBAAoB,CAAC,KAAG,KAanC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;EAM3B,CAAC"}

package/dist/main/lib/fetch.js

@@ -65,13 +65,13 @@ exports.resolveFetch = resolveFetch;
  * @param customFetch - An optional custom fetch function to use instead of the global fetch function.
  * @returns A fetch function that can be used to make HTTP requests with the provided API key in the "Authorization" header.
  */
-const fetchWithAuth = (apiKey, customFetch) => {
+const fetchWithAuth = ({ apiKey, customFetch, accessToken, }) => {
     const fetch = (0, exports.resolveFetch)(customFetch);
     const HeadersConstructor = (0, helpers_1.resolveHeadersConstructor)();
     return (input, init) => __awaiter(void 0, void 0, void 0, function* () {
         const headers = new HeadersConstructor(init === null || init === void 0 ? void 0 : init.headers);
         if (!headers.has("Authorization")) {
-            headers.set("Authorization", `Token ${apiKey}`);
+            headers.set("Authorization", accessToken ? `Bearer ${accessToken}` : `Token ${apiKey}`);
         }
         return fetch(input, Object.assign(Object.assign({}, init), { headers }));
     });

package/dist/main/lib/fetch.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../../src/lib/fetch.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAsD;AACtD,8DAAqC;AAGrC;;;;;GAKG;AACI,MAAM,YAAY,GAAG,CAAC,WAAmB,EAAS,EAAE;IACzD,IAAI,MAAa,CAAC;IAElB,IAAI,WAAW,EAAE;QACf,MAAM,GAAG,WAAW,CAAC;KACtB;SAAM,IAAI,OAAO,KAAK,KAAK,WAAW,EAAE;QACvC,MAAM,GAAG,qBAA8B,CAAC;KACzC;SAAM;QACL,MAAM,GAAG,KAAK,CAAC;KAChB;IAED,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;AACtC,CAAC,CAAC;AAZW,QAAA,YAAY,gBAYvB;AAEF;;;;;;GAMG;AACI,MAAM,aAAa,GAAG,CAAC,MAAc,EAAE,WAAmB,EAAS,EAAE;IAC1E,MAAM,KAAK,GAAG,IAAA,oBAAY,EAAC,WAAW,CAAC,CAAC;IACxC,MAAM,kBAAkB,GAAG,IAAA,mCAAyB,GAAE,CAAC;IAEvD,OAAO,CAAO,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,OAAO,CAAC,CAAC;QAEtD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE;YACjC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;SACjD;QAED,OAAO,KAAK,CAAC,KAAK,kCAAO,IAAI,KAAE,OAAO,IAAG,CAAC;IAC5C,CAAC,CAAA,CAAC;AACJ,CAAC,CAAC;AAbW,QAAA,aAAa,iBAaxB;AAEF;;;;GAIG;AACI,MAAM,eAAe,GAAG,GAAS,EAAE;IACxC,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE;QACnC,OAAO,CAAC,wDAAa,aAAa,GAAC,CAAC,CAAC,QAAQ,CAAC;KAC/C;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAA,CAAC;AANW,QAAA,eAAe,mBAM1B"}
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../../src/lib/fetch.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAsD;AACtD,8DAAqC;AAGrC;;;;;GAKG;AACI,MAAM,YAAY,GAAG,CAAC,WAAmB,EAAS,EAAE;IACzD,IAAI,MAAa,CAAC;IAElB,IAAI,WAAW,EAAE;QACf,MAAM,GAAG,WAAW,CAAC;KACtB;SAAM,IAAI,OAAO,KAAK,KAAK,WAAW,EAAE;QACvC,MAAM,GAAG,qBAA8B,CAAC;KACzC;SAAM;QACL,MAAM,GAAG,KAAK,CAAC;KAChB;IAED,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;AACtC,CAAC,CAAC;AAZW,QAAA,YAAY,gBAYvB;AAQF;;;;;;GAMG;AACI,MAAM,aAAa,GAAG,CAAC,EAC5B,MAAM,EACN,WAAW,EACX,WAAW,GACoB,EAAS,EAAE;IAC1C,MAAM,KAAK,GAAG,IAAA,oBAAY,EAAC,WAAW,CAAC,CAAC;IACxC,MAAM,kBAAkB,GAAG,IAAA,mCAAyB,GAAE,CAAC;IAEvD,OAAO,CAAO,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,OAAO,CAAC,CAAC;QAEtD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE;YACjC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC,CAAC,UAAU,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;SACzF;QAED,OAAO,KAAK,CAAC,KAAK,kCAAO,IAAI,KAAE,OAAO,IAAG,CAAC;IAC5C,CAAC,CAAA,CAAC;AACJ,CAAC,CAAC;AAjBW,QAAA,aAAa,iBAiBxB;AAEF;;;;GAIG;AACI,MAAM,eAAe,GAAG,GAAS,EAAE;IACxC,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE;QACnC,OAAO,CAAC,wDAAa,aAAa,GAAC,CAAC,CAAC,QAAQ,CAAC;KAC/C;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAA,CAAC;AANW,QAAA,eAAe,mBAM1B"}

package/dist/main/lib/types/AgentLiveSchema.d.ts

@@ -73,6 +73,7 @@ interface AgentLiveSchema extends Record<string, unknown> {
                 };
             }[];
             prompt?: string;
+            context_length?: number | "max";
         };
         /**
          * Optional message the agent will say at the start of the connection.

package/dist/main/lib/types/AgentLiveSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentLiveSchema.d.ts","sourceRoot":"","sources":["../../../../src/lib/types/AgentLiveSchema.ts"],"names":[],"mappings":"AAAA,aAAK,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3D;;GAEG;AACH,UAAU,eAAgB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvD;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE;QACL,KAAK,CAAC,EAAE;YACN;;eAEG;YACH,QAAQ,EAAE,MAAM,CAAC;YACjB;;eAEG;YACH,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC;QACF;;WAEG;QACH,MAAM,CAAC,EAAE;YACP,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB;;eAEG;YACH,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC;IACF,KAAK,EAAE;QACL;;;WAGG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE;YACP,QAAQ,EAAE,QAAQ,CAAC;SACpB,CAAC;QACF,KAAK,CAAC,EAAE;YACN,QAAQ,EAAE,QAAQ,CAAC;YACnB,QAAQ,CAAC,EAAE;gBACT,GAAG,EAAE,MAAM,CAAC;gBACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;aAClC,CAAC;SACH,CAAC;QACF;;WAEG;QACH,KAAK,CAAC,EAAE;YACN,QAAQ,EAAE,QAAQ,CAAC;YACnB;;eAEG;YACH,QAAQ,CAAC,EAAE;gBACT,GAAG,EAAE,MAAM,CAAC;gBACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;aAClC,CAAC;YACF,SAAS,CAAC,EAAE;gBACV,IAAI,CAAC,EAAE,MAAM,CAAC;gBACd,WAAW,CAAC,EAAE,MAAM,CAAC;gBACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBACrC,QAAQ,CAAC,EAAE;oBACT,GAAG,CAAC,EAAE,MAAM,CAAC;oBACb,MAAM,CAAC,EAAE,MAAM,CAAC;oBAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;iBAClC,CAAC;aACH,EAAE,CAAC;YACJ,MAAM,CAAC,EAAE,MAAM,CAAC;SACjB,CAAC;QACF;;WAEG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,YAAY,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"AgentLiveSchema.d.ts","sourceRoot":"","sources":["../../../../src/lib/types/AgentLiveSchema.ts"],"names":[],"mappings":"AAAA,aAAK,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3D;;GAEG;AACH,UAAU,eAAgB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvD;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE;QACL,KAAK,CAAC,EAAE;YACN;;eAEG;YACH,QAAQ,EAAE,MAAM,CAAC;YACjB;;eAEG;YACH,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC;QACF;;WAEG;QACH,MAAM,CAAC,EAAE;YACP,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB;;eAEG;YACH,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC;IACF,KAAK,EAAE;QACL;;;WAGG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE;YACP,QAAQ,EAAE,QAAQ,CAAC;SACpB,CAAC;QACF,KAAK,CAAC,EAAE;YACN,QAAQ,EAAE,QAAQ,CAAC;YACnB,QAAQ,CAAC,EAAE;gBACT,GAAG,EAAE,MAAM,CAAC;gBACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;aAClC,CAAC;SACH,CAAC;QACF;;WAEG;QACH,KAAK,CAAC,EAAE;YACN,QAAQ,EAAE,QAAQ,CAAC;YACnB;;eAEG;YACH,QAAQ,CAAC,EAAE;gBACT,GAAG,EAAE,MAAM,CAAC;gBACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;aAClC,CAAC;YACF,SAAS,CAAC,EAAE;gBACV,IAAI,CAAC,EAAE,MAAM,CAAC;gBACd,WAAW,CAAC,EAAE,MAAM,CAAC;gBACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBACrC,QAAQ,CAAC,EAAE;oBACT,GAAG,CAAC,EAAE,MAAM,CAAC;oBACb,MAAM,CAAC,EAAE,MAAM,CAAC;oBAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;iBAClC,CAAC;aACH,EAAE,CAAC;YACJ,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;SACjC,CAAC;QACF;;WAEG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,YAAY,EAAE,eAAe,EAAE,CAAC"}

package/dist/main/lib/types/DeepgramClientOptions.d.ts

@@ -21,7 +21,8 @@ interface ITransport<C, O> {
     options?: O;
 }
 export declare type DefaultNamespaceOptions = {
-    key: string;
+    key?: string | IKeyFactory;
+    accessToken?: string | IKeyFactory;
     fetch: {
         options: {
             url: TransportUrl;
@@ -34,7 +35,8 @@ export declare type DefaultNamespaceOptions = {
     };
 } & NamespaceOptions;
 export interface NamespaceOptions {
-    key?: string;
+    key?: string | IKeyFactory;
+    accessToken?: string | IKeyFactory;
     fetch?: ITransport<IFetch, TransportFetchOptions>;
     websocket?: ITransport<IWebSocket, TransportWebSocketOptions>;
 }
@@ -56,6 +58,7 @@ export declare type DefaultClientOptions = {
  */
 export interface DeepgramClientOptions {
     key?: string | IKeyFactory;
+    accessToken?: string | IKeyFactory;
     global?: NamespaceOptions & {
         url?: string;
         headers?: {

package/dist/main/lib/types/DeepgramClientOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DeepgramClientOptions.d.ts","sourceRoot":"","sources":["../../../../src/lib/types/DeepgramClientOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE9C,oBAAY,WAAW,GAAG,MAAM,MAAM,CAAC;AACvC,oBAAY,MAAM,GAAG,OAAO,KAAK,CAAC;AAClC,oBAAY,UAAU,GAAG,OAAO,SAAS,CAAC;AAE1C,UAAU,qBAAsB,SAAQ,gBAAgB,EAAE,YAAY;CAAG;AACzE,UAAU,yBAA0B,SAAQ,gBAAgB;IAC1D,gBAAgB,CAAC,EAAE;QAAE,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC;CAC7C;AAED,aAAK,YAAY,GAAG,MAAM,CAAC;AAE3B,UAAU,gBAAgB;IACxB,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,KAAK,CAAC,EAAE;QACN,GAAG,EAAE,YAAY,CAAC;KACnB,CAAC;CACH;AAED,UAAU,UAAU,CAAC,CAAC,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,OAAO,CAAC,EAAE,CAAC,CAAC;CACb;AAED,oBAAY,uBAAuB,GAAG;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE;QACL,OAAO,EAAE;YAAE,GAAG,EAAE,YAAY,CAAA;SAAE,CAAC;KAChC,CAAC;IACF,SAAS,EAAE;QACT,OAAO,EAAE;YAAE,GAAG,EAAE,YAAY,CAAA;SAAE,CAAC;KAChC,CAAC;CACH,GAAG,gBAAgB,CAAC;AAErB,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAClD,SAAS,CAAC,EAAE,UAAU,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC;CAC/D;AAED,oBAAY,oBAAoB,GAAG;IACjC,MAAM,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC1C,GAAG,qBAAqB,CAAC;AAE1B;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,MAAM,CAAC,EAAE,gBAAgB,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE;YAAE,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAA;KAAE,CAAC;IACjF,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAEzB;;OAEG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IAErB;;OAEG;IACH,wBAAwB,CAAC,EAAE,KAAK,CAAC;IAEjC;;OAEG;IACH,SAAS,CAAC,EAAE;QACV,GAAG,EAAE,IAAI,GAAG,MAAM,CAAC;KACpB,CAAC;CACH"}
+{"version":3,"file":"DeepgramClientOptions.d.ts","sourceRoot":"","sources":["../../../../src/lib/types/DeepgramClientOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE9C,oBAAY,WAAW,GAAG,MAAM,MAAM,CAAC;AACvC,oBAAY,MAAM,GAAG,OAAO,KAAK,CAAC;AAClC,oBAAY,UAAU,GAAG,OAAO,SAAS,CAAC;AAE1C,UAAU,qBAAsB,SAAQ,gBAAgB,EAAE,YAAY;CAAG;AACzE,UAAU,yBAA0B,SAAQ,gBAAgB;IAC1D,gBAAgB,CAAC,EAAE;QAAE,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC;CAC7C;AAED,aAAK,YAAY,GAAG,MAAM,CAAC;AAE3B,UAAU,gBAAgB;IACxB,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,KAAK,CAAC,EAAE;QACN,GAAG,EAAE,YAAY,CAAC;KACnB,CAAC;CACH;AAED,UAAU,UAAU,CAAC,CAAC,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,OAAO,CAAC,EAAE,CAAC,CAAC;CACb;AAED,oBAAY,uBAAuB,GAAG;IACpC,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IACnC,KAAK,EAAE;QACL,OAAO,EAAE;YAAE,GAAG,EAAE,YAAY,CAAA;SAAE,CAAC;KAChC,CAAC;IACF,SAAS,EAAE;QACT,OAAO,EAAE;YAAE,GAAG,EAAE,YAAY,CAAA;SAAE,CAAC;KAChC,CAAC;CACH,GAAG,gBAAgB,CAAC;AAErB,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IACnC,KAAK,CAAC,EAAE,UAAU,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAClD,SAAS,CAAC,EAAE,UAAU,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC;CAC/D;AAED,oBAAY,oBAAoB,GAAG;IACjC,MAAM,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC1C,GAAG,qBAAqB,CAAC;AAE1B;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IACnC,MAAM,CAAC,EAAE,gBAAgB,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE;YAAE,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAA;KAAE,CAAC;IACjF,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAEzB;;OAEG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IAErB;;OAEG;IACH,wBAAwB,CAAC,EAAE,KAAK,CAAC;IAEjC;;OAEG;IACH,SAAS,CAAC,EAAE;QACV,GAAG,EAAE,IAAI,GAAG,MAAM,CAAC;KACpB,CAAC;CACH"}

package/dist/main/lib/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "4.3.0";
+export declare const version = "4.5.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/main/lib/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.version = void 0;
-exports.version = "4.3.0";
+exports.version = "4.5.0";
 //# sourceMappingURL=version.js.map

package/dist/main/packages/AbstractClient.d.ts

@@ -14,7 +14,8 @@ export declare const noop: () => void;
  */
 export declare abstract class AbstractClient extends EventEmitter {
     protected factory: Function | undefined;
-    protected key: string;
+    protected key: string | undefined;
+    protected accessToken: string | undefined;
     protected options: DefaultClientOptions;
     namespace: string;
     version: string;

package/dist/main/packages/AbstractClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AbstractClient.d.ts","sourceRoot":"","sources":["../../../src/packages/AbstractClient.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EAExB,MAAM,cAAc,CAAC;AAEtB,eAAO,MAAM,IAAI,YAAW,CAAC;AAE7B;;;;;;;;;GASG;AACH,8BAAsB,cAAe,SAAQ,YAAY;IACvD,SAAS,CAAC,OAAO,EAAE,QAAQ,GAAG,SAAS,CAAa;IACpD,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAY;IAC7B,OAAO,EAAE,MAAM,CAAQ;IACvB,OAAO,EAAE,MAAM,CAAe;IAC9B,MAAM,EAAE,QAAQ,CAAQ;IAE/B;;;;;;;;;OASG;gBACS,OAAO,EAAE,qBAAqB;IAiC1C;;;;;OAKG;IACI,CAAC,CAAC,OAAO,GAAE,MAAa,GAAG,IAAI;IAMtC;;;;;;OAMG;IACH,IAAI,gBAAgB,IAAI,uBAAuB,CAU9C;IAED;;;;;;;OAOG;IACI,aAAa,CAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAA8B,EAC7D,oBAAoB,CAAC,EAAE;QACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,GACA,GAAG;IA4BN;;;;OAIG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;CAGjD"}
+{"version":3,"file":"AbstractClient.d.ts","sourceRoot":"","sources":["../../../src/packages/AbstractClient.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EAExB,MAAM,cAAc,CAAC;AAEtB,eAAO,MAAM,IAAI,YAAW,CAAC;AAE7B;;;;;;;;;GASG;AACH,8BAAsB,cAAe,SAAQ,YAAY;IACvD,SAAS,CAAC,OAAO,EAAE,QAAQ,GAAG,SAAS,CAAa;IACpD,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAa;IAC9C,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAa;IACtD,SAAS,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAY;IAC7B,OAAO,EAAE,MAAM,CAAQ;IACvB,OAAO,EAAE,MAAM,CAAe;IAC9B,MAAM,EAAE,QAAQ,CAAQ;IAE/B;;;;;;;;;OASG;gBACS,OAAO,EAAE,qBAAqB;IAwC1C;;;;;OAKG;IACI,CAAC,CAAC,OAAO,GAAE,MAAa,GAAG,IAAI;IAMtC;;;;;;OAMG;IACH,IAAI,gBAAgB,IAAI,uBAAuB,CAU9C;IAED;;;;;;;OAOG;IACI,aAAa,CAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAA8B,EAC7D,oBAAoB,CAAC,EAAE;QACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,GACA,GAAG;IA4BN;;;;OAIG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;CAGjD"}

package/dist/main/packages/AbstractClient.js

@@ -31,25 +31,36 @@ class AbstractClient extends events_1.EventEmitter {
     constructor(options) {
         super();
         this.factory = undefined;
+        this.key = undefined;
+        this.accessToken = undefined;
         this.namespace = "global";
         this.version = "v1";
         this.baseUrl = constants_1.DEFAULT_URL;
         this.logger = exports.noop;
-        let key;
+        // run the factory for the access token if it's a function
+        if (typeof options.accessToken === "function") {
+            this.factory = options.accessToken;
+            this.accessToken = this.factory();
+        }
+        else {
+            this.accessToken = options.accessToken;
+        }
+        // run the factory for the key if it's a function
         if (typeof options.key === "function") {
             this.factory = options.key;
-            key = this.factory();
+            this.key = this.factory();
         }
         else {
-            key = options.key;
+            this.key = options.key;
         }
-        if (!key) {
-            key = process.env.DEEPGRAM_API_KEY;
+        // if we still have neither, try to use the DEEPGRAM_API_KEY environment variable
+        if (!this.key && !this.accessToken) {
+            this.key = process.env.DEEPGRAM_API_KEY;
         }
-        if (!key) {
-            throw new errors_1.DeepgramError("A deepgram API key is required.");
+        // if we STILL have neither, throw an error
+        if (!this.key && !this.accessToken) {
+            throw new errors_1.DeepgramError("A deepgram API key or temporary auth token is required.");
         }
-        this.key = key;
         options = (0, helpers_1.convertLegacyOptions)(options);
         /**
          * Apply default options.