mcp-wordpress 2.4.2 → 2.5.1

package/dist/src/server/ToolRegistry.d.ts

@@ -0,0 +1,50 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { WordPressClient } from "../client/api.js";
+/**
+ * Interface for tool definition
+ */
+export interface ToolDefinition {
+    name: string;
+    description?: string;
+    parameters?: Array<{
+        name: string;
+        type?: string;
+        description?: string;
+        required?: boolean;
+    }>;
+    handler: (client: WordPressClient, args: Record<string, unknown>) => Promise<unknown>;
+}
+/**
+ * Registry for managing MCP tools
+ * Handles tool registration, parameter validation, and execution
+ */
+export declare class ToolRegistry {
+    private server;
+    private wordpressClients;
+    constructor(server: McpServer, wordpressClients: Map<string, WordPressClient>);
+    /**
+     * Register all available tools with the MCP server
+     */
+    registerAllTools(): void;
+    /**
+     * Register a single tool with parameter validation and execution handling
+     */
+    private registerTool;
+    /**
+     * Build Zod parameter schema from tool definition
+     */
+    private buildParameterSchema;
+    /**
+     * Get appropriate Zod type for parameter definition
+     */
+    private getZodTypeForParameter;
+    /**
+     * Intelligent site selection based on context
+     */
+    private selectBestSite;
+    /**
+     * Check if error is authentication-related
+     */
+    private isAuthenticationError;
+}
+//# sourceMappingURL=ToolRegistry.d.ts.map

package/dist/src/server/ToolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRegistry.d.ts","sourceRoot":"","sources":["../../../src/server/ToolRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAOnD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,OAAO,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACvF;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,gBAAgB,CAA+B;gBAE3C,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;IAK7E;;OAEG;IACI,gBAAgB,IAAI,IAAI;IAoB/B;;OAEG;IACH,OAAO,CAAC,YAAY;IAyHpB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAyB5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiB9B;;OAEG;IACH,OAAO,CAAC,cAAc;IA2CtB;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAO9B"}

package/dist/src/server/ToolRegistry.js

