youtube-transcript-nodejs 0.1.0

package/dist/esm/formatters/PrettyPrintFormatter.js

@@ -0,0 +1,22 @@
+import { toVttTime } from './base.js';
+/**
+ * Pretty-print formatter — human-readable debug output.
+ *
+ * Output format:
+ *
+ *     [00:00:00.000] Hello world
+ *     [00:00:01.540] Next line
+ */
+export class PrettyPrintFormatter {
+    extension = 'txt';
+    mimeType = 'text/plain';
+    render(snippets) {
+        const lines = snippets.map((s) => `[${toVttTime(s.start)}] ${s.text}`);
+        return {
+            content: lines.join('\n') + '\n',
+            extension: this.extension,
+            mimeType: this.mimeType,
+        };
+    }
+}
+//# sourceMappingURL=PrettyPrintFormatter.js.map

package/dist/esm/formatters/PrettyPrintFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrettyPrintFormatter.js","sourceRoot":"","sources":["../../../src/formatters/PrettyPrintFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC;;;;;;;GAOG;AACH,MAAM,OAAO,oBAAoB;IACtB,SAAS,GAAG,KAAK,CAAC;IAClB,QAAQ,GAAG,YAAY,CAAC;IAEjC,MAAM,CAAC,QAAgC;QACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACvE,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI;YAChC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/formatters/SRTFormatter.d.ts

@@ -0,0 +1,22 @@
+import type { FormattedOutput, Formatter, SnippetLike } from './Formatter.js';
+/**
+ * SRT subtitle formatter.
+ *
+ * Output format:
+ *
+ *     1
+ *     00:00:00,000 --> 00:00:01,540
+ *     Hello world
+ *
+ *     2
+ *     00:00:01,540 --> 00:00:03,540
+ *     Next line
+ *
+ * Mirrors `SRTFormatter` from the Python library.
+ */
+export declare class SRTFormatter implements Formatter {
+    readonly extension = "srt";
+    readonly mimeType = "application/x-subrip";
+    render(snippets: readonly SnippetLike[]): FormattedOutput;
+}
+//# sourceMappingURL=SRTFormatter.d.ts.map

package/dist/esm/formatters/SRTFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SRTFormatter.d.ts","sourceRoot":"","sources":["../../../src/formatters/SRTFormatter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE9E;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAa,YAAW,SAAS;IAC5C,QAAQ,CAAC,SAAS,SAAS;IAC3B,QAAQ,CAAC,QAAQ,0BAA0B;IAE3C,MAAM,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,eAAe;CAc1D"}

package/dist/esm/formatters/SRTFormatter.js

@@ -0,0 +1,35 @@
+import { computeEnd, toSrtTime } from './base.js';
+/**
+ * SRT subtitle formatter.
+ *
+ * Output format:
+ *
+ *     1
+ *     00:00:00,000 --> 00:00:01,540
+ *     Hello world
+ *
+ *     2
+ *     00:00:01,540 --> 00:00:03,540
+ *     Next line
+ *
+ * Mirrors `SRTFormatter` from the Python library.
+ */
+export class SRTFormatter {
+    extension = 'srt';
+    mimeType = 'application/x-subrip';
+    render(snippets) {
+        const blocks = [];
+        for (let i = 0; i < snippets.length; i++) {
+            const s = snippets[i];
+            const startStr = toSrtTime(s.start);
+            const endStr = toSrtTime(computeEnd(snippets, i));
+            blocks.push(`${i + 1}\n${startStr} --> ${endStr}\n${s.text}`);
+        }
+        return {
+            content: blocks.join('\n\n') + '\n',
+            extension: this.extension,
+            mimeType: this.mimeType,
+        };
+    }
+}
+//# sourceMappingURL=SRTFormatter.js.map

package/dist/esm/formatters/SRTFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SRTFormatter.js","sourceRoot":"","sources":["../../../src/formatters/SRTFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGlD;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,YAAY;IACd,SAAS,GAAG,KAAK,CAAC;IAClB,QAAQ,GAAG,sBAAsB,CAAC;IAE3C,MAAM,CAAC,QAAgC;QACrC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;YAClD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,QAAQ,MAAM,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI;YACnC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/formatters/TextFormatter.d.ts

