offcourse 1.0.0 → 1.0.1

package/dist/storage/fileSystem.js

@@ -7,6 +7,44 @@ import { courseSyncStateSchema } from "../config/schema.js";
 import { createFolderName } from "../scraper/navigator.js";
 import { ensureDir, outputFile, pathExists, readJson, outputJson } from "../shared/fs.js";
 import { http } from "../shared/http.js";
+// ============================================
+// Pure functions - testable without mocking
+// ============================================
+/**
+ * Gets the base filename for a lesson (without extension).
+ * Format: "01-lesson-name"
+ */
+export function getLessonBasename(lessonIndex, lessonName) {
+    return createFolderName(lessonIndex, lessonName);
+}
+/**
+ * Gets the video file path for a lesson.
+ * Videos are stored directly in the module directory with lesson name.
+ */
+export function getVideoPath(moduleDir, lessonIndex, lessonName) {
+    return join(moduleDir, `${getLessonBasename(lessonIndex, lessonName)}.mp4`);
+}
+/**
+ * Gets the markdown file path for a lesson.
+ * Markdown files are stored directly in the module directory with lesson name.
+ */
+export function getMarkdownPath(moduleDir, lessonIndex, lessonName) {
+    return join(moduleDir, `${getLessonBasename(lessonIndex, lessonName)}.md`);
+}
+/**
+ * Gets the path for a downloadable file.
+ * Files are stored in the module directory with lesson prefix.
+ */
+export function getDownloadFilePath(moduleDir, lessonIndex, lessonName, filename) {
+    const lessonPrefix = getLessonBasename(lessonIndex, lessonName);
+    // Sanitize filename
+    const safeFilename = filename.replace(/[<>:"/\\|?*]/g, "_");
+    return join(moduleDir, `${lessonPrefix}-${safeFilename}`);
+}
+// ============================================
+// I/O functions - require filesystem access
+// ============================================
+/* v8 ignore start */
 /**
  * Creates the output directory structure for a course.
  */
@@ -24,13 +62,6 @@ export async function createModuleDirectory(courseDir, moduleIndex, moduleName)
     await ensureDir(moduleDir);
     return moduleDir;
 }
-/**
- * Gets the base filename for a lesson (without extension).
- * Format: "01-lesson-name"
- */
-export function getLessonBasename(lessonIndex, lessonName) {
-    return createFolderName(lessonIndex, lessonName);
-}
 /**
  * Saves markdown content to a file.
  */
@@ -39,20 +70,6 @@ export async function saveMarkdown(directory, filename, content) {
     await outputFile(filePath, content);
     return filePath;
 }
-/**
- * Gets the video file path for a lesson.
- * Videos are stored directly in the module directory with lesson name.
- */
-export function getVideoPath(moduleDir, lessonIndex, lessonName) {
-    return join(moduleDir, `${getLessonBasename(lessonIndex, lessonName)}.mp4`);
-}
-/**
- * Gets the markdown file path for a lesson.
- * Markdown files are stored directly in the module directory with lesson name.
- */
-export function getMarkdownPath(moduleDir, lessonIndex, lessonName) {
-    return join(moduleDir, `${getLessonBasename(lessonIndex, lessonName)}.md`);
-}
 /**
  * Loads the sync state for a course.
  */
@@ -86,16 +103,6 @@ export async function isLessonSynced(moduleDir, lessonIndex, lessonName) {
     ]);
     return { video, content };
 }
