@bernierllc/email-webhook-events 1.0.0

package/dist/EmailWebhookEventsService.d.ts

@@ -0,0 +1,53 @@
+import { EmailWebhookEventsConfig, EmailWebhookResult, WebhookPayload, EmailEvent, EmailAnalytics, AnalyticsFilters, EventQuery } from './types';
+export declare class EmailWebhookEventsService {
+    private config;
+    private logger;
+    private persistenceAdapter?;
+    private analyticsEngine;
+    constructor(config: EmailWebhookEventsConfig);
+    /**
+     * Initialize the service
+     */
+    initialize(): Promise<void>;
+    /**
+     * Process incoming webhook
+     */
+    processWebhook(webhook: WebhookPayload): Promise<EmailWebhookResult>;
+    /**
+     * Get analytics for date range
+     */
+    getAnalytics(startDate: Date, endDate: Date, filters?: AnalyticsFilters): Promise<EmailAnalytics>;
+    /**
+     * Query events
+     */
+    queryEvents(query: EventQuery): Promise<EmailEvent[]>;
+    /**
+     * Get events for specific email
+     */
+    getEventsForEmail(emailId: string): Promise<EmailEvent[]>;
+    /**
+     * Normalize webhook event to unified format
+     */
+    private normalizeEvent;
+    /**
+     * Get normalizer for provider
+     */
+    private getNormalizerForProvider;
+    /**
+     * Check if event is critical (requires notification)
+     */
+    private isCriticalEvent;
+    /**
+     * Publish critical event to notification channels
+     */
+    private publishCriticalEvent;
+    /**
+     * Send notification via channel
+     */
+    private sendNotification;
+    /**
+     * Create persistence adapter
+     */
+    private createPersistenceAdapter;
+}
+//# sourceMappingURL=EmailWebhookEventsService.d.ts.map

package/dist/EmailWebhookEventsService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailWebhookEventsService.d.ts","sourceRoot":"","sources":["../src/EmailWebhookEventsService.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,cAAc,EAGd,gBAAgB,EAChB,UAAU,EAEX,MAAM,SAAS,CAAC;AAgCjB,qBAAa,yBAAyB;IAKxB,OAAO,CAAC,MAAM;IAJ1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,kBAAkB,CAAC,CAAqB;IAChD,OAAO,CAAC,eAAe,CAAkB;gBAErB,MAAM,EAAE,wBAAwB;IAKpD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IASjC;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA+C1E;;OAEG;IACG,YAAY,CAChB,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,EACb,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,cAAc,CAAC;IAI1B;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAO3D;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAI/D;;OAEG;YACW,cAAc;IAY5B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAiBhC;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;YACW,oBAAoB;IAelC;;OAEG;YACW,gBAAgB;IAa9B;;OAEG;YACW,wBAAwB;CAWvC"}

package/dist/EmailWebhookEventsService.js

