youtube-transcript-nodejs 0.1.0

package/dist/cjs/parsers/captionTrackParser.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCaptionTrack = parseCaptionTrack;
+exports.parseTranslationLanguage = parseTranslationLanguage;
+exports.parseCaptionTracklist = parseCaptionTracklist;
+/**
+ * Helpers to convert the InnerTube `playerCaptionsTracklistRenderer` JSON
+ * into clean JS values.
+ *
+ * Mirrors the Python library's `TranscriptList.build`.
+ */
+function readNameRuns(nameField) {
+    if (typeof nameField !== 'object' || nameField === null) {
+        return '';
+    }
+    const rec = nameField;
+    const runs = rec['runs'];
+    if (Array.isArray(runs) && runs.length > 0) {
+        const first = runs[0];
+        if (typeof first === 'object' && first !== null) {
+            const text = first['text'];
+            if (typeof text === 'string') {
+                return text;
+            }
+        }
+    }
+    const simpleText = rec['simpleText'];
+    if (typeof simpleText === 'string') {
+        return simpleText;
+    }
+    return '';
+}
+function parseCaptionTrack(node) {
+    if (typeof node !== 'object' || node === null)
+        return null;
+    const rec = node;
+    const baseUrl = rec['baseUrl'];
+    const languageCode = rec['languageCode'];
+    const vssId = rec['vssId'];
+    if (typeof baseUrl !== 'string' || typeof languageCode !== 'string' || typeof vssId !== 'string') {
+        return null;
+    }
+    // Strip the &fmt=srv3 flag so the response defaults to XML (mirrors Python).
+    const cleanBaseUrl = baseUrl.replace(/&fmt=srv3/g, '');
+    const kindRaw = rec['kind'];
+    const kind = kindRaw === 'asr' ? 'asr' : '';
+    return {
+        baseUrl: cleanBaseUrl,
+        languageCode,
+        name: readNameRuns(rec['name']),
+        kind,
+        isTranslatable: rec['isTranslatable'] === true,
+        vssId,
+    };
+}
+function parseTranslationLanguage(node) {
+    if (typeof node !== 'object' || node === null)
+        return null;
+    const rec = node;
+    const languageCode = rec['languageCode'];
+    if (typeof languageCode !== 'string')
+        return null;
+    return {
+        languageCode,
+        languageName: readNameRuns(rec['languageName']),
+    };
+}
+function parseCaptionTracklist(node) {
+    if (typeof node !== 'object' || node === null)
+        return null;
+    const rec = node;
+    const captionTracksRaw = rec['captionTracks'];
+    if (!Array.isArray(captionTracksRaw))
+        return null;
+    const captionTracks = [];
+    for (const ct of captionTracksRaw) {
+        const parsed = parseCaptionTrack(ct);
+        if (parsed)
+            captionTracks.push(parsed);
+    }
+    if (captionTracks.length === 0)
+        return null;
+    const translationLanguagesRaw = rec['translationLanguages'];
+    let translationLanguages = [];
+    if (Array.isArray(translationLanguagesRaw)) {
+        const list = [];
+        for (const tl of translationLanguagesRaw) {
+            const parsed = parseTranslationLanguage(tl);
+            if (parsed)
+                list.push(parsed);
+        }
+        translationLanguages = list;
+    }
+    return { captionTracks, translationLanguages };
+}
+//# sourceMappingURL=captionTrackParser.js.map

package/dist/cjs/parsers/captionTrackParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"captionTrackParser.js","sourceRoot":"","sources":["../../../src/parsers/captionTrackParser.ts"],"names":[],"mappings":"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"}

