@fluentcommerce/fc-connect-sdk 0.1.54 → 0.1.56

package/docs/03-PATTERN-GUIDES/connector-scenarios/modules/connector-scenarios-06-production-patterns.md

@@ -1,442 +1,442 @@
-# Module 6: Production Patterns
-
-**Level:** Intermediate
-**Estimated Time:** 30 minutes
-
-## Overview
-
-This module covers production-ready patterns for error handling, monitoring, testing, and deployment of connectors in real-world environments.
-
-## Learning Objectives
-
-By the end of this module, you will:
-- ✅ Implement layered error handling strategies
-- ✅ Add monitoring and metrics collection
-- ✅ Test connectors effectively
-- ✅ Deploy with proper configuration management
-- ✅ Handle secrets securely
-- ✅ Implement retry logic and circuit breakers
-
-## Best Practices
-
-### 1. Error Handling
-
-**Three-Level Error Strategy:**
-
-```typescript
-// Record-Level: Continue processing
-const { validRecords, errors } = records.reduce((acc, record) => {
-  try {
-    const transformed = mapper.map(record);
-    if (transformed.success) {
-      acc.validRecords.push(transformed.data);
-    } else {
-      acc.errors.push({ record, errors: transformed.errors });
-    }
-  } catch (error) {
-    acc.errors.push({ record, error: error.message });
-  }
-  return acc;
-}, { validRecords: [], errors: [] });
-
-logger.warn(`Skipped ${errors.length} invalid records`);
-
-// File-Level: Skip file, continue batch
-try {
-  await processFile(file);
-} catch (error) {
-  logger.error(`File failed: ${file.name}`, error);
-  await moveToErrorFolder(file);
-  // Continue with next file
-}
-
-// Job-Level: Fail fast
-try {
-  await syncInventory();
-} catch (error) {
-  logger.error('Critical failure', error);
-  await notifyAdministrators(error);
-  throw error; // Stop execution
-}
-```
-
-### 2. State Management
-
-**Track Processing State:**
-
-```typescript
-const kv = openKv(); // Or VersoriKVAdapter for Versori platform
-
-// File-level tracking (simple)
-await stateService.updateSyncState(kv, [{
-  fileName: 'inventory_2025-01-15.csv',
-  lastModified: new Date().toISOString(),
-  recordCount: 1000
-}], 'workflow-id');
-
-// Record-level checkpoints (advanced) - Use KV directly
-await kv.set(['checkpoint', 'job-123'], {
-  file: currentFile,
-  lastRecordId: record.id,
-  recordsProcessed: count,
-  lastProcessedAt: new Date().toISOString()
-});
-
-// Resume from checkpoint
-const checkpointData = await kv.get(['checkpoint', 'job-123']);
-const checkpoint = checkpointData?.value;
-if (checkpoint) {
-  startFrom = checkpoint.lastRecordId;
-}
-```
-
-### 3. Validation
-
-**Validate Before Transformation:**
-
-```typescript
-// Required field validation
-if (!record.sku || !record.location || record.quantity === undefined) {
-  return { valid: false, error: 'Missing required fields' };
-}
-
-// Type validation
-if (isNaN(Number(record.quantity))) {
-  return { valid: false, error: 'Invalid quantity type' };
-}
-
-// Format validation
-if (!/^[A-Z0-9-]+$/i.test(record.sku)) {
-  return { valid: false, error: 'Invalid SKU format' };
-}
-
-// Business rule validation
-if (Number(record.quantity) < 0) {
-  return { valid: false, error: 'Quantity cannot be negative' };
-}
-```
-
-### 4. Batch Processing
-
-**Process in Manageable Chunks:**
-
-```typescript
-const BATCH_SIZE = 100;
-
-for (let i = 0; i < records.length; i += BATCH_SIZE) {
-  const batch = records.slice(i, i + BATCH_SIZE);
-
-  try {
-    await processBatch(batch);
-    logger.info(`Batch ${i / BATCH_SIZE + 1} completed`);
-  } catch (error) {
-    logger.error(`Batch ${i / BATCH_SIZE + 1} failed`, error);
-    // Save failed batch for retry
-    await saveFailedBatch(batch, error);
-  }
-}
-```
-
-### 5. Monitoring
-
-**Collect and Report Metrics:**
-
-```typescript
-const metrics = {
-  startTime: Date.now(),
-  filesProcessed: 0,
-  recordsProcessed: 0,
-  recordsFailed: 0,
-  errors: [] as any[],
-  duration: 0
-};
-
-// Track during processing
-metrics.filesProcessed++;
-metrics.recordsProcessed += validRecords.length;
-metrics.recordsFailed += invalidRecords.length;
-
-// Calculate duration
-metrics.duration = Date.now() - metrics.startTime;
-
-// Log final metrics
-logger.info('Processing complete', {
-  ...metrics,
-  avgTimePerFile: metrics.duration / metrics.filesProcessed,
-  successRate: (metrics.recordsProcessed / (metrics.recordsProcessed + metrics.recordsFailed)) * 100
-});
-```
-
-### 6. Retry Logic
-
-**Implement Exponential Backoff:**
-
-```typescript
-async function retryWithBackoff<T>(
-  fn: () => Promise<T>,
-  maxRetries: number = 3,
-  baseDelay: number = 1000
-): Promise<T> {
-  let lastError: Error;
-
-  for (let attempt = 0; attempt < maxRetries; attempt++) {
-    try {
-      return await fn();
-    } catch (error) {
-      lastError = error as Error;
-      logger.warn(`Attempt ${attempt + 1} failed: ${error.message}`);
-
-      if (attempt < maxRetries - 1) {
-        const delay = baseDelay * Math.pow(2, attempt);
-        logger.info(`Retrying in ${delay}ms...`);
-        await new Promise(resolve => setTimeout(resolve, delay));
-      }
-    }
-  }
-
-  throw lastError!;
-}
-
-// Usage
-await retryWithBackoff(
-  () => fluentClient.sendBatch(jobId, entities),
-  3,  // max retries
-  2000  // base delay (2s)
-);
-```
-
-## Testing Your Connector
-
-### Unit Testing
-
-```typescript
-describe('Inventory Connector', () => {
-  it('should parse CSV correctly', async () => {
-    const csv = 'sku,qty\nPROD1,100';
-    const records = await parser.parse(csv);
-
-    expect(records).toHaveLength(1);
-    expect(records[0].sku).toBe('PROD1');
-    expect(records[0].qty).toBe('100');
-  });
-
-  it('should transform fields correctly', async () => {
-    const input = { sku: 'prod1', quantity: '100' };
-    const output = await mapper.map(input);
-
-    expect(output.success).toBe(true);
-    expect(output.data.ref).toBe('PROD1');
-    expect(output.data.qty).toBe(100);
-  });
-
-  it('should validate required fields', () => {
-    const invalid = { sku: 'PROD1' }; // missing quantity
-    const result = validateRecord(invalid);
-
-    expect(result.valid).toBe(false);
-    expect(result.error).toContain('Missing required fields');
-  });
-});
-```
-
-### Integration Testing
-
-```typescript
-describe('SFTP Integration', () => {
-  let sftpSource: SftpDataSource;
-
-  beforeAll(async () => {
-    sftpSource = new SftpDataSource({
-      type: 'SFTP_CSV',
-      connectionId: 'test-sftp',
-      name: 'Test SFTP',
-      settings: {
-        host: process.env.TEST_SFTP_HOST!,
-        username: process.env.TEST_SFTP_USER!,
-        password: process.env.TEST_SFTP_PASS!,
-        remotePath: '/test'
-      }
-    }, logger);
-  });
-
-  it('should connect and list files', async () => {
-    const files = await sftpSource.listFiles();
-    expect(files).toBeDefined();
-    expect(Array.isArray(files)).toBe(true);
-  });
-
-  it('should download and parse file', async () => {
-    const content = await sftpSource.downloadFile('test.csv');
-    expect(content).toBeDefined();
-    expect(content.length).toBeGreaterThan(0);
-  });
-});
-```
-
-### End-to-End Testing
-
-```typescript
-describe('Full Inventory Sync', () => {
-  it('should sync inventory from SFTP to Fluent', async () => {
-    // Upload test file
-    await sftpSource.uploadFile('test-inventory.csv', testCsvContent);
-
-    // Run sync
-    const result = await syncInventory();
-
-    // Verify results
-    expect(result.filesProcessed).toBe(1);
-    expect(result.recordsProcessed).toBeGreaterThan(0);
-    expect(result.errors.length).toBe(0);
-
-    // Verify in Fluent
-    const inventory = await fluentClient.graphql({
-      query: getInventoryQuery,
-      variables: { productRef: 'TEST-SKU' }
-    });
-
-    expect(inventory.data.inventoryPositions.edges.length).toBeGreaterThan(0);
-  });
-});
-```
-
-## Deployment Considerations
-
-### 1. Environment Variables
-
-**Use environment-specific configs:**
-
-```typescript
-// .env.production
-FLUENT_BASE_URL=https://api.fluentcommerce.com
-FLUENT_CLIENT_ID=prod-client-id
-FLUENT_CLIENT_SECRET=***SECRET***
-FLUENT_RETAILER_ID=1
-
-SFTP_HOST=sftp.partner.com
-SFTP_USERNAME=prod-user
-SFTP_PASSWORD=***SECRET***
-
-S3_BUCKET=prod-inventory-data
-AWS_REGION=us-east-1
-
-LOG_LEVEL=info
-STATE_STORAGE_TYPE=s3
-```
-
-### 2. Secret Management
-
-**Never hardcode secrets:**
-
-```typescript
-// ❌ WRONG
-const config = {
-  password: 'mypassword123'
-};
-
-// ✅ CORRECT
-const config = {
-  password: process.env.SFTP_PASSWORD!
-};
-
-// ✅ BETTER - Use secret management service
-import { SecretsManager } from '@aws-sdk/client-secrets-manager';
-
-const secretsManager = new SecretsManager({ region: 'us-east-1' });
-const secret = await secretsManager.getSecretValue({ SecretId: 'sftp-credentials' });
-const config = JSON.parse(secret.SecretString);
-```
-
-### 3. Logging Strategy
-
-**Structured logging for production:**
-
-```typescript
-import { createConsoleLogger, toStructuredLogger } from '@fluentcommerce/fc-connect-sdk';
-
-const logger = toStructuredLogger(createConsoleLogger(), {
-  service: 'inventory-sync',
-  module: 'production-workflow',
-  environment: process.env.NODE_ENV
-});
-
-// Log with context
-logger.info('Processing file', {
-  fileName: file.name,
-  fileSize: file.size,
-  source: 'SFTP'
-});
-```
-
-### 4. Health Checks
-
-**Implement health check endpoints:**
-
-```typescript
-// Health check endpoint
-app.get('/health', async (req, res) => {
-  const checks = {
-    sftpConnection: await checkSftpConnection(),
-    s3Access: await checkS3Access(),
-    fluentApi: await checkFluentConnection(),
-    lastSuccessfulRun: await getLastSuccessfulRun()
-  };
-
-  const healthy = Object.values(checks).every(c => c === true || c.success);
-
-  res.status(healthy ? 200 : 503).json({
-    status: healthy ? 'healthy' : 'unhealthy',
-    checks,
-    timestamp: new Date().toISOString()
-  });
-});
-```
-
-### 5. Alerts and Notifications
-
-**Notify on failures:**
-
-```typescript
-async function notifyOnError(error: Error, context: any) {
-  // Send to monitoring service
-  await sendToDatadog({
-    type: 'error',
-    message: error.message,
-    stack: error.stack,
-    context
-  });
-
-  // Send email alert
-  await sendEmail({
-    to: process.env.ALERT_EMAIL!,
-    subject: 'Connector Failure',
-    body: `
-      Error: ${error.message}
-      Context: ${JSON.stringify(context, null, 2)}
-      Timestamp: ${new Date().toISOString()}
-    `
-  });
-
-  // Send Slack notification
-  await sendSlackMessage({
-    channel: '#alerts',
-    text: `🚨 Connector failed: ${error.message}`
-  });
-}
-```
-
-## Key Takeaways
-
-- 🎯 Implement three-level error handling (record, file, job)
-- 🎯 Track state for recovery and duplicate prevention
-- 🎯 Validate data at multiple stages (structure, types, business rules)
-- 🎯 Process in batches with retry logic
-- 🎯 Collect metrics for monitoring and optimization
-- 🎯 Test at unit, integration, and end-to-end levels
-- 🎯 Use environment variables for configuration
-- 🎯 Never log or commit secrets
-- 🎯 Implement health checks and alerts
-
-## Next Steps
-
-Continue to [Module 7: Reference](./connector-scenarios-07-reference.md) for a complete pattern catalog and quick reference guide.
+# Module 6: Production Patterns
+
+**Level:** Intermediate
+**Estimated Time:** 30 minutes
+
+## Overview
+
+This module covers production-ready patterns for error handling, monitoring, testing, and deployment of connectors in real-world environments.
+
+## Learning Objectives
+
+By the end of this module, you will:
+- ✅ Implement layered error handling strategies
+- ✅ Add monitoring and metrics collection
+- ✅ Test connectors effectively
+- ✅ Deploy with proper configuration management
+- ✅ Handle secrets securely
+- ✅ Implement retry logic and circuit breakers
+
+## Best Practices
+
+### 1. Error Handling
+
+**Three-Level Error Strategy:**
+
+```typescript
+// Record-Level: Continue processing
+const { validRecords, errors } = records.reduce((acc, record) => {
+  try {
+    const transformed = mapper.map(record);
+    if (transformed.success) {
+      acc.validRecords.push(transformed.data);
+    } else {
+      acc.errors.push({ record, errors: transformed.errors });
+    }
+  } catch (error) {
+    acc.errors.push({ record, error: error.message });
+  }
+  return acc;
+}, { validRecords: [], errors: [] });
+
+logger.warn(`Skipped ${errors.length} invalid records`);
+
+// File-Level: Skip file, continue batch
+try {
+  await processFile(file);
+} catch (error) {
+  logger.error(`File failed: ${file.name}`, error);
+  await moveToErrorFolder(file);
+  // Continue with next file
+}
+
+// Job-Level: Fail fast
+try {
+  await syncInventory();
+} catch (error) {
+  logger.error('Critical failure', error);
+  await notifyAdministrators(error);
+  throw error; // Stop execution
+}
+```
+
+### 2. State Management
+
+**Track Processing State:**
+
+```typescript
+const kv = openKv(); // Or VersoriKVAdapter for Versori platform
+
+// File-level tracking (simple)
+await stateService.updateSyncState(kv, [{
+  fileName: 'inventory_2025-01-15.csv',
+  lastModified: new Date().toISOString(),
+  recordCount: 1000
+}], 'workflow-id');
+
+// Record-level checkpoints (advanced) - Use KV directly
+await kv.set(['checkpoint', 'job-123'], {
+  file: currentFile,
+  lastRecordId: record.id,
+  recordsProcessed: count,
+  lastProcessedAt: new Date().toISOString()
+});
+
+// Resume from checkpoint
+const checkpointData = await kv.get(['checkpoint', 'job-123']);
+const checkpoint = checkpointData?.value;
+if (checkpoint) {
+  startFrom = checkpoint.lastRecordId;
+}
+```
+
+### 3. Validation
+
+**Validate Before Transformation:**
+
+```typescript
+// Required field validation
+if (!record.sku || !record.location || record.quantity === undefined) {
+  return { valid: false, error: 'Missing required fields' };
+}
+
+// Type validation
+if (isNaN(Number(record.quantity))) {
+  return { valid: false, error: 'Invalid quantity type' };
+}
+
+// Format validation
+if (!/^[A-Z0-9-]+$/i.test(record.sku)) {
+  return { valid: false, error: 'Invalid SKU format' };
+}
+
+// Business rule validation
+if (Number(record.quantity) < 0) {
+  return { valid: false, error: 'Quantity cannot be negative' };
+}
+```
+
+### 4. Batch Processing
+
+**Process in Manageable Chunks:**
+
+```typescript
+const BATCH_SIZE = 100;
+
+for (let i = 0; i < records.length; i += BATCH_SIZE) {
+  const batch = records.slice(i, i + BATCH_SIZE);
+
+  try {
+    await processBatch(batch);
+    logger.info(`Batch ${i / BATCH_SIZE + 1} completed`);
+  } catch (error) {
+    logger.error(`Batch ${i / BATCH_SIZE + 1} failed`, error);
+    // Save failed batch for retry
+    await saveFailedBatch(batch, error);
+  }
+}
+```
+
+### 5. Monitoring
+
+**Collect and Report Metrics:**
+
+```typescript
+const metrics = {
+  startTime: Date.now(),
+  filesProcessed: 0,
+  recordsProcessed: 0,
+  recordsFailed: 0,
+  errors: [] as any[],
+  duration: 0
+};
+
+// Track during processing
+metrics.filesProcessed++;
+metrics.recordsProcessed += validRecords.length;
+metrics.recordsFailed += invalidRecords.length;
+
+// Calculate duration
+metrics.duration = Date.now() - metrics.startTime;
+
+// Log final metrics
+logger.info('Processing complete', {
+  ...metrics,
+  avgTimePerFile: metrics.duration / metrics.filesProcessed,
+  successRate: (metrics.recordsProcessed / (metrics.recordsProcessed + metrics.recordsFailed)) * 100
+});
+```
+
+### 6. Retry Logic
+
+**Implement Exponential Backoff:**
+
+```typescript
+async function retryWithBackoff<T>(
+  fn: () => Promise<T>,
+  maxRetries: number = 3,
+  baseDelay: number = 1000
+): Promise<T> {
+  let lastError: Error;
+
+  for (let attempt = 0; attempt < maxRetries; attempt++) {
+    try {
+      return await fn();
+    } catch (error) {
+      lastError = error as Error;
+      logger.warn(`Attempt ${attempt + 1} failed: ${error.message}`);
+
+      if (attempt < maxRetries - 1) {
+        const delay = baseDelay * Math.pow(2, attempt);
+        logger.info(`Retrying in ${delay}ms...`);
+        await new Promise(resolve => setTimeout(resolve, delay));
+      }
+    }
+  }
+
+  throw lastError!;
+}
+
+// Usage
+await retryWithBackoff(
+  () => fluentClient.sendBatch(jobId, entities),
+  3,  // max retries
+  2000  // base delay (2s)
+);
+```
+
+## Testing Your Connector
+
+### Unit Testing
+
+```typescript
+describe('Inventory Connector', () => {
+  it('should parse CSV correctly', async () => {
+    const csv = 'sku,qty\nPROD1,100';
+    const records = await parser.parse(csv);
+
+    expect(records).toHaveLength(1);
+    expect(records[0].sku).toBe('PROD1');
+    expect(records[0].qty).toBe('100');
+  });
+
+  it('should transform fields correctly', async () => {
+    const input = { sku: 'prod1', quantity: '100' };
+    const output = await mapper.map(input);
+
+    expect(output.success).toBe(true);
+    expect(output.data.ref).toBe('PROD1');
+    expect(output.data.qty).toBe(100);
+  });
+
+  it('should validate required fields', () => {
+    const invalid = { sku: 'PROD1' }; // missing quantity
+    const result = validateRecord(invalid);
+
+    expect(result.valid).toBe(false);
+    expect(result.error).toContain('Missing required fields');
+  });
+});
+```
+
+### Integration Testing
+
+```typescript
+describe('SFTP Integration', () => {
+  let sftpSource: SftpDataSource;
+
+  beforeAll(async () => {
+    sftpSource = new SftpDataSource({
+      type: 'SFTP_CSV',
+      connectionId: 'test-sftp',
+      name: 'Test SFTP',
+      settings: {
+        host: process.env.TEST_SFTP_HOST!,
+        username: process.env.TEST_SFTP_USER!,
+        password: process.env.TEST_SFTP_PASS!,
+        remotePath: '/test'
+      }
+    }, logger);
+  });
+
+  it('should connect and list files', async () => {
+    const files = await sftpSource.listFiles();
+    expect(files).toBeDefined();
+    expect(Array.isArray(files)).toBe(true);
+  });
+
+  it('should download and parse file', async () => {
+    const content = await sftpSource.downloadFile('test.csv');
+    expect(content).toBeDefined();
+    expect(content.length).toBeGreaterThan(0);
+  });
+});
+```
+
+### End-to-End Testing
+
+```typescript
+describe('Full Inventory Sync', () => {
+  it('should sync inventory from SFTP to Fluent', async () => {
+    // Upload test file
+    await sftpSource.uploadFile('test-inventory.csv', testCsvContent);
+
+    // Run sync
+    const result = await syncInventory();
+
+    // Verify results
+    expect(result.filesProcessed).toBe(1);
+    expect(result.recordsProcessed).toBeGreaterThan(0);
+    expect(result.errors.length).toBe(0);
+
+    // Verify in Fluent
+    const inventory = await fluentClient.graphql({
+      query: getInventoryQuery,
+      variables: { productRef: 'TEST-SKU' }
+    });
+
+    expect(inventory.data.inventoryPositions.edges.length).toBeGreaterThan(0);
+  });
+});
+```
+
+## Deployment Considerations
+
+### 1. Environment Variables
+
+**Use environment-specific configs:**
+
+```typescript
+// .env.production
+FLUENT_BASE_URL=https://api.fluentcommerce.com
+FLUENT_CLIENT_ID=prod-client-id
+FLUENT_CLIENT_SECRET=***SECRET***
+FLUENT_RETAILER_ID=1
+
+SFTP_HOST=sftp.partner.com
+SFTP_USERNAME=prod-user
+SFTP_PASSWORD=***SECRET***
+
+S3_BUCKET=prod-inventory-data
+AWS_REGION=us-east-1
+
+LOG_LEVEL=info
+STATE_STORAGE_TYPE=s3
+```
+
+### 2. Secret Management
+
+**Never hardcode secrets:**
+
+```typescript
+// ❌ WRONG
+const config = {
+  password: 'mypassword123'
+};
+
+// ✅ CORRECT
+const config = {
+  password: process.env.SFTP_PASSWORD!
+};
+
+// ✅ BETTER - Use secret management service
+import { SecretsManager } from '@aws-sdk/client-secrets-manager';
+
+const secretsManager = new SecretsManager({ region: 'us-east-1' });
+const secret = await secretsManager.getSecretValue({ SecretId: 'sftp-credentials' });
+const config = JSON.parse(secret.SecretString);
+```
+
+### 3. Logging Strategy
+
+**Structured logging for production:**
+
+```typescript
+import { createConsoleLogger, toStructuredLogger } from '@fluentcommerce/fc-connect-sdk';
+
+const logger = toStructuredLogger(createConsoleLogger(), {
+  service: 'inventory-sync',
+  module: 'production-workflow',
+  environment: process.env.NODE_ENV
+});
+
+// Log with context
+logger.info('Processing file', {
+  fileName: file.name,
+  fileSize: file.size,
+  source: 'SFTP'
+});
+```
+
+### 4. Health Checks
+
+**Implement health check endpoints:**
+
+```typescript
+// Health check endpoint
+app.get('/health', async (req, res) => {
+  const checks = {
+    sftpConnection: await checkSftpConnection(),
+    s3Access: await checkS3Access(),
+    fluentApi: await checkFluentConnection(),
+    lastSuccessfulRun: await getLastSuccessfulRun()
+  };
+
+  const healthy = Object.values(checks).every(c => c === true || c.success);
+
+  res.status(healthy ? 200 : 503).json({
+    status: healthy ? 'healthy' : 'unhealthy',
+    checks,
+    timestamp: new Date().toISOString()
+  });
+});
+```
+
+### 5. Alerts and Notifications
+
+**Notify on failures:**
+
+```typescript
+async function notifyOnError(error: Error, context: any) {
+  // Send to monitoring service
+  await sendToDatadog({
+    type: 'error',
+    message: error.message,
+    stack: error.stack,
+    context
+  });
+
+  // Send email alert
+  await sendEmail({
+    to: process.env.ALERT_EMAIL!,
+    subject: 'Connector Failure',
+    body: `
+      Error: ${error.message}
+      Context: ${JSON.stringify(context, null, 2)}
+      Timestamp: ${new Date().toISOString()}
+    `
+  });
+
+  // Send Slack notification
+  await sendSlackMessage({
+    channel: '#alerts',
+    text: `🚨 Connector failed: ${error.message}`
+  });
+}
+```
+
+## Key Takeaways
+
+- 🎯 Implement three-level error handling (record, file, job)
+- 🎯 Track state for recovery and duplicate prevention
+- 🎯 Validate data at multiple stages (structure, types, business rules)
+- 🎯 Process in batches with retry logic
+- 🎯 Collect metrics for monitoring and optimization
+- 🎯 Test at unit, integration, and end-to-end levels
+- 🎯 Use environment variables for configuration
+- 🎯 Never log or commit secrets
+- 🎯 Implement health checks and alerts
+
+## Next Steps
+
+Continue to [Module 7: Reference](./connector-scenarios-07-reference.md) for a complete pattern catalog and quick reference guide.