@postfetch/core 0.12.4 → 0.13.0

package/dist/index.js

@@ -2015,902 +2015,1113 @@ function trackId(track) {
   return string(track.permalink) ?? "track";
 }
 
-// src/tiktok.ts
-var marker = '<script id="__UNIVERSAL_DATA_FOR_REHYDRATION__" type="application/json">';
-var pageAttemptCount = 12;
-async function resolveTiktok(input) {
-  const pageUrl = await followShortlink(input.net, browserUserAgent(), input.url);
-  const id = videoId(pageUrl);
+// src/youtube.ts
+var androidVrClient = {
+  name: "ANDROID_VR",
+  number: "28",
+  userAgent: "com.google.android.apps.youtube.vr.oculus/1.65.10 (Linux; U; Android 12L; eureka-user Build/SQ3A.220605.009.A1) gzip",
+  version: "1.65.10"
+};
+var visionOsClient = {
+  clientName: "VISIONOS",
+  clientVersion: "1.02",
+  deviceMake: "Apple",
+  deviceModel: "RealityDevice17,1",
+  userAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_7_3) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/26.0 Safari/605.1.15",
+  osName: "visionOS",
+  osVersion: "26.5.23O471"
+};
+var browserCookie = "PREF=hl=en&tz=UTC; SOCS=CAI";
+async function resolveYoutube(input) {
+  const id = youtubeVideoId(input.url);
   if (!id) {
-    throw new Error("TikTok video id not found");
-  }
-  const page = await videoPage(input.net, id, asUrl(pageUrl).pathname.includes("/photo/"));
-  const user = author(page.item) ?? username(pageUrl) ?? "i";
-  const headers = {
-    referer: `https://www.tiktok.com/@${encodeURIComponent(user)}/video/${encodeURIComponent(id)}`,
-    "user-agent": page.userAgent
-  };
-  if (page.cookie) {
-    headers.cookie = page.cookie;
-  }
-  const items = mediaItems4(page.item, user, id, headers);
-  if (items.length === 0) {
-    throw new Error("TikTok media not found");
+    throw new Error("YouTube video id not found");
   }
-  return { archiveFilename: filename(`tiktok_${user}_${id}.zip`), comments: [], id, items, metadata: tiktokMetadata(page.item), platform: "tiktok" };
-}
-async function videoPage(net, id, photo) {
-  for (let attempt = 0;attempt < pageAttemptCount; attempt += 1) {
-    const baseHeaders2 = attempt % 2 === 0 ? navigationHeaders() : firefoxNavigationHeaders();
-    const userAgent2 = baseHeaders2["user-agent"];
-    const headers2 = {
-      ...baseHeaders2,
-      referer: "https://www.tiktok.com/",
-      "sec-fetch-site": "same-origin"
-    };
+  let session;
+  try {
+    session = await youtubeSession(input.net, id);
+    const payload = await youtubePlayer(input.net, playerBody(id, session), playerHeaders(session));
+    const streams = selectStreams(payload, input.preferredWidth);
+    if (!streams) {
+      throw new Error("YouTube mp4 stream not found");
+    }
+    const headers = { "user-agent": androidVrClient.userAgent };
+    await Promise.all([streams.video, streams.audio].filter((url) => url !== null).map((url) => probeStream(input.net, url, headers)));
+    return youtubeResult(id, payload, streams, headers);
+  } catch (primaryError) {
     try {
-      return { ...await fetchVideoPage(net, id, headers2), userAgent: userAgent2 };
-    } catch (error) {
-      if (!recoverablePageError(error)) {
-        throw error;
-      }
+      return await resolveVisionOs(input, id, session?.visitorData);
+    } catch (fallbackError) {
+      const message = (error) => error instanceof Error ? error.message : String(error);
+      throw new Error(`YouTube resolution failed: ${message(primaryError)}; visionOS HLS: ${message(fallbackError)}`, { cause: fallbackError });
     }
   }
-  if (!photo) {
-    throw new Error("TikTok hydration not found");
+}
+async function youtubePlayer(net, body, headers) {
+  const response = await net("https://www.youtube.com/youtubei/v1/player?prettyPrint=false", {
+    body: JSON.stringify(body),
+    headers,
+    method: "POST"
+  });
+  if (!response.ok) {
+    throw new Error(`YouTube player failed: ${response.status}`);
   }
-  const baseHeaders = navigationHeaders();
-  const userAgent = baseHeaders["user-agent"];
-  const headers = {
-    ...baseHeaders,
-    referer: "https://www.tiktok.com/",
-    "sec-fetch-site": "same-origin"
+  const payload = await response.json();
+  const status = object(payload) && object(payload.playabilityStatus) ? string(payload.playabilityStatus.status) : null;
+  if (status !== "OK") {
+    const reason = object(payload) && object(payload.playabilityStatus) ? string(payload.playabilityStatus.reason) : null;
+    throw new Error(reason ?? "YouTube video unavailable");
+  }
+  return payload;
+}
+function youtubeResult(id, payload, streams, headers) {
+  const title = object(payload) && object(payload.videoDetails) ? string(payload.videoDetails.title) : null;
+  const media = {
+    filename: filename(`youtube_${title ?? id}_${id}.mp4`),
+    headers,
+    id,
+    kind: "video",
+    mime: "video/mp4",
+    platform: "youtube",
+    url: streams.video,
+    ...streams.hls ? { hls: true } : {},
+    ...streams.audio ? { audio: { headers, url: streams.audio } } : {}
   };
-  return { ...await fetchEmbedPage(net, id, headers), userAgent };
+  return { archiveFilename: filename(`youtube_${id}.zip`), comments: [], id, items: [media], metadata: youtubeMetadata(payload), platform: "youtube" };
 }
-function tiktokMetadata(item) {
-  const user = object(item.author) ? item.author : null;
-  const stats = object(item.stats) ? item.stats : null;
-  const music = object(item.music) ? item.music : null;
-  const video = object(item.video) ? item.video : null;
+async function probeStream(net, url, headers) {
+  const response = await net(url, { headers }, 1);
+  await response.body?.cancel();
+  if (!response.ok) {
+    throw new Error(`YouTube stream failed: ${response.status}`);
+  }
+}
+async function resolveVisionOs(input, id, visitorData) {
+  const headers = { "user-agent": visionOsClient.userAgent };
+  const payload = await youtubePlayer(input.net, {
+    videoId: id,
+    contentCheckOk: true,
+    racyCheckOk: true,
+    context: { client: { ...visionOsClient, hl: "en", gl: "US", ...visitorData ? { visitorData } : {} } }
+  }, {
+    ...headers,
+    "content-type": "application/json",
+    "x-youtube-client-name": "101",
+    "x-youtube-client-version": visionOsClient.clientVersion,
+    ...visitorData ? { "x-goog-visitor-id": visitorData } : {}
+  });
+  const streaming = object(payload) && object(payload.streamingData) ? payload.streamingData : null;
+  const manifestUrl = streaming ? string(streaming.hlsManifestUrl) : null;
+  if (!manifestUrl) {
+    throw new Error("YouTube HLS manifest not found");
+  }
+  const response = await input.net(manifestUrl, { headers });
+  if (!response.ok) {
+    throw new Error(`YouTube HLS manifest failed: ${response.status}`);
+  }
+  const master = parseMaster(await response.text(), manifestUrl, { preferOriginalAudio: true });
+  const variants = master.variants.filter((variant2) => /(?:^|,)(?:vp09|av01)\./i.test(variant2.codecs ?? "") && /(?:^|,)mp4a\.40\.2(?:,|$)/i.test(variant2.codecs ?? "") && variant2.audioGroup && master.audio[variant2.audioGroup]).sort((left, right) => Math.abs(left.width - input.preferredWidth) - Math.abs(right.width - input.preferredWidth) || right.bandwidth - left.bandwidth);
+  const variant = variants[0];
+  if (!variant?.audioGroup) {
+    throw new Error("YouTube fragmented MP4 HLS video with AAC audio not found");
+  }
+  const playlist = await input.net(variant.url, { headers });
+  if (!playlist.ok) {
+    throw new Error(`YouTube HLS playlist failed: ${playlist.status}`);
+  }
+  if (!(await playlist.text()).includes("#EXT-X-MAP:")) {
+    throw new Error("YouTube HLS video is not fragmented MP4");
+  }
+  return youtubeResult(id, payload, { video: variant.url, audio: master.audio[variant.audioGroup], hls: true }, headers);
+}
+function youtubeMetadata(payload) {
+  const details = object(payload) && object(payload.videoDetails) ? payload.videoDetails : null;
+  const renderer = object(payload) && object(payload.microformat) && object(payload.microformat.playerMicroformatRenderer) ? payload.microformat.playerMicroformatRenderer : null;
+  const author = details ? string(details.author) : null;
+  const keywords = details && Array.isArray(details.keywords) ? details.keywords.filter((keyword) => typeof keyword === "string") : [];
   return {
-    text: string(item.desc) ?? undefined,
-    author: user ? {
-      handle: string(user.uniqueId) ?? undefined,
-      name: string(user.nickname) ?? undefined,
-      verified: bool(user.verified)
-    } : undefined,
-    createdAt: isoFromEpochSeconds(item.createTime),
-    likeCount: stats ? count(stats.diggCount) : undefined,
-    commentCount: stats ? count(stats.commentCount) : undefined,
-    shareCount: stats ? count(stats.shareCount) : undefined,
-    viewCount: stats ? count(stats.playCount) : undefined,
+    title: details ? string(details.title) ?? undefined : undefined,
+    text: details ? string(details.shortDescription) ?? undefined : undefined,
+    author: author ? { name: author } : undefined,
+    createdAt: renderer ? isoFromDateString(renderer.publishDate) : undefined,
+    viewCount: details ? count(details.viewCount) : undefined,
     extra: {
-      saveCount: stats ? count(stats.collectCount) : undefined,
-      musicTitle: music ? string(music.title) ?? undefined : undefined,
-      musicAuthor: music ? string(music.authorName) ?? undefined : undefined,
-      region: string(item.locationCreated) ?? undefined,
-      durationSeconds: video ? count(video.duration) : undefined
+      channelId: details ? string(details.channelId) ?? undefined : undefined,
+      durationSeconds: details ? count(details.lengthSeconds) : undefined,
+      keywords: keywords.length > 0 ? keywords : undefined
     }
   };
 }
-async function fetchVideoPage(net, id, headers) {
-  const page = await net(`https://www.tiktok.com/@i/video/${id}`, {
-    headers
-  });
-  return { cookie: cookieHeader(page.headers), item: itemStruct(await page.text()) };
+function selectStreams(payload, preferredWidth) {
+  const adaptive = adaptiveFormats(payload);
+  const video = bestVideo(adaptive, preferredWidth);
+  const audio = bestAudio(adaptive);
+  if (video && audio) {
+    return { video, audio };
+  }
+  const progressive = selectFormat(payload);
+  return progressive ? { video: progressive, audio: null } : null;
 }
-async function fetchEmbedPage(net, id, headers) {
-  const page = await net(`https://www.tiktok.com/embed/v2/${id}`, {
-    headers
+function adaptiveFormats(payload) {
+  const root = object(payload) ? payload : null;
+  const streaming = root && object(root.streamingData) ? root.streamingData : null;
+  return streaming && Array.isArray(streaming.adaptiveFormats) ? streaming.adaptiveFormats.filter(object) : [];
+}
+function bestVideo(formats, preferredWidth) {
+  const candidates = formats.filter((format) => {
+    const mimeType2 = string(format.mimeType);
+    return Boolean(string(format.url)) && mimeType2?.startsWith("video/mp4") === true && mimeType2.includes("avc1");
   });
-  return { cookie: cookieHeader(page.headers), item: embedItemStruct(await page.text(), id) };
+  const best = candidates.reduce((current, format) => {
+    if (!current) {
+      return format;
+    }
+    const width = number(format.width) ?? 0;
+    const currentWidth = number(current.width) ?? 0;
+    return Math.abs(width - preferredWidth) < Math.abs(currentWidth - preferredWidth) ? format : current;
+  }, null);
+  return best ? string(best.url) : null;
 }
-function isShortlinkHost(hostname) {
-  return hostname === "vm.tiktok.com" || hostname === "vt.tiktok.com";
+function bestAudio(formats) {
+  const candidates = formats.filter((format) => Boolean(string(format.url)) && string(format.mimeType)?.startsWith("audio/mp4") === true);
+  const best = candidates.reduce((current, format) => {
+    if (!current) {
+      return format;
+    }
+    const preference = audioPreference(format) - audioPreference(current);
+    if (preference !== 0) {
+      return preference > 0 ? format : current;
+    }
+    return (number(format.bitrate) ?? 0) > (number(current.bitrate) ?? 0) ? format : current;
+  }, null);
+  return best ? string(best.url) : null;
 }
-async function followShortlink(net, userAgent, input) {
-  const url = asUrl(input);
-  if (!isShortlinkHost(url.hostname)) {
-    return input;
-  }
-  const response = await net(input, { headers: { "user-agent": userAgent }, redirect: "manual" }, 1);
-  const location = response.headers.get("location");
-  if (location) {
-    return new URL(location, input).href;
+function audioPreference(format) {
+  const track = object(format.audioTrack) ? format.audioTrack : null;
+  if (track && /\boriginal\b/i.test(string(track.displayName) ?? "")) {
+    return 2;
   }
-  const html = await response.text();
-  const href = html.match(/<a href="(https:\/\/[^"]+)"/)?.[1];
-  return href ? new URL(href.split("?")[0]).href : input;
+  return track?.audioIsDefault === true ? 1 : 0;
 }
-function videoId(input) {
-  return asUrl(input).pathname.match(/(?:video|photo)\/(\d+)/)?.[1] ?? null;
-}
-function itemStruct(html) {
-  if (html.includes("SlardarWAF") || html.includes("_wafchallengeid")) {
-    throw new Error("TikTok WAF challenge");
-  }
-  const start = html.indexOf(marker);
-  const end = start === -1 ? -1 : html.indexOf("</script>", start + marker.length);
-  if (start === -1 || end === -1) {
-    throw new Error("TikTok hydration not found");
-  }
-  const parsed = JSON.parse(html.slice(start + marker.length, end));
-  const scope = object(parsed) && object(parsed.__DEFAULT_SCOPE__) ? parsed.__DEFAULT_SCOPE__ : null;
-  const detail = scope && object(scope["webapp.video-detail"]) ? scope["webapp.video-detail"] : null;
-  const info = detail && object(detail.itemInfo) ? detail.itemInfo : null;
-  const item = info && object(info.itemStruct) ? info.itemStruct : null;
-  if (!item) {
-    throw new Error("TikTok itemStruct not found");
-  }
-  return item;
+function playerBody(id, session) {
+  return {
+    contentCheckOk: true,
+    context: {
+      client: {
+        androidSdkVersion: 32,
+        clientName: androidVrClient.name,
+        clientVersion: androidVrClient.version,
+        deviceMake: "Oculus",
+        deviceModel: "Quest 3",
+        gl: "US",
+        hl: "en",
+        osName: "Android",
+        osVersion: "12L",
+        timeZone: "UTC",
+        userAgent: androidVrClient.userAgent,
+        utcOffsetMinutes: 0,
+        visitorData: session.visitorData
+      }
+    },
+    playbackContext: {
+      contentPlaybackContext: {
+        html5Preference: "HTML5_PREF_WANTS",
+        signatureTimestamp: session.signatureTimestamp
+      }
+    },
+    racyCheckOk: true,
+    videoId: id
+  };
 }
-function embedItemStruct(html, id) {
-  const raw = html.match(/<script\b[^>]*\bid=["']__FRONTITY_CONNECT_STATE__["'][^>]*>([\s\S]*?)<\/script>/i)?.[1];
-  if (!raw) {
-    throw new Error("TikTok embed state not found");
+async function youtubeSession(net, id) {
+  const response = await net(`https://www.youtube.com/watch?v=${id}&bpctr=9999999999&has_verified=1`, {
+    headers: {
+      accept: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+      "accept-language": "en-us,en;q=0.5",
+      cookie: browserCookie,
+      "sec-fetch-mode": "navigate",
+      "user-agent": browserUserAgent()
+    }
+  });
+  if (!response.ok) {
+    throw new Error(`YouTube page failed: ${response.status}`);
   }
-  const parsed = JSON.parse(raw);
-  const source2 = object(parsed) && object(parsed.source) ? parsed.source : null;
-  const data = source2 && object(source2.data) ? source2.data : null;
-  const rawRoute = data ? data[`/embed/v2/${id}`] : null;
-  const route = object(rawRoute) ? rawRoute : null;
-  const videoData = route && object(route.videoData) ? route.videoData : null;
-  const item = videoData && object(videoData.itemInfos) ? videoData.itemInfos : null;
-  if (!videoData || !item) {
-    throw new Error("TikTok embed item not found");
+  const page = await response.text();
+  const visitorData = string(page.match(/"visitorData":"([^"]+)"/)?.[1]);
+  if (!visitorData) {
+    throw new Error("YouTube visitor data not found");
   }
-  const authorInfo = object(videoData.authorInfos) ? videoData.authorInfos : {};
-  const musicInfo = object(videoData.musicInfos) ? videoData.musicInfos : {};
-  const video = object(item.video) ? item.video : {};
-  const videoMeta = object(video.videoMeta) ? video.videoMeta : {};
-  const imagePost = object(videoData.imagePostInfo) ? videoData.imagePostInfo : null;
-  const displayImages = imagePost && Array.isArray(imagePost.displayImages) ? imagePost.displayImages.filter(object) : [];
-  if (displayImages.length === 0) {
-    throw new Error("TikTok video hydration not found");
+  const playerPath = string(page.match(/"jsUrl":"([^"]+)"/)?.[1]) ?? string(page.match(/"PLAYER_JS_URL":"([^"]+)"/)?.[1]);
+  if (!playerPath) {
+    throw new Error("YouTube player url not found");
   }
   return {
-    ...item,
-    author: {
-      nickname: string(authorInfo.nickName),
-      uniqueId: string(authorInfo.uniqueId),
-      verified: bool(authorInfo.verified)
-    },
-    desc: string(item.text),
-    imagePost: {
-      images: displayImages.map((image) => ({
-        imageURL: {
-          urlList: Array.isArray(image.urlList) ? image.urlList.map(string).filter((url) => Boolean(url)) : []
-        }
-      }))
-    },
-    music: {
-      authorName: string(musicInfo.authorName),
-      playUrl: firstString(musicInfo.playUrl),
-      title: string(musicInfo.musicName)
-    },
-    stats: {
-      commentCount: item.commentCount,
-      diggCount: item.diggCount,
-      playCount: item.playCount,
-      shareCount: item.shareCount
-    },
-    video: {
-      duration: videoMeta.duration
-    }
+    cookie: youtubeCookie(response.headers),
+    signatureTimestamp: await signatureTimestamp(net, playerPath),
+    visitorData
   };
 }
-function recoverablePageError(error) {
-  const message = error instanceof Error ? error.message : "";
-  return message === "TikTok WAF challenge" || message === "TikTok hydration not found";
+function playerHeaders(session) {
+  return new Headers({
+    "content-type": "application/json",
+    cookie: `${browserCookie}; ${session.cookie}`,
+    origin: "https://www.youtube.com",
+    "user-agent": androidVrClient.userAgent,
+    "x-goog-visitor-id": session.visitorData,
+    "x-youtube-client-name": androidVrClient.number,
+    "x-youtube-client-version": androidVrClient.version
+  });
 }
-function firstString(value) {
-  return Array.isArray(value) ? value.map(string).find((candidate) => candidate !== null) ?? null : string(value);
+function youtubeCookie(headers) {
+  const readable = headers;
+  const fallback = headers.get("set-cookie");
+  const cookieHeaders = readable.getSetCookie ? readable.getSetCookie() : fallback ? [fallback] : [];
+  return cookieHeaders.map((header) => string(header.split(";", 1)[0])).filter(string).join("; ");
 }
-function downloadUrl(item) {
-  const video = object(item.video) ? item.video : null;
-  return video ? string(video.playAddr) ?? string(video.downloadAddr) : null;
+async function signatureTimestamp(net, playerPath) {
+  const response = await net(new URL(playerPath, "https://www.youtube.com").toString(), {
+    headers: { "user-agent": browserUserAgent() }
+  });
+  if (!response.ok) {
+    throw new Error(`YouTube player failed: ${response.status}`);
+  }
+  const player = await response.text();
+  const timestamp = number(Number(player.match(/signatureTimestamp[:=](\d+)/)?.[1] ?? player.match(/sts[:=](\d+)/)?.[1]));
+  if (!timestamp) {
+    throw new Error("YouTube signature timestamp not found");
+  }
+  return timestamp;
 }
-function mediaItems4(item, user, id, headers) {
-  const images = imageItems3(item, user, id, headers);
-  if (images.length > 0) {
-    const audio = audioItem2(item, user, id, headers);
-    return audio ? [...images, audio] : images;
+function youtubeVideoId(input) {
+  const url = asUrl(input);
+  if (url.hostname === "youtu.be") {
+    return cleanId(url.pathname.split("/").filter(Boolean)[0]);
   }
-  const url = downloadUrl(item);
-  return url ? [{
-    filename: filename(`tiktok_${user}_${id}.mp4`),
-    headers,
-    id,
-    kind: "video",
-    mime: "video/mp4",
-    platform: "tiktok",
-    url
-  }] : [];
+  const fromQuery = cleanId(url.searchParams.get("v"));
+  if (fromQuery) {
+    return fromQuery;
+  }
+  const parts = url.pathname.split("/").filter(Boolean);
+  const index = parts.findIndex((part) => part === "shorts" || part === "live" || part === "embed");
+  return index >= 0 ? cleanId(parts[index + 1]) : null;
 }
-function imageItems3(item, user, id, headers) {
-  const imagePost = object(item.imagePost) ? item.imagePost : null;
-  const images = imagePost && Array.isArray(imagePost.images) ? imagePost.images.filter(object) : [];
-  return images.flatMap((image, index) => {
-    const imageUrl2 = object(image.imageURL) ? image.imageURL : null;
-    const list = imageUrl2 && Array.isArray(imageUrl2.urlList) ? imageUrl2.urlList : [];
-    const url = list.map(string).find((candidate) => Boolean(candidate)) ?? null;
-    return url ? [{
-      filename: filename(`tiktok_${user}_${id}_${index + 1}.jpg`),
-      headers,
-      id,
-      kind: "image",
-      mime: "image/jpeg",
-      platform: "tiktok",
-      url
-    }] : [];
-  });
+function cleanId(value) {
+  return typeof value === "string" && /^[A-Za-z0-9_-]{11}$/.test(value) ? value : null;
 }
-function audioItem2(item, user, id, headers) {
-  const video = object(item.video) ? item.video : null;
-  const music = object(item.music) ? item.music : null;
-  const url = video ? string(video.playAddr) : null;
-  const fallback = music ? string(music.playUrl) : null;
-  const selected = url ?? fallback;
-  if (!selected) {
-    return null;
+function selectFormat(payload) {
+  const root = object(payload) ? payload : null;
+  const streaming = root && object(root.streamingData) ? root.streamingData : null;
+  const formats = streaming && Array.isArray(streaming.formats) ? streaming.formats.filter(object) : [];
+  const mp4 = formats.filter((format) => string(format.url) && string(format.mimeType)?.startsWith("video/mp4")).sort((left, right) => height(right) - height(left));
+  return mp4[0] ? string(mp4[0].url) : null;
+}
+function height(format) {
+  return number(format.height) ?? Number(string(format.qualityLabel)?.match(/(\d+)p/)?.[1] ?? 0);
+}
+
+// src/spotify.ts
+async function resolveSpotify(input) {
+  const url = asUrl(input.url);
+  const id = url.pathname.match(/^\/(?:intl-[a-z-]+\/)?(?:embed\/)?track\/([A-Za-z0-9]{22})\/?$/i)?.[1];
+  if (!id) {
+    throw new PostfetchError(400, "Spotify requires an open.spotify.com track URL");
   }
-  const extension = selected.includes("mime_type=audio_mpeg") ? "mp3" : "m4a";
+  const track = await spotifyTrack(input, id);
+  const youtubeUrl = await matchYoutube(input, track);
+  const youtube = await resolveYoutube({ ...input, url: youtubeUrl });
   return {
-    filename: filename(`tiktok_${user}_${id}_audio.${extension}`),
-    headers,
+    archiveFilename: filename(`spotify_${id}.zip`),
+    comments: [],
     id,
-    kind: "audio",
-    mime: extension === "mp3" ? "audio/mpeg" : "audio/mp4",
-    platform: "tiktok",
-    url: selected
+    items: youtube.items,
+    platform: "spotify",
+    metadata: {
+      title: track.title,
+      author: { name: track.artists.join(", ") },
+      extra: { artists: track.artists, durationSeconds: track.durationSeconds, youtubeUrl }
+    }
   };
 }
-function author(item) {
-  const user = object(item.author) ? item.author : null;
-  return user ? string(user.uniqueId) : null;
+async function spotifyTrack(input, id) {
+  const response = await input.net(`https://open.spotify.com/embed/track/${id}`, {
+    headers: { "user-agent": browserUserAgent() }
+  });
+  if (!response.ok) {
+    throw new PostfetchError(response.status === 404 ? 404 : 502, `Spotify track lookup failed: ${response.status}`);
+  }
+  const html = await response.text();
+  const raw = html.match(/<script\b[^>]*\bid=["']__NEXT_DATA__["'][^>]*>([\s\S]*?)<\/script>/i)?.[1];
+  const payload = parseJson2(raw);
+  const props = payload && object(payload.props) ? payload.props : null;
+  const page = props && object(props.pageProps) ? props.pageProps : null;
+  const state = page && object(page.state) ? page.state : null;
+  const data = state && object(state.data) ? state.data : null;
+  const entity = data && object(data.entity) ? data.entity : null;
+  const title = entity && (string(entity.title) ?? string(entity.name));
+  const artists = entity && Array.isArray(entity.artists) ? entity.artists.filter(object).map((artist) => string(artist.name)).filter((name) => name !== null) : [];
+  if (!entity || entity.type !== "track" || entity.id !== id || !title || artists.length === 0) {
+    throw new PostfetchError(502, "Spotify track metadata not found");
+  }
+  const duration = number(entity.duration);
+  return { title, artists, durationSeconds: duration !== null && duration > 0 ? duration / 1000 : undefined };
+}
+async function matchYoutube(input, track) {
+  const url = new URL("https://www.youtube.com/results");
+  url.searchParams.set("search_query", `${track.artists.join(" ")} ${track.title} audio`);
+  url.searchParams.set("hl", "en");
+  const response = await input.net(url.href, {
+    headers: { "accept-language": "en-US,en;q=0.9", cookie: "SOCS=CAI", "user-agent": browserUserAgent() }
+  });
+  if (!response.ok) {
+    throw new PostfetchError(502, `YouTube search failed: ${response.status}`);
+  }
+  const html = await response.text();
+  const raw = html.match(/(?:\bytInitialData|window\[["']ytInitialData["']\])\s*=\s*(\{[\s\S]*?)<\/script>/)?.[1];
+  const payload = parseAssignment(raw);
+  if (!payload || !object(payload.contents)) {
+    throw new PostfetchError(502, "YouTube search results not found");
+  }
+  const candidates = videoRenderers(payload.contents);
+  const ranked = candidates.map((candidate, index) => ({ candidate, score: matchScore(track, candidate) - index / 1000 })).filter(({ score }) => Number.isFinite(score)).sort((left, right) => right.score - left.score);
+  const id = ranked[0]?.candidate.videoId;
+  if (typeof id !== "string") {
+    throw new PostfetchError(404, "No matching YouTube video found for this Spotify track", "notFound");
+  }
+  return `https://www.youtube.com/watch?v=${id}`;
+}
+function videoRenderers(value) {
+  if (Array.isArray(value))
+    return value.flatMap(videoRenderers);
+  if (!object(value))
+    return [];
+  if (object(value.videoRenderer))
+    return [value.videoRenderer];
+  return Object.values(value).flatMap(videoRenderers);
 }
-function username(input) {
-  return asUrl(input).pathname.match(/@([^/]+)/)?.[1] ?? null;
+function text(value) {
+  if (!object(value))
+    return "";
+  return string(value.simpleText) ?? (Array.isArray(value.runs) ? value.runs.filter(object).map((run) => typeof run.text === "string" ? run.text : "").join("") : "");
 }
-function cookieHeader(headers) {
-  const getter = headers.getSetCookie;
-  const setCookie = typeof getter === "function" ? getter.call(headers).join(",") : headers.get("set-cookie");
-  const cookies = setCookie?.split(/,(?=[^;]+?=)/).map((part) => part.split(";")[0]?.trim()).filter((part) => Boolean(part));
-  return cookies && cookies.length > 0 ? cookies.join("; ") : null;
+function normalize(value) {
+  return value.normalize("NFKD").replace(/\p{M}/gu, "").toLowerCase().replace(/[^\p{L}\p{N}]+/gu, " ").trim();
 }
-
-// src/twitter.ts
-async function resolveTwitter(input) {
-  const id = tweetId(input.url);
-  if (!id) {
-    throw new Error("Tweet id not found");
+function contains(haystack, needle) {
+  return needle.length > 0 && ` ${haystack} `.includes(` ${needle} `);
+}
+function durationSeconds(value) {
+  if (!/^\d+(?::\d{2}){1,2}$/.test(value))
+    return null;
+  return value.split(":").reduce((seconds, part) => seconds * 60 + Number(part), 0);
+}
+function matchScore(track, candidate) {
+  if (typeof candidate.videoId !== "string" || !/^[A-Za-z0-9_-]{11}$/.test(candidate.videoId))
+    return -Infinity;
+  const title = normalize(text(candidate.title));
+  const author = normalize(text(candidate.ownerText) || text(candidate.longBylineText) || text(candidate.shortBylineText));
+  const expected = normalize(track.title.replace(/\s*[([](?:feat\.?|ft\.?).*?[)\]]/gi, ""));
+  const tokens = expected.split(" ").filter(Boolean);
+  if (tokens.length === 0)
+    return -Infinity;
+  const coverage = tokens.filter((token) => contains(title, token)).length / tokens.length;
+  if (coverage < (tokens.length <= 3 ? 1 : 0.8))
+    return -Infinity;
+  if (tokens.length <= 3 && !contains(title, expected))
+    return -Infinity;
+  const artists = track.artists.map(normalize);
+  if (!contains(`${title} ${author}`, artists[0]))
+    return -Infinity;
+  const duration = durationSeconds(text(candidate.lengthText));
+  if (duration === null || duration <= 0)
+    return -Infinity;
+  const tolerance = Math.min(30, Math.max(12, (track.durationSeconds ?? duration) * 0.08));
+  const delta = track.durationSeconds === undefined ? 0 : Math.abs(duration - track.durationSeconds);
+  if (delta > tolerance)
+    return -Infinity;
+  let recordingTitle = title;
+  for (const artist of artists)
+    recordingTitle = recordingTitle.replace(artist, "");
+  for (const version of [/\bremix\b/, /\bcover\b/, /\bkaraoke\b/, /\binstrumental\b/, /\bslowed\b/, /\b(?:sped|speed) up\b/, /\bnightcore\b/, /\blive\b/, /\bacoustic\b/]) {
+    if (version.test(recordingTitle) !== version.test(expected))
+      return -Infinity;
+  }
+  const artistUpload = contains(author, artists[0]);
+  const credited = artists.filter((artist) => contains(`${title} ${author}`, artist)).length / artists.length;
+  return coverage * 10 + (artistUpload ? 8 : 0) + credited * 2 + (contains(title, "official") ? 2 : 0) + 3 * (1 - delta / tolerance);
+}
+function parseJson2(value) {
+  try {
+    const parsed = JSON.parse(value ?? "");
+    return object(parsed) ? parsed : null;
+  } catch {
+    return null;
   }
-  const tweet = await syndication(input.net, id);
-  if (string(tweet.__typename) === "TweetTombstone") {
-    throw new Error("Tweet is unavailable or age-restricted");
+}
+function parseAssignment(value) {
+  if (!value)
+    return null;
+  let depth = 0;
+  let quoted = false;
+  let escaped = false;
+  for (let index = 0;index < value.length; index += 1) {
+    const character = value[index];
+    if (quoted) {
+      if (escaped)
+        escaped = false;
+      else if (character === "\\")
+        escaped = true;
+      else if (character === '"')
+        quoted = false;
+    } else if (character === '"')
+      quoted = true;
+    else if (character === "{")
+      depth += 1;
+    else if (character === "}" && --depth === 0)
+      return parseJson2(value.slice(0, index + 1));
   }
-  await expandTwitterText(input.net, tweet, id);
-  const groups = twitterTweets(tweet, id).flatMap(({ id: postId2, tweet: post }) => {
-    const media = Array.isArray(post.mediaDetails) ? post.mediaDetails.filter(object) : [];
-    return media.flatMap((entry, index) => {
-      const candidates = twitterCandidates(entry, postId2, index + 1);
-      return candidates.length > 0 ? [candidates] : [];
-    });
-  });
-  const items = input.tryMaxBytes === undefined ? groups.map((group) => group[0].item) : await sizeLimitedItems(input, groups);
-  return { archiveFilename: filename(`twitter_${id}.zip`), comments: await twitterComments(input, id), id, items, metadata: twitterMetadata(tweet), platform: "twitter" };
+  return null;
 }
-function twitterMetadata(tweet) {
-  const user = object(tweet.user) ? tweet.user : null;
-  const extra = {};
-  const lang = string(tweet.lang);
-  if (lang) {
-    extra.lang = lang;
+
+// src/tiktok.ts
+var marker = '<script id="__UNIVERSAL_DATA_FOR_REHYDRATION__" type="application/json">';
+var pageAttemptCount = 12;
+async function resolveTiktok(input) {
+  const pageUrl = await followShortlink(input.net, browserUserAgent(), input.url);
+  const id = videoId(pageUrl);
+  if (!id) {
+    throw new Error("TikTok video id not found");
   }
-  const quotedTweet = object(tweet.quoted_tweet) ? tweet.quoted_tweet : null;
-  const quotedId = quotedTweet ? string(quotedTweet.id_str) : null;
-  if (quotedTweet && quotedId) {
-    extra.quotedTweet = { id: quotedId, metadata: twitterMetadata(quotedTweet) };
+  const page = await videoPage(input.net, id, asUrl(pageUrl).pathname.includes("/photo/"));
+  const user = author(page.item) ?? username(pageUrl) ?? "i";
+  const headers = {
+    referer: `https://www.tiktok.com/@${encodeURIComponent(user)}/video/${encodeURIComponent(id)}`,
+    "user-agent": page.userAgent
+  };
+  if (page.cookie) {
+    headers.cookie = page.cookie;
   }
-  const parent = object(tweet.parent) ? tweet.parent : null;
-  const parentId = parent ? string(parent.id_str) : null;
-  const replyToId = string(tweet.in_reply_to_status_id_str) ?? parentId;
-  if (replyToId)
-    extra.replyToId = replyToId;
-  if (parent && parentId) {
-    extra.parentTweet = { id: parentId, metadata: twitterMetadata(parent) };
+  const items = mediaItems4(page.item, user, id, headers);
+  if (items.length === 0) {
+    throw new Error("TikTok media not found");
+  }
+  return { archiveFilename: filename(`tiktok_${user}_${id}.zip`), comments: [], id, items, metadata: tiktokMetadata(page.item), platform: "tiktok" };
+}
+async function videoPage(net, id, photo) {
+  for (let attempt = 0;attempt < pageAttemptCount; attempt += 1) {
+    const baseHeaders2 = attempt % 2 === 0 ? navigationHeaders() : firefoxNavigationHeaders();
+    const userAgent2 = baseHeaders2["user-agent"];
+    const headers2 = {
+      ...baseHeaders2,
+      referer: "https://www.tiktok.com/",
+      "sec-fetch-site": "same-origin"
+    };
+    try {
+      return { ...await fetchVideoPage(net, id, headers2), userAgent: userAgent2 };
+    } catch (error) {
+      if (!recoverablePageError(error)) {
+        throw error;
+      }
+    }
+  }
+  if (!photo) {
+    throw new Error("TikTok hydration not found");
   }
+  const baseHeaders = navigationHeaders();
+  const userAgent = baseHeaders["user-agent"];
+  const headers = {
+    ...baseHeaders,
+    referer: "https://www.tiktok.com/",
+    "sec-fetch-site": "same-origin"
+  };
+  return { ...await fetchEmbedPage(net, id, headers), userAgent };
+}
+function tiktokMetadata(item) {
+  const user = object(item.author) ? item.author : null;
+  const stats = object(item.stats) ? item.stats : null;
+  const music = object(item.music) ? item.music : null;
+  const video = object(item.video) ? item.video : null;
   return {
-    text: cleanTwitterText(twitterText(tweet), tweet) ?? undefined,
+    text: string(item.desc) ?? undefined,
     author: user ? {
-      handle: string(user.screen_name) ?? undefined,
-      name: string(user.name) ?? undefined,
-      verified: bool(user.verified) ?? bool(user.is_blue_verified)
+      handle: string(user.uniqueId) ?? undefined,
+      name: string(user.nickname) ?? undefined,
+      verified: bool(user.verified)
     } : undefined,
-    createdAt: isoFromDateString(tweet.created_at),
-    likeCount: count(tweet.favorite_count),
-    commentCount: count(tweet.conversation_count),
-    shareCount: count(tweet.retweet_count),
-    viewCount: count(tweet.view_count),
-    nsfw: bool(tweet.possibly_sensitive),
-    extra
+    createdAt: isoFromEpochSeconds(item.createTime),
+    likeCount: stats ? count(stats.diggCount) : undefined,
+    commentCount: stats ? count(stats.commentCount) : undefined,
+    shareCount: stats ? count(stats.shareCount) : undefined,
+    viewCount: stats ? count(stats.playCount) : undefined,
+    extra: {
+      saveCount: stats ? count(stats.collectCount) : undefined,
+      musicTitle: music ? string(music.title) ?? undefined : undefined,
+      musicAuthor: music ? string(music.authorName) ?? undefined : undefined,
+      region: string(item.locationCreated) ?? undefined,
+      durationSeconds: video ? count(video.duration) : undefined
+    }
   };
 }
-function noteText(tweet) {
-  const note = object(tweet.note_tweet) ? tweet.note_tweet : null;
-  const results = note && object(note.note_tweet_results) ? note.note_tweet_results : null;
-  const result = results && object(results.result) ? results.result : null;
-  return (result ? string(result.text) : null) ?? (note ? string(note.text) : null);
+async function fetchVideoPage(net, id, headers) {
+  const page = await net(`https://www.tiktok.com/@i/video/${id}`, {
+    headers
+  });
+  return { cookie: cookieHeader(page.headers), item: itemStruct(await page.text()) };
 }
-function twitterText(tweet) {
-  return noteText(tweet) ?? string(tweet.full_text) ?? string(tweet.text);
+async function fetchEmbedPage(net, id, headers) {
+  const page = await net(`https://www.tiktok.com/embed/v2/${id}`, {
+    headers
+  });
+  return { cookie: cookieHeader(page.headers), item: embedItemStruct(await page.text(), id) };
 }
-function cleanTwitterText(text, tweet) {
-  if (text === null)
-    return null;
-  const entities = object(tweet.entities) ? tweet.entities : null;
-  const media = [
-    ...entities && Array.isArray(entities.media) ? entities.media : [],
-    ...Array.isArray(tweet.mediaDetails) ? tweet.mediaDetails : []
-  ];
-  const urls = new Set(media.filter(object).map((entry) => string(entry.url)).filter(Boolean));
-  while (true) {
-    const trailing = text.match(/(?:^|\s)(https?:\/\/\S+)\s*$/);
-    if (!trailing || !urls.has(trailing[1]))
-      break;
-    text = text.slice(0, trailing.index).trimEnd();
-  }
-  return text.replace(/&(?:amp|gt|lt);/g, (entity) => entity === "&amp;" ? "&" : entity === "&gt;" ? ">" : "<");
+function isShortlinkHost(hostname) {
+  return hostname === "vm.tiktok.com" || hostname === "vt.tiktok.com";
 }
-function needsFullText(tweet) {
-  if (noteText(tweet) || string(tweet.full_text)) {
-    return false;
+async function followShortlink(net, userAgent, input) {
+  const url = asUrl(input);
+  if (!isShortlinkHost(url.hostname)) {
+    return input;
   }
-  return object(tweet.note_tweet) || bool(tweet.truncated) === true || (string(tweet.text)?.length ?? 0) >= 270;
-}
-async function expandTwitterText(net, tweet, rootId) {
-  const posts = new Map(twitterTweets(tweet, rootId, true).map(({ id, tweet: post }) => [id, post]));
-  for (const [id, post] of posts) {
-    if (!needsFullText(post)) {
-      continue;
-    }
-    try {
-      const response = await net(`https://api.fxtwitter.com/status/${id}`, {
-        headers: { accept: "application/json", "user-agent": browserUserAgent() }
-      }, 1);
-      if (!response.ok) {
-        continue;
-      }
-      const payload = await response.json();
-      if (!object(payload) || payload.code !== 200 || !object(payload.tweet) || string(payload.tweet.id) !== id) {
-        continue;
-      }
-      let current = payload.tweet;
-      const seen = new Set;
-      while (current) {
-        const currentId = string(current.id);
-        if (!currentId || seen.has(currentId)) {
-          break;
-        }
-        seen.add(currentId);
-        const target = posts.get(currentId);
-        const raw = object(current.raw_text) ? string(current.raw_text.text) : null;
-        const text = raw ?? string(current.text);
-        if (target && needsFullText(target) && text && text.length > (twitterText(target)?.length ?? 0)) {
-          target.full_text = text;
-        }
-        current = object(current.quote) ? current.quote : null;
-      }
-    } catch {}
+  const response = await net(input, { headers: { "user-agent": userAgent }, redirect: "manual" }, 1);
+  const location = response.headers.get("location");
+  if (location) {
+    return new URL(location, input).href;
   }
+  const html = await response.text();
+  const href = html.match(/<a href="(https:\/\/[^"]+)"/)?.[1];
+  return href ? new URL(href.split("?")[0]).href : input;
 }
-function twitterTweets(tweet, rootId, includeParents = false) {
-  const tweets = [];
-  const seen = new Set;
-  const visit = (current, fallbackId) => {
-    const id = string(current.id_str) ?? fallbackId;
-    if (!id || seen.has(id))
-      return;
-    seen.add(id);
-    tweets.push({ id, tweet: current });
-    if (object(current.quoted_tweet))
-      visit(current.quoted_tweet);
-    if (includeParents && object(current.parent))
-      visit(current.parent);
-  };
-  visit(tweet, rootId);
-  return tweets;
+function videoId(input) {
+  return asUrl(input).pathname.match(/(?:video|photo)\/(\d+)/)?.[1] ?? null;
 }
-async function syndication(net, id) {
-  const url = `https://cdn.syndication.twimg.com/tweet-result?id=${id}&lang=en&token=${syndicationToken(id)}`;
-  const response = await net(url, { headers: { accept: "application/json", "user-agent": browserUserAgent() } });
-  if (!response.ok) {
-    throw new Error(`Twitter syndication failed: ${response.status}`);
+function itemStruct(html) {
+  if (html.includes("SlardarWAF") || html.includes("_wafchallengeid")) {
+    throw new Error("TikTok WAF challenge");
   }
-  const payload = await response.json();
-  if (!object(payload)) {
-    throw new Error("Twitter response invalid");
+  const start = html.indexOf(marker);
+  const end = start === -1 ? -1 : html.indexOf("</script>", start + marker.length);
+  if (start === -1 || end === -1) {
+    throw new Error("TikTok hydration not found");
   }
-  return payload;
-}
-function syndicationToken(id) {
-  return (Number(id) / 1000000000000000 * Math.PI).toString(36).replace(/(0+|\.)/g, "");
-}
-function twitterCandidates(entry, id, index) {
-  const headers = { "user-agent": browserUserAgent() };
-  const type = string(entry.type);
-  if (type === "video" || type === "animated_gif") {
-    return videoVariants(entry).map(({ bitrate, url }) => ({
-      bitrate,
-      item: { filename: filename(`twitter_${id}_${index}.mp4`), headers, id, kind: "video", mime: "video/mp4", platform: "twitter", url }
-    }));
+  const parsed = JSON.parse(html.slice(start + marker.length, end));
+  const scope = object(parsed) && object(parsed.__DEFAULT_SCOPE__) ? parsed.__DEFAULT_SCOPE__ : null;
+  const detail = scope && object(scope["webapp.video-detail"]) ? scope["webapp.video-detail"] : null;
+  const info = detail && object(detail.itemInfo) ? detail.itemInfo : null;
+  const item = info && object(info.itemStruct) ? info.itemStruct : null;
+  if (!item) {
+    throw new Error("TikTok itemStruct not found");
   }
-  const photo = string(entry.media_url_https);
-  return photo ? [{ bitrate: 0, item: { filename: filename(`twitter_${id}_${index}.jpg`), headers, id, kind: "image", mime: "image/jpeg", platform: "twitter", url: `${photo}?name=orig` } }] : [];
+  return item;
 }
-function videoVariants(entry) {
-  const info = object(entry.video_info) ? entry.video_info : null;
-  const variants = info && Array.isArray(info.variants) ? info.variants.filter(object) : [];
-  const seen = new Set;
-  return variants.flatMap((variant) => {
-    const url = string(variant.url);
-    if (string(variant.content_type) !== "video/mp4" || !url || seen.has(url)) {
-      return [];
-    }
-    seen.add(url);
-    return [{ bitrate: number(variant.bitrate) ?? 0, url }];
-  }).sort((left, right) => right.bitrate - left.bitrate);
-}
-async function sizeLimitedItems(input, groups) {
-  if (groups.length === 0 || input.tryMaxBytes === undefined) {
-    return groups.map((group) => group[0].item);
+function embedItemStruct(html, id) {
+  const raw = html.match(/<script\b[^>]*\bid=["']__FRONTITY_CONNECT_STATE__["'][^>]*>([\s\S]*?)<\/script>/i)?.[1];
+  if (!raw) {
+    throw new Error("TikTok embed state not found");
   }
-  const sizes = new Map;
-  const size = (candidate) => {
-    const existing = sizes.get(candidate.item.url);
-    if (existing) {
-      return existing;
+  const parsed = JSON.parse(raw);
+  const source2 = object(parsed) && object(parsed.source) ? parsed.source : null;
+  const data = source2 && object(source2.data) ? source2.data : null;
+  const rawRoute = data ? data[`/embed/v2/${id}`] : null;
+  const route = object(rawRoute) ? rawRoute : null;
+  const videoData = route && object(route.videoData) ? route.videoData : null;
+  const item = videoData && object(videoData.itemInfos) ? videoData.itemInfos : null;
+  if (!videoData || !item) {
+    throw new Error("TikTok embed item not found");
+  }
+  const authorInfo = object(videoData.authorInfos) ? videoData.authorInfos : {};
+  const musicInfo = object(videoData.musicInfos) ? videoData.musicInfos : {};
+  const video = object(item.video) ? item.video : {};
+  const videoMeta = object(video.videoMeta) ? video.videoMeta : {};
+  const imagePost = object(videoData.imagePostInfo) ? videoData.imagePostInfo : null;
+  const displayImages = imagePost && Array.isArray(imagePost.displayImages) ? imagePost.displayImages.filter(object) : [];
+  if (displayImages.length === 0) {
+    throw new Error("TikTok video hydration not found");
+  }
+  return {
+    ...item,
+    author: {
+      nickname: string(authorInfo.nickName),
+      uniqueId: string(authorInfo.uniqueId),
+      verified: bool(authorInfo.verified)
+    },
+    desc: string(item.text),
+    imagePost: {
+      images: displayImages.map((image) => ({
+        imageURL: {
+          urlList: Array.isArray(image.urlList) ? image.urlList.map(string).filter((url) => Boolean(url)) : []
+        }
+      }))
+    },
+    music: {
+      authorName: string(musicInfo.authorName),
+      playUrl: firstString(musicInfo.playUrl),
+      title: string(musicInfo.musicName)
+    },
+    stats: {
+      commentCount: item.commentCount,
+      diggCount: item.diggCount,
+      playCount: item.playCount,
+      shareCount: item.shareCount
+    },
+    video: {
+      duration: videoMeta.duration
     }
-    const pending = contentLength(input.net, candidate.item);
-    sizes.set(candidate.item.url, pending);
-    return pending;
   };
-  const highest = groups.map((group) => group[0]);
-  const highestSizes = await Promise.all(highest.map(size));
-  const highestTotal = knownTotal(highestSizes);
-  if (highestTotal !== null && highestTotal <= input.tryMaxBytes) {
-    return highest.map(({ item }) => item);
-  }
-  const sized = await Promise.all(groups.map(async (group) => Promise.all(group.map(async (candidate) => ({ ...candidate, bytes: await size(candidate) })))));
-  const fitting = bestFitting(sized, input.tryMaxBytes);
-  return (fitting ?? groups.map((group) => group.at(-1))).map(({ item }) => item);
-}
-function knownTotal(sizes) {
-  return sizes.some((size) => size === null) ? null : sizes.reduce((total, size) => total + (size ?? 0), 0);
 }
-function bestFitting(groups, maxBytes) {
-  let selections = [
-    { bytes: 0, candidates: [], quality: 0 }
-  ];
-  for (const group of groups) {
-    selections = selections.flatMap((selection) => group.flatMap((candidate) => {
-      if (candidate.bytes === null || selection.bytes + candidate.bytes > maxBytes) {
-        return [];
-      }
-      return [{
-        bytes: selection.bytes + candidate.bytes,
-        candidates: [...selection.candidates, candidate],
-        quality: selection.quality + candidate.bitrate
-      }];
-    }));
-    if (selections.length === 0) {
-      return null;
-    }
-  }
-  const best = selections.reduce((current, selection) => selection.quality > current.quality ? selection : current);
-  return best.candidates;
+function recoverablePageError(error) {
+  const message = error instanceof Error ? error.message : "";
+  return message === "TikTok WAF challenge" || message === "TikTok hydration not found";
 }
-async function contentLength(net, item) {
-  try {
-    const response = await net(item.url, { headers: item.headers, method: "HEAD" }, 1);
-    const raw = response.ok ? response.headers.get("content-length") : null;
-    if (!raw || !/^\d+$/.test(raw)) {
-      return null;
-    }
-    const bytes = Number(raw);
-    return Number.isSafeInteger(bytes) ? bytes : null;
-  } catch {
-    return null;
-  }
+function firstString(value) {
+  return Array.isArray(value) ? value.map(string).find((candidate) => candidate !== null) ?? null : string(value);
 }
-function tweetId(input) {
-  return asUrl(input).pathname.match(/\/status(?:es)?\/(\d+)/)?.[1] ?? null;
+function downloadUrl(item) {
+  const video = object(item.video) ? item.video : null;
+  return video ? string(video.playAddr) ?? string(video.downloadAddr) : null;
 }
-async function twitterComments(input, id) {
-  const limit = input.comments;
-  if (!limit || !Number.isSafeInteger(limit) || limit < 0)
-    return [];
-  try {
-    const comments = [];
-    const seen = new Set;
-    const cursors = new Set;
-    let cursor = null;
-    do {
-      const url = new URL(`https://api.fxtwitter.com/2/conversation/${id}`);
-      if (cursor)
-        url.searchParams.set("cursor", cursor);
-      const response = await input.net(url.href, { headers: { accept: "application/json", "user-agent": browserUserAgent() } }, 1);
-      if (!response.ok)
-        throw new Error("Comment lookup failed");
-      const payload = await response.json();
-      if (!object(payload) || payload.code !== 200 || !Array.isArray(payload.replies))
-        throw new Error("Invalid comments");
-      const previousCount = comments.length;
-      for (const reply of payload.replies) {
-        if (!object(reply))
-          continue;
-        const replyId = string(reply.id);
-        const parent = object(reply.replying_to) ? string(reply.replying_to.status) : null;
-        if (!replyId || parent !== id || seen.has(replyId))
-          continue;
-        seen.add(replyId);
-        comments.push(twitterComment(reply, replyId));
-        if (comments.length >= limit)
-          return comments;
-      }
-      cursor = object(payload.cursor) ? string(payload.cursor.bottom) : null;
-      if (!cursor || cursors.has(cursor) || comments.length === previousCount)
-        break;
-      cursors.add(cursor);
-    } while (comments.length < limit);
-    return comments;
-  } catch {
-    return [];
+function mediaItems4(item, user, id, headers) {
+  const images = imageItems3(item, user, id, headers);
+  if (images.length > 0) {
+    const audio = audioItem2(item, user, id, headers);
+    return audio ? [...images, audio] : images;
   }
+  const url = downloadUrl(item);
+  return url ? [{
+    filename: filename(`tiktok_${user}_${id}.mp4`),
+    headers,
+    id,
+    kind: "video",
+    mime: "video/mp4",
+    platform: "tiktok",
+    url
+  }] : [];
 }
-function twitterComment(reply, id) {
-  const author2 = object(reply.author) ? reply.author : {};
-  const verification = object(author2.verification) ? author2.verification : {};
-  const media = object(reply.media) && Array.isArray(reply.media.all) ? reply.media.all.filter(object) : [];
-  const items = media.flatMap((entry, index) => {
-    const url = string(entry.url);
-    const photo = entry.type === "photo";
-    if (!url || !photo && entry.type !== "video" && entry.type !== "gif" && entry.type !== "animated_gif")
-      return [];
-    return [{
+function imageItems3(item, user, id, headers) {
+  const imagePost = object(item.imagePost) ? item.imagePost : null;
+  const images = imagePost && Array.isArray(imagePost.images) ? imagePost.images.filter(object) : [];
+  return images.flatMap((image, index) => {
+    const imageUrl2 = object(image.imageURL) ? image.imageURL : null;
+    const list = imageUrl2 && Array.isArray(imageUrl2.urlList) ? imageUrl2.urlList : [];
+    const url = list.map(string).find((candidate) => Boolean(candidate)) ?? null;
+    return url ? [{
+      filename: filename(`tiktok_${user}_${id}_${index + 1}.jpg`),
+      headers,
       id,
-      platform: "twitter",
-      filename: filename(`twitter_${id}_${index + 1}.${photo ? "jpg" : "mp4"}`),
-      kind: photo ? "image" : "video",
-      mime: photo ? "image/jpeg" : "video/mp4",
-      url,
-      headers: { "user-agent": browserUserAgent() }
-    }];
+      kind: "image",
+      mime: "image/jpeg",
+      platform: "tiktok",
+      url
+    }] : [];
   });
-  return {
-    id,
-    url: `https://x.com/i/status/${id}`,
-    items,
-    metadata: {
-      text: cleanTwitterText(string(reply.text), reply) ?? undefined,
-      author: {
-        handle: string(author2.screen_name) ?? undefined,
-        name: string(author2.name) ?? undefined,
-        verified: bool(verification.verified)
-      },
-      createdAt: isoFromDateString(reply.created_at),
-      likeCount: count(reply.likes),
-      commentCount: count(reply.replies),
-      shareCount: count(reply.reposts),
-      viewCount: count(reply.views),
-      nsfw: bool(reply.possibly_sensitive)
-    }
-  };
 }
-
-// src/youtube.ts
-var androidVrClient = {
-  name: "ANDROID_VR",
-  number: "28",
-  userAgent: "com.google.android.apps.youtube.vr.oculus/1.65.10 (Linux; U; Android 12L; eureka-user Build/SQ3A.220605.009.A1) gzip",
-  version: "1.65.10"
-};
-var visionOsClient = {
-  clientName: "VISIONOS",
-  clientVersion: "1.02",
-  deviceMake: "Apple",
-  deviceModel: "RealityDevice17,1",
-  userAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_7_3) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/26.0 Safari/605.1.15",
-  osName: "visionOS",
-  osVersion: "26.5.23O471"
-};
-var browserCookie = "PREF=hl=en&tz=UTC; SOCS=CAI";
-async function resolveYoutube(input) {
-  const id = youtubeVideoId(input.url);
-  if (!id) {
-    throw new Error("YouTube video id not found");
-  }
-  let session;
-  try {
-    session = await youtubeSession(input.net, id);
-    const payload = await youtubePlayer(input.net, playerBody(id, session), playerHeaders(session));
-    const streams = selectStreams(payload, input.preferredWidth);
-    if (!streams) {
-      throw new Error("YouTube mp4 stream not found");
-    }
-    const headers = { "user-agent": androidVrClient.userAgent };
-    await Promise.all([streams.video, streams.audio].filter((url) => url !== null).map((url) => probeStream(input.net, url, headers)));
-    return youtubeResult(id, payload, streams, headers);
-  } catch (primaryError) {
-    try {
-      return await resolveVisionOs(input, id, session?.visitorData);
-    } catch (fallbackError) {
-      const message = (error) => error instanceof Error ? error.message : String(error);
-      throw new Error(`YouTube resolution failed: ${message(primaryError)}; visionOS HLS: ${message(fallbackError)}`, { cause: fallbackError });
-    }
-  }
-}
-async function youtubePlayer(net, body, headers) {
-  const response = await net("https://www.youtube.com/youtubei/v1/player?prettyPrint=false", {
-    body: JSON.stringify(body),
-    headers,
-    method: "POST"
-  });
-  if (!response.ok) {
-    throw new Error(`YouTube player failed: ${response.status}`);
-  }
-  const payload = await response.json();
-  const status = object(payload) && object(payload.playabilityStatus) ? string(payload.playabilityStatus.status) : null;
-  if (status !== "OK") {
-    const reason = object(payload) && object(payload.playabilityStatus) ? string(payload.playabilityStatus.reason) : null;
-    throw new Error(reason ?? "YouTube video unavailable");
+function audioItem2(item, user, id, headers) {
+  const video = object(item.video) ? item.video : null;
+  const music = object(item.music) ? item.music : null;
+  const url = video ? string(video.playAddr) : null;
+  const fallback = music ? string(music.playUrl) : null;
+  const selected = url ?? fallback;
+  if (!selected) {
+    return null;
   }
-  return payload;
-}
-function youtubeResult(id, payload, streams, headers) {
-  const title = object(payload) && object(payload.videoDetails) ? string(payload.videoDetails.title) : null;
-  const media = {
-    filename: filename(`youtube_${title ?? id}_${id}.mp4`),
+  const extension = selected.includes("mime_type=audio_mpeg") ? "mp3" : "m4a";
+  return {
+    filename: filename(`tiktok_${user}_${id}_audio.${extension}`),
     headers,
     id,
-    kind: "video",
-    mime: "video/mp4",
-    platform: "youtube",
-    url: streams.video,
-    ...streams.hls ? { hls: true } : {},
-    ...streams.audio ? { audio: { headers, url: streams.audio } } : {}
+    kind: "audio",
+    mime: extension === "mp3" ? "audio/mpeg" : "audio/mp4",
+    platform: "tiktok",
+    url: selected
   };
-  return { archiveFilename: filename(`youtube_${id}.zip`), comments: [], id, items: [media], metadata: youtubeMetadata(payload), platform: "youtube" };
 }
-async function probeStream(net, url, headers) {
-  const response = await net(url, { headers }, 1);
-  await response.body?.cancel();
-  if (!response.ok) {
-    throw new Error(`YouTube stream failed: ${response.status}`);
-  }
+function author(item) {
+  const user = object(item.author) ? item.author : null;
+  return user ? string(user.uniqueId) : null;
 }
-async function resolveVisionOs(input, id, visitorData) {
-  const headers = { "user-agent": visionOsClient.userAgent };
-  const payload = await youtubePlayer(input.net, {
-    videoId: id,
-    contentCheckOk: true,
-    racyCheckOk: true,
-    context: { client: { ...visionOsClient, hl: "en", gl: "US", ...visitorData ? { visitorData } : {} } }
-  }, {
-    ...headers,
-    "content-type": "application/json",
-    "x-youtube-client-name": "101",
-    "x-youtube-client-version": visionOsClient.clientVersion,
-    ...visitorData ? { "x-goog-visitor-id": visitorData } : {}
-  });
-  const streaming = object(payload) && object(payload.streamingData) ? payload.streamingData : null;
-  const manifestUrl = streaming ? string(streaming.hlsManifestUrl) : null;
-  if (!manifestUrl) {
-    throw new Error("YouTube HLS manifest not found");
+function username(input) {
+  return asUrl(input).pathname.match(/@([^/]+)/)?.[1] ?? null;
+}
+function cookieHeader(headers) {
+  const getter = headers.getSetCookie;
+  const setCookie = typeof getter === "function" ? getter.call(headers).join(",") : headers.get("set-cookie");
+  const cookies = setCookie?.split(/,(?=[^;]+?=)/).map((part) => part.split(";")[0]?.trim()).filter((part) => Boolean(part));
+  return cookies && cookies.length > 0 ? cookies.join("; ") : null;
+}
+
+// src/twitter.ts
+async function resolveTwitter(input) {
+  const id = tweetId(input.url);
+  if (!id) {
+    throw new Error("Tweet id not found");
   }
-  const response = await input.net(manifestUrl, { headers });
-  if (!response.ok) {
-    throw new Error(`YouTube HLS manifest failed: ${response.status}`);
+  const tweet = await syndication(input.net, id);
+  if (string(tweet.__typename) === "TweetTombstone") {
+    throw new Error("Tweet is unavailable or age-restricted");
   }
-  const master = parseMaster(await response.text(), manifestUrl, { preferOriginalAudio: true });
-  const variants = master.variants.filter((variant2) => /(?:^|,)(?:vp09|av01)\./i.test(variant2.codecs ?? "") && /(?:^|,)mp4a\.40\.2(?:,|$)/i.test(variant2.codecs ?? "") && variant2.audioGroup && master.audio[variant2.audioGroup]).sort((left, right) => Math.abs(left.width - input.preferredWidth) - Math.abs(right.width - input.preferredWidth) || right.bandwidth - left.bandwidth);
-  const variant = variants[0];
-  if (!variant?.audioGroup) {
-    throw new Error("YouTube fragmented MP4 HLS video with AAC audio not found");
+  await expandTwitterText(input.net, tweet, id);
+  const posts = twitterTweets(tweet, id);
+  const groups = posts.flatMap(({ id: postId2, tweet: post }) => {
+    const media = Array.isArray(post.mediaDetails) ? post.mediaDetails.filter(object) : [];
+    return media.flatMap((entry, index) => {
+      const candidates = twitterCandidates(entry, postId2, index + 1);
+      return candidates.length > 0 ? [candidates] : [];
+    });
+  });
+  for (const { id: postId2, tweet: post } of posts.toReversed()) {
+    const card = twitterCardImage(post, postId2);
+    if (card)
+      groups.push([{ bitrate: 0, item: card }]);
   }
-  const playlist = await input.net(variant.url, { headers });
-  if (!playlist.ok) {
-    throw new Error(`YouTube HLS playlist failed: ${playlist.status}`);
+  const items = input.tryMaxBytes === undefined ? groups.map((group) => group[0].item) : await sizeLimitedItems(input, groups);
+  return { archiveFilename: filename(`twitter_${id}.zip`), comments: await twitterComments(input, id), id, items, metadata: twitterMetadata(tweet), platform: "twitter" };
+}
+function twitterMetadata(tweet) {
+  const user = object(tweet.user) ? tweet.user : null;
+  const extra = {};
+  const lang = string(tweet.lang);
+  if (lang) {
+    extra.lang = lang;
   }
-  if (!(await playlist.text()).includes("#EXT-X-MAP:")) {
-    throw new Error("YouTube HLS video is not fragmented MP4");
+  const quotedTweet = object(tweet.quoted_tweet) ? tweet.quoted_tweet : null;
+  const quotedId = quotedTweet ? string(quotedTweet.id_str) : null;
+  if (quotedTweet && quotedId) {
+    extra.quotedTweet = { id: quotedId, metadata: twitterMetadata(quotedTweet) };
+  }
+  const parent = object(tweet.parent) ? tweet.parent : null;
+  const parentId = parent ? string(parent.id_str) : null;
+  const replyToId = string(tweet.in_reply_to_status_id_str) ?? parentId;
+  if (replyToId)
+    extra.replyToId = replyToId;
+  if (parent && parentId) {
+    extra.parentTweet = { id: parentId, metadata: twitterMetadata(parent) };
   }
-  return youtubeResult(id, payload, { video: variant.url, audio: master.audio[variant.audioGroup], hls: true }, headers);
-}
-function youtubeMetadata(payload) {
-  const details = object(payload) && object(payload.videoDetails) ? payload.videoDetails : null;
-  const renderer = object(payload) && object(payload.microformat) && object(payload.microformat.playerMicroformatRenderer) ? payload.microformat.playerMicroformatRenderer : null;
-  const author2 = details ? string(details.author) : null;
-  const keywords = details && Array.isArray(details.keywords) ? details.keywords.filter((keyword) => typeof keyword === "string") : [];
   return {
-    title: details ? string(details.title) ?? undefined : undefined,
-    text: details ? string(details.shortDescription) ?? undefined : undefined,
-    author: author2 ? { name: author2 } : undefined,
-    createdAt: renderer ? isoFromDateString(renderer.publishDate) : undefined,
-    viewCount: details ? count(details.viewCount) : undefined,
-    extra: {
-      channelId: details ? string(details.channelId) ?? undefined : undefined,
-      durationSeconds: details ? count(details.lengthSeconds) : undefined,
-      keywords: keywords.length > 0 ? keywords : undefined
-    }
+    text: cleanTwitterText(twitterText(tweet), tweet) ?? undefined,
+    author: user ? {
+      handle: string(user.screen_name) ?? undefined,
+      name: string(user.name) ?? undefined,
+      verified: bool(user.verified) ?? bool(user.is_blue_verified)
+    } : undefined,
+    createdAt: isoFromDateString(tweet.created_at),
+    likeCount: count(tweet.favorite_count),
+    commentCount: count(tweet.conversation_count),
+    shareCount: count(tweet.retweet_count),
+    viewCount: count(tweet.view_count),
+    nsfw: bool(tweet.possibly_sensitive),
+    extra
   };
 }
-function selectStreams(payload, preferredWidth) {
-  const adaptive = adaptiveFormats(payload);
-  const video = bestVideo(adaptive, preferredWidth);
-  const audio = bestAudio(adaptive);
-  if (video && audio) {
-    return { video, audio };
-  }
-  const progressive = selectFormat(payload);
-  return progressive ? { video: progressive, audio: null } : null;
-}
-function adaptiveFormats(payload) {
-  const root = object(payload) ? payload : null;
-  const streaming = root && object(root.streamingData) ? root.streamingData : null;
-  return streaming && Array.isArray(streaming.adaptiveFormats) ? streaming.adaptiveFormats.filter(object) : [];
+function noteText(tweet) {
+  const note = object(tweet.note_tweet) ? tweet.note_tweet : null;
+  const results = note && object(note.note_tweet_results) ? note.note_tweet_results : null;
+  const result = results && object(results.result) ? results.result : null;
+  return (result ? string(result.text) : null) ?? (note ? string(note.text) : null);
 }
-function bestVideo(formats, preferredWidth) {
-  const candidates = formats.filter((format) => {
-    const mimeType2 = string(format.mimeType);
-    return Boolean(string(format.url)) && mimeType2?.startsWith("video/mp4") === true && mimeType2.includes("avc1");
-  });
-  const best = candidates.reduce((current, format) => {
-    if (!current) {
-      return format;
-    }
-    const width = number(format.width) ?? 0;
-    const currentWidth = number(current.width) ?? 0;
-    return Math.abs(width - preferredWidth) < Math.abs(currentWidth - preferredWidth) ? format : current;
-  }, null);
-  return best ? string(best.url) : null;
+function twitterText(tweet) {
+  return noteText(tweet) ?? string(tweet.full_text) ?? string(tweet.text);
 }
-function bestAudio(formats) {
-  const candidates = formats.filter((format) => Boolean(string(format.url)) && string(format.mimeType)?.startsWith("audio/mp4") === true);
-  const best = candidates.reduce((current, format) => {
-    if (!current) {
-      return format;
-    }
-    const preference = audioPreference(format) - audioPreference(current);
-    if (preference !== 0) {
-      return preference > 0 ? format : current;
-    }
-    return (number(format.bitrate) ?? 0) > (number(current.bitrate) ?? 0) ? format : current;
-  }, null);
-  return best ? string(best.url) : null;
+function cleanTwitterText(text2, tweet) {
+  if (text2 === null)
+    return null;
+  const entities = object(tweet.entities) ? tweet.entities : null;
+  const media = [
+    ...entities && Array.isArray(entities.media) ? entities.media : [],
+    ...Array.isArray(tweet.mediaDetails) ? tweet.mediaDetails : []
+  ];
+  const urls = new Set(media.filter(object).map((entry) => string(entry.url)).filter(Boolean));
+  while (true) {
+    const trailing = text2.match(/(?:^|\s)(https?:\/\/\S+)\s*$/);
+    if (!trailing || !urls.has(trailing[1]))
+      break;
+    text2 = text2.slice(0, trailing.index).trimEnd();
+  }
+  return text2.replace(/&(?:amp|gt|lt);/g, (entity) => entity === "&amp;" ? "&" : entity === "&gt;" ? ">" : "<");
 }
-function audioPreference(format) {
-  const track = object(format.audioTrack) ? format.audioTrack : null;
-  if (track && /\boriginal\b/i.test(string(track.displayName) ?? "")) {
-    return 2;
+function needsFullText(tweet) {
+  if (noteText(tweet) || string(tweet.full_text)) {
+    return false;
   }
-  return track?.audioIsDefault === true ? 1 : 0;
+  return object(tweet.note_tweet) || bool(tweet.truncated) === true || (string(tweet.text)?.length ?? 0) >= 270;
 }
-function playerBody(id, session) {
-  return {
-    contentCheckOk: true,
-    context: {
-      client: {
-        androidSdkVersion: 32,
-        clientName: androidVrClient.name,
-        clientVersion: androidVrClient.version,
-        deviceMake: "Oculus",
-        deviceModel: "Quest 3",
-        gl: "US",
-        hl: "en",
-        osName: "Android",
-        osVersion: "12L",
-        timeZone: "UTC",
-        userAgent: androidVrClient.userAgent,
-        utcOffsetMinutes: 0,
-        visitorData: session.visitorData
+async function expandTwitterText(net, tweet, rootId) {
+  const posts = new Map(twitterTweets(tweet, rootId, true).map(({ id, tweet: post }) => [id, post]));
+  for (const [id, post] of posts) {
+    if (!needsFullText(post)) {
+      continue;
+    }
+    try {
+      const response = await net(`https://api.fxtwitter.com/status/${id}`, {
+        headers: { accept: "application/json", "user-agent": browserUserAgent() }
+      }, 1);
+      if (!response.ok) {
+        continue;
       }
-    },
-    playbackContext: {
-      contentPlaybackContext: {
-        html5Preference: "HTML5_PREF_WANTS",
-        signatureTimestamp: session.signatureTimestamp
+      const payload = await response.json();
+      if (!object(payload) || payload.code !== 200 || !object(payload.tweet) || string(payload.tweet.id) !== id) {
+        continue;
       }
-    },
-    racyCheckOk: true,
-    videoId: id
+      let current = payload.tweet;
+      const seen = new Set;
+      while (current) {
+        const currentId = string(current.id);
+        if (!currentId || seen.has(currentId)) {
+          break;
+        }
+        seen.add(currentId);
+        const target = posts.get(currentId);
+        const raw = object(current.raw_text) ? string(current.raw_text.text) : null;
+        const text2 = raw ?? string(current.text);
+        if (target && needsFullText(target) && text2 && text2.length > (twitterText(target)?.length ?? 0)) {
+          target.full_text = text2;
+        }
+        current = object(current.quote) ? current.quote : null;
+      }
+    } catch {}
+  }
+}
+function twitterTweets(tweet, rootId, includeParents = false) {
+  const tweets = [];
+  const seen = new Set;
+  const visit = (current, fallbackId) => {
+    const id = string(current.id_str) ?? fallbackId;
+    if (!id || seen.has(id))
+      return;
+    seen.add(id);
+    tweets.push({ id, tweet: current });
+    if (object(current.quoted_tweet))
+      visit(current.quoted_tweet);
+    if (includeParents && object(current.parent))
+      visit(current.parent);
   };
+  visit(tweet, rootId);
+  return tweets;
 }
-async function youtubeSession(net, id) {
-  const response = await net(`https://www.youtube.com/watch?v=${id}&bpctr=9999999999&has_verified=1`, {
-    headers: {
-      accept: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
-      "accept-language": "en-us,en;q=0.5",
-      cookie: browserCookie,
-      "sec-fetch-mode": "navigate",
-      "user-agent": browserUserAgent()
-    }
-  });
+async function syndication(net, id) {
+  const url = `https://cdn.syndication.twimg.com/tweet-result?id=${id}&lang=en&token=${syndicationToken(id)}`;
+  const response = await net(url, { headers: { accept: "application/json", "user-agent": browserUserAgent() } });
   if (!response.ok) {
-    throw new Error(`YouTube page failed: ${response.status}`);
+    throw new Error(`Twitter syndication failed: ${response.status}`);
   }
-  const page = await response.text();
-  const visitorData = string(page.match(/"visitorData":"([^"]+)"/)?.[1]);
-  if (!visitorData) {
-    throw new Error("YouTube visitor data not found");
+  const payload = await response.json();
+  if (!object(payload)) {
+    throw new Error("Twitter response invalid");
   }
-  const playerPath = string(page.match(/"jsUrl":"([^"]+)"/)?.[1]) ?? string(page.match(/"PLAYER_JS_URL":"([^"]+)"/)?.[1]);
-  if (!playerPath) {
-    throw new Error("YouTube player url not found");
+  return payload;
+}
+function syndicationToken(id) {
+  return (Number(id) / 1000000000000000 * Math.PI).toString(36).replace(/(0+|\.)/g, "");
+}
+function twitterCandidates(entry, id, index) {
+  const headers = { "user-agent": browserUserAgent() };
+  const type = string(entry.type);
+  if (type === "video" || type === "animated_gif") {
+    return videoVariants(entry).map(({ bitrate, url }) => ({
+      bitrate,
+      item: { filename: filename(`twitter_${id}_${index}.mp4`), headers, id, kind: "video", mime: "video/mp4", platform: "twitter", url }
+    }));
   }
-  return {
-    cookie: youtubeCookie(response.headers),
-    signatureTimestamp: await signatureTimestamp(net, playerPath),
-    visitorData
-  };
+  const photo = string(entry.media_url_https);
+  return photo ? [{ bitrate: 0, item: { filename: filename(`twitter_${id}_${index}.jpg`), headers, id, kind: "image", mime: "image/jpeg", platform: "twitter", url: `${photo}?name=orig` } }] : [];
 }
-function playerHeaders(session) {
-  return new Headers({
-    "content-type": "application/json",
-    cookie: `${browserCookie}; ${session.cookie}`,
-    origin: "https://www.youtube.com",
-    "user-agent": androidVrClient.userAgent,
-    "x-goog-visitor-id": session.visitorData,
-    "x-youtube-client-name": androidVrClient.number,
-    "x-youtube-client-version": androidVrClient.version
-  });
+function twitterCardImage(tweet, id) {
+  const card = object(tweet.card) ? tweet.card : null;
+  if (!card || card.name !== "summary" && card.name !== "summary_large_image")
+    return null;
+  const bindings = object(card.binding_values) ? card.binding_values : {};
+  const images = Object.entries(bindings).flatMap(([key, value]) => {
+    if (!/^(photo_image_full_size|summary_photo_image|thumbnail_image)(_(original|x_large|large|small))?$/.test(key) || !object(value) || !object(value.image_value))
+      return [];
+    const image2 = value.image_value;
+    const rawUrl = string(image2.url);
+    if (!rawUrl)
+      return [];
+    try {
+      const url = new URL(rawUrl);
+      if (url.protocol !== "https:" && url.protocol !== "http:")
+        return [];
+      const format = (url.searchParams.get("format") ?? url.pathname.match(/\.(jpe?g|png|webp|gif)$/i)?.[1] ?? "jpg").toLowerCase();
+      const extension = format === "jpeg" ? "jpg" : format;
+      if (!["jpg", "png", "webp", "gif"].includes(extension))
+        return [];
+      return [{
+        url: url.href,
+        extension,
+        original: key.endsWith("_original") ? 1 : 0,
+        area: Math.max(0, number(image2.width) ?? 0) * Math.max(0, number(image2.height) ?? 0)
+      }];
+    } catch {
+      return [];
+    }
+  }).sort((a, b) => b.original - a.original || b.area - a.area);
+  const image = images[0];
+  return image ? {
+    filename: filename(`twitter_${id}_preview.${image.extension}`),
+    headers: { "user-agent": browserUserAgent() },
+    id,
+    kind: "image",
+    mime: `image/${image.extension === "jpg" ? "jpeg" : image.extension}`,
+    platform: "twitter",
+    role: "linkPreview",
+    url: image.url
+  } : null;
 }
-function youtubeCookie(headers) {
-  const readable = headers;
-  const fallback = headers.get("set-cookie");
-  const cookieHeaders = readable.getSetCookie ? readable.getSetCookie() : fallback ? [fallback] : [];
-  return cookieHeaders.map((header) => string(header.split(";", 1)[0])).filter(string).join("; ");
+function videoVariants(entry) {
+  const info = object(entry.video_info) ? entry.video_info : null;
+  const variants = info && Array.isArray(info.variants) ? info.variants.filter(object) : [];
+  const seen = new Set;
+  return variants.flatMap((variant) => {
+    const url = string(variant.url);
+    if (string(variant.content_type) !== "video/mp4" || !url || seen.has(url)) {
+      return [];
+    }
+    seen.add(url);
+    return [{ bitrate: number(variant.bitrate) ?? 0, url }];
+  }).sort((left, right) => right.bitrate - left.bitrate);
 }
-async function signatureTimestamp(net, playerPath) {
-  const response = await net(new URL(playerPath, "https://www.youtube.com").toString(), {
-    headers: { "user-agent": browserUserAgent() }
-  });
-  if (!response.ok) {
-    throw new Error(`YouTube player failed: ${response.status}`);
+async function sizeLimitedItems(input, groups) {
+  if (groups.length === 0 || input.tryMaxBytes === undefined) {
+    return groups.map((group) => group[0].item);
   }
-  const player = await response.text();
-  const timestamp = number(Number(player.match(/signatureTimestamp[:=](\d+)/)?.[1] ?? player.match(/sts[:=](\d+)/)?.[1]));
-  if (!timestamp) {
-    throw new Error("YouTube signature timestamp not found");
+  const sizes = new Map;
+  const size = (candidate) => {
+    const existing = sizes.get(candidate.item.url);
+    if (existing) {
+      return existing;
+    }
+    const pending = contentLength(input.net, candidate.item);
+    sizes.set(candidate.item.url, pending);
+    return pending;
+  };
+  const highest = groups.map((group) => group[0]);
+  const highestSizes = await Promise.all(highest.map(size));
+  const highestTotal = knownTotal(highestSizes);
+  if (highestTotal !== null && highestTotal <= input.tryMaxBytes) {
+    return highest.map(({ item }) => item);
   }
-  return timestamp;
+  const sized = await Promise.all(groups.map(async (group) => Promise.all(group.map(async (candidate) => ({ ...candidate, bytes: await size(candidate) })))));
+  const fitting = bestFitting(sized, input.tryMaxBytes);
+  return (fitting ?? groups.map((group) => group.at(-1))).map(({ item }) => item);
 }
-function youtubeVideoId(input) {
-  const url = asUrl(input);
-  if (url.hostname === "youtu.be") {
-    return cleanId(url.pathname.split("/").filter(Boolean)[0]);
+function knownTotal(sizes) {
+  return sizes.some((size) => size === null) ? null : sizes.reduce((total, size) => total + (size ?? 0), 0);
+}
+function bestFitting(groups, maxBytes) {
+  let selections = [
+    { bytes: 0, candidates: [], quality: 0 }
+  ];
+  for (const group of groups) {
+    selections = selections.flatMap((selection) => group.flatMap((candidate) => {
+      if (candidate.bytes === null || selection.bytes + candidate.bytes > maxBytes) {
+        return [];
+      }
+      return [{
+        bytes: selection.bytes + candidate.bytes,
+        candidates: [...selection.candidates, candidate],
+        quality: selection.quality + candidate.bitrate
+      }];
+    }));
+    if (selections.length === 0) {
+      return null;
+    }
   }
-  const fromQuery = cleanId(url.searchParams.get("v"));
-  if (fromQuery) {
-    return fromQuery;
+  const best = selections.reduce((current, selection) => selection.quality > current.quality ? selection : current);
+  return best.candidates;
+}
+async function contentLength(net, item) {
+  try {
+    const response = await net(item.url, { headers: item.headers, method: "HEAD" }, 1);
+    const raw = response.ok ? response.headers.get("content-length") : null;
+    if (!raw || !/^\d+$/.test(raw)) {
+      return null;
+    }
+    const bytes = Number(raw);
+    return Number.isSafeInteger(bytes) ? bytes : null;
+  } catch {
+    return null;
   }
-  const parts = url.pathname.split("/").filter(Boolean);
-  const index = parts.findIndex((part) => part === "shorts" || part === "live" || part === "embed");
-  return index >= 0 ? cleanId(parts[index + 1]) : null;
 }
-function cleanId(value) {
-  return typeof value === "string" && /^[A-Za-z0-9_-]{11}$/.test(value) ? value : null;
+function tweetId(input) {
+  return asUrl(input).pathname.match(/\/status(?:es)?\/(\d+)/)?.[1] ?? null;
 }
-function selectFormat(payload) {
-  const root = object(payload) ? payload : null;
-  const streaming = root && object(root.streamingData) ? root.streamingData : null;
-  const formats = streaming && Array.isArray(streaming.formats) ? streaming.formats.filter(object) : [];
-  const mp4 = formats.filter((format) => string(format.url) && string(format.mimeType)?.startsWith("video/mp4")).sort((left, right) => height(right) - height(left));
-  return mp4[0] ? string(mp4[0].url) : null;
+async function twitterComments(input, id) {
+  const limit = input.comments;
+  if (!limit || !Number.isSafeInteger(limit) || limit < 0)
+    return [];
+  try {
+    const comments = [];
+    const seen = new Set;
+    const cursors = new Set;
+    let cursor = null;
+    do {
+      const url = new URL(`https://api.fxtwitter.com/2/conversation/${id}`);
+      if (cursor)
+        url.searchParams.set("cursor", cursor);
+      const response = await input.net(url.href, { headers: { accept: "application/json", "user-agent": browserUserAgent() } }, 1);
+      if (!response.ok)
+        throw new Error("Comment lookup failed");
+      const payload = await response.json();
+      if (!object(payload) || payload.code !== 200 || !Array.isArray(payload.replies))
+        throw new Error("Invalid comments");
+      const previousCount = comments.length;
+      for (const reply of payload.replies) {
+        if (!object(reply))
+          continue;
+        const replyId = string(reply.id);
+        const parent = object(reply.replying_to) ? string(reply.replying_to.status) : null;
+        if (!replyId || parent !== id || seen.has(replyId))
+          continue;
+        seen.add(replyId);
+        comments.push(twitterComment(reply, replyId));
+        if (comments.length >= limit)
+          return comments;
+      }
+      cursor = object(payload.cursor) ? string(payload.cursor.bottom) : null;
+      if (!cursor || cursors.has(cursor) || comments.length === previousCount)
+        break;
+      cursors.add(cursor);
+    } while (comments.length < limit);
+    return comments;
+  } catch {
+    return [];
+  }
 }
-function height(format) {
-  return number(format.height) ?? Number(string(format.qualityLabel)?.match(/(\d+)p/)?.[1] ?? 0);
+function twitterComment(reply, id) {
+  const author2 = object(reply.author) ? reply.author : {};
+  const verification = object(author2.verification) ? author2.verification : {};
+  const media = object(reply.media) && Array.isArray(reply.media.all) ? reply.media.all.filter(object) : [];
+  const items = media.flatMap((entry, index) => {
+    const url = string(entry.url);
+    const photo = entry.type === "photo";
+    if (!url || !photo && entry.type !== "video" && entry.type !== "gif" && entry.type !== "animated_gif")
+      return [];
+    return [{
+      id,
+      platform: "twitter",
+      filename: filename(`twitter_${id}_${index + 1}.${photo ? "jpg" : "mp4"}`),
+      kind: photo ? "image" : "video",
+      mime: photo ? "image/jpeg" : "video/mp4",
+      url,
+      headers: { "user-agent": browserUserAgent() }
+    }];
+  });
+  return {
+    id,
+    url: `https://x.com/i/status/${id}`,
+    items,
+    metadata: {
+      text: cleanTwitterText(string(reply.text), reply) ?? undefined,
+      author: {
+        handle: string(author2.screen_name) ?? undefined,
+        name: string(author2.name) ?? undefined,
+        verified: bool(verification.verified)
+      },
+      createdAt: isoFromDateString(reply.created_at),
+      likeCount: count(reply.likes),
+      commentCount: count(reply.replies),
+      shareCount: count(reply.reposts),
+      viewCount: count(reply.views),
+      nsfw: bool(reply.possibly_sensitive)
+    }
+  };
 }
 
 // src/postfetch.ts
@@ -2946,6 +3157,8 @@ async function resolve(context) {
       return resolveReddit(context);
     case "soundcloud":
       return resolveSoundcloud(context);
+    case "spotify":
+      return resolveSpotify(context);
     case "tiktok":
       return resolveTiktok(context);
     case "twitter":
@@ -3026,6 +3239,9 @@ function detect(url) {
   if (host.includes("soundcloud.com") || host === "snd.sc") {
     return "soundcloud";
   }
+  if (host === "open.spotify.com") {
+    return "spotify";
+  }
   if (host.includes("youtube.com") || host === "youtu.be") {
     return "youtube";
   }
@@ -3035,7 +3251,7 @@ function detect(url) {
   if (host === "x.com" || host.endsWith(".x.com") || host.includes("twitter.com")) {
     return "twitter";
   }
-  throw new PostfetchError(400, "only Facebook, Instagram, LinkedIn, Pinterest, Reddit, SoundCloud, TikTok, X and YouTube URLs are supported");
+  throw new PostfetchError(400, "only Facebook, Instagram, LinkedIn, Pinterest, Reddit, SoundCloud, Spotify, TikTok, X and YouTube URLs are supported");
 }
 // src/mp4-remux.ts
 async function prepareMp4(bytes, ffmpegPath = "ffmpeg", ffprobePath = "ffprobe", runtime) {
@@ -3457,10 +3673,15 @@ async function archive(result, options = {}) {
   return { bytes: zip(files), filename: result.archiveFilename, mime: "application/zip" };
 }
 async function toResponse(result, options = {}) {
-  if (result.items.length === 1) {
-    return singleResponse(result.items[0], options);
+  const response = result.items.length === 1 ? await singleResponse(result.items[0], options) : await archiveResponse(result, options);
+  if (result.platform === "spotify") {
+    response.headers.set("x-media-platform", result.platform);
+    response.headers.set("x-media-id", result.id);
+    const youtubeUrl = result.metadata?.extra?.youtubeUrl;
+    if (youtubeUrl)
+      response.headers.set("x-media-youtube-url", youtubeUrl);
   }
-  return archiveResponse(result, options);
+  return response;
 }
 async function singleResponse(item, options) {
   if (buffered(item)) {