mcp-wordpress 2.10.0 → 2.10.2

package/src/client/managers/JWTAuthImplementation.ts

@@ -34,10 +34,10 @@ export class JWTAuthImplementation {
   private jwtToken: string | null = null;
   private tokenExpiry: number | null = null;
   private refreshTokenValue: string | null = null;
-  
+
   constructor(
     private requestManager: RequestManager,
-    private authConfig: AuthConfig
+    private authConfig: AuthConfig,
   ) {}
 
   /**
@@ -49,9 +49,9 @@ export class JWTAuthImplementation {
     }
 
     try {
-      this.logger.info("Starting JWT authentication", { 
+      this.logger.info("Starting JWT authentication", {
         username: this.authConfig.username,
-        endpoint: "jwt-auth/v1/token"
+        endpoint: "jwt-auth/v1/token",
       });
 
       const response = await this.requestManager.request<JWTTokenResponse>(
@@ -64,7 +64,7 @@ export class JWTAuthImplementation {
         {
           skipAuth: true, // Don't use auth headers for the auth request itself
           timeout: 10000,
-        } as RequestOptions & { skipAuth: boolean }
+        } as RequestOptions & { skipAuth: boolean },
       );
 
       if (!response.token) {
@@ -73,10 +73,10 @@ export class JWTAuthImplementation {
 
       // Store the JWT token
       this.jwtToken = response.token;
-      
+
       // Calculate token expiry (default to 24 hours if not provided)
-      const expiresInSeconds = response.expires_in || (24 * 60 * 60);
-      this.tokenExpiry = Date.now() + (expiresInSeconds * 1000);
+      const expiresInSeconds = response.expires_in || 24 * 60 * 60;
+      this.tokenExpiry = Date.now() + expiresInSeconds * 1000;
 
       this.logger.info("JWT authentication successful", {
         user: response.user_nicename,
@@ -85,14 +85,13 @@ export class JWTAuthImplementation {
 
       // Test the token by validating it
       await this.validateToken();
-
     } catch (error) {
       this.jwtToken = null;
       this.tokenExpiry = null;
       this.logger.error("JWT authentication failed", {
         error: error instanceof Error ? error.message : String(error),
       });
-      
+
       if (error instanceof Error) {
         throw new AuthenticationError(`JWT authentication failed: ${error.message}`, AUTH_METHODS.JWT);
       }
@@ -118,11 +117,11 @@ export class JWTAuthImplementation {
             Authorization: `Bearer ${this.jwtToken}`,
           },
           timeout: 5000,
-        }
+        },
       );
 
       const isValid = response.data.status === 200;
-      
+
       if (!isValid) {
         this.logger.warn("JWT token validation failed", { response });
         this.jwtToken = null;
@@ -130,7 +129,6 @@ export class JWTAuthImplementation {
       }
 
       return isValid;
-
     } catch (error) {
       this.logger.warn("JWT token validation error", {
         error: error instanceof Error ? error.message : String(error),
@@ -162,14 +160,14 @@ export class JWTAuthImplementation {
               Authorization: `Bearer ${this.jwtToken}`,
             },
             timeout: 5000,
-          }
+          },
         );
 
         if (refreshResponse.token) {
           this.jwtToken = refreshResponse.token;
-          const expiresInSeconds = refreshResponse.expires_in || (24 * 60 * 60);
-          this.tokenExpiry = Date.now() + (expiresInSeconds * 1000);
-          
+          const expiresInSeconds = refreshResponse.expires_in || 24 * 60 * 60;
+          this.tokenExpiry = Date.now() + expiresInSeconds * 1000;
+
           this.logger.info("JWT token refreshed successfully", {
             expiresAt: new Date(this.tokenExpiry).toISOString(),
           });
@@ -186,17 +184,16 @@ export class JWTAuthImplementation {
 
       this.logger.debug("Re-authenticating to refresh JWT token");
       await this.authenticateJWT();
-
     } catch (error) {
       this.jwtToken = null;
       this.tokenExpiry = null;
       this.logger.error("JWT token refresh failed", {
         error: error instanceof Error ? error.message : String(error),
       });
-      
+
       throw new AuthenticationError(
-        `JWT token refresh failed: ${error instanceof Error ? error.message : 'Unknown error'}`,
-        AUTH_METHODS.JWT
+        `JWT token refresh failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+        AUTH_METHODS.JWT,
       );
     }
   }
@@ -208,10 +205,10 @@ export class JWTAuthImplementation {
     if (!this.tokenExpiry) {
       return true;
     }
-    
+
     // Consider token expired if it expires within 5 minutes (300000ms)
     const buffer = 5 * 60 * 1000;
-    return Date.now() >= (this.tokenExpiry - buffer);
+    return Date.now() >= this.tokenExpiry - buffer;
   }
 
   /**
@@ -245,7 +242,7 @@ export class JWTAuthImplementation {
     if (!this.jwtToken) {
       return {};
     }
-    
+
     return {
       Authorization: `Bearer ${this.jwtToken}`,
     };
@@ -294,9 +291,9 @@ export class JWTAuthImplementation {
         {
           headers: this.getAuthHeaders(),
           timeout: 5000,
-        }
+        },
       );
-      
+
       this.logger.info("JWT token invalidated on server");
     } catch (error) {
       this.logger.warn("Failed to invalidate JWT token on server", {
@@ -323,4 +320,4 @@ export class JWTAuthImplementation {
       expiresIn: this.tokenExpiry ? Math.max(0, this.tokenExpiry - Date.now()) : null,
     };
   }
-}
+}

package/src/client/managers/ManagersIndex.ts

@@ -3,4 +3,4 @@
  * Export all manager classes
  */
 
-export { AuthManager, type JWTToken } from "./AuthManager.js";
+export { AuthManager, type JWTToken } from "./AuthManager.js";

package/src/client/managers/composed/MigrationAdapter.ts

@@ -245,7 +245,7 @@ import { MigrationAdapter } from '@/client/managers/composed';
 const USE_COMPOSITION = process.env.USE_COMPOSED_MANAGERS === 'true';
 
 const { requestManager, authManager } = await MigrationAdapter.createManagers(
-  config, 
+  config,
   USE_COMPOSITION
 );
 \`\`\`

package/src/client/managers/composed/index.ts

@@ -1,13 +1,13 @@
 /**
  * Composed Managers Export
- * 
+ *
  * This module provides composition-based alternatives to the inheritance-based managers.
  * The composed managers offer better testability, flexibility, and adherence to SOLID principles.
- * 
+ *
  * Usage:
  * ```typescript
  * import { createComposedWordPressClient } from '@/client/managers/composed';
- * 
+ *
  * const client = await createComposedWordPressClient(config);
  * const posts = await client.getPosts();
  * ```
@@ -23,7 +23,7 @@ export type {
   BaseManagerContract,
   ComposedManager,
   ManagerFactory,
-  ManagerCompositionConfig
+  ManagerCompositionConfig,
 } from "../interfaces/ManagerInterfaces.js";
 
 // Implementations
@@ -36,12 +36,12 @@ export { ComposedAuthenticationManager } from "../ComposedAuthenticationManager.
 export { ComposedRequestManager } from "../ComposedRequestManager.js";
 
 // Factory and Client
-export { 
+export {
   ComposedManagerFactory,
   ComposedWordPressClient,
   createComposedWordPressClient,
-  type ComposedWordPressClientDependencies
+  type ComposedWordPressClientDependencies,
 } from "../ComposedManagerFactory.js";
 
 // Migration utilities (for gradual migration from inheritance to composition)
-export { MigrationAdapter } from "./MigrationAdapter.js";
+export { MigrationAdapter } from "./MigrationAdapter.js";

package/src/client/managers/implementations/ErrorHandlerImpl.ts

@@ -28,18 +28,14 @@ export class ErrorHandlerImpl implements ErrorHandler {
 
     if (isErrorLike(error)) {
       if (error.name === "AbortError" || error.code === "ABORT_ERR") {
-        throw new WordPressAPIError(
-          `Request timeout after ${this.configProvider.config.timeout}ms`, 
-          408, 
-          "timeout"
-        );
+        throw new WordPressAPIError(`Request timeout after ${this.configProvider.config.timeout}ms`, 408, "timeout");
       }
 
       if (error.code === "ECONNREFUSED" || error.code === "ENOTFOUND") {
         throw new WordPressAPIError(
-          `Cannot connect to WordPress site: ${this.configProvider.config.baseUrl}`, 
-          503, 
-          "connection_failed"
+          `Cannot connect to WordPress site: ${this.configProvider.config.baseUrl}`,
+          503,
+          "connection_failed",
         );
       }
     }
@@ -60,27 +56,21 @@ export class ErrorHandlerImpl implements ErrorHandler {
    */
   handleAuthError(error: unknown, operation: string): never {
     logError(`Authentication failed during ${operation}:`, error as Record<string, unknown>);
-    
+
     if (error instanceof WordPressAPIError) {
       throw error;
     }
 
     const message = getErrorMessage(error);
-    throw new WordPressAPIError(
-      `Authentication failed during ${operation}: ${message}`, 
-      401, 
-      "auth_failed"
-    );
+    throw new WordPressAPIError(`Authentication failed during ${operation}: ${message}`, 401, "auth_failed");
   }
 
   /**
    * Handle rate limit errors specifically
    */
   handleRateLimitError(retryAfter?: number): never {
-    const message = retryAfter 
-      ? `Rate limit exceeded. Retry after ${retryAfter} seconds.`
-      : "Rate limit exceeded.";
-    
+    const message = retryAfter ? `Rate limit exceeded. Retry after ${retryAfter} seconds.` : "Rate limit exceeded.";
+
     throw new WordPressAPIError(message, 429, "rate_limited");
   }
 
@@ -91,12 +81,8 @@ export class ErrorHandlerImpl implements ErrorHandler {
     const message = getErrorMessage(baseError);
     const contextString = Object.entries(context)
       .map(([key, value]) => `${key}=${String(value)}`)
-      .join(', ');
-    
-    return new WordPressAPIError(
-      `${message} (Context: ${contextString})`,
-      500,
-      "contextual_error"
-    );
+      .join(", ");
+
+    return new WordPressAPIError(`${message} (Context: ${contextString})`, 500, "contextual_error");
   }
-}
+}

package/src/client/managers/implementations/ParameterValidatorImpl.ts

@@ -42,12 +42,16 @@ export class ParameterValidatorImpl implements ParameterValidator {
   /**
    * Validate string parameters
    */
-  validateString(value: unknown, fieldName: string, options?: {
-    required?: boolean;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: RegExp;
-  }): string {
+  validateString(
+    value: unknown,
+    fieldName: string,
+    options?: {
+      required?: boolean;
+      minLength?: number;
+      maxLength?: number;
+      pattern?: RegExp;
+    },
+  ): string {
     if (options?.required && (value === undefined || value === null || value === "")) {
       throw new WordPressAPIError(`${fieldName} is required`, 400, "missing_parameter");
     }
@@ -62,26 +66,22 @@ export class ParameterValidatorImpl implements ParameterValidator {
 
     if (options?.minLength && value.length < options.minLength) {
       throw new WordPressAPIError(
-        `${fieldName} must be at least ${options.minLength} characters`, 
-        400, 
-        "parameter_too_short"
+        `${fieldName} must be at least ${options.minLength} characters`,
+        400,
+        "parameter_too_short",
       );
     }
 
     if (options?.maxLength && value.length > options.maxLength) {
       throw new WordPressAPIError(
-        `${fieldName} must be no more than ${options.maxLength} characters`, 
-        400, 
-        "parameter_too_long"
+        `${fieldName} must be no more than ${options.maxLength} characters`,
+        400,
+        "parameter_too_long",
       );
     }
 
     if (options?.pattern && !options.pattern.test(value)) {
-      throw new WordPressAPIError(
-        `${fieldName} format is invalid`, 
-        400, 
-        "invalid_parameter_format"
-      );
+      throw new WordPressAPIError(`${fieldName} format is invalid`, 400, "invalid_parameter_format");
     }
 
     return value;
@@ -90,12 +90,16 @@ export class ParameterValidatorImpl implements ParameterValidator {
   /**
    * Validate numeric parameters
    */
-  validateNumber(value: unknown, fieldName: string, options?: {
-    required?: boolean;
-    min?: number;
-    max?: number;
-    integer?: boolean;
-  }): number {
+  validateNumber(
+    value: unknown,
+    fieldName: string,
+    options?: {
+      required?: boolean;
+      min?: number;
+      max?: number;
+      integer?: boolean;
+    },
+  ): number {
     if (options?.required && (value === undefined || value === null)) {
       throw new WordPressAPIError(`${fieldName} is required`, 400, "missing_parameter");
     }
@@ -115,19 +119,11 @@ export class ParameterValidatorImpl implements ParameterValidator {
     }
 
     if (options?.min !== undefined && numValue < options.min) {
-      throw new WordPressAPIError(
-        `${fieldName} must be at least ${options.min}`, 
-        400, 
-        "parameter_too_small"
-      );
+      throw new WordPressAPIError(`${fieldName} must be at least ${options.min}`, 400, "parameter_too_small");
     }
 
     if (options?.max !== undefined && numValue > options.max) {
-      throw new WordPressAPIError(
-        `${fieldName} must be no more than ${options.max}`, 
-        400, 
-        "parameter_too_large"
-      );
+      throw new WordPressAPIError(`${fieldName} must be no more than ${options.max}`, 400, "parameter_too_large");
     }
 
     return numValue;
@@ -136,12 +132,16 @@ export class ParameterValidatorImpl implements ParameterValidator {
   /**
    * Validate array parameters
    */
-  validateArray<T>(value: unknown, fieldName: string, options?: {
-    required?: boolean;
-    minLength?: number;
-    maxLength?: number;
-    itemValidator?: (item: unknown) => T;
-  }): T[] {
+  validateArray<T>(
+    value: unknown,
+    fieldName: string,
+    options?: {
+      required?: boolean;
+      minLength?: number;
+      maxLength?: number;
+      itemValidator?: (item: unknown) => T;
+    },
+  ): T[] {
     if (options?.required && (value === undefined || value === null)) {
       throw new WordPressAPIError(`${fieldName} is required`, 400, "missing_parameter");
     }
@@ -156,17 +156,17 @@ export class ParameterValidatorImpl implements ParameterValidator {
 
     if (options?.minLength && value.length < options.minLength) {
       throw new WordPressAPIError(
-        `${fieldName} must contain at least ${options.minLength} items`, 
-        400, 
-        "array_too_short"
+        `${fieldName} must contain at least ${options.minLength} items`,
+        400,
+        "array_too_short",
       );
     }
 
     if (options?.maxLength && value.length > options.maxLength) {
       throw new WordPressAPIError(
-        `${fieldName} must contain no more than ${options.maxLength} items`, 
-        400, 
-        "array_too_long"
+        `${fieldName} must contain no more than ${options.maxLength} items`,
+        400,
+        "array_too_long",
       );
     }
 
@@ -179,7 +179,7 @@ export class ParameterValidatorImpl implements ParameterValidator {
             throw new WordPressAPIError(
               `${fieldName}[${index}] validation failed: ${getErrorMessage(error)}`,
               400,
-              "array_item_invalid"
+              "array_item_invalid",
             );
           }
         });
@@ -190,7 +190,7 @@ export class ParameterValidatorImpl implements ParameterValidator {
         throw new WordPressAPIError(
           `${fieldName} validation failed: ${getErrorMessage(error)}`,
           400,
-          "array_validation_failed"
+          "array_validation_failed",
         );
       }
     }
@@ -205,7 +205,7 @@ export class ParameterValidatorImpl implements ParameterValidator {
     const id = this.validateNumber(value, fieldName, {
       required: true,
       min: 1,
-      integer: true
+      integer: true,
     });
 
     return id;
@@ -218,4 +218,4 @@ function getErrorMessage(error: unknown): string {
     return error.message;
   }
   return String(error);
-}
+}

package/src/client/managers/interfaces/ManagerInterfaces.ts

@@ -10,7 +10,7 @@ import type { WordPressClientConfig } from "@/types/client.js";
  */
 export interface ConfigurationProvider {
   readonly config: WordPressClientConfig;
-  
+
   /**
    * Get configuration value by path
    */
@@ -49,12 +49,16 @@ export interface ParameterValidator {
   /**
    * Validate string parameters
    */
-  validateString(value: unknown, fieldName: string, options?: {
-    required?: boolean;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: RegExp;
-  }): string;
+  validateString(
+    value: unknown,
+    fieldName: string,
+    options?: {
+      required?: boolean;
+      minLength?: number;
+      maxLength?: number;
+      pattern?: RegExp;
+    },
+  ): string;
 
   /**
    * Validate WordPress ID parameters
@@ -148,7 +152,7 @@ export interface ManagerFactory {
 export interface ManagerCompositionConfig {
   /** WordPress client configuration */
   clientConfig: WordPressClientConfig;
-  
+
   /** Optional custom implementations */
   customErrorHandler?: ErrorHandler;
   customValidator?: ParameterValidator;
@@ -168,4 +172,4 @@ export interface ComposedManager extends BaseManagerContract, RequestHandler, Au
    * Cleanup resources
    */
   dispose(): void;
-}
+}

package/src/config/index.ts

@@ -4,10 +4,10 @@
  */
 
 // Main Configuration System
-export { Config, ConfigHelpers, config } from './Config.js';
+export { Config, ConfigHelpers, config } from "./Config.js";
 
 // Configuration Schema and Validation
-export * from './ConfigurationSchema.js';
+export * from "./ConfigurationSchema.js";
 
 // Server Configuration (legacy)
-export * from './ServerConfiguration.js';
+export * from "./ServerConfiguration.js";

package/src/docs/MarkdownFormatter.ts

@@ -25,10 +25,12 @@ ${this.generateBadges()}
 
 ## Overview
 
-The WordPress MCP Server provides **${summary.totalTools} tools** across **${summary.totalCategories} categories** for comprehensive WordPress management through the Model Context Protocol.
+The WordPress MCP Server provides **${summary.totalTools} tools** across **${
+      summary.totalCategories
+    } categories** for comprehensive WordPress management through the Model Context Protocol.
 
-**Last Updated:** ${new Date(summary.lastUpdated).toLocaleDateString()}  
-**Version:** ${summary.version}  
+**Last Updated:** ${new Date(summary.lastUpdated).toLocaleDateString()}
+**Version:** ${summary.version}
 **Coverage:** ${summary.coverage.toolsWithExamples}/${summary.totalTools} tools with examples
 
 ## Quick Start
@@ -66,7 +68,7 @@ ${this.generateToolsTable(tools)}
 
 All tools support multiple authentication methods:
 - **Application Passwords** (recommended)
-- **JWT Authentication** 
+- **JWT Authentication**
 - **Basic Authentication** (development only)
 - **API Key Authentication**
 
@@ -214,7 +216,7 @@ wp_list_${category.name.toLowerCase()}
 # Get specific item
 wp_get_${category.name.toLowerCase().slice(0, -1)} --id=123
 
-# Create new item  
+# Create new item
 wp_create_${category.name.toLowerCase().slice(0, -1)} --title="Example"
 \`\`\`
 
@@ -272,7 +274,9 @@ ${type.examples.length > 1 ? this.generateAdditionalExamples(type.examples.slice
       const defaultVal = param.defaultValue !== undefined ? `\`${param.defaultValue}\`` : "-";
       const required = param.required ? "✅" : "❌";
 
-      return `| \`${param.name}\` | \`${param.type}\` | ${required} | ${param.description} | ${defaultVal} | ${examples || "-"} |`;
+      return `| \`${param.name}\` | \`${param.type}\` | ${required} | ${param.description} | ${defaultVal} | ${
+        examples || "-"
+      } |`;
     });
 
     return [headers, separator, ...rows].join("\n");
