tubezero 1.0.0 → 1.1.0

package/dist/index.js

@@ -1,360 +1,3 @@
-// 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) {
@@ -413,26 +56,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;
   }
 };
 
@@ -456,51 +100,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;
           }
         }
@@ -508,206 +243,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("#"));
+    }
+    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);
     }
-    this.id = channelId;
-    this.name = nameText;
-    this.thumbnails = new Thumbnails(thumbnails);
-    this.subscriberCount = subCount;
+  }
+  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;
   }
 };
 
@@ -817,18 +1107,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);
@@ -843,13 +1408,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;
@@ -865,114 +1464,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) {
@@ -1096,7 +2131,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) {
@@ -1235,6 +2270,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;
@@ -1242,26 +2286,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 [];
@@ -1273,6 +2336,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"
@@ -1280,9 +2344,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);
@@ -1296,9 +2358,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/",
@@ -1307,21 +2370,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;
@@ -1330,19 +2403,46 @@ 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);
+}
 export {
   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,
@@ -1353,7 +2453,12 @@ export {
   findContinuationToken,
   getInnerTubeConfig,
   getSApiSidHash,
-  getSapisidFromCookie,
+  getSapisidFromCookieString,
+  getVideoPlayback,
   parseXmlTranscriptRegex,
-  scrapeTasteData
+  scrapeTasteData,
+  searchYouTube,
+  toPlainText,
+  toSRT,
+  toVTT
 };