@temboplus/frontend-core 0.4.0 → 0.4.1

package/dist/models/amount/index.d.ts

@@ -1 +0,0 @@
-export * from "./amount.js";

package/dist/models/bank/bank.d.ts

@@ -1,184 +0,0 @@
-import { ISO2CountryCode } from "../country/country.types.js";
-import type { BankSwiftCode, KEBankSwiftCode, TZBankSwiftCode } from "./bank.types.js";
-import { z } from "zod";
-import { BankJSONSchema } from "./bank.schema.js";
-/**
- * Infer the BankJSON type from the schema
- */
-export type BankJSON = z.infer<typeof BankJSONSchema>;
-export declare class Bank {
-    /**
-     * The full registered name of the bank.
-     */
-    readonly fullName: string;
-    /**
-     * The commonly used short name or abbreviation for the bank.
-     */
-    readonly shortName: string;
-    /**
-     * The SWIFT/BIC code for the bank's head office.
-     */
-    readonly swiftCode: TZBankSwiftCode | KEBankSwiftCode;
-    /**
-     * The ISO 3166-1 alpha-2 country code (e.g., 'TZ', 'KE').
-     */
-    readonly countryCode: ISO2CountryCode;
-    /**
-     * Optional list of former names the bank was known by.
-     * Useful for historical reference and search functionality.
-     */
-    readonly formerNames?: string[];
-    /**
-     * Creates a new Bank instance.
-     *
-     * @param fullName The full registered name of the bank
-     * @param shortName The commonly used short name or abbreviation for the bank
-     * @param swiftCode The SWIFT/BIC code for the bank's head office
-     * @param countryCode The ISO 3166-1 alpha-2 country code
-     * @param formerNames Optional list of former names the bank was known by
-     */
-    constructor(fullName: string, shortName: string, swiftCode: TZBankSwiftCode | KEBankSwiftCode, countryCode: ISO2CountryCode, formerNames?: string[]);
-    /**
-     * Checks if this bank has any former names recorded.
-     * @returns True if the bank has at least one former name, false otherwise.
-     */
-    hasFormerNames(): boolean;
-    /**
-     * Gets a display string showing the current name with former names in parentheses.
-     * @returns A formatted string, e.g., "Access Bank Tanzania Limited (formerly BancABC)"
-     */
-    getDisplayNameWithHistory(): string;
-    /**
-     * Returns a string representation of the bank.
-     * @returns A formatted string, e.g., "CRDB BANK PLC (CRDB) - SWIFT: CORUTZTZ [TZ]"
-     */
-    toString(): string;
-    static from(swiftCode: BankSwiftCode, countryCode: ISO2CountryCode): Bank;
-    /**
-     * Converts the Bank instance to a plain JavaScript object.
-     * Suitable for serialization or data transfer.
-     *
-     * @returns {Object} Plain object representation of the bank
-     * @returns {string} returns.fullName - The full registered name of the bank
-     * @returns {string} returns.shortName - The commonly used short name
-     * @returns {string} returns.swiftCode - The SWIFT/BIC code
-     * @returns {ISO2CountryCode} returns.countryCode - The ISO 3166-1 alpha-2 country code
-     * @returns {string[] | undefined} returns.formerNames - Optional list of former names
-     *
-     * @example
-     * ```typescript
-     * const bank = Bank.from("FMBZTZTX", "TZ");
-     * const obj = bank.toObject();
-     * console.log(obj);
-     * // {
-     * //   fullName: "Access Bank Tanzania Limited",
-     * //   shortName: "ABT",
-     * //   swiftCode: "FMBZTZTX",
-     * //   countryCode: "TZ",
-     * //   formerNames: ["BancABC"]
-     * // }
-     * ```
-     */
-    toObject(): {
-        fullName: string;
-        shortName: string;
-        swiftCode: TZBankSwiftCode | KEBankSwiftCode;
-        countryCode: ISO2CountryCode;
-        formerNames?: string[];
-    };
-    /**
-     * Static method to determine if an unknown object is a valid Bank object.
-     *
-     * This method performs a series of checks to validate if the provided object conforms
-     * to the Bank interface and contains valid data.
-     *
-     * @param {unknown} obj - The object to validate.
-     * @returns {obj is Bank} - Returns true if the object is a valid Bank, false otherwise.
-     */
-    static is(obj: unknown): obj is Bank;
-    /**
-     * Serializes the Bank instance to a JSON-compatible object
-     */
-    toJSON(): BankJSON;
-    /**
-     * Serializes the Bank instance to a JSON string
-     */
-    toJSONString(): string;
-    /**
-     * Creates a Bank instance from a JSON-compatible object or string
-     */
-    static fromJSON(json: BankJSON | string): Bank | undefined;
-    /**
-     * Creates a Bank instance from a JSON string
-     */
-    static fromJSONString(jsonString: string): Bank | undefined;
-    /**
-     * Type guard to check if an object is a valid BankJSON using Zod validation
-     */
-    static isBankJSON(obj: unknown): obj is BankJSON;
-}
-/**
- * Service for managing bank data, validation, and instance creation
- * across multiple countries. Acts as the central Facade and Factory.
- * @class BankService
- */
-export declare class BankService {
-    private static instance;
-    private loadedData;
-    private constructor();
-    /**
-     * Gets the singleton instance of BankService.
-     */
-    static getInstance(): BankService;
-    /**
-     * Loads bank data for a specific country synchronously.
-     * @param countryCode The ISO country code (e.g., 'TZ', 'KE').
-     * @returns The loaded country data, or undefined on failure.
-     */
-    private loadCountryData;
-    /**
-     * Retrieves the loaded data structure for a given country.
-     * Ensures country is initialized.
-     * @param countryCode The ISO country code.
-     * @returns The CountryBankData structure or undefined.
-     */
-    private getCountryData;
-    /**
-     * Retrieves a Bank instance by its SWIFT code for a specific country.
-     * Performs validation before returning.
-     * @param countryCode The ISO country code.
-     * @param swiftCode The SWIFT code.
-     * @returns The Bank instance or undefined if SWIFT is invalid or not found.
-     */
-    getBankBySwiftCode(countryCode: ISO2CountryCode, swiftCode: BankSwiftCode): Bank | undefined;
-    /**
-     * Retrieves all banks for a specific country.
-     * @param countryCode The ISO country code.
-     * @returns An array of Bank instances, or empty array.
-     */
-    getAllBanks(countryCode: ISO2CountryCode): Bank[];
-    /**
-     * Retrieves all banks for all supported countries.
-     * @returns An array of Bank instances, or empty array.
-     */
-    getAllSupportedBanks(): Bank[];
-    /**
-     * Searches all supported banks for a bank with the provided swift code
-     */
-    detectBank(swiftCode: string): Bank | undefined;
-    /**
-     * Searches for banks within a specific country by SWIFT code.
-     * @param countryCode The ISO country code.
-     * @param searchTerm The SWIFT code fragment to search for (case-insensitive).
-     * @param limit Max number of results.
-     * @returns An array of matching Bank instances.
-     */
-    searchBanks(countryCode: ISO2CountryCode, searchTerm: string, limit?: number): Bank[];
-    /**
-     * Searches for banks across all supported countries by SWIFT code.
-     * @param searchTerm The SWIFT code fragment to search for (case-insensitive).
-     * @param limit Max number of results.
-     * @returns An array of matching Bank instances from all supported countries.
-     */
-    searchAllBanks(searchTerm: string, limit?: number): Bank[];
-}

