@stll/stdnum 0.0.1 → 2.0.0

package/dist/ua/edrpou.js

@@ -3,17 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/ua/edrpou.ts
-/**
-* EDRPOU (ЄДРПОУ, Unified State Register of
-* Enterprises and Organizations of Ukraine).
-*
-* 8-digit company identification number with a
-* weighted checksum. Two sets of weights are used
-* depending on whether the first digit is 0-2/6-9 or 3-5.
-*
-* @see https://en.wikipedia.org/wiki/EDRPOU
-* @see https://usr.minjust.gov.ua/
-*/
 const WEIGHTS_A = [
 	1,
 	2,
@@ -52,7 +41,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, " -");
@@ -87,6 +79,7 @@ const edrpou = {
 	abbreviation: "ЄДРПОУ",
 	aliases: ["ЄДРПОУ", "EDRPOU"],
 	candidatePattern: "\\d{8}",
+	scope: "country",
 	country: "UA",
 	entityType: "company",
 	lengths: [8],

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 type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\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: CountryValidator<\"UA\"> = {\n  name: \"Ukrainian Company Register Number\",\n  localName: \"ЄДРПОУ\",\n  abbreviation: \"ЄДРПОУ\",\n  aliases: [\"ЄДРПОУ\", \"EDRPOU\"] as const,\n  candidatePattern: \"\\\\d{8}\",\n  scope: \"country\",\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":";;;;;AAsBA,MAAM,YAAY;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;AACtC,MAAM,YAAY;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;AACtC,MAAM,aAAa;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;AACvC,MAAM,aAAa;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;AAEvC,MAAM,aACJ,OACA,YACW;CACX,IAAI,MAAM;CACV,KAAK,MAAM,CAAC,GAAG,WAAW,QAAQ,QAAQ,GAAG;EAC3C,IAAI,KAAK,GAAG;EACZ,OAAO,OAAO,MAAM,EAAE,IAAI;CAC5B;CACA,OAAO,MAAM;AACf;AAEA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;AAEnB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,GACf,OAAO,IACL,kBACA,iCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,iCACF;CAGF,MAAM,aAAa,OAAO,EAAE,EAAE;CAC9B,MAAM,OAAO,aAAa,KAAK,cAAc;CAC7C,MAAM,eAAe,OAAO,YAAY;CACxC,MAAM,gBAAgB,OAAO,aAAa;CAE1C,IAAI,QAAQ,UAAU,GAAG,YAAY;CACrC,IAAI,SAAS,IACX,QAAQ,UAAU,GAAG,aAAa,IAAI;CAGxC,IAAI,UAAU,OAAO,EAAE,EAAE,GACvB,OAAO,IACL,oBACA,6BACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,iBAAyB;CAC7B,SAAS;EACP,MAAM,IAAI,aAAa,CAAC;EACxB,IAAI,SAAS,CAAC,EAAE,OAAO,OAAO;CAChC;AACF;;AAGA,MAAM,SAAiC;CACrC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,UAAU,QAAQ;CAC5B,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,CAAC;CACX,WAAW;CACX,UAAU,CAAC,UAAU;CACrB;CACA;CACA;CACA;AACF"}

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.d.ts

@@ -1,13 +1,23 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/us/ein.d.ts
 /** Generate a random valid U.S. EIN. */
 declare const generate: () => string;
+/**
+ * EIN (U.S. Employer Identification Number).
+ *
+ * 9-digit identifier: 2-digit campus prefix +
+ * 7-digit group. No checksum. The first 2 digits
+ * must be a valid IRS campus code.
+ *
+ * @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
+ */
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** U.S. Employer Identification Number. */
-declare const ein: Validator;
+declare const ein: CountryValidator<"US">;
 //#endregion
 export { compact, ein as default, format, generate, validate };
 //# sourceMappingURL=ein.d.ts.map

package/dist/us/ein.js

@@ -1,106 +1,96 @@
 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
