@downcity/city 1.1.32 → 1.1.47

package/src/terminal/admin/commands/accounts.ts

@@ -0,0 +1,44 @@
+/**
+ * Admin Accounts 管理命令。
+ */
+
+import { AdminClient } from "@downcity/conduit";
+import { select, isCancel } from "@clack/prompts";
+import { showError } from "../../core/ui.js";
+import { adminErrorMessage, rethrowAdminAuthError } from "../auth-error.js";
+
+export async function manageAccounts(a: AdminClient): Promise<void> {
+  const svc = a.service("accounts");
+  while (true) {
+    const act = await select({
+      message: "Accounts",
+      options: [
+        { label: "List users", value: "users" },
+        { label: "List sessions", value: "sessions" },
+        { label: "Back", value: "back" },
+      ],
+    });
+    if (!act || isCancel(act) || act === "back") return;
+
+    try {
+      if (act === "users") {
+        const b = await svc.get<{ items: { user_id: string; email: string; created_at: string }[] }>("users");
+        console.log(`\n${b.items.length} users:\n`);
+        for (const u of b.items) {
+          console.log(`  ${u.user_id.padEnd(30)} ${u.email.padEnd(30)} ${u.created_at.slice(0, 10)}`);
+        }
+        console.log("");
+      } else {
+        const b = await svc.get<{ items: { session_id: string; user_id: string; status: string }[] }>("sessions");
+        console.log(`\n${b.items.length} sessions:\n`);
+        for (const s of b.items) {
+          console.log(`  ${s.session_id.padEnd(36)} ${s.user_id.padEnd(30)} [${s.status}]`);
+        }
+        console.log("");
+      }
+    } catch (e) {
+      rethrowAdminAuthError(e);
+      showError(adminErrorMessage(e));
+    }
+  }
+}

package/src/terminal/admin/commands/balance.ts

