@fluentcommerce/fc-connect-sdk 0.1.54 → 0.1.55

package/docs/02-CORE-GUIDES/mapping/graphql-mutation-mapping/modules/graphql-mutation-mapping-02-quick-start.md

@@ -1,351 +1,351 @@
-# Quick Start
-
-[← Back to GraphQL Mutation Mapping Guide](../graphql-mutation-mapping-readme.md)
-
-**Module 2 of 13** | **Level**: Beginner | **Time**: 10 minutes
-
----
-
-## Quick Start
-
-### 1. Install SDK
-
-```bash
-npm install @fluentcommerce/fc-connect-sdk
-```
-
-### 2. Create Mapping Configuration
-
-**Example: SFCC Order Ingestion** (from SFCC e-commerce platform → Fluent Commerce Order Management)
-
-✅ **Validated against schema:** [`docs/schema/fluent-commerce-schema.json`](../../../../04-REFERENCE/schema/fluent-commerce-schema.json) → `Mutation.createOrder`
-
-**Business Context:** Importing orders from SFCC storefront into Fluent Commerce for order fulfillment workflows.
-
-#### Source XML Data
-
-This is the typical SFCC order XML structure you'll receive:
-
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<orders>
-  <order order-no="ORD-2025-001">
-    <order-date>2025-01-14T10:30:00Z</order-date>
-    <total currency="USD">151.17</total>
-    <customer customer-no="CUST-12345" customer-email="john.doe@example.com">
-      <customer-name>John Doe</customer-name>
-    </customer>
-    <items>
-      <item id="ITEM-001" sku="SKU-WM-001" qty="2" unitPrice="29.99">
-        <product-name>Wireless Mouse</product-name>
-      </item>
-      <item id="ITEM-002" sku="SKU-KB-001" qty="1" unitPrice="79.99">
-        <product-name>Mechanical Keyboard</product-name>
-      </item>
-    </items>
-  </order>
-</orders>
-```
-
-**Key XML Features:**
-
-- `order-no` is an **attribute** on `<order>` element → referenced as `order@order-no`
-- `customer-no` and `customer-email` are **attributes** on `<customer>` → `order.customer@customer-no`
-- `id`, `sku`, `qty`, `unitPrice` are **attributes** on `<item>` → `$.@id`, `$.@sku`, etc.
-- `total` is an **element** with text content and a `currency` **attribute** → `order.total` and `order.total@currency`
-
-#### Visual Path Reference
-
-Here's how XML structure maps to path syntax:
-
-```
-XML Structure                           Mapping Path Syntax
-═══════════════════════════════════════════════════════════════════════
-
-<order order-no="ORD-123">             order@order-no
-       ↑                                      ↑
-       XML attribute                          @ indicates attribute
-
-  <order-date>2025-01-14</order-date>   order.order-date
-   ↑                                          ↑
-   XML element                                . indicates nested element
-
-  <customer customer-no="CUST-123"      order.customer@customer-no
-            customer-email="...">               ↑          ↑
-            ↑                              path to element  @ for attribute
-            Attributes on nested element
-
-  <total currency="USD">151.17</total>
-         ↑              ↑
-         order.total@currency (attribute)
-                        order.total (element text)
-
-  <items>
-    <item id="ITEM-1" sku="SKU-001">    order.items.item  (array source)
-          ↑           ↑                       ↓
-          $.@id       $.@sku             $ = current array item
-          ↑                                   ↑
-          @ for attribute in array item      relative path
-    </item>
-  </items>
-</order>
-
-Key Syntax Rules:
-  element           → element name
-  element@attr      → @ for XML attributes (NO dot before @)
-  parent.child      → . for nested elements
-  $.@attr           → $ for current item in arrays
-```
-
-#### Mapping Configuration
-
-Now let's map this XML to Fluent Commerce's `createOrder` mutation:
-
-```json
-{
-  "version": "1.0",
-  "mutation": "createOrder",
-  "operationName": "CreateOrderFromSFCC",
-  "sourceFormat": "xml",
-  "returnFields": ["id", "ref", "status", "totalPrice"],
-  "comment": "✅ SFCC Order → Fluent Commerce Order Management - Real-world production integration",
-
-  "arguments": {
-    "input": {
-      "_type": "CreateOrderInput!",
-
-      "ref": {
-        "source": "order@order-no",
-        "required": true,
-        "comment": "✅ Maps to CreateOrderInput.ref (String! required) - Business reference (order number)"
-      },
-
-      "type": {
-        "value": "STANDARD",
-        "required": true,
-        "comment": "✅ Maps to CreateOrderInput.type (OrderType! enum required) - Order type (STANDARD | HD | CC | SALES)"
-      },
-
-      "retailer": {
-        "fields": {
-          "id": {
-            "value": "${FLUENT_RETAILER_ID}",
-            "required": true,
-            "comment": "✅ Maps to CreateOrderInput.retailer.id (ID! required)"
-          }
-        }
-      },
-
-      "customer": {
-        "fields": {
-          "ref": {
-            "source": "order.customer@customer-no",
-            "required": true,
-            "comment": "✅ Maps to CreateOrderInput.customer.ref (String! required) - Customer business reference"
-          },
-          "email": {
-            "source": "order.customer@customer-email",
-            "resolver": "sdk.lowercase",
-            "comment": "✅ Maps to CreateOrderInput.customer.email (String optional)"
-          }
-        }
-      },
-
-      "totalPrice": {
-        "source": "order.total",
-        "resolver": "sdk.parseFloat",
-        "required": true,
-        "comment": "✅ Maps to CreateOrderInput.totalPrice (Float! required)"
-      },
-
-      "currency": {
-        "source": "order.total@currency",
-        "defaultValue": "USD",
-        "required": true,
-        "comment": "✅ Maps to CreateOrderInput.currency (String! required)"
-      },
-
-      "items": {
-        "_array": true,
-        "_type": "[OrderItemInput]!",
-        "source": "order.items.item",
-        "comment": "✅ Maps to CreateOrderInput.items ([OrderItemInput]! required)",
-
-        "ref": {
-          "source": "$.@id",
-          "required": true,
-          "comment": "✅ Maps to OrderItemInput.ref (String! required) - Line item business reference"
-        },
-        "productRef": {
-          "source": "$.@sku",
-          "required": true,
-          "comment": "✅ Maps to OrderItemInput.productRef (String! required) - Product SKU reference"
-        },
-        "quantity": {
-          "source": "$.@qty",
-          "resolver": "sdk.parseInt",
-          "required": true,
-          "comment": "✅ Maps to OrderItemInput.quantity (Int! required)"
-        },
-        "price": {
-          "source": "$.@unitPrice",
-          "resolver": "sdk.parseFloat",
-          "required": true,
-          "comment": "✅ Maps to OrderItemInput.price (Float! required) - Unit price"
-        },
-        "totalPrice": {
-          "resolver": "custom.calculateItemTotal",
-          "required": true,
-          "comment": "✅ Maps to OrderItemInput.totalPrice (Float! required)"
-        },
-        "currency": {
-          "source": "order.total@currency",
-          "required": true,
-          "comment": "✅ Maps to OrderItemInput.currency (String! required)"
-        }
-      }
-    }
-  }
-}
-```
-
-**Source Data:** See [`docs/03-PATTERN-GUIDES/examples/test-data/canonical-order.json`](../../../../03-PATTERN-GUIDES/examples/test-data/canonical-order.json) for complete SFCC order structure.
-
-**Real-World Production Example:** `connectors/versori-sfcc-connector/mappings/sfcc-to-fluent-order-mapping.json` (at repository root, outside docs folder)
-
-**This same structure works for:**
-
-- `updateInventory` mutations with inventory XML/JSON
-- `createCustomer` mutations with customer data
-- `updateProduct` mutations with product feeds
-- **ANY GraphQL mutation** with **ANY source data**
-
-### 3. CLI: Generate Mapping Stubs and Validate
-
-You can generate starter mappings and validate them against your schema using the CLI:
-
-```bash
-# Introspect your schema → outputs schema.json
-npx fc-connect introspect-schema \
-  --endpoint https://YOUR_ACCOUNT.api.fluentcommerce.com/graphql \
-  --output schema.json
-
-# Generate a mapping stub from a GraphQL mutation file
-npx fc-connect generate-mutation-mapping \
-  --file mutation.graphql \
-  --output mapping.json
-
-# Generate a mapping stub from a GraphQL query file
-npx fc-connect generate-query-mapping \
-  --file query.graphql \
-  --output mapping.json
-
-# Validate your mapping against the schema
-npx fc-connect validate-schema \
-  --mapping mapping.json \
-  --schema schema.json
-
-# Analyze coverage (which arguments/fields your mapping populates)
-npx fc-connect analyze-coverage \
-  --mapping mapping.json \
-  --schema schema.json
-```
-
-### 3. Use in Code
-
-```typescript
-import { GraphQLMutationMapper, createClient } from '@fluentcommerce/fc-connect-sdk';
-import mappingConfig from './mappings/sfcc-order-to-fluent.json';
-
-// Create Fluent client (REQUIRED for execution)
-const fluentClient = createClient({ baseUrl, clientId, clientSecret, logger });
-
-// Initialize mapper (client parameter is optional but REQUIRED for execution)
-const mapper = new GraphQLMutationMapper(mappingConfig, logger, { fluentClient: fluentClient });
-
-// Step 1: Generate GraphQL mutation payload (mapper does NOT execute)
-const payload = await mapper.map(xmlData);
-// Returns: { query: string, variables: Record<string, any> }
-
-// Step 2: Execute mutation (YOU must call client.graphql to execute)
-const result = await fluentClient.graphql(payload);
-// Returns: GraphQL response with data or errors
-
-// Step 3: Access returned fields (specified in returnFields config)
-const createdOrder = result.data.createOrder;
-logger.info('Order created', {
-  orderId: createdOrder.id,        // From returnFields: ["id", "ref", "status", "totalPrice"]
-  orderRef: createdOrder.ref,      // From returnFields
-  status: createdOrder.status,     // From returnFields
-  totalPrice: createdOrder.totalPrice // From returnFields
-});
-```
-
-**With Custom Resolvers (Constructor Pattern - Recommended):**
-
-```typescript
-import { GraphQLMutationMapper, createClient } from '@fluentcommerce/fc-connect-sdk';
-import mappingConfig from './mappings/sfcc-order-to-fluent.json';
-
-const fluentClient = createClient({ baseUrl, clientId, clientSecret, logger });
-
-// Define custom resolvers
-const customResolvers = {
-  'custom.customerLookup': async (value, sourceData, config, helpers) => {
-    // Lookup customer by email
-    const customer = await fluentClient.graphql({
-      query: GET_CUSTOMER_BY_EMAIL,
-      variables: { email: value }
-    });
-    return customer?.data?.customer?.id || null;
-  }
-};
-
-// Initialize mapper with resolvers in constructor (consistent with UniversalMapper)
-const mapper = new GraphQLMutationMapper(
-  mappingConfig, 
-  logger,
-  { 
-    customResolvers, // ✅ Resolvers in constructor (recommended)
-    fluentClient: fluentClient 
-  }
-);
-
-// Use mapWithNodes when custom resolvers are needed
-const result = await mapper.mapWithNodes(xmlData);
-// Resolvers from constructor are automatically used
-
-// Check success (errors are returned, not thrown)
-if (!result.success) {
-  console.error('Mapping failed:', result.errors);
-  return;
-}
-
-// Execute mutation (query is auto-generated in result)
-const mutationResult = 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
-```
-
-**Usage:** Custom resolvers should be passed in the constructor (consistent with `UniversalMapper`). Method call resolvers can override constructor resolvers for per-call customization.
-```
-
-**Important:** `GraphQLMutationMapper` generates GraphQL payloads but does **NOT** execute them. You must:
-1. Pass `fluentClient` to mapper constructor (or provide via context in `mapWithNodes`)
-2. Call `fluentClient.graphql(payload)` to execute the mutation
-
----
-
-## Navigation
-
-[← Back to Guide](../graphql-mutation-mapping-readme.md) | [Next: Schema Validation →](./graphql-mutation-mapping-03-schema-validation.md)
-
-## Related Documentation
-
-- [Module 01: Introduction](../../../ingestion/modules/02-core-guides-ingestion-01-introduction.md) - System overview and key features
-- [Module 03: Schema Validation](./graphql-mutation-mapping-03-schema-validation.md) - Validate mapping configurations
-- [Module 05: Configuration Reference](./graphql-mutation-mapping-05-configuration-reference.md) - Complete mapping configuration reference
+# Quick Start
+
+[← Back to GraphQL Mutation Mapping Guide](../graphql-mutation-mapping-readme.md)
+
+**Module 2 of 13** | **Level**: Beginner | **Time**: 10 minutes
+
+---
+
+## Quick Start
+
+### 1. Install SDK
+
+```bash
+npm install @fluentcommerce/fc-connect-sdk
+```
+
+### 2. Create Mapping Configuration
+
+**Example: SFCC Order Ingestion** (from SFCC e-commerce platform → Fluent Commerce Order Management)
+
+✅ **Validated against schema:** [`docs/schema/fluent-commerce-schema.json`](../../../../04-REFERENCE/schema/fluent-commerce-schema.json) → `Mutation.createOrder`
+
+**Business Context:** Importing orders from SFCC storefront into Fluent Commerce for order fulfillment workflows.
+
+#### Source XML Data
+
+This is the typical SFCC order XML structure you'll receive:
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<orders>
+  <order order-no="ORD-2025-001">
+    <order-date>2025-01-14T10:30:00Z</order-date>
+    <total currency="USD">151.17</total>
+    <customer customer-no="CUST-12345" customer-email="john.doe@example.com">
+      <customer-name>John Doe</customer-name>
+    </customer>
+    <items>
+      <item id="ITEM-001" sku="SKU-WM-001" qty="2" unitPrice="29.99">
+        <product-name>Wireless Mouse</product-name>
+      </item>
+      <item id="ITEM-002" sku="SKU-KB-001" qty="1" unitPrice="79.99">
+        <product-name>Mechanical Keyboard</product-name>
+      </item>
+    </items>
+  </order>
+</orders>
+```
+
+**Key XML Features:**
+
+- `order-no` is an **attribute** on `<order>` element → referenced as `order@order-no`
+- `customer-no` and `customer-email` are **attributes** on `<customer>` → `order.customer@customer-no`
+- `id`, `sku`, `qty`, `unitPrice` are **attributes** on `<item>` → `$.@id`, `$.@sku`, etc.
+- `total` is an **element** with text content and a `currency` **attribute** → `order.total` and `order.total@currency`
+
+#### Visual Path Reference
+
+Here's how XML structure maps to path syntax:
+
+```
+XML Structure                           Mapping Path Syntax
+═══════════════════════════════════════════════════════════════════════
+
+<order order-no="ORD-123">             order@order-no
+       ↑                                      ↑
+       XML attribute                          @ indicates attribute
+
+  <order-date>2025-01-14</order-date>   order.order-date
+   ↑                                          ↑
+   XML element                                . indicates nested element
+
+  <customer customer-no="CUST-123"      order.customer@customer-no
+            customer-email="...">               ↑          ↑
+            ↑                              path to element  @ for attribute
+            Attributes on nested element
+
+  <total currency="USD">151.17</total>
+         ↑              ↑
+         order.total@currency (attribute)
+                        order.total (element text)
+
+  <items>
+    <item id="ITEM-1" sku="SKU-001">    order.items.item  (array source)
+          ↑           ↑                       ↓
+          $.@id       $.@sku             $ = current array item
+          ↑                                   ↑
+          @ for attribute in array item      relative path
+    </item>
+  </items>
+</order>
+
+Key Syntax Rules:
+  element           → element name
+  element@attr      → @ for XML attributes (NO dot before @)
+  parent.child      → . for nested elements
+  $.@attr           → $ for current item in arrays
+```
+
+#### Mapping Configuration
+
+Now let's map this XML to Fluent Commerce's `createOrder` mutation:
+
+```json
+{
+  "version": "1.0",
+  "mutation": "createOrder",
+  "operationName": "CreateOrderFromSFCC",
+  "sourceFormat": "xml",
+  "returnFields": ["id", "ref", "status", "totalPrice"],
+  "comment": "✅ SFCC Order → Fluent Commerce Order Management - Real-world production integration",
+
+  "arguments": {
+    "input": {
+      "_type": "CreateOrderInput!",
+
+      "ref": {
+        "source": "order@order-no",
+        "required": true,
+        "comment": "✅ Maps to CreateOrderInput.ref (String! required) - Business reference (order number)"
+      },
+
+      "type": {
+        "value": "STANDARD",
+        "required": true,
+        "comment": "✅ Maps to CreateOrderInput.type (OrderType! enum required) - Order type (STANDARD | HD | CC | SALES)"
+      },
+
+      "retailer": {
+        "fields": {
+          "id": {
+            "value": "${FLUENT_RETAILER_ID}",
+            "required": true,
+            "comment": "✅ Maps to CreateOrderInput.retailer.id (ID! required)"
+          }
+        }
+      },
+
+      "customer": {
+        "fields": {
+          "ref": {
+            "source": "order.customer@customer-no",
+            "required": true,
+            "comment": "✅ Maps to CreateOrderInput.customer.ref (String! required) - Customer business reference"
+          },
+          "email": {
+            "source": "order.customer@customer-email",
+            "resolver": "sdk.lowercase",
+            "comment": "✅ Maps to CreateOrderInput.customer.email (String optional)"
+          }
+        }
+      },
+
+      "totalPrice": {
+        "source": "order.total",
+        "resolver": "sdk.parseFloat",
+        "required": true,
+        "comment": "✅ Maps to CreateOrderInput.totalPrice (Float! required)"
+      },
+
+      "currency": {
+        "source": "order.total@currency",
+        "defaultValue": "USD",
+        "required": true,
+        "comment": "✅ Maps to CreateOrderInput.currency (String! required)"
+      },
+
+      "items": {
+        "_array": true,
+        "_type": "[OrderItemInput]!",
+        "source": "order.items.item",
+        "comment": "✅ Maps to CreateOrderInput.items ([OrderItemInput]! required)",
+
+        "ref": {
+          "source": "$.@id",
+          "required": true,
+          "comment": "✅ Maps to OrderItemInput.ref (String! required) - Line item business reference"
+        },
+        "productRef": {
+          "source": "$.@sku",
+          "required": true,
+          "comment": "✅ Maps to OrderItemInput.productRef (String! required) - Product SKU reference"
+        },
+        "quantity": {
+          "source": "$.@qty",
+          "resolver": "sdk.parseInt",
+          "required": true,
+          "comment": "✅ Maps to OrderItemInput.quantity (Int! required)"
+        },
+        "price": {
+          "source": "$.@unitPrice",
+          "resolver": "sdk.parseFloat",
+          "required": true,
+          "comment": "✅ Maps to OrderItemInput.price (Float! required) - Unit price"
+        },
+        "totalPrice": {
+          "resolver": "custom.calculateItemTotal",
+          "required": true,
+          "comment": "✅ Maps to OrderItemInput.totalPrice (Float! required)"
+        },
+        "currency": {
+          "source": "order.total@currency",
+          "required": true,
+          "comment": "✅ Maps to OrderItemInput.currency (String! required)"
+        }
+      }
+    }
+  }
+}
+```
+
+**Source Data:** See [`docs/03-PATTERN-GUIDES/examples/test-data/canonical-order.json`](../../../../03-PATTERN-GUIDES/examples/test-data/canonical-order.json) for complete SFCC order structure.
+
+**Real-World Production Example:** `connectors/versori-sfcc-connector/mappings/sfcc-to-fluent-order-mapping.json` (at repository root, outside docs folder)
+
+**This same structure works for:**
+
+- `updateInventory` mutations with inventory XML/JSON
+- `createCustomer` mutations with customer data
+- `updateProduct` mutations with product feeds
+- **ANY GraphQL mutation** with **ANY source data**
+
+### 3. CLI: Generate Mapping Stubs and Validate
+
+You can generate starter mappings and validate them against your schema using the CLI:
+
+```bash
+# Introspect your schema → outputs schema.json
+npx fc-connect introspect-schema \
+  --endpoint https://YOUR_ACCOUNT.api.fluentcommerce.com/graphql \
+  --output schema.json
+
+# Generate a mapping stub from a GraphQL mutation file
+npx fc-connect generate-mutation-mapping \
+  --file mutation.graphql \
+  --output mapping.json
+
+# Generate a mapping stub from a GraphQL query file
+npx fc-connect generate-query-mapping \
+  --file query.graphql \
+  --output mapping.json
+
+# Validate your mapping against the schema
+npx fc-connect validate-schema \
+  --mapping mapping.json \
+  --schema schema.json
+
+# Analyze coverage (which arguments/fields your mapping populates)
+npx fc-connect analyze-coverage \
+  --mapping mapping.json \
+  --schema schema.json
+```
+
+### 3. Use in Code
+
+```typescript
+import { GraphQLMutationMapper, createClient } from '@fluentcommerce/fc-connect-sdk';
+import mappingConfig from './mappings/sfcc-order-to-fluent.json';
+
+// Create Fluent client (REQUIRED for execution)
+const fluentClient = createClient({ baseUrl, clientId, clientSecret, logger });
+
+// Initialize mapper (client parameter is optional but REQUIRED for execution)
+const mapper = new GraphQLMutationMapper(mappingConfig, logger, { fluentClient: fluentClient });
+
+// Step 1: Generate GraphQL mutation payload (mapper does NOT execute)
+const payload = await mapper.map(xmlData);
+// Returns: { query: string, variables: Record<string, any> }
+
+// Step 2: Execute mutation (YOU must call client.graphql to execute)
+const result = await fluentClient.graphql(payload);
+// Returns: GraphQL response with data or errors
+
+// Step 3: Access returned fields (specified in returnFields config)
+const createdOrder = result.data.createOrder;
+logger.info('Order created', {
+  orderId: createdOrder.id,        // From returnFields: ["id", "ref", "status", "totalPrice"]
+  orderRef: createdOrder.ref,      // From returnFields
+  status: createdOrder.status,     // From returnFields
+  totalPrice: createdOrder.totalPrice // From returnFields
+});
+```
+
+**With Custom Resolvers (Constructor Pattern - Recommended):**
+
+```typescript
+import { GraphQLMutationMapper, createClient } from '@fluentcommerce/fc-connect-sdk';
+import mappingConfig from './mappings/sfcc-order-to-fluent.json';
+
+const fluentClient = createClient({ baseUrl, clientId, clientSecret, logger });
+
+// Define custom resolvers
+const customResolvers = {
+  'custom.customerLookup': async (value, sourceData, config, helpers) => {
+    // Lookup customer by email
+    const customer = await fluentClient.graphql({
+      query: GET_CUSTOMER_BY_EMAIL,
+      variables: { email: value }
+    });
+    return customer?.data?.customer?.id || null;
+  }
+};
+
+// Initialize mapper with resolvers in constructor (consistent with UniversalMapper)
+const mapper = new GraphQLMutationMapper(
+  mappingConfig, 
+  logger,
+  { 
+    customResolvers, // ✅ Resolvers in constructor (recommended)
+    fluentClient: fluentClient 
+  }
+);
+
+// Use mapWithNodes when custom resolvers are needed
+const result = await mapper.mapWithNodes(xmlData);
+// Resolvers from constructor are automatically used
+
+// Check success (errors are returned, not thrown)
+if (!result.success) {
+  console.error('Mapping failed:', result.errors);
+  return;
+}
+
+// Execute mutation (query is auto-generated in result)
+const mutationResult = 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
+```
+
+**Usage:** Custom resolvers should be passed in the constructor (consistent with `UniversalMapper`). Method call resolvers can override constructor resolvers for per-call customization.
+```
+
+**Important:** `GraphQLMutationMapper` generates GraphQL payloads but does **NOT** execute them. You must:
+1. Pass `fluentClient` to mapper constructor (or provide via context in `mapWithNodes`)
+2. Call `fluentClient.graphql(payload)` to execute the mutation
+
+---
+
+## Navigation
+
+[← Back to Guide](../graphql-mutation-mapping-readme.md) | [Next: Schema Validation →](./graphql-mutation-mapping-03-schema-validation.md)
+
+## Related Documentation
+
+- [Module 01: Introduction](../../../ingestion/modules/02-core-guides-ingestion-01-introduction.md) - System overview and key features
+- [Module 03: Schema Validation](./graphql-mutation-mapping-03-schema-validation.md) - Validate mapping configurations
+- [Module 05: Configuration Reference](./graphql-mutation-mapping-05-configuration-reference.md) - Complete mapping configuration reference