vome-core 0.0.1

package/dist/src/ext/micro-apps.d.ts

@@ -0,0 +1,60 @@
+import { Elysia } from 'elysia';
+/**
+ * 托管业务模块 web：GET /vome/apps/:key/*
+ * 映射 ~/.vome/{hash}/modules/:key/web/
+ */
+export declare const microApps: Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    vome: {
+        apps: {
+            "*": {
+                get: {
+                    body: unknown;
+                    params: {
+                        "*": string;
+                    } & {};
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: "Not Found" | "Invalid app key" | "App not found" | "Forbidden" | Bun.BunFile;
+                        422: {
+                            type: "validation";
+                            on: string;
+                            summary?: string;
+                            message?: string;
+                            found?: unknown;
+                            property?: string;
+                            expected?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/src/ext/module-gateway.d.ts

@@ -0,0 +1,10 @@
+import { type AnyElysia } from 'elysia';
+/**
+ * 创建业务模块网关（宿主注入 adminAuth 宏插件）
+ *
+ * @example
+ * createModuleGateway({ adminAuth })
+ */
+export declare function createModuleGateway(options: {
+    adminAuth: AnyElysia;
+}): AnyElysia;

package/dist/src/ext/module-registry.d.ts

@@ -0,0 +1,45 @@
+import type { ModuleHandler, ModuleHandlerCtx, ModuleManifest, ModuleRouteDef } from '../../typings/ext/module';
+type LoadedModule = {
+    manifest: ModuleManifest;
+    handlers: Record<string, ModuleHandler>;
+    routes: ModuleRouteDef[];
+};
+/**
+ * 解析 server/index.js：取出 handlers（可选）与是否存在 Plugin 导出痕迹
+ * 有 routes 时必须有 handlers；仅钩子时可无 handlers
+ */
+export declare function loadModuleHandlers(content: string, required?: boolean): Record<string, ModuleHandler>;
+export declare const ModuleRegistry: {
+    get(key: string): LoadedModule | undefined;
+    list(): {
+        key: string;
+        manifest: ModuleManifest;
+        routes: ModuleRouteDef[];
+    }[];
+    /** 加载已落盘模块到内存；无 routes 时可无 handlers（纯页面 / 仅钩子） */
+    load(key: string): LoadedModule;
+    unload(key: string): void;
+    /** 匹配 method + 子路径，调用对应 handler */
+    dispatch(key: string, method: string, subPath: string, ctx: ModuleHandlerCtx): Promise<{
+        ok: false;
+        status: number;
+        message: string;
+        data?: undefined;
+        route?: undefined;
+    } | {
+        ok: true;
+        data: unknown;
+        route: ModuleRouteDef;
+        status?: undefined;
+        message?: undefined;
+    } | {
+        ok: false;
+        status: number;
+        message: string;
+        route: ModuleRouteDef;
+        data?: undefined;
+    }>;
+    /** 扫描 modules/ 下已安装目录并 load */
+    bootstrap(): void;
+};
+export {};

package/dist/src/ext/path.d.ts

@@ -0,0 +1,8 @@
+/** ~/.vome/{md5(keys)} */
+export declare function pDataPath(): string;
+/** 插件 JSON 落盘目录 */
+export declare function pPluginPath(): string;
+/** 已安装业务模块根目录（.vome） */
+export declare function pModulesPath(): string;
+/** 单个业务模块目录 */
+export declare function pModulePath(key: string): string;

package/dist/src/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @vome-core — 同构入口（前后端共用类型与纯工具）
+ *
+ * 服务端框架：`@vome-core/server`
+ * 管理端框架：`@vome-core/admin`
+ */
+export { merge, deepTree, flattenTree, RES_CODE } from './shared';
+export type { Loose, PageQuery, PagePagination, PageResult, ResCode, ApiSuccess, ApiFail, ApiResult, } from './shared';
+/** 与 package.json version 同步 */
+export declare const version: string;

package/dist/src/ioc/container.d.ts

@@ -0,0 +1,29 @@
+import 'reflect-metadata';
+import { type InjectionToken } from './metadata';
+/** @internal 宿主扫描后预创建 Singleton */
+export declare function bootstrapIoc(): void;
+/**
+ * 按类或自定义 id 取实例
+ *
+ * @example
+ * ```ts
+ * Ioc.get(AdminAuthService)
+ * Ioc.get('base.auth.service')
+ * ```
+ */
+declare function get<T = unknown>(token: InjectionToken<T>): T;
+/**
+ * 注册已创建的单例（Cache / Db 等）
+ *
+ * @param token - 类或自定义 id
+ * @param instance - 实例；若 token 为类，会同时按该类可注入
+ */
+declare function set<T>(token: InjectionToken<T>, instance: T): void;
+/** @internal 清空 Singleton 与 Provider 注册（App.stop 时调用） */
+export declare function resetIoc(): void;
+/** 依赖注入容器 */
+export declare const Ioc: {
+    get: typeof get;
+    set: typeof set;
+};
+export {};

package/dist/src/ioc/decorators.d.ts

@@ -0,0 +1,35 @@
+import 'reflect-metadata';
+import { type ClassToken, type InjectionToken, type ProvideOptions } from './metadata';
+/**
+ * 注册为可注入的 Provider。
+ *
+ * @param idOrOptions - 可省略；或自定义 id；或 `{ id, scope }`（作用域只在这里配置）
+ *
+ * @example
+ * ```ts
+ * @Provide()
+ * export class AdminAuthService {}
+ *
+ * @Provide('base.auth.service')
+ * export class AdminAuthService {}
+ *
+ * @Provide({ id: 'base.auth.service', scope: ScopeEnum.Request })
+ * export class OrderContext {}
+ * ```
+ */
+export declare function Provide(idOrOptions?: string | symbol | ProvideOptions): (target: ClassToken) => void;
+/**
+ * 属性注入。
+ *
+ * @param token - 类、字符串 id 或 symbol；省略则用属性 TS 类型
+ *
+ * @example
+ * ```ts
+ * @Inject()
+ * auth: AdminAuthService
+ *
+ * @Inject('base.auth.service')
+ * auth: AdminAuthService
+ * ```
+ */
+export declare function Inject(token?: InjectionToken): (target: object, propertyKey: string | symbol) => void;

package/dist/src/ioc/host.d.ts

@@ -0,0 +1,2 @@
+/** 扫描宿主 modules（service + controller）；CRUD 使用 core 内置 registrar */
+export declare function scanHost(): Promise<void>;

package/dist/src/ioc/index.d.ts

@@ -0,0 +1,6 @@
+export { scanHost } from './host';
+export { bootstrapIoc, resetIoc, Ioc } from './container';
+export { Provide, Inject } from './decorators';
+export { ScopeEnum } from './scope';
+export { appendInjectMeta, listProviders, getProvider } from './metadata';
+export type { ClassToken, InjectionToken, InjectMeta, ProvideOptions, ProviderToken, } from './metadata';

package/dist/src/ioc/metadata.d.ts

@@ -0,0 +1,12 @@
+export declare const INJECT_METADATA_KEY = "vome:inject";
+export type { ClassToken, InjectionToken, InjectMeta, ProvideOptions, ProviderMeta, ProviderToken, ScopeValue, } from '../../typings/ioc/metadata';
+import type { ClassToken, InjectionToken, InjectMeta, ProviderMeta } from '../../typings/ioc/metadata';
+export declare function registerProvider(meta: ProviderMeta): void;
+export declare function getProvider(token: InjectionToken): ProviderMeta | undefined;
+/** 去重后的 Provider 列表（同一 useClass 只出现一次） */
+export declare function listProviders(): ProviderMeta[];
+export declare function tokenLabel(token: InjectionToken): string;
+export declare function appendInjectMeta(target: ClassToken, inject: InjectMeta): void;
+export declare function getInjectMetas(target: ClassToken): InjectMeta[];
+/** @internal App.stop 时清空 Provider 注册表 */
+export declare function resetProviders(): void;

package/dist/src/ioc/scope.d.ts

@@ -0,0 +1,9 @@
+/** Provider 作用域（通过 `@Provide({ scope })` 配置） */
+export declare enum ScopeEnum {
+    /** 全局单例：进程内只创建一次（默认） */
+    Singleton = "singleton",
+    /** 请求作用域：同一 HTTP 请求内复用（依赖 asyncContextManager） */
+    Request = "request",
+    /** 原型：每次 Ioc.get / 注入都 new */
+    Prototype = "prototype"
+}

package/dist/src/logger/bootstrap.d.ts

@@ -0,0 +1,2 @@
+/** 创建可注入 Logger 并写入 IoC（须在 bootstrapIoc 之前） */
+export declare function bootstrapLogger(): void;

package/dist/src/logger/exception.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 业务异常
+ *
+ * 抛出后由全局 onError 拦截：按 logging 配置打日志，并返回 `{ code, message }`。
+ *
+ * @example
+ * ```ts
+ * throw new CommException('获取巧房数据为空')
+ * throw new CommException('未登录', { statusCode: 401, code: 1001 })
+ * ```
+ */
+export declare class CommException extends Error {
+    readonly statusCode: number;
+    readonly code: number;
+    constructor(message: string, options?: {
+        /** HTTP 状态，默认 200（业务错误体） */
+        statusCode?: number;
+        /** 业务码，默认 1001 */
+        code?: number;
+    });
+}
+export declare function isCommException(error: unknown): error is CommException;

package/dist/src/logger/index.d.ts

@@ -0,0 +1,5 @@
+export { Logger } from './logger';
+export { CommException, isCommException } from './exception';
+export { getPinoLogger, resetPinoLogger } from './pino';
+export type { LoggingConfig } from './pino';
+export { bootstrapLogger } from './bootstrap';

package/dist/src/logger/logger.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 可注入业务日志
+ *
+ * @example
+ * ```ts
+ * @Inject()
+ * logger: Logger
+ *
+ * this.logger.error('获取巧房数据为空')
+ * this.logger.info('user %s login', username)
+ * ```
+ */
+export declare class Logger {
+    info(msg: string, ...args: unknown[]): void;
+    warn(msg: string, ...args: unknown[]): void;
+    debug(msg: string, ...args: unknown[]): void;
+    error(msg: string | Error, ...args: unknown[]): void;
+}

package/dist/src/logger/pino.d.ts

@@ -0,0 +1,8 @@
+import { createPinoLogger } from '@bogeychan/elysia-logger';
+import type { LoggingConfig } from '../../typings/logger/config';
+export type { LoggingConfig };
+type AppPino = ReturnType<typeof createPinoLogger>;
+/** 全局 pino（请求日志与可注入 Logger 共用） */
+export declare function getPinoLogger(): AppPino;
+/** @internal App.stop 时清空 */
+export declare function resetPinoLogger(): void;

package/dist/src/orm/base-columns.d.ts

@@ -0,0 +1,11 @@
+/** 实体公共字段（含软删 deletedAt → 回收站） */
+export declare const baseColumns: {
+    id: import("drizzle-orm").IsPrimaryKey<import("drizzle-orm").NotNull<import("drizzle-orm/pg-core").PgSerialBuilderInitial<"id">>>;
+    createTime: import("drizzle-orm").HasDefault<import("drizzle-orm").NotNull<import("drizzle-orm/pg-core").PgTimestampBuilderInitial<"createTime">>>;
+    updateTime: import("drizzle-orm").HasDefault<import("drizzle-orm").HasDefault<import("drizzle-orm").NotNull<import("drizzle-orm/pg-core").PgTimestampBuilderInitial<"updateTime">>>>;
+    /** 软删时间，null = 未删除 */
+    deletedAt: import("drizzle-orm/pg-core").PgTimestampBuilderInitial<"deletedAt">;
+    tenantId: import("drizzle-orm/pg-core").PgIntegerBuilderInitial<"tenantId">;
+};
+/** 公共字段中文注释；columnComments() 会自动合并 */
+export declare const BASE_COLUMN_COMMENTS: Record<string, string>;

package/dist/src/orm/column-comments.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 为 pgTable 登记列注释，供 EPS / 自动筛选 / PG COMMENT 同步。
+ * 自动合并 `BASE_COLUMN_COMMENTS`，业务字段可覆盖。
+ *
+ * @example
+ * export const baseMenu = columnComments(pgTable(...), {
+ *   name: '名称',
+ *   router: '路由',
+ * })
+ */
+export declare function columnComments<T extends object>(table: T, comments?: Record<string, string>): T;
+export declare function getColumnComments(table: object): Record<string, string>;
+/** 已登记的表（schema import 后可用） */
+export declare function listColumnCommentTables(): object[];
+/** Bun.SQL 最小接口（避免 core 强耦合 bun 类型） */
+export type PgCommentSql = {
+    (strings: TemplateStringsArray, ...values: unknown[]): Promise<unknown>;
+    unsafe: (query: string) => Promise<unknown>;
+};
+/**
+ * 将 columnComments 与 PG 现有注释 diff，仅对差异列执行 COMMENT ON COLUMN。
+ * - 未变 → 不写
+ * - 新表 / 新列 / 文案变更 → 只更新对应列
+ */
+export declare function syncColumnCommentsToPg(sql: PgCommentSql): Promise<number>;

package/dist/src/orm/crud-config.d.ts

@@ -0,0 +1,7 @@
+import type { CrudConfig, CrudUpsertMode } from '../../typings/comm/crud';
+/** 读取 vome.crud（唯一入口，供 Repository / BaseService 共用） */
+export declare function readCrudConfig(): CrudConfig;
+/** upsert：参数覆盖 → 配置 → 默认 insert */
+export declare function resolveUpsert(override?: CrudUpsertMode): CrudUpsertMode;
+/** softDelete：参数覆盖 → 配置 → 默认 false */
+export declare function resolveSoftDelete(override?: boolean): boolean;

package/dist/src/orm/crud-register.d.ts

@@ -0,0 +1,5 @@
+import type { CrudRegistrar } from '../../typings/routing/register';
+/**
+ * 框架内置 CRUD 路由（api + restore + serviceApis）
+ */
+export declare const attachCrudRoutes: CrudRegistrar;

package/dist/src/orm/data-scope.d.ts

@@ -0,0 +1,24 @@
+import { type SQL } from 'drizzle-orm';
+import type { PgTable } from 'drizzle-orm/pg-core';
+/** 表是否含 departmentId 列（行级数据权限） */
+export declare function tableHasDepartmentId(table: PgTable): boolean;
+/**
+ * 当前请求数据范围
+ * - off：未写入 / noDataScope，不过滤
+ * - all：超管或角色 dataScope=全部
+ * - none：自定义但无部门，匹配不到任何行
+ * - number[]：按部门 ID 列表过滤
+ *
+ * Context 约定（宿主写入）：
+ * - dataScope: 'all' | 'none' | 'custom'
+ * - dataScopeDeptIds: number[]（custom 时）
+ */
+export declare function resolveDataScope(): 'off' | 'all' | 'none' | number[];
+/** 拼数据范围 where；无隔离时返回原 where */
+export declare function applyDataScopeWhere(table: PgTable, where?: SQL): SQL | undefined;
+/** 租户 + 数据范围（Repository / queryWithOp 统一入口） */
+export declare function applyRowScopes(table: PgTable, where?: SQL): SQL | undefined;
+/**
+ * 局部关闭数据范围过滤（权限解析、跨范围配置等）
+ */
+export declare function noDataScope<T>(fn: () => Promise<T>): Promise<T>;

package/dist/src/orm/db-store.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 数据库访问令牌（宿主 bootstrap 后 Ioc.set(DbStore, store)）
+ *
+ * drizzle / client 具体类型由宿主驱动决定，此处用 unknown 避免多驱动联合爆炸。
+ */
+export declare class DbStore {
+    readonly drizzle: unknown;
+    readonly client?: unknown | undefined;
+    readonly schema?: Record<string, unknown> | undefined;
+    readonly sql?: unknown | undefined;
+    constructor(drizzle: unknown, client?: unknown | undefined, schema?: Record<string, unknown> | undefined, sql?: unknown | undefined);
+}

package/dist/src/orm/entity-schema.d.ts

@@ -0,0 +1,7 @@
+import type { Table } from 'drizzle-orm';
+/** 由表结构生成 select / insert / update 三套 Zod */
+export declare function entitySchemas<T extends Table>(table: T): {
+    select: import("drizzle-zod").BuildSchema<"select", T["_"]["columns"], undefined, undefined>;
+    insert: import("drizzle-zod").BuildSchema<"insert", T["_"]["columns"], undefined, undefined>;
+    update: import("drizzle-zod").BuildSchema<"update", T["_"]["columns"], undefined, undefined>;
+};

package/dist/src/orm/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ORM / CRUD 层
+ *
+ * - DbStore：宿主注入的数据库令牌
+ * - Repository / BaseService：数据访问与业务基类
+ * - QueryOp / 回收站：字段查询与软删
+ * - attachCrudRoutes：内置 CRUD 路由
+ */
+export { DbStore } from './db-store';
+export { baseColumns, BASE_COLUMN_COMMENTS } from './base-columns';
+export { entitySchemas } from './entity-schema';
+export { columnComments, getColumnComments, syncColumnCommentsToPg } from './column-comments';
+export { readCrudConfig, resolveSoftDelete, resolveUpsert, } from './crud-config';
+export { Repository, getRepository, InjectRepository, } from './repository';
+export { BaseService } from './service';
+export { q, compactWhere, needsAdvancedQuery, buildQueryOp } from './query-op';
+export { queryWithOp } from './query-builder';
+export { attachCrudRoutes } from './crud-register';
+export { isTenantEnabled, tableHasTenantId, resolveTenantScope, applyTenantWhere, stampTenantId, noTenant, normalizeHost, } from './tenant';
+export { tableHasDepartmentId, resolveDataScope, applyDataScopeWhere, applyRowScopes, noDataScope, } from './data-scope';
+export type { CrudUpsertMode, CrudModifyType, CrudWriteOptions, CrudTrashQueryOptions, CrudDeleteOptions, } from '../../typings/comm/crud';
+export type { PageQuery, PagePagination, PageResult, } from '../../typings/comm/page';

package/dist/src/orm/query-builder.d.ts

@@ -0,0 +1,12 @@
+import type { PgTable } from 'drizzle-orm/pg-core';
+import type { QueryOp } from '../../typings/routing/crud';
+import type { CrudTrashQueryOptions } from '../../typings/comm/crud';
+import type { PageResult } from '../../typings/comm/page';
+/**
+ * 带 join / select / where / extend 的 list / page
+ */
+export declare function queryWithOp(main: PgTable, body: Record<string, unknown>, op: QueryOp, options: {
+    request?: Request;
+    mode: 'list' | 'page';
+    trash?: CrudTrashQueryOptions;
+}): Promise<unknown[] | PageResult>;

package/dist/src/orm/query-op.d.ts

@@ -0,0 +1,27 @@
+import { type SQL } from 'drizzle-orm';
+import type { PgTable } from 'drizzle-orm/pg-core';
+import type { QueryOp, QueryWhereResult } from '../../typings/routing/crud';
+/** 压平 where 返回值，丢弃空条件 */
+export declare function compactWhere(result: QueryWhereResult | undefined): SQL[];
+/**
+ * where 辅助（字段管理）
+ *
+ * - `between` / `range`：缺参自动跳过
+ * - `eqRest`：剩余 body 字段等值，可用 map 指到 join 列
+ * - `contains`：PG 数组列包含
+ */
+export declare const q: {
+    between(col: unknown, min: unknown, max: unknown): SQL | undefined;
+    range(col: unknown, start: unknown, end: unknown): SQL | undefined;
+    eqRest(params: Record<string, unknown>, table: PgTable, map?: Record<string, unknown>): SQL[];
+    contains(col: unknown, value: unknown): SQL | undefined;
+};
+/** 是否需要 join/select（须走 queryWithOp；where/extend 拼进 where 后走 Service） */
+export declare function needsAdvancedQuery(op?: QueryOp): boolean;
+/**
+ * 从请求体 + QueryOp 拼 where / orderBy（含 fieldArray、fieldRange、where、extend）
+ */
+export declare function buildQueryOp(table: PgTable, body: Record<string, unknown>, op?: QueryOp, request?: Request): Promise<{
+    where?: SQL;
+    orderBySql: SQL[];
+}>;

package/dist/src/orm/repository.d.ts

@@ -0,0 +1,74 @@
+import { type SQL } from 'drizzle-orm';
+import type { InferSelectModel } from 'drizzle-orm';
+import type { PgTable } from 'drizzle-orm/pg-core';
+import { entitySchemas } from './entity-schema';
+import type { CrudTrashQueryOptions } from '../../typings/comm/crud';
+import type { PageResult } from '../../typings/comm/page';
+type SchemaBundle = ReturnType<typeof entitySchemas>;
+/**
+ * 表级数据访问（按 pgTable 单例缓存）
+ *
+ * 查询默认排除已软删；写入走 Zod（entitySchemas）校验。
+ */
+export declare class Repository<T extends PgTable> {
+    readonly table: T;
+    readonly schema: SchemaBundle;
+    constructor(table: T, schema?: SchemaBundle);
+    /** 表是否有 deletedAt，能否进回收站 */
+    supportsSoftDelete(): boolean;
+    private scopedWhere;
+    /** 列表查询 */
+    find(where?: SQL, options?: CrudTrashQueryOptions & {
+        orderBy?: SQL[];
+    }): Promise<InferSelectModel<T>[]>;
+    /** 取第一条 */
+    findOne(where: SQL, options?: CrudTrashQueryOptions): Promise<InferSelectModel<T> | undefined>;
+    /** 按主键 id 查询 */
+    findById(id: number | string, options?: CrudTrashQueryOptions): Promise<InferSelectModel<T> | undefined>;
+    /** 计数 */
+    count(where?: SQL, options?: CrudTrashQueryOptions): Promise<number>;
+    /** 分页：返回 list + pagination */
+    findPage(options: {
+        page: number;
+        size: number;
+        where?: SQL;
+        orderBy?: SQL[];
+    } & CrudTrashQueryOptions): Promise<PageResult<InferSelectModel<T>>>;
+    private parseInsert;
+    /** 插入；对象 / 数组都直接交给 values()（Drizzle 两者都支持） */
+    create(data: unknown): Promise<InferSelectModel<T> | InferSelectModel<T>[]>;
+    /**
+     * 有 id 且存在则更新，否则插入。
+     * 对象 / 数组均可；数组时一次查出已存在 id，再批量 update + insert。
+     */
+    save(data: unknown): Promise<InferSelectModel<T> | InferSelectModel<T>[]>;
+    /**
+     * 更新：
+     * - update(where, patch) 条件更新
+     * - update([{ id, ...patch }, ...]) 按 id 批量；相同 patch 合并为一次 inArray
+     */
+    update(whereOrRows: SQL | Record<string, unknown>[], data?: unknown): Promise<InferSelectModel<T> | InferSelectModel<T>[] | undefined>;
+    /** 按行批量更新：同 patch 合并 inArray，一次 SQL */
+    private updateByRows;
+    /** SQL 或 id / id[] → where（数组走 inArray，一次条件） */
+    private resolveIdWhere;
+    /** 软删：写入 deletedAt；支持 SQL / id / id[] */
+    softDelete(whereOrIds: SQL | number | string | Array<number | string>): Promise<void>;
+    /** 恢复：清空 deletedAt；支持 SQL / id / id[] */
+    restore(whereOrIds: SQL | number | string | Array<number | string>): Promise<void>;
+    /** 硬删；支持 SQL / id / id[]（一次 DELETE … IN） */
+    forceDelete(whereOrIds: SQL | number | string | Array<number | string>): Promise<void>;
+}
+/** 按表取单例 Repository */
+export declare function getRepository<T extends PgTable>(table: T): Repository<T>;
+/**
+ * 属性注入 Repository
+ *
+ * @example
+ * ```ts
+ * @InjectRepository(baseUser)
+ * baseUserEntity: Repository<typeof baseUser>
+ * ```
+ */
+export declare function InjectRepository<T extends PgTable>(table: T): (target: object, propertyKey: string | symbol) => void;
+export {};

package/dist/src/orm/service.d.ts

@@ -0,0 +1,71 @@
+import { type SQL } from 'drizzle-orm';
+import type { Repository } from './repository';
+import type { CrudDeleteOptions, CrudModifyType, CrudTrashQueryOptions, CrudWriteOptions } from '../../typings/comm/crud';
+import type { PageQuery, PageResult } from '../../typings/comm/page';
+/**
+ * 业务 Service 基类
+ *
+ * 第一个 `@InjectRepository` 会自动绑定主实体，之后可用下方通用 CRUD。
+ * 可重写 `modifyBefore` / `modifyAfter` 在增删改前后处理数据。
+ * add / update / delete 均支持数组（内部判断，一次批量落库）。
+ */
+export declare abstract class BaseService {
+    protected entity?: Repository<any>;
+    /** IoC 注入时绑定主实体（仅首次） */
+    bindEntity(repo: Repository<any>): void;
+    /** 显式绑定主实体（CRUD 无 Service 时用） */
+    setEntity(repo: Repository<any>): void;
+    /** 是否已绑定主实体 */
+    hasEntity(): boolean;
+    /** 取已绑定 Repository */
+    getRepo(): Repository<any>;
+    private requireEntity;
+    /**
+     * 增删改之前（子类按需重写）
+     * - add / update：data 为写入对象或数组
+     * - delete：data 为 where 条件
+     */
+    modifyBefore(_data: any, _type: CrudModifyType): Promise<void>;
+    /**
+     * 增删改之后（子类按需重写）
+     * - add / update：data 多为落库后的行（或原写入对象）
+     * - delete：data 为 where 条件
+     */
+    modifyAfter(_data: any, _type: CrudModifyType): Promise<void>;
+    /** 新增；数组走 create/save 批量；受 vome.crud.upsert 控制 */
+    add(data: unknown, options?: CrudWriteOptions): Promise<{
+        [x: string]: any;
+    } | {
+        [x: string]: any;
+    }[]>;
+    /**
+     * 更新：
+     * - update(where, patch) SQL 条件
+     * - update({ id, ... }) 单条
+     * - update([{ id, ... }, ...]) 批量（同 patch 合并 inArray）
+     */
+    update(whereOrData: SQL | Record<string, unknown> | Record<string, unknown>[], data?: unknown): Promise<any>;
+    /**
+     * 删除：开启软删则进回收站，否则硬删；force 强制硬删。
+     * whereOrIds 原样交给 Repository（SQL / id / id[]）。
+     * 业务校验统一重写本方法；彻底删除传 { force: true }。
+     */
+    delete(whereOrIds: SQL | number | string | Array<number | string>, options?: CrudDeleteOptions): Promise<void>;
+    /** 从回收站恢复；SQL / id / id[] */
+    restore(whereOrIds: SQL | number | string | Array<number | string>): Promise<void>;
+    /** 列表（默认不含回收站；onlyTrashed / withTrashed 可调） */
+    list(where?: SQL, options?: CrudTrashQueryOptions & {
+        orderBy?: SQL[];
+    }): Promise<{
+        [x: string]: any;
+    }[]>;
+    /** 详情：传 id 或 where */
+    info(idOrWhere: number | string | SQL, options?: CrudTrashQueryOptions): Promise<{
+        [x: string]: any;
+    } | undefined>;
+    /** 分页 */
+    page(query?: PageQuery & {
+        where?: SQL;
+        orderBy?: SQL[];
+    } & CrudTrashQueryOptions): Promise<PageResult>;
+}

package/dist/src/orm/tenant.d.ts

@@ -0,0 +1,24 @@
+import { type SQL } from 'drizzle-orm';
+import type { PgTable } from 'drizzle-orm/pg-core';
+/** 是否开启多租户隔离 */
+export declare function isTenantEnabled(): boolean;
+/** 表是否含 tenantId 列 */
+export declare function tableHasTenantId(table: PgTable): boolean;
+/**
+ * 当前请求租户作用域
+ * - off：不隔离
+ * - all：超管 / noTenant，看全量
+ * - none：已开启但无 tenantId，匹配不到任何行
+ * - number：按该租户过滤
+ */
+export declare function resolveTenantScope(): 'off' | 'all' | 'none' | number;
+/** 拼租户 where；无隔离时返回原 where */
+export declare function applyTenantWhere(table: PgTable, where?: SQL): SQL | undefined;
+/** 写入时自动带上 tenantId（仅普通租户用户） */
+export declare function stampTenantId<T extends Record<string, unknown>>(table: PgTable, data: T): T;
+/**
+ * 局部关闭租户过滤（跨租户查询、登录、权限菜单等）
+ */
+export declare function noTenant<T>(fn: () => Promise<T>): Promise<T>;
+/** 规范化 Host：小写、去端口 */
+export declare function normalizeHost(host: string | null | undefined): string;