@spare-technologies/spare-api 1.0.0-beta.10

package/dist/core/fetcher/makeRequest.js

@@ -0,0 +1,54 @@
+import { anySignal, getTimeoutSignal } from "./signals.js";
+/**
+ * Cached result of checking whether the current runtime supports
+ * the `cache` option in `Request`. Some runtimes (e.g. Cloudflare Workers)
+ * throw a TypeError when this option is used.
+ */
+let _cacheNoStoreSupported;
+export function isCacheNoStoreSupported() {
+    if (_cacheNoStoreSupported != null) {
+        return _cacheNoStoreSupported;
+    }
+    try {
+        new Request("http://localhost", { cache: "no-store" });
+        _cacheNoStoreSupported = true;
+    }
+    catch {
+        _cacheNoStoreSupported = false;
+    }
+    return _cacheNoStoreSupported;
+}
+/**
+ * Reset the cached result of `isCacheNoStoreSupported`. Exposed for testing only.
+ */
+export function resetCacheNoStoreSupported() {
+    _cacheNoStoreSupported = undefined;
+}
+export const makeRequest = async (fetchFn, url, method, headers, requestBody, timeoutMs, abortSignal, withCredentials, duplex, disableCache) => {
+    const signals = [];
+    let timeoutAbortId;
+    if (timeoutMs != null) {
+        const { signal, abortId } = getTimeoutSignal(timeoutMs);
+        timeoutAbortId = abortId;
+        signals.push(signal);
+    }
+    if (abortSignal != null) {
+        signals.push(abortSignal);
+    }
+    const newSignals = anySignal(signals);
+    const response = await fetchFn(url, {
+        method: method,
+        headers,
+        body: requestBody,
+        signal: newSignals,
+        credentials: withCredentials ? "include" : undefined,
+        // @ts-ignore
+        duplex,
+        ...(disableCache && isCacheNoStoreSupported() ? { cache: "no-store" } : {}),
+    });
+    if (timeoutAbortId != null) {
+        clearTimeout(timeoutAbortId);
+    }
+    return response;
+};
+//# sourceMappingURL=makeRequest.js.map

