@stll/stdnum 2.1.0 → 2.1.2

package/src/kw/civil.ts

@@ -1,161 +0,0 @@
-/**
- * Civil Number (الرقم المدني, Kuwait).
- *
- * 12-digit number issued by PACI (Public Authority
- * for Civil Information):
- *   C       = century indicator (2 = 1900s, 3 = 2000s)
- *   YYMMDD  = birth date
- *   SSSS    = serial number
- *   K       = check digit (mod 11 weighted sum)
- *
- * @see https://prakhar.me/articles/kuwait-civil-id-checksum/
- * @see https://kuwaitsexpat.com/kuwait-civil-id-format/
- */
-
-import type {
-  ParsedBirthDate,
-  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 = [2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2] as const;
-
-const centuryMap: Record<number, number> = {
-  2: 1900,
-  3: 2000,
-};
-
-const compact = (value: string): string =>
-  clean(value, " -");
-
-const calcCheckDigit = (digits: string): number => {
-  let sum = 0;
-  for (const [i, weight] of WEIGHTS.entries()) {
-    sum += Number(digits[i]) * weight;
-  }
-  return (11 - (sum % 11)) % 11;
-};
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-
-  if (v.length !== 12) {
-    return err(
-      "INVALID_LENGTH",
-      "Kuwait civil number must be 12 digits",
-    );
-  }
-
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "Kuwait civil number must contain only digits",
-    );
-  }
-
-  const centuryDigit = Number(v[0]);
-  if (centuryDigit !== 2 && centuryDigit !== 3) {
-    return err(
-      "INVALID_COMPONENT",
-      "Century digit must be 2 or 3",
-    );
-  }
-
-  const yearBase = centuryMap[centuryDigit] ?? 1900;
-  const yy = Number(v.slice(1, 3));
-  const mm = Number(v.slice(3, 5));
-  const dd = Number(v.slice(5, 7));
-  const year = yearBase + yy;
-
-  if (!isValidDate(year, mm, dd)) {
-    return err(
-      "INVALID_COMPONENT",
-      "Civil number contains an invalid birth date",
-    );
-  }
-
-  const expected = calcCheckDigit(v.slice(0, 11));
-  if (expected !== Number(v[11])) {
-    return err(
-      "INVALID_CHECKSUM",
-      "Civil number check digit does not match",
-    );
-  }
-
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => {
-  const v = compact(value);
-  return `${v.slice(0, 1)} ${v.slice(1, 7)} ${v.slice(7, 11)} ${v.slice(11)}`;
-};
-
-/**
- * Extract birth date from a Kuwait civil number.
- * Gender is not encoded in the number.
- * Returns null if the value is not valid.
- */
-const parse = (value: string): ParsedBirthDate | null => {
-  const result = validate(value);
-  if (!result.valid) return null;
-
-  const v = result.compact;
-  const centuryDigit = Number(v[0]);
-  const yearBase = centuryMap[centuryDigit] ?? 1900;
-  const yy = Number(v.slice(1, 3));
-  const mm = Number(v.slice(3, 5));
-  const dd = Number(v.slice(5, 7));
-  const year = yearBase + yy;
-
-  return {
-    birthDate: new Date(year, mm - 1, dd),
-  };
-};
-
-/** Generate a random valid Kuwait civil number. */
-const generate = (): string => {
-  for (;;) {
-    const year = randomInt(1950, 2024);
-    const month = String(randomInt(1, 12)).padStart(2, "0");
-    const day = String(randomInt(1, 28)).padStart(2, "0");
-    const body =
-      `${year >= 2000 ? "3" : "2"}` +
-      `${String(year % 100).padStart(2, "0")}` +
-      `${month}${day}${randomDigits(4)}`;
-    const check = calcCheckDigit(body);
-    if (check > 9) continue;
-    return `${body}${String(check)}`;
-  }
-};
-
-/** Kuwait Civil Number (الرقم المدني). */
-const civil: CountryValidator<"KW", ParsedBirthDate> = {
-  name: "Civil Number",
-  localName: "الرقم المدني",
-  abbreviation: "Civil ID",
-  aliases: ["Civil ID", "الرقم المدني"] as const,
-  candidatePattern: "\\d{12}",
-  scope: "country",
-  country: "KW",
-  entityType: "person",
-  lengths: [12] as const,
-  examples: ["289011200032", "305031512348"] as const,
-  description:
-    "12-digit civil identification number issued by PACI",
-  sourceUrl:
-    "https://kuwaitsexpat.com/kuwait-civil-id-format/",
-  compact,
-  format,
-  parse,
-  validate,
-  generate,
-};
-
-export default civil;
-export { compact, format, generate, parse, validate };

package/src/kw/mod.ts

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

package/src/kz/iin.ts

