schema-dsl 1.2.4 → 2.0.0

package/examples/README.md

@@ -1,81 +0,0 @@
-# schema-dsl 示例代码
-
-本目录包含 schema-dsl 的各种功能示例。
-
-## 📂 示例列表
-
-### 基础示例
-- [simple-example.js](simple-example.js) - 简单入门示例
-- [dsl-style.js](dsl-style.js) - DSL 风格完整示例
-- [enum.examples.js](enum.examples.js) - 枚举类型验证示例
-
-### 扩展功能
-- [string-extensions.js](string-extensions.js) - String 扩展功能（username、password、phone）
-- [custom-extension.js](custom-extension.js) - 自定义扩展示例
-- [array-dsl-example.js](array-dsl-example.js) - 数组 DSL 语法示例
-
-### 数据库导出
-- [export-demo.js](export-demo.js) - 导出为 MongoDB/MySQL/PostgreSQL Schema
-
-### 国际化 (i18n)
-- [dynamic-locale-configuration.js](dynamic-locale-configuration.js) - 动态语言配置示例
-- [dynamic-locale-example.js](dynamic-locale-example.js) - 动态语言切换示例
-- [i18n-full-demo.js](i18n-full-demo.js) - 完整国际化示例
-- [i18n-memory-safety.examples.js](i18n-memory-safety.examples.js) - i18n 内存安全示例
-
-### Schema 工具
-- [schema-utils-chaining.examples.js](schema-utils-chaining.examples.js) - SchemaUtils 链式调用示例
-- [dsl-match-example.js](dsl-match-example.js) - 条件验证 match 示例
-- [new-features-comparison.js](new-features-comparison.js) - 新版本功能对比
-
-### 插件系统
-- [plugin-system.examples.js](plugin-system.examples.js) - 插件系统完整示例
-
-### 实际应用
-- [express-integration.js](express-integration.js) - Express 集成完整示例
-- [middleware-usage.js](middleware-usage.js) - 中间件使用示例
-- [user-registration/](user-registration/) - 用户注册流程完整示例
-  - [schema.js](user-registration/schema.js) - Schema 定义
-  - [routes.js](user-registration/routes.js) - 路由定义
-  - [server.js](user-registration/server.js) - 服务器入口
-- [password-reset/](password-reset/) - 密码重置流程示例
-  - [schema.js](password-reset/schema.js) - Schema 定义
-  - [test.js](password-reset/test.js) - 测试用例
-
-## 🚀 快速开始
-
-### 1. 安装依赖
-
-```bash
-cd schema-dsl
-npm install
-```
-
-### 2. 运行示例
-
-```bash
-# 运行简单示例
-node examples/simple-example.js
-
-# 运行 String 扩展示例
-node examples/string-extensions.js
-
-# 运行导出示例
-node examples/export-demo.js
-```
-
-### 3. 查看完整文档
-
-访问 [docs/INDEX.md](../docs/INDEX.md) 查看完整文档索引。
-
-## 📖 相关文档
-
-- [DSL 语法文档](../docs/dsl-syntax.md)
-- [String 扩展文档](../docs/string-extensions.md)
-- [插件系统文档](../docs/plugin-system.md)
-- [API 参考](../docs/api-reference.md)
-- [最佳实践](../docs/best-practices.md)
-
-## 🤝 贡献
-
-欢迎提交新的示例！请参考 [CONTRIBUTING.md](../CONTRIBUTING.md)。

package/examples/array-dsl-example.js