package/dist/core/fetcher/makeRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeRequest.js","sourceRoot":"","sources":["../../../core/fetcher/makeRequest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE3D;;;;GAIG;AACH,IAAI,sBAA2C,CAAC;AAChD,MAAM,UAAU,uBAAuB;IACnC,IAAI,sBAAsB,IAAI,IAAI,EAAE,CAAC;QACjC,OAAO,sBAAsB,CAAC;IAClC,CAAC;IACD,IAAI,CAAC;QACD,IAAI,OAAO,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QACvD,sBAAsB,GAAG,IAAI,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACL,sBAAsB,GAAG,KAAK,CAAC;IACnC,CAAC;IACD,OAAO,sBAAsB,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B;IACtC,sBAAsB,GAAG,SAAS,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAC5B,OAA8D,EAC9D,GAAW,EACX,MAAc,EACd,OAAyC,EACzC,WAAiC,EACjC,SAAkB,EAClB,WAAyB,EACzB,eAAyB,EACzB,MAAe,EACf,YAAsB,EACL,EAAE;IACnB,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,IAAI,cAAyD,CAAC;IAC9D,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;QACpB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACxD,cAAc,GAAG,OAAO,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9B,CAAC;IACD,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;QAChC,MAAM,EAAE,MAAM;QACd,OAAO;QACP,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,UAAU;QAClB,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QACpD,aAAa;QACb,MAAM;QACN,GAAG,CAAC,YAAY,IAAI,uBAAuB,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,UAA0B,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9F,CAAC,CAAC;IAEH,IAAI,cAAc,IAAI,IAAI,EAAE,CAAC;QACzB,YAAY,CAAC,cAAc,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC,CAAC","sourcesContent":["import { anySignal, getTimeoutSignal } from \"./signals.js\";\n\n/**\n * Cached result of checking whether the current runtime supports\n * the `cache` option in `Request`. Some runtimes (e.g. Cloudflare Workers)\n * throw a TypeError when this option is used.\n */\nlet _cacheNoStoreSupported: boolean | undefined;\nexport function isCacheNoStoreSupported(): boolean {\n    if (_cacheNoStoreSupported != null) {\n        return _cacheNoStoreSupported;\n    }\n    try {\n        new Request(\"http://localhost\", { cache: \"no-store\" });\n        _cacheNoStoreSupported = true;\n    } catch {\n        _cacheNoStoreSupported = false;\n    }\n    return _cacheNoStoreSupported;\n}\n\n/**\n * Reset the cached result of `isCacheNoStoreSupported`. Exposed for testing only.\n */\nexport function resetCacheNoStoreSupported(): void {\n    _cacheNoStoreSupported = undefined;\n}\n\nexport const makeRequest = async (\n    fetchFn: (url: string, init: RequestInit) => Promise<Response>,\n    url: string,\n    method: string,\n    headers: Headers | Record<string, string>,\n    requestBody: BodyInit | undefined,\n    timeoutMs?: number,\n    abortSignal?: AbortSignal,\n    withCredentials?: boolean,\n    duplex?: \"half\",\n    disableCache?: boolean,\n): Promise<Response> => {\n    const signals: AbortSignal[] = [];\n\n    let timeoutAbortId: ReturnType<typeof setTimeout> | undefined;\n    if (timeoutMs != null) {\n        const { signal, abortId } = getTimeoutSignal(timeoutMs);\n        timeoutAbortId = abortId;\n        signals.push(signal);\n    }\n\n    if (abortSignal != null) {\n        signals.push(abortSignal);\n    }\n    const newSignals = anySignal(signals);\n    const response = await fetchFn(url, {\n        method: method,\n        headers,\n        body: requestBody,\n        signal: newSignals,\n        credentials: withCredentials ? \"include\" : undefined,\n        // @ts-ignore\n        duplex,\n        ...(disableCache && isCacheNoStoreSupported() ? { cache: \"no-store\" as RequestCache } : {}),\n    });\n\n    if (timeoutAbortId != null) {\n        clearTimeout(timeoutAbortId);\n    }\n\n    return response;\n};\n"]}

package/dist/core/fetcher/requestWithRetries.d.ts

@@ -0,0 +1,2 @@
+export declare function requestWithRetries(requestFn: () => Promise<Response>, maxRetries?: number): Promise<Response>;
+//# sourceMappingURL=requestWithRetries.d.ts.map

package/dist/core/fetcher/requestWithRetries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestWithRetries.d.ts","sourceRoot":"","sources":["../../../core/fetcher/requestWithRetries.ts"],"names":[],"mappings":"AA8CA,wBAAsB,kBAAkB,CACpC,SAAS,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,EAClC,UAAU,GAAE,MAA4B,GACzC,OAAO,CAAC,QAAQ,CAAC,CAcnB"}

package/dist/core/fetcher/requestWithRetries.js

@@ -0,0 +1,54 @@
+const INITIAL_RETRY_DELAY = 1000; // in milliseconds
+const MAX_RETRY_DELAY = 60000; // in milliseconds
+const DEFAULT_MAX_RETRIES = 3;
+const JITTER_FACTOR = 0.2; // 20% random jitter
+function addPositiveJitter(delay) {
+    const jitterMultiplier = 1 + Math.random() * JITTER_FACTOR;
+    return delay * jitterMultiplier;
+}
+function addSymmetricJitter(delay) {
+    const jitterMultiplier = 1 + (Math.random() - 0.5) * JITTER_FACTOR;
+    return delay * jitterMultiplier;
+}
+function getRetryDelayFromHeaders(response, retryAttempt) {
+    const retryAfter = response.headers.get("Retry-After");
+    if (retryAfter) {
+        const retryAfterSeconds = parseInt(retryAfter, 10);
+        if (!Number.isNaN(retryAfterSeconds) && retryAfterSeconds > 0) {
+            return Math.min(retryAfterSeconds * 1000, MAX_RETRY_DELAY);
+        }
+        const retryAfterDate = new Date(retryAfter);
+        if (!Number.isNaN(retryAfterDate.getTime())) {
+            const delay = retryAfterDate.getTime() - Date.now();
+            if (delay > 0) {
+                return Math.min(Math.max(delay, 0), MAX_RETRY_DELAY);
+            }
+        }
+    }
+    const rateLimitReset = response.headers.get("X-RateLimit-Reset");
+    if (rateLimitReset) {
+        const resetTime = parseInt(rateLimitReset, 10);
+        if (!Number.isNaN(resetTime)) {
+            const delay = resetTime * 1000 - Date.now();
+            if (delay > 0) {
+                return addPositiveJitter(Math.min(delay, MAX_RETRY_DELAY));
+            }
+        }
+    }
+    return addSymmetricJitter(Math.min(INITIAL_RETRY_DELAY * 2 ** retryAttempt, MAX_RETRY_DELAY));
+}
+export async function requestWithRetries(requestFn, maxRetries = DEFAULT_MAX_RETRIES) {
+    let response = await requestFn();
+    for (let i = 0; i < maxRetries; ++i) {
+        if ([408, 429].includes(response.status) || response.status >= 500) {
+            const delay = getRetryDelayFromHeaders(response, i);
+            await new Promise((resolve) => setTimeout(resolve, delay));
+            response = await requestFn();
+        }
+        else {
+            break;
+        }
+    }
+    return response;
+}
+//# sourceMappingURL=requestWithRetries.js.map