@@ -0,0 +1,160 @@
+/**
+ * Admin Balance 管理命令。
+ */
+
+import { AdminClient } from "@downcity/conduit";
+import { isCancel, select } from "@clack/prompts";
+import { askText, showError, showSuccess } from "../../core/ui.js";
+import { adminErrorMessage, rethrowAdminAuthError } from "../auth-error.js";
+
+export async function manageBalance(a: AdminClient): Promise<void> {
+  while (true) {
+    const act = await select({
+      message: "Balance",
+      options: [
+        { label: "List users", value: "users" },
+        { label: "History", value: "history" },
+        { label: "Topups", value: "topups" },
+        { label: "Redeem codes", value: "redeem_codes" },
+        { label: "Add balance", value: "add" },
+        { label: "Subtract balance", value: "sub" },
+        { label: "Finish topup", value: "finish" },
+        { label: "Cancel topup", value: "cancel" },
+        { label: "Create redeem code", value: "create_redeem_code" },
+        { label: "Disable redeem code", value: "disable_redeem_code" },
+        { label: "Back", value: "back" },
+      ],
+    });
+    if (!act || isCancel(act) || act === "back") return;
+
+    try {
+      if (act === "users") {
+        const items = await a.balance.listUsers(30);
+        console.log(`\n${items.length} balance accounts:\n`);
+        for (const item of items) {
+          console.log(`  ${item.user_id.padEnd(28)} ${String(item.balance).padStart(8)} ${item.unit.padEnd(10)} ${item.updated_at.slice(0, 19)}`);
+        }
+        console.log("");
+        continue;
+      }
+
+      if (act === "history") {
+        const userId = await askText("user_id (optional)");
+        const items = await a.balance.listHistory({
+          limit: 30,
+          user_id: userId ?? "",
+        });
+        console.log(`\n${items.length} balance history entries:\n`);
+        for (const item of items) {
+          console.log(`  ${item.created_at.slice(0, 19)}  ${item.user_id.padEnd(20)} ${item.kind.padEnd(8)} ${String(item.amount).padStart(6)} -> ${String(item.balance_after).padStart(6)}  ${item.note}`);
+        }
+        console.log("");
+        continue;
+      }
+
+      if (act === "topups") {
+        const userId = await askText("user_id (optional)");
+        const items = await a.balance.listTopups({
+          limit: 30,
+          user_id: userId ?? "",
+        });
+        console.log(`\n${items.length} topup orders:\n`);
+        for (const item of items) {
+          console.log(`  ${item.topup_id.padEnd(24)} ${item.user_id.padEnd(20)} ${String(item.amount).padStart(6)} ${item.unit.padEnd(10)} [${item.status}] ${item.note}`);
+        }
+        console.log("");
+        continue;
+      }
+
+      if (act === "redeem_codes") {
+        const status = await askText("status (optional: active/redeemed/disabled)");
+        const userId = await askText("redeemed_by_user_id (optional)");
+        const items = await a.balance.redeemCodes.list({
+          limit: 30,
+          status: normalizeRedeemCodeStatus(status),
+          user_id: userId ?? "",
+        });
+        console.log(`\n${items.length} redeem codes:\n`);
+        for (const item of items) {
+          const owner = item.redeemed_by_user_id || "-";
+          console.log(`  ${item.redeem_code_id.padEnd(24)} ${item.code_mask.padEnd(22)} ${String(item.amount).padStart(6)} ${item.unit.padEnd(10)} [${item.status.padEnd(8)}] ${owner.padEnd(20)} ${item.note}`);
+        }
+        console.log("");
+        continue;
+      }
+
+      if (act === "add" || act === "sub") {
+        const userId = await askText("user_id");
+        if (!userId) continue;
+        const rawAmount = await askText("amount");
+        if (!rawAmount) continue;
+
+        const amount = Number(rawAmount);
+        if (!Number.isInteger(amount) || amount <= 0) {
+          showError("amount must be a positive integer");
+          continue;
+        }
+
+        const note = await askText("note (optional)");
+        const account = act === "add"
+          ? await a.balance.add({ user_id: userId, amount, note: note ?? "" })
+          : await a.balance.sub({ user_id: userId, amount, note: note ?? "" });
+        showSuccess(`balance updated: ${account.user_id} -> ${account.balance} ${account.unit}`);
+        continue;
+      }
+
+      if (act === "create_redeem_code") {
+        const rawAmount = await askText("amount");
+        if (!rawAmount) continue;
+
+        const amount = Number(rawAmount);
+        if (!Number.isInteger(amount) || amount <= 0) {
+          showError("amount must be a positive integer");
+          continue;
+        }
+
+        const code = await askText("custom redeem_code (optional)");
+        const note = await askText("note (optional)");
+        const issued = await a.balance.redeemCodes.create({
+          amount,
+          code: code ?? "",
+          note: note ?? "",
+        });
+        showSuccess(`redeem_code created: ${issued.redeem_code_id} -> ${issued.code} (+${issued.amount} ${issued.unit})`);
+        continue;
+      }
+
+      if (act === "disable_redeem_code") {
+        const redeemCodeId = await askText("redeem_code_id");
+        if (!redeemCodeId) continue;
+        const note = await askText("note (optional)");
+        const item = await a.balance.redeemCodes.disable({
+          redeem_code_id: redeemCodeId,
+          note: note ?? "",
+        });
+        showSuccess(`redeem_code updated: ${item.redeem_code_id} -> ${item.status}`);
+        continue;
+      }
+
+      const topupId = await askText("topup_id");
+      if (!topupId) continue;
+      const note = await askText("note (optional)");
+      const topup = act === "finish"
+        ? await a.balance.finishTopup({ topup_id: topupId, note: note ?? "" })
+        : await a.balance.cancelTopup({ topup_id: topupId, note: note ?? "" });
+      showSuccess(`topup updated: ${topup.topup_id} -> ${topup.status}`);
+    } catch (e) {
+      rethrowAdminAuthError(e);
+      showError(adminErrorMessage(e));
+    }
+  }
+}
+
+function normalizeRedeemCodeStatus(value: string | undefined): "active" | "redeemed" | "disabled" | undefined {
+  const normalized = String(value ?? "").trim();
+  if (!normalized) return undefined;
+  if (normalized === "active" || normalized === "redeemed" || normalized === "disabled") {
+    return normalized;
+  }
+  throw new TypeError("status must be active, redeemed, or disabled");
+}

