@downcity/city 0.2.82 → 0.2.93

package/README.md

@@ -5,7 +5,7 @@
 它负责这些共用能力：
 
 - 挂载 `Service` / `AIService`
-- 初始化内置 `towns` / `env` 表
+- 初始化内置 `cities` / `env` 表
 - 校验 `user_token` 和 `admin_secret_key`
 - 暴露统一的 `/v1/*` HTTP 路由
 - 提供 env、数据库、hook 和鉴权上下文
@@ -19,7 +19,7 @@ pnpm add @downcity/city
 ## 最小示例
 
 ```ts
-import { CityBase, AIService } from "@downcity/city";
+import { Federation, AIService } from "@downcity/city";
 import Database from "better-sqlite3";
 import { drizzle } from "drizzle-orm/better-sqlite3";
 
@@ -30,7 +30,7 @@ const db = Object.assign(drizzle(sqlite), {
   $client: { exec: (sql: string) => sqlite.exec(sql) },
 });
 
-const base = new CityBase({ db, dialect: "sqlite", raw: sqlite });
+const base = new Federation({ db, dialect: "sqlite", raw: sqlite });
 
 const ai = new AIService();
 ai.use({
@@ -66,9 +66,9 @@ serve({ fetch: base.router().fetch, port: 43127, hostname: "127.0.0.1" });
 
 ## City 说明文档
 
-`base.instruction()` 会返回当前 CityBase 实例的聚合说明文档字符串，内容包含：
+`base.instruction()` 会返回当前 Federation 实例的聚合说明文档字符串，内容包含：
 
-- CityBase 的基本使用方式
+- Federation 的基本使用方式
 - 当前已挂载的 service
 - 每个模块需要的 env 配置
 - 每个模块补充的使用说明
@@ -81,7 +81,7 @@ console.log(text);
 如果你需要从远程管理端读取同一份说明，可以请求：
 
 ```txt
-GET /v1/city/instruction
+GET /v1/federation/instruction
 ```
 
 这个接口只允许 `admin_secret_key` 访问，返回 `text/plain`。
@@ -142,7 +142,7 @@ base.use(ai);
 
 ## 官方服务
 
-官方服务用于封装多 town 复用能力：
+官方服务用于封装多 city 复用能力：
 
 ```ts
 import { accountsService } from "@downcity/services";
@@ -163,12 +163,12 @@ base.use(usageService());
 - `auth: ["admin"]` 只允许 `admin_secret_key`
 - `auth: []` 表示免登录
 
-对于用户侧请求，`user_token` 绑定 town 身份。如果请求体或 query 中传了 `town_id`，它必须与 token 里的 town 一致。
+对于用户侧请求，`user_token` 绑定 city 身份。如果请求体或 query 中传了 `city_id`，它必须与 token 里的 city 一致。
 
 ## 主要导出
 
 - `City`
-- `CityBase`
+- `Federation`
 - `Service`
 - `ServiceDefinition`
 - `AIService`
@@ -177,7 +177,7 @@ base.use(usageService());
 - `CityModelDescriptor`
 - `TokenSigner`
 - `EnvService`
-- `TownsService`
+- `CitiesService`
 
 ## City 模型目录
 

package/bin/client/city.d.ts

