@gennext/lb-infra 0.2.3 → 0.3.1

package/dist/components/mail/providers/mail-transport.provider.d.ts

@@ -0,0 +1,15 @@
+import { BaseProvider } from '../../../base/base.provider';
+import { type IMailTransport, type TMailOptions } from '../../../components/mail';
+import { Provider, ValueOrPromise } from '@loopback/core';
+export type TGetMailTransportFn = (options: TMailOptions) => IMailTransport;
+export declare class MailTransportProvider extends BaseProvider<TGetMailTransportFn> implements Provider<TGetMailTransportFn> {
+    constructor();
+    value(): ValueOrPromise<TGetMailTransportFn>;
+    private createNodemailerTransport;
+    private createMailgunTransport;
+    private createCustomTransport;
+    private isNodemailerOptions;
+    private isMailgunOptions;
+    private isCustomOptions;
+}
+//# sourceMappingURL=mail-transport.provider.d.ts.map

package/dist/components/mail/providers/mail-transport.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-transport.provider.d.ts","sourceRoot":"","sources":["../../../../src/components/mail/providers/mail-transport.provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAML,KAAK,cAAc,EAEnB,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,cAAc,CAAC;AAE5E,qBAAa,qBACX,SAAQ,YAAY,CAAC,mBAAmB,CACxC,YAAW,QAAQ,CAAC,mBAAmB,CAAC;;IAMxC,KAAK,IAAI,cAAc,CAAC,mBAAmB,CAAC;IA4B5C,OAAO,CAAC,yBAAyB;IAajC,OAAO,CAAC,sBAAsB;IAa9B,OAAO,CAAC,qBAAqB;IA8B7B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,eAAe;CAGxB"}

package/dist/components/mail/providers/mail-transport.provider.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MailTransportProvider = void 0;
+const base_provider_1 = require("../../../base/base.provider");
+const mail_1 = require("../../../components/mail");
+const helpers_1 = require("../../../components/mail/helpers");
+const utilities_1 = require("../../../utilities");
+class MailTransportProvider extends base_provider_1.BaseProvider {
+    constructor() {
+        super({ scope: MailTransportProvider.name });
+    }
+    value() {
+        return (options) => {
+            this.logger.info('[value] Creating mail transport for provider: %s', options.provider);
+            switch (options.provider) {
+                case mail_1.EMailProvider.NODEMAILER: {
+                    return this.createNodemailerTransport(options);
+                }
+                case mail_1.EMailProvider.MAILGUN: {
+                    return this.createMailgunTransport(options);
+                }
+                case mail_1.EMailProvider.CUSTOM: {
+                    return this.createCustomTransport(options);
+                }
+                default: {
+                    throw (0, utilities_1.getError)({
+                        statusCode: 500,
+                        messageCode: mail_1.MailErrorCodes.INVALID_CONFIGURATION,
+                        message: `Unsupported mail provider: ${options.provider}`,
+                    });
+                }
+            }
+        };
+    }
+    createNodemailerTransport(options) {
+        if (this.isNodemailerOptions(options)) {
+            this.logger.info('[createNodemailerTransport] Initializing Nodemailer transport');
+            return new helpers_1.NodemailerTransportHelper(options.config);
+        }
+        throw (0, utilities_1.getError)({
+            statusCode: 500,
+            messageCode: mail_1.MailErrorCodes.INVALID_CONFIGURATION,
+            message: 'Invalid Nodemailer configuration',
+        });
+    }
+    createMailgunTransport(options) {
+        if (this.isMailgunOptions(options)) {
+            this.logger.info('[createMailgunTransport] Initializing Mailgun transport');
+            return new helpers_1.MailgunTransportHelper(options.config);
+        }
+        throw (0, utilities_1.getError)({
+            statusCode: 500,
+            messageCode: mail_1.MailErrorCodes.INVALID_CONFIGURATION,
+            message: 'Invalid Mailgun configuration',
+        });
+    }
+    createCustomTransport(options) {
+        if (!this.isCustomOptions(options)) {
+            throw (0, utilities_1.getError)({
+                statusCode: 500,
+                messageCode: mail_1.MailErrorCodes.INVALID_CONFIGURATION,
+                message: 'Invalid custom mail provider configuration',
+            });
+        }
+        if (!(0, mail_1.isMailTransport)(options.config)) {
+            const missingMethods = [];
+            if (typeof options.config.send !== 'function') {
+                missingMethods.push('send');
+            }
+            if (typeof options.config.verify !== 'function') {
+                missingMethods.push('verify');
+            }
+            throw (0, utilities_1.getError)({
+                statusCode: 500,
+                messageCode: mail_1.MailErrorCodes.INVALID_CONFIGURATION,
+                message: `Custom mail provider must implement IMailTransport interface. Missing methods: ${missingMethods.join(', ')}`,
+            });
+        }
+        this.logger.info('[createCustomTransport] Using custom mail transport');
+        return options.config;
+    }
+    isNodemailerOptions(options) {
+        return options.provider === mail_1.EMailProvider.NODEMAILER && 'config' in options;
+    }
+    isMailgunOptions(options) {
+        return options.provider === mail_1.EMailProvider.MAILGUN && 'config' in options;
+    }
+    isCustomOptions(options) {
+        return options.provider === mail_1.EMailProvider.CUSTOM && 'config' in options;
+    }
+}
+exports.MailTransportProvider = MailTransportProvider;
+//# sourceMappingURL=mail-transport.provider.js.map

