@pangza/orm 0.0.0-stage → 1.0.0

package/dist/index.js

@@ -0,0 +1,122 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MapperXml = exports.relationToFieldSelect = exports.getRelation = exports.getRelations = exports.ManyToMany = exports.OneToMany = exports.ManyToOne = exports.buildRowParamContext = exports.hydrateRelations = exports.hydrateFieldSelects = exports.getFieldSelect = exports.getFieldSelects = exports.registerFieldSelect = exports.Transactional = exports.MAPPER_ENTITY_KEY = exports.Param = exports.Delete = exports.Update = exports.Insert = exports.Select = exports.OptimisticLockError = exports.OrmError = exports.DEFAULT_SQL_LOG_FORMAT = exports.detectSqlType = exports.renderSqlLog = exports.getSqlLogRuntime = exports.configureSqlLog = exports.getMetaObjectHandler = exports.setMetaObjectHandler = exports.getOrmConfig = exports.configureOrm = exports.assertSafeLastSql = exports.escapeLike = exports.assertSafeUint = exports.getQueryWrapperAndPage = exports.getQueryWrapper = exports.getTableSearchMeta = exports.OperTypeEnum = exports.TableSearch = exports.assertIdent = exports.QueryWrapper = exports.clearTableCache = exports.useTable = exports.table = exports.BaseMapper = exports.markOrmEnabled = exports.isOrmEnabled = exports.ORM_MODULE_FLAG = exports.EnableOrm = exports.Db = void 0;
+exports.DataSource = exports.getDialect = exports.mapResultRows = exports.mapResultRow = exports.defaultIdentifierGenerator = exports.getIdentifierGenerator = exports.setIdentifierGenerator = exports.resolveIdType = exports.IdType = exports.applyEntityFieldFills = exports.getEntityTableMeta = exports.getEntityIdField = exports.getEntityFields = exports.getTableName = exports.TableField = exports.TableId = exports.TableName = exports.buildParamContext = exports.parseMybatisSql = exports.watchXmlMappers = exports.bootstrapXmlMappers = exports.getXmlStatement = exports.evalTest = exports.renderStatementSql = exports.parseMapperXml = exports.ensureXmlMappersLoaded = exports.loadXmlMappers = exports.xmlMapper = void 0;
+const Db_1 = __importDefault(require("./Db"));
+exports.Db = Db_1.default;
+var enable_1 = require("./enable");
+Object.defineProperty(exports, "EnableOrm", { enumerable: true, get: function () { return enable_1.EnableOrm; } });
+var flag_1 = require("./flag");
+Object.defineProperty(exports, "ORM_MODULE_FLAG", { enumerable: true, get: function () { return flag_1.ORM_MODULE_FLAG; } });
+Object.defineProperty(exports, "isOrmEnabled", { enumerable: true, get: function () { return flag_1.isOrmEnabled; } });
+Object.defineProperty(exports, "markOrmEnabled", { enumerable: true, get: function () { return flag_1.markOrmEnabled; } });
+var BaseMapper_1 = require("./BaseMapper");
+Object.defineProperty(exports, "BaseMapper", { enumerable: true, get: function () { return BaseMapper_1.BaseMapper; } });
+var table_1 = require("./table");
+Object.defineProperty(exports, "table", { enumerable: true, get: function () { return table_1.table; } });
+Object.defineProperty(exports, "useTable", { enumerable: true, get: function () { return table_1.useTable; } });
+Object.defineProperty(exports, "clearTableCache", { enumerable: true, get: function () { return table_1.clearTableCache; } });
+var QueryWrapper_1 = require("./QueryWrapper");
+Object.defineProperty(exports, "QueryWrapper", { enumerable: true, get: function () { return QueryWrapper_1.QueryWrapper; } });
+Object.defineProperty(exports, "assertIdent", { enumerable: true, get: function () { return QueryWrapper_1.assertIdent; } });
+var tableSearch_1 = require("./tableSearch");
+Object.defineProperty(exports, "TableSearch", { enumerable: true, get: function () { return tableSearch_1.TableSearch; } });
+Object.defineProperty(exports, "OperTypeEnum", { enumerable: true, get: function () { return tableSearch_1.OperTypeEnum; } });
+Object.defineProperty(exports, "getTableSearchMeta", { enumerable: true, get: function () { return tableSearch_1.getTableSearchMeta; } });
+Object.defineProperty(exports, "getQueryWrapper", { enumerable: true, get: function () { return tableSearch_1.getQueryWrapper; } });
+Object.defineProperty(exports, "getQueryWrapperAndPage", { enumerable: true, get: function () { return tableSearch_1.getQueryWrapperAndPage; } });
+var security_1 = require("./security");
+Object.defineProperty(exports, "assertSafeUint", { enumerable: true, get: function () { return security_1.assertSafeUint; } });
+Object.defineProperty(exports, "escapeLike", { enumerable: true, get: function () { return security_1.escapeLike; } });
+Object.defineProperty(exports, "assertSafeLastSql", { enumerable: true, get: function () { return security_1.assertSafeLastSql; } });
+var config_1 = require("./config");
+Object.defineProperty(exports, "configureOrm", { enumerable: true, get: function () { return config_1.configureOrm; } });
+Object.defineProperty(exports, "getOrmConfig", { enumerable: true, get: function () { return config_1.getOrmConfig; } });
+Object.defineProperty(exports, "setMetaObjectHandler", { enumerable: true, get: function () { return config_1.setMetaObjectHandler; } });
+Object.defineProperty(exports, "getMetaObjectHandler", { enumerable: true, get: function () { return config_1.getMetaObjectHandler; } });
+var sqlLog_1 = require("./sqlLog");
+Object.defineProperty(exports, "configureSqlLog", { enumerable: true, get: function () { return sqlLog_1.configureSqlLog; } });
+Object.defineProperty(exports, "getSqlLogRuntime", { enumerable: true, get: function () { return sqlLog_1.getSqlLogRuntime; } });
+Object.defineProperty(exports, "renderSqlLog", { enumerable: true, get: function () { return sqlLog_1.renderSqlLog; } });
+Object.defineProperty(exports, "detectSqlType", { enumerable: true, get: function () { return sqlLog_1.detectSqlType; } });
+Object.defineProperty(exports, "DEFAULT_SQL_LOG_FORMAT", { enumerable: true, get: function () { return sqlLog_1.DEFAULT_SQL_LOG_FORMAT; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "OrmError", { enumerable: true, get: function () { return errors_1.OrmError; } });
+Object.defineProperty(exports, "OptimisticLockError", { enumerable: true, get: function () { return errors_1.OptimisticLockError; } });
+var sqlDecorators_1 = require("./sqlDecorators");
+Object.defineProperty(exports, "Select", { enumerable: true, get: function () { return sqlDecorators_1.Select; } });
+Object.defineProperty(exports, "Insert", { enumerable: true, get: function () { return sqlDecorators_1.Insert; } });
+Object.defineProperty(exports, "Update", { enumerable: true, get: function () { return sqlDecorators_1.Update; } });
+Object.defineProperty(exports, "Delete", { enumerable: true, get: function () { return sqlDecorators_1.Delete; } });
+Object.defineProperty(exports, "Param", { enumerable: true, get: function () { return sqlDecorators_1.Param; } });
+Object.defineProperty(exports, "MAPPER_ENTITY_KEY", { enumerable: true, get: function () { return sqlDecorators_1.MAPPER_ENTITY_KEY; } });
+var transactional_1 = require("./transactional");
+Object.defineProperty(exports, "Transactional", { enumerable: true, get: function () { return transactional_1.Transactional; } });
+var fieldSelect_1 = require("./fieldSelect");
+Object.defineProperty(exports, "registerFieldSelect", { enumerable: true, get: function () { return fieldSelect_1.registerFieldSelect; } });
+Object.defineProperty(exports, "getFieldSelects", { enumerable: true, get: function () { return fieldSelect_1.getFieldSelects; } });
+Object.defineProperty(exports, "getFieldSelect", { enumerable: true, get: function () { return fieldSelect_1.getFieldSelect; } });
+var hydrate_1 = require("./hydrate");
+Object.defineProperty(exports, "hydrateFieldSelects", { enumerable: true, get: function () { return hydrate_1.hydrateFieldSelects; } });
+Object.defineProperty(exports, "hydrateRelations", { enumerable: true, get: function () { return hydrate_1.hydrateRelations; } });
+Object.defineProperty(exports, "buildRowParamContext", { enumerable: true, get: function () { return hydrate_1.buildRowParamContext; } });
+var relation_1 = require("./relation");
+Object.defineProperty(exports, "ManyToOne", { enumerable: true, get: function () { return relation_1.ManyToOne; } });
+Object.defineProperty(exports, "OneToMany", { enumerable: true, get: function () { return relation_1.OneToMany; } });
+Object.defineProperty(exports, "ManyToMany", { enumerable: true, get: function () { return relation_1.ManyToMany; } });
+Object.defineProperty(exports, "getRelations", { enumerable: true, get: function () { return relation_1.getRelations; } });
+Object.defineProperty(exports, "getRelation", { enumerable: true, get: function () { return relation_1.getRelation; } });
+Object.defineProperty(exports, "relationToFieldSelect", { enumerable: true, get: function () { return relation_1.relationToFieldSelect; } });
+var xml_1 = require("./xml");
+Object.defineProperty(exports, "MapperXml", { enumerable: true, get: function () { return xml_1.MapperXml; } });
+Object.defineProperty(exports, "xmlMapper", { enumerable: true, get: function () { return xml_1.xmlMapper; } });
+Object.defineProperty(exports, "loadXmlMappers", { enumerable: true, get: function () { return xml_1.loadXmlMappers; } });
+Object.defineProperty(exports, "ensureXmlMappersLoaded", { enumerable: true, get: function () { return xml_1.ensureXmlMappersLoaded; } });
+Object.defineProperty(exports, "parseMapperXml", { enumerable: true, get: function () { return xml_1.parseMapperXml; } });
+Object.defineProperty(exports, "renderStatementSql", { enumerable: true, get: function () { return xml_1.renderStatementSql; } });
+Object.defineProperty(exports, "evalTest", { enumerable: true, get: function () { return xml_1.evalTest; } });
+Object.defineProperty(exports, "getXmlStatement", { enumerable: true, get: function () { return xml_1.getXmlStatement; } });
+Object.defineProperty(exports, "bootstrapXmlMappers", { enumerable: true, get: function () { return xml_1.bootstrapXmlMappers; } });
+Object.defineProperty(exports, "watchXmlMappers", { enumerable: true, get: function () { return xml_1.watchXmlMappers; } });
+var sqlTemplate_1 = require("./sqlTemplate");
+Object.defineProperty(exports, "parseMybatisSql", { enumerable: true, get: function () { return sqlTemplate_1.parseMybatisSql; } });
+Object.defineProperty(exports, "buildParamContext", { enumerable: true, get: function () { return sqlTemplate_1.buildParamContext; } });
+var entityDecorators_1 = require("./entityDecorators");
+Object.defineProperty(exports, "TableName", { enumerable: true, get: function () { return entityDecorators_1.TableName; } });
+Object.defineProperty(exports, "TableId", { enumerable: true, get: function () { return entityDecorators_1.TableId; } });
+Object.defineProperty(exports, "TableField", { enumerable: true, get: function () { return entityDecorators_1.TableField; } });
+Object.defineProperty(exports, "getTableName", { enumerable: true, get: function () { return entityDecorators_1.getTableName; } });
+Object.defineProperty(exports, "getEntityFields", { enumerable: true, get: function () { return entityDecorators_1.getEntityFields; } });
+Object.defineProperty(exports, "getEntityIdField", { enumerable: true, get: function () { return entityDecorators_1.getEntityIdField; } });
+Object.defineProperty(exports, "getEntityTableMeta", { enumerable: true, get: function () { return entityDecorators_1.getEntityTableMeta; } });
+Object.defineProperty(exports, "applyEntityFieldFills", { enumerable: true, get: function () { return entityDecorators_1.applyEntityFieldFills; } });
+var IdType_1 = require("./IdType");
+Object.defineProperty(exports, "IdType", { enumerable: true, get: function () { return IdType_1.IdType; } });
+Object.defineProperty(exports, "resolveIdType", { enumerable: true, get: function () { return IdType_1.resolveIdType; } });
+var identifier_1 = require("./identifier");
+Object.defineProperty(exports, "setIdentifierGenerator", { enumerable: true, get: function () { return identifier_1.setIdentifierGenerator; } });
+Object.defineProperty(exports, "getIdentifierGenerator", { enumerable: true, get: function () { return identifier_1.getIdentifierGenerator; } });
+Object.defineProperty(exports, "defaultIdentifierGenerator", { enumerable: true, get: function () { return identifier_1.defaultIdentifierGenerator; } });
+var resultMap_1 = require("./resultMap");
+Object.defineProperty(exports, "mapResultRow", { enumerable: true, get: function () { return resultMap_1.mapResultRow; } });
+Object.defineProperty(exports, "mapResultRows", { enumerable: true, get: function () { return resultMap_1.mapResultRows; } });
+var dialect_1 = require("./dialect");
+Object.defineProperty(exports, "getDialect", { enumerable: true, get: function () { return dialect_1.getDialect; } });
+var DataSource_1 = require("./DataSource");
+Object.defineProperty(exports, "DataSource", { enumerable: true, get: function () { return DataSource_1.DataSource; } });
+// 按 YAML 加载 XML Mapper；开启 mapperReload 时监听变更
+try {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const { bootstrapXmlMappers, watchXmlMappers } = require("./xml");
+    bootstrapXmlMappers();
+    watchXmlMappers();
+}
+catch (err) {
+    console.error("[ORM] XML Mapper 加载失败:", err);
+}
+// 不在 import 时连库：避免启动被 DB 超时拖慢；首次 query 走 DataSource.connect()
+exports.default = Db_1.default;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/relation.d.ts

@@ -0,0 +1,72 @@
+import "reflect-metadata";
+import { type FieldSelectMeta } from "./fieldSelect";
+import type { Dialect } from "./dialect";
+export type RelationKind = "ManyToOne" | "OneToMany" | "ManyToMany";
+export type RelationFetch = "SELECT" | "JOIN";
+export interface RelationBaseOptions {
+    /** selectList / selectPage 时是否自动填充，默认：ManyToOne true，其余 false */
+    eager?: boolean;
+    /** 读策略，首期仅 SELECT；JOIN 后续 */
+    fetch?: RelationFetch;
+    /** 嵌套关联递归层数，默认 0 */
+    depth?: number;
+    datasource?: string;
+    db?: string;
+}
+export interface ManyToOneOptions extends RelationBaseOptions {
+    /** 本表外键列名 */
+    foreignKey: string;
+    /** 目标表主键列，默认 id */
+    targetKey?: string;
+}
+export interface OneToManyOptions extends RelationBaseOptions {
+    /** 对方表指向本表的外键列名 */
+    foreignKey: string;
+    /** 本表被引用列，默认本表主键 */
+    localKey?: string;
+}
+export interface ManyToManyOptions extends RelationBaseOptions {
+    joinTable: string;
+    /** 中间表指向本表的列 */
+    joinColumn: string;
+    /** 中间表指向目标表的列 */
+    inverseJoinColumn: string;
+    /** 目标表主键列，默认 id */
+    targetKey?: string;
+    /** 本表被引用列，默认本表主键 */
+    localKey?: string;
+}
+export interface RelationMeta {
+    property: string;
+    kind: RelationKind;
+    /** 延迟解析目标实体，避免循环引用 */
+    target: () => Function;
+    foreignKey?: string;
+    targetKey: string;
+    localKey?: string;
+    joinTable?: string;
+    joinColumn?: string;
+    inverseJoinColumn?: string;
+    eager: boolean;
+    fetch: RelationFetch;
+    depth: number;
+    many: boolean;
+    datasource?: string;
+    db?: string;
+}
+type Ctor = Function;
+/** @ManyToOne(() => Role, { foreignKey: "role_id" }) */
+export declare function ManyToOne(target: () => Function, options: ManyToOneOptions): PropertyDecorator;
+/** @OneToMany(() => Menu, { foreignKey: "parent_id" }) */
+export declare function OneToMany(target: () => Function, options: OneToManyOptions): PropertyDecorator;
+/** @ManyToMany(() => Role, { joinTable, joinColumn, inverseJoinColumn }) */
+export declare function ManyToMany(target: () => Function, options: ManyToManyOptions): PropertyDecorator;
+export declare function getRelations(entity: Ctor): RelationMeta[];
+export declare function getRelation(entity: Ctor, property: string): RelationMeta | undefined;
+/**
+ * 把关联元数据编译为 FieldSelect 形态（复用 hydrate 批 IN）。
+ * SQL 使用指定方言引号。
+ */
+export declare function relationToFieldSelect(ownerEntity: Function, meta: RelationMeta, dialect?: Dialect): FieldSelectMeta;
+export {};
+//# sourceMappingURL=relation.d.ts.map

package/dist/relation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation.d.ts","sourceRoot":"","sources":["../src/relation.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAG1B,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAErE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC;AACpE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9C,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D,aAAa;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D,mBAAmB;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,CAAC;IACnB,sBAAsB;IACtB,MAAM,EAAE,MAAM,QAAQ,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAID,KAAK,IAAI,GAAG,QAAQ,CAAC;AA0CrB,wDAAwD;AACxD,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,QAAQ,EACtB,OAAO,EAAE,gBAAgB,GACxB,iBAAiB,CAkBnB;AAED,0DAA0D;AAC1D,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,QAAQ,EACtB,OAAO,EAAE,gBAAgB,GACxB,iBAAiB,CAoBnB;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,QAAQ,EACtB,OAAO,EAAE,iBAAiB,GACzB,iBAAiB,CAsBnB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,IAAI,GAAG,YAAY,EAAE,CAEzD;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,IAAI,EACZ,QAAQ,EAAE,MAAM,GACf,YAAY,GAAG,SAAS,CAE1B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,QAAQ,EACrB,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE,OAAO,GAChB,eAAe,CAiCjB"}

package/dist/relation.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ManyToOne = ManyToOne;
+exports.OneToMany = OneToMany;
+exports.ManyToMany = ManyToMany;
+exports.getRelations = getRelations;
+exports.getRelation = getRelation;
+exports.relationToFieldSelect = relationToFieldSelect;
+require("reflect-metadata");
+const beanKeys_1 = require("@pangza/core/Json/beanKeys");
+const entityDecorators_1 = require("./entityDecorators");
+const fieldSelect_1 = require("./fieldSelect");
+const security_1 = require("./security");
+const dialect_1 = require("./dialect");
+const RELATIONS_KEY = Symbol.for("pangza.orm.relations");
+function relationMap(ctor) {
+    return (Reflect.getOwnMetadata(RELATIONS_KEY, ctor) ?? {});
+}
+function saveRelation(ctor, meta) {
+    if ((0, fieldSelect_1.getFieldSelect)(ctor, meta.property)) {
+        throw new Error(`@${meta.kind}(${meta.property}) 与字段 @Select 不能同时用于同一属性`);
+    }
+    const prev = relationMap(ctor)[meta.property];
+    if (prev) {
+        throw new Error(`属性 ${meta.property} 已声明关联 ${prev.kind}`);
+    }
+    (0, beanKeys_1.addBeanKey)(ctor, meta.property);
+    Reflect.defineMetadata(RELATIONS_KEY, { ...relationMap(ctor), [meta.property]: meta }, ctor);
+}
+function resolveTargetTable(target) {
+    const name = (0, entityDecorators_1.getTableName)(target);
+    if (!name) {
+        throw new Error(`关联目标 ${target.name || "Entity"} 缺少 @TableName`);
+    }
+    return (0, security_1.assertIdent)(name);
+}
+function resolveIdColumn(entity, fallback = "id") {
+    return (0, security_1.assertIdent)((0, entityDecorators_1.getEntityIdField)(entity)?.column ?? fallback);
+}
+/** @ManyToOne(() => Role, { foreignKey: "role_id" }) */
+function ManyToOne(target, options) {
+    return (proto, propertyKey) => {
+        const property = String(propertyKey);
+        const fk = (0, security_1.assertIdent)(options.foreignKey);
+        saveRelation(proto.constructor, {
+            property,
+            kind: "ManyToOne",
+            target,
+            foreignKey: fk,
+            targetKey: (0, security_1.assertIdent)(options.targetKey ?? "id"),
+            eager: options.eager !== false,
+            fetch: options.fetch ?? "SELECT",
+            depth: Math.max(0, options.depth ?? 0),
+            many: false,
+            datasource: options.datasource?.trim() || undefined,
+            db: options.db?.trim() || undefined,
+        });
+    };
+}
+/** @OneToMany(() => Menu, { foreignKey: "parent_id" }) */
+function OneToMany(target, options) {
+    return (proto, propertyKey) => {
+        const property = String(propertyKey);
+        saveRelation(proto.constructor, {
+            property,
+            kind: "OneToMany",
+            target,
+            foreignKey: (0, security_1.assertIdent)(options.foreignKey),
+            targetKey: "id",
+            localKey: options.localKey
+                ? (0, security_1.assertIdent)(options.localKey)
+                : undefined,
+            eager: options.eager === true,
+            fetch: options.fetch ?? "SELECT",
+            depth: Math.max(0, options.depth ?? 0),
+            many: true,
+            datasource: options.datasource?.trim() || undefined,
+            db: options.db?.trim() || undefined,
+        });
+    };
+}
+/** @ManyToMany(() => Role, { joinTable, joinColumn, inverseJoinColumn }) */
+function ManyToMany(target, options) {
+    return (proto, propertyKey) => {
+        const property = String(propertyKey);
+        saveRelation(proto.constructor, {
+            property,
+            kind: "ManyToMany",
+            target,
+            joinTable: (0, security_1.assertIdent)(options.joinTable),
+            joinColumn: (0, security_1.assertIdent)(options.joinColumn),
+            inverseJoinColumn: (0, security_1.assertIdent)(options.inverseJoinColumn),
+            targetKey: (0, security_1.assertIdent)(options.targetKey ?? "id"),
+            localKey: options.localKey
+                ? (0, security_1.assertIdent)(options.localKey)
+                : undefined,
+            eager: options.eager === true,
+            fetch: options.fetch ?? "SELECT",
+            depth: Math.max(0, options.depth ?? 0),
+            many: true,
+            datasource: options.datasource?.trim() || undefined,
+            db: options.db?.trim() || undefined,
+        });
+    };
+}
+function getRelations(entity) {
+    return Object.values(relationMap(entity));
+}
+function getRelation(entity, property) {
+    return relationMap(entity)[property];
+}
+/**
+ * 把关联元数据编译为 FieldSelect 形态（复用 hydrate 批 IN）。
+ * SQL 使用指定方言引号。
+ */
+function relationToFieldSelect(ownerEntity, meta, dialect) {
+    const d = dialect ?? (0, dialect_1.getDialect)("mysql");
+    const q = (name) => d.quoteIdent((0, security_1.assertIdent)(name));
+    const target = meta.target();
+    const targetTable = resolveTargetTable(target);
+    let sql;
+    if (meta.kind === "ManyToOne") {
+        const fk = meta.foreignKey;
+        sql = `SELECT * FROM ${q(targetTable)} WHERE ${q(meta.targetKey)} = #{${fk}}`;
+    }
+    else if (meta.kind === "OneToMany") {
+        const localKey = meta.localKey ?? resolveIdColumn(ownerEntity);
+        sql = `SELECT * FROM ${q(targetTable)} WHERE ${q(meta.foreignKey)} = #{${localKey}}`;
+    }
+    else {
+        const localKey = meta.localKey ?? resolveIdColumn(ownerEntity);
+        const jt = meta.joinTable;
+        const alias = "t";
+        const j = "j";
+        sql =
+            `SELECT ${q(alias)}.* FROM ${q(targetTable)} ${q(alias)} ` +
+                `INNER JOIN ${q(jt)} ${q(j)} ON ${q(j)}.${q(meta.inverseJoinColumn)} = ${q(alias)}.${q(meta.targetKey)} ` +
+                `WHERE ${q(j)}.${q(meta.joinColumn)} = #{${localKey}}`;
+    }
+    return {
+        property: meta.property,
+        sql,
+        many: meta.many,
+        depth: meta.depth,
+        eager: meta.eager,
+        datasource: meta.datasource,
+        db: meta.db,
+    };
+}
+//# sourceMappingURL=relation.js.map

package/dist/relation.js.map

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

package/dist/resultMap.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 查询结果键名映射（对齐 MyBatis mapUnderscoreToCamelCase）。
+ * 默认开启：create_time → createTime。
+ */
+export declare function mapResultRow<T extends Record<string, any>>(row: T | null | undefined): T | null;
+export declare function mapResultRows<T extends Record<string, any>>(rows: T[]): T[];
+//# sourceMappingURL=resultMap.d.ts.map

package/dist/resultMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resultMap.d.ts","sourceRoot":"","sources":["../src/resultMap.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxD,GAAG,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GACxB,CAAC,GAAG,IAAI,CAIV;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAI3E"}

package/dist/resultMap.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapResultRow = mapResultRow;
+exports.mapResultRows = mapResultRows;
+const case_1 = require("@pangza/core/utils/case");
+const config_1 = require("./config");
+/**
+ * 查询结果键名映射（对齐 MyBatis mapUnderscoreToCamelCase）。
+ * 默认开启：create_time → createTime。
+ */
+function mapResultRow(row) {
+    if (!row)
+        return null;
+    if (!(0, config_1.getOrmConfig)().mapUnderscoreToCamelCase)
+        return row;
+    return (0, case_1.rowToCamel)(row);
+}
+function mapResultRows(rows) {
+    if (!rows?.length)
+        return rows ?? [];
+    if (!(0, config_1.getOrmConfig)().mapUnderscoreToCamelCase)
+        return rows;
+    return (0, case_1.rowsToCamel)(rows);
+}
+//# sourceMappingURL=resultMap.js.map

package/dist/resultMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resultMap.js","sourceRoot":"","sources":["../src/resultMap.ts"],"names":[],"mappings":";;AAOA,oCAMC;AAED,sCAIC;AAnBD,kDAAkE;AAClE,qCAAwC;AAExC;;;GAGG;AACH,SAAgB,YAAY,CAC1B,GAAyB;IAEzB,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,IAAI,CAAC,IAAA,qBAAY,GAAE,CAAC,wBAAwB;QAAE,OAAO,GAAG,CAAC;IACzD,OAAO,IAAA,iBAAU,EAAI,GAA8B,CAAE,CAAC;AACxD,CAAC;AAED,SAAgB,aAAa,CAAgC,IAAS;IACpE,IAAI,CAAC,IAAI,EAAE,MAAM;QAAE,OAAO,IAAI,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC,IAAA,qBAAY,GAAE,CAAC,wBAAwB;QAAE,OAAO,IAAI,CAAC;IAC1D,OAAO,IAAA,kBAAW,EAAI,IAAiC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/security.d.ts

@@ -0,0 +1,16 @@
+/**
+ * ORM SQL 安全工具：标识符白名单、整数校验、LIKE 转义。
+ * 值参数一律走 ? 占位，禁止拼接用户输入到 SQL 结构中。
+ */
+/** 校验表名/列名，防止标识符注入 */
+export declare function assertIdent(name: string): string;
+/** 校验非负安全整数（用于 LIMIT / OFFSET / 页码） */
+export declare function assertSafeUint(value: unknown, label?: string): number;
+/** 转义 LIKE 通配符，避免用户输入 %/_ 扩大匹配面 */
+export declare function escapeLike(value: string): string;
+/**
+ * 校验 last() 仅允许白名单安全片段。
+ * 禁止任意原生 SQL 拼接，降低注入风险。
+ */
+export declare function assertSafeLastSql(sql: string): string;
+//# sourceMappingURL=security.d.ts.map

package/dist/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../src/security.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,sBAAsB;AACtB,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED,uCAAuC;AACvC,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAW,GAAG,MAAM,CAMvE;AAED,mCAAmC;AACnC,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAYrD"}

package/dist/security.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * ORM SQL 安全工具：标识符白名单、整数校验、LIKE 转义。
+ * 值参数一律走 ? 占位，禁止拼接用户输入到 SQL 结构中。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertIdent = assertIdent;
+exports.assertSafeUint = assertSafeUint;
+exports.escapeLike = escapeLike;
+exports.assertSafeLastSql = assertSafeLastSql;
+const IDENT_RE = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+const FORBIDDEN_IDENTS = new Set([
+    "__proto__",
+    "constructor",
+    "prototype",
+]);
+/** 校验表名/列名，防止标识符注入 */
+function assertIdent(name) {
+    if (typeof name !== "string" || !IDENT_RE.test(name) || FORBIDDEN_IDENTS.has(name)) {
+        throw new Error(`非法标识符: ${String(name)}`);
+    }
+    return name;
+}
+/** 校验非负安全整数（用于 LIMIT / OFFSET / 页码） */
+function assertSafeUint(value, label = "number") {
+    const n = typeof value === "number" ? value : Number(value);
+    if (!Number.isInteger(n) || n < 0 || n > Number.MAX_SAFE_INTEGER) {
+        throw new Error(`非法整数参数 ${label}: ${String(value)}`);
+    }
+    return n;
+}
+/** 转义 LIKE 通配符，避免用户输入 %/_ 扩大匹配面 */
+function escapeLike(value) {
+    return String(value)
+        .replace(/\\/g, "\\\\")
+        .replace(/%/g, "\\%")
+        .replace(/_/g, "\\_");
+}
+/**
+ * 校验 last() 仅允许白名单安全片段。
+ * 禁止任意原生 SQL 拼接，降低注入风险。
+ */
+function assertSafeLastSql(sql) {
+    const trimmed = String(sql).trim().replace(/\s+/g, " ");
+    if (!/^(LIMIT\s+\d+(\s+OFFSET\s+\d+)?|FOR UPDATE|LOCK IN SHARE MODE)$/i.test(trimmed)) {
+        throw new Error("last() 仅允许: LIMIT n [OFFSET m] / FOR UPDATE / LOCK IN SHARE MODE");
+    }
+    return trimmed;
+}
+//# sourceMappingURL=security.js.map

package/dist/security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../src/security.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAUH,kCAKC;AAGD,wCAMC;AAGD,gCAKC;AAMD,8CAYC;AAhDD,MAAM,QAAQ,GAAG,0BAA0B,CAAC;AAC5C,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IAC/B,WAAW;IACX,aAAa;IACb,WAAW;CACZ,CAAC,CAAC;AAEH,sBAAsB;AACtB,SAAgB,WAAW,CAAC,IAAY;IACtC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACnF,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uCAAuC;AACvC,SAAgB,cAAc,CAAC,KAAc,EAAE,KAAK,GAAG,QAAQ;IAC7D,MAAM,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,mCAAmC;AACnC,SAAgB,UAAU,CAAC,KAAa;IACtC,OAAO,MAAM,CAAC,KAAK,CAAC;SACjB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;SACpB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,GAAW;IAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACxD,IACE,CAAC,kEAAkE,CAAC,IAAI,CACtE,OAAO,CACR,EACD,CAAC;QACD,MAAM,IAAI,KAAK,CACb,kEAAkE,CACnE,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/sqlDecorators.d.ts

@@ -0,0 +1,60 @@
+import "reflect-metadata";
+import type { DbType } from "./dialect";
+import { type FieldSelectOptions } from "./fieldSelect";
+/** Mapper 类上挂的实体（供方法级 @Select 结果自动填充字段 @Select） */
+export declare const MAPPER_ENTITY_KEY: unique symbol;
+/** 方法级 SQL 装饰器数据源选项 */
+export interface SqlExecuteOptions {
+    /**
+     * 数据源名称（Db.register 的名字），默认 "default"。
+     * 与 db 同时存在时以 datasource 为准。
+     */
+    datasource?: string;
+    /**
+     * 按已注册数据源的数据库类型查找（mysql / postgresql / sqlserver）。
+     * 同类型有多个时须改用 datasource。
+     */
+    db?: DbType | string;
+}
+export type SelectOptions = FieldSelectOptions & SqlExecuteOptions;
+/**
+ * @Param("id")
+ * 为方法参数命名，供 SQL 中 #{id} / ${id} 引用。
+ */
+export declare function Param(name: string): ParameterDecorator;
+/**
+ * @Select — 方法装饰器或字段装饰器。
+ *
+ * 方法：执行 SQL，返回行数组。
+ * 字段：查询结果映射到该属性（父行字段可用 #{id} / #{parentId} 等引用）。
+ *
+ * @example
+ * @Select("SELECT * FROM user WHERE id = #{id}")
+ * findById(@Param("id") id: string) {}
+ *
+ * @Select('SELECT * FROM "user" WHERE id = #{id}', { db: "postgresql" })
+ * findOnPg(@Param("id") id: string) {}
+ *
+ * @Select("SELECT * FROM menu WHERE parent_id = #{id}", { many: true })
+ * children?: Menu[];
+ */
+export declare function Select(sql: string, options?: SelectOptions): MethodDecorator & PropertyDecorator;
+/**
+ * @Insert("INSERT INTO user(name) VALUES(#{name})")
+ * 返回 insertId；PostgreSQL / SQL Server 建议在 SQL 中写 RETURNING / OUTPUT。
+ *
+ * @example
+ * @Insert("INSERT INTO user(name) VALUES(#{name})", { datasource: "pg" })
+ */
+export declare const Insert: (sql: string, options?: SqlExecuteOptions) => MethodDecorator;
+/**
+ * @Update("UPDATE user SET name = #{name} WHERE id = #{id}")
+ * 返回 affectedRows。
+ */
+export declare const Update: (sql: string, options?: SqlExecuteOptions) => MethodDecorator;
+/**
+ * @Delete("DELETE FROM user WHERE id = #{id}")
+ * 返回 affectedRows（物理删除；逻辑删除请用 BaseMapper.delete*）。
+ */
+export declare const Delete: (sql: string, options?: SqlExecuteOptions) => MethodDecorator;
+//# sourceMappingURL=sqlDecorators.d.ts.map

package/dist/sqlDecorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlDecorators.d.ts","sourceRoot":"","sources":["../src/sqlDecorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAuB,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAK7E,mDAAmD;AACnD,eAAO,MAAM,iBAAiB,eAAwC,CAAC;AAIvE,uBAAuB;AACvB,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG,iBAAiB,CAAC;AAuBnE;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAatD;AA0DD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,MAAM,CACpB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,aAAa,GACtB,eAAe,GAAG,iBAAiB,CA+BrC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,QAlHJ,MAAM,YAAY,iBAAiB,KAAG,eAkHG,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,MAAM,QAxHJ,MAAM,YAAY,iBAAiB,KAAG,eAwHG,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,MAAM,QA9HJ,MAAM,YAAY,iBAAiB,KAAG,eA8HG,CAAC"}