mm_cachebase 1.9.2 → 1.9.3

package/eslint.config.js

@@ -1,68 +1,211 @@
-const jsdoc = require('eslint-plugin-jsdoc');
-
-module.exports = [
-  {
-    files: ['lib/**/*.js'],
-    languageOptions: {
-      ecmaVersion: 2020,
-      sourceType: 'script'
-    },
-    plugins: {
-      jsdoc: jsdoc
-    },
-    rules: {
-      // JSDoc相关规则 - 设置为error级别强制要求
-      'jsdoc/require-jsdoc': ['error', {
-        require: {
-          FunctionDeclaration: true,
-          MethodDefinition: true,
-          ClassDeclaration: true,
-          ArrowFunctionExpression: true
-        }
-      }],
-      'jsdoc/check-param-names': 'off',
-      'jsdoc/check-tag-names': 'off',
-      'jsdoc/check-types': 'off',
-      'jsdoc/require-param': 'off',
-      'jsdoc/require-param-description': 'off',
-      'jsdoc/require-returns': 'off',
-      'jsdoc/require-returns-description': 'off',
-      
-      // 基础语法规则
-      'no-unused-vars': ['error', { args: 'none', vars: 'all' }],
-      'no-console': 'warn',
-      
-      // 代码风格规则
-      'indent': ['error', 2],
-      'quotes': ['error', 'single'],
-      'semi': ['error', 'always'],
-      'comma-dangle': ['error', 'never'],
-      'no-trailing-spaces': 'error',
-      'eol-last': 'error',
-      'max-len': ['error', { code: 100 }],
-      'max-lines-per-function': ['error', { max: 40 }],
-      'complexity': ['error', 12],
-      'max-depth': ['error', 4],
-      'max-params': ['error', 4],
-      
-      // 命名规则
-      'id-length': ['error', {
-        min: 1,
-        max: 20,
-        properties: 'always'
-      }]
-    }
-  },
-  {
-    files: ['test/**/*.js'],
-    languageOptions: {
-      ecmaVersion: 2020,
-      sourceType: 'script'
-    },
-    rules: {
-      // 测试文件中允许使用console
-      'no-console': 'off',
-      'no-unused-vars': 'off'
-    }
-  }
+'use strict';
+
+const namingConventionPlugin = require('mm_eslint');
+
+/**
+ * 基于个人规则的ESLint配置
+ * 符合最新ESLint Flat Config格式
+ */
+
+module.exports = [
+  {
+    files: ['**/*.js'],
+    plugins: {
+      'naming-convention': namingConventionPlugin,
+      'jsdoc': require('eslint-plugin-jsdoc')
+    },
+    languageOptions: {
+      ecmaVersion: 'latest',
+      sourceType: 'module',
+      parserOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module'
+      }
+    },
+    
+    // 命名规范规则 - 由自定义插件处理
+    rules: {
+      // 自定义命名规范插件规则（优先使用）
+      'naming-convention/class-name': 'error',
+      'naming-convention/function-name': 'error',
+      'naming-convention/method-name': 'error',
+      'naming-convention/variable-name': 'warn',
+      'naming-convention/constant-name': 'error',
+      'naming-convention/private-method-naming': 'warn',
+      'naming-convention/private-variable-naming': 'warn',
+      'naming-convention/param-name': 'warn',
+      'naming-convention/property-name': 'warn',
+      'naming-convention/instance-property': 'warn',
+      
+      // 禁用与命名规范插件冲突的默认规则
+      'camelcase': 'off',
+      'id-match': 'off',
+      'new-cap': 'off',
+      'id-length': 'off',
+      'id-denylist': 'off',
+      'id-blacklist': 'off'
+    }
+  },
+  
+  {
+    // 代码风格规则
+    rules: {
+      // 最大行长度100字符
+      'max-len': ['error', {
+        code: 100,
+        ignoreComments: true,
+        ignoreUrls: true,
+        ignoreStrings: true,
+        ignoreTemplateLiterals: true
+      }],
+      
+      // 缩进2空格
+      'indent': ['error', 2, {
+        SwitchCase: 1,
+        VariableDeclarator: 1,
+        outerIIFEBody: 1,
+        MemberExpression: 1,
+        FunctionDeclaration: { parameters: 1, body: 1 },
+        FunctionExpression: { parameters: 1, body: 1 },
+        CallExpression: { arguments: 1 },
+        ArrayExpression: 1,
+        ObjectExpression: 1,
+        ImportDeclaration: 1,
+        flatTernaryExpressions: false,
+        ignoreComments: false
+      }],
+      
+      // 单引号
+      'quotes': ['error', 'single', {
+        avoidEscape: true,
+        allowTemplateLiterals: true
+      }],
+      
+      // 禁止制表符
+      'no-tabs': 'error',
+      
+      // 行尾分号
+      'semi': ['error', 'always'],
+      
+      // 逗号风格
+      'comma-style': ['error', 'last'],
+      
+      // 逗号后必须有空格，逗号前不能有空格
+      'comma-spacing': ['error', {
+        before: false,
+        after: true
+      }]
+    }
+  },
+  
+  {
+    // 错误处理规则
+    rules: {
+      // 必须进行参数校验
+      'no-unused-vars': ['error', {
+        args: 'all',
+        argsIgnorePattern: '^_',
+        caughtErrors: 'all',
+        caughtErrorsIgnorePattern: '^_',
+        destructuredArrayIgnorePattern: '^_',
+        varsIgnorePattern: '^_',
+        ignoreRestSiblings: true
+      }],
+      
+      // 建议使用try-catch
+      'no-unsafe-finally': 'warn',
+      
+      // 禁止直接抛出字符串
+      'no-throw-literal': 'error'
+    }
+  },
+  
+  {
+    // 最佳实践规则
+    rules: {
+      // 优先使用async/await
+      'prefer-promise-reject-errors': 'error',
+      
+      // 避免副作用
+      'no-param-reassign': ['error', {
+        props: true,
+        ignorePropertyModificationsFor: [
+          'acc', // for reduce accumulators
+          'accumulator', // for reduce accumulators
+          'e', // for e.returnvalue
+          'ctx', // for Koa routing
+          'context', // for Koa routing
+          'req', // for Express requests
+          'request', // for Express requests
+          'res', // for Express responses
+          'response', // for Express responses
+          '$scope', // for Angular 1 scopes
+          'staticContext' // for ReactRouter context
+        ]
+      }],
+      
+      // 优先链式编程
+      'prefer-object-spread': 'error',
+      
+      // 优先函数式编程
+      'prefer-arrow-callback': 'error',
+      
+      // 方法长度限制
+      'max-lines-per-function': ['warn', {
+        max: 40,
+        skipBlankLines: true,
+        skipComments: true
+      }],
+      
+      // 复杂度限制
+      'complexity': ['warn', 10]
+    }
+  },
+  
+  {
+    // JSDoc规则
+    rules: {
+      // 要求公开方法有JSDoc注释
+      'jsdoc/require-jsdoc': ['warn', {
+        publicOnly: true,
+        require: {
+          FunctionDeclaration: true,
+          MethodDefinition: true,
+          ClassDeclaration: true,
+          ArrowFunctionExpression: false,
+          FunctionExpression: false
+        }
+      }],
+      
+      // 检查JSDoc语法
+      'jsdoc/check-alignment': 'warn',
+      'jsdoc/check-indentation': 'warn',
+      'jsdoc/check-param-names': 'warn',
+      'jsdoc/check-syntax': 'warn',
+      'jsdoc/check-tag-names': 'warn',
+      'jsdoc/check-types': 'warn',
+      'jsdoc/no-undefined-types': 'warn',
+      'jsdoc/require-description': 'warn',
+      'jsdoc/require-param': 'warn',
+      'jsdoc/require-param-description': 'warn',
+      'jsdoc/require-param-name': 'warn',
+      'jsdoc/require-param-type': 'warn',
+      'jsdoc/require-returns': 'warn',
+      'jsdoc/require-returns-check': 'warn',
+      'jsdoc/require-returns-description': 'warn',
+      'jsdoc/require-returns-type': 'warn',
+      'jsdoc/valid-types': 'warn'
+    }
+  },
+  
+  {
+    // 忽略规则
+    ignores: [
+      'node_modules/**',
+      'dist/**',
+      'build/**',
+      'coverage/**',
+      '*.min.js'
+    ]
+  }
 ];

