@pangza/orm 0.0.0-stage → 1.0.1

package/dist/Db.js

@@ -0,0 +1,222 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDialect = exports.DataSource = void 0;
+const sqlLog_1 = require("./sqlLog");
+const DataSource_1 = require("./DataSource");
+Object.defineProperty(exports, "DataSource", { enumerable: true, get: function () { return DataSource_1.DataSource; } });
+const dialect_1 = require("./dialect");
+Object.defineProperty(exports, "getDialect", { enumerable: true, get: function () { return dialect_1.getDialect; } });
+const config_1 = require("@pangza/core/config");
+/**
+ * 多数据源门面（默认名 default）。
+ *
+ * @example
+ * // 默认库（项目根目录 application*.yaml 的 datasource.default）
+ * await Db.query("SELECT 1")
+ *
+ * // 注册 PostgreSQL
+ * Db.register("pg", { type: "postgresql", host: "127.0.0.1", database: "app", user: "postgres", password: "x" })
+ * await Db.queryOn("pg", 'SELECT * FROM "user" WHERE id = ?', [1])
+ *
+ * // Mapper / 装饰器指定数据源
+ * @Mapper(UserEntity, { datasource: "pg" })
+ * @Select("SELECT ...", { datasource: "pg" })
+ */
+class Db {
+    /** 注册或覆盖数据源 */
+    static register(nameOrConfig, config) {
+        let name;
+        let cfg;
+        if (typeof nameOrConfig === "string") {
+            name = nameOrConfig.trim() || this.DEFAULT;
+            cfg = { ...(config ?? {}), name };
+        }
+        else {
+            cfg = { ...nameOrConfig };
+            name = (cfg.name ?? this.DEFAULT).trim() || this.DEFAULT;
+            cfg.name = name;
+        }
+        const ds = new DataSource_1.DataSource(cfg);
+        this.sources.set(name, ds);
+        return ds;
+    }
+    /** 确保默认数据源（来自 YAML datasource.default）；并按需注册 postgresql / sqlserver */
+    static ensureDefault() {
+        if (!this.sources.has(this.DEFAULT)) {
+            this.register(this.DEFAULT, {
+                name: this.DEFAULT,
+                type: config_1.mysqlConfig.type || "mysql",
+                host: config_1.mysqlConfig.host,
+                port: config_1.mysqlConfig.port,
+                user: config_1.mysqlConfig.user,
+                password: config_1.mysqlConfig.password,
+                database: config_1.mysqlConfig.database,
+                connectionLimit: config_1.mysqlConfig.connectionLimit,
+            });
+        }
+        this.registerOptionalFromEnv();
+        return this.sources.get(this.DEFAULT);
+    }
+    /** YAML 中 postgresql / sqlserver 的 host 非空时自动注册命名数据源 */
+    static registerOptionalFromEnv() {
+        if (config_1.postgresqlConfig.host && !this.sources.has("postgresql")) {
+            this.register("postgresql", {
+                name: "postgresql",
+                type: "postgresql",
+                host: config_1.postgresqlConfig.host,
+                port: config_1.postgresqlConfig.port,
+                user: config_1.postgresqlConfig.user,
+                password: config_1.postgresqlConfig.password,
+                database: config_1.postgresqlConfig.database,
+                connectionLimit: config_1.postgresqlConfig.connectionLimit,
+            });
+        }
+        if (config_1.mssqlConfig.host && !this.sources.has("sqlserver")) {
+            this.register("sqlserver", {
+                name: "sqlserver",
+                type: "sqlserver",
+                host: config_1.mssqlConfig.host,
+                port: config_1.mssqlConfig.port,
+                user: config_1.mssqlConfig.user,
+                password: config_1.mssqlConfig.password,
+                database: config_1.mssqlConfig.database,
+                connectionLimit: config_1.mssqlConfig.connectionLimit,
+            });
+        }
+    }
+    static getDataSource(name = this.DEFAULT) {
+        if (name === this.DEFAULT) {
+            return this.ensureDefault();
+        }
+        const ds = this.sources.get(name);
+        if (!ds) {
+            this.ensureDefault();
+            const registered = [...this.sources.keys()].join(", ") || "(无)";
+            throw new Error(`未注册数据源 [${name}]。已注册: ${registered}。请先 Db.register("${name}", { type, host, ... })`);
+        }
+        return ds;
+    }
+    /** 按数据库类型查找唯一数据源（用于 @Select({ db: "postgresql" })） */
+    static findByType(type) {
+        this.ensureDefault();
+        const dialect = (0, dialect_1.getDialect)(type);
+        const matched = [...this.sources.entries()].filter(([, ds]) => ds.type === dialect.type);
+        if (matched.length === 0) {
+            throw new Error(`没有已注册的 ${dialect.type} 数据源`);
+        }
+        if (matched.length > 1) {
+            throw new Error(`存在多个 ${dialect.type} 数据源 (${matched
+                .map(([n]) => n)
+                .join(", ")})，请用 datasource 指定名称`);
+        }
+        return matched[0][0];
+    }
+    static getDialect(name = this.DEFAULT) {
+        return this.getDataSource(name).dialect;
+    }
+    static listDataSources() {
+        this.ensureDefault();
+        return [...this.sources.keys()];
+    }
+    /** @deprecated 使用 register；保留覆盖默认连接配置 */
+    static configure(config = {}) {
+        this.register(this.DEFAULT, {
+            type: config_1.mysqlConfig.type || "mysql",
+            host: config_1.mysqlConfig.host,
+            port: config_1.mysqlConfig.port,
+            user: config_1.mysqlConfig.user,
+            password: config_1.mysqlConfig.password,
+            database: config_1.mysqlConfig.database,
+            connectionLimit: config_1.mysqlConfig.connectionLimit,
+            ...config,
+            name: this.DEFAULT,
+        });
+    }
+    static isReady(name = this.DEFAULT) {
+        return this.sources.get(name)?.isReady() ?? false;
+    }
+    /** 测试注入默认池驱动 */
+    static usePoolForTest(pool) {
+        const ds = this.ensureDefault();
+        // 兼容旧测试：传入 mysql2 Pool
+        if (pool && typeof pool.execute === "function") {
+            const mysqlPool = pool;
+            ds.useDriverForTest({
+                async query(sql, params) {
+                    const [rows] = await mysqlPool.execute(sql, params);
+                    return rows;
+                },
+                async getConnection() {
+                    const conn = await mysqlPool.getConnection();
+                    return {
+                        async query(sql, params) {
+                            const [rows] = await conn.execute(sql, params);
+                            return rows;
+                        },
+                        async begin() {
+                            await conn.beginTransaction();
+                        },
+                        async commit() {
+                            await conn.commit();
+                        },
+                        async rollback() {
+                            await conn.rollback();
+                        },
+                        release() {
+                            conn.release();
+                        },
+                    };
+                },
+                async end() {
+                    await mysqlPool.end();
+                },
+            });
+            return;
+        }
+        ds.useDriverForTest(pool);
+    }
+    static async connect(config) {
+        if (config)
+            this.configure(config);
+        await this.ensureDefault().connect();
+    }
+    static async connectAll() {
+        this.ensureDefault();
+        await Promise.all([...this.sources.values()].map((ds) => ds.connect()));
+    }
+    static async disconnect(name) {
+        if (name) {
+            await this.sources.get(name)?.disconnect();
+            return;
+        }
+        await Promise.all([...this.sources.values()].map((ds) => ds.disconnect()));
+    }
+    static inTransaction(name = this.DEFAULT) {
+        return this.getDataSource(name).inTransaction();
+    }
+    /** 默认数据源执行 SQL */
+    static async query(sql, params = []) {
+        return this.queryOn(this.DEFAULT, sql, params);
+    }
+    /** 指定数据源执行 SQL */
+    static async queryOn(datasource, sql, params = []) {
+        return (0, sqlLog_1.withSqlLog)(sql, params, async () => {
+            const ds = this.getDataSource(datasource);
+            return ds.query(sql, params);
+        });
+    }
+    static async getPool() {
+        await this.ensureDefault().connect();
+        return this.ensureDefault();
+    }
+    static async transaction(fn, options) {
+        return this.transactionOn(this.DEFAULT, fn, options);
+    }
+    static async transactionOn(datasource, fn, options) {
+        return this.getDataSource(datasource).transaction(fn, options);
+    }
+}
+Db.sources = new Map();
+Db.DEFAULT = "default";
+exports.default = Db;
+//# sourceMappingURL=Db.js.map

