extract-webpage 1.2.48 → 1.2.49

package/dist/index.d.ts

@@ -16,7 +16,7 @@ export * from './tokenize/text-to-chunks';
 export * from './url-to-content/url-to-content';
 export * from './url-to-content/url-to-html';
 export * from './html-to-cite/url-to-domain';
-export * from './url-to-content/youtube-to-text';
+export * from './url-to-content/youtube-helpers';
 export * from './url-to-content/docx-to-content';
 export * from './html-to-content/html-to-content';
 export * from './html-to-content/extract-content/extract-content-readability';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "extract-webpage",
-  "version": "1.2.48",
+  "version": "1.2.49",
   "module": "./dist/extract-webpage.es.js",
   "description": "Search, extract, cite, and outline the web for a topic with AI Research Agent.",
   "author": "vtempest <grokthiscontact@gmail.com>",
@@ -78,11 +78,11 @@
   "dependencies": {
     "@huggingface/transformers": "^3.8.1",
     "ai": "^5.0.0",
-    "chat-agent-toolkit": "^1.2.47",
+    "chat-agent-toolkit": "^1.2.48",
     "chrono-node": "^2.9.0",
     "drizzle-orm": "^0.45.1",
-    "extract-pdf": "^0.1.35",
-    "extract-youtube": "^1.0.35",
+    "extract-pdf": "^0.1.36",
+    "extract-youtube": "^1.0.36",
     "highlight.js": "^11.11.1",
     "html-entities": "^2.6.0",
     "js-yaml": "^4.1.1",

package/src/index.ts

@@ -17,7 +17,7 @@ export * from "./tokenize/text-to-chunks";
 export * from "./url-to-content/url-to-content";
 export * from "./url-to-content/url-to-html";
 export * from "./html-to-cite/url-to-domain";
-export * from "./url-to-content/youtube-to-text";
+export * from "./url-to-content/youtube-helpers";
 // PDF export removed from main index to prevent pdfjs-serverless from being evaluated at build time
 // Import directly from "./pdf-to-html/pdfToHtml" when needed
 export * from "./url-to-content/docx-to-content";

package/dist/url-to-content/youtube-to-text.d.ts

@@ -1,70 +0,0 @@
-/**
- * Fetch youtube.com video's webpage HTML for embedded transcript.
- * If blocked, use scraper of alternative sites providing transcripts.
- * @param {string} videoUrl
- * @param {Object} [options]
- * @param {boolean} options.addTimestamps default=true -
- * true to return timestamps, default true
- * @param {boolean} options.timeout default=5 - http request timeout
- * @return {{content: string, timestamps: string, word_count: number}}
- * where content is the full text of the transcript,
- * timestamps is a string of comma-separated [characterIndex, timeSeconds] pairs,
- * and word_count is the number of words in the transcript.
- * @category Extract
- * @author [vtempest (2025)](https://github.com/vtempest)
- */
-export declare function convertYoutubeToText(videoUrl: any, options?: {}): Promise<{
-    html: any;
-    word_count: any;
-    source: string;
-    date: any;
-    title: any;
-    author_cite: any;
-    length: number;
-}>;
-/**
- * Test if URL is to youtube video and return video id if true
- * @param {string} url - youtube video URL
- * @returns {string|boolean} video ID or false
- * @private
- */
-export declare function getURLYoutubeVideo(url: any): any;
-/**
- * Fetch-based scraper of youtubetotranscript.com
- * @returns {Object} content, timestamps -  where content is the full text of
- * the transcript, and timestamps is an array of [characterIndex, timeSeconds]
- */
-export declare function fetchViaYoutubeToTranscriptCom(videoId: any, options?: {}): Promise<{
-    error: number;
-    content?: undefined;
-    title?: undefined;
-    author_cite?: undefined;
-    timestamps?: undefined;
-} | {
-    content: string;
-    title: any;
-    author_cite: any;
-    timestamps: any[];
-    error?: undefined;
-}>;
-/** ========== NOT WORKING ========== */
-/**
- * Get YouTube transcript of most YouTube videos,
- * except if disabled by uploader
- * fetch-based scraper of youtubetranscript.com
- *
- * @param {string} videoUrl
- * @returns {Object} where content is the full text of
- * the transcript, and timestamps is an array of [characterIndex, timeSeconds]
- * @private
- */
-export declare function fetchViaYoutubeTranscript(videoId: any, options?: {}): Promise<{
-    error: number;
-    content?: undefined;
-    timestamps?: undefined;
-} | {
-    content: string;
-    timestamps: any[];
-    error?: undefined;
-}>;
-export declare function extractYouTubeInfo(videoId: any, options?: {}): Promise<{}>;

package/src/url-to-content/youtube-to-text.ts

@@ -1,468 +0,0 @@
-// @ts-nocheck
-import { convertURLSafeHTMLToHTML } from "../html-to-content/html-utils";
-import { scrapeURL } from "./url-to-html";
-import grab from "../utils/grab";
-import { decode, encode } from "html-entities";
-/**
- * Fetch youtube.com video's webpage HTML for embedded transcript.
- * If blocked, use scraper of alternative sites providing transcripts.
- * @param {string} videoUrl
- * @param {Object} [options]
- * @param {boolean} options.addTimestamps default=true -
- * true to return timestamps, default true
- * @param {boolean} options.timeout default=5 - http request timeout
- * @return {{content: string, timestamps: string, word_count: number}}
- * where content is the full text of the transcript,
- * timestamps is a string of comma-separated [characterIndex, timeSeconds] pairs,
- * and word_count is the number of words in the transcript.
- * @category Extract
- * @author [vtempest (2025)](https://github.com/vtempest)
- */
-export async function convertYoutubeToText(videoUrl, options = {}) {
-  const {
-    addTimestamps = true,
-    addPlayer = true,
-    timeout = 10,
-    proxy = null,
-  } = options;
-
-  var videoId = getURLYoutubeVideo(videoUrl),
-    res = {};
-
-  // res = await fetchTranscriptTactiq(videoId, options);
-
-  if (!res.content || res.error)
-    res = await fetchTranscriptOfficialYoutube(videoId, options);
-
-  console.log(res);
-
-  // if (!res.content || res.error)
-  //   res = await fetchViaYoutubeToTranscriptCom(videoId, options);
-
-  // if (!res.content || res.error)
-  //   res = await fetchViaYoutubeTranscript(videoId, options);
-
-  // var { date, title, author_cite, length } = await extractYouTubeInfo(
-  //   videoId,
-  //   options,
-  // );
-
-  // if (!res.content || res.error) return { error: 1 };
-  // var { content, timestamps } = res;
-
-  // var word_count = content.split(" ").length;
-
-  // content = convertURLSafeHTMLToHTML(content);
-
-  // console.log(content);
-
-  return;
-
-  //timestamp to track characters per second speed at each interval
-  var speedsEveryCharPeriod = {};
-  const valueCharPeriod = 100;
-
-  for (var timestamp of timestamps) {
-    var [char, time] = timestamp;
-
-    var speed = Math.floor(char / time) - 10;
-    speedsEveryCharPeriod[Math.floor(char / valueCharPeriod)] = speed;
-  }
-
-  var speeds = Object.keys(speedsEveryCharPeriod).map(
-    (timeKey) => speedsEveryCharPeriod[timeKey],
-  );
-
-  let compressed = [];
-  let compressedCount = [];
-  let currentNum = speeds[0];
-  let count = 1;
-
-  for (let i = 1; i < speeds.length; i++) {
-    if (speeds[i] === currentNum) {
-      count++;
-    } else {
-      compressed.push(currentNum);
-      compressedCount.push(count);
-      currentNum = speeds[i];
-      count = 1;
-    }
-  }
-  compressed.push(currentNum);
-  compressedCount.push(count);
-
-  var total = 0;
-  compressedCount = compressedCount.map((c) => {
-    total += c;
-    return total;
-  });
-
-  //remove extra spaces
-  content = content.replace(/\s+/g, " ");
-
-  speeds = compressed.join(",") + "  " + compressedCount.join(",");
-
-  if (addPlayer)
-    content = `<iframe width="100%" height="315px" data-timestamps="${speeds}" 
-    src="https://www.youtube.com/embed/${videoId}" frameborder="0" 
-    allow="accelerometer; autoplay; clipboard-write; encrypted-media; 
-    gyroscope; picture-in-picture" allowfullscreen></iframe>${content}`;
-
-  var source = "YouTube";
-
-  return {
-    html: content,
-    word_count,
-    source,
-    date,
-    title,
-    author_cite,
-    length,
-  };
-}
-
-function decompressTimestampsArray(compressedStr) {
-  let decompressed = [];
-  let parts = compressedStr.split(",");
-
-  for (let part of parts) {
-    let [num, count] = part.split("x");
-    num = parseInt(num);
-    count = parseInt(count);
-    decompressed.push(...Array(count).fill(num));
-  }
-
-  return decompressed;
-}
-
-/**
- * Test if URL is to youtube video and return video id if true
- * @param {string} url - youtube video URL
- * @returns {string|boolean} video ID or false
- * @private
- */
-export function getURLYoutubeVideo(url) {
-  var match = url?.match(
-    /(?:\/embed\/|v=|v\/|vi\/|youtu\.be\/|\/v\/|^https?:\/\/(?:www\.)?youtube\.com\/(?:(?:watch)?\?.*v=|(?:embed|v|vi|user)\/))([^#\&\?]*).*/,
-  );
-  return match ? match[1] : false;
-}
-
-/**
- * Fetch-based scraper of youtubetotranscript.com
- * @returns {Object} content, timestamps -  where content is the full text of
- * the transcript, and timestamps is an array of [characterIndex, timeSeconds]
- */
-export async function fetchViaYoutubeToTranscriptCom(videoId, options = {}) {
-  // try {
-  const url = `https://youtubetotranscript.com/transcript?v=${videoId}&current_language_code=en`;
-
-  var html = await scrapeURL(url, options);
-  if (html.error) return { error: 1 };
-
-  if (!html || html.error) return { error: 1 };
-
-  //remove line breaks
-  html = html?.replace(/[\r\n]/gi, " ");
-  // Title regex
-  const titleRegex = /<h1[^>]*>([^<]+)<\/h1>/gi;
-  var title = html?.match(titleRegex)?.[1];
-  //extract title between h1 tags
-  title = title
-    ?.replace(/<[^>]*>/g, "")
-    ?.replace("Transcript of ", "")
-    ?.trim();
-
-  // Author regex with "Author :" prefix
-
-  const authorRegex = /Author\s*:\s*<a[\s\S]*?>\s*(.*?)\s*<\/a\s*>/;
-  var author_cite = html.match(authorRegex)?.[1];
-
-  const transcriptRegex =
-    /<span[^>]*?data-start="([\d.]+)"[^>]*?class="transcript-segment"[^>]*?>[\s\n]*((?:(?!<\/span>).|\n)*?)[\s\n]*<\/span>/gms;
-
-  const matches = Array.from(html.matchAll(transcriptRegex));
-
-  const transcript = matches.map((match) => ({
-    text: match[2]?.replace(/<br\s*\/?>/gi, " ")?.trim(),
-    offset: parseFloat(match[1]),
-  }));
-
-  const content = transcript.map((item) => item.text).join(" ");
-  let timestamps = [];
-  let charIndex = 0;
-
-  transcript.forEach((item) => {
-    timestamps.push([charIndex, Math.floor(item.offset)]);
-    charIndex += item.text.length + 1; // +1 for the space we added
-  });
-
-  return { content, title, author_cite, timestamps };
-  // } catch (e) {
-  //   return { error: 1 };
-  // }
-}
-
-/**
- * Fetches via tactiq api
- * @param {string} videoId
- * @returns
- */
-async function fetchTranscriptTactiq(videoId, options = {}) {
-  try {
-    const data = await grab("https://tactiq-apps-prod.tactiq.io/transcript", {
-      method: "POST",
-      body: JSON.stringify({
-        videoUrl: "https://www.youtube.com/watch?v=" + videoId,
-      }),
-    });
-
-    if (!data.captions || data.captions.length === 0) {
-      return { error: true };
-    }
-
-    let content = "";
-    let timestamps = [];
-    let currentLength = 0;
-
-    data.captions.forEach(({ start, dur, text }) => {
-      timestamps.push([currentLength, Math.floor(parseFloat(start))]);
-      content += text + " ";
-      currentLength = content.length;
-    });
-
-    return { content, timestamps };
-  } catch (error) {
-    console.error("Error fetching transcript:", error);
-    return { error: true };
-  }
-}
-
-/** ========== NOT WORKING ========== */
-
-/**
- * Get YouTube transcript of most YouTube videos,
- * except if disabled by uploader
- * fetch-based scraper of youtubetranscript.com
- *
- * @param {string} videoUrl
- * @returns {Object} where content is the full text of
- * the transcript, and timestamps is an array of [characterIndex, timeSeconds]
- * @private
- */
-export async function fetchViaYoutubeTranscript(videoId, options = {}) {
-  const url = "https://youtubetranscript.com/?server_vid2=" + videoId;
-
-  const html = await grab(url, { responseType: "text" });
-
-  if (html.error) return { error: 1 };
-
-  const transcriptRegex =
-    /<text start="([\d.]+)" dur="[\d.]+">((?:(?!<\/text>).|\n)*?)<\/text>/gms;
-  const matches = Array.from(html.matchAll(transcriptRegex));
-
-  const transcript = matches.map((match) => ({
-    text: match[2],
-    offset: parseFloat(match[1]),
-  }));
-
-  const content = transcript.map((item) => item.text).join(" ");
-  let timestamps = [];
-  let charIndex = 0;
-
-  if (content.includes("YouTube is currently blocking us from fetching"))
-    return { error: 1 };
-
-  transcript.forEach((item) => {
-    timestamps.push([charIndex, Math.floor(item.offset)]);
-    charIndex += item.text.length + 1; // +1 for the space we added
-  });
-
-  return { content, timestamps };
-}
-
-export async function extractYouTubeInfo(videoId, options = {}) {
-  var htmlString = await scrapeURL(
-    `https://www.youtube.com/watch?v=${videoId}`,
-    options,
-  )?.data;
-
-  // youtube bot limiting
-  if (
-    htmlString?.error ||
-    htmlString?.data.includes('class="g-recaptcha"') ||
-    !htmlString?.data.includes('"playabilityStatus":')
-  )
-    return { error: 1 };
-
-  // Remove newlines for easier regex matching
-  htmlString = htmlString?.replace(/\n/g, "");
-
-  const result = {};
-
-  // Extract date
-  const datePattern =
-    /id="info"[^>]*>(?:.*?)(?:(?:Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)\s+\d{1,2},\s+\d{4}|\d+\s+(?:second|minute|hour|day|week|month|year)s?\s+ago)/gi;
-  const dateMatch = htmlString.match(datePattern);
-
-  if (dateMatch) {
-    // Extract just the date part using two possible patterns
-    const absoluteDatePattern =
-      /(?:Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)\s+\d{1,2},\s+\d{4}/;
-    const relativeDatePattern =
-      /\d+\s+(?:second|minute|hour|day|week|month|year)s?\s+ago/i;
-
-    const absoluteMatch = dateMatch[0].match(absoluteDatePattern);
-    const relativeMatch = dateMatch[0].match(relativeDatePattern);
-
-    if (absoluteMatch) {
-      result.date = absoluteMatch[0];
-    } else if (relativeMatch) {
-      const relative = relativeMatch[0];
-      const [amount, unit] = relative.split(" ");
-
-      // Convert relative date to absolute date
-      const now = new Date();
-      const date = new Date(now);
-
-      switch (unit?.toLowerCase()) {
-        case "second":
-        case "seconds":
-          date.setSeconds(now.getSeconds() - parseInt(amount));
-          break;
-        case "minute":
-        case "minutes":
-          date.setMinutes(now.getMinutes() - parseInt(amount));
-          break;
-        case "hour":
-        case "hours":
-          date.setHours(now.getHours() - parseInt(amount));
-          break;
-        case "day":
-        case "days":
-          date.setDate(now.getDate() - parseInt(amount));
-          break;
-        case "week":
-        case "weeks":
-          date.setDate(now.getDate() - parseInt(amount) * 7);
-          break;
-        case "month":
-        case "months":
-          date.setMonth(now.getMonth() - parseInt(amount));
-          break;
-        case "year":
-        case "years":
-          date.setFullYear(now.getFullYear() - parseInt(amount));
-          break;
-      }
-
-      // Format the date in YouTube style (MMM DD, YYYY)
-      const months = [
-        "Jan",
-        "Feb",
-        "Mar",
-        "Apr",
-        "May",
-        "Jun",
-        "Jul",
-        "Aug",
-        "Sep",
-        "Oct",
-        "Nov",
-        "Dec",
-      ];
-      const formatted = `${months[date.getMonth()]} ${date.getDate()}, ${date.getFullYear()}`;
-      result.date = formatted;
-    }
-  } else {
-    result.date = null;
-  }
-
-  // Extract title
-  const titlePattern = /"title":"([^"]+)"/;
-  const titleMatch = htmlString.match(titlePattern);
-  result.title = titleMatch ? titleMatch[1] : null;
-
-  // Extract author/channel name
-  const authorPattern = /"author":"([^"]+)"/;
-  const authorMatch = htmlString.match(authorPattern);
-  result.author_cite = authorMatch ? authorMatch[1] : null;
-
-  // Extract length in seconds (bonus)
-  const lengthPattern = /"lengthSeconds":"(\d+)"/;
-  const lengthMatch = htmlString.match(lengthPattern);
-  result.length = lengthMatch ? parseInt(lengthMatch[1]) : null;
-
-  return result;
-}
-
-async function fetchTranscriptOfficialYoutube(videoId, options = {}) {
-  let videoPageBody = await scrapeURL(
-    `https://www.youtube.com/watch?v=${videoId}`,
-    options,
-  );
-
-  videoPageBody = videoPageBody?.data;
-  // if (videoPageBody?.error) return { error: 1 };
-  // if (
-  //   videoPageBody?.includes('class="g-recaptcha"') ||
-  //   !videoPageBody?.includes('"playabilityStatus":')
-  // )
-  //   return { error: 1 };
-
-  var videoObj = videoPageBody
-    .replace("\n", "")
-    .split('"captions":')?.[1]
-    ?.split(',"videoDetails')[0];
-
-  if (!videoObj) return { error: 2 };
-
-  const captions = JSON.parse(videoObj)?.playerCaptionsTracklistRenderer;
-
-  if (!captions?.captionTracks) return { error: 3 };
-
-  const track = captions.captionTracks.find(
-    (track) => track.languageCode === "en",
-  );
-
-  if (!track) return { error: 4 };
-
-  //TODO: implement  youtube-po-token-generator";
-  // const { poToken } = await generate();
-const { poToken } = 1;
-  let transcriptURL =
-    track.baseUrl.replaceAll(",", "%2C") +
-    "&potc=1&pot=" +
-    encodeURIComponent(poToken.replace(/=/g, "%3D")) +
-    "&fmt=json3&xorb=2&xobt=3&xovt=3&cbr=Chrome&cbrver=144.0.0.0&c=WEB&cver=2.20260312.08.00&cplayer=UNIPLAYER&cos=X11&cplatform=DESKTOP";
-  console.log(transcriptURL);
-
-  const transcriptBody = await scrapeURL(transcriptURL, options);
-
-  console.log(transcriptBody);
-  return;
-  if (transcriptBody.error) return { error: true };
-
-  const results = [
-    ...transcriptBody.data.matchAll(
-      /<text start="([^"]*)" dur="([^"]*)">([^<]*)<\/text>/g,
-    ),
-  ];
-
-  var transcript = results.map(([, start, duration, text]) => ({
-    text,
-    duration: parseFloat(duration),
-    offset: parseFloat(start),
-    lang: track.languageCode,
-  }));
-
-  var content = "";
-  var timestamps = [];
-  transcript.forEach(({ offset, text }) => {
-    timestamps.push([content.length, Math.floor(offset, 0)]);
-
-    content += text + " ";
-  });
-
-  return { content, timestamps };
-}