@pangza/orm 0.0.0-stage → 1.0.0

package/dist/tableSearch.d.ts

@@ -0,0 +1,72 @@
+import "reflect-metadata";
+import { QueryWrapper } from "./QueryWrapper";
+import type { PageQuery } from "./types";
+/** 对齐 Java OperTypeEnum（并补充 NOT_* / IN / BETWEEN / IS_NULL） */
+export declare const OperTypeEnum: {
+    readonly EQ: "EQ";
+    readonly LIKE: "LIKE";
+    readonly LIKE_LEFT: "LIKE_LEFT";
+    readonly LIKE_RIGHT: "LIKE_RIGHT";
+    readonly NOT_LIKE: "NOT_LIKE";
+    readonly GT: "GT";
+    readonly GE: "GE";
+    readonly LT: "LT";
+    readonly LE: "LE";
+    readonly NE: "NE";
+    readonly IN: "IN";
+    readonly NOT_IN: "NOT_IN";
+    readonly BETWEEN: "BETWEEN";
+    readonly NOT_BETWEEN: "NOT_BETWEEN";
+    readonly IS_NULL: "IS_NULL";
+    readonly IS_NOT_NULL: "IS_NOT_NULL";
+};
+export type OperType = (typeof OperTypeEnum)[keyof typeof OperTypeEnum];
+export interface TableSearchOptions {
+    /** 数据库列名；空则用字段名 camel → snake（nickName → nick_name） */
+    column?: string;
+    /** 默认 EQ */
+    operator?: OperType;
+}
+export interface TableSearchMeta {
+    property: string;
+    column: string;
+    operator: OperType;
+}
+/** 对齐 Java QueryWrapperAndPage */
+export interface QueryWrapperAndPage {
+    queryWrapper: QueryWrapper;
+    page: Required<PageQuery>;
+}
+type FormCtor = Function;
+type WrapperConsumer = (wrapper: QueryWrapper) => void;
+/**
+ * 标记分页/列表查询字段（对齐 Java @TableSearch）。
+ *
+ * @example
+ * class UserPageDTO {
+ *   @TableSearch({ operator: OperTypeEnum.LIKE })
+ *   username?: string;
+ *   @TableSearch({ column: "name_zh" })
+ *   name?: string;
+ * }
+ */
+export declare function TableSearch(options?: TableSearchOptions | OperType): PropertyDecorator;
+/** 读取类上全部 @TableSearch 元数据（含父类，子类覆盖） */
+export declare function getTableSearchMeta(formClass: FormCtor): TableSearchMeta[];
+/**
+ * 根据表单 + DTO 类上的 @TableSearch 构建 QueryWrapper。
+ * JSON body 无原型信息，故第二参数必须传类（如 UserPageDTO）。
+ */
+export declare function getQueryWrapper(form: unknown, formClass: FormCtor, consumer?: WrapperConsumer): QueryWrapper;
+/**
+ * 构建 QueryWrapper + 分页参数。
+ *
+ * @example
+ * getQueryWrapperAndPage(form, UserPageDTO)
+ * getQueryWrapperAndPage(form, UserPageDTO, pageNum, pageSize)
+ * getQueryWrapperAndPage(form, UserPageDTO, pageNum, pageSize, (w) => w.orderByDesc('create_time'))
+ * getQueryWrapperAndPage(form, UserPageDTO, (w) => w.orderByDesc('id'))
+ */
+export declare function getQueryWrapperAndPage(form: unknown, formClass: FormCtor, currentOrConsumer?: number | WrapperConsumer, size?: number, consumer?: WrapperConsumer): QueryWrapperAndPage;
+export {};
+//# sourceMappingURL=tableSearch.d.ts.map

package/dist/tableSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableSearch.d.ts","sourceRoot":"","sources":["../src/tableSearch.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAG1B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,+DAA+D;AAC/D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;CAiBf,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAExE,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY;IACZ,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,kCAAkC;AAClC,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,YAAY,CAAC;IAC3B,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;CAC3B;AAED,KAAK,QAAQ,GAAG,QAAQ,CAAC;AACzB,KAAK,eAAe,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;AAmBvD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,OAAO,CAAC,EAAE,kBAAkB,GAAG,QAAQ,GACtC,iBAAiB,CAcnB;AAUD,wCAAwC;AACxC,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,QAAQ,GAAG,eAAe,EAAE,CAQzE;AA6HD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,QAAQ,EACnB,QAAQ,CAAC,EAAE,eAAe,GACzB,YAAY,CAKd;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,QAAQ,EACnB,iBAAiB,CAAC,EAAE,MAAM,GAAG,eAAe,EAC5C,IAAI,CAAC,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,eAAe,GACzB,mBAAmB,CAuBrB"}

