@diskd-ai/email-mcp 0.3.0

package/dist/services/scheduler.service.js

@@ -0,0 +1,260 @@
+/**
+ * Scheduler service — JSON file-based email scheduling queue.
+ *
+ * Manages scheduled emails with a local file queue.
+ * Source of truth is the JSON files in XDG state directory.
+ */
+import crypto from 'node:crypto';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { SCHEDULED_DIR, SCHEDULED_SENT_DIR } from '../config/xdg.js';
+/** Max age (ms) for "sending" status before resetting to "pending" */
+const STALE_LOCK_MS = 5 * 60 * 1000;
+/** Max retry attempts before marking as "failed" */
+const MAX_ATTEMPTS = 3;
+export default class SchedulerService {
+    smtpService;
+    imapService;
+    constructor(smtpService, imapService) {
+        this.smtpService = smtpService;
+        this.imapService = imapService;
+    }
+    // -------------------------------------------------------------------------
+    // Schedule a new email
+    // -------------------------------------------------------------------------
+    async schedule(account, options) {
+        const sendAtDate = new Date(options.sendAt);
+        if (Number.isNaN(sendAtDate.getTime())) {
+            throw new Error(`Invalid send_at date: ${options.sendAt}`);
+        }
+        if (sendAtDate.getTime() <= Date.now()) {
+            throw new Error('send_at must be in the future');
+        }
+        const scheduled = {
+            id: crypto.randomUUID(),
+            account,
+            to: options.to,
+            cc: options.cc,
+            bcc: options.bcc,
+            subject: options.subject,
+            body: options.body,
+            html: options.html ?? false,
+            sendAt: sendAtDate.toISOString(),
+            createdAt: new Date().toISOString(),
+            status: 'pending',
+            attempts: 0,
+            inReplyTo: options.inReplyTo,
+            references: options.references,
+        };
+        // Save IMAP draft (best-effort)
+        try {
+            const draftResult = await this.imapService.saveDraft(account, {
+                to: options.to,
+                subject: `[Scheduled: ${sendAtDate.toLocaleString()}] ${options.subject}`,
+                body: options.body,
+                cc: options.cc,
+                html: options.html,
+            });
+            scheduled.draftMessageId = String(draftResult.id);
+            scheduled.draftMailbox = draftResult.mailbox;
+        }
+        catch {
+            // Draft mirror is best-effort
+        }
+        await SchedulerService.writeScheduledFile(scheduled);
+        return scheduled;
+    }
+    // -------------------------------------------------------------------------
+    // List scheduled emails
+    // -------------------------------------------------------------------------
+    // eslint-disable-next-line class-methods-use-this
+    async list(options = {}) {
+        const status = options.status ?? 'pending';
+        const emails = [];
+        // Read pending/sending/failed from main dir
+        if (status !== 'sent') {
+            const pending = await SchedulerService.readDir(SCHEDULED_DIR);
+            emails.push(...pending);
+        }
+        // Read sent from sent/ subdir
+        if (status === 'sent' || status === 'all') {
+            const sent = await SchedulerService.readDir(SCHEDULED_SENT_DIR);
+            emails.push(...sent);
+        }
+        // Filter by account if specified
+        const filtered = options.account ? emails.filter((e) => e.account === options.account) : emails;
+        // Filter by status unless "all"
+        if (status !== 'all') {
+            return filtered.filter((e) => e.status === status);
+        }
+        return filtered.sort((a, b) => new Date(a.sendAt).getTime() - new Date(b.sendAt).getTime());
+    }
+    // -------------------------------------------------------------------------
+    // Cancel a scheduled email
+    // -------------------------------------------------------------------------
+    async cancel(scheduleId) {
+        const filePath = path.join(SCHEDULED_DIR, `${scheduleId}.json`);
+        let draftDeleted = false;
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            const scheduled = JSON.parse(content);
+            if (scheduled.status !== 'pending') {
+                throw new Error(`Cannot cancel email with status "${scheduled.status}"`);
+            }
+            // Delete IMAP draft (best-effort)
+            if (scheduled.draftMessageId && scheduled.draftMailbox) {
+                try {
+                    await this.imapService.deleteEmail(scheduled.account, scheduled.draftMessageId, scheduled.draftMailbox);
+                    draftDeleted = true;
+                }
+                catch {
+                    // Draft deletion is best-effort
+                }
+            }
+            await fs.unlink(filePath);
+            return { cancelled: true, draftDeleted };
+        }
+        catch (err) {
+            if (err instanceof Error &&
+                'code' in err &&
+                err.code === 'ENOENT') {
+                throw new Error(`Scheduled email "${scheduleId}" not found`);
+            }
+            throw err;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Check and send overdue emails
+    // -------------------------------------------------------------------------
+    /* eslint-disable no-await-in-loop, no-continue -- Sequential file processing required */
+    async checkAndSend() {
+        const result = { sent: 0, failed: 0, errors: [] };
+        await SchedulerService.ensureDirs();
+        let files;
+        try {
+            files = await fs.readdir(SCHEDULED_DIR);
+        }
+        catch {
+            return result;
+        }
+        const jsonFiles = files.filter((f) => f.endsWith('.json'));
+        const now = Date.now();
+        // Process files sequentially — must not double-send
+        // eslint-disable-next-line no-restricted-syntax
+        for (const file of jsonFiles) {
+            const filePath = path.join(SCHEDULED_DIR, file);
+            try {
+                const content = await fs.readFile(filePath, 'utf-8');
+                const scheduled = JSON.parse(content);
+                // Reset stale locks
+                if (scheduled.status === 'sending' && scheduled.lastError !== undefined) {
+                    const lockAge = now - new Date(scheduled.createdAt).getTime();
+                    if (lockAge > STALE_LOCK_MS) {
+                        scheduled.status = 'pending';
+                    }
+                }
+                else if (scheduled.status === 'sending') {
+                    // Check if it's been sending too long (use sendAt as reference)
+                    continue;
+                }
+                // Skip non-pending
+                if (scheduled.status !== 'pending')
+                    continue;
+                // Skip if not yet due
+                if (new Date(scheduled.sendAt).getTime() > now)
+                    continue;
+                // Skip if max attempts exceeded
+                if (scheduled.attempts >= MAX_ATTEMPTS) {
+                    scheduled.status = 'failed';
+                    scheduled.lastError = 'Max retry attempts exceeded';
+                    await SchedulerService.writeScheduledFile(scheduled);
+                    result.failed += 1;
+                    continue;
+                }
+                // Acquire lock
+                scheduled.status = 'sending';
+                scheduled.attempts += 1;
+                await SchedulerService.writeScheduledFile(scheduled);
+                // Send
+                const sendResult = await this.smtpService.sendEmail(scheduled.account, {
+                    to: scheduled.to,
+                    subject: scheduled.subject,
+                    body: scheduled.body,
+                    cc: scheduled.cc,
+                    bcc: scheduled.bcc,
+                    html: scheduled.html,
+                });
+                // Mark as sent and move to sent dir
+                scheduled.status = 'sent';
+                scheduled.sentAt = new Date().toISOString();
+                scheduled.sentMessageId = sendResult.messageId;
+                const sentPath = path.join(SCHEDULED_SENT_DIR, file);
+                await fs.writeFile(sentPath, JSON.stringify(scheduled, null, 2));
+                await fs.unlink(filePath);
+                // Delete draft (best-effort)
+                if (scheduled.draftMessageId && scheduled.draftMailbox) {
+                    try {
+                        await this.imapService.deleteEmail(scheduled.account, scheduled.draftMessageId, scheduled.draftMailbox);
+                    }
+                    catch {
+                        // Best-effort
+                    }
+                }
+                result.sent += 1;
+            }
+            catch (err) {
+                const errorMsg = err instanceof Error ? err.message : String(err);
+                result.errors.push(`${file}: ${errorMsg}`);
+                // Mark as failed in the file
+                try {
+                    const content = await fs.readFile(filePath, 'utf-8');
+                    const scheduled = JSON.parse(content);
+                    scheduled.status = scheduled.attempts >= MAX_ATTEMPTS ? 'failed' : 'pending';
+                    scheduled.lastError = errorMsg;
+                    await fs.writeFile(filePath, JSON.stringify(scheduled, null, 2));
+                }
+                catch {
+                    // If we can't even update the file, skip
+                }
+                result.failed += 1;
+            }
+        }
+        return result;
+    }
+    /* eslint-enable no-await-in-loop, no-continue */
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    static async ensureDirs() {
+        await fs.mkdir(SCHEDULED_DIR, { recursive: true });
+        await fs.mkdir(SCHEDULED_SENT_DIR, { recursive: true });
+    }
+    static async writeScheduledFile(scheduled) {
+        await SchedulerService.ensureDirs();
+        const filePath = path.join(SCHEDULED_DIR, `${scheduled.id}.json`);
+        await fs.writeFile(filePath, JSON.stringify(scheduled, null, 2));
+    }
+    static async readDir(dirPath) {
+        const emails = [];
+        try {
+            const files = await fs.readdir(dirPath);
+            // eslint-disable-next-line no-restricted-syntax
+            for (const file of files) {
+                if (!file.endsWith('.json'))
+                    continue; // eslint-disable-line no-continue
+                try {
+                    const content = await fs.readFile(path.join(dirPath, file), 'utf-8'); // eslint-disable-line no-await-in-loop
+                    emails.push(JSON.parse(content));
+                }
+                catch {
+                    // Skip corrupted files
+                }
+            }
+        }
+        catch {
+            // Directory may not exist yet
+        }
+        return emails;
+    }
+}
+//# sourceMappingURL=scheduler.service.js.map

package/dist/services/scheduler.service.js.map

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

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

@@ -0,0 +1,40 @@
+/**
+ * SMTP service — pure business logic for email send operations.
+ *
+ * No MCP dependency — fully unit-testable.
+ */
+import type { IConnectionManager } from '../connections/types.js';
+import type RateLimiter from '../safety/rate-limiter.js';
+import type { SendResult } from '../types/index.js';
+import type ImapService from './imap.service.js';
+export default class SmtpService {
+    private connections;
+    private rateLimiter;
+    private imapService;
+    constructor(connections: IConnectionManager, rateLimiter: RateLimiter, imapService: ImapService);
+    sendEmail(accountName: string, options: {
+        to: string[];
+        subject: string;
+        body: string;
+        cc?: string[];
+        bcc?: string[];
+        html?: boolean;
+    }): Promise<SendResult>;
+    replyToEmail(accountName: string, options: {
+        emailId: string;
+        mailbox?: string;
+        body: string;
+        replyAll?: boolean;
+        html?: boolean;
+    }): Promise<SendResult>;
+    forwardEmail(accountName: string, options: {
+        emailId: string;
+        mailbox?: string;
+        to: string[];
+        body?: string;
+        cc?: string[];
+    }): Promise<SendResult>;
+    private checkRateLimit;
+    sendDraft(accountName: string, draftId: number, mailbox?: string): Promise<SendResult>;
+}
+//# sourceMappingURL=smtp.service.d.ts.map

package/dist/services/smtp.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smtp.service.d.ts","sourceRoot":"","sources":["../../src/services/smtp.service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,WAAW,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AAEjD,MAAM,CAAC,OAAO,OAAO,WAAW;IAE5B,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,WAAW;gBAFX,WAAW,EAAE,kBAAkB,EAC/B,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,WAAW;IAO5B,SAAS,CACb,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,EAAE,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,GACA,OAAO,CAAC,UAAU,CAAC;IAyBhB,YAAY,CAChB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,GACA,OAAO,CAAC,UAAU,CAAC;IAsDhB,YAAY,CAChB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,EAAE,EAAE,MAAM,EAAE,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;KACf,GACA,OAAO,CAAC,UAAU,CAAC;IA4CtB,OAAO,CAAC,cAAc;IAahB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAkC7F"}

package/dist/services/smtp.service.js

@@ -0,0 +1,151 @@
+/**
+ * SMTP service — pure business logic for email send operations.
+ *
+ * No MCP dependency — fully unit-testable.
+ */
+export default class SmtpService {
+    connections;
+    rateLimiter;
+    imapService;
+    constructor(connections, rateLimiter, imapService) {
+        this.connections = connections;
+        this.rateLimiter = rateLimiter;
+        this.imapService = imapService;
+    }
+    // -------------------------------------------------------------------------
+    // Send email
+    // -------------------------------------------------------------------------
+    async sendEmail(accountName, options) {
+        this.checkRateLimit(accountName);
+        const account = this.connections.getAccount(accountName);
+        const transport = await this.connections.getSmtpTransport(accountName);
+        const result = await transport.sendMail({
+            from: account.fullName ? `"${account.fullName}" <${account.email}>` : account.email,
+            to: options.to.join(', '),
+            cc: options.cc?.join(', '),
+            bcc: options.bcc?.join(', '),
+            subject: options.subject,
+            ...(options.html ? { html: options.body } : { text: options.body }),
+        });
+        return {
+            messageId: result.messageId ?? '',
+            status: 'sent',
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Reply
+    // -------------------------------------------------------------------------
+    async replyToEmail(accountName, options) {
+        this.checkRateLimit(accountName);
+        const account = this.connections.getAccount(accountName);
+        const original = await this.imapService.getEmail(accountName, options.emailId, options.mailbox);
+        // Build recipient list
+        const to = [original.from.address];
+        const cc = [];
+        if (options.replyAll) {
+            // Add all original To recipients except ourselves
+            original.to
+                .filter((addr) => addr.address !== account.email)
+                .forEach((addr) => {
+                to.push(addr.address);
+            });
+            // Add CC recipients except ourselves
+            (original.cc ?? [])
+                .filter((addr) => addr.address !== account.email)
+                .forEach((addr) => {
+                cc.push(addr.address);
+            });
+        }
+        // Build threading headers
+        const references = [...(original.references ?? []), original.messageId].filter(Boolean);
+        const subject = original.subject.startsWith('Re:')
+            ? original.subject
+            : `Re: ${original.subject}`;
+        const transport = await this.connections.getSmtpTransport(accountName);
+        const result = await transport.sendMail({
+            from: account.fullName ? `"${account.fullName}" <${account.email}>` : account.email,
+            to: to.join(', '),
+            cc: cc.length > 0 ? cc.join(', ') : undefined,
+            subject,
+            inReplyTo: original.messageId,
+            references: references.join(' '),
+            ...(options.html ? { html: options.body } : { text: options.body }),
+        });
+        return {
+            messageId: result.messageId ?? '',
+            status: 'sent',
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Forward
+    // -------------------------------------------------------------------------
+    async forwardEmail(accountName, options) {
+        this.checkRateLimit(accountName);
+        const account = this.connections.getAccount(accountName);
+        const original = await this.imapService.getEmail(accountName, options.emailId, options.mailbox);
+        const subject = original.subject.startsWith('Fwd:')
+            ? original.subject
+            : `Fwd: ${original.subject}`;
+        // Build forwarded message body
+        const forwardHeader = [
+            '',
+            '---------- Forwarded message ----------',
+            `From: ${original.from.name ? `${original.from.name} <${original.from.address}>` : original.from.address}`,
+            `Date: ${original.date}`,
+            `Subject: ${original.subject}`,
+            `To: ${original.to.map((a) => a.address).join(', ')}`,
+            '',
+        ].join('\n');
+        const originalBody = original.bodyText ?? original.bodyHtml ?? '';
+        const fullBody = (options.body ?? '') + forwardHeader + originalBody;
+        const transport = await this.connections.getSmtpTransport(accountName);
+        const result = await transport.sendMail({
+            from: account.fullName ? `"${account.fullName}" <${account.email}>` : account.email,
+            to: options.to.join(', '),
+            cc: options.cc?.join(', '),
+            subject,
+            text: fullBody,
+        });
+        return {
+            messageId: result.messageId ?? '',
+            status: 'sent',
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Rate limit check
+    // -------------------------------------------------------------------------
+    checkRateLimit(accountName) {
+        if (!this.rateLimiter.tryConsume(accountName)) {
+            throw new Error(`Rate limit exceeded for account "${accountName}". ` +
+                `Please wait before sending more emails.`);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Send draft
+    // -------------------------------------------------------------------------
+    async sendDraft(accountName, draftId, mailbox) {
+        this.checkRateLimit(accountName);
+        // Fetch the draft via IMAP
+        const { email: draft, mailbox: draftsPath } = await this.imapService.fetchDraft(accountName, draftId, mailbox);
+        const account = this.connections.getAccount(accountName);
+        const transport = await this.connections.getSmtpTransport(accountName);
+        const to = draft.to.map((a) => a.address).join(', ');
+        const cc = draft.cc?.map((a) => a.address).join(', ');
+        const result = await transport.sendMail({
+            from: account.fullName ? `"${account.fullName}" <${account.email}>` : account.email,
+            to,
+            cc,
+            subject: draft.subject,
+            inReplyTo: draft.inReplyTo,
+            references: draft.references?.join(' '),
+            ...(draft.bodyHtml ? { html: draft.bodyHtml } : { text: draft.bodyText ?? '' }),
+        });
+        // Delete the draft after successful send
+        await this.imapService.deleteDraft(accountName, draftId, draftsPath);
+        return {
+            messageId: result.messageId ?? '',
+            status: 'sent',
+        };
+    }
+}
+//# sourceMappingURL=smtp.service.js.map

package/dist/services/smtp.service.js.map

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

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

@@ -0,0 +1,33 @@
+/**
+ * Template service — load, parse, and apply user-defined email templates.
+ *
+ * Templates are stored as TOML files in the XDG config templates directory.
+ * Each template has a name, optional description, subject, body, and a list
+ * of variable names used for {{variable}} substitution.
+ */
+import type { EmailTemplate } from '../types/index.js';
+export default class TemplateService {
+    private templatesDir;
+    constructor(templatesDir?: string);
+    /**
+     * List all templates from the templates directory.
+     * Returns metadata only (name, description, variables).
+     */
+    listTemplates(): Promise<EmailTemplate[]>;
+    /**
+     * Get a single template by name.
+     */
+    getTemplate(name: string): Promise<EmailTemplate>;
+    /**
+     * Apply variable substitution to a template.
+     * Returns the composed subject and body with variables replaced.
+     * Missing variables are left as {{variable}} placeholders.
+     */
+    applyTemplate(name: string, variables: Record<string, string>, html?: boolean): Promise<{
+        subject: string;
+        body: string;
+    }>;
+    /** Get the templates directory path. */
+    get directory(): string;
+}
+//# sourceMappingURL=template.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template.service.d.ts","sourceRoot":"","sources":["../../src/services/template.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AA2CvD,MAAM,CAAC,OAAO,OAAO,eAAe;IAClC,OAAO,CAAC,YAAY,CAAS;gBAEjB,YAAY,SAAgB;IAIxC;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IA2B/C;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAUvD;;;;OAIG;IACG,aAAa,CACjB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,IAAI,UAAQ,GACX,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAsB7C,wCAAwC;IACxC,IAAI,SAAS,IAAI,MAAM,CAEtB;CACF"}

package/dist/services/template.service.js

@@ -0,0 +1,123 @@
+/**
+ * Template service — load, parse, and apply user-defined email templates.
+ *
+ * Templates are stored as TOML files in the XDG config templates directory.
+ * Each template has a name, optional description, subject, body, and a list
+ * of variable names used for {{variable}} substitution.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { parse as parseTOML } from 'smol-toml';
+import { TEMPLATES_DIR } from '../config/xdg.js';
+import { sanitizeTemplateVariable } from '../safety/validation.js';
+/**
+ * Validate that a parsed object looks like an EmailTemplate.
+ * Returns the template or throws with a descriptive message.
+ */
+function validateTemplate(raw, filename) {
+    const { name, description, subject, body, variables } = raw;
+    if (typeof name !== 'string' || name.length === 0) {
+        throw new Error(`Template "${filename}" is missing a valid "name" field`);
+    }
+    if (typeof subject !== 'string') {
+        throw new Error(`Template "${filename}" is missing a "subject" field`);
+    }
+    if (typeof body !== 'string') {
+        throw new Error(`Template "${filename}" is missing a "body" field`);
+    }
+    if (!Array.isArray(variables) || !variables.every((v) => typeof v === 'string')) {
+        throw new Error(`Template "${filename}" must have a "variables" array of strings`);
+    }
+    return {
+        name,
+        description: typeof description === 'string' ? description : undefined,
+        subject,
+        body,
+        variables,
+    };
+}
+/**
+ * Replace all {{variable}} placeholders in a string with the provided values.
+ */
+function substituteVariables(text, variables) {
+    return text.replace(/\{\{(\w+)\}\}/g, (match, varName) => {
+        if (varName in variables) {
+            return variables[varName];
+        }
+        return match; // Leave unresolved placeholders as-is
+    });
+}
+export default class TemplateService {
+    templatesDir;
+    constructor(templatesDir = TEMPLATES_DIR) {
+        this.templatesDir = templatesDir;
+    }
+    /**
+     * List all templates from the templates directory.
+     * Returns metadata only (name, description, variables).
+     */
+    async listTemplates() {
+        try {
+            await fs.access(this.templatesDir);
+        }
+        catch {
+            return []; // Directory doesn't exist yet — no templates
+        }
+        const entries = await fs.readdir(this.templatesDir);
+        const tomlFiles = entries.filter((f) => f.endsWith('.toml'));
+        const templates = [];
+        // eslint-disable-next-line no-restricted-syntax
+        for (const file of tomlFiles) {
+            try {
+                const filePath = path.join(this.templatesDir, file);
+                // eslint-disable-next-line no-await-in-loop
+                const content = await fs.readFile(filePath, 'utf-8');
+                const raw = parseTOML(content);
+                templates.push(validateTemplate(raw, file));
+            }
+            catch {
+                // Skip invalid templates silently
+            }
+        }
+        return templates;
+    }
+    /**
+     * Get a single template by name.
+     */
+    async getTemplate(name) {
+        const templates = await this.listTemplates();
+        const template = templates.find((t) => t.name === name);
+        if (!template) {
+            const available = templates.map((t) => t.name).join(', ') || 'none';
+            throw new Error(`Template "${name}" not found. Available: ${available}`);
+        }
+        return template;
+    }
+    /**
+     * Apply variable substitution to a template.
+     * Returns the composed subject and body with variables replaced.
+     * Missing variables are left as {{variable}} placeholders.
+     */
+    async applyTemplate(name, variables, html = false) {
+        const template = await this.getTemplate(name);
+        const sanitized = Object.fromEntries(Object.entries(variables).map(([k, v]) => [k, sanitizeTemplateVariable(v, html)]));
+        // Warn about missing variables
+        const missing = template.variables.filter((v) => !(v in sanitized));
+        if (missing.length > 0) {
+            const composed = {
+                subject: substituteVariables(template.subject, sanitized),
+                body: substituteVariables(template.body, sanitized),
+            };
+            return composed;
+        }
+        return {
+            subject: substituteVariables(template.subject, sanitized),
+            body: substituteVariables(template.body, sanitized),
+        };
+    }
+    /** Get the templates directory path. */
+    get directory() {
+        return this.templatesDir;
+    }
+}
+//# sourceMappingURL=template.service.js.map

package/dist/services/template.service.js.map

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