/** * 数据库工具的公共小工具 */ import mongoose from "mongoose"; /** * 转义正则元字符,用于把用户/模型输入当作字面量做模糊匹配 * * 直接把输入拼进 $regex 有两个问题:用户输入 "(" 会导致查询报错, * 输入嵌套量词(如 (a+)+$)可能触发 ReDoS。这里统一转义并截断长度。 * * @param {string} input 原始关键词 * @param {number} maxLength 最大参与匹配的长度 * @returns {string} */ function escapeRegex(input, maxLength = 64) { if (typeof input !== "string") return ""; return input .slice(0, maxLength) .replace(/[.*+?^${}()|[\]\\]/g, "\\$&"); } /** * 严格解析 ObjectId * * 用固定 24 位十六进制格式校验,而不是 isValid(后者对部分非标准字符串也返回 true)。 * 非法值返回 null,供工具提前返回错误,避免 Mongoose CastError 或把字符串直接带进查询。 * * @param {*} value 待解析的 ID * @returns {mongoose.Types.ObjectId|null} */ function parseObjectId(value) { if (value === null || value === undefined) return null; const raw = typeof value === "string" ? value.trim() : String(value); if (!/^[0-9a-fA-F]{24}$/.test(raw)) return null; return new mongoose.Types.ObjectId(raw); } export { escapeRegex, parseObjectId };