package/dist/Db.js.map

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

package/dist/IdType.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 主键生成策略（对齐 MyBatis-Plus IdType）
+ *
+ * @example
+ * @TableId({ type: IdType.ASSIGN_ID })
+ * id!: string;
+ */
+export declare enum IdType {
+    /** 数据库自增（不向 INSERT 写入 id，插入后回填） */
+    AUTO = "AUTO",
+    /** 未设置：跟随全局 configureOrm / ORM_ID_TYPE */
+    NONE = "NONE",
+    /** 插入前自行赋值，框架不生成 */
+    INPUT = "INPUT",
+    /** 雪花算法分配（空才生成），适合 number / string */
+    ASSIGN_ID = "ASSIGN_ID",
+    /** UUID（去横线）分配，适合 string */
+    ASSIGN_UUID = "ASSIGN_UUID"
+}
+export type IdTypeValue = IdType | keyof typeof IdType | string;
+export declare function resolveIdType(value?: IdTypeValue | null): IdType;
+//# sourceMappingURL=IdType.d.ts.map

package/dist/IdType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IdType.d.ts","sourceRoot":"","sources":["../src/IdType.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,oBAAY,MAAM;IAChB,mCAAmC;IACnC,IAAI,SAAS;IACb,0CAA0C;IAC1C,IAAI,SAAS;IACb,oBAAoB;IACpB,KAAK,UAAU;IACf,sCAAsC;IACtC,SAAS,cAAc;IACvB,4BAA4B;IAC5B,WAAW,gBAAgB;CAC5B;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,OAAO,MAAM,GAAG,MAAM,CAAC;AAEhE,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,MAAM,CAOhE"}

