offcourse 0.0.2 → 1.0.1

package/dist/downloader/hlsDownloader.js

@@ -0,0 +1,263 @@
+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.
+ */
+/* v8 ignore next 8 */
+export async function checkFfmpeg() {
+    try {
+        await execa("ffmpeg", ["-version"]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Fetches an HLS master playlist and parses quality variants.
+ */
+/* v8 ignore next 14 */
+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)
+ */
+/* v8 ignore start */
+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);
+        const closest = lower[0];
+        if (closest) {
+            return closest.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) {
+                const [, hours = "0", mins = "0", secs = "0", centis = "0"] = durationMatch;
+                duration =
+                    parseInt(hours, 10) * 3600 +
+                        parseInt(mins, 10) * 60 +
+                        parseInt(secs, 10) +
+                        parseInt(centis, 10) / 100;
+            }
+            // Parse current time from progress
+            const timeMatch = /time=(\d{2}):(\d{2}):(\d{2})\.(\d{2})/.exec(output);
+            if (timeMatch) {
+                const [, hours = "0", mins = "0", secs = "0", centis = "0"] = timeMatch;
+                currentTime =
+                    parseInt(hours, 10) * 3600 +
+                        parseInt(mins, 10) * 60 +
+                        parseInt(secs, 10) +
+                        parseInt(centis, 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?.[1]) {
+            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);
+}
+/* v8 ignore stop */
+/**
+ * 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);
+        const locationId = match?.[1];
+        const videoId = match?.[2];
+        if (!locationId || !videoId) {
+            return null;
+        }
+        const token = urlObj.searchParams.get("token");
+        return {
+            locationId,
+            videoId,
+            ...(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":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAmBlC;;GAEG;AACH,sBAAsB;AACtB,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,uBAAuB;AACvB,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAiB;IACvD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtC,OAAO,gBAAgB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;QACvD,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,OAAe;IAC/D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEpC,gDAAgD;QAChD,IAAI,CAAC,CAAC,UAAU,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACpD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,QAAQ,GAAiB,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YAC/D,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;YACzC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;YACtC,MAAM,KAAK,GAAG,UAAU,EAAE,KAAK,CAAC;YAChC,MAAM,MAAM,GAAG,UAAU,EAAE,MAAM,CAAC;YAElC,qBAAqB;YACrB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;gBAC/C,CAAC,CAAC,OAAO,CAAC,GAAG;gBACb,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;YAEvC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC;YAEzE,OAAO;gBACL,KAAK;gBACL,GAAG,EAAE,UAAU;gBACf,SAAS;gBACT,KAAK;gBACL,MAAM;aACP,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,oCAAoC;QACpC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;QAEnD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,yCAAyC;QACzC,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,qBAAqB;AACrB,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAAiB,EACjB,eAAwB;IAExB,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAErD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,sCAAsC;QACtC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,eAAe,EAAE,CAAC;QACpB,yCAAyC;QACzC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,eAAe,CAAC,CAAC;QAClE,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC,GAAG,CAAC;QAE5B,6BAA6B;QAC7B,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,IAAI,eAAe,CAAC,CAAC;QAC/E,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC,GAAG,CAAC;QACrB,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,SAAS,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAc,EACd,UAAkB,EAClB,UAAiD;IAEjD,+BAA+B;IAC/B,MAAM,SAAS,GAAG,MAAM,WAAW,EAAE,CAAC;IACtC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,wEAAwE;YAC/E,SAAS,EAAE,kBAAkB;SAC9B,CAAC;IACJ,CAAC;IAED,iCAAiC;IACjC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,uBAAuB;IACvB,MAAM,IAAI,GAAG;QACX,IAAI,EAAE,mBAAmB;QACzB,cAAc;QACd,WAAW;QACX,SAAS;QACT,QAAQ;QACR,IAAI;QACJ,MAAM;QACN,IAAI;QACJ,MAAM,EAAE,mCAAmC;QAC3C,QAAQ;QACR,eAAe,EAAE,iBAAiB;QAClC,UAAU;KACX,CAAC;IAEF,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,kBAAkB,GAAG,CAAC,CAAC;IAE3B,MAAM,cAAc,GAAG,GAAG,EAAE;QAC1B,IAAI,QAAQ,GAAG,CAAC,IAAI,UAAU,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,GAAG,QAAQ,CAAC,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC;YAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAEvB,0CAA0C;YAC1C,IAAI,GAAG,GAAG,kBAAkB,GAAG,GAAG,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;gBACrD,kBAAkB,GAAG,GAAG,CAAC;gBACzB,UAAU,CAAC;oBACT,KAAK,EAAE,aAAa;oBACpB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;oBAC5B,YAAY,EAAE,WAAW;oBACzB,UAAU,EAAE,QAAQ;iBACrB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAEzC,iCAAiC;QACjC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAE/B,iCAAiC;YACjC,MAAM,aAAa,GAAG,8CAA8C,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAClF,IAAI,aAAa,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;gBACpC,MAAM,CAAC,EAAE,KAAK,GAAG,GAAG,EAAE,IAAI,GAAG,GAAG,EAAE,IAAI,GAAG,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,aAAa,CAAC;gBAC5E,QAAQ;oBACN,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,IAAI;wBAC1B,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE;wBACvB,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;wBAClB,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;YAC/B,CAAC;YAED,mCAAmC;YACnC,MAAM,SAAS,GAAG,uCAAuC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvE,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,CAAC,EAAE,KAAK,GAAG,GAAG,EAAE,IAAI,GAAG,GAAG,EAAE,IAAI,GAAG,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC;gBACxE,WAAW;oBACT,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,IAAI;wBAC1B,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE;wBACvB,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;wBAClB,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;gBAE7B,cAAc,EAAE,CAAC;YACnB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,UAAU,CAAC;QAEjB,wBAAwB;QACxB,IAAI,UAAU,EAAE,CAAC;YACf,UAAU,CAAC;gBACT,KAAK,EAAE,UAAU;gBACjB,OAAO,EAAE,GAAG;aACb,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,UAAU;YACV,QAAQ;SACT,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,iBAAiB,YAAY,EAAE;YACtC,SAAS,EAAE,cAAc;SAC1B,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,SAAiB,EACjB,UAAkB,EAClB,gBAAyB,EACzB,UAAiD;IAEjD,eAAe;IACf,UAAU,EAAE,CAAC;QACX,KAAK,EAAE,WAAW;QAClB,OAAO,EAAE,CAAC;KACX,CAAC,CAAC;IAEH,6CAA6C;IAC7C,IAAI,eAAmC,CAAC;IACxC,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAChD,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACf,eAAe,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,IAAI,WAAW,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC;QACH,WAAW,GAAG,MAAM,iBAAiB,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IACpE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,oDAAoD,EAAE,KAAK,CAAC,CAAC;IAC5E,CAAC;IAED,wBAAwB;IACxB,OAAO,gBAAgB,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AAC/D,CAAC;AACD,oBAAoB;AAEpB;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAKhD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAE5B,iEAAiE;QACjE,MAAM,KAAK,GAAG,0CAA0C,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/E,MAAM,UAAU,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QAE3B,IAAI,CAAC,UAAU,IAAI,CAAC,OAAO,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAE/C,OAAO;YACL,UAAU;YACV,OAAO;YACP,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5B,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

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":"AAWA,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,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAgDhG;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,IAAI,EACX,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,mBAAmB,CAAC,CA0D9B;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,152 @@
+/**
+ * HLS stream validation - requires network access to verify streams.
+ * Excluded from coverage via vitest.config.ts.
+ */
+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

package/dist/downloader/hlsValidator.js.map

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

package/dist/downloader/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Video download coordination - delegates to type-specific downloaders.
+ */
+import { type DownloadProgress } from "./loomDownloader.js";
+export interface VideoDownloadTask {
+    lessonId: number;
+    lessonName: string;
+    videoUrl: string;
+    videoType: "loom" | "vimeo" | "youtube" | "wistia" | "native" | "hls" | "highlevel" | "unknown" | null;
+    outputPath: string;
+    /** Optional preferred quality (e.g., "720p", "1080p") */
+    preferredQuality?: string | undefined;
+}
+export interface DownloadResult {
+    success: boolean;
+    error?: string | undefined;
+    errorCode?: string | undefined;
+    details?: string | undefined;
+}
+/**
+ * Downloads a video based on its type.
+ */
+export declare function downloadVideo(task: VideoDownloadTask, onProgress?: (progress: DownloadProgress) => void): Promise<DownloadResult>;
+export { downloadFile, downloadLoomVideo, extractLoomId, getLoomVideoInfoDetailed, type DownloadProgress, type LoomFetchResult, } from "./loomDownloader.js";
+export { downloadVimeoVideo, extractVimeoId, getVimeoVideoInfo, getVimeoVideoInfoFromBrowser, type VimeoDownloadResult, type VimeoFetchResult, type VimeoVideoInfo, } from "./vimeoDownloader.js";
+export { AsyncQueue, type QueueItem, type QueueOptions } from "./queue.js";
+export { validateLoomHls, validateVideoHls, validateVimeoVideo, type HlsValidationResult, } from "./hlsValidator.js";
+export { checkFfmpeg, downloadHighLevelVideo, downloadHLSVideo, fetchHLSQualities, getBestQualityUrl, parseHighLevelVideoUrl, parseHLSPlaylist, type HLSDownloadResult, type HLSQuality, } from "./hlsDownloader.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/downloader/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAmC,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAI7F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EACL,MAAM,GACN,OAAO,GACP,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,KAAK,GACL,WAAW,GACX,SAAS,GACT,IAAI,CAAC;IACT,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,iBAAiB,EACvB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,GAChD,OAAO,CAAC,cAAc,CAAC,CA8CzB;AAED,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,4BAA4B,EAC5B,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,UAAU,GAChB,MAAM,oBAAoB,CAAC"}

