@fluentcommerce/fc-connect-sdk 0.1.53 → 0.1.55

package/docs/02-CORE-GUIDES/mapping/graphql-mutation-mapping/modules/graphql-mutation-mapping-12-arguments-vs-nodes.md

@@ -1,383 +1,383 @@
-# Arguments vs Nodes
-
-[← Back to GraphQL Mutation Mapping Guide](../graphql-mutation-mapping-readme.md)
-
-**Module 12 of 13** | **Level**: Advanced | **Time**: 15 minutes
-
----
-
-## Two Mapping Patterns: Simple vs Advanced
-
-The mapper supports two configuration patterns depending on your use case:
-
-- **Pattern 1 - Simple (arguments-based)**: Direct field mapping from source to GraphQL
-- **Pattern 2 - Advanced (nodes + fields)**: Extract embedded/nested data first, then map fields
-
-**Both patterns are fully supported and current.** Choose based on your data structure and requirements.
-
-## Pattern Comparison
-
-| Feature              | Pattern 1: Simple (Arguments) | Pattern 2: Advanced (Nodes + Fields) |
-| -------------------- | ----------------------------- | ------------------------------------ |
-| **Best For**         | Straightforward JSON→GraphQL  | Complex XML with embedded data       |
-| **Config Root**      | `config.arguments`            | `config.nodes` + `config.fields`     |
-| **Type Annotations** | `_type` metadata              | Inferred from schema                 |
-| **Embedded Data**    | Limited (direct paths only)   | Full support with extraction         |
-| **Method**           | `mapper.map()`                | `mapper.mapWithNodes()`              |
-| **Use Case**         | Simple, flat structures       | Nested, encoded, multi-source data   |
-
-## Pattern 2 Example: Advanced (nodes + fields)
-
-✅ **Validated against schema:** [`docs/schema/fluent-commerce-schema.json`](../../../../04-REFERENCE/schema/fluent-commerce-schema.json) → `Mutation.createOrder`
-
-**Business Context:** Shopify webhook integration - Orders from Shopify store to Fluent Commerce fulfillment.
-
-```json
-{
-  "mutation": "createOrder",
-  "sourceFormat": "xml",
-  "comment": "✅ Shopify Order Webhook → Fluent Commerce Order Management",
-  "nodes": {
-    "orderXml": {
-      "extract": "orders.order",
-      "required": true,
-      "unescape": true,
-      "comment": "Extract order XML from webhook payload"
-    }
-  },
-  "fields": {
-    "ref": {
-      "source": "$orderXml@order-no",
-      "required": true,
-      "comment": "✅ Maps to CreateOrderInput.ref (String! required) - Shopify order number"
-    },
-    "type": {
-      "value": "STANDARD",
-      "required": true,
-      "comment": "✅ Maps to CreateOrderInput.type (OrderType! required)"
-    },
-    "retailer": {
-      "fields": {
-        "id": {
-          "value": "1",
-          "comment": "✅ Maps to CreateOrderInput.retailer.id (ID! required)"
-        }
-      }
-    },
-    "customer": {
-      "fields": {
-        "ref": {
-          "source": "$orderXml.customer.customer-no",
-          "required": true,
-          "comment": "✅ Maps to CreateOrderInput.customer.ref (String! required) - Shopify customer ID"
-        },
-        "email": {
-          "source": "$orderXml.customer.email",
-          "resolver": "sdk.lowercase",
-          "comment": "✅ Maps to CreateOrderInput.customer.email (String optional)"
-        }
-      }
-    },
-    "items": {
-      "_array": true,
-      "source": "$orderXml.product-lineitems.product-lineitem",
-      "comment": "✅ Maps to CreateOrderInput.items ([OrderItemInput]! required)",
-      "fields": {
-        "ref": {
-          "source": "product-id",
-          "required": true,
-          "comment": "✅ Maps to OrderItemInput.ref (String! required) - Shopify line item ID"
-        },
-        "productRef": {
-          "source": "product-id",
-          "required": true,
-          "comment": "✅ Maps to OrderItemInput.productRef (String! required) - Product SKU"
-        },
-        "quantity": {
-          "source": "quantity",
-          "resolver": "sdk.parseInt",
-          "required": true,
-          "comment": "✅ Maps to OrderItemInput.quantity (Int! required)"
-        }
-      }
-    }
-  }
-}
-```
-
-### Using mapWithNodes()
-
-```typescript
-import { GraphQLMutationMapper } from '@fluentcommerce/fc-connect-sdk';
-
-const mapper = new GraphQLMutationMapper(mappingConfig, logger, { fluentClient: fluentClient });
-const result = await mapper.mapWithNodes(xmlData, customResolvers, { fluentClient });
-
-if (!result.success) {
-  throw new Error('Mapping failed: ' + result.errors?.join(', '));
-}
-
-// Execute mutation (query is auto-generated in result)
-const response = await fluentClient.graphql({
-  query: result.query,
-  variables: result.variables,  // ✅ Use variables (wrapped if fields pattern)
-});
-
-// Access mapped fields directly (unwrapped)
-const orderRef = result.data.ref;  // ✅ Use data for direct field access
-```
-
-**Benefits of Nodes + Fields Pattern:**
-
-- ✅ **Embedded Data Extraction**: Extract and parse HTML-encoded XML/JSON
-- ✅ **Cleaner Config**: No `_type` annotations needed
-- ✅ **Node References**: `$nodeName.path` syntax for extracted data
-- ✅ **Better Validation**: Automatic type inference from schema
-- ✅ **More Flexible**: Supports complex data transformations
-
-## Pattern 1 Example: Simple (arguments)
-
-✅ **Validated against schema:** [`docs/schema/fluent-commerce-schema.json`](../../../../04-REFERENCE/schema/fluent-commerce-schema.json) → `Mutation.createOrder`
-
-**Business Context:** Magento order integration - Simple pattern for straightforward JSON mapping.
-
-```json
-{
-  "version": "1.0",
-  "mutation": "createOrder",
-  "operationName": "CreateOrderFromMagento",
-  "sourceFormat": "xml",
-  "returnFields": ["id", "ref", "status"],
-  "comment": "✅ Simple arguments pattern - Magento Order → Fluent Commerce",
-  "arguments": {
-    "input": {
-      "_type": "CreateOrderInput!",
-      "ref": {
-        "source": "order@order-no",
-        "required": true,
-        "comment": "✅ Maps to CreateOrderInput.ref (String! required) - Magento order number"
-      },
-      "type": {
-        "value": "STANDARD",
-        "required": true,
-        "comment": "✅ Maps to CreateOrderInput.type (OrderType! required)"
-      },
-      "retailer": {
-        "fields": {
-          "id": {
-            "value": "1",
-            "comment": "✅ Maps to CreateOrderInput.retailer.id (ID! required)"
-          }
-        }
-      },
-      "items": {
-        "_array": true,
-        "_type": "[OrderItemInput]!",
-        "source": "product-lineitems.product-lineitem",
-        "comment": "✅ Maps to CreateOrderInput.items ([OrderItemInput]! required)",
-        "ref": {
-          "source": "product-id",
-          "required": true,
-          "comment": "✅ Maps to OrderItemInput.ref (String! required) - Magento line item ID"
-        },
-        "productRef": {
-          "source": "product-id",
-          "required": true,
-          "comment": "✅ Maps to OrderItemInput.productRef (String! required)"
-        },
-        "quantity": {
-          "source": "quantity",
-          "resolver": "sdk.parseInt",
-          "required": true,
-          "comment": "✅ Maps to OrderItemInput.quantity (Int! required)"
-        }
-      }
-    }
-  }
-}
-```
-
-```typescript
-const mapper = new GraphQLMutationMapper(mappingConfig, logger, { fluentClient: fluentClient });
-const payload = await mapper.map(xmlData); // returns { query, variables }
-const result = await fluentClient.graphql(payload);
-```
-
-**Pattern 1 Characteristics:**
-
-- ✅ **Simple Mappings**: Works well for straightforward transformations
-- ✅ **Explicit Types**: `_type` annotations document GraphQL types
-- ✅ **Straightforward**: Minimal configuration for basic cases
-- ⚠️ **Limited Extraction**: No built-in support for embedded data
-- ⚠️ **Verbose**: Requires `_type` annotations
-
-## SDK Resolvers vs Custom Resolvers
-
-### SDK Resolvers (built-in)
-
-Available in **both patterns** via `resolver` property:
-
-**Built-in SDK resolvers:**
-
-- `sdk.parseInt` - Convert to integer (safe, returns 0 on invalid)
-- `sdk.parseFloat` - Convert to float (safe, returns 0 on invalid)
-- `sdk.number` - Parse as number (alias for parseFloat)
-- `sdk.uppercase` - Uppercase string
-- `sdk.lowercase` - Lowercase string
-- `sdk.trim` - Remove whitespace
-- `sdk.toString` - Convert to string
-- `sdk.boolean` - Convert to boolean
-- `sdk.formatDate` - Format to ISO8601
-- `sdk.formatDateShort` - Format to YYYY-MM-DD
-- `sdk.parseDate` - Parse date string
-- `sdk.parseJson` - Parse JSON string
-- `sdk.toJson` - Stringify to JSON
-- `sdk.identity` - Pass-through (no transformation)
-- `sdk.coalesce` - Return first non-null value
-
-**Arguments Pattern:**
-
-```json
-{
-  "quantity": {
-    "source": "qty",
-    "resolver": "sdk.parseInt"
-  }
-}
-```
-
-**Nodes + Fields Pattern:**
-
-```json
-{
-  "quantity": {
-    "source": "$orderXml.qty",
-    "resolver": "sdk.parseInt"
-  }
-}
-```
-
-### Resolvers (custom)
-
-Run during resolver pass in `mapWithNodes` after fields are built.
-
-**Custom resolvers** provide:
-
-- ✅ Complex logic on extracted values
-- ✅ Access to helper functions
-- ✅ Async operations
-- ✅ Full source data context
-
-```typescript
-const customResolvers = {
-  'custom.calculateTotal': (value, data, config, helpers) => {
-    const items = helpers.get(data, 'order.items');
-    return helpers.sum(items, 'price');
-  },
-};
-```
-
-**Use in config:**
-
-```json
-{
-  "totalPrice": {
-    "resolver": "custom.calculateTotal"
-  }
-}
-```
-
-## Source Format and Path Resolution
-
-The `sourceFormat` field determines which path resolver to use:
-
-### XML Source Format
-
-```json
-{
-  "sourceFormat": "xml"
-}
-```
-
-**Uses:** `XMLPathResolver`
-
-**Path Syntax:**
-
-- Elements: `order.customer.email`
-- Attributes: `order@order-no`
-- Arrays: `items.item[0].sku`
-- Wildcards: `items.item.*.sku`
-
-**Supports:**
-
-- Raw XML strings (auto-parses)
-- Pre-parsed objects (Versori format with `$` attributes)
-
-### JSON Source Format
-
-```json
-{
-  "sourceFormat": "json"
-}
-```
-
-**Uses:** `JSONPathResolver`
-
-**Path Syntax:**
-
-- Properties: `order.customer.email`
-- Arrays: `items[0].sku`
-- Wildcards: `items.*.sku`
-
-## Node References
-
-In the nodes + fields pattern, use `$nodeName.` to reference extracted nodes:
-
-```json
-{
-  "nodes": {
-    "metadata": {
-      "extract": "order.customData.metadata",
-      "parse": "xml"
-    }
-  },
-  "fields": {
-    "priority": {
-      "source": "$metadata.priority"
-    }
-  }
-}
-```
-
-**Without `$` prefix:** Path resolves from root data
-**With `$` prefix:** Path resolves from named node
-
-## When to Use Each Pattern
-
-### Use Nodes + Fields Pattern When:
-
-- ✅ Working with embedded/encoded data
-- ✅ Building new integrations
-- ✅ Complex data transformations needed
-- ✅ Multiple data sources in one mapping
-- ✅ Want cleaner, more maintainable configs
-
-### Use Pattern 1 (Arguments) When:
-
-- ✅ Working with simple, flat data structures
-- ✅ Direct JSON to GraphQL mapping
-- ✅ Explicit type documentation preferred
-- ✅ No embedded data extraction required
-
----
-
-## Navigation
-
-[← Previous: Error Handling](./graphql-mutation-mapping-11-error-handling.md) | [Back to Guide](../graphql-mutation-mapping-readme.md) | [Next: Best Practices →](./graphql-mutation-mapping-13-best-practices.md)
-
-## Related Documentation
-
-- [Module 09: Advanced Patterns](./graphql-mutation-mapping-09-advanced-patterns.md) - Embedded XML/JSON extraction
-- [Module 08: Custom Resolvers](./graphql-mutation-mapping-08-custom-resolvers.md) - Custom transformation functions
-- [Nodes Pattern Guide](./graphql-mutation-mapping-07-array-handling.md) - Complete nodes pattern documentation
-- [API Reference](../../../api-reference/api-reference-readme.md) - Complete API documentation
+# Arguments vs Nodes
+
+[← Back to GraphQL Mutation Mapping Guide](../graphql-mutation-mapping-readme.md)
+
+**Module 12 of 13** | **Level**: Advanced | **Time**: 15 minutes
+
+---
+
+## Two Mapping Patterns: Simple vs Advanced
+
+The mapper supports two configuration patterns depending on your use case:
+
+- **Pattern 1 - Simple (arguments-based)**: Direct field mapping from source to GraphQL
+- **Pattern 2 - Advanced (nodes + fields)**: Extract embedded/nested data first, then map fields
+
+**Both patterns are fully supported and current.** Choose based on your data structure and requirements.
+
+## Pattern Comparison
+
+| Feature              | Pattern 1: Simple (Arguments) | Pattern 2: Advanced (Nodes + Fields) |
+| -------------------- | ----------------------------- | ------------------------------------ |
+| **Best For**         | Straightforward JSON→GraphQL  | Complex XML with embedded data       |
+| **Config Root**      | `config.arguments`            | `config.nodes` + `config.fields`     |
+| **Type Annotations** | `_type` metadata              | Inferred from schema                 |
+| **Embedded Data**    | Limited (direct paths only)   | Full support with extraction         |
+| **Method**           | `mapper.map()`                | `mapper.mapWithNodes()`              |
+| **Use Case**         | Simple, flat structures       | Nested, encoded, multi-source data   |
+
+## Pattern 2 Example: Advanced (nodes + fields)
+
+✅ **Validated against schema:** [`docs/schema/fluent-commerce-schema.json`](../../../../04-REFERENCE/schema/fluent-commerce-schema.json) → `Mutation.createOrder`
+
+**Business Context:** Shopify webhook integration - Orders from Shopify store to Fluent Commerce fulfillment.
+
+```json
+{
+  "mutation": "createOrder",
+  "sourceFormat": "xml",
+  "comment": "✅ Shopify Order Webhook → Fluent Commerce Order Management",
+  "nodes": {
+    "orderXml": {
+      "extract": "orders.order",
+      "required": true,
+      "unescape": true,
+      "comment": "Extract order XML from webhook payload"
+    }
+  },
+  "fields": {
+    "ref": {
+      "source": "$orderXml@order-no",
+      "required": true,
+      "comment": "✅ Maps to CreateOrderInput.ref (String! required) - Shopify order number"
+    },
+    "type": {
+      "value": "STANDARD",
+      "required": true,
+      "comment": "✅ Maps to CreateOrderInput.type (OrderType! required)"
+    },
+    "retailer": {
+      "fields": {
+        "id": {
+          "value": "1",
+          "comment": "✅ Maps to CreateOrderInput.retailer.id (ID! required)"
+        }
+      }
+    },
+    "customer": {
+      "fields": {
+        "ref": {
+          "source": "$orderXml.customer.customer-no",
+          "required": true,
+          "comment": "✅ Maps to CreateOrderInput.customer.ref (String! required) - Shopify customer ID"
+        },
+        "email": {
+          "source": "$orderXml.customer.email",
+          "resolver": "sdk.lowercase",
+          "comment": "✅ Maps to CreateOrderInput.customer.email (String optional)"
+        }
+      }
+    },
+    "items": {
+      "_array": true,
+      "source": "$orderXml.product-lineitems.product-lineitem",
+      "comment": "✅ Maps to CreateOrderInput.items ([OrderItemInput]! required)",
+      "fields": {
+        "ref": {
+          "source": "product-id",
+          "required": true,
+          "comment": "✅ Maps to OrderItemInput.ref (String! required) - Shopify line item ID"
+        },
+        "productRef": {
+          "source": "product-id",
+          "required": true,
+          "comment": "✅ Maps to OrderItemInput.productRef (String! required) - Product SKU"
+        },
+        "quantity": {
+          "source": "quantity",
+          "resolver": "sdk.parseInt",
+          "required": true,
+          "comment": "✅ Maps to OrderItemInput.quantity (Int! required)"
+        }
+      }
+    }
+  }
+}
+```
+
+### Using mapWithNodes()
+
+```typescript
+import { GraphQLMutationMapper } from '@fluentcommerce/fc-connect-sdk';
+
+const mapper = new GraphQLMutationMapper(mappingConfig, logger, { fluentClient: fluentClient });
+const result = await mapper.mapWithNodes(xmlData, customResolvers, { fluentClient });
+
+if (!result.success) {
+  throw new Error('Mapping failed: ' + result.errors?.join(', '));
+}
+
+// Execute mutation (query is auto-generated in result)
+const response = await fluentClient.graphql({
+  query: result.query,
+  variables: result.variables,  // ✅ Use variables (wrapped if fields pattern)
+});
+
+// Access mapped fields directly (unwrapped)
+const orderRef = result.data.ref;  // ✅ Use data for direct field access
+```
+
+**Benefits of Nodes + Fields Pattern:**
+
+- ✅ **Embedded Data Extraction**: Extract and parse HTML-encoded XML/JSON
+- ✅ **Cleaner Config**: No `_type` annotations needed
+- ✅ **Node References**: `$nodeName.path` syntax for extracted data
+- ✅ **Better Validation**: Automatic type inference from schema
+- ✅ **More Flexible**: Supports complex data transformations
+
+## Pattern 1 Example: Simple (arguments)
+
+✅ **Validated against schema:** [`docs/schema/fluent-commerce-schema.json`](../../../../04-REFERENCE/schema/fluent-commerce-schema.json) → `Mutation.createOrder`
+
+**Business Context:** Magento order integration - Simple pattern for straightforward JSON mapping.
+
+```json
+{
+  "version": "1.0",
+  "mutation": "createOrder",
+  "operationName": "CreateOrderFromMagento",
+  "sourceFormat": "xml",
+  "returnFields": ["id", "ref", "status"],
+  "comment": "✅ Simple arguments pattern - Magento Order → Fluent Commerce",
+  "arguments": {
+    "input": {
+      "_type": "CreateOrderInput!",
+      "ref": {
+        "source": "order@order-no",
+        "required": true,
+        "comment": "✅ Maps to CreateOrderInput.ref (String! required) - Magento order number"
+      },
+      "type": {
+        "value": "STANDARD",
+        "required": true,
+        "comment": "✅ Maps to CreateOrderInput.type (OrderType! required)"
+      },
+      "retailer": {
+        "fields": {
+          "id": {
+            "value": "1",
+            "comment": "✅ Maps to CreateOrderInput.retailer.id (ID! required)"
+          }
+        }
+      },
+      "items": {
+        "_array": true,
+        "_type": "[OrderItemInput]!",
+        "source": "product-lineitems.product-lineitem",
+        "comment": "✅ Maps to CreateOrderInput.items ([OrderItemInput]! required)",
+        "ref": {
+          "source": "product-id",
+          "required": true,
+          "comment": "✅ Maps to OrderItemInput.ref (String! required) - Magento line item ID"
+        },
+        "productRef": {
+          "source": "product-id",
+          "required": true,
+          "comment": "✅ Maps to OrderItemInput.productRef (String! required)"
+        },
+        "quantity": {
+          "source": "quantity",
+          "resolver": "sdk.parseInt",
+          "required": true,
+          "comment": "✅ Maps to OrderItemInput.quantity (Int! required)"
+        }
+      }
+    }
+  }
+}
+```
+
+```typescript
+const mapper = new GraphQLMutationMapper(mappingConfig, logger, { fluentClient: fluentClient });
+const payload = await mapper.map(xmlData); // returns { query, variables }
+const result = await fluentClient.graphql(payload);
+```
+
+**Pattern 1 Characteristics:**
+
+- ✅ **Simple Mappings**: Works well for straightforward transformations
+- ✅ **Explicit Types**: `_type` annotations document GraphQL types
+- ✅ **Straightforward**: Minimal configuration for basic cases
+- ⚠️ **Limited Extraction**: No built-in support for embedded data
+- ⚠️ **Verbose**: Requires `_type` annotations
+
+## SDK Resolvers vs Custom Resolvers
+
+### SDK Resolvers (built-in)
+
+Available in **both patterns** via `resolver` property:
+
+**Built-in SDK resolvers:**
+
+- `sdk.parseInt` - Convert to integer (safe, returns 0 on invalid)
+- `sdk.parseFloat` - Convert to float (safe, returns 0 on invalid)
+- `sdk.number` - Parse as number (alias for parseFloat)
+- `sdk.uppercase` - Uppercase string
+- `sdk.lowercase` - Lowercase string
+- `sdk.trim` - Remove whitespace
+- `sdk.toString` - Convert to string
+- `sdk.boolean` - Convert to boolean
+- `sdk.formatDate` - Format to ISO8601
+- `sdk.formatDateShort` - Format to YYYY-MM-DD
+- `sdk.parseDate` - Parse date string
+- `sdk.parseJson` - Parse JSON string
+- `sdk.toJson` - Stringify to JSON
+- `sdk.identity` - Pass-through (no transformation)
+- `sdk.coalesce` - Return first non-null value
+
+**Arguments Pattern:**
+
+```json
+{
+  "quantity": {
+    "source": "qty",
+    "resolver": "sdk.parseInt"
+  }
+}
+```
+
+**Nodes + Fields Pattern:**
+
+```json
+{
+  "quantity": {
+    "source": "$orderXml.qty",
+    "resolver": "sdk.parseInt"
+  }
+}
+```
+
+### Resolvers (custom)
+
+Run during resolver pass in `mapWithNodes` after fields are built.
+
+**Custom resolvers** provide:
+
+- ✅ Complex logic on extracted values
+- ✅ Access to helper functions
+- ✅ Async operations
+- ✅ Full source data context
+
+```typescript
+const customResolvers = {
+  'custom.calculateTotal': (value, data, config, helpers) => {
+    const items = helpers.get(data, 'order.items');
+    return helpers.sum(items, 'price');
+  },
+};
+```
+
+**Use in config:**
+
+```json
+{
+  "totalPrice": {
+    "resolver": "custom.calculateTotal"
+  }
+}
+```
+
+## Source Format and Path Resolution
+
+The `sourceFormat` field determines which path resolver to use:
+
+### XML Source Format
+
+```json
+{
+  "sourceFormat": "xml"
+}
+```
+
+**Uses:** `XMLPathResolver`
+
+**Path Syntax:**
+
+- Elements: `order.customer.email`
+- Attributes: `order@order-no`
+- Arrays: `items.item[0].sku`
+- Wildcards: `items.item.*.sku`
+
+**Supports:**
+
+- Raw XML strings (auto-parses)
+- Pre-parsed objects (Versori format with `$` attributes)
+
+### JSON Source Format
+
+```json
+{
+  "sourceFormat": "json"
+}
+```
+
+**Uses:** `JSONPathResolver`
+
+**Path Syntax:**
+
+- Properties: `order.customer.email`
+- Arrays: `items[0].sku`
+- Wildcards: `items.*.sku`
+
+## Node References
+
+In the nodes + fields pattern, use `$nodeName.` to reference extracted nodes:
+
+```json
+{
+  "nodes": {
+    "metadata": {
+      "extract": "order.customData.metadata",
+      "parse": "xml"
+    }
+  },
+  "fields": {
+    "priority": {
+      "source": "$metadata.priority"
+    }
+  }
+}
+```
+
+**Without `$` prefix:** Path resolves from root data
+**With `$` prefix:** Path resolves from named node
+
+## When to Use Each Pattern
+
+### Use Nodes + Fields Pattern When:
+
+- ✅ Working with embedded/encoded data
+- ✅ Building new integrations
+- ✅ Complex data transformations needed
+- ✅ Multiple data sources in one mapping
+- ✅ Want cleaner, more maintainable configs
+
+### Use Pattern 1 (Arguments) When:
+
+- ✅ Working with simple, flat data structures
+- ✅ Direct JSON to GraphQL mapping
+- ✅ Explicit type documentation preferred
+- ✅ No embedded data extraction required
+
+---
+
+## Navigation
+
+[← Previous: Error Handling](./graphql-mutation-mapping-11-error-handling.md) | [Back to Guide](../graphql-mutation-mapping-readme.md) | [Next: Best Practices →](./graphql-mutation-mapping-13-best-practices.md)
+
+## Related Documentation
+
+- [Module 09: Advanced Patterns](./graphql-mutation-mapping-09-advanced-patterns.md) - Embedded XML/JSON extraction
+- [Module 08: Custom Resolvers](./graphql-mutation-mapping-08-custom-resolvers.md) - Custom transformation functions
+- [Nodes Pattern Guide](./graphql-mutation-mapping-07-array-handling.md) - Complete nodes pattern documentation
+- [API Reference](../../../api-reference/api-reference-readme.md) - Complete API documentation