@tokenbuddy/tb-admin 1.0.30 → 1.0.32

package/dist/src/client.d.ts

@@ -3,8 +3,8 @@
  * 内部封装 Bearer Token 鉴权、JSON 序列化、非 2xx 抛错的统一行为。
  */
 export declare class AdminClient {
-    private baseUrl;
-    private token;
+    protected baseUrl: string;
+    protected token: string;
     constructor(baseUrl: string, token: string);
     private request;
     get(path: string): Promise<any>;
@@ -21,4 +21,84 @@ export declare class AdminClient {
         [key: string]: string;
     }): Promise<any>;
 }
+/**
+ * Vendor domain client. Step 5 of the registry redesign: vendor
+ * tokens call `/platform/*` (Bearer auth). The old `bootstrap
+ * config*`, `bootstrap registry publish`, and `bootstrap default-
+ * seller set` commands have been removed; vendors stage sellers and
+ * submit release requests instead.
+ */
+export declare class RegistryVendorClient extends AdminClient {
+    me(): Promise<{
+        vendor: {
+            id: string;
+            name: string;
+            status: string;
+        };
+    }>;
+    listSellers(): Promise<{
+        sellers: unknown[];
+    }>;
+    /**
+     * Step 14 (v1.1): vendor-scoped seller status mutation.
+     * Replaces the old `tb-admin bootstrap sellers status` path which called
+     * /operator/registry/sellers/:id/status (operator-level, super-admin scope).
+     * Vendor can only mutate sellers in its own scope; the platform vendor
+     * (DEFAULT_PLATFORM_VENDOR_ID) can mutate any.
+     */
+    setSellerStatus(id: string, status: "active" | "draining" | "offline", options?: {
+        expectedVersion?: number;
+        idempotencyKey?: string;
+    }): Promise<{
+        registry: {
+            version: number;
+            sellers: unknown[];
+        };
+    }>;
+    stageSeller(seller: unknown): Promise<{
+        pendingSeller: unknown;
+    }>;
+    listPendingSellers(status?: string): Promise<{
+        pendingSellers: unknown[];
+    }>;
+    submitRelease(input: {
+        stagedSellerIds: string[];
+        note?: string;
+    }): Promise<{
+        releaseRequest: unknown;
+    }>;
+    listReleaseRequests(limit?: number): Promise<{
+        releaseRequests: unknown[];
+    }>;
+    getReleaseRequest(id: number): Promise<{
+        releaseRequest: unknown;
+    }>;
+}
+/**
+ * Super-admin client. Used by automated scripts / CI to drive the
+ * admin web endpoints (force-publish, registry versions, audit).
+ * Step 5 keeps this narrow; the human-facing flow is the browser.
+ */
+export declare class RegistryAdminClient extends AdminClient {
+    constructor(baseUrl: string, superAdminKey: string);
+    protected overrideHeaders(headers: Record<string, string>): Record<string, string>;
+    private requestAdmin;
+    listVendors(): Promise<{
+        vendors: unknown[];
+    }>;
+    createVendor(name: string): Promise<{
+        vendor: unknown;
+        token: string;
+    }>;
+    forcePublish(releaseId: number): Promise<{
+        releaseRequest: unknown;
+        publishedVersion: number | null;
+    }>;
+    listVersions(): Promise<{
+        versions: unknown[];
+    }>;
+    listAudit(): Promise<{
+        records: unknown[];
+    }>;
+}
 //# sourceMappingURL=client.d.ts.map

package/dist/src/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAS;gBAEV,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;YAK5B,OAAO;IA8BR,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAI/B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAIhF,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAIjF,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAIlF,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;CAGjG"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}

package/dist/src/client.js

@@ -52,4 +52,97 @@ export class AdminClient {
         return this.request(path, "DELETE", body, headers);
     }
 }
