mcp-twake-mail 0.1.0

package/build/cli/index.js

@@ -0,0 +1,56 @@
+/**
+ * CLI entry point using Commander.js.
+ * Routes between MCP server (default) and interactive commands.
+ */
+import { Command } from 'commander';
+import { startServer } from '../mcp/server.js';
+// Read version from package.json at runtime to stay in sync
+const VERSION = '0.1.0'; // Match package.json
+/**
+ * Create and configure the CLI program.
+ * @returns Configured Commander program
+ */
+export function createCLI() {
+    const program = new Command();
+    program
+        .name('mcp-twake-mail')
+        .description('MCP server for JMAP mail operations via Twake Mail')
+        .version(VERSION);
+    // Default action: start MCP server (no subcommand)
+    program
+        .action(async () => {
+        await startServer();
+    });
+    // Setup wizard command
+    program
+        .command('setup')
+        .description('Interactive configuration wizard')
+        .action(async () => {
+        const { runSetup } = await import('./commands/setup.js');
+        await runSetup();
+    });
+    program
+        .command('auth')
+        .description('Re-run OIDC authentication')
+        .action(async () => {
+        const { runAuth } = await import('./commands/auth.js');
+        await runAuth();
+    });
+    program
+        .command('check')
+        .description('Verify configuration and test connection')
+        .action(async () => {
+        const { runCheck } = await import('./commands/check.js');
+        await runCheck();
+    });
+    return program;
+}
+/**
+ * Run the CLI program.
+ * Uses parseAsync for proper async action handling.
+ */
+export async function runCLI() {
+    const program = createCLI();
+    await program.parseAsync(process.argv);
+}
+//# sourceMappingURL=index.js.map

package/build/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,4DAA4D;AAC5D,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,qBAAqB;AAE9C;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,gBAAgB,CAAC;SACtB,WAAW,CAAC,oDAAoD,CAAC;SACjE,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,mDAAmD;IACnD,OAAO;SACJ,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,WAAW,EAAE,CAAC;IACtB,CAAC,CAAC,CAAC;IAEL,uBAAuB;IACvB,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,kCAAkC,CAAC;SAC/C,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QACzD,MAAM,QAAQ,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,4BAA4B,CAAC;SACzC,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACvD,MAAM,OAAO,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,0CAA0C,CAAC;SACvD,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QACzD,MAAM,QAAQ,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM;IAC1B,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;IAC5B,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC"}

package/build/cli/prompts/setup-wizard.d.ts

@@ -0,0 +1,38 @@
+/** Auth method choices for the wizard */
+export type AuthMethod = 'oidc' | 'basic' | 'bearer';
+/**
+ * Prompt for JMAP session URL with validation.
+ */
+export declare function promptJmapUrl(): Promise<string>;
+/**
+ * Prompt for authentication method selection.
+ */
+export declare function promptAuthMethod(): Promise<AuthMethod>;
+/**
+ * Prompt for Basic auth credentials.
+ */
+export declare function promptBasicAuth(): Promise<{
+    username: string;
+    password: string;
+}>;
+/**
+ * Prompt for Bearer token.
+ */
+export declare function promptBearerToken(): Promise<string>;
+/**
+ * Prompt for OIDC configuration.
+ */
+export declare function promptOidcAuth(): Promise<{
+    issuer: string;
+    clientId: string;
+    scope: string;
+    redirectUri: string;
+}>;
+/**
+ * Prompt to confirm writing config to file.
+ */
+export declare function promptWriteConfig(): Promise<boolean>;
+/**
+ * Prompt for custom server name in Claude config.
+ */
+export declare function promptServerName(): Promise<string>;

package/build/cli/prompts/setup-wizard.js