package/dist/cjs/parsers/videoIdParser.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractVideoId = extractVideoId;
+exports.tryExtractVideoId = tryExtractVideoId;
+const constants_js_1 = require("../config/constants.js");
+const index_js_1 = require("../errors/index.js");
+/**
+ * Extract a YouTube video id from a string that is either:
+ *  - a raw 11-character id
+ *  - any common YouTube URL form (watch?v=, youtu.be/, /shorts/, /embed/, etc.)
+ *
+ * Mirrors the Python library's regex set (added in PR #282 by Tesla2000).
+ */
+const URL_PATTERNS = [
+    // youtu.be/<id>
+    /(?:youtu\.be\/)([A-Za-z0-9_-]{11})/,
+    // youtube.com/shorts/<id>
+    /(?:youtube\.com\/shorts\/)([A-Za-z0-9_-]{11})/,
+    // youtube.com/embed/<id>
+    /(?:youtube\.com\/embed\/)([A-Za-z0-9_-]{11})/,
+    // youtube.com/v/<id>
+    /(?:youtube\.com\/v\/)([A-Za-z0-9_-]{11})/,
+    // music.youtube.com/watch?v=<id>
+    /(?:music\.youtube\.com\/watch\?v=)([A-Za-z0-9_-]{11})/,
+    // generic ?v=<id> or &v=<id>
+    /(?:\?v=|\&v=)([A-Za-z0-9_-]{11})/,
+];
+/**
+ * Try to extract a video id from `input`.
+ *
+ * @throws InvalidVideoId if `input` is not a valid YouTube id or URL.
+ */
+function extractVideoId(input) {
+    if (typeof input !== 'string') {
+        throw new index_js_1.InvalidVideoId(String(input));
+    }
+    const trimmed = input.trim();
+    if (trimmed.length === 0) {
+        throw new index_js_1.InvalidVideoId(input);
+    }
+    // Fast path: already a canonical id.
+    if (constants_js_1.VIDEO_ID_REGEX.test(trimmed)) {
+        return trimmed;
+    }
+    // Try URL patterns.
+    for (const re of URL_PATTERNS) {
+        const m = re.exec(trimmed);
+        if (m && m[1]) {
+            return m[1];
+        }
+    }
+    throw new index_js_1.InvalidVideoId(input);
+}
+/**
+ * Non-throwing variant of `extractVideoId`. Returns `null` on failure.
+ */
+function tryExtractVideoId(input) {
+    try {
+        return extractVideoId(input);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=videoIdParser.js.map

package/dist/cjs/parsers/videoIdParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"videoIdParser.js","sourceRoot":"","sources":["../../../src/parsers/videoIdParser.ts"],"names":[],"mappings":";;AA8BA,wCAoBC;AAKD,8CAMC;AA7DD,yDAAwD;AACxD,iDAAoD;AAEpD;;;;;;GAMG;AACH,MAAM,YAAY,GAAsB;IACtC,gBAAgB;IAChB,oCAAoC;IACpC,0BAA0B;IAC1B,+CAA+C;IAC/C,yBAAyB;IACzB,8CAA8C;IAC9C,qBAAqB;IACrB,0CAA0C;IAC1C,iCAAiC;IACjC,uDAAuD;IACvD,6BAA6B;IAC7B,kCAAkC;CACnC,CAAC;AAEF;;;;GAIG;AACH,SAAgB,cAAc,CAAC,KAAa;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,yBAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,yBAAc,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IACD,qCAAqC;IACrC,IAAI,6BAAc,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,oBAAoB;IACpB,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACd,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IACD,MAAM,IAAI,yBAAc,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,KAAa;IAC7C,IAAI,CAAC;QACH,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/cjs/parsers/watchHtmlParser.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONSENT_FORM_VALUE_REGEX = exports.CONSENT_GATE_MARKER = void 0;
+exports.isConsentGate = isConsentGate;
+exports.isCaptchaGate = isCaptchaGate;
+exports.extractInnertubeApiKey = extractInnertubeApiKey;
+exports.extractConsentFormValue = extractConsentFormValue;
+exports.buildConsentCookieValue = buildConsentCookieValue;
+const index_js_1 = require("../errors/index.js");
+/**
+ * Parse the YouTube watch HTML to extract the `INNERTUBE_API_KEY` and
+ * (optionally) the EU-consent gate parameters.
+ *
+ * Mirrors the Python library's `_extract_innertube_api_key`:
+ *
+ *     pattern = r'"INNERTUBE_API_KEY":\s*"([a-zA-Z0-9_-]+)"'
+ *
+ * We also keep a couple of fallback patterns to make the parser resilient
+ * to YouTube's occasional A/B variations.
+ */
+const API_KEY_PATTERNS = [
+    /"INNERTUBE_API_KEY":\s*"([A-Za-z0-9_-]+)"/,
+    /"innertubeApiKey":\s*"([A-Za-z0-9_-]+)"/,
+    /"key":\s*"([A-Za-z0-9_-]{20,})"/,
+];
+/** Marker that indicates the EU consent gate is present. */
+exports.CONSENT_GATE_MARKER = 'action="https://consent.youtube.com/s"';
+/** Regex extracting the `v` form value used to mint the CONSENT cookie. */
+exports.CONSENT_FORM_VALUE_REGEX = /name="v" value="([^"]+)"/;
+/**
+ * Detect whether the watch HTML is the EU consent gate.
+ */
+function isConsentGate(html) {
+    return html.includes(exports.CONSENT_GATE_MARKER);
+}
+/**
+ * Detect whether the watch HTML is a CAPTCHA / bot-detect page.
+ *
+ * Python library checks for `class="g-recaptcha"`; we extend slightly.
+ */
+function isCaptchaGate(html) {
+    return html.includes('class="g-recaptcha"') || html.includes('class="rc-imageselect"');
+}
+/**
+ * Extract the `INNERTUBE_API_KEY` from watch HTML.
+ *
+ * @throws YouTubeDataUnparsable if no key is found.
+ * @throws IpBlocked (with statusCode undefined) if a CAPTCHA gate is detected.
+ */
+function extractInnertubeApiKey(html, videoId) {
+    if (isCaptchaGate(html)) {
+        throw new index_js_1.IpBlocked(videoId);
+    }
+    for (const re of API_KEY_PATTERNS) {
+        const m = re.exec(html);
+        if (m && m[1]) {
+            return m[1];
+        }
+    }
+    throw new index_js_1.YouTubeDataUnparsable(videoId, 'INNERTUBE_API_KEY not found in watch HTML (YouTube may have changed the page format).');
+}
+/**
+ * Extract the `v` parameter from the EU consent form.
+ *
+ * @returns the raw `v` value, or `null` if not found.
+ */
+function extractConsentFormValue(html) {
+    const m = exports.CONSENT_FORM_VALUE_REGEX.exec(html);
+    return m && m[1] ? m[1] : null;
+}
+/**
+ * Build a CONSENT cookie value in the format YouTube expects:
+ *   `YES+<v>`
+ */
+function buildConsentCookieValue(v) {
+    return `YES+${v}`;
+}
+//# sourceMappingURL=watchHtmlParser.js.map

