@application-kit/mailer 0.0.0-stage → 0.1.0

package/dist/esm/configs/envs/mailer.environment.js

@@ -0,0 +1,44 @@
+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);
+};
+import { Expose, Type } from 'class-transformer';
+import { IsNumber, IsString } from 'class-validator';
+export class MailerEnvironment {
+    MAIL_FROM = 'no-reply@localhost';
+    MAIL_SMTP_HOST = '';
+    MAIL_SMTP_PASSWORD = '';
+    MAIL_SMTP_PORT = 587;
+    MAIL_SMTP_USER = '';
+}
+__decorate([
+    Expose(),
+    IsString(),
+    __metadata("design:type", Object)
+], MailerEnvironment.prototype, "MAIL_FROM", void 0);
+__decorate([
+    Expose(),
+    IsString(),
+    __metadata("design:type", Object)
+], MailerEnvironment.prototype, "MAIL_SMTP_HOST", void 0);
+__decorate([
+    Expose(),
+    IsString(),
+    __metadata("design:type", Object)
+], MailerEnvironment.prototype, "MAIL_SMTP_PASSWORD", void 0);
+__decorate([
+    Expose(),
+    IsNumber(),
+    Type(() => Number),
+    __metadata("design:type", Object)
+], MailerEnvironment.prototype, "MAIL_SMTP_PORT", void 0);
+__decorate([
+    Expose(),
+    IsString(),
+    __metadata("design:type", Object)
+], MailerEnvironment.prototype, "MAIL_SMTP_USER", void 0);

package/dist/esm/configs/index.d.ts

@@ -0,0 +1,2 @@
+export * from './envs/index.js';
+export * from './mailer.config.js';

package/dist/esm/configs/index.js

@@ -0,0 +1,2 @@
+export * from './envs/index.js';
+export * from './mailer.config.js';

package/dist/esm/configs/mailer.config.d.ts

@@ -0,0 +1,15 @@
+import { MailerEnvironment } from './envs/mailer.environment.js';
+export interface SmtpSettingsInterface {
+    readonly host: string;
+    readonly password: string;
+    readonly port: number;
+    readonly secure: boolean;
+    readonly user: string;
+}
+export declare class MailerConfig {
+    private readonly environment;
+    get from(): string;
+    get isSmtpConfigured(): boolean;
+    get smtp(): SmtpSettingsInterface;
+    constructor(environment: MailerEnvironment);
+}

package/dist/esm/configs/mailer.config.js

@@ -0,0 +1,38 @@
+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);
+};
+import { Injectable } from '@nestjs/common';
+import { MailerEnvironment } from './envs/mailer.environment.js';
+const IMPLICIT_TLS_PORT = 465;
+let MailerConfig = class MailerConfig {
+    environment;
+    get from() {
+        return this.environment.MAIL_FROM;
+    }
+    get isSmtpConfigured() {
+        return this.environment.MAIL_SMTP_HOST !== '';
+    }
+    get smtp() {
+        return {
+            host: this.environment.MAIL_SMTP_HOST,
+            password: this.environment.MAIL_SMTP_PASSWORD,
+            port: this.environment.MAIL_SMTP_PORT,
+            secure: this.environment.MAIL_SMTP_PORT === IMPLICIT_TLS_PORT,
+            user: this.environment.MAIL_SMTP_USER,
+        };
+    }
+    constructor(environment) {
+        this.environment = environment;
+    }
+};
+MailerConfig = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [MailerEnvironment])
+], MailerConfig);
+export { MailerConfig };

package/dist/esm/constants.d.ts

@@ -0,0 +1,7 @@
+export declare const EMAIL_SENDER_PORT: unique symbol;
+export declare const EMAIL_TEMPLATE_RENDERER_PORT: unique symbol;
+export declare const MAILER_PORT: unique symbol;
+export declare const SENT_EMAIL_LOG_PORT: unique symbol;
+export declare const EMAIL_SUBSCRIPTIONS_PORT: unique symbol;
+export declare const EMAIL_TEMPLATE_CATALOG_PORT: unique symbol;
+export declare const MAILER_LOGGER: unique symbol;

package/dist/esm/constants.js

