offcourse 0.0.2 → 1.0.0

package/src/downloader/index.ts

@@ -0,0 +1,122 @@
+/**
+ * Video download coordination - delegates to type-specific downloaders.
+ */
+import { downloadFile, downloadLoomVideo, type DownloadProgress } from "./loomDownloader.js";
+import { downloadVimeoVideo } from "./vimeoDownloader.js";
+import { downloadHighLevelVideo, downloadHLSVideo } from "./hlsDownloader.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 async function downloadVideo(
+  task: VideoDownloadTask,
+  onProgress?: (progress: DownloadProgress) => void
+): Promise<DownloadResult> {
+  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,
+  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";

package/src/downloader/loomDownloader.test.ts

@@ -0,0 +1,43 @@
+import { describe, expect, it } from "vitest";
+import { extractLoomId } from "./loomDownloader.js";
+
+describe("extractLoomId", () => {
+  it("extracts ID from embed URL", () => {
+    const url = "https://www.loom.com/embed/a1b2c3d4e5f6";
+    expect(extractLoomId(url)).toBe("a1b2c3d4e5f6");
+  });
+
+  it("extracts ID from share URL", () => {
+    const url = "https://www.loom.com/share/abcdef123456";
+    expect(extractLoomId(url)).toBe("abcdef123456");
+  });
+
+  it("extracts ID from URL with query params", () => {
+    const url = "https://www.loom.com/embed/abc123?autoplay=1&t=10";
+    expect(extractLoomId(url)).toBe("abc123");
+  });
+
+  it("handles URL without www", () => {
+    const url = "https://loom.com/embed/abc123def456";
+    expect(extractLoomId(url)).toBe("abc123def456");
+  });
+
+  it("returns null for invalid URL", () => {
+    expect(extractLoomId("https://youtube.com/watch?v=123")).toBeNull();
+    expect(extractLoomId("not-a-url")).toBeNull();
+  });
+
+  it("returns null for Loom homepage", () => {
+    expect(extractLoomId("https://loom.com")).toBeNull();
+  });
+
+  it("returns null for empty string", () => {
+    expect(extractLoomId("")).toBeNull();
+  });
+
+  it("handles very long IDs", () => {
+    const longId = "a".repeat(32);
+    const url = `https://loom.com/embed/${longId}`;
+    expect(extractLoomId(url)).toBe(longId);
+  });
+});