@@ -0,0 +1,198 @@
+"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.EmailWebhookEventsService = void 0;
+const types_1 = require("./types");
+const AnalyticsEngine_1 = require("./analytics/AnalyticsEngine");
+const InMemoryPersistenceAdapter_1 = require("./persistence/InMemoryPersistenceAdapter");
+const SendGridNormalizer_1 = require("./normalizers/SendGridNormalizer");
+const MailgunNormalizer_1 = require("./normalizers/MailgunNormalizer");
+const SESNormalizer_1 = require("./normalizers/SESNormalizer");
+const PostmarkNormalizer_1 = require("./normalizers/PostmarkNormalizer");
+const SMTP2GONormalizer_1 = require("./normalizers/SMTP2GONormalizer");
+class MockLogger {
+    info(message, meta) {
+        console.log(`[INFO] ${message}`, meta || '');
+    }
+    warn(message, meta) {
+        console.warn(`[WARN] ${message}`, meta || '');
+    }
+    error(message, meta) {
+        console.error(`[ERROR] ${message}`, meta || '');
+    }
+}
+class EmailWebhookEventsService {
+    constructor(config) {
+        this.config = config;
+        this.logger = new MockLogger();
+        this.analyticsEngine = new AnalyticsEngine_1.AnalyticsEngine(config.analytics);
+    }
+    /**
+     * Initialize the service
+     */
+    async initialize() {
+        // Initialize persistence
+        if (this.config.persistence?.enabled) {
+            this.persistenceAdapter = await this.createPersistenceAdapter();
+        }
+        this.logger.info('Email webhook events service initialized');
+    }
+    /**
+     * Process incoming webhook
+     */
+    async processWebhook(webhook) {
+        try {
+            // Validate webhook signature would happen here
+            // For now, we'll assume validation passes
+            // Normalize event
+            const normalizedEvent = await this.normalizeEvent(webhook);
+            if (!normalizedEvent) {
+                this.logger.warn('Failed to normalize webhook event', {
+                    provider: webhook.provider
+                });
+                return { success: false, error: 'Event normalization failed' };
+            }
+            // Persist event
+            if (this.persistenceAdapter) {
+                await this.persistenceAdapter.saveEvent(normalizedEvent);
+            }
+            // Update analytics
+            await this.analyticsEngine.recordEvent(normalizedEvent);
+            // Publish critical events
+            if (this.isCriticalEvent(normalizedEvent)) {
+                await this.publishCriticalEvent(normalizedEvent);
+            }
+            this.logger.info('Email event processed successfully', {
+                eventId: normalizedEvent.id,
+                type: normalizedEvent.type,
+                recipient: normalizedEvent.recipient
+            });
+            return { success: true, event: normalizedEvent };
+        }
+        catch (error) {
+            this.logger.error('Error processing email webhook', {
+                error: error instanceof Error ? error.message : 'Unknown error',
+                provider: webhook.provider
+            });
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    }
+    /**
+     * Get analytics for date range
+     */
+    async getAnalytics(startDate, endDate, filters) {
+        return this.analyticsEngine.getAnalytics(startDate, endDate, filters);
+    }
+    /**
+     * Query events
+     */
+    async queryEvents(query) {
+        if (!this.persistenceAdapter) {
+            throw new Error('Event persistence not enabled');
+        }
+        return this.persistenceAdapter.queryEvents(query);
+    }
+    /**
+     * Get events for specific email
+     */
+    async getEventsForEmail(emailId) {
+        return this.queryEvents({ emailId });
+    }
+    /**
+     * Normalize webhook event to unified format
+     */
+    async normalizeEvent(webhook) {
+        const normalizer = this.getNormalizerForProvider(webhook.provider);
+        if (!normalizer) {
+            this.logger.error('No normalizer found for provider', {
+                provider: webhook.provider
+            });
+            return null;
+        }
+        return normalizer.normalize(webhook);
+    }
+    /**
+     * Get normalizer for provider
+     */
+    getNormalizerForProvider(provider) {
+        switch (provider) {
+            case types_1.EmailProvider.SENDGRID:
+                return new SendGridNormalizer_1.SendGridNormalizer();
+            case types_1.EmailProvider.MAILGUN:
+                return new MailgunNormalizer_1.MailgunNormalizer();
+            case types_1.EmailProvider.AWS_SES:
+                return new SESNormalizer_1.SESNormalizer();
+            case types_1.EmailProvider.POSTMARK:
+                return new PostmarkNormalizer_1.PostmarkNormalizer();
+            case types_1.EmailProvider.SMTP2GO:
+                return new SMTP2GONormalizer_1.SMTP2GONormalizer();
+            default:
+                return null;
+        }
+    }
+    /**
+     * Check if event is critical (requires notification)
+     */
+    isCriticalEvent(event) {
+        const criticalTypes = this.config.notifications?.criticalEvents || [
+            types_1.EmailEventType.BOUNCED,
+            types_1.EmailEventType.COMPLAINED,
+            types_1.EmailEventType.FAILED
+        ];
+        return criticalTypes.includes(event.type);
+    }
+    /**
+     * Publish critical event to notification channels
+     */
+    async publishCriticalEvent(event) {
+        if (!this.config.notifications?.enabled)
+            return;
+        for (const channel of this.config.notifications.channels) {
+            try {
+                await this.sendNotification(channel, event);
+            }
+            catch (error) {
+                this.logger.error('Failed to send notification', {
+                    channel: channel.type,
+                    error: error instanceof Error ? error.message : 'Unknown error'
+                });
+            }
+        }
+    }
+    /**
+     * Send notification via channel
+     */
+    async sendNotification(channel, event) {
+        // In a real implementation, this would send notifications
+        // For now, just log
+        this.logger.info('Critical event notification', {
+            channel: channel.type,
+            eventType: event.type,
+            recipient: event.recipient
+        });
+    }
+    /**
+     * Create persistence adapter
+     */
+    async createPersistenceAdapter() {
+        const adapter = this.config.persistence?.adapter || 'memory';
+        switch (adapter) {
+            case 'memory':
+                return new InMemoryPersistenceAdapter_1.InMemoryPersistenceAdapter();
+            // Other adapters would be implemented here
+            default:
+                throw new Error(`Unsupported persistence adapter: ${adapter}`);
+        }
+    }
+}
+exports.EmailWebhookEventsService = EmailWebhookEventsService;
+//# sourceMappingURL=EmailWebhookEventsService.js.map

package/dist/EmailWebhookEventsService.js.map

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

package/dist/analytics/AnalyticsEngine.d.ts

@@ -0,0 +1,20 @@
+import { EmailEvent, EmailAnalytics, AnalyticsFilters } from '../types';
+export declare class AnalyticsEngine {
+    private events;
+    private config?;
+    constructor(config?: {
+        realTimeEnabled: boolean;
+        aggregationInterval: number;
+        retentionDays: number;
+    });
+    recordEvent(event: EmailEvent): Promise<void>;
+    getAnalytics(startDate: Date, endDate: Date, filters?: AnalyticsFilters): Promise<EmailAnalytics>;
+    private calculateCounts;
+    private calculateRates;
+    private calculateProviderBreakdown;
+    private calculateEventTypeBreakdown;
+    private calculateBounceTypeBreakdown;
+    private calculateTopLinks;
+    private calculateDeviceBreakdown;
+}
+//# sourceMappingURL=AnalyticsEngine.d.ts.map

package/dist/analytics/AnalyticsEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsEngine.d.ts","sourceRoot":"","sources":["../../src/analytics/AnalyticsEngine.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,UAAU,EACV,cAAc,EAId,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAC,CAIb;gBAEU,MAAM,CAAC,EAAE;QAAE,eAAe,EAAE,OAAO,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE;IAI/F,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7C,YAAY,CAChB,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,EACb,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,cAAc,CAAC;IAgD1B,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,cAAc;IA8BtB,OAAO,CAAC,0BAA0B;IA0BlC,OAAO,CAAC,2BAA2B;IAWnC,OAAO,CAAC,4BAA4B;IAUpC,OAAO,CAAC,iBAAiB;IAwBzB,OAAO,CAAC,wBAAwB;CAcjC"}

package/dist/analytics/AnalyticsEngine.js

@@ -0,0 +1,160 @@
+"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.AnalyticsEngine = void 0;
+const types_1 = require("../types");
+class AnalyticsEngine {
+    constructor(config) {
+        this.events = [];
+        this.config = config;
+    }
+    async recordEvent(event) {
+        this.events.push(event);
+        // Cleanup old events based on retention policy
+        if (this.config?.retentionDays) {
+            const cutoffDate = new Date();
+            cutoffDate.setDate(cutoffDate.getDate() - this.config.retentionDays);
+            this.events = this.events.filter(e => e.timestamp >= cutoffDate);
+        }
+    }
+    async getAnalytics(startDate, endDate, filters) {
+        // Filter events by date range and filters
+        let filteredEvents = this.events.filter(e => e.timestamp >= startDate && e.timestamp <= endDate);
+        if (filters?.provider) {
+            filteredEvents = filteredEvents.filter(e => e.provider === filters.provider);
+        }
+        if (filters?.emailId) {
+            filteredEvents = filteredEvents.filter(e => e.emailId === filters.emailId);
+        }
+        if (filters?.recipient) {
+            filteredEvents = filteredEvents.filter(e => e.recipient === filters.recipient);
+        }
+        if (filters?.eventTypes && filters.eventTypes.length > 0) {
+            filteredEvents = filteredEvents.filter(e => filters.eventTypes.includes(e.type));
+        }
+        // Calculate counts
+        const counts = this.calculateCounts(filteredEvents);
+        // Calculate rates
+        const rates = this.calculateRates(counts);
+        // Calculate breakdowns
+        const byProvider = this.calculateProviderBreakdown(filteredEvents);
+        const byEventType = this.calculateEventTypeBreakdown(filteredEvents);
+        const byBounceType = this.calculateBounceTypeBreakdown(filteredEvents);
+        const topLinks = this.calculateTopLinks(filteredEvents);
+        const byDevice = this.calculateDeviceBreakdown(filteredEvents);
+        return {
+            startDate,
+            endDate,
+            ...counts,
+            ...rates,
+            byProvider,
+            byEventType,
+            byBounceType,
+            topLinks,
+            byDevice
+        };
+    }
+    calculateCounts(events) {
+        return {
+            totalSent: events.length, // Simplified - in real implementation, would track sent separately
+            totalDelivered: events.filter(e => e.type === types_1.EmailEventType.DELIVERED).length,
+            totalOpened: events.filter(e => e.type === types_1.EmailEventType.OPENED).length,
+            totalClicked: events.filter(e => e.type === types_1.EmailEventType.CLICKED).length,
+            totalBounced: events.filter(e => e.type === types_1.EmailEventType.BOUNCED).length,
+            totalComplained: events.filter(e => e.type === types_1.EmailEventType.COMPLAINED).length,
+            totalUnsubscribed: events.filter(e => e.type === types_1.EmailEventType.UNSUBSCRIBED).length,
+            totalFailed: events.filter(e => e.type === types_1.EmailEventType.FAILED).length
+        };
+    }
+    calculateRates(counts) {
+        const safeDiv = (num, denom) => (denom === 0 ? 0 : num / denom);
+        return {
+            deliveryRate: safeDiv(counts.totalDelivered, counts.totalSent),
+            openRate: safeDiv(counts.totalOpened, counts.totalDelivered),
+            clickRate: safeDiv(counts.totalClicked, counts.totalDelivered),
+            clickToOpenRate: safeDiv(counts.totalClicked, counts.totalOpened),
+            bounceRate: safeDiv(counts.totalBounced, counts.totalSent),
+            complaintRate: safeDiv(counts.totalComplained, counts.totalSent),
+            unsubscribeRate: safeDiv(counts.totalUnsubscribed, counts.totalDelivered)
+        };
+    }
+    calculateProviderBreakdown(events) {
+        const providers = Object.values(types_1.EmailProvider);
+        const breakdown = {};
+        for (const provider of providers) {
+            const providerEvents = events.filter(e => e.provider === provider);
+            const counts = this.calculateCounts(providerEvents);
+            const rates = this.calculateRates(counts);
+            breakdown[provider] = {
+                sent: counts.totalSent,
+                delivered: counts.totalDelivered,
+                opened: counts.totalOpened,
+                clicked: counts.totalClicked,
+                bounced: counts.totalBounced,
+                complained: counts.totalComplained,
+                failed: counts.totalFailed,
+                deliveryRate: rates.deliveryRate,
+                openRate: rates.openRate,
+                clickRate: rates.clickRate
+            };
+        }
+        return breakdown;
+    }
+    calculateEventTypeBreakdown(events) {
+        const eventTypes = Object.values(types_1.EmailEventType);
+        const breakdown = {};
+        for (const eventType of eventTypes) {
+            breakdown[eventType] = events.filter(e => e.type === eventType).length;
+        }
+        return breakdown;
+    }
+    calculateBounceTypeBreakdown(events) {
+        const bounceEvents = events.filter(e => e.type === types_1.EmailEventType.BOUNCED);
+        if (bounceEvents.length === 0)
+            return undefined;
+        return {
+            hard: bounceEvents.filter(e => e.metadata.bounceType === 'hard').length,
+            soft: bounceEvents.filter(e => e.metadata.bounceType === 'soft').length
+        };
+    }
+    calculateTopLinks(events) {
+        const clickEvents = events.filter(e => e.type === types_1.EmailEventType.CLICKED && e.metadata.url);
+        if (clickEvents.length === 0)
+            return undefined;
+        const linkStats = new Map();
+        for (const event of clickEvents) {
+            const url = event.metadata.url;
+            const existing = linkStats.get(url) || { clicks: 0, recipients: new Set() };
+            existing.clicks++;
+            existing.recipients.add(event.recipient);
+            linkStats.set(url, existing);
+        }
+        return Array.from(linkStats.entries())
+            .map(([url, stats]) => ({
+            url,
+            clicks: stats.clicks,
+            uniqueClicks: stats.recipients.size
+        }))
+            .sort((a, b) => b.clicks - a.clicks)
+            .slice(0, 10);
+    }
+    calculateDeviceBreakdown(events) {
+        const interactionEvents = events.filter(e => (e.type === types_1.EmailEventType.OPENED || e.type === types_1.EmailEventType.CLICKED) && e.metadata.deviceType);
+        if (interactionEvents.length === 0)
+            return undefined;
+        return {
+            desktop: interactionEvents.filter(e => e.metadata.deviceType === 'desktop').length,
+            mobile: interactionEvents.filter(e => e.metadata.deviceType === 'mobile').length,
+            tablet: interactionEvents.filter(e => e.metadata.deviceType === 'tablet').length,
+            unknown: interactionEvents.filter(e => e.metadata.deviceType === 'unknown').length
+        };
+    }
+}
+exports.AnalyticsEngine = AnalyticsEngine;
+//# sourceMappingURL=AnalyticsEngine.js.map

package/dist/analytics/AnalyticsEngine.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { EmailWebhookEventsService } from './EmailWebhookEventsService';
+export { EmailEvent, EmailEventType, EmailProvider, EmailEventMetadata, EmailAnalytics, ProviderAnalytics, EmailWebhookEventsConfig, ProviderWebhookConfig, NotificationChannel, EmailWebhookResult, WebhookPayload, AnalyticsFilters, EventQuery, EmailWebhookError, EmailWebhookErrorCode } from './types';
+export { EventNormalizer } from './normalizers/EventNormalizer';
+export { SendGridNormalizer } from './normalizers/SendGridNormalizer';
+export { MailgunNormalizer } from './normalizers/MailgunNormalizer';
+export { SESNormalizer } from './normalizers/SESNormalizer';
+export { PostmarkNormalizer } from './normalizers/PostmarkNormalizer';
+export { SMTP2GONormalizer } from './normalizers/SMTP2GONormalizer';
+export { AnalyticsEngine } from './analytics/AnalyticsEngine';
+export { PersistenceAdapter } from './persistence/PersistenceAdapter';
+export { InMemoryPersistenceAdapter } from './persistence/InMemoryPersistenceAdapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAExE,OAAO,EACL,UAAU,EACV,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+"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.InMemoryPersistenceAdapter = exports.AnalyticsEngine = exports.SMTP2GONormalizer = exports.PostmarkNormalizer = exports.SESNormalizer = exports.MailgunNormalizer = exports.SendGridNormalizer = exports.EmailWebhookErrorCode = exports.EmailProvider = exports.EmailEventType = exports.EmailWebhookEventsService = void 0;
+var EmailWebhookEventsService_1 = require("./EmailWebhookEventsService");
+Object.defineProperty(exports, "EmailWebhookEventsService", { enumerable: true, get: function () { return EmailWebhookEventsService_1.EmailWebhookEventsService; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "EmailEventType", { enumerable: true, get: function () { return types_1.EmailEventType; } });
+Object.defineProperty(exports, "EmailProvider", { enumerable: true, get: function () { return types_1.EmailProvider; } });
+Object.defineProperty(exports, "EmailWebhookErrorCode", { enumerable: true, get: function () { return types_1.EmailWebhookErrorCode; } });
+var SendGridNormalizer_1 = require("./normalizers/SendGridNormalizer");
+Object.defineProperty(exports, "SendGridNormalizer", { enumerable: true, get: function () { return SendGridNormalizer_1.SendGridNormalizer; } });
+var MailgunNormalizer_1 = require("./normalizers/MailgunNormalizer");
+Object.defineProperty(exports, "MailgunNormalizer", { enumerable: true, get: function () { return MailgunNormalizer_1.MailgunNormalizer; } });
+var SESNormalizer_1 = require("./normalizers/SESNormalizer");
+Object.defineProperty(exports, "SESNormalizer", { enumerable: true, get: function () { return SESNormalizer_1.SESNormalizer; } });
+var PostmarkNormalizer_1 = require("./normalizers/PostmarkNormalizer");
+Object.defineProperty(exports, "PostmarkNormalizer", { enumerable: true, get: function () { return PostmarkNormalizer_1.PostmarkNormalizer; } });
+var SMTP2GONormalizer_1 = require("./normalizers/SMTP2GONormalizer");
+Object.defineProperty(exports, "SMTP2GONormalizer", { enumerable: true, get: function () { return SMTP2GONormalizer_1.SMTP2GONormalizer; } });
+var AnalyticsEngine_1 = require("./analytics/AnalyticsEngine");
+Object.defineProperty(exports, "AnalyticsEngine", { enumerable: true, get: function () { return AnalyticsEngine_1.AnalyticsEngine; } });
+var InMemoryPersistenceAdapter_1 = require("./persistence/InMemoryPersistenceAdapter");
+Object.defineProperty(exports, "InMemoryPersistenceAdapter", { enumerable: true, get: function () { return InMemoryPersistenceAdapter_1.InMemoryPersistenceAdapter; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;AAEF,yEAAwE;AAA/D,sIAAA,yBAAyB,OAAA;AAElC,iCAgBiB;AAdf,uGAAA,cAAc,OAAA;AACd,sGAAA,aAAa,OAAA;AAYb,8GAAA,qBAAqB,OAAA;AAIvB,uEAAsE;AAA7D,wHAAA,kBAAkB,OAAA;AAC3B,qEAAoE;AAA3D,sHAAA,iBAAiB,OAAA;AAC1B,6DAA4D;AAAnD,8GAAA,aAAa,OAAA;AACtB,uEAAsE;AAA7D,wHAAA,kBAAkB,OAAA;AAC3B,qEAAoE;AAA3D,sHAAA,iBAAiB,OAAA;AAE1B,+DAA8D;AAArD,kHAAA,eAAe,OAAA;AAGxB,uFAAsF;AAA7E,wIAAA,0BAA0B,OAAA"}

package/dist/normalizers/EventNormalizer.d.ts

@@ -0,0 +1,5 @@
+import { EmailEvent, WebhookPayload } from '../types';
+export interface EventNormalizer {
+    normalize(webhook: WebhookPayload): EmailEvent;
+}
+//# sourceMappingURL=EventNormalizer.d.ts.map

package/dist/normalizers/EventNormalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventNormalizer.d.ts","sourceRoot":"","sources":["../../src/normalizers/EventNormalizer.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,UAAU,CAAC;CAChD"}

package/dist/normalizers/EventNormalizer.js

@@ -0,0 +1,10 @@
+"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 });
+//# sourceMappingURL=EventNormalizer.js.map

package/dist/normalizers/EventNormalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventNormalizer.js","sourceRoot":"","sources":["../../src/normalizers/EventNormalizer.ts"],"names":[],"mappings":";AAAA;;;;;;EAME"}

package/dist/normalizers/MailgunNormalizer.d.ts

@@ -0,0 +1,9 @@
+import { EventNormalizer } from './EventNormalizer';
+import { EmailEvent, WebhookPayload } from '../types';
+export declare class MailgunNormalizer implements EventNormalizer {
+    normalize(webhook: WebhookPayload): EmailEvent;
+    private mapEventType;
+    private generateEventId;
+    private detectDeviceType;
+}
+//# sourceMappingURL=MailgunNormalizer.d.ts.map

package/dist/normalizers/MailgunNormalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MailgunNormalizer.d.ts","sourceRoot":"","sources":["../../src/normalizers/MailgunNormalizer.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAiC,cAAc,EAAE,MAAM,UAAU,CAAC;AAErF,qBAAa,iBAAkB,YAAW,eAAe;IACvD,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,UAAU;IAmC9C,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,gBAAgB;CAOzB"}

package/dist/normalizers/MailgunNormalizer.js

@@ -0,0 +1,73 @@
+"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.MailgunNormalizer = void 0;
+const types_1 = require("../types");
+class MailgunNormalizer {
+    normalize(webhook) {
+        const payload = webhook.payload;
+        const event = payload['event-data'];
+        const message = event.message || {};
+        const headers = message.headers || {};
+        const deliveryStatus = event['delivery-status'];
+        const clientInfo = event['client-info'];
+        const geolocation = event.geolocation;
+        return {
+            id: this.generateEventId(event),
+            emailId: headers['message-id'] || '',
+            messageId: event.id || '',
+            type: this.mapEventType(event.event),
+            recipient: event.recipient || '',
+            timestamp: new Date(event.timestamp * 1000),
+            provider: types_1.EmailProvider.MAILGUN,
+            metadata: {
+                url: event.url,
+                bounceType: event.severity === 'permanent' ? 'hard' : 'soft',
+                bounceReason: deliveryStatus?.message,
+                bounceCode: deliveryStatus?.code?.toString(),
+                ipAddress: clientInfo?.['client-ip'],
+                userAgent: clientInfo?.['user-agent'],
+                deviceType: this.detectDeviceType(clientInfo?.['user-agent']),
+                location: {
+                    country: geolocation?.country,
+                    region: geolocation?.region,
+                    city: geolocation?.city
+                }
+            },
+            rawEvent: event
+        };
+    }
+    mapEventType(mailgunEvent) {
+        const mapping = {
+            'delivered': types_1.EmailEventType.DELIVERED,
+            'opened': types_1.EmailEventType.OPENED,
+            'clicked': types_1.EmailEventType.CLICKED,
+            'bounced': types_1.EmailEventType.BOUNCED,
+            'complained': types_1.EmailEventType.COMPLAINED,
+            'unsubscribed': types_1.EmailEventType.UNSUBSCRIBED,
+            'failed': types_1.EmailEventType.FAILED
+        };
+        return mapping[mailgunEvent] || types_1.EmailEventType.FAILED;
+    }
+    generateEventId(event) {
+        return `mailgun-${event.id}`;
+    }
+    detectDeviceType(userAgent) {
+        if (!userAgent)
+            return 'unknown';
+        const ua = userAgent.toLowerCase();
+        if (ua.includes('mobile'))
+            return 'mobile';
+        if (ua.includes('tablet') || ua.includes('ipad'))
+            return 'tablet';
+        return 'desktop';
+    }
+}
+exports.MailgunNormalizer = MailgunNormalizer;
+//# sourceMappingURL=MailgunNormalizer.js.map

package/dist/normalizers/MailgunNormalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MailgunNormalizer.js","sourceRoot":"","sources":["../../src/normalizers/MailgunNormalizer.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;AAGF,oCAAqF;AAErF,MAAa,iBAAiB;IAC5B,SAAS,CAAC,OAAuB;QAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAkC,CAAC;QAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,CAA4B,CAAC;QAC/D,MAAM,OAAO,GAAI,KAAK,CAAC,OAAmC,IAAI,EAAE,CAAC;QACjE,MAAM,OAAO,GAAI,OAAO,CAAC,OAAkC,IAAI,EAAE,CAAC;QAClE,MAAM,cAAc,GAAG,KAAK,CAAC,iBAAiB,CAAwC,CAAC;QACvF,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,CAAwC,CAAC;QAC/E,MAAM,WAAW,GAAG,KAAK,CAAC,WAAiD,CAAC;QAE5E,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;YAC/B,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE;YACpC,SAAS,EAAG,KAAK,CAAC,EAAa,IAAI,EAAE;YACrC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,KAAe,CAAC;YAC9C,SAAS,EAAG,KAAK,CAAC,SAAoB,IAAI,EAAE;YAC5C,SAAS,EAAE,IAAI,IAAI,CAAE,KAAK,CAAC,SAAoB,GAAG,IAAI,CAAC;YACvD,QAAQ,EAAE,qBAAa,CAAC,OAAO;YAC/B,QAAQ,EAAE;gBACR,GAAG,EAAE,KAAK,CAAC,GAAyB;gBACpC,UAAU,EAAG,KAAK,CAAC,QAAmB,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;gBACxE,YAAY,EAAE,cAAc,EAAE,OAA6B;gBAC3D,UAAU,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC5C,SAAS,EAAE,UAAU,EAAE,CAAC,WAAW,CAAuB;gBAC1D,SAAS,EAAE,UAAU,EAAE,CAAC,YAAY,CAAuB;gBAC3D,UAAU,EAAE,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC,YAAY,CAAuB,CAAC;gBACnF,QAAQ,EAAE;oBACR,OAAO,EAAE,WAAW,EAAE,OAAO;oBAC7B,MAAM,EAAE,WAAW,EAAE,MAAM;oBAC3B,IAAI,EAAE,WAAW,EAAE,IAAI;iBACxB;aACF;YACD,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;IAEO,YAAY,CAAC,YAAoB;QACvC,MAAM,OAAO,GAAmC;YAC9C,WAAW,EAAE,sBAAc,CAAC,SAAS;YACrC,QAAQ,EAAE,sBAAc,CAAC,MAAM;YAC/B,SAAS,EAAE,sBAAc,CAAC,OAAO;YACjC,SAAS,EAAE,sBAAc,CAAC,OAAO;YACjC,YAAY,EAAE,sBAAc,CAAC,UAAU;YACvC,cAAc,EAAE,sBAAc,CAAC,YAAY;YAC3C,QAAQ,EAAE,sBAAc,CAAC,MAAM;SAChC,CAAC;QACF,OAAO,OAAO,CAAC,YAAY,CAAC,IAAI,sBAAc,CAAC,MAAM,CAAC;IACxD,CAAC;IAEO,eAAe,CAAC,KAA8B;QACpD,OAAO,WAAW,KAAK,CAAC,EAAY,EAAE,CAAC;IACzC,CAAC;IAEO,gBAAgB,CAAC,SAAkB;QACzC,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QACjC,MAAM,EAAE,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;QACnC,IAAI,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;QAC3C,IAAI,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,QAAQ,CAAC;QAClE,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AA5DD,8CA4DC"}