import type { ShippingZoneRow } from '../../../../types/db/index.js'; export interface ZoneAddressFilter { country: string; /** The stored `administrative_area` key (`US-CA`). */ administrativeArea?: string | null; /** Reserved for postal-code-aware zone matching; not used yet in v1. */ postalCode?: string | null; } /** * Resolve the shipping zones that cover a given destination address. * * A zone matches iff: * (a) the destination country is in the zone's `shipping_zone_country` rows; AND * (b) either (i) the zone has no `shipping_zone_region` rows at level * `administrative_area` for that country (the whole country is covered), * or (ii) the destination's administrative-area key matches one of those * rows. Keys are compared as stored; a retired key on a zone matches no * new address because the form no longer offers it (spec § 3.3). * * Multiple zones may match a single address — overlapping coverage is allowed. * The orchestrator iterates over every matching zone and fans out provider * calls per zone. * * See wiki/shipping-provider-design.md → "Data flow" / "Listing methods at checkout". */ export declare function resolveZonesForAddress(filter: ZoneAddressFilter): Promise;