@pangza/orm 0.0.0-stage → 1.0.1

package/dist/dialect.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqlServerDialect = exports.PostgresqlDialect = exports.MysqlDialect = void 0;
+exports.getDialect = getDialect;
+function replaceQuestionMarks(sql, to) {
+    let i = 0;
+    return sql.replace(/\?/g, () => to(++i));
+}
+exports.MysqlDialect = {
+    type: "mysql",
+    quoteIdent(name) {
+        return `\`${name}\``;
+    },
+    convertPlaceholders(sql) {
+        return sql;
+    },
+    likeEscapeClause() {
+        return " ESCAPE '\\\\'";
+    },
+    appendLimitOffset(sql, limit, offset = 0) {
+        if (offset > 0)
+            return `${sql} LIMIT ${limit} OFFSET ${offset}`;
+        return `${sql} LIMIT ${limit}`;
+    },
+    listColumnsSql(table) {
+        return {
+            sql: `SHOW COLUMNS FROM ${this.quoteIdent(table)}`,
+            params: [],
+        };
+    },
+    parseColumnNames(rows) {
+        return rows.map((r) => String(r.Field ?? r.field ?? ""));
+    },
+    prepareInsert(sql) {
+        return { sql, returning: false };
+    },
+    extractInsertId(result) {
+        const header = result;
+        return Number(header?.insertId ?? 0);
+    },
+    extractAffectedRows(result) {
+        const header = result;
+        return Number(header?.affectedRows ?? 0);
+    },
+};
+exports.PostgresqlDialect = {
+    type: "postgresql",
+    quoteIdent(name) {
+        return `"${name}"`;
+    },
+    convertPlaceholders(sql) {
+        return replaceQuestionMarks(sql, (i) => `$${i}`);
+    },
+    likeEscapeClause() {
+        return " ESCAPE '\\'";
+    },
+    appendLimitOffset(sql, limit, offset = 0) {
+        if (offset > 0)
+            return `${sql} LIMIT ${limit} OFFSET ${offset}`;
+        return `${sql} LIMIT ${limit}`;
+    },
+    listColumnsSql(table) {
+        return {
+            sql: `SELECT column_name AS "Field" FROM information_schema.columns WHERE table_schema = current_schema() AND table_name = ?`,
+            params: [table],
+        };
+    },
+    parseColumnNames(rows) {
+        return rows.map((r) => String(r.Field ?? r.field ?? r.column_name ?? ""));
+    },
+    prepareInsert(sql, idColumn) {
+        return {
+            sql: `${sql} RETURNING ${this.quoteIdent(idColumn)}`,
+            returning: true,
+        };
+    },
+    extractInsertId(result, idColumn, returning) {
+        if (returning && Array.isArray(result) && result[0]) {
+            const row = result[0];
+            return Number(row[idColumn] ?? 0);
+        }
+        return 0;
+    },
+    extractAffectedRows(result) {
+        if (Array.isArray(result))
+            return result.length;
+        const header = result;
+        return Number(header?.rowCount ?? header?.affectedRows ?? 0);
+    },
+};
+exports.SqlServerDialect = {
+    type: "sqlserver",
+    quoteIdent(name) {
+        return `[${name}]`;
+    },
+    convertPlaceholders(sql) {
+        // node-mssql 对 ? 支持不稳定，统一转 @p1,@p2
+        return replaceQuestionMarks(sql, (i) => `@p${i}`);
+    },
+    likeEscapeClause() {
+        return " ESCAPE '\\'";
+    },
+    appendLimitOffset(sql, limit, offset = 0, hasOrderBy = false) {
+        const order = hasOrderBy ? "" : " ORDER BY (SELECT NULL)";
+        return `${sql}${order} OFFSET ${offset} ROWS FETCH NEXT ${limit} ROWS ONLY`;
+    },
+    listColumnsSql(table) {
+        return {
+            sql: `SELECT COLUMN_NAME AS [Field] FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_NAME = ?`,
+            params: [table],
+        };
+    },
+    parseColumnNames(rows) {
+        return rows.map((r) => String(r.Field ?? r.field ?? r.COLUMN_NAME ?? ""));
+    },
+    prepareInsert(sql, idColumn) {
+        // INSERT INTO t (a) VALUES (@p1) → INSERT INTO t (a) OUTPUT INSERTED.[id] VALUES (@p1)
+        const upper = sql.toUpperCase();
+        const valuesIdx = upper.lastIndexOf(" VALUES");
+        if (valuesIdx < 0) {
+            return { sql, returning: false };
+        }
+        const head = sql.slice(0, valuesIdx);
+        const tail = sql.slice(valuesIdx);
+        return {
+            sql: `${head} OUTPUT INSERTED.${this.quoteIdent(idColumn)}${tail}`,
+            returning: true,
+        };
+    },
+    extractInsertId(result, idColumn, returning) {
+        if (returning && Array.isArray(result) && result[0]) {
+            const row = result[0];
+            return Number(row[idColumn] ?? 0);
+        }
+        return 0;
+    },
+    extractAffectedRows(result) {
+        if (Array.isArray(result))
+            return result.length;
+        const header = result;
+        if (Array.isArray(header?.rowsAffected)) {
+            return Number(header.rowsAffected[0] ?? 0);
+        }
+        return Number(header?.affectedRows ?? 0);
+    },
+};
+const DIALECTS = {
+    mysql: exports.MysqlDialect,
+    postgresql: exports.PostgresqlDialect,
+    sqlserver: exports.SqlServerDialect,
+};
+function getDialect(type = "mysql") {
+    const key = String(type || "mysql").toLowerCase();
+    const map = {
+        mysql: "mysql",
+        mariadb: "mysql",
+        postgres: "postgresql",
+        postgresql: "postgresql",
+        pg: "postgresql",
+        mssql: "sqlserver",
+        sqlserver: "sqlserver",
+        "sql-server": "sqlserver",
+    };
+    const resolved = map[key] ?? key;
+    const dialect = DIALECTS[resolved];
+    if (!dialect) {
+        throw new Error(`不支持的数据库类型: ${type}`);
+    }
+    return dialect;
+}
+//# sourceMappingURL=dialect.js.map

