@downcity/city 0.2.17

package/bin/core/base/base-runtime.js

@@ -0,0 +1,116 @@
+/**
+ * City 组装模块。
+ *
+ * 负责把用户传入的 Drizzle db 适配成 City 内部 runtime 能力，
+ * 并提供默认的数据库 env provider。
+ */
+import { pgEnv, sqliteEnv } from "../../service/env/schema.js";
+import { pgStudios, sqliteStudios } from "../../service/studios/schema.js";
+import { normalizeEnvKey, parseDotenvEntries } from "../../utils/helpers.js";
+/**
+ * 从 CityOptions 创建 runtime。
+ */
+export function create_runtime_from_db(options) {
+    const dialect = options.dialect ?? infer_dialect(options.db);
+    const builtin_tables = builtin_tables_for(dialect);
+    const client = extract_db_client(options.db);
+    return {
+        database: options.db,
+        client,
+        env: new DatabaseEnvProvider(),
+        builtinTables: builtin_tables,
+        raw: options.raw ?? options.db.$client,
+    };
+}
+/**
+ * 推断 City 内置表定义。
+ */
+function builtin_tables_for(dialect) {
+    return dialect === "pg"
+        ? { studios: pgStudios, env: pgEnv }
+        : { studios: sqliteStudios, env: sqliteEnv };
+}
+/**
+ * 从 Drizzle 实例推断方言。
+ */
+function infer_dialect(db) {
+    const entity_kind = db.constructor?.name ?? "";
+    if (/pg|postgres/i.test(entity_kind))
+        return "pg";
+    if (/sqlite|d1/i.test(entity_kind))
+        return "sqlite";
+    throw new Error("Unable to infer Drizzle dialect. Pass { dialect: \"pg\" } or { dialect: \"sqlite\" } to City.");
+}
+/**
+ * 提取底层数据库 client。
+ */
+function extract_db_client(db) {
+    const client = db.$client;
+    if (client && typeof client === "object") {
+        return client;
+    }
+    if (typeof client === "function") {
+        return {
+            unsafe: (sql, params) => client(sql, params),
+        };
+    }
+    throw new Error("Drizzle db must expose $client so City can initialize tables.");
+}
+/**
+ * 数据库存储的 env provider。
+ *
+ * 关键说明（中文）
+ * - City 把所有系统与业务 env 统一托管到 env 表
+ * - 运行时通过内存 cache 加速读取，每次请求前 refresh 保证最新视图
+ */
+class DatabaseEnvProvider {
+    store;
+    cache = new Map();
+    async attachStore(store) {
+        this.store = store;
+        await this.refresh();
+    }
+    get(key) {
+        return this.cache.get(normalizeEnvKey(key));
+    }
+    async refresh() {
+        if (!this.store)
+            return;
+        const entries = await this.store.list();
+        this.cache.clear();
+        for (const entry of entries) {
+            this.cache.set(entry.key, entry.value);
+        }
+    }
+    async list() {
+        await this.refresh();
+        return [...this.cache.entries()].map(([key, value]) => ({
+            key,
+            value,
+            source: "database",
+        }));
+    }
+    async upsert(input) {
+        if (!this.store)
+            throw new Error("Env store is not ready");
+        const entry = await this.store.upsert(input);
+        this.cache.set(entry.key, entry.value);
+        return entry;
+    }
+    async remove(key) {
+        if (!this.store)
+            throw new Error("Env store is not ready");
+        const normalized_key = normalizeEnvKey(key);
+        await this.store.remove(normalized_key);
+        this.cache.delete(normalized_key);
+    }
+    async import(raw) {
+        const entries = parseDotenvEntries(raw);
+        const stored = [];
+        for (const entry of entries) {
+            stored.push(await this.upsert(entry));
+        }
+        return stored;
+    }
+}
+//# sourceMappingURL=base-runtime.js.map

package/bin/core/base/base-runtime.js.map

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

package/bin/core/base/base.d.ts

