@simonecoelhosfo/optimizely-mcp-server/dist/errors/ValidationErrorTransformer.d.ts

Optimizely MCP Server for AI assistants with integrated CLI tools

/**
 * Validation Error Transformer
 *
 * Transforms cryptic API validation errors into clear, actionable guidance for AI agents.
 * This ensures that AI agents never see raw ZOD or JSON schema validation errors.
 *
 * @author Optimizely MCP Server
 * @version 1.0.0
 */
export interface ValidationErrorContext {
    entityType: string;
    operation: string;
    projectId?: string;
    payload?: any;
    apiEndpoint?: string;
}
export interface TransformedError {
    userMessage: string;
    technicalDetails: string;
    suggestedFix: string;
    examplePayload?: any;
    documentationLink?: string;
}
export declare class ValidationErrorTransformer {
    private logger;
    /**
     * Transform any validation error into user-friendly guidance
     */
    transformValidationError(errorMessage: string, context: ValidationErrorContext): TransformedError;
    /**
     * Check if this is a ruleset validation error
     */
    private isRulesetValidationError;
    /**
     * Transform ruleset-specific validation errors
     */
    private transformRulesetError;
    /**
     * Check if this is a flag update with ab_test structure
     */
    private isFlagAbTestError;
    /**
     * Transform flag ab_test errors
     */
    private transformFlagAbTestError;
    /**
     * Check if this is a variation validation error
     */
    private isVariationValidationError;
    /**
     * Transform variation-specific validation errors
     */
    private transformVariationError;
    /**
     * Check if this is a JSON schema validation error
     */
    private isSchemaValidationError;
    /**
     * Transform schema validation errors
     */
    private transformSchemaError;
    /**
     * Check if this is a missing required field error
     */
    private isMissingFieldError;
    /**
     * Transform missing field errors
     */
    private transformMissingFieldError;
    /**
     * Check if this is a type mismatch error
     */
    private isTypeError;
    /**
     * Transform type errors
     */
    private transformTypeError;
    /**
     * Create default transformation for unknown errors
     */
    private createDefaultTransformation;
    /**
     * Create default ruleset guidance
     */
    private createDefaultRulesetGuide;
    /**
     * Create default variation guidance
     */
    private createDefaultVariationGuide;
    /**
     * Check if error message contains patterns that should trigger template mode
     */
    shouldSuggestTemplateMode(message: string, context: ValidationErrorContext): boolean;
}
export declare const validationErrorTransformer: ValidationErrorTransformer;
//# sourceMappingURL=ValidationErrorTransformer.d.ts.map