# GeoThai NPM Packages Changelog ## 3.0.1 ### Patch Changes - 57adb4c: Update bundled data to include district name fix: "Rat Thewi" → "Ratchathewi". ## 3.0.0 - 2026-01-06 ### Changed - **BREAKING:** Migrated data structure from v3 (flat references) to v4 (nested objects) - **BREAKING:** `Province.districts` now contains full `District[]` objects instead of `Array` codes - **BREAKING:** `District.subdistricts` now contains full `Subdistrict[]` objects instead of `Array` codes - **BREAKING:** `PostalCode` type completely restructured with new `postal_code` field and `addresses: PostalCodeAddress[]` instead of `code` and `subdistricts: Array` ### Added - New `name_en_lower` and `name_th_lower` fields to `Province`, `District`, and `Subdistrict` types for improved autocomplete support - New `PostalCodeAddress` type with full location details (province, district, subdistrict names and codes) - JSDoc documentation for all public API functions - New export `rawProvinces` from province service ### Migration Guide **Province Usage:** ```typescript // Before (v2.0.1) const province = getProvinceByCode("10"); const districtCodes = province.districts; // Array // After (v3.0.0) const province = getProvinceByCode("10"); const districts = province.districts; // District[] - full objects const firstDistrict = districts[0].name_en; // Direct access ``` **District Usage:** ```typescript // Before (v2.0.1) const district = getDistrictByCode("1001"); const subdistrictCodes = district.subdistricts; // Array // After (v3.0.0) const district = getDistrictByCode("1001"); const subdistricts = district.subdistricts; // Subdistrict[] - full objects const firstSubdistrict = subdistricts[0].name_en; // Direct access ``` **PostalCode Usage:** ```typescript // Before (v2.0.1) const postal = getPostalCode("10100"); const code = postal.code; // number const subdistrictCodes = postal.subdistricts; // Array // After (v3.0.0) const postal = getPostalCode("10100"); const code = postal.postal_code; // renamed from 'code' const addresses = postal.addresses; // PostalCodeAddress[] with full details const firstAddress = addresses[0].province_name_en; // Direct access to names ``` ## 2.0.1 - 2025-01-05 ### Fixed - Updated `.npmignore` to replace `pnpm-lock.yaml` with `bun.lock` and ignore all source files for cleaner package distribution **Full Changelog**: ## 2.0.0 - 2025-05-08 ### Changed - **BREAKING:** Updated the data structure for provinces, districts, subdistricts, and postal codes. The internal JSON format has changed, which impacts the shape of the exported types. - **BREAKING:** The following functions now expect different type shapes for their input and output due to the updated data definitions: - `getProvincesByCriterion(criterion: Partial)` - `getDistrictsByCriterion(criterion: Partial)` - `getSubdistrictsByCriterion(criterion: Partial)` > [!WARNING] > While function names and signatures remain the same, the change in data types > can result in **TypeScript compilation errors** or runtime issues if existing > code assumes the old structure. - Services for provinces, districts, subdistricts, and postal codes have been updated to work with the new structure. This improves consistency and prepares for better scalability, but may require consumers to adjust their usage of types. ## 1.0.0 - 2024-08-17 ### Added - **Integrated Data Structure**: Replaced individual JSON files with a more integrated data structure, featuring nested relationships among provinces, districts, and subdistricts. Added additional postal code data with `src/data/postal_codes.json`. - **Metadata**: Introduced `src/data/metadata.json` to provide detailed information about data versioning and statistics. - **Postal Code Service**: Added new service `src/services/postal-code.ts` to handle postal code data, including retrieval functions. - **New Type Definitions**: Added new TypeScript types for metadata and postal codes: - `src/types/Metadata.ts` - `src/types/PostalCode.ts` ### Changed - **Data Files**: Updated data files for provinces, districts, and subdistricts to reflect the new integrated structure and added postal code data. - **Service Implementations**: Refactored existing services (`province.ts`, `district.ts`, `subdistrict.ts`) to accommodate the new data structure: - Updated identifiers from `province_id`, `district_id`, `subdistrict_id` to `id`. - Adjusted data retrieval logic to work with the new nested data format. - **Index and Exports**: Updated `src/index.ts` to include the new postal code service and metadata. - **Test Updates**: Revised tests to match the updated data structure and identifiers. Added new tests for postal codes and metadata. ### Improvements - **Data Integration**: Enhanced data organization by integrating related entities and adding postal code information, improving data accessibility and usability. - **Performance**: Improved service performance and consistency with the updated data structure and new caching mechanisms. ## 0.2.0 - 2024-08-15 ### Minor Changes #### Added - **Caching**: Introduced `src/utils/cache.ts` to cache results and improve performance for frequently accessed data. - **Service Creation Utility**: Added `src/utils/create-service.ts` to simplify the creation of data services with caching and lookup functionality. #### Changed - **District Service**: Updated to use caching and the `createService` utility. Functions now cache results for better performance. - **Province Service**: Refactored to leverage caching and the `createService` utility. Improved performance with result caching. - **Subdistrict Service**: Enhanced with caching and the `createService` utility. Optimized data retrieval with cached results. #### Improvements - Improved data retrieval performance across services by integrating caching mechanisms. - Modularized service creation with `createService` utility, promoting code reuse and consistency. - Enhanced maintainability and performance by centralizing caching logic in `src/utils/cache.ts`. ## 0.1.0 - 2024-08-14 ### Minor Changes #### Added - **New Services**: Split functionality into modular services: - `src/services/province.ts`: Handles all province-related operations. - `src/services/district.ts`: Handles all district-related operations. - `src/services/subdistrict.ts`: Handles all subdistrict-related operations. - **Utility Function**: Added `src/utils/criteria-matcher.ts` for consistent criteria-based filtering across services. #### Changed - **Code Refactoring**: - Moved logic from `src/index.ts` to the new service modules. - Simplified `index.ts` by re-exporting the services and utilities. - **Test Structure**: - Removed outdated tests (`tests/index.test.ts`). - Introduced new tests for individual services (`tests/district.test.ts`, `tests/province.test.ts`, `tests/subdistrict.test.ts`). #### Removed - **Deprecated Test**: Removed `tests/index.test.ts` in favor of more granular test coverage in new service-specific tests. #### Improvements - Enhanced code organization by modularizing the service logic, improving maintainability and readability. - Centralized criteria matching logic in a dedicated utility function, ensuring consistency across different modules. ## 0.0.2 - 2024-08-13 ### Patch Changes #### Improvements - Added TypeScript type annotations to `Map` objects for provinces, districts, and subdistricts to enhance type safety. - Replaced spread operator with `Array.from()` for converting `Map` values to arrays for consistency and readability. - Refined filtering logic in `getProvincesByCriterion`, `getDistrictsByCriterion`, and `getSubdistrictsByCriterion` functions to use appropriate TypeScript type assertions. #### Code Cleanup - Enhanced type safety and clarity in `src/index.ts`. ## 0.0.1 - 2024-08-13 ### Initial Release - **Data Integration**: Imported and initialized data for provinces, districts, and subdistricts from JSON files. - **Data Storage**: Created `Map` objects to efficiently store and access provinces, districts, and subdistricts by their IDs. - **APIs Implemented**: - `getAllProvinces()`: Retrieves all provinces. - `getProvinceById(provinceId: number)`: Retrieves a single province by its ID. - `getAllDistricts()`: Retrieves all districts. - `getDistrictById(districtId: number)`: Retrieves a single district by its ID. - `getAllSubdistricts()`: Retrieves all subdistricts. - `getSubdistrictById(subdistrictId: number)`: Retrieves a single subdistrict by its ID. - `getProvincesByCriterion(criterion: Partial)`: Retrieves provinces matching a specific criterion. - `getDistrictsByCriterion(criterion: Partial)`: Retrieves districts matching a specific criterion. - `getSubdistrictsByCriterion(criterion: Partial)`: Retrieves subdistricts matching a specific criterion. - **Type Definitions**: Utilized TypeScript types for provinces, districts, and subdistricts for better type safety and code clarity.