@@ -0,0 +1,10 @@
+import type { FormattedOutput, Formatter, SnippetLike } from './Formatter.js';
+/**
+ * Plain text formatter — just concatenates the snippet text with newlines.
+ */
+export declare class TextFormatter implements Formatter {
+    readonly extension = "txt";
+    readonly mimeType = "text/plain";
+    render(snippets: readonly SnippetLike[]): FormattedOutput;
+}
+//# sourceMappingURL=TextFormatter.d.ts.map

package/dist/esm/formatters/TextFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextFormatter.d.ts","sourceRoot":"","sources":["../../../src/formatters/TextFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE9E;;GAEG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,QAAQ,CAAC,SAAS,SAAS;IAC3B,QAAQ,CAAC,QAAQ,gBAAgB;IAEjC,MAAM,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,eAAe;CAQ1D"}

package/dist/esm/formatters/TextFormatter.js

@@ -0,0 +1,16 @@
+/**
+ * Plain text formatter — just concatenates the snippet text with newlines.
+ */
+export class TextFormatter {
+    extension = 'txt';
+    mimeType = 'text/plain';
+    render(snippets) {
+        const content = snippets.map((s) => s.text).join('\n');
+        return {
+            content: snippets.length > 0 ? content + '\n' : '',
+            extension: this.extension,
+            mimeType: this.mimeType,
+        };
+    }
+}
+//# sourceMappingURL=TextFormatter.js.map

package/dist/esm/formatters/TextFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextFormatter.js","sourceRoot":"","sources":["../../../src/formatters/TextFormatter.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,aAAa;IACf,SAAS,GAAG,KAAK,CAAC;IAClB,QAAQ,GAAG,YAAY,CAAC;IAEjC,MAAM,CAAC,QAAgC;QACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvD,OAAO;YACL,OAAO,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE;YAClD,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/formatters/WebVTTFormatter.d.ts

@@ -0,0 +1,22 @@
+import type { FormattedOutput, Formatter, SnippetLike } from './Formatter.js';
+/**
+ * WebVTT subtitle formatter.
+ *
+ * Output format:
+ *
+ *     WEBVTT
+ *
+ *     00:00:00.000 --> 00:00:01.540
+ *     Hello world
+ *
+ *     00:00:01.540 --> 00:00:03.540
+ *     Next line
+ *
+ * Mirrors `WebVTTFormatter` from the Python library.
+ */
+export declare class WebVTTFormatter implements Formatter {
+    readonly extension = "vtt";
+    readonly mimeType = "text/vtt";
+    render(snippets: readonly SnippetLike[]): FormattedOutput;
+}
+//# sourceMappingURL=WebVTTFormatter.d.ts.map

package/dist/esm/formatters/WebVTTFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebVTTFormatter.d.ts","sourceRoot":"","sources":["../../../src/formatters/WebVTTFormatter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE9E;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAgB,YAAW,SAAS;IAC/C,QAAQ,CAAC,SAAS,SAAS;IAC3B,QAAQ,CAAC,QAAQ,cAAc;IAE/B,MAAM,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,eAAe;CAc1D"}

package/dist/esm/formatters/WebVTTFormatter.js

@@ -0,0 +1,35 @@
+import { computeEnd, toVttTime } from './base.js';
+/**
+ * WebVTT subtitle formatter.
+ *
+ * Output format:
+ *
+ *     WEBVTT
+ *
+ *     00:00:00.000 --> 00:00:01.540
+ *     Hello world
+ *
+ *     00:00:01.540 --> 00:00:03.540
+ *     Next line
+ *
+ * Mirrors `WebVTTFormatter` from the Python library.
+ */
+export class WebVTTFormatter {
+    extension = 'vtt';
+    mimeType = 'text/vtt';
+    render(snippets) {
+        const blocks = [];
+        for (let i = 0; i < snippets.length; i++) {
+            const s = snippets[i];
+            const startStr = toVttTime(s.start);
+            const endStr = toVttTime(computeEnd(snippets, i));
+            blocks.push(`${startStr} --> ${endStr}\n${s.text}`);
+        }
+        return {
+            content: 'WEBVTT\n\n' + blocks.join('\n\n') + '\n',
+            extension: this.extension,
+            mimeType: this.mimeType,
+        };
+    }
+}
+//# sourceMappingURL=WebVTTFormatter.js.map