@@ -0,0 +1,121 @@
+/**
+ * Interactive prompts for setup wizard.
+ * Uses @inquirer/prompts for modern, TypeScript-first prompts.
+ */
+import { input, select, password, confirm } from '@inquirer/prompts';
+/**
+ * Prompt for JMAP session URL with validation.
+ */
+export async function promptJmapUrl() {
+    return input({
+        message: 'JMAP Session URL:',
+        default: 'https://jmap.linagora.com/jmap/session',
+        validate: (value) => {
+            try {
+                new URL(value);
+                return true;
+            }
+            catch {
+                return 'Please enter a valid URL';
+            }
+        },
+    });
+}
+/**
+ * Prompt for authentication method selection.
+ */
+export async function promptAuthMethod() {
+    return select({
+        message: 'Authentication method:',
+        choices: [
+            { value: 'oidc', name: 'OIDC (recommended for Twake Mail)' },
+            { value: 'basic', name: 'Basic Auth (username/password)' },
+            { value: 'bearer', name: 'Bearer Token' },
+        ],
+    });
+}
+/**
+ * Prompt for Basic auth credentials.
+ */
+export async function promptBasicAuth() {
+    const username = await input({
+        message: 'Username (email):',
+        validate: (value) => value.length > 0 || 'Username is required',
+    });
+    const pwd = await password({
+        message: 'Password:',
+        mask: '*',
+    });
+    return { username, password: pwd };
+}
+/**
+ * Prompt for Bearer token.
+ */
+export async function promptBearerToken() {
+    return password({
+        message: 'Bearer token:',
+        mask: '*',
+        validate: (value) => value.length > 0 || 'Token is required',
+    });
+}
+/**
+ * Prompt for OIDC configuration.
+ */
+export async function promptOidcAuth() {
+    const issuer = await input({
+        message: 'OIDC Issuer URL:',
+        default: 'https://sso.linagora.com',
+        validate: (value) => {
+            try {
+                new URL(value);
+                return true;
+            }
+            catch {
+                return 'Please enter a valid URL';
+            }
+        },
+    });
+    const clientId = await input({
+        message: 'OAuth Client ID:',
+        default: 'twake-mail',
+        validate: (value) => value.length > 0 || 'Client ID is required',
+    });
+    const scope = await input({
+        message: 'OAuth Scopes:',
+        default: 'openid profile email offline_access',
+    });
+    const redirectUri = await input({
+        message: 'OAuth Redirect URI (registered with OIDC provider):',
+        default: 'http://localhost:3000/callback',
+        validate: (value) => {
+            try {
+                new URL(value);
+                return true;
+            }
+            catch {
+                return 'Please enter a valid URL';
+            }
+        },
+    });
+    return { issuer, clientId, scope, redirectUri };
+}
+/**
+ * Prompt to confirm writing config to file.
+ */
+export async function promptWriteConfig() {
+    return confirm({
+        message: 'Write config to Claude Desktop config file?',
+        default: true,
+    });
+}
+/**
+ * Prompt for custom server name in Claude config.
+ */
+export async function promptServerName() {
+    return input({
+        message: 'Server name in Claude Desktop:',
+        default: 'twake-mail',
+        validate: (value) => /^[a-z0-9-]+$/.test(value) || 'Use lowercase letters, numbers, and hyphens only',
+    });
+}
+//# sourceMappingURL=setup-wizard.js.map

package/build/cli/prompts/setup-wizard.js.map

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

package/build/config/__tests__/logger.test.d.ts

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

package/build/config/__tests__/logger.test.js

@@ -0,0 +1,28 @@
+import { describe, it, expect } from 'vitest';
+import { createLogger } from '../logger.js';
+describe('createLogger', () => {
+    it('should create a pino logger instance', () => {
+        const logger = createLogger('info');
+        // Verify it's a valid logger with expected methods
+        expect(logger).toHaveProperty('info');
+        expect(logger).toHaveProperty('error');
+        expect(logger).toHaveProperty('warn');
+        expect(logger).toHaveProperty('debug');
+        expect(logger).toHaveProperty('trace');
+        expect(logger).toHaveProperty('fatal');
+    });
+    it('should use the provided log level', () => {
+        const logger = createLogger('debug');
+        expect(logger.level).toBe('debug');
+    });
+    it('should default to info level', () => {
+        const logger = createLogger();
+        expect(logger.level).toBe('info');
+    });
+    it('should have mcp-twake-mail as name', () => {
+        const logger = createLogger();
+        // Pino logger has bindings for the name
+        expect(logger.bindings()).toHaveProperty('name', 'mcp-twake-mail');
+    });
+});
+//# sourceMappingURL=logger.test.js.map

package/build/config/__tests__/logger.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.test.js","sourceRoot":"","sources":["../../../src/config/__tests__/logger.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QAEpC,mDAAmD;QACnD,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QAErC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAE9B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAE9B,wCAAwC;QACxC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/config/__tests__/schema.test.d.ts

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

package/build/config/__tests__/schema.test.js

