mcp-twake-mail 0.1.0

package/build/auth/token-refresh.js

@@ -0,0 +1,132 @@
+import * as client from 'openid-client';
+import { loadTokens, saveTokens } from './token-store.js';
+import { JMAPError } from '../errors.js';
+/**
+ * Refresh tokens 60 seconds before actual expiry
+ * This buffer ensures tokens are refreshed before they become invalid
+ */
+export const TOKEN_EXPIRY_BUFFER = 60;
+/**
+ * Token refresher with mutex for concurrent access safety
+ *
+ * When an MCP server handles multiple simultaneous requests, each may try
+ * to refresh the token if it's expiring soon. Without coordination, this
+ * causes "invalid_grant" errors. This class ensures only one refresh
+ * happens at a time and all callers get the fresh token.
+ */
+export class TokenRefresher {
+    issuerUrl;
+    clientId;
+    refreshPromise = null;
+    cachedConfig = null;
+    constructor(issuerUrl, clientId) {
+        this.issuerUrl = issuerUrl;
+        this.clientId = clientId;
+    }
+    /**
+     * Get or create cached OIDC issuer configuration
+     */
+    async getIssuerConfig() {
+        if (!this.cachedConfig) {
+            this.cachedConfig = await client.discovery(new URL(this.issuerUrl), this.clientId);
+        }
+        return this.cachedConfig;
+    }
+    /**
+     * Check if token is valid (not expired or expiring soon)
+     * Returns false if token will expire within TOKEN_EXPIRY_BUFFER seconds
+     */
+    isTokenValid(tokens) {
+        if (!tokens.expiresAt) {
+            // No expiry info - assume valid (server will reject if not)
+            return true;
+        }
+        const now = Math.floor(Date.now() / 1000);
+        const expiresIn = tokens.expiresAt - now;
+        // Token is valid if it won't expire within the buffer period
+        return expiresIn > TOKEN_EXPIRY_BUFFER;
+    }
+    /**
+     * Ensure we have a valid token, refreshing if necessary
+     *
+     * Uses a mutex pattern: if a refresh is already in progress,
+     * all callers wait for that same promise rather than starting
+     * parallel refresh requests.
+     */
+    async ensureValidToken() {
+        // Load stored tokens
+        const tokens = await loadTokens();
+        if (!tokens) {
+            throw JMAPError.noStoredTokens();
+        }
+        // If token is still valid, return it
+        if (this.isTokenValid(tokens)) {
+            return tokens;
+        }
+        // Token needs refresh - check if we have a refresh token
+        if (!tokens.refreshToken) {
+            throw JMAPError.tokenExpired(false);
+        }
+        // Mutex: if refresh is already in progress, wait for it
+        if (this.refreshPromise) {
+            return this.refreshPromise;
+        }
+        // Start refresh and store the promise for concurrent callers
+        this.refreshPromise = this.doRefresh(tokens.refreshToken);
+        try {
+            const newTokens = await this.refreshPromise;
+            return newTokens;
+        }
+        finally {
+            // Clear the mutex when refresh completes (success or failure)
+            this.refreshPromise = null;
+        }
+    }
+    /**
+     * Perform the actual token refresh
+     */
+    async doRefresh(refreshToken) {
+        try {
+            const config = await this.getIssuerConfig();
+            const tokenResponse = await client.refreshTokenGrant(config, refreshToken);
+            // Build new stored tokens
+            const newTokens = {
+                accessToken: tokenResponse.access_token,
+                refreshToken: tokenResponse.refresh_token ?? refreshToken, // Keep old refresh token if not rotated
+                expiresAt: tokenResponse.expires_in
+                    ? Math.floor(Date.now() / 1000) + tokenResponse.expires_in
+                    : undefined,
+                idToken: tokenResponse.id_token,
+            };
+            // Persist new tokens
+            await saveTokens(newTokens);
+            return newTokens;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            throw JMAPError.refreshFailed(message);
+        }
+    }
+    /**
+     * Clear cached configuration (useful for testing)
+     */
+    clearCache() {
+        this.cachedConfig = null;
+        this.refreshPromise = null;
+    }
+}
+/**
+ * Factory function to create a TokenRefresher instance
+ */
+export function createTokenRefresher(issuerUrl, clientId) {
+    return new TokenRefresher(issuerUrl, clientId);
+}
+/**
+ * Convenience function to ensure valid token with a new refresher
+ * For simple use cases that don't need to maintain refresher state
+ */
+export async function ensureValidToken(issuerUrl, clientId) {
+    const refresher = createTokenRefresher(issuerUrl, clientId);
+    return refresher.ensureValidToken();
+}
+//# sourceMappingURL=token-refresh.js.map

