@application-kit/mailer 0.0.0-stage → 0.1.0

package/dist/cjs/mailer.module.js

@@ -0,0 +1,55 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MailerModule = void 0;
+const nestjs_config_module_1 = require("@libs-for-dev/nestjs-config-module");
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("@nestjs/typeorm");
+const email_dispatcher_service_js_1 = require("./application/services/email-dispatcher.service.js");
+const email_idempotency_key_service_js_1 = require("./application/services/email-idempotency-key.service.js");
+const email_sender_service_js_1 = require("./application/services/email-sender.service.js");
+const mailer_environment_js_1 = require("./configs/envs/mailer.environment.js");
+const mailer_config_js_1 = require("./configs/mailer.config.js");
+const constants_js_1 = require("./constants.js");
+const interpolating_email_template_renderer_js_1 = require("./infrastructure/adapters/interpolating-email-template-renderer.js");
+const json_mailer_adapter_js_1 = require("./infrastructure/adapters/json-mailer.adapter.js");
+const smtp_mailer_adapter_js_1 = require("./infrastructure/adapters/smtp-mailer.adapter.js");
+const sent_email_entity_js_1 = require("./infrastructure/database/typeorm/entities/sent-email.entity.js");
+const sent_email_log_repository_js_1 = require("./infrastructure/database/typeorm/repositories/sent-email-log.repository.js");
+const selectMailer = (config, logger) => (config.isSmtpConfigured
+    ? new smtp_mailer_adapter_js_1.SmtpMailerAdapter(config)
+    : new json_mailer_adapter_js_1.JsonMailerAdapter(logger));
+const mailerByConfig = {
+    inject: [mailer_config_js_1.MailerConfig, constants_js_1.MAILER_LOGGER],
+    provide: constants_js_1.MAILER_PORT,
+    useFactory: selectMailer,
+};
+let MailerModule = class MailerModule {
+    static register(options) {
+        return {
+            imports: [nestjs_config_module_1.ConfigsModule.forFeature([mailer_config_js_1.MailerConfig], [mailer_environment_js_1.MailerEnvironment]), options.subscriptions],
+            module: this,
+            providers: [{ provide: constants_js_1.EMAIL_TEMPLATE_CATALOG_PORT, useClass: options.templates }],
+        };
+    }
+};
+exports.MailerModule = MailerModule;
+exports.MailerModule = MailerModule = __decorate([
+    (0, common_1.Module)({
+        exports: [email_dispatcher_service_js_1.EmailDispatcherService],
+        imports: [typeorm_1.TypeOrmModule.forFeature([sent_email_entity_js_1.SentEmailEntity])],
+        providers: [
+            { provide: constants_js_1.EMAIL_SENDER_PORT, useClass: email_sender_service_js_1.EmailSenderService },
+            { provide: constants_js_1.EMAIL_TEMPLATE_RENDERER_PORT, useClass: interpolating_email_template_renderer_js_1.InterpolatingEmailTemplateRenderer },
+            { provide: constants_js_1.SENT_EMAIL_LOG_PORT, useClass: sent_email_log_repository_js_1.SentEmailLogRepository },
+            email_dispatcher_service_js_1.EmailDispatcherService,
+            email_idempotency_key_service_js_1.EmailIdempotencyKeyService,
+            mailerByConfig,
+        ],
+    })
+], MailerModule);

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/cjs/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/cjs/testing/email-sender.fake.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FakeEmailSender = void 0;
+const oxide_ts_1 = require("oxide.ts");
+class FakeEmailSender {
+    result = (0, oxide_ts_1.Ok)(true);
+    resultByTemplate = new Map();
+    sent = [];
+    async send(request) {
+        await Promise.resolve();
+        this.sent.push(request);
+        return this.resultByTemplate.get(request.template) ?? this.result;
+    }
+}
+exports.FakeEmailSender = FakeEmailSender;

package/dist/cjs/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/cjs/testing/email-subscriptions.fake.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FakeEmailSubscriptions = void 0;
+const keyOf = ({ accountId, category }) => `${accountId}:${category}`;
+class FakeEmailSubscriptions {
+    unsubscribed = new Set();
+    async isSubscribed(subscription) {
+        await Promise.resolve();
+        return !this.unsubscribed.has(keyOf(subscription));
+    }
+    unsubscribe(subscription) {
+        this.unsubscribed.add(keyOf(subscription));
+    }
+}
+exports.FakeEmailSubscriptions = FakeEmailSubscriptions;

