offcourse 0.0.2 → 1.0.1

package/dist/cli/index.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { configGetCommand, configSetCommand, configShowCommand } from "./commands/config.js";
+import { inspectCommand } from "./commands/inspect.js";
+import { loginCommand, logoutCommand } from "./commands/login.js";
+import { statusCommand, statusListCommand } from "./commands/status.js";
+import { syncCommand } from "./commands/sync.js";
+import { syncHighLevelCommand, isHighLevelPortal, } from "./commands/syncHighLevel.js";
+const program = new Command();
+program
+    .name("offcourse")
+    .description("Download online courses for offline access – of course!")
+    .version("0.1.0");
+// Login command
+program
+    .command("login")
+    .description("Log in to a learning platform (opens browser)")
+    .option("-f, --force", "Force re-login even if session exists")
+    .action(loginCommand);
+// Logout command
+program.command("logout").description("Clear saved session").action(logoutCommand);
+// Sync command - auto-detects platform
+program
+    .command("sync <url>")
+    .description("Download a course for offline access (auto-detects platform)")
+    .option("--skip-videos", "Skip video downloads (only save text content)")
+    .option("--skip-content", "Skip text content (only download videos)")
+    .option("--dry-run", "Scan course structure without downloading")
+    .option("--limit <n>", "Limit to first N lessons (for testing)", parseInt)
+    .option("-f, --force", "Force full rescan of all lessons")
+    .option("--retry-failed", "Retry failed lessons with detailed diagnostics")
+    .option("--visible", "Show browser window (default: headless)")
+    .option("-q, --quality <quality>", "Preferred video quality (e.g., 720p, 1080p)")
+    .option("--course-name <name>", "Override detected course name")
+    .action((url, options) => {
+    // Auto-detect platform
+    if (url.includes("skool.com")) {
+        return syncCommand(url, options);
+    }
+    else if (isHighLevelPortal(url)) {
+        return syncHighLevelCommand(url, options);
+    }
+    else {
+        // Default: try HighLevel (most generic)
+        console.log("Platform not recognized, trying as HighLevel portal...");
+        return syncHighLevelCommand(url, options);
+    }
+});
+// Explicit Skool sync command
+program
+    .command("sync-skool <url>")
+    .description("Download a Skool course for offline access")
+    .option("--skip-videos", "Skip video downloads (only save text content)")
+    .option("--skip-content", "Skip text content (only download videos)")
+    .option("--dry-run", "Scan course structure without downloading")
+    .option("--limit <n>", "Limit to first N lessons (for testing)", parseInt)
+    .option("-f, --force", "Force full rescan of all lessons")
+    .option("--retry-failed", "Retry failed lessons with detailed diagnostics")
+    .option("--visible", "Show browser window (default: headless)")
+    .action(syncCommand);
+// Explicit HighLevel sync command
+program
+    .command("sync-highlevel <url>")
+    .description("Download a HighLevel (GoHighLevel) course for offline access")
+    .option("--skip-videos", "Skip video downloads (only save text content)")
+    .option("--skip-content", "Skip text content (only download videos)")
+    .option("--dry-run", "Scan course structure without downloading")
+    .option("--limit <n>", "Limit to first N lessons (for testing)", parseInt)
+    .option("--visible", "Show browser window (default: headless)")
+    .option("-q, --quality <quality>", "Preferred video quality (e.g., 720p, 1080p)")
+    .option("--course-name <name>", "Override detected course name")
+    .action(syncHighLevelCommand);
+// Status command
+program
+    .command("status [url]")
+    .description("Show sync status for a course (or list all if no URL)")
+    .option("--errors", "Show details for failed downloads")
+    .option("--pending", "Show not-yet-scanned lessons")
+    .option("-a, --all", "Show all details")
+    .action((url, options) => {
+    if (url) {
+        statusCommand(url, options);
+    }
+    else {
+        void statusListCommand();
+    }
+});
+// Inspect command (debugging)
+program
+    .command("inspect <url>")
+    .description("Analyze page structure for debugging")
+    .option("-o, --output <dir>", "Save analysis to directory")
+    .option("--full", "Save complete HTML as well")
+    .option("--click", "Try to click video preview to trigger lazy loading")
+    .action(inspectCommand);
+// Config commands
+const configCmd = program.command("config").description("Manage configuration");
+configCmd.command("show").description("Show all configuration values").action(configShowCommand);
+configCmd.command("get <key>").description("Get a configuration value").action(configGetCommand);
+configCmd
+    .command("set <key> <value>")
+    .description("Set a configuration value")
+    .action(configSetCommand);
+// Parse and run
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/config/configManager.d.ts

