@williamtessa27/cm-phone-lookup

v1.12.0

Published

4 months ago

Librairie JavaScript professionnelle pour la détection d'opérateurs mobiles multi-pays avec API unifiée, validation avancée et métadonnées enrichies. Supporte 21 pays africains : Cameroun 🇨🇲, Sénégal 🇸🇳, Côte d'Ivoire 🇨🇮, Nigeria 🇳🇬, Ghana 🇬🇭, K

📱 @williamtessa27/cm-phone-lookup

Une librairie JavaScript professionnelle pour la détection d'opérateurs mobiles multi-pays avec API unifiée, validation avancée et métadonnées enrichies. Supporte 21 pays africains : Cameroun 🇨🇲, Sénégal 🇸🇳, Côte d'Ivoire 🇨🇮, Nigeria 🇳🇬, Ghana 🇬🇭, Kenya 🇰🇪, Afrique du Sud 🇿🇦, Maroc 🇲🇦, Éthiopie 🇪🇹, Égypte 🇪🇬, Tanzanie 🇹🇿, RDC 🇨🇩, Ouganda 🇺🇬, Rwanda 🇷🇼, Algérie 🇩🇿, Mali 🇲🇱, Soudan 🇸🇩, Mozambique 🇲🇿, Angola 🇦🇴, Burkina Faso 🇧🇫, Soudan du Sud 🇸🇸 avec plus de 80+ opérateurs (MTN, Orange, Vodacom, Safaricom, Airtel, Ethio Telecom, Vodafone Egypt, Halotel, Mobilis, Djezzy, Ooredoo, Zain Sudan, Movitel, Tmcel, Unitel, Movicel, Africell Angola, Telecel Faso, Zain South Sudan, etc.) à partir d'un numéro de téléphone.
Compatible JavaScript et TypeScript.

🚀 Installation

npm install @williamtessa27/cm-phone-lookup
# ou
yarn add @williamtessa27/cm-phone-lookup
# ou
pnpm add @williamtessa27/cm-phone-lookup

📖 Utilisation

🎯 NOUVEAU : API Unifiée avec PhoneLookup.analyze()

import { PhoneLookup } from '@williamtessa27/cm-phone-lookup';

// Analyse complète en une seule fonction !
const result = PhoneLookup.analyze('+233241234567');
console.log(`${result.country?.flag} ${result.country?.name}: ${result.operator}`);
// 🇬🇭 Ghana: GHANA_MTN

// Métadonnées complètes incluses
console.log(`Capitale: ${result.country?.capital}`);
console.log(`Population: ${result.country?.population}`);
console.log(`Devise: ${result.country?.currency}`);
console.log(`Fuseau: ${result.country?.timezone}`);

🔗 NOUVEAU : Méthodes Chainées (Fluent API)

import { PhoneLookup } from '@williamtessa27/cm-phone-lookup';

const result = new PhoneLookup('+237650123456')
  .validate()
  .format()
  .getInfo();

console.log(`${result.country?.flag} ${result.country?.name}`);
// 🇨🇲 Cameroon

⚙️ NOUVEAU : Configuration Flexible

import { PhoneLookup } from '@williamtessa27/cm-phone-lookup';

const lookup = new PhoneLookup('+233241234567', {
  strictMode: true,        // Validation stricte
  autoFormat: false,       // Désactiver le formatage automatique
  language: 'en',          // Langue anglaise
  includeMetadata: true,   // Inclure les métadonnées
  throwOnError: false      // Ne pas lancer d'exceptions
});

🚨 NOUVEAU : Gestion d'Erreurs Avancée

import { PhoneLookup, validatePhoneNumber } from '@williamtessa27/cm-phone-lookup';

try {
  const result = PhoneLookup.analyze('123', { throwOnError: true });
} catch (error) {
  if (error.code === 'INVALID_COUNTRY_CODE') {
    console.log('Codes supportés:', error.suggestions);
  }
}