@@ -0,0 +1,7 @@
+export const EMAIL_SENDER_PORT = Symbol('EMAIL_SENDER_PORT');
+export const EMAIL_TEMPLATE_RENDERER_PORT = Symbol('EMAIL_TEMPLATE_RENDERER_PORT');
+export const MAILER_PORT = Symbol('MAILER_PORT');
+export const SENT_EMAIL_LOG_PORT = Symbol('SENT_EMAIL_LOG_PORT');
+export const EMAIL_SUBSCRIPTIONS_PORT = Symbol('EMAIL_SUBSCRIPTIONS_PORT');
+export const EMAIL_TEMPLATE_CATALOG_PORT = Symbol('EMAIL_TEMPLATE_CATALOG_PORT');
+export const MAILER_LOGGER = Symbol('MAILER_LOGGER');

package/dist/esm/index.d.ts

@@ -0,0 +1,6 @@
+export * from './application/index.js';
+export * from './configs/index.js';
+export * from './infrastructure/index.js';
+export * from './constants.js';
+export * from './mailer-logger.js';
+export * from './mailer.module.js';

package/dist/esm/index.js

@@ -0,0 +1,6 @@
+export * from './application/index.js';
+export * from './configs/index.js';
+export * from './infrastructure/index.js';
+export * from './constants.js';
+export * from './mailer-logger.js';
+export * from './mailer.module.js';

package/dist/esm/infrastructure/adapters/index.d.ts

@@ -0,0 +1,3 @@
+export * from './interpolating-email-template-renderer.js';
+export * from './json-mailer.adapter.js';
+export * from './smtp-mailer.adapter.js';

package/dist/esm/infrastructure/adapters/index.js

@@ -0,0 +1,3 @@
+export * from './interpolating-email-template-renderer.js';
+export * from './json-mailer.adapter.js';
+export * from './smtp-mailer.adapter.js';

package/dist/esm/infrastructure/adapters/interpolating-email-template-renderer.d.ts

@@ -0,0 +1,7 @@
+import type { EmailTemplateCatalogInterface } from '../../application/ports/email-template-catalog.interface.js';
+import type { EmailTemplateParameters, EmailTemplateRendererInterface, RenderedEmailInterface } from '../../application/ports/email-template-renderer.interface.js';
+export declare class InterpolatingEmailTemplateRenderer implements EmailTemplateRendererInterface {
+    private readonly catalog;
+    constructor(catalog: EmailTemplateCatalogInterface);
+    render(name: string, locale: string, parameters: EmailTemplateParameters): RenderedEmailInterface;
+}

package/dist/esm/infrastructure/adapters/interpolating-email-template-renderer.js

@@ -0,0 +1,49 @@
+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); }
+};
+import { Inject, Injectable } from '@nestjs/common';
+import { EMAIL_TEMPLATE_CATALOG_PORT } from '../../constants.js';
+const PLACEHOLDER_PATTERN = /\{(?<parameter>\w+)\}/gu;
+const keepAsIs = (value) => value;
+const escapeHtml = (value) => value
+    .replaceAll('&', '&amp;')
+    .replaceAll('"', '&quot;')
+    .replaceAll('\'', '&#39;')
+    .replaceAll('<', '&lt;')
+    .replaceAll('>', '&gt;');
+const interpolate = (template, parameters, transform) => template.replaceAll(PLACEHOLDER_PATTERN, (placeholder, name) => {
+    const value = parameters[name];
+    if (value === undefined) {
+        return placeholder;
+    }
+    return transform(value);
+});
+let InterpolatingEmailTemplateRenderer = class InterpolatingEmailTemplateRenderer {
+    catalog;
+    constructor(catalog) {
+        this.catalog = catalog;
+    }
+    render(name, locale, parameters) {
+        const template = this.catalog.get(name, locale);
+        return {
+            html: interpolate(template.html, parameters, escapeHtml),
+            subject: interpolate(template.subject, parameters, keepAsIs),
+            text: interpolate(template.text, parameters, keepAsIs),
+        };
+    }
+};
+InterpolatingEmailTemplateRenderer = __decorate([
+    Injectable(),
+    __param(0, Inject(EMAIL_TEMPLATE_CATALOG_PORT)),
+    __metadata("design:paramtypes", [Object])
+], InterpolatingEmailTemplateRenderer);
+export { InterpolatingEmailTemplateRenderer };