package/dist/dialect.js.map

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

package/dist/enable.d.ts

@@ -0,0 +1,12 @@
+import type { NextFunction, Request, Response } from "express";
+import type { DataSourceConfig } from "./DataSource";
+/**
+ * 显式启用 ORM / 默认数据源：预热仅在 registry 后执行。
+ * 未 registry 时启动阶段不会连库；业务首次查询仍可懒连接。
+ *
+ * @example
+ * Application.registry(EnableOrm()).start();
+ * Application.registry(EnableOrm({ host: "127.0.0.1", database: "app" })).start();
+ */
+export declare function EnableOrm(config?: DataSourceConfig): (_req: Request, _res: Response, next: NextFunction) => void;
+//# sourceMappingURL=enable.d.ts.map

package/dist/enable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enable.d.ts","sourceRoot":"","sources":["../src/enable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,gBAAgB,UAMvB,OAAO,QAAQ,QAAQ,QAAQ,YAAY,UAUtE"}

package/dist/enable.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnableOrm = EnableOrm;
+const Db_1 = __importDefault(require("./Db"));
+const flag_1 = require("./flag");
+/**
+ * 显式启用 ORM / 默认数据源：预热仅在 registry 后执行。
+ * 未 registry 时启动阶段不会连库；业务首次查询仍可懒连接。
+ *
+ * @example
+ * Application.registry(EnableOrm()).start();
+ * Application.registry(EnableOrm({ host: "127.0.0.1", database: "app" })).start();
+ */
+function EnableOrm(config) {
+    (0, flag_1.markOrmEnabled)(true);
+    if (config) {
+        Db_1.default.register("default", config);
+    }
+    const middleware = (_req, _res, next) => {
+        next();
+    };
+    Object.defineProperty(middleware, flag_1.ORM_MODULE_FLAG, {
+        value: true,
+        enumerable: false,
+    });
+    return middleware;
+}
+//# sourceMappingURL=enable.js.map

