@pangza/orm 0.0.0-stage → 1.0.0

package/dist/sqlDecorators.js

@@ -0,0 +1,147 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Delete = exports.Update = exports.Insert = exports.MAPPER_ENTITY_KEY = void 0;
+exports.Param = Param;
+exports.Select = Select;
+require("reflect-metadata");
+const Db_1 = __importDefault(require("./Db"));
+const fieldSelect_1 = require("./fieldSelect");
+const resultMap_1 = require("./resultMap");
+const sqlTemplate_1 = require("./sqlTemplate");
+const PARAM_NAMES_KEY = Symbol.for("pangza.orm.sqlParamNames");
+/** Mapper 类上挂的实体（供方法级 @Select 结果自动填充字段 @Select） */
+exports.MAPPER_ENTITY_KEY = Symbol.for("pangza.orm.mapperEntity");
+function resolveDatasource(options) {
+    if (options?.datasource?.trim()) {
+        return options.datasource.trim();
+    }
+    if (options?.db) {
+        return Db_1.default.findByType(options.db);
+    }
+    return "default";
+}
+function getNamedParams(target, methodName) {
+    return (Reflect.getOwnMetadata(PARAM_NAMES_KEY, target, methodName) ?? {});
+}
+/**
+ * @Param("id")
+ * 为方法参数命名，供 SQL 中 #{id} / ${id} 引用。
+ */
+function Param(name) {
+    return (target, propertyKey, parameterIndex) => {
+        if (propertyKey === undefined)
+            return;
+        const key = String(name).trim();
+        if (!key) {
+            throw new Error("@Param 名称不能为空");
+        }
+        const map = {
+            ...getNamedParams(target, propertyKey),
+            [parameterIndex]: key,
+        };
+        Reflect.defineMetadata(PARAM_NAMES_KEY, map, target, propertyKey);
+    };
+}
+function createSqlMethodDecorator(kind) {
+    return (sql, options) => {
+        if (!sql || !String(sql).trim()) {
+            throw new Error(`@${kind[0].toUpperCase()}${kind.slice(1)} SQL 不能为空`);
+        }
+        const template = String(sql);
+        const datasource = resolveDatasource(options);
+        return (target, propertyKey, descriptor) => {
+            const methodName = String(propertyKey);
+            const named = () => getNamedParams(target, propertyKey);
+            const executor = async function (...args) {
+                const ctx = (0, sqlTemplate_1.buildParamContext)(args, named());
+                const parsed = (0, sqlTemplate_1.parseMybatisSql)(template, ctx);
+                const result = await Db_1.default.queryOn(datasource, parsed.sql, parsed.params);
+                if (kind === "select") {
+                    // 方法级 @Select 常用于批量查询，不自动填字段 @Select，避免 N+1。
+                    // 需要时：hydrateFieldSelects(Entity, rows, { datasource })
+                    return (0, resultMap_1.mapResultRows)(result ?? []);
+                }
+                const dialect = Db_1.default.getDialect(datasource);
+                if (kind === "insert") {
+                    // 自定义 INSERT 若含 RETURNING / OUTPUT，优先取第一行第一列
+                    if (Array.isArray(result) && result[0] && typeof result[0] === "object") {
+                        const row = result[0];
+                        const first = Object.values(row)[0];
+                        if (first != null)
+                            return Number(first);
+                    }
+                    return dialect.extractInsertId(result, "id", false);
+                }
+                return dialect.extractAffectedRows(result);
+            };
+            executor[Symbol.for("pangza.orm.sqlBound")] = kind;
+            if (descriptor) {
+                descriptor.value = executor;
+                return descriptor;
+            }
+            Object.defineProperty(target, methodName, {
+                value: executor,
+                writable: true,
+                configurable: true,
+            });
+        };
+    };
+}
+/**
+ * @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[];
+ */
+function Select(sql, options) {
+    const template = String(sql ?? "").trim();
+    if (!template) {
+        throw new Error("@Select SQL 不能为空");
+    }
+    return ((target, propertyKey, descriptor) => {
+        // 方法装饰器：descriptor.value 为函数
+        if (propertyKey !== undefined &&
+            descriptor &&
+            typeof descriptor.value === "function") {
+            return createSqlMethodDecorator("select")(template, options)(target, propertyKey, descriptor);
+        }
+        // 属性装饰器
+        if (propertyKey === undefined) {
+            throw new Error("@Select 不能用于类");
+        }
+        const ctor = target.constructor;
+        (0, fieldSelect_1.registerFieldSelect)(ctor, String(propertyKey), template, options);
+    });
+}
+/**
+ * @Insert("INSERT INTO user(name) VALUES(#{name})")
+ * 返回 insertId；PostgreSQL / SQL Server 建议在 SQL 中写 RETURNING / OUTPUT。
+ *
+ * @example
+ * @Insert("INSERT INTO user(name) VALUES(#{name})", { datasource: "pg" })
+ */
+exports.Insert = createSqlMethodDecorator("insert");
+/**
+ * @Update("UPDATE user SET name = #{name} WHERE id = #{id}")
+ * 返回 affectedRows。
+ */
+exports.Update = createSqlMethodDecorator("update");
+/**
+ * @Delete("DELETE FROM user WHERE id = #{id}")
+ * 返回 affectedRows（物理删除；逻辑删除请用 BaseMapper.delete*）。
+ */
+exports.Delete = createSqlMethodDecorator("delete");
+//# sourceMappingURL=sqlDecorators.js.map

