@herowcode/utils 1.3.4 → 1.4.8

package/dist/date/get-relative-time.d.ts

@@ -1,3 +0,0 @@
-import type { ConfigType } from "dayjs";
-export declare function getRelativeTime(date: ConfigType, dateNow?: import("dayjs").Dayjs): string;
-//# sourceMappingURL=get-relative-time.d.ts.map

package/dist/date/get-relative-time.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"get-relative-time.d.ts","sourceRoot":"","sources":["../../src/date/get-relative-time.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAGvC,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,wBAAU,GAAG,MAAM,CAE3E"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/date/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,uBAAuB,CAAA;AACrC,cAAc,eAAe,CAAA;AAC7B,cAAc,2BAA2B,CAAA;AACzC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA"}

package/dist/date/parse-time-spent.d.ts

@@ -1,15 +0,0 @@
-export interface ITimeSpent {
-    years: number;
-    months: number;
-    days: number;
-    hours: number;
-    minutes: number;
-    seconds: number;
-    formatted: string;
-}
-export declare function parseTimeSpent(initialDate: string | Date, finalDate: string | Date, locale?: string, // Default to Portuguese for backward compatibility
-options?: {
-    format?: "verbose" | "compact";
-    minimal?: boolean;
-}): ITimeSpent;
-//# sourceMappingURL=parse-time-spent.d.ts.map

package/dist/date/parse-time-spent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"parse-time-spent.d.ts","sourceRoot":"","sources":["../../src/date/parse-time-spent.ts"],"names":[],"mappings":"AA2HA,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB;AAGD,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,MAAM,SAAU,EAAE,mDAAmD;AACrE,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9D,UAAU,CAkHZ"}

package/dist/esm/api/client.js

