configforge 1.0.0-beta.5 → 1.0.0-beta.7

package/README.md

@@ -103,7 +103,26 @@ const converter = forge()
   .end()
 ```
 
-### 5. Set Default Values
+### 5. Merge Multiple Fields
+
+```javascript
+// Combine multiple source fields into one target field
+.merge(['firstName', 'lastName'], 'fullName', (first, last) => `${first} ${last}`)
+
+// Merge with transformation
+.merge(['basePrice', 'tax'], 'totalPrice',
+  (price, tax) => price + tax,
+  total => `$${total.toFixed(2)}`
+)
+
+// Merge complex data
+.merge(['user.profile', 'user.settings'], 'userInfo', (profile, settings) => ({
+  ...profile,
+  ...settings
+}))
+```
+
+### 6. Set Default Values
 
 ```javascript
 .defaults({
@@ -113,7 +132,34 @@ const converter = forge()
 })
 ```
 
-### 6. Convert Data
+### 7. Add Validation
+
+```javascript
+const { validators } = require('configforge');
+
+// Add field validation
+.validate('email', validators.email)
+.validate('age', validators.all(
+  validators.required,
+  validators.type('number'),
+  validators.range(18, 120)
+))
+.validate('username', validators.all(
+  validators.required,
+  validators.minLength(3),
+  validators.pattern(/^[a-zA-Z0-9_]+$/, 'Only letters, numbers, and underscores allowed')
+))
+
+// Custom validation with context
+.validate('password', (value, context) => {
+  if (context.source.confirmPassword !== value) {
+    return 'Passwords do not match';
+  }
+  return validators.minLength(8)(value, context);
+})
+```
+
+### 8. Convert Data
 
 ```javascript
 // Convert object data
@@ -247,69 +293,71 @@ console.log(result.data);
 ### Example 3: Array Processing with forEach()
 
 ```javascript
-// Citizens NPC configuration
-const citizensData = {
-  'last-created-npc-id': 2,
-  npc: [
+// Simple fruit inventory
+const fruitData = {
+  storeId: 'STORE-001',
+  fruits: [
+    {
+      name: 'Apple',
+      color: 'red',
+      price: 1.5,
+      quantity: 100,
+    },
     {
-      name: 'Guard',
-      uuid: '9e1d174d-bc6c-495e-bd70-17e60327b716',
-      traits: {
-        location: { x: 0.5, y: 98.0, z: -22.5 },
-        skintrait: { skinName: 'Nik_187t' },
-        commandtrait: { commands: [{ command: 'warp plots' }] },
-      },
+      name: 'Banana',
+      color: 'yellow',
+      price: 0.75,
+      quantity: 80,
     },
     {
-      name: 'Merchant',
-      uuid: 'fb0d6308-de11-4d3a-8c16-97338747c26f',
-      traits: {
-        location: { x: 33.5, y: 99.0, z: -31.5 },
-        skintrait: { skinName: 'FrostAMC' },
-        commandtrait: { commands: [{ command: 'knightrank' }] },
-      },
+      name: 'Orange',
+      color: 'orange',
+      price: 1.25,
+      quantity: 60,
     },
   ],
 };
 
 const converter = forge()
-  .from('citizens')
-  .to('fancynpcs')
-  .map('last-created-npc-id', 'lastId')
-  .forEach('npc', (npc, index) => {
+  .from('inventory')
+  .to('catalog')
+  .map('storeId', 'storeId')
+  .forEach('fruits', (fruit, index) => {
     return {
-      id: npc.uuid,
-      name: npc.name || `NPC_${index}`,
-      location: {
-        x: npc.traits?.location?.x,
-        y: npc.traits?.location?.y,
-        z: npc.traits?.location?.z,
-      },
-      skin: npc.traits?.skintrait?.skinName,
-      commands:
-        npc.traits?.commandtrait?.commands?.map(cmd => cmd.command) || [],
+      id: index + 1,
+      fruitName: fruit.name,
+      displayColor: fruit.color,
+      pricePerItem: fruit.price,
+      inStock: fruit.quantity,
+      totalValue: fruit.price * fruit.quantity,
+      isExpensive: fruit.price > 1.0,
     };
   });
 
-const result = await converter.convert(citizensData);
+const result = await converter.convert(fruitData);
 console.log(result.data);
 // {
-//   lastId: 2,
-//   npc: [
+//   storeId: 'STORE-001',
+//   fruits: [
 //     {
-//       id: '9e1d174d-bc6c-495e-bd70-17e60327b716',
-//       name: 'Guard',
-//       location: { x: 0.5, y: 98.0, z: -22.5 },
-//       skin: 'Nik_187t',
-//       commands: ['warp plots']
+//       id: 1,
+//       fruitName: 'Apple',
+//       displayColor: 'red',
+//       pricePerItem: 1.50,
+//       inStock: 100,
+//       totalValue: 150,
+//       isExpensive: true
 //     },
 //     {
-//       id: 'fb0d6308-de11-4d3a-8c16-97338747c26f',
-//       name: 'Merchant',
-//       location: { x: 33.5, y: 99.0, z: -31.5 },
-//       skin: 'FrostAMC',
-//       commands: ['knightrank']
-//     }
+//       id: 2,
+//       fruitName: 'Banana',
+//       displayColor: 'yellow',
+//       pricePerItem: 0.75,
+//       inStock: 80,
+//       totalValue: 60,
+//       isExpensive: false
+//     },
+//     // ... more fruits
 //   ]
 // }
 ```
