@stll/stdnum 0.0.1 → 1.0.0

package/dist/types.d.ts

@@ -17,24 +17,25 @@ type ValidateResult = {
   error: StdnumError;
 };
 /**
- * Structured data extracted from a personal ID number.
- * Returned by `parse()` on validators that encode
- * birth date and gender.
+ * Structured data extracted from an identifier that
+ * encodes a birth date.
  */
-type ParsedPersonId = {
+type ParsedBirthDate = {
   birthDate: Date;
+};
+/**
+ * Structured data extracted from a personal ID number
+ * that also encodes gender.
+ */
+type ParsedPersonId = ParsedBirthDate & {
   gender: "male" | "female";
 };
-type Validator = {
-  /** English name. */
-  name: string;
-  /** Name in the local language. */
-  localName: string;
-  /** Common abbreviation (e.g. "IČO"). */
-  abbreviation: string;
-  /** Country this identifier belongs to. */
-  country?: CountryCode;
-  /** What kind of entity this identifies. */
+type ParsedIdentifier = ParsedBirthDate | ParsedPersonId;
+type Validator<TParsed extends ParsedIdentifier | undefined = undefined> = {
+  /** English name. */name: string; /** Name in the local language. */
+  localName: string; /** Common abbreviation (e.g. "IČO"). */
+  abbreviation: string; /** Country this identifier belongs to. */
+  country?: CountryCode; /** What kind of entity this identifies. */
   entityType: "person" | "company" | "any";
   /**
    * Strip separators and normalize to a
@@ -51,12 +52,9 @@ type Validator = {
    * compact form on success, or an error
    * with a code and message on failure.
    */
-  validate: (value: string) => ValidateResult;
-  /** One-liner describing the identifier. */
-  description?: string;
-  /** URL to official authority or spec page. */
-  sourceUrl?: string;
-  /** Valid lengths of the compact form. */
+  validate: (value: string) => ValidateResult; /** One-liner describing the identifier. */
+  description?: string; /** URL to official authority or spec page. */
+  sourceUrl?: string; /** Valid lengths of the compact form. */
   lengths?: readonly number[];
   /**
    * Known-valid compact values. Useful as test
@@ -89,7 +87,22 @@ type Validator = {
    * passed to validate() for confirmation.
    */
   candidatePattern?: string;
-};
+  /**
+   * Extract structured data (e.g. birth date,
+   * gender) from a known-valid identifier.
+   * Available on personal IDs that encode such
+   * data. Returns null if the input cannot be
+   * parsed.
+   *
+   * On the base `Validator` type this is optional
+   * with a widened return; narrow it by typing the
+   * validator as `Validator<ParsedPersonId>` etc.
+   */
+  parse?: (value: string) => ParsedIdentifier | null;
+} & ([TParsed] extends [undefined] ? unknown : {
+  parse: (value: string) => TParsed | null;
+});
+type ParsableValidator<TParsed extends ParsedIdentifier = ParsedIdentifier> = Validator<TParsed>;
 //#endregion
-export { CountryCode, ErrorCode, ParsedPersonId, StdnumError, ValidateResult, Validator };
+export { CountryCode, ErrorCode, ParsableValidator, ParsedBirthDate, ParsedIdentifier, ParsedPersonId, StdnumError, ValidateResult, Validator };
 //# sourceMappingURL=types.d.ts.map

package/dist/ua/edrpou.d.ts

@@ -1,7 +1,6 @@
 import { ValidateResult, Validator } from "../types.js";
 
 //#region src/ua/edrpou.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;

package/dist/ua/edrpou.js

@@ -52,7 +52,10 @@ const WEIGHTS_B2 = [
 ];
 const calcCheck = (value, weights) => {
 	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;
 };
 const compact = (value) => clean(value, " -");

package/dist/ua/edrpou.js.map

@@ -1 +1 @@
-{"version":3,"file":"edrpou.js","names":[],"sources":["../../src/ua/edrpou.ts"],"sourcesContent":["/**\n * EDRPOU (ЄДРПОУ, Unified State Register of\n * Enterprises and Organizations of Ukraine).\n *\n * 8-digit company identification number with a\n * weighted checksum. Two sets of weights are used\n * depending on whether the first digit is 0-2/6-9 or 3-5.\n *\n * @see https://en.wikipedia.org/wiki/EDRPOU\n * @see https://usr.minjust.gov.ua/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst WEIGHTS_A = [1, 2, 3, 4, 5, 6, 7] as const;\nconst WEIGHTS_B = [7, 1, 2, 3, 4, 5, 6] as const;\nconst WEIGHTS_A2 = [3, 4, 5, 6, 7, 8, 9] as const;\nconst WEIGHTS_B2 = [9, 3, 4, 5, 6, 7, 8] as const;\n\nconst calcCheck = (\n  value: string,\n  weights: readonly number[],\n): number => {\n  let sum = 0;\n  for (let i = 0; i < 7; i++) {\n    sum += Number(value[i]) * weights[i]!;\n  }\n  return sum % 11;\n};\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 8) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"EDRPOU must be exactly 8 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"EDRPOU must contain only digits\",\n    );\n  }\n\n  const firstDigit = Number(v[0]);\n  const useA = firstDigit < 3 || firstDigit >= 6;\n  const weightsFirst = useA ? WEIGHTS_A : WEIGHTS_B;\n  const weightsSecond = useA ? WEIGHTS_A2 : WEIGHTS_B2;\n\n  let check = calcCheck(v, weightsFirst);\n  if (check >= 10) {\n    check = calcCheck(v, weightsSecond) % 10;\n  }\n\n  if (check !== Number(v[7])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"EDRPOU check digit mismatch\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Ukrainian EDRPOU. */\nconst generate = (): string => {\n  for (;;) {\n    const c = randomDigits(8);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Ukrainian Company Register Number. */\nconst edrpou: Validator = {\n  name: \"Ukrainian Company Register Number\",\n  localName: \"ЄДРПОУ\",\n  abbreviation: \"ЄДРПОУ\",\n  aliases: [\"ЄДРПОУ\", \"EDRPOU\"] as const,\n  candidatePattern: \"\\\\d{8}\",\n  country: \"UA\",\n  entityType: \"company\",\n  lengths: [8] as const,\n  sourceUrl: \"https://usr.minjust.gov.ua/\",\n  examples: [\"14360570\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default edrpou;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;AAmBA,MAAM,YAAY;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AACvC,MAAM,YAAY;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AACvC,MAAM,aAAa;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AACxC,MAAM,aAAa;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AAExC,MAAM,aACJ,OACA,YACW;CACX,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,QAAO,OAAO,MAAM,GAAG,GAAG,QAAQ;AAEpC,QAAO,MAAM;;AAGf,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,kCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,kCACD;CAGH,MAAM,aAAa,OAAO,EAAE,GAAG;CAC/B,MAAM,OAAO,aAAa,KAAK,cAAc;CAC7C,MAAM,eAAe,OAAO,YAAY;CACxC,MAAM,gBAAgB,OAAO,aAAa;CAE1C,IAAI,QAAQ,UAAU,GAAG,aAAa;AACtC,KAAI,SAAS,GACX,SAAQ,UAAU,GAAG,cAAc,GAAG;AAGxC,KAAI,UAAU,OAAO,EAAE,GAAG,CACxB,QAAO,IACL,oBACA,8BACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,IAAI,aAAa,EAAE;AACzB,MAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;AAKlC,MAAM,SAAoB;CACxB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,UAAU,SAAS;CAC7B,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,EAAE;CACZ,WAAW;CACX,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"edrpou.js","names":[],"sources":["../../src/ua/edrpou.ts"],"sourcesContent":["/**\n * EDRPOU (ЄДРПОУ, Unified State Register of\n * Enterprises and Organizations of Ukraine).\n *\n * 8-digit company identification number with a\n * weighted checksum. Two sets of weights are used\n * depending on whether the first digit is 0-2/6-9 or 3-5.\n *\n * @see https://en.wikipedia.org/wiki/EDRPOU\n * @see https://usr.minjust.gov.ua/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst WEIGHTS_A = [1, 2, 3, 4, 5, 6, 7] as const;\nconst WEIGHTS_B = [7, 1, 2, 3, 4, 5, 6] as const;\nconst WEIGHTS_A2 = [3, 4, 5, 6, 7, 8, 9] as const;\nconst WEIGHTS_B2 = [9, 3, 4, 5, 6, 7, 8] as const;\n\nconst calcCheck = (\n  value: string,\n  weights: readonly number[],\n): number => {\n  let sum = 0;\n  for (const [i, weight] of weights.entries()) {\n    if (i >= 7) break;\n    sum += Number(value[i]) * weight;\n  }\n  return sum % 11;\n};\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 8) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"EDRPOU must be exactly 8 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"EDRPOU must contain only digits\",\n    );\n  }\n\n  const firstDigit = Number(v[0]);\n  const useA = firstDigit < 3 || firstDigit >= 6;\n  const weightsFirst = useA ? WEIGHTS_A : WEIGHTS_B;\n  const weightsSecond = useA ? WEIGHTS_A2 : WEIGHTS_B2;\n\n  let check = calcCheck(v, weightsFirst);\n  if (check >= 10) {\n    check = calcCheck(v, weightsSecond) % 10;\n  }\n\n  if (check !== Number(v[7])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"EDRPOU check digit mismatch\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Ukrainian EDRPOU. */\nconst generate = (): string => {\n  for (;;) {\n    const c = randomDigits(8);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Ukrainian Company Register Number. */\nconst edrpou: Validator = {\n  name: \"Ukrainian Company Register Number\",\n  localName: \"ЄДРПОУ\",\n  abbreviation: \"ЄДРПОУ\",\n  aliases: [\"ЄДРПОУ\", \"EDRPOU\"] as const,\n  candidatePattern: \"\\\\d{8}\",\n  country: \"UA\",\n  entityType: \"company\",\n  lengths: [8] as const,\n  sourceUrl: \"https://usr.minjust.gov.ua/\",\n  examples: [\"14360570\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default edrpou;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;AAmBA,MAAM,YAAY;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AACvC,MAAM,YAAY;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AACvC,MAAM,aAAa;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AACxC,MAAM,aAAa;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AAExC,MAAM,aACJ,OACA,YACW;CACX,IAAI,MAAM;AACV,MAAK,MAAM,CAAC,GAAG,WAAW,QAAQ,SAAS,EAAE;AAC3C,MAAI,KAAK,EAAG;AACZ,SAAO,OAAO,MAAM,GAAG,GAAG;;AAE5B,QAAO,MAAM;;AAGf,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,kCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,kCACD;CAGH,MAAM,aAAa,OAAO,EAAE,GAAG;CAC/B,MAAM,OAAO,aAAa,KAAK,cAAc;CAC7C,MAAM,eAAe,OAAO,YAAY;CACxC,MAAM,gBAAgB,OAAO,aAAa;CAE1C,IAAI,QAAQ,UAAU,GAAG,aAAa;AACtC,KAAI,SAAS,GACX,SAAQ,UAAU,GAAG,cAAc,GAAG;AAGxC,KAAI,UAAU,OAAO,EAAE,GAAG,CACxB,QAAO,IACL,oBACA,8BACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,IAAI,aAAa,EAAE;AACzB,MAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;AAKlC,MAAM,SAAoB;CACxB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,UAAU,SAAS;CAC7B,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,EAAE;CACZ,WAAW;CACX,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;CACD"}

package/dist/ua/mod.d.ts

@@ -1,8 +1,9 @@
-import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import edrpou from "./edrpou.js";
 
 //#region src/ua/mod.d.ts
-
+declare namespace mod_d_exports {
+  export { edrpou };
+}
 //#endregion
 export { edrpou, mod_d_exports };
 //# sourceMappingURL=mod.d.ts.map

package/dist/us/ein.js

@@ -1,5 +1,5 @@
 import { clean } from "../_util/clean.js";
-import { randomDigits, randomInt } from "../_util/generate.js";
+import { randomDigits, randomPick } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/us/ein.ts
@@ -13,94 +13,94 @@ import { isdigits } from "../_util/strings.js";
 * @see https://en.wikipedia.org/wiki/Employer_Identification_Number
 * @see https://www.irs.gov/businesses/small-businesses-self-employed/how-eins-are-assigned-and-valid-ein-prefixes
 */
+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"
+];
 /** Generate a random valid U.S. EIN. */
 const generate = () => {
-	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"
-	];
-	return prefixes[randomInt(0, prefixes.length - 1)] + randomDigits(7);
+	return randomPick(EIN_PREFIXES) + randomDigits(7);
 };
 /**
 * Valid EIN campus prefixes. Sourced from IRS

package/dist/us/ein.js.map

@@ -1 +1 @@
-{"version":3,"file":"ein.js","names":[],"sources":["../../src/us/ein.ts"],"sourcesContent":["/** Generate a random valid U.S. EIN. */\nconst generate = (): string => {\n  const prefixes = [\n    \"01\",\n    \"02\",\n    \"03\",\n    \"04\",\n    \"05\",\n    \"06\",\n    \"10\",\n    \"11\",\n    \"12\",\n    \"13\",\n    \"14\",\n    \"15\",\n    \"16\",\n    \"20\",\n    \"21\",\n    \"22\",\n    \"23\",\n    \"24\",\n    \"25\",\n    \"26\",\n    \"27\",\n    \"30\",\n    \"31\",\n    \"32\",\n    \"33\",\n    \"34\",\n    \"35\",\n    \"36\",\n    \"37\",\n    \"38\",\n    \"39\",\n    \"40\",\n    \"41\",\n    \"42\",\n    \"43\",\n    \"44\",\n    \"45\",\n    \"46\",\n    \"47\",\n    \"48\",\n    \"50\",\n    \"51\",\n    \"52\",\n    \"53\",\n    \"54\",\n    \"55\",\n    \"56\",\n    \"57\",\n    \"58\",\n    \"59\",\n    \"60\",\n    \"61\",\n    \"62\",\n    \"63\",\n    \"64\",\n    \"65\",\n    \"66\",\n    \"67\",\n    \"68\",\n    \"71\",\n    \"72\",\n    \"73\",\n    \"74\",\n    \"75\",\n    \"76\",\n    \"77\",\n    \"80\",\n    \"81\",\n    \"82\",\n    \"83\",\n    \"84\",\n    \"85\",\n    \"86\",\n    \"87\",\n    \"88\",\n    \"90\",\n    \"91\",\n    \"92\",\n    \"93\",\n    \"94\",\n    \"95\",\n    \"98\",\n    \"99\",\n  ];\n  const prefix =\n    prefixes[randomInt(0, prefixes.length - 1)]!;\n  return prefix + randomDigits(7);\n};\n\n/**\n * EIN (U.S. Employer Identification Number).\n *\n * 9-digit identifier: 2-digit campus prefix +\n * 7-digit group. No checksum. The first 2 digits\n * must be a valid IRS campus code.\n *\n * @see https://en.wikipedia.org/wiki/Employer_Identification_Number\n * @see https://www.irs.gov/businesses/small-businesses-self-employed/how-eins-are-assigned-and-valid-ein-prefixes\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\n/**\n * Valid EIN campus prefixes. Sourced from IRS\n * documentation and python-stdnum's numdb.\n */\nconst VALID_PREFIXES = new Set([\n  \"01\",\n  \"02\",\n  \"03\",\n  \"04\",\n  \"05\",\n  \"06\",\n  \"10\",\n  \"11\",\n  \"12\",\n  \"13\",\n  \"14\",\n  \"15\",\n  \"16\",\n  \"20\",\n  \"21\",\n  \"22\",\n  \"23\",\n  \"24\",\n  \"25\",\n  \"26\",\n  \"27\",\n  \"30\",\n  \"31\",\n  \"32\",\n  \"33\",\n  \"34\",\n  \"35\",\n  \"36\",\n  \"37\",\n  \"38\",\n  \"39\",\n  \"40\",\n  \"41\",\n  \"42\",\n  \"43\",\n  \"44\",\n  \"45\",\n  \"46\",\n  \"47\",\n  \"48\",\n  \"50\",\n  \"51\",\n  \"52\",\n  \"53\",\n  \"54\",\n  \"55\",\n  \"56\",\n  \"57\",\n  \"58\",\n  \"59\",\n  \"60\",\n  \"61\",\n  \"62\",\n  \"63\",\n  \"64\",\n  \"65\",\n  \"66\",\n  \"67\",\n  \"68\",\n  \"71\",\n  \"72\",\n  \"73\",\n  \"74\",\n  \"75\",\n  \"76\",\n  \"77\",\n  \"80\",\n  \"81\",\n  \"82\",\n  \"83\",\n  \"84\",\n  \"85\",\n  \"86\",\n  \"87\",\n  \"88\",\n  \"90\",\n  \"91\",\n  \"92\",\n  \"93\",\n  \"94\",\n  \"95\",\n  \"98\",\n  \"99\",\n]);\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"EIN must contain only digits\",\n    );\n  }\n  if (v.length !== 9) {\n    return err(\"INVALID_LENGTH\", \"EIN must be 9 digits\");\n  }\n  const prefix = v.slice(0, 2);\n  if (!VALID_PREFIXES.has(prefix)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"EIN campus prefix is invalid\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length === 9) {\n    return `${v.slice(0, 2)}-${v.slice(2)}`;\n  }\n  return v;\n};\n\n/** U.S. Employer Identification Number. */\nconst ein: Validator = {\n  name: \"Employer Identification Number\",\n  localName: \"Employer Identification Number\",\n  abbreviation: \"EIN\",\n  aliases: [\n    \"EIN\",\n    \"Employer Identification Number\",\n    \"Federal Tax ID\",\n  ] as const,\n  candidatePattern: \"\\\\d{2}-?\\\\d{7}\",\n  country: \"US\",\n  entityType: \"company\",\n  sourceUrl:\n    \"https://www.irs.gov/businesses/small-businesses-self-employed/how-eins-are-assigned-and-valid-ein-prefixes\",\n  examples: [\"042103594\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ein;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;AACA,MAAM,iBAAyB;CAC7B,MAAM,WAAW;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD;AAGD,QADE,SAAS,UAAU,GAAG,SAAS,SAAS,EAAE,IAC5B,aAAa,EAAE;;;;;;AAyBjC,MAAM,iBAAiB,IAAI,IAAI;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;AAEH,KAAI,EAAE,WAAW,EACf,QAAO,IAAI,kBAAkB,uBAAuB;CAEtD,MAAM,SAAS,EAAE,MAAM,GAAG,EAAE;AAC5B,KAAI,CAAC,eAAe,IAAI,OAAO,CAC7B,QAAO,IACL,qBACA,+BACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;AAEvC,QAAO;;;AAIT,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WACE;CACF,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"ein.js","names":[],"sources":["../../src/us/ein.ts"],"sourcesContent":["const EIN_PREFIXES = [\n  \"01\",\n  \"02\",\n  \"03\",\n  \"04\",\n  \"05\",\n  \"06\",\n  \"10\",\n  \"11\",\n  \"12\",\n  \"13\",\n  \"14\",\n  \"15\",\n  \"16\",\n  \"20\",\n  \"21\",\n  \"22\",\n  \"23\",\n  \"24\",\n  \"25\",\n  \"26\",\n  \"27\",\n  \"30\",\n  \"31\",\n  \"32\",\n  \"33\",\n  \"34\",\n  \"35\",\n  \"36\",\n  \"37\",\n  \"38\",\n  \"39\",\n  \"40\",\n  \"41\",\n  \"42\",\n  \"43\",\n  \"44\",\n  \"45\",\n  \"46\",\n  \"47\",\n  \"48\",\n  \"50\",\n  \"51\",\n  \"52\",\n  \"53\",\n  \"54\",\n  \"55\",\n  \"56\",\n  \"57\",\n  \"58\",\n  \"59\",\n  \"60\",\n  \"61\",\n  \"62\",\n  \"63\",\n  \"64\",\n  \"65\",\n  \"66\",\n  \"67\",\n  \"68\",\n  \"71\",\n  \"72\",\n  \"73\",\n  \"74\",\n  \"75\",\n  \"76\",\n  \"77\",\n  \"80\",\n  \"81\",\n  \"82\",\n  \"83\",\n  \"84\",\n  \"85\",\n  \"86\",\n  \"87\",\n  \"88\",\n  \"90\",\n  \"91\",\n  \"92\",\n  \"93\",\n  \"94\",\n  \"95\",\n  \"98\",\n  \"99\",\n] as const;\n\n/** Generate a random valid U.S. EIN. */\nconst generate = (): string => {\n  const prefix = randomPick(EIN_PREFIXES);\n  return prefix + randomDigits(7);\n};\n\n/**\n * EIN (U.S. Employer Identification Number).\n *\n * 9-digit identifier: 2-digit campus prefix +\n * 7-digit group. No checksum. The first 2 digits\n * must be a valid IRS campus code.\n *\n * @see https://en.wikipedia.org/wiki/Employer_Identification_Number\n * @see https://www.irs.gov/businesses/small-businesses-self-employed/how-eins-are-assigned-and-valid-ein-prefixes\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomPick } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\n/**\n * Valid EIN campus prefixes. Sourced from IRS\n * documentation and python-stdnum's numdb.\n */\nconst VALID_PREFIXES = new Set([\n  \"01\",\n  \"02\",\n  \"03\",\n  \"04\",\n  \"05\",\n  \"06\",\n  \"10\",\n  \"11\",\n  \"12\",\n  \"13\",\n  \"14\",\n  \"15\",\n  \"16\",\n  \"20\",\n  \"21\",\n  \"22\",\n  \"23\",\n  \"24\",\n  \"25\",\n  \"26\",\n  \"27\",\n  \"30\",\n  \"31\",\n  \"32\",\n  \"33\",\n  \"34\",\n  \"35\",\n  \"36\",\n  \"37\",\n  \"38\",\n  \"39\",\n  \"40\",\n  \"41\",\n  \"42\",\n  \"43\",\n  \"44\",\n  \"45\",\n  \"46\",\n  \"47\",\n  \"48\",\n  \"50\",\n  \"51\",\n  \"52\",\n  \"53\",\n  \"54\",\n  \"55\",\n  \"56\",\n  \"57\",\n  \"58\",\n  \"59\",\n  \"60\",\n  \"61\",\n  \"62\",\n  \"63\",\n  \"64\",\n  \"65\",\n  \"66\",\n  \"67\",\n  \"68\",\n  \"71\",\n  \"72\",\n  \"73\",\n  \"74\",\n  \"75\",\n  \"76\",\n  \"77\",\n  \"80\",\n  \"81\",\n  \"82\",\n  \"83\",\n  \"84\",\n  \"85\",\n  \"86\",\n  \"87\",\n  \"88\",\n  \"90\",\n  \"91\",\n  \"92\",\n  \"93\",\n  \"94\",\n  \"95\",\n  \"98\",\n  \"99\",\n]);\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"EIN must contain only digits\",\n    );\n  }\n  if (v.length !== 9) {\n    return err(\"INVALID_LENGTH\", \"EIN must be 9 digits\");\n  }\n  const prefix = v.slice(0, 2);\n  if (!VALID_PREFIXES.has(prefix)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"EIN campus prefix is invalid\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length === 9) {\n    return `${v.slice(0, 2)}-${v.slice(2)}`;\n  }\n  return v;\n};\n\n/** U.S. Employer Identification Number. */\nconst ein: Validator = {\n  name: \"Employer Identification Number\",\n  localName: \"Employer Identification Number\",\n  abbreviation: \"EIN\",\n  aliases: [\n    \"EIN\",\n    \"Employer Identification Number\",\n    \"Federal Tax ID\",\n  ] as const,\n  candidatePattern: \"\\\\d{2}-?\\\\d{7}\",\n  country: \"US\",\n  entityType: \"company\",\n  sourceUrl:\n    \"https://www.irs.gov/businesses/small-businesses-self-employed/how-eins-are-assigned-and-valid-ein-prefixes\",\n  examples: [\"042103594\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ein;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;AAAA,MAAM,eAAe;CACnB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;AAGD,MAAM,iBAAyB;AAE7B,QADe,WAAW,aAAa,GACvB,aAAa,EAAE;;;;;;AAyBjC,MAAM,iBAAiB,IAAI,IAAI;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;AAEH,KAAI,EAAE,WAAW,EACf,QAAO,IAAI,kBAAkB,uBAAuB;CAEtD,MAAM,SAAS,EAAE,MAAM,GAAG,EAAE;AAC5B,KAAI,CAAC,eAAe,IAAI,OAAO,CAC7B,QAAO,IACL,qBACA,+BACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;AAEvC,QAAO;;;AAIT,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WACE;CACF,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;CACD"}

package/dist/us/itin.js

@@ -1,5 +1,5 @@
 import { clean } from "../_util/clean.js";
-import { randomDigits, randomInt } from "../_util/generate.js";
+import { randomDigits, randomPick } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/us/itin.ts
@@ -14,11 +14,10 @@ import { isdigits } from "../_util/strings.js";
 *
 * @see https://www.irs.gov/individuals/individual-taxpayer-identification-number
 */
+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 = () => {
-	const area = "9" + randomDigits(2);
-	const allowed = Array.from({ length: 30 }, (_, i) => i + 70).filter((g) => g !== 89 && g !== 93);
-	return `${area}${String(allowed[randomInt(0, allowed.length - 1)])}${randomDigits(4)}`;
+	return `${"9" + randomDigits(2)}${String(randomPick(ITIN_ALLOWED_GROUPS))}${randomDigits(4)}`;
 };
 const ITIN_RE = /^(?<area>\d{3})-?(?<group>\d{2})-?\d{4}$/;
 /** Groups 70-99 excluding 89 and 93. */

package/dist/us/itin.js.map

@@ -1 +1 @@
-{"version":3,"file":"itin.js","names":[],"sources":["../../src/us/itin.ts"],"sourcesContent":["/** Generate a random valid U.S. ITIN. */\nconst generate = (): string => {\n  const area = \"9\" + randomDigits(2);\n  const allowed = Array.from(\n    { length: 30 },\n    (_, i) => i + 70,\n  ).filter((g) => g !== 89 && g !== 93);\n  const group = String(\n    allowed[randomInt(0, allowed.length - 1)]!,\n  );\n  const serial = randomDigits(4);\n  return `${area}${group}${serial}`;\n};\n\n/**\n * ITIN (U.S. Individual Taxpayer Identification\n * Number).\n *\n * 9-digit number issued by the IRS to individuals\n * who need a taxpayer ID but are not eligible for\n * an SSN. Starts with 9; digits 4-5 (the \"group\")\n * must be in the range 70-99 excluding 89 and 93.\n *\n * @see https://www.irs.gov/individuals/individual-taxpayer-identification-number\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst ITIN_RE = /^(?<area>\\d{3})-?(?<group>\\d{2})-?\\d{4}$/;\n\n/** Groups 70-99 excluding 89 and 93. */\nconst ALLOWED_GROUPS = new Set(\n  Array.from({ length: 30 }, (_, i) => i + 70)\n    .filter((g) => g !== 89 && g !== 93)\n    .map(String),\n);\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"ITIN must contain only digits\",\n    );\n  }\n  if (v.length !== 9) {\n    return err(\"INVALID_LENGTH\", \"ITIN must be 9 digits\");\n  }\n\n  const match = ITIN_RE.exec(v);\n  if (!match?.groups) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"ITIN must be 9 digits, optionally \" +\n        \"formatted as NNN-NN-NNNN\",\n    );\n  }\n\n  const { area, group } = match.groups;\n  if (!area || !group) {\n    return err(\"INVALID_FORMAT\", \"ITIN must be 9 digits\");\n  }\n\n  if (area[0] !== \"9\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"ITIN area must start with 9\",\n    );\n  }\n\n  if (!ALLOWED_GROUPS.has(group)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"ITIN group digits are not in the \" +\n        \"allowed range (70-99 excl. 89, 93)\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length === 9) {\n    return (\n      `${v.slice(0, 3)}-${v.slice(3, 5)}` + `-${v.slice(5)}`\n    );\n  }\n  return v;\n};\n\n/**\n * U.S. Individual Taxpayer Identification Number.\n */\nconst itin: Validator = {\n  name: \"Individual Taxpayer Identification Number\",\n  localName: \"Individual Taxpayer Identification Number\",\n  abbreviation: \"ITIN\",\n  aliases: [\n    \"ITIN\",\n    \"Individual Taxpayer Identification Number\",\n  ] as const,\n  candidatePattern: \"9\\\\d{2}[\\\\s-]?\\\\d{2}[\\\\s-]?\\\\d{4}\",\n  country: \"US\",\n  entityType: \"person\",\n  sourceUrl:\n    \"https://www.irs.gov/individuals/\" +\n    \"individual-taxpayer-identification-number\",\n  lengths: [9] as const,\n  examples: [\"912-90-3456\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default itin;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;AACA,MAAM,iBAAyB;CAC7B,MAAM,OAAO,MAAM,aAAa,EAAE;CAClC,MAAM,UAAU,MAAM,KACpB,EAAE,QAAQ,IAAI,GACb,GAAG,MAAM,IAAI,GACf,CAAC,QAAQ,MAAM,MAAM,MAAM,MAAM,GAAG;AAKrC,QAAO,GAAG,OAJI,OACZ,QAAQ,UAAU,GAAG,QAAQ,SAAS,EAAE,EACzC,GACc,aAAa,EAAE;;AAuBhC,MAAM,UAAU;;AAGhB,MAAM,iBAAiB,IAAI,IACzB,MAAM,KAAK,EAAE,QAAQ,IAAI,GAAG,GAAG,MAAM,IAAI,GAAG,CACzC,QAAQ,MAAM,MAAM,MAAM,MAAM,GAAG,CACnC,IAAI,OAAO,CACf;AAED,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,gCACD;AAEH,KAAI,EAAE,WAAW,EACf,QAAO,IAAI,kBAAkB,wBAAwB;CAGvD,MAAM,QAAQ,QAAQ,KAAK,EAAE;AAC7B,KAAI,CAAC,OAAO,OACV,QAAO,IACL,kBACA,6DAED;CAGH,MAAM,EAAE,MAAM,UAAU,MAAM;AAC9B,KAAI,CAAC,QAAQ,CAAC,MACZ,QAAO,IAAI,kBAAkB,wBAAwB;AAGvD,KAAI,KAAK,OAAO,IACd,QAAO,IACL,qBACA,8BACD;AAGH,KAAI,CAAC,eAAe,IAAI,MAAM,CAC5B,QAAO,IACL,qBACA,sEAED;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QACE,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAA,GAAS,EAAE,MAAM,EAAE;AAGxD,QAAO;;;;;AAMT,MAAM,OAAkB;CACtB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,QACA,4CACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WACE;CAEF,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,cAAc;CACzB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"itin.js","names":[],"sources":["../../src/us/itin.ts"],"sourcesContent":["const ITIN_ALLOWED_GROUPS = Array.from(\n  { length: 30 },\n  (_, i) => i + 70,\n).filter((g) => g !== 89 && g !== 93);\n\n/** Generate a random valid U.S. ITIN. */\nconst generate = (): string => {\n  const area = \"9\" + randomDigits(2);\n  const group = String(randomPick(ITIN_ALLOWED_GROUPS));\n  const serial = randomDigits(4);\n  return `${area}${group}${serial}`;\n};\n\n/**\n * ITIN (U.S. Individual Taxpayer Identification\n * Number).\n *\n * 9-digit number issued by the IRS to individuals\n * who need a taxpayer ID but are not eligible for\n * an SSN. Starts with 9; digits 4-5 (the \"group\")\n * must be in the range 70-99 excluding 89 and 93.\n *\n * @see https://www.irs.gov/individuals/individual-taxpayer-identification-number\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomPick } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst ITIN_RE = /^(?<area>\\d{3})-?(?<group>\\d{2})-?\\d{4}$/;\n\n/** Groups 70-99 excluding 89 and 93. */\nconst ALLOWED_GROUPS = new Set(\n  Array.from({ length: 30 }, (_, i) => i + 70)\n    .filter((g) => g !== 89 && g !== 93)\n    .map(String),\n);\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"ITIN must contain only digits\",\n    );\n  }\n  if (v.length !== 9) {\n    return err(\"INVALID_LENGTH\", \"ITIN must be 9 digits\");\n  }\n\n  const match = ITIN_RE.exec(v);\n  if (!match?.groups) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"ITIN must be 9 digits, optionally \" +\n        \"formatted as NNN-NN-NNNN\",\n    );\n  }\n\n  const { area, group } = match.groups;\n  if (!area || !group) {\n    return err(\"INVALID_FORMAT\", \"ITIN must be 9 digits\");\n  }\n\n  if (area[0] !== \"9\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"ITIN area must start with 9\",\n    );\n  }\n\n  if (!ALLOWED_GROUPS.has(group)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"ITIN group digits are not in the \" +\n        \"allowed range (70-99 excl. 89, 93)\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length === 9) {\n    return (\n      `${v.slice(0, 3)}-${v.slice(3, 5)}` + `-${v.slice(5)}`\n    );\n  }\n  return v;\n};\n\n/**\n * U.S. Individual Taxpayer Identification Number.\n */\nconst itin: Validator = {\n  name: \"Individual Taxpayer Identification Number\",\n  localName: \"Individual Taxpayer Identification Number\",\n  abbreviation: \"ITIN\",\n  aliases: [\n    \"ITIN\",\n    \"Individual Taxpayer Identification Number\",\n  ] as const,\n  candidatePattern: \"9\\\\d{2}[\\\\s-]?\\\\d{2}[\\\\s-]?\\\\d{4}\",\n  country: \"US\",\n  entityType: \"person\",\n  sourceUrl:\n    \"https://www.irs.gov/individuals/\" +\n    \"individual-taxpayer-identification-number\",\n  lengths: [9] as const,\n  examples: [\"912-90-3456\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default itin;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;AAAA,MAAM,sBAAsB,MAAM,KAChC,EAAE,QAAQ,IAAI,GACb,GAAG,MAAM,IAAI,GACf,CAAC,QAAQ,MAAM,MAAM,MAAM,MAAM,GAAG;;AAGrC,MAAM,iBAAyB;AAI7B,QAAO,GAHM,MAAM,aAAa,EAAE,GACpB,OAAO,WAAW,oBAAoB,CAAC,GACtC,aAAa,EAAE;;AAuBhC,MAAM,UAAU;;AAGhB,MAAM,iBAAiB,IAAI,IACzB,MAAM,KAAK,EAAE,QAAQ,IAAI,GAAG,GAAG,MAAM,IAAI,GAAG,CACzC,QAAQ,MAAM,MAAM,MAAM,MAAM,GAAG,CACnC,IAAI,OAAO,CACf;AAED,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,gCACD;AAEH,KAAI,EAAE,WAAW,EACf,QAAO,IAAI,kBAAkB,wBAAwB;CAGvD,MAAM,QAAQ,QAAQ,KAAK,EAAE;AAC7B,KAAI,CAAC,OAAO,OACV,QAAO,IACL,kBACA,6DAED;CAGH,MAAM,EAAE,MAAM,UAAU,MAAM;AAC9B,KAAI,CAAC,QAAQ,CAAC,MACZ,QAAO,IAAI,kBAAkB,wBAAwB;AAGvD,KAAI,KAAK,OAAO,IACd,QAAO,IACL,qBACA,8BACD;AAGH,KAAI,CAAC,eAAe,IAAI,MAAM,CAC5B,QAAO,IACL,qBACA,sEAED;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QACE,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAA,GAAS,EAAE,MAAM,EAAE;AAGxD,QAAO;;;;;AAMT,MAAM,OAAkB;CACtB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,QACA,4CACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WACE;CAEF,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,cAAc;CACzB;CACA;CACA;CACA;CACD"}

package/dist/us/mod.d.ts

@@ -1,11 +1,12 @@
-import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import ein from "./ein.js";
 import itin from "./itin.js";
 import rtn from "./rtn.js";
 import ssn from "./ssn.js";
 
 //#region src/us/mod.d.ts
-
+declare namespace mod_d_exports {
+  export { ein, itin, rtn, ssn };
+}
 //#endregion
 export { ein, itin, mod_d_exports, rtn, ssn };
 //# sourceMappingURL=mod.d.ts.map

package/dist/us/rtn.d.ts

@@ -1,7 +1,6 @@
 import { ValidateResult, Validator } from "../types.js";
 
 //#region src/us/rtn.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;

package/dist/us/rtn.js

@@ -1,5 +1,5 @@
 import { clean } from "../_util/clean.js";
-import { randomDigits, randomInt } from "../_util/generate.js";
+import { randomDigits, randomInt, randomPick } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/us/rtn.ts
@@ -38,7 +38,7 @@ const validate = (value) => {
 	const prefix = Number(v.slice(0, 2));
 	if (!(prefix >= 1 && prefix <= 12 || prefix >= 21 && prefix <= 32 || prefix >= 61 && prefix <= 72 || prefix === 80)) return err("INVALID_COMPONENT", "RTN has an invalid Federal Reserve district");
 	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("INVALID_CHECKSUM", "RTN checksum is invalid");
 	return {
 		valid: true,
@@ -55,10 +55,13 @@ const PREFIX_RANGES = [
 ];
 /** Generate a random valid U.S. RTN. */
 const generate = () => {
-	const range = PREFIX_RANGES[randomInt(0, PREFIX_RANGES.length - 1)];
-	const body = String(randomInt(range[0], range[1])).padStart(2, "0") + randomDigits(6);
+	const [low, high] = randomPick(PREFIX_RANGES);
+	const body = String(randomInt(low, high)).padStart(2, "0") + randomDigits(6);
 	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/dist/us/rtn.js.map

@@ -1 +1 @@
-{"version":3,"file":"rtn.js","names":[],"sources":["../../src/us/rtn.ts"],"sourcesContent":["/**\n * RTN (Routing Transit Number / ABA Number).\n *\n * 9-digit number used by U.S. financial institutions\n * for routing wire transfers, ACH, and check\n * processing. Uses a weighted checksum with weights\n * [3, 7, 1] repeated three times.\n *\n * The first two digits identify the Federal Reserve\n * district (01-12) or special ranges (21-32 for\n * thrifts, 61-72 for electronic, 80 for traveler's\n * cheques).\n *\n * @see https://en.wikipedia.org/wiki/ABA_routing_transit_number\n * @see https://www.frbservices.org/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst WEIGHTS = [3, 7, 1, 3, 7, 1, 3, 7, 1];\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").trim();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 9) {\n    return err(\"INVALID_LENGTH\", \"RTN must be 9 digits\");\n  }\n\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RTN must contain only digits\",\n    );\n  }\n\n  // Validate Federal Reserve prefix (first 2 digits)\n  const prefix = Number(v.slice(0, 2));\n  const validPrefixRanges =\n    (prefix >= 1 && prefix <= 12) ||\n    (prefix >= 21 && prefix <= 32) ||\n    (prefix >= 61 && prefix <= 72) ||\n    prefix === 80;\n  if (!validPrefixRanges) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RTN has an invalid Federal Reserve district\",\n    );\n  }\n\n  // Weighted checksum must be divisible by 10\n  let sum = 0;\n  for (let i = 0; i < 9; i++) {\n    sum += Number(v[i]) * WEIGHTS[i]!;\n  }\n  if (sum % 10 !== 0) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RTN checksum is invalid\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** All valid Federal Reserve prefix ranges. */\nconst PREFIX_RANGES: readonly [number, number][] = [\n  [1, 12],\n  [21, 32],\n  [61, 72],\n  [80, 80],\n];\n\n/** Generate a random valid U.S. RTN. */\nconst generate = (): string => {\n  const range =\n    PREFIX_RANGES[randomInt(0, PREFIX_RANGES.length - 1)]!;\n  const prefix = String(\n    randomInt(range[0], range[1]),\n  ).padStart(2, \"0\");\n  const mid = randomDigits(6);\n  const body = prefix + mid;\n  let sum = 0;\n  for (let i = 0; i < 8; i++) {\n    sum += Number(body[i]) * WEIGHTS[i]!;\n  }\n  const check = (10 - (sum % 10)) % 10;\n  return body + String(check);\n};\n\n/** U.S. Routing Transit Number. */\nconst rtn: Validator = {\n  name: \"Routing Transit Number\",\n  localName: \"Routing Transit Number\",\n  abbreviation: \"RTN\",\n  aliases: [\n    \"RTN\",\n    \"ABA\",\n    \"Routing Number\",\n    \"ABA Routing Number\",\n    \"Routing Transit Number\",\n  ] as const,\n  candidatePattern: \"\\\\d{9}\",\n  country: \"US\",\n  entityType: \"company\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/ABA_routing_transit_number\",\n  lengths: [9] as const,\n  examples: [\"111000025\", \"021000021\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default rtn;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAwBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AAE3C,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,MAAM;AAE3B,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,EACf,QAAO,IAAI,kBAAkB,uBAAuB;AAGtD,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;CAIH,MAAM,SAAS,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;AAMpC,KAAI,EAJD,UAAU,KAAK,UAAU,MACzB,UAAU,MAAM,UAAU,MAC1B,UAAU,MAAM,UAAU,MAC3B,WAAW,IAEX,QAAO,IACL,qBACA,8CACD;CAIH,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,QAAO,OAAO,EAAE,GAAG,GAAG,QAAQ;AAEhC,KAAI,MAAM,OAAO,EACf,QAAO,IACL,oBACA,0BACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,gBAA6C;CACjD,CAAC,GAAG,GAAG;CACP,CAAC,IAAI,GAAG;CACR,CAAC,IAAI,GAAG;CACR,CAAC,IAAI,GAAG;CACT;;AAGD,MAAM,iBAAyB;CAC7B,MAAM,QACJ,cAAc,UAAU,GAAG,cAAc,SAAS,EAAE;CAKtD,MAAM,OAJS,OACb,UAAU,MAAM,IAAI,MAAM,GAAG,CAC9B,CAAC,SAAS,GAAG,IAAI,GACN,aAAa,EAAE;CAE3B,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,QAAO,OAAO,KAAK,GAAG,GAAG,QAAQ;CAEnC,MAAM,SAAS,KAAM,MAAM,MAAO;AAClC,QAAO,OAAO,OAAO,MAAM;;;AAI7B,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WACE;CACF,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,aAAa,YAAY;CACpC;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"rtn.js","names":[],"sources":["../../src/us/rtn.ts"],"sourcesContent":["/**\n * RTN (Routing Transit Number / ABA Number).\n *\n * 9-digit number used by U.S. financial institutions\n * for routing wire transfers, ACH, and check\n * processing. Uses a weighted checksum with weights\n * [3, 7, 1] repeated three times.\n *\n * The first two digits identify the Federal Reserve\n * district (01-12) or special ranges (21-32 for\n * thrifts, 61-72 for electronic, 80 for traveler's\n * cheques).\n *\n * @see https://en.wikipedia.org/wiki/ABA_routing_transit_number\n * @see https://www.frbservices.org/\n */\n\nimport { clean } from \"#util/clean\";\nimport {\n  randomDigits,\n  randomInt,\n  randomPick,\n} from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst WEIGHTS = [3, 7, 1, 3, 7, 1, 3, 7, 1] as const;\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").trim();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 9) {\n    return err(\"INVALID_LENGTH\", \"RTN must be 9 digits\");\n  }\n\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RTN must contain only digits\",\n    );\n  }\n\n  // Validate Federal Reserve prefix (first 2 digits)\n  const prefix = Number(v.slice(0, 2));\n  const validPrefixRanges =\n    (prefix >= 1 && prefix <= 12) ||\n    (prefix >= 21 && prefix <= 32) ||\n    (prefix >= 61 && prefix <= 72) ||\n    prefix === 80;\n  if (!validPrefixRanges) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RTN has an invalid Federal Reserve district\",\n    );\n  }\n\n  // Weighted checksum must be divisible by 10\n  let sum = 0;\n  for (const [i, weight] of WEIGHTS.entries()) {\n    sum += Number(v[i]) * weight;\n  }\n  if (sum % 10 !== 0) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RTN checksum is invalid\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** All valid Federal Reserve prefix ranges. */\nconst PREFIX_RANGES: readonly [number, number][] = [\n  [1, 12],\n  [21, 32],\n  [61, 72],\n  [80, 80],\n];\n\n/** Generate a random valid U.S. RTN. */\nconst generate = (): string => {\n  const [low, high] = randomPick(PREFIX_RANGES);\n  const prefix = String(randomInt(low, high)).padStart(\n    2,\n    \"0\",\n  );\n  const mid = randomDigits(6);\n  const body = prefix + mid;\n  let sum = 0;\n  for (const [i, weight] of WEIGHTS.entries()) {\n    if (i >= 8) break;\n    sum += Number(body[i]) * weight;\n  }\n  const check = (10 - (sum % 10)) % 10;\n  return body + String(check);\n};\n\n/** U.S. Routing Transit Number. */\nconst rtn: Validator = {\n  name: \"Routing Transit Number\",\n  localName: \"Routing Transit Number\",\n  abbreviation: \"RTN\",\n  aliases: [\n    \"RTN\",\n    \"ABA\",\n    \"Routing Number\",\n    \"ABA Routing Number\",\n    \"Routing Transit Number\",\n  ] as const,\n  candidatePattern: \"\\\\d{9}\",\n  country: \"US\",\n  entityType: \"company\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/ABA_routing_transit_number\",\n  lengths: [9] as const,\n  examples: [\"111000025\", \"021000021\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default rtn;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA4BA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AAE3C,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,MAAM;AAE3B,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,EACf,QAAO,IAAI,kBAAkB,uBAAuB;AAGtD,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;CAIH,MAAM,SAAS,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;AAMpC,KAAI,EAJD,UAAU,KAAK,UAAU,MACzB,UAAU,MAAM,UAAU,MAC1B,UAAU,MAAM,UAAU,MAC3B,WAAW,IAEX,QAAO,IACL,qBACA,8CACD;CAIH,IAAI,MAAM;AACV,MAAK,MAAM,CAAC,GAAG,WAAW,QAAQ,SAAS,CACzC,QAAO,OAAO,EAAE,GAAG,GAAG;AAExB,KAAI,MAAM,OAAO,EACf,QAAO,IACL,oBACA,0BACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,gBAA6C;CACjD,CAAC,GAAG,GAAG;CACP,CAAC,IAAI,GAAG;CACR,CAAC,IAAI,GAAG;CACR,CAAC,IAAI,GAAG;CACT;;AAGD,MAAM,iBAAyB;CAC7B,MAAM,CAAC,KAAK,QAAQ,WAAW,cAAc;CAM7C,MAAM,OALS,OAAO,UAAU,KAAK,KAAK,CAAC,CAAC,SAC1C,GACA,IACD,GACW,aAAa,EAAE;CAE3B,IAAI,MAAM;AACV,MAAK,MAAM,CAAC,GAAG,WAAW,QAAQ,SAAS,EAAE;AAC3C,MAAI,KAAK,EAAG;AACZ,SAAO,OAAO,KAAK,GAAG,GAAG;;CAE3B,MAAM,SAAS,KAAM,MAAM,MAAO;AAClC,QAAO,OAAO,OAAO,MAAM;;;AAI7B,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WACE;CACF,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,aAAa,YAAY;CACpC;CACA;CACA;CACA;CACD"}

package/dist/uy/mod.d.ts

@@ -1,8 +1,9 @@
-import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import rut from "./rut.js";
 
 //#region src/uy/mod.d.ts
-
+declare namespace mod_d_exports {
+  export { rut };
+}
 //#endregion
 export { mod_d_exports, rut };
 //# sourceMappingURL=mod.d.ts.map

package/dist/uy/rut.d.ts

@@ -1,7 +1,6 @@
 import { ValidateResult, Validator } from "../types.js";
 
 //#region src/uy/rut.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;

package/dist/uy/rut.js

@@ -42,7 +42,7 @@ const compact = (value) => {
 const pymod = (a, b) => (a % b + b) % b;
 const calcCheckDigit = (value) => {
 	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);
 	if (result === 10) return null;
 	return String(result);

package/dist/uy/rut.js.map

@@ -1 +1 @@
-{"version":3,"file":"rut.js","names":[],"sources":["../../src/uy/rut.ts"],"sourcesContent":["/**\n * RUT (Registro Único Tributario).\n *\n * Uruguayan tax identification number issued by the\n * DGI (Dirección General Impositiva). The number is\n * 12 digits: 2-digit document type (01-22), 6-digit\n * sequence, fixed \"001\" suffix, and a check digit\n * computed via weighted sum mod 11 (Python-style\n * modulo of the negated sum).\n *\n * Format: ############  (12 digits compact)\n *\n * @see https://www.agesic.gub.uy/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst WEIGHTS = [4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2] as const;\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -\").trim();\n  if (v.toUpperCase().startsWith(\"UY\")) {\n    v = v.slice(2);\n  }\n  return v;\n};\n\n/**\n * Python-style modulo: always returns a non-negative\n * result for a positive divisor.\n */\nconst pymod = (a: number, b: number): number =>\n  ((a % b) + b) % b;\n\nconst calcCheckDigit = (value: string): string | null => {\n  let sum = 0;\n  for (let i = 0; i < 11; i++) {\n    sum += Number(value[i]) * WEIGHTS[i]!;\n  }\n  const result = pymod(-sum, 11);\n  // A result of 10 means no valid single-digit check\n  // digit exists; the DGI does not issue such numbers.\n  if (result === 10) return null;\n  return String(result);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 12) {\n    return err(\"INVALID_LENGTH\", \"RUT must be 12 digits\");\n  }\n\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RUT must contain only digits\",\n    );\n  }\n\n  // First 2 digits: document type (01-22)\n  const docType = Number.parseInt(v.slice(0, 2), 10);\n  if (docType < 1 || docType > 22) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RUT document type must be between 01 and 22\",\n    );\n  }\n\n  // Digits 2-8: sequence (must not be all zeros)\n  if (v.slice(2, 8) === \"000000\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RUT sequence must not be all zeros\",\n    );\n  }\n\n  // Digits 8-11: must be \"001\"\n  if (v.slice(8, 11) !== \"001\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RUT branch code must be 001\",\n    );\n  }\n\n  const expected = calcCheckDigit(v);\n  if (expected === null || v.at(-1) !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RUT check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 2)}-${v.slice(2, 8)}-${v.slice(8, 11)}-${v.slice(11)}`;\n};\n\n/** Generate a random valid Uruguayan RUT. */\nconst generate = (): string => {\n  for (;;) {\n    const docType = String(randomInt(1, 22)).padStart(\n      2,\n      \"0\",\n    );\n    const seq = randomDigits(6);\n    if (seq === \"000000\") continue;\n    const partial = `${docType}${seq}001`;\n    const check = calcCheckDigit(partial);\n    if (check === null) continue;\n    return `${partial}${check}`;\n  }\n};\n\n/**\n * Uruguayan RUT (tax identification number).\n *\n * Examples sourced from python-stdnum test suite.\n */\nconst rut: Validator = {\n  name: \"Uruguayan Tax ID\",\n  localName: \"Registro Único Tributario\",\n  abbreviation: \"RUT\",\n  aliases: [\"RUT\", \"Registro Único Tributario\"] as const,\n  candidatePattern: \"\\\\d{12}\",\n  country: \"UY\",\n  entityType: \"any\",\n  lengths: [12] as const,\n  examples: [\"010100010013\", \"102000010017\"] as const,\n  compact,\n  format,\n  validate,\n  sourceUrl: \"https://www.agesic.gub.uy/\",\n  generate,\n};\n\nexport default rut;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAsBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AAEjD,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,KAAK,CAAC,MAAM;AACjC,KAAI,EAAE,aAAa,CAAC,WAAW,KAAK,CAClC,KAAI,EAAE,MAAM,EAAE;AAEhB,QAAO;;;;;;AAOT,MAAM,SAAS,GAAW,OACtB,IAAI,IAAK,KAAK;AAElB,MAAM,kBAAkB,UAAiC;CACvD,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,IACtB,QAAO,OAAO,MAAM,GAAG,GAAG,QAAQ;CAEpC,MAAM,SAAS,MAAM,CAAC,KAAK,GAAG;AAG9B,KAAI,WAAW,GAAI,QAAO;AAC1B,QAAO,OAAO,OAAO;;AAGvB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,GACf,QAAO,IAAI,kBAAkB,wBAAwB;AAGvD,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;CAIH,MAAM,UAAU,OAAO,SAAS,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG;AAClD,KAAI,UAAU,KAAK,UAAU,GAC3B,QAAO,IACL,qBACA,8CACD;AAIH,KAAI,EAAE,MAAM,GAAG,EAAE,KAAK,SACpB,QAAO,IACL,qBACA,qCACD;AAIH,KAAI,EAAE,MAAM,GAAG,GAAG,KAAK,MACrB,QAAO,IACL,qBACA,8BACD;CAGH,MAAM,WAAW,eAAe,EAAE;AAClC,KAAI,aAAa,QAAQ,EAAE,GAAG,GAAG,KAAK,SACpC,QAAO,IACL,oBACA,iCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG;;;AAI3E,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,UAAU,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,SACvC,GACA,IACD;EACD,MAAM,MAAM,aAAa,EAAE;AAC3B,MAAI,QAAQ,SAAU;EACtB,MAAM,UAAU,GAAG,UAAU,IAAI;EACjC,MAAM,QAAQ,eAAe,QAAQ;AACrC,MAAI,UAAU,KAAM;AACpB,SAAO,GAAG,UAAU;;;;;;;;AASxB,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,4BAA4B;CAC7C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,gBAAgB,eAAe;CAC1C;CACA;CACA;CACA,WAAW;CACX;CACD"}
+{"version":3,"file":"rut.js","names":[],"sources":["../../src/uy/rut.ts"],"sourcesContent":["/**\n * RUT (Registro Único Tributario).\n *\n * Uruguayan tax identification number issued by the\n * DGI (Dirección General Impositiva). The number is\n * 12 digits: 2-digit document type (01-22), 6-digit\n * sequence, fixed \"001\" suffix, and a check digit\n * computed via weighted sum mod 11 (Python-style\n * modulo of the negated sum).\n *\n * Format: ############  (12 digits compact)\n *\n * @see https://www.agesic.gub.uy/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst WEIGHTS = [4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2] as const;\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -\").trim();\n  if (v.toUpperCase().startsWith(\"UY\")) {\n    v = v.slice(2);\n  }\n  return v;\n};\n\n/**\n * Python-style modulo: always returns a non-negative\n * result for a positive divisor.\n */\nconst pymod = (a: number, b: number): number =>\n  ((a % b) + b) % b;\n\nconst calcCheckDigit = (value: string): string | null => {\n  let sum = 0;\n  for (const [i, weight] of WEIGHTS.entries()) {\n    sum += Number(value[i]) * weight;\n  }\n  const result = pymod(-sum, 11);\n  // A result of 10 means no valid single-digit check\n  // digit exists; the DGI does not issue such numbers.\n  if (result === 10) return null;\n  return String(result);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 12) {\n    return err(\"INVALID_LENGTH\", \"RUT must be 12 digits\");\n  }\n\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RUT must contain only digits\",\n    );\n  }\n\n  // First 2 digits: document type (01-22)\n  const docType = Number.parseInt(v.slice(0, 2), 10);\n  if (docType < 1 || docType > 22) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RUT document type must be between 01 and 22\",\n    );\n  }\n\n  // Digits 2-8: sequence (must not be all zeros)\n  if (v.slice(2, 8) === \"000000\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RUT sequence must not be all zeros\",\n    );\n  }\n\n  // Digits 8-11: must be \"001\"\n  if (v.slice(8, 11) !== \"001\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RUT branch code must be 001\",\n    );\n  }\n\n  const expected = calcCheckDigit(v);\n  if (expected === null || v.at(-1) !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RUT check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 2)}-${v.slice(2, 8)}-${v.slice(8, 11)}-${v.slice(11)}`;\n};\n\n/** Generate a random valid Uruguayan RUT. */\nconst generate = (): string => {\n  for (;;) {\n    const docType = String(randomInt(1, 22)).padStart(\n      2,\n      \"0\",\n    );\n    const seq = randomDigits(6);\n    if (seq === \"000000\") continue;\n    const partial = `${docType}${seq}001`;\n    const check = calcCheckDigit(partial);\n    if (check === null) continue;\n    return `${partial}${check}`;\n  }\n};\n\n/**\n * Uruguayan RUT (tax identification number).\n *\n * Examples sourced from python-stdnum test suite.\n */\nconst rut: Validator = {\n  name: \"Uruguayan Tax ID\",\n  localName: \"Registro Único Tributario\",\n  abbreviation: \"RUT\",\n  aliases: [\"RUT\", \"Registro Único Tributario\"] as const,\n  candidatePattern: \"\\\\d{12}\",\n  country: \"UY\",\n  entityType: \"any\",\n  lengths: [12] as const,\n  examples: [\"010100010013\", \"102000010017\"] as const,\n  compact,\n  format,\n  validate,\n  sourceUrl: \"https://www.agesic.gub.uy/\",\n  generate,\n};\n\nexport default rut;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAsBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AAEjD,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,KAAK,CAAC,MAAM;AACjC,KAAI,EAAE,aAAa,CAAC,WAAW,KAAK,CAClC,KAAI,EAAE,MAAM,EAAE;AAEhB,QAAO;;;;;;AAOT,MAAM,SAAS,GAAW,OACtB,IAAI,IAAK,KAAK;AAElB,MAAM,kBAAkB,UAAiC;CACvD,IAAI,MAAM;AACV,MAAK,MAAM,CAAC,GAAG,WAAW,QAAQ,SAAS,CACzC,QAAO,OAAO,MAAM,GAAG,GAAG;CAE5B,MAAM,SAAS,MAAM,CAAC,KAAK,GAAG;AAG9B,KAAI,WAAW,GAAI,QAAO;AAC1B,QAAO,OAAO,OAAO;;AAGvB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,GACf,QAAO,IAAI,kBAAkB,wBAAwB;AAGvD,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;CAIH,MAAM,UAAU,OAAO,SAAS,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG;AAClD,KAAI,UAAU,KAAK,UAAU,GAC3B,QAAO,IACL,qBACA,8CACD;AAIH,KAAI,EAAE,MAAM,GAAG,EAAE,KAAK,SACpB,QAAO,IACL,qBACA,qCACD;AAIH,KAAI,EAAE,MAAM,GAAG,GAAG,KAAK,MACrB,QAAO,IACL,qBACA,8BACD;CAGH,MAAM,WAAW,eAAe,EAAE;AAClC,KAAI,aAAa,QAAQ,EAAE,GAAG,GAAG,KAAK,SACpC,QAAO,IACL,oBACA,iCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG;;;AAI3E,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,UAAU,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,SACvC,GACA,IACD;EACD,MAAM,MAAM,aAAa,EAAE;AAC3B,MAAI,QAAQ,SAAU;EACtB,MAAM,UAAU,GAAG,UAAU,IAAI;EACjC,MAAM,QAAQ,eAAe,QAAQ;AACrC,MAAI,UAAU,KAAM;AACpB,SAAO,GAAG,UAAU;;;;;;;;AASxB,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,4BAA4B;CAC7C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,gBAAgB,eAAe;CAC1C;CACA;CACA;CACA,WAAW;CACX;CACD"}

package/dist/ve/mod.d.ts

@@ -1,8 +1,9 @@
-import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import rif from "./rif.js";
 
 //#region src/ve/mod.d.ts
-
+declare namespace mod_d_exports {
+  export { rif };
+}
 //#endregion
 export { mod_d_exports, rif };
 //# sourceMappingURL=mod.d.ts.map

package/dist/ve/rif.d.ts

@@ -1,7 +1,6 @@
 import { ValidateResult, Validator } from "../types.js";
 
 //#region src/ve/rif.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;

package/dist/ve/rif.js

@@ -1,5 +1,5 @@
 import { clean } from "../_util/clean.js";
-import { randomDigits, randomInt } from "../_util/generate.js";
+import { randomDigits, randomPick } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/ve/rif.ts
@@ -46,9 +46,9 @@ const WEIGHTS = [
 const CHECK_LOOKUP = "00987654321";
 const compact = (value) => clean(value, " -.").trim().toUpperCase();
 const calcCheckDigit = (prefix, body) => {
-	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;
 	return CHECK_LOOKUP[(pv + sum % 11) % 11];
 };
 const validate = (value) => {
@@ -69,16 +69,16 @@ const format = (value) => {
 	const v = compact(value);
 	return `${v[0]}-${v.slice(1, 9)}-${v.slice(9)}`;
 };
+const GENERATE_TYPES = [
+	"V",
+	"E",
+	"J",
+	"P",
+	"G"
+];
 /** Generate a random valid Venezuelan RIF. */
 const generate = () => {
-	const types = [
-		"V",
-		"E",
-		"J",
-		"P",
-		"G"
-	];
-	const prefix = types[randomInt(0, types.length - 1)];
+	const prefix = randomPick(GENERATE_TYPES);
 	const body = randomDigits(8);
 	return prefix + body + String(calcCheckDigit(prefix, body));
 };