@temboplus/frontend-core 0.3.0-beta.2 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (16) hide show
  1. package/README.md +38 -100
  2. package/dist/index.cjs.js +3 -3
  3. package/dist/index.cjs.js.map +1 -1
  4. package/dist/index.d.ts +0 -1
  5. package/dist/index.esm.js +2 -2
  6. package/dist/index.esm.js.map +1 -1
  7. package/dist/models/bank/bank.d.ts +7 -16
  8. package/dist/models/bank/bank.types.d.ts +1 -1
  9. package/dist/models/country/country.d.ts +8 -533
  10. package/dist/models/currency/currency.d.ts +4 -280
  11. package/dist/models/phone-number/mno/mno.types.d.ts +1 -2
  12. package/dist/services/index.d.ts +0 -1
  13. package/package.json +4 -6
  14. package/dist/reports/index.d.ts +0 -1
  15. package/dist/reports/report-manager.d.ts +0 -173
  16. package/dist/services/config.d.ts +0 -12
package/dist/models/bank/bank.d.ts CHANGED
@@ -128,16 +128,14 @@ export declare class BankService {
128
128
  private constructor();
129
129
  /**
130
130
  * Gets the singleton instance of BankService.
131
- * Initializes known countries synchronously on first call.
132
- * Consider async initialization if data loading becomes async.
133
131
  */
134
132
  static getInstance(): BankService;
135
133
  /**
136
- * Initializes bank data for a specific country synchronously.
134
+ * Loads bank data for a specific country synchronously.
137
135
  * @param countryCode The ISO country code (e.g., 'TZ', 'KE').
138
- * @returns True if successful or already loaded, false on failure.
136
+ * @returns The loaded country data, or undefined on failure.
139
137
  */
140
- initializeCountry(countryCode: ISO2CountryCode): boolean;
138
+ private loadCountryData;
141
139
  /**
142
140
  * Retrieves the loaded data structure for a given country.
143
141
  * Ensures country is initialized.
@@ -169,25 +167,18 @@ export declare class BankService {
169
167
  */
170
168
  detectBank(swiftCode: string): Bank | undefined;
171
169
  /**
172
- * Searches for banks within a specific country by name, SWIFT code, or former names.
170
+ * Searches for banks within a specific country by SWIFT code.
173
171
  * @param countryCode The ISO country code.
174
- * @param searchTerm The term to search for (case-insensitive).
172
+ * @param searchTerm The SWIFT code fragment to search for (case-insensitive).
175
173
  * @param limit Max number of results.
176
174
  * @returns An array of matching Bank instances.
177
175
  */
178
176
  searchBanks(countryCode: ISO2CountryCode, searchTerm: string, limit?: number): Bank[];
179
177
  /**
180
- * Searches for banks across all supported countries by name, SWIFT code, or former names.
181
- * @param searchTerm The term to search for (case-insensitive).
178
+ * Searches for banks across all supported countries by SWIFT code.
179
+ * @param searchTerm The SWIFT code fragment to search for (case-insensitive).
182
180
  * @param limit Max number of results.
183
181
  * @returns An array of matching Bank instances from all supported countries.
184
182
  */
185
183
  searchAllBanks(searchTerm: string, limit?: number): Bank[];
186
- /**
187
- * Finds banks that were formerly known by a specific name.
188
- * @param formerName The former name to search for (case-insensitive).
189
- * @param countryCode Optional country code to limit the search.
190
- * @returns An array of Bank instances that match the former name.
191
- */
192
- findByFormerName(formerName: string, countryCode?: ISO2CountryCode): Bank[];
193
184
  }
package/dist/models/bank/bank.types.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  export declare const KEBankSwiftCodesSet: Set<string>;
2
2
  export declare const TZBankSwiftCodesSet: Set<string>;
