@flusys/nestjs-email 6.4.0 → 7.0.0-beta.1

package/cjs/config/event-actions.js

@@ -0,0 +1,34 @@
+/**
+ * Domain event actions published by the email module, alongside the CRUD
+ * lifecycle actions every ApiService emits.
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get EMAIL_EVENT_ACTIONS () {
+        return EMAIL_EVENT_ACTIONS;
+    },
+    get EMAIL_EVENT_ENTITIES () {
+        return EMAIL_EVENT_ENTITIES;
+    },
+    get EMAIL_EVENT_MODULE () {
+        return EMAIL_EVENT_MODULE;
+    }
+});
+const EMAIL_EVENT_ACTIONS = {
+    SENT: 'sent',
+    FAILED: 'failed'
+};
+const EMAIL_EVENT_ENTITIES = {
+    MESSAGE: 'email_message',
+    CONFIG: 'emailConfig',
+    TEMPLATE: 'emailTemplate'
+};
+const EMAIL_EVENT_MODULE = 'email';

package/cjs/config/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", {
     value: true
 });
 _export_star(require("./email.constants"), exports);
+_export_star(require("./event-actions"), exports);
 _export_star(require("./message-keys"), exports);
 function _export_star(from, to) {
     Object.keys(from).forEach(function(k) {

package/cjs/config/message-keys.js

@@ -10,6 +10,9 @@ function _export(target, all) {
     });
 }
 _export(exports, {
+    get EMAIL_CONFIG_MESSAGES () {
+        return EMAIL_CONFIG_MESSAGES;
+    },
     get EMAIL_SEND_MESSAGES () {
         return EMAIL_SEND_MESSAGES;
     },
@@ -21,6 +24,9 @@ const EMAIL_TEMPLATE_MESSAGES = {
     GET_SUCCESS: 'email.template.get.success',
     NOT_FOUND: 'email.template.not.found'
 };
+const EMAIL_CONFIG_MESSAGES = {
+    DEFAULT_DELETE_FORBIDDEN: 'email.config.default.delete.forbidden'
+};
 const EMAIL_SEND_MESSAGES = {
     SUCCESS: 'email.send.success',
     FAILED: 'email.send.failed',

package/cjs/modules/email.module.js

@@ -78,6 +78,7 @@ let EmailModule = class EmailModule {
                 useValue: options
             });
         }
+        providers.push((0, _modules.createModuleEventsProvider)('email', _emailconstants.EMAIL_MODULE_OPTIONS));
         return providers;
     }
     static createAsyncProviders(options) {

package/cjs/services/email-provider-config.service.js

@@ -12,6 +12,8 @@ const _classes = require("@flusys/nestjs-shared/classes");
 const _modules = require("@flusys/nestjs-shared/modules");
 const _utils = require("@flusys/nestjs-shared/utils");
 const _common = require("@nestjs/common");
+const _typeorm = require("typeorm");
+const _config = require("../config");
 const _entities = require("../entities");
 const _emailconfigservice = require("./email-config.service");
 const _emaildatasourceprovider = require("./email-datasource.provider");
@@ -46,6 +48,29 @@ let EmailProviderConfigService = class EmailProviderConfigService extends _class
     resolveEntity() {
         return this.emailConfig.isCompanyFeatureEnabled() ? _entities.EmailConfigWithCompany : _entities.EmailConfig;
     }
+    async beforeDeleteOperation(dto, _user, _queryRunner) {
+        const ids = Array.isArray(dto.id) ? dto.id : [
+            dto.id
+        ];
+        await this.ensureDataSourceRepository();
+        const defaultConfigs = await this.repository.find({
+            where: {
+                id: (0, _typeorm.In)(ids),
+                isDefault: true,
+                deletedAt: (0, _typeorm.IsNull)()
+            }
+        });
+        if (defaultConfigs.length > 0) {
+            const names = defaultConfigs.map((c)=>c.name).join(', ');
+            throw new _common.ForbiddenException({
+                message: `Cannot delete the default email config(s): ${names}. Set another config as default first.`,
+                messageKey: _config.EMAIL_CONFIG_MESSAGES.DEFAULT_DELETE_FORBIDDEN,
+                messageVariables: {
+                    names
+                }
+            });
+        }
+    }
     async convertSingleDtoToEntity(dto, user) {
         const entity = {
             ...dto

package/cjs/services/email-provider-config.service.spec.js

@@ -244,4 +244,22 @@ describe('EmailProviderConfigService', ()=>{
             });
         });
     });
+    describe('beforeDeleteOperation', ()=>{
+        it('rejects deleting the default email config', async ()=>{
+            mockRepo.find.mockResolvedValue([
+                buildEmailConfig({
+                    isDefault: true
+                })
+            ]);
+            await expect(service.beforeDeleteOperation({
+                id: 'config-uuid-1'
+            }, null, {})).rejects.toThrow('Cannot delete the default email config');
+        });
+        it('allows deleting a non-default email config', async ()=>{
+            mockRepo.find.mockResolvedValue([]);
+            await expect(service.beforeDeleteOperation({
+                id: 'config-uuid-1'
+            }, null, {})).resolves.toBeUndefined();
+        });
+    });
 });

package/cjs/services/email-send.service.js

@@ -9,10 +9,11 @@ Object.defineProperty(exports, "EmailSendService", {
     }
 });
 const _nestjsshared = require("@flusys/nestjs-shared");
-const _config = require("../config");
+const _classes = require("@flusys/nestjs-shared/classes");
 const _interfaces = require("@flusys/nestjs-shared/interfaces");
 const _utils = require("@flusys/nestjs-shared/utils");
 const _common = require("@nestjs/common");
+const _config = require("../config");
 const _emailconfigservice = require("./email-config.service");
 const _dtos = require("../dtos");
 const _providers = require("../providers");
@@ -51,7 +52,7 @@ let EmailSendService = class EmailSendService {
     async sendEmail(dto, user) {
         const { provider, config } = await this.getEmailProviderWithConfig(dto.emailConfigId, user);
         const sender = this.resolveSender(dto, config);
-        return await provider.sendEmail({
+        const result = await provider.sendEmail({
             to: dto.to,
             cc: dto.cc,
             bcc: dto.bcc,
@@ -62,13 +63,17 @@ let EmailSendService = class EmailSendService {
             replyTo: dto.replyTo,
             attachments: this.buildAttachments(dto.attachments)
         });
+        await this.publishSendEvent(result, dto.to, user, {
+            emailConfigId: config.id
+        });
+        return result;
     }
     async sendTemplateEmail(dto, user) {
         const template = await this.resolveTemplate(dto, user);
         const { subject, html, text } = this.buildTemplateContent(template, dto.variables);
         const { provider, config } = await this.getEmailProviderWithConfig(dto.emailConfigId, user);
         const sender = this.resolveSender(dto, config);
-        return await provider.sendEmail({
+        const result = await provider.sendEmail({
             to: dto.to,
             cc: dto.cc,
             bcc: dto.bcc,
@@ -79,6 +84,12 @@ let EmailSendService = class EmailSendService {
             replyTo: dto.replyTo,
             attachments: this.buildAttachments(dto.attachments)
         });
+        await this.publishSendEvent(result, dto.to, user, {
+            emailConfigId: config.id,
+            templateId: template.id,
+            templateSlug: template.slug
+        });
+        return result;
     }
     async sendTestEmail(emailConfigId, recipient, user) {
         const { provider, config } = await this.getEmailProviderWithConfig(emailConfigId, user);
@@ -94,6 +105,10 @@ let EmailSendService = class EmailSendService {
             from: config.fromEmail || undefined,
             fromName: config.fromName || this.emailConfigService.getDefaultFromName()
         });
+        await this.publishSendEvent(result, recipient, user, {
+            emailConfigId: config.id,
+            isTest: true
+        });
         return result;
     }
     // ─── Private: Provider & Config Resolution ──────────────────────────────────
@@ -137,7 +152,7 @@ let EmailSendService = class EmailSendService {
     }
     // ─── Private: Template Resolution ───────────────────────────────────────────
     async resolveTemplate(dto, user) {
-        let template = null;
+        let template;
         if (dto.templateId) {
             template = await this.emailTemplateService.findByIdDirect(dto.templateId);
         } else if (dto.templateSlug) {
@@ -213,6 +228,27 @@ let EmailSendService = class EmailSendService {
       </div>
     `;
     }
+    async publishSendEvent(result, to, user, metadata) {
+        const recipients = Array.isArray(to) ? to : [
+            to
+        ];
+        await (0, _classes.publishDomainEvent)({
+            module: _config.EMAIL_EVENT_MODULE,
+            entity: _config.EMAIL_EVENT_ENTITIES.MESSAGE,
+            action: result.success ? _config.EMAIL_EVENT_ACTIONS.SENT : _config.EMAIL_EVENT_ACTIONS.FAILED,
+            ids: result.messageId ? [
+                result.messageId
+            ] : [],
+            metadata: {
+                ...metadata,
+                recipientCount: recipients.length,
+                ...result.error ? {
+                    error: result.error
+                } : {}
+            },
+            user: user ?? null
+        });
+    }
     constructor(emailFactory, emailConfigService, emailProviderConfigService, emailTemplateService){
         _define_property(this, "emailFactory", void 0);
         _define_property(this, "emailConfigService", void 0);

package/cjs/services/email-send.service.spec.js

@@ -8,6 +8,7 @@ const _loggedusermock = require("@test-utils/mocks/logged-user.mock");
 const _providers = require("../providers");
 const _emailconfigservice = require("./email-config.service");
 const _emailproviderconfigservice = require("./email-provider-config.service");
+const _classes = require("@flusys/nestjs-shared/classes");
 const _emailsendservice = require("./email-send.service");
 const _emailtemplateservice = require("./email-template.service");
 function buildConfig(overrides = {}) {
@@ -543,4 +544,71 @@ describe('EmailSendService', ()=>{
             expect(payload.html).not.toContain('<script>alert(1)</script>');
         });
     });
+    describe('domain events', ()=>{
+        let publish;
+        beforeEach(()=>{
+            publish = jest.fn().mockResolvedValue(undefined);
+            _classes.EventBusRegistry.reset();
+            _classes.EventBusRegistry.setBus({
+                publish,
+                subscribe: jest.fn(),
+                close: jest.fn()
+            });
+            _classes.EventBusRegistry.configureModule('email', {
+                enabled: true
+            });
+            mockEmailProviderConfigService.findByIdDirect.mockResolvedValue(buildConfig());
+        });
+        afterEach(()=>{
+            _classes.EventBusRegistry.reset();
+        });
+        it('publishes email.email_message.sent for a successful send', async ()=>{
+            await service.sendEmail({
+                to: 'user@example.com',
+                subject: 'Hi',
+                emailConfigId: 'config-uuid-1'
+            }, (0, _loggedusermock.buildMockUser)());
+            expect(publish).toHaveBeenCalledWith(expect.objectContaining({
+                name: 'email.email_message.sent',
+                payload: expect.objectContaining({
+                    ids: [
+                        'msg-1'
+                    ],
+                    metadata: expect.objectContaining({
+                        recipientCount: 1
+                    })
+                })
+            }));
+        });
+        it('publishes email.email_message.failed when the provider reports a failure', async ()=>{
+            mockProvider.sendEmail.mockResolvedValue({
+                success: false,
+                error: 'smtp refused'
+            });
+            await service.sendEmail({
+                to: 'user@example.com',
+                subject: 'Hi',
+                emailConfigId: 'config-uuid-1'
+            }, (0, _loggedusermock.buildMockUser)());
+            expect(publish).toHaveBeenCalledWith(expect.objectContaining({
+                name: 'email.email_message.failed',
+                payload: expect.objectContaining({
+                    metadata: expect.objectContaining({
+                        error: 'smtp refused'
+                    })
+                })
+            }));
+        });
+        it('does not publish when the email module has events disabled', async ()=>{
+            _classes.EventBusRegistry.configureModule('email', {
+                enabled: false
+            });
+            await service.sendEmail({
+                to: 'user@example.com',
+                subject: 'Hi',
+                emailConfigId: 'config-uuid-1'
+            }, (0, _loggedusermock.buildMockUser)());
+            expect(publish).not.toHaveBeenCalled();
+        });
+    });
 });

package/config/event-actions.d.ts

@@ -0,0 +1,10 @@
+export declare const EMAIL_EVENT_ACTIONS: {
+    readonly SENT: "sent";
+    readonly FAILED: "failed";
+};
+export declare const EMAIL_EVENT_ENTITIES: {
+    readonly MESSAGE: "email_message";
+    readonly CONFIG: "emailConfig";
+    readonly TEMPLATE: "emailTemplate";
+};
+export declare const EMAIL_EVENT_MODULE = "email";

package/config/index.d.ts

@@ -1,2 +1,3 @@
 export * from './email.constants';
+export * from './event-actions';
 export * from './message-keys';

package/config/message-keys.d.ts

@@ -2,6 +2,9 @@ export declare const EMAIL_TEMPLATE_MESSAGES: {
     readonly GET_SUCCESS: "email.template.get.success";
     readonly NOT_FOUND: "email.template.not.found";
 };
+export declare const EMAIL_CONFIG_MESSAGES: {
+    readonly DEFAULT_DELETE_FORBIDDEN: "email.config.default.delete.forbidden";
+};
 export declare const EMAIL_SEND_MESSAGES: {
     readonly SUCCESS: "email.send.success";
     readonly FAILED: "email.send.failed";

package/fesm/config/event-actions.js

@@ -0,0 +1,13 @@
+/**
+ * Domain event actions published by the email module, alongside the CRUD
+ * lifecycle actions every ApiService emits.
+ */ export const EMAIL_EVENT_ACTIONS = {
+    SENT: 'sent',
+    FAILED: 'failed'
+};
+/** Every entity the email module publishes under, ApiService backed or not */ export const EMAIL_EVENT_ENTITIES = {
+    MESSAGE: 'email_message',
+    CONFIG: 'emailConfig',
+    TEMPLATE: 'emailTemplate'
+};
+export const EMAIL_EVENT_MODULE = 'email';

