offcourse 0.0.2 → 1.0.0

package/README.md

@@ -1,33 +1,142 @@
 # Offcourse
 
-[![npm version](https://img.shields.io/npm/v/offcourse?color=cb0000&label=npm)](https://www.npmjs.com/package/offcourse)
-[![npm downloads](https://img.shields.io/npm/dm/offcourse?color=cb0000)](https://www.npmjs.com/package/offcourse)
-[![license](https://img.shields.io/npm/l/offcourse?color=cb0000)](https://github.com/sebastian-software/offcourse/blob/main/LICENSE)
-[![node](https://img.shields.io/node/v/offcourse?color=cb0000)](https://nodejs.org)
+[![npm version](https://img.shields.io/npm/v/offcourse?color=3b82f6&label=npm)](https://www.npmjs.com/package/offcourse)
+[![npm downloads](https://img.shields.io/npm/dm/offcourse?color=3b82f6)](https://www.npmjs.com/package/offcourse)
+[![license](https://img.shields.io/npm/l/offcourse?color=3b82f6)](https://github.com/sebastian-software/offcourse/blob/main/LICENSE)
+[![node](https://img.shields.io/badge/node-%3E%3D22-3b82f6)](https://nodejs.org)
+[![codecov](https://codecov.io/gh/sebastian-software/offcourse/graph/badge.svg)](https://codecov.io/gh/sebastian-software/offcourse)
+[![CI](https://github.com/sebastian-software/offcourse/actions/workflows/ci.yml/badge.svg)](https://github.com/sebastian-software/offcourse/actions/workflows/ci.yml)
 
 Download online courses for offline access – of course! 📚
 
-> 🚧 **Coming Soon** – This package is currently in private development.
+Saves video content and lesson text as Markdown files, organized by module structure.
 
-## What is Offcourse?
-
-Offcourse is a CLI tool that downloads online courses for offline access. It preserves the course structure, downloads videos, and converts lesson content to clean Markdown files.
-
-## Planned Features
+## Features
 
 - 🔐 **Browser-based authentication** – Log in once, sessions are cached
 - 📚 **Course structure preservation** – Maintains module/lesson hierarchy
-- 🎬 **Video downloads** – Supports Loom, native video (Vimeo, YouTube, Wistia planned)
+- 🎬 **Video downloads** – Supports HLS streams, Loom and Vimeo
 - 📝 **Content extraction** – Converts lesson text to clean Markdown
 - ⏸️ **Resumable syncs** – Skips already downloaded content
 - ⚡ **Concurrent downloads** – Configurable parallelism
+- 🔍 **Auto-detection** – Automatically detects platform from URL
 
 ## Supported Platforms
 
-| Platform | Status |
-|----------|--------|
-| [Skool.com](https://skool.com) | ✅ Ready |
-| [LearningSuite.io](https://learningsuite.io) | 🚧 Planned |
+| Platform | Status | Notes |
+|----------|--------|-------|
+| [Skool.com](https://skool.com) | ✅ Supported | Community courses |
+| [HighLevel (GoHighLevel)](https://gohighlevel.com) | ✅ Supported | Membership portals, ClientClub |
+| [LearningSuite.io](https://learningsuite.io) | 🚧 Planned | |
+
+## Installation
+
+```bash
+npm install -g offcourse
+```
+
+Or run directly with npx:
+
+```bash
+npx offcourse <command>
+```
+
+Requires Node.js 22+.
+
+For HLS video downloads (HighLevel native videos), [ffmpeg](https://ffmpeg.org/) must be installed:
+
+```bash
+# macOS
+brew install ffmpeg
+
+# Ubuntu/Debian
+sudo apt install ffmpeg
+
+# Windows (via Chocolatey)
+choco install ffmpeg
+```
+
+## Usage
+
+### Login
+
+```bash
+# Opens browser for interactive login
+offcourse login
+
+# Force re-login
+offcourse login --force
+```
+
+### Sync a Course
+
+The `sync` command auto-detects the platform from the URL:
+
+```bash
+# Auto-detect platform and download
+offcourse sync <url>
+
+# Skip video downloads
+offcourse sync <url> --skip-videos
+
+# Skip text content
+offcourse sync <url> --skip-content
+
+# Preview without downloading
+offcourse sync <url> --dry-run
+
+# Limit to first N lessons (for testing)
+offcourse sync <url> --limit 5
+
+# Override course name (useful when auto-detection fails)
+offcourse sync <url> --course-name "My Course Name"
+
+# Prefer specific video quality
+offcourse sync <url> --quality 720p
+```
+
+### Platform-Specific Commands
+
+```bash
+# Skool courses
+offcourse sync-skool https://www.skool.com/your-community/classroom
+
+# HighLevel/GoHighLevel membership portals
+offcourse sync-highlevel https://member.example.com/courses/products/<id>
+offcourse sync-highlevel <url> --course-name "Course Name"
+```
+
+### Configuration
+
+```bash
+# Show current config
+offcourse config show
+
+# Set output directory
+offcourse config set outputDir ~/Courses
+
+# Set video quality (highest, lowest, 1080p, 720p, 480p)
+offcourse config set videoQuality 720p
+
+# Set download concurrency (1-5)
+offcourse config set concurrency 3
+
+# Run headless (no browser window)
+offcourse config set headless true
+```
+
+### Inspect (Debugging)
+
+```bash
+# Analyze page structure
+offcourse inspect <url>
+
+# Save analysis to files
+offcourse inspect <url> --output ./analysis
+
+# Include full HTML dump
+offcourse inspect <url> --full
+```
 
 ## Output Structure
 
@@ -45,13 +154,139 @@ Offcourse is a CLI tool that downloads online courses for offline access. It pre
         └── ...
 ```
 
-## Stay Updated
+## Platform Notes
 
-⭐ Star the repo to get notified when we release:
+### HighLevel (GoHighLevel)
 
-→ [github.com/sebastian-software/offcourse](https://github.com/sebastian-software/offcourse)
+HighLevel is an all-in-one marketing platform with a "Memberships" feature for hosting courses. Offcourse supports:
 
-## License
+- **Authentication**: Firebase-based login via browser
+- **Course structure**: Extracts products, categories, and posts via API
+- **Video downloads**: Native HLS videos with quality selection (requires ffmpeg)
+- **Embedded videos**: Vimeo, Loom, and other embedded players
+
+Common HighLevel portal URLs:
+- `https://member.yourdomain.com/courses/...`
+- `https://portal.yourdomain.com/courses/...`
+- `https://courses.yourdomain.com/...`
+
+## Development
+
+### Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/sebastian-software/offcourse.git
+cd offcourse
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Link globally (optional)
+npm link
+```
+
+### Commands
+
+```bash
+# Watch mode
+npm run dev
+
+# Run directly (without build)
+npx tsx src/cli/index.ts <command>
+
+# Lint
+npm run lint
+
+# Format
+npm run format
+
+# Type check
+npm run typecheck
+
+# Test
+npm test
+```
+
+### Git Hooks
+
+This project uses [Husky](https://typicode.github.io/husky/) for Git hooks:
+
+- **pre-commit**: Runs Prettier on staged files via lint-staged
+- **pre-push**: Runs ESLint and TypeScript type checking
+- **commit-msg**: Validates commit messages follow [Conventional Commits](https://www.conventionalcommits.org/)
+
+### Commit Convention
+
+We follow [Conventional Commits](https://www.conventionalcommits.org/). Commit messages must follow this format:
 
-MIT © [Sebastian Software GmbH](https://sebastian-software.de)
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+**Types:**
+
+- `feat`: New feature
+- `fix`: Bug fix
+- `docs`: Documentation changes
+- `style`: Code style changes (formatting, semicolons, etc.)
+- `refactor`: Code refactoring
+- `perf`: Performance improvements
+- `test`: Adding or updating tests
+- `chore`: Maintenance tasks
+- `ci`: CI/CD changes
+
+**Examples:**
+
+```bash
+git commit -m "feat: add support for Vimeo downloads"
+git commit -m "fix: handle missing video URLs gracefully"
+git commit -m "docs: update installation instructions"
+```
+
+### Releasing
+
+Releases are managed with [release-it](https://github.com/release-it/release-it). The release process:
+
+1. Runs linting, type checking, and tests
+2. Bumps version based on conventional commits
+3. Generates/updates `CHANGELOG.md`
+4. Creates a Git tag and GitHub release
+5. Publishes to npm
+
+```bash
+# Interactive release (will prompt for version bump)
+npm run release
+
+# Dry run (preview what would happen)
+npm run release -- --dry-run
+
+# Specific version bump
+npm run release -- --minor
+npm run release -- --major
+```
+
+## Acknowledgments
+
+A huge thank you to [Sindre Sorhus](https://github.com/sindresorhus) 🙏 for creating and maintaining so many excellent packages that power this project:
+
+- [`@sindresorhus/slugify`](https://github.com/sindresorhus/slugify) – Slugify a string
+- [`conf`](https://github.com/sindresorhus/conf) – Simple config handling
+- [`delay`](https://github.com/sindresorhus/delay) – Delay a promise
+- [`execa`](https://github.com/sindresorhus/execa) – Process execution for humans
+- [`ky`](https://github.com/sindresorhus/ky) – Tiny & elegant HTTP client
+- [`p-queue`](https://github.com/sindresorhus/p-queue) – Promise queue with concurrency control
+- [`p-retry`](https://github.com/sindresorhus/p-retry) – Retry a promise-returning function
+
+His commitment to high-quality, well-documented, and beautifully designed open source software is truly inspiring. If you find his work useful, consider [sponsoring him](https://github.com/sponsors/sindresorhus).
+
+## License
 
+MIT

package/commitlint.config.js

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

package/dist/ai/openRouter.d.ts

@@ -0,0 +1,47 @@
+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

@@ -0,0 +1 @@
+{"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"}

package/dist/ai/openRouter.js

@@ -0,0 +1,116 @@
+import { config } from "dotenv";
+// Load .env file
+config();
+const OPENROUTER_API_URL = "https://openrouter.ai/api/v1/chat/completions";
+// Track cumulative usage across calls
+let cumulativeUsage = {
+    promptTokens: 0,
+    completionTokens: 0,
+    totalTokens: 0,
+    cost: undefined,
+};
+/**
+ * Get cumulative usage stats for the current session.
+ */
+export function getCumulativeUsage() {
+    return { ...cumulativeUsage };
+}
+/**
+ * Reset cumulative usage stats.
+ */
+export function resetCumulativeUsage() {
+    cumulativeUsage = {
+        promptTokens: 0,
+        completionTokens: 0,
+        totalTokens: 0,
+        cost: undefined,
+    };
+}
+/**
+ * Get the OpenRouter API key from environment.
+ */
+function getApiKey() {
+    const key = process.env.OPENROUTER_API_KEY;
+    if (!key) {
+        throw new Error("OPENROUTER_API_KEY not set. Add it to .env file or set as environment variable.");
+    }
+    return key;
+}
+/**
+ * Get the default model from environment or use fallback.
+ */
+function getDefaultModel() {
+    return process.env.OPENROUTER_MODEL ?? "anthropic/claude-3.5-sonnet";
+}
+/**
+ * Check if OpenRouter is configured.
+ */
+export function isConfigured() {
+    return !!process.env.OPENROUTER_API_KEY;
+}
+/**
+ * Send a chat completion request to OpenRouter.
+ * Returns full result with usage info.
+ */
+export async function chatWithUsage(messages, options = {}) {
+    const apiKey = getApiKey();
+    const model = options.model ?? getDefaultModel();
+    const response = await fetch(OPENROUTER_API_URL, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+            "HTTP-Referer": "https://github.com/course-grab",
+            "X-Title": "course-grab",
+        },
+        body: JSON.stringify({
+            model,
+            messages,
+            max_tokens: options.maxTokens ?? 4096,
+            temperature: options.temperature ?? 0.3,
+        }),
+    });
+    if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`OpenRouter API error: ${response.status} - ${error}`);
+    }
+    const data = (await response.json());
+    const usage = {
+        promptTokens: data.usage?.prompt_tokens ?? 0,
+        completionTokens: data.usage?.completion_tokens ?? 0,
+        totalTokens: data.usage?.total_tokens ?? 0,
+        cost: data.total_cost,
+    };
+    // Accumulate usage
+    cumulativeUsage.promptTokens += usage.promptTokens;
+    cumulativeUsage.completionTokens += usage.completionTokens;
+    cumulativeUsage.totalTokens += usage.totalTokens;
+    if (usage.cost !== undefined) {
+        cumulativeUsage.cost = (cumulativeUsage.cost ?? 0) + usage.cost;
+    }
+    return {
+        content: data.choices[0]?.message?.content ?? "",
+        usage,
+        model: data.model ?? model,
+    };
+}
+/**
+ * Send a chat completion request to OpenRouter.
+ * Simple version that just returns the content string.
+ */
+export async function chat(messages, options = {}) {
+    const result = await chatWithUsage(messages, options);
+    return result.content;
+}
+/**
+ * Simple prompt helper.
+ */
+export async function prompt(userPrompt, systemPrompt, options) {
+    const messages = [];
+    if (systemPrompt) {
+        messages.push({ role: "system", content: systemPrompt });
+    }
+    messages.push({ role: "user", content: userPrompt });
+    return chat(messages, options);
+}
+//# sourceMappingURL=openRouter.js.map

package/dist/ai/openRouter.js.map

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

package/dist/ai/transcriptPolisher.d.ts

@@ -0,0 +1,24 @@
+export interface PolishedTranscript {
+    summary: string;
+    transcript: string;
+}
+/**
+ * Convert folder name to readable title.
+ * "01-1-herzlich-willkommen" → "Herzlich Willkommen"
+ * "02-onboarding-social-leads-academy" → "Onboarding Social Leads Academy"
+ */
+export declare function folderNameToTitle(folderName: string): string;
+/**
+ * Polish a transcript using an LLM.
+ * Returns separate summary and transcript.
+ */
+export declare function polishTranscript(rawTranscript: string): Promise<PolishedTranscript>;
+/**
+ * Generate a module summary from multiple lesson summaries.
+ */
+export declare function generateModuleSummary(moduleName: string, lessonSummaries: Array<{
+    name: string;
+    title: string;
+    summary: string;
+}>): Promise<string>;
+//# sourceMappingURL=transcriptPolisher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transcriptPolisher.d.ts","sourceRoot":"","sources":["../../src/ai/transcriptPolisher.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAW5D;AAkCD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA0BzF;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GACvE,OAAO,CAAC,MAAM,CAAC,CAkBjB"}

package/dist/ai/transcriptPolisher.js

@@ -0,0 +1,89 @@
+import { prompt, isConfigured } from "./openRouter.js";
+/**
+ * Convert folder name to readable title.
+ * "01-1-herzlich-willkommen" → "Herzlich Willkommen"
+ * "02-onboarding-social-leads-academy" → "Onboarding Social Leads Academy"
+ */
+export function folderNameToTitle(folderName) {
+    return folderName
+        // Remove leading numbers and separators (e.g., "01-1-", "02-")
+        .replace(/^[\d]+-[\d]*-?/, "")
+        // Replace remaining dashes with spaces
+        .replace(/-/g, " ")
+        // Capitalize each word
+        .split(" ")
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(" ")
+        .trim();
+}
+const SYSTEM_PROMPT = `Du bist ein Experte für die Aufbereitung von Video-Transkripten.
+
+Deine Aufgabe:
+1. Erstelle eine kurze TLDR-Zusammenfassung (2-3 Sätze)
+2. Strukturiere den Text in sinnvolle Absätze
+3. Füge Markdown-Formatierung hinzu:
+   - **Fettschrift** für wichtige Begriffe und Kernaussagen
+   - *Kursiv* für Betonungen
+   - Überschriften (## oder ###) für klare Themenwechsel
+   - Aufzählungen wo es Sinn macht
+
+Regeln:
+- Behalte den Originaltext bei, ändere keine Wörter
+- Korrigiere nur offensichtliche Transkriptionsfehler
+- Füge Absätze an natürlichen Sprechpausen ein
+- Halte alles auf Deutsch`;
+const USER_PROMPT_TEMPLATE = `Hier ist ein Video-Transkript das aufbereitet werden soll:
+
+---
+{transcript}
+---
+
+Antworte in folgendem Format:
+
+## TLDR
+[2-3 Sätze Zusammenfassung]
+
+## Transkript
+
+[Aufbereiteter Text mit Markdown-Formatierung]`;
+/**
+ * Polish a transcript using an LLM.
+ * Returns separate summary and transcript.
+ */
+export async function polishTranscript(rawTranscript) {
+    if (!isConfigured()) {
+        return {
+            summary: "",
+            transcript: rawTranscript,
+        };
+    }
+    const userPrompt = USER_PROMPT_TEMPLATE.replace("{transcript}", rawTranscript);
+    const result = await prompt(userPrompt, SYSTEM_PROMPT, {
+        maxTokens: 8192,
+        temperature: 0.2,
+    });
+    // Parse the response
+    const tldrMatch = result.match(/## TLDR\s*\n+([\s\S]*?)(?=\n## Transkript|$)/i);
+    const transcriptMatch = result.match(/## Transkript\s*\n+([\s\S]*?)$/i);
+    const summary = tldrMatch?.[1]?.trim() ?? "";
+    const transcript = transcriptMatch?.[1]?.trim() ?? result;
+    return {
+        summary,
+        transcript,
+    };
+}
+/**
+ * Generate a module summary from multiple lesson summaries.
+ */
+export async function generateModuleSummary(moduleName, lessonSummaries) {
+    if (!isConfigured() || lessonSummaries.length === 0) {
+        return "";
+    }
+    const moduleTitle = folderNameToTitle(moduleName);
+    const summariesText = lessonSummaries
+        .map((l, i) => `### ${i + 1}. ${l.title}\n${l.summary}`)
+        .join("\n\n");
+    const result = await prompt(`Hier sind die Zusammenfassungen aller Lektionen des Moduls "${moduleTitle}":\n\n${summariesText}\n\nErstelle eine übergreifende Zusammenfassung des gesamten Moduls (5-8 Sätze). Fasse die wichtigsten Lernziele und Kernkonzepte zusammen.`, "Du bist ein Experte für Kurszusammenfassungen. Antworte auf Deutsch in klarem, präzisem Stil.", { maxTokens: 512, temperature: 0.3 });
+    return `# Zusammenfassung: ${moduleTitle}\n\n${result.trim()}\n\n---\n\n## Lektionen\n\n${summariesText}`;
+}
+//# sourceMappingURL=transcriptPolisher.js.map

package/dist/ai/transcriptPolisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcriptPolisher.js","sourceRoot":"","sources":["../../src/ai/transcriptPolisher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAOvD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,OAAO,UAAU;QACf,+DAA+D;SAC9D,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;QAC9B,uCAAuC;SACtC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;QACnB,uBAAuB;SACtB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC3D,IAAI,CAAC,GAAG,CAAC;SACT,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;0BAeI,CAAC;AAE3B,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;+CAakB,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,aAAqB;IAC1D,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;QACpB,OAAO;YACL,OAAO,EAAE,EAAE;YACX,UAAU,EAAE,aAAa;SAC1B,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;IAE/E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,aAAa,EAAE;QACrD,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,GAAG;KACjB,CAAC,CAAC;IAEH,qBAAqB;IACrB,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAChF,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAExE,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC7C,MAAM,UAAU,GAAG,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC;IAE1D,OAAO;QACL,OAAO;QACP,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,UAAkB,EAClB,eAAwE;IAExE,IAAI,CAAC,YAAY,EAAE,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,WAAW,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAElD,MAAM,aAAa,GAAG,eAAe;SAClC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;SACvD,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,MAAM,MAAM,GAAG,MAAM,MAAM,CACzB,+DAA+D,WAAW,SAAS,aAAa,6IAA6I,EAC7O,+FAA+F,EAC/F,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,CACrC,CAAC;IAEF,OAAO,sBAAsB,WAAW,OAAO,MAAM,CAAC,IAAI,EAAE,8BAA8B,aAAa,EAAE,CAAC;AAC5G,CAAC"}

package/dist/cli/commands/config.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shows all current configuration values.
+ */
+export declare function configShowCommand(): void;
+/**
+ * Sets a configuration value.
+ */
+export declare function configSetCommand(key: string, value: string): void;
+/**
+ * Gets a specific configuration value.
+ */
+export declare function configGetCommand(key: string): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/cli/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/config.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAUxC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAiCjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAWlD"}