@herowcode/utils 1.1.2 → 1.1.3

package/README.md

@@ -337,11 +337,24 @@ function VideoComponent() {
 #### `validateYoutubeLink(videoUrl: string): Promise<boolean>`
 Checks whether a YouTube video exists by probing thumbnails and falling back to the oEmbed endpoint. Returns `true` for found/public videos and `false` otherwise.
 
-```typescript
+```ts
 const ok = await validateYoutubeLink('https://youtu.be/dQw4w9WgXcQ');
 // true | false
 ```
 
+#### `getYoutubeThumbnail(videoUrl: string): Promise<string | null>`
+Attempts to load YouTube thumbnail images in priority order (maxresdefault, hqdefault, mqdefault, default). It creates an Image in the browser and returns the first URL that successfully loads, or `null` if none are available or the video ID cannot be extracted.
+
+Example:
+```ts
+const thumb = await getYoutubeThumbnail('https://youtu.be/abc123');
+// e.g. "https://img.youtube.com/vi/abc123/hqdefault.jpg" or null
+```
+
+Notes:
+- Uses the browser Image load/error events to avoid CORS issues.
+- Returns `null` when the video ID cannot be extracted or no thumbnails load.
+
 ## Browser Support
 
 This library supports all modern browsers and Node.js environments. It uses ES2018 features and requires:

package/dist/youtube/get-youtube-thumbnail.d.ts

@@ -0,0 +1,2 @@
+export declare function getYoutubeThumbnail(videoUrl: string): Promise<string | null>;
+//# sourceMappingURL=get-youtube-thumbnail.d.ts.map

package/dist/youtube/get-youtube-thumbnail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-youtube-thumbnail.d.ts","sourceRoot":"","sources":["../../src/youtube/get-youtube-thumbnail.ts"],"names":[],"mappings":"AAAA,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgCxB"}

package/dist/youtube/get-youtube-thumbnail.esm.js

@@ -0,0 +1,31 @@
+export async function getYoutubeThumbnail(videoUrl) {
+    const { extractYouTubeId } = await import("./extract-youtube-video-id");
+    const videoId = extractYouTubeId(videoUrl);
+    if (!videoId)
+        return null;
+    // 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 url;
+        }
+        catch (_a) {
+            // ignore and try next thumbnail
+        }
+    }
+    return null;
+}

package/dist/youtube/get-youtube-thumbnail.js

@@ -0,0 +1,31 @@
+export async function getYoutubeThumbnail(videoUrl) {
+    const { extractYouTubeId } = await import("./extract-youtube-video-id");
+    const videoId = extractYouTubeId(videoUrl);
+    if (!videoId)
+        return null;
+    // 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 url;
+        }
+        catch (_a) {
+            // ignore and try next thumbnail
+        }
+    }
+    return null;
+}

package/dist/youtube/get-youtube-thumbnail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-youtube-thumbnail.js","sourceRoot":"","sources":["../../src/youtube/get-youtube-thumbnail.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,kDAkCC;AAlCM,KAAK,UAAU,mBAAmB,CACvC,QAAgB;IAEhB,MAAM,EAAE,gBAAgB,EAAE,GAAG,wDAAa,4BAA4B,GAAC,CAAA;IACvE,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IAC1C,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAA;IAEzB,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,GAAG,CAAA;QACpB,CAAC;QAAC,WAAM,CAAC;YACP,gCAAgC;QAClC,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/youtube/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./extract-youtube-video-id";
 export * from "./generate-youtube-url";
+export * from "./get-youtube-thumbnail";
 export * from "./use-get-video-duration";
 export * from "./validate-youtube-link";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/youtube/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,wBAAwB,CAAA;AACtC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/youtube/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,wBAAwB,CAAA;AACtC,cAAc,yBAAyB,CAAA;AACvC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA"}

package/dist/youtube/index.esm.js

@@ -1,4 +1,5 @@
 export * from "./extract-youtube-video-id";
 export * from "./generate-youtube-url";
+export * from "./get-youtube-thumbnail";
 export * from "./use-get-video-duration";
 export * from "./validate-youtube-link";

package/dist/youtube/index.js

@@ -1,4 +1,5 @@
 export * from "./extract-youtube-video-id";
 export * from "./generate-youtube-url";
+export * from "./get-youtube-thumbnail";
 export * from "./use-get-video-duration";
 export * from "./validate-youtube-link";

package/dist/youtube/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/youtube/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA0C;AAC1C,yDAAsC;AACtC,2DAAwC;AACxC,0DAAuC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/youtube/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA0C;AAC1C,yDAAsC;AACtC,0DAAuC;AACvC,2DAAwC;AACxC,0DAAuC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herowcode/utils",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "description": "A lightweight collection of utility functions for everyday JavaScript/TypeScript development",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",