offcourse 0.0.2 → 1.0.1

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/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":"AAKA,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;AAyBD;;;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"}