@konce-pt/validators 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 konce.pt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,38 @@
+# @konce-pt/validators
+
+Walidatory polskiego pionu dla [Koncept UI](https://gitlab.com/konce-pt/koncept-ui):
+NIP, REGON, PESEL, IBAN, kod pocztowy i numer rachunku bankowego (NRB).
+Czysty TypeScript, **zero zależności runtime**.
+
+```bash
+npm i @konce-pt/validators
+```
+
+```ts
+import { isValidNip, isValidPesel, peselDate, peselSex } from '@konce-pt/validators';
+
+isValidNip('123-456-32-18');   // true (separatory tolerowane)
+isValidPesel('44051401359');   // true
+peselDate('44051401359');      // Date 1944-05-14
+peselSex('44051401359');       // 'male'
+```
+
+## API
+
+| Funkcja | Zwraca | Opis |
+|---|---|---|
+| `isValidNip(value)` | `boolean` | NIP — 10 cyfr, suma kontrolna mod 11 |
+| `isValidRegon(value)` | `boolean` | REGON — 9 lub 14 cyfr |
+| `isValidPesel(value)` | `boolean` | PESEL — 11 cyfr, mod 10 + poprawna data |
+| `peselDate(value)` | `Date \| null` | Data urodzenia zakodowana w PESEL-u |
+| `peselSex(value)` | `'male' \| 'female' \| null` | Płeć z PESEL-u |
+| `isValidIban(value)` | `boolean` | IBAN — mod 97, długość per kraj (PL = 28) |
+| `isValidNrb(value)` | `boolean` | Polski rachunek NRB — 26 cyfr |
+| `isValidPostalCodePl(value)` | `boolean` | Kod pocztowy `NN-NNN` |
+
+Wszystkie funkcje są czyste i synchroniczne. Separatory (spacje, myślniki) są tolerowane
+w NIP/REGON/PESEL/NRB/IBAN.
+
+## Licencja
+
+MIT © konce.pt

package/dist/iban.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Waliduje IBAN po regule mod 97. Ignoruje spacje, wielkość liter bez znaczenia.
+ * Jeśli kraj jest znany, sprawdza też wymaganą długość (np. PL = 28).
+ */
+export declare function isValidIban(value: string): boolean;

package/dist/iban.js

@@ -0,0 +1,33 @@
+// Długości IBAN dla wybranych krajów (podzbiór). Brak wpisu = tylko ogólna walidacja mod 97.
+const IBAN_LENGTHS = {
+    PL: 28, DE: 22, GB: 22, FR: 27, ES: 24, IT: 27, NL: 18, CZ: 24, SK: 24, AT: 20,
+    BE: 16, CH: 21, DK: 18, IE: 22, LT: 20, LV: 21, EE: 20, PT: 25, SE: 24, NO: 15,
+};
+function mod97(iban) {
+    // Przenosimy 4 pierwsze znaki na koniec i zamieniamy litery na liczby (A=10..Z=35),
+    // licząc resztę mod 97 kawałkami, by nie przekroczyć zakresu liczb.
+    const rearranged = iban.slice(4) + iban.slice(0, 4);
+    let remainder = 0;
+    for (const ch of rearranged) {
+        const chunk = ch >= 'A' && ch <= 'Z' ? String(ch.charCodeAt(0) - 55) : ch;
+        for (const digit of chunk) {
+            remainder = (remainder * 10 + Number(digit)) % 97;
+        }
+    }
+    return remainder;
+}
+/**
+ * Waliduje IBAN po regule mod 97. Ignoruje spacje, wielkość liter bez znaczenia.
+ * Jeśli kraj jest znany, sprawdza też wymaganą długość (np. PL = 28).
+ */
+export function isValidIban(value) {
+    const iban = value.replace(/\s/g, '').toUpperCase();
+    if (!/^[A-Z]{2}[0-9]{2}[A-Z0-9]+$/.test(iban))
+        return false;
+    if (iban.length < 15 || iban.length > 34)
+        return false;
+    const expected = IBAN_LENGTHS[iban.slice(0, 2)];
+    if (expected !== undefined && iban.length !== expected)
+        return false;
+    return mod97(iban) === 1;
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { isValidNip } from './nip.ts';
+export { isValidRegon } from './regon.ts';
+export { isValidPesel, peselDate, peselSex, type Sex } from './pesel.ts';
+export { isValidIban } from './iban.ts';
+export { isValidNrb } from './nrb.ts';
+export { isValidPostalCodePl } from './postal-code.ts';

package/dist/index.js

@@ -0,0 +1,7 @@
+// @konce-pt/validators — walidatory polskiego pionu. Czysty TS, zero zależności runtime.
+export { isValidNip } from "./nip.js";
+export { isValidRegon } from "./regon.js";
+export { isValidPesel, peselDate, peselSex } from "./pesel.js";
+export { isValidIban } from "./iban.js";
+export { isValidNrb } from "./nrb.js";
+export { isValidPostalCodePl } from "./postal-code.js";

package/dist/internal.d.ts

@@ -0,0 +1,6 @@
+/** Usuwa spacje i myślniki — typowe separatory w NIP/REGON/PESEL/NRB. */
+export declare function stripSeparators(value: string): string;
+/** Czy ciąg składa się wyłącznie z cyfr (i jest niepusty). */
+export declare function isAllDigits(value: string): boolean;
+/** Suma iloczynów kolejnych cyfr i wag. Wagi wyznaczają długość liczenia. */
+export declare function weightedSum(digits: string, weights: readonly number[]): number;

package/dist/internal.js

@@ -0,0 +1,17 @@
+// Wspólne helpery walidatorów. Nie eksportowane z paczki (implementacja wewnętrzna).
+/** Usuwa spacje i myślniki — typowe separatory w NIP/REGON/PESEL/NRB. */
+export function stripSeparators(value) {
+    return value.replace(/[\s-]/g, '');
+}
+/** Czy ciąg składa się wyłącznie z cyfr (i jest niepusty). */
+export function isAllDigits(value) {
+    return value.length > 0 && /^[0-9]+$/.test(value);
+}
+/** Suma iloczynów kolejnych cyfr i wag. Wagi wyznaczają długość liczenia. */
+export function weightedSum(digits, weights) {
+    let sum = 0;
+    for (let i = 0; i < weights.length; i++) {
+        sum += Number(digits[i]) * weights[i];
+    }
+    return sum;
+}

package/dist/nip.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Waliduje polski NIP (10 cyfr) po sumie kontrolnej mod 11.
+ * Akceptuje separatory (spacje, myślniki), np. `123-456-32-18`.
+ */
+export declare function isValidNip(value: string): boolean;

package/dist/nip.js

@@ -0,0 +1,15 @@
+import { stripSeparators, isAllDigits, weightedSum } from "./internal.js";
+const NIP_WEIGHTS = [6, 5, 7, 2, 3, 4, 5, 6, 7];
+/**
+ * Waliduje polski NIP (10 cyfr) po sumie kontrolnej mod 11.
+ * Akceptuje separatory (spacje, myślniki), np. `123-456-32-18`.
+ */
+export function isValidNip(value) {
+    const nip = stripSeparators(value);
+    if (nip.length !== 10 || !isAllDigits(nip))
+        return false;
+    const control = weightedSum(nip, NIP_WEIGHTS) % 11;
+    if (control === 10)
+        return false; // niemożliwa cyfra kontrolna
+    return control === Number(nip[9]);
+}

package/dist/nrb.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Waliduje polski numer rachunku bankowego NRB (26 cyfr) — to samo, co „numer
+ * rachunku VAT". Poprawność liczona przez regułę IBAN dla `PL` + 26 cyfr.
+ * Akceptuje separatory (spacje, myślniki).
+ */
+export declare function isValidNrb(value: string): boolean;

package/dist/nrb.js

@@ -0,0 +1,13 @@
+import { stripSeparators, isAllDigits } from "./internal.js";
+import { isValidIban } from "./iban.js";
+/**
+ * Waliduje polski numer rachunku bankowego NRB (26 cyfr) — to samo, co „numer
+ * rachunku VAT". Poprawność liczona przez regułę IBAN dla `PL` + 26 cyfr.
+ * Akceptuje separatory (spacje, myślniki).
+ */
+export function isValidNrb(value) {
+    const nrb = stripSeparators(value);
+    if (nrb.length !== 26 || !isAllDigits(nrb))
+        return false;
+    return isValidIban('PL' + nrb);
+}

package/dist/pesel.d.ts

@@ -0,0 +1,16 @@
+export type Sex = 'male' | 'female';
+/**
+ * Waliduje polski PESEL (11 cyfr): suma kontrolna mod 10 oraz poprawność
+ * zakodowanej daty urodzenia (miesiąc niesie stulecie).
+ */
+export declare function isValidPesel(value: string): boolean;
+/**
+ * Data urodzenia zakodowana w PESEL-u lub `null`, gdy PESEL ma złą długość,
+ * niecyfrowe znaki albo niepoprawną datę. Nie sprawdza sumy kontrolnej.
+ */
+export declare function peselDate(value: string): Date | null;
+/**
+ * Płeć zakodowana w PESEL-u (przedostatnia cyfra: parzysta = kobieta) lub `null`
+ * przy złej długości/niecyfrowych znakach. Nie sprawdza sumy kontrolnej.
+ */
+export declare function peselSex(value: string): Sex | null;

package/dist/pesel.js

@@ -0,0 +1,65 @@
+import { stripSeparators, isAllDigits, weightedSum } from "./internal.js";
+const PESEL_WEIGHTS = [1, 3, 7, 9, 1, 3, 7, 9, 1, 3];
+/**
+ * Waliduje polski PESEL (11 cyfr): suma kontrolna mod 10 oraz poprawność
+ * zakodowanej daty urodzenia (miesiąc niesie stulecie).
+ */
+export function isValidPesel(value) {
+    const pesel = stripSeparators(value);
+    if (pesel.length !== 11 || !isAllDigits(pesel))
+        return false;
+    const control = (10 - (weightedSum(pesel, PESEL_WEIGHTS) % 10)) % 10;
+    if (control !== Number(pesel[10]))
+        return false;
+    return peselDate(pesel) !== null;
+}
+/**
+ * Data urodzenia zakodowana w PESEL-u lub `null`, gdy PESEL ma złą długość,
+ * niecyfrowe znaki albo niepoprawną datę. Nie sprawdza sumy kontrolnej.
+ */
+export function peselDate(value) {
+    const pesel = stripSeparators(value);
+    if (pesel.length !== 11 || !isAllDigits(pesel))
+        return null;
+    const yy = Number(pesel.slice(0, 2));
+    let month = Number(pesel.slice(2, 4));
+    const day = Number(pesel.slice(4, 6));
+    let century;
+    if (month >= 1 && month <= 12)
+        century = 1900;
+    else if (month >= 21 && month <= 32) {
+        century = 2000;
+        month -= 20;
+    }
+    else if (month >= 41 && month <= 52) {
+        century = 2100;
+        month -= 40;
+    }
+    else if (month >= 61 && month <= 72) {
+        century = 2200;
+        month -= 60;
+    }
+    else if (month >= 81 && month <= 92) {
+        century = 1800;
+        month -= 80;
+    }
+    else
+        return null;
+    const year = century + yy;
+    const date = new Date(year, month - 1, day);
+    // Odrzuca przepełnienia (np. 31 lutego przesunięte na marzec).
+    if (date.getFullYear() !== year || date.getMonth() !== month - 1 || date.getDate() !== day) {
+        return null;
+    }
+    return date;
+}
+/**
+ * Płeć zakodowana w PESEL-u (przedostatnia cyfra: parzysta = kobieta) lub `null`
+ * przy złej długości/niecyfrowych znakach. Nie sprawdza sumy kontrolnej.
+ */
+export function peselSex(value) {
+    const pesel = stripSeparators(value);
+    if (pesel.length !== 11 || !isAllDigits(pesel))
+        return null;
+    return Number(pesel[9]) % 2 === 0 ? 'female' : 'male';
+}

package/dist/postal-code.d.ts

@@ -0,0 +1,2 @@
+/** Waliduje polski kod pocztowy w formacie `NN-NNN` (np. `00-950`). */
+export declare function isValidPostalCodePl(value: string): boolean;

package/dist/postal-code.js

@@ -0,0 +1,4 @@
+/** Waliduje polski kod pocztowy w formacie `NN-NNN` (np. `00-950`). */
+export function isValidPostalCodePl(value) {
+    return /^[0-9]{2}-[0-9]{3}$/.test(value.trim());
+}

package/dist/regon.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Waliduje polski REGON — 9-cyfrowy (podmiot) lub 14-cyfrowy (jednostka lokalna).
+ * Dla 14 cyfr sprawdza także poprawność 9-cyfrowego prefiksu.
+ */
+export declare function isValidRegon(value: string): boolean;

package/dist/regon.js

@@ -0,0 +1,25 @@
+import { stripSeparators, isAllDigits, weightedSum } from "./internal.js";
+const REGON9_WEIGHTS = [8, 9, 2, 3, 4, 5, 6, 7];
+const REGON14_WEIGHTS = [2, 4, 8, 5, 0, 9, 7, 3, 6, 1, 2, 4, 8];
+function controlDigit(digits, weights) {
+    const mod = weightedSum(digits, weights) % 11;
+    return mod === 10 ? 0 : mod;
+}
+/**
+ * Waliduje polski REGON — 9-cyfrowy (podmiot) lub 14-cyfrowy (jednostka lokalna).
+ * Dla 14 cyfr sprawdza także poprawność 9-cyfrowego prefiksu.
+ */
+export function isValidRegon(value) {
+    const regon = stripSeparators(value);
+    if (!isAllDigits(regon))
+        return false;
+    if (regon.length === 9) {
+        return controlDigit(regon, REGON9_WEIGHTS) === Number(regon[8]);
+    }
+    if (regon.length === 14) {
+        if (controlDigit(regon.slice(0, 9), REGON9_WEIGHTS) !== Number(regon[8]))
+            return false;
+        return controlDigit(regon, REGON14_WEIGHTS) === Number(regon[13]);
+    }
+    return false;
+}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@konce-pt/validators",
+  "version": "0.2.0",
+  "description": "Polish-domain validators for Koncept UI — NIP, REGON, PESEL, IBAN, postal code, bank account (NRB). Pure TypeScript, zero runtime dependencies.",
+  "license": "MIT",
+  "author": "konce.pt",
+  "homepage": "https://gitlab.com/konce-pt/koncept-ui#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/konce-pt/koncept-ui.git",
+    "directory": "packages/validators"
+  },
+  "bugs": {
+    "url": "https://gitlab.com/konce-pt/koncept-ui/-/issues"
+  },
+  "keywords": [
+    "validators",
+    "nip",
+    "regon",
+    "pesel",
+    "iban",
+    "nrb",
+    "polish",
+    "poland",
+    "koncept-ui"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "devDependencies": {
+    "typescript": "~6.0.3"
+  },
+  "nx": {
+    "targets": {
+      "build": {
+        "outputs": [
+          "{projectRoot}/dist"
+        ],
+        "cache": true
+      },
+      "test": {
+        "cache": true
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "node --test \"src/**/*.test.ts\"",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\""
+  }
+}