import { AcurisClient } from "@acuris-geo/av-sdk";
import type { Assessment, UcpDestinationCheck, UcpMessage, UcpOptions, UcpShippingDestination } from "./types.js";
/**
 * Validate a UCP shipping destination inside a merchant checkout-session
 * endpoint (POST /checkout-sessions and PUT /checkout-sessions/{id}).
 *
 *   const check = await validateUcpDestination(destination, { apiKey });
 *   checkout.messages.push(...check.messages);
 *   if (check.correctedDestination) {
 *     // echo the standardized form back as the authoritative destination
 *   }
 *
 * Codes follow Google's UCP error-code registry: `missing_fulfillment_info`
 * for absent fields, `address_undeliverable` (core-spec standard error) when
 * the house number does not exist, `address_unverifiable` when no confident
 * match is found. All address errors use severity `recoverable` so the agent
 * platform can correct the input and retry, per the spec's standard-error
 * guidance.
 */
export declare function validateUcpDestination(destination: UcpShippingDestination, options?: UcpOptions, clientOverride?: AcurisClient): Promise<UcpDestinationCheck>;
/** Pure mapper: Assessment → UCP `messages[]` entries. Exported for custom flows. */
export declare function toUcpMessages(assessment: Assessment, basePath: string, options?: UcpOptions): UcpMessage[];
export declare function composeStreetLine(street?: string, houseNumber?: string, countryIso3?: string): string;
/**
 * UCP spec: alpha-2 recommended; alpha-3 and full country names tolerated.
 * Returns Acuris ISO-3 lowercase, or undefined when unparseable.
 */
export declare function parseUcpCountry(country?: string): string | undefined;
//# sourceMappingURL=ucp.d.ts.map