schema-dsl 1.0.0 → 1.0.4

package/lib/core/DslBuilder.js

@@ -97,12 +97,36 @@ class DslBuilder {
       }
     }
 
-    // 处理枚举
-    if (dsl.includes('|') && !dsl.includes(':')) {
-      return {
-        type: 'string',
-        enum: dsl.split('|').map(v => v.trim())
-      };
+    // 处理枚举（支持多种格式）
+    if (dsl.includes('|')) {
+      let enumType = 'string';  // 默认字符串
+      let enumValues = dsl;
+
+      // 识别 enum:type:values 或 enum:values 格式
+      if (dsl.startsWith('enum:')) {
+        const parts = dsl.slice(5).split(':');
+
+        if (parts.length === 2) {
+          // enum:type:values
+          enumType = parts[0];
+          enumValues = parts[1];
+        } else if (parts.length === 1) {
+          // enum:values (默认 string)
+          enumValues = parts[0];
+        }
+      } else if (dsl.includes(':') && !this._isKnownType(dsl.split(':')[0])) {
+        // 如果有冒号但不是已知类型（如 string:3-32），不作为枚举
+        // 让后续逻辑处理
+      } else {
+        // 简写形式：value1|value2
+        // 自动识别类型
+        enumType = this._detectEnumType(enumValues);
+      }
+
+      // 如果是枚举，解析值
+      if (enumValues.includes('|')) {
+        return this._parseEnum(enumType, enumValues);
+      }
     }
 
     // 处理类型:约束格式
@@ -230,7 +254,14 @@ class DslBuilder {
       'hexColor': { type: 'string', pattern: '^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$', _customMessages: { 'pattern': 'pattern.hexColor' } },
       'macAddress': { type: 'string', pattern: '^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$', _customMessages: { 'pattern': 'pattern.macAddress' } },
       'cron': { type: 'string', pattern: '^(\\*|([0-9]|1[0-9]|2[0-9]|3[0-9]|4[0-9]|5[0-9])|\\*\\/([0-9]|1[0-9]|2[0-9]|3[0-9]|4[0-9]|5[0-9])) (\\*|([0-9]|1[0-9]|2[0-3])|\\*\\/([0-9]|1[0-9]|2[0-3])) (\\*|([1-9]|1[0-9]|2[0-9]|3[0-1])|\\*\\/([1-9]|1[0-9]|2[0-9]|3[0-1])) (\\*|([1-9]|1[0-2])|\\*\\/([1-9]|1[0-2])) (\\*|([0-6])|\\*\\/([0-6]))$', _customMessages: { 'pattern': 'pattern.cron' } },
-      'any': {}
+      'slug': { type: 'string', pattern: '^[a-z0-9]+(?:-[a-z0-9]+)*$', _customMessages: { 'pattern': 'pattern.slug' } },
+      'any': {},
+      // v1.0.2 新增类型
+      'alphanum': { type: 'string', alphanum: true },
+      'lower': { type: 'string', lowercase: true },
+      'upper': { type: 'string', uppercase: true },
+      'json': { type: 'string', jsonString: true },
+      'port': { type: 'integer', port: true }
     };
 
     return typeMap[type] || { type: 'string' };
@@ -260,8 +291,10 @@ class DslBuilder {
         const value = constraint.trim();
         if (value) {
           if (type === 'string') {
-            result.maxLength = parseInt(value);
+            // 🔴 String单值 = 精确长度（常用于验证码、国家代码等）
+            result.exactLength = parseInt(value);
           } else {
+            // Number单值 = 最大值（符合直觉：不超过某值）
             result.maximum = parseFloat(value);
           }
         }
@@ -271,6 +304,76 @@ class DslBuilder {
     return result;
   }
 
+  /**
+   * 检查是否为已知类型
+   * @private
+   */
+  _isKnownType(type) {
+    const knownTypes = [
+      'string', 'number', 'integer', 'boolean', 'object', 'array', 'null',
+      'email', 'url', 'uuid', 'date', 'datetime', 'time', 'ipv4', 'ipv6',
+      'binary', 'objectId', 'hexColor', 'macAddress', 'cron', 'any',
+      'phone', 'idCard', 'creditCard', 'licensePlate', 'postalCode', 'passport',
+      // v1.0.2 新增
+      'alphanum', 'lower', 'upper', 'json', 'port'
+    ];
+    return knownTypes.includes(type);
+  }
+
+  /**
+   * 自动检测枚举类型
+   * @private
+   */
+  _detectEnumType(enumValues) {
+    const values = enumValues.split('|').map(v => v.trim());
+
+    // 检查是否全部为布尔值
+    const allBoolean = values.every(v => v === 'true' || v === 'false');
+    if (allBoolean) return 'boolean';
+
+    // 检查是否全部为数字
+    const allNumber = values.every(v => !isNaN(parseFloat(v)) && isFinite(v));
+    if (allNumber) return 'number';
+
+    // 默认字符串
+    return 'string';
+  }
+
+  /**
+   * 解析枚举值
+   * @private
+   */
+  _parseEnum(enumType, enumValues) {
+    let values = enumValues.split('|').map(v => v.trim());
+
+    // 类型转换
+    if (enumType === 'boolean') {
+      values = values.map(v => {
+        if (v === 'true') return true;
+        if (v === 'false') return false;
+        throw new Error(`Invalid boolean enum value: ${v}. Must be 'true' or 'false'`);
+      });
+      return { type: 'boolean', enum: values };
+    } else if (enumType === 'number') {
+      values = values.map(v => {
+        const num = parseFloat(v);
+        if (isNaN(num)) throw new Error(`Invalid number enum value: ${v}`);
+        return num;
+      });
+      return { type: 'number', enum: values };
+    } else if (enumType === 'integer') {
+      values = values.map(v => {
+        const num = parseInt(v, 10);
+        if (isNaN(num)) throw new Error(`Invalid integer enum value: ${v}`);
+        return num;
+      });
+      return { type: 'integer', enum: values };
+    } else {
+      // 字符串枚举（默认）
+      return { type: 'string', enum: values };
+    }
+  }
+
   /**
    * 添加正则表达式验证
    * @param {RegExp|string} regex - 正则表达式
@@ -734,6 +837,395 @@ class DslBuilder {
     }
     return this.pattern(config.pattern).messages({ 'pattern': config.key });
   }
+
+  // ========== v1.0.2 新增验证器方法 ==========
+
+  /**
+   * String 最小长度（使用AJV原生minLength）
+   * @param {number} n - 最小长度
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('string!').min(3)  // 最少3个字符
+   */
+  min(n) {
+    if (this._baseSchema.type !== 'string') {
+      throw new Error('min() only applies to string type');
+    }
+    this._baseSchema.minLength = n;
+    return this;
+  }
+
+  /**
+   * String 最大长度（使用AJV原生maxLength）
+   * @param {number} n - 最大长度
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('string!').max(32)  // 最多32个字符
+   */
+  max(n) {
+    if (this._baseSchema.type !== 'string') {
+      throw new Error('max() only applies to string type');
+    }
+    this._baseSchema.maxLength = n;
+    return this;
+  }
+
+  /**
+   * String 精确长度
+   * @param {number} n - 精确长度
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('string!').length(11)  // 必须是11个字符
+   */
+  length(n) {
+    if (this._baseSchema.type !== 'string') {
+      throw new Error('length() only applies to string type');
+    }
+    this._baseSchema.exactLength = n;
+    return this;
+  }
+
+  /**
+   * String 只能包含字母和数字
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('string!').alphanum()  // 只能是字母和数字
+   */
+  alphanum() {
+    if (this._baseSchema.type !== 'string') {
+      throw new Error('alphanum() only applies to string type');
+    }
+    this._baseSchema.alphanum = true;
+    return this;
+  }
+
+  /**
+   * String 不能包含前后空格
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('string!').trim()  // 不能有前后空格
+   */
+  trim() {
+    if (this._baseSchema.type !== 'string') {
+      throw new Error('trim() only applies to string type');
+    }
+    this._baseSchema.trim = true;
+    return this;
+  }
+
+  /**
+   * String 必须是小写
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('string!').lowercase()  // 必须全小写
+   */
+  lowercase() {
+    if (this._baseSchema.type !== 'string') {
+      throw new Error('lowercase() only applies to string type');
+    }
+    this._baseSchema.lowercase = true;
+    return this;
+  }
+
+  /**
+   * String 必须是大写
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('string!').uppercase()  // 必须全大写
+   */
+  uppercase() {
+    if (this._baseSchema.type !== 'string') {
+      throw new Error('uppercase() only applies to string type');
+    }
+    this._baseSchema.uppercase = true;
+    return this;
+  }
+
+  /**
+   * Number 小数位数限制
+   * @param {number} n - 最大小数位数
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('number!').precision(2)  // 最多2位小数
+   */
+  precision(n) {
+    if (this._baseSchema.type !== 'number' && this._baseSchema.type !== 'integer') {
+      throw new Error('precision() only applies to number type');
+    }
+    this._baseSchema.precision = n;
+    return this;
+  }
+
+  /**
+   * Number 倍数验证（使用AJV原生multipleOf）
+   * @param {number} n - 必须是此数的倍数
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('number!').multiple(5)  // 必须是5的倍数
+   */
+  multiple(n) {
+    if (this._baseSchema.type !== 'number' && this._baseSchema.type !== 'integer') {
+      throw new Error('multiple() only applies to number type');
+    }
+    this._baseSchema.multipleOf = n;
+    return this;
+  }
+
+  /**
+   * Number 端口号验证（1-65535）
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('integer!').port()  // 必须是有效端口号
+   */
+  port() {
+    if (this._baseSchema.type !== 'number' && this._baseSchema.type !== 'integer') {
+      throw new Error('port() only applies to number type');
+    }
+    this._baseSchema.port = true;
+    return this;
+  }
+
+  /**
+   * Object 要求所有属性都必须存在
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl({ name: 'string', age: 'number' }).requireAll()
+   */
+  requireAll() {
+    if (this._baseSchema.type !== 'object') {
+      throw new Error('requireAll() only applies to object type');
+    }
+    this._baseSchema.requiredAll = true;
+    return this;
+  }
+
+  /**
+   * Object 严格模式，不允许额外属性
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl({ name: 'string!' }).strict()
+   */
+  strict() {
+    if (this._baseSchema.type !== 'object') {
+      throw new Error('strict() only applies to object type');
+    }
+    this._baseSchema.strictSchema = true;
+    return this;
+  }
+
+  /**
+   * Array 不允许稀疏数组
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('array<string>').noSparse()
+   */
+  noSparse() {
+    if (this._baseSchema.type !== 'array') {
+      throw new Error('noSparse() only applies to array type');
+    }
+    this._baseSchema.noSparse = true;
+    return this;
+  }
+
+  /**
+   * Array 必须包含指定元素
+   * @param {Array} items - 必须包含的元素
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('array<string>').includesRequired(['admin', 'user'])
+   */
+  includesRequired(items) {
+    if (this._baseSchema.type !== 'array') {
+      throw new Error('includesRequired() only applies to array type');
+    }
+    if (!Array.isArray(items)) {
+      throw new Error('includesRequired() requires an array parameter');
+    }
+    this._baseSchema.includesRequired = items;
+    return this;
+  }
+
+  /**
+   * Date 自定义日期格式验证
+   * @param {string} fmt - 日期格式（YYYY-MM-DD, YYYY/MM/DD, DD-MM-YYYY, DD/MM/YYYY, ISO8601）
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('string!').dateFormat('YYYY-MM-DD')
+   */
+  dateFormat(fmt) {
+    if (this._baseSchema.type !== 'string') {
+      throw new Error('dateFormat() only applies to string type');
+    }
+    this._baseSchema.dateFormat = fmt;
+    return this;
+  }
+
+  /**
+   * Date 必须晚于指定日期
+   * @param {string} date - 比较日期
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('date!').after('2024-01-01')
+   */
+  after(date) {
+    if (this._baseSchema.type !== 'string') {
+      throw new Error('after() only applies to string type');
+    }
+    this._baseSchema.dateGreater = date;
+    return this;
+  }
+
+  /**
+   * Date 必须早于指定日期
+   * @param {string} date - 比较日期
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('date!').before('2025-12-31')
+   */
+  before(date) {
+    if (this._baseSchema.type !== 'string') {
+      throw new Error('before() only applies to string type');
+    }
+    this._baseSchema.dateLess = date;
+    return this;
+  }
+
+  /**
+   * Pattern 域名验证
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('string!').domain()
+   */
+  domain() {
+    if (this._baseSchema.type !== 'string') {
+      throw new Error('domain() only applies to string type');
+    }
+    const config = patterns.common.domain;
+    return this.pattern(config.pattern).messages({ 'pattern': config.key });
+  }
+
+  /**
+   * Pattern IP地址验证（IPv4或IPv6）
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('string!').ip()
+   */
+  ip() {
+    if (this._baseSchema.type !== 'string') {
+      throw new Error('ip() only applies to string type');
+    }
+    const config = patterns.common.ip;
+    return this.pattern(config.pattern).messages({ 'pattern': config.key });
+  }
+
+  /**
+   * Pattern Base64编码验证
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('string!').base64()
+   */
+  base64() {
+    if (this._baseSchema.type !== 'string') {
+      throw new Error('base64() only applies to string type');
+    }
+    const config = patterns.common.base64;
+    return this.pattern(config.pattern).messages({ 'pattern': config.key });
+  }
+
+  /**
+   * Pattern JWT令牌验证
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('string!').jwt()
+   */
+  jwt() {
+    if (this._baseSchema.type !== 'string') {
+      throw new Error('jwt() only applies to string type');
+    }
+    const config = patterns.common.jwt;
+    return this.pattern(config.pattern).messages({ 'pattern': config.key });
+  }
+
+  /**
+   * Pattern JSON字符串验证
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('string!').json()
+   */
+  json() {
+    if (this._baseSchema.type !== 'string') {
+      throw new Error('json() only applies to string type');
+    }
+    this._baseSchema.jsonString = true;
+    return this;
+  }
+
+  /**
+   * Pattern URL slug验证 (v1.0.3)
+   * URL slug只能包含小写字母、数字和连字符
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('string!').slug()  // my-blog-post, hello-world-123
+   */
+  slug() {
+    if (this._baseSchema.type !== 'string') {
+      throw new Error('slug() only applies to string type');
+    }
+    this._baseSchema.pattern = '^[a-z0-9]+(?:-[a-z0-9]+)*$';
+    this._baseSchema._customMessages = this._baseSchema._customMessages || {};
+    this._baseSchema._customMessages['pattern'] = 'pattern.slug';
+    return this;
+  }
+
+
+  /**
+   * 日期大于验证 (v1.0.2)
+   * @param {string} date - 对比日期
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('string!').dateGreater('2025-01-01')
+   */
+  dateGreater(date) {
+    this._baseSchema.dateGreater = date;
+    return this;
+  }
+
+  /**
+   * 日期小于验证 (v1.0.2)
+   * @param {string} date - 对比日期
+   * @returns {DslBuilder}
+   *
+   * @example
+   * dsl('string!').dateLess('2025-12-31')
+   */
+  dateLess(date) {
+    this._baseSchema.dateLess = date;
+    return this;
+  }
 }
 
 module.exports = DslBuilder;

package/lib/core/StringExtensions.js

@@ -172,6 +172,32 @@ function installStringExtensions(dslFunction) {
     return dslFunction(String(this)).passport(country);
   };
 
+  /**
+   * v1.0.2 新增方法（dateGreater和dateLess）
+   * v1.0.3 新增方法（slug）
+   */
+
+  /**
+   * URL slug验证
+   */
+  String.prototype.slug = function() {
+    return dslFunction(String(this)).slug();
+  };
+
+  /**
+   * 日期大于验证
+   */
+  String.prototype.dateGreater = function(date) {
+    return dslFunction(String(this)).dateGreater(date);
+  };
+
+  /**
+   * 日期小于验证
+   */
+  String.prototype.dateLess = function(date) {
+    return dslFunction(String(this)).dateLess(date);
+  };
+
   // 标记已安装
   String.prototype._dslExtensionsInstalled = true;
 }
