youtube-transcript-nodejs 0.1.0

package/dist/esm/http/httpClient.js

@@ -0,0 +1,191 @@
+import { DEFAULT_ACCEPT_LANGUAGE, DEFAULT_REQUEST_TIMEOUT_MS, DEFAULT_USER_AGENT, } from '../config/constants.js';
+import { YouTubeRequestFailed } from '../errors/index.js';
+import { parseProxyUrl } from '../util/proxyUrl.js';
+/**
+ * Thin HTTP client wrapper around global fetch.
+ *
+ * - Injects default User-Agent, Accept-Language, cookie headers
+ * - Honors a CookieJar (mutates it from `Set-Cookie` responses)
+ * - Supports proxy URLs via dynamic undici import (only loaded when needed)
+ * - Retries on 429
+ *
+ * Designed to be small and easily mockable for tests.
+ */
+export class HttpClient {
+    userAgent;
+    acceptLanguage;
+    defaultTimeoutMs;
+    cookies;
+    defaultHeaders;
+    proxyUrl;
+    fetchImpl;
+    retriesOn429;
+    proxyDispatcher;
+    constructor(config = {}) {
+        this.userAgent = config.userAgent ?? DEFAULT_USER_AGENT;
+        this.acceptLanguage = config.acceptLanguage ?? DEFAULT_ACCEPT_LANGUAGE;
+        this.defaultTimeoutMs = config.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+        this.cookies = config.cookies;
+        this.defaultHeaders = { ...config.defaultHeaders };
+        this.proxyUrl = config.proxyUrl;
+        this.fetchImpl = config.fetchImpl ?? globalThis.fetch.bind(globalThis);
+        this.retriesOn429 = config.retriesOn429 ?? 3;
+        if (!this.fetchImpl) {
+            throw new Error('No fetch implementation available; pass fetchImpl or run on Node 18+');
+        }
+    }
+    /**
+     * Build full headers for a request, merging defaults + per-request + cookies.
+     */
+    buildHeaders(url, perRequest) {
+        const headers = new Headers();
+        headers.set('User-Agent', this.userAgent);
+        headers.set('Accept-Language', this.acceptLanguage);
+        for (const [k, v] of Object.entries(this.defaultHeaders)) {
+            headers.set(k, v);
+        }
+        if (perRequest) {
+            for (const [k, v] of Object.entries(perRequest)) {
+                headers.set(k, v);
+            }
+        }
+        if (this.cookies) {
+            const cookieHeader = this.cookies.headerForUrl(url);
+            if (cookieHeader)
+                headers.set('Cookie', cookieHeader);
+        }
+        return headers;
+    }
+    /**
+     * GET request.
+     */
+    async get(url, opts = {}) {
+        return this.request(url, { ...opts, method: 'GET' });
+    }
+    /**
+     * POST request with a JSON body.
+     */
+    async postJson(url, body, opts = {}) {
+        const headers = { ...(opts.headers ?? {}), 'Content-Type': 'application/json' };
+        return this.request(url, {
+            ...opts,
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body),
+        });
+    }
+    /**
+     * Perform an HTTP request with retries on 429.
+     */
+    async request(url, opts = {}) {
+        const method = opts.method ?? 'GET';
+        const timeoutMs = opts.timeoutMs ?? this.defaultTimeoutMs;
+        const headers = this.buildHeaders(url, opts.headers);
+        const dispatcher = await this.maybeProxyDispatcher();
+        let lastErr;
+        const attempts = Math.max(1, this.retriesOn429);
+        for (let attempt = 1; attempt <= attempts; attempt++) {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+            const onUserAbort = () => controller.abort();
+            opts.signal?.addEventListener('abort', onUserAbort, { once: true });
+            try {
+                const fetchOpts = {
+                    method,
+                    headers,
+                    signal: controller.signal,
+                };
+                if (opts.body !== undefined)
+                    fetchOpts.body = opts.body;
+                if (dispatcher)
+                    fetchOpts.dispatcher = dispatcher;
+                const rawResponse = await this.fetchImpl(url, fetchOpts);
+                const response = await this.normalizeResponse(rawResponse);
+                // Capture Set-Cookie headers
+                if (this.cookies) {
+                    const setCookies = this.extractSetCookies(rawResponse);
+                    for (const sc of setCookies) {
+                        this.cookies.ingestSetCookie(sc, url);
+                    }
+                }
+                if (response.status === 429 && attempt < attempts) {
+                    // Exponential backoff
+                    await new Promise((r) => setTimeout(r, 200 * 2 ** (attempt - 1)));
+                    continue;
+                }
+                return response;
+            }
+            catch (err) {
+                lastErr = err;
+                if (attempt >= attempts) {
+                    if (err instanceof Error && err.name === 'AbortError') {
+                        throw new YouTubeRequestFailed(url, 0, 'Request aborted (timeout)', url);
+                    }
+                    throw err;
+                }
+                await new Promise((r) => setTimeout(r, 200 * 2 ** (attempt - 1)));
+            }
+            finally {
+                clearTimeout(timeoutId);
+                opts.signal?.removeEventListener('abort', onUserAbort);
+            }
+        }
+        throw lastErr;
+    }
+    /**
+     * Wrap a raw `Response` so that `.json()` returns `unknown` and re-throwing
+     * makes the type usable in tests.
+     */
+    async normalizeResponse(raw) {
+        return {
+            status: raw.status,
+            statusText: raw.statusText,
+            ok: raw.ok,
+            text: () => raw.text(),
+            json: async () => {
+                try {
+                    return await raw.json();
+                }
+                catch (err) {
+                    throw new Error(`Failed to parse JSON response: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            },
+        };
+    }
+    extractSetCookies(raw) {
+        // Response.headers.getSetCookie is Node 18.14+ / 19.7+
+        const fn = raw.headers.getSetCookie;
+        if (typeof fn === 'function') {
+            try {
+                return fn.call(raw.headers);
+            }
+            catch {
+                // ignore
+            }
+        }
+        const single = raw.headers.get('set-cookie');
+        return single ? [single] : [];
+    }
+    /**
+     * Lazily load undici and create a ProxyAgent when a proxy URL is configured.
+     * Returns `undefined` if no proxy is set.
+     */
+    async maybeProxyDispatcher() {
+        if (!this.proxyUrl)
+            return undefined;
+        if (this.proxyDispatcher)
+            return this.proxyDispatcher;
+        const parsed = parseProxyUrl(this.proxyUrl);
+        if (!parsed) {
+            throw new Error(`Invalid proxy URL: ${this.proxyUrl}`);
+        }
+        // Dynamic import so `undici` stays optional.
+        const undici = (await import('undici'));
+        const agentUrl = this.proxyUrl.startsWith('http')
+            ? this.proxyUrl
+            : `${parsed.protocol}://${parsed.host}${parsed.port ? `:${parsed.port}` : ''}`;
+        this.proxyDispatcher = new undici.ProxyAgent(agentUrl);
+        return this.proxyDispatcher;
+    }
+}
+//# sourceMappingURL=httpClient.js.map

package/dist/esm/http/httpClient.js.map

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

package/dist/esm/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * youtube-transcript-nodejs — public API entry point.
+ */
+export { YouTubeTranscriptApi } from './api/YouTubeTranscriptApi.js';
+export type { YouTubeTranscriptApiConfig } from './api/YouTubeTranscriptApi.js';
+export { FetchedTranscript } from './models/FetchedTranscript.js';
+export { FetchedTranscriptSnippet } from './models/FetchedTranscriptSnippet.js';
+export { Transcript } from './models/Transcript.js';
+export { TranscriptList } from './models/TranscriptList.js';
+export type { TranslationLanguage } from './models/TranslationLanguage.js';
+export type { TranscriptMetadata } from './models/TranscriptMetadata.js';
+export type { FormattedTranscript } from './models/FormattedTranscript.js';
+export * from './errors/index.js';
+export { SRTFormatter, WebVTTFormatter, TextFormatter, JSONFormatter, PrettyPrintFormatter, computeEnd, toSrtTime, toVttTime, toPrettyTime, } from './formatters/index.js';
+export type { Formatter, FormattedOutput, SnippetLike } from './formatters/index.js';
+export type { PoTokenProvider, TokenResult } from './potoken/types.js';
+export { NoopPoTokenProvider, HttpPoTokenProvider, AutoPoTokenProvider, BaseScriptCache, isTokenFresh, } from './potoken/index.js';
+export type { HttpPoTokenProviderOptions, AutoPoTokenProviderOptions, BaseScriptCacheOptions, } from './potoken/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,YAAY,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAEhF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,YAAY,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,YAAY,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAG3E,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,UAAU,EACV,SAAS,EACT,SAAS,EACT,YAAY,GACb,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGrF,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,0BAA0B,EAC1B,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,oBAAoB,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,14 @@
+/**
+ * youtube-transcript-nodejs — public API entry point.
+ */
+export { YouTubeTranscriptApi } from './api/YouTubeTranscriptApi.js';
+export { FetchedTranscript } from './models/FetchedTranscript.js';
+export { FetchedTranscriptSnippet } from './models/FetchedTranscriptSnippet.js';
+export { Transcript } from './models/Transcript.js';
+export { TranscriptList } from './models/TranscriptList.js';
+// Re-export error classes for `instanceof` checks in user code.
+export * from './errors/index.js';
+// Re-export formatters so users can compose their own.
+export { SRTFormatter, WebVTTFormatter, TextFormatter, JSONFormatter, PrettyPrintFormatter, computeEnd, toSrtTime, toVttTime, toPrettyTime, } from './formatters/index.js';
+export { NoopPoTokenProvider, HttpPoTokenProvider, AutoPoTokenProvider, BaseScriptCache, isTokenFresh, } from './potoken/index.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAGrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAM5D,gEAAgE;AAChE,cAAc,mBAAmB,CAAC;AAElC,uDAAuD;AACvD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,UAAU,EACV,SAAS,EACT,SAAS,EACT,YAAY,GACb,MAAM,uBAAuB,CAAC;AAK/B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,YAAY,GACb,MAAM,oBAAoB,CAAC"}

package/dist/esm/models/FetchedTranscript.d.ts

@@ -0,0 +1,49 @@
+import { type Formatter } from '../formatters/index.js';
+import { FetchedTranscriptSnippet } from './FetchedTranscriptSnippet.js';
+import type { FormattedTranscript } from './FormattedTranscript.js';
+import type { TranscriptMetadata } from './TranscriptMetadata.js';
+/**
+ * Concrete transcript with all its cues loaded.
+ *
+ * Iterable and indexable. Provides formatting helpers that delegate
+ * to the formatter classes in `../formatters`.
+ */
+export declare class FetchedTranscript implements Iterable<FetchedTranscriptSnippet> {
+    readonly snippets: readonly FetchedTranscriptSnippet[];
+    readonly videoId: string;
+    readonly language: string;
+    readonly languageCode: string;
+    readonly isGenerated: boolean;
+    readonly translationLanguages: readonly {
+        languageCode: string;
+        languageName: string;
+    }[];
+    constructor(snippets: ReadonlyArray<{
+        text: string;
+        start: number;
+        duration: number;
+    }>, meta: TranscriptMetadata);
+    [Symbol.iterator](): IterableIterator<FetchedTranscriptSnippet>;
+    get length(): number;
+    /** Format using an arbitrary formatter. */
+    format(formatter: Formatter): FormattedTranscript;
+    /** Raw array form (matches Python `to_raw_data()`). */
+    toRaw(): FormattedTranscript;
+    /** Plain text — one snippet per line. */
+    toText(): FormattedTranscript;
+    /** SRT subtitle format. */
+    toSRT(): FormattedTranscript;
+    /** WebVTT subtitle format. */
+    toVTT(): FormattedTranscript;
+    /** Pretty-print human-readable. */
+    toPretty(): FormattedTranscript;
+    /** Serialize the entire transcript as a plain object. */
+    toJSON(): FormattedTranscript;
+    forEach(fn: (s: FetchedTranscriptSnippet, i: number) => void): void;
+    map<T>(fn: (s: FetchedTranscriptSnippet, i: number) => T): readonly T[];
+    filter(fn: (s: FetchedTranscriptSnippet, i: number) => boolean): readonly FetchedTranscriptSnippet[];
+    find(fn: (s: FetchedTranscriptSnippet, i: number) => boolean): FetchedTranscriptSnippet | undefined;
+    /** Pick a subset of snippets by 1-based line range (inclusive). */
+    slice(start: number, end?: number): readonly FetchedTranscriptSnippet[];
+}
+//# sourceMappingURL=FetchedTranscript.d.ts.map

package/dist/esm/models/FetchedTranscript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FetchedTranscript.d.ts","sourceRoot":"","sources":["../../../src/models/FetchedTranscript.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EAEf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,QAAQ,CAAC,wBAAwB,CAAC;IAC1E,QAAQ,CAAC,QAAQ,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,oBAAoB,EAAE,SAAS;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;gBAGvF,QAAQ,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,EAC1E,IAAI,EAAE,kBAAkB;IAY1B,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,wBAAwB,CAAC;IAI/D,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,2CAA2C;IAC3C,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,mBAAmB;IAKjD,uDAAuD;IACvD,KAAK,IAAI,mBAAmB;IAI5B,yCAAyC;IACzC,MAAM,IAAI,mBAAmB;IAI7B,2BAA2B;IAC3B,KAAK,IAAI,mBAAmB;IAI5B,8BAA8B;IAC9B,KAAK,IAAI,mBAAmB;IAI5B,mCAAmC;IACnC,QAAQ,IAAI,mBAAmB;IAI/B,yDAAyD;IACzD,MAAM,IAAI,mBAAmB;IAI7B,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,wBAAwB,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAInE,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,wBAAwB,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC,GAAG,SAAS,CAAC,EAAE;IAIvE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,wBAAwB,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,wBAAwB,EAAE;IAIpG,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,wBAAwB,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,GAAG,wBAAwB,GAAG,SAAS;IAInG,mEAAmE;IACnE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,wBAAwB,EAAE;CAGxE"}

package/dist/esm/models/FetchedTranscript.js

@@ -0,0 +1,76 @@
+import { JSONFormatter, PrettyPrintFormatter, SRTFormatter, TextFormatter, WebVTTFormatter, } from '../formatters/index.js';
+import { FetchedTranscriptSnippet } from './FetchedTranscriptSnippet.js';
+/**
+ * Concrete transcript with all its cues loaded.
+ *
+ * Iterable and indexable. Provides formatting helpers that delegate
+ * to the formatter classes in `../formatters`.
+ */
+export class FetchedTranscript {
+    snippets;
+    videoId;
+    language;
+    languageCode;
+    isGenerated;
+    translationLanguages;
+    constructor(snippets, meta) {
+        this.snippets = Object.freeze(snippets.map((s) => new FetchedTranscriptSnippet(s.text, s.start, s.duration)));
+        this.videoId = meta.videoId;
+        this.language = meta.languageName;
+        this.languageCode = meta.languageCode;
+        this.isGenerated = meta.isGenerated;
+        this.translationLanguages = meta.translationLanguages;
+    }
+    [Symbol.iterator]() {
+        return this.snippets[Symbol.iterator]();
+    }
+    get length() {
+        return this.snippets.length;
+    }
+    /** Format using an arbitrary formatter. */
+    format(formatter) {
+        const out = formatter.render(this.snippets);
+        return { content: out.content, extension: out.extension, mimeType: out.mimeType };
+    }
+    /** Raw array form (matches Python `to_raw_data()`). */
+    toRaw() {
+        return this.format(new JSONFormatter());
+    }
+    /** Plain text — one snippet per line. */
+    toText() {
+        return this.format(new TextFormatter());
+    }
+    /** SRT subtitle format. */
+    toSRT() {
+        return this.format(new SRTFormatter());
+    }
+    /** WebVTT subtitle format. */
+    toVTT() {
+        return this.format(new WebVTTFormatter());
+    }
+    /** Pretty-print human-readable. */
+    toPretty() {
+        return this.format(new PrettyPrintFormatter());
+    }
+    /** Serialize the entire transcript as a plain object. */
+    toJSON() {
+        return this.format(new JSONFormatter());
+    }
+    forEach(fn) {
+        this.snippets.forEach((s, i) => fn(s, i));
+    }
+    map(fn) {
+        return this.snippets.map(fn);
+    }
+    filter(fn) {
+        return this.snippets.filter(fn);
+    }
+    find(fn) {
+        return this.snippets.find(fn);
+    }
+    /** Pick a subset of snippets by 1-based line range (inclusive). */
+    slice(start, end) {
+        return this.snippets.slice(start, end);
+    }
+}
+//# sourceMappingURL=FetchedTranscript.js.map

package/dist/esm/models/FetchedTranscript.js.map

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

package/dist/esm/models/FetchedTranscriptSnippet.d.ts

@@ -0,0 +1,15 @@
+/**
+ * One snippet in a fetched transcript.
+ */
+export declare class FetchedTranscriptSnippet {
+    readonly text: string;
+    readonly start: number;
+    readonly duration: number;
+    constructor(text: string, start: number, duration: number);
+    /**
+     * End timestamp = start + duration (or earlier if the next snippet starts first).
+     * Lazily computed and cached.
+     */
+    endFor(_index: number, nextStart: number | undefined): number;
+}
+//# sourceMappingURL=FetchedTranscriptSnippet.d.ts.map

package/dist/esm/models/FetchedTranscriptSnippet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FetchedTranscriptSnippet.d.ts","sourceRoot":"","sources":["../../../src/models/FetchedTranscriptSnippet.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,wBAAwB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAMzD;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM;CAO9D"}

package/dist/esm/models/FetchedTranscriptSnippet.js

@@ -0,0 +1,25 @@
+/**
+ * One snippet in a fetched transcript.
+ */
+export class FetchedTranscriptSnippet {
+    text;
+    start;
+    duration;
+    constructor(text, start, duration) {
+        this.text = text;
+        this.start = start;
+        this.duration = duration;
+    }
+    /**
+     * End timestamp = start + duration (or earlier if the next snippet starts first).
+     * Lazily computed and cached.
+     */
+    endFor(_index, nextStart) {
+        const end = this.start + this.duration;
+        if (nextStart !== undefined && nextStart < end) {
+            return nextStart;
+        }
+        return end;
+    }
+}
+//# sourceMappingURL=FetchedTranscriptSnippet.js.map

package/dist/esm/models/FetchedTranscriptSnippet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FetchedTranscriptSnippet.js","sourceRoot":"","sources":["../../../src/models/FetchedTranscriptSnippet.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,wBAAwB;IAC1B,IAAI,CAAS;IACb,KAAK,CAAS;IACd,QAAQ,CAAS;IAE1B,YAAY,IAAY,EAAE,KAAa,EAAE,QAAgB;QACvD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,MAAc,EAAE,SAA6B;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;QACvC,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,GAAG,GAAG,EAAE,CAAC;YAC/C,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/dist/esm/models/FormattedTranscript.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Result of formatting a transcript.
+ */
+export interface FormattedTranscript {
+    readonly content: string;
+    readonly extension: string;
+    readonly mimeType: string;
+}
+//# sourceMappingURL=FormattedTranscript.d.ts.map

package/dist/esm/models/FormattedTranscript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormattedTranscript.d.ts","sourceRoot":"","sources":["../../../src/models/FormattedTranscript.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B"}

package/dist/esm/models/FormattedTranscript.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=FormattedTranscript.js.map

package/dist/esm/models/FormattedTranscript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormattedTranscript.js","sourceRoot":"","sources":["../../../src/models/FormattedTranscript.ts"],"names":[],"mappings":""}

package/dist/esm/models/Transcript.d.ts

@@ -0,0 +1,36 @@
+import type { InnerTubeClient } from '../api/InnerTubeClient.js';
+import type { TranslationLanguage } from './TranslationLanguage.js';
+import type { TranscriptMetadata } from './TranscriptMetadata.js';
+import { FetchedTranscript } from './FetchedTranscript.js';
+/**
+ * A handle to a single caption track.
+ *
+ * Created via `TranscriptList.findTranscript` (or `.findGeneratedTranscript`,
+ * `.findManuallyCreatedTranscript`). To obtain the actual cues, call
+ * `.fetch()` or chain `.translate(targetLang).fetch()`.
+ */
+export declare class Transcript implements TranscriptMetadata {
+    readonly videoId: string;
+    readonly languageName: string;
+    readonly languageCode: string;
+    readonly isGenerated: boolean;
+    readonly translationLanguages: readonly TranslationLanguage[];
+    private readonly _baseUrl;
+    private readonly _httpClient;
+    private readonly _translationLanguageCodes;
+    constructor(httpClient: InnerTubeClient, videoId: string, baseUrl: string, languageName: string, languageCode: string, isGenerated: boolean, translationLanguages: readonly TranslationLanguage[]);
+    get isTranslatable(): boolean;
+    /**
+     * Fetch this transcript's cues.
+     */
+    fetch(preserveFormatting?: boolean): Promise<FetchedTranscript>;
+    /**
+     * Translate this transcript to `targetLang`.
+     *
+     * Returns a new (un-fetched) Transcript whose `.fetch()` returns the
+     * translated cues. The translated track is not itself translatable.
+     */
+    translate(targetLang: string): Transcript;
+    toMetadata(): TranscriptMetadata;
+}
+//# sourceMappingURL=Transcript.d.ts.map

package/dist/esm/models/Transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transcript.d.ts","sourceRoot":"","sources":["../../../src/models/Transcript.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;GAMG;AACH,qBAAa,UAAW,YAAW,kBAAkB;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,oBAAoB,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAE9D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkB;IAC9C,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAsB;gBAG9D,UAAU,EAAE,eAAe,EAC3B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,OAAO,EACpB,oBAAoB,EAAE,SAAS,mBAAmB,EAAE;IAYtD,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED;;OAEG;IACG,KAAK,CAAC,kBAAkB,GAAE,OAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAS5E;;;;;OAKG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU;IAsBzC,UAAU,IAAI,kBAAkB;CAUjC"}

package/dist/esm/models/Transcript.js

@@ -0,0 +1,71 @@
+import { NotTranslatable, TranslationLanguageNotAvailable, } from '../errors/index.js';
+import { parseTranscriptXml } from '../parsers/xmlTranscriptParser.js';
+import { FetchedTranscript } from './FetchedTranscript.js';
+/**
+ * A handle to a single caption track.
+ *
+ * Created via `TranscriptList.findTranscript` (or `.findGeneratedTranscript`,
+ * `.findManuallyCreatedTranscript`). To obtain the actual cues, call
+ * `.fetch()` or chain `.translate(targetLang).fetch()`.
+ */
+export class Transcript {
+    videoId;
+    languageName;
+    languageCode;
+    isGenerated;
+    translationLanguages;
+    _baseUrl;
+    _httpClient;
+    _translationLanguageCodes;
+    constructor(httpClient, videoId, baseUrl, languageName, languageCode, isGenerated, translationLanguages) {
+        this._httpClient = httpClient;
+        this.videoId = videoId;
+        this._baseUrl = baseUrl;
+        this.languageName = languageName;
+        this.languageCode = languageCode;
+        this.isGenerated = isGenerated;
+        this.translationLanguages = translationLanguages;
+        this._translationLanguageCodes = new Set(translationLanguages.map((l) => l.languageCode));
+    }
+    get isTranslatable() {
+        return this.translationLanguages.length > 0;
+    }
+    /**
+     * Fetch this transcript's cues.
+     */
+    async fetch(preserveFormatting = false) {
+        const xml = await this._httpClient.fetchTranscriptXml(this._baseUrl, this.videoId);
+        const cues = parseTranscriptXml(xml, { preserveFormatting });
+        return new FetchedTranscript(cues.map((c) => ({ text: c.text, start: c.start, duration: c.duration })), this.toMetadata());
+    }
+    /**
+     * Translate this transcript to `targetLang`.
+     *
+     * Returns a new (un-fetched) Transcript whose `.fetch()` returns the
+     * translated cues. The translated track is not itself translatable.
+     */
+    translate(targetLang) {
+        if (!this.isTranslatable) {
+            throw new NotTranslatable(this.videoId);
+        }
+        if (!this._translationLanguageCodes.has(targetLang)) {
+            throw new TranslationLanguageNotAvailable(this.videoId, targetLang, [
+                ...this._translationLanguageCodes,
+            ]);
+        }
+        const newUrl = this._httpClient.buildTranslateUrl(this._baseUrl, targetLang);
+        const name = this.translationLanguages.find((l) => l.languageCode === targetLang);
+        return new Transcript(this._httpClient, this.videoId, newUrl, name?.languageName ?? targetLang, targetLang, true, []);
+    }
+    toMetadata() {
+        return {
+            videoId: this.videoId,
+            languageName: this.languageName,
+            languageCode: this.languageCode,
+            isGenerated: this.isGenerated,
+            isTranslatable: this.isTranslatable,
+            translationLanguages: this.translationLanguages,
+        };
+    }
+}
+//# sourceMappingURL=Transcript.js.map

package/dist/esm/models/Transcript.js.map

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

package/dist/esm/models/TranscriptList.d.ts

@@ -0,0 +1,48 @@
+import type { InnerTubeClient } from '../api/InnerTubeClient.js';
+import { Transcript } from './Transcript.js';
+import type { TranslationLanguage } from './TranslationLanguage.js';
+/**
+ * Collection of all available transcript tracks for a video.
+ *
+ * Created via `YouTubeTranscriptApi.list(videoId)`. Use the `find*` helpers
+ * to pick a track, then call `.fetch()` on the result.
+ */
+export declare class TranscriptList {
+    readonly videoId: string;
+    readonly manuallyCreatedTranscripts: readonly Transcript[];
+    readonly generatedTranscripts: readonly Transcript[];
+    readonly translationLanguages: readonly TranslationLanguage[];
+    constructor(videoId: string, manuallyCreatedTranscripts: readonly Transcript[], generatedTranscripts: readonly Transcript[], translationLanguages: readonly TranslationLanguage[]);
+    /**
+     * Find a transcript matching one of the given language codes.
+     * Manual tracks are preferred over generated ones.
+     */
+    findTranscript(languageCodes: readonly string[]): Transcript;
+    /**
+     * Find only an ASR-generated transcript.
+     */
+    findGeneratedTranscript(languageCodes: readonly string[]): Transcript;
+    /**
+     * Find only a manually uploaded transcript.
+     */
+    findManuallyCreatedTranscript(languageCodes: readonly string[]): Transcript;
+    private findInOrder;
+    /**
+     * Iterate over all transcripts (manual first, then generated).
+     */
+    [Symbol.iterator](): IterableIterator<Transcript>;
+}
+/**
+ * Factory helper to build a TranscriptList from raw caption data.
+ *
+ * `httpClient` is propagated to each Transcript so they can fetch their
+ * own cues lazily.
+ */
+export declare function buildTranscriptList(httpClient: InnerTubeClient, videoId: string, captionTracks: ReadonlyArray<{
+    baseUrl: string;
+    languageCode: string;
+    name: string;
+    kind: '' | 'asr';
+    isTranslatable: boolean;
+}>, translationLanguages: readonly TranslationLanguage[]): TranscriptList;
+//# sourceMappingURL=TranscriptList.d.ts.map

package/dist/esm/models/TranscriptList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranscriptList.d.ts","sourceRoot":"","sources":["../../../src/models/TranscriptList.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,0BAA0B,EAAE,SAAS,UAAU,EAAE,CAAC;IAC3D,QAAQ,CAAC,oBAAoB,EAAE,SAAS,UAAU,EAAE,CAAC;IACrD,QAAQ,CAAC,oBAAoB,EAAE,SAAS,mBAAmB,EAAE,CAAC;gBAG5D,OAAO,EAAE,MAAM,EACf,0BAA0B,EAAE,SAAS,UAAU,EAAE,EACjD,oBAAoB,EAAE,SAAS,UAAU,EAAE,EAC3C,oBAAoB,EAAE,SAAS,mBAAmB,EAAE;IAQtD;;;OAGG;IACH,cAAc,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU;IAI5D;;OAEG;IACH,uBAAuB,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU;IAIrE;;OAEG;IACH,6BAA6B,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU;IAI3E,OAAO,CAAC,WAAW;IAiBnB;;OAEG;IACF,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,UAAU,CAAC;CAInD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,eAAe,EAC3B,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,aAAa,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC,EACF,oBAAoB,EAAE,SAAS,mBAAmB,EAAE,GACnD,cAAc,CAiBhB"}