xapi-to 0.1.12 → 0.1.14

package/src/commands/register.ts

@@ -1,59 +0,0 @@
-/**
- * register command: create a new user account
- *
- * POST /auth/register — no auth required
- * Returns apiKey (shown once), claimCode, claimUrl, tweetTemplate
- * Automatically saves apiKey to ~/.xapi/config.json
- */
-
-import { XAPI_API_HOST, saveConfig, scheme } from '../config.ts';
-import { output, err } from '../format.ts';
-
-async function registerAccount() {
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), 15_000);
-  try {
-    const res = await fetch(`${scheme(XAPI_API_HOST)}://${XAPI_API_HOST}/api/auth/register`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      signal: controller.signal,
-    });
-    if (!res.ok) {
-      const text = await res.text();
-      throw new Error(`HTTP ${res.status}: ${text.slice(0, 300)}`);
-    }
-    return res.json() as Promise<{
-      apiKey: string;
-      claimCode: string;
-      claimSessionId: string;
-      claimUrl: string;
-      tweetTemplate: string;
-      user: { id: string; accountType: string };
-    }>;
-  } finally {
-    clearTimeout(timer);
-  }
-}
-
-export async function register(args: string[], flags: Record<string, string>) {
-  try {
-    const res = await registerAccount();
-
-    // auto-save apiKey
-    saveConfig({ apiKey: res.apiKey });
-
-    output({
-      apiKey: res.apiKey,
-      user: res.user,
-      claim: {
-        code: res.claimCode,
-        sessionId: res.claimSessionId,
-        url: res.claimUrl,
-      },
-      tweetTemplate: res.tweetTemplate,
-      note: 'apiKey saved to ~/.xapi/config.json',
-    }, flags.format as any);
-  } catch (e: any) {
-    err('register failed', e.message);
-  }
-}

package/src/commands/topup.ts

@@ -1,33 +0,0 @@
-/**
- * topup command
- *
- * Generates a payment URL pointing to the xapi frontend topup page.
- * All params are optional.
- *
- * Usage:
- *   xapi topup [--amount <usd>] [--method stripe|x402]
- */
-
-import { getConfig } from '../config.ts';
-import { output } from '../format.ts';
-
-const TOPUP_BASE_URL = 'https://www.xapi.to/topup/payment';
-
-export async function topup(args: string[], flags: Record<string, string>) {
-  const cfg = getConfig();
-
-  const url = new URL(TOPUP_BASE_URL);
-
-  if (cfg.apiKey) url.searchParams.set('apikey', cfg.apiKey);
-  if (flags.method) url.searchParams.set('method', flags.method);
-
-  const amountStr = flags.amount || args[0];
-  if (amountStr) {
-    const amountUsd = parseFloat(amountStr);
-    if (!isNaN(amountUsd) && amountUsd > 0) {
-      url.searchParams.set('amount', String(amountUsd));
-    }
-  }
-
-  output({ url: url.toString() }, flags.format as any);
-}

package/src/config.ts

