@bernierllc/email-manager 0.4.0 → 0.4.1

package/dist/enhanced-email-manager.d.ts

@@ -1,5 +1,8 @@
 import { EmailManager } from './email-manager.js';
-import { EnhancedEmailManagerConfig, EmailRecipient, SendTemplateOptions, EnhancedSenderConfiguration, CreateSenderRequest, SenderSelectionOptions, EnhancedSenderValidationResult, EnhancedTemplateValidationResult, VariableContextDefinition, EnhancedVariableSuggestion, TemplateSyncResult, BatchTemplateSyncResult, BootstrapResult, SystemHealthReport, SendResult, EmailData, EnhancedSendOptions, VariableDefinition } from './types.js';
+import type { CalendarEvent, CalendarAttendee } from '@bernierllc/email-calendar';
+import type { BatchSenderOptions, BatchResult, BatchEmailInput } from '@bernierllc/email-batch-sender';
+import type { SubscriptionStore, SubscriberList, Subscriber, AddSubscriberInput, CreateListOptions, BulkAddResult } from '@bernierllc/email-subscription';
+import { EnhancedEmailManagerConfig, EmailRecipient, SendTemplateOptions, EnhancedSenderConfiguration, CreateSenderRequest, SenderSelectionOptions, EnhancedSenderValidationResult, EnhancedTemplateValidationResult, VariableContextDefinition, EnhancedVariableSuggestion, TemplateSyncResult, BatchTemplateSyncResult, BootstrapResult, SystemHealthReport, SendResult, EmailData, EnhancedSendOptions, VariableDefinition, CalendarInviteSendOptions } from './types.js';
 /**
  * Internal template store for enhanced template management
  */