@@ -0,0 +1,31 @@
+import { Config } from "./schema.js";
+/**
+ * Ensures all required application directories exist.
+ */
+export declare function ensureAppDirectories(): Promise<void>;
+/**
+ * Loads the application configuration.
+ * Returns validated config with defaults applied.
+ */
+export declare function loadConfig(): Config;
+/**
+ * Saves the configuration.
+ */
+export declare function saveConfig(config: Config): void;
+/**
+ * Updates specific config values.
+ */
+export declare function updateConfig(updates: Partial<Config>): Config;
+/**
+ * Gets a specific config value.
+ */
+export declare function getConfigValue<K extends keyof Config>(key: K): Config[K];
+/**
+ * Clears all configuration (for testing or reset).
+ */
+export declare function clearConfig(): void;
+/**
+ * Gets the path to the config file.
+ */
+export declare function getConfigPath(): string;
+//# sourceMappingURL=configManager.d.ts.map

package/dist/config/configManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configManager.d.ts","sourceRoot":"","sources":["../../src/config/configManager.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAgB,MAAM,aAAa,CAAC;AAcnD;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAG1D;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAGnC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAG/C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAK7D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAExE;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/config/configManager.js

@@ -0,0 +1,68 @@
+/**
+ * Application configuration using the `conf` package.
+ * Excluded from coverage - testing would just test the conf package.
+ */
+import Conf from "conf";
+import { APP_DIR, SESSIONS_DIR } from "./paths.js";
+import { configSchema } from "./schema.js";
+import { ensureDir } from "../shared/fs.js";
+/**
+ * Application configuration store using conf package.
+ * Provides atomic writes, dot-notation access, and safe defaults.
+ */
+const store = new Conf({
+    projectName: "offcourse",
+    cwd: APP_DIR,
+    configName: "config",
+    defaults: configSchema.parse({}),
+});
+/**
+ * Ensures all required application directories exist.
+ */
+export async function ensureAppDirectories() {
+    const dirs = [APP_DIR, SESSIONS_DIR, `${APP_DIR}/sync-state`];
+    await Promise.all(dirs.map((dir) => ensureDir(dir)));
+}
+/**
+ * Loads the application configuration.
+ * Returns validated config with defaults applied.
+ */
+export function loadConfig() {
+    // Validate with zod to ensure type safety
+    return configSchema.parse(store.store);
+}
+/**
+ * Saves the configuration.
+ */
+export function saveConfig(config) {
+    const validated = configSchema.parse(config);
+    store.store = validated;
+}
+/**
+ * Updates specific config values.
+ */
+export function updateConfig(updates) {
+    const current = loadConfig();
+    const updated = configSchema.parse({ ...current, ...updates });
+    store.store = updated;
+    return updated;
+}
+/**
+ * Gets a specific config value.
+ */
+export function getConfigValue(key) {
+    return store.get(key);
+}
+/**
+ * Clears all configuration (for testing or reset).
+ */
+export function clearConfig() {
+    store.clear();
+}
+/**
+ * Gets the path to the config file.
+ */
+export function getConfigPath() {
+    return store.path;
+}
+//# sourceMappingURL=configManager.js.map

package/dist/config/configManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configManager.js","sourceRoot":"","sources":["../../src/config/configManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAU,YAAY,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;GAGG;AACH,MAAM,KAAK,GAAG,IAAI,IAAI,CAAS;IAC7B,WAAW,EAAE,WAAW;IACxB,GAAG,EAAE,OAAO;IACZ,UAAU,EAAE,QAAQ;IACpB,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;CACjC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,aAAa,CAAC,CAAC;IAC9D,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,0CAA0C;IAC1C,OAAO,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAwB;IACnD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/D,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC;IACtB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAyB,GAAM;IAC3D,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,CAAC,IAAI,CAAC;AACpB,CAAC"}

