mcp-wordpress 1.2.2 → 1.3.0

package/src/types/client.ts

@@ -1,14 +1,14 @@
 /**
  * WordPress API Client Types
- * 
+ *
  * TypeScript definitions for the WordPress REST API client
  */
 
-import type { 
-  WordPressPost, 
-  WordPressPage, 
-  WordPressMedia, 
-  WordPressUser, 
+import type {
+  WordPressPost,
+  WordPressPage,
+  WordPressMedia,
+  WordPressUser,
   WordPressComment,
   WordPressCategory,
   WordPressTag,
@@ -31,11 +31,16 @@ import type {
   CreateTagRequest,
   UpdateTagRequest,
   UploadMediaRequest,
-  UpdateMediaRequest
-} from './wordpress.js';
+  UpdateMediaRequest,
+} from "./wordpress.js";
 
 // Authentication Configuration
-export type AuthMethod = 'app-password' | 'jwt' | 'basic' | 'api-key' | 'cookie';
+export type AuthMethod =
+  | "app-password"
+  | "jwt"
+  | "basic"
+  | "api-key"
+  | "cookie";
 
 export interface AuthConfig {
   method: AuthMethod;
@@ -64,7 +69,7 @@ export interface WordPressClientConfig {
 }
 
 // HTTP Method Types
-export type HTTPMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+export type HTTPMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
 
 // Request Options
 export interface RequestOptions {
@@ -115,71 +120,151 @@ export interface IWordPressClient {
   disconnect(): Promise<void>;
 
   // Generic HTTP Methods
-  request<T = any>(method: HTTPMethod, endpoint: string, data?: any, options?: RequestOptions): Promise<T>;
+  request<T = any>(
+    method: HTTPMethod,
+    endpoint: string,
+    data?: any,
+    options?: RequestOptions,
+  ): Promise<T>;
   get<T = any>(endpoint: string, options?: RequestOptions): Promise<T>;
-  post<T = any>(endpoint: string, data?: any, options?: RequestOptions): Promise<T>;
-  put<T = any>(endpoint: string, data?: any, options?: RequestOptions): Promise<T>;
-  patch<T = any>(endpoint: string, data?: any, options?: RequestOptions): Promise<T>;
+  post<T = any>(
+    endpoint: string,
+    data?: any,
+    options?: RequestOptions,
+  ): Promise<T>;
+  put<T = any>(
+    endpoint: string,
+    data?: any,
+    options?: RequestOptions,
+  ): Promise<T>;
+  patch<T = any>(
+    endpoint: string,
+    data?: any,
+    options?: RequestOptions,
+  ): Promise<T>;
   delete<T = any>(endpoint: string, options?: RequestOptions): Promise<T>;
 
   // Posts
   getPosts(params?: PostQueryParams): Promise<WordPressPost[]>;
-  getPost(id: number, context?: 'view' | 'embed' | 'edit'): Promise<WordPressPost>;
+  getPost(
+    id: number,
+    context?: "view" | "embed" | "edit",
+  ): Promise<WordPressPost>;
   createPost(data: CreatePostRequest): Promise<WordPressPost>;
   updatePost(data: UpdatePostRequest): Promise<WordPressPost>;
-  deletePost(id: number, force?: boolean): Promise<{ deleted: boolean; previous?: WordPressPost }>;
+  deletePost(
+    id: number,
+    force?: boolean,
+  ): Promise<{ deleted: boolean; previous?: WordPressPost }>;
   getPostRevisions(id: number): Promise<WordPressPost[]>;
 
   // Pages
   getPages(params?: PostQueryParams): Promise<WordPressPage[]>;
-  getPage(id: number, context?: 'view' | 'embed' | 'edit'): Promise<WordPressPage>;
+  getPage(
+    id: number,
+    context?: "view" | "embed" | "edit",
+  ): Promise<WordPressPage>;
   createPage(data: CreatePageRequest): Promise<WordPressPage>;
   updatePage(data: UpdatePageRequest): Promise<WordPressPage>;
-  deletePage(id: number, force?: boolean): Promise<{ deleted: boolean; previous?: WordPressPage }>;
+  deletePage(
+    id: number,
+    force?: boolean,
+  ): Promise<{ deleted: boolean; previous?: WordPressPage }>;
   getPageRevisions(id: number): Promise<WordPressPage[]>;
 
   // Media
   getMedia(params?: MediaQueryParams): Promise<WordPressMedia[]>;
-  getMediaItem(id: number, context?: 'view' | 'embed' | 'edit'): Promise<WordPressMedia>;
+  getMediaItem(
+    id: number,
+    context?: "view" | "embed" | "edit",
+  ): Promise<WordPressMedia>;
   uploadMedia(data: UploadMediaRequest): Promise<WordPressMedia>;
-  uploadFile(fileData: Buffer, filename: string, mimeType: string, meta?: Partial<UploadMediaRequest>, options?: RequestOptions): Promise<WordPressMedia>;
+  uploadFile(
+    fileData: Buffer,
+    filename: string,
+    mimeType: string,
+    meta?: Partial<UploadMediaRequest>,
+    options?: RequestOptions,
+  ): Promise<WordPressMedia>;
   updateMedia(data: UpdateMediaRequest): Promise<WordPressMedia>;
-  deleteMedia(id: number, force?: boolean): Promise<{ deleted: boolean; previous?: WordPressMedia }>;
+  deleteMedia(
+    id: number,
+    force?: boolean,
+  ): Promise<{ deleted: boolean; previous?: WordPressMedia }>;
 
   // Users
   getUsers(params?: UserQueryParams): Promise<WordPressUser[]>;
-  getUser(id: number | 'me', context?: 'view' | 'embed' | 'edit'): Promise<WordPressUser>;
+  getUser(
+    id: number | "me",
+    context?: "view" | "embed" | "edit",
+  ): Promise<WordPressUser>;
   createUser(data: CreateUserRequest): Promise<WordPressUser>;
   updateUser(data: UpdateUserRequest): Promise<WordPressUser>;
-  deleteUser(id: number, reassign?: number): Promise<{ deleted: boolean; previous?: WordPressUser }>;
+  deleteUser(
+    id: number,
+    reassign?: number,
+  ): Promise<{ deleted: boolean; previous?: WordPressUser }>;
   getCurrentUser(): Promise<WordPressUser>;
 
   // Comments
   getComments(params?: CommentQueryParams): Promise<WordPressComment[]>;
-  getComment(id: number, context?: 'view' | 'embed' | 'edit'): Promise<WordPressComment>;
+  getComment(
+    id: number,
+    context?: "view" | "embed" | "edit",
+  ): Promise<WordPressComment>;
   createComment(data: CreateCommentRequest): Promise<WordPressComment>;
   updateComment(data: UpdateCommentRequest): Promise<WordPressComment>;
-  deleteComment(id: number, force?: boolean): Promise<{ deleted: boolean; previous?: WordPressComment }>;
+  deleteComment(
+    id: number,
+    force?: boolean,
+  ): Promise<{ deleted: boolean; previous?: WordPressComment }>;
   approveComment(id: number): Promise<WordPressComment>;
   rejectComment(id: number): Promise<WordPressComment>;
   spamComment(id: number): Promise<WordPressComment>;
 
   // Taxonomies
-  getCategories(params?: { search?: string; exclude?: number[]; include?: number[]; order?: 'asc' | 'desc'; orderby?: string; hide_empty?: boolean; parent?: number; post?: number; slug?: string }): Promise<WordPressCategory[]>;
+  getCategories(params?: {
+    search?: string;
+    exclude?: number[];
+    include?: number[];
+    order?: "asc" | "desc";
+    orderby?: string;
+    hide_empty?: boolean;
+    parent?: number;
+    post?: number;
+    slug?: string;
+  }): Promise<WordPressCategory[]>;
   getCategory(id: number): Promise<WordPressCategory>;
   createCategory(data: CreateCategoryRequest): Promise<WordPressCategory>;
   updateCategory(data: UpdateCategoryRequest): Promise<WordPressCategory>;
-  deleteCategory(id: number, force?: boolean): Promise<{ deleted: boolean; previous?: WordPressCategory }>;
-
-  getTags(params?: { search?: string; exclude?: number[]; include?: number[]; order?: 'asc' | 'desc'; orderby?: string; hide_empty?: boolean; post?: number; slug?: string }): Promise<WordPressTag[]>;
+  deleteCategory(
+    id: number,
+    force?: boolean,
+  ): Promise<{ deleted: boolean; previous?: WordPressCategory }>;
+
+  getTags(params?: {
+    search?: string;
+    exclude?: number[];
+    include?: number[];
+    order?: "asc" | "desc";
+    orderby?: string;
+    hide_empty?: boolean;
+    post?: number;
+    slug?: string;
+  }): Promise<WordPressTag[]>;
   getTag(id: number): Promise<WordPressTag>;
   createTag(data: CreateTagRequest): Promise<WordPressTag>;
   updateTag(data: UpdateTagRequest): Promise<WordPressTag>;
-  deleteTag(id: number, force?: boolean): Promise<{ deleted: boolean; previous?: WordPressTag }>;
+  deleteTag(
+    id: number,
+    force?: boolean,
+  ): Promise<{ deleted: boolean; previous?: WordPressTag }>;
 
   // Site Management
   getSiteSettings(): Promise<WordPressSiteSettings>;
-  updateSiteSettings(settings: Partial<WordPressSiteSettings>): Promise<WordPressSiteSettings>;
+  updateSiteSettings(
+    settings: Partial<WordPressSiteSettings>,
+  ): Promise<WordPressSiteSettings>;
   getSiteInfo(): Promise<{
     name: string;
     description: string;
@@ -193,18 +278,33 @@ export interface IWordPressClient {
   }>;
 
   // Application Passwords
-  getApplicationPasswords(userId?: number | 'me'): Promise<WordPressApplicationPassword[]>;
-  createApplicationPassword(userId: number | 'me', name: string, appId?: string): Promise<WordPressApplicationPassword>;
-  deleteApplicationPassword(userId: number | 'me', uuid: string): Promise<{ deleted: boolean }>;
+  getApplicationPasswords(
+    userId?: number | "me",
+  ): Promise<WordPressApplicationPassword[]>;
+  createApplicationPassword(
+    userId: number | "me",
+    name: string,
+    appId?: string,
+  ): Promise<WordPressApplicationPassword>;
+  deleteApplicationPassword(
+    userId: number | "me",
+    uuid: string,
+  ): Promise<{ deleted: boolean }>;
 
   // Search
-  search(query: string, types?: string[], subtype?: string): Promise<Array<{
-    id: number;
-    title: string;
-    url: string;
-    type: string;
-    subtype: string;
-  }>>;
+  search(
+    query: string,
+    types?: string[],
+    subtype?: string,
+  ): Promise<
+    Array<{
+      id: number;
+      title: string;
+      url: string;
+      type: string;
+      subtype: string;
+    }>
+  >;
 
   // Utility Methods
   ping(): Promise<boolean>;
@@ -228,14 +328,9 @@ export class WordPressAPIError extends Error {
   public readonly code?: string;
   public data?: any;
 
-  constructor(
-    message: string,
-    statusCode?: number,
-    code?: string,
-    data?: any
-  ) {
+  constructor(message: string, statusCode?: number, code?: string, data?: any) {
     super(message);
-    this.name = 'WordPressAPIError';
+    this.name = "WordPressAPIError";
     if (statusCode !== undefined) this.statusCode = statusCode;
     if (code !== undefined) this.code = code;
     if (data !== undefined) this.data = data;
@@ -244,24 +339,24 @@ export class WordPressAPIError extends Error {
 
 export class AuthenticationError extends WordPressAPIError {
   constructor(message: string, method: AuthMethod) {
-    super(message, 401, 'authentication_failed');
-    this.name = 'AuthenticationError';
+    super(message, 401, "authentication_failed");
+    this.name = "AuthenticationError";
     this.data = { method };
   }
 }
 
 export class RateLimitError extends WordPressAPIError {
   constructor(message: string, resetTime: number) {
-    super(message, 429, 'rate_limit_exceeded');
-    this.name = 'RateLimitError';
+    super(message, 429, "rate_limit_exceeded");
+    this.name = "RateLimitError";
     this.data = { resetTime };
   }
 }
 
 export class ValidationError extends WordPressAPIError {
   constructor(message: string, field?: string) {
-    super(message, 400, 'validation_failed');
-    this.name = 'ValidationError';
+    super(message, 400, "validation_failed");
+    this.name = "ValidationError";
     this.data = { field };
   }
 }
@@ -271,7 +366,9 @@ export function isWordPressAPIError(error: any): error is WordPressAPIError {
   return error instanceof WordPressAPIError;
 }
 
-export function isAuthenticationError(error: any): error is AuthenticationError {
+export function isAuthenticationError(
+  error: any,
+): error is AuthenticationError {
   return error instanceof AuthenticationError;
 }
 
@@ -285,21 +382,21 @@ export function isValidationError(error: any): error is ValidationError {
 
 // Response Type Guards
 export function isWordPressPost(obj: any): obj is WordPressPost {
-  return obj && typeof obj.id === 'number' && obj.type === 'post';
+  return obj && typeof obj.id === "number" && obj.type === "post";
 }
 
 export function isWordPressPage(obj: any): obj is WordPressPage {
-  return obj && typeof obj.id === 'number' && obj.type === 'page';
+  return obj && typeof obj.id === "number" && obj.type === "page";
 }
 
 export function isWordPressMedia(obj: any): obj is WordPressMedia {
-  return obj && typeof obj.id === 'number' && obj.media_type;
+  return obj && typeof obj.id === "number" && obj.media_type;
 }
 
 export function isWordPressUser(obj: any): obj is WordPressUser {
-  return obj && typeof obj.id === 'number' && obj.username;
+  return obj && typeof obj.id === "number" && obj.username;
 }
 
 export function isWordPressComment(obj: any): obj is WordPressComment {
-  return obj && typeof obj.id === 'number' && typeof obj.post === 'number';
+  return obj && typeof obj.id === "number" && typeof obj.post === "number";
 }

package/src/types/index.ts

@@ -1,17 +1,17 @@
 /**
  * Type Exports
- * 
+ *
  * Central export point for all TypeScript types
  */
 
 // WordPress API Types
-export * from './wordpress.js';
+export * from "./wordpress.js";
 
 // MCP Types
-export * from './mcp.js';
+export * from "./mcp.js";
 
 // Client Types
-export * from './client.js';
+export * from "./client.js";
 
 // Common Utility Types
 export type Optional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
@@ -74,16 +74,16 @@ export interface DatabaseConfig {
 }
 
 export interface LoggingConfig {
-  level: 'debug' | 'info' | 'warn' | 'error';
+  level: "debug" | "info" | "warn" | "error";
   file?: string;
   console?: boolean;
-  format?: 'json' | 'text';
+  format?: "json" | "text";
 }
 
 export interface ServerConfig {
   host: string;
   port: number;
-  env: 'development' | 'production' | 'test';
+  env: "development" | "production" | "test";
   debug: boolean;
   logging: LoggingConfig;
 }
@@ -104,7 +104,16 @@ export interface Environment {
 
 // Validation Schema Types
 export interface ValidationRule {
-  type: 'required' | 'string' | 'number' | 'boolean' | 'email' | 'url' | 'enum' | 'array' | 'object';
+  type:
+    | "required"
+    | "string"
+    | "number"
+    | "boolean"
+    | "email"
+    | "url"
+    | "enum"
+    | "array"
+    | "object";
   message?: string;
   min?: number;
   max?: number;
@@ -127,7 +136,7 @@ export interface CacheEntry<T> {
 export interface CacheOptions {
   ttl?: number; // time to live in milliseconds
   maxSize?: number;
-  strategy?: 'lru' | 'fifo' | 'ttl';
+  strategy?: "lru" | "fifo" | "ttl";
 }
 
 // Event Types
@@ -149,13 +158,16 @@ export interface PerformanceMetric {
 
 // Health Check Types
 export interface HealthStatus {
-  status: 'healthy' | 'degraded' | 'unhealthy';
+  status: "healthy" | "degraded" | "unhealthy";
   timestamp: number;
-  checks: Record<string, {
-    status: 'pass' | 'fail' | 'warn';
-    message?: string;
-    duration?: number;
-  }>;
+  checks: Record<
+    string,
+    {
+      status: "pass" | "fail" | "warn";
+      message?: string;
+      duration?: number;
+    }
+  >;
   uptime: number;
   version: string;
 }
@@ -163,7 +175,7 @@ export interface HealthStatus {
 // Debugging Types
 export interface DebugInfo {
   timestamp: number;
-  level: 'debug' | 'info' | 'warn' | 'error';
+  level: "debug" | "info" | "warn" | "error";
   message: string;
   context?: Record<string, any>;
   stack?: string;
@@ -187,21 +199,31 @@ export type Awaited<T> = T extends Promise<infer U> ? U : T;
 // Brand types for better type safety
 export type Brand<T, B> = T & { __brand: B };
 
-export type WordPressID = Brand<number, 'WordPressID'>;
-export type UserID = Brand<number, 'UserID'>;
-export type PostID = Brand<number, 'PostID'>;
-export type MediaID = Brand<number, 'MediaID'>;
-export type CommentID = Brand<number, 'CommentID'>;
-export type CategoryID = Brand<number, 'CategoryID'>;
-export type TagID = Brand<number, 'TagID'>;
+export type WordPressID = Brand<number, "WordPressID">;
+export type UserID = Brand<number, "UserID">;
+export type PostID = Brand<number, "PostID">;
+export type MediaID = Brand<number, "MediaID">;
+export type CommentID = Brand<number, "CommentID">;
+export type CategoryID = Brand<number, "CategoryID">;
+export type TagID = Brand<number, "TagID">;
 
 // Function Types
-export type AsyncFunction<TArgs extends any[] = any[], TReturn = any> = (...args: TArgs) => Promise<TReturn>;
-export type SyncFunction<TArgs extends any[] = any[], TReturn = any> = (...args: TArgs) => TReturn;
-export type AnyFunction<TArgs extends any[] = any[], TReturn = any> = SyncFunction<TArgs, TReturn> | AsyncFunction<TArgs, TReturn>;
+export type AsyncFunction<TArgs extends any[] = any[], TReturn = any> = (
+  ...args: TArgs
+) => Promise<TReturn>;
+export type SyncFunction<TArgs extends any[] = any[], TReturn = any> = (
+  ...args: TArgs
+) => TReturn;
+export type AnyFunction<TArgs extends any[] = any[], TReturn = any> =
+  | SyncFunction<TArgs, TReturn>
+  | AsyncFunction<TArgs, TReturn>;
 
 // Conditional Types
 export type If<C extends boolean, T, F> = C extends true ? T : F;
 export type IsEqual<T, U> = T extends U ? (U extends T ? true : false) : false;
 export type IsArray<T> = T extends any[] ? true : false;
-export type IsObject<T> = T extends object ? (T extends any[] ? false : true) : false;
+export type IsObject<T> = T extends object
+  ? T extends any[]
+    ? false
+    : true
+  : false;

package/src/types/mcp.ts

@@ -6,19 +6,19 @@
 
 import type {
   CallToolRequestSchema,
-  ListToolsRequestSchema
-} from '@modelcontextprotocol/sdk/types.js';
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
 
 // MCP Tool Schema Types
 export interface MCPToolSchema {
-  type: 'object';
+  type: "object";
   properties: Record<string, JSONSchemaProperty>;
   required?: string[];
   additionalProperties?: boolean;
 }
 
 export interface JSONSchemaProperty {
-  type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+  type: "string" | "number" | "boolean" | "array" | "object";
   description?: string;
   enum?: (string | number)[];
   items?: JSONSchemaProperty;
@@ -41,18 +41,18 @@ export interface MCPTool {
 
 // MCP Content Types
 export interface MCPTextContent {
-  type: 'text';
+  type: "text";
   text: string;
 }
 
 export interface MCPImageContent {
-  type: 'image';
+  type: "image";
   data: string;
   mimeType: string;
 }
 
 export interface MCPResourceContent {
-  type: 'resource';
+  type: "resource";
   resource: {
     uri: string;
     mimeType?: string;
@@ -94,14 +94,14 @@ export type MCPCallToolRequest = typeof CallToolRequestSchema;
 
 // Tool Categories for Organization
 export type MCPToolCategory =
-  | 'authentication'
-  | 'posts'
-  | 'pages'
-  | 'media'
-  | 'users'
-  | 'comments'
-  | 'taxonomies'
-  | 'site';
+  | "authentication"
+  | "posts"
+  | "pages"
+  | "media"
+  | "users"
+  | "comments"
+  | "taxonomies"
+  | "site";
 
 // Enhanced Tool Definition with Category
 export interface CategorizedMCPTool extends MCPTool {