@temboplus/frontend-core 0.2.9 → 0.2.11

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

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

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

@@ -0,0 +1,106 @@
+import { ISO2CountryCode } from "../country/country.types";
+import type { BankSwiftCode, KEBankSwiftCode, TZBankSwiftCode } from "./bank.types";
+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;
+    /**
+     * 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
+     */
+    constructor(fullName: string, shortName: string, swiftCode: TZBankSwiftCode | KEBankSwiftCode, countryCode: ISO2CountryCode);
+    /**
+     * 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;
+    /**
+     * 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;
+}
+/**
+ * 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.
+     * Initializes known countries synchronously on first call.
+     * Consider async initialization if data loading becomes async.
+     */
+    static getInstance(): BankService;
+    /**
+     * Initializes bank data for a specific country synchronously.
+     * @param countryCode The ISO country code (e.g., 'TZ', 'KE').
+     * @returns True if successful or already loaded, false on failure.
+     */
+    initializeCountry(countryCode: ISO2CountryCode): boolean;
+    /**
+     * 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.
+     * @param countryCode The ISO country code.
+     * @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 name or SWIFT code.
+     * @param countryCode The ISO country code.
+     * @param searchTerm The term 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[];
+}

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

@@ -0,0 +1,3 @@
+import { z } from "zod";
+export declare const TZBankSWIFTCodeSchema: z.ZodEffects<z.ZodString, string, string>;
+export declare const KEBankSWIFTCodeSchema: z.ZodEffects<z.ZodString, string, string>;

package/{esm/src/models/bank/types.d.ts → dist/models/bank/bank.types.d.ts}

@@ -1,7 +1,5 @@
+export declare const KEBankSwiftCodesSet: Set<string>;
+export declare const TZBankSwiftCodesSet: Set<string>;
+export type KEBankSwiftCode = "KCBLKENX" | "EQBLKENX" | "KCOOKENX" | "SCBLKENX" | "BARCKENX" | "CBAFKENX" | "DTKEKENX" | "FABLKENA" | "CITIKENA" | "HFCOKENX" | "SBICKENX" | "NBKEKENX" | "AFRIKENX" | "GTBOKENX" | "IMBLKENX" | "ECOCKENX" | "BARBKENX" | "BKIDKENX" | "UNAFKENX" | "SGKENX";
 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";
-/**
- * A Set containing all SWIFT codes from the provided list.
- * Useful for quick lookups (e.g., checking if a string is a valid SWIFT code from this list).
- */
-export declare const TZBankSwiftCodesSet: Set<TZBankSwiftCode>;
-//# sourceMappingURL=types.d.ts.map
+export type BankSwiftCode = KEBankSwiftCode | TZBankSwiftCode;

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

@@ -0,0 +1,80 @@
+import { ISO2CountryCode } from "../country";
+import { BankSwiftCode } from "./bank.types";
+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

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

package/{script/src → dist}/models/country/country.d.ts

@@ -24,9 +24,9 @@
  * The addition of currency support through the getCurrency() method leverages
  * the Currency model while maintaining a clean separation of concerns.
  */
-import { Currency } from "../currency/currency.js";
-import type { CurrencyCode } from "../currency/index.js";
-import type { CountryCode, ISO2CountryCode, ISO3CountryCode } from "./types.js";
+import { Currency } from "../../models/currency";
+import type { CurrencyCode } from "../../models/currency";
+import type { CountryCode, ISO2CountryCode, ISO3CountryCode } from "./country.types";
 /**
  * Enum for continents
  */
