@fluentcommerce/fc-connect-sdk 0.1.53 → 0.1.55

package/docs/04-REFERENCE/resolver-signature/resolver-signature-readme.md

@@ -1,351 +1,351 @@
-# Resolver Signature Learning Path
-
-> **Complete guide to the standard 4-parameter resolver signature**
-> Progressive learning modules with real schema examples and verified code patterns
-
-## 📚 What You'll Learn
-
-This guide teaches you the standard resolver signature used across ALL mappers in the Fluent Connect SDK. By the end, you'll understand:
-
-- ✅ Why the 4-parameter signature is consistent across UniversalMapper AND GraphQLMutationMapper
-- ✅ What each parameter does and when to use it
-- ✅ How to write context-aware transformations using sourceData
-- ✅ How to leverage the ResolverHelpers utilities (54 helper functions)
-- ✅ How to migrate from old 3-arg resolvers to the new 4-arg pattern
-- ✅ Best practices for testing and production use
-
-## 🎯 Learning Path Overview
-
-This guide is organized into **7 progressive modules**. Follow them in order for the best learning experience:
-
-| Module | Topic | Level |
-|--------|-------|-------|
-| [Module 1](./modules/resolver-signature-01-foundations.md) | **Foundations** - Standard signature, why 4 parameters, consistency | Beginner |
-| [Module 2](./modules/resolver-signature-02-parameter-reference.md) | **Parameter Reference** - Detailed breakdown of each parameter | Beginner |
-| [Module 3](./modules/resolver-signature-03-basic-examples.md) | **Basic Examples** - Simple transformations, string/number handling | Beginner |
-| [Module 4](./modules/resolver-signature-04-advanced-patterns.md) | **Advanced Patterns** - Context-aware transformations, async resolvers | Advanced |
-| [Module 5](./modules/resolver-signature-05-sdk-resolvers.md) | **SDK Resolvers** - How built-in resolvers use the signature | Intermediate |
-| [Module 6](./modules/resolver-signature-06-migration-guide.md) | **Migration Guide** - Migrating from 3-arg to 4-arg, best practices | Intermediate |
-| [Module 7](./modules/resolver-signature-07-api-reference.md) | **API Reference** - TypeScript types, ResolverHelpers interface, testing | Reference |
-
-## 🚀 Quick Navigation
-
-### By Use Case
-
-- **First time writing resolvers?** → Start with [Module 1: Foundations](./modules/resolver-signature-01-foundations.md)
-- **Need to understand parameters?** → Jump to [Module 2: Parameter Reference](./modules/resolver-signature-02-parameter-reference.md)
-- **Migrating old resolvers?** → See [Module 6: Migration Guide](./modules/resolver-signature-06-migration-guide.md)
-- **Need specific helper function?** → Check [Module 7: API Reference](./modules/resolver-signature-07-api-reference.md)
-- **Want code examples?** → Browse [Examples Directory](./examples/)
-
-### By Resolver Type
-
-Different resolver types leverage parameters differently:
-
-| Resolver Type | Primary Parameters | Complexity | Example |
-|---------------|-------------------|------------|---------|
-| Simple transformations | `value`, `helpers` | Low | [Basic String Transform](./examples/basic-resolvers.ts) |
-| Context-aware | `value`, `sourceData`, `helpers` | Medium | [Price Calculation](./examples/advanced-resolvers.ts) |
-| Configuration-driven | `value`, `config`, `helpers` | Medium | [Tax Rate Lookup](./examples/advanced-resolvers.ts) |
-| Full context | All 4 parameters | High | [Complex Transform](./examples/advanced-resolvers.ts) |
-| Async operations | All 4 + async | High | [API Enrichment](./examples/async-resolvers.ts) |
-
-## 📖 Quick Reference
-
-For quick lookups, see:
-- [Quick Reference Cheat Sheet](../../02-CORE-GUIDES/advanced-services/advanced-services-quick-reference.md) - All parameters and helpers on one page
-- [Common Patterns](./examples/basic-resolvers.ts) - Copy-paste ready snippets
-- [Migration Checklist](./modules/resolver-signature-06-migration-guide.md#migration-checklist) - Step-by-step migration guide
-
-## 🎓 Prerequisites
-
-Before starting this guide, you should:
-
-1. ✅ Have the SDK installed: `npm install @fluentcommerce/fc-connect-sdk`
-2. ✅ Understand basic TypeScript concepts (types, functions, async/await)
-3. ✅ Be familiar with UniversalMapper or GraphQLMutationMapper
-4. ✅ Have read the [Universal Mapping Guide](../../02-CORE-GUIDES/mapping/mapping-readme.md)
-
-**New to the SDK?** Start with the [Getting Started Guide](../../00-START-HERE/getting-started.md) first.
-
-## 🔍 Key Concepts at a Glance
-
-### The Standard Signature
-
-```typescript
-// ✅ STANDARD 4-PARAMETER SIGNATURE
-// Used by BOTH UniversalMapper AND GraphQLMutationMapper
-type ResolverFunction = (
-  value: any,              // The field value being transformed
-  sourceData: any,         // Full source object for context
-  config: any,             // Resolver-specific configuration
-  helpers: ResolverHelpers // SDK utilities (54 helper functions)
-) => any | Promise<any>;
-```
-
-### Why This Matters
-
-**Consistency Across Mappers:**
-```typescript
-// Same signature everywhere!
-const customResolvers = {
-  // Works in UniversalMapper (CSV/JSON/Parquet/XML)
-  'custom.formatSKU': (value, sourceData, config, helpers) => {
-    return String(value).toUpperCase();
-  },
-
-  // Works in GraphQLMutationMapper (XML/JSON → GraphQL)
-  'custom.calculateTax': (value, sourceData, config, helpers) => {
-    const taxRate = config.taxRate || 0.1;
-    return helpers.parseFloatSafe(value, 0) * (1 + taxRate);
-  }
-};
-
-// Use with UniversalMapper
-const mapper1 = new UniversalMapper(mapping, { customResolvers });
-
-// Use with GraphQLMutationMapper
-const mapper2 = new GraphQLMutationMapper(mapping, { customResolvers });
-```
-
-### Before and After
-
-```typescript
-// ❌ OLD (3 parameters) - Will fail!
-'custom.myResolver': (value, sourceData, helpers) => {
-  return helpers.get(sourceData, 'some.path');
-}
-
-// ✅ NEW (4 parameters) - Correct!
-'custom.myResolver': (value, sourceData, config, helpers) => {
-  return helpers.get(sourceData, 'some.path');
-}
-```
-
-## 🎯 What Makes This Signature Powerful
-
-### 1. Access to Source Context
-```typescript
-'custom.calculatePrice': (basePrice, sourceData, config, helpers) => {
-  // Access sibling fields from sourceData
-  const quantity = helpers.get(sourceData, 'quantity') || 1;
-  const discount = helpers.get(sourceData, 'discountPercent') || 0;
-
-  return basePrice * quantity * (1 - discount / 100);
-}
-```
-
-### 2. Configuration-Driven Logic
-```typescript
-'custom.formatWithPrefix': (value, sourceData, config, helpers) => {
-  // Use config for business rules
-  const prefix = config.skuPrefix || 'SKU';
-  return `${prefix}-${value}`;
-}
-
-// Pass config via mapper
-const mapper = new UniversalMapper(mapping, {
-  customResolvers,
-  context: { skuPrefix: 'PROD' }  // Becomes 'config' parameter
-});
-```
-
-### 3. Rich Utility Library
-```typescript
-'custom.safeTransform': (value, sourceData, config, helpers) => {
-  // Use helpers for safe operations
-  const numeric = helpers.parseFloatSafe(value, 0);
-  const formatted = helpers.formatCurrency(numeric, config.currency);
-
-  helpers.log.debug(`Transformed ${value} to ${formatted}`);
-  return formatted;
-}
-```
-
-### 4. Async Operations
-```typescript
-'custom.enrichData': async (value, sourceData, config, helpers) => {
-  // Async API calls supported
-  if (!helpers.fluentClient) {
-    return value;
-  }
-
-  const result = await helpers.fluentClient.graphql({
-    query: `query { product(id: "${value}") { name } }`
-  });
-
-  return result.data.product;
-}
-```
-
-## 📚 Module Details
-
-### Module 1: Foundations
-Learn why the 4-parameter signature exists and how it ensures consistency across all mappers.
-
-**Key Topics:**
-- Standard signature definition
-- Why 4 parameters instead of 3
-- Consistency across UniversalMapper and GraphQLMutationMapper
-- Predictability and ease of use
-
-**Time:** 10 minutes
-
-### Module 2: Parameter Reference
-Deep dive into each parameter with examples and use cases.
-
-**Key Topics:**
-- `value` - The extracted field value
-- `sourceData` - Full source object access
-- `config` - Business rules and configuration
-- `helpers` - 54 utility functions
-
-**Time:** 20 minutes
-
-### Module 3: Basic Examples
-Simple, practical examples to get started immediately.
-
-**Key Topics:**
-- String transformations
-- Number parsing and formatting
-- Date handling
-- Safe fallback patterns
-
-**Time:** 15 minutes
-
-### Module 4: Advanced Patterns
-Complex transformations using all 4 parameters.
-
-**Key Topics:**
-- Context-aware transformations
-- Multi-field calculations
-- Async resolvers with API calls
-- Error handling patterns
-
-**Time:** 30 minutes
-
-### Module 5: SDK Resolvers
-How built-in SDK resolvers use the 4-parameter signature.
-
-**Key Topics:**
-- SDK resolver implementation
-- Why SDK resolvers follow the same pattern
-- Understanding consistency
-- Extending SDK resolvers
-
-**Time:** 15 minutes
-
-### Module 6: Migration Guide
-Step-by-step guide to migrate from old 3-arg resolvers.
-
-**Key Topics:**
-- Migration checklist
-- Common migration scenarios
-- Breaking changes and fixes
-- Testing migrated resolvers
-
-**Time:** 20 minutes
-
-### Module 7: API Reference
-Complete TypeScript types, interfaces, and testing utilities.
-
-**Key Topics:**
-- `ResolverFunction` type definition
-- `ResolverHelpers` interface (all 48+ functions)
-- Testing resolver signatures
-- Production best practices
-
-**Time:** Reference (as needed)
-
-## 🧪 Complete Working Example
-
-```typescript
-import { UniversalMapper } from '@fluentcommerce/fc-connect-sdk';
-
-// Define custom resolvers using 4-parameter signature
-const customResolvers = {
-  // Simple transformation
-  'custom.formatSKU': (value, sourceData, config, helpers) => {
-    const prefix = config.skuPrefix || 'SKU';
-    return `${prefix}-${String(value).toUpperCase()}`;
-  },
-
-  // Context-aware transformation
-  'custom.calculateTotal': (value, sourceData, config, helpers) => {
-    const quantity = helpers.get(sourceData, 'quantity') || 1;
-    const price = helpers.parseFloatSafe(value, 0);
-    const taxRate = config.taxRate || 0;
-
-    return price * quantity * (1 + taxRate);
-  },
-
-  // Async resolver
-  'custom.enrichProduct': async (sku, sourceData, config, helpers) => {
-    if (!helpers.fluentClient) {
-      return { sku };
-    }
-
-    try {
-      const result = await helpers.fluentClient.graphql({
-        query: `query { product(ref: "${sku}") { id name } }`
-      });
-      return result.data.product;
-    } catch (error) {
-      helpers.log.error('Product enrichment failed', error);
-      return { sku };
-    }
-  }
-};
-
-// Use with mapper
-const mapper = new UniversalMapper(
-  {
-    fields: {
-      sku: { source: 'product_id', resolver: 'custom.formatSKU' },
-      total: { source: 'base_price', resolver: 'custom.calculateTotal' },
-      product: { source: 'sku', resolver: 'custom.enrichProduct' }
-    }
-  },
-  {
-    customResolvers,
-    context: { skuPrefix: 'PROD', taxRate: 0.1 },
-    fluentClient: myFluentClient,
-    logger: myLogger
-  }
-);
-
-// Transform data
-const result = await mapper.map({
-  product_id: 'widget-001',
-  base_price: '19.99',
-  quantity: 5
-});
-
-console.log(result.data);
-// {
-//   sku: 'PROD-WIDGET-001',
-//   total: 109.945,  // 19.99 * 5 * 1.1
-//   product: { id: '123', name: 'Widget' }
-// }
-```
-
-## ✅ Key Takeaways
-
-1. **Standard Signature** - Always `(value, sourceData, config, helpers) => any`
-2. **Universal Application** - Works in UniversalMapper AND GraphQLMutationMapper
-3. **Always 4 Parameters** - Even if you don't use all of them, include all 4
-4. **Config = Context** - Pass via mapper options `context`, receive as 3rd param
-5. **Helpers = Power** - 54 SDK utility functions + fluentClient + logger
-6. **Consistency = Predictability** - Same pattern everywhere makes SDK easier to use
-
-## 🎯 Next Steps
-
-1. **Start Learning** → Begin with [Module 1: Foundations](./modules/resolver-signature-01-foundations.md)
-2. **Try Examples** → Copy code from [Examples Directory](./examples/)
-3. **Build Your Own** → Create custom resolvers for your use case
-4. **Test Thoroughly** → Use patterns from [Module 7: API Reference](./modules/resolver-signature-07-api-reference.md)
-5. **Deploy Confidently** → Follow best practices from [Module 6: Migration Guide](./modules/resolver-signature-06-migration-guide.md)
-
----
-
-**Ready to master resolver signatures?** Start with [Module 1: Foundations](./modules/resolver-signature-01-foundations.md) and progress through the learning path.
+# Resolver Signature Learning Path
+
+> **Complete guide to the standard 4-parameter resolver signature**
+> Progressive learning modules with real schema examples and verified code patterns
+
+## 📚 What You'll Learn
+
+This guide teaches you the standard resolver signature used across ALL mappers in the Fluent Connect SDK. By the end, you'll understand:
+
+- ✅ Why the 4-parameter signature is consistent across UniversalMapper AND GraphQLMutationMapper
+- ✅ What each parameter does and when to use it
+- ✅ How to write context-aware transformations using sourceData
+- ✅ How to leverage the ResolverHelpers utilities (54 helper functions)
+- ✅ How to migrate from old 3-arg resolvers to the new 4-arg pattern
+- ✅ Best practices for testing and production use
+
+## 🎯 Learning Path Overview
+
+This guide is organized into **7 progressive modules**. Follow them in order for the best learning experience:
+
+| Module | Topic | Level |
+|--------|-------|-------|
+| [Module 1](./modules/resolver-signature-01-foundations.md) | **Foundations** - Standard signature, why 4 parameters, consistency | Beginner |
+| [Module 2](./modules/resolver-signature-02-parameter-reference.md) | **Parameter Reference** - Detailed breakdown of each parameter | Beginner |
+| [Module 3](./modules/resolver-signature-03-basic-examples.md) | **Basic Examples** - Simple transformations, string/number handling | Beginner |
+| [Module 4](./modules/resolver-signature-04-advanced-patterns.md) | **Advanced Patterns** - Context-aware transformations, async resolvers | Advanced |
+| [Module 5](./modules/resolver-signature-05-sdk-resolvers.md) | **SDK Resolvers** - How built-in resolvers use the signature | Intermediate |
+| [Module 6](./modules/resolver-signature-06-migration-guide.md) | **Migration Guide** - Migrating from 3-arg to 4-arg, best practices | Intermediate |
+| [Module 7](./modules/resolver-signature-07-api-reference.md) | **API Reference** - TypeScript types, ResolverHelpers interface, testing | Reference |
+
+## 🚀 Quick Navigation
+
+### By Use Case
+
+- **First time writing resolvers?** → Start with [Module 1: Foundations](./modules/resolver-signature-01-foundations.md)
+- **Need to understand parameters?** → Jump to [Module 2: Parameter Reference](./modules/resolver-signature-02-parameter-reference.md)
+- **Migrating old resolvers?** → See [Module 6: Migration Guide](./modules/resolver-signature-06-migration-guide.md)
+- **Need specific helper function?** → Check [Module 7: API Reference](./modules/resolver-signature-07-api-reference.md)
+- **Want code examples?** → Browse [Examples Directory](./examples/)
+
+### By Resolver Type
+
+Different resolver types leverage parameters differently:
+
+| Resolver Type | Primary Parameters | Complexity | Example |
+|---------------|-------------------|------------|---------|
+| Simple transformations | `value`, `helpers` | Low | [Basic String Transform](./examples/basic-resolvers.ts) |
+| Context-aware | `value`, `sourceData`, `helpers` | Medium | [Price Calculation](./examples/advanced-resolvers.ts) |
+| Configuration-driven | `value`, `config`, `helpers` | Medium | [Tax Rate Lookup](./examples/advanced-resolvers.ts) |
+| Full context | All 4 parameters | High | [Complex Transform](./examples/advanced-resolvers.ts) |
+| Async operations | All 4 + async | High | [API Enrichment](./examples/async-resolvers.ts) |
+
+## 📖 Quick Reference
+
+For quick lookups, see:
+- [Quick Reference Cheat Sheet](../../02-CORE-GUIDES/advanced-services/advanced-services-quick-reference.md) - All parameters and helpers on one page
+- [Common Patterns](./examples/basic-resolvers.ts) - Copy-paste ready snippets
+- [Migration Checklist](./modules/resolver-signature-06-migration-guide.md#migration-checklist) - Step-by-step migration guide
+
+## 🎓 Prerequisites
+
+Before starting this guide, you should:
+
+1. ✅ Have the SDK installed: `npm install @fluentcommerce/fc-connect-sdk`
+2. ✅ Understand basic TypeScript concepts (types, functions, async/await)
+3. ✅ Be familiar with UniversalMapper or GraphQLMutationMapper
+4. ✅ Have read the [Universal Mapping Guide](../../02-CORE-GUIDES/mapping/mapping-readme.md)
+
+**New to the SDK?** Start with the [Getting Started Guide](../../00-START-HERE/getting-started.md) first.
+
+## 🔍 Key Concepts at a Glance
+
+### The Standard Signature
+
+```typescript
+// ✅ STANDARD 4-PARAMETER SIGNATURE
+// Used by BOTH UniversalMapper AND GraphQLMutationMapper
+type ResolverFunction = (
+  value: any,              // The field value being transformed
+  sourceData: any,         // Full source object for context
+  config: any,             // Resolver-specific configuration
+  helpers: ResolverHelpers // SDK utilities (54 helper functions)
+) => any | Promise<any>;
+```
+
+### Why This Matters
+
+**Consistency Across Mappers:**
+```typescript
+// Same signature everywhere!
+const customResolvers = {
+  // Works in UniversalMapper (CSV/JSON/Parquet/XML)
+  'custom.formatSKU': (value, sourceData, config, helpers) => {
+    return String(value).toUpperCase();
+  },
+
+  // Works in GraphQLMutationMapper (XML/JSON → GraphQL)
+  'custom.calculateTax': (value, sourceData, config, helpers) => {
+    const taxRate = config.taxRate || 0.1;
+    return helpers.parseFloatSafe(value, 0) * (1 + taxRate);
+  }
+};
+
+// Use with UniversalMapper
+const mapper1 = new UniversalMapper(mapping, { customResolvers });
+
+// Use with GraphQLMutationMapper
+const mapper2 = new GraphQLMutationMapper(mapping, { customResolvers });
+```
+
+### Before and After
+
+```typescript
+// ❌ OLD (3 parameters) - Will fail!
+'custom.myResolver': (value, sourceData, helpers) => {
+  return helpers.get(sourceData, 'some.path');
+}
+
+// ✅ NEW (4 parameters) - Correct!
+'custom.myResolver': (value, sourceData, config, helpers) => {
+  return helpers.get(sourceData, 'some.path');
+}
+```
+
+## 🎯 What Makes This Signature Powerful
+
+### 1. Access to Source Context
+```typescript
+'custom.calculatePrice': (basePrice, sourceData, config, helpers) => {
+  // Access sibling fields from sourceData
+  const quantity = helpers.get(sourceData, 'quantity') || 1;
+  const discount = helpers.get(sourceData, 'discountPercent') || 0;
+
+  return basePrice * quantity * (1 - discount / 100);
+}
+```
+
+### 2. Configuration-Driven Logic
+```typescript
+'custom.formatWithPrefix': (value, sourceData, config, helpers) => {
+  // Use config for business rules
+  const prefix = config.skuPrefix || 'SKU';
+  return `${prefix}-${value}`;
+}
+
+// Pass config via mapper
+const mapper = new UniversalMapper(mapping, {
+  customResolvers,
+  context: { skuPrefix: 'PROD' }  // Becomes 'config' parameter
+});
+```
+
+### 3. Rich Utility Library
+```typescript
+'custom.safeTransform': (value, sourceData, config, helpers) => {
+  // Use helpers for safe operations
+  const numeric = helpers.parseFloatSafe(value, 0);
+  const formatted = helpers.formatCurrency(numeric, config.currency);
+
+  helpers.log.debug(`Transformed ${value} to ${formatted}`);
+  return formatted;
+}
+```
+
+### 4. Async Operations
+```typescript
+'custom.enrichData': async (value, sourceData, config, helpers) => {
+  // Async API calls supported
+  if (!helpers.fluentClient) {
+    return value;
+  }
+
+  const result = await helpers.fluentClient.graphql({
+    query: `query { product(id: "${value}") { name } }`
+  });
+
+  return result.data.product;
+}
+```
+
+## 📚 Module Details
+
+### Module 1: Foundations
+Learn why the 4-parameter signature exists and how it ensures consistency across all mappers.
+
+**Key Topics:**
+- Standard signature definition
+- Why 4 parameters instead of 3
+- Consistency across UniversalMapper and GraphQLMutationMapper
+- Predictability and ease of use
+
+**Time:** 10 minutes
+
+### Module 2: Parameter Reference
+Deep dive into each parameter with examples and use cases.
+
+**Key Topics:**
+- `value` - The extracted field value
+- `sourceData` - Full source object access
+- `config` - Business rules and configuration
+- `helpers` - 54 utility functions
+
+**Time:** 20 minutes
+
+### Module 3: Basic Examples
+Simple, practical examples to get started immediately.
+
+**Key Topics:**
+- String transformations
+- Number parsing and formatting
+- Date handling
+- Safe fallback patterns
+
+**Time:** 15 minutes
+
+### Module 4: Advanced Patterns
+Complex transformations using all 4 parameters.
+
+**Key Topics:**
+- Context-aware transformations
+- Multi-field calculations
+- Async resolvers with API calls
+- Error handling patterns
+
+**Time:** 30 minutes
+
+### Module 5: SDK Resolvers
+How built-in SDK resolvers use the 4-parameter signature.
+
+**Key Topics:**
+- SDK resolver implementation
+- Why SDK resolvers follow the same pattern
+- Understanding consistency
+- Extending SDK resolvers
+
+**Time:** 15 minutes
+
+### Module 6: Migration Guide
+Step-by-step guide to migrate from old 3-arg resolvers.
+
+**Key Topics:**
+- Migration checklist
+- Common migration scenarios
+- Breaking changes and fixes
+- Testing migrated resolvers
+
+**Time:** 20 minutes
+
+### Module 7: API Reference
+Complete TypeScript types, interfaces, and testing utilities.
+
+**Key Topics:**
+- `ResolverFunction` type definition
+- `ResolverHelpers` interface (all 48+ functions)
+- Testing resolver signatures
+- Production best practices
+
+**Time:** Reference (as needed)
+
+## 🧪 Complete Working Example
+
+```typescript
+import { UniversalMapper } from '@fluentcommerce/fc-connect-sdk';
+
+// Define custom resolvers using 4-parameter signature
+const customResolvers = {
+  // Simple transformation
+  'custom.formatSKU': (value, sourceData, config, helpers) => {
+    const prefix = config.skuPrefix || 'SKU';
+    return `${prefix}-${String(value).toUpperCase()}`;
+  },
+
+  // Context-aware transformation
+  'custom.calculateTotal': (value, sourceData, config, helpers) => {
+    const quantity = helpers.get(sourceData, 'quantity') || 1;
+    const price = helpers.parseFloatSafe(value, 0);
+    const taxRate = config.taxRate || 0;
+
+    return price * quantity * (1 + taxRate);
+  },
+
+  // Async resolver
+  'custom.enrichProduct': async (sku, sourceData, config, helpers) => {
+    if (!helpers.fluentClient) {
+      return { sku };
+    }
+
+    try {
+      const result = await helpers.fluentClient.graphql({
+        query: `query { product(ref: "${sku}") { id name } }`
+      });
+      return result.data.product;
+    } catch (error) {
+      helpers.log.error('Product enrichment failed', error);
+      return { sku };
+    }
+  }
+};
+
+// Use with mapper
+const mapper = new UniversalMapper(
+  {
+    fields: {
+      sku: { source: 'product_id', resolver: 'custom.formatSKU' },
+      total: { source: 'base_price', resolver: 'custom.calculateTotal' },
+      product: { source: 'sku', resolver: 'custom.enrichProduct' }
+    }
+  },
+  {
+    customResolvers,
+    context: { skuPrefix: 'PROD', taxRate: 0.1 },
+    fluentClient: myFluentClient,
+    logger: myLogger
+  }
+);
+
+// Transform data
+const result = await mapper.map({
+  product_id: 'widget-001',
+  base_price: '19.99',
+  quantity: 5
+});
+
+console.log(result.data);
+// {
+//   sku: 'PROD-WIDGET-001',
+//   total: 109.945,  // 19.99 * 5 * 1.1
+//   product: { id: '123', name: 'Widget' }
+// }
+```
+
+## ✅ Key Takeaways
+
+1. **Standard Signature** - Always `(value, sourceData, config, helpers) => any`
+2. **Universal Application** - Works in UniversalMapper AND GraphQLMutationMapper
+3. **Always 4 Parameters** - Even if you don't use all of them, include all 4
+4. **Config = Context** - Pass via mapper options `context`, receive as 3rd param
+5. **Helpers = Power** - 54 SDK utility functions + fluentClient + logger
+6. **Consistency = Predictability** - Same pattern everywhere makes SDK easier to use
+
+## 🎯 Next Steps
+
+1. **Start Learning** → Begin with [Module 1: Foundations](./modules/resolver-signature-01-foundations.md)
+2. **Try Examples** → Copy code from [Examples Directory](./examples/)
+3. **Build Your Own** → Create custom resolvers for your use case
+4. **Test Thoroughly** → Use patterns from [Module 7: API Reference](./modules/resolver-signature-07-api-reference.md)
+5. **Deploy Confidently** → Follow best practices from [Module 6: Migration Guide](./modules/resolver-signature-06-migration-guide.md)
+
+---
+
+**Ready to master resolver signatures?** Start with [Module 1: Foundations](./modules/resolver-signature-01-foundations.md) and progress through the learning path.