@pangza/orm 0.0.0-stage → 1.0.1

package/dist/QueryWrapper.js

@@ -0,0 +1,343 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryWrapper = exports.assertIdent = void 0;
+const security_1 = require("./security");
+const dialect_1 = require("./dialect");
+var security_2 = require("./security");
+Object.defineProperty(exports, "assertIdent", { enumerable: true, get: function () { return security_2.assertIdent; } });
+function resolveInBatchSize() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const { getOrmConfig } = require("./config");
+        const n = Number(getOrmConfig().batchInSize ?? 500);
+        return Number.isFinite(n) && n >= 1 ? Math.floor(n) : 500;
+    }
+    catch {
+        return 500;
+    }
+}
+/**
+ * 条件构造器（对齐 MyBatis-Plus QueryWrapper 常用 API）
+ * 列名白名单校验，值一律参数绑定。
+ *
+ * @example
+ * new QueryWrapper().select('id', 'username').eq('status', 1).orderByDesc('id')
+ * new QueryWrapper({ dialect: "postgresql" }).eq("status", 1)
+ */
+class QueryWrapper {
+    constructor(options) {
+        this.conditions = [];
+        this.orders = [];
+        this.selectColumns = [];
+        this.groupColumns = [];
+        this.havingClauses = [];
+        this.lastSqlText = "";
+        this.nextJoin = "AND";
+        this.skipLogicDelete = false;
+        if (!options) {
+            this.dialect = (0, dialect_1.getDialect)("mysql");
+        }
+        else if (typeof options === "string") {
+            this.dialect = (0, dialect_1.getDialect)(options);
+        }
+        else if (typeof options === "object" && "quoteIdent" in options) {
+            this.dialect = options;
+        }
+        else {
+            const d = options.dialect;
+            if (d && typeof d === "object" && "quoteIdent" in d) {
+                this.dialect = d;
+            }
+            else {
+                this.dialect = (0, dialect_1.getDialect)(d ?? "mysql");
+            }
+        }
+    }
+    getDialect() {
+        return this.dialect;
+    }
+    /** 本条查询忽略逻辑删除条件（查回收站等） */
+    ignoreLogicDelete() {
+        this.skipLogicDelete = true;
+        return this;
+    }
+    isIgnoreLogicDelete() {
+        return this.skipLogicDelete;
+    }
+    /** 复制一份，避免 Mapper 追加逻辑删除时改到调用方 */
+    clone() {
+        const copy = new QueryWrapper(this.dialect);
+        copy.conditions =
+            this.conditions.map((c) => ({
+                join: c.join,
+                sql: c.sql,
+                params: [...c.params],
+            }));
+        copy.orders = [...this.orders];
+        copy.selectColumns = [
+            ...this.selectColumns,
+        ];
+        copy.groupColumns = [
+            ...this.groupColumns,
+        ];
+        copy.havingClauses =
+            this.havingClauses.map((h) => ({
+                sql: h.sql,
+                params: [...h.params],
+            }));
+        copy.lastSqlText = this.lastSqlText;
+        copy.nextJoin = this.nextJoin;
+        copy.skipLogicDelete = this.skipLogicDelete;
+        return copy;
+    }
+    /** 下一条件用 OR 连接 */
+    or() {
+        this.nextJoin = "OR";
+        return this;
+    }
+    /** 下一条件用 AND 连接（默认） */
+    and() {
+        this.nextJoin = "AND";
+        return this;
+    }
+    add(sql, params = []) {
+        this.conditions.push({
+            join: this.nextJoin,
+            sql,
+            params,
+        });
+        this.nextJoin = "AND";
+        return this;
+    }
+    col(column) {
+        return this.dialect.quoteIdent((0, security_1.assertIdent)(column));
+    }
+    /**
+     * 指定查询列；不传则默认 SELECT *
+     * @example wrapper.select('id', 'username', 'status')
+     */
+    select(...columns) {
+        if (columns.length === 0) {
+            this.selectColumns = [];
+            return this;
+        }
+        this.selectColumns = columns.map((c) => this.col(c));
+        return this;
+    }
+    eq(column, value) {
+        return this.add(`${this.col(column)} = ?`, [value]);
+    }
+    /** field = value OR field IS NULL（兼容历史未填逻辑删除字段的数据） */
+    eqOrIsNull(column, value) {
+        const c = this.col(column);
+        return this.add(`(${c} = ? OR ${c} IS NULL)`, [value]);
+    }
+    ne(column, value) {
+        return this.add(`${this.col(column)} <> ?`, [value]);
+    }
+    gt(column, value) {
+        return this.add(`${this.col(column)} > ?`, [value]);
+    }
+    ge(column, value) {
+        return this.add(`${this.col(column)} >= ?`, [value]);
+    }
+    lt(column, value) {
+        return this.add(`${this.col(column)} < ?`, [value]);
+    }
+    le(column, value) {
+        return this.add(`${this.col(column)} <= ?`, [value]);
+    }
+    likePattern(column, pattern, not = false) {
+        const op = not ? "NOT LIKE" : "LIKE";
+        return this.add(`${this.col(column)} ${op} ?${this.dialect.likeEscapeClause()}`, [pattern]);
+    }
+    /** 模糊查询；已转义 % / _，避免通配符注入 */
+    like(column, value) {
+        return this.likePattern(column, `%${(0, security_1.escapeLike)(String(value))}%`);
+    }
+    /** 左模糊：`%value`（对齐 MP likeLeft） */
+    likeLeft(column, value) {
+        return this.likePattern(column, `%${(0, security_1.escapeLike)(String(value))}`);
+    }
+    /** 右模糊：`value%`（对齐 MP likeRight） */
+    likeRight(column, value) {
+        return this.likePattern(column, `${(0, security_1.escapeLike)(String(value))}%`);
+    }
+    /** `NOT LIKE %value%`（已转义通配符） */
+    notLike(column, value) {
+        return this.likePattern(column, `%${(0, security_1.escapeLike)(String(value))}%`, true);
+    }
+    /**
+     * EXISTS (子查询)。子查询自行保证安全；参数走绑定。
+     * @example wrapper.exists('SELECT 1 FROM role_user ru WHERE ru.user_id = t.id AND ru.role_id = ?', [1])
+     */
+    exists(sql, params = []) {
+        const body = String(sql).trim();
+        if (!body)
+            throw new Error("exists() 子查询不能为空");
+        return this.add(`EXISTS (${body})`, params);
+    }
+    /** NOT EXISTS (子查询) */
+    notExists(sql, params = []) {
+        const body = String(sql).trim();
+        if (!body)
+            throw new Error("notExists() 子查询不能为空");
+        return this.add(`NOT EXISTS (${body})`, params);
+    }
+    /**
+     * 追加自定义条件片段（参数绑定）。
+     * 仅用于无法用 eq/like 表达的括号 OR 等场景；列名须自行保证安全。
+     */
+    apply(sql, params = []) {
+        return this.add(`(${sql})`, params);
+    }
+    /** 括号分组：fn 内条件作为整体与外层 AND/OR 连接（内层沿用本 Wrapper 方言） */
+    nested(fn) {
+        const inner = new QueryWrapper(this.dialect);
+        fn(inner);
+        const frag = inner.build();
+        if (!frag.whereSql)
+            return this;
+        const body = frag.whereSql.replace(/^WHERE\s+/i, "");
+        return this.add(`(${body})`, frag.params);
+    }
+    /** 大数组按 batchInSize 拆成多个 IN，用 OR / AND 连接 */
+    inChunks(column, values, not) {
+        const col = this.col(column);
+        const chunkSize = resolveInBatchSize();
+        const op = not ? "NOT IN" : "IN";
+        const join = not ? " AND " : " OR ";
+        if (values.length <= chunkSize) {
+            const placeholders = values.map(() => "?").join(", ");
+            return this.add(`${col} ${op} (${placeholders})`, values);
+        }
+        const parts = [];
+        const params = [];
+        for (let i = 0; i < values.length; i += chunkSize) {
+            const chunk = values.slice(i, i + chunkSize);
+            parts.push(`${col} ${op} (${chunk.map(() => "?").join(", ")})`);
+            params.push(...chunk);
+        }
+        return this.add(`(${parts.join(join)})`, params);
+    }
+    in(column, values) {
+        if (!Array.isArray(values)) {
+            throw new Error("in() 参数必须是数组");
+        }
+        if (!values.length) {
+            return this.add("1 = 0");
+        }
+        return this.inChunks(column, values, false);
+    }
+    /** `NOT IN (...)`；空数组视为永真（不加限制），与 in([]) 永假对称 */
+    notIn(column, values) {
+        if (!Array.isArray(values)) {
+            throw new Error("notIn() 参数必须是数组");
+        }
+        if (!values.length) {
+            return this.add("1 = 1");
+        }
+        return this.inChunks(column, values, true);
+    }
+    between(column, start, end) {
+        return this.add(`${this.col(column)} BETWEEN ? AND ?`, [start, end]);
+    }
+    notBetween(column, start, end) {
+        return this.add(`${this.col(column)} NOT BETWEEN ? AND ?`, [start, end]);
+    }
+    /**
+     * 按已注册数据源方言创建 Wrapper（避免默认 mysql 引号用在 PG/MSSQL 上）。
+     * @example QueryWrapper.forDatasource("postgresql").eq("status", 1)
+     */
+    static forDatasource(name = "default") {
+        // 延迟加载，避免与 Db 循环依赖
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const Db = require("./Db").default;
+        return new QueryWrapper(Db.getDialect(name));
+    }
+    isNull(column) {
+        return this.add(`${this.col(column)} IS NULL`);
+    }
+    isNotNull(column) {
+        return this.add(`${this.col(column)} IS NOT NULL`);
+    }
+    orderByAsc(column) {
+        this.orders.push(`${this.col(column)} ASC`);
+        return this;
+    }
+    orderByDesc(column) {
+        this.orders.push(`${this.col(column)} DESC`);
+        return this;
+    }
+    /**
+     * GROUP BY 列（白名单标识符）。可多次调用追加。
+     * @example wrapper.select("status").groupBy("status")
+     */
+    groupBy(...columns) {
+        for (const c of columns) {
+            this.groupColumns.push(this.col(c));
+        }
+        return this;
+    }
+    /**
+     * HAVING 条件（参数绑定）。可多次调用，以 AND 连接。
+     * 聚合表达式由调用方书写，列名请自行保证安全。
+     * @example wrapper.groupBy("status").having("COUNT(*) > ?", [1])
+     */
+    having(sql, params = []) {
+        const body = String(sql).trim();
+        if (!body)
+            throw new Error("having() 条件不能为空");
+        this.havingClauses.push({ sql: body, params: [...params] });
+        return this;
+    }
+    /**
+     * 追加安全白名单片段（禁止任意 SQL）。
+     * 仅允许：LIMIT n [OFFSET m] / FOR UPDATE / LOCK IN SHARE MODE
+     */
+    last(sql) {
+        this.lastSqlText = (0, security_1.assertSafeLastSql)(sql);
+        return this;
+    }
+    /** 生成 SELECT / WHERE / GROUP BY / HAVING / ORDER BY / LAST 片段 */
+    build() {
+        const params = [];
+        let whereSql = "";
+        if (this.conditions.length > 0) {
+            const parts = [];
+            this.conditions.forEach((c, index) => {
+                if (index === 0) {
+                    parts.push(c.sql);
+                }
+                else {
+                    parts.push(`${c.join} ${c.sql}`);
+                }
+                params.push(...c.params);
+            });
+            whereSql = `WHERE ${parts.join(" ")}`;
+        }
+        const groupSql = this.groupColumns.length > 0
+            ? `GROUP BY ${this.groupColumns.join(", ")}`
+            : "";
+        let havingSql = "";
+        if (this.havingClauses.length > 0) {
+            const parts = this.havingClauses.map((h) => {
+                params.push(...h.params);
+                return h.sql;
+            });
+            havingSql = `HAVING ${parts.join(" AND ")}`;
+        }
+        const orderSql = this.orders.length > 0 ? `ORDER BY ${this.orders.join(", ")}` : "";
+        return {
+            selectSql: this.selectColumns.length > 0 ? this.selectColumns.join(", ") : "*",
+            whereSql,
+            groupSql,
+            havingSql,
+            orderSql,
+            lastSql: this.lastSqlText,
+            params,
+        };
+    }
+}
+exports.QueryWrapper = QueryWrapper;
+//# sourceMappingURL=QueryWrapper.js.map

