@n24q02m/better-email-mcp 1.0.0

package/build/src/tools/composite/attachments.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Attachments Mega Tool
+ * List and download email attachments
+ */
+import type { AccountConfig } from '../helpers/config.js';
+export interface AttachmentsInput {
+    action: 'list' | 'download';
+    account: string;
+    uid: number;
+    folder?: string;
+    filename?: string;
+}
+/**
+ * Unified attachments tool - handles attachment operations
+ */
+export declare function attachments(accounts: AccountConfig[], input: AttachmentsInput): Promise<any>;
+//# sourceMappingURL=attachments.d.ts.map

package/build/src/tools/composite/attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../../../src/tools/composite/attachments.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAIzD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;IAG3B,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IAGX,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AA8BD;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAiClG"}

package/build/src/tools/composite/attachments.js

@@ -0,0 +1,77 @@
+/**
+ * Attachments Mega Tool
+ * List and download email attachments
+ */
+import { EmailMCPError, withErrorHandling } from '../helpers/errors.js';
+import { getAttachment, readEmail } from '../helpers/imap-client.js';
+/**
+ * Resolve a single account by filter
+ */
+function resolveSingleAccount(accounts, accountFilter) {
+    const lower = accountFilter.toLowerCase();
+    const matched = accounts.filter((a) => a.email.toLowerCase() === lower || a.id === lower || a.email.toLowerCase().includes(lower));
+    if (matched.length === 0) {
+        throw new EmailMCPError(`Account not found: ${accountFilter}`, 'ACCOUNT_NOT_FOUND', `Available accounts: ${accounts.map((a) => a.email).join(', ')}`);
+    }
+    if (matched.length > 1) {
+        throw new EmailMCPError('Multiple accounts matched. Specify the exact account email.', 'AMBIGUOUS_ACCOUNT', `Matched: ${matched.map((a) => a.email).join(', ')}`);
+    }
+    return matched[0];
+}
+/**
+ * Unified attachments tool - handles attachment operations
+ */
+export async function attachments(accounts, input) {
+    return withErrorHandling(async () => {
+        if (!input.account) {
+            throw new EmailMCPError('account is required for attachment operations', 'VALIDATION_ERROR', 'Provide the account email address');
+        }
+        if (!input.uid) {
+            throw new EmailMCPError('uid is required for attachment operations', 'VALIDATION_ERROR', 'Provide the email UID from search/read');
+        }
+        switch (input.action) {
+            case 'list':
+                return await handleList(accounts, input);
+            case 'download':
+                return await handleDownload(accounts, input);
+            default:
+                throw new EmailMCPError(`Unknown action: ${input.action}`, 'VALIDATION_ERROR', 'Supported actions: list, download');
+        }
+    })();
+}
+/**
+ * List attachments for an email
+ */
+async function handleList(accounts, input) {
+    const account = resolveSingleAccount(accounts, input.account);
+    const folder = input.folder || 'INBOX';
+    const email = await readEmail(account, input.uid, folder);
+    return {
+        action: 'list',
+        account: account.email,
+        uid: input.uid,
+        folder,
+        subject: email.subject,
+        total: email.attachments.length,
+        attachments: email.attachments
+    };
+}
+/**
+ * Download a specific attachment (returns base64)
+ */
+async function handleDownload(accounts, input) {
+    if (!input.filename) {
+        throw new EmailMCPError('filename is required for download action', 'VALIDATION_ERROR', 'Use attachments list action first to see available filenames');
+    }
+    const account = resolveSingleAccount(accounts, input.account);
+    const folder = input.folder || 'INBOX';
+    const attachment = await getAttachment(account, input.uid, folder, input.filename);
+    return {
+        action: 'download',
+        account: account.email,
+        uid: input.uid,
+        folder,
+        ...attachment
+    };
+}
+//# sourceMappingURL=attachments.js.map

package/build/src/tools/composite/attachments.js.map

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

package/build/src/tools/composite/attachments.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=attachments.test.d.ts.map

package/build/src/tools/composite/attachments.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.test.d.ts","sourceRoot":"","sources":["../../../../src/tools/composite/attachments.test.ts"],"names":[],"mappings":""}

package/build/src/tools/composite/attachments.test.js

