offcourse 0.0.2 → 1.0.0

package/dist/config/schema.test.js.map

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

package/dist/downloader/hlsDownloader.d.ts

@@ -0,0 +1,58 @@
+import type { DownloadProgress } from "./loomDownloader.js";
+export interface HLSDownloadResult {
+    success: boolean;
+    error?: string;
+    errorCode?: string;
+    outputPath?: string;
+    duration?: number;
+}
+export interface HLSQuality {
+    label: string;
+    url: string;
+    bandwidth: number;
+    width?: number | undefined;
+    height?: number | undefined;
+}
+/**
+ * Checks if ffmpeg is available on the system.
+ */
+export declare function checkFfmpeg(): Promise<boolean>;
+/**
+ * Fetches an HLS master playlist and parses quality variants.
+ */
+export declare function fetchHLSQualities(masterUrl: string): Promise<HLSQuality[]>;
+/**
+ * Parses an HLS master playlist to extract quality variants.
+ * Uses hls-parser for robust parsing.
+ */
+export declare function parseHLSPlaylist(content: string, baseUrl: string): HLSQuality[];
+/**
+ * Gets the best quality URL from a master playlist.
+ * @param masterUrl The master playlist URL
+ * @param preferredHeight Preferred video height (e.g., 720, 1080)
+ */
+export declare function getBestQualityUrl(masterUrl: string, preferredHeight?: number): Promise<string>;
+/**
+ * Downloads an HLS stream using ffmpeg.
+ * @param hlsUrl The HLS playlist URL (master or media)
+ * @param outputPath The output file path (should end in .mp4)
+ * @param onProgress Progress callback
+ */
+export declare function downloadHLSVideo(hlsUrl: string, outputPath: string, onProgress?: (progress: DownloadProgress) => void): Promise<HLSDownloadResult>;
+/**
+ * Downloads a HighLevel HLS video with quality selection.
+ * @param masterUrl The master playlist URL (may include token)
+ * @param outputPath The output file path
+ * @param preferredQuality Preferred quality label (e.g., "720p", "1080p")
+ * @param onProgress Progress callback
+ */
+export declare function downloadHighLevelVideo(masterUrl: string, outputPath: string, preferredQuality?: string, onProgress?: (progress: DownloadProgress) => void): Promise<HLSDownloadResult>;
+/**
+ * Extracts video info from a HighLevel HLS URL.
+ */
+export declare function parseHighLevelVideoUrl(url: string): {
+    locationId: string;
+    videoId: string;
+    token?: string | undefined;
+} | null;
+//# sourceMappingURL=hlsDownloader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hlsDownloader.d.ts","sourceRoot":"","sources":["../../src/downloader/hlsDownloader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAOpD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAahF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAuC/E;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,GAChD,OAAO,CAAC,iBAAiB,CAAC,CA4G5B;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,gBAAgB,CAAC,EAAE,MAAM,EACzB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,GAChD,OAAO,CAAC,iBAAiB,CAAC,CA0B5B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,GAAG,IAAI,CAqBP"}

package/dist/downloader/hlsDownloader.js