@@ -78,6 +78,7 @@ export declare class Country {
     private readonly _continent;
     private readonly _region;
     private readonly _currencyCode;
+    private readonly _dialCode;
     static readonly AF: Country;
     static readonly AX: Country;
     static readonly AL: Country;
@@ -578,8 +579,9 @@ export declare class 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(_name: string, _iso2: ISO2CountryCode, _nameOfficial: string, _iso3: ISO3CountryCode, _flagEmoji?: string, _continent?: CONTINENT, _region?: SUB_REGION, _currencyCode?: CurrencyCode | null);
+    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
@@ -620,6 +622,11 @@ export declare class 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
@@ -819,4 +826,3 @@ export declare class CountryService {
      */
     compare(country1: Country, country2: Country): boolean;
 }
-//# sourceMappingURL=country.d.ts.map

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

@@ -0,0 +1,46 @@
+import { z } from "zod";
+/**
+ * Zod schema for validating ISO 3166-1 alpha-2 country codes.
+ *
+ * This schema checks if a given string is a valid ISO 3166-1 alpha-2 country code
+ * by checking against the predefined set of valid codes.
+ *
+ * @example
+ * const result = iso2CountryCodeSchema.safeParse("US");
+ * if (result.success) {
+ *   console.log("Valid ISO2 country code");
+ * } else {
+ *   console.error("Invalid ISO2 country code");
+ * }
+ */
+export declare const ISO2CountryCodeSchema: z.ZodEffects<z.ZodString, string, string>;
+/**
+ * Zod schema for validating ISO 3166-1 alpha-3 country codes.
+ *
+ * This schema checks if a given string is a valid ISO 3166-1 alpha-3 country code
+ * by checking against the predefined set of valid codes.
+ *
+ * @example
+ * const result = iso3CountryCodeSchema.safeParse("USA");
+ * if (result.success) {
+ *  console.log("Valid ISO3 country code");
+ * } else {
+ *  console.error("Invalid ISO3 country code");
+ * }
+ */
+export declare const ISO3CountryCodeSchema: z.ZodEffects<z.ZodString, string, string>;
+/**
+ * Zod schema for validating either ISO 3166-1 alpha-2 or alpha-3 country codes.
+ *
+ * This schema allows for flexibility in accepting both two-letter and three-letter
+ * country codes, making it useful for functions that need to handle both formats.
+ *
+ * @example
+ * const result = countryCodeSchema.safeParse("US");
+ * if (result.success) {
+ *   console.log("Valid country code");
+ * } else {
+ *   console.error("Invalid country code");
+ * }
+ */
+export declare const CountryCodeSchema: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodString, string, string>]>;

package/{script/src/models/country/types.d.ts → dist/models/country/country.types.d.ts}

@@ -60,4 +60,3 @@ export declare const ISO3CountryCodesSet: Set<string>;
  * @see ISO3CountryCode - For three-letter country codes only
  */
 export type CountryCode = ISO2CountryCode | ISO3CountryCode;
-//# sourceMappingURL=types.d.ts.map

package/{esm/src/models/country/utils.js → dist/models/country/country.validation.d.ts}

@@ -1,25 +1,26 @@
-import { ISO2CountryCodesSet } from "./index.js";
+import { type ISO2CountryCode, type ISO3CountryCode } from "./country.types";
+import type { CountryCode } from "..";
+export declare const CountryValidation: {
+    isISO2CountryCode: typeof isISO2CountryCode;
+    isISO3CountryCode: typeof isISO3CountryCode;
+    isCountryCode: typeof isCountryCode;
+};
 /**
  * Type guard to check if a string is a valid ISO2CountryCode.
  * @param code The string to check.
  * @returns True if the string is a member of the ISO2CountryCode union type, false otherwise.
  */
-export function isISO2CountryCode(code) {
-    return ISO2CountryCodesSet.has(code);
-}
+declare function isISO2CountryCode(code: string): code is ISO2CountryCode;
 /**
  * Type guard to check if a string is a valid isISO3CountryCode.
  * @param code The string to check.
  * @returns True if the string is a member of the isISO3CountryCode union type, false otherwise.
  */
-export function isISO3CountryCode(code) {
-    return ISO2CountryCodesSet.has(code);
-}
+declare function isISO3CountryCode(code: string): code is ISO3CountryCode;
 /**
  * Type guard to check if a string is a valid CountryCode.
  * @param code The string to check
  * @returns True if the string is a valid ISO-2 or ISO-3 country code
  */
-export function isCountryCode(code) {
-    return isISO2CountryCode(code) || isISO3CountryCode(code);
-}
+declare function isCountryCode(code: string): code is CountryCode;
+export {};

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

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