package/dist/downloader/index.js

@@ -0,0 +1,55 @@
+/**
+ * Video download coordination - delegates to type-specific downloaders.
+ */
+import { downloadFile, downloadLoomVideo } from "./loomDownloader.js";
+import { downloadVimeoVideo } from "./vimeoDownloader.js";
+import { downloadHighLevelVideo, downloadHLSVideo } from "./hlsDownloader.js";
+/**
+ * Downloads a video based on its type.
+ */
+export async function downloadVideo(task, onProgress) {
+    const { videoUrl, videoType, outputPath, preferredQuality } = task;
+    switch (videoType) {
+        case "loom":
+            return downloadLoomVideo(videoUrl, outputPath, onProgress);
+        case "vimeo":
+            return downloadVimeoVideo(videoUrl, outputPath, onProgress);
+        case "native":
+            // Direct MP4/WebM URL - download directly
+            return downloadFile(videoUrl, outputPath, onProgress);
+        case "hls":
+            // Generic HLS stream
+            return downloadHLSVideo(videoUrl, outputPath, onProgress);
+        case "highlevel":
+            // HighLevel HLS video with quality selection
+            return downloadHighLevelVideo(videoUrl, outputPath, preferredQuality, onProgress);
+        case "youtube":
+        case "wistia":
+            // These require yt-dlp or special handling
+            return {
+                success: false,
+                error: `${videoType} videos are not yet supported. Consider installing yt-dlp. Video URL: ${videoUrl}`,
+                errorCode: "UNSUPPORTED_TYPE",
+            };
+        case "unknown":
+        default:
+            // Try direct download as fallback
+            if (/\.(mp4|webm|mov)(\?|$)/i.exec(videoUrl)) {
+                return downloadFile(videoUrl, outputPath, onProgress);
+            }
+            // Try HLS if it looks like a playlist
+            if (/\.m3u8(\?|$)/i.exec(videoUrl)) {
+                return downloadHLSVideo(videoUrl, outputPath, onProgress);
+            }
+            return {
+                success: false,
+                error: `Unknown video type. URL: ${videoUrl}`,
+            };
+    }
+}
+export { downloadFile, downloadLoomVideo, extractLoomId, getLoomVideoInfoDetailed, } from "./loomDownloader.js";
+export { downloadVimeoVideo, extractVimeoId, getVimeoVideoInfo, getVimeoVideoInfoFromBrowser, } from "./vimeoDownloader.js";
+export { AsyncQueue } from "./queue.js";
+export { validateLoomHls, validateVideoHls, validateVimeoVideo, } from "./hlsValidator.js";
+export { checkFfmpeg, downloadHighLevelVideo, downloadHLSVideo, fetchHLSQualities, getBestQualityUrl, parseHighLevelVideoUrl, parseHLSPlaylist, } from "./hlsDownloader.js";
+//# sourceMappingURL=index.js.map

