@deepgram/sdk 5.0.0 → 5.2.0

package/dist/cjs/api/types/DeleteAgentVariableV1Response.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -6,4 +6,17 @@ export interface Groq {
     model: "openai/gpt-oss-20b";
     /** Groq temperature (0-2) */
     temperature?: number | undefined;
+    /** OpenAI reasoning_effort */
+    reasoning_mode?: Groq.ReasoningMode | undefined;
+}
+export declare namespace Groq {
+    /** OpenAI reasoning_effort */
+    const ReasoningMode: {
+        readonly None: "none";
+        readonly Minimal: "minimal";
+        readonly Low: "low";
+        readonly Medium: "medium";
+        readonly High: "high";
+    };
+    type ReasoningMode = (typeof ReasoningMode)[keyof typeof ReasoningMode] | string;
 }

package/dist/cjs/api/types/Groq.js

@@ -1,3 +1,15 @@
 "use strict";
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.Groq = void 0;
+var Groq;
+(function (Groq) {
+    /** OpenAI reasoning_effort */
+    Groq.ReasoningMode = {
+        None: "none",
+        Minimal: "minimal",
+        Low: "low",
+        Medium: "medium",
+        High: "high",
+    };
+})(Groq || (exports.Groq = Groq = {}));

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

@@ -0,0 +1,5 @@
+import type * as Deepgram from "../index.js";
+export interface ListAgentConfigurationsV1Response {
+    /** A list of agent configurations for the project */
+    agents?: Deepgram.AgentConfigurationV1[] | undefined;
+}

package/dist/cjs/api/types/ListAgentConfigurationsV1Response.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,5 @@
+import type * as Deepgram from "../index.js";
+export interface ListAgentVariablesV1Response {
+    /** A list of agent variables for the project */
+    variables?: Deepgram.AgentVariableV1[] | undefined;
+}

package/dist/cjs/api/types/ListAgentVariablesV1Response.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -7,7 +7,11 @@ export declare namespace ListProjectMembersV1Response {
         interface Item {
             /** The unique identifier of the member */
             member_id?: string | undefined;
+            /** The API scopes of the member */
+            scopes?: string[] | undefined;
             email?: string | undefined;
+            first_name?: string | undefined;
+            last_name?: string | undefined;
         }
     }
 }

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

@@ -1 +1,4 @@
+/**
+ * URL to which we'll make the callback request
+ */
 export type ListenV1Callback = unknown;

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

@@ -1 +1,4 @@
+/**
+ * The number of channels in the submitted audio
+ */
 export type ListenV1Channels = unknown;

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

@@ -1 +1,4 @@
+/**
+ * Indicates how long Deepgram will wait to detect whether a speaker has finished speaking or pauses for a significant period of time. When set to a value, the streaming endpoint immediately finalizes the transcription for the processed time range and returns the transcript with a speech_final parameter set to true. Can also be set to false to disable endpointing
+ */
 export type ListenV1Endpointing = unknown;

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

@@ -1 +1,4 @@
+/**
+ * Arbitrary key-value pairs that are attached to the API response for usage in downstream processing
+ */
 export type ListenV1Extra = unknown;

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

@@ -1 +1,4 @@
+/**
+ * Key term prompting can boost specialized terminology and brands. Only compatible with Nova-3
+ */
 export type ListenV1Keyterm = unknown;

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

@@ -1 +1,4 @@
+/**
+ * Keywords can boost or suppress specialized terminology and brands
+ */
 export type ListenV1Keywords = unknown;

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

@@ -1 +1,4 @@
+/**
+ * The [BCP-47 language tag](https://tools.ietf.org/html/bcp47) that hints at the primary spoken language. Depending on the Model you choose only certain languages are available
+ */
 export type ListenV1Language = unknown;

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

@@ -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 ListenV1MipOptOut = unknown;

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

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

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

@@ -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/cjs/api/types/ListenV1Search.d.ts

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

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

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

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

@@ -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/cjs/api/types/ListenV1Version.d.ts

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

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

@@ -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/cjs/api/types/ListenV2EotThreshold.d.ts

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

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

@@ -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/cjs/api/types/ListenV2LanguageHint.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Language hints constrain and prioritize language detection for the
+ * flux-general-multi model. Pass multiple language_hint query parameters
+ * to specify multiple language codes. Empty values are rejected.
+ * Only valid when model is flux-general-multi.
+ */
+export type ListenV2LanguageHint = string | string[];