package/dist/cjs/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/cjs/testing/email-template-catalog.fake.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FakeEmailTemplateCatalog = void 0;
+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;
+    }
+}
+exports.FakeEmailTemplateCatalog = FakeEmailTemplateCatalog;

package/dist/cjs/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;
+}

package/dist/cjs/testing/email-template-renderer.fake.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FakeEmailTemplateRenderer = void 0;
+class FakeEmailTemplateRenderer {
+    requests = [];
+    rendered = {
+        html: '<p>rendered html</p>',
+        subject: 'rendered subject',
+        text: 'rendered text',
+    };
+    render(name, locale, parameters) {
+        this.requests.push({ locale, name, parameters });
+        return this.rendered;
+    }
+    returns(rendered) {
+        this.rendered = rendered;
+    }
+}
+exports.FakeEmailTemplateRenderer = FakeEmailTemplateRenderer;

package/dist/cjs/testing/index.d.ts

@@ -0,0 +1,6 @@
+export * from './email-sender.fake.js';
+export * from './email-subscriptions.fake.js';
+export * from './email-template-catalog.fake.js';
+export * from './email-template-renderer.fake.js';
+export * from './mailer.fake.js';
+export * from './sent-email-log.fake.js';

package/dist/cjs/testing/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./email-sender.fake.js"), exports);
+__exportStar(require("./email-subscriptions.fake.js"), exports);
+__exportStar(require("./email-template-catalog.fake.js"), exports);
+__exportStar(require("./email-template-renderer.fake.js"), exports);
+__exportStar(require("./mailer.fake.js"), exports);
+__exportStar(require("./sent-email-log.fake.js"), exports);

package/dist/cjs/testing/mailer.fake.d.ts

@@ -0,0 +1,8 @@
+import type { MailerInterface, MailerMessageInterface } from '../application/ports/mailer.interface.js';
+export declare class FakeMailer implements MailerInterface {
+    readonly sent: MailerMessageInterface[];
+    private failure;
+    failWith(error: Error): void;
+    recover(): void;
+    send(message: MailerMessageInterface): Promise<void>;
+}

package/dist/cjs/testing/mailer.fake.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FakeMailer = void 0;
+class FakeMailer {
+    sent = [];
+    failure = undefined;
+    failWith(error) {
+        this.failure = error;
+    }
+    recover() {
+        this.failure = undefined;
+    }
+    async send(message) {
+        await Promise.resolve();
+        if (this.failure !== undefined) {
+            throw this.failure;
+        }
+        this.sent.push(message);
+    }
+}
+exports.FakeMailer = FakeMailer;

package/dist/cjs/testing/sent-email-log.fake.d.ts

@@ -0,0 +1,8 @@
+import type { SentEmailLogInterface } from '../application/ports/sent-email-log.interface.js';
+export declare class FakeSentEmailLog implements SentEmailLogInterface {
+    readonly claimed: Set<string>;
+    private failure;
+    claim(key: string): Promise<boolean>;
+    failWith(error: Error): void;
+    release(key: string): Promise<void>;
+}

package/dist/cjs/testing/sent-email-log.fake.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FakeSentEmailLog = void 0;
+class FakeSentEmailLog {
+    claimed = new Set();
+    failure = undefined;
+    async claim(key) {
+        await Promise.resolve();
+        if (this.failure !== undefined) {
+            throw this.failure;
+        }
+        if (this.claimed.has(key)) {
+            return false;
+        }
+        this.claimed.add(key);
+        return true;
+    }
+    failWith(error) {
+        this.failure = error;
+    }
+    async release(key) {
+        await Promise.resolve();
+        this.claimed.delete(key);
+    }
+}
+exports.FakeSentEmailLog = FakeSentEmailLog;

package/dist/esm/application/errors/index.d.ts

@@ -0,0 +1 @@
+export * from './send-email.error.js';

package/dist/esm/application/errors/index.js

@@ -0,0 +1 @@
+export * from './send-email.error.js';

package/dist/esm/application/errors/send-email.error.d.ts

@@ -0,0 +1,8 @@
+export interface SendEmailErrorContextInterface {
+    locale: string;
+    template: string;
+}
+export declare class SendEmailError extends Error {
+    readonly context: SendEmailErrorContextInterface;
+    constructor(context: SendEmailErrorContextInterface, options?: ErrorOptions);
+}