@@ -0,0 +1,101 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { loadConfig } from '../schema.js';
+import { ZodError } from 'zod';
+describe('loadConfig', () => {
+    const originalEnv = process.env;
+    beforeEach(() => {
+        process.env = { ...originalEnv };
+    });
+    it('should return Config type with valid env vars', () => {
+        process.env.JMAP_SESSION_URL = 'https://jmap.example.com/session';
+        process.env.JMAP_AUTH_METHOD = 'basic';
+        process.env.JMAP_USERNAME = 'test@example.com';
+        process.env.JMAP_PASSWORD = 'testpass';
+        const config = loadConfig();
+        expect(config).toHaveProperty('JMAP_SESSION_URL');
+        expect(config.JMAP_SESSION_URL).toBe('https://jmap.example.com/session');
+        expect(config.JMAP_USERNAME).toBe('test@example.com');
+        expect(config.JMAP_PASSWORD).toBe('testpass');
+        expect(config.LOG_LEVEL).toBe('info'); // default
+    });
+    it('should allow localhost with HTTP', () => {
+        process.env.JMAP_SESSION_URL = 'http://localhost:8080/session';
+        process.env.JMAP_USERNAME = 'test';
+        process.env.JMAP_PASSWORD = 'test';
+        const config = loadConfig();
+        expect(config.JMAP_SESSION_URL).toBe('http://localhost:8080/session');
+    });
+    it('should throw ZodError when JMAP_SESSION_URL is missing', () => {
+        delete process.env.JMAP_SESSION_URL;
+        process.env.JMAP_USERNAME = 'test';
+        process.env.JMAP_PASSWORD = 'test';
+        expect(() => loadConfig()).toThrow(ZodError);
+    });
+    it('should throw ZodError when using HTTP with non-localhost', () => {
+        process.env.JMAP_SESSION_URL = 'http://insecure.example.com/session';
+        process.env.JMAP_USERNAME = 'test';
+        process.env.JMAP_PASSWORD = 'test';
+        expect(() => loadConfig()).toThrow(ZodError);
+    });
+    it('should throw ZodError when basic auth missing username', () => {
+        process.env.JMAP_SESSION_URL = 'https://jmap.example.com/session';
+        process.env.JMAP_AUTH_METHOD = 'basic';
+        delete process.env.JMAP_USERNAME;
+        process.env.JMAP_PASSWORD = 'test';
+        expect(() => loadConfig()).toThrow(ZodError);
+    });
+    it('should throw ZodError when bearer auth missing token', () => {
+        process.env.JMAP_SESSION_URL = 'https://jmap.example.com/session';
+        process.env.JMAP_AUTH_METHOD = 'bearer';
+        delete process.env.JMAP_TOKEN;
+        expect(() => loadConfig()).toThrow(ZodError);
+    });
+    it('should throw ZodError when basic auth missing password', () => {
+        process.env.JMAP_SESSION_URL = 'https://jmap.example.com/session';
+        process.env.JMAP_AUTH_METHOD = 'basic';
+        process.env.JMAP_USERNAME = 'test@example.com';
+        delete process.env.JMAP_PASSWORD;
+        expect(() => loadConfig()).toThrow(ZodError);
+    });
+    it('should throw ZodError when oidc auth missing issuer', () => {
+        process.env.JMAP_SESSION_URL = 'https://jmap.example.com/session';
+        process.env.JMAP_AUTH_METHOD = 'oidc';
+        delete process.env.JMAP_OIDC_ISSUER;
+        process.env.JMAP_OIDC_CLIENT_ID = 'client-123';
+        expect(() => loadConfig()).toThrow(ZodError);
+    });
+    it('should throw ZodError when oidc auth missing client ID', () => {
+        process.env.JMAP_SESSION_URL = 'https://jmap.example.com/session';
+        process.env.JMAP_AUTH_METHOD = 'oidc';
+        process.env.JMAP_OIDC_ISSUER = 'https://auth.example.com';
+        delete process.env.JMAP_OIDC_CLIENT_ID;
+        expect(() => loadConfig()).toThrow(ZodError);
+    });
+    it('should allow valid oidc auth configuration', () => {
+        process.env.JMAP_SESSION_URL = 'https://jmap.example.com/session';
+        process.env.JMAP_AUTH_METHOD = 'oidc';
+        process.env.JMAP_OIDC_ISSUER = 'https://auth.example.com';
+        process.env.JMAP_OIDC_CLIENT_ID = 'client-123';
+        const config = loadConfig();
+        expect(config.JMAP_AUTH_METHOD).toBe('oidc');
+        expect(config.JMAP_OIDC_ISSUER).toBe('https://auth.example.com');
+        expect(config.JMAP_OIDC_CLIENT_ID).toBe('client-123');
+        expect(config.JMAP_OIDC_SCOPE).toBe('openid email offline_access'); // default
+    });
+    it('should allow bearer auth with valid token', () => {
+        process.env.JMAP_SESSION_URL = 'https://jmap.example.com/session';
+        process.env.JMAP_AUTH_METHOD = 'bearer';
+        process.env.JMAP_TOKEN = 'valid-bearer-token';
+        const config = loadConfig();
+        expect(config.JMAP_AUTH_METHOD).toBe('bearer');
+        expect(config.JMAP_TOKEN).toBe('valid-bearer-token');
+    });
+    it('should allow 127.0.0.1 with HTTP', () => {
+        process.env.JMAP_SESSION_URL = 'http://127.0.0.1:8080/session';
+        process.env.JMAP_USERNAME = 'test';
+        process.env.JMAP_PASSWORD = 'test';
+        const config = loadConfig();
+        expect(config.JMAP_SESSION_URL).toBe('http://127.0.0.1:8080/session');
+    });
+});
+//# sourceMappingURL=schema.test.js.map