package/dist/cjs/api/types/ListenV2LanguageHint.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -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/cjs/api/types/ListenV2Model.d.ts

@@ -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/cjs/api/types/ListenV2Model.js

@@ -1,3 +1,9 @@
 "use strict";
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListenV2Model = void 0;
+/** Defines the AI model used to process submitted audio. */
+exports.ListenV2Model = {
+    FluxGeneralEn: "flux-general-en",
+    FluxGeneralMulti: "flux-general-multi",
+};

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

@@ -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/cjs/api/types/ListenV2Tag.d.ts

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

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

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

package/dist/cjs/api/types/OpenAiThinkProvider.js

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

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

@@ -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;

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

@@ -0,0 +1,4 @@
+/**
+ * Speaking rate multiplier that adjusts the pace of generated speech while preserving natural prosody and voice quality. Not yet supported in all languages.
+ */
+export type SpeakV1Speed = number;

package/dist/cjs/api/types/SpeakV1Speed.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -44,12 +44,11 @@ export declare namespace UsageBreakdownV1Response {
                 endpoint?: string | undefined;
                 /** Optional feature set identifier */
                 feature_set?: string | undefined;
-                /** Optional models identifier */
-                models?: string | undefined;
+                models?: (string | undefined)[] | undefined;
                 /** Optional method identifier */
                 method?: string | undefined;
-                /** Optional tags */
-                tags?: string | undefined;
+                /** Optional list of tags, null unless grouped by tags. */
+                tags?: string[] | undefined;
                 /** Optional deployment identifier */
                 deployment?: string | undefined;
             }

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

@@ -1,14 +1,19 @@
+export * from "./AgentConfigurationV1.js";
 export * from "./AgentThinkModelsV1Response.js";
+export * from "./AgentVariableV1.js";
 export * from "./Anthropic.js";
 export * from "./AwsBedrockThinkProvider.js";
 export * from "./AwsPollySpeakProvider.js";
 export * from "./BillingBreakdownV1Response.js";
 export * from "./Cartesia.js";
-export * from "./CreateKeyV1RequestOne.js";
+export * from "./CreateAgentConfigurationV1Response.js";
+export * from "./CreateKeyV1Request.js";
 export * from "./CreateKeyV1Response.js";
 export * from "./CreateProjectDistributionCredentialsV1Response.js";
 export * from "./CreateProjectInviteV1Response.js";
 export * from "./Deepgram.js";
+export * from "./DeleteAgentConfigurationV1Response.js";
+export * from "./DeleteAgentVariableV1Response.js";
 export * from "./DeleteProjectInviteV1Response.js";
 export * from "./DeleteProjectKeyV1Response.js";
 export * from "./DeleteProjectMemberV1Response.js";
@@ -28,6 +33,8 @@ export * from "./Google.js";
 export * from "./GrantV1Response.js";
 export * from "./Groq.js";
 export * from "./LeaveProjectV1Response.js";
+export * from "./ListAgentConfigurationsV1Response.js";
+export * from "./ListAgentVariablesV1Response.js";
 export * from "./ListBillingFieldsV1Response.js";
 export * from "./ListenV1AcceptedResponse.js";
 export * from "./ListenV1Callback.js";
@@ -72,6 +79,7 @@ export * from "./ListenV2Encoding.js";
 export * from "./ListenV2EotThreshold.js";
 export * from "./ListenV2EotTimeoutMs.js";
 export * from "./ListenV2Keyterm.js";
+export * from "./ListenV2LanguageHint.js";
 export * from "./ListenV2MipOptOut.js";
 export * from "./ListenV2Model.js";
 export * from "./ListenV2SampleRate.js";
@@ -108,6 +116,7 @@ export * from "./SpeakV1MipOptOut.js";
 export * from "./SpeakV1Model.js";
 export * from "./SpeakV1Response.js";
 export * from "./SpeakV1SampleRate.js";
+export * from "./SpeakV1Speed.js";
 export * from "./ThinkSettingsV1.js";
 export * from "./ThinkSettingsV1Provider.js";
 export * from "./UpdateProjectMemberScopesV1Response.js";

package/dist/cjs/api/types/index.js

@@ -14,17 +14,22 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./AgentConfigurationV1.js"), exports);
 __exportStar(require("./AgentThinkModelsV1Response.js"), exports);