@@ -0,0 +1,138 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+// --- Mocks ---
+vi.mock('../helpers/imap-client.js', () => ({
+    readEmail: vi.fn(),
+    getAttachment: vi.fn()
+}));
+import { getAttachment, readEmail } from '../helpers/imap-client.js';
+import { attachments } from './attachments.js';
+const mockReadEmail = vi.mocked(readEmail);
+const mockGetAttachment = vi.mocked(getAttachment);
+const accounts = [
+    {
+        id: 'user1_gmail_com',
+        email: 'user1@gmail.com',
+        password: 'pass1',
+        imap: { host: 'imap.gmail.com', port: 993, secure: true },
+        smtp: { host: 'smtp.gmail.com', port: 465, secure: true }
+    }
+];
+beforeEach(() => {
+    vi.clearAllMocks();
+});
+// ============================================================================
+// list
+// ============================================================================
+describe('attachments - list', () => {
+    it('lists attachments for an email', async () => {
+        mockReadEmail.mockResolvedValue({
+            account_id: 'user1_gmail_com',
+            account_email: 'user1@gmail.com',
+            uid: 10,
+            subject: 'Email with files',
+            from: 'sender@test.com',
+            to: 'user1@gmail.com',
+            date: '2025-01-01',
+            flags: [],
+            body_text: 'See attached',
+            attachments: [
+                { filename: 'doc.pdf', content_type: 'application/pdf', size: 1024 },
+                { filename: 'img.png', content_type: 'image/png', size: 2048 }
+            ]
+        });
+        const result = await attachments(accounts, {
+            action: 'list',
+            account: 'user1@gmail.com',
+            uid: 10
+        });
+        expect(result.action).toBe('list');
+        expect(result.total).toBe(2);
+        expect(result.attachments).toHaveLength(2);
+        expect(result.subject).toBe('Email with files');
+    });
+    it('returns empty list when no attachments', async () => {
+        mockReadEmail.mockResolvedValue({
+            account_id: 'user1_gmail_com',
+            account_email: 'user1@gmail.com',
+            uid: 10,
+            subject: 'No files',
+            from: 'x@test.com',
+            to: 'y@test.com',
+            date: '2025-01-01',
+            flags: [],
+            body_text: 'text',
+            attachments: []
+        });
+        const result = await attachments(accounts, {
+            action: 'list',
+            account: 'user1@gmail.com',
+            uid: 10
+        });
+        expect(result.total).toBe(0);
+        expect(result.attachments).toHaveLength(0);
+    });
+});
+// ============================================================================
+// download
+// ============================================================================
+describe('attachments - download', () => {
+    it('downloads attachment as base64', async () => {
+        mockGetAttachment.mockResolvedValue({
+            filename: 'report.pdf',
+            content_type: 'application/pdf',
+            size: 5000,
+            content_base64: 'base64content'
+        });
+        const result = await attachments(accounts, {
+            action: 'download',
+            account: 'user1@gmail.com',
+            uid: 10,
+            filename: 'report.pdf'
+        });
+        expect(result.action).toBe('download');
+        expect(result.content_base64).toBe('base64content');
+        expect(result.filename).toBe('report.pdf');
+    });
+    it('throws when filename is missing', async () => {
+        await expect(attachments(accounts, {
+            action: 'download',
+            account: 'user1@gmail.com',
+            uid: 10
+            // no filename
+        })).rejects.toThrow('filename is required');
+    });
+});
+// ============================================================================
+// validation
+// ============================================================================
+describe('attachments - validation', () => {
+    it('throws when account is missing', async () => {
+        await expect(attachments(accounts, {
+            action: 'list',
+            account: '',
+            uid: 10
+        })).rejects.toThrow();
+    });
+    it('throws when uid is missing', async () => {
+        await expect(attachments(accounts, {
+            action: 'list',
+            account: 'user1@gmail.com',
+            uid: 0
+        })).rejects.toThrow();
+    });
+    it('throws when account not found', async () => {
+        await expect(attachments(accounts, {
+            action: 'list',
+            account: 'nonexistent@test.com',
+            uid: 10
+        })).rejects.toThrow('Account not found');
+    });
+    it('throws for unknown action', async () => {
+        await expect(attachments(accounts, {
+            action: 'unknown',
+            account: 'user1@gmail.com',
+            uid: 10
+        })).rejects.toThrow();
+    });
+});
+//# sourceMappingURL=attachments.test.js.map

package/build/src/tools/composite/attachments.test.js.map

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