package/dist/tableSearch.js

@@ -0,0 +1,232 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperTypeEnum = void 0;
+exports.TableSearch = TableSearch;
+exports.getTableSearchMeta = getTableSearchMeta;
+exports.getQueryWrapper = getQueryWrapper;
+exports.getQueryWrapperAndPage = getQueryWrapperAndPage;
+require("reflect-metadata");
+const beanKeys_1 = require("@pangza/core/Json/beanKeys");
+const case_1 = require("@pangza/core/utils/case");
+const QueryWrapper_1 = require("./QueryWrapper");
+/** 对齐 Java OperTypeEnum（并补充 NOT_* / IN / BETWEEN / IS_NULL） */
+exports.OperTypeEnum = {
+    EQ: "EQ",
+    LIKE: "LIKE",
+    LIKE_LEFT: "LIKE_LEFT",
+    LIKE_RIGHT: "LIKE_RIGHT",
+    NOT_LIKE: "NOT_LIKE",
+    GT: "GT",
+    GE: "GE",
+    LT: "LT",
+    LE: "LE",
+    NE: "NE",
+    IN: "IN",
+    NOT_IN: "NOT_IN",
+    BETWEEN: "BETWEEN",
+    NOT_BETWEEN: "NOT_BETWEEN",
+    IS_NULL: "IS_NULL",
+    IS_NOT_NULL: "IS_NOT_NULL",
+};
+const TABLE_SEARCH_KEY = Symbol.for("pangza.orm.tableSearch");
+function searchMap(ctor) {
+    return (Reflect.getOwnMetadata(TABLE_SEARCH_KEY, ctor) ??
+        {});
+}
+function resolveColumn(property, column) {
+    const c = column?.trim();
+    if (c)
+        return c;
+    return (0, case_1.camelToSnake)(property);
+}
+/**
+ * 标记分页/列表查询字段（对齐 Java @TableSearch）。
+ *
+ * @example
+ * class UserPageDTO {
+ *   @TableSearch({ operator: OperTypeEnum.LIKE })
+ *   username?: string;
+ *   @TableSearch({ column: "name_zh" })
+ *   name?: string;
+ * }
+ */
+function TableSearch(options) {
+    return (target, propertyKey) => {
+        const ctor = target.constructor;
+        const prop = String(propertyKey);
+        const opts = typeof options === "string" ? { operator: options } : options ?? {};
+        const map = { ...searchMap(ctor) };
+        map[prop] = {
+            column: resolveColumn(prop, opts.column),
+            operator: opts.operator ?? exports.OperTypeEnum.EQ,
+        };
+        Reflect.defineMetadata(TABLE_SEARCH_KEY, map, ctor);
+        (0, beanKeys_1.addBeanKey)(ctor, prop);
+    };
+}
+function collectSearchMap(ctor) {
+    const proto = Object.getPrototypeOf(ctor.prototype);
+    const parentCtor = proto?.constructor;
+    const parentMap = parentCtor && parentCtor !== Object ? collectSearchMap(parentCtor) : {};
+    return { ...parentMap, ...searchMap(ctor) };
+}
+/** 读取类上全部 @TableSearch 元数据（含父类，子类覆盖） */
+function getTableSearchMeta(formClass) {
+    return Object.entries(collectSearchMap(formClass)).map(([property, meta]) => ({
+        property,
+        column: meta.column,
+        operator: meta.operator,
+    }));
+}
+function isEmptyValue(value) {
+    if (value == null)
+        return true;
+    if (typeof value === "string" && value.trim() === "")
+        return true;
+    if (Array.isArray(value) && value.length === 0)
+        return true;
+    return false;
+}
+function toArray(value) {
+    if (Array.isArray(value))
+        return value;
+    if (typeof value === "string") {
+        return value
+            .split(",")
+            .map((s) => s.trim())
+            .filter((s) => s !== "");
+    }
+    return [value];
+}
+function toBetweenPair(value) {
+    if (Array.isArray(value) && value.length >= 2) {
+        return [value[0], value[1]];
+    }
+    if (typeof value === "string" && value.includes(",")) {
+        const parts = value.split(",").map((s) => s.trim());
+        if (parts.length >= 2)
+            return [parts[0], parts[1]];
+    }
+    return null;
+}
+function applyOperator(wrapper, operator, column, value) {
+    switch (operator) {
+        case exports.OperTypeEnum.LIKE:
+            wrapper.like(column, String(value));
+            break;
+        case exports.OperTypeEnum.LIKE_LEFT:
+            wrapper.likeLeft(column, String(value));
+            break;
+        case exports.OperTypeEnum.LIKE_RIGHT:
+            wrapper.likeRight(column, String(value));
+            break;
+        case exports.OperTypeEnum.NOT_LIKE:
+            wrapper.notLike(column, String(value));
+            break;
+        case exports.OperTypeEnum.GT:
+            wrapper.gt(column, value);
+            break;
+        case exports.OperTypeEnum.GE:
+            wrapper.ge(column, value);
+            break;
+        case exports.OperTypeEnum.LT:
+            wrapper.lt(column, value);
+            break;
+        case exports.OperTypeEnum.LE:
+            wrapper.le(column, value);
+            break;
+        case exports.OperTypeEnum.NE:
+            wrapper.ne(column, value);
+            break;
+        case exports.OperTypeEnum.IN:
+            wrapper.in(column, toArray(value));
+            break;
+        case exports.OperTypeEnum.NOT_IN:
+            wrapper.notIn(column, toArray(value));
+            break;
+        case exports.OperTypeEnum.BETWEEN: {
+            const pair = toBetweenPair(value);
+            if (!pair) {
+                throw new Error(`@TableSearch BETWEEN 需要 [start, end] 或 "start,end"，字段列: ${column}`);
+            }
+            wrapper.between(column, pair[0], pair[1]);
+            break;
+        }
+        case exports.OperTypeEnum.NOT_BETWEEN: {
+            const pair = toBetweenPair(value);
+            if (!pair) {
+                throw new Error(`@TableSearch NOT_BETWEEN 需要 [start, end] 或 "start,end"，字段列: ${column}`);
+            }
+            wrapper.notBetween(column, pair[0], pair[1]);
+            break;
+        }
+        case exports.OperTypeEnum.IS_NULL:
+            wrapper.isNull(column);
+            break;
+        case exports.OperTypeEnum.IS_NOT_NULL:
+            wrapper.isNotNull(column);
+            break;
+        case exports.OperTypeEnum.EQ:
+        default:
+            wrapper.eq(column, value);
+            break;
+    }
+}
+function buildFromForm(form, formClass, wrapper) {
+    if (form == null || typeof form !== "object")
+        return;
+    const data = form;
+    for (const meta of getTableSearchMeta(formClass)) {
+        const value = data[meta.property];
+        // IS_NULL / IS_NOT_NULL 不依赖表单值；其它运算符空值跳过
+        if (meta.operator !== exports.OperTypeEnum.IS_NULL &&
+            meta.operator !== exports.OperTypeEnum.IS_NOT_NULL &&
+            isEmptyValue(value)) {
+            continue;
+        }
+        applyOperator(wrapper, meta.operator, meta.column, value);
+    }
+}
+/**
+ * 根据表单 + DTO 类上的 @TableSearch 构建 QueryWrapper。
+ * JSON body 无原型信息，故第二参数必须传类（如 UserPageDTO）。
+ */
+function getQueryWrapper(form, formClass, consumer) {
+    const wrapper = new QueryWrapper_1.QueryWrapper();
+    buildFromForm(form, formClass, wrapper);
+    consumer?.(wrapper);
+    return wrapper;
+}
+/**
+ * 构建 QueryWrapper + 分页参数。
+ *
+ * @example
+ * getQueryWrapperAndPage(form, UserPageDTO)
+ * getQueryWrapperAndPage(form, UserPageDTO, pageNum, pageSize)
+ * getQueryWrapperAndPage(form, UserPageDTO, pageNum, pageSize, (w) => w.orderByDesc('create_time'))
+ * getQueryWrapperAndPage(form, UserPageDTO, (w) => w.orderByDesc('id'))
+ */
+function getQueryWrapperAndPage(form, formClass, currentOrConsumer, size, consumer) {
+    let current = 1;
+    let pageSize = 10;
+    let fn;
+    if (typeof currentOrConsumer === "function") {
+        fn = currentOrConsumer;
+    }
+    else {
+        if (currentOrConsumer != null) {
+            const n = Number(currentOrConsumer);
+            current = Number.isFinite(n) && n > 0 ? n : 1;
+        }
+        if (size != null) {
+            const n = Number(size);
+            pageSize = Number.isFinite(n) && n > 0 ? n : 10;
+        }
+        fn = consumer;
+    }
+    return {
+        queryWrapper: getQueryWrapper(form, formClass, fn),
+        page: { current, size: pageSize },
+    };
+}
+//# sourceMappingURL=tableSearch.js.map