package/dist/esm/formatters/WebVTTFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebVTTFormatter.js","sourceRoot":"","sources":["../../../src/formatters/WebVTTFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGlD;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,eAAe;IACjB,SAAS,GAAG,KAAK,CAAC;IAClB,QAAQ,GAAG,UAAU,CAAC;IAE/B,MAAM,CAAC,QAAgC;QACrC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;YAClD,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,QAAQ,MAAM,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,OAAO;YACL,OAAO,EAAE,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI;YAClD,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/formatters/base.d.ts

@@ -0,0 +1,25 @@
+import type { SnippetLike } from './Formatter.js';
+/**
+ * Shared helpers for SRT/WebVTT formatters.
+ */
+/**
+ * Compute the end timestamp for a snippet.
+ *
+ * End = min(next.start, this.start + this.duration) when a next snippet
+ * exists AND starts before this one ends (avoid overlap). Otherwise use
+ * start + duration. Mirrors Python library's `_TextBasedFormatter`.
+ */
+export declare function computeEnd(snippets: readonly SnippetLike[], index: number): number;
+/**
+ * Format seconds into `HH:MM:SS,mmm` (SRT style).
+ */
+export declare function toSrtTime(seconds: number): string;
+/**
+ * Format seconds into `HH:MM:SS.mmm` (WebVTT style).
+ */
+export declare function toVttTime(seconds: number): string;
+/**
+ * Format seconds into `[HH:MM:SS.mmm]` pretty-print style.
+ */
+export declare function toPrettyTime(seconds: number): string;
+//# sourceMappingURL=base.d.ts.map

package/dist/esm/formatters/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/formatters/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;GAEG;AAEH;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQlF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAuBD;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/esm/formatters/base.js

@@ -0,0 +1,55 @@
+/**
+ * Shared helpers for SRT/WebVTT formatters.
+ */
+/**
+ * Compute the end timestamp for a snippet.
+ *
+ * End = min(next.start, this.start + this.duration) when a next snippet
+ * exists AND starts before this one ends (avoid overlap). Otherwise use
+ * start + duration. Mirrors Python library's `_TextBasedFormatter`.
+ */
+export function computeEnd(snippets, index) {
+    const cur = snippets[index];
+    const end = cur.start + cur.duration;
+    const next = snippets[index + 1];
+    if (next && next.start < end) {
+        return next.start;
+    }
+    return end;
+}
+/**
+ * Format seconds into `HH:MM:SS,mmm` (SRT style).
+ */
+export function toSrtTime(seconds) {
+    return toDelimitedTime(seconds, ',');
+}
+/**
+ * Format seconds into `HH:MM:SS.mmm` (WebVTT style).
+ */
+export function toVttTime(seconds) {
+    return toDelimitedTime(seconds, '.');
+}
+function toDelimitedTime(seconds, msDelim) {
+    const ms = Math.round(seconds * 1000);
+    const h = Math.floor(ms / 3_600_000);
+    const m = Math.floor((ms % 3_600_000) / 60_000);
+    const s = Math.floor((ms % 60_000) / 1000);
+    const milli = ms % 1000;
+    return (pad(h) +
+        ':' +
+        pad(m) +
+        ':' +
+        pad(s) +
+        msDelim +
+        pad(milli, 3));
+}
+function pad(n, len = 2) {
+    return n.toString().padStart(len, '0');
+}
+/**
+ * Format seconds into `[HH:MM:SS.mmm]` pretty-print style.
+ */
+export function toPrettyTime(seconds) {
+    return '[' + toVttTime(seconds) + ']';
+}
+//# sourceMappingURL=base.js.map

package/dist/esm/formatters/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/formatters/base.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgC,EAAE,KAAa;IACxE,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAE,CAAC;IAC7B,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC;IACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACjC,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,eAAe,CAAC,OAAe,EAAE,OAAkB;IAC1D,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACtC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC;IACrC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,CAAC;IAChD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC;IACxB,OAAO,CACL,GAAG,CAAC,CAAC,CAAC;QACN,GAAG;QACH,GAAG,CAAC,CAAC,CAAC;QACN,GAAG;QACH,GAAG,CAAC,CAAC,CAAC;QACN,OAAO;QACP,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CACd,CAAC;AACJ,CAAC;AAED,SAAS,GAAG,CAAC,CAAS,EAAE,MAAc,CAAC;IACrC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC;AACxC,CAAC"}

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

