@stll/stdnum 2.1.1 → 2.1.3

package/src/fi/ytunnus.ts

@@ -1,87 +0,0 @@
-/**
- * Y-tunnus (Finnish Business ID).
- *
- * 8 digits. Weights [7,9,10,5,8,4,2,1],
- * sum % 11 === 0. Same algorithm as FI VAT.
- * Display format: NNNNNNN-C.
- *
- * @see https://www.ytj.fi/en/index/businessid.html
- */
-
-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 WEIGHTS = [7, 9, 10, 5, 8, 4, 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",
-      "Finnish Y-tunnus must be 8 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "Finnish Y-tunnus must contain only digits",
-    );
-  }
-  const sum = weightedSum(v, WEIGHTS, 11);
-  if (sum !== 0) {
-    return err(
-      "INVALID_CHECKSUM",
-      "Finnish Y-tunnus check digit mismatch",
-    );
-  }
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => {
-  const v = compact(value);
-  return `${v.slice(0, 7)}-${v[7]}`;
-};
-
-/** Generate a random valid Finnish Y-tunnus. */
-const generate = (): string => {
-  for (;;) {
-    const c = randomDigits(8);
-    if (validate(c).valid) return c;
-  }
-};
-
-/** Finnish Business ID. */
-const ytunnus: CountryValidator<"FI"> = {
-  name: "Finnish Business ID",
-  localName: "Y-tunnus",
-  abbreviation: "Y-tunnus",
-  aliases: [
-    "Y-tunnus",
-    "yritystunnus",
-    "FO-nummer",
-  ] as const,
-  candidatePattern: "\\d{7}-\\d",
-  scope: "country",
-  country: "FI",
-  entityType: "company",
-  sourceUrl: "https://www.ytj.fi/en/index/businessid.html",
-  examples: ["20774740"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default ytunnus;
-export { compact, format, validate, generate };

package/src/fr/mod.ts

@@ -1,5 +0,0 @@
-export { default as nif } from "./nif";
-export { default as nir } from "./nir";
-export { default as siren } from "./siren";
-export { default as siret } from "./siret";
-export { default as tva } from "./tva";

package/src/fr/nif.ts

@@ -1,97 +0,0 @@
-/**
- * NIF (Numéro d'Identification Fiscale).
- *
- * French tax identification number. 13 digits;
- * first digit is 0-3. Last 3 digits are a
- * check: first_10_digits % 511 == last_3.
- *
- * @see https://www.impots.gouv.fr/
- */
-
-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";
-
-const compact = (value: string): string =>
-  clean(value, " -");
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 13) {
-    return err(
-      "INVALID_LENGTH",
-      "French NIF must be exactly 13 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "French NIF must contain only digits",
-    );
-  }
-  const first = v[0];
-  if (
-    first !== "0" &&
-    first !== "1" &&
-    first !== "2" &&
-    first !== "3"
-  ) {
-    return err(
-      "INVALID_COMPONENT",
-      "French NIF must start with 0-3",
-    );
-  }
-  const front = Number(v.slice(0, 10));
-  const check = Number(v.slice(10));
-  if (front % 511 !== check) {
-    return err(
-      "INVALID_CHECKSUM",
-      "French NIF check digits mismatch",
-    );
-  }
-  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, 7)} ${v.slice(7, 10)} ${v.slice(10)}`;
-};
-
-/** Generate a random valid French NIF. */
-const generate = (): string => {
-  for (;;) {
-    const c = String(randomInt(0, 3)) + randomDigits(12);
-    if (validate(c).valid) return c;
-  }
-};
-
-/** French Tax Identification Number. */
-const nif: CountryValidator<"FR"> = {
-  name: "French Tax ID",
-  localName: "Numéro d'Identification Fiscale",
-  abbreviation: "NIF",
-  aliases: [
-    "numéro fiscal",
-    "NIF",
-    "numéro d'identification fiscale",
-  ] as const,
-  candidatePattern: "\\d{13}",
-  scope: "country",
-  country: "FR",
-  entityType: "person",
-  sourceUrl: "https://www.impots.gouv.fr/",
-  examples: ["3023217600053"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default nif;
-export { compact, format, validate, generate };

package/src/fr/nir.ts

@@ -1,197 +0,0 @@
-/**
- * NIR (Numero d'Inscription au Repertoire).
- *
- * French social security number (numero de securite
- * sociale). 15 digits: 13 identity digits + 2 check
- * digits. Encodes gender, year/month of birth, and
- * department of birth.
- *
- * Corsican departments 2A/2B are encoded as 19/18
- * for the mod-97 checksum computation.
- *
- * @see https://en.wikipedia.org/wiki/INSEE_code
- */
-
-import type {
-  ParsedPersonId,
-  ValidateResult,
-  CountryValidator,
-} from "../types";
-
-import { clean } from "#util/clean";
-import { resolveTwoDigitYear } from "#util/date";
-import { randomInt } from "#util/generate";
-import { err } from "#util/result";
-
-const compact = (value: string): string =>
-  clean(value, " -.");
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value).toUpperCase();
-  if (v.length !== 15) {
-    return err(
-      "INVALID_LENGTH",
-      "French NIR must be 15 characters",
-    );
-  }
-
-  const gender = v[0];
-  if (gender !== "1" && gender !== "2") {
-    return err(
-      "INVALID_COMPONENT",
-      "French NIR first digit must be 1 or 2",
-    );
-  }
-
-  const yearPart = v.slice(1, 3);
-  if (!/^\d{2}$/.test(yearPart)) {
-    return err(
-      "INVALID_FORMAT",
-      "French NIR year must be 2 digits",
-    );
-  }
-
-  const monthPart = v.slice(3, 5);
-  if (!/^\d{2}$/.test(monthPart) || monthPart === "00") {
-    return err(
-      "INVALID_FORMAT",
-      "French NIR month must be 01-99",
-    );
-  }
-
-  const deptPart = v.slice(5, 7);
-  const isCorsica = deptPart === "2A" || deptPart === "2B";
-  if (!isCorsica && !/^\d{2}$/.test(deptPart)) {
-    return err(
-      "INVALID_FORMAT",
-      "French NIR department must be 2 digits or 2A/2B",
-    );
-  }
-
-  const communePart = v.slice(7, 10);
-  if (!/^\d{3}$/.test(communePart)) {
-    return err(
-      "INVALID_FORMAT",
-      "French NIR commune must be 3 digits",
-    );
-  }
-
-  const serialPart = v.slice(10, 13);
-  if (!/^\d{3}$/.test(serialPart)) {
-    return err(
-      "INVALID_FORMAT",
-      "French NIR serial must be 3 digits",
-    );
-  }
-
-  const checkPart = v.slice(13, 15);
-  if (!/^\d{2}$/.test(checkPart)) {
-    return err(
-      "INVALID_FORMAT",
-      "French NIR check must be 2 digits",
-    );
-  }
-
-  let numericBase: string;
-  if (deptPart === "2A") {
-    numericBase = v.slice(0, 5) + "19" + v.slice(7, 13);
-  } else if (deptPart === "2B") {
-    numericBase = v.slice(0, 5) + "18" + v.slice(7, 13);
-  } else {
-    numericBase = v.slice(0, 13);
-  }
-
-  const base = BigInt(numericBase);
-  const expected = 97n - (base % 97n);
-  const actual = BigInt(checkPart);
-
-  if (expected !== actual) {
-    return err(
-      "INVALID_CHECKSUM",
-      "French NIR check digits mismatch",
-    );
-  }
-
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => {
-  const v = compact(value).toUpperCase();
-  return (
-    `${v.slice(0, 1)} ${v.slice(1, 3)}` +
-    ` ${v.slice(3, 5)} ${v.slice(5, 7)}` +
-    ` ${v.slice(7, 10)} ${v.slice(10, 13)}` +
-    ` ${v.slice(13)}`
-  );
-};
-
-const parse = (value: string): ParsedPersonId | null => {
-  const result = validate(value);
-  if (!result.valid) return null;
-
-  const v = result.compact;
-  const genderDigit = v[0];
-  const yy = Number(v.slice(1, 3));
-  const mm = Number(v.slice(3, 5));
-
-  if (mm < 1 || mm > 12) return null;
-
-  const year = resolveTwoDigitYear(yy);
-  const gender = genderDigit === "1" ? "male" : "female";
-
-  return {
-    birthDate: new Date(year, mm - 1, 1),
-    gender,
-  };
-};
-
-/** Generate a random valid French NIR. */
-const generate = (): string => {
-  for (;;) {
-    const g = String(randomInt(1, 2));
-    const yy = String(randomInt(50, 99)).padStart(2, "0");
-    const mm = String(randomInt(1, 12)).padStart(2, "0");
-    const dept = String(randomInt(1, 95)).padStart(2, "0");
-    const com = String(randomInt(1, 999)).padStart(3, "0");
-    const s = String(randomInt(1, 999)).padStart(3, "0");
-    const base = g + yy + mm + dept + com + s;
-    const check = String(97 - (Number(base) % 97)).padStart(
-      2,
-      "0",
-    );
-    const c = base + check;
-    if (validate(c).valid) return c;
-  }
-};
-
-/** French Social Security Number. */
-const nir: CountryValidator<"FR", ParsedPersonId> = {
-  name: "French Social Security Number",
-  localName: "Numero d'Inscription au Repertoire",
-  abbreviation: "NIR",
-  aliases: [
-    "NIR",
-    "numéro de sécurité sociale",
-    "numéro SS",
-    "sécu",
-  ] as const,
-  candidatePattern:
-    "[12]\\s?\\d{2}\\s?\\d{2}\\s?\\d{2}\\s?\\d{3}\\s?\\d{3}\\s?\\d{2}",
-  scope: "country",
-  country: "FR",
-  entityType: "person",
-  description:
-    "French social security number encoding " +
-    "gender, birth date, and department",
-  sourceUrl: "https://en.wikipedia.org/wiki/INSEE_code",
-  lengths: [15] as const,
-  examples: ["295117823456784"] as const,
-  compact,
-  format,
-  parse,
-  validate,
-  generate,
-};
-
-export default nir;
-export { compact, format, parse, validate, generate };

package/src/fr/siren.ts

@@ -1,83 +0,0 @@
-/**
- * SIREN (Système d'Identification du Répertoire
- * des Entreprises).
- *
- * French company identification number. 9 digits
- * validated with standard Luhn algorithm.
- *
- * @see https://www.insee.fr/fr/information/2549588
- */
-
-import type {
-  ValidateResult,
-  CountryValidator,
-} from "../types";
-
-import {
-  luhnValidate,
-  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 =>
-  clean(value, " -.");
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 9) {
-    return err(
-      "INVALID_LENGTH",
-      "SIREN must be exactly 9 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "SIREN must contain only digits",
-    );
-  }
-  if (!luhnValidate(v)) {
-    return err(
-      "INVALID_CHECKSUM",
-      "SIREN fails Luhn check",
-    );
-  }
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => {
-  const v = compact(value);
-  return `${v.slice(0, 3)} ${v.slice(3, 6)} ${v.slice(6)}`;
-};
-
-/** Generate a random valid French SIREN. */
-const generate = (): string => {
-  const payload = randomDigits(8);
-  const cs = luhnChecksum(payload + "0");
-  return payload + String((10 - cs) % 10);
-};
-
-/** French Company Identification Number. */
-const siren: CountryValidator<"FR"> = {
-  name: "French Company ID",
-  localName:
-    "Système d'Identification du Répertoire des Entreprises",
-  abbreviation: "SIREN",
-  aliases: ["SIREN", "numéro SIREN"] as const,
-  candidatePattern: "\\d{3}\\s?\\d{3}\\s?\\d{3}",
-  scope: "country",
-  country: "FR",
-  entityType: "company",
-  sourceUrl: "https://www.insee.fr/fr/information/2549588",
-  examples: ["552008443"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default siren;
-export { compact, format, validate, generate };

package/src/fr/siret.ts

@@ -1,126 +0,0 @@
-/**
- * SIRET (Système d'Identification du Répertoire
- * des Établissements).
- *
- * French establishment identification number.
- * 14 digits: SIREN (9) + NIC (5). Validated
- * with Luhn, with a special case for La Poste.
- *
- * @see https://www.insee.fr/fr/information/2549588
- */
-
-import type {
-  ValidateResult,
-  CountryValidator,
-} from "../types";
-
-import {
-  luhnValidate,
-  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 =>
-  clean(value, " -.");
-
-/**
- * La Poste SIRET uses digit sum % 5 instead of
- * Luhn, EXCEPT the head office (35600000000048)
- * which uses standard Luhn.
- */
-const isLaPoste = (v: string): boolean =>
-  v.startsWith("356000000") && v !== "35600000000048";
-
-const digitSum = (v: string): number => {
-  let sum = 0;
-  for (let i = 0; i < v.length; i++) {
-    sum += Number(v[i]);
-  }
-  return sum;
-};
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 14) {
-    return err(
-      "INVALID_LENGTH",
-      "SIRET must be exactly 14 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "SIRET must contain only digits",
-    );
-  }
-
-  // Validate SIREN part (first 9 digits)
-  const siren = v.slice(0, 9);
-  if (!luhnValidate(siren) && !isLaPoste(v)) {
-    return err(
-      "INVALID_CHECKSUM",
-      "SIRET SIREN part fails Luhn check",
-    );
-  }
-
-  // La Poste: digit sum mod 5
-  if (isLaPoste(v)) {
-    if (digitSum(v) % 5 !== 0) {
-      return err(
-        "INVALID_CHECKSUM",
-        "SIRET La Poste digit sum check failed",
-      );
-    }
-  } else {
-    // Standard: full 14-digit Luhn
-    if (!luhnValidate(v)) {
-      return err(
-        "INVALID_CHECKSUM",
-        "SIRET fails Luhn check",
-      );
-    }
-  }
-
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => {
-  const v = compact(value);
-  return `${v.slice(0, 3)} ${v.slice(3, 6)} ${v.slice(6, 9)} ${v.slice(9)}`;
-};
-
-/** Generate a random valid French SIRET. */
-const generate = (): string => {
-  const sp = randomDigits(8);
-  const sc = luhnChecksum(sp + "0");
-  const siren = sp + String((10 - sc) % 10);
-  const nic = randomDigits(4);
-  const payload = siren + nic;
-  const cs = luhnChecksum(payload + "0");
-  return payload + String((10 - cs) % 10);
-};
-
-/** French Establishment Identification Number. */
-const siret: CountryValidator<"FR"> = {
-  name: "French Establishment ID",
-  localName:
-    "Système d'Identification du Répertoire des Établissements",
-  abbreviation: "SIRET",
-  aliases: ["SIRET", "numéro SIRET"] as const,
-  candidatePattern: "\\d{3}\\s?\\d{3}\\s?\\d{3}\\s?\\d{5}",
-  scope: "country",
-  country: "FR",
-  entityType: "company",
-  sourceUrl: "https://www.insee.fr/fr/information/2549588",
-  examples: ["73282932000074"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default siret;
-export { compact, format, validate, generate };