package/dist/tableSearch.js.map

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

package/dist/transactional.d.ts

@@ -0,0 +1,27 @@
+import type { TransactionPropagation } from "./types";
+export interface TransactionalOptions {
+    /** 事务所属数据源，默认 "default" */
+    datasource?: string;
+    /**
+     * 传播行为（对齐 Spring）：
+     * - `REQUIRED`（默认）：加入外层或新建
+     * - `REQUIRES_NEW`：挂起外层，独立提交/回滚
+     */
+    propagation?: TransactionPropagation;
+}
+/**
+ * 事务装饰器（对齐 Spring @Transactional）。
+ * 可标在类或方法上；方法内同数据源的 Db.queryOn / BaseMapper 走同一连接，抛错则回滚。
+ *
+ * @example
+ * @Transactional()
+ * async transfer() { ... }
+ *
+ * @Transactional({ propagation: "REQUIRES_NEW" })
+ * async auditLog() { ... }
+ *
+ * @Transactional({ datasource: "pg" })
+ * async syncToPg() { ... }
+ */
+export declare function Transactional(options?: TransactionalOptions): MethodDecorator & ClassDecorator;
+//# sourceMappingURL=transactional.d.ts.map

package/dist/transactional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional.d.ts","sourceRoot":"","sources":["../src/transactional.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAMtD,MAAM,WAAW,oBAAoB;IACnC,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,sBAAsB,CAAC;CACtC;AAoBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,eAAe,GAAG,cAAc,CA8BlC"}