@@ -317,55 +365,255 @@ console.log(result.data);
 ### Example 4: Conditional Mapping with when()
 
 ```javascript
-// Different NPC types need different mappings
-const npcConfig = {
-  npc: {
-    type: 'PLAYER',
-    name: 'Guard',
-    uuid: '9e1d174d-bc6c-495e-bd70-17e60327b716',
-    traits: {
-      skintrait: { skinName: 'Steve' },
-      commandtrait: { commands: ['warp spawn', 'heal'] },
-      equipment: { helmet: 'diamond_helmet' },
-    },
+// Different types of pets need different mappings
+const petData = {
+  type: 'dog',
+  name: 'Buddy',
+  age: 3,
+  dogInfo: {
+    breed: 'Golden Retriever',
+    tricks: ['sit', 'stay', 'fetch'],
+  },
+  catInfo: {
+    breed: 'Persian',
+    indoor: true,
+  },
+  birdInfo: {
+    species: 'Parrot',
+    canTalk: true,
   },
 };
 
 const converter = forge()
-  .from('citizens')
-  .to('fancynpcs')
-  .map('npc.name', 'name')
-  .map('npc.uuid', 'id')
-
-  // Only map skin for PLAYER NPCs
-  .when(source => source.npc?.type === 'PLAYER')
-  .map('npc.traits.skintrait.skinName', 'skin')
-  .map('npc.traits.commandtrait.commands', 'commands')
+  .from('petData')
+  .to('petProfile')
+  .map('name', 'petName')
+  .map('age', 'petAge')
+  .map('type', 'animalType')
+
+  // Only map dog-specific info for dogs
+  .when(source => source.type === 'dog')
+  .map('dogInfo.breed', 'breed')
+  .map('dogInfo.tricks', 'knownTricks')
   .end()
 
-  // Only map profession for VILLAGER NPCs
-  .when(source => source.npc?.type === 'VILLAGER')
-  .map('npc.traits.profession', 'profession')
-  .map('npc.traits.trades', 'trades')
+  // Only map cat-specific info for cats
+  .when(source => source.type === 'cat')
+  .map('catInfo.breed', 'breed')
+  .map('catInfo.indoor', 'isIndoorCat')
   .end()
 
-  // String condition - only if field exists
-  .when('npc.traits.equipment')
-  .map('npc.traits.equipment', 'equipment')
+  // Only map bird-specific info for birds
+  .when(source => source.type === 'bird')
+  .map('birdInfo.species', 'species')
+  .map('birdInfo.canTalk', 'canSpeak')
   .end();
 
-const result = await converter.convert(npcConfig);
+const result = await converter.convert(petData);
 console.log(result.data);
 // {
-//   name: 'Guard',
-//   id: '9e1d174d-bc6c-495e-bd70-17e60327b716',
-//   skin: 'Steve',
-//   commands: ['warp spawn', 'heal'],
-//   equipment: { helmet: 'diamond_helmet' }
+//   petName: 'Buddy',
+//   petAge: 3,
+//   animalType: 'dog',
+//   breed: 'Golden Retriever',
+//   knownTricks: ['sit', 'stay', 'fetch']
 // }
 ```
 
