@zintrust/mail-nodemailer 0.1.8

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+export type NodemailerMailConfig = {
+    driver: 'nodemailer';
+    host: string;
+    port: number;
+    username: string;
+    password: string;
+    secure: boolean | 'starttls';
+};
+export type MailAddress = {
+    email: string;
+    name?: string;
+};
+export type MailAttachment = {
+    filename: string;
+    content: Buffer;
+};
+export type MailMessage = {
+    to: string | string[];
+    from: MailAddress;
+    subject: string;
+    text: string;
+    html?: string;
+    attachments?: MailAttachment[];
+};
+export declare const NodemailerDriver: Readonly<{
+    send(config: NodemailerMailConfig, message: MailMessage): Promise<{
+        ok: boolean;
+        messageId?: string;
+    }>;
+}>;
+export default NodemailerDriver;

package/dist/index.js

@@ -0,0 +1,54 @@
+import { ErrorFactory } from '@zintrust/core';
+async function importNodemailer() {
+    return (await import('nodemailer'));
+}
+function normalizeRecipients(to) {
+    return Array.isArray(to) ? to : [to];
+}
+function formatFrom(from) {
+    const name = (from.name ?? '').trim();
+    return name === '' ? from.email : `${name} <${from.email}>`;
+}
+function mapSecure(value) {
+    if (value === 'starttls')
+        return { secure: false, requireTLS: true };
+    return { secure: Boolean(value) };
+}
+export const NodemailerDriver = Object.freeze({
+    async send(config, message) {
+        const host = (config.host ?? '').trim();
+        const port = Number(config.port);
+        if (host === '') {
+            throw ErrorFactory.createConfigError('Nodemailer: missing MAIL_HOST');
+        }
+        if (!Number.isFinite(port) || port <= 0) {
+            throw ErrorFactory.createConfigError('Nodemailer: invalid MAIL_PORT');
+        }
+        if (message.from.email.trim() === '') {
+            throw ErrorFactory.createConfigError('Mail: missing from.email');
+        }
+        const { createTransport } = await importNodemailer();
+        const tls = mapSecure(config.secure);
+        const authUser = (config.username ?? '').trim();
+        const authPass = (config.password ?? '').trim();
+        const transport = createTransport({
+            host,
+            port,
+            secure: tls.secure,
+            requireTLS: tls.requireTLS,
+            auth: authUser === '' ? undefined : { user: authUser, pass: authPass },
+        });
+        const info = await transport.sendMail({
+            from: formatFrom(message.from),
+            to: normalizeRecipients(message.to).join(','),
+            subject: message.subject,
+            text: message.text,
+            html: typeof message.html === 'string' && message.html !== '' ? message.html : undefined,
+            attachments: message.attachments?.map((a) => ({ filename: a.filename, content: a.content })) ??
+                undefined,
+        });
+        const messageId = typeof info?.messageId === 'string' ? info.messageId : undefined;
+        return { ok: true, messageId };
+    },
+});
+export default NodemailerDriver;

package/dist/register.d.ts

@@ -0,0 +1,8 @@
+type Registry = {
+    register: (driver: string, handler: (cfg: unknown, msg: unknown) => Promise<{
+        ok: boolean;
+        messageId?: string;
+    }>) => void;
+};
+export declare function registerNodemailerDriver(registry: Registry): void;
+export {};

package/dist/register.js

@@ -0,0 +1,10 @@
+import { NodemailerDriver } from './index.js';
+export function registerNodemailerDriver(registry) {
+    registry.register('nodemailer', async (config, message) => {
+        return NodemailerDriver.send(config, message);
+    });
+}
+const core = (await import('@zintrust/core'));
+if (core.MailDriverRegistry !== undefined) {
+    registerNodemailerDriver(core.MailDriverRegistry);
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@zintrust/mail-nodemailer",
+  "version": "0.1.8",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./register": {
+      "types": "./dist/register.d.ts",
+      "default": "./dist/register.js"
+    }
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "peerDependencies": {
+    "@zintrust/core": "^0.1.8"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "nodemailer": "^7.0.11"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  }
+}