xapi-to 0.1.12 → 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,39 +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 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);
-  }
-}

package/src/commands/oauth.ts

@@ -1,297 +0,0 @@
-/**
- * oauth commands: bind, status, unbind
- *
- * Flow for `xapi oauth bind [--provider twitter]`:
- *  1. Login with current API key → get JWT
- *  2. List API keys → find the one matching the current key by prefix
- *  3. Enable OAuth on the key if not already (POST /keys/:id/enable-oauth)
- *  4. List OAuth providers → find the requested provider
- *  5. POST /oauth/authorize → get authorizationUrl
- *  6. Open browser (macOS/Linux/Windows) and poll for binding completion
- *
- * `xapi oauth status`: list current OAuth bindings for the API key
- * `xapi oauth unbind <binding-id>`: delete an OAuth binding
- */
-
-import { spawnSync } from 'child_process';
-import { XAPI_API_HOST, getConfig, requireApiKey } from '../config.ts';
-import {
-  loginWithApiKey,
-  listKeys,
-  enableOAuthForKey,
-  listOAuthProviders,
-  initiateOAuth,
-  listOAuthBindings,
-  deleteOAuthBinding,
-} from '../client.ts';
-import { output, err } from '../format.ts';
-
-/** Try to open a URL in the default browser. Silent on failure. */
-function openBrowser(url: string): void {
-  const cmd = process.platform === 'win32' ? 'start'
-    : process.platform === 'darwin' ? 'open'
-    : 'xdg-open';
-  try {
-    spawnSync(cmd, [url], { stdio: 'ignore' });
-  } catch {
-    // ignore — user can open manually
-  }
-}
-
-/**
- * Poll bindings until one for (apiKeyId, providerId) appears.
- * Shows a live countdown in TTY mode.
- * Returns the matched binding or null on timeout.
- */
-async function pollForBinding(
-  apiKeyId: string,
-  providerId: string,
-  jwtToken: string,
-  timeoutMs = 5 * 60 * 1000,
-  intervalMs = 3000,
-): Promise<{ providerAccountName: string | null } | null> {
-  const deadline = Date.now() + timeoutMs;
-  const isTTY = process.stdout.isTTY;
-
-  while (Date.now() < deadline) {
-    await new Promise((r) => setTimeout(r, intervalMs));
-
-    try {
-      const bindings = await listOAuthBindings(jwtToken, XAPI_API_HOST);
-      const match = Array.isArray(bindings)
-        ? bindings.find((b) => b.apiKeyId === apiKeyId && b.providerId === providerId)
-        : null;
-      if (match) return match;
-    } catch {
-      // transient error — keep polling
-    }
-
-    if (isTTY) {
-      const remaining = Math.ceil((deadline - Date.now()) / 1000);
-      process.stdout.write(`\r  Waiting for authorization... (${remaining}s remaining)  `);
-    }
-  }
-
-  if (process.stdout.isTTY) process.stdout.write('\n');
-  return null;
-}
-
-// ── Helpers ────────────────────────────────────────────────────────────────────
-
-async function loginAndGetJwt(apiKey: string): Promise<string> {
-  const result = await loginWithApiKey(apiKey, XAPI_API_HOST) as any;
-  if (!result?.accessToken) {
-    throw new Error('Login failed: no access token returned');
-  }
-  return result.accessToken;
-}
-
-/**
- * Find the API key record that corresponds to the current plaintext API key.
- * Matches by key prefix (first 7 chars of the plaintext key = keyPrefix).
- */
-async function findCurrentKeyRecord(
-  plaintextKey: string,
-  jwtToken: string,
-): Promise<{ id: string; name: string; keyPreview: string; oauthEnabled: boolean }> {
-  const keys = await listKeys(jwtToken, XAPI_API_HOST);
-  if (!Array.isArray(keys) || keys.length === 0) {
-    throw new Error('No API keys found for this account');
-  }
-  if (keys.length === 1) return keys[0];
-  // Match by prefix: keyPreview starts with the key's prefix
-  const prefix = plaintextKey.substring(0, 7);
-  const match = keys.find((k) => k.keyPreview.startsWith(prefix));
-  if (!match) {
-    // Fallback: use the first key
-    return keys[0];
-  }
-  return match;
-}
-
-// ── Help text ──────────────────────────────────────────────────────────────────
-
-export const OAUTH_HELP = `xapi oauth - Manage OAuth bindings
-
-USAGE
-  xapi oauth <command> [flags]
-
-COMMANDS
-  bind [--provider <name>]   Bind an OAuth account to your API key
-  status                     List current OAuth bindings
-  unbind <binding-id>        Remove an OAuth binding
-  providers                  List available OAuth providers
-
-FLAGS
-  --provider <name>          OAuth provider (default: twitter)
-  --format json|pretty|table   Output format
-
-EXAMPLES
-  xapi oauth bind
-  xapi oauth bind --provider twitter
-  xapi oauth status
-  xapi oauth status --format pretty
-  xapi oauth unbind abc123
-  xapi oauth providers
-`;
-
-// ── Commands ───────────────────────────────────────────────────────────────────
-
-/**
- * xapi oauth bind [--provider twitter]
- *
- * Initiates OAuth binding for the current API key.
- * Prints the authorization URL for the user to open in a browser.
- */
-export async function oauthBind(args: string[], flags: Record<string, string>) {
-  const cfg = getConfig();
-  requireApiKey(cfg);
-  const apiKey = cfg.apiKey!;
-  const providerName = (flags.provider || 'twitter').toLowerCase();
-
-  try {
-    // 1. Login to get JWT
-    const jwtToken = await loginAndGetJwt(apiKey);
-
-    // 2. Find the API key record
-    const keyRecord = await findCurrentKeyRecord(apiKey, jwtToken);
-
-    // 3. Enable OAuth on the key if needed
-    if (!keyRecord.oauthEnabled) {
-      await enableOAuthForKey(keyRecord.id, apiKey, jwtToken, XAPI_API_HOST);
-    }
-
-    // 4. Find the requested OAuth provider
-    const providers = await listOAuthProviders(XAPI_API_HOST);
-    if (!Array.isArray(providers) || providers.length === 0) {
-      throw new Error('No OAuth providers available');
-    }
-    const provider = providers.find(
-      (p) =>
-        p.type.toLowerCase() === providerName ||
-        p.name.toLowerCase().includes(providerName),
-    );
-    if (!provider) {
-      const available = providers.map((p) => p.type).join(', ');
-      throw new Error(
-        `Provider "${providerName}" not found. Available: ${available}`,
-      );
-    }
-
-    // 5. Initiate OAuth authorization
-    const result = await initiateOAuth(keyRecord.id, provider.id, jwtToken, XAPI_API_HOST);
-    const { authorizationUrl } = result;
-
-    const isTTY = process.stdout.isTTY;
-
-    if (isTTY) {
-      // Interactive mode: open browser + poll
-      console.error(`\n  Provider : ${provider.name}`);
-      console.error(`  API Key  : ${keyRecord.keyPreview}`);
-      console.error(`\n  Authorization URL:\n  ${authorizationUrl}\n`);
-      console.error('  Opening browser...');
-      openBrowser(authorizationUrl);
-      console.error('  Waiting for you to complete authorization in the browser...\n');
-
-      const binding = await pollForBinding(keyRecord.id, provider.id, jwtToken);
-
-      if (process.stdout.isTTY) process.stdout.write('\n');
-
-      if (binding) {
-        const account = (binding as any).providerAccountName || 'unknown';
-        console.error(`\n  Authorization complete! Bound to @${account}\n`);
-        output({ status: 'success', provider: provider.name, account }, flags.format as any);
-      } else {
-        err('oauth bind timed out', 'Authorization was not completed within 5 minutes. Run "xapi oauth bind" again.');
-      }
-    } else {
-      // Non-interactive / agent mode: just output the URL
-      output({
-        status: 'pending',
-        provider: provider.name,
-        apiKey: keyRecord.keyPreview,
-        authorizationUrl,
-      }, flags.format as any);
-    }
-  } catch (e: any) {
-    err('oauth bind failed', e.message);
-  }
-}
-
-/**
- * xapi oauth status
- *
- * Lists all OAuth bindings for the current account.
- */
-export async function oauthStatus(args: string[], flags: Record<string, string>) {
-  const cfg = getConfig();
-  requireApiKey(cfg);
-  const apiKey = cfg.apiKey!;
-
-  try {
-    const jwtToken = await loginAndGetJwt(apiKey);
-    const bindings = await listOAuthBindings(jwtToken, XAPI_API_HOST);
-
-    if (!Array.isArray(bindings) || bindings.length === 0) {
-      output({
-        status: 'no_bindings',
-        message: 'No OAuth bindings found. Run "xapi oauth bind" to connect an account.',
-      }, flags.format as any);
-      return;
-    }
-
-    output({
-      status: 'ok',
-      count: bindings.length,
-      bindings: bindings.map((b) => ({
-        id: b.id,
-        provider: b.provider.name,
-        providerType: b.provider.type,
-        account: b.providerAccountName || b.providerAccountId,
-        apiKeyId: b.apiKeyId,
-        scopes: b.scopes,
-        boundAt: b.createdAt,
-      })),
-    }, flags.format as any);
-  } catch (e: any) {
-    err('oauth status failed', e.message);
-  }
-}
-
-/**
- * xapi oauth unbind <binding-id>
- *
- * Deletes an OAuth binding. Get the ID from `xapi oauth status`.
- */
-export async function oauthUnbind(args: string[], flags: Record<string, string>) {
-  const cfg = getConfig();
-  requireApiKey(cfg);
-  const apiKey = cfg.apiKey!;
-
-  const bindingId = args[0];
-  if (!bindingId) {
-    err('usage: xapi oauth unbind <binding-id>', 'Get the binding ID from "xapi oauth status"');
-  }
-
-  try {
-    const jwtToken = await loginAndGetJwt(apiKey);
-    const result = await deleteOAuthBinding(bindingId, jwtToken, XAPI_API_HOST);
-    output({ success: result.success, message: 'OAuth binding removed' }, flags.format as any);
-  } catch (e: any) {
-    err('oauth unbind failed', e.message);
-  }
-}
-
-/**
- * xapi oauth providers
- *
- * Lists available OAuth providers.
- */
-export async function oauthProviders(args: string[], flags: Record<string, string>) {
-  try {
-    const providers = await listOAuthProviders(XAPI_API_HOST);
-    output(providers, flags.format as any);
-  } catch (e: any) {
-    err('oauth providers failed', e.message);
-  }
-}