@robinmordasiewicz/f5xc-api-mcp 3.0.0 → 3.0.2

package/dist/cli/setup.js

@@ -0,0 +1,347 @@
+/**
+ * Interactive CLI setup wizard for F5XC API MCP credentials
+ *
+ * Features:
+ * - Auto-detection of existing environment variables
+ * - Interactive profile creation with validation
+ * - Profile management (list, delete, set default)
+ */
+import * as readline from "readline";
+import { ConfigManager } from "../config/index.js";
+import { AUTH_ENV_VARS } from "../auth/credential-manager.js";
+import { logger } from "../utils/logging.js";
+/**
+ * Detect existing environment variables
+ */
+function detectEnvironmentCredentials() {
+    const apiUrl = process.env[AUTH_ENV_VARS.API_URL];
+    const apiToken = process.env[AUTH_ENV_VARS.API_TOKEN];
+    const p12File = process.env[AUTH_ENV_VARS.P12_FILE];
+    const p12Password = process.env[AUTH_ENV_VARS.P12_PASSWORD];
+    return {
+        hasCredentials: Boolean(apiUrl && (apiToken || p12File)),
+        apiUrl,
+        apiToken,
+        p12File,
+        p12Password,
+    };
+}
+/**
+ * Create a readline interface for user input
+ */
+function createReadlineInterface() {
+    return readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+}
+/**
+ * Prompt user with a question
+ */
+async function prompt(rl, question) {
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            resolve(answer.trim());
+        });
+    });
+}
+/**
+ * Validate profile name format
+ */
+function validateProfileName(name) {
+    if (!name) {
+        return { valid: false, error: "Profile name cannot be empty" };
+    }
+    if (!/^[a-z0-9_-]+$/i.test(name)) {
+        return {
+            valid: false,
+            error: "Profile name must contain only alphanumeric characters, hyphens, and underscores",
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Create a profile from detected environment variables
+ */
+async function createProfileFromEnv(rl, configManager, envCreds) {
+    console.log();
+    // Get profile name
+    let profileName = "";
+    while (!profileName) {
+        const answer = await prompt(rl, "Profile name [production]: ");
+        profileName = answer || "production";
+        const validation = validateProfileName(profileName);
+        if (!validation.valid) {
+            console.log(`❌ ${validation.error}`);
+            profileName = "";
+        }
+    }
+    // Get optional description
+    const description = await prompt(rl, "Description [Environment credentials]: ");
+    // Create profile
+    const profile = {
+        apiUrl: envCreds.apiUrl,
+        apiToken: envCreds.apiToken,
+        p12File: envCreds.p12File,
+        p12Password: envCreds.p12Password,
+        metadata: {
+            description: description || "Environment credentials",
+            createdAt: new Date().toISOString(),
+            lastModifiedAt: new Date().toISOString(),
+        },
+    };
+    await configManager.setProfile(profileName, profile);
+    console.log(`\n✅ Profile "${profileName}" created from environment variables!\n`);
+    // Ask if user wants to set as default
+    const setDefault = await prompt(rl, "Set as default profile? (Y/n): ");
+    if (setDefault.toLowerCase() !== "n") {
+        await configManager.setDefaultProfile(profileName);
+        console.log(`✅ "${profileName}" set as default profile\n`);
+    }
+    console.log("Next steps:");
+    console.log("  • Run 'f5xc-api-mcp' to start with this profile");
+    console.log("  • Or use 'F5XC_PROFILE=staging f5xc-api-mcp' for other profiles");
+    console.log("  • Environment variables still override profile settings\n");
+}
+/**
+ * Create a profile manually
+ */
+async function addProfile(rl, configManager) {
+    console.log("\nLet's create a new profile.\n");
+    // Get profile name
+    let profileName = "";
+    while (!profileName) {
+        const answer = await prompt(rl, "Profile name: ");
+        profileName = answer;
+        if (!profileName) {
+            console.log("❌ Profile name cannot be empty");
+        }
+        else {
+            const validation = validateProfileName(profileName);
+            if (!validation.valid) {
+                console.log(`❌ ${validation.error}`);
+                profileName = "";
+            }
+        }
+    }
+    // Get description
+    const description = await prompt(rl, "Description (optional): ");
+    // Get API URL
+    let apiUrl = "";
+    while (!apiUrl) {
+        const answer = await prompt(rl, "F5XC API URL: ");
+        apiUrl = answer;
+        if (!apiUrl) {
+            console.log("❌ API URL cannot be empty");
+        }
+        else if (!apiUrl.startsWith("http://") && !apiUrl.startsWith("https://")) {
+            console.log("❌ API URL must start with http:// or https://");
+            apiUrl = "";
+        }
+    }
+    // Get authentication method
+    console.log("\nAuthentication method:");
+    console.log("  1) API Token");
+    console.log("  2) P12 Certificate");
+    let authMethod = "";
+    while (authMethod !== "1" && authMethod !== "2") {
+        authMethod = await prompt(rl, "Select (1-2) [1]: ");
+        authMethod = authMethod || "1";
+        if (authMethod !== "1" && authMethod !== "2") {
+            console.log("❌ Please select 1 or 2");
+            authMethod = "";
+        }
+    }
+    let apiToken;
+    let p12File;
+    let p12Password;
+    if (authMethod === "1") {
+        // Token authentication
+        apiToken = await prompt(rl, "API Token: ");
+        if (!apiToken) {
+            console.log("❌ API Token cannot be empty");
+            return;
+        }
+    }
+    else {
+        // Certificate authentication
+        p12File = await prompt(rl, "Path to P12 certificate file: ");
+        if (!p12File) {
+            console.log("❌ P12 file path cannot be empty");
+            return;
+        }
+        p12Password = await prompt(rl, "P12 certificate password (optional): ");
+    }
+    // Create profile
+    const profile = {
+        apiUrl,
+        apiToken,
+        p12File,
+        p12Password: p12Password || undefined,
+        metadata: {
+            description: description || undefined,
+            createdAt: new Date().toISOString(),
+            lastModifiedAt: new Date().toISOString(),
+        },
+    };
+    await configManager.setProfile(profileName, profile);
+    console.log(`\n✅ Profile "${profileName}" created successfully!\n`);
+    // Ask if user wants to set as default
+    const setDefault = await prompt(rl, "Set as default profile? (Y/n): ");
+    if (setDefault.toLowerCase() !== "n") {
+        await configManager.setDefaultProfile(profileName);
+        console.log(`✅ "${profileName}" set as default profile\n`);
+    }
+}
+/**
+ * Run the interactive setup wizard
+ */
+export async function runSetupWizard() {
+    const rl = createReadlineInterface();
+    const configManager = new ConfigManager();
+    try {
+        console.log("\n🔧 F5XC API MCP Server - Credential Setup\n");
+        // Check for existing environment variables
+        const envCreds = detectEnvironmentCredentials();
+        if (envCreds.hasCredentials) {
+            console.log("✅ Detected existing environment variables:");
+            if (envCreds.apiUrl) {
+                console.log(`   F5XC_API_URL: ${envCreds.apiUrl}`);
+            }
+            if (envCreds.apiToken) {
+                console.log(`   F5XC_API_TOKEN: ***${envCreds.apiToken.slice(-4)}`);
+            }
+            if (envCreds.p12File) {
+                console.log(`   F5XC_P12_FILE: ${envCreds.p12File}`);
+            }
+            console.log();
+            const useEnv = await prompt(rl, "Create profile from environment variables? (Y/n): ");
+            if (useEnv.toLowerCase() !== "n") {
+                await createProfileFromEnv(rl, configManager, envCreds);
+                return;
+            }
+        }
+        // Manual profile creation
+        await addProfile(rl, configManager);
+    }
+    catch (error) {
+        logger.error("Setup wizard error", {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        process.exit(1);
+    }
+    finally {
+        rl.close();
+    }
+}
+/**
+ * List all configured profiles
+ */
+export async function listProfiles() {
+    const configManager = new ConfigManager();
+    try {
+        const profiles = await configManager.listProfiles();
+        const defaultProfile = await configManager.getDefaultProfile();
+        if (profiles.length === 0) {
+            console.log("No profiles configured. Run 'f5xc-api-mcp --setup' to create one.\n");
+            return;
+        }
+        console.log("Configured profiles:\n");
+        for (const profile of profiles) {
+            const creds = await configManager.getProfile(profile);
+            const isDefault = profile === defaultProfile ? " (default)" : "";
+            console.log(`  • ${profile}${isDefault}`);
+            if (creds?.metadata?.description) {
+                console.log(`    ${creds.metadata.description}`);
+            }
+            if (creds?.apiUrl) {
+                console.log(`    URL: ${creds.apiUrl}`);
+            }
+            console.log();
+        }
+    }
+    catch (error) {
+        logger.error("Failed to list profiles", {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        process.exit(1);
+    }
+}
+/**
+ * Delete a profile
+ */
+export async function deleteProfile(name) {
+    const configManager = new ConfigManager();
+    try {
+        await configManager.deleteProfile(name);
+        console.log(`✅ Profile "${name}" deleted.\n`);
+    }
+    catch (error) {
+        console.log(`❌ ${error instanceof Error ? error.message : String(error)}\n`);
+        process.exit(1);
+    }
+}
+/**
+ * Set default profile
+ */
+export async function setDefaultProfile(name) {
+    const configManager = new ConfigManager();
+    try {
+        await configManager.setDefaultProfile(name);
+        console.log(`✅ Default profile set to "${name}".\n`);
+    }
+    catch (error) {
+        console.log(`❌ ${error instanceof Error ? error.message : String(error)}\n`);
+        process.exit(1);
+    }
+}
+/**
+ * Show current configuration
+ */
+export async function showConfig() {
+    const configManager = new ConfigManager();
+    try {
+        const config = await configManager.getConfig();
+        console.log("\nConfiguration:\n");
+        console.log(JSON.stringify(config, null, 2));
+        console.log();
+    }
+    catch (error) {
+        logger.error("Failed to read configuration", {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        process.exit(1);
+    }
+}
+/**
+ * Test connection with a specific profile
+ */
+export async function testProfile(name) {
+    const configManager = new ConfigManager();
+    try {
+        const profile = await configManager.getProfile(name);
+        if (!profile) {
+            console.log(`❌ Profile "${name}" not found.\n`);
+            process.exit(1);
+        }
+        console.log(`\nTesting profile "${name}"...\n`);
+        if (!profile.apiUrl) {
+            console.log("❌ No API URL configured for this profile.\n");
+            process.exit(1);
+        }
+        if (!profile.apiToken && !profile.p12File) {
+            console.log("❌ No authentication configured for this profile.\n");
+            process.exit(1);
+        }
+        // TODO: Implement actual connection test
+        console.log("✅ Profile configuration is valid.\n");
+        console.log("Note: Full connection testing not yet implemented.\n");
+    }
+    catch (error) {
+        logger.error("Failed to test profile", {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/cli/setup.js.map

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

package/dist/config/config-manager.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Configuration Manager for F5XC API MCP
+ * Handles reading/writing configuration files with proper permissions and atomic operations
+ */
+import { ConfigFile, ProfileCredentials } from "./types.js";
+/**
+ * Manages F5XC API MCP configuration files
+ */
+export declare class ConfigManager {
+    private configDir;
+    private configFile;
+    constructor(configDir?: string, configFile?: string);
+    /**
+     * Check if configuration file exists
+     */
+    exists(): Promise<boolean>;
+    /**
+     * Ensure configuration directory exists with proper permissions
+     */
+    private ensureConfigDir;
+    /**
+     * Check and fix file permissions
+     */
+    private checkAndFixPermissions;
+    /**
+     * Read configuration file (async)
+     */
+    read(): Promise<ConfigFile>;
+    /**
+     * Read configuration file synchronously (for initialization)
+     * Note: This is used during CredentialManager construction
+     */
+    readSync(): ConfigFile;
+    /**
+     * Write configuration file with atomic operation
+     * Uses temp file + rename pattern to ensure consistency
+     */
+    write(config: ConfigFile): Promise<void>;
+    /**
+     * Get list of all profile names
+     */
+    listProfiles(): Promise<string[]>;
+    /**
+     * Get a specific profile by name
+     */
+    getProfile(name: string): Promise<ProfileCredentials | null>;
+    /**
+     * Create or update a profile
+     */
+    setProfile(name: string, credentials: ProfileCredentials): Promise<void>;
+    /**
+     * Delete a profile by name
+     */
+    deleteProfile(name: string): Promise<void>;
+    /**
+     * Get the default profile name
+     */
+    getDefaultProfile(): Promise<string | null>;
+    /**
+     * Set the default profile
+     */
+    setDefaultProfile(name: string): Promise<void>;
+    /**
+     * Update the lastUsedAt timestamp for a profile
+     */
+    touchProfile(name: string): Promise<void>;
+    /**
+     * Get the full configuration file
+     */
+    getConfig(): Promise<ConfigFile>;
+}
+//# sourceMappingURL=config-manager.d.ts.map

package/dist/config/config-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../../src/config/config-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EACL,UAAU,EACV,kBAAkB,EAMnB,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;gBAEf,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAKnD;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAShC;;OAEG;YACW,eAAe;IAY7B;;OAEG;YACW,sBAAsB;IAsBpC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IAiBjC;;;OAGG;IACH,QAAQ,IAAI,UAAU;IAiCtB;;;OAGG;IACG,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IA+B9C;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKvC;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAKlE;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB9E;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBhD;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKjD;;OAEG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpD;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB/C;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC;CAGvC"}

package/dist/config/config-manager.js

@@ -0,0 +1,240 @@
+/**
+ * Configuration Manager for F5XC API MCP
+ * Handles reading/writing configuration files with proper permissions and atomic operations
+ */
+import * as fs from "fs/promises";
+import * as fsSync from "fs";
+import { DEFAULT_CONFIG, CONFIG_DIR_PERMISSIONS, CONFIG_FILE_PERMISSIONS, getConfigDirPath, getConfigFilePath, } from "./types.js";
+import { validateConfigFile, safeValidateConfigFile } from "./schema.js";
+/**
+ * Manages F5XC API MCP configuration files
+ */
+export class ConfigManager {
+    configDir;
+    configFile;
+    constructor(configDir, configFile) {
+        this.configDir = configDir || getConfigDirPath();
+        this.configFile = configFile || getConfigFilePath();
+    }
+    /**
+     * Check if configuration file exists
+     */
+    async exists() {
+        try {
+            await fs.access(this.configFile);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Ensure configuration directory exists with proper permissions
+     */
+    async ensureConfigDir() {
+        try {
+            await fs.mkdir(this.configDir, { recursive: true, mode: CONFIG_DIR_PERMISSIONS });
+            // Fix permissions if directory already exists
+            await fs.chmod(this.configDir, CONFIG_DIR_PERMISSIONS);
+        }
+        catch (error) {
+            throw new Error(`Failed to create config directory: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    /**
+     * Check and fix file permissions
+     */
+    async checkAndFixPermissions(filePath, expectedPermissions) {
+        try {
+            const stats = await fs.stat(filePath);
+            const currentMode = stats.mode & 0o777;
+            if (currentMode !== expectedPermissions) {
+                console.warn(`Warning: Config file has insecure permissions (${currentMode.toString(8)}). Fixing to ${expectedPermissions.toString(8)}...`);
+                await fs.chmod(filePath, expectedPermissions);
+            }
+        }
+        catch (error) {
+            const err = error;
+            if (err.code !== "ENOENT") {
+                throw error;
+            }
+        }
+    }
+    /**
+     * Read configuration file (async)
+     */
+    async read() {
+        try {
+            await this.checkAndFixPermissions(this.configFile, CONFIG_FILE_PERMISSIONS);
+            const content = await fs.readFile(this.configFile, "utf-8");
+            const data = JSON.parse(content);
+            return validateConfigFile(data);
+        }
+        catch (error) {
+            const err = error;
+            if (err.code === "ENOENT") {
+                return DEFAULT_CONFIG;
+            }
+            throw new Error(`Failed to read config file: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    /**
+     * Read configuration file synchronously (for initialization)
+     * Note: This is used during CredentialManager construction
+     */
+    readSync() {
+        try {
+            if (!fsSync.existsSync(this.configFile)) {
+                return DEFAULT_CONFIG;
+            }
+            // Check permissions
+            const stats = fsSync.statSync(this.configFile);
+            const currentMode = stats.mode & 0o777;
+            if (currentMode !== CONFIG_FILE_PERMISSIONS) {
+                console.warn(`Warning: Config file has insecure permissions (${currentMode.toString(8)}). Run 'f5xc-api-mcp --setup' to fix.`);
+            }
+            const content = fsSync.readFileSync(this.configFile, "utf-8");
+            const data = JSON.parse(content);
+            const result = safeValidateConfigFile(data);
+            if (!result.success) {
+                console.warn(`Warning: Invalid config file: ${result.error}`);
+                return DEFAULT_CONFIG;
+            }
+            return result.data;
+        }
+        catch (error) {
+            console.warn(`Warning: Failed to read config file: ${error instanceof Error ? error.message : "Unknown error"}`);
+            return DEFAULT_CONFIG;
+        }
+    }
+    /**
+     * Write configuration file with atomic operation
+     * Uses temp file + rename pattern to ensure consistency
+     */
+    async write(config) {
+        await this.ensureConfigDir();
+        const tempFile = `${this.configFile}.tmp.${Date.now()}`;
+        try {
+            // Validate before writing
+            validateConfigFile(config);
+            // Write to temporary file
+            const content = JSON.stringify(config, null, 2);
+            await fs.writeFile(tempFile, content, { mode: CONFIG_FILE_PERMISSIONS });
+            // Atomic rename
+            await fs.rename(tempFile, this.configFile);
+            // Verify permissions
+            await this.checkAndFixPermissions(this.configFile, CONFIG_FILE_PERMISSIONS);
+        }
+        catch (error) {
+            // Clean up temp file on error
+            try {
+                await fs.unlink(tempFile);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            throw new Error(`Failed to write config file: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    /**
+     * Get list of all profile names
+     */
+    async listProfiles() {
+        const config = await this.read();
+        return Object.keys(config.profiles);
+    }
+    /**
+     * Get a specific profile by name
+     */
+    async getProfile(name) {
+        const config = await this.read();
+        return config.profiles[name] || null;
+    }
+    /**
+     * Create or update a profile
+     */
+    async setProfile(name, credentials) {
+        const config = await this.read();
+        // Validate profile name
+        if (!/^[a-z0-9_-]+$/i.test(name)) {
+            throw new Error("Profile name must contain only alphanumeric characters, hyphens, and underscores");
+        }
+        // Set metadata if not provided
+        if (!credentials.metadata) {
+            credentials.metadata = {
+                createdAt: new Date().toISOString(),
+                lastModifiedAt: new Date().toISOString(),
+            };
+        }
+        else {
+            credentials.metadata.lastModifiedAt = new Date().toISOString();
+        }
+        config.profiles[name] = credentials;
+        config.metadata = { lastModifiedAt: new Date().toISOString() };
+        await this.write(config);
+    }
+    /**
+     * Delete a profile by name
+     */
+    async deleteProfile(name) {
+        const config = await this.read();
+        if (!config.profiles[name]) {
+            throw new Error(`Profile "${name}" does not exist`);
+        }
+        delete config.profiles[name];
+        // Clear default profile if it was deleted
+        if (config.defaultProfile === name) {
+            config.defaultProfile = undefined;
+        }
+        config.metadata = { lastModifiedAt: new Date().toISOString() };
+        await this.write(config);
+    }
+    /**
+     * Get the default profile name
+     */
+    async getDefaultProfile() {
+        const config = await this.read();
+        return config.defaultProfile || null;
+    }
+    /**
+     * Set the default profile
+     */
+    async setDefaultProfile(name) {
+        const config = await this.read();
+        if (!config.profiles[name]) {
+            throw new Error(`Profile "${name}" does not exist`);
+        }
+        config.defaultProfile = name;
+        config.metadata = { lastModifiedAt: new Date().toISOString() };
+        await this.write(config);
+    }
+    /**
+     * Update the lastUsedAt timestamp for a profile
+     */
+    async touchProfile(name) {
+        const config = await this.read();
+        const profile = config.profiles[name];
+        if (!profile) {
+            return; // Silently ignore if profile doesn't exist
+        }
+        if (!profile.metadata) {
+            profile.metadata = {
+                createdAt: new Date().toISOString(),
+                lastModifiedAt: new Date().toISOString(),
+                lastUsedAt: new Date().toISOString(),
+            };
+        }
+        else {
+            profile.metadata.lastUsedAt = new Date().toISOString();
+        }
+        config.metadata = { lastModifiedAt: new Date().toISOString() };
+        await this.write(config);
+    }
+    /**
+     * Get the full configuration file
+     */
+    async getConfig() {
+        return this.read();
+    }
+}
+//# sourceMappingURL=config-manager.js.map