package/src/terminal/admin/commands/config.ts

@@ -0,0 +1,13 @@
+/**
+ * 旧的 Admin Server URL 命令兼容壳。
+ *
+ * 关键说明（中文）
+ * - 新交互下，server 管理已经提升到顶层 Manage Servers
+ * - 这里保留空壳是为了避免历史导入直接报错
+ */
+
+import { type AdminSession } from "../../core/session.js";
+
+export async function changeServerUrl(_session: AdminSession): Promise<boolean> {
+  return false;
+}

package/src/terminal/admin/commands/custom.ts

@@ -0,0 +1,46 @@
+/**
+ * Admin Custom Service 命令。
+ */
+
+import { AdminClient } from "@downcity/conduit";
+import { select, isCancel } from "@clack/prompts";
+import { askText, showError } from "../../core/ui.js";
+import { adminErrorMessage, rethrowAdminAuthError } from "../auth-error.js";
+
+export async function manageCustom(a: AdminClient): Promise<void> {
+  while (true) {
+    const name = await askText("service name (empty to go back)");
+    if (!name) return;
+
+    const act = await select({
+      message: name,
+      options: [
+        { label: "GET", value: "get" },
+        { label: "POST", value: "post" },
+        { label: "Back", value: "back" },
+      ],
+    });
+    if (!act || isCancel(act) || act === "back") return;
+
+    try {
+      const svc = a.service(name);
+      if (act === "get") {
+        const path = await askText("path") ?? "";
+        console.log(JSON.stringify(await svc.get(path), null, 2));
+      } else {
+        const raw = await askText("body (JSON)") ?? "{}";
+        let body: Record<string, unknown>;
+        try {
+          body = JSON.parse(raw);
+        } catch {
+          showError("Invalid JSON body");
+          continue;
+        }
+        console.log(JSON.stringify(await svc.action("").invoke(body), null, 2));
+      }
+    } catch (e) {
+      rethrowAdminAuthError(e);
+      showError(adminErrorMessage(e));
+    }
+  }
+}

package/src/terminal/admin/commands/instruction.ts

@@ -0,0 +1,12 @@
+/**
+ * Admin Infra 说明文档查看命令。
+ */
+
+import { AdminClient } from "@downcity/conduit";
+
+/**
+ * 展示当前 InfraRuntime 聚合后的说明文档。
+ */
+export async function manageInstruction(a: AdminClient): Promise<void> {
+  console.log(`\n${await a.instruction()}\n`);
+}

package/src/terminal/admin/commands/models.ts

