umedia 0.4.1 → 0.5.0

package/lib/providers/snapchat.js

@@ -1,177 +0,0 @@
-import { fetchText, hostMatches } from "../util.js";
-import { Codes, UMediaError } from "../errors.js";
-
-/**
- * Snapchat — Spotlight videos and public story snap lists.
- * Primary: the page's __NEXT_DATA__ -> spotlightFeed.spotlightStories, matched
- * by storyId (the exact structure yt-dlp's snapchat extractor reads) ->
- * videoMetadata.contentUrl (direct sc-cdn mp4). Fallback: the preload video
- * link (cobalt). Stories: pageProps.story.snapList — ALL snaps, in order.
- */
-export const name = "snapchat";
-
-const NEXT_DATA = /<script id="__NEXT_DATA__" type="application\/json">({.+?})<\/script>/;
-const PRELOAD_VIDEO = /<link data-react-helmet="true" rel="preload" href="([^"]+)" as="video"\/>/;
-
-export function canHandle(url) {
-  try {
-    return hostMatches(new URL(String(url)).hostname, ["snapchat.com", "t.snapchat.com"]);
-  } catch { return false; }
-}
-
-export function spotlightId(url) {
-  const m = String(url).match(/\/spotlight\/([\w-]{10,120})/);
-  return m ? m[1] : null;
-}
-
-function nextData(html) {
-  const m = html.match(NEXT_DATA);
-  if (!m) return null;
-  try { return JSON.parse(m[1]); } catch { return null; }
-}
-
-function pushStorySnap(snap, media) {
-  const isPhoto = snap.snapMediaType === 0;
-  const u = snap.snapUrls?.mediaUrl;
-  if (!u) return;
-  media.push({
-    type: isPhoto ? "image" : "video", index: media.length, url: u,
-    thumbnail: snap.snapUrls?.mediaPreviewUrl?.value || u,
-    mimeType: isPhoto ? "image/jpeg" : "video/mp4",
-    width: null, height: null,
-    duration: snap.durationInMs ? Math.round(snap.durationInMs / 1000) : (snap.duration ? Math.round(snap.duration / 1000) : null),
-    size: null, quality: null,
-    hasAudio: !isPhoto, hasVideo: !isPhoto, source: name, variants: [],
-  });
-}
-
-export async function resolve(url, ctx = {}) {
-  const attempt = { provider: name, status: "skipped" };
-  ctx.attempts?.push(attempt);
-  const t0 = Date.now();
-
-  let target = String(url);
-  if (/t\.snapchat\.com\//i.test(target)) {
-    try {
-      const res = await fetch(target, { redirect: "follow", headers: { "user-agent": "Mozilla/5.0" } });
-      target = res.url || target;
-    } catch { /* keep original */ }
-  }
-
-  const media = [];
-  let title = null;
-  let author = null;
-  let duration = null;
-
-  const sid = spotlightId(target);
-  const story = target.match(/\/add\/([\w.-]+)(?:\/([\w-]+))?/i);
-
-  if (sid) {
-    const r = await fetchText(`https://www.snapchat.com/spotlight/${sid}`, { headers: { "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0 Safari/537.36" } }, 20_000).catch(() => null);
-    const html = r?.text || "";
-
-    // primary: __NEXT_DATA__ spotlight feed entry matched by storyId (yt-dlp structure)
-    const d = nextData(html);
-    const stories = d?.props?.pageProps?.spotlightFeed?.spotlightStories || [];
-    const entry = stories.find((s) => s?.story?.storyId?.value === sid);
-    const vm = entry?.metadata?.videoMetadata;
-    if (vm?.contentUrl) {
-      media.push({
-        type: "video", index: 0, url: vm.contentUrl,
-        thumbnail: vm.thumbnailUrl || null,
-        mimeType: "video/mp4",
-        width: vm.width ?? null, height: vm.height ?? null,
-        duration: vm.durationMs ? Math.round(vm.durationMs / 1000) : null,
-        size: null, quality: vm.height ? `${vm.height}p` : null,
-        hasAudio: true, hasVideo: true, source: name, variants: [],
-      });
-      title = vm.name || null;
-      author = vm.creator?.personCreator?.username || vm.creator?.username || null;
-      duration = vm.durationMs ? Math.round(vm.durationMs / 1000) : null;
-    }
-
-    // fallback: the preload video link (cobalt's route)
-    if (!media.length) {
-      const v = html.match(PRELOAD_VIDEO)?.[1];
-      if (v && /^https?:/.test(v) && new URL(v).hostname.endsWith("sc-cdn.net")) {
-        media.push({
-          type: "video", index: 0, url: v, thumbnail: null,
-          mimeType: "video/mp4", width: null, height: null,
-          duration: null, size: null, quality: null,
-          hasAudio: true, hasVideo: true, source: name, variants: [],
-        });
-      }
-    }
-  } else if (story) {
-    const r = await fetchText(`https://www.snapchat.com/add/${story[1]}${story[2] ? "/" + story[2] : ""}`,
-      { headers: { "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0 Safari/537.36" } }, 20_000).catch(() => null);
-    const d = nextData(r?.text || "");
-    const pp = d?.props?.pageProps || {};
-    author = story[1];
-
-    const activeStory = pp.story?.snapList || [];
-    const highlights = pp.spotlightHighlights || [];
-    const curated = pp.curatedHighlights || [];
-
-    if (story[2]) {
-      // a single snap (by snapId) or one highlight reel (by storyId/highlightId)
-      const wanted = story[2];
-      const allLists = [activeStory, ...curated.map((c) => c.snapList || []), ...highlights.map((h) => h.snapList || [])];
-      for (const list of allLists) {
-        const snap = list.find((s) => s.snapId?.value === wanted || s.snapId === wanted);
-        if (snap) { pushStorySnap(snap, media); break; }
-      }
-      if (!media.length) {
-        const hl = highlights.find((h) => h.storyId === wanted || h.highlightId === wanted || h.storyShareId === wanted);
-        if (hl) {
-          title = hl.storyTitle || null;
-          (hl.snapList || []).forEach((snap) => pushStorySnap(snap, media));
-        }
-      }
-    }
-    if (!media.length) {
-      // bare /add/{user}: the current story if it exists, else their public
-      // highlight reels — ALL snaps, in order, nothing silently dropped
-      const list = activeStory.length
-        ? activeStory
-        : (curated[0]?.snapList?.length ? curated[0].snapList : highlights.flatMap((h) => h.snapList || []));
-      if (!activeStory.length && highlights.length && !curated[0]?.snapList?.length) {
-        title = `${author} — ${highlights.length} public highlight${highlights.length > 1 ? "s" : ""}`;
-      }
-      list.forEach((snap) => pushStorySnap(snap, media));
-    }
-  }
-
-  if (!media.length) {
-    attempt.status = "failed";
-    attempt.error = "no snap media exposed (removed, private, or an expired spotlight)";
-    throw new UMediaError(Codes.MEDIA_NOT_FOUND,
-      `Snapchat exposes no media for this URL (${attempt.error}) — public spotlight links and stories work; removed snaps are gone from Snapchat itself.`, { attempts: [attempt] });
-  }
-
-  attempt.status = "success";
-  attempt.latencyMs = Date.now() - t0;
-  return {
-    result: {
-      sourceUrl: url,
-      platform: name,
-      title: title || (author ? `Snapchat story @${author}` : null),
-      author,
-      thumbnail: media[0].thumbnail,
-      itemCount: media.length,
-      counts: {
-        images: media.filter((m) => m.type === "image").length,
-        videos: media.filter((m) => m.type === "video").length,
-        audios: 0, other: 0,
-      },
-      truncated: false,
-      media,
-      streamUrlsAvailable: true,
-    },
-    engine: { attempts: ctx.attempts || [attempt], finalProvider: name, totalLatencyMs: Date.now() - t0 },
-  };
-}
-
-export async function search() {
-  return [];
-}