@@ -1,69 +0,0 @@
-/**
- * Config management
- * Only apiKey is user-configurable. Host is built-in.
- * Reads from env var XAPI_KEY or ~/.xapi/config.json
- */
-
-import { existsSync, readFileSync, writeFileSync, mkdirSync, chmodSync } from 'fs';
-import { err } from './format.ts';
-import { homedir } from 'os';
-import { join } from 'path';
-
-export const XAPI_ACTION_HOST = process.env.XAPI_ACTION_HOST || 'action.xapi.to'; // action service (capabilities + APIs)
-export const XAPI_API_HOST = process.env.XAPI_API_HOST || 'api.xapi.to';          // auth + agent API
-
-/** Returns https:// for remote hosts, http:// for localhost */
-export function scheme(host: string): string {
-  return host.startsWith('localhost') || host.startsWith('127.') ? 'http' : 'https';
-}
-
-export interface XapiConfig {
-  actionHost: string;
-  apiKey?: string;
-}
-
-const CONFIG_DIR = join(homedir(), '.xapi');
-const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
-
-function loadFileConfig(): { apiKey?: string } {
-  if (!existsSync(CONFIG_FILE)) return {};
-  try {
-    return JSON.parse(readFileSync(CONFIG_FILE, 'utf-8'));
-  } catch {
-    return {};
-  }
-}
-
-export function getConfig(): XapiConfig {
-  const file = loadFileConfig();
-  return {
-    actionHost: XAPI_ACTION_HOST,
-    apiKey: process.env.XAPI_KEY || process.env.XAPI_API_KEY || file.apiKey,
-  };
-}
-
-export function requireApiKey(cfg: XapiConfig): void {
-  if (!cfg.apiKey) {
-    err('API key not configured', 'Run "npx xapi-to register" to create an account, or "npx xapi-to config set apiKey=<key>" to set an existing key.');
-  }
-}
-
-export function saveConfig(updates: { apiKey?: string }): void {
-  const current = loadFileConfig();
-  const merged = { ...current, ...updates };
-  if (!existsSync(CONFIG_DIR)) mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
-  writeFileSync(CONFIG_FILE, JSON.stringify(merged, null, 2), { mode: 0o600 });
-}
-
-export function showConfig(): void {
-  const cfg = getConfig();
-  const file = loadFileConfig();
-  console.log(JSON.stringify({
-    actionHost: cfg.actionHost,
-    apiKey: cfg.apiKey ? `${cfg.apiKey.slice(0, 8)}...` : undefined,
-    source: {
-      apiKey: (process.env.XAPI_KEY || process.env.XAPI_API_KEY) ? 'env' : file.apiKey ? 'file' : 'none',
-    },
-    configFile: CONFIG_FILE,
-  }, null, 2));
-}

package/src/format.ts

@@ -1,61 +0,0 @@
-/**
- * Output formatting
- * Supports: json (default, machine-readable), pretty (human-readable), table
- */
-
-export type OutputFormat = 'json' | 'pretty' | 'table';
-
-export function getFormat(): OutputFormat {
-  const f = process.env.XAPI_OUTPUT || 'json';
-  if (f === 'pretty' || f === 'table') return f;
-  return 'json';
-}
-
-export function output(data: unknown, format?: OutputFormat): void {
-  const fmt = format || getFormat();
-  if (fmt === 'json') {
-    console.log(JSON.stringify(data));
-    return;
-  }
-  if (fmt === 'pretty') {
-    console.log(JSON.stringify(data, null, 2));
-    return;
-  }
-  // table: try to render arrays of objects as a table
-  if (fmt === 'table' && Array.isArray(data)) {
-    printTable(data as Record<string, unknown>[]);
-    return;
-  }
-  console.log(JSON.stringify(data, null, 2));
-}
-
-function printTable(rows: Record<string, unknown>[]): void {
-  if (rows.length === 0) {
-    console.log('(empty)');
-    return;
-  }
-  const keys = Object.keys(rows[0]);
-  const widths = keys.map(k =>
-    Math.min(40, Math.max(k.length, ...rows.map(r => String(r[k] ?? '').length)))
-  );
-  const sep = widths.map(w => '-'.repeat(w)).join('  ');
-  const header = keys.map((k, i) => k.padEnd(widths[i])).join('  ');
-  console.log(header);
-  console.log(sep);
-  for (const row of rows) {
-    const line = keys.map((k, i) => String(row[k] ?? '').slice(0, widths[i]).padEnd(widths[i])).join('  ');
-    console.log(line);
-  }
-}
-
-export function err(msg: string, detail?: unknown): never {
-  if (process.stderr.isTTY) {
-    console.error(`Error: ${msg}`);
-    if (detail !== undefined) console.error(`  ${detail}`);
-  } else {
-    const out: Record<string, unknown> = { error: msg };
-    if (detail !== undefined) out.detail = detail;
-    console.error(JSON.stringify(out));
-  }
-  process.exit(1);
-}

