@downcity/city 0.2.17 → 0.2.25

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

@@ -0,0 +1,44 @@
+/**
+ * Service / Action 调用器。
+ *
+ * client.service("ai").action("text").invoke({ prompt: "hello" })
+ *   → POST /v1/ai/text
+ *
+ * 如果设置了 town_id，自动注入到 POST body。
+ * GET Action 则支持通过第二个参数传 query。
+ */
+import type { RequestInitLike } from "../http.js";
+type Requester = <T>(path: string, init: RequestInitLike) => Promise<T>;
+/**
+ * Action 调用器。
+ */
+export declare class ActionClient {
+    private readonly req;
+    private readonly url;
+    /** 当前 Town ID，自动注入到 POST body */
+    private readonly town_id?;
+    constructor(req: Requester, url: string, 
+    /** 当前 Town ID，自动注入到 POST body */
+    town_id?: string | undefined);
+    /** POST 执行 Action */
+    invoke<T = unknown>(input?: Record<string, unknown>): Promise<T>;
+}
+/**
+ * Service 调用器。
+ */
+export declare class ServiceClient {
+    private readonly req;
+    private readonly prefix;
+    private readonly serviceId;
+    /** 当前 Town ID，透传给 ActionClient */
+    private readonly town_id?;
+    constructor(req: Requester, prefix: string, serviceId: string, 
+    /** 当前 Town ID，透传给 ActionClient */
+    town_id?: string | undefined);
+    /** 获取 Action 调用器 */
+    action(name: string): ActionClient;
+    /** GET 调用 Action（用于 method="GET" 的 action） */
+    get<T = unknown>(name: string, query?: Record<string, unknown>): Promise<T>;
+}
+export {};
+//# sourceMappingURL=invoker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"invoker.d.ts","sourceRoot":"","sources":["../../../src/city/invoker/invoker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,KAAK,SAAS,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAExE;;GAEG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,iCAAiC;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAHR,GAAG,EAAE,SAAS,EACd,GAAG,EAAE,MAAM;IAC5B,iCAAiC;IAChB,OAAO,CAAC,EAAE,MAAM,YAAA;IAGnC,qBAAqB;IACrB,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAOrE;AAED;;GAEG;AACH,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAJR,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM;IAClC,kCAAkC;IACjB,OAAO,CAAC,EAAE,MAAM,YAAA;IAGnC,oBAAoB;IACpB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAMlC,8CAA8C;IAC9C,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAK5E"}

package/bin/city/invoker/invoker.js

@@ -0,0 +1,87 @@
+/**
+ * Service / Action 调用器。
+ *
+ * client.service("ai").action("text").invoke({ prompt: "hello" })
+ *   → POST /v1/ai/text
+ *
+ * 如果设置了 town_id，自动注入到 POST body。
+ * GET Action 则支持通过第二个参数传 query。
+ */
+/**
+ * Action 调用器。
+ */
+export class ActionClient {
+    req;
+    url;
+    town_id;
+    constructor(req, url, 
+    /** 当前 Town ID，自动注入到 POST body */
+    town_id) {
+        this.req = req;
+        this.url = url;
+        this.town_id = town_id;
+    }
+    /** POST 执行 Action */
+    invoke(input = {}) {
+        const body = this.town_id ? { ...input, town_id: this.town_id } : input;
+        return this.req(this.url, {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+    }
+}
+/**
+ * Service 调用器。
+ */
+export class ServiceClient {
+    req;
+    prefix;
+    serviceId;
+    town_id;
+    constructor(req, prefix, serviceId, 
+    /** 当前 Town ID，透传给 ActionClient */
+    town_id) {
+        this.req = req;
+        this.prefix = prefix;
+        this.serviceId = serviceId;
+        this.town_id = town_id;
+    }
+    /** 获取 Action 调用器 */
+    action(name) {
+        const id = normalizeName(name);
+        const url = `${this.prefix}/${encodeURIComponent(this.serviceId)}/${id}`;
+        return new ActionClient(this.req, url, this.town_id);
+    }
+    /** GET 调用 Action（用于 method="GET" 的 action） */
+    get(name, query) {
+        const id = normalizeName(name);
+        const url = withQuery(`${this.prefix}/${encodeURIComponent(this.serviceId)}/${id}`, query);
+        return this.req(url, { method: "GET" });
+    }
+}
+function normalizeName(value) {
+    const s = String(value ?? "").trim().replace(/^\/+/, "");
+    if (!s)
+        throw new TypeError("name is required");
+    return s;
+}
+/**
+ * 为 GET action 构造 query string。
+ *
+ * 关键说明（中文）
+ * - 统一由 SDK 负责 query 拼接，业务侧不再手写 `foo?bar=baz`
+ * - `undefined` / `null` 会被忽略，避免产生无意义参数
+ */
+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)
+            continue;
+        search.set(key, String(value));
+    }
+    const qs = search.toString();
+    return qs ? `${url}?${qs}` : url;
+}
+//# sourceMappingURL=invoker.js.map

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

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

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

