@bernierllc/email-tracking 1.0.0

package/dist/database.d.ts

@@ -0,0 +1,22 @@
+import { EmailSendRecord, EmailEvent, RecipientHistory, EmailDeliveryStatus, CampaignStatistics } from './types.js';
+/**
+ * In-memory database implementation for email tracking.
+ * In production, this would be replaced with a real database (PostgreSQL, etc.)
+ */
+export declare class Database {
+    private sendRecords;
+    private messageIdIndex;
+    private events;
+    private recipientHistory;
+    storeSendRecord(record: EmailSendRecord): Promise<void>;
+    getSendRecord(trackingId: string): Promise<EmailSendRecord | null>;
+    findSendRecordByMessageId(messageId: string): Promise<EmailSendRecord | null>;
+    updateSendRecordStatus(trackingId: string, status: EmailDeliveryStatus): Promise<void>;
+    createEvent(event: EmailEvent): Promise<void>;
+    getEventsBySendRecord(sendRecordId: string): Promise<EmailEvent[]>;
+    updateRecipientHistory(recipients: string[], eventType: EmailDeliveryStatus): Promise<void>;
+    fetchRecipientHistory(emailAddress: string): Promise<RecipientHistory>;
+    aggregateCampaignStats(campaignId: string): Promise<CampaignStatistics>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=database.d.ts.map

package/dist/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,WAAW,CAA2C;IAC9D,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,gBAAgB,CAA4C;IAE9D,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAIlE,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAM7E,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAStF,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAIlE,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwD3F,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoBtE,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoCvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B"}

package/dist/database.js

@@ -0,0 +1,156 @@
+"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.Database = void 0;
+const types_js_1 = require("./types.js");
+/**
+ * In-memory database implementation for email tracking.
+ * In production, this would be replaced with a real database (PostgreSQL, etc.)
+ */
+class Database {
+    constructor() {
+        this.sendRecords = new Map();
+        this.messageIdIndex = new Map(); // messageId -> trackingId
+        this.events = new Map(); // sendRecordId -> events[]
+        this.recipientHistory = new Map();
+    }
+    async storeSendRecord(record) {
+        this.sendRecords.set(record.id, record);
+        this.messageIdIndex.set(record.messageId, record.id);
+    }
+    async getSendRecord(trackingId) {
+        return this.sendRecords.get(trackingId) || null;
+    }
+    async findSendRecordByMessageId(messageId) {
+        const trackingId = this.messageIdIndex.get(messageId);
+        if (!trackingId)
+            return null;
+        return this.getSendRecord(trackingId);
+    }
+    async updateSendRecordStatus(trackingId, status) {
+        const record = this.sendRecords.get(trackingId);
+        if (record) {
+            record.currentStatus = status;
+            record.updatedAt = new Date();
+            this.sendRecords.set(trackingId, record);
+        }
+    }
+    async createEvent(event) {
+        const existingEvents = this.events.get(event.sendRecordId) || [];
+        existingEvents.push(event);
+        this.events.set(event.sendRecordId, existingEvents);
+    }
+    async getEventsBySendRecord(sendRecordId) {
+        return this.events.get(sendRecordId) || [];
+    }
+    async updateRecipientHistory(recipients, eventType) {
+        for (const recipient of recipients) {
+            let history = this.recipientHistory.get(recipient);
+            if (!history) {
+                history = {
+                    emailAddress: recipient,
+                    totalSent: 0,
+                    totalDelivered: 0,
+                    totalBounced: 0,
+                    totalOpened: 0,
+                    totalClicked: 0,
+                    totalComplained: 0,
+                    totalUnsubscribed: 0,
+                    reputationScore: 100
+                };
+            }
+            const now = new Date();
+            switch (eventType) {
+                case types_js_1.EmailDeliveryStatus.SENT:
+                    history.totalSent++;
+                    history.lastSentAt = now;
+                    break;
+                case types_js_1.EmailDeliveryStatus.DELIVERED:
+                    history.totalDelivered++;
+                    history.lastDeliveredAt = now;
+                    break;
+                case types_js_1.EmailDeliveryStatus.BOUNCED:
+                    history.totalBounced++;
+                    history.lastBouncedAt = now;
+                    history.reputationScore = Math.max(0, history.reputationScore - 10);
+                    break;
+                case types_js_1.EmailDeliveryStatus.OPENED:
+                    history.totalOpened++;
+                    history.lastOpenedAt = now;
+                    break;
+                case types_js_1.EmailDeliveryStatus.CLICKED:
+                    history.totalClicked++;
+                    history.lastClickedAt = now;
+                    break;
+                case types_js_1.EmailDeliveryStatus.COMPLAINED:
+                    history.totalComplained++;
+                    history.reputationScore = Math.max(0, history.reputationScore - 25);
+                    break;
+                case types_js_1.EmailDeliveryStatus.UNSUBSCRIBED:
+                    history.totalUnsubscribed++;
+                    history.reputationScore = Math.max(0, history.reputationScore - 5);
+                    break;
+            }
+            this.recipientHistory.set(recipient, history);
+        }
+    }
+    async fetchRecipientHistory(emailAddress) {
+        const history = this.recipientHistory.get(emailAddress);
+        if (!history) {
+            return {
+                emailAddress,
+                totalSent: 0,
+                totalDelivered: 0,
+                totalBounced: 0,
+                totalOpened: 0,
+                totalClicked: 0,
+                totalComplained: 0,
+                totalUnsubscribed: 0,
+                reputationScore: 100
+            };
+        }
+        return history;
+    }
+    async aggregateCampaignStats(campaignId) {
+        const campaignRecords = Array.from(this.sendRecords.values())
+            .filter(record => record.campaignId === campaignId);
+        const totalSent = campaignRecords.length;
+        const totalDelivered = campaignRecords.filter(r => [types_js_1.EmailDeliveryStatus.DELIVERED, types_js_1.EmailDeliveryStatus.OPENED, types_js_1.EmailDeliveryStatus.CLICKED]
+            .includes(r.currentStatus)).length;
+        const totalBounced = campaignRecords.filter(r => r.currentStatus === types_js_1.EmailDeliveryStatus.BOUNCED).length;
+        const totalOpened = campaignRecords.filter(r => [types_js_1.EmailDeliveryStatus.OPENED, types_js_1.EmailDeliveryStatus.CLICKED].includes(r.currentStatus)).length;
+        const totalClicked = campaignRecords.filter(r => r.currentStatus === types_js_1.EmailDeliveryStatus.CLICKED).length;
+        const totalComplained = campaignRecords.filter(r => r.currentStatus === types_js_1.EmailDeliveryStatus.COMPLAINED).length;
+        const totalUnsubscribed = campaignRecords.filter(r => r.currentStatus === types_js_1.EmailDeliveryStatus.UNSUBSCRIBED).length;
+        const deliveryRate = totalSent > 0 ? (totalDelivered / totalSent) * 100 : 0;
+        const openRate = totalDelivered > 0 ? (totalOpened / totalDelivered) * 100 : 0;
+        const clickRate = totalOpened > 0 ? (totalClicked / totalOpened) * 100 : 0;
+        return {
+            campaignId,
+            totalSent,
+            totalDelivered,
+            totalBounced,
+            totalOpened,
+            totalClicked,
+            totalComplained,
+            totalUnsubscribed,
+            deliveryRate: Math.round(deliveryRate * 100) / 100,
+            openRate: Math.round(openRate * 100) / 100,
+            clickRate: Math.round(clickRate * 100) / 100
+        };
+    }
+    async clear() {
+        this.sendRecords.clear();
+        this.messageIdIndex.clear();
+        this.events.clear();
+        this.recipientHistory.clear();
+    }
+}
+exports.Database = Database;
+//# sourceMappingURL=database.js.map

package/dist/database.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { EmailTracking } from './EmailTracking.js';
+export * from './types.js';
+export { calculateNewStatus, mapWebhookEventType } from './status-calculator.js';
+export { loadConfig } from './config.js';
+//# 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,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,33 @@
+"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.
+*/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = exports.mapWebhookEventType = exports.calculateNewStatus = exports.EmailTracking = void 0;
+var EmailTracking_js_1 = require("./EmailTracking.js");
+Object.defineProperty(exports, "EmailTracking", { enumerable: true, get: function () { return EmailTracking_js_1.EmailTracking; } });
+__exportStar(require("./types.js"), exports);
+var status_calculator_js_1 = require("./status-calculator.js");
+Object.defineProperty(exports, "calculateNewStatus", { enumerable: true, get: function () { return status_calculator_js_1.calculateNewStatus; } });
+Object.defineProperty(exports, "mapWebhookEventType", { enumerable: true, get: function () { return status_calculator_js_1.mapWebhookEventType; } });
+var config_js_1 = require("./config.js");
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_js_1.loadConfig; } });
+//# 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,uDAAmD;AAA1C,iHAAA,aAAa,OAAA;AACtB,6CAA2B;AAC3B,+DAAiF;AAAxE,0HAAA,kBAAkB,OAAA;AAAE,2HAAA,mBAAmB,OAAA;AAChD,yCAAyC;AAAhC,uGAAA,UAAU,OAAA"}

