@herowcode/utils 1.1.10 → 1.2.1

package/dist/cjs/date/dayjs.js

@@ -4,18 +4,121 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.dayjs = void 0;
+exports.getDayjsGlobalIntl = getDayjsGlobalIntl;
+exports.setDayjsGlobalIntl = setDayjsGlobalIntl;
+exports.resetDayjsGlobalIntl = resetDayjsGlobalIntl;
+exports.withDayjsGlobalIntl = withDayjsGlobalIntl;
+exports.resolveDayjsIntlConfig = resolveDayjsIntlConfig;
 const dayjs_1 = __importDefault(require("dayjs"));
-const advancedFormat_js_1 = __importDefault(require("dayjs/plugin/advancedFormat.js"));
-const customParseFormat_js_1 = __importDefault(require("dayjs/plugin/customParseFormat.js"));
-const localizedFormat_js_1 = __importDefault(require("dayjs/plugin/localizedFormat.js"));
-const relativeTime_js_1 = __importDefault(require("dayjs/plugin/relativeTime.js"));
-const timezone_js_1 = __importDefault(require("dayjs/plugin/timezone.js"));
-const utc_js_1 = __importDefault(require("dayjs/plugin/utc.js"));
-dayjs_1.default.extend(utc_js_1.default);
-dayjs_1.default.extend(customParseFormat_js_1.default);
-dayjs_1.default.extend(advancedFormat_js_1.default);
-dayjs_1.default.extend(timezone_js_1.default);
-dayjs_1.default.extend(localizedFormat_js_1.default);
-dayjs_1.default.extend(relativeTime_js_1.default);
+const advancedFormat_1 = __importDefault(require("dayjs/plugin/advancedFormat"));
+const customParseFormat_1 = __importDefault(require("dayjs/plugin/customParseFormat"));
+const localizedFormat_1 = __importDefault(require("dayjs/plugin/localizedFormat"));
+const relativeTime_1 = __importDefault(require("dayjs/plugin/relativeTime"));
+const timezone_1 = __importDefault(require("dayjs/plugin/timezone"));
+const utc_1 = __importDefault(require("dayjs/plugin/utc"));
+require("dayjs/locale/en");
+require("dayjs/locale/es");
+require("dayjs/locale/fr");
+require("dayjs/locale/pt-br");
+const DEFAULT_INTL_CONFIG = {
+    locale: "pt-BR",
+    options: {
+        month: "long",
+        day: "numeric",
+        year: "numeric",
+    },
+};
+let globalIntlConfig = {
+    locale: DEFAULT_INTL_CONFIG.locale,
+    options: { ...DEFAULT_INTL_CONFIG.options },
+};
+function mergeIntlConfigs(base, override) {
+    var _a;
+    if (!override) {
+        return {
+            locale: base.locale,
+            options: { ...base.options },
+        };
+    }
+    const mergedLocale = (_a = override.locale) !== null && _a !== void 0 ? _a : base.locale;
+    const mergedOptions = { ...base.options };
+    if (override.options) {
+        for (const key of Object.keys(override.options)) {
+            const value = override.options[key];
+            if (value === undefined || value === null) {
+                delete mergedOptions[key];
+            }
+            else {
+                ;
+                mergedOptions[key] = value;
+            }
+        }
+    }
+    return {
+        locale: mergedLocale,
+        options: mergedOptions,
+    };
+}
+const intlPlugin = (pluginConfig, DayjsClass) => {
+    if (pluginConfig) {
+        globalIntlConfig = mergeIntlConfigs(globalIntlConfig, pluginConfig);
+    }
+    const formatIntl = function formatIntl(config) {
+        const resolved = mergeIntlConfigs(globalIntlConfig, config);
+        return new Intl.DateTimeFormat(resolved.locale, resolved.options).format(this.toDate());
+    };
+    const toIntlFormatter = function toIntlFormatter(config) {
+        const resolved = mergeIntlConfigs(globalIntlConfig, config);
+        return new Intl.DateTimeFormat(resolved.locale, resolved.options);
+    };
+    Object.defineProperty(DayjsClass.prototype, "formatIntl", {
+        value: formatIntl,
+        configurable: true,
+    });
+    Object.defineProperty(DayjsClass.prototype, "toIntlFormatter", {
+        value: toIntlFormatter,
+        configurable: true,
+    });
+};
+function getDayjsGlobalIntl() {
+    return {
+        locale: globalIntlConfig.locale,
+        options: { ...globalIntlConfig.options },
+    };
+}
+function setDayjsGlobalIntl(config) {
+    globalIntlConfig = mergeIntlConfigs(globalIntlConfig, config);
+    return getDayjsGlobalIntl();
+}
+function resetDayjsGlobalIntl() {
+    globalIntlConfig = {
+        locale: DEFAULT_INTL_CONFIG.locale,
+        options: { ...DEFAULT_INTL_CONFIG.options },
+    };
+    return getDayjsGlobalIntl();
+}
+function withDayjsGlobalIntl(config, callback) {
+    const previous = getDayjsGlobalIntl();
+    globalIntlConfig = mergeIntlConfigs(globalIntlConfig, config);
+    try {
+        return callback();
+    }
+    finally {
+        globalIntlConfig = {
+            locale: previous.locale,
+            options: { ...previous.options },
+        };
+    }
+}
+function resolveDayjsIntlConfig(config) {
+    return mergeIntlConfigs(globalIntlConfig, config);
+}
+dayjs_1.default.extend(utc_1.default);
+dayjs_1.default.extend(customParseFormat_1.default);
+dayjs_1.default.extend(advancedFormat_1.default);
+dayjs_1.default.extend(timezone_1.default);
+dayjs_1.default.extend(localizedFormat_1.default);
+dayjs_1.default.extend(relativeTime_1.default);
+dayjs_1.default.extend(intlPlugin);
 exports.dayjs = dayjs_1.default;
 //# sourceMappingURL=dayjs.js.map

