💳 IBAN Helper

📖 Introductie

De IBAN Helper bevat utility functies voor het verwerken en valideren van IBAN-nummers (International Bank Account Numbers).

---

📦 Functionaliteit

🔤 Basis

• normalize(value) → verwijdert spaties en zet om naar uppercase
• format(value) → groepeert IBAN in blokken van 4 tekens

✅ Validatie

• isValid(value) → controleert geldigheid volgens IBAN standaard

---

⚙️ Werking

De IBAN Helper voert een volledige validatie uit volgens de internationale standaard.

1. Normaliseren

• Verwijdert spaties
• Zet om naar uppercase

2. Structuur validatie

• Controleert patroon: ^[A-Z]{2}\d{2}[A-Z0-9]+$
• Controleert landcode + controlegetal

3. Lengte controle

• Controleert lengte per land (via interne mapping)

4. Rearrange

• Eerste 4 karakters worden naar het einde verplaatst

5. Conversie

• Letters worden vervangen door cijfers:
  • A = 10, B = 11, ..., Z = 35

6. Modulo 97 check

remainder === 1

---

🌍 Ondersteunde landen

Land	Lengte
NL	18
BE	16
DE	22
FR	27
ES	24
IT	27
GB	22
IE	22
PT	25
AT	20
CH	21
LU	20
SE	24
NO	15
DK	18
FI	18
PL	28
CZ	24
SK	24
HU	28
RO	24
BG	22
HR	21
SI	19

---

⚠️ Belangrijke aandachtspunten

• isValid() voert volledige checksum validatie uit
• normalize() altijd gebruiken vóór opslag of validatie
• format() alleen voor weergave (niet opslag)
• Alleen landen in de mapping worden ondersteund

---

💡 Voorbeelden

Normaliseren

const iban = core.IBAN.normalize("nl91 abna 0417 1643 00");
// "NL91ABNA0417164300"

Formatteren

const formatted = core.IBAN.format("NL91ABNA0417164300");
// "NL91 ABNA 0417 1643 00"

Validatie

const valid = core.IBAN.isValid("NL91ABNA0417164300");
// true / false

---

📊 Samenvatting