package/dist/IdType.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdType = void 0;
+exports.resolveIdType = resolveIdType;
+/**
+ * 主键生成策略（对齐 MyBatis-Plus IdType）
+ *
+ * @example
+ * @TableId({ type: IdType.ASSIGN_ID })
+ * id!: string;
+ */
+var IdType;
+(function (IdType) {
+    /** 数据库自增（不向 INSERT 写入 id，插入后回填） */
+    IdType["AUTO"] = "AUTO";
+    /** 未设置：跟随全局 configureOrm / ORM_ID_TYPE */
+    IdType["NONE"] = "NONE";
+    /** 插入前自行赋值，框架不生成 */
+    IdType["INPUT"] = "INPUT";
+    /** 雪花算法分配（空才生成），适合 number / string */
+    IdType["ASSIGN_ID"] = "ASSIGN_ID";
+    /** UUID（去横线）分配，适合 string */
+    IdType["ASSIGN_UUID"] = "ASSIGN_UUID";
+})(IdType || (exports.IdType = IdType = {}));
+function resolveIdType(value) {
+    if (value == null || value === "")
+        return IdType.NONE;
+    const key = String(value).toUpperCase();
+    if (key in IdType) {
+        return IdType[key];
+    }
+    throw new Error(`不支持的 IdType: ${value}`);
+}
+//# sourceMappingURL=IdType.js.map

package/dist/IdType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IdType.js","sourceRoot":"","sources":["../src/IdType.ts"],"names":[],"mappings":";;;AAsBA,sCAOC;AA7BD;;;;;;GAMG;AACH,IAAY,MAWX;AAXD,WAAY,MAAM;IAChB,mCAAmC;IACnC,uBAAa,CAAA;IACb,0CAA0C;IAC1C,uBAAa,CAAA;IACb,oBAAoB;IACpB,yBAAe,CAAA;IACf,sCAAsC;IACtC,iCAAuB,CAAA;IACvB,4BAA4B;IAC5B,qCAA2B,CAAA;AAC7B,CAAC,EAXW,MAAM,sBAAN,MAAM,QAWjB;AAID,SAAgB,aAAa,CAAC,KAA0B;IACtD,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IACtD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IACxC,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;QAClB,OAAO,MAAM,CAAC,GAA0B,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,gBAAgB,KAAK,EAAE,CAAC,CAAC;AAC3C,CAAC"}

package/dist/QueryWrapper.d.ts

