/**
 * @copyright Sister Software
 * @license AGPL-3.0
 * @author Teffen Ellis, et al.
 *
 *   Fetch the GeoNames per-country postal-code exports — the only source in this family that includes a
 *   `(postcode, locality, region)` triple with the names inline.
 *
 *   Source : https://download.geonames.org/export/zip/<CC>.zip
 *   License: CC-BY-4.0, attribute "GeoNames". Tier B.
 *
 *   GeoNames publishes roughly 80 countries. An absent country fails as one entry, never as the whole run.
 */
import type { BaseFetchOptions, FetchSummary } from "#tools/fetch/download";
/**
 * Countries fetched when the caller names none.
 *
 * Venezuela is deliberately absent because GeoNames does not publish it.
 */
export declare const GEONAMES_POSTAL_DEFAULT_COUNTRIES: readonly ["PT", "AU", "NZ", "IE", "BR", "ZA", "MX"];
export interface FetchGeonamesPostalOptions extends BaseFetchOptions {
    /**
     * ISO alpha-2 codes in any casing.
     *
     * Defaults to `{@linkcode GEONAMES_POSTAL_DEFAULT_COUNTRIES}`.
     */
    countries?: readonly string[];
    /**
     * Export directory to read from.
     *
     * Defaults to GeoNames' own, so the 404-is-coverage behavior can be exercised against a local server.
     */
    baseURL?: string;
}
/**
 * Download the requested GeoNames postal zips into `<outRoot>/geonames-postal/` with
 * a sibling `manifest.json`; a country the source does not cover is counted as failed
 * and recorded in `failedCodes` without stopping the rest.
 */
export declare function fetchGeonamesPostal(options: FetchGeonamesPostalOptions, report?: (line: string) => void): Promise<FetchSummary>;
//# sourceMappingURL=postal.d.ts.map