@@ -1,227 +0,0 @@
-/**
- * SchemaIO v2.0.1 新功能完整示例
- *
- * 展示v2.0.1版本的核心功能
- */
-
-const { dsl, validate, SchemaUtils, DslBuilder, Validator } = require('../index');
-
-console.log('========== SchemaIO v2.0.1 新功能示例 ==========\n');
-
-// ========== 1. DSL数组语法 ==========
-console.log('✨ 1. DSL数组语法');
-
-const tagsSchema = dsl({
-  // 使用DSL数组语法：array:min-max<itemType>
-  tags: 'array:1-10<string:1-20>!'
-});
-
-console.log('验证标签:', validate(tagsSchema, { tags: ['javascript', 'nodejs'] }).valid);
-console.log('空标签验证:', validate(tagsSchema, { tags: [] }).valid); // false
-console.log('');
-
-// ========== 2. when条件验证 ==========
-console.log('✨ 2. when条件验证');
-
-const contactSchema = dsl({
-  contactType: 'email|phone',
-  // 使用 dsl.match 条件验证
-  contact: dsl.match('contactType', {
-    email: 'email!',
-    phone: 'string:11!'
-  })
-});
-
-console.log('match条件Schema已创建');
-console.log('');
-
-// ========== 3. 自定义验证器 ==========
-console.log('✨ 3. 自定义验证器');
-
-const customSchema = dsl({
-  username: dsl('string:3-32!')
-    .custom((value) => {
-      // 返回错误消息字符串表示失败
-      const forbidden = ['admin', 'root'];
-      if (forbidden.includes(value)) {
-        return '该用户名已被保留';
-      }
-      // 不返回任何值表示通过
-    })
-    .label('用户名')
-});
-
-console.log('自定义验证器Schema已创建');
-console.log('');
-
-// ========== 4. 默认验证器快捷方法 ==========
-console.log('✨ 4. 默认验证器快捷方法');
-
-const userSchema = dsl({
-  // ✨ username验证器：自动设置正则和长度
-  username: dsl('string!').username().label('用户名'),
-
-  // ✨ password验证器：根据强度设置验证
-  password: dsl('string!').password('medium').label('密码'),
-
-  // ✨ phone验证器：根据国家设置正则
-  phone: dsl('string!').phone('cn').label('手机号')
-});
-
-console.log('验证用户:', validate(userSchema, {
-  username: 'john_doe',
-  password: 'Test1234',
-  phone: '13800138000'
-}).valid);
-console.log('');
-
-// ========== 5. Schema复用 ==========
-console.log('✨ 5. Schema复用');
-
-// ✨ 新特性：创建可复用片段
-const emailField = SchemaUtils.reusable(() =>
-  dsl('email!').label('邮箱地址')
-);
-
-const schema1 = dsl({ email: emailField() });
-const schema2 = dsl({ contactEmail: emailField() });
-
-console.log('Schema复用成功:', schema1.properties.email.format === 'email');
-console.log('');
-
-// ========== 6. Schema合并 ==========
-console.log('✨ 6. Schema合并');
-
-const baseUser = dsl({
-  name: 'string!',
-  email: 'email!'
-});
-
-const withAge = dsl({
-  age: 'number:18-120'
-});
-
-// ✨ 新特性：merge方法
-const extendedSchema = SchemaUtils.extend(baseUser, withAge);
-
-console.log('合并后字段数:', Object.keys(extendedSchema.properties).length);
-console.log('');
-
-// ========== 7. Schema pick/omit ==========
-console.log('✨ 7. Schema pick/omit');
-
-const fullUser = dsl({
-  name: 'string!',
-  email: 'email!',
-  password: 'string!',
-  age: 'number'
-});
-
-// ✨ 新特性：pick方法
-const publicUser = SchemaUtils.pick(fullUser, ['name', 'email']);
-
-console.log('公开用户字段:', Object.keys(publicUser.properties));
-console.log('');
-
-// ========== 8. 性能监控 ==========
-console.log('✨ 8. 性能监控');
-
-// Validator 已在文件开头导入
-const validator = new Validator(); // 高级用法：创建实例以增强功能
-
-// ✨ 新特性：性能监控
-const enhancedValidator = SchemaUtils.withPerformance(validator);
-
-const perfResult = enhancedValidator.validate(
-  dsl({ email: 'email!' }),
-  { email: 'test@example.com' }
-);
-
-console.log('验证耗时:', perfResult.performance.duration, 'ms');
-console.log('');
-
-// ========== 9. 批量验证 ==========
-console.log('✨ 9. 批量验证');
-
-const users = [
-  { email: 'user1@example.com' },
-  { email: 'invalid' },
-  { email: 'user3@example.com' }
-];
-
-// ✨ 新特性：批量验证优化
-const batchResult = SchemaUtils.validateBatch(
-  dsl({ email: 'email!' }),
-  users,
-  validator
-);
-
-console.log('批量验证总数:', batchResult.summary.total);
-console.log('有效数量:', batchResult.summary.valid);
-console.log('无效数量:', batchResult.summary.invalid);
-console.log('平均耗时:', batchResult.summary.averageTime.toFixed(2), 'ms');
-console.log('');
-
-// ========== 10. Schema导出文档 ==========
-console.log('✨ 10. Schema导出文档');
-
-const docSchema = dsl({
-  name: dsl('string:1-50!').label('姓名').description('用户真实姓名'),
-  email: dsl('email!').label('邮箱').description('用于登录'),
-  age: dsl('number:18-120').label('年龄')
-});
-
-// ✨ 新特性：导出Markdown
-const markdown = SchemaUtils.toMarkdown(docSchema, { title: '用户Schema' });
-
-console.log('Markdown文档生成:', markdown.length, '字符');
-console.log('');
-console.log('--- Markdown预览 ---');
-console.log(markdown.substring(0, 300) + '...');
-console.log('');
-
-// ========== 11. 嵌套深度验证 ==========
-console.log('✨ 11. 嵌套深度验证');
-
-const deepSchema = dsl({
-  level1: {
-    level2: {
-      level3: {
-        level4: {
-          value: 'string'
-        }
-      }
-    }
-  }
-});
-
-// ✨ 新特性：嵌套深度检查
-const depthCheck = DslBuilder.validateNestingDepth(deepSchema, 3);
-
-console.log('嵌套深度检查:', depthCheck.message);
-console.log('实际深度:', depthCheck.depth);
-console.log('是否超限:', !depthCheck.valid ? '⚠️ 是' : '✅ 否');
-console.log('');
-
-// ========== 总结 ==========
-console.log('========== 功能总结 ==========');
-console.log(`
-✨ SchemaIO v2.0.1 核心功能：
-
-1. ✅ DSL数组语法 - array:min-max<itemType>
-2. ✅ when条件验证 - 条件字段验证
-3. ✅ 自定义验证器 - .custom()链式调用
-4. ✅ 默认验证器 - username/password/phone
-5. ✅ Schema复用 - reusable()方法
-6. ✅ Schema合并 - merge()方法
-7. ✅ Schema筛选 - pick/omit方法
-8. ✅ 性能监控 - withPerformance()
-9. ✅ 批量验证 - validateBatch()优化
-10. ✅ 文档导出 - toMarkdown/toHTML
-11. ✅ 嵌套检查 - validateNestingDepth()
-
-🎉 SchemaIO v2.0.1 - 功能强大，使用简单！
-`);
-
-
-