@@ -0,0 +1,110 @@
+import type { SqlFragment } from "./types";
+import { type Dialect, type DbType } from "./dialect";
+export { assertIdent } from "./security";
+export interface QueryWrapperOptions {
+    /** 方言或数据库类型，影响列名引号；默认 mysql */
+    dialect?: Dialect | DbType | string;
+}
+/**
+ * 条件构造器（对齐 MyBatis-Plus QueryWrapper 常用 API）
+ * 列名白名单校验，值一律参数绑定。
+ *
+ * @example
+ * new QueryWrapper().select('id', 'username').eq('status', 1).orderByDesc('id')
+ * new QueryWrapper({ dialect: "postgresql" }).eq("status", 1)
+ */
+export declare class QueryWrapper {
+    private conditions;
+    private orders;
+    private selectColumns;
+    private groupColumns;
+    private havingClauses;
+    private lastSqlText;
+    private nextJoin;
+    private skipLogicDelete;
+    private readonly dialect;
+    constructor(options?: QueryWrapperOptions | Dialect | DbType | string);
+    getDialect(): Dialect;
+    /** 本条查询忽略逻辑删除条件（查回收站等） */
+    ignoreLogicDelete(): this;
+    isIgnoreLogicDelete(): boolean;
+    /** 复制一份，避免 Mapper 追加逻辑删除时改到调用方 */
+    clone(): QueryWrapper;
+    /** 下一条件用 OR 连接 */
+    or(): this;
+    /** 下一条件用 AND 连接（默认） */
+    and(): this;
+    private add;
+    private col;
+    /**
+     * 指定查询列；不传则默认 SELECT *
+     * @example wrapper.select('id', 'username', 'status')
+     */
+    select(...columns: string[]): this;
+    eq(column: string, value: unknown): this;
+    /** field = value OR field IS NULL（兼容历史未填逻辑删除字段的数据） */
+    eqOrIsNull(column: string, value: unknown): this;
+    ne(column: string, value: unknown): this;
+    gt(column: string, value: unknown): this;
+    ge(column: string, value: unknown): this;
+    lt(column: string, value: unknown): this;
+    le(column: string, value: unknown): this;
+    private likePattern;
+    /** 模糊查询；已转义 % / _，避免通配符注入 */
+    like(column: string, value: string): this;
+    /** 左模糊：`%value`（对齐 MP likeLeft） */
+    likeLeft(column: string, value: string): this;
+    /** 右模糊：`value%`（对齐 MP likeRight） */
+    likeRight(column: string, value: string): this;
+    /** `NOT LIKE %value%`（已转义通配符） */
+    notLike(column: string, value: string): this;
+    /**
+     * EXISTS (子查询)。子查询自行保证安全；参数走绑定。
+     * @example wrapper.exists('SELECT 1 FROM role_user ru WHERE ru.user_id = t.id AND ru.role_id = ?', [1])
+     */
+    exists(sql: string, params?: unknown[]): this;
+    /** NOT EXISTS (子查询) */
+    notExists(sql: string, params?: unknown[]): this;
+    /**
+     * 追加自定义条件片段（参数绑定）。
+     * 仅用于无法用 eq/like 表达的括号 OR 等场景；列名须自行保证安全。
+     */
+    apply(sql: string, params?: unknown[]): this;
+    /** 括号分组：fn 内条件作为整体与外层 AND/OR 连接（内层沿用本 Wrapper 方言） */
+    nested(fn: (w: QueryWrapper) => void): this;
+    /** 大数组按 batchInSize 拆成多个 IN，用 OR / AND 连接 */
+    private inChunks;
+    in(column: string, values: unknown[]): this;
+    /** `NOT IN (...)`；空数组视为永真（不加限制），与 in([]) 永假对称 */
+    notIn(column: string, values: unknown[]): this;
+    between(column: string, start: unknown, end: unknown): this;
+    notBetween(column: string, start: unknown, end: unknown): this;
+    /**
+     * 按已注册数据源方言创建 Wrapper（避免默认 mysql 引号用在 PG/MSSQL 上）。
+     * @example QueryWrapper.forDatasource("postgresql").eq("status", 1)
+     */
+    static forDatasource(name?: string): QueryWrapper;
+    isNull(column: string): this;
+    isNotNull(column: string): this;
+    orderByAsc(column: string): this;
+    orderByDesc(column: string): this;
+    /**
+     * GROUP BY 列（白名单标识符）。可多次调用追加。
+     * @example wrapper.select("status").groupBy("status")
+     */
+    groupBy(...columns: string[]): this;
+    /**
+     * HAVING 条件（参数绑定）。可多次调用，以 AND 连接。
+     * 聚合表达式由调用方书写，列名请自行保证安全。
+     * @example wrapper.groupBy("status").having("COUNT(*) > ?", [1])
+     */
+    having(sql: string, params?: unknown[]): this;
+    /**
+     * 追加安全白名单片段（禁止任意 SQL）。
+     * 仅允许：LIMIT n [OFFSET m] / FOR UPDATE / LOCK IN SHARE MODE
+     */
+    last(sql: string): this;
+    /** 生成 SELECT / WHERE / GROUP BY / HAVING / ORDER BY / LAST 片段 */
+    build(): SqlFragment;
+}
+//# sourceMappingURL=QueryWrapper.d.ts.map

package/dist/QueryWrapper.d.ts.map

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