// Validation avec messages d'erreur détaillés
const validation = validatePhoneNumber('123');
if (!validation.isValid) {
  validation.errors.forEach(error => {
    console.log(`${error.code}: ${error.message}`);
    if (error.suggestion) {
      console.log(`💡 Suggestion: ${error.suggestion}`);
    }
  });
}

📊 NOUVEAU : Statistiques Globales

import { PhoneLookup } from '@williamtessa27/cm-phone-lookup';

const stats = PhoneLookup.getStats();
console.log(`🌍 Total pays: ${stats.totalCountries}`);
console.log(`📱 Total opérateurs: ${stats.totalOperators}`);

stats.countries.forEach(country => {
  console.log(`${country.flag} ${country.name}: ${country.operators} opérateurs`);
});

🌍 NOUVEAU : Métadonnées des Pays

import { getCountryMetadata, getAllCountries } from '@williamtessa27/cm-phone-lookup';

// Obtenir les métadonnées d'un pays
const ghana = getCountryMetadata('233');
console.log(`${ghana?.flag} ${ghana?.name} (${ghana?.nameLocal})`);
console.log(`Capitale: ${ghana?.capital}`);
console.log(`Population: ${ghana?.population}`);
console.log(`Devise: ${ghana?.currency}`);

// 🇨🇲 Cameroun : Exemple de bilinguisme officiel
const cameroon = getCountryMetadata('237');
console.log(`${cameroon?.flag} ${cameroon?.name} (${cameroon?.nameLocal})`);
console.log(`Langues: ${Array.isArray(cameroon?.language) ? cameroon?.language.join(' + ') : cameroon?.language}`);
// Affiche: "Langues: fr + en" (Français + Anglais)

// Autres pays : Langue unique
const senegal = getCountryMetadata('221');
console.log(`Langue: ${senegal?.language}`); // "fr" (Français uniquement)

// Liste de tous les pays supportés
const countries = getAllCountries();
console.log('Pays supportés:', countries);

📱 API Classique (Toujours Disponible)

import { detectOperator, isValidNumber, getPhoneInfo, formatPhoneNumber } from '@williamtessa27/cm-phone-lookup';

// Cameroun
const operatorCM = detectOperator('+237650123456');
console.log(operatorCM); // "CAMEROON_MTN"

// Sénégal
const operatorSN = detectOperator('+221771234567');
console.log(operatorSN); // "SENEGAL_ORANGE"

// Éthiopie
const operatorET = detectOperator('+25191123456');
console.log(operatorET); // "ETHIOPIA_ETHIO_TELECOM"

// Égypte
const operatorEG = detectOperator('+201012345678');
console.log(operatorEG); // "EGYPT_VODAFONE"

// Tanzanie
const operatorTZ = detectOperator('+255741234567');
console.log(operatorTZ); // "TANZANIA_VODACOM"

// RDC (République Démocratique du Congo)
const operatorCD = detectOperator('+243811234567');
console.log(operatorCD); // "DRC_VODACOM"

// Angola
const operatorAO = detectOperator('+244911234567');
console.log(operatorAO); // "ANGOLA_UNITEL"

// Burkina Faso
const operatorBF = detectOperator('+22670123456');
console.log(operatorBF); // "BURKINA_FASO_ORANGE"

// Soudan du Sud
const operatorSS = detectOperator('+211921234567');
console.log(operatorSS); // "SOUTH_SUDAN_MTN"

// Ouganda
const operatorUG = detectOperator('+256771234567');
console.log(operatorUG); // "UGANDA_MTN"

// Rwanda
const operatorRW = detectOperator('+250781234567');
console.log(operatorRW); // "RWANDA_MTN"

// Algérie
const operatorDZ = detectOperator('+213512345678');
console.log(operatorDZ); // "ALGERIA_MOBILIS"

// Mali
const operatorML = detectOperator('+22370123456');
console.log(operatorML); // "MALI_ORANGE"

// Soudan
const operatorSD = detectOperator('+24991123456');
console.log(operatorSD); // "SUDAN_ZAIN"

