@tokenbuddy/tb-admin 1.0.31 → 1.0.33

package/tests/ui-state-fleet.test.ts

@@ -0,0 +1,257 @@
+/**
+ * Step 13 v1.1: admin web seller list 双源 (fly + registry) 数据流测试.
+ *
+ * 原则: 不 mock flyctl. 测的是 AdminUiState 内部数据流, 用注入的
+ *   fetchJson (fake HTTP server) + flyApps (closure) 替代真 IO.
+ *
+ * 覆盖 (跟 docs/processes/seller-fleet-data-sources.md 一致):
+ *   1. fly + registry both → 行 dataSource="both", 绿点 = /manifest 200
+ *   2. fly only → 行 dataSource="fly", 灰点 (无 instance url 拉 manifest 失败),
+ *      行带 "未发布" 提示
+ *   3. registry only → 行 dataSource="registry", **整行标红 (registryAlert=true)**,
+ *      行带 "未部署" 提示 + 立即下线按钮 (我们这里只验字段, UI 验由 ui-static 验)
+ *   4. fly + registry both, 但 /manifest 失败 → 灰/红点, 仍 dataSource="both"
+ *
+ * 隔离外部依赖:
+ *   - node:http fake server 模拟 registry (/registry/sellers)
+ *   - node:http fake server 模拟 seller instance (/manifest)
+ *   - flyApps 通过 AdminUiStateOptions.flyApps 注入 closure
+ *
+ * 失败模式:
+ *   - 如果 4 个 case 任何一个 dataSource 错 / nodeStatus 错 / alert 漏, 立即 fail
+ *   - 永不调真 flyctl
+ */
+
+import { createServer, type Server } from "node:http";
+import { AddressInfo } from "node:net";
+import { mkdtempSync, writeFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { ConfigManager } from "../src/config.js";
+import { AdminUiState } from "../src/ui-state.js";
+import type { SellerAppJson } from "../src/seller.js";
+
+interface FakeManifestResponse {
+  status: number;
+  body?: unknown;
+}
+
+interface FakeServerHandle {
+  url: string;
+  setManifest: (sellerId: string, resp: FakeManifestResponse) => void;
+  setManifestPath: (path: string, resp: FakeManifestResponse) => void;
+  setRegistry: (resp: { sellers: any[]; version: number }) => void;
+  close: () => Promise<void>;
+}
+
+function startFakeRegistry(): Promise<FakeServerHandle> {
+  let registryDoc: { sellers: any[]; version: number } = { sellers: [], version: 0 };
+  const manifests = new Map<string, FakeManifestResponse>();
+
+  return new Promise((resolve) => {
+    const server = createServer((req, res) => {
+      const url = new URL(req.url || "/", "http://localhost");
+      if (url.pathname === "/registry/sellers") {
+        res.writeHead(200, { "Content-Type": "application/json" });
+        res.end(JSON.stringify(registryDoc));
+        return;
+      }
+      // 1) 按 path 查 (setManifestPath 注册的)
+      if (manifests.has(url.pathname)) {
+        const resp = manifests.get(url.pathname)!;
+        res.writeHead(resp.status, { "Content-Type": "application/json" });
+        res.end(JSON.stringify(resp.body || {}));
+        return;
+      }
+      // 2) 按 /manifest/{id} 模式查 (setManifest 注册的)
+      const match = url.pathname.match(/^\/manifest\/([^/]+)$/);
+      if (match) {
+        const id = decodeURIComponent(match[1]);
+        const resp = manifests.get(id) || { status: 404, body: { error: "not found" } };
+        res.writeHead(resp.status, { "Content-Type": "application/json" });
+        res.end(JSON.stringify(resp.body || {}));
+        return;
+      }
+      res.writeHead(404);
+      res.end("not found");
+    });
+    server.listen(0, "127.0.0.1", () => {
+      const port = (server.address() as AddressInfo).port;
+      const handle: FakeServerHandle = {
+        url: `http://127.0.0.1:${port}`,
+        setManifest: (id, resp) => {
+          manifests.set(id, resp);
+        },
+        setManifestPath: (path, resp) => {
+          manifests.set(path, resp);
+        },
+        setRegistry: (doc) => {
+          registryDoc = doc;
+        },
+        close: () => new Promise<void>((r) => server.close(() => r()))
+      };
+      resolve(handle);
+    });
+  });
+}
+
+let tmpDir: string;
+let tmpConfigPath: string;
+
+function makeState(
+  registryUrl: string,
+  flyApps: Omit<SellerAppJson, "raw">[]
+): AdminUiState {
+  if (!tmpDir) {
+    tmpDir = mkdtempSync(join(tmpdir(), "ui-fleet-test-"));
+    tmpConfigPath = join(tmpDir, "admin.toml");
+  }
+  writeFileSync(
+    tmpConfigPath,
+    `[profiles.default]
+url = "${registryUrl}"
+token = "fake-vendor-token"
+`,
+    "utf8"
+  );
+  const configManager = new ConfigManager(tmpConfigPath);
+  return new AdminUiState({
+    configManager,
+    profile: "default",
+    url: registryUrl,
+    token: "fake-vendor-token",
+    flyApps: async () => flyApps.map((a) => ({ ...a, raw: {} })),
+    fetchJson: (async (target: string, init?: RequestInit) => {
+      const res = await fetch(target, init);
+      return await res.json();
+    }) as any
+  });
+}
+
+describe("AdminUiState 双源 seller list (v1.1 spec)", () => {
+  let fake: FakeServerHandle;
+
+  beforeEach(async () => {
+    fake = await startFakeRegistry();
+  });
+
+  afterEach(async () => {
+    await fake.close();
+  });
+
+  afterAll(() => {
+    if (tmpDir) {
+      rmSync(tmpDir, { recursive: true, force: true });
+    }
+  });
+
+  test("case 1: fly + registry both → dataSource=both, 绿点 = /manifest 200", async () => {
+    fake.setRegistry({
+      version: 7,
+      sellers: [
+        {
+          id: "alpha",
+          name: "Alpha Seller",
+          app: "tb-seller-alpha",
+          // entry.url 是 instance 自己的 url; probeManifest 会拼 + "/manifest"
+          url: `${fake.url}/alpha-base`,
+          status: "active",
+          supportedProtocols: ["chat_completions"],
+          paymentMethods: ["clawtip"],
+          models: ["gpt-5.4"]
+        }
+      ]
+    });
+    // entry.url = ".../alpha-base", probe target = ".../alpha-base/manifest"
+    fake.setManifestPath("/alpha-base/manifest", { status: 200, body: { ok: true } });
+    const state = makeState(fake.url, [
+      { name: "tb-seller-alpha", status: "running", owner: "vendor-a" }
+    ]);
+
+    const rows = await state.sellers();
+    expect(rows).toHaveLength(1);
+    expect(rows[0].dataSource).toBe("both");
+    expect(rows[0].registryAlert).toBeFalsy();
+    // 绿点: /manifest 200 → nodeStatus=active (manifest ok 映射 active)
+    expect(rows[0].nodeStatus).toBe("active");
+  });
+
+  test("case 2: fly only → dataSource=fly, 灰点, registryAlert=undefined", async () => {
+    fake.setRegistry({ version: 7, sellers: [] });
+    const state = makeState(fake.url, [
+      { name: "tb-seller-flyonly", status: "running", owner: "vendor-a" }
+    ]);
+
+    const rows = await state.sellers();
+    expect(rows).toHaveLength(1);
+    expect(rows[0].dataSource).toBe("fly");
+    expect(rows[0].nodeStatus).toBe("unknown");
+    expect(rows[0].registryAlert).toBeFalsy();
+    expect(rows[0].publishHint).toContain("未发布");
+  });
+
+  test("case 3: registry only → dataSource=registry, 整行标红, 立即下线提示", async () => {
+    fake.setRegistry({
+      version: 7,
+      sellers: [
+        {
+          id: "ghost",
+          name: "Ghost Seller",
+          app: "tb-seller-ghost",
+          url: "https://tbs-ghost.fly.dev",
+          status: "active",
+          supportedProtocols: ["chat_completions"],
+          paymentMethods: ["clawtip"],
+          models: ["gpt-5.4"]
+        }
+      ]
+    });
+    const state = makeState(fake.url, [
+      // 注意: fly list 完全没有 tb-seller-ghost
+      { name: "tb-seller-other", status: "running", owner: "vendor-a" }
+    ]);
+
+    const rows = await state.sellers();
+    expect(rows).toHaveLength(2); // ghost + other
+    const ghost = rows.find((r) => r.id === "ghost");
+    expect(ghost).toBeDefined();
+    expect(ghost!.dataSource).toBe("registry");
+    expect(ghost!.registryAlert).toBe(true);
+    expect(ghost!.alertReason).toContain("registry 收录了但 fly app 失踪");
+    expect(ghost!.removeHint).toContain("立即下线 (registry-only)");
+
+    const other = rows.find((r) => r.app === "tb-seller-other");
+    expect(other).toBeDefined();
+    expect(other!.dataSource).toBe("fly");
+    expect(other!.registryAlert).toBeFalsy();
+  });
+
+  test("case 4: both, /manifest 失败 → 灰/红点, dataSource 仍 = both", async () => {
+    fake.setRegistry({
+      version: 7,
+      sellers: [
+        {
+          id: "down",
+          name: "Down Seller",
+          app: "tb-seller-down",
+          url: `${fake.url}/down-base`,
+          status: "active",
+          supportedProtocols: ["chat_completions"],
+          paymentMethods: ["clawtip"],
+          models: ["gpt-5.4"]
+        }
+      ]
+    });
+    fake.setManifestPath("/down-base/manifest", { status: 502, body: { error: "upstream down" } });
+    const state = makeState(fake.url, [
+      { name: "tb-seller-down", status: "running", owner: "vendor-a" }
+    ]);
+
+    const rows = await state.sellers();
+    expect(rows).toHaveLength(1);
+    expect(rows[0].dataSource).toBe("both");
+    expect(rows[0].registryAlert).toBeFalsy();
+    // /manifest 失败 → nodeStatus=unknown (不是 active)
+    expect(rows[0].nodeStatus).toBe("unknown");
+  });
+});

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/);
+  });
+});