import { z } from 'zod';
/**
 * Result of a safe validation attempt.
 * On success, contains the parsed data. On failure, contains the error details.
 */
export interface ValidationResult<T> {
    success: boolean;
    data?: T;
    error?: string;
    issues?: Array<{
        path: string;
        message: string;
    }>;
}
/**
 * Creates a strict validator function for a Zod schema.
 * Throws on validation failure with a descriptive error message.
 *
 * @param schema - The Zod schema to validate against
 * @param serviceName - Human-readable service name for error messages
 * @returns A validator function that parses and returns typed data
 */
export declare function createValidator<T>(schema: z.ZodType<T>, serviceName: string): (data: unknown) => T;
/**
 * Creates a safe validator function for a Zod schema.
 * Never throws; returns a ValidationResult with success/failure information.
 * On failure, logs a warning but does not throw.
 *
 * @param schema - The Zod schema to validate against
 * @param serviceName - Human-readable service name for log messages
 * @returns A safe validator function that returns a ValidationResult
 */
export declare function createSafeValidator<T>(schema: z.ZodType<T>, serviceName: string): (data: unknown) => ValidationResult<T>;