@bernierllc/email-webhook-events 1.0.0

package/dist/normalizers/PostmarkNormalizer.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"PostmarkNormalizer.d.ts","sourceRoot":"","sources":["../../src/normalizers/PostmarkNormalizer.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAiC,cAAc,EAAE,MAAM,UAAU,CAAC;AAErF,qBAAa,kBAAmB,YAAW,eAAe;IACxD,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,UAAU;IA6B9C,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,gBAAgB;CAOzB"}

package/dist/normalizers/PostmarkNormalizer.js

@@ -0,0 +1,75 @@
+"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.PostmarkNormalizer = void 0;
+const types_1 = require("../types");
+class PostmarkNormalizer {
+    normalize(webhook) {
+        const event = webhook.payload;
+        return {
+            id: this.generateEventId(event),
+            emailId: event.MessageID || '',
+            messageId: event.MessageID || '',
+            type: this.mapEventType(event.RecordType),
+            recipient: event.Recipient || '',
+            timestamp: new Date(event.ReceivedAt),
+            provider: types_1.EmailProvider.POSTMARK,
+            metadata: {
+                url: event.OriginalLink,
+                bounceType: this.mapBounceType(event.Type),
+                bounceReason: event.Description,
+                bounceCode: event.TypeCode?.toString(),
+                complaintFeedbackType: event.Type,
+                userAgent: event.UserAgent,
+                deviceType: this.detectDeviceType(event.UserAgent),
+                location: {
+                    country: event.Geo?.Country,
+                    region: event.Geo?.Region,
+                    city: event.Geo?.City
+                }
+            },
+            rawEvent: event
+        };
+    }
+    mapEventType(postmarkEvent) {
+        const mapping = {
+            'Delivery': types_1.EmailEventType.DELIVERED,
+            'Open': types_1.EmailEventType.OPENED,
+            'Click': types_1.EmailEventType.CLICKED,
+            'Bounce': types_1.EmailEventType.BOUNCED,
+            'SpamComplaint': types_1.EmailEventType.COMPLAINED,
+            'SubscriptionChange': types_1.EmailEventType.UNSUBSCRIBED
+        };
+        return mapping[postmarkEvent] || types_1.EmailEventType.FAILED;
+    }
+    mapBounceType(bounceType) {
+        if (!bounceType)
+            return undefined;
+        if (bounceType.includes('Hard'))
+            return 'hard';
+        if (bounceType.includes('Soft'))
+            return 'soft';
+        return undefined;
+    }
+    generateEventId(event) {
+        return `postmark-${event.MessageID || ''}-${Date.now()}`;
+    }
+    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.PostmarkNormalizer = PostmarkNormalizer;
+//# sourceMappingURL=PostmarkNormalizer.js.map

package/dist/normalizers/PostmarkNormalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostmarkNormalizer.js","sourceRoot":"","sources":["../../src/normalizers/PostmarkNormalizer.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;AAGF,oCAAqF;AAErF,MAAa,kBAAkB;IAC7B,SAAS,CAAC,OAAuB;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,OAAkC,CAAC;QAEzD,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;YAC/B,OAAO,EAAG,KAAK,CAAC,SAAoB,IAAI,EAAE;YAC1C,SAAS,EAAG,KAAK,CAAC,SAAoB,IAAI,EAAE;YAC5C,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,UAAoB,CAAC;YACnD,SAAS,EAAG,KAAK,CAAC,SAAoB,IAAI,EAAE;YAC5C,SAAS,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,UAAoB,CAAC;YAC/C,QAAQ,EAAE,qBAAa,CAAC,QAAQ;YAChC,QAAQ,EAAE;gBACR,GAAG,EAAE,KAAK,CAAC,YAAkC;gBAC7C,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAA0B,CAAC;gBAChE,YAAY,EAAE,KAAK,CAAC,WAAiC;gBACrD,UAAU,EAAE,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE;gBACtC,qBAAqB,EAAE,KAAK,CAAC,IAA0B;gBACvD,SAAS,EAAE,KAAK,CAAC,SAA+B;gBAChD,UAAU,EAAE,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,SAA+B,CAAC;gBACxE,QAAQ,EAAE;oBACR,OAAO,EAAG,KAAK,CAAC,GAA0C,EAAE,OAAO;oBACnE,MAAM,EAAG,KAAK,CAAC,GAA0C,EAAE,MAAM;oBACjE,IAAI,EAAG,KAAK,CAAC,GAA0C,EAAE,IAAI;iBAC9D;aACF;YACD,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;IAEO,YAAY,CAAC,aAAqB;QACxC,MAAM,OAAO,GAAmC;YAC9C,UAAU,EAAE,sBAAc,CAAC,SAAS;YACpC,MAAM,EAAE,sBAAc,CAAC,MAAM;YAC7B,OAAO,EAAE,sBAAc,CAAC,OAAO;YAC/B,QAAQ,EAAE,sBAAc,CAAC,OAAO;YAChC,eAAe,EAAE,sBAAc,CAAC,UAAU;YAC1C,oBAAoB,EAAE,sBAAc,CAAC,YAAY;SAClD,CAAC;QACF,OAAO,OAAO,CAAC,aAAa,CAAC,IAAI,sBAAc,CAAC,MAAM,CAAC;IACzD,CAAC;IAEO,aAAa,CAAC,UAAmB;QACvC,IAAI,CAAC,UAAU;YAAE,OAAO,SAAS,CAAC;QAClC,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QAC/C,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QAC/C,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,eAAe,CAAC,KAA8B;QACpD,OAAO,YAAa,KAAK,CAAC,SAAoB,IAAI,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IACvE,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,gDA4DC"}

package/dist/normalizers/SESNormalizer.d.ts

@@ -0,0 +1,16 @@
+import { EventNormalizer } from './EventNormalizer';
+import { EmailEvent, WebhookPayload } from '../types';
+export declare class SESNormalizer implements EventNormalizer {
+    normalize(webhook: WebhookPayload): EmailEvent;
+    private mapEventType;
+    private extractMessageId;
+    private extractRecipient;
+    private extractBounceType;
+    private extractBounceReason;
+    private extractComplaintType;
+    private extractClickUrl;
+    private extractIpAddress;
+    private extractUserAgent;
+    private generateEventId;
+}
+//# sourceMappingURL=SESNormalizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SESNormalizer.d.ts","sourceRoot":"","sources":["../../src/normalizers/SESNormalizer.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAiC,cAAc,EAAE,MAAM,UAAU,CAAC;AAErF,qBAAa,aAAc,YAAW,eAAe;IACnD,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,UAAU;IAyB9C,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,gBAAgB;IAuBxB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,eAAe;CAIxB"}

package/dist/normalizers/SESNormalizer.js

@@ -0,0 +1,107 @@
+"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.SESNormalizer = void 0;
+const types_1 = require("../types");
+class SESNormalizer {
+    normalize(webhook) {
+        const payload = webhook.payload;
+        const message = JSON.parse(payload.Message);
+        const eventType = message.eventType;
+        return {
+            id: this.generateEventId(message),
+            emailId: this.extractMessageId(message),
+            messageId: this.extractMessageId(message),
+            type: this.mapEventType(eventType),
+            recipient: this.extractRecipient(message),
+            timestamp: new Date(message.mail.timestamp),
+            provider: types_1.EmailProvider.AWS_SES,
+            metadata: {
+                bounceType: this.extractBounceType(message),
+                bounceReason: this.extractBounceReason(message),
+                complaintFeedbackType: this.extractComplaintType(message),
+                url: this.extractClickUrl(message),
+                ipAddress: this.extractIpAddress(message),
+                userAgent: this.extractUserAgent(message)
+            },
+            rawEvent: message
+        };
+    }
+    mapEventType(sesEvent) {
+        const mapping = {
+            'Delivery': types_1.EmailEventType.DELIVERED,
+            'Open': types_1.EmailEventType.OPENED,
+            'Click': types_1.EmailEventType.CLICKED,
+            'Bounce': types_1.EmailEventType.BOUNCED,
+            'Complaint': types_1.EmailEventType.COMPLAINED,
+            'Reject': types_1.EmailEventType.FAILED
+        };
+        return mapping[sesEvent] || types_1.EmailEventType.FAILED;
+    }
+    extractMessageId(message) {
+        const mail = message.mail;
+        return mail?.messageId || '';
+    }
+    extractRecipient(message) {
+        const bounce = message.bounce;
+        const complaint = message.complaint;
+        const mail = message.mail;
+        if (bounce) {
+            const bouncedRecipients = bounce.bouncedRecipients;
+            if (bouncedRecipients?.[0]?.emailAddress) {
+                return bouncedRecipients[0].emailAddress;
+            }
+        }
+        if (complaint) {
+            const complainedRecipients = complaint.complainedRecipients;
+            if (complainedRecipients?.[0]?.emailAddress) {
+                return complainedRecipients[0].emailAddress;
+            }
+        }
+        const destination = mail.destination;
+        return destination?.[0] || '';
+    }
+    extractBounceType(message) {
+        const bounce = message.bounce;
+        if (!bounce)
+            return undefined;
+        return bounce.bounceType?.toLowerCase();
+    }
+    extractBounceReason(message) {
+        const bounce = message.bounce;
+        if (!bounce)
+            return undefined;
+        const bouncedRecipients = bounce.bouncedRecipients;
+        return bouncedRecipients?.[0]?.diagnosticCode;
+    }
+    extractComplaintType(message) {
+        const complaint = message.complaint;
+        return complaint?.complaintFeedbackType;
+    }
+    extractClickUrl(message) {
+        const click = message.click;
+        return click?.link;
+    }
+    extractIpAddress(message) {
+        const open = message.open;
+        const click = message.click;
+        return open?.ipAddress || click?.ipAddress || undefined;
+    }
+    extractUserAgent(message) {
+        const open = message.open;
+        const click = message.click;
+        return open?.userAgent || click?.userAgent || undefined;
+    }
+    generateEventId(message) {
+        const mail = message.mail;
+        return `ses-${mail?.messageId || ''}-${Date.now()}`;
+    }
+}
+exports.SESNormalizer = SESNormalizer;
+//# sourceMappingURL=SESNormalizer.js.map

package/dist/normalizers/SESNormalizer.js.map

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

package/dist/normalizers/SMTP2GONormalizer.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"SMTP2GONormalizer.d.ts","sourceRoot":"","sources":["../../src/normalizers/SMTP2GONormalizer.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;IAoB9C,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,eAAe;CAGxB"}

package/dist/normalizers/SMTP2GONormalizer.js

@@ -0,0 +1,55 @@
+"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.SMTP2GONormalizer = void 0;
+const types_1 = require("../types");
+class SMTP2GONormalizer {
+    normalize(webhook) {
+        const event = webhook.payload;
+        return {
+            id: this.generateEventId(event),
+            emailId: event.email_id || event.message_id || '',
+            messageId: event.message_id || '',
+            type: this.mapEventType(event.event),
+            recipient: event.rcpt_to || '',
+            timestamp: new Date(event.timestamp),
+            provider: types_1.EmailProvider.SMTP2GO,
+            metadata: {
+                bounceType: this.mapBounceType(event.bounce_type),
+                bounceReason: event.reason,
+                failureReason: event.reason
+            },
+            rawEvent: event
+        };
+    }
+    mapEventType(smtp2goEvent) {
+        const mapping = {
+            'delivered': types_1.EmailEventType.DELIVERED,
+            'open': types_1.EmailEventType.OPENED,
+            'click': types_1.EmailEventType.CLICKED,
+            'bounce': types_1.EmailEventType.BOUNCED,
+            'failed': types_1.EmailEventType.FAILED
+        };
+        return mapping[smtp2goEvent] || types_1.EmailEventType.FAILED;
+    }
+    mapBounceType(bounceType) {
+        if (!bounceType)
+            return undefined;
+        if (bounceType.toLowerCase().includes('hard'))
+            return 'hard';
+        if (bounceType.toLowerCase().includes('soft'))
+            return 'soft';
+        return undefined;
+    }
+    generateEventId(event) {
+        return `smtp2go-${event.message_id || ''}-${Date.now()}`;
+    }
+}
+exports.SMTP2GONormalizer = SMTP2GONormalizer;
+//# sourceMappingURL=SMTP2GONormalizer.js.map

package/dist/normalizers/SMTP2GONormalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SMTP2GONormalizer.js","sourceRoot":"","sources":["../../src/normalizers/SMTP2GONormalizer.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;AAGF,oCAAqF;AAErF,MAAa,iBAAiB;IAC5B,SAAS,CAAC,OAAuB;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,OAAkC,CAAC;QAEzD,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;YAC/B,OAAO,EAAG,KAAK,CAAC,QAAmB,IAAK,KAAK,CAAC,UAAqB,IAAI,EAAE;YACzE,SAAS,EAAG,KAAK,CAAC,UAAqB,IAAI,EAAE;YAC7C,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,KAAe,CAAC;YAC9C,SAAS,EAAG,KAAK,CAAC,OAAkB,IAAI,EAAE;YAC1C,SAAS,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,SAAmB,CAAC;YAC9C,QAAQ,EAAE,qBAAa,CAAC,OAAO;YAC/B,QAAQ,EAAE;gBACR,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,WAAiC,CAAC;gBACvE,YAAY,EAAE,KAAK,CAAC,MAA4B;gBAChD,aAAa,EAAE,KAAK,CAAC,MAA4B;aAClD;YACD,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;IAEO,YAAY,CAAC,YAAoB;QACvC,MAAM,OAAO,GAAmC;YAC9C,WAAW,EAAE,sBAAc,CAAC,SAAS;YACrC,MAAM,EAAE,sBAAc,CAAC,MAAM;YAC7B,OAAO,EAAE,sBAAc,CAAC,OAAO;YAC/B,QAAQ,EAAE,sBAAc,CAAC,OAAO;YAChC,QAAQ,EAAE,sBAAc,CAAC,MAAM;SAChC,CAAC;QACF,OAAO,OAAO,CAAC,YAAY,CAAC,IAAI,sBAAc,CAAC,MAAM,CAAC;IACxD,CAAC;IAEO,aAAa,CAAC,UAAmB;QACvC,IAAI,CAAC,UAAU;YAAE,OAAO,SAAS,CAAC;QAClC,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QAC7D,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QAC7D,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,eAAe,CAAC,KAA8B;QACpD,OAAO,WAAY,KAAK,CAAC,UAAqB,IAAI,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IACvE,CAAC;CACF;AA1CD,8CA0CC"}

package/dist/normalizers/SendGridNormalizer.d.ts

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

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

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

package/dist/normalizers/SendGridNormalizer.js

@@ -0,0 +1,64 @@
+"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.SendGridNormalizer = void 0;
+const types_1 = require("../types");
+class SendGridNormalizer {
+    normalize(webhook) {
+        const event = webhook.payload;
+        return {
+            id: this.generateEventId(event),
+            emailId: event.email_id || event.sg_message_id || '',
+            messageId: event.sg_message_id || '',
+            type: this.mapEventType(event.event),
+            recipient: event.email || '',
+            timestamp: new Date(event.timestamp * 1000),
+            provider: types_1.EmailProvider.SENDGRID,
+            metadata: {
+                url: event.url,
+                bounceType: event.event === 'bounce'
+                    ? (event.status?.startsWith('5') ? 'hard' : 'soft')
+                    : undefined,
+                bounceReason: event.reason,
+                userAgent: event.useragent,
+                ipAddress: event.ip,
+                deviceType: this.detectDeviceType(event.useragent)
+            },
+            rawEvent: event
+        };
+    }
+    mapEventType(sendgridEvent) {
+        const mapping = {
+            'delivered': types_1.EmailEventType.DELIVERED,
+            'open': types_1.EmailEventType.OPENED,
+            'click': types_1.EmailEventType.CLICKED,
+            'bounce': types_1.EmailEventType.BOUNCED,
+            'dropped': types_1.EmailEventType.DROPPED,
+            'spamreport': types_1.EmailEventType.COMPLAINED,
+            'unsubscribe': types_1.EmailEventType.UNSUBSCRIBED,
+            'deferred': types_1.EmailEventType.DEFERRED
+        };
+        return mapping[sendgridEvent] || types_1.EmailEventType.FAILED;
+    }
+    generateEventId(event) {
+        return `sendgrid-${event.sg_event_id || Date.now()}`;
+    }
+    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.SendGridNormalizer = SendGridNormalizer;
+//# sourceMappingURL=SendGridNormalizer.js.map

package/dist/normalizers/SendGridNormalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SendGridNormalizer.js","sourceRoot":"","sources":["../../src/normalizers/SendGridNormalizer.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;AAGF,oCAAqF;AAErF,MAAa,kBAAkB;IAC7B,SAAS,CAAC,OAAuB;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,OAAkC,CAAC;QAEzD,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;YAC/B,OAAO,EAAG,KAAK,CAAC,QAAmB,IAAK,KAAK,CAAC,aAAwB,IAAI,EAAE;YAC5E,SAAS,EAAG,KAAK,CAAC,aAAwB,IAAI,EAAE;YAChD,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,KAAe,CAAC;YAC9C,SAAS,EAAG,KAAK,CAAC,KAAgB,IAAI,EAAE;YACxC,SAAS,EAAE,IAAI,IAAI,CAAE,KAAK,CAAC,SAAoB,GAAG,IAAI,CAAC;YACvD,QAAQ,EAAE,qBAAa,CAAC,QAAQ;YAChC,QAAQ,EAAE;gBACR,GAAG,EAAE,KAAK,CAAC,GAAyB;gBACpC,UAAU,EAAE,KAAK,CAAC,KAAK,KAAK,QAAQ;oBAClC,CAAC,CAAC,CAAE,KAAK,CAAC,MAAiB,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;oBAC/D,CAAC,CAAC,SAAS;gBACb,YAAY,EAAE,KAAK,CAAC,MAA4B;gBAChD,SAAS,EAAE,KAAK,CAAC,SAA+B;gBAChD,SAAS,EAAE,KAAK,CAAC,EAAwB;gBACzC,UAAU,EAAE,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,SAA+B,CAAC;aACzE;YACD,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;IAEO,YAAY,CAAC,aAAqB;QACxC,MAAM,OAAO,GAAmC;YAC9C,WAAW,EAAE,sBAAc,CAAC,SAAS;YACrC,MAAM,EAAE,sBAAc,CAAC,MAAM;YAC7B,OAAO,EAAE,sBAAc,CAAC,OAAO;YAC/B,QAAQ,EAAE,sBAAc,CAAC,OAAO;YAChC,SAAS,EAAE,sBAAc,CAAC,OAAO;YACjC,YAAY,EAAE,sBAAc,CAAC,UAAU;YACvC,aAAa,EAAE,sBAAc,CAAC,YAAY;YAC1C,UAAU,EAAE,sBAAc,CAAC,QAAQ;SACpC,CAAC;QACF,OAAO,OAAO,CAAC,aAAa,CAAC,IAAI,sBAAc,CAAC,MAAM,CAAC;IACzD,CAAC;IAEO,eAAe,CAAC,KAA8B;QACpD,OAAO,YAAa,KAAK,CAAC,WAAsB,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IACnE,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;AAnDD,gDAmDC"}

package/dist/persistence/InMemoryPersistenceAdapter.d.ts

@@ -0,0 +1,12 @@
+import { PersistenceAdapter } from './PersistenceAdapter';
+import { EmailEvent, EventQuery } from '../types';
+export declare class InMemoryPersistenceAdapter implements PersistenceAdapter {
+    private events;
+    private sentEmails;
+    saveEvent(event: EmailEvent): Promise<void>;
+    queryEvents(query: EventQuery): Promise<EmailEvent[]>;
+    saveSentEmail(emailData: unknown): Promise<void>;
+    getEventCount(): number;
+    clearEvents(): void;
+}
+//# sourceMappingURL=InMemoryPersistenceAdapter.d.ts.map

package/dist/persistence/InMemoryPersistenceAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryPersistenceAdapter.d.ts","sourceRoot":"","sources":["../../src/persistence/InMemoryPersistenceAdapter.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAElD,qBAAa,0BAA2B,YAAW,kBAAkB;IACnE,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,UAAU,CAAiB;IAE7B,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAmCrD,aAAa,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtD,aAAa,IAAI,MAAM;IAIvB,WAAW,IAAI,IAAI;CAIpB"}

package/dist/persistence/InMemoryPersistenceAdapter.js

@@ -0,0 +1,58 @@
+"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 = void 0;
+class InMemoryPersistenceAdapter {
+    constructor() {
+        this.events = [];
+        this.sentEmails = [];
+    }
+    async saveEvent(event) {
+        this.events.push(event);
+    }
+    async queryEvents(query) {
+        let results = [...this.events];
+        if (query.emailId) {
+            results = results.filter(e => e.emailId === query.emailId);
+        }
+        if (query.recipient) {
+            results = results.filter(e => e.recipient === query.recipient);
+        }
+        if (query.eventTypes && query.eventTypes.length > 0) {
+            results = results.filter(e => query.eventTypes.includes(e.type));
+        }
+        if (query.startDate) {
+            results = results.filter(e => e.timestamp >= query.startDate);
+        }
+        if (query.endDate) {
+            results = results.filter(e => e.timestamp <= query.endDate);
+        }
+        // Apply offset and limit
+        if (query.offset) {
+            results = results.slice(query.offset);
+        }
+        if (query.limit) {
+            results = results.slice(0, query.limit);
+        }
+        return results;
+    }
+    async saveSentEmail(emailData) {
+        this.sentEmails.push(emailData);
+    }
+    // Test helper methods
+    getEventCount() {
+        return this.events.length;
+    }
+    clearEvents() {
+        this.events = [];
+        this.sentEmails = [];
+    }
+}
+exports.InMemoryPersistenceAdapter = InMemoryPersistenceAdapter;
+//# sourceMappingURL=InMemoryPersistenceAdapter.js.map

package/dist/persistence/InMemoryPersistenceAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryPersistenceAdapter.js","sourceRoot":"","sources":["../../src/persistence/InMemoryPersistenceAdapter.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;AAKF,MAAa,0BAA0B;IAAvC;QACU,WAAM,GAAiB,EAAE,CAAC;QAC1B,eAAU,GAAc,EAAE,CAAC;IAsDrC,CAAC;IApDC,KAAK,CAAC,SAAS,CAAC,KAAiB;QAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAiB;QACjC,IAAI,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAE/B,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,UAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,SAAU,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,OAAQ,CAAC,CAAC;QAC/D,CAAC;QAED,yBAAyB;QACzB,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,SAAkB;QACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,sBAAsB;IACtB,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,WAAW;QACT,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IACvB,CAAC;CACF;AAxDD,gEAwDC"}

package/dist/persistence/PersistenceAdapter.d.ts

@@ -0,0 +1,7 @@
+import { EmailEvent, EventQuery } from '../types';
+export interface PersistenceAdapter {
+    saveEvent(event: EmailEvent): Promise<void>;
+    queryEvents(query: EventQuery): Promise<EmailEvent[]>;
+    saveSentEmail?(emailData: unknown): Promise<void>;
+}
+//# sourceMappingURL=PersistenceAdapter.d.ts.map

package/dist/persistence/PersistenceAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PersistenceAdapter.d.ts","sourceRoot":"","sources":["../../src/persistence/PersistenceAdapter.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACtD,aAAa,CAAC,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD"}

package/dist/persistence/PersistenceAdapter.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=PersistenceAdapter.js.map

package/dist/persistence/PersistenceAdapter.js.map

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