package/dist/enable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enable.js","sourceRoot":"","sources":["../src/enable.ts"],"names":[],"mappings":";;;;;AAaA,8BAgBC;AA5BD,8CAAsB;AAEtB,iCAAyD;AAEzD;;;;;;;GAOG;AACH,SAAgB,SAAS,CAAC,MAAyB;IACjD,IAAA,qBAAc,EAAC,IAAI,CAAC,CAAC;IACrB,IAAI,MAAM,EAAE,CAAC;QACX,YAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,IAAa,EAAE,IAAc,EAAE,IAAkB,EAAE,EAAE;QACvE,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;IAEF,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,sBAAe,EAAE;QACjD,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,KAAK;KAClB,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/entityDecorators.d.ts

@@ -0,0 +1,77 @@
+import "reflect-metadata";
+import { IdType, type IdTypeValue } from "./IdType";
+/** insertFill / updateFill：直接值，或同步/异步函数 */
+export type FieldFillValue = unknown | (() => unknown) | (() => Promise<unknown>);
+export interface TableIdOptions {
+    /** 数据库列名，默认用属性名 */
+    value?: string;
+    /**
+     * 主键策略，默认 IdType.NONE（跟随全局 ORM_ID_TYPE / configureOrm）。
+     * @see IdType
+     */
+    type?: IdTypeValue;
+}
+export interface TableFieldOptions {
+    /** 数据库列名，默认用属性名 */
+    value?: string;
+    /** false 表示非表字段，不参与默认 SQL 映射 */
+    exist?: boolean;
+    /**
+     * 插入时默认填充：常量或函数。
+     * 仅当实体上该列仍为 undefined 时写入。
+     */
+    insertFill?: FieldFillValue;
+    /**
+     * 更新时默认填充：常量或函数。
+     * 仅当实体上该列仍为 undefined 时写入。
+     */
+    updateFill?: FieldFillValue;
+}
+export interface EntityFieldMeta {
+    /** 实体属性名 */
+    property: string;
+    /** 数据库列名 */
+    column: string;
+    /** 是否主键 */
+    id?: boolean;
+    /** 主键策略（仅 id 字段有意义） */
+    idType?: IdType;
+    exist: boolean;
+    insertFill?: FieldFillValue;
+    updateFill?: FieldFillValue;
+}
+export interface EntityTableMeta {
+    tableName: string;
+    idColumn: string;
+    fields: EntityFieldMeta[];
+}
+type Ctor = Function;
+/**
+ * @TableName("user")
+ * 标记实体对应表名。
+ */
+export declare function TableName(tableName: string): ClassDecorator;
+/**
+ * @TableId() / @TableId("user_id") / @TableId({ value: "user_id", type: IdType.ASSIGN_ID })
+ * 标记主键字段及生成策略。
+ */
+export declare function TableId(valueOrOptions?: string | TableIdOptions): PropertyDecorator;
+/** 读取实体主键字段元数据（含 IdType） */
+export declare function getEntityIdField(entity: Ctor): EntityFieldMeta | undefined;
+/**
+ * @TableField("nick_name")
+ * @TableField({ value: "create_time", insertFill: () => new Date() })
+ */
+export declare function TableField(valueOrOptions?: string | TableFieldOptions): PropertyDecorator;
+export declare function getTableName(entity: Ctor): string | undefined;
+export declare function getEntityFields(entity: Ctor): EntityFieldMeta[];
+export declare function getEntityTableMeta(entity: Ctor): EntityTableMeta | undefined;
+export declare function resolveFieldFill(fill: FieldFillValue | undefined): Promise<unknown>;
+/**
+ * 按实体 @TableField 的 insertFill / updateFill 填充。
+ * 写入列名（column）；属性名与列名不同时同步写属性名，便于对象读写。
+ * 仅当目标键仍为 undefined 时填充。
+ */
+export declare function applyEntityFieldFills(entityClass: Ctor | undefined, row: Record<string, any>, mode: "insert" | "update"): Promise<void>;
+export {};
+//# sourceMappingURL=entityDecorators.d.ts.map

