chanjs 2.7.2 → 2.7.4

package/helper/rate-limit.js

@@ -1,116 +0,0 @@
-import { isIgnored } from "./checker.js";
-import { getIp } from "../helper/ip.js";
-
-/**
- * 访问频率限制工具
- * 提供基于 IP 和 Cookie 的访问限流功能
- */
-
-const COOKIE_NAME = `${process.env.APP_NAME || 'app'}_ratelimit`;
-
-/**
- * 解析时间窗口参数
- * @private
- * @param {number|string} time - 时间值
- * @returns {number} 毫秒数
- * @description
- * 支持以下格式：
- * - 数字：直接作为毫秒数
- * - 数字+s：秒
- * - 数字+m：分钟
- * - 数字+h：小时
- * - 数字+d：天
- */
-function parseWindowMs(time) {
-  if (typeof time === 'number') return time;
-  if (typeof time !== 'string') return 60 * 60 * 1000;
-
-  const match = time.match(/^(\d+)([smhd])$/);
-  if (!match) return 60 * 60 * 1000;
-
-  const value = parseInt(match[1], 10);
-  const unit = match[2];
-
-  const multipliers = {
-    's': 1000,
-    'm': 60 * 1000,
-    'h': 60 * 60 * 1000,
-    'd': 24 * 60 * 60 * 1000,
-  };
-
-  return value * (multipliers[unit] || 1000);
-}
-
-/**
- * 创建限流中间件
- * @param {Object} rateLimitConfig - 限流配置
- * @param {number|string} rateLimitConfig.windowMs - 时间窗口
- * @param {number} rateLimitConfig.max - 最大请求次数
- * @param {Array<string>} [rateLimitConfig.ignorePaths] - 忽略的路径数组
- * @returns {Function} Express 中间件函数
- * @description
- * 基于客户端 IP 实现滑动窗口限流算法
- * 使用 Cookie 存储限流状态，避免内存泄漏
- * @example
- * const rateLimiter = createRateLimitMiddleware({
- *   windowMs: '1m',
- *   max: 60,
- *   ignorePaths: ['/health']
- * });
- */
-export function createRateLimitMiddleware(rateLimitConfig) {
-  const config = {
-    ...rateLimitConfig,
-    windowMs: parseWindowMs(rateLimitConfig?.windowMs),
-  };
-
-  return (req, res, next) => {
-    try {
-      if (isIgnored(req.path, config.ignorePaths)) {
-        return next();
-      }
-
-      const now = Date.now();
-      const ip = getIp(req);
-      const cookieValue = req.cookies && req.cookies[COOKIE_NAME];
-      let currentData = null;
-
-      if (cookieValue) {
-        try {
-          currentData = JSON.parse(cookieValue);
-          if (currentData && currentData.ip !== ip) {
-            currentData = null;
-          }
-        } catch (e) {
-          currentData = null;
-        }
-      }
-
-      let newData;
-      if (!currentData || now > currentData.resetTime) {
-        newData = { count: 1, resetTime: now + config.windowMs, ip };
-      } else if (currentData.count >= config.max) {
-        console.error(`[WAF 限流拦截] 路径:${req.path} 计数:${currentData.count}/${config.max} IP:${ip}`);
-        return res.status(429).json({
-          code: 429,
-          success: false,
-          msg: '请求过于频繁，请稍后重试',
-          retryAfter: Math.ceil((currentData.resetTime - now) / 1000),
-        });
-      } else {
-        newData = { count: currentData.count + 1, resetTime: currentData.resetTime, ip };
-      }
-
-      res.cookie(COOKIE_NAME, JSON.stringify(newData), {
-        httpOnly: true,
-        maxAge: config.windowMs,
-        sameSite: 'strict',
-      });
-
-      next();
-    } catch (error) {
-      console.error(`[WAF 限流异常] 路径:${req.path} 错误:${error.message}`);
-      next();
-    }
-  };
-}

package/helper/request.js