@@ -1,184 +0,0 @@
-/**
- * IIN (Individual Identification Number,
- * Жеке сәйкестендіру нөмірі / ИИН).
- *
- * Kazakhstan individual identification number. 12 digits:
- *   YYMMDD = birth date
- *   C      = century/gender (1-6)
- *   SSSS   = serial number
- *   K      = check digit (two-pass weighted sum mod 11)
- *
- * Odd century digits = male, even = female.
- * 1-2 = 1800s, 3-4 = 1900s, 5-6 = 2000s.
- *
- * @see https://www.oecd.org/tax/automatic-exchange/crs-implementation-and-assistance/tax-identification-numbers/Kazakhstan-TIN.pdf
- */
-
-import type {
-  ParsedPersonId,
-  ValidateResult,
-  CountryValidator,
-} from "../types";
-
-import { weightedSum } from "#checksums/weighted-sum";
-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_1 = [
-  1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11,
-] as const;
-const WEIGHTS_2 = [
-  3, 4, 5, 6, 7, 8, 9, 10, 11, 1, 2,
-] as const;
-
-const centuryMap: Record<number, number> = {
-  1: 1800,
-  2: 1800,
-  3: 1900,
-  4: 1900,
-  5: 2000,
-  6: 2000,
-};
-
-const compact = (value: string): string =>
-  clean(value, " -").trim();
-
-/**
- * Two-pass check digit: weighted sum mod 11 with
- * fallback to second weight set.
- */
-const calcCheckDigit = (digits: string): number => {
-  let remainder = weightedSum(digits, WEIGHTS_1, 11);
-  if (remainder === 10) {
-    remainder = weightedSum(digits, WEIGHTS_2, 11);
-  }
-  return remainder === 10 ? 0 : remainder;
-};
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-
-  if (v.length !== 12) {
-    return err(
-      "INVALID_LENGTH",
-      "Kazakhstan IIN must be 12 digits",
-    );
-  }
-
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "Kazakhstan IIN must contain only digits",
-    );
-  }
-
-  const centuryDigit = Number(v[6]);
-  if (centuryDigit < 1 || centuryDigit > 6) {
-    return err(
-      "INVALID_COMPONENT",
-      "IIN century/gender digit must be 1-6",
-    );
-  }
-
-  const yearBase = centuryMap[centuryDigit] ?? 1900;
-  const yy = Number(v.slice(0, 2));
-  const mm = Number(v.slice(2, 4));
-  const dd = Number(v.slice(4, 6));
-  const year = yearBase + yy;
-
-  if (!isValidDate(year, mm, dd)) {
-    return err(
-      "INVALID_COMPONENT",
-      "IIN contains an invalid birth date",
-    );
-  }
-
-  const expected = calcCheckDigit(v.slice(0, 11));
-  if (expected !== Number(v[11])) {
-    return err(
-      "INVALID_CHECKSUM",
-      "IIN check digit does not match",
-    );
-  }
-
-  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 Kazakhstan IIN.
- * 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 centuryDigit = Number(v[6]);
-  const yearBase = centuryMap[centuryDigit] ?? 1900;
-  const yy = Number(v.slice(0, 2));
-  const mm = Number(v.slice(2, 4));
-  const dd = Number(v.slice(4, 6));
-  const year = yearBase + yy;
-
-  return {
-    birthDate: new Date(year, mm - 1, dd),
-    gender: centuryDigit % 2 === 1 ? "male" : "female",
-  };
-};
-
-/** Generate a random valid Kazakhstan IIN. */
-const generate = (): string => {
-  for (;;) {
-    const yy = String(randomInt(50, 99)).padStart(2, "0");
-    const mm = String(randomInt(1, 12)).padStart(2, "0");
-    const dd = String(randomInt(1, 28)).padStart(2, "0");
-    const gender = String(randomInt(1, 6));
-    const serial = randomDigits(4);
-    const payload = yy + mm + dd + gender + serial;
-    const check = calcCheckDigit(payload);
-    const c = payload + String(check);
-    if (validate(c).valid) return c;
-  }
-};
-
-/**
- * Kazakhstan Individual Identification Number (IIN).
- *
- * Examples sourced from identique/idnumbers test suite.
- */
-const iin: CountryValidator<"KZ", ParsedPersonId> = {
-  name: "Kazakhstan Individual ID",
-  localName: "Жеке сәйкестендіру нөмірі",
-  abbreviation: "IIN",
-  aliases: [
-    "ИИН",
-    "IIN",
-    "индивидуальный идентификационный номер",
-  ] as const,
-  candidatePattern: "\\d{12}",
-  scope: "country",
-  country: "KZ",
-  entityType: "person",
-  lengths: [12] as const,
-  examples: ["880515300120", "950101400012"] as const,
-  compact,
-  format,
-  parse,
-  validate,
-  sourceUrl:
-    "https://www.oecd.org/tax/automatic-exchange/" +
-    "crs-implementation-and-assistance/" +
-    "tax-identification-numbers/Kazakhstan-TIN.pdf",
-  generate,
-};
-
-export default iin;
-export { compact, format, parse, validate, generate };