package/dist/downloader/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/downloader/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAyB,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AA4B9E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAuB,EACvB,UAAiD;IAEjD,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;IAEnE,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,iBAAiB,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAE7D,KAAK,OAAO;YACV,OAAO,kBAAkB,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAE9D,KAAK,QAAQ;YACX,0CAA0C;YAC1C,OAAO,YAAY,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAExD,KAAK,KAAK;YACR,qBAAqB;YACrB,OAAO,gBAAgB,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAE5D,KAAK,WAAW;YACd,6CAA6C;YAC7C,OAAO,sBAAsB,CAAC,QAAQ,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,CAAC,CAAC;QAEpF,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ;YACX,2CAA2C;YAC3C,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,GAAG,SAAS,yEAAyE,QAAQ,EAAE;gBACtG,SAAS,EAAE,kBAAkB;aAC9B,CAAC;QAEJ,KAAK,SAAS,CAAC;QACf;YACE,kCAAkC;YAClC,IAAI,yBAAyB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7C,OAAO,YAAY,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;YACxD,CAAC;YACD,sCAAsC;YACtC,IAAI,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACnC,OAAO,gBAAgB,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;YAC5D,CAAC;YACD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,4BAA4B,QAAQ,EAAE;aAC9C,CAAC;IACN,CAAC;AACH,CAAC;AAED,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,wBAAwB,GAGzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,4BAA4B,GAI7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAqC,MAAM,YAAY,CAAC;AAC3E,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GAEnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,GAGjB,MAAM,oBAAoB,CAAC"}

