@herowcode/utils 1.0.2 → 1.1.1

package/dist/youtube/use-get-video-duration.esm.js

@@ -0,0 +1,150 @@
+/** biome-ignore-all lint/suspicious/noExplicitAny: Window is any */
+import { useCallback } from "react";
+import { formatSecondsToHMS } from "../string";
+import { extractYouTubeId } from "./extract-youtube-video-id";
+import { validateYoutubeLink } from "./validate-youtube-link";
+let YtApiLoading = null;
+function loadYouTubeIFrameAPI() {
+    var _a;
+    if ((_a = window.YT) === null || _a === void 0 ? void 0 : _a.Player)
+        return Promise.resolve();
+    if (YtApiLoading)
+        return YtApiLoading;
+    YtApiLoading = new Promise((resolve) => {
+        const existing = document.querySelector('script[src="https://www.youtube.com/iframe_api"]');
+        if (existing) {
+            // Poll until the API is ready
+            const poll = setInterval(() => {
+                var _a;
+                if ((_a = window.YT) === null || _a === void 0 ? void 0 : _a.Player) {
+                    clearInterval(poll);
+                    resolve();
+                }
+            }, 50);
+            return;
+        }
+        const tag = document.createElement("script");
+        tag.src = "https://www.youtube.com/iframe_api";
+        tag.async = true;
+        document.body.appendChild(tag);
+        window.onYouTubeIframeAPIReady = () => {
+            resolve();
+        };
+    });
+    return YtApiLoading;
+}
+/**
+ * useGetYoutubeVideoDuration
+ * Returns a function that accepts a YouTube URL (full or short) and returns a Promise
+ * resolving to the video duration formatted as "HH:MM:SS" or null on failure.
+ */
+export function useGetYoutubeVideoDuration() {
+    const getYoutubeVideoDuration = useCallback(async (videoUrl) => {
+        const videoId = extractYouTubeId(videoUrl);
+        if (!videoId)
+            return null;
+        const videoIsValid = await validateYoutubeLink(videoUrl);
+        if (!videoIsValid)
+            return null;
+        try {
+            await loadYouTubeIFrameAPI();
+        }
+        catch (_a) {
+            return null;
+        }
+        return await new Promise((resolve) => {
+            const iframeId = `yt-duration-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+            const iframe = document.createElement("iframe");
+            // create a minimal offscreen iframe for the player
+            iframe.id = iframeId;
+            iframe.style.position = "fixed";
+            iframe.style.left = "-9999px";
+            iframe.style.width = "1px";
+            iframe.style.height = "1px";
+            iframe.style.opacity = "0";
+            iframe.style.pointerEvents = "none";
+            // embed URL with enablejsapi so we can construct YT.Player
+            const origin = window.location.origin;
+            iframe.src = `https://www.youtube.com/embed/${encodeURIComponent(videoId)}?enablejsapi=1&origin=${encodeURIComponent(origin)}`;
+            let resolved = false;
+            let player = null;
+            let cleanupTimeout = null;
+            function cleanupAndResolve(result) {
+                if (resolved)
+                    return;
+                resolved = true;
+                try {
+                    if (player && typeof player.destroy === "function")
+                        player.destroy();
+                }
+                catch (_a) {
+                    /* ignore */
+                }
+                try {
+                    if (iframe.parentNode)
+                        iframe.parentNode.removeChild(iframe);
+                }
+                catch (_b) {
+                    /* ignore */
+                }
+                if (cleanupTimeout)
+                    window.clearTimeout(cleanupTimeout);
+                resolve(result);
+            }
+            // timeout fallback
+            cleanupTimeout = window.setTimeout(() => {
+                cleanupAndResolve(null);
+            }, 10000); // 10s timeout
+            document.body.appendChild(iframe);
+            // Construct player
+            try {
+                player = new window.YT.Player(iframeId, {
+                    events: {
+                        onReady: (e) => {
+                            try {
+                                let duration = e.target.getDuration();
+                                if (!duration || duration === 0) {
+                                    // Sometimes duration is 0 immediately; try a few short retries
+                                    let attempts = 0;
+                                    const tryInterval = setInterval(() => {
+                                        attempts += 1;
+                                        try {
+                                            duration = e.target.getDuration();
+                                            if (duration && duration > 0) {
+                                                clearInterval(tryInterval);
+                                                cleanupAndResolve(formatSecondsToHMS(duration));
+                                            }
+                                            else if (attempts >= 8) {
+                                                clearInterval(tryInterval);
+                                                cleanupAndResolve(null);
+                                            }
+                                        }
+                                        catch (_a) {
+                                            if (attempts >= 8) {
+                                                clearInterval(tryInterval);
+                                                cleanupAndResolve(null);
+                                            }
+                                        }
+                                    }, 300);
+                                }
+                                else {
+                                    cleanupAndResolve(formatSecondsToHMS(duration));
+                                }
+                            }
+                            catch (_a) {
+                                cleanupAndResolve(null);
+                            }
+                        },
+                        onError: () => {
+                            cleanupAndResolve(null);
+                        },
+                    },
+                });
+            }
+            catch (_a) {
+                cleanupAndResolve(null);
+            }
+        });
+    }, []);
+    return getYoutubeVideoDuration;
+}

