hume 0.15.8 → 0.15.10

package/dist/esm/core/base64.mjs

@@ -0,0 +1,22 @@
+function base64ToBytes(base64) {
+    const binString = atob(base64);
+    return Uint8Array.from(binString, (m) => m.codePointAt(0));
+}
+function bytesToBase64(bytes) {
+    const binString = String.fromCodePoint(...bytes);
+    return btoa(binString);
+}
+export function base64Encode(input) {
+    if (typeof Buffer !== "undefined") {
+        return Buffer.from(input, "utf8").toString("base64");
+    }
+    const bytes = new TextEncoder().encode(input);
+    return bytesToBase64(bytes);
+}
+export function base64Decode(input) {
+    if (typeof Buffer !== "undefined") {
+        return Buffer.from(input, "base64").toString("utf8");
+    }
+    const bytes = base64ToBytes(input);
+    return new TextDecoder().decode(bytes);
+}

package/dist/esm/core/fetcher/BinaryResponse.d.mts

@@ -1,20 +1,19 @@
-import type { ResponseWithBody } from "./ResponseWithBody.mjs";
 export type BinaryResponse = {
     /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */
-    bodyUsed: boolean;
+    bodyUsed: Response["bodyUsed"];
     /**
      * Returns a ReadableStream of the response body.
      * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body)
      */
-    stream: () => ReadableStream<Uint8Array>;
+    stream: () => Response["body"];
     /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */
-    arrayBuffer: () => Promise<ArrayBuffer>;
+    arrayBuffer: () => ReturnType<Response["arrayBuffer"]>;
     /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */
-    blob: () => Promise<Blob>;
+    blob: () => ReturnType<Response["blob"]>;
     /**
      * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes)
      * Some versions of the Fetch API may not support this method.
      */
-    bytes?(): Promise<Uint8Array>;
+    bytes?(): ReturnType<Response["bytes"]>;
 };
-export declare function getBinaryResponse(response: ResponseWithBody): BinaryResponse;
+export declare function getBinaryResponse(response: Response): BinaryResponse;

package/dist/esm/core/fetcher/EndpointSupplier.d.mts

@@ -1,12 +1,12 @@
 import type { EndpointMetadata } from "./EndpointMetadata.mjs";
 import type { Supplier } from "./Supplier.mjs";
 type EndpointSupplierFn<T> = (arg: {
-    endpointMetadata: EndpointMetadata;
+    endpointMetadata?: EndpointMetadata;
 }) => T | Promise<T>;
 export type EndpointSupplier<T> = Supplier<T> | EndpointSupplierFn<T>;
 export declare const EndpointSupplier: {
     get: <T>(supplier: EndpointSupplier<T>, arg: {
-        endpointMetadata: EndpointMetadata;
+        endpointMetadata?: EndpointMetadata;
     }) => Promise<T>;
 };
 export {};

package/dist/esm/core/fetcher/Fetcher.d.mts

@@ -1,14 +1,13 @@
 import { type LogConfig, type Logger } from "../logging/logger.mjs";
 import type { APIResponse } from "./APIResponse.mjs";
 import type { EndpointMetadata } from "./EndpointMetadata.mjs";
