@venizia/ignis 0.4.3 → 0.4.5

package/dist/esm/components/mail/services/generators/verification-data.js

@@ -0,0 +1,46 @@
+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 DefaultVerificationDataGenerator_1;
+import { inject } from '../../../../base/metadata/index.js';
+import { BaseHelper } from '@venizia/ignis-helpers/core';
+import { MailKeys } from '../../common/index.js';
+import { getExpiryTime, getExpiryTimeInHours } from '../../utilities/index.js';
+let DefaultVerificationDataGenerator = DefaultVerificationDataGenerator_1 = class DefaultVerificationDataGenerator extends BaseHelper {
+    constructor(codeGenerator, tokenGenerator) {
+        super({ scope: DefaultVerificationDataGenerator_1.name });
+        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: getExpiryTime(options.codeExpiryMinutes).toISOString(),
+            codeAttempts: 0,
+            verificationToken: token,
+            tokenGeneratedAt: now,
+            tokenExpiresAt: getExpiryTimeInHours(options.tokenExpiryHours).toISOString(),
+            lastCodeSentAt: now,
+        };
+    }
+};
+DefaultVerificationDataGenerator = DefaultVerificationDataGenerator_1 = __decorate([
+    __param(0, inject({ key: MailKeys.MAIL_VERIFICATION_CODE_GENERATOR })),
+    __param(1, inject({ key: MailKeys.MAIL_VERIFICATION_TOKEN_GENERATOR })),
+    __metadata("design:paramtypes", [Object, Object])
+], DefaultVerificationDataGenerator);
+export { DefaultVerificationDataGenerator };
+//# sourceMappingURL=verification-data.js.map

package/dist/esm/components/mail/services/generators/verification-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-data.js","sourceRoot":"","sources":["../../../../../../src/components/mail/services/generators/verification-data.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AASzD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEtE,IAAa,gCAAgC,wCAA7C,MAAa,gCACX,SAAQ,UAAU;IAGlB,YAEU,aAAyC,EAGzC,cAA2C;QAEnD,KAAK,CAAC,EAAE,KAAK,EAAE,kCAAgC,CAAC,IAAI,EAAE,CAAC,CAAC;QALhD,kBAAa,GAAb,aAAa,CAA4B;QAGzC,mBAAc,GAAd,cAAc,CAA6B;IAGrD,CAAC;IAED,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,aAAa,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,WAAW,EAAE;YACrE,YAAY,EAAE,CAAC;YAEf,iBAAiB,EAAE,KAAK;YACxB,gBAAgB,EAAE,GAAG;YACrB,cAAc,EAAE,oBAAoB,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,WAAW,EAAE;YAE5E,cAAc,EAAE,GAAG;SACpB,CAAC;IACJ,CAAC;CACF,CAAA;AAhCY,gCAAgC;IAKxC,WAAA,MAAM,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,gCAAgC,EAAE,CAAC,CAAA;IAG1D,WAAA,MAAM,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,iCAAiC,EAAE,CAAC,CAAA;;GARnD,gCAAgC,CAgC5C","sourcesContent":["import { inject } from '@/base/metadata';\nimport { BaseHelper } from '@venizia/ignis-helpers/core';\n// Interfaces are `import type`: with emitDecoratorMetadata on, a value import of a type-only name survives transpilation and the ESM named-import check fails at load.\nimport type {\n  IVerificationCodeGenerator,\n  IVerificationData,\n  IVerificationDataGenerator,\n  IVerificationGenerationOptions,\n  IVerificationTokenGenerator,\n} from '../../common';\nimport { MailKeys } from '../../common';\nimport { getExpiryTime, getExpiryTimeInHours } from '../../utilities';\n\nexport class DefaultVerificationDataGenerator\n  extends BaseHelper\n  implements IVerificationDataGenerator\n{\n  constructor(\n    @inject({ key: MailKeys.MAIL_VERIFICATION_CODE_GENERATOR })\n    private codeGenerator: IVerificationCodeGenerator,\n\n    @inject({ key: MailKeys.MAIL_VERIFICATION_TOKEN_GENERATOR })\n    private tokenGenerator: IVerificationTokenGenerator,\n  ) {\n    super({ scope: DefaultVerificationDataGenerator.name });\n  }\n\n  generateVerificationData(options: IVerificationGenerationOptions): IVerificationData {\n    const code = this.codeGenerator.generateCode(options.codeLength);\n    const token = this.tokenGenerator.generateToken(options.tokenBytes);\n    const now = new Date().toISOString();\n\n    return {\n      verificationCode: code,\n      codeGeneratedAt: now,\n      codeExpiresAt: getExpiryTime(options.codeExpiryMinutes).toISOString(),\n      codeAttempts: 0,\n\n      verificationToken: token,\n      tokenGeneratedAt: now,\n      tokenExpiresAt: getExpiryTimeInHours(options.tokenExpiryHours).toISOString(),\n\n      lastCodeSentAt: now,\n    };\n  }\n}\n"]}

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

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

package/dist/esm/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,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}

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

@@ -0,0 +1,4 @@
+export * from './generators/index.js';
+export * from './mail.service.js';
+export * from './template.service.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/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,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC","sourcesContent":["export * from './generators';\nexport * from './mail.service';\nexport * from './template.service';\n"]}

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

