@cinnabun/mail 0.0.1

package/dist/adapters/console.adapter.d.ts

@@ -0,0 +1,8 @@
+import type { MailMessage } from "../interfaces/mail-message.js";
+import type { MailAdapter } from "../interfaces/mail-adapter.js";
+export declare class ConsoleAdapter implements MailAdapter {
+    private connected;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    send(message: MailMessage): Promise<void>;
+}

package/dist/adapters/console.adapter.js

@@ -0,0 +1,26 @@
+export class ConsoleAdapter {
+    connected = false;
+    async connect() {
+        this.connected = true;
+    }
+    async disconnect() {
+        this.connected = false;
+    }
+    async send(message) {
+        if (!this.connected) {
+            throw new Error("ConsoleAdapter not connected. Call connect() first.");
+        }
+        const to = Array.isArray(message.to) ? message.to.join(", ") : message.to;
+        const lines = [
+            "--- Email (Console Adapter) ---",
+            `To: ${to}`,
+            message.from ? `From: ${message.from}` : null,
+            `Subject: ${message.subject}`,
+            "---",
+            message.text ? `Text:\n${message.text}` : null,
+            message.html ? `HTML:\n${message.html}` : null,
+            "---",
+        ].filter(Boolean);
+        console.log(lines.join("\n"));
+    }
+}

package/dist/adapters/smtp.adapter.d.ts