package/dist/components/mail/providers/mail-transport.provider.js.map

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

package/dist/components/mail/services/generator.service.d.ts

@@ -0,0 +1,14 @@
+import { IVerificationCodeGenerator, IVerificationData, IVerificationDataGenerator, IVerificationGenerationOptions, IVerificationTokenGenerator } from '../../../components/mail';
+export declare class NumericCodeGenerator implements IVerificationCodeGenerator {
+    generateCode(length: number): string;
+}
+export declare class RandomTokenGenerator implements IVerificationTokenGenerator {
+    generateToken(bytes: number): string;
+}
+export declare class DefaultVerificationDataGenerator implements IVerificationDataGenerator {
+    private codeGenerator;
+    private tokenGenerator;
+    constructor(codeGenerator: IVerificationCodeGenerator, tokenGenerator: IVerificationTokenGenerator);
+    generateVerificationData(options: IVerificationGenerationOptions): IVerificationData;
+}
+//# sourceMappingURL=generator.service.d.ts.map

package/dist/components/mail/services/generator.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.service.d.ts","sourceRoot":"","sources":["../../../../src/components/mail/services/generator.service.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,0BAA0B,EAC1B,iBAAiB,EACjB,0BAA0B,EAC1B,8BAA8B,EAC9B,2BAA2B,EAE5B,MAAM,mBAAmB,CAAC;AAG3B,qBACa,oBAAqB,YAAW,0BAA0B;IACrE,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAKrC;AAED,qBACa,oBAAqB,YAAW,2BAA2B;IACtE,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAGrC;AAED,qBACa,gCAAiC,YAAW,0BAA0B;IAG/E,OAAO,CAAC,aAAa;IAGrB,OAAO,CAAC,cAAc;gBAHd,aAAa,EAAE,0BAA0B,EAGzC,cAAc,EAAE,2BAA2B;IAGrD,wBAAwB,CAAC,OAAO,EAAE,8BAA8B,GAAG,iBAAiB;CAkBrF"}

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