@@ -1,143 +0,0 @@
-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);
-    }
-    let body;
-    try {
-        const cloned = request.clone();
-        const text = await cloned.text();
-        body = text === "" ? undefined : text;
-    }
-    catch (_a) {
-        body = undefined;
-    }
-    return new Request(request, { headers, body });
-}
-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 (_b) {
-            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 _b, _c, _d, _e;
-    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 = ((_b = retryConfig.statusCodes) === null || _b === void 0 ? void 0 : _b.includes(response.status)) &&
-            ((_c = retryConfig.methods) === null || _c === void 0 ? void 0 : _c.includes(method)) &&
-            attempt < ((_d = retryConfig.limit) !== null && _d !== void 0 ? _d : 5);
-        if (!shouldRetry)
-            return response;
-        const backoff = Math.min(2 ** attempt * 100, (_e = retryConfig.backoffLimit) !== null && _e !== void 0 ? _e : 3000);
-        await new Promise((resolve) => setTimeout(resolve, backoff));
-    }
-}
-async function api(config, endpoint, options = {}) {
-    var _b, _c;
-    let url = endpoint.startsWith("http")
-        ? endpoint
-        : `${(_b = config.baseURL) === null || _b === void 0 ? void 0 : _b.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 !== undefined && options.json !== null) {
-        body = JSON.stringify(options.json);
-        // Only add Content-Type if body is not empty
-        if (body && body !== "null" && body !== "undefined") {
-            init.headers = {
-                ...init.headers,
-                "Content-Type": "application/json",
-            };
-        }
-    }
-    // Remove Content-Type application/json if there's no body
-    if (!body) {
-        const headers = new Headers(init.headers);
-        if (((_c = headers.get("Content-Type")) === null || _c === void 0 ? void 0 : _c.toLowerCase()) === "application/json") {
-            headers.delete("Content-Type");
-            init.headers = headers;
-        }
-    }
-    // Create initial request
-    let request = new Request(url, { ...init, body });
-    // Run pre-request hooks
-    request = await beforeRequestHook(request, config.getAccessToken, config.getUserIP);
-    // Keep init headers in sync with the mutated request so fetch keeps auth headers
-    init.headers = new Headers(request.headers);
-    // 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

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

package/dist/esm/api/wrapper.js

@@ -1,148 +0,0 @@
-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,
-        };
-    }
-}

package/dist/esm/array/index.js

@@ -1,2 +0,0 @@
-export * from "./shuffle.js";
-export * from "./unique.js";

package/dist/esm/array/shuffle.js

@@ -1,12 +0,0 @@
-export function shuffle(array) {
-    const shuffled = [...array];
-    for (let i = shuffled.length - 1; i > 0; i--) {
-        // Get cryptographically strong random values
-        const randomBuffer = new Uint32Array(1);
-        crypto.getRandomValues(randomBuffer);
-        // Use modulo to get a value in our range
-        const j = randomBuffer[0] % (i + 1);
-        [shuffled[i], shuffled[j]] = [shuffled[j], shuffled[i]];
-    }
-    return shuffled;
-}

package/dist/esm/array/unique.js

@@ -1,3 +0,0 @@
-export function unique(array) {
-    return [...new Set(array)];
-}

package/dist/esm/array.js

@@ -1 +0,0 @@
-export * from './array/index.js'

package/dist/esm/date/dayjs.js

@@ -1,111 +0,0 @@
-import dayJs from "dayjs";
-import advancedFormat from "dayjs/plugin/advancedFormat";
-import customParseFormat from "dayjs/plugin/customParseFormat";
-import localizedFormat from "dayjs/plugin/localizedFormat";
-import relativeTime from "dayjs/plugin/relativeTime";
-import timezone from "dayjs/plugin/timezone";
-import utc from "dayjs/plugin/utc";
-import "dayjs/locale/en";
-import "dayjs/locale/es";
-import "dayjs/locale/fr";
-import "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,
-    });
-};
-export function getDayjsGlobalIntl() {
-    return {
-        locale: globalIntlConfig.locale,
-        options: { ...globalIntlConfig.options },
-    };
-}
-export function setDayjsGlobalIntl(config) {
-    globalIntlConfig = mergeIntlConfigs(globalIntlConfig, config);
-    return getDayjsGlobalIntl();
-}
-export function resetDayjsGlobalIntl() {
-    globalIntlConfig = {
-        locale: DEFAULT_INTL_CONFIG.locale,
-        options: { ...DEFAULT_INTL_CONFIG.options },
-    };
-    return getDayjsGlobalIntl();
-}
-export function withDayjsGlobalIntl(config, callback) {
-    const previous = getDayjsGlobalIntl();
-    globalIntlConfig = mergeIntlConfigs(globalIntlConfig, config);
-    try {
-        return callback();
-    }
-    finally {
-        globalIntlConfig = {
-            locale: previous.locale,
-            options: { ...previous.options },
-        };
-    }
-}
-export function resolveDayjsIntlConfig(config) {
-    return mergeIntlConfigs(globalIntlConfig, config);
-}
-dayJs.extend(utc);
-dayJs.extend(customParseFormat);
-dayJs.extend(advancedFormat);
-dayJs.extend(timezone);
-dayJs.extend(localizedFormat);
-dayJs.extend(relativeTime);
-dayJs.extend(intlPlugin);
-export const dayjs = dayJs;

package/dist/esm/date/fix-timezone-offset.js

@@ -1,5 +0,0 @@
-import { dayjs } from "./dayjs.js";
-export function fixTimezoneOffset(utcDate) {
-    const offset = new Date(utcDate).getTimezoneOffset();
-    return dayjs(utcDate).add(offset, "minute");
-}

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

@@ -1,67 +0,0 @@
-import { dayjs, getDayjsGlobalIntl } from "./dayjs.js";
-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);
-}
-export function formatDate(date, localeOrConfig = getDayjsGlobalIntl().locale, opts) {
-    var _a;
-    const instance = 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);
-}

package/dist/esm/date/get-current-date-in-utc.js

@@ -1,4 +0,0 @@
-import { dayjs } from "./dayjs.js";
-export function getCurrentDateInUTC() {
-    return dayjs().utc();
-}

package/dist/esm/date/get-date-in-utc.js

@@ -1,4 +0,0 @@
-import { dayjs } from "./dayjs.js";
-export function getDateInUTC(date) {
-    return dayjs(date).utc();
-}

package/dist/esm/date/get-relative-time.js

@@ -1,4 +0,0 @@
-import { dayjs } from "./dayjs.js";
-export function getRelativeTime(date, dateNow = dayjs()) {
-    return dayjs(date).from(dateNow);
-}

package/dist/esm/date/index.js

@@ -1,7 +0,0 @@
-export * from "./dayjs.js";
-export * from "./fix-timezone-offset.js";
-export * from "./format-date.js";
-export * from "./get-current-date-in-utc.js";
-export * from "./get-date-in-utc.js";
-export * from "./get-relative-time.js";
-export * from "./parse-time-spent.js";