package/dist/transactional.js

@@ -0,0 +1,57 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Transactional = Transactional;
+const Db_1 = __importDefault(require("./Db"));
+const TX_WRAPPED = Symbol.for("pangza.orm.transactional.wrapped");
+function wrapTransactional(fn, datasource = "default", propagation = "REQUIRED") {
+    if (fn[TX_WRAPPED])
+        return fn;
+    const ds = (datasource || "default").trim() || "default";
+    const wrapped = async function (...args) {
+        return Db_1.default.transactionOn(ds, async () => fn.apply(this, args), { propagation });
+    };
+    wrapped[TX_WRAPPED] = true;
+    return wrapped;
+}
+/**
+ * 事务装饰器（对齐 Spring @Transactional）。
+ * 可标在类或方法上；方法内同数据源的 Db.queryOn / BaseMapper 走同一连接，抛错则回滚。
+ *
+ * @example
+ * @Transactional()
+ * async transfer() { ... }
+ *
+ * @Transactional({ propagation: "REQUIRES_NEW" })
+ * async auditLog() { ... }
+ *
+ * @Transactional({ datasource: "pg" })
+ * async syncToPg() { ... }
+ */
+function Transactional(options) {
+    const datasource = options?.datasource ?? "default";
+    const propagation = options?.propagation ?? "REQUIRED";
+    return ((target, propertyKey, descriptor) => {
+        if (propertyKey !== undefined && descriptor && typeof descriptor.value === "function") {
+            descriptor.value = wrapTransactional(descriptor.value, datasource, propagation);
+            return descriptor;
+        }
+        const proto = target.prototype;
+        if (!proto)
+            return;
+        for (const key of Object.getOwnPropertyNames(proto)) {
+            if (key === "constructor")
+                continue;
+            const desc = Object.getOwnPropertyDescriptor(proto, key);
+            if (!desc || typeof desc.value !== "function")
+                continue;
+            Object.defineProperty(proto, key, {
+                ...desc,
+                value: wrapTransactional(desc.value, datasource, propagation),
+            });
+        }
+    });
+}
+//# sourceMappingURL=transactional.js.map