package/fesm/config/index.js

@@ -1,2 +1,3 @@
 export * from './email.constants';
+export * from './event-actions';
 export * from './message-keys';

package/fesm/config/message-keys.js

@@ -3,6 +3,9 @@ export const EMAIL_TEMPLATE_MESSAGES = {
     GET_SUCCESS: 'email.template.get.success',
     NOT_FOUND: 'email.template.not.found'
 };
+export const EMAIL_CONFIG_MESSAGES = {
+    DEFAULT_DELETE_FORBIDDEN: 'email.config.default.delete.forbidden'
+};
 export const EMAIL_SEND_MESSAGES = {
     SUCCESS: 'email.send.success',
     FAILED: 'email.send.failed',

package/fesm/modules/email.module.js

@@ -4,7 +4,7 @@ function _ts_decorate(decorators, target, key, desc) {
     else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-import { CacheModule, UtilsModule } from '@flusys/nestjs-shared/modules';
+import { CacheModule, UtilsModule, createModuleEventsProvider } from '@flusys/nestjs-shared/modules';
 import { Module } from '@nestjs/common';
 import { EMAIL_MODULE_OPTIONS } from '../config/email.constants';
 import { EmailConfigController, EmailSendController, EmailTemplateController } from '../controllers';
@@ -68,6 +68,7 @@ export class EmailModule {
                 useValue: options
             });
         }
