@bobfrankston/rmfmail 1.0.467

package/packages/mailx-send/index.js

@@ -0,0 +1,264 @@
+/**
+ * @bobfrankston/mailsend
+ * Queue-based mail sender. Each account has its own queue directory.
+ * Messages queued as .ltr (RFC 822) files, sent via SMTP with retry.
+ * Supports password and OAuth2 (Gmail) authentication.
+ *
+ * Directory structure:
+ *   {baseDir}/{accountId}/queue/    — pending .ltr files
+ *   {baseDir}/{accountId}/sent/     — sent messages (optional, YYYY/MM/DD)
+ *   {baseDir}/{accountId}/fail/     — failed messages for retry
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { createTransport } from "nodemailer";
+// ── File helpers ──
+function generateFilename() {
+    const now = new Date();
+    const pad2 = (n) => String(n).padStart(2, "0");
+    const ts = `${now.getFullYear()}${pad2(now.getMonth() + 1)}${pad2(now.getDate())}_${pad2(now.getHours())}${pad2(now.getMinutes())}${pad2(now.getSeconds())}`;
+    const seq = String(Math.floor(Math.random() * 10000)).padStart(4, "0");
+    return `${ts}-${seq}.ltr`;
+}
+function datePath() {
+    const dt = new Date();
+    const pad2 = (n) => String(n).padStart(2, "0");
+    return `${dt.getFullYear()}/${pad2(dt.getMonth() + 1)}/${pad2(dt.getDate())}`;
+}
+function moveToDateDir(filePath, destBase) {
+    const dest = path.join(destBase, datePath());
+    fs.mkdirSync(dest, { recursive: true });
+    fs.renameSync(filePath, path.join(dest, path.basename(filePath)));
+}
+function listLtr(dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    return fs.readdirSync(dir).filter(f => f.endsWith(".ltr")).sort();
+}
+function walkLtrCount(dir) {
+    if (!fs.existsSync(dir))
+        return 0;
+    let count = 0;
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        if (entry.isDirectory())
+            count += walkLtrCount(path.join(dir, entry.name));
+        else if (entry.name.endsWith(".ltr"))
+            count++;
+    }
+    return count;
+}
+function walkLtrFiles(dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    const files = [];
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory())
+            files.push(...walkLtrFiles(full));
+        else if (entry.name.endsWith(".ltr"))
+            files.push(full);
+    }
+    return files;
+}
+// ── RFC 822 builder ──
+export function buildRfc822(msg) {
+    const lines = [];
+    lines.push(`From: ${msg.from}`);
+    lines.push(`To: ${msg.to.join(", ")}`);
+    if (msg.cc?.length)
+        lines.push(`Cc: ${msg.cc.join(", ")}`);
+    if (msg.bcc?.length)
+        lines.push(`Bcc: ${msg.bcc.join(", ")}`);
+    lines.push(`Subject: ${msg.subject}`);
+    lines.push(`Date: ${new Date().toUTCString()}`);
+    if (msg.inReplyTo)
+        lines.push(`In-Reply-To: ${msg.inReplyTo}`);
+    if (msg.references)
+        lines.push(`References: ${msg.references}`);
+    if (msg.accountId)
+        lines.push(`X-MailSend-Account: ${msg.accountId}`);
+    lines.push(`MIME-Version: 1.0`);
+    if (msg.html) {
+        lines.push(`Content-Type: text/html; charset=UTF-8`);
+        lines.push(`Content-Transfer-Encoding: 8bit`);
+        lines.push("");
+        lines.push(msg.html);
+    }
+    else {
+        lines.push(`Content-Type: text/plain; charset=UTF-8`);
+        lines.push(`Content-Transfer-Encoding: 8bit`);
+        lines.push("");
+        lines.push(msg.text || "");
+    }
+    return lines.join("\r\n");
+}
+// ── Transport cache ──
+const transports = new Map();
+function getTransport(config) {
+    const key = `${config.host}:${config.port}:${config.user}`;
+    let transport = transports.get(key);
+    if (!transport) {
+        const opts = {
+            host: config.host,
+            port: config.port,
+            secure: config.secure ?? (config.port === 465),
+            tls: { rejectUnauthorized: false },
+        };
+        if (config.auth === "password") {
+            opts.auth = { user: config.user, pass: config.password };
+        }
+        else if (config.auth === "oauth2") {
+            opts.auth = { type: "OAuth2", user: config.user };
+        }
+        transport = createTransport(opts);
+        transports.set(key, transport);
+    }
+    return transport;
+}
+// ── MailSender ──
+let singleton = null;
+export class MailSender {
+    config;
+    processing = false;
+    retryTimer = null;
+    constructor(config) {
+        this.config = config;
+        // Ensure base directory exists
+        fs.mkdirSync(config.baseDir, { recursive: true });
+    }
+    accountDir(accountId) {
+        return path.join(this.config.baseDir, accountId);
+    }
+    queueDir(accountId) {
+        const dir = path.join(this.accountDir(accountId), "queue");
+        fs.mkdirSync(dir, { recursive: true });
+        return dir;
+    }
+    sentDir(accountId) {
+        return path.join(this.accountDir(accountId), "sent");
+    }
+    failDir(accountId) {
+        const dir = path.join(this.accountDir(accountId), "fail");
+        fs.mkdirSync(dir, { recursive: true });
+        return dir;
+    }
+    /** Queue a message. Returns the filename. */
+    queueMessage(msg) {
+        const accountId = msg.accountId || this.config.defaultAccount;
+        if (!accountId)
+            throw new Error("No accountId and no defaultAccount configured");
+        msg.accountId = accountId;
+        const content = buildRfc822(msg);
+        const filename = generateFilename();
+        fs.writeFileSync(path.join(this.queueDir(accountId), filename), content);
+        // Process immediately (non-blocking)
+        this.processQueue(accountId).catch(e => console.error(`[mailsend] Process error: ${e.message}`));
+        return filename;
+    }
+    /** Process pending messages for one account */
+    async processQueue(accountId) {
+        if (this.processing)
+            return;
+        this.processing = true;
+        try {
+            const smtpConfig = this.config.accounts[accountId];
+            if (!smtpConfig) {
+                console.error(`[mailsend] No SMTP config for: ${accountId}`);
+                return;
+            }
+            const files = listLtr(this.queueDir(accountId));
+            for (const file of files) {
+                await this.sendFile(path.join(this.queueDir(accountId), file), accountId, smtpConfig);
+            }
+        }
+        finally {
+            this.processing = false;
+        }
+    }
+    /** Process all account queues */
+    async processAllQueues() {
+        for (const accountId of Object.keys(this.config.accounts)) {
+            await this.processQueue(accountId);
+        }
+    }
+    async sendFile(filePath, accountId, smtpConfig) {
+        const content = fs.readFileSync(filePath, "utf-8");
+        try {
+            const transport = getTransport(smtpConfig);
+            if (smtpConfig.auth === "oauth2" && smtpConfig.tokenProvider) {
+                const token = await smtpConfig.tokenProvider();
+                transport.options.auth.accessToken = token;
+            }
+            const result = await transport.sendMail({ raw: content });
+            if (result.rejected?.length > 0) {
+                console.error(`[mailsend] Rejected: ${result.rejected.join(", ")} — ${path.basename(filePath)}`);
+                moveToDateDir(filePath, this.failDir(accountId));
+                return false;
+            }
+            console.log(`[mailsend] Sent: ${path.basename(filePath)} → ${result.accepted?.join(", ")} (${result.messageId})`);
+            if (this.config.logSent) {
+                moveToDateDir(filePath, this.sentDir(accountId));
+            }
+            else {
+                fs.unlinkSync(filePath);
+            }
+            return true;
+        }
+        catch (e) {
+            console.error(`[mailsend] Error: ${path.basename(filePath)}: ${e.message}`);
+            moveToDateDir(filePath, this.failDir(accountId));
+            return false;
+        }
+    }
+    /** Start background worker — retries failed, processes queues */
+    startWorker() {
+        if (this.retryTimer)
+            return;
+        const interval = this.config.retryIntervalMs || 300000;
+        this.retryTimer = setInterval(async () => {
+            for (const accountId of Object.keys(this.config.accounts)) {
+                this.retryFailed(accountId);
+            }
+            await this.processAllQueues();
+        }, interval);
+    }
+    retryFailed(accountId) {
+        const failFiles = walkLtrFiles(this.failDir(accountId));
+        const queueDir = this.queueDir(accountId);
+        for (const file of failFiles) {
+            fs.renameSync(file, path.join(queueDir, path.basename(file)));
+        }
+    }
+    stopWorker() {
+        if (this.retryTimer) {
+            clearInterval(this.retryTimer);
+            this.retryTimer = null;
+        }
+    }
+    /** Get queue status per account */
+    getStatus() {
+        const result = {};
+        for (const accountId of Object.keys(this.config.accounts)) {
+            result[accountId] = {
+                pending: listLtr(this.queueDir(accountId)).length,
+                failed: walkLtrCount(this.failDir(accountId)),
+            };
+        }
+        return result;
+    }
+}
+// ── Singleton API ──
+export function initMailSend(config) {
+    singleton = new MailSender(config);
+    singleton.startWorker();
+    return singleton;
+}
+export function getMailSender() {
+    return singleton;
+}
+export function queueMessage(msg) {
+    if (!singleton)
+        throw new Error("mailsend not initialized — call initMailSend() first");
+    return singleton.queueMessage(msg);
+}
+//# sourceMappingURL=index.js.map