package/dist/models/bank/bank.schema.d.ts

@@ -1,23 +0,0 @@
-import { z } from "zod";
-export declare const TZBankSWIFTCodeSchema: z.ZodEffects<z.ZodString, string, string>;
-export declare const KEBankSWIFTCodeSchema: z.ZodEffects<z.ZodString, string, string>;
-/**
-* Zod schema for Bank JSON serialization
-* This schema validates the JSON representation of a Bank instance
-*/
-export declare const BankJSONSchema: z.ZodObject<{
-    /** The SWIFT/BIC code for the bank's head office */
-    swiftCode: z.ZodString;
-    /** The ISO 3166-1 alpha-2 country code */
-    countryCode: z.ZodString;
-    /** Version for future compatibility */
-    version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-}, "strip", z.ZodTypeAny, {
-    version: string;
-    swiftCode: string;
-    countryCode: string;
-}, {
-    swiftCode: string;
-    countryCode: string;
-    version?: string | undefined;
-}>;

package/dist/models/bank/bank.types.d.ts

@@ -1,5 +0,0 @@
-export declare const KEBankSwiftCodesSet: Set<string>;
-export declare const TZBankSwiftCodesSet: Set<string>;
-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";
-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";
-export type BankSwiftCode = KEBankSwiftCode | TZBankSwiftCode;