@@ -0,0 +1,219 @@
+import { getErrorMessage } from "../utils/error.js";
+import { EnhancedError, ErrorHandlers } from "../utils/enhancedError.js";
+import { config } from "../config/Config.js";
+import * as Tools from "../tools/index.js";
+import { z } from "zod";
+/**
+ * Registry for managing MCP tools
+ * Handles tool registration, parameter validation, and execution
+ */
+export class ToolRegistry {
+    server;
+    wordpressClients;
+    constructor(server, wordpressClients) {
+        this.server = server;
+        this.wordpressClients = wordpressClients;
+    }
+    /**
+     * Register all available tools with the MCP server
+     */
+    registerAllTools() {
+        // Register all tools from the tools directory
+        Object.values(Tools).forEach((ToolClass) => {
+            let toolInstance;
+            // Cache and Performance tools need the clients map
+            if (ToolClass.name === "CacheTools" || ToolClass.name === "PerformanceTools") {
+                toolInstance = new ToolClass(this.wordpressClients);
+            }
+            else {
+                toolInstance = new ToolClass();
+            }
+            const tools = toolInstance.getTools();
+            tools.forEach((tool) => {
+                this.registerTool(tool);
+            });
+        });
+    }
+    /**
+     * Register a single tool with parameter validation and execution handling
+     */
+    registerTool(tool) {
+        // Create base parameter schema with site parameter
+        const baseSchema = {
+            site: z
+                .string()
+                .optional()
+                .describe("The ID of the WordPress site to target (from mcp-wordpress.config.json). Required if multiple sites are configured."),
+        };
+        // Merge with tool-specific parameters
+        const parameterSchema = this.buildParameterSchema(tool, baseSchema);
+        // Make site parameter required if multiple sites are configured
+        if (this.wordpressClients.size > 1 &&
+            parameterSchema.site &&
+            typeof parameterSchema.site === "object" &&
+            "describe" in parameterSchema.site) {
+            parameterSchema.site = parameterSchema.site.describe("The ID of the WordPress site to target (from mcp-wordpress.config.json). Required when multiple sites are configured.");
+        }
+        this.server.tool(tool.name, tool.description || `WordPress tool: ${tool.name}`, parameterSchema, async (args) => {
+            try {
+                let siteId = args.site;
+                // If no site specified and multiple sites configured, require site parameter
+                if (!siteId && this.wordpressClients.size > 1) {
+                    const availableSites = Array.from(this.wordpressClients.keys());
+                    const error = ErrorHandlers.siteParameterMissing(availableSites);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: error.toString(),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                // Intelligent site selection for single-site configurations
+                if (!siteId) {
+                    siteId = this.selectBestSite(tool.name, args);
+                }
+                const client = this.wordpressClients.get(siteId);
+                if (!client) {
+                    const availableSites = Array.from(this.wordpressClients.keys());
+                    const error = ErrorHandlers.siteNotFound(siteId, availableSites);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: error.toString(),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                // Call the tool handler with the client and parameters
+                const result = await tool.handler(client, args);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: typeof result === "string" ? result : JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                if (this.isAuthenticationError(error)) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Authentication failed for site '${args.site || "default"}'. Please check your credentials.`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                // Handle enhanced errors with suggestions
+                if (error instanceof EnhancedError) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: error.toString(),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error: ${getErrorMessage(error)}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    /**
+     * Build Zod parameter schema from tool definition
+     */
+    buildParameterSchema(tool, baseSchema) {
+        return (tool.parameters?.reduce((schema, param) => {
+            let zodType = this.getZodTypeForParameter(param);
+            if (param.description) {
+                zodType = zodType.describe(param.description);
+            }
+            if (!param.required) {
+                zodType = zodType.optional();
+            }
+            schema[param.name] = zodType;
+            return schema;
+        }, { ...baseSchema }) || baseSchema);
+    }
+    /**
+     * Get appropriate Zod type for parameter definition
+     */
+    getZodTypeForParameter(param) {
+        switch (param.type) {
+            case "string":
+                return z.string();
+            case "number":
+                return z.number();
+            case "boolean":
+                return z.boolean();
+            case "array":
+                return z.array(z.string());
+            case "object":
+                return z.record(z.unknown());
+            default:
+                return z.string();
+        }
+    }
+    /**
+     * Intelligent site selection based on context
+     */
+    selectBestSite(toolName, args) {
+        const availableSites = Array.from(this.wordpressClients.keys());
+        // Single site scenario - use it directly
+        if (availableSites.length === 1) {
+            return availableSites[0];
+        }
+        // Multiple sites scenario - intelligent selection
+        if (availableSites.length > 1) {
+            // Try to find a site based on context clues
+            // 1. Check if there's a 'default' site
+            if (availableSites.includes("default")) {
+                return "default";
+            }
+            // 2. Check if there's a 'main' or 'primary' site
+            const primarySites = availableSites.filter((site) => ["main", "primary", "prod", "production"].includes(site.toLowerCase()));
+            if (primarySites.length > 0) {
+                return primarySites[0];
+            }
+            // 3. For development/test operations, prefer dev sites
+            if (toolName.includes("test") || config().app.isDevelopment) {
+                const devSites = availableSites.filter((site) => ["dev", "test", "staging", "local"].includes(site.toLowerCase()));
+                if (devSites.length > 0) {
+                    return devSites[0];
+                }
+            }
+            // 4. Default to first available site
+            return availableSites[0];
+        }
+        // Fallback to 'default' if no sites available
+        return "default";
+    }
+    /**
+     * Check if error is authentication-related
+     */
+    isAuthenticationError(error) {
+        const errorObj = error;
+        if (errorObj?.response?.status && [401, 403].includes(errorObj.response.status)) {
+            return true;
+        }
+        return errorObj?.code === "WORDPRESS_AUTH_ERROR";
+    }
+}
+//# sourceMappingURL=ToolRegistry.js.map

package/dist/src/server/ToolRegistry.js.map

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

package/dist/src/server.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Compatibility export for tests
+ * Re-exports the main MCP server class for backward compatibility
+ */
+export { default as MCPWordPressServer } from "./index.js";
+export { default } from "./index.js";
+//# sourceMappingURL=server.d.ts.map

package/dist/src/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/server.js

@@ -0,0 +1,7 @@
+/**
+ * Compatibility export for tests
+ * Re-exports the main MCP server class for backward compatibility
+ */
+export { default as MCPWordPressServer } from "./index.js";
+export { default } from "./index.js";
+//# sourceMappingURL=server.js.map

package/dist/src/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/tools/BaseToolManager.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Base utility class for tool managers with enhanced type safety
+ */
+import { WordPressId, DeepReadonly, Result } from "../types/enhanced.js";
+export interface ParameterValidationRule<T = unknown> {
+    readonly key: string;
+    readonly required: boolean;
+    readonly type?: string;
+    readonly validator?: (value: unknown) => value is T;
+    readonly transformer?: (value: unknown) => T;
+    readonly errorMessage?: string;
+}
+export interface CacheKeyOptions {
+    readonly namespace?: string;
+    readonly includeTimestamp?: boolean;
+    readonly customHasher?: (params: Record<string, unknown>) => string;
+}
+export declare class BaseToolUtils {
+    /**
+     * Validate required parameters with enhanced type safety
+     */
+    static validateParams<T extends Record<string, unknown>>(params: unknown, rules: readonly ParameterValidationRule[]): Result<T, Error>;
+    /**
+     * Validate ID parameter with WordPress ID branding
+     */
+    static validateId(id: unknown, name?: string): Result<WordPressId, Error>;
+    /**
+     * Validate multiple IDs at once
+     */
+    static validateIds(ids: unknown[], name?: string): Result<readonly WordPressId[], Error>;
+    /**
+     * Handle errors consistently with enhanced error context
+     */
+    static handleError(error: unknown, operation: string, context?: Record<string, unknown> | undefined): Error;
+    /**
+     * Generate cache keys with enhanced options
+     */
+    static generateCacheKey(operation: string, params: DeepReadonly<Record<string, unknown>>, options?: CacheKeyOptions): string;
+    /**
+     * Format consistent success response messages
+     */
+    static formatSuccessMessage(operation: string, details?: string, count?: number): string;
+    /**
+     * Validate string parameters with enhanced checks
+     */
+    static validateString(value: unknown, name: string, options?: {
+        readonly required?: boolean;
+        readonly minLength?: number;
+        readonly maxLength?: number;
+        readonly pattern?: RegExp;
+        readonly allowEmpty?: boolean;
+    }): Result<string, Error>;
+    /**
+     * Type-safe parameter extraction
+     */
+    static extractParam<T>(params: DeepReadonly<Record<string, unknown>>, key: string, defaultValue?: T): T | undefined;
+    /**
+     * Safe array extraction with type validation
+     */
+    static extractArray<T>(params: DeepReadonly<Record<string, unknown>>, key: string, itemValidator?: (item: unknown) => item is T): readonly T[];
+}
+//# sourceMappingURL=BaseToolManager.d.ts.map

package/dist/src/tools/BaseToolManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseToolManager.d.ts","sourceRoot":"","sources":["../../../src/tools/BaseToolManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,WAAW,EAAqB,YAAY,EAAE,MAAM,EAA8B,MAAM,sBAAsB,CAAC;AASxH,MAAM,WAAW,uBAAuB,CAAC,CAAC,GAAG,OAAO;IAClD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC;IACpD,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,CAAC;IAC7C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;CACrE;AAED,qBAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrD,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,SAAS,uBAAuB,EAAE,GACxC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC;IAoEnB;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,SAAO,GAAG,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC;IAoBvE;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,IAAI,SAAQ,GAAG,MAAM,CAAC,SAAS,WAAW,EAAE,EAAE,KAAK,CAAC;IAcvF;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,KAAK;IAa3G;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC7C,OAAO,GAAE,eAAoB,GAC5B,MAAM;IA8BT;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAgBxF;;OAEG;IACH,MAAM,CAAC,cAAc,CACnB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;QACP,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;KAC1B,GACL,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IA6CxB;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,CAAC,EACnB,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC7C,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,CAAC,GACf,CAAC,GAAG,SAAS;IAKhB;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,CAAC,EACnB,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC7C,GAAG,EAAE,MAAM,EACX,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,GAC3C,SAAS,CAAC,EAAE;CAahB"}

package/dist/src/tools/BaseToolManager.js

@@ -0,0 +1,195 @@
+/**
+ * Base utility class for tool managers with enhanced type safety
+ */
+import { getErrorMessage } from "../utils/error.js";
+import { createWordPressId, createSuccess, createError } from "../types/enhanced.js";
+export class BaseToolUtils {
+    /**
+     * Validate required parameters with enhanced type safety
+     */
+    static validateParams(params, rules) {
+        if (!params || typeof params !== 'object' || Array.isArray(params)) {
+            return createError(new ValidationError('Parameters must be a non-null object', 'params', params));
+        }
+        const typedParams = params;
+        const errors = [];
+        for (const rule of rules) {
+            const value = typedParams[rule.key];
+            const exists = rule.key in typedParams;
+            // Check required fields
+            if (rule.required && (!exists || value === undefined || value === null)) {
+                errors.push(new ValidationError(rule.errorMessage || `Missing required parameter: ${rule.key}`, rule.key, value));
+                continue;
+            }
+            // Skip optional fields that don't exist
+            if (!rule.required && !exists) {
+                continue;
+            }
+            // Type validation
+            if (rule.type && typeof value !== rule.type) {
+                errors.push(new ValidationError(`Parameter ${rule.key} must be of type ${rule.type}, got ${typeof value}`, rule.key, value));
+                continue;
+            }
+            // Custom validation
+            if (rule.validator && !rule.validator(value)) {
+                errors.push(new ValidationError(rule.errorMessage || `Parameter ${rule.key} failed validation`, rule.key, value));
+                continue;
+            }
+            // Transform value if transformer provided
+            if (rule.transformer) {
+                try {
+                    typedParams[rule.key] = rule.transformer(value);
+                }
+                catch (error) {
+                    errors.push(new ValidationError(`Failed to transform parameter ${rule.key}: ${getErrorMessage(error)}`, rule.key, value));
+                }
+            }
+        }
+        if (errors.length > 0) {
+            return createError(errors[0]); // Return first error for simplicity
+        }
+        return createSuccess(typedParams);
+    }
+    /**
+     * Validate ID parameter with WordPress ID branding
+     */
+    static validateId(id, name = "id") {
+        try {
+            const numId = Number(id);
+            if (!Number.isInteger(numId) || numId <= 0) {
+                return createError(new ValidationError(`Invalid ${name}: must be a positive integer`, name, id));
+            }
+            return createSuccess(createWordPressId(numId));
+        }
+        catch (error) {
+            return createError(new ValidationError(`Invalid ${name}: ${getErrorMessage(error)}`, name, id));
+        }
+    }
+    /**
+     * Validate multiple IDs at once
+     */
+    static validateIds(ids, name = "ids") {
+        const validatedIds = [];
+        for (let i = 0; i < ids.length; i++) {
+            const result = this.validateId(ids[i], `${name}[${i}]`);
+            if (!result.success) {
+                return result;
+            }
+            validatedIds.push(result.data);
+        }
+        return createSuccess(validatedIds);
+    }
+    /**
+     * Handle errors consistently with enhanced error context
+     */
+    static handleError(error, operation, context) {
+        const errorMessage = getErrorMessage(error);
+        const enhancedMessage = `Error in ${operation}: ${errorMessage}`;
+        const enhancedError = new Error(enhancedMessage);
+        enhancedError.originalError = error;
+        enhancedError.operation = operation;
+        enhancedError.context = context;
+        enhancedError.timestamp = new Date();
+        return enhancedError;
+    }
+    /**
+     * Generate cache keys with enhanced options
+     */
+    static generateCacheKey(operation, params, options = {}) {
+        const { namespace = 'wp', includeTimestamp = false, customHasher } = options;
+        const site = params.site || "default";
+        let paramStr;
+        if (customHasher) {
+            paramStr = customHasher(params);
+        }
+        else {
+            paramStr = Object.entries(params)
+                .filter(([key]) => key !== "site")
+                .sort(([a], [b]) => a.localeCompare(b))
+                .map(([key, value]) => `${key}:${JSON.stringify(value)}`)
+                .join("|");
+        }
+        let cacheKey = `${namespace}:${site}:${operation}:${paramStr}`;
+        if (includeTimestamp) {
+            const timestamp = Math.floor(Date.now() / 1000);
+            cacheKey += `:${timestamp}`;
+        }
+        return cacheKey;
+    }
+    /**
+     * Format consistent success response messages
+     */
+    static formatSuccessMessage(operation, details, count) {
+        let message = operation;
+        if (count !== undefined) {
+            message += ` (${count} ${count === 1 ? 'item' : 'items'})`;
+        }
+        if (details) {
+            message += `: ${details}`;
+        }
+        else {
+            message += " completed successfully";
+        }
+        return message;
+    }
+    /**
+     * Validate string parameters with enhanced checks
+     */
+    static validateString(value, name, options = {}) {
+        const { required = true, minLength, maxLength, pattern, allowEmpty = false } = options;
+        if (value === undefined || value === null) {
+            if (required) {
+                return createError(new ValidationError(`${name} is required`, name, value));
+            }
+            return createSuccess('');
+        }
+        if (typeof value !== 'string') {
+            return createError(new ValidationError(`${name} must be a string`, name, value));
+        }
+        if (!allowEmpty && value.trim().length === 0) {
+            return createError(new ValidationError(`${name} cannot be empty`, name, value));
+        }
+        if (minLength !== undefined && value.length < minLength) {
+            return createError(new ValidationError(`${name} must be at least ${minLength} characters long`, name, value));
+        }
+        if (maxLength !== undefined && value.length > maxLength) {
+            return createError(new ValidationError(`${name} must be no more than ${maxLength} characters long`, name, value));
+        }
+        if (pattern && !pattern.test(value)) {
+            return createError(new ValidationError(`${name} does not match required pattern`, name, value));
+        }
+        return createSuccess(value);
+    }
+    /**
+     * Type-safe parameter extraction
+     */
+    static extractParam(params, key, defaultValue) {
+        const value = params[key];
+        return value !== undefined ? value : defaultValue;
+    }
+    /**
+     * Safe array extraction with type validation
+     */
+    static extractArray(params, key, itemValidator) {
+        const value = params[key];
+        if (!Array.isArray(value)) {
+            return [];
+        }
+        if (itemValidator) {
+            return value.filter(itemValidator);
+        }
+        return value;
+    }
+}
+// Custom ValidationError class for enhanced error handling
+class ValidationError extends Error {
+    field;
+    value;
+    constructor(message, field, value) {
+        super(message);
+        this.field = field;
+        this.value = value;
+        this.name = 'ValidationError';
+    }
+}
+//# sourceMappingURL=BaseToolManager.js.map

package/dist/src/tools/BaseToolManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseToolManager.js","sourceRoot":"","sources":["../../../src/tools/BaseToolManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAe,iBAAiB,EAAwB,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAwBxH,MAAM,OAAO,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,cAAc,CACnB,MAAe,EACf,KAAyC;QAEzC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnE,OAAO,WAAW,CAAC,IAAI,eAAe,CAAC,sCAAsC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;QACpG,CAAC;QAED,MAAM,WAAW,GAAG,MAAiC,CAAC;QACtD,MAAM,MAAM,GAAY,EAAE,CAAC;QAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,WAAW,CAAC;YAEvC,wBAAwB;YACxB,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,EAAE,CAAC;gBACxE,MAAM,CAAC,IAAI,CAAC,IAAI,eAAe,CAC7B,IAAI,CAAC,YAAY,IAAI,+BAA+B,IAAI,CAAC,GAAG,EAAE,EAC9D,IAAI,CAAC,GAAG,EACR,KAAK,CACN,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,wCAAwC;YACxC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC9B,SAAS;YACX,CAAC;YAED,kBAAkB;YAClB,IAAI,IAAI,CAAC,IAAI,IAAI,OAAO,KAAK,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5C,MAAM,CAAC,IAAI,CAAC,IAAI,eAAe,CAC7B,aAAa,IAAI,CAAC,GAAG,oBAAoB,IAAI,CAAC,IAAI,SAAS,OAAO,KAAK,EAAE,EACzE,IAAI,CAAC,GAAG,EACR,KAAK,CACN,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,oBAAoB;YACpB,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7C,MAAM,CAAC,IAAI,CAAC,IAAI,eAAe,CAC7B,IAAI,CAAC,YAAY,IAAI,aAAa,IAAI,CAAC,GAAG,oBAAoB,EAC9D,IAAI,CAAC,GAAG,EACR,KAAK,CACN,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,0CAA0C;YAC1C,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrB,IAAI,CAAC;oBACH,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;gBAClD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,CAAC,IAAI,eAAe,CAC7B,iCAAiC,IAAI,CAAC,GAAG,KAAK,eAAe,CAAC,KAAK,CAAC,EAAE,EACtE,IAAI,CAAC,GAAG,EACR,KAAK,CACN,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,oCAAoC;QACrE,CAAC;QAED,OAAO,aAAa,CAAC,WAAgB,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,EAAW,EAAE,IAAI,GAAG,IAAI;QACxC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBAC3C,OAAO,WAAW,CAAC,IAAI,eAAe,CACpC,WAAW,IAAI,8BAA8B,EAC7C,IAAI,EACJ,EAAE,CACH,CAAC,CAAC;YACL,CAAC;YACD,OAAO,aAAa,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,IAAI,eAAe,CACpC,WAAW,IAAI,KAAK,eAAe,CAAC,KAAK,CAAC,EAAE,EAC5C,IAAI,EACJ,EAAE,CACH,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,GAAc,EAAE,IAAI,GAAG,KAAK;QAC7C,MAAM,YAAY,GAAkB,EAAE,CAAC;QAEvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;YACxD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QAED,OAAO,aAAa,CAAC,YAAsC,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAc,EAAE,SAAiB,EAAE,OAA6C;QACjG,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,eAAe,GAAG,YAAY,SAAS,KAAK,YAAY,EAAE,CAAC;QAEjE,MAAM,aAAa,GAAG,IAAI,KAAK,CAAC,eAAe,CAAkB,CAAC;QAClE,aAAa,CAAC,aAAa,GAAG,KAAK,CAAC;QACpC,aAAa,CAAC,SAAS,GAAG,SAAS,CAAC;QACpC,aAAa,CAAC,OAAO,GAAG,OAAO,CAAC;QAChC,aAAa,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAErC,OAAO,aAAa,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,SAAiB,EACjB,MAA6C,EAC7C,UAA2B,EAAE;QAE7B,MAAM,EACJ,SAAS,GAAG,IAAI,EAChB,gBAAgB,GAAG,KAAK,EACxB,YAAY,EACb,GAAG,OAAO,CAAC;QAEZ,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,SAAS,CAAC;QAEtC,IAAI,QAAgB,CAAC;QACrB,IAAI,YAAY,EAAE,CAAC;YACjB,QAAQ,GAAG,YAAY,CAAC,MAAiC,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;iBAC9B,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,MAAM,CAAC;iBACjC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;iBACtC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;iBACxD,IAAI,CAAC,GAAG,CAAC,CAAC;QACf,CAAC;QAED,IAAI,QAAQ,GAAG,GAAG,SAAS,IAAI,IAAI,IAAI,SAAS,IAAI,QAAQ,EAAE,CAAC;QAE/D,IAAI,gBAAgB,EAAE,CAAC;YACrB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YAChD,QAAQ,IAAI,IAAI,SAAS,EAAE,CAAC;QAC9B,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,SAAiB,EAAE,OAAgB,EAAE,KAAc;QAC7E,IAAI,OAAO,GAAG,SAAS,CAAC;QAExB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,IAAI,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC;QAC7D,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,yBAAyB,CAAC;QACvC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc,CACnB,KAAc,EACd,IAAY,EACZ,UAMI,EAAE;QAEN,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;QAEvF,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,WAAW,CAAC,IAAI,eAAe,CAAC,GAAG,IAAI,cAAc,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;YAC9E,CAAC;YACD,OAAO,aAAa,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,WAAW,CAAC,IAAI,eAAe,CAAC,GAAG,IAAI,mBAAmB,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACnF,CAAC;QAED,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7C,OAAO,WAAW,CAAC,IAAI,eAAe,CAAC,GAAG,IAAI,kBAAkB,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QAClF,CAAC;QAED,IAAI,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YACxD,OAAO,WAAW,CAAC,IAAI,eAAe,CACpC,GAAG,IAAI,qBAAqB,SAAS,kBAAkB,EACvD,IAAI,EACJ,KAAK,CACN,CAAC,CAAC;QACL,CAAC;QAED,IAAI,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YACxD,OAAO,WAAW,CAAC,IAAI,eAAe,CACpC,GAAG,IAAI,yBAAyB,SAAS,kBAAkB,EAC3D,IAAI,EACJ,KAAK,CACN,CAAC,CAAC;QACL,CAAC;QAED,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,OAAO,WAAW,CAAC,IAAI,eAAe,CACpC,GAAG,IAAI,kCAAkC,EACzC,IAAI,EACJ,KAAK,CACN,CAAC,CAAC;QACL,CAAC;QAED,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,MAA6C,EAC7C,GAAW,EACX,YAAgB;QAEhB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAU,CAAC,CAAC,CAAC,YAAY,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,MAA6C,EAC7C,GAAW,EACX,aAA4C;QAE5C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAE1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,KAAqB,CAAC;IAC/B,CAAC;CACF;AAED,2DAA2D;AAC3D,MAAM,eAAgB,SAAQ,KAAK;IAGf;IACA;IAHlB,YACE,OAAe,EACC,KAAa,EACb,KAAc;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,UAAK,GAAL,KAAK,CAAQ;QACb,UAAK,GAAL,KAAK,CAAS;QAG9B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/src/tools/auth.d.ts

@@ -0,0 +1,50 @@
+import { WordPressClient } from "../client/api.js";
+/**
+ * Provides authentication-related tools for WordPress sites.
+ * This class encapsulates tool definitions and their corresponding handlers.
+ */
+export declare class AuthTools {
+    /**
+     * Retrieves the list of authentication tools.
+     * @returns An array of MCPTool definitions.
+     */
+    getTools(): Array<{
+        name: string;
+        description: string;
+        parameters?: Array<{
+            name: string;
+            type?: string;
+            description?: string;
+            required?: boolean;
+            enum?: string[];
+            items?: unknown;
+        }>;
+        handler: (client: WordPressClient, params: Record<string, unknown>) => Promise<unknown>;
+    }>;
+    /**
+     * Handles the 'wp_test_auth' tool request.
+     * It tests the connection and fetches user details upon success.
+     * @param client - The WordPressClient instance for the target site.
+     * @param params - The parameters for the tool request.
+     * @returns A promise that resolves to an MCPToolResponse.
+     */
+    handleTestAuth(client: WordPressClient, params: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Handles the 'wp_get_auth_status' tool request.
+     * Reports whether the client is currently authenticated.
+     * @param client - The WordPressClient instance for the target site.
+     * @param params - The parameters for the tool request.
+     * @returns A promise that resolves to an MCPToolResponse.
+     */
+    handleGetAuthStatus(client: WordPressClient, params: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Handles the 'wp_switch_auth_method' tool request.
+     * Updates the client's authentication configuration in memory for the session.
+     * @param client - The WordPressClient instance for the target site.
+     * @param params - The parameters for the tool request, including the new auth details.
+     * @returns A promise that resolves to an MCPToolResponse.
+     */
+    handleSwitchAuthMethod(client: WordPressClient, params: Record<string, unknown>): Promise<unknown>;
+}
+export default AuthTools;
+//# sourceMappingURL=auth.d.ts.map

package/dist/src/tools/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/tools/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAInD;;;GAGG;AACH,qBAAa,SAAS;IACpB;;;OAGG;IACI,QAAQ,IAAI,KAAK,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QAChI,OAAO,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KACzF,CAAC;IAqDF;;;;;;OAMG;IACU,cAAc,CACzB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAoBnC;;;;;;OAMG;IACU,mBAAmB,CAC9B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAsBnC;;;;;;OAMG;IACU,sBAAsB,CACjC,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;CAiBpB;AAED,eAAe,SAAS,CAAC"}