mcp-wordpress 2.5.0 → 2.5.1

package/dist/src/cache/HttpCacheWrapper.js

@@ -0,0 +1,283 @@
+/**
+ * HTTP-level caching wrapper with ETags and Cache-Control headers
+ * Implements WordPress REST API caching best practices
+ */
+import { CachePresets } from "./CacheManager.js";
+import * as crypto from "crypto";
+import { LoggerFactory } from "../utils/logger.js";
+/**
+ * HTTP caching wrapper that adds intelligent caching to HTTP requests
+ */
+export class HttpCacheWrapper {
+    cacheManager;
+    siteId;
+    logger = LoggerFactory.cache();
+    constructor(cacheManager, siteId) {
+        this.cacheManager = cacheManager;
+        this.siteId = siteId;
+    }
+    /**
+     * Execute request with intelligent caching
+     */
+    async request(requestFn, options, cacheOptions) {
+        // Only cache GET requests
+        if (options.method.toUpperCase() !== "GET") {
+            return await requestFn();
+        }
+        const cacheKey = this.generateCacheKey(options);
+        const cachedEntry = this.cacheManager.getEntry(cacheKey);
+        // Check for conditional request support
+        if (cachedEntry && this.cacheManager.supportsConditionalRequest(cacheKey)) {
+            const conditionalHeaders = this.cacheManager.getConditionalHeaders(cacheKey);
+            // Add conditional headers to request
+            const requestWithHeaders = {
+                ...options,
+                headers: {
+                    ...options.headers,
+                    ...conditionalHeaders,
+                },
+            };
+            try {
+                const response = await this.executeRequestWithHeaders(requestFn, requestWithHeaders);
+                // 304 Not Modified - return cached data
+                if (response.status === 304) {
+                    return {
+                        data: cachedEntry.value.data,
+                        status: 200,
+                        headers: cachedEntry.value.headers,
+                        cached: true,
+                    };
+                }
+                // Content changed - update cache
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return await this.cacheAndReturn(response, cacheKey, cacheOptions);
+            }
+            catch (error) {
+                // If conditional request fails, try without conditions
+                this.logger.warn("Conditional request failed, falling back to regular request", {
+                    error: error instanceof Error ? error.message : String(error),
+                    siteId: this.siteId
+                });
+            }
+        }
+        // Check for valid cached response
+        const cached = this.cacheManager.get(cacheKey);
+        if (cached) {
+            return {
+                data: cached.data,
+                status: cached.status,
+                headers: cached.headers,
+                cached: true,
+            };
+        }
+        // Execute fresh request
+        const response = await requestFn();
+        return await this.cacheAndReturn(response, cacheKey, cacheOptions);
+    }
+    /**
+     * Invalidate cache for specific endpoint
+     */
+    invalidate(endpoint, params) {
+        const cacheKey = this.cacheManager.generateKey(this.siteId, endpoint, params);
+        this.cacheManager.delete(cacheKey);
+    }
+    /**
+     * Invalidate cache entries matching pattern
+     */
+    invalidatePattern(pattern) {
+        const regex = new RegExp(`${this.siteId}:${pattern}`);
+        return this.cacheManager.clearPattern(regex);
+    }
+    /**
+     * Invalidate all cache for this site
+     */
+    invalidateAll() {
+        return this.cacheManager.clearSite(this.siteId);
+    }
+    /**
+     * Pre-warm cache with data
+     */
+    warm(endpoint, data, params, cacheOptions) {
+        const cacheKey = this.cacheManager.generateKey(this.siteId, endpoint, params);
+        const ttl = cacheOptions?.ttl || this.getDefaultTTL(endpoint);
+        const cachedResponse = {
+            data,
+            status: 200,
+            headers: this.generateCacheHeaders(cacheOptions, endpoint),
+            etag: this.generateETag(data),
+            lastModified: new Date().toUTCString(),
+            cacheControl: cacheOptions?.cacheControl || this.getDefaultCacheControl(endpoint),
+        };
+        this.cacheManager.set(cacheKey, cachedResponse, ttl, cachedResponse.etag, cachedResponse.lastModified);
+    }
+    /**
+     * Get cache statistics for this site
+     */
+    getStats() {
+        return this.cacheManager.getStats();
+    }
+    /**
+     * Generate cache key for request
+     */
+    generateCacheKey(options) {
+        const endpoint = this.extractEndpoint(options.url);
+        return this.cacheManager.generateKey(this.siteId, endpoint, {
+            ...options.params,
+            // Include relevant headers that affect response
+            ...this.extractCacheableHeaders(options.headers),
+        });
+    }
+    /**
+     * Extract endpoint from full URL
+     */
+    extractEndpoint(url) {
+        // Extract the path after /wp-json/wp/v2/
+        const match = url.match(/\/wp-json\/wp\/v2\/(.+?)(?:\?|$)/);
+        return match ? match[1] : url;
+    }
+    /**
+     * Extract headers that affect caching
+     */
+    extractCacheableHeaders(headers) {
+        if (!headers)
+            return {};
+        const cacheableHeaders = {};
+        const relevantHeaders = ["accept", "accept-language", "authorization"];
+        for (const header of relevantHeaders) {
+            if (headers[header]) {
+                cacheableHeaders[header] = headers[header];
+            }
+        }
+        return cacheableHeaders;
+    }
+    /**
+     * Execute request with modified headers
+     */
+    async executeRequestWithHeaders(requestFn, options) {
+        // This is a simplified approach - in practice, you'd need to modify the actual request
+        // The actual implementation would depend on your HTTP client (axios, fetch, etc.)
+        return await requestFn();
+    }
+    /**
+     * Cache response and return with cache metadata
+     */
+    async cacheAndReturn(response, cacheKey, cacheOptions) {
+        // Don't cache error responses (unless specifically configured)
+        if (response.status >= 400) {
+            return response;
+        }
+        const endpoint = this.extractEndpointFromKey(cacheKey);
+        const ttl = cacheOptions?.ttl || this.getDefaultTTL(endpoint);
+        // Generate ETags and cache headers
+        const etag = this.generateETag(response.data);
+        const lastModified = new Date().toUTCString();
+        const cacheControl = cacheOptions?.cacheControl || this.getDefaultCacheControl(endpoint);
+        const cachedResponse = {
+            data: response.data,
+            status: response.status,
+            headers: {
+                ...response.headers,
+                etag: etag,
+                "last-modified": lastModified,
+                "cache-control": cacheControl,
+            },
+            etag,
+            lastModified,
+            cacheControl,
+        };
+        // Store in cache
+        this.cacheManager.set(cacheKey, cachedResponse, ttl, etag, lastModified);
+        return {
+            data: response.data,
+            status: response.status,
+            headers: cachedResponse.headers,
+            cached: false,
+        };
+    }
+    /**
+     * Generate ETag for response data
+     */
+    generateETag(data) {
+        const hash = crypto.createHash("md5").update(JSON.stringify(data)).digest("hex");
+        return `"${hash}"`;
+    }
+    /**
+     * Get default TTL based on endpoint type
+     */
+    getDefaultTTL(endpoint) {
+        // Static data endpoints
+        if (this.isStaticEndpoint(endpoint)) {
+            return CachePresets.STATIC.ttl;
+        }
+        // Semi-static data endpoints
+        if (this.isSemiStaticEndpoint(endpoint)) {
+            return CachePresets.SEMI_STATIC.ttl;
+        }
+        // Session/auth endpoints
+        if (this.isSessionEndpoint(endpoint)) {
+            return CachePresets.SESSION.ttl;
+        }
+        // Default to dynamic for posts, comments, etc.
+        return CachePresets.DYNAMIC.ttl;
+    }
+    /**
+     * Get default Cache-Control header based on endpoint
+     */
+    getDefaultCacheControl(endpoint) {
+        if (this.isStaticEndpoint(endpoint)) {
+            return CachePresets.STATIC.cacheControl;
+        }
+        if (this.isSemiStaticEndpoint(endpoint)) {
+            return CachePresets.SEMI_STATIC.cacheControl;
+        }
+        if (this.isSessionEndpoint(endpoint)) {
+            return CachePresets.SESSION.cacheControl;
+        }
+        return CachePresets.DYNAMIC.cacheControl;
+    }
+    /**
+     * Generate cache headers
+     */
+    generateCacheHeaders(options, endpoint) {
+        const headers = {};
+        if (options?.cacheControl) {
+            headers["cache-control"] = options.cacheControl;
+        }
+        else if (endpoint) {
+            headers["cache-control"] = this.getDefaultCacheControl(endpoint);
+        }
+        if (options?.varyHeaders?.length) {
+            headers["vary"] = options.varyHeaders.join(", ");
+        }
+        return headers;
+    }
+    /**
+     * Check if endpoint contains static data
+     */
+    isStaticEndpoint(endpoint) {
+        const staticEndpoints = ["settings", "types", "statuses"];
+        return staticEndpoints.some((pattern) => endpoint.includes(pattern));
+    }
+    /**
+     * Check if endpoint contains semi-static data
+     */
+    isSemiStaticEndpoint(endpoint) {
+        const semiStaticEndpoints = ["categories", "tags", "users", "taxonomies"];
+        return semiStaticEndpoints.some((pattern) => endpoint.includes(pattern));
+    }
+    /**
+     * Check if endpoint is session-related
+     */
+    isSessionEndpoint(endpoint) {
+        const sessionEndpoints = ["users/me", "application-passwords"];
+        return sessionEndpoints.some((pattern) => endpoint.includes(pattern));
+    }
+    /**
+     * Extract endpoint from cache key
+     */
+    extractEndpointFromKey(cacheKey) {
+        const parts = cacheKey.split(":");
+        return parts[1] || "";
+    }
+}
+//# sourceMappingURL=HttpCacheWrapper.js.map