package/dist/cjs/date/dayjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"dayjs.js","sourceRoot":"","sources":["../../../src/date/dayjs.ts"],"names":[],"mappings":";;;;;;AAAA,kDAAyB;AACzB,uFAA2D;AAC3D,6FAAiE;AACjE,yFAA6D;AAC7D,mFAAuD;AACvD,2EAA+C;AAC/C,iEAAqC;AAErC,eAAK,CAAC,MAAM,CAAC,gBAAG,CAAC,CAAA;AACjB,eAAK,CAAC,MAAM,CAAC,8BAAiB,CAAC,CAAA;AAC/B,eAAK,CAAC,MAAM,CAAC,2BAAc,CAAC,CAAA;AAC5B,eAAK,CAAC,MAAM,CAAC,qBAAQ,CAAC,CAAA;AACtB,eAAK,CAAC,MAAM,CAAC,4BAAe,CAAC,CAAA;AAC7B,eAAK,CAAC,MAAM,CAAC,yBAAY,CAAC,CAAA;AAEb,QAAA,KAAK,GAAG,eAAK,CAAA"}
+{"version":3,"file":"dayjs.js","sourceRoot":"","sources":["../../../src/date/dayjs.ts"],"names":[],"mappings":"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"}

package/dist/cjs/date/format-date.d.ts

@@ -1,2 +1,23 @@
-export declare function formatDate(date: Date | string | number, locale?: Intl.LocalesArgument, opts?: Intl.DateTimeFormatOptions): string;
+import type { IDayjsIntlConfig } from "./dayjs";
+export interface IFormatDateConfig {
+    /** Optional locale override applied to the underlying dayjs instance */
+    locale?: string;
+    /**
+     * When provided, format using dayjs tokens (e.g. "DD/MM/YYYY").
+     * Unless `useIntl` is true, this takes precedence over Intl formatting.
+     */
+    format?: string;
+    /**
+     * Intl configuration used when formatting through `Intl.DateTimeFormat`.
+     * Values are merged on top of the global Intl configuration.
+     */
+    intl?: IDayjsIntlConfig;
+    /**
+     * Forces the use of Intl formatting even if a format string is supplied.
+     */
+    useIntl?: boolean;
+}
+type TLocaleOrConfig = Intl.LocalesArgument | IFormatDateConfig;
+export declare function formatDate(date: Date | string | number, localeOrConfig?: TLocaleOrConfig, opts?: Intl.DateTimeFormatOptions): string;
+export {};
 //# sourceMappingURL=format-date.d.ts.map