-/**
-* EIN (U.S. Employer Identification Number).
-*
-* 9-digit identifier: 2-digit campus prefix +
-* 7-digit group. No checksum. The first 2 digits
-* must be a valid IRS campus code.
-*
-* @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
@@ -219,6 +209,7 @@ const ein = {
 		"Federal Tax ID"
 	],
 	candidatePattern: "\\d{2}-?\\d{7}",
+	scope: "country",
 	country: "US",
 	entityType: "company",
 	sourceUrl: "https://www.irs.gov/businesses/small-businesses-self-employed/how-eins-are-assigned-and-valid-ein-prefixes",

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 type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomPick } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\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: CountryValidator<\"US\"> = {\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  scope: \"country\",\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;AACF;;AAGA,MAAM,iBAAyB;CAE7B,OADe,WAAW,YACd,IAAI,aAAa,CAAC;AAChC;;;;;AA2BA,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;AACF,CAAC;AAED,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;AAEnB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,8BACF;CAEF,IAAI,EAAE,WAAW,GACf,OAAO,IAAI,kBAAkB,sBAAsB;CAErD,MAAM,SAAS,EAAE,MAAM,GAAG,CAAC;CAC3B,IAAI,CAAC,eAAe,IAAI,MAAM,GAC5B,OAAO,IACL,qBACA,8BACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,GACf,OAAO,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC;CAEtC,OAAO;AACT;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;CACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WACE;CACF,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;AACF"}

package/dist/us/itin.d.ts

@@ -1,15 +1,26 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/us/itin.d.ts
 /** Generate a random valid U.S. ITIN. */
 declare const generate: () => string;
+/**
+ * ITIN (U.S. Individual Taxpayer Identification
+ * Number).
+ *
+ * 9-digit number issued by the IRS to individuals
+ * who need a taxpayer ID but are not eligible for
+ * an SSN. Starts with 9; digits 4-5 (the "group")
+ * must be in the range 70-99 excluding 89 and 93.
+ *
+ * @see https://www.irs.gov/individuals/individual-taxpayer-identification-number
+ */
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /**
  * U.S. Individual Taxpayer Identification Number.
  */
-declare const itin: Validator;
+declare const itin: CountryValidator<"US">;
 //#endregion
 export { compact, itin as default, format, generate, validate };
 //# sourceMappingURL=itin.d.ts.map

package/dist/us/itin.js

@@ -1,24 +1,12 @@
 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
-/**
-* ITIN (U.S. Individual Taxpayer Identification
-* Number).
-*
-* 9-digit number issued by the IRS to individuals
-* who need a taxpayer ID but are not eligible for
-* an SSN. Starts with 9; digits 4-5 (the "group")
-* must be in the range 70-99 excluding 89 and 93.
-*
-* @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. */
@@ -53,6 +41,7 @@ const itin = {
 	abbreviation: "ITIN",
 	aliases: ["ITIN", "Individual Taxpayer Identification Number"],
 	candidatePattern: "9\\d{2}[\\s-]?\\d{2}[\\s-]?\\d{4}",
+	scope: "country",
 	country: "US",
 	entityType: "person",
 	sourceUrl: "https://www.irs.gov/individuals/individual-taxpayer-identification-number",

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 type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomPick } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\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: CountryValidator<\"US\"> = {\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  scope: \"country\",\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,GAAG,IACZ,GAAG,MAAM,IAAI,EAChB,EAAE,QAAQ,MAAM,MAAM,MAAM,MAAM,EAAE;;AAGpC,MAAM,iBAAyB;CAI7B,OAAO,GAHM,MAAM,aAAa,CAAC,IACnB,OAAO,WAAW,mBAAmB,CAE9B,IADN,aAAa,CACE;AAChC;AAwBA,MAAM,UAAU;;AAGhB,MAAM,iBAAiB,IAAI,IACzB,MAAM,KAAK,EAAE,QAAQ,GAAG,IAAI,GAAG,MAAM,IAAI,EAAE,EACxC,QAAQ,MAAM,MAAM,MAAM,MAAM,EAAE,EAClC,IAAI,MAAM,CACf;AAEA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;AAEnB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,+BACF;CAEF,IAAI,EAAE,WAAW,GACf,OAAO,IAAI,kBAAkB,uBAAuB;CAGtD,MAAM,QAAQ,QAAQ,KAAK,CAAC;CAC5B,IAAI,CAAC,OAAO,QACV,OAAO,IACL,kBACA,4DAEF;CAGF,MAAM,EAAE,MAAM,UAAU,MAAM;CAC9B,IAAI,CAAC,QAAQ,CAAC,OACZ,OAAO,IAAI,kBAAkB,uBAAuB;CAGtD,IAAI,KAAK,OAAO,KACd,OAAO,IACL,qBACA,6BACF;CAGF,IAAI,CAAC,eAAe,IAAI,KAAK,GAC3B,OAAO,IACL,qBACA,qEAEF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,GACf,OACE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAA,GAAU,EAAE,MAAM,CAAC;CAGvD,OAAO;AACT;;;;AAKA,MAAM,OAA+B;CACnC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,QACA,2CACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WACE;CAEF,SAAS,CAAC,CAAC;CACX,UAAU,CAAC,aAAa;CACxB;CACA;CACA;CACA;AACF"}

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,14 +1,13 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } 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;
 /** Generate a random valid U.S. RTN. */
 declare const generate: () => string;
 /** U.S. Routing Transit Number. */
