@visiblebase/core 0.2.0

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

@@ -0,0 +1,171 @@
+/**
+ * Env 数据库 schema 模块。
+ *
+ * 定义 VisibleBase 内置的 Env 表结构（SQLite + Postgres）。
+ * Env 表存储运行时环境变量，优先级高于 `.env` 文件。
+ */
+/**
+ * 默认 SQLite Env 表。
+ */
+export declare const sqliteEnv: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "visiblebase_env";
+    schema: undefined;
+    columns: {
+        key: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "key";
+            tableName: "visiblebase_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: "visiblebase_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: "visiblebase_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: "visiblebase_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: "visiblebase_env";
+    schema: undefined;
+    columns: {
+        key: import("drizzle-orm/pg-core").PgColumn<{
+            name: "key";
+            tableName: "visiblebase_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: "visiblebase_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: "visiblebase_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: "visiblebase_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 模块。
+ *
+ * 定义 VisibleBase 内置的 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 = "visiblebase_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,iBAAiB,CAAC;AAE5C;;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,37 @@
+/**
+ * Env 层公共类型。
+ *
+ * 环境变量可以来源于 `.env` 文件或数据库。
+ * 数据库中的值优先级高于 `.env` 文件。
+ */
+/**
+ * Runtime env 列表中的单条记录。
+ */
+export interface EnvEntry extends Record<string, unknown> {
+    /**
+     * 标准化后的环境变量名。
+     */
+    key: string;
+    /**
+     * 环境变量明文值。
+     */
+    value: string;
+    /**
+     * env 值来源。
+     */
+    source: "database" | "dotenv";
+}
+/**
+ * 写入 env 时的输入。
+ */
+export interface EnvUpsertInput {
+    /**
+     * 环境变量名。
+     */
+    key: string;
+    /**
+     * 环境变量值。
+     */
+    value: string;
+}
+//# 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,GAAG,QAAQ,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf"}

package/bin/service/env/types.js

@@ -0,0 +1,8 @@
+/**
+ * Env 层公共类型。
+ *
+ * 环境变量可以来源于 `.env` 文件或数据库。
+ * 数据库中的值优先级高于 `.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,20 @@
+/**
+ * Hook 模块。
+ *
+ * Hook 是 service 执行生命周期中可注册的回调链，支持 before / after / onError 三个阶段。
+ * 所有 hook 函数接收 Context，可返回新 Context 替换当前。
+ */
+import type { HookFn } from "./types.js";
+import type { Context } from "./service.js";
+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<Context>;
+    runAfter(ctx: Context): Promise<Context>;
+    runOnError(ctx: Context): Promise<void>;
+}
+//# 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;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,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;IAMxB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMvB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMnB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAQzC,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAQxC,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAK9C"}

package/bin/service/hook.js

@@ -0,0 +1,52 @@
+/**
+ * Hook 模块。
+ *
+ * Hook 是 service 执行生命周期中可注册的回调链，支持 before / after / onError 三个阶段。
+ * 所有 hook 函数接收 Context，可返回新 Context 替换当前。
+ */
+import { assertFunction } from "../utils/validation.js";
+export class Hook {
+    befores = [];
+    afters = [];
+    errors = [];
+    before(fn) {
+        assertFunction(fn, "before");
+        this.befores.push(fn);
+        return this;
+    }
+    after(fn) {
+        assertFunction(fn, "after");
+        this.afters.push(fn);
+        return this;
+    }
+    onError(fn) {
+        assertFunction(fn, "onError");
+        this.errors.push(fn);
+        return this;
+    }
+    async runBefore(ctx) {
+        for (const fn of this.befores) {
+            const next = await fn(ctx);
+            if (next !== undefined)
+                ctx = next;
+        }
+        return ctx;
+    }
+    async runAfter(ctx) {
+        for (const fn of this.afters) {
+            const next = await fn(ctx);
+            if (next !== undefined)
+                ctx = next;
+        }
+        return ctx;
+    }
+    async runOnError(ctx) {
+        for (const fn of this.errors) {
+            try {
+                await fn(ctx);
+            }
+            catch { /* 不覆盖原始错误 */ }
+        }
+    }
+}
+//# 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;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAIxD,MAAM,OAAO,IAAI;IACP,OAAO,GAAa,EAAE,CAAC;IACvB,MAAM,GAAa,EAAE,CAAC;IACtB,MAAM,GAAa,EAAE,CAAC;IAE9B,MAAM,CAAC,EAAU;QACf,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,EAAU;QACd,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,cAAc,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAC9B,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,IAAI,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;YAC3B,IAAI,IAAI,KAAK,SAAS;gBAAE,GAAG,GAAG,IAAI,CAAC;QACrC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAY;QACzB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;YAC3B,IAAI,IAAI,KAAK,SAAS;gBAAE,GAAG,GAAG,IAAI,CAAC;QACrC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,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;CACF"}

package/bin/service/plugin.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Plugin 桥接模块。
+ *
+ * 提供 Plugin 基类，将旧的 Plugin API（install/route/table/hook）
+ * 桥接到新的 Service API。方便现有插件平滑迁移。
+ *
+ * Plugin = Service + install(ctx) 生命周期。
+ */
+import { Service, type RouteAuth } from "./service.js";
+import type { BaseTableApi } from "../store/table-api.js";
+import type { CreateUserTokenInput, UserTokenIssueResult, RuntimeUser } from "../core/auth/types.js";
+/**
+ * Plugin 安装上下文。
+ *
+ * 与 Service 不同，Plugin 通过 install() 手动注册路由和 hook，
+ * 而不是在构造函数中用 this.get()/this.post()。
+ */
+export interface BasePluginContext {
+    /**
+     * 获取指定名称的数据库表 API。
+     */
+    table<TRow extends Record<string, unknown> = Record<string, unknown>>(name: string): BaseTableApi<TRow>;
+    /**
+     * 注册一个路由。
+     */
+    route(config: {
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+        path: string;
+        auth?: RouteAuth;
+        /** 使用属性签名（非 method），避免 TypeScript 将 this 绑定到 config 对象 */
+        handler: (ctx: PluginRouteContext) => Promise<Response> | Response;
+    }): void;
+    /**
+     * 生命周期 hook。
+     */
+    hook: {
+        /** 请求前 */
+        before(fn: (ctx: ServiceContext) => Promise<void> | void): void;
+        /** 请求后 */
+        after(fn: (ctx: ServiceContext) => Promise<void> | void): void;
+        /** 请求出错 */
+        onError(fn: (ctx: ServiceContext) => Promise<void> | void): void;
+    };
+    /**
+     * 签发 user_token。
+     */
+    createUserToken(input: CreateUserTokenInput): Promise<UserTokenIssueResult>;
+    /**
+     * 读取环境变量。
+     */
+    env(key: string): string | undefined;
+}
+/**
+ * 路由 handler 的上下文。
+ */
+export interface PluginRouteContext {
+    /** 当前用户 */
+    user: RuntimeUser;
+    /** 当前 Product */
+    product: {
+        product_id: string;
+        status: string;
+    };
+    /** 原始 Request */
+    request: Request;
+    /** JSON body 解析 */
+    json<T extends Record<string, unknown> = Record<string, unknown>>(): Promise<T>;
+    /** 文本 body 读取 */
+    text(): Promise<string>;
+    /** JSON 响应 */
+    jsonResponse(body: unknown, status?: number): Response;
+}
+/**
+ * Service hook 上下文。
+ */
+export interface ServiceContext {
+    user: RuntimeUser;
+    product: {
+        product_id: string;
+        status: string;
+    };
+    service: string;
+    model?: {
+        id: string;
+        name: string;
+        meta?: Record<string, unknown>;
+    };
+    resolved_model_id?: string;
+    input: Record<string, unknown>;
+    started_at: Date;
+    ended_at?: Date;
+    error?: unknown;
+}
+/**
+ * Plugin 基类。
+ *
+ * 扩展自 Service，新增 install() 生命周期。
+ * 用法：
+ * ```ts
+ * class MyPlugin extends Plugin {
+ *   install(ctx: BasePluginContext): void {
+ *     ctx.route({ method: "GET", path: "/hello", handler: async (c) => c.jsonResponse({ ok: true }) });
+ *     ctx.hook.before(async (sc) => { ... });
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class Plugin extends Service {
+    /**
+     * 插件 schema（与 Service.tables 等价，提供别名兼容）。
+     *
+     * 子类通过 readonly schema = { ... } 定义，
+     * _onInit 中自动同步到 this.tables。
+     */
+    readonly schema?: Record<string, any>;
+    constructor();
+    /**
+     * 安装回调。
+     *
+     * 在 Base 初始化时自动调用，此时 _db/_client/_authenticator/_env 已就绪。
+     */
+    abstract install(ctx: BasePluginContext): void;
+    _onInit(): Promise<void>;
+}
+/**
+ * 函数式 Plugin（简化版，不需要 class）。
+ */
+export type BasePlugin = {
+    id: string;
+    name?: string;
+    version?: string;
+    schema?: Record<string, unknown>;
+    install(ctx: BasePluginContext): void;
+};
+/**
+ * 将函数式 BasePlugin 包装为 Plugin 类实例。
+ *
+ * Base.use() 内部调用此函数，使 Service 和 BasePlugin 都可传入。
+ */
+export declare function asPlugin(bp: BasePlugin): Plugin;
+//# sourceMappingURL=plugin.d.ts.map

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

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

package/bin/service/plugin.js

@@ -0,0 +1,124 @@
+/**
+ * Plugin 桥接模块。
+ *
+ * 提供 Plugin 基类，将旧的 Plugin API（install/route/table/hook）
+ * 桥接到新的 Service API。方便现有插件平滑迁移。
+ *
+ * Plugin = Service + install(ctx) 生命周期。
+ */
+import { Service } from "./service.js";
+import { TableApi } from "../store/table-api.js";
+// ===========================================================================
+// Plugin 基类
+// ===========================================================================
+/**
+ * Plugin 基类。
+ *
+ * 扩展自 Service，新增 install() 生命周期。
+ * 用法：
+ * ```ts
+ * class MyPlugin extends Plugin {
+ *   install(ctx: BasePluginContext): void {
+ *     ctx.route({ method: "GET", path: "/hello", handler: async (c) => c.jsonResponse({ ok: true }) });
+ *     ctx.hook.before(async (sc) => { ... });
+ *   }
+ * }
+ * ```
+ */
+export class Plugin extends Service {
+    /**
+     * 插件 schema（与 Service.tables 等价，提供别名兼容）。
+     *
+     * 子类通过 readonly schema = { ... } 定义，
+     * _onInit 中自动同步到 this.tables。
+     */
+    schema;
+    constructor() {
+        // 占位 id — 子类的 readonly 字段初始化后会覆盖
+        super({ id: "plugin" });
+    }
+    async _onInit() {
+        // 同步 schema → tables（兼容旧插件用 schema 而非 tables）
+        if (this.schema && !this.tables) {
+            this.tables = this.schema;
+        }
+        const self = this;
+        const ctx = {
+            table(name) {
+                if (!self._db)
+                    throw new Error("Plugin database not ready");
+                const table = self.tables?.[name];
+                if (!table)
+                    throw new Error(`Unknown table: ${name}`);
+                return new TableApi(self._db, table);
+            },
+            route(config) {
+                const handler = async (svcCtx) => {
+                    const result = await config.handler({
+                        user: svcCtx.user ?? { user_id: "", metadata: {} },
+                        product: svcCtx.product ?? { product_id: "", status: "active" },
+                        request: svcCtx.request,
+                        json: async () => {
+                            return svcCtx.input;
+                        },
+                        text: async () => JSON.stringify(svcCtx.input),
+                        jsonResponse: (body, status) => new Response(JSON.stringify(body), {
+                            status,
+                            headers: { "content-type": "application/json" },
+                        }),
+                    });
+                    return result;
+                };
+                const methodMap = {
+                    GET: self.get.bind(self),
+                    POST: self.post.bind(self),
+                    PUT: self.put.bind(self),
+                    PATCH: self.patch.bind(self),
+                    DELETE: self.delete.bind(self),
+                };
+                const register = methodMap[config.method];
+                if (register) {
+                    register(config.path, handler, { auth: config.auth });
+                }
+            },
+            hook: {
+                before(fn) { self.hook.before(fn); },
+                after(fn) { self.hook.after(fn); },
+                onError(fn) { self.hook.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);
+    }
+}
+// ===========================================================================
+// 将 BasePlugin 包装为 Plugin 实例
+// ===========================================================================
+/**
+ * 将函数式 BasePlugin 包装为 Plugin 类实例。
+ *
+ * Base.use() 内部调用此函数，使 Service 和 BasePlugin 都可传入。
+ */
+export function asPlugin(bp) {
+    return new (class extends Plugin {
+        constructor() {
+            super();
+            this.id = bp.id;
+            if (bp.name)
+                this.name = bp.name;
+            if (bp.schema)
+                this.tables = bp.schema;
+        }
+        install(ctx) {
+            bp.install(ctx);
+        }
+    })();
+}
+//# sourceMappingURL=plugin.js.map

package/bin/service/plugin.js.map

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

package/bin/service/products/product-store.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Product 数据存储。
+ *
+ * 基于 BaseTableApi，不直接依赖 Drizzle。
+ */
+import type { BaseTableApi } from "../../store/table-api.js";
+import type { Product, ProductCreateInput, ProductStatus } from "./types.js";
+export declare class ProductStore {
+    private table;
+    constructor(table: BaseTableApi<Product>);
+    list(): Promise<Product[]>;
+    get(product_id: string): Promise<Product | undefined>;
+    create(input: ProductCreateInput): Promise<Product>;
+    setStatus(product_id: string, status: ProductStatus): Promise<Product>;
+    remove(product_id: string): Promise<void>;
+}
+//# sourceMappingURL=product-store.d.ts.map

package/bin/service/products/product-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-store.d.ts","sourceRoot":"","sources":["../../../src/service/products/product-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7E,qBAAa,YAAY;IACX,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC;IAE1C,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAI1B,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAKrD,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAenD,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAWtE,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGhD"}