package/dist/status-calculator.d.ts

@@ -0,0 +1,4 @@
+import { EmailDeliveryStatus } from './types.js';
+export declare function calculateNewStatus(currentStatus: EmailDeliveryStatus, eventType: EmailDeliveryStatus): EmailDeliveryStatus;
+export declare function mapWebhookEventType(webhookEventType: string): EmailDeliveryStatus;
+//# sourceMappingURL=status-calculator.d.ts.map

package/dist/status-calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-calculator.d.ts","sourceRoot":"","sources":["../src/status-calculator.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAajD,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,mBAAmB,EAClC,SAAS,EAAE,mBAAmB,GAC7B,mBAAmB,CAIrB;AAED,wBAAgB,mBAAmB,CAAC,gBAAgB,EAAE,MAAM,GAAG,mBAAmB,CAYjF"}

package/dist/status-calculator.js

@@ -0,0 +1,40 @@
+"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.calculateNewStatus = calculateNewStatus;
+exports.mapWebhookEventType = mapWebhookEventType;
+const types_js_1 = require("./types.js");
+const STATUS_PRIORITY = {
+    [types_js_1.EmailDeliveryStatus.COMPLAINED]: 7,
+    [types_js_1.EmailDeliveryStatus.UNSUBSCRIBED]: 6,
+    [types_js_1.EmailDeliveryStatus.BOUNCED]: 5,
+    [types_js_1.EmailDeliveryStatus.FAILED]: 4,
+    [types_js_1.EmailDeliveryStatus.CLICKED]: 3,
+    [types_js_1.EmailDeliveryStatus.OPENED]: 2,
+    [types_js_1.EmailDeliveryStatus.DELIVERED]: 1,
+    [types_js_1.EmailDeliveryStatus.SENT]: 0
+};
+function calculateNewStatus(currentStatus, eventType) {
+    return STATUS_PRIORITY[eventType] > STATUS_PRIORITY[currentStatus]
+        ? eventType
+        : currentStatus;
+}
+function mapWebhookEventType(webhookEventType) {
+    const mapping = {
+        delivered: types_js_1.EmailDeliveryStatus.DELIVERED,
+        bounce: types_js_1.EmailDeliveryStatus.BOUNCED,
+        open: types_js_1.EmailDeliveryStatus.OPENED,
+        click: types_js_1.EmailDeliveryStatus.CLICKED,
+        spamreport: types_js_1.EmailDeliveryStatus.COMPLAINED,
+        unsubscribe: types_js_1.EmailDeliveryStatus.UNSUBSCRIBED,
+        failed: types_js_1.EmailDeliveryStatus.FAILED
+    };
+    return mapping[webhookEventType.toLowerCase()] || types_js_1.EmailDeliveryStatus.SENT;
+}
+//# sourceMappingURL=status-calculator.js.map

