@tokenbuddy/tb-admin 1.0.31 → 1.0.32

package/tests/ui-static-row.test.ts

@@ -0,0 +1,202 @@
+/**
+ * Step 13 v1.1: admin web UI seller row 渲染测试.
+ *
+ * 原则: 不引入 jsdom / linkedom. 直接 evaluate ui-static.ts bundle 的
+ * inline script 抽出 sellerRow 函数 (regex 匹配 function 声明) + 喂 mock
+ * window.__tbFmt, 然后 string match 验证 4 类行 (dataSource=both / fly /
+ * registry / 老 1.0.31 缺字段) 渲染出正确的 CSS class + 文案 + 按钮.
+ *
+ * 覆盖 (跟 docs/processes/seller-fleet-data-sources.md 一致):
+ *   1. dataSource="both"       → "app-row" (无红/灰 class), 绿点 active, "Both" chip
+ *   2. dataSource="fly"        → "app-row app-row-fly-only" (灰), "未发布" chip
+ *                                + publish-hint-btn 文案
+ *   3. dataSource="registry"   → "app-row app-row-registry-only" (整行红边)
+ *                                + "严重事故" + alert-reason + remove-hint-btn
+ *   4. dataSource 老 1.0.31 缺失 → 兜底 "both" (默认行, 不报红)
+ *
+ * 验证 grep 锚点 (跟 spec 一致):
+ *   - "立即下线 (registry-only)" 必须在 remove-hint-btn 出现
+ *   - "registry 收录了但 fly app 失踪" 必须在 alert-reason 出现
+ *   - "未发布 — 可申请发布" 必须在 publish-hint-btn 出现
+ */
+
+import { adminUiHtml } from "../src/ui-static.js";
+
+interface MockFmt {
+  UNKNOWN_VALUE: string;
+  formatDuration: (v: unknown) => string;
+  formatSpeed: (v: unknown) => string;
+  formatBalanceAmount: () => string;
+  formatSellerCapacity: () => string;
+  formatDiscountRatio: (v: unknown) => string;
+  formatSellerStatus: (s: unknown) => string;
+  sellerStatusTone: (s: unknown) => string;
+  normalizeStatusLabel: (s: unknown) => string;
+  formatTimeCompact: (s: unknown) => string;
+  formatCount: (n: unknown) => string;
+}
+
+const MOCK_FMT: MockFmt = {
+  UNKNOWN_VALUE: "—",
+  formatDuration: () => "123ms",
+  formatSpeed: () => "12.3 tok/s",
+  formatBalanceAmount: () => "0.00",
+  formatSellerCapacity: () => "3/8",
+  formatDiscountRatio: () => "1.0x",
+  formatSellerStatus: (s) => String(s || "unknown"),
+  sellerStatusTone: (s) => {
+    const k = String(s || "unknown").toLowerCase();
+    if (k === "active" || k === "healthy") return "green";
+    if (k === "draining" || k === "degraded") return "amber";
+    if (k === "offline" || k === "unhealthy") return "red";
+    if (k === "busy_capacity") return "blue";
+    return "gray";
+  },
+  normalizeStatusLabel: (s) => String(s || "—"),
+  formatTimeCompact: () => "12:34",
+  formatCount: (n) => String(n ?? 0)
+};
+
+/**
+ * Step 13 v1.1: 不引 jsdom, 用 `new Function` 跑抽出 sellerRow 函数体.
+ * ui-static.ts 整个文件是 `<script>...</script>` 模板字符串, 我们用
+ * 简单 regex 提取 inline script 内容, 加上 mock window, 跑 sellerRow 拿 HTML.
+ *
+ * 限制: 不模拟 DOM 树. 验证方式是直接看 sellerRow() 返回的 HTML 字符串
+ * 是否含预期的 class + 文案 + 按钮 (跟 spec grep 锚点一一对应).
+ */
+function renderRow(row: Record<string, unknown>): string {
+  const html = adminUiHtml();
+  // 抽 <script>...</script>
+  const scriptMatch = html.match(/<script>([\s\S]*?)<\/script>/);
+  if (!scriptMatch) {
+    throw new Error("adminUiHtml() did not include a <script> tag");
+  }
+  const scriptBody = scriptMatch[1];
+  // mock window + 把 sellerRow 暴露
+  const code = `
+    var noopArr = () => [];
+    var fakeEl = { classList: { toggle: () => undefined, add: () => undefined, remove: () => undefined }, innerHTML: "", textContent: "" };
+    var window = { __tbFmt: ${JSON.stringify(MOCK_FMT)}, addEventListener: () => undefined };
+    var document = {
+      createElement: () => fakeEl,
+      addEventListener: () => undefined,
+      querySelectorAll: noopArr,
+      querySelector: () => fakeEl,
+      getElementById: () => fakeEl
+    };
+    var setTimeout = () => 0;
+    var setInterval = () => 0;
+    var clearTimeout = () => undefined;
+    var clearInterval = () => undefined;
+    ${scriptBody}
+    return sellerRow(${JSON.stringify(row)});
+  `;
+  // eslint-disable-next-line @typescript-eslint/no-implied-eval, no-new-func
+  const fn = new Function(code);
+  return fn();
+}
+
+describe("admin web seller row 渲染 (Step 13 v1.1 双源 spec)", () => {
+  test("dataSource=both → 正常行 (无红/灰 class), 绿点, Both chip", () => {
+    const out = renderRow({
+      id: "tbs-alpha",
+      name: "tbs-alpha",
+      app: "tbs-alpha",
+      url: "https://tbs-alpha.fly.dev",
+      registryStatus: "active",
+      nodeStatus: "active",
+      upstreamDomain: "openrouter.ai",
+      upstreamStatus: "healthy",
+      modelsCount: 1,
+      dataSource: "both",
+      flyApp: { name: "tbs-alpha", status: "running" }
+    });
+    // 行 class 不带 registry-only / fly-only
+    expect(out).toContain('class="app-row"');
+    expect(out).not.toContain("app-row-registry-only");
+    expect(out).not.toContain("app-row-fly-only");
+    // 绿点 active → tone-green
+    expect(out).toMatch(/app-dot tone-green/);
+    // Both chip
+    expect(out).toMatch(/datasource-chip both/);
+    expect(out).toContain("Both");
+    // 无 alert-reason / remove-hint-btn / publish-hint-btn
+    expect(out).not.toContain("alert-reason");
+    expect(out).not.toContain("remove-hint-btn");
+    expect(out).not.toContain("publish-hint-btn");
+  });
+
+  test("dataSource=fly → 灰底 + 未发布 chip + publish-hint-btn", () => {
+    const out = renderRow({
+      id: "tbs-flyonly",
+      name: "tbs-flyonly",
+      app: "tbs-flyonly",
+      url: "https://tbs-flyonly.fly.dev",
+      registryStatus: "unknown",
+      nodeStatus: "unknown",
+      upstreamDomain: "tbs-flyonly.fly.dev",
+      upstreamStatus: "unknown",
+      modelsCount: 0,
+      dataSource: "fly",
+      publishHint: "未发布 — 可申请发布 (走 vendor-bootstrap stage)",
+      flyApp: { name: "tbs-flyonly", status: "running" }
+    });
+    expect(out).toContain("app-row-fly-only");
+    expect(out).not.toContain("app-row-registry-only");
+    expect(out).toMatch(/datasource-chip fly/);
+    expect(out).toContain("未发布");
+    // publish-hint-btn 出现 + 文案含 spec 关键词
+    expect(out).toContain("publish-hint-btn");
+    expect(out).toContain("未发布 — 可申请发布");
+  });
+
+  test("dataSource=registry → 整行红边 + 严重事故 + alert-reason + 立即下线 (registry-only) 按钮", () => {
+    const out = renderRow({
+      id: "tbs-ghost",
+      name: "tbs-ghost",
+      app: "tbs-ghost",
+      url: "https://tbs-ghost.fly.dev",
+      registryStatus: "active",
+      nodeStatus: "unknown",
+      upstreamDomain: "tbs-ghost.fly.dev",
+      upstreamStatus: "unknown",
+      modelsCount: 1,
+      dataSource: "registry",
+      registryAlert: true,
+      alertReason: "registry 收录了但 fly app 失踪 — 严重事故, 立即下线",
+      removeHint: "立即下线 (registry-only)"
+    });
+    expect(out).toContain("app-row-registry-only");
+    // 严重事故 文案
+    expect(out).toContain("严重事故");
+    // alert-reason
+    expect(out).toContain("alert-reason");
+    expect(out).toContain("registry 收录了但 fly app 失踪");
+    // 立即下线 (registry-only) 按钮
+    expect(out).toContain("remove-hint-btn");
+    expect(out).toContain("立即下线 (registry-only)");
+    expect(out).toMatch(/data-action="remove"/);
+    expect(out).toMatch(/data-seller-id="tbs-ghost"/);
+  });
+
+  test("dataSource 缺失 (老 1.0.31 行) → 兜底 'both', 不报错不标红", () => {
+    const out = renderRow({
+      id: "legacy",
+      name: "legacy",
+      app: "legacy",
+      url: "https://legacy.fly.dev",
+      registryStatus: "active",
+      nodeStatus: "active",
+      upstreamDomain: "legacy.fly.dev",
+      upstreamStatus: "healthy",
+      modelsCount: 1
+      // 故意没 dataSource 字段, 模拟 1.0.31 老 row
+    });
+    expect(out).toContain('class="app-row"');
+    expect(out).not.toContain("app-row-registry-only");
+    expect(out).not.toContain("app-row-fly-only");
+    // 兜底 chip = both
+    expect(out).toMatch(/datasource-chip both/);
+  });
+});