package/dist/youtube/use-get-video-duration.js

@@ -0,0 +1,150 @@
+/** biome-ignore-all lint/suspicious/noExplicitAny: Window is any */
+import { useCallback } from "react";
+import { formatSecondsToHMS } from "../string";
+import { extractYouTubeId } from "./extract-youtube-video-id";
+import { validateYoutubeLink } from "./validate-youtube-link";
+let YtApiLoading = null;
+function loadYouTubeIFrameAPI() {
+    var _a;
+    if ((_a = window.YT) === null || _a === void 0 ? void 0 : _a.Player)
+        return Promise.resolve();
+    if (YtApiLoading)
+        return YtApiLoading;
+    YtApiLoading = new Promise((resolve) => {
+        const existing = document.querySelector('script[src="https://www.youtube.com/iframe_api"]');
+        if (existing) {
+            // Poll until the API is ready
+            const poll = setInterval(() => {
+                var _a;
+                if ((_a = window.YT) === null || _a === void 0 ? void 0 : _a.Player) {
+                    clearInterval(poll);
+                    resolve();
+                }
+            }, 50);
+            return;
+        }
+        const tag = document.createElement("script");
+        tag.src = "https://www.youtube.com/iframe_api";
+        tag.async = true;
+        document.body.appendChild(tag);
+        window.onYouTubeIframeAPIReady = () => {
+            resolve();
+        };
+    });
+    return YtApiLoading;
+}
+/**
+ * useGetYoutubeVideoDuration
+ * Returns a function that accepts a YouTube URL (full or short) and returns a Promise
+ * resolving to the video duration formatted as "HH:MM:SS" or null on failure.
+ */
+export function useGetYoutubeVideoDuration() {
+    const getYoutubeVideoDuration = useCallback(async (videoUrl) => {
+        const videoId = extractYouTubeId(videoUrl);
+        if (!videoId)
+            return null;
+        const videoIsValid = await validateYoutubeLink(videoUrl);
+        if (!videoIsValid)
+            return null;
+        try {
+            await loadYouTubeIFrameAPI();
+        }
+        catch (_a) {
+            return null;
+        }
+        return await new Promise((resolve) => {
+            const iframeId = `yt-duration-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+            const iframe = document.createElement("iframe");
+            // create a minimal offscreen iframe for the player
+            iframe.id = iframeId;
+            iframe.style.position = "fixed";
+            iframe.style.left = "-9999px";
+            iframe.style.width = "1px";
+            iframe.style.height = "1px";
+            iframe.style.opacity = "0";
+            iframe.style.pointerEvents = "none";
+            // embed URL with enablejsapi so we can construct YT.Player
+            const origin = window.location.origin;
+            iframe.src = `https://www.youtube.com/embed/${encodeURIComponent(videoId)}?enablejsapi=1&origin=${encodeURIComponent(origin)}`;
+            let resolved = false;
+            let player = null;
+            let cleanupTimeout = null;
+            function cleanupAndResolve(result) {
+                if (resolved)
+                    return;
+                resolved = true;
+                try {
+                    if (player && typeof player.destroy === "function")
+                        player.destroy();
+                }
+                catch (_a) {
+                    /* ignore */
+                }
+                try {
+                    if (iframe.parentNode)
+                        iframe.parentNode.removeChild(iframe);
+                }
+                catch (_b) {
+                    /* ignore */
+                }
+                if (cleanupTimeout)
+                    window.clearTimeout(cleanupTimeout);
+                resolve(result);
+            }
+            // timeout fallback
+            cleanupTimeout = window.setTimeout(() => {
+                cleanupAndResolve(null);
+            }, 10000); // 10s timeout
+            document.body.appendChild(iframe);
+            // Construct player
+            try {
+                player = new window.YT.Player(iframeId, {
+                    events: {
+                        onReady: (e) => {
+                            try {
+                                let duration = e.target.getDuration();
+                                if (!duration || duration === 0) {
+                                    // Sometimes duration is 0 immediately; try a few short retries
+                                    let attempts = 0;
+                                    const tryInterval = setInterval(() => {
+                                        attempts += 1;
+                                        try {
+                                            duration = e.target.getDuration();
+                                            if (duration && duration > 0) {
+                                                clearInterval(tryInterval);
+                                                cleanupAndResolve(formatSecondsToHMS(duration));
+                                            }
+                                            else if (attempts >= 8) {
+                                                clearInterval(tryInterval);
+                                                cleanupAndResolve(null);
+                                            }
+                                        }
+                                        catch (_a) {
+                                            if (attempts >= 8) {
+                                                clearInterval(tryInterval);
+                                                cleanupAndResolve(null);
+                                            }
+                                        }
+                                    }, 300);
+                                }
+                                else {
+                                    cleanupAndResolve(formatSecondsToHMS(duration));
+                                }
+                            }
+                            catch (_a) {
+                                cleanupAndResolve(null);
+                            }
+                        },
+                        onError: () => {
+                            cleanupAndResolve(null);
+                        },
+                    },
+                });
+            }
+            catch (_a) {
+                cleanupAndResolve(null);
+            }
+        });
+    }, []);
+    return getYoutubeVideoDuration;
+}

