@herowcode/utils 1.3.5 → 1.5.0

package/dist/esm/files/file-delete.js

@@ -1,12 +0,0 @@
-import fs from "node:fs/promises";
-import { fileExists } from "./file-exists.js";
-export const fileDelete = async (filePath) => {
-    try {
-        if (await fileExists(filePath))
-            await fs.rm(filePath);
-    }
-    catch (err) {
-        // Log but don't throw during cleanup
-        console.error(`Error deleting file at ${filePath}:`, err);
-    }
-};

package/dist/esm/files/file-exists.js

@@ -1,10 +0,0 @@
-import fs from "node:fs/promises";
-export const fileExists = async (filePath) => {
-    try {
-        await fs.access(filePath);
-        return true;
-    }
-    catch (_a) {
-        return false;
-    }
-};

package/dist/esm/files/format-bytes.js

@@ -1,13 +0,0 @@
-export function formatBytes(bytes) {
-    if (bytes < 0) {
-        throw new Error("Size in bytes cannot be negative");
-    }
-    const units = ["B", "KB", "MB", "GB", "TB", "PB"];
-    let size = bytes;
-    let index = 0;
-    while (size >= 1024 && index < units.length - 1) {
-        size /= 1024;
-        index++;
-    }
-    return `${size.toFixed(2)} ${units[index]}`;
-}

package/dist/esm/files/index.js

@@ -1,5 +0,0 @@
-export * from "./compress-image.js";
-export * from "./download-url.js";
-export * from "./file-delete.js";
-export * from "./file-exists.js";
-export * from "./format-bytes.js";

package/dist/esm/files.js

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

package/dist/esm/function/debounce.js

@@ -1,22 +0,0 @@
-/**
- * Creates a debounced function that delays invoking func until after delay milliseconds
- * have elapsed since the last time the debounced function was invoked
- * @param fn - The function to debounce
- * @param delay - The number of milliseconds to delay
- * @returns The debounced function
- */
-export function debounce(fn, delay) {
-    if (typeof fn !== "function") {
-        throw new Error("First argument must be a function");
-    }
-    if (typeof delay !== "number" || delay < 0) {
-        throw new Error("Delay must be a non-negative number");
-    }
-    let timeoutId;
-    return function (...args) {
-        if (timeoutId) {
-            clearTimeout(timeoutId);
-        }
-        timeoutId = setTimeout(() => fn.apply(this, args), delay);
-    };
-}

package/dist/esm/function/index.js

@@ -1,3 +0,0 @@
-export * from "./debounce.js";
-export * from "./throttle.js";
-export * from "./try-catch.js";

package/dist/esm/function/throttle.js

@@ -1,32 +0,0 @@
-/**
- * Creates a throttled function that only invokes func at most once per every delay milliseconds
- * @param fn - The function to throttle
- * @param delay - The number of milliseconds to throttle invocations to
- * @returns The throttled function
- */
-export function throttle(fn, delay) {
-    if (typeof fn !== "function") {
-        throw new Error("First argument must be a function");
-    }
-    if (typeof delay !== "number" || delay < 0) {
-        throw new Error("Delay must be a non-negative number");
-    }
-    let lastCall = 0;
-    let timeoutId;
-    return function (...args) {
-        const now = Date.now();
-        if (now - lastCall >= delay) {
-            lastCall = now;
-            fn.apply(this, args);
-        }
-        else {
-            if (timeoutId) {
-                clearTimeout(timeoutId);
-            }
-            timeoutId = setTimeout(() => {
-                lastCall = Date.now();
-                fn.apply(this, args);
-            }, delay - (now - lastCall));
-        }
-    };
-}

package/dist/esm/function/try-catch.js

@@ -1,35 +0,0 @@
-/**
- * Enhanced try-catch utility that handles async operations and provides typed results
- *
- * @param fn - The promise or function returning a promise to execute
- * @param defaultData - Optional default value to use for data when an error occurs (instead of null)
- * @returns A consistent result object containing either data or error
- *
- * @example
- * // With a promise
- * const result = await tryCatch(fetchUserData(userId));
- *
- * @example
- * // With a function that returns a promise
- * const result = await tryCatch(() => fetchUserData(userId));
- *
- * @example
- * // With custom default data
- * const result = await tryCatch(fetchItems(), []);
- * // result.data will be an empty array instead of null when error occurs
- */
-export async function tryCatch(fn, defaultData) {
-    try {
-        const data = await (typeof fn === "function" ? fn() : fn);
-        return {
-            data,
-            error: null,
-        };
-    }
-    catch (error) {
-        return {
-            data: (defaultData !== null && defaultData !== void 0 ? defaultData : null),
-            error: error,
-        };
-    }
-}