package/tests/vendor-cli.test.ts

@@ -0,0 +1,197 @@
+import request from "supertest";
+import * as fs from "fs";
+import * as path from "path";
+import { buildAdminCli } from "../src/cli.js";
+import { ConfigManager } from "../src/config.js";
+import { execSync } from "child_process";
+
+// Use the workspace-linked package. ts-jest will resolve the
+// `.js` to the compiled `.ts` via the root moduleNameMapper.
+import { buildApp, BootstrapConfig } from "@tokenbuddy/wallet-bootstrap";
+
+const WALLET_TEST_DIR = path.resolve(__dirname, "../../data-vendor-cli-test");
+const TEMP_REGISTRY_PATH = path.join(WALLET_TEST_DIR, "sellers.json");
+const TEMP_REGISTRY_DB_PATH = path.join(WALLET_TEST_DIR, "bootstrap.sqlite");
+const TEMP_CONFIG_PATH = path.join(WALLET_TEST_DIR, "tb-registry.yaml");
+const TEMP_ADMIN_CONF_PATH = path.join(WALLET_TEST_DIR, "admin-config.json");
+const SUPER_ADMIN_KEY = "platform-super-admin-key-please-rotate-me-1234567890";
+const SESSION_SECRET = "session-secret-32-chars-min-please";
+
+const baseRegistry = {
+  version: 1,
+  defaultSeller: "platform-seed",
+  sellers: [
+    {
+      id: "platform-seed",
+      name: "Platform Seed",
+      url: "https://platform-seed.example.com",
+      status: "active",
+      models: ["seed-model"],
+      supportedProtocols: ["chat_completions"],
+      paymentMethods: ["clawtip"]
+    }
+  ]
+};
+
+const baseConfig: BootstrapConfig = {
+  configPath: TEMP_CONFIG_PATH,
+  payTo: "pay-to-x",
+  sm4KeyBase64: "MDEyMzQ1Njc4OUFCQ0RFRg==",
+  skillSlug: "tb-registry",
+  skillId: "si-tb-registry",
+  description: "Activate",
+  resourceUrl: "https://example.com",
+  activationFeeFen: 1,
+  microsPerFen: 1000000,
+  sellerRegistryPath: TEMP_REGISTRY_PATH,
+  operatorSecret: "op-secret",
+  superAdminKey: SUPER_ADMIN_KEY,
+  superAdminLabel: "ops",
+  sessionSecret: SESSION_SECRET
+};
+
+function buildServer() {
+  fs.mkdirSync(WALLET_TEST_DIR, { recursive: true });
+  fs.writeFileSync(TEMP_REGISTRY_PATH, JSON.stringify(baseRegistry), "utf8");
+  for (const f of [TEMP_REGISTRY_DB_PATH, `${TEMP_REGISTRY_DB_PATH}-wal`, `${TEMP_REGISTRY_DB_PATH}-shm`]) {
+    try { fs.rmSync(f, { force: true }); } catch { /* ignore */ }
+  }
+  return buildApp(baseConfig);
+}
+
+async function createVendorToken(app: ReturnType<typeof buildServer>, name: string): Promise<string> {
+  const response = await request(app)
+    .post("/platform/vendors")
+    .set("X-Registry-Admin-Key", SUPER_ADMIN_KEY)
+    .send({ name });
+  expect(response.status).toBe(200);
+  return response.body.token;
+}
+
+async function runCli(args: string[], env: NodeJS.ProcessEnv): Promise<{ stdout: string; stderr: string; status: number }> {
+  // We invoke the CLI as a child process so the `program` state does
+  // not leak between tests. The package's `dist/` may not exist in
+  // worktrees, so we run from TypeScript source via `tsx` if
+  // available; fall back to requiring the source.
+  const cliEntry = path.resolve(__dirname, "../src/cli.ts");
+  // Try `npx tsx` first, then `node --import tsx`, then fallback
+  // to `node -r ts-node/register`.
+  let cmd: string;
+  let finalArgs: string[];
+  try {
+    execSync("which tsx", { stdio: "ignore" });
+    cmd = "npx";
+    finalArgs = ["tsx", cliEntry, ...args];
+  } catch {
+    cmd = "node";
+    finalArgs = ["--import", "tsx", cliEntry, ...args];
+  }
+  try {
+    const stdout = execSync(`${cmd} ${finalArgs.map((a) => JSON.stringify(a)).join(" ")}`, {
+      env: { ...process.env, ...env },
+      stdio: ["ignore", "pipe", "pipe"],
+      encoding: "utf8"
+    });
+    return { stdout, stderr: "", status: 0 };
+  } catch (err: any) {
+    return {
+      stdout: err.stdout?.toString() || "",
+      stderr: err.stderr?.toString() || err.message,
+      status: err.status || 1
+    };
+  }
+}
+
+describe("Vendor CLI integration (Step 5)", () => {
+  beforeEach(() => {
+    fs.mkdirSync(WALLET_TEST_DIR, { recursive: true });
+    for (const f of [TEMP_REGISTRY_PATH, TEMP_REGISTRY_DB_PATH, `${TEMP_REGISTRY_DB_PATH}-wal`, `${TEMP_REGISTRY_DB_PATH}-shm`, TEMP_CONFIG_PATH, TEMP_ADMIN_CONF_PATH]) {
+      try { fs.rmSync(f, { force: true }); } catch { /* ignore */ }
+    }
+  });
+
+  afterAll(() => {
+    fs.rmSync(WALLET_TEST_DIR, { recursive: true, force: true });
+  });
+
+  test("buildAdminCli still constructs without errors after the registry redesign", () => {
+    const config = new ConfigManager(TEMP_ADMIN_CONF_PATH);
+    const cli = buildAdminCli(config);
+    expect(cli.commands.find((c: any) => c.name() === "vendor-bootstrap")).toBeDefined();
+    // The legacy `bootstrap` command is still there for backward compat.
+    expect(cli.commands.find((c: any) => c.name() === "bootstrap")).toBeDefined();
+  });
+
+  test("RegistryVendorClient can authenticate against a live wallet-bootstrap app and stage a seller", async () => {
+    const app = buildServer();
+    const token = await createVendorToken(app, "Acme");
+    // Direct HTTP call to the vendor API as the CLI would do.
+    const stage = await request(app)
+      .post("/platform/sellers/stage")
+      .set("Authorization", `Bearer ${token}`)
+      .send({ seller: {
+        id: "acme-seller-1",
+        name: "Acme Seller 1",
+        url: "https://acme.example.com",
+        status: "active",
+        models: ["m1"],
+        supportedProtocols: ["chat_completions"],
+        paymentMethods: ["clawtip"]
+      } });
+    expect(stage.status).toBe(200);
+    expect(stage.body.pendingSeller.id).toBe("acme-seller-1");
+    expect(stage.body.pendingSeller.status).toBe("staged");
+  });
+
+  test("RegistryVendorClient listPendingSellers only returns this vendor's rows", async () => {
+    const app = buildServer();
+    const tokenA = await createVendorToken(app, "VendorA");
+    const tokenB = await createVendorToken(app, "VendorB");
+    await request(app)
+      .post("/platform/sellers/stage")
+      .set("Authorization", `Bearer ${tokenA}`)
+      .send({ seller: {
+        id: "va-1", name: "VA1", url: "https://va1.example.com", status: "active",
+        models: ["m1"], supportedProtocols: ["chat_completions"], paymentMethods: ["clawtip"]
+      } });
+    await request(app)
+      .post("/platform/sellers/stage")
+      .set("Authorization", `Bearer ${tokenB}`)
+      .send({ seller: {
+        id: "vb-1", name: "VB1", url: "https://vb1.example.com", status: "active",
+        models: ["m1"], supportedProtocols: ["chat_completions"], paymentMethods: ["clawtip"]
+      } });
+    const aList = await request(app)
+      .get("/platform/sellers/pending?status=staged")
+      .set("Authorization", `Bearer ${tokenA}`);
+    const bList = await request(app)
+      .get("/platform/sellers/pending?status=staged")
+      .set("Authorization", `Bearer ${tokenB}`);
+    expect(aList.body.pendingSellers).toHaveLength(1);
+    expect(aList.body.pendingSellers[0].id).toBe("va-1");
+    expect(bList.body.pendingSellers).toHaveLength(1);
+    expect(bList.body.pendingSellers[0].id).toBe("vb-1");
+  });
+
+  test("RegistryVendorClient submitRelease -> listReleaseRequests round-trips", async () => {
+    const app = buildServer();
+    const token = await createVendorToken(app, "VendorC");
+    await request(app)
+      .post("/platform/sellers/stage")
+      .set("Authorization", `Bearer ${token}`)
+      .send({ seller: {
+        id: "vc-1", name: "VC1", url: "https://vc1.example.com", status: "active",
+        models: ["m1"], supportedProtocols: ["chat_completions"], paymentMethods: ["clawtip"]
+      } });
+    const submit = await request(app)
+      .post("/platform/release-requests")
+      .set("Authorization", `Bearer ${token}`)
+      .send({ stagedSellerIds: ["vc-1"], note: "test" });
+    expect(submit.status).toBe(200);
+    const list = await request(app)
+      .get("/platform/release-requests?limit=10")
+      .set("Authorization", `Bearer ${token}`);
+    expect(list.body.releaseRequests).toHaveLength(1);
+    expect(list.body.releaseRequests[0].id).toBe(submit.body.releaseRequest.id);
+  });
+});