@@ -0,0 +1,82 @@
+/**
+ * City 主模块。
+ *
+ * City 是城市基础设施运行容器，负责协调：
+ * - service 注册
+ * - runtime 初始化
+ * - 鉴权器访问
+ * - HTTP 路由暴露
+ *
+ * 具体初始化、路由构建、instruction 聚合等实现已拆到独立模块。
+ */
+import type { Hono } from "hono";
+import { Service } from "../../service/service.js";
+import { type ServiceDefinition } from "../../service/installable-service.js";
+import type { CityOptions, CityHealthStatus } from "../types.js";
+import type { Authenticator } from "../auth/authenticator.js";
+import type { CityTableApi } from "../../store/table-api.js";
+export declare class City {
+    private readonly runtime;
+    private readonly services;
+    private database?;
+    private client?;
+    private table_map?;
+    private init_promise?;
+    private hono?;
+    private authenticator?;
+    private studio_store?;
+    constructor(options: CityOptions);
+    /**
+     * 注册 service。
+     */
+    use(service_input: Service | ServiceDefinition): this;
+    /**
+     * 获取单个 service。
+     */
+    getService(id: string): Service | undefined;
+    /**
+     * 获取所有已注册 service。
+     */
+    getServices(): Service[];
+    /**
+     * 获取鉴权器。
+     */
+    getAuthenticator(): Promise<Authenticator>;
+    /**
+     * 获取表 API。
+     */
+    table<TRow extends Record<string, unknown> = Record<string, unknown>>(name: string): Promise<CityTableApi<TRow>>;
+    /**
+     * 返回已构建好的 Hono router。
+     */
+    router(): Hono;
+    /**
+     * 处理 HTTP 请求。
+     */
+    handleRequest(request: Request): Promise<Response>;
+    /**
+     * 健康检查。
+     */
+    health(): Promise<CityHealthStatus>;
+    /**
+     * 聚合 instruction 文档。
+     */
+    instruction(): Promise<string>;
+    /**
+     * 执行 City 初始化。
+     */
+    private initialize;
+    /**
+     * 确保初始化完成。
+     */
+    private ensure_ready;
+    /**
+     * 同步要求初始化完成。
+     */
+    private require_ready_sync;
+    /**
+     * 给 Authenticator 延迟访问 studio store。
+     */
+    private require_ready;
+}
+//# sourceMappingURL=base.d.ts.map

package/bin/core/base/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/core/base/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAOpG,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI7D,qBAAa,IAAI;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IAEvD,OAAO,CAAC,QAAQ,CAAC,CAAW;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAwB;IACvC,OAAO,CAAC,SAAS,CAAC,CAA4B;IAC9C,OAAO,CAAC,YAAY,CAAC,CAAgB;IACrC,OAAO,CAAC,IAAI,CAAC,CAAO;IACpB,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,YAAY,CAAC,CAAc;gBAEvB,OAAO,EAAE,WAAW;IAMhC;;OAEG;IACH,GAAG,CAAC,aAAa,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI;IAQrD;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI3C;;OAEG;IACH,WAAW,IAAI,OAAO,EAAE;IAIxB;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC;IAKhD;;OAEG;IACG,KAAK,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxE,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAO9B;;OAEG;IACH,MAAM,IAAI,IAAI;IAKd;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKxD;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAYzC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAKpC;;OAEG;YACW,UAAU;IAoBxB;;OAEG;YACW,YAAY;IAO1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;YACW,aAAa;CAQ5B"}

package/bin/core/base/base.js