package/{script/src → dist}/models/currency/currency.d.ts

@@ -26,7 +26,7 @@
  * This approach follows the principle that closely related classes with circular
  * dependencies are best managed in a unified module.
  */
-import type { CurrencyCode } from "./types.js";
+import type { CurrencyCode } from "./currency.types";
 /**
  * Represents a currency with essential details.
  * @class Currency
@@ -284,7 +284,7 @@ export declare class Currency {
      * @param {CurrencyCode} _code - The ISO 4217 currency code
      * @param {string} _namePlural - The plural form of the currency name
      */
-    constructor(_symbol: string, _name: string, _symbolNative: string, _decimalDigits: number, _rounding: number, _code: CurrencyCode, _namePlural: string);
+    constructor(token: symbol, _symbol: string, _name: string, _symbolNative: string, _decimalDigits: number, _rounding: number, _code: CurrencyCode, _namePlural: string);
     /**
      * Gets the international symbol of the currency.
      * @returns {string} The international symbol of the currency
@@ -462,4 +462,3 @@ export declare class CurrencyService {
      */
     private escapeRegExp;
 }
-//# sourceMappingURL=currency.d.ts.map

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

@@ -0,0 +1,8 @@
+import { z } from "zod";
+/**
+ * Zod schema for validating ISO 4217 currency codes
+ *
+ * This schema checks if the provided string is a valid ISO 4217 currency code.
+ * If the validation fails, it returns an error message.
+ */
+export declare const CurrencyCodeSchema: z.ZodEffects<z.ZodString, string, string>;

package/{esm/src/models/currency/types.d.ts → dist/models/currency/currency.types.d.ts}

@@ -17,5 +17,4 @@
  * Example: "USD" for US Dollar, "EUR" for Euro, "JPY" for Japanese Yen
  */
 export type CurrencyCode = "USD" | "CAD" | "EUR" | "AED" | "AFN" | "ALL" | "AMD" | "ARS" | "AUD" | "AZN" | "BAM" | "BDT" | "BGN" | "BHD" | "BIF" | "BND" | "BOB" | "BRL" | "BWP" | "BYN" | "BZD" | "CDF" | "CHF" | "CLP" | "CNY" | "COP" | "CRC" | "CVE" | "CZK" | "DJF" | "DKK" | "DOP" | "DZD" | "EGP" | "ERN" | "ETB" | "GBP" | "GEL" | "GHS" | "GNF" | "GTQ" | "HKD" | "HNL" | "HRK" | "HUF" | "IDR" | "ILS" | "INR" | "IQD" | "IRR" | "ISK" | "JMD" | "JOD" | "JPY" | "KES" | "KHR" | "KMF" | "KRW" | "KWD" | "KZT" | "LBP" | "LKR" | "LYD" | "MAD" | "MDL" | "MGA" | "MKD" | "MMK" | "MOP" | "MUR" | "MXN" | "MYR" | "MZN" | "NAD" | "NGN" | "NIO" | "NOK" | "NPR" | "NZD" | "OMR" | "PAB" | "PEN" | "PHP" | "PKR" | "PLN" | "PYG" | "QAR" | "RON" | "RSD" | "RUB" | "RWF" | "SAR" | "SDG" | "SEK" | "SGD" | "SOS" | "SSP" | "SYP" | "THB" | "TND" | "TOP" | "TRY" | "TTD" | "TWD" | "TZS" | "UAH" | "UGX" | "UYU" | "UZS" | "VES" | "VND" | "XAF" | "XOF" | "YER" | "ZAR" | "ZMW" | "STN" | "MRU" | "ZWG";
-export declare const ValidCurrencyCodesSet: Set<CurrencyCode>;
-//# sourceMappingURL=types.d.ts.map
+export declare const CurrencyCodesSet: Set<CurrencyCode>;

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

