umedia 0.4.1 → 0.5.0

package/lib/providers/tumblr.js

@@ -1,153 +0,0 @@
-import { fetchJson, hostMatches } from "../util.js";
-import { Codes, UMediaError } from "../errors.js";
-
-/**
- * Tumblr — the public mobile API (api-http2.tumblr.com, the same endpoint the
- * official iPhone app calls with its public api_key). Videos, audio, photos —
- * including reblog trails. Reference: cobalt tumblr service.
- */
-export const name = "tumblr";
-
-const API_KEY = "jrsCWX1XDuVxAFO4GkK147syAoN8BJZ5voz8tS80bPcj26Vc5Z";
-const API_BASE = "https://api-http2.tumblr.com";
-const MOBILE = {
-  "user-agent": "Tumblr/iPhone/33.3/333010/17.3.1/tumblr",
-  "x-version": "iPhone/33.3/333010/17.3.1/tumblr",
-};
-
-export function canHandle(url) {
-  try {
-    return hostMatches(new URL(String(url)).hostname, ["tumblr.com"]);
-  } catch { return false; }
-}
-
-export function parseUrl(url) {
-  const u = new URL(String(url));
-  const host = u.hostname.replace(/^www\./, "");
-  let m;
-  // https://{user}.tumblr.com/post/{id}/...
-  m = u.pathname.match(/^\/post\/(\d+)/);
-  if (m && host !== "tumblr.com") return { user: host.split(".")[0], id: m[1] };
-  // https://www.tumblr.com/{user}/{id} or /blog/view/{user}/{id}
-  m = u.pathname.match(/^\/(?:blog\/view\/)?([\w.-]+)\/(\d+)/);
-  if (m) return { user: m[1], id: m[2] };
-  return null;
-}
-
-export async function resolve(url, ctx = {}) {
-  const attempt = { provider: name, status: "skipped" };
-  ctx.attempts?.push(attempt);
-  const t0 = Date.now();
-
-  const parsed = parseUrl(url);
-  if (!parsed) {
-    attempt.status = "failed";
-    throw new UMediaError(Codes.INVALID_URL, "Not a Tumblr post URL (expected {user}.tumblr.com/post/{id} or tumblr.com/{user}/{id})", { attempts: [attempt] });
-  }
-
-  let data;
-  try {
-    data = await fetchJson(
-      `${API_BASE}/v2/blog/${encodeURIComponent(parsed.user)}.tumblr.com/posts/${parsed.id}/permalink?api_key=${API_KEY}`, { headers: MOBILE }, 20_000);
-  } catch (e) {
-    attempt.status = "failed";
-    attempt.error = e.message;
-    throw new UMediaError(Codes.PROVIDER_UNAVAILABLE, `Tumblr API unavailable. ${e.message}`, { attempts: [attempt] });
-  }
-
-  const element = data?.response?.timeline?.elements?.[0];
-  if (!element) {
-    attempt.status = "failed";
-    attempt.error = data?.meta?.msg || "post not found";
-    throw new UMediaError(Codes.MEDIA_NOT_FOUND, `Tumblr: ${attempt.error}`, { attempts: [attempt] });
-  }
-
-  // contents: the post itself + any reblog trail, in order — ALL of it
-  const contents = [
-    ...(element.content || []),
-    ...(element.trail || []).flatMap((t) => t.content || []),
-  ];
-
-  const media = [];
-  for (const c of contents) {
-    if (c.type === "video" && (c.provider === "tumblr" || !c.provider) && c.media?.url) {
-      media.push({
-        type: "video", index: media.length, url: c.media.url,
-        thumbnail: c.poster?.[0]?.url || null,
-        mimeType: "video/mp4", width: c.width ?? null, height: c.height ?? null,
-        duration: null, size: null, quality: null,
-        hasAudio: true, hasVideo: true, source: name, variants: [],
-      });
-    } else if (c.type === "audio" && c.media?.url) {
-      media.push({
-        type: "audio", index: media.length, url: c.media.url,
-        thumbnail: null, mimeType: "audio/mpeg", width: null, height: null,
-        duration: null, size: null, quality: null,
-        hasAudio: true, hasVideo: false, source: name, variants: [],
-      });
-    } else if (c.type === "image" || c.type === "photo") {
-      // image content carries media as an ARRAY of renditions — take the best
-      // one as the item, keep the rest as variants. never inflate items.
-      const items = (Array.isArray(c.media) ? c.media : (c.media?.url ? [c.media] : []))
-        .filter((mm) => mm?.url);
-      const uniq = [...new Map(items.map((mm) => [mm.url, mm])).values()]
-        .sort((a, b) => ((b.width || 0) * (b.height || 0)) - ((a.width || 0) * (a.height || 0)));
-      const best = uniq[0];
-      if (best) {
-        media.push({
-          type: "image", index: media.length, url: best.url,
-          thumbnail: best.url, mimeType: "image/jpeg",
-          width: best.width ?? null, height: best.height ?? null,
-          duration: null, size: null, quality: best.width ? `${best.width}px` : null,
-          hasAudio: false, hasVideo: false, source: name,
-          variants: uniq.map((x) => ({
-            height: x.height ?? null, width: x.width ?? null, url: x.url,
-            hasAudio: false, hasVideo: false, quality: x.width ? `${x.width}px` : null, mimeType: "image/jpeg",
-          })),
-        });
-      }
-    }
-  }
-
-  // reblog trails repeat media from earlier hops — dedupe by URL, keep first order
-  const seen = new Set();
-  const deduped = [];
-  for (const mm of media) {
-    if (seen.has(mm.url)) continue;
-    seen.add(mm.url);
-    deduped.push({ ...mm, index: deduped.length });
-  }
-  media.length = 0;
-  media.push(...deduped);
-
-  if (!media.length) {
-    attempt.status = "failed";
-    throw new UMediaError(Codes.MEDIA_NOT_FOUND, "Tumblr post contains no downloadable media (text/link post, or third-party embed — use the yt-dlp tier for YouTube/Vimeo embeds)", { attempts: [attempt] });
-  }
-
-  attempt.status = "success";
-  attempt.latencyMs = Date.now() - t0;
-  return {
-    result: {
-      sourceUrl: url,
-      platform: name,
-      title: (element.summary || element.let || "").slice(0, 200) || null,
-      author: element.blog_name || parsed.user,
-      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: media.filter((m) => m.type === "audio").length, 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/twitch.js

@@ -1,108 +0,0 @@
-import { fetchJson, hostMatches } from "../util.js";
-import { Codes, UMediaError } from "../errors.js";
-
-/**
- * Twitch clips — the public GraphQL endpoint the web player calls (its web
- * client-id ships in Twitch's own JS; nothing secret). Direct CloudFront mp4
- * renditions per quality. VODs/livestreams need the yt-dlp tier (honest).
- */
-export const name = "twitch";
-
-// Twitch's own public web client id (shipped in their frontend bundle)
-const CLIENT_ID = "kimne78kx3ncx6brgo4mv6wki5h1ko";
-
-export function canHandle(url) {
-  try {
-    return hostMatches(new URL(String(url)).hostname, ["twitch.tv", "clips.twitch.tv"]);
-  } catch { return false; }
-}
-
-export function clipSlug(url) {
-  const m = String(url).match(/(?:clips\.twitch\.tv\/|\/clip\/)([\w-]+)/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 slug = clipSlug(url);
-  if (!slug) {
-    attempt.status = "failed";
-    throw new UMediaError(Codes.INVALID_URL,
-      "Only Twitch CLIP urls resolve natively (clips.twitch.tv/{slug} or twitch.tv/{ch}/clip/{slug}). VODs/livestreams: use downloadWithYtdlp().", { attempts: [attempt] });
-  }
-
-  let gql;
-  try {
-    gql = await fetchJson("https://gql.twitch.tv/gql",
-      {
-        method: "POST",
-        headers: { "client-id": CLIENT_ID, "content-type": "text/plain" },
-        body: JSON.stringify({
-          query: `query{clip(slug:"${slug}"){title durationSeconds broadcaster{displayName} thumbnailURL videoQualities{frameRate quality sourceURL} playbackAccessToken(params:{platform:"web",playerType:"site"}){value signature}}}`,
-        }),
-      }, 15_000);
-  } catch (e) {
-    attempt.status = "failed";
-    attempt.error = e.message;
-    throw new UMediaError(Codes.PROVIDER_UNAVAILABLE, `Twitch GraphQL unavailable. ${e.message}`, { attempts: [attempt] });
-  }
-  const clip = gql?.data?.clip;
-  if (!clip) {
-    attempt.status = "failed";
-    attempt.error = "clip not found (expired clips are removed with their VOD)";
-    throw new UMediaError(Codes.MEDIA_NOT_FOUND, `Twitch: ${attempt.error}`, { attempts: [attempt] });
-  }
-
-  // Twitch CDN (nauth) URLs only serve with the clip's playback token — sign them like the web player
-  const tok = clip.playbackAccessToken;
-  const sign = (u) => (tok?.value && tok?.signature
-    ? `${u}${u.includes("?") ? "&" : "?"}token=${encodeURIComponent(tok.value)}&sig=${tok.signature}`
-    : u);
-
-  const variants = (clip.videoQualities || [])
-    .filter((q) => q?.sourceURL)
-    .map((q) => ({
-      height: parseInt(q.quality, 10) || null, width: null, url: sign(q.sourceURL),
-      hasAudio: true, hasVideo: true,
-      quality: q.quality ? `${q.quality}p` : null, mimeType: "video/mp4",
-    }))
-    .sort((a, b) => (b.height || 0) - (a.height || 0));
-  const chosen = variants[0];
-  if (!chosen) {
-    attempt.status = "failed";
-    throw new UMediaError(Codes.MEDIA_NOT_FOUND, "Twitch clip has no downloadable renditions", { attempts: [attempt] });
-  }
-
-  attempt.status = "success";
-  attempt.latencyMs = Date.now() - t0;
-  return {
-    result: {
-      sourceUrl: url,
-      platform: name,
-      title: clip.title || null,
-      author: clip.broadcaster?.displayName || null,
-      thumbnail: clip.thumbnailURL || null,
-      itemCount: 1,
-      counts: { images: 0, videos: 1, audios: 0, other: 0 },
-      truncated: false,
-      media: [{
-        type: "video", index: 0, url: chosen.url,
-        thumbnail: clip.thumbnailURL || null,
-        mimeType: "video/mp4",
-        width: null, height: chosen.height ?? null,
-        duration: clip.durationSeconds ?? 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/vimeo.js

@@ -1,108 +0,0 @@
-import { fetchJson, hostMatches } from "../util.js";
-import { Codes, UMediaError } from "../errors.js";
-
-/**
- * Vimeo — the public player config JSON (player.vimeo.com/video/{id}/config):
- * progressive renditions when Vimeo serves them, otherwise HLS masters with
- * real per-rendition quality labels.
- */
-export const name = "vimeo";
-
-export function canHandle(url) {
-  try {
-    return hostMatches(new URL(String(url)).hostname, ["vimeo.com", "player.vimeo.com"]);
-  } catch { return false; }
-}
-
-export function videoId(url) {
-  const m = String(url).match(/(?:video\/|vimeo\.com\/(?:video\/)?)(\d{6,12})/);
-  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 Vimeo video URL (password-protected/album URLs need the yt-dlp tier)", { attempts: [attempt] });
-  }
-
-  let cfg;
-  try {
-    cfg = await fetchJson(`https://player.vimeo.com/video/${id}/config`,
-      { headers: { referer: "https://vimeo.com/" } }, 15_000);
-  } catch (e) {
-    attempt.status = "failed";
-    attempt.error = e.message;
-    throw new UMediaError(Codes.PROVIDER_UNAVAILABLE, `Vimeo player config unavailable. ${e.message}`, { attempts: [attempt] });
-  }
-  const v = cfg?.video;
-  if (!v) {
-    attempt.status = "failed";
-    attempt.error = cfg?.title || "video unavailable";
-    throw new UMediaError(Codes.MEDIA_NOT_FOUND, `Vimeo: ${attempt.error}`, { attempts: [attempt] });
-  }
-
-  const files = cfg.request?.files || {};
-  const variants = [];
-  for (const p of (files.progressive || [])) {
-    if (!p?.url) continue;
-    variants.push({
-      height: p.height ?? null, width: p.width ?? null, url: p.url,
-      hasAudio: true, hasVideo: true,
-      quality: p.quality || (p.height ? `${p.height}p` : null),
-      mimeType: p.mime || "video/mp4",
-    });
-  }
-  const hls = files.hls || {};
-  const cdns = hls.cdns || {};
-  const defaultUrl = cdns[hls.default_cdn]?.avc_url || Object.values(cdns)[0]?.avc_url || null;
-  if (defaultUrl) {
-    variants.push({
-      height: null, width: null, url: defaultUrl,
-      hasAudio: !hls.separate_av, hasVideo: true,
-      quality: "hls", mimeType: "application/x-mpegURL",
-    });
-  }
-
-  const progressive = variants.find((v) => /mp4/.test(v.mimeType || ""));
-  const chosen = progressive || variants[0];
-  if (!chosen) {
-    attempt.status = "failed";
-    throw new UMediaError(Codes.MEDIA_NOT_FOUND, "Vimeo serves no stream URLs (private or domain-restricted video)", { attempts: [attempt] });
-  }
-
-  attempt.status = "success";
-  attempt.latencyMs = Date.now() - t0;
-  return {
-    result: {
-      sourceUrl: url,
-      platform: name,
-      title: v.title || null,
-      author: cfg.owner?.display_name || cfg.user?.name || null,
-      thumbnail: v.thumbs?.base || v.thumb || null,
-      itemCount: 1,
-      counts: { images: 0, videos: 1, audios: 0, other: 0 },
-      truncated: false,
-      media: [{
-        type: "video", index: 0, url: chosen.url,
-        thumbnail: v.thumbs?.base || v.thumb || null,
-        mimeType: chosen.mimeType,
-        width: v.width ?? null, height: v.height ?? null,
-        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/x.js

@@ -1,215 +0,0 @@
-import { fetchJson, hostMatches } from "../util.js";
-import { Codes, UMediaError } from "../errors.js";
-
-/**
- * X / Twitter — two proven public routes, no login:
- *  1. syndication embed API with the computed token (the route embed widgets use)
- *  2. GraphQL TweetDetail with a guest token (the route the logged-out web uses)
- * Both are the exact techniques from yt-dlp's twitter extractor and cobalt's
- * twitter service. Photos, videos (best bitrate mp4), gifs.
- */
-export const name = "x";
-
-const BEARER = "AAAAAAAAAAAAAAAAAAAAANRILgAAAAAAnNwIzUejRCOuH5E6I8xnZz4puTs%3D1Zv7ttfk8LF81IUq16cHjhLTvJu4FA33AGWWjCpTnA";
-const GQL_FEATURES = JSON.stringify({
-  rweb_video_screen_enabled: false, payments_enabled: false, rweb_xchat_enabled: false,
-  profile_label_improvements_pcf_label_in_post_enabled: true, rweb_tipjar_consumption_enabled: true,
-  verified_phone_label_enabled: false, creator_subscriptions_tweet_preview_api_enabled: true,
-  responsive_web_graphql_timeline_navigation_enabled: true, responsive_web_graphql_skip_user_profile_image_extensions_enabled: false,
-  premium_content_api_read_enabled: false, communities_web_enable_tweet_community_results_fetch: true,
-  c9s_tweet_anatomy_moderator_badge_enabled: true, responsive_web_grok_analyze_button_fetch_trends_enabled: false,
-  responsive_web_grok_analyze_post_followups_enabled: true, responsive_web_jetfuel_frame: true,
-  responsive_web_grok_share_attachment_enabled: true, articles_preview_enabled: true,
-  responsive_web_edit_tweet_api_enabled: true, graphql_is_translatable_rweb_tweet_is_translatable_enabled: true,
-  view_counts_everywhere_api_enabled: true, longform_notetweets_consumption_enabled: true,
-  responsive_web_twitter_article_tweet_consumption_enabled: true, tweet_awards_web_tipping_enabled: false,
-  creator_subscriptions_quote_tweet_preview_enabled: false, freedom_of_speech_not_reach_fetch_enabled: true,
-  standardized_nudges_misinfo: true, tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled: true,
-  longform_notetweets_rich_text_read_enabled: true, longform_notetweets_inline_media_enabled: true,
-  responsive_web_grok_image_annotation_enabled: true, responsive_web_grok_imagine_annotation_enabled: true,
-  responsive_web_grok_community_note_auto_translation_is_enabled: false, responsive_web_enhance_cards_enabled: false,
-});
-
-const GQL_HEADERS = {
-  authorization: `Bearer ${BEARER}`,
-  "x-twitter-client-language": "en",
-  "x-twitter-active-user": "yes",
-  "accept-language": "en",
-  "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0 Safari/537.36",
-};
-
-export function canHandle(url) {
-  try {
-    return hostMatches(new URL(String(url)).hostname, ["twitter.com", "x.com"]);
-  } catch { return false; }
-}
-
-export function tweetId(url) {
-  const m = String(url).match(/\/status(?:es)?\/(\d{8,25})/);
-  return m ? m[1] : null;
-}
-
-// the syndication embed token — computed from the tweet id (yt-dlp technique)
-const syndicationToken = (id) => ((Number(id) / 1e15) * Math.PI).toString(36).replace(/(0+|\.)/g, "");
-
-let _guestToken = null;
-async function guestToken() {
-  if (_guestToken) return _guestToken;
-  try {
-    const j = await fetchJson("https://api.x.com/1.1/guest/activate.json", {
-      method: "POST", headers: GQL_HEADERS,
-    }, 15_000);
-    if (j?.guest_token) return (_guestToken = j.guest_token);
-  } catch { /* syndication may still work */ }
-  return null;
-}
-
-function mediaFromEntities(entities, media) {
-  for (const m of entities || []) {
-    const isPhoto = m.type === "photo";
-    const isVideo = m.type === "video" || m.type === "animated_gif";
-    if (isPhoto && m.media_url_https) {
-      media.push({
-        type: "image", index: media.length, url: m.media_url_https, thumbnail: m.media_url_https,
-        mimeType: "image/jpeg", width: m.original_info?.width ?? null, height: m.original_info?.height ?? null,
-        duration: null, size: null, quality: "original",
-        hasAudio: false, hasVideo: false, source: name, variants: [],
-      });
-    } else if (isVideo && m.video_info?.variants?.length) {
-      const mp4s = m.video_info.variants
-        .filter((v) => v.content_type === "video/mp4" && v.url)
-        .map((v) => ({
-          height: null, width: null,
-          // cobalt strips the flaky `tag` param from twitter mp4 urls
-          url: (() => { try { const u = new URL(v.url); u.searchParams.delete("tag"); return u.toString(); } catch { return v.url; } })(),
-          hasAudio: true, hasVideo: true,
-          quality: v.bitrate ? `${Math.round(v.bitrate / 1000)}kbps` : "mp4",
-          mimeType: "video/mp4", bitrate: v.bitrate ?? null,
-        }))
-        .sort((a, b) => (b.bitrate || 0) - (a.bitrate || 0));
-      const best = mp4s[0]
-        || m.video_info.variants.filter((v) => v.url).map((v) => ({
-          height: null, width: null, url: v.url, hasAudio: true, hasVideo: true,
-          quality: null, mimeType: v.content_type || "application/x-mpegURL", bitrate: null,
-        }))[0];
-      if (best) {
-        media.push({
-          type: "video", index: media.length, url: best.url,
-          thumbnail: m.media_url_https || null,
-          mimeType: best.mimeType, width: m.original_info?.width ?? null, height: m.original_info?.height ?? null,
-          duration: m.video_info.duration_millis ? Math.round(m.video_info.duration_millis / 1000) : null,
-          size: null, quality: best.quality,
-          hasAudio: true, hasVideo: true, source: name, variants: mp4s,
-        });
-      }
-    }
-  }
-}
-
-export async function resolve(url, ctx = {}) {
-  const attempt = { provider: name, status: "skipped" };
-  ctx.attempts?.push(attempt);
-  const t0 = Date.now();
-
-  const id = tweetId(url);
-  if (!id) {
-    attempt.status = "failed";
-    throw new UMediaError(Codes.INVALID_URL, "Not a tweet URL (expected x.com/{user}/status/{id})", { attempts: [attempt] });
-  }
-
-  const media = [];
-  let title = null;
-  let author = null;
-
-  // 1) GraphQL TweetDetail with guest token (fullest data)
-  try {
-    const token = await guestToken();
-    if (token) {
-      const u = new URL("https://api.x.com/graphql/4Siu98E55GquhG52zHdY5w/TweetDetail");
-      u.searchParams.set("variables", JSON.stringify({
-        focalTweetId: id, with_rux_injections: false, rankingMode: "Relevance",
-        includePromotedContent: true, withCommunity: true,
-        withQuickPromoteEligibilityTweetFields: true, withBirdwatchNotes: true, withVoice: true,
-      }));
-      u.searchParams.set("features", GQL_FEATURES);
-      u.searchParams.set("fieldToggles", JSON.stringify({ withArticleRichContentState: true, withArticlePlainText: false }));
-      const j = await fetchJson(u.toString(), {
-        headers: { ...GQL_HEADERS, "content-type": "application/json", "x-guest-token": token, cookie: `guest_id=v1%3A${token}` },
-      }, 20_000);
-      const entries = j?.data?.threaded_conversation_with_injections_v2?.instructions
-        ?.find((i) => i.type === "TimelineAddEntries")?.entries || [];
-      const node = entries.find((e) => e.entryId === `tweet-${id}`)?.content?.itemContent?.tweet_results?.result;
-      let base = node?.legacy;
-      if (node?.__typename === "TweetWithVisibilityResults") base = node.tweet?.legacy;
-      const rep = base?.retweeted_status_result?.result?.legacy?.extended_entities
-        || base?.retweeted_status_result?.result?.tweet?.legacy?.extended_entities;
-      if (base?.full_text) title = base.full_text;
-      author = node?.core?.user_results?.result?.legacy?.screen_name
-        || node?.tweet?.core?.user_results?.result?.legacy?.screen_name || null;
-      mediaFromEntities(rep?.media || base?.extended_entities?.media, media);
-    }
-  } catch (e) {
-    attempt.note = `graphql: ${String(e.message).slice(0, 60)}`;
-  }
-
-  // 2) syndication embed API with the computed token (embed-widget route)
-  if (!media.length) {
-    try {
-      const j = await fetchJson(
-        `https://cdn.syndication.twimg.com/tweet-result?id=${id}&token=${syndicationToken(id)}&lang=en`, {}, 15_000);
-      title = title || j?.text || null;
-      author = author || j?.user?.screen_name || null;
-      mediaFromEntities(j?.mediaDetails, media);
-      if (!media.length && j?.video?.variants) {
-        const mp4s = j.video.variants.filter((v) => v.type === "video/mp4").sort((a, b) => (b.bitrate || 0) - (a.bitrate || 0));
-        if (mp4s[0]) media.push({
-          type: "video", index: 0, url: mp4s[0].src, thumbnail: j.thumbnail?.image?.src || null,
-          mimeType: "video/mp4", width: null, height: null,
-          duration: j.video.duration_millis ? Math.round(j.video.duration_millis / 1000) : null,
-          size: null, quality: mp4s[0].bitrate ? `${Math.round(mp4s[0].bitrate / 1000)}kbps` : null,
-          hasAudio: true, hasVideo: true, source: name,
-          variants: mp4s.map((v) => ({ height: null, width: null, url: v.src, hasAudio: true, hasVideo: true, quality: v.bitrate ? `${Math.round(v.bitrate / 1000)}kbps` : null, mimeType: "video/mp4", bitrate: v.bitrate ?? null })),
-        });
-      }
-    } catch (e) {
-      attempt.note = `${attempt.note ? attempt.note + " · " : ""}syndication: ${String(e.message).slice(0, 60)}`;
-    }
-  }
-
-  if (!media.length) {
-    attempt.status = "failed";
-    attempt.error = j_err(attempt.note);
-    throw new UMediaError(Codes.MEDIA_NOT_FOUND,
-      `X exposes no media for this tweet (${attempt.error}) — protected/removed tweets stay inaccessible; the yt-dlp tier adds cookie support.`, { attempts: [attempt] });
-  }
-
-  attempt.status = "success";
-  attempt.latencyMs = Date.now() - t0;
-  return {
-    result: {
-      sourceUrl: url,
-      platform: name,
-      title: title ? title.slice(0, 200) : 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 },
-  };
-}
-
-function j_err(note) {
-  return (note || "no media in public routes").replace(/^.*?(graphql|syndication)/, "$1");
-}
-
-export async function search() {
-  return [];
-}