// Mozambique
const operatorMZ = detectOperator('+25882123456');
console.log(operatorMZ); // "MOZAMBIQUE_VODACOM"

// Côte d'Ivoire
const operatorCI = detectOperator('+22501234567');
console.log(operatorCI); // "IVORY_COAST_ORANGE"

// Nigeria
const operatorNG = detectOperator('+2340803123456');
console.log(operatorNG); // "NIGERIA_MTN"

// Ghana
const operatorGH = detectOperator('+233241234567');
console.log(operatorGH); // "GHANA_MTN"

// Kenya
const operatorKE = detectOperator('+254700123456');
console.log(operatorKE); // "KENYA_SAFARICOM"

// Afrique du Sud
const operatorZA = detectOperator('+27721234567');
console.log(operatorZA); // "SOUTH_AFRICA_VODACOM"

// Maroc
const operatorMA = detectOperator('+212612345678');
console.log(operatorMA); // "MOROCCO_MAROC_TELECOM"

Validation de numéro

import { isValidNumber } from '@williamtessa27/cm-phone-lookup';

const isValid = isValidNumber('+237650123456');
console.log(isValid); // true

Information complète

import { getPhoneInfo } from '@williamtessa27/cm-phone-lookup';

const info = getPhoneInfo('+237650123456');
console.log(info);
// {
//   operator: "CAMEROON_MTN",
//   isValid: true,
//   countryCode: "+237",
//   localNumber: "650123456",
//   formattedNumber: "+237 650 123 456",
//   isMobile: true,
//   isFixed: false,
//   length: 9
// }

Formatage de numéro

import { formatPhoneNumber } from '@williamtessa27/cm-phone-lookup';

const formatted = formatPhoneNumber('+237650123456');
console.log(formatted); // "+237 650 123 456"

Obtenir les préfixes d'un opérateur

import { getOperatorPrefixes } from '@williamtessa27/cm-phone-lookup';

const mtnPrefixes = getOperatorPrefixes('CAMEROON_MTN');
console.log(mtnPrefixes); // ["650", "651", "652", "653", "654", "680", "681", "682", "683", "684"]

Vérifier si un préfixe appartient à un opérateur

import { isPrefixForOperator } from '@williamtessa27/cm-phone-lookup';

const isMtn = isPrefixForOperator('650', 'CAMEROON_MTN');
console.log(isMtn); // true

🏗️ Opérateurs supportés

