@visiblebase/core 0.2.0 → 0.2.2

package/bin/service/plugin.d.ts

@@ -1,130 +1,53 @@
 /**
  * Plugin 桥接模块。
  *
- * 提供 Plugin 基类，将旧的 Plugin API（install/route/table/hook）
- * 桥接到新的 Service API。方便现有插件平滑迁移。
- *
+ * 提供 Plugin 基类，将旧 Plugin API 桥接到新 Service.action() API。
  * Plugin = Service + install(ctx) 生命周期。
  */
-import { Service, type RouteAuth } from "./service.js";
+import { Service, type Context, type EnvRequirement } from "./service.js";
+import { Hook } from "./hook.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 对象 */
+        auth?: "public" | "user" | "admin";
         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;
+        before(fn: (ctx: Context) => Promise<void> | void): void;
+        after(fn: (ctx: Context) => Promise<void> | void): void;
+        onError(fn: (ctx: Context) => 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();
     /**
-     * 安装回调。
+     * 插件级全局 hook。
      *
-     * 在 Base 初始化时自动调用，此时 _db/_client/_authenticator/_env 已就绪。
+     * 通过 BasePluginContext.hook 注册，Base 会在所有 Service Action
+     * 执行时统一触发。插件自己的路由仍然通过 Service.action() 暴露。
      */
+    readonly globalHook: Hook;
+    constructor(env?: EnvRequirement[]);
     abstract install(ctx: BasePluginContext): void;
     _onInit(): Promise<void>;
 }