@@ -0,0 +1,69 @@
+/**
+ * Payment 用户端调用器。
+ *
+ * 关键说明（中文）
+ * - `client.payment.methods()` 统一读取支付方式目录
+ * - `client.payment.method("stripe").invoke(...)` 会自动解析目标 service / action
+ * - 前端不再手写 `payment.stripe` 或 `checkout/create`
+ */
+import type { RequestInitLike } from "../../http.js";
+import { ServiceClient } from "../invoker.js";
+import type { UserPaymentMethod } from "./types.js";
+type Requester = <T>(path: string, init: RequestInitLike) => Promise<T>;
+type ServiceFactory = (name: string) => ServiceClient;
+/**
+ * Payment 调用器。
+ */
+export declare class PaymentInvoker {
+    private readonly req;
+    private readonly service;
+    private readonly hasUserToken;
+    constructor(opts: {
+        requestJSON: Requester;
+        service: ServiceFactory;
+        hasUserToken: () => boolean;
+    });
+    /**
+     * 读取当前 City 暴露的支付方式列表。
+     */
+    methods(): Promise<UserPaymentMethod[]>;
+    /**
+     * 获取单个支付方式句柄。
+     */
+    method(id: string): PaymentMethodHandle;
+    /**
+     * 读取单个支付方式定义。
+     */
+    readMethod(id: string): Promise<UserPaymentMethod>;
+    /**
+     * 按支付方式定义自动分发到具体 service / action。
+     */
+    invokeMethod<T = unknown>(id: string, input?: Record<string, unknown>): Promise<T>;
+    /**
+     * 使用已解析的支付方式定义执行具体动作。
+     */
+    executeMethod<T = unknown>(method: UserPaymentMethod, input?: Record<string, unknown>): Promise<T>;
+    private dispatchMethod;
+}
+/**
+ * 单个支付方式句柄。
+ */
+export declare class PaymentMethodHandle {
+    private readonly payment;
+    /**
+     * 支付方式唯一标识。
+     */
+    readonly id: string;
+    private definitionPromise?;
+    constructor(payment: PaymentInvoker, id: string);
+    /**
+     * 读取当前支付方式定义。
+     */
+    describe(): Promise<UserPaymentMethod>;
+    /**
+     * 发起当前支付方式对应的具体动作。
+     */
+    invoke<T = unknown>(input?: Record<string, unknown>): Promise<T>;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/city/invoker/payment/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIpD,KAAK,SAAS,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AACxE,KAAK,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,CAAC;AAEtD;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;gBAEjC,IAAI,EAAE;QAChB,WAAW,EAAE,SAAS,CAAC;QACvB,OAAO,EAAE,cAAc,CAAC;QACxB,YAAY,EAAE,MAAM,OAAO,CAAC;KAC7B;IAMD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAO7C;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB;IAIvC;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAUxD;;OAEG;IACG,YAAY,CAAC,CAAC,GAAG,OAAO,EAC5B,EAAE,EAAE,MAAM,EACV,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAClC,OAAO,CAAC,CAAC,CAAC;IAKb;;OAEG;IACH,aAAa,CAAC,CAAC,GAAG,OAAO,EACvB,MAAM,EAAE,iBAAiB,EACzB,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAClC,OAAO,CAAC,CAAC,CAAC;IAIb,OAAO,CAAC,cAAc;CAevB;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAS5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAR1B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,OAAO,CAAC,iBAAiB,CAAC,CAA6B;gBAGpC,OAAO,EAAE,cAAc,EACxC,EAAE,EAAE,MAAM;IAKZ;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAOtC;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAI3E"}

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

@@ -0,0 +1,110 @@
+/**
+ * Payment 用户端调用器。
+ *
+ * 关键说明（中文）
+ * - `client.payment.methods()` 统一读取支付方式目录
+ * - `client.payment.method("stripe").invoke(...)` 会自动解析目标 service / action
+ * - 前端不再手写 `payment.stripe` 或 `checkout/create`
+ */
+const PREFIX = "/v1/payment";
+/**
+ * Payment 调用器。
+ */
+export class PaymentInvoker {
+    req;
+    service;
+    hasUserToken;
+    constructor(opts) {
+        this.req = opts.requestJSON;
+        this.service = opts.service;
+        this.hasUserToken = opts.hasUserToken;
+    }
+    /**
+     * 读取当前 City 暴露的支付方式列表。
+     */
+    async methods() {
+        const body = await this.req(`${PREFIX}/methods`, {
+            method: "GET",
+        });
+        return body.items;
+    }
+    /**
+     * 获取单个支付方式句柄。
+     */
+    method(id) {
+        return new PaymentMethodHandle(this, normalizeMethodId(id));
+    }
+    /**
+     * 读取单个支付方式定义。
+     */
+    async readMethod(id) {
+        const methodId = normalizeMethodId(id);
+        const methods = await this.methods();
+        const method = methods.find((item) => item.id === methodId);
+        if (!method) {
+            throw new Error(`payment method "${methodId}" is not available`);
+        }
+        return method;
+    }
+    /**
+     * 按支付方式定义自动分发到具体 service / action。
+     */
+    async invokeMethod(id, input = {}) {
+        const method = await this.readMethod(id);
+        return this.executeMethod(method, input);
+    }
+    /**
+     * 使用已解析的支付方式定义执行具体动作。
+     */
+    executeMethod(method, input = {}) {
+        return this.dispatchMethod(method, input);
+    }
+    dispatchMethod(method, input = {}) {
+        if (!method.enabled) {
+            const reason = method.reason ? `: ${method.reason}` : "";
+            throw new Error(`payment method "${method.id}" is disabled${reason}`);
+        }
+        if (method.requires_user && !this.hasUserToken()) {
+            throw new TypeError(`user_token is required for payment method "${method.id}"`);
+        }
+        return this.service(method.service).action(method.action).invoke(input);
+    }
+}
+/**
+ * 单个支付方式句柄。
+ */
+export class PaymentMethodHandle {
+    payment;
+    /**
+     * 支付方式唯一标识。
+     */
+    id;
+    definitionPromise;
+    constructor(payment, id) {
+        this.payment = payment;
+        this.id = id;
+    }
+    /**
+     * 读取当前支付方式定义。
+     */
+    describe() {
+        if (!this.definitionPromise) {
+            this.definitionPromise = this.payment.readMethod(this.id);
+        }
+        return this.definitionPromise;
+    }
+    /**
+     * 发起当前支付方式对应的具体动作。
+     */
+    async invoke(input = {}) {
+        const method = await this.describe();
+        return this.payment.executeMethod(method, input);
+    }
+}
+function normalizeMethodId(value) {
+    const id = String(value ?? "").trim();
+    if (!id)
+        throw new TypeError("payment method id is required");
+    return id;
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,66 @@
+/**
+ * Payment 调用器对外类型。
+ *
+ * 关键说明（中文）
+ * - `payment` 是统一支付入口，负责告诉前端“当前有哪些支付方式”
+ * - 具体执行动作仍然落到具体 service / action，例如 `payment.stripe`
+ * - client 侧通过 typed invoker 屏蔽 service / action 的拼接细节
+ */
+/**
+ * 支付方式模式。
+ */
+export type UserPaymentMethodType = "checkout";
+/**
+ * 支付方式不可用原因。
+ */
+export type UserPaymentMethodReason = "not_configured" | "not_supported";
+/**
+ * 单个支付方式定义。
+ */
+export interface UserPaymentMethod {
+    /**
+     * 支付方式唯一标识。
+     *
+     * 例如：`stripe`
+     */
+    id: string;
+    /**
+     * 当前支付方式模式。
+     *
+     * 当前版本统一为 `checkout`，表示需要先创建支付会话，再跳转到第三方支付页。
+     */
+    type: UserPaymentMethodType;
+    /**
+     * 当前 City 是否已真正开放该支付方式。
+     */
+    enabled: boolean;
+    /**
+     * 展示给终端用户的支付方式名称。
+     */
+    label: string;
+    /**
+     * 发起支付时应调用的 service id。
+     *
+     * 例如：`payment.stripe`
+     */
+    service: string;
+    /**
+     * 发起支付时应调用的 action id。
+     *
+     * 例如：`checkout/create`
+     */
+    action: string;
+    /**
+     * 当前支付方式是否要求用户先处于登录态。
+     */
+    requires_user: boolean;
+    /**
+     * 当前支付方式默认结算币种。
+     */
+    currency: string;
+    /**
+     * 当前支付方式未启用时的原因。
+     */
+    reason?: UserPaymentMethodReason;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/city/invoker/payment/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;;OAIG;IACH,IAAI,EAAE,qBAAqB,CAAC;IAE5B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,uBAAuB,CAAC;CAClC"}

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

@@ -0,0 +1,10 @@
+/**
+ * Payment 调用器对外类型。
+ *
+ * 关键说明（中文）
+ * - `payment` 是统一支付入口，负责告诉前端“当前有哪些支付方式”
+ * - 具体执行动作仍然落到具体 service / action，例如 `payment.stripe`
+ * - client 侧通过 typed invoker 屏蔽 service / action 的拼接细节
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

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

@@ -0,0 +1,46 @@
+/**
+ * Towns Service 调用器（对应 core service/towns/towns-service.ts TownsService）。
+ *
+ * 管理端操作：Town CRUD + Token 签发。
+ */
+import type { RequestInitLike } from "../../http.js";
+import type { Town, TownCreateInput, TokenApplyInput, TokenApplyResult } from "./types.js";
+/**
+ * Town 和 Token 管理调用器。
+ *
+ * 通过 Admin City .towns 访问：
+ * ```ts
+ * await admin.towns.list();
+ * await admin.towns.create({ name: "My App" });
+ * await admin.towns.tokens.apply({ town_id, user_id });
+ * ```
+ */
+export declare class TownsInvoker {
+    /** Token 签发 */
+    readonly tokens: TokenInvoker;
+    private readonly req;
+    constructor(opts: {
+        requestJSON: <T>(path: string, init: RequestInitLike) => Promise<T>;
+    });
+    /** 列出 Town */
+    list(): Promise<Town[]>;
+    /** 创建 */
+    create(input: TownCreateInput): Promise<Town>;
+    /** 暂停 */
+    pause(town_id: string): Promise<Town>;
+    /** 激活 */
+    activate(town_id: string): Promise<Town>;
+    /** 删除 */
+    remove(town_id: string): Promise<unknown>;
+}
+/** Token 签发调用器 */
+declare class TokenInvoker {
+    private readonly req;
+    constructor(opts: {
+        requestJSON: <T>(path: string, init: RequestInitLike) => Promise<T>;
+    });
+    /** 签发 user_token */
+    apply(input: TokenApplyInput): Promise<TokenApplyResult>;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/city/invoker/towns/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAI3F;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,eAAe;IACf,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B,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;IAKD,cAAc;IACR,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAK7B,SAAS;IACT,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7C,SAAS;IACT,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrC,SAAS;IACT,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxC,SAAS;IACT,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAM1C;AAED,kBAAkB;AAClB,cAAM,YAAY;IAChB,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,oBAAoB;IACpB,KAAK,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAMzD"}

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

@@ -0,0 +1,73 @@
+/**
+ * Towns Service 调用器（对应 core service/towns/towns-service.ts TownsService）。
+ *
+ * 管理端操作：Town CRUD + Token 签发。
+ */
+const PREFIX = "/v1/towns";
+/**
+ * Town 和 Token 管理调用器。
+ *
+ * 通过 Admin City .towns 访问：
+ * ```ts
+ * await admin.towns.list();
+ * await admin.towns.create({ name: "My App" });
+ * await admin.towns.tokens.apply({ town_id, user_id });
+ * ```
+ */
+export class TownsInvoker {
+    /** Token 签发 */
+    tokens;
+    req;
+    constructor(opts) {
+        this.req = opts.requestJSON;
+        this.tokens = new TokenInvoker(opts);
+    }
+    /** 列出 Town */
+    async list() {
+        const body = await this.req(`${PREFIX}/list`, { method: "GET" });
+        return body.items;
+    }
+    /** 创建 */
+    create(input) {
+        return this.req(`${PREFIX}/create`, {
+            method: "POST",
+            body: JSON.stringify(input),
+        });
+    }
+    /** 暂停 */
+    pause(town_id) {
+        return this.req(`${PREFIX}/pause`, {
+            method: "POST",
+            body: JSON.stringify({ town_id }),
+        });
+    }
+    /** 激活 */
+    activate(town_id) {
+        return this.req(`${PREFIX}/activate`, {
+            method: "POST",
+            body: JSON.stringify({ town_id }),
+        });
+    }
+    /** 删除 */
+    remove(town_id) {
+        return this.req(`${PREFIX}/remove`, {
+            method: "POST",
+            body: JSON.stringify({ town_id }),
+        });
+    }
+}
+/** Token 签发调用器 */
+class TokenInvoker {
+    req;
+    constructor(opts) {
+        this.req = opts.requestJSON;
+    }
+    /** 签发 user_token */
+    apply(input) {
+        return this.req(`${PREFIX}/tokens/apply`, {
+            method: "POST",
+            body: JSON.stringify(input),
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/city/invoker/towns/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,MAAM,GAAG,WAAW,CAAC;AAE3B;;;;;;;;;GASG;AACH,MAAM,OAAO,YAAY;IACvB,eAAe;IACN,MAAM,CAAe;IAEb,GAAG,CAAyD;IAE7E,YAAY,IAEX;QACC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,cAAc;IACd,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAoB,GAAG,MAAM,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACpF,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,SAAS;IACT,MAAM,CAAC,KAAsB;QAC3B,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,KAAK,CAAC,OAAe;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,QAAQ,EAAE;YACjC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;SAClC,CAAC,CAAC;IACL,CAAC;IAED,SAAS;IACT,QAAQ,CAAC,OAAe;QACtB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,WAAW,EAAE;YACpC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;SAClC,CAAC,CAAC;IACL,CAAC;IAED,SAAS;IACT,MAAM,CAAC,OAAe;QACpB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,SAAS,EAAE;YAClC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;SAClC,CAAC,CAAC;IACL,CAAC;CACF;AAED,kBAAkB;AAClB,MAAM,YAAY;IACC,GAAG,CAAyD;IAE7E,YAAY,IAEX;QACC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC;IAC9B,CAAC;IAED,oBAAoB;IACpB,KAAK,CAAC,KAAsB;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,eAAe,EAAE;YACxC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;SAC5B,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,46 @@
+/**
+ * Town / Token 类型（对应 core service/towns/types.ts + core/auth/types.ts）。
+ */
+/** Town 记录 */
+export interface Town {
+    /** Town 的唯一 ID，User City 请求会使用它绑定访问边界。 */
+    town_id: string;
+    /** Town 的展示名称，便于管理端识别不同产品或场景。 */
+    name: string;
+    /** Town 当前状态，paused 状态会阻止用户侧继续调用。 */
+    status: "active" | "paused";
+    /** Town 创建时间，使用 ISO 字符串。 */
+    created_at: string;
+    /** Town 最后更新时间，使用 ISO 字符串。 */
+    updated_at: string;
+}
+/** 创建 Town 的输入 */
+export interface TownCreateInput {
+    /** Town 的展示名称。 */
+    name: string;
+    /** 可选自定义 Town ID；不传时由 City 自动生成。 */
+    town_id?: string;
+}
+/** 签发 token 的输入 */
+export interface TokenApplyInput {
+    /** token 绑定的 Town ID。 */
+    town_id: string;
+    /** token 绑定的业务用户 ID。 */
+    user_id: string;
+    /** 写入 token payload 的业务元数据。 */
+    metadata?: Record<string, unknown>;
+    /** token 有效期，可传毫秒数或可解析的时长字符串。 */
+    ttl?: string | number;
+}
+/** token 签发结果 */
+export interface TokenApplyResult {
+    /** 可交给 User City 使用的 token */
+    user_token: string;
+    /** token 所属 Town ID */
+    town_id: string;
+    /** token 所属用户 ID */
+    user_id: string;
+    /** token 过期时间；未设置 ttl 时省略 */
+    expires_at?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/city/invoker/towns/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc;AACd,MAAM,WAAW,IAAI;IACnB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAEhB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IAEb,qCAAqC;IACrC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAE5B,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IAEnB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,kBAAkB;AAClB,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IAEb,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,mBAAmB;AACnB,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAEhB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,iBAAiB;AACjB,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

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

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

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

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