mcp-wordpress 2.4.2 → 2.5.1

package/dist/src/config/ServerConfiguration.js

@@ -0,0 +1,255 @@
+import dotenv from "dotenv";
+import * as fs from "fs";
+import * as path from "path";
+import { fileURLToPath } from "url";
+import { WordPressClient } from "../client/api.js";
+import { CachedWordPressClient } from "../client/CachedWordPressClient.js";
+import { MockWordPressClient } from "../client/MockWordPressClient.js";
+import { getErrorMessage } from "../utils/error.js";
+import { LoggerFactory } from "../utils/logger.js";
+import { ConfigHelpers } from "./Config.js";
+import { ConfigurationValidator, } from "./ConfigurationSchema.js";
+/**
+ * Configuration loader for MCP WordPress Server
+ * Handles both single-site (environment variables) and multi-site (JSON config) modes
+ */
+export class ServerConfiguration {
+    static instance;
+    logger = LoggerFactory.server();
+    rootDir;
+    envPath;
+    constructor() {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = path.dirname(__filename);
+        this.rootDir = path.resolve(__dirname, "../..");
+        this.envPath = path.resolve(this.rootDir, ".env");
+        // Load environment variables (completely silent for MCP compatibility)
+        // Suppress dotenv output that could interfere with JSON-RPC communication
+        // eslint-disable-next-line no-console
+        const originalConsoleLog = console.log;
+        // eslint-disable-next-line no-console
+        const originalConsoleError = console.error;
+        try {
+            // eslint-disable-next-line no-console
+            console.log = () => { };
+            // eslint-disable-next-line no-console
+            console.error = () => { };
+            dotenv.config({
+                path: this.envPath,
+                debug: false,
+                override: false
+            });
+        }
+        finally {
+            // eslint-disable-next-line no-console
+            console.log = originalConsoleLog;
+            // eslint-disable-next-line no-console
+            console.error = originalConsoleError;
+        }
+        // Debug output for DXT troubleshooting (reduced in DXT mode)
+        if (ConfigHelpers.shouldDebug()) {
+            this.logger.debug("ServerConfiguration initialized", {
+                rootDir: this.rootDir,
+                envPath: this.envPath,
+                envFileExists: fs.existsSync(this.envPath),
+            });
+        }
+    }
+    /**
+     * Get singleton instance of ServerConfiguration
+     */
+    static getInstance() {
+        if (!ServerConfiguration.instance) {
+            ServerConfiguration.instance = new ServerConfiguration();
+        }
+        return ServerConfiguration.instance;
+    }
+    /**
+     * Load WordPress client configurations
+     * Returns a Map of site ID to WordPressClient instances
+     */
+    loadClientConfigurations(mcpConfig) {
+        const configPath = path.resolve(this.rootDir, "mcp-wordpress.config.json");
+        if (fs.existsSync(configPath)) {
+            if (ConfigHelpers.shouldLogInfo()) {
+                this.logger.info("Found multi-site configuration file", { configPath });
+            }
+            return this.loadMultiSiteConfig(configPath);
+        }
+        else {
+            if (ConfigHelpers.shouldLogInfo()) {
+                this.logger.info("Multi-site config not found, using environment variables for single-site mode", {
+                    configPath,
+                });
+            }
+            return this.loadSingleSiteFromEnv(mcpConfig);
+        }
+    }
+    /**
+     * Load multi-site configuration from JSON file
+     */
+    loadMultiSiteConfig(configPath) {
+        try {
+            const configFile = fs.readFileSync(configPath, "utf-8");
+            const rawConfig = JSON.parse(configFile);
+            // Validate configuration using Zod schema
+            const config = ConfigurationValidator.validateMultiSiteConfig(rawConfig);
+            const clients = new Map();
+            const validConfigs = [];
+            for (const site of config.sites) {
+                const clientConfig = {
+                    baseUrl: site.config.WORDPRESS_SITE_URL,
+                    auth: {
+                        method: site.config.WORDPRESS_AUTH_METHOD || "app-password",
+                        username: site.config.WORDPRESS_USERNAME,
+                        appPassword: site.config.WORDPRESS_APP_PASSWORD,
+                    },
+                };
+                // Use cached client for better performance
+                const client = ConfigHelpers.shouldUseCache()
+                    ? new CachedWordPressClient(clientConfig, site.id)
+                    : new WordPressClient(clientConfig);
+                clients.set(site.id, client);
+                validConfigs.push(site);
+                if (ConfigHelpers.shouldLogInfo()) {
+                    this.logger.info("Initialized site client", {
+                        siteName: site.name,
+                        siteId: site.id,
+                        authMethod: site.config.WORDPRESS_AUTH_METHOD,
+                    });
+                }
+            }
+            return { clients, configs: validConfigs };
+        }
+        catch (error) {
+            this.logger.fatal("Failed to load multi-site configuration", {
+                configPath,
+                error: getErrorMessage(error),
+            });
+            process.exit(1);
+        }
+    }
+    /**
+     * Check if we're in CI environment
+     */
+    isCIEnvironment() {
+        return ConfigHelpers.isCI();
+    }
+    /**
+     * Create mock configuration for CI environments
+     */
+    createMockConfiguration() {
+        const mockConfig = {
+            WORDPRESS_SITE_URL: "https://demo.wordpress.com",
+            WORDPRESS_USERNAME: "ci-user",
+            WORDPRESS_APP_PASSWORD: "ci-mock-password",
+            WORDPRESS_AUTH_METHOD: "app-password",
+        };
+        const clientConfig = {
+            baseUrl: mockConfig.WORDPRESS_SITE_URL,
+            auth: {
+                method: mockConfig.WORDPRESS_AUTH_METHOD,
+                username: mockConfig.WORDPRESS_USERNAME,
+                appPassword: mockConfig.WORDPRESS_APP_PASSWORD,
+            },
+        };
+        // Create mock client that won't actually connect to WordPress
+        const client = new MockWordPressClient(clientConfig);
+        const clients = new Map();
+        clients.set("default", client);
+        const siteConfig = {
+            id: "default",
+            name: "Demo Site (CI Mode)",
+            config: mockConfig,
+        };
+        this.logger.info("Using mock configuration for CI environment");
+        return { clients, configs: [siteConfig] };
+    }
+    /**
+     * Load single-site configuration from environment variables
+     */
+    loadSingleSiteFromEnv(mcpConfig) {
+        try {
+            // Debug output for DXT troubleshooting (reduced in DXT mode)
+            const isDXTMode = process.env.NODE_ENV === "dxt";
+            if (!isDXTMode && ConfigHelpers.shouldDebug()) {
+                this.logger.debug("Loading single-site configuration from environment", {
+                    mcpConfigProvided: Boolean(mcpConfig),
+                    siteUrl: process.env.WORDPRESS_SITE_URL || "NOT SET",
+                    username: process.env.WORDPRESS_USERNAME || "NOT SET",
+                    appPasswordSet: Boolean(process.env.WORDPRESS_APP_PASSWORD),
+                    authMethod: process.env.WORDPRESS_AUTH_METHOD || "NOT SET",
+                });
+            }
+            // Check if we're in CI environment and credentials are missing
+            if (this.isCIEnvironment() && !process.env.WORDPRESS_SITE_URL) {
+                return this.createMockConfiguration();
+            }
+            // Validate MCP config if provided
+            const validatedMcpConfig = mcpConfig ? ConfigurationValidator.validateMcpConfig(mcpConfig) : undefined;
+            // Prepare environment configuration for validation
+            const envConfig = {
+                WORDPRESS_SITE_URL: validatedMcpConfig?.wordpressSiteUrl || process.env.WORDPRESS_SITE_URL,
+                WORDPRESS_USERNAME: validatedMcpConfig?.wordpressUsername || process.env.WORDPRESS_USERNAME,
+                WORDPRESS_APP_PASSWORD: validatedMcpConfig?.wordpressAppPassword || process.env.WORDPRESS_APP_PASSWORD,
+                WORDPRESS_AUTH_METHOD: validatedMcpConfig?.wordpressAuthMethod || process.env.WORDPRESS_AUTH_METHOD || "app-password",
+                NODE_ENV: process.env.NODE_ENV,
+                DEBUG: process.env.DEBUG,
+                DISABLE_CACHE: process.env.DISABLE_CACHE,
+                LOG_LEVEL: process.env.LOG_LEVEL,
+            };
+            if (!isDXTMode && ConfigHelpers.shouldDebug()) {
+                this.logger.debug("Final environment configuration for validation", {
+                    siteUrl: envConfig.WORDPRESS_SITE_URL || "NOT SET",
+                    username: envConfig.WORDPRESS_USERNAME || "NOT SET",
+                    appPasswordSet: Boolean(envConfig.WORDPRESS_APP_PASSWORD),
+                    authMethod: envConfig.WORDPRESS_AUTH_METHOD || "NOT SET",
+                });
+            }
+            // Validate environment configuration using Zod schema
+            const validatedConfig = ConfigurationValidator.validateEnvironmentConfig(envConfig);
+            const clientConfig = {
+                baseUrl: validatedConfig.WORDPRESS_SITE_URL,
+                auth: {
+                    method: validatedConfig.WORDPRESS_AUTH_METHOD,
+                    username: validatedConfig.WORDPRESS_USERNAME,
+                    appPassword: validatedConfig.WORDPRESS_APP_PASSWORD,
+                },
+            };
+            // Use cached client for better performance
+            const client = process.env.DISABLE_CACHE === "true"
+                ? new WordPressClient(clientConfig)
+                : new CachedWordPressClient(clientConfig, "default");
+            const clients = new Map();
+            clients.set("default", client);
+            const siteConfig = {
+                id: "default",
+                name: "Default Site",
+                config: {
+                    WORDPRESS_SITE_URL: validatedConfig.WORDPRESS_SITE_URL,
+                    WORDPRESS_USERNAME: validatedConfig.WORDPRESS_USERNAME,
+                    WORDPRESS_APP_PASSWORD: validatedConfig.WORDPRESS_APP_PASSWORD,
+                    WORDPRESS_AUTH_METHOD: validatedConfig.WORDPRESS_AUTH_METHOD,
+                },
+            };
+            if (!isDXTMode) {
+                this.logger.info("Initialized default site client in single-site mode");
+            }
+            return { clients, configs: [siteConfig] };
+        }
+        catch (error) {
+            this.logger.error("Configuration validation failed for single-site mode", {
+                error: getErrorMessage(error),
+                suggestion: "Please check your environment variables or MCP configuration",
+            });
+            return { clients: new Map(), configs: [] };
+        }
+    }
+    /**
+     * Get root directory path
+     */
+    getRootDir() {
+        return this.rootDir;
+    }
+}
+//# sourceMappingURL=ServerConfiguration.js.map

