@brilab-mailer/core 0.2.1 → 0.2.2

package/cjs/index.js

@@ -0,0 +1,18 @@
+"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("./lib/mailer.service.js"), exports);
+__exportStar(require("./lib/mailer.module.js"), exports);

package/cjs/lib/mailer-sender.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MailerSender = void 0;
+const contracts_1 = require("@brilab-mailer/contracts");
+const template_context_index = 1;
+class MailerSender extends contracts_1.MailerMessagesBuilder {
+    _send;
+    _render;
+    _templateParams = null;
+    constructor(_send, _render) {
+        super();
+        this._send = _send;
+        this._render = _render;
+    }
+    useTemplate(...params) {
+        if (!this._render) {
+            throw new Error('[MailerSender] Templater client is not available');
+        }
+        const prevParams = this._templateParams || ['__no_key__', undefined, undefined];
+        const prevCtx = prevParams[template_context_index] || {};
+        const currCtx = params[template_context_index] || {};
+        params[template_context_index] = { ...prevCtx, ...currCtx };
+        this._templateParams = params;
+        return this;
+    }
+    addTemplateContext(context) {
+        if (!this._render) {
+            throw new Error('[MailerSender] Templater client is not available');
+        }
+        const params = this._templateParams || ['__no_key__', undefined, undefined];
+        params[template_context_index] = { ...(params[template_context_index] || {}), ...context, };
+        this._templateParams = params;
+        return this;
+    }
+    async send() {
+        if (this._templateParams && this._render) {
+            const draft = this.generateDraft() || {};
+            const ctx = this._templateParams[1] || {};
+            this._templateParams[1] = {
+                subject: draft.subject,
+                ...ctx,
+            };
+            const html = await this._render(...this._templateParams);
+            this.setHtml(html);
+        }
+        const resolved = this.prepare();
+        return this._send(resolved);
+    }
+}
+exports.MailerSender = MailerSender;

package/cjs/lib/mailer.constants.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveMailerOptions = exports.MAILER_RETRY_BACKOFF_MS_DEFAULT = exports.MAILER_RETRY_ATTEMPTS_DEFAULT = void 0;
+exports.MAILER_RETRY_ATTEMPTS_DEFAULT = 3;
+exports.MAILER_RETRY_BACKOFF_MS_DEFAULT = [500, 1000, 2000];
+/**
+ * Resolves retry options from the values the application passes in, falling
+ * back to defaults. The library never reads process env itself — the host app
+ * resolves everything (from its own NestJS config) and passes it through
+ * `register({ options })` / `registerAsync(useFactory -> { options })`.
+ */
+const resolveMailerOptions = (overrides) => ({
+    maxAttempts: overrides?.maxAttempts ?? exports.MAILER_RETRY_ATTEMPTS_DEFAULT,
+    backoffMs: overrides?.backoffMs ?? exports.MAILER_RETRY_BACKOFF_MS_DEFAULT,
+});
+exports.resolveMailerOptions = resolveMailerOptions;

package/cjs/lib/mailer.module.js

