hume 0.15.8 → 0.15.10

package/dist/cjs/api/resources/tts/resources/voices/client/Client.d.ts

@@ -1,20 +1,20 @@
 import type { BaseClientOptions, BaseRequestOptions } from "../../../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "../../../../../../BaseClient.js";
 import * as core from "../../../../../../core/index.js";
 import * as Hume from "../../../../../index.js";
-export declare namespace Voices {
-    interface Options extends BaseClientOptions {
-    }
+export declare namespace VoicesClient {
+    type Options = BaseClientOptions;
     interface RequestOptions extends BaseRequestOptions {
     }
 }
-export declare class Voices {
-    protected readonly _options: Voices.Options;
-    constructor(_options?: Voices.Options);
+export declare class VoicesClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<VoicesClient.Options>;
+    constructor(options?: VoicesClient.Options);
     /**
-     * Lists voices you have saved in your account, or voices from the [Voice Library](https://platform.hume.ai/tts/voice-library).
+     * Lists voices you have saved in your account, or voices from the [Voice Library](https://app.hume.ai/voices).
      *
      * @param {Hume.tts.VoicesListRequest} request
-     * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
+     * @param {VoicesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Hume.tts.BadRequestError}
      *
@@ -23,14 +23,14 @@ export declare class Voices {
      *         provider: "CUSTOM_VOICE"
      *     })
      */
-    list(request: Hume.tts.VoicesListRequest, requestOptions?: Voices.RequestOptions): Promise<core.Page<Hume.tts.ReturnVoice, Hume.tts.ReturnPagedVoices>>;
+    list(request: Hume.tts.VoicesListRequest, requestOptions?: VoicesClient.RequestOptions): Promise<core.Page<Hume.tts.ReturnVoice, Hume.tts.ReturnPagedVoices>>;
     /**
      * Saves a new custom voice to your account using the specified TTS generation ID.
      *
      * Once saved, this voice can be reused in subsequent TTS requests, ensuring consistent speech style and prosody. For more details on voice creation, see the [Voices Guide](/docs/text-to-speech-tts/voices).
      *
      * @param {Hume.tts.PostedVoice} request
-     * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
+     * @param {VoicesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Hume.tts.UnprocessableEntityError}
      *
@@ -40,13 +40,13 @@ export declare class Voices {
      *         name: "David Hume"
      *     })
      */
-    create(request: Hume.tts.PostedVoice, requestOptions?: Voices.RequestOptions): core.HttpResponsePromise<Hume.tts.ReturnVoice>;
+    create(request: Hume.tts.PostedVoice, requestOptions?: VoicesClient.RequestOptions): core.HttpResponsePromise<Hume.tts.ReturnVoice>;
     private __create;
     /**
      * Deletes a previously generated custom voice.
      *
      * @param {Hume.tts.VoicesDeleteRequest} request
-     * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
+     * @param {VoicesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Hume.tts.BadRequestError}
      *
@@ -55,7 +55,6 @@ export declare class Voices {
      *         name: "David Hume"
      *     })
      */
-    delete(request: Hume.tts.VoicesDeleteRequest, requestOptions?: Voices.RequestOptions): core.HttpResponsePromise<void>;
+    delete(request: Hume.tts.VoicesDeleteRequest, requestOptions?: VoicesClient.RequestOptions): core.HttpResponsePromise<void>;
     private __delete;
-    protected _getCustomAuthorizationHeaders(): Promise<Record<string, string | undefined>>;
 }

package/dist/cjs/api/resources/tts/resources/voices/client/Client.js

@@ -43,22 +43,24 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Voices = void 0;
+exports.VoicesClient = void 0;
+const BaseClient_js_1 = require("../../../../../../BaseClient.js");
 const headers_js_1 = require("../../../../../../core/headers.js");
 const core = __importStar(require("../../../../../../core/index.js"));
 const environments = __importStar(require("../../../../../../environments.js"));
+const handleNonStatusCodeError_js_1 = require("../../../../../../errors/handleNonStatusCodeError.js");
 const errors = __importStar(require("../../../../../../errors/index.js"));
 const serializers = __importStar(require("../../../../../../serialization/index.js"));
 const Hume = __importStar(require("../../../../../index.js"));
-class Voices {
-    constructor(_options = {}) {
-        this._options = _options;
+class VoicesClient {
+    constructor(options = {}) {
+        this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
-     * Lists voices you have saved in your account, or voices from the [Voice Library](https://platform.hume.ai/tts/voice-library).
+     * Lists voices you have saved in your account, or voices from the [Voice Library](https://app.hume.ai/voices).
      *
      * @param {Hume.tts.VoicesListRequest} request
-     * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
+     * @param {VoicesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Hume.tts.BadRequestError}
      *
@@ -72,29 +74,18 @@ class Voices {
             const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
                 const { provider, pageNumber, pageSize, ascendingOrder, filterTag } = request;
-                const _queryParams = {};
-                _queryParams.provider = serializers.tts.VoiceProvider.jsonOrThrow(provider, {
-                    unrecognizedObjectKeys: "strip",
-                    omitUndefined: true,
-                });
-                if (pageNumber != null) {
-                    _queryParams.page_number = pageNumber.toString();
-                }
-                if (pageSize != null) {
-                    _queryParams.page_size = pageSize.toString();
-                }
-                if (ascendingOrder != null) {
-                    _queryParams.ascending_order = ascendingOrder.toString();
-                }
-                if (filterTag != null) {
-                    if (Array.isArray(filterTag)) {
-                        _queryParams.filter_tag = filterTag.map((item) => item);
-                    }
-                    else {
-                        _queryParams.filter_tag = filterTag;
-                    }
-                }
-                const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+                const _queryParams = {
+                    provider: serializers.tts.VoiceProvider.jsonOrThrow(provider, {
+                        unrecognizedObjectKeys: "strip",
+                        omitUndefined: true,
+                    }),
+                    page_number: pageNumber,
+                    page_size: pageSize,
+                    ascending_order: ascendingOrder,
+                    filter_tag: filterTag,
+                };
+                const _authRequest = yield this._options.authProvider.getAuthRequest();
+                const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
                 const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
                     url: core.url.join((_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : ((_d = (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.HumeEnvironment.Prod)
                         .base, "v0/tts/voices"),
@@ -137,21 +128,7 @@ class Voices {
                             });
                     }
                 }
-                switch (_response.error.reason) {
-                    case "non-json":
-                        throw new errors.HumeError({
-                            statusCode: _response.error.statusCode,
-                            body: _response.error.rawBody,
-                            rawResponse: _response.rawResponse,
-                        });
-                    case "timeout":
-                        throw new errors.HumeTimeoutError("Timeout exceeded when calling GET /v0/tts/voices.");
-                    case "unknown":
-                        throw new errors.HumeError({
-                            message: _response.error.errorMessage,
-                            rawResponse: _response.rawResponse,
-                        });
-                }
+                return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/tts/voices");
             }));
             let _offset = (request === null || request === void 0 ? void 0 : request.pageNumber) != null ? request === null || request === void 0 ? void 0 : request.pageNumber : 0;
             const dataWithRawResponse = yield list(request).withRawResponse();
@@ -173,7 +150,7 @@ class Voices {
      * Once saved, this voice can be reused in subsequent TTS requests, ensuring consistent speech style and prosody. For more details on voice creation, see the [Voices Guide](/docs/text-to-speech-tts/voices).
      *
      * @param {Hume.tts.PostedVoice} request
-     * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
+     * @param {VoicesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Hume.tts.UnprocessableEntityError}
      *
@@ -189,7 +166,8 @@ class Voices {
     __create(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
                 url: core.url.join((_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : ((_d = (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.HumeEnvironment.Prod).base, "v0/tts/voices"),
                 method: "POST",
@@ -237,28 +215,14 @@ class Voices {
                         });
                 }
             }
-            switch (_response.error.reason) {
-                case "non-json":
-                    throw new errors.HumeError({
-                        statusCode: _response.error.statusCode,
-                        body: _response.error.rawBody,
-                        rawResponse: _response.rawResponse,
-                    });
-                case "timeout":
-                    throw new errors.HumeTimeoutError("Timeout exceeded when calling POST /v0/tts/voices.");
-                case "unknown":
-                    throw new errors.HumeError({
-                        message: _response.error.errorMessage,
-                        rawResponse: _response.rawResponse,
-                    });
-            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v0/tts/voices");
         });
     }
     /**
      * Deletes a previously generated custom voice.
      *
      * @param {Hume.tts.VoicesDeleteRequest} request
-     * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
+     * @param {VoicesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Hume.tts.BadRequestError}
      *
@@ -274,9 +238,11 @@ class Voices {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
             const { name } = request;
-            const _queryParams = {};
-            _queryParams.name = name;
-            const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _queryParams = {
+                name,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
                 url: core.url.join((_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : ((_d = (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.HumeEnvironment.Prod).base, "v0/tts/voices"),
                 method: "DELETE",
@@ -309,28 +275,8 @@ class Voices {
                         });
                 }
             }
-            switch (_response.error.reason) {
-                case "non-json":
-                    throw new errors.HumeError({
-                        statusCode: _response.error.statusCode,
-                        body: _response.error.rawBody,
-                        rawResponse: _response.rawResponse,
-                    });
-                case "timeout":
-                    throw new errors.HumeTimeoutError("Timeout exceeded when calling DELETE /v0/tts/voices.");
-                case "unknown":
-                    throw new errors.HumeError({
-                        message: _response.error.errorMessage,
-                        rawResponse: _response.rawResponse,
-                    });
-            }
-        });
-    }
-    _getCustomAuthorizationHeaders() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const apiKeyValue = yield core.Supplier.get(this._options.apiKey);
-            return { "X-Hume-Api-Key": apiKeyValue };
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "DELETE", "/v0/tts/voices");
         });
     }
 }
-exports.Voices = Voices;
+exports.VoicesClient = VoicesClient;

package/dist/cjs/api/resources/tts/resources/voices/client/requests/PostedVoice.d.ts

@@ -8,6 +8,6 @@
 export interface PostedVoice {
     /** A unique ID associated with this TTS generation that can be used as context for generating consistent speech style and prosody across multiple requests. */
     generationId: string;
-    /** Name of the voice in the `Voice Library`. */
+    /** The name of a **Voice**. */
     name: string;
 }

package/dist/cjs/api/resources/tts/resources/voices/client/requests/VoicesListRequest.d.ts

@@ -9,7 +9,7 @@ export interface VoicesListRequest {
     /**
      * Specify the voice provider to filter voices returned by the endpoint:
      *
-     * - **`HUME_AI`**: Lists preset, shared voices from Hume's [Voice Library](https://platform.hume.ai/tts/voice-library).
+     * - **`HUME_AI`**: Lists preset, shared voices from Hume's [Voice Library](https://app.hume.ai/voices).
      * - **`CUSTOM_VOICE`**: Lists custom voices created and saved to your account.
      */
     provider: Hume.tts.VoiceProvider;

package/dist/cjs/api/resources/tts/types/OctaveVersion.d.ts

@@ -1,9 +1,13 @@
 /**
- * Selects the Octave model version used to synthesize speech for this request. If you omit this field, Hume automatically routes the request to the most appropriate model. Setting a specific version ensures stable and repeatable behavior across requests.
+ * Selects the Octave model version used to synthesize speech for this request. If you omit this field, Hume
+ * automatically routes the request to the most appropriate model. Setting a specific version ensures stable and
+ * repeatable behavior across requests.
  *
- * Use `2` to opt into the latest Octave capabilities. When you specify version `2`, you must also provide a `voice`. Requests that set `version: 2` without a voice will be rejected.
+ * Use `2` to opt into the latest Octave capabilities. When you specify version `2`, you must also provide a
+ * `voice`. Requests that set `version: 2` without a voice will be rejected.
  *
- * For a comparison of Octave versions, see the [Octave versions](/docs/text-to-speech-tts/overview#octave-versions) section in the TTS overview.
+ * For a comparison of Octave versions, see the
+ * [Octave versions](/docs/text-to-speech-tts/overview#octave-versions) section in the TTS overview.
  */
 export declare const OctaveVersion: {
     readonly One: "1";

package/dist/cjs/api/resources/tts/types/OctaveVersion.js

@@ -3,11 +3,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OctaveVersion = void 0;
 /**
- * Selects the Octave model version used to synthesize speech for this request. If you omit this field, Hume automatically routes the request to the most appropriate model. Setting a specific version ensures stable and repeatable behavior across requests.
+ * Selects the Octave model version used to synthesize speech for this request. If you omit this field, Hume
+ * automatically routes the request to the most appropriate model. Setting a specific version ensures stable and
+ * repeatable behavior across requests.
  *
- * Use `2` to opt into the latest Octave capabilities. When you specify version `2`, you must also provide a `voice`. Requests that set `version: 2` without a voice will be rejected.
+ * Use `2` to opt into the latest Octave capabilities. When you specify version `2`, you must also provide a
+ * `voice`. Requests that set `version: 2` without a voice will be rejected.
  *
- * For a comparison of Octave versions, see the [Octave versions](/docs/text-to-speech-tts/overview#octave-versions) section in the TTS overview.
+ * For a comparison of Octave versions, see the
+ * [Octave versions](/docs/text-to-speech-tts/overview#octave-versions) section in the TTS overview.
  */
 exports.OctaveVersion = {
     One: "1",

package/dist/cjs/api/resources/tts/types/PostedTts.d.ts

@@ -38,11 +38,5 @@ export interface PostedTts {
      * For a comparison of Octave versions, see the [Octave versions](/docs/text-to-speech-tts/overview#octave-versions) section in the TTS overview.
      */
     version?: Hume.tts.OctaveVersion;
-    /**
-     * Enables ultra-low latency streaming, significantly reducing the time until the first audio chunk is received. Recommended for real-time applications requiring immediate audio playback. For further details, see our documentation on [instant mode](/docs/text-to-speech-tts/overview#ultra-low-latency-streaming-instant-mode).
-     * - A [voice](/reference/text-to-speech-tts/synthesize-json-streaming#request.body.utterances.voice) must be specified when instant mode is enabled. Dynamic voice generation is not supported with this mode.
-     * - Instant mode is only supported for streaming endpoints (e.g., [/v0/tts/stream/json](/reference/text-to-speech-tts/synthesize-json-streaming), [/v0/tts/stream/file](/reference/text-to-speech-tts/synthesize-file-streaming)).
-     * - Ensure only a single generation is requested ([num_generations](/reference/text-to-speech-tts/synthesize-json-streaming#request.body.num_generations) must be `1` or omitted).
-     */
     instantMode?: boolean;
 }

package/dist/cjs/api/resources/tts/types/PostedUtteranceVoiceWithId.d.ts

@@ -5,7 +5,7 @@ export interface PostedUtteranceVoiceWithId {
     /**
      * Specifies the source provider associated with the chosen voice.
      *
-     * - **`HUME_AI`**: Select voices from Hume's [Voice Library](https://platform.hume.ai/tts/voice-library), containing a variety of preset, shared voices.
+     * - **`HUME_AI`**: Select voices from Hume's [Voice Library](https://app.hume.ai/voices), containing a variety of preset, shared voices.
      * - **`CUSTOM_VOICE`**: Select from voices you've personally generated and saved in your account.
      *
      * If no provider is explicitly set, the default provider is `CUSTOM_VOICE`. When using voices from Hume's **Voice Library**, you must explicitly set the provider to `HUME_AI`.

package/dist/cjs/api/resources/tts/types/PostedUtteranceVoiceWithName.d.ts

@@ -5,7 +5,7 @@ export interface PostedUtteranceVoiceWithName {
     /**
      * Specifies the source provider associated with the chosen voice.
      *
-     * - **`HUME_AI`**: Select voices from Hume's [Voice Library](https://platform.hume.ai/tts/voice-library), containing a variety of preset, shared voices.
+     * - **`HUME_AI`**: Select voices from Hume's [Voice Library](https://app.hume.ai/voices), containing a variety of preset, shared voices.
      * - **`CUSTOM_VOICE`**: Select from voices you've personally generated and saved in your account.
      *
      * If no provider is explicitly set, the default provider is `CUSTOM_VOICE`. When using voices from Hume's **Voice Library**, you must explicitly set the provider to `HUME_AI`.

package/dist/cjs/api/resources/tts/types/PublishTts.d.ts

@@ -5,16 +5,26 @@ import type * as Hume from "../../../index.js";
 export interface PublishTts {
     /** Force the generation of audio and close the stream. */
     close?: boolean;
-    /** Natural language instructions describing how the text should be spoken by the model (e.g., `"a soft, gentle voice with a strong British accent"`). */
+    /**
+     * Natural language instructions describing how the synthesized speech should sound, including but not limited to tone, intonation, pacing, and accent.
+     *
+     * **This field behaves differently depending on whether a voice is specified**:
+     * - **Voice specified**: the description will serve as acting directions for delivery. Keep directions concise—100 characters or fewer—for best results. See our guide on [acting instructions](/docs/text-to-speech-tts/acting-instructions).
+     * - **Voice not specified**: the description will serve as a voice prompt for generating a voice. See our [prompting guide](/docs/text-to-speech-tts/prompting) for design tips.
+     */
     description?: string;
     /** Force the generation of audio regardless of how much text has been supplied. */
     flush?: boolean;
-    /** A relative measure of how fast this utterance should be spoken. */
+    /** Speed multiplier for the synthesized speech. Extreme values below 0.75 and above 1.5 may sometimes cause instability to the generated output. */
     speed?: number;
-    /** The input text to be converted to speech output. */
+    /** The input text to be synthesized into speech. */
     text?: string;
     /** Duration of trailing silence (in seconds) to add to this utterance */
     trailingSilence?: number;
-    /** The name or ID of the voice from the `Voice Library` to be used as the speaker for this and all subsequent utterances, until the `"voice"` field is updated again. */
+    /**
+     * The `name` or `id` associated with a **Voice** from the **Voice Library** to be used as the speaker for this and all subsequent `utterances`, until the `voice` field is updated again.
+     *
+     *  See our [voices guide](/docs/text-to-speech-tts/voices) for more details on generating and specifying **Voices**.
+     */
     voice?: Hume.tts.PostedUtteranceVoice;
 }

package/dist/cjs/api/resources/tts/types/ReturnPagedVoices.d.ts

@@ -3,20 +3,16 @@ import type * as Hume from "../../../index.js";
  * A paginated list Octave voices available for text-to-speech
  */
 export interface ReturnPagedVoices {
-    /**
-     * The page number of the returned list.
-     *
-     * This value corresponds to the `page_number` parameter specified in the request. Pagination uses zero-based indexing.
-     */
-    pageNumber?: number;
+    /** The page number of the returned results. */
+    pageNumber: number;
     /**
      * The maximum number of items returned per page.
      *
      * This value corresponds to the `page_size` parameter specified in the request.
      */
-    pageSize?: number;
+    pageSize: number;
     /** The total number of pages in the collection. */
-    totalPages?: number;
+    totalPages: number;
     /** List of voices returned for the specified `page_number` and `page_size`. */
-    voicesPage?: Hume.tts.ReturnVoice[];
+    voicesPage: Hume.tts.ReturnVoice[];
 }

package/dist/cjs/api/resources/tts/types/ReturnVoice.d.ts

@@ -5,13 +5,13 @@ import type * as Hume from "../../../index.js";
 export interface ReturnVoice {
     compatibleOctaveModels?: string[];
     /** ID of the voice in the `Voice Library`. */
-    id?: string;
+    id: string;
     /** Name of the voice in the `Voice Library`. */
-    name?: string;
+    name: string;
     /**
      * The provider associated with the created voice.
      *
      * Voices created through this endpoint will always have the provider set to `CUSTOM_VOICE`, indicating a custom voice stored in your account.
      */
-    provider?: Hume.tts.VoiceProvider;
+    provider: Hume.tts.VoiceProvider;
 }

package/dist/cjs/auth/HeaderAuthProvider.d.ts

@@ -0,0 +1,26 @@
+/**
+ * THIS FILE IS MANUALLY MAINTAINED: see .fernignore
+ *
+ * Custom HeaderAuthProvider that supports both apiKey and accessToken authentication.
+ * When accessToken is provided to HumeClient, the wrapper converts it to an
+ * Authorization: Bearer header. This provider checks for both apiKey and the
+ * Authorization header to support both auth methods.
+ */
+import * as core from "../core/index.js";
+export declare namespace HeaderAuthProvider {
+    type AuthOptions = {
+        apiKey?: core.Supplier<string | undefined>;
+    };
+    type Options = {
+        headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
+    } & AuthOptions;
+}
+export declare class HeaderAuthProvider implements core.AuthProvider {
+    private readonly options;
+    constructor(options: HeaderAuthProvider.Options);
+    static canCreate(options: HeaderAuthProvider.Options): boolean;
+    private static hasAuthorizationHeader;
+    getAuthRequest(_arg?: {
+        endpointMetadata?: core.EndpointMetadata;
+    }): Promise<core.AuthRequest>;
+}

package/dist/cjs/auth/HeaderAuthProvider.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * THIS FILE IS MANUALLY MAINTAINED: see .fernignore
+ *
+ * Custom HeaderAuthProvider that supports both apiKey and accessToken authentication.
+ * When accessToken is provided to HumeClient, the wrapper converts it to an
+ * Authorization: Bearer header. This provider checks for both apiKey and the
+ * Authorization header to support both auth methods.
+ */
+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.HeaderAuthProvider = void 0;
+const core = __importStar(require("../core/index.js"));
+const errors = __importStar(require("../errors/index.js"));
+class HeaderAuthProvider {
+    constructor(options) {
+        this.options = options;
+    }
+    static canCreate(options) {
+        return options.apiKey != null || HeaderAuthProvider.hasAuthorizationHeader(options.headers);
+    }
+    static hasAuthorizationHeader(headers) {
+        if (!headers)
+            return false;
+        return Object.keys(headers).some((key) => key.toLowerCase() === "authorization");
+    }
+    getAuthRequest(_arg) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Check apiKey first (preferred method)
+            const apiKey = yield core.Supplier.get(this.options.apiKey);
+            if (apiKey != null) {
+                return { headers: { "X-Hume-Api-Key": apiKey } };
+            }
+            // Check for Authorization header (from accessToken)
+            if (this.options.headers) {
+                const authKey = Object.keys(this.options.headers).find((key) => key.toLowerCase() === "authorization");
+                if (authKey) {
+                    const authValue = yield core.Supplier.get(this.options.headers[authKey]);
+                    if (authValue != null) {
+                        return { headers: { Authorization: authValue } };
+                    }
+                }
+            }
+            throw new errors.HumeError({
+                message: "Please provide either 'apiKey' or 'accessToken' when initializing the client",
+            });
+        });
+    }
+}
+exports.HeaderAuthProvider = HeaderAuthProvider;

package/dist/cjs/auth/index.d.ts

@@ -0,0 +1 @@
+export { HeaderAuthProvider } from "./HeaderAuthProvider.js";

package/dist/cjs/auth/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HeaderAuthProvider = void 0;
+var HeaderAuthProvider_js_1 = require("./HeaderAuthProvider.js");
+Object.defineProperty(exports, "HeaderAuthProvider", { enumerable: true, get: function () { return HeaderAuthProvider_js_1.HeaderAuthProvider; } });

package/dist/cjs/core/auth/AuthProvider.d.ts

@@ -0,0 +1,7 @@
+import type { EndpointMetadata } from "../fetcher/EndpointMetadata.js";
+import type { AuthRequest } from "./AuthRequest.js";
+export interface AuthProvider {
+    getAuthRequest(arg?: {
+        endpointMetadata?: EndpointMetadata;
+    }): Promise<AuthRequest>;
+}

package/dist/cjs/core/auth/AuthProvider.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/core/auth/AuthRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Request parameters for authentication requests.
+ */
+export interface AuthRequest {
+    /**
+     * The headers to be included in the request.
+     */
+    headers: Record<string, string>;
+}

package/dist/cjs/core/auth/AuthRequest.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/core/auth/BasicAuth.d.ts

@@ -0,0 +1,8 @@
+export interface BasicAuth {
+    username: string;
+    password: string;
+}
+export declare const BasicAuth: {
+    toAuthorizationHeader: (basicAuth: BasicAuth | undefined) => string | undefined;
+    fromAuthorizationHeader: (header: string) => BasicAuth;
+};

package/dist/cjs/core/auth/BasicAuth.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BasicAuth = void 0;
+const base64_js_1 = require("../base64.js");
+const BASIC_AUTH_HEADER_PREFIX = /^Basic /i;
+exports.BasicAuth = {
+    toAuthorizationHeader: (basicAuth) => {
+        if (basicAuth == null) {
+            return undefined;
+        }
+        const token = (0, base64_js_1.base64Encode)(`${basicAuth.username}:${basicAuth.password}`);
+        return `Basic ${token}`;
+    },
+    fromAuthorizationHeader: (header) => {
+        const credentials = header.replace(BASIC_AUTH_HEADER_PREFIX, "");
+        const decoded = (0, base64_js_1.base64Decode)(credentials);
+        const [username, ...passwordParts] = decoded.split(":");
+        const password = passwordParts.length > 0 ? passwordParts.join(":") : undefined;
+        if (username == null || password == null) {
+            throw new Error("Invalid basic auth");
+        }
+        return {
+            username,
+            password,
+        };
+    },
+};

package/dist/cjs/core/auth/BearerToken.d.ts

@@ -0,0 +1,7 @@
+export type BearerToken = string;
+declare function toAuthorizationHeader(token: string | undefined): string | undefined;
+export declare const BearerToken: {
+    toAuthorizationHeader: typeof toAuthorizationHeader;
+    fromAuthorizationHeader: (header: string) => BearerToken;
+};
+export {};