/**
 * Authentication Matrix Validator
 *
 * Tests endpoints in all possible authentication states to ensure
 * correct behavior across the authentication spectrum.
 *
 * Prevents auth-related bugs by exhaustively testing:
 * - Unauthenticated access
 * - Authenticated access
 * - Expired tokens
 * - Invalid tokens
 * - Insufficient permissions
 */
import { APIContract, AuthTestCase, MatrixResult, AuthenticationRequirement } from '../types/api-contracts';
export declare class AuthenticationMatrixValidator {
    /**
     * Generate comprehensive test matrix from API contract
     *
     * The matrix covers all relevant authentication states based on
     * the contract's authentication requirement.
     */
    static buildMatrix(contract: APIContract): AuthTestCase[];
    /**
     * Execute authentication matrix tests
     *
     * Runs all test cases and collects results with detailed violation reporting.
     */
    static executeMatrix(baseUrl: string, contract: APIContract, testTokens?: {
        readonly validToken?: string;
        readonly expiredToken?: string;
        readonly invalidToken?: string;
    }): Promise<MatrixResult[]>;
    /**
     * Execute a single test case
     */
    private static executeTestCase;
    /**
     * Get authentication headers for specific auth state
     */
    private static getAuthHeaders;
    /**
     * Generate fix suggestion based on test failure
     */
    private static generateFixSuggestion;
    /**
     * Validate response body against schema
     */
    private static validateSchema;
    /**
     * Generate human-readable matrix report
     */
    static generateMatrixReport(results: MatrixResult[]): string;
    /**
     * Get authentication requirement name for display
     */
    static getAuthRequirementName(auth: AuthenticationRequirement): string;
}
//# sourceMappingURL=authentication-matrix.d.ts.map