package/dist/youtube/use-get-video-duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-get-video-duration.js","sourceRoot":"","sources":["../../src/youtube/use-get-video-duration.ts"],"names":[],"mappings":"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"}

package/dist/youtube/validate-youtube-link.d.ts

@@ -0,0 +1,2 @@
+export declare function validateYoutubeLink(videoUrl: string): Promise<boolean>;
+//# sourceMappingURL=validate-youtube-link.d.ts.map

package/dist/youtube/validate-youtube-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-youtube-link.d.ts","sourceRoot":"","sources":["../../src/youtube/validate-youtube-link.ts"],"names":[],"mappings":"AAAA,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA0C5E"}

package/dist/youtube/validate-youtube-link.esm.js

@@ -0,0 +1,40 @@
+export async function validateYoutubeLink(videoUrl) {
+    const { extractYouTubeId } = await import("./extract-youtube-video-id");
+    const videoId = extractYouTubeId(videoUrl);
+    if (!videoId)
+        return false;
+    // Try loading YouTube thumbnail images — avoids CORS problems because
+    // creating an Image and listening for load/error is not blocked by CORS.
+    const thumbs = [
+        `https://img.youtube.com/vi/${videoId}/maxresdefault.jpg`,
+        `https://img.youtube.com/vi/${videoId}/hqdefault.jpg`,
+        `https://img.youtube.com/vi/${videoId}/mqdefault.jpg`,
+        `https://img.youtube.com/vi/${videoId}/default.jpg`,
+    ];
+    const loadImage = (src) => new Promise((resolve) => {
+        const img = new Image();
+        img.onload = () => resolve(true);
+        img.onerror = () => resolve(false);
+        img.src = src;
+    });
+    for (const url of thumbs) {
+        try {
+            const ok = await loadImage(url);
+            if (ok)
+                return true;
+        }
+        catch (_a) {
+            // ignore and try next thumbnail
+        }
+    }
+    // Fallback: try oEmbed endpoint (may be subject to CORS in some environments)
+    try {
+        const watchUrl = `https://www.youtube.com/watch?v=${encodeURIComponent(videoId)}`;
+        const oembedUrl = `https://www.youtube.com/oembed?url=${encodeURIComponent(watchUrl)}&format=json`;
+        const res = await fetch(oembedUrl, { method: "GET" });
+        return res.ok;
+    }
+    catch (_b) {
+        return false;
+    }
+}