package/dist/sqlDecorators.js.map

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

package/dist/sqlLog.d.ts

@@ -0,0 +1,30 @@
+import type { SqlLogFormatFn, SqlLogInfo, SqlLogParts } from "./types";
+declare const DEFAULT_FORMAT = "{time} [{type}] {cost}ms | {sql} | params={params}";
+export interface SqlLogRuntime {
+    enabled: boolean;
+    /** 占位符模板，或自定义函数 */
+    format: string | SqlLogFormatFn;
+    /** 控制输出哪些片段（模板里对应占位符为空时跳过） */
+    parts: Required<SqlLogParts>;
+    /** pino 级别 */
+    level: "trace" | "debug" | "info" | "warn";
+}
+export declare function getSqlLogRuntime(): SqlLogRuntime;
+export declare function configureSqlLog(patch?: Partial<{
+    enabled: boolean;
+    format: string | SqlLogFormatFn;
+    parts: SqlLogParts;
+    level: SqlLogRuntime["level"];
+}>): void;
+/** 从 SQL 推断类型：SELECT / INSERT / UPDATE / DELETE / OTHER */
+export declare function detectSqlType(sql: string): string;
+/**
+ * 默认模板替换。
+ * 占位符：{time} {type} {sql} {params} {cost}
+ * 若某 part 关闭，对应占位符替换为空，并清理多余分隔符。
+ */
+export declare function renderSqlLog(info: SqlLogInfo, format?: string | SqlLogFormatFn, parts?: Required<SqlLogParts>): string;
+/** 执行前后包装：记录耗时并按配置输出 */
+export declare function withSqlLog<T>(sql: string, params: unknown[], run: () => Promise<T>): Promise<T>;
+export { DEFAULT_FORMAT as DEFAULT_SQL_LOG_FORMAT };
+//# sourceMappingURL=sqlLog.d.ts.map