@@ -0,0 +1,254 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { execa } from "execa";
+import * as HLS from "hls-parser";
+/**
+ * Checks if ffmpeg is available on the system.
+ */
+export async function checkFfmpeg() {
+    try {
+        await execa("ffmpeg", ["-version"]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Fetches an HLS master playlist and parses quality variants.
+ */
+export async function fetchHLSQualities(masterUrl) {
+    try {
+        const response = await fetch(masterUrl);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch playlist: ${response.status}`);
+        }
+        const content = await response.text();
+        return parseHLSPlaylist(content, masterUrl);
+    }
+    catch (error) {
+        console.error("Failed to fetch HLS qualities:", error);
+        return [];
+    }
+}
+/**
+ * Parses an HLS master playlist to extract quality variants.
+ * Uses hls-parser for robust parsing.
+ */
+export function parseHLSPlaylist(content, baseUrl) {
+    try {
+        const playlist = HLS.parse(content);
+        // Check if it's a master playlist with variants
+        if (!("variants" in playlist) || !playlist.variants) {
+            return [];
+        }
+        const variants = playlist.variants.map((variant) => {
+            const bandwidth = variant.bandwidth ?? 0;
+            const resolution = variant.resolution;
+            const width = resolution?.width;
+            const height = resolution?.height;
+            // Build absolute URL
+            const variantUrl = variant.uri.startsWith("http")
+                ? variant.uri
+                : new URL(variant.uri, baseUrl).href;
+            const label = height ? `${height}p` : `${Math.round(bandwidth / 1000)}k`;
+            return {
+                label,
+                url: variantUrl,
+                bandwidth,
+                width,
+                height,
+            };
+        });
+        // Sort by bandwidth (highest first)
+        variants.sort((a, b) => b.bandwidth - a.bandwidth);
+        return variants;
+    }
+    catch {
+        // Fallback to empty array on parse error
+        return [];
+    }
+}
+/**
+ * Gets the best quality URL from a master playlist.
+ * @param masterUrl The master playlist URL
+ * @param preferredHeight Preferred video height (e.g., 720, 1080)
+ */
+export async function getBestQualityUrl(masterUrl, preferredHeight) {
+    const qualities = await fetchHLSQualities(masterUrl);
+    if (qualities.length === 0) {
+        // Assume it's a direct media playlist
+        return masterUrl;
+    }
+    if (preferredHeight) {
+        // Find closest match to preferred height
+        const match = qualities.find((q) => q.height === preferredHeight);
+        if (match)
+            return match.url;
+        // Find closest lower quality
+        const lower = qualities.filter((q) => q.height && q.height <= preferredHeight);
+        if (lower.length > 0) {
+            return lower[0].url;
+        }
+    }
+    // Return highest quality
+    return qualities[0]?.url ?? masterUrl;
+}
+/**
+ * Downloads an HLS stream using ffmpeg.
+ * @param hlsUrl The HLS playlist URL (master or media)
+ * @param outputPath The output file path (should end in .mp4)
+ * @param onProgress Progress callback
+ */
+export async function downloadHLSVideo(hlsUrl, outputPath, onProgress) {
+    // Check if ffmpeg is available
+    const hasFfmpeg = await checkFfmpeg();
+    if (!hasFfmpeg) {
+        return {
+            success: false,
+            error: "ffmpeg is not installed. Please install ffmpeg to download HLS videos.",
+            errorCode: "FFMPEG_NOT_FOUND",
+        };
+    }
+    // Ensure output directory exists
+    const outputDir = path.dirname(outputPath);
+    if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true });
+    }
+    // Build ffmpeg command
+    const args = [
+        "-y", // Overwrite output
+        "-hide_banner",
+        "-loglevel",
+        "warning",
+        "-stats",
+        "-i",
+        hlsUrl,
+        "-c",
+        "copy", // Copy streams without re-encoding
+        "-bsf:a",
+        "aac_adtstoasc", // Fix AAC stream
+        outputPath,
+    ];
+    let duration = 0;
+    let currentTime = 0;
+    let lastProgressUpdate = 0;
+    const updateProgress = () => {
+        if (duration > 0 && onProgress) {
+            const percent = Math.min((currentTime / duration) * 100, 100);
+            const now = Date.now();
+            // Throttle progress updates to avoid spam
+            if (now - lastProgressUpdate > 200 || percent >= 100) {
+                lastProgressUpdate = now;
+                onProgress({
+                    phase: "downloading",
+                    percent: Math.round(percent),
+                    currentBytes: currentTime,
+                    totalBytes: duration,
+                });
+            }
+        }
+    };
+    try {
+        const subprocess = execa("ffmpeg", args);
+        // Parse stderr for progress info
+        subprocess.stderr?.on("data", (data) => {
+            const output = data.toString();
+            // Parse duration from input info
+            const durationMatch = /Duration:\s*(\d{2}):(\d{2}):(\d{2})\.(\d{2})/.exec(output);
+            if (durationMatch && duration === 0) {
+                duration =
+                    parseInt(durationMatch[1], 10) * 3600 +
+                        parseInt(durationMatch[2], 10) * 60 +
+                        parseInt(durationMatch[3], 10) +
+                        parseInt(durationMatch[4], 10) / 100;
+            }
+            // Parse current time from progress
+            const timeMatch = /time=(\d{2}):(\d{2}):(\d{2})\.(\d{2})/.exec(output);
+            if (timeMatch) {
+                currentTime =
+                    parseInt(timeMatch[1], 10) * 3600 +
+                        parseInt(timeMatch[2], 10) * 60 +
+                        parseInt(timeMatch[3], 10) +
+                        parseInt(timeMatch[4], 10) / 100;
+                updateProgress();
+            }
+        });
+        await subprocess;
+        // Final progress update
+        if (onProgress) {
+            onProgress({
+                phase: "complete",
+                percent: 100,
+            });
+        }
+        return {
+            success: true,
+            outputPath,
+            duration,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            error: `ffmpeg error: ${errorMessage}`,
+            errorCode: "FFMPEG_ERROR",
+        };
+    }
+}
+/**
+ * Downloads a HighLevel HLS video with quality selection.
+ * @param masterUrl The master playlist URL (may include token)
+ * @param outputPath The output file path
+ * @param preferredQuality Preferred quality label (e.g., "720p", "1080p")
+ * @param onProgress Progress callback
+ */
+export async function downloadHighLevelVideo(masterUrl, outputPath, preferredQuality, onProgress) {
+    // Report start
+    onProgress?.({
+        phase: "preparing",
+        percent: 0,
+    });
+    // Parse preferred height from quality string
+    let preferredHeight;
+    if (preferredQuality) {
+        const match = /(\d+)p?/i.exec(preferredQuality);
+        if (match) {
+            preferredHeight = parseInt(match[1], 10);
+        }
+    }
+    // Get the best quality URL
+    let downloadUrl = masterUrl;
+    try {
+        downloadUrl = await getBestQualityUrl(masterUrl, preferredHeight);
+    }
+    catch (error) {
+        console.warn("Failed to fetch quality options, using master URL:", error);
+    }
+    // Download using ffmpeg
+    return downloadHLSVideo(downloadUrl, outputPath, onProgress);
+}
+/**
+ * Extracts video info from a HighLevel HLS URL.
+ */
+export function parseHighLevelVideoUrl(url) {
+    try {
+        const urlObj = new URL(url);
+        // Pattern: /hls/v2/memberships/{locationId}/videos/{videoId}/...
+        const match = /\/memberships\/([^/]+)\/videos\/([^/,]+)/.exec(urlObj.pathname);
+        if (!match) {
+            return null;
+        }
+        const token = urlObj.searchParams.get("token");
+        return {
+            locationId: match[1],
+            videoId: match[2],
+            ...(token ? { token } : {}),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=hlsDownloader.js.map

package/dist/downloader/hlsDownloader.js.map

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

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

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

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

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

package/dist/downloader/hlsDownloader.test.js

@@ -0,0 +1,116 @@
+import { describe, expect, it } from "vitest";
+import { parseHLSPlaylist, parseHighLevelVideoUrl } from "./hlsDownloader.js";
+describe("parseHLSPlaylist", () => {
+    const baseUrl = "https://cdn.example.com/video/";
+    it("parses master playlist with multiple qualities", () => {
+        const content = `#EXTM3U
+#EXT-X-VERSION:3
+#EXT-X-STREAM-INF:BANDWIDTH=800000,RESOLUTION=640x360
+360p.m3u8
+#EXT-X-STREAM-INF:BANDWIDTH=1400000,RESOLUTION=854x480
+480p.m3u8
+#EXT-X-STREAM-INF:BANDWIDTH=2800000,RESOLUTION=1280x720
+720p.m3u8
+#EXT-X-STREAM-INF:BANDWIDTH=5000000,RESOLUTION=1920x1080
+1080p.m3u8`;
+        const result = parseHLSPlaylist(content, baseUrl);
+        expect(result).toHaveLength(4);
+        // Should be sorted by bandwidth (highest first)
+        expect(result[0].label).toBe("1080p");
+        expect(result[0].bandwidth).toBe(5000000);
+        expect(result[0].height).toBe(1080);
+        expect(result[0].width).toBe(1920);
+        expect(result[0].url).toBe("https://cdn.example.com/video/1080p.m3u8");
+        expect(result[3].label).toBe("360p");
+        expect(result[3].bandwidth).toBe(800000);
+    });
+    it("handles absolute URLs in playlist", () => {
+        const content = `#EXTM3U
+#EXT-X-STREAM-INF:BANDWIDTH=2800000,RESOLUTION=1280x720
+https://other-cdn.com/video/720p.m3u8`;
+        const result = parseHLSPlaylist(content, baseUrl);
+        expect(result).toHaveLength(1);
+        expect(result[0].url).toBe("https://other-cdn.com/video/720p.m3u8");
+    });
+    it("handles playlist without resolution", () => {
+        const content = `#EXTM3U
+#EXT-X-STREAM-INF:BANDWIDTH=500000
+audio.m3u8`;
+        const result = parseHLSPlaylist(content, baseUrl);
+        expect(result).toHaveLength(1);
+        expect(result[0].label).toBe("500k");
+        expect(result[0].height).toBeUndefined();
+        expect(result[0].width).toBeUndefined();
+    });
+    it("handles empty playlist", () => {
+        const content = `#EXTM3U
+#EXT-X-VERSION:3`;
+        const result = parseHLSPlaylist(content, baseUrl);
+        expect(result).toHaveLength(0);
+    });
+    it("ignores comments and metadata", () => {
+        const content = `#EXTM3U
+#EXT-X-VERSION:3
+# This is a comment
+#EXT-X-INDEPENDENT-SEGMENTS
+#EXT-X-STREAM-INF:BANDWIDTH=1000000,RESOLUTION=1280x720
+720p.m3u8`;
+        const result = parseHLSPlaylist(content, baseUrl);
+        expect(result).toHaveLength(1);
+    });
+    it("handles real-world Vimeo-style playlist", () => {
+        const content = `#EXTM3U
+#EXT-X-VERSION:4
+#EXT-X-STREAM-INF:AVERAGE-BANDWIDTH=246064,BANDWIDTH=326400,CODECS="avc1.4D401E,mp4a.40.2",RESOLUTION=426x240,FRAME-RATE=24.000
+https://vod.example.com/exp=123/~hmac=abc/240p/prog_index.m3u8
+#EXT-X-STREAM-INF:AVERAGE-BANDWIDTH=602416,BANDWIDTH=796800,CODECS="avc1.4D401F,mp4a.40.2",RESOLUTION=640x360,FRAME-RATE=24.000
+https://vod.example.com/exp=123/~hmac=abc/360p/prog_index.m3u8
+#EXT-X-STREAM-INF:AVERAGE-BANDWIDTH=1270416,BANDWIDTH=1680000,CODECS="avc1.4D401F,mp4a.40.2",RESOLUTION=854x480,FRAME-RATE=24.000
+https://vod.example.com/exp=123/~hmac=abc/480p/prog_index.m3u8`;
+        const result = parseHLSPlaylist(content, baseUrl);
+        expect(result).toHaveLength(3);
+        expect(result[0].height).toBe(480);
+        expect(result[1].height).toBe(360);
+        expect(result[2].height).toBe(240);
+    });
+});
+describe("parseHighLevelVideoUrl", () => {
+    it("parses standard HighLevel HLS URL", () => {
+        const url = "https://backend.leadconnectorhq.com/hls/v2/memberships/ABC123/videos/video-id-456/master.m3u8";
+        const result = parseHighLevelVideoUrl(url);
+        expect(result).toEqual({
+            locationId: "ABC123",
+            videoId: "video-id-456",
+        });
+    });
+    it("parses URL with token", () => {
+        const url = "https://backend.leadconnectorhq.com/hls/v2/memberships/LOC123/videos/VID456/master.m3u8?token=secret-token";
+        const result = parseHighLevelVideoUrl(url);
+        expect(result).toEqual({
+            locationId: "LOC123",
+            videoId: "VID456",
+            token: "secret-token",
+        });
+    });
+    it("handles complex video IDs", () => {
+        const url = "https://cdn.example.com/hls/memberships/location-abc/videos/cts-184162b5f0747fcd,1080p/master.m3u8";
+        const result = parseHighLevelVideoUrl(url);
+        expect(result).toEqual({
+            locationId: "location-abc",
+            videoId: "cts-184162b5f0747fcd",
+        });
+    });
+    it("returns null for non-HighLevel URLs", () => {
+        expect(parseHighLevelVideoUrl("https://vimeo.com/123456")).toBeNull();
+        expect(parseHighLevelVideoUrl("https://youtube.com/watch?v=abc")).toBeNull();
+    });
+    it("returns null for invalid URLs", () => {
+        expect(parseHighLevelVideoUrl("not-a-url")).toBeNull();
+        expect(parseHighLevelVideoUrl("")).toBeNull();
+    });
+    it("returns null for missing video path", () => {
+        const url = "https://backend.leadconnectorhq.com/hls/v2/other/path";
+        expect(parseHighLevelVideoUrl(url)).toBeNull();
+    });
+});
+//# sourceMappingURL=hlsDownloader.test.js.map

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

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

package/dist/downloader/hlsValidator.d.ts

@@ -0,0 +1,35 @@
+import type { Page } from "playwright";
+/**
+ * Result of HLS validation.
+ */
+export interface HlsValidationResult {
+    isValid: boolean;
+    hlsUrl: string | null;
+    error?: string;
+    errorCode?: string;
+    details?: string;
+}
+/**
+ * Validates that a Loom video has an accessible HLS stream.
+ * This should be called during the scanning phase to catch issues early.
+ *
+ * @param loomUrl - The Loom video URL
+ * @param page - Optional Playwright page for network interception fallback
+ */
+export declare function validateLoomHls(loomUrl: string, page?: Page): Promise<HlsValidationResult>;
+/**
+ * Validates a Vimeo video has accessible streams.
+ * @param vimeoUrl - The Vimeo video URL
+ * @param page - Optional Playwright page for domain-restricted videos
+ * @param lessonUrl - Optional lesson URL for referer-based access
+ */
+export declare function validateVimeoVideo(vimeoUrl: string, page?: Page, lessonUrl?: string): Promise<HlsValidationResult>;
+/**
+ * Validates HLS availability for a video URL based on its type.
+ * @param videoUrl - The video URL to validate
+ * @param videoType - The type of video (loom, vimeo, etc.)
+ * @param page - Optional Playwright page for network interception fallback
+ * @param lessonUrl - Optional lesson URL for referer-based access
+ */
+export declare function validateVideoHls(videoUrl: string, videoType: string, page?: Page, lessonUrl?: string): Promise<HlsValidationResult>;
+//# sourceMappingURL=hlsValidator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hlsValidator.d.ts","sourceRoot":"","sources":["../../src/downloader/hlsValidator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,IAAI,GACV,OAAO,CAAC,mBAAmB,CAAC,CAgD9B;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,IAAI,EACX,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,mBAAmB,CAAC,CAyD9B;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,IAAI,EACX,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,mBAAmB,CAAC,CAgC9B"}

package/dist/downloader/hlsValidator.js

@@ -0,0 +1,148 @@
+import { extractLoomId, getLoomVideoInfoDetailed } from "./loomDownloader.js";
+import { extractVimeoId, getVimeoVideoInfo, getVimeoVideoInfoFromBrowser } from "./vimeoDownloader.js";
+import { captureLoomHls, captureVimeoConfig } from "../scraper/videoInterceptor.js";
+/**
+ * Validates that a Loom video has an accessible HLS stream.
+ * This should be called during the scanning phase to catch issues early.
+ *
+ * @param loomUrl - The Loom video URL
+ * @param page - Optional Playwright page for network interception fallback
+ */
+export async function validateLoomHls(loomUrl, page) {
+    const videoId = extractLoomId(loomUrl);
+    if (!videoId) {
+        return {
+            isValid: false,
+            hlsUrl: null,
+            error: "Invalid Loom URL - could not extract video ID",
+            errorCode: "INVALID_URL",
+            details: `URL: ${loomUrl}`,
+        };
+    }
+    // First try direct API
+    const result = await getLoomVideoInfoDetailed(videoId, 2, 500);
+    if (result.success && result.info) {
+        return {
+            isValid: true,
+            hlsUrl: result.info.hlsUrl,
+        };
+    }
+    // If direct API failed and we have a page, try network interception
+    if (page && result.errorCode === "HLS_NOT_FOUND") {
+        const captured = await captureLoomHls(page, videoId, 15000);
+        if (captured.hlsUrl) {
+            return {
+                isValid: true,
+                hlsUrl: captured.hlsUrl,
+                details: "Captured via network interception",
+            };
+        }
+    }
+    // Return the original error
+    const validation = {
+        isValid: false,
+        hlsUrl: null,
+        error: result.error ?? "Failed to fetch Loom video info",
+    };
+    if (result.errorCode) {
+        validation.errorCode = result.errorCode;
+    }
+    if (result.details) {
+        validation.details = result.details;
+    }
+    return validation;
+}
+/**
+ * Validates a Vimeo video has accessible streams.
+ * @param vimeoUrl - The Vimeo video URL
+ * @param page - Optional Playwright page for domain-restricted videos
+ * @param lessonUrl - Optional lesson URL for referer-based access
+ */
+export async function validateVimeoVideo(vimeoUrl, page, lessonUrl) {
+    const videoId = extractVimeoId(vimeoUrl);
+    if (!videoId) {
+        return {
+            isValid: false,
+            hlsUrl: null,
+            error: "Invalid Vimeo URL - could not extract video ID",
+            errorCode: "INVALID_URL",
+            details: `URL: ${vimeoUrl}`,
+        };
+    }
+    // Extract unlisted hash if present
+    const hashMatch = (/vimeo\.com\/\d+\/([a-f0-9]+)/.exec(vimeoUrl)) ?? (/[?&]h=([a-f0-9]+)/.exec(vimeoUrl));
+    const unlistedHash = hashMatch?.[1] ?? null;
+    // First try direct fetch (works for public videos)
+    let result = await getVimeoVideoInfo(videoId, unlistedHash, lessonUrl);
+    // If video is private/restricted and we have a browser context, try browser-based fetch
+    if (!result.success && result.errorCode === "PRIVATE_VIDEO" && page) {
+        result = await getVimeoVideoInfoFromBrowser(page, videoId, unlistedHash);
+    }
+    // If still failing and we have a page, try extracting from the running player
+    if (!result.success && result.errorCode === "PRIVATE_VIDEO" && page) {
+        const captured = await captureVimeoConfig(page, videoId, 20000);
+        if (captured.hlsUrl || captured.progressiveUrl) {
+            return {
+                isValid: true,
+                hlsUrl: captured.hlsUrl ?? captured.progressiveUrl,
+                details: "Extracted from running player",
+            };
+        }
+    }
+    if (!result.success || !result.info) {
+        const validation = {
+            isValid: false,
+            hlsUrl: null,
+            error: result.error ?? "Failed to fetch Vimeo video info",
+        };
+        if (result.errorCode) {
+            validation.errorCode = result.errorCode;
+        }
+        if (result.details) {
+            validation.details = result.details;
+        }
+        return validation;
+    }
+    // Return HLS URL if available, or progressive URL as fallback
+    return {
+        isValid: true,
+        hlsUrl: result.info.hlsUrl ?? result.info.progressiveUrl,
+    };
+}
+/**
+ * Validates HLS availability for a video URL based on its type.
+ * @param videoUrl - The video URL to validate
+ * @param videoType - The type of video (loom, vimeo, etc.)
+ * @param page - Optional Playwright page for network interception fallback
+ * @param lessonUrl - Optional lesson URL for referer-based access
+ */
+export async function validateVideoHls(videoUrl, videoType, page, lessonUrl) {
+    switch (videoType) {
+        case "loom":
+            return validateLoomHls(videoUrl, page);
+        case "vimeo":
+            return validateVimeoVideo(videoUrl, page, lessonUrl);
+        case "youtube":
+        case "wistia":
+            // These require yt-dlp - skip validation, will fail at download
+            return {
+                isValid: true,
+                hlsUrl: null,
+                details: `${videoType} requires yt-dlp - will attempt download`,
+            };
+        case "native":
+            // Native videos have direct URLs, no HLS needed
+            return {
+                isValid: true,
+                hlsUrl: videoUrl,
+            };
+        default:
+            return {
+                isValid: false,
+                hlsUrl: null,
+                error: `Unknown video type: ${videoType}`,
+                errorCode: "UNKNOWN_TYPE",
+            };
+    }
+}
+//# sourceMappingURL=hlsValidator.js.map