mcp-twake-mail 0.1.0

package/build/errors.js

@@ -0,0 +1,154 @@
+import { ZodError } from 'zod';
+export class JMAPError extends Error {
+    type;
+    fix;
+    constructor(message, type, fix) {
+        super(message);
+        this.name = 'JMAPError';
+        this.type = type;
+        this.fix = fix;
+    }
+    /**
+     * Create a JMAPError for HTTP-level errors (4xx, 5xx responses)
+     */
+    static httpError(status, statusText) {
+        const message = `HTTP ${status}: ${statusText}`;
+        if (status === 401) {
+            return new JMAPError(message, 'unauthorized', 'Check your credentials. For basic auth: verify JMAP_USERNAME and JMAP_PASSWORD. For bearer: verify JMAP_TOKEN is valid.');
+        }
+        if (status === 403) {
+            return new JMAPError(message, 'forbidden', 'You do not have permission to access this resource. Check your account permissions.');
+        }
+        if (status === 404) {
+            return new JMAPError(message, 'notFound', 'The JMAP endpoint was not found. Verify JMAP_SESSION_URL is correct.');
+        }
+        if (status >= 500) {
+            return new JMAPError(message, 'serverError', 'The JMAP server encountered an error. Try again later or contact the server administrator.');
+        }
+        return new JMAPError(message, 'httpError', 'An HTTP error occurred. Check the server URL and try again.');
+    }
+    /**
+     * Create a JMAPError for JMAP method-level errors
+     */
+    static methodError(type, description) {
+        const message = description || `JMAP method error: ${type}`;
+        const fixes = {
+            stateMismatch: 'The state is stale. Refetch the data and try again.',
+            cannotCalculateChanges: 'State is too old. Perform a full sync instead of incremental.',
+            notFound: 'The requested item was not found. It may have been deleted.',
+            forbidden: 'You do not have permission for this operation.',
+            accountNotFound: 'The account ID is invalid. Refetch the session.',
+            noMailAccount: 'The server does not have a mail account. Check the JMAP server configuration.',
+            unknownCapability: 'The server does not support the requested capability.',
+            invalidArguments: 'The request arguments are invalid. Check the request parameters.',
+        };
+        const fix = fixes[type] || 'A JMAP error occurred. Check the error details and try again.';
+        return new JMAPError(message, type, fix);
+    }
+    /**
+     * Create a JMAPError for timeout errors
+     */
+    static timeout(operation) {
+        return new JMAPError(`${operation} timed out`, 'timeout', 'The operation took too long. Check your network connection and try again. If the issue persists, increase JMAP_REQUEST_TIMEOUT.');
+    }
+    /**
+     * Create a JMAPError for expired access token
+     */
+    static tokenExpired(refreshAvailable) {
+        if (refreshAvailable) {
+            return new JMAPError('Access token expired. Will attempt automatic refresh.', 'tokenExpired', 'The access token has expired. Automatic refresh will be attempted.');
+        }
+        return new JMAPError('Access token expired and no refresh token available. Re-authenticate using: npx mcp-twake-mail auth', 'tokenExpired', 'Your session has expired. Re-authenticate using: npx mcp-twake-mail auth');
+    }
+    /**
+     * Create a JMAPError for failed token refresh
+     */
+    static refreshFailed(reason) {
+        const message = reason ? `Token refresh failed: ${reason}` : 'Token refresh failed';
+        return new JMAPError(message, 'refreshFailed', 'Your session has expired. Re-authenticate using: npx mcp-twake-mail auth');
+    }
+    /**
+     * Create a JMAPError for OIDC flow errors
+     */
+    static oidcFlowError(stage, details) {
+        const message = details
+            ? `OIDC authentication failed at ${stage}: ${details}`
+            : `OIDC authentication failed at ${stage}`;
+        return new JMAPError(message, 'oidcError', 'Check your OIDC provider configuration. Verify JMAP_OIDC_ISSUER is correct and the provider supports PKCE.');
+    }
+    /**
+     * Create a JMAPError for missing stored tokens
+     */
+    static noStoredTokens() {
+        return new JMAPError('No stored authentication tokens found', 'noStoredTokens', 'Authenticate first using: npx mcp-twake-mail auth');
+    }
+}
+export function formatStartupError(error, sessionUrl) {
+    // Handle Zod validation errors
+    if (error instanceof ZodError) {
+        const issues = error.issues.map((issue) => {
+            const field = issue.path.join('.');
+            return `  ${field}: ${issue.message}`;
+        });
+        return [
+            'Configuration validation failed:',
+            ...issues,
+            '',
+            'Fix: Check your environment variables.',
+            'For basic auth: JMAP_SESSION_URL, JMAP_USERNAME, JMAP_PASSWORD',
+            'For bearer auth: JMAP_SESSION_URL, JMAP_AUTH_METHOD=bearer, JMAP_TOKEN',
+            'For OIDC auth: JMAP_SESSION_URL, JMAP_AUTH_METHOD=oidc, JMAP_OIDC_ISSUER, JMAP_OIDC_CLIENT_ID',
+        ].join('\n');
+    }
+    const message = error.message.toLowerCase();
+    // Token expiration errors
+    if (message.includes('token') && message.includes('expired')) {
+        return [
+            'Authentication token has expired.',
+            '',
+            'Fix: Re-authenticate using: npx mcp-twake-mail auth',
+        ].join('\n');
+    }
+    // OIDC/OAuth errors
+    if (message.includes('oidc') || message.includes('oauth')) {
+        return [
+            'OIDC authentication error.',
+            '',
+            'Fix: Check your OIDC configuration:',
+            '- Verify JMAP_OIDC_ISSUER is correct and accessible',
+            '- Verify JMAP_OIDC_CLIENT_ID is valid',
+            '- Ensure the OIDC provider supports PKCE',
+            '',
+            'Try re-authenticating: npx mcp-twake-mail auth',
+        ].join('\n');
+    }
+    // Authentication failures
+    if (message.includes('401') || message.includes('unauthorized')) {
+        return [
+            'Authentication failed for JMAP server.',
+            '',
+            'Fix: Verify your credentials are correct.',
+            'If using basic auth: check JMAP_USERNAME and JMAP_PASSWORD.',
+            'If using bearer: check JMAP_TOKEN is valid and not expired.',
+            'If using OIDC: try re-authenticating with npx mcp-twake-mail auth',
+        ].join('\n');
+    }
+    // Timeout errors
+    if (message.includes('timeout')) {
+        const urlContext = sessionUrl ? ` ${sessionUrl}` : '';
+        return [
+            `Connection to${urlContext} timed out.`,
+            '',
+            'Fix: Check the JMAP server is running and accessible.',
+            'Try accessing the session URL in a browser to verify it responds.',
+        ].join('\n');
+    }
+    // Fallback
+    return [
+        `Unexpected error: ${error.message}`,
+        '',
+        'Fix: Check your configuration and try again.',
+        'Verify JMAP_SESSION_URL and authentication settings.',
+    ].join('\n');
+}
+//# sourceMappingURL=errors.js.map

