@stll/stdnum 2.1.1 → 2.1.2

package/src/si/emso.ts

@@ -1,178 +0,0 @@
-/**
- * EMŠO (Enotna matična številka občana).
- *
- * Slovenian unique master citizen number. 13 digits
- * encoding DDMMYYY (7-digit birth year), region code,
- * serial number, and a check digit.
- *
- * Canonical source:
- * - Slovenia government registry overview
- *
- * This is the source behind the stricter register
- * code check (50-59) and the decision to reject
- * future birth dates in the embedded date field.
- *
- * @see https://www.gov.si/teme/registri-in-evidence-prebivalstva/
- */
-
-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 = [
-  7, 6, 5, 4, 3, 2, 7, 6, 5, 4, 3, 2,
-] as const;
-
-const compact = (value: string): string =>
-  clean(value, " -");
-
-/**
- * Compute the check digit matching python-stdnum:
- * `str(-total % 11 % 10)`.
- */
-const calcCheckDigit = (v: string): number => {
-  const total = weightedSum(v.slice(0, 12), WEIGHTS, 11);
-  // Python's (-total % 11 % 10) — always 0..9
-  // weightedSum already returns (sum % 11 + 11) % 11,
-  // so total is 0..10. Negate within mod 11:
-  return ((11 - total) % 11) % 10;
-};
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 13) {
-    return err(
-      "INVALID_LENGTH",
-      "EMŠO must be exactly 13 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "EMŠO must contain only digits",
-    );
-  }
-
-  // Validate embedded birth date (DDMMYYY)
-  const dd = Number(v.slice(0, 2));
-  const mm = Number(v.slice(2, 4));
-  let yyyy = Number(v.slice(4, 7));
-  // JMBG standard: 900-999 → 1900s, 000-899 → 2000s
-  // Note: python-stdnum uses 800 as threshold, but
-  // the official JMBG spec uses 900. No practical
-  // difference (800-899 range has no living citizens).
-  if (yyyy < 900) {
-    yyyy += 2000;
-  } else {
-    yyyy += 1000;
-  }
-  if (!isValidDate(yyyy, mm, dd)) {
-    return err(
-      "INVALID_COMPONENT",
-      "EMŠO contains an invalid date",
-    );
-  }
-  const birthDate = new Date(yyyy, mm - 1, dd);
-  const today = new Date();
-  today.setHours(0, 0, 0, 0);
-  if (birthDate > today) {
-    return err(
-      "INVALID_COMPONENT",
-      "EMŠO cannot contain a future birth date",
-    );
-  }
-
-  const register = Number(v.slice(7, 9));
-  if (register < 50 || register > 59) {
-    return err(
-      "INVALID_COMPONENT",
-      "EMSO register code must be between 50 and 59",
-    );
-  }
-
-  if (calcCheckDigit(v) !== Number(v[12])) {
-    return err(
-      "INVALID_CHECKSUM",
-      "EMŠO check digit does not match",
-    );
-  }
-
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => compact(value);
-
-/**
- * Extract birth date and gender from an EMSO.
- * 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));
-  let yyyy = Number(v.slice(4, 7));
-  if (yyyy < 900) {
-    yyyy += 2000;
-  } else {
-    yyyy += 1000;
-  }
-
-  const serial = Number(v.slice(9, 12));
-
-  return {
-    birthDate: new Date(yyyy, mm - 1, dd),
-    gender: serial < 500 ? "male" : "female",
-  };
-};
-
-/** Generate a random valid Slovenian EMSO. */
-const generate = (): string => {
-  for (;;) {
-    const dd = String(randomInt(1, 28)).padStart(2, "0");
-    const mm = String(randomInt(1, 12)).padStart(2, "0");
-    const yyy = String(randomInt(900, 999));
-    const rr = String(randomInt(50, 59));
-    const sss = String(randomInt(0, 999)).padStart(3, "0");
-    const partial = dd + mm + yyy + rr + sss;
-    const c = partial + String(calcCheckDigit(partial));
-    if (validate(c).valid) return c;
-  }
-};
-
-/** Slovenian Unique Master Citizen Number. */
-const emso: CountryValidator<"SI", ParsedPersonId> = {
-  name: "Slovenian Personal ID",
-  localName: "Enotna matična številka občana",
-  abbreviation: "EMŠO",
-  aliases: [
-    "EMŠO",
-    "enotna matična številka občana",
-  ] as const,
-  candidatePattern: "\\d{13}",
-  scope: "country",
-  country: "SI",
-  entityType: "person",
-  sourceUrl:
-    "https://www.gov.si/teme/registri-in-evidence-prebivalstva/",
-  examples: ["0101006500006"] as const,
-  compact,
-  format,
-  parse,
-  validate,
-  generate,
-};
-
-export default emso;
-export { compact, format, parse, validate, generate };

package/src/si/mod.ts

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

package/src/si/vat.ts

