@stll/stdnum 2.1.1 → 2.1.2

package/src/nl/bsn.ts

@@ -1,91 +0,0 @@
-/**
- * BSN (Burgerservicenummer).
- *
- * Dutch citizen service number. 9 digits (zero-padded)
- * with a weighted checksum where the last digit has
- * weight -1.
- *
- * @see https://www.government.nl/topics/personal-data/citizen-service-number-bsn
- */
-
-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 = [9, 8, 7, 6, 5, 4, 3, 2, -1] as const;
-
-const compact = (value: string): string =>
-  clean(value, " -.").padStart(9, "0");
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 9) {
-    return err(
-      "INVALID_LENGTH",
-      "BSN must be exactly 9 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "BSN must contain only digits",
-    );
-  }
-
-  if (Number(v) === 0) {
-    return err("INVALID_FORMAT", "BSN cannot be all zeros");
-  }
-
-  const sum = weightedSum(v, WEIGHTS, 11);
-  if (sum !== 0) {
-    return err(
-      "INVALID_CHECKSUM",
-      "BSN check does not match",
-    );
-  }
-
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => compact(value);
-
-/** Generate a random valid Dutch BSN. */
-const generate = (): string => {
-  for (;;) {
-    const c = randomDigits(9);
-    if (validate(c).valid) return c;
-  }
-};
-
-/** Dutch Citizen Service Number. */
-const bsn: CountryValidator<"NL"> = {
-  name: "Dutch Citizen Service Number",
-  localName: "Burgerservicenummer",
-  abbreviation: "BSN",
-  aliases: [
-    "burgerservicenummer",
-    "BSN",
-    "sofinummer",
-  ] as const,
-  candidatePattern: "\\d{9}",
-  scope: "country",
-  country: "NL",
-  entityType: "person",
-  sourceUrl:
-    "https://www.government.nl/topics/personal-data/citizen-service-number-bsn",
-  examples: ["111222333"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default bsn;
-export { compact, format, validate, generate };

package/src/nl/kvk.ts

@@ -1,63 +0,0 @@
-/** Generate a random valid Dutch KvK number. */
-const generate = (): string => randomDigits(8);
-
-/**
- * KvK-nummer (Dutch Chamber of Commerce number).
- *
- * 8 digits. Format-only validation; no checksum.
- *
- * @see https://www.kvk.nl/
- */
-
-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, " -/.");
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 8) {
-    return err(
-      "INVALID_LENGTH",
-      "Dutch KvK number must be 8 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "Dutch KvK number must contain only digits",
-    );
-  }
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => compact(value);
-
-/** Dutch Chamber of Commerce Number. */
-const kvk: CountryValidator<"NL"> = {
-  name: "Dutch Chamber of Commerce Number",
-  localName: "KvK-nummer",
-  abbreviation: "KvK",
-  aliases: ["KVK-nummer", "Kamer van Koophandel"] as const,
-  candidatePattern: "\\d{8}",
-  scope: "country",
-  country: "NL",
-  entityType: "company",
-  sourceUrl: "https://www.kvk.nl/",
-  examples: ["12345678"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default kvk;
-export { compact, format, validate, generate };

package/src/nl/mod.ts

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

package/src/nl/vat.ts

@@ -1,95 +0,0 @@
-/**
- * BTW (Dutch VAT number).
- *
- * 12 characters: 9 digits + "B" + 2 digits.
- *
- * The current Dutch VAT identification number
- * (btw-id) format is structural: `NL` + 9 digits
- * + `B` + 2 digits. The official guidance explicitly
- * states that the 9 digits are not derived from BSN
- * and the final 2 digits are random.
- *
- * @see https://business.gov.nl/regulations/using-checking-vat-numbers/
- */
-
-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("NL") || v.startsWith("nl")) {
-    v = v.slice(2);
-  }
-  v = v.toUpperCase();
-  // Zero-pad numeric part to 9 digits if B is found
-  const bIdx = v.indexOf("B");
-  if (bIdx > 0 && bIdx < 9) {
-    v = v.slice(0, bIdx).padStart(9, "0") + v.slice(bIdx);
-  }
-  return v;
-};
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 12) {
-    return err(
-      "INVALID_LENGTH",
-      "Dutch VAT number must be 12 characters",
-    );
-  }
-  if (!isdigits(v.slice(0, 9))) {
-    return err(
-      "INVALID_FORMAT",
-      "Dutch VAT number must start with 9 digits",
-    );
-  }
-  if (v[9] !== "B") {
-    return err(
-      "INVALID_COMPONENT",
-      "Dutch VAT number digit 10 must be B",
-    );
-  }
-  if (!isdigits(v.slice(10, 12))) {
-    return err(
-      "INVALID_FORMAT",
-      "Dutch VAT number must end with 2 digits",
-    );
-  }
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string =>
-  `NL${compact(value)}`;
-
-/** Generate a random valid Dutch VAT number. */
-const generate = (): string =>
-  `${randomDigits(9)}B${randomDigits(2)}`;
-
-/** Dutch VAT Number. */
-const vat: CountryValidator<"NL"> = {
-  name: "Dutch VAT Number",
-  localName: "BTW-identificatienummer",
-  abbreviation: "BTW",
-  aliases: ["BTW-nummer", "BTW-id"] as const,
-  candidatePattern: "NL\\d{9}B\\d{2}",
-  scope: "country",
-  country: "NL",
-  entityType: "company",
-  sourceUrl:
-    "https://business.gov.nl/regulations/using-checking-vat-numbers/",
-  examples: ["000099998B57"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default vat;
-export { compact, format, validate, generate };

package/src/no/fodselsnummer.ts

@@ -1,197 +0,0 @@
-/**
- * Fødselsnummer (Norwegian birth number).
- *
- * 11 digits: DDMMYY + 3-digit individual number + 2
- * check digits. Supports D-numbers (day + 40) and
- * H-numbers (month + 40).
- *
- * @see https://www.skatteetaten.no/
- */
-
-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 WEIGHTS_D1 = [3, 7, 6, 1, 8, 9, 4, 5, 2] as const;
-const WEIGHTS_D2 = [5, 4, 3, 2, 7, 6, 5, 4, 3, 2] as const;
-
-const compact = (value: string): string =>
-  clean(value, " -");
-
-const getCentury = (
-  yy: number,
-  individual: number,
-): number | undefined => {
-  if (individual >= 0 && individual <= 499) return 1900;
-  if (individual >= 500 && individual <= 749 && yy >= 54) {
-    return 1800;
-  }
-  if (individual >= 500 && individual <= 999 && yy < 40) {
-    return 2000;
-  }
-  if (individual >= 900 && individual <= 999 && yy >= 40) {
-    return 1900;
-  }
-  return undefined;
-};
-
-const checkDigit = (
-  v: string,
-  weights: readonly number[],
-): number | undefined => {
-  let sum = 0;
-  for (let i = 0; i < weights.length; i++) {
-    sum += Number(v.charAt(i)) * (weights[i] ?? 0);
-  }
-  const remainder = (11 - (sum % 11)) % 11;
-  if (remainder === 10) return undefined;
-  return remainder;
-};
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 11) {
-    return err(
-      "INVALID_LENGTH",
-      "Norwegian birth number must be 11 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "Norwegian birth number must contain only digits",
-    );
-  }
-
-  // Check digits
-  const d1 = checkDigit(v, WEIGHTS_D1);
-  if (d1 === undefined || d1 !== Number(v[9])) {
-    return err(
-      "INVALID_CHECKSUM",
-      "Norwegian birth number check digit 1 mismatch",
-    );
-  }
-  const d2 = checkDigit(v, WEIGHTS_D2);
-  if (d2 === undefined || d2 !== Number(v[10])) {
-    return err(
-      "INVALID_CHECKSUM",
-      "Norwegian birth number check digit 2 mismatch",
-    );
-  }
-
-  // Parse date components
-  let dd = Number(v.slice(0, 2));
-  let mm = Number(v.slice(2, 4));
-  const yy = Number(v.slice(4, 6));
-  const individual = Number(v.slice(6, 9));
-
-  // D-number: day > 40
-  if (dd > 40) dd -= 40;
-  // H-number: month > 40
-  if (mm > 40) mm -= 40;
-
-  const century = getCentury(yy, individual);
-  if (century === undefined) {
-    return err(
-      "INVALID_COMPONENT",
-      "Norwegian birth number has invalid individual/century combination",
-    );
-  }
-
-  const year = century + yy;
-  if (!isValidDate(year, mm, dd)) {
-    return err(
-      "INVALID_COMPONENT",
-      "Norwegian birth number contains an invalid date",
-    );
-  }
-
-  // Reject future birth dates
-  if (new Date(year, mm - 1, dd) > new Date()) {
-    return err(
-      "INVALID_COMPONENT",
-      "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 Norwegian
- * birth 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;
-  let dd = Number(v.slice(0, 2));
-  let mm = Number(v.slice(2, 4));
-  const yy = Number(v.slice(4, 6));
-  const individual = Number(v.slice(6, 9));
-
-  if (dd > 40) dd -= 40;
-  if (mm > 40) mm -= 40;
-
-  const century = getCentury(yy, individual);
-  if (century === undefined) return null;
-
-  const year = century + yy;
-
-  return {
-    birthDate: new Date(year, mm - 1, dd),
-    gender: individual % 2 === 0 ? "female" : "male",
-  };
-};
-
-/** Generate a random valid Norwegian birth number. */
-const generate = (): string => {
-  for (;;) {
-    const dd = String(randomInt(1, 28)).padStart(2, "0");
-    const mm = String(randomInt(1, 12)).padStart(2, "0");
-    const yy = String(randomInt(50, 99)).padStart(2, "0");
-    const ind = String(randomInt(0, 499)).padStart(3, "0");
-    const c = dd + mm + yy + ind + randomDigits(2);
-    if (validate(c).valid) return c;
-  }
-};
-
-/** Norwegian Birth Number. */
-const fodselsnummer: CountryValidator<
-  "NO",
-  ParsedPersonId
-> = {
-  name: "Norwegian Birth Number",
-  localName: "Fødselsnummer",
-  abbreviation: "Fødselsnr",
-  aliases: ["fødselsnummer", "personnummer"] as const,
-  candidatePattern: "\\d{11}",
-  scope: "country",
-  country: "NO",
-  entityType: "person",
-  sourceUrl: "https://www.skatteetaten.no/",
-  examples: ["15108695088"] as const,
-  compact,
-  format,
-  parse,
-  validate,
-  generate,
-};
-
-export default fodselsnummer;
-export { compact, format, parse, validate, generate };

package/src/no/mod.ts

@@ -1,3 +0,0 @@
-export { default as orgnr } from "./orgnr";
-export { default as mva } from "./mva";
-export { default as fodselsnummer } from "./fodselsnummer";

package/src/no/mva.ts

@@ -1,77 +0,0 @@
-/**
- * MVA (Merverdiavgift, Norwegian VAT number).
- *
- * Format: optional "NO" prefix + 9 digits + "MVA" suffix.
- * The 9-digit part is validated as an Organisasjonsnummer.
- *
- * @see https://www.skatteetaten.no/
- */
-
-import type {
-  ValidateResult,
-  CountryValidator,
-} from "../types";
-import {
-  validate as validateOrgnr,
-  generate as generateOrgnr,
-} from "./orgnr";
-
-import { clean } from "#util/clean";
-import { err } from "#util/result";
-
-const compact = (value: string): string => {
-  let v = clean(value, " -").toUpperCase();
-  if (v.startsWith("NO")) {
-    v = v.slice(2);
-  }
-  return v;
-};
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-
-  if (!v.endsWith("MVA")) {
-    return err(
-      "INVALID_FORMAT",
-      "Norwegian VAT must end with MVA",
-    );
-  }
-
-  const digits = v.slice(0, -3);
-  const orgnrResult = validateOrgnr(digits);
-  if (!orgnrResult.valid) {
-    return orgnrResult;
-  }
-
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => {
-  const v = compact(value);
-  const digits = v.endsWith("MVA") ? v.slice(0, -3) : v;
-  return `NO ${digits.slice(0, 3)} ${digits.slice(3, 6)} ${digits.slice(6)} MVA`;
-};
-
-/** Generate a random valid Norwegian VAT number. */
-const generate = (): string => generateOrgnr() + "MVA";
-
-/** Norwegian VAT Number. */
-const mva: CountryValidator<"NO"> = {
-  name: "Norwegian VAT Number",
-  localName: "Merverdiavgift",
-  abbreviation: "MVA",
-  aliases: ["MVA-nummer", "organisasjonsnummer"] as const,
-  candidatePattern: "NO\\d{9}MVA",
-  scope: "country",
-  country: "NO",
-  entityType: "company",
-  sourceUrl: "https://www.skatteetaten.no/",
-  examples: ["995525828MVA"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default mva;
-export { compact, format, validate, generate };

package/src/no/orgnr.ts

@@ -1,83 +0,0 @@
-/**
- * Organisasjonsnummer (Norwegian organization number).
- *
- * 9 digits. Weights [3,2,7,6,5,4,3,2,1], sum % 11 === 0.
- *
- * @see https://www.brreg.no/
- */
-
-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 = [3, 2, 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 (v.length !== 9) {
-    return err(
-      "INVALID_LENGTH",
-      "Norwegian org number must be 9 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "Norwegian org number must contain only digits",
-    );
-  }
-
-  const sum = weightedSum(v, WEIGHTS, 11);
-  if (sum !== 0) {
-    return err(
-      "INVALID_CHECKSUM",
-      "Norwegian org number check digit mismatch",
-    );
-  }
-
-  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 Norwegian org number. */
-const generate = (): string => {
-  for (;;) {
-    const c = randomDigits(9);
-    if (validate(c).valid) return c;
-  }
-};
-
-/** Norwegian Organization Number. */
-const orgnr: CountryValidator<"NO"> = {
-  name: "Norwegian Organization Number",
-  localName: "Organisasjonsnummer",
-  abbreviation: "Orgnr",
-  aliases: ["organisasjonsnummer", "org.nr"] as const,
-  candidatePattern: "\\d{9}",
-  scope: "country",
-  country: "NO",
-  entityType: "company",
-  sourceUrl: "https://www.brreg.no/",
-  examples: ["923609016"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default orgnr;
-export { compact, format, validate, generate };