package/dist/esm/application/errors/send-email.error.js

@@ -0,0 +1,8 @@
+export class SendEmailError extends Error {
+    context;
+    constructor(context, options) {
+        super(`Email delivery failed for template "${context.template}"`, options);
+        this.name = 'SendEmailError';
+        this.context = context;
+    }
+}

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

@@ -0,0 +1,3 @@
+export * from './errors/index.js';
+export * from './ports/index.js';
+export * from './services/index.js';

package/dist/esm/application/index.js

@@ -0,0 +1,3 @@
+export * from './errors/index.js';
+export * from './ports/index.js';
+export * from './services/index.js';

package/dist/esm/application/ports/email-sender.interface.d.ts

@@ -0,0 +1,14 @@
+import type { Result } from 'oxide.ts';
+import type { SendEmailError } from '../errors/send-email.error.js';
+import type { EmailTemplateParameters } from './email-template-renderer.interface.js';
+export interface EmailSenderInterface {
+    send(request: SendEmailRequestInterface): Promise<SendEmailResult>;
+}
+export interface SendEmailRequestInterface {
+    readonly idempotencyMaterial: readonly string[];
+    readonly locale: string;
+    readonly parameters: EmailTemplateParameters;
+    readonly template: string;
+    readonly to: string;
+}
+export type SendEmailResult = Result<true, SendEmailError>;

package/dist/esm/application/ports/email-sender.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/application/ports/email-subscriptions.interface.d.ts

@@ -0,0 +1,10 @@
+export type EmailCategory = keyof EmailCategoryRegistryInterface;
+export interface EmailCategoryRegistryInterface {
+}
+export interface EmailSubscriptionInterface {
+    readonly accountId: string;
+    readonly category: EmailCategory;
+}
+export interface EmailSubscriptionsInterface {
+    isSubscribed(subscription: EmailSubscriptionInterface): Promise<boolean>;
+}

package/dist/esm/application/ports/email-subscriptions.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/application/ports/email-template-catalog.interface.d.ts

@@ -0,0 +1,8 @@
+export interface EmailTemplateCatalogInterface {
+    get(name: string, locale: string): EmailTemplateInterface;
+}
+export interface EmailTemplateInterface {
+    readonly html: string;
+    readonly subject: string;
+    readonly text: string;
+}

package/dist/esm/application/ports/email-template-catalog.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/application/ports/email-template-renderer.interface.d.ts

@@ -0,0 +1,9 @@
+export type EmailTemplateParameters = Readonly<Record<string, string>>;
+export interface EmailTemplateRendererInterface {
+    render(name: string, locale: string, parameters: EmailTemplateParameters): RenderedEmailInterface;
+}
+export interface RenderedEmailInterface {
+    readonly html: string;
+    readonly subject: string;
+    readonly text: string;
+}

package/dist/esm/application/ports/email-template-renderer.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/application/ports/index.d.ts

@@ -0,0 +1,7 @@
+export * from './email-sender.interface.js';
+export * from './email-subscriptions.interface.js';
+export * from './email-template-catalog.interface.js';
+export * from './email-template-renderer.interface.js';
+export * from './mailer-logger.interface.js';
+export * from './mailer.interface.js';
+export * from './sent-email-log.interface.js';

package/dist/esm/application/ports/index.js

@@ -0,0 +1,7 @@
+export * from './email-sender.interface.js';
+export * from './email-subscriptions.interface.js';
+export * from './email-template-catalog.interface.js';
+export * from './email-template-renderer.interface.js';
+export * from './mailer-logger.interface.js';
+export * from './mailer.interface.js';
+export * from './sent-email-log.interface.js';

package/dist/esm/application/ports/mailer-logger.interface.d.ts

@@ -0,0 +1,5 @@
+export interface MailerLoggerInterface {
+    error(context: unknown, message: string): void;
+    info(context: unknown, message: string): void;
+    warn(context: unknown, message: string): void;
+}

package/dist/esm/application/ports/mailer-logger.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/application/ports/mailer.interface.d.ts

@@ -0,0 +1,9 @@
+export interface MailerInterface {
+    send(message: MailerMessageInterface): Promise<void>;
+}
+export interface MailerMessageInterface {
+    readonly html: string;
+    readonly subject: string;
+    readonly text: string;
+    readonly to: string;
+}

package/dist/esm/application/ports/mailer.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/application/ports/sent-email-log.interface.d.ts