package/dist/esm/function.js

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

package/dist/esm/index.js

@@ -1,7 +0,0 @@
-export * from "./api/index.js"; // API utilities
-export * from "./array/index.js"; // Array utilities
-export * from "./date/index.js"; // Date utilities
-export * from "./files/index.js"; // Files utilities
-export * from "./function/index.js"; // Function utilities
-export * from "./string/index.js"; // String utilities
-export * from "./youtube/index.js"; // YouTube utilities

package/dist/esm/string/camel-case.js

@@ -1,21 +0,0 @@
-export function camelCase(str) {
-    if (typeof str !== "string") {
-        throw new Error("Input must be a string");
-    }
-    if (str.length === 0) {
-        return str;
-    }
-    const words = str
-        .toLowerCase()
-        .replace(/[^a-zA-Z0-9\s\-_]/g, "")
-        .split(/[\s\-_]+/)
-        .filter((word) => word.length > 0);
-    if (words.length === 0) {
-        return "";
-    }
-    return (words[0] +
-        words
-            .slice(1)
-            .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
-            .join(""));
-}

package/dist/esm/string/capitalize.js

@@ -1,9 +0,0 @@
-export function capitalize(str) {
-    if (typeof str !== "string") {
-        throw new Error("Input must be a string");
-    }
-    if (str.length === 0) {
-        return str;
-    }
-    return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
-}

package/dist/esm/string/format-hms-to-seconds.js

@@ -1,25 +0,0 @@
-export const formatHMSToSeconds = (val) => {
-    if (val == null || val === "")
-        return null;
-    if (typeof val === "number")
-        return Number.isFinite(val) ? Math.max(0, Math.floor(val)) : null;
-    const s = String(val).trim();
-    // purely numeric string
-    if (/^\d+$/.test(s))
-        return Math.max(0, Number.parseInt(s, 10));
-    // hh:mm:ss or mm:ss
-    if (/^\d{1,2}(:\d{1,2}){1,2}$/.test(s)) {
-        const parts = s.split(":").map((p) => Number.parseInt(p, 10));
-        if (parts.some((n) => Number.isNaN(n)))
-            return null;
-        let seconds = 0;
-        if (parts.length === 3) {
-            seconds = parts[0] * 3600 + parts[1] * 60 + parts[2];
-        }
-        else {
-            seconds = parts[0] * 60 + parts[1];
-        }
-        return Math.max(0, seconds);
-    }
-    return null;
-};

package/dist/esm/string/format-seconds-to-fragment.js

@@ -1,15 +0,0 @@
-/** convert seconds to "1h2m3s" or "42s" style for fragment */
-export const formatSecondsToFragment = (secs) => {
-    const parsedSecs = Math.max(0, Math.floor(secs));
-    const h = Math.floor(parsedSecs / 3600);
-    const m = Math.floor((parsedSecs % 3600) / 60);
-    const s = parsedSecs % 60;
-    let out = "";
-    if (h > 0)
-        out += `${h}h`;
-    if (m > 0)
-        out += `${m}m`;
-    if (s > 0 || out === "")
-        out += `${s}s`;
-    return out;
-};

package/dist/esm/string/format-seconds-to-hms.js

@@ -1,13 +0,0 @@
-export function formatSecondsToHMS(totalSeconds) {
-    const rounded = Math.max(0, Math.round(totalSeconds));
-    const hours = Math.floor(rounded / 3600);
-    const minutes = Math.floor((rounded % 3600) / 60);
-    const seconds = rounded % 60;
-    const hh = String(hours).padStart(2, "0");
-    const mm = String(minutes).padStart(2, "0");
-    const ss = String(seconds).padStart(2, "0");
-    if (hours === 0) {
-        return `${mm}:${ss}`;
-    }
-    return `${hh}:${mm}:${ss}`;
-}

