@tokenbuddy/tb-admin 1.0.35 → 1.0.37

package/src/seller.ts

@@ -1,538 +0,0 @@
-/**
- * Step 12 v1.1 (增量): tb-admin seller 子命令 CLI 门面层.
- *
- * 1.0.31 现状:
- *   - `tb-admin seller ls|create|deploy|remove` 4 个子命令
- *   - 每个命令内部直接 `console.log(FlyProvider.<method>() 的 string 返回值)`
- *   - 1.0.31 文本输出跟 flyctl 原始 stdout 一致 (人类可读表 / 状态文案)
- *
- * v1.1 增量:
- *   1. 新增 `tb-admin seller status <app>` 第 5 子命令
- *   2. 5 个子命令全部加 `--json` flag
- *   3. `--json` 输出统一包装:
- *      - ls/status: 直接拿 flyctl `--json` 解析后的 array / object
- *      - create/deploy/remove: `{ ok, provider, action, app, dryRun, ... }`
- *   4. 默认路径 1:1 保留 1.0.31 行为 (FlyProvider 不变, server-cmd.ts 不动)
- *   5. UI 之后通过 spawn `tb-admin seller <cmd> --json` 取结构化数据
- *
- * 不改: FlyProvider 类 / server-cmd.ts / admin web / provider.ts.
- * 不写 UI (Step 13).
- */
-
-import { execSync, spawnSync } from "node:child_process";
-import { FlyProvider, type SellerCreateOptions } from "./server-cmd.js";
-import type { ConfigManager, SellerProviderConfig } from "./config.js";
-
-/** 单个 seller app 的 JSON 形态 (跟 flyctl apps list --json 对齐, 但只保留 UI 关心字段) */
-export interface SellerAppJson {
-  name: string;
-  status: string;
-  owner?: string;
-  region?: string;
-  version?: number;
-  latestDeployAt?: string;
-  /** raw flyctl 字段, 保留供未来扩展 */
-  raw: Record<string, unknown>;
-}
-
-export interface SellerMachineSpecs {
-  machines: number;
-  runningMachines?: number;
-  cpuKind?: string;
-  cpuCores?: number;
-  memoryMb?: number;
-  volumeGb?: number;
-  regions?: string[];
-}
-
-/** ls --json 输出 */
-export interface SellerListResult {
-  ok: true;
-  provider: "fly";
-  action: "list";
-  count: number;
-  apps: SellerAppJson[];
-}
-
-/** status --json 输出 */
-export interface SellerStatusResult {
-  ok: true;
-  provider: "fly";
-  action: "status";
-  app: string;
-  status: Record<string, unknown>;
-}
-
-/** create / deploy / remove --json 输出 */
-export interface SellerActionResult<T extends "create" | "deploy" | "remove"> {
-  ok: true;
-  provider: "fly";
-  action: T;
-  app: string;
-  dryRun: boolean;
-  /** dry-run 模式下, 列出实际会跑的 flyctl 命令 */
-  commands?: string[];
-  /** 实际执行后, flyctl 输出摘录 (limited to stdout summary) */
-  summary?: string;
-  /** create/deploy 额外信息 */
-  machines?: string[];
-}
-
-/** roll --json 输出: 按顺序对一组 seller 跑 image-only redeploy */
-export interface SellerRollResult {
-  ok: true;
-  provider: "fly";
-  action: "roll";
-  image: string;
-  dryRun: boolean;
-  /** 实际进入 roll 的 seller app 名 (去 exclude 之后) */
-  candidates: string[];
-  /** 被 --exclude 排除的 seller */
-  excluded: string[];
-  /** 每一台 deploy 的结果, 按执行顺序. 失败那一台后续不再执行 */
-  attempts: SellerRollAttempt[];
-  /** true = 全部 success; false = 至少一台失败且后续没跑 */
-  completed: boolean;
-}
-
-export interface SellerRollAttempt {
-  app: string;
-  ok: boolean;
-  /** 失败时填 stderr / 异常 message */
-  error?: string;
-  /** 实际 deploy 后 flyctl 摘录 */
-  summary?: string;
-}
-
-export type SellerCommandResult =
-  | SellerListResult
-  | SellerStatusResult
-  | SellerActionResult<"create">
-  | SellerActionResult<"deploy">
-  | SellerActionResult<"remove">
-  | SellerRollResult;
-
-export class FlyCliMissingError extends Error {
-  constructor(public readonly flyctl: string) {
-    super(`\`${flyctl}\` is not installed on your system PATH.`);
-    this.name = "FlyCliMissingError";
-  }
-}
-
-export class FlyCommandError extends Error {
-  constructor(
-    public readonly command: string,
-    public readonly exitCode: number,
-    public readonly stderr: string
-  ) {
-    super(`flyctl command failed (${exitCode}): ${command}\n${stderr.trim()}`);
-    this.name = "FlyCommandError";
-  }
-}
-
-/**
- * 解析 flyctl apps list 文本输出 (人类可读表) -> 数组.
- * 默认路径不变; --json 路径用 `parseFlyListJson` 走结构化路径.
- */
-function parseFlyListText(text: string): SellerAppJson[] {
-  const lines = text.split(/\r?\n/).filter((l) => l.trim().length > 0);
-  // 第一行 = 表头, 跳过; 后续行 = app 行
-  return lines.slice(1).map((line) => {
-    const cols = line.split("│").map((c) => c.trim());
-    return {
-      name: cols[0] || "",
-      status: cols[2] || "unknown",
-      owner: cols[1] || undefined,
-      latestDeployAt: cols[3] || undefined,
-      raw: { textLine: line }
-    };
-  });
-}
-
-function parseFlyListJson(jsonText: string): SellerAppJson[] {
-  let parsed: unknown;
-  try {
-    parsed = JSON.parse(jsonText || "[]");
-  } catch (err) {
-    throw new Error(`flyctl apps list --json returned invalid JSON: ${(err as Error).message}`);
-  }
-  if (!Array.isArray(parsed)) {
-    throw new Error(`flyctl apps list --json did not return an array`);
-  }
-  return parsed.map((item) => {
-    if (!item || typeof item !== "object") {
-      return { name: String(item), status: "unknown", raw: { value: item } };
-    }
-    const obj = item as Record<string, unknown>;
-    const name = typeof obj.Name === "string" ? obj.Name : typeof obj.name === "string" ? obj.name : "";
-    const status = typeof obj.Status === "string" ? obj.Status : typeof obj.status === "string" ? obj.status : "unknown";
-    return {
-      name,
-      status,
-      owner: typeof obj.Owner === "string" ? obj.Owner : undefined,
-      region: typeof obj.Region === "string" ? obj.Region : undefined,
-      version: typeof obj.Version === "number" ? obj.Version : undefined,
-      latestDeployAt: typeof obj.Deployed === "boolean" && obj.Deployed ? new Date().toISOString() : undefined,
-      raw: obj
-    };
-  });
-}
-
-function parseFlyStatusJson(jsonText: string): Record<string, unknown> {
-  let parsed: unknown;
-  try {
-    parsed = JSON.parse(jsonText || "{}");
-  } catch (err) {
-    throw new Error(`flyctl status --json returned invalid JSON: ${(err as Error).message}`);
-  }
-  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-    throw new Error(`flyctl status --json did not return an object`);
-  }
-  return parsed as Record<string, unknown>;
-}
-
-/**
- * Low-level flyctl exec helper. Throws FlyCommandError on non-zero exit.
- * Use this for --json path; default 1.0.31 path still goes through FlyProvider
- * (which uses `stdio: "inherit"` for human consumption).
- */
-function runFlyctlJson(
-  flyctl: string,
-  args: string[],
-  env: NodeJS.ProcessEnv,
-  timeoutMs?: number
-): unknown {
-  const result = spawnSync(flyctl, args, { encoding: "utf8", env, timeout: timeoutMs });
-  if (result.error) {
-    throw result.error;
-  }
-  if (result.status !== 0) {
-    throw new FlyCommandError(
-      `${flyctl} ${args.join(" ")}`,
-      result.status ?? -1,
-      result.stderr || result.stdout || ""
-    );
-  }
-  return result.stdout;
-}
-
-function parseFlyMachinesJson(jsonText: string): SellerMachineSpecs {
-  let parsed: unknown;
-  try {
-    parsed = JSON.parse(jsonText || "[]");
-  } catch (err) {
-    throw new Error(`flyctl machines list --json returned invalid JSON: ${(err as Error).message}`);
-  }
-  if (!Array.isArray(parsed)) {
-    throw new Error("flyctl machines list --json did not return an array");
-  }
-  const machines = parsed.filter((item) => item && typeof item === "object") as Array<Record<string, unknown>>;
-  const first = machines[0];
-  const guest = first && typeof first.config === "object" && first.config
-    ? (first.config as Record<string, unknown>).guest as Record<string, unknown> | undefined
-    : undefined;
-  const mount = first && typeof first.config === "object" && first.config && Array.isArray((first.config as Record<string, unknown>).mounts)
-    ? ((first.config as Record<string, unknown>).mounts as unknown[]).find((item) => item && typeof item === "object") as Record<string, unknown> | undefined
-    : undefined;
-  const regions = Array.from(new Set(machines.map((machine) => typeof machine.region === "string" ? machine.region : undefined).filter((region): region is string => Boolean(region)))).sort();
-  return {
-    machines: machines.length,
-    runningMachines: machines.filter((machine) => machine.state === "started").length,
-    cpuKind: typeof guest?.cpu_kind === "string" ? guest.cpu_kind : undefined,
-    cpuCores: typeof guest?.cpus === "number" ? guest.cpus : undefined,
-    memoryMb: typeof guest?.memory_mb === "number" ? guest.memory_mb : undefined,
-    volumeGb: typeof mount?.size_gb === "number" ? mount.size_gb : undefined,
-    regions
-  };
-}
-
-/**
- * 顶层 seller 命令入口. 5 个 op 都走这里.
- * - `json=false` (默认): 走 FlyProvider 现有方法, 返回人类可读 string, 调用方 console.log
- * - `json=true`: 走结构化 flyctl --json + 包装, 返回 SellerCommandResult 对象
- */
-export class SellerCommandRunner {
-  constructor(private configManager: ConfigManager) {}
-
-  private getProviderConfig(): SellerProviderConfig | undefined {
-    return this.configManager.getSellerProvider("fly");
-  }
-
-  private getProvider(): FlyProvider {
-    return new FlyProvider(this.getProviderConfig());
-  }
-
-  private getFlyctl(): string {
-    return this.getProviderConfig()?.flyctl_path || "flyctl";
-  }
-
-  // -- ls --
-
-  public ls(json: boolean): SellerListResult | string {
-    const provider = this.getProvider();
-    if (!json) {
-      return provider.listApps();
-    }
-    const flyctl = this.getFlyctl();
-    if (!providerCheck(flyctl)) {
-      throw new FlyCliMissingError(flyctl);
-    }
-    const env = flyEnv(this.getProviderConfig());
-    const stdout = runFlyctlJson(flyctl, ["apps", "list", "--json"], env) as string;
-    const apps = parseFlyListJson(stdout);
-    return { ok: true, provider: "fly", action: "list", count: apps.length, apps };
-  }
-
-  // -- status --
-
-  public status(appName: string, json: boolean): SellerStatusResult | string {
-    const provider = this.getProvider();
-    if (!json) {
-      return provider.statusApp(appName);
-    }
-    const flyctl = this.getFlyctl();
-    if (!providerCheck(flyctl)) {
-      throw new FlyCliMissingError(flyctl);
-    }
-    const resolvedName = appName.includes("-") ? appName : `tb-seller-${appName}`;
-    const env = flyEnv(this.getProviderConfig());
-    const stdout = runFlyctlJson(flyctl, ["status", "--app", resolvedName, "--json"], env) as string;
-    const status = parseFlyStatusJson(stdout);
-    return { ok: true, provider: "fly", action: "status", app: resolvedName, status };
-  }
-
-  public machineSpecs(appName: string): SellerMachineSpecs | undefined {
-    const flyctl = this.getFlyctl();
-    if (!providerCheck(flyctl)) {
-      throw new FlyCliMissingError(flyctl);
-    }
-    const env = flyEnv(this.getProviderConfig());
-    const stdout = runFlyctlJson(flyctl, ["machines", "list", "--app", appName, "--json"], env, 10000) as string;
-    return parseFlyMachinesJson(stdout);
-  }
-
-  // -- create --
-
-  public create(options: SellerCreateOptions, json: boolean): SellerActionResult<"create"> | string {
-    const provider = this.getProvider();
-    if (!json) {
-      return provider.createSeller(options);
-    }
-    // --json 路径: dry-run 模式直接列命令, 不实际调 flyctl
-    if (options.dryRun) {
-      return {
-        ok: true,
-        provider: "fly",
-        action: "create",
-        app: options.app || `tb-seller-${options.name}`,
-        dryRun: true,
-        commands: buildCreateCommands(options)
-      };
-    }
-    // 非 dry-run: 调 FlyProvider (它已经会跑 flyctl), 包装 stdout
-    const summary = provider.createSeller(options);
-    return {
-      ok: true,
-      provider: "fly",
-      action: "create",
-      app: options.app || `tb-seller-${options.name}`,
-      dryRun: false,
-      summary: String(summary)
-    };
-  }
-
-  // -- deploy --
-
-  public deploy(
-    args: { app: string; image?: string; dryRun?: boolean },
-    json: boolean
-  ): SellerActionResult<"deploy"> | string {
-    const provider = this.getProvider();
-    if (!json) {
-      return provider.deploySeller(args);
-    }
-    if (args.dryRun) {
-      return {
-        ok: true,
-        provider: "fly",
-        action: "deploy",
-        app: args.app,
-        dryRun: true,
-        commands: [`fly machine update <machine-id> --app ${args.app} --image ${args.image} --yes`]
-      };
-    }
-    const summary = provider.deploySeller(args);
-    return {
-      ok: true,
-      provider: "fly",
-      action: "deploy",
-      app: args.app,
-      dryRun: false,
-      summary: String(summary)
-    };
-  }
-
-  // -- remove --
-
-  public remove(appName: string, dryRun: boolean, json: boolean): SellerActionResult<"remove"> | string {
-    const provider = this.getProvider();
-    if (!json) {
-      return provider.removeSeller(appName, dryRun);
-    }
-    if (dryRun) {
-      return {
-        ok: true,
-        provider: "fly",
-        action: "remove",
-        app: appName,
-        dryRun: true,
-        commands: [`fly apps destroy ${appName} --yes`]
-      };
-    }
-    const summary = provider.removeSeller(appName, dryRun);
-    return {
-      ok: true,
-      provider: "fly",
-      action: "remove",
-      app: appName,
-      dryRun: false,
-      summary: String(summary)
-    };
-  }
-
-  // -- roll --
-  //
-  // Step 13 之后 (v1.1 增量): 不写死 5 台 fixed-fleet, 从 `fly apps list` 拉全部
-  // `tbs-*` 候选, 按顺序 image-only redeploy 到指定镜像. 失败停、报告.
-  //
-  // 设计约束 (跟 1.0.31 deploy 子命令保持一致):
-  //   - 复用 FlyProvider.deploySeller (image-only, 不动 volume / config / secrets)
-  //   - 走 --json 路径 (runFlyctlJson), 失败可解析, 不靠 stdio inherit
-  //   - 候选列表 = fly apps list --json 中 name 以 `tbs-` 开头的, 排除 --exclude
-  //   - 真跑: 失败那台后续不再执行, 报告 attempts 全部 + completed=false
-  //   - dry-run: 跑 fly apps list 拿候选, 不真 deploy, attempts 全部 ok=true, summary=计划
-
-  public roll(
-    args: { image: string; exclude?: string[]; dryRun?: boolean },
-    json: boolean
-  ): SellerRollResult | string {
-    const provider = this.getProvider();
-    const flyctl = this.getFlyctl();
-    const targetImage = args.image;
-    const excludeSet = new Set<string>((args.exclude || []).filter((s) => s.trim().length > 0));
-
-    if (!targetImage) {
-      throw new Error("seller roll requires --image registry.fly.io/tb-seller:<v>");
-    }
-
-    // 拿候选: 必须走 --json 路径 (需要结构化 Name 字段做 filter)
-    if (!providerCheck(flyctl)) {
-      throw new FlyCliMissingError(flyctl);
-    }
-    const env = flyEnv(this.getProviderConfig());
-    const stdout = runFlyctlJson(flyctl, ["apps", "list", "--json"], env) as string;
-    const allApps = parseFlyListJson(stdout);
-    const tbsOnly = allApps.filter((a) => a.name.startsWith("tbs-"));
-    const excluded = tbsOnly.filter((a) => excludeSet.has(a.name)).map((a) => a.name);
-    const candidates = tbsOnly.filter((a) => !excludeSet.has(a.name)).map((a) => a.name);
-
-    if (!json) {
-      // 文本路径: 先列计划, 然后按顺序跑
-      const lines: string[] = [];
-      lines.push(`[Fly.io] roll candidates (tbs-*, excludes applied): ${candidates.length}`);
-      for (const app of candidates) lines.push(`  - ${app}`);
-      if (excluded.length > 0) {
-        lines.push(`[Fly.io] excluded by --exclude: ${excluded.join(", ")}`);
-      }
-      lines.push(`[Fly.io] image: ${targetImage}`);
-      lines.push(`[Fly.io] mode: ${args.dryRun ? "dry-run (no actual deploy)" : "live sequential, fail-fast"}`);
-      lines.push("");
-
-      let completed = true;
-      for (const app of candidates) {
-        if (args.dryRun) {
-          lines.push(`[Fly.io] [DRY-RUN] would update ${app} image to ${targetImage}`);
-          continue;
-        }
-        try {
-          const summary = provider.deploySeller({ app, image: targetImage });
-          lines.push(`[Fly.io] ${app}: ${summary}`);
-        } catch (err: any) {
-          lines.push(`[Fly.io] ${app}: FAILED — ${err.message || String(err)}`);
-          completed = false;
-          break;
-        }
-      }
-      lines.push("");
-      lines.push(completed ? "[Fly.io] roll completed." : "[Fly.io] roll stopped at failure.");
-      return lines.join("\n");
-    }
-
-    // --json 路径: 同样顺序执行, 但输出结构化
-    const attempts: SellerRollAttempt[] = [];
-    let completed = true;
-    for (const app of candidates) {
-      if (args.dryRun) {
-        attempts.push({ app, ok: true, summary: `[dry-run] would update ${app} image to ${targetImage}` });
-        continue;
-      }
-      try {
-        const summary = provider.deploySeller({ app, image: targetImage });
-        attempts.push({ app, ok: true, summary: String(summary) });
-      } catch (err: any) {
-        attempts.push({ app, ok: false, error: err.message || String(err) });
-        completed = false;
-        break;
-      }
-    }
-    return {
-      ok: true,
-      provider: "fly",
-      action: "roll",
-      image: targetImage,
-      dryRun: Boolean(args.dryRun),
-      candidates,
-      excluded,
-      attempts,
-      completed
-    };
-  }
-}
-
-// ===== helpers =====
-
-/** 跟 FlyProvider 私有 flyEnv 行为一致; 复用 provider config token */
-function flyEnv(config: SellerProviderConfig | undefined): NodeJS.ProcessEnv {
-  const configuredToken = config?.token;
-  const merged: NodeJS.ProcessEnv = { ...process.env };
-  if (configuredToken && !merged.FLY_API_TOKEN) {
-    merged.FLY_API_TOKEN = configuredToken;
-  }
-  return merged;
-}
-
-function providerCheck(flyctl: string): boolean {
-  try {
-    execSync(`which ${flyctl}`, { stdio: "ignore" });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function buildCreateCommands(options: SellerCreateOptions): string[] {
-  const appName = options.app || `tb-seller-${options.name}`;
-  const region = options.region || "sin";
-  const lines: string[] = [];
-  if (options.flyConfig) {
-    lines.push(`fly apps create ${appName}`);
-  }
-  lines.push(`fly deploy --config ${options.flyConfig} --app ${appName} --region ${region}`);
-  if (options.image) {
-    lines.push(`fly machine update <machine-id> --app ${appName} --image ${options.image} --yes`);
-  }
-  return lines;
-}
-
-// re-exports 方便测试
-export { parseFlyListJson, parseFlyListText, parseFlyStatusJson };