@downcity/city 1.1.39 → 1.1.47

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

package/src/terminal/admin/commands/service-env.ts

@@ -0,0 +1,256 @@
+/**
+ * Admin Env 管理命令。
+ *
+ * 三种模式：
+ * - Init：遍历所有 service 的 env 需求，逐一交互式配置
+ * - 按 Service 查看：选择一个 service，查看/配置其 env
+ * - 直接管理：list / upsert / remove 裸 key-value
+ */
+
+import { AdminClient } from "@downcity/conduit";
+import { select, isCancel } from "@clack/prompts";
+import { askText, show, showError, showSuccess } from "../../core/ui.js";
+import { adminErrorMessage, isAdminNotFoundError, rethrowAdminAuthError } from "../auth-error.js";
+
+interface EnvRequirement {
+  /** 环境变量 key */
+  key: string;
+  /** 给管理员展示的说明文本 */
+  description: string;
+  /** 当前是否必须配置 */
+  required: boolean;
+  /** 当前 InfraRuntime 是否已配置该 key */
+  configured: boolean;
+  /** 当前值的安全预览 */
+  value_preview?: string;
+}
+
+interface ServiceEnv {
+  /** 逻辑分组 ID */
+  id: string;
+  /** 分组展示名称 */
+  name: string;
+  /** 当前分组包含的 env 需求列表 */
+  env: EnvRequirement[];
+}
+
+export async function manageEnv(a: AdminClient): Promise<void> {
+  while (true) {
+    const services = await fetchEnvScopes(a);
+
+    const choices: { label: string; value: string; hint?: string }[] = [
+      { label: "Init (walk through all)", value: "__init__", hint: "Configure all missing env keys in sequence" },
+      { label: "List all", value: "__list__", hint: "Show all configured env variables" },
+      { label: "Upsert", value: "__upsert__", hint: "Add or update a key=value" },
+      { label: "Update", value: "__update__", hint: "Update an existing key" },
+      { label: "Remove", value: "__remove__", hint: "Delete a key" },
+    ];
+
+    if (services) {
+      for (const s of services) {
+        const configured = s.env.filter((item) => item.configured).length;
+        choices.push({
+          label: `  ${s.name} (${configured}/${s.env.length} configured)`,
+          value: s.id,
+          hint: s.env.map((e) => `${e.key}${e.configured ? "✓" : ""}`).join(", "),
+        });
+      }
+    }
+
+    choices.push({ label: "Back", value: "back", hint: "Return to admin menu" });
+
+    const svcId = await select({ message: "Env", options: choices });
+    if (!svcId || isCancel(svcId) || svcId === "back") return;
+
+    if (svcId === "__init__" && services) { await initAllEnv(a, services); continue; }
+    if (svcId === "__list__") { await listAllEnv(a); continue; }
+    if (svcId === "__upsert__") { await upsertEnv(a); continue; }
+    if (svcId === "__update__") { await updateEnv(a); continue; }
+    if (svcId === "__remove__") { await removeEnv(a); continue; }
+
+    if (services) {
+      const svc = services.find((s) => s.id === svcId);
+      if (svc) await configureServiceEnv(a, svc);
+    }
+  }
+}
+
+// ============================================================
+// Init 模式
+// ============================================================
+
+async function initAllEnv(a: AdminClient, services: ServiceEnv[]): Promise<void> {
+  const configuredKeys = new Set(
+    services.flatMap((svc) => svc.env.filter((item) => item.configured).map((item) => item.key)),
+  );
+  let changed = false;
+
+  for (const svc of services) {
+    show(`\n── ${svc.name} ──────────────────────────────`);
+    for (const req of svc.env) {
+      if (configuredKeys.has(req.key)) { show(`  ${req.key} ✓ (already set)`); continue; }
+
+      const label = req.required
+        ? `${req.key} (${req.description})`
+        : `${req.key} (${req.description}, optional — enter to skip)`;
+
+      const value = await askText(label);
+      if (!value) { if (req.required) show(`  ${req.key} ✗ skipped (required)`); continue; }
+
+      try {
+        await a.env.upsert({ key: req.key, value });
+        configuredKeys.add(req.key);
+        showSuccess(`  ${req.key}`);
+        changed = true;
+      } catch (e) {
+        rethrowAdminAuthError(e);
+        showError(`  ${req.key}: ${adminErrorMessage(e)}`);
+      }
+    }
+  }
+
+  if (changed) showSuccess("\nEnv init complete.");
+  else show("\nAll env keys are already configured.");
+}
+
+// ============================================================
+// 直接管理模式
+// ============================================================
+
+async function listAllEnv(a: AdminClient): Promise<void> {
+  try {
+    const items = await a.env.list();
+    if (items.length === 0) { show("No env variables configured."); return; }
+    console.log(`\n${items.length} env:\n`);
+    for (const e of items) {
+      console.log(`  ${e.key.padEnd(35)} ${maskValue(e.value, 40)}`);
+    }
+    console.log("");
+  } catch (e) {
+    rethrowAdminAuthError(e);
+    showError(adminErrorMessage(e));
+  }
+}
+
+async function upsertEnv(a: AdminClient): Promise<void> {
+  const key = await askText("key");
+  if (!key) return;
+  const value = await askText("value");
+  if (!value) return;
+  try {
+    await a.env.upsert({ key, value });
+    showSuccess(`upserted: ${key}`);
+  } catch (e) {
+    rethrowAdminAuthError(e);
+    showError(adminErrorMessage(e));
+  }
+}
+
+async function updateEnv(a: AdminClient): Promise<void> {
+  const items = await fetchCurrentEnv(a);
+  if (items.length === 0) { show("No env variables to update."); return; }
+
+  const choices = items.map((e) => ({
+    label: e.key, value: e.key, hint: `current: ${maskValue(e.value, 20)}`,
+  }));
+  choices.push({ label: "Cancel", value: "__cancel__", hint: "Return without changes" });
+
+  const key = await select({ message: "Select key to update", options: choices });
+  if (!key || isCancel(key) || key === "__cancel__") return;
+
+  const current = items.find((e) => e.key === key)!;
+  const value = await askText(`New value (current: ${maskValue(current.value, 16)})`);
+  if (!value) return;
+
+  try {
+    await a.env.upsert({ key: key as string, value });
+    showSuccess(`updated: ${key}`);
+  } catch (e) {
+    rethrowAdminAuthError(e);
+    showError(adminErrorMessage(e));
+  }
+}
+
+async function removeEnv(a: AdminClient): Promise<void> {
+  const key = await askText("key");
+  if (!key) return;
+  try {
+    await a.env.remove(key);
+    showSuccess(`removed: ${key}`);
+  } catch (e) {
+    rethrowAdminAuthError(e);
+    showError(adminErrorMessage(e));
+  }
+}
+
+// ============================================================
+// 按 Service 查看
+// ============================================================
+
+async function configureServiceEnv(a: AdminClient, svc: ServiceEnv): Promise<void> {
+  while (true) {
+    const scopes = await fetchEnvScopes(a);
+    const currentScope = scopes?.find((item) => item.id === svc.id) ?? svc;
+
+    const choices = currentScope.env.map((req) => {
+      const status = req.configured
+        ? `✓ configured${req.value_preview ? ` (${req.value_preview})` : ""}`
+        : (req.required ? "✗ MISSING" : "○ unset");
+      return { label: req.key, value: req.key, hint: `${req.description} [${status}]` };
+    });
+    choices.push({ label: "Back", value: "back", hint: "Return to env menu" });
+
+    const key = await select({ message: `${svc.name} — configure`, options: choices });
+    if (!key || isCancel(key) || key === "back") return;
+
+    const req = currentScope.env.find((e) => e.key === key)!;
+    const hint = req.configured
+      ? `(current: ${req.value_preview ?? "configured"}, enter a new value to replace it)`
+      : "";
+    const value = await askText(`${req.description} ${hint}`);
+    if (!value) continue;
+
+    try {
+      if (value) { await a.env.upsert({ key: req.key, value }); showSuccess(`set ${req.key}`); }
+    } catch (e) {
+      rethrowAdminAuthError(e);
+      showError(adminErrorMessage(e));
+    }
+  }
+}
+
+// ============================================================
+// 工具
+// ============================================================
+
+async function fetchEnvScopes(a: AdminClient): Promise<ServiceEnv[] | undefined> {
+  try {
+    const scopes = await a.env.catalog();
+    if (scopes.length === 0) {
+      show("No services or AI models with env requirements found.");
+      return undefined;
+    }
+    return scopes;
+  } 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 undefined;
+    }
+    showError(`Failed to fetch env catalog: ${adminErrorMessage(e)}`);
+    return undefined;
+  }
+}
+
+async function fetchCurrentEnv(a: AdminClient): Promise<{ key: string; value: string }[]> {
+  try {
+    return await a.env.list();
+  } catch (e) {
+    rethrowAdminAuthError(e);
+    return [];
+  }
+}
+
+function maskValue(v: string, n: number): string {
+  return v.length <= n ? v : v.slice(0, n) + "...";
+}

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