| Opérateur | Préfixes | Type | Pays | |-----------|----------|------|------| | CAMEROON_MTN | 67, 670-679, 68, 680-689, 650-654 | Mobile | 🇨🇲 Cameroun | | CAMEROON_ORANGE | 655, 656, 657, 658, 659 | Mobile | 🇨🇲 Cameroun | | CAMEROON_CAMTEL | 222, 233, 242-246, 620, 621, 6200-6209, 6210-6219 | Fixe/Mobile | 🇨🇲 Cameroun | | CAMEROON_NEXTTEL | 66, 660-669 | Mobile | 🇨🇲 Cameroun | | SENEGAL_ORANGE | 77, 78 | Mobile | 🇸🇳 Sénégal | | SENEGAL_TIGO | 76 | Mobile | 🇸🇳 Sénégal | | SENEGAL_EXPRESSO | 70 | Mobile | 🇸🇳 Sénégal | | SENEGAL_HAYO | 72 | Mobile | 🇸🇳 Sénégal | | SENEGAL_SIRIUS | 754, 755, 756 | Mobile | 🇸🇳 Sénégal | | SENEGAL_ORIGINES | 757 | Mobile | 🇸🇳 Sénégal | | IVORY_COAST_ORANGE | 07, 27 | Mobile/Fixe | 🇨🇮 Côte d'Ivoire | | IVORY_COAST_MTN | 05, 25 | Mobile/Fixe | 🇨🇮 Côte d'Ivoire | | IVORY_COAST_MOOV | 01, 21 | Mobile/Fixe | 🇨🇮 Côte d'Ivoire | | NIGERIA_MTN | 0703, 0706, 0803, 0806, 0810, 0813, 0814, 0816, 0903, 0906, 0913, 0916, 0704, 07025, 07026 | Mobile | 🇳🇬 Nigeria | | NIGERIA_AIRTEL | 0701, 0708, 0802, 0808, 0812, 0901, 0902, 0904, 0907, 0912, 0911 | Mobile | 🇳🇬 Nigeria | | NIGERIA_GLO | 0705, 0805, 0807, 0811, 0815, 0905, 0915 | Mobile | 🇳🇬 Nigeria | | NIGERIA_9MOBILE | 0809, 0817, 0818, 0908, 0909 | Mobile | 🇳🇬 Nigeria | | NIGERIA_NTEL | 0804 | Mobile | 🇳🇬 Nigeria | | NIGERIA_SMILE | 0702 | Mobile | 🇳🇬 Nigeria | | NIGERIA_STARCOMMS | 07028, 07029, 0819 | Mobile | 🇳🇬 Nigeria | | NIGERIA_MULTILINKS | 07027, 0709 | Mobile | 🇳🇬 Nigeria | | NIGERIA_ZOOMMOBILE | 0707 | Mobile | 🇳🇬 Nigeria | | GHANA_MTN | 024, 054, 055, 059, 0256, 0257, 0597, 0598, 0599 | Mobile | 🇬🇭 Ghana | | GHANA_VODAFONE | 020, 050 | Mobile | 🇬🇭 Ghana | | GHANA_AIRTELTIGO | 026, 056, 027, 057 | Mobile | 🇬🇭 Ghana | | GHANA_GLO | 023 | Mobile | 🇬🇭 Ghana | | GHANA_EXPRESSO | 028 | Mobile | 🇬🇭 Ghana | | KENYA_SAFARICOM | 70, 71, 72, 74, 757-759, 768-769, 79, 110-115 | Mobile | 🇰🇪 Kenya | | KENYA_AIRTEL | 730-739, 750-756, 785-789, 100-102 | Mobile | 🇰🇪 Kenya | | KENYA_TELKOM | 770-779 | Mobile | 🇰🇪 Kenya | | KENYA_FAIBA | 747 | Mobile | 🇰🇪 Kenya | | KENYA_EQUITEL | 763-765 | Mobile | 🇰🇪 Kenya | | SOUTH_AFRICA_VODACOM | 72, 82, 606-609, 636-637, 646-649, 660-665, 711-716, 79, 818 | Mobile | 🇿🇦 South Africa | | SOUTH_AFRICA_MTN | 73, 83, 78, 710, 603-605, 630-635, 655-657, 810 | Mobile | 🇿🇦 South Africa | | SOUTH_AFRICA_CELL_C | 74, 84, 610-613, 615-619, 641-645, 650-653 | Mobile | 🇿🇦 South Africa | | SOUTH_AFRICA_TELKOM | 614, 658-659, 811-815, 817 | Mobile | 🇿🇦 South Africa | | SOUTH_AFRICA_VIRGIN_MOBILE | 741 | Mobile | 🇿🇦 South Africa | | MOROCCO_MAROC_TELECOM | 5, 6, 7, 8, 9 | Mobile/Fixe | 🇲🇦 Morocco | | MOROCCO_ORANGE_MAROC | 5, 6, 7, 8, 9 | Mobile/Fixe | 🇲🇦 Morocco | | MOROCCO_INWI | 5, 6, 7, 8, 9 | Mobile/Fixe | 🇲🇦 Morocco | | ETHIOPIA_ETHIO_TELECOM | 90-99 | Mobile | 🇪🇹 Ethiopia | | ETHIOPIA_SAFARICOM | 70-79 | Mobile | 🇪🇹 Ethiopia | | EGYPT_VODAFONE | 10 | Mobile | 🇪🇬 Egypt | | EGYPT_ETISALAT | 11 | Mobile | 🇪🇬 Egypt | | EGYPT_ORANGE | 12 | Mobile | 🇪🇬 Egypt | | EGYPT_WE | 15 | Mobile | 🇪🇬 Egypt | | TANZANIA_HALOTEL | 62 | Mobile | 🇹🇿 Tanzania | | TANZANIA_TIGO | 65, 67, 71 | Mobile | 🇹🇿 Tanzania | | TANZANIA_SMILE | 66 | Mobile | 🇹🇿 Tanzania | | TANZANIA_AIRTEL | 68, 69, 78 | Mobile | 🇹🇿 Tanzania | | TANZANIA_TTCL | 73 | Mixte | 🇹🇿 Tanzania | | TANZANIA_VODACOM | 74, 75, 76 | Mobile | 🇹🇿 Tanzania | | TANZANIA_ZANTEL | 77 | Mobile | 🇹🇿 Tanzania | | DRC_VODACOM | 81, 82 | Mobile | 🇨🇩 RDC | | DRC_ORANGE | 89 | Mobile | 🇨🇩 RDC | | DRC_AIRTEL | 97, 98 | Mobile | 🇨🇩 RDC | | DRC_AFRICELL | 90, 91 | Mobile | 🇨🇩 RDC | | UGANDA_AIRTEL | 70, 74, 75, 76 | Mobile | 🇺🇬 Uganda | | UGANDA_MTN | 77, 78 | Mobile | 🇺🇬 Uganda | | UGANDA_LYCAMOBILE | 79 | Mobile | 🇺🇬 Uganda | | RWANDA_MTN | 78, 79 | Mobile | 🇷🇼 Rwanda | | RWANDA_AIRTEL | 72, 73 | Mobile | 🇷🇼 Rwanda | | ALGERIA_MOBILIS | 5, 9 | Mobile | 🇩🇿 Algeria | | ALGERIA_DJEZZY | 65, 66, 67, 7, 8 | Mobile | 🇩🇿 Algeria | | ALGERIA_OOREDOO | 77, 78, 79 | Mobile | 🇩🇿 Algeria | | MALI_ORANGE | 70, 71, 72, 73, 74, 75, 76 | Mobile | 🇲🇱 Mali | | MALI_MOOV | 60, 61, 62, 63, 64 | Mobile | 🇲🇱 Mali | | MALI_TELECEL | 65, 66, 67 | Mobile | 🇲🇱 Mali | | SUDAN_ZAIN | 91, 92, 93, 95 | Mobile | 🇸🇩 Sudan | | SUDAN_MTN | 96, 97, 98 | Mobile | 🇸🇩 Sudan | | SUDAN_SUDANI | 99 | Mobile | 🇸🇩 Sudan | | MOZAMBIQUE_VODACOM | 82, 84 | Mobile | 🇲🇿 Mozambique | | MOZAMBIQUE_MOVITEL | 86, 87 | Mobile | 🇲🇿 Mozambique | | MOZAMBIQUE_TMCEL | 83 | Mobile | 🇲🇿 Mozambique | | ANGOLA_UNITEL | 91, 92 | Mobile | 🇦🇴 Angola | | ANGOLA_MOVICEL | 93 | Mobile | 🇦🇴 Angola | | ANGOLA_AFRICELL | 94, 95 | Mobile | 🇦🇴 Angola | | BURKINA_FASO_ORANGE | 70, 71, 72 | Mobile | 🇧🇫 Burkina Faso | | BURKINA_FASO_MOOV | 74, 75 | Mobile | 🇧🇫 Burkina Faso | | BURKINA_FASO_TELECEL | 76 | Mobile | 🇧🇫 Burkina Faso | | SOUTH_SUDAN_MTN | 92, 95 | Mobile | 🇸🇸 Soudan du Sud | | SOUTH_SUDAN_ZAIN | 91, 97 | Mobile | 🇸🇸 Soudan du Sud |