package/dist/cjs/parsers/watchHtmlParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchHtmlParser.js","sourceRoot":"","sources":["../../../src/parsers/watchHtmlParser.ts"],"names":[],"mappings":";;;AA6BA,sCAEC;AAOD,sCAEC;AAQD,wDAcC;AAOD,0DAGC;AAMD,0DAEC;AAhFD,iDAAsE;AAEtE;;;;;;;;;;GAUG;AAEH,MAAM,gBAAgB,GAAsB;IAC1C,2CAA2C;IAC3C,yCAAyC;IACzC,iCAAiC;CAClC,CAAC;AAEF,4DAA4D;AAC/C,QAAA,mBAAmB,GAAG,wCAAwC,CAAC;AAE5E,2EAA2E;AAC9D,QAAA,wBAAwB,GAAG,0BAA0B,CAAC;AAEnE;;GAEG;AACH,SAAgB,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,2BAAmB,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC;AACzF,CAAC;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB,CAAC,IAAY,EAAE,OAAe;IAClE,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,oBAAS,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,gBAAgB,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACd,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IACD,MAAM,IAAI,gCAAqB,CAC7B,OAAO,EACP,uFAAuF,CACxF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,uBAAuB,CAAC,IAAY;IAClD,MAAM,CAAC,GAAG,gCAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,SAAgB,uBAAuB,CAAC,CAAS;IAC/C,OAAO,OAAO,CAAC,EAAE,CAAC;AACpB,CAAC"}