@@ -1,113 +0,0 @@
-/**
- * DDV (Slovenian VAT number).
- *
- * 8 digits, no leading 0.
- * Weights [8,7,6,5,4,3,2], check = 11 - sum % 11.
- * If check === 10 invalid; if 11 the number is
- * invalid (spec says no valid number yields 11).
- *
- * @see https://www.vatify.eu/slovenia-vat-number.html
- * @see https://spot.gov.si/en/info/taxes/value-added-tax-vat
- */
-
-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 = [8, 7, 6, 5, 4, 3, 2];
-
-const compact = (value: string): string => {
-  let v = clean(value, " -/.");
-  if (v.startsWith("SI") || v.startsWith("si")) {
-    v = v.slice(2);
-  }
-  return v;
-};
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 8) {
-    return err(
-      "INVALID_LENGTH",
-      "Slovenian VAT number must be 8 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "Slovenian VAT number must contain only digits",
-    );
-  }
-  if (v[0] === "0") {
-    return err(
-      "INVALID_COMPONENT",
-      "Slovenian VAT number cannot start with 0",
-    );
-  }
-  const remainder = weightedSum(v.slice(0, 7), WEIGHTS, 11);
-  const check = 11 - remainder;
-  if (check === 11) {
-    return err(
-      "INVALID_CHECKSUM",
-      "Slovenian VAT number check digit invalid",
-    );
-  }
-  if (check === 10) {
-    // check digit 10 means 0
-    if (Number(v[7]) !== 0) {
-      return err(
-        "INVALID_CHECKSUM",
-        "Slovenian VAT number check digit mismatch",
-      );
-    }
-  } else if (check !== Number(v[7])) {
-    return err(
-      "INVALID_CHECKSUM",
-      "Slovenian VAT number check digit mismatch",
-    );
-  }
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string =>
-  `SI${compact(value)}`;
-
-/** Generate a random valid Slovenian VAT number. */
-const generate = (): string => {
-  for (;;) {
-    const c = String(randomInt(1, 9)) + randomDigits(7);
-    if (validate(c).valid) return c;
-  }
-};
-
-/** Slovenian VAT Number. */
-const vat: CountryValidator<"SI"> = {
-  name: "Slovenian VAT Number",
-  localName: "Davčna številka",
-  abbreviation: "DDV",
-  aliases: [
-    "DDV",
-    "identifikacijska številka za DDV",
-  ] as const,
-  candidatePattern: "SI\\d{8}",
-  scope: "country",
-  country: "SI",
-  entityType: "company",
-  sourceUrl: "https://www.fu.gov.si/",
-  lengths: [8] as const,
-  examples: ["15012557"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default vat;
-export { compact, format, validate, generate };

package/src/sk/dic.ts

@@ -1,110 +0,0 @@
-/**
- * IČ DPH (Identifikačné číslo pre daň z
- * pridanej hodnoty).
- *
- * Slovak VAT number. Format: "SK" + 10 digits.
- * The 10-digit number must be divisible by 11.
- * First digit is 1-9.
- *
- * @see https://www.financnasprava.sk/
- */
-
-import { validate as validateRc } from "../cz/rc";
-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 => {
-  const v = clean(value, " -");
-  if (v.startsWith("SK") || v.startsWith("sk")) {
-    return v.slice(2);
-  }
-  return v;
-};
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 10) {
-    return err(
-      "INVALID_LENGTH",
-      "Slovak VAT number must be 10 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "Slovak VAT number must contain only digits",
-    );
-  }
-  // A valid birth number is also accepted as DPH
-  if (validateRc(v).valid) {
-    return { valid: true, compact: v };
-  }
-  if (v[0] === "0") {
-    return err(
-      "INVALID_COMPONENT",
-      "Slovak VAT number cannot start with 0",
-    );
-  }
-  // Third digit must be 2, 3, 4, 7, 8, or 9
-  const d3 = Number(v[2]);
-  if (
-    d3 !== 2 &&
-    d3 !== 3 &&
-    d3 !== 4 &&
-    d3 !== 7 &&
-    d3 !== 8 &&
-    d3 !== 9
-  ) {
-    return err(
-      "INVALID_FORMAT",
-      "Slovak VAT number has invalid third digit",
-    );
-  }
-  if (Number(v) % 11 !== 0) {
-    return err(
-      "INVALID_CHECKSUM",
-      "Slovak VAT number is not divisible by 11",
-    );
-  }
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string =>
-  `SK${compact(value)}`;
-
-/** Generate a random valid Slovak DIČ. */
-const generate = (): string => {
-  for (;;) {
-    const c = randomDigits(10);
-    if (validate(c).valid) return c;
-  }
-};
-
-/** Slovak VAT Number. */
-const dic: CountryValidator<"SK"> = {
-  name: "Slovak VAT Number",
-  localName:
-    "Identifikačné číslo pre daň z pridanej hodnoty",
-  abbreviation: "IČ DPH",
-  aliases: ["DIČ", "daňové identifikačné číslo"] as const,
-  candidatePattern: "SK\\d{10}",
-  scope: "country",
-  country: "SK",
-  entityType: "company",
-  sourceUrl: "https://www.financnasprava.sk/",
-  examples: ["2021853504"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default dic;
-export { compact, format, validate, generate };

package/src/sk/ico.ts

@@ -1,40 +0,0 @@
-/**
- * IČO (Identifikačné číslo organizácie).
- *
- * Slovak company identification number. Same
- * 8-digit weighted checksum as the Czech IČO.
- *
- * @see https://www.statistics.sk/
- */
-
-import {
-  compact,
-  format,
-  generate,
-  validate,
-} from "../cz/ico";
-import type { CountryValidator } from "../types";
-
-/** Slovak Company Identification Number. */
-const ico: CountryValidator<"SK"> = {
-  name: "Slovak Company ID",
-  localName: "Identifikačné číslo organizácie",
-  abbreviation: "IČO",
-  aliases: [
-    "IČO",
-    "identifikačné číslo organizácie",
-  ] as const,
-  candidatePattern: "\\d{8}",
-  scope: "country",
-  country: "SK",
-  entityType: "company",
-  sourceUrl: "https://www.statistics.sk/",
-  examples: ["25123891"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default ico;
-export { compact, format, validate, generate };

package/src/sk/mod.ts

@@ -1,3 +0,0 @@
-export { default as dic } from "./dic";
-export { default as ico } from "./ico";
-export { default as rc } from "./rc";

package/src/sk/rc.ts

@@ -1,44 +0,0 @@
-/**
- * RČ (Rodné číslo).
- *
- * Slovak birth number. Identical algorithm to
- * the Czech birth number.
- *
- * @see https://www.mvcr.cz/mvcren/docDetail.aspx?docid=21975362&doctype=ART
- * @see https://www.minv.sk/
- */
-
-import {
-  compact,
-  format,
-  generate,
-  parse,
-  validate,
-} from "../cz/rc";
-import type {
-  ParsedPersonId,
-  CountryValidator,
-} from "../types";
-
-/** Slovak Birth Number. */
-const rc: CountryValidator<"SK", ParsedPersonId> = {
-  name: "Slovak Birth Number",
-  localName: "Rodné číslo",
-  abbreviation: "RČ",
-  aliases: ["rodné číslo", "RČ"] as const,
-  candidatePattern: "\\d{6}/\\d{3,4}",
-  scope: "country",
-  country: "SK",
-  entityType: "person",
-  sourceUrl: "https://www.minv.sk/",
-  lengths: [9, 10] as const,
-  examples: ["7103192745"] as const,
-  compact,
-  format,
-  generate,
-  parse,
-  validate,
-};
-
-export default rc;
-export { compact, format, generate, parse, validate };

package/src/th/mod.ts

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

package/src/th/tin.ts

@@ -1,106 +0,0 @@
-/**
- * TIN (Thai Tax Identification Number,
- * เลขประจำตัวผู้เสียภาษี).
- *
- * 13 digits. Individual TINs have first digit 1-8;
- * company TINs (MOA) start with 0. Both use a
- * weighted mod-11 check digit.
- *
- * @see https://www.rd.go.th/
- * @see https://en.wikipedia.org/wiki/Thai_identity_card
- */
-
-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",
-      "TIN must be exactly 13 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "TIN must contain only digits",
-    );
-  }
-
-  // First digit: 1-8 for individuals, 0 for companies
-  const first = Number(v[0]);
-  if (first > 8) {
-    return err(
-      "INVALID_COMPONENT",
-      "TIN first digit must be 0-8",
-    );
-  }
-
-  // Mod-11 check digit (position 13)
-  let sum = 0;
-  for (let i = 0; i < 12; i++) {
-    sum += Number(v[i]) * (13 - i);
-  }
-  const check = (11 - (sum % 11)) % 10;
-  if (check !== Number(v[12])) {
-    return err(
-      "INVALID_CHECKSUM",
-      "TIN check digit does not match",
-    );
-  }
-
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => {
-  const v = compact(value);
-  return (
-    `${v[0]} ${v.slice(1, 5)} ` +
-    `${v.slice(5, 10)} ${v.slice(10, 12)} ${v[12]}`
-  );
-};
-
-/** Generate a random valid Thai TIN. */
-const generate = (): string => {
-  const first = String(randomInt(1, 8));
-  const payload = first + randomDigits(11);
-  let sum = 0;
-  for (let i = 0; i < 12; i++)
-    sum += (13 - i) * Number(payload[i]);
-  return payload + String((11 - (sum % 11)) % 10);
-};
-
-/** Thai Tax Identification Number. */
-const tin: CountryValidator<"TH"> = {
-  name: "Thai Tax Identification Number",
-  localName: "เลขประจำตัวผู้เสียภาษี",
-  abbreviation: "TIN",
-  aliases: ["เลขประจำตัวผู้เสียภาษี", "TIN"] as const,
-  candidatePattern: "\\d{13}",
-  scope: "country",
-  country: "TH",
-  entityType: "any",
-  description:
-    "13-digit tax identifier for individuals and companies",
-  sourceUrl: "https://www.rd.go.th/",
-  lengths: [13] as const,
-  examples: ["1101700230708", "3100600445015"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default tin;
-export { compact, format, validate, generate };

package/src/tr/mod.ts

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