🔧 API Reference

🆕 NOUVEAU : Classe PhoneLookup

`PhoneLookup.analyze(phone: string, options?: PhoneLookupOptions): EnhancedPhoneInfo`

Analyse complète d'un numéro de téléphone avec toutes les informations et métadonnées.

`PhoneLookup.validate(phone: string, options?: PhoneLookupOptions): boolean`

Validation rapide d'un numéro de téléphone.

`PhoneLookup.getOperator(phone: string): string`

Détection rapide de l'opérateur.

`PhoneLookup.format(phone: string): string`

Formatage rapide d'un numéro.

`PhoneLookup.getStats()`

Obtient les statistiques globales de la librairie.

Méthodes d'instance avec chaînage :

const result = new PhoneLookup('+233241234567')
  .validate()    // Valide le numéro
  .format()      // Formate le numéro
  .getInfo();    // Obtient toutes les informations

API Classique (Toujours Disponible)

`detectOperator(phone: string): Operator`

Détecte l'opérateur mobile à partir d'un numéro de téléphone multi-pays.

Paramètres:

phone (string): Le numéro de téléphone (avec ou sans code pays)

Retourne:

Operator: L'opérateur détecté ou "Unknown"

`isValidNumber(phone: string): boolean`

Valide si un numéro de téléphone multi-pays est valide.

