mcp-wordpress 2.4.2 → 2.5.1

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

@@ -0,0 +1,149 @@
+/**
+ * Intelligent caching system for WordPress MCP Server
+ * Implements multi-layer caching with TTL, LRU eviction, and site-specific keys
+ */
+export interface CacheEntry<T = unknown> {
+    value: T;
+    timestamp: number;
+    ttl: number;
+    etag?: string | undefined;
+    lastModified?: string | undefined;
+    accessCount: number;
+    lastAccessed: number;
+}
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    evictions: number;
+    totalSize: number;
+    hitRate: number;
+}
+export interface CacheConfig {
+    maxSize: number;
+    defaultTTL: number;
+    enableLRU: boolean;
+    enableStats: boolean;
+    sitePrefix?: string;
+}
+/**
+ * High-performance in-memory cache with TTL and LRU eviction
+ */
+export declare class CacheManager {
+    private config;
+    private cache;
+    private accessOrder;
+    private cleanupInterval;
+    private stats;
+    constructor(config: CacheConfig);
+    /**
+     * Generate cache key with site prefix and parameter hash
+     */
+    generateKey(siteId: string, endpoint: string, params?: Record<string, unknown>): string;
+    /**
+     * Get value from cache if not expired
+     */
+    get<T>(key: string): T | null;
+    /**
+     * Set value in cache with TTL
+     */
+    set<T>(key: string, value: T, ttl?: number, etag?: string, lastModified?: string): void;
+    /**
+     * Check if cache entry exists and is valid
+     */
+    has(key: string): boolean;
+    /**
+     * Delete specific cache entry
+     */
+    delete(key: string): boolean;
+    /**
+     * Clear all cache entries
+     */
+    clear(): void;
+    /**
+     * Clear cache entries for specific site
+     */
+    clearSite(siteId: string): number;
+    /**
+     * Clear cache entries matching pattern
+     */
+    clearPattern(pattern: RegExp): number;
+    /**
+     * Get cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Get cache entry with metadata
+     */
+    getEntry(key: string): CacheEntry | null;
+    /**
+     * Check if entry supports conditional requests
+     */
+    supportsConditionalRequest(key: string): boolean;
+    /**
+     * Get conditional request headers
+     */
+    getConditionalHeaders(key: string): Record<string, string>;
+    /**
+     * Check if entry is expired
+     */
+    private isExpired;
+    /**
+     * Evict least recently used entry
+     */
+    private evictLRU;
+    /**
+     * Update access order for LRU tracking
+     */
+    private updateAccessOrder;
+    /**
+     * Remove key from access order
+     */
+    private removeFromAccessOrder;
+    /**
+     * Normalize parameters for consistent hashing
+     */
+    private normalizeParams;
+    /**
+     * Update hit rate calculation
+     */
+    private updateHitRate;
+    /**
+     * Start periodic cleanup of expired entries
+     * Note: This uses setInterval and is not called in test environments to avoid Jest timer issues
+     */
+    private startCleanupInterval;
+    /**
+     * Stop the cleanup interval and clean up resources
+     */
+    destroy(): void;
+    /**
+     * Remove expired entries
+     */
+    private cleanupExpired;
+}
+/**
+ * Cache configuration presets for different data types
+ */
+export declare const CachePresets: {
+    STATIC: {
+        ttl: number;
+        cacheControl: string;
+    };
+    SEMI_STATIC: {
+        ttl: number;
+        cacheControl: string;
+    };
+    DYNAMIC: {
+        ttl: number;
+        cacheControl: string;
+    };
+    SESSION: {
+        ttl: number;
+        cacheControl: string;
+    };
+    REALTIME: {
+        ttl: number;
+        cacheControl: string;
+    };
+};
+//# sourceMappingURL=CacheManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../../src/cache/CacheManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,YAAY;IAYX,OAAO,CAAC,MAAM;IAX1B,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,KAAK,CAMX;gBAEkB,MAAM,EAAE,WAAW;IAOvC;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAiBvF;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IA6B7B;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,GAAE,MAA+B,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;IA0B/G;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKzB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAS5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAkBjC;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAkBrC;;OAEG;IACH,QAAQ,IAAI,UAAU;IAItB;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAQxC;;OAEG;IACH,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKhD;;OAEG;IACH,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAiB1D;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAUhB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;IACH,OAAO,CAAC,eAAe;IAqBvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;OAEG;IACH,OAAO,IAAI,IAAI;IAOf;;OAEG;IACH,OAAO,CAAC,cAAc;CAiBvB;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;CA8BxB,CAAC"}

package/dist/src/cache/CacheManager.js

@@ -0,0 +1,326 @@
+/**
+ * Intelligent caching system for WordPress MCP Server
+ * Implements multi-layer caching with TTL, LRU eviction, and site-specific keys
+ */
+import * as crypto from "crypto";
+import { ConfigHelpers } from "../config/Config.js";
+/**
+ * High-performance in-memory cache with TTL and LRU eviction
+ */
+export class CacheManager {
+    config;
+    cache = new Map();
+    accessOrder = [];
+    cleanupInterval = null;
+    stats = {
+        hits: 0,
+        misses: 0,
+        evictions: 0,
+        totalSize: 0,
+        hitRate: 0,
+    };
+    constructor(config) {
+        this.config = config;
+        // Start cleanup interval (skip in test environment to avoid timer issues)
+        if (!ConfigHelpers.isTest()) {
+            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;
+        }
+        if (Array.isArray(params)) {
+            // Recursively normalize each item in the array
+            return params.map((item) => this.normalizeParams(item));
+        }
+        // Sort object keys for consistent hashing
+        const normalized = {};
+        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
+     * Note: This uses setInterval and is not called in test environments to avoid Jest timer issues
+     */
+    startCleanupInterval() {
+        this.cleanupInterval = setInterval(() => {
+            this.cleanupExpired();
+        }, 60000); // Cleanup every minute
+    }
+    /**
+     * Stop the cleanup interval and clean up resources
+     */
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+    }
+    /**
+     * 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/src/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/src/cache/HttpCacheWrapper.d.ts

@@ -0,0 +1,122 @@
+/**
+ * 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: unknown;
+    status: number;
+    headers: Record<string, string>;
+    etag?: string;
+    lastModified?: string;
+    cacheControl?: string;
+}
+export interface RequestOptions {
+    method: string;
+    url: string;
+    headers?: Record<string, string>;
+    params?: Record<string, unknown>;
+    data?: unknown;
+}
+/**
+ * HTTP caching wrapper that adds intelligent caching to HTTP requests
+ */
+export declare class HttpCacheWrapper {
+    private cacheManager;
+    private siteId;
+    private logger;
+    constructor(cacheManager: CacheManager, siteId: string);
+    /**
+     * Execute request with intelligent caching
+     */
+    request<T = unknown>(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?: Record<string, unknown>): 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?: Record<string, unknown>, 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/src/cache/HttpCacheWrapper.d.ts.map

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