package/build/errors.js.map

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

package/build/errors.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/errors.test.js

@@ -0,0 +1,234 @@
+/**
+ * Tests for JMAPError class and formatStartupError function.
+ */
+import { describe, it, expect } from 'vitest';
+import { JMAPError, formatStartupError } from './errors.js';
+import { z } from 'zod';
+describe('JMAPError', () => {
+    describe('constructor', () => {
+        it('creates error with message, type, and fix', () => {
+            const error = new JMAPError('Test error', 'testType', 'Fix: do something');
+            expect(error.message).toBe('Test error');
+            expect(error.name).toBe('JMAPError');
+            expect(error.type).toBe('testType');
+            expect(error.fix).toBe('Fix: do something');
+        });
+    });
+    describe('httpError', () => {
+        it('creates 401 unauthorized error', () => {
+            const error = JMAPError.httpError(401, 'Unauthorized');
+            expect(error.message).toBe('HTTP 401: Unauthorized');
+            expect(error.type).toBe('unauthorized');
+            expect(error.fix).toContain('credentials');
+        });
+        it('creates 403 forbidden error', () => {
+            const error = JMAPError.httpError(403, 'Forbidden');
+            expect(error.message).toBe('HTTP 403: Forbidden');
+            expect(error.type).toBe('forbidden');
+            expect(error.fix).toContain('permission');
+        });
+        it('creates 404 not found error', () => {
+            const error = JMAPError.httpError(404, 'Not Found');
+            expect(error.message).toBe('HTTP 404: Not Found');
+            expect(error.type).toBe('notFound');
+            expect(error.fix).toContain('JMAP_SESSION_URL');
+        });
+        it('creates server error for 5xx status', () => {
+            const error = JMAPError.httpError(500, 'Internal Server Error');
+            expect(error.message).toBe('HTTP 500: Internal Server Error');
+            expect(error.type).toBe('serverError');
+            expect(error.fix).toContain('server');
+        });
+        it('creates generic http error for other status codes', () => {
+            const error = JMAPError.httpError(418, "I'm a teapot");
+            expect(error.message).toBe("HTTP 418: I'm a teapot");
+            expect(error.type).toBe('httpError');
+            expect(error.fix).toContain('HTTP error');
+        });
+    });
+    describe('methodError', () => {
+        it('creates error with description', () => {
+            const error = JMAPError.methodError('notFound', 'Email not found');
+            expect(error.message).toBe('Email not found');
+            expect(error.type).toBe('notFound');
+            expect(error.fix).toContain('not found');
+        });
+        it('creates error without description', () => {
+            const error = JMAPError.methodError('forbidden');
+            expect(error.message).toBe('JMAP method error: forbidden');
+            expect(error.type).toBe('forbidden');
+            expect(error.fix).toContain('permission');
+        });
+        it('handles stateMismatch error type', () => {
+            const error = JMAPError.methodError('stateMismatch');
+            expect(error.type).toBe('stateMismatch');
+            expect(error.fix).toContain('Refetch');
+        });
+        it('handles cannotCalculateChanges error type', () => {
+            const error = JMAPError.methodError('cannotCalculateChanges');
+            expect(error.type).toBe('cannotCalculateChanges');
+            expect(error.fix).toContain('full sync');
+        });
+        it('handles accountNotFound error type', () => {
+            const error = JMAPError.methodError('accountNotFound');
+            expect(error.type).toBe('accountNotFound');
+            expect(error.fix).toContain('Refetch the session');
+        });
+        it('handles unknownCapability error type', () => {
+            const error = JMAPError.methodError('unknownCapability');
+            expect(error.type).toBe('unknownCapability');
+            expect(error.fix).toContain('capability');
+        });
+        it('handles invalidArguments error type', () => {
+            const error = JMAPError.methodError('invalidArguments');
+            expect(error.type).toBe('invalidArguments');
+            expect(error.fix).toContain('arguments');
+        });
+        it('handles noMailAccount error type', () => {
+            const error = JMAPError.methodError('noMailAccount');
+            expect(error.type).toBe('noMailAccount');
+            expect(error.fix).toContain('mail account');
+        });
+        it('handles unknown error types with generic fix', () => {
+            const error = JMAPError.methodError('unknownType');
+            expect(error.type).toBe('unknownType');
+            expect(error.fix).toContain('JMAP error');
+        });
+    });
+    describe('timeout', () => {
+        it('creates timeout error with operation name', () => {
+            const error = JMAPError.timeout('fetchSession');
+            expect(error.message).toBe('fetchSession timed out');
+            expect(error.type).toBe('timeout');
+            expect(error.fix).toContain('JMAP_REQUEST_TIMEOUT');
+        });
+    });
+    describe('tokenExpired', () => {
+        it('creates error with refresh available', () => {
+            const error = JMAPError.tokenExpired(true);
+            expect(error.message).toContain('automatic refresh');
+            expect(error.type).toBe('tokenExpired');
+            expect(error.fix).toContain('Automatic');
+        });
+        it('creates error without refresh available', () => {
+            const error = JMAPError.tokenExpired(false);
+            expect(error.message).toContain('Re-authenticate');
+            expect(error.type).toBe('tokenExpired');
+            expect(error.fix).toContain('Re-authenticate');
+        });
+    });
+    describe('refreshFailed', () => {
+        it('creates error with reason', () => {
+            const error = JMAPError.refreshFailed('Invalid refresh token');
+            expect(error.message).toBe('Token refresh failed: Invalid refresh token');
+            expect(error.type).toBe('refreshFailed');
+            expect(error.fix).toContain('Re-authenticate');
+        });
+        it('creates error without reason', () => {
+            const error = JMAPError.refreshFailed();
+            expect(error.message).toBe('Token refresh failed');
+            expect(error.type).toBe('refreshFailed');
+        });
+    });
+    describe('oidcFlowError', () => {
+        it('creates error with details', () => {
+            const error = JMAPError.oidcFlowError('discovery', 'Issuer not found');
+            expect(error.message).toBe('OIDC authentication failed at discovery: Issuer not found');
+            expect(error.type).toBe('oidcError');
+            expect(error.fix).toContain('OIDC');
+        });
+        it('creates error without details', () => {
+            const error = JMAPError.oidcFlowError('token_exchange');
+            expect(error.message).toBe('OIDC authentication failed at token_exchange');
+            expect(error.type).toBe('oidcError');
+        });
+    });
+    describe('noStoredTokens', () => {
+        it('creates error for missing tokens', () => {
+            const error = JMAPError.noStoredTokens();
+            expect(error.message).toContain('No stored');
+            expect(error.type).toBe('noStoredTokens');
+            expect(error.fix).toContain('npx mcp-twake-mail auth');
+        });
+    });
+});
+describe('formatStartupError', () => {
+    describe('Zod validation errors', () => {
+        it('formats ZodError with field details', () => {
+            const schema = z.object({
+                JMAP_SESSION_URL: z.string().url(),
+                JMAP_USERNAME: z.string().min(1),
+            });
+            try {
+                schema.parse({ JMAP_SESSION_URL: 'invalid', JMAP_USERNAME: '' });
+            }
+            catch (error) {
+                const formatted = formatStartupError(error);
+                expect(formatted).toContain('Configuration validation failed');
+                expect(formatted).toContain('JMAP_SESSION_URL');
+                expect(formatted).toContain('JMAP_USERNAME');
+                expect(formatted).toContain('environment variables');
+            }
+        });
+    });
+    describe('token expiration errors', () => {
+        it('formats token expired error', () => {
+            const error = new Error('Access token has expired');
+            const formatted = formatStartupError(error);
+            expect(formatted).toContain('Authentication token has expired');
+            expect(formatted).toContain('npx mcp-twake-mail auth');
+        });
+    });
+    describe('OIDC/OAuth errors', () => {
+        it('formats OIDC error', () => {
+            const error = new Error('OIDC discovery failed');
+            const formatted = formatStartupError(error);
+            expect(formatted).toContain('OIDC authentication error');
+            expect(formatted).toContain('JMAP_OIDC_ISSUER');
+            expect(formatted).toContain('JMAP_OIDC_CLIENT_ID');
+        });
+        it('formats OAuth error', () => {
+            const error = new Error('OAuth token exchange failed');
+            const formatted = formatStartupError(error);
+            expect(formatted).toContain('OIDC authentication error');
+        });
+    });
+    describe('authentication failures', () => {
+        it('formats 401 error', () => {
+            const error = new Error('HTTP 401 Unauthorized');
+            const formatted = formatStartupError(error);
+            expect(formatted).toContain('Authentication failed');
+            expect(formatted).toContain('JMAP_USERNAME');
+            expect(formatted).toContain('JMAP_PASSWORD');
+        });
+        it('formats unauthorized error', () => {
+            const error = new Error('Request unauthorized');
+            const formatted = formatStartupError(error);
+            expect(formatted).toContain('Authentication failed');
+        });
+    });
+    describe('timeout errors', () => {
+        it('formats timeout error', () => {
+            const error = new Error('Connection timeout');
+            const formatted = formatStartupError(error, 'https://jmap.example.com/.well-known/jmap');
+            expect(formatted).toContain('timed out');
+            expect(formatted).toContain('https://jmap.example.com/.well-known/jmap');
+        });
+        it('formats timeout error without URL', () => {
+            const error = new Error('Request timeout');
+            const formatted = formatStartupError(error);
+            expect(formatted).toContain('timed out');
+            expect(formatted).toContain('JMAP server');
+        });
+    });
+    describe('fallback errors', () => {
+        it('formats unknown errors with generic message', () => {
+            const error = new Error('Something went wrong');
+            const formatted = formatStartupError(error);
+            expect(formatted).toContain('Unexpected error');
+            expect(formatted).toContain('Something went wrong');
+            expect(formatted).toContain('configuration');
+        });
+    });
+});
+//# sourceMappingURL=errors.test.js.map

