mcp-wordpress 2.10.0 → 2.10.2

package/src/server/index.ts

@@ -4,7 +4,7 @@
  */
 
 // Connection Testing
-export { ConnectionTester } from './ConnectionTester.js';
+export { ConnectionTester } from "./ConnectionTester.js";
 
 // Tool Registry Management
-export { ToolRegistry } from './ToolRegistry.js';
+export { ToolRegistry } from "./ToolRegistry.js";

package/src/tools/cache.ts

@@ -236,7 +236,9 @@ export class CacheTools {
         throw new Error("No WordPress sites configured.");
       } else {
         throw new Error(
-          `Multiple sites configured. Please specify --site parameter. Available sites: ${Array.from(this.clients.keys()).join(", ")}`,
+          `Multiple sites configured. Please specify --site parameter. Available sites: ${Array.from(
+            this.clients.keys(),
+          ).join(", ")}`,
         );
       }
     }

package/src/tools/comments.ts

@@ -168,7 +168,9 @@ export class CommentTools {
         comments
           .map(
             (c) =>
-              `- ID ${c.id}: By **${c.author_name}** on Post ${c.post} (${c.status})\n  > ${c.content.rendered.substring(0, 100)}...`,
+              `- ID ${c.id}: By **${c.author_name}** on Post ${c.post} (${
+                c.status
+              })\n  > ${c.content.rendered.substring(0, 100)}...`,
           )
           .join("\n");
       return content;

package/src/tools/performance.ts

@@ -39,7 +39,7 @@ export default class PerformanceTools {
   constructor(clients?: Map<string, unknown>) {
     // Initialize logger first
     this.logger = LoggerFactory.performance();
-    
+
     // Initialize performance monitoring system
     this.monitor = new PerformanceMonitor({
       enableRealTimeMonitoring: true,
@@ -944,12 +944,16 @@ export default class PerformanceTools {
   }
 
   private formatAlertMessage(alert: PerformanceAlert): string {
-    return `${alert.severity.toUpperCase()}: ${alert.message} (${alert.metric}: ${alert.actualValue} vs threshold: ${alert.threshold})`;
+    return `${alert.severity.toUpperCase()}: ${alert.message} (${alert.metric}: ${alert.actualValue} vs threshold: ${
+      alert.threshold
+    })`;
   }
 
   private formatAnomalyDescription(anomaly: PerformanceAnomaly): string {
     const direction = anomaly.actualValue > anomaly.expectedValue ? "higher" : "lower";
-    return `${anomaly.metric} is ${Math.abs(anomaly.deviation).toFixed(1)}% ${direction} than expected (${anomaly.expectedValue.toFixed(2)} vs ${anomaly.actualValue.toFixed(2)})`;
+    return `${anomaly.metric} is ${Math.abs(anomaly.deviation).toFixed(
+      1,
+    )}% ${direction} than expected (${anomaly.expectedValue.toFixed(2)} vs ${anomaly.actualValue.toFixed(2)})`;
   }
 
   private calculateAlertStatus(

package/src/tools/posts/PostHandlers.ts

@@ -204,7 +204,9 @@ export async function handleListPosts(
     // Add pagination guidance for large result sets
     let finalContent = content;
     if (posts.length >= (sanitizedParams.per_page || 10)) {
-      finalContent += `\n\n📄 **Pagination Tip**: Use \`per_page\` parameter to control results (max 100). Current: ${sanitizedParams.per_page || 10}`;
+      finalContent += `\n\n📄 **Pagination Tip**: Use \`per_page\` parameter to control results (max 100). Current: ${
+        sanitizedParams.per_page || 10
+      }`;
     }
 
     return finalContent;

package/src/tools/seo/SEOTools.ts

@@ -852,7 +852,9 @@ export class SEOTools {
     const titlePercentage = analysis.postsWithSEO > 0 ? (analysis.postsWithTitles / analysis.postsWithSEO) * 100 : 0;
     if (titlePercentage < 80) {
       analysis.recommendations.push(
-        `${Math.round(100 - titlePercentage)}% of SEO-enabled posts lack custom titles. Add SEO titles for better search visibility.`,
+        `${Math.round(
+          100 - titlePercentage,
+        )}% of SEO-enabled posts lack custom titles. Add SEO titles for better search visibility.`,
       );
     }
 
@@ -860,7 +862,9 @@ export class SEOTools {
       analysis.postsWithSEO > 0 ? (analysis.postsWithDescriptions / analysis.postsWithSEO) * 100 : 0;
     if (descPercentage < 80) {
       analysis.recommendations.push(
-        `${Math.round(100 - descPercentage)}% of SEO-enabled posts lack meta descriptions. Add descriptions to improve click-through rates.`,
+        `${Math.round(
+          100 - descPercentage,
+        )}% of SEO-enabled posts lack meta descriptions. Add descriptions to improve click-through rates.`,
       );
     }
 

package/src/tools/seo/analyzers/ContentAnalyzer.ts

@@ -179,7 +179,9 @@ export class ContentAnalyzer {
       recommendations.push({
         type: "content",
         priority: "medium",
-        message: `Content readability is low (${metrics.fleschReadingEase.toFixed(1)}). Consider using shorter sentences and simpler words.`,
+        message: `Content readability is low (${metrics.fleschReadingEase.toFixed(
+          1,
+        )}). Consider using shorter sentences and simpler words.`,
         impact: 60,
         autoFixAvailable: false,
         suggestedFix: "Break up long sentences and use more common vocabulary.",
@@ -195,7 +197,9 @@ export class ContentAnalyzer {
         recommendations.push({
           type: "keyword",
           priority: "medium",
-          message: `Focus keyword density is low (${metrics.keywordDensity.toFixed(1)}%). Consider adding the keyword "${params.focusKeywords[0]}" more naturally throughout the content.`,
+          message: `Focus keyword density is low (${metrics.keywordDensity.toFixed(
+            1,
+          )}%). Consider adding the keyword "${params.focusKeywords[0]}" more naturally throughout the content.`,
           impact: 70,
           autoFixAvailable: false,
         });
@@ -203,7 +207,9 @@ export class ContentAnalyzer {
         recommendations.push({
           type: "keyword",
           priority: "medium",
-          message: `Focus keyword density is too high (${metrics.keywordDensity.toFixed(1)}%). This might be considered keyword stuffing.`,
+          message: `Focus keyword density is too high (${metrics.keywordDensity.toFixed(
+            1,
+          )}%). This might be considered keyword stuffing.`,
           impact: 75,
           autoFixAvailable: false,
           suggestedFix: `Reduce keyword usage to around ${targetDensity}%`,

package/src/types/enhanced.ts

@@ -1,6 +1,6 @@
 /**
  * Enhanced TypeScript Types for MCP WordPress
- * 
+ *
  * This file provides stronger typing, utility types, and generic constraints
  * to improve type safety throughout the codebase.
  */
@@ -13,22 +13,22 @@ export type DeepReadonly<T> = {
   readonly [P in keyof T]: T[P] extends (infer U)[]
     ? DeepReadonlyArray<U>
     : T[P] extends readonly (infer U)[]
-    ? DeepReadonlyArray<U>
-    : T[P] extends object
-    ? DeepReadonly<T[P]>
-    : T[P];
+      ? DeepReadonlyArray<U>
+      : T[P] extends object
+        ? DeepReadonly<T[P]>
+        : T[P];
 };
 
 interface DeepReadonlyArray<T> extends ReadonlyArray<DeepReadonly<T>> {}
 
 // Branded Types for Domain-Specific Values
-export type WordPressId = number & { readonly __brand: 'WordPressId' };
-export type UserId = number & { readonly __brand: 'UserId' };
-export type PostId = number & { readonly __brand: 'PostId' };
-export type MediaId = number & { readonly __brand: 'MediaId' };
-export type CommentId = number & { readonly __brand: 'CommentId' };
-export type CategoryId = number & { readonly __brand: 'CategoryId' };
-export type TagId = number & { readonly __brand: 'TagId' };
+export type WordPressId = number & { readonly __brand: "WordPressId" };
+export type UserId = number & { readonly __brand: "UserId" };
+export type PostId = number & { readonly __brand: "PostId" };
+export type MediaId = number & { readonly __brand: "MediaId" };
+export type CommentId = number & { readonly __brand: "CommentId" };
+export type CategoryId = number & { readonly __brand: "CategoryId" };
+export type TagId = number & { readonly __brand: "TagId" };
 
 // Helper functions to create branded types
 export const createWordPressId = (id: number): WordPressId => {
@@ -46,7 +46,7 @@ export const createCategoryId = (id: number): CategoryId => id as CategoryId;
 export const createTagId = (id: number): TagId => id as TagId;
 
 // Strict URL type
-export type WordPressURL = string & { readonly __brand: 'WordPressURL' };
+export type WordPressURL = string & { readonly __brand: "WordPressURL" };
 export const createWordPressURL = (url: string): WordPressURL => {
   try {
     new URL(url);
@@ -64,13 +64,13 @@ export interface TypedError<TCode extends string = string> extends Error {
   readonly context?: Record<string, unknown>;
 }
 
-export interface ValidationError extends TypedError<'VALIDATION_ERROR'> {
+export interface ValidationError extends TypedError<"VALIDATION_ERROR"> {
   readonly field: string;
   readonly value: unknown;
   readonly constraint: string;
 }
 
-export interface APIError extends TypedError<'API_ERROR'> {
+export interface APIError extends TypedError<"API_ERROR"> {
   readonly endpoint: string;
   readonly method: string;
   readonly statusCode: number;
@@ -108,7 +108,7 @@ export interface RequestConfig {
 }
 
 export interface HTTPRequestOptions extends RequestConfig {
-  readonly method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+  readonly method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
   readonly url: WordPressURL;
   readonly data?: unknown;
   readonly params?: DeepReadonly<Record<string, string | number | boolean>>;
@@ -135,7 +135,7 @@ export interface ToolResult<TData = unknown> {
 
 export type ToolHandler<TInput, TOutput> = (
   input: DeepReadonly<TInput>,
-  context: DeepReadonly<ToolContext>
+  context: DeepReadonly<ToolContext>,
 ) => Promise<ToolResult<TOutput>>;
 
 // Cache Types with Enhanced Type Safety
@@ -156,7 +156,7 @@ export interface CacheEntry<TData> {
 export interface CacheOptions {
   readonly ttl: number;
   readonly tags?: readonly string[];
-  readonly priority?: 'low' | 'medium' | 'high';
+  readonly priority?: "low" | "medium" | "high";
 }
 
 // Configuration Types with Better Validation
@@ -165,7 +165,7 @@ export interface StrictSiteConfig {
   readonly name: string;
   readonly url: WordPressURL;
   readonly auth: DeepReadonly<{
-    readonly method: 'app-password' | 'jwt' | 'basic' | 'api-key';
+    readonly method: "app-password" | "jwt" | "basic" | "api-key";
     readonly username: string;
     readonly password: string;
   }>;
@@ -193,7 +193,7 @@ export interface PerformanceThresholds {
 
 // Type Guards for Runtime Validation
 export const isWordPressId = (value: unknown): value is WordPressId => {
-  return typeof value === 'number' && Number.isInteger(value) && value > 0;
+  return typeof value === "number" && Number.isInteger(value) && value > 0;
 };
 
 export const isNonEmptyArray = <T>(value: unknown): value is NonEmptyArray<T> => {
@@ -201,7 +201,7 @@ export const isNonEmptyArray = <T>(value: unknown): value is NonEmptyArray<T> =>
 };
 
 export const isValidURL = (value: unknown): value is WordPressURL => {
-  if (typeof value !== 'string') return false;
+  if (typeof value !== "string") return false;
   try {
     new URL(value);
     return true;
@@ -216,7 +216,7 @@ export type OptionalFields<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T,
 
 // JSON Schema Type Definitions
 export interface JSONSchemaDefinition {
-  readonly type: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'null';
+  readonly type: "string" | "number" | "boolean" | "object" | "array" | "null";
   readonly description?: string;
   readonly required?: boolean;
   readonly enum?: readonly (string | number)[];
@@ -225,21 +225,21 @@ export interface JSONSchemaDefinition {
   readonly minLength?: number;
   readonly maxLength?: number;
   readonly pattern?: string;
-  readonly format?: 'email' | 'uri' | 'date-time' | 'date' | 'time';
+  readonly format?: "email" | "uri" | "date-time" | "date" | "time";
   readonly items?: JSONSchemaDefinition;
   readonly properties?: DeepReadonly<Record<string, JSONSchemaDefinition>>;
 }
 
 // Enhanced MCP Tool Schema
 export interface StrictMCPToolSchema {
-  readonly type: 'object';
+  readonly type: "object";
   readonly properties: DeepReadonly<Record<string, JSONSchemaDefinition>>;
   readonly required: readonly string[];
   readonly additionalProperties: false;
 }
 
 // Result Types for Better Error Handling
-export type Result<TSuccess, TError = Error> = 
+export type Result<TSuccess, TError = Error> =
   | { readonly success: true; readonly data: TSuccess }
   | { readonly success: false; readonly error: TError };
 
@@ -298,14 +298,14 @@ export interface ConfigValidationResult {
 }
 
 // Performance Monitoring Event Types
-export type PerformanceEventType = 
-  | 'request_started'
-  | 'request_completed' 
-  | 'request_failed'
-  | 'cache_hit'
-  | 'cache_miss'
-  | 'auth_success'
-  | 'auth_failure';
+export type PerformanceEventType =
+  | "request_started"
+  | "request_completed"
+  | "request_failed"
+  | "cache_hit"
+  | "cache_miss"
+  | "auth_success"
+  | "auth_failure";
 
 export interface PerformanceEvent extends DomainEvent<PerformanceEventType> {
   readonly payload: {
@@ -315,4 +315,4 @@ export interface PerformanceEvent extends DomainEvent<PerformanceEventType> {
     readonly cacheKey?: string;
     readonly userId?: UserId;
   };
-}
+}

package/src/types/index.ts

@@ -14,13 +14,13 @@ export * from "./mcp.js";
 export * from "./client.js";
 
 // Enhanced Types (New) - Selective exports to avoid conflicts
-export type { 
-  WordPressId, 
-  PostId, 
-  UserId, 
-  MediaId, 
-  CommentId, 
-  CategoryId, 
+export type {
+  WordPressId,
+  PostId,
+  UserId,
+  MediaId,
+  CommentId,
+  CategoryId,
   TagId,
   Result,
   DeepReadonly,
@@ -28,14 +28,14 @@ export type {
   NonEmptyArray,
   createWordPressId,
   createSuccess,
-  createError
+  createError,
 } from "./enhanced.js";
 
 // Request Types (New)
 export * from "./requests.js";
 
 // Tool Types (New) - Selective exports to avoid conflicts
-export type { 
+export type {
   BaseToolParams,
   CreatePostParams,
   UpdatePostParams,
@@ -48,7 +48,7 @@ export type {
   ListPagesParams,
   DeletePageParams,
   ToolDefinition as EnhancedToolDefinition,
-  ToolRegistry as EnhancedToolRegistry
+  ToolRegistry as EnhancedToolRegistry,
 } from "./tools.js";
 
 // Common Utility Types
@@ -237,7 +237,9 @@ export type CategoryID = Brand<number, "CategoryID">;
 export type TagID = Brand<number, "TagID">;
 
 // Function Types
-export type AsyncFunction<TArgs extends unknown[] = unknown[], TReturn = unknown> = (...args: TArgs) => Promise<TReturn>;
+export type AsyncFunction<TArgs extends unknown[] = unknown[], TReturn = unknown> = (
+  ...args: TArgs
+) => Promise<TReturn>;
 export type SyncFunction<TArgs extends unknown[] = unknown[], TReturn = unknown> = (...args: TArgs) => TReturn;
 export type AnyFunction<TArgs extends unknown[] = unknown[], TReturn = unknown> =
   | SyncFunction<TArgs, TReturn>

package/src/types/requests.ts

@@ -1,15 +1,15 @@
 /**
  * Enhanced Request Types for WordPress API Client
- * 
- * This file provides strongly-typed request interfaces to replace 
+ *
+ * This file provides strongly-typed request interfaces to replace
  * loose typing throughout the codebase.
  */
 
-import type { DeepReadonly } from './enhanced.js';
+import type { DeepReadonly } from "./enhanced.js";
 
 // Generic HTTP Request Structure
 export interface HTTPRequestConfig {
-  readonly method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+  readonly method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
   readonly url: string;
   readonly headers?: DeepReadonly<Record<string, string>>;
   readonly timeout?: number;
@@ -32,7 +32,7 @@ export interface QueuedRequest {
   readonly id: string;
   readonly config: HTTPRequestFull;
   readonly timestamp: Date;
-  readonly priority: 'low' | 'medium' | 'high';
+  readonly priority: "low" | "medium" | "high";
   readonly retries: number;
   readonly maxRetries: number;
 }
@@ -84,7 +84,7 @@ export interface ErrorResponse {
 
 // Authentication Request Types
 export interface AuthenticationRequest {
-  readonly method: 'app-password' | 'jwt' | 'basic' | 'api-key' | 'cookie';
+  readonly method: "app-password" | "jwt" | "basic" | "api-key" | "cookie";
   readonly credentials: DeepReadonly<{
     readonly username?: string;
     readonly password?: string;
@@ -108,11 +108,11 @@ export interface AuthenticationResponse {
 
 // WordPress Specific Request Types
 export interface WordPressQueryParams {
-  readonly context?: 'view' | 'embed' | 'edit';
+  readonly context?: "view" | "embed" | "edit";
   readonly page?: number;
   readonly per_page?: number;
   readonly search?: string;
-  readonly order?: 'asc' | 'desc';
+  readonly order?: "asc" | "desc";
   readonly orderby?: string;
   readonly offset?: number;
   readonly include?: readonly number[];
@@ -137,14 +137,14 @@ export interface PostSpecificParams extends WordPressQueryParams {
 export interface MediaSpecificParams extends WordPressQueryParams {
   readonly parent?: number;
   readonly parent_exclude?: readonly number[];
-  readonly media_type?: 'image' | 'video' | 'text' | 'application' | 'audio';
+  readonly media_type?: "image" | "video" | "text" | "application" | "audio";
   readonly mime_type?: string;
 }
 
 export interface UserSpecificParams extends WordPressQueryParams {
   readonly roles?: readonly string[];
   readonly capabilities?: readonly string[];
-  readonly who?: 'authors';
+  readonly who?: "authors";
   readonly has_published_posts?: readonly string[];
 }
 
@@ -153,14 +153,14 @@ export interface CommentSpecificParams extends WordPressQueryParams {
   readonly parent?: readonly number[];
   readonly parent_exclude?: readonly number[];
   readonly post?: readonly number[];
-  readonly type?: 'comment' | 'trackback' | 'pingback';
+  readonly type?: "comment" | "trackback" | "pingback";
   readonly password?: string;
 }
 
 // Batch Request Types
 export interface BatchOperation<TParams = unknown> {
   readonly id: string;
-  readonly method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+  readonly method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
   readonly endpoint: string;
   readonly params?: TParams;
   readonly data?: unknown;
@@ -222,7 +222,7 @@ export interface PaginatedResponse<TData> {
 // Search Request Types
 export interface SearchRequest {
   readonly query: string;
-  readonly type?: readonly ('post' | 'page' | 'attachment' | 'user' | 'comment')[];
+  readonly type?: readonly ("post" | "page" | "attachment" | "user" | "comment")[];
   readonly subtype?: readonly string[];
   readonly include?: readonly number[];
   readonly exclude?: readonly number[];
@@ -253,7 +253,7 @@ export interface UploadRequest {
   readonly description?: string;
   readonly post?: number;
   readonly author?: number;
-  readonly status?: 'publish' | 'future' | 'draft' | 'pending' | 'private';
+  readonly status?: "publish" | "future" | "draft" | "pending" | "private";
   readonly date?: string;
   readonly date_gmt?: string;
 }
@@ -292,7 +292,7 @@ export interface RateLimitState {
 }
 
 export interface RateLimitedRequest extends HTTPRequestFull {
-  readonly priority: 'low' | 'medium' | 'high';
+  readonly priority: "low" | "medium" | "high";
   readonly rateLimitKey?: string;
 }
 
@@ -300,7 +300,7 @@ export interface RateLimitedRequest extends HTTPRequestFull {
 export interface CacheableRequest extends HTTPRequestConfig {
   readonly cacheKey?: string;
   readonly cacheTTL?: number;
-  readonly cacheStrategy?: 'cache-first' | 'network-first' | 'cache-only' | 'network-only';
+  readonly cacheStrategy?: "cache-first" | "network-first" | "cache-only" | "network-only";
   readonly invalidateCache?: boolean;
   readonly cacheTags?: readonly string[];
 }
@@ -338,7 +338,7 @@ export interface HealthCheckRequest {
 }
 
 export interface HealthCheckResponse {
-  readonly status: 'healthy' | 'degraded' | 'unhealthy';
+  readonly status: "healthy" | "degraded" | "unhealthy";
   readonly responseTime: number;
   readonly statusCode: number;
   readonly timestamp: Date;
@@ -353,7 +353,7 @@ export interface HealthCheckResponse {
 export interface RequestValidationRule {
   readonly field: string;
   readonly required: boolean;
-  readonly type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+  readonly type: "string" | "number" | "boolean" | "array" | "object";
   readonly minLength?: number;
   readonly maxLength?: number;
   readonly pattern?: RegExp;
@@ -375,4 +375,4 @@ export interface RequestValidationResult {
     readonly code: string;
   }[];
   readonly sanitizedData?: unknown;
-}
+}