package/packages/mailx-send/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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"}

package/packages/mailx-send/index.ts

@@ -0,0 +1,333 @@
+/**
+ * @bobfrankston/mailsend
+ * Queue-based mail sender. Each account has its own queue directory.
+ * Messages queued as .ltr (RFC 822) files, sent via SMTP with retry.
+ * Supports password and OAuth2 (Gmail) authentication.
+ *
+ * Directory structure:
+ *   {baseDir}/{accountId}/queue/    — pending .ltr files
+ *   {baseDir}/{accountId}/sent/     — sent messages (optional, YYYY/MM/DD)
+ *   {baseDir}/{accountId}/fail/     — failed messages for retry
+ */
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { createTransport, type Transporter } from "nodemailer";
+
+// ── Types ──
+
+export interface SmtpConfig {
+    host: string;
+    port: number;
+    secure?: boolean;
+    auth: "password" | "oauth2";
+    user: string;
+    password?: string;
+    /** Default From address, e.g. "Bob Frankston <bob@iecc.com>" */
+    from?: string;
+    tokenProvider?: () => Promise<string>;
+}
+
+export interface MailMessage {
+    from: string;
+    to: string[];
+    cc?: string[];
+    bcc?: string[];
+    subject: string;
+    html?: string;
+    text?: string;
+    inReplyTo?: string;
+    references?: string;
+    accountId?: string;
+}
+
+export interface MailSendConfig {
+    /** Base directory for all queues */
+    baseDir: string;
+    /** SMTP configs keyed by account ID */
+    accounts: Record<string, SmtpConfig>;
+    /** Log sent messages to sent/ subdirectory */
+    logSent?: boolean;
+    /** Retry interval in ms (default: 5 minutes) */
+    retryIntervalMs?: number;
+    /** Default account ID */
+    defaultAccount?: string;
+}
+
+// ── File helpers ──
+
+function generateFilename(): string {
+    const now = new Date();
+    const pad2 = (n: number) => String(n).padStart(2, "0");
+    const ts = `${now.getFullYear()}${pad2(now.getMonth() + 1)}${pad2(now.getDate())}_${pad2(now.getHours())}${pad2(now.getMinutes())}${pad2(now.getSeconds())}`;
+    const seq = String(Math.floor(Math.random() * 10000)).padStart(4, "0");
+    return `${ts}-${seq}.ltr`;
+}
+
+function datePath(): string {
+    const dt = new Date();
+    const pad2 = (n: number) => String(n).padStart(2, "0");
+    return `${dt.getFullYear()}/${pad2(dt.getMonth() + 1)}/${pad2(dt.getDate())}`;
+}
+
+function moveToDateDir(filePath: string, destBase: string): void {
+    const dest = path.join(destBase, datePath());
+    fs.mkdirSync(dest, { recursive: true });
+    fs.renameSync(filePath, path.join(dest, path.basename(filePath)));
+}
+
+function listLtr(dir: string): string[] {
+    if (!fs.existsSync(dir)) return [];
+    return fs.readdirSync(dir).filter(f => f.endsWith(".ltr")).sort();
+}
+
+function walkLtrCount(dir: string): number {
+    if (!fs.existsSync(dir)) return 0;
+    let count = 0;
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        if (entry.isDirectory()) count += walkLtrCount(path.join(dir, entry.name));
+        else if (entry.name.endsWith(".ltr")) count++;
+    }
+    return count;
+}
+
+function walkLtrFiles(dir: string): string[] {
+    if (!fs.existsSync(dir)) return [];
+    const files: string[] = [];
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) files.push(...walkLtrFiles(full));
+        else if (entry.name.endsWith(".ltr")) files.push(full);
+    }
+    return files;
+}
+
+// ── RFC 822 builder ──
+
+export function buildRfc822(msg: MailMessage): string {
+    const lines: string[] = [];
+    lines.push(`From: ${msg.from}`);
+    lines.push(`To: ${msg.to.join(", ")}`);
+    if (msg.cc?.length) lines.push(`Cc: ${msg.cc.join(", ")}`);
+    if (msg.bcc?.length) lines.push(`Bcc: ${msg.bcc.join(", ")}`);
+    lines.push(`Subject: ${msg.subject}`);
+    lines.push(`Date: ${new Date().toUTCString()}`);
+    if (msg.inReplyTo) lines.push(`In-Reply-To: ${msg.inReplyTo}`);
+    if (msg.references) lines.push(`References: ${msg.references}`);
+    if (msg.accountId) lines.push(`X-MailSend-Account: ${msg.accountId}`);
+    lines.push(`MIME-Version: 1.0`);
+
+    if (msg.html) {
+        lines.push(`Content-Type: text/html; charset=UTF-8`);
+        lines.push(`Content-Transfer-Encoding: 8bit`);
+        lines.push("");
+        lines.push(msg.html);
+    } else {
+        lines.push(`Content-Type: text/plain; charset=UTF-8`);
+        lines.push(`Content-Transfer-Encoding: 8bit`);
+        lines.push("");
+        lines.push(msg.text || "");
+    }
+
+    return lines.join("\r\n");
+}
+
+// ── Transport cache ──
+
+const transports: Map<string, Transporter> = new Map();
+
+function getTransport(config: SmtpConfig): Transporter {
+    const key = `${config.host}:${config.port}:${config.user}`;
+    let transport = transports.get(key);
+    if (!transport) {
+        const opts: any = {
+            host: config.host,
+            port: config.port,
+            secure: config.secure ?? (config.port === 465),
+            tls: { rejectUnauthorized: false },
+        };
+
+        if (config.auth === "password") {
+            opts.auth = { user: config.user, pass: config.password };
+        } else if (config.auth === "oauth2") {
+            opts.auth = { type: "OAuth2", user: config.user };
+        }
+
+        transport = createTransport(opts);
+        transports.set(key, transport);
+    }
+    return transport;
+}
+
+// ── MailSender ──
+
+let singleton: MailSender | null = null;
+
+export class MailSender {
+    private config: MailSendConfig;
+    private processing = false;
+    private retryTimer: ReturnType<typeof setInterval> | null = null;
+
+    constructor(config: MailSendConfig) {
+        this.config = config;
+        // Ensure base directory exists
+        fs.mkdirSync(config.baseDir, { recursive: true });
+    }
+
+    private accountDir(accountId: string): string {
+        return path.join(this.config.baseDir, accountId);
+    }
+
+    private queueDir(accountId: string): string {
+        const dir = path.join(this.accountDir(accountId), "queue");
+        fs.mkdirSync(dir, { recursive: true });
+        return dir;
+    }
+
+    private sentDir(accountId: string): string {
+        return path.join(this.accountDir(accountId), "sent");
+    }
+
+    private failDir(accountId: string): string {
+        const dir = path.join(this.accountDir(accountId), "fail");
+        fs.mkdirSync(dir, { recursive: true });
+        return dir;
+    }
+
+    /** Queue a message. Returns the filename. */
+    queueMessage(msg: MailMessage): string {
+        const accountId = msg.accountId || this.config.defaultAccount;
+        if (!accountId) throw new Error("No accountId and no defaultAccount configured");
+        msg.accountId = accountId;
+
+        const content = buildRfc822(msg);
+        const filename = generateFilename();
+        fs.writeFileSync(path.join(this.queueDir(accountId), filename), content);
+
+        // Process immediately (non-blocking)
+        this.processQueue(accountId).catch(e =>
+            console.error(`[mailsend] Process error: ${e.message}`)
+        );
+
+        return filename;
+    }
+
+    /** Process pending messages for one account */
+    async processQueue(accountId: string): Promise<void> {
+        if (this.processing) return;
+        this.processing = true;
+
+        try {
+            const smtpConfig = this.config.accounts[accountId];
+            if (!smtpConfig) {
+                console.error(`[mailsend] No SMTP config for: ${accountId}`);
+                return;
+            }
+
+            const files = listLtr(this.queueDir(accountId));
+            for (const file of files) {
+                await this.sendFile(path.join(this.queueDir(accountId), file), accountId, smtpConfig);
+            }
+        } finally {
+            this.processing = false;
+        }
+    }
+
+    /** Process all account queues */
+    async processAllQueues(): Promise<void> {
+        for (const accountId of Object.keys(this.config.accounts)) {
+            await this.processQueue(accountId);
+        }
+    }
+
+    private async sendFile(filePath: string, accountId: string, smtpConfig: SmtpConfig): Promise<boolean> {
+        const content = fs.readFileSync(filePath, "utf-8");
+
+        try {
+            const transport = getTransport(smtpConfig);
+
+            if (smtpConfig.auth === "oauth2" && smtpConfig.tokenProvider) {
+                const token = await smtpConfig.tokenProvider();
+                (transport as any).options.auth.accessToken = token;
+            }
+
+            const result = await transport.sendMail({ raw: content });
+
+            if (result.rejected?.length > 0) {
+                console.error(`[mailsend] Rejected: ${result.rejected.join(", ")} — ${path.basename(filePath)}`);
+                moveToDateDir(filePath, this.failDir(accountId));
+                return false;
+            }
+
+            console.log(`[mailsend] Sent: ${path.basename(filePath)} → ${result.accepted?.join(", ")} (${result.messageId})`);
+
+            if (this.config.logSent) {
+                moveToDateDir(filePath, this.sentDir(accountId));
+            } else {
+                fs.unlinkSync(filePath);
+            }
+            return true;
+        } catch (e: any) {
+            console.error(`[mailsend] Error: ${path.basename(filePath)}: ${e.message}`);
+            moveToDateDir(filePath, this.failDir(accountId));
+            return false;
+        }
+    }
+
+    /** Start background worker — retries failed, processes queues */
+    startWorker(): void {
+        if (this.retryTimer) return;
+        const interval = this.config.retryIntervalMs || 300000;
+
+        this.retryTimer = setInterval(async () => {
+            for (const accountId of Object.keys(this.config.accounts)) {
+                this.retryFailed(accountId);
+            }
+            await this.processAllQueues();
+        }, interval);
+    }
+
+    private retryFailed(accountId: string): void {
+        const failFiles = walkLtrFiles(this.failDir(accountId));
+        const queueDir = this.queueDir(accountId);
+        for (const file of failFiles) {
+            fs.renameSync(file, path.join(queueDir, path.basename(file)));
+        }
+    }
+
+    stopWorker(): void {
+        if (this.retryTimer) {
+            clearInterval(this.retryTimer);
+            this.retryTimer = null;
+        }
+    }
+
+    /** Get queue status per account */
+    getStatus(): Record<string, { pending: number; failed: number }> {
+        const result: Record<string, { pending: number; failed: number }> = {};
+        for (const accountId of Object.keys(this.config.accounts)) {
+            result[accountId] = {
+                pending: listLtr(this.queueDir(accountId)).length,
+                failed: walkLtrCount(this.failDir(accountId)),
+            };
+        }
+        return result;
+    }
+}
+
+// ── Singleton API ──
+
+export function initMailSend(config: MailSendConfig): MailSender {
+    singleton = new MailSender(config);
+    singleton.startWorker();
+    return singleton;
+}
+
+export function getMailSender(): MailSender | null {
+    return singleton;
+}
+
+export function queueMessage(msg: MailMessage): string {
+    if (!singleton) throw new Error("mailsend not initialized — call initMailSend() first");
+    return singleton.queueMessage(msg);
+}