@stll/stdnum 2.1.0 → 2.1.2

package/src/be/nn.ts

@@ -1,129 +0,0 @@
-/**
- * NN (Numéro national / Rijksregisternummer).
- *
- * Belgian national identification number. 11 digits
- * encoding date of birth, serial number, and a
- * check digit pair. The first 6 digits are YYMMDD,
- * followed by a 3-digit serial and 2 check digits.
- *
- * @see https://fr.wikipedia.org/wiki/Numéro_de_registre_national
- * @see https://www.ibz.rrn.fgov.be/
- */
-
-import type {
-  ValidateResult,
-  CountryValidator,
-} from "../types";
-
-import { clean } from "#util/clean";
-import { randomInt } from "#util/generate";
-import { err } from "#util/result";
-import { isdigits } from "#util/strings";
-
-const compact = (value: string): string =>
-  clean(value, " .-");
-
-/**
- * Verify the mod-97 checksum and return the detected
- * century (1900 or 2000). Returns null on mismatch.
- * Matches python-stdnum's _checksum logic: the 2000s
- * century is only attempted when YY+2000 <= current year.
- */
-const checksum = (v: string): number | null => {
-  const first9 = Number(v.slice(0, 9));
-  const check = Number(v.slice(9, 11));
-
-  if (97 - (first9 % 97) === check) return 1900;
-
-  const yy = Number(v.slice(0, 2));
-  if (yy + 2000 <= new Date().getFullYear()) {
-    const with2 = Number(`2${v.slice(0, 9)}`);
-    if (97 - (with2 % 97) === check) return 2000;
-  }
-
-  return null;
-};
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 11) {
-    return err(
-      "INVALID_LENGTH",
-      "NN must be exactly 11 digits",
-    );
-  }
-  if (!isdigits(v) || Number(v) === 0) {
-    return err(
-      "INVALID_FORMAT",
-      "NN must contain only digits",
-    );
-  }
-
-  if (checksum(v) === null) {
-    return err(
-      "INVALID_CHECKSUM",
-      "NN check digits do not match",
-    );
-  }
-
-  // Raw month digits must be 0..12 (values 13+ are
-  // invalid; counter-exhaustion uses 00, not 20+).
-  const rawMonth = Number(v.slice(2, 4));
-  if (rawMonth > 12) {
-    return err(
-      "INVALID_COMPONENT",
-      "Month must be in 0..12",
-    );
-  }
-
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => {
-  const v = compact(value);
-  return `${v.slice(0, 2)}.${v.slice(2, 4)}.${v.slice(4, 6)}-${v.slice(6, 9)}.${v.slice(9)}`;
-};
-
-/** Generate a random valid Belgian NN. */
-const generate = (): string => {
-  for (;;) {
-    const yy = String(randomInt(0, 99)).padStart(2, "0");
-    const mm = String(randomInt(1, 12)).padStart(2, "0");
-    const dd = String(randomInt(1, 28)).padStart(2, "0");
-    const serial = String(randomInt(1, 997)).padStart(
-      3,
-      "0",
-    );
-    const base = yy + mm + dd + serial;
-    const n1 = Number(base);
-    const check1 = 97 - (n1 % 97);
-    const c = base + String(check1).padStart(2, "0");
-    if (validate(c).valid) return c;
-  }
-};
-
-/** Belgian National Number. */
-const nn: CountryValidator<"BE"> = {
-  name: "Belgian National Number",
-  localName: "Numéro national",
-  abbreviation: "NN",
-  aliases: [
-    "rijksregisternummer",
-    "numéro national",
-    "NN",
-  ] as const,
-  candidatePattern:
-    "\\d{2}\\.?\\d{2}\\.?\\d{2}-?\\d{3}\\.?\\d{2}",
-  scope: "country",
-  country: "BE",
-  entityType: "person",
-  sourceUrl: "https://www.ibz.rrn.fgov.be/",
-  examples: ["93051822361"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default nn;
-export { checksum, compact, format, validate, generate };

package/src/be/vat.ts

@@ -1,111 +0,0 @@
-/**
- * BTW/TVA/MWSt (Belgian VAT number).
- *
- * 10 digits, first must be 0 or 1.
- * Checksum: (first 8 digits + last 2) % 97 === 0.
- *
- * @see https://www.vatify.eu/belgium-vat-number.html
- * @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/belgium-tin.pdf
- */
-
-import type {
-  ValidateResult,
-  CountryValidator,
-} from "../types";
-
-import { clean } from "#util/clean";
-import { randomDigits } from "#util/generate";
-import { err } from "#util/result";
-import { isdigits } from "#util/strings";
-
-const compact = (value: string): string => {
-  let v = clean(value, " -/.");
-  if (v.startsWith("BE") || v.startsWith("be")) {
-    v = v.slice(2);
-  }
-  // Old 9-digit format: zero-pad to 10
-  if (v.length === 9) {
-    v = `0${v}`;
-  }
-  return v;
-};
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 10) {
-    return err(
-      "INVALID_LENGTH",
-      "Belgian VAT number must be 10 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "Belgian VAT number must contain only digits",
-    );
-  }
-  if (Number(v) === 0) {
-    return err(
-      "INVALID_FORMAT",
-      "Belgian VAT number cannot be all zeros",
-    );
-  }
-  if (v[0] !== "0" && v[0] !== "1") {
-    return err(
-      "INVALID_COMPONENT",
-      "Belgian VAT number must start with 0 or 1",
-    );
-  }
-  const front = Number.parseInt(v.slice(0, 8), 10);
-  const check = Number.parseInt(v.slice(8, 10), 10);
-  if ((front + check) % 97 !== 0) {
-    return err(
-      "INVALID_CHECKSUM",
-      "Belgian VAT number check digit mismatch",
-    );
-  }
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => {
-  const v = compact(value);
-  return `BE${v}`;
-};
-
-/** Generate a random valid Belgian VAT number. */
-const generate = (): string => {
-  for (;;) {
-    const prefix = Math.random() < 0.5 ? "0" : "1";
-    const front = prefix + randomDigits(7);
-    const rem = Number.parseInt(front, 10) % 97;
-    const check = rem === 0 ? 97 : 97 - rem;
-    const c = front + String(check).padStart(2, "0");
-    if (validate(c).valid) return c;
-  }
-};
-
-/** Belgian VAT Number. */
-const vat: CountryValidator<"BE"> = {
-  name: "Belgian VAT Number",
-  localName: "BTW-identificatienummer",
-  abbreviation: "BTW",
-  aliases: [
-    "BTW",
-    "TVA",
-    "numéro d'entreprise",
-    "ondernemingsnummer",
-  ] as const,
-  candidatePattern: "BE0?\\d{9,10}",
-  scope: "country",
-  country: "BE",
-  entityType: "company",
-  sourceUrl: "https://finances.belgium.be/",
-  examples: ["0776091951"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default vat;
-export { compact, format, validate, generate };

package/src/bg/egn.ts

@@ -1,164 +0,0 @@
-/**
- * EGN (Единен граждански номер).
- *
- * Bulgarian personal identification number.
- * 10 digits encoding date of birth, serial number,
- * and a check digit.
- *
- * Canonical source:
- * - GRAO regulation PDF describing the EGN structure.
- *
- * We treat this as authoritative over third-party
- * oracle libraries when the checksum or date rules
- * disagree.
- *
- * @see https://www.grao.bg/normact/NaredbaFunkcESGR.pdf
- */
-
-import type {
-  ParsedPersonId,
-  ValidateResult,
-  CountryValidator,
-} from "../types";
-
-import { weightedSum } from "#checksums/weighted-sum";
-import { clean } from "#util/clean";
-import { isValidDate } from "#util/date";
-import { randomInt } from "#util/generate";
-import { err } from "#util/result";
-import { isdigits } from "#util/strings";
-
-const WEIGHTS = [2, 4, 8, 5, 10, 9, 7, 3, 6] as const;
-
-const compact = (value: string): string =>
-  clean(value, " -");
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 10) {
-    return err(
-      "INVALID_LENGTH",
-      "EGN must be exactly 10 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "EGN must contain only digits",
-    );
-  }
-
-  const yy = Number(v.slice(0, 2));
-  const mm = Number(v.slice(2, 4));
-  const dd = Number(v.slice(4, 6));
-
-  let year: number;
-  let month: number;
-  if (mm > 40) {
-    year = 2000 + yy;
-    month = mm - 40;
-  } else if (mm > 20) {
-    year = 1800 + yy;
-    month = mm - 20;
-  } else {
-    year = 1900 + yy;
-    month = mm;
-  }
-
-  if (!isValidDate(year, month, dd)) {
-    return err(
-      "INVALID_COMPONENT",
-      "EGN contains an invalid date",
-    );
-  }
-
-  const sum = weightedSum(v.slice(0, 9), WEIGHTS, 11);
-  const check = sum % 10;
-  if (check !== Number(v[9])) {
-    return err(
-      "INVALID_CHECKSUM",
-      "EGN check digit does not match",
-    );
-  }
-
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => compact(value);
-
-/**
- * Extract birth date and gender from an EGN.
- * Returns null if the value is not valid.
- */
-const parse = (value: string): ParsedPersonId | null => {
-  const result = validate(value);
-  if (!result.valid) return null;
-
-  const v = result.compact;
-  const yy = Number(v.slice(0, 2));
-  const mm = Number(v.slice(2, 4));
-  const dd = Number(v.slice(4, 6));
-  const serial = Number(v.slice(6, 9));
-
-  let year: number;
-  let month: number;
-  if (mm > 40) {
-    year = 2000 + yy;
-    month = mm - 40;
-  } else if (mm > 20) {
-    year = 1800 + yy;
-    month = mm - 20;
-  } else {
-    year = 1900 + yy;
-    month = mm;
-  }
-
-  return {
-    birthDate: new Date(year, month - 1, dd),
-    gender: serial % 2 === 0 ? "male" : "female",
-  };
-};
-
-/** Generate a random valid EGN. */
-const generate = (): string => {
-  for (;;) {
-    const yy = String(randomInt(0, 99)).padStart(2, "0");
-    const mm = String(randomInt(1, 12)).padStart(2, "0");
-    const dd = String(randomInt(1, 28)).padStart(2, "0");
-    const serial = String(randomInt(0, 999)).padStart(
-      3,
-      "0",
-    );
-    const payload = yy + mm + dd + serial;
-    const sum = weightedSum(payload, WEIGHTS, 11);
-    const c = payload + String(sum % 10);
-    if (validate(c).valid) return c;
-  }
-};
-
-/** Bulgarian Personal Identification Number. */
-const egn: CountryValidator<"BG", ParsedPersonId> = {
-  name: "Bulgarian Personal ID",
-  localName: "Единен граждански номер",
-  abbreviation: "ЕГН",
-  aliases: [
-    "ЕГН",
-    "единен граждански номер",
-    "EGN",
-  ] as const,
-  candidatePattern: "\\d{10}",
-  scope: "country",
-  country: "BG",
-  entityType: "person",
-  sourceUrl:
-    "https://www.grao.bg/normact/NaredbaFunkcESGR.pdf",
-  examples: ["7523169263"] as const,
-  compact,
-  format,
-  parse,
-  validate,
-  generate,
-};
-
-export default egn;
-export { compact, format, parse, validate, generate };

package/src/bg/mod.ts

@@ -1,3 +0,0 @@
-export { default as egn } from "./egn";
-export { default as pnf } from "./pnf";
-export { default as vat } from "./vat";

package/src/bg/pnf.ts

@@ -1,90 +0,0 @@
-/**
- * PNF (ЛНЧ, Личен номер на чужденец).
- *
- * Bulgarian personal number of a foreigner.
- * 10 digits; the last digit is a weighted checksum.
- *
- * @see https://en.wikipedia.org/wiki/Unique_citizenship_number
- */
-
-import type {
-  ValidateResult,
-  CountryValidator,
-} from "../types";
-
-import { clean } from "#util/clean";
-import { randomDigits } from "#util/generate";
-import { err } from "#util/result";
-import { isdigits } from "#util/strings";
-
-const WEIGHTS = [21, 19, 17, 13, 11, 9, 7, 3, 1] as const;
-
-const compact = (value: string): string =>
-  clean(value, " -.");
-
-const calcCheckDigit = (number: string): string => {
-  let sum = 0;
-  for (let i = 0; i < 9; i++) {
-    // SAFETY: WEIGHTS has exactly 9 entries
-    // eslint-disable-next-line no-non-null-assertion
-    sum += WEIGHTS[i]! * Number(number[i]);
-  }
-  return String(sum % 10);
-};
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 10) {
-    return err(
-      "INVALID_LENGTH",
-      "PNF must be exactly 10 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "PNF must contain only digits",
-    );
-  }
-  if (calcCheckDigit(v.slice(0, 9)) !== v[9]) {
-    return err(
-      "INVALID_CHECKSUM",
-      "PNF check digit does not match",
-    );
-  }
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => compact(value);
-
-/** Generate a random valid PNF. */
-const generate = (): string => {
-  const payload = randomDigits(9);
-  return payload + calcCheckDigit(payload);
-};
-
-/** Bulgarian Personal Number of a Foreigner. */
-const pnf: CountryValidator<"BG"> = {
-  name: "Bulgarian Foreigner Number",
-  localName: "Личен номер на чужденец",
-  abbreviation: "ЛНЧ",
-  aliases: [
-    "ЛНЧ",
-    "личен номер на чужденец",
-    "PNF",
-  ] as const,
-  candidatePattern: "\\d{10}",
-  scope: "country",
-  country: "BG",
-  entityType: "person",
-  sourceUrl:
-    "https://en.wikipedia.org/wiki/Unique_citizenship_number",
-  examples: ["7111042925"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default pnf;
-export { compact, format, validate, generate };

package/src/bg/vat.ts

@@ -1,160 +0,0 @@
-/**
- * ИН по ДДС (Bulgarian VAT number).
- *
- * 9 or 10 digits with weighted checksum.
- *
- * @see https://www.vatify.eu/bulgaria-vat-number.html
- * @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/bulgaria-tin.pdf
- */
-
-import type {
-  ValidateResult,
-  CountryValidator,
-} from "../types";
-
-import { weightedSum } from "#checksums/weighted-sum";
-import { clean } from "#util/clean";
-import { randomDigits } from "#util/generate";
-import { err } from "#util/result";
-import { isdigits } from "#util/strings";
-
-const compact = (value: string): string => {
-  let v = clean(value, " -/.");
-  if (v.startsWith("BG") || v.startsWith("bg")) {
-    v = v.slice(2);
-  }
-  return v;
-};
-
-const d = (v: string, i: number): number => Number(v[i]);
-
-const WEIGHTS_9_PASS1 = [1, 2, 3, 4, 5, 6, 7, 8];
-const WEIGHTS_9_PASS2 = [3, 4, 5, 6, 7, 8, 9, 10];
-const WEIGHTS_EGN = [2, 4, 8, 5, 10, 9, 7, 3, 6];
-const WEIGHTS_PNF = [21, 19, 17, 13, 11, 9, 7, 3, 1];
-const WEIGHTS_OTHER = [4, 3, 2, 7, 6, 5, 4, 3, 2];
-
-const validate9 = (v: string): boolean => {
-  let check = weightedSum(
-    v.slice(0, 8),
-    WEIGHTS_9_PASS1,
-    11,
-  );
-  if (check === 10) {
-    check = weightedSum(v.slice(0, 8), WEIGHTS_9_PASS2, 11);
-  }
-  return check % 10 === d(v, 8);
-};
-
-/**
- * Validate a 10-digit EGN (personal code).
- * First 6 digits encode birth date (YYMMDD with month
- * offsets: +20 for 1800s, +40 for 2000s). Check digit
- * uses weights [2,4,8,5,10,9,7,3,6], sum % 11 % 10.
- */
-const validateEgn = (v: string): boolean => {
-  const year = d(v, 0) * 10 + d(v, 1);
-  let month = d(v, 2) * 10 + d(v, 3);
-  const day = d(v, 4) * 10 + d(v, 5);
-  let fullYear = year + 1900;
-  if (month > 40) {
-    fullYear += 100;
-    month -= 40;
-  } else if (month > 20) {
-    fullYear -= 100;
-    month -= 20;
-  }
-  // Validate the birth date
-  const date = new Date(fullYear, month - 1, day);
-  if (
-    date.getFullYear() !== fullYear ||
-    date.getMonth() !== month - 1 ||
-    date.getDate() !== day
-  ) {
-    return false;
-  }
-  const sum = weightedSum(v.slice(0, 9), WEIGHTS_EGN, 11);
-  return sum % 10 === d(v, 9);
-};
-
-/**
- * Validate a 10-digit PNF (foreigner personal number).
- * Weights [21,19,17,13,11,9,7,3,1], sum % 10.
- */
-const validatePnf = (v: string): boolean => {
-  const sum = weightedSum(v.slice(0, 9), WEIGHTS_PNF, 10);
-  return sum === d(v, 9);
-};
-
-/**
- * Validate a 10-digit "other" VAT number.
- * Weights [4,3,2,7,6,5,4,3,2], (11 - sum%11) % 11.
- */
-const validateOther = (v: string): boolean => {
-  const sum = weightedSum(v.slice(0, 9), WEIGHTS_OTHER, 11);
-  return (11 - sum) % 11 === d(v, 9);
-};
-
-const validate10 = (v: string): boolean =>
-  validateEgn(v) || validatePnf(v) || validateOther(v);
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 9 && v.length !== 10) {
-    return err(
-      "INVALID_LENGTH",
-      "Bulgarian VAT number must be 9 or 10 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "Bulgarian VAT number must contain only digits",
-    );
-  }
-  const valid =
-    v.length === 9 ? validate9(v) : validate10(v);
-  if (!valid) {
-    return err(
-      "INVALID_CHECKSUM",
-      "Bulgarian VAT number check digit mismatch",
-    );
-  }
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string =>
-  `BG${compact(value)}`;
-
-/** Generate a random valid 9-digit Bulgarian VAT. */
-const generate = (): string => {
-  for (;;) {
-    const c = randomDigits(9);
-    if (validate(c).valid) return c;
-  }
-};
-
-/** Bulgarian VAT Number. */
-const vat: CountryValidator<"BG"> = {
-  name: "Bulgarian VAT Number",
-  localName: "ИН по ДДС",
-  abbreviation: "ИН по ДДС",
-  aliases: [
-    "ДДС",
-    "идентификационен номер по ДДС",
-  ] as const,
-  candidatePattern: "BG\\d{9,10}",
-  scope: "country",
-  country: "BG",
-  entityType: "any",
-  sourceUrl: "https://www.nra.bg/",
-  lengths: [9, 10] as const,
-  examples: ["175074752"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default vat;
-export { compact, format, validate, generate };