@downcity/city 0.2.17

package/bin/service/env/schema.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Env 数据库 schema 模块。
+ *
+ * 定义 Downcity 内置的 Env 表结构（SQLite + Postgres）。
+ * Env 表存储运行时环境变量，优先级高于 `.env` 文件。
+ */
+/**
+ * 默认 SQLite Env 表。
+ */
+export declare const sqliteEnv: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "env";
+    schema: undefined;
+    columns: {
+        key: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "key";
+            tableName: "env";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        value: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "value";
+            tableName: "env";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        created_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "created_at";
+            tableName: "env";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        updated_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "updated_at";
+            tableName: "env";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+    };
+    dialect: "sqlite";
+}>;
+/**
+ * 默认 Postgres Env 表。
+ */
+export declare const pgEnv: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "env";
+    schema: undefined;
+    columns: {
+        key: import("drizzle-orm/pg-core").PgColumn<{
+            name: "key";
+            tableName: "env";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        value: import("drizzle-orm/pg-core").PgColumn<{
+            name: "value";
+            tableName: "env";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        created_at: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "env";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updated_at: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "env";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+//# sourceMappingURL=schema.d.ts.map

package/bin/service/env/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/service/env/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBhB,CAAC"}

package/bin/service/env/schema.js

@@ -0,0 +1,52 @@
+/**
+ * Env 数据库 schema 模块。
+ *
+ * 定义 Downcity 内置的 Env 表结构（SQLite + Postgres）。
+ * Env 表存储运行时环境变量，优先级高于 `.env` 文件。
+ */
+import { pgTable, text as pgText } from "drizzle-orm/pg-core";
+import { sqliteTable, text as sqliteText } from "drizzle-orm/sqlite-core";
+const DEFAULT_ENV_TABLE = "env";
+/**
+ * 默认 SQLite Env 表。
+ */
+export const sqliteEnv = sqliteTable(DEFAULT_ENV_TABLE, {
+    /**
+     * Env key。
+     */
+    key: sqliteText("key").primaryKey(),
+    /**
+     * Env value。
+     */
+    value: sqliteText("value").notNull(),
+    /**
+     * 创建时间。
+     */
+    created_at: sqliteText("created_at").notNull(),
+    /**
+     * 更新时间。
+     */
+    updated_at: sqliteText("updated_at").notNull(),
+});
+/**
+ * 默认 Postgres Env 表。
+ */
+export const pgEnv = pgTable(DEFAULT_ENV_TABLE, {
+    /**
+     * Env key。
+     */
+    key: pgText("key").primaryKey(),
+    /**
+     * Env value。
+     */
+    value: pgText("value").notNull(),
+    /**
+     * 创建时间。
+     */
+    created_at: pgText("created_at").notNull(),
+    /**
+     * 更新时间。
+     */
+    updated_at: pgText("updated_at").notNull(),
+});
+//# sourceMappingURL=schema.js.map

package/bin/service/env/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/service/env/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1E,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAEhC;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC,iBAAiB,EAAE;IACtD;;OAEG;IACH,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE;IAEnC;;OAEG;IACH,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE;IAEpC;;OAEG;IACH,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IAE9C;;OAEG;IACH,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;CAC/C,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,OAAO,CAAC,iBAAiB,EAAE;IAC9C;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE;IAE/B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE;IAEhC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IAE1C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;CAC3C,CAAC,CAAC"}

package/bin/service/env/types.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Env 层公共类型。
+ *
+ * Downcity 的业务 env 统一由 City 内部管理。
+ * Service / Model 只声明自己需要哪些 key，具体值统一写入 City 的 env 表。
+ */
+/**
+ * Runtime env 列表中的单条记录。
+ */
+export interface EnvEntry extends Record<string, unknown> {
+    /**
+     * 标准化后的环境变量名。
+     */
+    key: string;
+    /**
+     * 环境变量明文值。
+     */
+    value: string;
+    /**
+     * env 值来源。
+     */
+    source: "database";
+}
+/**
+ * 写入 env 时的输入。
+ */
+export interface EnvUpsertInput {
+    /**
+     * 环境变量名。
+     */
+    key: string;
+    /**
+     * 环境变量值。
+     */
+    value: string;
+}
+/**
+ * 单个 env requirement 的当前状态。
+ */
+export interface EnvRequirementStatus {
+    /**
+     * 环境变量 key。
+     */
+    key: string;
+    /**
+     * 给管理员展示的说明文本。
+     */
+    description: string;
+    /**
+     * 当前是否必填。
+     */
+    required: boolean;
+    /**
+     * 当前 City 是否已经配置了该 key。
+     */
+    configured: boolean;
+    /**
+     * 当前值的安全预览文本。
+     */
+    value_preview?: string;
+}
+/**
+ * City 聚合后的 env 配置分组。
+ */
+export interface EnvCatalogScope {
+    /**
+     * 分组唯一标识。
+     */
+    id: string;
+    /**
+     * 分组展示名称。
+     */
+    name: string;
+    /**
+     * 当前分组下的 env requirement 列表。
+     */
+    env: EnvRequirementStatus[];
+}
+//# sourceMappingURL=types.d.ts.map

package/bin/service/env/types.d.ts.map

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

package/bin/service/env/types.js

@@ -0,0 +1,8 @@
+/**
+ * Env 层公共类型。
+ *
+ * Downcity 的业务 env 统一由 City 内部管理。
+ * Service / Model 只声明自己需要哪些 key，具体值统一写入 City 的 env 表。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/bin/service/env/types.js.map

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

package/bin/service/hook.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Hook 模块。
+ *
+ * Hook 是执行生命周期中可注册的回调链，支持 before / after / onError 三个阶段。
+ * 所有 hook 函数接收 Context，不返回值（直接在 ctx 上修改）。
+ */
+import type { Context } from "./service.js";
+/** Hook 回调函数 */
+export type HookFn = (ctx: Context) => void | Promise<void>;
+export declare class Hook {
+    private befores;
+    private afters;
+    private errors;
+    before(fn: HookFn): this;
+    after(fn: HookFn): this;
+    onError(fn: HookFn): this;
+    runBefore(ctx: Context): Promise<void>;
+    runAfter(ctx: Context): Promise<void>;
+    runOnError(ctx: Context): Promise<void>;
+    /** 清空所有 hook */
+    clear(): this;
+}
+//# sourceMappingURL=hook.d.ts.map

package/bin/service/hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/service/hook.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,gBAAgB;AAChB,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5D,qBAAa,IAAI;IACf,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAgB;IAE9B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKxB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKvB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKnB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtC,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrC,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C,gBAAgB;IAChB,KAAK,IAAI,IAAI;CAMd"}

package/bin/service/hook.js

@@ -0,0 +1,49 @@
+/**
+ * Hook 模块。
+ *
+ * Hook 是执行生命周期中可注册的回调链，支持 before / after / onError 三个阶段。
+ * 所有 hook 函数接收 Context，不返回值（直接在 ctx 上修改）。
+ */
+export class Hook {
+    befores = [];
+    afters = [];
+    errors = [];
+    before(fn) {
+        this.befores.push(fn);
+        return this;
+    }
+    after(fn) {
+        this.afters.push(fn);
+        return this;
+    }
+    onError(fn) {
+        this.errors.push(fn);
+        return this;
+    }
+    async runBefore(ctx) {
+        for (const fn of this.befores) {
+            await fn(ctx);
+        }
+    }
+    async runAfter(ctx) {
+        for (const fn of this.afters) {
+            await fn(ctx);
+        }
+    }
+    async runOnError(ctx) {
+        for (const fn of this.errors) {
+            try {
+                await fn(ctx);
+            }
+            catch { /* 不覆盖原始错误 */ }
+        }
+    }
+    /** 清空所有 hook */
+    clear() {
+        this.befores = [];
+        this.afters = [];
+        this.errors = [];
+        return this;
+    }
+}
+//# sourceMappingURL=hook.js.map

package/bin/service/hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.js","sourceRoot":"","sources":["../../src/service/hook.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,OAAO,IAAI;IACP,OAAO,GAAa,EAAE,CAAC;IACvB,MAAM,GAAa,EAAE,CAAC;IACtB,MAAM,GAAa,EAAE,CAAC;IAE9B,MAAM,CAAC,EAAU;QACf,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,EAAU;QACd,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAY;QAC1B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC9B,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAY;QACzB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAY;QAC3B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC7B,IAAI,CAAC;gBAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,gBAAgB;IAChB,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/bin/service/installable-service.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 可安装服务桥接模块。
+ *
+ * 提供 `InstallableService` 基类，把带 `install(ctx)` 生命周期的服务
+ * 统一桥接到 `Service.action()` 体系。
+ */
+import { Service, type Context, type EnvRequirement } from "./service.js";
+import { Hook } from "./hook.js";
+import type { CityTableApi } from "../store/table-api.js";
+import type { CreateUserTokenInput, UserTokenIssueResult, RuntimeUser } from "../core/auth/types.js";
+import type { InstructionDefinition } from "./instruction.js";
+export interface ServiceInstallContext {
+    table<TRow extends Record<string, unknown> = Record<string, unknown>>(name: string): CityTableApi<TRow>;
+    route(config: {
+        method: "GET" | "POST";
+        path: string;
+        auth?: Array<"user" | "admin">;
+        handler: (ctx: ServiceRouteContext) => Promise<Response> | Response;
+    }): void;
+    hook: {
+        before(fn: (ctx: Context) => Promise<void> | void): void;
+        after(fn: (ctx: Context) => Promise<void> | void): void;
+        onError(fn: (ctx: Context) => Promise<void> | void): void;
+    };
+    createUserToken(input: CreateUserTokenInput): Promise<UserTokenIssueResult>;
+    env(key: string): string | undefined;
+}
+export interface ServiceRouteContext {
+    /** 当前 user_token 解析出的用户；免登录或 admin 请求时可能为空 */
+    user?: RuntimeUser;
+    /** 当前 user_token 对应的 studio；免登录或 admin 请求时可能为空 */
+    studio?: {
+        studio_id: string;
+        status: string;
+    };
+    /** 原始 HTTP 请求 */
+    request: Request;
+    /** 读取已解析 JSON 请求体 */
+    json<T extends Record<string, unknown> = Record<string, unknown>>(): Promise<T>;
+    /** 读取原始文本请求体 */
+    text(): Promise<string>;
+    /** 快速返回 JSON Response */
+    jsonResponse(body: unknown, status?: number): Response;
+}
+export declare abstract class InstallableService extends Service {
+    readonly schema?: Record<string, any>;
+    /**
+     * 服务级全局 hook。
+     *
+     * 通过 ServiceInstallContext.hook 注册，City 会在所有 Service Action
+     * 执行时统一触发。服务自己的路由仍然通过 Service.action() 暴露。
+     */
+    readonly globalHook: Hook;
+    constructor(env?: EnvRequirement[]);
+    abstract install(ctx: ServiceInstallContext): void;
+    _onInit(): Promise<void>;
+}
+export type ServiceDefinition = {
+    id: string;
+    name?: string;
+    version?: string;
+    schema?: Record<string, unknown>;
+    /**
+     * 服务依赖的运行时环境变量声明。
+     *
+     * 关键说明（中文）
+     * - 这些 key 会出现在 `/v1/services` 中，供 manager / admin UI 展示
+     * - City 会把这些 key 自动注册到自己的 env requirement 目录中
+     */
+    env?: EnvRequirement[];
+    instruction?: InstructionDefinition;
+    install(ctx: ServiceInstallContext): void;
+};
+export declare function asInstallableService(bp: ServiceDefinition): InstallableService;
+//# sourceMappingURL=installable-service.d.ts.map

package/bin/service/installable-service.d.ts.map

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

package/bin/service/installable-service.js

@@ -0,0 +1,89 @@
+/**
+ * 可安装服务桥接模块。
+ *
+ * 提供 `InstallableService` 基类，把带 `install(ctx)` 生命周期的服务
+ * 统一桥接到 `Service.action()` 体系。
+ */
+import { Service } from "./service.js";
+import { Hook } from "./hook.js";
+import { TableApi } from "../store/table-api.js";
+// ===========================================================================
+// InstallableService 基类
+// ===========================================================================
+export class InstallableService extends Service {
+    schema;
+    /**
+     * 服务级全局 hook。
+     *
+     * 通过 ServiceInstallContext.hook 注册，City 会在所有 Service Action
+     * 执行时统一触发。服务自己的路由仍然通过 Service.action() 暴露。
+     */
+    globalHook = new Hook();
+    constructor(env) {
+        super({ id: "service", env });
+    }
+    async _onInit() {
+        if (this.schema && !this.tables) {
+            this.tables = this.schema;
+        }
+        const self = this;
+        const ctx = {
+            table(name) {
+                if (!self._db)
+                    throw new Error("InstallableService database is not ready");
+                const table = self.tables?.[name];
+                if (!table)
+                    throw new Error(`Unknown table: ${name}`);
+                return new TableApi(self._db, table);
+            },
+            route(config) {
+                // 去掉前导 /，与 client ServiceClient.action() 的 normalizeName 对齐
+                const actionId = config.path.replace(/^\/+/, "");
+                self.action(actionId, async (svcCtx) => {
+                    return await config.handler({
+                        user: svcCtx.user,
+                        studio: svcCtx.studio,
+                        request: svcCtx.request ?? new Request("http://local"),
+                        json: async () => svcCtx.input,
+                        text: async () => svcCtx.raw_body ?? JSON.stringify(svcCtx.input),
+                        jsonResponse: (body, status) => new Response(JSON.stringify(body), {
+                            status, headers: { "content-type": "application/json" },
+                        }),
+                    });
+                }, { method: config.method, auth: config.auth });
+            },
+            hook: {
+                before(fn) { self.globalHook.before(fn); },
+                after(fn) { self.globalHook.after(fn); },
+                onError(fn) { self.globalHook.onError(fn); },
+            },
+            async createUserToken(input) {
+                if (!self._authenticator)
+                    throw new Error("Authenticator not ready");
+                return self._authenticator.createToken(input);
+            },
+            env(key) {
+                return self._env?.get(key);
+            },
+        };
+        this.install(ctx);
+    }
+}
+export function asInstallableService(bp) {
+    return new (class extends InstallableService {
+        constructor() {
+            super(bp.env);
+            this.id = bp.id;
+            if (bp.name)
+                this.name = bp.name;
+            if (bp.schema)
+                this.tables = bp.schema;
+            if (bp.instruction)
+                this.instruction = bp.instruction;
+        }
+        install(ctx) {
+            bp.install(ctx);
+        }
+    })();
+}
+//# sourceMappingURL=installable-service.js.map

package/bin/service/installable-service.js.map

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