loon-bulma-react 2026.0.39 → 2026.0.41

package/dist/lib/utils/BSN.functions.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Controleer of een string een BSN bevat. Om dat te doen worden alle karakters, behalve letters en getallen gewist.
+ * Als er een of meer BSNs aangetroffen worden, worden ze allemaal teruggeven in een array.
+ * @param txt a string which could contain a BSN
+ * @returns false when there is no BSN or a tuple [true, Array<string>] where the string-array contains all found BSNs
+ * @example
+ * hasBSN('123456789')                       // [false, []]
+ * hasBSN('123456782')                       // [true, ['123456782']]
+ * hasBSN('xxx123456782xxx')                 // [true, ['123456782']]
+ * hasBSN('xxx123456789xxx')                 // [false, []]
+ * hasBSN('123x456x782')                     // [false, []]
+ * hasBSN('123.456.782')                     // [true, ['123456782']]
+ * hasBSN('123456782, 123456782, 123456782') // [true, ['123456782','123456782','123456782']]
+ */
+export declare function hasBSN(txt: string): readonly [boolean, Array<string>];
+/**
+ * Controleer of een string een BSN bevat.
+ * @param txt een string die een bsn zou kunnen zijn
+ * @returns true als de string een BSN is
+ * @example
+ * isBSN('12345')           // false
+ * isBSN('123456789')       // false
+ * isBSN('123456782')       // true
+ * isBSN('123456782000000') // false
+ */
+export declare function isBSN(txt: string): boolean;
+/**
+ * Genereer een willekeurig geldig BSN (Burgerservicenummer)
+ * @returns Een geldig 9-cijferig BSN als string
+ * @example
+ * generateBSN(); // '200644440'
+ * generateBSN(); // '218111058'
+ */
+export declare function generateBSN(): string;
+type MaskBSNOptions = {
+    /** Karakter gebruikt voor maskering (standaard: '*') */
+    maskChar?: string;
+    /** Aantal zichtbare cijfers aan het einde (standaard: 3) */
+    visibleDigits?: number;
+    /** Waar te maskeren: 'begin' = toon laatste chars, 'end' = toon eerste chars (standaard: 'end') */
+    maskFrom?: 'begin' | 'b' | 'end' | 'e';
+};
+/**
+ * Maskeer een BSN voor privacy doeleinden
+ * Toont alleen de eerste of laatste N cijfers, de rest wordt gemaskeerd
+ * @param bsn BSN nummer als string (mag voorloopnullen, spaties of separators bevatten)
+ * @param options Maskeer opties
+ * @returns Gemaskeerd BSN, of lege string als BSN ongeldig is
+ * @example
+ * maskBSN('123456782'); // '******782'
+ * maskBSN('123456782', { maskChar: 'X' }); // 'XXXXXX782'
+ * maskBSN('123456782', { visibleDigits: 4 }); // '*****6782'
+ * maskBSN('123456782', { maskFrom: 'begin' }); // '123******'
+ * maskBSN('123456782', { visibleDigits: 4, maskFrom: 'begin' }); // '1234*****'
+ */
+export declare function maskBSN(bsn: string, options?: MaskBSNOptions): string;
+export {};

package/dist/lib/utils/IBAN.functions.d.ts

