/**
 * Address service for Nova Poshta API
 * Handles all address-related operations
 */
import type { ClientContext } from '../core/client';
import type { GetSettlementsRequest, GetSettlementsResponse, GetSettlementCountryRegionRequest, GetSettlementCountryRegionResponse, GetCitiesRequest, GetCitiesResponse, GetStreetRequest, GetStreetResponse, SearchSettlementsRequest, SearchSettlementsResponse, SearchSettlementStreetsRequest, SearchSettlementStreetsResponse } from '../types/address';
/**
 * Service for managing address operations
 *
 * @example
 * ```typescript
 * // Get settlements (areas)
 * const settlements = await addressService.getSettlements();
 *
 * // Search for cities
 * const cities = await addressService.getCities({
 *   findByString: 'Kyiv'
 * });
 *
 * // Search settlements online
 * const searchResults = await addressService.searchSettlements({
 *   cityName: 'kyiv',
 *   page: 1,
 *   limit: 50
 * });
 * ```
 */
export declare class AddressService {
    readonly namespace: "address";
    private transport;
    private apiKey?;
    attach(ctx: ClientContext): void;
    /**
     * Get settlements (areas)
     * @description Retrieves list of settlement areas
     * @cacheable 12 hours
     */
    getSettlements(request?: GetSettlementsRequest): Promise<GetSettlementsResponse>;
    /**
     * Get settlement country regions
     * @description Retrieves list of settlement regions for a specific area
     * @cacheable 12 hours
     */
    getSettlementCountryRegion(request: GetSettlementCountryRegionRequest): Promise<GetSettlementCountryRegionResponse>;
    /**
     * Get cities
     * @description Retrieves list of cities with Nova Poshta offices
     * @cacheable 12 hours
     */
    getCities(request?: GetCitiesRequest): Promise<GetCitiesResponse>;
    /**
     * Get streets
     * @description Retrieves list of streets in a specific city
     * @cacheable 12 hours
     */
    getStreet(request: GetStreetRequest): Promise<GetStreetResponse>;
    /**
     * Search settlements online
     * @description Performs online search for settlements
     * @cacheable 1 hour
     */
    searchSettlements(request: SearchSettlementsRequest): Promise<SearchSettlementsResponse>;
    /**
     * Search settlement streets online
     * @description Performs online search for streets in a settlement
     * @cacheable 1 hour
     */
    searchSettlementStreets(request: SearchSettlementStreetsRequest): Promise<SearchSettlementStreetsResponse>;
}
//# sourceMappingURL=addressService.d.ts.map