-/**
- * 函数式 Plugin（简化版，不需要 class）。
- */
 export type BasePlugin = {
     id: string;
     name?: string;
@@ -132,10 +55,5 @@ export type BasePlugin = {
     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

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

package/bin/service/plugin.js

@@ -1,44 +1,28 @@
 /**
  * Plugin 桥接模块。
  *
- * 提供 Plugin 基类，将旧的 Plugin API（install/route/table/hook）
- * 桥接到新的 Service API。方便现有插件平滑迁移。
- *
+ * 提供 Plugin 基类，将旧 Plugin API 桥接到新 Service.action() API。
  * Plugin = Service + install(ctx) 生命周期。
  */
 import { Service } from "./service.js";
+import { Hook } from "./hook.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;
     /**
-     * 插件 schema（与 Service.tables 等价，提供别名兼容）。
+     * 插件级全局 hook。
      *
-     * 子类通过 readonly schema = { ... } 定义，
-     * _onInit 中自动同步到 this.tables。
+     * 通过 BasePluginContext.hook 注册，Base 会在所有 Service Action
+     * 执行时统一触发。插件自己的路由仍然通过 Service.action() 暴露。
      */
-    schema;
-    constructor() {
-        // 占位 id — 子类的 readonly 字段初始化后会覆盖
-        super({ id: "plugin" });
+    globalHook = new Hook();
+    constructor(env) {
+        super({ id: "plugin", env });
     }
     async _onInit() {
-        // 同步 schema → tables（兼容旧插件用 schema 而非 tables）
         if (this.schema && !this.tables) {
             this.tables = this.schema;
         }
@@ -53,38 +37,25 @@ export class Plugin extends Service {
                 return new TableApi(self._db, table);
             },
             route(config) {
-                const handler = async (svcCtx) => {
-                    const result = await config.handler({
+                // 去掉前导 /，与 client ServiceClient.action() 的 normalizeName 对齐
+                const actionId = config.path.replace(/^\/+/, "");
+                self.action(actionId, async (svcCtx) => {
+                    return 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),
+                        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" },
+                            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 });
-                }
+                }, { method: config.method, auth: config.auth });
             },
             hook: {
-                before(fn) { self.hook.before(fn); },
-                after(fn) { self.hook.after(fn); },
-                onError(fn) { self.hook.onError(fn); },
+                before(fn) { self.globalHook.before(fn); },
+                after(fn) { self.globalHook.after(fn); },
+                onError(fn) { self.globalHook.onError(fn); },
             },
             async createUserToken(input) {
                 if (!self._authenticator)
@@ -98,17 +69,9 @@ export class Plugin extends Service {
         this.install(ctx);
     }
 }
-// ===========================================================================
-// 将 BasePlugin 包装为 Plugin 实例
-// ===========================================================================
-/**
- * 将函数式 BasePlugin 包装为 Plugin 类实例。
- *
- * Base.use() 内部调用此函数，使 Service 和 BasePlugin 都可传入。
- */
 export function asPlugin(bp) {
     return new (class extends Plugin {
-        constructor() {
+        constructor(env) {
             super();
             this.id = bp.id;
             if (bp.name)

package/bin/service/plugin.js.map

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

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

@@ -1,16 +1,11 @@
 /**
  * products 内置服务。
- *
- * 通过 _onInit() 自初始化 ProductStore，Base 不需要知道 ProductStore 的存在。
  */
 import { Service } from "../service.js";
 export declare class ProductsService extends Service {
     private store;
     private auth;
     constructor();
-    /**
-     * Base 调用，传入 DB 和 Auth。Service 自行创建 Store 并种子数据。
-     */
     _onInit(): Promise<void>;
 }
 //# sourceMappingURL=products-service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"products-service.d.ts","sourceRoot":"","sources":["../../../src/service/products/products-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAOxC,qBAAa,eAAgB,SAAQ,OAAO;IAC1C,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,IAAI,CAAiB;;IAmC7B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAU/B"}
+{"version":3,"file":"products-service.d.ts","sourceRoot":"","sources":["../../../src/service/products/products-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAOxC,qBAAa,eAAgB,SAAQ,OAAO;IAC1C,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,IAAI,CAAiB;;IAmCvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAS/B"}

package/bin/service/products/products-service.js

@@ -1,7 +1,5 @@
 /**
  * products 内置服务。
- *
- * 通过 _onInit() 自初始化 ProductStore，Base 不需要知道 ProductStore 的存在。
  */
 import { Service } from "../service.js";
 import { ProductStore } from "./product-store.js";
@@ -12,37 +10,33 @@ export class ProductsService extends Service {
     auth;
     constructor() {
         super({ id: "products", name: "Products", tables: { products: sqliteProducts } });
-        this.get("/", async () => ({ items: await this.store.list() }), { auth: "admin" });
-        this.post("/create", async ({ input }) => {
-            return await this.store.create({ name: String(input.name ?? "") });
+        this.action("list", async () => ({ items: await this.store.list() }), { method: "GET", auth: "admin" });
+        this.action("create", async (ctx) => {
+            return await this.store.create({ name: String(ctx.input.name ?? "") });
         }, { auth: "admin" });
-        this.post("/pause", async ({ input }) => {
-            return await this.store.setStatus(String(input.product_id ?? ""), "paused");
+        this.action("pause", async (ctx) => {
+            return await this.store.setStatus(String(ctx.input.product_id ?? ""), "paused");
         }, { auth: "admin" });
-        this.post("/activate", async ({ input }) => {
-            return await this.store.setStatus(String(input.product_id ?? ""), "active");
+        this.action("activate", async (ctx) => {
+            return await this.store.setStatus(String(ctx.input.product_id ?? ""), "active");
         }, { auth: "admin" });
-        this.post("/remove", async ({ input }) => {
-            await this.store.remove(String(input.product_id ?? ""));
+        this.action("remove", async (ctx) => {
+            await this.store.remove(String(ctx.input.product_id ?? ""));
             return { success: true };
         }, { auth: "admin" });
-        this.post("/tokens/apply", async ({ input }) => {
+        this.action("tokens/apply", async (ctx) => {
             const result = await this.auth.createToken({
-                product_id: String(input.product_id ?? ""),
-                user_id: String(input.user_id ?? ""),
-                metadata: input.metadata,
-                ttl: input.ttl,
+                product_id: String(ctx.input.product_id ?? ""),
+                user_id: String(ctx.input.user_id ?? ""),
+                metadata: ctx.input.metadata,
+                ttl: ctx.input.ttl,
             });
             return { user_token: result.user_token };
         }, { auth: "admin" });
     }
-    /**
-     * Base 调用，传入 DB 和 Auth。Service 自行创建 Store 并种子数据。
-     */
     async _onInit() {
         this.store = new ProductStore(new TableApi(this._db, sqliteProducts));
         this.auth = this._authenticator;
-        // 种子默认 Product
         const existing = await this.store.get("prod_visiblebase");
         if (!existing) {
             await this.store.create({ product_id: "prod_visiblebase", name: "VisibleBase" });

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

@@ -1 +1 @@
-{"version":3,"file":"products-service.js","sourceRoot":"","sources":["../../../src/service/products/products-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"products-service.js","sourceRoot":"","sources":["../../../src/service/products/products-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAqB,MAAM,0BAA0B,CAAC;AAGvE,MAAM,OAAO,eAAgB,SAAQ,OAAO;IAClC,KAAK,CAAgB;IACrB,IAAI,CAAiB;IAE7B;QACE,KAAK,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;QAElF,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAExG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAClC,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAEtB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACjC,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;QAClF,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAEtB,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpC,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;QAClF,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAEtB,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAClC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC;YAC5D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAEtB,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACxC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC;gBACzC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;gBAC9C,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;gBACxC,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,QAA+C;gBACnE,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,GAAkC;aAClD,CAAC,CAAC;YACH,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;QAC3C,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,KAAK,GAAG,IAAI,YAAY,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAI,EAAE,cAAc,CAAqC,CAAC,CAAC;QAC3G,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,cAAe,CAAC;QAEjC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAC1D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,kBAAkB,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;CACF"}

package/bin/service/service.d.ts

@@ -1,118 +1,113 @@
 /**
  * Service — SDK 核心单元。
  *
- * 每个 Service = 路由 + 数据库表 + hook + 自初始化。
- * 只有一个 Context 类型，所有 handler 共用。
+ * 每个 Service = 一组 Action + 数据库表 + hook。
+ * Action 是 Service 的一等能力单元，可独立被 client 调用。
  * Service 需要的基础设施（DB、Auth、Env）由 Base 直接设为属性。
  */
 import type { AnySQLiteTable } from "drizzle-orm/sqlite-core";
 import type { AnyPgTable } from "drizzle-orm/pg-core";
 import { Hook } from "./hook.js";
+import { Action, type ActionFn } from "./action.js";
 import type { BaseTableApi } from "../store/table-api.js";
 import type { Database, DbClient } from "../store/db.js";
 import type { RuntimeUser } from "../core/auth/types.js";
 import type { Authenticator } from "../core/auth/authenticator.js";
 export type RouteAuth = "public" | "user" | "admin";
 export interface Context {
+    /** 请求参数（来自 client 的 input） */
     input: Record<string, unknown>;
-    db: Record<string, BaseTableApi>;
+    /** 原始 HTTP Request，插件 webhook 等需要读取 header 时使用 */
+    request?: Request;
+    /** 原始请求 body 文本，插件 webhook 等需要验签时使用 */
+    raw_body?: string;
+    /** Action 执行结果（after 阶段可用） */
+    output?: unknown;
+    /** 当前用户（route.auth="user" 时有值） */
     user?: RuntimeUser;
+    /** 所属 product */
     product?: {
         product_id: string;
         status: string;
     };
-    request: Request;
-    env(key: string): string | undefined;
-    /** AI 模型信息（AIService 设置，其他 Service 为 undefined） */
-    model?: {
+    /** 当前解析的 variant（如 AI model、翻译语言对等）。由 Service 自行注入 */
+    variant?: {
+        id: string;
+        name: string;
+        meta?: Record<string, unknown>;
+    };
+    /** Action 开始时间（框架自动填充） */
+    started_at?: Date;
+    /** Action 结束时间（框架自动填充） */
+    ended_at?: Date;
+    /** 异常对象（onError hook 可用，框架自动填充） */
+    error?: Error;
+    /** 当前 Service */
+    service?: {
         id: string;
         name: string;
     };
+    /** 当前 Action */
+    action?: {
+        id: string;
+    };
+    /** 数据表（框架注入） */
+    db: Record<string, BaseTableApi>;
+    /** 读环境变量（框架注入） */
+    env(key: string): string | undefined;
 }
-export type Handler = (ctx: Context) => unknown | Response | Promise<unknown | Response>;
 export interface EnvRequirement {
     key: string;
     description: string;
     required: boolean;
 }
-type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
-interface RouteDef {
-    method: HttpMethod;
-    path: string;
-    auth: RouteAuth;
-    handler(ctx: RouteContext): Promise<Response> | Response;
-}
-/** 内部桥接上下文（Base 构造，wrapHandler 消费，不对外导出） */
-export interface RouteContext {
-    request: Request;
-    url: URL;
-    service_id: string;
-    route: RouteDef;
-    user?: RuntimeUser;
-    product?: {
-        product_id: string;
-        status: string;
-    };
-    json<T extends object = Record<string, unknown>>(): Promise<T>;
-    text(): Promise<string>;
-    jsonResponse(body: unknown, status?: number): Response;
-    table(name: string): Promise<BaseTableApi>;
-    env(key: string): string | undefined;
+export interface ActionOptions {
+    /** HTTP 方法，默认 POST */
+    method?: "GET" | "POST";
+    /** 鉴权级别，默认 "user" */
+    auth?: RouteAuth;
 }
 export declare class Service {
     readonly id: string;
     readonly name: string;
+    /** Service 级 hook，该 Service 下所有 Action 共享 */
     readonly hook: Hook;
     readonly tables?: Record<string, AnySQLiteTable | AnyPgTable>;
     readonly env?: EnvRequirement[];
-    /**
-     * 数据库查询接口（Base 初始化后设置）。
-     */
+    /** Action 注册表 */
+    private actionMap;
     _db?: Database;
-    /** 数据库底层连接，用于 DDL（Base 初始化后设置） */
     _client?: {
         $client: DbClient;
     };
-    /**
-     * 鉴权器（Base 初始化后设置）。
-     */
     _authenticator?: Authenticator;
-    /**
-     * Runtime 环境变量（Base 初始化后设置）。
-     */
     _env?: {
         get(key: string): string | undefined;
     };
-    private routes;
+    /** 原始数据库实例（better-sqlite3 / D1 等） */
+    _raw?: unknown;
+    /** 服务公网 URL */
+    _baseURL?: string;
     constructor(options: {
         id: string;
         name?: string;
         tables?: Record<string, AnySQLiteTable | AnyPgTable>;
         env?: EnvRequirement[];
     });
+    _onInit(): Promise<void>;
     /**
-     * 初始化回调（可选）。Base 在设置 _database/_client/_authenticator/_env 后调用。
-     * Service 在此创建自己的 Store、种子数据等。默认空实现。
+     * 注册一个 Action（默认 POST，auth="user"）。
      */
-    _onInit(): Promise<void>;
-    get(path: string, handler: Handler, opts?: {
-        auth?: RouteAuth;
-    }): this;
-    post(path: string, handler: Handler, opts?: {
-        auth?: RouteAuth;
-    }): this;
-    put(path: string, handler: Handler, opts?: {
-        auth?: RouteAuth;
-    }): this;
-    patch(path: string, handler: Handler, opts?: {
-        auth?: RouteAuth;
-    }): this;
-    delete(path: string, handler: Handler, opts?: {
-        auth?: RouteAuth;
-    }): this;
-    _listRoutes(): RouteDef[];
-    private _add;
+    action(id: string, fn: ActionFn, opts?: ActionOptions): Action;
+    /** 获取已注册的 Action */
+    get(id: string): Action | undefined;
+    /** 列出所有已注册的 Action */
+    list(): Action[];
+    /** 列出 Action 及其元数据（Base 内部使用） */
+    _listActionDefs(): Array<{
+        action: Action;
+        method: "GET" | "POST";
+        auth: RouteAuth;
+    }>;
 }
-export declare function serviceRouteFullPath(serviceId: string, route: RouteDef): string;
-export {};
 //# sourceMappingURL=service.d.ts.map

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

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