kaven-cli 0.4.0 → 0.4.2-alpha.0

package/README.md

@@ -1,48 +1,83 @@
 # Kaven CLI
 
-> 📖 Versão em Português: [README.pt-BR.md](./README.pt-BR.md)
+> 📖 Portuguese Version: [README.pt-BR.md](./README.pt-BR.md)
 
 [![npm version](https://img.shields.io/npm/v/kaven-cli/alpha.svg)](https://www.npmjs.com/package/kaven-cli)
 [![npm downloads](https://img.shields.io/npm/dm/kaven-cli.svg)](https://www.npmjs.com/package/kaven-cli)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
-[![Node](https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg)](https://nodejs.org)
-[![CI](https://github.com/kaven-co/kaven-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/kaven-co/kaven-cli/actions/workflows/ci.yml)
+[![Node](https://img.shields.io/badge/node-%3E%3D22-brightgreen.svg)](https://nodejs.org)
+[![Build Status](https://github.com/kaven-co/kaven-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/kaven-co/kaven-cli/actions/workflows/ci.yml)
+[![Pure ESM](https://img.shields.io/badge/module-Pure%20ESM-yellow.svg)](https://nodejs.org/api/esm.html)
 
-The official command-line tool for the [Kaven](https://kaven.site) SaaS boilerplate framework.
-Bootstrap projects, manage modules, and interact with the Kaven Marketplace — all from your terminal.
+**Kaven CLI** is the central orchestrator for the [Kaven Framework](https://kaven.site). It automates the entire lifecycle of a high-performance SaaS boilerplate, from initial scaffolding and Prisma schema orchestration to marketplace module installation and advanced capability management.
 
-> **Alpha:** APIs and commands may change before v1.0.0.
+Built for precision and speed, it is now a **Pure ESM** tool optimized for modern Node.js environments.
+
+---
+
+## Table of Contents
+
+- [Core Principles](#core-principles)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Command Reference](#command-reference)
+  - [Project Initialization (`init`)](#project-initialization-init)
+  - [Schema Activation Engine (`module`)](#schema-activation-engine-module)
+  - [Feature Flags & Capabilities (`config features`)](#feature-flags--capabilities-config-features)
+  - [Marketplace Integration](#marketplace-integration)
+  - [Update & Upgrade](#update--upgrade)
+- [Architecture Deep Dive](#architecture-deep-dive)
+  - [Schema Activation Logic](#schema-activation-logic)
+  - [AIOX Squad Integration](#aiox-squad-integration)
+- [Configuration & Environment](#configuration--environment)
+- [Troubleshooting](#troubleshooting)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
+## Core Principles
+
+- **Pristine Scaffolding**: No more cluttered boilerplates. Kaven starts lean and grows as you add modules.
+- **Transactional Integrity**: The CLI uses a `TransactionalFileSystem` to ensure that failed installations or migrations never leave your project in a broken state.
+- **Agent-Ready**: Native support for **AIOX Squads**, providing a team of specialized AI agents to help build your product.
+- **Type Safety**: Built with strict TypeScript, providing a reliable developer experience.
 
 ---
 
 ## Installation
 
+### Global Install (Recommended)
+
 ```bash
 npm install -g kaven-cli@alpha
 # or
 pnpm add -g kaven-cli@alpha
 ```
 
-**Requirements:** Node.js >= 20, pnpm (required by `kaven init`)
+### Requirements
+- **Node.js**: >= 22.0.0 (Pure ESM support required)
+- **PackageManager**: `pnpm` is highly recommended and required for certain internal tasks.
+- **Git**: Installed and configured.
 
 ---
 
 ## Quick Start
 
 ```bash
-# 1. Bootstrap a new Kaven project
-kaven init my-saas-app
+# 1. Bootstrap a new project with AI Squad support
+kaven init my-unicorn-startup --with-squad
 
-# 2. Authenticate with the marketplace
+# 2. Login to Kaven Marketplace
 kaven auth login
 
-# 3. Browse available modules
-kaven marketplace browse
+# 3. Choose your SaaS tier and features (Interactive TUI)
+kaven config features
 
-# 4. Install a module
-kaven marketplace install payments
+# 4. Activate the Billing module in your schema
+kaven module activate billing
 
-# 5. Check project health
+# 5. Verify project health
 kaven module doctor
 ```
 
@@ -50,274 +85,213 @@ kaven module doctor
 
 ## Command Reference
 
-### `kaven init [project-name]`
+### Project Initialization (`init`)
 
-Bootstrap a new Kaven project from the official template.
+The `init` command clones the official [Kaven Template](https://github.com/kaven-co/kaven-template) and prepares the project environment.
 
-```
-Options:
-  --defaults       Skip interactive prompts, use defaults
-  --skip-install   Skip pnpm install after setup
-  --skip-git       Skip git init and initial commit
-  --force          Overwrite existing directory
-  --with-squad     Initialize AIOX squad in the project
-
-Examples:
-  kaven init my-app
-  kaven init my-app --defaults
-  kaven init my-app --skip-git --skip-install
+```bash
+kaven init [project-name] [options]
 ```
 
----
+**Options:**
+- `--with-squad`: Bootstraps the AIOX agent infrastructure in `squads/kaven-squad/`.
+- `--template <path|url>`: Use a custom local directory or Git repository as the source.
+- `--force`: Overwrite existing directory if it exists.
+- `--skip-install`: Skip the automatic `pnpm install`.
+- `--skip-git`: Skip `git init` and initial commit.
 
-### `kaven auth`
+---
 
-Manage authentication with the Kaven Marketplace.
+### Schema Activation Engine (`module`)
 
-```
-Commands:
-  login    Start device code flow (RFC 8628) — opens browser to confirm
-  logout   Clear the local session
-  whoami   Display the authenticated user info
-```
+Kaven's **Schema Activation Engine** solves the "Boilerplate Bloat" problem. Instead of having dozens of inactive tables in your database, Kaven keeps modules commented out in your Prisma schema until you need them.
 
----
+```bash
+# List all available modules and their status
+kaven module list
 
-### `kaven marketplace`
+# Activate a module (uncomments Prisma models)
+kaven module activate billing
 
-Explore and install modules from the Kaven Marketplace.
+# Deactivate a module (comments Prisma models)
+kaven module deactivate billing
 
-```
-Commands:
-  list      List available modules
-  install   Download and apply a module to the current project
-  browse    Interactive TUI browser
-
-Options (list):
-  --category <cat>   Filter by category
-  --sort <field>     newest (default) | popular | name
-  --page <n>         Page number
-  --limit <n>        Results per page (max 100)
-  --json             Raw JSON output
-
-Options (install):
-  --version <ver>    Install a specific version
-  --force            Skip overwrite confirmation
-  --skip-env         Skip .env injection
-  --env-file <path>  Target .env file path
+# Verify module integrity and database sync
+kaven module doctor --fix
 ```
 
 ---
 
-### `kaven module`
+### Feature Flags & Capabilities (`config features`)
 
-Manage modules installed in the current project.
+Kaven Framework supports over **60+ granular capabilities** (feature flags) that control everything from UI visibility to API limits.
 
-```
-Commands:
-  doctor    Run health checks on the project and installed modules
-  add       Install a module from a local manifest
-  remove    Uninstall an installed module
-  publish   Publish a module to the marketplace
-
-Options (doctor):
-  --fix    Auto-fix detected issues (runs pnpm install, prisma generate, patches env)
-  --json   Machine-readable JSON output
-
-Exit codes (doctor):
-  0   All checks passed
-  1   One or more errors
-  2   Warnings only
-
-Options (publish):
-  --dry-run          Validate and package without uploading
-  --changelog <msg>  Release notes for this version
+```bash
+kaven config features [options]
 ```
 
-> `kaven doctor` is an alias for `kaven module doctor`.
+This command launches an **Interactive TUI** where you can:
+- Select a **Tier Preset** (Starter, Complete, Pro, Enterprise).
+- Customize individual flags (e.g., `TENANCY_CUSTOM_DOMAINS`, `MAX_PROJECTS`).
+- Automatically generate the `packages/database/prisma/seeds/capabilities.seed.ts` file.
 
 ---
 
-### `kaven upgrade`
-
-Upgrade your license tier via Paddle checkout.
+### Marketplace Integration
 
-```
-Options:
-  --no-browser   Print checkout URL instead of opening browser
-
-Behavior:
-  Opens Paddle checkout in browser → polls for payment (every 5s, max 10 min)
-  → updates local license on success
-```
+The `marketplace` command set allows you to extend your SaaS with official and community modules.
 
----
+```bash
+# Browse modules in a visual TUI
+kaven marketplace browse
 
-### `kaven license`
+# Install a specific module
+kaven marketplace install auth-google
 
-```
-Commands:
-  status   Show current license tier and expiry
+# List available categories
+kaven marketplace list --category auth
 ```
 
 ---
 
-### `kaven cache`
+### Update & Upgrade
 
-Manage the local API response cache (`~/.kaven/cache`, max 50 MB).
+Kaven follows the Linux `apt` convention — **update** manages software versions, **upgrade** manages your plan.
 
-```
-Commands:
-  status   Show cache stats (size, entries, age)
-  clear    Delete all cached data
-
-Cache TTLs:
-  Module listings    24 hours
-  Module manifests   7 days
-  License status     1 hour
+#### `kaven update` — Update CLI and modules
+
+```bash
+kaven update              # check for updates: CLI + all installed modules
+kaven update --core       # check and update CLI only
+kaven update --module X   # update a specific installed module
+kaven update --all        # apply all available updates
+kaven update --check      # check without applying (dry run)
 ```
 
----
+> Works offline: uses local MSW handlers when marketplace is unreachable.
 
-### `kaven telemetry`
+#### `kaven module update` — Update a specific module (C4.1)
 
+```bash
+kaven module update payments          # update to latest
+kaven module update payments@1.0.3    # update to specific version
 ```
-Commands:
-  view   Show recent local telemetry events
-         -l, --limit <n>   Number of events (default: 10)
+
+#### `kaven upgrade` — License plan upgrade only
+
+```bash
+kaven upgrade             # opens Stripe checkout to upgrade your plan tier
+kaven upgrade check       # check if a newer CLI version is on npm
 ```
 
+> `kaven upgrade` is **not** for updating software. It is exclusively for moving between Starter → Complete → Pro license tiers via Stripe.
+
 ---
 
-### `kaven config`
+## Architecture Deep Dive
 
-```
-Commands:
-  set <key> <value>   Set a configuration value
-  get <key>           Get a configuration value
+### Schema Activation Logic
+
+The `SchemaActivator` core targets the `packages/database/prisma/schema.extended.prisma` file. It uses a robust marker system:
+
+```prisma
+// [KAVEN_MODULE:BILLING BEGIN]
+// model Invoice {
+//   id        String   @id @default(cuid())
+//   ...
+// }
+// [KAVEN_MODULE:BILLING END]
 ```
 
----
+When `activate billing` is called, the CLI:
+1. Validates **Marker Pairing** (BEGIN/END integrity).
+2. Performs a **Regex-based uncommenting** that preserves your code's indentation.
+3. Notifies the developer to run `pnpm db:generate && pnpm db:migrate`.
 
-### `kaven init-ci`
+### AIOX Squad Integration
 
-Initialize CI/CD configuration in the current project. Generates GitHub Actions workflows tailored for Kaven projects.
+By passing `--with-squad` during `init`, the CLI:
+1. Injects the `.gemini/` and `.antigravity/` configurations.
+2. Sets up the specialized agents: **Kai** (Orchestrator), **Dex** (Developer), **Quinn** (QA), and **Gage** (DevOps).
+3. Configures the repository for an AI-native development workflow.
 
 ---
 
-## Configuration
+## Configuration & Environment
 
-All configuration lives in `~/.kaven/`:
+All CLI state and cached marketplace data reside in `~/.kaven/`:
 
-```
-~/.kaven/
-  auth.json         Authentication tokens         (chmod 600)
-  config.json       CLI configuration
-  license.json      License key and tier
-  signing-key.json  Module Ed25519 signing key    (chmod 600)
-  cache/            API response cache            (max 50 MB)
-  telemetry.log     Local telemetry events
-```
+- `auth.json`: JWT tokens for marketplace access.
+- `config.json`: CLI preferences (e.g., `apiUrl`, `serviceToken`).
+- `license.json`: Local cache of your framework license.
+- `cache/`: Cached API responses to speed up browsing.
 
 ### Environment Variables
 
 | Variable | Description |
 |----------|-------------|
-| `KAVEN_API_URL` | Override the marketplace API URL |
-| `KAVEN_DEBUG=1` | Enable verbose debug output |
-| `KAVEN_OFFLINE=1` | Use cached data only, no network requests |
-| `KAVEN_TELEMETRY=0` | Disable telemetry entirely |
-
-### API URL Override (config file)
-
-```json
-// ~/.kaven/config.json
-{
-  "apiUrl": "https://api.your-kaven-instance.com"
-}
-```
-
-### Debug Mode
-
-```bash
-KAVEN_DEBUG=1 kaven marketplace list
-```
-
-### Offline Mode
-
-```bash
-KAVEN_OFFLINE=1 kaven marketplace list
-```
+| `KAVEN_API_URL` | Override the production marketplace URL. |
+| `KAVEN_DEBUG=1` | Enable detailed logging of HTTP and FS operations. |
+| `KAVEN_SERVICE_TOKEN` | Token for automated CI/CD or Agent-to-Service auth. |
+| `KAVEN_OFFLINE=1` | Force the CLI to use local cache only. |
 
 ---
 
 ## Troubleshooting
 
-**"Not authenticated" error**
-```bash
-kaven auth login
-```
-
-**"module.json not found" on publish**
-
-Run `kaven module publish` from inside the module directory (the one containing `module.json`).
-
-**pnpm install fails on `kaven init`**
-```bash
-npm install -g pnpm          # install pnpm globally
-# or skip it and install later:
-kaven init my-app --skip-install
-cd my-app && pnpm install
-```
-
-**Prisma client out of sync**
-```bash
-kaven module doctor --fix
-# or manually:
-npx prisma generate
-```
+### "ReferenceError: module is not defined"
+Kaven CLI is **Pure ESM**. If you are trying to extend the CLI or run it in an environment that expects CommonJS, ensure your `package.json` contains `"type": "module"` and you are using Node.js 22+.
 
-**Cache issues**
-```bash
-kaven cache clear
-```
+### "Marker Pairing Failed"
+This error occurs if you manually edited the Prisma file and deleted or duplicated a `// [KAVEN_MODULE:...]` marker. Run `kaven module doctor` to identify the broken section.
 
-**Permission denied on `~/.kaven/`**
-```bash
-chmod 700 ~/.kaven
-chmod 600 ~/.kaven/auth.json ~/.kaven/signing-key.json
-```
+### "Not Authenticated"
+Run `kaven auth login`. If you are in a CI/CD environment, provide a `KAVEN_SERVICE_TOKEN` via environment variables.
 
 ---
 
 ## Contributing
 
+We welcome contributions! Kaven CLI is a high-integrity project with strict quality gates.
+
+### Development Setup
+
 ```bash
+# 1. Clone and install
 git clone https://github.com/kaven-co/kaven-cli
 cd kaven-cli
 pnpm install
-pnpm test           # 310 tests
-pnpm run typecheck
+
+# 2. Run the full test suite (334 tests)
+pnpm test
+
+# 3. Run linting and type-checking
 pnpm run lint
+pnpm run typecheck
+
+# 4. Build the Pure ESM bundle
+pnpm run build
 ```
 
-**Commit convention:** this repo uses [Conventional Commits](https://www.conventionalcommits.org/).
+### Commit Guidelines
+We use **Conventional Commits**. Every commit must be prefixed with `feat:`, `fix:`, `docs:`, etc. Breaking changes must be flagged.
 
-```bash
-feat: add --with-squad flag to kaven init
-fix: resolve cache corruption on concurrent writes
-docs: update troubleshooting section
-```
+### Quality Gates
+- **Tests**: 100% pass rate required.
+- **Lint**: No `any` allowed in core modules.
+- **ESM**: All relative imports must include the `.js` extension.
+
+---
 
-**Release flow:**
-1. Open a PR against `main`
-2. PR requires CI green (lint + typecheck + tests + build)
-3. Merge → Semantic Release automatically bumps version and publishes to npm (`@alpha` tag)
+## Credits & Attribution
 
-Types that trigger a release: `feat` (minor), `fix` / `perf` / `refactor` (patch), `BREAKING CHANGE` (major).
-Types that do **not** trigger a release: `chore`, `docs`, `test`, `style`, `ci`.
+Kaven CLI is built with support from the **AIOX Framework**, an agentic development ecosystem by [SynkraAI](https://github.com/synkra). 
 
-See [`docs/releasing.md`](./docs/releasing.md) for the full release pipeline documentation.
+Special thanks to the **Kaven Squad** of autonomous agents who helped architect, develop, and validate this tool:
+- **Kai** (Orchestrator)
+- **Dex** (Developer)
+- **Quinn** (QA)
+- **Gage** (DevOps)
 
 ---
 
@@ -327,6 +301,6 @@ Apache 2.0 — see [LICENSE](LICENSE)
 
 ---
 
-Documentation: https://docs.kaven.site/cli
-GitHub: https://github.com/kaven-co/kaven-cli
-npm: https://www.npmjs.com/package/kaven-cli
+**Documentation**: [docs.kaven.site/cli](https://docs.kaven.site/cli)  
+**GitHub**: [github.com/kaven-co/kaven-cli](https://github.com/kaven-co/kaven-cli)  
+**NPM**: [npmjs.com/package/kaven-cli](https://www.npmjs.com/package/kaven-cli)

package/dist/EnvManager-NMS3NMIE.js

@@ -0,0 +1,15 @@
+import*as l from"fs";import*as f from"path";import*as m from"readline";import d from"chalk";var h=class{async injectEnvVars(n,t,r){if(r.skipEnv||!t||t.length===0)return{added:0,skipped:0};let s=f.join(r.projectDir,r.envFile??".env"),a=this.readEnvFile(s),c=this.parseEnvFile(a),i=[],p=0;console.log(d.bold(`
+  Environment variables for '${n}':
+`));for(let e of t){if(c.has(e.name)){console.log(d.dim(`  ${e.name} \u2014 already set, skipping`)),p++;continue}let o;if(e.sensitive)o=await this.promptPassword(`  ${e.name} (${e.description})${e.default?" [****]":""}: `),!o&&e.default&&(o=e.default);else{let g=e.default?` [${e.default}]`:"";o=await this.promptInput(`  ${e.name} (${e.description})${g}: `,e.default)}if(e.required&&!o&&(console.log(d.yellow(`  ${e.name} is required.`)),o=e.sensitive?await this.promptPassword(`  ${e.name}: `):await this.promptInput(`  ${e.name}: `),!o)){console.log(d.yellow(`  Skipping ${e.name} \u2014 set it manually in .env`)),p++;continue}i.push({name:e.name,value:o})}if(i.length===0)return console.log(d.dim("  No new environment variables to add.")),{added:0,skipped:p};let u=this.buildMarkerBlock(n,i);return this.appendToEnvFile(s,a,u),console.log(d.green(`
+  Added ${i.length} environment variable(s) to ${r.envFile??".env"}`)),{added:i.length,skipped:p}}removeEnvVars(n,t){let r=[".env",".env.local",".env.development",".env.production"];t.envFile&&r.unshift(t.envFile);let s=0;for(let a of r){let c=f.join(t.projectDir,a);if(!l.existsSync(c))continue;let i=l.readFileSync(c,"utf-8"),p=`# [KAVEN_MODULE:${n} BEGIN]`,u=`# [KAVEN_MODULE:${n} END]`,e=i.indexOf(p),o=i.indexOf(u);if(e===-1||o===-1)continue;let v=i.substring(e,o+u.length).split(`
+`).filter(w=>/^[A-Z_]+=/.test(w)).length,E=i.substring(0,e).replace(/\n+$/,`
+`),$=i.substring(o+u.length+1);l.writeFileSync(c,E+$),s+=v,v>0&&console.log(d.dim(`  Removed ${v} env var(s) from ${a}`))}return s}readEnvFile(n){try{return l.readFileSync(n,"utf-8")}catch{return""}}parseEnvFile(n){let t=new Map;for(let r of n.split(`
+`)){let s=r.match(/^([A-Z_][A-Z0-9_]*)=(.*)$/);s&&t.set(s[1],s[2])}return t}buildMarkerBlock(n,t){return[`# [KAVEN_MODULE:${n} BEGIN]`,...t.map(r=>`${r.name}=${r.value}`),`# [KAVEN_MODULE:${n} END]`].join(`
+`)}appendToEnvFile(n,t,r){l.mkdirSync(f.dirname(n),{recursive:!0});let s=t.endsWith(`
+`)||t===""?`
+`:`
+
+`;l.writeFileSync(n,t+s+r+`
+`)}promptInput(n,t){return new Promise(r=>{let s=m.createInterface({input:process.stdin,output:process.stdout});s.question(n,a=>{s.close(),r(a||t||"")})})}promptPassword(n){return new Promise(t=>{let r=m.createInterface({input:process.stdin,output:process.stdout});process.stdout.write(n),process.stdin.setRawMode?.(!0),process.stdin.resume();let s="",a=c=>{let i=c.toString();i==="\r"||i===`
+`?(process.stdin.setRawMode?.(!1),process.stdin.pause(),process.stdin.removeListener("data",a),process.stdout.write(`
+`),r.close(),t(s)):i===""?process.exit():i==="\x7F"?(s=s.slice(0,-1),process.stdout.clearLine(0),process.stdout.cursorTo(0),process.stdout.write(n+"*".repeat(s.length))):(s+=i,process.stdout.write("*"))};process.stdin.on("data",a)})}};export{h as EnvManager};

package/dist/MarketplaceClient-YCFH2VU4.js

@@ -0,0 +1 @@
+import{g as a}from"./chunk-JHLQ46NG.js";export{a as MarketplaceClient};

package/dist/chunk-JHLQ46NG.js

@@ -0,0 +1 @@
+import v from"fs-extra";import q from"path";import x from"os";var c=class extends Error{constructor(e){super(e),this.name="MarketplaceError"}},T=class extends c{constructor(e){super(e),this.name="AuthenticationError"}},E=class extends c{constructor(t,s){super(s);this.requiredTier=t;this.name="LicenseRequiredError"}},p=class extends c{constructor(e){super(e),this.name="NotFoundError"}},R=class extends c{constructor(t){super(`Rate limited. Try again in ${t}s`);this.retryAfter=t;this.name="RateLimitError"}},m=class extends c{constructor(e){super(e),this.name="ServerError"}},y=class extends c{constructor(e){super(e),this.name="NetworkError"}},A=class extends c{constructor(e){super(e),this.name="SignatureVerificationError"}};function S(r){if(r instanceof Error)return r;if(typeof r=="string")return new Error(r);try{return new Error(JSON.stringify(r))}catch{return new Error(String(r))}}var O="https://marketplace.kaven.site",_=3e4,P=3,C=1e3;function b(r){process.env.KAVEN_DEBUG==="1"&&console.debug(`[kaven:debug] ${r}`)}async function D(){try{let r=q.join(x.homedir(),".kaven","config.json");if(await v.pathExists(r)){let e=await v.readJson(r);if(typeof e.apiUrl=="string"&&e.apiUrl)return e.apiUrl}}catch{}return null}async function I(){if(process.env.KAVEN_SERVICE_TOKEN)return process.env.KAVEN_SERVICE_TOKEN;try{let r=q.join(x.homedir(),".kaven","config.json");if(await v.pathExists(r)){let e=await v.readJson(r);if(typeof e.serviceToken=="string"&&e.serviceToken)return e.serviceToken}}catch{}return null}async function j(){if(process.env.KAVEN_API_URL)return process.env.KAVEN_API_URL.replace(/\/$/,"");let r=await D();return r?r.replace(/\/$/,""):O}function K(r){return new Promise(e=>setTimeout(e,r))}function G(r){return r>=500}var $=class{baseURLPromise;authService;constructor(e){this.authService=e??null,this.baseURLPromise=j()}async resolveUrl(e){return`${await this.baseURLPromise}${e}`}async request(e,t,s={}){let k=`${await this.baseURLPromise}${t}`,{body:d,authenticated:U=!1}=s,g=null;for(let u=0;u<=P;u++){if(u>0){let l=C*Math.pow(2,u-1);b(`Retry attempt ${u} for ${e} ${t} (delay ${l}ms)`),await K(l)}try{let l={"Content-Type":"application/json",Accept:"application/json"};if(U&&this.authService){let h=await this.authService.getValidToken();l.Authorization=`Bearer ${h}`}let n=await I();n&&(l["X-Service-Token"]=n),b(`${e} ${k}`);let w=new AbortController,M=setTimeout(()=>w.abort(),_),o;try{o=await fetch(k,{method:e,headers:l,body:d!==void 0?JSON.stringify(d):void 0,signal:w.signal})}finally{clearTimeout(M)}if(b(`Response: ${o.status} ${o.statusText}`),!o.ok){let h=await o.text().catch(()=>""),f=h;try{let a=JSON.parse(h);f=a.message||a.error||h}catch{}switch(o.status){case 401:throw new T(f||"Authentication required");case 403:{let a="pro";try{a=JSON.parse(h).requiredTier||a}catch{}throw new E(a,f||"License required")}case 404:throw new p(f||"Resource not found");case 429:{let a=parseInt(o.headers.get("retry-after")??"60",10);throw new R(isNaN(a)?60:a)}default:if(G(o.status)){g=new m(f||`Server error: ${o.status}`);continue}throw new m(f||`Server error: ${o.status}`)}}return(o.headers.get("content-type")??"").includes("application/json")?await o.json():{}}catch(l){let n=S(l);if(n instanceof T||n instanceof E||n instanceof p||n instanceof R)throw n;if(n instanceof TypeError||n.name==="AbortError"){let w=new y(n.name==="AbortError"?"Request timed out after 30s":`Network error: ${n.message}`);if(g=w,u<P)continue;throw w}if(n instanceof m){if(g=n,u<P)continue;throw n}throw n}}throw g??new y("Request failed after retries")}async requestDeviceCode(){return this.request("POST","/auth/device-code",{body:{client_id:"kaven-cli"},authenticated:!1})}async pollDeviceToken(e){try{let s=`${await this.baseURLPromise}/auth/token`,i=new AbortController,k=setTimeout(()=>i.abort(),_),d;try{d=await fetch(s,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({device_code:e,grant_type:"urn:ietf:params:oauth:grant-type:device_code"}),signal:i.signal})}finally{clearTimeout(k)}if(d.ok)return{status:"success",tokens:await d.json()};let g=(await d.json().catch(()=>({}))).error??"unknown_error";switch(g){case"authorization_pending":return{status:"authorization_pending"};case"slow_down":return{status:"slow_down"};case"access_denied":return{status:"access_denied"};case"expired_token":return{status:"expired_token"};default:throw new Error(`Unexpected error: ${g}`)}}catch(t){let s=S(t),i=s;throw i.code==="ECONNREFUSED"||i.code==="ENOTFOUND"?new y("Network error. Check your connection and try again."):s}}async refreshToken(e){return this.request("POST","/auth/refresh",{body:{refresh_token:e},authenticated:!1})}async listModules(e){let t=new URLSearchParams;e?.category&&t.set("category",e.category),e?.tier&&t.set("tier",e.tier),e?.q&&t.set("q",e.q),e?.page&&t.set("page",String(e.page)),e?.pageSize&&t.set("pageSize",String(e.pageSize));let s=t.toString(),i=`/modules${s?`?${s}`:""}`;return this.request("GET",i)}async getModule(e){return this.request("GET",`/modules/${e}`)}async getManifest(e,t){return this.request("GET",`/modules/${e}/versions/${t}/manifest`)}async createDownloadToken(e,t){return this.request("POST","/download-tokens",{body:{moduleSlug:e,version:t},authenticated:!0})}async validateLicense(e,t){return await this.request("POST","/licenses/validate",{body:{licenseKey:e,requiredTier:t}})}async getLicenseStatus(e){return this.request("GET",`/licenses/status?key=${encodeURIComponent(e)}`)}async getModuleManifest(e){try{return await this.getManifest(e,"latest")}catch(t){if(t instanceof p)return null;throw t}}async getReleaseInfo(e,t){return this.request("GET",`/modules/${e}/versions/${t}`)}async getUploadUrl(e,t,s){return this.request("POST","/releases/upload-url",{body:{moduleSlug:e,version:t,size:s},authenticated:!0})}async createRelease(e){return this.request("POST","/releases",{body:e,authenticated:!0})}async createCheckoutSession(e,t){return this.request("POST","/checkout/session",{body:{tier:e,licenseKey:t},authenticated:!0})}async getCheckoutStatus(e){return this.request("GET",`/checkout/session/${e}/status`,{authenticated:!0})}async getCategories(){try{let e=await this.request("GET","/categories",{authenticated:!1});return Array.isArray(e)?e:e.categories??[]}catch(e){if(e instanceof p){let s=(await this.request("GET","/search?q=",{authenticated:!1})).facets?.categories?.map(i=>i.category).filter(Boolean)??[];return[...new Set(s)].sort()}throw e}}};export{T as a,E as b,p as c,y as d,A as e,S as f,$ as g};

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+declare const main: () => void;
+
+export { main };