/**
 * Base utility class for tool managers with enhanced type safety
 */
import { WordPressId, DeepReadonly, Result } from "../types/enhanced.js";
export interface ParameterValidationRule<T = unknown> {
    readonly key: string;
    readonly required: boolean;
    readonly type?: string;
    readonly validator?: (value: unknown) => value is T;
    readonly transformer?: (value: unknown) => T;
    readonly errorMessage?: string;
}
export interface CacheKeyOptions {
    readonly namespace?: string;
    readonly includeTimestamp?: boolean;
    readonly customHasher?: (params: Record<string, unknown>) => string;
}
export declare class BaseToolUtils {
    /**
     * Validate required parameters with enhanced type safety
     */
    static validateParams<T extends Record<string, unknown>>(params: unknown, rules: readonly ParameterValidationRule[]): Result<T, Error>;
    /**
     * Validate ID parameter with WordPress ID branding
     */
    static validateId(id: unknown, name?: string): Result<WordPressId, Error>;
    /**
     * Validate multiple IDs at once
     */
    static validateIds(ids: unknown[], name?: string): Result<readonly WordPressId[], Error>;
    /**
     * Handle errors consistently with enhanced error context
     */
    static handleError(error: unknown, operation: string, context?: Record<string, unknown> | undefined): Error;
    /**
     * Generate cache keys with enhanced options
     */
    static generateCacheKey(operation: string, params: DeepReadonly<Record<string, unknown>>, options?: CacheKeyOptions): string;
    /**
     * Format consistent success response messages
     */
    static formatSuccessMessage(operation: string, details?: string, count?: number): string;
    /**
     * Validate string parameters with enhanced checks
     */
    static validateString(value: unknown, name: string, options?: {
        readonly required?: boolean;
        readonly minLength?: number;
        readonly maxLength?: number;
        readonly pattern?: RegExp;
        readonly allowEmpty?: boolean;
    }): Result<string, Error>;
    /**
     * Type-safe parameter extraction
     */
    static extractParam<T>(params: DeepReadonly<Record<string, unknown>>, key: string, defaultValue?: T): T | undefined;
    /**
     * Safe array extraction with type validation
     */
    static extractArray<T>(params: DeepReadonly<Record<string, unknown>>, key: string, itemValidator?: (item: unknown) => item is T): readonly T[];
}
//# sourceMappingURL=BaseToolManager.d.ts.map