@bernierllc/email-tracking 1.0.0

package/coverage/lcov.info

@@ -0,0 +1,356 @@
+TN:
+SF:src/EmailTracking.ts
+FN:34,(anonymous_0)
+FN:39,(anonymous_1)
+FN:60,(anonymous_2)
+FN:91,(anonymous_3)
+FN:95,(anonymous_4)
+FN:100,(anonymous_5)
+FN:105,(anonymous_6)
+FN:157,(anonymous_7)
+FN:229,(anonymous_8)
+FN:255,(anonymous_9)
+FN:267,(anonymous_10)
+FN:279,(anonymous_11)
+FN:283,(anonymous_12)
+FN:287,(anonymous_13)
+FN:293,(anonymous_14)
+FNF:15
+FNH:11
+FNDA:38,(anonymous_0)
+FNDA:39,(anonymous_1)
+FNDA:0,(anonymous_2)
+FNDA:0,(anonymous_3)
+FNDA:0,(anonymous_4)
+FNDA:0,(anonymous_5)
+FNDA:70,(anonymous_6)
+FNDA:78,(anonymous_7)
+FNDA:13,(anonymous_8)
+FNDA:16,(anonymous_9)
+FNDA:9,(anonymous_10)
+FNDA:70,(anonymous_11)
+FNDA:147,(anonymous_12)
+FNDA:38,(anonymous_13)
+FNDA:35,(anonymous_14)
+DA:9,4
+DA:10,4
+DA:23,4
+DA:24,4
+DA:25,4
+DA:27,4
+DA:32,38
+DA:35,38
+DA:36,38
+DA:40,39
+DA:41,1
+DA:45,38
+DA:46,0
+DA:47,0
+DA:48,0
+DA:52,38
+DA:56,38
+DA:57,38
+DA:61,0
+DA:63,0
+DA:92,0
+DA:95,0
+DA:96,0
+DA:100,0
+DA:101,0
+DA:106,70
+DA:107,70
+DA:124,70
+DA:127,70
+DA:134,70
+DA:137,70
+DA:138,69
+DA:141,70
+DA:147,70
+DA:149,0
+DA:150,0
+DA:158,78
+DA:160,78
+DA:162,78
+DA:163,1
+DA:167,1
+DA:171,77
+DA:174,77
+DA:183,77
+DA:186,77
+DA:188,77
+DA:189,74
+DA:192,74
+DA:193,0
+DA:209,77
+DA:210,77
+DA:213,77
+DA:219,77
+DA:221,0
+DA:222,0
+DA:230,13
+DA:231,13
+DA:232,13
+DA:233,2
+DA:236,11
+DA:237,11
+DA:239,11
+DA:246,11
+DA:248,0
+DA:256,16
+DA:257,16
+DA:258,16
+DA:260,0
+DA:268,9
+DA:269,9
+DA:270,9
+DA:272,0
+DA:280,70
+DA:284,147
+DA:294,35
+LF:75
+LH:57
+BRDA:34,0,0,15
+BRDA:40,1,0,1
+BRDA:45,2,0,0
+BRDA:52,3,0,0
+BRDA:52,3,1,38
+BRDA:61,4,0,0
+BRDA:92,5,0,0
+BRDA:137,6,0,69
+BRDA:152,7,0,0
+BRDA:152,7,1,0
+BRDA:162,8,0,1
+BRDA:188,9,0,74
+BRDA:192,10,0,0
+BRDA:209,11,0,77
+BRDA:224,12,0,0
+BRDA:224,12,1,0
+BRDA:232,13,0,2
+BRDA:243,14,0,11
+BRDA:243,14,1,0
+BRDA:250,15,0,0
+BRDA:250,15,1,0
+BRDA:262,16,0,0
+BRDA:262,16,1,0
+BRDA:274,17,0,0
+BRDA:274,17,1,0
+BRF:25
+BRH:9
+end_of_record
+TN:
+SF:src/config.ts
+FN:11,loadConfig
+FNF:1
+FNH:1
+FNDA:48,loadConfig
+DA:11,5
+DA:12,48
+LF:2
+LH:2
+BRDA:11,0,0,7
+BRDA:13,1,0,17
+BRDA:13,1,1,31
+BRDA:15,2,0,31
+BRDA:15,2,1,30
+BRDA:16,3,0,15
+BRDA:16,3,1,33
+BRDA:18,4,0,33
+BRDA:18,4,1,33
+BRDA:19,5,0,16
+BRDA:19,5,1,32
+BRDA:21,6,0,32
+BRDA:21,6,1,29
+BRDA:22,7,0,24
+BRDA:22,7,1,24
+BRDA:24,8,0,24
+BRDA:24,8,1,24
+BRF:17
+BRH:17
+end_of_record
+TN:
+SF:src/database.ts
+FN:21,(anonymous_0)
+FN:27,(anonymous_1)
+FN:32,(anonymous_2)
+FN:36,(anonymous_3)
+FN:42,(anonymous_4)
+FN:51,(anonymous_5)
+FN:57,(anonymous_6)
+FN:61,(anonymous_7)
+FN:117,(anonymous_8)
+FN:137,(anonymous_9)
+FN:139,(anonymous_10)
+FN:142,(anonymous_11)
+FN:146,(anonymous_12)
+FN:147,(anonymous_13)
+FN:150,(anonymous_14)
+FN:151,(anonymous_15)
+FN:152,(anonymous_16)
+FN:173,(anonymous_17)
+FNF:18
+FNH:18
+FNDA:38,(anonymous_0)
+FNDA:70,(anonymous_1)
+FNDA:90,(anonymous_2)
+FNDA:78,(anonymous_3)
+FNDA:74,(anonymous_4)
+FNDA:147,(anonymous_5)
+FNDA:11,(anonymous_6)
+FNDA:146,(anonymous_7)
+FNDA:16,(anonymous_8)
+FNDA:9,(anonymous_9)
+FNDA:42,(anonymous_10)
+FNDA:34,(anonymous_11)
+FNDA:34,(anonymous_12)
+FNDA:34,(anonymous_13)
+FNDA:34,(anonymous_14)
+FNDA:34,(anonymous_15)
+FNDA:34,(anonymous_16)
+FNDA:35,(anonymous_17)
+DA:9,4
+DA:21,4
+DA:22,38
+DA:23,38
+DA:24,38
+DA:25,38
+DA:28,70
+DA:29,70
+DA:33,90
+DA:37,78
+DA:38,78
+DA:39,77
+DA:43,74
+DA:44,74
+DA:45,74
+DA:46,74
+DA:47,74
+DA:52,147
+DA:53,147
+DA:54,147
+DA:58,11
+DA:62,146
+DA:63,147
+DA:65,147
+DA:66,55
+DA:79,147
+DA:81,147
+DA:83,70
+DA:84,70
+DA:85,70
+DA:87,33
+DA:88,33
+DA:89,33
+DA:91,11
+DA:92,11
+DA:93,11
+DA:94,11
+DA:96,12
+DA:97,12
+DA:98,12
+DA:100,11
+DA:101,11
+DA:102,11
+DA:104,6
+DA:105,6
+DA:106,6
+DA:108,4
+DA:109,4
+DA:110,4
+DA:113,147
+DA:118,16
+DA:120,16
+DA:121,3
+DA:134,13
+DA:138,9
+DA:139,42
+DA:141,9
+DA:142,9
+DA:143,34
+DA:146,34
+DA:147,9
+DA:148,34
+DA:150,34
+DA:151,34
+DA:152,34
+DA:154,9
+DA:155,9
+DA:156,9
+DA:158,9
+DA:174,35
+DA:175,35
+DA:176,35
+DA:177,35
+LF:73
+LH:73
+BRDA:33,0,0,90
+BRDA:33,0,1,2
+BRDA:38,1,0,1
+BRDA:44,2,0,74
+BRDA:52,3,0,147
+BRDA:52,3,1,70
+BRDA:58,4,0,11
+BRDA:58,4,1,0
+BRDA:65,5,0,55
+BRDA:81,6,0,70
+BRDA:81,6,1,33
+BRDA:81,6,2,11
+BRDA:81,6,3,12
+BRDA:81,6,4,11
+BRDA:81,6,5,6
+BRDA:81,6,6,4
+BRDA:120,7,0,3
+BRDA:154,8,0,7
+BRDA:154,8,1,2
+BRDA:155,9,0,4
+BRDA:155,9,1,5
+BRDA:156,10,0,2
+BRDA:156,10,1,7
+BRF:23
+BRH:22
+end_of_record
+TN:
+SF:src/status-calculator.ts
+FN:22,calculateNewStatus
+FN:31,mapWebhookEventType
+FNF:2
+FNH:2
+FNDA:96,calculateNewStatus
+FNDA:89,mapWebhookEventType
+DA:9,5
+DA:11,5
+DA:22,5
+DA:26,96
+DA:31,5
+DA:32,89
+DA:42,89
+LF:7
+LH:7
+BRDA:26,0,0,88
+BRDA:26,0,1,8
+BRDA:42,1,0,89
+BRDA:42,1,1,2
+BRF:4
+BRH:4
+end_of_record
+TN:
+SF:src/types.ts
+FN:9,(anonymous_0)
+FNF:1
+FNH:1
+FNDA:5,(anonymous_0)
+DA:9,5
+DA:10,5
+DA:11,5
+DA:12,5
+DA:13,5
+DA:14,5
+DA:15,5
+DA:16,5
+DA:17,5
+LF:9
+LH:9
+BRDA:9,0,0,5
+BRDA:9,0,1,5
+BRF:2
+BRH:2
+end_of_record