package/dist/core/fetcher/requestWithRetries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestWithRetries.js","sourceRoot":"","sources":["../../../core/fetcher/requestWithRetries.ts"],"names":[],"mappings":"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","sourcesContent":["const INITIAL_RETRY_DELAY = 1000; // in milliseconds\nconst MAX_RETRY_DELAY = 60000; // in milliseconds\nconst DEFAULT_MAX_RETRIES = 3;\nconst JITTER_FACTOR = 0.2; // 20% random jitter\n\nfunction addPositiveJitter(delay: number): number {\n    const jitterMultiplier = 1 + Math.random() * JITTER_FACTOR;\n    return delay * jitterMultiplier;\n}\n\nfunction addSymmetricJitter(delay: number): number {\n    const jitterMultiplier = 1 + (Math.random() - 0.5) * JITTER_FACTOR;\n    return delay * jitterMultiplier;\n}\n\nfunction getRetryDelayFromHeaders(response: Response, retryAttempt: number): number {\n    const retryAfter = response.headers.get(\"Retry-After\");\n    if (retryAfter) {\n        const retryAfterSeconds = parseInt(retryAfter, 10);\n        if (!Number.isNaN(retryAfterSeconds) && retryAfterSeconds > 0) {\n            return Math.min(retryAfterSeconds * 1000, MAX_RETRY_DELAY);\n        }\n\n        const retryAfterDate = new Date(retryAfter);\n        if (!Number.isNaN(retryAfterDate.getTime())) {\n            const delay = retryAfterDate.getTime() - Date.now();\n            if (delay > 0) {\n                return Math.min(Math.max(delay, 0), MAX_RETRY_DELAY);\n            }\n        }\n    }\n\n    const rateLimitReset = response.headers.get(\"X-RateLimit-Reset\");\n    if (rateLimitReset) {\n        const resetTime = parseInt(rateLimitReset, 10);\n        if (!Number.isNaN(resetTime)) {\n            const delay = resetTime * 1000 - Date.now();\n            if (delay > 0) {\n                return addPositiveJitter(Math.min(delay, MAX_RETRY_DELAY));\n            }\n        }\n    }\n\n    return addSymmetricJitter(Math.min(INITIAL_RETRY_DELAY * 2 ** retryAttempt, MAX_RETRY_DELAY));\n}\n\nexport async function requestWithRetries(\n    requestFn: () => Promise<Response>,\n    maxRetries: number = DEFAULT_MAX_RETRIES,\n): Promise<Response> {\n    let response: Response = await requestFn();\n\n    for (let i = 0; i < maxRetries; ++i) {\n        if ([408, 429].includes(response.status) || response.status >= 500) {\n            const delay = getRetryDelayFromHeaders(response, i);\n\n            await new Promise((resolve) => setTimeout(resolve, delay));\n            response = await requestFn();\n        } else {\n            break;\n        }\n    }\n    return response!;\n}\n"]}