package/dist/esm/string/format-string-to-time.js

@@ -1,10 +0,0 @@
-export const formatStringToTime = (str) => {
-    const stringCleaned = Number(str.replace(/\D/g, "")).toString();
-    if (stringCleaned.length > 4) {
-        return stringCleaned
-            .padStart(6, "0")
-            .slice(0, 6)
-            .replace(/(\d{2})(\d{2})(\d{2})/, "$1:$2:$3");
-    }
-    return stringCleaned.padStart(4, "0").replace(/(\d{2})(\d{2})/, "$1:$2");
-};

package/dist/esm/string/index.js

@@ -1,13 +0,0 @@
-export * from "./camel-case.js";
-export * from "./capitalize.js";
-export * from "./format-hms-to-seconds.js";
-export * from "./format-seconds-to-fragment.js";
-export * from "./format-seconds-to-hms.js";
-export * from "./format-string-to-time.js";
-export * from "./kebab-case.js";
-export * from "./markdown-to-text.js";
-export * from "./remove-html-tags.js";
-export * from "./slugify.js";
-export * from "./snake-case.js";
-export * from "./to-sentence-case.js";
-export * from "./truncate.js";

package/dist/esm/string/kebab-case.js

@@ -1,11 +0,0 @@
-export function kebabCase(str) {
-    if (typeof str !== "string") {
-        throw new Error("Input must be a string");
-    }
-    return str
-        .replace(/([a-z])([A-Z])/g, "$1-$2")
-        .replace(/[\s_]+/g, "-")
-        .replace(/[^a-zA-Z0-9-]/g, "")
-        .toLowerCase()
-        .replace(/^-+|-+$/g, "");
-}

package/dist/esm/string/markdown-to-text.js