@@ -0,0 +1,156 @@
+/**
+ * City 主模块。
+ *
+ * City 是城市基础设施运行容器，负责协调：
+ * - service 注册
+ * - runtime 初始化
+ * - 鉴权器访问
+ * - HTTP 路由暴露
+ *
+ * 具体初始化、路由构建、instruction 聚合等实现已拆到独立模块。
+ */
+import { asInstallableService } from "../../service/installable-service.js";
+import { EnvService } from "../../service/env/env-service.js";
+import { StudiosService } from "../../service/studios/studios-service.js";
+import { build_city_instruction } from "./base-instruction.js";
+import { initialize_city } from "./base-init.js";
+import { build_city_router } from "./base-router.js";
+import { create_runtime_from_db } from "./base-runtime.js";
+export class City {
+    runtime;
+    services = new Map();
+    database;
+    client;
+    table_map;
+    init_promise;
+    hono;
+    authenticator;
+    studio_store;
+    constructor(options) {
+        this.runtime = options.runtime ?? create_runtime_from_db(options);
+        this.use(new EnvService());
+        this.use(new StudiosService());
+    }
+    /**
+     * 注册 service。
+     */
+    use(service_input) {
+        const service = "install" in service_input && !("get" in service_input)
+            ? asInstallableService(service_input)
+            : service_input;
+        this.services.set(service.id, service);
+        return this;
+    }
+    /**
+     * 获取单个 service。
+     */
+    getService(id) {
+        return this.services.get(id);
+    }
+    /**
+     * 获取所有已注册 service。
+     */
+    getServices() {
+        return [...this.services.values()];
+    }
+    /**
+     * 获取鉴权器。
+     */
+    async getAuthenticator() {
+        await this.ensure_ready();
+        return this.authenticator;
+    }
+    /**
+     * 获取表 API。
+     */
+    async table(name) {
+        await this.ensure_ready();
+        const api = this.table_map?.get(name);
+        if (!api)
+            throw new Error(`Unknown schema table: ${name}`);
+        return api;
+    }
+    /**
+     * 返回已构建好的 Hono router。
+     */
+    router() {
+        this.require_ready_sync();
+        return this.hono;
+    }
+    /**
+     * 处理 HTTP 请求。
+     */
+    async handleRequest(request) {
+        await this.ensure_ready();
+        return this.hono.fetch(request);
+    }
+    /**
+     * 健康检查。
+     */
+    async health() {
+        await this.ensure_ready();
+        const services = this.getServices();
+        return {
+            ok: true,
+            name: "downcity",
+            checked_at: new Date().toISOString(),
+            services: services.map((service) => service.id),
+            service_list: services.map((service) => ({ id: service.id, name: service.name })),
+        };
+    }
+    /**
+     * 聚合 instruction 文档。
+     */
+    async instruction() {
+        await this.ensure_ready();
+        return build_city_instruction(this.getServices());
+    }
+    /**
+     * 执行 City 初始化。
+     */
+    async initialize() {
+        const state = await initialize_city({
+            runtime: this.runtime,
+            services: this.getServices(),
+            require_ready: () => this.require_ready(),
+        });
+        this.database = state.database;
+        this.client = state.client;
+        this.table_map = state.table_map;
+        this.studio_store = state.studio_store;
+        this.authenticator = state.authenticator;
+        this.hono = build_city_router({
+            runtime: this.runtime,
+            services: this.getServices(),
+            authenticator: state.authenticator,
+            table_map: state.table_map,
+        });
+    }
+    /**
+     * 确保初始化完成。
+     */
+    async ensure_ready() {
+        if (!this.init_promise) {
+            this.init_promise = this.initialize();
+        }
+        await this.init_promise;
+    }
+    /**
+     * 同步要求初始化完成。
+     */
+    require_ready_sync() {
+        if (!this.hono) {
+            throw new Error("City init has not completed yet");
+        }
+    }
+    /**
+     * 给 Authenticator 延迟访问 studio store。
+     */
+    async require_ready() {
+        await this.ensure_ready();
+        return {
+            studio: this.studio_store ?? { get: () => Promise.resolve(undefined) },
+        };
+    }
+}
+//# sourceMappingURL=base.js.map

package/bin/core/base/base.js.map

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

