Content
Unsubscribe'\n};\n\n// Use fluent API for assertions\nexpect(email)\n .toHaveSender('noreply@example.com')\n .toHaveRecipient('user@example.com')\n .toHaveSubject(/Welcome to/)\n .toContainText('Welcome John')\n .toHaveReplacedAllVariables()\n .toHaveUnsubscribeLink();\n```\n\n### Jest Integration\n\n```typescript\nimport { setupJestMatchers } from '@bernierllc/email-test-assertions/matchers/jest';\n\n// In Jest setup file (e.g., jest.setup.js)\nsetupJestMatchers();\n\n// In test files\ntest('should send welcome email', async () => {\n const email = await captureEmail();\n\n expect(email).toHaveEmailRecipient('user@example.com');\n expect(email).toHaveEmailSubject(/Welcome/);\n expect(email).toHaveValidEmailTemplate();\n expect(email).toBeCompliantEmail('US');\n});\n```\n\n### Vitest Integration\n\n```typescript\nimport { setupVitestMatchers } from '@bernierllc/email-test-assertions/matchers/vitest';\n\n// In Vitest setup file\nsetupVitestMatchers();\n\n// In test files\ntest('should send notification email', async () => {\n const email = await captureEmail();\n\n expect(email).toHaveEmailSender('notifications@example.com');\n expect(email).toContainEmailText('Important update');\n expect(email).toHaveEmailAttachment('report.pdf');\n});\n```\n\n### Async Email Waiting\n\n```typescript\nimport { waitForEmail, waitForEmails, EmailWaiter } from '@bernierllc/email-test-assertions';\n\n// Wait for a single email matching criteria\nconst welcomeEmail = await waitForEmail({\n recipient: 'user@example.com',\n subject: /Welcome/,\n timeout: 5000\n});\n\n// Wait for multiple emails\nconst notifications = await waitForEmails(3, {\n recipient: 'user@example.com',\n timeout: 5000\n});\n\n// Wait by subject\nconst resetEmail = await waitForEmailWithSubject(/Password Reset/);\n\n// Custom waiter instance\nconst waiter = new EmailWaiter({\n defaultTimeout: 10000,\n defaultRetryInterval: 100\n});\n\n// Add emails to waiter (for testing)\nwaiter.addEmail(parsedEmail);\n\n// Wait for email\nconst email = await waiter.waitForEmail({\n recipient: 'user@example.com'\n});\n```\n\n## API Reference\n\n### Assertion Methods\n\n#### Basic Properties\n\n- `toHaveRecipient(email: string)` - Assert email has specific recipient\n- `toHaveSender(email: string)` - Assert email has specific sender\n- `toHaveSubject(subject: string | RegExp)` - Assert email has subject\n\n#### Content\n\n- `toHaveTextContent(content: string | RegExp)` - Assert text content\n- `toHaveHtmlContent(html: string | RegExp)` - Assert HTML content\n- `toContainText(text: string)` - Assert email contains text\n\n#### Template Variables\n\n- `toHaveReplacedAllVariables()` - Assert all variables replaced\n- `toHaveVariable(name: string, value: string)` - Assert variable has value\n- `toNotContainUnreplacedVariables()` - Alias for toHaveReplacedAllVariables\n\n#### Compliance\n\n- `toHaveUnsubscribeLink()` - Assert unsubscribe link present\n- `toHavePhysicalAddress()` - Assert physical address present\n- `toBeCompliant(region: 'US' | 'EU' | 'GLOBAL')` - Assert compliance with regulations\n\n#### Attachments\n\n- `toHaveAttachment(filename: string)` - Assert specific attachment\n- `toHaveAttachmentCount(count: number)` - Assert attachment count\n\n#### SMTP\n\n- `toHaveBeenDelivered()` - Assert email was delivered\n- `toHavePassedSPF()` - Assert SPF validation passed\n- `toHaveValidDKIM()` - Assert DKIM signature valid\n\n#### Timing\n\n- `toHaveBeenSentWithin(timespan: number)` - Assert sent within timespan (ms)\n- `toHaveBeenReceivedAfter(date: Date)` - Assert received after date\n\n### Jest Matchers\n\n- `toHaveEmailRecipient(email: string)`\n- `toHaveEmailSender(email: string)`\n- `toHaveEmailSubject(subject: string | RegExp)`\n- `toHaveValidEmailTemplate()`\n- `toBeCompliantEmail(region?: 'US' | 'EU' | 'GLOBAL')`\n- `toContainEmailText(text: string)`\n- `toHaveEmailAttachment(filename: string)`\n\n### Email Waiter API\n\n```typescript\ninterface EmailWaiterConfig {\n defaultTimeout?: number; // Default: 5000ms\n defaultRetryInterval?: number; // Default: 100ms\n emailStore?: CapturedEmail[]; // Pre-populate email store\n}\n\ninterface EmailCriteria {\n recipient?: string;\n sender?: string;\n subject?: string | RegExp;\n timeout?: number;\n retryInterval?: number;\n}\n\nclass EmailWaiter {\n waitForEmail(criteria: EmailCriteria): Promise