@herowcode/utils 1.3.5 → 1.5.0

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

package/dist/esm/date/parse-time-spent.js

@@ -1,203 +0,0 @@
-import { fixTimezoneOffset } from "./fix-timezone-offset.js";
-// Supported locales and their translations
-const locales = {
-    "pt-BR": {
-        year: { singular: "ano", plural: "anos" },
-        month: { singular: "mês", plural: "meses" },
-        day: { singular: "dia", plural: "dias" },
-        hour: { singular: "hora", plural: "horas" },
-        minute: { singular: "minuto", plural: "minutos" },
-        second: { singular: "segundo", plural: "segundos" },
-        formatList: (parts) => {
-            if (parts.length === 0)
-                return "";
-            if (parts.length === 1)
-                return parts[0];
-            const lastPart = parts[parts.length - 1];
-            const otherParts = parts.slice(0, -1);
-            return `${otherParts.join(", ")} e ${lastPart}`;
-        },
-        compactTokens: {
-            year: "a",
-            month: "m",
-            day: "d",
-            hour: "h",
-            minute: "min",
-            second: "s",
-        },
-    },
-    "en-US": {
-        year: { singular: "year", plural: "years" },
-        month: { singular: "month", plural: "months" },
-        day: { singular: "day", plural: "days" },
-        hour: { singular: "hour", plural: "hours" },
-        minute: { singular: "minute", plural: "minutes" },
-        second: { singular: "second", plural: "seconds" },
-        formatList: (parts) => {
-            if (parts.length === 0)
-                return "";
-            if (parts.length === 1)
-                return parts[0];
-            if (parts.length === 2)
-                return `${parts[0]} and ${parts[1]}`;
-            return `${parts.slice(0, -1).join(", ")}, and ${parts[parts.length - 1]}`;
-        },
-        compactTokens: {
-            year: "y",
-            month: "mo",
-            day: "d",
-            hour: "h",
-            minute: "m",
-            second: "s",
-        },
-    },
-    "es-ES": {
-        year: { singular: "año", plural: "años" },
-        month: { singular: "mes", plural: "meses" },
-        day: { singular: "día", plural: "días" },
-        hour: { singular: "hora", plural: "horas" },
-        minute: { singular: "minuto", plural: "minutos" },
-        second: { singular: "segundo", plural: "segundos" },
-        formatList: (parts) => {
-            if (parts.length === 0)
-                return "";
-            if (parts.length === 1)
-                return parts[0];
-            const lastPart = parts[parts.length - 1];
-            const otherParts = parts.slice(0, -1);
-            return `${otherParts.join(", ")} y ${lastPart}`;
-        },
-        compactTokens: {
-            year: "a",
-            month: "mes",
-            day: "d",
-            hour: "h",
-            minute: "min",
-            second: "s",
-        },
-    },
-    "fr-FR": {
-        year: { singular: "an", plural: "ans" },
-        month: { singular: "mois", plural: "mois" },
-        day: { singular: "jour", plural: "jours" },
-        hour: { singular: "heure", plural: "heures" },
-        minute: { singular: "minute", plural: "minutes" },
-        second: { singular: "seconde", plural: "secondes" },
-        formatList: (parts) => {
-            if (parts.length === 0)
-                return "";
-            if (parts.length === 1)
-                return parts[0];
-            const lastPart = parts[parts.length - 1];
-            const otherParts = parts.slice(0, -1);
-            return `${otherParts.join(", ")} et ${lastPart}`;
-        },
-        compactTokens: {
-            year: "a",
-            month: "m",
-            day: "j",
-            hour: "h",
-            minute: "min",
-            second: "s",
-        },
-    },
-};
-// options: format -> 'verbose' | 'compact', minimal -> show only largest non-zero unit
-export function parseTimeSpent(initialDate, finalDate, locale = "pt-BR", // Default to Portuguese for backward compatibility
-options) {
-    var _a, _b;
-    const final = fixTimezoneOffset(finalDate);
-    const initial = fixTimezoneOffset(initialDate);
-    const years = final.diff(initial, "year");
-    const months = final.diff(initial.add(years, "year"), "month");
-    const days = final.diff(initial.add(years, "year").add(months, "month"), "day");
-    const hours = final.diff(initial.add(years, "year").add(months, "month").add(days, "day"), "hour");
-    const minutes = final.diff(initial
-        .add(years, "year")
-        .add(months, "month")
-        .add(days, "day")
-        .add(hours, "hour"), "minute");
-    const seconds = final.diff(initial
-        .add(years, "year")
-        .add(months, "month")
-        .add(days, "day")
-        .add(hours, "hour")
-        .add(minutes, "minute"), "second");
-    // Use default locale if the requested one isn't supported
-    const translations = locales[locale] || locales["pt-BR"];
-    // Build verbose parts (localized words)
-    const verboseParts = [];
-    if (years > 0) {
-        const unit = years === 1 ? translations.year.singular : translations.year.plural;
-        verboseParts.push(`${years} ${unit}`);
-    }
-    if (months > 0) {
-        const unit = months === 1 ? translations.month.singular : translations.month.plural;
-        verboseParts.push(`${months} ${unit}`);
-    }
-    if (days > 0) {
-        const unit = days === 1 ? translations.day.singular : translations.day.plural;
-        verboseParts.push(`${days} ${unit}`);
-    }
-    if (hours > 0) {
-        const unit = hours === 1 ? translations.hour.singular : translations.hour.plural;
-        verboseParts.push(`${hours} ${unit}`);
-    }
-    if (minutes > 0) {
-        const unit = minutes === 1 ? translations.minute.singular : translations.minute.plural;
-        verboseParts.push(`${minutes} ${unit}`);
-    }
-    if (seconds > 0) {
-        const unit = seconds === 1 ? translations.second.singular : translations.second.plural;
-        verboseParts.push(`${seconds} ${unit}`);
-    }
-    // Build compact parts (e.g. "1a2m3d")
-    const compactPieces = [];
-    if (years > 0)
-        compactPieces.push(`${years}${translations.compactTokens.year}`);
-    if (months > 0)
-        compactPieces.push(`${months}${translations.compactTokens.month}`);
-    if (days > 0)
-        compactPieces.push(`${days}${translations.compactTokens.day}`);
-    if (hours > 0)
-        compactPieces.push(`${hours}${translations.compactTokens.hour}`);
-    if (minutes > 0)
-        compactPieces.push(`${minutes}${translations.compactTokens.minute}`);
-    if (seconds > 0)
-        compactPieces.push(`${seconds}${translations.compactTokens.second}`);
-    const format = (_a = options === null || options === void 0 ? void 0 : options.format) !== null && _a !== void 0 ? _a : "verbose";
-    const minimal = (_b = options === null || options === void 0 ? void 0 : options.minimal) !== null && _b !== void 0 ? _b : false;
-    let formatted = "";
-    if (format === "compact") {
-        if (compactPieces.length === 0) {
-            formatted = "";
-        }
-        else if (minimal) {
-            formatted = compactPieces[0];
-        }
-        else {
-            formatted = compactPieces.join("");
-        }
-    }
-    else {
-        // verbose
-        if (verboseParts.length === 0) {
-            formatted = "";
-        }
-        else if (minimal) {
-            formatted = verboseParts[0];
-        }
-        else {
-            formatted = translations.formatList(verboseParts);
-        }
-    }
-    return {
-        years,
-        months,
-        days,
-        hours,
-        minutes,
-        seconds,
-        formatted,
-    };
-}