@@ -0,0 +1,70 @@
+"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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultVerificationDataGenerator = exports.RandomTokenGenerator = exports.NumericCodeGenerator = void 0;
+const core_1 = require("../../../base/loopback/@lb/core");
+const mail_1 = require("../../../components/mail");
+const node_crypto_1 = __importDefault(require("node:crypto"));
+let NumericCodeGenerator = class NumericCodeGenerator {
+    generateCode(length) {
+        const max = Math.pow(10, length);
+        const code = node_crypto_1.default.randomInt(0, max);
+        return code.toString().padStart(length, '0');
+    }
+};
+exports.NumericCodeGenerator = NumericCodeGenerator;
+exports.NumericCodeGenerator = NumericCodeGenerator = __decorate([
+    (0, core_1.injectable)()
+], NumericCodeGenerator);
+let RandomTokenGenerator = class RandomTokenGenerator {
+    generateToken(bytes) {
+        return node_crypto_1.default.randomBytes(bytes).toString('base64url');
+    }
+};
+exports.RandomTokenGenerator = RandomTokenGenerator;
+exports.RandomTokenGenerator = RandomTokenGenerator = __decorate([
+    (0, core_1.injectable)()
+], RandomTokenGenerator);
+let DefaultVerificationDataGenerator = class DefaultVerificationDataGenerator {
+    constructor(codeGenerator, tokenGenerator) {
+        this.codeGenerator = codeGenerator;
+        this.tokenGenerator = tokenGenerator;
+    }
+    generateVerificationData(options) {
+        const code = this.codeGenerator.generateCode(options.codeLength);
+        const token = this.tokenGenerator.generateToken(options.tokenBytes);
+        const now = new Date().toISOString();
+        return {
+            verificationCode: code,
+            codeGeneratedAt: now,
+            codeExpiresAt: (0, mail_1.getExpiryTime)(options.codeExpiryMinutes).toISOString(),
+            codeAttempts: 0,
+            verificationToken: token,
+            tokenGeneratedAt: now,
+            tokenExpiresAt: (0, mail_1.getExpiryTimeInHours)(options.tokenExpiryHours).toISOString(),
+            lastCodeSentAt: now,
+        };
+    }
+};
+exports.DefaultVerificationDataGenerator = DefaultVerificationDataGenerator;
+exports.DefaultVerificationDataGenerator = DefaultVerificationDataGenerator = __decorate([
+    (0, core_1.injectable)(),
+    __param(0, (0, core_1.inject)(mail_1.MailKeys.MAIL_VERIFICATION_CODE_GENERATOR)),
+    __param(1, (0, core_1.inject)(mail_1.MailKeys.MAIL_VERIFICATION_TOKEN_GENERATOR)),
+    __metadata("design:paramtypes", [Object, Object])
+], DefaultVerificationDataGenerator);
+//# sourceMappingURL=generator.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generator.service.js","sourceRoot":"","sources":["../../../../src/components/mail/services/generator.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,mDAA8D;AAC9D,4CAS2B;AAC3B,8DAAiC;AAG1B,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAC/B,YAAY,CAAC,MAAc;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,qBAAM,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;CACF,CAAA;AANY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,iBAAU,GAAE;GACA,oBAAoB,CAMhC;AAGM,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAC/B,aAAa,CAAC,KAAa;QACzB,OAAO,qBAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACzD,CAAC;CACF,CAAA;AAJY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,iBAAU,GAAE;GACA,oBAAoB,CAIhC;AAGM,IAAM,gCAAgC,GAAtC,MAAM,gCAAgC;IAC3C,YAEU,aAAyC,EAGzC,cAA2C;QAH3C,kBAAa,GAAb,aAAa,CAA4B;QAGzC,mBAAc,GAAd,cAAc,CAA6B;IAClD,CAAC;IAEJ,wBAAwB,CAAC,OAAuC;QAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACjE,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACpE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAErC,OAAO;YACL,gBAAgB,EAAE,IAAI;YACtB,eAAe,EAAE,GAAG;YACpB,aAAa,EAAE,IAAA,oBAAa,EAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,WAAW,EAAE;YACrE,YAAY,EAAE,CAAC;YAEf,iBAAiB,EAAE,KAAK;YACxB,gBAAgB,EAAE,GAAG;YACrB,cAAc,EAAE,IAAA,2BAAoB,EAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,WAAW,EAAE;YAE5E,cAAc,EAAE,GAAG;SACpB,CAAC;IACJ,CAAC;CACF,CAAA;AA3BY,4EAAgC;2CAAhC,gCAAgC;IAD5C,IAAA,iBAAU,GAAE;IAGR,WAAA,IAAA,aAAM,EAAC,eAAQ,CAAC,gCAAgC,CAAC,CAAA;IAGjD,WAAA,IAAA,aAAM,EAAC,eAAQ,CAAC,iCAAiC,CAAC,CAAA;;GAL1C,gCAAgC,CA2B5C"}

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

@@ -0,0 +1,4 @@
+export * from './generator.service';
+export * from './mail.service';
+export * from './template-engine.service';
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,20 @@
+"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("./generator.service"), exports);
+__exportStar(require("./mail.service"), exports);
+__exportStar(require("./template-engine.service"), exports);
+//# sourceMappingURL=index.js.map

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

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

package/dist/components/mail/services/mail.service.d.ts

