@brilab-mailer/provider-mailtrap 0.0.1-beta.47

package/README.md

@@ -0,0 +1,69 @@
+# @brilab-mailer/provider-mailtrap
+
+## Overview
+A production-ready Mailtrap email provider for Brilab Mailer.  
+Supports both API and SMTP versions (API mode recommended).
+
+---
+
+## Configuration
+
+### Environment Variables
+```
+MAILTRAP_API_TOKEN=xxxx
+MAILTRAP_INBOX_ID=12345
+MAILTRAP_SENDER=no-reply@example.com
+```
+
+---
+
+## Installation
+
+```bash
+pnpm add @brilab-mailer/provider-mailtrap
+```
+
+---
+
+## Usage
+
+```ts
+MailerModule.register({
+  providerClass: MailtrapApiProvider,
+  templateEngineClass: HandlebarsTemplateEngine,
+});
+```
+
+---
+
+## Provider Implementation
+
+```ts
+@Injectable()
+export class MailtrapApiProvider implements MailerProvider {
+  async send(options: MailerSendOptions) {
+    await this.client.send({
+      from: { email: this.sender },
+      to: [{ email: options.to }],
+      subject: options.subject,
+      html: options.html,
+    });
+  }
+}
+```
+
+---
+
+## Debugging
+
+- Invalid token → 401
+- Invalid inbox → 404
+- Rate limit → auto-retry recommended in mailer-core
+
+---
+
+## Best Practices
+- Use per-environment inbox IDs  
+- Never store token in repository  
+- Use template engine instead of raw HTML  
+

package/index.d.ts

@@ -0,0 +1,2 @@
+export * from './lib/mailtrap-api.provider.js';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC"}

package/index.js

@@ -0,0 +1 @@
+export * from './lib/mailtrap-api.provider.js';

package/lib/mailtrap-api.provider.d.ts

@@ -0,0 +1,12 @@
+import { MailtrapClient, type MailtrapClientConfig } from 'mailtrap';
+import { MailerProvider, type MailerMessagesResolved } from '@brilab-mailer/contracts';
+import { Mail } from "mailtrap/dist/types/mailtrap.js";
+export declare class MailtrapApiProvider implements MailerProvider<MailtrapClientConfig, MailtrapClient, Mail> {
+    private readonly options;
+    private _client;
+    constructor(options: MailtrapClientConfig);
+    getClient(): MailtrapClient;
+    createPayload(resolved: MailerMessagesResolved): Mail;
+    send(payload: Mail): Promise<void>;
+}
+//# sourceMappingURL=mailtrap-api.provider.d.ts.map

package/lib/mailtrap-api.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailtrap-api.provider.d.ts","sourceRoot":"","sources":["../../src/lib/mailtrap-api.provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EACN,cAAc,EAEd,KAAK,sBAAsB,EAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,iCAAiC,CAAC;AAEvD,qBACa,mBAAoB,YAAW,cAAc,CAAC,oBAAoB,EAAE,cAAc,EAAE,IAAI,CAAC;IAKpG,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJzB,OAAO,CAAC,OAAO,CAAiB;gBAId,OAAO,EAAE,oBAAoB;IAYxC,SAAS,IAAI,cAAc;IAI3B,aAAa,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAqB/C,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAG/C"}

package/lib/mailtrap-api.provider.js

@@ -0,0 +1,50 @@
+import { __decorate, __metadata, __param } from "tslib";
+import { Inject, Injectable } from '@nestjs/common';
+import { MailtrapClient } from 'mailtrap';
+import { MAILER_PROVIDER_OPTIONS, } from '@brilab-mailer/contracts';
+let MailtrapApiProvider = class MailtrapApiProvider {
+    options;
+    _client;
+    constructor(options) {
+        this.options = options;
+        const token = this.options?.token;
+        if (!token)
+            throw new Error('[MailtrapApiProvider] mailtrap token is not set');
+        this._client = new MailtrapClient({
+            token,
+            testInboxId: this.options?.testInboxId,
+            accountId: this.options?.accountId
+        });
+    }
+    getClient() {
+        return this._client;
+    }
+    createPayload(resolved) {
+        const base = {
+            from: resolved.from,
+            to: resolved.to,
+            subject: resolved.subject || '',
+        };
+        switch (resolved.content.kind) {
+            case 'text': return { ...base, text: resolved.content.text };
+            case 'html': return { ...base, html: resolved.content.html };
+            case 'mixed':
+                return {
+                    ...base,
+                    text: resolved.content.text || '',
+                    html: resolved.content.html || ''
+                };
+            default:
+                return { ...base, text: '', html: '' };
+        }
+    }
+    async send(payload) {
+        await this._client.testing.send(payload);
+    }
+};
+MailtrapApiProvider = __decorate([
+    Injectable(),
+    __param(0, Inject(MAILER_PROVIDER_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], MailtrapApiProvider);
+export { MailtrapApiProvider };

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@brilab-mailer/provider-mailtrap",
+  "version": "0.0.1-beta.47",
+  "author": "Bohdan Radchenko <radchenkobs@gmail.com>",
+  "type": "module",
+  "main": "./index.js",
+  "module": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    }
+  },
+  "files": [
+    "**/*",
+    "!**/*.tsbuildinfo"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "directory": "dist"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^10.0.0",
+    "@nestjs/config": "^3.0.0",
+    "@brilab-mailer/contracts": "^0.0.1",
+    "@brilab-mailer/core": "^0.0.1"
+  },
+  "peerDependenciesMeta": {
+    "@brilab-mailer/contracts": {
+      "optional": false
+    },
+    "@brilab-mailer/core": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "mailtrap": "^3.0.0"
+  }
+}