chanjs 2.7.3 → 2.7.5

package/common/code.js

@@ -1,52 +0,0 @@
-/**
- * 响应状态码常量定义（旧版对象形式，保留向后兼容）
- *
- * ============================================================
- * 重要说明
- * ============================================================
- * 业务侧推荐使用 config/code.js 的三层 code 体系（0/1xxx/5xxx/6xxx），
- * 该文件提供完整的 CODE 字典、CODE_RANGE 段位常量、语义化别名、DB_ERROR 映射。
- *
- * 本文件的 CODE 对象为旧版形式，仅用于兼容历史代码。
- * code 值已对齐新体系，不再使用 200/201/500。
- *
- * @deprecated 推荐使用 config/code.js 的新体系
- */
-
-export const CODE = {
-  /**
-   * 操作成功（code: 0，不再用 200）
-   */
-  SUCCESS: {
-    code: 0,
-    message: "操作成功",
-  },
-  /**
-   * 操作失败（code: 1008 业务处理失败）
-   */
-  FAIL: {
-    code: 1008,
-    message: "操作失败",
-  },
-  /**
-   * 系统错误（code: 5001 系统内部错误）
-   */
-  ERROR: {
-    code: 5001,
-    message: "系统错误",
-  },
-  /**
-   * 未授权（code: 1001 认证失败）
-   */
-  UNAUTHORIZED: {
-    code: 1001,
-    message: "认证失败",
-  },
-  /**
-   * 禁止访问（code: 1003 权限不足）
-   */
-  FORBIDDEN: {
-    code: 1003,
-    message: "权限不足",
-  },
-};

package/common/email.js