package/dist/transactional.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional.js","sourceRoot":"","sources":["../src/transactional.ts"],"names":[],"mappings":";;;;;AAkDA,sCAgCC;AAlFD,8CAAsB;AAGtB,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;AAelE,SAAS,iBAAiB,CACxB,EAAK,EACL,UAAU,GAAG,SAAS,EACtB,cAAsC,UAAU;IAEhD,IAAK,EAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,EAAE,GAAG,CAAC,UAAU,IAAI,SAAS,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;IACzD,MAAM,OAAO,GAAG,KAAK,WAA0B,GAAG,IAAe;QAC/D,OAAO,YAAE,CAAC,aAAa,CACrB,EAAE,EACF,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAChC,EAAE,WAAW,EAAE,CAChB,CAAC;IACJ,CAAC,CAAC;IACD,OAAe,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IACpC,OAAO,OAAuB,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,aAAa,CAC3B,OAA8B;IAE9B,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,SAAS,CAAC;IACpD,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,UAAU,CAAC;IACvD,OAAO,CAAC,CACN,MAAyB,EACzB,WAA6B,EAC7B,UAA+B,EAC/B,EAAE;QACF,IAAI,WAAW,KAAK,SAAS,IAAI,UAAU,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACtF,UAAU,CAAC,KAAK,GAAG,iBAAiB,CAClC,UAAU,CAAC,KAAK,EAChB,UAAU,EACV,WAAW,CACZ,CAAC;YACF,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,MAAM,KAAK,GAAI,MAAiC,CAAC,SAAS,CAAC;QAC3D,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,IAAI,GAAG,KAAK,aAAa;gBAAE,SAAS;YACpC,MAAM,IAAI,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACzD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,UAAU;gBAAE,SAAS;YACxD,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE;gBAChC,GAAG,IAAI;gBACP,KAAK,EAAE,iBAAiB,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,CAAC;aAC9D,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAqC,CAAC;AACzC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,155 @@
+/** 兼容：单库 MySQL 连接配置（也可用作 DataSourceConfig） */
+export interface MysqlConfig {
+    host?: string;
+    port?: number;
+    user?: string;
+    password?: string;
+    database?: string;
+    connectionLimit?: number;
+}
+/** BaseMapper 表级配置（可覆盖全局 YAML / configureOrm） */
+export interface MapperOptions {
+    /** 表名 */
+    table: string;
+    /** 主键，默认 id */
+    idField?: string;
+    /**
+     * 数据源名称（Db.register 的名字），默认 "default"。
+     * 多库 / 多数据源时在此指定。
+     */
+    datasource?: string;
+    /** 是否开启逻辑删除 */
+    logicDelete?: boolean;
+    /** 逻辑删除字段名 */
+    logicDeleteField?: string;
+    /** 已删除值 */
+    logicDeleteValue?: unknown;
+    /** 未删除值 */
+    logicNotDeleteValue?: unknown;
+    /** 是否开启乐观锁 */
+    optimisticLock?: boolean;
+    /** 版本号字段名 */
+    versionField?: string;
+    /** 是否自动填充 create/update 字段，默认 true */
+    fill?: boolean;
+    /**
+     * 更新时对 `null` 的策略（`undefined` 始终跳过）：
+     * - `INCLUDE`（默认）：写入 NULL
+     * - `IGNORE`：跳过 null，不更新该列
+     */
+    updateNullStrategy?: "INCLUDE" | "IGNORE";
+    /**
+     * 实体类（带 @TableName / @TableId / @TableField）。
+     * 用于读取表字段填充策略 insertFill / updateFill。
+     */
+    entity?: Function;
+}
+/** 表级配置（不含 table） */
+export type MapperTableOptions = Omit<MapperOptions, "table">;
+/** 解析后的全局 ORM 配置 */
+export interface ResolvedOrmConfig {
+    logicDelete: boolean;
+    logicDeleteField: string;
+    logicDeleteValue: unknown;
+    logicNotDeleteValue: unknown;
+    optimisticLock: boolean;
+    versionField: string;
+    /**
+     * 全局主键策略（@TableId type 为 NONE 时使用）。
+     * 默认 ASSIGN_ID（雪花字符串）。
+     */
+    idType?: string;
+    /**
+     * 查询结果下划线列名转驼峰（对齐 MyBatis mapUnderscoreToCamelCase）。
+     * 默认 true。
+     */
+    mapUnderscoreToCamelCase?: boolean;
+    fillCreateTime?: string;
+    fillUpdateTime?: string;
+    fillCreateBy?: string;
+    fillUpdateBy?: string;
+    /** 是否打印 SQL 日志，默认 false */
+    sqlLog?: boolean;
+    /**
+     * SQL 日志格式：
+     * - 字符串模板，占位符 {time} {type} {sql} {params} {cost}
+     * - 或自定义函数 (info) => string
+     * 默认：`{time} [{type}] {cost}ms | {sql} | params={params}`
+     */
+    sqlLogFormat?: string | SqlLogFormatFn;
+    /** 控制输出片段开关 */
+    sqlLogParts?: SqlLogParts;
+    /** SQL 日志级别，默认 info */
+    sqlLogLevel?: "trace" | "debug" | "info" | "warn";
+    /** saveBatch 每批行数，默认 200 */
+    batchInsertSize?: number;
+    /** updateBatch 每批实体数，默认 200 */
+    batchUpdateSize?: number;
+    /** 大 IN 分批（QueryWrapper.in / deleteByIds 等），默认 500 */
+    batchInSize?: number;
+    /** XML 扫描路径（相对项目根或绝对路径），如 mappers/**\/*.xml；空数组表示不启用 */
+    mapperLocations?: string[];
+    /** 开发态改 XML 热加载，默认 false */
+    mapperReload?: boolean;
+}
+/** @Transactional 传播行为（对齐 Spring） */
+export type TransactionPropagation = "REQUIRED" | "REQUIRES_NEW";
+/** SQL 日志各片段开关（时间 / 类型 / 语句 / 参数 / 耗时） */
+export interface SqlLogParts {
+    time?: boolean;
+    type?: boolean;
+    sql?: boolean;
+    params?: boolean;
+    cost?: boolean;
+}
+/** 单次 SQL 日志上下文 */
+export interface SqlLogInfo {
+    time: string;
+    type: string;
+    sql: string;
+    params: unknown[];
+    paramsText: string;
+    cost: number;
+    error?: boolean;
+}
+export type SqlLogFormatFn = (info: SqlLogInfo) => string;
+/** 插入 / 更新拦截器（对齐 MyBatis-Plus MetaObjectHandler） */
+export interface MetaObjectHandler {
+    insert?(entity: Record<string, any>): void | Promise<void>;
+    update?(entity: Record<string, any>): void | Promise<void>;
+}
+/** 分页查询（MyBatis-Plus Page 风格） */
+export interface PageQuery {
+    current?: number;
+    size?: number;
+}
+/**
+ * 查询时关联 / 字段 @Select 填充选项。
+ * - `relations` 省略：仅 eager
+ * - `false`：不填充关联与字段 @Select
+ * - `string[]`：只填充列出的属性（含 lazy 关联）
+ */
+export interface SelectQueryOptions {
+    limit?: number;
+    relations?: boolean | string[];
+}
+/** 分页结果 */
+export interface IPage<T> {
+    records: T[];
+    total: number;
+    current: number;
+    size: number;
+}
+/** QueryWrapper SQL 片段 */
+export interface SqlFragment {
+    selectSql: string;
+    whereSql: string;
+    /** `GROUP BY ...`，无则空串 */
+    groupSql: string;
+    /** `HAVING ...`，无则空串；参数已并入 params（接在 WHERE 之后） */
+    havingSql: string;
+    orderSql: string;
+    lastSql: string;
+    params: unknown[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/xml/MapperXml.d.ts

@@ -0,0 +1,24 @@
+import "reflect-metadata";
+export interface MapperXmlOptions {
+    /** 默认数据源，可被语句 datasource 覆盖 */
+    datasource?: string;
+}
+/**
+ * 将类方法绑定到 XML namespace（方法名 = 语句 id）。
+ *
+ * @example
+ * @MapperXml("com.pangza.UserMapper")
+ * class UserMapper {
+ *   findByRole(@Param("roleId") roleId: number): Promise<any[]> {
+ *     throw new Error("bound by XML");
+ *   }
+ * }
+ */
+export declare function MapperXml(namespace: string, options?: MapperXmlOptions): ClassDecorator;
+export declare function getMapperXmlNamespace(ctor: Function): string | undefined;
+/** 标记方法已由 @Select 等绑定，供 MapperXml 冲突检测 */
+export declare function markSqlMethodBound(fn: Function, kind?: string): void;
+export declare function isSqlMethodBound(fn: Function): boolean;
+/** 启动时加载 XML（若配置了 mapperLocations） */
+export declare function bootstrapXmlMappers(): void;
+//# sourceMappingURL=MapperXml.d.ts.map

package/dist/xml/MapperXml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapperXml.d.ts","sourceRoot":"","sources":["../../src/xml/MapperXml.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAU1B,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAqDD;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,gBAAgB,GACzB,cAAc,CAoBhB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAExE;AAED,0CAA0C;AAC1C,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,SAAe,GAAG,IAAI,CAE1E;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAEtD;AAED,sCAAsC;AACtC,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}