package/dist/esm/date.js

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

package/dist/esm/files/compress-image.js

@@ -1,57 +0,0 @@
-function convertToWebp(filename) {
-    const lastDotIndex = filename.lastIndexOf(".");
-    if (lastDotIndex === -1) {
-        return `${filename}.webp`;
-    }
-    return `${filename.substring(0, lastDotIndex)}.webp`;
-}
-export function compressImage({ file, maxWidth = Number.POSITIVE_INFINITY, maxHeight = Number.POSITIVE_INFINITY, quality = 1, allowedFileTypes = ["image/jpg", "image/jpeg", "image/png", "image/webp"], }) {
-    if (!allowedFileTypes.includes(file.type)) {
-        throw new Error("Image format not supported");
-    }
-    return new Promise((resolve, reject) => {
-        const reader = new FileReader();
-        reader.onload = (event) => {
-            var _a;
-            const compressed = new Image();
-            compressed.onload = () => {
-                const canvas = document.createElement("canvas");
-                let width = compressed.width;
-                let height = compressed.height;
-                if (width > height) {
-                    if (width > maxWidth) {
-                        height *= maxWidth / width;
-                        width = maxWidth;
-                    }
-                }
-                else {
-                    if (height > maxHeight) {
-                        width *= maxHeight / height;
-                        height = maxHeight;
-                    }
-                }
-                canvas.width = width;
-                canvas.height = height;
-                const context = canvas.getContext("2d");
-                if (!context) {
-                    reject(new Error("Failed to get canvas context"));
-                    return;
-                }
-                context.drawImage(compressed, 0, 0, width, height);
-                canvas.toBlob((blob) => {
-                    if (!blob) {
-                        reject(new Error("Failed to compress image."));
-                        return;
-                    }
-                    const compressedFile = new File([blob], convertToWebp(file.name), {
-                        type: "image/webp",
-                        lastModified: Date.now(),
-                    });
-                    resolve(compressedFile);
-                }, "image/webp", quality);
-            };
-            compressed.src = (_a = event.target) === null || _a === void 0 ? void 0 : _a.result;
-        };
-        reader.readAsDataURL(file);
-    });
-}

package/dist/esm/files/download-url.js

@@ -1,24 +0,0 @@
-export const downloadUrl = async (url) => {
-    try {
-        const urlObj = new URL(url);
-        const pathname = urlObj.pathname;
-        const segments = pathname.split("/").filter((segment) => segment.length > 0);
-        const filename = segments.length > 0 ? segments[segments.length - 1] : null;
-        if (!filename || !filename.includes(".")) {
-            throw new Error("URL does not contain a valid filename");
-        }
-        const response = await fetch(url, { mode: "cors" });
-        const blob = await response.blob();
-        const link = document.createElement("a");
-        link.href = window.URL.createObjectURL(blob);
-        link.download = filename;
-        document.body.appendChild(link);
-        link.click();
-        document.body.removeChild(link);
-        return true;
-    }
-    catch (error) {
-        console.error("Error downloading the file", error);
-        return false;
-    }
-};