package/dist/core/fetcher/signals.d.ts

@@ -0,0 +1,6 @@
+export declare function getTimeoutSignal(timeoutMs: number): {
+    signal: AbortSignal;
+    abortId: ReturnType<typeof setTimeout>;
+};
+export declare function anySignal(...args: AbortSignal[] | [AbortSignal[]]): AbortSignal;
+//# sourceMappingURL=signals.d.ts.map

package/dist/core/fetcher/signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../../core/fetcher/signals.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAA;CAAE,CAInH;AAED,wBAAgB,SAAS,CAAC,GAAG,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,WAAW,CAiB/E"}

package/dist/core/fetcher/signals.js

@@ -0,0 +1,21 @@
+const TIMEOUT = "timeout";
+export function getTimeoutSignal(timeoutMs) {
+    const controller = new AbortController();
+    const abortId = setTimeout(() => controller.abort(TIMEOUT), timeoutMs);
+    return { signal: controller.signal, abortId };
+}
+export function anySignal(...args) {
+    const signals = (args.length === 1 && Array.isArray(args[0]) ? args[0] : args);
+    const controller = new AbortController();
+    for (const signal of signals) {
+        if (signal.aborted) {
+            controller.abort(signal?.reason);
+            break;
+        }
+        signal.addEventListener("abort", () => controller.abort(signal?.reason), {
+            signal: controller.signal,
+        });
+    }
+    return controller.signal;
+}
+//# sourceMappingURL=signals.js.map

package/dist/core/fetcher/signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.js","sourceRoot":"","sources":["../../../core/fetcher/signals.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,GAAG,SAAS,CAAC;AAE1B,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAC9C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,CAAC;IACvE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAG,IAAqC;IAC9D,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAkB,CAAC;IAEhG,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IAEzC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,UAAU,CAAC,KAAK,CAAE,MAAc,EAAE,MAAM,CAAC,CAAC;YAC1C,MAAM;QACV,CAAC;QAED,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAE,MAAc,EAAE,MAAM,CAAC,EAAE;YAC9E,MAAM,EAAE,UAAU,CAAC,MAAM;SAC5B,CAAC,CAAC;IACP,CAAC;IAED,OAAO,UAAU,CAAC,MAAM,CAAC;AAC7B,CAAC","sourcesContent":["const TIMEOUT = \"timeout\";\n\nexport function getTimeoutSignal(timeoutMs: number): { signal: AbortSignal; abortId: ReturnType<typeof setTimeout> } {\n    const controller = new AbortController();\n    const abortId = setTimeout(() => controller.abort(TIMEOUT), timeoutMs);\n    return { signal: controller.signal, abortId };\n}\n\nexport function anySignal(...args: AbortSignal[] | [AbortSignal[]]): AbortSignal {\n    const signals = (args.length === 1 && Array.isArray(args[0]) ? args[0] : args) as AbortSignal[];\n\n    const controller = new AbortController();\n\n    for (const signal of signals) {\n        if (signal.aborted) {\n            controller.abort((signal as any)?.reason);\n            break;\n        }\n\n        signal.addEventListener(\"abort\", () => controller.abort((signal as any)?.reason), {\n            signal: controller.signal,\n        });\n    }\n\n    return controller.signal;\n}\n"]}

package/dist/core/headers.d.ts

@@ -0,0 +1,3 @@
+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>;
+//# sourceMappingURL=headers.d.ts.map

package/dist/core/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../../core/headers.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,GAAG,YAAY,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAerH;AAED,wBAAgB,uBAAuB,CACnC,GAAG,YAAY,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAChE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB"}

package/dist/core/headers.js

