@stll/stdnum 1.0.0 → 2.0.0

package/dist/th/tin.js

@@ -3,17 +3,6 @@ import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/th/tin.ts
-/**
-* TIN (Thai Tax Identification Number,
-* เลขประจำตัวผู้เสียภาษี).
-*
-* 13 digits. Individual TINs have first digit 1-8;
-* company TINs (MOA) start with 0. Both use a
-* weighted mod-11 check digit.
-*
-* @see https://www.rd.go.th/
-* @see https://en.wikipedia.org/wiki/Thai_identity_card
-*/
 const compact = (value) => clean(value, " -");
 const validate = (value) => {
 	const v = compact(value);
@@ -46,6 +35,7 @@ const tin = {
 	abbreviation: "TIN",
 	aliases: ["เลขประจำตัวผู้เสียภาษี", "TIN"],
 	candidatePattern: "\\d{13}",
+	scope: "country",
 	country: "TH",
 	entityType: "any",
 	description: "13-digit tax identifier for individuals and companies",

package/dist/th/tin.js.map

@@ -1 +1 @@
-{"version":3,"file":"tin.js","names":[],"sources":["../../src/th/tin.ts"],"sourcesContent":["/**\n * TIN (Thai Tax Identification Number,\n * เลขประจำตัวผู้เสียภาษี).\n *\n * 13 digits. Individual TINs have first digit 1-8;\n * company TINs (MOA) start with 0. Both use a\n * weighted mod-11 check digit.\n *\n * @see https://www.rd.go.th/\n * @see https://en.wikipedia.org/wiki/Thai_identity_card\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 compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"TIN must be exactly 13 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"TIN must contain only digits\",\n    );\n  }\n\n  // First digit: 1-8 for individuals, 0 for companies\n  const first = Number(v[0]);\n  if (first > 8) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"TIN first digit must be 0-8\",\n    );\n  }\n\n  // Mod-11 check digit (position 13)\n  let sum = 0;\n  for (let i = 0; i < 12; i++) {\n    sum += Number(v[i]) * (13 - i);\n  }\n  const check = (11 - (sum % 11)) % 10;\n  if (check !== Number(v[12])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"TIN 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 (\n    `${v[0]} ${v.slice(1, 5)} ` +\n    `${v.slice(5, 10)} ${v.slice(10, 12)} ${v[12]}`\n  );\n};\n\n/** Generate a random valid Thai TIN. */\nconst generate = (): string => {\n  const first = String(randomInt(1, 8));\n  const payload = first + randomDigits(11);\n  let sum = 0;\n  for (let i = 0; i < 12; i++)\n    sum += (13 - i) * Number(payload[i]);\n  return payload + String((11 - (sum % 11)) % 10);\n};\n\n/** Thai Tax Identification Number. */\nconst tin: Validator = {\n  name: \"Thai Tax Identification Number\",\n  localName: \"เลขประจำตัวผู้เสียภาษี\",\n  abbreviation: \"TIN\",\n  aliases: [\"เลขประจำตัวผู้เสียภาษี\", \"TIN\"] as const,\n  candidatePattern: \"\\\\d{13}\",\n  country: \"TH\",\n  entityType: \"any\",\n  description:\n    \"13-digit tax identifier for individuals and companies\",\n  sourceUrl: \"https://www.rd.go.th/\",\n  lengths: [13] as const,\n  examples: [\"1101700230708\", \"3100600445015\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default tin;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;AAmBA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,gCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;AAKH,KADc,OAAO,EAAE,GAAG,GACd,EACV,QAAO,IACL,qBACA,8BACD;CAIH,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,IACtB,QAAO,OAAO,EAAE,GAAG,IAAI,KAAK;AAG9B,MADe,KAAM,MAAM,MAAO,OACpB,OAAO,EAAE,IAAI,CACzB,QAAO,IACL,oBACA,iCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QACE,GAAG,EAAE,GAAG,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GACtB,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE;;;AAK9C,MAAM,iBAAyB;CAE7B,MAAM,UADQ,OAAO,UAAU,GAAG,EAAE,CAAC,GACb,aAAa,GAAG;CACxC,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,IACtB,SAAQ,KAAK,KAAK,OAAO,QAAQ,GAAG;AACtC,QAAO,UAAU,QAAQ,KAAM,MAAM,MAAO,GAAG;;;AAIjD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,0BAA0B,MAAM;CAC1C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,aACE;CACF,WAAW;CACX,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,iBAAiB,gBAAgB;CAC5C;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"tin.js","names":[],"sources":["../../src/th/tin.ts"],"sourcesContent":["/**\n * TIN (Thai Tax Identification Number,\n * เลขประจำตัวผู้เสียภาษี).\n *\n * 13 digits. Individual TINs have first digit 1-8;\n * company TINs (MOA) start with 0. Both use a\n * weighted mod-11 check digit.\n *\n * @see https://www.rd.go.th/\n * @see https://en.wikipedia.org/wiki/Thai_identity_card\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"TIN must be exactly 13 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"TIN must contain only digits\",\n    );\n  }\n\n  // First digit: 1-8 for individuals, 0 for companies\n  const first = Number(v[0]);\n  if (first > 8) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"TIN first digit must be 0-8\",\n    );\n  }\n\n  // Mod-11 check digit (position 13)\n  let sum = 0;\n  for (let i = 0; i < 12; i++) {\n    sum += Number(v[i]) * (13 - i);\n  }\n  const check = (11 - (sum % 11)) % 10;\n  if (check !== Number(v[12])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"TIN 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 (\n    `${v[0]} ${v.slice(1, 5)} ` +\n    `${v.slice(5, 10)} ${v.slice(10, 12)} ${v[12]}`\n  );\n};\n\n/** Generate a random valid Thai TIN. */\nconst generate = (): string => {\n  const first = String(randomInt(1, 8));\n  const payload = first + randomDigits(11);\n  let sum = 0;\n  for (let i = 0; i < 12; i++)\n    sum += (13 - i) * Number(payload[i]);\n  return payload + String((11 - (sum % 11)) % 10);\n};\n\n/** Thai Tax Identification Number. */\nconst tin: CountryValidator<\"TH\"> = {\n  name: \"Thai Tax Identification Number\",\n  localName: \"เลขประจำตัวผู้เสียภาษี\",\n  abbreviation: \"TIN\",\n  aliases: [\"เลขประจำตัวผู้เสียภาษี\", \"TIN\"] as const,\n  candidatePattern: \"\\\\d{13}\",\n  scope: \"country\",\n  country: \"TH\",\n  entityType: \"any\",\n  description:\n    \"13-digit tax identifier for individuals and companies\",\n  sourceUrl: \"https://www.rd.go.th/\",\n  lengths: [13] as const,\n  examples: [\"1101700230708\", \"3100600445015\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default tin;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AAsBA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;AAEnB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,+BACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,8BACF;CAKF,IADc,OAAO,EAAE,EACf,IAAI,GACV,OAAO,IACL,qBACA,6BACF;CAIF,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KACtB,OAAO,OAAO,EAAE,EAAE,KAAK,KAAK;CAG9B,KADe,KAAM,MAAM,MAAO,OACpB,OAAO,EAAE,GAAG,GACxB,OAAO,IACL,oBACA,gCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,OACE,GAAG,EAAE,GAAG,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GACtB,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,IAAI,EAAE,EAAE,GAAG,EAAE;AAE9C;;AAGA,MAAM,iBAAyB;CAE7B,MAAM,UADQ,OAAO,UAAU,GAAG,CAAC,CACf,IAAI,aAAa,EAAE;CACvC,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KACtB,QAAQ,KAAK,KAAK,OAAO,QAAQ,EAAE;CACrC,OAAO,UAAU,QAAQ,KAAM,MAAM,MAAO,EAAE;AAChD;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,0BAA0B,KAAK;CACzC,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,aACE;CACF,WAAW;CACX,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,iBAAiB,eAAe;CAC3C;CACA;CACA;CACA;AACF"}

package/dist/tr/tckimlik.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/tr/tckimlik.d.ts
 declare const compact: (value: string) => string;
@@ -8,7 +8,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid Turkish T.C. Kimlik No. */
 declare const generate: () => string;
 /** Turkish Personal Identification Number. */
-declare const tckimlik: Validator;
+declare const tckimlik: CountryValidator<"TR">;
 //#endregion
 export { compact, tckimlik as default, format, generate, validate };
 //# sourceMappingURL=tckimlik.d.ts.map

package/dist/tr/tckimlik.js

@@ -3,26 +3,6 @@ import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/tr/tckimlik.ts
-/**
-* T.C. Kimlik No.
-* (Türkiye Cumhuriyeti Kimlik Numarası,
-* Turkish personal identification number).
-*
-* 11-digit unique personal ID assigned to every
-* Turkish citizen by MERNİS (Merkezi Nüfus İdaresi
-* Sistemi). The first digit is never zero. The last
-* two digits are check digits.
-*
-* Check digit algorithm:
-*   Let A = sum of digits at odd positions (1,3,5,7,9)
-*   Let B = sum of digits at even positions (2,4,6,8)
-*   d10 = (7 * A - B) mod 10
-*   d11 = (d1 + d2 + ... + d10) mod 10
-*
-* @see https://tckimlik.nvi.gov.tr/
-* @see https://en.wikipedia.org/wiki/Turkish_Identification_Number
-* @see https://www.turkiye.gov.tr/nvi-tckn-dogrulama
-*/
 const compact = (value) => clean(value, " -./");
 /**
 * Calculate the two check digits from the first
@@ -64,6 +44,7 @@ const tckimlik = {
 	abbreviation: "T.C. Kimlik",
 	aliases: ["TC Kimlik No", "T.C. Kimlik Numarası"],
 	candidatePattern: "[1-9]\\d{10}",
+	scope: "country",
 	country: "TR",
 	entityType: "person",
 	sourceUrl: "https://www.nvi.gov.tr/",

package/dist/tr/tckimlik.js.map

@@ -1 +1 @@
-{"version":3,"file":"tckimlik.js","names":[],"sources":["../../src/tr/tckimlik.ts"],"sourcesContent":["/**\n * T.C. Kimlik No.\n * (Türkiye Cumhuriyeti Kimlik Numarası,\n * Turkish personal identification number).\n *\n * 11-digit unique personal ID assigned to every\n * Turkish citizen by MERNİS (Merkezi Nüfus İdaresi\n * Sistemi). The first digit is never zero. The last\n * two digits are check digits.\n *\n * Check digit algorithm:\n *   Let A = sum of digits at odd positions (1,3,5,7,9)\n *   Let B = sum of digits at even positions (2,4,6,8)\n *   d10 = (7 * A - B) mod 10\n *   d11 = (d1 + d2 + ... + d10) mod 10\n *\n * @see https://tckimlik.nvi.gov.tr/\n * @see https://en.wikipedia.org/wiki/Turkish_Identification_Number\n * @see https://www.turkiye.gov.tr/nvi-tckn-dogrulama\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 compact = (value: string): string =>\n  clean(value, \" -./\");\n\n/**\n * Calculate the two check digits from the first\n * nine digits of a T.C. Kimlik number.\n */\nconst calcCheckDigits = (number: string): string => {\n  let oddSum = 0;\n  let evenSum = 0;\n  for (let i = 0; i < 9; i++) {\n    const d = Number(number[i]);\n    if (i % 2 === 0) {\n      oddSum += d;\n    } else {\n      evenSum += d;\n    }\n  }\n  const d10 = (((7 * oddSum - evenSum) % 10) + 10) % 10;\n  const d11 = (oddSum + evenSum + d10) % 10;\n  return `${d10}${d11}`;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"T.C. Kimlik number must be 11 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"T.C. Kimlik number must contain only digits\",\n    );\n  }\n  if (v[0] === \"0\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"T.C. Kimlik number cannot start with 0\",\n    );\n  }\n  if (calcCheckDigits(v) !== v.slice(9)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"T.C. Kimlik number check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\n/** TR IDs are displayed without separators. */\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Turkish T.C. Kimlik No. */\nconst generate = (): string => {\n  const payload = String(randomInt(1, 9)) + randomDigits(8);\n  return payload + calcCheckDigits(payload);\n};\n\n/** Turkish Personal Identification Number. */\nconst tckimlik: Validator = {\n  name: \"Turkish Personal ID\",\n  localName: \"T.C. Kimlik Numarası\",\n  abbreviation: \"T.C. Kimlik\",\n  aliases: [\n    \"TC Kimlik No\",\n    \"T.C. Kimlik Numarası\",\n  ] as const,\n  candidatePattern: \"[1-9]\\\\d{10}\",\n  country: \"TR\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.nvi.gov.tr/\",\n  examples: [\"17291716060\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default tckimlik;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,MAAM,WAAW,UACf,MAAM,OAAO,OAAO;;;;;AAMtB,MAAM,mBAAmB,WAA2B;CAClD,IAAI,SAAS;CACb,IAAI,UAAU;AACd,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,IAAI,OAAO,OAAO,GAAG;AAC3B,MAAI,IAAI,MAAM,EACZ,WAAU;MAEV,YAAW;;CAGf,MAAM,QAAS,IAAI,SAAS,WAAW,KAAM,MAAM;AAEnD,QAAO,GAAG,OADG,SAAS,UAAU,OAAO;;AAIzC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,uCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,8CACD;AAEH,KAAI,EAAE,OAAO,IACX,QAAO,IACL,qBACA,yCACD;AAEH,KAAI,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,CACnC,QAAO,IACL,oBACA,0CACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;;AAIpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;CAC7B,MAAM,UAAU,OAAO,UAAU,GAAG,EAAE,CAAC,GAAG,aAAa,EAAE;AACzD,QAAO,UAAU,gBAAgB,QAAQ;;;AAI3C,MAAM,WAAsB;CAC1B,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,gBACA,uBACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,cAAc;CACzB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"tckimlik.js","names":[],"sources":["../../src/tr/tckimlik.ts"],"sourcesContent":["/**\n * T.C. Kimlik No.\n * (Türkiye Cumhuriyeti Kimlik Numarası,\n * Turkish personal identification number).\n *\n * 11-digit unique personal ID assigned to every\n * Turkish citizen by MERNİS (Merkezi Nüfus İdaresi\n * Sistemi). The first digit is never zero. The last\n * two digits are check digits.\n *\n * Check digit algorithm:\n *   Let A = sum of digits at odd positions (1,3,5,7,9)\n *   Let B = sum of digits at even positions (2,4,6,8)\n *   d10 = (7 * A - B) mod 10\n *   d11 = (d1 + d2 + ... + d10) mod 10\n *\n * @see https://tckimlik.nvi.gov.tr/\n * @see https://en.wikipedia.org/wiki/Turkish_Identification_Number\n * @see https://www.turkiye.gov.tr/nvi-tckn-dogrulama\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -./\");\n\n/**\n * Calculate the two check digits from the first\n * nine digits of a T.C. Kimlik number.\n */\nconst calcCheckDigits = (number: string): string => {\n  let oddSum = 0;\n  let evenSum = 0;\n  for (let i = 0; i < 9; i++) {\n    const d = Number(number[i]);\n    if (i % 2 === 0) {\n      oddSum += d;\n    } else {\n      evenSum += d;\n    }\n  }\n  const d10 = (((7 * oddSum - evenSum) % 10) + 10) % 10;\n  const d11 = (oddSum + evenSum + d10) % 10;\n  return `${d10}${d11}`;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"T.C. Kimlik number must be 11 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"T.C. Kimlik number must contain only digits\",\n    );\n  }\n  if (v[0] === \"0\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"T.C. Kimlik number cannot start with 0\",\n    );\n  }\n  if (calcCheckDigits(v) !== v.slice(9)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"T.C. Kimlik number check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\n/** TR IDs are displayed without separators. */\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Turkish T.C. Kimlik No. */\nconst generate = (): string => {\n  const payload = String(randomInt(1, 9)) + randomDigits(8);\n  return payload + calcCheckDigits(payload);\n};\n\n/** Turkish Personal Identification Number. */\nconst tckimlik: CountryValidator<\"TR\"> = {\n  name: \"Turkish Personal ID\",\n  localName: \"T.C. Kimlik Numarası\",\n  abbreviation: \"T.C. Kimlik\",\n  aliases: [\n    \"TC Kimlik No\",\n    \"T.C. Kimlik Numarası\",\n  ] as const,\n  candidatePattern: \"[1-9]\\\\d{10}\",\n  scope: \"country\",\n  country: \"TR\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.nvi.gov.tr/\",\n  examples: [\"17291716060\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default tckimlik;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AA+BA,MAAM,WAAW,UACf,MAAM,OAAO,MAAM;;;;;AAMrB,MAAM,mBAAmB,WAA2B;CAClD,IAAI,SAAS;CACb,IAAI,UAAU;CACd,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,IAAI,OAAO,OAAO,EAAE;EAC1B,IAAI,IAAI,MAAM,GACZ,UAAU;OAEV,WAAW;CAEf;CACA,MAAM,QAAS,IAAI,SAAS,WAAW,KAAM,MAAM;CAEnD,OAAO,GAAG,OADG,SAAS,UAAU,OAAO;AAEzC;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,sCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,6CACF;CAEF,IAAI,EAAE,OAAO,KACX,OAAO,IACL,qBACA,wCACF;CAEF,IAAI,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,OAAO,IACL,oBACA,yCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;;AAGA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,iBAAyB;CAC7B,MAAM,UAAU,OAAO,UAAU,GAAG,CAAC,CAAC,IAAI,aAAa,CAAC;CACxD,OAAO,UAAU,gBAAgB,OAAO;AAC1C;;AAGA,MAAM,WAAmC;CACvC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,gBACA,sBACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,aAAa;CACxB;CACA;CACA;CACA;AACF"}

package/dist/tr/vkn.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/tr/vkn.d.ts
 declare const compact: (value: string) => string;
@@ -8,7 +8,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid Turkish VKN. */
 declare const generate: () => string;
 /** Turkish Tax Identification Number. */
-declare const vkn: Validator;
+declare const vkn: CountryValidator<"TR">;
 //#endregion
 export { compact, vkn as default, format, generate, validate };
 //# sourceMappingURL=vkn.d.ts.map

package/dist/tr/vkn.js

@@ -3,26 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/tr/vkn.ts
-/**
-* VKN (Vergi Kimlik Numarası, Turkish tax
-* identification number).
-*
-* 10-digit tax ID used for businesses in Turkey.
-* The last digit is a check digit.
-*
-* Check digit algorithm:
-*   For each of the first 9 digits (right to left,
-*   position i = 1..9):
-*     c1 = (digit + i) mod 10
-*     c2 = if c1 != 0: (c1 * 2^i) mod 9, or 9 if
-*          that result is 0
-*     sum += c2
-*   check = (10 - sum) mod 10
-*
-* @see https://www.turkiye.gov.tr/gib-intvrg-vergi-kimlik-numarasi-dogrulama
-* @see https://arthurdejong.org/python-stdnum/doc/1.17/stdnum.tr.vkn
-* @see https://www.gib.gov.tr/
-*/
 const compact = (value) => clean(value, " -./");
 /**
 * Calculate the check digit for the first 9 digits
@@ -64,6 +44,7 @@ const vkn = {
 	abbreviation: "VKN",
 	aliases: ["VKN", "Vergi Kimlik Numarası"],
 	candidatePattern: "\\d{10}",
+	scope: "country",
 	country: "TR",
 	entityType: "company",
 	sourceUrl: "https://www.gib.gov.tr/",

package/dist/tr/vkn.js.map

@@ -1 +1 @@
-{"version":3,"file":"vkn.js","names":[],"sources":["../../src/tr/vkn.ts"],"sourcesContent":["/**\n * VKN (Vergi Kimlik Numarası, Turkish tax\n * identification number).\n *\n * 10-digit tax ID used for businesses in Turkey.\n * The last digit is a check digit.\n *\n * Check digit algorithm:\n *   For each of the first 9 digits (right to left,\n *   position i = 1..9):\n *     c1 = (digit + i) mod 10\n *     c2 = if c1 != 0: (c1 * 2^i) mod 9, or 9 if\n *          that result is 0\n *     sum += c2\n *   check = (10 - sum) mod 10\n *\n * @see https://www.turkiye.gov.tr/gib-intvrg-vergi-kimlik-numarasi-dogrulama\n * @see https://arthurdejong.org/python-stdnum/doc/1.17/stdnum.tr.vkn\n * @see https://www.gib.gov.tr/\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 compact = (value: string): string =>\n  clean(value, \" -./\");\n\n/**\n * Calculate the check digit for the first 9 digits\n * of a VKN.\n */\nconst calcCheckDigit = (number: string): string => {\n  let s = 0;\n  for (let i = 0; i < 9; i++) {\n    const pos = 9 - i; // position 1..9 from right\n    const c1 = (Number(number[i]) + pos) % 10;\n    if (c1 !== 0) {\n      const pow = 2 ** pos;\n      const c2 = (c1 * pow) % 9 || 9;\n      s += c2;\n    }\n  }\n  return String((10 - (s % 10)) % 10);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 10) {\n    return err(\"INVALID_LENGTH\", \"VKN must be 10 digits\");\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"VKN must contain only digits\",\n    );\n  }\n  if (calcCheckDigit(v) !== v[9]) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"VKN check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\n/** TR IDs are displayed without separators. */\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Turkish VKN. */\nconst generate = (): string => {\n  const payload = randomDigits(9);\n  return payload + calcCheckDigit(payload);\n};\n\n/** Turkish Tax Identification Number. */\nconst vkn: Validator = {\n  name: \"Turkish Tax ID\",\n  localName: \"Vergi Kimlik Numarası\",\n  abbreviation: \"VKN\",\n  aliases: [\"VKN\", \"Vergi Kimlik Numarası\"] as const,\n  candidatePattern: \"\\\\d{10}\",\n  country: \"TR\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.gib.gov.tr/\",\n  examples: [\"4540536920\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vkn;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,MAAM,WAAW,UACf,MAAM,OAAO,OAAO;;;;;AAMtB,MAAM,kBAAkB,WAA2B;CACjD,IAAI,IAAI;AACR,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,MAAM,IAAI;EAChB,MAAM,MAAM,OAAO,OAAO,GAAG,GAAG,OAAO;AACvC,MAAI,OAAO,GAAG;GAEZ,MAAM,KAAM,KADA,KAAK,MACO,KAAK;AAC7B,QAAK;;;AAGT,QAAO,QAAQ,KAAM,IAAI,MAAO,GAAG;;AAGrC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IAAI,kBAAkB,wBAAwB;AAEvD,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;AAEH,KAAI,eAAe,EAAE,KAAK,EAAE,GAC1B,QAAO,IACL,oBACA,2BACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;;AAIpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,EAAE;AAC/B,QAAO,UAAU,eAAe,QAAQ;;;AAI1C,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,wBAAwB;CACzC,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,aAAa;CACxB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"vkn.js","names":[],"sources":["../../src/tr/vkn.ts"],"sourcesContent":["/**\n * VKN (Vergi Kimlik Numarası, Turkish tax\n * identification number).\n *\n * 10-digit tax ID used for businesses in Turkey.\n * The last digit is a check digit.\n *\n * Check digit algorithm:\n *   For each of the first 9 digits (right to left,\n *   position i = 1..9):\n *     c1 = (digit + i) mod 10\n *     c2 = if c1 != 0: (c1 * 2^i) mod 9, or 9 if\n *          that result is 0\n *     sum += c2\n *   check = (10 - sum) mod 10\n *\n * @see https://www.turkiye.gov.tr/gib-intvrg-vergi-kimlik-numarasi-dogrulama\n * @see https://arthurdejong.org/python-stdnum/doc/1.17/stdnum.tr.vkn\n * @see https://www.gib.gov.tr/\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 compact = (value: string): string =>\n  clean(value, \" -./\");\n\n/**\n * Calculate the check digit for the first 9 digits\n * of a VKN.\n */\nconst calcCheckDigit = (number: string): string => {\n  let s = 0;\n  for (let i = 0; i < 9; i++) {\n    const pos = 9 - i; // position 1..9 from right\n    const c1 = (Number(number[i]) + pos) % 10;\n    if (c1 !== 0) {\n      const pow = 2 ** pos;\n      const c2 = (c1 * pow) % 9 || 9;\n      s += c2;\n    }\n  }\n  return String((10 - (s % 10)) % 10);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 10) {\n    return err(\"INVALID_LENGTH\", \"VKN must be 10 digits\");\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"VKN must contain only digits\",\n    );\n  }\n  if (calcCheckDigit(v) !== v[9]) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"VKN check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\n/** TR IDs are displayed without separators. */\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Turkish VKN. */\nconst generate = (): string => {\n  const payload = randomDigits(9);\n  return payload + calcCheckDigit(payload);\n};\n\n/** Turkish Tax Identification Number. */\nconst vkn: CountryValidator<\"TR\"> = {\n  name: \"Turkish Tax ID\",\n  localName: \"Vergi Kimlik Numarası\",\n  abbreviation: \"VKN\",\n  aliases: [\"VKN\", \"Vergi Kimlik Numarası\"] as const,\n  candidatePattern: \"\\\\d{10}\",\n  scope: \"country\",\n  country: \"TR\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.gib.gov.tr/\",\n  examples: [\"4540536920\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vkn;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AA+BA,MAAM,WAAW,UACf,MAAM,OAAO,MAAM;;;;;AAMrB,MAAM,kBAAkB,WAA2B;CACjD,IAAI,IAAI;CACR,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,MAAM,IAAI;EAChB,MAAM,MAAM,OAAO,OAAO,EAAE,IAAI,OAAO;EACvC,IAAI,OAAO,GAAG;GAEZ,MAAM,KAAM,KADA,KAAK,MACO,KAAK;GAC7B,KAAK;EACP;CACF;CACA,OAAO,QAAQ,KAAM,IAAI,MAAO,EAAE;AACpC;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IAAI,kBAAkB,uBAAuB;CAEtD,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,8BACF;CAEF,IAAI,eAAe,CAAC,MAAM,EAAE,IAC1B,OAAO,IACL,oBACA,0BACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;;AAGA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,CAAC;CAC9B,OAAO,UAAU,eAAe,OAAO;AACzC;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,uBAAuB;CACxC,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;AACF"}

package/dist/tw/ubn.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/tw/ubn.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid UBN. */
 declare const generate: () => string;
 /** Taiwanese Unified Business Number. */
-declare const ubn: Validator;
+declare const ubn: CountryValidator<"TW">;
 //#endregion
 export { compact, ubn as default, format, generate, validate };
 //# sourceMappingURL=ubn.d.ts.map

package/dist/tw/ubn.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/tw/ubn.ts
-/**
-* UBN (Unified Business Number, 統一編號).
-*
-* Taiwanese company identifier. 8 digits with a
-* weighted checksum. Weights [1,2,1,2,1,2,4,1];
-* sum the individual digits of each product, total
-* mod 10 must be 0. Special case: when the 7th digit
-* is 7, checksum 9 is also accepted.
-*
-* @see https://zh.wikipedia.org/wiki/統一編號
-*/
 const WEIGHTS = [
 	1,
 	2,
@@ -69,6 +58,7 @@ const ubn = {
 	abbreviation: "UBN",
 	aliases: ["統一編號", "UBN"],
 	candidatePattern: "\\d{8}",
+	scope: "country",
 	country: "TW",
 	entityType: "company",
 	description: "8-digit company identifier issued by the Ministry of Economic Affairs",

package/dist/tw/ubn.js.map

@@ -1 +1 @@
-{"version":3,"file":"ubn.js","names":[],"sources":["../../src/tw/ubn.ts"],"sourcesContent":["/**\n * UBN (Unified Business Number, 統一編號).\n *\n * Taiwanese company identifier. 8 digits with a\n * weighted checksum. Weights [1,2,1,2,1,2,4,1];\n * sum the individual digits of each product, total\n * mod 10 must be 0. Special case: when the 7th digit\n * is 7, checksum 9 is also accepted.\n *\n * @see https://zh.wikipedia.org/wiki/統一編號\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 = [1, 2, 1, 2, 1, 2, 4, 1] as const;\n\n/** Sum the individual digits of a number. */\nconst digitSum = (n: number): number => {\n  let sum = 0;\n  while (n > 0) {\n    sum += n % 10;\n    n = Math.floor(n / 10);\n  }\n  return sum;\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      \"UBN must be exactly 8 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"UBN must contain only digits\",\n    );\n  }\n\n  let sum = 0;\n  for (const [i, weight] of WEIGHTS.entries()) {\n    sum += digitSum(Number(v[i]) * weight);\n  }\n\n  const checksum = sum % 10;\n  if (checksum === 0) {\n    return { valid: true, compact: v };\n  }\n\n  // Special case: when the 7th digit is 7 (product\n  // 4*7=28), the checksum may be 9 instead of 0.\n  if (checksum === 9 && v[6] === \"7\") {\n    return { valid: true, compact: v };\n  }\n\n  return err(\n    \"INVALID_CHECKSUM\",\n    \"UBN checksum does not match\",\n  );\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid UBN. */\nconst generate = (): string => {\n  for (;;) {\n    const prefix = randomDigits(7);\n    for (let d = 0; d < 10; d++) {\n      const candidate = `${prefix}${d}`;\n      const r = validate(candidate);\n      if (r.valid) return candidate;\n    }\n  }\n};\n\n/** Taiwanese Unified Business Number. */\nconst ubn: Validator = {\n  name: \"Unified Business Number\",\n  localName: \"統一編號\",\n  abbreviation: \"UBN\",\n  aliases: [\"統一編號\", \"UBN\"] as const,\n  candidatePattern: \"\\\\d{8}\",\n  country: \"TW\",\n  entityType: \"company\",\n  description:\n    \"8-digit company identifier issued by the Ministry of Economic Affairs\",\n  sourceUrl:\n    \"https://zh.wikipedia.org/wiki/%E7%B5%B1%E4%B8%80%E7%B7%A8%E8%99%9F\",\n  lengths: [8] as const,\n  examples: [\"00501503\", \"04595257\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ubn;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;;;;;;;;;;;;AAmBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;;AAGxC,MAAM,YAAY,MAAsB;CACtC,IAAI,MAAM;AACV,QAAO,IAAI,GAAG;AACZ,SAAO,IAAI;AACX,MAAI,KAAK,MAAM,IAAI,GAAG;;AAExB,QAAO;;AAGT,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,+BACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;CAGH,IAAI,MAAM;AACV,MAAK,MAAM,CAAC,GAAG,WAAW,QAAQ,SAAS,CACzC,QAAO,SAAS,OAAO,EAAE,GAAG,GAAG,OAAO;CAGxC,MAAM,WAAW,MAAM;AACvB,KAAI,aAAa,EACf,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;AAKpC,KAAI,aAAa,KAAK,EAAE,OAAO,IAC7B,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;AAGpC,QAAO,IACL,oBACA,8BACD;;AAGH,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,SAAS,aAAa,EAAE;AAC9B,OAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;GAC3B,MAAM,YAAY,GAAG,SAAS;AAE9B,OADU,SAAS,UAAU,CACvB,MAAO,QAAO;;;;;AAM1B,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,QAAQ,MAAM;CACxB,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,aACE;CACF,WACE;CACF,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,YAAY,WAAW;CAClC;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"ubn.js","names":[],"sources":["../../src/tw/ubn.ts"],"sourcesContent":["/**\n * UBN (Unified Business Number, 統一編號).\n *\n * Taiwanese company identifier. 8 digits with a\n * weighted checksum. Weights [1,2,1,2,1,2,4,1];\n * sum the individual digits of each product, total\n * mod 10 must be 0. Special case: when the 7th digit\n * is 7, checksum 9 is also accepted.\n *\n * @see https://zh.wikipedia.org/wiki/統一編號\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 = [1, 2, 1, 2, 1, 2, 4, 1] as const;\n\n/** Sum the individual digits of a number. */\nconst digitSum = (n: number): number => {\n  let sum = 0;\n  while (n > 0) {\n    sum += n % 10;\n    n = Math.floor(n / 10);\n  }\n  return sum;\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      \"UBN must be exactly 8 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"UBN must contain only digits\",\n    );\n  }\n\n  let sum = 0;\n  for (const [i, weight] of WEIGHTS.entries()) {\n    sum += digitSum(Number(v[i]) * weight);\n  }\n\n  const checksum = sum % 10;\n  if (checksum === 0) {\n    return { valid: true, compact: v };\n  }\n\n  // Special case: when the 7th digit is 7 (product\n  // 4*7=28), the checksum may be 9 instead of 0.\n  if (checksum === 9 && v[6] === \"7\") {\n    return { valid: true, compact: v };\n  }\n\n  return err(\n    \"INVALID_CHECKSUM\",\n    \"UBN checksum does not match\",\n  );\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid UBN. */\nconst generate = (): string => {\n  for (;;) {\n    const prefix = randomDigits(7);\n    for (let d = 0; d < 10; d++) {\n      const candidate = `${prefix}${d}`;\n      const r = validate(candidate);\n      if (r.valid) return candidate;\n    }\n  }\n};\n\n/** Taiwanese Unified Business Number. */\nconst ubn: CountryValidator<\"TW\"> = {\n  name: \"Unified Business Number\",\n  localName: \"統一編號\",\n  abbreviation: \"UBN\",\n  aliases: [\"統一編號\", \"UBN\"] as const,\n  candidatePattern: \"\\\\d{8}\",\n  scope: \"country\",\n  country: \"TW\",\n  entityType: \"company\",\n  description:\n    \"8-digit company identifier issued by the Ministry of Economic Affairs\",\n  sourceUrl:\n    \"https://zh.wikipedia.org/wiki/%E7%B5%B1%E4%B8%80%E7%B7%A8%E8%99%9F\",\n  lengths: [8] as const,\n  examples: [\"00501503\", \"04595257\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ubn;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;AAsBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;;AAGvC,MAAM,YAAY,MAAsB;CACtC,IAAI,MAAM;CACV,OAAO,IAAI,GAAG;EACZ,OAAO,IAAI;EACX,IAAI,KAAK,MAAM,IAAI,EAAE;CACvB;CACA,OAAO;AACT;AAEA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;AAEnB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,GACf,OAAO,IACL,kBACA,8BACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,8BACF;CAGF,IAAI,MAAM;CACV,KAAK,MAAM,CAAC,GAAG,WAAW,QAAQ,QAAQ,GACxC,OAAO,SAAS,OAAO,EAAE,EAAE,IAAI,MAAM;CAGvC,MAAM,WAAW,MAAM;CACvB,IAAI,aAAa,GACf,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;CAKnC,IAAI,aAAa,KAAK,EAAE,OAAO,KAC7B,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;CAGnC,OAAO,IACL,oBACA,6BACF;AACF;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,iBAAyB;CAC7B,SAAS;EACP,MAAM,SAAS,aAAa,CAAC;EAC7B,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;GAC3B,MAAM,YAAY,GAAG,SAAS;GAE9B,IADU,SAAS,SACf,EAAE,OAAO,OAAO;EACtB;CACF;AACF;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,QAAQ,KAAK;CACvB,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,aACE;CACF,WACE;CACF,SAAS,CAAC,CAAC;CACX,UAAU,CAAC,YAAY,UAAU;CACjC;CACA;CACA;CACA;AACF"}

package/dist/types.d.ts

@@ -31,11 +31,25 @@ type ParsedPersonId = ParsedBirthDate & {
   gender: "male" | "female";
 };
 type ParsedIdentifier = ParsedBirthDate | ParsedPersonId;
-type Validator<TParsed extends ParsedIdentifier | undefined = undefined> = {
+/**
+ * Whether an identifier is scoped to a single
+ * country (e.g. Czech IČO) or is cross-border by
+ * design (e.g. IBAN, ISIN, BIC, LEI, EU VAT).
+ *
+ * Modeled as a discriminated union so consumers
+ * can group, filter, and exhaustively switch
+ * without null-checking `country`.
+ */
+type ValidatorScope = {
+  scope: "country";
+  country: CountryCode;
+} | {
+  scope: "global";
+};
+type ValidatorBase<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. */
+  abbreviation: string; /** What kind of entity this identifies. */
   entityType: "person" | "company" | "any";
   /**
    * Strip separators and normalize to a
@@ -102,7 +116,15 @@ type Validator<TParsed extends ParsedIdentifier | undefined = undefined> = {
 } & ([TParsed] extends [undefined] ? unknown : {
   parse: (value: string) => TParsed | null;
 });
+type CountryValidator<TCountry extends CountryCode = CountryCode, TParsed extends ParsedIdentifier | undefined = undefined> = ValidatorBase<TParsed> & {
+  scope: "country";
+  country: TCountry;
+};
+type GlobalValidator<TParsed extends ParsedIdentifier | undefined = undefined> = ValidatorBase<TParsed> & {
+  scope: "global";
+};
+type Validator<TParsed extends ParsedIdentifier | undefined = undefined> = CountryValidator<CountryCode, TParsed> | GlobalValidator<TParsed>;
 type ParsableValidator<TParsed extends ParsedIdentifier = ParsedIdentifier> = Validator<TParsed>;
 //#endregion
-export { CountryCode, ErrorCode, ParsableValidator, ParsedBirthDate, ParsedIdentifier, ParsedPersonId, StdnumError, ValidateResult, Validator };
+export { CountryCode, CountryValidator, ErrorCode, GlobalValidator, ParsableValidator, ParsedBirthDate, ParsedIdentifier, ParsedPersonId, StdnumError, ValidateResult, Validator, ValidatorScope };
 //# sourceMappingURL=types.d.ts.map

package/dist/ua/edrpou.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/ua/edrpou.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid Ukrainian EDRPOU. */
 declare const generate: () => string;
 /** Ukrainian Company Register Number. */
-declare const edrpou: Validator;
+declare const edrpou: CountryValidator<"UA">;
 //#endregion
 export { compact, edrpou as default, format, generate, validate };
 //# sourceMappingURL=edrpou.d.ts.map

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,
@@ -90,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 (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"}
+{"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/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

@@ -3,16 +3,6 @@ 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",
@@ -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":["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"}
+{"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

@@ -3,17 +3,6 @@ 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 = () => {
@@ -52,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":["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"}
+{"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/rtn.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/us/rtn.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ 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