package/dist/cjs/parsers/xmlTranscriptParser.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTranscriptXml = parseTranscriptXml;
+const htmlSanitizer_js_1 = require("../util/htmlSanitizer.js");
+/**
+ * Parse timedtext XML into a list of cues.
+ *
+ * Note on parsing strategy: timedtext XML uses HTML-like markup INSIDE
+ * the `<text>` element (e.g. `<text><b>bold</b></text>`). A strict XML
+ * parser would treat the inner `<b>` as a nested element and lose the
+ * mixed-content ordering. The Python library uses defusedxml, which has
+ * the same limitation; the sanitizer layer below strips tags afterward.
+ *
+ * To avoid that pitfall, we extract `<text>` elements with a regex,
+ * which preserves the inner HTML verbatim for the sanitizer to handle.
+ *
+ * Expected input shape:
+ *
+ *     <transcript>
+ *       <text start="0.0" dur="1.54">Hello</text>
+ *       <text start="1.54" dur="2.0">With <b>bold</b></text>
+ *     </transcript>
+ */
+const TEXT_ELEMENT_REGEX = /<text\b([^>]*?)\/?>([\s\S]*?)<\/text>|<text\b([^>]*?)\/>/gi;
+const ATTR_REGEX = /([a-zA-Z_][\w:-]*)\s*=\s*"([^"]*)"/g;
+/**
+ * Parse the timedtext XML response body.
+ *
+ * @throws Error if the input is not a string with at least one `<text>` element.
+ */
+function parseTranscriptXml(rawXml, opts = {}) {
+    if (typeof rawXml !== 'string' || rawXml.length === 0) {
+        throw new Error('Empty transcript XML');
+    }
+    // Sanity: must contain at least one <text tag; otherwise we treat as malformed.
+    if (!/<text\b/i.test(rawXml)) {
+        throw new Error('Transcript XML contains no <text> elements');
+    }
+    const preserveFormatting = opts.preserveFormatting === true;
+    const cues = [];
+    // Reset lastIndex to be safe.
+    TEXT_ELEMENT_REGEX.lastIndex = 0;
+    let match;
+    while ((match = TEXT_ELEMENT_REGEX.exec(rawXml)) !== null) {
+        // The regex captures either:
+        //   match[1] = attrs, match[2] = inner content (paired <text>...</text>)
+        // or:
+        //   match[3] = attrs (self-closing <text ... />)
+        const attrs = match[1] ?? match[3] ?? '';
+        const innerHtml = match[2] ?? '';
+        if (innerHtml.length === 0)
+            continue;
+        const { start, duration } = parseAttributes(attrs);
+        if (!Number.isFinite(start))
+            continue;
+        cues.push({
+            text: (0, htmlSanitizer_js_1.sanitizeTranscriptText)(innerHtml, preserveFormatting),
+            start,
+            duration,
+        });
+    }
+    return cues;
+}
+function parseAttributes(attrString) {
+    const map = {};
+    ATTR_REGEX.lastIndex = 0;
+    let m;
+    while ((m = ATTR_REGEX.exec(attrString)) !== null) {
+        const name = m[1];
+        const value = m[2];
+        if (name && value !== undefined) {
+            map[name] = value;
+        }
+    }
+    const startStr = map['start'];
+    const durStr = map['dur'];
+    const start = startStr !== undefined ? Number.parseFloat(startStr) : 0;
+    const duration = durStr !== undefined ? Number.parseFloat(durStr) : 0;
+    return {
+        start: Number.isFinite(start) ? start : 0,
+        duration: Number.isFinite(duration) ? duration : 0,
+    };
+}
+//# sourceMappingURL=xmlTranscriptParser.js.map

package/dist/cjs/parsers/xmlTranscriptParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xmlTranscriptParser.js","sourceRoot":"","sources":["../../../src/parsers/xmlTranscriptParser.ts"],"names":[],"mappings":"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"}

package/dist/cjs/potoken/AutoPoTokenProvider.js

