@bernierllc/email-testing-suite 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Bernier LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,347 @@
+# @bernierllc/email-testing-suite
+
+Complete email testing solution with opinionated defaults and best practices.
+
+## Features
+
+- **One-Command Setup** - Start testing emails with minimal configuration
+- **Opinionated Defaults** - Pre-configured validations and best practices
+- **Comprehensive Validation** - Template, compliance, accessibility, performance, and security checks
+- **Advanced Analytics** - Track trends, identify issues, generate reports
+- **Best Practices Enforcement** - Automatic validation against email standards
+- **Integration Ready** - Works with Jest, Mocha, Vitest, and other test frameworks
+
+## Installation
+
+```bash
+npm install @bernierllc/email-testing-suite
+```
+
+## Quick Start
+
+### One-Line Testing
+
+The simplest way to test an email:
+
+```typescript
+import { testEmail } from '@bernierllc/email-testing-suite';
+
+const result = await testEmail({
+  template: './templates/welcome.html',
+  data: { name: 'John Doe', product: 'Pro Plan' },
+  recipient: 'test@example.com'
+});
+
+expect(result.success).toBe(true);
+expect(result.score).toBeGreaterThan(90);
+```
+
+### Full Suite Usage
+
+For more control and advanced features:
+
+```typescript
+import { EmailTestingSuite } from '@bernierllc/email-testing-suite';
+
+const suite = new EmailTestingSuite({
+  smtp: { port: 2525 },
+  defaults: { compliance: 'US', timeout: 30000 }
+});
+
+await suite.start();
+
+const result = await suite.testEmailTemplate({
+  name: 'Welcome Email',
+  template: './templates/welcome.html',
+  data: { name: 'Jane Doe' },
+  recipients: ['test@example.com'],
+  expectations: {
+    delivery: true,
+    templateCompletion: true,
+    compliance: 'US',
+    accessibility: true,
+    performance: { renderTime: 2000, size: '100kb' }
+  }
+});
+
+await suite.stop();
+```
+
+## Configuration
+
+### Suite Configuration
+
+```typescript
+interface EmailTestingSuiteConfig {
+  smtp?: {
+    port: number;        // Default: 2525
+    host: string;        // Default: 'localhost'
+    auth?: { user: string; pass: string; };
+  };
+
+  defaults?: {
+    compliance: 'US' | 'EU' | 'GLOBAL';  // Default: 'US'
+    timeout: number;                      // Default: 30000
+    retries: number;                      // Default: 3
+    expectations?: Partial<EmailExpectations>;
+  };
+
+  validation?: {
+    enabledValidators?: ValidatorType[];  // All enabled by default
+    strictMode?: boolean;                 // Default: false
+    customRules?: ValidationRule[];       // Custom validation rules
+  };
+
+  reporting?: {
+    enableAnalytics?: boolean;            // Default: true
+    generateTrendReports?: boolean;       // Default: true
+    exportFormats?: ReportFormat[];       // Default: ['json', 'html']
+    retainHistory?: number;               // Days, default: 30
+  };
+}
+```
+
+### Expectations
+
+```typescript
+interface EmailExpectations {
+  delivery: boolean;               // Email should be delivered
+  templateCompletion: boolean;     // All variables resolved
+  compliance: 'US' | 'EU' | 'GLOBAL';  // Compliance standard
+  accessibility: boolean;          // Accessibility validation
+  performance: {
+    renderTime?: number;          // Max render time (ms)
+    size?: string;                // Max email size (e.g., '100kb')
+    deliveryTime?: number;        // Max delivery time (ms)
+  };
+}
+```
+
+## Test Patterns
+
+Pre-configured test patterns for common scenarios:
+
+### Welcome Email
+
+```typescript
+import { EmailTestPatterns } from '@bernierllc/email-testing-suite';
+
+const result = await EmailTestPatterns.testWelcomeEmail(
+  './templates/welcome.html',
+  { name: 'John Doe', email: 'john@example.com' }
+);
+```
+
+### Password Reset Email
+
+```typescript
+const result = await EmailTestPatterns.testPasswordResetEmail(
+  './templates/reset.html',
+  { email: 'user@example.com', resetLink: 'https://example.com/reset?token=abc' }
+);
+```
+
+### Newsletter Email
+
+```typescript
+const result = await EmailTestPatterns.testNewsletterEmail(
+  './templates/newsletter.html',
+  { title: 'Monthly Update', articles: [...] },
+  'subscriber@example.com'
+);
+```
+
+### Transactional Email
+
+```typescript
+const result = await EmailTestPatterns.testTransactionalEmail(
+  './templates/order-confirmation.html',
+  { orderNumber: '12345', total: '$99.99' },
+  'customer@example.com'
+);
+```
+
+## Email Flow Testing
+
+Test multi-step email workflows:
+
+```typescript
+const flowResult = await suite.testEmailFlow({
+  name: 'User Onboarding Flow',
+  steps: [
+    { trigger: 'user.signup', template: 'welcome', delay: 0 },
+    { trigger: 'user.verify', template: 'verification', delay: 300000 },
+    { trigger: 'user.complete', template: 'onboarding', delay: 86400000 }
+  ],
+  assertions: [
+    { step: 1, assertion: 'delivered' },
+    { step: 2, assertion: 'contains_verification_link' },
+    { step: 3, assertion: 'personalized_content' }
+  ]
+});
+```
+
+## Analytics
+
+Track and analyze email testing performance:
+
+```typescript
+import { EmailTestAnalytics } from '@bernierllc/email-testing-suite';
+
+const analytics = new EmailTestAnalytics();
+
+// Add test results
+analytics.addTestResult(result);
+
+// Generate analytics
+const data = analytics.generateAnalytics('last_30_days');
+console.log(`Success Rate: ${data.successRate}%`);
+console.log(`Average Score: ${data.performanceMetrics.averageRenderTime}ms`);
+
+// Export analytics
+const json = analytics.exportAsJSON();
+const csv = analytics.exportAsCSV();
+```
+
+## Best Practices
+
+Get best practice recommendations:
+
+```typescript
+import { BestPracticesValidator } from '@bernierllc/email-testing-suite';
+
+// Validate email
+const validation = BestPracticesValidator.validateEmail(emailData);
+console.log(`Score: ${validation.score}`);
+console.log(`Recommendations: ${validation.recommendations.length}`);
+
+// Get compliance checklist
+const checklist = BestPracticesValidator.getComplianceChecklist('US');
+
+// Get accessibility guidelines
+const guidelines = BestPracticesValidator.getAccessibilityGuidelines();
+
+// Get performance tips
+const tips = BestPracticesValidator.getPerformanceOptimizationTips();
+
+// Get recommended coverage
+const coverage = BestPracticesValidator.getRecommendedCoverage('marketing');
+```
+
+## Test Suite Execution
+
+Run multiple tests together:
+
+```typescript
+const tests = [
+  {
+    name: 'Welcome Email',
+    template: 'welcome.html',
+    data: { name: 'User 1' },
+    recipients: ['test1@example.com']
+  },
+  {
+    name: 'Newsletter',
+    template: 'newsletter.html',
+    data: { content: '...' },
+    recipients: ['test2@example.com']
+  }
+];
+
+const suiteResult = await suite.runTestSuite(tests);
+
+console.log(`Total: ${suiteResult.totalTests}`);
+console.log(`Passed: ${suiteResult.passedTests}`);
+console.log(`Failed: ${suiteResult.failedTests}`);
+console.log(`Average Score: ${suiteResult.summary.averageScore}`);
+```
+
+## Jest Integration
+
+```typescript
+describe('Email Templates', () => {
+  let suite: EmailTestingSuite;
+
+  beforeAll(async () => {
+    suite = new EmailTestingSuite({
+      smtp: { port: process.env.SMTP_PORT || 2525 },
+      defaults: { compliance: 'US', timeout: 30000 }
+    });
+    await suite.start();
+  });
+
+  afterAll(async () => {
+    await suite.stop();
+  });
+
+  test('welcome email passes validation', async () => {
+    const result = await suite.testEmailTemplate({
+      name: 'Welcome Email',
+      template: './templates/welcome.html',
+      data: { name: 'Test User' },
+      recipients: ['test@example.com']
+    });
+
+    expect(result.success).toBe(true);
+    expect(result.score).toBeGreaterThan(90);
+  });
+});
+```
+
+## Data Generation
+
+Generate test data from a schema:
+
+```typescript
+const schema = {
+  name: { type: 'string', required: true },
+  email: { type: 'email', required: true },
+  age: { type: 'number', min: 18, max: 100 },
+  joinDate: { type: 'date' },
+  website: { type: 'url' },
+  userId: { type: 'uuid' }
+};
+
+const testData = suite.generateTestData(schema);
+// Returns: { name: 'test-name', email: 'test-email@example.com', age: 18, ... }
+```
+
+## API Reference
+
+### EmailTestingSuite
+
+- `constructor(config?: EmailTestingSuiteConfig)` - Create new suite instance
+- `async start()` - Start the testing environment
+- `async stop()` - Stop the testing environment
+- `async reset()` - Reset captured emails and state
+- `async testEmailTemplate(spec: EmailTemplateTest)` - Test an email template
+- `async testEmailFlow(flow: EmailFlowTest)` - Test an email flow
+- `async runTestSuite(tests: EmailTest[])` - Run multiple tests
+- `getTestingEnvironment()` - Get current environment state
+- `generateTestData(schema: DataSchema)` - Generate test data
+- `getTestHistory()` - Get all test results
+- `clearTestHistory()` - Clear test history
+
+### EmailTestAnalytics
+
+- `addTestResult(result: EmailTestResult)` - Add single result
+- `addTestResults(results: EmailTestResult[])` - Add multiple results
+- `generateAnalytics(period: string)` - Generate analytics report
+- `exportAsJSON(period?: string)` - Export as JSON
+- `exportAsCSV(period?: string)` - Export as CSV
+- `getTestHistory()` - Get all results
+- `clearHistory()` - Clear history
+
+### BestPracticesValidator
+
+- `static validateEmail(email: EmailData)` - Validate email against best practices
+- `static getRecommendedCoverage(emailType: string)` - Get recommended validators
+- `static getComplianceChecklist(region: 'US' | 'EU' | 'GLOBAL')` - Get compliance checklist
+- `static getAccessibilityGuidelines()` - Get accessibility guidelines
+- `static getPerformanceOptimizationTips()` - Get performance tips
+
+## License
+
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.

