xapi-to 0.1.13 → 0.1.14

package/src/commands/action.ts

@@ -1,328 +0,0 @@
-/**
- * Top-level action commands: list, search, categories, services, get, call
- * Unified interface for all actions (capabilities + APIs).
- * Use --source capability|api to filter by source type.
- */
-
-import { getConfig, requireApiKey } from '../config.ts';
-import * as client from '../client.ts';
-import { output, err, getFormat } from '../format.ts';
-import { generateCode, buildDefaultInput, resolveTarget } from '../codegen.ts';
-
-const VALID_SOURCES = ['capability', 'api'];
-
-// ── Subcommand help texts ────────────────────────────────────────────────────
-
-const LIST_HELP = `xapi list - List all actions
-
-USAGE
-  xapi list [flags]
-
-FLAGS
-  --source capability|api   Filter by source type
-  --category <name>         Filter by category
-  --service-id <id>         Filter by service
-  --page N                  Page number (default: 1)
-  --page-size N             Results per page
-  --format json|pretty|table  Output format
-
-EXAMPLES
-  xapi list
-  xapi list --source api --format table
-  xapi list --category social --page 2
-`;
-
-const SEARCH_HELP = `xapi search - Search actions by keyword
-
-USAGE
-  xapi search <query> [flags]
-
-FLAGS
-  --source capability|api   Filter by source type
-  --category <name>         Filter by category
-  --page N                  Page number (default: 1)
-  --page-size N             Results per page
-  --format json|pretty|table  Output format
-
-EXAMPLES
-  xapi search twitter
-  xapi search "tweet detail" --source api
-  xapi search weather --category utility --format table
-`;
-
-const GET_HELP = `xapi get - Get action schema
-
-USAGE
-  xapi get <id> [flags]
-
-FLAGS
-  --method GET|POST|...     Filter by HTTP method
-  --code <target>           Generate code snippet instead of showing schema
-  --format json|pretty|table  Output format
-
-CODE TARGETS
-  curl                      cURL command
-  py, python                Python (requests)
-  python.requests           Python with requests
-  py.requests               alias for python.requests
-  python.httpx              Python with httpx
-  py.httpx                  alias for python.httpx
-  js, javascript            JavaScript (fetch)
-  javascript.fetch          JavaScript with fetch
-  js.fetch                  alias for javascript.fetch
-  javascript.axios          JavaScript with axios
-  js.axios                  alias for javascript.axios
-  ts, typescript            TypeScript (fetch)
-  typescript.fetch          TypeScript with fetch
-  ts.fetch                  alias for typescript.fetch
-  go                        Go (net/http)
-
-EXAMPLES
-  xapi get twitter.tweet_detail
-  xapi get twitter.tweet_detail --method POST
-  xapi get twitter.tweet_detail --code curl
-  xapi get twitter.tweet_detail --code python.httpx --format pretty
-`;
-
-const CALL_HELP = `xapi call - Execute an action
-
-USAGE
-  xapi call <id> --input '{"key":"val"}' [flags]
-
-FLAGS
-  --input <json>            Input payload as JSON (required for execution)
-  --method GET|POST|...     Override HTTP method
-  --code <target>           Generate code snippet instead of executing
-  --format json|pretty|table  Output format
-
-CODE TARGETS
-  curl                      cURL command
-  py, python                Python (requests)
-  python.requests           Python with requests
-  py.requests               alias for python.requests
-  python.httpx              Python with httpx
-  py.httpx                  alias for python.httpx
-  js, javascript            JavaScript (fetch)
-  javascript.fetch          JavaScript with fetch
-  js.fetch                  alias for javascript.fetch
-  javascript.axios          JavaScript with axios
-  js.axios                  alias for javascript.axios
-  ts, typescript            TypeScript (fetch)
-  typescript.fetch          TypeScript with fetch
-  ts.fetch                  alias for typescript.fetch
-  go                        Go (net/http)
-
-EXAMPLES
-  xapi call twitter.tweet_detail --input '{"tweet_id":"1234567890"}'
-  xapi call twitter.tweet_detail --input '{"tweet_id":"123"}' --code py
-  xapi call twitter.tweet_detail --input '{"tweet_id":"123"}' --code curl --format pretty
-`;
-
-/** Print subcommand help and exit if --help flag is set */
-function showHelpIfRequested(flags: Record<string, string>, helpText: string): void {
-  if (flags.help) {
-    console.log(helpText);
-    process.exit(0);
-  }
-}
-
-/** Validate --code flag: check for bare flag and unknown target (fail fast before I/O) */
-function validateCodeFlag(flags: Record<string, string>): void {
-  if (flags.code === 'true') {
-    err('--code requires a target language, e.g. --code curl, --code py, --code js');
-  }
-  resolveTarget(flags.code);
-}
-
-/** Output code snippet respecting --format */
-function outputCode(result: { lang: string; lib: string; code: string }, flags: Record<string, string>) {
-  const fmt = flags.format || getFormat();
-  if (fmt === 'json') {
-    output({ language: result.lang, library: result.lib, code: result.code }, 'json');
-  } else {
-    console.log(result.code);
-  }
-}
-
-/** Validate and return source filter from --source flag */
-function getSource(flags: Record<string, string>): string | undefined {
-  if (!flags.source) return undefined;
-  if (!VALID_SOURCES.includes(flags.source)) {
-    err(`invalid --source value: "${flags.source}". Must be "capability" or "api".`);
-  }
-  return flags.source;
-}
-
-export async function actionList(args: string[], flags: Record<string, string>) {
-  showHelpIfRequested(flags, LIST_HELP);
-  const cfg = getConfig();
-  try {
-    const res = await client.actionList(cfg, {
-      source: getSource(flags),
-      page: flags.page ? parseInt(flags.page) : undefined,
-      page_size: flags['page-size'] ? parseInt(flags['page-size']) : undefined,
-      category: flags.category,
-      service_id: flags['service-id'],
-    });
-    const actions = (res.actions || []) as any[];
-    if (flags.format === 'table') {
-      output(actions.map((a: any) => ({
-        id: a.id,
-        method: a.method ?? '',
-        displayName: a.displayName ?? '',
-        source: a.source ?? '',
-        category: a.meta?.category ?? '',
-        status: a.status ?? '',
-        cost: a.meta?.cost ?? '',
-      })), 'table');
-    } else {
-      output(res, flags.format as any);
-    }
-  } catch (e: any) {
-    err('list failed', e.message);
-  }
-}
-
-export async function actionSearch(args: string[], flags: Record<string, string>) {
-  showHelpIfRequested(flags, SEARCH_HELP);
-  const query = args[0];
-  if (!query) err('usage: xapi search <query>');
-  const cfg = getConfig();
-  try {
-    const res = await client.actionSearch(query, cfg, {
-      source: getSource(flags),
-      category: flags.category,
-      page: flags.page ? parseInt(flags.page) : undefined,
-      page_size: flags['page-size'] ? parseInt(flags['page-size']) : undefined,
-    });
-    const results = (res.results || []) as any[];
-    if (flags.format === 'table') {
-      output(results.map((a: any) => ({
-        id: a.id,
-        method: a.method ?? '',
-        displayName: a.displayName ?? '',
-        source: a.source ?? '',
-        category: a.meta?.category ?? '',
-        status: a.status ?? '',
-        cost: a.meta?.cost ?? '',
-      })), 'table');
-    } else {
-      output(res, flags.format as any);
-    }
-  } catch (e: any) {
-    err('search failed', e.message);
-  }
-}
-
-export async function actionCategories(args: string[], flags: Record<string, string>) {
-  const cfg = getConfig();
-  try {
-    const res = await client.actionCategories(cfg, { source: getSource(flags) });
-    if (flags.format === 'table') {
-      output(res.categories.map(c => ({ category: c })), 'table');
-    } else {
-      output(res, flags.format as any);
-    }
-  } catch (e: any) {
-    err('categories failed', e.message);
-  }
-}
-
-export async function actionServices(args: string[], flags: Record<string, string>) {
-  const cfg = getConfig();
-  try {
-    const res = await client.actionServices(cfg, {
-      page: flags.page ? parseInt(flags.page) : undefined,
-      page_size: flags['page-size'] ? parseInt(flags['page-size']) : undefined,
-      category: flags.category,
-    });
-    const services = (res.services || []) as any[];
-    if (flags.format === 'table') {
-      output(services.map((s: any) => ({
-        id: s.id,
-        name: s.name ?? '',
-        category: s.category ?? '',
-        source: s.source ?? '',
-        endpoints: s.endpointCount ?? '',
-        status: s.status ?? '',
-      })), 'table');
-    } else {
-      output(res, flags.format as any);
-    }
-  } catch (e: any) {
-    err('services failed', e.message);
-  }
-}
-
-export async function actionGet(args: string[], flags: Record<string, string>) {
-  showHelpIfRequested(flags, GET_HELP);
-  const id = args[0];
-  if (!id) err('usage: xapi get <id> [--method GET|POST|DELETE|...]');
-  if (flags.code) validateCodeFlag(flags);
-  const cfg = getConfig();
-  try {
-    const res = await client.actionGet(id, cfg);
-    const actions = Array.isArray(res) ? res : [res];
-    const methodFilter = flags.method?.toUpperCase();
-    const filtered = methodFilter
-      ? actions.filter((a: any) => a.method?.toUpperCase() === methodFilter)
-      : actions;
-    if (filtered.length === 0) {
-      err(`no endpoint found for method "${methodFilter}" in action "${id}"`);
-    }
-
-    if (flags.code) {
-      if (filtered.length > 1) {
-        process.stderr.write(
-          `Warning: action "${id}" has ${filtered.length} endpoints; using method "${(filtered[0] as any).method}". Use --method to select a specific one.\n`,
-        );
-      }
-      const action = filtered[0] as any;
-      const { method: _schemaMethod, ...cleanCodeInput } = buildDefaultInput(action.input ?? {});
-      const result = generateCode(flags.code, { actionId: id, input: cleanCodeInput, actionHost: cfg.actionHost, method: action.method });
-      outputCode(result, flags);
-      return;
-    }
-
-    output(filtered.length === 1 ? filtered[0] : filtered, flags.format as any);
-  } catch (e: any) {
-    err('get failed', e.message);
-  }
-}
-
-export async function actionCall(args: string[], flags: Record<string, string>) {
-  showHelpIfRequested(flags, CALL_HELP);
-  const id = args[0];
-  if (!id) err('usage: xapi call <id> --input \'{"key":"val"}\'');
-  if (flags.code) validateCodeFlag(flags);
-  const cfg = getConfig();
-  let input: Record<string, unknown> = {};
-  if (flags.input) {
-    try {
-      input = JSON.parse(flags.input);
-    } catch {
-      err('--input must be valid JSON');
-    }
-    if (typeof input !== 'object' || input === null || Array.isArray(input)) {
-      err('--input must be a JSON object');
-    }
-  }
-  // method 作为独立参数传递，兼容 input 内的 method
-  const { method: inputMethod, ...cleanInput } = input;
-  const method = flags.method?.toUpperCase()
-    || (typeof inputMethod === 'string' ? inputMethod.toUpperCase() : undefined);
-
-  if (flags.code) {
-    const result = generateCode(flags.code, { actionId: id, input: cleanInput, actionHost: cfg.actionHost, method });
-    outputCode(result, flags);
-    return;
-  }
-
-  requireApiKey(cfg);
-  try {
-    const res = await client.actionCall(id, cleanInput, cfg, method);
-    output(res, flags.format as any);
-  } catch (e: any) {
-    err('call failed', e.message);
-  }
-}

