import { type HttpPaymentStatusResponse } from "@aibtc/tx-schemas/http";
type HeaderValue = string | string[] | number | undefined | null;
type HeaderBag = Record<string, HeaderValue> | undefined;
export type CanonicalPaymentAction = "poll_same_payment" | "success" | "rebuild_sender" | "retry_bounded" | "stop_replaced" | "restart_payment" | "stop";
export interface CanonicalPaymentDecision {
    action: CanonicalPaymentAction;
    retryable: boolean;
    shouldReusePaymentId: boolean;
    shouldRebuild: boolean;
    shouldStopPollingOldPaymentId: boolean;
    summary: string;
}
export declare function normalizeCallerFacingStatus(status: unknown): HttpPaymentStatusResponse["status"] | undefined;
export declare function extractCanonicalPaymentHints(options: {
    payload?: unknown;
    paymentId?: string;
    responseHeaders?: HeaderBag;
    baseUrl?: string;
}): {
    paymentId?: string;
    status?: HttpPaymentStatusResponse["status"];
    checkStatusUrl?: string;
    txid?: string;
};
export declare function resolveCanonicalPaymentStatus(options: {
    payload?: unknown;
    paymentId?: string;
    responseHeaders?: HeaderBag;
    baseUrl?: string;
    fallbackCheckStatusUrl?: string;
    fetchImpl?: typeof fetch;
    onPoll?: (details: {
        paymentId?: string;
        checkStatusUrl: string;
        source: "canonical_hint" | "compat_fallback";
    }) => void;
}): Promise<HttpPaymentStatusResponse | null>;
export declare function classifyCanonicalPaymentStatus(status: HttpPaymentStatusResponse): CanonicalPaymentDecision;
export declare function formatCanonicalPaymentStatus(status: HttpPaymentStatusResponse): string;
export {};
//# sourceMappingURL=x402-payment-state.d.ts.map