-import { EndpointSupplier } from "./EndpointSupplier.mjs";
 export type FetchFunction = <R = unknown>(args: Fetcher.Args) => Promise<APIResponse<R, Fetcher.Error>>;
 export declare namespace Fetcher {
     interface Args {
         url: string;
         method: string;
         contentType?: string;
-        headers?: Record<string, string | EndpointSupplier<string | null | undefined> | null | undefined>;
+        headers?: Record<string, unknown>;
         queryParameters?: Record<string, unknown>;
         body?: unknown;
         timeoutMs?: number;
@@ -22,7 +21,7 @@ export declare namespace Fetcher {
         fetchFn?: typeof fetch;
         logging?: LogConfig | Logger;
     }
-    type Error = FailedStatusCodeError | NonJsonError | TimeoutError | UnknownError;
+    type Error = FailedStatusCodeError | NonJsonError | BodyIsNullError | TimeoutError | UnknownError;
     interface FailedStatusCodeError {
         reason: "status-code";
         statusCode: number;
@@ -33,6 +32,10 @@ export declare namespace Fetcher {
         statusCode: number;
         rawBody: string;
     }
+    interface BodyIsNullError {
+        reason: "body-is-null";
+        statusCode: number;
+    }
     interface TimeoutError {
         reason: "timeout";
     }

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

@@ -15,23 +15,31 @@ import { getErrorResponseBody } from "./getErrorResponseBody.mjs";
 import { getFetchFn } from "./getFetchFn.mjs";
 import { getRequestBody } from "./getRequestBody.mjs";
 import { getResponseBody } from "./getResponseBody.mjs";
+import { Headers } from "./Headers.mjs";
 import { makeRequest } from "./makeRequest.mjs";
 import { abortRawResponse, toRawResponse, unknownRawResponse } from "./RawResponse.mjs";
 import { requestWithRetries } from "./requestWithRetries.mjs";
 const SENSITIVE_HEADERS = new Set([
     "authorization",
+    "www-authenticate",
     "x-api-key",
     "api-key",
+    "apikey",
+    "x-api-token",
     "x-auth-token",
+    "auth-token",
     "cookie",
     "set-cookie",
     "proxy-authorization",
+    "proxy-authenticate",
     "x-csrf-token",
     "x-xsrf-token",
+    "x-session-token",
+    "x-access-token",
 ]);
 function redactHeaders(headers) {
     const filtered = {};
-    for (const [key, value] of Object.entries(headers)) {
+    for (const [key, value] of headers instanceof Headers ? headers.entries() : Object.entries(headers)) {
         if (SENSITIVE_HEADERS.has(key.toLowerCase())) {
             filtered[key] = "[REDACTED]";
         }
@@ -81,20 +89,26 @@ function redactUrl(url) {
     if (protocolIndex === -1)
         return url;
     const afterProtocol = protocolIndex + 3;
-    const atIndex = url.indexOf("@", afterProtocol);
-    if (atIndex !== -1) {
-        const pathStart = url.indexOf("/", afterProtocol);
-        const queryStart = url.indexOf("?", afterProtocol);
-        const fragmentStart = url.indexOf("#", afterProtocol);
-        const firstDelimiter = Math.min(pathStart === -1 ? url.length : pathStart, queryStart === -1 ? url.length : queryStart, fragmentStart === -1 ? url.length : fragmentStart);
-        if (atIndex < firstDelimiter) {
-            url = `${url.slice(0, afterProtocol)}[REDACTED]@${url.slice(atIndex + 1)}`;
+    // Find the first delimiter that marks the end of the authority section
+    const pathStart = url.indexOf("/", afterProtocol);
+    let queryStart = url.indexOf("?", afterProtocol);
+    let fragmentStart = url.indexOf("#", afterProtocol);
+    const firstDelimiter = Math.min(pathStart === -1 ? url.length : pathStart, queryStart === -1 ? url.length : queryStart, fragmentStart === -1 ? url.length : fragmentStart);
+    // Find the LAST @ before the delimiter (handles multiple @ in credentials)
+    let atIndex = -1;
+    for (let i = afterProtocol; i < firstDelimiter; i++) {
+        if (url[i] === "@") {
+            atIndex = i;
         }
     }
-    const queryStart = url.indexOf("?");
+    if (atIndex !== -1) {
+        url = `${url.slice(0, afterProtocol)}[REDACTED]@${url.slice(atIndex + 1)}`;
+    }
+    // Recalculate queryStart since url might have changed
+    queryStart = url.indexOf("?");
     if (queryStart === -1)
         return url;
-    const fragmentStart = url.indexOf("#", queryStart);
+    fragmentStart = url.indexOf("#", queryStart);
     const queryEnd = fragmentStart !== -1 ? fragmentStart : url.length;
     const queryString = url.slice(queryStart + 1, queryEnd);
     if (queryString.length === 0)
@@ -102,15 +116,15 @@ function redactUrl(url) {
     // FAST PATH: Quick check if any sensitive keywords present
     // Using indexOf is faster than regex for simple substring matching
     const lower = queryString.toLowerCase();
-    const hasSensitive = lower.includes("token") || // catches token, access_token, auth_token, etc.
-        lower.includes("key") || // catches key, api_key, apikey, api-key, etc.
-        lower.includes("password") || // catches password
-        lower.includes("passwd") || // catches passwd
-        lower.includes("secret") || // catches secret, api_secret, etc.
-        lower.includes("session") || // catches session, session_id, session-id
-        lower.includes("auth"); // catches auth_token, auth-token, etc.
+    const hasSensitive = lower.includes("token") ||
+        lower.includes("key") ||
+        lower.includes("password") ||
+        lower.includes("passwd") ||
+        lower.includes("secret") ||
+        lower.includes("session") ||
+        lower.includes("auth");
     if (!hasSensitive) {
-        return url; // Early exit - no sensitive params
+        return url;
     }
     // SLOW PATH: Parse and redact
     const redactedParams = [];
@@ -137,9 +151,10 @@ function redactUrl(url) {
 function getHeaders(args) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a;
-        const newHeaders = {};
+        const newHeaders = new Headers();
+        newHeaders.set("Accept", args.responseType === "json" ? "application/json" : args.responseType === "text" ? "text/plain" : "*/*");
         if (args.body !== undefined && args.contentType != null) {
-            newHeaders["Content-Type"] = args.contentType;
+            newHeaders.set("Content-Type", args.contentType);
         }
         if (args.headers == null) {
             return newHeaders;
@@ -147,13 +162,13 @@ function getHeaders(args) {
         for (const [key, value] of Object.entries(args.headers)) {
             const result = yield EndpointSupplier.get(value, { endpointMetadata: (_a = args.endpointMetadata) !== null && _a !== void 0 ? _a : {} });
             if (typeof result === "string") {
-                newHeaders[key] = result;
+                newHeaders.set(key, result);
                 continue;
             }
             if (result == null) {
                 continue;
             }
-            newHeaders[key] = `${result}`;
+            newHeaders.set(key, `${result}`);
         }
         return newHeaders;
     });
@@ -189,12 +204,14 @@ export function fetcherImpl(args) {
                         method: args.method,
                         url: redactUrl(url),
                         statusCode: response.status,
+                        responseHeaders: redactHeaders(response.headers),
                     };
                     logger.debug("HTTP request succeeded", metadata);
                 }
+                const body = yield getResponseBody(response, args.responseType);
                 return {
                     ok: true,
-                    body: (yield getResponseBody(response, args.responseType)),
+                    body: body,
                     headers: response.headers,
                     rawResponse: toRawResponse(response),
                 };
@@ -205,6 +222,7 @@ export function fetcherImpl(args) {
                         method: args.method,
                         url: redactUrl(url),
                         statusCode: response.status,
+                        responseHeaders: redactHeaders(Object.fromEntries(response.headers.entries())),
                     };
                     logger.error("HTTP request failed with error status", metadata);
                 }

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

@@ -9,12 +9,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { fromJson } from "../json.mjs";
 import { getBinaryResponse } from "./BinaryResponse.mjs";
-import { isResponseWithBody } from "./ResponseWithBody.mjs";
 export function getResponseBody(response, responseType) {
     return __awaiter(this, void 0, void 0, function* () {
-        if (!isResponseWithBody(response)) {
-            return undefined;
-        }
         switch (responseType) {
             case "binary-response":
                 return getBinaryResponse(response);
@@ -23,8 +19,26 @@ export function getResponseBody(response, responseType) {
             case "arrayBuffer":
                 return yield response.arrayBuffer();
             case "sse":
+                if (response.body == null) {
+                    return {
+                        ok: false,
+                        error: {
+                            reason: "body-is-null",
+                            statusCode: response.status,
+                        },
+                    };
+                }
                 return response.body;
             case "streaming":
+                if (response.body == null) {
+                    return {
+                        ok: false,
+                        error: {
+                            reason: "body-is-null",
+                            statusCode: response.status,
+                        },
+                    };
+                }
                 return response.body;
             case "text":
                 return yield response.text();

package/dist/esm/core/fetcher/makeRequest.d.mts

@@ -1 +1 @@
-export declare const makeRequest: (fetchFn: (url: string, init: RequestInit) => Promise<Response>, url: string, method: string, headers: Record<string, string>, requestBody: BodyInit | undefined, timeoutMs?: number, abortSignal?: AbortSignal, withCredentials?: boolean, duplex?: "half") => Promise<Response>;
+export declare const makeRequest: (fetchFn: (url: string, init: RequestInit) => Promise<Response>, url: string, method: string, headers: Headers | Record<string, string>, requestBody: BodyInit | undefined, timeoutMs?: number, abortSignal?: AbortSignal, withCredentials?: boolean, duplex?: "half") => Promise<Response>;

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

@@ -10,14 +10,12 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { anySignal, getTimeoutSignal } from "./signals.mjs";
 export const makeRequest = (fetchFn, url, method, headers, requestBody, timeoutMs, abortSignal, withCredentials, duplex) => __awaiter(void 0, void 0, void 0, function* () {
     const signals = [];
-    // Add timeout signal
     let timeoutAbortId;
     if (timeoutMs != null) {
         const { signal, abortId } = getTimeoutSignal(timeoutMs);
         timeoutAbortId = abortId;
         signals.push(signal);
     }
-    // Add arbitrary signal
     if (abortSignal != null) {
         signals.push(abortSignal);
     }

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

@@ -12,25 +12,20 @@ const MAX_RETRY_DELAY = 60000; // in milliseconds
 const DEFAULT_MAX_RETRIES = 2;
 const JITTER_FACTOR = 0.2; // 20% random jitter
 function addPositiveJitter(delay) {
-    // Generate a random value between 0 and +JITTER_FACTOR
     const jitterMultiplier = 1 + Math.random() * JITTER_FACTOR;
     return delay * jitterMultiplier;
 }
 function addSymmetricJitter(delay) {
-    // Generate a random value in a JITTER_FACTOR-sized percentage range around delay
     const jitterMultiplier = 1 + (Math.random() - 0.5) * JITTER_FACTOR;
     return delay * jitterMultiplier;
 }
 function getRetryDelayFromHeaders(response, retryAttempt) {
-    // Check for Retry-After header first (RFC 7231), with no jitter
     const retryAfter = response.headers.get("Retry-After");
     if (retryAfter) {
-        // Parse as number of seconds...
         const retryAfterSeconds = parseInt(retryAfter, 10);
         if (!Number.isNaN(retryAfterSeconds) && retryAfterSeconds > 0) {
             return Math.min(retryAfterSeconds * 1000, MAX_RETRY_DELAY);
         }
-        // ...or as an HTTP date; both are valid
         const retryAfterDate = new Date(retryAfter);
         if (!Number.isNaN(retryAfterDate.getTime())) {
             const delay = retryAfterDate.getTime() - Date.now();
@@ -39,19 +34,16 @@ function getRetryDelayFromHeaders(response, retryAttempt) {
             }
         }
     }
-    // Then check for industry-standard X-RateLimit-Reset header, with positive jitter
     const rateLimitReset = response.headers.get("X-RateLimit-Reset");
     if (rateLimitReset) {
         const resetTime = parseInt(rateLimitReset, 10);
         if (!Number.isNaN(resetTime)) {
-            // Assume Unix timestamp in epoch seconds
             const delay = resetTime * 1000 - Date.now();
             if (delay > 0) {
                 return addPositiveJitter(Math.min(delay, MAX_RETRY_DELAY));
             }
         }
     }
-    // Fall back to exponential backoff, with symmetric jitter
     return addSymmetricJitter(Math.min(INITIAL_RETRY_DELAY * Math.pow(2, retryAttempt), MAX_RETRY_DELAY));
 }
 export function requestWithRetries(requestFn_1) {
@@ -59,7 +51,6 @@ export function requestWithRetries(requestFn_1) {
         let response = yield requestFn();
         for (let i = 0; i < maxRetries; ++i) {
             if ([408, 429].includes(response.status) || response.status >= 500) {
-                // Get delay with appropriate jitter applied
                 const delay = getRetryDelayFromHeaders(response, i);
                 yield new Promise((resolve) => setTimeout(resolve, delay));
                 response = yield requestFn();

package/dist/esm/core/fetcher/signals.d.mts

@@ -1,11 +1,5 @@
 export declare function getTimeoutSignal(timeoutMs: number): {
     signal: AbortSignal;
-    abortId: NodeJS.Timeout;
+    abortId: ReturnType<typeof setTimeout>;
 };
-/**
- * Returns an abort signal that is getting aborted when
- * at least one of the specified abort signals is aborted.
- *
- * Requires at least node.js 18.
- */
 export declare function anySignal(...args: AbortSignal[] | [AbortSignal[]]): AbortSignal;

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

@@ -4,26 +4,14 @@ export function getTimeoutSignal(timeoutMs) {
     const abortId = setTimeout(() => controller.abort(TIMEOUT), timeoutMs);
     return { signal: controller.signal, abortId };
 }
-/**
- * Returns an abort signal that is getting aborted when
- * at least one of the specified abort signals is aborted.
- *
- * Requires at least node.js 18.
- */
 export function anySignal(...args) {
-    // Allowing signals to be passed either as array
-    // of signals or as multiple arguments.
     const signals = (args.length === 1 && Array.isArray(args[0]) ? args[0] : args);
     const controller = new AbortController();
     for (const signal of signals) {
         if (signal.aborted) {
-            // Exiting early if one of the signals
-            // is already aborted.
             controller.abort(signal === null || signal === void 0 ? void 0 : signal.reason);
             break;
         }
-        // Listening for signals and removing the listeners
-        // when at least one symbol is aborted.
         signal.addEventListener("abort", () => controller.abort(signal === null || signal === void 0 ? void 0 : signal.reason), {
             signal: controller.signal,
         });

package/dist/esm/core/headers.d.mts

@@ -1,2 +1,2 @@
-export declare function mergeHeaders<THeaderValue>(...headersArray: (Record<string, THeaderValue> | null | undefined)[]): Record<string, string | THeaderValue>;
-export declare function mergeOnlyDefinedHeaders<THeaderValue>(...headersArray: (Record<string, THeaderValue> | null | undefined)[]): Record<string, THeaderValue>;
+export declare function mergeHeaders(...headersArray: (Record<string, unknown> | null | undefined)[]): Record<string, unknown>;
+export declare function mergeOnlyDefinedHeaders(...headersArray: (Record<string, unknown> | null | undefined)[]): Record<string, unknown>;

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

@@ -1,3 +1,5 @@
+export * from "./auth/index.mjs";
+export * from "./base64.mjs";
 export * from "./fetcher/index.mjs";
 export * as file from "./file/index.mjs";
 export * from "./form-data-utils/index.mjs";

package/dist/esm/core/index.mjs

@@ -1,3 +1,5 @@
+export * from "./auth/index.mjs";
+export * from "./base64.mjs";
 export * from "./fetcher/index.mjs";
 export * as file from "./file/index.mjs";
 export * from "./form-data-utils/index.mjs";

package/dist/esm/core/logging/logger.mjs

@@ -46,7 +46,7 @@ export class Logger {
      * @returns True if the level should be logged
      */
     shouldLog(level) {
-        return !this.silent && this.level >= logLevelMap[level];
+        return !this.silent && this.level <= logLevelMap[level];
     }
     /**
      * Checks if debug logging is enabled.

package/dist/esm/core/pagination/CustomPager.d.mts

@@ -0,0 +1,67 @@
+import type { BaseRequestOptions, NormalizedClientOptions } from "../../BaseClient.mjs";
+import type { APIResponse } from "../fetcher/APIResponse.mjs";
+import type { Fetcher } from "../fetcher/Fetcher.mjs";
+import type { RawResponse } from "../fetcher/index.mjs";
+/**
+ *
+ * @template TItem The type of the items in the page.
+ * @template TResponse The type of the API response.
+ */
+export declare class CustomPager<TItem, TResponse> implements AsyncIterable<TItem> {
+    /** The items from the current page */
+    data: TItem[];
+    /** The raw HTTP response */
+    rawResponse: RawResponse;
+    /** The parsed response object */
+    response: TResponse;
+    private sendRequest;
+    private nextRequest?;
+    private previousRequest?;
+    private _hasNextPage;
+    private _hasPreviousPage;
+    constructor(args: {
+        response: TResponse;
+        rawResponse: RawResponse;
+        items: TItem[];
+        hasNextPage: boolean;
+        hasPreviousPage: boolean;
+        nextRequest?: Fetcher.Args;
+        previousRequest?: Fetcher.Args;
+        sendRequest: (request: Fetcher.Args) => Promise<APIResponse<TResponse, Fetcher.Error>>;
+    });
+    /**
+     * @returns whether there is a next page to load
+     */
+    hasNextPage(): boolean;
+    /**
+     * @returns whether there is a previous page to load
+     */
+    hasPreviousPage(): boolean;
+    /**
+     * Returns the current page data.
+     * This is an alias for the `data` property for consistency with other pagination APIs.
+     *
+     * @returns the items from the current page
+     */
+    getCurrentPage(): TItem[];
+    /**
+     * Retrieves the next page of results.
+     * @returns this pager with updated data
+     * @throws Error if there is no next page
+     */
+    getNextPage(): Promise<this>;
+    /**
+     * Retrieves the previous page of results.
+     * @returns this pager with updated data
+     * @throws Error if there is no previous page
+     */
+    getPreviousPage(): Promise<this>;
+    private iterMessages;
+    [Symbol.asyncIterator](): AsyncIterator<TItem, void, unknown>;
+}
+export declare function createCustomPager<TItem, TResponse>({ sendRequest, initialHttpRequest, clientOptions, }: {
+    sendRequest: (request: Fetcher.Args) => Promise<APIResponse<TResponse, Fetcher.Error>>;
+    initialHttpRequest: Fetcher.Args;
+    clientOptions: NormalizedClientOptions;
+    requestOptions?: BaseRequestOptions;
+}): Promise<CustomPager<TItem, TResponse>>;