@@ -1,66 +0,0 @@
-export function markdownToText(markdown) {
-    if (!markdown)
-        return "";
-    // normalize newlines
-    let text = markdown.replace(/\r\n?/g, "\n");
-    // Remove code fences but keep inner content (trim surrounding newlines to avoid extra blank lines)
-    text = text.replace(/```[\s\S]*?```/g, (m) => {
-        const inner = m.replace(/^```.*\n?/, "").replace(/```$/, "");
-        return inner.replace(/^\n+|\n+$/g, "");
-    });
-    // Remove inline code backticks
-    text = text.replace(/`([^`]+)`/g, "$1");
-    // Images: keep alt text if present
-    text = text.replace(/!\[([^\]]*)\]\((?:[^)]+)\)/g, "$1");
-    // Links: keep link text
-    text = text.replace(/\[([^\]]+)\]\((?:[^)]+)\)/g, "$1");
-    // Reference-style links: [text][id] -> text
-    text = text.replace(/\[([^\]]+)\]\s*\[[^\]]*\]/g, "$1");
-    // Remove footnote markers like [^1] (do this before we mutate surrounding lines)
-    text = text.replace(/\[\^[^\]]+\]/g, "");
-    // Remove reference definitions like: [id]: url (and footnote defs like [^1]: note)
-    // Remove the entire definition line including its trailing newline to avoid leaving blank lines
-    text = text.replace(/^\s*\[[^\]]+\]:\s*.*(?:\r\n?|\n)?/gm, "");
-    text = text.replace(/^\s*\[\^[^\]]+\]:\s*.*(?:\r\n?|\n)?/gm, "");
-    // Remove HTML tags but keep inner text
-    text = text.replace(/<\/?[^>]+>/g, "");
-    // Remove emphasis markers (bold/italic/strikethrough), preserve text
-    text = text.replace(/(\*\*|__)(.*?)\1/g, "$2");
-    text = text.replace(/(\*|_)(.*?)\1/g, "$2");
-    text = text.replace(/~~(.*?)~~/g, "$1");
-    // Remove headings (#, ##, etc.)
-    text = text.replace(/^\s{0,3}#{1,6}\s*/gm, "");
-    // Remove blockquote markers
-    text = text.replace(/^\s{0,3}>\s?/gm, "");
-    // Remove list markers (ordered and unordered)
-    text = text.replace(/^\s{0,3}([-+*]|\d+\.)\s+/gm, "");
-    // Remove table separator lines and keep table cell content by replacing pipes with spaced pipes
-    // Match the separator line and any trailing newline so we don't leave an empty line behind
-    // Remove separator lines entirely (don't insert an extra newline)
-    text = text.replace(/^\s*\|?(?:\s*:?-+:?\s*\|)+\s*(?:\r\n?|\n)?/gm, "");
-    text = text.replace(/\|/g, " | ");
-    // Trim leading whitespace on each line (fixes leading space introduced by replacing pipes)
-    text = text.replace(/^[ \t]+/gm, "");
-    // Fix table spacing edge-case: when a cell starts with two spaces before a digit (caused by adding spaces around pipes), collapse to a single space
-    text = text.replace(/\|\s{2}(?=\d)/g, "| ");
-    // Remove footnote markers like [^1]
-    text = text.replace(/\[\^[^\]]+\]/g, "");
-    // Remove any leftover footnote-definition fragments that may have been concatenated to the previous line
-    // e.g. "Text^1: note" -> "Text"
-    text = text.replace(/\^[0-9]+:\s*.*(?:\r\n?|\n)?/g, "");
-    // Decode a few common HTML entities
-    const entities = {
-        "&amp;": "&",
-        "&lt;": "<",
-        "&gt;": ">",
-        "&quot;": '"',
-        "&#39;": "'",
-    };
-    text = text.replace(/&[a-zA-Z0-9#]+;/g, (e) => { var _a; return (_a = entities[e]) !== null && _a !== void 0 ? _a : e; });
-    // Trim trailing whitespace on each line
-    text = text.replace(/[ \t]+$/gm, "");
-    // Collapse excessive blank lines to at most two (preserve paragraph breaks)
-    text = text.replace(/\n{3,}/g, "\n\n");
-    // Final trim but preserve leading/trailing single newlines inside content as needed
-    return text.trim();
-}

package/dist/esm/string/remove-html-tags.js

@@ -1,14 +0,0 @@
-export function removeHtmlTags(input) {
-    // Input validation
-    if (!input || typeof input !== "string") {
-        return "";
-    }
-    // Apply reasonable input length limit for safety
-    const maxLength = 100000; // Adjust based on your requirements
-    let updatedInput = input;
-    if (updatedInput.length > maxLength) {
-        updatedInput = updatedInput.slice(0, maxLength);
-    }
-    // Use a non-backtracking approach to prevent ReDoS vulnerabilities
-    return updatedInput.replace(/<(?:[^>"']|"[^"]*"|'[^']*')*>/g, "");
-}

package/dist/esm/string/slugify.js

@@ -1,9 +0,0 @@
-export function slugify(text) {
-    return text
-        .normalize("NFD")
-        .replace(/[\u0300-\u036f]/g, "")
-        .replace(/[^\w\s]/gi, "")
-        .trim()
-        .replace(/\s+/g, "-")
-        .toLowerCase();
-}

package/dist/esm/string/snake-case.js

@@ -1,11 +0,0 @@
-export function snakeCase(str) {
-    if (typeof str !== "string") {
-        throw new Error("Input must be a string");
-    }
-    return str
-        .replace(/([a-z])([A-Z])/g, "$1_$2")
-        .replace(/[\s-]+/g, "_")
-        .replace(/[^a-zA-Z0-9_]/g, "")
-        .toLowerCase()
-        .replace(/^_+|_+$/g, "");
-}

package/dist/esm/string/to-sentence-case.js

@@ -1,9 +0,0 @@
-export function toSentenceCase(str) {
-    return str
-        .replace(/_/g, " ")
-        .replace(/([A-Z])/g, " $1")
-        .toLowerCase()
-        .replace(/^\w/, (c) => c.toUpperCase())
-        .replace(/\s+/g, " ")
-        .trim();
-}

package/dist/esm/string/truncate.js

@@ -1,15 +0,0 @@
-export function truncate(str, length, suffix = "...") {
-    if (typeof str !== "string") {
-        throw new Error("Input must be a string");
-    }
-    if (typeof length !== "number" || length < 0) {
-        throw new Error("Length must be a non-negative number");
-    }
-    if (str.length <= length) {
-        return str;
-    }
-    if (length === 0) {
-        return suffix;
-    }
-    return str.slice(0, Math.max(0, length - suffix.length)) + suffix;
-}

package/dist/esm/string.js

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

package/dist/esm/youtube/extract-youtube-video-id.js

@@ -1,26 +0,0 @@
-export function extractYouTubeId(urlString) {
-    if (!urlString)
-        return null;
-    try {
-        const url = new URL(urlString);
-        const hostname = url.hostname.toLowerCase();
-        const pathname = url.pathname;
-        if (hostname.includes("youtu.be")) {
-            const id = pathname.replace(/^\/+/, "").split(/[?&#]/)[0];
-            return id || null;
-        }
-        if (hostname.includes("youtube.com")) {
-            if (url.searchParams.has("v")) {
-                return url.searchParams.get("v");
-            }
-            const parts = pathname.split("/").filter(Boolean);
-            const last = parts[parts.length - 1];
-            if (last)
-                return last.split(/[?&#]/)[0] || null;
-        }
-    }
-    catch (_a) { }
-    const regex = /(?:v=|\/embed\/|\/shorts\/|youtu\.be\/)([0-9A-Za-z_-]{6,})/i;
-    const match = urlString.match(regex);
-    return match ? match[1] : null;
-}

package/dist/esm/youtube/generate-youtube-url.js

@@ -1,81 +0,0 @@
-import { formatHMSToSeconds, formatSecondsToFragment } from "../string.js";
-import { extractYouTubeId } from "./extract-youtube-video-id.js";
-export const generateYoutubeURL = (opts) => {
-    const { videoURL, start, end, embed = false, short = false, useFragment = false, autoplay, controls, rel, loop, mute, modestbranding, origin, playlist, params = {}, } = opts;
-    const videoId = extractYouTubeId(videoURL);
-    if (!videoId)
-        return null;
-    const startSec = formatHMSToSeconds(start);
-    const endSec = formatHMSToSeconds(end);
-    // base url
-    const base = embed
-        ? `https://www.youtube.com/embed/${videoId}`
-        : short
-            ? `https://youtu.be/${videoId}`
-            : "https://www.youtube.com/watch";
-    const search = new URLSearchParams();
-    // Add video ID for watch URLs
-    if (!embed && !short) {
-        search.set("v", videoId);
-    }
-    // Standard param names for watch/embed
-    if (!useFragment) {
-        if (startSec != null) {
-            // youtu.be historically uses "t" as a query param, but "start" is widely supported.
-            // Use "t" for short links, otherwise "start".
-            search.set(short ? "t" : "start", String(startSec));
-        }
-        if (endSec != null) {
-            search.set("end", String(endSec));
-        }
-    }
-    // embed / player related params
-    if (typeof autoplay !== "undefined")
-        search.set("autoplay", autoplay ? "1" : "0");
-    if (typeof controls !== "undefined")
-        search.set("controls", String(controls));
-    if (typeof rel !== "undefined")
-        search.set("rel", String(rel));
-    if (typeof modestbranding !== "undefined")
-        search.set("modestbranding", String(modestbranding));
-    if (typeof origin !== "undefined")
-        search.set("origin", origin);
-    if (typeof mute !== "undefined")
-        search.set("mute", mute ? "1" : "0");
-    // loop requires playlist param when embedding a single video
-    if (loop) {
-        search.set("loop", "1");
-        if (playlist) {
-            search.set("playlist", playlist);
-        }
-        else if (embed) {
-            // for embed+loop, YouTube expects &playlist=VIDEO_ID
-            search.set("playlist", videoId);
-        }
-    }
-    else if (playlist) {
-        search.set("playlist", playlist);
-    }
-    // merge custom params (allow overriding)
-    Object.entries(params).forEach(([k, v]) => {
-        if (v === false)
-            search.set(k, "0");
-        else if (v === true)
-            search.set(k, "1");
-        else
-            search.set(k, String(v));
-    });
-    const qs = search.toString() ? `?${search.toString()}` : "";
-    // fragment handling (e.g. #t=1m2s)
-    let fragment = "";
-    if (useFragment && startSec != null) {
-        fragment = `#t=${formatSecondsToFragment(startSec)}`;
-    }
-    // For short links, people often prefer the short host and start as query or fragment.
-    if (short) {
-        // prefer fragment if requested, otherwise use search params (t)
-        return `${base}${qs}${fragment}`;
-    }
-    // watch/embed links
-    return `${base}${qs}${fragment}`;
-};