package/build/auth/token-refresh.js.map

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

package/build/auth/token-store.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Structure for stored OIDC tokens
+ */
+export interface StoredTokens {
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt?: number;
+    idToken?: string;
+}
+/**
+ * Path to token storage file
+ * ~/.mcp-twake-mail/tokens.json
+ */
+declare const TOKEN_PATH: string;
+/**
+ * Save tokens to secure file storage
+ * Creates parent directory with 0700 permissions
+ * Writes token file with 0600 permissions (owner read/write only)
+ */
+export declare function saveTokens(tokens: StoredTokens): Promise<void>;
+/**
+ * Load tokens from storage
+ * Returns null if no tokens are stored
+ */
+export declare function loadTokens(): Promise<StoredTokens | null>;
+/**
+ * Clear stored tokens (logout)
+ */
+export declare function clearTokens(): Promise<void>;
+/**
+ * Export TOKEN_PATH for testing purposes
+ */
+export { TOKEN_PATH };

package/build/auth/token-store.js

@@ -0,0 +1,63 @@
+import { mkdir, writeFile, readFile, unlink, chmod } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join, dirname } from 'node:path';
+/**
+ * Path to token storage file
+ * ~/.mcp-twake-mail/tokens.json
+ */
+const TOKEN_PATH = join(homedir(), '.mcp-twake-mail', 'tokens.json');
+/**
+ * Save tokens to secure file storage
+ * Creates parent directory with 0700 permissions
+ * Writes token file with 0600 permissions (owner read/write only)
+ */
+export async function saveTokens(tokens) {
+    const dir = dirname(TOKEN_PATH);
+    // Create parent directory with restricted permissions
+    await mkdir(dir, { recursive: true, mode: 0o700 });
+    // Write tokens file
+    await writeFile(TOKEN_PATH, JSON.stringify(tokens, null, 2), {
+        mode: 0o600,
+        encoding: 'utf-8',
+    });
+    // Ensure permissions even if file already existed
+    await chmod(TOKEN_PATH, 0o600);
+}
+/**
+ * Load tokens from storage
+ * Returns null if no tokens are stored
+ */
+export async function loadTokens() {
+    try {
+        const content = await readFile(TOKEN_PATH, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        // File doesn't exist - that's okay, just return null
+        if (error.code === 'ENOENT') {
+            return null;
+        }
+        // Re-throw other errors (permission issues, corrupted JSON, etc.)
+        throw error;
+    }
+}
+/**
+ * Clear stored tokens (logout)
+ */
+export async function clearTokens() {
+    try {
+        await unlink(TOKEN_PATH);
+    }
+    catch (error) {
+        // File doesn't exist - already cleared, that's fine
+        if (error.code === 'ENOENT') {
+            return;
+        }
+        throw error;
+    }
+}
+/**
+ * Export TOKEN_PATH for testing purposes
+ */
+export { TOKEN_PATH };
+//# sourceMappingURL=token-store.js.map

package/build/auth/token-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-store.js","sourceRoot":"","sources":["../../src/auth/token-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAY1C;;;GAGG;AACH,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,iBAAiB,EAAE,aAAa,CAAC,CAAC;AAErE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAoB;IACnD,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEhC,sDAAsD;IACtD,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAEnD,oBAAoB;IACpB,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;QAC3D,IAAI,EAAE,KAAK;QACX,QAAQ,EAAE,OAAO;KAClB,CAAC,CAAC;IAEH,kDAAkD;IAClD,MAAM,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAiB,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,qDAAqD;QACrD,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,kEAAkE;QAClE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,oDAAoD;QACpD,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO;QACT,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/build/cli/commands/auth.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Run OIDC authentication flow using current environment config.
+ * Requires JMAP_AUTH_METHOD=oidc and OIDC env vars to be set.
+ */
+export declare function runAuth(): Promise<void>;

package/build/cli/commands/auth.js

@@ -0,0 +1,49 @@
+/**
+ * Auth command - re-run OIDC authentication flow.
+ * Useful when tokens have expired or been revoked.
+ */
+import { loadConfig } from '../../config/schema.js';
+import { performOIDCFlow, getOIDCOptionsFromConfig } from '../../auth/oidc-flow.js';
+/**
+ * Run OIDC authentication flow using current environment config.
+ * Requires JMAP_AUTH_METHOD=oidc and OIDC env vars to be set.
+ */
+export async function runAuth() {
+    console.log('\n=== MCP Twake Mail - Re-authenticate ===\n');
+    // Load config from environment
+    let config;
+    try {
+        config = loadConfig();
+    }
+    catch (error) {
+        console.error('Configuration error:', error instanceof Error ? error.message : String(error));
+        console.error('\nMake sure environment variables are set. Run `mcp-twake-mail setup` to configure.');
+        process.exit(1);
+    }
+    // Check if OIDC is configured
+    const oidcOptions = getOIDCOptionsFromConfig(config);
+    if (!oidcOptions) {
+        console.error('OIDC is not configured.');
+        console.error('\nThis command only works when JMAP_AUTH_METHOD=oidc');
+        console.error('For basic or bearer auth, credentials are read from environment variables.');
+        process.exit(1);
+    }
+    console.log(`Issuer: ${oidcOptions.issuerUrl}`);
+    console.log(`Client ID: ${oidcOptions.clientId}`);
+    console.log(`Scopes: ${oidcOptions.scope}`);
+    console.log('\nOpening browser for authentication...\n');
+    try {
+        const tokens = await performOIDCFlow(oidcOptions);
+        console.log('\nAuthentication successful!');
+        console.log(`Access token stored (expires: ${tokens.expiresAt ? new Date(tokens.expiresAt * 1000).toISOString() : 'unknown'})`);
+        if (tokens.refreshToken) {
+            console.log('Refresh token stored for automatic renewal.');
+        }
+        console.log('\nYou can now use mcp-twake-mail.\n');
+    }
+    catch (error) {
+        console.error('\nAuthentication failed:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=auth.js.map

package/build/cli/commands/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/cli/commands/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEpF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO;IAC3B,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAE5D,+BAA+B;IAC/B,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,UAAU,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9F,OAAO,CAAC,KAAK,CAAC,qFAAqF,CAAC,CAAC;QACrG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,8BAA8B;IAC9B,MAAM,WAAW,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACzC,OAAO,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;QACtE,OAAO,CAAC,KAAK,CAAC,4EAA4E,CAAC,CAAC;QAC5F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,WAAW,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,cAAc,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,WAAW,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;IAEzD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,iCAAiC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC;QAChI,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAClG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/build/cli/commands/check.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Run configuration and connection checks.
+ */
+export declare function runCheck(): Promise<void>;

package/build/cli/commands/check.js

@@ -0,0 +1,125 @@
+/**
+ * Check command - verify configuration and test connection.
+ * Helps users diagnose configuration issues.
+ */
+import { loadConfig } from '../../config/schema.js';
+import { createLogger } from '../../config/logger.js';
+import { JMAPClient } from '../../jmap/client.js';
+/**
+ * Format check result with status indicator.
+ */
+function formatResult(result) {
+    const icons = { ok: '[OK]', warning: '[WARN]', error: '[FAIL]' };
+    return `${icons[result.status]} ${result.name}: ${result.message}`;
+}
+/**
+ * Check environment configuration.
+ */
+function checkEnvironment() {
+    const results = [];
+    // Check JMAP URL
+    const jmapUrl = process.env.JMAP_SESSION_URL;
+    if (jmapUrl) {
+        results.push({ name: 'JMAP URL', status: 'ok', message: jmapUrl });
+    }
+    else {
+        results.push({ name: 'JMAP URL', status: 'error', message: 'JMAP_SESSION_URL not set' });
+    }
+    // Check auth method
+    const authMethod = process.env.JMAP_AUTH_METHOD;
+    if (authMethod) {
+        results.push({ name: 'Auth Method', status: 'ok', message: authMethod });
+        // Check auth-specific vars
+        if (authMethod === 'basic') {
+            const hasUser = !!process.env.JMAP_USERNAME;
+            const hasPass = !!process.env.JMAP_PASSWORD;
+            if (hasUser && hasPass) {
+                results.push({ name: 'Basic Auth', status: 'ok', message: 'Credentials configured' });
+            }
+            else {
+                results.push({
+                    name: 'Basic Auth',
+                    status: 'error',
+                    message: `Missing: ${!hasUser ? 'JMAP_USERNAME' : ''} ${!hasPass ? 'JMAP_PASSWORD' : ''}`.trim(),
+                });
+            }
+        }
+        else if (authMethod === 'bearer') {
+            if (process.env.JMAP_BEARER_TOKEN) {
+                results.push({ name: 'Bearer Token', status: 'ok', message: 'Token configured' });
+            }
+            else {
+                results.push({ name: 'Bearer Token', status: 'error', message: 'JMAP_BEARER_TOKEN not set' });
+            }
+        }
+        else if (authMethod === 'oidc') {
+            const hasIssuer = !!process.env.JMAP_OIDC_ISSUER;
+            const hasClient = !!process.env.JMAP_OIDC_CLIENT_ID;
+            if (hasIssuer && hasClient) {
+                results.push({ name: 'OIDC Config', status: 'ok', message: `Issuer: ${process.env.JMAP_OIDC_ISSUER}` });
+            }
+            else {
+                results.push({
+                    name: 'OIDC Config',
+                    status: 'error',
+                    message: `Missing: ${!hasIssuer ? 'JMAP_OIDC_ISSUER' : ''} ${!hasClient ? 'JMAP_OIDC_CLIENT_ID' : ''}`.trim(),
+                });
+            }
+        }
+    }
+    else {
+        results.push({ name: 'Auth Method', status: 'error', message: 'JMAP_AUTH_METHOD not set' });
+    }
+    return results;
+}
+/**
+ * Test JMAP connection.
+ */
+async function checkConnection() {
+    try {
+        const config = loadConfig();
+        const logger = createLogger('error');
+        const client = new JMAPClient(config, logger);
+        const session = await client.fetchSession();
+        return {
+            name: 'Connection',
+            status: 'ok',
+            message: `Connected (Account: ${session.accountId})`,
+        };
+    }
+    catch (error) {
+        return {
+            name: 'Connection',
+            status: 'error',
+            message: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Run configuration and connection checks.
+ */
+export async function runCheck() {
+    console.log('\n=== MCP Twake Mail - Configuration Check ===\n');
+    // Check environment variables
+    console.log('Environment Configuration:');
+    const envResults = checkEnvironment();
+    for (const result of envResults) {
+        console.log(`  ${formatResult(result)}`);
+    }
+    // Check for configuration errors
+    const hasEnvError = envResults.some((r) => r.status === 'error');
+    if (hasEnvError) {
+        console.log('\nConfiguration incomplete. Run `mcp-twake-mail setup` to configure.\n');
+        process.exit(1);
+    }
+    // Test connection
+    console.log('\nConnection Test:');
+    const connResult = await checkConnection();
+    console.log(`  ${formatResult(connResult)}`);
+    if (connResult.status === 'error') {
+        console.log('\nConnection failed. Check your configuration and network.\n');
+        process.exit(1);
+    }
+    console.log('\nAll checks passed! mcp-twake-mail is ready to use.\n');
+}
+//# sourceMappingURL=check.js.map

package/build/cli/commands/check.js.map

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

package/build/cli/commands/setup.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Run the interactive setup wizard.
+ */
+export declare function runSetup(): Promise<void>;

package/build/cli/commands/setup.js

@@ -0,0 +1,172 @@
+/**
+ * Setup wizard command - interactive configuration for mcp-twake-mail.
+ * Generates Claude Desktop config JSON.
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { promptJmapUrl, promptAuthMethod, promptBasicAuth, promptBearerToken, promptOidcAuth, promptWriteConfig, promptServerName, } from '../prompts/setup-wizard.js';
+/**
+ * Get Claude Desktop config file path based on platform.
+ */
+function getClaudeConfigPath() {
+    const home = homedir();
+    if (process.platform === 'darwin') {
+        return join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+    }
+    else if (process.platform === 'win32') {
+        return join(process.env.APPDATA || join(home, 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json');
+    }
+    // Linux fallback (unofficial)
+    return join(home, '.config', 'claude', 'claude_desktop_config.json');
+}
+/**
+ * Generate Claude Desktop config for this MCP server.
+ */
+function generateClaudeConfig(serverName, env) {
+    return {
+        mcpServers: {
+            [serverName]: {
+                command: 'npx',
+                args: ['-y', 'mcp-twake-mail'],
+                env,
+            },
+        },
+    };
+}
+/**
+ * Test JMAP connection with provided config.
+ * Returns true if connection successful, false otherwise.
+ */
+async function testConnection(env) {
+    // Dynamically import to avoid loading JMAP client in CLI context unnecessarily
+    try {
+        const { JMAPClient } = await import('../../jmap/client.js');
+        const { createLogger } = await import('../../config/logger.js');
+        // Build minimal config object for JMAPClient
+        const config = {
+            JMAP_SESSION_URL: env.JMAP_SESSION_URL,
+            JMAP_AUTH_METHOD: env.JMAP_AUTH_METHOD,
+            JMAP_USERNAME: env.JMAP_USERNAME,
+            JMAP_PASSWORD: env.JMAP_PASSWORD,
+            JMAP_TOKEN: env.JMAP_BEARER_TOKEN,
+            JMAP_OIDC_ISSUER: env.JMAP_OIDC_ISSUER,
+            JMAP_OIDC_CLIENT_ID: env.JMAP_OIDC_CLIENT_ID,
+            JMAP_OIDC_SCOPE: env.JMAP_OIDC_SCOPE || 'openid profile email offline_access',
+            JMAP_OIDC_REDIRECT_URI: env.JMAP_OIDC_REDIRECT_URI || 'http://localhost:3000/callback',
+            JMAP_REQUEST_TIMEOUT: 30000,
+            LOG_LEVEL: 'error',
+        };
+        const logger = createLogger('error');
+        const client = new JMAPClient(config, logger);
+        // For OIDC, we need to run the auth flow first
+        if (config.JMAP_AUTH_METHOD === 'oidc') {
+            const { performOIDCFlow } = await import('../../auth/oidc-flow.js');
+            console.log('\nOpening browser for authentication...');
+            await performOIDCFlow({
+                issuerUrl: config.JMAP_OIDC_ISSUER,
+                clientId: config.JMAP_OIDC_CLIENT_ID,
+                scope: config.JMAP_OIDC_SCOPE,
+                redirectUri: config.JMAP_OIDC_REDIRECT_URI,
+            });
+            console.log('Authentication successful!\n');
+        }
+        const session = await client.fetchSession();
+        console.log(`Connected! Account ID: ${session.accountId}`);
+        return { success: true };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Run the interactive setup wizard.
+ */
+export async function runSetup() {
+    console.log('\n=== MCP Twake Mail Setup Wizard ===\n');
+    // Step 1: JMAP URL
+    const jmapUrl = await promptJmapUrl();
+    // Step 2: Auth method
+    const authMethod = await promptAuthMethod();
+    // Step 3: Auth-specific prompts
+    const env = {
+        JMAP_SESSION_URL: jmapUrl,
+        JMAP_AUTH_METHOD: authMethod,
+    };
+    if (authMethod === 'basic') {
+        const { username, password } = await promptBasicAuth();
+        env.JMAP_USERNAME = username;
+        env.JMAP_PASSWORD = password;
+    }
+    else if (authMethod === 'bearer') {
+        env.JMAP_BEARER_TOKEN = await promptBearerToken();
+    }
+    else if (authMethod === 'oidc') {
+        const { issuer, clientId, scope, redirectUri } = await promptOidcAuth();
+        env.JMAP_OIDC_ISSUER = issuer;
+        env.JMAP_OIDC_CLIENT_ID = clientId;
+        env.JMAP_OIDC_SCOPE = scope;
+        env.JMAP_OIDC_REDIRECT_URI = redirectUri;
+    }
+    // Step 4: Test connection
+    console.log('\nTesting connection...');
+    const testResult = await testConnection(env);
+    if (!testResult.success) {
+        console.error(`\nConnection failed: ${testResult.error}`);
+        console.error('Please check your configuration and try again.\n');
+        process.exit(1);
+    }
+    console.log('\nConnection successful!\n');
+    // Step 5: Server name for Claude config
+    const serverName = await promptServerName();
+    // Step 6: Generate config
+    const config = generateClaudeConfig(serverName, env);
+    const configJson = JSON.stringify(config, null, 2);
+    console.log('\n--- Generated Claude Desktop Config ---');
+    console.log(configJson);
+    console.log('---------------------------------------\n');
+    // Step 7: Optionally write to Claude Desktop config
+    const shouldWrite = await promptWriteConfig();
+    if (shouldWrite) {
+        const configPath = getClaudeConfigPath();
+        console.log(`\nWriting to: ${configPath}`);
+        try {
+            // Read existing config if it exists
+            let existingConfig = {};
+            try {
+                const existingContent = await readFile(configPath, 'utf-8');
+                existingConfig = JSON.parse(existingContent);
+            }
+            catch {
+                // File doesn't exist or is invalid, start fresh
+            }
+            // Merge mcpServers
+            const mergedConfig = {
+                ...existingConfig,
+                mcpServers: {
+                    ...(existingConfig.mcpServers || {}),
+                    ...config.mcpServers,
+                },
+            };
+            // Ensure directory exists
+            await mkdir(join(configPath, '..'), { recursive: true });
+            // Write merged config
+            await writeFile(configPath, JSON.stringify(mergedConfig, null, 2), 'utf-8');
+            console.log('Config written successfully!');
+            console.log('\nRestart Claude Desktop to load the new configuration.\n');
+        }
+        catch (error) {
+            console.error(`Failed to write config: ${error instanceof Error ? error.message : String(error)}`);
+            console.error('\nYou can manually add the config above to your Claude Desktop configuration.\n');
+            process.exit(1);
+        }
+    }
+    else {
+        console.log('\nTo use this configuration, add it to your Claude Desktop config file:');
+        console.log(`  ${getClaudeConfigPath()}\n`);
+    }
+}
+//# sourceMappingURL=setup.js.map

package/build/cli/commands/setup.js.map

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

package/build/cli/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * CLI entry point using Commander.js.
+ * Routes between MCP server (default) and interactive commands.
+ */
+import { Command } from 'commander';
+/**
+ * Create and configure the CLI program.
+ * @returns Configured Commander program
+ */
+export declare function createCLI(): Command;
+/**
+ * Run the CLI program.
+ * Uses parseAsync for proper async action handling.
+ */
+export declare function runCLI(): Promise<void>;