@@ -1,47 +0,0 @@
-/**
- * HTTP 请求工具函数
- * 提供统一的请求发送方法
- */
-
-/**
- * 发送 HTTP 请求
- * @async
- * @param {string} url - 请求 URL
- * @param {Object} [options={}] - 请求选项
- * @param {string} [options.method='GET'] - HTTP 方法
- * @param {Object} [options.headers] - 请求头
- * @param {Object|string} [options.body] - 请求体
- * @returns {Promise<Object|null>} 响应数据，失败时返回 null
- * @description
- * 发送 HTTP 请求并返回 JSON 格式的响应数据
- * 自动将对象类型的 body 转换为 JSON 字符串
- * 默认 Content-Type 为 application/json
- * @example
- * const data = await request('https://api.example.com/users', {
- *   method: 'POST',
- *   body: { name: '张三' }
- * });
- */
-export async function request(url, options = {}) {
-  const defaultOptions = {
-    method: 'GET',
-    headers: {
-      'Content-Type': 'application/json',
-    },
-  };
-
-  const finalOptions = { ...defaultOptions, ...options };
-
-  if (finalOptions.body && typeof finalOptions.body !== 'string') {
-    finalOptions.body = JSON.stringify(finalOptions.body);
-  }
-
-  try {
-    const response = await fetch(url, finalOptions);
-    const data = await response.json();
-    return data;
-  } catch (error) {
-    console.error('[Request] 请求失败:', error.message);
-    return null;
-  }
-}

package/helper/response.js

@@ -1,180 +0,0 @@
-import { CODE, DB_ERROR } from "../config/code.js";
-
-/**
- * 响应工具函数
- * 提供统一的响应格式和错误处理
- */
-
-const ERROR_MESSAGES = {
-  6001: "数据库连接失败",
-  6002: "数据库访问被拒绝",
-  6003: "存在关联数据，操作失败",
-  6004: "数据库字段错误",
-  6005: "数据重复，违反唯一性约束",
-  6006: "目标表不存在",
-  6007: "数据库操作超时",
-  6008: "数据库语法错误，请检查查询语句",
-  6009: "数据库连接已关闭，请重试",
-  4003: "资源已存在",
-  5001: "系统内部错误",
-};
-
-/**
- * 获取默认错误代码
- * @private
- * @param {Error} error - 错误对象
- * @returns {number} 错误代码
- */
-const getDefaultErrorCode = (error) => {
-  if (!error?.message) return 5001;
-  if (error.message.includes("syntax") || error.message.includes("SQL")) {
-    return 6008;
-  } else if (error.message.includes("Connection closed")) {
-    return 6009;
-  } else if (error.message.includes("permission")) {
-    return 3003;
-  }
-  return 5001;
-};
-
-/**
- * 解析数据库错误
- * @param {Error} error - 数据库错误对象
- * @returns {Object} 包含 code、msg 和 statusCode 的对象
- * @description
- * 根据数据库错误代码映射为业务状态码
- * 返回对应的错误消息和 HTTP 状态码
- */
-export function parseDatabaseError(error) {
-  const errorCode = error?.code && DB_ERROR[error.code]
-    ? DB_ERROR[error.code]
-    : error?.message?.includes("syntax") || error?.message?.includes("SQL")
-      ? 6008
-      : error?.message?.includes("Connection closed")
-        ? 6009
-        : error?.message?.includes("permission")
-          ? 3003
-          : 5001;
-
-  return {
-    code: errorCode,
-    msg: ERROR_MESSAGES[errorCode] || error?.message || "服务器内部错误",
-    statusCode: errorCode >= 6000 ? 500 : errorCode >= 4000 ? 400 : 500,
-  };
-}
-
-/**
- * 生成错误响应
- * @param {Object} options - 响应选项
- * @param {Error} options.err - 错误对象
- * @param {Object} [options.data={}] - 响应数据
- * @param {number} [options.code=500] - 错误代码
- * @returns {Object} 错误响应对象
- * @description
- * 根据错误类型生成标准错误响应
- * 开发环境下包含数据库错误详情
- */
-export const error = ({ err, data = {}, code = 500 } = {}) => {
-  if (err) {
-    console.error("[DB Error]", err?.message || err);
-    const errorCode = err?.code && DB_ERROR[err.code] ? DB_ERROR[err.code] : getDefaultErrorCode(err);
-    const msg = ERROR_MESSAGES[errorCode] || "操作失败";
-
-    return {
-      success: false,
-      msg,
-      code: errorCode,
-      data: process.env.NODE_ENV === 'development' ? {
-        sql: err?.sql,
-        sqlMessage: err?.sqlMessage,
-        message: err?.message,
-      } : {},
-    };
-  }
-  
-  const msg = CODE[code] || "操作失败";
-  return {
-    success: false,
-    msg,
-    code,
-    data,
-  };
-};
-
-/**
- * 生成失败响应
- * @param {Object} options - 响应选项
- * @param {string} [options.msg="操作失败"] - 错误消息
- * @param {Object} [options.data={}] - 响应数据
- * @param {number} [options.code=201] - 错误代码
- * @returns {Object} 失败响应对象
- */
-export const fail = ({ msg = "操作失败", data = {}, code = 201 } = {}) => {
-  return {
-    success: false,
-    msg,
-    code,
-    data,
-  };
-};
-
-/**
- * 生成成功响应
- * @param {Object} options - 响应选项
- * @param {Object} [options.data={}] - 响应数据
- * @param {string} [options.msg="操作成功"] - 成功消息
- * @returns {Object} 成功响应对象
- */
-export const success = ({ data = {}, msg = "操作成功" } = {}) => ({
-  success: true,
-  msg,
-  code: 200,
-  data,
-});
-
-/**
- * 生成 404 响应
- * @param {Object} req - Express 请求对象
- * @returns {Object} 404 响应对象
- */
-export function notFoundResponse(req) {
-  return {
-    success: false,
-    msg: "接口不存在",
-    code: 404,
-    data: { path: req.path, method: req.method },
-  };
-}
-
-/**
- * 生成错误响应（Express 错误处理中间件用）
- * @param {Error} err - 错误对象
- * @param {Object} req - Express 请求对象
- * @returns {Object} 错误响应对象
- */
-export function errorResponse(err, req) {
-  const errorInfo = parseDatabaseError(err);
-  
-  console.error(`[Error Handler] ${errorInfo.msg} - ${err?.message}`, {
-    code: errorInfo.code,
-    path: req?.path,
-    method: req?.method,
-    sql: err?.sql,
-    sqlMessage: err?.sqlMessage,
-    stack: err?.stack,
-  });
-  
-  return {
-    success: false,
-    msg: errorInfo.msg,
-    code: errorInfo.code,
-    data: process.env.NODE_ENV === "development"
-      ? {
-          message: err?.message,
-          sql: err?.sql,
-          sqlMessage: err?.sqlMessage,
-          stack: err?.stack,
-        }
-      : {},
-  };
-}

