mcp-wordpress 1.1.7 → 1.2.2

package/dist/tools/BaseToolClass.js

@@ -0,0 +1,104 @@
+import { getErrorMessage } from '../utils/error.js';
+/**
+ * Base class for all WordPress tool implementations
+ * Provides common functionality and patterns used across tool classes
+ */
+export class BaseToolClass {
+    /**
+     * Format a list response with consistent styling
+     */
+    formatListResponse(items, entityName, formatter, totalCount) {
+        if (items.length === 0) {
+            return `No ${entityName} found matching the criteria.`;
+        }
+        const countText = totalCount !== undefined
+            ? `Found ${items.length} of ${totalCount} ${entityName}:`
+            : `Found ${items.length} ${entityName}:`;
+        return `${countText}\n\n${items.map(formatter).join('\n')}`;
+    }
+    /**
+     * Format a single entity response
+     */
+    formatDetailResponse(entity, entityName) {
+        const details = Object.entries(entity)
+            .filter(([key, value]) => value !== null && value !== undefined)
+            .map(([key, value]) => {
+            const displayKey = key.replace(/_/g, ' ').replace(/\b\w/g, l => l.toUpperCase());
+            if (typeof value === 'object') {
+                return `${displayKey}: ${JSON.stringify(value, null, 2)}`;
+            }
+            return `${displayKey}: ${value}`;
+        })
+            .join('\n');
+        return `${entityName} Details:\n\n${details}`;
+    }
+    /**
+     * Format a success response for create/update operations
+     */
+    formatSuccessResponse(action, entityName, entity) {
+        const id = entity.id || entity.term_id || 'unknown';
+        const title = entity.title?.rendered || entity.name || entity.slug || 'Untitled';
+        return `✅ ${entityName} ${action} successfully with ID: ${id}\nTitle: ${title}`;
+    }
+    /**
+     * Handle errors consistently across all tools
+     */
+    handleError(error, operation) {
+        const errorMessage = getErrorMessage(error);
+        throw new Error(`Failed to ${operation}: ${errorMessage}`);
+    }
+    /**
+     * Validate required parameters
+     */
+    validateRequiredParams(params, requiredFields) {
+        for (const field of requiredFields) {
+            if (params[field] === undefined || params[field] === null || params[field] === '') {
+                throw new Error(`Missing required parameter: ${field}`);
+            }
+        }
+    }
+    /**
+     * Create common pagination parameters
+     */
+    getPaginationParameters() {
+        return [
+            {
+                name: 'per_page',
+                type: 'number',
+                description: 'Number of items to return per page (max 100).'
+            },
+            {
+                name: 'page',
+                type: 'number',
+                description: 'Page number to retrieve (1-based).'
+            },
+            {
+                name: 'search',
+                type: 'string',
+                description: 'Limit results to those matching a search term.'
+            }
+        ];
+    }
+    /**
+     * Create common status parameter
+     */
+    getStatusParameter(validStatuses) {
+        return {
+            name: 'status',
+            type: 'string',
+            description: 'Filter by status.',
+            enum: validStatuses
+        };
+    }
+    /**
+     * Create site parameter for multi-site support
+     */
+    getSiteParameter() {
+        return {
+            name: 'site',
+            type: 'string',
+            description: 'Site identifier for multi-site configurations.'
+        };
+    }
+}
+//# sourceMappingURL=BaseToolClass.js.map

package/dist/tools/BaseToolClass.js.map

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

package/dist/tools/BaseToolManager.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Base utility class for tool managers to reduce code duplication
+ */
+export declare class BaseToolUtils {
+    /**
+     * Validate required parameters
+     */
+    static validateParams(params: Record<string, any>, required: string[]): void;
+    /**
+     * Validate ID parameter
+     */
+    static validateId(id: unknown, name?: string): number;
+    /**
+     * Handle errors consistently across all tools
+     */
+    static handleError(error: unknown, operation: string): string;
+    /**
+     * Cache key generation helper
+     */
+    static generateCacheKey(operation: string, params: Record<string, unknown>): string;
+    /**
+     * Format consistent response messages
+     */
+    static formatSuccessMessage(operation: string, details?: string): string;
+}
+//# sourceMappingURL=BaseToolManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BaseToolManager.d.ts","sourceRoot":"","sources":["../../src/tools/BaseToolManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,qBAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAY5E;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,SAAO,GAAG,MAAM;IAQnD;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAK7D;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM;IAUT;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;CAKzE"}

package/dist/tools/BaseToolManager.js