package/dist/downloader/loomDownloader.d.ts

@@ -0,0 +1,56 @@
+export interface LoomVideoInfo {
+    id: string;
+    title: string;
+    duration: number;
+    width: number;
+    height: number;
+    hlsUrl: string;
+}
+export interface LoomFetchResult {
+    success: boolean;
+    info?: LoomVideoInfo;
+    error?: string;
+    errorCode?: "EMBED_FETCH_FAILED" | "HLS_NOT_FOUND" | "RATE_LIMITED" | "NETWORK_ERROR" | "PARSE_ERROR";
+    statusCode?: number;
+    details?: string;
+}
+export interface DownloadProgress {
+    percent: number;
+    downloaded?: number | undefined;
+    total?: number | undefined;
+    phase?: "preparing" | "downloading" | "complete" | undefined;
+    currentBytes?: number | undefined;
+    totalBytes?: number | undefined;
+}
+/**
+ * Extracts the Loom video ID from various URL formats.
+ */
+export declare function extractLoomId(url: string): string | null;
+/**
+ * Fetches video information from Loom's embed page with detailed error reporting.
+ * Uses p-retry for automatic retries with exponential backoff.
+ */
+export declare function getLoomVideoInfoDetailed(videoId: string, retryCount?: number, retryDelayMs?: number): Promise<LoomFetchResult>;
+/**
+ * Fetches video information from Loom's embed page.
+ * @deprecated Use getLoomVideoInfoDetailed for better error reporting
+ */
+export declare function getLoomVideoInfo(videoId: string): Promise<LoomVideoInfo | null>;
+export interface LoomDownloadResult {
+    success: boolean;
+    error?: string;
+    errorCode?: LoomFetchResult["errorCode"] | "INVALID_URL" | "NO_VIDEO_STREAM" | "NO_SEGMENTS" | "DOWNLOAD_FAILED" | "MERGE_FAILED";
+    details?: string;
+}
+/**
+ * Downloads a Loom video using HLS.
+ */
+export declare function downloadLoomVideo(urlOrId: string, outputPath: string, onProgress?: (progress: DownloadProgress) => void): Promise<LoomDownloadResult>;
+/**
+ * Downloads a file directly.
+ */
+export declare function downloadFile(url: string, outputPath: string, onProgress?: (progress: DownloadProgress) => void): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=loomDownloader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loomDownloader.d.ts","sourceRoot":"","sources":["../../src/downloader/loomDownloader.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,aAAa;IAC5B,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,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EACN,oBAAoB,GACpB,eAAe,GACf,cAAc,GACd,eAAe,GACf,aAAa,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,WAAW,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,CAAC;IAC7D,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGxD;AAkKD;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,UAAU,SAAI,EACd,YAAY,SAAO,GAClB,OAAO,CAAC,eAAe,CAAC,CAoC1B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAGrF;AAyMD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EACN,eAAe,CAAC,WAAW,CAAC,GAC5B,aAAa,GACb,iBAAiB,GACjB,aAAa,GACb,iBAAiB,GACjB,cAAc,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,GAChD,OAAO,CAAC,kBAAkB,CAAC,CAuL7B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,GAChD,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgE/C"}