offcourse 0.0.2 → 1.0.1

package/dist/shared/url.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Generic URL utilities for parsing and manipulation.
+ */
+/**
+ * Extracts the query string from a URL (including the leading ?).
+ * Returns empty string if no query params exist.
+ *
+ * @example
+ * extractQueryParams("https://example.com/path?foo=bar&baz=1")
+ * // => "?foo=bar&baz=1"
+ */
+export declare function extractQueryParams(url: string): string;
+/**
+ * Gets the base URL (everything up to and including the last slash).
+ * Useful for resolving relative URLs.
+ *
+ * @example
+ * getBaseUrl("https://example.com/videos/playlist.m3u8")
+ * // => "https://example.com/videos/"
+ */
+export declare function getBaseUrl(url: string): string;
+/**
+ * Resolves a potentially relative URI against a base URL.
+ * If the URI is already absolute (starts with http), returns it unchanged.
+ *
+ * @example
+ * resolveUrl("segment001.ts", "https://cdn.example.com/videos/")
+ * // => "https://cdn.example.com/videos/segment001.ts"
+ *
+ * resolveUrl("https://other.com/file.ts", "https://cdn.example.com/videos/")
+ * // => "https://other.com/file.ts"
+ */
+export declare function resolveUrl(uri: string, baseUrl: string): string;
+/**
+ * Resolves a URI and appends query params for authentication.
+ * Useful for signed URLs where auth tokens need to be preserved.
+ *
+ * @example
+ * resolveUrlWithParams("segment.ts", "https://cdn.com/", "?token=abc")
+ * // => "https://cdn.com/segment.ts?token=abc"
+ */
+export declare function resolveUrlWithParams(uri: string, baseUrl: string, queryParams: string): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/shared/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/shared/url.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAI9F"}

package/dist/shared/url.js

@@ -0,0 +1,54 @@
+/**
+ * Generic URL utilities for parsing and manipulation.
+ */
+/**
+ * Extracts the query string from a URL (including the leading ?).
+ * Returns empty string if no query params exist.
+ *
+ * @example
+ * extractQueryParams("https://example.com/path?foo=bar&baz=1")
+ * // => "?foo=bar&baz=1"
+ */
+export function extractQueryParams(url) {
+    const queryStart = url.indexOf("?");
+    return queryStart !== -1 ? url.substring(queryStart) : "";
+}
+/**
+ * Gets the base URL (everything up to and including the last slash).
+ * Useful for resolving relative URLs.
+ *
+ * @example
+ * getBaseUrl("https://example.com/videos/playlist.m3u8")
+ * // => "https://example.com/videos/"
+ */
+export function getBaseUrl(url) {
+    return url.substring(0, url.lastIndexOf("/") + 1);
+}
+/**
+ * Resolves a potentially relative URI against a base URL.
+ * If the URI is already absolute (starts with http), returns it unchanged.
+ *
+ * @example
+ * resolveUrl("segment001.ts", "https://cdn.example.com/videos/")
+ * // => "https://cdn.example.com/videos/segment001.ts"
+ *
+ * resolveUrl("https://other.com/file.ts", "https://cdn.example.com/videos/")
+ * // => "https://other.com/file.ts"
+ */
+export function resolveUrl(uri, baseUrl) {
+    return uri.startsWith("http") ? uri : baseUrl + uri;
+}
+/**
+ * Resolves a URI and appends query params for authentication.
+ * Useful for signed URLs where auth tokens need to be preserved.
+ *
+ * @example
+ * resolveUrlWithParams("segment.ts", "https://cdn.com/", "?token=abc")
+ * // => "https://cdn.com/segment.ts?token=abc"
+ */
+export function resolveUrlWithParams(uri, baseUrl, queryParams) {
+    const resolved = resolveUrl(uri, baseUrl);
+    // Don't add params if URL already has them
+    return resolved.includes("?") ? resolved : resolved + queryParams;
+}
+//# sourceMappingURL=url.js.map