package/bin/core/runtime.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Runtime 能力接口模块。
+ *
+ * 定义 City 内部依赖的能力集合。用户侧只需要传入 Drizzle db，
+ * City 会从 db 组装这些能力。
+ *
+ * 使用示例：
+ * ```ts
+ * const city = new City({ db });
+ * ```
+ */
+import type { Database, DbClient } from "../store/db.js";
+import type { EnvEntry, EnvUpsertInput } from "../service/env/types.js";
+import type { EnvStore } from "../service/env/env-store.js";
+import type { AnySQLiteTable } from "drizzle-orm/sqlite-core";
+import type { AnyPgTable } from "drizzle-orm/pg-core";
+/** 表定义类型（SQLite 或 Postgres） */
+export type TableDef = AnySQLiteTable | AnyPgTable;
+/**
+ * 环境变量提供者接口。
+ *
+ * City 通过此接口读取/写入运行时环境变量。
+ */
+export interface EnvProvider {
+    /**
+     * 读取单个环境变量。
+     *
+     * @param key - 环境变量名（会自动标准化）
+     */
+    get(key: string): string | undefined;
+    /**
+     * 主动刷新当前 provider 的读取视图。
+     *
+     * 关键说明（中文）
+     * - City 在每次 HTTP 请求进入时会先调用它
+     * - 这样 Worker 常驻实例也能及时看到别的请求刚写入的 City env
+     */
+    refresh(): Promise<void>;
+    /**
+     * 列出所有环境变量（含来源信息）。
+     */
+    list(): EnvEntry[] | Promise<EnvEntry[]>;
+    /**
+     * 写入或更新环境变量。
+     *
+     * @param input - 环境变量键值
+     */
+    upsert(input: EnvUpsertInput): Promise<EnvEntry>;
+    /**
+     * 删除环境变量。
+     *
+     * @param key - 环境变量名
+     */
+    remove(key: string): Promise<void>;
+    /**
+     * 批量导入环境变量文本（.env 格式）。
+     *
+     * @param raw - .env 文本内容
+     */
+    import(raw: unknown): Promise<EnvEntry[]>;
+    /**
+     * 关联数据库存储。
+     *
+     * City 初始化内置 env 表后调用。
+     * 默认 env provider 会把 City env 表作为唯一业务 env 来源。
+     */
+    attachStore(store: EnvStore): Promise<void>;
+}
+/**
+ * City 内置表定义。
+ *
+ * 包含 studios 和 env 两个内置表。
+ * 适配器根据数据库类型（SQLite / Postgres）提供对应的表定义。
+ */
+export interface BuiltinTables {
+    /** 产品表 */
+    studios: TableDef;
+    /** 环境变量表 */
+    env: TableDef;
+}
+/**
+ * 运行时能力接口。
+ *
+ * 这是 City 内部从 Drizzle db 组装出来的结构，不作为用户主要入口。
+ */
+export interface Runtime {
+    /**
+     * 数据库实例（Drizzle Database 接口）。
+     *
+     * 用于 Service 的 CRUD 操作。
+     */
+    database: Database;
+    /**
+     * 底层数据库客户端（用于 DDL 执行）。
+     */
+    client: DbClient;
+    /**
+     * 环境变量提供者。
+     *
+     * 用于读取密钥、API key 等配置。
+     */
+    env: EnvProvider;
+    /**
+     * City 内置表定义（studios + env）。
+     *
+     * 适配器根据数据库类型提供正确的 Drizzle 表定义。
+     */
+    builtinTables: BuiltinTables;
+    /**
+     * 原始数据库实例（better-sqlite3 Database / D1Database 等）。
+     * 供 better-auth 等第三方库直接使用。
+     */
+    raw?: unknown;
+    /**
+     * 服务公网 URL（http://localhost:43127 或 https://xxx.workers.dev）。
+     * 用于 OAuth callback、邮件链接等。
+     */
+    baseURL?: string;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/bin/core/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/core/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,+BAA+B;AAC/B,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,UAAU,CAAC;AAMnD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAErC;;;;;;OAMG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;OAEG;IACH,IAAI,IAAI,QAAQ,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEzC;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEjD;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE1C;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAMD;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU;IACV,OAAO,EAAE,QAAQ,CAAC;IAClB,YAAY;IACZ,GAAG,EAAE,QAAQ,CAAC;CACf;AAMD;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB;;;;OAIG;IACH,QAAQ,EAAE,QAAQ,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,QAAQ,CAAC;IAEjB;;;;OAIG;IACH,GAAG,EAAE,WAAW,CAAC;IAEjB;;;;OAIG;IACH,aAAa,EAAE,aAAa,CAAC;IAE7B;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/bin/core/runtime.js

@@ -0,0 +1,13 @@
+/**
+ * Runtime 能力接口模块。
+ *
+ * 定义 City 内部依赖的能力集合。用户侧只需要传入 Drizzle db，
+ * City 会从 db 组装这些能力。
+ *
+ * 使用示例：
+ * ```ts
+ * const city = new City({ db });
+ * ```
+ */
+export {};
+//# sourceMappingURL=runtime.js.map

package/bin/core/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/core/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/bin/core/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * City 配置类型模块。
+ *
+ * 包含创建 City 实例和健康检查所需的所有类型定义。
+ */
+import type { Runtime } from "./runtime.js";
+import type { Database } from "../store/db.js";
+/**
+ * City 健康检查结果。
+ */
+export interface CityHealthStatus {
+    /** 当前 Runtime 是否已经完成初始化并可处理请求 */
+    ok: boolean;
+    /** 服务名称，用于外部探测确认命中的服务类型 */
+    name: string;
+    /** 健康检查响应时间 */
+    checked_at: string;
+    /** 当前注册的 service ID 列表 */
+    services: string[];
+    /** 当前启用的 service 信息列表 */
+    service_list: {
+        id: string;
+        name: string;
+    }[];
+}
+/**
+ * 创建 City 实例时传入的顶层配置。
+ *
+ * 默认只需要传入 Drizzle db。City 会自动初始化内置 env/studios 能力。
+ */
+export interface CityOptions {
+    /**
+     * Drizzle database 对象。
+     *
+     * 支持 pg 与 sqlite 方言；D1 也属于 sqlite 方言。
+     */
+    db: Database & {
+        $client?: unknown;
+    };
+    /**
+     * 数据库方言。
+     *
+     * 默认会从 Drizzle db 自动推断；当自定义 db 无法推断时可以显式传入。
+     */
+    dialect?: "pg" | "sqlite";
+    /**
+     * 原始数据库实例。
+     *
+     * 某些服务需要把底层数据库传给第三方库时使用，例如 accounts 服务。
+     * 默认使用 db.$client。
+     */
+    raw?: unknown;
+    /**
+     * 内部运行时能力。
+     *
+     * 保留给测试和高级适配场景；普通用户不需要传入。
+     */
+    runtime?: Runtime;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,eAAe;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,yBAAyB;IACzB,YAAY,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC9C;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,EAAE,EAAE,QAAQ,GAAG;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAErC;;;;OAIG;IACH,OAAO,CAAC,EAAE,IAAI,GAAG,QAAQ,CAAC;IAE1B;;;;;OAKG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/bin/core/types.js

@@ -0,0 +1,7 @@
+/**
+ * City 配置类型模块。
+ *
+ * 包含创建 City 实例和健康检查所需的所有类型定义。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/bin/core/types.js.map

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

package/bin/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @downcity/city 公共入口。
+ */
+export { City } from "./core/base/base.js";
+export type { CityOptions, CityHealthStatus } from "./core/types.js";
+export type { Runtime, EnvProvider, BuiltinTables, TableDef } from "./core/runtime.js";
+export { Service } from "./service/service.js";
+export { InstallableService } from "./service/installable-service.js";
+export { Action } from "./service/action.js";
+export type { Context, RouteAuth, EnvRequirement, } from "./service/service.js";
+export type { ActionFn, HookFn, } from "./service/action.js";
+export type { ServiceDefinition, ServiceInstallContext, ServiceRouteContext, } from "./service/installable-service.js";
+export type { InstructionDefinition, InstructionContext, InstructionActionDefinition, InstructionCapable, } from "./service/instruction.js";
+export { AIService } from "./service/ai/ai-service.js";
+export { Provider } from "./service/ai/provider.js";
+export { createOpenAICompatibleProvider } from "./service/ai/openai-compatible-provider.js";
+export type { ModelConfig, ModelActions, PublicModel, } from "./service/ai/types.js";
+export type { OpenAICompatibleClient, OpenAICompatibleClientConfig, OpenAICompatibleClientFactory, OpenAICompatibleProviderOptions, } from "./service/ai/openai-compatible-provider.js";
+export { TokenSigner } from "./core/auth/token-signer.js";
+export type { RuntimeUser, CreateUserTokenInput, UserTokenPayload, UserTokenIssueResult, } from "./core/auth/types.js";
+export { EnvService } from "./service/env/env-service.js";
+export type { EnvEntry, EnvUpsertInput, EnvRequirementStatus, EnvCatalogScope, } from "./service/env/types.js";
+export { EnvStore } from "./service/env/env-store.js";
+export { StudiosService } from "./service/studios/studios-service.js";
+export type { Studio, StudioCreateInput, StudioStatus } from "./service/studios/types.js";
+export type { Database, DbClient } from "./store/db.js";
+export { executeDDL } from "./store/db.js";
+export type { CityTableApi } from "./store/table-api.js";
+export type { CityUserSchemaInput } from "./store/types.js";
+export { sqliteStudios, pgStudios } from "./service/studios/schema.js";
+export { sqliteEnv, pgEnv } from "./service/env/schema.js";
+export { randomSecret, base64UrlEncode, base64UrlDecode, base64UrlEncodeBytes, base64UrlDecodeBytes, timingSafeEqualBytes, httpError, normalizeEnvKey, bearerToken, parseDotenvEntries, } from "./utils/helpers.js";
+//# sourceMappingURL=index.d.ts.map

package/bin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACrE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAMvF,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,YAAY,EACV,OAAO,EACP,SAAS,EACT,cAAc,GACf,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,QAAQ,EACR,MAAM,GACP,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,8BAA8B,EAAE,MAAM,4CAA4C,CAAC;AAE5F,YAAY,EACV,WAAW,EACX,YAAY,EACZ,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,sBAAsB,EACtB,4BAA4B,EAC5B,6BAA6B,EAC7B,+BAA+B,GAChC,MAAM,4CAA4C,CAAC;AAMpD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,YAAY,EACV,QAAQ,EACR,cAAc,EACd,oBAAoB,EACpB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,YAAY,EAAE,MAAM,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAM1F,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAM5D,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAM3D,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,SAAS,EACT,eAAe,EACf,WAAW,EACX,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}