iradoweck/moz-utils

Utility functions for Mozambique — validation of NUIT, BI, documents, and phone number formatting. Moz-Utils Moz Utils Patch Dev 🇲🇿 The Definitive Swiss Army Knife for Software Developers in Mozambique. moz-utils is a collection of essential utility functions tailored for the Mozambican software development ecosystem. It standardizes critical validations such as NUIT (Unique Tax Identification Number), BI (National ID), DIRE (Foreign Resident ID), Passports , Driving Licenses , mobile phone numbers (Vodacom, Tmcel, Movitel / M-Pesa, e-Mola, mKesh), Metical currency formatting (MZN), and national geographical data (including the New Postal Code System - CEP). The project is actively maintained and ported to the most popular programming languages used across Africa. ### ℹ️ Mozambique Specifications | Parameter | Details | | :--- | :--- | | **Country** | Mozambique | | **Calling Code (DDI)** | `+258` | | **Official Language** | Portuguese (pt-MZ) | | **Official Currency** | Metical (`MZN` / `MT`) | --- ## 🔄 Enterprise Release Cycle The **moz-utils** ecosystem follows a rigorous **Stable/LTS/EOL** policy to ensure enterprise-grade reliability, alongside the Base 10 versioning dogma. | Version | Status | Release Date | End of Life (EOL) | | :--- | :--- | :--- | :--- | | **0.3.x** | 🟢 **Stable** | May 27, 2026 | Until 0.4.0 is released | | **0.2.x** | 🔴 **EOL** | May 26, 2026 | Immediate (Replaced rapidly) | | **0.1.x** | 🔴 **EOL** | May 20, 2026 | Immediate (Replaced rapidly) | > **Note:** Future LTS (Long Term Support) versions will be supported for a minimum of **3 to 6 months**. The ecosystem retains a maximum of 2 active LTS lines simultaneously. An automatic deprecation warning will trigger when an LTS reaches its final 5% lifespan. --- ## 🗺️ Workflows and Architecture All heavy technical logic (NUIT mathematics, document Regex validation, and Mozambique maps) has been isolated. To read detailed technical documentation on how algorithms work and the structure of Mozambican geographical databases, check out our off …