@bobfrankston/rmfmail 1.0.467

package/packages/mailx-send/mailsend/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);
+}

package/packages/mailx-send/mailsend/package-lock.json

@@ -0,0 +1,65 @@
+{
+  "name": "@bobfrankston/mailsend",
+  "version": "0.1.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@bobfrankston/mailsend",
+      "version": "0.1.0",
+      "license": "MIT",
+      "dependencies": {
+        "@bobfrankston/oauthsupport": "file:../../projects/oauth/oauthsupport",
+        "nodemailer": "^7.0.0"
+      },
+      "bin": {
+        "mailsend": "cli.js"
+      },
+      "devDependencies": {
+        "@types/node": "^22.0.0",
+        "@types/nodemailer": "^6.4.0"
+      }
+    },
+    "../../projects/oauth/oauthsupport": {},
+    "node_modules/@bobfrankston/oauthsupport": {
+      "resolved": "../../projects/oauth/oauthsupport",
+      "link": true
+    },
+    "node_modules/@types/node": {
+      "version": "22.19.15",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.19.15.tgz",
+      "integrity": "sha512-F0R/h2+dsy5wJAUe3tAU6oqa2qbWY5TpNfL/RGmo1y38hiyO1w3x2jPtt76wmuaJI4DQnOBu21cNXQ2STIUUWg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "undici-types": "~6.21.0"
+      }
+    },
+    "node_modules/@types/nodemailer": {
+      "version": "6.4.23",
+      "resolved": "https://registry.npmjs.org/@types/nodemailer/-/nodemailer-6.4.23.tgz",
+      "integrity": "sha512-aFV3/NsYFLSx9mbb5gtirBSXJnAlrusoKNuPbxsASWc7vrKLmIrTQRpdcxNcSFL3VW2A2XpeLEavwb2qMi6nlQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/nodemailer": {
+      "version": "7.0.13",
+      "resolved": "https://registry.npmjs.org/nodemailer/-/nodemailer-7.0.13.tgz",
+      "integrity": "sha512-PNDFSJdP+KFgdsG3ZzMXCgquO7I6McjY2vlqILjtJd0hy8wEvtugS9xKRF2NWlPNGxvLCXlTNIae4serI7dinw==",
+      "license": "MIT-0",
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/undici-types": {
+      "version": "6.21.0",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
+      "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
+      "dev": true,
+      "license": "MIT"
+    }
+  }
+}

package/packages/mailx-send/mailsend/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@bobfrankston/mailsend",
+  "version": "0.1.0",
+  "description": "Queue-based mail sender with SMTP and OAuth2 support",
+  "type": "module",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "bin": {
+    "mailsend": "cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "release": "npmglobalize"
+  },
+  "keywords": ["email", "smtp", "queue", "oauth2", "gmail"],
+  "author": "Bob Frankston",
+  "license": "MIT",
+  "dependencies": {
+    "nodemailer": "^7.0.0",
+    "@bobfrankston/oauthsupport": "file:../../projects/oauth/oauthsupport"
+  },
+  "devDependencies": {
+    "@types/nodemailer": "^6.4.0",
+    "@types/node": "^22.0.0"
+  }
+}

package/packages/mailx-send/mailsend/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "strict": true,
+    "strictNullChecks": false,
+    "noImplicitAny": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": ".",
+    "rootDir": ".",
+    "newLine": "lf"
+  },
+  "include": ["*.ts"],
+  "exclude": ["node_modules", "prev", "cruft"]
+}

package/packages/mailx-send/package-lock.json

@@ -0,0 +1,65 @@
+{
+  "name": "@bobfrankston/mailsend",
+  "version": "0.1.1",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@bobfrankston/mailsend",
+      "version": "0.1.1",
+      "license": "MIT",
+      "dependencies": {
+        "@bobfrankston/oauthsupport": "file:../../projects/oauth/oauthsupport",
+        "nodemailer": "^7.0.0"
+      },
+      "bin": {
+        "mailsend": "cli.js"
+      },
+      "devDependencies": {
+        "@types/node": "^22.0.0",
+        "@types/nodemailer": "^6.4.0"
+      }
+    },
+    "../../projects/oauth/oauthsupport": {},
+    "node_modules/@bobfrankston/oauthsupport": {
+      "resolved": "../../projects/oauth/oauthsupport",
+      "link": true
+    },
+    "node_modules/@types/node": {
+      "version": "22.19.15",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.19.15.tgz",
+      "integrity": "sha512-F0R/h2+dsy5wJAUe3tAU6oqa2qbWY5TpNfL/RGmo1y38hiyO1w3x2jPtt76wmuaJI4DQnOBu21cNXQ2STIUUWg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "undici-types": "~6.21.0"
+      }
+    },
+    "node_modules/@types/nodemailer": {
+      "version": "6.4.23",
+      "resolved": "https://registry.npmjs.org/@types/nodemailer/-/nodemailer-6.4.23.tgz",
+      "integrity": "sha512-aFV3/NsYFLSx9mbb5gtirBSXJnAlrusoKNuPbxsASWc7vrKLmIrTQRpdcxNcSFL3VW2A2XpeLEavwb2qMi6nlQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/nodemailer": {
+      "version": "7.0.13",
+      "resolved": "https://registry.npmjs.org/nodemailer/-/nodemailer-7.0.13.tgz",
+      "integrity": "sha512-PNDFSJdP+KFgdsG3ZzMXCgquO7I6McjY2vlqILjtJd0hy8wEvtugS9xKRF2NWlPNGxvLCXlTNIae4serI7dinw==",
+      "license": "MIT-0",
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/undici-types": {
+      "version": "6.21.0",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
+      "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
+      "dev": true,
+      "license": "MIT"
+    }
+  }
+}

package/packages/mailx-send/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@bobfrankston/mailx-send",
+  "version": "0.1.1",
+  "description": "Queue-based mail sender with SMTP and OAuth2 support",
+  "type": "module",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "bin": {
+    "mailsend": "cli-send.js",
+    "mailq": "cli-queue.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "release": "npmglobalize"
+  },
+  "keywords": [
+    "email",
+    "smtp",
+    "queue",
+    "oauth2",
+    "gmail"
+  ],
+  "author": "Bob Frankston",
+  "license": "MIT",
+  "dependencies": {
+    "nodemailer": "^7.0.0",
+    "@bobfrankston/oauthsupport": "file:../../../../../projects/oauth/oauthsupport"
+  },
+  "devDependencies": {
+    "@types/nodemailer": "^6.4.0",
+    "@types/node": "^22.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/BobFrankston/mailx-send.git"
+  }
+}

package/packages/mailx-send/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "strict": true,
+    "strictNullChecks": false,
+    "noImplicitAny": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": ".",
+    "rootDir": ".",
+    "newLine": "lf"
+  },
+  "include": ["*.ts"],
+  "exclude": ["node_modules", "prev", "cruft"]
+}

package/packages/mailx-server/.gitattributes

@@ -0,0 +1,10 @@
+# Force LF line endings for all text files
+* text=auto eol=lf
+
+# Ensure these are always LF
+*.ts text eol=lf
+*.js text eol=lf
+*.json text eol=lf
+*.md text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf

package/packages/mailx-server/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @bobfrankston/mailx-server
+ * Express server: serves client, mounts API, manages WebSocket push.
+ */
+declare const app: import("express-serve-static-core").Express;
+declare function start(): Promise<void>;
+export { app, start };
+//# sourceMappingURL=index.d.ts.map

package/packages/mailx-server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoEH,QAAA,MAAM,GAAG,6CAAY,CAAC;AAmOtB,iBAAe,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAyFpC;AAyCD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC"}