package/dist/status-calculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-calculator.js","sourceRoot":"","sources":["../src/status-calculator.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;AAeF,gDAOC;AAED,kDAYC;AAlCD,yCAAiD;AAEjD,MAAM,eAAe,GAAwC;IAC3D,CAAC,8BAAmB,CAAC,UAAU,CAAC,EAAE,CAAC;IACnC,CAAC,8BAAmB,CAAC,YAAY,CAAC,EAAE,CAAC;IACrC,CAAC,8BAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;IAChC,CAAC,8BAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;IAC/B,CAAC,8BAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;IAChC,CAAC,8BAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;IAC/B,CAAC,8BAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;IAClC,CAAC,8BAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;CAC9B,CAAC;AAEF,SAAgB,kBAAkB,CAChC,aAAkC,EAClC,SAA8B;IAE9B,OAAO,eAAe,CAAC,SAAS,CAAC,GAAG,eAAe,CAAC,aAAa,CAAC;QAChE,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,aAAa,CAAC;AACpB,CAAC;AAED,SAAgB,mBAAmB,CAAC,gBAAwB;IAC1D,MAAM,OAAO,GAAwC;QACnD,SAAS,EAAE,8BAAmB,CAAC,SAAS;QACxC,MAAM,EAAE,8BAAmB,CAAC,OAAO;QACnC,IAAI,EAAE,8BAAmB,CAAC,MAAM;QAChC,KAAK,EAAE,8BAAmB,CAAC,OAAO;QAClC,UAAU,EAAE,8BAAmB,CAAC,UAAU;QAC1C,WAAW,EAAE,8BAAmB,CAAC,YAAY;QAC7C,MAAM,EAAE,8BAAmB,CAAC,MAAM;KACnC,CAAC;IAEF,OAAO,OAAO,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC,IAAI,8BAAmB,CAAC,IAAI,CAAC;AAC7E,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,98 @@
+export declare enum EmailDeliveryStatus {
+    SENT = "sent",
+    DELIVERED = "delivered",
+    BOUNCED = "bounced",
+    OPENED = "opened",
+    CLICKED = "clicked",
+    COMPLAINED = "complained",
+    UNSUBSCRIBED = "unsubscribed",
+    FAILED = "failed"
+}
+export type EmailProvider = 'sendgrid' | 'mailgun' | 'ses' | 'postmark';
+export interface EmailSendRecord {
+    id: string;
+    messageId: string;
+    provider: EmailProvider;
+    from: string;
+    to: string[];
+    cc?: string[];
+    bcc?: string[];
+    subject: string;
+    campaignId?: string;
+    metadata?: Record<string, unknown>;
+    sentAt: Date;
+    currentStatus: EmailDeliveryStatus;
+    updatedAt: Date;
+}
+export interface EmailEvent {
+    id: string;
+    sendRecordId: string;
+    eventType: EmailDeliveryStatus;
+    timestamp: Date;
+    metadata?: Record<string, unknown>;
+    sourceEvent?: unknown;
+}
+export interface EmailTimeline {
+    sendRecord: EmailSendRecord;
+    events: EmailEvent[];
+    currentStatus: EmailDeliveryStatus;
+    lastEventAt: Date;
+}
+export interface RecipientHistory {
+    emailAddress: string;
+    totalSent: number;
+    totalDelivered: number;
+    totalBounced: number;
+    totalOpened: number;
+    totalClicked: number;
+    totalComplained: number;
+    totalUnsubscribed: number;
+    lastSentAt?: Date;
+    lastDeliveredAt?: Date;
+    lastBouncedAt?: Date;
+    lastOpenedAt?: Date;
+    lastClickedAt?: Date;
+    reputationScore: number;
+}
+export interface TrackingConfig {
+    enableOpenTracking?: boolean;
+    enableClickTracking?: boolean;
+    eventRetentionDays?: number;
+    aggregateStats?: boolean;
+}
+export interface EmailTrackingResult<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: string;
+}
+export interface RecordEmailSentData {
+    messageId: string;
+    provider: string;
+    from: string;
+    to: string[];
+    cc?: string[];
+    bcc?: string[];
+    subject: string;
+    campaignId?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface WebhookEventData {
+    messageId: string;
+    eventType: string;
+    timestamp: string | Date;
+    metadata?: Record<string, unknown>;
+}
+export interface CampaignStatistics {
+    campaignId: string;
+    totalSent: number;
+    totalDelivered: number;
+    totalBounced: number;
+    totalOpened: number;
+    totalClicked: number;
+    totalComplained: number;
+    totalUnsubscribed: number;
+    deliveryRate: number;
+    openRate: number;
+    clickRate: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,22 @@
+"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.EmailDeliveryStatus = void 0;
+var EmailDeliveryStatus;
+(function (EmailDeliveryStatus) {
+    EmailDeliveryStatus["SENT"] = "sent";
+    EmailDeliveryStatus["DELIVERED"] = "delivered";
+    EmailDeliveryStatus["BOUNCED"] = "bounced";
+    EmailDeliveryStatus["OPENED"] = "opened";
+    EmailDeliveryStatus["CLICKED"] = "clicked";
+    EmailDeliveryStatus["COMPLAINED"] = "complained";
+    EmailDeliveryStatus["UNSUBSCRIBED"] = "unsubscribed";
+    EmailDeliveryStatus["FAILED"] = "failed";
+})(EmailDeliveryStatus || (exports.EmailDeliveryStatus = EmailDeliveryStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;AAEF,IAAY,mBASX;AATD,WAAY,mBAAmB;IAC7B,oCAAa,CAAA;IACb,8CAAuB,CAAA;IACvB,0CAAmB,CAAA;IACnB,wCAAiB,CAAA;IACjB,0CAAmB,CAAA;IACnB,gDAAyB,CAAA;IACzB,oDAA6B,CAAA;IAC7B,wCAAiB,CAAA;AACnB,CAAC,EATW,mBAAmB,mCAAnB,mBAAmB,QAS9B"}

package/jest.config.cjs

@@ -0,0 +1,32 @@
+/*
+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.
+*/
+
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: '<rootDir>/../../../jest-environment-node-fixed.cjs',
+  collectCoverageFrom: [
+    'src/**/*.{ts,tsx}',
+    '!src/**/*.d.ts',
+    '!src/index.ts'
+  ],
+  coverageThreshold: {
+    global: {
+      branches: 74,
+      functions: 85,
+      lines: 85,
+      statements: 85
+    }
+  },
+  testMatch: [
+    '**/__tests__/**/*.test.ts'
+  ],
+  moduleNameMapper: {
+    '^(\\.{1,2}/.*)\\.js$': '$1',
+    '@bernierllc/neverhub-adapter': '<rootDir>/__mocks__/neverhub-adapter.ts'
+  }
+};

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@bernierllc/email-tracking",
+  "version": "1.0.0",
+  "description": "Email delivery tracking service that monitors email lifecycle from send to delivery/bounce/open/click",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "keywords": [
+    "email",
+    "tracking",
+    "delivery",
+    "analytics",
+    "events",
+    "webhooks",
+    "sendgrid",
+    "mailgun",
+    "ses",
+    "postmark"
+  ],
+  "author": "Bernier LLC",
+  "license": "SEE LICENSE IN LICENSE",
+  "dependencies": {
+    "@bernierllc/email-webhook-events": "^1.0.0",
+    "@bernierllc/logger": "^1.2.0",
+    "@bernierllc/neverhub-adapter": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.0.0",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "jest": "^29.0.0",
+    "ts-jest": "^29.0.0",
+    "typescript": "^5.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bernierllc": {
+    "integration": {
+      "neverhub": "required",
+      "neveradmin": "not-applicable",
+      "logger": "integrated"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "jest --watch",
+    "test:run": "jest",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src --ext .ts",
+    "clean": "rm -rf dist"
+  }
+}