package/dist/models/bank/bank.validation.d.ts

@@ -1,80 +0,0 @@
-import { ISO2CountryCode } from "@models/country/country.types.js";
-import { BankSwiftCode } from "./bank.types.js";
-export declare const BankValidation: {
-    /**
-     * Validates a bank account number format for a specific country.
-     * @param accountNumber The account number string.
-     * @param countryCode The ISO2 country code.
-     * @returns True if the format is valid, false otherwise.
-     */
-    validateAccountNumber: (accountNumber: string, countryCode: ISO2CountryCode) => boolean;
-    /**
-     * Validates a bank account number format for any supported country.
-     * @param accountNumber The account number string.
-     * @returns True if the format is valid for any supported country, false otherwise.
-     */
-    validateAccountNumberForAnyCountry: (accountNumber: string) => boolean;
-    /**
-     * Validates a SWIFT/BIC code for a specific country.
-     * @param swiftCode The SWIFT code string.
-     * @param countryCode The ISO2 country code.
-     * @returns True if the format is valid, false otherwise.
-     */
-    validateSwiftCode: (swiftCode: string, countryCode: ISO2CountryCode) => swiftCode is BankSwiftCode;
-    /**
-     * Validates a SWIFT/BIC code for any supported country.
-     * @param swiftCode The SWIFT code string.
-     * @returns True if the SWIFT code is valid for any supported country, false otherwise.
-     */
-    validateSwiftCodeForAnyCountry: (swiftCode: string) => swiftCode is BankSwiftCode;
-    /**
-     * Validates an account name based on various criteria.
-     * This validation is country-agnostic as account name rules are generally similar.
-     *
-     * @param {string} accountName - The account name to validate
-     * @returns {boolean} True if the account name meets all validation criteria, false otherwise
-     *
-     * @example
-     * // Returns true
-     * validateAccountName("John Smith");
-     *
-     * @example
-     * // Returns false (too short)
-     * validateAccountName("Jo");
-     *
-     * @example
-     * // Returns false (invalid characters)
-     * validateAccountName("User123");
-     */
-    validateAccountName: (accountName: string) => boolean;
-    /**
-     * Validates an account name for any supported country.
-     * Since account name validation is generally country-agnostic, this is an alias to validateAccountName.
-     * @param accountName The account name to validate.
-     * @returns True if the account name is valid, false otherwise.
-     */
-    validateAccountNameForAnyCountry: (accountName: string) => boolean;
-    /**
-     * Validates all bank details (account number, SWIFT code, and account name) for a specific country.
-     * @param accountNumber The account number string.
-     * @param swiftCode The SWIFT code string.
-     * @param accountName The account name string.
-     * @param countryCode The ISO2 country code.
-     * @returns True if all details are valid for the specified country, false otherwise.
-     */
-    validateAllBankDetails: (accountNumber: string, swiftCode: string, accountName: string, countryCode: ISO2CountryCode) => boolean;
-    /**
-     * Validates all bank details (account number, SWIFT code, and account name) for any supported country.
-     * @param accountNumber The account number string.
-     * @param swiftCode The SWIFT code string.
-     * @param accountName The account name string.
-     * @returns True if all details are valid for any supported country, false otherwise.
-     */
-    validateAllBankDetailsForAnyCountry: (accountNumber: string, swiftCode: string, accountName: string) => boolean;
-    /**
-     * Determines which country a SWIFT code belongs to.
-     * @param swiftCode The SWIFT code string.
-     * @returns The ISO2 country code if found, undefined otherwise.
-     */
-    getCountryFromSwiftCode: (swiftCode: string) => ISO2CountryCode | undefined;
-};

package/dist/models/bank/index.d.ts

@@ -1,4 +0,0 @@
-export * from "./bank.js";
-export * from "./bank.types.js";
-export * from "./bank.validation.js";
-export * from "./bank.schema.js";

