@downcity/city 0.2.17 → 0.2.25

package/bin/city/invoker/balance/index.js

@@ -0,0 +1,137 @@
+/**
+ * Balance Service 管理端调用器。
+ *
+ * 路由：/v1/balance/*
+ */
+const PREFIX = "/v1/balance";
+/**
+ * Balance 管理端调用器。
+ *
+ * 通过 `admin.balance` 访问：
+ * ```ts
+ * await admin.balance.listUsers();
+ * const issued = await admin.balance.redeemCodes.create({ amount: 500 });
+ * ```
+ */
+export class BalanceInvoker {
+    /**
+     * redeem_code 子调用器。
+     */
+    redeemCodes;
+    req;
+    constructor(opts) {
+        this.req = opts.requestJSON;
+        this.redeemCodes = new BalanceRedeemCodeInvoker(opts);
+    }
+    /**
+     * 列出余额账户。
+     */
+    async listUsers(limit) {
+        const body = await this.req(withQuery(`${PREFIX}/users`, { limit }), { method: "GET" });
+        return body.items;
+    }
+    /**
+     * 列出余额流水。
+     */
+    async listHistory(input = {}) {
+        const body = await this.req(withQuery(`${PREFIX}/history`, input), { method: "GET" });
+        return body.items;
+    }
+    /**
+     * 列出充值单。
+     */
+    async listTopups(input = {}) {
+        const body = await this.req(withQuery(`${PREFIX}/topups`, input), { method: "GET" });
+        return body.items;
+    }
+    /**
+     * 手动加余额。
+     */
+    add(input) {
+        return this.req(`${PREFIX}/add`, {
+            method: "POST",
+            body: JSON.stringify(input),
+        });
+    }
+    /**
+     * 手动扣余额。
+     */
+    sub(input) {
+        return this.req(`${PREFIX}/sub`, {
+            method: "POST",
+            body: JSON.stringify(input),
+        });
+    }
+    /**
+     * 确认充值单到账。
+     */
+    finishTopup(input) {
+        return this.req(`${PREFIX}/topups/finish`, {
+            method: "POST",
+            body: JSON.stringify(input),
+        });
+    }
+    /**
+     * 取消充值单。
+     */
+    cancelTopup(input) {
+        return this.req(`${PREFIX}/topups/cancel`, {
+            method: "POST",
+            body: JSON.stringify(input),
+        });
+    }
+}
+/**
+ * redeem_code 管理端调用器。
+ */
+export class BalanceRedeemCodeInvoker {
+    req;
+    constructor(opts) {
+        this.req = opts.requestJSON;
+    }
+    /**
+     * 列出 redeem_code。
+     */
+    async list(input = {}) {
+        const body = await this.req(withQuery(`${PREFIX}/redeem-codes`, input), { method: "GET" });
+        return body.items;
+    }
+    /**
+     * 创建 redeem_code。
+     */
+    create(input) {
+        return this.req(`${PREFIX}/redeem-codes/create`, {
+            method: "POST",
+            body: JSON.stringify(input),
+        });
+    }
+    /**
+     * 停用 redeem_code。
+     */
+    disable(input) {
+        return this.req(`${PREFIX}/redeem-codes/disable`, {
+            method: "POST",
+            body: JSON.stringify(input),
+        });
+    }
+}
+/**
+ * 构造带 query 的 URL。
+ *
+ * 关键说明（中文）
+ * - SDK 统一处理 query 拼接，避免调用方手写 URL
+ * - 空值会被自动忽略
+ */
+function withQuery(url, query) {
+    if (!query)
+        return url;
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (value === undefined || value === null || value === "")
+            continue;
+        search.set(key, String(value));
+    }
+    const qs = search.toString();
+    return qs ? `${url}?${qs}` : url;
+}
+//# sourceMappingURL=index.js.map

package/bin/city/invoker/balance/index.js.map

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

package/bin/city/invoker/balance/types.d.ts

