@stll/stdnum 2.1.1 → 2.1.3

package/src/de/svnr.ts

@@ -1,171 +0,0 @@
-/**
- * SVNR (Sozialversicherungsnummer).
- *
- * German social insurance number. 12 characters:
- * area number (2 digits) + date of birth (DDMMYY)
- * + initial letter of birth name (1 letter) +
- * serial number (2 digits) + check digit (1 digit).
- *
- * @see https://de.wikipedia.org/wiki/Sozialversicherungsnummer
- */
-
-import type {
-  ValidateResult,
-  CountryValidator,
-} from "../types";
-
-import { clean } from "#util/clean";
-import {
-  isValidDate,
-  resolveTwoDigitYear,
-} from "#util/date";
-import { randomInt } from "#util/generate";
-import { err } from "#util/result";
-
-const letterValue = (ch: string): number => {
-  const code = ch.charCodeAt(0);
-  if (code >= 65 && code <= 90) return code - 64;
-  return -1;
-};
-
-const WEIGHTS = [
-  2, 1, 2, 5, 7, 1, 2, 1, 2, 1, 2, 1,
-] as const;
-
-const compact = (value: string): string =>
-  clean(value, " -/").toUpperCase();
-
-const computeCheck = (v: string): number => {
-  const digits: number[] = [];
-
-  for (let i = 0; i < 8; i++) {
-    digits.push(Number(v[i]));
-  }
-
-  // SAFETY: caller guarantees v.length === 12.
-  // eslint-disable-next-line no-non-null-assertion
-  const lv = letterValue(v[8]!);
-  digits.push(Math.floor(lv / 10));
-  digits.push(lv % 10);
-
-  digits.push(Number(v[9]));
-  digits.push(Number(v[10]));
-
-  let sum = 0;
-  for (const [i, weight] of WEIGHTS.entries()) {
-    // SAFETY: WEIGHTS.length === 12 and we just pushed
-    // 12 entries onto `digits`.
-    // eslint-disable-next-line no-non-null-assertion
-    const product = digits[i]! * weight;
-    if (product >= 10) {
-      sum += Math.floor(product / 10) + (product % 10);
-    } else {
-      sum += product;
-    }
-  }
-
-  return sum % 10;
-};
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 12) {
-    return err(
-      "INVALID_LENGTH",
-      "German SVNR must be 12 characters",
-    );
-  }
-
-  if (!/^\d{8}[A-Z]\d{3}$/.test(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "German SVNR must be 8 digits, 1 letter, " +
-        "3 digits",
-    );
-  }
-
-  const dd = Number(v.slice(2, 4));
-  const mm = Number(v.slice(4, 6));
-  const yy = Number(v.slice(6, 8));
-
-  const year = resolveTwoDigitYear(yy);
-
-  if (!isValidDate(year, mm, dd)) {
-    return err(
-      "INVALID_COMPONENT",
-      "German SVNR contains an invalid birth date",
-    );
-  }
-
-  const expected = computeCheck(v);
-  const actual = Number(v[11]);
-
-  if (expected !== actual) {
-    return err(
-      "INVALID_CHECKSUM",
-      "German SVNR check digit mismatch",
-    );
-  }
-
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => {
-  const v = compact(value);
-  return (
-    `${v.slice(0, 2)} ${v.slice(2, 8)}` +
-    ` ${v.slice(8, 9)} ${v.slice(9, 11)}` +
-    ` ${v.slice(11)}`
-  );
-};
-
-/** Generate a random valid German SVNR. */
-const generate = (): string => {
-  for (;;) {
-    const area = String(randomInt(1, 99)).padStart(2, "0");
-    const dd = String(randomInt(1, 28)).padStart(2, "0");
-    const mm = String(randomInt(1, 12)).padStart(2, "0");
-    const yy = String(randomInt(40, 99)).padStart(2, "0");
-    const letter = String.fromCharCode(
-      65 + randomInt(0, 25),
-    );
-    const serial = String(randomInt(0, 49)).padStart(
-      2,
-      "0",
-    );
-    const partial = area + dd + mm + yy + letter + serial;
-    const c = partial + String(computeCheck(partial));
-    if (validate(c).valid) return c;
-  }
-};
-
-/** German Social Insurance Number. */
-const svnr: CountryValidator<"DE"> = {
-  name: "German Social Insurance Number",
-  localName: "Sozialversicherungsnummer",
-  abbreviation: "SVNR",
-  aliases: [
-    "Sozialversicherungsnummer",
-    "SVNR",
-    "Versicherungsnummer",
-  ] as const,
-  candidatePattern: "\\d{2}\\s?\\d{6}\\s?[A-Z]\\s?\\d{3}",
-  scope: "country",
-  country: "DE",
-  entityType: "person",
-  description:
-    "German social insurance number encoding " +
-    "birth date and name initial",
-  sourceUrl:
-    "https://de.wikipedia.org/wiki/" +
-    "Sozialversicherungsnummer",
-  lengths: [12] as const,
-  examples: ["12010188M011"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default svnr;
-export { compact, format, validate, generate };

package/src/de/vat.ts

@@ -1,102 +0,0 @@
-/**
- * USt-IdNr. (Umsatzsteuer-Identifikationsnummer).
- *
- * German VAT identification number. Format:
- * "DE" + 9 digits. The last digit is a check
- * digit computed using ISO 7064 Mod 11,10.
- *
- * @see https://www.bzst.de/DE/Unternehmen/Identifikationsnummern/Umsatzsteuer-Identifikationsnummer/umsatzsteuer-identifikationsnummer_node.html
- * @see https://www.bzst.de/SharedDocs/Downloads/DE/Merkblaetter/ust_idnr_aufbau.pdf
- */
-
-import type {
-  ValidateResult,
-  CountryValidator,
-} from "../types";
-
-import {
-  mod1110checkDigit,
-  mod1110validate,
-} from "#checksums/mod1110";
-import { clean } from "#util/clean";
-import { randomDigits, randomInt } from "#util/generate";
-import { err } from "#util/result";
-import { isdigits } from "#util/strings";
-
-const compact = (value: string): string => {
-  const v = clean(value, " -/");
-  if (v.startsWith("DE") || v.startsWith("de")) {
-    return v.slice(2);
-  }
-  return v;
-};
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 9) {
-    return err(
-      "INVALID_LENGTH",
-      "German VAT number must be 9 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "German VAT number must contain only digits",
-    );
-  }
-  if (v[0] === "0") {
-    return err(
-      "INVALID_COMPONENT",
-      "German VAT number cannot start with 0",
-    );
-  }
-  if (!mod1110validate(v)) {
-    return err(
-      "INVALID_CHECKSUM",
-      "German VAT number check digit mismatch",
-    );
-  }
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string =>
-  `DE${compact(value)}`;
-
-/** Generate a random valid German VAT number. */
-const generate = (): string => {
-  const first = String(randomInt(1, 9));
-  const rest = randomDigits(7);
-  const payload = `${first}${rest}`;
-  const check = mod1110checkDigit(payload);
-  return `${payload}${String(check)}`;
-};
-
-/** German VAT Identification Number. */
-const vat: CountryValidator<"DE"> = {
-  name: "German VAT Number",
-  localName: "Umsatzsteuer-Identifikationsnummer",
-  abbreviation: "USt-IdNr.",
-  aliases: [
-    "USt-IdNr",
-    "Umsatzsteuer-Identifikationsnummer",
-    "VAT DE",
-  ] as const,
-  candidatePattern: "DE\\d{9}",
-  scope: "country",
-  country: "DE",
-  entityType: "company",
-  description:
-    "German VAT ID issued by the Federal Tax Office (BZSt)",
-  sourceUrl:
-    "https://www.bzst.de/DE/Unternehmen/Identifikationsnummern/Umsatzsteuer-Identifikationsnummer/umsatzsteuer-identifikationsnummer_node.html",
-  lengths: [9] as const,
-  examples: ["136695976"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default vat;
-export { compact, format, generate, validate };

package/src/dk/cpr.ts

@@ -1,137 +0,0 @@
-/**
- * CPR (Det Centrale Personregister).
- *
- * Danish personal identification number. 10 digits
- * in format DDMMYY-SSSS. Checksum enforcement was
- * dropped in 2007; only date validation is performed.
- *
- * @see https://cpr.dk/
- */
-
-import type {
-  ParsedPersonId,
-  ValidateResult,
-  CountryValidator,
-} from "../types";
-
-import { clean } from "#util/clean";
-import { isValidDate } from "#util/date";
-import { randomDigits, randomInt } from "#util/generate";
-import { err } from "#util/result";
-import { isdigits } from "#util/strings";
-
-const compact = (value: string): string =>
-  clean(value, " -");
-
-const getCentury = (yy: number, s7: number): number => {
-  // 7th digit (first of serial) determines century
-  if (s7 >= 0 && s7 <= 3) return 1900;
-  if (s7 === 4 || s7 === 9) {
-    return yy <= 36 ? 2000 : 1900;
-  }
-  // s7 5..8
-  return yy <= 57 ? 2000 : 1800;
-};
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 10) {
-    return err(
-      "INVALID_LENGTH",
-      "CPR must be exactly 10 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "CPR must contain only digits",
-    );
-  }
-
-  const dd = Number(v.slice(0, 2));
-  const mm = Number(v.slice(2, 4));
-  const yy = Number(v.slice(4, 6));
-  const s7 = Number(v[6]);
-
-  const century = getCentury(yy, s7);
-  const year = century + yy;
-
-  if (!isValidDate(year, mm, dd)) {
-    return err(
-      "INVALID_COMPONENT",
-      "CPR contains an invalid date",
-    );
-  }
-
-  // Reject future birth dates
-  if (new Date(year, mm - 1, dd) > new Date()) {
-    return err(
-      "INVALID_COMPONENT",
-      "CPR birth date is in the future",
-    );
-  }
-
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => {
-  const v = compact(value);
-  return `${v.slice(0, 6)}-${v.slice(6)}`;
-};
-
-/**
- * Extract birth date and gender from a CPR number.
- * 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 dd = Number(v.slice(0, 2));
-  const mm = Number(v.slice(2, 4));
-  const yy = Number(v.slice(4, 6));
-  const s7 = Number(v[6]);
-  const lastDigit = Number(v[9]);
-
-  const century = getCentury(yy, s7);
-  const year = century + yy;
-
-  return {
-    birthDate: new Date(year, mm - 1, dd),
-    gender: lastDigit % 2 === 0 ? "female" : "male",
-  };
-};
-
-/** Generate a random valid Danish CPR. */
-const generate = (): string => {
-  const year = randomInt(1900, 2024);
-  const month = String(randomInt(1, 12)).padStart(2, "0");
-  const day = String(randomInt(1, 28)).padStart(2, "0");
-  const yy = String(year % 100).padStart(2, "0");
-  const serialPrefix = String(randomInt(0, 3));
-  return `${day}${month}${yy}${serialPrefix}${randomDigits(3)}`;
-};
-
-/** Danish Personal Identification Number. */
-const cpr: CountryValidator<"DK", ParsedPersonId> = {
-  name: "Danish Personal ID",
-  localName: "Det Centrale Personregister",
-  abbreviation: "CPR",
-  aliases: ["CPR-nummer", "personnummer", "CPR"] as const,
-  candidatePattern: "\\d{6}-?\\d{4}",
-  scope: "country",
-  country: "DK",
-  entityType: "person",
-  sourceUrl: "https://cpr.dk/",
-  lengths: [10] as const,
-  examples: ["2110625629"] as const,
-  compact,
-  format,
-  parse,
-  validate,
-  generate,
-};
-
-export default cpr;
-export { compact, format, generate, parse, validate };

package/src/dk/cvr.ts

@@ -1,91 +0,0 @@
-/**
- * CVR (Central Business Register number).
- *
- * 8 digits, no leading 0.
- * Weights [2,7,6,5,4,3,2,1], sum % 11 === 0.
- *
- * Same algorithm as the Danish VAT number, but this
- * is the company register identifier.
- *
- * @see https://erhvervsstyrelsen.dk/
- *
- * Denmark dropped mod-11 for CPR in 2007; unconfirmed
- * for CVR.
- */
-
-import type {
-  ValidateResult,
-  CountryValidator,
-} from "../types";
-
-import { weightedSum } from "#checksums/weighted-sum";
-import { clean } from "#util/clean";
-import { randomDigits, randomInt } from "#util/generate";
-import { err } from "#util/result";
-import { isdigits } from "#util/strings";
-
-const WEIGHTS = [2, 7, 6, 5, 4, 3, 2, 1];
-
-const compact = (value: string): string =>
-  clean(value, " -/.");
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 8) {
-    return err(
-      "INVALID_LENGTH",
-      "Danish CVR must be 8 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "Danish CVR must contain only digits",
-    );
-  }
-  if (v[0] === "0") {
-    return err(
-      "INVALID_COMPONENT",
-      "Danish CVR cannot start with 0",
-    );
-  }
-  const sum = weightedSum(v, WEIGHTS, 11);
-  if (sum !== 0) {
-    return err(
-      "INVALID_CHECKSUM",
-      "Danish CVR check digit mismatch",
-    );
-  }
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => compact(value);
-
-/** Generate a random valid Danish CVR. */
-const generate = (): string => {
-  for (;;) {
-    const c = String(randomInt(1, 9)) + randomDigits(7);
-    if (validate(c).valid) return c;
-  }
-};
-
-/** Danish Central Business Register Number. */
-const cvr: CountryValidator<"DK"> = {
-  name: "Danish Business Register Number",
-  localName: "CVR-nummer",
-  abbreviation: "CVR",
-  aliases: ["CVR-nummer", "CVR"] as const,
-  candidatePattern: "\\d{8}",
-  scope: "country",
-  country: "DK",
-  entityType: "company",
-  sourceUrl: "https://erhvervsstyrelsen.dk/",
-  examples: ["13585628"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default cvr;
-export { compact, format, validate, generate };

package/src/dk/mod.ts

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

package/src/dk/vat.ts

@@ -1,96 +0,0 @@
-/**
- * CVR (Danish VAT / business registration number).
- *
- * 8 digits, no leading 0.
- * Weights [2,7,6,5,4,3,2,1], sum % 11 === 0.
- *
- * @see https://www.vatify.eu/denmark-vat-number.html
- * @see https://erhvervsstyrelsen.dk/det-centrale-virksomhedsregister-cvr
- *
- * Denmark dropped mod-11 for CPR in 2007; unconfirmed
- * for CVR.
- */
-
-import type {
-  ValidateResult,
-  CountryValidator,
-} from "../types";
-
-import { weightedSum } from "#checksums/weighted-sum";
-import { clean } from "#util/clean";
-import { randomDigits, randomInt } from "#util/generate";
-import { err } from "#util/result";
-import { isdigits } from "#util/strings";
-
-const WEIGHTS = [2, 7, 6, 5, 4, 3, 2, 1];
-
-const compact = (value: string): string => {
-  let v = clean(value, " -/.");
-  if (v.startsWith("DK") || v.startsWith("dk")) {
-    v = v.slice(2);
-  }
-  return v;
-};
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 8) {
-    return err(
-      "INVALID_LENGTH",
-      "Danish VAT number must be 8 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "Danish VAT number must contain only digits",
-    );
-  }
-  if (v[0] === "0") {
-    return err(
-      "INVALID_COMPONENT",
-      "Danish VAT number cannot start with 0",
-    );
-  }
-  const sum = weightedSum(v, WEIGHTS, 11);
-  if (sum !== 0) {
-    return err(
-      "INVALID_CHECKSUM",
-      "Danish VAT number check digit mismatch",
-    );
-  }
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string =>
-  `DK${compact(value)}`;
-
-/** Generate a random valid Danish VAT number. */
-const generate = (): string => {
-  for (;;) {
-    const c = String(randomInt(1, 9)) + randomDigits(7);
-    if (validate(c).valid) return c;
-  }
-};
-
-/** Danish VAT Number. */
-const vat: CountryValidator<"DK"> = {
-  name: "Danish VAT Number",
-  localName: "Momsregistreringsnummer",
-  abbreviation: "CVR",
-  aliases: ["momsnummer", "SE-nummer"] as const,
-  candidatePattern: "DK\\d{8}",
-  scope: "country",
-  country: "DK",
-  entityType: "company",
-  sourceUrl: "https://erhvervsstyrelsen.dk/",
-  lengths: [8] as const,
-  examples: ["13585628"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default vat;
-export { compact, format, validate, generate };

package/src/do/mod.ts

@@ -1 +0,0 @@
-export { default as rnc } from "./rnc";