package/dist/youtube/validate-youtube-link.js

@@ -0,0 +1,40 @@
+export async function validateYoutubeLink(videoUrl) {
+    const { extractYouTubeId } = await import("./extract-youtube-video-id");
+    const videoId = extractYouTubeId(videoUrl);
+    if (!videoId)
+        return false;
+    // Try loading YouTube thumbnail images — avoids CORS problems because
+    // creating an Image and listening for load/error is not blocked by CORS.
+    const thumbs = [
+        `https://img.youtube.com/vi/${videoId}/maxresdefault.jpg`,
+        `https://img.youtube.com/vi/${videoId}/hqdefault.jpg`,
+        `https://img.youtube.com/vi/${videoId}/mqdefault.jpg`,
+        `https://img.youtube.com/vi/${videoId}/default.jpg`,
+    ];
+    const loadImage = (src) => new Promise((resolve) => {
+        const img = new Image();
+        img.onload = () => resolve(true);
+        img.onerror = () => resolve(false);
+        img.src = src;
+    });
+    for (const url of thumbs) {
+        try {
+            const ok = await loadImage(url);
+            if (ok)
+                return true;
+        }
+        catch (_a) {
+            // ignore and try next thumbnail
+        }
+    }
+    // Fallback: try oEmbed endpoint (may be subject to CORS in some environments)
+    try {
+        const watchUrl = `https://www.youtube.com/watch?v=${encodeURIComponent(videoId)}`;
+        const oembedUrl = `https://www.youtube.com/oembed?url=${encodeURIComponent(watchUrl)}&format=json`;
+        const res = await fetch(oembedUrl, { method: "GET" });
+        return res.ok;
+    }
+    catch (_b) {
+        return false;
+    }
+}

package/dist/youtube/validate-youtube-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-youtube-link.js","sourceRoot":"","sources":["../../src/youtube/validate-youtube-link.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,kDA0CC;AA1CM,KAAK,UAAU,mBAAmB,CAAC,QAAgB;IACxD,MAAM,EAAE,gBAAgB,EAAE,GAAG,wDAAa,4BAA4B,GAAC,CAAA;IACvE,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IAC1C,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAA;IAE1B,sEAAsE;IACtE,yEAAyE;IACzE,MAAM,MAAM,GAAG;QACb,8BAA8B,OAAO,oBAAoB;QACzD,8BAA8B,OAAO,gBAAgB;QACrD,8BAA8B,OAAO,gBAAgB;QACrD,8BAA8B,OAAO,cAAc;KACpD,CAAA;IAED,MAAM,SAAS,GAAG,CAAC,GAAW,EAAE,EAAE,CAChC,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;QAC/B,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAA;QACvB,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAChC,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAClC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAA;IACf,CAAC,CAAC,CAAA;IAEJ,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAA;YAC/B,IAAI,EAAE;gBAAE,OAAO,IAAI,CAAA;QACrB,CAAC;QAAC,WAAM,CAAC;YACP,gCAAgC;QAClC,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,mCAAmC,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAA;QACjF,MAAM,SAAS,GAAG,sCAAsC,kBAAkB,CACxE,QAAQ,CACT,cAAc,CAAA;QACf,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;QACrD,OAAO,GAAG,CAAC,EAAE,CAAA;IACf,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herowcode/utils",
-  "version": "1.0.2",
+  "version": "1.1.1",
   "description": "A lightweight collection of utility functions for everyday JavaScript/TypeScript development",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
@@ -26,15 +26,20 @@
       "import": "./dist/string/index.esm.js",
       "require": "./dist/string/index.js"
     },
