@wisemen/nestjs-mail 1.0.0 → 1.1.0

package/README.md

@@ -6,7 +6,10 @@ Reusable NestJS mail infrastructure for Wisemen services.
 
 - `MailModule.forRoot()` and `MailModule.forRootAsync()` for DI-friendly mail client wiring
 - `HandlebarsRenderer` integration through `@wisemen/nestjs-handlebars`
-- Mail providers for MailPit, Scaleway, and SendGrid
+- Mail providers for MailPit, Scaleway, SendGrid, and Mailgun
+- Named sender support (`from` as a string or `{ email, name? }`)
+- Application-defined delivery metadata
+- Delivery success and failure hooks without replacing packaged clients or queue handlers
 - Shared mail errors, enums, and message types
 
 ## Usage
@@ -21,10 +24,15 @@ import { MailModule } from '@wisemen/nestjs-mail'
       templateRootPath: process.cwd() + '/dist/src/modules',
       client: {
         type: 'mailpit',
-        url: 'http://127.0.0.1:8025'
-      }
-    })
-  ]
+        url: 'http://127.0.0.1:8025',
+        defaultFrom: {
+          email: 'hello@example.com',
+          name: 'Example Team',
+        },
+      },
+      queueName: 'mail',
+    }),
+  ],
 })
 export class AppModule {}
 ```
@@ -32,3 +40,81 @@ export class AppModule {}
 Project-specific policy belongs outside the package. In larger apps, use `forRootAsync()` and resolve the `client` options from environment variables, feature flags, secrets, or test doubles in your own factory.
 
 Install `@wisemen/nestjs-handlebars` alongside this package when you want to inject `HandlebarsRenderer` for template-based mail rendering.
+
+## Named senders and metadata
+
+Both configured default senders and per-message `from` values accept an email
+string or an object with an optional display name. `metadata` is opaque
+application context exposed to delivery hooks; it is never sent to MailPit,
+Scaleway, or SendGrid.
+
+```ts
+await mailClient.sendMail({
+  from: {
+    email: 'tickets@example.com',
+    name: 'Example Tickets',
+  },
+  to: 'customer@example.com',
+  subject: 'Your tickets',
+  html: '<p>Your tickets are ready.</p>',
+  metadata: {
+    deliveryId: 'delivery-123',
+    kind: 'ticket-confirmation',
+  },
+})
+```
+
+Metadata placed in `SendHtmlMailJobData` or `SendTemplateMailJobData` must be
+JSON-serializable because it passes through the queue.
+
+## Mailgun
+
+```ts
+MailModule.forRoot({
+  client: {
+    type: 'mailgun',
+    domain: 'mail.example.com',
+    apiKey: 'key-...',
+    defaultFrom: {
+      email: 'hello@example.com',
+      name: 'Example Team',
+    },
+    // Use 'https://api.eu.mailgun.net' for EU-region domains. Defaults to 'https://api.mailgun.net'.
+    baseUrl: 'https://api.eu.mailgun.net',
+  },
+  queueName: 'mail',
+})
+```
+
+## Delivery hooks
+
+Configure one hooks object on the module. Hooks receive the configured client
+type, the original send options (including metadata), and either the exact
+`SentMail[]` result or the original provider error.
+
+```ts
+MailModule.forRoot({
+  client: {
+    type: 'mailpit',
+    url: 'http://127.0.0.1:8025',
+  },
+  queueName: 'mail',
+  deliveryHooks: {
+    async onSuccess ({ clientType, options, sentMails }) {
+      await deliveries.markSent({
+        clientType,
+        metadata: options.metadata,
+        providerIds: sentMails.map(mail => mail.id),
+      })
+    },
+    async onFailure ({ clientType, options, error }) {
+      await deliveries.markFailed({ clientType, metadata: options.metadata, error })
+    },
+  },
+})
+```
+
+Hook failures log only the hook phase, client type, and error stack. Recipients,
+bodies, subjects, and metadata are never added to the log. Hook failures never
+turn a successful provider delivery into a failed send or replace a provider
+error, so they cannot trigger a duplicate-email queue retry.

package/dist/clients/mail-client.factory.d.ts

@@ -1,4 +1,5 @@
 import type { MailModuleOptions } from '../modules/mail.module-options.js';
 import type { MailClient } from './mail.client.js';
-export declare function createMailClient(options: MailModuleOptions['client']): MailClient;
+import type { MailDeliveryHooks } from './mail.client.js';
+export declare function createMailClient(options: MailModuleOptions['client'], deliveryHooks?: MailDeliveryHooks): MailClient;
 export declare const mailClientFactory: typeof createMailClient;

package/dist/clients/mail-client.factory.js

@@ -1,10 +1,19 @@
 import { MailProvider } from '../enums/mail-provider.enum.js';
 import { exhaustiveCheck } from '../utils/exhaustive-check.js';
+import { MailDeliveryHooksClient } from './mail-delivery-hooks.client.js';
+import { MailgunMailClient } from './mailgun-mail.client.js';
 import { MailPitMailClient } from './mailpit-mail.client.js';
 import { MockMailClient } from './mock-mail.client.js';
 import { ScalewayMailClient } from './scaleway-mail.client.js';
 import { SendGridMailClient } from './sendgrid-mail.client.js';
-export function createMailClient(options) {
+export function createMailClient(options, deliveryHooks) {
+    const client = createConcreteMailClient(options);
+    if (deliveryHooks === undefined) {
+        return client;
+    }
+    return new MailDeliveryHooksClient(client, options.type, deliveryHooks);
+}
+function createConcreteMailClient(options) {
     switch (options.type) {
         case 'mailpit':
             return new MailPitMailClient(options);
@@ -14,6 +23,8 @@ export function createMailClient(options) {
             return new ScalewayMailClient(options);
         case MailProvider.SEND_GRID:
             return new SendGridMailClient(options);
+        case MailProvider.MAILGUN:
+            return new MailgunMailClient(options);
         default:
             exhaustiveCheck(options);
     }

package/dist/clients/mail-client.factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"mail-client.factory.js","sourceRoot":"","sources":["../../lib/clients/mail-client.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAE9D,MAAM,UAAU,gBAAgB,CAAE,OAAoC;IACpE,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAA;QACvC,KAAK,MAAM;YACT,OAAO,IAAI,cAAc,EAAE,CAAA;QAC7B,KAAK,YAAY,CAAC,QAAQ;YACxB,OAAO,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAA;QACxC,KAAK,YAAY,CAAC,SAAS;YACzB,OAAO,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAA;QACxC;YACE,eAAe,CAAC,OAAO,CAAC,CAAA;IAC5B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,gBAAgB,CAAA"}
+{"version":3,"file":"mail-client.factory.js","sourceRoot":"","sources":["../../lib/clients/mail-client.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAG9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAE9D,MAAM,UAAU,gBAAgB,CAC9B,OAAoC,EACpC,aAAiC;IAEjC,MAAM,MAAM,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAA;IAEhD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,MAAM,CAAA;IACf,CAAC;IAED,OAAO,IAAI,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;AACzE,CAAC;AAED,SAAS,wBAAwB,CAAE,OAAoC;IACrE,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAA;QACvC,KAAK,MAAM;YACT,OAAO,IAAI,cAAc,EAAE,CAAA;QAC7B,KAAK,YAAY,CAAC,QAAQ;YACxB,OAAO,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAA;QACxC,KAAK,YAAY,CAAC,SAAS;YACzB,OAAO,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAA;QACxC,KAAK,YAAY,CAAC,OAAO;YACvB,OAAO,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAA;QACvC;YACE,eAAe,CAAC,OAAO,CAAC,CAAA;IAC5B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,gBAAgB,CAAA"}

package/dist/clients/mail-delivery-hooks.client.d.ts

@@ -0,0 +1,11 @@
+import type { MailClientType, MailDeliveryHooks, SendMailOptions, SentMail } from './mail.client.js';
+import { MailClient } from './mail.client.js';
+export declare class MailDeliveryHooksClient extends MailClient {
+    private readonly client;
+    private readonly clientType;
+    private readonly hooks;
+    private readonly logger;
+    constructor(client: MailClient, clientType: MailClientType, hooks: MailDeliveryHooks);
+    sendMail(options: SendMailOptions): Promise<SentMail[]>;
+    private runHook;
+}

package/dist/clients/mail-delivery-hooks.client.js

@@ -0,0 +1,47 @@
+import { Logger } from '@nestjs/common';
+import { MailClient } from './mail.client.js';
+export class MailDeliveryHooksClient extends MailClient {
+    client;
+    clientType;
+    hooks;
+    logger = new Logger(MailDeliveryHooksClient.name);
+    constructor(client, clientType, hooks) {
+        super();
+        this.client = client;
+        this.clientType = clientType;
+        this.hooks = hooks;
+    }
+    async sendMail(options) {
+        let sentMails;
+        try {
+            sentMails = await this.client.sendMail(options);
+        }
+        catch (error) {
+            await this.runHook('failure', () => this.hooks.onFailure?.({
+                clientType: this.clientType,
+                options,
+                error
+            }));
+            throw error;
+        }
+        await this.runHook('success', () => this.hooks.onSuccess?.({
+            clientType: this.clientType,
+            options,
+            sentMails
+        }));
+        return sentMails;
+    }
+    async runHook(phase, hook) {
+        try {
+            await hook();
+        }
+        catch (error) {
+            this.logger.error({
+                phase,
+                clientType: this.clientType,
+                stack: error instanceof Error ? error.stack : undefined
+            });
+        }
+    }
+}
+//# sourceMappingURL=mail-delivery-hooks.client.js.map

package/dist/clients/mail-delivery-hooks.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-delivery-hooks.client.js","sourceRoot":"","sources":["../../lib/clients/mail-delivery-hooks.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAEvC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAI7C,MAAM,OAAO,uBAAwB,SAAQ,UAAU;IAIlC;IACA;IACA;IALF,MAAM,GAAG,IAAI,MAAM,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAA;IAElE,YACmB,MAAkB,EAClB,UAA0B,EAC1B,KAAwB;QAEzC,KAAK,EAAE,CAAA;QAJU,WAAM,GAAN,MAAM,CAAY;QAClB,eAAU,GAAV,UAAU,CAAgB;QAC1B,UAAK,GAAL,KAAK,CAAmB;IAG3C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAE,OAAwB;QACtC,IAAI,SAAqB,CAAA;QAEzB,IAAI,CAAC;YACH,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QACjD,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;gBACzD,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,OAAO;gBACP,KAAK;aACN,CAAC,CAAC,CAAA;YAEH,MAAM,KAAK,CAAA;QACb,CAAC;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YACzD,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO;YACP,SAAS;SACV,CAAC,CAAC,CAAA;QAEH,OAAO,SAAS,CAAA;IAClB,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,KAA4B,EAC5B,IAAqC;QAErC,IAAI,CAAC;YACH,MAAM,IAAI,EAAE,CAAA;QACd,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;gBAChB,KAAK;gBACL,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;aACxD,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/clients/mail-delivery-hooks.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clients/mail-delivery-hooks.test.js

@@ -0,0 +1,104 @@
+import { Logger } from '@nestjs/common';
+import { afterEach, describe, it, mock } from 'node:test';
+import { expect } from 'expect';
+import { createMailClient } from './mail-client.factory.js';
+import { MockMailClient } from './mock-mail.client.js';
+afterEach(() => {
+    mock.restoreAll();
+});
+const options = {
+    to: 'recipient@example.com',
+    subject: 'Sensitive subject',
+    text: 'Sensitive body',
+    metadata: { deliveryId: 'sensitive-metadata' }
+};
+describe('mail delivery hooks', () => {
+    it('awaits success hooks and preserves the exact result', async () => {
+        const sentMails = [{ id: 'provider-id', recipients: ['recipient@example.com'] }];
+        let delivery;
+        let hookFinished = false;
+        mock.method(MockMailClient.prototype, 'sendMail', () => Promise.resolve(sentMails));
+        const client = createMailClient({ type: 'mock' }, {
+            onSuccess: async (value) => {
+                await Promise.resolve();
+                delivery = value;
+                hookFinished = true;
+            }
+        });
+        const result = await client.sendMail(options);
+        expect(hookFinished).toBe(true);
+        expect(delivery?.clientType).toBe('mock');
+        expect(delivery?.options).toBe(options);
+        expect(delivery?.sentMails).toBe(sentMails);
+        expect(result).toBe(sentMails);
+    });
+    it('invokes failure hooks and rethrows the exact provider error', async () => {
+        const providerError = new Error('provider failed');
+        let delivery;
+        mock.method(MockMailClient.prototype, 'sendMail', () => Promise.reject(providerError));
+        const client = createMailClient({ type: 'mock' }, {
+            onFailure: async (value) => {
+                delivery = value;
+                await Promise.resolve();
+            }
+        });
+        await expect(client.sendMail(options)).rejects.toBe(providerError);
+        expect(delivery?.clientType).toBe('mock');
+        expect(delivery?.options).toBe(options);
+        expect(delivery?.error).toBe(providerError);
+    });
+    it('logs and swallows success-hook failures without invoking failure hooks', async () => {
+        const sentMails = [{ id: 'provider-id', recipients: ['recipient@example.com'] }];
+        const hookError = new Error('success hook failed');
+        const logs = [];
+        let failureHookCalled = false;
+        mock.method(MockMailClient.prototype, 'sendMail', () => Promise.resolve(sentMails));
+        mock.method(Logger.prototype, 'error', (...args) => {
+            logs.push(args);
+        });
+        const client = createMailClient({ type: 'mock' }, {
+            onSuccess: () => Promise.reject(hookError),
+            onFailure: () => {
+                failureHookCalled = true;
+                return Promise.resolve();
+            }
+        });
+        const result = await client.sendMail(options);
+        expect(result).toBe(sentMails);
+        expect(failureHookCalled).toBe(false);
+        expect(logs).toEqual([[{
+                    phase: 'success',
+                    clientType: 'mock',
+                    stack: hookError.stack
+                }]]);
+        expect(JSON.stringify(logs)).not.toContain(options.subject);
+        expect(JSON.stringify(logs)).not.toContain(options.text);
+        expect(JSON.stringify(logs)).not.toContain('sensitive-metadata');
+    });
+    it('logs failure-hook failures and preserves the provider error', async () => {
+        const providerError = new Error('provider failed');
+        const hookError = new Error('failure hook failed');
+        const logs = [];
+        mock.method(MockMailClient.prototype, 'sendMail', () => Promise.reject(providerError));
+        mock.method(Logger.prototype, 'error', (...args) => {
+            logs.push(args);
+        });
+        const client = createMailClient({ type: 'mock' }, {
+            onFailure: () => Promise.reject(hookError)
+        });
+        await expect(client.sendMail(options)).rejects.toBe(providerError);
+        expect(logs).toEqual([[{
+                    phase: 'failure',
+                    clientType: 'mock',
+                    stack: hookError.stack
+                }]]);
+        expect(JSON.stringify(logs)).not.toContain(options.subject);
+        expect(JSON.stringify(logs)).not.toContain(options.text);
+        expect(JSON.stringify(logs)).not.toContain('sensitive-metadata');
+    });
+    it('returns the existing concrete client unchanged without hooks', () => {
+        const client = createMailClient({ type: 'mock' });
+        expect(client).toBeInstanceOf(MockMailClient);
+    });
+});
+//# sourceMappingURL=mail-delivery-hooks.test.js.map

package/dist/clients/mail-delivery-hooks.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-delivery-hooks.test.js","sourceRoot":"","sources":["../../lib/clients/mail-delivery-hooks.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AACvC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAEtD,SAAS,CAAC,GAAG,EAAE;IACb,IAAI,CAAC,UAAU,EAAE,CAAA;AACnB,CAAC,CAAC,CAAA;AAEF,MAAM,OAAO,GAAoB;IAC/B,EAAE,EAAE,uBAAuB;IAC3B,OAAO,EAAE,mBAAmB;IAC5B,IAAI,EAAE,gBAAgB;IACtB,QAAQ,EAAE,EAAE,UAAU,EAAE,oBAAoB,EAAE;CAC/C,CAAA;AAED,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,SAAS,GAAe,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAA;QAC5F,IAAI,QAAyC,CAAA;QAC7C,IAAI,YAAY,GAAG,KAAK,CAAA;QAExB,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAA;QACnF,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;YAChD,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACzB,MAAM,OAAO,CAAC,OAAO,EAAE,CAAA;gBACvB,QAAQ,GAAG,KAAK,CAAA;gBAChB,YAAY,GAAG,IAAI,CAAA;YACrB,CAAC;SACF,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QAE7C,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC/B,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACzC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACvC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAChC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,aAAa,GAAG,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;QAClD,IAAI,QAAyC,CAAA;QAE7C,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAA;QACtF,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;YAChD,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACzB,QAAQ,GAAG,KAAK,CAAA;gBAChB,MAAM,OAAO,CAAC,OAAO,EAAE,CAAA;YACzB,CAAC;SACF,CAAC,CAAA;QAEF,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;QAClE,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACzC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACvC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,SAAS,GAAe,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAA;QAC5F,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAA;QAClD,MAAM,IAAI,GAAgB,EAAE,CAAA;QAC5B,IAAI,iBAAiB,GAAG,KAAK,CAAA;QAE7B,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAA;QACnF,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;YAC5D,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjB,CAAC,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;YAChD,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;YAC1C,SAAS,EAAE,GAAG,EAAE;gBACd,iBAAiB,GAAG,IAAI,CAAA;gBACxB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;YAC1B,CAAC;SACF,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QAE7C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC9B,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACrC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;oBACrB,KAAK,EAAE,SAAS;oBAChB,UAAU,EAAE,MAAM;oBAClB,KAAK,EAAE,SAAS,CAAC,KAAK;iBACvB,CAAC,CAAC,CAAC,CAAA;QACJ,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAC3D,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACxD,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAA;IAClE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,aAAa,GAAG,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;QAClD,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAA;QAClD,MAAM,IAAI,GAAgB,EAAE,CAAA;QAE5B,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAA;QACtF,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;YAC5D,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjB,CAAC,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;YAChD,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;SAC3C,CAAC,CAAA;QAEF,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;QAClE,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;oBACrB,KAAK,EAAE,SAAS;oBAChB,UAAU,EAAE,MAAM;oBAClB,KAAK,EAAE,SAAS,CAAC,KAAK;iBACvB,CAAC,CAAC,CAAC,CAAA;QACJ,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAC3D,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACxD,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAA;IAClE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;QAEjD,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,cAAc,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/clients/mail-providers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clients/mail-providers.test.js

@@ -0,0 +1,275 @@
+import { afterEach, describe, it, mock } from 'node:test';
+import { expect } from 'expect';
+import { MailProvider } from '../enums/mail-provider.enum.js';
+import { MailgunMailClient } from './mailgun-mail.client.js';
+import { MailPitMailClient } from './mailpit-mail.client.js';
+import { ScalewayMailClient } from './scaleway-mail.client.js';
+import { SendGridMailClient } from './sendgrid-mail.client.js';
+afterEach(() => {
+    mock.restoreAll();
+});
+function captureFetchBody(response) {
+    let body;
+    mock.method(globalThis, 'fetch', (_input, init) => {
+        if (typeof init?.body !== 'string') {
+            return Promise.reject(new Error('Expected a JSON request body'));
+        }
+        body = init.body;
+        return Promise.resolve(response);
+    });
+    return () => JSON.parse(body ?? '');
+}
+function scalewayResponse() {
+    return new Response(JSON.stringify({
+        emails: [{ id: 'scaleway-id', mail_rcpt: 'recipient@example.com' }]
+    }), { status: 200 });
+}
+function sendGridResponse() {
+    return new Response(null, {
+        status: 202,
+        headers: { 'x-message-id': 'sendgrid-id' }
+    });
+}
+function captureFormDataBody(response) {
+    let body;
+    mock.method(globalThis, 'fetch', (_input, init) => {
+        if (!(init?.body instanceof FormData)) {
+            return Promise.reject(new Error('Expected a FormData request body'));
+        }
+        body = init.body;
+        return Promise.resolve(response);
+    });
+    return () => {
+        if (body === undefined) {
+            throw new Error('fetch was not called');
+        }
+        return body;
+    };
+}
+function mailgunResponse() {
+    return new Response(JSON.stringify({ id: 'mailgun-id', message: 'Queued. Thank you.' }), { status: 200 });
+}
+describe('ScalewayMailClient sender payload', () => {
+    it('normalizes a string sender and preserves SentMail', async () => {
+        const getBody = captureFetchBody(scalewayResponse());
+        const client = new ScalewayMailClient({
+            type: MailProvider.SCALEWAY,
+            projectId: 'project-id',
+            apiKey: 'api-key',
+            from: 'default@example.com'
+        });
+        const sentMails = await client.sendMail({
+            from: 'sender@example.com',
+            to: 'recipient@example.com',
+            subject: 'Subject',
+            text: 'Body'
+        });
+        expect(getBody()).toMatchObject({ from: { email: 'sender@example.com' } });
+        expect(sentMails).toEqual([{ id: 'scaleway-id', recipients: ['recipient@example.com'] }]);
+    });
+    it('maps a named sender and excludes metadata', async () => {
+        const getBody = captureFetchBody(scalewayResponse());
+        const client = new ScalewayMailClient({
+            type: MailProvider.SCALEWAY,
+            projectId: 'project-id',
+            apiKey: 'api-key',
+            from: 'default@example.com'
+        });
+        await client.sendMail({
+            from: { email: 'sender@example.com', name: 'Sender Name' },
+            to: 'recipient@example.com',
+            subject: 'Subject',
+            text: 'Body',
+            metadata: { deliveryId: 'secret-delivery-id' }
+        });
+        const body = getBody();
+        expect(body).toMatchObject({ from: { email: 'sender@example.com', name: 'Sender Name' } });
+        expect(body).not.toHaveProperty('metadata');
+        expect(JSON.stringify(body)).not.toContain('secret-delivery-id');
+    });
+    it('maps a named default sender', async () => {
+        const getBody = captureFetchBody(scalewayResponse());
+        const client = new ScalewayMailClient({
+            type: MailProvider.SCALEWAY,
+            projectId: 'project-id',
+            apiKey: 'api-key',
+            from: { email: 'default@example.com', name: 'Default Sender' }
+        });
+        await client.sendMail({
+            to: 'recipient@example.com',
+            subject: 'Subject',
+            text: 'Body'
+        });
+        expect(getBody()).toMatchObject({ from: { email: 'default@example.com', name: 'Default Sender' } });
+    });
+});
+describe('SendGridMailClient sender payload', () => {
+    it('normalizes a string sender and preserves SentMail', async () => {
+        const getBody = captureFetchBody(sendGridResponse());
+        const client = new SendGridMailClient({
+            type: MailProvider.SEND_GRID,
+            apiToken: 'api-token',
+            defaultFrom: 'default@example.com'
+        });
+        const sentMails = await client.sendMail({
+            from: 'sender@example.com',
+            to: 'recipient@example.com',
+            subject: 'Subject',
+            text: 'Body'
+        });
+        expect(getBody()).toMatchObject({ from: { email: 'sender@example.com' } });
+        expect(sentMails).toEqual([{ id: 'sendgrid-id', recipients: ['recipient@example.com'] }]);
+    });
+    it('maps a named sender and excludes metadata', async () => {
+        const getBody = captureFetchBody(sendGridResponse());
+        const client = new SendGridMailClient({
+            type: MailProvider.SEND_GRID,
+            apiToken: 'api-token',
+            defaultFrom: 'default@example.com'
+        });
+        await client.sendMail({
+            from: { email: 'sender@example.com', name: 'Sender Name' },
+            to: 'recipient@example.com',
+            subject: 'Subject',
+            text: 'Body',
+            metadata: { deliveryId: 'secret-delivery-id' }
+        });
+        const body = getBody();
+        expect(body).toMatchObject({ from: { email: 'sender@example.com', name: 'Sender Name' } });
+        expect(body).not.toHaveProperty('metadata');
+        expect(JSON.stringify(body)).not.toContain('secret-delivery-id');
+    });
+    it('maps a named default sender', async () => {
+        const getBody = captureFetchBody(sendGridResponse());
+        const client = new SendGridMailClient({
+            type: MailProvider.SEND_GRID,
+            apiToken: 'api-token',
+            defaultFrom: { email: 'default@example.com', name: 'Default Sender' }
+        });
+        await client.sendMail({
+            to: 'recipient@example.com',
+            subject: 'Subject',
+            text: 'Body'
+        });
+        expect(getBody()).toMatchObject({ from: { email: 'default@example.com', name: 'Default Sender' } });
+    });
+});
+describe('MailgunMailClient sender payload', () => {
+    it('normalizes a string sender and preserves SentMail', async () => {
+        const getForm = captureFormDataBody(mailgunResponse());
+        const client = new MailgunMailClient({
+            type: MailProvider.MAILGUN,
+            domain: 'mail.example.com',
+            apiKey: 'api-key',
+            defaultFrom: 'default@example.com'
+        });
+        const sentMails = await client.sendMail({
+            from: 'sender@example.com',
+            to: 'recipient@example.com',
+            subject: 'Subject',
+            text: 'Body'
+        });
+        expect(getForm().get('from')).toBe('sender@example.com');
+        expect(sentMails).toEqual([{ id: 'mailgun-id', recipients: ['recipient@example.com'] }]);
+    });
+    it('maps a named sender and excludes metadata', async () => {
+        const getForm = captureFormDataBody(mailgunResponse());
+        const client = new MailgunMailClient({
+            type: MailProvider.MAILGUN,
+            domain: 'mail.example.com',
+            apiKey: 'api-key',
+            defaultFrom: 'default@example.com'
+        });
+        await client.sendMail({
+            from: { email: 'sender@example.com', name: 'Sender Name' },
+            to: 'recipient@example.com',
+            subject: 'Subject',
+            text: 'Body',
+            metadata: { deliveryId: 'secret-delivery-id' }
+        });
+        const form = getForm();
+        expect(form.get('from')).toBe('Sender Name <sender@example.com>');
+        const values = [...form.values()]
+            .filter((value) => typeof value === 'string')
+            .join(' ');
+        expect(values).not.toContain('secret-delivery-id');
+        expect(values).not.toContain('metadata');
+    });
+    it('maps a named default sender', async () => {
+        const getForm = captureFormDataBody(mailgunResponse());
+        const client = new MailgunMailClient({
+            type: MailProvider.MAILGUN,
+            domain: 'mail.example.com',
+            apiKey: 'api-key',
+            defaultFrom: { email: 'default@example.com', name: 'Default Sender' }
+        });
+        await client.sendMail({
+            to: 'recipient@example.com',
+            subject: 'Subject',
+            text: 'Body'
+        });
+        expect(getForm().get('from')).toBe('Default Sender <default@example.com>');
+    });
+});
+function captureMailPitRequest(client) {
+    let request;
+    Object.defineProperty(client, 'client', {
+        value: {
+            sendMessage: (value) => {
+                request = value;
+                return Promise.resolve({ ID: 'mailpit-id' });
+            }
+        }
+    });
+    return () => request;
+}
+describe('MailPitMailClient sender payload', () => {
+    it('normalizes a string sender and preserves SentMail', async () => {
+        const client = new MailPitMailClient({
+            type: 'mailpit',
+            url: 'http://127.0.0.1:8025'
+        });
+        const getRequest = captureMailPitRequest(client);
+        const sentMails = await client.sendMail({
+            from: 'sender@example.com',
+            to: 'recipient@example.com',
+            subject: 'Subject',
+            text: 'Body'
+        });
+        expect(getRequest()).toMatchObject({ From: { Email: 'sender@example.com' } });
+        expect(sentMails).toEqual([{ id: 'mailpit-id', recipients: ['recipient@example.com'] }]);
+    });
+    it('maps a named sender and excludes metadata', async () => {
+        const client = new MailPitMailClient({
+            type: 'mailpit',
+            url: 'http://127.0.0.1:8025'
+        });
+        const getRequest = captureMailPitRequest(client);
+        await client.sendMail({
+            from: { email: 'sender@example.com', name: 'Sender Name' },
+            to: 'recipient@example.com',
+            subject: 'Subject',
+            text: 'Body',
+            metadata: { deliveryId: 'secret-delivery-id' }
+        });
+        const request = getRequest();
+        expect(request).toMatchObject({ From: { Email: 'sender@example.com', Name: 'Sender Name' } });
+        expect(request).not.toHaveProperty('metadata');
+        expect(JSON.stringify(request)).not.toContain('secret-delivery-id');
+    });
+    it('maps a named default sender', async () => {
+        const client = new MailPitMailClient({
+            type: 'mailpit',
+            url: 'http://127.0.0.1:8025',
+            defaultFrom: { email: 'default@example.com', name: 'Default Sender' }
+        });
+        const getRequest = captureMailPitRequest(client);
+        await client.sendMail({
+            to: 'recipient@example.com',
+            subject: 'Subject',
+            text: 'Body'
+        });
+        expect(getRequest()).toMatchObject({ From: { Email: 'default@example.com', Name: 'Default Sender' } });
+    });
+});
+//# sourceMappingURL=mail-providers.test.js.map

package/dist/clients/mail-providers.test.js.map

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