package/dist/shared/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/shared/url.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,OAAO,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,OAAe;IACrD,OAAO,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC;AACtD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW,EAAE,OAAe,EAAE,WAAmB;IACpF,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC1C,2CAA2C;IAC3C,OAAO,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,GAAG,WAAW,CAAC;AACpE,CAAC"}

package/dist/state/database.d.ts

@@ -0,0 +1,246 @@
+/**
+ * Lesson sync status.
+ */
+export declare const LessonStatus: {
+    readonly PENDING: "pending";
+    readonly SCANNED: "scanned";
+    readonly VALIDATED: "validated";
+    readonly DOWNLOADED: "downloaded";
+    readonly ERROR: "error";
+    readonly SKIPPED: "skipped";
+};
+export type LessonStatusType = (typeof LessonStatus)[keyof typeof LessonStatus];
+/**
+ * Video types supported by the tool.
+ */
+export declare const VideoType: {
+    readonly LOOM: "loom";
+    readonly VIMEO: "vimeo";
+    readonly YOUTUBE: "youtube";
+    readonly WISTIA: "wistia";
+    readonly NATIVE: "native";
+    readonly UNKNOWN: "unknown";
+};
+export type VideoTypeValue = (typeof VideoType)[keyof typeof VideoType];
+/**
+ * Module record from database.
+ */
+export interface ModuleRecord {
+    id: number;
+    slug: string;
+    name: string;
+    position: number;
+    isLocked: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Lesson record from database.
+ */
+export interface LessonRecord {
+    id: number;
+    moduleId: number;
+    slug: string;
+    name: string;
+    url: string;
+    position: number;
+    isLocked: boolean;
+    status: LessonStatusType;
+    videoType: VideoTypeValue | null;
+    videoUrl: string | null;
+    hlsUrl: string | null;
+    errorMessage: string | null;
+    errorCode: string | null;
+    retryCount: number;
+    lastScannedAt: string | null;
+    lastDownloadedAt: string | null;
+    videoFileSize: number | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Lesson with module info for display.
+ */
+export interface LessonWithModule extends LessonRecord {
+    moduleName: string;
+    moduleSlug: string;
+    modulePosition: number;
+}
+/**
+ * Course metadata stored in the database.
+ */
+export interface CourseMetadata {
+    name: string;
+    url: string;
+    lastSyncAt: string | null;
+    totalModules: number;
+    totalLessons: number;
+}
+/**
+ * Get the database directory path.
+ */
+export declare function getDbDir(): string;
+/**
+ * Get the database file path for a course.
+ */
+export declare function getDbPath(communitySlug: string): string;
+/**
+ * Extract community slug from a Skool URL.
+ */
+export declare function extractCommunitySlug(url: string): string;
+/**
+ * Database manager for course state persistence.
+ * SQLite operations - not unit testable without mocking.
+ */
+export declare class CourseDatabase {
+    private db;
+    constructor(communitySlug: string);
+    /**
+     * Initialize database schema.
+     */
+    private initSchema;
+    /**
+     * Run database migrations for schema updates.
+     */
+    private runMigrations;
+    /**
+     * Close the database connection.
+     */
+    close(): void;
+    /**
+     * Set a metadata value.
+     */
+    setMetadata(key: string, value: string): void;
+    /**
+     * Get a metadata value.
+     */
+    getMetadata(key: string): string | null;
+    /**
+     * Get all course metadata.
+     */
+    getCourseMetadata(): CourseMetadata;
+    /**
+     * Update course metadata after sync.
+     */
+    updateCourseMetadata(name: string, url: string): void;
+    /**
+     * Upsert a module (insert or update).
+     */
+    upsertModule(slug: string, name: string, position: number, isLocked?: boolean): ModuleRecord;
+    /**
+     * Get all modules.
+     */
+    getModules(): ModuleRecord[];
+    /**
+     * Get module count.
+     */
+    getModuleCount(): number;
+    /**
+     * Get module by slug.
+     */
+    getModuleBySlug(slug: string): ModuleRecord | null;
+    private mapModuleRow;
+    /**
+     * Upsert a lesson (insert or update).
+     */
+    upsertLesson(moduleId: number, slug: string, name: string, url: string, position: number, isLocked?: boolean): LessonRecord;
+    /**
+     * Update lesson scan results.
+     */
+    updateLessonScan(lessonId: number, videoType: VideoTypeValue | null, videoUrl: string | null, hlsUrl: string | null, status: LessonStatusType, errorMessage?: string, errorCode?: string): void;
+    /**
+     * Mark lesson as downloaded.
+     */
+    markLessonDownloaded(lessonId: number, fileSize?: number): void;
+    /**
+     * Mark lesson as error.
+     */
+    markLessonError(lessonId: number, errorMessage: string, errorCode?: string): void;
+    /**
+     * Mark lesson as skipped (no video).
+     */
+    markLessonSkipped(lessonId: number, reason?: string): void;
+    /**
+     * Update lesson video type.
+     */
+    updateLessonVideoType(lessonId: number, videoType: string): void;
+    /**
+     * Increment retry count for a lesson.
+     */
+    incrementRetryCount(lessonId: number): number;
+    /**
+     * Reset retry count for a lesson.
+     */
+    resetRetryCount(lessonId: number): void;
+    /**
+     * Get lessons that failed but can still be retried (retry_count < maxRetries).
+     * Only returns retryable errors (not UNSUPPORTED_PROVIDER).
+     */
+    getLessonsToRetry(maxRetries?: number): LessonWithModule[];
+    /**
+     * Mark a lesson for retry by setting it back to pending/validated status.
+     */
+    queueForRetry(lessonId: number, targetStatus?: LessonStatusType): void;
+    /**
+     * Get all lessons.
+     */
+    getLessons(): LessonRecord[];
+    /**
+     * Get lessons with module info.
+     */
+    getLessonsWithModules(): LessonWithModule[];
+    /**
+     * Get lessons by status.
+     */
+    getLessonsByStatus(status: LessonStatusType): LessonWithModule[];
+    /**
+     * Get lessons that need scanning (pending or never scanned).
+     */
+    getLessonsToScan(): LessonWithModule[];
+    /**
+     * Get lessons that need validation (scanned but not validated, with video).
+     */
+    getLessonsToValidate(): LessonWithModule[];
+    /**
+     * Get lessons that are ready for download (validated with HLS URL).
+     */
+    getLessonsToDownload(): LessonWithModule[];
+    /**
+     * Get lesson count.
+     */
+    getLessonCount(): number;
+    /**
+     * Get lesson by URL.
+     */
+    getLessonByUrl(url: string): LessonRecord | null;
+    /**
+     * Get status summary.
+     */
+    getStatusSummary(): Record<LessonStatusType, number> & {
+        locked: number;
+    };
+    /**
+     * Reset all error lessons to pending for retry.
+     */
+    resetErrorLessons(): number;
+    /**
+     * Reset ALL lessons to pending (for --force full rescan).
+     * Preserves locked status.
+     */
+    resetAllLessonsToPending(): number;
+    /**
+     * Reset error lessons to validated (for --resume --retry-errors).
+     * Only resets lessons that already have an HLS URL.
+     */
+    resetErrorLessonsForResume(): number;
+    /**
+     * Get lessons by error code.
+     */
+    getLessonsByErrorCode(errorCode: string): LessonWithModule[];
+    /**
+     * Get count of lessons grouped by video type.
+     */
+    getVideoTypeSummary(): Record<string, number>;
+    private mapLessonRow;
+}
+//# sourceMappingURL=database.d.ts.map

package/dist/state/database.d.ts.map

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