import { GuardedResult } from "./model";
export type OnFailureHandler = (output: GuardedResult) => string | Record<string, unknown>;
/**
 * Built-in failure strategy factories.
 */
export declare const OnFailure: {
    /** Throw a GuardValidationError (or custom exception). Default behavior. */
    readonly raiseException: (message?: string) => OnFailureHandler;
    /** Log a warning and return the original result unchanged. */
    readonly log: (level?: "error" | "warn", message?: string) => OnFailureHandler;
    /** Silently return the original result (shadow/observe mode). */
    readonly noop: () => OnFailureHandler;
    /** Return a fixed fallback value instead of the original result. */
    readonly returnValue: (value: string | Record<string, unknown>) => OnFailureHandler;
};
/**
 * Resolve a string shorthand or callable to an OnFailureHandler.
 *
 * - "raise"  → OnFailure.raiseException()
 * - "log"    → OnFailure.log()
 * - "ignore" / "noop" → OnFailure.noop()
 * - any other string  → OnFailure.returnValue(string)
 * - callable          → used as-is
 */
export declare function resolveOnFailure(value: string | OnFailureHandler): OnFailureHandler;
//# sourceMappingURL=on-failure.d.ts.map