npm - tubezero - Versions diffs - 1.0.0 → 1.1.0 - Mend

tubezero 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/index.cjs CHANGED Viewed

@@ -21,17 +21,34 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   Base: () => Base,
+  BaseChannel: () => BaseChannel,
   BaseVideo: () => BaseVideo,
+  Caption: () => Caption,
+  CaptionLanguage: () => CaptionLanguage,
+  Channel: () => Channel,
   ChannelCompact: () => ChannelCompact,
+  ChannelLive: () => ChannelLive,
+  ChannelPlaylists: () => ChannelPlaylists,
+  ChannelPosts: () => ChannelPosts,
+  ChannelShorts: () => ChannelShorts,
+  ChannelVideos: () => ChannelVideos,
+  Chat: () => Chat,
   Client: () => Client,
+  Comment: () => Comment,
+  CommentReplies: () => CommentReplies,
   Continuable: () => Continuable,
+  LiveVideo: () => LiveVideo,
+  MixPlaylist: () => MixPlaylist,
   Playlist: () => Playlist,
   PlaylistCompact: () => PlaylistCompact,
   PlaylistVideos: () => PlaylistVideos,
   SearchResult: () => SearchResult,
   Thumbnails: () => Thumbnails,
   Video: () => Video,
+  VideoCaptions: () => VideoCaptions,
+  VideoComments: () => VideoComments,
   VideoCompact: () => VideoCompact,
+  VideoRelated: () => VideoRelated,
   createCommentsApiRequestOptions: () => createCommentsApiRequestOptions,
   extractPlayerResponse: () => extractPlayerResponse,
   extractVideoEntries: () => extractVideoEntries,
@@ -42,369 +59,17 @@ __export(index_exports, {
   findContinuationToken: () => findContinuationToken,
   getInnerTubeConfig: () => getInnerTubeConfig,
   getSApiSidHash: () => getSApiSidHash,
-  getSapisidFromCookie: () => getSapisidFromCookie,
+  getSapisidFromCookieString: () => getSapisidFromCookieString,
+  getVideoPlayback: () => getVideoPlayback,
   parseXmlTranscriptRegex: () => parseXmlTranscriptRegex,
-  scrapeTasteData: () => scrapeTasteData
+  scrapeTasteData: () => scrapeTasteData,
+  searchYouTube: () => searchYouTube,
+  toPlainText: () => toPlainText,
+  toSRT: () => toSRT,
+  toVTT: () => toVTT
 });
 module.exports = __toCommonJS(index_exports);
