@fluentcommerce/fc-connect-sdk 0.1.54 → 0.1.56

package/docs/01-TEMPLATES/standalone/standalone-multi-channel-inventory-sync.md

@@ -1,1185 +1,1185 @@
-# Standalone: Multi-Channel Inventory Sync (Real-Time ATP to Marketplaces)
-
-**FC Connect SDK Use Case Guide**
-
-> **SDK**: [@fluentcommerce/fc-connect-sdk](https://www.npmjs.com/package/@fluentcommerce/fc-connect-sdk)
-> **Version**: Use latest - `npm install @fluentcommerce/fc-connect-sdk@latest`
-
-**Context**: Node.js script that aggregates Available-to-Promise (ATP) inventory from Fluent Commerce and pushes real-time updates to multiple marketplaces (Amazon, eBay, Walmart)
-
-**Complexity**: High
-
-**Runtime**: Node.js >=18
-
-**Estimated Lines**: ~950 lines
-
-**Volume**: Large (10k-100k SKUs, multiple marketplaces)
-
-**Latency**: Near real-time (every 5-15 min)
-
-**Pattern**: GraphQL pagination → external marketplace APIs
-
-## What You'll Build
-
-- OAuth2-authenticated Fluent Commerce client
-- GraphQL query with auto-pagination for inventory positions
-- ATP (Available-to-Promise) aggregation across multiple locations
-- Marketplace-specific buffer stock calculations
-- Parallel marketplace updates with rate limiting:
-  - Amazon MWS/SP-API integration
-  - eBay Trading API integration
-  - Walmart Seller API integration
-- Per-marketplace error handling and retry logic
-- SLA tracking (15-minute sync requirement)
-- Comprehensive metrics and logging
-- Dry-run mode for testing
-- State management to prevent duplicate updates
-
-## SDK Methods Used
-
-- `createClient({ config: { baseUrl, clientId, clientSecret, retailerId } })` - OAuth2 client
-- `client.graphql({ query, variables, pagination })` - Query with auto-pagination
-- `UniversalMapper(mappingConfig)` - Transform Fluent data to marketplace formats
-- `createConsoleLogger()` - Simple console logger
-- `toStructuredLogger(logger, context)` - Add context to logs
-- `generateCorrelationId()` - Generate unique correlation IDs
-- State tracking for incremental updates
-
----
-
-## Complete Working Implementation
-
-### 1. Project Setup
-
-```bash
-# Create project directory
-mkdir multi-channel-inventory-sync
-cd multi-channel-inventory-sync
-
-# Initialize Node.js project
-npm init -y
-
-# Install dependencies
-npm install @fluentcommerce/fc-connect-sdk dotenv axios p-limit p-retry
-```
-
-### 2. Environment Configuration
-
-Create `.env` file:
-
-```bash
-# Fluent Commerce OAuth2
-FLUENT_BASE_URL=https://api.fluentcommerce.com
-FLUENT_CLIENT_ID=your-oauth2-client-id
-FLUENT_CLIENT_SECRET=your-oauth2-client-secret
-FLUENT_RETAILER_ID=your-retailer-id
-
-# Sync Configuration
-SYNC_INTERVAL_MINUTES=15
-SLA_THRESHOLD_MINUTES=15
-MAX_RECORDS_PER_SYNC=100000
-DRY_RUN=false
-
-# Amazon SP-API Credentials
-AMAZON_ENABLED=true
-AMAZON_MARKETPLACE_ID=ATVPDKIKX0DER
-AMAZON_SELLER_ID=your-amazon-seller-id
-AMAZON_REFRESH_TOKEN=your-amazon-refresh-token
-AMAZON_CLIENT_ID=amzn1.application-oa2-client.xxxxx
-AMAZON_CLIENT_SECRET=your-amazon-client-secret
-AMAZON_AWS_ACCESS_KEY_ID=your-aws-access-key
-AMAZON_AWS_SECRET_ACCESS_KEY=your-aws-secret-key
-AMAZON_REGION=us-east-1
-AMAZON_ROLE_ARN=arn:aws:iam::123456789:role/SellingPartnerAPI
-AMAZON_BUFFER_STOCK=5
-AMAZON_RATE_LIMIT=10
-
-# eBay Trading API Credentials
-EBAY_ENABLED=true
-EBAY_APP_ID=your-ebay-app-id
-EBAY_DEV_ID=your-ebay-dev-id
-EBAY_CERT_ID=your-ebay-cert-id
-EBAY_AUTH_TOKEN=your-ebay-auth-token
-EBAY_SITE_ID=0
-EBAY_SANDBOX=false
-EBAY_BUFFER_STOCK=3
-EBAY_RATE_LIMIT=5
-
-# Walmart Seller API Credentials
-WALMART_ENABLED=true
-WALMART_CLIENT_ID=your-walmart-client-id
-WALMART_CLIENT_SECRET=your-walmart-client-secret
-WALMART_CHANNEL_TYPE=0a7d6c3e-e9a0-4a0c-8d6a-f6c6f1e7a5c7
-WALMART_BUFFER_STOCK=10
-WALMART_RATE_LIMIT=20
-
-# Logging
-LOG_LEVEL=info
-METRICS_ENABLED=true
-```
-
-### 3. Package Configuration
-
-Create `package.json`:
-
-```json
-{
-  "name": "multi-channel-inventory-sync",
-  "version": "1.0.0",
-  "type": "module",
-  "description": "Real-time ATP inventory sync from Fluent Commerce to multiple marketplaces",
-  "main": "src/index.js",
-  "scripts": {
-    "start": "node src/index.js",
-    "sync:once": "node src/index.js --once",
-    "sync:continuous": "node src/index.js",
-    "sync:dry-run": "DRY_RUN=true node src/index.js --once",
-    "test": "node --test tests/**/*.test.js"
-  },
-  "dependencies": {
-    "@fluentcommerce/fc-connect-sdk": "^0.1.39",
-    "axios": "^1.6.0",
-    "dotenv": "^16.0.0",
-    "p-limit": "^5.0.0",
-    "p-retry": "^6.0.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}
-```
-
-### 4. TypeScript Configuration (tsconfig.json)
-
-```json
-{
-  "compilerOptions": {
-    "module": "ES2022",
-    "target": "ES2024",
-    "moduleResolution": "node"
-  }
-}
-```
-
-### 5. Main Script Implementation (src/multi-channel-sync.ts)
-
-> **⚠️ RUNTIME COMPATIBILITY NOTE:**
-> This template includes `import { Buffer } from 'node:buffer';` for Deno/Versori compatibility.
-> While Buffer is globally available in Node.js and this import is optional for Node.js-only deployments,
-> including it ensures the code works across all runtimes (Node.js, Deno, Versori) without modification.
-
-```typescript
-import 'dotenv/config';
-import { Buffer } from 'node:buffer'; // Required for Deno/Versori runtime compatibility
-
-// FC Connect SDK+
-// Install: npm install @fluentcommerce/fc-connect-sdk@latest
-// Docs: https://www.npmjs.com/package/@fluentcommerce/fc-connect-sdk
-// GitHub: https://github.com/fluentcommerce/fc-connect-sdk
-
-import {
-  createClient,
-  type FluentClient,
-  type StructuredLogger,
-  createConsoleLogger,
-  toStructuredLogger
-} from '@fluentcommerce/fc-connect-sdk';
-
-import axios, { AxiosInstance } from 'axios';
-import pLimit from 'p-limit';
-
-// ============================================================================
-// TYPES & INTERFACES
-// ============================================================================
-
-interface InventoryPosition {
-  productRef: string;
-  locationRef: string;
-  quantity: number;
-  onHand: number;
-  available: number;
-  reserved: number;
-}
-
-interface ChannelConfig {
-  enabled: boolean;
-  apiClient: AxiosInstance;
-  bufferStock: number;
-  rateLimit: number;
-}
-
-interface SyncMetrics {
-  startTime: Date;
-  endTime?: Date;
-  totalSKUs: number;
-  successfulUpdates: number;
-  failedUpdates: number;
-  skippedUpdates: number;
-  errors: Array<{ sku: string; channel: string; error: string }>;
-  rateLimitHits: number;
-  avgResponseTime: number;
-}
-
-// ============================================================================
-// CONFIGURATION
-// ============================================================================
-
-const config = {
-  fluent: {
-    baseUrl: process.env.FLUENT_BASE_URL!,
-    clientId: process.env.FLUENT_CLIENT_ID!,
-    clientSecret: process.env.FLUENT_CLIENT_SECRET!,
-    retailerId: process.env.FLUENT_RETAILER_ID!,
-  },
-  amazon: {
-    enabled: process.env.AMAZON_ENABLED === 'true',
-    clientId: process.env.AMAZON_CLIENT_ID!,
-    clientSecret: process.env.AMAZON_CLIENT_SECRET!,
-    refreshToken: process.env.AMAZON_REFRESH_TOKEN!,
-    marketplaceId: process.env.AMAZON_MARKETPLACE_ID!,
-    sellerId: process.env.AMAZON_SELLER_ID!,
-    bufferStock: parseInt(process.env.AMAZON_BUFFER_STOCK || '5'),
-    rateLimit: parseInt(process.env.AMAZON_RATE_LIMIT || '10'),
-  },
-  ebay: {
-    enabled: process.env.EBAY_ENABLED === 'true',
-    appId: process.env.EBAY_APP_ID!,
-    certId: process.env.EBAY_CERT_ID!,
-    authToken: process.env.EBAY_AUTH_TOKEN!,
-    siteId: process.env.EBAY_SITE_ID || '0',
-    bufferStock: parseInt(process.env.EBAY_BUFFER_STOCK || '3'),
-    rateLimit: parseInt(process.env.EBAY_RATE_LIMIT || '5'),
-  },
-  walmart: {
-    enabled: process.env.WALMART_ENABLED === 'true',
-    clientId: process.env.WALMART_CLIENT_ID!,
-    clientSecret: process.env.WALMART_CLIENT_SECRET!,
-    channelType: process.env.WALMART_CHANNEL_TYPE!,
-    bufferStock: parseInt(process.env.WALMART_BUFFER_STOCK || '10'),
-    rateLimit: parseInt(process.env.WALMART_RATE_LIMIT || '20'),
-  },
-  processing: {
-    concurrency: parseInt(process.env.CONCURRENCY || '10'),
-    metricsEnabled: process.env.METRICS_ENABLED === 'true',
-  },
-};
-
-// ============================================================================
-// MARKETPLACE API CLIENTS
-// ============================================================================
-
-class AmazonAPIClient {
-  private client: AxiosInstance;
-  private accessToken?: string;
-  private tokenExpiry?: Date;
-
-  constructor(
-    private config: typeof config.amazon,
-    private logger: StructuredLogger
-  ) {
-    this.client = axios.create({
-      baseURL: 'https://sellingpartnerapi-na.amazon.com',
-      timeout: 30000,
-    });
-  }
-
-  async ensureAuthenticated(): Promise<void> {
-    if (this.accessToken && this.tokenExpiry && new Date() < this.tokenExpiry) {
-      return; // Token still valid
-    }
-
-    this.logger.info('Refreshing Amazon SP-API access token');
-
-    const response = await axios.post('https://api.amazon.com/auth/o2/token', {
-      grant_type: 'refresh_token',
-      refresh_token: this.config.refreshToken,
-      client_id: this.config.clientId,
-      client_secret: this.config.clientSecret,
-    });
-
-    this.accessToken = response.data.access_token;
-    this.tokenExpiry = new Date(Date.now() + response.data.expires_in * 1000);
-
-    this.logger.info('Amazon SP-API token refreshed successfully');
-  }
-
-  async updateInventory(sku: string, quantity: number): Promise<void> {
-    await this.ensureAuthenticated();
-
-    const payload = {
-      marketplaceId: this.config.marketplaceId,
-      sellerId: this.config.sellerId,
-      feeds: [
-        {
-          feedType: 'POST_INVENTORY_AVAILABILITY_DATA',
-          feedOptions: {
-            encoding: 'UTF-8',
-          },
-          feedContent: this.buildInventoryFeedXml(sku, quantity),
-        },
-      ],
-    };
-
-    await this.client.post('/feeds/2021-06-30/feeds', payload, {
-      headers: {
-        'x-amz-access-token': this.accessToken,
-        'Content-Type': 'application/json',
-      },
-    });
-  }
-
-  private buildInventoryFeedXml(sku: string, quantity: number): string {
-    return `<?xml version="1.0" encoding="UTF-8"?>
-<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amzn-envelope.xsd">
-  <Header>
-    <DocumentVersion>1.01</DocumentVersion>
-    <MerchantIdentifier>${this.config.sellerId}</MerchantIdentifier>
-  </Header>
-  <MessageType>Inventory</MessageType>
-  <Message>
-    <MessageID>1</MessageID>
-    <OperationType>Update</OperationType>
-    <Inventory>
-      <SKU>${sku}</SKU>
-      <Quantity>${quantity}</Quantity>
-      <FulfillmentLatency>2</FulfillmentLatency>
-    </Inventory>
-  </Message>
-</AmazonEnvelope>`;
-  }
-}
-
-class eBayAPIClient {
-  private client: AxiosInstance;
-
-  constructor(
-    private config: typeof config.ebay,
-    private logger: StructuredLogger
-  ) {
-    this.client = axios.create({
-      baseURL: 'https://api.ebay.com/ws/api.dll',
-      timeout: 30000,
-    });
-  }
-
-  async updateInventory(sku: string, quantity: number): Promise<void> {
-    const xmlRequest = `<?xml version="1.0" encoding="utf-8"?>
-<ReviseInventoryStatusRequest xmlns="urn:ebay:apis:eBLBaseComponents">
-  <RequesterCredentials>
-    <eBayAuthToken>${this.config.authToken}</eBayAuthToken>
-  </RequesterCredentials>
-  <InventoryStatus>
-    <SKU>${sku}</SKU>
-    <Quantity>${quantity}</Quantity>
-  </InventoryStatus>
-</ReviseInventoryStatusRequest>`;
-
-    await this.client.post('', xmlRequest, {
-      headers: {
-        'X-EBAY-API-SITEID': this.config.siteId,
-        'X-EBAY-API-COMPATIBILITY-LEVEL': '967',
-        'X-EBAY-API-CALL-NAME': 'ReviseInventoryStatus',
-        'Content-Type': 'text/xml',
-      },
-    });
-  }
-}
-
-class WalmartAPIClient {
-  private client: AxiosInstance;
-  private accessToken?: string;
-  private tokenExpiry?: Date;
-
-  constructor(
-    private config: typeof config.walmart,
-    private logger: StructuredLogger
-  ) {
-    this.client = axios.create({
-      baseURL: 'https://marketplace.walmartapis.com/v3',
-      timeout: 30000,
-    });
-  }
-
-  async ensureAuthenticated(): Promise<void> {
-    if (this.accessToken && this.tokenExpiry && new Date() < this.tokenExpiry) {
-      return;
-    }
-
-    this.logger.info('Refreshing Walmart Marketplace access token');
-
-    const credentials = Buffer.from(`${this.config.clientId}:${this.config.clientSecret}`).toString(
-      'base64'
-    );
-
-    const response = await axios.post(
-      'https://marketplace.walmartapis.com/v3/token',
-      'grant_type=client_credentials',
-      {
-        headers: {
-          Authorization: `Basic ${credentials}`,
-          'Content-Type': 'application/x-www-form-urlencoded',
-          'WM_SVC.NAME': 'Walmart Marketplace',
-          'WM_QOS.CORRELATION_ID': Date.now().toString(),
-        },
-      }
-    );
-
-    this.accessToken = response.data.access_token;
-    this.tokenExpiry = new Date(Date.now() + response.data.expires_in * 1000);
-
-    this.logger.info('Walmart access token refreshed successfully');
-  }
-
-  async updateInventory(sku: string, quantity: number): Promise<void> {
-    await this.ensureAuthenticated();
-
-    const payload = {
-      sku,
-      quantity: {
-        unit: 'EACH',
-        amount: quantity,
-      },
-    };
-
-    await this.client.put(`/inventory?sku=${sku}`, payload, {
-      headers: {
-        'WM_SEC.ACCESS_TOKEN': this.accessToken,
-        'WM_SVC.NAME': 'Walmart Marketplace',
-        'WM_QOS.CORRELATION_ID': Date.now().toString(),
-        'Content-Type': 'application/json',
-      },
-    });
-  }
-}
-
-// ============================================================================
-// MULTI-CHANNEL INVENTORY SYNCHRONIZER
-// ============================================================================
-
-class MultiChannelInventorySync {
-  private fluentClient: FluentClient;
-  private logger: StructuredLogger;
-  private channels: Map<string, ChannelConfig> = new Map();
-  private metrics: SyncMetrics;
-
-  constructor() {
-    this.logger = toStructuredLogger(createConsoleLogger(), { logLevel: 'info' });
-
-    this.metrics = {
-      startTime: new Date(),
-      totalSKUs: 0,
-      successfulUpdates: 0,
-      failedUpdates: 0,
-      skippedUpdates: 0,
-      errors: [],
-      rateLimitHits: 0,
-      avgResponseTime: 0,
-    };
-  }
-
-  async initialize(): Promise<void> {
-    this.logger.info('Initializing Multi-Channel Inventory Sync');
-
-    // Initialize Fluent Commerce client
-    this.fluentClient = await createClient({ config: config.fluent });
-
-    // Initialize marketplace API clients
-    if (config.amazon.enabled) {
-      const amazonClient = new AmazonAPIClient(config.amazon, this.logger);
-      this.channels.set('amazon', {
-        enabled: true,
-        apiClient: amazonClient as any,
-        bufferStock: config.amazon.bufferStock,
-        rateLimit: config.amazon.rateLimit,
-      });
-      this.logger.info('Amazon SP-API client initialized');
-    }
-
-    if (config.ebay.enabled) {
-      const ebayClient = new eBayAPIClient(config.ebay, this.logger);
-      this.channels.set('ebay', {
-        enabled: true,
-        apiClient: ebayClient as any,
-        bufferStock: config.ebay.bufferStock,
-        rateLimit: config.ebay.rateLimit,
-      });
-      this.logger.info('eBay Trading API client initialized');
-    }
-
-    if (config.walmart.enabled) {
-      const walmartClient = new WalmartAPIClient(config.walmart, this.logger);
-      this.channels.set('walmart', {
-        enabled: true,
-        apiClient: walmartClient as any,
-        bufferStock: config.walmart.bufferStock,
-        rateLimit: config.walmart.rateLimit,
-      });
-      this.logger.info('Walmart Marketplace API client initialized');
-    }
-
-    this.logger.info(`Initialized ${this.channels.size} marketplace channels`);
-  }
-
-  async syncInventory(): Promise<void> {
-    this.logger.info('Starting multi-channel inventory sync');
-    this.metrics.startTime = new Date();
-
-    try {
-      // Step 1: Fetch all ATP inventory from Fluent Commerce
-      const inventory = await this.fetchFluentInventory();
-      this.metrics.totalSKUs = inventory.length;
-
-      this.logger.info(`Fetched ${inventory.length} inventory positions from Fluent`);
-
-      // Step 2: Calculate ATP for each channel with buffer stock
-      const channelInventory = this.calculateChannelInventory(inventory);
-
-      // Step 3: Update each marketplace in parallel with rate limiting
-      await this.updateMarketplaces(channelInventory);
-
-      this.metrics.endTime = new Date();
-      this.logMetrics();
-
-      this.logger.info('Multi-channel inventory sync completed successfully');
-    } catch (error: any) {
-      this.logger.error('Multi-channel inventory sync failed', error);
-      throw error;
-    }
-  }
-
-  private async fetchFluentInventory(): Promise<InventoryPosition[]> {
-    const query = `
-      query GetInventory($retailerId: ID!, $first: Int!, $after: String) {
-        inventoryQuantities(
-          first: $first
-          after: $after
-          retailerId: $retailerId
-          type: "AVAILABLE"
-        ) {
-          edges {
-            node {
-              productRef
-              locationRef
-              quantity
-              onHand
-              available
-              reserved
-            }
-            cursor
-          }
-          pageInfo {
-            hasNextPage
-          }
-        }
-      }
-    `;
-
-    const result = await this.fluentClient.graphql({
-      query,
-      variables: {
-        retailerId: config.fluent.retailerId,
-        first: 250,
-      },
-      pagination: {
-        maxPages: 500,
-      },
-    });
-
-    if (result.errors) {
-      throw new Error(`GraphQL errors: ${JSON.stringify(result.errors)}`);
-    }
-
-    const edges = (result.data as any).inventoryQuantities?.edges || [];
-    return edges.map((edge: any) => edge.node);
-  }
-
-  private calculateChannelInventory(
-    inventory: InventoryPosition[]
-  ): Map<string, Map<string, number>> {
-    const channelInventory = new Map<string, Map<string, number>>();
-
-    for (const [channelName, channelConfig] of this.channels) {
-      const skuQuantities = new Map<string, number>();
-
-      for (const position of inventory) {
-        const atpQuantity = position.available || 0;
-        const channelQuantity = Math.max(0, atpQuantity - channelConfig.bufferStock);
-        skuQuantities.set(position.productRef, channelQuantity);
-      }
-
-      channelInventory.set(channelName, skuQuantities);
-    }
-
-    return channelInventory;
-  }
-
-  private async updateMarketplaces(
-    channelInventory: Map<string, Map<string, number>>
-  ): Promise<void> {
-    const updatePromises: Promise<void>[] = [];
-
-    for (const [channelName, skuQuantities] of channelInventory) {
-      const channelConfig = this.channels.get(channelName)!;
-      const limit = pLimit(channelConfig.rateLimit);
-
-      const channelPromises = Array.from(skuQuantities.entries()).map(([sku, quantity]) =>
-        limit(async () => {
-          try {
-            const startTime = Date.now();
-
-            if (channelName === 'amazon') {
-              await (channelConfig.apiClient as any).updateInventory(sku, quantity);
-            } else if (channelName === 'ebay') {
-              await (channelConfig.apiClient as any).updateInventory(sku, quantity);
-            } else if (channelName === 'walmart') {
-              await (channelConfig.apiClient as any).updateInventory(sku, quantity);
-            }
-
-            const duration = Date.now() - startTime;
-            this.metrics.successfulUpdates++;
-
-            this.logger.debug(`Updated ${channelName} inventory for ${sku}: ${quantity}`, {
-              duration,
-            });
-          } catch (error: any) {
-            this.metrics.failedUpdates++;
-            this.metrics.errors.push({
-              sku,
-              channel: channelName,
-              error: error.message,
-            });
-
-            if (error.response?.status === 429) {
-              this.metrics.rateLimitHits++;
-            }
-
-            this.logger.warn(`Failed to update ${channelName} inventory for ${sku}`, {
-              error: error.message,
-              status: error.response?.status,
-            });
-          }
-        })
-      );
-
-      updatePromises.push(...channelPromises);
-    }
-
-    await Promise.all(updatePromises);
-  }
-
-  private logMetrics(): void {
-    if (!config.processing.metricsEnabled) return;
-
-    const duration = this.metrics.endTime
-      ? (this.metrics.endTime.getTime() - this.metrics.startTime.getTime()) / 1000
-      : 0;
-
-    this.logger.info('='.repeat(80));
-    this.logger.info('SYNC METRICS', {
-      duration: `${duration.toFixed(2)}s`,
-      totalSKUs: this.metrics.totalSKUs,
-      successfulUpdates: this.metrics.successfulUpdates,
-      failedUpdates: this.metrics.failedUpdates,
-      skippedUpdates: this.metrics.skippedUpdates,
-      successRate: `${((this.metrics.successfulUpdates / (this.metrics.successfulUpdates + this.metrics.failedUpdates)) * 100).toFixed(2)}%`,
-      rateLimitHits: this.metrics.rateLimitHits,
-      errorCount: this.metrics.errors.length,
-    });
-
-    if (this.metrics.errors.length > 0) {
-      this.logger.warn('Error summary (first 10):', {
-        errors: this.metrics.errors.slice(0, 10),
-      });
-    }
-
-    this.logger.info('='.repeat(80));
-  }
-}
-
-// ============================================================================
-// MAIN ENTRY POINT
-// ============================================================================
-
-async function main() {
-  const sync = new MultiChannelInventorySync();
-
-  try {
-    await sync.initialize();
-    await sync.syncInventory();
-
-    console.log('Multi-channel inventory sync completed successfully');
-    process.exit(0);
-  } catch (error: any) {
-    console.error('Fatal error:', error);
-    process.exit(1);
-  }
-}
-
-// Run if executed directly
-if (require.main === module) {
-  main();
-}
-
-export { MultiChannelInventorySync };
-```
-
----
-
-## Key Patterns Explained
-
-### Pattern 1: GraphQL Auto-Pagination for Large Datasets
-
-**Challenge**: Efficiently fetch 10k-100k inventory positions without manual pagination logic
-
-**Solution**: Use SDK's built-in auto-pagination with progress callbacks
-
-```javascript
-const result = await fluentClient.graphql({
-  query,
-  variables: { retailerId, first: 200 },
-  pagination: {
-    maxRecords: 100000,
-    maxPages: 500,
-  },
-});
-```
-
-**Why This Works**:
-
-- **Automatic**: No manual cursor tracking needed
-- **Safe**: Built-in protections against infinite loops
-- **Efficient**: Streams data as it's received
-- **Observable**: Progress callbacks for monitoring
-
-### Pattern 2: ATP Aggregation with Location Rollup
-
-**Challenge**: Calculate total Available-to-Promise across multiple warehouses/stores per SKU
-
-**Solution**: Map-based aggregation with location tracking
-
-```javascript
-function aggregateATP(inventoryPositions) {
-  const atpMap = new Map();
-  for (const position of inventoryPositions) {
-    const sku = position.productRef;
-    const availableQty = Math.max(0, position.availableQty || 0);
-
-    if (!atpMap.has(sku)) {
-      atpMap.set(sku, {
-        sku,
-        totalATP: 0,
-        locations: [],
-        lastUpdated: position.updatedOn,
-      });
-    }
-
-    const aggregated = atpMap.get(sku);
-    aggregated.totalATP += availableQty;
-    aggregated.locations.push({
-      locationRef: position.locationRef,
-      availableQty: availableQty,
-    });
-  }
-  return atpMap;
-}
-```
-
-**Why This Works**:
-
-- **O(n) complexity**: Single pass through inventory
-- **Location visibility**: Track which locations contribute to total
-- **Negative protection**: `Math.max(0, ...)` prevents negative ATP
-- **Timestamp tracking**: Know when inventory was last updated
-
-### Pattern 3: Marketplace-Specific Buffer Stock
-
-**Challenge**: Different marketplaces need different safety buffers to prevent overselling
-
-**Solution**: Configurable buffer per marketplace
-
-```javascript
-// Configuration
-const buffers = {
-  amazon: 5, // Lower buffer (fast fulfillment)
-  ebay: 3, // Moderate buffer
-  walmart: 10, // Higher buffer (longer fulfillment)
-};
-
-// Application
-function applyBufferStock(totalATP, bufferStock) {
-  return Math.max(0, totalATP - bufferStock);
-}
-
-// Example: SKU with 50 ATP across all locations
-const amazonQty = applyBufferStock(50, 5); // 45 available on Amazon
-const ebayQty = applyBufferStock(50, 3); // 47 available on eBay
-const walmartQty = applyBufferStock(50, 10); // 40 available on Walmart
-```
-
-**Why This Works**:
-
-- **Oversell prevention**: Accounts for sync delays and processing time
-- **Marketplace flexibility**: Different risk profiles per marketplace
-- **Safety floor**: `Math.max(0, ...)` ensures quantity never goes negative
-- **Configurable**: Easy to adjust per marketplace requirements
-
-### Pattern 4: Parallel Marketplace Updates with Rate Limiting
-
-**Challenge**: Update multiple marketplaces efficiently without exceeding API rate limits
-
-**Solution**: Parallel execution with per-marketplace rate limiters
-
-```javascript
-import pLimit from 'p-limit';
-
-// Each marketplace has its own rate limiter
-class AmazonMarketplace {
-  constructor(config) {
-    this.limiter = pLimit(config.rateLimit); // 10 req/sec
-  }
-
-  async updateInventory(sku, quantity) {
-    // Rate-limited execution
-    return this.limiter(() => this.makeApiCall(sku, quantity));
-  }
-}
-
-// Parallel sync across all marketplaces
-const syncResults = await Promise.all(
-  marketplaces.map(marketplace => marketplace.syncInventory(atpMap))
-);
-```
-
-**Why This Works**:
-
-- **Parallel execution**: All marketplaces sync simultaneously
-- **Independent rate limits**: Each marketplace respects its own limits
-- **Error isolation**: Failure in one marketplace doesn't affect others
-- **Concurrency control**: p-limit prevents overwhelming APIs
-
-### Pattern 5: Exponential Backoff Retry Strategy
-
-**Challenge**: Handle transient API failures (429 rate limits, 500 server errors)
-
-**Solution**: p-retry with exponential backoff
-
-```javascript
-import pRetry from 'p-retry';
-
-async updateInventory(sku, quantity) {
-  return pRetry(
-    async () => {
-      // Attempt API call
-      const response = await axios.put(endpoint, payload);
-
-      // Check for retryable errors
-      if (response.status === 429) {
-        throw new Error('Rate limit exceeded'); // Will retry
-      }
-
-      return response.data;
-    },
-    {
-      retries: 3,
-      factor: 2,         // Exponential backoff factor
-      minTimeout: 1000,  // 1s, 2s, 4s delays
-      onFailedAttempt: error => {
-        logger.warn(`Retry attempt ${error.attemptNumber}`, {
-          retriesLeft: error.retriesLeft,
-        });
-      },
-    }
-  );
-}
-```
-
-**Why This Works**:
-
-- **Transient failure recovery**: Handles temporary API issues
-- **Exponential backoff**: Reduces load on overloaded APIs
-- **Configurable retries**: 3 attempts is reasonable for most cases
-- **Observable**: Logs each retry attempt for debugging
-
-### Pattern 6: SLA Tracking and Compliance
-
-**Challenge**: Ensure sync completes within 15-minute SLA requirement
-
-**Solution**: Duration tracking with SLA compliance check
-
-```javascript
-function checkSLA(durationMs) {
-  const durationMinutes = durationMs / 60000;
-  const slaThreshold = 15; // 15-minute requirement
-  const slaMet = durationMinutes <= slaThreshold;
-
-  if (!slaMet) {
-    logger.warn('SLA BREACH: Sync exceeded threshold', {
-      durationMinutes: durationMinutes.toFixed(2),
-      threshold: slaThreshold,
-    });
-    metrics.increment('sla_breaches');
-    // Alert via PagerDuty, Slack, etc.
-  }
-
-  return slaMet;
-}
-```
-
-**Why This Works**:
-
-- **Clear threshold**: 15 minutes is measurable and actionable
-- **Automated detection**: No manual checking needed
-- **Alerting hook**: Can trigger notifications on breach
-- **Metrics tracking**: Historical SLA compliance data
-
-### Pattern 7: Dry-Run Mode for Safe Testing
-
-**Challenge**: Test sync logic without actually updating marketplaces
-
-**Solution**: Dry-run flag that short-circuits API calls
-
-```javascript
-async updateInventory(sku, quantity, dryRun = false) {
-  if (dryRun) {
-    this.logger.info(`[DRY RUN] Would update inventory`, { sku, quantity });
-    return { success: true, sku, quantity, dryRun: true };
-  }
-
-  // Real API call
-  return this.makeApiCall(sku, quantity);
-}
-
-// Usage
-npm run sync:dry-run
-```
-
-**Why This Works**:
-
-- **Safe testing**: Validate logic without side effects
-- **End-to-end flow**: Tests everything except final API call
-- **Easy toggle**: Environment variable or CLI flag
-- **Visible logging**: Clear indication of dry-run mode
-
----
-
-## Testing
-
-### Dry-Run Test
-
-```bash
-# Test sync without updating marketplaces
-DRY_RUN=true npm run sync:once
-
-# Expected output:
-# [DRY RUN] Would update Amazon inventory { sku: 'PROD-001', quantity: 45 }
-# [DRY RUN] Would update eBay inventory { sku: 'PROD-001', quantity: 47 }
-# [DRY RUN] Would update Walmart inventory { sku: 'PROD-001', quantity: 40 }
-```
-
-### Single Sync Execution
-
-```bash
-# Run once and exit
-npm run sync:once
-
-# Check logs
-cat logs/inventory-sync.log | grep "COMPLETE"
-```
-
-### Continuous Sync Mode
-
-```bash
-# Run continuously (every 15 minutes)
-npm run sync:continuous
-
-# Check next sync time in logs
-```
-
----
-
-## Deployment Options
-
-### Option 1: Docker Container
-
-Create `Dockerfile`:
-
-```dockerfile
-FROM node:18-alpine
-
-WORKDIR /app
-
-# Copy package files
-COPY package*.json ./
-
-# Install dependencies
-RUN npm ci --only=production
-
-# Copy application code
-COPY src ./src
-
-# Create state directory
-RUN mkdir -p /app/state
-
-# Run continuous sync
-CMD ["node", "src/index.js"]
-```
-
-Build and run:
-
-```bash
-# Build image
-docker build -t multi-channel-sync .
-
-# Run container
-docker run -d \
-  --name inventory-sync \
-  --env-file .env \
-  --restart unless-stopped \
-  --volume ./state:/app/state \
-  multi-channel-sync
-```
-
-### Option 2: AWS ECS Task
-
-Create `ecs-task-definition.json`:
-
-```json
-{
-  "family": "multi-channel-inventory-sync",
-  "networkMode": "awsvpc",
-  "requiresCompatibilities": ["FARGATE"],
-  "cpu": "1024",
-  "memory": "2048",
-  "containerDefinitions": [
-    {
-      "name": "inventory-sync",
-      "image": "your-registry/multi-channel-sync:latest",
-      "essential": true,
-      "environment": [
-        { "name": "LOG_LEVEL", "value": "info" },
-        { "name": "SYNC_INTERVAL_MINUTES", "value": "15" }
-      ],
-      "secrets": [
-        {
-          "name": "FLUENT_CLIENT_ID",
-          "valueFrom": "arn:aws:secretsmanager:us-east-1:123:secret:fluent-client-id"
-        }
-      ],
-      "logConfiguration": {
-        "logDriver": "awslogs",
-        "options": {
-          "awslogs-group": "/ecs/inventory-sync",
-          "awslogs-region": "us-east-1",
-          "awslogs-stream-prefix": "ecs"
-        }
-      }
-    }
-  ]
-}
-```
-
-Deploy:
-
-```bash
-aws ecs register-task-definition --cli-input-json file://ecs-task-definition.json
-aws ecs create-service \
-  --cluster production \
-  --service-name inventory-sync \
-  --task-definition multi-channel-inventory-sync \
-  --desired-count 1 \
-  --launch-type FARGATE
-```
-
----
-
-## Common Issues & Solutions
-
-### Issue 1: SLA Breach (Sync Takes >15 Minutes)
-
-**Symptoms**:
-
-- Log shows "SLA BREACH" warning
-- Sync duration exceeds 15 minutes
-
-**Solutions**:
-
-1. **Reduce page size** (faster initial response):
-
-```javascript
-variables: {
-  first: 100;
-} // Instead of 200
-```
-
-2. **Increase parallelism**:
-
-```javascript
-const limiter = pLimit(20); // Increase from 10
-```
-
-3. **Optimize marketplace rate limits** (if APIs allow):
-
-```bash
-AMAZON_RATE_LIMIT=20  # Increase from 10
-```
-
-4. **Split sync by marketplace** (run separately):
-
-```bash
-AMAZON_ENABLED=true EBAY_ENABLED=false WALMART_ENABLED=false npm run sync:once
-```
-
----
-
-## Related Guides
-
-- **GraphQL Query Export**: [`./graphql-query-export.md`](./graphql-query-export.md) - GraphQL pagination patterns
-- **Multi-Source Aggregation**: `./04-multi-source-aggregation.md` - Data aggregation strategies
-- **Error Handling Patterns**: `../../03-PATTERN-GUIDES/error-handling/readme.md` - Retry and error handling
-- **Universal Mapping Guide**: `../../02-CORE-GUIDES/mapping/readme.md` - Field transformations
-- **SDK API Reference**: `../../readme.md` - Core SDK documentation
-
----
-
-## Production Checklist
-
-Before deploying to production:
-
-- [ ] All marketplace credentials secured (AWS Secrets Manager, Vault)
-- [ ] Rate limits configured per marketplace API documentation
-- [ ] Buffer stock values tested and approved by business
-- [ ] SLA threshold aligned with business requirements
-- [ ] Monitoring dashboards created (sync duration, SLA compliance, error rates)
-- [ ] Alerting configured (PagerDuty, Slack, email)
-- [ ] Dry-run testing completed with production data
-- [ ] Load testing with 100k+ SKUs
-- [ ] State management enabled to prevent duplicate processing
-- [ ] Logging configured (CloudWatch, Datadog, Splunk)
-- [ ] Error tracking integrated (Sentry, Rollbar)
-- [ ] Documentation updated with runbooks
-- [ ] On-call team trained on troubleshooting
-- [ ] Disaster recovery plan documented
-- [ ] Metrics baseline established (average sync duration, success rate)
-
----
-
-**Next Steps**:
-
-1. Customize buffer stock values per marketplace and product category
-2. Implement incremental sync (only process changed inventory)
-3. Add webhook integration for real-time inventory updates
-4. Set up monitoring dashboards (Grafana, Datadog)
-5. Integrate with incident management (PagerDuty)
-6. Add marketplace-specific SKU mapping (Fluent SKU → Marketplace SKU)
-7. Implement A/B testing for buffer stock optimization
-
-**Support**:
-
-- SDK Issues: https://github.com/fluentcommerce/fc-connect-sdk/issues
-- Fluent Commerce API: https://docs.fluentcommerce.com
-- Amazon SP-API: https://developer-docs.amazon.com/sp-api/
-- eBay Trading API: https://developer.ebay.com/devzone/xml/docs/reference/ebay/
-- Walmart Seller API: https://developer.walmart.com/
+# Standalone: Multi-Channel Inventory Sync (Real-Time ATP to Marketplaces)
+
+**FC Connect SDK Use Case Guide**
+
+> **SDK**: [@fluentcommerce/fc-connect-sdk](https://www.npmjs.com/package/@fluentcommerce/fc-connect-sdk)
+> **Version**: Use latest - `npm install @fluentcommerce/fc-connect-sdk@latest`
+
+**Context**: Node.js script that aggregates Available-to-Promise (ATP) inventory from Fluent Commerce and pushes real-time updates to multiple marketplaces (Amazon, eBay, Walmart)
+
+**Complexity**: High
+
+**Runtime**: Node.js >=18
+
+**Estimated Lines**: ~950 lines
+
+**Volume**: Large (10k-100k SKUs, multiple marketplaces)
+
+**Latency**: Near real-time (every 5-15 min)
+
+**Pattern**: GraphQL pagination → external marketplace APIs
+
+## What You'll Build
+
+- OAuth2-authenticated Fluent Commerce client
+- GraphQL query with auto-pagination for inventory positions
+- ATP (Available-to-Promise) aggregation across multiple locations
+- Marketplace-specific buffer stock calculations
+- Parallel marketplace updates with rate limiting:
+  - Amazon MWS/SP-API integration
+  - eBay Trading API integration
+  - Walmart Seller API integration
+- Per-marketplace error handling and retry logic
+- SLA tracking (15-minute sync requirement)
+- Comprehensive metrics and logging
+- Dry-run mode for testing
+- State management to prevent duplicate updates
+
+## SDK Methods Used
+
+- `createClient({ config: { baseUrl, clientId, clientSecret, retailerId } })` - OAuth2 client
+- `client.graphql({ query, variables, pagination })` - Query with auto-pagination
+- `UniversalMapper(mappingConfig)` - Transform Fluent data to marketplace formats
+- `createConsoleLogger()` - Simple console logger
+- `toStructuredLogger(logger, context)` - Add context to logs
+- `generateCorrelationId()` - Generate unique correlation IDs
+- State tracking for incremental updates
+
+---
+
+## Complete Working Implementation
+
+### 1. Project Setup
+
+```bash
+# Create project directory
+mkdir multi-channel-inventory-sync
+cd multi-channel-inventory-sync
+
+# Initialize Node.js project
+npm init -y
+
+# Install dependencies
+npm install @fluentcommerce/fc-connect-sdk dotenv axios p-limit p-retry
+```
+
+### 2. Environment Configuration
+
+Create `.env` file:
+
+```bash
+# Fluent Commerce OAuth2
+FLUENT_BASE_URL=https://api.fluentcommerce.com
+FLUENT_CLIENT_ID=your-oauth2-client-id
+FLUENT_CLIENT_SECRET=your-oauth2-client-secret
+FLUENT_RETAILER_ID=your-retailer-id
+
+# Sync Configuration
+SYNC_INTERVAL_MINUTES=15
+SLA_THRESHOLD_MINUTES=15
+MAX_RECORDS_PER_SYNC=100000
+DRY_RUN=false
+
+# Amazon SP-API Credentials
+AMAZON_ENABLED=true
+AMAZON_MARKETPLACE_ID=ATVPDKIKX0DER
+AMAZON_SELLER_ID=your-amazon-seller-id
+AMAZON_REFRESH_TOKEN=your-amazon-refresh-token
+AMAZON_CLIENT_ID=amzn1.application-oa2-client.xxxxx
+AMAZON_CLIENT_SECRET=your-amazon-client-secret
+AMAZON_AWS_ACCESS_KEY_ID=your-aws-access-key
+AMAZON_AWS_SECRET_ACCESS_KEY=your-aws-secret-key
+AMAZON_REGION=us-east-1
+AMAZON_ROLE_ARN=arn:aws:iam::123456789:role/SellingPartnerAPI
+AMAZON_BUFFER_STOCK=5
+AMAZON_RATE_LIMIT=10
+
+# eBay Trading API Credentials
+EBAY_ENABLED=true
+EBAY_APP_ID=your-ebay-app-id
+EBAY_DEV_ID=your-ebay-dev-id
+EBAY_CERT_ID=your-ebay-cert-id
+EBAY_AUTH_TOKEN=your-ebay-auth-token
+EBAY_SITE_ID=0
+EBAY_SANDBOX=false
+EBAY_BUFFER_STOCK=3
+EBAY_RATE_LIMIT=5
+
+# Walmart Seller API Credentials
+WALMART_ENABLED=true
+WALMART_CLIENT_ID=your-walmart-client-id
+WALMART_CLIENT_SECRET=your-walmart-client-secret
+WALMART_CHANNEL_TYPE=0a7d6c3e-e9a0-4a0c-8d6a-f6c6f1e7a5c7
+WALMART_BUFFER_STOCK=10
+WALMART_RATE_LIMIT=20
+
+# Logging
+LOG_LEVEL=info
+METRICS_ENABLED=true
+```
+
+### 3. Package Configuration
+
+Create `package.json`:
+
+```json
+{
+  "name": "multi-channel-inventory-sync",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Real-time ATP inventory sync from Fluent Commerce to multiple marketplaces",
+  "main": "src/index.js",
+  "scripts": {
+    "start": "node src/index.js",
+    "sync:once": "node src/index.js --once",
+    "sync:continuous": "node src/index.js",
+    "sync:dry-run": "DRY_RUN=true node src/index.js --once",
+    "test": "node --test tests/**/*.test.js"
+  },
+  "dependencies": {
+    "@fluentcommerce/fc-connect-sdk": "^0.1.39",
+    "axios": "^1.6.0",
+    "dotenv": "^16.0.0",
+    "p-limit": "^5.0.0",
+    "p-retry": "^6.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}
+```
+
+### 4. TypeScript Configuration (tsconfig.json)
+
+```json
+{
+  "compilerOptions": {
+    "module": "ES2022",
+    "target": "ES2024",
+    "moduleResolution": "node"
+  }
+}
+```
+
+### 5. Main Script Implementation (src/multi-channel-sync.ts)
+
+> **⚠️ RUNTIME COMPATIBILITY NOTE:**
+> This template includes `import { Buffer } from 'node:buffer';` for Deno/Versori compatibility.
+> While Buffer is globally available in Node.js and this import is optional for Node.js-only deployments,
+> including it ensures the code works across all runtimes (Node.js, Deno, Versori) without modification.
+
+```typescript
+import 'dotenv/config';
+import { Buffer } from 'node:buffer'; // Required for Deno/Versori runtime compatibility
+
+// FC Connect SDK+
+// Install: npm install @fluentcommerce/fc-connect-sdk@latest
+// Docs: https://www.npmjs.com/package/@fluentcommerce/fc-connect-sdk
+// GitHub: https://github.com/fluentcommerce/fc-connect-sdk
+
+import {
+  createClient,
+  type FluentClient,
+  type StructuredLogger,
+  createConsoleLogger,
+  toStructuredLogger
+} from '@fluentcommerce/fc-connect-sdk';
+
+import axios, { AxiosInstance } from 'axios';
+import pLimit from 'p-limit';
+
+// ============================================================================
+// TYPES & INTERFACES
+// ============================================================================
+
+interface InventoryPosition {
+  productRef: string;
+  locationRef: string;
+  quantity: number;
+  onHand: number;
+  available: number;
+  reserved: number;
+}
+
+interface ChannelConfig {
+  enabled: boolean;
+  apiClient: AxiosInstance;
+  bufferStock: number;
+  rateLimit: number;
+}
+
+interface SyncMetrics {
+  startTime: Date;
+  endTime?: Date;
+  totalSKUs: number;
+  successfulUpdates: number;
+  failedUpdates: number;
+  skippedUpdates: number;
+  errors: Array<{ sku: string; channel: string; error: string }>;
+  rateLimitHits: number;
+  avgResponseTime: number;
+}
+
+// ============================================================================
+// CONFIGURATION
+// ============================================================================
+
+const config = {
+  fluent: {
+    baseUrl: process.env.FLUENT_BASE_URL!,
+    clientId: process.env.FLUENT_CLIENT_ID!,
+    clientSecret: process.env.FLUENT_CLIENT_SECRET!,
+    retailerId: process.env.FLUENT_RETAILER_ID!,
+  },
+  amazon: {
+    enabled: process.env.AMAZON_ENABLED === 'true',
+    clientId: process.env.AMAZON_CLIENT_ID!,
+    clientSecret: process.env.AMAZON_CLIENT_SECRET!,
+    refreshToken: process.env.AMAZON_REFRESH_TOKEN!,
+    marketplaceId: process.env.AMAZON_MARKETPLACE_ID!,
+    sellerId: process.env.AMAZON_SELLER_ID!,
+    bufferStock: parseInt(process.env.AMAZON_BUFFER_STOCK || '5'),
+    rateLimit: parseInt(process.env.AMAZON_RATE_LIMIT || '10'),
+  },
+  ebay: {
+    enabled: process.env.EBAY_ENABLED === 'true',
+    appId: process.env.EBAY_APP_ID!,
+    certId: process.env.EBAY_CERT_ID!,
+    authToken: process.env.EBAY_AUTH_TOKEN!,
+    siteId: process.env.EBAY_SITE_ID || '0',
+    bufferStock: parseInt(process.env.EBAY_BUFFER_STOCK || '3'),
+    rateLimit: parseInt(process.env.EBAY_RATE_LIMIT || '5'),
+  },
+  walmart: {
+    enabled: process.env.WALMART_ENABLED === 'true',
+    clientId: process.env.WALMART_CLIENT_ID!,
+    clientSecret: process.env.WALMART_CLIENT_SECRET!,
+    channelType: process.env.WALMART_CHANNEL_TYPE!,
+    bufferStock: parseInt(process.env.WALMART_BUFFER_STOCK || '10'),
+    rateLimit: parseInt(process.env.WALMART_RATE_LIMIT || '20'),
+  },
+  processing: {
+    concurrency: parseInt(process.env.CONCURRENCY || '10'),
+    metricsEnabled: process.env.METRICS_ENABLED === 'true',
+  },
+};
+
+// ============================================================================
+// MARKETPLACE API CLIENTS
+// ============================================================================
+
+class AmazonAPIClient {
+  private client: AxiosInstance;
+  private accessToken?: string;
+  private tokenExpiry?: Date;
+
+  constructor(
+    private config: typeof config.amazon,
+    private logger: StructuredLogger
+  ) {
+    this.client = axios.create({
+      baseURL: 'https://sellingpartnerapi-na.amazon.com',
+      timeout: 30000,
+    });
+  }
+
+  async ensureAuthenticated(): Promise<void> {
+    if (this.accessToken && this.tokenExpiry && new Date() < this.tokenExpiry) {
+      return; // Token still valid
+    }
+
+    this.logger.info('Refreshing Amazon SP-API access token');
+
+    const response = await axios.post('https://api.amazon.com/auth/o2/token', {
+      grant_type: 'refresh_token',
+      refresh_token: this.config.refreshToken,
+      client_id: this.config.clientId,
+      client_secret: this.config.clientSecret,
+    });
+
+    this.accessToken = response.data.access_token;
+    this.tokenExpiry = new Date(Date.now() + response.data.expires_in * 1000);
+
+    this.logger.info('Amazon SP-API token refreshed successfully');
+  }
+
+  async updateInventory(sku: string, quantity: number): Promise<void> {
+    await this.ensureAuthenticated();
+
+    const payload = {
+      marketplaceId: this.config.marketplaceId,
+      sellerId: this.config.sellerId,
+      feeds: [
+        {
+          feedType: 'POST_INVENTORY_AVAILABILITY_DATA',
+          feedOptions: {
+            encoding: 'UTF-8',
+          },
+          feedContent: this.buildInventoryFeedXml(sku, quantity),
+        },
+      ],
+    };
+
+    await this.client.post('/feeds/2021-06-30/feeds', payload, {
+      headers: {
+        'x-amz-access-token': this.accessToken,
+        'Content-Type': 'application/json',
+      },
+    });
+  }
+
+  private buildInventoryFeedXml(sku: string, quantity: number): string {
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amzn-envelope.xsd">
+  <Header>
+    <DocumentVersion>1.01</DocumentVersion>
+    <MerchantIdentifier>${this.config.sellerId}</MerchantIdentifier>
+  </Header>
+  <MessageType>Inventory</MessageType>
+  <Message>
+    <MessageID>1</MessageID>
+    <OperationType>Update</OperationType>
+    <Inventory>
+      <SKU>${sku}</SKU>
+      <Quantity>${quantity}</Quantity>
+      <FulfillmentLatency>2</FulfillmentLatency>
+    </Inventory>
+  </Message>
+</AmazonEnvelope>`;
+  }
+}
+
+class eBayAPIClient {
+  private client: AxiosInstance;
+
+  constructor(
+    private config: typeof config.ebay,
+    private logger: StructuredLogger
+  ) {
+    this.client = axios.create({
+      baseURL: 'https://api.ebay.com/ws/api.dll',
+      timeout: 30000,
+    });
+  }
+
+  async updateInventory(sku: string, quantity: number): Promise<void> {
+    const xmlRequest = `<?xml version="1.0" encoding="utf-8"?>
+<ReviseInventoryStatusRequest xmlns="urn:ebay:apis:eBLBaseComponents">
+  <RequesterCredentials>
+    <eBayAuthToken>${this.config.authToken}</eBayAuthToken>
+  </RequesterCredentials>
+  <InventoryStatus>
+    <SKU>${sku}</SKU>
+    <Quantity>${quantity}</Quantity>
+  </InventoryStatus>
+</ReviseInventoryStatusRequest>`;
+
+    await this.client.post('', xmlRequest, {
+      headers: {
+        'X-EBAY-API-SITEID': this.config.siteId,
+        'X-EBAY-API-COMPATIBILITY-LEVEL': '967',
+        'X-EBAY-API-CALL-NAME': 'ReviseInventoryStatus',
+        'Content-Type': 'text/xml',
+      },
+    });
+  }
+}
+
+class WalmartAPIClient {
+  private client: AxiosInstance;
+  private accessToken?: string;
+  private tokenExpiry?: Date;
+
+  constructor(
+    private config: typeof config.walmart,
+    private logger: StructuredLogger
+  ) {
+    this.client = axios.create({
+      baseURL: 'https://marketplace.walmartapis.com/v3',
+      timeout: 30000,
+    });
+  }
+
+  async ensureAuthenticated(): Promise<void> {
+    if (this.accessToken && this.tokenExpiry && new Date() < this.tokenExpiry) {
+      return;
+    }
+
+    this.logger.info('Refreshing Walmart Marketplace access token');
+
+    const credentials = Buffer.from(`${this.config.clientId}:${this.config.clientSecret}`).toString(
+      'base64'
+    );
+
+    const response = await axios.post(
+      'https://marketplace.walmartapis.com/v3/token',
+      'grant_type=client_credentials',
+      {
+        headers: {
+          Authorization: `Basic ${credentials}`,
+          'Content-Type': 'application/x-www-form-urlencoded',
+          'WM_SVC.NAME': 'Walmart Marketplace',
+          'WM_QOS.CORRELATION_ID': Date.now().toString(),
+        },
+      }
+    );
+
+    this.accessToken = response.data.access_token;
+    this.tokenExpiry = new Date(Date.now() + response.data.expires_in * 1000);
+
+    this.logger.info('Walmart access token refreshed successfully');
+  }
+
+  async updateInventory(sku: string, quantity: number): Promise<void> {
+    await this.ensureAuthenticated();
+
+    const payload = {
+      sku,
+      quantity: {
+        unit: 'EACH',
+        amount: quantity,
+      },
+    };
+
+    await this.client.put(`/inventory?sku=${sku}`, payload, {
+      headers: {
+        'WM_SEC.ACCESS_TOKEN': this.accessToken,
+        'WM_SVC.NAME': 'Walmart Marketplace',
+        'WM_QOS.CORRELATION_ID': Date.now().toString(),
+        'Content-Type': 'application/json',
+      },
+    });
+  }
+}
+
+// ============================================================================
+// MULTI-CHANNEL INVENTORY SYNCHRONIZER
+// ============================================================================
+
+class MultiChannelInventorySync {
+  private fluentClient: FluentClient;
+  private logger: StructuredLogger;
+  private channels: Map<string, ChannelConfig> = new Map();
+  private metrics: SyncMetrics;
+
+  constructor() {
+    this.logger = toStructuredLogger(createConsoleLogger(), { logLevel: 'info' });
+
+    this.metrics = {
+      startTime: new Date(),
+      totalSKUs: 0,
+      successfulUpdates: 0,
+      failedUpdates: 0,
+      skippedUpdates: 0,
+      errors: [],
+      rateLimitHits: 0,
+      avgResponseTime: 0,
+    };
+  }
+
+  async initialize(): Promise<void> {
+    this.logger.info('Initializing Multi-Channel Inventory Sync');
+
+    // Initialize Fluent Commerce client
+    this.fluentClient = await createClient({ config: config.fluent });
+
+    // Initialize marketplace API clients
+    if (config.amazon.enabled) {
+      const amazonClient = new AmazonAPIClient(config.amazon, this.logger);
+      this.channels.set('amazon', {
+        enabled: true,
+        apiClient: amazonClient as any,
+        bufferStock: config.amazon.bufferStock,
+        rateLimit: config.amazon.rateLimit,
+      });
+      this.logger.info('Amazon SP-API client initialized');
+    }
+
+    if (config.ebay.enabled) {
+      const ebayClient = new eBayAPIClient(config.ebay, this.logger);
+      this.channels.set('ebay', {
+        enabled: true,
+        apiClient: ebayClient as any,
+        bufferStock: config.ebay.bufferStock,
+        rateLimit: config.ebay.rateLimit,
+      });
+      this.logger.info('eBay Trading API client initialized');
+    }
+
+    if (config.walmart.enabled) {
+      const walmartClient = new WalmartAPIClient(config.walmart, this.logger);
+      this.channels.set('walmart', {
+        enabled: true,
+        apiClient: walmartClient as any,
+        bufferStock: config.walmart.bufferStock,
+        rateLimit: config.walmart.rateLimit,
+      });
+      this.logger.info('Walmart Marketplace API client initialized');
+    }
+
+    this.logger.info(`Initialized ${this.channels.size} marketplace channels`);
+  }
+
+  async syncInventory(): Promise<void> {
+    this.logger.info('Starting multi-channel inventory sync');
+    this.metrics.startTime = new Date();
+
+    try {
+      // Step 1: Fetch all ATP inventory from Fluent Commerce
+      const inventory = await this.fetchFluentInventory();
+      this.metrics.totalSKUs = inventory.length;
+
+      this.logger.info(`Fetched ${inventory.length} inventory positions from Fluent`);
+
+      // Step 2: Calculate ATP for each channel with buffer stock
+      const channelInventory = this.calculateChannelInventory(inventory);
+
+      // Step 3: Update each marketplace in parallel with rate limiting
+      await this.updateMarketplaces(channelInventory);
+
+      this.metrics.endTime = new Date();
+      this.logMetrics();
+
+      this.logger.info('Multi-channel inventory sync completed successfully');
+    } catch (error: any) {
+      this.logger.error('Multi-channel inventory sync failed', error);
+      throw error;
+    }
+  }
+
+  private async fetchFluentInventory(): Promise<InventoryPosition[]> {
+    const query = `
+      query GetInventory($retailerId: ID!, $first: Int!, $after: String) {
+        inventoryQuantities(
+          first: $first
+          after: $after
+          retailerId: $retailerId
+          type: "AVAILABLE"
+        ) {
+          edges {
+            node {
+              productRef
+              locationRef
+              quantity
+              onHand
+              available
+              reserved
+            }
+            cursor
+          }
+          pageInfo {
+            hasNextPage
+          }
+        }
+      }
+    `;
+
+    const result = await this.fluentClient.graphql({
+      query,
+      variables: {
+        retailerId: config.fluent.retailerId,
+        first: 250,
+      },
+      pagination: {
+        maxPages: 500,
+      },
+    });
+
+    if (result.errors) {
+      throw new Error(`GraphQL errors: ${JSON.stringify(result.errors)}`);
+    }
+
+    const edges = (result.data as any).inventoryQuantities?.edges || [];
+    return edges.map((edge: any) => edge.node);
+  }
+
+  private calculateChannelInventory(
+    inventory: InventoryPosition[]
+  ): Map<string, Map<string, number>> {
+    const channelInventory = new Map<string, Map<string, number>>();
+
+    for (const [channelName, channelConfig] of this.channels) {
+      const skuQuantities = new Map<string, number>();
+
+      for (const position of inventory) {
+        const atpQuantity = position.available || 0;
+        const channelQuantity = Math.max(0, atpQuantity - channelConfig.bufferStock);
+        skuQuantities.set(position.productRef, channelQuantity);
+      }
+
+      channelInventory.set(channelName, skuQuantities);
+    }
+
+    return channelInventory;
+  }
+
+  private async updateMarketplaces(
+    channelInventory: Map<string, Map<string, number>>
+  ): Promise<void> {
+    const updatePromises: Promise<void>[] = [];
+
+    for (const [channelName, skuQuantities] of channelInventory) {
+      const channelConfig = this.channels.get(channelName)!;
+      const limit = pLimit(channelConfig.rateLimit);
+
+      const channelPromises = Array.from(skuQuantities.entries()).map(([sku, quantity]) =>
+        limit(async () => {
+          try {
+            const startTime = Date.now();
+
+            if (channelName === 'amazon') {
+              await (channelConfig.apiClient as any).updateInventory(sku, quantity);
+            } else if (channelName === 'ebay') {
+              await (channelConfig.apiClient as any).updateInventory(sku, quantity);
+            } else if (channelName === 'walmart') {
+              await (channelConfig.apiClient as any).updateInventory(sku, quantity);
+            }
+
+            const duration = Date.now() - startTime;
+            this.metrics.successfulUpdates++;
+
+            this.logger.debug(`Updated ${channelName} inventory for ${sku}: ${quantity}`, {
+              duration,
+            });
+          } catch (error: any) {
+            this.metrics.failedUpdates++;
+            this.metrics.errors.push({
+              sku,
+              channel: channelName,
+              error: error.message,
+            });
+
+            if (error.response?.status === 429) {
+              this.metrics.rateLimitHits++;
+            }
+
+            this.logger.warn(`Failed to update ${channelName} inventory for ${sku}`, {
+              error: error.message,
+              status: error.response?.status,
+            });
+          }
+        })
+      );
+
+      updatePromises.push(...channelPromises);
+    }
+
+    await Promise.all(updatePromises);
+  }
+
+  private logMetrics(): void {
+    if (!config.processing.metricsEnabled) return;
+
+    const duration = this.metrics.endTime
+      ? (this.metrics.endTime.getTime() - this.metrics.startTime.getTime()) / 1000
+      : 0;
+
+    this.logger.info('='.repeat(80));
+    this.logger.info('SYNC METRICS', {
+      duration: `${duration.toFixed(2)}s`,
+      totalSKUs: this.metrics.totalSKUs,
+      successfulUpdates: this.metrics.successfulUpdates,
+      failedUpdates: this.metrics.failedUpdates,
+      skippedUpdates: this.metrics.skippedUpdates,
+      successRate: `${((this.metrics.successfulUpdates / (this.metrics.successfulUpdates + this.metrics.failedUpdates)) * 100).toFixed(2)}%`,
+      rateLimitHits: this.metrics.rateLimitHits,
+      errorCount: this.metrics.errors.length,
+    });
+
+    if (this.metrics.errors.length > 0) {
+      this.logger.warn('Error summary (first 10):', {
+        errors: this.metrics.errors.slice(0, 10),
+      });
+    }
+
+    this.logger.info('='.repeat(80));
+  }
+}
+
+// ============================================================================
+// MAIN ENTRY POINT
+// ============================================================================
+
+async function main() {
+  const sync = new MultiChannelInventorySync();
+
+  try {
+    await sync.initialize();
+    await sync.syncInventory();
+
+    console.log('Multi-channel inventory sync completed successfully');
+    process.exit(0);
+  } catch (error: any) {
+    console.error('Fatal error:', error);
+    process.exit(1);
+  }
+}
+
+// Run if executed directly
+if (require.main === module) {
+  main();
+}
+
+export { MultiChannelInventorySync };
+```
+
+---
+
+## Key Patterns Explained
+
+### Pattern 1: GraphQL Auto-Pagination for Large Datasets
+
+**Challenge**: Efficiently fetch 10k-100k inventory positions without manual pagination logic
+
+**Solution**: Use SDK's built-in auto-pagination with progress callbacks
+
+```javascript
+const result = await fluentClient.graphql({
+  query,
+  variables: { retailerId, first: 200 },
+  pagination: {
+    maxRecords: 100000,
+    maxPages: 500,
+  },
+});
+```
+
+**Why This Works**:
+
+- **Automatic**: No manual cursor tracking needed
+- **Safe**: Built-in protections against infinite loops
+- **Efficient**: Streams data as it's received
+- **Observable**: Progress callbacks for monitoring
+
+### Pattern 2: ATP Aggregation with Location Rollup
+
+**Challenge**: Calculate total Available-to-Promise across multiple warehouses/stores per SKU
+
+**Solution**: Map-based aggregation with location tracking
+
+```javascript
+function aggregateATP(inventoryPositions) {
+  const atpMap = new Map();
+  for (const position of inventoryPositions) {
+    const sku = position.productRef;
+    const availableQty = Math.max(0, position.availableQty || 0);
+
+    if (!atpMap.has(sku)) {
+      atpMap.set(sku, {
+        sku,
+        totalATP: 0,
+        locations: [],
+        lastUpdated: position.updatedOn,
+      });
+    }
+
+    const aggregated = atpMap.get(sku);
+    aggregated.totalATP += availableQty;
+    aggregated.locations.push({
+      locationRef: position.locationRef,
+      availableQty: availableQty,
+    });
+  }
+  return atpMap;
+}
+```
+
+**Why This Works**:
+
+- **O(n) complexity**: Single pass through inventory
+- **Location visibility**: Track which locations contribute to total
+- **Negative protection**: `Math.max(0, ...)` prevents negative ATP
+- **Timestamp tracking**: Know when inventory was last updated
+
+### Pattern 3: Marketplace-Specific Buffer Stock
+
+**Challenge**: Different marketplaces need different safety buffers to prevent overselling
+
+**Solution**: Configurable buffer per marketplace
+
+```javascript
+// Configuration
+const buffers = {
+  amazon: 5, // Lower buffer (fast fulfillment)
+  ebay: 3, // Moderate buffer
+  walmart: 10, // Higher buffer (longer fulfillment)
+};
+
+// Application
+function applyBufferStock(totalATP, bufferStock) {
+  return Math.max(0, totalATP - bufferStock);
+}
+
+// Example: SKU with 50 ATP across all locations
+const amazonQty = applyBufferStock(50, 5); // 45 available on Amazon
+const ebayQty = applyBufferStock(50, 3); // 47 available on eBay
+const walmartQty = applyBufferStock(50, 10); // 40 available on Walmart
+```
+
+**Why This Works**:
+
+- **Oversell prevention**: Accounts for sync delays and processing time
+- **Marketplace flexibility**: Different risk profiles per marketplace
+- **Safety floor**: `Math.max(0, ...)` ensures quantity never goes negative
+- **Configurable**: Easy to adjust per marketplace requirements
+
+### Pattern 4: Parallel Marketplace Updates with Rate Limiting
+
+**Challenge**: Update multiple marketplaces efficiently without exceeding API rate limits
+
+**Solution**: Parallel execution with per-marketplace rate limiters
+
+```javascript
+import pLimit from 'p-limit';
+
+// Each marketplace has its own rate limiter
+class AmazonMarketplace {
+  constructor(config) {
+    this.limiter = pLimit(config.rateLimit); // 10 req/sec
+  }
+
+  async updateInventory(sku, quantity) {
+    // Rate-limited execution
+    return this.limiter(() => this.makeApiCall(sku, quantity));
+  }
+}
+
+// Parallel sync across all marketplaces
+const syncResults = await Promise.all(
+  marketplaces.map(marketplace => marketplace.syncInventory(atpMap))
+);
+```
+
+**Why This Works**:
+
+- **Parallel execution**: All marketplaces sync simultaneously
+- **Independent rate limits**: Each marketplace respects its own limits
+- **Error isolation**: Failure in one marketplace doesn't affect others
+- **Concurrency control**: p-limit prevents overwhelming APIs
+
+### Pattern 5: Exponential Backoff Retry Strategy
+
+**Challenge**: Handle transient API failures (429 rate limits, 500 server errors)
+
+**Solution**: p-retry with exponential backoff
+
+```javascript
+import pRetry from 'p-retry';
+
+async updateInventory(sku, quantity) {
+  return pRetry(
+    async () => {
+      // Attempt API call
+      const response = await axios.put(endpoint, payload);
+
+      // Check for retryable errors
+      if (response.status === 429) {
+        throw new Error('Rate limit exceeded'); // Will retry
+      }
+
+      return response.data;
+    },
+    {
+      retries: 3,
+      factor: 2,         // Exponential backoff factor
+      minTimeout: 1000,  // 1s, 2s, 4s delays
+      onFailedAttempt: error => {
+        logger.warn(`Retry attempt ${error.attemptNumber}`, {
+          retriesLeft: error.retriesLeft,
+        });
+      },
+    }
+  );
+}
+```
+
+**Why This Works**:
+
+- **Transient failure recovery**: Handles temporary API issues
+- **Exponential backoff**: Reduces load on overloaded APIs
+- **Configurable retries**: 3 attempts is reasonable for most cases
+- **Observable**: Logs each retry attempt for debugging
+
+### Pattern 6: SLA Tracking and Compliance
+
+**Challenge**: Ensure sync completes within 15-minute SLA requirement
+
+**Solution**: Duration tracking with SLA compliance check
+
+```javascript
+function checkSLA(durationMs) {
+  const durationMinutes = durationMs / 60000;
+  const slaThreshold = 15; // 15-minute requirement
+  const slaMet = durationMinutes <= slaThreshold;
+
+  if (!slaMet) {
+    logger.warn('SLA BREACH: Sync exceeded threshold', {
+      durationMinutes: durationMinutes.toFixed(2),
+      threshold: slaThreshold,
+    });
+    metrics.increment('sla_breaches');
+    // Alert via PagerDuty, Slack, etc.
+  }
+
+  return slaMet;
+}
+```
+
+**Why This Works**:
+
+- **Clear threshold**: 15 minutes is measurable and actionable
+- **Automated detection**: No manual checking needed
+- **Alerting hook**: Can trigger notifications on breach
+- **Metrics tracking**: Historical SLA compliance data
+
+### Pattern 7: Dry-Run Mode for Safe Testing
+
+**Challenge**: Test sync logic without actually updating marketplaces
+
+**Solution**: Dry-run flag that short-circuits API calls
+
+```javascript
+async updateInventory(sku, quantity, dryRun = false) {
+  if (dryRun) {
+    this.logger.info(`[DRY RUN] Would update inventory`, { sku, quantity });
+    return { success: true, sku, quantity, dryRun: true };
+  }
+
+  // Real API call
+  return this.makeApiCall(sku, quantity);
+}
+
+// Usage
+npm run sync:dry-run
+```
+
+**Why This Works**:
+
+- **Safe testing**: Validate logic without side effects
+- **End-to-end flow**: Tests everything except final API call
+- **Easy toggle**: Environment variable or CLI flag
+- **Visible logging**: Clear indication of dry-run mode
+
+---
+
+## Testing
+
+### Dry-Run Test
+
+```bash
+# Test sync without updating marketplaces
+DRY_RUN=true npm run sync:once
+
+# Expected output:
+# [DRY RUN] Would update Amazon inventory { sku: 'PROD-001', quantity: 45 }
+# [DRY RUN] Would update eBay inventory { sku: 'PROD-001', quantity: 47 }
+# [DRY RUN] Would update Walmart inventory { sku: 'PROD-001', quantity: 40 }
+```
+
+### Single Sync Execution
+
+```bash
+# Run once and exit
+npm run sync:once
+
+# Check logs
+cat logs/inventory-sync.log | grep "COMPLETE"
+```
+
+### Continuous Sync Mode
+
+```bash
+# Run continuously (every 15 minutes)
+npm run sync:continuous
+
+# Check next sync time in logs
+```
+
+---
+
+## Deployment Options
+
+### Option 1: Docker Container
+
+Create `Dockerfile`:
+
+```dockerfile
+FROM node:18-alpine
+
+WORKDIR /app
+
+# Copy package files
+COPY package*.json ./
+
+# Install dependencies
+RUN npm ci --only=production
+
+# Copy application code
+COPY src ./src
+
+# Create state directory
+RUN mkdir -p /app/state
+
+# Run continuous sync
+CMD ["node", "src/index.js"]
+```
+
+Build and run:
+
+```bash
+# Build image
+docker build -t multi-channel-sync .
+
+# Run container
+docker run -d \
+  --name inventory-sync \
+  --env-file .env \
+  --restart unless-stopped \
+  --volume ./state:/app/state \
+  multi-channel-sync
+```
+
+### Option 2: AWS ECS Task
+
+Create `ecs-task-definition.json`:
+
+```json
+{
+  "family": "multi-channel-inventory-sync",
+  "networkMode": "awsvpc",
+  "requiresCompatibilities": ["FARGATE"],
+  "cpu": "1024",
+  "memory": "2048",
+  "containerDefinitions": [
+    {
+      "name": "inventory-sync",
+      "image": "your-registry/multi-channel-sync:latest",
+      "essential": true,
+      "environment": [
+        { "name": "LOG_LEVEL", "value": "info" },
+        { "name": "SYNC_INTERVAL_MINUTES", "value": "15" }
+      ],
+      "secrets": [
+        {
+          "name": "FLUENT_CLIENT_ID",
+          "valueFrom": "arn:aws:secretsmanager:us-east-1:123:secret:fluent-client-id"
+        }
+      ],
+      "logConfiguration": {
+        "logDriver": "awslogs",
+        "options": {
+          "awslogs-group": "/ecs/inventory-sync",
+          "awslogs-region": "us-east-1",
+          "awslogs-stream-prefix": "ecs"
+        }
+      }
+    }
+  ]
+}
+```
+
+Deploy:
+
+```bash
+aws ecs register-task-definition --cli-input-json file://ecs-task-definition.json
+aws ecs create-service \
+  --cluster production \
+  --service-name inventory-sync \
+  --task-definition multi-channel-inventory-sync \
+  --desired-count 1 \
+  --launch-type FARGATE
+```
+
+---
+
+## Common Issues & Solutions
+
+### Issue 1: SLA Breach (Sync Takes >15 Minutes)
+
+**Symptoms**:
+
+- Log shows "SLA BREACH" warning
+- Sync duration exceeds 15 minutes
+
+**Solutions**:
+
+1. **Reduce page size** (faster initial response):
+
+```javascript
+variables: {
+  first: 100;
+} // Instead of 200
+```
+
+2. **Increase parallelism**:
+
+```javascript
+const limiter = pLimit(20); // Increase from 10
+```
+
+3. **Optimize marketplace rate limits** (if APIs allow):
+
+```bash
+AMAZON_RATE_LIMIT=20  # Increase from 10
+```
+
+4. **Split sync by marketplace** (run separately):
+
+```bash
+AMAZON_ENABLED=true EBAY_ENABLED=false WALMART_ENABLED=false npm run sync:once
+```
+
+---
+
+## Related Guides
+
+- **GraphQL Query Export**: [`./graphql-query-export.md`](./graphql-query-export.md) - GraphQL pagination patterns
+- **Multi-Source Aggregation**: `./04-multi-source-aggregation.md` - Data aggregation strategies
+- **Error Handling Patterns**: `../../03-PATTERN-GUIDES/error-handling/readme.md` - Retry and error handling
+- **Universal Mapping Guide**: `../../02-CORE-GUIDES/mapping/readme.md` - Field transformations
+- **SDK API Reference**: `../../readme.md` - Core SDK documentation
+
+---
+
+## Production Checklist
+
+Before deploying to production:
+
+- [ ] All marketplace credentials secured (AWS Secrets Manager, Vault)
+- [ ] Rate limits configured per marketplace API documentation
+- [ ] Buffer stock values tested and approved by business
+- [ ] SLA threshold aligned with business requirements
+- [ ] Monitoring dashboards created (sync duration, SLA compliance, error rates)
+- [ ] Alerting configured (PagerDuty, Slack, email)
+- [ ] Dry-run testing completed with production data
+- [ ] Load testing with 100k+ SKUs
+- [ ] State management enabled to prevent duplicate processing
+- [ ] Logging configured (CloudWatch, Datadog, Splunk)
+- [ ] Error tracking integrated (Sentry, Rollbar)
+- [ ] Documentation updated with runbooks
+- [ ] On-call team trained on troubleshooting
+- [ ] Disaster recovery plan documented
+- [ ] Metrics baseline established (average sync duration, success rate)
+
+---
+
+**Next Steps**:
+
+1. Customize buffer stock values per marketplace and product category
+2. Implement incremental sync (only process changed inventory)
+3. Add webhook integration for real-time inventory updates
+4. Set up monitoring dashboards (Grafana, Datadog)
+5. Integrate with incident management (PagerDuty)
+6. Add marketplace-specific SKU mapping (Fluent SKU → Marketplace SKU)
+7. Implement A/B testing for buffer stock optimization
+
+**Support**:
+
+- SDK Issues: https://github.com/fluentcommerce/fc-connect-sdk/issues
+- Fluent Commerce API: https://docs.fluentcommerce.com
+- Amazon SP-API: https://developer-docs.amazon.com/sp-api/
+- eBay Trading API: https://developer.ebay.com/devzone/xml/docs/reference/ebay/
+- Walmart Seller API: https://developer.walmart.com/