@beaulewis/saas-cli 1.0.0 → 1.0.2

package/README.md

@@ -7,9 +7,11 @@
 Live documentation · AI-powered assistance · Code generation · Backend integrations
 
 [![npm version](https://img.shields.io/npm/v/@beaulewis/saas-cli.svg?style=flat-square)](https://www.npmjs.com/package/@beaulewis/saas-cli)
+[![npm downloads](https://img.shields.io/npm/dm/@beaulewis/saas-cli.svg?style=flat-square)](https://www.npmjs.com/package/@beaulewis/saas-cli)
 [![license](https://img.shields.io/npm/l/@beaulewis/saas-cli.svg?style=flat-square)](https://github.com/Beaulewis1977/saas-cli/blob/main/LICENSE)
-[![CI](https://img.shields.io/github/actions/workflow/status/Beaulewis1977/saas-cli/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/Beaulewis1977/saas-cli/actions/workflows/ci.yml)
+[![CI](https://img.shields.io/github/actions/workflow/status/Beaulewis1977/saas-cli/ci.yml?branch=develop&style=flat-square&label=CI)](https://github.com/Beaulewis1977/saas-cli/actions/workflows/ci.yml)
 [![node](https://img.shields.io/node/v/@beaulewis/saas-cli.svg?style=flat-square)](https://nodejs.org)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/Beaulewis1977/saas-cli/pulls)
 
 </div>
 
@@ -18,6 +20,7 @@ Live documentation · AI-powered assistance · Code generation · Backend integr
 ## Table of Contents
 
 - [Features](#features)
+- [Requirements](#requirements)
 - [Installation](#installation)
 - [Quick Start](#quick-start)
 - [Commands](#commands)
@@ -53,6 +56,39 @@ Live documentation · AI-powered assistance · Code generation · Backend integr
 
 ---
 
+## Requirements
+
+### Core Requirement
+
+- **Node.js 20+** - [Download](https://nodejs.org/)
+
+### External CLI Dependencies
+
+Some commands require external CLIs to be installed. The table below shows which CLIs are needed for each command:
+
+| Command | Required CLI | Installation |
+|---------|--------------|--------------|
+| `saas init flutter` | Flutter SDK | [flutter.dev/get-started/install](https://docs.flutter.dev/get-started/install) |
+| `saas init add` | Flutter SDK | [flutter.dev/get-started/install](https://docs.flutter.dev/get-started/install) |
+| `saas init worker` | Wrangler CLI | `npm install -g wrangler` |
+| `saas init supabase` | Supabase CLI | `npm install -g supabase` or `brew install supabase/tap/supabase` |
+| `saas video *` | FFmpeg | `brew install ffmpeg` (macOS) or `apt install ffmpeg` (Linux) |
+| `saas cf *` | Wrangler CLI | `npm install -g wrangler` |
+| `saas supabase *` | Supabase CLI | `npm install -g supabase` or `brew install supabase/tap/supabase` |
+
+### Commands Without External Dependencies
+
+These commands work out of the box with just Node.js:
+
+- `saas docs` - Documentation lookup (requires `CONTEXT7_API_KEY`)
+- `saas ask` - AI questions (requires `PERPLEXITY_API_KEY`)
+- `saas gen` - Code generation
+- `saas redis` - Redis management (requires `REDIS_URL`)
+- `saas push` - Push notifications (requires OneSignal keys)
+- `saas flags` - Feature flags (requires PostHog keys)
+
+---
+
 ## Installation
 
 ```bash
@@ -273,7 +309,86 @@ saas init add riverpod,drift,freezed
 
 ## Environment Variables
 
-Create a `.env` file in your project root or set these in your shell configuration.
+The CLI reads environment variables for API keys and service credentials. You have two options:
+
+### Option 1: Project `.env` File (Recommended)
+
+Create a `.env` file in your project directory. This allows different API keys per project.
+
+```bash
+# Create .env in your project root (add to .gitignore!)
+touch .env
+```
+
+**Copy this template into your `.env` file:**
+
+```ini
+# Documentation (Context7)
+CONTEXT7_API_KEY=
+
+# AI Questions (Perplexity)
+PERPLEXITY_API_KEY=
+
+# Supabase
+SUPABASE_PROJECT_REF=
+SUPABASE_ACCESS_TOKEN=
+
+# Redis
+REDIS_URL=
+
+# Cloudflare Workers
+CF_API_TOKEN=
+
+# Push Notifications (OneSignal)
+ONESIGNAL_APP_ID=
+ONESIGNAL_API_KEY=
+
+# Feature Flags (PostHog)
+POSTHOG_API_KEY=
+POSTHOG_PROJECT_ID=
+```
+
+**Add `.env` to your `.gitignore` to avoid committing secrets:**
+
+```gitignore
+.env
+```
+
+### Option 2: Shell Exports (Global)
+
+Add these to your `~/.bashrc`, `~/.zshrc`, or shell config for system-wide access:
+
+```bash
+# Documentation (Context7)
+export CONTEXT7_API_KEY="your-key-here"
+
+# AI Questions (Perplexity)
+export PERPLEXITY_API_KEY="pplx-your-key-here"
+
+# Supabase
+export SUPABASE_PROJECT_REF="your-project-ref"
+export SUPABASE_ACCESS_TOKEN="your-access-token"
+
+# Redis
+export REDIS_URL="redis://localhost:6379"
+
+# Cloudflare Workers
+export CF_API_TOKEN="your-cloudflare-token"
+
+# Push Notifications (OneSignal)
+export ONESIGNAL_APP_ID="your-app-id"
+export ONESIGNAL_API_KEY="your-api-key"
+
+# Feature Flags (PostHog)
+export POSTHOG_API_KEY="your-posthog-key"
+export POSTHOG_PROJECT_ID="your-project-id"
+```
+
+After adding, reload your shell: `source ~/.bashrc` or `source ~/.zshrc`
+
+> **Note:** Shell-exported environment variables take precedence over `.env` file values. If you have both, the shell export wins.
+
+### Variable Reference
 
 | Variable | Description | Required For |
 |----------|-------------|--------------|
@@ -328,6 +443,10 @@ This CLI executes external tools (FFmpeg, Wrangler, Flutter, Supabase CLI) via s
 
 Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for development guidelines.
 
+- **Bug reports:** [Open an issue](https://github.com/Beaulewis1977/saas-cli/issues/new)
+- **Feature requests:** [Start a discussion](https://github.com/Beaulewis1977/saas-cli/discussions)
+- **Pull requests:** Fork, create a branch, and submit a PR
+
 ```bash
 # Clone and install
 git clone https://github.com/Beaulewis1977/saas-cli.git

package/dist/chunk-FGZ7PLMQ.js

@@ -0,0 +1,38 @@
+// src/types/index.ts
+var MODEL_ALIASES = {
+  sonar: "sonar",
+  pro: "sonar-pro",
+  reasoning: "sonar-reasoning-pro",
+  deep: "sonar-deep-research"
+};
+var LIBRARY_IDS = {
+  flutter: "/websites/flutter_cn",
+  dart: "/websites/dart_dev",
+  riverpod: "/rrousselgit/riverpod",
+  drift: "/simolus3/drift",
+  go_router: "/websites/flutter_cn",
+  gorouter: "/websites/flutter_cn",
+  supabase: "/supabase/supabase-js",
+  powersync: "/powersync-ja/powersync-js",
+  freezed: "/rrousselgit/freezed",
+  bloc: "/felangel/bloc",
+  dio: "/cfug/dio",
+  hive: "/isar/hive",
+  isar: "/isar/isar",
+  firebase: "/firebase/flutterfire"
+};
+var EXIT_CODES = {
+  SUCCESS: 0,
+  GENERAL_ERROR: 1,
+  USAGE_ERROR: 2,
+  CONFIG_ERROR: 3,
+  NETWORK_ERROR: 4,
+  AUTH_ERROR: 5
+};
+
+export {
+  MODEL_ALIASES,
+  LIBRARY_IDS,
+  EXIT_CODES
+};
+//# sourceMappingURL=chunk-FGZ7PLMQ.js.map

package/dist/chunk-FGZ7PLMQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/index.ts"],"sourcesContent":["/**\n * Global CLI configuration stored in ~/.config/saas-cli/config.yaml\n */\nexport interface GlobalConfig {\n  context7?: {\n    enabled?: boolean;\n    apiKey?: string;\n  };\n  perplexity?: {\n    apiKey?: string;\n    defaultModel?: PerplexityModel;\n  };\n  supabase?: {\n    projectRef?: string;\n    url?: string;\n    serviceKey?: string;\n  };\n  redis?: {\n    url?: string;\n  };\n  cloudflare?: {\n    accountId?: string;\n    apiToken?: string;\n  };\n  onesignal?: {\n    appId?: string;\n    apiKey?: string;\n  };\n  posthog?: {\n    projectId?: string;\n    apiKey?: string;\n  };\n  defaults?: {\n    outputFormat?: OutputFormat;\n    cacheTtl?: number;\n  };\n}\n\n/**\n * Project-level configuration stored in ./saas.yaml\n */\nexport interface ProjectConfig {\n  project?: {\n    name?: string;\n    type?: 'flutter' | 'dart' | 'other';\n  };\n  flutter?: {\n    path?: string;\n  };\n  supabase?: {\n    path?: string;\n    typesOutput?: string;\n  };\n  templates?: Record<string, { path: string }>;\n}\n\n/**\n * Output format options\n */\nexport type OutputFormat = 'pretty' | 'json' | 'minimal';\n\n/**\n * Global CLI options available on all commands\n */\nexport interface GlobalOptions {\n  json?: boolean;\n  verbose?: boolean;\n  debug?: boolean;\n}\n\n/**\n * Perplexity AI model options\n */\nexport type PerplexityModel = 'sonar' | 'sonar-pro' | 'sonar-reasoning-pro' | 'sonar-deep-research';\n\n/**\n * Model aliases for user-friendly names\n */\nexport const MODEL_ALIASES: Record<string, PerplexityModel> = {\n  sonar: 'sonar',\n  pro: 'sonar-pro',\n  reasoning: 'sonar-reasoning-pro',\n  deep: 'sonar-deep-research',\n};\n\n/**\n * Context7 library ID mapping for common Flutter/Dart packages\n */\nexport const LIBRARY_IDS: Record<string, string> = {\n  flutter: '/websites/flutter_cn',\n  dart: '/websites/dart_dev',\n  riverpod: '/rrousselgit/riverpod',\n  drift: '/simolus3/drift',\n  go_router: '/websites/flutter_cn',\n  gorouter: '/websites/flutter_cn',\n  supabase: '/supabase/supabase-js',\n  powersync: '/powersync-ja/powersync-js',\n  freezed: '/rrousselgit/freezed',\n  bloc: '/felangel/bloc',\n  dio: '/cfug/dio',\n  hive: '/isar/hive',\n  isar: '/isar/isar',\n  firebase: '/firebase/flutterfire',\n};\n\n/**\n * Context7 API response types\n */\nexport interface Context7SearchResult {\n  libraryId: string;\n  name?: string;\n  description?: string;\n}\n\nexport interface Context7DocsResult {\n  content: string;\n  source?: string;\n  title?: string;\n}\n\n/**\n * Perplexity API response types\n */\nexport interface PerplexityResponse {\n  choices: Array<{\n    message: {\n      content: string;\n      role: string;\n    };\n  }>;\n  citations?: string[];\n  usage: {\n    prompt_tokens: number;\n    completion_tokens: number;\n  };\n}\n\nexport interface PerplexityAskOptions {\n  model?: PerplexityModel;\n  maxTokens?: number;\n  temperature?: number;\n  searchRecencyFilter?: 'day' | 'week' | 'month' | 'year';\n  searchDomainFilter?: string[];\n  returnSources?: boolean;\n}\n\n/**\n * Column specification for code generation\n */\nexport interface ColumnSpec {\n  name: string;\n  type: string;\n  isPrimaryKey?: boolean;\n  isForeignKey?: boolean;\n  foreignKeyTable?: string;\n  foreignKeyColumn?: string;\n  isNullable?: boolean;\n  defaultValue?: string;\n  isAutoIncrement?: boolean;\n}\n\n/**\n * RLS policy types for Supabase\n */\nexport type RLSPolicyType = 'user-owned' | 'team-owned' | 'public-read' | 'admin-only';\n\n/**\n * Command exit codes\n */\nexport const EXIT_CODES = {\n  SUCCESS: 0,\n  GENERAL_ERROR: 1,\n  USAGE_ERROR: 2,\n  CONFIG_ERROR: 3,\n  NETWORK_ERROR: 4,\n  AUTH_ERROR: 5,\n} as const;\n\nexport type ExitCode = (typeof EXIT_CODES)[keyof typeof EXIT_CODES];\n"],"mappings":";AA8EO,IAAM,gBAAiD;AAAA,EAC5D,OAAO;AAAA,EACP,KAAK;AAAA,EACL,WAAW;AAAA,EACX,MAAM;AACR;AAKO,IAAM,cAAsC;AAAA,EACjD,SAAS;AAAA,EACT,MAAM;AAAA,EACN,UAAU;AAAA,EACV,OAAO;AAAA,EACP,WAAW;AAAA,EACX,UAAU;AAAA,EACV,UAAU;AAAA,EACV,WAAW;AAAA,EACX,SAAS;AAAA,EACT,MAAM;AAAA,EACN,KAAK;AAAA,EACL,MAAM;AAAA,EACN,MAAM;AAAA,EACN,UAAU;AACZ;AAkEO,IAAM,aAAa;AAAA,EACxB,SAAS;AAAA,EACT,eAAe;AAAA,EACf,aAAa;AAAA,EACb,cAAc;AAAA,EACd,eAAe;AAAA,EACf,YAAY;AACd;","names":[]}

package/dist/{chunk-5BCEXHNM.js → chunk-JTMQREZ6.js}

@@ -1,39 +1,9 @@
-// src/utils/error.ts
-import pc from "picocolors";
-
-// src/types/index.ts
-var MODEL_ALIASES = {
-  sonar: "sonar",
-  pro: "sonar-pro",
-  reasoning: "sonar-reasoning-pro",
-  deep: "sonar-deep-research"
-};
-var LIBRARY_IDS = {
-  flutter: "/websites/flutter_cn",
-  dart: "/websites/dart_dev",
-  riverpod: "/rrousselgit/riverpod",
-  drift: "/simolus3/drift",
-  go_router: "/websites/flutter_cn",
-  gorouter: "/websites/flutter_cn",
-  supabase: "/supabase/supabase-js",
-  powersync: "/powersync-ja/powersync-js",
-  freezed: "/rrousselgit/freezed",
-  bloc: "/felangel/bloc",
-  dio: "/cfug/dio",
-  hive: "/isar/hive",
-  isar: "/isar/isar",
-  firebase: "/firebase/flutterfire"
-};
-var EXIT_CODES = {
-  SUCCESS: 0,
-  GENERAL_ERROR: 1,
-  USAGE_ERROR: 2,
-  CONFIG_ERROR: 3,
-  NETWORK_ERROR: 4,
-  AUTH_ERROR: 5
-};
+import {
+  EXIT_CODES
+} from "./chunk-FGZ7PLMQ.js";
 
 // src/utils/error.ts
+import pc from "picocolors";
 var CLIError = class extends Error {
   constructor(message, exitCode = EXIT_CODES.GENERAL_ERROR, hint, seeAlso) {
     super(message);
@@ -95,14 +65,63 @@ function handleError(error) {
   console.error(pc.dim(String(error)));
   process.exit(EXIT_CODES.GENERAL_ERROR);
 }
+function createAPIErrorHandler(service) {
+  return (error) => {
+    if (error instanceof APIError) {
+      handleError(error);
+    }
+    if (error && typeof error === "object" && "response" in error) {
+      const response = error.response;
+      const statusCode = response?.statusCode;
+      let hint;
+      switch (statusCode) {
+        case 401:
+          hint = `Check your ${service.toUpperCase()}_API_KEY environment variable`;
+          break;
+        case 403:
+          hint = `Your API key may not have permission for this operation`;
+          break;
+        case 429:
+          hint = `Rate limited. Wait a moment and try again`;
+          break;
+        case 404:
+          hint = `Resource not found. Check if the library or endpoint exists`;
+          break;
+        case 500:
+        case 502:
+        case 503:
+          hint = `${service} service is temporarily unavailable. Try again later`;
+          break;
+      }
+      const apiError = new APIError(
+        `${service} API request failed (${statusCode})`,
+        service,
+        statusCode,
+        hint
+      );
+      handleError(apiError);
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    handleError(new APIError(message, service));
+  };
+}
+function withErrorHandler(fn) {
+  return async (...args) => {
+    try {
+      return await fn(...args);
+    } catch (error) {
+      handleError(error);
+    }
+  };
+}
 
 export {
-  MODEL_ALIASES,
-  LIBRARY_IDS,
   CLIError,
   APIError,
   ConfigError,
   AuthError,
-  handleError
+  handleError,
+  createAPIErrorHandler,
+  withErrorHandler
 };
-//# sourceMappingURL=chunk-5BCEXHNM.js.map
+//# sourceMappingURL=chunk-JTMQREZ6.js.map

package/dist/chunk-JTMQREZ6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/error.ts"],"sourcesContent":["import pc from 'picocolors';\nimport { EXIT_CODES, type ExitCode } from '../types/index.js';\n\n/**\n * Custom CLI error with exit code and helpful hints\n */\nexport class CLIError extends Error {\n  constructor(\n    message: string,\n    public exitCode: ExitCode = EXIT_CODES.GENERAL_ERROR,\n    public hint?: string,\n    public seeAlso?: string,\n  ) {\n    super(message);\n    this.name = 'CLIError';\n  }\n}\n\n/**\n * API-specific error with service context\n */\nexport class APIError extends CLIError {\n  constructor(\n    message: string,\n    public service: string,\n    public statusCode?: number,\n    hint?: string,\n  ) {\n    super(message, EXIT_CODES.NETWORK_ERROR, hint);\n    this.name = 'APIError';\n  }\n}\n\n/**\n * Configuration error\n */\nexport class ConfigError extends CLIError {\n  constructor(message: string, hint?: string) {\n    super(message, EXIT_CODES.CONFIG_ERROR, hint);\n    this.name = 'ConfigError';\n  }\n}\n\n/**\n * Authentication error\n */\nexport class AuthError extends CLIError {\n  constructor(message: string, hint?: string) {\n    super(message, EXIT_CODES.AUTH_ERROR, hint);\n    this.name = 'AuthError';\n  }\n}\n\n/**\n * Format error message for display\n */\nfunction formatError(error: CLIError): string {\n  const lines: string[] = [];\n\n  // Main error message\n  lines.push(pc.red(`Error: ${error.message}`));\n\n  // Add hint if available\n  if (error.hint) {\n    lines.push(pc.yellow(`Hint: ${error.hint}`));\n  }\n\n  // Add see also if available\n  if (error.seeAlso) {\n    lines.push(pc.dim(`See: ${error.seeAlso}`));\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Handle errors and exit appropriately\n */\nexport function handleError(error: unknown): never {\n  // Handle CLIError instances\n  if (error instanceof CLIError) {\n    console.error(formatError(error));\n\n    // Show stack trace in debug mode\n    if (process.env.DEBUG) {\n      console.error(pc.dim('\\nStack trace:'));\n      console.error(pc.dim(error.stack ?? ''));\n    }\n\n    process.exit(error.exitCode);\n  }\n\n  // Handle standard errors\n  if (error instanceof Error) {\n    console.error(pc.red(`Error: ${error.message}`));\n\n    if (process.env.DEBUG) {\n      console.error(pc.dim('\\nStack trace:'));\n      console.error(pc.dim(error.stack ?? ''));\n    }\n\n    process.exit(EXIT_CODES.GENERAL_ERROR);\n  }\n\n  // Handle unknown errors\n  console.error(pc.red('An unexpected error occurred'));\n  console.error(pc.dim(String(error)));\n  process.exit(EXIT_CODES.GENERAL_ERROR);\n}\n\n/**\n * Create an API error handler for a specific service\n */\nexport function createAPIErrorHandler(service: string) {\n  return (error: unknown): never => {\n    if (error instanceof APIError) {\n      handleError(error);\n    }\n\n    // Handle got/HTTP errors\n    if (error && typeof error === 'object' && 'response' in error) {\n      const response = (error as { response?: { statusCode?: number; body?: unknown } }).response;\n      const statusCode = response?.statusCode;\n\n      let hint: string | undefined;\n\n      switch (statusCode) {\n        case 401:\n          hint = `Check your ${service.toUpperCase()}_API_KEY environment variable`;\n          break;\n        case 403:\n          hint = `Your API key may not have permission for this operation`;\n          break;\n        case 429:\n          hint = `Rate limited. Wait a moment and try again`;\n          break;\n        case 404:\n          hint = `Resource not found. Check if the library or endpoint exists`;\n          break;\n        case 500:\n        case 502:\n        case 503:\n          hint = `${service} service is temporarily unavailable. Try again later`;\n          break;\n      }\n\n      const apiError = new APIError(\n        `${service} API request failed (${statusCode})`,\n        service,\n        statusCode,\n        hint,\n      );\n\n      handleError(apiError);\n    }\n\n    // Re-throw as generic API error\n    const message = error instanceof Error ? error.message : String(error);\n    handleError(new APIError(message, service));\n  };\n}\n\n/**\n * Wrap an async function with error handling\n */\nexport function withErrorHandler<T extends (...args: unknown[]) => Promise<unknown>>(\n  fn: T,\n): (...args: Parameters<T>) => Promise<Awaited<ReturnType<T>>> {\n  return async (...args: Parameters<T>): Promise<Awaited<ReturnType<T>>> => {\n    try {\n      return (await fn(...args)) as Awaited<ReturnType<T>>;\n    } catch (error) {\n      handleError(error);\n    }\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-N2ONDKDL.js

@@ -0,0 +1,28 @@
+import {
+  CLIError
+} from "./chunk-JTMQREZ6.js";
+import {
+  EXIT_CODES
+} from "./chunk-FGZ7PLMQ.js";
+
+// src/utils/path.ts
+import { isAbsolute, normalize, relative, resolve, sep } from "path";
+function validateOutputPath(userPath, baseDir = process.cwd()) {
+  const normalizedBase = normalize(resolve(baseDir));
+  const normalizedPath = normalize(resolve(baseDir, userPath));
+  const relativePath = relative(normalizedBase, normalizedPath);
+  const escapesBase = relativePath === ".." || relativePath.startsWith(`..${sep}`) || isAbsolute(relativePath);
+  if (escapesBase) {
+    throw new CLIError(
+      `Output path escapes project directory: "${userPath}"`,
+      EXIT_CODES.GENERAL_ERROR,
+      'Output path must be within the current project directory. Use relative paths like "./lib/output.dart".'
+    );
+  }
+  return normalizedPath;
+}
+
+export {
+  validateOutputPath
+};
+//# sourceMappingURL=chunk-N2ONDKDL.js.map

package/dist/chunk-N2ONDKDL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/path.ts"],"sourcesContent":["import { isAbsolute, normalize, relative, resolve, sep } from 'node:path';\nimport { EXIT_CODES } from '../types/index.js';\nimport { CLIError } from './error.js';\n\n/**\n * Validate and normalize an output file path, preventing path traversal attacks.\n * Ensures the output path is within the specified base directory (defaults to cwd).\n *\n * @param userPath - The user-provided output path\n * @param baseDir - The base directory to restrict output to (defaults to process.cwd())\n * @returns The normalized absolute path if valid\n * @throws CLIError if the path escapes the base directory\n */\nexport function validateOutputPath(userPath: string, baseDir: string = process.cwd()): string {\n  // Normalize and resolve the path\n  const normalizedBase = normalize(resolve(baseDir));\n  const normalizedPath = normalize(resolve(baseDir, userPath));\n\n  // Check if the resolved path is within the base directory\n  const relativePath = relative(normalizedBase, normalizedPath);\n\n  // Segment-aware check: reject '..' or '../...' but allow '..hidden' filenames\n  const escapesBase =\n    relativePath === '..' || relativePath.startsWith(`..${sep}`) || isAbsolute(relativePath);\n\n  if (escapesBase) {\n    throw new CLIError(\n      `Output path escapes project directory: \"${userPath}\"`,\n      EXIT_CODES.GENERAL_ERROR,\n      'Output path must be within the current project directory. Use relative paths like \"./lib/output.dart\".',\n    );\n  }\n\n  return normalizedPath;\n}\n"],"mappings":";;;;;;;;AAAA,SAAS,YAAY,WAAW,UAAU,SAAS,WAAW;AAavD,SAAS,mBAAmB,UAAkB,UAAkB,QAAQ,IAAI,GAAW;AAE5F,QAAM,iBAAiB,UAAU,QAAQ,OAAO,CAAC;AACjD,QAAM,iBAAiB,UAAU,QAAQ,SAAS,QAAQ,CAAC;AAG3D,QAAM,eAAe,SAAS,gBAAgB,cAAc;AAG5D,QAAM,cACJ,iBAAiB,QAAQ,aAAa,WAAW,KAAK,GAAG,EAAE,KAAK,WAAW,YAAY;AAEzF,MAAI,aAAa;AACf,UAAM,IAAI;AAAA,MACR,2CAA2C,QAAQ;AAAA,MACnD,WAAW;AAAA,MACX;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/{chunk-N4OIAZSA.js → chunk-O53ZYAOB.js}

@@ -2,11 +2,13 @@ import {
   cacheKey,
   cachedFetch,
   createAuthenticatedClient
-} from "./chunk-3KD5CFV3.js";
+} from "./chunk-T7ZSH2YP.js";
+import {
+  APIError
+} from "./chunk-JTMQREZ6.js";
 import {
-  APIError,
   LIBRARY_IDS
-} from "./chunk-5BCEXHNM.js";
+} from "./chunk-FGZ7PLMQ.js";
 
 // src/services/context7.ts
 var CONTEXT7_BASE_URL = "https://context7.com/api/v2";
@@ -107,4 +109,4 @@ function getContext7Client(apiKey) {
 export {
   getContext7Client
 };
-//# sourceMappingURL=chunk-N4OIAZSA.js.map
+//# sourceMappingURL=chunk-O53ZYAOB.js.map

package/dist/{chunk-N4OIAZSA.js.map → chunk-O53ZYAOB.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/services/context7.ts"],"sourcesContent":["import type { Got } from 'got';\nimport { LIBRARY_IDS } from '../types/index.js';\nimport { cachedFetch, cacheKey } from '../utils/cache.js';\nimport { APIError } from '../utils/error.js';\nimport { createAuthenticatedClient } from './http.js';\n\nconst CONTEXT7_BASE_URL = 'https://context7.com/api/v2';\n\n/**\n * Context7 API client for documentation lookup\n */\nexport class Context7Client {\n  private client: Got;\n\n  constructor(apiKey: string) {\n    this.client = createAuthenticatedClient(CONTEXT7_BASE_URL, apiKey);\n  }\n\n  /**\n   * Resolve a library name to its Context7 library ID\n   */\n  async resolveLibrary(libraryName: string, query: string): Promise<string> {\n    // Check if we have a known mapping\n    const normalizedName = libraryName.toLowerCase().replace(/-/g, '_');\n    if (LIBRARY_IDS[normalizedName]) {\n      return LIBRARY_IDS[normalizedName] as string;\n    }\n\n    // Search for the library\n    try {\n      const response = await this.client\n        .get('libs/search', {\n          searchParams: {\n            libraryName,\n            query,\n          },\n        })\n        .json<{ results?: Array<{ libraryId: string; name: string }> }>();\n\n      if (response.results && response.results.length > 0 && response.results[0]) {\n        return response.results[0].libraryId;\n      }\n\n      // Fallback: try to construct a likely ID\n      return `/${libraryName}/${libraryName}`;\n    } catch (_error) {\n      // If search fails, try the fallback pattern\n      return `/${libraryName}/${libraryName}`;\n    }\n  }\n\n  /**\n   * Query documentation for a specific library\n   */\n  async queryDocs(libraryId: string, query: string): Promise<string> {\n    try {\n      const response = await this.client\n        .get('context', {\n          searchParams: {\n            libraryId,\n            query,\n            tokens: 8000,\n          },\n        })\n        .text();\n\n      // API returns markdown text directly\n      if (!response || response.trim() === '') {\n        return 'No documentation found for this query.';\n      }\n\n      return response;\n    } catch (error) {\n      if (error && typeof error === 'object' && 'response' in error) {\n        const response = (error as { response?: { statusCode?: number } }).response;\n        const statusCode = response?.statusCode;\n\n        if (statusCode === 202) {\n          throw new APIError(\n            'Library is being indexed',\n            'Context7',\n            202,\n            'The library is being indexed. Please try again in a few minutes.',\n          );\n        }\n\n        if (statusCode === 404) {\n          throw new APIError(\n            'Library not found',\n            'Context7',\n            404,\n            `Could not find library: ${libraryId}. Try a different package name.`,\n          );\n        }\n      }\n\n      throw error;\n    }\n  }\n\n  /**\n   * Search for documentation (combines resolve + query)\n   */\n  async search(library: string, query: string): Promise<string> {\n    const key = cacheKey('context7', library, query);\n\n    return cachedFetch(\n      key,\n      async () => {\n        const libraryId = await this.resolveLibrary(library, query);\n        return this.queryDocs(libraryId, query);\n      },\n      3600 * 1000, // 1 hour cache\n    );\n  }\n}\n\n// Singleton instance cache\nlet clientInstance: Context7Client | null = null;\nlet currentApiKey: string | null = null;\n\n/**\n * Get or create a Context7 client instance\n */\nexport function getContext7Client(apiKey: string): Context7Client {\n  if (!clientInstance || currentApiKey !== apiKey) {\n    clientInstance = new Context7Client(apiKey);\n    currentApiKey = apiKey;\n  }\n  return clientInstance;\n}\n"],"mappings":";;;;;;;;;;;AAMA,IAAM,oBAAoB;AAKnB,IAAM,iBAAN,MAAqB;AAAA,EAClB;AAAA,EAER,YAAY,QAAgB;AAC1B,SAAK,SAAS,0BAA0B,mBAAmB,MAAM;AAAA,EACnE;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,eAAe,aAAqB,OAAgC;AAExE,UAAM,iBAAiB,YAAY,YAAY,EAAE,QAAQ,MAAM,GAAG;AAClE,QAAI,YAAY,cAAc,GAAG;AAC/B,aAAO,YAAY,cAAc;AAAA,IACnC;AAGA,QAAI;AACF,YAAM,WAAW,MAAM,KAAK,OACzB,IAAI,eAAe;AAAA,QAClB,cAAc;AAAA,UACZ;AAAA,UACA;AAAA,QACF;AAAA,MACF,CAAC,EACA,KAA+D;AAElE,UAAI,SAAS,WAAW,SAAS,QAAQ,SAAS,KAAK,SAAS,QAAQ,CAAC,GAAG;AAC1E,eAAO,SAAS,QAAQ,CAAC,EAAE;AAAA,MAC7B;AAGA,aAAO,IAAI,WAAW,IAAI,WAAW;AAAA,IACvC,SAAS,QAAQ;AAEf,aAAO,IAAI,WAAW,IAAI,WAAW;AAAA,IACvC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,UAAU,WAAmB,OAAgC;AACjE,QAAI;AACF,YAAM,WAAW,MAAM,KAAK,OACzB,IAAI,WAAW;AAAA,QACd,cAAc;AAAA,UACZ;AAAA,UACA;AAAA,UACA,QAAQ;AAAA,QACV;AAAA,MACF,CAAC,EACA,KAAK;AAGR,UAAI,CAAC,YAAY,SAAS,KAAK,MAAM,IAAI;AACvC,eAAO;AAAA,MACT;AAEA,aAAO;AAAA,IACT,SAAS,OAAO;AACd,UAAI,SAAS,OAAO,UAAU,YAAY,cAAc,OAAO;AAC7D,cAAM,WAAY,MAAiD;AACnE,cAAM,aAAa,UAAU;AAE7B,YAAI,eAAe,KAAK;AACtB,gBAAM,IAAI;AAAA,YACR;AAAA,YACA;AAAA,YACA;AAAA,YACA;AAAA,UACF;AAAA,QACF;AAEA,YAAI,eAAe,KAAK;AACtB,gBAAM,IAAI;AAAA,YACR;AAAA,YACA;AAAA,YACA;AAAA,YACA,2BAA2B,SAAS;AAAA,UACtC;AAAA,QACF;AAAA,MACF;AAEA,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAO,SAAiB,OAAgC;AAC5D,UAAM,MAAM,SAAS,YAAY,SAAS,KAAK;AAE/C,WAAO;AAAA,MACL;AAAA,MACA,YAAY;AACV,cAAM,YAAY,MAAM,KAAK,eAAe,SAAS,KAAK;AAC1D,eAAO,KAAK,UAAU,WAAW,KAAK;AAAA,MACxC;AAAA,MACA,OAAO;AAAA;AAAA,IACT;AAAA,EACF;AACF;AAGA,IAAI,iBAAwC;AAC5C,IAAI,gBAA+B;AAK5B,SAAS,kBAAkB,QAAgC;AAChE,MAAI,CAAC,kBAAkB,kBAAkB,QAAQ;AAC/C,qBAAiB,IAAI,eAAe,MAAM;AAC1C,oBAAgB;AAAA,EAClB;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/services/context7.ts"],"sourcesContent":["import type { Got } from 'got';\nimport { LIBRARY_IDS } from '../types/index.js';\nimport { cachedFetch, cacheKey } from '../utils/cache.js';\nimport { APIError } from '../utils/error.js';\nimport { createAuthenticatedClient } from './http.js';\n\nconst CONTEXT7_BASE_URL = 'https://context7.com/api/v2';\n\n/**\n * Context7 API client for documentation lookup\n */\nexport class Context7Client {\n  private client: Got;\n\n  constructor(apiKey: string) {\n    this.client = createAuthenticatedClient(CONTEXT7_BASE_URL, apiKey);\n  }\n\n  /**\n   * Resolve a library name to its Context7 library ID\n   */\n  async resolveLibrary(libraryName: string, query: string): Promise<string> {\n    // Check if we have a known mapping\n    const normalizedName = libraryName.toLowerCase().replace(/-/g, '_');\n    if (LIBRARY_IDS[normalizedName]) {\n      return LIBRARY_IDS[normalizedName] as string;\n    }\n\n    // Search for the library\n    try {\n      const response = await this.client\n        .get('libs/search', {\n          searchParams: {\n            libraryName,\n            query,\n          },\n        })\n        .json<{ results?: Array<{ libraryId: string; name: string }> }>();\n\n      if (response.results && response.results.length > 0 && response.results[0]) {\n        return response.results[0].libraryId;\n      }\n\n      // Fallback: try to construct a likely ID\n      return `/${libraryName}/${libraryName}`;\n    } catch (_error) {\n      // If search fails, try the fallback pattern\n      return `/${libraryName}/${libraryName}`;\n    }\n  }\n\n  /**\n   * Query documentation for a specific library\n   */\n  async queryDocs(libraryId: string, query: string): Promise<string> {\n    try {\n      const response = await this.client\n        .get('context', {\n          searchParams: {\n            libraryId,\n            query,\n            tokens: 8000,\n          },\n        })\n        .text();\n\n      // API returns markdown text directly\n      if (!response || response.trim() === '') {\n        return 'No documentation found for this query.';\n      }\n\n      return response;\n    } catch (error) {\n      if (error && typeof error === 'object' && 'response' in error) {\n        const response = (error as { response?: { statusCode?: number } }).response;\n        const statusCode = response?.statusCode;\n\n        if (statusCode === 202) {\n          throw new APIError(\n            'Library is being indexed',\n            'Context7',\n            202,\n            'The library is being indexed. Please try again in a few minutes.',\n          );\n        }\n\n        if (statusCode === 404) {\n          throw new APIError(\n            'Library not found',\n            'Context7',\n            404,\n            `Could not find library: ${libraryId}. Try a different package name.`,\n          );\n        }\n      }\n\n      throw error;\n    }\n  }\n\n  /**\n   * Search for documentation (combines resolve + query)\n   */\n  async search(library: string, query: string): Promise<string> {\n    const key = cacheKey('context7', library, query);\n\n    return cachedFetch(\n      key,\n      async () => {\n        const libraryId = await this.resolveLibrary(library, query);\n        return this.queryDocs(libraryId, query);\n      },\n      3600 * 1000, // 1 hour cache\n    );\n  }\n}\n\n// Singleton instance cache\nlet clientInstance: Context7Client | null = null;\nlet currentApiKey: string | null = null;\n\n/**\n * Get or create a Context7 client instance\n */\nexport function getContext7Client(apiKey: string): Context7Client {\n  if (!clientInstance || currentApiKey !== apiKey) {\n    clientInstance = new Context7Client(apiKey);\n    currentApiKey = apiKey;\n  }\n  return clientInstance;\n}\n"],"mappings":";;;;;;;;;;;;;AAMA,IAAM,oBAAoB;AAKnB,IAAM,iBAAN,MAAqB;AAAA,EAClB;AAAA,EAER,YAAY,QAAgB;AAC1B,SAAK,SAAS,0BAA0B,mBAAmB,MAAM;AAAA,EACnE;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,eAAe,aAAqB,OAAgC;AAExE,UAAM,iBAAiB,YAAY,YAAY,EAAE,QAAQ,MAAM,GAAG;AAClE,QAAI,YAAY,cAAc,GAAG;AAC/B,aAAO,YAAY,cAAc;AAAA,IACnC;AAGA,QAAI;AACF,YAAM,WAAW,MAAM,KAAK,OACzB,IAAI,eAAe;AAAA,QAClB,cAAc;AAAA,UACZ;AAAA,UACA;AAAA,QACF;AAAA,MACF,CAAC,EACA,KAA+D;AAElE,UAAI,SAAS,WAAW,SAAS,QAAQ,SAAS,KAAK,SAAS,QAAQ,CAAC,GAAG;AAC1E,eAAO,SAAS,QAAQ,CAAC,EAAE;AAAA,MAC7B;AAGA,aAAO,IAAI,WAAW,IAAI,WAAW;AAAA,IACvC,SAAS,QAAQ;AAEf,aAAO,IAAI,WAAW,IAAI,WAAW;AAAA,IACvC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,UAAU,WAAmB,OAAgC;AACjE,QAAI;AACF,YAAM,WAAW,MAAM,KAAK,OACzB,IAAI,WAAW;AAAA,QACd,cAAc;AAAA,UACZ;AAAA,UACA;AAAA,UACA,QAAQ;AAAA,QACV;AAAA,MACF,CAAC,EACA,KAAK;AAGR,UAAI,CAAC,YAAY,SAAS,KAAK,MAAM,IAAI;AACvC,eAAO;AAAA,MACT;AAEA,aAAO;AAAA,IACT,SAAS,OAAO;AACd,UAAI,SAAS,OAAO,UAAU,YAAY,cAAc,OAAO;AAC7D,cAAM,WAAY,MAAiD;AACnE,cAAM,aAAa,UAAU;AAE7B,YAAI,eAAe,KAAK;AACtB,gBAAM,IAAI;AAAA,YACR;AAAA,YACA;AAAA,YACA;AAAA,YACA;AAAA,UACF;AAAA,QACF;AAEA,YAAI,eAAe,KAAK;AACtB,gBAAM,IAAI;AAAA,YACR;AAAA,YACA;AAAA,YACA;AAAA,YACA,2BAA2B,SAAS;AAAA,UACtC;AAAA,QACF;AAAA,MACF;AAEA,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAO,SAAiB,OAAgC;AAC5D,UAAM,MAAM,SAAS,YAAY,SAAS,KAAK;AAE/C,WAAO;AAAA,MACL;AAAA,MACA,YAAY;AACV,cAAM,YAAY,MAAM,KAAK,eAAe,SAAS,KAAK;AAC1D,eAAO,KAAK,UAAU,WAAW,KAAK;AAAA,MACxC;AAAA,MACA,OAAO;AAAA;AAAA,IACT;AAAA,EACF;AACF;AAGA,IAAI,iBAAwC;AAC5C,IAAI,gBAA+B;AAK5B,SAAS,kBAAkB,QAAgC;AAChE,MAAI,CAAC,kBAAkB,kBAAkB,QAAQ;AAC/C,qBAAiB,IAAI,eAAe,MAAM;AAC1C,oBAAgB;AAAA,EAClB;AACA,SAAO;AACT;","names":[]}

package/dist/{chunk-3KD5CFV3.js → chunk-T7ZSH2YP.js}

@@ -1,6 +1,6 @@
 import {
   ConfigError
-} from "./chunk-5BCEXHNM.js";
+} from "./chunk-JTMQREZ6.js";
 
 // src/utils/config.ts
 import { existsSync } from "fs";
@@ -193,4 +193,4 @@ export {
   formatTable,
   formatBox
 };
-//# sourceMappingURL=chunk-3KD5CFV3.js.map
+//# sourceMappingURL=chunk-T7ZSH2YP.js.map