@@ -0,0 +1,203 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutoPoTokenProvider = void 0;
+const index_js_1 = require("../errors/index.js");
+const types_js_1 = require("./types.js");
+/**
+ * Self-contained PoToken provider.
+ *
+ * Uses `bgutils-js` (an optional dependency) to drive YouTube's BotGuard
+ * VM and mint PoTokens locally. No external service required.
+ *
+ * The visitorData is derived from the video id by default; pass a real
+ * one via `setVisitorData()` for stronger session-bound guarantees.
+ *
+ * Note: this provider requires the optional `bgutils-js` dependency. If
+ * it is not installed, generation throws `BotDetected`.
+ */
+const WAA_API_KEY = 'AIzaSyDyT5W0Jh49F30Pqqtyfdf7pDLFKLJoAnw';
+const REQUEST_KEY = 'O43z0dpjhgX20SCx4KAo';
+const CHALLENGE_URL = 'https://jnn-pa.googleapis.com/$rpc/google.internal.waa.v1.Waa/Create';
+/**
+ * Lazy import of bgutils-js. Throws if the package is not installed.
+ */
+async function importBg() {
+    try {
+        const mod = (await Promise.resolve().then(() => __importStar(require('bgutils-js'))));
+        return mod.BG ?? mod;
+    }
+    catch {
+        return null;
+    }
+}
+class AutoPoTokenProvider {
+    fetchImpl;
+    ttlMs;
+    challengeTtlMs;
+    visitorData;
+    cache = null;
+    constructor(opts = {}) {
+        const f = opts.fetchImpl ?? globalThis.fetch.bind(globalThis);
+        if (!f) {
+            throw new Error('No fetch implementation available');
+        }
+        this.fetchImpl = f;
+        this.ttlMs = opts.ttlMs ?? 12 * 60 * 60 * 1000;
+        this.challengeTtlMs = opts.challengeTtlMs ?? 5 * 60 * 1000;
+        this.visitorData = opts.visitorData;
+    }
+    setVisitorData(visitorData) {
+        this.visitorData = visitorData;
+    }
+    /**
+     * Whether bgutils-js is installed and the provider is usable.
+     */
+    isAvailable() {
+        // Synchronous check via require cache is unreliable; the real check
+        // happens lazily in generateForVideo().
+        try {
+            require.resolve('bgutils-js');
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async generateForVideo(videoId) {
+        if (this.cache?.lastVideoId === videoId &&
+            this.cache.lastTokenResult &&
+            (0, types_js_1.isTokenFresh)(this.cache.lastTokenResult, 60_000)) {
+            return this.cache.lastTokenResult;
+        }
+        const bg = await importBg();
+        if (!bg) {
+            throw new index_js_1.BotDetected(videoId);
+        }
+        const visitorData = this.visitorData ?? videoId;
+        try {
+            const challengeEntry = await this.getOrLoadChallenge(bg);
+            const botguard = await bg.BotGuardClient.create({
+                program: challengeEntry.challenge.program,
+                globalName: challengeEntry.challenge.globalName,
+                globalObj: challengeEntry.globalObj,
+            });
+            const result = await bg.PoToken.generate({
+                program: challengeEntry.challenge.program,
+                globalName: challengeEntry.challenge.globalName,
+                bgConfig: {
+                    fetch: this.fetchImpl.bind(globalThis),
+                    globalObj: challengeEntry.globalObj,
+                    identifier: visitorData,
+                    requestKey: REQUEST_KEY,
+                },
+            });
+            const tokenResult = {
+                poToken: result.poToken,
+                visitorData,
+                expiresAt: new Date(Date.now() + this.ttlMs),
+            };
+            this.cache = {
+                ...challengeEntry,
+                botguard,
+                lastVideoId: videoId,
+                lastTokenResult: tokenResult,
+            };
+            return tokenResult;
+        }
+        catch (err) {
+            if (err instanceof index_js_1.BotDetected)
+                throw err;
+            throw new index_js_1.BotDetected(videoId);
+        }
+    }
+    async dispose() {
+        if (this.cache?.botguard?.shutdown) {
+            try {
+                await this.cache.botguard.shutdown();
+            }
+            catch {
+                // ignore
+            }
+        }
+        this.cache = null;
+    }
+    async getOrLoadChallenge(bg) {
+        if (this.cache && Date.now() - this.cache.fetchedAt < this.challengeTtlMs) {
+            return this.cache;
+        }
+        const response = await this.fetchImpl(CHALLENGE_URL, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json+protobuf',
+                'x-goog-api-key': WAA_API_KEY,
+                'x-user-agent': 'grpc-web-javascript/0.1',
+            },
+            body: JSON.stringify([REQUEST_KEY]),
+        });
+        if (!response.ok) {
+            throw new index_js_1.BotDetected('__challenge__');
+        }
+        const rawData = (await response.json());
+        const parsed = bg.Challenge.parseChallengeData
+            ? bg.Challenge.parseChallengeData(rawData)
+            : rawData;
+        const challenge = parsed;
+        if (!challenge?.program || !challenge?.globalName) {
+            throw new index_js_1.BotDetected('__challenge__');
+        }
+        // Execute interpreter script to populate globalObj[globalName].
+        const globalObj = globalThis ?? {};
+        const script = challenge.interpreterJavascript.privateDoNotAccessOrElseSafeScriptWrappedValue;
+        if (typeof script === 'string' && script.length > 0 && !globalObj[challenge.globalName]) {
+            try {
+                new Function(script)();
+            }
+            catch {
+                throw new index_js_1.BotDetected('__challenge__');
+            }
+        }
+        const entry = {
+            challenge,
+            globalObj,
+            botguard: null,
+            fetchedAt: Date.now(),
+        };
+        this.cache = entry;
+        return entry;
+    }
+}
+exports.AutoPoTokenProvider = AutoPoTokenProvider;
+//# sourceMappingURL=AutoPoTokenProvider.js.map