@@ -0,0 +1,138 @@
+/** Iban gegevens per Land */
+export type IbanGegevens = {
+    /** landnaam waar deze settings van toepassing zijn */
+    land: string;
+    /** code voor het land zoals dat in een IBAN voorkomt */
+    code: string;
+    /** Kunnen we SEPA's gebruiken? */
+    sepa: boolean;
+    /** een voorbeeld-IBAN-nummer (lege string betekent niet ondersteund) */
+    IBAN: string;
+    /** wordt dit land ondersteund? (afgeleid van of er een IBAN voorbeeld is) */
+    supported: boolean;
+    /** regex patroon voor BBAN validatie (optioneel) */
+    bbanRgx?: string | undefined;
+};
+type IBANFormatOptions = {
+    /** Separator tussen groepen karakters (standaard: spatie) */
+    separator?: string;
+    /** Aantal karakters per groep (standaard: 4) */
+    groupSize?: number;
+    /** Converteer naar lowercase in plaats van uppercase (standaard: false) */
+    lowercase?: boolean;
+    /** Extra separator na landcode (standaard: false) */
+    countryCodeSeparate?: boolean;
+    /** Toon alleen BBAN zonder landcode en check digits (standaard: false) */
+    stripCountryCode?: boolean;
+};
+type MaskIBANOptions = {
+    /** Karakter gebruikt voor maskering (standaard: '*') */
+    maskChar?: string;
+    /** Aantal zichtbare karakters (standaard: 4, minimum: 4 wanneer keepCountryCode true) */
+    visibleChars?: number;
+    /** Waar te maskeren: 'begin' = toon laatste chars, 'end' = toon eerste chars (standaard: 'end') */
+    maskFrom?: 'begin' | 'b' | 'end' | 'e';
+    /** Behoud landcode zichtbaar (standaard: true) */
+    keepCountryCode?: boolean;
+};
+/**
+ * Type voor Nederlandse bank codes (BIC codes zonder SWIFT suffix)
+ * Uitgebreide lijst van alle bekende Nederlandse banken en financiële instellingen
+ */
+export type DutchBankCode = {
+    bic: string;
+    code: string;
+    name: string;
+};
+/**
+ * Verwijder spaties, streepjes en andere niet-alfanumerieke karakters uit een IBAN en zet deze om naar hoofdletters
+ * @param iban IBAN nummer met of zonder spaties/streepjes
+ * @returns Schone IBAN in elektronisch formaat (alleen hoofdletters en cijfers), of lege string als de input geen string is
+ * @example
+ * cleanIBAN('NL91 ABNA 0417 1643 00'); // 'NL91ABNA0417164300'
+ * cleanIBAN('NL91-ABNA-0417-1643-00'); // 'NL91ABNA0417164300'
+ * cleanIBAN('nl91abna0417164300'); // 'NL91ABNA0417164300'
+ */
+export declare function cleanIBAN(iban: string | null | undefined): string;
+/**
+ * Formatteer een IBAN met spaties (of eigen separator) na elke N karakters voor weergave
+ * @param iban IBAN nummer (met of zonder spaties)
+ * @param options Formatting opties
+ * @returns Geformatteerde IBAN (lege string als input geen string is)
+ * @example
+ * formattedIBAN('NL91ABNA0417164300'); // 'NL91 ABNA 0417 1643 00'
+ * formattedIBAN('NL91ABNA0417164300', { separator: '-' }); // 'NL91-ABNA-0417-1643-00'
+ * formattedIBAN('NL91ABNA0417164300', { lowercase: true }); // 'nl91 abna 0417 1643 00'
+ * formattedIBAN('NL91ABNA0417164300', { groupSize: 3 }); // 'NL9 1AB NA0 417 164 300'
+ * formattedIBAN('NL91ABNA0417164300', { countryCodeSeparate: true }); // 'NL91  ABNA 0417 1643 00'
+ * formattedIBAN('NL91ABNA0417164300', { stripCountryCode: true }); // 'ABNA 0417 1643 00'
+ */
+export declare function formattedIBAN(iban: string | null | undefined, options?: IBANFormatOptions): string;
+/**
+ * Maskeer een IBAN voor privacy doeleinden
+ * Toont alleen een deel van het IBAN, de rest wordt gemaskeerd
+ * @param iban IBAN nummer (met of zonder spaties)
+ * @param options Maskeer opties
+ * @param options.maskChar Karakter gebruikt voor maskering (standaard: '*')
+ * @param options.visibleChars Aantal zichtbare karakters (standaard: 4). Wanneer keepCountryCode true is, wordt dit automatisch minimaal 4 (voor de landcode)
+ * @param options.maskFrom Waar te maskeren: 'begin' = toon laatste chars, 'end' = toon eerste chars (standaard: 'end')
+ * @param options.keepCountryCode Houd de landcode altijd zichtbaar (standaard: true). Wanneer true, is visibleChars minimaal 4
+ * @returns Gemaskeerd IBAN, of lege string als IBAN ongeldig is
+ * @example
+ * maskIBAN('NL91ABNA0417164300'); // 'NL91**************' (visibleChars: 4 = only country)
+ * maskIBAN('NL91ABNA0417164300', { maskChar: 'X' }); // 'NL91XXXXXXXXXXXXXX'
+ * maskIBAN('NL91ABNA0417164300', { visibleChars: 8 }); // 'NL91ABNA**********' (country + 4 from BBAN)
+ * maskIBAN('NL91ABNA0417164300', { visibleChars: 8, maskFrom: 'begin' }); // 'NL91**********4300' (country + last 4 from BBAN)
+ * maskIBAN('NL91ABNA0417164300', { keepCountryCode: false }); // 'NL91**************'
+ * maskIBAN('NL91ABNA0417164300', { keepCountryCode: false, visibleChars: 6 }); // 'NL91AB************'
+ */
+export declare function maskIBAN(iban: string | null | undefined, options?: MaskIBANOptions): string;
+/**
+ * Controleer of een opgegeven rekeningnummer wel een IBAN nummer is.
+ * @param rekNr het rekeningsnummer dat gecontroleerd moet worden
+ * @param opts extra opties
+ * @param opts.allowed lijst van toegestane landcodes (optioneel)
+ * @param opts.disallowed lijst van verboden landcodes (optioneel)
+ * @returns een tuple met een boolean en een string
+ * - `[true, 'LAND']` als het een geldige IBAN is
+ * - `[false, 'invalid format']` als het niet voldoet aan het IBAN-formaat
+ * - `[false, 'invalid landcode']` als de landcode niet bestaat (in onze gegevens)
+ * - `[false, 'invalid length']` als het niet voldoet aan de lengte-eis die hoort bij de landcode
+ * - `[false, 'invalid bban structure']` als het BBAN-gedeelte niet voldoet aan het formaat van het land
+ * - `[false, 'invalid restgetal']` als het niet voldoet aan de mod-97 berekening voor IBAN
+ * @example
+ * const [bool, msg] = isIBAN('NL28 ASNB 0709 1665 92');  // [true, 'Nederland']
+ * const [bool, msg] = isIBAN('NL28 ASNB 0709 1665 922'); // [false, 'invalid length']
+ * const [bool, msg] = isIBAN('NL28 ASNB 0709 1665 93');  // [false, 'invalid restgetal']
+ * const [bool, msg] = isIBAN('NL28 1234 5678 9012 34');  // [false, 'invalid bban structure']
+ * const [bool, msg] = isIBAN('ABCDEFG');                 // [false, 'invalid format']
+ * const [bool, msg] = isIBAN('QQ28 ASNB 0709 1665 93');  // [false, 'invalid landcode']
+ * const [bool, msg] = isIBAN('BE68 5390 0754 7034', { disallowed: ['BE', 'DE', 'FR'] }); // [false, 'disallowed landcode']
+ * const [bool, msg] = isIBAN('DE89 3704 0044 0532 0130 00', { allowed: ['DE', 'FR'] }); // [true, 'Duitsland']
+ * const [bool, msg] = isIBAN('FR14 2004 1010 0505 0001 3M02 606', { allowed: ['BE', 'FR'], disallowed: ['DE', 'FR'] }); // [false, `allowed & disallowed contain the same country 'FR'`]
+ */
+export declare function isIBAN(rekNr: string, opts?: {
+    allowed?: string[] | undefined;
+    disallowed?: string[] | undefined;
+} | undefined): readonly [boolean, string];
+/**
+ * Genereer een willekeurig geldig Nederlands IBAN nummer
+ * @param bankCode Optionele Nederlandse bankcode (4 letters, bijv. 'ASNB', 'TRIO'). Als niet opgegeven wordt een willekeurige bankcode gekozen uit veelgebruikte banken. Het accountnummer (10 cijfers) wordt altijd willekeurig gegenereerd.
+ * @returns Een geldig Nederlands IBAN nummer
+ * @example
+ * generateIban(); // Volledig willekeurig NL IBAN, bijv. "NL91ABNA0417164300"
+ * generateIban('INGB'); // NL IBAN met ING Bank, bijv. "NL13INGB0001234567"
+ * generateIban('TRIO'); // Ook met minder gebruikte banken zoals Triodos
+ */
+export declare function generateIban(bankCode?: string): string;
+/** * Alleen de meest gebruikte Nederlandse banken voor random generatie .
+ * @see https://www.betaalvereniging.nl/betalingsverkeer/giraal-betalingsverkeer/bic-sepa-transacties/
+ */
+export declare const COMMON_DUTCH_BANKS: ReadonlyArray<DutchBankCode>;
+/** Een array van landen met de landcode en de lengte van een IBAN. Ook een voorbeeld-IBAN.
+ * @link https://www.iban.com/structure
+ */
+export declare const IbanDetailsPerLand: Readonly<Array<IbanGegevens>>;
+/** Type for all valid IBAN country codes */
+export type IbanCountryCode = (typeof IbanDetailsPerLand)[number]['code'];
+export {};