package/dist/sqlLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlLog.d.ts","sourceRoot":"","sources":["../src/sqlLog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAIvE,QAAA,MAAM,cAAc,uDACkC,CAAC;AAUvD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB;IACnB,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC;IAChC,8BAA8B;IAC9B,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC7B,cAAc;IACd,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;CAC5C;AASD,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED,wBAAgB,eAAe,CAC7B,KAAK,GAAE,OAAO,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC;IAChC,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CAC/B,CAAM,GACN,IAAI,CAON;AAED,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQjD;AA0DD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,UAAU,EAChB,MAAM,GAAE,MAAM,GAAG,cAA+B,EAChD,KAAK,GAAE,QAAQ,CAAC,WAAW,CAAiB,GAC3C,MAAM,CAmCR;AAED,wBAAwB;AACxB,wBAAsB,UAAU,CAAC,CAAC,EAChC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,OAAO,EAAE,EACjB,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,CAAC,CAAC,CAuDZ;AAED,OAAO,EAAE,cAAc,IAAI,sBAAsB,EAAE,CAAC"}

package/dist/sqlLog.js

@@ -0,0 +1,183 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SQL_LOG_FORMAT = void 0;
+exports.getSqlLogRuntime = getSqlLogRuntime;
+exports.configureSqlLog = configureSqlLog;
+exports.detectSqlType = detectSqlType;
+exports.renderSqlLog = renderSqlLog;
+exports.withSqlLog = withSqlLog;
+const Logger_1 = require("@pangza/core/Logger");
+const log = (0, Logger_1.getLogger)("ORM.SQL");
+const DEFAULT_FORMAT = "{time} [{type}] {cost}ms | {sql} | params={params}";
+exports.DEFAULT_SQL_LOG_FORMAT = DEFAULT_FORMAT;
+const DEFAULT_PARTS = {
+    time: true,
+    type: true,
+    sql: true,
+    params: true,
+    cost: true,
+};
+let runtime = {
+    enabled: false,
+    format: DEFAULT_FORMAT,
+    parts: { ...DEFAULT_PARTS },
+    level: "info",
+};
+function getSqlLogRuntime() {
+    return runtime;
+}
+function configureSqlLog(patch = {}) {
+    runtime = {
+        enabled: patch.enabled ?? runtime.enabled,
+        format: patch.format ?? runtime.format,
+        parts: { ...runtime.parts, ...(patch.parts ?? {}) },
+        level: patch.level ?? runtime.level,
+    };
+}
+/** 从 SQL 推断类型：SELECT / INSERT / UPDATE / DELETE / OTHER */
+function detectSqlType(sql) {
+    const m = String(sql)
+        .trim()
+        .match(/^(WITH|SELECT|INSERT|UPDATE|DELETE|REPLACE|CALL|SHOW|DESCRIBE|EXPLAIN|SET|BEGIN|COMMIT|ROLLBACK)\b/i);
+    if (!m)
+        return "OTHER";
+    const raw = m[1].toUpperCase();
+    if (raw === "WITH")
+        return "SELECT";
+    return raw;
+}
+function formatTime(date) {
+    const pad = (n, len = 2) => String(n).padStart(len, "0");
+    return (`${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ` +
+        `${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}.` +
+        `${pad(date.getMilliseconds(), 3)}`);
+}
+/** 日志参数脱敏：键名含这些片段时替换为 *** */
+const SENSITIVE_KEY_RE = /password|passwd|pwd|secret|token|authorization|credential|private.?key|access.?key/i;
+function walkRedact(value, key) {
+    if (key && SENSITIVE_KEY_RE.test(key))
+        return "***";
+    if (typeof value === "bigint")
+        return value.toString();
+    if (value instanceof Date)
+        return value.toISOString();
+    if (Buffer.isBuffer(value))
+        return `<Buffer ${value.length}b>`;
+    if (Array.isArray(value)) {
+        return value.map((item, i) => walkRedact(item, String(i)));
+    }
+    if (value !== null && typeof value === "object") {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            out[k] = walkRedact(v, k);
+        }
+        return out;
+    }
+    return value;
+}
+function safeParams(params) {
+    try {
+        return JSON.stringify(params.map((p) => walkRedact(p)));
+    }
+    catch {
+        return String(params);
+    }
+}
+function compactSql(sql) {
+    return String(sql).replace(/\s+/g, " ").trim();
+}
+function applyParts(info, parts) {
+    return {
+        time: parts.time ? info.time : "",
+        type: parts.type ? info.type : "",
+        sql: parts.sql ? info.sql : "",
+        params: parts.params ? info.paramsText : "",
+        cost: parts.cost ? String(info.cost) : "",
+    };
+}
+/**
+ * 默认模板替换。
+ * 占位符：{time} {type} {sql} {params} {cost}
+ * 若某 part 关闭，对应占位符替换为空，并清理多余分隔符。
+ */
+function renderSqlLog(info, format = runtime.format, parts = runtime.parts) {
+    if (typeof format === "function") {
+        return format(info);
+    }
+    const values = applyParts(info, parts);
+    let out = String(format).replace(/\{(time|type|sql|params|cost)\}/g, (_m, key) => values[key] ?? "");
+    // 清理因关闭某段产生的空标签 / 多余分隔
+    out = out
+        .replace(/\bparams=\s*(?=\||$)/gi, "")
+        .replace(/\s*\|\s*\|/g, " |")
+        .replace(/\[\s*\]/g, "")
+        .replace(/\s{2,}/g, " ")
+        .replace(/\s+\|/g, " |")
+        .replace(/\|\s+/g, "| ")
+        .replace(/^\s*\|\s*/, "")
+        .replace(/\s*\|\s*$/, "")
+        .trim();
+    // 默认模板 `{cost}ms`：cost 关闭时去掉孤立 ms
+    if (!parts.cost) {
+        out = out
+            .replace(/(^|\|\s*)ms(\s*\||$)/g, "$1$2")
+            .replace(/\s+ms$/g, "")
+            .replace(/\s*\|\s*\|/g, " |")
+            .replace(/^\s*\|\s*/, "")
+            .replace(/\s*\|\s*$/, "")
+            .trim();
+    }
+    return out;
+}
+/** 执行前后包装：记录耗时并按配置输出 */
+async function withSqlLog(sql, params, run) {
+    if (!runtime.enabled) {
+        return run();
+    }
+    const startedAt = Date.now();
+    const startDate = new Date(startedAt);
+    try {
+        const result = await run();
+        const cost = Date.now() - startedAt;
+        const info = {
+            time: formatTime(startDate),
+            type: detectSqlType(sql),
+            sql: compactSql(sql),
+            params,
+            paramsText: safeParams(params),
+            cost,
+            error: false,
+        };
+        const message = renderSqlLog(info);
+        // 结构化字段 + 消息，避免仅依赖 msg 在部分终端丢编码
+        log[runtime.level]({
+            sqlType: info.type,
+            cost: info.cost,
+            sql: info.sql,
+            params: info.params,
+        }, message);
+        return result;
+    }
+    catch (err) {
+        const cost = Date.now() - startedAt;
+        const info = {
+            time: formatTime(startDate),
+            type: detectSqlType(sql),
+            sql: compactSql(sql),
+            params,
+            paramsText: safeParams(params),
+            cost,
+            error: true,
+        };
+        const message = renderSqlLog(info);
+        log.error({
+            err,
+            sqlType: info.type,
+            cost: info.cost,
+            sql: info.sql,
+            params: info.params,
+        }, message);
+        throw err;
+    }
+}
+//# sourceMappingURL=sqlLog.js.map