package/dist/models/country/country.d.ts

@@ -1,329 +0,0 @@
-/**
- * @fileoverview This file contains both the Country class and CountryService class.
- *
- * ARCHITECTURE NOTE: Country and CountryService Classes
- * ======================================================
- *
- * These two classes have been intentionally placed in the same file to resolve
- * a circular dependency issue. The original implementation had these in separate files:
- *
- * - Country class: Defines country properties and lookup helpers
- * - CountryService class: Loads country data and provides instance methods
- *
- * The circular dependency occurred because:
- * 1. Country needed CountryService for centralized lookups
- * 2. CountryService needed Country to create Country instances
- *
- * By combining both classes in a single file:
- * - We ensure proper initialization order
- * - The public API remains unchanged
- *
- * This approach also better encapsulates related functionality in a single module,
- * making it easier to understand and maintain the country-related domain model.
- * The addition of currency support through the getCurrency() method leverages
- * the Currency model while maintaining a clean separation of concerns.
- */
-import { Currency } from "@models/currency/currency.js";
-import { CurrencyCode } from "@models/currency/currency.types.js";
-import { ISO2CountryCode, ISO3CountryCode, CountryCode } from "./country.types.js";
-import { z } from "zod";
-import { CountryJSONSchema } from "./country.schema.js";
-/**
- * Infer the CountryJSON type from the schema
- */
-export type CountryJSON = z.infer<typeof CountryJSONSchema>;
-/**
- * Enum for continents
- */
-export declare enum CONTINENT {
-    AFRICA = "Africa",
-    ANTARCTICA = "Antarctica",
-    ASIA = "Asia",
-    EUROPE = "Europe",
-    NORTH_AMERICA = "North America",
-    OCEANIA = "Oceania",
-    SOUTH_AMERICA = "South America"
-}
-/**
- * Enum for sub-regions
- */
-export declare enum SUB_REGION {
-    AUSTRALIA_AND_NEW_ZEALAND = "Australia and New Zealand",
-    CARIBBEAN = "Caribbean",
-    CENTRAL_AMERICA = "Central America",
-    CENTRAL_ASIA = "Central Asia",
-    EASTERN_AFRICA = "Eastern Africa",
-    EASTERN_ASIA = "Eastern Asia",
-    EASTERN_EUROPE = "Eastern Europe",
-    MELANESIA = "Melanesia",
-    MICRONESIA = "Micronesia",
-    MIDDLE_AFRICA = "Middle Africa",
-    NORTHERN_AFRICA = "Northern Africa",
-    NORTHERN_AMERICA = "Northern America",
-    NORTHERN_EUROPE = "Northern Europe",
-    POLYNESIA = "Polynesia",
-    SOUTH_EASTERN_ASIA = "South-eastern Asia",
-    SOUTHERN_AFRICA = "Southern Africa",
-    SOUTHERN_ASIA = "Southern Asia",
-    SOUTHERN_EUROPE = "Southern Europe",
-    WESTERN_AFRICA = "Western Africa",
-    WESTERN_ASIA = "Western Asia",
-    WESTERN_EUROPE = "Western Europe"
-}
-/**
- * Represents a country with essential details.
- * @class Country
- */
-export declare class Country {
-    private readonly _name;
-    private readonly _iso2;
-    private readonly _nameOfficial;
-    private readonly _iso3;
-    private readonly _flagEmoji;
-    private readonly _continent;
-    private readonly _region;
-    private readonly _currencyCode;
-    private readonly _dialCode;
-    /**
-     * Creates a new Country instance.
-     * @param {string} _name - The common name of the country
-     * @param {string} _iso2 - The ISO-2 country code
-     * @param {string} _nameOfficial - The official name of the country
-     * @param {string} _iso3 - The ISO-3 country code
-     * @param {string} _flagEmoji - The flag emoji of the country
-     * @param {CONTINENT} _continent - The continent where the country is located
-     * @param {SUB_REGION} _region - The region within the continent where the country is located
-     * @param {string | null} _currencyCode - The ISO currency code used in the country
-     * @param {number} _dialCode - The dial code used in the country
-     */
-    constructor(token: symbol, _name: string, _iso2: ISO2CountryCode, _nameOfficial: string | undefined, _iso3: ISO3CountryCode, _flagEmoji: string | undefined, _continent: CONTINENT | undefined, _region: SUB_REGION | undefined, _currencyCode: (CurrencyCode | null) | undefined, _dialCode: number);
-    /**
-     * Gets the common name of the country.
-     * @returns {string} The common name of the country
-     */
-    get name(): string;
-    /**
-     * Gets the ISO-2 code of the country.
-     * @returns {ISO2CountryCode} The ISO-2 code of the country
-     */
-    get code(): ISO2CountryCode;
-    /**
-     * Gets the official name of the country.
-     * @returns {string} The official name of the country
-     */
-    get nameOfficial(): string;
-    /**
-     * Gets the ISO-3 code of the country.
-     * @returns {ISO3CountryCode} The ISO-3 code of the country
-     */
-    get iso3(): ISO3CountryCode;
-    /**
-     * Gets the flag emoji of the country.
-     * @returns {string} The flag emoji of the country
-     */
-    get flagEmoji(): string;
-    /**
-     * Gets the continent where the country is located.
-     * @returns {CONTINENT} The continent where the country is located
-     */
-    get continent(): CONTINENT;
-    /**
-     * Gets the region within the continent where the country is located.
-     * @returns {SUB_REGION} The region within the continent where the country is located
-     */
-    get region(): SUB_REGION;
-    /**
-     * Gets the ISO currency code used in the country.
-     * @returns {string | null} The ISO currency code of the country, or null if not available
-     */
-    get currencyCode(): CurrencyCode | null;
-    /**
-     * Gets the dial code used in the country.
-     * @returns {number} The dial code of the country
-     */
-    get dialCode(): number;
-    /**
-     * Gets the Currency instance for this country.
-     * @returns {Currency | undefined} The Currency instance or undefined if no currency is assigned
-     */
-    getCurrency(): Currency | undefined;
-    /**
-     * Creates a string representation of the country.
-     * @returns {string} String representation of the country
-     */
-    toString(): string;
-    /**
-     * Creates a detailed string representation of the country including the flag.
-     * @returns {string} Detailed string representation of the country
-     */
-    toDetailedString(): string;
-    /**
-     * Retrieves a country by its ISO-2 or ISO-3 code.
-     * @param {CountryCode} code The ISO-2 or ISO-3 code of the country.
-     * @returns {Country | undefined} The country corresponding to the ISO code or `undefined` if not found.
-     */
-    static fromCode(code: CountryCode): Country | undefined;
-    /**
-     * Retrieves a country by its ISO-3 code.
-     * @param {ISO3CountryCode} iso3 The ISO-3 code of the country.
-     * @returns {Country | undefined} The country corresponding to the ISO-3 code or `undefined` if not found.
-     */
-    static fromIso3(iso3: ISO3CountryCode): Country | undefined;
-    /**
-     * Returns all available countries.
-     * @returns {Country[]} Array of all countries
-     */
-    static getAll(): Country[];
-    /**
-     * Returns countries from a specific continent.
-     * @param {CONTINENT} continent The continent enum value
-     * @returns {Country[]} Array of countries in the specified continent
-     */
-    static getByContinent(continent: CONTINENT): Country[];
-    /**
-     * Returns countries from a specific region.
-     * @param {SUB_REGION} region The region enum value
-     * @returns {Country[]} Array of countries in the specified region
-     */
-    static getByRegion(region: SUB_REGION): Country[];
-    /**
-     * Returns a list of all available continents.
-     * @returns {CONTINENT[]} Array of continent enum values
-     */
-    static getContinents(): CONTINENT[];
-    /**
-     * Returns a list of all available regions.
-     * @returns {SUB_REGION[]} Array of region enum values
-     */
-    static getRegions(): SUB_REGION[];
-    /**
-     * Checks the validity of the country data
-     * @returns true if the country information is available and valid
-     */
-    validate(): boolean;
-    /**
-     * Attempts to create a Country instance from an ISO code.
-     * @param input The ISO-2 or ISO-3 code
-     * @returns A Country instance if valid input, undefined otherwise
-     */
-    static from(input: string): Country | undefined;
-    /**
-     * Validates if the input can be used to construct a valid Country instance
-     * @param input The ISO-2 or ISO-3 code to validate
-     * @returns True if input can construct a valid country, false otherwise
-     */
-    static canConstruct(input?: string | null): boolean;
-    /**
-     * Checks if an unknown value is a Country instance
-     * @param obj The value to validate
-     * @returns Type predicate indicating if the value is a valid Country
-     */
-    static is(obj: unknown): obj is Country;
-    /**
-     * Serializes the Country instance to a JSON-compatible object
-     */
-    toJSON(): CountryJSON;
-    /**
-     * Serializes the Country instance to a JSON string
-     */
-    toJSONString(): string;
-    /**
-     * Creates a Country instance from a JSON-compatible object or string
-     */
-    static fromJSON(json: CountryJSON | string): Country | undefined;
-    /**
-     * Creates a Country instance from a JSON string
-     */
-    static fromJSONString(jsonString: string): Country | undefined;
-    /**
-     * Type guard to check if an object is a valid CountryJSON using Zod validation
-     */
-    static isCountryJSON(obj: unknown): obj is CountryJSON;
-}
-/**
- * Service for managing country data.
- * @class CountryService
- */
-export declare class CountryService {
-    private static instance;
-    private countryList;
-    private codeRecord;
-    private iso3Record;
-    private continentRecord;
-    private regionRecord;
-    private constructor();
-    /**
-     * Gets the singleton instance of CountryService.
-     * Creates the instance if it doesn't exist.
-     * @static
-     * @returns {CountryService} The singleton instance
-     */
-    static getInstance(): CountryService;
-    /**
-     * Maps a string continent name to the CONTINENT enum
-     * @param continentName String continent name from JSON
-     * @returns The corresponding CONTINENT enum value
-     */
-    private mapContinent;
-    /**
-     * Maps a string region name to the SUB_REGION enum
-     * @param regionName String region name from JSON
-     * @returns The corresponding SUB_REGION enum value
-     */
-    private mapRegion;
-    /**
-     * Initializes the service with country data.
-     * Should be called once when your application starts.
-     */
-    private initialize;
-    /**
-     * Gets all countries.
-     * @returns {Country[]} Array of all countries
-     */
-    getAll(): Country[];
-    /**
-     * Gets all countries as a record.
-     * @returns {Record<string, Country>} Record of country codes and country objects
-     */
-    getAllAsRecord(): Record<string, Country>;
-    /**
-     * Gets all countries from a specific continent.
-     * @param {CONTINENT} continent The continent enum value
-     * @returns {Country[]} Array of countries in the specified continent
-     */
-    getByContinent(continent: CONTINENT): Country[];
-    /**
-     * Gets all countries from a specific region.
-     * @param {SUB_REGION} region The region enum value
-     * @returns {Country[]} Array of countries in the specified region
-     */
-    getByRegion(region: SUB_REGION): Country[];
-    /**
-     * Retrieves a country by its ISO-2 or ISO-3 code.
-     * @param {CountryCode} code The ISO code of the country.
-     * @returns {Country | undefined} The country corresponding to the ISO code or `undefined` if not found.
-     */
-    fromCode(code: CountryCode): Country | undefined;
-    /**
-     * Retrieves a country by its ISO-3 code.
-     * @param {ISO3CountryCode} iso3 The ISO-3 code of the country.
-     * @returns {Country | undefined} The country corresponding to the ISO-3 code or `undefined` if not found.
-     */
-    fromIso3(iso3: ISO3CountryCode): Country | undefined;
-    /**
-     * Searches for countries that match the given search term.
-     * @param {string} searchTerm - The partial ISO-2 or ISO-3 code to search for.
-     * @param {number} [limit=10] - Maximum number of results to return.
-     * @returns {Country[]} Array of matching countries, limited to specified count.
-     */
-    search(searchTerm: string, limit?: number): Country[];
-    /**
-     * Compares two Country instances for equality by checking their name and code
-     *
-     * @param {Country} country1 - First country to compare
-     * @param {Country} country2 - Second country to compare
-     * @returns {boolean} True if countries are equal, false otherwise
-     * @private
-     */
-    compare(country1: Country, country2: Country): boolean;
-}