@@ -0,0 +1,8 @@
+export { SRTFormatter } from './SRTFormatter.js';
+export { WebVTTFormatter } from './WebVTTFormatter.js';
+export { PrettyPrintFormatter } from './PrettyPrintFormatter.js';
+export { TextFormatter } from './TextFormatter.js';
+export { JSONFormatter } from './JSONFormatter.js';
+export { computeEnd, toSrtTime, toVttTime, toPrettyTime } from './base.js';
+export type { Formatter, FormattedOutput, SnippetLike } from './Formatter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/formatters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC3E,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/esm/formatters/index.js

@@ -0,0 +1,7 @@
+export { SRTFormatter } from './SRTFormatter.js';
+export { WebVTTFormatter } from './WebVTTFormatter.js';
+export { PrettyPrintFormatter } from './PrettyPrintFormatter.js';
+export { TextFormatter } from './TextFormatter.js';
+export { JSONFormatter } from './JSONFormatter.js';
+export { computeEnd, toSrtTime, toVttTime, toPrettyTime } from './base.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/formatters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/formatters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/esm/http/cookieJar.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Minimal in-memory cookie jar.
+ *
+ * Tracks `name -> value` per domain; matches cookies by request URL host.
+ * Sufficient for YouTube's needs (CONSENT, VISITOR_INFO1_LIVE, etc.).
+ */
+export interface CookieEntry {
+    readonly name: string;
+    readonly value: string;
+    readonly domain: string;
+    readonly path: string;
+}
+export interface SetCookieOptions {
+    name: string;
+    value: string;
+    domain?: string;
+    path?: string;
+}
+export declare class CookieJar {
+    private readonly cookies;
+    private key;
+    set(opts: SetCookieOptions): void;
+    /**
+     * Get all cookies that apply to a URL.
+     *
+     * Matches by:
+     *  - exact domain match
+     *  - parent-domain match (cookie with leading `.`)
+     *  - path prefix
+     */
+    getForUrl(url: string): CookieEntry[];
+    /** Build the value for the `Cookie:` request header. */
+    headerForUrl(url: string): string;
+    /** Inspect a `Set-Cookie` response header and store it (best-effort). */
+    ingestSetCookie(setCookieValue: string, requestUrl: string): void;
+    clear(): void;
+    size(): number;
+}
+//# sourceMappingURL=cookieJar.d.ts.map

package/dist/esm/http/cookieJar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookieJar.d.ts","sourceRoot":"","sources":["../../../src/http/cookieJar.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAE1D,OAAO,CAAC,GAAG;IAIX,GAAG,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAOjC;;;;;;;OAOG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE;IAiBrC,wDAAwD;IACxD,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAKjC,yEAAyE;IACzE,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IA2BjE,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,MAAM;CAGf"}

package/dist/esm/http/cookieJar.js

@@ -0,0 +1,87 @@
+/**
+ * Minimal in-memory cookie jar.
+ *
+ * Tracks `name -> value` per domain; matches cookies by request URL host.
+ * Sufficient for YouTube's needs (CONSENT, VISITOR_INFO1_LIVE, etc.).
+ */
+export class CookieJar {
+    cookies = new Map();
+    key(domain, name) {
+        return `${domain}::${name}`;
+    }
+    set(opts) {
+        const domain = (opts.domain ?? '.youtube.com').toLowerCase();
+        const path = opts.path ?? '/';
+        const k = this.key(domain, opts.name);
+        this.cookies.set(k, { name: opts.name, value: opts.value, domain, path });
+    }
+    /**
+     * Get all cookies that apply to a URL.
+     *
+     * Matches by:
+     *  - exact domain match
+     *  - parent-domain match (cookie with leading `.`)
+     *  - path prefix
+     */
+    getForUrl(url) {
+        let host;
+        try {
+            host = new URL(url).hostname.toLowerCase();
+        }
+        catch {
+            return [];
+        }
+        const out = [];
+        for (const c of this.cookies.values()) {
+            const d = c.domain.replace(/^\.+/, '').toLowerCase();
+            if (host === d || host.endsWith('.' + d)) {
+                out.push(c);
+            }
+        }
+        return out;
+    }
+    /** Build the value for the `Cookie:` request header. */
+    headerForUrl(url) {
+        const cookies = this.getForUrl(url);
+        return cookies.map((c) => `${c.name}=${c.value}`).join('; ');
+    }
+    /** Inspect a `Set-Cookie` response header and store it (best-effort). */
+    ingestSetCookie(setCookieValue, requestUrl) {
+        // Simple parser: "name=value; Domain=.x; Path=/"
+        const parts = setCookieValue.split(';').map((s) => s.trim());
+        const first = parts[0];
+        if (!first)
+            return;
+        const eq = first.indexOf('=');
+        if (eq <= 0)
+            return;
+        const name = first.slice(0, eq).trim();
+        const value = first.slice(eq + 1).trim();
+        let domain = '';
+        let path = '/';
+        for (const part of parts.slice(1)) {
+            const [rawK, v] = part.split('=').map((s) => s.trim());
+            const lk = (rawK ?? '').toLowerCase();
+            if (lk === 'domain' && v)
+                domain = v;
+            else if (lk === 'path' && v)
+                path = v;
+        }
+        if (!domain) {
+            try {
+                domain = new URL(requestUrl).hostname;
+            }
+            catch {
+                return;
+            }
+        }
+        this.set({ name, value, domain, path });
+    }
+    clear() {
+        this.cookies.clear();
+    }
+    size() {
+        return this.cookies.size;
+    }
+}
+//# sourceMappingURL=cookieJar.js.map

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

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