@@ -0,0 +1,90 @@
+/**
+ * City 客户端统一访问入口。
+ *
+ * City 面向开发者表达“我以某种角色进入 Federation”，内部再委托给
+ * admin / user 协议访问层（`pact/`），让用户在第一层概念上无需关心 client 拆分。
+ */
+import { AdminPactAccess } from "../pact/admin/index.js";
+import { UserPactAccess } from "../pact/user/index.js";
+import type { ServiceClient } from "../pact/invoker/invoker.js";
+import type { CityOptionsForRole, CityRole } from "./types.js";
+import type { AdminModelRecord, AdminServiceSummary } from "../pact/admin/types.js";
+import type { UserServiceSummary } from "../pact/user/types.js";
+/**
+ * Downcity City 客户端。
+ */
+export declare class City<TRole extends CityRole = CityRole> {
+    /**
+     * 当前 City 客户端的访问角色。
+     */
+    readonly role: TRole;
+    /**
+     * Admin 能力面。
+     *
+     * 仅 `role: "admin"` 时可用。
+     */
+    private readonly admin_access?;
+    /**
+     * User 能力面。
+     *
+     * 仅 `role: "user"` 时可用。
+     */
+    private readonly user_access?;
+    constructor(options: CityOptionsForRole<TRole>);
+    /**
+     * User 角色的 AI 调用入口。
+     */
+    get ai(): UserPactAccess["ai"];
+    /**
+     * User 角色的支付入口。
+     */
+    get payment(): UserPactAccess["payment"];
+    /**
+     * Admin 角色的余额服务入口。
+     */
+    get balance(): AdminPactAccess["balance"];
+    /**
+     * Admin 角色的 City 管理入口。
+     */
+    get cities(): AdminPactAccess["cities"];
+    /**
+     * Admin 角色的环境变量服务入口。
+     */
+    get env(): AdminPactAccess["env"];
+    /**
+     * Token 管理入口。
+     *
+     * 不需要传 city_id，构造时传入的 city_id 会自动注入。
+     */
+    get tokens(): {
+        apply: (input: {
+            user_id: string;
+            metadata?: Record<string, unknown>;
+            ttl?: string | number;
+        }) => Promise<{
+            user_token: string;
+            city_id: string;
+            user_id: string;
+            expires_at?: string;
+        }>;
+    };
+    /**
+     * 获取普通 service 调用器。
+     */
+    service(name: string): ServiceClient;
+    /**
+     * 列出当前 Federation 暴露的 service。
+     */
+    listServices(): Promise<AdminServiceSummary[] | UserServiceSummary[]>;
+    /**
+     * 列出 Federation 模型目录。
+     */
+    listModels(): Promise<AdminModelRecord[]>;
+    /**
+     * 读取 Federation 聚合说明文档。
+     */
+    instruction(): Promise<string>;
+    private require_admin;
+    private require_user;
+}
+//# sourceMappingURL=city.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"city.d.ts","sourceRoot":"","sources":["../../src/client/city.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;GAEG;AACH,qBAAa,IAAI,CAAC,KAAK,SAAS,QAAQ,GAAG,QAAQ;IACjD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAErB;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAkB;IAEhD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAiB;gBAElC,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC;IAyB9C;;OAEG;IACH,IAAI,EAAE,IAAI,cAAc,CAAC,IAAI,CAAC,CAE7B;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,cAAc,CAAC,SAAS,CAAC,CAEvC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,eAAe,CAAC,SAAS,CAAC,CAExC;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,eAAe,CAAC,QAAQ,CAAC,CAEtC;IAED;;OAEG;IACH,IAAI,GAAG,IAAI,eAAe,CAAC,KAAK,CAAC,CAEhC;IAED;;;;OAIG;IACH,IAAI,MAAM,IAAI;QAAE,KAAK,EAAE,CAAC,KAAK,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAGzM;IAED;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAIpC;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC,mBAAmB,EAAE,GAAG,kBAAkB,EAAE,CAAC;IAIrE;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAIzC;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAI9B,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,YAAY;CAMrB"}

package/bin/{city → client}/city.js

@@ -1,17 +1,17 @@
 /**
- * City 统一访问入口。
+ * City 客户端统一访问入口。
  *
- * City 面向开发者表达“我以某种角色进入 City”，内部再委托给
- * admin / user 访问层，避免用户在第一层概念上关心 client 拆分。
+ * City 面向开发者表达“我以某种角色进入 Federation”，内部再委托给
+ * admin / user 协议访问层（`pact/`），让用户在第一层概念上无需关心 client 拆分。
  */