@@ -43,6 +46,10 @@ export declare class EnhancedEmailManager extends EmailManager {
     private senderStore;
     private variableContexts;
     private initialized;
+    private subscriptionStore;
+    private subscriptionListManager;
+    private unsubscribeManager;
+    private suppressionManager;
     constructor(config: EnhancedEmailManagerConfig);
     /**
      * Send a templated email with variable validation and smart sender selection
@@ -129,6 +136,159 @@ export declare class EnhancedEmailManager extends EmailManager {
      * Validate template data against a context
      */
     validateTemplateData(context: string, data: Record<string, unknown>): Promise<EnhancedTemplateValidationResult>;
+    /**
+     * Send a calendar invite email to recipients.
+     *
+     * Generates an ICS file from the CalendarEvent and attaches it to the email.
+     * The ICS attachment uses METHOD:REQUEST by default.
+     *
+     * @param event - The calendar event to send
+     * @param recipients - Array of recipient email addresses
+     * @param options - Optional subject, body, and provider overrides
+     * @returns SendResult from the email send operation
+     *
+     * @throws {Error} When the calendar event is invalid (missing title, bad dates, no attendees)
+     * @throws {EmailValidationError} When recipient validation fails
+     */
+    sendCalendarInvite(event: CalendarEvent, recipients: string[], options?: CalendarInviteSendOptions): Promise<SendResult>;
+    /**
+     * Send a calendar cancellation email.
+     *
+     * Generates a METHOD:CANCEL ICS and sends it to the specified attendees.
+     *
+     * @param eventUid - The UID of the event to cancel
+     * @param organizer - The organizer attendee
+     * @param attendees - The attendees to notify
+     * @param options - Optional subject and body overrides
+     * @returns SendResult from the email send operation
+     */
+    sendCalendarCancel(eventUid: string, organizer: CalendarAttendee, attendees: CalendarAttendee[], options?: CalendarInviteSendOptions): Promise<SendResult>;
+    /**
+     * Send a batch of emails with concurrency control, rate limiting, and retry.
+     *
+     * Wraps the existing email sending mechanism with the BatchSender from
+     * @bernierllc/email-batch-sender, providing efficient bulk email operations.
+     *
+     * @param emails - Array of batch email inputs
+     * @param options - Batch sender configuration (concurrency, rate limits, retry, etc.)
+     * @returns BatchResult with per-recipient results, timing, and abort status
+     *
+     * @throws {BatchSenderError} When batch input is invalid (missing toEmail/subject)
+     */
+    sendBatch(emails: BatchEmailInput[], options?: BatchSenderOptions): Promise<BatchResult>;
+    /**
+     * Create a new subscriber list.
+     *
+     * @param name - The list name
+     * @param options - Optional description and metadata
+     * @returns The created SubscriberList
+     */
+    createSubscriberList(name: string, options?: CreateListOptions): Promise<SubscriberList>;
+    /**
+     * Get a subscriber list by ID.
+     *
+     * @param listId - The list ID
+     * @returns The SubscriberList or null if not found
+     */
+    getSubscriberList(listId: string): Promise<SubscriberList | null>;
+    /**
+     * Delete a subscriber list and all its subscribers.
+     *
+     * @param listId - The list ID
+     * @returns true if the list was deleted
+     */
+    deleteSubscriberList(listId: string): Promise<boolean>;
+    /**
+     * Add a subscriber to a list.
+     *
+     * Checks for suppression and duplicates before adding.
+     *
+     * @param listId - The list ID
+     * @param input - Subscriber email, name, and metadata
+     * @throws {SubscriptionError} If list not found, email suppressed, or duplicate
+     */
+    addSubscriber(listId: string, input: AddSubscriberInput): Promise<void>;
+    /**
+     * Add multiple subscribers to a list in bulk.
+     *
+     * Skips duplicates and suppressed emails without throwing.
+     *
+     * @param listId - The list ID
+     * @param subscribers - Array of subscriber inputs
+     * @returns BulkAddResult with added/skipped counts
+     */
+    addSubscribers(listId: string, subscribers: ReadonlyArray<{
+        email: string;
+        name?: string;
+    }>): Promise<BulkAddResult>;
+    /**
+     * Remove a subscriber from a list.
+     *
+     * @param listId - The list ID
+     * @param email - The subscriber email
+     * @returns true if the subscriber was removed
+     */
+    removeSubscriber(listId: string, email: string): Promise<boolean>;
+    /**
+     * Get a subscriber from a list.
+     *
+     * @param listId - The list ID
+     * @param email - The subscriber email
+     * @returns The Subscriber or null if not found
+     */
+    getSubscriber(listId: string, email: string): Promise<Subscriber | null>;
+    /**
+     * Generate an unsubscribe URL for a subscriber.
+     *
+     * Requires subscription.unsubscribe configuration in the manager config.
+     *
+     * @param email - The subscriber email
+     * @param listId - The list ID
+     * @returns The signed unsubscribe URL
+     * @throws {Error} If unsubscribe manager is not configured
+     */
+    generateUnsubscribeUrl(email: string, listId: string): string;
+    /**
+     * Process an unsubscribe request from a signed token.
+     *
+     * Verifies the token, updates subscriber status, and adds suppression.
+     *
+     * @param token - The unsubscribe token from the URL
+     * @throws {Error} If unsubscribe manager is not configured
+     * @throws {SubscriptionError} If token is invalid or expired
+     */
+    processUnsubscribe(token: string): Promise<void>;
+    /**
+     * Check if an email address is suppressed.
+     *
+     * @param email - The email address to check
+     * @param listId - Optional list ID for scope-specific checks
+     * @returns true if the email is suppressed
+     */
+    isSuppressed(email: string, listId?: string): Promise<boolean>;
+    /**
+     * Send an email with List-Unsubscribe headers automatically added.
+     *
+     * Generates unsubscribe URL and adds RFC 2369/8058 headers to the email.
+     * Requires subscription.unsubscribe configuration.
+     *
+     * @param email - The email data to send
+     * @param listId - The list ID for unsubscribe scoping
+     * @param recipientEmail - The recipient email for unsubscribe token
+     * @param oneClick - Whether to include RFC 8058 one-click unsubscribe
+     * @returns SendResult from the email send operation
+     * @throws {Error} If unsubscribe manager is not configured
+     */
+    sendWithUnsubscribe(email: EmailData, listId: string, recipientEmail: string, oneClick?: boolean): Promise<SendResult>;
+    /**
+     * Set a custom subscription store (e.g., database-backed).
+     *
+     * Replaces the default InMemorySubscriptionStore and reinitializes
+     * all subscription managers to use the new store.
+     *
+     * @param store - A SubscriptionStore implementation
+     */
+    setSubscriptionStore(store: SubscriptionStore): void;
     /**
      * Bootstrap the email manager system
      */
@@ -145,6 +305,8 @@ export declare class EnhancedEmailManager extends EmailManager {
     private getTemplateSystemStats;
     private getSenderSystemStats;
     private getProviderHealthStats;
+    private getSubscriptionHealthStats;
+    private getBatchSenderHealthStats;
     private calculateOverallHealth;
     private generateHealthRecommendations;
     private renderSimpleTemplate;

package/dist/enhanced-email-manager.d.ts.map

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

package/dist/enhanced-email-manager.js

@@ -7,6 +7,10 @@ Redistribution or use in other products or commercial offerings is not permitted
 */
 import { EmailManager } from './email-manager.js';
 import { v4 as uuidv4 } from 'uuid';
+import { createCalendarInvite, createCalendarCancel, toCalendarAttachment } from '@bernierllc/email-calendar';
+import { createBatchSender } from '@bernierllc/email-batch-sender';
+import { SubscriptionListManager, UnsubscribeManager, SuppressionManager, InMemorySubscriptionStore, } from '@bernierllc/email-subscription';
+import { createListUnsubscribeHeaders } from '@bernierllc/email-headers';
 /**
  * EnhancedEmailManager - Extended email management with template service,
  * sender management, and variable validation integration.
@@ -27,7 +31,15 @@ export class EnhancedEmailManager extends EmailManager {
         this.senderStore = new Map();
         this.variableContexts = new Map();
         this.initialized = false;
+        this.unsubscribeManager = null;
         this.enhancedConfig = config;
+        // Initialize subscription components
+        this.subscriptionStore = new InMemorySubscriptionStore();
+        this.subscriptionListManager = new SubscriptionListManager(this.subscriptionStore);
+        this.suppressionManager = new SuppressionManager(this.subscriptionStore);
+        if (config.subscription?.unsubscribe) {
+            this.unsubscribeManager = new UnsubscribeManager(this.subscriptionStore, config.subscription.unsubscribe);
+        }
     }
     // ======================
     // Enhanced Email Sending
@@ -440,6 +452,305 @@ export class EnhancedEmailManager extends EmailManager {
         };
     }
     // ======================
+    // Calendar Invite Methods
+    // ======================
+    /**
+     * Send a calendar invite email to recipients.
+     *
+     * Generates an ICS file from the CalendarEvent and attaches it to the email.
+     * The ICS attachment uses METHOD:REQUEST by default.
+     *
+     * @param event - The calendar event to send
+     * @param recipients - Array of recipient email addresses
+     * @param options - Optional subject, body, and provider overrides
+     * @returns SendResult from the email send operation
+     *
+     * @throws {Error} When the calendar event is invalid (missing title, bad dates, no attendees)
+     * @throws {EmailValidationError} When recipient validation fails
+     */
+    async sendCalendarInvite(event, recipients, options) {
+        if (!recipients || recipients.length === 0) {
+            throw new Error('At least one recipient is required');
+        }
+        // Generate ICS content
+        const icsContent = createCalendarInvite(event);
+        // Convert to email attachment
+        const calendarAttachment = toCalendarAttachment(icsContent, 'REQUEST');
+        // Build subject line
+        const subject = options?.subject ?? `Calendar Invite: ${event.title}`;
+        // Build default body
+        const textBody = options?.textBody ??
+            `You have been invited to: ${event.title}\nWhen: ${event.start.toISOString()} - ${event.end.toISOString()}${event.location ? `\nWhere: ${event.location}` : ''}${event.description ? `\n\n${event.description}` : ''}`;
+        const htmlBody = options?.htmlBody ??
+            `<h2>${event.title}</h2><p><strong>When:</strong> ${event.start.toISOString()} - ${event.end.toISOString()}</p>${event.location ? `<p><strong>Where:</strong> ${event.location}</p>` : ''}${event.description ? `<p>${event.description}</p>` : ''}`;
+        // Build email data with calendar attachment
+        const emailData = {
+            to: recipients,
+            subject,
+            text: textBody,
+            html: htmlBody,
+            attachments: [{
+                    filename: calendarAttachment.filename,
+                    content: calendarAttachment.content,
+                    contentType: calendarAttachment.contentType,
+                }],
+            provider: options?.provider,
+            metadata: {
+                ...options?.metadata,
+                calendarEvent: true,
+                eventTitle: event.title,
+            },
+        };
+        return this.sendEmail(emailData);
+    }
+    /**
+     * Send a calendar cancellation email.
+     *
+     * Generates a METHOD:CANCEL ICS and sends it to the specified attendees.
+     *
+     * @param eventUid - The UID of the event to cancel
+     * @param organizer - The organizer attendee
+     * @param attendees - The attendees to notify
+     * @param options - Optional subject and body overrides
+     * @returns SendResult from the email send operation
+     */
+    async sendCalendarCancel(eventUid, organizer, attendees, options) {
+        if (!attendees || attendees.length === 0) {
+            throw new Error('At least one attendee is required');
+        }
+        const icsContent = createCalendarCancel(eventUid, organizer, attendees);
+        const calendarAttachment = toCalendarAttachment(icsContent, 'CANCEL');
+        const subject = options?.subject ?? 'Event Cancelled';
+        const recipients = attendees.map(a => a.email);
+        const emailData = {
+            to: recipients,
+            subject,
+            text: options?.textBody ?? 'This event has been cancelled.',
+            html: options?.htmlBody ?? '<p>This event has been cancelled.</p>',
+            attachments: [{
+                    filename: calendarAttachment.filename,
+                    content: calendarAttachment.content,
+                    contentType: calendarAttachment.contentType,
+                }],
+            provider: options?.provider,
+            metadata: {
+                ...options?.metadata,
+                calendarCancel: true,
+                eventUid,
+            },
+        };
+        return this.sendEmail(emailData);
+    }
+    // ======================
+    // Batch Send Methods
+    // ======================
+    /**
+     * Send a batch of emails with concurrency control, rate limiting, and retry.
+     *
+     * Wraps the existing email sending mechanism with the BatchSender from
+     * @bernierllc/email-batch-sender, providing efficient bulk email operations.
+     *
+     * @param emails - Array of batch email inputs
+     * @param options - Batch sender configuration (concurrency, rate limits, retry, etc.)
+     * @returns BatchResult with per-recipient results, timing, and abort status
+     *
+     * @throws {BatchSenderError} When batch input is invalid (missing toEmail/subject)
+     */
+    async sendBatch(emails, options) {
+        // Create an adapter that wraps our sendEmail into the EmailSenderInterface
+        const senderAdapter = {
+            send: async (message) => {
+                try {
+                    const emailData = {
+                        to: message.toEmail,
+                        subject: message.subject,
+                        html: message.htmlContent,
+                        text: message.textContent,
+                        metadata: message.metadata,
+                    };
+                    const result = await this.sendEmail(emailData);
+                    return {
+                        success: result.success,
+                        messageId: result.messageId,
+                        provider: result.provider,
+                    };
+                }
+                catch (error) {
+                    return {
+                        success: false,
+                        errorMessage: error instanceof Error ? error.message : 'Unknown send error',
+                    };
+                }
+            }
+        };
+        const batchSender = createBatchSender(senderAdapter, options);
+        return batchSender.send(emails);
+    }
+    // ======================
+    // Subscription Management Methods
+    // ======================
+    /**
+     * Create a new subscriber list.
+     *
+     * @param name - The list name
+     * @param options - Optional description and metadata
+     * @returns The created SubscriberList
+     */
+    async createSubscriberList(name, options) {
+        return this.subscriptionListManager.createList(name, options);
+    }
+    /**
+     * Get a subscriber list by ID.
+     *
+     * @param listId - The list ID
+     * @returns The SubscriberList or null if not found
+     */
+    async getSubscriberList(listId) {
+        return this.subscriptionListManager.getList(listId);
+    }
+    /**
+     * Delete a subscriber list and all its subscribers.
+     *
+     * @param listId - The list ID
+     * @returns true if the list was deleted
+     */
+    async deleteSubscriberList(listId) {
+        return this.subscriptionListManager.deleteList(listId);
+    }
+    /**
+     * Add a subscriber to a list.
+     *
+     * Checks for suppression and duplicates before adding.
+     *
+     * @param listId - The list ID
+     * @param input - Subscriber email, name, and metadata
+     * @throws {SubscriptionError} If list not found, email suppressed, or duplicate
+     */
+    async addSubscriber(listId, input) {
+        return this.subscriptionListManager.addSubscriber(listId, input);
+    }
+    /**
+     * Add multiple subscribers to a list in bulk.
+     *
+     * Skips duplicates and suppressed emails without throwing.
+     *
+     * @param listId - The list ID
+     * @param subscribers - Array of subscriber inputs
+     * @returns BulkAddResult with added/skipped counts
+     */
+    async addSubscribers(listId, subscribers) {
+        return this.subscriptionListManager.addSubscribers(listId, subscribers);
+    }
+    /**
+     * Remove a subscriber from a list.
+     *
+     * @param listId - The list ID
+     * @param email - The subscriber email
+     * @returns true if the subscriber was removed
+     */
+    async removeSubscriber(listId, email) {
+        return this.subscriptionListManager.removeSubscriber(listId, email);
+    }
+    /**
+     * Get a subscriber from a list.
+     *
+     * @param listId - The list ID
+     * @param email - The subscriber email
+     * @returns The Subscriber or null if not found
+     */
+    async getSubscriber(listId, email) {
+        return this.subscriptionListManager.getSubscriber(listId, email);
+    }
+    /**
+     * Generate an unsubscribe URL for a subscriber.
+     *
+     * Requires subscription.unsubscribe configuration in the manager config.
+     *
+     * @param email - The subscriber email
+     * @param listId - The list ID
+     * @returns The signed unsubscribe URL
+     * @throws {Error} If unsubscribe manager is not configured
+     */
+    generateUnsubscribeUrl(email, listId) {
+        if (!this.unsubscribeManager) {
+            throw new Error('UnsubscribeManager is not configured. Provide subscription.unsubscribe config.');
+        }
+        return this.unsubscribeManager.generateUnsubscribeUrl(email, listId);
+    }
+    /**
+     * Process an unsubscribe request from a signed token.
+     *
+     * Verifies the token, updates subscriber status, and adds suppression.
+     *
+     * @param token - The unsubscribe token from the URL
+     * @throws {Error} If unsubscribe manager is not configured
+     * @throws {SubscriptionError} If token is invalid or expired
+     */
+    async processUnsubscribe(token) {
+        if (!this.unsubscribeManager) {
+            throw new Error('UnsubscribeManager is not configured. Provide subscription.unsubscribe config.');
+        }
+        return this.unsubscribeManager.processUnsubscribe(token);
+    }
+    /**
+     * Check if an email address is suppressed.
+     *
+     * @param email - The email address to check
+     * @param listId - Optional list ID for scope-specific checks
+     * @returns true if the email is suppressed
+     */
+    async isSuppressed(email, listId) {
+        return this.suppressionManager.isSuppressed(email, listId);
+    }
+    /**
+     * Send an email with List-Unsubscribe headers automatically added.
+     *
+     * Generates unsubscribe URL and adds RFC 2369/8058 headers to the email.
+     * Requires subscription.unsubscribe configuration.
+     *
+     * @param email - The email data to send
+     * @param listId - The list ID for unsubscribe scoping
+     * @param recipientEmail - The recipient email for unsubscribe token
+     * @param oneClick - Whether to include RFC 8058 one-click unsubscribe
+     * @returns SendResult from the email send operation
+     * @throws {Error} If unsubscribe manager is not configured
+     */
+    async sendWithUnsubscribe(email, listId, recipientEmail, oneClick = true) {
+        if (!this.unsubscribeManager) {
+            throw new Error('UnsubscribeManager is not configured. Provide subscription.unsubscribe config.');
+        }
+        // Generate unsubscribe URL
+        const unsubscribeUrl = this.unsubscribeManager.generateUnsubscribeUrl(recipientEmail, listId);
+        // Create List-Unsubscribe headers
+        const unsubscribeHeaders = createListUnsubscribeHeaders(unsubscribeUrl, undefined, oneClick);
+        // Merge unsubscribe headers into email metadata (headers)
+        const emailWithHeaders = {
+            ...email,
+            metadata: {
+                ...email.metadata,
+                unsubscribeHeaders,
+                listId,
+            },
+        };
+        return this.sendEmail(emailWithHeaders);
+    }
+    /**
+     * Set a custom subscription store (e.g., database-backed).
+     *
+     * Replaces the default InMemorySubscriptionStore and reinitializes
+     * all subscription managers to use the new store.
+     *
+     * @param store - A SubscriptionStore implementation
+     */
+    setSubscriptionStore(store) {
+        this.subscriptionStore = store;
+        this.subscriptionListManager = new SubscriptionListManager(store);
+        this.suppressionManager = new SuppressionManager(store);
+        if (this.enhancedConfig.subscription?.unsubscribe) {
+            this.unsubscribeManager = new UnsubscribeManager(store, this.enhancedConfig.subscription.unsubscribe);
+        }
+    }
+    // ======================
     // System Operations
     // ======================
     /**
@@ -507,21 +818,39 @@ export class EnhancedEmailManager extends EmailManager {
         const templateStats = await this.getTemplateSystemStats();
         const senderStats = await this.getSenderSystemStats();
         const providerStats = await this.getProviderHealthStats();
-        const overallHealth = this.calculateOverallHealth([
+        const subscriptionStats = await this.getSubscriptionHealthStats();
+        const batchSenderStats = this.getBatchSenderHealthStats();
+        const allComponents = [
             emailStats,
             templateStats,
             senderStats,
             providerStats
-        ]);
+        ];
+        // Only include subscription and batch sender in overall health
+        // calculation if they are configured
+        if (subscriptionStats) {
+            allComponents.push(subscriptionStats);
+        }
+        if (batchSenderStats) {
+            allComponents.push(batchSenderStats);
+        }
+        const overallHealth = this.calculateOverallHealth(allComponents);
+        const components = {
+            email: emailStats,
+            templates: templateStats,
+            senders: senderStats,
+            providers: providerStats
+        };
+        if (subscriptionStats) {
+            components.subscription = subscriptionStats;
+        }
+        if (batchSenderStats) {
+            components.batchSender = batchSenderStats;
+        }
         return {
             overall: overallHealth,
             timestamp: new Date(),
-            components: {
-                email: emailStats,
-                templates: templateStats,
-                senders: senderStats,
-                providers: providerStats
-            },
+            components,
             recommendations: this.generateHealthRecommendations({
                 emailStats,
                 templateStats,
@@ -722,6 +1051,81 @@ export class EnhancedEmailManager extends EmailManager {
             issues
         };
     }
+    async getSubscriptionHealthStats() {
+        if (!this.enhancedConfig.subscription?.enabled) {
+            return null;
+        }
+        try {
+            const lists = await this.subscriptionListManager.listLists();
+            const suppressions = await this.suppressionManager.listSuppressions();
+            const totalSubscribers = lists.items.reduce((sum, list) => sum + list.subscriberCount, 0);
+            const issues = [];
+            if (lists.total === 0) {
+                issues.push({
+                    severity: 'info',
+                    message: 'No subscription lists configured',
+                    details: 'Create subscription lists to manage email recipients'
+                });
+            }
+            if (suppressions.total > 0 && lists.total > 0) {
+                const suppressionRatio = suppressions.total / Math.max(totalSubscribers, 1);
+                if (suppressionRatio > 0.3) {
+                    issues.push({
+                        severity: 'warning',
+                        message: 'High suppression ratio',
+                        details: `${suppressions.total} suppressions vs ${totalSubscribers} subscribers`
+                    });
+                }
+            }
+            const hasDegraded = issues.some(i => i.severity === 'warning');
+            const score = Math.max(0, 100 - issues.filter(i => i.severity === 'warning').length * 20);
+            return {
+                status: hasDegraded ? 'degraded' : 'healthy',
+                score,
+                metrics: {
+                    listCount: lists.total,
+                    totalSubscribers,
+                    suppressionCount: suppressions.total
+                },
+                issues
+            };
+        }
+        catch (error) {
+            return {
+                status: 'degraded',
+                score: 50,
+                metrics: {
+                    listCount: 0,
+                    totalSubscribers: 0,
+                    suppressionCount: 0
+                },
+                issues: [{
+                        severity: 'warning',
+                        message: 'Failed to retrieve subscription health',
+                        details: error instanceof Error ? error.message : 'Unknown error'
+                    }]
+            };
+        }
+    }
+    getBatchSenderHealthStats() {
+        // The batch sender is available if the email-batch-sender package is
+        // imported and the manager has at least one active provider configured.
+        // Since createBatchSender is a factory that wraps an EmailSenderInterface,
+        // it is always structurally available but only useful with providers.
+        const hasProviders = this.enhancedConfig.providers.length > 0;
+        if (!hasProviders) {
+            return null;
+        }
+        return {
+            status: 'healthy',
+            score: 100,
+            metrics: {
+                available: 1,
+                configured: 1
+            },
+            issues: []
+        };
+    }
     calculateOverallHealth(components) {
         const avgScore = components.reduce((sum, c) => sum + c.score, 0) / components.length;
         const hasUnhealthy = components.some(c => c.status === 'unhealthy');