package/build/src/tools/composite/folders.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Folders Mega Tool
+ * List mailbox folders across email accounts
+ */
+import type { AccountConfig } from '../helpers/config.js';
+export interface FoldersInput {
+    action: 'list';
+    account?: string;
+}
+/**
+ * Unified folders tool - handles folder listing
+ */
+export declare function folders(accounts: AccountConfig[], input: FoldersInput): Promise<any>;
+//# sourceMappingURL=folders.d.ts.map

package/build/src/tools/composite/folders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../../../src/tools/composite/folders.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAIzD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IAGd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,CAU1F"}

package/build/src/tools/composite/folders.js

@@ -0,0 +1,57 @@
+/**
+ * Folders Mega Tool
+ * List mailbox folders across email accounts
+ */
+import { EmailMCPError, withErrorHandling } from '../helpers/errors.js';
+import { listFolders } from '../helpers/imap-client.js';
+/**
+ * Unified folders tool - handles folder listing
+ */
+export async function folders(accounts, input) {
+    return withErrorHandling(async () => {
+        switch (input.action) {
+            case 'list':
+                return await handleList(accounts, input);
+            default:
+                throw new EmailMCPError(`Unknown action: ${input.action}`, 'VALIDATION_ERROR', 'Supported actions: list');
+        }
+    })();
+}
+/**
+ * List folders across accounts
+ */
+async function handleList(accounts, input) {
+    let targetAccounts = accounts;
+    if (input.account) {
+        const lower = input.account.toLowerCase();
+        targetAccounts = accounts.filter((a) => a.email.toLowerCase() === lower || a.id === lower || a.email.toLowerCase().includes(lower));
+        if (targetAccounts.length === 0) {
+            throw new EmailMCPError(`Account not found: ${input.account}`, 'ACCOUNT_NOT_FOUND', `Available accounts: ${accounts.map((a) => a.email).join(', ')}`);
+        }
+    }
+    const results = [];
+    for (const account of targetAccounts) {
+        try {
+            const folderList = await listFolders(account);
+            results.push({
+                account_id: account.id,
+                account_email: account.email,
+                folders: folderList
+            });
+        }
+        catch (error) {
+            results.push({
+                account_id: account.id,
+                account_email: account.email,
+                error: error.message,
+                folders: []
+            });
+        }
+    }
+    return {
+        action: 'list',
+        total_accounts: results.length,
+        accounts: results
+    };
+}
+//# sourceMappingURL=folders.js.map

package/build/src/tools/composite/folders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.js","sourceRoot":"","sources":["../../../../src/tools/composite/folders.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AASvD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,QAAyB,EAAE,KAAmB;IAC1E,OAAO,iBAAiB,CAAC,KAAK,IAAI,EAAE;QAClC,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;YACrB,KAAK,MAAM;gBACT,OAAO,MAAM,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;YAE1C;gBACE,MAAM,IAAI,aAAa,CAAC,mBAAmB,KAAK,CAAC,MAAM,EAAE,EAAE,kBAAkB,EAAE,yBAAyB,CAAC,CAAA;QAC7G,CAAC;IACH,CAAC,CAAC,EAAE,CAAA;AACN,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,UAAU,CAAC,QAAyB,EAAE,KAAmB;IACtE,IAAI,cAAc,GAAG,QAAQ,CAAA;IAE7B,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAA;QACzC,cAAc,GAAG,QAAQ,CAAC,MAAM,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAClG,CAAA;QAED,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,aAAa,CACrB,sBAAsB,KAAK,CAAC,OAAO,EAAE,EACrC,mBAAmB,EACnB,uBAAuB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACjE,CAAA;QACH,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAU,EAAE,CAAA;IAEzB,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAA;YAC7C,OAAO,CAAC,IAAI,CAAC;gBACX,UAAU,EAAE,OAAO,CAAC,EAAE;gBACtB,aAAa,EAAE,OAAO,CAAC,KAAK;gBAC5B,OAAO,EAAE,UAAU;aACpB,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC;gBACX,UAAU,EAAE,OAAO,CAAC,EAAE;gBACtB,aAAa,EAAE,OAAO,CAAC,KAAK;gBAC5B,KAAK,EAAE,KAAK,CAAC,OAAO;gBACpB,OAAO,EAAE,EAAE;aACZ,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM;QACd,cAAc,EAAE,OAAO,CAAC,MAAM;QAC9B,QAAQ,EAAE,OAAO;KAClB,CAAA;AACH,CAAC"}