@@ -0,0 +1,56 @@
+/**
+ * Base utility class for tool managers to reduce code duplication
+ */
+import { getErrorMessage } from '../utils/error.js';
+export class BaseToolUtils {
+    /**
+     * Validate required parameters
+     */
+    static validateParams(params, required) {
+        for (const field of required) {
+            if (!(field in params) ||
+                params[field] === undefined ||
+                params[field] === null) {
+                throw new Error(`Missing required parameter: ${field}`);
+            }
+        }
+    }
+    /**
+     * Validate ID parameter
+     */
+    static validateId(id, name = 'id') {
+        const numId = Number(id);
+        if (!Number.isInteger(numId) || numId <= 0) {
+            throw new Error(`Invalid ${name}: must be a positive integer`);
+        }
+        return numId;
+    }
+    /**
+     * Handle errors consistently across all tools
+     */
+    static handleError(error, operation) {
+        const errorMessage = getErrorMessage(error);
+        return `Error in ${operation}: ${errorMessage}`;
+    }
+    /**
+     * Cache key generation helper
+     */
+    static generateCacheKey(operation, params) {
+        const site = params.site || 'default';
+        const paramStr = Object.entries(params)
+            .filter(([key]) => key !== 'site')
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([key, value]) => `${key}:${value}`)
+            .join('|');
+        return `${site}:${operation}:${paramStr}`;
+    }
+    /**
+     * Format consistent response messages
+     */
+    static formatSuccessMessage(operation, details) {
+        return details
+            ? `${operation}: ${details}`
+            : `${operation} completed successfully`;
+    }
+}
+//# sourceMappingURL=BaseToolManager.js.map

package/dist/tools/BaseToolManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseToolManager.js","sourceRoot":"","sources":["../../src/tools/BaseToolManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,OAAO,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAA2B,EAAE,QAAkB;QACnE,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,IACE,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC;gBAClB,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS;gBAC3B,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,EACtB,CAAC;gBACD,MAAM,IAAI,KAAK,CAAC,+BAA+B,KAAK,EAAE,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,EAAW,EAAE,IAAI,GAAG,IAAI;QACxC,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,8BAA8B,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAc,EAAE,SAAiB;QAClD,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QAC5C,OAAO,YAAY,SAAS,KAAK,YAAY,EAAE,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,SAAiB,EACjB,MAA+B;QAE/B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,SAAS,CAAC;QACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;aACpC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,MAAM,CAAC;aACjC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;aACtC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;aACxC,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,OAAO,GAAG,IAAI,IAAI,SAAS,IAAI,QAAQ,EAAE,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,SAAiB,EAAE,OAAgB;QAC7D,OAAO,OAAO;YACZ,CAAC,CAAC,GAAG,SAAS,KAAK,OAAO,EAAE;YAC5B,CAAC,CAAC,GAAG,SAAS,yBAAyB,CAAC;IAC5C,CAAC;CACF"}

package/dist/tools/base.d.ts