package/dist/QueryWrapper.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,12 @@
+import type { MetaObjectHandler, ResolvedOrmConfig } from "./types";
+/** 读取当前全局 ORM 配置（YAML + configure 覆盖） */
+export declare function getOrmConfig(): ResolvedOrmConfig;
+/**
+ * 运行时覆盖全局配置（表级 MapperOptions 仍可再覆盖）。
+ * 会清空 Mapper 缓存，使逻辑删除 / 乐观锁等快照配置生效。
+ */
+export declare function configureOrm(patch?: Partial<ResolvedOrmConfig>): void;
+/** 注册创建 / 修改拦截（在默认填充之后执行） */
+export declare function setMetaObjectHandler(handler?: MetaObjectHandler): void;
+export declare function getMetaObjectHandler(): MetaObjectHandler | undefined;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAWpE,yCAAyC;AACzC,wBAAgB,YAAY,IAAI,iBAAiB,CAoChD;AA0BD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,GAAE,OAAO,CAAC,iBAAiB,CAAM,GAAG,IAAI,CASzE;AAED,6BAA6B;AAC7B,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAEtE;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,GAAG,SAAS,CAEpE"}

package/dist/config.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOrmConfig = getOrmConfig;
+exports.configureOrm = configureOrm;
+exports.setMetaObjectHandler = setMetaObjectHandler;
+exports.getMetaObjectHandler = getMetaObjectHandler;
+const config_1 = require("@pangza/core/config");
+const sqlLog_1 = require("./sqlLog");
+let runtime = {};
+let metaObjectHandler;
+function strOrUndef(value) {
+    const v = value?.trim();
+    return v ? v : undefined;
+}
+/** 读取当前全局 ORM 配置（YAML + configure 覆盖） */
+function getOrmConfig() {
+    return {
+        logicDelete: runtime.logicDelete ?? config_1.ormEnvConfig.logicDelete,
+        logicDeleteField: runtime.logicDeleteField ?? config_1.ormEnvConfig.logicDeleteField,
+        logicDeleteValue: runtime.logicDeleteValue ?? config_1.ormEnvConfig.logicDeleteValue,
+        logicNotDeleteValue: runtime.logicNotDeleteValue ?? config_1.ormEnvConfig.logicNotDeleteValue,
+        optimisticLock: runtime.optimisticLock ?? config_1.ormEnvConfig.optimisticLock,
+        versionField: runtime.versionField ?? config_1.ormEnvConfig.versionField,
+        idType: runtime.idType ?? config_1.ormEnvConfig.idType,
+        mapUnderscoreToCamelCase: runtime.mapUnderscoreToCamelCase ??
+            config_1.ormEnvConfig.mapUnderscoreToCamelCase,
+        fillCreateTime: runtime.fillCreateTime ?? strOrUndef(config_1.ormEnvConfig.fillCreateTime),
+        fillUpdateTime: runtime.fillUpdateTime ?? strOrUndef(config_1.ormEnvConfig.fillUpdateTime),
+        fillCreateBy: runtime.fillCreateBy ?? strOrUndef(config_1.ormEnvConfig.fillCreateBy),
+        fillUpdateBy: runtime.fillUpdateBy ?? strOrUndef(config_1.ormEnvConfig.fillUpdateBy),
+        sqlLog: runtime.sqlLog ?? config_1.ormEnvConfig.sqlLog,
+        sqlLogFormat: runtime.sqlLogFormat ?? config_1.ormEnvConfig.sqlLogFormat,
+        sqlLogParts: runtime.sqlLogParts ?? config_1.ormEnvConfig.sqlLogParts,
+        sqlLogLevel: runtime.sqlLogLevel ?? config_1.ormEnvConfig.sqlLogLevel,
+        batchInsertSize: runtime.batchInsertSize ?? config_1.ormEnvConfig.batchInsertSize,
+        batchUpdateSize: runtime.batchUpdateSize ?? config_1.ormEnvConfig.batchUpdateSize,
+        batchInSize: runtime.batchInSize ?? config_1.ormEnvConfig.batchInSize,
+        mapperLocations: runtime.mapperLocations ?? config_1.ormEnvConfig.mapperLocations ?? [],
+        mapperReload: runtime.mapperReload ?? config_1.ormEnvConfig.mapperReload ?? false,
+    };
+}
+function syncSqlLogFromConfig() {
+    const cfg = getOrmConfig();
+    // 生产环境：除非 configureOrm / YAML 显式打开，否则强制关闭 SQL 日志
+    const production = config_1.configProfile === "production";
+    const enabled = production && runtime.sqlLog === undefined && config_1.ormEnvConfig.sqlLog !== true
+        ? false
+        : !!cfg.sqlLog;
+    if (production && enabled) {
+        console.warn("[ORM] 生产环境已开启 SQL 日志，请确认不会泄露敏感参数；日志已对 password/token 等字段脱敏");
+    }
+    (0, sqlLog_1.configureSqlLog)({
+        enabled,
+        format: cfg.sqlLogFormat,
+        parts: cfg.sqlLogParts,
+        level: cfg.sqlLogLevel,
+    });
+}
+// 模块加载时按 YAML 同步一次
+syncSqlLogFromConfig();
+/**
+ * 运行时覆盖全局配置（表级 MapperOptions 仍可再覆盖）。
+ * 会清空 Mapper 缓存，使逻辑删除 / 乐观锁等快照配置生效。
+ */
+function configureOrm(patch = {}) {
+    runtime = { ...runtime, ...patch };
+    syncSqlLogFromConfig();
+    // 延迟加载，避免 config ↔ table ↔ BaseMapper 循环依赖
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const { clearTableCache } = require("./table");
+    clearTableCache();
+}
+/** 注册创建 / 修改拦截（在默认填充之后执行） */
+function setMetaObjectHandler(handler) {
+    metaObjectHandler = handler;
+}
+function getMetaObjectHandler() {
+    return metaObjectHandler;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/dialect.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 数据库方言：引号、占位符、分页、自增回填等差异。
+ */
+export type DbType = "mysql" | "postgresql" | "sqlserver";
+export interface Dialect {
+    readonly type: DbType;
+    /** 引用标识符（表名 / 列名） */
+    quoteIdent(name: string): string;
+    /**
+     * 将内部统一的 `?` 占位 SQL 转为驱动可执行形式。
+     * MySQL / SQL Server 保持 `?`；PostgreSQL 转为 `$1,$2,...`
+     */
+    convertPlaceholders(sql: string): string;
+    /**
+     * LIKE / NOT LIKE 的 ESCAPE 子句（含前导空格）。
+     * MySQL 字符串里 `\\\\` 表示一个反斜杠转义符；PG / MSSQL 用 `\\`。
+     */
+    likeEscapeClause(): string;
+    /** 追加 LIMIT / OFFSET（或 SQL Server OFFSET FETCH） */
+    appendLimitOffset(sql: string, limit: number, offset?: number, hasOrderBy?: boolean): string;
+    /** 查询表列名的 SQL（参数：tableName） */
+    listColumnsSql(table: string): {
+        sql: string;
+        params: unknown[];
+    };
+    /** 从 listColumns 结果解析列名 */
+    parseColumnNames(rows: Record<string, unknown>[]): string[];
+    /** INSERT 后取自增/回填 id；pg 会改写 SQL 加 RETURNING */
+    prepareInsert(sql: string, idColumn: string): {
+        sql: string;
+        returning: boolean;
+    };
+    extractInsertId(result: unknown, idColumn: string, returning: boolean): number;
+    /** 影响行数 */
+    extractAffectedRows(result: unknown): number;
+}
+export declare const MysqlDialect: Dialect;
+export declare const PostgresqlDialect: Dialect;
+export declare const SqlServerDialect: Dialect;
+export declare function getDialect(type?: DbType | string): Dialect;
+//# sourceMappingURL=dialect.d.ts.map

package/dist/dialect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialect.d.ts","sourceRoot":"","sources":["../src/dialect.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,WAAW,CAAC;AAE1D,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC;;;OAGG;IACH,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACzC;;;OAGG;IACH,gBAAgB,IAAI,MAAM,CAAC;IAC3B,mDAAmD;IACnD,iBAAiB,CACf,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,OAAO,GACnB,MAAM,CAAC;IACV,+BAA+B;IAC/B,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAClE,2BAA2B;IAC3B,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;IAC5D,+CAA+C;IAC/C,aAAa,CACX,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IACvC,eAAe,CACb,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO,GACjB,MAAM,CAAC;IACV,WAAW;IACX,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;CAC9C;AAOD,eAAO,MAAM,YAAY,EAAE,OAmC1B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,OA0C/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,OAsD9B,CAAC;AAQF,wBAAgB,UAAU,CAAC,IAAI,GAAE,MAAM,GAAG,MAAgB,GAAG,OAAO,CAkBnE"}