package/dist/cjs/potoken/AutoPoTokenProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoPoTokenProvider.js","sourceRoot":"","sources":["../../../src/potoken/AutoPoTokenProvider.ts"],"names":[],"mappings":"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"}

package/dist/cjs/potoken/HttpPoTokenProvider.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpPoTokenProvider = void 0;
+const index_js_1 = require("../errors/index.js");
+const types_js_1 = require("./types.js");
+/**
+ * Talks to a `bgutil-ytdlp-pot-provider`-compatible HTTP endpoint to fetch
+ * PoTokens. Useful for users who already run the provider as a sidecar.
+ *
+ * Protocol (compatible with bgutil-ytdlp-pot-provider):
+ *
+ *   POST {baseUrl}/get_pot
+ *   Content-Type: application/json
+ *   Body: { video_id, visitor_data? }
+ *   → 200 { po_token, visitor_data, expiration? }
+ *
+ * If the server returns no token, throws `BotDetected`.
+ */
+class HttpPoTokenProvider {
+    baseUrl;
+    timeoutMs;
+    fetchImpl;
+    ttlMs;
+    cache = null;
+    signal;
+    constructor(opts) {
+        if (!opts.baseUrl) {
+            throw new Error('HttpPoTokenProvider requires baseUrl');
+        }
+        this.baseUrl = opts.baseUrl.replace(/\/+$/, '');
+        this.timeoutMs = opts.timeoutMs ?? 30_000;
+        const f = opts.fetchImpl ?? globalThis.fetch.bind(globalThis);
+        if (!f) {
+            throw new Error('No fetch implementation available');
+        }
+        this.fetchImpl = f;
+        this.ttlMs = opts.ttlMs ?? 12 * 60 * 60 * 1000; // 12h default
+        this.signal = opts.signal;
+    }
+    async generateForVideo(videoId) {
+        if (this.cache && this.cache.videoId === videoId && (0, types_js_1.isTokenFresh)(this.cache.result)) {
+            return this.cache.result;
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        this.signal?.addEventListener('abort', () => controller.abort(), { once: true });
+        try {
+            const response = await this.fetchImpl(`${this.baseUrl}/get_pot`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ video_id: videoId }),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new index_js_1.BotDetected(videoId);
+            }
+            const data = (await response.json());
+            if (!data.po_token || !data.visitor_data) {
+                throw new index_js_1.BotDetected(videoId);
+            }
+            const expiresAt = parseExpiration(data.expiration, this.ttlMs);
+            const result = {
+                poToken: data.po_token,
+                visitorData: data.visitor_data,
+                expiresAt,
+            };
+            this.cache = { videoId, result };
+            return result;
+        }
+        catch (err) {
+            if (err instanceof index_js_1.BotDetected)
+                throw err;
+            // Re-throw AbortError directly so tests / callers can distinguish
+            // timeout from other failures.
+            if (err instanceof Error && err.name === 'AbortError') {
+                throw new Error(`PoToken request timed out for video "${videoId}"`);
+            }
+            // Wrap network errors as BotDetected since they likely indicate the
+            // provider is down or unreachable.
+            if (process.env['DEBUG_POT']) {
+                console.error('[HttpPoTokenProvider] fetch failed:', err);
+            }
+            throw new index_js_1.BotDetected(videoId);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async dispose() {
+        this.cache = null;
+    }
+}
+exports.HttpPoTokenProvider = HttpPoTokenProvider;
+function parseExpiration(value, fallbackMs) {
+    if (typeof value === 'number') {
+        return new Date(value > 1e12 ? value : Date.now() + value);
+    }
+    if (typeof value === 'string') {
+        const parsed = Date.parse(value);
+        if (Number.isFinite(parsed))
+            return new Date(parsed);
+    }
+    return new Date(Date.now() + fallbackMs);
+}
+//# sourceMappingURL=HttpPoTokenProvider.js.map