+/**
+ * Vendor domain client. Step 5 of the registry redesign: vendor
+ * tokens call `/platform/*` (Bearer auth). The old `bootstrap
+ * config*`, `bootstrap registry publish`, and `bootstrap default-
+ * seller set` commands have been removed; vendors stage sellers and
+ * submit release requests instead.
+ */
+export class RegistryVendorClient extends AdminClient {
+    async me() {
+        return this.get("/platform/me");
+    }
+    async listSellers() {
+        return this.get("/platform/sellers");
+    }
+    /**
+     * Step 14 (v1.1): vendor-scoped seller status mutation.
+     * Replaces the old `tb-admin bootstrap sellers status` path which called
+     * /operator/registry/sellers/:id/status (operator-level, super-admin scope).
+     * Vendor can only mutate sellers in its own scope; the platform vendor
+     * (DEFAULT_PLATFORM_VENDOR_ID) can mutate any.
+     */
+    async setSellerStatus(id, status, options = {}) {
+        const headers = {};
+        if (options.idempotencyKey) {
+            headers["Idempotency-Key"] = options.idempotencyKey;
+        }
+        return this.put(`/platform/sellers/${encodeURIComponent(id)}/status`, {
+            status,
+            ...(options.expectedVersion !== undefined ? { expectedVersion: options.expectedVersion } : {})
+        }, headers);
+    }
+    async stageSeller(seller) {
+        return this.post("/platform/sellers/stage", { seller });
+    }
+    async listPendingSellers(status) {
+        const path = status ? `/platform/sellers/pending?status=${encodeURIComponent(status)}` : "/platform/sellers/pending";
+        return this.get(path);
+    }
+    async submitRelease(input) {
+        return this.post("/platform/release-requests", input);
+    }
+    async listReleaseRequests(limit = 20) {
+        return this.get(`/platform/release-requests?limit=${limit}`);
+    }
+    async getReleaseRequest(id) {
+        return this.get(`/platform/release-requests/${id}`);
+    }
+}
+/**
+ * Super-admin client. Used by automated scripts / CI to drive the
+ * admin web endpoints (force-publish, registry versions, audit).
+ * Step 5 keeps this narrow; the human-facing flow is the browser.
+ */
+export class RegistryAdminClient extends AdminClient {
+    constructor(baseUrl, superAdminKey) {
+        // We pass the super-admin key as the "token" but override the
+        // Authorization header below — super-admin uses the
+        // `X-Registry-Admin-Key` header, not Bearer.
+        super(baseUrl, superAdminKey);
+    }
+    overrideHeaders(headers) {
+        return { ...headers, "X-Registry-Admin-Key": this.token };
+    }
+    async requestAdmin(path, method, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = this.overrideHeaders({ "Content-Type": "application/json" });
+        const options = { method, headers };
+        if (body)
+            options.body = JSON.stringify(body);
+        const response = await fetch(url, options);
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`HTTP Error ${response.status}: ${text || response.statusText}`);
+        }
+        const text = await response.text();
+        return text ? JSON.parse(text) : {};
+    }
+    async listVendors() {
+        return this.requestAdmin("/platform/vendors", "GET");
+    }
+    async createVendor(name) {
+        return this.requestAdmin("/platform/vendors", "POST", { name });
+    }
+    async forcePublish(releaseId) {
+        return this.requestAdmin(`/platform/admin/release-requests/${releaseId}/force-publish`, "POST");
+    }
+    async listVersions() {
+        return this.requestAdmin("/platform/admin/registry-versions", "GET");
+    }
+    async listAudit() {
+        return this.requestAdmin("/platform/audit", "GET");
+    }
+}
 //# sourceMappingURL=client.js.map

package/dist/src/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,WAAW;IACd,OAAO,CAAS;IAChB,KAAK,CAAS;IAEtB,YAAY,OAAe,EAAE,KAAa;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,MAAc,EAAE,IAAU,EAAE,eAA0C,EAAE;QAC1G,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;QACrC,MAAM,OAAO,GAA8B;YACzC,cAAc,EAAE,kBAAkB;YAClC,eAAe,EAAE,UAAU,IAAI,CAAC,KAAK,EAAE;YACvC,GAAG,YAAY;SAChB,CAAC;QAEF,MAAM,OAAO,GAAgB;YAC3B,MAAM;YACN,OAAO;SACR,CAAC;QAEF,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC3C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACxC,MAAM,IAAI,KAAK,CAAC,cAAc,QAAQ,CAAC,MAAM,KAAK,SAAS,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACxF,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,IAAY;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,IAAY,EAAE,IAAU,EAAE,OAAmC;QAC5E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,IAAU,EAAE,OAAmC;QAC7E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,IAAU,EAAE,OAAmC;QAC9E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,IAAU,EAAE,OAAmC;QAC/E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;CACF"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}