3
- export type KEBankSwiftCode = "KCBLKENX" | "EQBLKENX" | "KCOOKENX" | "SCBLKENX" | "BARCKENX" | "CBAFKENX" | "DTKEKENX" | "FABLKENA" | "CITIKENA" | "HFCOKENX" | "SBICKENX" | "NBKEKENX" | "AFRIKENX" | "GTBOKENX" | "IMBLKENX" | "ECOCKENX" | "BARBKENX" | "BKIDKENX" | "UNAFKENX" | "SGKENX";
3
+ export type KEBankSwiftCode = "ABNGKENA" | "ABCLKENA" | "AFRIKENX" | "BARBKENA" | "CRMFKENA" | "CHFIKENX" | "CITIKENA" | "KCOOKENA" | "MYBKKENA" | "CONKKENA" | "CRBTKENA" | "DEVKKENA" | "DTKEKENA" | "DUIBKENA" | "ECOCKENA" | "EQBLKENA" | "FABLKENA" | "FAUMKENA" | "GTBIKENA" | "GUARKENA" | "GAFRKENA" | "HBZUKENA" | "HFCOKENA" | "IMBLKENA" | "KWMIKENX" | "CIFIKENA" | "MORBKENA" | "MIEKKENA" | "NBKEKENX" | "CBAFKENX" | "PAUTKENA" | "IFCBKENA" | "PRIEKENX" | "SBMKKENA" | "SIDNKENA" | "SBICKENX" | "SCBLKENX" | "VICMKENA";
4
4
  export type TZBankSwiftCode = "CORUTZTZ" | "PBZATZTZ" | "SCBLTZTX" | "SBICTZTX" | "CITITZTZ" | "EUAFTZTZ" | "DTKETZTZ" | "AKCOTZTZ" | "EXTNTZTZ" | "KLMJTZTZ" | "NLCBTZTX" | "NMIBTZTZ" | "KCBLTZTZ" | "HABLTZTZ" | "BKMYTZTZ" | "BARCTZTZ" | "IMBLTZTZ" | "CBAFTZTZ" | "DASUTZTZ" | "BARBTZTZ" | "AZANTZTZ" | "UCCTTZTZ" | "FMBZTZTX" | "ACTZTZTZ" | "BKIDTZTZ" | "UNAFTZTZ" | "MKCBTZTZ" | "ECOCTZTZ" | "MWCBTZTZ" | "FIRNTZTX" | "AMNNTZTZ" | "EQBLTZTZ" | "TAPBTZTZ" | "MBTLTZTZ" | "CNRBTZTZ" | "MWCOTZTZ" | "GTBITZTZ" | "YETMTZTZ" | "CDSHTZTZ";
5
5
  export type BankSwiftCode = KEBankSwiftCode | TZBankSwiftCode;
package/dist/models/country/country.d.ts CHANGED
@@ -7,16 +7,15 @@
7
7
  * These two classes have been intentionally placed in the same file to resolve
8
8
  * a circular dependency issue. The original implementation had these in separate files:
9
9
  *
10
- * - Country class: Defines country properties and static accessors
10
+ * - Country class: Defines country properties and lookup helpers
11
11
  * - CountryService class: Loads country data and provides instance methods
12
12
  *
13
13
  * The circular dependency occurred because:
14
- * 1. Country needed CountryService to initialize its static properties
14
+ * 1. Country needed CountryService for centralized lookups
15
15
  * 2. CountryService needed Country to create Country instances
16
16
  *
17
17
  * By combining both classes in a single file:
18
18
  * - We ensure proper initialization order
19
- * - All static properties are immediately available after import
20
19
  * - The public API remains unchanged
21
20
  *
22
21
  * This approach also better encapsulates related functionality in a single module,