package/dist/esm/infrastructure/adapters/json-mailer.adapter.d.ts

@@ -0,0 +1,7 @@
+import type { MailerLoggerInterface } from '../../application/ports/mailer-logger.interface.js';
+import type { MailerInterface, MailerMessageInterface } from '../../application/ports/mailer.interface.js';
+export declare class JsonMailerAdapter implements MailerInterface {
+    private readonly logger;
+    constructor(logger: MailerLoggerInterface);
+    send(message: MailerMessageInterface): Promise<void>;
+}

package/dist/esm/infrastructure/adapters/json-mailer.adapter.js

@@ -0,0 +1,25 @@
+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);
+};
+import { Injectable } from '@nestjs/common';
+let JsonMailerAdapter = class JsonMailerAdapter {
+    logger;
+    constructor(logger) {
+        this.logger = logger;
+    }
+    async send(message) {
+        this.logger.warn({ html: message.html, subject: message.subject, text: message.text, to: message.to }, 'Email dumped to the log: SMTP is not configured');
+        await Promise.resolve();
+    }
+};
+JsonMailerAdapter = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [Object])
+], JsonMailerAdapter);
+export { JsonMailerAdapter };

package/dist/esm/infrastructure/adapters/smtp-mailer.adapter.d.ts

@@ -0,0 +1,8 @@
+import type { MailerInterface, MailerMessageInterface } from '../../application/ports/mailer.interface.js';
+import { MailerConfig } from '../../configs/mailer.config.js';
+export declare class SmtpMailerAdapter implements MailerInterface {
+    private readonly config;
+    private readonly transporter;
+    constructor(config: MailerConfig);
+    send(message: MailerMessageInterface): Promise<void>;
+}

package/dist/esm/infrastructure/adapters/smtp-mailer.adapter.js

@@ -0,0 +1,41 @@
+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);
+};
+import { Injectable } from '@nestjs/common';
+import { createTransport } from 'nodemailer';
+import { MailerConfig } from '../../configs/mailer.config.js';
+let SmtpMailerAdapter = class SmtpMailerAdapter {
+    config;
+    transporter;
+    constructor(config) {
+        this.config = config;
+        const { host, password, port, secure, user } = config.smtp;
+        this.transporter = createTransport({
+            auth: user === '' ? undefined : { pass: password, user },
+            host,
+            port,
+            requireTLS: true,
+            secure,
+        });
+    }
+    async send(message) {
+        await this.transporter.sendMail({
+            from: this.config.from,
+            html: message.html,
+            subject: message.subject,
+            text: message.text,
+            to: message.to,
+        });
+    }
+};
+SmtpMailerAdapter = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [MailerConfig])
+], SmtpMailerAdapter);
+export { SmtpMailerAdapter };

package/dist/esm/infrastructure/database/index.d.ts

@@ -0,0 +1 @@
+export * from './typeorm/index.js';

package/dist/esm/infrastructure/database/index.js

@@ -0,0 +1 @@
+export * from './typeorm/index.js';

package/dist/esm/infrastructure/database/typeorm/entities/index.d.ts

@@ -0,0 +1 @@
+export * from './sent-email.entity.js';

package/dist/esm/infrastructure/database/typeorm/entities/index.js

@@ -0,0 +1 @@
+export * from './sent-email.entity.js';

package/dist/esm/infrastructure/database/typeorm/entities/sent-email.entity.d.ts

@@ -0,0 +1,4 @@
+export declare class SentEmailEntity {
+    idempotencyKey: string;
+    sentAt: Date;
+}

package/dist/esm/infrastructure/database/typeorm/entities/sent-email.entity.js

@@ -0,0 +1,27 @@
+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);
+};
+import { CreateDateColumn, Entity, PrimaryColumn } from 'typeorm';
+import { EMAIL_IDEMPOTENCY_KEY_MAX_LENGTH, } from '../../../../application/services/email-idempotency-key.service.js';
+let SentEmailEntity = class SentEmailEntity {
+    idempotencyKey;
+    sentAt;
+};
+__decorate([
+    PrimaryColumn({ length: EMAIL_IDEMPOTENCY_KEY_MAX_LENGTH, type: 'varchar' }),
+    __metadata("design:type", String)
+], SentEmailEntity.prototype, "idempotencyKey", void 0);
+__decorate([
+    CreateDateColumn({ type: 'timestamp without time zone' }),
+    __metadata("design:type", Date)
+], SentEmailEntity.prototype, "sentAt", void 0);
+SentEmailEntity = __decorate([
+    Entity()
+], SentEmailEntity);
+export { SentEmailEntity };