package/dist/src/provider.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Step 12 (provider-agnostic seller management):
+ * 抽象 seller provider 接口, 让 tb-admin CLI + UI 不再 hardcode
+ * Fly.io 调用。
+ *
+ * 设计原则 (跟用户 ZCG 在 2026-06-11 凌晨讨论):
+ *  - 一个 `SellerProvider` 实现对应一种底层平台 (Fly.io / mock / ...).
+ *  - 5 个核心操作: listApps / statusApp / createApp / deployApp / removeApp.
+ *  - 所有方法都接受 dryRun, 都在 provider config 缺失必填字段时抛错.
+ *  - 所有方法都支持 `json: true` 输出, 方便 UI / 测试 / 自动化调用.
+ *  - Provider 通过 `ProviderRegistry` 注册, 默认 'fly' 实现是
+ *    `FlyProvider` (从 server-cmd.ts 拆出), 'mock' 是测试实现.
+ *  - 调用方 (CLI / UI / 其他) 都通过 `ProviderRegistry.get(name)` 取.
+ *  - `tb-admin seller <cmd>` CLI 子命令全部加 `--provider <name>`
+ *    (默认 'fly') + `--json` flag.
+ *
+ * 注意: Fly 字段 (`flyctl_path` / `default_region` / ...) 仍放在
+ * `SellerProviderConfig` 里, 不引入新的 provider 专用 config 字段
+ * (避免拆得过细). 未来加 K8s / 自建集群 provider 时, 把 `flyctl_path`
+ * 等字段移到 `FlyConfig` 子接口, 让 `SellerProviderConfig` 持有
+ * 通用字段 (default_region / default_image / volume_* 跨 provider 通用).
+ */
+import type { SellerProviderConfig } from "./config.js";
+/** Dry-run / json 通用选项, 所有方法都接受 */
+export interface ProviderCallOptions {
+    dryRun?: boolean;
+    /** 静默: 不打 [Fly.io] / [Mock] 之类的人类可读日志, 只输出 json */
+    silent?: boolean;
+}
+/** Provider 必须能列出所有它知道的应用, 跨 provider 字段对齐 */
+export interface SellerAppEntry {
+    /** Provider 内的应用 id (Fly 跟 K8s 各自定义) */
+    name: string;
+    /** 状态 (active / suspended / deployed / pending / unknown). 各 provider 各自定义枚举. */
+    status: string;
+    /** Provider 内部 id, 跨 provider 不必有意义. UI 用它跳转详情. */
+    providerId: string;
+    /** Region / zone / namespace. */
+    region?: string;
+    /** 上次部署时间 ISO 字符串. */
+    lastDeployAt?: string;
+    /** provider 特有的元数据 (machines count / image / 等) */
+    metadata?: Record<string, unknown>;
+}
+/** Provider 创建入参. 字段尽量 provider-agnostic; 私有字段放 `providerOptions` */
+export interface SellerCreateInput {
+    name: string;
+    region?: string;
+    image?: string;
+    operatorSecret: string;
+    initialConfigPath?: string;
+    volumeName?: string;
+    volumeSizeGb?: number;
+    volumeId?: string;
+    volumeSnapshotRetentionDays?: number;
+    dryRun?: boolean;
+    /** provider 私有扩展 (FlyConfig / K8sConfig / ...) */
+    providerOptions?: Record<string, unknown>;
+}
+/** Provider deploy 入参 */
+export interface SellerDeployInput {
+    app: string;
+    image?: string;
+    dryRun?: boolean;
+    providerOptions?: Record<string, unknown>;
+}
+/** Provider 通用 5 操作接口 */
+export interface SellerProvider {
+    /** provider 名 ('fly' / 'mock' / 'k8s' 等), 用于 `tb-admin --provider <name>` 选择 */
+    readonly name: string;
+    /** 检测 provider runtime 是否装好 (flyctl / kubectl / etc). CLI 启动时调用一次. */
+    isAvailable(): boolean;
+    /** List all apps this provider manages. */
+    listApps(options?: ProviderCallOptions): Promise<SellerAppEntry[]>;
+    /** Get one app's status (machine state / region / last deploy). */
+    statusApp(name: string, options?: ProviderCallOptions): Promise<SellerAppEntry>;
+    /** Create + initial deploy. `dryRun` 模式只输出计划. */
+    createApp(input: SellerCreateInput): Promise<{
+        ok: true;
+        app: string;
+        dryRun: boolean;
+    }>;
+    /** Update image on existing app. */
+    deployApp(input: SellerDeployInput): Promise<{
+        ok: true;
+        app: string;
+        machines: string[];
+        dryRun: boolean;
+    }>;
+    /** Destroy app. */
+    removeApp(name: string, options?: ProviderCallOptions): Promise<{
+        ok: true;
+        app: string;
+        dryRun: boolean;
+    }>;
+}
+/**
+ * Provider registry: CLI / UI / 测试都通过 `ProviderRegistry.get(name)`
+ * 拿 provider. 构造时塞一份 SellerProviderConfig, 跟现有
+ * `configManager.getSellerProvider(name)` 同源.
+ */
+export declare class ProviderRegistry {
+    private configManager;
+    private providers;
+    constructor(configManager: {
+        getSellerProvider(name?: string): SellerProviderConfig | undefined;
+    });
+    /** 注册一个 provider. 测试场景用. */
+    register(provider: SellerProvider): void;
+    /** 取 provider. 默认 'fly'. 不存在抛错 (CLI 应该 fail fast). */
+    get(name?: string): SellerProvider;
+    /** 列出所有已注册 provider 名. */
+    list(): string[];
+}
+/**
+ * 默认 provider 工厂. 'fly' -> FlyProvider.
+ * 任何未知 name 抛错. 通过 import 避免循环依赖, 所以放在文件底部.
+ */
+export declare function createDefaultProvider(name: string, config: SellerProviderConfig): SellerProvider;
+//# sourceMappingURL=provider.d.ts.map