package/src/index.ts

@@ -1,205 +0,0 @@
-#!/usr/bin/env bun
-/**
- * xapi CLI - agent-friendly command-line interface for xapi
- *
- * Usage:
- *   xapi list [--source capability|api] [--page N] [--page-size N] [--category X]
- *   xapi search <query> [--source capability|api] [--category X] [--page N] [--page-size N]
- *   xapi categories [--source capability|api]
- *   xapi services [--page N] [--page-size N] [--category X]
- *   xapi get <id> [--code curl|py|js|ts|go]
- *   xapi call <id> --input '{"k":"v"}' [--code curl|py|js|ts|go]
- *
- *   xapi config show
- *   xapi config set apiKey=<key>
- *   xapi health
- *
- * Global flags:
- *   --format json|pretty|table   output format (default: json)
- *   --help                       show help
- *
- * Env vars:
- *   XAPI_KEY       API key
- *   XAPI_ACTION_HOST   Action service host (default: action.xapi.to)
- *   XAPI_OUTPUT        default output format (json|pretty|table)
- */
-
-import * as actionCmds from './commands/action.ts';
-import * as cfgCmds from './commands/config.ts';
-import * as regCmds from './commands/register.ts';
-import * as topupCmds from './commands/topup.ts';
-import * as balanceCmds from './commands/balance.ts';
-import * as oauthCmds from './commands/oauth.ts';
-const { OAUTH_HELP } = oauthCmds;
-
-// ── Argument parser ───────────────────────────────────────────────────────────
-
-interface ParsedArgs {
-  positional: string[];
-  flags: Record<string, string>;
-}
-
-function parseArgs(argv: string[]): ParsedArgs {
-  const positional: string[] = [];
-  const flags: Record<string, string> = {};
-  let i = 0;
-  while (i < argv.length) {
-    const arg = argv[i];
-    if (arg.startsWith('--')) {
-      const key = arg.slice(2);
-      const next = argv[i + 1];
-      if (next && !next.startsWith('--')) {
-        flags[key] = next;
-        i += 2;
-      } else {
-        flags[key] = 'true';
-        i++;
-      }
-    } else {
-      positional.push(arg);
-      i++;
-    }
-  }
-  return { positional, flags };
-}
-
-// ── Help ──────────────────────────────────────────────────────────────────────
-
-const HELP = `xapi - agent-friendly CLI for xapi
-
-USAGE
-  xapi <command> [args] [flags]
-
-COMMANDS
-  list                              List all actions
-    --source capability|api         Filter by source type
-    --page N  --page-size N         Pagination
-    --category <name>               Filter by category
-    --service-id <id>               Filter by service
-  search <query>                    Search actions by keyword
-    --source capability|api         Filter by source type
-    --category <name>               Filter by category
-    --page N  --page-size N         Pagination
-  categories                        List all action categories
-    --source capability|api         Filter by source type
-  services                          List all services
-    --page N  --page-size N         Pagination
-    --category <name>               Filter by category
-  get <id> [--method GET|POST|...]   Get action schema (filter by HTTP method)
-    --code <target>                  Generate code snippet (curl, py, js, ts, go)
-  call <id> --input '{"key":"val"}'  Execute an action
-    --method GET|POST|...            Override HTTP method
-    --code <target>                  Generate code snippet instead of executing
-    Variants: python.requests, python.httpx, javascript.fetch, javascript.axios
-
-  oauth bind [--provider twitter]   Bind Twitter OAuth to your API key
-  oauth status                      List current OAuth bindings
-  oauth unbind <binding-id>         Remove an OAuth binding
-  oauth providers                   List available OAuth providers
-
-  register                          Create a new user account (apiKey saved automatically)
-  balance                           Show current account balance
-  topup [--amount <usd>] [--method stripe|x402]   Generate payment URL
-
-  health                            Check backend connectivity
-
-  config show                       Show current config
-  config set apiKey=<key>           Save API key to ~/.xapi/config.json
-
-GLOBAL FLAGS
-  --format json|pretty|table        Output format (default: json)
-  --help                            Show help (use with a command for details, e.g. xapi get --help)
-
-ENV VARS
-  XAPI_KEY       API key (header: XAPI-Key)
-  XAPI_ACTION_HOST   Action service host (default: action.xapi.to)
-  XAPI_OUTPUT        Default output format
-
-EXAMPLES
-  xapi register
-  xapi list --format table
-  xapi list --source capability
-  xapi search twitter --source api
-  xapi get twitter.tweet_detail
-  xapi get twitter.tweet_detail --code curl
-  xapi get twitter.tweet_detail --code py --format pretty
-  xapi call twitter.tweet_detail --input '{"tweet_id":"1234567890"}'
-  xapi call twitter.tweet_detail --input '{"tweet_id":"1234567890"}' --code python
-  xapi categories
-  xapi services --format table
-  xapi config set apiKey=xapi_abc123
-  xapi health
-`;
-
-// ── Router ────────────────────────────────────────────────────────────────────
-
-async function main() {
-  const { positional, flags } = parseArgs(process.argv.slice(2));
-
-  if (positional.length === 0) {
-    console.log(HELP);
-    process.exit(0);
-  }
-
-  // inject format from flag into env so format.ts picks it up
-  if (flags.format) process.env.XAPI_OUTPUT = flags.format;
-
-  const [cmd, ...rest] = positional;
-
-  switch (cmd) {
-    // ── Action commands (top-level) ──
-    case 'list':       return actionCmds.actionList(rest, flags);
-    case 'search':     return actionCmds.actionSearch(rest, flags);
-    case 'categories': return actionCmds.actionCategories(rest, flags);
-    case 'services':   return actionCmds.actionServices(rest, flags);
-    case 'get':        return actionCmds.actionGet(rest, flags);
-    case 'call':       return actionCmds.actionCall(rest, flags);
-
-    // ── OAuth commands ──
-    case 'oauth': {
-      if (flags.help || rest.length === 0) {
-        console.log(OAUTH_HELP);
-        process.exit(0);
-      }
-      const [subCmd, ...subRest] = rest;
-      switch (subCmd) {
-        case 'bind':      return oauthCmds.oauthBind(subRest, flags);
-        case 'status':    return oauthCmds.oauthStatus(subRest, flags);
-        case 'unbind':    return oauthCmds.oauthUnbind(subRest, flags);
-        case 'providers': return oauthCmds.oauthProviders(subRest, flags);
-        default:
-          console.error(JSON.stringify({ error: `unknown oauth command: ${subCmd}`, hint: 'valid commands: bind, status, unbind, providers' }));
-          process.exit(1);
-      }
-      break;
-    }
-
-    // ── Account commands ──
-    case 'register':   return regCmds.register(rest, flags);
-    case 'balance':    return balanceCmds.balance(rest, flags);
-    case 'topup':      return topupCmds.topup(rest, flags);
-    case 'health':     return cfgCmds.configHealth(rest, flags);
-
-    // ── Config commands ──
-    case 'config': {
-      const [subCmd, ...subRest] = rest;
-      switch (subCmd) {
-        case 'show':   return cfgCmds.configShow(subRest, flags);
-        case 'set':    return cfgCmds.configSet(subRest, flags);
-        default:
-          console.error(JSON.stringify({ error: `unknown config command: ${subCmd}` }));
-          process.exit(1);
-      }
-      break;
-    }
-
-    default:
-      console.error(JSON.stringify({ error: `unknown command: ${cmd}`, hint: 'run xapi --help' }));
-      process.exit(1);
-  }
-}
-
-main().catch(e => {
-  console.error(JSON.stringify({ error: 'fatal', message: e.message }));
-  process.exit(1);
-});