umedia 0.4.1 → 0.4.2

package/lib/registry.js

@@ -31,6 +31,49 @@ export function detectPlatform(url) {
 
 const DIRECT_MEDIA = /\.(mp4|webm|m4a|mp3|aac|wav|jpg|jpeg|png|gif|webp|mov|mkv)(\?|#|$)/i;
 
+/** Signed CDN blob URLs have no file extension — probe the content-type honestly. */
+async function probeDirectMedia(url) {
+  try {
+    let res = await fetch(url, {
+      method: "HEAD",
+      headers: { "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0 Safari/537.36" },
+      redirect: "follow",
+      signal: AbortSignal.timeout(12_000),
+    });
+    if (!res.ok && res.status !== 405) {
+      res = await fetch(url, {
+        headers: { "user-agent": "Mozilla/5.0", range: "bytes=0-0" },
+        redirect: "follow",
+        signal: AbortSignal.timeout(12_000),
+      });
+    }
+    const ct = (res.headers.get("content-type") || "").split(";")[0].trim();
+    const kind = /^video\//.test(ct) ? "video" : /^audio\//.test(ct) ? "audio" : /^image\//.test(ct) ? "image" : null;
+    return kind ? { kind, mimeType: ct } : null;
+  } catch {
+    return null;
+  }
+}
+
+function directResult(url, kind, mimeType, note) {
+  return {
+    data: {
+      sourceUrl: url, platform: "direct",
+      title: String(url).split("/").pop()?.split("?")[0] || "Direct media",
+      author: null, thumbnail: kind === "video" ? null : url,
+      itemCount: 1,
+      counts: { images: kind === "image" ? 1 : 0, videos: kind === "video" ? 1 : 0, audios: kind === "audio" ? 1 : 0, other: 0 },
+      truncated: false,
+      media: [{
+        type: kind, index: 0, url: String(url), thumbnail: null, mimeType: mimeType ?? null,
+        width: null, height: null, duration: null, size: null, quality: "original",
+        hasAudio: kind !== "image", hasVideo: kind !== "audio", source: "direct", variants: [],
+      }],
+    },
+    engine: { attempts: [{ provider: "direct", status: "success", note }], finalProvider: "direct", totalLatencyMs: 0 },
+  };
+}
+
 /** Resolve a URL: native adapter first, optional yt-dlp fallback. attempts[] is the honest trail. */
 export async function resolve(url) {
   // SSRF hygiene FIRST — never dispatch or fetch private/internal targets (bots pass user URLs!)
@@ -88,6 +131,14 @@ export async function resolve(url) {
     }
   }
   const last = ctx.attempts[ctx.attempts.length - 1];
+  // extension-less signed CDN URLs: honest content-type probe before refusing
+  if (detectPlatform(url) === "unknown") {
+    const probe = await probeDirectMedia(url);
+    if (probe) return directResult(url, probe.kind, probe.mimeType, "direct media URL (content-type probe)");
+    throw new UMediaError(Codes.INVALID_URL,
+      `No provider could resolve this URL${last?.error ? " Last error: " + last.error : ""}. Tip: install yt-dlp to unlock 1800+ sites and hard networks.`,
+      { attempts: ctx.attempts });
+  }
   // surface the real provider error when every matching provider failed —
   // never mask a typed outcome behind a generic message
   if (lastTyped) {
@@ -95,7 +146,7 @@ export async function resolve(url) {
     throw lastTyped;
   }
   throw new UMediaError(
-    detectPlatform(url) === "unknown" ? Codes.INVALID_URL : Codes.PROVIDER_UNAVAILABLE,
+    Codes.PROVIDER_UNAVAILABLE,
     `No provider could resolve this URL.${last?.error ? " Last error: " + last.error : ""}` +
       (ytdlp.binary() ? "" : " Tip: install yt-dlp to unlock 1800+ sites and hard networks."),
     { attempts: ctx.attempts },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "umedia",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Standalone media engine — search, resolve and download media from YouTube, TikTok, Instagram, Reddit, X, iTunes (and 1800+ sites via the yt-dlp tier) entirely on your machine. No hosted API, no keys, no server bills. Honest quality labels, complete galleries, typed errors.",
   "type": "module",
   "main": "./index.js",