schema-dsl 1.2.5 → 2.0.1

package/examples/dynamic-locale-example.js

@@ -1,287 +0,0 @@
-/**
- * 动态多语言配置示例
- *
- * 演示如何从请求头动态获取语言并进行验证
- */
-
-const { dsl, Validator, Locale } = require('../index');
-
-// ========== 1. 初始化语言包 ==========
-
-console.log('📦 初始化语言包...\n');
-
-// 中文语言包
-Locale.addLocale('zh-CN', {
-  'required': '{{#label}}不能为空',
-  'min': '{{#label}}至少{{#limit}}个字符',
-  'max': '{{#label}}最多{{#limit}}个字符',
-  'pattern': '{{#label}}格式不正确',
-  'format': '请输入有效的{{#label}}',
-
-  // Labels
-  'label.username': '用户名',
-  'label.email': '邮箱地址',
-  'label.password': '密码',
-  'label.age': '年龄'
-});
-
-// 英文语言包
-Locale.addLocale('en-US', {
-  'required': '{{#label}} is required',
-  'min': '{{#label}} must be at least {{#limit}} characters',
-  'max': '{{#label}} must be at most {{#limit}} characters',
-  'pattern': '{{#label}} format is invalid',
-  'format': 'Please enter a valid {{#label}}',
-
-  // Labels
-  'label.username': 'Username',
-  'label.email': 'Email',
-  'label.password': 'Password',
-  'label.age': 'Age'
-});
-
-console.log('✅ 语言包已加载: zh-CN, en-US\n');
-
-// ========== 2. 定义Schema ==========
-
-console.log('📋 定义Schema...\n');
-
-const userSchema = dsl({
-  username: 'string:3-32!'.label('label.username'),
-  email: 'email!'.label('label.email'),
-  password: 'string:8-64!'
-    .pattern(/^(?=.*[a-z])(?=.*[A-Z])(?=.*\d).+$/)
-    .label('label.password'),
-  age: 'number:18-120'.label('label.age')
-});
-
-console.log('✅ Schema定义完成\n');
-
-// ========== 3. 测试数据 ==========
-
-const testData = {
-  username: 'ab',  // 太短
-  email: 'invalid-email',  // 格式错误
-  password: 'weak',  // 不符合强度要求
-  age: 15  // 年龄不够
-};
-
-// ========== 4. 创建验证器 ==========
-
-const validator = new Validator();
-
-// ========== 5. 测试不同语言 ==========
-
-console.log('🧪 测试验证 - 不同语言\n');
-console.log('=' .repeat(60));
-
-// 中文验证
-console.log('\n📍 测试1: 中文错误消息 (locale: zh-CN)');
-console.log('-'.repeat(60));
-
-const result1 = validator.validate(userSchema, testData, {
-  locale: 'zh-CN'
-});
-
-console.log('验证结果:', result1.valid ? '✅ 通过' : '❌ 失败');
-if (!result1.valid) {
-  console.log('\n错误列表:');
-  result1.errors.forEach((error, index) => {
-    console.log(`  ${index + 1}. ${error.path}: ${error.message}`);
-  });
-}
-
-// 英文验证
-console.log('\n📍 测试2: 英文错误消息 (locale: en-US)');
-console.log('-'.repeat(60));
-
-const result2 = validator.validate(userSchema, testData, {
-  locale: 'en-US'
-});
-
-console.log('验证结果:', result2.valid ? '✅ 通过' : '❌ 失败');
-if (!result2.valid) {
-  console.log('\n错误列表:');
-  result2.errors.forEach((error, index) => {
-    console.log(`  ${index + 1}. ${error.path}: ${error.message}`);
-  });
-}
-
-// ========== 6. 模拟HTTP请求场景 ==========
-
-console.log('\n\n🌐 模拟HTTP请求场景');
-console.log('=' .repeat(60));
-
-/**
- * 解析 Accept-Language 头
- */
-function parseAcceptLanguage(acceptLanguage) {
-  if (!acceptLanguage) return 'en-US';
-
-  const languages = acceptLanguage.split(',').map(lang => {
-    const [code, qValue] = lang.trim().split(';');
-    const q = qValue ? parseFloat(qValue.split('=')[1]) : 1.0;
-    return { code: code.trim(), q };
-  });
-
-  languages.sort((a, b) => b.q - a.q);
-
-  const supportedLocales = ['zh-CN', 'en-US'];
-  for (const lang of languages) {
-    const matched = supportedLocales.find(locale =>
-      locale.toLowerCase() === lang.code.toLowerCase()
-    );
-    if (matched) return matched;
-  }
-
-  return 'en-US';
-}
-
-/**
- * 模拟验证请求
- */
-function handleRequest(acceptLanguage, data) {
-  const locale = parseAcceptLanguage(acceptLanguage);
-
-  console.log(`\n📍 请求头: Accept-Language: ${acceptLanguage}`);
-  console.log(`   解析语言: ${locale}`);
-  console.log('-'.repeat(60));
-
-  const result = validator.validate(userSchema, data, { locale });
-
-  if (!result.valid) {
-    console.log('❌ 验证失败:');
-    result.errors.forEach((error, index) => {
-      console.log(`   ${index + 1}. ${error.path}: ${error.message}`);
-    });
-  } else {
-    console.log('✅ 验证通过');
-  }
-
-  return result;
-}
-
-// 测试不同的 Accept-Language 头
-handleRequest('zh-CN,zh;q=0.9,en;q=0.8', testData);
-handleRequest('en-US,en;q=0.9', testData);
-handleRequest('zh-CN', testData);
-handleRequest('en-US', testData);
-handleRequest('ja-JP,en-US;q=0.8', testData);  // 不支持的语言，回退到英文
-
-// ========== 6.1 格式化类型测试 (v2.1.0 新增) ==========
-
-console.log('\n\n🌐 格式化类型测试 (v2.1.0)');
-console.log('=' .repeat(60));
-
-const formatSchema = dsl({
-  email: 'email!',
-  url: 'url!',
-  ipv4: 'ipv4!'
-});
-
-const formatData = {
-  email: 'invalid-email',
-  url: 'invalid-url',
-  ipv4: '999.999.999.999'
-};
-
-function testFormat(locale) {
-  console.log(`\nTesting format with locale: ${locale}`);
-  const result = validator.validate(formatSchema, formatData, { locale });
-  result.errors.forEach(e => console.log(`   ${e.path}: ${e.message}`));
-}
-
-testFormat('zh-CN');
-testFormat('en-US');
-testFormat('ja-JP'); // 如果已加载 ja-JP
-
-// ========== 7. 并发测试 ==========
-
-console.log('\n\n⚡ 并发测试 - 验证无竞态问题');
-console.log('=' .repeat(60));
-
-async function concurrentTest() {
-  const promises = [
-    // 5个中文请求
-    ...Array(5).fill().map(() =>
-      Promise.resolve(validator.validate(userSchema, testData, { locale: 'zh-CN' }))
-    ),
-    // 5个英文请求
-    ...Array(5).fill().map(() =>
-      Promise.resolve(validator.validate(userSchema, testData, { locale: 'en-US' }))
-    )
-  ];
-
-  const results = await Promise.all(promises);
-
-  // 检查结果
-  const zhResults = results.slice(0, 5);
-  const enResults = results.slice(5);
-
-  const allZhCorrect = zhResults.every(r =>
-    r.errors[0].message.includes('用户名')
-  );
-
-  const allEnCorrect = enResults.every(r =>
-    r.errors[0].message.includes('username')
-  );
-
-  console.log('\n并发测试结果:');
-  console.log(`  中文请求 (5个): ${allZhCorrect ? '✅ 全部正确' : '❌ 有错误'}`);
-  console.log(`  英文请求 (5个): ${allEnCorrect ? '✅ 全部正确' : '❌ 有错误'}`);
-
-  if (allZhCorrect && allEnCorrect) {
-    console.log('\n🎉 并发测试通过！无竞态问题！');
-  }
-}
-
-concurrentTest();
-
-// ========== 8. 正确数据测试 ==========
-
-console.log('\n\n✅ 测试正确数据');
-console.log('=' .repeat(60));
-
-const validData = {
-  username: 'john_doe',
-  email: 'john@example.com',
-  password: 'Password123',
-  age: 25
-};
-
-console.log('\n📍 中文验证');
-const validResult1 = validator.validate(userSchema, validData, {
-  locale: 'zh-CN'
-});
-console.log('结果:', validResult1.valid ? '✅ 验证通过' : '❌ 验证失败');
-
-console.log('\n📍 英文验证');
-const validResult2 = validator.validate(userSchema, validData, {
-  locale: 'en-US'
-});
-console.log('结果:', validResult2.valid ? '✅ 验证通过' : '❌ 验证失败');
-
-// ========== 总结 ==========
-
-console.log('\n\n' + '='.repeat(60));
-console.log('📊 总结');
-console.log('='.repeat(60));
-console.log(`
-✅ 核心功能:
-  1. 支持动态语言切换 (locale参数)
-  2. 支持并发请求，无竞态问题
-  3. 自动解析 Accept-Language 头
-  4. 支持多语言错误消息
-
-✅ 使用方式:
-  validator.validate(schema, data, { locale: 'zh-CN' })
-
-✅ 推荐场景:
-  - Express/Koa API 服务
-  - 多语言Web应用
-  - 国际化移动应用后端
-
-📖 详细文档: docs/dynamic-locale.md
-`);
-
-

