chanjs 2.0.17 → 2.0.19

package/helper/db.js

@@ -19,7 +19,7 @@ const getDefaultErrorMessage = (error) => {
   }
   return "数据库发生未知错误，请稍后重试。";
 };
-export const db =({
+export const db = ({
   client = "mysql2",
   host = "127.0.0.1",
   user = "root",
@@ -30,8 +30,8 @@ export const db =({
   charset = "utf8mb4",
   min = 0,
   max = 2,
-  filename=''
-}) =>{
+  filename = "",
+}) => {
   let config = {
     client,
     connection: {
@@ -40,20 +40,23 @@ export const db =({
       user,
       password,
       database,
-      charset
+      charset,
     },
     debug,
     pool: {
       //默认为{min: 2, max: 10},连接池配置
       min,
       max,
-       // 添加连接池错误处理
-       afterCreate: (conn, done) => {
-        conn.on('error', (error) => {
-          console.error(`[连接池错误] 连接出错: ${getDefaultErrorMessage(error)}`, error);
+      // 添加连接池错误处理
+      afterCreate: (conn, done) => {
+        conn.on("error", (error) => {
+          console.error(
+            `[连接池错误] 连接出错: ${getDefaultErrorMessage(error)}`,
+            error
+          );
         });
         done(null, conn);
-      }
+      },
     },
     log: {
       warn(message) {
@@ -79,10 +82,10 @@ export const db =({
       },
     },
   };
-  
-	if(client==='sqlite3' || client === 'better-sqlite3'){
-		config.connection.filename = filename
-	}
+
+  if (client === "sqlite3" || client === "better-sqlite3") {
+    config.connection.filename = filename;
+  }
 
   return knex(config);
 };

package/helper/file.js

@@ -1,17 +1,16 @@
-import fs from 'fs/promises';
-import { accessSync, unlinkSync, existsSync, mkdirSync } from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
+import fs from "fs/promises";
+import { accessSync, unlinkSync, existsSync, mkdirSync } from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
 
-export const dirname = (url) =>{
+export const dirname = (url) => {
   const __filename = fileURLToPath(url);
   return path.dirname(__filename);
-}
-
+};
 
 /**
  * 获取指定路径的文件树结构
- * 
+ *
  * @param {string} basePath - 要扫描的基础路径
  * @param {boolean} [deep=true] - 是否深度遍历子目录
  * @returns {Promise<Array<Object>>} 文件树数组，每个元素包含文件/目录信息
@@ -43,13 +42,15 @@ export const getFileTree = async (basePath, deep = true) => {
         name: item,
         path: itemPath,
         relativePath: path.relative(ROOT_PATH, itemPath),
-        type: itemStats.isDirectory() ? 'directory' : 'file',
+        type: itemStats.isDirectory() ? "directory" : "file",
         size: itemStats.size,
         modified: itemStats.mtime,
-        depth: itemPath.split(path.sep).length - path.resolve(ROOT_PATH).split(path.sep).length
+        depth:
+          itemPath.split(path.sep).length -
+          path.resolve(ROOT_PATH).split(path.sep).length,
       };
 
-      if (treeItem.type === 'directory' && deep) {
+      if (treeItem.type === "directory" && deep) {
         treeItem.children = await getFileTree(itemPath, deep);
       }
 
@@ -59,9 +60,9 @@ export const getFileTree = async (basePath, deep = true) => {
     // 排序：文件夹在前，文件在后，名称按字母顺序排列
     return tree.sort((a, b) => {
       if (a.type === b.type) {
-        return a.name.localeCompare(b.name, undefined, { sensitivity: 'base' });
+        return a.name.localeCompare(b.name, undefined, { sensitivity: "base" });
       }
-      return a.type === 'directory' ? -1 : 1;
+      return a.type === "directory" ? -1 : 1;
     });
   } catch (error) {
     console.error(`获取文件树失败: ${basePath}`, error);
@@ -71,7 +72,7 @@ export const getFileTree = async (basePath, deep = true) => {
 
 /**
  * 读取文件内容（UTF-8编码）
- * 
+ *
  * @param {string} filePath - 要读取的文件路径
  * @returns {Promise<string>} 文件内容字符串
  * @throws {Error} 当文件不存在、无法读取或不是文件时抛出错误
@@ -79,17 +80,17 @@ export const getFileTree = async (basePath, deep = true) => {
 export const readFileContent = async (filePath) => {
   try {
     // 先检查路径是否安全
-    if (!isPathSafe(filePath,APP_PATH)  && !isPathSafe(filePath,ROOT_PATH)) {
+    if (!isPathSafe(filePath, APP_PATH) && !isPathSafe(filePath, ROOT_PATH)) {
       throw new Error(`路径不安全: ${filePath}`);
     }
-    
+
     // 检查是否为文件
     const stats = await fs.stat(filePath);
     if (!stats.isFile()) {
       throw new Error(`不是文件: ${filePath}`);
     }
-    
-    return await fs.readFile(filePath, 'utf8');
+
+    return await fs.readFile(filePath, "utf8");
   } catch (error) {
     console.error(`读取文件失败: ${filePath}`, error);
     throw error;
@@ -98,7 +99,7 @@ export const readFileContent = async (filePath) => {
 
 /**
  * 保存内容到文件（UTF-8编码）
- * 
+ *
  * @param {string} filePath - 要保存的文件路径
  * @param {string} content - 要写入的内容
  * @returns {Promise<void>} 无返回值
@@ -107,16 +108,16 @@ export const readFileContent = async (filePath) => {
 export const saveFileContent = async (filePath, content) => {
   try {
     // 先检查路径是否安全
-    if (!isPathSafe(filePath,APP_PATH)  && !isPathSafe(filePath,ROOT_PATH)) {
+    if (!isPathSafe(filePath, APP_PATH) && !isPathSafe(filePath, ROOT_PATH)) {
       throw new Error(`路径不安全: ${filePath}`);
     }
-    
+
     // 确保目录存在
     const dirname = path.dirname(filePath);
     await fs.mkdir(dirname, { recursive: true });
-    
+
     // 写入文件
-    await fs.writeFile(filePath, content, 'utf8');
+    await fs.writeFile(filePath, content, "utf8");
   } catch (error) {
     console.error(`保存文件失败: ${filePath}`, error);
     throw error;
@@ -125,7 +126,7 @@ export const saveFileContent = async (filePath, content) => {
 
 /**
  * 验证路径是否在基础路径范围内（防止路径遍历攻击）
- * 
+ *
  * @param {string} requestedPath - 要验证的路径
  * @param {string} basePath - 基础路径，requestedPath必须在此路径下
  * @returns {boolean} 如果路径安全则返回true，否则返回false
@@ -139,7 +140,7 @@ export const isPathSafe = (requestedPath, basePath) => {
 
 /**
  * 删除指定路径的图片文件
- * 
+ *
  * @param {string} link - 图片文件的路径
  * @returns {boolean} 成功删除返回true，否则返回false
  * @description 同步操作，会检查文件是否存在后再删除
@@ -151,10 +152,10 @@ export function delImg(link) {
       console.error(`路径不安全: ${link}`);
       return false;
     }
-    
+
     // 检查文件是否存在
     accessSync(link);
-    
+
     // 删除文件
     unlinkSync(link);
     return true;
@@ -166,7 +167,7 @@ export function delImg(link) {
 
 /**
  * 递归创建目录（同步操作）
- * 
+ *
  * @param {string} dirname - 要创建的目录路径
  * @returns {boolean} 成功创建或目录已存在返回true，否则返回false
  * @description 类似于mkdir -p命令，会创建所有不存在的父目录
@@ -178,18 +179,18 @@ export function mkdirsSync(dirname) {
       console.error(`路径不安全: ${dirname}`);
       return false;
     }
-    
+
     if (existsSync(dirname)) {
       return true;
     }
-    
+
     // 递归创建父目录
     const parentDir = path.dirname(dirname);
     if (mkdirsSync(parentDir)) {
       mkdirSync(dirname);
       return true;
     }
-    
+
     return false;
   } catch (err) {
     console.error(`创建目录失败: ${dirname}`, err);
@@ -197,7 +198,6 @@ export function mkdirsSync(dirname) {
   }
 }
 
-
 export default {
   mkdirsSync,
   delImg,
@@ -205,4 +205,4 @@ export default {
   saveFileContent,
   readFileContent,
   getFileTree,
-}
+};

package/helper/html.js

@@ -5,17 +5,21 @@
  */
 export const htmlEncode = (str) => {
   // 非字符串直接返回，避免报错
-  if (typeof str !== 'string') return str;
-  
+  if (typeof str !== "string") return str;
+
   // 一次性替换所有特殊字符，减少函数调用
-  return str.replace(/[&<>"' ]/g, match => ({
-    '&': '&amp;',
-    '<': '&lt;',
-    '>': '&gt;',
-    '"': '&quot;',
-    "'": '&#39;',
-    ' ': '&nbsp;'
-  }[match]));
+  return str.replace(
+    /[&<>"' ]/g,
+    (match) =>
+      ({
+        "&": "&amp;",
+        "<": "&lt;",
+        ">": "&gt;",
+        '"': "&quot;",
+        "'": "&#39;",
+        " ": "&nbsp;",
+      }[match])
+  );
 };
 
 /**
@@ -25,15 +29,19 @@ export const htmlEncode = (str) => {
  */
 export const htmlDecode = (str) => {
   // 非字符串直接返回，避免报错
-  if (typeof str !== 'string') return str;
-  
+  if (typeof str !== "string") return str;
+
   // 一次性替换所有常见实体，减少函数调用
-  return str.replace(/&amp;|&lt;|&gt;|&nbsp;|&#39;|&quot;/g, match => ({
-    '&amp;': '&',
-    '&lt;': '<',
-    '&gt;': '>',
-    '&nbsp;': ' ',
-    '&#39;': "'",
-    '&quot;': '"'
-  }[match]));
-};
+  return str.replace(
+    /&amp;|&lt;|&gt;|&nbsp;|&#39;|&quot;/g,
+    (match) =>
+      ({
+        "&amp;": "&",
+        "&lt;": "<",
+        "&gt;": ">",
+        "&nbsp;": " ",
+        "&#39;": "'",
+        "&quot;": '"',
+      }[match])
+  );
+};

package/helper/index.js

@@ -1,9 +1,5 @@
+import { db } from "./db.js";
+import { loaderSort, loadConfig } from "./loader.js";
+import { formatTime, formatDateFields } from "./time.js";
 
-import { db } from './db.js'
-import { loaderSort, loadConfig } from './loader.js'
-
-export {
-  db,
-  loaderSort,
-  loadConfig,
-}
+export { db, loaderSort, loadConfig, formatTime, formatDateFields };

package/helper/ip.js

@@ -3,34 +3,35 @@
  * @param {Object} req - Express请求对象
  * @returns {string} 格式化后的IP地址，默认返回空字符串
  */
-export const getIp = (req) =>{
-  
+export const getIp = (req) => {
   // 优先级从高到低获取可能的IP来源
   const ipSources = [
-    req.headers['x-forwarded-for'],  // 代理场景下的真实IP（可能多个，逗号分隔）
-    req.headers['x-real-ip'],       // 部分代理服务器使用
-    req.ip,                         // Express内置的IP获取（已处理代理）
-    req.connection?.remoteAddress,  // 底层连接的远程地址
-    req.socket?.remoteAddress,      // 套接字的远程地址
-    req.connection?.socket?.remoteAddress  // 连接套接字的远程地址
+    req.headers["x-forwarded-for"], // 代理场景下的真实IP（可能多个，逗号分隔）
+    req.headers["x-real-ip"], // 部分代理服务器使用
+    req.ip, // Express内置的IP获取（已处理代理）
+    req.connection?.remoteAddress, // 底层连接的远程地址
+    req.socket?.remoteAddress, // 套接字的远程地址
+    req.connection?.socket?.remoteAddress, // 连接套接字的远程地址
   ];
 
   // 从来源中找到第一个有效IP字符串
-  let ip = ipSources.find(source => typeof source === 'string' && source.trim() !== '');
-  
+  let ip = ipSources.find(
+    (source) => typeof source === "string" && source.trim() !== ""
+  );
+
   // 若未找到有效IP，直接返回空
-  if (!ip) return '';
+  if (!ip) return "";
 
   // 处理多IP情况（取第一个）
-  ip = ip.split(',').shift().trim();
+  ip = ip.split(",").shift().trim();
 
   // IPv6转IPv4处理
-  if (ip === '::1') {
-    return '127.0.0.1';  // 本地环回地址
+  if (ip === "::1") {
+    return "127.0.0.1"; // 本地环回地址
   }
-  if (ip.startsWith('::ffff:')) {
-    return ip.slice(7);  // 去除IPv6映射的IPv4前缀
+  if (ip.startsWith("::ffff:")) {
+    return ip.slice(7); // 去除IPv6映射的IPv4前缀
   }
 
   return ip;
-}
+};

package/helper/jwt.js

@@ -1,41 +1,40 @@
 import jwt from "jsonwebtoken";
 
-
 /**
- * 
+ *
  * @param {Object} data - 要存储在令牌中的数据（不建议存放敏感信息）
  * @param {string} secretKey - 用于签名的密钥
  * @param {string} time - 令牌过期时间,如 '1h'、'7d' 或秒数
  * @returns {string} 生成的JWT令牌
  */
-export function setToken(data={}, secretKey='chancms', time='7d') {
+export function setToken(data = {}, secretKey = "chancms", time = "7d") {
   try {
     return jwt.sign(data, secretKey, {
       expiresIn: time,
-      algorithm: 'HS256',
+      algorithm: "HS256",
     });
   } catch (error) {
-    console.error('令牌生成失败:', error.message);
+    console.error("令牌生成失败:", error.message);
     throw new Error(`生成令牌失败: ${error.message}`);
   }
 }
 
 // 获取token
-export async function getToken(token, secretKey='chancms') {
+export async function getToken(token, secretKey = "chancms") {
   return new Promise((resolve, reject) => {
-    jwt.verify(token, secretKey,(err, decode) => {
+    jwt.verify(token, secretKey, (err, decode) => {
       if (err) {
-       let errorMessage = '令牌验证失败';
-       if (err.name === 'TokenExpiredError') {
-         errorMessage = '令牌已过期';
-       } else if (err.name === 'JsonWebTokenError') {
-         errorMessage = '无效的令牌';
-       }
-       console.error(errorMessage, '令牌异常信息:', err.message);
-       return reject(new Error(errorMessage));
+        let errorMessage = "令牌验证失败";
+        if (err.name === "TokenExpiredError") {
+          errorMessage = "令牌已过期";
+        } else if (err.name === "JsonWebTokenError") {
+          errorMessage = "无效的令牌";
+        }
+        console.error(errorMessage, "令牌异常信息:", err.message);
+        return reject(new Error(errorMessage));
       } else {
         resolve(decode);
       }
     });
   });
-}
+}

package/helper/loader.js

@@ -1,5 +1,27 @@
 import fs from "fs";
 import path from "path";
+import { pathToFileURL } from "url";
+
+/**
+ * @description 实例化一个类，并将该类的所有方法绑定到一个新的对象上。
+ * @param {Function} className - 需要实例化的类。
+ *@returns {Object} 包含绑定方法的对象。
+ */
+export const bindClass = function (className) {
+  let obj = {};
+  const cls = new className();
+  Object.getOwnPropertyNames(cls.constructor.prototype).forEach(
+    (methodName) => {
+      if (
+        methodName !== "constructor" &&
+        typeof cls[methodName] === "function"
+      ) {
+        obj[methodName] = cls[methodName].bind(cls);
+      }
+    }
+  );
+  return obj;
+};
 
 /**
  *
@@ -26,6 +48,26 @@ export const loadConfig = async function () {
   return config;
 };
 
+/**
+ * 绑定已实例化对象的方法
+ * @param {Object} instance - 已实例化的对象
+ * @returns {Object} 绑定方法后的对象
+ */
+export const bindInstance = function (instance) {
+  Object.getOwnPropertyNames(Object.getPrototypeOf(instance)).forEach(
+    (methodName) => {
+      if (
+        methodName !== "constructor" &&
+        typeof instance[methodName] === "function"
+      ) {
+        instance[methodName] = instance[methodName].bind(instance);
+      }
+    }
+  );
+  return instance;
+};
+
+
 /**
  * 加载指定模块名下的所有控制器文件
  * @param {string} moduleName - 模块名称
@@ -45,17 +87,15 @@ export const loadController = async function (moduleName) {
 
   for (const file of files) {
     const filePath = path.join(dir, file);
-    const name = file.replace(/\.js$/i, ""); // 安全处理 .js 后缀
+    const name = file.replace(/\.js$/i, "");
 
     try {
       const module = await importFile(filePath);
-      let obj = module.default || module;
-
-      controller[name] = obj;
+      let obj = module?.default || module;
+      // 使用 bindClass 确保方法绑定了正确的 this
+      controller[name] = bindInstance(obj);
     } catch (e) {
       console.error(`加载控制器失败: ${filePath}`, e);
-      // 可选：抛出错误或继续加载其他文件
-      // throw e;
     }
   }
 

package/helper/time.js

@@ -21,8 +21,54 @@ export const formatDay = (data, time = true, format = "YYYY-MM-DD") => {
     }
   });
   return data;
-}
+};
 
 export const formatTime = (data, format = "YYYY-MM-DD HH:mm:ss") => {
-  return dayjs(data).format("YYYY-MM-DD HH:mm:ss");
-}
+  return dayjs(data).format(format);
+};
+
+/**
+ * 格式化对象或数组中的日期字段
+ * @param {Object|Array} data - 要格式化的数据
+ * @param {Object} options - 配置选项
+ * @param {Array} options.fields - 要格式化的字段名，默认 ['createdAt', 'updatedAt']
+ * @param {String} options.format - 日期格式，默认 'YYYY-MM-DD HH:mm:ss'
+ * @returns {Object|Array} - 格式化后的数据
+ */
+export const formatDateFields = (data, options = {}) => {
+  const {
+    fields = ['createdAt', 'updatedAt'],
+    format = 'YYYY-MM-DD HH:mm:ss',
+  } = options;
+
+  const isPlainObject = (val) =>
+    Object.prototype.toString.call(val) === '[object Object]';
+
+  if (isPlainObject(data)) {
+    const result = { ...data };
+    fields.forEach(field => {
+      const value = result[field];
+      if (value != null) {
+        const type = typeof value;
+        if (type === 'string' || type === 'number' || value instanceof Date) {
+          try {
+            result[field] = formatTime(value, format);
+          } catch (e) {
+            console.warn(`格式化字段 ${field} 失败:`, e.message);
+          }
+        }
+      }
+    });
+    return result;
+  }
+
+  if (Array.isArray(data)) {
+    return data.map(item =>
+      typeof item === 'object' && item !== null
+        ? formatDateFields(item, options)
+        : item
+    );
+  }
+
+  return data;
+};;

package/index.js

@@ -17,7 +17,7 @@ import {
   waf,
 } from "./middleware/index.js";
 import { db, loaderSort, loadConfig } from "./helper/index.js";
-import {dirname} from "./helper/file.js";
+import { dirname } from "./helper/file.js";
 
 class Chan {
   //版本号
@@ -29,6 +29,7 @@ class Chan {
   static Controller = Controller; //控制器
   static extend = {}; //组件扩展
   static middleware = {}; //中间件
+  static modules = {}; //模块
 
   constructor() {
     this.app = express();
@@ -65,8 +66,8 @@ class Chan {
       logger,
       cors,
     } = Chan.config;
-    
-    this.app.set('trust proxy', true);
+
+    this.app.set("trust proxy", true);
     log(this.app, logger);
     setFavicon(this.app);
     setCookie(this.app, cookieKey);
@@ -134,7 +135,9 @@ class Chan {
 
   async loadFn(_path, key) {
     if (fs.existsSync(_path)) {
-      const files = fs.readdirSync(_path).filter((file) => file.endsWith(".js"));
+      const files = fs
+        .readdirSync(_path)
+        .filter((file) => file.endsWith(".js"));
       for (const file of files) {
         const filePath = path.join(_path, file);
         let helperModule = await importFile(filePath);
@@ -162,7 +165,6 @@ class Chan {
         methods: Object.keys(r.route.methods),
       }));
 
-    console.log(routes);
   }
 
   run(cb) {

package/middleware/cookie.js

@@ -1,4 +1,4 @@
 import cookieParser from "cookie-parser";
-export const setCookie = (app,cookieKey) => {
-   app.use(cookieParser(cookieKey));
+export const setCookie = (app, cookieKey) => {
+  app.use(cookieParser(cookieKey));
 };

package/middleware/cors.js

@@ -1,4 +1,4 @@
 import cors from "cors";
-export const Cors = (app,_cors) => {
-    app.use(cors(_cors));
-};
+export const Cors = (app, _cors) => {
+  app.use(cors(_cors));
+};

package/middleware/header.js

@@ -1,4 +1,4 @@
-export let setHeader =  (app, { APP_NAME, APP_VERSION })=>{
+export let setHeader = (app, { APP_NAME, APP_VERSION }) => {
   app.use((req, res, next) => {
     res.setHeader("Create-By", "Chanjs");
     res.setHeader("X-Powered-By", "ChanCMS");