package/dist/entityDecorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entityDecorators.d.ts","sourceRoot":"","sources":["../src/entityDecorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,MAAM,EAAiB,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAEnE,2CAA2C;AAC3C,MAAM,MAAM,cAAc,GACtB,OAAO,GACP,CAAC,MAAM,OAAO,CAAC,GACf,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;AAE7B,MAAM,WAAW,cAAc;IAC7B,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B;;;OAGG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAKD,KAAK,IAAI,GAAG,QAAQ,CAAC;AAgBrB;;;GAGG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAM3D;AAED;;;GAGG;AACH,wBAAgB,OAAO,CACrB,cAAc,CAAC,EAAE,MAAM,GAAG,cAAc,GACvC,iBAAiB,CAsBnB;AAED,4BAA4B;AAC5B,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,IAAI,GAAG,eAAe,GAAG,SAAS,CAE1E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,cAAc,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAC1C,iBAAiB,CAqBnB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAE7D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,IAAI,GAAG,eAAe,EAAE,CAE/D;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,GAAG,eAAe,GAAG,SAAS,CAU5E;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,cAAc,GAAG,SAAS,GAC/B,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,IAAI,GAAG,SAAS,EAC7B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GACxB,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/entityDecorators.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TableName = TableName;
+exports.TableId = TableId;
+exports.getEntityIdField = getEntityIdField;
+exports.TableField = TableField;
+exports.getTableName = getTableName;
+exports.getEntityFields = getEntityFields;
+exports.getEntityTableMeta = getEntityTableMeta;
+exports.resolveFieldFill = resolveFieldFill;
+exports.applyEntityFieldFills = applyEntityFieldFills;
+require("reflect-metadata");
+const beanKeys_1 = require("@pangza/core/Json/beanKeys");
+const IdType_1 = require("./IdType");
+const TABLE_NAME_KEY = Symbol.for("pangza.orm.tableName");
+const FIELDS_KEY = Symbol.for("pangza.orm.entityFields");
+function fieldMap(ctor) {
+    return (Reflect.getOwnMetadata(FIELDS_KEY, ctor) ?? {});
+}
+function saveField(ctor, meta) {
+    const map = { ...fieldMap(ctor), [meta.property]: meta };
+    Reflect.defineMetadata(FIELDS_KEY, map, ctor);
+    (0, beanKeys_1.addBeanKey)(ctor, meta.property);
+}
+/**
+ * @TableName("user")
+ * 标记实体对应表名。
+ */
+function TableName(tableName) {
+    return (ctor) => {
+        const name = String(tableName).trim();
+        if (!name)
+            throw new Error("@TableName 不能为空");
+        Reflect.defineMetadata(TABLE_NAME_KEY, name, ctor);
+    };
+}
+/**
+ * @TableId() / @TableId("user_id") / @TableId({ value: "user_id", type: IdType.ASSIGN_ID })
+ * 标记主键字段及生成策略。
+ */
+function TableId(valueOrOptions) {
+    return (target, propertyKey) => {
+        const property = String(propertyKey);
+        let column = property;
+        let idType = IdType_1.IdType.NONE;
+        if (typeof valueOrOptions === "string") {
+            column = valueOrOptions || property;
+        }
+        else if (valueOrOptions) {
+            if (valueOrOptions.value)
+                column = valueOrOptions.value;
+            if (valueOrOptions.type != null) {
+                idType = (0, IdType_1.resolveIdType)(valueOrOptions.type);
+            }
+        }
+        const ctor = target.constructor;
+        saveField(ctor, {
+            property,
+            column,
+            id: true,
+            idType,
+            exist: true,
+        });
+    };
+}
+/** 读取实体主键字段元数据（含 IdType） */
+function getEntityIdField(entity) {
+    return getEntityFields(entity).find((f) => f.id);
+}
+/**
+ * @TableField("nick_name")
+ * @TableField({ value: "create_time", insertFill: () => new Date() })
+ */
+function TableField(valueOrOptions) {
+    return (target, propertyKey) => {
+        const property = String(propertyKey);
+        let options = {};
+        if (typeof valueOrOptions === "string") {
+            options = { value: valueOrOptions };
+        }
+        else if (valueOrOptions) {
+            options = valueOrOptions;
+        }
+        const ctor = target.constructor;
+        const prev = fieldMap(ctor)[property];
+        saveField(ctor, {
+            property,
+            column: options.value || property,
+            id: prev?.id,
+            idType: prev?.idType,
+            exist: options.exist !== false,
+            insertFill: options.insertFill,
+            updateFill: options.updateFill,
+        });
+    };
+}
+function getTableName(entity) {
+    return Reflect.getOwnMetadata(TABLE_NAME_KEY, entity);
+}
+function getEntityFields(entity) {
+    return Object.values(fieldMap(entity));
+}
+function getEntityTableMeta(entity) {
+    const tableName = getTableName(entity);
+    if (!tableName)
+        return undefined;
+    const fields = getEntityFields(entity);
+    const idField = fields.find((f) => f.id);
+    return {
+        tableName,
+        idColumn: idField?.column ?? "id",
+        fields,
+    };
+}
+async function resolveFieldFill(fill) {
+    if (fill === undefined)
+        return undefined;
+    if (typeof fill === "function") {
+        return await fill();
+    }
+    return fill;
+}
+/**
+ * 按实体 @TableField 的 insertFill / updateFill 填充。
+ * 写入列名（column）；属性名与列名不同时同步写属性名，便于对象读写。
+ * 仅当目标键仍为 undefined 时填充。
+ */
+async function applyEntityFieldFills(entityClass, row, mode) {
+    if (!entityClass)
+        return;
+    const fields = getEntityFields(entityClass);
+    for (const field of fields) {
+        if (!field.exist)
+            continue;
+        const fill = mode === "insert" ? field.insertFill : field.updateFill;
+        if (fill === undefined)
+            continue;
+        const colKey = field.column;
+        const propKey = field.property;
+        const current = row[colKey] !== undefined ? row[colKey] : row[propKey];
+        if (current !== undefined)
+            continue;
+        const value = await resolveFieldFill(fill);
+        if (value === undefined || value === null)
+            continue;
+        // 只写列名，避免 camelCase 属性名被当成 SQL 列
+        row[colKey] = value;
+    }
+}
+//# sourceMappingURL=entityDecorators.js.map