package/dist/analytics.d.ts

@@ -0,0 +1,52 @@
+import type { EmailTestResult, AnalyticsData } from './types';
+/**
+ * Analytics engine for email testing data
+ */
+export declare class EmailTestAnalytics {
+    private testHistory;
+    /**
+     * Add test result to analytics history
+     */
+    addTestResult(result: EmailTestResult): void;
+    /**
+     * Add multiple test results
+     */
+    addTestResults(results: EmailTestResult[]): void;
+    /**
+     * Generate analytics for a given period
+     */
+    generateAnalytics(period?: string): AnalyticsData;
+    /**
+     * Filter test results by period
+     */
+    private filterByPeriod;
+    /**
+     * Calculate trend data
+     */
+    private calculateTrends;
+    /**
+     * Identify top issues from test results
+     */
+    private identifyTopIssues;
+    /**
+     * Calculate performance metrics
+     */
+    private calculatePerformanceMetrics;
+    /**
+     * Get test history
+     */
+    getTestHistory(): EmailTestResult[];
+    /**
+     * Clear analytics history
+     */
+    clearHistory(): void;
+    /**
+     * Export analytics data as JSON
+     */
+    exportAsJSON(period?: string): string;
+    /**
+     * Export analytics data as CSV
+     */
+    exportAsCSV(period?: string): string;
+}
+//# sourceMappingURL=analytics.d.ts.map