package/dist/esm/infrastructure/database/typeorm/index.d.ts

@@ -0,0 +1,3 @@
+export * from './entities/index.js';
+export * from './migrations/index.js';
+export * from './repositories/index.js';

package/dist/esm/infrastructure/database/typeorm/index.js

@@ -0,0 +1,3 @@
+export * from './entities/index.js';
+export * from './migrations/index.js';
+export * from './repositories/index.js';

package/dist/esm/infrastructure/database/typeorm/migrations/add-sent-emails.migration.d.ts

@@ -0,0 +1,6 @@
+import type { MigrationInterface, QueryRunner } from 'typeorm';
+export declare class AddSentEmails1790231050588 implements MigrationInterface {
+    name: string;
+    down(queryRunner: QueryRunner): Promise<void>;
+    up(queryRunner: QueryRunner): Promise<void>;
+}

package/dist/esm/infrastructure/database/typeorm/migrations/add-sent-emails.migration.js

@@ -0,0 +1,9 @@
+export class AddSentEmails1790231050588 {
+    name = 'AddSentEmails1790231050588';
+    async down(queryRunner) {
+        await queryRunner.query(`DROP TABLE "sent_emails"`);
+    }
+    async up(queryRunner) {
+        await queryRunner.query(`CREATE TABLE "sent_emails" ("idempotency_key" character varying(128) NOT NULL, "sent_at" TIMESTAMP NOT NULL DEFAULT now(), CONSTRAINT "PK_5940884b20d8dacfb3fba3e01bb" PRIMARY KEY ("idempotency_key"))`);
+    }
+}

package/dist/esm/infrastructure/database/typeorm/migrations/index.d.ts

@@ -0,0 +1 @@
+export * from './add-sent-emails.migration.js';

package/dist/esm/infrastructure/database/typeorm/migrations/index.js

@@ -0,0 +1 @@
+export * from './add-sent-emails.migration.js';

package/dist/esm/infrastructure/database/typeorm/repositories/index.d.ts

@@ -0,0 +1 @@
+export * from './sent-email-log.repository.js';

package/dist/esm/infrastructure/database/typeorm/repositories/index.js

@@ -0,0 +1 @@
+export * from './sent-email-log.repository.js';

package/dist/esm/infrastructure/database/typeorm/repositories/sent-email-log.repository.d.ts

@@ -0,0 +1,9 @@
+import { Repository } from 'typeorm';
+import { SentEmailLogInterface } from '../../../../application/ports/sent-email-log.interface.js';
+import { SentEmailEntity } from '../entities/sent-email.entity.js';
+export declare class SentEmailLogRepository implements SentEmailLogInterface {
+    private readonly repository;
+    constructor(repository: Repository<SentEmailEntity>);
+    claim(key: string): Promise<boolean>;
+    release(key: string): Promise<void>;
+}

package/dist/esm/infrastructure/database/typeorm/repositories/sent-email-log.repository.js

@@ -0,0 +1,41 @@
+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); }
+};
+import { Injectable } from '@nestjs/common';
+import { InjectRepository } from '@nestjs/typeorm';
+import { Repository } from 'typeorm';
+import { SentEmailEntity } from '../entities/sent-email.entity.js';
+let SentEmailLogRepository = class SentEmailLogRepository {
+    repository;
+    constructor(repository) {
+        this.repository = repository;
+    }
+    async claim(key) {
+        const inserted = await this.repository
+            .createQueryBuilder()
+            .insert()
+            .into(SentEmailEntity)
+            .values({ idempotencyKey: key })
+            .orIgnore()
+            .execute();
+        return inserted.identifiers.length > 0;
+    }
+    async release(key) {
+        await this.repository.delete({ idempotencyKey: key });
+    }
+};
+SentEmailLogRepository = __decorate([
+    Injectable(),
+    __param(0, InjectRepository(SentEmailEntity)),
+    __metadata("design:paramtypes", [Repository])
+], SentEmailLogRepository);
+export { SentEmailLogRepository };