package/dist/entityDecorators.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,11 @@
+import { ResponseCode } from "@pangza/core/types/enums";
+/** ORM 业务错误，携带响应码 */
+export declare class OrmError extends Error {
+    readonly code: ResponseCode;
+    constructor(message: string, code?: ResponseCode);
+}
+/** 乐观锁版本不匹配 */
+export declare class OptimisticLockError extends OrmError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,qBAAqB;AACrB,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiC;CAKrE;AAED,eAAe;AACf,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,SAAkB;CAItC"}

package/dist/errors.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OptimisticLockError = exports.OrmError = void 0;
+const enums_1 = require("@pangza/core/types/enums");
+/** ORM 业务错误，携带响应码 */
+class OrmError extends Error {
+    constructor(message, code = enums_1.ResponseCode.ERROR) {
+        super(message);
+        this.name = "OrmError";
+        this.code = code;
+    }
+}
+exports.OrmError = OrmError;
+/** 乐观锁版本不匹配 */
+class OptimisticLockError extends OrmError {
+    constructor(message = "数据已被修改，请刷新后重试") {
+        super(message, enums_1.ResponseCode.CONFLICT);
+        this.name = "OptimisticLockError";
+    }
+}
+exports.OptimisticLockError = OptimisticLockError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAA,oDAAwD;AAExD,qBAAqB;AACrB,MAAa,QAAS,SAAQ,KAAK;IAGjC,YAAY,OAAe,EAAE,OAAqB,oBAAY,CAAC,KAAK;QAClE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AARD,4BAQC;AAED,eAAe;AACf,MAAa,mBAAoB,SAAQ,QAAQ;IAC/C,YAAY,OAAO,GAAG,eAAe;QACnC,KAAK,CAAC,OAAO,EAAE,oBAAY,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC"}