@@ -0,0 +1,23 @@
+import { BaseService } from '../../../base/services';
+import { IMailMessage, IMailSendResult, IMailService, IMailTemplateEngine, IMailTransport, TMailOptions } from '../common';
+import { AnyType } from '../../../common';
+export declare class MailService extends BaseService implements IMailService {
+    protected options: TMailOptions;
+    protected transport: IMailTransport;
+    protected templateEngine?: IMailTemplateEngine | undefined;
+    constructor(options: TMailOptions, transport: IMailTransport, templateEngine?: IMailTemplateEngine | undefined);
+    send(message: IMailMessage): Promise<IMailSendResult>;
+    sendBatch(messages: IMailMessage[], options?: {
+        concurrency?: number;
+    }): Promise<IMailSendResult[]>;
+    sendTemplate(opts: {
+        templateName: string;
+        data: Record<string, AnyType>;
+        recipients: string | string[];
+        options?: Partial<IMailMessage>;
+    }): Promise<IMailSendResult>;
+    verify(): Promise<boolean>;
+    protected validateMessage(message: IMailMessage): void;
+    protected getDefaultFrom(): string;
+}
+//# sourceMappingURL=mail.service.d.ts.map

package/dist/components/mail/services/mail.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail.service.d.ts","sourceRoot":"","sources":["../../../../src/components/mail/services/mail.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C,OAAO,EACL,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,cAAc,EAId,YAAY,EACb,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,qBACa,WAAY,SAAQ,WAAY,YAAW,YAAY;IAGhE,SAAS,CAAC,OAAO,EAAE,YAAY;IAE/B,SAAS,CAAC,SAAS,EAAE,cAAc;IAEnC,SAAS,CAAC,cAAc,CAAC,EAAE,mBAAmB;gBAJpC,OAAO,EAAE,YAAY,EAErB,SAAS,EAAE,cAAc,EAEzB,cAAc,CAAC,EAAE,mBAAmB,YAAA;IAS1C,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC;IA6BrD,SAAS,CACb,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACjC,OAAO,CAAC,eAAe,EAAE,CAAC;IA2CvB,YAAY,CAAC,IAAI,EAAE;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC9B,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;KACjC,GAAG,OAAO,CAAC,eAAe,CAAC;IA2CtB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBhC,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IA0BtD,SAAS,CAAC,cAAc,IAAI,MAAM;CAOnC"}

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":";;;;;;;;;;;;;;;;AAAA,8CAA8C;AAC9C,2CAAgE;AAChE,yCAAkE;AAClE,sCAUmB;AAIZ,IAAM,WAAW,mBAAjB,MAAM,WAAY,SAAQ,sBAAW;IAC1C,YAEY,OAAqB,EAErB,SAAyB,EAEzB,cAAoC;QAE9C,KAAK,CAAC,EAAE,KAAK,EAAE,aAAW,CAAC,IAAI,EAAE,CAAC,CAAC;QANzB,YAAO,GAAP,OAAO,CAAc;QAErB,cAAS,GAAT,SAAS,CAAgB;QAEzB,mBAAc,GAAd,cAAc,CAAsB;QAG9C,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,0DAA0D,EAC1D,IAAI,CAAC,OAAO,CAAC,QAAQ,CACtB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAqB;QAC9B,IAAI,CAAC;YACH,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAE9B,MAAM,YAAY,GAAiB;gBACjC,GAAG,OAAO;gBACV,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,cAAc,EAAE;aAC5C,CAAC;YAEF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;YAClE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAEvD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+CAA+C,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;YACvF,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAClE,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;YAC3D,MAAM,IAAA,oBAAQ,EAAC;gBACb,UAAU,EAAE,GAAG;gBACf,WAAW,EAAE,uBAAc,CAAC,WAAW;gBACvC,OAAO,EAAE,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;aAC7F,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CACb,QAAwB,EACxB,OAAkC;QAElC,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,qBAAY,CAAC,iBAAiB,CAAC;YAC3E,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,6DAA6D,EAC7D,QAAQ,CAAC,MAAM,EACf,WAAW,CACZ,CAAC;YAEF,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE;gBAC/C,IAAI,CAAC;oBACH,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAClC,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;qBAChE,CAAC;gBACJ,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,MAAM,IAAA,mCAAuB,EAAkB;gBAC7D,KAAK;gBACL,KAAK,EAAE,WAAW;aACnB,CAAC,CAAC;YAEH,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;YAC3D,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,2DAA2D,EAC3D,YAAY,EACZ,OAAO,CAAC,MAAM,GAAG,YAAY,CAC9B,CAAC;YAEF,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4CAA4C,EAAE,KAAK,CAAC,CAAC;YACvE,MAAM,IAAA,oBAAQ,EAAC;gBACb,UAAU,EAAE,GAAG;gBACf,WAAW,EAAE,uBAAc,CAAC,iBAAiB;gBAC7C,OAAO,EAAE,gCAAgC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;aACpG,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAKlB;QACC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEzD,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;gBACzB,MAAM,IAAA,oBAAQ,EAAC;oBACb,UAAU,EAAE,GAAG;oBACf,WAAW,EAAE,uBAAc,CAAC,qBAAqB;oBACjD,OAAO,EAAE,gCAAgC;iBAC1C,CAAC,CAAC;YACL,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,EAAE,YAAY,CAAC,CAAC;YACzE,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;gBACtC,YAAY;gBACZ,IAAI;gBACJ,eAAe,EAAE,OAAO,EAAE,eAAe;aAC1C,CAAC,CAAC;YAEH,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;YAEnE,MAAM,OAAO,GAAiB;gBAC5B,EAAE,EAAE,UAAU;gBACd,OAAO,EACL,OAAO,EAAE,OAAO;oBAChB,CAAC,YAAY,EAAE,OAAO,KAAK,SAAS;wBAClC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;4BACzB,YAAY,EAAE,YAAY,CAAC,OAAO;4BAClC,IAAI;4BACJ,eAAe,EAAE,OAAO,EAAE,eAAe;yBAC1C,CAAC;wBACJ,CAAC,CAAC,YAAY,CAAC;gBACnB,IAAI;gBACJ,GAAG,OAAO;aACX,CAAC;YAEF,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iDAAiD,EAAE,KAAK,CAAC,CAAC;YAC5E,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;YAClE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YAC9C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,OAAO,CAAC,CAAC;YAC/D,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;YAC7D,MAAM,IAAA,oBAAQ,EAAC;gBACb,UAAU,EAAE,GAAG;gBACf,WAAW,EAAE,uBAAc,CAAC,mBAAmB;gBAC/C,OAAO,EAAE,uCAAuC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;aAC3G,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAES,eAAe,CAAC,OAAqB;QAC7C,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YAC1E,MAAM,IAAA,oBAAQ,EAAC;gBACb,UAAU,EAAE,GAAG;gBACf,WAAW,EAAE,uBAAc,CAAC,iBAAiB;gBAC7C,OAAO,EAAE,qCAAqC;aAC/C,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,IAAA,oBAAQ,EAAC;gBACb,UAAU,EAAE,GAAG;gBACf,WAAW,EAAE,uBAAc,CAAC,qBAAqB;gBACjD,OAAO,EAAE,2BAA2B;aACrC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,IAAA,oBAAQ,EAAC;gBACb,UAAU,EAAE,GAAG;gBACf,WAAW,EAAE,uBAAc,CAAC,qBAAqB;gBACjD,OAAO,EAAE,6CAA6C;aACvD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAES,cAAc;QACtB,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC1B,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC;QAC7D,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,qBAAqB,CAAC;IACpD,CAAC;CACF,CAAA;AA5LY,kCAAW;sBAAX,WAAW;IADvB,IAAA,iBAAU,EAAC,EAAE,KAAK,EAAE,mBAAY,CAAC,SAAS,EAAE,CAAC;IAGzC,WAAA,IAAA,aAAM,EAAC,iBAAQ,CAAC,YAAY,CAAC,CAAA;IAE7B,WAAA,IAAA,aAAM,EAAC,iBAAQ,CAAC,uBAAuB,CAAC,CAAA;IAExC,WAAA,IAAA,aAAM,EAAC,iBAAQ,CAAC,oBAAoB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;;GANjD,WAAW,CA4LvB"}

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;IAsCV,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,135 @@
+"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;
+        }
+        if (!content) {
+            throw (0, utilities_1.getError)({
+                statusCode: 404,
+                messageCode: common_1.MailErrorCodes.TEMPLATE_NOT_FOUND,
+                message: templateName
+                    ? `Template not found: ${templateName}`
+                    : 'Template content is missing',
+            });
+        }
+        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