@@ -0,0 +1,11 @@
+import { type CurrencyCode } from "./currency.types";
+export declare const CurrencyValidation: {
+    isCurrencyCode: typeof isCurrencyCode;
+};
+/**
+ * Type guard to check if a string is a valid CurrencyCode.
+ * @param code The string to check.
+ * @returns True if the string is a member of the CurrencyCode union type, false otherwise.
+ */
+declare function isCurrencyCode(code: string): code is CurrencyCode;
+export {};

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

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

package/dist/models/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./amount/index";
+export * from "./bank/index";
+export * from "./phone-number/index";
+export * from "./country/index";
+export * from "./currency/index";

package/dist/models/phone-number/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./phone-number.factory";
+export * from "./phone-number.types";
+export * from "./mno/mno.utils";
+export * from "./mno/mno.types";
+export * from "./phone-number";
+export * from "./mno";

package/dist/models/phone-number/mno/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./ke/mobile-number.ke";
+export * from "./ke/mobile-number.ke-mnos";
+export * from "./tz/mobile-number.tz";
+export * from "./tz/mobile-number.tz-mnos";
+export * from "./mno.types";
+export * from "./mno.utils";

package/dist/models/phone-number/mno/ke/mobile-number.ke-mnos.d.ts

@@ -0,0 +1,22 @@
+import { ISO2CountryCode } from "../../../country/country.types";
+import { CountryMNOImplementation, KEMNOId, MNOInfo } from "../mno.types";
+/**
+ * Configuration object for Kenyan mobile network operators.
+ * Conforms to the generic MNOInfo interface.
+ */
+export declare const KE_MNO_CONFIG: Record<KEMNOId, MNOInfo>;
+/**
+ * Gets all available Kenyan MNO configurations.
+ * @returns Array of all KE MNO configurations.
+ */
+export declare function getAllKEMNOs(): MNOInfo[];
+export declare class KEMNOImplementation implements CountryMNOImplementation {
+    private static instance;
+    private constructor();
+    static getInstance(): KEMNOImplementation;
+    getAllMNOs(): MNOInfo[];
+    isValidMNOId(id: string): boolean;
+    getMNOById(id: string): MNOInfo | undefined;
+    requiresExplicitMNO(): boolean;
+    getCountryCode(): ISO2CountryCode;
+}

package/dist/models/phone-number/mno/ke/mobile-number.ke.d.ts

@@ -0,0 +1,45 @@
+import { ISO2CountryCode } from "../../../country";
+import { MNOInfo } from "../mno.types";
+import { PhoneNumber } from "../../phone-number";
+import { type ParsedPhoneNumber, PhoneNumberService } from "../../phone-number.service";
+import { type PhoneNumberContract, type PhoneNumberParseOptions, PhoneNumberType } from "../../phone-number.types";
+/**
+ * Represents a validated Kenyan (KE) **mobile** phone number.
+ * Extends the generic PhoneNumber class and implements the common PhoneNumberContract interface.
+ * Note: Does not provide MNO details as per requirement.
+ */
+export declare class KEMobileNumber extends PhoneNumber implements PhoneNumberContract {
+    readonly countryCode: ISO2CountryCode;
+    /**
+     * Protected constructor. Use static `from` method for instantiation.
+     * Calls the base class constructor.
+     */
+    protected constructor(parsedInfo: ParsedPhoneNumber, service: PhoneNumberService);
+    /**
+     * Validates the structure for a Kenyan **mobile** phone number.
+     * Checks base validity AND ensures the national number starts with a valid KE mobile prefix.
+     * @returns {boolean} True if the number is a valid KE mobile number structure.
+     */
+    validate(): boolean;
+    /**
+     * Gets associated mobile operator information. Returns undefined for KE.
+     * Overrides the base implementation.
+     * @returns {MNOInfo | undefined} Always returns undefined.
+     */
+    getOperatorInfo(): MNOInfo | undefined;
+    /**
+     * Gets the specific type for this class, overriding the base method.
+     * @returns {PhoneNumberType} Always returns MOBILE.
+     */
+    getNumberType(): PhoneNumberType;
+    /**
+     * Attempts to create a `KEMobileNumber` instance from a given string input.
+     * Performs KE-specific parsing and validation FIRST, then uses the core
+     * service for final validation and object creation.
+     *
+     * @param input - The input phone number string.
+     * @param options - Parsing options (optional).
+     * @returns {KEMobileNumber | undefined} An instance if valid, otherwise undefined.
+     */
+    static from(input: string | null | undefined, options?: PhoneNumberParseOptions): KEMobileNumber | undefined;
+}