-import { AdminCityAccess } from "./admin/index.js";
-import { UserCityAccess } from "./user/index.js";
+import { AdminPactAccess } from "../pact/admin/index.js";
+import { UserPactAccess } from "../pact/user/index.js";
 /**
- * Downcity City。
+ * Downcity City 客户端。
  */
 export class City {
     /**
-     * 当前 City 访问角色。
+     * 当前 City 客户端的访问角色。
      */
     role;
     /**
@@ -32,49 +32,59 @@ export class City {
         }
         this.role = options.role;
         if (options.role === "admin") {
-            this.admin_access = new AdminCityAccess({
-                base_url: options.city_url,
+            this.admin_access = new AdminPactAccess({
+                base_url: options.federation_url,
+                city_id: options.city_id,
                 admin_secret_key: options.admin_secret_key,
                 fetch: options.fetch,
             });
             return;
         }
-        this.user_access = new UserCityAccess({
-            base_url: options.city_url,
-            town_id: options.town_id,
+        this.user_access = new UserPactAccess({
+            base_url: options.federation_url,
+            city_id: options.city_id,
             user_token: options.user_token,
             fetch: options.fetch,
         });
     }
     /**
-     * User City 的 AI 调用入口。
+     * User 角色的 AI 调用入口。
      */
     get ai() {
         return this.require_user().ai;
     }
     /**
-     * User City 的支付入口。
+     * User 角色的支付入口。
      */
     get payment() {
         return this.require_user().payment;
     }
     /**
-     * Admin City 的余额服务入口。
+     * Admin 角色的余额服务入口。
      */
     get balance() {
         return this.require_admin().balance;
     }
     /**
-     * Admin City 的环境变量服务入口。
+     * Admin 角色的 City 管理入口。
+     */
+    get cities() {
+        return this.require_admin().cities;
+    }
+    /**
+     * Admin 角色的环境变量服务入口。
      */
     get env() {
         return this.require_admin().env;
     }
     /**
-     * Admin City 的 Town 管理入口。
+     * Token 管理入口。
+     *
+     * 不需要传 city_id，构造时传入的 city_id 会自动注入。
      */
-    get towns() {
-        return this.require_admin().towns;
+    get tokens() {
+        const admin = this.require_admin();
+        return { apply: (input) => admin.applyToken(input) };
     }
     /**
      * 获取普通 service 调用器。
@@ -83,19 +93,19 @@ export class City {
         return this.admin_access?.service(name) ?? this.require_user().service(name);
     }
     /**
-     * 列出当前 City 暴露的 service。
+     * 列出当前 Federation 暴露的 service。
      */
     listServices() {
         return this.admin_access?.listServices() ?? this.require_user().listServices();
     }
     /**
-     * 列出 City 模型目录。
+     * 列出 Federation 模型目录。
      */
     listModels() {
         return this.require_admin().listModels();
     }
     /**
-     * 读取 City 聚合说明文档。
+     * 读取 Federation 聚合说明文档。
      */
     instruction() {
         return this.require_admin().instruction();

package/bin/client/city.js.map

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

package/bin/client/types.d.ts

@@ -0,0 +1,77 @@
+/**
+ * City 客户端构造类型模块。
+ *
+ * City 是访问 Federation 的统一客户端入口：开发者只需要声明访问角色，
+ * SDK 会在内部选择 admin 或 user 能力面。底层 HTTP 协议实现位于 `pact/`。
+ */
+import type { FetchLike } from "../pact/http.js";
+/**
+ * City 访问角色。
+ */
+export type CityRole = "admin" | "user";
+/**
+ * City 客户端共享构造参数。
+ */
+export interface CityBaseOptions {
+    /**
+     * Federation 的 HTTP 入口地址。
+     *
+     * 示例：`https://city.example.com` 或 `http://localhost:43127`。
+     */
+    federation_url: string;
+    /**
+     * 自定义 fetch 实现。
+     *
+     * 主要用于测试、Worker 运行时适配，或在请求层注入日志与追踪。
+     */
+    fetch?: FetchLike;
+}
+/**
+ * Admin 角色的 City 构造参数。
+ */
+export interface AdminCityOptions extends CityBaseOptions {
+    /**
+     * 使用 admin 身份访问 Federation。
+     */
+    role: "admin";
+    /**
+     * 当前管理的 City ID。
+     *
+     * token 签发等服务会自动使用该 ID，调用方无需再传 city_id。
+     */
+    city_id: string;
+    /**
+     * Federation 管理密钥。
+     *
+     * 未传入时会由 Federation 回退读取 `DOWNCITY_FEDERATION_ADMIN_SECRET_KEY`。
+     */
+    admin_secret_key?: string;
+}
+/**
+ * User 角色的 City 构造参数。
+ */
+export interface UserCityOptions extends CityBaseOptions {
+    /**
+     * 使用 user 身份访问 Federation。
+     */
+    role: "user";
+    /**
+     * 当前 user_token 绑定的 City ID。
+     *
+     * AI 与普通 service action 调用会自动把该值注入为 `city_id`。
+     */
+    city_id?: string;
+    /**
+     * 终端用户访问 token。
+     */
+    user_token?: string;
+}
+/**
+ * City 构造参数。
+ */
+export type CityOptions = AdminCityOptions | UserCityOptions;
+/**
+ * 按角色收窄后的 City 构造参数。
+ */
+export type CityOptionsForRole<TRole extends CityRole> = TRole extends "admin" ? AdminCityOptions : UserCityOptions;
+//# sourceMappingURL=types.d.ts.map

package/bin/client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,QAAQ,IAAI,KAAK,SAAS,OAAO,GAC1E,gBAAgB,GAChB,eAAe,CAAC"}

package/bin/client/types.js

@@ -0,0 +1,8 @@
+/**
+ * City 客户端构造类型模块。
+ *
+ * City 是访问 Federation 的统一客户端入口：开发者只需要声明访问角色，
+ * SDK 会在内部选择 admin 或 user 能力面。底层 HTTP 协议实现位于 `pact/`。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/bin/{core → client}/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/bin/{core → federation}/auth/authenticator.d.ts

@@ -16,9 +16,9 @@ export interface AuthResult {
     level: RouteIdentity;
     /** 解析出的用户信息（user 级别时可用） */
     user?: RuntimeUser;
-    /** 解析出的 Town 信息（user 级别时可用） */
-    town?: {
-        town_id: string;
+    /** 解析出的 City 信息（user 级别时可用） */
+    city?: {
+        city_id: string;
         status: string;
     };
 }
@@ -29,9 +29,9 @@ export declare class Authenticator {
     /** 缓存的 TokenSigner 实例 */
     private tokenSigner?;
     constructor(env: EnvProvider, store: () => Promise<{
-        town: {
+        city: {
             get(id: string): Promise<{
-                town_id: string;
+                city_id: string;
                 status: string;
             } | undefined>;
         };
@@ -39,7 +39,7 @@ export declare class Authenticator {
     /**
      * 获取（或创建）TokenSigner 单例。
      *
-     * 首次调用时从 env 读取 DOWNCITY_CITY_TOKEN_SIGNING_KEY 创建实例并缓存。
+     * 首次调用时从 env 读取 DOWNCITY_FEDERATION_TOKEN_SIGNING_KEY 创建实例并缓存。
      */
     private getSigner;
     /**
@@ -62,7 +62,7 @@ export declare class Authenticator {
      */
     authenticate(request: Request, required?: RouteAuth): Promise<AuthResult>;
     /**
-     * 签发 user_token（验证 town 状态后签发）。
+     * 签发 user_token（验证 city 状态后签发）。
      *
      * @param input - token 创建参数
      * @returns 签发结果（含 token 字符串）

package/bin/federation/auth/authenticator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authenticator.d.ts","sourceRoot":"","sources":["../../../src/federation/auth/authenticator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAsB,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAClG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE5G,WAAW;AACX,WAAW;AACX,MAAM,WAAW,UAAU;IACzB,eAAe;IACf,KAAK,EAAE,aAAa,CAAC;IACrB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,+BAA+B;IAC/B,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C;AAED,YAAY;AACZ,qBAAa,aAAa;IAKtB,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,KAAK;IALf,yBAAyB;IACzB,OAAO,CAAC,WAAW,CAAC,CAAc;gBAGxB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,MAAM,OAAO,CAAC;QAAE,IAAI,EAAE;YAAE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAA;aAAE,GAAG,SAAS,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC;IAGvH;;;;OAIG;IACH,OAAO,CAAC,SAAS;IASjB;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IA0BpD;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,SAAS,GAAG,UAAU;IAY/D;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAI/E;;;;;OAKG;IACG,WAAW,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAiB7E;;;;;OAKG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAG5D"}

package/bin/{core → federation}/auth/authenticator.js

@@ -22,13 +22,13 @@ export class Authenticator {
     /**
      * 获取（或创建）TokenSigner 单例。
      *
-     * 首次调用时从 env 读取 DOWNCITY_CITY_TOKEN_SIGNING_KEY 创建实例并缓存。
+     * 首次调用时从 env 读取 DOWNCITY_FEDERATION_TOKEN_SIGNING_KEY 创建实例并缓存。
      */
     getSigner() {
         if (!this.tokenSigner) {
-            const signingKey = this.env.get("DOWNCITY_CITY_TOKEN_SIGNING_KEY");
+            const signingKey = this.env.get("DOWNCITY_FEDERATION_TOKEN_SIGNING_KEY");
             if (!signingKey)
-                throw new Error("DOWNCITY_CITY_TOKEN_SIGNING_KEY is required");
+                throw new Error("DOWNCITY_FEDERATION_TOKEN_SIGNING_KEY is required");
             this.tokenSigner = new TokenSigner(signingKey);
         }
         return this.tokenSigner;
@@ -43,22 +43,22 @@ export class Authenticator {
         const token = bearerToken(request);
         if (!token)
             return { level: "guest" };
-        const adminKey = this.env.get("DOWNCITY_CITY_ADMIN_SECRET_KEY");
+        const adminKey = this.env.get("DOWNCITY_FEDERATION_ADMIN_SECRET_KEY");
         if (adminKey && token === adminKey) {
             return { level: "admin" };
         }
         try {
             const payload = await this.getSigner().verify(token);
             const store = await this.store();
-            const town = await store.town.get(payload.town_id);
-            if (!town)
+            const city = await store.city.get(payload.city_id);
+            if (!city)
                 return { level: "guest" };
-            if (town.status !== "active")
+            if (city.status !== "active")
                 return { level: "guest" };
             return {
                 level: "user",
                 user: { user_id: payload.user_id, metadata: payload.metadata ?? {} },
-                town,
+                city,
             };
         }
         catch {
@@ -90,22 +90,22 @@ export class Authenticator {
         return this.authorize(await this.resolve(request), required);
     }
     /**
-     * 签发 user_token（验证 town 状态后签发）。
+     * 签发 user_token（验证 city 状态后签发）。
      *
      * @param input - token 创建参数
      * @returns 签发结果（含 token 字符串）
      */
     async createToken(input) {
         const store = await this.store();
-        const town = await store.town.get(input.town_id);
-        if (!town)
-            throw httpError(404, `Unknown town: ${input.town_id}`);
-        if (town.status !== "active")
-            throw httpError(403, `Town is not active: ${input.town_id}`);
+        const city = await store.city.get(input.city_id);
+        if (!city)
+            throw httpError(404, `Unknown city: ${input.city_id}`);
+        if (city.status !== "active")
+            throw httpError(403, `City is not active: ${input.city_id}`);
         const user_token = await this.getSigner().sign(input);
         return {
             user_token,
-            town_id: input.town_id,
+            city_id: input.city_id,
             user_id: input.user_id,
             ...(input.ttl
                 ? { expires_at: new Date(Date.now() + TokenSigner.parseTTL(input.ttl) * 1000).toISOString() }

package/bin/federation/auth/authenticator.js.map

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

package/bin/federation/auth/token-signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-signer.d.ts","sourceRoot":"","sources":["../../../src/federation/auth/token-signer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEzE,qBAAa,WAAW;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,qCAAqC;IACrC,OAAO,CAAC,SAAS,CAAC,CAAqB;gBAE3B,UAAU,EAAE,MAAM;IAO9B;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAcpB,oBAAoB;IACd,IAAI,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IA4BxD,0CAA0C;IACpC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6BtD,kBAAkB;IAClB,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;CAyB9C"}

package/bin/{core → federation}/auth/token-signer.js

@@ -30,8 +30,8 @@ export class TokenSigner {
     }
     /** 签发 user_token */
     async sign(input) {
-        if (!input || typeof input.town_id !== "string" || input.town_id.length === 0) {
-            throw new TypeError("town_id is required");
+        if (!input || typeof input.city_id !== "string" || input.city_id.length === 0) {
+            throw new TypeError("city_id is required");
         }
         if (typeof input.user_id !== "string" || input.user_id.length === 0) {
             throw new TypeError("user_id is required");
@@ -40,7 +40,7 @@ export class TokenSigner {
         const now = Math.floor(Date.now() / 1000);
         const payload = {
             aud: "downcity:user",
-            town_id: input.town_id,
+            city_id: input.city_id,
             user_id: input.user_id,
             metadata: input.metadata ?? {},
             iat: now,
@@ -70,7 +70,7 @@ export class TokenSigner {
         if (payload.aud !== "downcity:user") {
             throw httpError(401, "Invalid user token audience");
         }
-        if (!payload.town_id || !payload.user_id) {
+        if (!payload.city_id || !payload.user_id) {
             throw httpError(401, "Invalid user token payload");
         }
         return payload;

package/bin/federation/auth/token-signer.js.map

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

package/bin/{core → federation}/auth/types.d.ts

@@ -21,9 +21,9 @@ export interface RuntimeUser {
  */
 export interface CreateUserTokenInput {
     /**
-     * token 所属的 Town ID。
+     * token 所属的 City ID。
      */
-    town_id: string;
+    city_id: string;
     /**
      * token 所属的终端用户 ID。
      */
@@ -48,9 +48,9 @@ export interface UserTokenPayload {
      */
     aud: "downcity:user";
     /**
-     * token 所属 Town ID。
+     * token 所属 City ID。
      */
-    town_id: string;
+    city_id: string;
     /**
      * token 所属用户 ID。
      */
@@ -77,9 +77,9 @@ export interface UserTokenIssueResult {
      */
     user_token: string;
     /**
-     * token 所属 Town ID。
+     * token 所属 City ID。
      */
-    town_id: string;
+    city_id: string;
     /**
      * token 所属用户 ID。
      */

package/bin/federation/auth/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/federation/auth/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,GAAG,EAAE,eAAe,CAAC;IAErB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/bin/federation/auth/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/federation/auth/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/bin/federation/federation-env-catalog.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Federation env requirement 聚合模块。
+ *
+ * 负责把 service.env 与 AI 模型 env requirement 汇总成统一目录。
+ */
+import type { Service } from "../service/service.js";
+import type { EnvCatalogScope } from "../service/env/types.js";
+import type { EnvProvider } from "./runtime.js";
+/**
+ * 聚合当前 Federation 暴露的 env requirement。
+ */
+export declare function collect_federation_env_catalog(services: Service[], env_provider: EnvProvider): EnvCatalogScope[];
+//# sourceMappingURL=federation-env-catalog.d.ts.map

package/bin/federation/federation-env-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation-env-catalog.d.ts","sourceRoot":"","sources":["../../src/federation/federation-env-catalog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,yBAAyB,CAAC;AACrF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,OAAO,EAAE,EACnB,YAAY,EAAE,WAAW,GACxB,eAAe,EAAE,CAsBnB"}