package/dist/src/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/provider.ts"],"names":[],"mappings":"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"}

package/dist/src/provider.js

@@ -0,0 +1,73 @@
+/**
+ * Step 12 (provider-agnostic seller management):
+ * 抽象 seller provider 接口, 让 tb-admin CLI + UI 不再 hardcode
+ * Fly.io 调用。
+ *
+ * 设计原则 (跟用户 ZCG 在 2026-06-11 凌晨讨论):
+ *  - 一个 `SellerProvider` 实现对应一种底层平台 (Fly.io / mock / ...).
+ *  - 5 个核心操作: listApps / statusApp / createApp / deployApp / removeApp.
+ *  - 所有方法都接受 dryRun, 都在 provider config 缺失必填字段时抛错.
+ *  - 所有方法都支持 `json: true` 输出, 方便 UI / 测试 / 自动化调用.
+ *  - Provider 通过 `ProviderRegistry` 注册, 默认 'fly' 实现是
+ *    `FlyProvider` (从 server-cmd.ts 拆出), 'mock' 是测试实现.
+ *  - 调用方 (CLI / UI / 其他) 都通过 `ProviderRegistry.get(name)` 取.
+ *  - `tb-admin seller <cmd>` CLI 子命令全部加 `--provider <name>`
+ *    (默认 'fly') + `--json` flag.
+ *
+ * 注意: Fly 字段 (`flyctl_path` / `default_region` / ...) 仍放在
+ * `SellerProviderConfig` 里, 不引入新的 provider 专用 config 字段
+ * (避免拆得过细). 未来加 K8s / 自建集群 provider 时, 把 `flyctl_path`
+ * 等字段移到 `FlyConfig` 子接口, 让 `SellerProviderConfig` 持有
+ * 通用字段 (default_region / default_image / volume_* 跨 provider 通用).
+ */
+/**
+ * Provider registry: CLI / UI / 测试都通过 `ProviderRegistry.get(name)`
+ * 拿 provider. 构造时塞一份 SellerProviderConfig, 跟现有
+ * `configManager.getSellerProvider(name)` 同源.
+ */
+export class ProviderRegistry {
+    configManager;
+    providers = new Map();
+    constructor(configManager) {
+        this.configManager = configManager;
+    }
+    /** 注册一个 provider. 测试场景用. */
+    register(provider) {
+        this.providers.set(provider.name, provider);
+    }
+    /** 取 provider. 默认 'fly'. 不存在抛错 (CLI 应该 fail fast). */
+    get(name = "fly") {
+        const registered = this.providers.get(name);
+        if (registered) {
+            return registered;
+        }
+        // 还没注册 -> 现造一个 (FlyProvider / MockProvider 各自 lazy 构造)
+        const config = this.configManager.getSellerProvider(name);
+        if (!config) {
+            throw new Error(`provider '${name}' is not configured. ` +
+                `Run \`tb-admin config set <profile>\` first, or add a [seller_providers.${name}] section.`);
+        }
+        const instance = createDefaultProvider(name, config);
+        this.providers.set(name, instance);
+        return instance;
+    }
+    /** 列出所有已注册 provider 名. */
+    list() {
+        return Array.from(this.providers.keys());
+    }
+}
+/**
+ * 默认 provider 工厂. 'fly' -> FlyProvider.
+ * 任何未知 name 抛错. 通过 import 避免循环依赖, 所以放在文件底部.
+ */
+export function createDefaultProvider(name, config) {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const { FlyProvider } = require("./server-cmd.js");
+    if (name === "fly") {
+        // Step 14 之前 FlyProvider 暂不 implements SellerProvider (保留 1.0.31 行为 1:1).
+        // 这里通过 unknown 桥接; 真用时调用方应通过 SellerCommandRunner 而不是直接用 ProviderRegistry.
+        return new FlyProvider(config);
+    }
+    throw new Error(`unknown provider name: '${name}' (built-in: fly)`);
+}
+//# sourceMappingURL=provider.js.map