package/src/kz/mod.ts

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

package/src/lei.ts

@@ -1,102 +0,0 @@
-/**
- * LEI (Legal Entity Identifier).
- *
- * ISO 17442. 20-character alphanumeric code
- * identifying legal entities in financial
- * transactions. Validated using ISO 7064
- * Mod 97-10 (same as IBAN).
- *
- * @see https://www.gleif.org/
- */
-
-import type {
-  ValidateResult,
-  GlobalValidator,
-} from "./types";
-
-import { mod97 } from "#checksums/mod97";
-import { clean } from "#util/clean";
-import { randomInt } from "#util/generate";
-import { err } from "#util/result";
-import { charValue, isalnum } from "#util/strings";
-
-const compact = (value: string): string =>
-  clean(value, " -").toUpperCase();
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 20) {
-    return err(
-      "INVALID_LENGTH",
-      "LEI must be exactly 20 characters",
-    );
-  }
-  if (!isalnum(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "LEI must contain only letters and digits",
-    );
-  }
-  // Characters 5-18 must be alphanumeric (entity)
-  // Characters 19-20 are check digits (numeric)
-  const checkPart = v.slice(18);
-  if (!/^\d{2}$/.test(checkPart)) {
-    return err(
-      "INVALID_FORMAT",
-      "LEI check digits must be numeric",
-    );
-  }
-  // Convert to numeric and validate mod 97
-  let numeric = "";
-  for (let i = 0; i < v.length; i++) {
-    const ch = v[i];
-    if (ch !== undefined) {
-      numeric += String(charValue(ch));
-    }
-  }
-  if (mod97(numeric) !== 1) {
-    return err(
-      "INVALID_CHECKSUM",
-      "LEI check digits are incorrect",
-    );
-  }
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => {
-  const v = compact(value);
-  return `${v.slice(0, 4)} ${v.slice(4, 8)} ${v.slice(8, 12)} ${v.slice(12, 16)} ${v.slice(16)}`;
-};
-
-/** Generate a random valid LEI. */
-const generate = (): string => {
-  for (;;) {
-    let base = "";
-    for (let i = 0; i < 18; i++)
-      base += String(randomInt(0, 9));
-    for (let cd = 0; cd < 100; cd++) {
-      const c = base + String(cd).padStart(2, "0");
-      if (validate(c).valid) return c;
-    }
-  }
-};
-
-/** Legal Entity Identifier. */
-const lei: GlobalValidator = {
-  scope: "global",
-  name: "Legal Entity Identifier",
-  localName: "Legal Entity Identifier",
-  abbreviation: "LEI",
-  aliases: ["LEI", "Legal Entity Identifier"] as const,
-  candidatePattern: "[A-Z0-9]{18}\\d{2}",
-  entityType: "company",
-  sourceUrl: "https://www.gleif.org/",
-  examples: ["5493006MHB84DD0ZWV18"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default lei;
-export { compact, format, validate, generate };

package/src/li/mod.ts

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

package/src/li/peid.ts

@@ -1,70 +0,0 @@
-/** Generate a random valid Liechtenstein PEID. */
-const generate = (): string => {
-  const len = randomInt(4, 12);
-  const first = String(randomInt(1, 9));
-  return first + randomDigits(len - 1);
-};
-
-/**
- * PEID (Personenidentifikationsnummer).
- *
- * Liechtenstein tax code for individuals and entities.
- * Numeric code of 4 to 12 digits, with leading zeros
- * stripped during compaction.
- *
- * @see https://www.oera.li/
- */
-
-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, " .").replace(/^0+/, "");
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length < 4 || v.length > 12) {
-    return err(
-      "INVALID_LENGTH",
-      "Liechtenstein PEID must be 4 to 12 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "Liechtenstein PEID must contain only digits",
-    );
-  }
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => compact(value);
-
-/** Liechtenstein Person Identification Number. */
-const peid: CountryValidator<"LI"> = {
-  name: "Liechtenstein Person Identification Number",
-  localName: "Personenidentifikationsnummer",
-  abbreviation: "PEID",
-  aliases: ["PEID", "Personenidentifikation"] as const,
-  candidatePattern: "\\d{6}",
-  scope: "country",
-  country: "LI",
-  entityType: "any",
-  lengths: [4, 5, 6, 7, 8, 9, 10, 11, 12] as const,
-  sourceUrl: "https://www.oera.li/",
-  examples: ["1234567"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default peid;
-export { compact, format, validate, generate };

package/src/lk/mod.ts

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