package/helper/sign.js

@@ -1,96 +0,0 @@
-import CryptoJS from "crypto-js";
-
-/**
- * 加密和签名工具函数
- * 提供 AES 加密解密和数据签名功能
- */
-
-/**
- * AES 加密
- * @param {Object} obj - 要加密的对象
- * @param {string} key - 加密密钥
- * @returns {string|null} 加密后的字符串，失败时返回 null
- * @description
- * 使用 AES 算法加密数据
- * 需要配置 AES_SALT 环境变量作为密钥
- * @example
- * const encrypted = aesEncrypt({ id: 1, name: '张三' }, 'my-secret-key');
- */
-export const aesEncrypt = (obj, key) => {
-  if (!key) {
-    console.error('[安全错误] AES_SALT 必须配置');
-    return null;
-  }
-  try {
-    const encrypted = CryptoJS.AES.encrypt(JSON.stringify(obj), key);
-    return encrypted.toString();
-  } catch (error) {
-    console.error("AES加密失败:", error);
-    return "";
-  }
-};
-
-/**
- * AES 解密
- * @param {string} str - 要解密的字符串
- * @param {string} key - 解密密钥
- * @returns {string|null} 解密后的字符串，失败时返回 null
- * @description
- * 使用 AES 算法解密数据
- * 需要配置 AES_SALT 环境变量作为密钥
- * @example
- * const decrypted = aesDecrypt(encryptedStr, 'my-secret-key');
- */
-export const aesDecrypt = (str, key) => {
-  if (!key) {
-    console.error('[安全错误] AES_SALT 必须配置');
-    return null;
-  }
-  try {
-    const decrypted = CryptoJS.AES.decrypt(str, key);
-    return decrypted.toString(CryptoJS.enc.Utf8);
-  } catch (error) {
-    console.error("AES解密失败:", error);
-    return "";
-  }
-};
-
-/**
- * 数据签名
- * @param {Object} data - 要签名的数据对象
- * @param {string} secret - 签名密钥
- * @returns {string|null} 签名字符串，失败时返回 null
- * @description
- * 使用 HMAC-SHA256 算法对数据进行签名
- * @example
- * const signature = signData({ userId: 123 }, 'my-sign-key');
- */
-export function signData(data, secret) {
-  if (!secret) {
-    console.error('[安全错误] 签名密钥必须配置');
-    return null;
-  }
-  try {
-    const sign = CryptoJS.HmacSHA256(JSON.stringify(data), secret).toString();
-    return sign;
-  } catch (error) {
-    console.error("数据签名失败:", error.message);
-    return null;
-  }
-}
-
-/**
- * 验证数据签名
- * @param {Object} data - 原始数据对象
- * @param {string} signature - 待验证的签名
- * @param {string} secret - 签名密钥
- * @returns {boolean} 签名是否有效
- * @description
- * 重新计算签名并与传入的签名进行比对
- * @example
- * const isValid = verifySign({ userId: 123 }, signature, 'my-sign-key');
- */
-export function verifySign(data, signature, secret) {
-  const computedSign = signData(data, secret);
-  return computedSign === signature;
-}