package/build/config/__tests__/schema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.test.js","sourceRoot":"","sources":["../../../src/config/__tests__/schema.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAE/B,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;IAEhC,UAAU,CAAC,GAAG,EAAE;QACd,OAAO,CAAC,GAAG,GAAG,EAAE,GAAG,WAAW,EAAE,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,kCAAkC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,OAAO,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,kBAAkB,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,UAAU,CAAC;QAEvC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAE5B,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QACzE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,+BAA+B,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,MAAM,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,MAAM,CAAC;QAEnC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,MAAM,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,MAAM,CAAC;QAEnC,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,qCAAqC,CAAC;QACrE,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,MAAM,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,MAAM,CAAC;QAEnC,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,kCAAkC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,OAAO,CAAC;QACvC,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,MAAM,CAAC;QAEnC,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,kCAAkC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,QAAQ,CAAC;QACxC,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;QAE9B,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,kCAAkC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,OAAO,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,kBAAkB,CAAC;QAC/C,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;QAEjC,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,kCAAkC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,MAAM,CAAC;QACtC,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,YAAY,CAAC;QAE/C,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,kCAAkC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,MAAM,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,0BAA0B,CAAC;QAC1D,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QAEvC,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,kCAAkC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,MAAM,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,0BAA0B,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,YAAY,CAAC;QAE/C,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAE5B,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACjE,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,CAAC,UAAU;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,kCAAkC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,QAAQ,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,oBAAoB,CAAC;QAE9C,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAE5B,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,+BAA+B,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,MAAM,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,MAAM,CAAC;QAEnC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/config/logger.d.ts

@@ -0,0 +1,3 @@
+import pino from 'pino';
+export type Logger = pino.Logger;
+export declare function createLogger(level?: string): Logger;

package/build/config/logger.js

@@ -0,0 +1,9 @@
+import pino from 'pino';
+export function createLogger(level = 'info') {
+    return pino({
+        name: 'mcp-twake-mail',
+        level,
+    }, pino.destination(2) // CRITICAL: fd 2 = stderr. NEVER use stdout.
+    );
+}
+//# sourceMappingURL=logger.js.map

package/build/config/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/config/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAIxB,MAAM,UAAU,YAAY,CAAC,QAAgB,MAAM;IACjD,OAAO,IAAI,CACT;QACE,IAAI,EAAE,gBAAgB;QACtB,KAAK;KACN,EACD,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,6CAA6C;KAClE,CAAC;AACJ,CAAC"}

package/build/config/schema.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export declare const envSchema: z.ZodObject<{
+    JMAP_SESSION_URL: z.ZodString;
+    JMAP_AUTH_METHOD: z.ZodDefault<z.ZodEnum<{
+        oidc: "oidc";
+        basic: "basic";
+        bearer: "bearer";
+    }>>;
+    JMAP_USERNAME: z.ZodOptional<z.ZodString>;
+    JMAP_PASSWORD: z.ZodOptional<z.ZodString>;
+    JMAP_TOKEN: z.ZodOptional<z.ZodString>;
+    JMAP_OIDC_ISSUER: z.ZodOptional<z.ZodString>;
+    JMAP_OIDC_CLIENT_ID: z.ZodOptional<z.ZodString>;
+    JMAP_OIDC_SCOPE: z.ZodDefault<z.ZodString>;
+    JMAP_OIDC_REDIRECT_URI: z.ZodDefault<z.ZodString>;
+    JMAP_OIDC_LOCAL_PORT: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    JMAP_REQUEST_TIMEOUT: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    LOG_LEVEL: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        fatal: "fatal";
+        warn: "warn";
+        info: "info";
+        debug: "debug";
+        trace: "trace";
+    }>>;
+}, z.core.$strip>;
+export type Config = z.infer<typeof envSchema>;
+export declare function loadConfig(): Config;