Paramètres:

phone (string): Le numéro de téléphone à valider

Retourne:

boolean: true si le numéro est valide, false sinon

`getPhoneInfo(phone: string): PhoneInfo`

Obtient des informations complètes sur un numéro de téléphone.

Paramètres:

phone (string): Le numéro de téléphone

Retourne:

PhoneInfo: Un objet avec toutes les informations du numéro

`formatPhoneNumber(phone: string): string`

Formate un numéro de téléphone en format lisible.

Paramètres:

phone (string): Le numéro de téléphone

Retourne:

string: Le numéro formaté avec espaces

`getOperatorPrefixes(operator: Operator): string[]`

Obtient tous les préfixes d'un opérateur spécifique.

Paramètres:

operator (Operator): L'opérateur

Retourne:

string[]: Liste des préfixes de l'opérateur

`getSupportedOperators(): Operator[]`

Obtient la liste de tous les opérateurs supportés.

Retourne:

Operator[]: Liste de tous les opérateurs

`isPrefixForOperator(prefix: string, operator: Operator): boolean`

Vérifie si un préfixe appartient à un opérateur spécifique.

Paramètres:

prefix (string): Le préfixe à vérifier
operator (Operator): L'opérateur

Retourne:

boolean: true si le préfixe appartient à l'opérateur

🆕 NOUVEAU : Validation Avancée

`validatePhoneNumber(phone: string): ValidationResult`

Valide un numéro avec messages d'erreur détaillés et suggestions.

`PhoneValidationError`

Classe d'erreur personnalisée avec codes d'erreur et suggestions.

🆕 NOUVEAU : Métadonnées des Pays

`getCountryMetadata(countryCode: string): CountryMetadata | null`

Obtient les métadonnées complètes d'un pays.

💡 Note sur les langues : Le Cameroun 🇨🇲 est le seul pays bilingue officiel (français + anglais) dans notre librairie. Son champ language retourne ['fr', 'en'], tandis que les autres pays retournent une seule langue.

`getAllCountries(): string[]`

Obtient la liste de tous les codes pays supportés.

`getCountryByCode(code: string): CountryMetadata | null`

Recherche un pays par son code.

📱 Types

`Operator`

type Operator = "CAMEROON_MTN" | "CAMEROON_ORANGE" | "CAMEROON_CAMTEL" | "CAMEROON_NEXTTEL" | "SENEGAL_ORANGE" | "SENEGAL_TIGO" | "SENEGAL_EXPRESSO" | "IVORY_COAST_ORANGE" | "IVORY_COAST_MTN" | "IVORY_COAST_MOOV" | "IVORY_COAST_TELECOM" | "NIGERIA_MTN" | "NIGERIA_AIRTEL" | "NIGERIA_GLO" | "NIGERIA_9MOBILE" | "GHANA_MTN" | "GHANA_VODAFONE" | "GHANA_AIRTELTIGO" | "Unknown";

