@stll/stdnum 2.1.1 → 2.1.2

package/src/id/npwp.ts

@@ -1,191 +0,0 @@
-/**
- * NPWP (Nomor Pokok Wajib Pajak, Indonesian tax ID).
- *
- * 15 or 16 digits. The 15-digit (legacy) format has a
- * Luhn check on the first 9 digits. The 16-digit format
- * is either a NIK (starts with non-zero) validated as a
- * province-code and birth-date checks, or the legacy
- * format prefixed with 0 (Luhn on first 10 digits).
- *
- * @see https://www.oecd.org/tax/automatic-exchange/crs-implementation-and-assistance/tax-identification-numbers/Indonesia-TIN.pdf
- */
-
-import type {
-  ValidateResult,
-  CountryValidator,
-} from "../types";
-
-import {
-  luhnValidate,
-  luhnChecksum,
-} from "#checksums/luhn";
-import { clean } from "#util/clean";
-import { isValidDate } from "#util/date";
-import { randomDigits } from "#util/generate";
-import { err } from "#util/result";
-import { isdigits } from "#util/strings";
-
-const compact = (value: string): string =>
-  clean(value, " .-");
-
-/**
- * Valid 2-digit province codes for NIK, sourced from
- * python-stdnum's id/loc numdb.
- */
-const NIK_PROVINCES = new Set([
-  "11",
-  "12",
-  "13",
-  "14",
-  "15",
-  "16",
-  "17",
-  "18",
-  "19",
-  "21",
-  "31",
-  "32",
-  "33",
-  "34",
-  "35",
-  "36",
-  "51",
-  "52",
-  "53",
-  "61",
-  "62",
-  "63",
-  "64",
-  "71",
-  "72",
-  "73",
-  "74",
-  "75",
-  "76",
-  "81",
-  "82",
-  "91",
-  "94",
-]);
-
-/**
- * Validate a 16-digit NIK (Nomor Induk Kependudukan).
- * Format: PPRRSSDDMMYYXXXX where PP = province,
- * RRSS = regency/city + sub-district,
- * DDMMYY = birth date (DD+40 for females),
- * XXXX = serial.
- */
-const validateNik = (v: string): ValidateResult => {
-  // Province code check
-  if (!NIK_PROVINCES.has(v.slice(0, 2))) {
-    return err(
-      "INVALID_COMPONENT",
-      "NIK province code is invalid",
-    );
-  }
-  let day = Number(v.slice(6, 8));
-  const month = Number(v.slice(8, 10));
-  const year = Number(v.slice(10, 12));
-  // Females have 40 added to the day
-  if (day > 40) day -= 40;
-  // Validate the date (century is ambiguous in NIK)
-  if (
-    !isValidDate(1900 + year, month, day) &&
-    !isValidDate(2000 + year, month, day)
-  ) {
-    return err(
-      "INVALID_COMPONENT",
-      "NIK contains an invalid date",
-    );
-  }
-  return { valid: true, compact: v };
-};
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "NPWP must contain only digits",
-    );
-  }
-  if (v.length === 15) {
-    // Legacy 15-digit format: Luhn on first 9 digits
-    if (!luhnValidate(v.slice(0, 9))) {
-      return err(
-        "INVALID_CHECKSUM",
-        "NPWP Luhn check on first 9 digits failed",
-      );
-    }
-    return { valid: true, compact: v };
-  }
-  if (v.length === 16) {
-    if (v[0] !== "0") {
-      // NIK format
-      return validateNik(v);
-    }
-    // 0-prefixed legacy: Luhn on first 10 digits
-    if (!luhnValidate(v.slice(0, 10))) {
-      return err(
-        "INVALID_CHECKSUM",
-        "NPWP Luhn check on first 10 digits failed",
-      );
-    }
-    return { valid: true, compact: v };
-  }
-  return err(
-    "INVALID_LENGTH",
-    "NPWP must be 15 or 16 digits",
-  );
-};
-
-const format = (value: string): string => {
-  const v = compact(value);
-  if (v.length === 16) {
-    // NIK or 0-prefixed legacy: no standard mask
-    return v;
-  }
-  return (
-    `${v.slice(0, 2)}.${v.slice(2, 5)}.` +
-    `${v.slice(5, 8)}.${v.slice(8, 9)}` +
-    `-${v.slice(9, 12)}.${v.slice(12)}`
-  );
-};
-
-/** Generate a random valid 15-digit NPWP. */
-const generate = (): string => {
-  for (;;) {
-    const p = randomDigits(8);
-    const cs = luhnChecksum(p + "0");
-    const c = p + String((10 - cs) % 10) + randomDigits(6);
-    if (validate(c).valid) return c;
-  }
-};
-
-/** Indonesian Taxpayer Identification Number. */
-const npwp: CountryValidator<"ID"> = {
-  name: "Indonesian Taxpayer Identification Number",
-  localName: "Nomor Pokok Wajib Pajak",
-  abbreviation: "NPWP",
-  aliases: ["NPWP", "Nomor Pokok Wajib Pajak"] as const,
-  candidatePattern:
-    "\\d{2}\\.?\\d{3}\\.?\\d{3}\\.?\\d-?\\d{3}\\.?\\d{3}",
-  scope: "country",
-  country: "ID",
-  entityType: "any",
-  lengths: [15, 16],
-  examples: ["013000666091000", "016090524017000"],
-  description:
-    "15 or 16-digit tax identification number issued by " +
-    "the Directorate General of Taxes",
-  sourceUrl:
-    "https://en.wikipedia.org/wiki/" +
-    "Tax_identification_number#Indonesia",
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default npwp;
-export { compact, format, validate, generate };

package/src/ie/mod.ts

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

package/src/ie/pps.ts

@@ -1,109 +0,0 @@
-/**
- * PPS (Personal Public Service Number).
- *
- * Irish personal identification number. 7 digits
- * followed by a check letter and an optional second
- * letter (new format). Uses a weighted sum with
- * alphabet "WABCDEFGHIJKLMNOPQRSTUV".
- *
- * @see https://www.gov.ie/en/service/12e6de-get-a-personal-public-service-pps-number/
- */
-
-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 ALPHABET = "WABCDEFGHIJKLMNOPQRSTUV";
-
-const compact = (value: string): string =>
-  clean(value, " -").toUpperCase();
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length < 8 || v.length > 9) {
-    return err(
-      "INVALID_LENGTH",
-      "PPS must be 8 or 9 characters",
-    );
-  }
-
-  const digits = v.slice(0, 7);
-  if (!isdigits(digits)) {
-    return err(
-      "INVALID_FORMAT",
-      "PPS must start with 7 digits",
-    );
-  }
-
-  const checkLetter = v[7];
-  const secondLetter = v.length >= 9 ? v[8] : undefined;
-
-  // Compute weighted sum: weights 8..2 for digits
-  let sum = 0;
-  for (let i = 0; i < 7; i++) {
-    sum += Number(digits[i]) * (8 - i);
-  }
-
-  // New format: add 9 * index of 2nd letter
-  if (secondLetter !== undefined && secondLetter !== "W") {
-    const idx = ALPHABET.indexOf(secondLetter);
-    if (idx === -1) {
-      return err(
-        "INVALID_FORMAT",
-        "PPS second letter is invalid",
-      );
-    }
-    sum += 9 * idx;
-  }
-
-  const remainder = sum % 23;
-  const expected = ALPHABET[remainder];
-  if (checkLetter !== expected) {
-    return err(
-      "INVALID_CHECKSUM",
-      "PPS check letter does not match",
-    );
-  }
-
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => compact(value);
-
-/** Generate a random valid Irish PPS number. */
-const generate = (): string => {
-  for (;;) {
-    for (let c = 65; c <= 90; c++) {
-      const cand = randomDigits(7) + String.fromCharCode(c);
-      if (validate(cand).valid) return compact(cand);
-    }
-  }
-};
-
-/** Irish Personal Public Service Number. */
-const pps: CountryValidator<"IE"> = {
-  name: "Irish Personal ID",
-  localName: "Personal Public Service Number",
-  abbreviation: "PPS",
-  aliases: ["PPS number", "PPSN", "RSI number"] as const,
-  candidatePattern: "\\d{7}[A-Z]{1,2}",
-  scope: "country",
-  country: "IE",
-  entityType: "person",
-  sourceUrl:
-    "https://www.gov.ie/en/service/12e6de-get-a-personal-public-service-pps-number/",
-  examples: ["6433435F"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default pps;
-export { compact, format, validate, generate };

package/src/ie/vat.ts

@@ -1,142 +0,0 @@
-/**
- * VAT (Irish VAT number).
- *
- * 8-9 characters, complex format with old and new
- * styles.
- *
- * @see https://www.vatify.eu/ireland-vat-number.html
- * @see https://www.revenue.ie/
- */
-
-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 ALPHABET = "WABCDEFGHIJKLMNOPQRSTUV";
-
-const compact = (value: string): string => {
-  let v = clean(value, " -/.");
-  if (v.startsWith("IE") || v.startsWith("ie")) {
-    v = v.slice(2);
-  }
-  return v.toUpperCase();
-};
-
-const checkNew = (v: string): boolean => {
-  // New format: 7 digits + check letter + optional
-  // trailing letter (W or A-Z)
-  const trailing = v.length === 9 ? v.charAt(8) : "W";
-  let sum = 0;
-  for (let i = 0; i < 7; i++) {
-    sum += (8 - i) * Number(v.charAt(i));
-  }
-  sum += 9 * ALPHABET.indexOf(trailing);
-  const expected = ALPHABET.charAt(sum % 23);
-  return v.charAt(7) === expected;
-};
-
-const checkOld = (v: string): boolean => {
-  // Old format: digit + letter + 5 digits +
-  // check letter (8 chars total).
-  // Rearrange to 7-digit new-style layout:
-  // 0 + d[2..6] + d[0]
-  const rearranged = `0${v.slice(2, 7)}${v.charAt(0)}`;
-  let sum = 0;
-  for (let i = 0; i < 7; i++) {
-    sum += (8 - i) * Number(rearranged.charAt(i));
-  }
-  const expected = ALPHABET.charAt(sum % 23);
-  return v.charAt(7) === expected;
-};
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length !== 8 && v.length !== 9) {
-    return err(
-      "INVALID_LENGTH",
-      "Irish VAT number must be 8 or 9 characters",
-    );
-  }
-
-  // New format: 7 digits + letter [+ letter]
-  if (
-    isdigits(v.slice(0, 7)) &&
-    /^[A-Z]$/.test(v.charAt(7))
-  ) {
-    if (v.length === 9 && !/^[A-Z+*]$/.test(v.charAt(8))) {
-      return err(
-        "INVALID_FORMAT",
-        "Irish VAT trailing character must be a letter",
-      );
-    }
-    if (!checkNew(v)) {
-      return err(
-        "INVALID_CHECKSUM",
-        "Irish VAT number check letter mismatch",
-      );
-    }
-    return { valid: true, compact: v };
-  }
-
-  // Old format: digit + letter + 5 digits + letter
-  if (
-    v.length === 8 &&
-    /^\d$/.test(v.charAt(0)) &&
-    /^[A-Z+*]$/.test(v.charAt(1)) &&
-    isdigits(v.slice(2, 7)) &&
-    /^[A-Z]$/.test(v.charAt(7))
-  ) {
-    if (!checkOld(v)) {
-      return err(
-        "INVALID_CHECKSUM",
-        "Irish VAT number check letter mismatch",
-      );
-    }
-    return { valid: true, compact: v };
-  }
-
-  return err(
-    "INVALID_FORMAT",
-    "Irish VAT number has invalid format",
-  );
-};
-
-const format = (value: string): string =>
-  `IE${compact(value)}`;
-
-/** Generate a random valid Irish VAT number. */
-const generate = (): string => {
-  for (;;) {
-    for (let c = 65; c <= 90; c++) {
-      const cand = randomDigits(7) + String.fromCharCode(c);
-      if (validate(cand).valid) return compact(cand);
-    }
-  }
-};
-
-/** Irish VAT Number. */
-const vat: CountryValidator<"IE"> = {
-  name: "Irish VAT Number",
-  localName: "Value Added Tax Number",
-  abbreviation: "VAT",
-  aliases: ["VAT number IE"] as const,
-  candidatePattern: "IE\\d[A-Z+*]\\d{5}[A-Z]",
-  scope: "country",
-  country: "IE",
-  entityType: "any",
-  sourceUrl: "https://www.revenue.ie/",
-  examples: ["6433435F", "8D79739I"] as const,
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default vat;
-export { compact, format, validate, generate };

package/src/il/idnr.ts

@@ -1,91 +0,0 @@
-/**
- * Identity Number (Mispar Zehut, מספר זהות).
- *
- * Israeli personal identity number. 9 digits
- * (zero-padded) with a Luhn checksum.
- *
- * @see https://en.wikipedia.org/wiki/Israeli_identity_card
- */
-
-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, " -").padStart(9, "0");
-
-const validate = (value: string): ValidateResult => {
-  const v = compact(value);
-  if (v.length > 9) {
-    return err(
-      "INVALID_LENGTH",
-      "Israeli ID must be at most 9 digits",
-    );
-  }
-  if (!isdigits(v) || Number(v) === 0) {
-    return err(
-      "INVALID_FORMAT",
-      "Israeli ID must contain only digits" +
-        " and not be zero",
-    );
-  }
-  if (!luhnValidate(v)) {
-    return err(
-      "INVALID_CHECKSUM",
-      "Israeli ID Luhn check digit mismatch",
-    );
-  }
-  return { valid: true, compact: v };
-};
-
-const format = (value: string): string => {
-  const v = compact(value);
-  return `${v.slice(0, -1)}-${v.slice(-1)}`;
-};
-
-/** Generate a random valid Israeli ID number. */
-const generate = (): string => {
-  const payload = randomDigits(8);
-  const cs = luhnChecksum(payload + "0");
-  return payload + String((10 - cs) % 10);
-};
-
-/** Israeli Identity Number (Mispar Zehut). */
-const idnr: CountryValidator<"IL"> = {
-  name: "Israeli Identity Number",
-  localName: "מספר זהות",
-  abbreviation: "ת.ז.",
-  aliases: [
-    "תעודת זהות",
-    "Teudat Zehut",
-    "ID number",
-  ] as const,
-  candidatePattern: "\\d{9}",
-  scope: "country",
-  country: "IL",
-  entityType: "person",
-  compact,
-  format,
-  validate,
-  description:
-    "Israeli personal identification number" +
-    " (Mispar Zehut)",
-  sourceUrl:
-    "https://en.wikipedia.org/wiki/Israeli_identity_card",
-  lengths: [9] as const,
-  examples: ["039337423", "000000018"] as const,
-  generate,
-};
-
-export default idnr;
-export { compact, format, validate, generate };