@@ -0,0 +1,64 @@
+/**
+ * Admin Models 只读视图。
+ *
+ * 关键说明（中文）
+ * - 这里不提供模型新增、删除、启停。
+ * - 模型定义仍然来自代码注册；admin 只负责查看当前可用状态。
+ * - 如果模型缺少 provider key，会在这里直接显示缺失项。
+ */
+
+import { AdminClient } from "@downcity/conduit";
+import { show, showError } from "../../core/ui.js";
+import { adminErrorMessage, isAdminNotFoundError, rethrowAdminAuthError } from "../auth-error.js";
+
+/**
+ * 展示全部代码注册模型及其运行状态。
+ */
+export async function manageModels(a: AdminClient): Promise<void> {
+  try {
+    const [modelResp, envCatalog] = await Promise.all([
+      a.listModels(),
+      a.env.catalog(),
+    ]);
+    const items = modelResp ?? [];
+    const aiScope = envCatalog.find((item) => item.id === "ai-models");
+    const envMap = new Map(aiScope?.env.map((item) => [item.key, item.configured]) ?? []);
+
+    if (items.length === 0) {
+      show("No models registered on server.");
+      return;
+    }
+
+    console.log(`\n${items.length} models:\n`);
+    for (const model of items) {
+      const requirements = model.env_requirements ?? [];
+      const missingEnv = requirements
+        .filter((item) => item.required && !envMap.get(item.key))
+        .map((item) => item.key);
+      const status = missingEnv.length === 0 ? "READY" : `MISSING ${missingEnv.join(", ")}`;
+      const defaults = (model.default_modes ?? []).length > 0
+        ? `default: ${(model.default_modes ?? []).join(", ")}`
+        : "default: none";
+      const envText = requirements.length > 0
+        ? requirements
+          .map((item) => `${item.key}${envMap.get(item.key) ? "✓" : "✗"}`)
+          .join(", ")
+        : "none";
+
+      console.log(`  ${model.name} (${model.id})`);
+      console.log(`    status: ${status}`);
+      console.log(`    modalities: ${model.modalities.join(", ") || "none"}`);
+      console.log(`    ${defaults}`);
+      console.log(`    env: ${envText}`);
+      if (model.description) console.log(`    desc: ${model.description}`);
+      console.log("");
+    }
+  } catch (e) {
+    rethrowAdminAuthError(e);
+    if (isAdminNotFoundError(e)) {
+      showError("Connected InfraRuntime is too old and does not expose /v1/env/catalog yet. Deploy the latest worker/server first.");
+      return;
+    }
+    showError(adminErrorMessage(e));
+  }
+}

package/src/terminal/admin/commands/payment.ts

@@ -0,0 +1,94 @@
+/**
+ * Admin Payment 管理命令。
+ */
+
+import { AdminClient } from "@downcity/conduit";
+import { select, isCancel } from "@clack/prompts";
+import { buildStripeEndpoints } from "../../core/stripe.js";
+import { show, showError } from "../../core/ui.js";
+import { adminErrorMessage, rethrowAdminAuthError } from "../auth-error.js";
+
+interface StripePaymentListItem {
+  /** 支付记录 ID */
+  payment_id: string;
+  /** 充值单 ID */
+  topup_id: string;
+  /** 用户 ID */
+  user_id: string;
+  /** 充值金额 */
+  amount: number;
+  /** 结算币种 */
+  currency: string;
+  /** 当前状态 */
+  status: string;
+  /** 更新时间 */
+  updated_at: string;
+}
+
+interface StripeEventListItem {
+  /** 事件 ID */
+  event_id: string;
+  /** 事件类型 */
+  type: string;
+  /** 同步状态 */
+  sync_status: string;
+  /** 同步错误 */
+  sync_error: string;
+  /** 创建时间 */
+  created_at: string;
+}
+
+export async function managePayment(a: AdminClient, baseUrl: string): Promise<void> {
+  const svc = a.service("payment.stripe");
+  const endpoints = buildStripeEndpoints(baseUrl);
+  while (true) {
+    const act = await select({
+      message: "Payment",
+      options: [
+        { label: "Show webhook setup", value: "webhook", hint: endpoints.webhook_url },
+        { label: "List payments", value: "payments" },
+        { label: "List webhook events", value: "events" },
+        { label: "Back", value: "back" },
+      ],
+    });
+    if (!act || isCancel(act) || act === "back") return;
+
+    try {
+      if (act === "webhook") {
+        show([
+          `Server URL: ${endpoints.base_url}`,
+          `Stripe webhook endpoint: ${endpoints.webhook_url}`,
+          "Recommended Stripe events:",
+          "- checkout.session.completed",
+          "- checkout.session.expired",
+          "- payment_intent.payment_failed",
+          "After creating the endpoint in Stripe Dashboard, copy its Signing secret into STRIPE_WEBHOOK_SECRET.",
+        ].join("\n"));
+        continue;
+      }
+
+      if (act === "payments") {
+        const result = await svc.get<{ items: StripePaymentListItem[] }>("payments");
+        console.log(`\n${result.items.length} payments:\n`);
+        for (const item of result.items) {
+          console.log(
+            `  ${item.updated_at.slice(0, 19)}  ${item.user_id.padEnd(20)} ${String(item.amount).padStart(6)} ${item.currency.padEnd(6)} [${item.status}] ${item.payment_id}`,
+          );
+        }
+        console.log("");
+        continue;
+      }
+
+      const result = await svc.get<{ items: StripeEventListItem[] }>("events");
+      console.log(`\n${result.items.length} webhook events:\n`);
+      for (const item of result.items) {
+        const error = item.sync_error ? ` ${item.sync_error}` : "";
+        console.log(`  ${item.created_at.slice(0, 19)}  ${item.type.padEnd(32)} [${item.sync_status}] ${item.event_id}${error}`);
+      }
+      console.log("");
+    } catch (e) {
+      rethrowAdminAuthError(e);
+      showError(adminErrorMessage(e));
+    }
+  }
+}

