@downcity/city 0.2.82 → 0.2.92

package/bin/{core/base/base-env-catalog.js → federation/federation-env-catalog.js}

@@ -1,13 +1,13 @@
 /**
- * City env requirement 聚合模块。
+ * Federation env requirement 聚合模块。
  *
  * 负责把 service.env 与 AI 模型 env requirement 汇总成统一目录。
  */
-import { AIService } from "../../service/ai/ai-service.js";
+import { AIService } from "../service/ai/ai-service.js";
 /**
- * 聚合当前 City 暴露的 env requirement。
+ * 聚合当前 Federation 暴露的 env requirement。
  */
-export function collect_city_env_catalog(services, env_provider) {
+export function collect_federation_env_catalog(services, env_provider) {
     const scopes = [];
     for (const service of services) {
         if ((service.env?.length ?? 0) === 0)
@@ -82,4 +82,4 @@ function preview_env_value(value) {
         return value;
     return `${value.slice(0, 6)}...${value.slice(-4)}`;
 }
-//# sourceMappingURL=base-env-catalog.js.map
+//# sourceMappingURL=federation-env-catalog.js.map

package/bin/federation/federation-env-catalog.js.map

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

package/bin/{core/base/base-init.d.ts → federation/federation-init.d.ts}

@@ -1,19 +1,19 @@
 /**
- * City 初始化模块。
+ * Federation 初始化模块。
  *
  * 负责组装表、执行建表、挂载 env store、初始化 authenticator，
  * 并把 runtime 依赖注入到各个 service。
  */
-import { type CityTableApi } from "../../store/table-api.js";
-import { TownStore } from "../../service/towns/town-store.js";
-import { Authenticator } from "../auth/authenticator.js";
-import type { Service } from "../../service/service.js";
-import type { Runtime } from "../runtime.js";
-import type { Database, DbClient } from "../../store/db.js";
+import { type CityTableApi } from "../store/table-api.js";
+import { CityStore } from "../service/cities/city-store.js";
+import { Authenticator } from "./auth/authenticator.js";
+import type { Service } from "../service/service.js";
+import type { Runtime } from "./runtime.js";
+import type { Database, DbClient } from "../store/db.js";
 /**
- * City 初始化后的内部状态。
+ * Federation 初始化后的内部状态。
  */
-export interface CityInitState {
+export interface FederationInitState {
     /** 初始化后的 database */
     database: Database;
     /** 初始化后的底层 client */
@@ -22,27 +22,27 @@ export interface CityInitState {
     };
     /** 所有表 API 映射 */
     table_map: Map<string, CityTableApi>;
-    /** town store */
-    town_store: TownStore;
+    /** city store */
+    city_store: CityStore;
     /** 鉴权器 */
     authenticator: Authenticator;
 }
 /**
- * 执行 City 初始化。
+ * 执行 Federation 初始化。
  */
-export declare function initialize_city(params: {
+export declare function initialize_federation(params: {
     /** runtime 能力 */
     runtime: Runtime;
     /** 已注册服务 */
     services: Service[];
     /** City ready 回调 */
     require_ready: () => Promise<{
-        town: {
+        city: {
             get(id: string): Promise<{
-                town_id: string;
+                city_id: string;
                 status: string;
             } | undefined>;
         };
     }>;
-}): Promise<CityInitState>;
-//# sourceMappingURL=base-init.d.ts.map
+}): Promise<FederationInitState>;
+//# sourceMappingURL=federation-init.d.ts.map

package/bin/federation/federation-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation-init.d.ts","sourceRoot":"","sources":["../../src/federation/federation-init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAqC,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE7F,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qBAAqB;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,qBAAqB;IACrB,MAAM,EAAE;QAAE,OAAO,EAAE,QAAQ,CAAA;KAAE,CAAC;IAC9B,iBAAiB;IACjB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,iBAAiB;IACjB,UAAU,EAAE,SAAS,CAAC;IACtB,UAAU;IACV,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,iBAAiB;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY;IACZ,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,oBAAoB;IACpB,aAAa,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,CAAC;CACvH,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAuD/B"}

package/bin/{core/base/base-init.js → federation/federation-init.js}

@@ -1,24 +1,24 @@
 /**
- * City 初始化模块。
+ * Federation 初始化模块。
  *
  * 负责组装表、执行建表、挂载 env store、初始化 authenticator，
  * 并把 runtime 依赖注入到各个 service。
  */
-import { executeDDL } from "../../store/db.js";
-import { TableApi, buildCreateUserTableSQL } from "../../store/table-api.js";
-import { EnvStore } from "../../service/env/env-store.js";
-import { TownStore } from "../../service/towns/town-store.js";
-import { Authenticator } from "../auth/authenticator.js";
-import { randomSecret } from "../../utils/helpers.js";
+import { executeDDL } from "../store/db.js";
+import { TableApi, buildCreateUserTableSQL } from "../store/table-api.js";
+import { EnvStore } from "../service/env/env-store.js";
+import { CityStore } from "../service/cities/city-store.js";
+import { Authenticator } from "./auth/authenticator.js";
+import { randomSecret } from "../utils/helpers.js";
 /**
- * 执行 City 初始化。
+ * 执行 Federation 初始化。
  */
-export async function initialize_city(params) {
+export async function initialize_federation(params) {
     const { runtime, services, require_ready } = params;
     const { database, client, env, builtinTables } = runtime;
     const user_schema = collect_service_schemas(services);
     const table_map = new Map();
-    table_map.set("towns", new TableApi(database, builtinTables.towns));
+    table_map.set("cities", new TableApi(database, builtinTables.cities));
     table_map.set("env", new TableApi(database, builtinTables.env));
     for (const [name, table] of Object.entries(user_schema)) {
         table_map.set(name, new TableApi(database, table));
@@ -31,14 +31,14 @@ export async function initialize_city(params) {
     }
     const env_table = table_map.get("env");
     if (!env_table)
-        throw new Error("City env table is not initialized");
+        throw new Error("Federation env table is not initialized");
     const env_store = new EnvStore(env_table);
     await env.attachStore(env_store);
-    const towns_table = table_map.get("towns");
-    if (!towns_table)
-        throw new Error("City towns table is not initialized");
-    const town_store = new TownStore(towns_table);
-    const configured_base_url = env.get("DOWNCITY_CITY_BASE_URL")
+    const cities_table = table_map.get("cities");
+    if (!cities_table)
+        throw new Error("City cities table is not initialized");
+    const city_store = new CityStore(cities_table);
+    const configured_base_url = env.get("DOWNCITY_FEDERATION_BASE_URL")
         ?? env.get("BETTER_AUTH_URL")
         ?? runtime.baseURL
         ?? "http://localhost";
@@ -49,7 +49,7 @@ export async function initialize_city(params) {
         service._client = db_client;
         service._authenticator = authenticator;
         service._env = env;
-        service._townStore = town_store;
+        service._cityStore = city_store;
         service._raw = runtime.raw;
         service._baseURL = configured_base_url ?? runtime.baseURL;
         await service._onInit();
@@ -58,7 +58,7 @@ export async function initialize_city(params) {
         database,
         client: db_client,
         table_map,
-        town_store,
+        city_store,
         authenticator,
     };
 }
@@ -82,24 +82,24 @@ function collect_service_schemas(services) {
     return collected;
 }
 /**
- * 确保 City 系统级 env key 存在。
+ * 确保 Federation 系统级 env key 存在。
  *
  * 关键说明（中文）
- * - 系统密钥也统一走 City env 表托管
+ * - 系统密钥也统一走 Federation env 表托管
  * - 缺失时自动生成，避免宿主环境额外配置负担
  */
 async function bootstrap_default_keys(env) {
-    const admin_key = env.get("DOWNCITY_CITY_ADMIN_SECRET_KEY") || `admin_${randomSecret()}`;
-    if (!env.get("DOWNCITY_CITY_ADMIN_SECRET_KEY")) {
-        await env.upsert({ key: "DOWNCITY_CITY_ADMIN_SECRET_KEY", value: admin_key });
+    const admin_key = env.get("DOWNCITY_FEDERATION_ADMIN_SECRET_KEY") || `admin_${randomSecret()}`;
+    if (!env.get("DOWNCITY_FEDERATION_ADMIN_SECRET_KEY")) {
+        await env.upsert({ key: "DOWNCITY_FEDERATION_ADMIN_SECRET_KEY", value: admin_key });
     }
-    const token_key = env.get("DOWNCITY_CITY_TOKEN_SIGNING_KEY") || `sign_${randomSecret()}`;
-    if (!env.get("DOWNCITY_CITY_TOKEN_SIGNING_KEY")) {
-        await env.upsert({ key: "DOWNCITY_CITY_TOKEN_SIGNING_KEY", value: token_key });
+    const token_key = env.get("DOWNCITY_FEDERATION_TOKEN_SIGNING_KEY") || `sign_${randomSecret()}`;
+    if (!env.get("DOWNCITY_FEDERATION_TOKEN_SIGNING_KEY")) {
+        await env.upsert({ key: "DOWNCITY_FEDERATION_TOKEN_SIGNING_KEY", value: token_key });
     }
     const better_auth_secret = env.get("BETTER_AUTH_SECRET") || `better_auth_${randomSecret()}${randomSecret()}`;
     if (!env.get("BETTER_AUTH_SECRET")) {
         await env.upsert({ key: "BETTER_AUTH_SECRET", value: better_auth_secret });
     }
 }
-//# sourceMappingURL=base-init.js.map
+//# sourceMappingURL=federation-init.js.map

package/bin/federation/federation-init.js.map

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

package/bin/federation/federation-instruction.d.ts

@@ -0,0 +1,11 @@
+/**
+ * City instruction 聚合模块。
+ *
+ * 负责将所有 service 的 instruction 与 action 定义汇总成统一文档。
+ */
+import type { Service } from "../service/service.js";
+/**
+ * 聚合 City 的 instruction 文档。
+ */
+export declare function build_federation_instruction(services: Service[]): Promise<string>;
+//# sourceMappingURL=federation-instruction.d.ts.map

package/bin/federation/federation-instruction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation-instruction.d.ts","sourceRoot":"","sources":["../../src/federation/federation-instruction.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD;;GAEG;AACH,wBAAsB,4BAA4B,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BvF"}

package/bin/{core/base/base-instruction.js → federation/federation-instruction.js}

@@ -3,11 +3,11 @@
  *
  * 负责将所有 service 的 instruction 与 action 定义汇总成统一文档。
  */
-import { formatInstructionDocument, resolveInstruction, } from "../../service/instruction.js";
+import { formatInstructionDocument, resolveInstruction, } from "../service/instruction.js";
 /**
  * 聚合 City 的 instruction 文档。
  */
-export async function build_city_instruction(services) {
+export async function build_federation_instruction(services) {
     const sections = [];
     for (const service of services) {
         const actions = service._listInstructionActions();
@@ -28,10 +28,10 @@ export async function build_city_instruction(services) {
     }
     return formatInstructionDocument({
         base: {
-            builtin_services: ["env", "towns"],
+            builtin_services: ["env", "cities"],
             loaded_modules: sections.map((item) => item.id),
         },
         sections,
     });
 }
-//# sourceMappingURL=base-instruction.js.map
+//# sourceMappingURL=federation-instruction.js.map

package/bin/federation/federation-instruction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation-instruction.js","sourceRoot":"","sources":["../../src/federation/federation-instruction.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,yBAAyB,EACzB,kBAAkB,GAEnB,MAAM,2BAA2B,CAAC;AAGnC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,QAAmB;IACpE,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAE1C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,WAAW,EAAE;YACzD,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,OAAO;SACR,CAAC,CAAC;QAEH,QAAQ,CAAC,IAAI,CAAC;YACZ,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,SAAS;YACf,OAAO;YACP,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED,OAAO,yBAAyB,CAAC;QAC/B,IAAI,EAAE;YACJ,gBAAgB,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC;YACnC,cAAc,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;SAChD;QACD,QAAQ;KACT,CAAC,CAAC;AACL,CAAC"}

package/bin/{core/base/base-router.d.ts → federation/federation-router.d.ts}

@@ -1,5 +1,5 @@
 /**
- * City 路由构建模块。
+ * Federation 路由构建模块。
  *
  * 负责把 service/action 暴露为 Hono 路由，并统一处理：
  * - 请求身份解析
@@ -8,27 +8,27 @@
  * - 公共管理接口
  */
 import { Hono } from "hono";
-import type { CityTableApi } from "../../store/table-api.js";
-import type { Service } from "../../service/service.js";
-import type { Authenticator } from "../auth/authenticator.js";
-import type { Runtime } from "../runtime.js";
-import type { RuntimeUser } from "../auth/types.js";
+import type { CityTableApi } from "../store/table-api.js";
+import type { Service } from "../service/service.js";
+import type { Authenticator } from "./auth/authenticator.js";
+import type { Runtime } from "./runtime.js";
+import type { RuntimeUser } from "./auth/types.js";
 declare module "hono" {
     interface ContextVariableMap {
         identity?: {
             kind: "guest" | "user" | "admin";
         };
         user?: RuntimeUser;
-        town?: {
-            town_id: string;
+        city?: {
+            city_id: string;
             status: string;
         };
     }
 }
 /**
- * 构建 City 对外路由。
+ * 构建 Federation 对外路由。
  */
-export declare function build_city_router(params: {
+export declare function build_federation_router(params: {
     /** runtime 能力 */
     runtime: Runtime;
     /** 已注册服务 */
@@ -38,4 +38,4 @@ export declare function build_city_router(params: {
     /** 表映射 */
     table_map: Map<string, CityTableApi>;
 }): Hono;
-//# sourceMappingURL=base-router.d.ts.map
+//# sourceMappingURL=federation-router.d.ts.map

package/bin/federation/federation-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation-router.d.ts","sourceRoot":"","sources":["../../src/federation/federation-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAW,MAAM,uBAAuB,CAAC;AAG9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAInD,OAAO,QAAQ,MAAM,CAAC;IACpB,UAAU,kBAAkB;QAC1B,QAAQ,CAAC,EAAE;YAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC;QAChD,IAAI,CAAC,EAAE,WAAW,CAAC;QACnB,IAAI,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KAC5C;CACF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,iBAAiB;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY;IACZ,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,UAAU;IACV,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU;IACV,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACtC,GAAG,IAAI,CAoJP"}

package/bin/{core/base/base-router.js → federation/federation-router.js}

@@ -1,5 +1,5 @@
 /**
- * City 路由构建模块。
+ * Federation 路由构建模块。
  *
  * 负责把 service/action 暴露为 Hono 路由，并统一处理：
  * - 请求身份解析
@@ -8,14 +8,14 @@
  * - 公共管理接口
  */
 import { Hono } from "hono";
-import { InstallableService } from "../../service/installable-service.js";
-import { httpError } from "../../utils/helpers.js";
-import { build_city_instruction } from "./base-instruction.js";
-import { collect_city_env_catalog } from "./base-env-catalog.js";
+import { InstallableService } from "../service/installable-service.js";
+import { httpError } from "../utils/helpers.js";
+import { build_federation_instruction } from "./federation-instruction.js";
+import { collect_federation_env_catalog } from "./federation-env-catalog.js";
 /**
- * 构建 City 对外路由。
+ * 构建 Federation 对外路由。
  */
-export function build_city_router(params) {
+export function build_federation_router(params) {
     const { runtime, services, authenticator, table_map } = params;
     const app = new Hono();
     app.get("/health", (c) => c.json({
@@ -27,7 +27,7 @@ export function build_city_router(params) {
     }));
     app.use("/v1/*", async (c, next) => {
         // 关键说明（中文）
-        // City env 默认读取运行时内存 cache。
+        // Federation env 默认读取运行时内存 cache。
         // 管理端通过 /v1/env/upsert、/remove、/import 修改 env 时会自动更新当前 cache；
         // 如果直接改数据库，可通过 /v1/env/refresh 或 city CLI 手动刷新。
         sync_request_origin(services, new URL(c.req.raw.url).origin);
@@ -35,8 +35,8 @@ export function build_city_router(params) {
         c.set("identity", { kind: result.level });
         if (result.user)
             c.set("user", result.user);
-        if (result.town)
-            c.set("town", result.town);
+        if (result.city)
+            c.set("city", result.city);
         await next();
     });
     app.get("/v1/services", (c) => c.json({
@@ -51,22 +51,22 @@ export function build_city_router(params) {
             authenticator.authorize({
                 level: c.get("identity")?.kind ?? "guest",
                 user: c.get("user"),
-                town: c.get("town"),
+                city: c.get("city"),
             }, ["admin"]);
-            return c.json({ items: collect_city_env_catalog(services, runtime.env) });
+            return c.json({ items: collect_federation_env_catalog(services, runtime.env) });
         }
         catch (error) {
             return build_error_response(error);
         }
     });
-    app.get("/v1/city/instruction", async (c) => {
+    app.get("/v1/federation/instruction", async (c) => {
         try {
             authenticator.authorize({
                 level: c.get("identity")?.kind ?? "guest",
                 user: c.get("user"),
-                town: c.get("town"),
+                city: c.get("city"),
             }, ["admin"]);
-            return new Response(await build_city_instruction(services), {
+            return new Response(await build_federation_instruction(services), {
                 status: 200,
                 headers: {
                     "content-type": "text/plain; charset=utf-8",
@@ -101,7 +101,7 @@ export function build_city_router(params) {
                     db,
                     identity: c.get("identity") ?? { kind: "guest" },
                     user: c.get("user"),
-                    town: c.get("town"),
+                    city: c.get("city"),
                     env: (key) => runtime.env.get(key),
                     service: { id: service.id, name: service.name },
                     action: { id: action.id },
@@ -117,9 +117,9 @@ export function build_city_router(params) {
                     authenticator.authorize({
                         level: ctx.identity?.kind ?? "guest",
                         user: ctx.user,
-                        town: ctx.town,
+                        city: ctx.city,
                     }, def.auth);
-                    ensure_town_identity_match(ctx);
+                    ensure_city_identity_match(ctx);
                     for (const hook of global_service_hooks(services)) {
                         await hook.runBefore(ctx);
                     }
@@ -202,19 +202,19 @@ function search_params_to_object(search_params) {
     return result;
 }
 /**
- * 校验 input.town_id 与 token 绑定产品一致。
+ * 校验 input.city_id 与 token 绑定产品一致。
  */
-function ensure_town_identity_match(ctx) {
+function ensure_city_identity_match(ctx) {
     if (ctx.identity?.kind !== "user")
         return;
-    const request_town_id = typeof ctx.input.town_id === "string"
-        ? ctx.input.town_id.trim()
+    const request_city_id = typeof ctx.input.city_id === "string"
+        ? ctx.input.city_id.trim()
         : "";
-    if (!request_town_id)
+    if (!request_city_id)
         return;
-    const token_town_id = ctx.town?.town_id ?? "";
-    if (request_town_id !== token_town_id) {
-        throw httpError(403, "town_id does not match the authenticated token");
+    const token_city_id = ctx.city?.city_id ?? "";
+    if (request_city_id !== token_city_id) {
+        throw httpError(403, "city_id does not match the authenticated token");
     }
 }
 /**
@@ -225,4 +225,4 @@ function build_error_response(error) {
     const status = error.statusCode ?? 500;
     return Response.json({ error: { message, type: "server_error" } }, { status: status });
 }
-//# sourceMappingURL=base-router.js.map
+//# sourceMappingURL=federation-router.js.map

package/bin/federation/federation-router.js.map

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

package/bin/{core/base/base-runtime.d.ts → federation/federation-runtime.d.ts}

@@ -1,18 +1,18 @@
 /**
- * City 组装模块。
+ * Federation 组装模块。
  *
  * 关键说明（中文）
  * - 用户只需要传入 Drizzle db，方言、底层 client 全部由 City 自己从 db 推断。
  * - 用户既不需要传 `dialect`，也不需要传 `raw`，避免参数语义重复。
  */
-import type { CityBaseOptions } from "../types.js";
-import type { Runtime } from "../runtime.js";
+import type { FederationOptions } from "./types.js";
+import type { Runtime } from "./runtime.js";
 /**
- * 从 CityBaseOptions 创建 runtime。
+ * 从 FederationOptions 创建 runtime。
  *
  * 关键说明（中文）
  * - 通过 Drizzle 暴露的 `db.dialect` 自动推断 sqlite / pg 方言。
  * - 通过 `db.$client` 提取底层 client，既用于 DDL 也作为 raw 暴露给需要它的 service。
  */
-export declare function create_runtime_from_db(options: CityBaseOptions): Runtime;
-//# sourceMappingURL=base-runtime.d.ts.map
+export declare function create_federation_runtime(options: FederationOptions): Runtime;
+//# sourceMappingURL=federation-runtime.d.ts.map

package/bin/federation/federation-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation-runtime.d.ts","sourceRoot":"","sources":["../../src/federation/federation-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,KAAK,EAA8B,OAAO,EAAE,MAAM,cAAc,CAAC;AAGxE;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAY7E"}

package/bin/{core/base/base-runtime.js → federation/federation-runtime.js}

@@ -1,21 +1,21 @@
 /**
- * City 组装模块。
+ * Federation 组装模块。
  *
  * 关键说明（中文）
  * - 用户只需要传入 Drizzle db，方言、底层 client 全部由 City 自己从 db 推断。
  * - 用户既不需要传 `dialect`，也不需要传 `raw`，避免参数语义重复。
  */
-import { pgEnv, sqliteEnv } from "../../service/env/schema.js";
-import { pgTowns, sqliteTowns } from "../../service/towns/schema.js";
-import { normalizeEnvKey, parseDotenvEntries } from "../../utils/helpers.js";
+import { pgEnv, sqliteEnv } from "../service/env/schema.js";
+import { pgCities, sqliteCities } from "../service/cities/schema.js";
+import { normalizeEnvKey, parseDotenvEntries } from "../utils/helpers.js";
 /**
- * 从 CityBaseOptions 创建 runtime。
+ * 从 FederationOptions 创建 runtime。
  *
  * 关键说明（中文）
  * - 通过 Drizzle 暴露的 `db.dialect` 自动推断 sqlite / pg 方言。
  * - 通过 `db.$client` 提取底层 client，既用于 DDL 也作为 raw 暴露给需要它的 service。
  */
-export function create_runtime_from_db(options) {
+export function create_federation_runtime(options) {
     const dialect = infer_dialect(options.db);
     const builtin_tables = builtin_tables_for(dialect);
     const client = extract_db_client(options.db);
@@ -28,12 +28,12 @@ export function create_runtime_from_db(options) {
     };
 }
 /**
- * 推断 City 内置表定义。
+ * 推断 Federation 内置表定义。
  */
 function builtin_tables_for(dialect) {
     return dialect === "pg"
-        ? { towns: pgTowns, env: pgEnv }
-        : { towns: sqliteTowns, env: sqliteEnv };
+        ? { cities: pgCities, env: pgEnv }
+        : { cities: sqliteCities, env: sqliteEnv };
 }
 /**
  * 从 Drizzle 实例推断方言。
@@ -127,4 +127,4 @@ class DatabaseEnvProvider {
         return stored;
     }
 }
-//# sourceMappingURL=base-runtime.js.map
+//# sourceMappingURL=federation-runtime.js.map

package/bin/federation/federation-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation-runtime.js","sourceRoot":"","sources":["../../src/federation/federation-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAM1E;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAA0B;IAClE,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,cAAc,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAE7C,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,EAAE;QACpB,MAAM;QACN,GAAG,EAAE,IAAI,mBAAmB,EAAE;QAC9B,aAAa,EAAE,cAAc;QAC7B,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC,OAAO;KACxB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,OAAwB;IAClD,OAAO,OAAO,KAAK,IAAI;QACrB,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE;QAClC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,EAA0D;IAC/E,MAAM,YAAY,GAAI,EAAE,CAAC,OAA2D,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC;IAC9G,IAAI,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC;QAAE,OAAO,QAAQ,CAAC;IAClD,IAAI,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,SAAS,GAAG,EAAE,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC;IAC7C,IAAI,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,QAAQ,CAAC;IAClD,IAAI,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,MAAM,IAAI,KAAK,CAAC,6FAA6F,CAAC,CAAC;AACjH,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,EAAyB;IAClD,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC;IAC1B,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,OAAO,MAAkB,CAAC;IAC5B,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,OAAO;YACL,MAAM,EAAE,CAAC,GAAW,EAAE,MAAkB,EAAE,EAAE,CACzC,MAAkE,CAAC,GAAG,EAAE,MAAM,CAAC;SACnF,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;AACnF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,mBAAmB;IACf,KAAK,CAAY;IACR,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEnD,KAAK,CAAC,WAAW,CAAC,KAAe;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QACxB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACtD,GAAG;YACH,KAAK;YACL,MAAM,EAAE,UAAmB;SAC5B,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAqB;QAChC,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC3D,MAAM,cAAc,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAY;QACvB,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,MAAM,GAAe,EAAE,CAAC;QAC9B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/bin/{core/base/base.d.ts → federation/federation.d.ts}

@@ -1,7 +1,7 @@
 /**
- * CityBase 主模块。
+ * Federation 主模块。
  *
- * CityBase 是城市基础设施运行容器，负责协调：
+ * Federation 是城市基础设施运行容器，负责协调：
  * - service 注册
  * - runtime 初始化
  * - 鉴权器访问
@@ -10,12 +10,12 @@
  * 具体初始化、路由构建、instruction 聚合等实现已拆到独立模块。
  */
 import type { Hono } from "hono";
-import { Service } from "../../service/service.js";
-import { type ServiceDefinition } from "../../service/installable-service.js";
-import type { CityBaseOptions, CityBaseHealthStatus, CityHandleRequestOptions } from "../types.js";
-import type { Authenticator } from "../auth/authenticator.js";
-import type { CityTableApi } from "../../store/table-api.js";
-export declare class CityBase {
+import { Service } from "../service/service.js";
+import { type ServiceDefinition } from "../service/installable-service.js";
+import type { FederationOptions, FederationHealthStatus, FederationHandleRequestOptions } from "./types.js";
+import type { Authenticator } from "./auth/authenticator.js";
+import type { CityTableApi } from "../store/table-api.js";
+export declare class Federation {
     private readonly runtime;
     private readonly services;
     private database?;
@@ -24,8 +24,8 @@ export declare class CityBase {
     private init_promise?;
     private hono?;
     private authenticator?;
-    private town_store?;
-    constructor(options: CityBaseOptions);
+    private city_store?;
+    constructor(options: FederationOptions);
     /**
      * 注册 service。
      */
@@ -53,17 +53,17 @@ export declare class CityBase {
     /**
      * 处理 HTTP 请求。
      */
-    handleRequest(request: Request, options?: CityHandleRequestOptions): Promise<Response>;
+    handleRequest(request: Request, options?: FederationHandleRequestOptions): Promise<Response>;
     /**
      * 健康检查。
      */
-    health(): Promise<CityBaseHealthStatus>;
+    health(): Promise<FederationHealthStatus>;
     /**
      * 聚合 instruction 文档。
      */
     instruction(): Promise<string>;
     /**
-     * 执行 City 初始化。
+     * 执行 Federation 初始化。
      */
     private initialize;
     /**
@@ -75,8 +75,8 @@ export declare class CityBase {
      */
     private require_ready_sync;
     /**
-     * 给 Authenticator 延迟访问 town store。
+     * 给 Authenticator 延迟访问 city store。
      */
     private require_ready;
 }
-//# sourceMappingURL=base.d.ts.map
+//# sourceMappingURL=federation.d.ts.map