@fluentcommerce/fc-connect-sdk 0.1.54 → 0.1.56

package/docs/03-PATTERN-GUIDES/error-handling/error-handling-quick-reference.md

@@ -1,390 +1,390 @@
-# Error Handling Quick Reference
-
-**Quick lookup for error codes, handling patterns, and retry strategies**
-
-## Error Codes Cheat Sheet
-
-### File Discovery (20xx)
-
-| Code | Description | Retryable | Action |
-|------|-------------|-----------|--------|
-| `FILE_DISCOVERY_FAILED` | Failed to list/discover files | ✅ Yes | Retry with backoff |
-| `FILE_ACCESS_DENIED` | Permission denied | ❌ No | Fix permissions |
-| `FILE_NOT_FOUND` | File doesn't exist | ❌ No | Check file path |
-| `INVALID_FILE_FORMAT` | Unsupported file type | ❌ No | Fix file format |
-
-### Parsing (21xx)
-
-| Code | Description | Retryable | Action |
-|------|-------------|-----------|--------|
-| `PARSE_ERROR` | Generic parsing error | ❌ No | Fix source file |
-| `INVALID_CSV_FORMAT` | Malformed CSV | ❌ No | Fix CSV syntax |
-| `INVALID_PARQUET_FORMAT` | Invalid Parquet file | ❌ No | Regenerate Parquet |
-| `ENCODING_ERROR` | Character encoding issue | ❌ No | Convert to UTF-8 |
-
-### Transformation (22xx)
-
-| Code | Description | Retryable | Action |
-|------|-------------|-----------|--------|
-| `TRANSFORMATION_ERROR` | Generic transformation error | ❌ No | Fix mapping/data |
-| `FIELD_MAPPING_ERROR` | Field mapping failed | ❌ No | Fix mapping config |
-| `VALIDATION_ERROR` | Data validation failed | ❌ No | Fix source data |
-| `REQUIRED_FIELD_MISSING` | Required field empty | ❌ No | Provide field value |
-
-### Submission (23xx)
-
-| Code | Description | Retryable | Action |
-|------|-------------|-----------|--------|
-| `BATCH_SUBMISSION_ERROR` | Batch API error | ✅ Yes | Retry with backoff |
-| `JOB_CREATION_ERROR` | Job creation failed | ✅ Yes | Retry with backoff |
-| `API_ERROR` | Fluent API error | ✅ Yes | Retry with backoff |
-| `NETWORK_ERROR` | Network connectivity | ✅ Yes | Retry with backoff |
-
-### State Management (24xx)
-
-| Code | Description | Retryable | Action |
-|------|-------------|-----------|--------|
-| `LOCK_ACQUISITION_FAILED` | Failed to acquire lock | ✅ Yes | Retry with backoff |
-| `STATE_UPDATE_FAILED` | State update failed | ❌ No | Fix state management logic |
-
-### Configuration (25xx)
-
-| Code | Description | Retryable | Action |
-|------|-------------|-----------|--------|
-| `CONFIGURATION_ERROR` | Generic config error | ❌ No | Fix configuration |
-| `MISSING_REQUIRED_CONFIG` | Required config missing | ❌ No | Provide config value |
-| `INVALID_CONFIGURATION` | Config value invalid | ❌ No | Fix config value |
-
-### General (26xx)
-
-| Code | Description | Retryable | Action |
-|------|-------------|-----------|--------|
-| `UNKNOWN_ERROR` | Unexpected error | ❓ Maybe | Investigate and retry |
-| `TIMEOUT_ERROR` | Operation timeout | ✅ Yes | Retry with backoff |
-| `RATE_LIMIT_ERROR` | API rate limit hit | ✅ Yes | Wait `retryAfter` |
-
-## Error Classes Quick Lookup
-
-```typescript
-import {
-  // Base classes
-  IngestionError,
-  FluentError,
-
-  // Ingestion errors
-  FileDiscoveryError,
-  FileParsingError,
-  TransformationError,
-  BatchSubmissionError,
-  ConfigurationError,
-  ValidationError,
-  GraphQLExecutionError,
-  AggregateIngestionError,
-
-  // Mapping errors
-  MappingError,
-  ResolverError,
-  PathResolutionError,
-
-  // Data source errors
-  DataSourceError,
-
-  // Error codes
-  IngestionErrorCode
-} from '@fluentcommerce/fc-connect-sdk';
-```
-
-## Common Patterns
-
-### Basic Error Handling
-
-```typescript
-try {
-  const result = await processOrder(data);
-  return result;
-} catch (error) {
-  logger.error('Processing failed:', error);
-  throw error;  // Always re-throw!
-}
-```
-
-### Type-Specific Handling
-
-```typescript
-try {
-  await processOrder(data);
-} catch (error) {
-  if (error instanceof FileParsingError) {
-    logger.error('Parse error - fix source file');
-    throw error;  // Don't retry
-
-  } else if (error instanceof MappingError) {
-    logger.error('Mapping error - fix config or data');
-    throw error;  // Don't retry
-
-  } else if (error instanceof IngestionError && error.isRetryable()) {
-    return scheduleRetry();  // Retry transient errors
-  }
-
-  throw error;
-}
-```
-
-### Retry with Exponential Backoff
-
-```typescript
-async function retryWithBackoff<T>(
-  operation: () => Promise<T>,
-  maxRetries = 3
-): Promise<T> {
-  for (let attempt = 0; attempt < maxRetries; attempt++) {
-    try {
-      return await operation();
-    } catch (error) {
-      // Don't retry permanent errors
-      if (error instanceof MappingError ||
-          error instanceof PathResolutionError ||
-          error instanceof FileParsingError) {
-        throw error;
-      }
-
-      // Check if retryable
-      if (error instanceof IngestionError && !error.isRetryable()) {
-        throw error;
-      }
-
-      // Last attempt
-      if (attempt === maxRetries - 1) {
-        throw error;
-      }
-
-      // Exponential backoff
-      const delay = Math.pow(2, attempt) * 1000;
-      await new Promise(resolve => setTimeout(resolve, delay));
-    }
-  }
-}
-```
-
-### Rate Limit Handling
-
-```typescript
-catch (error) {
-  if (error instanceof IngestionError &&
-      error.code === IngestionErrorCode.RATE_LIMIT_ERROR) {
-
-    const retryAfter = error.context?.retryAfter || 60;
-    logger.info(`Rate limited - waiting ${retryAfter}s`);
-
-    await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
-    return retry();
-  }
-}
-```
-
-### Structured Logging
-
-```typescript
-catch (error) {
-  logger.error('Processing failed', {
-    // Use toJSON() for complete error data
-    error: error instanceof IngestionError ? error.toJSON() : error.message,
-
-    // Add business context
-    orderId,
-    fileName,
-    correlationId,
-
-    // Environment info
-    environment: process.env.NODE_ENV,
-    timestamp: new Date().toISOString()
-  });
-
-  throw error;
-}
-```
-
-## Decision Tree
-
-```
-Error occurred
-    │
-    ├─ Is it FileParsingError?
-    │   └─ YES → Don't retry, fix source file
-    │
-    ├─ Is it PathResolutionError?
-    │   └─ YES → Don't retry, fix mapping config
-    │
-    ├─ Is it MappingError?
-    │   └─ YES → Don't retry, fix data or config
-    │
-    ├─ Is it ValidationError?
-    │   └─ YES → Don't retry, fix source data
-    │
-    ├─ Is it ConfigurationError?
-    │   └─ YES → Don't retry, fix configuration
-    │
-    └─ Is it IngestionError?
-        └─ Check error.isRetryable()
-            ├─ YES → Retry with exponential backoff
-            └─ NO → Don't retry, permanent failure
-```
-
-## Retryable vs Non-Retryable
-
-### ❌ Never Retry
-
-- `FileParsingError` - Invalid XML/CSV/JSON
-- `PathResolutionError` - Wrong mapping path
-- `MappingError` - Required field missing
-- `ValidationError` - Data validation failed
-- `ConfigurationError` - Invalid configuration
-- `IngestionError` with `PARSE_ERROR`
-- `IngestionError` with `VALIDATION_ERROR`
-- `IngestionError` with `REQUIRED_FIELD_MISSING`
-- `IngestionError` with `FIELD_MAPPING_ERROR`
-- `IngestionError` with `CONFIGURATION_ERROR`
-
-### ✅ Always Retry
-
-- `IngestionError` with `NETWORK_ERROR`
-- `IngestionError` with `TIMEOUT_ERROR`
-- `IngestionError` with `RATE_LIMIT_ERROR`
-- `IngestionError` with `LOCK_ACQUISITION_FAILED`
-
-## Backoff Strategies
-
-### Exponential Backoff
-
-```
-Attempt 1: Wait 1s
-Attempt 2: Wait 2s
-Attempt 3: Wait 4s
-Attempt 4: Wait 8s
-Attempt 5: Wait 16s
-```
-
-### Exponential Backoff with Jitter
-
-```typescript
-const delay = initialDelay * Math.pow(2, attempt);
-const jitter = Math.random() * 100;
-const totalDelay = delay + jitter;
-```
-
-### Full Jitter (AWS recommended)
-
-```typescript
-const exponentialDelay = baseDelay * Math.pow(2, attempt);
-const cappedDelay = Math.min(exponentialDelay, maxDelay);
-const delay = Math.random() * cappedDelay;
-```
-
-## Error Methods Quick Reference
-
-### error.toJSON()
-
-Get structured error data for logging:
-
-```typescript
-const errorData = error.toJSON();
-// {
-//   name: "FileParsingError",
-//   message: "Invalid XML",
-//   code: "PARSE_ERROR",
-//   fileName: "order.xml",
-//   lineNumber: 42,
-//   timestamp: "2025-01-10T12:34:56Z",
-//   stack: "..."
-// }
-```
-
-### error.isRetryable()
-
-Check if error should be retried:
-
-```typescript
-if (error instanceof IngestionError && error.isRetryable()) {
-  // Retry with backoff
-}
-```
-
-## Error Properties by Class
-
-| Class | Key Properties | Example |
-|-------|----------------|---------|
-| `FileParsingError` | `fileName`, `lineNumber`, `code` | `error.fileName // "order.xml"` |
-| `PathResolutionError` | `path`, `cause` | `error.path // "order.WRONG.path"` |
-| `MappingError` | `field`, `sourcePath` | `error.field // "ref"` |
-| `ResolverError` | `resolverName`, `fieldName`, `fieldPath`, `originalError` | `error.resolverName // "custom.parseDate"` |
-| `ValidationError` | `validationErrors[]` | `error.validationErrors[0].field` |
-| `ConfigurationError` | `configKey`, `code` | `error.configKey // "baseUrl"` |
-| `BatchSubmissionError` | `jobId`, `batchId`, `code` | `error.jobId // "JOB-123"` |
-| `GraphQLExecutionError` | `graphqlErrors[]`, `query`, `variables` | `error.getErrorMessages()` |
-| `DataSourceError` | `source`, `operation`, `details` | `error.source // "S3_CSV"` |
-| `IngestionError` | `code`, `context`, `timestamp` | `error.code // "NETWORK_ERROR"` |
-
-## Common Mistakes
-
-### ❌ Silencing Errors
-
-```typescript
-// ❌ WRONG
-try {
-  await processOrder(data);
-} catch (error) {
-  // Do nothing - error is lost!
-}
-```
-
-### ❌ Retrying Permanent Errors
-
-```typescript
-// ❌ WRONG
-catch (error) {
-  if (error instanceof FileParsingError) {
-    return retry();  // Won't succeed!
-  }
-}
-```
-
-### ❌ Missing Context
-
-```typescript
-// ❌ WRONG
-logger.error('Error occurred');
-```
-
-### ❌ Not Re-throwing
-
-```typescript
-// ❌ WRONG
-catch (error) {
-  logger.error('Error:', error);
-  return null;  // Swallows error!
-}
-```
-
-## Best Practices Summary
-
-1. ✅ Always use try-catch
-2. ✅ Check error types with `instanceof`
-3. ✅ Use `error.toJSON()` for logging
-4. ✅ Check `error.isRetryable()` before retry
-5. ✅ Re-throw errors after handling
-6. ✅ Log with correlation IDs
-7. ✅ Monitor error rates
-8. ✅ Set up alerts
-9. ✅ Document error scenarios
-10. ✅ Test error paths
-
-## Related Modules
-
-- [Module 1: Foundations](./modules/error-handling-01-foundations.md) - Fail-fast principles
-- [Module 2: Error Types](./modules/error-handling-02-error-types.md) - Complete error reference
-- [Module 3: UTF-8 Handling](./modules/error-handling-03-utf8-handling.md) - UTF-8 encoding and special characters
-- [Module 4: Error Scenarios](./modules/error-handling-04-error-scenarios.md) - Real-world examples
-- [Module 5: Calling Patterns](./modules/error-handling-05-calling-patterns.md) - Code patterns
-- [Module 6: Retry Strategies](./modules/error-handling-06-retry-strategies.md) - Retry logic
-- [Module 7: Monitoring](./modules/error-handling-07-monitoring.md) - Logging and monitoring
-- [Module 8: API Reference](./modules/error-handling-08-api-reference.md) - Complete API docs
+# Error Handling Quick Reference
+
+**Quick lookup for error codes, handling patterns, and retry strategies**
+
+## Error Codes Cheat Sheet
+
+### File Discovery (20xx)
+
+| Code | Description | Retryable | Action |
+|------|-------------|-----------|--------|
+| `FILE_DISCOVERY_FAILED` | Failed to list/discover files | ✅ Yes | Retry with backoff |
+| `FILE_ACCESS_DENIED` | Permission denied | ❌ No | Fix permissions |
+| `FILE_NOT_FOUND` | File doesn't exist | ❌ No | Check file path |
+| `INVALID_FILE_FORMAT` | Unsupported file type | ❌ No | Fix file format |
+
+### Parsing (21xx)
+
+| Code | Description | Retryable | Action |
+|------|-------------|-----------|--------|
+| `PARSE_ERROR` | Generic parsing error | ❌ No | Fix source file |
+| `INVALID_CSV_FORMAT` | Malformed CSV | ❌ No | Fix CSV syntax |
+| `INVALID_PARQUET_FORMAT` | Invalid Parquet file | ❌ No | Regenerate Parquet |
+| `ENCODING_ERROR` | Character encoding issue | ❌ No | Convert to UTF-8 |
+
+### Transformation (22xx)
+
+| Code | Description | Retryable | Action |
+|------|-------------|-----------|--------|
+| `TRANSFORMATION_ERROR` | Generic transformation error | ❌ No | Fix mapping/data |
+| `FIELD_MAPPING_ERROR` | Field mapping failed | ❌ No | Fix mapping config |
+| `VALIDATION_ERROR` | Data validation failed | ❌ No | Fix source data |
+| `REQUIRED_FIELD_MISSING` | Required field empty | ❌ No | Provide field value |
+
+### Submission (23xx)
+
+| Code | Description | Retryable | Action |
+|------|-------------|-----------|--------|
+| `BATCH_SUBMISSION_ERROR` | Batch API error | ✅ Yes | Retry with backoff |
+| `JOB_CREATION_ERROR` | Job creation failed | ✅ Yes | Retry with backoff |
+| `API_ERROR` | Fluent API error | ✅ Yes | Retry with backoff |
+| `NETWORK_ERROR` | Network connectivity | ✅ Yes | Retry with backoff |
+
+### State Management (24xx)
+
+| Code | Description | Retryable | Action |
+|------|-------------|-----------|--------|
+| `LOCK_ACQUISITION_FAILED` | Failed to acquire lock | ✅ Yes | Retry with backoff |
+| `STATE_UPDATE_FAILED` | State update failed | ❌ No | Fix state management logic |
+
+### Configuration (25xx)
+
+| Code | Description | Retryable | Action |
+|------|-------------|-----------|--------|
+| `CONFIGURATION_ERROR` | Generic config error | ❌ No | Fix configuration |
+| `MISSING_REQUIRED_CONFIG` | Required config missing | ❌ No | Provide config value |
+| `INVALID_CONFIGURATION` | Config value invalid | ❌ No | Fix config value |
+
+### General (26xx)
+
+| Code | Description | Retryable | Action |
+|------|-------------|-----------|--------|
+| `UNKNOWN_ERROR` | Unexpected error | ❓ Maybe | Investigate and retry |
+| `TIMEOUT_ERROR` | Operation timeout | ✅ Yes | Retry with backoff |
+| `RATE_LIMIT_ERROR` | API rate limit hit | ✅ Yes | Wait `retryAfter` |
+
+## Error Classes Quick Lookup
+
+```typescript
+import {
+  // Base classes
+  IngestionError,
+  FluentError,
+
+  // Ingestion errors
+  FileDiscoveryError,
+  FileParsingError,
+  TransformationError,
+  BatchSubmissionError,
+  ConfigurationError,
+  ValidationError,
+  GraphQLExecutionError,
+  AggregateIngestionError,
+
+  // Mapping errors
+  MappingError,
+  ResolverError,
+  PathResolutionError,
+
+  // Data source errors
+  DataSourceError,
+
+  // Error codes
+  IngestionErrorCode
+} from '@fluentcommerce/fc-connect-sdk';
+```
+
+## Common Patterns
+
+### Basic Error Handling
+
+```typescript
+try {
+  const result = await processOrder(data);
+  return result;
+} catch (error) {
+  logger.error('Processing failed:', error);
+  throw error;  // Always re-throw!
+}
+```
+
+### Type-Specific Handling
+
+```typescript
+try {
+  await processOrder(data);
+} catch (error) {
+  if (error instanceof FileParsingError) {
+    logger.error('Parse error - fix source file');
+    throw error;  // Don't retry
+
+  } else if (error instanceof MappingError) {
+    logger.error('Mapping error - fix config or data');
+    throw error;  // Don't retry
+
+  } else if (error instanceof IngestionError && error.isRetryable()) {
+    return scheduleRetry();  // Retry transient errors
+  }
+
+  throw error;
+}
+```
+
+### Retry with Exponential Backoff
+
+```typescript
+async function retryWithBackoff<T>(
+  operation: () => Promise<T>,
+  maxRetries = 3
+): Promise<T> {
+  for (let attempt = 0; attempt < maxRetries; attempt++) {
+    try {
+      return await operation();
+    } catch (error) {
+      // Don't retry permanent errors
+      if (error instanceof MappingError ||
+          error instanceof PathResolutionError ||
+          error instanceof FileParsingError) {
+        throw error;
+      }
+
+      // Check if retryable
+      if (error instanceof IngestionError && !error.isRetryable()) {
+        throw error;
+      }
+
+      // Last attempt
+      if (attempt === maxRetries - 1) {
+        throw error;
+      }
+
+      // Exponential backoff
+      const delay = Math.pow(2, attempt) * 1000;
+      await new Promise(resolve => setTimeout(resolve, delay));
+    }
+  }
+}
+```
+
+### Rate Limit Handling
+
+```typescript
+catch (error) {
+  if (error instanceof IngestionError &&
+      error.code === IngestionErrorCode.RATE_LIMIT_ERROR) {
+
+    const retryAfter = error.context?.retryAfter || 60;
+    logger.info(`Rate limited - waiting ${retryAfter}s`);
+
+    await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
+    return retry();
+  }
+}
+```
+
+### Structured Logging
+
+```typescript
+catch (error) {
+  logger.error('Processing failed', {
+    // Use toJSON() for complete error data
+    error: error instanceof IngestionError ? error.toJSON() : error.message,
+
+    // Add business context
+    orderId,
+    fileName,
+    correlationId,
+
+    // Environment info
+    environment: process.env.NODE_ENV,
+    timestamp: new Date().toISOString()
+  });
+
+  throw error;
+}
+```
+
+## Decision Tree
+
+```
+Error occurred
+    │
+    ├─ Is it FileParsingError?
+    │   └─ YES → Don't retry, fix source file
+    │
+    ├─ Is it PathResolutionError?
+    │   └─ YES → Don't retry, fix mapping config
+    │
+    ├─ Is it MappingError?
+    │   └─ YES → Don't retry, fix data or config
+    │
+    ├─ Is it ValidationError?
+    │   └─ YES → Don't retry, fix source data
+    │
+    ├─ Is it ConfigurationError?
+    │   └─ YES → Don't retry, fix configuration
+    │
+    └─ Is it IngestionError?
+        └─ Check error.isRetryable()
+            ├─ YES → Retry with exponential backoff
+            └─ NO → Don't retry, permanent failure
+```
+
+## Retryable vs Non-Retryable
+
+### ❌ Never Retry
+
+- `FileParsingError` - Invalid XML/CSV/JSON
+- `PathResolutionError` - Wrong mapping path
+- `MappingError` - Required field missing
+- `ValidationError` - Data validation failed
+- `ConfigurationError` - Invalid configuration
+- `IngestionError` with `PARSE_ERROR`
+- `IngestionError` with `VALIDATION_ERROR`
+- `IngestionError` with `REQUIRED_FIELD_MISSING`
+- `IngestionError` with `FIELD_MAPPING_ERROR`
+- `IngestionError` with `CONFIGURATION_ERROR`
+
+### ✅ Always Retry
+
+- `IngestionError` with `NETWORK_ERROR`
+- `IngestionError` with `TIMEOUT_ERROR`
+- `IngestionError` with `RATE_LIMIT_ERROR`
+- `IngestionError` with `LOCK_ACQUISITION_FAILED`
+
+## Backoff Strategies
+
+### Exponential Backoff
+
+```
+Attempt 1: Wait 1s
+Attempt 2: Wait 2s
+Attempt 3: Wait 4s
+Attempt 4: Wait 8s
+Attempt 5: Wait 16s
+```
+
+### Exponential Backoff with Jitter
+
+```typescript
+const delay = initialDelay * Math.pow(2, attempt);
+const jitter = Math.random() * 100;
+const totalDelay = delay + jitter;
+```
+
+### Full Jitter (AWS recommended)
+
+```typescript
+const exponentialDelay = baseDelay * Math.pow(2, attempt);
+const cappedDelay = Math.min(exponentialDelay, maxDelay);
+const delay = Math.random() * cappedDelay;
+```
+
+## Error Methods Quick Reference
+
+### error.toJSON()
+
+Get structured error data for logging:
+
+```typescript
+const errorData = error.toJSON();
+// {
+//   name: "FileParsingError",
+//   message: "Invalid XML",
+//   code: "PARSE_ERROR",
+//   fileName: "order.xml",
+//   lineNumber: 42,
+//   timestamp: "2025-01-10T12:34:56Z",
+//   stack: "..."
+// }
+```
+
+### error.isRetryable()
+
+Check if error should be retried:
+
+```typescript
+if (error instanceof IngestionError && error.isRetryable()) {
+  // Retry with backoff
+}
+```
+
+## Error Properties by Class
+
+| Class | Key Properties | Example |
+|-------|----------------|---------|
+| `FileParsingError` | `fileName`, `lineNumber`, `code` | `error.fileName // "order.xml"` |
+| `PathResolutionError` | `path`, `cause` | `error.path // "order.WRONG.path"` |
+| `MappingError` | `field`, `sourcePath` | `error.field // "ref"` |
+| `ResolverError` | `resolverName`, `fieldName`, `fieldPath`, `originalError` | `error.resolverName // "custom.parseDate"` |
+| `ValidationError` | `validationErrors[]` | `error.validationErrors[0].field` |
+| `ConfigurationError` | `configKey`, `code` | `error.configKey // "baseUrl"` |
+| `BatchSubmissionError` | `jobId`, `batchId`, `code` | `error.jobId // "JOB-123"` |
+| `GraphQLExecutionError` | `graphqlErrors[]`, `query`, `variables` | `error.getErrorMessages()` |
+| `DataSourceError` | `source`, `operation`, `details` | `error.source // "S3_CSV"` |
+| `IngestionError` | `code`, `context`, `timestamp` | `error.code // "NETWORK_ERROR"` |
+
+## Common Mistakes
+
+### ❌ Silencing Errors
+
+```typescript
+// ❌ WRONG
+try {
+  await processOrder(data);
+} catch (error) {
+  // Do nothing - error is lost!
+}
+```
+
+### ❌ Retrying Permanent Errors
+
+```typescript
+// ❌ WRONG
+catch (error) {
+  if (error instanceof FileParsingError) {
+    return retry();  // Won't succeed!
+  }
+}
+```
+
+### ❌ Missing Context
+
+```typescript
+// ❌ WRONG
+logger.error('Error occurred');
+```
+
+### ❌ Not Re-throwing
+
+```typescript
+// ❌ WRONG
+catch (error) {
+  logger.error('Error:', error);
+  return null;  // Swallows error!
+}
+```
+
+## Best Practices Summary
+
+1. ✅ Always use try-catch
+2. ✅ Check error types with `instanceof`
+3. ✅ Use `error.toJSON()` for logging
+4. ✅ Check `error.isRetryable()` before retry
+5. ✅ Re-throw errors after handling
+6. ✅ Log with correlation IDs
+7. ✅ Monitor error rates
+8. ✅ Set up alerts
+9. ✅ Document error scenarios
+10. ✅ Test error paths
+
+## Related Modules
+
+- [Module 1: Foundations](./modules/error-handling-01-foundations.md) - Fail-fast principles
+- [Module 2: Error Types](./modules/error-handling-02-error-types.md) - Complete error reference
+- [Module 3: UTF-8 Handling](./modules/error-handling-03-utf8-handling.md) - UTF-8 encoding and special characters
+- [Module 4: Error Scenarios](./modules/error-handling-04-error-scenarios.md) - Real-world examples
+- [Module 5: Calling Patterns](./modules/error-handling-05-calling-patterns.md) - Code patterns
+- [Module 6: Retry Strategies](./modules/error-handling-06-retry-strategies.md) - Retry logic
+- [Module 7: Monitoring](./modules/error-handling-07-monitoring.md) - Logging and monitoring
+- [Module 8: API Reference](./modules/error-handling-08-api-reference.md) - Complete API docs