@venizia/ignis 0.4.3 → 0.4.4

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

@@ -1,209 +0,0 @@
-"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 common_1 = require("@venizia/ignis-helpers/common");
-const ignis_kernel_1 = require("@venizia/ignis-kernel");
-const common_2 = require("../common");
-const metadata_1 = require("../../../base/metadata");
-const core_1 = require("@venizia/ignis-helpers/core");
-const ignis_helpers_1 = require("@venizia/ignis-helpers");
-const attachment_utility_1 = require("../utilities/attachment.utility");
-const body_utility_1 = require("../utilities/body.utility");
-let MailService = MailService_1 = class MailService extends ignis_kernel_1.BaseService {
-    constructor(options, transport, templateEngine) {
-        super({ scope: MailService_1.name });
-        this.options = options;
-        this.transport = transport;
-        this.templateEngine = templateEngine;
-        this.logger
-            .for(this.constructor.name)
-            .info('Mail service initialized with provider: %s', this.options.provider);
-    }
-    async send(message) {
-        try {
-            this.validateMessage(message);
-            const emailMessage = {
-                ...message,
-                from: message.from ?? this.getDefaultFrom(),
-            };
-            // The one place the attachment policy applies: every transport receives bytes, never a path.
-            if (message.attachments) {
-                emailMessage.attachments = await (0, attachment_utility_1.resolveMailAttachments)({
-                    attachments: message.attachments,
-                    attachmentRoot: this.options.attachmentRoot,
-                    maxBytes: this.options.maxAttachmentBytes ?? common_2.MailDefaults.MAX_ATTACHMENT_BYTES,
-                });
-            }
-            this.logger.for(this.send.name).debug('Sending email to: %s', emailMessage.to);
-            const result = await this.transport.send(emailMessage);
-            if (result.success) {
-                this.logger
-                    .for(this.send.name)
-                    .debug('Email sent successfully. MessageId: %s', result.messageId);
-            }
-            else {
-                this.logger.for(this.send.name).debug('Email send failed: %s', result.error);
-            }
-            return result;
-        }
-        catch (error) {
-            this.logger.for(this.send.name).error('Error sending email: %s', error);
-            (0, attachment_utility_1.releaseAttachmentStreams)({ attachments: message.attachments });
-            // An error the framework already shaped carries its own status and message code; re-wrapping as 500 would report a caller mistake as a server fault.
-            if ((0, core_1.isApplicationError)(error)) {
-                throw error;
-            }
-            throw (0, core_1.getError)({
-                statusCode: common_1.HTTP.ResultCodes.RS_5.InternalServerError,
-                messageCode: common_2.MailErrorCodes.SEND_FAILED,
-                // The raw text can carry a file path or a provider detail; it rides in `cause`, which only development responses show.
-                message: 'Failed to send email',
-                cause: error,
-            });
-        }
-    }
-    async sendBatch(messages, options) {
-        try {
-            const concurrency = options?.concurrency ?? common_2.MailDefaults.BATCH_CONCURRENCY;
-            this.logger
-                .for(this.sendBatch.name)
-                .info('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, ignis_helpers_1.executePromiseWithLimit)({
-                tasks,
-                limit: concurrency,
-            });
-            const successCount = results.filter((r) => r.success).length;
-            this.logger
-                .for(this.sendBatch.name)
-                .info('Batch send completed. Success: %d, Failed: %d', successCount, results.length - successCount);
-            return results;
-        }
-        catch (error) {
-            this.logger.for(this.sendBatch.name).error('Error sending batch emails: %s', error);
-            throw (0, core_1.getError)({
-                statusCode: common_1.HTTP.ResultCodes.RS_5.InternalServerError,
-                messageCode: common_2.MailErrorCodes.BATCH_SEND_FAILED,
-                message: 'Failed to send batch emails',
-                cause: error,
-            });
-        }
-    }
-    async sendTemplate(opts) {
-        const { templateName, data, recipients, options } = opts;
-        try {
-            if (!this.templateEngine) {
-                throw (0, core_1.getError)({
-                    statusCode: common_1.HTTP.ResultCodes.RS_5.InternalServerError,
-                    messageCode: common_2.MailErrorCodes.INVALID_CONFIGURATION,
-                    message: 'Template engine not configured',
-                });
-            }
-            this.logger.for(this.sendTemplate.name).debug('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.for(this.sendTemplate.name).error('Error sending template email: %s', error);
-            throw error;
-        }
-    }
-    async verify() {
-        try {
-            this.logger.for(this.verify.name).debug('Verifying mail transport connection');
-            const isValid = await this.transport.verify();
-            this.logger.for(this.verify.name).debug('Verification result: %s', isValid);
-            return isValid;
-        }
-        catch (error) {
-            this.logger.for(this.verify.name).error('Verification failed: %s', error);
-            throw (0, core_1.getError)({
-                statusCode: common_1.HTTP.ResultCodes.RS_5.InternalServerError,
-                messageCode: common_2.MailErrorCodes.VERIFICATION_FAILED,
-                message: 'Mail transport verification failed',
-                cause: error,
-            });
-        }
-    }
-    validateMessage(message) {
-        if (!message.to || (Array.isArray(message.to) && message.to.length === 0)) {
-            throw (0, core_1.getError)({
-                error: common_2.MailErrors.INVALID_RECIPIENT,
-                message: 'Recipient email address is required',
-            });
-        }
-        if (!message.subject) {
-            throw (0, core_1.getError)({
-                error: common_2.MailErrors.INVALID_CONFIGURATION,
-                message: 'Email subject is required',
-            });
-        }
-        if (!message.text && !message.html) {
-            throw (0, core_1.getError)({
-                error: common_2.MailErrors.INVALID_CONFIGURATION,
-                message: 'Email must have either text or html content',
-            });
-        }
-        (0, body_utility_1.assertMailBodyIsText)({ message });
-    }
-    getDefaultFrom() {
-        const { from, fromName } = this.options;
-        // A display name is only renderable around an address: `"Name" <undefined>` is not a sender.
-        if (!from) {
-            return common_2.MailDefaults.FALLBACK_FROM;
-        }
-        if (!fromName) {
-            return from;
-        }
-        return `"${fromName}" <${from}>`;
-    }
-};
-exports.MailService = MailService;
-exports.MailService = MailService = MailService_1 = __decorate([
-    __param(0, (0, metadata_1.inject)({ key: common_2.MailKeys.MAIL_OPTIONS })),
-    __param(1, (0, metadata_1.inject)({ key: common_2.MailKeys.MAIL_TRANSPORT_INSTANCE })),
-    __param(2, (0, metadata_1.inject)({ key: common_2.MailKeys.MAIL_TEMPLATE_ENGINE, isOptional: true })),
-    __metadata("design:paramtypes", [Object, Object, Object])
-], MailService);
-//# sourceMappingURL=mail.service.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"mail.service.js","sourceRoot":"","sources":["../../../../src/components/mail/services/mail.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@venizia/ignis-helpers/common';\nimport { BaseService } from '@venizia/ignis-kernel';\nimport type {\n  IMailMessage,\n  IMailSendResult,\n  IMailService,\n  IMailTemplateEngine,\n  IMailTransport,\n  TMailOptions,\n} from '../common';\nimport { MailDefaults, MailErrorCodes, MailErrors, MailKeys } from '../common';\nimport { inject } from '@/base/metadata';\nimport { getError, isApplicationError } from '@venizia/ignis-helpers/core';\nimport { type AnyType } from '@venizia/ignis-helpers/common';\nimport { executePromiseWithLimit } from '@venizia/ignis-helpers';\nimport { releaseAttachmentStreams, resolveMailAttachments } from '../utilities/attachment.utility';\nimport { assertMailBodyIsText } from '../utilities/body.utility';\n\nexport class MailService extends BaseService implements IMailService {\n  constructor(\n    @inject({ key: MailKeys.MAIL_OPTIONS })\n    protected options: TMailOptions,\n    @inject({ key: MailKeys.MAIL_TRANSPORT_INSTANCE })\n    protected transport: IMailTransport,\n    @inject({ key: MailKeys.MAIL_TEMPLATE_ENGINE, isOptional: true })\n    protected templateEngine?: IMailTemplateEngine,\n  ) {\n    super({ scope: MailService.name });\n    this.logger\n      .for(this.constructor.name)\n      .info('Mail service initialized with provider: %s', this.options.provider);\n  }\n\n  async send(message: IMailMessage): Promise<IMailSendResult> {\n    try {\n      this.validateMessage(message);\n\n      const emailMessage: IMailMessage = {\n        ...message,\n        from: message.from ?? this.getDefaultFrom(),\n      };\n\n      // The one place the attachment policy applies: every transport receives bytes, never a path.\n      if (message.attachments) {\n        emailMessage.attachments = await resolveMailAttachments({\n          attachments: message.attachments,\n          attachmentRoot: this.options.attachmentRoot,\n          maxBytes: this.options.maxAttachmentBytes ?? MailDefaults.MAX_ATTACHMENT_BYTES,\n        });\n      }\n\n      this.logger.for(this.send.name).debug('Sending email to: %s', emailMessage.to);\n      const result = await this.transport.send(emailMessage);\n\n      if (result.success) {\n        this.logger\n          .for(this.send.name)\n          .debug('Email sent successfully. MessageId: %s', result.messageId);\n      } else {\n        this.logger.for(this.send.name).debug('Email send failed: %s', result.error);\n      }\n\n      return result;\n    } catch (error) {\n      this.logger.for(this.send.name).error('Error sending email: %s', error);\n      releaseAttachmentStreams({ attachments: message.attachments });\n\n      // An error the framework already shaped carries its own status and message code; re-wrapping as 500 would report a caller mistake as a server fault.\n      if (isApplicationError(error)) {\n        throw error;\n      }\n\n      throw getError({\n        statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n        messageCode: MailErrorCodes.SEND_FAILED,\n        // The raw text can carry a file path or a provider detail; it rides in `cause`, which only development responses show.\n        message: 'Failed to send email',\n        cause: error,\n      });\n    }\n  }\n\n  async sendBatch(\n    messages: IMailMessage[],\n    options?: { concurrency?: number },\n  ): Promise<IMailSendResult[]> {\n    try {\n      const concurrency = options?.concurrency ?? MailDefaults.BATCH_CONCURRENCY;\n      this.logger\n        .for(this.sendBatch.name)\n        .info('Sending batch of %d emails with concurrency: %d', messages.length, concurrency);\n\n      const tasks = messages.map((message) => async () => {\n        try {\n          return await this.send(message);\n        } catch (error) {\n          return {\n            success: false,\n            error: error instanceof Error ? error.message : 'Unknown error',\n          };\n        }\n      });\n\n      const results = await executePromiseWithLimit<IMailSendResult>({\n        tasks,\n        limit: concurrency,\n      });\n\n      const successCount = results.filter((r) => r.success).length;\n      this.logger\n        .for(this.sendBatch.name)\n        .info(\n          'Batch send completed. Success: %d, Failed: %d',\n          successCount,\n          results.length - successCount,\n        );\n\n      return results;\n    } catch (error) {\n      this.logger.for(this.sendBatch.name).error('Error sending batch emails: %s', error);\n      throw getError({\n        statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n        messageCode: MailErrorCodes.BATCH_SEND_FAILED,\n        message: 'Failed to send batch emails',\n        cause: error,\n      });\n    }\n  }\n\n  async sendTemplate(opts: {\n    templateName: string;\n    data: Record<string, AnyType>;\n    recipients: string | string[];\n    options?: Partial<IMailMessage>;\n  }): Promise<IMailSendResult> {\n    const { templateName, data, recipients, options } = opts;\n\n    try {\n      if (!this.templateEngine) {\n        throw getError({\n          statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n          messageCode: MailErrorCodes.INVALID_CONFIGURATION,\n          message: 'Template engine not configured',\n        });\n      }\n\n      this.logger.for(this.sendTemplate.name).debug('Rendering template: %s', templateName);\n      const html = this.templateEngine.render({\n        templateName,\n        data,\n        requireValidate: options?.requireValidate,\n      });\n\n      const templateData = this.templateEngine.getTemplate(templateName);\n\n      const message: IMailMessage = {\n        to: recipients,\n        subject:\n          options?.subject ??\n          (templateData?.subject !== undefined\n            ? this.templateEngine.render({\n                templateData: templateData.subject,\n                data,\n                requireValidate: options?.requireValidate,\n              })\n            : 'No Subject'),\n        html,\n        ...options,\n      };\n\n      return await this.send(message);\n    } catch (error) {\n      this.logger.for(this.sendTemplate.name).error('Error sending template email: %s', error);\n      throw error;\n    }\n  }\n\n  async verify(): Promise<boolean> {\n    try {\n      this.logger.for(this.verify.name).debug('Verifying mail transport connection');\n      const isValid = await this.transport.verify();\n      this.logger.for(this.verify.name).debug('Verification result: %s', isValid);\n      return isValid;\n    } catch (error) {\n      this.logger.for(this.verify.name).error('Verification failed: %s', error);\n      throw getError({\n        statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n        messageCode: MailErrorCodes.VERIFICATION_FAILED,\n        message: 'Mail transport verification failed',\n        cause: error,\n      });\n    }\n  }\n\n  protected validateMessage(message: IMailMessage): void {\n    if (!message.to || (Array.isArray(message.to) && message.to.length === 0)) {\n      throw getError({\n        error: MailErrors.INVALID_RECIPIENT,\n        message: 'Recipient email address is required',\n      });\n    }\n\n    if (!message.subject) {\n      throw getError({\n        error: MailErrors.INVALID_CONFIGURATION,\n        message: 'Email subject is required',\n      });\n    }\n\n    if (!message.text && !message.html) {\n      throw getError({\n        error: MailErrors.INVALID_CONFIGURATION,\n        message: 'Email must have either text or html content',\n      });\n    }\n\n    assertMailBodyIsText({ message });\n  }\n\n  protected getDefaultFrom(): string {\n    const { from, fromName } = this.options;\n\n    // A display name is only renderable around an address: `\"Name\" <undefined>` is not a sender.\n    if (!from) {\n      return MailDefaults.FALLBACK_FROM;\n    }\n\n    if (!fromName) {\n      return from;\n    }\n\n    return `\"${fromName}\" <${from}>`;\n  }\n}\n"]}

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