package/helper/tree.js

@@ -1,77 +0,0 @@
-/**
- * 树形结构工具函数
- * 提供数组转树形结构和路径查找功能
- */
-
-/**
- * 将扁平数组转换为树形结构
- * @param {Array<Object>} arr - 扁平化的数据数组
- * @param {number} [pid=0] - 父节点 ID，默认为 0
- * @returns {Array<Object>} 树形结构数组
- * @description
- * 递归构建树形结构，为每个节点添加 level 属性
- * 如果有子节点，则添加 children 属性
- * @example
- * const arr = [
- *   { id: 1, pid: 0, name: '根节点' },
- *   { id: 2, pid: 1, name: '子节点' },
- *   { id: 3, pid: 2, name: '孙节点' }
- * ];
- * const tree = tree(arr);
- * // 返回带有 children 和 level 的树形结构
- */
-export function tree(arr, pid = 0) {
-  if(arr.length === 0){
-    return []
-  }
-  let result = [];
-  arr.forEach((item) => {
-    if (item.pid === pid) {
-      let children = tree(arr, item.id);
-      if (children.length) {
-        item.children = children;
-      }
-      item.level = 1;
-      result.push(item);
-    }
-  });
-  return result;
-}
-
-/**
- * 根据 ID 查找节点路径
- * @param {number} id - 要查找的节点 ID
- * @param {Array<Object>} source - 数据源数组
- * @returns {Array<Object>} 从根节点到目标节点的路径数组
- * @description
- * 递归查找指定 ID 的节点及其所有父节点
- * 为每个节点添加 path 属性，包含拼音路径
- * @example
- * const arr = [
- *   { id: 1, pid: 0, pinyin: 'root' },
- *   { id: 2, pid: 1, pinyin: 'child' }
- * ];
- * const path = treeById(2, arr);
- * // 返回包含 root 和 child 节点的数组
- */
-export function treeById(id, source) {
-  const arr = [];
-  const findId = (id, source) => {
-    for (let i = 0, item; i < source.length; i++) {
-      item = source[i];
-      if (item.id == id) {
-        arr.unshift(item);
-        if (item.pid != 0) {
-          findId(item.pid, source);
-        }
-      }
-    }
-  };
-  findId(id, source);
-  const _path = [];
-  arr.forEach((item) => {
-    _path.push("/" + item.pinyin);
-    item.path = _path.join("");
-  });
-  return arr;
-}

package/helper/xss-filter.js

@@ -1,42 +0,0 @@
-import xss from 'xss';
-
-/**
- * XSS 过滤工具
- * 提供跨站脚本攻击过滤功能
- */
-
-/**
- * 过滤 XSS 攻击代码
- * @param {*} data - 要过滤的数据，可以是字符串、数组或对象
- * @returns {*} 过滤后的数据
- * @description
- * 递归过滤数据中的所有字符串值
- * 使用 xss 库清除危险的 HTML 和 JavaScript 代码
- * 支持字符串、数组和对象的递归处理
- * @example
- * const clean = filterXSS({
- *   name: '<script>alert(1)</script>',
- *   items: ['<img src=x onerror=alert(1)>']
- * });
- */
-export function filterXSS(data) {
-  if (typeof data === 'string') {
-    return xss(data);
-  }
-
-  if (Array.isArray(data)) {
-    return data.map(item => filterXSS(item));
-  }
-
-  if (data && typeof data === 'object') {
-    const result = {};
-    for (const key in data) {
-      if (Object.prototype.hasOwnProperty.call(data, key)) {
-        result[key] = filterXSS(data[key]);
-      }
-    }
-    return result;
-  }
-
-  return data;
-}