+__exportStar(require("./AgentVariableV1.js"), exports);
 __exportStar(require("./Anthropic.js"), exports);
 __exportStar(require("./AwsBedrockThinkProvider.js"), exports);
 __exportStar(require("./AwsPollySpeakProvider.js"), exports);
 __exportStar(require("./BillingBreakdownV1Response.js"), exports);
 __exportStar(require("./Cartesia.js"), exports);
-__exportStar(require("./CreateKeyV1RequestOne.js"), exports);
+__exportStar(require("./CreateAgentConfigurationV1Response.js"), exports);
+__exportStar(require("./CreateKeyV1Request.js"), exports);
 __exportStar(require("./CreateKeyV1Response.js"), exports);
 __exportStar(require("./CreateProjectDistributionCredentialsV1Response.js"), exports);
 __exportStar(require("./CreateProjectInviteV1Response.js"), exports);
 __exportStar(require("./Deepgram.js"), exports);
+__exportStar(require("./DeleteAgentConfigurationV1Response.js"), exports);
+__exportStar(require("./DeleteAgentVariableV1Response.js"), exports);
 __exportStar(require("./DeleteProjectInviteV1Response.js"), exports);
 __exportStar(require("./DeleteProjectKeyV1Response.js"), exports);
 __exportStar(require("./DeleteProjectMemberV1Response.js"), exports);
@@ -44,6 +49,8 @@ __exportStar(require("./Google.js"), exports);
 __exportStar(require("./GrantV1Response.js"), exports);
 __exportStar(require("./Groq.js"), exports);
 __exportStar(require("./LeaveProjectV1Response.js"), exports);
+__exportStar(require("./ListAgentConfigurationsV1Response.js"), exports);
+__exportStar(require("./ListAgentVariablesV1Response.js"), exports);
 __exportStar(require("./ListBillingFieldsV1Response.js"), exports);
 __exportStar(require("./ListenV1AcceptedResponse.js"), exports);
 __exportStar(require("./ListenV1Callback.js"), exports);
@@ -88,6 +95,7 @@ __exportStar(require("./ListenV2Encoding.js"), exports);
 __exportStar(require("./ListenV2EotThreshold.js"), exports);
 __exportStar(require("./ListenV2EotTimeoutMs.js"), exports);
 __exportStar(require("./ListenV2Keyterm.js"), exports);
+__exportStar(require("./ListenV2LanguageHint.js"), exports);
 __exportStar(require("./ListenV2MipOptOut.js"), exports);
 __exportStar(require("./ListenV2Model.js"), exports);
 __exportStar(require("./ListenV2SampleRate.js"), exports);
@@ -124,6 +132,7 @@ __exportStar(require("./SpeakV1MipOptOut.js"), exports);
 __exportStar(require("./SpeakV1Model.js"), exports);
 __exportStar(require("./SpeakV1Response.js"), exports);
 __exportStar(require("./SpeakV1SampleRate.js"), exports);
+__exportStar(require("./SpeakV1Speed.js"), exports);
 __exportStar(require("./ThinkSettingsV1.js"), exports);
 __exportStar(require("./ThinkSettingsV1Provider.js"), exports);
 __exportStar(require("./UpdateProjectMemberScopesV1Response.js"), exports);

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

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

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