package/dist/sqlLog.js.map

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

package/dist/sqlTemplate.d.ts

@@ -0,0 +1,38 @@
+/**
+ * MyBatis 风格 SQL 模板：
+ * - #{name}  → ? 占位 + 参数绑定（防注入）
+ * - ${name}  → 字符串直接替换（仅用于可信标识符等，勿接用户输入）
+ * - 支持 #{id, jdbcType=INTEGER} 形式（忽略逗号后选项）
+ */
+export interface ParsedSql {
+    sql: string;
+    params: unknown[];
+}
+declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/** 从对象取 a.b.c 路径 */
+export declare function getPath(root: unknown, path: string): unknown;
+/**
+ * 从方法实参构建命名参数表（对齐 MyBatis 常用约定）：
+ * - @Param("x") 标注的名字
+ * - param1 / param2 ...（从 1 起）
+ * - arg0 / arg1 ...
+ * - 单参数且为对象：展开其字段
+ * - 单参数原始值：任意 #{name} 都映射到该值
+ */
+export declare function buildParamContext(args: unknown[], namedByIndex?: Record<number, string>): Record<string, unknown>;
+export interface ParseSqlOptions {
+    /**
+     * 为 true 时不打印 `${}` 告警（仍做危险字符校验）。
+     * 仅用于框架内部已知安全的模板。
+     */
+    silenceDollarWarn?: boolean;
+}
+/**
+ * 解析含 #{} / ${} 的 SQL。
+ * 按出现顺序处理；${} 直接拼进 SQL，#{} 变为 ? 并收集 params。
+ *
+ * 安全：优先使用 `#{}`。`${}` 仅用于可信标识符；含 `;`/`--`/引号/SQL 关键字等会抛错，并默认打告警。
+ */
+export declare function parseMybatisSql(template: string, ctx: Record<string, unknown>, options?: ParseSqlOptions): ParsedSql;
+export { isPlainObject };
+//# sourceMappingURL=sqlTemplate.d.ts.map