@@ -200,6 +226,11 @@ function uninstallStringExtensions() {
   delete String.prototype.licensePlate;
   delete String.prototype.postalCode;
   delete String.prototype.passport;
+  // v1.0.2 新增
+  delete String.prototype.dateGreater;
+  delete String.prototype.dateLess;
+  // v1.0.3 新增
+  delete String.prototype.slug;
   delete String.prototype._dslExtensionsInstalled;
 }
 

package/lib/core/Validator.js

@@ -58,6 +58,13 @@ class Validator {
     // 错误格式化器
     this.errorFormatter = new ErrorFormatter();
 
+    // ✅ 性能优化：WeakMap 缓存键（避免 JSON.stringify）
+    this.schemaMap = new WeakMap();
+    this.schemaKeyCounter = 0;
+
+    // ✅ 性能优化：缓存 DslBuilder 转换结果
+    this.dslSchemaCache = new WeakMap();
+
     // 自定义关键字注册表
     this.customKeywords = new Map();
   }
@@ -102,18 +109,35 @@ class Validator {
    * @returns {Object} 验证结果 { valid: boolean, errors: Array, data: * }
    */
   validate(schema, data, options = {}) {
-    const shouldFormat = options.format !== false;
-    const locale = options.locale || Locale.getLocale();
-
-    // 如果指定了语言，临时切换
-    const originalLocale = options.locale ? Locale.getLocale() : null;
-    if (options.locale) {
+    // ✅ 性能优化：提前检查语言切换，避免99%的无效操作
+    if (options.locale && options.locale !== Locale.getLocale()) {
+      const originalLocale = Locale.getLocale();
       Locale.setLocale(options.locale);
+      try {
+        return this._validateInternal(schema, data, options);
+      } finally {
+        Locale.setLocale(originalLocale);
+      }
     }
 
-    // 如果schema是DslBuilder实例，转换为JSON Schema
+    // 正常流程（无需切换语言）
+    return this._validateInternal(schema, data, options);
+  }
+
+  /**
+   * 内部验证方法
+   * @private
+   */
+  _validateInternal(schema, data, options = {}) {
+    const shouldFormat = options.format !== false;
+    const locale = options.locale || Locale.getLocale();
+
+    // ✅ 性能优化：缓存 DslBuilder 转换结果
     if (schema && typeof schema.toSchema === 'function') {
-      schema = schema.toSchema();
+      if (!this.dslSchemaCache.has(schema)) {
+        this.dslSchemaCache.set(schema, schema.toSchema());
+      }
+      schema = this.dslSchemaCache.get(schema);
     }
 
     // 检查是否需要移除额外字段 (clean 模式)
@@ -167,11 +191,6 @@ class Validator {
         }],
         data
       };
-    } finally {
-      // 恢复原语言
-      if (originalLocale) {
-        Locale.setLocale(originalLocale);
-      }
     }
   }
 
