@bernierllc/email-webhook-events 1.2.0 → 1.3.1

package/.eslintrc.cjs

@@ -1,29 +1,30 @@
-/*
-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 = {
   parser: '@typescript-eslint/parser',
+  plugins: ['@typescript-eslint'],
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended'
+  ],
   parserOptions: {
     ecmaVersion: 2020,
     sourceType: 'module',
     project: './tsconfig.json',
+    tsconfigRootDir: __dirname
+  },
+  env: {
+    node: true,
+    es6: true,
+    jest: true
   },
-  plugins: ['@typescript-eslint'],
-  extends: [
-    'eslint:recommended',
-    'plugin:@typescript-eslint/recommended',
-    'plugin:@typescript-eslint/recommended-requiring-type-checking',
-  ],
   rules: {
-    '@typescript-eslint/explicit-function-return-type': 'warn',
-    '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
-    '@typescript-eslint/no-explicit-any': 'error',
-    '@typescript-eslint/strict-boolean-expressions': 'off',
+    '@typescript-eslint/no-explicit-any': 'off',
+    '@typescript-eslint/no-unused-vars': ['error', {
+      argsIgnorePattern: '^_',
+      varsIgnorePattern: '^_',
+      caughtErrorsIgnorePattern: '^_'
+    }],
+    'no-unused-vars': 'off',
+    'no-console': 'off'
   },
-  ignorePatterns: ['dist/', 'node_modules/', '*.cjs'],
+  ignorePatterns: ['dist/', 'node_modules/', '*.js', '*.cjs', 'coverage/']
 };

package/CHANGELOG.md

@@ -3,6 +3,28 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.3.1](https://github.com/bernierllc/tools/compare/@bernierllc/email-webhook-events@1.3.0...@bernierllc/email-webhook-events@1.3.1) (2026-03-09)
+
+
+### Bug Fixes
+
+* **email:** sync provider type unions across email packages ([b515e54](https://github.com/bernierllc/tools/commit/b515e5456da4ce6fd6067d20e4da010d658e3a2b))
+
+
+
+
+
+# [1.3.0](https://github.com/bernierllc/tools/compare/@bernierllc/email-webhook-events@1.2.0...@bernierllc/email-webhook-events@1.3.0) (2026-03-03)
+
+
+### Features
+
+* **email:** add multi-provider capability matrix with smart routing ([#29](https://github.com/bernierllc/tools/issues/29)) ([b9c38c0](https://github.com/bernierllc/tools/commit/b9c38c0a93985dc1675681657cc2ec3a209a9435))
+
+
+
+
+
 # 1.2.0 (2025-12-25)
 
 

package/README.md

@@ -363,6 +363,72 @@ and used to generate accurate mocks for unit tests.
 
 See `__tests__/fixtures/sendgrid-webhooks/README.md` for more details.
 
+## Provider Capability Support
+
+This section documents how webhook event processing behaves across email providers, based on the canonical `CAPABILITY_MATRIX` in `@bernierllc/email-manager`.
+
+### Capability Levels by Provider
+
+| Provider | `webhooksReceive` | `webhookNormalization` | Notes |
+|----------|------------------|----------------------|-------|
+| SendGrid | **provider** | **enhanced** | Native Event Webhook with platform normalization |
+| Mailgun | **provider** | **enhanced** | Native webhooks with platform normalization |
+| Postmark | **provider** | **enhanced** | Native webhooks for delivery, bounce, and spam events |
+| SES | **provider** | **enhanced** | Event notifications via SNS (requires SNS topic configuration) |
+| SMTP | **unsupported** | **unsupported** | SMTP does not provide webhook callbacks |
+
+### How It Works
+
+- **Provider-level webhooks** (SendGrid, Mailgun, Postmark, SES): The email provider pushes event data (delivered, opened, clicked, bounced, etc.) to your configured webhook endpoint. This package receives those raw payloads, validates signatures, and passes them to the normalizer.
+
+- **Enhanced normalization** (SendGrid, Mailgun, Postmark, SES): Each provider sends events in its own format. This package normalizes all provider-specific payloads into a unified `EmailEvent` format with consistent event types, timestamps, and metadata. Provider-specific details are preserved in the normalized event's metadata.
+
+- **Unsupported** (SMTP): Plain SMTP does not provide any webhook or event callback mechanism. No delivery tracking, open tracking, or bounce notifications are available through SMTP alone.
+
+### Degradation Behavior
+
+When used with an unsupported provider (SMTP):
+
+- **Strategy**: No automatic fallback -- SMTP simply does not emit events
+- **Impact**: No delivery tracking, no bounce notifications, no open/click tracking
+- **Workaround**: SMTP users who need event tracking should either:
+  1. Use a provider that supports webhooks (SendGrid, Mailgun, Postmark, SES)
+  2. Set up an external webhook relay service that monitors the SMTP server's logs
+  3. Implement polling-based delivery verification using DSN (Delivery Status Notifications) if the SMTP server supports it
+
+### Override Options
+
+The webhook receive capability is marked `overridable: true` for all providers with native support. This allows you to:
+
+- Replace the built-in normalizer for a specific provider with a custom implementation
+- Add custom event types beyond the standard normalized set
+- Route raw (unnormalized) events to a separate processing pipeline
+
+```typescript
+const service = new EmailWebhookEventsService({
+  providers: [
+    {
+      provider: EmailProvider.SENDGRID,
+      enabled: true,
+      webhookUrl: '/webhooks/sendgrid',
+      secretKey: process.env.SENDGRID_WEBHOOK_SECRET!,
+      // Custom normalizer override
+      normalizer: myCustomSendGridNormalizer,
+    },
+  ],
+});
+```
+
+### SES-Specific Notes
+
+SES webhook support requires additional infrastructure setup:
+
+- An SNS topic must be configured to receive SES event notifications
+- An SNS subscription (HTTPS or Lambda) must forward events to this package's webhook endpoint
+- SES configuration sets must be created to route events to the SNS topic
+
+This is reflected in the capability matrix as a limitation: `"Requires SNS topic configuration"`.
+
 ## Integration Status
 
 - **Logger**: integrated - Uses MockLogger (pending @bernierllc/logger publication)

package/__tests__/EmailWebhookEventsService.test.ts

@@ -147,9 +147,11 @@ describe('EmailWebhookEventsService', () => {
         }
       }));
 
+      const rangeStart = new Date(Date.now() - 24 * 60 * 60 * 1000);
+      const rangeEnd = new Date(Date.now() + 24 * 60 * 60 * 1000);
       const analytics = await service.getAnalytics(
-        new Date('2025-01-01'),
-        new Date('2025-12-31')
+        rangeStart,
+        rangeEnd
       );
 
       expect(analytics.totalDelivered).toBe(2);
@@ -164,9 +166,11 @@ describe('EmailWebhookEventsService', () => {
         provider: EmailProvider.SENDGRID
       }));
 
+      const rangeStart = new Date(Date.now() - 24 * 60 * 60 * 1000);
+      const rangeEnd = new Date(Date.now() + 24 * 60 * 60 * 1000);
       const analytics = await service.getAnalytics(
-        new Date('2025-01-01'),
-        new Date('2025-12-31'),
+        rangeStart,
+        rangeEnd,
         { provider: EmailProvider.SENDGRID }
       );
 

package/__tests__/WebhookEventCallbacks.test.ts

@@ -0,0 +1,343 @@
+/*
+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.
+*/
+
+import { EmailWebhookEventsService } from '../src/EmailWebhookEventsService';
+import {
+  EmailEventType,
+  EmailProvider,
+  WebhookPayload,
+  EmailEvent,
+  WebhookEventCallbacks,
+  EmailWebhookEventsConfig
+} from '../src/types';
+
+describe('WebhookEventCallbacks', () => {
+  const createWebhook = (eventType: string, overrides: Partial<WebhookPayload> = {}): WebhookPayload => ({
+    provider: EmailProvider.SENDGRID,
+    signature: 'test-signature',
+    payload: {
+      event: eventType,
+      email: 'user@example.com',
+      timestamp: Math.floor(Date.now() / 1000),
+      sg_message_id: 'msg-123',
+      email_id: 'email-456'
+    },
+    headers: {},
+    ...overrides
+  });
+
+  const createService = async (callbacks: WebhookEventCallbacks): Promise<EmailWebhookEventsService> => {
+    const config: EmailWebhookEventsConfig = {
+      providers: [{
+        provider: EmailProvider.SENDGRID,
+        enabled: true,
+        webhookUrl: '/webhooks/sendgrid',
+        secretKey: 'test-secret',
+        signatureHeader: 'X-Twilio-Email-Event-Webhook-Signature',
+        signatureAlgorithm: 'sha256'
+      }],
+      persistence: {
+        enabled: true,
+        adapter: 'memory'
+      },
+      analytics: {
+        realTimeEnabled: true,
+        aggregationInterval: 5000,
+        retentionDays: 90
+      },
+      callbacks
+    };
+
+    const service = new EmailWebhookEventsService(config);
+    await service.initialize();
+    return service;
+  };
+
+  it('should invoke onBounce callback for bounce events', async () => {
+    const onBounce = jest.fn();
+    const service = await createService({ onBounce });
+
+    const webhook = createWebhook('bounce', {
+      payload: {
+        event: 'bounce',
+        email: 'user@example.com',
+        timestamp: Math.floor(Date.now() / 1000),
+        sg_message_id: 'msg-123',
+        status: '5.1.1',
+        reason: 'User unknown'
+      }
+    });
+
+    const result = await service.processWebhook(webhook);
+
+    expect(result.success).toBe(true);
+    expect(onBounce).toHaveBeenCalledTimes(1);
+    expect(onBounce).toHaveBeenCalledWith(
+      expect.objectContaining({
+        type: EmailEventType.BOUNCED,
+        recipient: 'user@example.com'
+      })
+    );
+  });
+
+  it('should invoke onComplaint callback for complaint events', async () => {
+    const onComplaint = jest.fn();
+    const service = await createService({ onComplaint });
+
+    const webhook = createWebhook('spamreport', {
+      payload: {
+        event: 'spamreport',
+        email: 'user@example.com',
+        timestamp: Math.floor(Date.now() / 1000),
+        sg_message_id: 'msg-123'
+      }
+    });
+
+    const result = await service.processWebhook(webhook);
+
+    expect(result.success).toBe(true);
+    expect(onComplaint).toHaveBeenCalledTimes(1);
+    expect(onComplaint).toHaveBeenCalledWith(
+      expect.objectContaining({
+        type: EmailEventType.COMPLAINED,
+        recipient: 'user@example.com'
+      })
+    );
+  });
+
+  it('should invoke onUnsubscribe callback for unsubscribe events', async () => {
+    const onUnsubscribe = jest.fn();
+    const service = await createService({ onUnsubscribe });
+
+    const webhook = createWebhook('unsubscribe', {
+      payload: {
+        event: 'unsubscribe',
+        email: 'user@example.com',
+        timestamp: Math.floor(Date.now() / 1000),
+        sg_message_id: 'msg-123'
+      }
+    });
+
+    const result = await service.processWebhook(webhook);
+
+    expect(result.success).toBe(true);
+    expect(onUnsubscribe).toHaveBeenCalledTimes(1);
+    expect(onUnsubscribe).toHaveBeenCalledWith(
+      expect.objectContaining({
+        type: EmailEventType.UNSUBSCRIBED,
+        recipient: 'user@example.com'
+      })
+    );
+  });
+
+  it('should invoke onDelivery callback for delivery events', async () => {
+    const onDelivery = jest.fn();
+    const service = await createService({ onDelivery });
+
+    const webhook = createWebhook('delivered');
+    const result = await service.processWebhook(webhook);
+
+    expect(result.success).toBe(true);
+    expect(onDelivery).toHaveBeenCalledTimes(1);
+    expect(onDelivery).toHaveBeenCalledWith(
+      expect.objectContaining({
+        type: EmailEventType.DELIVERED,
+        recipient: 'user@example.com'
+      })
+    );
+  });
+
+  it('should invoke onOpen callback for open events', async () => {
+    const onOpen = jest.fn();
+    const service = await createService({ onOpen });
+
+    const webhook = createWebhook('open');
+    const result = await service.processWebhook(webhook);
+
+    expect(result.success).toBe(true);
+    expect(onOpen).toHaveBeenCalledTimes(1);
+    expect(onOpen).toHaveBeenCalledWith(
+      expect.objectContaining({
+        type: EmailEventType.OPENED
+      })
+    );
+  });
+
+  it('should invoke onClick callback for click events', async () => {
+    const onClick = jest.fn();
+    const service = await createService({ onClick });
+
+    const webhook = createWebhook('click', {
+      payload: {
+        event: 'click',
+        email: 'user@example.com',
+        timestamp: Math.floor(Date.now() / 1000),
+        sg_message_id: 'msg-123',
+        url: 'https://example.com/link'
+      }
+    });
+
+    const result = await service.processWebhook(webhook);
+
+    expect(result.success).toBe(true);
+    expect(onClick).toHaveBeenCalledTimes(1);
+    expect(onClick).toHaveBeenCalledWith(
+      expect.objectContaining({
+        type: EmailEventType.CLICKED,
+        metadata: expect.objectContaining({
+          url: 'https://example.com/link'
+        })
+      })
+    );
+  });
+
+  it('should invoke onFailure callback for failed events', async () => {
+    const onFailure = jest.fn();
+    const service = await createService({ onFailure });
+
+    // An unmapped SendGrid event type falls through to EmailEventType.FAILED
+    const webhook = createWebhook('unknown_failure_event', {
+      payload: {
+        event: 'unknown_failure_event',
+        email: 'user@example.com',
+        timestamp: Math.floor(Date.now() / 1000),
+        sg_message_id: 'msg-123',
+        reason: 'Invalid email'
+      }
+    });
+
+    const result = await service.processWebhook(webhook);
+
+    expect(result.success).toBe(true);
+    expect(onFailure).toHaveBeenCalledTimes(1);
+    expect(onFailure).toHaveBeenCalledWith(
+      expect.objectContaining({
+        type: EmailEventType.FAILED
+      })
+    );
+  });
+
+  it('should not fail webhook processing if callback throws', async () => {
+    const onDelivery = jest.fn().mockRejectedValue(new Error('Callback exploded'));
+    const service = await createService({ onDelivery });
+
+    const webhook = createWebhook('delivered');
+    const result = await service.processWebhook(webhook);
+
+    expect(result.success).toBe(true);
+    expect(result.event).toBeDefined();
+    expect(onDelivery).toHaveBeenCalledTimes(1);
+  });
+
+  it('should not fail webhook processing if sync callback throws', async () => {
+    const onDelivery = jest.fn().mockImplementation(() => {
+      throw new Error('Sync callback exploded');
+    });
+    const service = await createService({ onDelivery });
+
+    const webhook = createWebhook('delivered');
+    const result = await service.processWebhook(webhook);
+
+    expect(result.success).toBe(true);
+    expect(result.event).toBeDefined();
+    expect(onDelivery).toHaveBeenCalledTimes(1);
+  });
+
+  it('should handle async callbacks', async () => {
+    let resolvedValue: string | undefined;
+    const onDelivery = jest.fn().mockImplementation(async (event: EmailEvent) => {
+      await new Promise(resolve => setTimeout(resolve, 10));
+      resolvedValue = event.recipient;
+    });
+    const service = await createService({ onDelivery });
+
+    const webhook = createWebhook('delivered');
+    const result = await service.processWebhook(webhook);
+
+    expect(result.success).toBe(true);
+    expect(onDelivery).toHaveBeenCalledTimes(1);
+    expect(resolvedValue).toBe('user@example.com');
+  });
+
+  it('should work when no callbacks configured', async () => {
+    const config: EmailWebhookEventsConfig = {
+      providers: [{
+        provider: EmailProvider.SENDGRID,
+        enabled: true,
+        webhookUrl: '/webhooks/sendgrid',
+        secretKey: 'test-secret',
+        signatureHeader: 'X-Twilio-Email-Event-Webhook-Signature',
+        signatureAlgorithm: 'sha256'
+      }],
+      persistence: {
+        enabled: true,
+        adapter: 'memory'
+      },
+      analytics: {
+        realTimeEnabled: true,
+        aggregationInterval: 5000,
+        retentionDays: 90
+      }
+      // No callbacks property
+    };
+
+    const service = new EmailWebhookEventsService(config);
+    await service.initialize();
+
+    const webhook = createWebhook('delivered');
+    const result = await service.processWebhook(webhook);
+
+    expect(result.success).toBe(true);
+    expect(result.event).toBeDefined();
+  });
+
+  it('should work with empty callbacks object', async () => {
+    const service = await createService({});
+
+    const webhook = createWebhook('delivered');
+    const result = await service.processWebhook(webhook);
+
+    expect(result.success).toBe(true);
+    expect(result.event).toBeDefined();
+  });
+
+  it('should invoke multiple different callbacks for different events', async () => {
+    const onDelivery = jest.fn();
+    const onBounce = jest.fn();
+    const onOpen = jest.fn();
+    const service = await createService({ onDelivery, onBounce, onOpen });
+
+    await service.processWebhook(createWebhook('delivered'));
+    await service.processWebhook(createWebhook('bounce', {
+      payload: {
+        event: 'bounce',
+        email: 'user@example.com',
+        timestamp: Math.floor(Date.now() / 1000),
+        sg_message_id: 'msg-123',
+        status: '5.1.1',
+        reason: 'Unknown user'
+      }
+    }));
+    await service.processWebhook(createWebhook('open'));
+
+    expect(onDelivery).toHaveBeenCalledTimes(1);
+    expect(onBounce).toHaveBeenCalledTimes(1);
+    expect(onOpen).toHaveBeenCalledTimes(1);
+  });
+
+  it('should not invoke unrelated callbacks', async () => {
+    const onBounce = jest.fn();
+    const onComplaint = jest.fn();
+    const service = await createService({ onBounce, onComplaint });
+
+    await service.processWebhook(createWebhook('delivered'));
+
+    expect(onBounce).not.toHaveBeenCalled();
+    expect(onComplaint).not.toHaveBeenCalled();
+  });
+});