package/src/il/mod.ts

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

package/src/in/aadhaar.ts

@@ -1,100 +0,0 @@
-/**
- * Aadhaar (Indian unique identity number).
- *
- * 12 digits with Verhoeff checksum (last digit).
- * Cannot start with 0 or 1.
- * Issued by the Unique Identification Authority
- * of India (UIDAI).
- *
- * @see https://en.wikipedia.org/wiki/Aadhaar
- * @see https://uidai.gov.in/
- */
-
-import type {
-  ValidateResult,
-  CountryValidator,
-} from "../types";
-
-import {
-  verhoeffValidate,
-  verhoeffCheckDigit,
-} from "#checksums/verhoeff";
-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 !== 12) {
-    return err(
-      "INVALID_LENGTH",
-      "Aadhaar must be 12 digits",
-    );
-  }
-  if (!isdigits(v)) {
-    return err(
-      "INVALID_FORMAT",
-      "Aadhaar must contain only digits",
-    );
-  }
-  if (v[0] === "0" || v[0] === "1") {
-    return err(
-      "INVALID_COMPONENT",
-      "Aadhaar cannot start with 0 or 1",
-    );
-  }
-  // Aadhaar cannot be a palindrome
-  if (v === v.split("").reverse().join("")) {
-    return err(
-      "INVALID_FORMAT",
-      "Aadhaar cannot be a palindrome",
-    );
-  }
-  if (!verhoeffValidate(v)) {
-    return err(
-      "INVALID_CHECKSUM",
-      "Aadhaar 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, 8)} ${v.slice(8)}`;
-};
-
-/** Generate a random valid Aadhaar number. */
-const generate = (): string => {
-  const first = String(randomInt(2, 9));
-  const payload = first + randomDigits(10);
-  return payload + String(verhoeffCheckDigit(payload));
-};
-
-/** Indian Unique Identity Number. */
-const aadhaar: CountryValidator<"IN"> = {
-  name: "Indian Unique Identity Number",
-  localName: "Aadhaar",
-  abbreviation: "Aadhaar",
-  aliases: ["Aadhaar", "आधार"] as const,
-  candidatePattern: "\\d{4}\\s?\\d{4}\\s?\\d{4}",
-  scope: "country",
-  country: "IN",
-  entityType: "person",
-  lengths: [12],
-  examples: ["234123412346", "295274982189"],
-  description:
-    "12-digit unique identity number issued by UIDAI",
-  sourceUrl: "https://uidai.gov.in/",
-  compact,
-  format,
-  validate,
-  generate,
-};
-
-export default aadhaar;
-export { compact, format, validate, generate };