@@ -0,0 +1,23 @@
+import { BaseService } from '@venizia/ignis-kernel';
+import type { IMailMessage, IMailSendResult, IMailService, IMailTemplateEngine, IMailTransport, TMailOptions } from '../common/index.js';
+import { type AnyType } from '@venizia/ignis-helpers/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/esm/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":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,YAAY,EACb,MAAM,WAAW,CAAC;AAInB,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAK7D,qBAAa,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;IAQ1C,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC;IAiDrD,SAAS,CACb,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACjC,OAAO,CAAC,eAAe,EAAE,CAAC;IA4CvB,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;IAiBhC,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAyBtD,SAAS,CAAC,cAAc,IAAI,MAAM;CAcnC"}

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

@@ -0,0 +1,206 @@
+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;
+import { HTTP } from '@venizia/ignis-helpers/common';
+import { BaseService } from '@venizia/ignis-kernel';
+import { MailDefaults, MailErrorCodes, MailErrors, MailKeys } from '../common/index.js';
+import { inject } from '../../../base/metadata/index.js';
+import { getError, isApplicationError } from '@venizia/ignis-helpers/core';
+import { executePromiseWithLimit } from '@venizia/ignis-helpers';
+import { releaseAttachmentStreams, resolveMailAttachments } from '../utilities/attachment.utility.js';
+import { assertMailBodyIsText } from '../utilities/body.utility.js';
+let MailService = MailService_1 = class MailService extends 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 resolveMailAttachments({
+                    attachments: message.attachments,
+                    attachmentRoot: this.options.attachmentRoot,
+                    maxBytes: this.options.maxAttachmentBytes ?? 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);
+            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 (isApplicationError(error)) {
+                throw error;
+            }
+            throw getError({
+                statusCode: HTTP.ResultCodes.RS_5.InternalServerError,
+                messageCode: 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 ?? 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 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 getError({
+                statusCode: HTTP.ResultCodes.RS_5.InternalServerError,
+                messageCode: 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 getError({
+                    statusCode: HTTP.ResultCodes.RS_5.InternalServerError,
+                    messageCode: 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 getError({
+                statusCode: HTTP.ResultCodes.RS_5.InternalServerError,
+                messageCode: MailErrorCodes.VERIFICATION_FAILED,
+                message: 'Mail transport verification failed',
+                cause: error,
+            });
+        }
+    }
+    validateMessage(message) {
+        if (!message.to || (Array.isArray(message.to) && message.to.length === 0)) {
+            throw getError({
+                error: MailErrors.INVALID_RECIPIENT,
+                message: 'Recipient email address is required',
+            });
+        }
+        if (!message.subject) {
+            throw getError({
+                error: MailErrors.INVALID_CONFIGURATION,
+                message: 'Email subject is required',
+            });
+        }
+        if (!message.text && !message.html) {
+            throw getError({
+                error: MailErrors.INVALID_CONFIGURATION,
+                message: 'Email must have either text or html content',
+            });
+        }
+        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 MailDefaults.FALLBACK_FROM;
+        }
+        if (!fromName) {
+            return from;
+        }
+        return `"${fromName}" <${from}>`;
+    }
+};
+MailService = MailService_1 = __decorate([
+    __param(0, inject({ key: MailKeys.MAIL_OPTIONS })),
+    __param(1, inject({ key: MailKeys.MAIL_TRANSPORT_INSTANCE })),
+    __param(2, inject({ key: MailKeys.MAIL_TEMPLATE_ENGINE, isOptional: true })),
+    __metadata("design:paramtypes", [Object, Object, Object])
+], MailService);
+export { MailService };
+//# sourceMappingURL=mail.service.js.map

package/dist/esm/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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","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/esm/components/mail/services/template.service.d.ts

@@ -0,0 +1,36 @@
+import { BaseService } from '@venizia/ignis-kernel';
+import type { IMailTemplateEngine, ITemplate } from '../common/index.js';
+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/esm/components/mail/services/template.service.d.ts.map

@@ -0,0 +1 @@
+{"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/esm/components/mail/services/template.service.js

@@ -0,0 +1,111 @@
+import { BaseService } from '@venizia/ignis-kernel';
+import { MailErrors } from '../common/index.js';
+import { getError } from '@venizia/ignis-helpers/core';
+export class TemplateEngineService extends 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 getError({ message: 'Either templateName or templateData must be provided' });
+        }
+        let content = templateData;
+        if (!content && templateName) {
+            const template = this.templates.get(templateName);
+            if (!template) {
+                throw getError({
+                    error: 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 getError({
+                    error: 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);
+    }
+}
+//# sourceMappingURL=template.service.js.map

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

@@ -0,0 +1 @@
+{"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/esm/components/mail/utilities/address.utility.d.ts.map

@@ -0,0 +1 @@
+{"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/esm/components/mail/utilities/address.utility.js

@@ -0,0 +1,33 @@
+/**
+ * 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.
+ */
+export 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/esm/components/mail/utilities/address.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.utility.js","sourceRoot":"","sources":["../../../../../src/components/mail/utilities/address.utility.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,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/esm/components/mail/utilities/attachment.utility.d.ts

@@ -0,0 +1,31 @@
+import { type IMailAttachment } from '../common/index.js';
+/**
+ * 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/esm/components/mail/utilities/attachment.utility.d.ts.map

@@ -0,0 +1 @@
+{"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"}