@@ -5,10 +5,16 @@ const base64_js_1 = require("../base64.js");
 const BASIC_AUTH_HEADER_PREFIX = /^Basic /i;
 exports.BasicAuth = {
     toAuthorizationHeader: (basicAuth) => {
+        var _a, _b;
         if (basicAuth == null) {
             return undefined;
         }
-        const token = (0, base64_js_1.base64Encode)(`${basicAuth.username}:${basicAuth.password}`);
+        const username = (_a = basicAuth.username) !== null && _a !== void 0 ? _a : "";
+        const password = (_b = basicAuth.password) !== null && _b !== void 0 ? _b : "";
+        if (username === "" && password === "") {
+            return undefined;
+        }
+        const token = (0, base64_js_1.base64Encode)(`${username}:${password}`);
         return `Basic ${token}`;
     },
     fromAuthorizationHeader: (header) => {

package/dist/cjs/core/fetcher/BinaryResponse.d.ts

@@ -14,6 +14,6 @@ export type BinaryResponse = {
      * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes)
      * Some versions of the Fetch API may not support this method.
      */
-    bytes?(): ReturnType<Response["bytes"]>;
+    bytes?(): Promise<Uint8Array>;
 };
 export declare function getBinaryResponse(response: Response): BinaryResponse;

package/dist/cjs/core/fetcher/Fetcher.d.ts

@@ -8,7 +8,13 @@ export declare namespace Fetcher {
         method: string;
         contentType?: string;
         headers?: Record<string, unknown>;
+        /**
+         * @deprecated Prefer `queryString` (produced by `core.url.queryBuilder()`).
+         * Retained for backwards compatibility with custom fetchers and callers that
+         * still construct request args with a query-parameter object.
+         */
         queryParameters?: Record<string, unknown>;
+        queryString?: string;
         body?: unknown;
         timeoutMs?: number;
         maxRetries?: number;
@@ -38,10 +44,12 @@ export declare namespace Fetcher {
     }
     interface TimeoutError {
         reason: "timeout";
+        cause?: unknown;
     }
     interface UnknownError {
         reason: "unknown";
         errorMessage: string;
+        cause?: unknown;
     }
 }
 export declare function fetcherImpl<R = unknown>(args: Fetcher.Args): Promise<APIResponse<R, Fetcher.Error>>;

package/dist/cjs/core/fetcher/Fetcher.js

@@ -75,16 +75,11 @@ const SENSITIVE_QUERY_PARAMS = new Set([
 ]);
 function redactQueryParameters(queryParameters) {
     if (queryParameters == null) {
-        return queryParameters;
+        return undefined;
     }
     const redacted = {};
     for (const [key, value] of Object.entries(queryParameters)) {
-        if (SENSITIVE_QUERY_PARAMS.has(key.toLowerCase())) {
-            redacted[key] = "[REDACTED]";
-        }
-        else {
-            redacted[key] = value;
-        }
+        redacted[key] = SENSITIVE_QUERY_PARAMS.has(key.toLowerCase()) ? "[REDACTED]" : value;
     }
     return redacted;
 }
@@ -186,7 +181,13 @@ function getHeaders(args) {
 function fetcherImpl(args) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a, _b, _c;
-        const url = (0, createRequestUrl_js_1.createRequestUrl)(args.url, args.queryParameters);
+        let url = args.url;
+        if (args.queryString != null && args.queryString.length > 0) {
+            url = `${url}?${args.queryString}`;
+        }
+        else {
+            url = (0, createRequestUrl_js_1.createRequestUrl)(args.url, args.queryParameters);
+        }
         const requestBody = yield (0, getRequestBody_js_1.getRequestBody)({
             body: args.body,
             type: (_a = args.requestType) !== null && _a !== void 0 ? _a : "other",
@@ -261,6 +262,7 @@ function fetcherImpl(args) {
                     error: {
                         reason: "unknown",
                         errorMessage: "The user aborted a request",
+                        cause: error,
                     },
                     rawResponse: RawResponse_js_1.abortRawResponse,
                 };
@@ -278,6 +280,7 @@ function fetcherImpl(args) {
                     ok: false,
                     error: {
                         reason: "timeout",
+                        cause: error,
                     },
                     rawResponse: RawResponse_js_1.abortRawResponse,
                 };
@@ -296,6 +299,7 @@ function fetcherImpl(args) {
                     error: {
                         reason: "unknown",
                         errorMessage: error.message,
+                        cause: error,
                     },
                     rawResponse: RawResponse_js_1.unknownRawResponse,
                 };
@@ -313,6 +317,7 @@ function fetcherImpl(args) {
                 error: {
                     reason: "unknown",
                     errorMessage: (0, json_js_1.toJson)(error),
+                    cause: error,
                 },
                 rawResponse: RawResponse_js_1.unknownRawResponse,
             };

package/dist/cjs/core/fetcher/index.d.ts

@@ -6,6 +6,8 @@ export type { Fetcher, FetchFunction } from "./Fetcher.js";
 export { fetcher } from "./Fetcher.js";
 export { getHeader } from "./getHeader.js";
 export { HttpResponsePromise } from "./HttpResponsePromise.js";
+export type { PassthroughRequest } from "./makePassthroughRequest.js";
+export { makePassthroughRequest } from "./makePassthroughRequest.js";
 export type { RawResponse, WithRawResponse } from "./RawResponse.js";
 export { abortRawResponse, toRawResponse, unknownRawResponse } from "./RawResponse.js";
 export { Supplier } from "./Supplier.js";

package/dist/cjs/core/fetcher/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Supplier = exports.unknownRawResponse = exports.toRawResponse = exports.abortRawResponse = exports.HttpResponsePromise = exports.getHeader = exports.fetcher = exports.EndpointSupplier = void 0;
+exports.Supplier = exports.unknownRawResponse = exports.toRawResponse = exports.abortRawResponse = exports.makePassthroughRequest = exports.HttpResponsePromise = exports.getHeader = exports.fetcher = exports.EndpointSupplier = void 0;
 var EndpointSupplier_js_1 = require("./EndpointSupplier.js");
 Object.defineProperty(exports, "EndpointSupplier", { enumerable: true, get: function () { return EndpointSupplier_js_1.EndpointSupplier; } });
 var Fetcher_js_1 = require("./Fetcher.js");
@@ -9,6 +9,8 @@ var getHeader_js_1 = require("./getHeader.js");
 Object.defineProperty(exports, "getHeader", { enumerable: true, get: function () { return getHeader_js_1.getHeader; } });
 var HttpResponsePromise_js_1 = require("./HttpResponsePromise.js");
 Object.defineProperty(exports, "HttpResponsePromise", { enumerable: true, get: function () { return HttpResponsePromise_js_1.HttpResponsePromise; } });
+var makePassthroughRequest_js_1 = require("./makePassthroughRequest.js");
+Object.defineProperty(exports, "makePassthroughRequest", { enumerable: true, get: function () { return makePassthroughRequest_js_1.makePassthroughRequest; } });
 var RawResponse_js_1 = require("./RawResponse.js");
 Object.defineProperty(exports, "abortRawResponse", { enumerable: true, get: function () { return RawResponse_js_1.abortRawResponse; } });
 Object.defineProperty(exports, "toRawResponse", { enumerable: true, get: function () { return RawResponse_js_1.toRawResponse; } });

package/dist/cjs/core/fetcher/makePassthroughRequest.d.ts

@@ -0,0 +1,49 @@
+import { type LogConfig, type Logger } from "../logging/logger.js";
+import { Supplier } from "./Supplier.js";
+export declare namespace PassthroughRequest {
+    /**
+     * Per-request options that can override the SDK client defaults.
+     */
+    interface RequestOptions {
+        /** Override the default timeout for this request (in seconds). */
+        timeoutInSeconds?: number;
+        /** Override the default number of retries for this request. */
+        maxRetries?: number;
+        /** Additional headers to include in this request. */
+        headers?: Record<string, string>;
+        /** Abort signal for this request. */
+        abortSignal?: AbortSignal;
+    }
+    /**
+     * SDK client configuration used by the passthrough fetch method.
+     */
+    interface ClientOptions {
+        /** The base URL or environment for the client. */
+        environment?: Supplier<string>;
+        /** Override the base URL. */
+        baseUrl?: Supplier<string>;
+        /** Default headers to include in requests. */
+        headers?: Record<string, unknown>;
+        /** Default maximum time to wait for a response in seconds. */
+        timeoutInSeconds?: number;
+        /** Default number of times to retry the request. Defaults to 2. */
+        maxRetries?: number;
+        /** A custom fetch function. */
+        fetch?: typeof fetch;
+        /** Logging configuration. */
+        logging?: LogConfig | Logger;
+        /** A function that returns auth headers. */
+        getAuthHeaders?: () => Promise<Record<string, string>>;
+    }
+}
+/**
+ * Makes a passthrough HTTP request using the SDK's configuration (auth, retry, logging, etc.)
+ * while mimicking the standard `fetch` API.
+ *
+ * @param input - The URL, path, or Request object. If a relative path, it will be resolved against the configured base URL.
+ * @param init - Standard RequestInit options (method, headers, body, signal, etc.)
+ * @param clientOptions - SDK client options (auth, default headers, logging, etc.)
+ * @param requestOptions - Per-request overrides (timeout, retries, extra headers, abort signal).
+ * @returns A standard Response object.
+ */
+export declare function makePassthroughRequest(input: Request | string | URL, init: RequestInit | undefined, clientOptions: PassthroughRequest.ClientOptions, requestOptions?: PassthroughRequest.RequestOptions): Promise<Response>;