bakissation/houwiya

Validate, parse & extract Algerian identifiers in TypeScript — NIN, NIF, NIS, RC, RIB/CCP/IBAN, CNAS. Checksums, wilaya extraction, Arabic-aware, zero dependencies. # @bakissation/houwiya **Validate, parse, and extract Algerian identifiers** in TypeScript — NIN, NIF, NIS, RC, RIB/CCP/IBAN, CNAS. Don't just check validity: pull out exactly the part you need (the wilaya of an RC, the sex from a NIN, the account from a RIB). **Zero runtime dependencies.** - 🔎 **Parse, don't just validate** — every `parse*` returns a typed object you can read one field from. - ✅ **Real checksums** — NIN (Luhn), RIB / CCP / IBAN (mod-97). Structural validation for the rest. - 🧩 **Semantic extraction** — wilaya (NIF/NIS/RC/CNAS), entity type (RC `A/B`), sex + birth year (NIN), bank/agency/account (RIB). - 🇩🇿 **Algeria-aware** — 69 wilayas (2026 reform), Latin **and** Arabic input (`أ/ب`, Arabic-Indic digits), the CCP↔RIB "BaridiMob" bridge. - 🧱 **Strict TypeScript, ESM + CommonJS, zero dependencies.** ## Install ```bash npm install @bakissation/houwiya ``` Requires **Node.js ≥ 18**. ## Quick start ```typescript import { parseRc, parseNin, parseRib, isValidIban } from '@bakissation/houwiya'; // Extract just the part you need parseRc('24B1282577').wilaya; // { code: '16', name: 'Alger' } (when present) parseRc('24B1282577').entityType; // 'morale' (A/أ → physique, B/ب → morale) parseNin('119881234056700007').sex; // 'female' (+ birthYearDigits, communeCode…) — Luhn-checked parseRib('00100023456...').account; // decomposed; mod-97 verified isValidIban('DZ58 0002 1000 ...'); // ISO mod-97 ``` Lenient by design: even when `valid` is `false`, any parts that could be extracted are still returned. ## Supported identifiers | Identifier | Function | Checksum | Extracts | |---|---|---|---| | **NIN** (national ID) | `parseNin` | Luhn | sex, birth year, commune, act sequence | | **NIF** (tax) | `parseNif` | — | 15-digit core, establishment suffix | | **NIS** (statistical) | `parseNis` | — | wilaya, commune, secondary suffix | | **RC** (trade register) | `parseRc` | — | entity type (A/B/أ/ب), year, sequence, wilaya | | **RIB** (bank) | …