test-numbers-generator/dist/postcodeService.d.ts

Generate and validate European test phone numbers (mobile and landline) in safe, non-existent ranges.

/**
 * Haalt maximaal 10 unieke postcodes en het bereik van huisnummers op voor een opgegeven plaatsnaam via de PDOK Locatieserver.
 * @param {string} plaatsnaam - De naam van de plaats (bijv. 'Amsterdam')
 * @returns {Promise<Array<{ postcode: string, min: number, max: number }>>} - Array met postcode en huisnummerbereik
 */
export declare function fetchPostcodesEnNummerRangeByPlaatsnaam(plaatsnaam: string, maxPostcodes?: number): Promise<Array<{
    postcode: string;
    min: number;
    max: number;
}>>;
/**
 * Zoekt alle unieke postcodes in een plaats waar adressen voorkomen met een huisnummertoevoeging (bijv. 12A, 12-B).
 * @param {string} plaatsnaam - De naam van de plaats
 * @param {number} maxPostcodes - Maximaal aantal postcodes om op te halen (default 50)
 * @returns {Promise<Set<string>>} - Set met unieke postcodes (formaat: '1234 AB')
 */
export declare function fetchPostcodesMetHuisnummerToevoeging(plaatsnaam: string, maxPostcodes?: number): Promise<Set<string>>;
/**
 * Haalt adresgegevens (straatnaam, woonplaats) op via de PDOK Locatieserver op basis van postcode en huisnummer.
 * @param {string} postcode - Postcode in formaat '1234 AB' of '1234AB'
 * @param {string|number} huisnummer - Huisnummer (zonder toevoeging)
 * @returns {Promise<{ straatnaam: string, woonplaats: string } | null>} - Adresgegevens of null als niet gevonden
 */
export declare function checkAdresByPostcodeHuisnummer(postcode: string, huisnummer: string | number): Promise<{
    straatnaam: string;
    woonplaats: string;
} | null>;
/**
 * Haalt een willekeurig bestaand adres op in een opgegeven plaatsnaam.
 * @param {string} plaatsnaam - De naam van de plaats
 * @returns {Promise<{ postcode: string, huisnummer: number, straatnaam: string, woonplaats: string } | null>}
 */
export declare function getRandomAdresInPlaatsnaam(plaatsnaam: string): Promise<{
    postcode: string;
    huisnummer: number;
    straatnaam: string;
    woonplaats: string;
} | null>;
/**
 * Haalt een lijst van plaatsnamen op uit de PDOK Locatieserver en kiest er willekeurig één uit.
 * Gebruikt een random letter/cijfer als prefix voor meer variatie.
 */
export declare function getRandomPlaatsnaam(): Promise<string | null>;