package/dist/src/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AA2EH;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IAGP;IAFZ,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;IAEtD,YAAoB,aAAqF;QAArF,kBAAa,GAAb,aAAa,CAAwE;IAAG,CAAC;IAE7G,4BAA4B;IAC5B,QAAQ,CAAC,QAAwB;QAC/B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,sDAAsD;IACtD,GAAG,CAAC,OAAe,KAAK;QACtB,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,uDAAuD;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,aAAa,IAAI,uBAAuB;gBACxC,2EAA2E,IAAI,YAAY,CAC5F,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACrD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACnC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,0BAA0B;IAC1B,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,MAA4B;IAC9E,8DAA8D;IAC9D,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAqC,CAAC;IACvF,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,0EAA0E;QAC1E,0EAA0E;QAC1E,OAAO,IAAI,WAAW,CAAC,MAAM,CAA8B,CAAC;IAC9D,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,mBAAmB,CAAC,CAAC;AACtE,CAAC"}

package/dist/src/seller.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 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 { type SellerCreateOptions } from "./server-cmd.js";
+import type { ConfigManager } 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>;
+}
+/** 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[];
+}
+export type SellerCommandResult = SellerListResult | SellerStatusResult | SellerActionResult<"create"> | SellerActionResult<"deploy"> | SellerActionResult<"remove">;
+export declare class FlyCliMissingError extends Error {
+    readonly flyctl: string;
+    constructor(flyctl: string);
+}
+export declare class FlyCommandError extends Error {
+    readonly command: string;
+    readonly exitCode: number;
+    readonly stderr: string;
+    constructor(command: string, exitCode: number, stderr: string);
+}
+/**
+ * 解析 flyctl apps list 文本输出 (人类可读表) -> 数组.
+ * 默认路径不变; --json 路径用 `parseFlyListJson` 走结构化路径.
+ */
+declare function parseFlyListText(text: string): SellerAppJson[];
+declare function parseFlyListJson(jsonText: string): SellerAppJson[];
+declare function parseFlyStatusJson(jsonText: string): Record<string, unknown>;
+/**
+ * 顶层 seller 命令入口. 5 个 op 都走这里.
+ * - `json=false` (默认): 走 FlyProvider 现有方法, 返回人类可读 string, 调用方 console.log
+ * - `json=true`: 走结构化 flyctl --json + 包装, 返回 SellerCommandResult 对象
+ */
+export declare class SellerCommandRunner {
+    private configManager;
+    constructor(configManager: ConfigManager);
+    private getProviderConfig;
+    private getProvider;
+    private getFlyctl;
+    ls(json: boolean): SellerListResult | string;
+    status(appName: string, json: boolean): SellerStatusResult | string;
+    create(options: SellerCreateOptions, json: boolean): SellerActionResult<"create"> | string;
+    deploy(args: {
+        app: string;
+        image?: string;
+        dryRun?: boolean;
+    }, json: boolean): SellerActionResult<"deploy"> | string;
+    remove(appName: string, dryRun: boolean, json: boolean): SellerActionResult<"remove"> | string;
+}
+export { parseFlyListJson, parseFlyListText, parseFlyStatusJson };
+//# sourceMappingURL=seller.d.ts.map

package/dist/src/seller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seller.d.ts","sourceRoot":"","sources":["../../src/seller.ts"],"names":[],"mappings":"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"}