+        providers.push(createModuleEventsProvider('email', EMAIL_MODULE_OPTIONS));
         return providers;
     }
     static createAsyncProviders(options) {

package/fesm/services/email-provider-config.service.js

@@ -28,7 +28,9 @@ function _ts_param(paramIndex, decorator) {
 import { HybridCache, ApiService } from '@flusys/nestjs-shared/classes';
 import { UtilsService } from '@flusys/nestjs-shared/modules';
 import { applyCompanyFilter, buildCompanyWhereCondition } from '@flusys/nestjs-shared/utils';
-import { Inject, Injectable, Scope } from '@nestjs/common';
+import { ForbiddenException, Inject, Injectable, Scope } from '@nestjs/common';
+import { In, IsNull } from 'typeorm';
+import { EMAIL_CONFIG_MESSAGES } from '../config';
 import { EmailConfig, EmailConfigWithCompany } from '../entities';
 import { EmailConfigService } from './email-config.service';
 import { EmailDataSourceProvider } from './email-datasource.provider';
@@ -36,6 +38,29 @@ export class EmailProviderConfigService extends ApiService {
     resolveEntity() {
         return this.emailConfig.isCompanyFeatureEnabled() ? EmailConfigWithCompany : EmailConfig;
     }
+    async beforeDeleteOperation(dto, _user, _queryRunner) {
+        const ids = Array.isArray(dto.id) ? dto.id : [
+            dto.id
+        ];
+        await this.ensureDataSourceRepository();
+        const defaultConfigs = await this.repository.find({
+            where: {
+                id: In(ids),
+                isDefault: true,
+                deletedAt: IsNull()
+            }
+        });
+        if (defaultConfigs.length > 0) {
+            const names = defaultConfigs.map((c)=>c.name).join(', ');
+            throw new ForbiddenException({
+                message: `Cannot delete the default email config(s): ${names}. Set another config as default first.`,
+                messageKey: EMAIL_CONFIG_MESSAGES.DEFAULT_DELETE_FORBIDDEN,
+                messageVariables: {
+                    names
+                }
+            });
+        }
+    }
     async convertSingleDtoToEntity(dto, user) {
         const entity = {
             ...dto

package/fesm/services/email-provider-config.service.spec.js

@@ -240,4 +240,22 @@ describe('EmailProviderConfigService', ()=>{
             });
         });
     });
+    describe('beforeDeleteOperation', ()=>{
+        it('rejects deleting the default email config', async ()=>{
+            mockRepo.find.mockResolvedValue([
+                buildEmailConfig({
+                    isDefault: true
+                })
+            ]);
+            await expect(service.beforeDeleteOperation({
+                id: 'config-uuid-1'
+            }, null, {})).rejects.toThrow('Cannot delete the default email config');
+        });
+        it('allows deleting a non-default email config', async ()=>{
+            mockRepo.find.mockResolvedValue([]);
+            await expect(service.beforeDeleteOperation({
+                id: 'config-uuid-1'
+            }, null, {})).resolves.toBeUndefined();
+        });
+    });
 });