@@ -0,0 +1,4 @@
+export interface SentEmailLogInterface {
+    claim(key: string): Promise<boolean>;
+    release(key: string): Promise<void>;
+}

package/dist/esm/application/ports/sent-email-log.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/application/services/email-dispatcher.service.d.ts

@@ -0,0 +1,12 @@
+import type { EmailSenderInterface, SendEmailRequestInterface } from '../ports/email-sender.interface.js';
+import type { EmailSubscriptionInterface, EmailSubscriptionsInterface } from '../ports/email-subscriptions.interface.js';
+import type { MailerLoggerInterface } from '../ports/mailer-logger.interface.js';
+export declare class EmailDispatcherService {
+    private readonly emails;
+    private readonly logger;
+    private readonly subscriptions;
+    constructor(emails: EmailSenderInterface, logger: MailerLoggerInterface, subscriptions: EmailSubscriptionsInterface);
+    sendIfSubscribed(subscription: EmailSubscriptionInterface, request: SendEmailRequestInterface, failureMessage: string): Promise<void>;
+    sendOrLog(request: SendEmailRequestInterface, failureMessage: string): Promise<void>;
+    sendOrRethrow(request: SendEmailRequestInterface, failureMessage: string): Promise<void>;
+}

package/dist/esm/application/services/email-dispatcher.service.js

@@ -0,0 +1,53 @@
+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_SENDER_PORT, EMAIL_SUBSCRIPTIONS_PORT, MAILER_LOGGER } from '../../constants.js';
+let EmailDispatcherService = class EmailDispatcherService {
+    emails;
+    logger;
+    subscriptions;
+    constructor(emails, logger, subscriptions) {
+        this.emails = emails;
+        this.logger = logger;
+        this.subscriptions = subscriptions;
+    }
+    async sendIfSubscribed(subscription, request, failureMessage) {
+        if (!await this.subscriptions.isSubscribed(subscription)) {
+            return;
+        }
+        await this.sendOrLog(request, failureMessage);
+    }
+    async sendOrLog(request, failureMessage) {
+        const result = await this.emails.send(request);
+        if (result.isErr()) {
+            this.logger.error({ err: result.unwrapErr() }, failureMessage);
+        }
+    }
+    async sendOrRethrow(request, failureMessage) {
+        const result = await this.emails.send(request);
+        if (result.isOk()) {
+            return;
+        }
+        const error = result.unwrapErr();
+        this.logger.error({ err: error }, failureMessage);
+        throw error;
+    }
+};
+EmailDispatcherService = __decorate([
+    Injectable(),
+    __param(0, Inject(EMAIL_SENDER_PORT)),
+    __param(1, Inject(MAILER_LOGGER)),
+    __param(2, Inject(EMAIL_SUBSCRIPTIONS_PORT)),
+    __metadata("design:paramtypes", [Object, Object, Object])
+], EmailDispatcherService);
+export { EmailDispatcherService };

package/dist/esm/application/services/email-idempotency-key.service.d.ts

@@ -0,0 +1,4 @@
+export declare const EMAIL_IDEMPOTENCY_KEY_MAX_LENGTH = 128;
+export declare class EmailIdempotencyKeyService {
+    build(template: string, ...material: string[]): string;
+}

package/dist/esm/application/services/email-idempotency-key.service.js

@@ -0,0 +1,21 @@
+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 { Injectable } from '@nestjs/common';
+import { createHash } from 'node:crypto';
+export const EMAIL_IDEMPOTENCY_KEY_MAX_LENGTH = 128;
+const MATERIAL_SEPARATOR = String.fromCodePoint(0);
+let EmailIdempotencyKeyService = class EmailIdempotencyKeyService {
+    build(template, ...material) {
+        const digest = createHash('sha256').update(material.join(MATERIAL_SEPARATOR))
+            .digest('hex');
+        return `${template}:${digest}`;
+    }
+};
+EmailIdempotencyKeyService = __decorate([
+    Injectable()
+], EmailIdempotencyKeyService);
+export { EmailIdempotencyKeyService };

package/dist/esm/application/services/email-sender.service.d.ts