package/build/errors.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.js","sourceRoot":"","sources":["../src/errors.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,YAAY,EAAE,UAAU,EAAE,mBAAmB,CAAC,CAAC;YAE3E,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACzC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACrC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;QACzB,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;YACxC,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YAEvD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YACrD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACxC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YAEpD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACrC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YAEpD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,uBAAuB,CAAC,CAAC;YAEhE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;YAC9D,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACvC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;YAC3D,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YAEvD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YACrD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACrC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;YACxC,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;YAEnE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAC9C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;YAEjD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAC3D,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACrC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;YAErD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACzC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,wBAAwB,CAAC,CAAC;YAE9D,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;YAEvD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAC3C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;YAEzD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAC7C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;YAExD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAC5C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;YAErD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACzC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;YAEnD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACvC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;QACvB,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YAEhD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YACrD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACnC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,MAAM,KAAK,GAAG,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAE3C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;YACrD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACxC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,MAAM,KAAK,GAAG,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YAE5C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;YACnD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACxC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;YACnC,MAAM,KAAK,GAAG,SAAS,CAAC,aAAa,CAAC,uBAAuB,CAAC,CAAC;YAE/D,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;YAC1E,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACzC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,KAAK,GAAG,SAAS,CAAC,aAAa,EAAE,CAAC;YAExC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YACnD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;YACpC,MAAM,KAAK,GAAG,SAAS,CAAC,aAAa,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;YAEvE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;YACxF,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACrC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,KAAK,GAAG,SAAS,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;YAExD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;YAC3E,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,KAAK,GAAG,SAAS,CAAC,cAAc,EAAE,CAAC;YAEzC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YAC7C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAC1C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;QACrC,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;gBACtB,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;gBAClC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;aACjC,CAAC,CAAC;YAEH,IAAI,CAAC;gBACH,MAAM,CAAC,KAAK,CAAC,EAAE,gBAAgB,EAAE,SAAS,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC;YACnE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAc,CAAC,CAAC;gBAErD,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,iCAAiC,CAAC,CAAC;gBAC/D,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;gBAChD,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;gBAC7C,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;YACvD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;YACpD,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAE5C,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,kCAAkC,CAAC,CAAC;YAChE,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACjC,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;YAC5B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACjD,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAE5C,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC;YACzD,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;YAChD,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;YAC7B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YACvD,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAE5C,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;YAC3B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACjD,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAE5C,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;YACrD,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;YAC7C,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;YACpC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;YAChD,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAE5C,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;YAC/B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAC9C,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,EAAE,2CAA2C,CAAC,CAAC;YAEzF,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YACzC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,2CAA2C,CAAC,CAAC;QAC3E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;YAC3C,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAE5C,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YACzC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAC/B,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;YAChD,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAE5C,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;YAChD,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;YACpD,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/build/index.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Entry point for mcp-twake-mail.
+ * Routes to CLI commands or MCP server based on arguments.
+ */
+import { runCLI } from './cli/index.js';
+runCLI().catch((error) => {
+    // Log to stderr (NEVER stdout - may be reserved for MCP JSON-RPC)
+    process.stderr.write(`Fatal error: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACvB,kEAAkE;IAClE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/jmap/client.d.ts

@@ -0,0 +1,96 @@
+/**
+ * JMAP client with session management, authentication, and request handling.
+ * Implements JMAP Core (RFC 8620) patterns.
+ */
+import type { Config } from '../config/schema.js';
+import type { Logger } from '../config/logger.js';
+import type { JMAPCapabilities, JMAPMethodCall, JMAPMethodResponse, JMAPResponse, JMAPErrorResponse } from '../types/jmap.js';
+/** Extracted session data from JMAP session response */
+export interface JMAPSession {
+    apiUrl: string;
+    downloadUrl: string;
+    accountId: string;
+    capabilities: JMAPCapabilities;
+    state: string;
+}
+/**
+ * JMAP client for interacting with JMAP mail servers.
+ * Handles authentication, session management, and request batching.
+ */
+export declare class JMAPClient {
+    private session;
+    private readonly config;
+    private readonly logger;
+    private readonly stateTracker;
+    private readonly tokenRefresher;
+    constructor(config: Config, logger: Logger);
+    /**
+     * Generate authentication headers based on configured auth method.
+     * For OIDC, automatically refreshes tokens if needed via TokenRefresher.
+     * @returns Headers object with Authorization and Content-Type
+     */
+    private getAuthHeaders;
+    /**
+     * Fetch JMAP session from the server.
+     * Discovers apiUrl, accountId, and capabilities.
+     * @returns JMAPSession with extracted session data
+     * @throws JMAPError if session fetch fails or no mail account found
+     */
+    fetchSession(): Promise<JMAPSession>;
+    /**
+     * Get the current session.
+     * @returns JMAPSession
+     * @throws JMAPError if session not initialized
+     */
+    getSession(): JMAPSession;
+    /**
+     * Make a batched JMAP request with multiple method calls.
+     * @param methodCalls Array of method calls to execute
+     * @param using Optional array of capability URIs (defaults to core + mail)
+     * @returns JMAPResponse with method responses
+     * @throws JMAPError on HTTP errors or timeouts
+     */
+    request(methodCalls: JMAPMethodCall[], using?: string[]): Promise<JMAPResponse>;
+    /**
+     * Parse a method response and extract success/error status.
+     * @param response The method response tuple
+     * @returns Object with success flag and data or error
+     */
+    parseMethodResponse(response: JMAPMethodResponse): {
+        success: boolean;
+        data?: Record<string, unknown>;
+        error?: JMAPErrorResponse;
+    };
+    /**
+     * Extract state from method response and update tracker.
+     * @param response The method response tuple
+     */
+    private extractAndUpdateState;
+    /**
+     * Update tracked state for an object type.
+     * @param type Object type (e.g., 'Email', 'Mailbox')
+     * @param state New state string
+     */
+    updateState(type: string, state: string): void;
+    /**
+     * Get tracked state for an object type.
+     * @param type Object type (e.g., 'Email', 'Mailbox')
+     * @returns State string or undefined if not tracked
+     */
+    getState(type: string): string | undefined;
+    /**
+     * Clear tracked state.
+     * @param type Optional object type to clear. If not provided, clears all state.
+     */
+    clearState(type?: string): void;
+    /**
+     * Download a blob (attachment) from the JMAP server.
+     * Uses the downloadUrl template from the session.
+     * @param blobId The blob ID to download
+     * @param name Optional filename for the download
+     * @param type Optional MIME type
+     * @returns ArrayBuffer containing the blob data
+     * @throws JMAPError if download fails
+     */
+    downloadBlob(blobId: string, name?: string, type?: string): Promise<ArrayBuffer>;
+}