package/dist/sqlTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlTemplate.d.ts","sourceRoot":"","sources":["../src/sqlTemplate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAID,iBAAS,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQvE;AAED,oBAAoB;AACpB,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAS5D;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EAAE,EACf,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACxC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzB;AAgCD,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAID;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,CAAC,EAAE,eAAe,GACxB,SAAS,CA6BX;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/sqlTemplate.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * MyBatis 风格 SQL 模板：
+ * - #{name}  → ? 占位 + 参数绑定（防注入）
+ * - ${name}  → 字符串直接替换（仅用于可信标识符等，勿接用户输入）
+ * - 支持 #{id, jdbcType=INTEGER} 形式（忽略逗号后选项）
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPath = getPath;
+exports.buildParamContext = buildParamContext;
+exports.parseMybatisSql = parseMybatisSql;
+exports.isPlainObject = isPlainObject;
+const PLACEHOLDER_RE = /([#$])\{([^}]+)\}/g;
+function isPlainObject(value) {
+    return (value !== null &&
+        typeof value === "object" &&
+        !Array.isArray(value) &&
+        !(value instanceof Date) &&
+        !(value instanceof Buffer));
+}
+/** 从对象取 a.b.c 路径 */
+function getPath(root, path) {
+    if (!path)
+        return undefined;
+    const parts = path.split(".").map((p) => p.trim()).filter(Boolean);
+    let cur = root;
+    for (const part of parts) {
+        if (cur == null || typeof cur !== "object")
+            return undefined;
+        cur = cur[part];
+    }
+    return cur;
+}
+/**
+ * 从方法实参构建命名参数表（对齐 MyBatis 常用约定）：
+ * - @Param("x") 标注的名字
+ * - param1 / param2 ...（从 1 起）
+ * - arg0 / arg1 ...
+ * - 单参数且为对象：展开其字段
+ * - 单参数原始值：任意 #{name} 都映射到该值
+ */
+function buildParamContext(args, namedByIndex = {}) {
+    const ctx = {};
+    args.forEach((arg, i) => {
+        ctx[`param${i + 1}`] = arg;
+        ctx[`arg${i}`] = arg;
+        const named = namedByIndex[i];
+        if (named)
+            ctx[named] = arg;
+    });
+    if (args.length === 1) {
+        const only = args[0];
+        if (isPlainObject(only)) {
+            Object.assign(ctx, only);
+        }
+        else {
+            ctx.__single__ = only;
+        }
+    }
+    return ctx;
+}
+function resolveExpr(ctx, rawExpr) {
+    // #{id, jdbcType=INTEGER} → id
+    const key = rawExpr.split(",")[0].trim();
+    if (!key) {
+        throw new Error("SQL 占位符名不能为空");
+    }
+    if (Object.prototype.hasOwnProperty.call(ctx, key)) {
+        return ctx[key];
+    }
+    const nested = getPath(ctx, key);
+    if (nested !== undefined) {
+        return nested;
+    }
+    if (Object.prototype.hasOwnProperty.call(ctx, "__single__")) {
+        return ctx.__single__;
+    }
+    throw new Error(`[SQL] 找不到参数: ${key}`);
+}
+/** ${} 危险片段：拒绝拼进 SQL */
+const DOLLAR_UNSAFE_RE = /;|--|\/\*|\*\/|'|"|\\|\b(union|select|insert|update|delete|drop|alter|exec|execute)\b/i;
+let dollarWarnCount = 0;
+/**
+ * 解析含 #{} / ${} 的 SQL。
+ * 按出现顺序处理；${} 直接拼进 SQL，#{} 变为 ? 并收集 params。
+ *
+ * 安全：优先使用 `#{}`。`${}` 仅用于可信标识符；含 `;`/`--`/引号/SQL 关键字等会抛错，并默认打告警。
+ */
+function parseMybatisSql(template, ctx, options) {
+    const params = [];
+    const sql = String(template).replace(PLACEHOLDER_RE, (_whole, kind, expr) => {
+        const value = resolveExpr(ctx, expr);
+        if (kind === "$") {
+            if (value === undefined || value === null) {
+                throw new Error(`[SQL] \${${expr.trim()}} 的值不能为空`);
+            }
+            const text = String(value);
+            if (DOLLAR_UNSAFE_RE.test(text)) {
+                throw new Error(`[SQL] \${${expr.trim()}} 的值含有危险字符或关键字，已拒绝。请改用 #{} 参数绑定，或仅传入可信标识符`);
+            }
+            if (!options?.silenceDollarWarn && dollarWarnCount < 20) {
+                dollarWarnCount += 1;
+                console.warn(`[ORM] SQL 使用了 \${${expr.trim()}} 字符串拼接，存在注入风险；仅可用于可信表名/列名。优先改用 #{}。`);
+            }
+            return text;
+        }
+        params.push(value);
+        return "?";
+    });
+    return { sql, params };
+}
+//# sourceMappingURL=sqlTemplate.js.map

package/dist/sqlTemplate.js.map

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

package/dist/table.d.ts

@@ -0,0 +1,17 @@
+import { BaseMapper } from "./BaseMapper";
+import type { MapperOptions, MapperTableOptions } from "./types";
+declare function normalizeOptions(tableName: string, idFieldOrOptions?: string | MapperTableOptions): MapperOptions;
+/**
+ * 获取表对应的 BaseMapper（单例缓存）
+ *
+ * @example
+ * await table('user').selectById(1)
+ * await table('user', { logicDelete: true }).selectList()
+ */
+export declare function table<T extends Record<string, any> = Record<string, any>>(tableName: string, idFieldOrOptions?: string | MapperTableOptions): BaseMapper<T>;
+/** 清除 Mapper 缓存（一般仅测试用；改全局 ORM 配置后可调用） */
+export declare function clearTableCache(): void;
+/** useTable 别名，语义更贴近 hooks 风格 */
+export declare const useTable: typeof table;
+export { normalizeOptions };
+//# sourceMappingURL=table.d.ts.map

package/dist/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../src/table.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAKjE,iBAAS,gBAAgB,CACvB,SAAS,EAAE,MAAM,EACjB,gBAAgB,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAC7C,aAAa,CAKf;AAmBD;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACvE,SAAS,EAAE,MAAM,EACjB,gBAAgB,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAC7C,UAAU,CAAC,CAAC,CAAC,CASf;AAED,0CAA0C;AAC1C,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED,iCAAiC;AACjC,eAAO,MAAM,QAAQ,cAAQ,CAAC;AAE9B,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/table.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTable = void 0;
+exports.table = table;
+exports.clearTableCache = clearTableCache;
+exports.normalizeOptions = normalizeOptions;
+const BaseMapper_1 = require("./BaseMapper");
+/** 按表配置缓存 Mapper，避免重复 new */
+const mapperCache = new Map();
+function normalizeOptions(tableName, idFieldOrOptions) {
+    if (typeof idFieldOrOptions === "string" || idFieldOrOptions === undefined) {
+        return { table: tableName, idField: idFieldOrOptions ?? "id" };
+    }
+    return { table: tableName, idField: "id", ...idFieldOrOptions };
+}
+function cacheKey(options) {
+    return JSON.stringify({
+        table: options.table,
+        idField: options.idField ?? "id",
+        datasource: options.datasource ?? "default",
+        logicDelete: options.logicDelete ?? null,
+        logicDeleteField: options.logicDeleteField ?? null,
+        logicDeleteValue: options.logicDeleteValue ?? null,
+        logicNotDeleteValue: options.logicNotDeleteValue ?? null,
+        optimisticLock: options.optimisticLock ?? null,
+        versionField: options.versionField ?? null,
+        fill: options.fill ?? null,
+        updateNullStrategy: options.updateNullStrategy ?? null,
+        entity: options.entity?.name ?? null,
+    });
+}
+/**
+ * 获取表对应的 BaseMapper（单例缓存）
+ *
+ * @example
+ * await table('user').selectById(1)
+ * await table('user', { logicDelete: true }).selectList()
+ */
+function table(tableName, idFieldOrOptions) {
+    const options = normalizeOptions(tableName, idFieldOrOptions);
+    const key = cacheKey(options);
+    let mapper = mapperCache.get(key);
+    if (!mapper) {
+        mapper = new BaseMapper_1.BaseMapper(options);
+        mapperCache.set(key, mapper);
+    }
+    return mapper;
+}
+/** 清除 Mapper 缓存（一般仅测试用；改全局 ORM 配置后可调用） */
+function clearTableCache() {
+    mapperCache.clear();
+}
+/** useTable 别名，语义更贴近 hooks 风格 */
+exports.useTable = table;
+//# sourceMappingURL=table.js.map

package/dist/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../src/table.ts"],"names":[],"mappings":";;;AAwCA,sBAYC;AAGD,0CAEC;AAKQ,4CAAgB;AA9DzB,6CAA0C;AAG1C,6BAA6B;AAC7B,MAAM,WAAW,GAAG,IAAI,GAAG,EAA2B,CAAC;AAEvD,SAAS,gBAAgB,CACvB,SAAiB,EACjB,gBAA8C;IAE9C,IAAI,OAAO,gBAAgB,KAAK,QAAQ,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC3E,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,IAAI,IAAI,EAAE,CAAC;IACjE,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,gBAAgB,EAAE,CAAC;AAClE,CAAC;AAED,SAAS,QAAQ,CAAC,OAAsB;IACtC,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAChC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,SAAS;QAC3C,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;QACxC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,IAAI;QAClD,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,IAAI;QAClD,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,IAAI,IAAI;QACxD,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI;QAC9C,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;QAC1C,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;QAC1B,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,IAAI;QACtD,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,IAAI,IAAI;KACrC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,KAAK,CACnB,SAAiB,EACjB,gBAA8C;IAE9C,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9B,IAAI,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAA8B,CAAC;IAC/D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,IAAI,uBAAU,CAAI,OAAO,CAAC,CAAC;QACpC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,0CAA0C;AAC1C,SAAgB,eAAe;IAC7B,WAAW,CAAC,KAAK,EAAE,CAAC;AACtB,CAAC;AAED,iCAAiC;AACpB,QAAA,QAAQ,GAAG,KAAK,CAAC"}