@@ -0,0 +1,44 @@
+/**
+ * Admin Usage 管理命令。
+ */
+
+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 manageUsage(a: AdminClient): Promise<void> {
+  const svc = a.service("usage");
+  while (true) {
+    const act = await select({
+      message: "Usage",
+      options: [
+        { label: "List events", value: "events" },
+        { label: "Summary", value: "summary" },
+        { label: "Back", value: "back" },
+      ],
+    });
+    if (!act || isCancel(act) || act === "back") return;
+
+    try {
+      if (act === "events") {
+        const b = await svc.get<{ items: { product_id: string; service: string; status: string; created_at: string }[] }>("events");
+        console.log(`\n${b.items.length} events:\n`);
+        for (const e of b.items.slice(-20)) {
+          console.log(`  ${e.created_at.slice(0, 19)}  ${e.product_id.padEnd(22)} ${e.service.padEnd(15)} [${e.status}]`);
+        }
+        console.log("");
+      } else {
+        const b = await svc.get<{ items: { product_id: string; service: string; status: string; count: number }[] }>("summary");
+        console.log(`\nSummary:\n`);
+        for (const s of b.items) {
+          console.log(`  ${s.product_id.padEnd(22)} ${s.service.padEnd(15)} ${String(s.count).padStart(5)} [${s.status}]`);
+        }
+        console.log("");
+      }
+    } catch (e) {
+      rethrowAdminAuthError(e);
+      showError(adminErrorMessage(e));
+    }
+  }
+}

