schema-dsl 2.3.0 → 2.3.1

package/.github/workflows/ci.yml

@@ -13,7 +13,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [14.x, 16.x, 18.x, 20.x]
+        node-version: [16.x, 18.x, 20.x]
 
     steps:
     - uses: actions/checkout@v3
@@ -30,6 +30,4 @@ jobs:
     - name: Run tests
       run: npm test
 
-    - name: Run benchmarks
-      run: npm run test:benchmark
 

package/README.md

@@ -17,6 +17,8 @@
 
 ### 代码量减少 65% | 性能优秀 | 独家数据库导出
 
+### 🆕 v2.1.0 新特性：异步验证 + Schema 链式复用
+
 </div>
 
 ---
@@ -69,6 +71,63 @@ const result = validate(schema, {
 console.log(result.valid);  // true
 ```
 
+### 🆕 v2.1.0 新特性快速示例
+
+#### 异步验证 + 自动错误处理
+
+```javascript
+const { dsl, validateAsync, ValidationError } = require('schema-dsl');
+
+// Express 中使用
+app.post('/users', async (req, res, next) => {
+  try {
+    // 验证通过返回数据，失败自动抛出 ValidationError
+    const data = await validateAsync(userSchema, req.body);
+    const user = await db.users.insert(data);
+    res.json(user);
+  } catch (error) {
+    next(error); // 自动传递给错误处理中间件
+  }
+});
+
+// 全局错误处理
+app.use((error, req, res, next) => {
+  if (error instanceof ValidationError) {
+    return res.status(error.statusCode).json(error.toJSON());
+  }
+  next(error);
+});
+```
+
+#### Schema 链式复用 - 一行代码搞定
+
+```javascript
+const { SchemaUtils } = require('schema-dsl');
+
+// POST /users - 创建用户（严格模式）
+const createSchema = SchemaUtils
+  .omit(fullUserSchema, ['id', 'createdAt', 'updatedAt'])
+  .strict();
+
+// GET /users/:id - 查询用户（移除敏感字段）
+const publicSchema = SchemaUtils
+  .omit(fullUserSchema, ['password'])
+  .clean();
+
+// PATCH /users/:id - 更新用户（部分验证，宽松模式）
+const updateSchema = SchemaUtils
+  .pick(fullUserSchema, ['name', 'age'])
+  .partial()
+  .loose();
+```
+
+**详细文档**:
+- [异步验证完整指南](./docs/validate-async.md)
+- [Schema链式复用方法](./docs/schema-utils-chaining.md)
+- [Express集成示例](./examples/express-integration.js)
+
+---
+
 ### 📊 与其他库对比
 
 <table>
@@ -114,7 +173,9 @@ const schema = Joi.object({
 - **简洁语法**: 一行代码定义验证规则
 - **String扩展**: 字符串直接链式调用方法
 - **默认验证器**: 内置用户名、手机号、密码验证
-- **插件系统**: 强大的插件机制，支持自定义验证器和格式 🆕
+- **🆕 异步验证（v2.1.0）**: `validateAsync` + `ValidationError` 自动错误处理
+- **🆕 Schema链式复用（v2.1.0）**: 8个链式方法简化Schema复用
+- **插件系统**: 强大的插件机制，支持自定义验证器和格式
 - **数据库导出**: 导出MongoDB/MySQL/PostgreSQL Schema
 - **多语言支持**: 内置中英文，可自定义语言包
 - **高性能**: 基于ajv，支持编译缓存
@@ -260,7 +321,7 @@ schema-dsl 使用**运行时解析**，而 Zod 使用**编译时构建**。
    res.json({ rules: { username: 'string:3-32!' } });
    ```
 
-**权衡结果**：
+**权衡结果**
 ```
 损失：比 Zod 慢 1.9倍
 换来：代码量减少 65% + 完全动态性 + 独家功能
@@ -548,7 +609,7 @@ const result = validator.validate(validate, data);
 
 ## � 插件系统
 
-**v2.2.0 新增**：强大的插件机制，轻松扩展 SchemaIO 功能。
+**v2.2.0 新增**：强大的插件机制，轻松扩展 schema-dsl 功能。
 
 ### 快速开始
 
@@ -688,6 +749,8 @@ pluginManager.clear(schema-dsl);
 
 ## �🗄️ 数据库导出
 
+> ⚠️ **重要提示**: 并非所有 schema-dsl 特性都能导出到数据库。条件验证（`dsl.match()`、`dsl.if()`）、自定义验证器等无法导出。详见 [**导出限制说明**](docs/export-limitations.md)。
+
 ### MongoDB Schema
 
 ```javascript
@@ -861,7 +924,7 @@ const schema = dsl({
 - `type` - 类型不匹配
 
 **💡 简化的错误关键字**:  
-SchemaIO 对常见的错误关键字做了简化：
+schema-dsl 对常见的错误关键字做了简化：
 - `min` / `max` 代替 `minLength` / `maxLength` - 更简洁
 - 同时也支持完整关键字 `minLength` / `maxLength` - 向后兼容
 
@@ -932,7 +995,7 @@ const schema2 = dsl({ contactEmail: emailField() });
 const baseUser = dsl({ name: 'string!', email: 'email!' });
 const withAge = dsl({ age: 'number:18-120' });
 
-const merged = SchemaUtils.merge(baseUser, withAge);
+const extended = SchemaUtils.extend(baseUser, { age: 'number:18-120' });
 ```
 
 ### Schema 筛选
@@ -1067,7 +1130,7 @@ npm run coverage  # 测试覆盖率
 
 ### 贡献者
 
-感谢所有为 SchemaIO 做出贡献的开发者！
+感谢所有为 schema-dsl 做出贡献的开发者！
 
 <a href="https://github.com/vextjs/schema-dsl/graphs/contributors">
   <img src="https://contrib.rocks/image?repo=vextjs/schema-dsl" />
@@ -1119,4 +1182,3 @@ Made with ❤️ by [vextjs](https://github.com/vextjs)
 </div>
 
 
-

package/docs/FEATURE-INDEX.md

@@ -290,7 +290,7 @@ const schema1 = dsl({ email: emailField() });
 const schema2 = dsl({ contactEmail: emailField() });
 
 // Schema合并
-const merged = SchemaUtils.merge(schema1, schema2);
+const extended = SchemaUtils.extend(schema1, { age: 'number' });
 ```
 
 **文档位置**:

package/docs/INDEX.md

@@ -2,7 +2,7 @@
 
 > **更新时间**: 2025-12-29  
 > **用途**: 所有文档的快速导航  
-> **文档数量**: 26个文档（总计 11,600+ 行）
+> **文档数量**: 27个文档（总计 12,450+ 行）
 
 ---
 
@@ -45,6 +45,10 @@
 | [plugin-system.md](plugin-system.md) | 580行 | **插件系统指南** ⭐⭐ |
 | [api-reference.md](api-reference.md) | 534行 | API完整参考 ⭐⭐ |
 | [validate.md](validate.md) | 452行 | validate方法详解 ⭐ |
+| [**validate-async.md**](validate-async.md) | ~700行 | **异步验证方法详解** ⭐⭐⭐ |
+| [**schema-utils-chaining.md**](schema-utils-chaining.md) | ~680行 | **Schema链式复用方法** ⭐⭐⭐ |
+| [**schema-utils-best-practices.md**](schema-utils-best-practices.md) | ~500行 | **SchemaUtils最佳实践与常见陷阱** ⭐⭐⭐ |
+| [**schema-utils-advanced-issues.md**](schema-utils-advanced-issues.md) | ~600行 | **SchemaUtils深入问题分析** ⭐⭐ |
 
 ---
 
@@ -59,6 +63,9 @@
 | String 扩展 | [string-extensions.md](string-extensions.md) | `lib/core/StringExtensions.js` |
 | Validator 类 | [validate.md](validate.md) | `lib/core/Validator.js` |
 | validate() 函数 | [api-reference.md](api-reference.md) | `index.js` |
+| **validateAsync() 函数（v2.1.0）** | [validate-async.md](validate-async.md) | `index.js` |
+| **ValidationError 类（v2.1.0）** | [validate-async.md](validate-async.md#validationerror) | `lib/errors/ValidationError.js` |
+| **SchemaUtils 链式调用（v2.1.0）** | [schema-utils-chaining.md](schema-utils-chaining.md) | `lib/utils/SchemaUtils.js` |
 
 
 ---
@@ -67,6 +74,21 @@
 
 > 将 JSON Schema 转换为数据库 DDL 和验证规则
 
+> ⚠️ **重要提示**: 请先阅读 [**导出限制说明**](export-limitations.md)，了解哪些特性无法导出到数据库 Schema。
+
+### 导出限制说明 ⚠️
+
+| 文档 | 说明 |
+|------|------|
+| [**export-limitations.md**](export-limitations.md) | **导出限制完整说明**（必读）⭐⭐⭐ |
+
+**主要内容**:
+- ❌ 不支持导出的特性（条件验证、自定义验证器等）
+- ⚠️ 部分支持的特性（正则、范围、枚举等）
+- ✅ 完全支持的特性（基础类型、必填约束等）
+- 数据库特定限制对比（MongoDB/MySQL/PostgreSQL）
+- 最佳实践建议（分层验证、文档化约束等）
+
 ### MongoDB 导出器
 
 | 文档 | 行数 | 说明 |
@@ -149,6 +171,13 @@
 - 错误处理最佳实践
 
 ### 导出指南内容
+- MongoDB/MySQL/PostgreSQL 导出对比
+- 配置与自定义选项
+- 自动化迁移脚本
+- 版本管理与最佳实践
+- **⚠️ [导出限制说明](export-limitations.md) - 哪些特性无法导出** ⭐⭐⭐
+
+
 - 数据库导出概述
 - MongoDB/MySQL/PostgreSQL 导出教程
 - 多数据库同步方案
@@ -219,6 +248,6 @@
 - ⭐⭐ 核心文档
 - ⭐⭐⭐ 必读文档
 
-**最后更新**: 2025-12-26
+**最后更新**: 2025-12-29
 
 

package/docs/export-guide.md

@@ -3,6 +3,8 @@
 > **用途**: Schema 到数据库 DDL 的完整导出指南  
 > **阅读时间**: 10分钟
 
+> ⚠️ **重要提示**: 并非所有 SchemaIO 特性都能导出到数据库。请先阅读 [导出限制说明](export-limitations.md) 了解哪些特性不支持导出。
+
 ---
 
 ## 📑 目录
@@ -451,6 +453,7 @@ console.log('导出完成！');
 
 ## 相关文档
 
+- [**导出限制说明**](export-limitations.md) ⚠️ **必读**
 - [MongoDB 导出器](mongodb-exporter.md)
 - [MySQL 导出器](mysql-exporter.md)
 - [PostgreSQL 导出器](postgresql-exporter.md)