package/fesm/services/email-send.service.js

@@ -26,10 +26,11 @@ function _ts_param(paramIndex, decorator) {
     };
 }
 import { LogAction } from '@flusys/nestjs-shared';
-import { EMAIL_SEND_MESSAGES } from '../config';
+import { publishDomainEvent } from '@flusys/nestjs-shared/classes';
 import { ILoggedUserInfo } from '@flusys/nestjs-shared/interfaces';
 import { escapeHtmlVariables, validateCompanyOwnership } from '@flusys/nestjs-shared/utils';
 import { BadRequestException, Inject, Injectable, NotFoundException, Scope } from '@nestjs/common';
+import { EMAIL_EVENT_ACTIONS, EMAIL_EVENT_ENTITIES, EMAIL_EVENT_MODULE, EMAIL_SEND_MESSAGES } from '../config';
 import { EmailConfigService } from './email-config.service';
 import { SendEmailDto, SendTemplateEmailDto } from '../dtos';
 import { EmailFactoryService } from '../providers';
@@ -41,7 +42,7 @@ export class EmailSendService {
     async sendEmail(dto, user) {
         const { provider, config } = await this.getEmailProviderWithConfig(dto.emailConfigId, user);
         const sender = this.resolveSender(dto, config);
-        return await provider.sendEmail({
+        const result = await provider.sendEmail({
             to: dto.to,
             cc: dto.cc,
             bcc: dto.bcc,
@@ -52,13 +53,17 @@ export class EmailSendService {
             replyTo: dto.replyTo,
             attachments: this.buildAttachments(dto.attachments)
         });
+        await this.publishSendEvent(result, dto.to, user, {
+            emailConfigId: config.id
+        });
+        return result;
     }
     async sendTemplateEmail(dto, user) {
         const template = await this.resolveTemplate(dto, user);
         const { subject, html, text } = this.buildTemplateContent(template, dto.variables);
         const { provider, config } = await this.getEmailProviderWithConfig(dto.emailConfigId, user);
         const sender = this.resolveSender(dto, config);
-        return await provider.sendEmail({
+        const result = await provider.sendEmail({
             to: dto.to,
             cc: dto.cc,
             bcc: dto.bcc,
@@ -69,6 +74,12 @@ export class EmailSendService {
             replyTo: dto.replyTo,
             attachments: this.buildAttachments(dto.attachments)
         });
+        await this.publishSendEvent(result, dto.to, user, {
+            emailConfigId: config.id,
+            templateId: template.id,
+            templateSlug: template.slug
+        });
+        return result;
     }
     async sendTestEmail(emailConfigId, recipient, user) {
         const { provider, config } = await this.getEmailProviderWithConfig(emailConfigId, user);
@@ -84,6 +95,10 @@ export class EmailSendService {
             from: config.fromEmail || undefined,
             fromName: config.fromName || this.emailConfigService.getDefaultFromName()
         });
+        await this.publishSendEvent(result, recipient, user, {
+            emailConfigId: config.id,
+            isTest: true
+        });
         return result;
     }
     // ─── Private: Provider & Config Resolution ──────────────────────────────────
@@ -127,7 +142,7 @@ export class EmailSendService {
     }
     // ─── Private: Template Resolution ───────────────────────────────────────────
     async resolveTemplate(dto, user) {
-        let template = null;
+        let template;
         if (dto.templateId) {
             template = await this.emailTemplateService.findByIdDirect(dto.templateId);
         } else if (dto.templateSlug) {
@@ -203,6 +218,27 @@ export class EmailSendService {
       </div>
     `;
     }
+    async publishSendEvent(result, to, user, metadata) {
+        const recipients = Array.isArray(to) ? to : [
+            to
+        ];
+        await publishDomainEvent({
+            module: EMAIL_EVENT_MODULE,
+            entity: EMAIL_EVENT_ENTITIES.MESSAGE,
+            action: result.success ? EMAIL_EVENT_ACTIONS.SENT : EMAIL_EVENT_ACTIONS.FAILED,
+            ids: result.messageId ? [
+                result.messageId
+            ] : [],
+            metadata: {
+                ...metadata,
+                recipientCount: recipients.length,
+                ...result.error ? {
+                    error: result.error
+                } : {}
+            },
+            user: user ?? null
+        });
+    }
     constructor(emailFactory, emailConfigService, emailProviderConfigService, emailTemplateService){
         _define_property(this, "emailFactory", void 0);
         _define_property(this, "emailConfigService", void 0);

package/fesm/services/email-send.service.spec.js

@@ -4,6 +4,7 @@ import { buildMockUser } from '@test-utils/mocks/logged-user.mock';
 import { EmailFactoryService } from '../providers';
 import { EmailConfigService } from './email-config.service';
 import { EmailProviderConfigService } from './email-provider-config.service';
+import { EventBusRegistry } from '@flusys/nestjs-shared/classes';
 import { EmailSendService } from './email-send.service';
 import { EmailTemplateService } from './email-template.service';
 function buildConfig(overrides = {}) {
@@ -539,4 +540,71 @@ describe('EmailSendService', ()=>{
             expect(payload.html).not.toContain('<script>alert(1)</script>');
         });
     });
+    describe('domain events', ()=>{
+        let publish;
+        beforeEach(()=>{
+            publish = jest.fn().mockResolvedValue(undefined);
+            EventBusRegistry.reset();
+            EventBusRegistry.setBus({
+                publish,
+                subscribe: jest.fn(),
+                close: jest.fn()
+            });
+            EventBusRegistry.configureModule('email', {
+                enabled: true
+            });
+            mockEmailProviderConfigService.findByIdDirect.mockResolvedValue(buildConfig());
+        });
+        afterEach(()=>{
+            EventBusRegistry.reset();
+        });
+        it('publishes email.email_message.sent for a successful send', async ()=>{
+            await service.sendEmail({
+                to: 'user@example.com',
+                subject: 'Hi',
+                emailConfigId: 'config-uuid-1'
+            }, buildMockUser());
+            expect(publish).toHaveBeenCalledWith(expect.objectContaining({
+                name: 'email.email_message.sent',
+                payload: expect.objectContaining({
+                    ids: [
+                        'msg-1'
+                    ],
+                    metadata: expect.objectContaining({
+                        recipientCount: 1
+                    })
+                })
+            }));
+        });
+        it('publishes email.email_message.failed when the provider reports a failure', async ()=>{
+            mockProvider.sendEmail.mockResolvedValue({
+                success: false,
+                error: 'smtp refused'
+            });
+            await service.sendEmail({
+                to: 'user@example.com',
+                subject: 'Hi',
+                emailConfigId: 'config-uuid-1'
+            }, buildMockUser());
+            expect(publish).toHaveBeenCalledWith(expect.objectContaining({
+                name: 'email.email_message.failed',
+                payload: expect.objectContaining({
+                    metadata: expect.objectContaining({
+                        error: 'smtp refused'
+                    })
+                })
+            }));
+        });
+        it('does not publish when the email module has events disabled', async ()=>{
+            EventBusRegistry.configureModule('email', {
+                enabled: false
+            });
+            await service.sendEmail({
+                to: 'user@example.com',
+                subject: 'Hi',
+                emailConfigId: 'config-uuid-1'
+            }, buildMockUser());
+            expect(publish).not.toHaveBeenCalled();
+        });
+    });
 });

package/interfaces/email-module-options.interface.d.ts

@@ -1,9 +1,11 @@
 import { IBootstrapAppConfig, IDataSourceServiceOptions, IDynamicModuleConfig, IModuleOptionsFactory } from '@flusys/nestjs-core';
+import { IModuleEventsConfig } from '@flusys/nestjs-shared/interfaces';
 import { ModuleMetadata, Type } from '@nestjs/common';
 export interface IEmailModuleConfig extends IDataSourceServiceOptions {
     defaultProvider?: string;
     rateLimitPerMinute?: number;
     enableLogging?: boolean;
+    events?: IModuleEventsConfig;
 }
 export interface EmailModuleOptions extends IDynamicModuleConfig {
     bootstrapAppConfig?: IBootstrapAppConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flusys/nestjs-email",
-  "version": "6.4.0",
+  "version": "7.0.0-beta.1",
   "description": "Modular email package with SMTP, SendGrid, and Mailgun providers",
   "main": "cjs/index.js",
   "module": "fesm/index.js",
@@ -105,7 +105,7 @@
     }
   },
   "dependencies": {
-    "@flusys/nestjs-core": "6.4.0",
-    "@flusys/nestjs-shared": "6.4.0"
+    "@flusys/nestjs-core": "7.0.0-beta.1",
+    "@flusys/nestjs-shared": "7.0.0-beta.1"
   }
 }

package/services/email-provider-config.service.d.ts

@@ -1,8 +1,8 @@
 import { HybridCache, ApiService } from '@flusys/nestjs-shared/classes';
-import { FilterAndPaginationDto } from '@flusys/nestjs-shared/dtos';
+import { DeleteDto, FilterAndPaginationDto } from '@flusys/nestjs-shared/dtos';
 import { ILoggedUserInfo } from '@flusys/nestjs-shared/interfaces';
 import { UtilsService } from '@flusys/nestjs-shared/modules';
-import { EntityTarget, SelectQueryBuilder } from 'typeorm';
+import { EntityTarget, QueryRunner, SelectQueryBuilder } from 'typeorm';
 import { CreateEmailConfigDto, UpdateEmailConfigDto } from '../dtos';
 import { EmailConfig, EmailConfigBase } from '../entities';
 import { IEmailConfig } from '../interfaces';
@@ -14,6 +14,7 @@ export declare class EmailProviderConfigService extends ApiService<CreateEmailCo
     private readonly emailConfig;
     constructor(cacheManager: HybridCache, utilsService: UtilsService, emailConfig: EmailConfigService, dataSourceProvider: EmailDataSourceProvider);
     protected resolveEntity(): EntityTarget<EmailConfigBase>;
+    protected beforeDeleteOperation(dto: DeleteDto, _user: ILoggedUserInfo | null, _queryRunner: QueryRunner): Promise<void>;
     convertSingleDtoToEntity(dto: CreateEmailConfigDto | UpdateEmailConfigDto, user: ILoggedUserInfo | null): Promise<EmailConfigBase>;
     getSelectQuery(query: SelectQueryBuilder<EmailConfigBase>, _user: ILoggedUserInfo | null, select?: string[]): Promise<{
         query: SelectQueryBuilder<EmailConfig>;

package/services/email-send.service.d.ts

@@ -23,4 +23,5 @@ export declare class EmailSendService {
     private buildAttachments;
     private interpolateVariables;
     private buildTestEmailHtml;
+    private publishSendEvent;
 }