package/__tests__/analytics/AnalyticsEngine.test.ts

@@ -11,6 +11,8 @@ import { EmailEvent, EmailEventType, EmailProvider } from '../../src/types';
 
 describe('AnalyticsEngine', () => {
   let engine: AnalyticsEngine;
+  let rangeStart: Date;
+  let rangeEnd: Date;
 
   beforeEach(() => {
     engine = new AnalyticsEngine({
@@ -18,6 +20,10 @@ describe('AnalyticsEngine', () => {
       aggregationInterval: 5000,
       retentionDays: 90
     });
+
+    // Use dynamic date range that always encompasses "now"
+    rangeStart = new Date(Date.now() - 24 * 60 * 60 * 1000); // 1 day ago
+    rangeEnd = new Date(Date.now() + 24 * 60 * 60 * 1000);   // 1 day from now
   });
 
   const createEvent = (type: EmailEventType, overrides: Partial<EmailEvent> = {}): EmailEvent => ({
@@ -37,8 +43,8 @@ describe('AnalyticsEngine', () => {
     await engine.recordEvent(event);
 
     const analytics = await engine.getAnalytics(
-      new Date('2025-01-01'),
-      new Date('2025-12-31')
+      rangeStart,
+      rangeEnd
     );
 
     expect(analytics.totalDelivered).toBe(1);
@@ -50,8 +56,8 @@ describe('AnalyticsEngine', () => {
     await engine.recordEvent(createEvent(EmailEventType.BOUNCED));
 
     const analytics = await engine.getAnalytics(
-      new Date('2025-01-01'),
-      new Date('2025-12-31')
+      rangeStart,
+      rangeEnd
     );
 
     expect(analytics.totalSent).toBe(3);
@@ -65,8 +71,8 @@ describe('AnalyticsEngine', () => {
     await engine.recordEvent(createEvent(EmailEventType.OPENED));
 
     const analytics = await engine.getAnalytics(
-      new Date('2025-01-01'),
-      new Date('2025-12-31')
+      rangeStart,
+      rangeEnd
     );
 
     expect(analytics.totalDelivered).toBe(2);
@@ -80,8 +86,8 @@ describe('AnalyticsEngine', () => {
     await engine.recordEvent(createEvent(EmailEventType.CLICKED));
 
     const analytics = await engine.getAnalytics(
-      new Date('2025-01-01'),
-      new Date('2025-12-31')
+      rangeStart,
+      rangeEnd
     );
 
     expect(analytics.totalOpened).toBe(2);
@@ -91,8 +97,8 @@ describe('AnalyticsEngine', () => {
 
   it('should handle zero denominators gracefully', async () => {
     const analytics = await engine.getAnalytics(
-      new Date('2025-01-01'),
-      new Date('2025-12-31')
+      rangeStart,
+      rangeEnd
     );
 
     expect(analytics.deliveryRate).toBe(0);
@@ -105,8 +111,8 @@ describe('AnalyticsEngine', () => {
     await engine.recordEvent(createEvent(EmailEventType.BOUNCED));
 
     const analytics = await engine.getAnalytics(
-      new Date('2025-01-01'),
-      new Date('2025-12-31')
+      rangeStart,
+      rangeEnd
     );
 
     expect(analytics.bounceRate).toBe(0.5);
@@ -117,8 +123,8 @@ describe('AnalyticsEngine', () => {
     await engine.recordEvent(createEvent(EmailEventType.DELIVERED, { provider: EmailProvider.MAILGUN }));
 
     const analytics = await engine.getAnalytics(
-      new Date('2025-01-01'),
-      new Date('2025-12-31')
+      rangeStart,
+      rangeEnd
     );
 
     expect(analytics.byProvider[EmailProvider.SENDGRID].delivered).toBe(1);
@@ -131,8 +137,8 @@ describe('AnalyticsEngine', () => {
     await engine.recordEvent(createEvent(EmailEventType.CLICKED));
 
     const analytics = await engine.getAnalytics(
-      new Date('2025-01-01'),
-      new Date('2025-12-31')
+      rangeStart,
+      rangeEnd
     );
 
     expect(analytics.byEventType[EmailEventType.DELIVERED]).toBe(1);
@@ -153,8 +159,8 @@ describe('AnalyticsEngine', () => {
     );
 
     const analytics = await engine.getAnalytics(
-      new Date('2025-01-01'),
-      new Date('2025-12-31')
+      rangeStart,
+      rangeEnd
     );
 
     expect(analytics.byBounceType).toBeDefined();
@@ -183,8 +189,8 @@ describe('AnalyticsEngine', () => {
     );
 
     const analytics = await engine.getAnalytics(
-      new Date('2025-01-01'),
-      new Date('2025-12-31')
+      rangeStart,
+      rangeEnd
     );
 
     expect(analytics.topLinks).toBeDefined();
@@ -206,8 +212,8 @@ describe('AnalyticsEngine', () => {
     );
 
     const analytics = await engine.getAnalytics(
-      new Date('2025-01-01'),
-      new Date('2025-12-31')
+      rangeStart,
+      rangeEnd
     );
 
     expect(analytics.byDevice).toBeDefined();
@@ -220,8 +226,8 @@ describe('AnalyticsEngine', () => {
     await engine.recordEvent(createEvent(EmailEventType.DELIVERED, { provider: EmailProvider.MAILGUN }));
 
     const analytics = await engine.getAnalytics(
-      new Date('2025-01-01'),
-      new Date('2025-12-31'),
+      rangeStart,
+      rangeEnd,
       { provider: EmailProvider.SENDGRID }
     );
 
@@ -233,8 +239,8 @@ describe('AnalyticsEngine', () => {
     await engine.recordEvent(createEvent(EmailEventType.OPENED));
 
     const analytics = await engine.getAnalytics(
-      new Date('2025-01-01'),
-      new Date('2025-12-31'),
+      rangeStart,
+      rangeEnd,
       { eventTypes: [EmailEventType.DELIVERED] }
     );
 

package/dist/EmailWebhookEventsService.d.ts

@@ -45,6 +45,10 @@ export declare class EmailWebhookEventsService {
      * Send notification via channel
      */
     private sendNotification;
+    /**
+     * Invoke registered event callbacks
+     */
+    private invokeCallbacks;
     /**
      * Create persistence adapter
      */

package/dist/EmailWebhookEventsService.d.ts.map

@@ -1 +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"}
+{"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;IAkD1E;;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,eAAe;IAqC7B;;OAEG;YACW,wBAAwB;CAWvC"}

package/dist/EmailWebhookEventsService.js

@@ -64,6 +64,8 @@ class EmailWebhookEventsService {
             }
             // Update analytics
             await this.analyticsEngine.recordEvent(normalizedEvent);
+            // Invoke event callbacks
+            await this.invokeCallbacks(normalizedEvent);
             // Publish critical events
             if (this.isCriticalEvent(normalizedEvent)) {
                 await this.publishCriticalEvent(normalizedEvent);
@@ -180,6 +182,46 @@ class EmailWebhookEventsService {
             recipient: event.recipient
         });
     }
+    /**
+     * Invoke registered event callbacks
+     */
+    async invokeCallbacks(event) {
+        const callbacks = this.config.callbacks;
+        if (!callbacks)
+            return;
+        try {
+            switch (event.type) {
+                case types_1.EmailEventType.BOUNCED:
+                    await callbacks.onBounce?.(event);
+                    break;
+                case types_1.EmailEventType.COMPLAINED:
+                    await callbacks.onComplaint?.(event);
+                    break;
+                case types_1.EmailEventType.UNSUBSCRIBED:
+                    await callbacks.onUnsubscribe?.(event);
+                    break;
+                case types_1.EmailEventType.DELIVERED:
+                    await callbacks.onDelivery?.(event);
+                    break;
+                case types_1.EmailEventType.OPENED:
+                    await callbacks.onOpen?.(event);
+                    break;
+                case types_1.EmailEventType.CLICKED:
+                    await callbacks.onClick?.(event);
+                    break;
+                case types_1.EmailEventType.FAILED:
+                    await callbacks.onFailure?.(event);
+                    break;
+            }
+        }
+        catch (error) {
+            this.logger.error('Event callback failed', {
+                eventType: event.type,
+                eventId: event.id,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            });
+        }
+    }
     /**
      * Create persistence adapter
      */

package/dist/EmailWebhookEventsService.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { EmailWebhookEventsService } from './EmailWebhookEventsService';
-export { EmailEvent, EmailEventType, EmailProvider, EmailEventMetadata, EmailAnalytics, ProviderAnalytics, EmailWebhookEventsConfig, ProviderWebhookConfig, NotificationChannel, EmailWebhookResult, WebhookPayload, AnalyticsFilters, EventQuery, EmailWebhookError, EmailWebhookErrorCode } from './types';
+export { EmailEvent, EmailEventType, EmailProvider, EmailEventMetadata, EmailAnalytics, ProviderAnalytics, EmailWebhookEventsConfig, ProviderWebhookConfig, NotificationChannel, EmailWebhookResult, WebhookPayload, AnalyticsFilters, EventQuery, EmailWebhookError, EmailWebhookErrorCode, WebhookEventCallbacks } from './types';
 export { EventNormalizer } from './normalizers/EventNormalizer';
 export { SendGridNormalizer } from './normalizers/SendGridNormalizer';
 export { MailgunNormalizer } from './normalizers/MailgunNormalizer';

package/dist/index.d.ts.map

@@ -1 +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"}
+{"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,EACrB,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.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;AAEF,yEAAwE;AAA/D,sIAAA,yBAAyB,OAAA;AAElC,iCAiBiB;AAff,uGAAA,cAAc,OAAA;AACd,sGAAA,aAAa,OAAA;AAYb,8GAAA,qBAAqB,OAAA;AAKvB,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/types.d.ts

@@ -26,7 +26,8 @@ export declare enum EmailProvider {
     AWS_SES = "aws_ses",
     POSTMARK = "postmark",
     SMTP2GO = "smtp2go",
-    GENERIC_SMTP = "generic_smtp"
+    GENERIC_SMTP = "generic_smtp",
+    MANDRILL = "mandrill"
 }
 export interface EmailEventMetadata {
     url?: string;
@@ -97,6 +98,15 @@ export interface ProviderAnalytics {
     openRate: number;
     clickRate: number;
 }
+export interface WebhookEventCallbacks {
+    readonly onBounce?: (event: EmailEvent) => void | Promise<void>;
+    readonly onComplaint?: (event: EmailEvent) => void | Promise<void>;
+    readonly onUnsubscribe?: (event: EmailEvent) => void | Promise<void>;
+    readonly onDelivery?: (event: EmailEvent) => void | Promise<void>;
+    readonly onOpen?: (event: EmailEvent) => void | Promise<void>;
+    readonly onClick?: (event: EmailEvent) => void | Promise<void>;
+    readonly onFailure?: (event: EmailEvent) => void | Promise<void>;
+}
 export interface EmailWebhookEventsConfig {
     providers: ProviderWebhookConfig[];
     persistence?: {
@@ -114,6 +124,7 @@ export interface EmailWebhookEventsConfig {
         criticalEvents: EmailEventType[];
         channels: NotificationChannel[];
     };
+    callbacks?: WebhookEventCallbacks;
     rateLimiting?: {
         enabled: boolean;
         maxEventsPerSecond: number;

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -28,6 +28,7 @@ var EmailProvider;
     EmailProvider["POSTMARK"] = "postmark";
     EmailProvider["SMTP2GO"] = "smtp2go";
     EmailProvider["GENERIC_SMTP"] = "generic_smtp";
+    EmailProvider["MANDRILL"] = "mandrill";
 })(EmailProvider || (exports.EmailProvider = EmailProvider = {}));
 var EmailWebhookErrorCode;
 (function (EmailWebhookErrorCode) {

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;AA4BF,IAAY,cAUX;AAVD,WAAY,cAAc;IACxB,yCAAuB,CAAA;IACvB,mCAAiB,CAAA;IACjB,qCAAmB,CAAA;IACnB,qCAAmB,CAAA;IACnB,2CAAyB,CAAA;IACzB,+CAA6B,CAAA;IAC7B,mCAAiB,CAAA;IACjB,uCAAqB,CAAA;IACrB,qCAAmB,CAAA;AACrB,CAAC,EAVW,cAAc,8BAAd,cAAc,QAUzB;AAED,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;IACnB,oCAAmB,CAAA;IACnB,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;IACnB,8CAA6B,CAAA;AAC/B,CAAC,EAPW,aAAa,6BAAb,aAAa,QAOxB;AAyLD,IAAY,qBAOX;AAPD,WAAY,qBAAqB;IAC/B,gEAAuC,CAAA;IACvC,sEAA6C,CAAA;IAC7C,sEAA6C,CAAA;IAC7C,kEAAyC,CAAA;IACzC,4EAAmD,CAAA;IACnD,oEAA2C,CAAA;AAC7C,CAAC,EAPW,qBAAqB,qCAArB,qBAAqB,QAOhC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;AA4BF,IAAY,cAUX;AAVD,WAAY,cAAc;IACxB,yCAAuB,CAAA;IACvB,mCAAiB,CAAA;IACjB,qCAAmB,CAAA;IACnB,qCAAmB,CAAA;IACnB,2CAAyB,CAAA;IACzB,+CAA6B,CAAA;IAC7B,mCAAiB,CAAA;IACjB,uCAAqB,CAAA;IACrB,qCAAmB,CAAA;AACrB,CAAC,EAVW,cAAc,8BAAd,cAAc,QAUzB;AAED,IAAY,aAQX;AARD,WAAY,aAAa;IACvB,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;IACnB,oCAAmB,CAAA;IACnB,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;IACnB,8CAA6B,CAAA;IAC7B,sCAAqB,CAAA;AACvB,CAAC,EARW,aAAa,6BAAb,aAAa,QAQxB;AAuMD,IAAY,qBAOX;AAPD,WAAY,qBAAqB;IAC/B,gEAAuC,CAAA;IACvC,sEAA6C,CAAA;IAC7C,sEAA6C,CAAA;IAC7C,kEAAyC,CAAA;IACzC,4EAAmD,CAAA;IACnD,oEAA2C,CAAA;AAC7C,CAAC,EAPW,qBAAqB,qCAArB,qBAAqB,QAOhC"}

package/package.json

@@ -1,17 +1,9 @@
 {
   "name": "@bernierllc/email-webhook-events",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "Email event tracking, normalization, and analytics service for processing webhooks from all email providers",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "scripts": {
-    "build": "tsc",
-    "test": "jest",
-    "test:run": "jest",
-    "test:coverage": "jest --coverage",
-    "lint": "eslint src --ext .ts",
-    "clean": "rm -rf dist"
-  },
   "keywords": [
     "email",
     "webhooks",
@@ -28,7 +20,7 @@
   "author": "Bernier LLC",
   "license": "SEE LICENSE IN LICENSE",
   "dependencies": {
-    "@bernierllc/email-manager": "0.4.0"
+    "@bernierllc/email-manager": "0.6.0"
   },
   "devDependencies": {
     "@ngrok/ngrok": "^1.7.0",
@@ -55,5 +47,12 @@
       "logger": "integrated"
     }
   },
-  "gitHead": "af7e74b3715d56d3a193e1bb6743b337c2b0df6d"
-}
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:run": "jest --forceExit",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src --ext .ts",
+    "clean": "rm -rf dist"
+  }
+}

package/src/EmailWebhookEventsService.ts

@@ -96,6 +96,9 @@ export class EmailWebhookEventsService {
       // Update analytics
       await this.analyticsEngine.recordEvent(normalizedEvent);
 
+      // Invoke event callbacks
+      await this.invokeCallbacks(normalizedEvent);
+
       // Publish critical events
       if (this.isCriticalEvent(normalizedEvent)) {
         await this.publishCriticalEvent(normalizedEvent);
@@ -230,6 +233,46 @@ export class EmailWebhookEventsService {
     });
   }
 
+  /**
+   * Invoke registered event callbacks
+   */
+  private async invokeCallbacks(event: EmailEvent): Promise<void> {
+    const callbacks = this.config.callbacks;
+    if (!callbacks) return;
+
+    try {
+      switch (event.type) {
+        case EmailEventType.BOUNCED:
+          await callbacks.onBounce?.(event);
+          break;
+        case EmailEventType.COMPLAINED:
+          await callbacks.onComplaint?.(event);
+          break;
+        case EmailEventType.UNSUBSCRIBED:
+          await callbacks.onUnsubscribe?.(event);
+          break;
+        case EmailEventType.DELIVERED:
+          await callbacks.onDelivery?.(event);
+          break;
+        case EmailEventType.OPENED:
+          await callbacks.onOpen?.(event);
+          break;
+        case EmailEventType.CLICKED:
+          await callbacks.onClick?.(event);
+          break;
+        case EmailEventType.FAILED:
+          await callbacks.onFailure?.(event);
+          break;
+      }
+    } catch (error) {
+      this.logger.error('Event callback failed', {
+        eventType: event.type,
+        eventId: event.id,
+        error: error instanceof Error ? error.message : 'Unknown error'
+      });
+    }
+  }
+
   /**
    * Create persistence adapter
    */

package/src/index.ts

@@ -23,7 +23,8 @@ export {
   AnalyticsFilters,
   EventQuery,
   EmailWebhookError,
-  EmailWebhookErrorCode
+  EmailWebhookErrorCode,
+  WebhookEventCallbacks
 } from './types';
 
 export { EventNormalizer } from './normalizers/EventNormalizer';

package/src/types.ts

@@ -50,7 +50,8 @@ export enum EmailProvider {
   AWS_SES = 'aws_ses',
   POSTMARK = 'postmark',
   SMTP2GO = 'smtp2go',
-  GENERIC_SMTP = 'generic_smtp'
+  GENERIC_SMTP = 'generic_smtp',
+  MANDRILL = 'mandrill',
 }
 
 export interface EmailEventMetadata {
@@ -148,6 +149,17 @@ export interface ProviderAnalytics {
   clickRate: number;
 }
 
+// Event callback hooks
+export interface WebhookEventCallbacks {
+  readonly onBounce?: (event: EmailEvent) => void | Promise<void>;
+  readonly onComplaint?: (event: EmailEvent) => void | Promise<void>;
+  readonly onUnsubscribe?: (event: EmailEvent) => void | Promise<void>;
+  readonly onDelivery?: (event: EmailEvent) => void | Promise<void>;
+  readonly onOpen?: (event: EmailEvent) => void | Promise<void>;
+  readonly onClick?: (event: EmailEvent) => void | Promise<void>;
+  readonly onFailure?: (event: EmailEvent) => void | Promise<void>;
+}
+
 // Configuration
 export interface EmailWebhookEventsConfig {
   // Provider configurations
@@ -174,6 +186,9 @@ export interface EmailWebhookEventsConfig {
     channels: NotificationChannel[];
   };
 
+  // Event callbacks
+  callbacks?: WebhookEventCallbacks;
+
   // Rate limiting
   rateLimiting?: {
     enabled: boolean;