-/**
- * Gets the path for a downloadable file.
- * Files are stored in the module directory with lesson prefix.
- */
-export function getDownloadFilePath(moduleDir, lessonIndex, lessonName, filename) {
-    const lessonPrefix = getLessonBasename(lessonIndex, lessonName);
-    // Sanitize filename
-    const safeFilename = filename.replace(/[<>:"/\\|?*]/g, "_");
-    return join(moduleDir, `${lessonPrefix}-${safeFilename}`);
-}
 /**
  * Downloads a file from a URL to the specified path.
  */
@@ -118,4 +125,5 @@ export async function downloadFile(url, outputPath) {
         return { success: false, error: String(error) };
     }
 }
+/* v8 ignore stop */
 //# sourceMappingURL=fileSystem.js.map

package/dist/storage/fileSystem.js.map

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

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "offcourse",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Download online courses for offline access – of course!",
   "type": "module",
   "bin": {
     "offcourse": "./dist/cli/index.js"
   },
+  "files": [
+    "dist"
+  ],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/sebastian-software/offcourse.git"
@@ -15,7 +18,7 @@
   },
   "homepage": "https://offcourse.app",
   "scripts": {
-    "build": "tsc",
+    "build": "tsc -p tsconfig.build.json",
     "dev": "tsc --watch",
     "start": "node dist/cli/index.js",
     "lint": "eslint src",

package/.github/workflows/ci.yml

@@ -1,50 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  test:
-    runs-on: ${{ matrix.os }}
-
-    strategy:
-      matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
-        node-version: [22, 24]
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-          cache: "npm"
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Type check
-        run: npm run typecheck
-
-      - name: Lint
-        run: npm run lint
-
-      - name: Run tests with coverage
-        run: npm run test:coverage
-
-      - name: Upload coverage to Codecov
-        if: matrix.os == 'ubuntu-latest' && matrix.node-version == 22
-        uses: codecov/codecov-action@v5
-        with:
-          token: ${{ secrets.CODECOV_TOKEN }}
-          files: ./coverage/lcov.info
-          fail_ci_if_error: false
-          verbose: true
-
-
-

package/.husky/commit-msg

@@ -1,2 +0,0 @@
-npx --no -- commitlint --edit $1
-

package/.husky/pre-commit

@@ -1 +0,0 @@
-npx lint-staged

package/.husky/pre-push

@@ -1,3 +0,0 @@
-npm run lint
-npm run typecheck
-

package/.prettierrc

@@ -1,8 +0,0 @@
-{
-  "semi": true,
-  "singleQuote": false,
-  "tabWidth": 2,
-  "trailingComma": "es5",
-  "printWidth": 100
-}
-

package/.release-it.json

@@ -1,23 +0,0 @@
-{
-  "git": {
-    "commitMessage": "chore: release v${version}",
-    "tagName": "v${version}",
-    "requireBranch": "main"
-  },
-  "github": {
-    "release": true,
-    "releaseName": "v${version}"
-  },
-  "npm": {
-    "publish": true
-  },
-  "plugins": {
-    "@release-it/conventional-changelog": {
-      "preset": "conventionalcommits",
-      "infile": "CHANGELOG.md"
-    }
-  },
-  "hooks": {
-    "before:init": ["npm run lint", "npm run typecheck", "npm test run"]
-  }
-}

package/ARCHITECTURE.md

@@ -1,233 +0,0 @@
-# Architecture
-
-## Overview
-
-Offcourse is a modular CLI tool for downloading online courses. The architecture is designed to support multiple learning platforms through a plugin-like pattern.
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                         CLI Layer                           │
-│  (commands: login, sync, sync-skool, sync-highlevel, etc.) │
-└─────────────────────────────────────────────────────────────┘
-                              │
-          ┌───────────────────┼───────────────────┐
-          ▼                   ▼                   ▼
-┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐
-│     Scraper     │  │   Downloader    │  │     Storage     │
-│  (per platform) │  │ (per video host)│  │   (file system) │
-└─────────────────┘  └─────────────────┘  └─────────────────┘
-          │                   │                   │
-          └───────────────────┼───────────────────┘
-                              ▼
-                    ┌─────────────────┐
-                    │     Config      │
-                    │  (Zod schemas)  │
-                    └─────────────────┘
-```
-
-## Directory Structure
-
-```
-src/
-├── cli/                    # Command-line interface
-│   ├── index.ts            # Entry point, command registration
-│   └── commands/
-│       ├── config.ts       # Configuration management
-│       ├── inspect.ts      # Page analysis for debugging
-│       ├── login.ts        # Authentication flow
-│       ├── sync.ts         # Skool download orchestration
-│       └── syncHighLevel.ts # HighLevel download orchestration
-│
-├── config/                 # Configuration management
-│   ├── schema.ts           # Zod schemas for all config types
-│   ├── configManager.ts    # Load/save configuration
-│   └── paths.ts            # Path resolution utilities
-│
-├── scraper/                # Platform-specific extraction
-│   ├── auth.ts             # Session management (Playwright) - Skool
-│   ├── navigator.ts        # Course structure discovery - Skool
-│   ├── extractor.ts        # Content extraction - Skool
-│   ├── videoInterceptor.ts # Network interception for video URLs
-│   └── highlevel/          # HighLevel (GoHighLevel) scraper
-│       ├── auth.ts         # Firebase auth, session management
-│       ├── navigator.ts    # Course structure via API
-│       ├── extractor.ts    # Video/content extraction
-│       └── index.ts        # Exports
-│
-├── downloader/             # Video download handlers
-│   ├── index.ts            # Download dispatcher by video type
-│   ├── queue.ts            # Async queue with concurrency control
-│   ├── loomDownloader.ts   # Loom-specific HLS download
-│   ├── vimeoDownloader.ts  # Vimeo-specific download
-│   └── hlsDownloader.ts    # Generic HLS download (ffmpeg-based)
-│
-├── state/                  # State management
-│   ├── index.ts            # State exports
-│   └── database.ts         # SQLite database for sync state
-│
-└── storage/                # File system operations
-    └── fileSystem.ts       # Directory creation, file saving
-```
-
-## Key Components
-
-### CLI Layer (`src/cli/`)
-
-Handles user interaction via Commander.js. Each command is a separate module.
-
-- **login**: Opens browser for interactive authentication, saves session
-- **sync**: Auto-detects platform and delegates to appropriate handler
-- **sync-skool**: Skool-specific sync (uses `sync.ts`)
-- **sync-highlevel**: HighLevel-specific sync (uses `syncHighLevel.ts`)
-- **inspect**: Debug tool for analyzing page structure
-- **config**: Read/write configuration values
-
-### Scraper (`src/scraper/`)
-
-Platform-specific logic for extracting course content.
-
-#### Skool Scraper (root level)
-
-- **auth.ts**: Manages Playwright browser sessions, session persistence
-- **navigator.ts**: Discovers course structure (modules, lessons, URLs)
-- **extractor.ts**: Extracts video URLs and text content from lesson pages
-- **videoInterceptor.ts**: Intercepts network requests to capture video URLs
-
-#### HighLevel Scraper (`src/scraper/highlevel/`)
-
-- **auth.ts**: Firebase authentication, session management with token refresh
-- **navigator.ts**: Extracts course structure via API interception
-- **extractor.ts**: Extracts HLS video URLs, embedded videos (Vimeo, Loom), and content
-
-To add a new platform, create a new directory under `src/scraper/` with the same interfaces.
-
-### Downloader (`src/downloader/`)
-
-Video download handlers. Each video host needs its own implementation.
-
-- **queue.ts**: Generic async queue with concurrency control and retry logic
-- **loomDownloader.ts**: Handles Loom's HLS streaming format
-- **vimeoDownloader.ts**: Handles Vimeo video downloads
-- **hlsDownloader.ts**: Generic HLS download using ffmpeg (used for HighLevel native videos)
-- **index.ts**: Dispatcher that routes downloads by video type
-
-### State (`src/state/`)
-
-Persistent state management using SQLite.
-
-- **database.ts**: Manages sync state, tracks downloaded content
-- Enables resume functionality for interrupted syncs
-
-### Storage (`src/storage/`)
-
-File system abstraction for saving content.
-
-- Creates directory structure mirroring course hierarchy
-- Saves markdown content and video files
-- Tracks sync state to enable resume
-
-### Config (`src/config/`)
-
-Centralized configuration with Zod validation.
-
-- **schema.ts**: Type-safe schemas for all configuration
-- **configManager.ts**: Persists config to `~/.offcourse/`
-- **paths.ts**: Path resolution utilities
-
-## Data Flow
-
-```
-1. User runs: offcourse sync <url>
-                    │
-2. Auto-detect      │
-   platform ────────────► Skool? HighLevel? Unknown?
-                    │
-3. Load config      │
-                    ▼
-4. Authenticate ─────────► Browser session (cached or interactive)
-                    │
-5. Navigate ────────────► Extract course structure (modules, lessons)
-                    │
-6. For each lesson: │
-   ├─► Extract ─────────► Get video URL + text content
-   ├─► Save content ────► Write Markdown to disk
-   └─► Queue video ─────► Add to download queue
-                    │
-7. Process queue ───────► Download videos with concurrency control
-                    │
-8. Done ────────────────► Summary output
-```
-
-## Platform-Specific Details
-
-### Skool
-
-- **Auth**: Standard session-based, browser login
-- **Structure**: DOM-based extraction via Playwright selectors
-- **Videos**: Loom, Vimeo, native video elements
-
-### HighLevel (GoHighLevel)
-
-- **Auth**: Firebase authentication via `sso.clientclub.net`
-- **Structure**: API-based extraction (`services.leadconnectorhq.com`)
-- **Videos**: Native HLS streams, Vimeo, Loom embeds
-- **Special**: Requires ffmpeg for native video downloads
-
-## Adding a New Platform
-
-1. **Create scraper directory**: `src/scraper/<platform>/`
-2. **Implement modules**:
-   - `auth.ts` - Authentication flow
-   - `navigator.ts` - Course structure extraction
-   - `extractor.ts` - Content/video extraction
-   - `index.ts` - Exports
-3. **Create CLI command**: `src/cli/commands/sync<Platform>.ts`
-4. **Register in CLI**: Add to `src/cli/index.ts`
-5. **Add auto-detection**: Update `sync` command's platform detection
-
-## Adding a New Video Host
-
-1. **Create downloader**: Implement in `src/downloader/<host>Downloader.ts`
-2. **Export from index**: Add to `src/downloader/index.ts` dispatcher
-3. **Update extractor**: Add detection in platform-specific `extractVideoUrl()`
-
-## Technology Choices
-
-| Purpose | Technology | Rationale |
-|---------|------------|-----------|
-| Browser automation | Playwright | Reliable, handles SPAs, session persistence |
-| CLI framework | Commander.js | Standard, declarative command definition |
-| Validation | Zod | Runtime validation with TypeScript inference |
-| HTML → Markdown | Turndown | Mature, configurable |
-| Styling | Chalk + Ora | Clean terminal output with spinners |
-| Database | better-sqlite3 | Fast, embedded SQLite for state management |
-| HLS downloads | ffmpeg | Industry standard for HLS stream processing |
-
-## Development Tooling
-
-| Tool | Purpose | Configuration |
-|------|---------|---------------|
-| TypeScript | Type safety | `tsconfig.json` |
-| ESLint | Linting | `eslint.config.js` |
-| Prettier | Code formatting | `.prettierrc` (defaults) |
-| Vitest | Testing | `vitest.config.ts` |
-| Husky | Git hooks | `.husky/` |
-| lint-staged | Pre-commit formatting | `package.json` |
-| commitlint | Commit message validation | `commitlint.config.js` |
-| release-it | Release management | `.release-it.json` |
-
-### Git Hooks
-
-- **pre-commit**: Formats staged files with Prettier via lint-staged
-- **pre-push**: Runs ESLint and TypeScript type checking
-- **commit-msg**: Validates conventional commit format
-
-### Release Process
-
-Releases use [release-it](https://github.com/release-it/release-it) with the conventional changelog plugin:
-
-1. Validates code (lint, typecheck, test)
-2. Determines version bump from commit history
-3. Updates `CHANGELOG.md` with categorized changes
-4. Creates Git tag and GitHub release
-5. Publishes to npm

package/CHANGELOG.md

@@ -1,78 +0,0 @@
-# Changelog
-
-## 1.0.0 (2025-12-22)
-
-### ⚠ BREAKING CHANGES
-
-* The 'enrich' command for transcribing videos is no longer available
-
-### Features
-
-* add --resume flag and fix HLS URL handling in downloaders ([163055b](https://github.com/sebastian-software/offcourse/commit/163055b343345aa60bf3babd1b4bb33443d61616))
-* add detailed error reporting and retry logic for Loom downloads ([177e92d](https://github.com/sebastian-software/offcourse/commit/177e92d5b5a30d959b6582327fb16d6337916ea1))
-* add fast mode to skip images, fonts, CSS during scraping ([bc7a128](https://github.com/sebastian-software/offcourse/commit/bc7a12836470b914bd1b515ab04fda5a5c6e705b))
-* add HighLevel (GoHighLevel) course scraper support ([04c15f8](https://github.com/sebastian-software/offcourse/commit/04c15f832381d3fbfde82e3f0847bf32f7e590c2))
-* add network interception fallback for video URL capture ([fc36f6d](https://github.com/sebastian-software/offcourse/commit/fc36f6d03e5d17f681114fea791454453c5e819f))
-* add OpenRouter integration for transcript polishing ([22487f2](https://github.com/sebastian-software/offcourse/commit/22487f2300bc1b9ac1b5be98db695094cca4bf54))
-* add tsx for dev, detect locked lessons ([809c9fd](https://github.com/sebastian-software/offcourse/commit/809c9fdd6ae9a06e2fa038d020bdff18f275505c))
-* add video transcription with Whisper ([06f9edd](https://github.com/sebastian-software/offcourse/commit/06f9eddf56c4181e4d7530c7a39ca23c25d1a0f0))
-* add video type prefix [LOOM], [VIMEO] etc. to output ([bba70e7](https://github.com/sebastian-software/offcourse/commit/bba70e7581c39b9fd3e9934496cd2b50106418c6))
-* add Vimeo video download support ([64ecde7](https://github.com/sebastian-software/offcourse/commit/64ecde76081749ff232732493ede602e7013be44))
-* add Zod schemas for API response validation ([1fec40f](https://github.com/sebastian-software/offcourse/commit/1fec40f49a0bd6900b46eeab5d95cbf6381e01ca))
-* beautiful multi-progress bars for parallel downloads ([cfe6e01](https://github.com/sebastian-software/offcourse/commit/cfe6e012eb70d283475e8963e0be08bbf24d7501))
-* **cli:** add Commander-based CLI with sync, login, inspect commands ([53b53e1](https://github.com/sebastian-software/offcourse/commit/53b53e10de11d3ceefabe16f17a3b1a50cec73c4))
-* **config:** add configuration system with Zod validation ([552e5c8](https://github.com/sebastian-software/offcourse/commit/552e5c8d3bebb60d443275b8bcf8e0bec44d38df))
-* detect and track locked lessons separately ([8a62c9a](https://github.com/sebastian-software/offcourse/commit/8a62c9aa860e375dee8853aeecaa244668e88fd4))
-* download linked PDF and Office files from lessons ([6e838be](https://github.com/sebastian-software/offcourse/commit/6e838beabc1f4e75505cffa2712f567c39be4941))
-* **downloader:** add HLS streaming support for Loom videos ([2dfcae1](https://github.com/sebastian-software/offcourse/commit/2dfcae1a746075bc68882efc26c49b21aeaf7796))
-* **downloader:** add native video downloader with queue system ([8c6e236](https://github.com/sebastian-software/offcourse/commit/8c6e23620682c72fd403eb4360931ce91c4fb5ec))
-* extract Vimeo URLs from running player in iframe ([ba68bbe](https://github.com/sebastian-software/offcourse/commit/ba68bbe2db305531bfcda0b8a10d4d845715603b))
-* format transcripts with paragraphs ([cd16eb8](https://github.com/sebastian-software/offcourse/commit/cd16eb8d3f0205802927a0623ad124a7407dff9b))
-* improve download progress display and file size reporting ([c5a548c](https://github.com/sebastian-software/offcourse/commit/c5a548c0c601c7c493a616eb44a982aee70ba56a))
-* improve locked lesson detection using hasAccess from JSON ([6b2e3e8](https://github.com/sebastian-software/offcourse/commit/6b2e3e80fe8a425e032dff8179389bb0963e920f))
-* improved logging for unsupported video providers ([f808169](https://github.com/sebastian-software/offcourse/commit/f808169ef88bda9006cf12955f3e0b154fdc9ae6))
-* parallel downloads for faster video syncing ([95d12f2](https://github.com/sebastian-software/offcourse/commit/95d12f2071281544523bd069980c1449c47acf7e))
-* progress bar for Phase 1 (course structure scanning) ([2017425](https://github.com/sebastian-software/offcourse/commit/201742583b4842ebe6f1d01a39c4280988e15ba2))
-* progress bars for validation and content extraction phases ([324be59](https://github.com/sebastian-software/offcourse/commit/324be597ed04e1d04f70e4c58139b2dc65648129))
-* remove AI transcription and enrich feature ([7ba6327](https://github.com/sebastian-software/offcourse/commit/7ba632753a5e08d67a653ff24452d83bd3406eb7))
-* **scraper:** add Playwright-based Skool scraper ([b9b111f](https://github.com/sebastian-software/offcourse/commit/b9b111f6e22ad03c78fe14d040caeee0d510a901))
-* separate summary.md and transcript.md, add module summaries ([fc49a60](https://github.com/sebastian-software/offcourse/commit/fc49a6097cf612ac3a63f6c060060febd0f6b8ed))
-* SQLite state management, improved video detection, graceful shutdown ([fc001d7](https://github.com/sebastian-software/offcourse/commit/fc001d7a82705b59ed4973d66d7ca8a0406c7dd4))
-* **storage:** add filesystem utilities for course output ([ef18545](https://github.com/sebastian-software/offcourse/commit/ef185453a9afc6d0ff373e8dd58ce812514d6b46))
-* support domain-restricted Vimeo videos via browser context ([2b16e0c](https://github.com/sebastian-software/offcourse/commit/2b16e0c21f483ecbac3b22a9e09b5f8835367d79))
-* use CDP network interception to capture video URLs from iframes ([b49a873](https://github.com/sebastian-software/offcourse/commit/b49a873a6a1f4db7285e673f80de85683f548332))
-* use readable titles in summary and transcript files ([ad1377d](https://github.com/sebastian-software/offcourse/commit/ad1377d83bb07611adca439546969fb9c7fdc5b7))
-
-### Bug Fixes
-
-* --force flag now also resets error lessons for retry ([d20e7fb](https://github.com/sebastian-software/offcourse/commit/d20e7fb95ed98d7cd9d70d798baa888ce1cd60f5))
-* --resume --retry-errors now works correctly ([bbe732d](https://github.com/sebastian-software/offcourse/commit/bbe732d36e43a421ff3faa9e81f2ccfc35841fd3))
-* add autoplay=1 to embed URLs to trigger HLS fetch ([1ffa068](https://github.com/sebastian-software/offcourse/commit/1ffa068ece40553118d573b0b55ff14fecfb41f2))
-* add conventional-changelog-conventionalcommits peer dependency ([84f4502](https://github.com/sebastian-software/offcourse/commit/84f45029e5a81e76ab16a5f38beae16197701664))
-* add missing await to saveMarkdown call ([da6e1e7](https://github.com/sebastian-software/offcourse/commit/da6e1e7dc50de9441c7ff7fc2bb5f95ddbdbb3a9))
-* capture Loom/Vimeo HLS by navigating to embed page ([6608bd9](https://github.com/sebastian-software/offcourse/commit/6608bd9f9eee6107912af259340fb68ce86701e0))
-* clean download progress display - remove completed bars ([8334894](https://github.com/sebastian-software/offcourse/commit/83348940a44859dc3cd915c8415d473829f3d2d0))
-* extract full iframe URLs with auth params for Vimeo ([e8fcec3](https://github.com/sebastian-software/offcourse/commit/e8fcec308c3208ba2fd1a47b012926d77d199acf))
-* formatting ([4491c00](https://github.com/sebastian-software/offcourse/commit/4491c00ed610997b55314ed4d456e42325de5f3f))
-* handle direct HLS URLs in Loom downloader ([974b7d6](https://github.com/sebastian-software/offcourse/commit/974b7d6e7024f2f711abd3be815f3fee64bd4b10))
-* **highlevel:** correctly parse product API response for course name ([697ab07](https://github.com/sebastian-software/offcourse/commit/697ab07575e61e6cd85481743c79a2f1ca74cbfb))
-* **highlevel:** fix video detection and default to headless mode ([e4dcf51](https://github.com/sebastian-software/offcourse/commit/e4dcf513b0b81ddfdfec9539ae4fa8ea1f0bb0ed))
-* migrate to Zod 4 API for url and datetime validation ([7519b2c](https://github.com/sebastian-software/offcourse/commit/7519b2c3f5155a938d2ec55e8a5c7e70c371659b))
-* mute videos during extraction to avoid audio output ([9150dc0](https://github.com/sebastian-software/offcourse/commit/9150dc09cac1e7c70eb9a9dd257a9e4f6fd924b9))
-* mute videos during extraction to avoid audio output ([ee43c1c](https://github.com/sebastian-software/offcourse/commit/ee43c1c18c138aa014bdd913db871593adcd0dda))
-* **navigator:** correctly handle module URLs vs classroom URLs ([a0e8763](https://github.com/sebastian-software/offcourse/commit/a0e8763c982a65ba7a38d59c9571dbeee577ac3f))
-* prefix unused parameter with underscore in queue test ([076f9c4](https://github.com/sebastian-software/offcourse/commit/076f9c4f1906358075d4061c81b31aa1b579b8da))
-* resolve lint errors in syncHighLevel.ts ([4af50d5](https://github.com/sebastian-software/offcourse/commit/4af50d5615ab260de7778e2248cf3fb0bedda851))
-* simplify release-it preset config for v10 compatibility ([9f9748f](https://github.com/sebastian-software/offcourse/commit/9f9748f829f1a92b9c397d5ff4ab690ac044f8f7))
-* use Playwright request API for Vimeo (avoids CORS) ([09a2386](https://github.com/sebastian-software/offcourse/commit/09a23867115bded76521e27e0afbda76970b50d2))
-* use response listener instead of route interception ([cb63eee](https://github.com/sebastian-software/offcourse/commit/cb63eeeeb2d2e13f3d0cba22ed702b35c1b88525))
-* use URL slug for output directory name ([804e4fb](https://github.com/sebastian-software/offcourse/commit/804e4fb9d99615feccf6973b1fc603f02336146a))
-* version ([d17bbc7](https://github.com/sebastian-software/offcourse/commit/d17bbc7497e660634262af2d8047f96781ff4ac2))
-
-### Performance Improvements
-
-* reduce wait times and improve content extraction ([e306be2](https://github.com/sebastian-software/offcourse/commit/e306be27d8d021a273801c0f5739639cab3599f7))
-
-All notable changes to this project will be documented in this file.
-
-This changelog is automatically generated based on [Conventional Commits](https://www.conventionalcommits.org/).

package/commitlint.config.js

@@ -1,4 +0,0 @@
-export default {
-  extends: ["@commitlint/config-conventional"],
-};
-

package/dist/ai/openRouter.d.ts

@@ -1,47 +0,0 @@
-export interface OpenRouterOptions {
-    model?: string;
-    maxTokens?: number;
-    temperature?: number;
-}
-export interface ChatMessage {
-    role: "system" | "user" | "assistant";
-    content: string;
-}
-export interface UsageInfo {
-    promptTokens: number;
-    completionTokens: number;
-    totalTokens: number;
-    cost: number | undefined;
-}
-export interface ChatResult {
-    content: string;
-    usage: UsageInfo;
-    model: string;
-}
-/**
- * Get cumulative usage stats for the current session.
- */
-export declare function getCumulativeUsage(): UsageInfo;
-/**
- * Reset cumulative usage stats.
- */
-export declare function resetCumulativeUsage(): void;
-/**
- * Check if OpenRouter is configured.
- */
-export declare function isConfigured(): boolean;
-/**
- * Send a chat completion request to OpenRouter.
- * Returns full result with usage info.
- */
-export declare function chatWithUsage(messages: ChatMessage[], options?: OpenRouterOptions): Promise<ChatResult>;
-/**
- * Send a chat completion request to OpenRouter.
- * Simple version that just returns the content string.
- */
-export declare function chat(messages: ChatMessage[], options?: OpenRouterOptions): Promise<string>;
-/**
- * Simple prompt helper.
- */
-export declare function prompt(userPrompt: string, systemPrompt?: string, options?: OpenRouterOptions): Promise<string>;
-//# sourceMappingURL=openRouter.d.ts.map

package/dist/ai/openRouter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"openRouter.d.ts","sourceRoot":"","sources":["../../src/ai/openRouter.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAUD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,SAAS,CAE9C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAO3C;AAsBD;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAcD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,UAAU,CAAC,CA+CrB;AAED;;;GAGG;AACH,wBAAsB,IAAI,CACxB,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;GAEG;AACH,wBAAsB,MAAM,CAC1B,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAUjB"}