-    "./number": {
-      "types": "./dist/number.d.ts",
-      "import": "./dist/number.esm.js",
-      "require": "./dist/number.js"
+    "./files": {
+      "types": "./dist/files/index.d.ts",
+      "import": "./dist/files/index.esm.js",
+      "require": "./dist/files/index.js"
     },
     "./function": {
       "types": "./dist/function.d.ts",
       "import": "./dist/function.esm.js",
       "require": "./dist/function.js"
+    },
+    "./youtube": {
+      "types": "./dist/youtube.d.ts",
+      "import": "./dist/youtube.esm.js",
+      "require": "./dist/youtube.js"
     }
   },
   "files": [
@@ -47,14 +52,15 @@
     "build:types": "tsc --project tsconfig.types.json",
     "lint": "biome check --write --unsafe",
     "clean": "rm -rf dist",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "prepare": "yarn build",
-    "prepublishOnly": "yarn lint && yarn test && yarn build",
-    "version:patch": "yarn lint && yarn test && yarn build && npm version patch && git push && git push --tags",
-    "version:minor": "yarn lint && yarn test && yarn build && npm version minor && git push && git push --tags",
-    "version:major": "yarn lint && yarn test && yarn build && npm version major && git push && git push --tags"
+    "prepublishOnly": "yarn lint && yarn test:run && yarn build",
+    "version:patch": "yarn lint && yarn test:run && yarn build && npm version patch && git push && git push --tags",
+    "version:minor": "yarn lint && yarn test:run && yarn build && npm version minor && git push && git push --tags",
+    "version:major": "yarn lint && yarn test:run && yarn build && npm version major && git push && git push --tags"
   },
   "keywords": [
     "utils",
@@ -72,14 +78,24 @@
   },
   "license": "MIT",
   "dependencies": {
-    "dayjs": "^1.11.10"
+    "dayjs": "^1.11.10",
+    "react": "19.1.1"
   },
   "devDependencies": {
     "@biomejs/biome": "2.2.3",
-    "@types/jest": "^29.5.5",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.1.1",
-    "typescript": "^5.2.2"
+    "@testing-library/dom": "10.4.1",
+    "@testing-library/jest-dom": "6.8.0",
+    "@testing-library/react": "16.3.0",
+    "@testing-library/react-hooks": "8.0.1",
+    "@types/react": "19.1.12",
+    "@types/react-dom": "19.1.9",
+    "@vitest/coverage-v8": "3.2.4",
+    "@vitest/ui": "3.2.4",
+    "jest-environment-jsdom": "30.1.2",
+    "jsdom": "26.1.0",
+    "react-dom": "19.1.1",
+    "typescript": "^5.2.2",
+    "vitest": "3.2.4"
   },
   "repository": {
     "type": "git",

package/dist/number.d.ts

@@ -1,8 +0,0 @@
-/**
- * Generates a random integer between min and max (inclusive)
- * @param min - The minimum value (inclusive)
- * @param max - The maximum value (inclusive)
- * @returns A random integer between min and max
- */
-export declare function randomInt(min: number, max: number): number;
-//# sourceMappingURL=number.d.ts.map

package/dist/number.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../src/number.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAU1D"}

package/dist/number.esm.js

@@ -1,15 +0,0 @@
-/**
- * Generates a random integer between min and max (inclusive)
- * @param min - The minimum value (inclusive)
- * @param max - The maximum value (inclusive)
- * @returns A random integer between min and max
- */
-export function randomInt(min, max) {
-    if (!Number.isInteger(min) || !Number.isInteger(max)) {
-        throw new Error("Both min and max must be integers");
-    }
-    if (min > max) {
-        throw new Error("Min value cannot be greater than max value");
-    }
-    return Math.floor(Math.random() * (max - min + 1)) + min;
-}

package/dist/number.js

@@ -1,15 +0,0 @@
-/**
- * Generates a random integer between min and max (inclusive)
- * @param min - The minimum value (inclusive)
- * @param max - The maximum value (inclusive)
- * @returns A random integer between min and max
- */
-export function randomInt(min, max) {
-    if (!Number.isInteger(min) || !Number.isInteger(max)) {
-        throw new Error("Both min and max must be integers");
-    }
-    if (min > max) {
-        throw new Error("Min value cannot be greater than max value");
-    }
-    return Math.floor(Math.random() * (max - min + 1)) + min;
-}

package/dist/number.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"number.js","sourceRoot":"","sources":["../src/number.ts"],"names":[],"mappings":";;AAMA,8BAUC;AAhBD;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,GAAW,EAAE,GAAW;IAChD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;IACtD,CAAC;IAED,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;IAC/D,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAA;AAC1D,CAAC"}