package/dist/src/config/ServerConfiguration.js.map

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

package/dist/src/docs/DocumentationGenerator.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Comprehensive API Documentation Auto-Generation System
+ * Extracts documentation from tool classes, types, and WordPress mappings
+ */
+export interface DocumentationConfig {
+    outputDir: string;
+    includeExamples: boolean;
+    includeWordPressMapping: boolean;
+    generateOpenAPI: boolean;
+    generateInteractiveHtml: boolean;
+    validateExamples: boolean;
+}
+export interface ToolDocumentation {
+    name: string;
+    category: string;
+    description: string;
+    parameters: ParameterDocumentation[];
+    examples: ExampleUsage[];
+    wordpressEndpoint: string | undefined;
+    requiredPermissions: string[] | undefined;
+    returnType: string;
+    errorCodes: ErrorDocumentation[];
+    relatedTools: string[];
+}
+export interface ParameterDocumentation {
+    name: string;
+    type: string;
+    required: boolean;
+    description: string;
+    defaultValue: unknown;
+    allowedValues: string[] | undefined;
+    examples: string[];
+}
+export interface ExampleUsage {
+    title: string;
+    description: string;
+    command: string;
+    parameters: Record<string, unknown>;
+    expectedResponse: unknown;
+    errorExample?: {
+        scenario: string;
+        error: unknown;
+    };
+}
+export interface ErrorDocumentation {
+    code: string;
+    message: string;
+    description: string;
+    resolution: string;
+}
+export interface DocumentationOutput {
+    tools: ToolDocumentation[];
+    categories: CategoryDocumentation[];
+    types: TypeDocumentation[];
+    openApiSpec: OpenAPISpecification | undefined;
+    summary: DocumentationSummary;
+}
+export interface CategoryDocumentation {
+    name: string;
+    description: string;
+    toolCount: number;
+    tools: string[];
+    usagePatterns: string[];
+}
+export interface TypeDocumentation {
+    name: string;
+    description: string;
+    properties: PropertyDocumentation[];
+    examples: unknown[];
+    wordpressSource?: string;
+}
+export interface PropertyDocumentation {
+    name: string;
+    type: string;
+    required: boolean;
+    description: string;
+    format?: string;
+}
+export interface OpenAPISpecification {
+    openapi: string;
+    info: Record<string, unknown>;
+    paths: Record<string, unknown>;
+    components: Record<string, unknown>;
+}
+export interface DocumentationSummary {
+    totalTools: number;
+    totalCategories: number;
+    totalTypes: number;
+    lastUpdated: string;
+    version: string;
+    coverage: {
+        toolsWithExamples: number;
+        toolsWithWordPressMapping: number;
+        typesDocumented: number;
+    };
+}
+/**
+ * Main Documentation Generator
+ */
+export declare class DocumentationGenerator {
+    private config;
+    private toolCategories;
+    private wordpressEndpoints;
+    private logger;
+    constructor(config?: Partial<DocumentationConfig>);
+    /**
+     * Generate complete documentation for all tools and types
+     */
+    generateFullDocumentation(): Promise<DocumentationOutput>;
+    /**
+     * Extract documentation from all tool classes
+     */
+    private extractAllToolDocumentation;
+    /**
+     * Extract documentation for a single tool
+     */
+    private extractToolDocumentation;
+    /**
+     * Extract parameter documentation
+     */
+    private extractParameterDocumentation;
+    /**
+     * Generate usage examples for tools
+     */
+    private generateToolExamples;
+    /**
+     * Generate basic usage example
+     */
+    private generateBasicExample;
+    /**
+     * Generate multi-site example
+     */
+    private generateMultiSiteExample;
+    /**
+     * Generate advanced example with all parameters
+     */
+    private generateAdvancedExample;
+    /**
+     * Generate category documentation
+     */
+    private generateCategoryDocumentation;
+    /**
+     * Extract type documentation from TypeScript definitions
+     */
+    private extractTypeDocumentation;
+    /**
+     * Generate OpenAPI specification
+     */
+    private generateOpenAPISpecification;
+    /**
+     * Write all documentation files
+     */
+    private writeDocumentationFiles;
+    private extractCategoryFromClassName;
+    private initializeWordPressMapping;
+    private initializeToolCategories;
+    private generateDocumentationSummary;
+    /**
+     * Helper methods for documentation generation
+     */
+    private getDefaultValue;
+    private getAllowedValues;
+    private generateParameterExamples;
+    private supportsMultiSite;
+    private generateExampleValue;
+    private generateExpectedResponse;
+    private getExampleParameters;
+    private getCategoryDescription;
+    private generateUsagePatterns;
+    private generateWordPressPostExample;
+    private generateParameterSchema;
+    private convertTypeToJsonSchema;
+    private inferReturnType;
+    private generateErrorDocumentation;
+    private findRelatedTools;
+    private getRequiredPermissions;
+    /**
+     * File writing implementations
+     */
+    private writeApiOverview;
+    private writeToolDocumentation;
+    private writeCategoryDocumentation;
+    private writeTypeDocumentation;
+}
+//# sourceMappingURL=DocumentationGenerator.d.ts.map

package/dist/src/docs/DocumentationGenerator.d.ts.map

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