@bernierllc/email-testing-suite 0.7.12 → 0.7.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,52 @@
1
+ import type { EmailTestResult, AnalyticsData } from './types';
2
+ /**
3
+ * Analytics engine for email testing data
4
+ */
5
+ export declare class EmailTestAnalytics {
6
+ private testHistory;
7
+ /**
8
+ * Add test result to analytics history
9
+ */
10
+ addTestResult(result: EmailTestResult): void;
11
+ /**
12
+ * Add multiple test results
13
+ */
14
+ addTestResults(results: EmailTestResult[]): void;
15
+ /**
16
+ * Generate analytics for a given period
17
+ */
18
+ generateAnalytics(period?: string): AnalyticsData;
19
+ /**
20
+ * Filter test results by period
21
+ */
22
+ private filterByPeriod;
23
+ /**
24
+ * Calculate trend data
25
+ */
26
+ private calculateTrends;
27
+ /**
28
+ * Identify top issues from test results
29
+ */
30
+ private identifyTopIssues;
31
+ /**
32
+ * Calculate performance metrics
33
+ */
34
+ private calculatePerformanceMetrics;
35
+ /**
36
+ * Get test history
37
+ */
38
+ getTestHistory(): EmailTestResult[];
39
+ /**
40
+ * Clear analytics history
41
+ */
42
+ clearHistory(): void;
43
+ /**
44
+ * Export analytics data as JSON
45
+ */
46
+ exportAsJSON(period?: string): string;
47
+ /**
48
+ * Export analytics data as CSV
49
+ */
50
+ exportAsCSV(period?: string): string;
51
+ }
52
+ //# sourceMappingURL=analytics.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,211 @@
1
+ "use strict";
2
+ /*
3
+ Copyright (c) 2025 Bernier LLC
4
+
5
+ This file is licensed to the client under a limited-use license.
6
+ The client may use and modify this code *only within the scope of the project it was delivered for*.
7
+ Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.EmailTestAnalytics = void 0;
11
+ /**
12
+ * Analytics engine for email testing data
13
+ */
14
+ class EmailTestAnalytics {
15
+ testHistory = [];
16
+ /**
17
+ * Add test result to analytics history
18
+ */
19
+ addTestResult(result) {
20
+ this.testHistory.push(result);
21
+ }
22
+ /**
23
+ * Add multiple test results
24
+ */
25
+ addTestResults(results) {
26
+ this.testHistory.push(...results);
27
+ }
28
+ /**
29
+ * Generate analytics for a given period
30
+ */
31
+ generateAnalytics(period = 'last_30_days') {
32
+ const filteredResults = this.filterByPeriod(period);
33
+ const testCount = filteredResults.length;
34
+ const successCount = filteredResults.filter((r) => r.success).length;
35
+ const successRate = testCount > 0 ? (successCount / testCount) * 100 : 0;
36
+ const trends = this.calculateTrends(filteredResults);
37
+ const topIssues = this.identifyTopIssues(filteredResults);
38
+ const performanceMetrics = this.calculatePerformanceMetrics(filteredResults);
39
+ return {
40
+ period,
41
+ testCount,
42
+ successRate,
43
+ trends,
44
+ topIssues,
45
+ performanceMetrics,
46
+ };
47
+ }
48
+ /**
49
+ * Filter test results by period
50
+ */
51
+ filterByPeriod(period) {
52
+ const now = new Date();
53
+ let cutoffDate;
54
+ switch (period) {
55
+ case 'last_7_days':
56
+ cutoffDate = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
57
+ break;
58
+ case 'last_30_days':
59
+ cutoffDate = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
60
+ break;
61
+ case 'last_90_days':
62
+ cutoffDate = new Date(now.getTime() - 90 * 24 * 60 * 60 * 1000);
63
+ break;
64
+ default:
65
+ cutoffDate = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
66
+ }
67
+ return this.testHistory.filter((result) => {
68
+ const resultDate = new Date(result.timestamp);
69
+ return resultDate >= cutoffDate;
70
+ });
71
+ }
72
+ /**
73
+ * Calculate trend data
74
+ */
75
+ calculateTrends(results) {
76
+ const trendMap = new Map();
77
+ for (const result of results) {
78
+ const date = new Date(result.timestamp).toISOString().split('T')[0];
79
+ if (!trendMap.has(date)) {
80
+ trendMap.set(date, {
81
+ date,
82
+ successRate: 0,
83
+ testCount: 0,
84
+ averageScore: 0,
85
+ });
86
+ }
87
+ const trend = trendMap.get(date);
88
+ trend.testCount++;
89
+ trend.averageScore = (trend.averageScore * (trend.testCount - 1) + result.score) / trend.testCount;
90
+ if (result.success) {
91
+ trend.successRate = ((trend.successRate * (trend.testCount - 1)) / trend.testCount) * 100;
92
+ }
93
+ }
94
+ return Array.from(trendMap.values()).sort((a, b) => a.date.localeCompare(b.date));
95
+ }
96
+ /**
97
+ * Identify top issues from test results
98
+ */
99
+ identifyTopIssues(results) {
100
+ const issueMap = new Map();
101
+ for (const result of results) {
102
+ if (result.errors && result.errors.length > 0) {
103
+ for (const error of result.errors) {
104
+ const key = error.substring(0, 100); // Normalize error message
105
+ if (!issueMap.has(key)) {
106
+ issueMap.set(key, {
107
+ issue: key,
108
+ count: 0,
109
+ severity: 'error',
110
+ });
111
+ }
112
+ const issue = issueMap.get(key);
113
+ issue.count++;
114
+ }
115
+ }
116
+ // Check validation warnings
117
+ if (result.validations) {
118
+ for (const validation of result.validations) {
119
+ if (validation.warnings && validation.warnings.length > 0) {
120
+ for (const warning of validation.warnings) {
121
+ const key = warning.substring(0, 100);
122
+ if (!issueMap.has(key)) {
123
+ issueMap.set(key, {
124
+ issue: key,
125
+ count: 0,
126
+ severity: 'warning',
127
+ });
128
+ }
129
+ const issue = issueMap.get(key);
130
+ issue.count++;
131
+ }
132
+ }
133
+ }
134
+ }
135
+ }
136
+ return Array.from(issueMap.values())
137
+ .sort((a, b) => b.count - a.count)
138
+ .slice(0, 10);
139
+ }
140
+ /**
141
+ * Calculate performance metrics
142
+ */
143
+ calculatePerformanceMetrics(results) {
144
+ if (results.length === 0) {
145
+ return {
146
+ averageRenderTime: 0,
147
+ averageDeliveryTime: 0,
148
+ averageSize: 0,
149
+ };
150
+ }
151
+ const totalDuration = results.reduce((sum, r) => sum + r.duration, 0);
152
+ const averageRenderTime = totalDuration / results.length;
153
+ // Mock delivery time and size calculations
154
+ const averageDeliveryTime = averageRenderTime * 1.5;
155
+ const averageSize = 50000; // Mock value
156
+ return {
157
+ averageRenderTime,
158
+ averageDeliveryTime,
159
+ averageSize,
160
+ };
161
+ }
162
+ /**
163
+ * Get test history
164
+ */
165
+ getTestHistory() {
166
+ return [...this.testHistory];
167
+ }
168
+ /**
169
+ * Clear analytics history
170
+ */
171
+ clearHistory() {
172
+ this.testHistory = [];
173
+ }
174
+ /**
175
+ * Export analytics data as JSON
176
+ */
177
+ exportAsJSON(period = 'last_30_days') {
178
+ const analytics = this.generateAnalytics(period);
179
+ return JSON.stringify(analytics, null, 2);
180
+ }
181
+ /**
182
+ * Export analytics data as CSV
183
+ */
184
+ exportAsCSV(period = 'last_30_days') {
185
+ const analytics = this.generateAnalytics(period);
186
+ const lines = [];
187
+ // Header
188
+ lines.push('Metric,Value');
189
+ // Summary metrics
190
+ lines.push(`Test Count,${analytics.testCount}`);
191
+ lines.push(`Success Rate,${analytics.successRate.toFixed(2)}%`);
192
+ lines.push(`Average Render Time,${analytics.performanceMetrics.averageRenderTime.toFixed(2)}ms`);
193
+ lines.push(`Average Delivery Time,${analytics.performanceMetrics.averageDeliveryTime.toFixed(2)}ms`);
194
+ lines.push(`Average Size,${analytics.performanceMetrics.averageSize} bytes`);
195
+ // Trends
196
+ lines.push('');
197
+ lines.push('Date,Test Count,Success Rate,Average Score');
198
+ for (const trend of analytics.trends) {
199
+ lines.push(`${trend.date},${trend.testCount},${trend.successRate.toFixed(2)}%,${trend.averageScore.toFixed(2)}`);
200
+ }
201
+ // Top Issues
202
+ lines.push('');
203
+ lines.push('Issue,Count,Severity');
204
+ for (const issue of analytics.topIssues) {
205
+ lines.push(`"${issue.issue}",${issue.count},${issue.severity}`);
206
+ }
207
+ return lines.join('\n');
208
+ }
209
+ }
210
+ exports.EmailTestAnalytics = EmailTestAnalytics;
211
+ //# sourceMappingURL=analytics.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"analytics.js","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,34 @@
1
+ import type { EmailData, Recommendation } from './types';
2
+ /**
3
+ * Best practices validator for email testing
4
+ */
5
+ export declare class BestPracticesValidator {
6
+ /**
7
+ * Validate email against best practices
8
+ */
9
+ static validateEmail(email: EmailData): {
10
+ passed: boolean;
11
+ score: number;
12
+ recommendations: Recommendation[];
13
+ };
14
+ /**
15
+ * Get recommended test coverage for email type
16
+ */
17
+ static getRecommendedCoverage(emailType: string): {
18
+ validators: string[];
19
+ description: string;
20
+ };
21
+ /**
22
+ * Generate compliance checklist
23
+ */
24
+ static getComplianceChecklist(region: 'US' | 'EU' | 'GLOBAL'): string[];
25
+ /**
26
+ * Get accessibility guidelines
27
+ */
28
+ static getAccessibilityGuidelines(): Recommendation[];
29
+ /**
30
+ * Get performance optimization tips
31
+ */
32
+ static getPerformanceOptimizationTips(): Recommendation[];
33
+ }
34
+ //# sourceMappingURL=best-practices.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,268 @@
1
+ "use strict";
2
+ /*
3
+ Copyright (c) 2025 Bernier LLC
4
+
5
+ This file is licensed to the client under a limited-use license.
6
+ The client may use and modify this code *only within the scope of the project it was delivered for*.
7
+ Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.BestPracticesValidator = void 0;
11
+ /**
12
+ * Best practices validator for email testing
13
+ */
14
+ class BestPracticesValidator {
15
+ /**
16
+ * Validate email against best practices
17
+ */
18
+ static validateEmail(email) {
19
+ const recommendations = [];
20
+ let score = 100;
21
+ // Check subject line
22
+ if (!email.subject || email.subject.length === 0) {
23
+ recommendations.push({
24
+ category: 'Subject Line',
25
+ priority: 'high',
26
+ title: 'Missing subject line',
27
+ description: 'Email should have a subject line',
28
+ action: 'Add a descriptive subject line to the email',
29
+ });
30
+ score -= 20;
31
+ }
32
+ else if (email.subject.length > 60) {
33
+ recommendations.push({
34
+ category: 'Subject Line',
35
+ priority: 'medium',
36
+ title: 'Subject line too long',
37
+ description: 'Subject line should be under 60 characters for optimal display',
38
+ action: 'Shorten the subject line to 60 characters or less',
39
+ });
40
+ score -= 5;
41
+ }
42
+ // Check HTML content
43
+ if (email.html) {
44
+ if (!email.html.includes('<!DOCTYPE') && !email.html.includes('<html')) {
45
+ recommendations.push({
46
+ category: 'HTML Structure',
47
+ priority: 'medium',
48
+ title: 'Missing HTML structure',
49
+ description: 'Email HTML should include proper DOCTYPE and html tags',
50
+ action: 'Add proper HTML structure to the email template',
51
+ });
52
+ score -= 10;
53
+ }
54
+ // Check for alt text on images
55
+ const imgTags = email.html.match(/<img[^>]*>/g) || [];
56
+ const imagesWithoutAlt = imgTags.filter((tag) => !tag.includes('alt=')).length;
57
+ if (imagesWithoutAlt > 0) {
58
+ recommendations.push({
59
+ category: 'Accessibility',
60
+ priority: 'high',
61
+ title: 'Images missing alt text',
62
+ description: `${imagesWithoutAlt} image(s) do not have alt text`,
63
+ action: 'Add descriptive alt text to all images for accessibility',
64
+ });
65
+ score -= 15;
66
+ }
67
+ // Check for responsive design
68
+ if (!email.html.includes('viewport') && !email.html.includes('media query')) {
69
+ recommendations.push({
70
+ category: 'Responsive Design',
71
+ priority: 'medium',
72
+ title: 'Email may not be mobile-friendly',
73
+ description: 'Email does not appear to include responsive design elements',
74
+ action: 'Add viewport meta tag and media queries for mobile support',
75
+ });
76
+ score -= 10;
77
+ }
78
+ }
79
+ // Check plain text version
80
+ if (!email.text || email.text.length === 0) {
81
+ recommendations.push({
82
+ category: 'Content',
83
+ priority: 'medium',
84
+ title: 'Missing plain text version',
85
+ description: 'Email should include a plain text version for accessibility',
86
+ action: 'Add a plain text version of the email content',
87
+ });
88
+ score -= 10;
89
+ }
90
+ // Check for unsubscribe link (basic check)
91
+ const hasUnsubscribe = (email.html && email.html.toLowerCase().includes('unsubscribe')) ||
92
+ (email.text && email.text.toLowerCase().includes('unsubscribe'));
93
+ if (!hasUnsubscribe) {
94
+ recommendations.push({
95
+ category: 'Compliance',
96
+ priority: 'high',
97
+ title: 'Missing unsubscribe link',
98
+ description: 'Email should include an unsubscribe link for compliance',
99
+ action: 'Add an unsubscribe link to the email footer',
100
+ });
101
+ score -= 20;
102
+ }
103
+ // Check from address
104
+ if (!email.from || !email.from.includes('@')) {
105
+ recommendations.push({
106
+ category: 'Sender Information',
107
+ priority: 'high',
108
+ title: 'Invalid from address',
109
+ description: 'Email must have a valid from address',
110
+ action: 'Ensure the from address is a valid email address',
111
+ });
112
+ score -= 15;
113
+ }
114
+ // Check recipients
115
+ if (!email.to || email.to.length === 0) {
116
+ recommendations.push({
117
+ category: 'Recipients',
118
+ priority: 'high',
119
+ title: 'No recipients specified',
120
+ description: 'Email must have at least one recipient',
121
+ action: 'Add at least one recipient to the email',
122
+ });
123
+ score -= 20;
124
+ }
125
+ return {
126
+ passed: score >= 70,
127
+ score: Math.max(0, score),
128
+ recommendations,
129
+ };
130
+ }
131
+ /**
132
+ * Get recommended test coverage for email type
133
+ */
134
+ static getRecommendedCoverage(emailType) {
135
+ switch (emailType.toLowerCase()) {
136
+ case 'transactional':
137
+ return {
138
+ validators: ['template', 'compliance', 'performance', 'security'],
139
+ description: 'Transactional emails require template accuracy, compliance, fast delivery, and security',
140
+ };
141
+ case 'marketing':
142
+ return {
143
+ validators: ['template', 'compliance', 'accessibility', 'performance'],
144
+ description: 'Marketing emails need full validation including accessibility and compliance',
145
+ };
146
+ case 'notification':
147
+ return {
148
+ validators: ['template', 'performance'],
149
+ description: 'Notification emails prioritize template accuracy and delivery speed',
150
+ };
151
+ case 'newsletter':
152
+ return {
153
+ validators: ['template', 'compliance', 'accessibility', 'performance'],
154
+ description: 'Newsletters require comprehensive validation for broad audience reach',
155
+ };
156
+ default:
157
+ return {
158
+ validators: ['template', 'compliance', 'accessibility', 'performance', 'security'],
159
+ description: 'Default comprehensive validation for all email types',
160
+ };
161
+ }
162
+ }
163
+ /**
164
+ * Generate compliance checklist
165
+ */
166
+ static getComplianceChecklist(region) {
167
+ const baseChecklist = [
168
+ 'Include valid from address',
169
+ 'Include unsubscribe link',
170
+ 'Include physical mailing address',
171
+ 'Accurate subject line (no deceptive practices)',
172
+ 'Honor opt-out requests promptly',
173
+ ];
174
+ if (region === 'EU' || region === 'GLOBAL') {
175
+ baseChecklist.push('Obtain explicit consent (GDPR)', 'Provide data privacy information', 'Enable data portability and deletion requests');
176
+ }
177
+ if (region === 'US' || region === 'GLOBAL') {
178
+ baseChecklist.push('Comply with CAN-SPAM Act', 'Include valid postal address', 'Process opt-out within 10 business days');
179
+ }
180
+ return baseChecklist;
181
+ }
182
+ /**
183
+ * Get accessibility guidelines
184
+ */
185
+ static getAccessibilityGuidelines() {
186
+ return [
187
+ {
188
+ category: 'Accessibility',
189
+ priority: 'high',
190
+ title: 'Provide alt text for all images',
191
+ description: 'Screen readers need descriptive alt text to convey image content',
192
+ action: 'Add meaningful alt attributes to all img tags',
193
+ },
194
+ {
195
+ category: 'Accessibility',
196
+ priority: 'high',
197
+ title: 'Use semantic HTML',
198
+ description: 'Proper heading hierarchy and semantic elements improve screen reader navigation',
199
+ action: 'Use h1-h6 tags appropriately and semantic HTML elements',
200
+ },
201
+ {
202
+ category: 'Accessibility',
203
+ priority: 'medium',
204
+ title: 'Ensure sufficient color contrast',
205
+ description: 'Text should have at least 4.5:1 contrast ratio with background',
206
+ action: 'Use color contrast checker and adjust colors as needed',
207
+ },
208
+ {
209
+ category: 'Accessibility',
210
+ priority: 'medium',
211
+ title: 'Avoid relying solely on color',
212
+ description: 'Important information should not be conveyed by color alone',
213
+ action: 'Use text labels, icons, or patterns in addition to color',
214
+ },
215
+ {
216
+ category: 'Accessibility',
217
+ priority: 'low',
218
+ title: 'Include plain text version',
219
+ description: 'Plain text version provides fallback for accessibility tools',
220
+ action: 'Generate plain text version of all HTML emails',
221
+ },
222
+ ];
223
+ }
224
+ /**
225
+ * Get performance optimization tips
226
+ */
227
+ static getPerformanceOptimizationTips() {
228
+ return [
229
+ {
230
+ category: 'Performance',
231
+ priority: 'high',
232
+ title: 'Optimize image sizes',
233
+ description: 'Large images increase email size and load time',
234
+ action: 'Compress images and use appropriate dimensions',
235
+ },
236
+ {
237
+ category: 'Performance',
238
+ priority: 'high',
239
+ title: 'Minimize CSS and inline styles',
240
+ description: 'Excessive CSS increases email size',
241
+ action: 'Inline critical CSS and remove unused styles',
242
+ },
243
+ {
244
+ category: 'Performance',
245
+ priority: 'medium',
246
+ title: 'Limit external resources',
247
+ description: 'External resources may be blocked or slow to load',
248
+ action: 'Inline images and styles when possible',
249
+ },
250
+ {
251
+ category: 'Performance',
252
+ priority: 'medium',
253
+ title: 'Keep total size under 102KB',
254
+ description: 'Gmail clips messages over 102KB',
255
+ action: 'Optimize content to stay under size threshold',
256
+ },
257
+ {
258
+ category: 'Performance',
259
+ priority: 'low',
260
+ title: 'Use web-safe fonts',
261
+ description: 'Custom fonts may not render consistently across clients',
262
+ action: 'Use web-safe fonts with appropriate fallbacks',
263
+ },
264
+ ];
265
+ }
266
+ }
267
+ exports.BestPracticesValidator = BestPracticesValidator;
268
+ //# sourceMappingURL=best-practices.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"best-practices.js","sourceRoot":"","sources":["../src/best-practices.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,74 @@
1
+ import type { EmailTestingSuiteConfig, EmailTemplateTest, EmailFlowTest, EmailTest, EmailTestResult, EmailFlowResult, EmailSuiteResult, TestingEnvironment, DataSchema } from './types';
2
+ /**
3
+ * Complete email testing solution with opinionated defaults
4
+ */
5
+ export declare class EmailTestingSuite {
6
+ private config;
7
+ private mockServer;
8
+ private orchestrator;
9
+ private running;
10
+ private capturedEmails;
11
+ private testHistory;
12
+ constructor(config?: EmailTestingSuiteConfig);
13
+ /**
14
+ * Merge user config with opinionated defaults
15
+ */
16
+ private mergeWithDefaults;
17
+ /**
18
+ * Start the email testing environment
19
+ */
20
+ start(): Promise<void>;
21
+ /**
22
+ * Stop the email testing environment
23
+ */
24
+ stop(): Promise<void>;
25
+ /**
26
+ * Reset the testing environment
27
+ */
28
+ reset(): Promise<void>;
29
+ /**
30
+ * Test an email template with comprehensive validation
31
+ */
32
+ testEmailTemplate(spec: EmailTemplateTest): Promise<EmailTestResult>;
33
+ /**
34
+ * Test an email flow with multiple steps
35
+ */
36
+ testEmailFlow(flow: EmailFlowTest): Promise<EmailFlowResult>;
37
+ /**
38
+ * Run a suite of email tests
39
+ */
40
+ runTestSuite(tests: EmailTest[]): Promise<EmailSuiteResult>;
41
+ /**
42
+ * Get the current testing environment state
43
+ */
44
+ getTestingEnvironment(): TestingEnvironment;
45
+ /**
46
+ * Generate test data based on a schema
47
+ */
48
+ generateTestData(schema: DataSchema): Record<string, any>;
49
+ /**
50
+ * Type guard for EmailTemplateTest
51
+ */
52
+ private isEmailTemplateTest;
53
+ /**
54
+ * Type guard for EmailFlowTest
55
+ */
56
+ private isEmailFlowTest;
57
+ /**
58
+ * Generate summary from test results
59
+ */
60
+ private generateSummary;
61
+ /**
62
+ * Generate a simple UUID
63
+ */
64
+ private generateUUID;
65
+ /**
66
+ * Get test history
67
+ */
68
+ getTestHistory(): EmailTestResult[];
69
+ /**
70
+ * Clear test history
71
+ */
72
+ clearTestHistory(): void;
73
+ }
74
+ //# sourceMappingURL=email-testing-suite.d.ts.map