package/lib/providers/soundcloud.js

@@ -1,138 +0,0 @@
-import { fetchJson, fetchText, hostMatches, UA } from "../util.js";
-import { Codes, UMediaError } from "../errors.js";
-
-/**
- * SoundCloud — public api-v2 (the route the web player itself calls):
- * resolve -> transcodings -> CDN hop -> direct progressive MP3 (or HLS).
- * This is the music pipeline: search elsewhere, download REAL full tracks here.
- */
-export const name = "soundcloud";
-
-let _client_id = null;   // cached; rotated by SoundCloud occasionally
-let _cidFetchedAt = 0;
-
-export function canHandle(url) {
-  try {
-    return hostMatches(new URL(String(url)).hostname, ["soundcloud.com", "snd.sc"]);
-  } catch { return false; }
-}
-
-export function trackId(url) {
-  const m = String(url).match(/soundcloud\.com\/([\w-]+)\/([\w-]+)/i);
-  return m ? `${m[1]}/${m[2]}` : null;
-}
-
-async function clientId() {
-  if (_client_id && Date.now() - _cidFetchedAt < 6 * 3600_000) return _client_id;
-  // SoundCloud ships its public client_id inside its JS bundles — read it like the web player does
-  const page = await fetchText("https://soundcloud.com/discover", {}, 15_000);
-  const bundles = [...new Set((page.text.match(/https:\/\/a-v2\.sndcdn\.com\/assets\/[^"']+\.js/g) || []))].slice(0, 14);
-  for (const b of bundles) {
-    try {
-      const js = await fetchText(b, {}, 15_000);
-      const m = js.text.match(/client_id[":= ]{1,4}([A-Za-z0-9]{24,40})/);
-      if (m) {
-        _client_id = m[1];
-        _cidFetchedAt = Date.now();
-        return _client_id;
-      }
-    } catch { /* try the next bundle */ }
-  }
-  throw new UMediaError(Codes.PROVIDER_UNAVAILABLE, "SoundCloud client_id not retrievable (site changed) — use the yt-dlp tier");
-}
-
-export async function resolve(url, ctx = {}) {
-  const attempt = { provider: name, status: "skipped" };
-  ctx.attempts?.push(attempt);
-  const t0 = Date.now();
-
-  const slug = trackId(url);
-  if (!slug) {
-    attempt.status = "failed";
-    throw new UMediaError(Codes.INVALID_URL, "Not a SoundCloud track URL (expected soundcloud.com/{user}/{track})", { attempts: [attempt] });
-  }
-
-  const cid = await clientId();
-  let track;
-  try {
-    track = await fetchJson(
-      `https://api-v2.soundcloud.com/resolve?url=${encodeURIComponent(String(url).split("?")[0])}&client_id=${cid}`, {}, 20_000);
-  } catch (e) {
-    attempt.status = "failed";
-    attempt.error = e.message;
-    throw new UMediaError(Codes.MEDIA_NOT_FOUND, `SoundCloud track not retrievable. ${e.message}`, { attempts: [attempt] });
-  }
-  if (!track || track.kind !== "track") {
-    attempt.status = "failed";
-    throw new UMediaError(Codes.MEDIA_NOT_FOUND, "SoundCloud: not a public track (removed, private, or a set)", { attempts: [attempt] });
-  }
-
-  const media = [];
-  const variants = [];
-  for (const tr of (track.media?.transcodings || [])) {
-    const fmt = tr.format || {};
-    const isProg = fmt.protocol === "progressive";
-    const isMp3 = /mpeg|mp3/i.test(fmt.mime_type || "");
-    variants.push({
-      url: `${tr.url}${tr.url.includes("?") ? "&" : "?"}client_id=${cid}`,
-      height: null, width: null,
-      hasAudio: true, hasVideo: false,
-      quality: tr.quality || (isProg ? "progressive" : fmt.protocol),
-      mimeType: fmt.mime_type || null,
-      protocol: fmt.protocol,
-      _mp3: isProg && isMp3,
-    });
-  }
-  // resolve each transcoding hop -> real CDN URL (progressive mp3 first, then HLS)
-  const order = [...variants].sort((a, b) => (b._mp3 ? 1 : 0) - (a._mp3 ? 1 : 0));
-  const resolvedVariants = [];
-  for (const v of order) {
-    try {
-      const hop = await fetchJson(v.url, {}, 15_000);
-      if (hop?.url) resolvedVariants.push({ ...v, url: hop.url });
-    } catch { /* rights-restricted encoding — skip honestly */ }
-  }
-
-  if (!resolvedVariants.length) {
-    attempt.status = "failed";
-    attempt.error = "no downloadable encodings (rights-restricted)";
-    throw new UMediaError(Codes.ACCESS_RESTRICTED,
-      "SoundCloud exposes no downloadable encoding for this track (rights-restricted) — stream it in-app or use the yt-dlp tier", { attempts: [attempt] });
-  }
-
-  const chosen = resolvedVariants.find((v) => v._mp3) || resolvedVariants[0];
-  media.push({
-    type: "audio", index: 0, url: chosen.url,
-    thumbnail: track.artwork_url || track.user?.avatar_url || null,
-    mimeType: chosen.mimeType || (/mpegurl/.test(chosen.mimeType || "") ? "application/x-mpegURL" : "audio/mpeg"),
-    width: null, height: null,
-    duration: track.duration ? Math.round(track.duration / 1000) : null,
-    size: null, quality: chosen.quality,
-    hasAudio: true, hasVideo: false, source: name,
-    variants: resolvedVariants.map((v) => ({
-      height: null, width: null, url: v.url,
-      hasAudio: true, hasVideo: false, quality: v.quality, mimeType: v.mimeType,
-    })),
-  });
-
-  attempt.status = "success";
-  attempt.latencyMs = Date.now() - t0;
-  return {
-    result: {
-      sourceUrl: url,
-      platform: name,
-      title: track.title || null,
-      author: track.user?.username || null,
-      thumbnail: track.artwork_url || null,
-      itemCount: 1,
-      counts: { images: 0, videos: 0, audios: 1, other: 0 },
-      truncated: false,
-      media,
-    },
-    engine: { attempts: ctx.attempts || [attempt], finalProvider: name, totalLatencyMs: Date.now() - t0 },
-  };
-}
-
-export async function search() {
-  return [];
-}

package/lib/providers/streamable.js

@@ -1,93 +0,0 @@
-import { fetchJson, hostMatches } from "../util.js";
-import { Codes, UMediaError } from "../errors.js";
-
-/**
- * Streamable — the public video JSON (api.streamable.com/videos/{id}):
- * direct mp4 renditions (mp4 / mp4-mobile / original) with real heights.
- */
-export const name = "streamable";
-
-export function canHandle(url) {
-  try {
-    return hostMatches(new URL(String(url)).hostname, ["streamable.com"]);
-  } catch { return false; }
-}
-
-export function videoId(url) {
-  const m = String(url).match(/streamable\.com\/(?:e\/|video\/)?([a-z0-9]+)/i);
-  return m ? m[1] : null;
-}
-
-export async function resolve(url, ctx = {}) {
-  const attempt = { provider: name, status: "skipped" };
-  ctx.attempts?.push(attempt);
-  const t0 = Date.now();
-
-  const id = videoId(url);
-  if (!id) {
-    attempt.status = "failed";
-    throw new UMediaError(Codes.INVALID_URL, "Not a Streamable URL", { attempts: [attempt] });
-  }
-
-  let v;
-  try {
-    v = await fetchJson(`https://api.streamable.com/videos/${id}`, {}, 15_000);
-  } catch (e) {
-    attempt.status = "failed";
-    attempt.error = e.message;
-    throw new UMediaError(Codes.MEDIA_NOT_FOUND, `Streamable video not retrievable. ${e.message}`, { attempts: [attempt] });
-  }
-  if (v?.error || (v?.status && v.status !== 2 && !v.files)) {
-    attempt.status = "failed";
-    attempt.error = v?.error || v?.message || "video not found or still processing";
-    throw new UMediaError(Codes.MEDIA_NOT_FOUND, `Streamable: ${attempt.error}`, { attempts: [attempt] });
-  }
-
-  const variants = [];
-  for (const [key, f] of Object.entries(v.files || {})) {
-    // their API occasionally returns a doubled scheme — normalize, never silently drop
-    const raw = typeof f?.url === "string" ? f.url.replace(/^https:https:\/\//, "https://") : null;
-    if (!raw) continue;
-    variants.push({
-      height: f.height ?? null, width: f.width ?? null, url: raw,
-      hasAudio: true, hasVideo: true,
-      quality: key === "mp4-mobile" ? "360p" : (f.height ? `${f.height}p` : key),
-      mimeType: "video/mp4",
-    });
-  }
-  const chosen = variants.sort((a, b) => (b.height || 0) - (a.height || 0))[0];
-  if (!chosen) {
-    attempt.status = "failed";
-    throw new UMediaError(Codes.MEDIA_NOT_FOUND, "Streamable: no downloadable renditions (deleted or processing)", { attempts: [attempt] });
-  }
-
-  attempt.status = "success";
-  attempt.latencyMs = Date.now() - t0;
-  return {
-    result: {
-      sourceUrl: url,
-      platform: name,
-      title: v.title || null,
-      author: null,
-      thumbnail: (typeof v.thumbnail_url === "string" ? v.thumbnail_url.replace(/^https:https:\/\//, "https://") : v.thumbnail_url) || null,
-      itemCount: 1,
-      counts: { images: 0, videos: 1, audios: 0, other: 0 },
-      truncated: false,
-      media: [{
-        type: "video", index: 0, url: chosen.url,
-        thumbnail: (typeof v.thumbnail_url === "string" ? v.thumbnail_url.replace(/^https:https:\/\//, "https://") : v.thumbnail_url) || null,
-        mimeType: "video/mp4",
-        width: chosen.width ?? null, height: chosen.height ?? null,
-        duration: v.video_duration ?? v.duration ?? null,
-        size: null, quality: chosen.quality,
-        hasAudio: true, hasVideo: true, source: name, variants,
-      }],
-      streamUrlsAvailable: true,
-    },
-    engine: { attempts: ctx.attempts || [attempt], finalProvider: name, totalLatencyMs: Date.now() - t0 },
-  };
-}
-
-export async function search() {
-  return [];
-}

package/lib/providers/threads.js

@@ -1,103 +0,0 @@
-import { fetchText, hostMatches } from "../util.js";
-import { Codes, UMediaError } from "../errors.js";
-
-/**
- * Threads (Meta) — the share page's server-rendered state (`video_url` /
- * `image_urls` in the post JSON) plus official og: meta. Best-effort like all
- * Meta surfaces (login-gated on some networks); yt-dlp tier covers gated ones.
- */
-export const name = "threads";
-
-export function canHandle(url) {
-  try {
-    return hostMatches(new URL(String(url)).hostname, ["threads.net", "threads.com"]);
-  } catch { return false; }
-}
-
-export async function resolve(url, ctx = {}) {
-  const attempt = { provider: name, status: "skipped" };
-  ctx.attempts?.push(attempt);
-  const t0 = Date.now();
-
-  let html;
-  try {
-    const r = await fetchText(String(url), {
-      headers: {
-        "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0 Safari/537.36",
-        accept: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
-        "accept-language": "en-US,en;q=0.9",
-      },
-    }, 18_000);
-    html = r.text;
-  } catch (e) {
-    attempt.status = "failed";
-    attempt.error = e.message;
-    throw new UMediaError(Codes.PROVIDER_UNAVAILABLE, `Threads page not retrievable. ${e.message}`, { attempts: [attempt] });
-  }
-
-  const un = (s) => { try { return JSON.parse(`"${s}"`); } catch { return s.replace(/\\\//g, "/"); } };
-  const media = [];
-
-  // post state: video_url + display_url (escaped JSON strings inside the SSR payload)
-  const video = html.match(/\\"video_url\\":\\"((?:[^"\\]|\\.)+?)\\"/) || html.match(/"video_url":"((?:[^"\\]|\\.)+?)"/);
-  const image = html.match(/\\"display_url\\":\\"((?:[^"\\]|\\.)+?)\\"/) || html.match(/"display_url":"((?:[^"\\]|\\.)+?)"/);
-  if (video?.[1]) {
-    const u = un(video[1]);
-    if (/^https?:/.test(u)) media.push({
-      type: "video", index: 0, url: u, thumbnail: image ? un(image[1]) : u,
-      mimeType: "video/mp4", width: null, height: null, duration: null, size: null,
-      quality: null, hasAudio: true, hasVideo: true, source: name, variants: [],
-    });
-  }
-  if (!media.length && image?.[1]) {
-    const u = un(image[1]);
-    if (/^https?:/.test(u)) media.push({
-      type: "image", index: 0, url: u, thumbnail: u,
-      mimeType: "image/jpeg", width: null, height: null, duration: null, size: null,
-      quality: null, hasAudio: false, hasVideo: false, source: name, variants: [],
-    });
-  }
-
-  // og: meta fallback
-  if (!media.length) {
-    const ogv = (html.match(/property="og:video"[^>]+content="([^"]+)"/) || html.match(/content="([^"]+)"[^>]+property="og:video"/) || [])[1];
-    const ogi = (html.match(/property="og:image"[^>]+content="([^"]+)"/) || html.match(/content="([^"]+)"[^>]+property="og:image"/) || [])[1];
-    const u = ogv || ogi;
-    if (u && /^https?:/.test(u)) media.push({
-      type: ogv ? "video" : "image", index: 0, url: u.replace(/&/g, "&"), thumbnail: (ogi || u).replace(/&/g, "&"),
-      mimeType: ogv ? "video/mp4" : "image/jpeg", width: null, height: null,
-      duration: null, size: null, quality: null,
-      hasAudio: Boolean(ogv), hasVideo: Boolean(ogv), source: name, variants: [],
-    });
-  }
-
-  if (!media.length) {
-    attempt.status = "failed";
-    attempt.error = "no media in the public page (login-gated or removed)";
-    throw new UMediaError(Codes.MEDIA_NOT_FOUND,
-      `Threads exposes no media for this URL (${attempt.error}) — the yt-dlp tier covers gated posts.`, { attempts: [attempt] });
-  }
-
-  const title = (html.match(/"caption":"((?:[^"\\]|\\.){1,200})"/) || html.match(/<title[^>]*>([^<]*)/i) || [])[1] || null;
-  attempt.status = "success";
-  attempt.latencyMs = Date.now() - t0;
-  return {
-    result: {
-      sourceUrl: url,
-      platform: name,
-      title: title ? un(title).slice(0, 200) : null,
-      author: (String(url).match(/@([\w.]+)/) || [])[1] || null,
-      thumbnail: media[0].thumbnail,
-      itemCount: media.length,
-      counts: { images: media.filter((m) => m.type === "image").length, videos: media.filter((m) => m.type === "video").length, audios: 0, other: 0 },
-      truncated: false,
-      media,
-      streamUrlsAvailable: true,
-    },
-    engine: { attempts: ctx.attempts || [attempt], finalProvider: name, totalLatencyMs: Date.now() - t0 },
-  };
-}
-
-export async function search() {
-  return [];
-}

package/lib/providers/tiktok.js

@@ -1,165 +0,0 @@
-import { fetchJson, fetchText } from "../util.js";
-import { Codes, UMediaError } from "../errors.js";
-
-/** TikTok — oEmbed metadata + embed/v2 for photo posts (proven adapter), CDN media. */
-export const name = "tiktok";
-
-export function canHandle(url) {
-  return /tiktok\.com\//i.test(String(url)) || /vm\.tiktok\.com\//i.test(String(url));
-}
-
-export function postId(url) {
-  const m = String(url).match(/\/(?:photo|video|embed\/v2?)\/(\d+)/);
-  return m ? m[1] : null;
-}
-
-const _cache = new Map(); // id -> {at, data}
-
-export async function resolve(url, ctx = {}) {
-  const attempt = { provider: name, status: "skipped" };
-  ctx.attempts?.push(attempt);
-  const t0 = Date.now();
-
-  // 1) oEmbed: title/author/thumbnail (works for public posts)
-  let meta = {};
-  try {
-    meta = await fetchJson(`https://www.tiktok.com/oembed?url=${encodeURIComponent(url)}`, {}, 12_000);
-  } catch { /* oEmbed is advisory */ }
-
-  // 2) embed/v2: the reliable path for photo galleries + video playAddr
-  const id = postId(url);
-  const attempts = [];
-  let payload = id ? _cache.get(id) : null;
-  if (!payload?.data) {
-    for (let i = 0; i < 3 && !payload; i++) {
-      try {
-        const target = id
-          ? `https://www.tiktok.com/embed/v2/${id}`
-          : `https://www.tiktok.com/embed/${encodeURIComponent(url)}`;
-        const { status, text } = await fetchText(target, {}, 15_000);
-        if (status === 200 && text.includes("__UNIVERSAL_DATA")) {
-          const raw = text.split('<script id="__UNIVERSAL_DATA_FOR_REHYDRATION__" type="application/json">')[1]?.split("</script>")[0];
-          payload = { data: JSON.parse(raw) };
-          if (id) _cache.set(id, { at: Date.now(), data: payload.data });
-        } else if (status === 200) {
-          // Frontity state (current embed/v2 shape) first, then any JSON script that carries media data
-          const frontity = text.split('<script id="__FRONTITY_CONNECT_STATE__" type="application/json">')[1]?.split("</script>")[0];
-          if (frontity) {
-            payload = { data: JSON.parse(frontity) };
-            if (id) _cache.set(id, { at: Date.now(), data: payload.data });
-          } else {
-            for (const m of text.matchAll(/<script[^>]*type="application\/json"[^>]*>([\s\S]*?)<\/script>/g)) {
-              try {
-                const parsed = JSON.parse(m[1]);
-                const rawStr = JSON.stringify(parsed);
-                if (rawStr.includes("urlList") || rawStr.includes("playAddr") || rawStr.includes("imagePost")) {
-                  payload = { data: parsed };
-                  if (id) _cache.set(id, { at: Date.now(), data: payload.data });
-                  break;
-                }
-              } catch { /* not state JSON */ }
-            }
-          }
-        }
-        if (!payload) attempts.push(`embed fetch ${status}`);
-      } catch (e) {
-        attempts.push(e.message);
-        await new Promise((r) => setTimeout(r, 800 * (i + 1)));
-      }
-    }
-  }
-
-  const media = [];
-  const scope = payload?.data?.__DEFAULT_SCOPE__?.["webapp.video-detail"]?.itemInfo?.itemStruct
-    || payload?.data?.itemInfo?.itemStruct
-    || null;
-
-  // Frontity state — the CURRENT embed/v2 shape (Sept 2026+): source.data[<route>].videoData
-  let frontity = null;
-  const sourceData = payload?.data?.source?.data;
-  if (sourceData && typeof sourceData === "object") {
-    for (const node of Object.values(sourceData)) {
-      if (node && typeof node === "object" && node.videoData) { frontity = node.videoData; break; }
-    }
-  }
-
-  // images: canonical imagePost.images[] (complete) OR displayImages[] (public surface — possibly partial)
-  let galleryDegraded = false;
-  const imageList = scope?.imagePost?.images;
-  if (imageList?.length) {
-    imageList.forEach((img, i) => {
-      const u = img.imageURL?.urlList?.[0] || img.imageURL?.url;
-      if (u) media.push({
-        type: "image", index: i, url: u, thumbnail: u, mimeType: "image/jpeg",
-        width: img.width ?? null, height: img.height ?? null, duration: null, size: null,
-        quality: img.width && img.height ? `${img.width}x${img.height}` : null,
-        hasAudio: false, hasVideo: false, source: name, variants: [],
-      });
-    });
-  } else if (frontity?.imagePostInfo?.displayImages?.length) {
-    galleryDegraded = true; // platform now serves a partial gallery publicly — honest truncated flag
-    frontity.imagePostInfo.displayImages.forEach((img, i) => {
-      const u = img?.urlList?.[0];
-      if (u) media.push({
-        type: "image", index: i, url: u, thumbnail: u, mimeType: "image/jpeg",
-        width: img.width ?? null, height: img.height ?? null, duration: null, size: null,
-        quality: img.width && img.height ? `${img.width}x${img.height}` : null,
-        hasAudio: false, hasVideo: false, source: name, variants: [],
-      });
-    });
-  }
-
-  // video: classic playAddr OR Frontity itemInfos.video.urls (direct CDN mp4)
-  const fv = frontity?.itemInfos?.video;
-  const videoUrl = scope?.video?.playAddr || scope?.video?.downloadAddr
-    || scope?.video?.bitrateInfo?.[0]?.PlayAddr?.UrlList?.[0]
-    || (fv?.urls?.length ? fv.urls[0] : null);
-  if (videoUrl) {
-    const meta = scope?.video || {};
-    const fmeta = fv?.videoMeta || {};
-    media.push({
-      type: "video", index: media.length, url: videoUrl,
-      thumbnail: meta.cover || frontity?.itemInfos?.covers?.[0] || null,
-      mimeType: "video/mp4",
-      width: meta.width ?? fmeta.width ?? null, height: meta.height ?? fmeta.height ?? null,
-      duration: meta.duration ? meta.duration / 1000 : (fmeta.duration ?? null),
-      size: null,
-      quality: (meta.height || fmeta.height) ? `${meta.height || fmeta.height}p` : null,
-      hasAudio: true, hasVideo: true, source: name, variants: [],
-    });
-  }
-
-  if (!media.length) {
-    attempt.status = "failed";
-    attempt.error = attempts.length ? attempts[attempts.length - 1] : "no media exposed (post may be private or region-locked)";
-    // honest failure — unless oEmbed gave us at least a thumbnail-level record
-    throw new UMediaError(Codes.MEDIA_NOT_FOUND, `TikTok media not retrievable for this URL. ${attempt.error}`, { attempts: [attempt] });
-  }
-
-  attempt.status = "success";
-  attempt.latencyMs = Date.now() - t0;
-  return {
-    result: {
-      sourceUrl: url,
-      platform: "tiktok",
-      title: meta.title ?? scope?.desc ?? frontity?.itemInfos?.text ?? null,
-      author: meta.author_name ?? scope?.author?.nickname ?? frontity?.authorInfos?.nickName ?? frontity?.authorInfos?.uniqueId ?? null,
-      thumbnail: meta.thumbnail_url ?? media[0].thumbnail,
-      itemCount: media.length,
-      counts: {
-        images: media.filter((m) => m.type === "image").length,
-        videos: media.filter((m) => m.type === "video").length,
-        audios: 0, other: 0,
-      },
-      // honest: true when the public surface exposed only a partial gallery —
-      // the full slides need the yt-dlp tier (TikTok degrades embeds since 2026-09)
-      truncated: galleryDegraded,
-      media,
-    },
-    engine: { attempts: ctx.attempts || [attempt], finalProvider: name, totalLatencyMs: Date.now() - t0 },
-  };
-}
-
-export async function search() {
-  return [];
-}