package/dist/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EAId,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAAyB;IAE5C;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAI5C;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,IAAI;IAIhD;;OAEG;IACH,iBAAiB,CAAC,MAAM,GAAE,MAAuB,GAAG,aAAa;IAqBjE;;OAEG;IACH,OAAO,CAAC,cAAc;IAwBtB;;OAEG;IACH,OAAO,CAAC,eAAe;IA2BvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiDzB;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAuBnC;;OAEG;IACH,cAAc,IAAI,eAAe,EAAE;IAInC;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,YAAY,CAAC,MAAM,GAAE,MAAuB,GAAG,MAAM;IAKrD;;OAEG;IACH,WAAW,CAAC,MAAM,GAAE,MAAuB,GAAG,MAAM;CAoCrD"}

package/dist/analytics.js

@@ -0,0 +1,211 @@
+"use strict";
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailTestAnalytics = void 0;
+/**
+ * Analytics engine for email testing data
+ */
+class EmailTestAnalytics {
+    testHistory = [];
+    /**
+     * Add test result to analytics history
+     */
+    addTestResult(result) {
+        this.testHistory.push(result);
+    }
+    /**
+     * Add multiple test results
+     */
+    addTestResults(results) {
+        this.testHistory.push(...results);
+    }
+    /**
+     * Generate analytics for a given period
+     */
+    generateAnalytics(period = 'last_30_days') {
+        const filteredResults = this.filterByPeriod(period);
+        const testCount = filteredResults.length;
+        const successCount = filteredResults.filter((r) => r.success).length;
+        const successRate = testCount > 0 ? (successCount / testCount) * 100 : 0;
+        const trends = this.calculateTrends(filteredResults);
+        const topIssues = this.identifyTopIssues(filteredResults);
+        const performanceMetrics = this.calculatePerformanceMetrics(filteredResults);
+        return {
+            period,
+            testCount,
+            successRate,
+            trends,
+            topIssues,
+            performanceMetrics,
+        };
+    }
+    /**
+     * Filter test results by period
+     */
+    filterByPeriod(period) {
+        const now = new Date();
+        let cutoffDate;
+        switch (period) {
+            case 'last_7_days':
+                cutoffDate = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
+                break;
+            case 'last_30_days':
+                cutoffDate = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
+                break;
+            case 'last_90_days':
+                cutoffDate = new Date(now.getTime() - 90 * 24 * 60 * 60 * 1000);
+                break;
+            default:
+                cutoffDate = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
+        }
+        return this.testHistory.filter((result) => {
+            const resultDate = new Date(result.timestamp);
+            return resultDate >= cutoffDate;
+        });
+    }
+    /**
+     * Calculate trend data
+     */
+    calculateTrends(results) {
+        const trendMap = new Map();
+        for (const result of results) {
+            const date = new Date(result.timestamp).toISOString().split('T')[0];
+            if (!trendMap.has(date)) {
+                trendMap.set(date, {
+                    date,
+                    successRate: 0,
+                    testCount: 0,
+                    averageScore: 0,
+                });
+            }
+            const trend = trendMap.get(date);
+            trend.testCount++;
+            trend.averageScore = (trend.averageScore * (trend.testCount - 1) + result.score) / trend.testCount;
+            if (result.success) {
+                trend.successRate = ((trend.successRate * (trend.testCount - 1)) / trend.testCount) * 100;
+            }
+        }
+        return Array.from(trendMap.values()).sort((a, b) => a.date.localeCompare(b.date));
+    }
+    /**
+     * Identify top issues from test results
+     */
+    identifyTopIssues(results) {
+        const issueMap = new Map();
+        for (const result of results) {
+            if (result.errors && result.errors.length > 0) {
+                for (const error of result.errors) {
+                    const key = error.substring(0, 100); // Normalize error message
+                    if (!issueMap.has(key)) {
+                        issueMap.set(key, {
+                            issue: key,
+                            count: 0,
+                            severity: 'error',
+                        });
+                    }
+                    const issue = issueMap.get(key);
+                    issue.count++;
+                }
+            }
+            // Check validation warnings
+            if (result.validations) {
+                for (const validation of result.validations) {
+                    if (validation.warnings && validation.warnings.length > 0) {
+                        for (const warning of validation.warnings) {
+                            const key = warning.substring(0, 100);
+                            if (!issueMap.has(key)) {
+                                issueMap.set(key, {
+                                    issue: key,
+                                    count: 0,
+                                    severity: 'warning',
+                                });
+                            }
+                            const issue = issueMap.get(key);
+                            issue.count++;
+                        }
+                    }
+                }
+            }
+        }
+        return Array.from(issueMap.values())
+            .sort((a, b) => b.count - a.count)
+            .slice(0, 10);
+    }
+    /**
+     * Calculate performance metrics
+     */
+    calculatePerformanceMetrics(results) {
+        if (results.length === 0) {
+            return {
+                averageRenderTime: 0,
+                averageDeliveryTime: 0,
+                averageSize: 0,
+            };
+        }
+        const totalDuration = results.reduce((sum, r) => sum + r.duration, 0);
+        const averageRenderTime = totalDuration / results.length;
+        // Mock delivery time and size calculations
+        const averageDeliveryTime = averageRenderTime * 1.5;
+        const averageSize = 50000; // Mock value
+        return {
+            averageRenderTime,
+            averageDeliveryTime,
+            averageSize,
+        };
+    }
+    /**
+     * Get test history
+     */
+    getTestHistory() {
+        return [...this.testHistory];
+    }
+    /**
+     * Clear analytics history
+     */
+    clearHistory() {
+        this.testHistory = [];
+    }
+    /**
+     * Export analytics data as JSON
+     */
+    exportAsJSON(period = 'last_30_days') {
+        const analytics = this.generateAnalytics(period);
+        return JSON.stringify(analytics, null, 2);
+    }
+    /**
+     * Export analytics data as CSV
+     */
+    exportAsCSV(period = 'last_30_days') {
+        const analytics = this.generateAnalytics(period);
+        const lines = [];
+        // Header
+        lines.push('Metric,Value');
+        // Summary metrics
+        lines.push(`Test Count,${analytics.testCount}`);
+        lines.push(`Success Rate,${analytics.successRate.toFixed(2)}%`);
+        lines.push(`Average Render Time,${analytics.performanceMetrics.averageRenderTime.toFixed(2)}ms`);
+        lines.push(`Average Delivery Time,${analytics.performanceMetrics.averageDeliveryTime.toFixed(2)}ms`);
+        lines.push(`Average Size,${analytics.performanceMetrics.averageSize} bytes`);
+        // Trends
+        lines.push('');
+        lines.push('Date,Test Count,Success Rate,Average Score');
+        for (const trend of analytics.trends) {
+            lines.push(`${trend.date},${trend.testCount},${trend.successRate.toFixed(2)}%,${trend.averageScore.toFixed(2)}`);
+        }
+        // Top Issues
+        lines.push('');
+        lines.push('Issue,Count,Severity');
+        for (const issue of analytics.topIssues) {
+            lines.push(`"${issue.issue}",${issue.count},${issue.severity}`);
+        }
+        return lines.join('\n');
+    }
+}
+exports.EmailTestAnalytics = EmailTestAnalytics;
+//# sourceMappingURL=analytics.js.map