package/src/terminal/admin/loop.ts

@@ -0,0 +1,69 @@
+/**
+ * Admin 命令循环。返回 "logout" | "quit" | "switch_identity"。
+ */
+
+import { AdminClient } from "@downcity/conduit";
+import { select, isCancel } from "@clack/prompts";
+import { type AdminSession } from "../core/session.js";
+import { showError, showSuccess } from "../core/ui.js";
+import { adminErrorMessage, isAdminAuthError } from "./auth-error.js";
+import { manageEnv } from "./commands/service-env.js";
+import { manageProducts } from "./commands/products.js";
+import { manageAccounts } from "./commands/accounts.js";
+import { manageBalance } from "./commands/balance.js";
+import { manageUsage } from "./commands/usage.js";
+import { managePayment } from "./commands/payment.js";
+import { manageCustom } from "./commands/custom.js";
+import { manageModels } from "./commands/models.js";
+import { manageInstruction } from "./commands/instruction.js";
+
+const commands: Record<string, (a: AdminClient, baseUrl: string) => Promise<void>> = {
+  env: manageEnv,
+  instruction: manageInstruction,
+  models: manageModels,
+  products: manageProducts,
+  accounts: manageAccounts,
+  balance: manageBalance,
+  usage: manageUsage,
+  payment: managePayment,
+  custom: manageCustom,
+};
+
+export async function adminLoop(session: AdminSession): Promise<"logout" | "quit" | "switch_identity"> {
+  const admin = new AdminClient({ base_url: session.base_url, admin_secret_key: session.admin_token });
+
+  while (true) {
+    const svc = await select({
+      message: "Manage Service",
+      options: [
+        { label: "Env", value: "env", hint: "View & configure environment variables" },
+        { label: "Infra Instruction", value: "instruction", hint: "Read aggregated base/service/service guidance" },
+        { label: "Models", value: "models", hint: "Read model readiness and missing env" },
+        { label: "Products", value: "products" },
+        { label: "Accounts", value: "accounts" },
+        { label: "Balance", value: "balance" },
+        { label: "Usage", value: "usage" },
+        { label: "Payment (Stripe)", value: "payment" },
+        { label: "Custom service...", value: "custom" },
+        { label: "Switch to User", value: "switch" },
+        { label: "Logout", value: "logout" },
+        { label: "Quit", value: "quit" },
+      ],
+    });
+    if (!svc || isCancel(svc)) return "quit";
+
+    if (svc === "quit") return "quit";
+    if (svc === "logout") { showSuccess("left admin mode"); return "logout"; }
+    if (svc === "switch") return "switch_identity";
+
+    try {
+      await commands[svc]?.(admin, session.base_url);
+    } catch (e) {
+      if (isAdminAuthError(e)) {
+        showError(adminErrorMessage(e));
+        return "logout";
+      }
+      showError(adminErrorMessage(e));
+    }
+  }
+}