package/dist/EmailTracking.d.ts

@@ -0,0 +1,22 @@
+import { EmailSendRecord, EmailTimeline, RecipientHistory, TrackingConfig, EmailTrackingResult, RecordEmailSentData, WebhookEventData, CampaignStatistics } from './types.js';
+export declare class EmailTracking {
+    private neverhub?;
+    private logger?;
+    private config;
+    private database;
+    private initialized;
+    constructor(config?: TrackingConfig);
+    initialize(): Promise<void>;
+    private registerWithNeverHub;
+    private setupEventSubscriptions;
+    recordEmailSent(data: RecordEmailSentData): Promise<EmailTrackingResult<EmailSendRecord>>;
+    processWebhookEvent(webhookEvent: WebhookEventData): Promise<EmailTrackingResult>;
+    getTimeline(trackingId: string): Promise<EmailTrackingResult<EmailTimeline>>;
+    getRecipientHistory(emailAddress: string): Promise<EmailTrackingResult<RecipientHistory>>;
+    getCampaignStats(campaignId: string): Promise<EmailTrackingResult<CampaignStatistics>>;
+    private generateTrackingId;
+    private generateEventId;
+    private initializeCore;
+    clearDatabase(): Promise<void>;
+}
+//# sourceMappingURL=EmailTracking.d.ts.map