-// src/scraper.ts
-async function fetchYtInitialData(url) {
-  try {
-    console.log(`[Scraper] Fetching HTML from ${url}`);
-    const response = await fetch(url, { credentials: "include" });
-    const text = await response.text();
-    const patterns = [
-      /var ytInitialData\s*=\s*(\{.*?\});<\/script>/,
-      /window\["ytInitialData"\]\s*=\s*(\{.*?\});/
-    ];
-    for (const regex of patterns) {
-      const match = text.match(regex);
-      if (match && match[1]) {
-        return JSON.parse(match[1]);
-      }
-    }
-    console.warn(`[Scraper] Could not find ytInitialData in ${url}`);
-  } catch (e) {
-    console.error(`[Scraper] Failed to fetch data from ${url}`, e);
-  }
-  return null;
-}
-function getSapisidFromCookie() {
-  if (typeof document === "undefined") return null;
-  const match = document.cookie.match(/__Secure-3PAPISID=([^;]+)/) || document.cookie.match(/__Secure-1PAPISID=([^;]+)/) || document.cookie.match(/SAPISID=([^;]+)/);
-  return match ? match[1] : null;
-}
-async function getSApiSidHash(sapisid, origin = "https://www.youtube.com") {
-  if (!sapisid) return null;
-  try {
-    const timestamp = Math.floor(Date.now() / 1e3);
-    const input = `${timestamp} ${sapisid} ${origin}`;
-    const encoder = new TextEncoder();
-    const data = encoder.encode(input);
-    const buffer = await crypto.subtle.digest("SHA-1", data);
-    const hash = Array.from(new Uint8Array(buffer)).map((b) => b.toString(16).padStart(2, "0")).join("");
-    return `${timestamp}_${hash}`;
-  } catch (e) {
-    console.error("[Scraper] Failed to generate SAPISIDHASH", e);
-    return null;
-  }
-}
-function extractVideoEntries(data) {
-  const entries = [];
-  const seenTitles = /* @__PURE__ */ new Set();
-  function recurse(obj) {
-    if (!obj || typeof obj !== "object") return;
-    if (Array.isArray(obj)) {
-      for (let i = 0; i < obj.length; i++) {
-        recurse(obj[i]);
-      }
-      return;
-    }
-    if (obj.videoId && obj.title) {
-      let title = "";
-      if (typeof obj.title === "string") {
-        title = obj.title;
-      } else if (obj.title.runs && obj.title.runs[0] && obj.title.runs[0].text) {
-        title = obj.title.runs[0].text;
-      } else if (obj.title.simpleText) {
-        title = obj.title.simpleText;
-      }
-      title = title.trim();
-      if (title && title.length > 2 && title !== "Skip navigation") {
-        if (!seenTitles.has(title)) {
-          seenTitles.add(title);
-          let channel = "";
-          const byline = obj.longBylineText || obj.shortBylineText || obj.ownerText;
-          if (byline) {
-            if (typeof byline === "string") {
-              channel = byline;
-            } else if (byline.runs && byline.runs[0] && byline.runs[0].text) {
-              channel = byline.runs[0].text;
-            } else if (byline.simpleText) {
-              channel = byline.simpleText;
-            }
-          }
-          entries.push({
-            title,
-            channel: channel.split("\n")[0].replace(/•/g, "").trim()
-          });
-        }
-      }
-      return;
-    }
-    if (obj.lockupViewModel && obj.lockupViewModel.contentId && obj.lockupViewModel.contentType === "LOCKUP_CONTENT_TYPE_VIDEO") {
-      const model = obj.lockupViewModel;
-      const meta = model.metadata?.lockupMetadataViewModel;
-      if (meta && meta.title && meta.title.content) {
-        const title = meta.title.content.trim();
-        if (title && !seenTitles.has(title)) {
-          seenTitles.add(title);
-          let channel = "";
-          const rows = meta.metadata?.contentMetadataViewModel?.metadataRows;
-          if (rows && rows[0] && rows[0].metadataParts && rows[0].metadataParts[0] && rows[0].metadataParts[0].text) {
-            channel = rows[0].metadataParts[0].text.content || "";
-          }
-          entries.push({
-            title,
-            channel: channel.split("\n")[0].replace(/•/g, "").trim()
-          });
-        }
-      }
-      return;
-    }
-    for (const key in obj) {
-      if (Object.prototype.hasOwnProperty.call(obj, key)) {
-        recurse(obj[key]);
-      }
-    }
-  }
-  try {
-    recurse(data);
-  } catch (e) {
-    console.warn("[Scraper] Error extracting video entries recursively", e);
-  }
-  return entries;
-}
-function getFallbackClientVersion() {
-  const d = /* @__PURE__ */ new Date();
-  d.setDate(d.getDate() - 2);
-  const yyyymmdd = d.toISOString().split("T")[0].replace(/-/g, "");
-  return `2.${yyyymmdd}.00.00`;
-}
-var cachedApiKey = null;
-var cachedClientVersion = null;
-var cachedIdToken = null;
-async function getInnerTubeConfig(injectedConfig) {
-  if (injectedConfig && injectedConfig.apiKey) {
-    cachedApiKey = injectedConfig.apiKey;
-    cachedClientVersion = injectedConfig.clientVersion || getFallbackClientVersion();
-    cachedIdToken = injectedConfig.idToken ?? null;
-    return { apiKey: cachedApiKey, clientVersion: cachedClientVersion, idToken: cachedIdToken };
-  }
-  if (cachedApiKey && cachedClientVersion) {
-    return { apiKey: cachedApiKey, clientVersion: cachedClientVersion, idToken: cachedIdToken };
-  }
-  try {
-    console.log("[Scraper] Fetching YouTube homepage for config...");
-    const response = await fetch("https://www.youtube.com", { credentials: "include" });
-    const html = await response.text();
-    const apiKeyMatch = html.match(/"INNERTUBE_API_KEY":"([^"]+)"/);
-    const clientVersionMatch = html.match(/"INNERTUBE_CLIENT_VERSION":"([^"]+)"/);
-    const idTokenMatch = html.match(/"ID_TOKEN":"([^"]+)"/);
-    if (apiKeyMatch && apiKeyMatch[1]) cachedApiKey = apiKeyMatch[1];
-    if (clientVersionMatch && clientVersionMatch[1]) cachedClientVersion = clientVersionMatch[1];
-    if (idTokenMatch && idTokenMatch[1]) cachedIdToken = idTokenMatch[1];
-    console.log(`[Scraper] Extracted Config \u2014 Key: ${cachedApiKey ? "OK" : "Failed"}, Version: ${cachedClientVersion}`);
-  } catch (e) {
-    console.warn("[Scraper] Failed to extract InnerTube config from HTML", e);
-  }
-  if (!cachedClientVersion) {
-    cachedClientVersion = getFallbackClientVersion();
-  }
-  return { apiKey: cachedApiKey, clientVersion: cachedClientVersion, idToken: cachedIdToken };
-}
-function findContinuationToken(obj) {
-  if (!obj || typeof obj !== "object") return null;
-  if (obj.continuationCommand && obj.continuationCommand.token) {
-    return obj.continuationCommand.token;
-  }
-  for (const key in obj) {
-    if (Object.prototype.hasOwnProperty.call(obj, key)) {
-      const token = findContinuationToken(obj[key]);
-      if (token) return token;
-    }
-  }
-  return null;
-}
-async function fetchInnerTubeContinuation(apiKey, clientVersion, idToken, initialToken, limit) {
-  const entries = [];
-  let continuationToken = initialToken;
-  try {
-    while (continuationToken && entries.length < limit) {
-      const headers = {
-        "Content-Type": "application/json",
-        "X-Youtube-Client-Name": "1",
-        "X-Youtube-Client-Version": clientVersion
-      };
-      if (idToken) {
-        headers["X-Youtube-Identity-Token"] = idToken;
-      }
-      const sapisid = getSapisidFromCookie();
-      if (sapisid) {
-        const authHash = await getSApiSidHash(sapisid, "https://www.youtube.com");
-        if (authHash) {
-          headers["Authorization"] = `SAPISIDHASH ${authHash}`;
-        }
-      }
-      const response = await fetch(`https://www.youtube.com/youtubei/v1/browse?key=${apiKey}&prettyPrint=false`, {
-        method: "POST",
-        headers,
-        credentials: "include",
-        body: JSON.stringify({
-          context: {
-            client: {
-              clientName: "WEB",
-              clientVersion,
-              hl: "en",
-              gl: "US"
-            }
-          },
-          continuation: continuationToken
-        })
-      });
-      if (!response.ok) break;
-      const data = await response.json();
-      const pageEntries = extractVideoEntries(data);
-      entries.push(...pageEntries);
-      continuationToken = findContinuationToken(data);
-    }
-  } catch (e) {
-    console.error("[Scraper] Error in InnerTube pagination", e);
-  }
-  return entries;
-}
-async function fetchInnerTubeFeed(apiKey, clientVersion, idToken, browseId, limit = 500) {
-  const entries = [];
-  try {
-    const headers = {
-      "Content-Type": "application/json",
-      "X-Youtube-Client-Name": "1",
-      "X-Youtube-Client-Version": clientVersion
-    };
-    if (idToken) {
-      headers["X-Youtube-Identity-Token"] = idToken;
-    }
-    const sapisid = getSapisidFromCookie();
-    if (sapisid) {
-      const authHash = await getSApiSidHash(sapisid, "https://www.youtube.com");
-      if (authHash) {
-        headers["Authorization"] = `SAPISIDHASH ${authHash}`;
-      }
-    }
-    const response = await fetch(`https://www.youtube.com/youtubei/v1/browse?key=${apiKey}&prettyPrint=false`, {
-      method: "POST",
-      headers,
-      credentials: "include",
-      body: JSON.stringify({
-        context: {
-          client: {
-            clientName: "WEB",
-            clientVersion,
-            hl: "en",
-            gl: "US"
-          }
-        },
-        browseId
-      })
-    });
-    if (!response.ok) return [];
-    const data = await response.json();
-    const pageEntries = extractVideoEntries(data);
-    entries.push(...pageEntries);
-    if (entries.length < limit) {
-      const continuationToken = findContinuationToken(data);
-      if (continuationToken) {
-        const more = await fetchInnerTubeContinuation(apiKey, clientVersion, idToken, continuationToken, limit - entries.length);
-        entries.push(...more);
-      }
-    }
-  } catch (e) {
-    console.error(`[Scraper] InnerTube fetch error for ${browseId}`, e);
-  }
-  return entries;
-}
-async function scrapeTasteData(injectedConfig, customPlaylists = [], limit = 500) {
-  let historyEntries = [];
-  let likesEntries = [];
-  let wlEntries = [];
-  const dislikesEntries = [];
-  const config = await getInnerTubeConfig(injectedConfig);
-  const apiKey = config.apiKey;
-  const clientVersion = config.clientVersion;
-  const idToken = config.idToken;
-  if (apiKey) {
-    historyEntries = await fetchInnerTubeFeed(apiKey, clientVersion, idToken, "FEhistory", limit);
-    likesEntries = await fetchInnerTubeFeed(apiKey, clientVersion, idToken, "VLLL", limit);
-    wlEntries = await fetchInnerTubeFeed(apiKey, clientVersion, idToken, "VLWL", limit);
-  }
-  if (historyEntries.length === 0) {
-    const historyData = await fetchYtInitialData("https://www.youtube.com/feed/history");
-    if (historyData) {
-      historyEntries = extractVideoEntries(historyData);
-      if (historyEntries.length < limit) {
-        const token = findContinuationToken(historyData);
-        if (token && apiKey) {
-          const more = await fetchInnerTubeContinuation(apiKey, clientVersion, idToken, token, limit - historyEntries.length);
-          historyEntries.push(...more);
-        }
-      }
-    }
-  }
-  if (likesEntries.length === 0) {
-    const likesData = await fetchYtInitialData("https://www.youtube.com/playlist?list=LL");
-    if (likesData) {
-      likesEntries = extractVideoEntries(likesData);
-      if (likesEntries.length < limit) {
-        const token = findContinuationToken(likesData);
-        if (token && apiKey) {
-          const more = await fetchInnerTubeContinuation(apiKey, clientVersion, idToken, token, limit - likesEntries.length);
-          likesEntries.push(...more);
-        }
-      }
-    }
-  }
-  if (wlEntries.length === 0) {
-    const wlData = await fetchYtInitialData("https://www.youtube.com/playlist?list=WL");
-    if (wlData) {
-      wlEntries = extractVideoEntries(wlData);
-      if (wlEntries.length < limit) {
-        const token = findContinuationToken(wlData);
-        if (token && apiKey) {
-          const more = await fetchInnerTubeContinuation(apiKey, clientVersion, idToken, token, limit - wlEntries.length);
-          wlEntries.push(...more);
-        }
-      }
-    }
-  }
-  const customPlaylistsData = [];
-  for (const pl of customPlaylists) {
-    if (!pl.url) continue;
-    const match = pl.url.match(/[&?]list=([a-zA-Z0-9_-]+)/);
-    const playlistId = match ? match[1] : pl.url.trim();
-    if (!playlistId || !/^[a-zA-Z0-9_-]+$/.test(playlistId)) continue;
-    const browseId = playlistId.startsWith("VL") ? playlistId : "VL" + playlistId;
-    let entries = [];
-    if (apiKey) {
-      entries = await fetchInnerTubeFeed(apiKey, clientVersion, idToken, browseId, limit);
-    }
-    if (entries.length === 0) {
-      const data = await fetchYtInitialData(`https://www.youtube.com/playlist?list=${playlistId}`);
-      if (data) {
-        entries = extractVideoEntries(data);
-        if (entries.length < limit) {
-          const token = findContinuationToken(data);
-          if (token && apiKey) {
-            const more = await fetchInnerTubeContinuation(apiKey, clientVersion, idToken, token, limit - entries.length);
-            entries.push(...more);
-          }
-        }
-      }
-    }
-    customPlaylistsData.push({
-      id: playlistId,
-      entries: entries.slice(0, limit)
-    });
-  }
-  return {
-    historyEntries: historyEntries.slice(0, limit),
-    likesEntries: likesEntries.slice(0, limit),
-    wlEntries: wlEntries.slice(0, limit),
-    dislikesEntries: dislikesEntries.slice(0, limit),
-    customPlaylistsData
-  };
-}
 // src/base.ts
 var Base = class {
   constructor(client) {
@@ -463,26 +128,27 @@ var Continuable = class extends Base {
 };
 // src/thumbnails.ts
-var Thumbnails = class {
-  list;
-  constructor(list) {
-    this.list = list;
-  }
-  getBestResolution() {
-    if (!this.list || this.list.length === 0) {
-      return void 0;
-    }
-    let best = this.list[0];
-    let maxResolution = (best.width || 0) * (best.height || 0);
-    for (let i = 1; i < this.list.length; i++) {
-      const thumb = this.list[i];
-      const resolution = (thumb.width || 0) * (thumb.height || 0);
-      if (resolution > maxResolution) {
-        maxResolution = resolution;
-        best = thumb;
-      }
+var Thumbnails = class extends Array {
+  constructor(list = []) {
+    if (typeof list === "number") {
+      super(list);
+    } else {
+      super(...list);
     }
-    return best;
+  }
+  get min() {
+    return this[0]?.url;
+  }
+  get best() {
+    return this.reduce((prev, curr) => {
+      if (!prev) return curr;
+      return prev.width * prev.height > curr.width * curr.height ? prev : curr;
+    }, void 0)?.url;
+  }
+  load(thumbnails) {
+    this.length = 0;
+    this.push(...thumbnails);
+    return this;
   }
 };
@@ -506,51 +172,142 @@ var VideoCompact = class extends Base {
     let pubAt = null;
     let thumbnails = [];
     let channelObj = void 0;
-    if (data.videoId) {
-      videoId = data.videoId;
+    if (data.videoId) {
+      videoId = data.videoId;
+      titleText = data.title?.simpleText || data.title?.runs?.[0]?.text || "";
+      thumbnails = data.thumbnail?.thumbnails || [];
+      if (data.lengthText) {
+        const text = data.lengthText.simpleText || data.lengthText.runs?.[0]?.text || "";
+        durationSec = this.parseDuration(text);
+      }
+      if (data.badges?.some((b) => b.metadataBadgeRenderer?.style === "BADGE_STYLE_TYPE_LIVE_NOW")) {
+        isLive = true;
+      }
+      if (data.viewCountText) {
+        const text = data.viewCountText.simpleText || data.viewCountText.runs?.[0]?.text || "";
+        viewCountNum = this.parseViewCount(text);
+      }
+      if (data.publishedTimeText) {
+        pubAt = data.publishedTimeText.simpleText || data.publishedTimeText.runs?.[0]?.text || null;
+      }
+      const byline = data.shortBylineText || data.longBylineText || data.ownerText;
+      if (byline && byline.runs && byline.runs[0]) {
+        const run = byline.runs[0];
+        channelObj = {
+          id: run.navigationEndpoint?.browseEndpoint?.browseId || void 0,
+          name: run.text,
+          thumbnails: data.channelThumbnailSupportedRenderers?.channelThumbnailWithLinkRenderer?.thumbnail?.thumbnails ? new Thumbnails(data.channelThumbnailSupportedRenderers.channelThumbnailWithLinkRenderer.thumbnail.thumbnails) : void 0
+        };
+      }
+    } else if (data.lockupViewModel && data.lockupViewModel.contentId && data.lockupViewModel.contentType === "LOCKUP_CONTENT_TYPE_VIDEO") {
+      const model = data.lockupViewModel;
+      videoId = model.contentId;
+      const meta = model.metadata?.lockupMetadataViewModel;
+      titleText = meta?.title?.content || "";
+      const rows = meta?.metadata?.contentMetadataViewModel?.metadataRows || [];
+      let cName = "";
+      let vCount = null;
+      let pAt = null;
+      for (const row of rows) {
+        for (const part of row.metadataParts || []) {
+          const text = part.text?.content || "";
+          if (text.includes("views") || text.includes("watching")) {
+            if (text.includes("watching")) isLive = true;
+            vCount = this.parseViewCount(text);
+          } else if (text.includes("ago")) {
+            pAt = text;
+          } else {
+            cName = text;
+          }
+        }
+      }
+      if (cName) {
+        channelObj = { name: cName.replace(/•/g, "").trim() };
+      }
+      viewCountNum = vCount;
+      pubAt = pAt;
+    }
+    this.id = videoId;
+    this.title = titleText;
+    this.thumbnails = new Thumbnails(thumbnails);
+    this.duration = durationSec;
+    this.isLive = isLive;
+    this.channel = channelObj;
+    this.viewCount = viewCountNum;
+    this.publishedAt = pubAt;
+  }
+  parseDuration(text) {
+    const parts = text.split(":").map(Number);
+    if (parts.some(isNaN)) return 0;
+    if (parts.length === 3) return parts[0] * 3600 + parts[1] * 60 + parts[2];
+    if (parts.length === 2) return parts[0] * 60 + parts[1];
+    return parts[0] || 0;
+  }
+  parseViewCount(text) {
+    const cleaned = text.trim().replace(/,/g, "");
+    const match = cleaned.match(/([\d.]+)\s*([KMB])?/i);
+    if (!match) return null;
+    const num = parseFloat(match[1]);
+    if (isNaN(num)) return null;
+    const suffix = match[2]?.toUpperCase();
+    if (suffix === "K") return Math.round(num * 1e3);
+    if (suffix === "M") return Math.round(num * 1e6);
+    if (suffix === "B") return Math.round(num * 1e9);
+    const result = Math.round(num);
+    return isNaN(result) ? null : result;
+  }
+};
+// src/playlist-compact.ts
+var PlaylistCompact = class extends Base {
+  id;
+  title;
+  thumbnails;
+  videoCount;
+  channel;
+  constructor(client, data) {
+    super(client);
+    let playlistId = "";
+    let titleText = "";
+    let thumbnails = [];
+    let videoCountNum = null;
+    let channelObj = void 0;
+    if (data.playlistId) {
+      playlistId = data.playlistId;
       titleText = data.title?.simpleText || data.title?.runs?.[0]?.text || "";
-      thumbnails = data.thumbnail?.thumbnails || [];
-      if (data.lengthText) {
-        const text = data.lengthText.simpleText || data.lengthText.runs?.[0]?.text || "";
-        durationSec = this.parseDuration(text);
-      }
-      if (data.badges?.some((b) => b.metadataBadgeRenderer?.style === "BADGE_STYLE_TYPE_LIVE_NOW")) {
-        isLive = true;
-      }
-      if (data.viewCountText) {
-        const text = data.viewCountText.simpleText || data.viewCountText.runs?.[0]?.text || "";
-        viewCountNum = this.parseViewCount(text);
-      }
-      if (data.publishedTimeText) {
-        pubAt = data.publishedTimeText.simpleText || data.publishedTimeText.runs?.[0]?.text || null;
+      thumbnails = data.thumbnails?.[0]?.thumbnails || data.thumbnail?.thumbnails || [];
+      if (data.videoCount) {
+        const parsed = parseInt(data.videoCount, 10);
+        videoCountNum = isNaN(parsed) ? null : parsed;
+      } else if (data.videoCountText) {
+        const text = data.videoCountText.runs?.[0]?.text || data.videoCountText.simpleText || "";
+        const cleaned = text.replace(/[^0-9]/g, "");
+        if (cleaned) videoCountNum = parseInt(cleaned, 10);
       }
       const byline = data.shortBylineText || data.longBylineText || data.ownerText;
       if (byline && byline.runs && byline.runs[0]) {
         const run = byline.runs[0];
         channelObj = {
           id: run.navigationEndpoint?.browseEndpoint?.browseId || void 0,
-          name: run.text,
-          thumbnails: data.channelThumbnailSupportedRenderers?.channelThumbnailWithLinkRenderer?.thumbnail?.thumbnails ? new Thumbnails(data.channelThumbnailSupportedRenderers.channelThumbnailWithLinkRenderer.thumbnail.thumbnails) : void 0
+          name: run.text
         };
       }
-    } else if (data.lockupViewModel && data.lockupViewModel.contentId && data.lockupViewModel.contentType === "LOCKUP_CONTENT_TYPE_VIDEO") {
+    } else if (data.lockupViewModel && data.lockupViewModel.contentId && data.lockupViewModel.contentType === "LOCKUP_CONTENT_TYPE_PLAYLIST") {
       const model = data.lockupViewModel;
-      videoId = model.contentId;
+      playlistId = model.contentId;
       const meta = model.metadata?.lockupMetadataViewModel;
       titleText = meta?.title?.content || "";
+      const img = model.image?.lockupImageViewModel?.image;
+      if (img && img.sources) thumbnails = img.sources;
       const rows = meta?.metadata?.contentMetadataViewModel?.metadataRows || [];
       let cName = "";
-      let vCount = null;
-      let pAt = null;
       for (const row of rows) {
         for (const part of row.metadataParts || []) {
           const text = part.text?.content || "";
-          if (text.includes("views") || text.includes("watching")) {
-            if (text.includes("watching")) isLive = true;
-            vCount = this.parseViewCount(text);
-          } else if (text.includes("ago")) {
-            pAt = text;
-          } else {
+          if (text.includes("video")) {
+            const cleaned = text.replace(/[^0-9]/g, "");
+            if (cleaned) videoCountNum = parseInt(cleaned, 10);
+          } else if (!cName) {
             cName = text;
           }
         }
@@ -558,206 +315,761 @@ var VideoCompact = class extends Base {
       if (cName) {
         channelObj = { name: cName.replace(/•/g, "").trim() };
       }
-      viewCountNum = vCount;
-      pubAt = pAt;
     }
-    this.id = videoId;
+    this.id = playlistId;
     this.title = titleText;
     this.thumbnails = new Thumbnails(thumbnails);
-    this.duration = durationSec;
-    this.isLive = isLive;
+    this.videoCount = videoCountNum;
     this.channel = channelObj;
-    this.viewCount = viewCountNum;
-    this.publishedAt = pubAt;
   }
-  parseDuration(text) {
-    const parts = text.split(":").map(Number);
-    if (parts.some(isNaN)) return 0;
-    if (parts.length === 3) return parts[0] * 3600 + parts[1] * 60 + parts[2];
-    if (parts.length === 2) return parts[0] * 60 + parts[1];
-    return parts[0] || 0;
+};
+// src/channel-compact.ts
+var ChannelCompact = class extends Base {
+  id;
+  name;
+  thumbnails;
+  subscriberCount;
+  constructor(client, data) {
+    super(client);
+    let channelId = "";
+    let nameText = "";
+    let thumbnails = [];
+    let subCount = null;
+    if (data.channelId) {
+      channelId = data.channelId;
+      nameText = data.title?.simpleText || data.title?.runs?.[0]?.text || "";
+      thumbnails = data.thumbnail?.thumbnails || [];
+      if (data.subscriberCountText) {
+        subCount = data.subscriberCountText.simpleText || data.subscriberCountText.runs?.[0]?.text || null;
+      } else if (data.videoSubscriberCountText) {
+        subCount = data.videoSubscriberCountText.simpleText || data.videoSubscriberCountText.runs?.[0]?.text || null;
+      }
+    }
+    this.id = channelId;
+    this.name = nameText;
+    this.thumbnails = new Thumbnails(thumbnails);
+    this.subscriberCount = subCount;
+  }
+};
+// src/search-result.ts
+var SearchResult = class _SearchResult extends Continuable {
+  constructor(client, initialData) {
+    super(client);
+    const { items, continuation } = _SearchResult.parseData(client, initialData);
+    this.items = items;
+    this.continuation = continuation;
+  }
+  async fetch() {
+    if (!this.continuation) {
+      return { items: [], continuation: null };
+    }
+    const data = await this.client.request("search", {
+      continuation: this.continuation
+    });
+    return _SearchResult.parseData(this.client, data);
+  }
+  static parseData(client, data) {
+    const items = [];
+    let continuation = null;
+    function traverse(obj) {
+      if (!obj || typeof obj !== "object") return;
+      if (Array.isArray(obj)) {
+        for (const item of obj) traverse(item);
+        return;
+      }
+      if (obj.videoRenderer || obj.lockupViewModel && obj.lockupViewModel.contentId && obj.lockupViewModel.contentType === "LOCKUP_CONTENT_TYPE_VIDEO") {
+        items.push(new VideoCompact(client, obj.videoRenderer || obj));
+        return;
+      }
+      if (obj.playlistRenderer) {
+        items.push(new PlaylistCompact(client, obj.playlistRenderer));
+        return;
+      }
+      if (obj.channelRenderer) {
+        items.push(new ChannelCompact(client, obj.channelRenderer));
+        return;
+      }
+      if (obj.continuationCommand && obj.continuationCommand.token) {
+        continuation = obj.continuationCommand.token;
+      } else if (obj.continuationItemRenderer?.continuationEndpoint) {
+        continuation = obj.continuationItemRenderer.continuationEndpoint?.continuationCommand?.token || null;
+      }
+      for (const key of Object.keys(obj)) {
+        traverse(obj[key]);
+      }
+    }
+    traverse(data);
+    return { items, continuation };
+  }
+};
+// src/base-channel.ts
+var TAB_PARAMS = {
+  videos: "EgZ2aWRlb3PyBgQKAjoA",
+  shorts: "EgZzaG9ydHPyBgUKA5oBAA%3D%3D",
+  live: "EgdzdHJlYW1z8gYECgJ6AA%3D%3D",
+  playlists: "EglwbGF5bGlzdHPyBgQKAkIA",
+  posts: "EgVwb3N0c_IGBAoCSgA%3D"
+};
+var ChannelVideos = class extends Continuable {
+  constructor(client, channel) {
+    super(client);
+    this.channel = channel;
+  }
+  channel;
+  async fetch() {
+    const data = await this.client.request("browse", {
+      browseId: this.channel.id,
+      params: TAB_PARAMS.videos,
+      continuation: this.continuation || void 0
+    });
+    return parseTabItems(this.client, data, "videos");
+  }
+};
+var ChannelShorts = class extends Continuable {
+  constructor(client, channel) {
+    super(client);
+    this.channel = channel;
+  }
+  channel;
+  async fetch() {
+    const data = await this.client.request("browse", {
+      browseId: this.channel.id,
+      params: TAB_PARAMS.shorts,
+      continuation: this.continuation || void 0
+    });
+    return parseTabItems(this.client, data, "shorts");
+  }
+};
+var ChannelLive = class extends Continuable {
+  constructor(client, channel) {
+    super(client);
+    this.channel = channel;
+  }
+  channel;
+  async fetch() {
+    const data = await this.client.request("browse", {
+      browseId: this.channel.id,
+      params: TAB_PARAMS.live,
+      continuation: this.continuation || void 0
+    });
+    return parseTabItems(this.client, data, "live");
+  }
+};
+var ChannelPlaylists = class extends Continuable {
+  constructor(client, channel) {
+    super(client);
+    this.channel = channel;
+  }
+  channel;
+  async fetch() {
+    const data = await this.client.request("browse", {
+      browseId: this.channel.id,
+      params: TAB_PARAMS.playlists,
+      continuation: this.continuation || void 0
+    });
+    return parseTabItems(this.client, data, "playlists");
+  }
+};
+var ChannelPosts = class extends Continuable {
+  constructor(client, channel) {
+    super(client);
+    this.channel = channel;
+  }
+  channel;
+  async fetch() {
+    const data = await this.client.request("browse", {
+      browseId: this.channel.id,
+      params: TAB_PARAMS.posts,
+      continuation: this.continuation || void 0
+    });
+    return parseTabItems(this.client, data, "posts");
+  }
+};
+var BaseChannel = class extends Base {
+  id;
+  name;
+  handle;
+  description;
+  thumbnails;
+  subscriberCount;
+  videos;
+  shorts;
+  live;
+  playlists;
+  posts;
+  constructor(client, data) {
+    super(client);
+    this.id = "";
+    this.name = "";
+    this.videos = new ChannelVideos(client, this);
+    this.shorts = new ChannelShorts(client, this);
+    this.live = new ChannelLive(client, this);
+    this.playlists = new ChannelPlaylists(client, this);
+    this.posts = new ChannelPosts(client, this);
+    if (data) {
+      this.load(data);
+    }
+  }
+  get url() {
+    return `https://www.youtube.com/channel/${this.id}`;
+  }
+  load(data) {
+    const headerObj = data.header?.c4TabbedHeaderRenderer || data.header?.pageHeaderRenderer || data.c4TabbedHeaderRenderer || data;
+    if (headerObj.pageTitle) {
+      this.name = headerObj.pageTitle;
+    }
+    const viewModel = headerObj.content?.pageHeaderViewModel;
+    if (viewModel) {
+      this.name = viewModel.title?.dynamicTextViewModel?.text?.content || this.name;
+      const thumbs = viewModel.image?.decoratedAvatarViewModel?.avatar?.avatarViewModel?.image?.sources || [];
+      this.thumbnails = new Thumbnails(thumbs);
+      const rows = viewModel.metadata?.contentMetadataViewModel?.metadataRows || [];
+      for (const row of rows) {
+        for (const part of row.metadataParts || []) {
+          const txt = part.text?.content || "";
+          if (txt.includes("subscriber")) {
+            this.subscriberCount = txt;
+          }
+        }
+      }
+    }
+    if (headerObj.channelId) {
+      this.id = headerObj.channelId;
+    }
+    if (headerObj.title) {
+      this.name = headerObj.title.simpleText || headerObj.title.runs?.[0]?.text || this.name;
+    }
+    if (headerObj.subscriberCountText) {
+      this.subscriberCount = headerObj.subscriberCountText.simpleText || headerObj.subscriberCountText.runs?.[0]?.text || this.subscriberCount;
+    }
+    if (headerObj.thumbnail) {
+      const thumbs = headerObj.thumbnail.thumbnails || [];
+      this.thumbnails = new Thumbnails(thumbs);
+    }
+    this.id = this.id || data.id || data.channelId || "";
+    this.name = this.name || data.name || "";
+    if (!this.thumbnails || this.thumbnails.length === 0) {
+      const thumbs = data.thumbnails || data.thumbnail?.thumbnails || [];
+      this.thumbnails = new Thumbnails(thumbs);
+    }
+    if (!this.id) {
+      const serviceParams = data.responseContext?.serviceTrackingParams || [];
+      for (const sp of serviceParams) {
+        const browseIdParam = sp.params?.find((p) => p.key === "browse_id");
+        if (browseIdParam) {
+          this.id = browseIdParam.value;
+          break;
+        }
+      }
+    }
+    return this;
+  }
+};
+function parseTabItems(client, data, tabName) {
+  const items = [];
+  let continuation = null;
+  function traverse(obj) {
+    if (!obj || typeof obj !== "object") return;
+    if (Array.isArray(obj)) {
+      for (const item of obj) traverse(item);
+      return;
+    }
+    if (obj.videoRenderer || obj.lockupViewModel && obj.lockupViewModel.contentId && obj.lockupViewModel.contentType === "LOCKUP_CONTENT_TYPE_VIDEO") {
+      if (tabName !== "playlists") {
+        items.push(new VideoCompact(client, obj.videoRenderer || obj));
+      }
+      return;
+    }
+    if (obj.playlistRenderer || obj.lockupViewModel && obj.lockupViewModel.contentId && obj.lockupViewModel.contentType === "LOCKUP_CONTENT_TYPE_PLAYLIST") {
+      if (tabName === "playlists") {
+        items.push(new PlaylistCompact(client, obj.playlistRenderer || obj));
+      }
+      return;
+    }
+    if (obj.backstagePostRenderer || obj.sharedPostRenderer) {
+      if (tabName === "posts") {
+        items.push(obj);
+      }
+      return;
+    }
+    if (obj.continuationCommand && obj.continuationCommand.token) {
+      continuation = obj.continuationCommand.token;
+    } else if (obj.continuationItemRenderer?.continuationEndpoint) {
+      continuation = obj.continuationItemRenderer.continuationEndpoint?.continuationCommand?.token || null;
+    }
+    for (const key of Object.keys(obj)) {
+      traverse(obj[key]);
+    }
+  }
+  traverse(data);
+  return { items, continuation };
+}
+// src/video-related.ts
+var VideoRelated = class extends Continuable {
+  constructor(client, video) {
+    super(client);
+    this.video = video;
+  }
+  video;
+  async fetch() {
+    if (!this.continuation) {
+      return { items: [], continuation: null };
+    }
+    const data = await this.client.request("next", {
+      continuation: this.continuation
+    });
+    return parseRelatedData(this.client, data);
+  }
+};
+function parseRelatedData(client, data) {
+  const items = [];
+  let continuation = null;
+  function traverse(obj) {
+    if (!obj || typeof obj !== "object") return;
+    if (Array.isArray(obj)) {
+      for (const item of obj) traverse(item);
+      return;
+    }
+    if (obj.compactVideoRenderer || obj.lockupViewModel && obj.lockupViewModel.contentId && obj.lockupViewModel.contentType === "LOCKUP_CONTENT_TYPE_VIDEO") {
+      items.push(new VideoCompact(client, obj.compactVideoRenderer || obj));
+      return;
+    }
+    if (obj.compactRadioRenderer || obj.lockupViewModel && obj.lockupViewModel.contentId && obj.lockupViewModel.contentType === "LOCKUP_CONTENT_TYPE_PLAYLIST") {
+      items.push(new PlaylistCompact(client, obj.compactRadioRenderer || obj));
+      return;
+    }
+    if (obj.continuationCommand && obj.continuationCommand.token) {
+      continuation = obj.continuationCommand.token;
+    } else if (obj.continuationItemRenderer?.continuationEndpoint) {
+      continuation = obj.continuationItemRenderer.continuationEndpoint?.continuationCommand?.token || null;
+    }
+    for (const key of Object.keys(obj)) {
+      traverse(obj[key]);
+    }
+  }
+  const secondaryContents = data.contents?.twoColumnWatchNextResults?.secondaryResults?.secondaryResults?.results || data.onResponseReceivedEndpoints?.[0]?.appendContinuationItemsAction?.continuationItems || [];
+  if (secondaryContents.length > 0) {
+    traverse(secondaryContents);
+  } else {
+    traverse(data);
+  }
+  return { items, continuation };
+}
+// src/caption.ts
+var CaptionLanguage = class {
+  captions;
+  name;
+  code;
+  isTranslatable;
+  url;
+  constructor(attr) {
+    this.captions = attr.captions;
+    this.name = attr.name;
+    this.code = attr.code;
+    this.isTranslatable = attr.isTranslatable;
+    this.url = attr.url;
+  }
+  async get(translationLanguageCode) {
+    return this.captions.get(this.code, translationLanguageCode);
+  }
+};
+var Caption = class {
+  duration;
+  start;
+  text;
+  segments;
+  constructor(attr) {
+    Object.assign(this, attr);
+  }
+  get end() {
+    return this.start + this.duration;
+  }
+};
+// src/video-captions.ts
+var VideoCaptions = class extends Base {
+  video;
+  languages = [];
+  constructor(attr) {
+    super(attr.client);
+    this.video = attr.video;
+  }
+  load(data) {
+    const captionTracks = data?.captionTracks || [];
+    this.languages = captionTracks.map((track) => new CaptionLanguage({
+      captions: this,
+      name: track.name?.simpleText || track.name?.runs?.[0]?.text || "",
+      code: track.languageCode,
+      isTranslatable: !!track.isTranslatable,
+      url: track.baseUrl
+    }));
+    return this;
   }
-  parseViewCount(text) {
-    const cleaned = text.trim().replace(/,/g, "");
-    const match = cleaned.match(/([\d.]+)\s*([KMB])?/i);
-    if (!match) return null;
-    const num = parseFloat(match[1]);
-    if (isNaN(num)) return null;
-    const suffix = match[2]?.toUpperCase();
-    if (suffix === "K") return Math.round(num * 1e3);
-    if (suffix === "M") return Math.round(num * 1e6);
-    if (suffix === "B") return Math.round(num * 1e9);
-    const result = Math.round(num);
-    return isNaN(result) ? null : result;
+  async get(languageCode, translationLanguageCode) {
+    if (!languageCode) {
+      languageCode = "en";
+    }
+    const lang = this.languages.find((l) => l.code.toUpperCase() === languageCode?.toUpperCase());
+    const url = lang?.url;
+    if (!url) return void 0;
+    let fetchUrl = `${url}&fmt=json3`;
+    if (translationLanguageCode) {
+      fetchUrl += `&tlang=${translationLanguageCode}`;
+    }
+    const response = await this.client.fetch(fetchUrl);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch caption: ${response.status}`);
+    }
+    const json = await response.json();
+    const events = json.events || [];
+    const captions = [];
+    for (const e of events) {
+      if (e.segs === void 0) continue;
+      captions.push(new Caption({
+        duration: e.dDurationMs || 0,
+        start: e.tStartMs || 0,
+        text: e.segs.map((s) => s.utf8).join(""),
+        segments: e.segs
+      }));
+    }
+    return captions;
   }
 };
-// src/playlist-compact.ts
-var PlaylistCompact = class extends Base {
+// src/base-video.ts
+var BaseVideo = class extends Base {
   id;
   title;
+  description;
   thumbnails;
-  videoCount;
+  viewCount;
+  uploadDate;
   channel;
+  channels;
+  isLiveContent;
+  likeCount;
+  tags;
+  formats;
+  adaptiveFormats;
+  streamingData;
+  related;
+  captions;
   constructor(client, data) {
     super(client);
-    let playlistId = "";
-    let titleText = "";
-    let thumbnails = [];
-    let videoCountNum = null;
-    let channelObj = void 0;
-    if (data.playlistId) {
-      playlistId = data.playlistId;
-      titleText = data.title?.simpleText || data.title?.runs?.[0]?.text || "";
-      thumbnails = data.thumbnails?.[0]?.thumbnails || data.thumbnail?.thumbnails || [];
-      if (data.videoCount) {
-        const parsed = parseInt(data.videoCount, 10);
-        videoCountNum = isNaN(parsed) ? null : parsed;
-      } else if (data.videoCountText) {
-        const text = data.videoCountText.runs?.[0]?.text || data.videoCountText.simpleText || "";
-        const cleaned = text.replace(/[^0-9]/g, "");
-        if (cleaned) videoCountNum = parseInt(cleaned, 10);
-      }
-      const byline = data.shortBylineText || data.longBylineText || data.ownerText;
-      if (byline && byline.runs && byline.runs[0]) {
-        const run = byline.runs[0];
-        channelObj = {
-          id: run.navigationEndpoint?.browseEndpoint?.browseId || void 0,
-          name: run.text
-        };
-      }
+    this.id = "";
+    this.title = "";
+    this.description = "";
+    this.thumbnails = new Thumbnails([]);
+    this.viewCount = null;
+    this.uploadDate = null;
+    this.channel = null;
+    this.channels = null;
+    this.isLiveContent = false;
+    this.likeCount = null;
+    this.tags = [];
+    this.formats = [];
+    this.adaptiveFormats = [];
+    this.related = new VideoRelated(client, this);
+    this.captions = null;
+    if (data) {
+      this.parse(data);
     }
-    this.id = playlistId;
-    this.title = titleText;
-    this.thumbnails = new Thumbnails(thumbnails);
-    this.videoCount = videoCountNum;
-    this.channel = channelObj;
   }
-};
-// src/channel-compact.ts
-var ChannelCompact = class extends Base {
-  id;
-  name;
-  thumbnails;
-  subscriberCount;
-  constructor(client, data) {
-    super(client);
-    let channelId = "";
-    let nameText = "";
-    let thumbnails = [];
-    let subCount = null;
-    if (data.channelId) {
-      channelId = data.channelId;
-      nameText = data.title?.simpleText || data.title?.runs?.[0]?.text || "";
-      thumbnails = data.thumbnail?.thumbnails || [];
-      if (data.subscriberCountText) {
-        subCount = data.subscriberCountText.simpleText || data.subscriberCountText.runs?.[0]?.text || null;
-      } else if (data.videoSubscriberCountText) {
-        subCount = data.videoSubscriberCountText.simpleText || data.videoSubscriberCountText.runs?.[0]?.text || null;
+  parse(data) {
+    const videoDetails = data.videoDetails || {};
+    const playerResponse = data.playerResponse || data;
+    const watchResponse = data.response || {};
+    this.id = videoDetails.videoId || playerResponse.videoDetails?.videoId || "";
+    this.title = videoDetails.title || playerResponse.videoDetails?.title || "";
+    this.description = videoDetails.shortDescription || playerResponse.videoDetails?.shortDescription || "";
+    const thumbs = videoDetails.thumbnail?.thumbnails || playerResponse.videoDetails?.thumbnail?.thumbnails || [];
+    this.thumbnails = new Thumbnails(thumbs);
+    this.viewCount = videoDetails.viewCount ? parseInt(videoDetails.viewCount, 10) : playerResponse.videoDetails?.viewCount ? parseInt(playerResponse.videoDetails.viewCount, 10) : null;
+    this.isLiveContent = videoDetails.isLiveContent || playerResponse.videoDetails?.isLiveContent || false;
+    const authorId = videoDetails.channelId || playerResponse.videoDetails?.channelId || "";
+    const authorName = videoDetails.author || playerResponse.videoDetails?.author || "";
+    if (authorId || authorName) {
+      this.channel = new BaseChannel(this.client, {
+        channelId: authorId,
+        title: { simpleText: authorName }
+      });
+    }
+    const watchNextResults = watchResponse.contents?.twoColumnWatchNextResults || data.contents?.twoColumnWatchNextResults;
+    const primaryInfo = watchNextResults?.results?.results?.contents?.find((c) => c.videoPrimaryInfoRenderer)?.videoPrimaryInfoRenderer;
+    if (primaryInfo) {
+      this.uploadDate = primaryInfo.dateText?.simpleText || primaryInfo.dateText?.runs?.[0]?.text || null;
+      const topLevelButtons = primaryInfo.videoActions?.menuRenderer?.topLevelButtons || [];
+      let likeButtonText = "";
+      for (const button of topLevelButtons) {
+        const renderer = button.toggleButtonRenderer || button.buttonRenderer;
+        if (renderer) {
+          const label = renderer.defaultText?.accessibility?.accessibilityData?.accessibilityData || renderer.accessibilityData?.accessibilityData?.label;
+          if (label && label.toLowerCase().includes("like")) {
+            likeButtonText = label;
+            break;
+          }
+        }
       }
+      if (likeButtonText) {
+        this.likeCount = parseInt(likeButtonText.replace(/[^0-9]/g, "") || "0", 10) || null;
+      }
+      const runs = primaryInfo.superTitleLink?.runs || [];
+      this.tags = runs.map((r) => r.text.trim()).filter((t) => t.startsWith("#"));
     }
-    this.id = channelId;
-    this.name = nameText;
-    this.thumbnails = new Thumbnails(thumbnails);
-    this.subscriberCount = subCount;
+    const streamingData = data.streamingData || playerResponse.streamingData;
+    if (streamingData) {
+      this.formats = streamingData.formats || [];
+      this.adaptiveFormats = streamingData.adaptiveFormats || [];
+      const parseFormat = (f) => ({
+        itag: f.itag,
+        url: f.url,
+        mimeType: f.mimeType,
+        bitrate: f.bitrate,
+        width: f.width,
+        height: f.height,
+        hasVideo: !!f.width || f.mimeType?.includes("video/"),
+        hasAudio: !!f.audioBitrate || !!f.audioChannels || f.mimeType?.includes("audio/") || f.mimeType?.includes("video/") && (f.mimeType?.includes("mp4a") || f.mimeType?.includes("opus") || f.mimeType?.includes("vorbis") || f.mimeType?.includes("ec-3")),
+        isLive: this.isLiveContent,
+        contentLength: f.contentLength,
+        quality: f.quality,
+        qualityLabel: f.qualityLabel,
+        audioQuality: f.audioQuality,
+        approxDurationMs: f.approxDurationMs
+      });
+      this.streamingData = {
+        expiresInSeconds: streamingData.expiresInSeconds || "0",
+        formats: this.formats.map(parseFormat),
+        adaptiveFormats: this.adaptiveFormats.map(parseFormat)
+      };
+    }
+    const relatedRes = parseRelatedData(this.client, data);
+    this.related.items = relatedRes.items;
+    this.related.continuation = relatedRes.continuation;
+    const captionTracks = playerResponse.captions?.playerCaptionsTracklistRenderer;
+    if (captionTracks) {
+      this.captions = new VideoCaptions({ video: this, client: this.client }).load(captionTracks);
+    }
+  }
+  get upNext() {
+    return this.related.items[0] || null;
   }
 };
-// src/search-result.ts
-var SearchResult = class _SearchResult extends Continuable {
-  constructor(client, initialData) {
+// src/comment.ts
+var CommentReplies = class extends Continuable {
+  constructor(client, comment) {
     super(client);
-    const { items, continuation } = _SearchResult.parseData(client, initialData);
-    this.items = items;
-    this.continuation = continuation;
+    this.comment = comment;
   }
+  comment;
   async fetch() {
     if (!this.continuation) {
       return { items: [], continuation: null };
     }
-    const data = await this.client.request("search", {
+    const data = await this.client.request("next", {
       continuation: this.continuation
     });
-    return _SearchResult.parseData(this.client, data);
-  }
-  static parseData(client, data) {
     const items = [];
-    let continuation = null;
+    let nextContinuation = null;
+    const mutations = data.frameworkUpdates?.entityBatchUpdate?.mutations || [];
+    for (const mutation of mutations) {
+      const payload = mutation.payload?.commentEntityPayload;
+      if (payload) {
+        items.push(new Comment(this.client, { payload, video: this.comment.video }));
+      }
+    }
     function traverse(obj) {
       if (!obj || typeof obj !== "object") return;
-      if (Array.isArray(obj)) {
-        for (const item of obj) traverse(item);
+      if (obj.continuationCommand && obj.continuationCommand.token) {
+        nextContinuation = obj.continuationCommand.token;
         return;
-      }
-      if (obj.videoRenderer || obj.lockupViewModel && obj.lockupViewModel.contentId && obj.lockupViewModel.contentType === "LOCKUP_CONTENT_TYPE_VIDEO") {
-        items.push(new VideoCompact(client, obj.videoRenderer || obj));
+      } else if (obj.continuationItemRenderer?.continuationEndpoint) {
+        nextContinuation = obj.continuationItemRenderer.continuationEndpoint?.continuationCommand?.token || null;
         return;
       }
-      if (obj.playlistRenderer) {
-        items.push(new PlaylistCompact(client, obj.playlistRenderer));
-        return;
+      for (const key of Object.keys(obj)) {
+        traverse(obj[key]);
       }
-      if (obj.channelRenderer) {
-        items.push(new ChannelCompact(client, obj.channelRenderer));
-        return;
+    }
+    traverse(data);
+    return { items, continuation: nextContinuation };
+  }
+};
+var VideoComments = class extends Continuable {
+  constructor(client, video) {
+    super(client);
+    this.video = video;
+  }
+  video;
+  async fetch() {
+    if (!this.continuation) {
+      return { items: [], continuation: null };
+    }
+    const data = await this.client.request("next", {
+      continuation: this.continuation
+    });
+    const items = [];
+    let nextContinuation = null;
+    const mutations = data.frameworkUpdates?.entityBatchUpdate?.mutations || [];
+    for (const mutation of mutations) {
+      const payload = mutation.payload?.commentEntityPayload;
+      if (payload) {
+        items.push(new Comment(this.client, { payload, video: this.video }));
       }
+    }
+    function traverse(obj) {
+      if (!obj || typeof obj !== "object") return;
       if (obj.continuationCommand && obj.continuationCommand.token) {
-        continuation = obj.continuationCommand.token;
+        nextContinuation = obj.continuationCommand.token;
+        return;
       } else if (obj.continuationItemRenderer?.continuationEndpoint) {
-        continuation = obj.continuationItemRenderer.continuationEndpoint?.continuationCommand?.token || null;
+        nextContinuation = obj.continuationItemRenderer.continuationEndpoint?.continuationCommand?.token || null;
+        return;
       }
       for (const key of Object.keys(obj)) {
         traverse(obj[key]);
       }
     }
     traverse(data);
-    return { items, continuation };
+    return { items, continuation: nextContinuation };
   }
 };
-// src/base-video.ts
-var BaseVideo = class extends Base {
+var Comment = class extends Base {
   id;
-  title;
-  description;
-  thumbnails;
-  viewCount;
+  video;
+  author;
+  content;
   publishDate;
-  channel;
-  isLive;
-  constructor(client, data) {
+  likeCount;
+  isAuthorChannelOwner;
+  isPinned;
+  replyCount;
+  replies;
+  constructor(client, options) {
     super(client);
+    this.video = options.video;
     this.id = "";
-    this.title = "";
-    this.description = "";
-    this.thumbnails = new Thumbnails([]);
-    this.viewCount = null;
-    this.publishDate = null;
-    this.isLive = false;
-    this.parse(data);
+    this.content = "";
+    this.publishDate = "";
+    this.likeCount = 0;
+    this.isAuthorChannelOwner = false;
+    this.isPinned = false;
+    this.replyCount = 0;
+    this.author = new BaseChannel(client);
+    this.replies = new CommentReplies(client, this);
+    this.load(options.payload);
   }
-  parse(data) {
-    const videoDetails = data.videoDetails || data.microformat?.playerMicroformatRenderer || {};
-    this.id = videoDetails.videoId || "";
-    this.title = typeof videoDetails.title === "string" ? videoDetails.title : videoDetails.title?.simpleText || videoDetails.title?.runs?.[0]?.text || "";
-    this.description = videoDetails.shortDescription || videoDetails.description?.simpleText || videoDetails.description?.runs?.map((r) => r.text).join("") || "";
-    this.thumbnails = new Thumbnails(videoDetails.thumbnail?.thumbnails || []);
-    this.viewCount = videoDetails.viewCount ? parseInt(videoDetails.viewCount, 10) : null;
-    this.isLive = videoDetails.isLiveContent || false;
-    this.publishDate = videoDetails.publishDate || null;
-    this.channel = {
-      name: videoDetails.author || videoDetails.ownerChannelName || "",
-      id: videoDetails.channelId || videoDetails.externalChannelId || ""
-    };
+  load(payload) {
+    const props = payload.properties || {};
+    const toolbar = payload.toolbar || {};
+    const authorInfo = payload.author || {};
+    const avatar = payload.avatar || {};
+    this.id = props.commentId || payload.commentId || "";
+    this.content = props.content?.content || payload.contentText?.simpleText || payload.contentText?.runs?.map((r) => r.text).join("") || "";
+    this.publishDate = props.publishedTime || payload.publishedTimeText?.simpleText || "";
+    this.isAuthorChannelOwner = !!authorInfo.isCreator || !!payload.authorIsCreator;
+    this.isPinned = !!payload.pinned;
+    const likeStr = toolbar.likeCountLiked || toolbar.likeCountNotliked || payload.voteCount?.simpleText || "0";
+    this.likeCount = parseInt(String(likeStr).replace(/[^0-9]/g, "") || "0", 10);
+    const replyStr = toolbar.replyCount || payload.replyCount || "0";
+    this.replyCount = parseInt(String(replyStr).replace(/[^0-9]/g, "") || "0", 10);
+    const authorId = authorInfo.id || payload.authorEndpoint?.browseEndpoint?.browseId || "";
+    const authorName = authorInfo.displayName || payload.authorText?.simpleText || payload.authorText?.runs?.[0]?.text || "";
+    const thumbs = avatar.image?.sources || payload.authorThumbnail?.thumbnails || [];
+    this.author = new BaseChannel(this.client, {
+      channelId: authorId,
+      title: { simpleText: authorName },
+      thumbnail: { thumbnails: thumbs }
+    });
+    return this;
+  }
+  get url() {
+    return `https://www.youtube.com/watch?v=${this.video.id}&lc=${this.id}`;
   }
 };
 // src/video.ts
 var Video = class extends BaseVideo {
-  // We will expand this with related videos, comments pagination, and chapters in Sprints 3 & 4.
+  duration;
+  chapters;
+  comments;
+  music;
   constructor(client, data) {
-    super(client, data);
+    super(client);
+    this.duration = 0;
+    this.chapters = [];
+    this.music = null;
+    this.comments = new VideoComments(client, this);
+    this.load(data);
+  }
+  load(data) {
+    super.parse(data);
+    const videoDetails = data.videoDetails || data.playerResponse?.videoDetails || {};
+    this.duration = parseInt(videoDetails.lengthSeconds || "0", 10);
+    this.chapters = [];
+    const markersMap = data.response?.playerOverlays?.playerOverlayRenderer?.decoratedPlayerBarRenderer?.decoratedPlayerBarRenderer?.playerBar?.multiMarkersPlayerBarRenderer?.markersMap;
+    const chaptersList = markersMap?.[0]?.value?.chapters || [];
+    for (const chap of chaptersList) {
+      const renderer = chap.chapterRenderer;
+      if (renderer) {
+        this.chapters.push({
+          title: renderer.title?.simpleText || renderer.title?.runs?.[0]?.text || "",
+          start: renderer.timeRangeStartMillis || 0,
+          thumbnails: new Thumbnails(renderer.thumbnail?.thumbnails || [])
+        });
+      }
+    }
+    this.music = null;
+    const panels = data.response?.engagementPanels || [];
+    const structuredPanel = panels.find((p) => p.engagementPanelSectionListRenderer?.content?.structuredDescriptionContentRenderer);
+    const descriptionItems = structuredPanel?.engagementPanelSectionListRenderer?.content?.structuredDescriptionContentRenderer?.items || [];
+    const musicItem = descriptionItems.find((i) => i.horizontalCardListRenderer?.footerButton?.buttonViewModel?.iconName === "MUSIC" || i.horizontalCardListRenderer?.cards?.some((c) => c.videoAttributeViewModel));
+    if (musicItem) {
+      const card = musicItem.horizontalCardListRenderer?.cards?.find((c) => c.videoAttributeViewModel)?.videoAttributeViewModel;
+      if (card) {
+        this.music = {
+          imageUrl: card.image?.sources?.[0]?.url || "",
+          title: card.title || "",
+          artist: card.subtitle || "",
+          album: card.secondarySubtitle?.content || null
+        };
+      }
+    }
+    const watchNextResults = data.response?.contents?.twoColumnWatchNextResults || data.contents?.twoColumnWatchNextResults;
+    const contents = watchNextResults?.results?.results?.contents || [];
+    let commentToken = null;
+    for (const content of contents) {
+      const itemSection = content.itemSectionRenderer;
+      if (itemSection?.contents) {
+        for (const item of itemSection.contents) {
+          if (item.continuationItemRenderer?.continuationEndpoint?.continuationCommand?.token) {
+            commentToken = item.continuationItemRenderer.continuationEndpoint.continuationCommand.token;
+            break;
+          }
+          if (item.commentsEntryPointHeaderRenderer?.content?.commentsEntryPointHeaderRenderer?.headerText?.runs?.[0]?.navigationEndpoint?.continuationCommand?.token) {
+            commentToken = item.commentsEntryPointHeaderRenderer.content.commentsEntryPointHeaderRenderer.headerText.runs[0].navigationEndpoint.continuationCommand.token;
+            break;
+          }
+        }
+      }
+      if (commentToken) break;
+    }
+    if (!commentToken) {
+      for (const panel of panels) {
+        const token = panel.engagementPanelSectionListRenderer?.content?.sectionListRenderer?.contents?.[0]?.itemSectionRenderer?.contents?.[0]?.continuationItemRenderer?.continuationEndpoint?.continuationCommand?.token;
+        if (token) {
+          commentToken = token;
+          break;
+        }
+      }
+    }
+    this.comments.continuation = commentToken;
+    return this;
   }
 };
@@ -867,18 +1179,293 @@ var Playlist = class extends Base {
   }
 };
+// src/channel.ts
+var Channel = class extends BaseChannel {
+  videoCount;
+  banner;
+  mobileBanner;
+  tvBanner;
+  shelves;
+  constructor(client, data) {
+    super(client, data);
+    this.banner = new Thumbnails([]);
+    this.mobileBanner = new Thumbnails([]);
+    this.tvBanner = new Thumbnails([]);
+    this.shelves = [];
+    if (data) {
+      this.load(data);
+    }
+  }
+  load(data) {
+    super.load(data);
+    const headerObj = data.header?.c4TabbedHeaderRenderer || data.header?.pageHeaderRenderer || data.c4TabbedHeaderRenderer || data;
+    const viewModel = headerObj.content?.pageHeaderViewModel;
+    if (viewModel) {
+      this.banner = new Thumbnails(viewModel.banner?.imageBannerViewModel?.image?.sources || []);
+      this.handle = viewModel.metadata?.contentMetadataViewModel?.metadataRows?.[0]?.metadataParts?.[0]?.text?.content || this.handle;
+      this.description = viewModel.description?.descriptionPreviewViewModel?.description?.content || this.description;
+      const rows = viewModel.metadata?.contentMetadataViewModel?.metadataRows || [];
+      for (const row of rows) {
+        for (const part of row.metadataParts || []) {
+          const txt = part.text?.content || "";
+          if (txt.includes("video")) {
+            this.videoCount = txt;
+          }
+        }
+      }
+    }
+    if (headerObj.channelId) {
+      this.videoCount = headerObj.videosCountText?.runs?.[0]?.text || headerObj.videosCountText?.simpleText || this.videoCount;
+      this.banner = new Thumbnails(headerObj.banner?.thumbnails || []);
+      this.tvBanner = new Thumbnails(headerObj.tvBanner?.thumbnails || []);
+      this.mobileBanner = new Thumbnails(headerObj.mobileBanner?.thumbnails || []);
+    }
+    this.shelves = [];
+    const tabs = data.contents?.twoColumnBrowseResultsRenderer?.tabs || [];
+    const homeTab = tabs.find((t) => t.tabRenderer?.selected || t.tabRenderer?.title?.toLowerCase() === "home");
+    const sectionList = homeTab?.tabRenderer?.content?.sectionListRenderer?.contents || [];
+    for (const section of sectionList) {
+      const shelf = section.itemSectionRenderer?.contents?.[0]?.shelfRenderer;
+      if (shelf) {
+        const title = shelf.title?.simpleText || shelf.title?.runs?.[0]?.text || "";
+        const subtitle = shelf.subtitle?.simpleText || shelf.subtitle?.runs?.[0]?.text || void 0;
+        const items = [];
+        const gridItems = shelf.content?.horizontalListRenderer?.items || shelf.content?.gridRenderer?.items || [];
+        for (const item of gridItems) {
+          if (item.gridVideoRenderer) {
+            items.push(item.gridVideoRenderer);
+          } else if (item.gridPlaylistRenderer) {
+            items.push(item.gridPlaylistRenderer);
+          } else if (item.gridChannelRenderer) {
+            items.push(item.gridChannelRenderer);
+          }
+        }
+        this.shelves.push({ title, subtitle, items });
+      }
+    }
+    return this;
+  }
+};
+// src/mix-playlist.ts
+var MixPlaylist = class extends Base {
+  id;
+  title;
+  videoCount;
+  videos;
+  constructor(client, data) {
+    super(client);
+    this.id = "";
+    this.title = "";
+    this.videoCount = 0;
+    this.videos = [];
+    if (data) {
+      this.load(data);
+    }
+  }
+  load(data) {
+    const playlist = data.contents?.twoColumnWatchNextResults?.playlist?.playlist || {};
+    this.title = playlist.titleText?.simpleText || playlist.title || "";
+    this.id = playlist.playlistId || "";
+    const contents = playlist.contents || [];
+    this.videos = [];
+    for (const item of contents) {
+      const renderer = item.playlistPanelVideoRenderer;
+      if (renderer) {
+        this.videos.push(new VideoCompact(this.client, renderer));
+      }
+    }
+    this.videoCount = this.videos.length;
+    return this;
+  }
+};
+// src/chat.ts
+var Chat = class extends Base {
+  id;
+  message;
+  author;
+  timestamp;
+  constructor(client, data) {
+    super(client);
+    if (data) {
+      this.load(data);
+    }
+  }
+  load(data) {
+    const { id, message, authorName, authorPhoto, timestampUsec, authorExternalChannelId } = data;
+    this.id = id;
+    this.message = message?.runs?.map((r) => r.text).join("") || "";
+    this.timestamp = parseInt(timestampUsec || "0", 10);
+    this.author = new BaseChannel(this.client, {
+      channelId: authorExternalChannelId,
+      title: { simpleText: authorName },
+      thumbnail: { thumbnails: authorPhoto }
+    });
+    return this;
+  }
+};
+// src/live-video.ts
+var LiveVideo = class extends BaseVideo {
+  watchingCount = 0;
+  chatContinuation = "";
+  delay = 0;
+  chatRequestPoolingTimeout = null;
+  timeoutMs = 0;
+  isChatPlaying = false;
+  chatQueue = /* @__PURE__ */ new Set();
+  pollSessionId = 0;
+  listeners = {};
+  constructor(client, data) {
+    super(client, data);
+    if (data) {
+      this.load(data);
+    }
+  }
+  on(event, listener) {
+    if (!this.listeners[event]) {
+      this.listeners[event] = [];
+    }
+    this.listeners[event].push(listener);
+    return this;
+  }
+  emit(event, ...args) {
+    const list = this.listeners[event];
+    if (!list || list.length === 0) return false;
+    for (const listener of list) {
+      listener(...args);
+    }
+    return true;
+  }
+  load(data) {
+    super.parse(data);
+    const videoDetails = data.videoDetails || {};
+    const runText = data.response?.contents?.twoColumnWatchNextResults?.results?.results?.contents?.[0]?.videoPrimaryInfoRenderer?.viewCount?.videoViewCountRenderer?.viewCount?.runs?.map((r) => r.text).join(" ");
+    const countStr = runText || videoDetails.viewCount || "0";
+    this.watchingCount = parseInt(String(countStr).replace(/[^0-9]/g, "") || "0", 10);
+    this.chatContinuation = data.response?.contents?.twoColumnWatchNextResults?.conversationBar?.liveChatRenderer?.continuations?.[0]?.reloadContinuationData?.continuation || "";
+    return this;
+  }
+  playChat(delay = 0) {
+    if (this.isChatPlaying) return;
+    this.delay = delay;
+    this.isChatPlaying = true;
+    const sessionId = ++this.pollSessionId;
+    this.pollChatContinuation(sessionId);
+  }
+  stopChat() {
+    this.isChatPlaying = false;
+    this.pollSessionId++;
+    if (this.chatRequestPoolingTimeout) {
+      clearTimeout(this.chatRequestPoolingTimeout);
+      this.chatRequestPoolingTimeout = null;
+    }
+  }
+  async pollChatContinuation(sessionId) {
+    if (!this.isChatPlaying || !this.chatContinuation || sessionId !== this.pollSessionId) return;
+    try {
+      const response = await this.client.request("live_chat/get_live_chat", {
+        continuation: this.chatContinuation
+      });
+      if (!response?.continuationContents?.liveChatContinuation || sessionId !== this.pollSessionId) return;
+      const chatCont = response.continuationContents.liveChatContinuation;
+      const actions = chatCont.actions || [];
+      for (const action of actions) {
+        const item = action.addChatItemAction?.item?.liveChatTextMessageRenderer;
+        if (item) {
+          const chat = new Chat(this.client).load(item);
+          if (this.chatQueue.has(chat.id)) continue;
+          this.chatQueue.add(chat.id);
+          if (this.chatQueue.size > 500) {
+            const firstKey = this.chatQueue.keys().next().value;
+            if (firstKey !== void 0) {
+              this.chatQueue.delete(firstKey);
+            }
+          }
+          const timeout = chat.timestamp / 1e3 - (Date.now() - this.delay);
+          setTimeout(() => {
+            if (sessionId === this.pollSessionId) {
+              this.emit("chat", chat);
+            }
+          }, Math.max(0, timeout));
+        }
+      }
+      const continuation = chatCont.continuations?.[0];
+      const continuationData = continuation?.timedContinuationData || continuation?.invalidationContinuationData;
+      if (continuationData && sessionId === this.pollSessionId) {
+        this.timeoutMs = continuationData.timeoutMs || 5e3;
+        this.chatContinuation = continuationData.continuation;
+        this.chatRequestPoolingTimeout = setTimeout(() => this.pollChatContinuation(sessionId), this.timeoutMs);
+      }
+    } catch (e) {
+      console.error("[LiveVideo] Error polling live chat:", e);
+      if (sessionId === this.pollSessionId) {
+        this.chatRequestPoolingTimeout = setTimeout(() => this.pollChatContinuation(sessionId), 5e3);
+      }
+    }
+  }
+};
 // src/client.ts
-function getFallbackClientVersion2() {
+var CLIENT_PROFILES = [
+  {
+    name: "ios",
+    clientName: "IOS",
+    clientVersion: "20.10.4",
+    clientNameHeader: "5",
+    userAgent: "com.google.ios.youtube/20.10.4 (iPhone16,2; U; CPU iOS 18_3_2 like Mac OS X;)",
+    context: {
+      deviceMake: "Apple",
+      deviceModel: "iPhone16,2",
+      platform: "MOBILE",
+      osName: "iOS",
+      osVersion: "18.3.2.22D82"
+    }
+  },
+  {
+    name: "android_vr",
+    clientName: "ANDROID_VR",
+    clientVersion: "1.62.20",
+    clientNameHeader: "28",
+    userAgent: "com.google.android.apps.youtube.vr.oculus/1.62.20 (Linux; U; Android 12L; eureka-user Build/SQ3A.220605.009.A1) gzip",
+    context: {
+      deviceMake: "Oculus",
+      deviceModel: "Quest 3",
+      platform: "MOBILE",
+      osName: "Android",
+      osVersion: "12L",
+      androidSdkVersion: 32
+    }
+  },
+  {
+    name: "mweb",
+    clientName: "MWEB",
+    clientVersion: "2.20251209.01.00",
+    clientNameHeader: "2",
+    userAgent: "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1",
+    context: {
+      platform: "MOBILE",
+      osName: "iOS",
+      osVersion: "17.5.1"
+    }
+  }
+];
+function getFallbackClientVersion() {
   const d = /* @__PURE__ */ new Date();
   d.setDate(d.getDate() - 2);
   const yyyymmdd = d.toISOString().split("T")[0].replace(/-/g, "");
   return `2.${yyyymmdd}.00.00`;
 }
 function getSapisidFromCookieString(cookieString) {
+  if (!cookieString && typeof document !== "undefined") {
+    cookieString = document.cookie;
+  }
+  if (!cookieString) return null;
   const match = cookieString.match(/__Secure-3PAPISID=([^;]+)/) || cookieString.match(/__Secure-1PAPISID=([^;]+)/) || cookieString.match(/SAPISID=([^;]+)/);
   return match ? match[1] : null;
 }
-async function getSApiSidHash2(sapisid, origin = "https://www.youtube.com") {
+async function getSApiSidHash(sapisid, origin = "https://www.youtube.com") {
   if (!sapisid) return null;
   try {
     const timestamp = Math.floor(Date.now() / 1e3);
@@ -893,13 +1480,47 @@ async function getSApiSidHash2(sapisid, origin = "https://www.youtube.com") {
     return null;
   }
 }
+var cachedApiKey = null;
+var cachedClientVersion = null;
+var cachedIdToken = null;
+async function getInnerTubeConfig(injectedConfig, customFetch) {
+  if (injectedConfig && injectedConfig.apiKey) {
+    return {
+      apiKey: injectedConfig.apiKey,
+      clientVersion: injectedConfig.clientVersion || getFallbackClientVersion(),
+      idToken: injectedConfig.idToken ?? null
+    };
+  }
+  if (cachedApiKey && cachedClientVersion) {
+    return { apiKey: cachedApiKey, clientVersion: cachedClientVersion, idToken: cachedIdToken };
+  }
+  try {
+    const fetchFn = customFetch || (typeof globalThis !== "undefined" ? globalThis.fetch : fetch);
+    const response = await fetchFn("https://www.youtube.com", { credentials: "include" });
+    const html = await response.text();
+    const apiKeyMatch = html.match(/"INNERTUBE_API_KEY":"([^"]+)"/);
+    const clientVersionMatch = html.match(/"INNERTUBE_CLIENT_VERSION":"([^"]+)"/);
+    const idTokenMatch = html.match(/"ID_TOKEN":"([^"]+)"/);
+    if (apiKeyMatch && apiKeyMatch[1]) cachedApiKey = apiKeyMatch[1];
+    if (clientVersionMatch && clientVersionMatch[1]) cachedClientVersion = clientVersionMatch[1];
+    if (idTokenMatch && idTokenMatch[1]) cachedIdToken = idTokenMatch[1];
+  } catch (e) {
+    console.warn("[Client] Failed to extract InnerTube config from HTML", e);
+  }
+  if (!cachedClientVersion) cachedClientVersion = getFallbackClientVersion();
+  return { apiKey: cachedApiKey, clientVersion: cachedClientVersion, idToken: cachedIdToken };
+}
 var Client = class {
   apiKey = null;
   clientVersion = "";
   idToken = null;
   cookie = "";
+  fetch;
+  cache;
   constructor(options = {}) {
     this.cookie = options.cookie !== void 0 ? options.cookie : "";
+    this.fetch = options.fetch || (typeof globalThis !== "undefined" ? globalThis.fetch : fetch);
+    this.cache = options.cache;
     let resolvedApiKey = options.apiKey !== void 0 ? options.apiKey : null;
     let resolvedClientVersion = options.clientVersion !== void 0 ? options.clientVersion : null;
     let resolvedIdToken = options.idToken !== void 0 ? options.idToken : null;
@@ -915,114 +1536,550 @@ var Client = class {
         if (resolvedIdToken === null) resolvedIdToken = ytcfg.ID_TOKEN || null;
       }
     }
-    this.apiKey = resolvedApiKey;
-    this.clientVersion = resolvedClientVersion || getFallbackClientVersion2();
-    this.idToken = resolvedIdToken;
-  }
-  /**
-   * Asynchronously resolves config parameters if apiKey is not set yet.
-   * Fetches and parses YouTube's home page HTML using the scraper logic.
-   */
-  async ensureConfig() {
-    if (this.apiKey) {
-      return;
-    }
-    const config = await getInnerTubeConfig();
-    this.apiKey = config.apiKey;
-    if (config.clientVersion) {
-      this.clientVersion = config.clientVersion;
-    }
-    this.idToken = config.idToken;
+    this.apiKey = resolvedApiKey;
+    this.clientVersion = resolvedClientVersion || getFallbackClientVersion();
+    this.idToken = resolvedIdToken;
+  }
+  async ensureConfig() {
+    if (this.apiKey) return;
+    const config = await getInnerTubeConfig(null, this.fetch);
+    this.apiKey = config.apiKey;
+    if (config.clientVersion) this.clientVersion = config.clientVersion;
+    this.idToken = config.idToken;
+  }
+  /**
+   * Standard InnerTube request using the WEB client (useful for authenticated endpoints).
+   */
+  async request(endpoint, payload) {
+    await this.ensureConfig();
+    if (!this.apiKey) {
+      throw new Error("[Client] InnerTube API key is not configured.");
+    }
+    const cleanEndpoint = endpoint.startsWith("/") ? endpoint.slice(1) : endpoint;
+    const url = `https://www.youtube.com/youtubei/v1/${cleanEndpoint}?key=${this.apiKey}&prettyPrint=false`;
+    const headers = {
+      "Content-Type": "application/json",
+      "X-Youtube-Client-Name": "1",
+      "X-Youtube-Client-Version": this.clientVersion
+    };
+    if (this.idToken) headers["X-Youtube-Identity-Token"] = this.idToken;
+    const activeCookie = this.cookie || (typeof document !== "undefined" ? document.cookie : "");
+    if (activeCookie) {
+      headers["Cookie"] = activeCookie;
+      const sapisid = getSapisidFromCookieString(activeCookie);
+      if (sapisid) {
+        const authHash = await getSApiSidHash(sapisid, "https://www.youtube.com");
+        if (authHash) headers["Authorization"] = `SAPISIDHASH ${authHash}`;
+      }
+    }
+    const bodyPayload = payload && typeof payload === "object" ? payload : {};
+    const requestBody = {
+      ...bodyPayload,
+      context: {
+        ...bodyPayload.context,
+        client: {
+          clientName: "WEB",
+          clientVersion: this.clientVersion,
+          hl: "en",
+          gl: "US",
+          ...bodyPayload.context?.client
+        }
+      }
+    };
+    const authContext = this.idToken ? "_auth" : "_anon";
+    const cacheKey = `yt_request_${cleanEndpoint}_${JSON.stringify(bodyPayload)}${authContext}`;
+    if (this.cache) {
+      const cached = await this.cache.get(cacheKey);
+      if (cached) return cached;
+    }
+    const response = await this.fetch(url, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(requestBody),
+      credentials: "include"
+    });
+    if (!response.ok) {
+      throw new Error(`InnerTube request failed with status: ${response.status}`);
+    }
+    const data = await response.json();
+    if (this.cache) {
+      await this.cache.set(cacheKey, data);
+    }
+    return data;
+  }
+  /**
+   * Specialized request for the /player endpoint that loops through client profiles
+   * to bypass IP blocks or Captcha walls.
+   */
+  async requestPlayerWithFallback(videoId) {
+    await this.ensureConfig();
+    const authContext = this.idToken ? "_auth" : "_anon";
+    const cacheKey = `yt_player_fallback_${videoId}${authContext}`;
+    if (this.cache) {
+      const cached = await this.cache.get(cacheKey);
+      if (cached) return cached;
+    }
+    const url = `https://www.youtube.com/youtubei/v1/player?key=${this.apiKey}&prettyPrint=false`;
+    let firstPlayable = null;
+    const failures = [];
+    for (const profile of CLIENT_PROFILES) {
+      try {
+        const body = {
+          videoId,
+          context: {
+            client: {
+              clientName: profile.clientName,
+              clientVersion: profile.clientVersion,
+              hl: "en",
+              gl: "US",
+              ...profile.context
+            },
+            user: { lockedSafetyMode: false },
+            request: { useSsl: true }
+          },
+          contentCheckOk: true,
+          racyCheckOk: true
+        };
+        const headers = {
+          "Content-Type": "application/json",
+          "User-Agent": profile.userAgent,
+          "X-YouTube-Client-Name": profile.clientNameHeader,
+          "X-YouTube-Client-Version": profile.clientVersion,
+          "Origin": "https://www.youtube.com"
+        };
+        if (this.idToken) headers["X-Youtube-Identity-Token"] = this.idToken;
+        const activeCookie = this.cookie || (typeof document !== "undefined" ? document.cookie : "");
+        if (activeCookie) {
+          headers["Cookie"] = activeCookie;
+          const sapisid = getSapisidFromCookieString(activeCookie);
+          if (sapisid) {
+            const authHash = await getSApiSidHash(sapisid, "https://www.youtube.com");
+            if (authHash) headers["Authorization"] = `SAPISIDHASH ${authHash}`;
+          }
+        }
+        const response = await this.fetch(url, {
+          method: "POST",
+          headers,
+          body: JSON.stringify(body),
+          credentials: "include"
+        });
+        if (!response.ok) {
+          failures.push(`${profile.name}: ${response.status}`);
+          continue;
+        }
+        const data = await response.json();
+        const status = data.playabilityStatus?.status;
+        if (status && status !== "OK") {
+          const reason = data.playabilityStatus?.reason;
+          failures.push(`${profile.name}: ${status}${reason ? ` - ${reason}` : ""}`);
+          continue;
+        }
+        if (!firstPlayable) firstPlayable = data;
+        const tracks = data.captions?.playerCaptionsTracklistRenderer?.captionTracks;
+        if (tracks && tracks.length > 0) {
+          if (this.cache) await this.cache.set(cacheKey, data);
+          return data;
+        }
+        failures.push(`${profile.name}: OK but no caption tracks`);
+      } catch (err) {
+        failures.push(`${profile.name}: ${err.message}`);
+      }
+    }
+    if (firstPlayable) {
+      if (this.cache) await this.cache.set(cacheKey, firstPlayable);
+      return firstPlayable;
+    }
+    console.warn(`[Client] All mobile profiles failed, falling back to WEB profile. Attempts:
+${failures.join("\n")}`);
+    return this.request("player", { videoId, contentCheckOk: true, racyCheckOk: true });
+  }
+  async search(query, options) {
+    const payload = { query };
+    if (options?.type === "video") payload.params = "EgIQAQ%3D%3D";
+    else if (options?.type === "playlist") payload.params = "EgIQAw%3D%3D";
+    else if (options?.type === "channel") payload.params = "EgIQAg%3D%3D";
+    const data = await this.request("search", payload);
+    return new SearchResult(this, data);
+  }
+  async findOne(query, options) {
+    const result = await this.search(query, options);
+    return result.items[0] || void 0;
+  }
+  async getVideo(videoId) {
+    const [playerData, nextData] = await Promise.all([
+      this.requestPlayerWithFallback(videoId),
+      this.request("next", { videoId })
+    ]);
+    const merged = { ...playerData, ...nextData };
+    if (playerData.playabilityStatus?.liveStreamability) {
+      return new LiveVideo(this, merged);
+    }
+    return new Video(this, merged);
+  }
+  async getPlaylist(playlistId) {
+    if (playlistId.startsWith("RD")) {
+      const data2 = await this.request("next", { playlistId });
+      return new MixPlaylist(this, data2);
+    }
+    const browseId = playlistId.startsWith("VL") ? playlistId : `VL${playlistId}`;
+    const data = await this.request("browse", { browseId });
+    return new Playlist(this, data);
+  }
+  async getChannel(channelId) {
+    const data = await this.request("browse", { browseId: channelId });
+    if (data.error) return void 0;
+    return new Channel(this, data);
+  }
+  async getVideoTranscript(videoId, languageCode) {
+    const video = await this.getVideo(videoId);
+    return video.captions?.get(languageCode);
+  }
+};
+// src/scraper.ts
+async function fetchYtInitialData(url) {
+  try {
+    console.log(`[Scraper] Fetching HTML from ${url}`);
+    const response = await fetch(url, { credentials: "include" });
+    const text = await response.text();
+    const patterns = [
+      /var ytInitialData\s*=\s*(\{.*?\});<\/script>/,
+      /window\["ytInitialData"\]\s*=\s*(\{.*?\});/
+    ];
+    for (const regex of patterns) {
+      const match = text.match(regex);
+      if (match && match[1]) {
+        return JSON.parse(match[1]);
+      }
+    }
+    console.warn(`[Scraper] Could not find ytInitialData in ${url}`);
+  } catch (e) {
+    console.error(`[Scraper] Failed to fetch data from ${url}`, e);
+  }
+  return null;
+}
+function getSapisidFromCookie() {
+  return getSapisidFromCookieString("");
+}
+function extractVideoEntries(data) {
+  const entries = [];
+  const seenTitles = /* @__PURE__ */ new Set();
+  function recurse(obj) {
+    if (!obj || typeof obj !== "object") return;
+    if (Array.isArray(obj)) {
+      for (let i = 0; i < obj.length; i++) {
+        recurse(obj[i]);
+      }
+      return;
+    }
+    if (obj.videoId && obj.title) {
+      let title = "";
+      if (typeof obj.title === "string") {
+        title = obj.title;
+      } else if (obj.title.runs && obj.title.runs[0] && obj.title.runs[0].text) {
+        title = obj.title.runs[0].text;
+      } else if (obj.title.simpleText) {
+        title = obj.title.simpleText;
+      }
+      title = title.trim();
+      if (title && title.length > 2 && title !== "Skip navigation") {
+        if (!seenTitles.has(title)) {
+          seenTitles.add(title);
+          let channel = "";
+          const byline = obj.longBylineText || obj.shortBylineText || obj.ownerText;
+          if (byline) {
+            if (typeof byline === "string") {
+              channel = byline;
+            } else if (byline.runs && byline.runs[0] && byline.runs[0].text) {
+              channel = byline.runs[0].text;
+            } else if (byline.simpleText) {
+              channel = byline.simpleText;
+            }
+          }
+          entries.push({
+            title,
+            channel: channel.split("\n")[0].replace(/•/g, "").trim()
+          });
+        }
+      }
+      return;
+    }
+    if (obj.lockupViewModel && obj.lockupViewModel.contentId && obj.lockupViewModel.contentType === "LOCKUP_CONTENT_TYPE_VIDEO") {
+      const model = obj.lockupViewModel;
+      const meta = model.metadata?.lockupMetadataViewModel;
+      if (meta && meta.title && meta.title.content) {
+        const title = meta.title.content.trim();
+        if (title && !seenTitles.has(title)) {
+          seenTitles.add(title);
+          let channel = "";
+          const rows = meta.metadata?.contentMetadataViewModel?.metadataRows;
+          if (rows && rows[0] && rows[0].metadataParts && rows[0].metadataParts[0] && rows[0].metadataParts[0].text) {
+            channel = rows[0].metadataParts[0].text.content || "";
+          }
+          entries.push({
+            title,
+            channel: channel.split("\n")[0].replace(/•/g, "").trim()
+          });
+        }
+      }
+      return;
+    }
+    for (const key in obj) {
+      if (Object.prototype.hasOwnProperty.call(obj, key)) {
+        recurse(obj[key]);
+      }
+    }
+  }
+  try {
+    recurse(data);
+  } catch (e) {
+    console.warn("[Scraper] Error extracting video entries recursively", e);
+  }
+  return entries;
+}
+function findContinuationToken(obj) {
+  if (!obj || typeof obj !== "object") return null;
+  if (obj.continuationCommand && obj.continuationCommand.token) {
+    return obj.continuationCommand.token;
+  }
+  for (const key in obj) {
+    if (Object.prototype.hasOwnProperty.call(obj, key)) {
+      const token = findContinuationToken(obj[key]);
+      if (token) return token;
+    }
+  }
+  return null;
+}
+async function fetchInnerTubeContinuation(apiKey, clientVersion, idToken, initialToken, limit) {
+  const entries = [];
+  let continuationToken = initialToken;
+  try {
+    while (continuationToken && entries.length < limit) {
+      const headers = {
+        "Content-Type": "application/json",
+        "X-Youtube-Client-Name": "1",
+        "X-Youtube-Client-Version": clientVersion
+      };
+      if (idToken) {
+        headers["X-Youtube-Identity-Token"] = idToken;
+      }
+      const sapisid = getSapisidFromCookie();
+      if (sapisid) {
+        const authHash = await getSApiSidHash(sapisid, "https://www.youtube.com");
+        if (authHash) {
+          headers["Authorization"] = `SAPISIDHASH ${authHash}`;
+        }
+      }
+      const response = await fetch(`https://www.youtube.com/youtubei/v1/browse?key=${apiKey}&prettyPrint=false`, {
+        method: "POST",
+        headers,
+        credentials: "include",
+        body: JSON.stringify({
+          context: {
+            client: {
+              clientName: "WEB",
+              clientVersion,
+              hl: "en",
+              gl: "US"
+            }
+          },
+          continuation: continuationToken
+        })
+      });
+      if (!response.ok) break;
+      const data = await response.json();
+      const pageEntries = extractVideoEntries(data);
+      entries.push(...pageEntries);
+      continuationToken = findContinuationToken(data);
+    }
+  } catch (e) {
+    console.error("[Scraper] Error in InnerTube pagination", e);
   }
-  /**
-   * Dispatches an authenticated or unauthenticated POST request to the specified InnerTube endpoint.
-   */
-  async request(endpoint, payload) {
-    await this.ensureConfig();
-    if (!this.apiKey) {
-      throw new Error("[Client] InnerTube API key is not configured.");
-    }
-    const cleanEndpoint = endpoint.startsWith("/") ? endpoint.slice(1) : endpoint;
-    const url = `https://www.youtube.com/youtubei/v1/${cleanEndpoint}?key=${this.apiKey}&prettyPrint=false`;
+  return entries;
+}
+async function fetchInnerTubeFeed(apiKey, clientVersion, idToken, browseId, limit = 500) {
+  const entries = [];
+  try {
     const headers = {
       "Content-Type": "application/json",
       "X-Youtube-Client-Name": "1",
-      "X-Youtube-Client-Version": this.clientVersion
+      "X-Youtube-Client-Version": clientVersion
     };
-    if (this.idToken) {
-      headers["X-Youtube-Identity-Token"] = this.idToken;
+    if (idToken) {
+      headers["X-Youtube-Identity-Token"] = idToken;
     }
-    const activeCookie = this.cookie || (typeof document !== "undefined" ? document.cookie : "");
-    if (activeCookie) {
-      headers["Cookie"] = activeCookie;
-      const sapisid = getSapisidFromCookieString(activeCookie);
-      if (sapisid) {
-        const authHash = await getSApiSidHash2(sapisid, "https://www.youtube.com");
-        if (authHash) {
-          headers["Authorization"] = `SAPISIDHASH ${authHash}`;
-        }
+    const sapisid = getSapisidFromCookie();
+    if (sapisid) {
+      const authHash = await getSApiSidHash(sapisid, "https://www.youtube.com");
+      if (authHash) {
+        headers["Authorization"] = `SAPISIDHASH ${authHash}`;
       }
     }
-    const bodyPayload = payload && typeof payload === "object" ? payload : {};
-    const requestBody = {
-      ...bodyPayload,
-      context: {
-        ...bodyPayload.context,
-        client: {
-          clientName: "WEB",
-          clientVersion: this.clientVersion,
-          hl: "en",
-          gl: "US",
-          ...bodyPayload.context?.client
-        }
-      }
-    };
-    const response = await fetch(url, {
+    const response = await fetch(`https://www.youtube.com/youtubei/v1/browse?key=${apiKey}&prettyPrint=false`, {
       method: "POST",
       headers,
-      body: JSON.stringify(requestBody),
-      credentials: "include"
+      credentials: "include",
+      body: JSON.stringify({
+        context: {
+          client: {
+            clientName: "WEB",
+            clientVersion,
+            hl: "en",
+            gl: "US"
+          }
+        },
+        browseId
+      })
     });
-    if (!response.ok) {
-      throw new Error(`InnerTube request failed with status: ${response.status}`);
+    if (!response.ok) return [];
+    const data = await response.json();
+    const pageEntries = extractVideoEntries(data);
+    entries.push(...pageEntries);
+    if (entries.length < limit) {
+      const continuationToken = findContinuationToken(data);
+      if (continuationToken) {
+        const more = await fetchInnerTubeContinuation(apiKey, clientVersion, idToken, continuationToken, limit - entries.length);
+        entries.push(...more);
+      }
     }
-    return response.json();
+  } catch (e) {
+    console.error(`[Scraper] InnerTube fetch error for ${browseId}`, e);
   }
-  /**
-   * Searches YouTube for the given query.
-   */
-  async search(query, options) {
-    const payload = { query };
-    if (options?.type === "video") {
-      payload.params = "EgIQAQ%3D%3D";
-    } else if (options?.type === "playlist") {
-      payload.params = "EgIQAw%3D%3D";
-    } else if (options?.type === "channel") {
-      payload.params = "EgIQAg%3D%3D";
+  return entries;
+}
+async function scrapeTasteData(injectedConfig, customPlaylists = [], limit = 500) {
+  let historyEntries = [];
+  let likesEntries = [];
+  let wlEntries = [];
+  const dislikesEntries = [];
+  const config = await getInnerTubeConfig(injectedConfig);
+  const apiKey = config.apiKey;
+  const clientVersion = config.clientVersion;
+  const idToken = config.idToken;
+  if (apiKey) {
+    historyEntries = await fetchInnerTubeFeed(apiKey, clientVersion, idToken, "FEhistory", limit);
+    likesEntries = await fetchInnerTubeFeed(apiKey, clientVersion, idToken, "VLLL", limit);
+    wlEntries = await fetchInnerTubeFeed(apiKey, clientVersion, idToken, "VLWL", limit);
+  }
+  if (historyEntries.length === 0) {
+    const historyData = await fetchYtInitialData("https://www.youtube.com/feed/history");
+    if (historyData) {
+      historyEntries = extractVideoEntries(historyData);
+      if (historyEntries.length < limit) {
+        const token = findContinuationToken(historyData);
+        if (token && apiKey) {
+          const more = await fetchInnerTubeContinuation(apiKey, clientVersion, idToken, token, limit - historyEntries.length);
+          historyEntries.push(...more);
+        }
+      }
     }
-    const data = await this.request("search", payload);
-    return new SearchResult(this, data);
   }
-  /**
-   * Gets metadata for a specific video.
-   */
-  async getVideo(videoId) {
-    const [playerData, nextData] = await Promise.all([
-      this.request("player", { videoId }),
-      this.request("next", { videoId })
-    ]);
-    const merged = { ...playerData, ...nextData };
-    return new Video(this, merged);
+  if (likesEntries.length === 0) {
+    const likesData = await fetchYtInitialData("https://www.youtube.com/playlist?list=LL");
+    if (likesData) {
+      likesEntries = extractVideoEntries(likesData);
+      if (likesEntries.length < limit) {
+        const token = findContinuationToken(likesData);
+        if (token && apiKey) {
+          const more = await fetchInnerTubeContinuation(apiKey, clientVersion, idToken, token, limit - likesEntries.length);
+          likesEntries.push(...more);
+        }
+      }
+    }
   }
-  /**
-   * Gets metadata and videos for a specific playlist.
-   */
-  async getPlaylist(playlistId) {
-    const browseId = playlistId.startsWith("VL") ? playlistId : `VL${playlistId}`;
-    const data = await this.request("browse", { browseId });
-    return new Playlist(this, data);
+  if (wlEntries.length === 0) {
+    const wlData = await fetchYtInitialData("https://www.youtube.com/playlist?list=WL");
+    if (wlData) {
+      wlEntries = extractVideoEntries(wlData);
+      if (wlEntries.length < limit) {
+        const token = findContinuationToken(wlData);
+        if (token && apiKey) {
+          const more = await fetchInnerTubeContinuation(apiKey, clientVersion, idToken, token, limit - wlEntries.length);
+          wlEntries.push(...more);
+        }
+      }
+    }
   }
-};
+  const customPlaylistsData = [];
+  for (const pl of customPlaylists) {
+    if (!pl.url) continue;
+    const match = pl.url.match(/[&?]list=([a-zA-Z0-9_-]+)/);
+    const playlistId = match ? match[1] : pl.url.trim();
+    if (!playlistId || !/^[a-zA-Z0-9_-]+$/.test(playlistId)) continue;
+    const browseId = playlistId.startsWith("VL") ? playlistId : "VL" + playlistId;
+    let entries = [];
+    if (apiKey) {
+      entries = await fetchInnerTubeFeed(apiKey, clientVersion, idToken, browseId, limit);
+    }
+    if (entries.length === 0) {
+      const data = await fetchYtInitialData(`https://www.youtube.com/playlist?list=${playlistId}`);
+      if (data) {
+        entries = extractVideoEntries(data);
+        if (entries.length < limit) {
+          const token = findContinuationToken(data);
+          if (token && apiKey) {
+            const more = await fetchInnerTubeContinuation(apiKey, clientVersion, idToken, token, limit - entries.length);
+            entries.push(...more);
+          }
+        }
+      }
+    }
+    customPlaylistsData.push({
+      id: playlistId,
+      entries: entries.slice(0, limit)
+    });
+  }
+  return {
+    historyEntries: historyEntries.slice(0, limit),
+    likesEntries: likesEntries.slice(0, limit),
+    wlEntries: wlEntries.slice(0, limit),
+    dislikesEntries: dislikesEntries.slice(0, limit),
+    customPlaylistsData
+  };
+}
+// src/formatters.ts
+function formatSrtTimestamp(seconds) {
+  const totalMs = Math.round(seconds * 1e3);
+  const ms = totalMs % 1e3;
+  const totalSeconds = Math.floor(totalMs / 1e3);
+  const s = totalSeconds % 60;
+  const m = Math.floor(totalSeconds / 60) % 60;
+  const h = Math.floor(totalSeconds / 3600);
+  return String(h).padStart(2, "0") + ":" + String(m).padStart(2, "0") + ":" + String(s).padStart(2, "0") + "," + String(ms).padStart(3, "0");
+}
+function formatVttTimestamp(seconds) {
+  const totalMs = Math.round(seconds * 1e3);
+  const ms = totalMs % 1e3;
+  const totalSeconds = Math.floor(totalMs / 1e3);
+  const s = totalSeconds % 60;
+  const m = Math.floor(totalSeconds / 60) % 60;
+  const h = Math.floor(totalSeconds / 3600);
+  return String(h).padStart(2, "0") + ":" + String(m).padStart(2, "0") + ":" + String(s).padStart(2, "0") + "." + String(ms).padStart(3, "0");
+}
+function toSRT(segments) {
+  return segments.map((segment, index) => {
+    const start = formatSrtTimestamp(segment.start);
+    const end = formatSrtTimestamp(segment.start + segment.duration);
+    return `${index + 1}
+${start} --> ${end}
+${segment.text}`;
+  }).join("\n\n");
+}
+function toVTT(segments) {
+  const cues = segments.map((segment) => {
+    const start = formatVttTimestamp(segment.start);
+    const end = formatVttTimestamp(segment.start + segment.duration);
+    return `${start} --> ${end}
+${segment.text}`;
+  }).join("\n\n");
+  return `WEBVTT
+${cues}`;
+}
+function toPlainText(segments, separator = "\n") {
+  return segments.map((segment) => segment.text).join(separator);
+}
 // src/comments.ts
 function findValue(obj, path, defaultValue = void 0) {
@@ -1146,7 +2203,7 @@ async function fetchCommentsFromYouTube(videoId, count = 50, injectedConfig = nu
       console.log(`[Comments] Fetching comment batch, total comments so far: ${fetchedCount}`);
       const options = createCommentsApiRequestOptions(continuationToken, clientVersion);
       const headers = { ...options.headers };
-      const sapisid = getSapisidFromCookie();
+      const sapisid = getSapisidFromCookieString();
       if (sapisid) {
         const authHash = await getSApiSidHash(sapisid);
         if (authHash) {
@@ -1285,6 +2342,15 @@ function extractPlayerResponse(html) {
   }
   return null;
 }
+function decodeHtmlEntities(text) {
+  return text.replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/&#x([0-9a-fA-F]+);/g, (_, hex) => {
+    const code = parseInt(hex, 16);
+    return code >= 0 && code <= 1114111 ? String.fromCodePoint(code) : "";
+  }).replace(/&#(\d+);/g, (_, dec) => {
+    const code = parseInt(dec, 10);
+    return code >= 0 && code <= 1114111 ? String.fromCodePoint(code) : "";
+  });
+}
 function parseXmlTranscriptRegex(xmlText) {
   const segments = [];
   const regex = /<text start="([^"]+)" dur="([^"]+)"[^>]*>(.*?)<\/text>/g;
@@ -1292,26 +2358,45 @@ function parseXmlTranscriptRegex(xmlText) {
   while ((match = regex.exec(xmlText)) !== null) {
     const start = parseFloat(match[1]);
     const duration = parseFloat(match[2]);
-    const text = match[3].replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/\n/g, " ").trim();
+    let text = decodeHtmlEntities(match[3]).replace(/\n/g, " ").trim();
     if (text && !isNaN(start)) {
       segments.push({ start, duration, text });
     }
   }
   return segments;
 }
-async function fetchSubtitlesFromYouTube(videoId, language = "en") {
+async function fetchSubtitlesFromYouTube(videoId, language = "en", clientOrOptions) {
   try {
-    console.log(`[Subtitles] Fetching video watch page for video: ${videoId}`);
-    const videoPageUrl = `https://www.youtube.com/watch?v=${videoId}&bpctr=9999999999`;
-    const response = await fetch(videoPageUrl, {
-      headers: {
-        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36",
-        "Accept-Language": "en-US"
-      }
-    });
-    const pageHtml = await response.text();
-    console.log("[Subtitles] Extracting caption tracks...");
-    const playerResponse = extractPlayerResponse(pageHtml);
+    let client;
+    if (clientOrOptions instanceof Client) {
+      client = clientOrOptions;
+    } else {
+      client = new Client(clientOrOptions);
+    }
+    const cacheKey = `yt_subtitles_${videoId}_${language}`;
+    if (client.cache) {
+      const cached = await client.cache.get(cacheKey);
+      if (cached) return cached;
+    }
+    console.log(`[Subtitles] Fetching player data for video: ${videoId}`);
+    let playerResponse = null;
+    try {
+      playerResponse = await client.requestPlayerWithFallback(videoId);
+    } catch (apiError) {
+      console.warn(`[Subtitles] InnerTube API failed for ${videoId}. Falling back to HTML scraping.`, apiError);
+    }
+    if (!playerResponse || !playerResponse.captions || !playerResponse.captions.playerCaptionsTracklistRenderer) {
+      console.log(`[Subtitles] No captions in API response, trying HTML scraping fallback for ${videoId}`);
+      const videoPageUrl = `https://www.youtube.com/watch?v=${videoId}&bpctr=9999999999`;
+      const response = await client.fetch(videoPageUrl, {
+        headers: {
+          "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36",
+          "Accept-Language": "en-US"
+        }
+      });
+      const pageHtml = await response.text();
+      playerResponse = extractPlayerResponse(pageHtml);
+    }
     if (!playerResponse || !playerResponse.captions || !playerResponse.captions.playerCaptionsTracklistRenderer) {
       console.warn(`[Subtitles] No captions tracklist found for video: ${videoId}`);
       return [];
@@ -1323,6 +2408,7 @@ async function fetchSubtitlesFromYouTube(videoId, language = "en") {
     }
     const tracks = captionTracks.map((t) => ({
       baseUrl: t.baseUrl,
+      vssId: t.vssId,
       languageCode: t.languageCode,
       name: t.name?.simpleText || t.name,
       isTranslatable: t.kind === "asr"
@@ -1330,9 +2416,7 @@ async function fetchSubtitlesFromYouTube(videoId, language = "en") {
     let selectedTrack;
     if (language && language !== "auto") {
       const lowerLang = language.toLowerCase();
-      selectedTrack = tracks.find((t) => t.languageCode.toLowerCase() === lowerLang && !t.isTranslatable);
-      if (!selectedTrack) selectedTrack = tracks.find((t) => t.languageCode.toLowerCase() === lowerLang);
-      if (!selectedTrack) selectedTrack = tracks.find((t) => t.languageCode.toLowerCase().includes(lowerLang));
+      selectedTrack = tracks.find((t) => t.vssId === `.${lowerLang}`) || tracks.find((t) => t.vssId === `a.${lowerLang}`) || tracks.find((t) => t.languageCode.toLowerCase() === lowerLang && !t.isTranslatable) || tracks.find((t) => t.languageCode.toLowerCase() === lowerLang) || tracks.find((t) => t.languageCode.toLowerCase().includes(lowerLang));
     }
     if (!selectedTrack) {
       selectedTrack = tracks.find((t) => t.languageCode.toLowerCase().startsWith("en") && !t.isTranslatable);
@@ -1346,9 +2430,10 @@ async function fetchSubtitlesFromYouTube(videoId, language = "en") {
       return [];
     }
     console.log(`[Subtitles] Selected track: ${selectedTrack.languageCode} (${selectedTrack.isTranslatable ? "ASR/Auto" : "Manual"})`);
-    const urlWithFormat = selectedTrack.baseUrl.includes("&fmt=") ? selectedTrack.baseUrl : `${selectedTrack.baseUrl}&fmt=srv3`;
+    let urlWithFormat = selectedTrack.baseUrl.replace(/&fmt=[^&]+/, "");
+    urlWithFormat += "&fmt=json3";
     console.log(`[Subtitles] Fetching transcript from: ${urlWithFormat.substring(0, 100)}...`);
-    const transcriptResponse = await fetch(urlWithFormat, {
+    const transcriptResponse = await client.fetch(urlWithFormat, {
       headers: {
         "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36",
         "Referer": "https://www.youtube.com/",
@@ -1357,21 +2442,31 @@ async function fetchSubtitlesFromYouTube(videoId, language = "en") {
     });
     const transcriptData = await transcriptResponse.text();
     let transcripts = [];
-    if (transcriptData.trim().startsWith("<?xml") || transcriptData.includes("<transcript>") || transcriptData.includes("<text start=")) {
-      transcripts = parseXmlTranscriptRegex(transcriptData);
-    } else {
-      try {
-        const json = JSON.parse(transcriptData);
-        if (json.events) {
-          transcripts = json.events.map((e) => ({
-            start: e.tStartMs / 1e3,
-            duration: e.dDurationMs / 1e3,
-            text: (e.segs ? e.segs.map((s) => s.utf8).join("") : "").replace(/\n/g, " ").trim()
-          })).filter((s) => s.text);
-        }
-      } catch (e) {
-        console.warn("[Subtitles] Failed to parse transcript string as JSON/XML.");
+    try {
+      const json = JSON.parse(transcriptData);
+      if (json.events) {
+        transcripts = json.events.map((e) => {
+          if (!e) return null;
+          const rawText = e.segs ? e.segs.map((s) => s?.utf8 || "").join("") : "";
+          const cleanText = decodeHtmlEntities(rawText.replace(/<[^>]+>/g, "")).replace(/\n/g, " ").trim();
+          return {
+            start: (e.tStartMs || 0) / 1e3,
+            duration: (e.dDurationMs || 0) / 1e3,
+            text: cleanText
+          };
+        }).filter((s) => s && s.text);
       }
+    } catch (jsonError) {
+      console.warn("[Subtitles] Failed to parse transcript string as JSON3. Falling back to XML regex.", jsonError);
+      const xmlUrl = selectedTrack.baseUrl.replace(/&fmt=[^&]+/, "") + "&fmt=srv3";
+      const xmlResponse = await client.fetch(xmlUrl, {
+        headers: { "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)" }
+      });
+      const xmlData = await xmlResponse.text();
+      transcripts = parseXmlTranscriptRegex(xmlData);
+    }
+    if (client.cache && transcripts.length > 0) {
+      await client.cache.set(cacheKey, transcripts);
     }
     console.log(`[Subtitles] Retrieved ${transcripts.length} segments.`);
     return transcripts;
@@ -1380,20 +2475,47 @@ async function fetchSubtitlesFromYouTube(videoId, language = "en") {
     return [];
   }
 }
+// src/index.ts
+async function searchYouTube(query, options) {
+  const client = new Client(options);
+  return client.search(query, options);
+}
+async function getVideoPlayback(videoId, options) {
+  const client = new Client(options);
+  return client.getVideo(videoId);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Base,
+  BaseChannel,
   BaseVideo,
+  Caption,
+  CaptionLanguage,
+  Channel,
   ChannelCompact,
+  ChannelLive,
+  ChannelPlaylists,
+  ChannelPosts,
+  ChannelShorts,
+  ChannelVideos,
+  Chat,
   Client,
+  Comment,
+  CommentReplies,
   Continuable,
+  LiveVideo,
+  MixPlaylist,
   Playlist,
   PlaylistCompact,
   PlaylistVideos,
   SearchResult,
   Thumbnails,
   Video,
+  VideoCaptions,
+  VideoComments,
   VideoCompact,
+  VideoRelated,
   createCommentsApiRequestOptions,
   extractPlayerResponse,
   extractVideoEntries,
@@ -1404,7 +2526,12 @@ async function fetchSubtitlesFromYouTube(videoId, language = "en") {
   findContinuationToken,
   getInnerTubeConfig,
   getSApiSidHash,
-  getSapisidFromCookie,
+  getSapisidFromCookieString,
+  getVideoPlayback,
   parseXmlTranscriptRegex,
-  scrapeTasteData
+  scrapeTasteData,
+  searchYouTube,
+  toPlainText,
+  toSRT,
+  toVTT
 });