package/dist/src/cache/HttpCacheWrapper.js.map

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

package/dist/src/cache/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Cache system exports
+ * Provides centralized access to all caching components
+ */
+export { CacheManager, CachePresets } from "./CacheManager.js";
+export { HttpCacheWrapper } from "./HttpCacheWrapper.js";
+export { CacheInvalidation, WordPressCachePatterns, CacheWarmer } from "./CacheInvalidation.js";
+export { CachedWordPressClient } from "../client/CachedWordPressClient.js";
+export type { CacheEntry, CacheStats, CacheConfig } from "./CacheManager.js";
+export type { HttpCacheOptions, CachedResponse, RequestOptions } from "./HttpCacheWrapper.js";
+export type { InvalidationRule, InvalidationEvent } from "./CacheInvalidation.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAE3E,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE7E,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE9F,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/cache/index.js

@@ -0,0 +1,9 @@
+/**
+ * Cache system exports
+ * Provides centralized access to all caching components
+ */
+export { CacheManager, CachePresets } from "./CacheManager.js";
+export { HttpCacheWrapper } from "./HttpCacheWrapper.js";
+export { CacheInvalidation, WordPressCachePatterns, CacheWarmer } from "./CacheInvalidation.js";
+export { CachedWordPressClient } from "../client/CachedWordPressClient.js";
+//# sourceMappingURL=index.js.map