package/dist/fieldSelect.d.ts

@@ -0,0 +1,49 @@
+import "reflect-metadata";
+/** 字段级 @Select 选项（对齐 MyBatis association / collection） */
+export interface FieldSelectOptions {
+    /**
+     * true → 结果为数组（collection，如 children）
+     * false → 单条/单值（association，如 roleName）
+     * 默认 false
+     */
+    many?: boolean;
+    /**
+     * 取结果中某一列作为值；
+     * many=true 时得到标量数组；many=false 时得到单个标量。
+     * 不传则 many 时为行对象数组，否则为第一行对象。
+     */
+    column?: string;
+    /**
+     * 对嵌套查出的行是否继续填充其 @Select（同实体递归）。
+     * 默认 0：不再递归；设为 1+ 可做有限层树。
+     */
+    depth?: number;
+    /**
+     * 是否在 selectList / selectPage 上自动填充。
+     * 默认 true。形如 `列 = #{字段}` 的 SQL 会合并成一条 IN；
+     * 含子查询或 LIMIT 的仍逐行查。树形全表加载建议 eager:false，再手动 hydrate。
+     */
+    eager?: boolean;
+    /** 数据源名称；不传则跟随 hydrate / Mapper 的 datasource */
+    datasource?: string;
+    /** 按数据库类型查找数据源（同类型多源时须用 datasource） */
+    db?: string;
+}
+export interface FieldSelectMeta {
+    property: string;
+    sql: string;
+    many: boolean;
+    column?: string;
+    depth: number;
+    eager: boolean;
+    datasource?: string;
+    db?: string;
+}
+type Ctor = Function;
+/** 注册属性级 @Select */
+export declare function registerFieldSelect(ctor: Ctor, property: string, sql: string, options?: FieldSelectOptions): void;
+/** 读取实体上全部字段级 @Select */
+export declare function getFieldSelects(ctor: Ctor): FieldSelectMeta[];
+export declare function getFieldSelect(ctor: Ctor, property: string): FieldSelectMeta | undefined;
+export {};
+//# sourceMappingURL=fieldSelect.d.ts.map

package/dist/fieldSelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldSelect.d.ts","sourceRoot":"","sources":["../src/fieldSelect.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAG1B,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAID,KAAK,IAAI,GAAG,QAAQ,CAAC;AAUrB,oBAAoB;AACpB,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,kBAAuB,GAC/B,IAAI,CAkCN;AAED,yBAAyB;AACzB,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,eAAe,EAAE,CAE7D;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,GACf,eAAe,GAAG,SAAS,CAE7B"}

package/dist/fieldSelect.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerFieldSelect = registerFieldSelect;
+exports.getFieldSelects = getFieldSelects;
+exports.getFieldSelect = getFieldSelect;
+require("reflect-metadata");
+const beanKeys_1 = require("@pangza/core/Json/beanKeys");
+const FIELD_SELECT_KEY = Symbol.for("pangza.orm.fieldSelect");
+function fieldSelectMap(ctor) {
+    return (Reflect.getOwnMetadata(FIELD_SELECT_KEY, ctor) ?? {});
+}
+/** 注册属性级 @Select */
+function registerFieldSelect(ctor, property, sql, options = {}) {
+    const template = String(sql).trim();
+    if (!template) {
+        throw new Error("@Select 字段 SQL 不能为空");
+    }
+    // 延迟检查关联，避免 relation ↔ fieldSelect 循环依赖在加载期炸
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const { getRelation } = require("./relation");
+        if (getRelation(ctor, property)) {
+            throw new Error(`字段 @Select(${property}) 与关联装饰器不能同时用于同一属性`);
+        }
+    }
+    catch (err) {
+        if (err instanceof Error && /不能同时/.test(err.message))
+            throw err;
+    }
+    (0, beanKeys_1.addBeanKey)(ctor, property);
+    const map = {
+        ...fieldSelectMap(ctor),
+        [property]: {
+            property,
+            sql: template,
+            many: options.many === true,
+            column: options.column?.trim() || undefined,
+            depth: Math.max(0, options.depth ?? 0),
+            eager: options.eager !== false,
+            datasource: options.datasource?.trim() || undefined,
+            db: options.db?.trim() || undefined,
+        },
+    };
+    Reflect.defineMetadata(FIELD_SELECT_KEY, map, ctor);
+}
+/** 读取实体上全部字段级 @Select */
+function getFieldSelects(ctor) {
+    return Object.values(fieldSelectMap(ctor));
+}
+function getFieldSelect(ctor, property) {
+    return fieldSelectMap(ctor)[property];
+}
+//# sourceMappingURL=fieldSelect.js.map

