@fluentcommerce/fc-connect-sdk 0.1.54 → 0.1.55

package/docs/02-CORE-GUIDES/mapping/graphql-mutation-mapping/graphql-mutation-mapping-readme.md

@@ -1,227 +1,227 @@
-# GraphQL Mutation Mapping Guide
-
-Transform **any** XML/JSON data into **any** GraphQL mutation inputs with full validation and type safety.
-
----
-
-## 🌟 What is GraphQL Mutation Mapping?
-
-The GraphQL Mutation Mapping system is a **universal**, **schema-driven**, **format-agnostic** transformation engine that:
-
-- ✅ Works with **ANY** GraphQL mutation (createOrder, updateInventory, createCustomer, etc.)
-- ✅ Supports **ANY** XML source (SFCC, Magento, SAP, custom XML feeds)
-- ✅ Supports **ANY** JSON source (Shopify, REST APIs, webhooks, database exports)
-- ✅ Validates against **ANY** GraphQL schema (not just Fluent Commerce)
-- ✅ Provides **type-safe** transformations with schema introspection
-- ✅ Handles **complex** nested structures, arrays, and custom business logic
-
----
-
-## 📚 Module Guide
-
-### Getting Started
-
-| Module                                                            | Description                                   | Level    | Time   |
-| ----------------------------------------------------------------- | --------------------------------------------- | -------- | ------ |
-| **[01. Introduction](../../ingestion/modules/02-core-guides-ingestion-01-introduction.md)**              | Universal system overview and key features    | Beginner | 10 min |
-| **[02. Quick Start](../../auto-pagination/modules/auto-pagination-02-quick-start.md)**                | Installation, basic example, and usage        | Beginner | 15 min |
-| **[03. Schema Validation](./modules/graphql-mutation-mapping-03-schema-validation.md)** ⚠️ | **CRITICAL** - Schema validation requirements | Beginner | 10 min |
-
-### Core Concepts
-
-| Module                                                                     | Description                                        | Level        | Time   |
-| -------------------------------------------------------------------------- | -------------------------------------------------- | ------------ | ------ |
-| **[04. Mapping Patterns](./modules/graphql-mutation-mapping-04-mapping-patterns.md)**               | System architecture and data flow                  | Intermediate | 15 min |
-| **[05. Configuration Reference](./modules/graphql-mutation-mapping-05-configuration-reference.md)** | Complete mapping configuration reference           | Intermediate | 20 min |
-| **[06. Path Syntax](./modules/graphql-mutation-mapping-06-path-syntax.md)**                         | XML/JSON path resolution and Versori compatibility | Intermediate | 25 min |
-
-### Advanced Features
-
-| Module                                                             | Description                                             | Level        | Time   |
-| ------------------------------------------------------------------ | ------------------------------------------------------- | ------------ | ------ |
-| **[07. Array Handling](./modules/graphql-mutation-mapping-07-array-handling.md)**           | Array mapping, validation, and auto-wrap                | Intermediate | 20 min |
-| **[08. Custom Resolvers](./modules/graphql-mutation-mapping-08-custom-resolvers.md)**       | Custom transformation functions and async operations    | Advanced     | 30 min |
-| **[09. Advanced Patterns](./modules/graphql-mutation-mapping-09-advanced-patterns.md)**     | Relative paths, reference resolution, embedded XML/JSON | Advanced     | 35 min |
-| **[10. Hooks and Variables](./modules/graphql-mutation-mapping-10-hooks-and-variables.md)** | Custom hooks, environment variables, operation names    | Intermediate | 15 min |
-
-### Production Patterns
-
-| Module                                                           | Description                                            | Level        | Time   |
-| ---------------------------------------------------------------- | ------------------------------------------------------ | ------------ | ------ |
-| **[11. Error Handling](./modules/graphql-mutation-mapping-11-error-handling.md)**         | Fail-fast behavior, error types, and recovery patterns | Intermediate | 25 min |
-| **[12. Arguments vs Nodes](./modules/graphql-mutation-mapping-12-arguments-vs-nodes.md)** | Simple vs advanced configuration patterns              | Intermediate | 15 min |
-| **[13. Best Practices](./modules/graphql-mutation-mapping-13-best-practices.md)**         | Best practices, troubleshooting, and complete examples | All Levels   | 20 min |
-
----
-
-## 🎯 Quick Navigation
-
-### I Want To...
-
-| **Goal**                  | **Start Here**                                         | **Then See**                                                       |
-| ------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------ |
-| **Get started quickly**   | [Quick Start](../../auto-pagination/modules/auto-pagination-02-quick-start.md)             | [Schema Validation](./modules/graphql-mutation-mapping-03-schema-validation.md)             |
-| **Understand the system** | [Introduction](../../ingestion/modules/02-core-guides-ingestion-01-introduction.md)           | [Mapping Patterns](./modules/graphql-mutation-mapping-04-mapping-patterns.md)               |
-| **Map XML to GraphQL**    | [Path Syntax](./modules/graphql-mutation-mapping-06-path-syntax.md)             | [Advanced Patterns](./modules/graphql-mutation-mapping-09-advanced-patterns.md)             |
-| **Map JSON to GraphQL**   | [Path Syntax](./modules/graphql-mutation-mapping-06-path-syntax.md)             | [Configuration Reference](./modules/graphql-mutation-mapping-05-configuration-reference.md) |
-| **Handle arrays**         | [Array Handling](./modules/graphql-mutation-mapping-07-array-handling.md)       | [Advanced Patterns](./modules/graphql-mutation-mapping-09-advanced-patterns.md)             |
-| **Add custom logic**      | [Custom Resolvers](./modules/graphql-mutation-mapping-08-custom-resolvers.md)   | [Hooks and Variables](./modules/graphql-mutation-mapping-10-hooks-and-variables.md)         |
-| **Handle errors**         | [Error Handling](./modules/graphql-mutation-mapping-11-error-handling.md)       | [Best Practices](./modules/graphql-mutation-mapping-13-best-practices.md)                   |
-| **Validate schema**       | [Schema Validation](./modules/graphql-mutation-mapping-03-schema-validation.md) | [Configuration Reference](./modules/graphql-mutation-mapping-05-configuration-reference.md) |
-| **See complete examples** | [Best Practices](./modules/graphql-mutation-mapping-13-best-practices.md)       | [Arguments vs Nodes](./modules/graphql-mutation-mapping-12-arguments-vs-nodes.md)           |
-
----
-
-## 🚀 Real-World Use Cases
-
-### E-Commerce Order Integration
-
-**SFCC → Fluent Commerce**
-
-- XML order data from Salesforce Commerce Cloud
-- Transform to Fluent Commerce createOrder mutation
-- See: [Quick Start](../../auto-pagination/modules/auto-pagination-02-quick-start.md), [Path Syntax](./modules/graphql-mutation-mapping-06-path-syntax.md)
-
-**Shopify → Fluent Commerce**
-
-- JSON webhook from Shopify storefront
-- Map to Fluent Commerce order management
-- See: [Arguments vs Nodes](./modules/graphql-mutation-mapping-12-arguments-vs-nodes.md)
-
-**Magento → Fluent Commerce**
-
-- XML export from Magento platform
-- Simple pattern example
-- See: [Arguments vs Nodes](./modules/graphql-mutation-mapping-12-arguments-vs-nodes.md)
-
-### Inventory Management
-
-**Product Catalog Sync**
-
-- XML/JSON product feeds
-- Map to updateInventory mutations
-- See: [Advanced Patterns](./modules/graphql-mutation-mapping-09-advanced-patterns.md)
-
-**Stock Updates**
-
-- CSV to JSON to GraphQL
-- Batch inventory position updates
-- See: [Custom Resolvers](./modules/graphql-mutation-mapping-08-custom-resolvers.md)
-
----
-
-## 📖 Documentation Structure
-
-```
-graphql-mutation-mapping/
-├── readme.md (this file)
-└── modules/
-    ├── 01-introduction.md          (Universal system overview)
-    ├── 02-quick-start.md            (Installation and basic usage)
-    ├── 03-schema-validation.md      (⚠️ CRITICAL - Schema requirements)
-    ├── 04-architecture.md           (System architecture)
-    ├── 05-configuration-reference.md (Complete config reference)
-    ├── 06-path-syntax.md            (XML/JSON path resolution)
-    ├── 07-array-handling.md         (Array mapping patterns)
-    ├── 08-custom-resolvers.md       (Custom transformation functions)
-    ├── 09-advanced-patterns.md      (Advanced mapping patterns)
-    ├── 10-hooks-and-variables.md    (Hooks and environment variables)
-    ├── 11-error-handling.md         (Error handling and recovery)
-    ├── 12-arguments-vs-nodes.md     (Configuration pattern comparison)
-    └── 13-best-practices.md         (Best practices and troubleshooting)
-```
-
----
-
-## 🔗 Related Documentation
-
-### Core SDK Documentation
-
-- **[Universal Mapping Guide](../../mapping/mapping-readme.md)** - Field mapping and transformation patterns
-- **[Resolver Guide](../resolvers/mapping-resolvers-resolver-guide.md)** - Custom resolver patterns and SDK resolvers
-- **[XML Parser Guide](../../parsers/modules/02-core-guides-parsers-04-xml-parser.md)** - XML parsing with streaming support
-- **[JSON Parser Guide](../../parsers/modules/02-core-guides-parsers-03-json-parser.md)** - JSON/JSONL parsing with validation
-
-### Integration Examples
-
-- **[SFCC Connector Examples](../../../01-TEMPLATES/versori/webhooks/)** - Production SFCC order integration
-- **[Versori Platform Guide](../../../04-REFERENCE/platforms/versori/)** - Versori platform integration
-- **[Webhook Validation](../../../04-REFERENCE/platforms/versori/platforms-versori-webhook-auth-quick-reference.md)** - Validate webhook signatures
-
-### API Reference
-
-- **[API Reference](../../api-reference/api-reference-readme.md)** - Complete API documentation
-- **[Schema File](../../../04-REFERENCE/schema/fluent-commerce-schema.json)** - Fluent Commerce GraphQL schema
-
----
-
-## ⚠️ Important Notes
-
-### Schema Validation is CRITICAL
-
-Before using any mapping examples, you **MUST** validate mutation field names against your GraphQL schema:
-
-```bash
-# Step 1: Introspect schema
-npx fc-connect introspect-schema \
-  --endpoint https://YOUR_ACCOUNT.api.fluentcommerce.com/graphql \
-  --output schema.json
-
-# Step 2: Validate mapping
-npx fc-connect validate-schema \
-  --mapping mappings/order-mapping.json \
-  --schema schema.json
-```
-
-**See:** [Schema Validation Module](./modules/graphql-mutation-mapping-03-schema-validation.md) for complete requirements.
-
-### Versori Platform Compatibility
-
-XMLPathResolver supports **both** raw XML strings **AND** pre-parsed objects (from Versori webhooks) with automatic detection. Same mapping config works in both environments.
-
-**See:** [Path Syntax Module](./modules/graphql-mutation-mapping-06-path-syntax.md#versori-platform-compatibility) for details.
-
-### Error Handling is Fail-Fast
-
-The mapper implements **fail-fast** error handling - if ANY error occurs during mapping or validation, the GraphQL mutation is **NEVER SENT**.
-
-**See:** [Error Handling Module](./modules/graphql-mutation-mapping-11-error-handling.md) for comprehensive patterns.
-
----
-
-## 🎓 Learning Path
-
-### For Beginners
-
-1. Start with [Introduction](../../ingestion/modules/02-core-guides-ingestion-01-introduction.md)
-2. Follow [Quick Start](../../auto-pagination/modules/auto-pagination-02-quick-start.md)
-3. Read [Schema Validation](./modules/graphql-mutation-mapping-03-schema-validation.md) ⚠️
-4. Try [Path Syntax](./modules/graphql-mutation-mapping-06-path-syntax.md)
-
-### For Intermediate Users
-
-1. Review [Mapping Patterns](./modules/graphql-mutation-mapping-04-mapping-patterns.md)
-2. Master [Configuration Reference](./modules/graphql-mutation-mapping-05-configuration-reference.md)
-3. Learn [Array Handling](./modules/graphql-mutation-mapping-07-array-handling.md)
-4. Explore [Hooks and Variables](./modules/graphql-mutation-mapping-10-hooks-and-variables.md)
-
-### For Advanced Users
-
-1. Study [Custom Resolvers](./modules/graphql-mutation-mapping-08-custom-resolvers.md)
-2. Master [Advanced Patterns](./modules/graphql-mutation-mapping-09-advanced-patterns.md)
-3. Implement [Error Handling](./modules/graphql-mutation-mapping-11-error-handling.md)
-4. Review [Best Practices](./modules/graphql-mutation-mapping-13-best-practices.md)
-
----
-
-## 📝 Contributing
-
-Found an issue or want to improve the GraphQL Mutation Mapping documentation?
-
-1. Check the [GitHub Repository](https://github.com/fluentcommerce/fc-connect-sdk)
-2. Submit issues or pull requests
-3. Follow the [Contributing Guidelines](../../../readme.md)
-
----
-
-**License**: MIT
+# GraphQL Mutation Mapping Guide
+
+Transform **any** XML/JSON data into **any** GraphQL mutation inputs with full validation and type safety.
+
+---
+
+## 🌟 What is GraphQL Mutation Mapping?
+
+The GraphQL Mutation Mapping system is a **universal**, **schema-driven**, **format-agnostic** transformation engine that:
+
+- ✅ Works with **ANY** GraphQL mutation (createOrder, updateInventory, createCustomer, etc.)
+- ✅ Supports **ANY** XML source (SFCC, Magento, SAP, custom XML feeds)
+- ✅ Supports **ANY** JSON source (Shopify, REST APIs, webhooks, database exports)
+- ✅ Validates against **ANY** GraphQL schema (not just Fluent Commerce)
+- ✅ Provides **type-safe** transformations with schema introspection
+- ✅ Handles **complex** nested structures, arrays, and custom business logic
+
+---
+
+## 📚 Module Guide
+
+### Getting Started
+
+| Module                                                            | Description                                   | Level    | Time   |
+| ----------------------------------------------------------------- | --------------------------------------------- | -------- | ------ |
+| **[01. Introduction](../../ingestion/modules/02-core-guides-ingestion-01-introduction.md)**              | Universal system overview and key features    | Beginner | 10 min |
+| **[02. Quick Start](../../auto-pagination/modules/auto-pagination-02-quick-start.md)**                | Installation, basic example, and usage        | Beginner | 15 min |
+| **[03. Schema Validation](./modules/graphql-mutation-mapping-03-schema-validation.md)** ⚠️ | **CRITICAL** - Schema validation requirements | Beginner | 10 min |
+
+### Core Concepts
+
+| Module                                                                     | Description                                        | Level        | Time   |
+| -------------------------------------------------------------------------- | -------------------------------------------------- | ------------ | ------ |
+| **[04. Mapping Patterns](./modules/graphql-mutation-mapping-04-mapping-patterns.md)**               | System architecture and data flow                  | Intermediate | 15 min |
+| **[05. Configuration Reference](./modules/graphql-mutation-mapping-05-configuration-reference.md)** | Complete mapping configuration reference           | Intermediate | 20 min |
+| **[06. Path Syntax](./modules/graphql-mutation-mapping-06-path-syntax.md)**                         | XML/JSON path resolution and Versori compatibility | Intermediate | 25 min |
+
+### Advanced Features
+
+| Module                                                             | Description                                             | Level        | Time   |
+| ------------------------------------------------------------------ | ------------------------------------------------------- | ------------ | ------ |
+| **[07. Array Handling](./modules/graphql-mutation-mapping-07-array-handling.md)**           | Array mapping, validation, and auto-wrap                | Intermediate | 20 min |
+| **[08. Custom Resolvers](./modules/graphql-mutation-mapping-08-custom-resolvers.md)**       | Custom transformation functions and async operations    | Advanced     | 30 min |
+| **[09. Advanced Patterns](./modules/graphql-mutation-mapping-09-advanced-patterns.md)**     | Relative paths, reference resolution, embedded XML/JSON | Advanced     | 35 min |
+| **[10. Hooks and Variables](./modules/graphql-mutation-mapping-10-hooks-and-variables.md)** | Custom hooks, environment variables, operation names    | Intermediate | 15 min |
+
+### Production Patterns
+
+| Module                                                           | Description                                            | Level        | Time   |
+| ---------------------------------------------------------------- | ------------------------------------------------------ | ------------ | ------ |
+| **[11. Error Handling](./modules/graphql-mutation-mapping-11-error-handling.md)**         | Fail-fast behavior, error types, and recovery patterns | Intermediate | 25 min |
+| **[12. Arguments vs Nodes](./modules/graphql-mutation-mapping-12-arguments-vs-nodes.md)** | Simple vs advanced configuration patterns              | Intermediate | 15 min |
+| **[13. Best Practices](./modules/graphql-mutation-mapping-13-best-practices.md)**         | Best practices, troubleshooting, and complete examples | All Levels   | 20 min |
+
+---
+
+## 🎯 Quick Navigation
+
+### I Want To...
+
+| **Goal**                  | **Start Here**                                         | **Then See**                                                       |
+| ------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------ |
+| **Get started quickly**   | [Quick Start](../../auto-pagination/modules/auto-pagination-02-quick-start.md)             | [Schema Validation](./modules/graphql-mutation-mapping-03-schema-validation.md)             |
+| **Understand the system** | [Introduction](../../ingestion/modules/02-core-guides-ingestion-01-introduction.md)           | [Mapping Patterns](./modules/graphql-mutation-mapping-04-mapping-patterns.md)               |
+| **Map XML to GraphQL**    | [Path Syntax](./modules/graphql-mutation-mapping-06-path-syntax.md)             | [Advanced Patterns](./modules/graphql-mutation-mapping-09-advanced-patterns.md)             |
+| **Map JSON to GraphQL**   | [Path Syntax](./modules/graphql-mutation-mapping-06-path-syntax.md)             | [Configuration Reference](./modules/graphql-mutation-mapping-05-configuration-reference.md) |
+| **Handle arrays**         | [Array Handling](./modules/graphql-mutation-mapping-07-array-handling.md)       | [Advanced Patterns](./modules/graphql-mutation-mapping-09-advanced-patterns.md)             |
+| **Add custom logic**      | [Custom Resolvers](./modules/graphql-mutation-mapping-08-custom-resolvers.md)   | [Hooks and Variables](./modules/graphql-mutation-mapping-10-hooks-and-variables.md)         |
+| **Handle errors**         | [Error Handling](./modules/graphql-mutation-mapping-11-error-handling.md)       | [Best Practices](./modules/graphql-mutation-mapping-13-best-practices.md)                   |
+| **Validate schema**       | [Schema Validation](./modules/graphql-mutation-mapping-03-schema-validation.md) | [Configuration Reference](./modules/graphql-mutation-mapping-05-configuration-reference.md) |
+| **See complete examples** | [Best Practices](./modules/graphql-mutation-mapping-13-best-practices.md)       | [Arguments vs Nodes](./modules/graphql-mutation-mapping-12-arguments-vs-nodes.md)           |
+
+---
+
+## 🚀 Real-World Use Cases
+
+### E-Commerce Order Integration
+
+**SFCC → Fluent Commerce**
+
+- XML order data from Salesforce Commerce Cloud
+- Transform to Fluent Commerce createOrder mutation
+- See: [Quick Start](../../auto-pagination/modules/auto-pagination-02-quick-start.md), [Path Syntax](./modules/graphql-mutation-mapping-06-path-syntax.md)
+
+**Shopify → Fluent Commerce**
+
+- JSON webhook from Shopify storefront
+- Map to Fluent Commerce order management
+- See: [Arguments vs Nodes](./modules/graphql-mutation-mapping-12-arguments-vs-nodes.md)
+
+**Magento → Fluent Commerce**
+
+- XML export from Magento platform
+- Simple pattern example
+- See: [Arguments vs Nodes](./modules/graphql-mutation-mapping-12-arguments-vs-nodes.md)
+
+### Inventory Management
+
+**Product Catalog Sync**
+
+- XML/JSON product feeds
+- Map to updateInventory mutations
+- See: [Advanced Patterns](./modules/graphql-mutation-mapping-09-advanced-patterns.md)
+
+**Stock Updates**
+
+- CSV to JSON to GraphQL
+- Batch inventory position updates
+- See: [Custom Resolvers](./modules/graphql-mutation-mapping-08-custom-resolvers.md)
+
+---
+
+## 📖 Documentation Structure
+
+```
+graphql-mutation-mapping/
+├── readme.md (this file)
+└── modules/
+    ├── 01-introduction.md          (Universal system overview)
+    ├── 02-quick-start.md            (Installation and basic usage)
+    ├── 03-schema-validation.md      (⚠️ CRITICAL - Schema requirements)
+    ├── 04-architecture.md           (System architecture)
+    ├── 05-configuration-reference.md (Complete config reference)
+    ├── 06-path-syntax.md            (XML/JSON path resolution)
+    ├── 07-array-handling.md         (Array mapping patterns)
+    ├── 08-custom-resolvers.md       (Custom transformation functions)
+    ├── 09-advanced-patterns.md      (Advanced mapping patterns)
+    ├── 10-hooks-and-variables.md    (Hooks and environment variables)
+    ├── 11-error-handling.md         (Error handling and recovery)
+    ├── 12-arguments-vs-nodes.md     (Configuration pattern comparison)
+    └── 13-best-practices.md         (Best practices and troubleshooting)
+```
+
+---
+
+## 🔗 Related Documentation
+
+### Core SDK Documentation
+
+- **[Universal Mapping Guide](../../mapping/mapping-readme.md)** - Field mapping and transformation patterns
+- **[Resolver Guide](../resolvers/mapping-resolvers-resolver-guide.md)** - Custom resolver patterns and SDK resolvers
+- **[XML Parser Guide](../../parsers/modules/02-core-guides-parsers-04-xml-parser.md)** - XML parsing with streaming support
+- **[JSON Parser Guide](../../parsers/modules/02-core-guides-parsers-03-json-parser.md)** - JSON/JSONL parsing with validation
+
+### Integration Examples
+
+- **[SFCC Connector Examples](../../../01-TEMPLATES/versori/webhooks/)** - Production SFCC order integration
+- **[Versori Platform Guide](../../../04-REFERENCE/platforms/versori/)** - Versori platform integration
+- **[Webhook Validation](../../../04-REFERENCE/platforms/versori/platforms-versori-webhook-auth-quick-reference.md)** - Validate webhook signatures
+
+### API Reference
+
+- **[API Reference](../../api-reference/api-reference-readme.md)** - Complete API documentation
+- **[Schema File](../../../04-REFERENCE/schema/fluent-commerce-schema.json)** - Fluent Commerce GraphQL schema
+
+---
+
+## ⚠️ Important Notes
+
+### Schema Validation is CRITICAL
+
+Before using any mapping examples, you **MUST** validate mutation field names against your GraphQL schema:
+
+```bash
+# Step 1: Introspect schema
+npx fc-connect introspect-schema \
+  --endpoint https://YOUR_ACCOUNT.api.fluentcommerce.com/graphql \
+  --output schema.json
+
+# Step 2: Validate mapping
+npx fc-connect validate-schema \
+  --mapping mappings/order-mapping.json \
+  --schema schema.json
+```
+
+**See:** [Schema Validation Module](./modules/graphql-mutation-mapping-03-schema-validation.md) for complete requirements.
+
+### Versori Platform Compatibility
+
+XMLPathResolver supports **both** raw XML strings **AND** pre-parsed objects (from Versori webhooks) with automatic detection. Same mapping config works in both environments.
+
+**See:** [Path Syntax Module](./modules/graphql-mutation-mapping-06-path-syntax.md#versori-platform-compatibility) for details.
+
+### Error Handling is Fail-Fast
+
+The mapper implements **fail-fast** error handling - if ANY error occurs during mapping or validation, the GraphQL mutation is **NEVER SENT**.
+
+**See:** [Error Handling Module](./modules/graphql-mutation-mapping-11-error-handling.md) for comprehensive patterns.
+
+---
+
+## 🎓 Learning Path
+
+### For Beginners
+
+1. Start with [Introduction](../../ingestion/modules/02-core-guides-ingestion-01-introduction.md)
+2. Follow [Quick Start](../../auto-pagination/modules/auto-pagination-02-quick-start.md)
+3. Read [Schema Validation](./modules/graphql-mutation-mapping-03-schema-validation.md) ⚠️
+4. Try [Path Syntax](./modules/graphql-mutation-mapping-06-path-syntax.md)
+
+### For Intermediate Users
+
+1. Review [Mapping Patterns](./modules/graphql-mutation-mapping-04-mapping-patterns.md)
+2. Master [Configuration Reference](./modules/graphql-mutation-mapping-05-configuration-reference.md)
+3. Learn [Array Handling](./modules/graphql-mutation-mapping-07-array-handling.md)
+4. Explore [Hooks and Variables](./modules/graphql-mutation-mapping-10-hooks-and-variables.md)
+
+### For Advanced Users
+
+1. Study [Custom Resolvers](./modules/graphql-mutation-mapping-08-custom-resolvers.md)
+2. Master [Advanced Patterns](./modules/graphql-mutation-mapping-09-advanced-patterns.md)
+3. Implement [Error Handling](./modules/graphql-mutation-mapping-11-error-handling.md)
+4. Review [Best Practices](./modules/graphql-mutation-mapping-13-best-practices.md)
+
+---
+
+## 📝 Contributing
+
+Found an issue or want to improve the GraphQL Mutation Mapping documentation?
+
+1. Check the [GitHub Repository](https://github.com/fluentcommerce/fc-connect-sdk)
+2. Submit issues or pull requests
+3. Follow the [Contributing Guidelines](../../../readme.md)
+
+---
+
+**License**: MIT