@@ -0,0 +1,19 @@
+import type { MailMessage } from "../interfaces/mail-message.js";
+import type { MailAdapter } from "../interfaces/mail-adapter.js";
+export interface SmtpAdapterConfig {
+    host: string;
+    port: number;
+    secure?: boolean;
+    auth?: {
+        user: string;
+        pass: string;
+    };
+}
+export declare class SmtpAdapter implements MailAdapter {
+    private transporter;
+    private readonly config;
+    constructor(config: SmtpAdapterConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    send(message: MailMessage): Promise<void>;
+}

package/dist/adapters/smtp.adapter.js

@@ -0,0 +1,48 @@
+export class SmtpAdapter {
+    transporter = null;
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async connect() {
+        const nodemailer = await import("nodemailer");
+        this.transporter = nodemailer.createTransport({
+            host: this.config.host,
+            port: this.config.port,
+            secure: this.config.secure ?? this.config.port === 465,
+            auth: this.config.auth,
+        });
+    }
+    async disconnect() {
+        if (this.transporter) {
+            this.transporter.close();
+            this.transporter = null;
+        }
+    }
+    async send(message) {
+        if (!this.transporter) {
+            throw new Error("SmtpAdapter not connected. Call connect() first.");
+        }
+        const mailOptions = {
+            to: Array.isArray(message.to) ? message.to : [message.to],
+            from: message.from,
+            subject: message.subject,
+            text: message.text,
+            html: message.html,
+        };
+        if (message.cc) {
+            mailOptions.cc = Array.isArray(message.cc) ? message.cc : [message.cc];
+        }
+        if (message.bcc) {
+            mailOptions.bcc = Array.isArray(message.bcc) ? message.bcc : [message.bcc];
+        }
+        if (message.attachments?.length) {
+            mailOptions.attachments = message.attachments.map((a) => ({
+                filename: a.filename,
+                content: a.content,
+                contentType: a.contentType,
+            }));
+        }
+        await this.transporter.sendMail(mailOptions);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export type { MailMessage, Attachment } from "./interfaces/mail-message.js";
+export type { MailAdapter } from "./interfaces/mail-adapter.js";
+export type { MailModuleOptions } from "./interfaces/mail-options.js";
+export { SmtpAdapter } from "./adapters/smtp.adapter.js";
+export { ConsoleAdapter } from "./adapters/console.adapter.js";
+export { MailService } from "./services/mail.service.js";
+export { TemplateService } from "./services/template.service.js";
+export { MailModule } from "./mail.module.js";
+export { MailPlugin } from "./mail.plugin.js";
+export { getMailService } from "./mail-service-holder.js";

package/dist/index.js

@@ -0,0 +1,7 @@
+export { SmtpAdapter } from "./adapters/smtp.adapter.js";
+export { ConsoleAdapter } from "./adapters/console.adapter.js";
+export { MailService } from "./services/mail.service.js";
+export { TemplateService } from "./services/template.service.js";
+export { MailModule } from "./mail.module.js";
+export { MailPlugin } from "./mail.plugin.js";
+export { getMailService } from "./mail-service-holder.js";

package/dist/interfaces/mail-adapter.d.ts

@@ -0,0 +1,6 @@
+import type { MailMessage } from "./mail-message.js";
+export interface MailAdapter {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    send(message: MailMessage): Promise<void>;
+}

package/dist/interfaces/mail-adapter.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/mail-message.d.ts

@@ -0,0 +1,15 @@
+export interface Attachment {
+    filename: string;
+    content: Buffer | string;
+    contentType?: string;
+}
+export interface MailMessage {
+    to: string | string[];
+    from?: string;
+    subject: string;
+    text?: string;
+    html?: string;
+    cc?: string | string[];
+    bcc?: string | string[];
+    attachments?: Attachment[];
+}

package/dist/interfaces/mail-message.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/mail-options.d.ts

@@ -0,0 +1,17 @@
+export interface MailModuleOptions {
+    adapter: "smtp" | "console";
+    from?: string;
+    smtp?: {
+        host: string;
+        port: number;
+        secure?: boolean;
+        auth?: {
+            user: string;
+            pass: string;
+        };
+    };
+    templates?: {
+        dir?: string;
+        engine?: "handlebars" | "ejs";
+    };
+}

package/dist/interfaces/mail-options.js

@@ -0,0 +1 @@
+export {};

package/dist/mail-service-holder.d.ts

@@ -0,0 +1,3 @@
+import type { MailService } from "./services/mail.service.js";
+export declare function setMailService(service: MailService): void;
+export declare function getMailService(): MailService | null;

package/dist/mail-service-holder.js

@@ -0,0 +1,7 @@
+let mailServiceInstance = null;
+export function setMailService(service) {
+    mailServiceInstance = service;
+}
+export function getMailService() {
+    return mailServiceInstance;
+}

package/dist/mail.module.d.ts

@@ -0,0 +1,11 @@
+import type { MailModuleOptions } from "./interfaces/mail-options.js";
+import type { MailAdapter } from "./interfaces/mail-adapter.js";
+import { MailPlugin } from "./mail.plugin.js";
+export declare class MailModule {
+    static forRoot(options: MailModuleOptions): Function;
+    static getOptions(): MailModuleOptions;
+    static createAdapter(): MailAdapter;
+    static createPlugin(): MailPlugin;
+    static setService(name: string, service: unknown): void;
+    static getService<T>(name: string): T;
+}

package/dist/mail.module.js

@@ -0,0 +1,58 @@
+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;
+};
+import { Module } from "@cinnabun/core";
+import { SmtpAdapter } from "./adapters/smtp.adapter.js";
+import { ConsoleAdapter } from "./adapters/console.adapter.js";
+import { MailPlugin } from "./mail.plugin.js";
+let moduleOptions = null;
+let _services = {};
+export class MailModule {
+    static forRoot(options) {
+        moduleOptions = options;
+        _services = {};
+        let MailDynamicModule = class MailDynamicModule {
+        };
+        MailDynamicModule = __decorate([
+            Module({
+                imports: [],
+                controllers: [],
+                providers: [],
+                exports: [],
+            })
+        ], MailDynamicModule);
+        return MailDynamicModule;
+    }
+    static getOptions() {
+        if (!moduleOptions) {
+            throw new Error("MailModule not initialized. Call MailModule.forRoot() first.");
+        }
+        return moduleOptions;
+    }
+    static createAdapter() {
+        const options = MailModule.getOptions();
+        if (options.adapter === "console") {
+            return new ConsoleAdapter();
+        }
+        if (options.adapter === "smtp" && options.smtp) {
+            return new SmtpAdapter(options.smtp);
+        }
+        throw new Error("MailModule: smtp adapter requires smtp config (host, port)");
+    }
+    static createPlugin() {
+        return new MailPlugin();
+    }
+    static setService(name, service) {
+        _services[name] = service;
+    }
+    static getService(name) {
+        const service = _services[name];
+        if (!service) {
+            throw new Error(`Service "${name}" not found. Ensure MailModule.forRoot() and MailPlugin.onInit() have been called.`);
+        }
+        return service;
+    }
+}

package/dist/mail.plugin.d.ts

@@ -0,0 +1,7 @@
+import type { CinnabunPlugin, PluginContext } from "@cinnabun/core";
+export declare class MailPlugin implements CinnabunPlugin {
+    name: string;
+    private adapter;
+    onInit(context: PluginContext): Promise<void>;
+    onShutdown(_context: PluginContext): Promise<void>;
+}

package/dist/mail.plugin.js

@@ -0,0 +1,29 @@
+import { Logger } from "@cinnabun/core";
+import { MailModule } from "./mail.module.js";
+import { TemplateService } from "./services/template.service.js";
+import { MailService } from "./services/mail.service.js";
+import { setMailService } from "./mail-service-holder.js";
+export class MailPlugin {
+    name = "MailPlugin";
+    adapter = null;
+    async onInit(context) {
+        const logger = new Logger("MailPlugin");
+        const options = MailModule.getOptions();
+        const container = context.container;
+        const adapter = MailModule.createAdapter();
+        await adapter.connect();
+        this.adapter = adapter;
+        const templateService = new TemplateService(options.templates);
+        const mailService = new MailService(adapter, templateService, options.from);
+        container.registerInstance(MailService, mailService);
+        MailModule.setService("mailService", mailService);
+        setMailService(mailService);
+        logger.info(`Mail module initialized (adapter: ${options.adapter})`);
+    }
+    async onShutdown(_context) {
+        if (this.adapter) {
+            await this.adapter.disconnect();
+            this.adapter = null;
+        }
+    }
+}

package/dist/services/mail.service.d.ts

@@ -0,0 +1,11 @@
+import type { MailMessage } from "../interfaces/mail-message.js";
+import type { MailAdapter } from "../interfaces/mail-adapter.js";
+import type { TemplateService } from "./template.service.js";
+export declare class MailService {
+    private readonly adapter;
+    private readonly templateService;
+    private readonly defaultFrom?;
+    constructor(adapter: MailAdapter, templateService: TemplateService, defaultFrom?: string | undefined);
+    send(message: MailMessage): Promise<void>;
+    sendTemplate(to: string | string[], subject: string, templateName: string, data: Record<string, unknown>): Promise<void>;
+}

package/dist/services/mail.service.js

@@ -0,0 +1,26 @@
+export class MailService {
+    adapter;
+    templateService;
+    defaultFrom;
+    constructor(adapter, templateService, defaultFrom) {
+        this.adapter = adapter;
+        this.templateService = templateService;
+        this.defaultFrom = defaultFrom;
+    }
+    async send(message) {
+        const msg = {
+            ...message,
+            from: message.from ?? this.defaultFrom,
+        };
+        await this.adapter.send(msg);
+    }
+    async sendTemplate(to, subject, templateName, data) {
+        const { html, text } = await this.templateService.render(templateName, data);
+        await this.send({
+            to,
+            subject,
+            html,
+            text,
+        });
+    }
+}

package/dist/services/template.service.d.ts

@@ -0,0 +1,11 @@
+import type { MailModuleOptions } from "../interfaces/mail-options.js";
+export declare class TemplateService {
+    private readonly templatesDir;
+    private readonly engine;
+    constructor(options?: MailModuleOptions["templates"]);
+    render(templateName: string, data: Record<string, unknown>): Promise<{
+        html?: string;
+        text?: string;
+    }>;
+    static clearCache(): void;
+}

package/dist/services/template.service.js

@@ -0,0 +1,48 @@
+import { readFile } from "fs/promises";
+import { join } from "path";
+const templateCache = new Map();
+export class TemplateService {
+    templatesDir;
+    engine;
+    constructor(options = {}) {
+        const dir = options?.dir ?? "templates";
+        this.templatesDir = dir.startsWith("/") || /^[A-Za-z]:/.test(dir)
+            ? dir
+            : join(process.cwd(), dir);
+        this.engine = options?.engine ?? "handlebars";
+    }
+    async render(templateName, data) {
+        if (this.engine !== "handlebars") {
+            throw new Error(`Template engine "${this.engine}" not yet supported. Use "handlebars".`);
+        }
+        const Handlebars = await import("handlebars");
+        const result = {};
+        for (const ext of [".html", ".txt"]) {
+            const filePath = join(this.templatesDir, `${templateName}${ext}`);
+            try {
+                const content = await readFile(filePath, "utf-8");
+                const cacheKey = `${filePath}`;
+                let compile = templateCache.get(cacheKey);
+                if (!compile) {
+                    compile = Handlebars.compile(content);
+                    templateCache.set(cacheKey, compile);
+                }
+                const rendered = compile(data);
+                if (ext === ".html")
+                    result.html = rendered;
+                else
+                    result.text = rendered;
+            }
+            catch {
+                // File not found, skip this extension
+            }
+        }
+        if (!result.html && !result.text) {
+            throw new Error(`Template "${templateName}" not found in ${this.templatesDir}. Expected ${templateName}.html or ${templateName}.txt`);
+        }
+        return result;
+    }
+    static clearCache() {
+        templateCache.clear();
+    }
+}

package/dist/templates/default.html

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <title>{{ title }}</title>
+</head>
+<body style="font-family: sans-serif; line-height: 1.6; color: #333; max-width: 600px; margin: 0 auto; padding: 20px;">
+  <h1>{{ title }}</h1>
+  <div>{{{ body }}}</div>
+  {{#if buttonUrl}}
+  <p style="margin-top: 24px;">
+    <a href="{{ buttonUrl }}" style="display: inline-block; padding: 12px 24px; background: #007bff; color: white; text-decoration: none; border-radius: 4px;">{{ buttonText }}</a>
+  </p>
+  {{/if}}
+</body>
+</html>

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@cinnabun/mail",
+  "version": "0.0.1",
+  "description": "Email module for Cinnabun with SMTP and template rendering",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist", "src/templates"],
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "scripts": {
+    "test": "bun test",
+    "build": "tsc && cp -r src/templates dist/ 2>/dev/null || true",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": ["cinnabun", "mail", "email", "smtp", "nodemailer", "handlebars"],
+  "peerDependencies": {
+    "@cinnabun/core": "^0.0.3",
+    "nodemailer": ">=6.0.0",
+    "handlebars": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "nodemailer": { "optional": true },
+    "handlebars": { "optional": true }
+  },
+  "devDependencies": {
+    "@cinnabun/core": "workspace:*",
+    "@types/bun": "latest",
+    "@types/nodemailer": "^6.4.0",
+    "handlebars": "^4.7.8",
+    "nodemailer": "^6.9.0",
+    "reflect-metadata": "^0.2.2",
+    "typescript": "^5.9.3"
+  }
+}

package/src/templates/default.html

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <title>{{ title }}</title>
+</head>
+<body style="font-family: sans-serif; line-height: 1.6; color: #333; max-width: 600px; margin: 0 auto; padding: 20px;">
+  <h1>{{ title }}</h1>
+  <div>{{{ body }}}</div>
+  {{#if buttonUrl}}
+  <p style="margin-top: 24px;">
+    <a href="{{ buttonUrl }}" style="display: inline-block; padding: 12px 24px; background: #007bff; color: white; text-decoration: none; border-radius: 4px;">{{ buttonText }}</a>
+  </p>
+  {{/if}}
+</body>
+</html>