@@ -85,496 +84,6 @@ export declare class Country {
85
84
  private readonly _region;
86
85
  private readonly _currencyCode;
87
86
  private readonly _dialCode;
88
- static readonly AF: Country;
89
- static readonly AX: Country;
90
- static readonly AL: Country;
91
- static readonly DZ: Country;
92
- static readonly AS: Country;
93
- static readonly AD: Country;
94
- static readonly AO: Country;
95
- static readonly AI: Country;
96
- static readonly AQ: Country;
97
- static readonly AG: Country;
98
- static readonly AR: Country;
99
- static readonly AM: Country;
100
- static readonly AW: Country;
101
- static readonly AU: Country;
102
- static readonly AT: Country;
103
- static readonly AZ: Country;
104
- static readonly BS: Country;
105
- static readonly BH: Country;
106
- static readonly BD: Country;
107
- static readonly BB: Country;
108
- static readonly BY: Country;
109
- static readonly BE: Country;
110
- static readonly BZ: Country;
111
- static readonly BJ: Country;
112
- static readonly BM: Country;
113
- static readonly BT: Country;
114
- static readonly BO: Country;
115
- static readonly BA: Country;
116
- static readonly BW: Country;
117
- static readonly BV: Country;
118
- static readonly BR: Country;
119
- static readonly IO: Country;
120
- static readonly BN: Country;
121
- static readonly BG: Country;
122
- static readonly BF: Country;
123
- static readonly BI: Country;
124
- static readonly KH: Country;
125
- static readonly CM: Country;
126
- static readonly CA: Country;
127
- static readonly CV: Country;
128
- static readonly KY: Country;
129
- static readonly CF: Country;
130
- static readonly TD: Country;
131
- static readonly CL: Country;
132
- static readonly CN: Country;
133
- static readonly CX: Country;
134
- static readonly CC: Country;
135
- static readonly CO: Country;
136
- static readonly KM: Country;
137
- static readonly CG: Country;
138
- static readonly CD: Country;
139
- static readonly CK: Country;
140
- static readonly CR: Country;
141
- static readonly CI: Country;
142
- static readonly HR: Country;
143
- static readonly CU: Country;
144
- static readonly CY: Country;
145
- static readonly CZ: Country;
146
- static readonly DK: Country;
147
- static readonly DJ: Country;
148
- static readonly DM: Country;
149
- static readonly DO: Country;
150
- static readonly EC: Country;
151
- static readonly EG: Country;
152
- static readonly SV: Country;
153
- static readonly GQ: Country;
154
- static readonly ER: Country;
155
- static readonly EE: Country;
156
- static readonly ET: Country;
157
- static readonly FK: Country;
158
- static readonly FO: Country;
159
- static readonly FJ: Country;
160
- static readonly FI: Country;
161
- static readonly FR: Country;
162
- static readonly GF: Country;
163
- static readonly PF: Country;
164
- static readonly TF: Country;
165
- static readonly GA: Country;
166
- static readonly GM: Country;
167
- static readonly GE: Country;
168
- static readonly DE: Country;
169
- static readonly GH: Country;
170
- static readonly GI: Country;
171
- static readonly GR: Country;
172
- static readonly GL: Country;
173
- static readonly GD: Country;
174
- static readonly GP: Country;
175
- static readonly GU: Country;
176
- static readonly GT: Country;
177
- static readonly GG: Country;
178
- static readonly GN: Country;
179
- static readonly GW: Country;
180
- static readonly GY: Country;
181
- static readonly HT: Country;
182
- static readonly HM: Country;
183
- static readonly VA: Country;
184
- static readonly HN: Country;
185
- static readonly HK: Country;
186
- static readonly HU: Country;
187
- static readonly IS: Country;
188
- static readonly IN: Country;
189
- static readonly ID: Country;
190
- static readonly IR: Country;
191
- static readonly IQ: Country;
192
- static readonly IE: Country;
193
- static readonly IM: Country;
194
- static readonly IL: Country;
195
- static readonly IT: Country;
196
- static readonly JM: Country;
197
- static readonly JP: Country;
198
- static readonly JE: Country;
199
- static readonly JO: Country;
200
- static readonly KZ: Country;
201
- static readonly KE: Country;
202
- static readonly KI: Country;
203
- static readonly KP: Country;
204
- static readonly KR: Country;
205
- static readonly KW: Country;
206
- static readonly KG: Country;
207
- static readonly LA: Country;
208
- static readonly LV: Country;
209
- static readonly LB: Country;
210
- static readonly LS: Country;
211
- static readonly LR: Country;
212
- static readonly LY: Country;
213
- static readonly LI: Country;
214
- static readonly LT: Country;
215
- static readonly LU: Country;
216
- static readonly MO: Country;
217
- static readonly MK: Country;
218
- static readonly MG: Country;
219
- static readonly MW: Country;
220
- static readonly MY: Country;
221
- static readonly MV: Country;
222
- static readonly ML: Country;
223
- static readonly MT: Country;
224
- static readonly MH: Country;
225
- static readonly MQ: Country;
226
- static readonly MR: Country;
227
- static readonly MU: Country;
228
- static readonly YT: Country;
229
- static readonly MX: Country;
230
- static readonly FM: Country;
231
- static readonly MD: Country;
232
- static readonly MC: Country;
233
- static readonly MN: Country;
234
- static readonly ME: Country;
235
- static readonly MS: Country;
236
- static readonly MA: Country;
237
- static readonly MZ: Country;
238
- static readonly MM: Country;
239
- static readonly NA: Country;
240
- static readonly NR: Country;
241
- static readonly NP: Country;
242
- static readonly NL: Country;
243
- static readonly NC: Country;
244
- static readonly NZ: Country;
245
- static readonly NI: Country;
246
- static readonly NE: Country;
247
- static readonly NG: Country;
248
- static readonly NU: Country;
249
- static readonly NF: Country;
250
- static readonly MP: Country;
251
- static readonly NO: Country;
252
- static readonly OM: Country;
253
- static readonly PK: Country;
254
- static readonly PW: Country;
255
- static readonly PS: Country;
256
- static readonly PA: Country;
257
- static readonly PG: Country;
258
- static readonly PY: Country;
259
- static readonly PE: Country;
260
- static readonly PH: Country;
261
- static readonly PN: Country;
262
- static readonly PL: Country;
263
- static readonly PT: Country;
264
- static readonly PR: Country;
265
- static readonly QA: Country;
266
- static readonly RE: Country;
267
- static readonly RO: Country;
268
- static readonly RU: Country;
269
- static readonly RW: Country;
270
- static readonly SH: Country;
271
- static readonly KN: Country;
272
- static readonly LC: Country;
273
- static readonly PM: Country;
274
- static readonly VC: Country;
275
- static readonly WS: Country;
276
- static readonly SM: Country;
277
- static readonly ST: Country;
278
- static readonly SA: Country;
279
- static readonly SN: Country;
280
- static readonly RS: Country;
281
- static readonly SC: Country;
282
- static readonly SL: Country;
283
- static readonly SG: Country;
284
- static readonly SK: Country;
285
- static readonly SI: Country;
286
- static readonly SB: Country;
287
- static readonly SO: Country;
288
- static readonly ZA: Country;
289
- static readonly GS: Country;
290
- static readonly SS: Country;
291
- static readonly ES: Country;
292
- static readonly LK: Country;
293
- static readonly SD: Country;
294
- static readonly SR: Country;
295
- static readonly SJ: Country;
296
- static readonly SZ: Country;
297
- static readonly SE: Country;
298
- static readonly CH: Country;
299
- static readonly SY: Country;
300
- static readonly TW: Country;
301
- static readonly TJ: Country;
302
- static readonly TZ: Country;
303
- static readonly TH: Country;
304
- static readonly TL: Country;
305
- static readonly TG: Country;
306
- static readonly TK: Country;
307
- static readonly TO: Country;
308
- static readonly TT: Country;
309
- static readonly TN: Country;
310
- static readonly TR: Country;
311
- static readonly TM: Country;
312
- static readonly TC: Country;
313
- static readonly TV: Country;
314
- static readonly UG: Country;
315
- static readonly UA: Country;
316
- static readonly AE: Country;
317
- static readonly GB: Country;
318
- static readonly US: Country;
319
- static readonly UM: Country;
320
- static readonly UY: Country;
321
- static readonly UZ: Country;
322
- static readonly VU: Country;
323
- static readonly VE: Country;
324
- static readonly VN: Country;
325
- static readonly VG: Country;
326
- static readonly VI: Country;
327
- static readonly WF: Country;
328
- static readonly EH: Country;
329
- static readonly YE: Country;
330
- static readonly ZM: Country;
331
- static readonly ZW: Country;
332
- static readonly AFGHANISTAN: Country;
333
- static readonly ALAND_ISLANDS: Country;
334
- static readonly ALBANIA: Country;
335
- static readonly ALGERIA: Country;
336
- static readonly AMERICAN_SAMOA: Country;
337
- static readonly ANDORRA: Country;
338
- static readonly ANGOLA: Country;
339
- static readonly ANGUILLA: Country;
340
- static readonly ANTARCTICA: Country;
341
- static readonly ANTIGUA_AND_BARBUDA: Country;
342
- static readonly ARGENTINA: Country;
343
- static readonly ARMENIA: Country;
344
- static readonly ARUBA: Country;
345
- static readonly AUSTRALIA: Country;
346
- static readonly AUSTRIA: Country;
347
- static readonly AZERBAIJAN: Country;
348
- static readonly BAHAMAS: Country;
349
- static readonly BAHRAIN: Country;
350
- static readonly BANGLADESH: Country;
351
- static readonly BARBADOS: Country;
352
- static readonly BELARUS: Country;
353
- static readonly BELGIUM: Country;
354
- static readonly BELIZE: Country;
355
- static readonly BENIN: Country;
356
- static readonly BERMUDA: Country;
357
- static readonly BHUTAN: Country;
358
- static readonly BOLIVIA: Country;
359
- static readonly BOSNIA_AND_HERZEGOVINA: Country;
360
- static readonly BOTSWANA: Country;
361
- static readonly BOUVET_ISLAND: Country;
362
- static readonly BRAZIL: Country;
363
- static readonly BRITISH_INDIAN_OCEAN_TERRITORY: Country;
364
- static readonly BRITISH_VIRGIN_ISLANDS: Country;
365
- static readonly BRUNEI: Country;
366
- static readonly BULGARIA: Country;
367
- static readonly BURKINA_FASO: Country;
368
- static readonly BURUNDI: Country;
369
- static readonly CABO_VERDE: Country;
370
- static readonly CAMBODIA: Country;
371
- static readonly CAMEROON: Country;
372
- static readonly CANADA: Country;
373
- static readonly CAYMAN_ISLANDS: Country;
374
- static readonly CENTRAL_AFRICAN_REPUBLIC: Country;
375
- static readonly CHAD: Country;
376
- static readonly CHILE: Country;
377
- static readonly CHINA: Country;
378
- static readonly CHRISTMAS_ISLAND: Country;
379
- static readonly COCOS_ISLANDS: Country;
380
- static readonly COLOMBIA: Country;
381
- static readonly COMOROS: Country;
382
- static readonly CONGO: Country;
383
- static readonly COOK_ISLANDS: Country;
384
- static readonly COSTA_RICA: Country;
385
- static readonly COTE_DIVOIRE: Country;
386
- static readonly CROATIA: Country;
387
- static readonly CUBA: Country;
388
- static readonly CYPRUS: Country;
389
- static readonly CZECHIA: Country;
390
- static readonly DEMOCRATIC_REPUBLIC_OF_CONGO: Country;
391
- static readonly DENMARK: Country;
392
- static readonly DJIBOUTI: Country;
393
- static readonly DOMINICA: Country;
394
- static readonly DOMINICAN_REPUBLIC: Country;
395
- static readonly ECUADOR: Country;
396
- static readonly EGYPT: Country;
397
- static readonly EL_SALVADOR: Country;
398
- static readonly EQUATORIAL_GUINEA: Country;
399
- static readonly ERITREA: Country;
400
- static readonly ESTONIA: Country;
401
- static readonly ESWATINI: Country;
402
- static readonly ETHIOPIA: Country;
403
- static readonly FALKLAND_ISLANDS: Country;
404
- static readonly FAROE_ISLANDS: Country;
405
- static readonly FIJI: Country;
406
- static readonly FINLAND: Country;
407
- static readonly FRANCE: Country;
408
- static readonly FRENCH_GUIANA: Country;
409
- static readonly FRENCH_POLYNESIA: Country;
410
- static readonly FRENCH_SOUTHERN_TERRITORIES: Country;
411
- static readonly GABON: Country;
412
- static readonly GAMBIA: Country;
413
- static readonly GEORGIA: Country;
414
- static readonly GERMANY: Country;
415
- static readonly GHANA: Country;
416
- static readonly GIBRALTAR: Country;
417
- static readonly GREECE: Country;
418
- static readonly GREENLAND: Country;
419
- static readonly GRENADA: Country;
420
- static readonly GUADELOUPE: Country;
421
- static readonly GUAM: Country;
422
- static readonly GUATEMALA: Country;
423
- static readonly GUERNSEY: Country;
424
- static readonly GUINEA: Country;
425
- static readonly GUINEA_BISSAU: Country;
426
- static readonly GUYANA: Country;
427
- static readonly HAITI: Country;
428
- static readonly HEARD_ISLAND_AND_MCDONALD_ISLANDS: Country;
429
- static readonly HOLY_SEE: Country;
430
- static readonly HONDURAS: Country;
431
- static readonly HONG_KONG: Country;
432
- static readonly HUNGARY: Country;
433
- static readonly ICELAND: Country;
434
- static readonly INDIA: Country;
435
- static readonly INDONESIA: Country;
436
- static readonly IRAN: Country;
437
- static readonly IRAQ: Country;
438
- static readonly IRELAND: Country;
439
- static readonly ISLE_OF_MAN: Country;
440
- static readonly ISRAEL: Country;
441
- static readonly ITALY: Country;
442
- static readonly JAMAICA: Country;
443
- static readonly JAPAN: Country;
444
- static readonly JERSEY: Country;
445
- static readonly JORDAN: Country;
446
- static readonly KAZAKHSTAN: Country;
447
- static readonly KENYA: Country;
448
- static readonly KIRIBATI: Country;
449
- static readonly NORTH_KOREA: Country;
450
- static readonly SOUTH_KOREA: Country;
451
- static readonly KUWAIT: Country;
452
- static readonly KYRGYZSTAN: Country;
453
- static readonly LAO: Country;
454
- static readonly LATVIA: Country;
455
- static readonly LEBANON: Country;
456
- static readonly LESOTHO: Country;
457
- static readonly LIBERIA: Country;
458
- static readonly LIBYA: Country;
459
- static readonly LIECHTENSTEIN: Country;
460
- static readonly LITHUANIA: Country;
461
- static readonly LUXEMBOURG: Country;
462
- static readonly MACAO: Country;
463
- static readonly MACEDONIA: Country;
464
- static readonly MADAGASCAR: Country;
465
- static readonly MALAWI: Country;
466
- static readonly MALAYSIA: Country;
467
- static readonly MALDIVES: Country;
468
- static readonly MALI: Country;
469
- static readonly MALTA: Country;
470
- static readonly MARSHALL_ISLANDS: Country;
471
- static readonly MARTINIQUE: Country;
472
- static readonly MAURITANIA: Country;
473
- static readonly MAURITIUS: Country;
474
- static readonly MAYOTTE: Country;
475
- static readonly MEXICO: Country;
476
- static readonly MICRONESIA: Country;
477
- static readonly MOLDOVA: Country;
478
- static readonly MONACO: Country;
479
- static readonly MONGOLIA: Country;
480
- static readonly MONTENEGRO: Country;
481
- static readonly MONTSERRAT: Country;
482
- static readonly MOROCCO: Country;
483
- static readonly MOZAMBIQUE: Country;
484
- static readonly MYANMAR: Country;
485
- static readonly NAMIBIA: Country;
486
- static readonly NAURU: Country;
487
- static readonly NEPAL: Country;
488
- static readonly NETHERLANDS: Country;
489
- static readonly NEW_CALEDONIA: Country;
490
- static readonly NEW_ZEALAND: Country;
491
- static readonly NICARAGUA: Country;
492
- static readonly NIGER: Country;
493
- static readonly NIGERIA: Country;
494
- static readonly NIUE: Country;
495
- static readonly NORFOLK_ISLAND: Country;
496
- static readonly NORTHERN_MARIANA_ISLANDS: Country;
497
- static readonly NORWAY: Country;
498
- static readonly OMAN: Country;
499
- static readonly PAKISTAN: Country;
500
- static readonly PALAU: Country;
501
- static readonly PALESTINE: Country;
502
- static readonly PANAMA: Country;
503
- static readonly PAPUA_NEW_GUINEA: Country;
504
- static readonly PARAGUAY: Country;
505
- static readonly PERU: Country;
506
- static readonly PHILIPPINES: Country;
507
- static readonly PITCAIRN: Country;
508
- static readonly POLAND: Country;
509
- static readonly PORTUGAL: Country;
510
- static readonly PUERTO_RICO: Country;
511
- static readonly QATAR: Country;
512
- static readonly REUNION: Country;
513
- static readonly ROMANIA: Country;
514
- static readonly RUSSIA: Country;
515
- static readonly RWANDA: Country;
516
- static readonly SAINT_HELENA: Country;
517
- static readonly SAINT_KITTS_AND_NEVIS: Country;
518
- static readonly SAINT_LUCIA: Country;
519
- static readonly SAINT_PIERRE_AND_MIQUELON: Country;
520
- static readonly SAINT_VINCENT_AND_THE_GRENADINES: Country;
521
- static readonly SAMOA: Country;
522
- static readonly SAN_MARINO: Country;
523
- static readonly SAO_TOME_AND_PRINCIPE: Country;
524
- static readonly SAUDI_ARABIA: Country;
525
- static readonly SENEGAL: Country;
526
- static readonly SERBIA: Country;
527
- static readonly SEYCHELLES: Country;
528
- static readonly SIERRA_LEONE: Country;
529
- static readonly SINGAPORE: Country;
530
- static readonly SLOVAKIA: Country;
531
- static readonly SLOVENIA: Country;
532
- static readonly SOLOMON_ISLANDS: Country;
533
- static readonly SOMALIA: Country;
534
- static readonly SOUTH_AFRICA: Country;
535
- static readonly SOUTH_GEORGIA_AND_SANDWICH_ISLANDS: Country;
536
- static readonly SOUTH_SUDAN: Country;
537
- static readonly SPAIN: Country;
538
- static readonly SRI_LANKA: Country;
539
- static readonly SUDAN: Country;
540
- static readonly SURINAME: Country;
541
- static readonly SVALBARD_AND_JAN_MAYEN: Country;
542
- static readonly SWAZILAND: Country;
543
- static readonly SWEDEN: Country;
544
- static readonly SWITZERLAND: Country;
545
- static readonly SYRIA: Country;
546
- static readonly TAIWAN: Country;
547
- static readonly TAJIKISTAN: Country;
548
- static readonly TANZANIA: Country;
549
- static readonly THAILAND: Country;
550
- static readonly TIMOR_LESTE: Country;
551
- static readonly TOGO: Country;
552
- static readonly TOKELAU: Country;
553
- static readonly TONGA: Country;
554
- static readonly TRINIDAD_AND_TOBAGO: Country;
555
- static readonly TUNISIA: Country;
556
- static readonly TURKEY: Country;
557
- static readonly TURKMENISTAN: Country;
558
- static readonly TURKS_AND_CAICOS_ISLANDS: Country;
559
- static readonly TUVALU: Country;
560
- static readonly UGANDA: Country;
561
- static readonly UKRAINE: Country;
562
- static readonly UNITED_ARAB_EMIRATES: Country;
563
- static readonly UNITED_KINGDOM: Country;
564
- static readonly UNITED_STATES: Country;
565
- static readonly UNITED_STATES_MINOR_OUTLYING_ISLANDS: Country;
566
- static readonly URUGUAY: Country;
567
- static readonly UZBEKISTAN: Country;
568
- static readonly VANUATU: Country;
569
- static readonly VENEZUELA: Country;
570
- static readonly VIETNAM: Country;
571
- static readonly VIRGIN_ISLANDS_BRITISH: Country;
572
- static readonly VIRGIN_ISLANDS_US: Country;
573
- static readonly WALLIS_AND_FUTUNA: Country;
574
- static readonly WESTERN_SAHARA: Country;
575
- static readonly YEMEN: Country;
576
- static readonly ZAMBIA: Country;
577
- static readonly ZIMBABWE: Country;
578
87
  /**
579
88
  * Creates a new Country instance.
580
89
  * @param {string} _name - The common name of the country
@@ -660,12 +169,6 @@ export declare class Country {
660
169
  * @returns {Country | undefined} The country corresponding to the ISO-3 code or `undefined` if not found.
661
170
  */
662
171
  static fromIso3(iso3: ISO3CountryCode): Country | undefined;
663
- /**
664
- * Retrieves a country by its name.
665
- * @param {string} countryName The name of the country.
666
- * @returns {Country | undefined} The country corresponding to the name or `undefined` if not found.
667
- */
668
- static fromName(countryName: string): Country | undefined;
669
172
  /**
670
173
  * Returns all available countries.
671
174
  * @returns {Country[]} Array of all countries
@@ -693,26 +196,20 @@ export declare class Country {
693
196
  * @returns {SUB_REGION[]} Array of region enum values
694
197
  */
695
198
  static getRegions(): SUB_REGION[];
696
- /**
697
- * Validates if a given country name is valid
698
- * @param countryName The country name to validate
699
- * @returns True if the country name is valid
700
- */
701
- static isValidName(countryName?: string | null): boolean;
702
199
  /**
703
200
  * Checks the validity of the country data
704
201
  * @returns true if the country information is available and valid
705
202
  */
706
203
  validate(): boolean;
707
204
  /**
708
- * Attempts to create a Country instance from a country name or ISO code
709
- * @param input The country name or ISO code
205
+ * Attempts to create a Country instance from an ISO code.
206
+ * @param input The ISO-2 or ISO-3 code
710
207
  * @returns A Country instance if valid input, undefined otherwise
711
208
  */
712
209
  static from(input: string): Country | undefined;
713
210
  /**
714
211
  * Validates if the input can be used to construct a valid Country instance
715
- * @param input The country name or ISO code to validate
212
+ * @param input The ISO-2 or ISO-3 code to validate
716
213
  * @returns True if input can construct a valid country, false otherwise
717
214
  */
718
215
  static canConstruct(input?: string | null): boolean;
@@ -752,10 +249,8 @@ export declare class CountryService {
752
249
  private countryList;
753
250
  private codeRecord;
754
251
  private iso3Record;
755
- private nameRecord;
756
252
  private continentRecord;
757
253
  private regionRecord;
758
- private staticReferences;
759
254
  private constructor();
760
255
  /**
761
256
  * Gets the singleton instance of CountryService.
@@ -781,20 +276,11 @@ export declare class CountryService {
781
276
  * Should be called once when your application starts.
782
277
  */
783
278
  private initialize;
784
- /**
785
- * Initialize the static properties on the Country class
786
- */
787
- private initializeCountryStatics;
788
279
  /**
789
280
  * Gets all countries.
790
281
  * @returns {Country[]} Array of all countries
791
282
  */
792
283
  getAll(): Country[];
793
- /**
794
- * Gets static country references to be used by the Country class.
795
- * @returns {Map<string, Country>} Map of static references
796
- */
797
- getStaticReferences(): Map<string, Country>;
798
284
  /**
799
285
  * Gets all countries as a record.
800
286
  * @returns {Record<string, Country>} Record of country codes and country objects
@@ -813,13 +299,8 @@ export declare class CountryService {
813
299
  */
814
300
  getByRegion(region: SUB_REGION): Country[];
815
301
  /**
816
- * Gets the full name record mapping.
817
- * @returns {Record<string, Country>} Record of uppercase full name keys to country objects
818
- */
819
- getFullNameRecord(): Record<string, Country>;
820
- /**
821
- * Retrieves a country by its ISO-2 code.
822
- * @param {string} code The ISO-2 code of the country.
302
+ * Retrieves a country by its ISO-2 or ISO-3 code.
303
+ * @param {CountryCode} code The ISO code of the country.
823
304
  * @returns {Country | undefined} The country corresponding to the ISO code or `undefined` if not found.
824
305
  */
825
306
  fromCode(code: CountryCode): Country | undefined;
@@ -829,15 +310,9 @@ export declare class CountryService {
829
310
  * @returns {Country | undefined} The country corresponding to the ISO-3 code or `undefined` if not found.
830
311
  */
831
312
  fromIso3(iso3: ISO3CountryCode): Country | undefined;
832
- /**
833
- * Retrieves a country by its name.
834
- * @param {string} countryName The name of the country.
835
- * @returns {Country | undefined} The country corresponding to the name or `undefined` if not found.
836
- */
837
- fromName(countryName: string): Country | undefined;
838
313
  /**
839
314
  * Searches for countries that match the given search term.
840
- * @param {string} searchTerm - The partial name or code to search for.
315
+ * @param {string} searchTerm - The partial ISO-2 or ISO-3 code to search for.
841
316
  * @param {number} [limit=10] - Maximum number of results to return.
842
317
  * @returns {Country[]} Array of matching countries, limited to specified count.
843
318
  */