vietnam-address-converter/dist/DataLoader.d.ts

Thư viện JavaScript/TypeScript để tự động chuyển đổi địa chỉ hành chính Việt Nam từ cũ sang mới theo Nghị quyết 202/2025/QH15

import { Province, Ward, WardMapping } from './types';
/**
 * Class để load và parse dữ liệu từ thư viện vietnam-address-database
 */
export declare class DataLoader {
    private rawData;
    private provinces;
    private wards;
    private wardMappings;
    /**
     * Load dữ liệu từ thư viện vietnam-address-database
     */
    loadFromFile(filePath?: string): Promise<void>;
    /**
     * Load dữ liệu từ URL (cho browser environment)
     */
    loadFromUrl(url?: string): Promise<void>;
    /**
     * Parse dữ liệu từ raw JSON thành các đối tượng có cấu trúc
     */
    private parseData;
    /**
     * Lấy danh sách tỉnh/thành phố
     */
    getProvinces(): Province[];
    /**
     * Lấy danh sách phường/xã
     */
    getWards(): Ward[];
    /**
     * Lấy danh sách mapping
     */
    getWardMappings(): WardMapping[];
    /**
     * Tìm tỉnh theo tên
     */
    findProvinceByName(name: string): Province | undefined;
    /**
     * Tìm phường/xã theo tên và mã tỉnh
     */
    findWardByName(name: string, provinceCode?: string): Ward | undefined;
    /**
     * Tìm mapping theo thông tin địa chỉ cũ
     */
    findMappingByOldAddress(wardName?: string, districtName?: string, provinceName?: string): WardMapping[];
    /**
     * Kiểm tra xem dữ liệu đã được load chưa
     */
    isDataLoaded(): boolean;
    /**
     * Lấy thống kê dữ liệu
     */
    getDataStats(): {
        provinces: number;
        wards: number;
        mappings: number;
    };
}