@bernierllc/email-testing-suite 0.3.0 → 0.4.1

package/dist/feature-test-helpers.d.ts

@@ -0,0 +1,204 @@
+/**
+ * Test helper utilities for email feature packages.
+ *
+ * Provides mock factories, assertion helpers, and validation utilities
+ * for calendar events, batch sending, subscriptions, headers, and attachments.
+ *
+ * These helpers are designed for consumers of the email suite to use in their
+ * own test suites when building on top of @bernierllc email packages.
+ */
+import type { EmailData } from './types';
+/**
+ * Represents a calendar event for email invitations.
+ * Aligns with the planned @bernierllc/email-calendar package interface.
+ */
+export interface CalendarEvent {
+    uid: string;
+    summary: string;
+    description?: string;
+    location?: string;
+    dtstart: Date;
+    dtend: Date;
+    organizer: {
+        name: string;
+        email: string;
+    };
+    attendees?: Array<{
+        name: string;
+        email: string;
+        rsvp?: boolean;
+        role?: 'REQ-PARTICIPANT' | 'OPT-PARTICIPANT' | 'CHAIR';
+        status?: 'NEEDS-ACTION' | 'ACCEPTED' | 'DECLINED' | 'TENTATIVE';
+    }>;
+    method?: 'REQUEST' | 'REPLY' | 'CANCEL' | 'PUBLISH';
+    sequence?: number;
+    status?: 'CONFIRMED' | 'TENTATIVE' | 'CANCELLED';
+    rrule?: string;
+}
+/**
+ * Input for a single email in a batch send operation.
+ * Aligns with the planned @bernierllc/email-batch-sender package interface.
+ */
+export interface BatchEmailInput {
+    to: string;
+    subject: string;
+    html?: string;
+    text?: string;
+    from?: string;
+    headers?: Record<string, string>;
+    tags?: string[];
+    metadata?: Record<string, string>;
+}
+/**
+ * Result of a batch email send operation.
+ */
+export interface BatchResult {
+    total: number;
+    succeeded: number;
+    failed: number;
+    errors: Array<{
+        index: number;
+        email: string;
+        error: string;
+    }>;
+    duration: number;
+}
+/**
+ * Represents a subscription list.
+ * Aligns with the planned @bernierllc/email-subscription package interface.
+ */
+export interface SubscriberList {
+    id: string;
+    name: string;
+    description?: string;
+    subscribers: Subscriber[];
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Represents a subscriber within a list.
+ */
+export interface Subscriber {
+    id: string;
+    email: string;
+    name?: string;
+    status: 'active' | 'unsubscribed' | 'bounced' | 'complained';
+    subscribedAt: string;
+    unsubscribedAt?: string;
+    metadata?: Record<string, string>;
+    tags?: string[];
+}
+/**
+ * Represents a suppression entry.
+ */
+export interface Suppression {
+    email: string;
+    reason: 'bounce' | 'complaint' | 'unsubscribe' | 'manual';
+    createdAt: string;
+    source?: string;
+}
+/**
+ * Represents an email attachment.
+ * Aligns with the planned @bernierllc/email-attachments package interface.
+ */
+export interface Attachment {
+    filename: string;
+    content: Buffer | string;
+    contentType: string;
+    encoding?: 'base64' | 'binary' | 'utf-8';
+    contentDisposition?: 'attachment' | 'inline';
+    contentId?: string;
+    size?: number;
+}
+/**
+ * Creates a mock CalendarEvent with sensible defaults.
+ * Override any field by passing partial overrides.
+ */
+export declare function createMockCalendarEvent(overrides?: Partial<CalendarEvent>): CalendarEvent;
+/**
+ * Asserts that a string contains valid ICS (iCalendar) content.
+ * Validates required ICS properties and structure.
+ *
+ * @throws Error if the ICS content is invalid
+ */
+export declare function assertValidIcsContent(icsString: string): void;
+/**
+ * Asserts that an EmailData object represents a valid calendar invite email.
+ * Checks for a text/calendar attachment.
+ *
+ * @throws Error if the email is not a valid calendar invite
+ */
+export declare function assertCalendarInviteEmail(email: EmailData): void;
+/**
+ * Creates an array of mock batch email inputs.
+ *
+ * @param count - Number of mock emails to create
+ * @param overrides - Partial overrides applied to each email
+ */
+export declare function createMockBatchEmails(count: number, overrides?: Partial<BatchEmailInput>): BatchEmailInput[];
+/**
+ * Asserts that a BatchResult matches the given expectations.
+ *
+ * @throws Error if the result does not meet expectations
+ */
+export declare function assertBatchResult(result: BatchResult, expectations: {
+    minSucceeded?: number;
+    maxFailed?: number;
+}): void;
+/**
+ * Creates a mock SubscriberList with sensible defaults.
+ */
+export declare function createMockSubscriberList(overrides?: Partial<SubscriberList>): SubscriberList;
+/**
+ * Creates a mock Subscriber with sensible defaults.
+ */
+export declare function createMockSubscriber(overrides?: Partial<Subscriber>): Subscriber;
+/**
+ * Asserts that a subscriber has an active subscription.
+ *
+ * @throws Error if the subscriber is not active
+ */
+export declare function assertSubscriptionActive(subscriber: Subscriber): void;
+/**
+ * Asserts that a suppression entry is valid.
+ *
+ * @throws Error if the suppression is invalid
+ */
+export declare function assertSuppressed(suppression: Suppression): void;
+/**
+ * Asserts that headers contain email threading headers
+ * (In-Reply-To and/or References).
+ *
+ * @throws Error if threading headers are missing
+ */
+export declare function assertHasThreadingHeaders(headers: Record<string, string>): void;
+/**
+ * Asserts that headers contain List-Unsubscribe header(s).
+ * Validates both List-Unsubscribe and optionally List-Unsubscribe-Post (RFC 8058).
+ *
+ * @throws Error if List-Unsubscribe header is missing
+ */
+export declare function assertHasListUnsubscribeHeaders(headers: Record<string, string>): void;
+/**
+ * Asserts that headers contain a Disposition-Notification-To header (MDN request).
+ *
+ * @throws Error if MDN request header is missing
+ */
+export declare function assertHasMdnRequestHeader(headers: Record<string, string>): void;
+/**
+ * Creates a mock Attachment with sensible defaults.
+ */
+export declare function createMockAttachment(overrides?: Partial<Attachment>): Attachment;
+/**
+ * Asserts that an attachment has all required fields and valid values.
+ *
+ * @throws Error if the attachment is invalid
+ */
+export declare function assertValidAttachment(attachment: Attachment): void;
+/**
+ * Asserts that an attachment does not exceed the specified size in bytes.
+ *
+ * @throws Error if the attachment exceeds maxBytes
+ */
+export declare function assertAttachmentSize(attachment: Attachment, maxBytes: number): void;
+//# sourceMappingURL=feature-test-helpers.d.ts.map

package/dist/feature-test-helpers.d.ts.map

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

package/dist/feature-test-helpers.js

@@ -0,0 +1,375 @@
+"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.createMockCalendarEvent = createMockCalendarEvent;
+exports.assertValidIcsContent = assertValidIcsContent;
+exports.assertCalendarInviteEmail = assertCalendarInviteEmail;
+exports.createMockBatchEmails = createMockBatchEmails;
+exports.assertBatchResult = assertBatchResult;
+exports.createMockSubscriberList = createMockSubscriberList;
+exports.createMockSubscriber = createMockSubscriber;
+exports.assertSubscriptionActive = assertSubscriptionActive;
+exports.assertSuppressed = assertSuppressed;
+exports.assertHasThreadingHeaders = assertHasThreadingHeaders;
+exports.assertHasListUnsubscribeHeaders = assertHasListUnsubscribeHeaders;
+exports.assertHasMdnRequestHeader = assertHasMdnRequestHeader;
+exports.createMockAttachment = createMockAttachment;
+exports.assertValidAttachment = assertValidAttachment;
+exports.assertAttachmentSize = assertAttachmentSize;
+// ============================================================================
+// Calendar Helpers
+// ============================================================================
+/**
+ * Creates a mock CalendarEvent with sensible defaults.
+ * Override any field by passing partial overrides.
+ */
+function createMockCalendarEvent(overrides) {
+    const now = new Date();
+    const oneHourLater = new Date(now.getTime() + 60 * 60 * 1000);
+    return {
+        uid: `mock-event-${Date.now()}@example.com`,
+        summary: 'Mock Calendar Event',
+        description: 'This is a mock calendar event for testing',
+        location: 'Virtual Meeting Room',
+        dtstart: now,
+        dtend: oneHourLater,
+        organizer: {
+            name: 'Test Organizer',
+            email: 'organizer@example.com',
+        },
+        attendees: [
+            {
+                name: 'Test Attendee',
+                email: 'attendee@example.com',
+                rsvp: true,
+                role: 'REQ-PARTICIPANT',
+                status: 'NEEDS-ACTION',
+            },
+        ],
+        method: 'REQUEST',
+        sequence: 0,
+        status: 'CONFIRMED',
+        ...overrides,
+    };
+}
+/**
+ * Asserts that a string contains valid ICS (iCalendar) content.
+ * Validates required ICS properties and structure.
+ *
+ * @throws Error if the ICS content is invalid
+ */
+function assertValidIcsContent(icsString) {
+    if (!icsString || typeof icsString !== 'string') {
+        throw new Error('ICS content must be a non-empty string');
+    }
+    const trimmed = icsString.trim();
+    if (!trimmed.startsWith('BEGIN:VCALENDAR')) {
+        throw new Error('ICS content must start with BEGIN:VCALENDAR');
+    }
+    if (!trimmed.endsWith('END:VCALENDAR')) {
+        throw new Error('ICS content must end with END:VCALENDAR');
+    }
+    if (!trimmed.includes('BEGIN:VEVENT')) {
+        throw new Error('ICS content must contain at least one VEVENT');
+    }
+    if (!trimmed.includes('END:VEVENT')) {
+        throw new Error('ICS content must contain END:VEVENT');
+    }
+    const requiredProperties = ['DTSTART', 'DTEND', 'SUMMARY'];
+    for (const prop of requiredProperties) {
+        if (!trimmed.includes(prop)) {
+            throw new Error(`ICS content must contain ${prop} property`);
+        }
+    }
+    if (!trimmed.includes('VERSION:2.0')) {
+        throw new Error('ICS content must specify VERSION:2.0');
+    }
+}
+/**
+ * Asserts that an EmailData object represents a valid calendar invite email.
+ * Checks for a text/calendar attachment.
+ *
+ * @throws Error if the email is not a valid calendar invite
+ */
+function assertCalendarInviteEmail(email) {
+    if (!email) {
+        throw new Error('Email data is required');
+    }
+    if (!email.attachments || email.attachments.length === 0) {
+        throw new Error('Calendar invite email must have at least one attachment');
+    }
+    const calendarAttachment = email.attachments.find((att) => att.contentType === 'text/calendar' ||
+        att.contentType === 'application/ics' ||
+        (att.filename && att.filename.endsWith('.ics')));
+    if (!calendarAttachment) {
+        throw new Error('Calendar invite email must have a text/calendar or .ics attachment');
+    }
+}
+// ============================================================================
+// Batch Helpers
+// ============================================================================
+/**
+ * Creates an array of mock batch email inputs.
+ *
+ * @param count - Number of mock emails to create
+ * @param overrides - Partial overrides applied to each email
+ */
+function createMockBatchEmails(count, overrides) {
+    if (count < 0) {
+        throw new Error('Count must be a non-negative number');
+    }
+    return Array.from({ length: count }, (_, i) => ({
+        to: `recipient-${i + 1}@example.com`,
+        subject: `Batch Email #${i + 1}`,
+        html: `<p>Batch email content ${i + 1}</p>`,
+        text: `Batch email content ${i + 1}`,
+        from: 'sender@example.com',
+        ...overrides,
+    }));
+}
+/**
+ * Asserts that a BatchResult matches the given expectations.
+ *
+ * @throws Error if the result does not meet expectations
+ */
+function assertBatchResult(result, expectations) {
+    if (!result) {
+        throw new Error('Batch result is required');
+    }
+    if (expectations.minSucceeded !== undefined &&
+        result.succeeded < expectations.minSucceeded) {
+        throw new Error(`Expected at least ${expectations.minSucceeded} succeeded, but got ${result.succeeded}`);
+    }
+    if (expectations.maxFailed !== undefined &&
+        result.failed > expectations.maxFailed) {
+        throw new Error(`Expected at most ${expectations.maxFailed} failed, but got ${result.failed}`);
+    }
+    if (result.succeeded + result.failed !== result.total) {
+        throw new Error(`Batch result inconsistency: succeeded (${result.succeeded}) + failed (${result.failed}) !== total (${result.total})`);
+    }
+}
+// ============================================================================
+// Subscription Helpers
+// ============================================================================
+/**
+ * Creates a mock SubscriberList with sensible defaults.
+ */
+function createMockSubscriberList(overrides) {
+    const now = new Date().toISOString();
+    return {
+        id: `list-${Date.now()}`,
+        name: 'Mock Subscriber List',
+        description: 'A mock subscriber list for testing',
+        subscribers: [
+            createMockSubscriber({ email: 'subscriber-1@example.com' }),
+            createMockSubscriber({ email: 'subscriber-2@example.com' }),
+        ],
+        createdAt: now,
+        updatedAt: now,
+        ...overrides,
+    };
+}
+/**
+ * Creates a mock Subscriber with sensible defaults.
+ */
+function createMockSubscriber(overrides) {
+    const now = new Date().toISOString();
+    return {
+        id: `sub-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+        email: 'mock-subscriber@example.com',
+        name: 'Mock Subscriber',
+        status: 'active',
+        subscribedAt: now,
+        metadata: {},
+        tags: [],
+        ...overrides,
+    };
+}
+/**
+ * Asserts that a subscriber has an active subscription.
+ *
+ * @throws Error if the subscriber is not active
+ */
+function assertSubscriptionActive(subscriber) {
+    if (!subscriber) {
+        throw new Error('Subscriber is required');
+    }
+    if (subscriber.status !== 'active') {
+        throw new Error(`Expected subscriber status to be 'active', but got '${subscriber.status}'`);
+    }
+    if (!subscriber.subscribedAt) {
+        throw new Error('Active subscriber must have a subscribedAt date');
+    }
+    if (subscriber.unsubscribedAt) {
+        throw new Error('Active subscriber should not have an unsubscribedAt date');
+    }
+}
+/**
+ * Asserts that a suppression entry is valid.
+ *
+ * @throws Error if the suppression is invalid
+ */
+function assertSuppressed(suppression) {
+    if (!suppression) {
+        throw new Error('Suppression is required');
+    }
+    if (!suppression.email || !suppression.email.includes('@')) {
+        throw new Error('Suppression must have a valid email address');
+    }
+    const validReasons = [
+        'bounce',
+        'complaint',
+        'unsubscribe',
+        'manual',
+    ];
+    if (!validReasons.includes(suppression.reason)) {
+        throw new Error(`Suppression reason must be one of: ${validReasons.join(', ')}`);
+    }
+    if (!suppression.createdAt) {
+        throw new Error('Suppression must have a createdAt date');
+    }
+}
+// ============================================================================
+// Header Helpers
+// ============================================================================
+/**
+ * Asserts that headers contain email threading headers
+ * (In-Reply-To and/or References).
+ *
+ * @throws Error if threading headers are missing
+ */
+function assertHasThreadingHeaders(headers) {
+    if (!headers) {
+        throw new Error('Headers object is required');
+    }
+    const hasInReplyTo = 'In-Reply-To' in headers || 'in-reply-to' in headers;
+    const hasReferences = 'References' in headers || 'references' in headers;
+    if (!hasInReplyTo && !hasReferences) {
+        throw new Error('Threading headers require at least In-Reply-To or References header');
+    }
+}
+/**
+ * Asserts that headers contain List-Unsubscribe header(s).
+ * Validates both List-Unsubscribe and optionally List-Unsubscribe-Post (RFC 8058).
+ *
+ * @throws Error if List-Unsubscribe header is missing
+ */
+function assertHasListUnsubscribeHeaders(headers) {
+    if (!headers) {
+        throw new Error('Headers object is required');
+    }
+    const hasListUnsub = 'List-Unsubscribe' in headers || 'list-unsubscribe' in headers;
+    if (!hasListUnsub) {
+        throw new Error('Headers must contain a List-Unsubscribe header');
+    }
+    const unsubValue = headers['List-Unsubscribe'] || headers['list-unsubscribe'];
+    if (!unsubValue || unsubValue.trim().length === 0) {
+        throw new Error('List-Unsubscribe header must not be empty');
+    }
+}
+/**
+ * Asserts that headers contain a Disposition-Notification-To header (MDN request).
+ *
+ * @throws Error if MDN request header is missing
+ */
+function assertHasMdnRequestHeader(headers) {
+    if (!headers) {
+        throw new Error('Headers object is required');
+    }
+    const hasMdn = 'Disposition-Notification-To' in headers ||
+        'disposition-notification-to' in headers;
+    if (!hasMdn) {
+        throw new Error('Headers must contain a Disposition-Notification-To header for MDN requests');
+    }
+    const mdnValue = headers['Disposition-Notification-To'] ||
+        headers['disposition-notification-to'];
+    if (!mdnValue || !mdnValue.includes('@')) {
+        throw new Error('Disposition-Notification-To header must contain a valid email address');
+    }
+}
+// ============================================================================
+// Attachment Helpers
+// ============================================================================
+/**
+ * Creates a mock Attachment with sensible defaults.
+ */
+function createMockAttachment(overrides) {
+    const defaultContent = Buffer.from('Mock attachment content for testing');
+    return {
+        filename: 'test-document.pdf',
+        content: defaultContent,
+        contentType: 'application/pdf',
+        encoding: 'base64',
+        contentDisposition: 'attachment',
+        size: defaultContent.length,
+        ...overrides,
+    };
+}
+/**
+ * Asserts that an attachment has all required fields and valid values.
+ *
+ * @throws Error if the attachment is invalid
+ */
+function assertValidAttachment(attachment) {
+    if (!attachment) {
+        throw new Error('Attachment is required');
+    }
+    if (!attachment.filename || attachment.filename.trim().length === 0) {
+        throw new Error('Attachment must have a non-empty filename');
+    }
+    if (attachment.content === undefined || attachment.content === null) {
+        throw new Error('Attachment must have content');
+    }
+    if (typeof attachment.content === 'string' &&
+        attachment.content.length === 0) {
+        throw new Error('Attachment content must not be empty');
+    }
+    if (Buffer.isBuffer(attachment.content) &&
+        attachment.content.length === 0) {
+        throw new Error('Attachment content must not be empty');
+    }
+    if (!attachment.contentType ||
+        attachment.contentType.trim().length === 0) {
+        throw new Error('Attachment must have a non-empty contentType');
+    }
+    // Validate contentType format (should contain a slash)
+    if (!attachment.contentType.includes('/')) {
+        throw new Error(`Attachment contentType '${attachment.contentType}' is not a valid MIME type`);
+    }
+}
+/**
+ * Asserts that an attachment does not exceed the specified size in bytes.
+ *
+ * @throws Error if the attachment exceeds maxBytes
+ */
+function assertAttachmentSize(attachment, maxBytes) {
+    if (!attachment) {
+        throw new Error('Attachment is required');
+    }
+    if (maxBytes < 0) {
+        throw new Error('maxBytes must be a non-negative number');
+    }
+    let actualSize;
+    if (attachment.size !== undefined) {
+        actualSize = attachment.size;
+    }
+    else if (Buffer.isBuffer(attachment.content)) {
+        actualSize = attachment.content.length;
+    }
+    else if (typeof attachment.content === 'string') {
+        actualSize = Buffer.byteLength(attachment.content, 'utf-8');
+    }
+    else {
+        throw new Error('Cannot determine attachment size');
+    }
+    if (actualSize > maxBytes) {
+        throw new Error(`Attachment size (${actualSize} bytes) exceeds maximum allowed size (${maxBytes} bytes)`);
+    }
+}
+//# sourceMappingURL=feature-test-helpers.js.map

package/dist/feature-test-helpers.js.map

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

package/dist/index.d.ts

@@ -7,5 +7,7 @@ export { EmailTestingSuite } from './email-testing-suite';
 export { testEmail, EmailTestPatterns } from './test-patterns';
 export { EmailTestAnalytics } from './analytics';
 export { BestPracticesValidator } from './best-practices';
+export { createMockCalendarEvent, assertValidIcsContent, assertCalendarInviteEmail, createMockBatchEmails, assertBatchResult, createMockSubscriberList, createMockSubscriber, assertSubscriptionActive, assertSuppressed, assertHasThreadingHeaders, assertHasListUnsubscribeHeaders, assertHasMdnRequestHeader, createMockAttachment, assertValidAttachment, assertAttachmentSize, } from './feature-test-helpers';
+export type { CalendarEvent, BatchEmailInput, BatchResult, SubscriberList, Subscriber, Suppression, Attachment, } from './feature-test-helpers';
 export type { EmailTestingSuiteConfig, SMTPConfig, SMTPAuth, DefaultsConfig, ValidationConfig, ValidatorType, ValidationRule, ReportingConfig, ReportFormat, IntegrationsConfig, TestFramework, WebhookConfig, NotificationConfig, EmailTemplateTest, TemplateSource, EmailExpectations, PerformanceThresholds, EmailFlowTest, EmailFlowStep, FlowAssertion, EmailTest, SimpleEmailTest, EmailTestResult, ValidationResult, EmailFlowResult, StepResult, AssertionResult, EmailSuiteResult, TestSummary, PerformanceMetrics, IssueCount, EmailData, EmailAttachment, TestingEnvironment, DataSchema, SchemaField, AnalyticsData, TrendData, ReportOptions, Report, Recommendation, ExportOptions, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,YAAY,EACV,uBAAuB,EACvB,UAAU,EACV,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,aAAa,EACb,SAAS,EACT,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,aAAa,EACb,SAAS,EACT,aAAa,EACb,MAAM,EACN,cAAc,EACd,aAAa,GACd,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,OAAO,EAEL,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,EAEzB,qBAAqB,EACrB,iBAAiB,EAEjB,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,gBAAgB,EAEhB,yBAAyB,EACzB,+BAA+B,EAC/B,yBAAyB,EAEzB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EACV,aAAa,EACb,eAAe,EACf,WAAW,EACX,cAAc,EACd,UAAU,EACV,WAAW,EACX,UAAU,GACX,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EACV,uBAAuB,EACvB,UAAU,EACV,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,aAAa,EACb,SAAS,EACT,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,aAAa,EACb,SAAS,EACT,aAAa,EACb,MAAM,EACN,cAAc,EACd,aAAa,GACd,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -7,7 +7,7 @@ The client may use and modify this code *only within the scope of the project it
 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.BestPracticesValidator = exports.EmailTestAnalytics = exports.EmailTestPatterns = exports.testEmail = exports.EmailTestingSuite = void 0;
+exports.assertAttachmentSize = exports.assertValidAttachment = exports.createMockAttachment = exports.assertHasMdnRequestHeader = exports.assertHasListUnsubscribeHeaders = exports.assertHasThreadingHeaders = exports.assertSuppressed = exports.assertSubscriptionActive = exports.createMockSubscriber = exports.createMockSubscriberList = exports.assertBatchResult = exports.createMockBatchEmails = exports.assertCalendarInviteEmail = exports.assertValidIcsContent = exports.createMockCalendarEvent = exports.BestPracticesValidator = exports.EmailTestAnalytics = exports.EmailTestPatterns = exports.testEmail = exports.EmailTestingSuite = void 0;
 /**
  * @bernierllc/email-testing-suite
  *
@@ -22,4 +22,26 @@ var analytics_1 = require("./analytics");
 Object.defineProperty(exports, "EmailTestAnalytics", { enumerable: true, get: function () { return analytics_1.EmailTestAnalytics; } });
 var best_practices_1 = require("./best-practices");
 Object.defineProperty(exports, "BestPracticesValidator", { enumerable: true, get: function () { return best_practices_1.BestPracticesValidator; } });
+// Feature test helpers for calendar, batch, subscription, headers, attachments
+var feature_test_helpers_1 = require("./feature-test-helpers");
+// Calendar helpers
+Object.defineProperty(exports, "createMockCalendarEvent", { enumerable: true, get: function () { return feature_test_helpers_1.createMockCalendarEvent; } });
+Object.defineProperty(exports, "assertValidIcsContent", { enumerable: true, get: function () { return feature_test_helpers_1.assertValidIcsContent; } });
+Object.defineProperty(exports, "assertCalendarInviteEmail", { enumerable: true, get: function () { return feature_test_helpers_1.assertCalendarInviteEmail; } });
+// Batch helpers
+Object.defineProperty(exports, "createMockBatchEmails", { enumerable: true, get: function () { return feature_test_helpers_1.createMockBatchEmails; } });
+Object.defineProperty(exports, "assertBatchResult", { enumerable: true, get: function () { return feature_test_helpers_1.assertBatchResult; } });
+// Subscription helpers
+Object.defineProperty(exports, "createMockSubscriberList", { enumerable: true, get: function () { return feature_test_helpers_1.createMockSubscriberList; } });
+Object.defineProperty(exports, "createMockSubscriber", { enumerable: true, get: function () { return feature_test_helpers_1.createMockSubscriber; } });
+Object.defineProperty(exports, "assertSubscriptionActive", { enumerable: true, get: function () { return feature_test_helpers_1.assertSubscriptionActive; } });
+Object.defineProperty(exports, "assertSuppressed", { enumerable: true, get: function () { return feature_test_helpers_1.assertSuppressed; } });
+// Header helpers
+Object.defineProperty(exports, "assertHasThreadingHeaders", { enumerable: true, get: function () { return feature_test_helpers_1.assertHasThreadingHeaders; } });
+Object.defineProperty(exports, "assertHasListUnsubscribeHeaders", { enumerable: true, get: function () { return feature_test_helpers_1.assertHasListUnsubscribeHeaders; } });
+Object.defineProperty(exports, "assertHasMdnRequestHeader", { enumerable: true, get: function () { return feature_test_helpers_1.assertHasMdnRequestHeader; } });
+// Attachment helpers
+Object.defineProperty(exports, "createMockAttachment", { enumerable: true, get: function () { return feature_test_helpers_1.createMockAttachment; } });
+Object.defineProperty(exports, "assertValidAttachment", { enumerable: true, get: function () { return feature_test_helpers_1.assertValidAttachment; } });
+Object.defineProperty(exports, "assertAttachmentSize", { enumerable: true, get: function () { return feature_test_helpers_1.assertAttachmentSize; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;AAEF;;;;GAIG;AAEH,6DAA0D;AAAjD,wHAAA,iBAAiB,OAAA;AAC1B,iDAA+D;AAAtD,0GAAA,SAAS,OAAA;AAAE,kHAAA,iBAAiB,OAAA;AACrC,yCAAiD;AAAxC,+GAAA,kBAAkB,OAAA;AAC3B,mDAA0D;AAAjD,wHAAA,sBAAsB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;AAEF;;;;GAIG;AAEH,6DAA0D;AAAjD,wHAAA,iBAAiB,OAAA;AAC1B,iDAA+D;AAAtD,0GAAA,SAAS,OAAA;AAAE,kHAAA,iBAAiB,OAAA;AACrC,yCAAiD;AAAxC,+GAAA,kBAAkB,OAAA;AAC3B,mDAA0D;AAAjD,wHAAA,sBAAsB,OAAA;AAE/B,+EAA+E;AAC/E,+DAqBgC;AApB9B,mBAAmB;AACnB,+HAAA,uBAAuB,OAAA;AACvB,6HAAA,qBAAqB,OAAA;AACrB,iIAAA,yBAAyB,OAAA;AACzB,gBAAgB;AAChB,6HAAA,qBAAqB,OAAA;AACrB,yHAAA,iBAAiB,OAAA;AACjB,uBAAuB;AACvB,gIAAA,wBAAwB,OAAA;AACxB,4HAAA,oBAAoB,OAAA;AACpB,gIAAA,wBAAwB,OAAA;AACxB,wHAAA,gBAAgB,OAAA;AAChB,iBAAiB;AACjB,iIAAA,yBAAyB,OAAA;AACzB,uIAAA,+BAA+B,OAAA;AAC/B,iIAAA,yBAAyB,OAAA;AACzB,qBAAqB;AACrB,4HAAA,oBAAoB,OAAA;AACpB,6HAAA,qBAAqB,OAAA;AACrB,4HAAA,oBAAoB,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bernierllc/email-testing-suite",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Complete email testing solution with opinionated defaults, pre-configured test patterns, integrated mock server, and comprehensive reporting",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,16 +9,6 @@
     "README.md",
     "LICENSE"
   ],
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage",
-    "test:run": "jest --passWithNoTests",
-    "lint": "eslint src/**/*.ts",
-    "clean": "rimraf dist"
-  },
   "keywords": [
     "email",
     "testing",
@@ -39,18 +29,18 @@
     "directory": "packages/suite/email-testing-suite"
   },
   "dependencies": {
-    "@bernierllc/email-capture": "1.0.3",
-    "@bernierllc/email-parser": "0.3.0",
-    "@bernierllc/email-sender": "5.0.0",
-    "@bernierllc/email-test-assertions": "1.2.0",
-    "@bernierllc/email-test-orchestrator": "0.3.0",
-    "@bernierllc/email-validator": "3.0.0",
-    "@bernierllc/logger": "1.3.0",
-    "@bernierllc/mock-smtp-server": "1.2.0",
-    "@bernierllc/retry-policy": "0.3.0",
-    "@bernierllc/smtp-analyzer": "0.3.0",
-    "@bernierllc/template-engine": "0.4.0",
-    "@bernierllc/template-validator": "1.2.0"
+    "@bernierllc/email-capture": "1.0.5",
+    "@bernierllc/email-parser": "0.4.1",
+    "@bernierllc/email-sender": "5.2.0",
+    "@bernierllc/email-test-assertions": "1.2.2",
+    "@bernierllc/email-test-orchestrator": "0.3.2",
+    "@bernierllc/email-validator": "3.0.2",
+    "@bernierllc/logger": "1.3.2",
+    "@bernierllc/mock-smtp-server": "1.2.2",
+    "@bernierllc/retry-policy": "0.3.2",
+    "@bernierllc/template-engine": "0.4.2",
+    "@bernierllc/template-validator": "1.2.2",
+    "@bernierllc/smtp-analyzer": "0.3.2"
   },
   "devDependencies": {
     "@types/jest": "^29.5.5",
@@ -68,5 +58,14 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
-  "gitHead": "af7e74b3715d56d3a193e1bb6743b337c2b0df6d"
-}
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:run": "jest --passWithNoTests",
+    "lint": "eslint src/**/*.ts",
+    "clean": "rimraf dist"
+  }
+}