@@ -338,8 +357,16 @@ class Validator {
    * @returns {string} 缓存键
    */
   _generateCacheKey(schema) {
-    // 简单实现：使用JSON字符串的hash
-    // 生产环境建议使用更高效的hash算法
+    // ✅ 性能优化：使用 WeakMap 避免昂贵的 JSON.stringify
+    // 对于对象类型的 schema，使用 WeakMap 存储唯一标识符
+    if (typeof schema === 'object' && schema !== null) {
+      if (!this.schemaMap.has(schema)) {
+        this.schemaMap.set(schema, `schema_${++this.schemaKeyCounter}`);
+      }
+      return this.schemaMap.get(schema);
+    }
+
+    // 对于原始类型或 null，降级到字符串化
     return JSON.stringify(schema);
   }
 

package/lib/errors/ValidationError.js

@@ -4,7 +4,7 @@
  * 用于 validateAsync() 方法，验证失败时自动抛出
  *
  * @module lib/errors/ValidationError
- * @version 2.1.0
+ * @version 1.0.3
  */
 
 /**
@@ -119,7 +119,7 @@ class ValidationError extends Error {
    * }
    */
   getFieldError(field) {
-     // 规范化字段名（移除前导斜杠）
+    // 规范化字段名（移除前导斜杠）
     const normalizedField = field.replace(/^\//, '');
 
     // 查找匹配的错误（支持多种路径格式）
@@ -182,7 +182,7 @@ class ValidationError extends Error {
 
 // Support calling without new
 const ValidationErrorProxy = new Proxy(ValidationError, {
-  apply: function(target, thisArg, argumentsList) {
+  apply: function (target, thisArg, argumentsList) {
     return new target(...argumentsList);
   }
 });