package/dist/models/phone-number/mno/mno.types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Tanzanian mobile network operator identifiers.
+ * Values are used in payout channel-code field and should not change.
+ */
+import { ISO2CountryCode } from "../../country/country.types";
+export declare enum TZMNOId {
+    VODACOM = "VODACOM",
+    AIRTEL = "AIRTEL",
+    TIGO = "TIGO",
+    HALOTEL = "HALOTEL"
+}
+/**
+ * Kenyan mobile network operator identifiers.
+ * Values are used in payout channel-code field and should not change.
+ */
+export declare enum KEMNOId {
+    SAFARICOM = "SAFARICOM",
+    AIRTEL = "AIRTEL"
+}
+/**
+ * Union type for all MNO IDs
+ */
+export type MNOId = TZMNOId | KEMNOId;
+/**
+ * Generic interface for Mobile Network Operator information.
+ * Now properly typed with specific MNO IDs.
+ */
+export interface MNOInfo {
+    id: MNOId;
+    displayName: string;
+    mobileMoneyService: string;
+}
+/**
+ * Extended interface for country-specific MNO implementations
+ */
+export interface CountryMNOImplementation {
+    /**
+     * Get all MNOs for this country
+     */
+    getAllMNOs(): MNOInfo[];
+    /**
+     * Validate if an MNO ID is valid for this country
+     */
+    isValidMNOId(id: string): boolean;
+    /**
+     * Get MNO info by ID
+     */
+    getMNOById(id: string): MNOInfo | undefined;
+    /**
+     * Check if this country requires explicit MNO (has MNP)
+     */
+    requiresExplicitMNO(): boolean;
+    /**
+     * Get the country code
+     */
+    getCountryCode(): ISO2CountryCode;
+    /**
+     * Validate MNO for a phone number (if applicable)
+     *
+     * Returns undefined for countries with MNP
+     */
+    validateMNOForPhoneNumber?(phoneNumber: string, mnoId: string): boolean;
+}

package/dist/models/phone-number/mno/mno.utils.d.ts

@@ -0,0 +1,40 @@
+import { CountryCode, ISO2CountryCode } from "../../country";
+import { CountryMNOImplementation, MNOInfo } from "./mno.types";
+/**
+ * Utility functions for working with MNO data across countries.
+ */
+export declare class MNOUtils {
+    private static implementations;
+    /**
+     * Get MNO implementation for a specific country
+     */
+    private static getImplementation;
+    /**
+     * Get all MNOs for a specific country
+     */
+    static getCountryMNOs(countryCode: CountryCode): MNOInfo[];
+    /**
+     * Validate if an MNO ID is valid for a specific country
+     */
+    static isValidMNOForCountry(mnoId: string, countryCode: CountryCode): boolean;
+    /**
+     * Get MNO info by ID for a specific country
+     */
+    static getMNOById(mnoId: string, countryCode: CountryCode): MNOInfo | undefined;
+    /**
+     * Check if a country requires explicit MNO (has MNP)
+     */
+    static requiresExplicitMNO(countryCode: CountryCode): boolean;
+    /**
+     * Validate MNO for a phone number (country-specific logic)
+     */
+    static validateMNOForPhoneNumber(phoneNumber: string, mnoId: string, countryCode: CountryCode): boolean;
+    /**
+     * Get MNO by phone number (for countries without MNP)
+     */
+    static getMNOByPhoneNumber(phoneNumber: string, countryCode: CountryCode): MNOInfo | undefined;
+    /**
+     * Register a new country implementation
+     */
+    static registerCountryImplementation(countryCode: ISO2CountryCode, implementation: CountryMNOImplementation): void;
+}