@@ -1,191 +0,0 @@
-import nodemailer from "nodemailer";
-import Chan from "../App.js";
-
-/**
- * 邮件发送工具
- * 提供邮件发送和HTML模板生成功能
- * 通过 import Chan 获取应用配置（不依赖 global.Chan）
- */
-
-/**
- * 邮箱地址正则（基础校验，防注入和拼写错误）
- */
-const EMAIL_REGEX = /^[^\s@<>'"`]+@[^\s@<>'"`]+\.[^\s@<>'"`]+$/;
-
-/**
- * 模块级 transporter 缓存（避免每次发邮件都创建连接池）
- * 配置不变时复用同一个 transporter，提升性能
- */
-let _transporter = null;
-let _transporterKey = '';
-
-/**
- * HTML 特殊字符转义，防止邮件模板注入
- * @param {string} str - 待转义的字符串
- * @returns {string} 转义后的字符串
- */
-function escapeHtml(str) {
-  if (str == null) return '';
-  return String(str)
-    .replace(/&/g, '&amp;')
-    .replace(/</g, '&lt;')
-    .replace(/>/g, '&gt;')
-    .replace(/"/g, '&quot;')
-    .replace(/'/g, '&#39;');
-}
-
-/**
- * 校验收件人邮箱格式（基础规则，拒绝含特殊字符的非法地址）
- * @param {string} email - 邮箱地址
- * @returns {boolean} 是否合法
- */
-function isValidEmail(email) {
-  return typeof email === 'string' && EMAIL_REGEX.test(email) && email.length <= 254;
-}
-
-/**
- * 获取或创建 transporter（带缓存）
- * @param {Object} EMAIL - 邮件配置
- * @returns {Object} nodemailer transporter
- */
-function getTransporter(EMAIL) {
-  // 用 host+port+user 作为缓存 key，配置变化时自动重建
-  const key = `${EMAIL.HOST}:${EMAIL.PORT}:${EMAIL.USER}`;
-  if (_transporter && _transporterKey === key) {
-    return _transporter;
-  }
-
-  _transporter = nodemailer.createTransport({
-    host: EMAIL.HOST,
-    port: parseInt(EMAIL.PORT),
-    secure: EMAIL.SECURE === "true",
-    auth: {
-      user: EMAIL.USER,
-      pass: EMAIL.PASS,
-    },
-    // 连接池配置：避免每次发邮件都握手，降低 SMTP 服务器压力
-    pool: true,
-    maxConnections: 5,
-    maxMessages: 100,
-    // 超时控制，避免 SMTP 卡死拖垮业务
-    connectionTimeout: 10 * 1000,
-    greetingTimeout: 10 * 1000,
-    socketTimeout: 30 * 1000,
-  });
-  _transporterKey = key;
-  return _transporter;
-}
-
-/**
- * 发送邮件
- * @param {string} to - 收件人邮箱
- * @param {string} subject - 邮件主题
- * @param {string} text - 邮件文本内容
- * @param {string|null} html - 邮件HTML内容，默认为null
- * @returns {Promise<Object>} 发送结果
- * @throws {Error} 邮件服务未配置或发送失败时抛出异常
- * @description
- * - 收件人邮箱格式校验，拒绝非法地址
- * - transporter 模块级缓存，避免每次创建连接池
- */
-export const sendMail = async (to, subject, text, html = null) => {
-  // 收件人邮箱格式校验
-  if (!isValidEmail(to)) {
-    throw new Error(`[email] 收件人邮箱格式非法: ${to}`);
-  }
-
-  const { EMAIL, APP_NAME } = Chan.config;
-  
-  const transporter = getTransporter(EMAIL);
-  
-  let res = await transporter.verify();
-  if (!res) {
-    throw new Error("邮件服务未配置");
-  }
-
-  const mailOptions = {
-    from: EMAIL.FROM,
-    to,
-    subject,
-    text,
-    html: html || text,
-  };
-
-  try {
-    const info = await transporter.sendMail(mailOptions);
-    return info;
-  } catch (error) {
-    console.error("❌ 邮件发送失败:", error.message);
-    throw error;
-  }
-};
-
-/**
- * 生成注册验证码邮件HTML模板
- * @param {string} code - 验证码
- * @param {number} minutes - 有效期（分钟），默认10分钟
- * @returns {string} HTML字符串
- * @description
- * 安全改进：所有动态内容（code、APP_NAME）都经 escapeHtml 转义，防止 HTML 注入
- */
-export const genRegEmailHtml = (code, minutes = 10) => {
-  const { APP_NAME } = Chan.config;
-  // 转义防止 HTML 注入
-  const safeCode = escapeHtml(code);
-  const safeAppName = escapeHtml(APP_NAME);
-  return `
-  <div style="font-family: Arial, sans-serif; max-width: 750px; margin: auto; border: 1px solid #ddd; border-radius: 10px; overflow: hidden;">
-    <div style="background-color: #007bff; color: white; padding: 10px; text-align: center;">
-      <h2>${safeAppName} 欢迎注册！</h2>
-    </div>
-    <div style="padding: 20px; line-height: 1.6;">
-      <p>您好，感谢您注册我们的服务！</p>
-      <p>您的注册验证码是：</p>
-      <div style="font-size: 24px; font-weight: bold; color: #007bff; text-align: center; margin: 20px 0;">
-        ${safeCode}
-      </div>
-      <p>请在 <strong>${escapeHtml(minutes)} 分钟内</strong> 输入该验证码，完成账户验证。</p>
-      <p>如非本人操作，请忽略此邮件。</p>
-      <p>祝您使用愉快！</p>
-    </div>
-    <div style="background-color: #f8f9fa; padding: 10px; text-align: center; font-size: 12px; color: #666;">
-      &copy; ${new Date().getFullYear()} ${safeAppName}. 保留所有权利。
-    </div>
-  </div>
-  `;
-};
-
-/**
- * 生成重置密码邮件HTML模板
- * @param {string} code - 验证码
- * @param {number} minutes - 有效期（分钟），默认10分钟
- * @returns {string} HTML字符串
- * @description
- * 安全改进：所有动态内容（code、APP_NAME）都经 escapeHtml 转义，防止 HTML 注入
- */
-export const genResetPasswordEmail = (code, minutes = 10) => {
-  const { APP_NAME } = Chan.config;
-  // 转义防止 HTML 注入
-  const safeCode = escapeHtml(code);
-  const safeAppName = escapeHtml(APP_NAME);
-  return `
-  <div style="font-family: Arial, sans-serif; max-width: 600px; margin: auto; border: 1px solid #ddd; border-radius: 10px; overflow: hidden;">
-    <div style="background-color: #28a745; color: white; padding: 20px; text-align: center;">
-      <h2>重置密码_${safeAppName}</h2>
-    </div>
-    <div style="padding: 20px; line-height: 1.6;">
-      <p>您好，我们收到了您重置密码的请求。</p>
-       <p>您的重置密码验证码是：</p>
-      <div style="font-size: 24px; font-weight: bold; color: #007bff; text-align: center; margin: 20px 0;">
-        ${safeCode}
-      </div>
-      <p>请在 <strong>${escapeHtml(minutes)} 分钟内</strong> 输入该验证码，完成账户验证。</p>
-      <p>如非本人操作，请忽略此邮件。</p>
-      <p>祝您使用愉快！</p>
-    </div>
-    <div style="background-color: #f8f9fa; padding: 10px; text-align: center; font-size: 12px; color: #666;">
-      &copy; ${new Date().getFullYear()} ${safeAppName}. 保留所有权利。
-    </div>
-  </div>
-  `;
-};

package/common/index.js

@@ -1,5 +0,0 @@
-export { success, fail, error } from "./api.js";
-export { getChildrenId } from "./utils.js";
-export { CODE } from "./code.js";
-export { sendMail, genRegEmailHtml, genResetPasswordEmail } from "./email.js";
-export { pages, getHtmlFilesSync } from "./pages.js";

package/common/pages.js

@@ -1,120 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-
-/**
- * 分页工具函数
- * 提供分页HTML生成和文件遍历功能
- */
-
-/**
- * 生成分页HTML
- * @param {number} current - 当前页码
- * @param {number} total - 总记录数
- * @param {number} pageSize - 每页大小
- * @param {string} href - 链接基础路径
- * @param {string} query - 查询参数字符串，默认为空
- * @returns {string} 分页HTML字符串
- */
-export function pages(current, total, pageSize, href, query='') {
-  let pageTemp = [];
-  
-  // 确保参数是数字
-  current = parseInt(current) || 1;
-  total = parseInt(total) || 0;
-  pageSize = parseInt(pageSize) || 10;
-  
-  let totalPage = Math.ceil(total / pageSize);
-  
-  // 如果没有数据或只有一页，不显示分页
-  if (totalPage <= 1 || total === 0) {
-    return '';
-  }
-  
-  // 确保当前页在有效范围内
-  if (current < 1) current = 1;
-  if (current > totalPage) current = totalPage;
-  
-  // 上一页
-  if (current == 1) {
-    pageTemp.push(`<li class="disabled">上一页</li>`);
-  } else {
-    pageTemp.push(`<li><a href='${href}${current - 1}.html${query}'>上一页</a></li>`);
-  }
-  
-  // 页码逻辑
-  if (totalPage <= 7) {
-    // 总页数少于7页，全部显示
-    for (let i = 1; i <= totalPage; i++) {
-      if (current == i) {
-        pageTemp.push(`<li class="current">${i}</li>`);
-      } else {
-        pageTemp.push(`<li><a href='${href}${i}.html${query}'>${i}</a></li>`);
-      }
-    }
-  } else {
-    // 总页数大于7页，需要显示省略号
-    if (current <= 4) {
-      // 当前页在前4页：显示 1 2 3 4 5 ... 最后一页
-      for (let i = 1; i <= 5; i++) {
-        if (current == i) {
-          pageTemp.push(`<li class="current">${i}</li>`);
-        } else {
-          pageTemp.push(`<li><a href='${href}${i}.html${query}'>${i}</a></li>`);
-        }
-      }
-      pageTemp.push(`<li class="disabled">...</li>`);
-      pageTemp.push(`<li><a href='${href}${totalPage}.html${query}'>${totalPage}</a></li>`);
-    } else if (current >= totalPage - 3) {
-      // 当前页在后4页：显示 1 ... 最后5页
-      pageTemp.push(`<li><a href='${href}1.html${query}'>1</a></li>`);
-      pageTemp.push(`<li class="disabled">...</li>`);
-      for (let i = totalPage - 4; i <= totalPage; i++) {
-        if (current == i) {
-          pageTemp.push(`<li class="current">${i}</li>`);
-        } else {
-          pageTemp.push(`<li><a href='${href}${i}.html${query}'>${i}</a></li>`);
-        }
-      }
-    } else {
-      // 当前页在中间：显示 1 ... 当前页前1页 当前页 当前页后1页 ... 最后一页
-      pageTemp.push(`<li><a href='${href}1.html${query}'>1</a></li>`);
-      pageTemp.push(`<li class="disabled">...</li>`);
-      for (let i = current - 1; i <= current + 1; i++) {
-        if (current == i) {
-          pageTemp.push(`<li class="current">${i}</li>`);
-        } else {
-          pageTemp.push(`<li><a href='${href}${i}.html${query}'>${i}</a></li>`);
-        }
-      }
-      pageTemp.push(`<li class="disabled">...</li>`);
-      pageTemp.push(`<li><a href='${href}${totalPage}.html${query}'>${totalPage}</a></li>`);
-    }
-  }
-  
-  // 下一页
-  if (current == totalPage) {
-    pageTemp.push(`<li class="disabled">下一页</li>`);
-  } else {
-    pageTemp.push(`<li><a href='${href}${current + 1}.html${query}'>下一页</a></li>`);
-  }
-  
-  return pageTemp.join("");
-}
-
-/**
- * 同步获取指定文件夹下的所有HTML文件
- * @param {string} folderPath - 文件夹路径
- * @returns {Array<string>} HTML文件名数组
- */
-export function getHtmlFilesSync(folderPath) {
-  const files = fs.readdirSync(folderPath);
-  const htmlFiles = [];
-  files.forEach((file) => {
-    const filePath = path.join(folderPath, file);
-    const stats = fs.statSync(filePath);
-    if (stats.isFile() && path.extname(file) === ".html") {
-      htmlFiles.push(file);
-    }
-  });
-  return htmlFiles;
-}

package/common/utils.js

@@ -1,73 +0,0 @@
-/**
- * 通用工具函数
- * 提供分类、HTML处理、设备检测和图片提取等功能
- */
-
-/**
- * 根据拼音或ID获取分类信息
- * @param {string|number} py - 拼音或ID
- * @param {Array} source - 分类数据源
- * @returns {Object} 包含分类对象和ID的对象
- */
-export function getChildrenId(py, source) {
-  let cate = {};
-  let id = "";
-  source.forEach((item) => {
-    if (item.pinyin == py || item.id == py) {
-      cate = item;
-      id = item.id;
-    }
-  });
-  return { cate, id };
-}
-
-/**
- * 从HTML字符串中提取body内容
- * @param {string} str - HTML字符串
- * @returns {string} body内容，未找到则返回原字符串
- */
-export function filterBody(str) {
-  const result = /<body[^>]*>([\s\S]*)<\/body>/.exec(str);
-  if (result && result.length === 2) return result[1];
-  return str;
-}
-
-/**
- * 检测是否为PC端
- * @param {string} str - User-Agent字符串
- * @returns {boolean} 是PC端返回true，否则返回false
- */
-export function pc(str) {
-  if (
-    str.match(
-      /(phone|pad|pod|iPhone|iPod|ios|iPad|Android|Mobile|BlackBerry|IEMobile|MQQBrowser|JUC|Fennec|wOSBrowser|BrowserNG|WebOS|Symbian|Windows Phone)/i
-    )
-  ) {
-    return false;
-  }
-  return true;
-}
-
-/**
- * 从HTML字符串中提取所有图片URL
- * @param {string} str - HTML字符串
- * @returns {Array<string>} 图片URL数组
- */
-export function filterImgFromStr(str) {
-  if (!str) {
-    return [];
-  }
-  const imgReg = /<img.*?(?:>|\/>)/gi;
-  const srcReg = /src=[\'\"]?([^\'\"]*)[\'\"]?/i;
-  const arr = str.match(imgReg);
-  const imgArr = [];
-  if (arr) {
-    for (let i = 0; i < arr.length; i++) {
-      const src = arr[i].match(srcReg);
-      if (src[1]) {
-        imgArr.push(src[1]);
-      }
-    }
-  }
-  return imgArr;
-}

package/config/code.js

@@ -1,166 +0,0 @@
-/**
- * 业务状态码定义（统一三层 code 体系）
- *
- * ============================================================
- * 设计原则
- * ============================================================
- * 1. 业务 code 与 HTTP Status 彻底解耦
- *    - HTTP Status 由网关/Express 控制（200/400/401/403/404/500）
- *    - 业务 code 由业务层控制（0 / 1xxx / 5xxx / 6xxx）
- *    - 前端 axios 先看 HTTP Status，再看业务 code
- *
- * 2. 0 表示成功（不再用 200，避免与 HTTP 200 混淆）
- *
- * 3. 错误按业务域分段
- *    - 1xxx 通用业务错误（认证/权限/参数/资源）
- *    - 2xxx CMS 业务专用错误（保留扩展段）
- *    - 5xxx 系统错误
- *    - 6xxx 数据库错误
- *
- * 4. 每个 code 都有默认 msg，业务可覆盖
- *
- * ============================================================
- * Code 段位定义
- * ============================================================
- * 0       → 成功
- * 1001    → 认证失败（token 无效/未登录）
- * 1002    → token 已过期
- * 1003    → 权限不足
- * 1004    → 资源不存在
- * 1005    → 资源已存在
- * 1006    → 参数无效
- * 1007    → 参数缺失
- * 1008    → 业务处理失败（通用兜底）
- * 1009    → 请求过于频繁（限流）
- * 1010    → 登录设备异常
- * 2xxx    → CMS 业务专用错误（保留扩展段）
- * 5001    → 系统内部错误
- * 5002    → 服务繁忙，请稍后再试
- * 6001    → 数据库连接失败
- * 6002    → 数据库访问被拒绝
- * 6003    → 存在关联数据，操作失败
- * 6004    → 数据库字段错误
- * 6005    → 数据重复，违反唯一性约束
- * 6006    → 目标表不存在
- * 6007    → 数据库操作超时
- * 6008    → 数据库语法错误
- * 6009    → 数据库连接已关闭
- */
-
-/**
- * 业务状态码 → 默认消息
- * @type {Object<number, string>}
- */
-export const CODE = {
-  // 成功
-  0: "操作成功",
-
-  // 1xxx 通用业务错误
-  1001: "认证失败",
-  1002: "令牌已过期",
-  1003: "权限不足",
-  1004: "资源不存在",
-  1005: "资源已存在",
-  1006: "参数无效",
-  1007: "参数缺失",
-  1008: "业务处理失败",
-  1009: "请求过于频繁",
-  1010: "登录设备异常",
-
-  // 2xxx CMS 业务专用错误（保留扩展段，业务方可自定义）
-  // 例如：2001 文章不存在 / 2002 栏目不存在 等
-
-  // 5xxx 系统错误
-  5001: "系统内部错误",
-  5002: "服务繁忙，请稍后再试",
-
-  // 6xxx 数据库错误
-  6001: "数据库连接失败",
-  6002: "数据库访问被拒绝",
-  6003: "存在关联数据，操作失败",
-  6004: "数据库字段错误",
-  6005: "数据重复，违反唯一性约束",
-  6006: "目标表不存在",
-  6007: "数据库操作超时",
-  6008: "数据库语法错误，请检查查询语句",
-  6009: "数据库连接已关闭，请重试",
-};
-
-/**
- * 业务 code 段位常量
- * 便于业务方判断 code 归属段位
- * @example
- * if (code >= CODE_RANGE.SYSTEM[0] && code <= CODE_RANGE.SYSTEM[1]) { ... }
- */
-export const CODE_RANGE = {
-  SUCCESS: [0, 0],            // 成功
-  BUSINESS: [1000, 1999],    // 通用业务错误
-  CMS: [2000, 2999],          // CMS 业务错误（保留扩展段）
-  SYSTEM: [5000, 5999],      // 系统错误
-  DATABASE: [6000, 6999],    // 数据库错误
-};
-
-/**
- * 常用 code 语义化别名
- * 业务方可直接用 CODE_OK / CODE_AUTH_FAILED 等语义化常量，避免硬编码数字
- */
-export const CODE_OK = 0;                  // 成功
-export const CODE_AUTH_FAILED = 1001;       // 认证失败
-export const CODE_TOKEN_EXPIRED = 1002;     // token 过期
-export const CODE_FORBIDDEN = 1003;         // 权限不足
-export const CODE_NOT_FOUND = 1004;         // 资源不存在
-export const CODE_CONFLICT = 1005;          // 资源已存在
-export const CODE_PARAM_INVALID = 1006;     // 参数无效
-export const CODE_PARAM_MISSING = 1007;     // 参数缺失
-export const CODE_BUSINESS_FAIL = 1008;     // 业务处理失败（通用）
-export const CODE_RATE_LIMIT = 1009;        // 限流
-export const CODE_DEVICE_ERROR = 1010;       // 登录设备异常
-export const CODE_SYSTEM_ERROR = 5001;      // 系统内部错误
-export const CODE_SERVICE_BUSY = 5002;       // 服务繁忙
-
-/**
- * 数据库原生错误码 → 业务 code 映射
- * 将 MySQL/Knex 等数据库原生错误码转换为业务 code
- * @type {Object<string, number>}
- */
-export const DB_ERROR = {
-  ECONNREFUSED: 6001,
-  ER_ACCESS_DENIED_ERROR: 6002,
-  ER_ROW_IS_REFERENCED_2: 6003,
-  ER_BAD_FIELD_ERROR: 6004,
-  ER_DUP_ENTRY: 6005,
-  ER_NO_SUCH_TABLE: 6006,
-  ETIMEOUT: 6007,
-  ER_TABLE_EXISTS_ERROR: 1005,  // 表已存在 → 资源已存在
-};
-
-/**
- * 判断 code 是否为成功
- * @param {number} code - 业务 code
- * @returns {boolean}
- */
-export function isSuccessCode(code) {
-  return code === CODE_OK;
-}
-
-/**
- * 判断 code 所属段位
- * @param {number} code - 业务 code
- * @returns {string} 段位名：SUCCESS / BUSINESS / CMS / SYSTEM / DATABASE / UNKNOWN
- */
-export function getCodeRange(code) {
-  for (const [name, [min, max]] of Object.entries(CODE_RANGE)) {
-    if (code >= min && code <= max) return name;
-  }
-  return 'UNKNOWN';
-}
-
-/**
- * 获取 code 的默认消息
- * @param {number} code - 业务 code
- * @param {string} [fallback='操作失败'] - 兜底消息
- * @returns {string}
- */
-export function getCodeMsg(code, fallback = '操作失败') {
-  return CODE[code] || fallback;
-}

package/config/paths.js

@@ -1,60 +0,0 @@
-import path from "path";
-
-/**
- * 路径配置
- * 提供项目中常用路径的访问器
- */
-
-export const Paths = {
-  /**
-   * 项目根目录路径
-   */
-  rootPath: process.cwd(),
-};
-
-Object.defineProperties(Paths, {
-  /**
-   * 应用目录路径
-   */
-  appPath: {
-    get() { return path.join(this.rootPath, "app"); }
-  },
-  /**
-   * 配置文件目录路径
-   */
-  configPath: {
-    get() { return path.join(this.rootPath, "config"); }
-  },
-  /**
-   * 公共资源目录路径
-   */
-  publicPath: {
-    get() { return path.join(this.rootPath, "public"); }
-  },
-  /**
-   * 模块目录路径
-   */
-  modulesPath: {
-    get() { return path.join(this.appPath, "modules"); }
-  },
-  /**
-   * 通用模块目录路径
-   */
-  commonPath: {
-    get() { return path.join(this.appPath, "common"); }
-  },
-  /**
-   * 辅助函数目录路径
-   */
-  helperPath: {
-    get() { return path.join(this.appPath, "helper"); }
-  },
-  /**
-   * 扩展目录路径
-   */
-  extendPath: {
-    get() { return path.join(this.appPath, "extend"); }
-  },
-});
-
-export default Paths;