package/index.js

@@ -11,10 +11,10 @@ class CacheBase extends Base {
 	/**
 	 * 默认配置静态变量
 	 */
-	static default_config = {
+	static config = {
 		enabled: true,
 		persist: true,
-		file_path: './test_cache/undefined.cache.json',
+		file_path: './cache/base.json',
 		debug: false,
 		auto_save: true,
 		save_interval: 30000,
@@ -28,7 +28,7 @@ class CacheBase extends Base {
 	 * @param {Object} config - 配置对象
 	 */
 	constructor(config = {}) {
-		super(config);
+		super(CacheBase.config);
 		// 存储实际数据
 		this._data = {};
 
@@ -2344,9 +2344,14 @@ CacheBase.prototype.hlen = function(key) {
 	});
 };
 
-// 导出类
-exports.CacheBase = CacheBase;
-exports.cachebaseAdmin = function(scope, dir) {
+
+/**
+ * @description CacheBase管理器，用于创建缓存
+ * @param {String} scope 作用域
+ * @param {Object} config 配置参数
+ * @return {Object} 返回一个CacheBase类实例
+ */
+function cachebaseAdmin(scope, config) {
 	if (!global.$) {
 		global.$ = {};
 	}
@@ -2361,11 +2366,18 @@ exports.cachebaseAdmin = function(scope, dir) {
 	}
 	var obj = global.$.pool.cachebase[scope];
 	if (!obj) {
-		const config = {
-			file_path: dir ? './cachebase_' + scope + '.json' : '/cache/cachebase_' + scope + '.json'
+		const dbConfig = {
+			file_path: config && config.dir ? './cachebase_' + scope + '.json' : '/cache/cachebase_' + scope + '.json',
+			...(typeof config === 'object' && config ? config : {})
 		};
-		global.$.pool.cachebase[scope] = new CacheBase(config);
+		global.$.pool.cachebase[scope] = new CacheBase(dbConfig);
 		obj = global.$.pool.cachebase[scope];
 	}
 	return obj;
+}
+
+// 导出类
+module.exports = {
+	CacheBase,
+	cachebaseAdmin,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mm_cachebase",
-    "version": "1.9.2",
+    "version": "1.9.3",
     "description": "一个轻量级的本地缓存类库，提供与Redis兼容的API接口，支持过期时间设置、哈希表操作、数值操作、字符串操作等功能，以及完整的事件通知系统和多文件持久化功能。",
     "main": "index.js",
     "scripts": {