package/dist/config/paths.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Application directory paths.
+ * Uses ~/.offcourse/ for easy access and visibility.
+ */
+export declare const APP_DIR: string;
+export declare const SESSIONS_DIR: string;
+export declare const CONFIG_FILE: string;
+export declare const CACHE_DIR: string;
+/**
+ * Get the session file path for a specific domain.
+ */
+export declare function getSessionPath(domain: string): string;
+/**
+ * Get the sync state file path for a course.
+ */
+export declare function getSyncStatePath(courseSlug: string): string;
+/**
+ * Expand ~ to home directory in paths.
+ */
+export declare function expandPath(path: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/config/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,eAAO,MAAM,OAAO,QAAgC,CAAC;AACrD,eAAO,MAAM,YAAY,QAA4B,CAAC;AACtD,eAAO,MAAM,WAAW,QAA+B,CAAC;AACxD,eAAO,MAAM,SAAS,QAAyB,CAAC;AAEhD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/config/paths.js

@@ -0,0 +1,33 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+import untildify from "untildify";
+/**
+ * Application directory paths.
+ * Uses ~/.offcourse/ for easy access and visibility.
+ */
+export const APP_DIR = join(homedir(), ".offcourse");
+export const SESSIONS_DIR = join(APP_DIR, "sessions");
+export const CONFIG_FILE = join(APP_DIR, "config.json");
+export const CACHE_DIR = join(APP_DIR, "cache");
+/**
+ * Get the session file path for a specific domain.
+ */
+export function getSessionPath(domain) {
+    // Sanitize domain for filesystem
+    const safeDomain = domain.replace(/[^a-zA-Z0-9.-]/g, "_");
+    return join(SESSIONS_DIR, `${safeDomain}.json`);
+}
+/**
+ * Get the sync state file path for a course.
+ */
+export function getSyncStatePath(courseSlug) {
+    const safeSlug = courseSlug.replace(/[^a-zA-Z0-9-]/g, "_");
+    return join(APP_DIR, "sync-state", `${safeSlug}.json`);
+}
+/**
+ * Expand ~ to home directory in paths.
+ */
+export function expandPath(path) {
+    return untildify(path);
+}
+//# sourceMappingURL=paths.js.map

package/dist/config/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,SAAS,MAAM,WAAW,CAAC;AAElC;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AACtD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,iCAAiC;IACjC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,YAAY,EAAE,GAAG,UAAU,OAAO,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,QAAQ,OAAO,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/config/schema.d.ts

@@ -0,0 +1,60 @@
+import { z } from "zod";
+/**
+ * Video quality preferences for downloads.
+ */
+export declare const VIDEO_QUALITY: {
+    readonly highest: "highest";
+    readonly lowest: "lowest";
+    readonly "1080p": "1080p";
+    readonly "720p": "720p";
+    readonly "480p": "480p";
+};
+export type VideoQuality = keyof typeof VIDEO_QUALITY;
+/**
+ * Global application configuration schema.
+ */
+export declare const configSchema: z.ZodObject<{
+    outputDir: z.ZodDefault<z.ZodString>;
+    videoQuality: z.ZodDefault<z.ZodEnum<{
+        highest: "highest";
+        lowest: "lowest";
+        "1080p": "1080p";
+        "720p": "720p";
+        "480p": "480p";
+    }>>;
+    concurrency: z.ZodDefault<z.ZodNumber>;
+    retryAttempts: z.ZodDefault<z.ZodNumber>;
+    headless: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type Config = z.infer<typeof configSchema>;
+/**
+ * Course sync state to track progress and enable resume.
+ */
+export declare const courseSyncStateSchema: z.ZodObject<{
+    url: z.ZodURL;
+    name: z.ZodString;
+    lastSyncedAt: z.ZodOptional<z.ZodISODateTime>;
+    modules: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        slug: z.ZodString;
+        lessons: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            slug: z.ZodString;
+            url: z.ZodURL;
+            isCompleted: z.ZodDefault<z.ZodBoolean>;
+            videoDownloaded: z.ZodDefault<z.ZodBoolean>;
+            contentSaved: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CourseSyncState = z.infer<typeof courseSyncStateSchema>;
+/**
+ * Session info for a specific domain.
+ */
+export declare const sessionInfoSchema: z.ZodObject<{
+    domain: z.ZodString;
+    createdAt: z.ZodISODateTime;
+    expiresAt: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strip>;
+export type SessionInfo = z.infer<typeof sessionInfoSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,aAAa,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;iBAMvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;iBAoBhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;iBAI5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/config/schema.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+/**
+ * Video quality preferences for downloads.
+ */
+export const VIDEO_QUALITY = {
+    highest: "highest",
+    lowest: "lowest",
+    "1080p": "1080p",
+    "720p": "720p",
+    "480p": "480p",
+};
+/**
+ * Global application configuration schema.
+ */
+export const configSchema = z.object({
+    outputDir: z.string().default("~/Downloads/offcourse"),
+    videoQuality: z.enum(["highest", "lowest", "1080p", "720p", "480p"]).default("highest"),
+    concurrency: z.number().int().min(1).max(5).default(2),
+    retryAttempts: z.number().int().min(0).max(10).default(3),
+    headless: z.boolean().default(true),
+});
+/**
+ * Course sync state to track progress and enable resume.
+ */
+export const courseSyncStateSchema = z.object({
+    url: z.url(),
+    name: z.string(),
+    lastSyncedAt: z.iso.datetime().optional(),
+    modules: z.array(z.object({
+        name: z.string(),
+        slug: z.string(),
+        lessons: z.array(z.object({
+            name: z.string(),
+            slug: z.string(),
+            url: z.url(),
+            isCompleted: z.boolean().default(false),
+            videoDownloaded: z.boolean().default(false),
+            contentSaved: z.boolean().default(false),
+        })),
+    })),
+});
+/**
+ * Session info for a specific domain.
+ */
+export const sessionInfoSchema = z.object({
+    domain: z.string(),
+    createdAt: z.iso.datetime(),
+    expiresAt: z.iso.datetime().optional(),
+});
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,MAAM;CACN,CAAC;AAIX;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC;IACtD,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IACvF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACpC,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE;IACZ,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,YAAY,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACzC,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE;YACZ,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;YACvC,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;YAC3C,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;SACzC,CAAC,CACH;KACF,CAAC,CACH;CACF,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;IAC3B,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC"}

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;AAEH,wBAAsB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAOpD;AAED;;GAEG;AAEH,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;AAEH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC,CAuBjB;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,CA8G5B;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;AAGD;;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,CAuBP"}