@stll/stdnum 2.1.0 → 2.1.2

package/src/ar/dni.ts

@@ -1,83 +0,0 @@
-/** Generate a random valid Argentine DNI. */
-const generate = (): string => randomDigits(8);
-
-/**
- * DNI (Documento Nacional de Identidad).
- *
- * Argentine national identity card number. The DNI is
- * a 7 or 8-digit number assigned to all Argentine
- * citizens and permanent residents. No check digit.
- *
- * @see https://en.wikipedia.org/wiki/Documento_Nacional_de_Identidad_(Argentina)
- */
-
-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 =>
-  clean(value, " -.").trim();
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-
-  if (v.length < 7 || v.length > 8) {
-    return err(
-      "INVALID_LENGTH",
-      "DNI must be 7 or 8 digits",
-    );
-  }
-
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "DNI must contain only digits",
-    );
-  }
-
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => {
-  const v = compact(value);
-  if (v.length === 8) {
-    return `${v.slice(0, 2)}.${v.slice(2, 5)}.${v.slice(5)}`;
-  }
-  if (v.length === 7) {
-    return `${v.slice(0, 1)}.${v.slice(1, 4)}.${v.slice(4)}`;
-  }
-  return v;
-};
-
-/** Argentine National Identity Document. */
-const dni: CountryValidator<"AR"> = {
-  name: "Argentine Identity Card",
-  localName: "Documento Nacional de Identidad",
-  abbreviation: "DNI",
-  aliases: [
-    "DNI",
-    "Documento Nacional de Identidad",
-    "Documento de Identidad",
-  ] as const,
-  candidatePattern: "\\d{1,2}\\.?\\d{3}\\.?\\d{3}",
-  scope: "country",
-  country: "AR",
-  entityType: "person",
-  sourceUrl:
-    "https://en.wikipedia.org/wiki/Documento_Nacional_de_Identidad_(Argentina)",
-  lengths: [7, 8] as const,
-  examples: ["20123456", "12345678"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default dni;
-export { compact, format, validate, generate };

package/src/ar/mod.ts

@@ -1,3 +0,0 @@
-export { default as cbu } from "./cbu";
-export { default as cuit } from "./cuit";
-export { default as dni } from "./dni";

package/src/at/businessid.ts

@@ -1,78 +0,0 @@
-/** Generate a random valid Austrian Firmenbuchnummer. */
-const generate = (): string => {
-  const digits = randomDigits(randomInt(5, 6));
-  const letter = String.fromCodePoint(
-    97 + randomInt(0, 25),
-  ); // a-z (compact lowercases)
-  return `${digits}${letter}`;
-};
-
-/**
- * Firmenbuchnummer (Austrian company register number).
- *
- * Digits followed by a single trailing letter.
- * Optional "FN" prefix. No checksum.
- *
- * @see https://www.justiz.gv.at/
- */
-
-import type {
-  ValidateResult,
-  CountryValidator,
-} from "../types";
-
-import { clean } from "#util/clean";
-import { randomDigits, randomInt } from "#util/generate";
-import { err } from "#util/result";
-
-const FN_RE = /^\d+[a-z]$/i;
-
-const compact = (value: string): string => {
-  let v = clean(value, " -/.");
-  if (v.slice(0, 2).toUpperCase() === "FN") {
-    v = v.slice(2);
-  }
-  return v.toLowerCase();
-};
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length < 2) {
-    return err(
-      "INVALID_LENGTH",
-      "Austrian Firmenbuchnummer is too short",
-    );
-  }
-  if (!FN_RE.test(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "Austrian Firmenbuchnummer must be digits" +
-        " followed by a letter",
-    );
-  }
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string =>
-  `FN ${compact(value)}`;
-
-/** Austrian Company Register Number. */
-const businessid: CountryValidator<"AT"> = {
-  name: "Austrian Company Register Number",
-  localName: "Firmenbuchnummer",
-  abbreviation: "FN",
-  aliases: ["Firmenbuchnummer", "FN", "FBN"] as const,
-  candidatePattern: "FN\\s?\\d{5,6}[a-z]?",
-  scope: "country",
-  country: "AT",
-  entityType: "company",
-  sourceUrl: "https://www.justiz.gv.at/",
-  examples: ["122119m"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default businessid;
-export { compact, format, validate, generate };

package/src/at/mod.ts

@@ -1,4 +0,0 @@
-export { default as businessid } from "./businessid";
-export { default as tin } from "./tin";
-export { default as uid } from "./uid";
-export { default as vnr } from "./vnr";

package/src/at/tin.ts

@@ -1,94 +0,0 @@
-/**
- * TIN (Abgabenkontonummer).
- *
- * Austrian tax identification number. 9 digits:
- * 2-digit tax office code (Finanzamtsnummer) +
- * 6-digit subject number + 1 check digit.
- * Uses a variant of the Luhn algorithm.
- *
- * @see https://de.wikipedia.org/wiki/Abgabenkontonummer
- * @see https://service.bmf.gv.at/Service/Anwend/Behoerden/show_mast.asp
- */
-
-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";
-
-/** Luhn-variant doubling table: position-dependent. */
-const DOUBLE = "0246813579";
-
-const compact = (value: string): string =>
-  clean(value, " -./,");
-
-const calcCheckDigit = (number: string): string => {
-  let sum = 0;
-  for (let i = 0; i < 8; i++) {
-    const d = Number(number[i]);
-    // Even positions (0-indexed) add digit as-is;
-    // odd positions use the doubling table
-    sum += i % 2 === 0 ? d : Number(DOUBLE[d]);
-  }
-  return String((10 - (sum % 10)) % 10);
-};
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 9) {
-    return err(
-      "INVALID_LENGTH",
-      "Austrian TIN must be exactly 9 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "Austrian TIN must contain only digits",
-    );
-  }
-  if (calcCheckDigit(v) !== v[8]) {
-    return err(
-      "INVALID_CHECKSUM",
-      "Austrian TIN 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)}`;
-};
-
-/** Generate a random valid Austrian TIN. */
-const generate = (): string => {
-  const payload = randomDigits(8);
-  return payload + calcCheckDigit(payload);
-};
-
-/** Austrian Tax Identification Number. */
-const tin: CountryValidator<"AT"> = {
-  name: "Austrian Tax Identification Number",
-  localName: "Abgabenkontonummer",
-  abbreviation: "TIN",
-  aliases: ["Steuernummer", "St.Nr.", "TIN"] as const,
-  candidatePattern: "\\d{2}-?\\d{3}/\\d{4}",
-  scope: "country",
-  country: "AT",
-  entityType: "any",
-  sourceUrl:
-    "https://de.wikipedia.org/wiki/Abgabenkontonummer",
-  examples: ["591199013"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default tin;
-export { compact, format, validate, generate };

package/src/at/uid.ts

@@ -1,96 +0,0 @@
-/**
- * UID (Umsatzsteuer-Identifikationsnummer).
- *
- * Austrian VAT identification number. Format:
- * "U" + 7 digits + 1 check digit. Uses a
- * modified Luhn algorithm.
- *
- * @see https://www.bmf.gv.at/
- */
-
-import type {
-  ValidateResult,
-  CountryValidator,
-} from "../types";
-
-import { luhnChecksum } from "#checksums/luhn";
-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("AT") || v.startsWith("at")) {
-    v = v.slice(2);
-  }
-  return v.toUpperCase();
-};
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 9) {
-    return err(
-      "INVALID_LENGTH",
-      "Austrian UID must be U + 8 digits",
-    );
-  }
-  if (v[0] !== "U") {
-    return err(
-      "INVALID_COMPONENT",
-      "Austrian UID must start with U",
-    );
-  }
-  const digits = v.slice(1);
-  if (!isdigits(digits)) {
-    return err(
-      "INVALID_FORMAT",
-      "Austrian UID must be U + 8 digits",
-    );
-  }
-  const cs = luhnChecksum(digits.slice(0, 7));
-  const check = (((6 - cs) % 10) + 10) % 10;
-  if (check < 0 || check !== Number(digits[7])) {
-    return err(
-      "INVALID_CHECKSUM",
-      "Austrian UID check digit mismatch",
-    );
-  }
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string =>
-  `AT${compact(value)}`;
-
-/** Generate a random valid Austrian UID. */
-const generate = (): string => {
-  const payload = randomDigits(7);
-  const cs = luhnChecksum(payload);
-  const check = (((6 - cs) % 10) + 10) % 10;
-  return "U" + payload + String(check);
-};
-
-/** Austrian VAT Identification Number. */
-const uid: CountryValidator<"AT"> = {
-  name: "Austrian VAT Number",
-  localName: "Umsatzsteuer-Identifikationsnummer",
-  abbreviation: "UID",
-  aliases: [
-    "UID",
-    "Umsatzsteuer-Identifikationsnummer",
-    "ATU",
-  ] as const,
-  candidatePattern: "ATU\\d{8}",
-  scope: "country",
-  country: "AT",
-  entityType: "company",
-  sourceUrl: "https://www.bmf.gv.at/",
-  examples: ["U13585627"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default uid;
-export { compact, format, validate, generate };

package/src/at/vnr.ts

@@ -1,161 +0,0 @@
-/**
- * VNR (Versicherungsnummer).
- *
- * Austrian social insurance number. 10 digits: 3-digit
- * serial + 1 check digit + 6-digit birth date (DDMMYY).
- * The check digit is computed using a weighted sum
- * mod 11 over the 9 non-check digits.
- *
- * The 6-digit "birth date" field is not always a real
- * calendar date. Sozialversicherung.at documents that
- * persons with unknown date of birth are issued
- * substitute values (01.01. or 01.07.), and that
- * months 13, 14, etc. are issued when the daily serial
- * pool for a given substitute date is exhausted. We
- * therefore do not enforce a calendar-valid month here.
- * The day field, however, is always within 01-31 — even
- * in the documented overflow cases the day stays "01"
- * — so we keep the day-bounds check.
- *
- * @see https://de.wikipedia.org/wiki/Sozialversicherungsnummer#%C3%96sterreich
- * @see https://www.sozialversicherung.at/cdscontent/?contentid=10007.820902&viewmode=content
- */
-
-import type {
-  ValidateResult,
-  CountryValidator,
-} from "../types";
-
-import { clean } from "#util/clean";
-import { randomDigits, randomInt } from "#util/generate";
-import { err } from "#util/result";
-import { isdigits } from "#util/strings";
-
-/**
- * Weights for the 9 non-check digits (positions
- * 0,1,2, then 4,5,6,7,8,9). Check digit is at
- * position 3 and equals the weighted sum mod 11.
- */
-const WEIGHTS = [3, 7, 9, 5, 8, 4, 2, 1, 6] as const;
-
-const compact = (value: string): string =>
-  clean(value, " -/").trim();
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-
-  if (v.length !== 10) {
-    return err(
-      "INVALID_LENGTH",
-      "Austrian VNR must be 10 digits",
-    );
-  }
-
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "Austrian VNR must contain only digits",
-    );
-  }
-
-  // Per sozialversicherung.at, the 3-digit serial
-  // (positions 0-2) never starts with zero.
-  if (v[0] === "0") {
-    return err(
-      "INVALID_COMPONENT",
-      "Austrian VNR serial must not start with zero",
-    );
-  }
-
-  // Day (positions 4-5) is always within 01-31, even
-  // in the documented substitute and overflow cases
-  // where the month is shifted. The month is left
-  // unchecked per the source.
-  const day = Number(v.slice(4, 6));
-  if (day < 1 || day > 31) {
-    return err(
-      "INVALID_COMPONENT",
-      "Austrian VNR day field must be within 01-31",
-    );
-  }
-
-  // Check digit at position 3: weighted sum of the
-  // other 9 digits mod 11. If remainder is 10 the
-  // number is invalid.
-  const digits = v.slice(0, 3) + v.slice(4);
-  let sum = 0;
-  for (const [i, weight] of WEIGHTS.entries()) {
-    sum += Number(digits[i]) * weight;
-  }
-  const check = sum % 11;
-  if (check === 10) {
-    return err(
-      "INVALID_CHECKSUM",
-      "Austrian VNR check digit is invalid (mod 11 " +
-        "remainder is 10)",
-    );
-  }
-  if (check !== Number(v[3])) {
-    return err(
-      "INVALID_CHECKSUM",
-      "Austrian VNR check digit mismatch",
-    );
-  }
-
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => {
-  const v = compact(value);
-  return `${v.slice(0, 4)} ${v.slice(4, 6)}${v.slice(6, 8)}${v.slice(8)}`;
-};
-
-/** Generate a random valid Austrian VNR. */
-const generate = (): string => {
-  for (;;) {
-    // Serial must not start with zero (see validate).
-    const serial =
-      String(randomInt(1, 9)) + randomDigits(2);
-    const day = String(randomInt(1, 28)).padStart(2, "0");
-    const month = String(randomInt(1, 12)).padStart(2, "0");
-    const year = String(randomInt(0, 99)).padStart(2, "0");
-    const digits = `${serial}${day}${month}${year}`;
-
-    let sum = 0;
-    for (const [i, weight] of WEIGHTS.entries()) {
-      sum += Number(digits[i]) * weight;
-    }
-
-    const check = sum % 11;
-    if (check === 10) continue;
-    return `${serial}${String(check)}${day}${month}${year}`;
-  }
-};
-
-/** Austrian Social Insurance Number. */
-const vnr: CountryValidator<"AT"> = {
-  name: "Austrian Social Insurance Number",
-  localName: "Versicherungsnummer",
-  abbreviation: "VNR",
-  aliases: [
-    "VNR",
-    "SVNR",
-    "Versicherungsnummer",
-    "Sozialversicherungsnummer",
-  ] as const,
-  candidatePattern: "\\d{4}\\s?\\d{6}",
-  scope: "country",
-  country: "AT",
-  entityType: "person",
-  sourceUrl:
-    "https://de.wikipedia.org/wiki/Sozialversicherungsnummer",
-  lengths: [10] as const,
-  examples: ["1237010180"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default vnr;
-export { compact, format, generate, validate };

package/src/au/abn.ts

@@ -1,89 +0,0 @@
-/**
- * ABN (Australian Business Number).
- *
- * 11-digit identifier. Subtract 1 from the first
- * digit, then apply weights [10,1,3,5,7,9,11,13,
- * 15,17,19]; sum mod 89 must equal 0.
- *
- * @see https://en.wikipedia.org/wiki/Australian_Business_Number
- * @see https://abr.business.gov.au/
- */
-
-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 = [
-  10, 1, 3, 5, 7, 9, 11, 13, 15, 17, 19,
-] as const;
-
-const compact = (value: string): string =>
-  clean(value, " -");
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "ABN must contain only digits",
-    );
-  }
-  if (v.length !== 11) {
-    return err("INVALID_LENGTH", "ABN must be 11 digits");
-  }
-
-  let sum = 0;
-  for (let i = 0; i < 11; i++) {
-    let d = Number(v.charAt(i));
-    if (i === 0) d -= 1;
-    sum += d * (WEIGHTS[i] ?? 0);
-  }
-  if (sum % 89 !== 0) {
-    return err("INVALID_CHECKSUM", "ABN checksum mismatch");
-  }
-
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => {
-  const v = compact(value);
-  if (v.length === 11) {
-    return `${v.slice(0, 2)} ${v.slice(2, 5)} ${v.slice(5, 8)} ${v.slice(8)}`;
-  }
-  return v;
-};
-
-/** Generate a random valid ABN. */
-const generate = (): string => {
-  for (;;) {
-    const c = randomDigits(11);
-    if (validate(c).valid) return c;
-  }
-};
-
-/** Australian Business Number. */
-const abn: CountryValidator<"AU"> = {
-  name: "Australian Business Number",
-  localName: "Australian Business Number",
-  abbreviation: "ABN",
-  aliases: ["ABN", "Australian Business Number"] as const,
-  candidatePattern: "\\d{2}\\s?\\d{3}\\s?\\d{3}\\s?\\d{3}",
-  scope: "country",
-  country: "AU",
-  entityType: "company",
-  sourceUrl: "https://abr.business.gov.au/",
-  examples: ["83914571673", "51824753556"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default abn;
-export { compact, format, validate, generate };

package/src/au/acn.ts

@@ -1,90 +0,0 @@
-/**
- * ACN (Australian Company Number).
- *
- * 9-digit identifier. Weights [8,7,6,5,4,3,2,1]
- * applied to the first 8 digits; check digit is
- * (10 - sum % 10) % 10.
- *
- * @see https://en.wikipedia.org/wiki/Australian_Company_Number
- * @see https://asic.gov.au/
- */
-
-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 = [8, 7, 6, 5, 4, 3, 2, 1] as const;
-
-const compact = (value: string): string =>
-  clean(value, " -");
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "ACN must contain only digits",
-    );
-  }
-  if (v.length !== 9) {
-    return err("INVALID_LENGTH", "ACN must be 9 digits");
-  }
-
-  let sum = 0;
-  for (let i = 0; i < 8; i++) {
-    sum += Number(v.charAt(i)) * (WEIGHTS[i] ?? 0);
-  }
-  const check = (10 - (sum % 10)) % 10;
-  if (check !== Number(v.charAt(8))) {
-    return err(
-      "INVALID_CHECKSUM",
-      "ACN check digit mismatch",
-    );
-  }
-
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => {
-  const v = compact(value);
-  if (v.length === 9) {
-    return `${v.slice(0, 3)} ${v.slice(3, 6)} ${v.slice(6)}`;
-  }
-  return v;
-};
-
-/** Generate a random valid ACN. */
-const generate = (): string => {
-  const payload = randomDigits(8);
-  let sum = 0;
-  for (let i = 0; i < 8; i++)
-    sum += Number(payload.charAt(i)) * (WEIGHTS[i] ?? 0);
-  return payload + String((10 - (sum % 10)) % 10);
-};
-
-/** Australian Company Number. */
-const acn: CountryValidator<"AU"> = {
-  name: "Australian Company Number",
-  localName: "Australian Company Number",
-  abbreviation: "ACN",
-  aliases: ["ACN", "Australian Company Number"] as const,
-  candidatePattern: "\\d{3}\\s?\\d{3}\\s?\\d{3}",
-  scope: "country",
-  country: "AU",
-  entityType: "company",
-  sourceUrl: "https://asic.gov.au/",
-  examples: ["004085616", "010499966"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default acn;
-export { compact, format, validate, generate };

package/src/au/mod.ts

@@ -1,3 +0,0 @@
-export { default as abn } from "./abn";
-export { default as acn } from "./acn";
-export { default as tfn } from "./tfn";