@@ -0,0 +1,28 @@
+export function mergeHeaders(...headersArray) {
+    const result = {};
+    for (const [key, value] of headersArray
+        .filter((headers) => headers != null)
+        .flatMap((headers) => Object.entries(headers))) {
+        const insensitiveKey = key.toLowerCase();
+        if (value != null) {
+            result[insensitiveKey] = value;
+        }
+        else if (insensitiveKey in result) {
+            delete result[insensitiveKey];
+        }
+    }
+    return result;
+}
+export function mergeOnlyDefinedHeaders(...headersArray) {
+    const result = {};
+    for (const [key, value] of headersArray
+        .filter((headers) => headers != null)
+        .flatMap((headers) => Object.entries(headers))) {
+        const insensitiveKey = key.toLowerCase();
+        if (value != null) {
+            result[insensitiveKey] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=headers.js.map

package/dist/core/headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.js","sourceRoot":"","sources":["../../core/headers.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,GAAG,YAA4D;IACxF,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,YAAY;SAClC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,IAAI,IAAI,CAAC;SACpC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,cAAc,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QACzC,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAChB,MAAM,CAAC,cAAc,CAAC,GAAG,KAAK,CAAC;QACnC,CAAC;aAAM,IAAI,cAAc,IAAI,MAAM,EAAE,CAAC;YAClC,OAAO,MAAM,CAAC,cAAc,CAAC,CAAC;QAClC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,uBAAuB,CACnC,GAAG,YAA4D;IAE/D,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,YAAY;SAClC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,IAAI,IAAI,CAAC;SACpC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,cAAc,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QACzC,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAChB,MAAM,CAAC,cAAc,CAAC,GAAG,KAAK,CAAC;QACnC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC","sourcesContent":["export function mergeHeaders(...headersArray: (Record<string, unknown> | null | undefined)[]): Record<string, unknown> {\n    const result: Record<string, unknown> = {};\n\n    for (const [key, value] of headersArray\n        .filter((headers) => headers != null)\n        .flatMap((headers) => Object.entries(headers))) {\n        const insensitiveKey = key.toLowerCase();\n        if (value != null) {\n            result[insensitiveKey] = value;\n        } else if (insensitiveKey in result) {\n            delete result[insensitiveKey];\n        }\n    }\n\n    return result;\n}\n\nexport function mergeOnlyDefinedHeaders(\n    ...headersArray: (Record<string, unknown> | null | undefined)[]\n): Record<string, unknown> {\n    const result: Record<string, unknown> = {};\n\n    for (const [key, value] of headersArray\n        .filter((headers) => headers != null)\n        .flatMap((headers) => Object.entries(headers))) {\n        const insensitiveKey = key.toLowerCase();\n        if (value != null) {\n            result[insensitiveKey] = value;\n        }\n    }\n\n    return result;\n}\n"]}

package/dist/core/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./auth/index.js";
+export * from "./base64.js";
+export * from "./fetcher/index.js";
+export * as logging from "./logging/index.js";
+export * from "./runtime/index.js";
+export * as url from "./url/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../core/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,7 @@
+export * from "./auth/index.js";
+export * from "./base64.js";
+export * from "./fetcher/index.js";
+export * as logging from "./logging/index.js";
+export * from "./runtime/index.js";
+export * as url from "./url/index.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../core/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC","sourcesContent":["export * from \"./auth/index.js\";\nexport * from \"./base64.js\";\nexport * from \"./fetcher/index.js\";\nexport * as logging from \"./logging/index.js\";\nexport * from \"./runtime/index.js\";\nexport * as url from \"./url/index.js\";\n"]}

package/dist/core/json.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Serialize a value to JSON
+ * @param value A JavaScript value, usually an object or array, to be converted.
+ * @param replacer A function that transforms the results.
+ * @param space Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.
+ * @returns JSON string
+ */
+export declare const toJson: (value: unknown, replacer?: (this: unknown, key: string, value: unknown) => unknown, space?: string | number) => string;
+/**
+ * Parse JSON string to object, array, or other type
+ * @param text A valid JSON string.
+ * @param reviver A function that transforms the results. This function is called for each member of the object. If a member contains nested objects, the nested objects are transformed before the parent object is.
+ * @returns Parsed object, array, or other type
+ */
+export declare function fromJson<T = unknown>(text: string, reviver?: (this: unknown, key: string, value: unknown) => unknown): T;
+//# sourceMappingURL=json.d.ts.map

package/dist/core/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../core/json.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,GACf,OAAO,OAAO,EACd,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,EAClE,QAAQ,MAAM,GAAG,MAAM,KACxB,MAEF,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAChC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,GAClE,CAAC,CAEH"}

package/dist/core/json.js

@@ -0,0 +1,20 @@
+/**
+ * Serialize a value to JSON
+ * @param value A JavaScript value, usually an object or array, to be converted.
+ * @param replacer A function that transforms the results.
+ * @param space Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.
+ * @returns JSON string
+ */
+export const toJson = (value, replacer, space) => {
+    return JSON.stringify(value, replacer, space);
+};
+/**
+ * Parse JSON string to object, array, or other type
+ * @param text A valid JSON string.
+ * @param reviver A function that transforms the results. This function is called for each member of the object. If a member contains nested objects, the nested objects are transformed before the parent object is.
+ * @returns Parsed object, array, or other type
+ */
+export function fromJson(text, reviver) {
+    return JSON.parse(text, reviver);
+}
+//# sourceMappingURL=json.js.map

package/dist/core/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../core/json.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAClB,KAAc,EACd,QAAkE,EAClE,KAAuB,EACjB,EAAE;IACR,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CACpB,IAAY,EACZ,OAAiE;IAEjE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC","sourcesContent":["/**\n * Serialize a value to JSON\n * @param value A JavaScript value, usually an object or array, to be converted.\n * @param replacer A function that transforms the results.\n * @param space Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.\n * @returns JSON string\n */\nexport const toJson = (\n    value: unknown,\n    replacer?: (this: unknown, key: string, value: unknown) => unknown,\n    space?: string | number,\n): string => {\n    return JSON.stringify(value, replacer, space);\n};\n\n/**\n * Parse JSON string to object, array, or other type\n * @param text A valid JSON string.\n * @param reviver A function that transforms the results. This function is called for each member of the object. If a member contains nested objects, the nested objects are transformed before the parent object is.\n * @returns Parsed object, array, or other type\n */\nexport function fromJson<T = unknown>(\n    text: string,\n    reviver?: (this: unknown, key: string, value: unknown) => unknown,\n): T {\n    return JSON.parse(text, reviver);\n}\n"]}

package/dist/core/logging/exports.d.ts

@@ -0,0 +1,19 @@
+import * as logger from "./logger.js";
+export declare namespace logging {
+    /**
+     * Configuration for logger instances.
+     */
+    type LogConfig = logger.LogConfig;
+    type LogLevel = logger.LogLevel;
+    const LogLevel: typeof logger.LogLevel;
+    type ILogger = logger.ILogger;
+    /**
+     * Console logger implementation that outputs to the console.
+     */
+    type ConsoleLogger = logger.ConsoleLogger;
+    /**
+     * Console logger implementation that outputs to the console.
+     */
+    const ConsoleLogger: typeof logger.ConsoleLogger;
+}
+//# sourceMappingURL=exports.d.ts.map

package/dist/core/logging/exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../core/logging/exports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,yBAAiB,OAAO,CAAC;IACrB;;OAEG;IACH,KAAY,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACzC,KAAY,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAChC,MAAM,QAAQ,EAAE,OAAO,MAAM,CAAC,QAA0B,CAAC;IAChE,KAAY,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IACrC;;OAEG;IACH,KAAY,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;IACjD;;OAEG;IACI,MAAM,aAAa,EAAE,OAAO,MAAM,CAAC,aAAoC,CAAC;CAClF"}

package/dist/core/logging/exports.js

@@ -0,0 +1,10 @@
+import * as logger from "./logger.js";
+export var logging;
+(function (logging) {
+    logging.LogLevel = logger.LogLevel;
+    /**
+     * Console logger implementation that outputs to the console.
+     */
+    logging.ConsoleLogger = logger.ConsoleLogger;
+})(logging || (logging = {}));
+//# sourceMappingURL=exports.js.map

package/dist/core/logging/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../../../core/logging/exports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,MAAM,KAAW,OAAO,CAgBvB;AAhBD,WAAiB,OAAO;IAMP,gBAAQ,GAA2B,MAAM,CAAC,QAAQ,CAAC;IAMhE;;OAEG;IACU,qBAAa,GAAgC,MAAM,CAAC,aAAa,CAAC;AACnF,CAAC,EAhBgB,OAAO,KAAP,OAAO,QAgBvB","sourcesContent":["import * as logger from \"./logger.js\";\n\nexport namespace logging {\n    /**\n     * Configuration for logger instances.\n     */\n    export type LogConfig = logger.LogConfig;\n    export type LogLevel = logger.LogLevel;\n    export const LogLevel: typeof logger.LogLevel = logger.LogLevel;\n    export type ILogger = logger.ILogger;\n    /**\n     * Console logger implementation that outputs to the console.\n     */\n    export type ConsoleLogger = logger.ConsoleLogger;\n    /**\n     * Console logger implementation that outputs to the console.\n     */\n    export const ConsoleLogger: typeof logger.ConsoleLogger = logger.ConsoleLogger;\n}\n"]}

