mcp-wordpress 2.4.2 → 2.5.0

package/dist/tools/posts.d.ts

@@ -1,251 +1,15 @@
-import { WordPressClient } from "../client/api.js";
-import { CreatePostRequest, PostQueryParams, UpdatePostRequest } from "../types/wordpress.js";
 /**
- * Provides comprehensive tools for managing WordPress posts.
+ * WordPress Posts Tools - Legacy Import Module
  *
- * This class encapsulates tool definitions and their corresponding handlers for:
- * - Listing posts with advanced filtering and search capabilities
- * - Creating new posts with full metadata support
- * - Updating existing posts with validation
- * - Deleting posts with trash/permanent options
- * - Retrieving individual posts with detailed information
- * - Managing post revisions and history
+ * This file maintains backward compatibility while the codebase transitions
+ * to the new modular structure. The actual implementation has been refactored
+ * into focused modules under ./posts/ directory.
  *
- * @example
- * ```typescript
- * const postTools = new PostTools();
- * const tools = postTools.getTools();
- *
- * // Use with a WordPress client
- * const client = new WordPressClient(config);
- * const result = await postTools.handleListPosts(client, { per_page: 10 });
- * ```
- *
- * @since 1.0.0
- * @author MCP WordPress Team
+ * @deprecated Use direct imports from ./posts/ modules instead
+ * @see ./posts/index.ts for the new modular implementation
  */