@@ -1,36 +0,0 @@
-import { BaseService } from '@venizia/ignis-kernel';
-import type { IMailTemplateEngine, ITemplate } from '../common';
-import type { AnyType } from '@venizia/ignis-helpers/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.service.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"template.service.d.ts","sourceRoot":"","sources":["../../../../src/components/mail/services/template.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEhE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAG7D,qBAAa,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;IAgCD,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;IA0BT,OAAO,CAAC,cAAc;CAKvB"}

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

@@ -1,115 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TemplateEngineService = void 0;
-const ignis_kernel_1 = require("@venizia/ignis-kernel");
-const common_1 = require("../common");
-const core_1 = require("@venizia/ignis-helpers/core");
-class TemplateEngineService extends ignis_kernel_1.BaseService {
-    constructor() {
-        super({ scope: TemplateEngineService.name });
-        this.templates = new Map();
-        this.logger.for(this.constructor.name).info('Template engine initialized');
-    }
-    registerTemplate(opts) {
-        const { name, content, options } = opts;
-        this.logger.for(this.registerTemplate.name).info('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, core_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, core_1.getError)({
-                    error: common_1.MailErrors.TEMPLATE_NOT_FOUND,
-                    message: `Template not found: ${templateName}`,
-                });
-            }
-            this.logger.for(this.render.name).debug('Rendering template: %s', templateName);
-            content = template.content;
-        }
-        // TODO: check content! later
-        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.for(this.removeTemplate.name).info('Removing template: %s', name);
-        return this.templates.delete(name);
-    }
-    clearTemplates() {
-        this.logger.for(this.clearTemplates.name).info('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)) {
-                continue;
-            }
-            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
-                .for(this.validateTemplateData.name)
-                .warn('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, core_1.getError)({
-                    error: common_1.MailErrors.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
-                    .for(this.renderSimpleTemplate.name)
-                    .warn('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;
-//# sourceMappingURL=template.service.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"template.service.js","sourceRoot":"","sources":["../../../../src/components/mail/services/template.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseService } from '@venizia/ignis-kernel';\nimport type { IMailTemplateEngine, ITemplate } from '../common';\nimport { MailErrors } from '../common';\nimport type { AnyType } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\n\nexport class TemplateEngineService extends BaseService implements IMailTemplateEngine {\n  private templates: Map<string, ITemplate> = new Map();\n\n  constructor() {\n    super({ scope: TemplateEngineService.name });\n    this.logger.for(this.constructor.name).info('Template engine initialized');\n  }\n\n  registerTemplate(opts: { name: string; content: string; options?: Partial<ITemplate> }): void {\n    const { name, content, options } = opts;\n    this.logger.for(this.registerTemplate.name).info('Registering template: %s', name);\n\n    const template: ITemplate = {\n      name,\n      content,\n      subject: options?.subject,\n      description: options?.description,\n    };\n\n    this.templates.set(name, template);\n  }\n\n  render(opts: {\n    templateData?: string;\n    templateName?: string;\n    data: Record<string, AnyType>;\n    requireValidate?: boolean;\n  }): string {\n    const { templateData, templateName, data, requireValidate } = opts;\n\n    if (!templateData && !templateName) {\n      throw getError({ message: 'Either templateName or templateData must be provided' });\n    }\n\n    let content = templateData;\n\n    if (!content && templateName) {\n      const template = this.templates.get(templateName);\n\n      if (!template) {\n        throw getError({\n          error: MailErrors.TEMPLATE_NOT_FOUND,\n          message: `Template not found: ${templateName}`,\n        });\n      }\n\n      this.logger.for(this.render.name).debug('Rendering template: %s', templateName);\n\n      content = template.content;\n    }\n\n    // TODO: check content! later\n    return this.renderSimpleTemplate(content!, data, { requireValidate });\n  }\n\n  getTemplate(name: string): ITemplate | undefined {\n    return this.templates.get(name);\n  }\n\n  listTemplates(): ITemplate[] {\n    return Array.from(this.templates.values());\n  }\n\n  hasTemplate(name: string): boolean {\n    return this.templates.has(name);\n  }\n\n  removeTemplate(name: string): boolean {\n    this.logger.for(this.removeTemplate.name).info('Removing template: %s', name);\n    return this.templates.delete(name);\n  }\n\n  clearTemplates(): void {\n    this.logger.for(this.clearTemplates.name).info('Clearing all templates');\n    this.templates.clear();\n  }\n\n  validateTemplateData(opts: { template: string; data: Record<string, AnyType> }): {\n    isValid: boolean;\n    missingKeys: string[];\n    allKeys: string[];\n  } {\n    const { template, data } = opts;\n    const placeholderRegex = /\\{\\{(\\s*[\\w.]+\\s*)\\}\\}/g;\n    const allKeys: string[] = [];\n    const missingKeys: string[] = [];\n\n    let match: RegExpExecArray | null;\n    while ((match = placeholderRegex.exec(template)) !== null) {\n      const key = match[1].trim();\n      if (allKeys.includes(key)) {\n        continue;\n      }\n\n      allKeys.push(key);\n\n      const value = this.getNestedValue(data, key);\n      if (value === undefined || value === null) {\n        missingKeys.push(key);\n      }\n    }\n\n    const isValid = missingKeys.length === 0;\n\n    if (!isValid) {\n      this.logger\n        .for(this.validateTemplateData.name)\n        .warn('Template validation failed | Missing keys: %s', missingKeys.join(', '));\n    }\n\n    return { isValid, missingKeys, allKeys };\n  }\n\n  renderSimpleTemplate(\n    template: string,\n    data: Record<string, AnyType>,\n    opts?: { requireValidate?: boolean },\n  ): string {\n    if (opts?.requireValidate) {\n      const validation = this.validateTemplateData({ template, data });\n      if (!validation.isValid) {\n        throw getError({\n          error: MailErrors.INVALID_CONFIGURATION,\n          message: `Missing template data for keys: ${validation.missingKeys.join(', ')}`,\n        });\n      }\n    }\n\n    return template.replace(/\\{\\{(\\s*[\\w.]+\\s*)\\}\\}/g, (match, key) => {\n      const trimmedKey = key.trim();\n      const value = this.getNestedValue(data, trimmedKey);\n\n      if (value === undefined || value === null) {\n        this.logger\n          .for(this.renderSimpleTemplate.name)\n          .warn('Missing value for key: %s', trimmedKey);\n        return match;\n      }\n\n      return String(value);\n    });\n  }\n\n  private getNestedValue(obj: AnyType, path: string) {\n    return path.split('.').reduce((current, key) => {\n      return current?.[key];\n    }, obj);\n  }\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"address.utility.d.ts","sourceRoot":"","sources":["../../../../src/components/mail/utilities/address.utility.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CA8BnE"}

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

@@ -1,36 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.splitAddressList = splitAddressList;
-/**
- * Splits one or more RFC 5322 mailbox strings into individual addresses. A caller-supplied `to`
- * is frequently a single comma-separated string (`"a@x.com, b@y.com"`), not an array - treating
- * it as one opaque address turns it into a single malformed recipient. Splitting only at
- * top-level commas (outside a quoted display name) keeps `"Doe, Jane" <jane@x.com>` intact while
- * still separating `"Doe, Jane" <jane@x.com>, bob@y.com` into its two mailboxes.
- */
-function splitAddressList(value) {
-    const items = Array.isArray(value) ? value : [value];
-    const addresses = [];
-    for (const item of items) {
-        let current = '';
-        let inQuotes = false;
-        for (const char of item) {
-            if (char === '"') {
-                inQuotes = !inQuotes;
-            }
-            if (char === ',' && !inQuotes) {
-                if (current.trim()) {
-                    addresses.push(current.trim());
-                }
-                current = '';
-                continue;
-            }
-            current += char;
-        }
-        if (current.trim()) {
-            addresses.push(current.trim());
-        }
-    }
-    return addresses;
-}
-//# sourceMappingURL=address.utility.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"address.utility.js","sourceRoot":"","sources":["../../../../src/components/mail/utilities/address.utility.ts"],"names":[],"mappings":";;AAOA,4CA8BC;AArCD;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,KAAwB;IACvD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACrD,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,QAAQ,GAAG,CAAC,QAAQ,CAAC;YACvB,CAAC;YAED,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC9B,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;oBACnB,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;gBACjC,CAAC;gBACD,OAAO,GAAG,EAAE,CAAC;gBACb,SAAS;YACX,CAAC;YAED,OAAO,IAAI,IAAI,CAAC;QAClB,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACnB,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["/**\n * Splits one or more RFC 5322 mailbox strings into individual addresses. A caller-supplied `to`\n * is frequently a single comma-separated string (`\"a@x.com, b@y.com\"`), not an array - treating\n * it as one opaque address turns it into a single malformed recipient. Splitting only at\n * top-level commas (outside a quoted display name) keeps `\"Doe, Jane\" <jane@x.com>` intact while\n * still separating `\"Doe, Jane\" <jane@x.com>, bob@y.com` into its two mailboxes.\n */\nexport function splitAddressList(value: string | string[]): string[] {\n  const items = Array.isArray(value) ? value : [value];\n  const addresses: string[] = [];\n\n  for (const item of items) {\n    let current = '';\n    let inQuotes = false;\n\n    for (const char of item) {\n      if (char === '\"') {\n        inQuotes = !inQuotes;\n      }\n\n      if (char === ',' && !inQuotes) {\n        if (current.trim()) {\n          addresses.push(current.trim());\n        }\n        current = '';\n        continue;\n      }\n\n      current += char;\n    }\n\n    if (current.trim()) {\n      addresses.push(current.trim());\n    }\n  }\n\n  return addresses;\n}\n"]}

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

@@ -1,31 +0,0 @@
-import { type IMailAttachment } from '../common';
-/**
- * Reads one attachment's bytes. A string `content` is raw text unless `encoding` says otherwise
- * (nodemailer's convention); `null` counts as absent. A `path` is read only inside
- * `attachmentRoot` and refused without one. `maxBytes` caps the whole message; `usedBytes` is what
- * earlier attachments already took.
- */
-export declare const readAttachmentContent: (opts: {
-    attachment: IMailAttachment;
-    attachmentRoot?: string;
-    maxBytes?: number;
-    usedBytes?: number;
-}) => Promise<Buffer>;
-/**
- * Turns every attachment into `content` bytes and drops `path`, so no transport is ever handed a
- * file or URL to read on its own. `maxBytes` is shared by all attachments of the message. An
- * attachment read from `path` keeps the file's name and, when none is given, its content type.
- */
-export declare const resolveMailAttachments: (opts: {
-    attachments: IMailAttachment[];
-    attachmentRoot?: string;
-    maxBytes?: number;
-}) => Promise<IMailAttachment[]>;
-/**
- * Releases every attachment stream of a refused send, read or not, so none keeps a descriptor
- * open. A drained stream is already closed; releasing it again is harmless.
- */
-export declare const releaseAttachmentStreams: (opts: {
-    attachments?: IMailAttachment[];
-}) => void;
-//# sourceMappingURL=attachment.utility.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"attachment.utility.d.ts","sourceRoot":"","sources":["../../../../src/components/mail/utilities/attachment.utility.ts"],"names":[],"mappings":"AAMA,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAyJ7D;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAU,MAAM;IAChD,UAAU,EAAE,eAAe,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,KAAG,OAAO,CAAC,MAAM,CAgCjB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAU,MAAM;IACjD,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,KAAG,OAAO,CAAC,eAAe,EAAE,CAwC5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GAAI,MAAM;IAAE,WAAW,CAAC,EAAE,eAAe,EAAE,CAAA;CAAE,KAAG,IA0BpF,CAAC"}