package/dist/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"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"}

package/dist/best-practices.d.ts

@@ -0,0 +1,34 @@
+import type { EmailData, Recommendation } from './types';
+/**
+ * Best practices validator for email testing
+ */
+export declare class BestPracticesValidator {
+    /**
+     * Validate email against best practices
+     */
+    static validateEmail(email: EmailData): {
+        passed: boolean;
+        score: number;
+        recommendations: Recommendation[];
+    };
+    /**
+     * Get recommended test coverage for email type
+     */
+    static getRecommendedCoverage(emailType: string): {
+        validators: string[];
+        description: string;
+    };
+    /**
+     * Generate compliance checklist
+     */
+    static getComplianceChecklist(region: 'US' | 'EU' | 'GLOBAL'): string[];
+    /**
+     * Get accessibility guidelines
+     */
+    static getAccessibilityGuidelines(): Recommendation[];
+    /**
+     * Get performance optimization tips
+     */
+    static getPerformanceOptimizationTips(): Recommendation[];
+}
+//# sourceMappingURL=best-practices.d.ts.map

package/dist/best-practices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"best-practices.d.ts","sourceRoot":"","sources":["../src/best-practices.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzD;;GAEG;AACH,qBAAa,sBAAsB;IACjC;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG;QACtC,MAAM,EAAE,OAAO,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,eAAe,EAAE,cAAc,EAAE,CAAC;KACnC;IA4HD;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG;QAChD,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB;IA8BD;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,QAAQ,GAAG,MAAM,EAAE;IA4BvE;;OAEG;IACH,MAAM,CAAC,0BAA0B,IAAI,cAAc,EAAE;IAwCrD;;OAEG;IACH,MAAM,CAAC,8BAA8B,IAAI,cAAc,EAAE;CAuC1D"}