mcp-wordpress 1.1.7 → 1.2.2

package/dist/cache/CacheManager.js

@@ -0,0 +1,308 @@
+/**
+ * Intelligent caching system for WordPress MCP Server
+ * Implements multi-layer caching with TTL, LRU eviction, and site-specific keys
+ */
+import * as crypto from 'crypto';
+/**
+ * High-performance in-memory cache with TTL and LRU eviction
+ */
+export class CacheManager {
+    config;
+    cache = new Map();
+    accessOrder = [];
+    stats = {
+        hits: 0,
+        misses: 0,
+        evictions: 0,
+        totalSize: 0,
+        hitRate: 0
+    };
+    constructor(config) {
+        this.config = config;
+        // Start cleanup interval
+        this.startCleanupInterval();
+    }
+    /**
+     * Generate cache key with site prefix and parameter hash
+     */
+    generateKey(siteId, endpoint, params) {
+        const baseKey = `${siteId}:${endpoint}`;
+        if (!params || Object.keys(params).length === 0) {
+            return baseKey;
+        }
+        // Create deterministic hash of parameters
+        const paramHash = crypto
+            .createHash('md5')
+            .update(JSON.stringify(this.normalizeParams(params)))
+            .digest('hex')
+            .substring(0, 8);
+        return `${baseKey}:${paramHash}`;
+    }
+    /**
+     * Get value from cache if not expired
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.stats.misses++;
+            this.updateHitRate();
+            return null;
+        }
+        // Check if expired
+        if (this.isExpired(entry)) {
+            this.cache.delete(key);
+            this.removeFromAccessOrder(key);
+            this.stats.misses++;
+            this.updateHitRate();
+            return null;
+        }
+        // Update access tracking
+        entry.accessCount++;
+        entry.lastAccessed = Date.now();
+        this.updateAccessOrder(key);
+        this.stats.hits++;
+        this.updateHitRate();
+        return entry.value;
+    }
+    /**
+     * Set value in cache with TTL
+     */
+    set(key, value, ttl = this.config.defaultTTL, etag, lastModified) {
+        // Check if we need to evict entries
+        if (this.cache.size >= this.config.maxSize && !this.cache.has(key)) {
+            this.evictLRU();
+        }
+        const entry = {
+            value,
+            timestamp: Date.now(),
+            ttl,
+            etag,
+            lastModified,
+            accessCount: 1,
+            lastAccessed: Date.now()
+        };
+        // If updating existing entry, remove from access order first
+        if (this.cache.has(key)) {
+            this.removeFromAccessOrder(key);
+        }
+        this.cache.set(key, entry);
+        this.accessOrder.push(key);
+        this.stats.totalSize = this.cache.size;
+    }
+    /**
+     * Check if cache entry exists and is valid
+     */
+    has(key) {
+        const entry = this.cache.get(key);
+        return entry !== undefined && !this.isExpired(entry);
+    }
+    /**
+     * Delete specific cache entry
+     */
+    delete(key) {
+        const existed = this.cache.delete(key);
+        if (existed) {
+            this.removeFromAccessOrder(key);
+            this.stats.totalSize = this.cache.size;
+        }
+        return existed;
+    }
+    /**
+     * Clear all cache entries
+     */
+    clear() {
+        this.cache.clear();
+        this.accessOrder = [];
+        this.stats.totalSize = 0;
+    }
+    /**
+     * Clear cache entries for specific site
+     */
+    clearSite(siteId) {
+        let cleared = 0;
+        const keysToDelete = [];
+        for (const key of this.cache.keys()) {
+            if (key.startsWith(`${siteId}:`)) {
+                keysToDelete.push(key);
+            }
+        }
+        for (const key of keysToDelete) {
+            this.delete(key);
+            cleared++;
+        }
+        return cleared;
+    }
+    /**
+     * Clear cache entries matching pattern
+     */
+    clearPattern(pattern) {
+        let cleared = 0;
+        const keysToDelete = [];
+        for (const key of this.cache.keys()) {
+            if (pattern.test(key)) {
+                keysToDelete.push(key);
+            }
+        }
+        for (const key of keysToDelete) {
+            this.delete(key);
+            cleared++;
+        }
+        return cleared;
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Get cache entry with metadata
+     */
+    getEntry(key) {
+        const entry = this.cache.get(key);
+        if (!entry || this.isExpired(entry)) {
+            return null;
+        }
+        return { ...entry };
+    }
+    /**
+     * Check if entry supports conditional requests
+     */
+    supportsConditionalRequest(key) {
+        const entry = this.cache.get(key);
+        return !!(entry && (entry.etag || entry.lastModified));
+    }
+    /**
+     * Get conditional request headers
+     */
+    getConditionalHeaders(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return {};
+        const headers = {};
+        if (entry.etag) {
+            headers['If-None-Match'] = entry.etag;
+        }
+        if (entry.lastModified) {
+            headers['If-Modified-Since'] = entry.lastModified;
+        }
+        return headers;
+    }
+    /**
+     * Check if entry is expired
+     */
+    isExpired(entry) {
+        return Date.now() - entry.timestamp > entry.ttl;
+    }
+    /**
+     * Evict least recently used entry
+     */
+    evictLRU() {
+        if (this.accessOrder.length === 0)
+            return;
+        const lruKey = this.accessOrder[0];
+        this.cache.delete(lruKey);
+        this.accessOrder.shift();
+        this.stats.evictions++;
+        this.stats.totalSize = this.cache.size;
+    }
+    /**
+     * Update access order for LRU tracking
+     */
+    updateAccessOrder(key) {
+        if (!this.config.enableLRU)
+            return;
+        const index = this.accessOrder.indexOf(key);
+        if (index > -1) {
+            this.accessOrder.splice(index, 1);
+        }
+        this.accessOrder.push(key);
+    }
+    /**
+     * Remove key from access order
+     */
+    removeFromAccessOrder(key) {
+        const index = this.accessOrder.indexOf(key);
+        if (index > -1) {
+            this.accessOrder.splice(index, 1);
+        }
+    }
+    /**
+     * Normalize parameters for consistent hashing
+     */
+    normalizeParams(params) {
+        if (typeof params !== 'object' || params === null) {
+            return params;
+        }
+        // Sort object keys for consistent hashing
+        const normalized = Array.isArray(params) ? [] : {};
+        const keys = Object.keys(params).sort();
+        for (const key of keys) {
+            normalized[key] = this.normalizeParams(params[key]);
+        }
+        return normalized;
+    }
+    /**
+     * Update hit rate calculation
+     */
+    updateHitRate() {
+        const total = this.stats.hits + this.stats.misses;
+        this.stats.hitRate = total > 0 ? this.stats.hits / total : 0;
+    }
+    /**
+     * Start periodic cleanup of expired entries
+     */
+    startCleanupInterval() {
+        setInterval(() => {
+            this.cleanupExpired();
+        }, 60000); // Cleanup every minute
+    }
+    /**
+     * Remove expired entries
+     */
+    cleanupExpired() {
+        const now = Date.now();
+        const keysToDelete = [];
+        for (const [key, entry] of this.cache.entries()) {
+            if (now - entry.timestamp > entry.ttl) {
+                keysToDelete.push(key);
+            }
+        }
+        for (const key of keysToDelete) {
+            this.cache.delete(key);
+            this.removeFromAccessOrder(key);
+        }
+        this.stats.totalSize = this.cache.size;
+    }
+}
+/**
+ * Cache configuration presets for different data types
+ */
+export const CachePresets = {
+    // Static data: site settings, user roles
+    STATIC: {
+        ttl: 4 * 60 * 60 * 1000, // 4 hours
+        cacheControl: 'public, max-age=14400'
+    },
+    // Semi-static: categories, tags, user profiles  
+    SEMI_STATIC: {
+        ttl: 2 * 60 * 60 * 1000, // 2 hours
+        cacheControl: 'public, max-age=7200'
+    },
+    // Dynamic: posts, pages, comments
+    DYNAMIC: {
+        ttl: 15 * 60 * 1000, // 15 minutes
+        cacheControl: 'public, max-age=900'
+    },
+    // Session: authentication, current user
+    SESSION: {
+        ttl: 30 * 60 * 1000, // 30 minutes
+        cacheControl: 'private, max-age=1800'
+    },
+    // Fast changing: real-time data
+    REALTIME: {
+        ttl: 60 * 1000, // 1 minute
+        cacheControl: 'public, max-age=60'
+    }
+};
+//# sourceMappingURL=CacheManager.js.map

package/dist/cache/CacheManager.js.map

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

package/dist/cache/HttpCacheWrapper.d.ts

@@ -0,0 +1,121 @@
+/**
+ * HTTP-level caching wrapper with ETags and Cache-Control headers
+ * Implements WordPress REST API caching best practices
+ */
+import { CacheManager } from './CacheManager.js';
+export interface HttpCacheOptions {
+    ttl?: number;
+    cacheControl?: string;
+    varyHeaders?: string[];
+    private?: boolean;
+    revalidate?: boolean;
+}
+export interface CachedResponse {
+    data: any;
+    status: number;
+    headers: Record<string, string>;
+    etag?: string;
+    lastModified?: string;
+    cacheControl?: string;
+}
+export interface RequestOptions {
+    method: string;
+    url: string;
+    headers?: Record<string, string>;
+    params?: any;
+    data?: any;
+}
+/**
+ * HTTP caching wrapper that adds intelligent caching to HTTP requests
+ */
+export declare class HttpCacheWrapper {
+    private cacheManager;
+    private siteId;
+    constructor(cacheManager: CacheManager, siteId: string);
+    /**
+     * Execute request with intelligent caching
+     */
+    request<T = any>(requestFn: () => Promise<{
+        data: T;
+        status: number;
+        headers: Record<string, string>;
+    }>, options: RequestOptions, cacheOptions?: HttpCacheOptions): Promise<{
+        data: T;
+        status: number;
+        headers: Record<string, string>;
+        cached?: boolean;
+    }>;
+    /**
+     * Invalidate cache for specific endpoint
+     */
+    invalidate(endpoint: string, params?: any): void;
+    /**
+     * Invalidate cache entries matching pattern
+     */
+    invalidatePattern(pattern: string): number;
+    /**
+     * Invalidate all cache for this site
+     */
+    invalidateAll(): number;
+    /**
+     * Pre-warm cache with data
+     */
+    warm<T>(endpoint: string, data: T, params?: any, cacheOptions?: HttpCacheOptions): void;
+    /**
+     * Get cache statistics for this site
+     */
+    getStats(): import("./CacheManager.js").CacheStats;
+    /**
+     * Generate cache key for request
+     */
+    private generateCacheKey;
+    /**
+     * Extract endpoint from full URL
+     */
+    private extractEndpoint;
+    /**
+     * Extract headers that affect caching
+     */
+    private extractCacheableHeaders;
+    /**
+     * Execute request with modified headers
+     */
+    private executeRequestWithHeaders;
+    /**
+     * Cache response and return with cache metadata
+     */
+    private cacheAndReturn;
+    /**
+     * Generate ETag for response data
+     */
+    private generateETag;
+    /**
+     * Get default TTL based on endpoint type
+     */
+    private getDefaultTTL;
+    /**
+     * Get default Cache-Control header based on endpoint
+     */
+    private getDefaultCacheControl;
+    /**
+     * Generate cache headers
+     */
+    private generateCacheHeaders;
+    /**
+     * 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;
+    /**
+     * Extract endpoint from cache key
+     */
+    private extractEndpointFromKey;
+}
+//# sourceMappingURL=HttpCacheWrapper.d.ts.map

package/dist/cache/HttpCacheWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpCacheWrapper.d.ts","sourceRoot":"","sources":["../../src/cache/HttpCacheWrapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAgB,MAAM,mBAAmB,CAAC;AAG/D,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,GAAG,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,MAAM;gBADN,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,MAAM;IAGxB;;OAEG;IACG,OAAO,CAAC,CAAC,GAAG,GAAG,EACnB,SAAS,EAAE,MAAM,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC,EACtF,OAAO,EAAE,cAAc,EACvB,YAAY,CAAC,EAAE,gBAAgB,GAC9B,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IA4D1F;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,IAAI;IAKhD;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAK1C;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAsBvF;;OAEG;IACH,QAAQ;IAIR;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAe/B;;OAEG;YACW,yBAAyB;IASvC;;OAEG;YACW,cAAc;IAkD5B;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAoBrB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAK5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAI/B"}