package/dist/fieldSelect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldSelect.js","sourceRoot":"","sources":["../src/fieldSelect.ts"],"names":[],"mappings":";;AA0DA,kDAuCC;AAGD,0CAEC;AAED,wCAKC;AA7GD,4BAA0B;AAC1B,yDAAwD;AA4CxD,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAI9D,SAAS,cAAc,CAAC,IAAU;IAChC,OAAO,CACJ,OAAO,CAAC,cAAc,CAAC,gBAAgB,EAAE,IAAI,CAEhC,IAAI,EAAE,CACrB,CAAC;AACJ,CAAC;AAED,oBAAoB;AACpB,SAAgB,mBAAmB,CACjC,IAAU,EACV,QAAgB,EAChB,GAAW,EACX,UAA8B,EAAE;IAEhC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;IACD,6CAA6C;IAC7C,IAAI,CAAC;QACH,8DAA8D;QAC9D,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,YAAY,CAE3C,CAAC;QACF,IAAI,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,cAAc,QAAQ,oBAAoB,CAC3C,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,MAAM,GAAG,CAAC;IAClE,CAAC;IACD,IAAA,qBAAU,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3B,MAAM,GAAG,GAAG;QACV,GAAG,cAAc,CAAC,IAAI,CAAC;QACvB,CAAC,QAAQ,CAAC,EAAE;YACV,QAAQ;YACR,GAAG,EAAE,QAAQ;YACb,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,IAAI;YAC3B,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,SAAS;YAC3C,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;YACtC,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,KAAK;YAC9B,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,SAAS;YACnD,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,SAAS;SACpC;KACF,CAAC;IACF,OAAO,CAAC,cAAc,CAAC,gBAAgB,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,yBAAyB;AACzB,SAAgB,eAAe,CAAC,IAAU;IACxC,OAAO,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,SAAgB,cAAc,CAC5B,IAAU,EACV,QAAgB;IAEhB,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC;AACxC,CAAC"}

package/dist/fill.d.ts

@@ -0,0 +1,8 @@
+import { getOrmConfig } from "./config";
+import type { ResolvedOrmConfig } from "./types";
+/** 插入前默认填充 + 用户拦截 */
+export declare function applyInsertFill(entity: Record<string, any>, cfg: ResolvedOrmConfig, fillEnabled: boolean): Promise<void>;
+/** 更新 / 逻辑删除前默认填充 + 用户拦截 */
+export declare function applyUpdateFill(entity: Record<string, any>, cfg: ResolvedOrmConfig, fillEnabled: boolean): Promise<void>;
+export { getOrmConfig };
+//# sourceMappingURL=fill.d.ts.map

package/dist/fill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill.d.ts","sourceRoot":"","sources":["../src/fill.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,YAAY,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAyBjD,qBAAqB;AACrB,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,GAAG,EAAE,iBAAiB,EACtB,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC,IAAI,CAAC,CASf;AAED,4BAA4B;AAC5B,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,GAAG,EAAE,iBAAiB,EACtB,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}