youtube-transcript-nodejs 0.1.0

package/dist/esm/api/YouTubeTranscriptApi.d.ts

@@ -0,0 +1,88 @@
+import type { FetchedTranscript, TranscriptList } from '../models/index.js';
+import type { PoTokenProvider } from '../potoken/types.js';
+import { mapHttpStatusToError } from './InnerTubeClient.js';
+/**
+ * Public-facing configuration for {@link YouTubeTranscriptApi}.
+ */
+export interface YouTubeTranscriptApiConfig {
+    /** HTTP proxy URL (http / https / socks5). Triggers undici dynamic import. */
+    proxyConfig?: {
+        url: string;
+    };
+    /** Extra cookies to set (e.g. CONSENT for EU). */
+    cookies?: Array<{
+        name: string;
+        value: string;
+        domain?: string;
+        path?: string;
+    }>;
+    /** Default headers added to every request. */
+    headers?: Record<string, string>;
+    /** PoToken provider. Defaults to {@link NoopPoTokenProvider}. */
+    poTokenProvider?: PoTokenProvider;
+    /** When true, ANDROID failures trigger a WEB + PoToken retry. */
+    poTokenFallback?: boolean;
+    /** Custom User-Agent. */
+    userAgent?: string;
+    /** Custom fetch implementation (mainly for tests). */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Public façade — the single entry-point most users will need.
+ *
+ * Mirrors `YouTubeTranscriptApi` from the Python library:
+ *
+ *   const api = new YouTubeTranscriptApi();
+ *   const t = await api.fetch(videoId);
+ *   const list = await api.list(videoId);
+ *   const translated = await api.translate(videoId, 'fr');
+ *   const langs = await api.translationLanguages(videoId, 'en');
+ */
+export declare class YouTubeTranscriptApi {
+    private readonly http;
+    private readonly innerTube;
+    private readonly jar;
+    private readonly poTokenProvider;
+    private readonly poTokenFallback;
+    private lastStrategy;
+    constructor(config?: YouTubeTranscriptApiConfig);
+    /**
+     * Replace the PoToken provider after construction.
+     */
+    setPoTokenProvider(provider: PoTokenProvider): void;
+    /**
+     * Fetch a transcript with language fallback.
+     *
+     * @param videoId  YouTube video id (or full URL).
+     * @param opts     `languages`: ordered language codes to try.
+     *                 `preserveFormatting`: keep `<i>`/`<b>` tags.
+     */
+    fetch(videoId: string, opts?: {
+        languages?: readonly string[];
+        preserveFormatting?: boolean;
+    }): Promise<FetchedTranscript>;
+    /**
+     * List all available transcript tracks for a video.
+     */
+    list(videoId: string): Promise<TranscriptList>;
+    /**
+     * Translate an available track into another language and return its cues.
+     */
+    translate(videoId: string, targetLang: string, opts?: {
+        sourceLanguage?: string;
+        preserveFormatting?: boolean;
+    }): Promise<FetchedTranscript>;
+    /**
+     * Returns the list of languages this video's `sourceLanguage` track can be
+     * translated into.
+     */
+    translationLanguages(videoId: string, sourceLanguage: string): Promise<readonly {
+        languageCode: string;
+        languageName: string;
+    }[]>;
+    private resolveApiKey;
+    private runStrategy;
+    private tryPlayer;
+}
+export { mapHttpStatusToError };
+//# sourceMappingURL=YouTubeTranscriptApi.d.ts.map

package/dist/esm/api/YouTubeTranscriptApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"YouTubeTranscriptApi.d.ts","sourceRoot":"","sources":["../../../src/api/YouTubeTranscriptApi.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAG5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAmB,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,8EAA8E;IAC9E,WAAW,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,kDAAkD;IAClD,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjF,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iEAAiE;IACjE,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,iEAAiE;IACjE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,YAAY,CAA8D;gBAEtE,MAAM,GAAE,0BAA+B;IAmBnD;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAKnD;;;;;;OAMG;IACG,KAAK,CACT,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAO,GACzE,OAAO,CAAC,iBAAiB,CAAC;IAM7B;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAuBpD;;OAEG;IACG,SAAS,CACb,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAO,GACnE,OAAO,CAAC,iBAAiB,CAAC;IAO7B;;;OAGG;IACG,oBAAoB,CACxB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,SAAS;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;YAMvD,aAAa;YAgBb,WAAW;YAgCX,SAAS;CAIxB;AAGD,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/esm/api/YouTubeTranscriptApi.js

@@ -0,0 +1,157 @@
+import { ANDROID_INNERTUBE_CONTEXT, WEB_INNERTUBE_CONTEXT, } from '../config/innerTubeContext.js';
+import { BotDetected, FailedToCreateConsentCookie, IpBlocked, TranscriptsDisabled, VideoUnavailable, VideoUnplayable, YouTubeRequestFailed, } from '../errors/index.js';
+import { CookieJar } from '../http/cookieJar.js';
+import { HttpClient } from '../http/httpClient.js';
+import { buildTranscriptList } from '../models/index.js';
+import { NoopPoTokenProvider } from '../potoken/NoopPoTokenProvider.js';
+import { InnerTubeClient, mapHttpStatusToError } from './InnerTubeClient.js';
+/**
+ * Public façade — the single entry-point most users will need.
+ *
+ * Mirrors `YouTubeTranscriptApi` from the Python library:
+ *
+ *   const api = new YouTubeTranscriptApi();
+ *   const t = await api.fetch(videoId);
+ *   const list = await api.list(videoId);
+ *   const translated = await api.translate(videoId, 'fr');
+ *   const langs = await api.translationLanguages(videoId, 'en');
+ */
+export class YouTubeTranscriptApi {
+    http;
+    innerTube;
+    jar;
+    poTokenProvider;
+    poTokenFallback;
+    lastStrategy = null;
+    constructor(config = {}) {
+        this.jar = new CookieJar();
+        if (config.cookies) {
+            for (const c of config.cookies) {
+                this.jar.set({ name: c.name, value: c.value, domain: c.domain, path: c.path });
+            }
+        }
+        this.http = new HttpClient({
+            userAgent: config.userAgent,
+            cookies: this.jar,
+            defaultHeaders: config.headers,
+            proxyUrl: config.proxyConfig?.url,
+            fetchImpl: config.fetchImpl,
+        });
+        this.innerTube = new InnerTubeClient({ http: this.http });
+        this.poTokenProvider = config.poTokenProvider ?? new NoopPoTokenProvider();
+        this.poTokenFallback = config.poTokenFallback === true;
+    }
+    /**
+     * Replace the PoToken provider after construction.
+     */
+    setPoTokenProvider(provider) {
+        this.lastStrategy = null; // force re-evaluation
+        this.poTokenProvider = provider;
+    }
+    /**
+     * Fetch a transcript with language fallback.
+     *
+     * @param videoId  YouTube video id (or full URL).
+     * @param opts     `languages`: ordered language codes to try.
+     *                 `preserveFormatting`: keep `<i>`/`<b>` tags.
+     */
+    async fetch(videoId, opts = {}) {
+        const list = await this.list(videoId);
+        const transcript = list.findTranscript(opts.languages ?? ['en']);
+        return transcript.fetch(opts.preserveFormatting ?? false);
+    }
+    /**
+     * List all available transcript tracks for a video.
+     */
+    async list(videoId) {
+        const apiKey = await this.resolveApiKey(videoId);
+        const strategy = await this.runStrategy(videoId, apiKey);
+        const playerJson = await this.innerTube.fetchPlayer(videoId, apiKey, strategy.context);
+        const { captionTracks, translationLanguages } = this.innerTube.extractCaptionTracks(playerJson, videoId);
+        this.lastStrategy = { context: strategy.context, apiKey };
+        return buildTranscriptList(this.innerTube, videoId, captionTracks.map((t) => ({
+            baseUrl: t.baseUrl,
+            languageCode: t.languageCode,
+            name: t.name,
+            kind: t.kind,
+            isTranslatable: t.isTranslatable,
+        })), translationLanguages);
+    }
+    /**
+     * Translate an available track into another language and return its cues.
+     */
+    async translate(videoId, targetLang, opts = {}) {
+        const list = await this.list(videoId);
+        const src = list.findTranscript(opts.sourceLanguage ? [opts.sourceLanguage] : ['en']);
+        const translated = src.translate(targetLang);
+        return translated.fetch(opts.preserveFormatting ?? false);
+    }
+    /**
+     * Returns the list of languages this video's `sourceLanguage` track can be
+     * translated into.
+     */
+    async translationLanguages(videoId, sourceLanguage) {
+        const list = await this.list(videoId);
+        const src = list.findTranscript([sourceLanguage]);
+        return src.translationLanguages;
+    }
+    async resolveApiKey(videoId) {
+        if (this.lastStrategy?.apiKey)
+            return this.lastStrategy.apiKey;
+        let html;
+        try {
+            html = await this.innerTube.fetchWatchHtml(videoId);
+        }
+        catch (err) {
+            if (err instanceof FailedToCreateConsentCookie)
+                throw err;
+            if (err instanceof IpBlocked)
+                throw err;
+            if (err instanceof VideoUnavailable)
+                throw err;
+            if (err instanceof VideoUnplayable)
+                throw err;
+            if (err instanceof TranscriptsDisabled)
+                throw err;
+            throw err;
+        }
+        return this.innerTube.extractApiKey(html, videoId);
+    }
+    async runStrategy(videoId, apiKey) {
+        // Layer 1: ANDROID
+        try {
+            await this.tryPlayer(videoId, apiKey, ANDROID_INNERTUBE_CONTEXT);
+            return { context: ANDROID_INNERTUBE_CONTEXT };
+        }
+        catch (err) {
+            const fallbackEligible = err instanceof BotDetected ||
+                err instanceof IpBlocked ||
+                err instanceof TranscriptsDisabled ||
+                err instanceof VideoUnplayable;
+            if (!fallbackEligible || !this.poTokenFallback || this.poTokenProvider instanceof NoopPoTokenProvider) {
+                throw err;
+            }
+            // Layer 2: WEB + PoToken
+            try {
+                await this.poTokenProvider.generateForVideo(videoId);
+            }
+            catch {
+                throw err; // Surface the original Layer 1 error.
+            }
+            try {
+                await this.tryPlayer(videoId, apiKey, WEB_INNERTUBE_CONTEXT);
+                return { context: WEB_INNERTUBE_CONTEXT };
+            }
+            catch (err2) {
+                throw err2 instanceof Error ? err2 : new YouTubeRequestFailed(videoId, 0, String(err2), '');
+            }
+        }
+    }
+    async tryPlayer(videoId, apiKey, ctx) {
+        const playerJson = await this.innerTube.fetchPlayer(videoId, apiKey, ctx);
+        this.innerTube.extractCaptionTracks(playerJson, videoId);
+    }
+}
+// Re-export for backward compat and convenience
+export { mapHttpStatusToError };
+//# sourceMappingURL=YouTubeTranscriptApi.js.map

package/dist/esm/api/YouTubeTranscriptApi.js.map

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

package/dist/esm/api/fetchStrategies.d.ts

@@ -0,0 +1,20 @@
+import { type InnerTubeContext } from '../config/innerTubeContext.js';
+import type { PoTokenProvider } from '../potoken/types.js';
+import type { InnerTubeClient } from './InnerTubeClient.js';
+/**
+ * Strategy result indicating which client succeeded.
+ */
+export interface FetchStrategyResult {
+    readonly context: InnerTubeContext;
+    readonly poToken: string | undefined;
+    readonly visitorData: string | undefined;
+}
+/**
+ * Strategy: try ANDROID InnerTube first; on `BotDetected` / `IpBlocked`,
+ * optionally fall back to WEB + PoToken if the user has supplied a provider.
+ */
+export declare function runFetchStrategy(client: InnerTubeClient, videoId: string, apiKey: string, opts?: {
+    poTokenProvider?: PoTokenProvider;
+    enableFallback?: boolean;
+}): Promise<FetchStrategyResult>;
+//# sourceMappingURL=fetchStrategies.d.ts.map

package/dist/esm/api/fetchStrategies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchStrategies.d.ts","sourceRoot":"","sources":["../../../src/api/fetchStrategies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoD,KAAK,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAExH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IACJ,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,cAAc,CAAC,EAAE,OAAO,CAAC;CACrB,GACL,OAAO,CAAC,mBAAmB,CAAC,CAgC9B"}

package/dist/esm/api/fetchStrategies.js

@@ -0,0 +1,48 @@
+import { ANDROID_INNERTUBE_CONTEXT, WEB_INNERTUBE_CONTEXT } from '../config/innerTubeContext.js';
+import { BotDetected, IpBlocked } from '../errors/index.js';
+/**
+ * Strategy: try ANDROID InnerTube first; on `BotDetected` / `IpBlocked`,
+ * optionally fall back to WEB + PoToken if the user has supplied a provider.
+ */
+export async function runFetchStrategy(client, videoId, apiKey, opts = {}) {
+    // Layer 1: ANDROID
+    const androidResult = await tryClient(client, videoId, apiKey, ANDROID_INNERTUBE_CONTEXT);
+    if (androidResult.ok) {
+        return { context: ANDROID_INNERTUBE_CONTEXT, poToken: undefined, visitorData: undefined };
+    }
+    // Layer 2: WEB + PoToken (opt-in)
+    if (opts.enableFallback === true &&
+        opts.poTokenProvider !== undefined &&
+        isFallbackTrigger(androidResult.error)) {
+        const tokenResult = await opts.poTokenProvider.generateForVideo(videoId);
+        const webResult = await tryClient(client, videoId, apiKey, WEB_INNERTUBE_CONTEXT, { poToken: tokenResult.poToken, visitorData: tokenResult.visitorData });
+        if (webResult.ok) {
+            return {
+                context: WEB_INNERTUBE_CONTEXT,
+                poToken: tokenResult.poToken,
+                visitorData: tokenResult.visitorData,
+            };
+        }
+        throw webResult.error;
+    }
+    throw androidResult.error;
+}
+async function tryClient(client, videoId, apiKey, ctx, 
+// Reserved for future use (e.g. attaching PoToken body field in WEB path).
+_token) {
+    try {
+        const data = await client.fetchPlayer(videoId, apiKey, ctx);
+        client.extractCaptionTracks(data, videoId);
+        return { ok: true, error: new Error('unreachable') };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: err instanceof Error ? err : new Error(String(err)),
+        };
+    }
+}
+function isFallbackTrigger(err) {
+    return err instanceof BotDetected || err instanceof IpBlocked;
+}
+//# sourceMappingURL=fetchStrategies.js.map

package/dist/esm/api/fetchStrategies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchStrategies.js","sourceRoot":"","sources":["../../../src/api/fetchStrategies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAyB,MAAM,+BAA+B,CAAC;AACxH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAa5D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAuB,EACvB,OAAe,EACf,MAAc,EACd,OAGI,EAAE;IAEN,mBAAmB;IACnB,MAAM,aAAa,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,yBAAyB,CAAC,CAAC;IAC1F,IAAI,aAAa,CAAC,EAAE,EAAE,CAAC;QACrB,OAAO,EAAE,OAAO,EAAE,yBAAyB,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;IAC5F,CAAC;IAED,kCAAkC;IAClC,IACE,IAAI,CAAC,cAAc,KAAK,IAAI;QAC5B,IAAI,CAAC,eAAe,KAAK,SAAS;QAClC,iBAAiB,CAAC,aAAa,CAAC,KAAK,CAAC,EACtC,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACzE,MAAM,SAAS,GAAG,MAAM,SAAS,CAC/B,MAAM,EACN,OAAO,EACP,MAAM,EACN,qBAAqB,EACrB,EAAE,OAAO,EAAE,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,WAAW,EAAE,CACvE,CAAC;QACF,IAAI,SAAS,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO;gBACL,OAAO,EAAE,qBAAqB;gBAC9B,OAAO,EAAE,WAAW,CAAC,OAAO;gBAC5B,WAAW,EAAE,WAAW,CAAC,WAAW;aACrC,CAAC;QACJ,CAAC;QACD,MAAM,SAAS,CAAC,KAAK,CAAC;IACxB,CAAC;IAED,MAAM,aAAa,CAAC,KAAK,CAAC;AAC5B,CAAC;AAOD,KAAK,UAAU,SAAS,CACtB,MAAuB,EACvB,OAAe,EACf,MAAc,EACd,GAAqB;AACrB,2EAA2E;AAC3E,MAAiD;IAEjD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;QAC5D,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;IACvD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;SAC3D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAU;IACnC,OAAO,GAAG,YAAY,WAAW,IAAI,GAAG,YAAY,SAAS,CAAC;AAChE,CAAC"}

package/dist/esm/config/constants.d.ts

@@ -0,0 +1,30 @@
+/**
+ * YouTube URL constants and default request settings.
+ *
+ * These mirror the values hardcoded in the Python `youtube-transcript-api`
+ * library (v1.2.4), with the addition of an explicit default User-Agent
+ * (the Python library used `python-requests/x.y.z`; we pick a stable UA
+ * matching a recent Android Chrome so PoToken challenges behave consistently).
+ */
+export declare const WATCH_URL = "https://www.youtube.com/watch?v={video_id}";
+/** InnerTube API endpoint. The `key` query parameter is the INNERTUBE_API_KEY. */
+export declare const INNERTUBE_API_URL = "https://www.youtube.com/youtubei/v1/player?key={api_key}";
+/** YouTube's CDN host for player JS (base.js). Used by the AutoPoTokenProvider. */
+export declare const BASE_JS_HOST = "https://www.youtube.com";
+/** Default request timeout for the inner fetch wrappers (Node global fetch). */
+export declare const DEFAULT_REQUEST_TIMEOUT_MS = 30000;
+/** Default User-Agent: a recent Android Chrome — PoToken-friendly. */
+export declare const DEFAULT_USER_AGENT: string;
+/** Default Accept-Language header (matches Python library default). */
+export declare const DEFAULT_ACCEPT_LANGUAGE = "en-US";
+/** Cap on retries for IP-block responses. Mirrors Python's proxy_config default. */
+export declare const DEFAULT_RETRIES_WHEN_BLOCKED = 3;
+/** base.js refresh interval (5 minutes). YouTube re-rolls obfuscation frequently. */
+export declare const BASE_JS_CACHE_TTL_MS: number;
+/** PoToken TTL — slightly conservative (YouTube uses ~12-24h, we refresh at 12h). */
+export declare const DEFAULT_POTOKEN_TTL_MS: number;
+/** Maximum length of a valid YouTube video id. */
+export declare const VIDEO_ID_LENGTH = 11;
+/** Regex for the canonical 11-char video id (alphanumeric + `-_`). */
+export declare const VIDEO_ID_REGEX: RegExp;
+//# sourceMappingURL=constants.d.ts.map

package/dist/esm/config/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/config/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,SAAS,+CAA+C,CAAC;AAEtE,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,6DAA6D,CAAC;AAE5F,mFAAmF;AACnF,eAAO,MAAM,YAAY,4BAA4B,CAAC;AAEtD,gFAAgF;AAChF,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD,sEAAsE;AACtE,eAAO,MAAM,kBAAkB,QAE8B,CAAC;AAE9D,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAE/C,oFAAoF;AACpF,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,qFAAqF;AACrF,eAAO,MAAM,oBAAoB,QAAgB,CAAC;AAElD,qFAAqF;AACrF,eAAO,MAAM,sBAAsB,QAAsB,CAAC;AAE1D,kDAAkD;AAClD,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,sEAAsE;AACtE,eAAO,MAAM,cAAc,QAAwB,CAAC"}

package/dist/esm/config/constants.js

@@ -0,0 +1,31 @@
+/**
+ * YouTube URL constants and default request settings.
+ *
+ * These mirror the values hardcoded in the Python `youtube-transcript-api`
+ * library (v1.2.4), with the addition of an explicit default User-Agent
+ * (the Python library used `python-requests/x.y.z`; we pick a stable UA
+ * matching a recent Android Chrome so PoToken challenges behave consistently).
+ */
+export const WATCH_URL = 'https://www.youtube.com/watch?v={video_id}';
+/** InnerTube API endpoint. The `key` query parameter is the INNERTUBE_API_KEY. */
+export const INNERTUBE_API_URL = 'https://www.youtube.com/youtubei/v1/player?key={api_key}';
+/** YouTube's CDN host for player JS (base.js). Used by the AutoPoTokenProvider. */
+export const BASE_JS_HOST = 'https://www.youtube.com';
+/** Default request timeout for the inner fetch wrappers (Node global fetch). */
+export const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
+/** Default User-Agent: a recent Android Chrome — PoToken-friendly. */
+export const DEFAULT_USER_AGENT = 'Mozilla/5.0 (Linux; Android 10; SM-A205U) AppleWebKit/537.36 ' +
+    '(KHTML, like Gecko) Chrome/124.0.0.0 Mobile Safari/537.36';
+/** Default Accept-Language header (matches Python library default). */
+export const DEFAULT_ACCEPT_LANGUAGE = 'en-US';
+/** Cap on retries for IP-block responses. Mirrors Python's proxy_config default. */
+export const DEFAULT_RETRIES_WHEN_BLOCKED = 3;
+/** base.js refresh interval (5 minutes). YouTube re-rolls obfuscation frequently. */
+export const BASE_JS_CACHE_TTL_MS = 5 * 60 * 1000;
+/** PoToken TTL — slightly conservative (YouTube uses ~12-24h, we refresh at 12h). */
+export const DEFAULT_POTOKEN_TTL_MS = 12 * 60 * 60 * 1000;
+/** Maximum length of a valid YouTube video id. */
+export const VIDEO_ID_LENGTH = 11;
+/** Regex for the canonical 11-char video id (alphanumeric + `-_`). */
+export const VIDEO_ID_REGEX = /^[A-Za-z0-9_-]{11}$/;
+//# sourceMappingURL=constants.js.map

package/dist/esm/config/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/config/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,4CAA4C,CAAC;AAEtE,kFAAkF;AAClF,MAAM,CAAC,MAAM,iBAAiB,GAAG,0DAA0D,CAAC;AAE5F,mFAAmF;AACnF,MAAM,CAAC,MAAM,YAAY,GAAG,yBAAyB,CAAC;AAEtD,gFAAgF;AAChF,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAEjD,sEAAsE;AACtE,MAAM,CAAC,MAAM,kBAAkB,GAC7B,+DAA+D;IAC/D,2DAA2D,CAAC;AAE9D,uEAAuE;AACvE,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC;AAE/C,oFAAoF;AACpF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAE9C,qFAAqF;AACrF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAElD,qFAAqF;AACrF,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE1D,kDAAkD;AAClD,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAElC,sEAAsE;AACtE,MAAM,CAAC,MAAM,cAAc,GAAG,qBAAqB,CAAC"}

package/dist/esm/config/innerTubeContext.d.ts

@@ -0,0 +1,47 @@
+/**
+ * InnerTube client contexts.
+ *
+ * Mirrors the Python library's hardcoded ANDROID context
+ * (`{"client":{"clientName":"ANDROID","clientVersion":"20.10.38"}}`)
+ * which sidesteps the web client's PoToken requirement. We also expose
+ * WEB + TVHTML5 contexts as escape hatches.
+ */
+export interface InnerTubeContext {
+    readonly client: {
+        readonly clientName: string;
+        readonly clientVersion: string;
+        readonly hl?: string;
+        readonly gl?: string;
+        readonly userAgent?: string;
+        readonly androidSdkVersion?: number;
+    };
+}
+/**
+ * Android InnerTube client — the primary path. Matches Python 1.2.4.
+ *
+ * YouTube historically does NOT require PoToken from ANDROID clients when
+ * the request also carries `X-YouTube-Client-Name: 3` and the matching UA.
+ */
+export declare const ANDROID_INNERTUBE_CONTEXT: InnerTubeContext;
+/**
+ * Web InnerTube client — used as the fallback path with PoToken.
+ *
+ * Requires a valid PoToken + visitorData; otherwise InnerTube returns
+ * `LOGIN_REQUIRED` / BotGuard.
+ */
+export declare const WEB_INNERTUBE_CONTEXT: InnerTubeContext;
+/**
+ * TVHTML5_SIMPLY_EMBEDDED_PLAYER — used as a last-resort fallback. Generally
+ * less restrictive than WEB but more than ANDROID.
+ */
+export declare const TVHTML5_EMBEDDED_PLAYER_CONTEXT: InnerTubeContext;
+/**
+ * Returns the numeric `X-YouTube-Client-Name` header value for a given
+ * client context, used when issuing InnerTube requests.
+ */
+export declare function clientNameHeader(ctx: InnerTubeContext): string;
+/**
+ * Returns the `X-YouTube-Client-Version` header value.
+ */
+export declare function clientVersionHeader(ctx: InnerTubeContext): string;
+//# sourceMappingURL=innerTubeContext.d.ts.map

package/dist/esm/config/innerTubeContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"innerTubeContext.d.ts","sourceRoot":"","sources":["../../../src/config/innerTubeContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;KACrC,CAAC;CACH;AAED;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,EAAE,gBAQvC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,gBAOnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,+BAA+B,EAAE,gBAO7C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,CAgB9D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,CAEjE"}

package/dist/esm/config/innerTubeContext.js

@@ -0,0 +1,77 @@
+/**
+ * InnerTube client contexts.
+ *
+ * Mirrors the Python library's hardcoded ANDROID context
+ * (`{"client":{"clientName":"ANDROID","clientVersion":"20.10.38"}}`)
+ * which sidesteps the web client's PoToken requirement. We also expose
+ * WEB + TVHTML5 contexts as escape hatches.
+ */
+/**
+ * Android InnerTube client — the primary path. Matches Python 1.2.4.
+ *
+ * YouTube historically does NOT require PoToken from ANDROID clients when
+ * the request also carries `X-YouTube-Client-Name: 3` and the matching UA.
+ */
+export const ANDROID_INNERTUBE_CONTEXT = {
+    client: {
+        clientName: 'ANDROID',
+        clientVersion: '20.10.38',
+        hl: 'en',
+        gl: 'US',
+        androidSdkVersion: 30,
+    },
+};
+/**
+ * Web InnerTube client — used as the fallback path with PoToken.
+ *
+ * Requires a valid PoToken + visitorData; otherwise InnerTube returns
+ * `LOGIN_REQUIRED` / BotGuard.
+ */
+export const WEB_INNERTUBE_CONTEXT = {
+    client: {
+        clientName: 'WEB',
+        clientVersion: '2.20240101.00.00',
+        hl: 'en',
+        gl: 'US',
+    },
+};
+/**
+ * TVHTML5_SIMPLY_EMBEDDED_PLAYER — used as a last-resort fallback. Generally
+ * less restrictive than WEB but more than ANDROID.
+ */
+export const TVHTML5_EMBEDDED_PLAYER_CONTEXT = {
+    client: {
+        clientName: 'TVHTML5_SIMPLY_EMBEDDED_PLAYER',
+        clientVersion: '2.0',
+        hl: 'en',
+        gl: 'US',
+    },
+};
+/**
+ * Returns the numeric `X-YouTube-Client-Name` header value for a given
+ * client context, used when issuing InnerTube requests.
+ */
+export function clientNameHeader(ctx) {
+    switch (ctx.client.clientName) {
+        case 'ANDROID':
+            return '3';
+        case 'WEB':
+            return '1';
+        case 'TVHTML5':
+        case 'TVHTML5_SIMPLY_EMBEDDED_PLAYER':
+            return '85';
+        case 'IOS':
+            return '5';
+        case 'MWEB':
+            return '2';
+        default:
+            return '1';
+    }
+}
+/**
+ * Returns the `X-YouTube-Client-Version` header value.
+ */
+export function clientVersionHeader(ctx) {
+    return ctx.client.clientVersion;
+}
+//# sourceMappingURL=innerTubeContext.js.map

package/dist/esm/config/innerTubeContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"innerTubeContext.js","sourceRoot":"","sources":["../../../src/config/innerTubeContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD,MAAM,EAAE;QACN,UAAU,EAAE,SAAS;QACrB,aAAa,EAAE,UAAU;QACzB,EAAE,EAAE,IAAI;QACR,EAAE,EAAE,IAAI;QACR,iBAAiB,EAAE,EAAE;KACtB;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAqB;IACrD,MAAM,EAAE;QACN,UAAU,EAAE,KAAK;QACjB,aAAa,EAAE,kBAAkB;QACjC,EAAE,EAAE,IAAI;QACR,EAAE,EAAE,IAAI;KACT;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAqB;IAC/D,MAAM,EAAE;QACN,UAAU,EAAE,gCAAgC;QAC5C,aAAa,EAAE,KAAK;QACpB,EAAE,EAAE,IAAI;QACR,EAAE,EAAE,IAAI;KACT;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAqB;IACpD,QAAQ,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC9B,KAAK,SAAS;YACZ,OAAO,GAAG,CAAC;QACb,KAAK,KAAK;YACR,OAAO,GAAG,CAAC;QACb,KAAK,SAAS,CAAC;QACf,KAAK,gCAAgC;YACnC,OAAO,IAAI,CAAC;QACd,KAAK,KAAK;YACR,OAAO,GAAG,CAAC;QACb,KAAK,MAAM;YACT,OAAO,GAAG,CAAC;QACb;YACE,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAqB;IACvD,OAAO,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC;AAClC,CAAC"}

package/dist/esm/errors/BotDetected.d.ts

@@ -0,0 +1,13 @@
+import { YouTubeTranscriptError } from './YouTubeTranscriptError.js';
+/**
+ * Thrown when YouTube's InnerTube responds with LOGIN_REQUIRED + BotGuard reason
+ * (the bent-quote string `Sign in to confirm you're not a bot`).
+ *
+ * This is the canonical "PoToken required" signal in 1.2.4. Mirrors Python's
+ * `RequestBlocked` when triggered by BotGuard (mapped to `IpBlocked` there;
+ * we split it into a dedicated class for finer control).
+ */
+export declare class BotDetected extends YouTubeTranscriptError {
+    constructor(videoId: string);
+}
+//# sourceMappingURL=BotDetected.d.ts.map

package/dist/esm/errors/BotDetected.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BotDetected.d.ts","sourceRoot":"","sources":["../../../src/errors/BotDetected.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;;;;;GAOG;AACH,qBAAa,WAAY,SAAQ,sBAAsB;gBACzC,OAAO,EAAE,MAAM;CAM5B"}

package/dist/esm/errors/BotDetected.js

@@ -0,0 +1,16 @@
+import { YouTubeTranscriptError } from './YouTubeTranscriptError.js';
+/**
+ * Thrown when YouTube's InnerTube responds with LOGIN_REQUIRED + BotGuard reason
+ * (the bent-quote string `Sign in to confirm you're not a bot`).
+ *
+ * This is the canonical "PoToken required" signal in 1.2.4. Mirrors Python's
+ * `RequestBlocked` when triggered by BotGuard (mapped to `IpBlocked` there;
+ * we split it into a dedicated class for finer control).
+ */
+export class BotDetected extends YouTubeTranscriptError {
+    constructor(videoId) {
+        super(`YouTube BotGuard blocked the request for video "${videoId}". ` +
+            `Provide a PoToken provider (e.g. AutoPoTokenProvider) or use a proxy.`);
+    }
+}
+//# sourceMappingURL=BotDetected.js.map

package/dist/esm/errors/BotDetected.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BotDetected.js","sourceRoot":"","sources":["../../../src/errors/BotDetected.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,OAAO,WAAY,SAAQ,sBAAsB;IACrD,YAAY,OAAe;QACzB,KAAK,CACH,mDAAmD,OAAO,KAAK;YAC7D,uEAAuE,CAC1E,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/errors/FailedToCreateConsentCookie.d.ts

@@ -0,0 +1,10 @@
+import { YouTubeTranscriptError } from './YouTubeTranscriptError.js';
+/**
+ * Thrown when we hit the EU consent gate twice and cannot extract the `v`
+ * parameter from the form to set the CONSENT cookie. Mirrors Python's
+ * `FailedToCreateConsentCookie`.
+ */
+export declare class FailedToCreateConsentCookie extends YouTubeTranscriptError {
+    constructor(videoId: string);
+}
+//# sourceMappingURL=FailedToCreateConsentCookie.d.ts.map

package/dist/esm/errors/FailedToCreateConsentCookie.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FailedToCreateConsentCookie.d.ts","sourceRoot":"","sources":["../../../src/errors/FailedToCreateConsentCookie.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;;GAIG;AACH,qBAAa,2BAA4B,SAAQ,sBAAsB;gBACzD,OAAO,EAAE,MAAM;CAM5B"}

package/dist/esm/errors/FailedToCreateConsentCookie.js

@@ -0,0 +1,13 @@
+import { YouTubeTranscriptError } from './YouTubeTranscriptError.js';
+/**
+ * Thrown when we hit the EU consent gate twice and cannot extract the `v`
+ * parameter from the form to set the CONSENT cookie. Mirrors Python's
+ * `FailedToCreateConsentCookie`.
+ */
+export class FailedToCreateConsentCookie extends YouTubeTranscriptError {
+    constructor(videoId) {
+        super(`Failed to automatically give consent to YouTube for video "${videoId}". ` +
+            `Please set the CONSENT cookie manually and pass it via the \`cookies\` option.`);
+    }
+}
+//# sourceMappingURL=FailedToCreateConsentCookie.js.map

package/dist/esm/errors/FailedToCreateConsentCookie.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FailedToCreateConsentCookie.js","sourceRoot":"","sources":["../../../src/errors/FailedToCreateConsentCookie.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;;GAIG;AACH,MAAM,OAAO,2BAA4B,SAAQ,sBAAsB;IACrE,YAAY,OAAe;QACzB,KAAK,CACH,8DAA8D,OAAO,KAAK;YACxE,gFAAgF,CACnF,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/errors/InvalidVideoId.d.ts

@@ -0,0 +1,9 @@
+import { YouTubeTranscriptError } from './YouTubeTranscriptError.js';
+/**
+ * Thrown when the provided video id cannot be parsed or is invalid.
+ * Mirrors `InvalidVideoId` from the Python library.
+ */
+export declare class InvalidVideoId extends YouTubeTranscriptError {
+    constructor(videoId: string);
+}
+//# sourceMappingURL=InvalidVideoId.d.ts.map

package/dist/esm/errors/InvalidVideoId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvalidVideoId.d.ts","sourceRoot":"","sources":["../../../src/errors/InvalidVideoId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;GAGG;AACH,qBAAa,cAAe,SAAQ,sBAAsB;gBAC5C,OAAO,EAAE,MAAM;CAM5B"}