package/src/commands/balance.ts

@@ -1,35 +0,0 @@
-/**
- * balance command
- * Fetches balance from GET /auth/me
- */
-
-import { getConfig, requireApiKey, XAPI_API_HOST, scheme } from '../config.ts';
-import { loginWithApiKey, request } from '../client.ts';
-import { output, err } from '../format.ts';
-
-export async function balance(args: string[], flags: Record<string, string>) {
-  const cfg = getConfig();
-  requireApiKey(cfg);
-
-  let token: string;
-  try {
-    const res = await loginWithApiKey(cfg.apiKey!, XAPI_API_HOST);
-    token = res.accessToken;
-  } catch (e: any) {
-    err('login failed', e.message);
-  }
-
-  try {
-    const me = await request<{ balance: string; accountType: string; tier: string }>(
-      `${scheme(XAPI_API_HOST)}://${XAPI_API_HOST}/api/auth/me`,
-      { method: 'GET', headers: { Authorization: `Bearer ${token!}` } },
-    );
-    output({
-      balance: me.balance,
-      accountType: me.accountType,
-      tier: me.tier,
-    }, flags.format as any);
-  } catch (e: any) {
-    err('balance fetch failed', e.message);
-  }
-}

package/src/commands/config.ts

@@ -1,58 +0,0 @@
-/**
- * config commands: show, set, health
- */
-
-import { getConfig, saveConfig, showConfig } from '../config.ts';
-import { healthCheck } from '../client.ts';
-import { output, err } from '../format.ts';
-
-export const CONFIG_HELP = `xapi config - Manage CLI configuration
-
-USAGE
-  xapi config <command> [flags]
-
-COMMANDS
-  show                       Show current config (host, apiKey path, etc.)
-  set apiKey=<key>           Save API key to ~/.xapi/config.json
-  health                     Check backend connectivity (alias: xapi health)
-
-FLAGS
-  --format json|pretty|table   Output format
-
-EXAMPLES
-  xapi config show
-  xapi config set apiKey=xapi_abc123
-  xapi config health
-`;
-
-export async function configShow(args: string[], flags: Record<string, string>) {
-  showConfig();
-}
-
-export async function configSet(args: string[], flags: Record<string, string>) {
-  // xapi config set apiKey=xapi_xxx
-  if (args.length === 0) err('usage: xapi config set apiKey=<key>');
-  const updates: { apiKey?: string } = {};
-  for (const arg of args) {
-    const eq = arg.indexOf('=');
-    if (eq < 1) err(`invalid key=value: ${arg}`);
-    const key = arg.slice(0, eq);
-    if (key === 'host') err('host is built-in and cannot be configured');
-    if (key !== 'apiKey') err(`unknown config key: ${key} (only apiKey is configurable)`);
-    updates.apiKey = arg.slice(eq + 1);
-  }
-  saveConfig(updates);
-  console.log(JSON.stringify({ ok: true, updated: Object.keys(updates) }));
-}
-
-export async function configHealth(args: string[], flags: Record<string, string>) {
-  const cfg = getConfig();
-  const start = Date.now();
-  try {
-    await healthCheck(cfg);
-    output({ status: 'ok', host: cfg.actionHost, latency_ms: Date.now() - start }, flags.format as any);
-  } catch (e: any) {
-    output({ status: 'error', host: cfg.actionHost, error: e.message }, flags.format as any);
-    process.exit(1);
-  }
-}