package/examples/conditional-example.js

@@ -1,288 +0,0 @@
-/**
- * ConditionalBuilder 完整示例
- *
- * 展示链式条件构建器的各种用法
- */
-
-const { dsl, validate } = require('../index');
-
-console.log('========================================');
-console.log('ConditionalBuilder 示例');
-console.log('========================================\n');
-
-// ============================================
-// 示例1：简单条件 + 错误消息
-// ============================================
-console.log('【示例1】简单条件 + 错误消息');
-console.log('----------------------------');
-
-const schema1 = dsl({
-  age: 'number!',
-  status: dsl.if((data) => data.age >= 18)
-    .message('未成年用户不能注册')
-});
-
-const testData1a = { age: 20, status: 'active' };
-const result1a = validate(schema1, testData1a);
-console.log('✅ 成年用户:', result1a.valid ? '验证通过' : '验证失败');
-
-const testData1b = { age: 16, status: 'active' };
-const result1b = validate(schema1, testData1b);
-console.log('❌ 未成年用户:', result1b.valid ? '验证通过' : '验证失败');
-if (!result1b.valid) {
-  console.log('   错误消息:', result1b.errors[0].message);
-}
-
-// ============================================
-// 示例2：条件 + then/else（动态Schema）
-// ============================================
-console.log('\n【示例2】条件 + then/else（动态Schema）');
-console.log('----------------------------');
-
-const schema2 = dsl({
-  userType: 'string!',
-  email: dsl.if((data) => data.userType === 'admin')
-    .then('email!')  // 管理员必填
-    .else('email')   // 普通用户可选
-});
-
-const testData2a = { userType: 'admin', email: 'admin@example.com' };
-const result2a = validate(schema2, testData2a);
-console.log('✅ 管理员有邮箱:', result2a.valid ? '验证通过' : '验证失败');
-
-const testData2b = { userType: 'admin', email: '' };
-const result2b = validate(schema2, testData2b);
-console.log('❌ 管理员无邮箱:', result2b.valid ? '验证通过' : '验证失败');
-
-const testData2c = { userType: 'user', email: '' };
-const result2c = validate(schema2, testData2c);
-console.log('✅ 普通用户无邮箱:', result2c.valid ? '验证通过' : '验证失败');
-
-// ============================================
-// 示例3：else 可选（不写 else 就不验证）
-// ============================================
-console.log('\n【示例3】else 可选');
-console.log('----------------------------');
-
-const schema3 = dsl({
-  userType: 'string!',
-  vipLevel: dsl.if((data) => data.userType === 'vip')
-    .then('enum:gold|silver|bronze!')
-    // 不写 else，非 vip 用户不验证 vipLevel
-});
-
-const testData3a = { userType: 'vip', vipLevel: 'gold' };
-const result3a = validate(schema3, testData3a);
-console.log('✅ VIP用户有等级:', result3a.valid ? '验证通过' : '验证失败');
-
-const testData3b = { userType: 'user' };
-const result3b = validate(schema3, testData3b);
-console.log('✅ 普通用户无等级:', result3b.valid ? '验证通过' : '验证失败');
-
-const testData3c = { userType: 'user', vipLevel: 'invalid_level' };
-const result3c = validate(schema3, testData3c);
-console.log('✅ 普通用户有无效等级:', result3c.valid ? '验证通过（不验证）' : '验证失败');
-
-// ============================================
-// 示例4：多条件 AND
-// ============================================
-console.log('\n【示例4】多条件 AND');
-console.log('----------------------------');
-
-const schema4 = dsl({
-  age: 'number!',
-  userType: 'string!',
-  email: dsl.if((data) => data.age >= 18)
-    .and((data) => data.userType === 'admin')
-    .then('email!')
-    .else('email')
-});
-
-const testData4a = { age: 20, userType: 'admin', email: 'admin@example.com' };
-const result4a = validate(schema4, testData4a);
-console.log('✅ 成年管理员有邮箱:', result4a.valid ? '验证通过' : '验证失败');
-
-const testData4b = { age: 20, userType: 'user', email: '' };
-const result4b = validate(schema4, testData4b);
-console.log('✅ 成年普通用户无邮箱:', result4b.valid ? '验证通过' : '验证失败');
-
-const testData4c = { age: 16, userType: 'admin', email: '' };
-const result4c = validate(schema4, testData4c);
-console.log('✅ 未成年管理员无邮箱:', result4c.valid ? '验证通过' : '验证失败');
-
-// ============================================
-// 示例5：多条件 OR
-// ============================================
-console.log('\n【示例5】多条件 OR');
-console.log('----------------------------');
-
-const schema5 = dsl({
-  age: 'number!',
-  status: 'string!',
-  reason: dsl.if((data) => data.age < 18)
-    .or((data) => data.status === 'blocked')
-    .message('不允许注册')
-});
-
-const testData5a = { age: 16, status: 'active', reason: 'test' };
-const result5a = validate(schema5, testData5a);
-console.log('❌ 未成年用户:', result5a.valid ? '验证通过' : `验证失败（${result5a.errors[0].message}）`);
-
-const testData5b = { age: 20, status: 'blocked', reason: 'test' };
-const result5b = validate(schema5, testData5b);
-console.log('❌ 被封禁用户:', result5b.valid ? '验证通过' : `验证失败（${result5b.errors[0].message}）`);
-
-const testData5c = { age: 20, status: 'active', reason: 'test' };
-const result5c = validate(schema5, testData5c);
-console.log('✅ 正常用户:', result5c.valid ? '验证通过' : '验证失败');
-
-// ============================================
-// 示例6：elseIf 多分支
-// ============================================
-console.log('\n【示例6】elseIf 多分支');
-console.log('----------------------------');
-
-const schema6 = dsl({
-  userType: 'string!',
-  permissions: dsl.if((data) => data.userType === 'admin')
-    .then('array<string>!')
-    .elseIf((data) => data.userType === 'vip')
-    .then('array<string>')
-    .else(null)
-});
-
-const testData6a = { userType: 'admin', permissions: ['read', 'write'] };
-const result6a = validate(schema6, testData6a);
-console.log('✅ 管理员有权限:', result6a.valid ? '验证通过' : '验证失败');
-
-const testData6b = { userType: 'vip' };
-const result6b = validate(schema6, testData6b);
-console.log('✅ VIP无权限:', result6b.valid ? '验证通过' : '验证失败');
-
-const testData6c = { userType: 'guest' };
-const result6c = validate(schema6, testData6c);
-console.log('✅ 游客无权限:', result6c.valid ? '验证通过' : '验证失败');
-
-// ============================================
-// 示例7：复杂场景 - 用户注册
-// ============================================
-console.log('\n【示例7】复杂场景 - 用户注册');
-console.log('----------------------------');
-
-const userRegistrationSchema = dsl({
-  username: 'string:3-32!',
-  age: 'number:1-120!',
-  userType: 'enum:admin|vip|user!',
-
-  // 未成年禁止注册
-  ageCheck: dsl.if((data) => data.age < 18)
-    .message('未成年用户不能注册'),
-
-  // 管理员必须有邮箱
-  email: dsl.if((data) => data.userType === 'admin')
-    .then('email!')
-    .else('email'),
-
-  // VIP用户必须有手机号
-  phone: dsl.if((data) => data.userType === 'vip')
-    .then('string:11!')
-    .else(null),
-
-  // 管理员和VIP可以设置昵称
-  nickname: dsl.if((data) => data.userType === 'admin')
-    .or((data) => data.userType === 'vip')
-    .then('string:2-20')
-    .else(null)
-});
-
-const testData7a = {
-  username: 'admin1',
-  age: 25,
-  userType: 'admin',
-  email: 'admin@example.com',
-  nickname: 'Super Admin'
-};
-const result7a = validate(userRegistrationSchema, testData7a);
-console.log('✅ 成年管理员:', result7a.valid ? '注册成功' : '注册失败');
-
-const testData7b = {
-  username: 'vip1',
-  age: 30,
-  userType: 'vip',
-  phone: '13800138000',
-  nickname: 'VIP User'
-};
-const result7b = validate(userRegistrationSchema, testData7b);
-console.log('✅ VIP用户:', result7b.valid ? '注册成功' : '注册失败');
-
-const testData7c = {
-  username: 'kid',
-  age: 15,
-  userType: 'user'
-};
-const result7c = validate(userRegistrationSchema, testData7c);
-console.log('❌ 未成年用户:', result7c.valid ? '注册成功' : `注册失败（${result7c.errors[0].message}）`);
-
-// ============================================
-// 示例8：复杂场景 - 商品发布
-// ============================================
-console.log('\n【示例8】复杂场景 - 商品发布');
-console.log('----------------------------');
-
-const productSchema = dsl({
-  title: 'string:1-100!',
-  price: 'number:0-!',
-  type: 'enum:physical|digital|service!',
-
-  // 实体商品需要重量和尺寸
-  weight: dsl.if((data) => data.type === 'physical')
-    .then('number:0-!')
-    .else(null),
-
-  dimensions: dsl.if((data) => data.type === 'physical')
-    .then('string!')
-    .else(null),
-
-  // 数字商品需要下载链接
-  downloadUrl: dsl.if((data) => data.type === 'digital')
-    .then('url!')
-    .else(null),
-
-  // 服务类需要服务时长
-  duration: dsl.if((data) => data.type === 'service')
-    .then('number:1-!')
-    .else(null)
-});
-
-const testData8a = {
-  title: '笔记本电脑',
-  price: 5999,
-  type: 'physical',
-  weight: 1.5,
-  dimensions: '30x20x2cm'
-};
-const result8a = validate(productSchema, testData8a);
-console.log('✅ 实体商品:', result8a.valid ? '发布成功' : '发布失败');
-
-const testData8b = {
-  title: '电子书',
-  price: 29.9,
-  type: 'digital',
-  downloadUrl: 'https://example.com/download'
-};
-const result8b = validate(productSchema, testData8b);
-console.log('✅ 数字商品:', result8b.valid ? '发布成功' : '发布失败');
-
-const testData8c = {
-  title: '咨询服务',
-  price: 200,
-  type: 'service',
-  duration: 60
-};
-const result8c = validate(productSchema, testData8c);
-console.log('✅ 服务类:', result8c.valid ? '发布成功' : '发布失败');
-
-console.log('\n========================================');
-console.log('示例运行完成！');
-console.log('========================================');
-