package/dist/core/logging/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./logger.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/logging/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/core/logging/index.js

@@ -0,0 +1,2 @@
+export * from "./logger.js";
+//# sourceMappingURL=index.js.map

package/dist/core/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../core/logging/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC","sourcesContent":["export * from \"./logger.js\";\n"]}

package/dist/core/logging/logger.d.ts

@@ -0,0 +1,127 @@
+export declare const LogLevel: {
+    readonly Debug: "debug";
+    readonly Info: "info";
+    readonly Warn: "warn";
+    readonly Error: "error";
+};
+export type LogLevel = (typeof LogLevel)[keyof typeof LogLevel];
+export interface ILogger {
+    /**
+     * Logs a debug message.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    debug(message: string, ...args: unknown[]): void;
+    /**
+     * Logs an info message.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    info(message: string, ...args: unknown[]): void;
+    /**
+     * Logs a warning message.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    warn(message: string, ...args: unknown[]): void;
+    /**
+     * Logs an error message.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    error(message: string, ...args: unknown[]): void;
+}
+/**
+ * Configuration for logger initialization.
+ */
+export interface LogConfig {
+    /**
+     * Minimum log level to output.
+     * @default LogLevel.Info
+     */
+    level?: LogLevel;
+    /**
+     * Logger implementation to use.
+     * @default new ConsoleLogger()
+     */
+    logger?: ILogger;
+    /**
+     * Whether logging should be silenced.
+     * @default true
+     */
+    silent?: boolean;
+}
+/**
+ * Default console-based logger implementation.
+ */
+export declare class ConsoleLogger implements ILogger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+/**
+ * Logger class that provides level-based logging functionality.
+ */
+export declare class Logger {
+    private readonly level;
+    private readonly logger;
+    private readonly silent;
+    /**
+     * Creates a new logger instance.
+     * @param config - Logger configuration
+     */
+    constructor(config: Required<LogConfig>);
+    /**
+     * Checks if a log level should be output based on configuration.
+     * @param level - The log level to check
+     * @returns True if the level should be logged
+     */
+    shouldLog(level: LogLevel): boolean;
+    /**
+     * Checks if debug logging is enabled.
+     * @returns True if debug logs should be output
+     */
+    isDebug(): boolean;
+    /**
+     * Logs a debug message if debug logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    debug(message: string, ...args: unknown[]): void;
+    /**
+     * Checks if info logging is enabled.
+     * @returns True if info logs should be output
+     */
+    isInfo(): boolean;
+    /**
+     * Logs an info message if info logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    info(message: string, ...args: unknown[]): void;
+    /**
+     * Checks if warning logging is enabled.
+     * @returns True if warning logs should be output
+     */
+    isWarn(): boolean;
+    /**
+     * Logs a warning message if warning logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    warn(message: string, ...args: unknown[]): void;
+    /**
+     * Checks if error logging is enabled.
+     * @returns True if error logs should be output
+     */
+    isError(): boolean;
+    /**
+     * Logs an error message if error logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    error(message: string, ...args: unknown[]): void;
+}
+export declare function createLogger(config?: LogConfig | Logger): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logging/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../core/logging/logger.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ;;;;;CAKX,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAQhE,MAAM,WAAW,OAAO;IACpB;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,OAAO;IACzC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAGhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAG/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAG/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAGnD;AAED;;GAEG;AACH,qBAAa,MAAM;IACf,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IAEjC;;;OAGG;gBACS,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC;IAMvC;;;;OAIG;IACI,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAI1C;;;OAGG;IACI,OAAO,IAAI,OAAO;IAIzB;;;;OAIG;IACI,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMvD;;;OAGG;IACI,MAAM,IAAI,OAAO;IAIxB;;;;OAIG;IACI,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMtD;;;OAGG;IACI,MAAM,IAAI,OAAO;IAIxB;;;;OAIG;IACI,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMtD;;;OAGG;IACI,OAAO,IAAI,OAAO;IAIzB;;;;OAIG;IACI,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAK1D;AAED,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAYhE"}

package/dist/core/logging/logger.js

@@ -0,0 +1,138 @@
+export const LogLevel = {
+    Debug: "debug",
+    Info: "info",
+    Warn: "warn",
+    Error: "error",
+};
+const logLevelMap = {
+    [LogLevel.Debug]: 1,
+    [LogLevel.Info]: 2,
+    [LogLevel.Warn]: 3,
+    [LogLevel.Error]: 4,
+};
+/**
+ * Default console-based logger implementation.
+ */
+export class ConsoleLogger {
+    debug(message, ...args) {
+        console.debug(message, ...args);
+    }
+    info(message, ...args) {
+        console.info(message, ...args);
+    }
+    warn(message, ...args) {
+        console.warn(message, ...args);
+    }
+    error(message, ...args) {
+        console.error(message, ...args);
+    }
+}
+/**
+ * Logger class that provides level-based logging functionality.
+ */
+export class Logger {
+    /**
+     * Creates a new logger instance.
+     * @param config - Logger configuration
+     */
+    constructor(config) {
+        this.level = logLevelMap[config.level];
+        this.logger = config.logger;
+        this.silent = config.silent;
+    }
+    /**
+     * Checks if a log level should be output based on configuration.
+     * @param level - The log level to check
+     * @returns True if the level should be logged
+     */
+    shouldLog(level) {
+        return !this.silent && this.level <= logLevelMap[level];
+    }
+    /**
+     * Checks if debug logging is enabled.
+     * @returns True if debug logs should be output
+     */
+    isDebug() {
+        return this.shouldLog(LogLevel.Debug);
+    }
+    /**
+     * Logs a debug message if debug logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    debug(message, ...args) {
+        if (this.isDebug()) {
+            this.logger.debug(message, ...args);
+        }
+    }
+    /**
+     * Checks if info logging is enabled.
+     * @returns True if info logs should be output
+     */
+    isInfo() {
+        return this.shouldLog(LogLevel.Info);
+    }
+    /**
+     * Logs an info message if info logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    info(message, ...args) {
+        if (this.isInfo()) {
+            this.logger.info(message, ...args);
+        }
+    }
+    /**
+     * Checks if warning logging is enabled.
+     * @returns True if warning logs should be output
+     */
+    isWarn() {
+        return this.shouldLog(LogLevel.Warn);
+    }
+    /**
+     * Logs a warning message if warning logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    warn(message, ...args) {
+        if (this.isWarn()) {
+            this.logger.warn(message, ...args);
+        }
+    }
+    /**
+     * Checks if error logging is enabled.
+     * @returns True if error logs should be output
+     */
+    isError() {
+        return this.shouldLog(LogLevel.Error);
+    }
+    /**
+     * Logs an error message if error logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    error(message, ...args) {
+        if (this.isError()) {
+            this.logger.error(message, ...args);
+        }
+    }
+}
+export function createLogger(config) {
+    if (config == null) {
+        return defaultLogger;
+    }
+    if (config instanceof Logger) {
+        return config;
+    }
+    config = config ?? {};
+    config.level ?? (config.level = LogLevel.Info);
+    config.logger ?? (config.logger = new ConsoleLogger());
+    config.silent ?? (config.silent = true);
+    return new Logger(config);
+}
+const defaultLogger = new Logger({
+    level: LogLevel.Info,
+    logger: new ConsoleLogger(),
+    silent: true,
+});
+//# sourceMappingURL=logger.js.map