package/dist/esm/infrastructure/index.d.ts

@@ -0,0 +1,2 @@
+export * from './adapters/index.js';
+export * from './database/index.js';

package/dist/esm/infrastructure/index.js

@@ -0,0 +1,2 @@
+export * from './adapters/index.js';
+export * from './database/index.js';

package/dist/esm/mailer-logger.d.ts

@@ -0,0 +1,5 @@
+import * as nestjsPino from 'nestjs-pino';
+import type { MailerLoggerInterface } from './application/ports/mailer-logger.interface.js';
+export declare class MailerLogger extends nestjsPino.PinoLogger implements MailerLoggerInterface {
+    constructor(options: nestjsPino.Params);
+}

package/dist/esm/mailer-logger.js

@@ -0,0 +1,23 @@
+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 MailerLogger_1;
+import { Injectable } from '@nestjs/common';
+import * as nestjsPino from 'nestjs-pino';
+let MailerLogger = MailerLogger_1 = class MailerLogger extends nestjsPino.PinoLogger {
+    constructor(options) {
+        super(options);
+        this.setContext(MailerLogger_1.name);
+    }
+};
+MailerLogger = MailerLogger_1 = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [Object])
+], MailerLogger);
+export { MailerLogger };

package/dist/esm/mailer.module.d.ts

@@ -0,0 +1,9 @@
+import type { DynamicModule, Type } from '@nestjs/common';
+import type { EmailTemplateCatalogInterface } from './application/ports/email-template-catalog.interface.js';
+export interface MailerModuleOptionsInterface {
+    readonly subscriptions: Type;
+    readonly templates: Type<EmailTemplateCatalogInterface>;
+}
+export declare class MailerModule {
+    static register(options: MailerModuleOptionsInterface): DynamicModule;
+}

package/dist/esm/mailer.module.js

@@ -0,0 +1,52 @@
+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;
+};
+import { ConfigsModule } from '@libs-for-dev/nestjs-config-module';
+import { Module } from '@nestjs/common';
+import { TypeOrmModule } from '@nestjs/typeorm';
+import { EmailDispatcherService } from './application/services/email-dispatcher.service.js';
+import { EmailIdempotencyKeyService } from './application/services/email-idempotency-key.service.js';
+import { EmailSenderService } from './application/services/email-sender.service.js';
+import { MailerEnvironment } from './configs/envs/mailer.environment.js';
+import { MailerConfig } from './configs/mailer.config.js';
+import { EMAIL_SENDER_PORT, EMAIL_TEMPLATE_CATALOG_PORT, EMAIL_TEMPLATE_RENDERER_PORT, MAILER_LOGGER, MAILER_PORT, SENT_EMAIL_LOG_PORT, } from './constants.js';
+import { InterpolatingEmailTemplateRenderer } from './infrastructure/adapters/interpolating-email-template-renderer.js';
+import { JsonMailerAdapter } from './infrastructure/adapters/json-mailer.adapter.js';
+import { SmtpMailerAdapter } from './infrastructure/adapters/smtp-mailer.adapter.js';
+import { SentEmailEntity } from './infrastructure/database/typeorm/entities/sent-email.entity.js';
+import { SentEmailLogRepository } from './infrastructure/database/typeorm/repositories/sent-email-log.repository.js';
+const selectMailer = (config, logger) => (config.isSmtpConfigured
+    ? new SmtpMailerAdapter(config)
+    : new JsonMailerAdapter(logger));
+const mailerByConfig = {
+    inject: [MailerConfig, MAILER_LOGGER],
+    provide: MAILER_PORT,
+    useFactory: selectMailer,
+};
+let MailerModule = class MailerModule {
+    static register(options) {
+        return {
+            imports: [ConfigsModule.forFeature([MailerConfig], [MailerEnvironment]), options.subscriptions],
+            module: this,
+            providers: [{ provide: EMAIL_TEMPLATE_CATALOG_PORT, useClass: options.templates }],
+        };
+    }
+};
+MailerModule = __decorate([
+    Module({
+        exports: [EmailDispatcherService],
+        imports: [TypeOrmModule.forFeature([SentEmailEntity])],
+        providers: [
+            { provide: EMAIL_SENDER_PORT, useClass: EmailSenderService },
+            { provide: EMAIL_TEMPLATE_RENDERER_PORT, useClass: InterpolatingEmailTemplateRenderer },
+            { provide: SENT_EMAIL_LOG_PORT, useClass: SentEmailLogRepository },
+            EmailDispatcherService,
+            EmailIdempotencyKeyService,
+            mailerByConfig,
+        ],
+    })
+], MailerModule);
+export { MailerModule };

