schema-dsl 1.2.4 → 2.0.0

package/examples/slug.examples.js

@@ -1,179 +0,0 @@
-/**
- * slug 类型验证示例
- *
- * slug 用于 URL 友好的字符串，只能包含：
- * - 小写字母 (a-z)
- * - 数字 (0-9)
- * - 连字符 (-)
- *
- * 格式规则：
- * - 必须以字母或数字开头
- * - 必须以字母或数字结尾
- * - 中间可以有连字符，但不能连续
- */
-
-const { dsl, validate } = require('../index');
-
-// ========== 示例 1: 基础用法 ==========
-console.log('\n========== 示例 1: 基础 slug 验证 ==========');
-
-const schema1 = dsl({
-  slug: 'slug!'
-});
-
-console.log('✅ 有效的 slug:');
-console.log('  my-blog-post:', validate(schema1, { slug: 'my-blog-post' }).valid);
-console.log('  hello-world:', validate(schema1, { slug: 'hello-world' }).valid);
-console.log('  post-123:', validate(schema1, { slug: 'post-123' }).valid);
-console.log('  article:', validate(schema1, { slug: 'article' }).valid);
-
-console.log('\n❌ 无效的 slug:');
-console.log('  My-Blog-Post:', validate(schema1, { slug: 'My-Blog-Post' }).valid); // 大写
-console.log('  hello_world:', validate(schema1, { slug: 'hello_world' }).valid);   // 下划线
-console.log('  -hello:', validate(schema1, { slug: '-hello' }).valid);             // 开头连字符
-console.log('  hello-:', validate(schema1, { slug: 'hello-' }).valid);             // 结尾连字符
-console.log('  hello--world:', validate(schema1, { slug: 'hello--world' }).valid); // 连续连字符
-console.log('  hello world:', validate(schema1, { slug: 'hello world' }).valid);   // 空格
-
-// ========== 示例 2: DSL 字符串语法 ==========
-console.log('\n========== 示例 2: DSL 字符串语法 ==========');
-
-const schema2 = dsl({
-  articleSlug: 'slug:3-100!'  // slug + 长度限制
-});
-
-console.log('✅ 3-100字符的 slug:');
-console.log('  abc:', validate(schema2, { articleSlug: 'abc' }).valid);
-console.log('  my-long-article-title-with-many-words:',
-  validate(schema2, { articleSlug: 'my-long-article-title-with-many-words' }).valid);
-
-console.log('\n❌ 长度不符:');
-console.log('  ab:', validate(schema2, { articleSlug: 'ab' }).valid);  // 太短
-
-// ========== 示例 3: 链式调用 ==========
-console.log('\n========== 示例 3: 链式调用 ==========');
-
-const schema3 = dsl({
-  pageSlug: 'string!'.slug().label('页面别名')
-});
-
-console.log('✅ 链式调用验证:');
-console.log('  about-us:', validate(schema3, { pageSlug: 'about-us' }).valid);
-console.log('  contact:', validate(schema3, { pageSlug: 'contact' }).valid);
-
-// ========== 示例 4: 实际应用场景 ==========
-console.log('\n========== 示例 4: 博客文章Schema ==========');
-
-const blogPostSchema = dsl({
-  title: 'string:1-200!',
-  slug: 'slug:3-100!',
-  author: 'string!',
-  content: 'string:10-!',
-  tags: 'array<slug>',  // slug 数组
-  publishedAt: 'datetime'
-});
-
-const validPost = {
-  title: 'Getting Started with Node.js',
-  slug: 'getting-started-with-nodejs',
-  author: 'John Doe',
-  content: 'This is a comprehensive guide to Node.js...',
-  tags: ['nodejs', 'javascript', 'backend'],
-  publishedAt: '2025-12-31T10:00:00Z'
-};
-
-console.log('✅ 有效的博客文章:', validate(blogPostSchema, validPost).valid);
-
-const invalidPost = {
-  title: 'Invalid Post',
-  slug: 'Invalid Slug!',  // ❌ 包含大写和特殊字符
-  author: 'Jane',
-  content: 'Short content',
-  tags: ['Node.js', 'JavaScript'],  // ❌ 标签包含大写
-  publishedAt: '2025-12-31T10:00:00Z'
-};
-
-const result = validate(blogPostSchema, invalidPost);
-console.log('\n❌ 无效的博客文章:', result.valid);
-if (!result.valid) {
-  console.log('错误信息:');
-  result.errors.forEach(err => {
-    console.log(`  - ${err.path}: ${err.message}`);
-  });
-}
-
-// ========== 示例 5: URL 生成应用 ==========
-console.log('\n========== 示例 5: 自动生成 slug ==========');
-
-function generateSlug(title) {
-  return title
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, '-')  // 替换非字母数字为连字符
-    .replace(/^-+|-+$/g, '');      // 移除首尾连字符
-}
-
-const titles = [
-  'Hello World!',
-  'Getting Started with Node.js',
-  'Top 10 JavaScript Tips & Tricks',
-  '2025年的技术趋势'
-];
-
-const urlSchema = dsl({ slug: 'slug!' });
-
-console.log('标题 → slug 转换:');
-titles.forEach(title => {
-  const slug = generateSlug(title);
-  const isValid = validate(urlSchema, { slug }).valid;
-  console.log(`  "${title}"`);
-  console.log(`    → "${slug}" ${isValid ? '✅' : '❌'}`);
-});
-
-// ========== 示例 6: 多语言支持 ==========
-console.log('\n========== 示例 6: 多语言错误消息 ==========');
-
-const { Validator } = require('../index');
-const validator = new Validator();
-
-const schema6 = dsl({ slug: 'slug!' });
-
-// 中文
-const resultCN = validator.validate(schema6, { slug: 'Invalid Slug!' }, { locale: 'zh-CN' });
-console.log('中文错误:', resultCN.errors[0]?.message);
-
-// 英文
-const resultEN = validator.validate(schema6, { slug: 'Invalid Slug!' }, { locale: 'en-US' });
-console.log('英文错误:', resultEN.errors[0]?.message);
-
-// 西班牙语
-const resultES = validator.validate(schema6, { slug: 'Invalid Slug!' }, { locale: 'es-ES' });
-console.log('西班牙语错误:', resultES.errors[0]?.message);
-
-// ========== 示例 7: 常见错误 ==========
-console.log('\n========== 示例 7: 常见 slug 错误 ==========');
-
-const testCases = [
-  { slug: 'valid-slug-123', expected: true, reason: '✅ 正确格式' },
-  { slug: 'Valid-Slug', expected: false, reason: '❌ 包含大写字母' },
-  { slug: 'hello_world', expected: false, reason: '❌ 包含下划线' },
-  { slug: 'hello world', expected: false, reason: '❌ 包含空格' },
-  { slug: '-hello', expected: false, reason: '❌ 以连字符开头' },
-  { slug: 'hello-', expected: false, reason: '❌ 以连字符结尾' },
-  { slug: 'hello--world', expected: false, reason: '❌ 连续连字符' },
-  { slug: 'hello.world', expected: false, reason: '❌ 包含点号' },
-  { slug: '123-456', expected: true, reason: '✅ 纯数字+连字符' },
-  { slug: 'a', expected: true, reason: '✅ 单个字母' },
-  { slug: '1', expected: true, reason: '✅ 单个数字' }
-];
-
-const testSchema = dsl({ slug: 'slug!' });
-
-console.log('测试用例:');
-testCases.forEach(({ slug, expected, reason }) => {
-  const result = validate(testSchema, { slug });
-  const passed = result.valid === expected;
-  console.log(`  ${passed ? '✅' : '❌'} "${slug}" - ${reason}`);
-});
-
-console.log('\n========== 所有示例完成 ==========');
-

