@zenith-open/zenithcms-plugin-email 1.0.0-beta.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aman T Shekar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import { ZenithPlugin } from '@zenith-open/zenithcms-types';
+export interface EmailPluginConfig {
+    defaultFrom?: string;
+    resendKey?: string;
+    smtpHost?: string;
+    smtpPort?: number;
+    smtpUser?: string;
+    smtpPass?: string;
+}
+export declare const emailEnginePlugin: (config?: EmailPluginConfig) => ZenithPlugin;

package/dist/index.js

@@ -0,0 +1,122 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emailEnginePlugin = void 0;
+const resend_1 = require("resend");
+const nodemailer_1 = __importDefault(require("nodemailer"));
+const emailEnginePlugin = (config) => {
+    return {
+        id: 'email-engine',
+        name: 'Email Engine',
+        description: 'Handles email delivery via SMTP or Resend.',
+        apply: () => { },
+        onReady: async (ctx) => {
+            const resolveConfig = async (overrideSettings, siteId) => {
+                const activeConfig = {
+                    resendKey: process.env.RESEND_API_KEY || config?.resendKey,
+                    smtpHost: process.env.SMTP_HOST || config?.smtpHost,
+                    smtpPort: parseInt(process.env.SMTP_PORT || '') || config?.smtpPort || 587,
+                    smtpUser: process.env.SMTP_USER || config?.smtpUser,
+                    smtpPass: process.env.SMTP_PASS || config?.smtpPass,
+                    fromEmail: process.env.EMAIL_FROM || config?.defaultFrom || 'Zenith CMS <noreply@zenith.local>'
+                };
+                if (overrideSettings) {
+                    if (overrideSettings.smtpHost)
+                        activeConfig.smtpHost = overrideSettings.smtpHost;
+                    if (overrideSettings.smtpPort)
+                        activeConfig.smtpPort = overrideSettings.smtpPort;
+                    if (overrideSettings.smtpUser)
+                        activeConfig.smtpUser = overrideSettings.smtpUser;
+                    if (overrideSettings.smtpPass && overrideSettings.smtpPass !== '[MASKED_CREDENTIAL]')
+                        activeConfig.smtpPass = overrideSettings.smtpPass;
+                    if (overrideSettings.fromEmail)
+                        activeConfig.fromEmail = overrideSettings.fromEmail;
+                    return activeConfig;
+                }
+                try {
+                    const adapter = ctx.adapter;
+                    if (adapter && adapter.findOne) {
+                        const query = siteId ? { siteId } : {};
+                        const settings = await adapter.findOne('z_settings', query);
+                        if (settings) {
+                            if (settings.smtpHost)
+                                activeConfig.smtpHost = settings.smtpHost;
+                            if (settings.smtpPort)
+                                activeConfig.smtpPort = settings.smtpPort;
+                            if (settings.smtpUser)
+                                activeConfig.smtpUser = settings.smtpUser;
+                            if (settings.smtpPass && settings.smtpPass !== '[MASKED_CREDENTIAL]')
+                                activeConfig.smtpPass = settings.smtpPass;
+                            if (settings.fromEmail)
+                                activeConfig.fromEmail = settings.fromEmail;
+                            if (settings.resendKey && settings.resendKey !== '[MASKED_CREDENTIAL]')
+                                activeConfig.resendKey = settings.resendKey;
+                        }
+                    }
+                }
+                catch (e) {
+                    ctx.logger.warn('[Email Plugin] Failed to load email config from database settings');
+                }
+                return activeConfig;
+            };
+            const anyCtx = ctx;
+            if (anyCtx.eventHub) {
+                anyCtx.eventHub.on('email:send', async (payload) => {
+                    const { options, overrideSettings, siteId } = payload;
+                    const activeConfig = await resolveConfig(overrideSettings, siteId);
+                    const from = options.from || activeConfig.fromEmail;
+                    const to = Array.isArray(options.to) ? options.to : [options.to];
+                    // 1. Try SMTP if configured
+                    if (activeConfig.smtpHost) {
+                        try {
+                            const transporter = nodemailer_1.default.createTransport({
+                                host: activeConfig.smtpHost,
+                                port: activeConfig.smtpPort,
+                                secure: activeConfig.smtpPort === 465,
+                                auth: (activeConfig.smtpUser && activeConfig.smtpPass) ? {
+                                    user: activeConfig.smtpUser,
+                                    pass: activeConfig.smtpPass
+                                } : undefined
+                            });
+                            await transporter.sendMail({
+                                from,
+                                to,
+                                subject: options.subject,
+                                html: options.html,
+                                text: options.text,
+                            });
+                            ctx.logger.info(`[Email Plugin] Sent via SMTP to ${to.join(',')}`);
+                            return;
+                        }
+                        catch (err) {
+                            ctx.logger.error(`[Email Plugin] SMTP failed: ${err.message}`);
+                        }
+                    }
+                    // 2. Try Resend if configured
+                    if (activeConfig.resendKey) {
+                        try {
+                            const client = new resend_1.Resend(activeConfig.resendKey);
+                            await client.emails.send({
+                                from,
+                                to,
+                                subject: options.subject,
+                                html: options.html,
+                                text: options.text,
+                            });
+                            ctx.logger.info(`[Email Plugin] Sent via Resend to ${to.join(',')}`);
+                            return;
+                        }
+                        catch (err) {
+                            ctx.logger.error(`[Email Plugin] Resend failed: ${err.message}`);
+                        }
+                    }
+                    ctx.logger.warn('[Email Plugin] No valid SMTP or Resend config found to dispatch email.');
+                });
+            }
+            ctx.logger.info('[Email Plugin] Initialized and listening for email events.');
+        }
+    };
+};
+exports.emailEnginePlugin = emailEnginePlugin;

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@zenith-open/zenithcms-plugin-email",
+  "version": "1.0.0-beta.10",
+  "description": "Email Engine Plugin for Zenith CMS (Nodemailer & Resend)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "nodemailer": "^6.9.13",
+    "resend": "^3.2.0"
+  },
+  "devDependencies": {
+    "@types/nodemailer": "^6.4.14",
+    "typescript": "^5.4.5"
+  },
+  "peerDependencies": {
+    "@zenith-open/zenithcms-core": "1.0.0-beta.10",
+    "@zenith-open/zenithcms-types": "1.0.0-beta.10"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc"
+  }
+}