package/examples/enum.examples.js

@@ -1,324 +0,0 @@
-/**
- * 枚举功能完整示例
- *
- * 演示 schema-dsl 中枚举的各种用法
- *
- * @since v1.1.0
- */
-
-const { dsl, validate } = require('../index');
-
-console.log('========== 枚举功能示例 ==========\n');
-
-// ========================================
-// 1. 基础字符串枚举
-// ========================================
-console.log('【示例 1】基础字符串枚举\n');
-
-const userSchema = dsl({
-  username: 'string:3-32!',
-  role: 'admin|user|guest!',           // 简写形式
-  status: 'enum:active|inactive|pending'  // 完整形式
-});
-
-let result = validate(userSchema, {
-  username: 'john_doe',
-  role: 'admin',
-  status: 'active'
-});
-
-console.log('✅ 验证通过:', result.valid);
-console.log('数据:', result.data);
-console.log('');
-
-// 测试无效值
-result = validate(userSchema, {
-  username: 'jane',
-  role: 'superadmin',  // 无效值
-  status: 'active'
-});
-
-console.log('❌ 验证失败:', !result.valid);
-console.log('错误:', result.errors[0].message);
-console.log('');
-
-// ========================================
-// 2. 布尔值枚举
-// ========================================
-console.log('【示例 2】布尔值枚举\n');
-
-const featureSchema = dsl({
-  name: 'string!',
-  isEnabled: 'true|false!',              // 自动识别为布尔值
-  isPublic: 'enum:boolean:true|false',   // 显式指定布尔值
-  verified: 'true|false'                 // 可选的布尔值
-});
-
-result = validate(featureSchema, {
-  name: 'dark-mode',
-  isEnabled: true,
-  isPublic: false
-});
-
-console.log('✅ 验证通过:', result.valid);
-console.log('数据:', result.data);
-console.log('');
-
-// 测试类型错误
-result = validate(featureSchema, {
-  name: 'feature-x',
-  isEnabled: 'true',  // 字符串 'true' 不是布尔值
-  isPublic: false
-});
-
-console.log('❌ 类型错误（字符串 vs 布尔值）:', !result.valid);
-console.log('');
-
-// ========================================
-// 3. 数字枚举
-// ========================================
-console.log('【示例 3】数字枚举\n');
-
-const taskSchema = dsl({
-  title: 'string!',
-  priority: '1|2|3!',                    // 自动识别为数字
-  level: 'enum:number:1|2|3|4|5',       // 显式指定数字
-  rating: '1.0|1.5|2.0|2.5|3.0'         // 小数枚举
-});
-
-result = validate(taskSchema, {
-  title: 'Fix bug',
-  priority: 1,
-  level: 3,
-  rating: 2.5
-});
-
-console.log('✅ 验证通过:', result.valid);
-console.log('数据:', result.data);
-console.log('');
-
-// 测试超出范围
-result = validate(taskSchema, {
-  title: 'New task',
-  priority: 4,  // 超出 1|2|3
-  level: 2
-});
-
-console.log('❌ 超出范围:', !result.valid);
-console.log('');
-
-// ========================================
-// 4. 整数枚举
-// ========================================
-console.log('【示例 4】整数枚举（禁止小数）\n');
-
-const gameSchema = dsl({
-  playerName: 'string!',
-  difficulty: 'enum:integer:1|2|3'  // 必须是整数
-});
-
-result = validate(gameSchema, {
-  playerName: 'Alice',
-  difficulty: 2
-});
-
-console.log('✅ 整数验证通过:', result.valid);
-console.log('');
-
-// 小数应该失败
-result = validate(gameSchema, {
-  playerName: 'Bob',
-  difficulty: 1.5  // 小数不符合 integer 类型
-});
-
-console.log('❌ 小数验证失败:', !result.valid);
-console.log('');
-
-// ========================================
-// 5. 枚举与链式 API
-// ========================================
-console.log('【示例 5】枚举与链式 API\n');
-
-const postSchema = dsl({
-  title: 'string:5-100!',
-  status: dsl('draft|published|archived')
-    .label('文章状态')
-    .messages({
-      'enum': '状态必须是: 草稿、已发布或已归档'
-    }),
-  visibility: dsl('public|private|unlisted!')
-    .label('可见性')
-    .default('public')
-});
-
-result = validate(postSchema, {
-  title: 'My First Post',
-  status: 'invalid_status',
-  visibility: 'public'
-});
-
-console.log('❌ 自定义错误消息:', !result.valid);
-console.log('错误:', result.errors[0].message);
-console.log('');
-
-// ========================================
-// 6. 数组中的枚举
-// ========================================
-console.log('【示例 6】数组中的枚举\n');
-
-const articleSchema = dsl({
-  title: 'string!',
-  tags: 'array<enum:tech|business|lifestyle>',
-  permissions: 'array<enum:read|write|delete>'
-});
-
-result = validate(articleSchema, {
-  title: 'Tech Article',
-  tags: ['tech', 'business'],
-  permissions: ['read', 'write']
-});
-
-console.log('✅ 数组枚举验证通过:', result.valid);
-console.log('数据:', result.data);
-console.log('');
-
-// ========================================
-// 7. 复杂对象中的枚举
-// ========================================
-console.log('【示例 7】复杂对象中的枚举\n');
-
-const orderSchema = dsl({
-  orderId: 'string!',
-  status: 'pending|processing|completed|cancelled!',
-  priority: '1|2|3'.default(2),
-  payment: {
-    method: 'card|paypal|crypto!',
-    status: 'pending|success|failed!'
-  },
-  items: 'array',
-  metadata: {
-    isUrgent: 'true|false',
-    category: 'electronics|clothing|food'
-  }
-});
-
-result = validate(orderSchema, {
-  orderId: 'ORD-12345',
-  status: 'processing',
-  priority: 1,
-  payment: {
-    method: 'card',
-    status: 'success'
-  },
-  items: [],
-  metadata: {
-    isUrgent: true,
-    category: 'electronics'
-  }
-});
-
-console.log('✅ 复杂对象验证通过:', result.valid);
-console.log('数据:', JSON.stringify(result.data, null, 2));
-console.log('');
-
-// ========================================
-// 8. 错误处理
-// ========================================
-console.log('【示例 8】错误处理\n');
-
-try {
-  // 无效的布尔值枚举
-  dsl({ flag: 'enum:boolean:true|false|maybe' });
-} catch (error) {
-  console.log('❌ 捕获错误:', error.message);
-}
-
-try {
-  // 无效的数字枚举
-  dsl({ value: 'enum:number:1|2|abc' });
-} catch (error) {
-  console.log('❌ 捕获错误:', error.message);
-}
-
-console.log('');
-
-// ========================================
-// 9. 实际应用场景
-// ========================================
-console.log('【示例 9】实际应用 - 用户管理系统\n');
-
-const userManagementSchema = dsl({
-  // 基本信息
-  userId: 'string!',
-  username: 'string:3-32!',
-  email: 'email!',
-
-  // 枚举字段
-  role: 'admin|moderator|user|guest!',
-  status: 'active|inactive|suspended|banned',
-  emailVerified: 'true|false',
-
-  // 权限等级（数字枚举）
-  permissionLevel: '0|1|2|3|4|5'.default(0),
-
-  // 偏好设置
-  preferences: {
-    theme: 'light|dark|auto',
-    language: 'en|zh-CN|zh-TW|ja|ko',
-    notifications: 'all|mentions|none'
-  }
-});
-
-const newUser = {
-  userId: 'u_12345',
-  username: 'alice',
-  email: 'alice@example.com',
-  role: 'user',
-  status: 'active',
-  emailVerified: true,
-  permissionLevel: 1,
-  preferences: {
-    theme: 'dark',
-    language: 'zh-CN',
-    notifications: 'mentions'
-  }
-};
-
-result = validate(userManagementSchema, newUser);
-
-console.log('✅ 用户数据验证通过:', result.valid);
-console.log('用户数据:', JSON.stringify(result.data, null, 2));
-console.log('');
-
-// ========================================
-// 10. 性能测试
-// ========================================
-console.log('【示例 10】性能测试\n');
-
-const perfSchema = dsl({
-  status: 'active|inactive|pending',
-  priority: '1|2|3',
-  flag: 'true|false'
-});
-
-const iterations = 10000;
-const startTime = Date.now();
-
-for (let i = 0; i < iterations; i++) {
-  validate(perfSchema, {
-    status: 'active',
-    priority: 2,
-    flag: true
-  });
-}
-
-const endTime = Date.now();
-const duration = endTime - startTime;
-const perSecond = Math.round((iterations / duration) * 1000);
-
-console.log(`验证 ${iterations} 次耗时: ${duration}ms`);
-console.log(`平均每秒验证: ${perSecond.toLocaleString()} 次`);
-console.log('');
-
-console.log('========== 示例结束 ==========');
-