-declare const rtn: Validator;
+declare const rtn: CountryValidator<"US">;
 //#endregion
 export { compact, rtn as default, format, generate, validate };
 //# sourceMappingURL=rtn.d.ts.map

package/dist/us/rtn.js

@@ -1,24 +1,8 @@
 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
-/**
-* RTN (Routing Transit Number / ABA Number).
-*
-* 9-digit number used by U.S. financial institutions
-* for routing wire transfers, ACH, and check
-* processing. Uses a weighted checksum with weights
-* [3, 7, 1] repeated three times.
-*
-* The first two digits identify the Federal Reserve
-* district (01-12) or special ranges (21-32 for
-* thrifts, 61-72 for electronic, 80 for traveler's
-* cheques).
-*
-* @see https://en.wikipedia.org/wiki/ABA_routing_transit_number
-* @see https://www.frbservices.org/
-*/
 const WEIGHTS = [
 	3,
 	7,
@@ -36,9 +20,9 @@ const validate = (value) => {
 	if (v.length !== 9) return err("INVALID_LENGTH", "RTN must be 9 digits");
 	if (!isdigits(v)) return err("INVALID_FORMAT", "RTN must contain only digits");
 	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");
+	if (!(prefix >= 0 && 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,
@@ -48,17 +32,20 @@ const validate = (value) => {
 const format = (value) => compact(value);
 /** All valid Federal Reserve prefix ranges. */
 const PREFIX_RANGES = [
-	[1, 12],
+	[0, 12],
 	[21, 32],
 	[61, 72],
 	[80, 80]
 ];
 /** 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);
 };
@@ -75,6 +62,7 @@ const rtn = {
 		"Routing Transit Number"
 	],
 	candidatePattern: "\\d{9}",
+	scope: "country",
 	country: "US",
 	entityType: "company",
 	sourceUrl: "https://en.wikipedia.org/wiki/ABA_routing_transit_number",

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 (00 for U.S.\n * Government, 21-32 for thrifts, 61-72 for electronic,\n * 80 for traveler's cheques).\n *\n * @see https://en.wikipedia.org/wiki/ABA_routing_transit_number\n * @see https://www.frbservices.org/\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\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\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    // 00 is reserved for U.S. Government and federal\n    // agencies per the ABA Routing Number Policy;\n    // 01-12 are the 12 Federal Reserve districts.\n    // @see https://en.wikipedia.org/wiki/ABA_routing_transit_number\n    (prefix >= 0 && 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  [0, 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: CountryValidator<\"US\"> = {\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  scope: \"country\",\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":";;;;;AA+BA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;AAE1C,MAAM,WAAW,UACf,MAAM,OAAO,IAAI,EAAE,KAAK;AAE1B,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CAEvB,IAAI,EAAE,WAAW,GACf,OAAO,IAAI,kBAAkB,sBAAsB;CAGrD,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,8BACF;CAIF,MAAM,SAAS,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAUnC,IAAI,EAJD,UAAU,KAAK,UAAU,MACzB,UAAU,MAAM,UAAU,MAC1B,UAAU,MAAM,UAAU,MAC3B,WAAW,KAEX,OAAO,IACL,qBACA,6CACF;CAIF,IAAI,MAAM;CACV,KAAK,MAAM,CAAC,GAAG,WAAW,QAAQ,QAAQ,GACxC,OAAO,OAAO,EAAE,EAAE,IAAI;CAExB,IAAI,MAAM,OAAO,GACf,OAAO,IACL,oBACA,yBACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,gBAA6C;CACjD,CAAC,GAAG,EAAE;CACN,CAAC,IAAI,EAAE;CACP,CAAC,IAAI,EAAE;CACP,CAAC,IAAI,EAAE;AACT;;AAGA,MAAM,iBAAyB;CAC7B,MAAM,CAAC,KAAK,QAAQ,WAAW,aAAa;CAM5C,MAAM,OALS,OAAO,UAAU,KAAK,IAAI,CAAC,EAAE,SAC1C,GACA,GAGgB,IADN,aAAa,CACD;CACxB,IAAI,MAAM;CACV,KAAK,MAAM,CAAC,GAAG,WAAW,QAAQ,QAAQ,GAAG;EAC3C,IAAI,KAAK,GAAG;EACZ,OAAO,OAAO,KAAK,EAAE,IAAI;CAC3B;CACA,MAAM,SAAS,KAAM,MAAM,MAAO;CAClC,OAAO,OAAO,OAAO,KAAK;AAC5B;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACA;EACA;CACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WACE;CACF,SAAS,CAAC,CAAC;CACX,UAAU,CAAC,aAAa,WAAW;CACnC;CACA;CACA;CACA;AACF"}

package/dist/us/ssn.d.ts

@@ -1,13 +1,24 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/us/ssn.d.ts
 /** Generate a random valid U.S. SSN. */
 declare const generate: () => string;
+/**
+ * SSN (U.S. Social Security Number).
+ *
+ * 9-digit identifier: 3-digit area, 2-digit group,
+ * 4-digit serial. No checksum. Area cannot be 000,
+ * 666, or 900-999; group cannot be 00; serial
+ * cannot be 0000.
+ *
+ * @see https://en.wikipedia.org/wiki/Social_Security_number
+ * @see https://www.ssa.gov/employer/verifySSN.htm
+ */
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** U.S. Social Security Number. */
-declare const ssn: Validator;
+declare const ssn: CountryValidator<"US">;
 //#endregion
 export { compact, ssn as default, format, generate, validate };
 //# sourceMappingURL=ssn.d.ts.map

package/dist/us/ssn.js

@@ -3,17 +3,6 @@ import { randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/us/ssn.ts
-/**
-* SSN (U.S. Social Security Number).
-*
-* 9-digit identifier: 3-digit area, 2-digit group,
-* 4-digit serial. No checksum. Area cannot be 000,
-* 666, or 900-999; group cannot be 00; serial
-* cannot be 0000.
-*
-* @see https://en.wikipedia.org/wiki/Social_Security_number
-* @see https://www.ssa.gov/employer/verifySSN.htm
-*/
 /** Generate a random valid U.S. SSN. */
 const generate = () => {
 	for (;;) {
@@ -62,6 +51,7 @@ const ssn = {
 	abbreviation: "SSN",
 	aliases: ["SSN", "Social Security Number"],
 	candidatePattern: "\\d{3}-?\\d{2}-?\\d{4}",
+	scope: "country",
 	country: "US",
 	entityType: "person",
 	sourceUrl: "https://www.ssa.gov/employer/verifySSN.htm",