@minimaltech/node-infra 0.5.10-20 → 0.5.10-22

package/dist/components/mail/services/mail.service.js

@@ -0,0 +1,178 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var MailService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MailService = void 0;
+const services_1 = require("../../../base/services");
+const utilities_1 = require("../../../utilities");
+const core_1 = require("@loopback/core");
+const common_1 = require("../common");
+let MailService = MailService_1 = class MailService extends services_1.BaseService {
+    constructor(options, transport, templateEngine) {
+        super({ scope: MailService_1.name });
+        this.options = options;
+        this.transport = transport;
+        this.templateEngine = templateEngine;
+        this.logger.info('[constructor] Mail service initialized with provider: %s', this.options.provider);
+    }
+    async send(message) {
+        try {
+            this.validateMessage(message);
+            const emailMessage = {
+                ...message,
+                from: message.from ?? this.getDefaultFrom(),
+            };
+            this.logger.debug('[send] Sending email to: %s', emailMessage.to);
+            const result = await this.transport.send(emailMessage);
+            if (result.success) {
+                this.logger.debug('[send] Email sent successfully. MessageId: %s', result.messageId);
+            }
+            else {
+                this.logger.debug('[send] Email send failed: %s', result.error);
+            }
+            return result;
+        }
+        catch (error) {
+            this.logger.error('[send] Error sending email: %s', error);
+            throw (0, utilities_1.getError)({
+                statusCode: 500,
+                messageCode: common_1.MailErrorCodes.SEND_FAILED,
+                message: `Failed to send email: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            });
+        }
+    }
+    async sendBatch(messages, options) {
+        try {
+            const concurrency = options?.concurrency ?? common_1.MailDefaults.BATCH_CONCURRENCY;
+            this.logger.info('[sendBatch] Sending batch of %d emails with concurrency: %d', messages.length, concurrency);
+            const tasks = messages.map(message => async () => {
+                try {
+                    return await this.send(message);
+                }
+                catch (error) {
+                    return {
+                        success: false,
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    };
+                }
+            });
+            const results = await (0, utilities_1.executePromiseWithLimit)({
+                tasks,
+                limit: concurrency,
+            });
+            const successCount = results.filter(r => r.success).length;
+            this.logger.info('[sendBatch] Batch send completed. Success: %d, Failed: %d', successCount, results.length - successCount);
+            return results;
+        }
+        catch (error) {
+            this.logger.error('[sendBatch] Error sending batch emails: %s', error);
+            throw (0, utilities_1.getError)({
+                statusCode: 500,
+                messageCode: common_1.MailErrorCodes.BATCH_SEND_FAILED,
+                message: `Failed to send batch emails: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            });
+        }
+    }
+    async sendTemplate(opts) {
+        const { templateName, data, recipients, options } = opts;
+        try {
+            if (!this.templateEngine) {
+                throw (0, utilities_1.getError)({
+                    statusCode: 500,
+                    messageCode: common_1.MailErrorCodes.INVALID_CONFIGURATION,
+                    message: 'Template engine not configured',
+                });
+            }
+            this.logger.debug('[sendTemplate] Rendering template: %s', templateName);
+            const html = this.templateEngine.render({
+                templateName,
+                data,
+                requireValidate: options?.requireValidate,
+            });
+            const templateData = this.templateEngine.getTemplate(templateName);
+            const message = {
+                to: recipients,
+                subject: options?.subject ??
+                    (templateData?.subject !== undefined
+                        ? this.templateEngine.render({
+                            templateData: templateData.subject,
+                            data,
+                            requireValidate: options?.requireValidate,
+                        })
+                        : 'No Subject'),
+                html,
+                ...options,
+            };
+            return await this.send(message);
+        }
+        catch (error) {
+            this.logger.error('[sendTemplate] Error sending template email: %s', error);
+            throw error;
+        }
+    }
+    async verify() {
+        try {
+            this.logger.debug('[verify] Verifying mail transport connection');
+            const isValid = await this.transport.verify();
+            this.logger.debug('[verify] Verification result: %s', isValid);
+            return isValid;
+        }
+        catch (error) {
+            this.logger.error('[verify] Verification failed: %s', error);
+            throw (0, utilities_1.getError)({
+                statusCode: 500,
+                messageCode: common_1.MailErrorCodes.VERIFICATION_FAILED,
+                message: `Mail transport verification failed: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            });
+        }
+    }
+    validateMessage(message) {
+        if (!message.to || (Array.isArray(message.to) && message.to.length === 0)) {
+            throw (0, utilities_1.getError)({
+                statusCode: 400,
+                messageCode: common_1.MailErrorCodes.INVALID_RECIPIENT,
+                message: 'Recipient email address is required',
+            });
+        }
+        if (!message.subject) {
+            throw (0, utilities_1.getError)({
+                statusCode: 400,
+                messageCode: common_1.MailErrorCodes.INVALID_CONFIGURATION,
+                message: 'Email subject is required',
+            });
+        }
+        if (!message.text && !message.html) {
+            throw (0, utilities_1.getError)({
+                statusCode: 400,
+                messageCode: common_1.MailErrorCodes.INVALID_CONFIGURATION,
+                message: 'Email must have either text or html content',
+            });
+        }
+    }
+    getDefaultFrom() {
+        if (this.options.fromName) {
+            return `"${this.options.fromName}" <${this.options.from}>`;
+        }
+        return this.options.from ?? 'noreply@example.com';
+    }
+};
+exports.MailService = MailService;
+exports.MailService = MailService = MailService_1 = __decorate([
+    (0, core_1.injectable)({ scope: core_1.BindingScope.SINGLETON }),
+    __param(0, (0, core_1.inject)(common_1.MailKeys.MAIL_OPTIONS)),
+    __param(1, (0, core_1.inject)(common_1.MailKeys.MAIL_TRANSPORT_INSTANCE)),
+    __param(2, (0, core_1.inject)(common_1.MailKeys.MAIL_TEMPLATE_ENGINE, { optional: true })),
+    __metadata("design:paramtypes", [Object, Object, Object])
+], MailService);
+//# sourceMappingURL=mail.service.js.map

package/dist/components/mail/services/mail.service.js.map

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

package/dist/components/mail/services/template-engine.service.d.ts

@@ -0,0 +1,36 @@
+import { BaseService } from '../../../base/services';
+import { AnyType } from '../../../common';
+import { IMailTemplateEngine, ITemplate } from '../common';
+export declare class TemplateEngineService extends BaseService implements IMailTemplateEngine {
+    private templates;
+    constructor();
+    registerTemplate(opts: {
+        name: string;
+        content: string;
+        options?: Partial<ITemplate>;
+    }): void;
+    render(opts: {
+        templateData?: string;
+        templateName?: string;
+        data: Record<string, AnyType>;
+        requireValidate?: boolean;
+    }): string;
+    getTemplate(name: string): ITemplate | undefined;
+    listTemplates(): ITemplate[];
+    hasTemplate(name: string): boolean;
+    removeTemplate(name: string): boolean;
+    clearTemplates(): void;
+    validateTemplateData(opts: {
+        template: string;
+        data: Record<string, AnyType>;
+    }): {
+        isValid: boolean;
+        missingKeys: string[];
+        allKeys: string[];
+    };
+    renderSimpleTemplate(template: string, data: Record<string, AnyType>, opts?: {
+        requireValidate?: boolean;
+    }): string;
+    private getNestedValue;
+}
+//# sourceMappingURL=template-engine.service.d.ts.map

package/dist/components/mail/services/template-engine.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.service.d.ts","sourceRoot":"","sources":["../../../../src/components/mail/services/template-engine.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGnC,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAkB,MAAM,WAAW,CAAC;AAE3E,qBACa,qBAAsB,SAAQ,WAAY,YAAW,mBAAmB;IACnF,OAAO,CAAC,SAAS,CAAqC;;IAOtD,gBAAgB,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;KAAE,GAAG,IAAI;IAc7F,MAAM,CAAC,IAAI,EAAE;QACX,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,GAAG,MAAM;IA4BV,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIhD,aAAa,IAAI,SAAS,EAAE;IAI5B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIlC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAKrC,cAAc,IAAI,IAAI;IAKtB,oBAAoB,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG;QAC/E,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB;IA8BD,oBAAoB,CAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GACnC,MAAM;IAyBT,OAAO,CAAC,cAAc;CAKvB"}

package/dist/components/mail/services/template-engine.service.js

@@ -0,0 +1,126 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var TemplateEngineService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemplateEngineService = void 0;
+const services_1 = require("../../../base/services");
+const utilities_1 = require("../../../utilities");
+const core_1 = require("@loopback/core");
+const common_1 = require("../common");
+let TemplateEngineService = TemplateEngineService_1 = class TemplateEngineService extends services_1.BaseService {
+    constructor() {
+        super({ scope: TemplateEngineService_1.name });
+        this.templates = new Map();
+        this.logger.info('[constructor] Template engine initialized');
+    }
+    registerTemplate(opts) {
+        const { name, content, options } = opts;
+        this.logger.info('[registerTemplate] Registering template: %s', name);
+        const template = {
+            name,
+            content,
+            subject: options?.subject,
+            description: options?.description,
+        };
+        this.templates.set(name, template);
+    }
+    render(opts) {
+        const { templateData, templateName, data, requireValidate } = opts;
+        if (!templateData && !templateName) {
+            throw (0, utilities_1.getError)({ message: 'Either templateName or templateData must be provided' });
+        }
+        let content = templateData;
+        if (!content && templateName) {
+            const template = this.templates.get(templateName);
+            if (!template) {
+                throw (0, utilities_1.getError)({
+                    statusCode: 404,
+                    messageCode: common_1.MailErrorCodes.TEMPLATE_NOT_FOUND,
+                    message: `Template not found: ${templateName}`,
+                });
+            }
+            this.logger.debug('[render] Rendering template: %s', templateName);
+            content = template.content;
+        }
+        return this.renderSimpleTemplate(content, data, { requireValidate });
+    }
+    getTemplate(name) {
+        return this.templates.get(name);
+    }
+    listTemplates() {
+        return Array.from(this.templates.values());
+    }
+    hasTemplate(name) {
+        return this.templates.has(name);
+    }
+    removeTemplate(name) {
+        this.logger.info('[removeTemplate] Removing template: %s', name);
+        return this.templates.delete(name);
+    }
+    clearTemplates() {
+        this.logger.info('[clearTemplates] Clearing all templates');
+        this.templates.clear();
+    }
+    validateTemplateData(opts) {
+        const { template, data } = opts;
+        const placeholderRegex = /\{\{(\s*[\w.]+\s*)\}\}/g;
+        const allKeys = [];
+        const missingKeys = [];
+        let match;
+        while ((match = placeholderRegex.exec(template)) !== null) {
+            const key = match[1].trim();
+            if (!allKeys.includes(key)) {
+                allKeys.push(key);
+                const value = this.getNestedValue(data, key);
+                if (value === undefined || value === null) {
+                    missingKeys.push(key);
+                }
+            }
+        }
+        const isValid = missingKeys.length === 0;
+        if (!isValid) {
+            this.logger.warn('[validateTemplateData] Template validation failed | Missing keys: %s', missingKeys.join(', '));
+        }
+        return { isValid, missingKeys, allKeys };
+    }
+    renderSimpleTemplate(template, data, opts) {
+        if (opts?.requireValidate) {
+            const validation = this.validateTemplateData({ template, data });
+            if (!validation.isValid) {
+                throw (0, utilities_1.getError)({
+                    statusCode: 400,
+                    messageCode: common_1.MailErrorCodes.INVALID_CONFIGURATION,
+                    message: `Missing template data for keys: ${validation.missingKeys.join(', ')}`,
+                });
+            }
+        }
+        return template.replace(/\{\{(\s*[\w.]+\s*)\}\}/g, (match, key) => {
+            const trimmedKey = key.trim();
+            const value = this.getNestedValue(data, trimmedKey);
+            if (value === undefined || value === null) {
+                this.logger.warn('[renderSimpleTemplate] Missing value for key: %s', trimmedKey);
+                return match;
+            }
+            return String(value);
+        });
+    }
+    getNestedValue(obj, path) {
+        return path.split('.').reduce((current, key) => {
+            return current?.[key];
+        }, obj);
+    }
+};
+exports.TemplateEngineService = TemplateEngineService;
+exports.TemplateEngineService = TemplateEngineService = TemplateEngineService_1 = __decorate([
+    (0, core_1.injectable)({ scope: core_1.BindingScope.SINGLETON }),
+    __metadata("design:paramtypes", [])
+], TemplateEngineService);
+//# sourceMappingURL=template-engine.service.js.map

package/dist/components/mail/services/template-engine.service.js.map

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

package/dist/components/mail/utilities/index.d.ts

@@ -0,0 +1,3 @@
+export * from './type.utility';
+export * from './verification.utility';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/mail/utilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/mail/utilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC"}

package/dist/components/mail/utilities/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./type.utility"), exports);
+__exportStar(require("./verification.utility"), exports);
+//# sourceMappingURL=index.js.map

package/dist/components/mail/utilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/mail/utilities/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,yDAAuC"}

package/dist/components/mail/utilities/type.utility.d.ts

@@ -0,0 +1,5 @@
+import { AnyType } from '../../../common';
+import { IMailTransport, TMailOptions } from '../common';
+export declare function isMailTransport(value: AnyType): value is IMailTransport;
+export declare function isValidMailOptions(options: AnyType): options is TMailOptions;
+//# sourceMappingURL=type.utility.d.ts.map

package/dist/components/mail/utilities/type.utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.utility.d.ts","sourceRoot":"","sources":["../../../../src/components/mail/utilities/type.utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAoBvE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,YAAY,CAgB5E"}

package/dist/components/mail/utilities/type.utility.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMailTransport = isMailTransport;
+exports.isValidMailOptions = isValidMailOptions;
+function isMailTransport(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const transport = value;
+    if (typeof transport.send !== 'function') {
+        return false;
+    }
+    if (typeof transport.verify !== 'function') {
+        return false;
+    }
+    if (transport.close !== undefined && typeof transport.close !== 'function') {
+        return false;
+    }
+    return true;
+}
+function isValidMailOptions(options) {
+    if (!options || typeof options !== 'object') {
+        return false;
+    }
+    const opts = options;
+    if (typeof opts.provider !== 'string') {
+        return false;
+    }
+    if (!opts.config) {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=type.utility.js.map

package/dist/components/mail/utilities/type.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.utility.js","sourceRoot":"","sources":["../../../../src/components/mail/utilities/type.utility.ts"],"names":[],"mappings":";;AAGA,0CAoBC;AAED,gDAgBC;AAtCD,SAAgB,eAAe,CAAC,KAAc;IAC5C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,KAAgC,CAAC;IAEnD,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,SAAS,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,SAAS,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,kBAAkB,CAAC,OAAgB;IACjD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAG,OAAkC,CAAC;IAEhD,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/components/mail/utilities/verification.utility.d.ts

@@ -0,0 +1,3 @@
+export declare function getExpiryTime(minutes: number): Date;
+export declare function getExpiryTimeInHours(hours: number): Date;
+//# sourceMappingURL=verification.utility.d.ts.map

package/dist/components/mail/utilities/verification.utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification.utility.d.ts","sourceRoot":"","sources":["../../../../src/components/mail/utilities/verification.utility.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAExD"}

package/dist/components/mail/utilities/verification.utility.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getExpiryTime = getExpiryTime;
+exports.getExpiryTimeInHours = getExpiryTimeInHours;
+function getExpiryTime(minutes) {
+    return new Date(Date.now() + minutes * 60 * 1000);
+}
+function getExpiryTimeInHours(hours) {
+    return new Date(Date.now() + hours * 60 * 60 * 1000);
+}
+//# sourceMappingURL=verification.utility.js.map

package/dist/components/mail/utilities/verification.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification.utility.js","sourceRoot":"","sources":["../../../../src/components/mail/utilities/verification.utility.ts"],"names":[],"mappings":";;AAAA,sCAEC;AAED,oDAEC;AAND,SAAgB,aAAa,CAAC,OAAe;IAC3C,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,SAAgB,oBAAoB,CAAC,KAAa;IAChD,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;AACvD,CAAC"}

package/dist/utilities/index.d.ts

@@ -2,6 +2,7 @@ export * from './crypto.utility';
 export * from './date.utility';
 export * from './error.utility';
 export * from './model.utility';
+export * from './module.utility';
 export * from './parse.utility';
 export * from './performance.utility';
 export * from './promise.utility';

package/dist/utilities/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC"}

package/dist/utilities/index.js

@@ -18,6 +18,7 @@ __exportStar(require("./crypto.utility"), exports);
 __exportStar(require("./date.utility"), exports);
 __exportStar(require("./error.utility"), exports);
 __exportStar(require("./model.utility"), exports);
+__exportStar(require("./module.utility"), exports);
 __exportStar(require("./parse.utility"), exports);
 __exportStar(require("./performance.utility"), exports);
 __exportStar(require("./promise.utility"), exports);

package/dist/utilities/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utilities/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,iDAA+B;AAC/B,kDAAgC;AAChC,kDAAgC;AAChC,kDAAgC;AAChC,wDAAsC;AACtC,oDAAkC;AAClC,kDAAgC;AAChC,oDAAkC;AAClC,gDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utilities/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,iDAA+B;AAC/B,kDAAgC;AAChC,kDAAgC;AAChC,mDAAiC;AACjC,kDAAgC;AAChC,wDAAsC;AACtC,oDAAkC;AAClC,kDAAgC;AAChC,oDAAkC;AAClC,gDAA8B"}

package/dist/utilities/module.utility.d.ts

@@ -0,0 +1,5 @@
+export declare const validateModule: (opts: {
+    scope?: string;
+    modules: Array<string>;
+}) => void;
+//# sourceMappingURL=module.utility.d.ts.map

package/dist/utilities/module.utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.utility.d.ts","sourceRoot":"","sources":["../../src/utilities/module.utility.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc,GAAI,MAAM;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CAAE,SAgB9E,CAAC"}

package/dist/utilities/module.utility.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateModule = void 0;
+const helpers_1 = require("../helpers");
+const error_utility_1 = require("./error.utility");
+const validateModule = (opts) => {
+    const { scope = '', modules = [] } = opts;
+    for (const module of modules) {
+        try {
+            require.resolve(module);
+        }
+        catch (error) {
+            helpers_1.LoggerFactory.getLogger([scope]).error("[validateModule] Failed to import '%s' | Error: %s", module, error);
+            throw (0, error_utility_1.getError)({
+                message: `[validateModule] ${module} is required${scope ? ` for ${scope}` : ''}. Please install '${module}'`,
+            });
+        }
+    }
+};
+exports.validateModule = validateModule;
+//# sourceMappingURL=module.utility.js.map

package/dist/utilities/module.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.utility.js","sourceRoot":"","sources":["../../src/utilities/module.utility.ts"],"names":[],"mappings":";;;AAAA,uCAA0C;AAC1C,mDAA2C;AAEpC,MAAM,cAAc,GAAG,CAAC,IAAgD,EAAE,EAAE;IACjF,MAAM,EAAE,KAAK,GAAG,EAAE,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;IAC1C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,uBAAa,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CACpC,oDAAoD,EACpD,MAAM,EACN,KAAK,CACN,CAAC;YACF,MAAM,IAAA,wBAAQ,EAAC;gBACb,OAAO,EAAE,oBAAoB,MAAM,eAAe,KAAK,CAAC,CAAC,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,qBAAqB,MAAM,GAAG;aAC7G,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAhBW,QAAA,cAAc,kBAgBzB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minimaltech/node-infra",
-  "version": "0.5.10-20",
+  "version": "0.5.10-22",
   "description": "Minimal Technology - NodeJS Infrastructure - Loopback 4 Framework",
   "keywords": [
     "web",
@@ -147,6 +147,18 @@
     "winston-daily-rotate-file": "^5.0.0",
     "winston-transport": "^4.9.0"
   },
+  "peerDependencies": {
+    "nodemailer": "^7.0.10",
+    "mailgun.js": "^12.1.1"
+  },
+  "peerDependenciesMeta": {
+    "nodemailer": {
+      "optional": true
+    },
+    "mailgun.js": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@minimaltech/eslint-node": "^0.2.1",
     "@types/express": "4.17.21",
@@ -155,6 +167,7 @@
     "@types/mocha": "^10.0.10",
     "@types/multer": "^2.0.0",
     "@types/node": "^24.7.2",
+    "@types/nodemailer": "^7.0.4",
     "eslint": "^9.36.0",
     "prettier": "^3.6.2",
     "source-map-support": "^0.5.21",