package/examples/string-extensions.js

@@ -1,297 +0,0 @@
-/**
- * String 扩展完整示例 v2.0.1
- *
- * 展示字符串直接链式调用所有方法
- * 无需 dsl() 包裹，语法更简洁
- */
-
-const { dsl, Validator } = require('../index');
-
-console.log('========== String 扩展特性展示 ==========\n');
-
-// ========== 1. 基础链式调用 ==========
-
-console.log('1️⃣  基础链式调用');
-
-const basicSchema = dsl({
-  // 最简单：纯DSL字符串
-  name: 'string:1-50!',
-
-  // ✨ String扩展：添加标签
-  email: 'email!'.label('邮箱地址'),
-
-  // ✨ String扩展：添加描述
-  website: 'url'.description('个人主页'),
-
-  // ✨ String扩展：设置默认值
-  language: 'en|zh|ja'.default('zh')
-});
-
-console.log('基础Schema:', JSON.stringify(basicSchema, null, 2));
-
-// ========== 2. 正则验证 + 自定义消息 ==========
-
-console.log('\n2️⃣  正则验证 + 自定义消息');
-
-const regexSchema = dsl({
-  // ✨ 用户名：正则 + 消息
-  username: 'string:3-32!'
-    .pattern(/^[a-zA-Z0-9_]+$/)
-    .messages({
-      'pattern': '只能包含字母、数字和下划线',
-      'min': '用户名至少3个字符',
-      'max': '用户名最多32个字符'
-    })
-    .label('用户名'),
-
-  // ✨ 密码：复杂正则
-  password: 'string:8-64!'
-    .pattern(/^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[@$!%*?&]).+$/)
-    .messages({
-      'pattern': '密码必须包含大小写字母、数字和特殊字符'
-    })
-    .label('密码'),
-
-  // ✨ 手机号：中国手机号格式
-  phone: 'string:11!'
-    .pattern(/^1[3-9]\d{9}$/)
-    .messages({
-      'pattern': '请输入有效的中国手机号'
-    })
-    .label('手机号')
-});
-
-console.log('正则验证Schema:', JSON.stringify(regexSchema.properties.username, null, 2));
-
-// ========== 3. 完整的表单验证 ==========
-
-console.log('\n3️⃣  完整的表单验证示例');
-
-const formSchema = dsl({
-  // ✨ 邮箱
-  email: 'email!'
-    .label('邮箱地址')
-    .description('用于登录和接收通知')
-    .messages({
-      'format': '请输入有效的邮箱地址'
-    }),
-
-  // ✨ 昵称
-  nickname: 'string:2-20!'
-    .label('昵称')
-    .description('显示在个人资料页面'),
-
-  // ✨ 个人简介
-  bio: 'string:500'
-    .label('个人简介')
-    .description('告诉大家你的故事'),
-
-  // ✨ 社交媒体链接
-  twitter: 'url'
-    .pattern(/^https?:\/\/(www\.)?twitter\.com\//)
-    .label('Twitter链接')
-    .messages({
-      'pattern': '请输入有效的Twitter链接'
-    }),
-
-  github: 'url'
-    .pattern(/^https?:\/\/(www\.)?github\.com\//)
-    .label('GitHub链接')
-    .messages({
-      'pattern': '请输入有效的GitHub链接'
-    }),
-
-  // 简单字段（无需链式）
-  age: 'number:18-120',
-  gender: 'male|female|other',
-  country: 'string:2-50'
-});
-
-console.log('表单Schema字段数:', Object.keys(formSchema.properties).length);
-
-// ========== 4. 验证数据 ==========
-
-console.log('\n4️⃣  数据验证');
-
-const { validate } = require('../index');
-
-const testData = {
-  email: 'user@example.com',
-  nickname: '张三',
-  bio: '全栈开发工程师，热爱开源',
-  twitter: 'https://twitter.com/username',
-  github: 'https://github.com/username',
-  age: 25,
-  gender: 'male',
-  country: '中国'
-};
-
-const result = validate(formSchema, testData);
-console.log('验证结果:', result.valid ? '✅ 通过' : '❌ 失败');
-if (!result.valid) {
-  console.log('错误:', result.errors);
-}
-
-// ========== 5. 对比语法 ==========
-
-console.log('\n5️⃣  语法对比');
-
-console.log('\n❌ v1.0（需要 dsl() 包裹）:');
-console.log(`
-const schema = {
-  email: dsl('email!')
-    .pattern(/custom/)
-    .messages({ ... })
-    .label('邮箱地址')
-};
-`);
-
-console.log('✅ v2.0.1（字符串直接链式）:');
-console.log(`
-const schema = {
-  email: 'email!'
-    .pattern(/custom/)
-    .messages({ ... })
-    .label('邮箱地址')
-};
-`);
-
-console.log('💡 减少字符数: 5个字符 (dsl())');
-console.log('💡 更直观: 字符串直接调用方法');
-console.log('💡 更简洁: 符合自然语言习惯');
-
-// ========== 6. 所有可用方法 ==========
-
-console.log('\n6️⃣  String扩展所有可用方法');
-
-const allMethods = `
-String.prototype 扩展方法：
-
-1. .pattern(regex, message?)     - 添加正则验证
-2. .label(text)                   - 设置字段标签
-3. .messages(obj)                 - 自定义错误消息
-4. .description(text)             - 设置描述
-5. .custom(validator)             - 自定义验证器
-6. .when(field, options)          - 条件验证
-7. .default(value)                - 设置默认值
-8. .toSchema()                    - 转为JSON Schema
-
-使用示例：
-  'string:3-32!'
-    .pattern(/^\\w+$/)           // 正则
-    .label('用户名')             // 标签
-    .messages({...})            // 消息
-    .description('登录名')      // 描述
-    .default('guest')           // 默认值
-`;
-
-console.log(allMethods);
-
-// ========== 7. 高级用法：自定义验证器 ==========
-
-console.log('7️⃣  高级用法：自定义验证器');
-
-// 模拟异步用户名检查
-async function checkUsernameExists(username) {
-  // 模拟数据库查询
-  const existingUsers = ['admin', 'root', 'test'];
-  return existingUsers.includes(username);
-}
-
-const advancedSchema = dsl({
-  username: 'string:3-32!'
-    .pattern(/^[a-zA-Z0-9_]+$/)
-    .custom(async (value) => {
-      const exists = await checkUsernameExists(value);
-      if (exists) {
-        return {
-          error: 'username.exists',
-          message: '用户名已被占用'
-        };
-      }
-      return true;
-    })
-    .label('用户名')
-});
-
-console.log('✅ 自定义验证器已添加（异步检查用户名是否存在）');
-
-// ========== 8. 嵌套对象中使用 ==========
-
-console.log('\n8️⃣  嵌套对象中使用');
-
-const nestedSchema = dsl({
-  user: {
-    // ✨ 第一层嵌套
-    profile: {
-      name: 'string:1-50!'.label('姓名'),
-      avatar: 'url'.label('头像URL'),
-      // ✨ 第二层嵌套
-      social: {
-        twitter: 'url'
-          .pattern(/twitter\.com/)
-          .label('Twitter'),
-        github: 'url'
-          .pattern(/github\.com/)
-          .label('GitHub')
-      }
-    }
-  }
-});
-
-console.log('✅ 嵌套对象中String扩展完美支持');
-console.log('嵌套层级:', '3层（user → profile → social）');
-
-// ========== 9. 性能对比 ==========
-
-console.log('\n9️⃣  性能测试');
-
-const iterations = 10000;
-
-// 测试1: 纯DSL
-console.time('纯DSL');
-for (let i = 0; i < iterations; i++) {
-  dsl({
-    name: 'string:1-50!',
-    email: 'email!'
-  });
-}
-console.timeEnd('纯DSL');
-
-// 测试2: String扩展
-console.time('String扩展');
-for (let i = 0; i < iterations; i++) {
-  dsl({
-    name: 'string:1-50!'.label('姓名'),
-    email: 'email!'.label('邮箱')
-  });
-}
-console.timeEnd('String扩展');
-
-console.log('✅ String扩展性能开销极小（<5%）');
-
-// ========== 总结 ==========
-
-console.log('\n========== 总结 ==========');
-console.log(`
-✨ SchemaIO v2.0.1 String扩展特性：
-
-1. ✅ 字符串直接链式调用
-2. ✅ 无需 dsl() 包裹
-3. ✅ 支持所有DslBuilder方法
-4. ✅ 支持嵌套对象
-5. ✅ 支持自定义验证器
-6. ✅ 性能开销极小
-7. ✅ 100%向后兼容
-
-💡 推荐用法：
-   - 简单字段：纯DSL字符串
-   - 复杂字段：String扩展链式调用
-   - 80%用DSL，20%用扩展
-
-🎉 SchemaIO v2.0.1 - 最简洁的验证库！
-`);
-
-console.log('\n✅ String扩展示例运行完成！');
-
-

package/examples/union-type-example.js

@@ -1,127 +0,0 @@
-/**
- * 联合类型验证示例
- *
- * 使用 .pattern() + .messages() 实现一个字段支持多种格式
- */
-
-const { dsl, validate } = require('../index');
-
-console.log('========================================');
-console.log('联合类型验证示例 - 使用 .pattern()');
-console.log('========================================\n');
-
-// ========================================
-// 示例1：邮箱或手机号（使用多语言 key）
-// ========================================
-console.log('【示例1】邮箱或手机号 - 多语言支持');
-console.log('----------------------------');
-
-const schema1 = dsl({
-  name: 'string:1-50!',
-  contact: dsl('string!')
-    .pattern(/^([^\s@]+@[^\s@]+\.[^\s@]+|1[3-9]\d{9})$/)
-    .messages({ pattern: 'pattern.emailOrPhone' })  // 🌍 使用多语言 key
-    .label('联系方式')
-});
-
-const testData1 = [
-  { name: '张三', contact: 'zhangsan@example.com' },
-  { name: '李四', contact: '13800138000' },
-  { name: '王五', contact: 'invalid' }
-];
-
-// 中文验证
-console.log('🇨🇳 中文错误消息:');
-testData1.forEach((data) => {
-  const result = validate(schema1, data, { locale: 'zh-CN' });
-  console.log(`  ${data.name} (${data.contact}):`, result.valid ? '✅ 通过' : '❌ 失败');
-  if (!result.valid) {
-    console.log(`    错误: ${result.errors[0].message}`);
-  }
-});
-
-// 英文验证
-console.log('\n🇺🇸 英文错误消息:');
-testData1.forEach((data) => {
-  const result = validate(schema1, data, { locale: 'en-US' });
-  console.log(`  ${data.name} (${data.contact}):`, result.valid ? '✅ Pass' : '❌ Fail');
-  if (!result.valid) {
-    console.log(`    Error: ${result.errors[0].message}`);
-  }
-});
-
-console.log('');
-
-// ========================================
-// 示例2：用户登录（用户名或邮箱）- 多语言
-// ========================================
-console.log('【示例2】用户登录（用户名或邮箱）- 多语言');
-console.log('----------------------------');
-
-const loginSchema = dsl({
-  username: dsl('string:3-32!')
-    .pattern(/^([^\s@]+@[^\s@]+\.[^\s@]+|[a-zA-Z0-9_]+)$/)
-    .messages({ pattern: 'pattern.usernameOrEmail' })  // 🌍 多语言 key
-    .label('用户名'),
-  password: 'string:8-32!'
-});
-
-const loginTest = { username: 'invalid!@#', password: '12345678' };
-
-console.log('🇨🇳 中文:');
-const r1 = validate(loginSchema, loginTest, { locale: 'zh-CN' });
-console.log(`  ${loginTest.username}:`, r1.valid ? '✅' : `❌ ${r1.errors[0].message}`);
-
-console.log('🇺🇸 英文:');
-const r2 = validate(loginSchema, loginTest, { locale: 'en-US' });
-console.log(`  ${loginTest.username}:`, r2.valid ? '✅' : `❌ ${r2.errors[0].message}`);
-
-console.log('');
-
-// ========================================
-// 示例3：URL（http 或 https）- 多语言
-// ========================================
-console.log('【示例3】URL（http 或 https）- 多语言');
-console.log('----------------------------');
-
-const urlSchema = dsl({
-  website: dsl('string!')
-    .pattern(/^https?:\/\/.+$/)
-    .messages({ pattern: 'pattern.httpOrHttps' })  // 🌍 多语言 key
-    .label('网站地址')
-});
-
-const urlTest = { website: 'ftp://example.com' };
-
-console.log('🇨🇳 中文:');
-const u1 = validate(urlSchema, urlTest, { locale: 'zh-CN' });
-console.log(`  ${urlTest.website}:`, u1.valid ? '✅' : `❌ ${u1.errors[0].message}`);
-
-console.log('🇺🇸 英文:');
-const u2 = validate(urlSchema, urlTest, { locale: 'en-US' });
-console.log(`  ${urlTest.website}:`, u2.valid ? '✅' : `❌ ${u2.errors[0].message}`);
-
-console.log('');
-
-// ========================================
-// 示例4：直接写错误消息（不使用多语言）
-// ========================================
-console.log('【示例4】直接写错误消息（不使用多语言）');
-console.log('----------------------------');
-
-const simpleSchema = dsl({
-  contact: dsl('string!')
-    .pattern(/^([^\s@]+@[^\s@]+\.[^\s@]+|1[3-9]\d{9})$/)
-    .messages({ pattern: '必须是邮箱或手机号' })  // 直接写死
-});
-
-const result = validate(simpleSchema, { contact: 'invalid' });
-console.log('invalid:', result.valid ? '✅' : `❌ ${result.errors[0].message}`);
-
-console.log('');
-
-console.log('========================================');
-console.log('示例运行完成！');
-console.log('多语言测试成功！🎉');
-console.log('========================================');
-

package/examples/union-types-example.js

@@ -1,77 +0,0 @@
-/**
- * 跨类型联合验证示例
- *
- * 演示如何使用 types: 语法实现跨类型联合验证
- */
-
-const { dsl, validate, DslBuilder, PluginManager } = require('../index');
-
-console.log('='.repeat(60));
-console.log('跨类型联合验证 - types: 语法示例');
-console.log('='.repeat(60));
-
-// ========== 示例1：基础联合类型 ==========
-console.log('\n【示例1】基础联合类型：string|number');
-const schema1 = dsl({
-  value: 'types:string|number'
-});
-
-console.log('✓ 字符串:', validate(schema1, { value: 'hello' }).valid);
-console.log('✓ 数字:', validate(schema1, { value: 123 }).valid);
-console.log('✗ 布尔:', validate(schema1, { value: true }).valid);
-
-// ========== 示例2：带约束的联合类型 ==========
-console.log('\n【示例2】带约束：string:3-10|number:0-100');
-const schema2 = dsl({
-  value: 'types:string:3-10|number:0-100!'
-});
-
-console.log('✓ 字符串(abc):', validate(schema2, { value: 'abc' }).valid);
-console.log('✓ 数字(50):', validate(schema2, { value: 50 }).valid);
-console.log('✗ 字符串太短(ab):', validate(schema2, { value: 'ab' }).valid);
-console.log('✗ 数字超范围(101):', validate(schema2, { value: 101 }).valid);
-
-// ========== 示例3：使用插件自定义类型 ==========
-console.log('\n【示例3】使用插件自定义类型');
-
-// 加载custom-format插件
-const customFormatPlugin = require('../plugins/custom-format');
-const pluginManager = new PluginManager();
-pluginManager.register(customFormatPlugin);
-pluginManager.install(require('../index'));
-
-const schema3 = dsl({
-  contact: 'types:email|phone-cn|qq!'
-});
-
-console.log('✓ 邮箱:', validate(schema3, { contact: 'user@example.com' }).valid);
-console.log('✓ 手机号:', validate(schema3, { contact: '13800138000' }).valid);
-console.log('✓ QQ号:', validate(schema3, { contact: '10000' }).valid);
-console.log('✗ 无效格式:', validate(schema3, { contact: 'invalid' }).valid);
-
-// ========== 示例4：复杂场景 - 用户注册表单 ==========
-console.log('\n【示例4】实际场景：用户注册表单');
-
-const registerSchema = dsl({
-  username: 'string:3-20!',
-  password: 'string:8-20!',
-  contact: 'types:email|phone-cn!',  // 邮箱或手机号
-  age: 'types:integer:1-150|null',    // 年龄或null
-  referralCode: 'types:string:6|null' // 推荐码（6位）或null
-});
-
-const testData = {
-  username: 'john_doe',
-  password: 'Pass1234',
-  contact: 'john@example.com',
-  age: 25,
-  referralCode: 'ABC123'
-};
-
-const result = validate(registerSchema, testData);
-console.log('✓ 完整表单验证:', result.valid);
-
-console.log('\n' + '='.repeat(60));
-console.log('示例执行完成！');
-console.log('='.repeat(60));
-