Skip to content

Commit 39aad53

Browse files
docs: update changelog and README for v0.3.0 ISO3 support
- Add changelog entry for v0.3.0 with ISO3 functionality - Update README with new Get Country by ISO3 Code operation - Add comprehensive examples showing ISO2 vs ISO3 usage - Include comparison table of country codes (BR/BRA, US/USA, etc.) - Clarify when to use each format and supported operations
1 parent b8d082a commit 39aad53

2 files changed

Lines changed: 52 additions & 4 deletions

File tree

CHANGELOG.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
77

88
## [Unreleased]
99

10+
## [0.1.3] - 2025-10-28
11+
12+
### Added
13+
- **New Operation**: "Get Country by ISO3 Code" - Support for 3-letter country codes
14+
- Comprehensive ISO2 to ISO3 mapping for all 249 countries
15+
- Automatic conversion from ISO3 to ISO2 for data lookup
16+
- Enhanced result includes both ISO2 and ISO3 codes in response
17+
- Examples: `USA` → United States, `BRA` → Brazil, `CAN` → Canada, `GBR` → United Kingdom
18+
19+
### Changed
20+
- **Clarified field descriptions**: Distinguished between ISO2 (2 letters) and ISO3 (3 letters) codes
21+
- **Updated operation descriptions**: "Get Country by Code" now specifies ISO2 support
22+
- **Enhanced error handling**: Proper validation and error messages for invalid ISO3 codes
23+
24+
### Technical
25+
- Created `iso-mappings.ts` with complete ISO2 ↔ ISO3 country code mappings
26+
- Added input validation for ISO3 codes with informative error messages
27+
- Extended node interface to support both ISO2 and ISO3 code inputs
28+
1029
## [0.2.0] - 2025-10-28
1130

1231
### Added
@@ -55,6 +74,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
5574
- **Imports**: Fixed country-state-city library imports for CommonJS compatibility
5675

5776
## [Links]
77+
- [0.1.3]: https://github.com/mimirtechco/n8n-nodes-country-state-city/releases/tag/v0.1.3
5878
- [0.2.0]: https://github.com/mimirtechco/n8n-nodes-country-state-city/releases/tag/v0.2.0
5979
- [0.1.0]: https://github.com/mimirtechco/n8n-nodes-country-state-city/releases/tag/v0.1.0
60-
- [Unreleased]: https://github.com/mimirtechco/n8n-nodes-country-state-city/compare/v0.2.0...HEAD
80+
- [Unreleased]: https://github.com/mimirtechco/n8n-nodes-country-state-city/compare/v0.1.3...HEAD

README.md

Lines changed: 31 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,11 +12,16 @@ npm install n8n-nodes-country-state-city
1212

1313
## Operações
1414

15-
### 🌍 Get Country by Code
16-
Retorna os detalhes de um país com base no seu código ISO 2.
15+
### 🌍 Get Country by Code (ISO2)
16+
Retorna os detalhes de um país com base no seu código ISO2 (2 letras).
1717
- **Input**: Country Code (ex: `US`, `BR`, `CA`)
1818
- **Output**: Nome, código ISO, coordenadas, etc.
1919

20+
### 🌎 Get Country by ISO3 Code
21+
Retorna os detalhes de um país com base no seu código ISO3 (3 letras).
22+
- **Input**: Country ISO3 Code (ex: `USA`, `BRA`, `CAN`)
23+
- **Output**: Nome, códigos ISO2 e ISO3, coordenadas, etc.
24+
2025
### 🏛️ Get States by Country
2126
Retorna uma lista de todos os estados/províncias de um determinado país.
2227
- **Input**: Country Code (ex: `US`, `BR`, `CA`)
@@ -42,10 +47,18 @@ Retorna uma lista de todas as cidades de um determinado estado/província.
4247

4348
## Exemplos de Uso
4449

45-
### Obter informações do Brasil
50+
### Obter informações do Brasil (ISO2)
4651
- Operation: `Get Country by Code`
4752
- Country Code: `BR`
4853

54+
### Obter informações do Brasil (ISO3)
55+
- Operation: `Get Country by ISO3 Code`
56+
- Country ISO3 Code: `BRA`
57+
58+
### Obter informações dos Estados Unidos (ISO3)
59+
- Operation: `Get Country by ISO3 Code`
60+
- Country ISO3 Code: `USA`
61+
4962
### Listar estados do Brasil
5063
- Operation: `Get States by Country`
5164
- Country Code: `BR`
@@ -60,6 +73,21 @@ Retorna uma lista de todas as cidades de um determinado estado/província.
6073
- Country Code: `BR`
6174
- State Code: `SP`
6275

76+
## Códigos Suportados
77+
78+
### ISO2 vs ISO3
79+
| País | ISO2 | ISO3 |
80+
|------|------|------|
81+
| Brasil | `BR` | `BRA` |
82+
| Estados Unidos | `US` | `USA` |
83+
| Canadá | `CA` | `CAN` |
84+
| Reino Unido | `GB` | `GBR` |
85+
| França | `FR` | `FRA` |
86+
| Alemanha | `DE` | `DEU` |
87+
| Japão | `JP` | `JPN` |
88+
89+
> **Nota**: Ambos os formatos são suportados - use ISO2 para operações de estado/cidade, e ISO2 ou ISO3 para busca de países.
90+
6391
## Changelog
6492

6593
Veja [CHANGELOG.md](CHANGELOG.md) para o histórico completo de mudanças.

0 commit comments

Comments
 (0)