package/build/src/tools/composite/folders.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=folders.test.d.ts.map

package/build/src/tools/composite/folders.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.test.d.ts","sourceRoot":"","sources":["../../../../src/tools/composite/folders.test.ts"],"names":[],"mappings":""}

package/build/src/tools/composite/folders.test.js

@@ -0,0 +1,61 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+// --- Mocks ---
+vi.mock('../helpers/imap-client.js', () => ({
+    listFolders: vi.fn()
+}));
+import { listFolders } from '../helpers/imap-client.js';
+import { folders } from './folders.js';
+const mockListFolders = vi.mocked(listFolders);
+const accounts = [
+    {
+        id: 'user1_gmail_com',
+        email: 'user1@gmail.com',
+        password: 'pass1',
+        imap: { host: 'imap.gmail.com', port: 993, secure: true },
+        smtp: { host: 'smtp.gmail.com', port: 465, secure: true }
+    },
+    {
+        id: 'user2_outlook_com',
+        email: 'user2@outlook.com',
+        password: 'pass2',
+        imap: { host: 'outlook.office365.com', port: 993, secure: true },
+        smtp: { host: 'smtp.office365.com', port: 587, secure: false }
+    }
+];
+beforeEach(() => {
+    vi.clearAllMocks();
+});
+describe('folders - list', () => {
+    it('lists folders for all accounts', async () => {
+        mockListFolders.mockResolvedValue([{ name: 'INBOX', path: 'INBOX', flags: [], delimiter: '/' }]);
+        const result = await folders(accounts, { action: 'list' });
+        expect(result.action).toBe('list');
+        expect(result.total_accounts).toBe(2);
+        expect(result.accounts).toHaveLength(2);
+        expect(mockListFolders).toHaveBeenCalledTimes(2);
+    });
+    it('filters by account', async () => {
+        mockListFolders.mockResolvedValue([{ name: 'INBOX', path: 'INBOX', flags: [], delimiter: '/' }]);
+        const result = await folders(accounts, { action: 'list', account: 'user1@gmail.com' });
+        expect(result.total_accounts).toBe(1);
+        expect(result.accounts[0].account_email).toBe('user1@gmail.com');
+        expect(mockListFolders).toHaveBeenCalledTimes(1);
+    });
+    it('includes error when one account fails', async () => {
+        mockListFolders
+            .mockResolvedValueOnce([{ name: 'INBOX', path: 'INBOX', flags: [], delimiter: '/' }])
+            .mockRejectedValueOnce(new Error('Auth failed'));
+        const result = await folders(accounts, { action: 'list' });
+        expect(result.total_accounts).toBe(2);
+        expect(result.accounts[0].folders).toHaveLength(1);
+        expect(result.accounts[1].error).toBe('Auth failed');
+        expect(result.accounts[1].folders).toHaveLength(0);
+    });
+    it('throws when account not found', async () => {
+        await expect(folders(accounts, { action: 'list', account: 'nonexistent@test.com' })).rejects.toThrow('Account not found');
+    });
+    it('throws for unknown action', async () => {
+        await expect(folders(accounts, { action: 'unknown' })).rejects.toThrow();
+    });
+});
+//# sourceMappingURL=folders.test.js.map

package/build/src/tools/composite/folders.test.js.map

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

package/build/src/tools/composite/messages.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Messages Mega Tool
+ * All email message operations in one unified interface
+ */
+import type { AccountConfig } from '../helpers/config.js';
+export interface MessagesInput {
+    action: 'search' | 'read' | 'mark_read' | 'mark_unread' | 'flag' | 'unflag' | 'move' | 'archive' | 'trash';
+    account?: string;
+    query?: string;
+    folder?: string;
+    limit?: number;
+    uid?: number;
+    uids?: number[];
+    destination?: string;
+}
+/**
+ * Unified messages tool - handles all message operations
+ */
+export declare function messages(accounts: AccountConfig[], input: MessagesInput): Promise<any>;
+//# sourceMappingURL=messages.d.ts.map

package/build/src/tools/composite/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../../src/tools/composite/messages.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAIzD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;IAG1G,OAAO,CAAC,EAAE,MAAM,CAAA;IAGhB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IAGd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IAGf,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAuCD;;GAEG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAsC5F"}