@flusys/nestjs-email 3.0.0 → 4.0.0-rc

package/README.md

@@ -1,7 +1,7 @@
 # Email Package Guide
 
 > **Package:** `@flusys/nestjs-email`
-> **Version:** 3.0.0
+> **Version:** 3.0.1
 > **Type:** Email sending with templates, multiple providers, and multi-tenant support
 
 ## Table of Contents

package/cjs/config/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", {
     value: true
 });
 _export_star(require("./email.constants"), exports);
+_export_star(require("./message-keys"), exports);
 function _export_star(from, to) {
     Object.keys(from).forEach(function(k) {
         if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {

package/cjs/config/message-keys.js

@@ -0,0 +1,70 @@
+// ==================== EMAIL MODULE MESSAGE KEYS ====================
+"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_CONFIG_MESSAGES () {
+        return EMAIL_CONFIG_MESSAGES;
+    },
+    get EMAIL_MODULE_MESSAGES () {
+        return EMAIL_MODULE_MESSAGES;
+    },
+    get EMAIL_SEND_MESSAGES () {
+        return EMAIL_SEND_MESSAGES;
+    },
+    get EMAIL_TEMPLATE_MESSAGES () {
+        return EMAIL_TEMPLATE_MESSAGES;
+    }
+});
+const EMAIL_CONFIG_MESSAGES = {
+    CREATE_SUCCESS: 'email.config.create.success',
+    CREATE_MANY_SUCCESS: 'email.config.create.many.success',
+    GET_SUCCESS: 'email.config.get.success',
+    GET_ALL_SUCCESS: 'email.config.get.all.success',
+    UPDATE_SUCCESS: 'email.config.update.success',
+    UPDATE_MANY_SUCCESS: 'email.config.update.many.success',
+    DELETE_SUCCESS: 'email.config.delete.success',
+    RESTORE_SUCCESS: 'email.config.restore.success',
+    NOT_FOUND: 'email.config.not.found',
+    ACTIVE_SUCCESS: 'email.config.active.success',
+    TEST_SUCCESS: 'email.config.test.success',
+    TEST_FAILED: 'email.config.test.failed'
+};
+const EMAIL_TEMPLATE_MESSAGES = {
+    CREATE_SUCCESS: 'email.template.create.success',
+    CREATE_MANY_SUCCESS: 'email.template.create.many.success',
+    GET_SUCCESS: 'email.template.get.success',
+    GET_ALL_SUCCESS: 'email.template.get.all.success',
+    UPDATE_SUCCESS: 'email.template.update.success',
+    UPDATE_MANY_SUCCESS: 'email.template.update.many.success',
+    DELETE_SUCCESS: 'email.template.delete.success',
+    RESTORE_SUCCESS: 'email.template.restore.success',
+    NOT_FOUND: 'email.template.not.found',
+    PREVIEW_SUCCESS: 'email.template.preview.success'
+};
+const EMAIL_SEND_MESSAGES = {
+    SUCCESS: 'email.send.success',
+    FAILED: 'email.send.failed',
+    QUEUED: 'email.send.queued',
+    TEMPLATE_SUCCESS: 'email.send.template.success',
+    BULK_SUCCESS: 'email.send.bulk.success',
+    TEST_SUCCESS: 'email.send.test.success',
+    CONFIG_NOT_FOUND: 'email.send.config.not.found',
+    CONFIG_INACTIVE: 'email.send.config.inactive',
+    CONFIG_DEFAULT_NOT_FOUND: 'email.send.config.default.not.found',
+    TEMPLATE_NOT_FOUND: 'email.send.template.not.found',
+    TEMPLATE_INACTIVE: 'email.send.template.inactive',
+    TEMPLATE_ID_OR_SLUG_REQUIRED: 'email.send.template.id.or.slug.required'
+};
+const EMAIL_MODULE_MESSAGES = {
+    EMAIL_CONFIG: EMAIL_CONFIG_MESSAGES,
+    EMAIL_TEMPLATE: EMAIL_TEMPLATE_MESSAGES,
+    EMAIL_SEND: EMAIL_SEND_MESSAGES
+};

package/cjs/controllers/email-config.controller.js

@@ -41,6 +41,7 @@ function _ts_param(paramIndex, decorator) {
     };
 }
 let EmailConfigController = class EmailConfigController extends (0, _classes.createApiController)(_dtos.CreateEmailConfigDto, _dtos.UpdateEmailConfigDto, _dtos.EmailConfigResponseDto, {
+    entityName: 'emailConfig',
     security: {
         insert: {
             level: 'permission',

package/cjs/controllers/email-send.controller.js

@@ -8,6 +8,7 @@ Object.defineProperty(exports, "EmailSendController", {
         return EmailSendController;
     }
 });
+const _config = require("../config");
 const _decorators = require("@flusys/nestjs-shared/decorators");
 const _guards = require("@flusys/nestjs-shared/guards");
 const _interfaces = require("@flusys/nestjs-shared/interfaces");
@@ -59,6 +60,7 @@ let EmailSendController = class EmailSendController {
         return {
             success: result.success,
             message: result.success ? `${label} sent successfully` : `Failed to send ${label.toLowerCase()}`,
+            messageKey: result.success ? _config.EMAIL_SEND_MESSAGES.SUCCESS : _config.EMAIL_SEND_MESSAGES.FAILED,
             data: {
                 success: result.success,
                 messageId: result.messageId,

package/cjs/controllers/email-template.controller.js

@@ -9,6 +9,7 @@ Object.defineProperty(exports, "EmailTemplateController", {
     }
 });
 const _classes = require("@flusys/nestjs-shared/classes");
+const _config = require("../config");
 const _decorators = require("@flusys/nestjs-shared/decorators");
 const _guards = require("@flusys/nestjs-shared/guards");
 const _interfaces = require("@flusys/nestjs-shared/interfaces");
@@ -44,6 +45,7 @@ function _ts_param(paramIndex, decorator) {
     };
 }
 let EmailTemplateController = class EmailTemplateController extends (0, _classes.createApiController)(_dtos.CreateEmailTemplateDto, _dtos.UpdateEmailTemplateDto, _dtos.EmailTemplateResponseDto, {
+    entityName: 'emailTemplate',
     security: {
         insert: {
             level: 'permission',
@@ -94,6 +96,7 @@ let EmailTemplateController = class EmailTemplateController extends (0, _classes
         return {
             success: true,
             message: 'Template retrieved',
+            messageKey: _config.EMAIL_TEMPLATE_MESSAGES.GET_SUCCESS,
             data: data ?? undefined
         };
     }

package/cjs/modules/email.module.js

@@ -21,7 +21,6 @@ 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;
 }
-const logger = new _common.Logger('EmailModule');
 const CONTROLLERS = [
     _controllers.EmailConfigController,
     _controllers.EmailTemplateController,
@@ -38,7 +37,6 @@ const EXPORTED_SERVICES = [
 _providers.EmailProviderRegistry.register(_enums.EmailProviderTypeEnum.SMTP, _providers.SmtpProvider);
 _providers.EmailProviderRegistry.register(_enums.EmailProviderTypeEnum.SENDGRID, _providers.SendGridProvider);
 _providers.EmailProviderRegistry.register(_enums.EmailProviderTypeEnum.MAILGUN, _providers.MailgunProvider);
-logger.log('Registered built-in email providers: SMTP, SendGrid, Mailgun');
 let EmailModule = class EmailModule {
     static forRoot(options) {
         return {

package/cjs/providers/email-factory.service.js

@@ -8,8 +8,11 @@ Object.defineProperty(exports, "EmailFactoryService", {
         return EmailFactoryService;
     }
 });
+const _nestjsshared = require("@flusys/nestjs-shared");
+const _config = require("../config");
 const _common = require("@nestjs/common");
 const _crypto = require("crypto");
+const _interfaces = require("../interfaces");
 const _emailproviderregistry = require("./email-provider.registry");
 function _define_property(obj, key, value) {
     if (key in obj) {
@@ -30,6 +33,9 @@ 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;
 }
+function _ts_metadata(k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
 let EmailFactoryService = class EmailFactoryService {
     // ─── Public API ─────────────────────────────────────────────────────────────
     async createProvider(config) {
@@ -38,26 +44,36 @@ let EmailFactoryService = class EmailFactoryService {
         if (cached) return cached;
         const ProviderClass = _emailproviderregistry.EmailProviderRegistry.get(config.provider);
         if (!ProviderClass) {
-            throw new _common.NotFoundException(`Email provider '${config.provider}' is not registered. Available: ${_emailproviderregistry.EmailProviderRegistry.getAll().join(', ')}`);
+            throw new _common.NotFoundException({
+                message: `Email provider '${config.provider}' is not registered`,
+                messageKey: _config.EMAIL_SEND_MESSAGES.CONFIG_NOT_FOUND,
+                messageParams: {
+                    provider: config.provider,
+                    available: _emailproviderregistry.EmailProviderRegistry.getAll().join(', ')
+                }
+            });
         }
         try {
             const instance = new ProviderClass();
             await instance.initialize?.(config.config);
             this.providerCache.set(cacheKey, instance);
-            this.logger.log(`Created email provider: ${config.provider} (key: ${cacheKey})`);
             return instance;
         } catch (error) {
-            this.logger.error(`Failed to create provider ${config.provider}:`, error);
-            throw new _common.InternalServerErrorException(`Failed to initialize email provider '${config.provider}': ${this.extractErrorMessage(error)}`);
+            throw new _common.InternalServerErrorException({
+                message: `Failed to initialize email provider '${config.provider}'`,
+                messageKey: _nestjsshared.SYSTEM_MESSAGES.SERVICE_NOT_AVAILABLE,
+                messageParams: {
+                    provider: config.provider,
+                    error: this.extractErrorMessage(error)
+                }
+            });
         }
     }
     // ─── Lifecycle ──────────────────────────────────────────────────────────────
     async onModuleDestroy() {
-        this.logger.log('Cleaning up email provider connections...');
-        const closePromises = Array.from(this.providerCache.entries()).map(([key, provider])=>this.closeProvider(key, provider));
+        const closePromises = Array.from(this.providerCache.entries()).map(([, provider])=>this.closeProvider(provider));
         await Promise.allSettled(closePromises);
         this.providerCache.clear();
-        this.logger.log('Email provider cleanup complete');
     }
     // ─── Private Helpers ────────────────────────────────────────────────────────
     generateCacheKey(config) {
@@ -66,23 +82,32 @@ let EmailFactoryService = class EmailFactoryService {
         const hash = (0, _crypto.createHash)('sha256').update(configString).digest('hex').substring(0, 16);
         return `${config.provider}-${hash}`;
     }
-    async closeProvider(key, provider) {
+    async closeProvider(provider) {
         if (!provider.close) return;
         try {
             await provider.close();
-            this.logger.debug(`Closed provider: ${key}`);
-        } catch (err) {
-            this.logger.warn(`Failed to close provider ${key}: ${this.extractErrorMessage(err)}`);
+        } catch  {
+        // Silent failure
         }
     }
     extractErrorMessage(error) {
         return error instanceof Error ? error.message : 'Unknown error';
     }
     constructor(){
-        _define_property(this, "logger", new _common.Logger(EmailFactoryService.name));
         _define_property(this, "providerCache", new Map());
     }
 };
+_ts_decorate([
+    (0, _nestjsshared.LogAction)({
+        action: 'email.createProvider',
+        module: 'email'
+    }),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof _interfaces.IEmailProviderConfig === "undefined" ? Object : _interfaces.IEmailProviderConfig
+    ]),
+    _ts_metadata("design:returntype", Promise)
+], EmailFactoryService.prototype, "createProvider", null);
 EmailFactoryService = _ts_decorate([
     (0, _common.Injectable)()
 ], EmailFactoryService);

package/cjs/providers/mailgun-provider.js

@@ -9,6 +9,7 @@ Object.defineProperty(exports, "MailgunProvider", {
     }
 });
 const _common = require("@nestjs/common");
+const _constants = require("@flusys/nestjs-shared/constants");
 function _define_property(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
@@ -38,10 +39,11 @@ let MailgunProvider = class MailgunProvider {
                 key: config.apiKey,
                 url
             });
-            this.logger.log(`Mailgun Provider initialized for domain: ${config.domain}`);
-        } catch (error) {
-            this.logger.error('Failed to initialize Mailgun:', this.extractError(error));
-            throw new Error('Mailgun initialization failed. Install: npm install mailgun.js form-data');
+        } catch  {
+            throw new _common.InternalServerErrorException({
+                message: 'Mailgun initialization failed. Install: npm install mailgun.js form-data',
+                messageKey: _constants.SYSTEM_MESSAGES.SDK_NOT_INSTALLED
+            });
         }
     }
     async sendEmail(options) {
@@ -54,13 +56,15 @@ let MailgunProvider = class MailgunProvider {
         try {
             const messageData = this.buildMessageData(options);
             const result = await this.client.messages.create(this.domain, messageData);
-            this.logger.log(`Email sent via Mailgun: ${result.id}`);
             return {
                 success: true,
                 messageId: result.id
             };
         } catch (error) {
-            return this.handleError('Mailgun send failed', error);
+            return {
+                success: false,
+                error: this.extractError(error)
+            };
         }
     }
     async sendBulkEmails(options) {
@@ -105,16 +109,7 @@ let MailgunProvider = class MailgunProvider {
     extractError(error) {
         return error instanceof Error ? error.message : 'Unknown error';
     }
-    handleError(context, error) {
-        const message = this.extractError(error);
-        this.logger.error(`${context}: ${message}`, error);
-        return {
-            success: false,
-            error: message
-        };
-    }
     constructor(){
-        _define_property(this, "logger", new _common.Logger(MailgunProvider.name));
         _define_property(this, "client", null);
         _define_property(this, "domain", null);
     }

package/cjs/providers/sendgrid-provider.js

@@ -9,6 +9,7 @@ Object.defineProperty(exports, "SendGridProvider", {
     }
 });
 const _common = require("@nestjs/common");
+const _constants = require("@flusys/nestjs-shared/constants");
 function _define_property(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
@@ -30,10 +31,11 @@ let SendGridProvider = class SendGridProvider {
             const sgMailModule = await new Function('return import("@sendgrid/mail")')();
             this.sgMail = sgMailModule.default || sgMailModule;
             this.sgMail.setApiKey(config.apiKey);
-            this.logger.log('SendGrid Provider initialized');
-        } catch (error) {
-            this.logger.error('Failed to initialize SendGrid:', this.extractError(error));
-            throw new Error('SendGrid initialization failed. Install: npm install @sendgrid/mail');
+        } catch  {
+            throw new _common.InternalServerErrorException({
+                message: 'SendGrid initialization failed. Install: npm install @sendgrid/mail',
+                messageKey: _constants.SYSTEM_MESSAGES.SDK_NOT_INSTALLED
+            });
         }
     }
     async sendEmail(options) {
@@ -45,13 +47,15 @@ let SendGridProvider = class SendGridProvider {
             const msg = this.buildMessage(options, true);
             const [response] = await this.sgMail.send(msg);
             const messageId = response.headers['x-message-id'] || response.headers['X-Message-Id'];
-            this.logger.log(`Email sent via SendGrid: ${messageId}`);
             return {
                 success: true,
                 messageId
             };
         } catch (error) {
-            return this.handleError('SendGrid send failed', error);
+            return {
+                success: false,
+                error: this.extractError(error)
+            };
         }
     }
     async sendBulkEmails(options) {
@@ -66,7 +70,6 @@ let SendGridProvider = class SendGridProvider {
                     success: true
                 }));
         } catch (error) {
-            this.logger.error('SendGrid bulk send failed:', error);
             const errorMessage = this.extractError(error);
             return options.map(()=>({
                     success: false,
@@ -116,16 +119,7 @@ let SendGridProvider = class SendGridProvider {
         const sgError = error;
         return sgError.response?.body?.errors?.[0]?.message || sgError.message || 'Unknown error';
     }
-    handleError(context, error) {
-        const message = this.extractError(error);
-        this.logger.error(`${context}: ${message}`, error);
-        return {
-            success: false,
-            error: message
-        };
-    }
     constructor(){
-        _define_property(this, "logger", new _common.Logger(SendGridProvider.name));
         _define_property(this, "sgMail", null);
         _define_property(this, "apiKey", null);
     }

package/cjs/providers/smtp-provider.js

@@ -8,7 +8,6 @@ Object.defineProperty(exports, "SmtpProvider", {
         return SmtpProvider;
     }
 });
-const _common = require("@nestjs/common");
 function _define_property(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
@@ -67,7 +66,6 @@ const VERIFY_TIMEOUT_MS = 10_000;
 const SEND_TIMEOUT_MS = 30_000;
 let SmtpProvider = class SmtpProvider {
     async initialize(config) {
-        this.logger.log(`Initializing SMTP: host=${config.host}, port=${config.port}`);
         const nodemailer = await Promise.resolve().then(()=>/*#__PURE__*/ _interop_require_wildcard(require("nodemailer")));
         this.transporter = nodemailer.createTransport({
             host: config.host,
@@ -82,7 +80,7 @@ let SmtpProvider = class SmtpProvider {
                 minVersion: config.tls?.minVersion ?? 'TLSv1.2'
             }
         });
-        await this.verifyConnection(config);
+        await this.verifyConnection();
     }
     async sendEmail(options) {
         if (!this.transporter) return {
@@ -107,13 +105,15 @@ let SmtpProvider = class SmtpProvider {
                     }))
             };
             const info = await this.withTimeout(this.transporter.sendMail(mailOptions), SEND_TIMEOUT_MS, 'SMTP send timeout');
-            this.logger.log(`Email sent via SMTP: ${info.messageId}`);
             return {
                 success: true,
                 messageId: info.messageId
             };
         } catch (error) {
-            return this.handleError('SMTP send failed', error);
+            return {
+                success: false,
+                error: this.extractError(error)
+            };
         }
     }
     async sendBulkEmails(options) {
@@ -135,13 +135,8 @@ let SmtpProvider = class SmtpProvider {
         }
     }
     // ─── Private Helpers ────────────────────────────────────────────────────────
-    async verifyConnection(config) {
-        try {
-            await this.withTimeout(this.transporter.verify(), VERIFY_TIMEOUT_MS, 'SMTP verification timeout');
-            this.logger.log(`SMTP Provider verified: ${config.host}:${config.port}`);
-        } catch (error) {
-            this.logger.warn(`SMTP verification failed: ${this.extractError(error)}`);
-        }
+    async verifyConnection() {
+        await this.withTimeout(this.transporter.verify(), VERIFY_TIMEOUT_MS, 'SMTP verification timeout');
     }
     formatFrom(from, fromName) {
         return fromName ? `"${fromName}" <${from}>` : from;
@@ -159,16 +154,7 @@ let SmtpProvider = class SmtpProvider {
     extractError(error) {
         return error instanceof Error ? error.message : 'Unknown error';
     }
-    handleError(context, error) {
-        const message = this.extractError(error);
-        this.logger.error(`${context}: ${message}`, error instanceof Error ? error.stack : undefined);
-        return {
-            success: false,
-            error: message
-        };
-    }
     constructor(){
-        _define_property(this, "logger", new _common.Logger(SmtpProvider.name));
         _define_property(this, "transporter", null);
     }
 };

package/cjs/services/email-datasource.provider.js

@@ -9,6 +9,7 @@ Object.defineProperty(exports, "EmailDataSourceProvider", {
     }
 });
 const _modules = require("@flusys/nestjs-shared/modules");
+const _constants = require("@flusys/nestjs-shared/constants");
 const _common = require("@nestjs/common");
 const _core = require("@nestjs/core");
 const _express = require("express");
@@ -71,7 +72,10 @@ let EmailDataSourceProvider = class EmailDataSourceProvider extends _modules.Mul
         }
         const config = this.getDefaultDatabaseConfig();
         if (!config) {
-            throw new _common.InternalServerErrorException('No database config available. Provide defaultDatabaseConfig or tenantDefaultDatabaseConfig.');
+            throw new _common.InternalServerErrorException({
+                message: 'No database config available. Provide defaultDatabaseConfig or tenantDefaultDatabaseConfig.',
+                messageKey: _constants.SYSTEM_MESSAGES.DATABASE_CONFIG_NOT_AVAILABLE
+            });
         }
         const connectionPromise = this.createDataSourceFromConfig(config);
         EmailDataSourceProvider.singleConnectionLock = connectionPromise;
@@ -104,7 +108,7 @@ let EmailDataSourceProvider = class EmailDataSourceProvider extends _modules.Mul
         }
     }
     constructor(configService, request){
-        super(EmailDataSourceProvider.buildParentOptions(configService.getOptions()), request), _define_property(this, "configService", void 0), _define_property(this, "logger", void 0), this.configService = configService, this.logger = new _common.Logger(EmailDataSourceProvider.name);
+        super(EmailDataSourceProvider.buildParentOptions(configService.getOptions()), request), _define_property(this, "configService", void 0), this.configService = configService;
     }
 };
 _define_property(EmailDataSourceProvider, "tenantConnections", new Map());

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

@@ -129,7 +129,7 @@ let EmailProviderConfigService = class EmailProviderConfigService extends _class
         });
     }
     constructor(cacheManager, utilsService, emailConfig, dataSourceProvider){
-        super('emailConfig', null, cacheManager, utilsService, EmailProviderConfigService.name, true), _define_property(this, "cacheManager", void 0), _define_property(this, "utilsService", void 0), _define_property(this, "emailConfig", void 0), _define_property(this, "dataSourceProvider", void 0), this.cacheManager = cacheManager, this.utilsService = utilsService, this.emailConfig = emailConfig, this.dataSourceProvider = dataSourceProvider;
+        super('emailConfig', null, cacheManager, utilsService, EmailProviderConfigService.name, true, 'email'), _define_property(this, "cacheManager", void 0), _define_property(this, "utilsService", void 0), _define_property(this, "emailConfig", void 0), _define_property(this, "dataSourceProvider", void 0), this.cacheManager = cacheManager, this.utilsService = utilsService, this.emailConfig = emailConfig, this.dataSourceProvider = dataSourceProvider;
     }
 };
 EmailProviderConfigService = _ts_decorate([