mcp-twake-mail 0.1.0

package/build/transformers/__tests__/mailbox.test.js

@@ -0,0 +1,222 @@
+/**
+ * Tests for mailbox transformer - converts JMAP Mailbox objects to SimplifiedMailbox DTOs.
+ * TDD RED phase: These tests define the expected behavior.
+ */
+import { describe, it, expect } from 'vitest';
+import { transformMailbox } from '../mailbox.js';
+describe('transformMailbox', () => {
+    describe('core fields', () => {
+        it('transforms basic mailbox properties', () => {
+            const jmapMailbox = {
+                id: 'm1',
+                name: 'Inbox',
+                role: 'inbox',
+                totalEmails: 100,
+                unreadEmails: 5,
+                sortOrder: 1,
+                parentId: null,
+            };
+            const result = transformMailbox(jmapMailbox);
+            expect(result.id).toBe('m1');
+            expect(result.name).toBe('Inbox');
+            expect(result.role).toBe('inbox');
+            expect(result.totalEmails).toBe(100);
+            expect(result.unreadEmails).toBe(5);
+            expect(result.sortOrder).toBe(1);
+            expect(result.parentId).toBeNull();
+        });
+        it('preserves null role for custom folders', () => {
+            const jmapMailbox = {
+                id: 'm2',
+                name: 'Custom Folder',
+                role: null,
+                totalEmails: 50,
+                unreadEmails: 0,
+                sortOrder: 100,
+                parentId: null,
+            };
+            const result = transformMailbox(jmapMailbox);
+            expect(result.role).toBeNull();
+            expect(result.name).toBe('Custom Folder');
+        });
+        it('preserves parentId for nested folders', () => {
+            const jmapMailbox = {
+                id: 'm3',
+                name: 'Subfolder',
+                role: null,
+                totalEmails: 10,
+                unreadEmails: 2,
+                sortOrder: 50,
+                parentId: 'm1',
+            };
+            const result = transformMailbox(jmapMailbox);
+            expect(result.parentId).toBe('m1');
+        });
+    });
+    describe('standard roles', () => {
+        // Non-null roles only for testing
+        const standardRoles = [
+            'inbox',
+            'drafts',
+            'sent',
+            'trash',
+            'junk',
+            'archive',
+            'all',
+            'important',
+            'subscribed',
+        ];
+        it.each([...standardRoles])('preserves standard role: %s', (role) => {
+            const jmapMailbox = {
+                id: `m-${role}`,
+                name: role.charAt(0).toUpperCase() + role.slice(1),
+                role: role,
+                totalEmails: 10,
+                unreadEmails: 1,
+                sortOrder: 1,
+                parentId: null,
+            };
+            const result = transformMailbox(jmapMailbox);
+            expect(result.role).toBe(role);
+        });
+    });
+    describe('email counts', () => {
+        it('handles zero counts', () => {
+            const jmapMailbox = {
+                id: 'm4',
+                name: 'Empty Folder',
+                role: null,
+                totalEmails: 0,
+                unreadEmails: 0,
+                sortOrder: 10,
+                parentId: null,
+            };
+            const result = transformMailbox(jmapMailbox);
+            expect(result.totalEmails).toBe(0);
+            expect(result.unreadEmails).toBe(0);
+        });
+        it('handles large counts', () => {
+            const jmapMailbox = {
+                id: 'm5',
+                name: 'Archive',
+                role: 'archive',
+                totalEmails: 100000,
+                unreadEmails: 50000,
+                sortOrder: 10,
+                parentId: null,
+            };
+            const result = transformMailbox(jmapMailbox);
+            expect(result.totalEmails).toBe(100000);
+            expect(result.unreadEmails).toBe(50000);
+        });
+    });
+    describe('optional fields', () => {
+        it('handles missing optional fields gracefully', () => {
+            const jmapMailbox = {
+                id: 'm6',
+                name: 'Minimal Mailbox',
+                role: null,
+                totalEmails: 5,
+                unreadEmails: 1,
+                sortOrder: 1,
+                parentId: null,
+            };
+            const result = transformMailbox(jmapMailbox);
+            expect(result.id).toBe('m6');
+            // Should not throw and should return valid object
+            expect(result).toHaveProperty('id');
+            expect(result).toHaveProperty('name');
+            expect(result).toHaveProperty('role');
+            expect(result).toHaveProperty('totalEmails');
+            expect(result).toHaveProperty('unreadEmails');
+        });
+        it('includes totalThreads when present', () => {
+            const jmapMailbox = {
+                id: 'm7',
+                name: 'With Threads',
+                role: 'inbox',
+                totalEmails: 100,
+                unreadEmails: 10,
+                totalThreads: 80,
+                unreadThreads: 8,
+                sortOrder: 1,
+                parentId: null,
+            };
+            const result = transformMailbox(jmapMailbox);
+            expect(result.totalThreads).toBe(80);
+            expect(result.unreadThreads).toBe(8);
+        });
+    });
+    describe('sorting', () => {
+        it('preserves sortOrder values', () => {
+            const mailboxes = [
+                { id: 'm1', name: 'Inbox', role: 'inbox', totalEmails: 100, unreadEmails: 5, sortOrder: 1, parentId: null },
+                { id: 'm2', name: 'Sent', role: 'sent', totalEmails: 50, unreadEmails: 0, sortOrder: 2, parentId: null },
+                { id: 'm3', name: 'Custom', role: null, totalEmails: 10, unreadEmails: 1, sortOrder: 100, parentId: null },
+            ];
+            const results = mailboxes.map(transformMailbox);
+            expect(results[0].sortOrder).toBe(1);
+            expect(results[1].sortOrder).toBe(2);
+            expect(results[2].sortOrder).toBe(100);
+        });
+    });
+    describe('myRights', () => {
+        it('includes myRights when present', () => {
+            const jmapMailbox = {
+                id: 'm8',
+                name: 'Shared Folder',
+                role: null,
+                totalEmails: 10,
+                unreadEmails: 2,
+                sortOrder: 50,
+                parentId: null,
+                myRights: {
+                    mayReadItems: true,
+                    mayAddItems: true,
+                    mayRemoveItems: false,
+                    maySetSeen: true,
+                    maySetKeywords: true,
+                    mayCreateChild: false,
+                    mayRename: false,
+                    mayDelete: false,
+                    maySubmit: true,
+                },
+            };
+            const result = transformMailbox(jmapMailbox);
+            expect(result.myRights).toBeDefined();
+            expect(result.myRights.mayReadItems).toBe(true);
+            expect(result.myRights.mayRemoveItems).toBe(false);
+        });
+    });
+    describe('isSubscribed', () => {
+        it('includes isSubscribed when present', () => {
+            const jmapMailbox = {
+                id: 'm9',
+                name: 'Subscribed Folder',
+                role: null,
+                totalEmails: 10,
+                unreadEmails: 0,
+                sortOrder: 50,
+                parentId: null,
+                isSubscribed: true,
+            };
+            const result = transformMailbox(jmapMailbox);
+            expect(result.isSubscribed).toBe(true);
+        });
+        it('handles isSubscribed: false', () => {
+            const jmapMailbox = {
+                id: 'm10',
+                name: 'Unsubscribed Folder',
+                role: null,
+                totalEmails: 10,
+                unreadEmails: 0,
+                sortOrder: 50,
+                parentId: null,
+                isSubscribed: false,
+            };
+            const result = transformMailbox(jmapMailbox);
+            expect(result.isSubscribed).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=mailbox.test.js.map

package/build/transformers/__tests__/mailbox.test.js.map

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

package/build/transformers/email.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Email transformer - converts JMAP Email objects to SimplifiedEmail DTOs.
+ * Implements TRANS-03: keyword to boolean flag conversion.
+ */
+import type { SimplifiedEmail } from '../types/dto.js';
+/**
+ * JMAP Email address structure (from RFC 8621).
+ */
+interface JMAPEmailAddress {
+    name: string | null;
+    email: string;
+}
+/**
+ * JMAP Attachment structure.
+ */
+interface JMAPAttachment {
+    blobId: string;
+    type: string;
+    name: string | null;
+    size: number;
+}
+/**
+ * JMAP body part reference.
+ */
+interface JMAPBodyPart {
+    partId: string;
+    type: string;
+}
+/**
+ * JMAP body value.
+ */
+interface JMAPBodyValue {
+    value: string;
+    isEncodingProblem: boolean;
+    isTruncated: boolean;
+}
+/**
+ * JMAP Email object structure (subset needed for transformation).
+ */
+interface JMAPEmail {
+    id: string;
+    blobId: string;
+    threadId: string;
+    mailboxIds: Record<string, boolean>;
+    keywords?: Record<string, boolean>;
+    receivedAt: string;
+    subject: string | null;
+    from: JMAPEmailAddress[];
+    to: JMAPEmailAddress[];
+    cc?: JMAPEmailAddress[];
+    bcc?: JMAPEmailAddress[];
+    replyTo?: JMAPEmailAddress[];
+    preview?: string;
+    size?: number;
+    hasAttachment?: boolean;
+    textBody?: JMAPBodyPart[];
+    htmlBody?: JMAPBodyPart[];
+    bodyValues?: Record<string, JMAPBodyValue>;
+    attachments?: JMAPAttachment[];
+}
+/**
+ * Transform a JMAP Email object to SimplifiedEmail DTO.
+ * Converts keywords to boolean flags and mailboxIds to array.
+ *
+ * Keyword mapping:
+ * - $seen -> isRead
+ * - $flagged -> isFlagged
+ * - $draft -> isDraft
+ * - $answered -> isAnswered
+ * - $forwarded -> isForwarded
+ *
+ * @param jmapEmail JMAP Email object
+ * @returns SimplifiedEmail DTO
+ */
+export declare function transformEmail(jmapEmail: JMAPEmail): SimplifiedEmail;
+export {};

package/build/transformers/email.js

@@ -0,0 +1,138 @@
+/**
+ * Convert JMAP mailboxIds object to string array.
+ * Filters to only include mailboxes where value is true.
+ * @param mailboxIds Record of mailbox ID to boolean
+ * @returns Array of mailbox IDs
+ */
+function convertMailboxIds(mailboxIds) {
+    return Object.entries(mailboxIds)
+        .filter(([, isInMailbox]) => isInMailbox)
+        .map(([mailboxId]) => mailboxId);
+}
+/**
+ * Extract boolean flag from keywords object.
+ * @param keywords Keywords object or undefined
+ * @param keyword Keyword to check (e.g., '$seen')
+ * @returns true if keyword is set, false otherwise
+ */
+function hasKeyword(keywords, keyword) {
+    return keywords?.[keyword] === true;
+}
+/**
+ * Transform JMAP email addresses to EmailAddress DTOs.
+ * @param addresses JMAP email addresses
+ * @returns EmailAddress array
+ */
+function transformAddresses(addresses) {
+    if (!addresses) {
+        return [];
+    }
+    return addresses.map((addr) => ({
+        name: addr.name,
+        email: addr.email,
+    }));
+}
+/**
+ * Extract body content from JMAP body parts and values.
+ * @param bodyParts Body part references (textBody or htmlBody)
+ * @param bodyValues Body values keyed by partId
+ * @returns Extracted body text or undefined
+ */
+function extractBodyContent(bodyParts, bodyValues) {
+    if (!bodyParts || !bodyValues || bodyParts.length === 0) {
+        return undefined;
+    }
+    // Use first body part
+    const firstPart = bodyParts[0];
+    const value = bodyValues[firstPart.partId];
+    return value?.value;
+}
+/**
+ * Transform JMAP attachments to SimplifiedAttachment DTOs.
+ * @param attachments JMAP attachments
+ * @returns SimplifiedAttachment array or undefined
+ */
+function transformAttachments(attachments) {
+    if (!attachments || attachments.length === 0) {
+        return undefined;
+    }
+    return attachments.map((att) => ({
+        blobId: att.blobId,
+        type: att.type,
+        name: att.name,
+        size: att.size,
+    }));
+}
+/**
+ * Transform a JMAP Email object to SimplifiedEmail DTO.
+ * Converts keywords to boolean flags and mailboxIds to array.
+ *
+ * Keyword mapping:
+ * - $seen -> isRead
+ * - $flagged -> isFlagged
+ * - $draft -> isDraft
+ * - $answered -> isAnswered
+ * - $forwarded -> isForwarded
+ *
+ * @param jmapEmail JMAP Email object
+ * @returns SimplifiedEmail DTO
+ */
+export function transformEmail(jmapEmail) {
+    const keywords = jmapEmail.keywords;
+    const result = {
+        // Core identifiers
+        id: jmapEmail.id,
+        blobId: jmapEmail.blobId,
+        threadId: jmapEmail.threadId,
+        // Convert mailboxIds from object to array
+        mailboxIds: convertMailboxIds(jmapEmail.mailboxIds),
+        // Convert keywords to boolean flags
+        isRead: hasKeyword(keywords, '$seen'),
+        isFlagged: hasKeyword(keywords, '$flagged'),
+        isDraft: hasKeyword(keywords, '$draft'),
+        isAnswered: hasKeyword(keywords, '$answered'),
+        isForwarded: hasKeyword(keywords, '$forwarded'),
+        // Timestamp
+        receivedAt: jmapEmail.receivedAt,
+        // Content metadata
+        subject: jmapEmail.subject,
+        // Address fields
+        from: transformAddresses(jmapEmail.from),
+        to: transformAddresses(jmapEmail.to),
+    };
+    // Add optional fields only if present
+    if (jmapEmail.preview !== undefined) {
+        result.preview = jmapEmail.preview;
+    }
+    if (jmapEmail.size !== undefined) {
+        result.size = jmapEmail.size;
+    }
+    if (jmapEmail.hasAttachment !== undefined) {
+        result.hasAttachment = jmapEmail.hasAttachment;
+    }
+    if (jmapEmail.cc) {
+        result.cc = transformAddresses(jmapEmail.cc);
+    }
+    if (jmapEmail.bcc) {
+        result.bcc = transformAddresses(jmapEmail.bcc);
+    }
+    if (jmapEmail.replyTo) {
+        result.replyTo = transformAddresses(jmapEmail.replyTo);
+    }
+    // Extract body content if available
+    const textBody = extractBodyContent(jmapEmail.textBody, jmapEmail.bodyValues);
+    if (textBody !== undefined) {
+        result.textBody = textBody;
+    }
+    const htmlBody = extractBodyContent(jmapEmail.htmlBody, jmapEmail.bodyValues);
+    if (htmlBody !== undefined) {
+        result.htmlBody = htmlBody;
+    }
+    // Transform attachments
+    const attachments = transformAttachments(jmapEmail.attachments);
+    if (attachments !== undefined) {
+        result.attachments = attachments;
+    }
+    return result;
+}
+//# sourceMappingURL=email.js.map

package/build/transformers/email.js.map

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

package/build/transformers/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Transformers module - converts JMAP objects to simplified DTOs.
+ */
+export { transformEmail } from './email.js';
+export { transformMailbox } from './mailbox.js';

package/build/transformers/index.js

@@ -0,0 +1,6 @@
+/**
+ * Transformers module - converts JMAP objects to simplified DTOs.
+ */
+export { transformEmail } from './email.js';
+export { transformMailbox } from './mailbox.js';
+//# sourceMappingURL=index.js.map

package/build/transformers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transformers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/build/transformers/mailbox.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Mailbox transformer - converts JMAP Mailbox objects to SimplifiedMailbox DTOs.
+ */
+import type { SimplifiedMailbox } from '../types/dto.js';
+/**
+ * JMAP Mailbox rights structure (from RFC 8621).
+ */
+interface JMAPMailboxRights {
+    mayReadItems: boolean;
+    mayAddItems: boolean;
+    mayRemoveItems: boolean;
+    maySetSeen: boolean;
+    maySetKeywords: boolean;
+    mayCreateChild: boolean;
+    mayRename: boolean;
+    mayDelete: boolean;
+    maySubmit: boolean;
+}
+/**
+ * JMAP Mailbox object structure (subset needed for transformation).
+ */
+interface JMAPMailbox {
+    id: string;
+    name: string;
+    role: string | null;
+    totalEmails: number;
+    unreadEmails: number;
+    sortOrder: number;
+    parentId: string | null;
+    totalThreads?: number;
+    unreadThreads?: number;
+    myRights?: JMAPMailboxRights;
+    isSubscribed?: boolean;
+}
+/**
+ * Transform a JMAP Mailbox object to SimplifiedMailbox DTO.
+ * Straightforward property mapping with type safety.
+ *
+ * @param jmapMailbox JMAP Mailbox object
+ * @returns SimplifiedMailbox DTO
+ */
+export declare function transformMailbox(jmapMailbox: JMAPMailbox): SimplifiedMailbox;
+export {};

package/build/transformers/mailbox.js

@@ -0,0 +1,70 @@
+/**
+ * Validate and type-cast role to MailboxRole.
+ * @param role Raw role string from JMAP
+ * @returns Typed MailboxRole
+ */
+function castRole(role) {
+    if (role === null) {
+        return null;
+    }
+    // Known roles are passed through; unknown roles are treated as null
+    const knownRoles = ['inbox', 'drafts', 'sent', 'trash', 'junk', 'archive', 'all', 'important', 'subscribed'];
+    return knownRoles.includes(role) ? role : null;
+}
+/**
+ * Transform JMAP mailbox rights to MailboxRights DTO.
+ * @param rights JMAP rights object
+ * @returns MailboxRights or undefined
+ */
+function transformRights(rights) {
+    if (!rights) {
+        return undefined;
+    }
+    return {
+        mayReadItems: rights.mayReadItems,
+        mayAddItems: rights.mayAddItems,
+        mayRemoveItems: rights.mayRemoveItems,
+        maySetSeen: rights.maySetSeen,
+        maySetKeywords: rights.maySetKeywords,
+        mayCreateChild: rights.mayCreateChild,
+        mayRename: rights.mayRename,
+        mayDelete: rights.mayDelete,
+        maySubmit: rights.maySubmit,
+    };
+}
+/**
+ * Transform a JMAP Mailbox object to SimplifiedMailbox DTO.
+ * Straightforward property mapping with type safety.
+ *
+ * @param jmapMailbox JMAP Mailbox object
+ * @returns SimplifiedMailbox DTO
+ */
+export function transformMailbox(jmapMailbox) {
+    const result = {
+        // Core identifiers
+        id: jmapMailbox.id,
+        name: jmapMailbox.name,
+        role: castRole(jmapMailbox.role),
+        // Hierarchy
+        parentId: jmapMailbox.parentId,
+        sortOrder: jmapMailbox.sortOrder,
+        // Email counts
+        totalEmails: jmapMailbox.totalEmails,
+        unreadEmails: jmapMailbox.unreadEmails,
+    };
+    // Add optional fields only if present
+    if (jmapMailbox.totalThreads !== undefined) {
+        result.totalThreads = jmapMailbox.totalThreads;
+    }
+    if (jmapMailbox.unreadThreads !== undefined) {
+        result.unreadThreads = jmapMailbox.unreadThreads;
+    }
+    if (jmapMailbox.myRights !== undefined) {
+        result.myRights = transformRights(jmapMailbox.myRights);
+    }
+    if (jmapMailbox.isSubscribed !== undefined) {
+        result.isSubscribed = jmapMailbox.isSubscribed;
+    }
+    return result;
+}
+//# sourceMappingURL=mailbox.js.map

package/build/transformers/mailbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox.js","sourceRoot":"","sources":["../../src/transformers/mailbox.ts"],"names":[],"mappings":"AAqCA;;;;GAIG;AACH,SAAS,QAAQ,CAAC,IAAmB;IACnC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,oEAAoE;IACpE,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IAC7G,OAAO,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAoB,CAAC,CAAC,CAAC,IAAI,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,MAAqC;IAC5D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO;QACL,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAwB;IACvD,MAAM,MAAM,GAAsB;QAChC,mBAAmB;QACnB,EAAE,EAAE,WAAW,CAAC,EAAE;QAClB,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,IAAI,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC;QAEhC,YAAY;QACZ,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,SAAS,EAAE,WAAW,CAAC,SAAS;QAEhC,eAAe;QACf,WAAW,EAAE,WAAW,CAAC,WAAW;QACpC,YAAY,EAAE,WAAW,CAAC,YAAY;KACvC,CAAC;IAEF,sCAAsC;IACtC,IAAI,WAAW,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QAC3C,MAAM,CAAC,YAAY,GAAG,WAAW,CAAC,YAAY,CAAC;IACjD,CAAC;IACD,IAAI,WAAW,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QAC5C,MAAM,CAAC,aAAa,GAAG,WAAW,CAAC,aAAa,CAAC;IACnD,CAAC;IACD,IAAI,WAAW,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,CAAC,QAAQ,GAAG,eAAe,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,WAAW,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QAC3C,MAAM,CAAC,YAAY,GAAG,WAAW,CAAC,YAAY,CAAC;IACjD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}