`PhoneInfo`

interface PhoneInfo {
  operator: Operator;
  isValid: boolean;
  countryCode: string;
  localNumber: string;
  formattedNumber: string;
  isMobile: boolean;
  isFixed: boolean;
  length: number;
}

🆕 NOUVEAU : EnhancedPhoneInfo

interface EnhancedPhoneInfo extends PhoneInfo {
  phone: string;
  country: CountryMetadata | undefined;
  errors: string[] | undefined;
  suggestions: string[] | undefined;
}

🆕 NOUVEAU : CountryMetadata

interface CountryMetadata {
  name: string;
  nameLocal: string;
  flag: string;
  language: string | string[]; // Support pour langues multiples (Cameroun bilingue)
  currency: string;
  timezone: string;
  population?: string;
  capital?: string;
}

🆕 NOUVEAU : PhoneLookupOptions

interface PhoneLookupOptions {
  strictMode?: boolean;
  autoFormat?: boolean;
  language?: 'fr' | 'en';
  includeMetadata?: boolean;
  throwOnError?: boolean;
}

🆕 NOUVEAU : ValidationError

interface ValidationError {
  code: string;
  message: string;
  field: string | undefined;
  value: string | undefined;
  suggestion: string | undefined;
}

🧪 Tests

# Construire le projet
npm run build

# Lancer les tests classiques
npm test

# Lancer les tests des nouvelles fonctionnalités
node dist/test-enhanced.js

# Mode développement
npm run dev

# Nettoyer le dossier dist
npm run clean

🚀 Développement

# Cloner le repository
git clone https://github.com/williamtessa27/cm-phone-lookup.git

# Installer les dépendances
npm install

# Mode développement avec rechargement automatique
npm run dev

# Construire le projet
npm run build

📋 Fonctionnalités

✅ Fonctionnalités Classiques

Détection automatique des opérateurs multi-pays
Support multi-pays : Cameroun (+237), Sénégal (+221), Côte d'Ivoire (+225), Nigeria (+234), Ghana (+233), Kenya (+254), Afrique du Sud (+27), Maroc (+212), Éthiopie (+251), Égypte (+20), Tanzanie (+255), RDC (+243), Ouganda (+256), Rwanda (+250), Algérie (+213)
Validation complète des numéros de téléphone par pays
Support TypeScript avec types complets
Formatage automatique des numéros adapté au pays
Informations détaillées sur chaque numéro
Gestion des préfixes pour chaque opérateur
Tests complets pour toutes les fonctionnalités
Documentation complète en français et anglais
Compatibilité Node.js et navigateurs

🆕 NOUVELLES FONCTIONNALITÉS V1.5.0

API unifiée avec PhoneLookup.analyze() pour une analyse complète
Méthodes chainées (Fluent API) pour un code plus lisible
Configuration flexible avec options personnalisables
Validation avancée avec messages d'erreur détaillés et suggestions
Métadonnées enrichies des pays (drapeaux, capitales, populations, devises, fuseaux, langues officielles)
Bilinguisme du Cameroun 🇨🇲 : Support officiel français + anglais avec language: ['fr', 'en']
Gestion d'erreurs robuste avec codes d'erreur spécifiques
Méthodes statiques pour un usage rapide et simple
Statistiques globales de la librairie
Interface utilisateur améliorée pour une meilleure expérience développeur

🌍 Cas d'usage

Applications web nécessitant la validation de numéros multi-pays africains
Formulaires avec vérification automatique d'opérateur par pays
Systèmes de SMS avec routage par opérateur et par pays
Analytics sur l'utilisation des opérateurs par pays
Validation de numéros dans les bases de données multi-pays
Applications internationales nécessitant le support de plusieurs pays africains
Dashboards avec métadonnées pays et statistiques opérateurs
Systèmes de support client avec détection automatique du pays et de l'opérateur

🤝 Contribution

Les contributions sont les bienvenues ! N'hésitez pas à :

Fork le projet
Créer une branche pour votre fonctionnalité
Commiter vos changements
Pousser vers la branche
Ouvrir une Pull Request