-### Example 5: File Conversion
+### Example 5: Merge Multiple Fields with merge()
+
+```javascript
+// Simple student report card
+const studentData = {
+  student: {
+    firstName: 'Alice',
+    lastName: 'Smith',
+  },
+  grades: {
+    math: 85,
+    english: 92,
+    science: 78,
+  },
+  activities: ['soccer', 'chess', 'art'],
+  info: {
+    grade: '5th',
+    teacher: 'Ms. Johnson',
+  },
+};
+
+const converter = forge()
+  .from('report')
+  .to('summary')
+
+  // Merge student name fields
+  .merge(
+    ['student.firstName', 'student.lastName'],
+    'studentName',
+    (first, last) => `${first} ${last}`
+  )
+
+  // Calculate total with transformation
+  .merge(
+    ['order.basePrice', 'order.tax', 'order.shipping'],
+    'subtotal',
+    (base, tax, shipping) => base + tax + shipping
+  )
+
+  .merge(
+    ['order.basePrice', 'order.tax', 'order.shipping', 'order.discount'],
+    'total',
+    (base, tax, shipping, discount) => base + tax + shipping - discount,
+    total => `$${total.toFixed(2)}`
+  ) // Transform to currency format
+
+  // Merge arrays and objects
+  .merge(['items', 'metadata'], 'orderSummary', (items, meta) => ({
+    itemCount: items.length,
+    items: items.join(', '),
+    ...meta,
+  }))
+
+  // Simple field mappings
+  .map('customer.email', 'billingEmail');
+
+const result = await converter.convert(orderData);
+console.log(result.data);
+// {
+//   customerName: 'John Doe',
+//   subtotal: 121.49,
+//   total: '$106.49',
+//   orderSummary: {
+//     itemCount: 3,
+//     items: 'laptop, mouse, keyboard',
+//     orderDate: '2023-12-01',
+//     source: 'web'
+//   },
+//   billingEmail: 'john.doe@example.com'
+// }
+```
+
+### Example 6: Data Validation
+
+```javascript
+const { forge, validators } = require('configforge');
+
+// User registration form data
+const formData = {
+  personalInfo: {
+    firstName: 'John',
+    lastName: 'Doe',
+    email: 'john.doe@example.com',
+    age: 28,
+  },
+  accountInfo: {
+    username: 'johndoe123',
+    password: 'SecurePass123!',
+    confirmPassword: 'SecurePass123!',
+  },
+  preferences: {
+    newsletter: 'yes',
+    theme: 'dark',
+    language: 'en',
+  },
+};
+
+const converter = forge()
+  .from('form')
+  .to('user')
+  // Map fields
+  .merge(
+    ['personalInfo.firstName', 'personalInfo.lastName'],
+    'fullName',
+    (first, last) => `${first} ${last}`
+  )
+  .map('personalInfo.email', 'email')
+  .map('personalInfo.age', 'age')
+  .map('accountInfo.username', 'username')
+  .map('accountInfo.password', 'password')
+  .map(
+    'preferences.newsletter',
+    'subscribeToNewsletter',
+    value => value === 'yes'
+  )
+  .map('preferences.theme', 'theme')
+  .map('preferences.language', 'language')
+
+  // Add validation rules
+  .validate(
+    'fullName',
+    validators.all(
+      validators.required,
+      validators.minLength(2),
+      validators.maxLength(100)
+    )
+  )
+  .validate('email', validators.all(validators.required, validators.email))
+  .validate(
+    'age',
+    validators.all(
+      validators.required,
+      validators.type('number'),
+      validators.range(13, 120)
+    )
+  )
+  .validate(
+    'username',
+    validators.all(
+      validators.required,
+      validators.minLength(3),
+      validators.maxLength(20),
+      validators.pattern(
+        /^[a-zA-Z0-9_]+$/,
+        'Username can only contain letters, numbers, and underscores'
+      )
+    )
+  )
+  .validate(
+    'password',
+    validators.all(
+      validators.required,
+      validators.minLength(8),
+      validators.pattern(
+        /^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)/,
+        'Password must contain lowercase, uppercase, and number'
+      )
+    )
+  )
+  .validate('theme', validators.oneOf(['light', 'dark', 'auto']))
+  .validate('language', validators.oneOf(['en', 'es', 'fr', 'de']))
+
+  // Custom validation
+  .validate('password', (value, context) => {
+    if (context.source.accountInfo.confirmPassword !== value) {
+      return 'Passwords do not match';
+    }
+    return true;
+  });
+
+const result = await converter.convert(formData);
+
+if (result.errors.length > 0) {
+  console.log('Validation errors:');
+  result.errors.forEach(error => {
+    console.log(`- ${error.path}: ${error.message}`);
+  });
+} else {
+  console.log('User data is valid!');
+  console.log(result.data);
+  // {
+  //   fullName: 'John Doe',
+  //   email: 'john.doe@example.com',
+  //   age: 28,
+  //   username: 'johndoe123',
+  //   password: 'SecurePass123!',
+  //   subscribeToNewsletter: true,
+  //   theme: 'dark',
+  //   language: 'en'
+  // }
+}
+```
+
+### Example 7: File Conversion
 
 ```javascript
 // Convert YAML file to JSON structure
@@ -391,6 +639,7 @@ await result.save('./config.json');
 - ✅ **Array access**: Use bracket notation like `items[0]`
 - ✅ **Transformations**: Transform values during mapping
 - ✅ **Conditional mapping**: Use `when()` for conditional logic
+- ✅ **Multi-field merging**: Use `merge()` to combine multiple sources into one target
 - ✅ **Default values**: Set fallback values
 - ✅ **File support**: Convert YAML, JSON files directly
 - ✅ **Statistics**: Get detailed conversion reports
@@ -405,14 +654,15 @@ await result.save('./config.json');
 - Value transformations
 - Default values with `defaults()`
 - **Array/object processing with `forEach()`**
-- **Conditional mapping with `when()`** ⭐ NEW!
+- **Conditional mapping with `when()`**
+- **Multi-field merging with `merge()`**
+- **Field validation with `validate()`** ⭐ NEW!
 - File parsing (YAML, JSON)
 - Conversion statistics and reporting
 - Before/after hooks
 
 **🚧 Coming Soon:**
 
-- Field validation
 - CLI generation
 - Plugin system
 
@@ -422,10 +672,14 @@ await result.save('./config.json');
 2. **Use dot notation** for nested objects: `'user.profile.name'`
 3. **Use bracket notation** for arrays: `'items[0]'`, `'items[1]'`
 4. **Transform functions** get the value and context: `(value, ctx) => { ... }`
-5. **Use conditional mapping** with `when()` for type-specific logic: `when(source => source.type === 'PLAYER')`
-6. **Always call `.end()`** after conditional mappings to return to the main converter
-7. **Check `result.unmapped`** to see which fields weren't mapped
-8. **Use `result.print()`** for a nice conversion report
+5. **Use conditional mapping** with `when()` for type-specific logic: `when(source => source.accountType === 'premium')`
+6. **Use merge()** to combine multiple fields: `merge(['field1', 'field2'], 'result', (a, b) => a + b)`
+7. **Use validation** to ensure data quality: `validate('email', validators.email)`
+8. **Combine validators** with `validators.all()` for multiple rules
+9. **Always call `.end()`** after conditional mappings to return to the main converter
+10. **Check `result.errors`** to see validation failures
+11. **Check `result.unmapped`** to see which fields weren't mapped
+12. **Use `result.print()`** for a nice conversion report
 
 ---
 

package/dist/core/Converter.d.ts

@@ -10,6 +10,7 @@ export declare class Converter<TSource = any, TTarget = any> {
     private validators;
     private hooks;
     private options;
+    private sourceData?;
     constructor(options?: ForgeOptions);
     /**
      * Define the source schema
@@ -48,9 +49,9 @@ export declare class Converter<TSource = any, TTarget = any> {
      */
     forEach(source: string, mapFn: ForEachFn): this;
     /**
-     * Merge multiple sources (placeholder - will be implemented in task 10)
+     * Merge multiple sources into a single target field
      */
-    merge(_sources: string[], _target: string, _mergeFn: MergeFn): this;
+    merge(sources: string[], target: string, mergeFn: MergeFn, transform?: TransformFn): this;
     /**
      * Convert input data - supports objects, file paths, or arrays of file paths
      */

package/dist/core/Converter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Converter.d.ts","sourceRoot":"","sources":["../../src/core/Converter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Converter.d.ts","sourceRoot":"","sources":["../../src/core/Converter.ts"],"names":[],"mappings":"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"}

package/dist/core/Converter.js

@@ -126,11 +126,22 @@ class Converter {
         return this;
     }
     /**
-     * Merge multiple sources (placeholder - will be implemented in task 10)
+     * Merge multiple sources into a single target field
      */
-    merge(_sources, _target, _mergeFn) {
-        // This will be implemented in the merge functionality task
-        throw new Error('merge() method not yet implemented');
+    merge(sources, target, mergeFn, transform) {
+        const mapping = {
+            id: (0, uuid_1.v4)(),
+            source: sources.join(','), // Store sources as comma-separated string for identification
+            target,
+            type: 'merge',
+            ...(transform && { transform }),
+            metadata: {
+                sources,
+                mergeFn,
+            },
+        };
+        this.mappings.push(mapping);
+        return this;
     }
     /**
      * Convert input data - supports objects, file paths, or arrays of file paths
@@ -218,6 +229,8 @@ class Converter {
     executeConversion(sourceData, startTime) {
         const warnings = [];
         const errors = [];
+        // Store source data for validation context
+        this.sourceData = sourceData;
         // Run before hooks
         let processedSource = sourceData;
         for (const hook of this.hooks.before) {
@@ -307,20 +320,20 @@ class Converter {
             try {
                 const value = this.getPath(targetData, field);
                 const result = validator(value, {
-                    source: {},
+                    source: this.sourceData || {}, // Store source data for validation context
                     target: targetData,
                     path: field,
                     converter: this,
-                    allErrors: errors,
+                    allErrors: errors.filter(e => e instanceof types_1.ValidationError),
                 });
                 if (result !== true) {
-                    errors.push(new types_1.GenericConfigForgeError(typeof result === 'string'
+                    errors.push(new types_1.ValidationError(typeof result === 'string'
                         ? result
                         : `Validation failed for field: ${field}`, { path: field }));
                 }
             }
             catch (error) {
-                errors.push(new types_1.GenericConfigForgeError(`Validation error for field ${field}: ${error instanceof Error ? error.message : 'Unknown error'}`, { path: field }));
+                errors.push(new types_1.ValidationError(`Validation error for field ${field}: ${error instanceof Error ? error.message : 'Unknown error'}`, { path: field }));
             }
         }
     }
@@ -472,8 +485,10 @@ class ConditionalMapper {
             source,
             target,
             type: 'conditional',
-            condition: this.condition,
             ...(transform && { transform }),
+            metadata: {
+                condition: this.condition,
+            },
         };
         // Add the conditional mapping to the converter
         this.converter.addMapping(mapping);