-export declare class PostTools {
-    /**
-     * Retrieves the complete list of post management tools available for MCP.
-     *
-     * Returns an array of tool definitions that can be registered with an MCP server.
-     * Each tool includes comprehensive parameter validation, error handling, and
-     * detailed documentation with usage examples.
-     *
-     * @returns {Array<MCPTool>} An array of MCPTool definitions for post management
-     *
-     * @example
-     * ```typescript
-     * const postTools = new PostTools();
-     * const tools = postTools.getTools();
-     * console.log(tools.length); // 6 tools: list, get, create, update, delete, revisions
-     * ```
-     */
-    getTools(): any[];
-    /**
-     * Handles listing posts from a WordPress site with comprehensive filtering options.
-     *
-     * This method provides advanced search capabilities, status filtering, pagination,
-     * and category/tag filtering. Results include enhanced metadata and author information.
-     * For large result sets (>50 posts), it automatically uses streaming for better performance.
-     *
-     * @param {WordPressClient} client - The WordPress client instance for API communication
-     * @param {PostQueryParams} params - Query parameters for filtering and pagination
-     * @param {number} [params.per_page=10] - Number of posts to return per page (max 100)
-     * @param {string} [params.search] - Search term to filter posts by title/content
-     * @param {string|string[]} [params.status] - Post status filter (publish, draft, etc.)
-     * @param {number[]} [params.categories] - Array of category IDs to filter by
-     * @param {number[]} [params.tags] - Array of tag IDs to filter by
-     * @param {number} [params.page=1] - Page number for pagination
-     *
-     * @returns {Promise<string>} Formatted list of posts with metadata and context
-     *
-     * @throws {EnhancedError} When validation fails or API request encounters an error
-     *
-     * @example
-     * ```typescript
-     * // Basic listing
-     * const result = await handleListPosts(client, {});
-     *
-     * // Advanced filtering
-     * const filtered = await handleListPosts(client, {
-     *   search: "WordPress tips",
-     *   status: "publish",
-     *   categories: [1, 2],
-     *   per_page: 20
-     * });
-     * ```
-     *
-     * @since 1.0.0
-     */
-    handleListPosts(client: WordPressClient, params: PostQueryParams): Promise<any>;
-    /**
-     * Retrieves a single WordPress post by ID with complete details and metadata.
-     *
-     * This method fetches a specific post and returns comprehensive information including
-     * content, metadata, author details, categories, tags, and publication status.
-     *
-     * @param {WordPressClient} client - The WordPress client instance for API communication
-     * @param {Object} params - Parameters for post retrieval
-     * @param {number} params.id - The unique ID of the post to retrieve
-     *
-     * @returns {Promise<string>} Detailed post information formatted for display
-     *
-     * @throws {EnhancedError} When post ID is invalid or post is not found
-     *
-     * @example
-     * ```typescript
-     * // Get a specific post
-     * const post = await handleGetPost(client, { id: 123 });
-     * ```
-     *
-     * @since 1.0.0
-     */
-    handleGetPost(client: WordPressClient, params: {
-        id: number;
-    }): Promise<any>;
-    /**
-     * Creates a new WordPress post with comprehensive validation and metadata support.
-     *
-     * This method handles the creation of new posts with full support for content,
-     * metadata, categories, tags, and publishing options. Includes automatic validation
-     * and sanitization of all input parameters.
-     *
-     * @param {WordPressClient} client - The WordPress client instance for API communication
-     * @param {CreatePostRequest} params - Post creation parameters
-     * @param {string} params.title - The post title
-     * @param {string} params.content - The post content in HTML format
-     * @param {string} [params.status="draft"] - Post status (publish, draft, pending, private)
-     * @param {string} [params.excerpt] - Post excerpt/summary
-     * @param {number[]} [params.categories] - Array of category IDs to assign
-     * @param {number[]} [params.tags] - Array of tag IDs to assign
-     *
-     * @returns {Promise<string>} Success message with the new post ID and details
-     *
-     * @throws {EnhancedError} When validation fails or post creation encounters an error
-     *
-     * @example
-     * ```typescript
-     * // Create a basic post
-     * const result = await handleCreatePost(client, {
-     *   title: "My New Post",
-     *   content: "<p>This is the post content.</p>",
-     *   status: "publish"
-     * });
-     *
-     * // Create post with categories and tags
-     * const detailed = await handleCreatePost(client, {
-     *   title: "WordPress Tips",
-     *   content: "<p>Detailed WordPress tips...</p>",
-     *   categories: [1, 2],
-     *   tags: [5, 6],
-     *   excerpt: "Learn essential WordPress tips"
-     * });
-     * ```
-     *
-     * @since 1.0.0
-     */
-    handleCreatePost(client: WordPressClient, params: CreatePostRequest): Promise<any>;
-    /**
-     * Updates an existing WordPress post with validation and detailed confirmation.
-     *
-     * This method allows updating any aspect of a post including title, content, status,
-     * categories, and tags. Only provided fields are updated, leaving others unchanged.
-     *
-     * @param {WordPressClient} client - The WordPress client instance for API communication
-     * @param {UpdatePostRequest & {id: number}} params - Update parameters
-     * @param {number} params.id - The ID of the post to update
-     * @param {string} [params.title] - New post title
-     * @param {string} [params.content] - New post content in HTML format
-     * @param {string} [params.status] - New post status (publish, draft, pending, private)
-     * @param {string} [params.excerpt] - New post excerpt
-     * @param {number[]} [params.categories] - New category IDs to assign
-     * @param {number[]} [params.tags] - New tag IDs to assign
-     *
-     * @returns {Promise<string>} Success message confirming the update
-     *
-     * @throws {EnhancedError} When post ID is invalid or update fails
-     *
-     * @example
-     * ```typescript
-     * // Update post title and status
-     * const result = await handleUpdatePost(client, {
-     *   id: 123,
-     *   title: "Updated Post Title",
-     *   status: "publish"
-     * });
-     *
-     * // Update content and categories
-     * const updated = await handleUpdatePost(client, {
-     *   id: 123,
-     *   content: "<p>New content here...</p>",
-     *   categories: [1, 3, 5]
-     * });
-     * ```
-     *
-     * @since 1.0.0
-     */
-    handleUpdatePost(client: WordPressClient, params: UpdatePostRequest & {
-        id: number;
-    }): Promise<any>;
-    /**
-     * Deletes a WordPress post with options for trash or permanent deletion.
-     *
-     * This method provides safe deletion with trash option (default) or permanent
-     * deletion when force is specified. Includes confirmation of the deletion action.
-     *
-     * @param {WordPressClient} client - The WordPress client instance for API communication
-     * @param {Object} params - Deletion parameters
-     * @param {number} params.id - The ID of the post to delete
-     * @param {boolean} [params.force=false] - Whether to permanently delete (true) or move to trash (false)
-     *
-     * @returns {Promise<string>} Confirmation message of the deletion action
-     *
-     * @throws {EnhancedError} When post ID is invalid or deletion fails
-     *
-     * @example
-     * ```typescript
-     * // Move post to trash (safe deletion)
-     * const result = await handleDeletePost(client, { id: 123 });
-     *
-     * // Permanently delete post (cannot be undone)
-     * const permanent = await handleDeletePost(client, {
-     *   id: 123,
-     *   force: true
-     * });
-     * ```
-     *
-     * @since 1.0.0
-     */
-    handleDeletePost(client: WordPressClient, params: {
-        id: number;
-        force?: boolean;
-    }): Promise<any>;
-    /**
-     * Retrieves revision history for a specific WordPress post.
-     *
-     * This method fetches all available revisions for a post, providing a complete
-     * history of changes including dates, authors, and modification details.
-     *
-     * @param {WordPressClient} client - The WordPress client instance for API communication
-     * @param {Object} params - Parameters for revision retrieval
-     * @param {number} params.id - The ID of the post to get revisions for
-     *
-     * @returns {Promise<string>} Formatted list of post revisions with details
-     *
-     * @throws {EnhancedError} When post ID is invalid or revisions cannot be retrieved
-     *
-     * @example
-     * ```typescript
-     * // Get all revisions for a post
-     * const revisions = await handleGetPostRevisions(client, { id: 123 });
-     * ```
-     *
-     * @since 1.0.0
-     */
-    handleGetPostRevisions(client: WordPressClient, params: {
-        id: number;
-    }): Promise<any>;
-}
-export default PostTools;
+export { PostTools as default, PostTools } from "./posts/index.js";
+export type { CreatePostRequest, PostQueryParams, UpdatePostRequest, WordPressPost } from "../types/wordpress.js";
+export { postToolDefinitions } from "./posts/PostToolDefinitions.js";
+export { handleListPosts, handleGetPost, handleCreatePost, handleUpdatePost, handleDeletePost, handleGetPostRevisions, } from "./posts/PostHandlers.js";
 //# sourceMappingURL=posts.d.ts.map

package/dist/tools/posts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"posts.d.ts","sourceRoot":"","sources":["../../src/tools/posts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAM9F;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,SAAS;IACpB;;;;;;;;;;;;;;;OAeG;IACI,QAAQ,IAAI,GAAG,EAAE;IA0KxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACU,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC;IAqM5F;;;;;;;;;;;;;;;;;;;;;OAqBG;IACU,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAkHzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACU,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC;IA2B/F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACU,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,iBAAiB,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAShH;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACU,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAU7G;;;;;;;;;;;;;;;;;;;;;OAqBG;IACU,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;CAgBnG;AAED,eAAe,SAAS,CAAC"}
+{"version":3,"file":"posts.d.ts","sourceRoot":"","sources":["../../src/tools/posts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,SAAS,IAAI,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGnE,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGlH,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EACL,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC"}