📄 Licence

Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.

🙏 Remerciements

Tous les opérateurs télécoms des 15 pays africains supportés
Les communautés développeurs africaines
Tous les contributeurs open-source

Made with ❤️ across Africa 🌍 - Supporting 15 African countries: 🇨🇲🇸🇳🇨🇮🇳🇬🇬🇭🇰🇪🇿🇦🇲🇦🇪🇹🇪🇬🇹🇿🇨🇩🇺🇬🇷🇼🇩🇿

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

📱 @williamtessa27/cm-phone-lookup

🚀 Installation

📖 Utilisation

🎯 NOUVEAU : API Unifiée avec PhoneLookup.analyze()

🔗 NOUVEAU : Méthodes Chainées (Fluent API)

⚙️ NOUVEAU : Configuration Flexible

🚨 NOUVEAU : Gestion d'Erreurs Avancée

📊 NOUVEAU : Statistiques Globales

🌍 NOUVEAU : Métadonnées des Pays

📱 API Classique (Toujours Disponible)

Validation de numéro

Information complète

Formatage de numéro

Obtenir les préfixes d'un opérateur

Vérifier si un préfixe appartient à un opérateur

🏗️ Opérateurs supportés

🔧 API Reference

🆕 NOUVEAU : Classe PhoneLookup

PhoneLookup.analyze(phone: string, options?: PhoneLookupOptions): EnhancedPhoneInfo

PhoneLookup.validate(phone: string, options?: PhoneLookupOptions): boolean

PhoneLookup.getOperator(phone: string): string

PhoneLookup.format(phone: string): string

PhoneLookup.getStats()

Méthodes d'instance avec chaînage :

API Classique (Toujours Disponible)

detectOperator(phone: string): Operator

isValidNumber(phone: string): boolean

getPhoneInfo(phone: string): PhoneInfo

formatPhoneNumber(phone: string): string

getOperatorPrefixes(operator: Operator): string[]

getSupportedOperators(): Operator[]

isPrefixForOperator(prefix: string, operator: Operator): boolean

🆕 NOUVEAU : Validation Avancée

validatePhoneNumber(phone: string): ValidationResult

PhoneValidationError

🆕 NOUVEAU : Métadonnées des Pays

getCountryMetadata(countryCode: string): CountryMetadata | null

getAllCountries(): string[]

getCountryByCode(code: string): CountryMetadata | null

📱 Types

Operator

PhoneInfo

🆕 NOUVEAU : EnhancedPhoneInfo

🆕 NOUVEAU : CountryMetadata

🆕 NOUVEAU : PhoneLookupOptions

🆕 NOUVEAU : ValidationError

🧪 Tests

🚀 Développement

📋 Fonctionnalités

✅ Fonctionnalités Classiques

🆕 NOUVELLES FONCTIONNALITÉS V1.5.0

🌍 Cas d'usage

🤝 Contribution

📄 Licence

🙏 Remerciements

`PhoneLookup.analyze(phone: string, options?: PhoneLookupOptions): EnhancedPhoneInfo`

`PhoneLookup.validate(phone: string, options?: PhoneLookupOptions): boolean`

`PhoneLookup.getOperator(phone: string): string`

`PhoneLookup.format(phone: string): string`

`PhoneLookup.getStats()`

`detectOperator(phone: string): Operator`

`isValidNumber(phone: string): boolean`

`getPhoneInfo(phone: string): PhoneInfo`

`formatPhoneNumber(phone: string): string`

`getOperatorPrefixes(operator: Operator): string[]`

`getSupportedOperators(): Operator[]`

`isPrefixForOperator(prefix: string, operator: Operator): boolean`

`validatePhoneNumber(phone: string): ValidationResult`

`PhoneValidationError`

`getCountryMetadata(countryCode: string): CountryMetadata | null`

`getAllCountries(): string[]`

`getCountryByCode(code: string): CountryMetadata | null`

`Operator`

`PhoneInfo`