@@ -375,7 +379,7 @@ ${permissions.map((perm) => `- \`${perm}\``).join("\n")}
       return `### Common Errors
 
 - **Authentication Error**: Invalid credentials or insufficient permissions
-- **Validation Error**: Invalid or missing required parameters  
+- **Validation Error**: Invalid or missing required parameters
 - **Not Found Error**: Requested resource does not exist
 - **Server Error**: Internal WordPress or network error
 
@@ -386,8 +390,8 @@ See [Error Handling Guide](../error-handling.md) for complete error reference.`;
       .map(
         (error) => `### ${(error as Record<string, unknown>).code}
 
-**Message:** ${(error as Record<string, unknown>).message}  
-**Description:** ${(error as Record<string, unknown>).description}  
+**Message:** ${(error as Record<string, unknown>).message}
+**Description:** ${(error as Record<string, unknown>).description}
 **Resolution:** ${(error as Record<string, unknown>).resolution}
 `,
       )

package/src/performance/PerformanceAnalytics.ts

@@ -196,7 +196,9 @@ export class PerformanceAnalytics {
         category: "optimization",
         priority: "high",
         title: "Improve Cache Hit Rate",
-        description: `Current cache hit rate is ${(currentMetrics.cache.hitRate * 100).toFixed(1)}%, which is below optimal performance.`,
+        description: `Current cache hit rate is ${(currentMetrics.cache.hitRate * 100).toFixed(
+          1,
+        )}%, which is below optimal performance.`,
         impact: "performance",
         recommendation: "Implement cache warming strategies and optimize TTL values for frequently accessed data.",
         estimatedImprovement: "20-40% reduction in response times",
@@ -212,7 +214,9 @@ export class PerformanceAnalytics {
         category: "optimization",
         priority: "high",
         title: "Reduce Response Times",
-        description: `Average response time of ${currentMetrics.requests.averageResponseTime.toFixed(0)}ms is above recommended threshold.`,
+        description: `Average response time of ${currentMetrics.requests.averageResponseTime.toFixed(
+          0,
+        )}ms is above recommended threshold.`,
         impact: "user_experience",
         recommendation: "Enable aggressive caching, optimize database queries, or consider upgrading server resources.",
         estimatedImprovement: "50-70% reduction in response times",
@@ -249,7 +253,9 @@ export class PerformanceAnalytics {
         category: "optimization",
         priority: "low",
         title: "Optimize Frequently Used Tools",
-        description: `Most used tools: ${mostUsed.map(([tool]) => tool).join(", ")}. Consider optimizing these workflows.`,
+        description: `Most used tools: ${mostUsed
+          .map(([tool]) => tool)
+          .join(", ")}. Consider optimizing these workflows.`,
         impact: "performance",
         recommendation: "Create cached workflows or batch operations for frequently used tools.",
         estimatedImprovement: "10-20% reduction in API calls",

package/src/security/InputValidator.ts

@@ -175,7 +175,7 @@ export function validateSecurity(schema: z.ZodSchema) {
         logger.info(`Security validation passed for ${propertyName}`, {
           timestamp: new Date().toISOString(),
           method: propertyName,
-          paramCount: typeof validatedParams === 'object' && validatedParams ? Object.keys(validatedParams).length : 0,
+          paramCount: typeof validatedParams === "object" && validatedParams ? Object.keys(validatedParams).length : 0,
         });
 
         // Call original method with validated params

package/src/security/SecurityCIPipeline.ts

@@ -237,7 +237,7 @@ export class SecurityCIPipeline {
       try {
         const scanPromise = scanner.scanCodeForVulnerabilities
           ? scanner.scanCodeForVulnerabilities()
-          : (scanner.performScan?.() ?? Promise.resolve({ vulnerabilities: [], riskScore: 0 }));
+          : scanner.performScan?.() ?? Promise.resolve({ vulnerabilities: [], riskScore: 0 });
 
         if (opts.timeout && opts.timeout > 0) {
           const res = await Promise.race([

package/src/security/SecurityConfig.ts

@@ -190,7 +190,9 @@ export class SecurityUtils {
       return obj;
     }
 
-    const working: Record<string, unknown> | unknown[] = Array.isArray(obj) ? [...obj] : { ...(obj as Record<string, unknown>) };
+    const working: Record<string, unknown> | unknown[] = Array.isArray(obj)
+      ? [...obj]
+      : { ...(obj as Record<string, unknown>) };
 
     if (Array.isArray(working)) {
       return working.map((val) => (typeof val === "object" ? SecurityUtils.redactSensitiveData(val) : val));
@@ -276,8 +278,12 @@ export function createSecureError(
   const secureError = new Error(fallbackMessage);
 
   // Preserve error code if it's safe
-  if (error && typeof (error as { code?: unknown }).code === "string" && !(error as { code: string }).code.includes("_")) {
-  (secureError as unknown as Record<string, unknown>).code = (error as { code: string }).code;
+  if (
+    error &&
+    typeof (error as { code?: unknown }).code === "string" &&
+    !(error as { code: string }).code.includes("_")
+  ) {
+    (secureError as unknown as Record<string, unknown>).code = (error as { code: string }).code;
   }
 
   return secureError;