@@ -0,0 +1,130 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var MailerModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MailerModule = void 0;
+const common_1 = require("@nestjs/common");
+const contracts_1 = require("@brilab-mailer/contracts");
+const mailer_service_js_1 = require("./mailer.service.js");
+const mailer_constants_js_1 = require("./mailer.constants.js");
+let MailerModule = MailerModule_1 = class MailerModule {
+    static register(params) {
+        if (!params?.providerClass) {
+            throw new Error('[MailerModule] providerClass is required. ' +
+                'Example: MailerModule.register({ providerClass: MailtrapApiProvider, templateEngineClass: HandlebarsTemplateEngine })');
+        }
+        return {
+            module: MailerModule_1,
+            imports: [],
+            providers: [
+                {
+                    provide: contracts_1.MAILER_OPTIONS,
+                    useValue: (0, mailer_constants_js_1.resolveMailerOptions)(params.options),
+                },
+                {
+                    provide: contracts_1.MAILER_PROVIDER,
+                    useClass: params.providerClass,
+                },
+                {
+                    provide: contracts_1.MAILER_PROVIDER_OPTIONS,
+                    useValue: params.providerOptions || {},
+                },
+                {
+                    provide: contracts_1.MAILER_PROVIDER_NATIVE_CLIENT,
+                    useFactory: (provider) => provider?.getClient?.(),
+                    inject: [contracts_1.MAILER_PROVIDER],
+                },
+                ...(params.templateEngineClass
+                    ? [
+                        {
+                            provide: contracts_1.MAILER_TEMPLATE_ENGINE,
+                            useClass: params.templateEngineClass,
+                        },
+                        {
+                            provide: contracts_1.MAILER_TEMPLATE_ENGINE_OPTIONS,
+                            useValue: params.templateEngineOptions || {},
+                        },
+                    ]
+                    : []),
+                mailer_service_js_1.MailerService,
+            ],
+            exports: [
+                mailer_service_js_1.MailerService,
+                contracts_1.MAILER_OPTIONS,
+                contracts_1.MAILER_PROVIDER_OPTIONS,
+                contracts_1.MAILER_PROVIDER,
+                contracts_1.MAILER_PROVIDER_NATIVE_CLIENT,
+            ]
+        };
+    }
+    static registerAsync(params) {
+        if (!params?.providerClass) {
+            throw new Error('[MailerModule.registerAsync] providerClass is required.');
+        }
+        if (!params?.useFactory) {
+            throw new Error('[MailerModule.registerAsync] useFactory is required.');
+        }
+        return {
+            module: MailerModule_1,
+            imports: [...(params.imports || [])],
+            providers: [
+                {
+                    provide: contracts_1.MAILER_ASYNC,
+                    useFactory: params.useFactory,
+                    inject: params.inject || [],
+                },
+                {
+                    provide: contracts_1.MAILER_OPTIONS,
+                    useFactory: (asyncCfg) => (0, mailer_constants_js_1.resolveMailerOptions)(asyncCfg?.options),
+                    inject: [contracts_1.MAILER_ASYNC],
+                },
+                {
+                    provide: contracts_1.MAILER_PROVIDER,
+                    useClass: params.providerClass,
+                },
+                {
+                    provide: contracts_1.MAILER_PROVIDER_OPTIONS,
+                    useFactory: (asyncCfg) => asyncCfg?.providerOptions || {},
+                    inject: [contracts_1.MAILER_ASYNC],
+                },
+                {
+                    provide: contracts_1.MAILER_PROVIDER_NATIVE_CLIENT,
+                    useFactory: (provider) => provider?.getClient?.(),
+                    inject: [contracts_1.MAILER_PROVIDER],
+                },
+                ...(params.templateEngineClass
+                    ? [
+                        {
+                            provide: contracts_1.MAILER_TEMPLATE_ENGINE,
+                            useClass: params.templateEngineClass,
+                        },
+                        {
+                            provide: contracts_1.MAILER_TEMPLATE_ENGINE_OPTIONS,
+                            useFactory: (asyncCfg) => asyncCfg?.templateEngineOptions || {},
+                            inject: [contracts_1.MAILER_ASYNC],
+                        },
+                    ]
+                    : []),
+                mailer_service_js_1.MailerService,
+            ],
+            exports: [
+                mailer_service_js_1.MailerService,
+                contracts_1.MAILER_ASYNC,
+                contracts_1.MAILER_OPTIONS,
+                contracts_1.MAILER_PROVIDER_OPTIONS,
+                contracts_1.MAILER_PROVIDER,
+                contracts_1.MAILER_PROVIDER_NATIVE_CLIENT,
+            ]
+        };
+    }
+};
+exports.MailerModule = MailerModule;
+exports.MailerModule = MailerModule = MailerModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], MailerModule);