@@ -0,0 +1,324 @@
+/**
+ * Balance 管理端类型。
+ *
+ * 关键说明（中文）
+ * - 这里描述的是 Admin City 看到的 balance service 结构
+ * - redeem_code 明文只在创建结果中返回一次
+ */
+/**
+ * 余额账户记录。
+ */
+export interface BalanceAccountRecord {
+    /**
+     * 用户 ID。
+     */
+    user_id: string;
+    /**
+     * 当前余额。
+     */
+    balance: number;
+    /**
+     * 余额单位。
+     */
+    unit: string;
+    /**
+     * 创建时间。
+     */
+    created_at: string;
+    /**
+     * 更新时间。
+     */
+    updated_at: string;
+}
+/**
+ * 余额流水记录。
+ */
+export interface BalanceLedgerRecord {
+    /**
+     * 流水主键。
+     */
+    entry_id: string;
+    /**
+     * 用户 ID。
+     */
+    user_id: string;
+    /**
+     * 流水类型。
+     */
+    kind: "init" | "add" | "sub" | "topup" | "redeem";
+    /**
+     * 本次变动金额。
+     */
+    amount: number;
+    /**
+     * 变动后的余额快照。
+     */
+    balance_after: number;
+    /**
+     * 余额单位。
+     */
+    unit: string;
+    /**
+     * 说明文本。
+     */
+    note: string;
+    /**
+     * 外部引用 ID。
+     */
+    ref: string;
+    /**
+     * 扩展字段 JSON 文本。
+     */
+    metadata_json: string;
+    /**
+     * 创建时间。
+     */
+    created_at: string;
+}
+/**
+ * 充值单记录。
+ */
+export interface BalanceTopupRecord {
+    /**
+     * 充值单 ID。
+     */
+    topup_id: string;
+    /**
+     * 用户 ID。
+     */
+    user_id: string;
+    /**
+     * 充值金额。
+     */
+    amount: number;
+    /**
+     * 余额单位。
+     */
+    unit: string;
+    /**
+     * 充值单状态。
+     */
+    status: "pending" | "paid" | "canceled";
+    /**
+     * 说明文本。
+     */
+    note: string;
+    /**
+     * 外部引用 ID。
+     */
+    ref: string;
+    /**
+     * 扩展字段 JSON 文本。
+     */
+    metadata_json: string;
+    /**
+     * 创建时间。
+     */
+    created_at: string;
+    /**
+     * 更新时间。
+     */
+    updated_at: string;
+}
+/**
+ * redeem_code 记录。
+ */
+export interface BalanceRedeemCodeRecord {
+    /**
+     * redeem_code 主键。
+     */
+    redeem_code_id: string;
+    /**
+     * 充值金额。
+     */
+    amount: number;
+    /**
+     * 余额单位。
+     */
+    unit: string;
+    /**
+     * redeem_code 状态。
+     */
+    status: "active" | "redeemed" | "disabled";
+    /**
+     * 脱敏后的兑换码文本。
+     */
+    code_mask: string;
+    /**
+     * 说明文本。
+     */
+    note: string;
+    /**
+     * 外部引用 ID。
+     */
+    ref: string;
+    /**
+     * 扩展字段 JSON 文本。
+     */
+    metadata_json: string;
+    /**
+     * 被哪个用户兑换。
+     */
+    redeemed_by_user_id: string;
+    /**
+     * 兑换时间。
+     */
+    redeemed_at: string;
+    /**
+     * 创建时间。
+     */
+    created_at: string;
+    /**
+     * 更新时间。
+     */
+    updated_at: string;
+}
+/**
+ * 创建 redeem_code 的输入。
+ */
+export interface BalanceRedeemCodeCreateInput {
+    /**
+     * redeem_code 额度。
+     */
+    amount: number;
+    /**
+     * 可选自定义 redeem_code 明文。
+     *
+     * 不传时由服务端自动生成。
+     */
+    code?: string;
+    /**
+     * 说明文本。
+     */
+    note?: string;
+    /**
+     * 外部引用 ID。
+     */
+    ref?: string;
+    /**
+     * 扩展字段。
+     */
+    meta?: Record<string, unknown>;
+}
+/**
+ * 创建 redeem_code 的结果。
+ */
+export interface BalanceRedeemCodeIssueResult extends BalanceRedeemCodeRecord {
+    /**
+     * redeem_code 明文。
+     *
+     * 只在创建返回中可见。
+     */
+    code: string;
+}
+/**
+ * 查询流水的输入。
+ */
+export interface BalanceHistoryListInput {
+    /**
+     * 可选用户 ID。
+     */
+    user_id?: string;
+    /**
+     * 返回条数上限。
+     */
+    limit?: string | number;
+}
+/**
+ * 查询充值单的输入。
+ */
+export interface BalanceTopupListInput {
+    /**
+     * 可选用户 ID。
+     */
+    user_id?: string;
+    /**
+     * 返回条数上限。
+     */
+    limit?: string | number;
+}
+/**
+ * 查询 redeem_code 的输入。
+ */
+export interface BalanceRedeemCodeListInput {
+    /**
+     * 可选兑换状态。
+     */
+    status?: "active" | "redeemed" | "disabled";
+    /**
+     * 可选兑换用户 ID。
+     */
+    user_id?: string;
+    /**
+     * 返回条数上限。
+     */
+    limit?: string | number;
+}
+/**
+ * 手动加减余额的输入。
+ */
+export interface BalanceMutationInput {
+    /**
+     * 目标用户 ID。
+     */
+    user_id: string;
+    /**
+     * 变动额度。
+     */
+    amount: number;
+    /**
+     * 说明文本。
+     */
+    note?: string;
+    /**
+     * 外部引用 ID。
+     */
+    ref?: string;
+    /**
+     * 扩展字段。
+     */
+    meta?: Record<string, unknown>;
+}
+/**
+ * 完成或取消充值单的输入。
+ */
+export interface BalanceTopupUpdateInput {
+    /**
+     * 充值单 ID。
+     */
+    topup_id: string;
+    /**
+     * 说明文本。
+     */
+    note?: string;
+    /**
+     * 外部引用 ID。
+     */
+    ref?: string;
+    /**
+     * 扩展字段。
+     */
+    meta?: Record<string, unknown>;
+}
+/**
+ * 停用 redeem_code 的输入。
+ */
+export interface BalanceRedeemCodeDisableInput {
+    /**
+     * redeem_code ID。
+     */
+    redeem_code_id: string;
+    /**
+     * 说明文本。
+     */
+    note?: string;
+    /**
+     * 外部引用 ID。
+     */
+    ref?: string;
+    /**
+     * 扩展字段。
+     */
+    meta?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/bin/city/invoker/balance/types.d.ts.map

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

package/bin/city/invoker/balance/types.js

@@ -0,0 +1,9 @@
+/**
+ * Balance 管理端类型。
+ *
+ * 关键说明（中文）
+ * - 这里描述的是 Admin City 看到的 balance service 结构
+ * - redeem_code 明文只在创建结果中返回一次
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/bin/city/invoker/balance/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/city/invoker/balance/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/city/invoker/env/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Env Service 调用器（对应 core service/env/env-service.ts EnvService）。
+ *
+ * 管理端操作：list / upsert / remove / import。
+ */
+import type { RequestInitLike } from "../../http.js";
+import type { EnvCatalogScope, EnvEntry, EnvUpsertInput } from "./types.js";
+/**
+ * 环境变量管理调用器。
+ *
+ * 通过 Admin City .env 访问：
+ * ```ts
+ * await admin.env.list();
+ * await admin.env.upsert({ key: "KEY", value: "val" });
+ * ```
+ */
+export declare class EnvInvoker {
+    private readonly req;
+    constructor(opts: {
+        requestJSON: <T>(path: string, init: RequestInitLike) => Promise<T>;
+    });
+    /** 列出环境变量 */
+    list(): Promise<EnvEntry[]>;
+    /** 读取 City 聚合后的 env requirement 目录 */
+    catalog(): Promise<EnvCatalogScope[]>;
+    /** 写入/更新 */
+    upsert(input: EnvUpsertInput): Promise<unknown>;
+    /** 删除 */
+    remove(key: string): Promise<unknown>;
+    /** 批量导入 .env 文本 */
+    import(raw: string): Promise<unknown>;
+}
+//# sourceMappingURL=index.d.ts.map

package/bin/city/invoker/env/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/city/invoker/env/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAI5E;;;;;;;;GAQG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAyD;gBAEjE,IAAI,EAAE;QAChB,WAAW,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;KACrE;IAID,aAAa;IACP,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAKjC,sCAAsC;IAChC,OAAO,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAK3C,YAAY;IACZ,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAO/C,SAAS;IACT,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOrC,mBAAmB;IACnB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAMtC"}

package/bin/city/invoker/env/index.js

@@ -0,0 +1,53 @@
+/**
+ * Env Service 调用器（对应 core service/env/env-service.ts EnvService）。
+ *
+ * 管理端操作：list / upsert / remove / import。
+ */
+const PREFIX = "/v1/env";
+/**
+ * 环境变量管理调用器。
+ *
+ * 通过 Admin City .env 访问：
+ * ```ts
+ * await admin.env.list();
+ * await admin.env.upsert({ key: "KEY", value: "val" });
+ * ```
+ */
+export class EnvInvoker {
+    req;
+    constructor(opts) {
+        this.req = opts.requestJSON;
+    }
+    /** 列出环境变量 */
+    async list() {
+        const body = await this.req(`${PREFIX}/list`, { method: "GET" });
+        return body.items;
+    }
+    /** 读取 City 聚合后的 env requirement 目录 */
+    async catalog() {
+        const body = await this.req(`${PREFIX}/catalog`, { method: "GET" });
+        return body.items;
+    }
+    /** 写入/更新 */
+    upsert(input) {
+        return this.req(`${PREFIX}/upsert`, {
+            method: "POST",
+            body: JSON.stringify(input),
+        });
+    }
+    /** 删除 */
+    remove(key) {
+        return this.req(`${PREFIX}/remove`, {
+            method: "POST",
+            body: JSON.stringify({ key }),
+        });
+    }
+    /** 批量导入 .env 文本 */
+    import(raw) {
+        return this.req(`${PREFIX}/import`, {
+            method: "POST",
+            body: JSON.stringify({ raw }),
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/bin/city/invoker/env/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/city/invoker/env/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,MAAM,GAAG,SAAS,CAAC;AAEzB;;;;;;;;GAQG;AACH,MAAM,OAAO,UAAU;IACJ,GAAG,CAAyD;IAE7E,YAAY,IAEX;QACC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC;IAC9B,CAAC;IAED,aAAa;IACb,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAwB,GAAG,MAAM,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACxF,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAA+B,GAAG,MAAM,UAAU,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAClG,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,YAAY;IACZ,MAAM,CAAC,KAAqB;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,SAAS,EAAE;YAClC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,SAAS;IACT,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,SAAS,EAAE;YAClC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,mBAAmB;IACnB,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,SAAS,EAAE;YAClC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC;SAC9B,CAAC,CAAC;IACL,CAAC;CACF"}

package/bin/city/invoker/env/types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Env 类型（对应 core service/env/types.ts）。
+ */
+/** 环境变量记录 */
+export interface EnvEntry {
+    key: string;
+    value: string;
+    source: "database";
+}
+/** 写入/更新 env 的输入 */
+export interface EnvUpsertInput {
+    key: string;
+    value: string;
+}
+/**
+ * 单个 env requirement 的当前状态。
+ */
+export interface EnvRequirementStatus {
+    /**
+     * 环境变量 key。
+     */
+    key: string;
+    /**
+     * 给管理员展示的说明文本。
+     */
+    description: string;
+    /**
+     * 当前是否必填。
+     */
+    required: boolean;
+    /**
+     * 当前 City 是否已经配置了该 key。
+     */
+    configured: boolean;
+    /**
+     * 当前值的安全预览文本。
+     */
+    value_preview?: string;
+}
+/**
+ * City 聚合后的 env 配置分组。
+ */
+export interface EnvCatalogScope {
+    /**
+     * 分组唯一标识。
+     */
+    id: string;
+    /**
+     * 分组展示名称。
+     */
+    name: string;
+    /**
+     * 当前分组下的 env requirement 列表。
+     */
+    env: EnvRequirementStatus[];
+}
+//# sourceMappingURL=types.d.ts.map

package/bin/city/invoker/env/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/city/invoker/env/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,aAAa;AACb,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,oBAAoB;AACpB,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,GAAG,EAAE,oBAAoB,EAAE,CAAC;CAC7B"}

package/bin/city/invoker/env/types.js

@@ -0,0 +1,5 @@
+/**
+ * Env 类型（对应 core service/env/types.ts）。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/bin/city/invoker/env/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/city/invoker/env/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}