@@ -0,0 +1,37 @@
+import { WordPressClient } from "../client/api.js";
+/**
+ * Base class for all WordPress tool categories.
+ * Provides common functionality and error handling for tool implementations.
+ */
+export declare abstract class BaseToolClass {
+    protected client: WordPressClient;
+    constructor(client: WordPressClient);
+    /**
+     * Abstract method that must be implemented by subclasses to return their tool definitions.
+     * @returns An array of MCPTool definitions.
+     */
+    abstract getTools(): any[];
+    /**
+     * Common error handler for all tools.
+     * @param error The error to handle
+     * @param operation The operation that failed
+     * @throws Error with formatted message
+     */
+    protected handleError(error: unknown, operation: string): never;
+    /**
+     * Validates required parameters are not undefined or null.
+     * @param params Object containing parameters to validate
+     * @param required Array of required parameter names
+     * @throws Error if any required parameter is missing
+     */
+    protected validateRequiredParams(params: Record<string, any>, required: string[]): void;
+    /**
+     * Resolves the appropriate WordPress client for multi-site support.
+     * @param site Optional site ID for multi-site configurations
+     * @param clients Map of site IDs to WordPress clients
+     * @returns The resolved WordPress client
+     * @throws Error if site is not found or ambiguous
+     */
+    protected resolveClient(site: string | undefined, clients: Map<string, WordPressClient>): WordPressClient;
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/tools/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD;;;GAGG;AACH,8BAAsB,aAAa;IACrB,SAAS,CAAC,MAAM,EAAE,eAAe;gBAAvB,MAAM,EAAE,eAAe;IAE7C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,IAAI,GAAG,EAAE;IAE1B;;;;;OAKG;IACH,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK;IAI/D;;;;;OAKG;IACH,SAAS,CAAC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAQvF;;;;;;OAMG;IACH,SAAS,CAAC,aAAa,CACrB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GACpC,eAAe;CA6BnB"}

package/dist/tools/base.js

@@ -0,0 +1,60 @@
+import { getErrorMessage } from "../utils/error.js";
+/**
+ * Base class for all WordPress tool categories.
+ * Provides common functionality and error handling for tool implementations.
+ */
+export class BaseToolClass {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Common error handler for all tools.
+     * @param error The error to handle
+     * @param operation The operation that failed
+     * @throws Error with formatted message
+     */
+    handleError(error, operation) {
+        throw new Error(`Failed to ${operation}: ${getErrorMessage(error)}`);
+    }
+    /**
+     * Validates required parameters are not undefined or null.
+     * @param params Object containing parameters to validate
+     * @param required Array of required parameter names
+     * @throws Error if any required parameter is missing
+     */
+    validateRequiredParams(params, required) {
+        for (const param of required) {
+            if (params[param] === undefined || params[param] === null) {
+                throw new Error(`Missing required parameter: ${param}`);
+            }
+        }
+    }
+    /**
+     * Resolves the appropriate WordPress client for multi-site support.
+     * @param site Optional site ID for multi-site configurations
+     * @param clients Map of site IDs to WordPress clients
+     * @returns The resolved WordPress client
+     * @throws Error if site is not found or ambiguous
+     */
+    resolveClient(site, clients) {
+        if (clients.size === 0) {
+            throw new Error("No WordPress clients configured");
+        }
+        if (clients.size === 1 && !site) {
+            return Array.from(clients.values())[0];
+        }
+        if (!site && clients.size > 1) {
+            throw new Error(`Multiple sites configured. Please specify --site parameter with one of: ${Array.from(clients.keys()).join(", ")}`);
+        }
+        if (site) {
+            const client = clients.get(site);
+            if (!client) {
+                throw new Error(`Site "${site}" not found. Available sites: ${Array.from(clients.keys()).join(", ")}`);
+            }
+            return client;
+        }
+        return this.client;
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/tools/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/tools/base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;GAGG;AACH,MAAM,OAAgB,aAAa;IACX;IAAtB,YAAsB,MAAuB;QAAvB,WAAM,GAAN,MAAM,CAAiB;IAAG,CAAC;IAQjD;;;;;OAKG;IACO,WAAW,CAAC,KAAc,EAAE,SAAiB;QACrD,MAAM,IAAI,KAAK,CAAC,aAAa,SAAS,KAAK,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;;;OAKG;IACO,sBAAsB,CAAC,MAA2B,EAAE,QAAkB;QAC9E,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC1D,MAAM,IAAI,KAAK,CAAC,+BAA+B,KAAK,EAAE,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACO,aAAa,CACrB,IAAwB,EACxB,OAAqC;QAErC,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,2EAA2E,KAAK,CAAC,IAAI,CACnF,OAAO,CAAC,IAAI,EAAE,CACf,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACf,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACjC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CACb,SAAS,IAAI,iCAAiC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtF,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}

package/dist/tools/cache.d.ts

@@ -0,0 +1,260 @@
+/**
+ * Cache management tools for WordPress MCP Server
+ * Provides cache inspection, clearing, and warming capabilities
+ */
+import type { WordPressClient } from '../client/api.js';
+/**
+ * Cache management tools class
+ */
+export declare class CacheTools {
+    private clients;
+    constructor(clients: Map<string, WordPressClient>);
+    /**
+     * Get cache management tools
+     */
+    getTools(): ({
+        name: string;
+        description: string;
+        parameters: {
+            name: string;
+            type: string;
+            description: string;
+        }[];
+        handler: (params: {
+            site?: string;
+        }) => Promise<{
+            caching_enabled: boolean;
+            message: string;
+            cache_stats?: never;
+            invalidation_stats?: never;
+        } | {
+            caching_enabled: boolean;
+            cache_stats: {
+                hits: any;
+                misses: any;
+                hit_rate: string;
+                total_entries: any;
+                evictions: any;
+            };
+            invalidation_stats: {
+                queue_size: any;
+                rules_count: any;
+                processing: any;
+            };
+            message?: never;
+        }>;
+    } | {
+        name: string;
+        description: string;
+        parameters: {
+            name: string;
+            type: string;
+            description: string;
+        }[];
+        handler: (params: {
+            site?: string;
+            pattern?: string;
+        }) => Promise<{
+            success: boolean;
+            message: string;
+            cleared_entries?: never;
+            pattern?: never;
+        } | {
+            success: boolean;
+            message: string;
+            cleared_entries: number;
+            pattern: string;
+        } | {
+            success: boolean;
+            message: string;
+            cleared_entries: number;
+            pattern?: never;
+        }>;
+    } | {
+        name: string;
+        description: string;
+        parameters: {
+            name: string;
+            type: string;
+            description: string;
+        }[];
+        handler: (params: {
+            site?: string;
+        }) => Promise<{
+            success: boolean;
+            message: string;
+            cache_entries_after_warming?: never;
+            warmed_data?: never;
+        } | {
+            success: boolean;
+            message: string;
+            cache_entries_after_warming: any;
+            warmed_data: string[];
+        }>;
+    } | {
+        name: string;
+        description: string;
+        parameters: {
+            name: string;
+            type: string;
+            description: string;
+        }[];
+        handler: (params: {
+            site?: string;
+        }) => Promise<{
+            caching_enabled: boolean;
+            message: string;
+            how_to_enable: string;
+            cache_configuration?: never;
+            ttl_presets?: never;
+            current_stats?: never;
+            invalidation_info?: never;
+            performance_benefits?: never;
+        } | {
+            caching_enabled: boolean;
+            cache_configuration: {
+                max_size: string;
+                default_ttl: string;
+                lru_enabled: string;
+                stats_enabled: string;
+            };
+            ttl_presets: {
+                static_data: string;
+                semi_static_data: string;
+                dynamic_data: string;
+                session_data: string;
+                realtime_data: string;
+            };
+            current_stats: {
+                total_entries: any;
+                hit_rate: string;
+                hits: any;
+                misses: any;
+                evictions: any;
+            };
+            invalidation_info: {
+                queue_size: any;
+                rules_registered: any;
+                currently_processing: any;
+            };
+            performance_benefits: string[];
+            message?: never;
+            how_to_enable?: never;
+        }>;
+    })[];
+    /**
+     * Get cache statistics
+     */
+    handleGetCacheStats(params: {
+        site?: string;
+    }): Promise<{
+        caching_enabled: boolean;
+        message: string;
+        cache_stats?: never;
+        invalidation_stats?: never;
+    } | {
+        caching_enabled: boolean;
+        cache_stats: {
+            hits: any;
+            misses: any;
+            hit_rate: string;
+            total_entries: any;
+            evictions: any;
+        };
+        invalidation_stats: {
+            queue_size: any;
+            rules_count: any;
+            processing: any;
+        };
+        message?: never;
+    }>;
+    /**
+     * Clear cache
+     */
+    handleClearCache(params: {
+        site?: string;
+        pattern?: string;
+    }): Promise<{
+        success: boolean;
+        message: string;
+        cleared_entries?: never;
+        pattern?: never;
+    } | {
+        success: boolean;
+        message: string;
+        cleared_entries: number;
+        pattern: string;
+    } | {
+        success: boolean;
+        message: string;
+        cleared_entries: number;
+        pattern?: never;
+    }>;
+    /**
+     * Warm cache with essential data
+     */
+    handleWarmCache(params: {
+        site?: string;
+    }): Promise<{
+        success: boolean;
+        message: string;
+        cache_entries_after_warming?: never;
+        warmed_data?: never;
+    } | {
+        success: boolean;
+        message: string;
+        cache_entries_after_warming: any;
+        warmed_data: string[];
+    }>;
+    /**
+     * Get detailed cache information
+     */
+    handleGetCacheInfo(params: {
+        site?: string;
+    }): Promise<{
+        caching_enabled: boolean;
+        message: string;
+        how_to_enable: string;
+        cache_configuration?: never;
+        ttl_presets?: never;
+        current_stats?: never;
+        invalidation_info?: never;
+        performance_benefits?: never;
+    } | {
+        caching_enabled: boolean;
+        cache_configuration: {
+            max_size: string;
+            default_ttl: string;
+            lru_enabled: string;
+            stats_enabled: string;
+        };
+        ttl_presets: {
+            static_data: string;
+            semi_static_data: string;
+            dynamic_data: string;
+            session_data: string;
+            realtime_data: string;
+        };
+        current_stats: {
+            total_entries: any;
+            hit_rate: string;
+            hits: any;
+            misses: any;
+            evictions: any;
+        };
+        invalidation_info: {
+            queue_size: any;
+            rules_registered: any;
+            currently_processing: any;
+        };
+        performance_benefits: string[];
+        message?: never;
+        how_to_enable?: never;
+    }>;
+    /**
+     * Resolve client from site parameter
+     */
+    private resolveClient;
+}
+export default CacheTools;
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/tools/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAIxD;;GAEG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;IAEzD;;OAEG;IACH,QAAQ;;;;;;;;0BA6D0B;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAkCpB;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;0BAmCpC;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;0BAgCd;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAxGlD;;OAEG;IACG,mBAAmB,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;IA+BnD;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;IAgClE;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;IA6B/C;;OAEG;IACG,kBAAkB,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmDlD;;OAEG;IACH,OAAO,CAAC,aAAa;CAsBtB;AAED,eAAe,UAAU,CAAC"}