package/src/terminal/admin/commands/products.ts

@@ -0,0 +1,72 @@
+/**
+ * Admin Products 管理命令。
+ */
+
+import { AdminClient } from "@downcity/conduit";
+import { select, isCancel } from "@clack/prompts";
+import { askText, showError, showSuccess } from "../../core/ui.js";
+import { adminErrorMessage, rethrowAdminAuthError } from "../auth-error.js";
+
+export async function manageProducts(a: AdminClient): Promise<void> {
+  while (true) {
+    const act = await select({
+      message: "Products",
+      options: [
+        { label: "List all", value: "list" },
+        { label: "Create", value: "create" },
+        { label: "Pause", value: "pause" },
+        { label: "Activate", value: "activate" },
+        { label: "Remove", value: "remove" },
+        { label: "Issue token", value: "token" },
+        { label: "Back", value: "back" },
+      ],
+    });
+    if (!act || isCancel(act) || act === "back") return;
+
+    try {
+      if (act === "list") {
+        const items = await a.products.list();
+        console.log(`\n${items.length} products:\n`);
+        for (const p of items) {
+          console.log(`  ${p.product_id.padEnd(24)} ${p.name.padEnd(20)} [${p.status}]`);
+        }
+        console.log("");
+      } else if (act === "create") {
+        const n = await askText("product name");
+        if (!n) continue;
+        const productId = await askText("product_id (optional)");
+        const p = await a.products.create(
+          productId
+            ? { name: n, product_id: productId }
+            : { name: n },
+        );
+        showSuccess(`created: ${p.product_id}`);
+      } else if (act === "pause") {
+        const id = await askText("product_id");
+        if (!id) continue;
+        await a.products.pause(id);
+        showSuccess(`paused: ${id}`);
+      } else if (act === "activate") {
+        const id = await askText("product_id");
+        if (!id) continue;
+        await a.products.activate(id);
+        showSuccess(`activated: ${id}`);
+      } else if (act === "remove") {
+        const id = await askText("product_id");
+        if (!id) continue;
+        await a.products.remove(id);
+        showSuccess(`removed: ${id}`);
+      } else if (act === "token") {
+        const pid = await askText("product_id");
+        if (!pid) continue;
+        const uid = await askText("user_id");
+        if (!uid) continue;
+        const t = await a.products.tokens.apply({ product_id: pid, user_id: uid });
+        showSuccess(`token: ${t.user_token.slice(0, 20)}...`);
+      }
+    } catch (e) {
+      rethrowAdminAuthError(e);
+      showError(adminErrorMessage(e));
+    }
+  }
+}