offcourse 0.0.1 → 1.0.0

package/dist/downloader/queue.d.ts

@@ -0,0 +1,56 @@
+export interface QueueItem<T> {
+    id: string;
+    data: T;
+    status: "pending" | "processing" | "completed" | "failed";
+    error?: string;
+    retries: number;
+}
+export interface QueueOptions {
+    concurrency: number;
+    maxRetries: number;
+    onProgress?: ((completed: number, total: number, current?: string) => void) | undefined;
+}
+/**
+ * An async queue for processing items with concurrency control.
+ * Uses p-queue internally for battle-tested concurrency handling.
+ */
+export declare class AsyncQueue<T> {
+    private items;
+    private readonly queue;
+    private readonly maxRetries;
+    private readonly onProgress;
+    constructor(options: QueueOptions);
+    /**
+     * Adds an item to the queue.
+     */
+    add(id: string, data: T): void;
+    /**
+     * Adds multiple items to the queue.
+     */
+    addAll(items: Array<{
+        id: string;
+        data: T;
+    }>): void;
+    /**
+     * Processes all items in the queue using the provided handler.
+     */
+    process(handler: (item: T, id: string) => Promise<void>): Promise<{
+        completed: number;
+        failed: number;
+        errors: Array<{
+            id: string;
+            error: string;
+        }>;
+    }>;
+    private reportProgress;
+    /**
+     * Gets the current queue status.
+     */
+    getStatus(): {
+        pending: number;
+        processing: number;
+        completed: number;
+        failed: number;
+    };
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/downloader/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/downloader/queue.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACzF;AAED;;;GAGG;AACH,qBAAa,UAAU,CAAC,CAAC;IACvB,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAEb;gBAEF,OAAO,EAAE,YAAY;IAMjC;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAS9B;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,GAAG,IAAI;IAMnD;;OAEG;IACG,OAAO,CACX,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAC9C,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAoC/F,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,SAAS,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAQxF"}

package/dist/downloader/queue.js

@@ -0,0 +1,88 @@
+import PQueue from "p-queue";
+/**
+ * An async queue for processing items with concurrency control.
+ * Uses p-queue internally for battle-tested concurrency handling.
+ */
+export class AsyncQueue {
+    items = [];
+    queue;
+    maxRetries;
+    onProgress;
+    constructor(options) {
+        this.queue = new PQueue({ concurrency: options.concurrency });
+        this.maxRetries = options.maxRetries;
+        this.onProgress = options.onProgress;
+    }
+    /**
+     * Adds an item to the queue.
+     */
+    add(id, data) {
+        this.items.push({
+            id,
+            data,
+            status: "pending",
+            retries: 0,
+        });
+    }
+    /**
+     * Adds multiple items to the queue.
+     */
+    addAll(items) {
+        for (const item of items) {
+            this.add(item.id, item.data);
+        }
+    }
+    /**
+     * Processes all items in the queue using the provided handler.
+     */
+    async process(handler) {
+        const errors = [];
+        const processItem = async (item) => {
+            item.status = "processing";
+            // maxRetries=0 means try once, maxRetries=3 means try up to 3 times total
+            const maxAttempts = Math.max(1, this.maxRetries);
+            for (let attempt = 0; attempt < maxAttempts; attempt++) {
+                try {
+                    await handler(item.data, item.id);
+                    item.status = "completed";
+                    this.reportProgress();
+                    return;
+                }
+                catch (error) {
+                    item.retries = attempt + 1;
+                    if (attempt >= maxAttempts - 1) {
+                        item.status = "failed";
+                        item.error = error instanceof Error ? error.message : String(error);
+                        errors.push({ id: item.id, error: item.error });
+                        this.reportProgress();
+                    }
+                }
+            }
+        };
+        // Add all items to the p-queue
+        await this.queue.addAll(this.items.map((item) => () => processItem(item)));
+        const completed = this.items.filter((i) => i.status === "completed").length;
+        const failed = this.items.filter((i) => i.status === "failed").length;
+        return { completed, failed, errors };
+    }
+    reportProgress() {
+        if (!this.onProgress)
+            return;
+        const completed = this.items.filter((i) => i.status === "completed").length;
+        const total = this.items.length;
+        const current = this.items.find((i) => i.status === "processing");
+        this.onProgress(completed, total, current?.id);
+    }
+    /**
+     * Gets the current queue status.
+     */
+    getStatus() {
+        return {
+            pending: this.items.filter((i) => i.status === "pending").length,
+            processing: this.items.filter((i) => i.status === "processing").length,
+            completed: this.items.filter((i) => i.status === "completed").length,
+            failed: this.items.filter((i) => i.status === "failed").length,
+        };
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/downloader/queue.js.map

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

package/dist/downloader/queue.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=queue.test.d.ts.map

package/dist/downloader/queue.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.test.d.ts","sourceRoot":"","sources":["../../src/downloader/queue.test.ts"],"names":[],"mappings":""}

package/dist/downloader/queue.test.js

@@ -0,0 +1,158 @@
+import { describe, expect, it } from "vitest";
+import { AsyncQueue } from "./queue.js";
+describe("AsyncQueue", () => {
+    it("processes items in order", async () => {
+        const processed = [];
+        const queue = new AsyncQueue({
+            concurrency: 1,
+            maxRetries: 0,
+        });
+        queue.add("1", "first");
+        queue.add("2", "second");
+        queue.add("3", "third");
+        await queue.process(async (item) => {
+            processed.push(item);
+        });
+        expect(processed).toEqual(["first", "second", "third"]);
+    });
+    it("tracks completed and failed counts", async () => {
+        const queue = new AsyncQueue({
+            concurrency: 1,
+            maxRetries: 0,
+        });
+        queue.add("1", "success");
+        queue.add("2", "fail");
+        queue.add("3", "success");
+        const result = await queue.process(async (item) => {
+            if (item === "fail") {
+                throw new Error("Intentional failure");
+            }
+        });
+        expect(result.completed).toBe(2);
+        expect(result.failed).toBe(1);
+        expect(result.errors).toHaveLength(1);
+        expect(result.errors[0]?.id).toBe("2");
+    });
+    it("retries failed items up to maxRetries", async () => {
+        let attempts = 0;
+        const queue = new AsyncQueue({
+            concurrency: 1,
+            maxRetries: 3,
+        });
+        queue.add("1", "retry-test");
+        await queue.process(async () => {
+            attempts++;
+            if (attempts < 3) {
+                throw new Error("Not yet");
+            }
+        });
+        expect(attempts).toBe(3);
+    });
+    it("adds multiple items with addAll", async () => {
+        const queue = new AsyncQueue({
+            concurrency: 1,
+            maxRetries: 0,
+        });
+        queue.addAll([
+            { id: "a", data: 1 },
+            { id: "b", data: 2 },
+            { id: "c", data: 3 },
+        ]);
+        const sum = { value: 0 };
+        await queue.process(async (item) => {
+            sum.value += item;
+        });
+        expect(sum.value).toBe(6);
+    });
+    it("reports progress during processing", async () => {
+        const progressCalls = [];
+        const queue = new AsyncQueue({
+            concurrency: 1,
+            maxRetries: 0,
+            onProgress: (completed, total) => {
+                progressCalls.push({ completed, total });
+            },
+        });
+        queue.add("1", "a");
+        queue.add("2", "b");
+        queue.add("3", "c");
+        await queue.process(async () => {
+            // no-op
+        });
+        expect(progressCalls.length).toBeGreaterThan(0);
+        // Last call should have all completed
+        const lastCall = progressCalls.at(-1);
+        expect(lastCall?.completed).toBe(3);
+        expect(lastCall?.total).toBe(3);
+    });
+    it("returns correct status", async () => {
+        const queue = new AsyncQueue({
+            concurrency: 1,
+            maxRetries: 0,
+        });
+        queue.add("1", "a");
+        queue.add("2", "b");
+        const beforeStatus = queue.getStatus();
+        expect(beforeStatus.pending).toBe(2);
+        expect(beforeStatus.completed).toBe(0);
+        await queue.process(async () => { });
+        const afterStatus = queue.getStatus();
+        expect(afterStatus.pending).toBe(0);
+        expect(afterStatus.completed).toBe(2);
+    });
+    it("handles concurrent processing", async () => {
+        const processing = new Set();
+        let maxConcurrent = 0;
+        const queue = new AsyncQueue({
+            concurrency: 2,
+            maxRetries: 0,
+        });
+        queue.addAll([
+            { id: "1", data: "a" },
+            { id: "2", data: "b" },
+            { id: "3", data: "c" },
+            { id: "4", data: "d" },
+        ]);
+        await queue.process(async (_item, id) => {
+            processing.add(id);
+            maxConcurrent = Math.max(maxConcurrent, processing.size);
+            // Simulate async work
+            await new Promise((r) => setTimeout(r, 10));
+            processing.delete(id);
+        });
+        expect(maxConcurrent).toBeLessThanOrEqual(2);
+    });
+    it("handles empty queue", async () => {
+        const queue = new AsyncQueue({
+            concurrency: 1,
+            maxRetries: 0,
+        });
+        const result = await queue.process(async () => { });
+        expect(result.completed).toBe(0);
+        expect(result.failed).toBe(0);
+        expect(result.errors).toEqual([]);
+    });
+    it("captures error messages correctly", async () => {
+        const queue = new AsyncQueue({
+            concurrency: 1,
+            maxRetries: 0,
+        });
+        queue.add("1", "test");
+        const result = await queue.process(async () => {
+            throw new Error("Specific error message");
+        });
+        expect(result.errors[0]?.error).toBe("Specific error message");
+    });
+    it("handles non-Error throws", async () => {
+        const queue = new AsyncQueue({
+            concurrency: 1,
+            maxRetries: 0,
+        });
+        queue.add("1", "test");
+        const result = await queue.process(async () => {
+            throw "String error";
+        });
+        expect(result.errors[0]?.error).toBe("String error");
+    });
+});
+//# sourceMappingURL=queue.test.js.map

package/dist/downloader/queue.test.js.map

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

package/dist/downloader/videoDownloader.d.ts

@@ -0,0 +1,32 @@
+import type { VideoQuality } from "../config/schema.js";
+export interface DownloadResult {
+    success: boolean;
+    filePath: string | null;
+    error: string | null;
+}
+/**
+ * Checks if yt-dlp is available on the system.
+ */
+export declare function isYtDlpAvailable(): Promise<boolean>;
+/**
+ * Normalizes various video URLs to formats yt-dlp can handle.
+ */
+export declare function normalizeVideoUrl(embedUrl: string, videoType: "loom" | "vimeo" | "youtube" | "wistia" | "native" | "unknown" | null): string;
+/**
+ * Downloads a video using yt-dlp.
+ */
+export declare function downloadVideo(url: string, outputPath: string, options?: {
+    quality?: VideoQuality;
+    videoType?: "loom" | "vimeo" | "youtube" | "wistia" | "native" | "unknown" | null;
+    cookies?: string;
+    onProgress?: (percent: number) => void;
+}): Promise<DownloadResult>;
+/**
+ * Gets video info without downloading.
+ */
+export declare function getVideoInfo(url: string, videoType: "loom" | "vimeo" | "youtube" | "wistia" | "native" | "unknown" | null): Promise<{
+    title: string;
+    duration: number;
+    formats: string[];
+} | null>;
+//# sourceMappingURL=videoDownloader.d.ts.map

package/dist/downloader/videoDownloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"videoDownloader.d.ts","sourceRoot":"","sources":["../../src/downloader/videoDownloader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAYzD;AAiBD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,IAAI,GAC/E,MAAM,CAmCR;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,GACL,OAAO,CAAC,cAAc,CAAC,CA8EzB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,IAAI,GAC/E,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAAC,CAqCxE"}

package/dist/downloader/videoDownloader.js

@@ -0,0 +1,173 @@
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+/**
+ * Checks if yt-dlp is available on the system.
+ */
+export async function isYtDlpAvailable() {
+    return new Promise((resolve) => {
+        const proc = spawn("yt-dlp", ["--version"], { shell: true });
+        proc.on("close", (code) => {
+            resolve(code === 0);
+        });
+        proc.on("error", () => {
+            resolve(false);
+        });
+    });
+}
+/**
+ * Maps our quality setting to yt-dlp format selector.
+ */
+function getFormatSelector(quality) {
+    const qualityMap = {
+        highest: "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best",
+        lowest: "worstvideo[ext=mp4]+worstaudio[ext=m4a]/worst[ext=mp4]/worst",
+        "1080p": "bestvideo[height<=1080][ext=mp4]+bestaudio[ext=m4a]/best[height<=1080][ext=mp4]",
+        "720p": "bestvideo[height<=720][ext=mp4]+bestaudio[ext=m4a]/best[height<=720][ext=mp4]",
+        "480p": "bestvideo[height<=480][ext=mp4]+bestaudio[ext=m4a]/best[height<=480][ext=mp4]",
+    };
+    return qualityMap[quality];
+}
+/**
+ * Normalizes various video URLs to formats yt-dlp can handle.
+ */
+export function normalizeVideoUrl(embedUrl, videoType) {
+    switch (videoType) {
+        case "loom": {
+            // Convert Loom embed URL to regular URL
+            // https://www.loom.com/embed/abc123 -> https://www.loom.com/share/abc123
+            const videoId = embedUrl.match(/loom\.com\/embed\/([a-f0-9]+)/)?.[1];
+            if (videoId) {
+                return `https://www.loom.com/share/${videoId}`;
+            }
+            return embedUrl;
+        }
+        case "vimeo": {
+            // Convert Vimeo player URL to regular URL
+            // https://player.vimeo.com/video/123456 -> https://vimeo.com/123456
+            const videoId = embedUrl.match(/vimeo\.com\/(?:video\/)?(\d+)/)?.[1];
+            if (videoId) {
+                return `https://vimeo.com/${videoId}`;
+            }
+            return embedUrl;
+        }
+        case "youtube": {
+            // Convert YouTube embed URL to regular URL
+            // https://www.youtube.com/embed/abc123 -> https://www.youtube.com/watch?v=abc123
+            const videoId = embedUrl.match(/(?:embed\/|v=|youtu\.be\/)([^?&]+)/)?.[1];
+            if (videoId) {
+                return `https://www.youtube.com/watch?v=${videoId}`;
+            }
+            return embedUrl;
+        }
+        default:
+            return embedUrl;
+    }
+}
+/**
+ * Downloads a video using yt-dlp.
+ */
+export async function downloadVideo(url, outputPath, options = {}) {
+    const { quality = "highest", videoType, onProgress } = options;
+    // Check if already downloaded
+    if (existsSync(outputPath)) {
+        return {
+            success: true,
+            filePath: outputPath,
+            error: null,
+        };
+    }
+    // Normalize the URL for yt-dlp
+    const normalizedUrl = normalizeVideoUrl(url, videoType ?? null);
+    const args = [
+        normalizedUrl,
+        "-f",
+        getFormatSelector(quality),
+        "-o",
+        outputPath,
+        "--no-playlist",
+        "--no-warnings",
+        "--progress",
+        "--newline", // Print progress on new lines
+    ];
+    // Add referer for embedded videos
+    if (videoType === "loom") {
+        args.push("--referer", "https://www.skool.com/");
+    }
+    else if (videoType === "vimeo") {
+        args.push("--referer", "https://www.skool.com/");
+    }
+    return new Promise((resolve) => {
+        const proc = spawn("yt-dlp", args, { shell: true });
+        let errorOutput = "";
+        proc.stdout.on("data", (data) => {
+            const output = data.toString();
+            // Parse progress from yt-dlp output
+            // Format: [download]  45.2% of 123.45MiB at 1.23MiB/s ETA 01:23
+            const progressMatch = output.match(/(\d+\.?\d*)%/);
+            if (progressMatch?.[1] && onProgress) {
+                onProgress(parseFloat(progressMatch[1]));
+            }
+        });
+        proc.stderr.on("data", (data) => {
+            errorOutput += data.toString();
+        });
+        proc.on("close", (code) => {
+            if (code === 0 && existsSync(outputPath)) {
+                resolve({
+                    success: true,
+                    filePath: outputPath,
+                    error: null,
+                });
+            }
+            else {
+                resolve({
+                    success: false,
+                    filePath: null,
+                    error: errorOutput || `yt-dlp exited with code ${code}`,
+                });
+            }
+        });
+        proc.on("error", (err) => {
+            resolve({
+                success: false,
+                filePath: null,
+                error: err.message,
+            });
+        });
+    });
+}
+/**
+ * Gets video info without downloading.
+ */
+export async function getVideoInfo(url, videoType) {
+    const normalizedUrl = normalizeVideoUrl(url, videoType);
+    return new Promise((resolve) => {
+        const proc = spawn("yt-dlp", ["--dump-json", "--no-warnings", normalizedUrl], { shell: true });
+        let output = "";
+        proc.stdout.on("data", (data) => {
+            output += data.toString();
+        });
+        proc.on("close", (code) => {
+            if (code === 0) {
+                try {
+                    const info = JSON.parse(output);
+                    resolve({
+                        title: info.title ?? "Unknown",
+                        duration: info.duration ?? 0,
+                        formats: info.formats?.map((f) => f.format_id) ?? [],
+                    });
+                }
+                catch {
+                    resolve(null);
+                }
+            }
+            else {
+                resolve(null);
+            }
+        });
+        proc.on("error", () => {
+            resolve(null);
+        });
+    });
+}
+//# sourceMappingURL=videoDownloader.js.map

package/dist/downloader/videoDownloader.js.map

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

package/dist/downloader/vimeoDownloader.d.ts

@@ -0,0 +1,52 @@
+export interface VimeoVideoInfo {
+    id: string;
+    title: string;
+    duration: number;
+    width: number;
+    height: number;
+    hlsUrl: string | null;
+    progressiveUrl: string | null;
+}
+export interface VimeoFetchResult {
+    success: boolean;
+    info?: VimeoVideoInfo;
+    error?: string;
+    errorCode?: "VIDEO_NOT_FOUND" | "DRM_PROTECTED" | "PRIVATE_VIDEO" | "RATE_LIMITED" | "NETWORK_ERROR" | "PARSE_ERROR";
+    details?: string;
+}
+export interface DownloadProgress {
+    percent: number;
+    downloaded: number;
+    total: number;
+}
+export interface VimeoDownloadResult {
+    success: boolean;
+    error?: string;
+    errorCode?: VimeoFetchResult["errorCode"] | "INVALID_URL" | "NO_STREAM" | "DOWNLOAD_FAILED";
+    details?: string;
+}
+/**
+ * Extracts the Vimeo video ID from various URL formats.
+ */
+export declare function extractVimeoId(url: string): string | null;
+/**
+ * Fetches video information from Vimeo's player config.
+ * @param referer - Optional referer URL (e.g., the Skool page URL) for domain-restricted videos
+ */
+export declare function getVimeoVideoInfo(videoId: string, unlistedHash?: string | null, referer?: string): Promise<VimeoFetchResult>;
+/**
+ * Fetches Vimeo config from within a Playwright browser context.
+ * Uses page.request API which runs at browser level (no CORS restrictions)
+ * and includes the browser's cookies/session.
+ *
+ * @param page - Playwright page (should be on the Skool lesson page)
+ * @param videoId - Vimeo video ID
+ * @param unlistedHash - Optional hash for unlisted videos
+ */
+export declare function getVimeoVideoInfoFromBrowser(page: import("playwright").Page, videoId: string, unlistedHash?: string | null): Promise<VimeoFetchResult>;
+/**
+ * Downloads a Vimeo video.
+ * Prefers progressive (direct MP4) download, falls back to HLS.
+ */
+export declare function downloadVimeoVideo(url: string, outputPath: string, onProgress?: (progress: DownloadProgress) => void): Promise<VimeoDownloadResult>;
+//# sourceMappingURL=vimeoDownloader.d.ts.map

package/dist/downloader/vimeoDownloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vimeoDownloader.d.ts","sourceRoot":"","sources":["../../src/downloader/vimeoDownloader.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EACN,iBAAiB,GACjB,eAAe,GACf,eAAe,GACf,cAAc,GACd,eAAe,GACf,aAAa,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,gBAAgB,CAAC,WAAW,CAAC,GAAG,aAAa,GAAG,WAAW,GAAG,iBAAiB,CAAC;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqBzD;AAsBD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,EAC5B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC,CAgK3B;AAED;;;;;;;;GAQG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,OAAO,YAAY,EAAE,IAAI,EAC/B,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAiH3B;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,GAChD,OAAO,CAAC,mBAAmB,CAAC,CAsE9B"}