package/dist/src/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/src/client/CachedWordPressClient.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Cached WordPress API Client
+ * Extends the base WordPress client with intelligent caching capabilities and performance monitoring
+ */
+import { WordPressClient } from "./api.js";
+import { CacheManager, type CacheStats } from "../cache/CacheManager.js";
+import type { WordPressClientConfig, HTTPMethod, RequestOptions } from "../types/client.js";
+import type { WordPressPost, WordPressUser, WordPressCategory, WordPressTag, WordPressSiteSettings, PostQueryParams, CreatePostRequest, UpdatePostRequest } from "../types/wordpress.js";
+/**
+ * WordPress client with intelligent caching
+ */
+export declare class CachedWordPressClient extends WordPressClient {
+    private cacheManager;
+    private httpCache;
+    private cacheInvalidation;
+    private siteId;
+    constructor(config: WordPressClientConfig, siteId?: string);
+    /**
+     * Override request method to add caching
+     */
+    request<T = unknown>(method: HTTPMethod, endpoint: string, data?: unknown, options?: RequestOptions): Promise<T>;
+    /**
+     * Enhanced methods with caching optimization
+     */
+    /**
+     * Get posts with intelligent caching
+     */
+    getPosts(params?: PostQueryParams): Promise<WordPressPost[]>;
+    /**
+     * Get single post with caching
+     */
+    getPost(id: number): Promise<WordPressPost>;
+    /**
+     * Create post with cache invalidation
+     */
+    createPost(data: CreatePostRequest): Promise<WordPressPost>;
+    /**
+     * Update post with cache invalidation
+     */
+    updatePost(data: UpdatePostRequest): Promise<WordPressPost>;
+    /**
+     * Delete post with cache invalidation
+     */
+    deletePost(id: number, force?: boolean): Promise<{
+        deleted: boolean;
+        previous?: WordPressPost;
+    }>;
+    /**
+     * Get current user with session caching
+     */
+    getCurrentUser(): Promise<WordPressUser>;
+    /**
+     * Get categories with semi-static caching
+     */
+    getCategories(params?: Record<string, unknown>): Promise<WordPressCategory[]>;
+    /**
+     * Get tags with semi-static caching
+     */
+    getTags(params?: Record<string, unknown>): Promise<WordPressTag[]>;
+    /**
+     * Get site settings with static caching
+     */
+    getSiteSettings(): Promise<WordPressSiteSettings>;
+    /**
+     * Cache management methods
+     */
+    /**
+     * Private helper methods
+     */
+    private extractEndpoint;
+    /**
+     * Get cache options based on endpoint
+     */
+    private getCacheOptions;
+    /**
+     * Handle cache invalidation for write operations
+     */
+    private handleCacheInvalidation;
+    /**
+     * Extract resource type from endpoint
+     */
+    private extractResourceFromEndpoint;
+    /**
+     * Extract ID from endpoint
+     */
+    private extractIdFromEndpoint;
+    /**
+     * Check if endpoint contains static data
+     */
+    private isStaticEndpoint;
+    /**
+     * Check if endpoint contains semi-static data
+     */
+    private isSemiStaticEndpoint;
+    /**
+     * Check if endpoint is session-related
+     */
+    private isSessionEndpoint;
+    /**
+     * Performance monitoring and cache management methods
+     */
+    /**
+     * Get cache statistics for performance monitoring
+     */
+    getCacheStats(): {
+        cache: CacheStats;
+        invalidation: {
+            queueSize: number;
+            rulesCount: number;
+            processing: boolean;
+        };
+    };
+    /**
+     * Get cache manager instance (for performance monitoring integration)
+     */
+    getCacheManager(): CacheManager;
+    /**
+     * Clear cache entries (for cache management tools)
+     */
+    clearCache(): number;
+    /**
+     * Clear cache entries matching pattern
+     */
+    clearCachePattern(pattern: string): number;
+    /**
+     * Warm cache with essential data
+     */
+    warmCache(): Promise<void>;
+    /**
+     * Get cache efficiency metrics
+     */
+    getCacheEfficiency(): {
+        hitRate: number;
+        missRate: number;
+        efficiency: string;
+        memoryUsage: number;
+        totalEntries: number;
+    };
+    /**
+     * Get cache configuration info
+     */
+    getCacheInfo(): {
+        enabled: boolean;
+        siteId: string;
+        maxSize: number;
+        defaultTTL: number;
+        currentSize: number;
+        ttlPresets: Record<string, unknown>;
+    };
+    /**
+     * Estimate memory usage of cache (in MB)
+     */
+    private estimateMemoryUsage;
+    /**
+     * Get detailed cache performance metrics
+     */
+    getDetailedCacheMetrics(): {
+        statistics: {
+            cache: CacheStats;
+            invalidation: {
+                queueSize: number;
+                rulesCount: number;
+                processing: boolean;
+            };
+        };
+        efficiency: Record<string, unknown>;
+        configuration: Record<string, unknown>;
+        siteInfo: {
+            siteId: string;
+            baseUrl: string;
+        };
+    };
+}
+//# sourceMappingURL=CachedWordPressClient.d.ts.map

package/dist/src/client/CachedWordPressClient.d.ts.map

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