specra-cli 0.3.0

package/LICENSE.MD

@@ -0,0 +1,33 @@
+MIT License with Branding Requirement
+
+Copyright (c) 2025-2026 dalmasonto, arthur-kamau
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+1. The above copyright notice and this permission notice shall be included in
+   all copies or substantial portions of the Software.
+
+2. BRANDING / WATERMARK REQUIREMENT: All documentation sites generated using
+   this Software or the associated Specra SDK MUST display the "Powered by
+   Specra" watermark in a visible location (footer or equivalent) on every
+   public-facing page.
+
+   The watermark MUST NOT be removed, hidden, obscured, or made invisible
+   unless the user holds an active paid subscription (Starter tier or above)
+   on the Specra platform (https://specra-docs.com).
+
+   Removal, hiding, or circumvention of the watermark without a valid paid
+   subscription constitutes a COPYRIGHT VIOLATION and a breach of this license.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,246 @@
+# create-specra
+
+The fastest way to create a new Specra documentation site. Scaffold a complete documentation project with a single command.
+
+## What is Specra?
+
+Specra is a modern documentation library for SvelteKit that provides:
+- Multi-version documentation support
+- API reference generation
+- Full-text search
+- MDX-powered content
+- Beautiful UI components
+
+The official Specra site ([specra-docs](https://specra-docs.com)) also offers a SaaS platform with paid tiers (Starter, Pro, Enterprise) including authentication, Stripe/M-Pesa billing, and a user dashboard. The CLI scaffolds free, self-hosted documentation sites — no billing features are included in generated projects.
+
+## Usage
+
+### With npx (recommended)
+
+```bash
+npx create-specra my-docs
+```
+
+### With npm
+
+```bash
+npm create specra my-docs
+```
+
+### With yarn
+
+```bash
+yarn create specra my-docs
+```
+
+### With pnpm
+
+```bash
+pnpm create specra my-docs
+```
+
+## Options
+
+```bash
+npx create-specra [project-directory] [options]
+```
+
+### Arguments
+
+- `[project-directory]` - The directory to create the project in (optional, will prompt if not provided)
+
+### Options
+
+- `--template <template>` - Template to use: `minimal`, `book-docs`, `jbrains-docs` (will prompt if not provided)
+- `--use-npm` - Use npm as the package manager
+- `--use-pnpm` - Use pnpm as the package manager
+- `--use-yarn` - Use yarn as the package manager
+- `--skip-install` - Skip package installation
+
+## Templates
+
+### Minimal (Default)
+
+Minimal setup to get started quickly:
+- Basic documentation structure
+- Essential configuration
+- Clean starting point
+- Ready to customize
+
+### Book Docs
+
+Knowledge base style inspired by popular docs platforms:
+- Dark theme by default
+- Categorized sidebar with section headers (Content, Customization)
+- Site-wide banner
+- Flush sidebar layout (attached to screen edge)
+- Version badge in sidebar
+
+### JBrains Docs
+
+Reference documentation style with tabbed navigation:
+- Light theme by default
+- Tab groups for organizing content (Language, Multiplatform)
+- Collapsible tree-style sidebar
+- No table of contents (right panel)
+- Flush sidebar layout
+- Version badge in sidebar
+
+## Examples
+
+Create a new project with interactive prompts:
+
+```bash
+npx create-specra
+```
+
+Create a project with the minimal template using npm:
+
+```bash
+npx create-specra my-docs --template minimal --use-npm
+```
+
+Create a project with the book-docs template:
+
+```bash
+npx create-specra my-docs --template book-docs
+```
+
+Create a project and skip installation:
+
+```bash
+npx create-specra my-docs --skip-install
+```
+
+## What's Created
+
+The CLI creates a new SvelteKit project with Specra pre-configured:
+
+```
+my-docs/
+├── src/
+│   ├── routes/
+│   │   ├── +layout.svelte
+│   │   ├── +page.svelte
+│   │   └── docs/
+│   │       └── [version]/[...slug]/
+│   │           ├── +page.svelte
+│   │           └── +page.ts
+│   └── app.html
+├── docs/
+│   └── v1.0.0/
+│       └── index.mdx
+├── static/
+├── specra.config.json
+├── svelte.config.js
+├── vite.config.ts
+└── package.json
+```
+
+## After Creation
+
+Once your project is created, you can:
+
+1. Start the development server:
+   ```bash
+   cd my-docs
+   npm run dev
+   ```
+
+2. Open [http://localhost:5173](http://localhost:5173) in your browser
+
+3. Edit your documentation in the `docs/` directory
+
+4. Customize your site in `specra.config.json`
+
+## Deployment
+
+Specra projects are standard SvelteKit apps, so you can deploy anywhere SvelteKit runs.
+
+### Static Hosting (Vercel, Netlify, Cloudflare Pages)
+
+Install the appropriate SvelteKit adapter:
+
+```bash
+# Vercel
+npm install -D @sveltejs/adapter-vercel
+
+# Netlify
+npm install -D @sveltejs/adapter-netlify
+
+# Cloudflare Pages
+npm install -D @sveltejs/adapter-cloudflare
+```
+
+Update `svelte.config.js` to use the adapter:
+
+```js
+import adapter from '@sveltejs/adapter-vercel'; // or adapter-netlify, etc.
+
+export default {
+  kit: {
+    adapter: adapter()
+  }
+};
+```
+
+Then push to your Git provider — the platform handles the rest.
+
+### Node Server (VPS, Docker, Railway)
+
+Use `@sveltejs/adapter-node` (included by default):
+
+```bash
+npm run build
+node build
+```
+
+The server listens on port 3000 by default. Configure with environment variables:
+
+```bash
+PORT=8080 HOST=0.0.0.0 node build
+```
+
+### Static Site Generation
+
+For fully static docs with no server needed:
+
+```bash
+npm install -D @sveltejs/adapter-static
+```
+
+Update `svelte.config.js`:
+
+```js
+import adapter from '@sveltejs/adapter-static';
+
+export default {
+  kit: {
+    adapter: adapter({
+      fallback: '404.html'
+    })
+  }
+};
+```
+
+```bash
+npm run build
+```
+
+Upload the `build/` directory to any static host (GitHub Pages, S3, etc.).
+
+## Learn More
+
+- [Specra on npm](https://www.npmjs.com/package/specra)
+- [SvelteKit Documentation](https://svelte.dev/docs/kit)
+- [MDX Documentation](https://mdxjs.com)
+
+## License
+
+MIT with Branding Requirement — see [LICENSE.MD](LICENSE.MD).
+
+All documentation sites generated with create-specra display a "Powered by Specra" watermark by default. Removing the watermark requires an active paid subscription (Starter tier or above) at [specra-docs.com](https://specra-docs.com). Unauthorized removal is a copyright violation.
+
+## Authors
+
+dalmasonto, arthur-kamau

package/dist/api-client-VHQARPDT.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import {
+  ApiError,
+  apiRequest,
+  apiUpload,
+  formatError
+} from "./chunk-72RDEJR2.js";
+import "./chunk-5765WX4D.js";
+export {
+  ApiError,
+  apiRequest,
+  apiUpload,
+  formatError
+};
+//# sourceMappingURL=api-client-VHQARPDT.js.map

package/dist/api-client-VHQARPDT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-5765WX4D.js

@@ -0,0 +1,192 @@
+#!/usr/bin/env node
+
+// src/config.ts
+import { readFileSync, writeFileSync, mkdirSync, existsSync, unlinkSync } from "fs";
+import { join, resolve } from "path";
+import { homedir } from "os";
+var GLOBAL_CONFIG_DIR = join(homedir(), ".specra");
+var GLOBAL_CONFIG_FILE = join(GLOBAL_CONFIG_DIR, "config.json");
+var DEFAULT_TOKEN_ENV = "SPECRA_TOKEN";
+var DEFAULT_GLOBAL_CONFIG = {
+  apiUrl: "https://specra-docs.com"
+};
+function getEnvFilePath(dir) {
+  return join(resolve(dir || "."), ".env");
+}
+function readEnvFile(dir) {
+  const envPath = getEnvFilePath(dir);
+  try {
+    const content = readFileSync(envPath, "utf-8");
+    const env = {};
+    for (const line of content.split("\n")) {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith("#")) continue;
+      const eqIdx = trimmed.indexOf("=");
+      if (eqIdx === -1) continue;
+      const key = trimmed.slice(0, eqIdx).trim();
+      const value = trimmed.slice(eqIdx + 1).trim().replace(/^["']|["']$/g, "");
+      env[key] = value;
+    }
+    return env;
+  } catch {
+    return {};
+  }
+}
+function writeEnvVar(key, value, dir) {
+  const envPath = getEnvFilePath(dir);
+  let content = "";
+  try {
+    content = readFileSync(envPath, "utf-8");
+  } catch {
+  }
+  const lines = content.split("\n");
+  let found = false;
+  for (let i = 0; i < lines.length; i++) {
+    if (lines[i].trim().startsWith(`${key}=`)) {
+      lines[i] = `${key}=${value}`;
+      found = true;
+      break;
+    }
+  }
+  if (!found) {
+    if (lines.length > 0 && lines[lines.length - 1] !== "") {
+      lines.push("");
+    }
+    lines.push(`${key}=${value}`);
+  }
+  writeFileSync(envPath, lines.join("\n") + "\n");
+}
+function removeEnvVar(key, dir) {
+  const envPath = getEnvFilePath(dir);
+  try {
+    const content = readFileSync(envPath, "utf-8");
+    const lines = content.split("\n").filter((line) => !line.trim().startsWith(`${key}=`));
+    writeFileSync(envPath, lines.join("\n"));
+  } catch {
+  }
+}
+function ensureGitignore(dir) {
+  const gitignorePath = join(resolve(dir || "."), ".gitignore");
+  try {
+    let content = "";
+    try {
+      content = readFileSync(gitignorePath, "utf-8");
+    } catch {
+    }
+    if (!content.split("\n").some((line) => line.trim() === ".env")) {
+      const newline = content && !content.endsWith("\n") ? "\n" : "";
+      writeFileSync(gitignorePath, content + newline + ".env\n");
+    }
+  } catch {
+  }
+}
+function getGlobalConfig() {
+  try {
+    const raw = readFileSync(GLOBAL_CONFIG_FILE, "utf-8");
+    return { ...DEFAULT_GLOBAL_CONFIG, ...JSON.parse(raw) };
+  } catch {
+    return DEFAULT_GLOBAL_CONFIG;
+  }
+}
+function saveGlobalConfig(config) {
+  mkdirSync(GLOBAL_CONFIG_DIR, { recursive: true });
+  const current = getGlobalConfig();
+  const merged = { ...current, ...config };
+  writeFileSync(GLOBAL_CONFIG_FILE, JSON.stringify(merged, null, 2));
+}
+function clearGlobalToken() {
+  const config = getGlobalConfig();
+  delete config.token;
+  mkdirSync(GLOBAL_CONFIG_DIR, { recursive: true });
+  writeFileSync(GLOBAL_CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+function getLocalConfigPath(dir) {
+  return join(resolve(dir || "."), "specra.config.json");
+}
+function readLocalConfig(dir) {
+  const configPath = getLocalConfigPath(dir);
+  try {
+    return JSON.parse(readFileSync(configPath, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function getLocalToken(dir) {
+  const config = readLocalConfig(dir);
+  if (!config?.auth) return void 0;
+  if (config.auth.tokenEnv) {
+    const envName = config.auth.tokenEnv;
+    if (process.env[envName]) return process.env[envName];
+    const envVars = readEnvFile(dir);
+    return envVars[envName];
+  }
+  if (config.auth.source === "global") {
+    return getGlobalConfig().token;
+  }
+  return config.auth.token;
+}
+function saveLocalToken(token, dir) {
+  const configPath = getLocalConfigPath(dir);
+  if (!existsSync(configPath)) {
+    throw new Error(`specra.config.json not found in ${resolve(dir || ".")}. Are you in a Specra project?`);
+  }
+  writeEnvVar(DEFAULT_TOKEN_ENV, token, dir);
+  const config = JSON.parse(readFileSync(configPath, "utf-8"));
+  config.auth = { tokenEnv: DEFAULT_TOKEN_ENV };
+  writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+  ensureGitignore(dir);
+}
+function clearLocalToken(dir) {
+  removeEnvVar(DEFAULT_TOKEN_ENV, dir);
+  const configPath = getLocalConfigPath(dir);
+  if (!existsSync(configPath)) return;
+  try {
+    const config = JSON.parse(readFileSync(configPath, "utf-8"));
+    if (config.auth) {
+      delete config.auth;
+    }
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+  } catch {
+  }
+}
+function getToken(dir) {
+  return getLocalToken(dir) || getGlobalConfig().token;
+}
+function getConfig() {
+  return getGlobalConfig();
+}
+function isAuthenticated(dir) {
+  return !!getToken(dir);
+}
+function saveToken(token, options) {
+  if (options?.global) {
+    saveGlobalConfig({ token });
+    const configPath = getLocalConfigPath(options?.dir);
+    if (existsSync(configPath)) {
+      try {
+        const config = JSON.parse(readFileSync(configPath, "utf-8"));
+        config.auth = { source: "global" };
+        writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+      } catch {
+      }
+    }
+  } else {
+    saveLocalToken(token, options?.dir);
+  }
+}
+function clearToken(options) {
+  if (options?.global) {
+    clearGlobalToken();
+  } else {
+    clearLocalToken(options?.dir);
+  }
+}
+
+export {
+  getToken,
+  getConfig,
+  isAuthenticated,
+  saveToken,
+  clearToken
+};
+//# sourceMappingURL=chunk-5765WX4D.js.map

package/dist/chunk-5765WX4D.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts"],"sourcesContent":["import { readFileSync, writeFileSync, mkdirSync, existsSync, unlinkSync } from 'fs'\nimport { join, resolve } from 'path'\nimport { homedir } from 'os'\n\n// Global config: ~/.specra/config.json\nconst GLOBAL_CONFIG_DIR = join(homedir(), '.specra')\nconst GLOBAL_CONFIG_FILE = join(GLOBAL_CONFIG_DIR, 'config.json')\n\nconst DEFAULT_TOKEN_ENV = 'SPECRA_TOKEN'\n\ninterface GlobalConfig {\n  apiUrl: string\n  token?: string\n  defaultProject?: string\n}\n\nconst DEFAULT_GLOBAL_CONFIG: GlobalConfig = {\n  apiUrl: 'https://specra-docs.com',\n}\n\n// --------------- .env file helpers ---------------\n\nfunction getEnvFilePath(dir?: string): string {\n  return join(resolve(dir || '.'), '.env')\n}\n\nfunction readEnvFile(dir?: string): Record<string, string> {\n  const envPath = getEnvFilePath(dir)\n  try {\n    const content = readFileSync(envPath, 'utf-8')\n    const env: Record<string, string> = {}\n    for (const line of content.split('\\n')) {\n      const trimmed = line.trim()\n      if (!trimmed || trimmed.startsWith('#')) continue\n      const eqIdx = trimmed.indexOf('=')\n      if (eqIdx === -1) continue\n      const key = trimmed.slice(0, eqIdx).trim()\n      const value = trimmed.slice(eqIdx + 1).trim().replace(/^[\"']|[\"']$/g, '')\n      env[key] = value\n    }\n    return env\n  } catch {\n    return {}\n  }\n}\n\nfunction writeEnvVar(key: string, value: string, dir?: string) {\n  const envPath = getEnvFilePath(dir)\n  let content = ''\n  try {\n    content = readFileSync(envPath, 'utf-8')\n  } catch {\n    // file doesn't exist yet\n  }\n\n  const lines = content.split('\\n')\n  let found = false\n  for (let i = 0; i < lines.length; i++) {\n    if (lines[i].trim().startsWith(`${key}=`)) {\n      lines[i] = `${key}=${value}`\n      found = true\n      break\n    }\n  }\n\n  if (!found) {\n    // Ensure trailing newline before appending\n    if (lines.length > 0 && lines[lines.length - 1] !== '') {\n      lines.push('')\n    }\n    lines.push(`${key}=${value}`)\n  }\n\n  writeFileSync(envPath, lines.join('\\n') + '\\n')\n}\n\nfunction removeEnvVar(key: string, dir?: string) {\n  const envPath = getEnvFilePath(dir)\n  try {\n    const content = readFileSync(envPath, 'utf-8')\n    const lines = content.split('\\n').filter(line => !line.trim().startsWith(`${key}=`))\n    writeFileSync(envPath, lines.join('\\n'))\n  } catch {\n    // file doesn't exist, nothing to remove\n  }\n}\n\nfunction ensureGitignore(dir?: string) {\n  const gitignorePath = join(resolve(dir || '.'), '.gitignore')\n  try {\n    let content = ''\n    try {\n      content = readFileSync(gitignorePath, 'utf-8')\n    } catch {\n      // no .gitignore yet\n    }\n    if (!content.split('\\n').some(line => line.trim() === '.env')) {\n      const newline = content && !content.endsWith('\\n') ? '\\n' : ''\n      writeFileSync(gitignorePath, content + newline + '.env\\n')\n    }\n  } catch {\n    // ignore\n  }\n}\n\n// --------------- Global config ---------------\n\nexport function getGlobalConfig(): GlobalConfig {\n  try {\n    const raw = readFileSync(GLOBAL_CONFIG_FILE, 'utf-8')\n    return { ...DEFAULT_GLOBAL_CONFIG, ...JSON.parse(raw) }\n  } catch {\n    return DEFAULT_GLOBAL_CONFIG\n  }\n}\n\nexport function saveGlobalConfig(config: Partial<GlobalConfig>) {\n  mkdirSync(GLOBAL_CONFIG_DIR, { recursive: true })\n  const current = getGlobalConfig()\n  const merged = { ...current, ...config }\n  writeFileSync(GLOBAL_CONFIG_FILE, JSON.stringify(merged, null, 2))\n}\n\nexport function clearGlobalToken() {\n  const config = getGlobalConfig()\n  delete config.token\n  mkdirSync(GLOBAL_CONFIG_DIR, { recursive: true })\n  writeFileSync(GLOBAL_CONFIG_FILE, JSON.stringify(config, null, 2))\n}\n\n// --------------- Local config (specra.config.json) ---------------\n\nfunction getLocalConfigPath(dir?: string): string {\n  return join(resolve(dir || '.'), 'specra.config.json')\n}\n\nfunction readLocalConfig(dir?: string): Record<string, any> | null {\n  const configPath = getLocalConfigPath(dir)\n  try {\n    return JSON.parse(readFileSync(configPath, 'utf-8'))\n  } catch {\n    return null\n  }\n}\n\nexport function getLocalToken(dir?: string): string | undefined {\n  const config = readLocalConfig(dir)\n  if (!config?.auth) return undefined\n\n  // Env var reference: auth.tokenEnv → read from process.env, then .env file\n  if (config.auth.tokenEnv) {\n    const envName = config.auth.tokenEnv\n    if (process.env[envName]) return process.env[envName]\n    const envVars = readEnvFile(dir)\n    return envVars[envName]\n  }\n\n  // Global reference: auth.source === \"global\" → read from ~/.specra/config.json\n  if (config.auth.source === 'global') {\n    return getGlobalConfig().token\n  }\n\n  // Legacy: direct auth.token (backwards compat for existing projects)\n  return config.auth.token\n}\n\nexport function saveLocalToken(token: string, dir?: string) {\n  const configPath = getLocalConfigPath(dir)\n  if (!existsSync(configPath)) {\n    throw new Error(`specra.config.json not found in ${resolve(dir || '.')}. Are you in a Specra project?`)\n  }\n\n  // Save the actual token to .env\n  writeEnvVar(DEFAULT_TOKEN_ENV, token, dir)\n\n  // Point specra.config.json at the env var (never store raw token)\n  const config = JSON.parse(readFileSync(configPath, 'utf-8'))\n  config.auth = { tokenEnv: DEFAULT_TOKEN_ENV }\n  writeFileSync(configPath, JSON.stringify(config, null, 2) + '\\n')\n\n  // Make sure .env is gitignored\n  ensureGitignore(dir)\n}\n\nexport function clearLocalToken(dir?: string) {\n  // Remove token from .env\n  removeEnvVar(DEFAULT_TOKEN_ENV, dir)\n\n  // Clean up auth section from specra.config.json\n  const configPath = getLocalConfigPath(dir)\n  if (!existsSync(configPath)) return\n  try {\n    const config = JSON.parse(readFileSync(configPath, 'utf-8'))\n    if (config.auth) {\n      delete config.auth\n    }\n    writeFileSync(configPath, JSON.stringify(config, null, 2) + '\\n')\n  } catch {\n    // ignore parse errors\n  }\n}\n\n// --------------- Unified accessors ---------------\n\n/** Get token: checks local specra.config.json first, then global ~/.specra/config.json */\nexport function getToken(dir?: string): string | undefined {\n  return getLocalToken(dir) || getGlobalConfig().token\n}\n\n/** Get the API URL from global config */\nexport function getConfig(): GlobalConfig {\n  return getGlobalConfig()\n}\n\nexport function isAuthenticated(dir?: string): boolean {\n  return !!getToken(dir)\n}\n\n/** Save token to local .env (default) or global ~/.specra/config.json */\nexport function saveToken(token: string, options?: { global?: boolean; dir?: string }) {\n  if (options?.global) {\n    saveGlobalConfig({ token })\n    // If specra.config.json exists locally, point it at global\n    const configPath = getLocalConfigPath(options?.dir)\n    if (existsSync(configPath)) {\n      try {\n        const config = JSON.parse(readFileSync(configPath, 'utf-8'))\n        config.auth = { source: 'global' }\n        writeFileSync(configPath, JSON.stringify(config, null, 2) + '\\n')\n      } catch {\n        // ignore\n      }\n    }\n  } else {\n    saveLocalToken(token, options?.dir)\n  }\n}\n\n/** Clear token from local .env (default) or global config */\nexport function clearToken(options?: { global?: boolean; dir?: string }) {\n  if (options?.global) {\n    clearGlobalToken()\n  } else {\n    clearLocalToken(options?.dir)\n  }\n}\n\n// Legacy exports for backwards compat\nexport function saveConfig(config: Partial<GlobalConfig>) {\n  saveGlobalConfig(config)\n}\n\nexport function clearConfig() {\n  if (existsSync(GLOBAL_CONFIG_FILE)) {\n    unlinkSync(GLOBAL_CONFIG_FILE)\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-72RDEJR2.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+import {
+  getConfig,
+  getToken
+} from "./chunk-5765WX4D.js";
+
+// src/api-client.ts
+var ApiError = class extends Error {
+  constructor(status, message) {
+    super(message);
+    this.status = status;
+    this.name = "ApiError";
+  }
+};
+var STATUS_HINTS = {
+  401: "Try running `specra login` to re-authenticate.",
+  403: "You may not have permission for this action. Check your plan or project access.",
+  502: "The server is temporarily unavailable. Try again in a moment.",
+  503: "The server is temporarily unavailable. Try again in a moment."
+};
+function formatError(context, err) {
+  const prefix = context ? `${context}: ` : "";
+  if (err instanceof ApiError) {
+    const hint = STATUS_HINTS[err.status] || "";
+    return `${prefix}${err.message} (${err.status})${hint ? `
+  ${hint}` : ""}`;
+  }
+  if (err instanceof Error) {
+    return `${prefix}${err.message}`;
+  }
+  return `${prefix}${String(err)}`;
+}
+async function apiRequest(path, options = {}) {
+  const config = getConfig();
+  const token = getToken();
+  if (!token) {
+    throw new Error("Not authenticated. Run `specra login` first.");
+  }
+  const url = `${config.apiUrl}${path}`;
+  const res = await fetch(url, {
+    ...options,
+    headers: {
+      Authorization: `Bearer ${token}`,
+      ...options.headers
+    }
+  });
+  if (!res.ok) {
+    let message;
+    try {
+      const data = await res.json();
+      message = data.error || res.statusText;
+    } catch {
+      message = res.statusText;
+    }
+    throw new ApiError(res.status, message);
+  }
+  return res.json();
+}
+async function apiUpload(path, body, headers = {}) {
+  const config = getConfig();
+  const token = getToken();
+  if (!token) {
+    throw new Error("Not authenticated. Run `specra login` first.");
+  }
+  const url = `${config.apiUrl}${path}`;
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${token}`,
+      "Content-Type": "application/octet-stream",
+      ...headers
+    },
+    body
+  });
+  if (!res.ok) {
+    let message;
+    try {
+      const data = await res.json();
+      message = data.error || res.statusText;
+    } catch {
+      message = res.statusText;
+    }
+    throw new ApiError(res.status, message);
+  }
+  return res.json();
+}
+
+export {
+  ApiError,
+  formatError,
+  apiRequest,
+  apiUpload
+};
+//# sourceMappingURL=chunk-72RDEJR2.js.map

package/dist/chunk-72RDEJR2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/api-client.ts"],"sourcesContent":["import { getConfig, getToken } from './config.js'\n\nexport class ApiError extends Error {\n  constructor(public status: number, message: string) {\n    super(message)\n    this.name = 'ApiError'\n  }\n}\n\nconst STATUS_HINTS: Record<number, string> = {\n  401: 'Try running `specra login` to re-authenticate.',\n  403: 'You may not have permission for this action. Check your plan or project access.',\n  502: 'The server is temporarily unavailable. Try again in a moment.',\n  503: 'The server is temporarily unavailable. Try again in a moment.',\n}\n\n/** Format an error for CLI display (no stack traces). */\nexport function formatError(context: string, err: unknown): string {\n  const prefix = context ? `${context}: ` : ''\n  if (err instanceof ApiError) {\n    const hint = STATUS_HINTS[err.status] || ''\n    return `${prefix}${err.message} (${err.status})${hint ? `\\n  ${hint}` : ''}`\n  }\n  if (err instanceof Error) {\n    return `${prefix}${err.message}`\n  }\n  return `${prefix}${String(err)}`\n}\n\nexport async function apiRequest<T = unknown>(\n  path: string,\n  options: RequestInit = {}\n): Promise<T> {\n  const config = getConfig()\n  const token = getToken()\n\n  if (!token) {\n    throw new Error('Not authenticated. Run `specra login` first.')\n  }\n\n  const url = `${config.apiUrl}${path}`\n  const res = await fetch(url, {\n    ...options,\n    headers: {\n      Authorization: `Bearer ${token}`,\n      ...options.headers,\n    },\n  })\n\n  if (!res.ok) {\n    let message: string\n    try {\n      const data = (await res.json()) as Record<string, string>\n      message = data.error || res.statusText\n    } catch {\n      message = res.statusText\n    }\n    throw new ApiError(res.status, message)\n  }\n\n  return res.json() as Promise<T>\n}\n\nexport async function apiUpload(\n  path: string,\n  body: Buffer | ReadableStream,\n  headers: Record<string, string> = {}\n): Promise<unknown> {\n  const config = getConfig()\n  const token = getToken()\n\n  if (!token) {\n    throw new Error('Not authenticated. Run `specra login` first.')\n  }\n\n  const url = `${config.apiUrl}${path}`\n  const res = await fetch(url, {\n    method: 'POST',\n    headers: {\n      Authorization: `Bearer ${token}`,\n      'Content-Type': 'application/octet-stream',\n      ...headers,\n    },\n    body,\n  })\n\n  if (!res.ok) {\n    let message: string\n    try {\n      const data = (await res.json()) as Record<string, string>\n      message = data.error || res.statusText\n    } catch {\n      message = res.statusText\n    }\n    throw new ApiError(res.status, message)\n  }\n\n  return res.json()\n}\n"],"mappings":";;;;;;;AAEO,IAAM,WAAN,cAAuB,MAAM;AAAA,EAClC,YAAmB,QAAgB,SAAiB;AAClD,UAAM,OAAO;AADI;AAEjB,SAAK,OAAO;AAAA,EACd;AACF;AAEA,IAAM,eAAuC;AAAA,EAC3C,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AACP;AAGO,SAAS,YAAY,SAAiB,KAAsB;AACjE,QAAM,SAAS,UAAU,GAAG,OAAO,OAAO;AAC1C,MAAI,eAAe,UAAU;AAC3B,UAAM,OAAO,aAAa,IAAI,MAAM,KAAK;AACzC,WAAO,GAAG,MAAM,GAAG,IAAI,OAAO,KAAK,IAAI,MAAM,IAAI,OAAO;AAAA,IAAO,IAAI,KAAK,EAAE;AAAA,EAC5E;AACA,MAAI,eAAe,OAAO;AACxB,WAAO,GAAG,MAAM,GAAG,IAAI,OAAO;AAAA,EAChC;AACA,SAAO,GAAG,MAAM,GAAG,OAAO,GAAG,CAAC;AAChC;AAEA,eAAsB,WACpB,MACA,UAAuB,CAAC,GACZ;AACZ,QAAM,SAAS,UAAU;AACzB,QAAM,QAAQ,SAAS;AAEvB,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,8CAA8C;AAAA,EAChE;AAEA,QAAM,MAAM,GAAG,OAAO,MAAM,GAAG,IAAI;AACnC,QAAM,MAAM,MAAM,MAAM,KAAK;AAAA,IAC3B,GAAG;AAAA,IACH,SAAS;AAAA,MACP,eAAe,UAAU,KAAK;AAAA,MAC9B,GAAG,QAAQ;AAAA,IACb;AAAA,EACF,CAAC;AAED,MAAI,CAAC,IAAI,IAAI;AACX,QAAI;AACJ,QAAI;AACF,YAAM,OAAQ,MAAM,IAAI,KAAK;AAC7B,gBAAU,KAAK,SAAS,IAAI;AAAA,IAC9B,QAAQ;AACN,gBAAU,IAAI;AAAA,IAChB;AACA,UAAM,IAAI,SAAS,IAAI,QAAQ,OAAO;AAAA,EACxC;AAEA,SAAO,IAAI,KAAK;AAClB;AAEA,eAAsB,UACpB,MACA,MACA,UAAkC,CAAC,GACjB;AAClB,QAAM,SAAS,UAAU;AACzB,QAAM,QAAQ,SAAS;AAEvB,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,8CAA8C;AAAA,EAChE;AAEA,QAAM,MAAM,GAAG,OAAO,MAAM,GAAG,IAAI;AACnC,QAAM,MAAM,MAAM,MAAM,KAAK;AAAA,IAC3B,QAAQ;AAAA,IACR,SAAS;AAAA,MACP,eAAe,UAAU,KAAK;AAAA,MAC9B,gBAAgB;AAAA,MAChB,GAAG;AAAA,IACL;AAAA,IACA;AAAA,EACF,CAAC;AAED,MAAI,CAAC,IAAI,IAAI;AACX,QAAI;AACJ,QAAI;AACF,YAAM,OAAQ,MAAM,IAAI,KAAK;AAC7B,gBAAU,KAAK,SAAS,IAAI;AAAA,IAC9B,QAAQ;AACN,gBAAU,IAAI;AAAA,IAChB;AACA,UAAM,IAAI,SAAS,IAAI,QAAQ,OAAO;AAAA,EACxC;AAEA,SAAO,IAAI,KAAK;AAClB;","names":[]}