package/cjs/lib/mailer.service.js

@@ -0,0 +1,94 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MailerService = void 0;
+const common_1 = require("@nestjs/common");
+const contracts_1 = require("@brilab-mailer/contracts");
+const node_crypto_1 = require("node:crypto");
+const mailer_sender_js_1 = require("./mailer-sender.js");
+let MailerService = class MailerService {
+    options;
+    provider;
+    native_client;
+    _templater;
+    constructor(options, provider, native_client, _templater) {
+        this.options = options;
+        this.provider = provider;
+        this.native_client = native_client;
+        this._templater = _templater;
+    }
+    get nativeClient() {
+        const injected = this.native_client;
+        if (injected)
+            return injected;
+        const fromProvider = this.provider.getClient?.();
+        if (fromProvider)
+            return fromProvider;
+        throw new Error('[MailerService] Native client is not available');
+    }
+    get templater() {
+        const tmp = this._templater;
+        if (!tmp || !('render' in tmp))
+            throw new Error('[MailerService] Templater client is not available');
+        return tmp;
+    }
+    async send(resolved) {
+        const payload = this.provider.createPayload(resolved);
+        // One stable key per logical send so the retry loop can't duplicate
+        // emails on providers that honor idempotency (e.g. Resend).
+        const options = {
+            idempotencyKey: resolved.idempotencyKey ?? (0, node_crypto_1.randomUUID)(),
+        };
+        return this.withRetry(() => this.provider.send(payload, options));
+    }
+    sender() {
+        return new mailer_sender_js_1.MailerSender(this.send.bind(this), this._templater?.render?.bind(this._templater));
+    }
+    async withRetry(fn) {
+        const { backoffMs } = this.options;
+        const maxAttempts = Math.max(1, this.options.maxAttempts);
+        let lastError;
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            try {
+                return await fn();
+            }
+            catch (err) {
+                lastError = err;
+                // Permanent failures (e.g. 4xx validation) are not worth retrying.
+                if (err instanceof contracts_1.MailerSendError && !err.retryable)
+                    break;
+                const isLast = attempt >= maxAttempts - 1;
+                if (isLast)
+                    break;
+                const delay = backoffMs.length
+                    ? backoffMs[Math.min(attempt, backoffMs.length - 1)]
+                    : 0;
+                if (delay > 0)
+                    await new Promise((res) => setTimeout(res, delay));
+            }
+        }
+        throw lastError;
+    }
+};
+exports.MailerService = MailerService;
+exports.MailerService = MailerService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(contracts_1.MAILER_OPTIONS)),
+    __param(1, (0, common_1.Inject)(contracts_1.MAILER_PROVIDER)),
+    __param(2, (0, common_1.Optional)()),
+    __param(2, (0, common_1.Inject)(contracts_1.MAILER_PROVIDER_NATIVE_CLIENT)),
+    __param(3, (0, common_1.Optional)()),
+    __param(3, (0, common_1.Inject)(contracts_1.MAILER_TEMPLATE_ENGINE)),
+    __metadata("design:paramtypes", [Object, Object, Object, Object])
+], MailerService);

package/cjs/lib/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/package.json

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

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@brilab-mailer/core",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "author": "Bohdan Radchenko <radchenkobs@gmail.com>",
   "type": "module",
-  "main": "./index.js",
+  "main": "./cjs/index.js",
   "module": "./index.js",
   "types": "./index.d.ts",
   "exports": {
@@ -11,7 +11,7 @@
     ".": {
       "types": "./index.d.ts",
       "import": "./index.js",
-      "default": "./index.js"
+      "require": "./cjs/index.js"
     }
   },
   "files": [
@@ -27,6 +27,6 @@
     "@nestjs/common": "^10.0.0"
   },
   "dependencies": {
-    "@brilab-mailer/contracts": "^0.2.1"
+    "@brilab-mailer/contracts": "^0.2.2"
   }
 }