package/dist/esm/testing/email-sender.fake.d.ts

@@ -0,0 +1,7 @@
+import type { EmailSenderInterface, SendEmailRequestInterface, SendEmailResult } from '../application/ports/email-sender.interface.js';
+export declare class FakeEmailSender implements EmailSenderInterface {
+    result: SendEmailResult;
+    readonly resultByTemplate: Map<string, SendEmailResult>;
+    readonly sent: SendEmailRequestInterface[];
+    send(request: SendEmailRequestInterface): Promise<SendEmailResult>;
+}

package/dist/esm/testing/email-sender.fake.js

@@ -0,0 +1,11 @@
+import { Ok } from 'oxide.ts';
+export class FakeEmailSender {
+    result = Ok(true);
+    resultByTemplate = new Map();
+    sent = [];
+    async send(request) {
+        await Promise.resolve();
+        this.sent.push(request);
+        return this.resultByTemplate.get(request.template) ?? this.result;
+    }
+}

package/dist/esm/testing/email-subscriptions.fake.d.ts

@@ -0,0 +1,6 @@
+import type { EmailSubscriptionInterface, EmailSubscriptionsInterface } from '../application/ports/email-subscriptions.interface.js';
+export declare class FakeEmailSubscriptions implements EmailSubscriptionsInterface {
+    private readonly unsubscribed;
+    isSubscribed(subscription: EmailSubscriptionInterface): Promise<boolean>;
+    unsubscribe(subscription: EmailSubscriptionInterface): void;
+}

package/dist/esm/testing/email-subscriptions.fake.js

@@ -0,0 +1,11 @@
+const keyOf = ({ accountId, category }) => `${accountId}:${category}`;
+export class FakeEmailSubscriptions {
+    unsubscribed = new Set();
+    async isSubscribed(subscription) {
+        await Promise.resolve();
+        return !this.unsubscribed.has(keyOf(subscription));
+    }
+    unsubscribe(subscription) {
+        this.unsubscribed.add(keyOf(subscription));
+    }
+}

package/dist/esm/testing/email-template-catalog.fake.d.ts

@@ -0,0 +1,11 @@
+import type { EmailTemplateCatalogInterface, EmailTemplateInterface } from '../application/ports/email-template-catalog.interface.js';
+export interface EmailTemplateRequestInterface {
+    readonly locale: string;
+    readonly name: string;
+}
+export declare class FakeEmailTemplateCatalog implements EmailTemplateCatalogInterface {
+    readonly requests: EmailTemplateRequestInterface[];
+    private template;
+    get(name: string, locale: string): EmailTemplateInterface;
+    returns(template: EmailTemplateInterface): void;
+}

package/dist/esm/testing/email-template-catalog.fake.js

@@ -0,0 +1,11 @@
+export class FakeEmailTemplateCatalog {
+    requests = [];
+    template = { html: '<p>{name}</p>', subject: 'subject', text: '{name}' };
+    get(name, locale) {
+        this.requests.push({ locale, name });
+        return this.template;
+    }
+    returns(template) {
+        this.template = template;
+    }
+}

package/dist/esm/testing/email-template-renderer.fake.d.ts

@@ -0,0 +1,12 @@
+import type { EmailTemplateParameters, EmailTemplateRendererInterface, RenderedEmailInterface } from '../application/ports/email-template-renderer.interface.js';
+export interface EmailRenderRequestInterface {
+    readonly locale: string;
+    readonly name: string;
+    readonly parameters: EmailTemplateParameters;
+}
+export declare class FakeEmailTemplateRenderer implements EmailTemplateRendererInterface {
+    readonly requests: EmailRenderRequestInterface[];
+    private rendered;
+    render(name: string, locale: string, parameters: EmailTemplateParameters): RenderedEmailInterface;
+    returns(rendered: RenderedEmailInterface): void;
+}