@fluentcommerce/fc-connect-sdk 0.1.54 → 0.1.56

package/docs/03-PATTERN-GUIDES/readme.md

@@ -1,159 +1,159 @@
-# Pattern Guides
-
-> **Production-ready integration patterns and best practices**
-> Complete guides for common integration scenarios
-
-## Overview
-
-The Pattern Guides section provides practical integration patterns for real-world scenarios. Each guide demonstrates production-ready patterns with complete error handling, performance optimization, and best practices.
-
-## Available Guides
-
-### Integration Patterns
-
-| Guide | Description | Level | Status |
-|-------|-------------|-------|--------|
-| **[Connector Scenarios](./connector-scenarios/)** | Real-world integration scenarios | Intermediate | Complete |
-| **[Integration Patterns](./integration-patterns/)** | Real-time, batch, delta sync patterns | Advanced | Complete |
-| **[Enterprise Integration Patterns (EIP)](./enterprise-integration-patterns.md)** | How to build EIP patterns using SDK components | Advanced | Complete |
-| **[Error Handling](./error-handling/)** | Error handling and retry strategies | Intermediate | Complete |
-| **[Multiple Connections](./multiple-connections/)** | Multi-connection management | Advanced | Complete |
-| **[Webhook Patterns](./webhooks/)** | Webhook integration patterns | Intermediate | Complete |
-
-### Data Processing
-
-| Guide | Description | Level | Status |
-|-------|-------------|-------|--------|
-| **[File Operations](./file-operations/)** | S3/SFTP file operations | Medium | Complete |
-| **[Parquet](./parquet/)** | Parquet file processing | Advanced | Complete |
-| **[Parsers](./parsers/)** | Parser implementation patterns | Beginner | Complete |
-| **[Pagination](./pagination/)** | Pagination strategies | Intermediate | Complete |
-
-### Workflow Patterns
-
-| Guide | Description | Level | Status |
-|-------|-------------|-------|--------|
-| **[Ingestion](./ingestion/)** | Ingestion workflow patterns | Intermediate | Complete |
-| **[Extraction](./extraction/)** | Extraction workflow patterns | Intermediate | Complete |
-
-## Quick Navigation
-
-### By Use Case
-
-| I Want To... | Guide | Complexity |
-|--|--|--|
-| **Build a real-world connector** | [Connector Scenarios](./connector-scenarios/) | Intermediate |
-| **Understand EIP patterns** | [Enterprise Integration Patterns](./enterprise-integration-patterns.md) | Advanced |
-| **Implement error handling** | [Error Handling](./error-handling/) | Intermediate |
-| **Process files from S3/SFTP** | [File Operations](./file-operations/) | Medium |
-| **Handle webhooks** | [Webhook Patterns](./webhooks/) | Intermediate |
-| **Manage multiple connections** | [Multiple Connections](./multiple-connections/) | Advanced |
-| **Process Parquet files** | [Parquet](./parquet/) | Advanced |
-| **Implement pagination** | [Pagination](./pagination/) | Intermediate |
-| **Choose integration pattern** | [Integration Patterns](./integration-patterns/) | Advanced |
-
-### By Complexity
-
-**Beginner**
-- [Parsers](./parsers/) - Parser implementation basics
-
-**Intermediate**
-- [Connector Scenarios](./connector-scenarios/) - Real-world integrations
-- [Error Handling](./error-handling/) - Error patterns
-- [Webhook Patterns](./webhooks/) - Webhook handling
-- [Ingestion](./ingestion/) - Ingestion workflows
-- [Extraction](./extraction/) - Extraction workflows
-- [Pagination](./pagination/) - Pagination strategies
-
-**Advanced**
-- [Integration Patterns](./integration-patterns/) - Complex integration patterns
-- [Enterprise Integration Patterns](./enterprise-integration-patterns.md) - Build EIP patterns with SDK
-- [Multiple Connections](./multiple-connections/) - Multi-connection management
-- [Parquet](./parquet/) - Advanced file processing
-
-## Guide Structure
-
-Each guide follows this structure:
-
-```
-guide-name/
-├── readme.md                    # Main index
-├── guide-name-quick-reference.md # Cheat sheet
-├── modules/                     # Learning modules
-│   ├── readme.md                # Modules index
-│   └── *.md                     # Progressive modules
-└── examples/                    # Code examples
-    ├── readme.md                # Examples index
-    └── *.ts                     # Runnable examples
-```
-
-## Pattern Categories
-
-### Integration Patterns
-Production-ready patterns for common integration scenarios:
-- Real-time processing
-- Batch processing
-- Delta synchronization
-- Bidirectional sync
-- Multi-system integration
-- Enterprise Integration Patterns (EIP) - Build patterns using SDK components
-
-### Data Processing Patterns
-Efficient data processing strategies:
-- File operations (S3, SFTP)
-- Streaming large datasets
-- Parquet processing
-- Parser implementations
-- Pagination strategies
-
-### Error Handling Patterns
-Robust error handling and recovery:
-- Retry strategies
-- Circuit breakers
-- Dead letter queues
-- Error monitoring
-- Graceful degradation
-
-## Using These Patterns
-
-1. **Identify your scenario** from Quick Navigation
-2. **Review the pattern guide** for approach
-3. **Study the examples** for implementation
-4. **Adapt to your needs**
-5. **Test thoroughly**
-6. **Deploy to production**
-
-## Related Documentation
-
-### SDK Documentation
-- [Core Guides](../02-CORE-GUIDES/) - SDK fundamentals
-- [Templates](../01-TEMPLATES/) - Production-ready templates
-- [Reference](../04-REFERENCE/) - Technical reference
-
-### External Resources
-- [npm Package](https://www.npmjs.com/package/@fluentcommerce/fc-connect-sdk)
-- [Fluent Commerce Docs](https://docs.fluentcommerce.com/)
-
-## Best Practices
-
-All pattern guides follow these practices:
-- **Production-Ready** - Battle-tested in real integrations
-- **Error Handling** - Comprehensive error recovery
-- **Performance** - Optimized for scale
-- **Monitoring** - Built-in observability
-- **Security** - Secure credential management
-
-## Support
-
-Need help with integration patterns?
-- Browse guide examples
-- Check quick reference sheets
-- Review troubleshooting sections
-- Contact support@fluentcommerce.com
-
----
-
-**Next Steps:**
-- New to patterns? Start with [Connector Scenarios](./connector-scenarios/)
-- Need error handling? See [Error Handling Guide](./error-handling/)
-- Building a connector? Check [Integration Patterns](./integration-patterns/)
+# Pattern Guides
+
+> **Production-ready integration patterns and best practices**
+> Complete guides for common integration scenarios
+
+## Overview
+
+The Pattern Guides section provides practical integration patterns for real-world scenarios. Each guide demonstrates production-ready patterns with complete error handling, performance optimization, and best practices.
+
+## Available Guides
+
+### Integration Patterns
+
+| Guide | Description | Level | Status |
+|-------|-------------|-------|--------|
+| **[Connector Scenarios](./connector-scenarios/)** | Real-world integration scenarios | Intermediate | Complete |
+| **[Integration Patterns](./integration-patterns/)** | Real-time, batch, delta sync patterns | Advanced | Complete |
+| **[Enterprise Integration Patterns (EIP)](./enterprise-integration-patterns.md)** | How to build EIP patterns using SDK components | Advanced | Complete |
+| **[Error Handling](./error-handling/)** | Error handling and retry strategies | Intermediate | Complete |
+| **[Multiple Connections](./multiple-connections/)** | Multi-connection management | Advanced | Complete |
+| **[Webhook Patterns](./webhooks/)** | Webhook integration patterns | Intermediate | Complete |
+
+### Data Processing
+
+| Guide | Description | Level | Status |
+|-------|-------------|-------|--------|
+| **[File Operations](./file-operations/)** | S3/SFTP file operations | Medium | Complete |
+| **[Parquet](./parquet/)** | Parquet file processing | Advanced | Complete |
+| **[Parsers](./parsers/)** | Parser implementation patterns | Beginner | Complete |
+| **[Pagination](./pagination/)** | Pagination strategies | Intermediate | Complete |
+
+### Workflow Patterns
+
+| Guide | Description | Level | Status |
+|-------|-------------|-------|--------|
+| **[Ingestion](./ingestion/)** | Ingestion workflow patterns | Intermediate | Complete |
+| **[Extraction](./extraction/)** | Extraction workflow patterns | Intermediate | Complete |
+
+## Quick Navigation
+
+### By Use Case
+
+| I Want To... | Guide | Complexity |
+|--|--|--|
+| **Build a real-world connector** | [Connector Scenarios](./connector-scenarios/) | Intermediate |
+| **Understand EIP patterns** | [Enterprise Integration Patterns](./enterprise-integration-patterns.md) | Advanced |
+| **Implement error handling** | [Error Handling](./error-handling/) | Intermediate |
+| **Process files from S3/SFTP** | [File Operations](./file-operations/) | Medium |
+| **Handle webhooks** | [Webhook Patterns](./webhooks/) | Intermediate |
+| **Manage multiple connections** | [Multiple Connections](./multiple-connections/) | Advanced |
+| **Process Parquet files** | [Parquet](./parquet/) | Advanced |
+| **Implement pagination** | [Pagination](./pagination/) | Intermediate |
+| **Choose integration pattern** | [Integration Patterns](./integration-patterns/) | Advanced |
+
+### By Complexity
+
+**Beginner**
+- [Parsers](./parsers/) - Parser implementation basics
+
+**Intermediate**
+- [Connector Scenarios](./connector-scenarios/) - Real-world integrations
+- [Error Handling](./error-handling/) - Error patterns
+- [Webhook Patterns](./webhooks/) - Webhook handling
+- [Ingestion](./ingestion/) - Ingestion workflows
+- [Extraction](./extraction/) - Extraction workflows
+- [Pagination](./pagination/) - Pagination strategies
+
+**Advanced**
+- [Integration Patterns](./integration-patterns/) - Complex integration patterns
+- [Enterprise Integration Patterns](./enterprise-integration-patterns.md) - Build EIP patterns with SDK
+- [Multiple Connections](./multiple-connections/) - Multi-connection management
+- [Parquet](./parquet/) - Advanced file processing
+
+## Guide Structure
+
+Each guide follows this structure:
+
+```
+guide-name/
+├── readme.md                    # Main index
+├── guide-name-quick-reference.md # Cheat sheet
+├── modules/                     # Learning modules
+│   ├── readme.md                # Modules index
+│   └── *.md                     # Progressive modules
+└── examples/                    # Code examples
+    ├── readme.md                # Examples index
+    └── *.ts                     # Runnable examples
+```
+
+## Pattern Categories
+
+### Integration Patterns
+Production-ready patterns for common integration scenarios:
+- Real-time processing
+- Batch processing
+- Delta synchronization
+- Bidirectional sync
+- Multi-system integration
+- Enterprise Integration Patterns (EIP) - Build patterns using SDK components
+
+### Data Processing Patterns
+Efficient data processing strategies:
+- File operations (S3, SFTP)
+- Streaming large datasets
+- Parquet processing
+- Parser implementations
+- Pagination strategies
+
+### Error Handling Patterns
+Robust error handling and recovery:
+- Retry strategies
+- Circuit breakers
+- Dead letter queues
+- Error monitoring
+- Graceful degradation
+
+## Using These Patterns
+
+1. **Identify your scenario** from Quick Navigation
+2. **Review the pattern guide** for approach
+3. **Study the examples** for implementation
+4. **Adapt to your needs**
+5. **Test thoroughly**
+6. **Deploy to production**
+
+## Related Documentation
+
+### SDK Documentation
+- [Core Guides](../02-CORE-GUIDES/) - SDK fundamentals
+- [Templates](../01-TEMPLATES/) - Production-ready templates
+- [Reference](../04-REFERENCE/) - Technical reference
+
+### External Resources
+- [npm Package](https://www.npmjs.com/package/@fluentcommerce/fc-connect-sdk)
+- [Fluent Commerce Docs](https://docs.fluentcommerce.com/)
+
+## Best Practices
+
+All pattern guides follow these practices:
+- **Production-Ready** - Battle-tested in real integrations
+- **Error Handling** - Comprehensive error recovery
+- **Performance** - Optimized for scale
+- **Monitoring** - Built-in observability
+- **Security** - Secure credential management
+
+## Support
+
+Need help with integration patterns?
+- Browse guide examples
+- Check quick reference sheets
+- Review troubleshooting sections
+- Contact support@fluentcommerce.com
+
+---
+
+**Next Steps:**
+- New to patterns? Start with [Connector Scenarios](./connector-scenarios/)
+- Need error handling? See [Error Handling Guide](./error-handling/)
+- Building a connector? Check [Integration Patterns](./integration-patterns/)

package/docs/03-PATTERN-GUIDES/webhooks/readme.md

@@ -1,24 +1,24 @@
-# Webhook Patterns
-
-> **Webhook integration patterns**
-> Secure webhook handling with validation and error recovery
-
-For complete documentation, see [webhooks-readme.md](./webhooks-readme.md)
-
-## Overview
-
-This guide provides webhook integration patterns for Fluent Commerce, including signature validation, error handling, and response patterns.
-
-## Quick Start
-
-See [Webhook Validation Guide](../../02-CORE-GUIDES/webhook-validation/) for complete webhook documentation.
-
-This pattern guide focuses on advanced webhook patterns and production implementations.
-
-## Related Documentation
-
-- [Webhook Validation Guide](../../02-CORE-GUIDES/webhook-validation/) - Webhook security
-- [Versori Webhooks](../../01-TEMPLATES/versori/webhooks/) - Versori webhook templates
-- [Error Handling](../error-handling/) - Webhook error handling
-
-See [webhooks-readme.md](./webhooks-readme.md) for complete details.
+# Webhook Patterns
+
+> **Webhook integration patterns**
+> Secure webhook handling with validation and error recovery
+
+For complete documentation, see [webhooks-readme.md](./webhooks-readme.md)
+
+## Overview
+
+This guide provides webhook integration patterns for Fluent Commerce, including signature validation, error handling, and response patterns.
+
+## Quick Start
+
+See [Webhook Validation Guide](../../02-CORE-GUIDES/webhook-validation/) for complete webhook documentation.
+
+This pattern guide focuses on advanced webhook patterns and production implementations.
+
+## Related Documentation
+
+- [Webhook Validation Guide](../../02-CORE-GUIDES/webhook-validation/) - Webhook security
+- [Versori Webhooks](../../01-TEMPLATES/versori/webhooks/) - Versori webhook templates
+- [Error Handling](../error-handling/) - Webhook error handling
+
+See [webhooks-readme.md](./webhooks-readme.md) for complete details.

package/docs/03-PATTERN-GUIDES/webhooks/webhooks-readme.md

@@ -1,8 +1,8 @@
-# Webhook Patterns
-
-Webhook documentation is available in:
-
-**📍 [Webhook Validation Guide](../../02-CORE-GUIDES/webhook-validation/webhook-validation-readme.md)**
-
-For webhook templates, see:
-**📍 [Webhook Templates](../../01-TEMPLATES/versori/webhooks/)**
+# Webhook Patterns
+
+Webhook documentation is available in:
+
+**📍 [Webhook Validation Guide](../../02-CORE-GUIDES/webhook-validation/webhook-validation-readme.md)**
+
+For webhook templates, see:
+**📍 [Webhook Templates](../../01-TEMPLATES/versori/webhooks/)**