package/dist/cjs/date/format-date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format-date.d.ts","sourceRoot":"","sources":["../../../src/date/format-date.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CACxB,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC5B,MAAM,GAAE,IAAI,CAAC,eAAyB,EACtC,IAAI,GAAE,IAAI,CAAC,qBAA0B,UAQtC"}
+{"version":3,"file":"format-date.d.ts","sourceRoot":"","sources":["../../../src/date/format-date.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAG/C,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAA;IACvB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,KAAK,eAAe,GAAG,IAAI,CAAC,eAAe,GAAG,iBAAiB,CAAA;AAqC/D,wBAAgB,UAAU,CACxB,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC5B,cAAc,GAAE,eAA6C,EAC7D,IAAI,CAAC,EAAE,IAAI,CAAC,qBAAqB,GAChC,MAAM,CAkDR"}

package/dist/cjs/date/format-date.js

@@ -1,13 +1,71 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatDate = formatDate;
-function formatDate(date, locale = "pt-BR", opts = {}) {
-    var _a, _b, _c;
-    return new Intl.DateTimeFormat(locale, {
-        month: (_a = opts.month) !== null && _a !== void 0 ? _a : "long",
-        day: (_b = opts.day) !== null && _b !== void 0 ? _b : "numeric",
-        year: (_c = opts.year) !== null && _c !== void 0 ? _c : "numeric",
-        ...opts,
-    }).format(new Date(date));
+const dayjs_1 = require("./dayjs");
+function isFormatDateConfig(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function isValidLocaleTag(value) {
+    if (typeof Intl !== "undefined" &&
+        typeof Intl.getCanonicalLocales === "function") {
+        try {
+            Intl.getCanonicalLocales(value);
+            return true;
+        }
+        catch (_a) {
+            return false;
+        }
+    }
+    return /^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/.test(value);
+}
+function toDayjsLocale(locale) {
+    if (!locale)
+        return undefined;
+    const first = Array.isArray(locale)
+        ? locale[0]
+        : locale;
+    return typeof first === "string" ? first : String(first);
+}
+function formatDate(date, localeOrConfig = (0, dayjs_1.getDayjsGlobalIntl)().locale, opts) {
+    var _a;
+    const instance = (0, dayjs_1.dayjs)(date);
+    if (!instance.isValid()) {
+        throw new RangeError("Invalid time value");
+    }
+    if (isFormatDateConfig(localeOrConfig)) {
+        const { format, locale, intl, useIntl } = localeOrConfig;
+        const baseLocale = locale !== null && locale !== void 0 ? locale : toDayjsLocale(intl === null || intl === void 0 ? void 0 : intl.locale);
+        const workingInstance = baseLocale ? instance.locale(baseLocale) : instance;
+        if (format && !useIntl) {
+            return workingInstance.format(format);
+        }
+        const intlConfig = intl
+            ? {
+                locale: (_a = intl.locale) !== null && _a !== void 0 ? _a : baseLocale,
+                options: intl.options,
+            }
+            : baseLocale
+                ? {
+                    locale: baseLocale,
+                }
+                : undefined;
+        return workingInstance.formatIntl(intlConfig);
+    }
+    if (typeof localeOrConfig === "string" && opts === undefined) {
+        if (!isValidLocaleTag(localeOrConfig)) {
+            return instance.format(localeOrConfig);
+        }
+    }
+    const localeForDayjs = toDayjsLocale(localeOrConfig);
+    const workingInstance = localeForDayjs
+        ? instance.locale(localeForDayjs)
+        : instance;
+    const intlConfig = localeOrConfig !== undefined || opts !== undefined
+        ? {
+            locale: localeOrConfig,
+            options: opts,
+        }
+        : undefined;
+    return workingInstance.formatIntl(intlConfig);
 }
 //# sourceMappingURL=format-date.js.map

package/dist/cjs/date/format-date.js.map

@@ -1 +1 @@
-{"version":3,"file":"format-date.js","sourceRoot":"","sources":["../../../src/date/format-date.ts"],"names":[],"mappings":";;AAAA,gCAWC;AAXD,SAAgB,UAAU,CACxB,IAA4B,EAC5B,SAA+B,OAAO,EACtC,OAAmC,EAAE;;IAErC,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE;QACrC,KAAK,EAAE,MAAA,IAAI,CAAC,KAAK,mCAAI,MAAM;QAC3B,GAAG,EAAE,MAAA,IAAI,CAAC,GAAG,mCAAI,SAAS;QAC1B,IAAI,EAAE,MAAA,IAAI,CAAC,IAAI,mCAAI,SAAS;QAC5B,GAAG,IAAI;KACR,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;AAC3B,CAAC"}
+{"version":3,"file":"format-date.js","sourceRoot":"","sources":["../../../src/date/format-date.ts"],"names":[],"mappings":"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"}

package/dist/cjs/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./api/index.js";
 export * from "./array/index.js";
 export * from "./date/index.js";
 export * from "./files/index.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA"}

package/dist/cjs/index.js

@@ -14,6 +14,7 @@ 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("./api/index.js"), exports); // API utilities
 __exportStar(require("./array/index.js"), exports); // Array utilities
 __exportStar(require("./date/index.js"), exports); // Date utilities
 __exportStar(require("./files/index.js"), exports); // Files utilities

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAgC,CAAC,kBAAkB;AACnD,kDAA+B,CAAC,iBAAiB;AACjD,mDAAgC,CAAC,kBAAkB;AACnD,sDAAmC,CAAC,qBAAqB;AACzD,oDAAiC,CAAC,mBAAmB;AACrD,qDAAkC,CAAC,oBAAoB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA8B,CAAC,gBAAgB;AAC/C,mDAAgC,CAAC,kBAAkB;AACnD,kDAA+B,CAAC,iBAAiB;AACjD,mDAAgC,CAAC,kBAAkB;AACnD,sDAAmC,CAAC,qBAAqB;AACzD,oDAAiC,CAAC,mBAAmB;AACrD,qDAAkC,CAAC,oBAAoB"}

package/dist/date/dayjs.d.ts

@@ -1,3 +1,20 @@
 import dayJs from "dayjs";
+import "dayjs/locale/en";
+import "dayjs/locale/es";
+import "dayjs/locale/fr";
+import "dayjs/locale/pt-br";
+export interface IDayjsIntlConfig {
+    locale?: Intl.LocalesArgument;
+    options?: Intl.DateTimeFormatOptions;
+}
+export interface IDayjsIntlResolvedConfig {
+    locale: Intl.LocalesArgument;
+    options: Intl.DateTimeFormatOptions;
+}
+export declare function getDayjsGlobalIntl(): IDayjsIntlResolvedConfig;
+export declare function setDayjsGlobalIntl(config: IDayjsIntlConfig): IDayjsIntlResolvedConfig;
+export declare function resetDayjsGlobalIntl(): IDayjsIntlResolvedConfig;
+export declare function withDayjsGlobalIntl<T>(config: IDayjsIntlConfig, callback: () => T): T;
+export declare function resolveDayjsIntlConfig(config?: IDayjsIntlConfig): IDayjsIntlResolvedConfig;
 export declare const dayjs: typeof dayJs;
 //# sourceMappingURL=dayjs.d.ts.map

package/dist/date/dayjs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dayjs.d.ts","sourceRoot":"","sources":["../../src/date/dayjs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAezB,eAAO,MAAM,KAAK,cAAQ,CAAA"}
+{"version":3,"file":"dayjs.d.ts","sourceRoot":"","sources":["../../src/date/dayjs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAA;AAOzB,OAAO,iBAAiB,CAAA;AACxB,OAAO,iBAAiB,CAAA;AACxB,OAAO,iBAAiB,CAAA;AACxB,OAAO,oBAAoB,CAAA;AAI3B,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,CAAA;IAC7B,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,CAAA;CACrC;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,IAAI,CAAC,eAAe,CAAA;IAC5B,OAAO,EAAE,IAAI,CAAC,qBAAqB,CAAA;CACpC;AAuFD,wBAAgB,kBAAkB,IAAI,wBAAwB,CAK7D;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,GACvB,wBAAwB,CAG1B;AAED,wBAAgB,oBAAoB,IAAI,wBAAwB,CAM/D;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,CAAC,GAChB,CAAC,CAYH;AAED,wBAAgB,sBAAsB,CACpC,MAAM,CAAC,EAAE,gBAAgB,GACxB,wBAAwB,CAE1B;AAUD,eAAO,MAAM,KAAK,cAAQ,CAAA"}

package/dist/date/format-date.d.ts

@@ -1,2 +1,23 @@
-export declare function formatDate(date: Date | string | number, locale?: Intl.LocalesArgument, opts?: Intl.DateTimeFormatOptions): string;
+import type { IDayjsIntlConfig } from "./dayjs";
+export interface IFormatDateConfig {
+    /** Optional locale override applied to the underlying dayjs instance */
+    locale?: string;
+    /**
+     * When provided, format using dayjs tokens (e.g. "DD/MM/YYYY").
+     * Unless `useIntl` is true, this takes precedence over Intl formatting.
+     */
+    format?: string;
+    /**
+     * Intl configuration used when formatting through `Intl.DateTimeFormat`.
+     * Values are merged on top of the global Intl configuration.
+     */
+    intl?: IDayjsIntlConfig;
+    /**
+     * Forces the use of Intl formatting even if a format string is supplied.
+     */
+    useIntl?: boolean;
+}
+type TLocaleOrConfig = Intl.LocalesArgument | IFormatDateConfig;
+export declare function formatDate(date: Date | string | number, localeOrConfig?: TLocaleOrConfig, opts?: Intl.DateTimeFormatOptions): string;
+export {};
 //# sourceMappingURL=format-date.d.ts.map

package/dist/date/format-date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format-date.d.ts","sourceRoot":"","sources":["../../src/date/format-date.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CACxB,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC5B,MAAM,GAAE,IAAI,CAAC,eAAyB,EACtC,IAAI,GAAE,IAAI,CAAC,qBAA0B,UAQtC"}
+{"version":3,"file":"format-date.d.ts","sourceRoot":"","sources":["../../src/date/format-date.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAG/C,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAA;IACvB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,KAAK,eAAe,GAAG,IAAI,CAAC,eAAe,GAAG,iBAAiB,CAAA;AAqC/D,wBAAgB,UAAU,CACxB,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC5B,cAAc,GAAE,eAA6C,EAC7D,IAAI,CAAC,EAAE,IAAI,CAAC,qBAAqB,GAChC,MAAM,CAkDR"}

package/dist/esm/api/client.js

@@ -0,0 +1,121 @@
+import { apiWrapper } from "./wrapper.js";
+const defaultRetryConfig = {
+    limit: 5,
+    methods: ["get"],
+    statusCodes: [413],
+    backoffLimit: 3000,
+};
+function buildQueryString(params) {
+    const searchParams = new URLSearchParams();
+    Object.entries(params).forEach(([key, value]) => {
+        if (value !== null && value !== undefined) {
+            searchParams.append(key, String(value));
+        }
+    });
+    const queryString = searchParams.toString();
+    return queryString ? `?${queryString}` : "";
+}
+async function beforeRequestHook(request, getAccessToken, getUserIP) {
+    const token = await (getAccessToken === null || getAccessToken === void 0 ? void 0 : getAccessToken());
+    const headers = new Headers(request.headers);
+    if (token) {
+        headers.set("Authorization", `Bearer ${token}`);
+    }
+    const userIP = await (getUserIP === null || getUserIP === void 0 ? void 0 : getUserIP());
+    if (userIP) {
+        headers.set("X-User-IP", userIP);
+    }
+    return new Request(request, { headers });
+}
+async function afterResponseHook(request, response, onSignoutUnauthorized) {
+    const possibleSignInPaths = ["signin", "sign-in", "login"];
+    const isSignInPath = possibleSignInPaths.some((path) => request.url.includes(path));
+    const needsBody = response.status === 401 && !isSignInPath;
+    let responseBody = null;
+    let responseBodyFor401 = null;
+    if (needsBody) {
+        const clone = response.clone();
+        try {
+            responseBody = await clone.json();
+            responseBodyFor401 = responseBody;
+        }
+        catch (_a) {
+            responseBody = await clone.text();
+        }
+    }
+    if (response.status === 401 && !isSignInPath) {
+        return onSignoutUnauthorized === null || onSignoutUnauthorized === void 0 ? void 0 : onSignoutUnauthorized(responseBodyFor401);
+    }
+}
+async function fetchWithRetry(input, init) {
+    var _a, _b, _c, _d;
+    const retryConfig = (init === null || init === void 0 ? void 0 : init.retry) || defaultRetryConfig;
+    const method = ((init === null || init === void 0 ? void 0 : init.method) || "GET").toLowerCase();
+    let attempt = 0;
+    while (true) {
+        attempt++;
+        const response = await fetch(input, init);
+        const shouldRetry = ((_a = retryConfig.statusCodes) === null || _a === void 0 ? void 0 : _a.includes(response.status)) &&
+            ((_b = retryConfig.methods) === null || _b === void 0 ? void 0 : _b.includes(method)) &&
+            attempt < ((_c = retryConfig.limit) !== null && _c !== void 0 ? _c : 5);
+        if (!shouldRetry)
+            return response;
+        const backoff = Math.min(2 ** attempt * 100, (_d = retryConfig.backoffLimit) !== null && _d !== void 0 ? _d : 3000);
+        await new Promise((resolve) => setTimeout(resolve, backoff));
+    }
+}
+async function api(config, endpoint, options = {}) {
+    var _a;
+    let url = endpoint.startsWith("http")
+        ? endpoint
+        : `${(_a = config.baseURL) === null || _a === void 0 ? void 0 : _a.replace(/\/$/, "")}/${endpoint.replace(/^\//, "")}`;
+    // Add query parameters if provided
+    if (options.params) {
+        const queryString = buildQueryString(options.params);
+        url += queryString;
+    }
+    // Apply default options
+    const init = {
+        credentials: "include",
+        ...options,
+    };
+    let body;
+    if (options.json) {
+        body = JSON.stringify(options.json);
+        init.headers = {
+            ...init.headers,
+            "Content-Type": "application/json",
+        };
+    }
+    // Create initial request
+    let request = new Request(url, { ...init, body });
+    // Run pre-request hooks
+    request = await beforeRequestHook(request, config.getAccessToken, config.getUserIP);
+    // Execute request with retry logic
+    const response = await fetchWithRetry(request, init);
+    // Run post-response hooks
+    await afterResponseHook(request, response, config.onSignoutUnauthorized);
+    if (!response.ok) {
+        throw response;
+    }
+    if (response.status === 204) {
+        return null;
+    }
+    const text = await response.text();
+    if (!text) {
+        return null;
+    }
+    return JSON.parse(text);
+}
+export const apiClient = (config) => {
+    const apiConfig = {
+        ...config,
+    };
+    return {
+        get: (url, options) => apiWrapper(() => api(apiConfig, url, options)),
+        post: (url, options) => apiWrapper(() => api(apiConfig, url, { ...options, method: "POST" })),
+        put: (url, options) => apiWrapper(() => api(apiConfig, url, { ...options, method: "PUT" })),
+        delete: (url, options) => apiWrapper(() => api(apiConfig, url, { ...options, method: "DELETE" })),
+        patch: (url, options) => apiWrapper(() => api(apiConfig, url, { ...options, method: "PATCH" })),
+    };
+};

package/dist/esm/api/index.js

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

package/dist/esm/api/wrapper.js

@@ -0,0 +1,148 @@
+import { isAxiosError } from "axios";
+/**
+ * Extracts error properties from Axios errors
+ */
+async function extractAxiosErrorDetails(error) {
+    var _a, _b, _c;
+    const errorObj = {
+        message: error.message || "Axios Error",
+        status: (_a = error.response) === null || _a === void 0 ? void 0 : _a.status,
+        path: (_b = error.config) === null || _b === void 0 ? void 0 : _b.url,
+    };
+    if (((_c = error.response) === null || _c === void 0 ? void 0 : _c.data) && typeof error.response.data === "object") {
+        return await enrichErrorWithData(errorObj, Promise.resolve(error.response.data));
+    }
+    return errorObj;
+}
+/**
+ * Extracts error properties from standard Error objects
+ */
+function extractStandardErrorDetails(error) {
+    const errorObj = {
+        message: error.message,
+    };
+    // Capture any custom properties the error might have
+    const extendedError = error;
+    if (extendedError.code)
+        errorObj.code = String(extendedError.code);
+    if (extendedError.status)
+        errorObj.status = Number(extendedError.status);
+    if (extendedError.details)
+        errorObj.details = extendedError.details;
+    return errorObj;
+}
+/**
+ * Extracts error properties from fetch Response objects
+ */
+async function extractResponseErrorDetails(response) {
+    const errorObj = {
+        message: `HTTP Error ${response.status}: ${response.statusText}`,
+        status: response.status,
+        path: response.url,
+    };
+    try {
+        // Clone the response to avoid consuming the body stream
+        const clonedResponse = response.clone();
+        const errorData = await clonedResponse.json();
+        // Directly enrich the error object with the parsed data
+        if (errorData && typeof errorData === "object") {
+            if ("message" in errorData && errorData.message) {
+                errorObj.message = String(errorData.message);
+            }
+            if ("code" in errorData) {
+                errorObj.code = String(errorData.code);
+            }
+            if ("details" in errorData) {
+                errorObj.details = errorData.details;
+            }
+            else if ("issues" in errorData) {
+                errorObj.details = errorData.issues;
+            }
+            if ("timestamp" in errorData) {
+                errorObj.timestamp = String(errorData.timestamp);
+            }
+        }
+        return errorObj;
+    }
+    catch (_a) {
+        // If JSON parsing fails, return the basic error object
+        return errorObj;
+    }
+}
+/**
+ * Enriches an error object with additional data from response
+ */
+async function enrichErrorWithData(errorObj, errorData, path) {
+    const data = await errorData;
+    if (data) {
+        if ("message" in data) {
+            errorObj.message = String(data.message);
+        }
+        if ("code" in data) {
+            errorObj.code = String(data.code);
+        }
+        if ("details" in data) {
+            errorObj.details = data.details;
+        }
+        else if ("issues" in data) {
+            errorObj.details = data.issues;
+        }
+        if ("timestamp" in data) {
+            errorObj.timestamp = String(data.timestamp);
+        }
+        if (path) {
+            errorObj.path = path;
+        }
+    }
+    return errorObj;
+}
+/**
+ * Determines the type of error and routes to appropriate handler
+ */
+async function processError(error) {
+    if (error instanceof Response) {
+        return extractResponseErrorDetails(error);
+    }
+    if (isAxiosError(error)) {
+        return extractAxiosErrorDetails(error);
+    }
+    if (error instanceof Error) {
+        return extractStandardErrorDetails(error);
+    }
+    // Handle unknown error types
+    return {
+        message: error ? JSON.stringify(error) : "Unknown error",
+    };
+}
+/**
+ * Wraps API calls with standardized error handling
+ *
+ * @param apiCall - The API call function to execute
+ * @param defaultData - Optional default value to return when an error occurs
+ * @returns A standardized result object with data or formatted error message
+ *
+ * @example
+ * // Basic usage
+ * const result = await apiWrapper(() => fetchUserData(userId));
+ *
+ * @example
+ * // With default data value
+ * const result = await apiWrapper(() => fetchPosts(), []);
+ * // result.data will be [] instead of null on error
+ */
+export async function apiWrapper(apiCall, defaultData) {
+    try {
+        const data = await apiCall();
+        return {
+            data,
+            error: null,
+        };
+    }
+    catch (error) {
+        const errorObj = await processError(error);
+        return {
+            data: (defaultData !== null && defaultData !== void 0 ? defaultData : null),
+            error: errorObj,
+        };
+    }
+}