package/dist/esm/http/httpClient.d.ts

@@ -0,0 +1,88 @@
+import type { CookieJar } from './cookieJar.js';
+/**
+ * Configuration for the HTTP client.
+ */
+export interface HttpClientConfig {
+    /** Default User-Agent header. */
+    userAgent?: string;
+    /** Default Accept-Language header. */
+    acceptLanguage?: string;
+    /** Default request timeout in ms. */
+    timeoutMs?: number;
+    /** Cookie jar (shared). */
+    cookies?: CookieJar;
+    /** Default headers to add to every request. */
+    defaultHeaders?: Record<string, string>;
+    /** Proxy URL (http / https / socks5). Triggers undici dynamic import. */
+    proxyUrl?: string;
+    /** Optional fetch implementation (for testing / SSR). */
+    fetchImpl?: typeof fetch;
+    /** Maximum retries on 429. */
+    retriesOn429?: number;
+}
+export interface RequestOptions {
+    method?: 'GET' | 'POST';
+    headers?: Record<string, string>;
+    body?: string;
+    /** Request timeout in ms (overrides default). */
+    timeoutMs?: number;
+    /** AbortSignal. */
+    signal?: AbortSignal;
+}
+export interface ResponseLike {
+    status: number;
+    statusText: string;
+    ok: boolean;
+    text(): Promise<string>;
+    json(): Promise<unknown>;
+}
+/**
+ * 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 declare class HttpClient {
+    private readonly userAgent;
+    private readonly acceptLanguage;
+    private readonly defaultTimeoutMs;
+    private readonly cookies;
+    private readonly defaultHeaders;
+    private readonly proxyUrl;
+    private readonly fetchImpl;
+    private readonly retriesOn429;
+    private proxyDispatcher;
+    constructor(config?: HttpClientConfig);
+    /**
+     * Build full headers for a request, merging defaults + per-request + cookies.
+     */
+    private buildHeaders;
+    /**
+     * GET request.
+     */
+    get(url: string, opts?: RequestOptions): Promise<ResponseLike>;
+    /**
+     * POST request with a JSON body.
+     */
+    postJson(url: string, body: unknown, opts?: RequestOptions): Promise<ResponseLike>;
+    /**
+     * Perform an HTTP request with retries on 429.
+     */
+    request(url: string, opts?: RequestOptions): Promise<ResponseLike>;
+    /**
+     * Wrap a raw `Response` so that `.json()` returns `unknown` and re-throwing
+     * makes the type usable in tests.
+     */
+    private normalizeResponse;
+    private extractSetCookies;
+    /**
+     * Lazily load undici and create a ProxyAgent when a proxy URL is configured.
+     * Returns `undefined` if no proxy is set.
+     */
+    private maybeProxyDispatcher;
+}
+//# sourceMappingURL=httpClient.d.ts.map

package/dist/esm/http/httpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpClient.d.ts","sourceRoot":"","sources":["../../../src/http/httpClient.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,eAAe,CAAsB;gBAEjC,MAAM,GAAE,gBAAqB;IAczC;;OAEG;IACH,OAAO,CAAC,YAAY;IAmBpB;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAIxE;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAU5F;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAqD5E;;;OAGG;YACW,iBAAiB;IAkB/B,OAAO,CAAC,iBAAiB;IAczB;;;OAGG;YACW,oBAAoB;CAiBnC"}