package/build/config/schema.js

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+export const envSchema = z
+    .object({
+    JMAP_SESSION_URL: z
+        .string()
+        .url('JMAP_SESSION_URL must be a valid URL')
+        .refine((url) => {
+        const parsed = new URL(url);
+        return (parsed.protocol === 'https:' ||
+            parsed.hostname === 'localhost' ||
+            parsed.hostname === '127.0.0.1');
+    }, { message: 'URL must use HTTPS. Only localhost allowed over HTTP for development.' }),
+    JMAP_AUTH_METHOD: z.enum(['basic', 'bearer', 'oidc']).default('basic'),
+    JMAP_USERNAME: z.string().optional(),
+    JMAP_PASSWORD: z.string().optional(),
+    JMAP_TOKEN: z.string().optional(),
+    // OIDC configuration fields
+    JMAP_OIDC_ISSUER: z
+        .string()
+        .url('JMAP_OIDC_ISSUER must be a valid URL')
+        .optional(),
+    JMAP_OIDC_CLIENT_ID: z.string().optional(),
+    JMAP_OIDC_SCOPE: z.string().default('openid email offline_access'),
+    // Redirect URI for OIDC - must be registered with the provider
+    JMAP_OIDC_REDIRECT_URI: z.string().url().default('http://localhost:3000/callback'),
+    // Local port for OIDC callback server (useful when redirect URI is remote like ngrok)
+    JMAP_OIDC_LOCAL_PORT: z.coerce.number().optional(),
+    JMAP_REQUEST_TIMEOUT: z.coerce.number().default(30000),
+    LOG_LEVEL: z.enum(['fatal', 'error', 'warn', 'info', 'debug', 'trace']).default('info'),
+})
+    .superRefine((data, ctx) => {
+    // Conditional validation: basic auth requires username+password
+    if (data.JMAP_AUTH_METHOD === 'basic') {
+        if (!data.JMAP_USERNAME) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['JMAP_USERNAME'],
+                message: 'JMAP_USERNAME is required when using basic auth',
+            });
+        }
+        if (!data.JMAP_PASSWORD) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['JMAP_PASSWORD'],
+                message: 'JMAP_PASSWORD is required when using basic auth',
+            });
+        }
+    }
+    else if (data.JMAP_AUTH_METHOD === 'bearer') {
+        // Bearer auth requires a token
+        if (!data.JMAP_TOKEN) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['JMAP_TOKEN'],
+                message: 'JMAP_TOKEN is required when using bearer auth',
+            });
+        }
+    }
+    else if (data.JMAP_AUTH_METHOD === 'oidc') {
+        // OIDC requires issuer and client ID
+        if (!data.JMAP_OIDC_ISSUER) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['JMAP_OIDC_ISSUER'],
+                message: 'JMAP_OIDC_ISSUER is required when using oidc auth',
+            });
+        }
+        if (!data.JMAP_OIDC_CLIENT_ID) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['JMAP_OIDC_CLIENT_ID'],
+                message: 'JMAP_OIDC_CLIENT_ID is required when using oidc auth',
+            });
+        }
+        // Note: JMAP_TOKEN is NOT required for OIDC - tokens come from the OAuth flow
+    }
+});
+export function loadConfig() {
+    return envSchema.parse(process.env);
+}
+//# sourceMappingURL=schema.js.map

package/build/config/schema.js.map

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

package/build/errors.d.ts

@@ -0,0 +1,34 @@
+export declare class JMAPError extends Error {
+    type: string;
+    fix: string;
+    constructor(message: string, type: string, fix: string);
+    /**
+     * Create a JMAPError for HTTP-level errors (4xx, 5xx responses)
+     */
+    static httpError(status: number, statusText: string): JMAPError;
+    /**
+     * Create a JMAPError for JMAP method-level errors
+     */
+    static methodError(type: string, description?: string): JMAPError;
+    /**
+     * Create a JMAPError for timeout errors
+     */
+    static timeout(operation: string): JMAPError;
+    /**
+     * Create a JMAPError for expired access token
+     */
+    static tokenExpired(refreshAvailable: boolean): JMAPError;
+    /**
+     * Create a JMAPError for failed token refresh
+     */
+    static refreshFailed(reason?: string): JMAPError;
+    /**
+     * Create a JMAPError for OIDC flow errors
+     */
+    static oidcFlowError(stage: string, details?: string): JMAPError;
+    /**
+     * Create a JMAPError for missing stored tokens
+     */
+    static noStoredTokens(): JMAPError;
+}
+export declare function formatStartupError(error: Error, sessionUrl?: string): string;