@bobfrankston/rmfmail 1.2.232 → 1.2.233

package/packages/mailx-send/mailsend/index.ts

@@ -1,336 +0,0 @@
-/**
- * @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";
-import { encodeHeaderWord, encodeAddressHeader } from "@bobfrankston/mailx-types";
-
-// ── 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[] = [];
-    // See the sibling copy in mailx-send/index.ts — RFC 2047 or the message
-    // goes out as EAI and bounces from non-SMTPUTF8 receivers.
-    lines.push(`From: ${encodeAddressHeader(msg.from)}`);
-    lines.push(`To: ${encodeAddressHeader(msg.to.join(", "))}`);
-    if (msg.cc?.length) lines.push(`Cc: ${encodeAddressHeader(msg.cc.join(", "))}`);
-    if (msg.bcc?.length) lines.push(`Bcc: ${encodeAddressHeader(msg.bcc.join(", "))}`);
-    lines.push(`Subject: ${encodeHeaderWord(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

@@ -1,65 +0,0 @@
-{
-  "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

@@ -1,26 +0,0 @@
-{
-  "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

@@ -1,21 +0,0 @@
-{
-  "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

@@ -1,65 +0,0 @@
-{
-  "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

@@ -1,37 +0,0 @@
-{
-  "name": "@bobfrankston/mailx-send",
-  "version": "0.1.2",
-  "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

@@ -1,21 +0,0 @@
-{
-  "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

@@ -1,10 +0,0 @@
-# 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

@@ -1,8 +0,0 @@
-/**
- * @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

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