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

package/README.md

@@ -0,0 +1,81 @@
+# @brilab-mailer/provider-smtp
+
+## Overview
+Generic SMTP provider that supports any SMTP-compatible service:
+- Gmail  
+- Outlook  
+- SendGrid SMTP  
+- Mailgun SMTP  
+- Custom SMTP servers  
+
+---
+
+## Environment Variables
+
+```
+SMTP_HOST=smtp.example.com
+SMTP_PORT=587
+SMTP_SECURE=false
+SMTP_USER=example
+SMTP_PASS=password
+SMTP_FROM=no-reply@example.com
+```
+
+---
+
+## Installation
+
+```bash
+pnpm add @brilab-mailer/provider-smtp nodemailer
+```
+
+---
+
+## Provider Implementation Summary
+
+The SMTP provider:
+- creates a nodemailer transport  
+- validates credentials  
+- sends messages via SMTP protocol  
+
+---
+
+## Usage in Core
+
+```ts
+MailerModule.register({
+  providerClass: SmtpMailProvider,
+  templateEngineClass: HandlebarsTemplateEngine,
+});
+```
+
+---
+
+## Example Email
+
+```ts
+await this.mailer.send({
+  to: 'user@example.com',
+  subject: 'Order Confirmation',
+  html: await this.mailer.render('order', { id: 123 }),
+});
+```
+
+---
+
+## Security Recommendations
+- ALWAYS rotate SMTP passwords  
+- Use app passwords where possible  
+- Disable insecure ports (25)  
+- Use encrypted SMTP (TLS)  
+
+---
+
+## Troubleshooting
+
+| Error | Meaning | Fix |
+|------|---------|-----|
+| `ECONNREFUSED` | Cannot connect | wrong host/port |
+| `EAUTH` | Auth failed | wrong credentials |
+| `ETIMEDOUT` | Firewall blocks connection | allow outbound 587 |
+

package/index.d.ts

@@ -0,0 +1,2 @@
+export * from './lib/smtp-mail.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,6BAA6B,CAAC"}

package/index.js

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

package/lib/smtp-mail.provider.d.ts

@@ -0,0 +1,22 @@
+import { ConfigService } from '@nestjs/config';
+import * as nodemailer from 'nodemailer';
+import { type MailerMessagesResolved, MailerProvider } from '@brilab-mailer/contracts';
+import { Address, AttachmentLike } from "nodemailer/lib/mailer/index.js";
+import { Readable } from "stream";
+type MailOptionsType = {
+    from?: string | Address | undefined;
+    to?: string | Address | Array<string | Address> | undefined;
+    subject?: string | undefined;
+    text?: string | Buffer | Readable | AttachmentLike | undefined;
+    html?: string | Buffer | Readable | AttachmentLike | undefined;
+};
+export declare class SmtpMailProvider implements MailerProvider<any, any> {
+    private readonly config;
+    private _client;
+    constructor(config: ConfigService);
+    getClient(): nodemailer.Transporter;
+    createPayload(resolved: MailerMessagesResolved): MailOptionsType;
+    send(payload: MailOptionsType): Promise<void>;
+}
+export {};
+//# sourceMappingURL=smtp-mail.provider.d.ts.map

package/lib/smtp-mail.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smtp-mail.provider.d.ts","sourceRoot":"","sources":["../../src/lib/smtp-mail.provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,UAAU,MAAM,YAAY,CAAC;AACzC,OAAO,EACL,KAAK,sBAAsB,EAC3B,cAAc,EACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAElC,KAAK,eAAe,GAAG;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACpC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,SAAS,CAAC;IAC5D,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;IAC/D,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;CAChE,CAAA;AAED,qBACa,gBAAiB,YAAW,cAAc,CAAC,GAAG,EAAC,GAAG,CAAC;IAGlD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,OAAO,CAAyB;gBAEX,MAAM,EAAE,aAAa;IAY3C,SAAS,IAAI,UAAU,CAAC,WAAW;IAKnC,aAAa,CAAC,QAAQ,EAAE,sBAAsB,GAAG,eAAe;IAejE,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAGpD"}

package/lib/smtp-mail.provider.js

@@ -0,0 +1,39 @@
+import { __decorate, __metadata } from "tslib";
+import { Injectable } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import * as nodemailer from 'nodemailer';
+import { segmentedDataContentPayload, } from '@brilab-mailer/contracts';
+let SmtpMailProvider = class SmtpMailProvider {
+    config;
+    _client;
+    constructor(config) {
+        this.config = config;
+        this._client = nodemailer.createTransport({
+            host: this.config.get('MAIL_HOST'),
+            port: this.config.get('MAIL_PORT'),
+            auth: {
+                user: this.config.get('MAIL_USER'),
+                pass: this.config.get('MAIL_PASS'),
+            },
+        });
+    }
+    getClient() {
+        return this._client;
+    }
+    createPayload(resolved) {
+        const base = {
+            from: resolved.from.email,
+            to: resolved.to.map((t) => t.email).join(', '),
+            subject: resolved.subject,
+        };
+        return segmentedDataContentPayload(resolved, null, null, base);
+    }
+    async send(payload) {
+        await this._client.sendMail(payload);
+    }
+};
+SmtpMailProvider = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [ConfigService])
+], SmtpMailProvider);
+export { SmtpMailProvider };

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@brilab-mailer/provider-smtp",
+  "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
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "@types/nodemailer": "^6.4.0"
+  },
+  "dependencies": {
+    "nodemailer": "6.9.4"
+  }
+}