@@ -0,0 +1,17 @@
+import type { EmailSenderInterface, SendEmailRequestInterface, SendEmailResult } from '../ports/email-sender.interface.js';
+import type { EmailTemplateRendererInterface } from '../ports/email-template-renderer.interface.js';
+import type { MailerLoggerInterface } from '../ports/mailer-logger.interface.js';
+import type { MailerInterface } from '../ports/mailer.interface.js';
+import type { SentEmailLogInterface } from '../ports/sent-email-log.interface.js';
+import { EmailIdempotencyKeyService } from './email-idempotency-key.service.js';
+export declare class EmailSenderService implements EmailSenderInterface {
+    private readonly mailer;
+    private readonly renderer;
+    private readonly sentEmails;
+    private readonly keys;
+    private readonly logger;
+    constructor(mailer: MailerInterface, renderer: EmailTemplateRendererInterface, sentEmails: SentEmailLogInterface, keys: EmailIdempotencyKeyService, logger: MailerLoggerInterface);
+    send(request: SendEmailRequestInterface): Promise<SendEmailResult>;
+    private failAndRelease;
+    private skipRepeat;
+}

package/dist/esm/application/services/email-sender.service.js

@@ -0,0 +1,66 @@
+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 { Err, Ok } from 'oxide.ts';
+import { EMAIL_TEMPLATE_RENDERER_PORT, MAILER_LOGGER, MAILER_PORT, SENT_EMAIL_LOG_PORT, } from '../../constants.js';
+import { SendEmailError } from '../errors/send-email.error.js';
+import { EmailIdempotencyKeyService } from './email-idempotency-key.service.js';
+let EmailSenderService = class EmailSenderService {
+    mailer;
+    renderer;
+    sentEmails;
+    keys;
+    logger;
+    constructor(mailer, renderer, sentEmails, keys, logger) {
+        this.mailer = mailer;
+        this.renderer = renderer;
+        this.sentEmails = sentEmails;
+        this.keys = keys;
+        this.logger = logger;
+    }
+    async send(request) {
+        const idempotencyKey = this.keys.build(request.template, ...request.idempotencyMaterial);
+        const isClaimed = await this.sentEmails.claim(idempotencyKey);
+        if (!isClaimed) {
+            return this.skipRepeat(idempotencyKey);
+        }
+        const rendered = this.renderer.render(request.template, request.locale, request.parameters);
+        try {
+            await this.mailer.send({ ...rendered, to: request.to });
+        }
+        catch (error) {
+            return this.failAndRelease(request, idempotencyKey, error);
+        }
+        this.logger.info({ locale: request.locale, template: request.template, to: request.to }, 'Email handed to the transport');
+        return Ok(true);
+    }
+    async failAndRelease(request, idempotencyKey, error) {
+        await this.sentEmails.release(idempotencyKey);
+        const failure = new SendEmailError({ locale: request.locale, template: request.template }, { cause: error });
+        this.logger.error(failure.context, failure.message);
+        return Err(failure);
+    }
+    skipRepeat(idempotencyKey) {
+        this.logger.info({ idempotencyKey }, 'Email already sent for this idempotency key, skipping');
+        return Ok(true);
+    }
+};
+EmailSenderService = __decorate([
+    Injectable(),
+    __param(0, Inject(MAILER_PORT)),
+    __param(1, Inject(EMAIL_TEMPLATE_RENDERER_PORT)),
+    __param(2, Inject(SENT_EMAIL_LOG_PORT)),
+    __param(4, Inject(MAILER_LOGGER)),
+    __metadata("design:paramtypes", [Object, Object, Object, EmailIdempotencyKeyService, Object])
+], EmailSenderService);
+export { EmailSenderService };

package/dist/esm/application/services/index.d.ts

@@ -0,0 +1,3 @@
+export * from './email-dispatcher.service.js';
+export * from './email-idempotency-key.service.js';
+export * from './email-sender.service.js';

package/dist/esm/application/services/index.js

@@ -0,0 +1,3 @@
+export * from './email-dispatcher.service.js';
+export * from './email-idempotency-key.service.js';
+export * from './email-sender.service.js';

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

@@ -0,0 +1 @@
+export * from './mailer.environment.js';

package/dist/esm/configs/envs/index.js

@@ -0,0 +1 @@
+export * from './mailer.environment.js';

package/dist/esm/configs/envs/mailer.environment.d.ts

@@ -0,0 +1,7 @@
+export declare class MailerEnvironment {
+    MAIL_FROM: string;
+    MAIL_SMTP_HOST: string;
+    MAIL_SMTP_PASSWORD: string;
+    MAIL_SMTP_PORT: number;
+    MAIL_SMTP_USER: string;
+}