package/dist/EmailTracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailTracking.d.ts","sourceRoot":"","sources":["../src/EmailTracking.ts"],"names":[],"mappings":"AASA,OAAO,EACL,eAAe,EAEf,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAGhB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAKpB,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,CAAkB;IACnC,OAAO,CAAC,MAAM,CAAC,CAAU;IACzB,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,GAAE,cAAmB;IAKjC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAqBnB,oBAAoB;YA+BpB,uBAAuB;IAc/B,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC;IAoDzF,mBAAmB,CAAC,YAAY,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAwEjF,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;IA0B5E,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IAYzF,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,CAAC;IAY5F,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,eAAe;YAIT,cAAc;IAMtB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAGrC"}

package/dist/EmailTracking.js

@@ -0,0 +1,253 @@
+"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.EmailTracking = void 0;
+const neverhub_adapter_1 = require("@bernierllc/neverhub-adapter");
+const types_js_1 = require("./types.js");
+const config_js_1 = require("./config.js");
+const status_calculator_js_1 = require("./status-calculator.js");
+const database_js_1 = require("./database.js");
+class EmailTracking {
+    constructor(config = {}) {
+        this.initialized = false;
+        this.config = (0, config_js_1.loadConfig)(config);
+        this.database = new database_js_1.Database();
+    }
+    async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        // Auto-detect NeverHub
+        if (await neverhub_adapter_1.NeverHubAdapter.detect()) {
+            this.neverhub = new neverhub_adapter_1.NeverHubAdapter();
+            await this.registerWithNeverHub();
+            await this.setupEventSubscriptions();
+        }
+        // Initialize logger
+        this.logger = this.neverhub
+            ? await this.neverhub.getService('logging')
+            : console;
+        await this.initializeCore();
+        this.initialized = true;
+    }
+    async registerWithNeverHub() {
+        if (!this.neverhub)
+            return;
+        await this.neverhub.register({
+            type: 'email-tracking',
+            name: '@bernierllc/email-tracking',
+            version: '1.0.0',
+            dependencies: ['email-webhook-events', 'logging'],
+            capabilities: [
+                {
+                    type: 'email',
+                    name: 'delivery-tracking',
+                    version: '1.0.0',
+                    metadata: {
+                        features: ['send-tracking', 'event-linking', 'timeline', 'recipient-history']
+                    }
+                }
+            ],
+            discoveryEnabled: true,
+            discoverySubscriptions: [
+                {
+                    pattern: 'capability.available',
+                    handler: 'onCapabilityAvailable',
+                    metadata: {
+                        capabilityTypes: ['email', 'logging']
+                    }
+                }
+            ]
+        });
+    }
+    async setupEventSubscriptions() {
+        if (!this.neverhub)
+            return;
+        // Subscribe to email sent events
+        await this.neverhub.subscribe('email.sent', async (event) => {
+            await this.recordEmailSent(event.data);
+        });
+        // Subscribe to normalized webhook events
+        await this.neverhub.subscribe('email.webhook.*', async (event) => {
+            await this.processWebhookEvent(event.data);
+        });
+    }
+    async recordEmailSent(data) {
+        try {
+            const sendRecord = {
+                id: this.generateTrackingId(),
+                messageId: data.messageId,
+                provider: data.provider,
+                from: data.from,
+                to: data.to,
+                cc: data.cc,
+                bcc: data.bcc,
+                subject: data.subject,
+                campaignId: data.campaignId,
+                metadata: data.metadata,
+                sentAt: new Date(),
+                currentStatus: types_js_1.EmailDeliveryStatus.SENT,
+                updatedAt: new Date()
+            };
+            // Store send record
+            await this.database.storeSendRecord(sendRecord);
+            // Create initial "sent" event
+            const event = {
+                id: this.generateEventId(),
+                sendRecordId: sendRecord.id,
+                eventType: types_js_1.EmailDeliveryStatus.SENT,
+                timestamp: sendRecord.sentAt,
+                metadata: { provider: data.provider }
+            };
+            await this.database.createEvent(event);
+            // Update recipient history
+            if (this.config.aggregateStats) {
+                await this.database.updateRecipientHistory(sendRecord.to, types_js_1.EmailDeliveryStatus.SENT);
+            }
+            this.logger?.log('Email send recorded', {
+                trackingId: sendRecord.id,
+                messageId: data.messageId,
+                recipients: data.to.length
+            });
+            return { success: true, data: sendRecord };
+        }
+        catch (error) {
+            this.logger?.error('Failed to record email send', { error });
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    }
+    async processWebhookEvent(webhookEvent) {
+        try {
+            // Find matching send record by messageId
+            const sendRecord = await this.database.findSendRecordByMessageId(webhookEvent.messageId);
+            if (!sendRecord) {
+                this.logger?.warn('No send record found for webhook event', {
+                    messageId: webhookEvent.messageId,
+                    eventType: webhookEvent.eventType
+                });
+                return { success: false, error: 'Send record not found' };
+            }
+            // Map webhook event type to our enum
+            const eventType = (0, status_calculator_js_1.mapWebhookEventType)(webhookEvent.eventType);
+            // Create event
+            const event = {
+                id: this.generateEventId(),
+                sendRecordId: sendRecord.id,
+                eventType,
+                timestamp: new Date(webhookEvent.timestamp),
+                metadata: webhookEvent.metadata,
+                sourceEvent: webhookEvent
+            };
+            await this.database.createEvent(event);
+            // Update send record status
+            const newStatus = (0, status_calculator_js_1.calculateNewStatus)(sendRecord.currentStatus, eventType);
+            if (newStatus !== sendRecord.currentStatus) {
+                await this.database.updateSendRecordStatus(sendRecord.id, newStatus);
+                // Publish status change event
+                if (this.neverhub) {
+                    await this.neverhub.publishEvent({
+                        type: 'email.status_changed',
+                        data: {
+                            trackingId: sendRecord.id,
+                            messageId: sendRecord.messageId,
+                            oldStatus: sendRecord.currentStatus,
+                            newStatus: newStatus,
+                            eventType: eventType,
+                            recipient: sendRecord.to[0],
+                            timestamp: event.timestamp
+                        }
+                    });
+                }
+            }
+            // Update recipient history
+            if (this.config.aggregateStats) {
+                await this.database.updateRecipientHistory(sendRecord.to, eventType);
+            }
+            this.logger?.log('Webhook event processed', {
+                trackingId: sendRecord.id,
+                eventType: eventType,
+                newStatus: newStatus
+            });
+            return { success: true };
+        }
+        catch (error) {
+            this.logger?.error('Failed to process webhook event', { error });
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    }
+    async getTimeline(trackingId) {
+        try {
+            const sendRecord = await this.database.getSendRecord(trackingId);
+            if (!sendRecord) {
+                return { success: false, error: 'Send record not found' };
+            }
+            const events = await this.database.getEventsBySendRecord(trackingId);
+            const lastEvent = events[events.length - 1];
+            const timeline = {
+                sendRecord,
+                events,
+                currentStatus: sendRecord.currentStatus,
+                lastEventAt: lastEvent ? lastEvent.timestamp : sendRecord.sentAt
+            };
+            return { success: true, data: timeline };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    }
+    async getRecipientHistory(emailAddress) {
+        try {
+            const history = await this.database.fetchRecipientHistory(emailAddress);
+            return { success: true, data: history };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    }
+    async getCampaignStats(campaignId) {
+        try {
+            const stats = await this.database.aggregateCampaignStats(campaignId);
+            return { success: true, data: stats };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    }
+    generateTrackingId() {
+        return `track_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    generateEventId() {
+        return `event_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    async initializeCore() {
+        // Core initialization (database connections, etc.)
+        // In production, this would set up real database connections
+    }
+    // Test helper to clear database
+    async clearDatabase() {
+        await this.database.clear();
+    }
+}
+exports.EmailTracking = EmailTracking;
+//# sourceMappingURL=EmailTracking.js.map

package/dist/EmailTracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailTracking.js","sourceRoot":"","sources":["../src/EmailTracking.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;AAEF,mEAA+D;AAC/D,yCAYoB;AACpB,2CAAyC;AACzC,iEAAiF;AACjF,+CAAyC;AAEzC,MAAa,aAAa;IAOxB,YAAY,SAAyB,EAAE;QAF/B,gBAAW,GAAG,KAAK,CAAC;QAG1B,IAAI,CAAC,MAAM,GAAG,IAAA,sBAAU,EAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,IAAI,sBAAQ,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,uBAAuB;QACvB,IAAI,MAAM,kCAAe,CAAC,MAAM,EAAE,EAAE,CAAC;YACnC,IAAI,CAAC,QAAQ,GAAG,IAAI,kCAAe,EAAE,CAAC;YACtC,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAClC,MAAM,IAAI,CAAC,uBAAuB,EAAE,CAAC;QACvC,CAAC;QAED,oBAAoB;QACpB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ;YACzB,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC;YAC3C,CAAC,CAAC,OAAO,CAAC;QAEZ,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC5B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAEO,KAAK,CAAC,oBAAoB;QAChC,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAE3B,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC3B,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,4BAA4B;YAClC,OAAO,EAAE,OAAO;YAChB,YAAY,EAAE,CAAC,sBAAsB,EAAE,SAAS,CAAC;YACjD,YAAY,EAAE;gBACZ;oBACE,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,mBAAmB;oBACzB,OAAO,EAAE,OAAO;oBAChB,QAAQ,EAAE;wBACR,QAAQ,EAAE,CAAC,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,mBAAmB,CAAC;qBAC9E;iBACF;aACF;YACD,gBAAgB,EAAE,IAAI;YACtB,sBAAsB,EAAE;gBACtB;oBACE,OAAO,EAAE,sBAAsB;oBAC/B,OAAO,EAAE,uBAAuB;oBAChC,QAAQ,EAAE;wBACR,eAAe,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;qBACtC;iBACF;aACF;SACF,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,uBAAuB;QACnC,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAE3B,iCAAiC;QACjC,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,YAAY,EAAE,KAAK,EAAE,KAAoC,EAAE,EAAE;YACzF,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,yCAAyC;QACzC,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,iBAAiB,EAAE,KAAK,EAAE,KAAiC,EAAE,EAAE;YAC3F,MAAM,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,IAAyB;QAC7C,IAAI,CAAC;YACH,MAAM,UAAU,GAAoB;gBAClC,EAAE,EAAE,IAAI,CAAC,kBAAkB,EAAE;gBAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ,EAAE,IAAI,CAAC,QAAyB;gBACxC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,MAAM,EAAE,IAAI,IAAI,EAAE;gBAClB,aAAa,EAAE,8BAAmB,CAAC,IAAI;gBACvC,SAAS,EAAE,IAAI,IAAI,EAAE;aACtB,CAAC;YAEF,oBAAoB;YACpB,MAAM,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;YAEhD,8BAA8B;YAC9B,MAAM,KAAK,GAAe;gBACxB,EAAE,EAAE,IAAI,CAAC,eAAe,EAAE;gBAC1B,YAAY,EAAE,UAAU,CAAC,EAAE;gBAC3B,SAAS,EAAE,8BAAmB,CAAC,IAAI;gBACnC,SAAS,EAAE,UAAU,CAAC,MAAM;gBAC5B,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE;aACtC,CAAC;YACF,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAEvC,2BAA2B;YAC3B,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;gBAC/B,MAAM,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC,UAAU,CAAC,EAAE,EAAE,8BAAmB,CAAC,IAAI,CAAC,CAAC;YACtF,CAAC;YAED,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,qBAAqB,EAAE;gBACtC,UAAU,EAAE,UAAU,CAAC,EAAE;gBACzB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC,MAAM;aAC3B,CAAC,CAAC;YAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,6BAA6B,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7D,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAChE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,YAA8B;QACtD,IAAI,CAAC;YACH,yCAAyC;YACzC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YAEzF,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,wCAAwC,EAAE;oBAC1D,SAAS,EAAE,YAAY,CAAC,SAAS;oBACjC,SAAS,EAAE,YAAY,CAAC,SAAS;iBAClC,CAAC,CAAC;gBACH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;YAC5D,CAAC;YAED,qCAAqC;YACrC,MAAM,SAAS,GAAG,IAAA,0CAAmB,EAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YAE9D,eAAe;YACf,MAAM,KAAK,GAAe;gBACxB,EAAE,EAAE,IAAI,CAAC,eAAe,EAAE;gBAC1B,YAAY,EAAE,UAAU,CAAC,EAAE;gBAC3B,SAAS;gBACT,SAAS,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC;gBAC3C,QAAQ,EAAE,YAAY,CAAC,QAAQ;gBAC/B,WAAW,EAAE,YAAY;aAC1B,CAAC;YAEF,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAEvC,4BAA4B;YAC5B,MAAM,SAAS,GAAG,IAAA,yCAAkB,EAAC,UAAU,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;YAE1E,IAAI,SAAS,KAAK,UAAU,CAAC,aAAa,EAAE,CAAC;gBAC3C,MAAM,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;gBAErE,8BAA8B;gBAC9B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAClB,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;wBAC/B,IAAI,EAAE,sBAAsB;wBAC5B,IAAI,EAAE;4BACJ,UAAU,EAAE,UAAU,CAAC,EAAE;4BACzB,SAAS,EAAE,UAAU,CAAC,SAAS;4BAC/B,SAAS,EAAE,UAAU,CAAC,aAAa;4BACnC,SAAS,EAAE,SAAS;4BACpB,SAAS,EAAE,SAAS;4BACpB,SAAS,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;4BAC3B,SAAS,EAAE,KAAK,CAAC,SAAS;yBAC3B;qBACF,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,2BAA2B;YAC3B,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;gBAC/B,MAAM,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;YACvE,CAAC;YAED,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,yBAAyB,EAAE;gBAC1C,UAAU,EAAE,UAAU,CAAC,EAAE;gBACzB,SAAS,EAAE,SAAS;gBACpB,SAAS,EAAE,SAAS;aACrB,CAAC,CAAC;YAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,iCAAiC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAChE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,UAAkB;QAClC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;YACjE,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;YAC5D,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;YACrE,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAE5C,MAAM,QAAQ,GAAkB;gBAC9B,UAAU;gBACV,MAAM;gBACN,aAAa,EAAE,UAAU,CAAC,aAAa;gBACvC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM;aACjE,CAAC;YAEF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAChE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,YAAoB;QAC5C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAC;YACxE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAChE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,UAAkB;QACvC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC;YACrE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAChE,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,kBAAkB;QACxB,OAAO,SAAS,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAC1E,CAAC;IAEO,eAAe;QACrB,OAAO,SAAS,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAC1E,CAAC;IAEO,KAAK,CAAC,cAAc;QAC1B,mDAAmD;QACnD,6DAA6D;IAC/D,CAAC;IAED,gCAAgC;IAChC,KAAK,CAAC,aAAa;QACjB,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;CACF;AA7QD,sCA6QC"}

package/dist/config.d.ts

@@ -0,0 +1,3 @@
+import { TrackingConfig } from './types.js';
+export declare function loadConfig(userConfig?: TrackingConfig): Required<TrackingConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,wBAAgB,UAAU,CAAC,UAAU,GAAE,cAAmB,GAAG,QAAQ,CAAC,cAAc,CAAC,CAepF"}

package/dist/config.js

@@ -0,0 +1,27 @@
+"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.loadConfig = loadConfig;
+function loadConfig(userConfig = {}) {
+    return {
+        enableOpenTracking: userConfig.enableOpenTracking !== undefined
+            ? userConfig.enableOpenTracking
+            : (process.env.EMAIL_TRACKING_ENABLE_OPEN_TRACKING === 'true' || process.env.EMAIL_TRACKING_ENABLE_OPEN_TRACKING === undefined),
+        enableClickTracking: userConfig.enableClickTracking !== undefined
+            ? userConfig.enableClickTracking
+            : (process.env.EMAIL_TRACKING_ENABLE_CLICK_TRACKING === 'true' || process.env.EMAIL_TRACKING_ENABLE_CLICK_TRACKING === undefined),
+        eventRetentionDays: userConfig.eventRetentionDays !== undefined
+            ? userConfig.eventRetentionDays
+            : parseInt(process.env.EMAIL_TRACKING_EVENT_RETENTION_DAYS || '90', 10),
+        aggregateStats: userConfig.aggregateStats !== undefined
+            ? userConfig.aggregateStats
+            : (process.env.EMAIL_TRACKING_AGGREGATE_STATS === 'true' || process.env.EMAIL_TRACKING_AGGREGATE_STATS === undefined)
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;AAIF,gCAeC;AAfD,SAAgB,UAAU,CAAC,aAA6B,EAAE;IACxD,OAAO;QACL,kBAAkB,EAAE,UAAU,CAAC,kBAAkB,KAAK,SAAS;YAC7D,CAAC,CAAC,UAAU,CAAC,kBAAkB;YAC/B,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,mCAAmC,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,mCAAmC,KAAK,SAAS,CAAC;QACjI,mBAAmB,EAAE,UAAU,CAAC,mBAAmB,KAAK,SAAS;YAC/D,CAAC,CAAC,UAAU,CAAC,mBAAmB;YAChC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,oCAAoC,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,oCAAoC,KAAK,SAAS,CAAC;QACnI,kBAAkB,EAAE,UAAU,CAAC,kBAAkB,KAAK,SAAS;YAC7D,CAAC,CAAC,UAAU,CAAC,kBAAkB;YAC/B,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,mCAAmC,IAAI,IAAI,EAAE,EAAE,CAAC;QACzE,cAAc,EAAE,UAAU,CAAC,cAAc,KAAK,SAAS;YACrD,CAAC,CAAC,UAAU,CAAC,cAAc;YAC3B,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,8BAA8B,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,8BAA8B,KAAK,SAAS,CAAC;KACxH,CAAC;AACJ,CAAC"}