@stll/stdnum 0.0.1 → 1.0.0

package/src/ua/edrpou.ts

@@ -27,8 +27,9 @@ const calcCheck = (
   weights: readonly number[],
 ): number => {
   let sum = 0;
-  for (let i = 0; i < 7; i++) {
-    sum += Number(value[i]) * weights[i]!;
+  for (const [i, weight] of weights.entries()) {
+    if (i >= 7) break;
+    sum += Number(value[i]) * weight;
   }
   return sum % 11;
 };

package/src/us/ein.ts

@@ -1,92 +1,92 @@
+const EIN_PREFIXES = [
+  "01",
+  "02",
+  "03",
+  "04",
+  "05",
+  "06",
+  "10",
+  "11",
+  "12",
+  "13",
+  "14",
+  "15",
+  "16",
+  "20",
+  "21",
+  "22",
+  "23",
+  "24",
+  "25",
+  "26",
+  "27",
+  "30",
+  "31",
+  "32",
+  "33",
+  "34",
+  "35",
+  "36",
+  "37",
+  "38",
+  "39",
+  "40",
+  "41",
+  "42",
+  "43",
+  "44",
+  "45",
+  "46",
+  "47",
+  "48",
+  "50",
+  "51",
+  "52",
+  "53",
+  "54",
+  "55",
+  "56",
+  "57",
+  "58",
+  "59",
+  "60",
+  "61",
+  "62",
+  "63",
+  "64",
+  "65",
+  "66",
+  "67",
+  "68",
+  "71",
+  "72",
+  "73",
+  "74",
+  "75",
+  "76",
+  "77",
+  "80",
+  "81",
+  "82",
+  "83",
+  "84",
+  "85",
+  "86",
+  "87",
+  "88",
+  "90",
+  "91",
+  "92",
+  "93",
+  "94",
+  "95",
+  "98",
+  "99",
+] as const;
+
 /** Generate a random valid U.S. EIN. */
 const generate = (): string => {
-  const prefixes = [
-    "01",
-    "02",
-    "03",
-    "04",
-    "05",
-    "06",
-    "10",
-    "11",
-    "12",
-    "13",
-    "14",
-    "15",
-    "16",
-    "20",
-    "21",
-    "22",
-    "23",
-    "24",
-    "25",
-    "26",
-    "27",
-    "30",
-    "31",
-    "32",
-    "33",
-    "34",
-    "35",
-    "36",
-    "37",
-    "38",
-    "39",
-    "40",
-    "41",
-    "42",
-    "43",
-    "44",
-    "45",
-    "46",
-    "47",
-    "48",
-    "50",
-    "51",
-    "52",
-    "53",
-    "54",
-    "55",
-    "56",
-    "57",
-    "58",
-    "59",
-    "60",
-    "61",
-    "62",
-    "63",
-    "64",
-    "65",
-    "66",
-    "67",
-    "68",
-    "71",
-    "72",
-    "73",
-    "74",
-    "75",
-    "76",
-    "77",
-    "80",
-    "81",
-    "82",
-    "83",
-    "84",
-    "85",
-    "86",
-    "87",
-    "88",
-    "90",
-    "91",
-    "92",
-    "93",
-    "94",
-    "95",
-    "98",
-    "99",
-  ];
-  const prefix =
-    prefixes[randomInt(0, prefixes.length - 1)]!;
+  const prefix = randomPick(EIN_PREFIXES);
   return prefix + randomDigits(7);
 };
 
@@ -102,7 +102,7 @@ const generate = (): string => {
  */
 
 import { clean } from "#util/clean";
-import { randomDigits, randomInt } from "#util/generate";
+import { randomDigits, randomPick } from "#util/generate";
 import { err } from "#util/result";
 import { isdigits } from "#util/strings";
 

package/src/us/itin.ts

@@ -1,13 +1,12 @@
+const ITIN_ALLOWED_GROUPS = Array.from(
+  { length: 30 },
+  (_, i) => i + 70,
+).filter((g) => g !== 89 && g !== 93);
+
 /** Generate a random valid U.S. ITIN. */
 const generate = (): string => {
   const area = "9" + randomDigits(2);
-  const allowed = Array.from(
-    { length: 30 },
-    (_, i) => i + 70,
-  ).filter((g) => g !== 89 && g !== 93);
-  const group = String(
-    allowed[randomInt(0, allowed.length - 1)]!,
-  );
+  const group = String(randomPick(ITIN_ALLOWED_GROUPS));
   const serial = randomDigits(4);
   return `${area}${group}${serial}`;
 };
@@ -25,7 +24,7 @@ const generate = (): string => {
  */
 
 import { clean } from "#util/clean";
-import { randomDigits, randomInt } from "#util/generate";
+import { randomDigits, randomPick } from "#util/generate";
 import { err } from "#util/result";
 import { isdigits } from "#util/strings";
 

package/src/us/rtn.ts

@@ -16,13 +16,17 @@
  */
 
 import { clean } from "#util/clean";
-import { randomDigits, randomInt } from "#util/generate";
+import {
+  randomDigits,
+  randomInt,
+  randomPick,
+} from "#util/generate";
 import { err } from "#util/result";
 import { isdigits } from "#util/strings";
 
 import type { ValidateResult, Validator } from "../types";
 
-const WEIGHTS = [3, 7, 1, 3, 7, 1, 3, 7, 1];
+const WEIGHTS = [3, 7, 1, 3, 7, 1, 3, 7, 1] as const;
 
 const compact = (value: string): string =>
   clean(value, " -").trim();
@@ -57,8 +61,8 @@ const validate = (value: string): ValidateResult => {
 
   // Weighted checksum must be divisible by 10
   let sum = 0;
-  for (let i = 0; i < 9; i++) {
-    sum += Number(v[i]) * WEIGHTS[i]!;
+  for (const [i, weight] of WEIGHTS.entries()) {
+    sum += Number(v[i]) * weight;
   }
   if (sum % 10 !== 0) {
     return err(
@@ -82,16 +86,17 @@ const PREFIX_RANGES: readonly [number, number][] = [
 
 /** Generate a random valid U.S. RTN. */
 const generate = (): string => {
-  const range =
-    PREFIX_RANGES[randomInt(0, PREFIX_RANGES.length - 1)]!;
-  const prefix = String(
-    randomInt(range[0], range[1]),
-  ).padStart(2, "0");
+  const [low, high] = randomPick(PREFIX_RANGES);
+  const prefix = String(randomInt(low, high)).padStart(
+    2,
+    "0",
+  );
   const mid = randomDigits(6);
   const body = prefix + mid;
   let sum = 0;
-  for (let i = 0; i < 8; i++) {
-    sum += Number(body[i]) * WEIGHTS[i]!;
+  for (const [i, weight] of WEIGHTS.entries()) {
+    if (i >= 8) break;
+    sum += Number(body[i]) * weight;
   }
   const check = (10 - (sum % 10)) % 10;
   return body + String(check);

package/src/uy/rut.ts

@@ -39,8 +39,8 @@ const pymod = (a: number, b: number): number =>
 
 const calcCheckDigit = (value: string): string | null => {
   let sum = 0;
-  for (let i = 0; i < 11; i++) {
-    sum += Number(value[i]) * WEIGHTS[i]!;
+  for (const [i, weight] of WEIGHTS.entries()) {
+    sum += Number(value[i]) * weight;
   }
   const result = pymod(-sum, 11);
   // A result of 10 means no valid single-digit check

package/src/ve/rif.ts

@@ -14,7 +14,7 @@
  */
 
 import { clean } from "#util/clean";
-import { randomDigits, randomInt } from "#util/generate";
+import { randomDigits, randomPick } from "#util/generate";
 import { err } from "#util/result";
 import { isdigits } from "#util/strings";
 
@@ -48,12 +48,14 @@ const calcCheckDigit = (
   prefix: string,
   body: string,
 ): string => {
-  const pv = PREFIX_VALUES[prefix]!;
+  const pv = PREFIX_VALUES[prefix] ?? 0;
   let sum = 0;
-  for (let i = 0; i < 8; i++) {
-    sum += Number(body[i]) * WEIGHTS[i]!;
+  for (const [i, weight] of WEIGHTS.entries()) {
+    sum += Number(body[i]) * weight;
   }
   const digit = (pv + (sum % 11)) % 11;
+  // SAFETY: digit ∈ [0, 10] and CHECK_LOOKUP has 11 chars.
+  // eslint-disable-next-line no-non-null-assertion
   return CHECK_LOOKUP[digit]!;
 };
 
@@ -67,6 +69,8 @@ const validate = (value: string): ValidateResult => {
     );
   }
 
+  // SAFETY: length check above guarantees v[0] exists.
+  // eslint-disable-next-line no-non-null-assertion
   const prefix = v[0]!;
   if (!(prefix in PREFIX_VALUES)) {
     return err(
@@ -100,10 +104,11 @@ const format = (value: string): string => {
   return `${v[0]}-${v.slice(1, 9)}-${v.slice(9)}`;
 };
 
+const GENERATE_TYPES = ["V", "E", "J", "P", "G"] as const;
+
 /** Generate a random valid Venezuelan RIF. */
 const generate = (): string => {
-  const types = ["V", "E", "J", "P", "G"] as const;
-  const prefix = types[randomInt(0, types.length - 1)]!;
+  const prefix = randomPick(GENERATE_TYPES);
   const body = randomDigits(8);
   return (
     prefix + body + String(calcCheckDigit(prefix, body))

package/src/za/idnr.ts

@@ -132,7 +132,7 @@ const generate = (): string => {
 };
 
 /** South African Identity Number. */
-const idnr: Validator = {
+const idnr: Validator<ParsedPersonId> = {
   name: "South African Identity Number",
   localName: "South African Identity Number",
   abbreviation: "SA ID",
@@ -142,6 +142,7 @@ const idnr: Validator = {
   entityType: "person",
   compact,
   format,
+  parse,
   validate,
   description:
     "South African personal identification number",