@stll/stdnum 1.0.0 → 2.0.1

package/dist/us/rtn.js

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

package/dist/us/ssn.js.map

@@ -1 +1 @@
-{"version":3,"file":"ssn.js","names":[],"sources":["../../src/us/ssn.ts"],"sourcesContent":["/** Generate a random valid U.S. SSN. */\nconst generate = (): string => {\n  for (;;) {\n    let area: string;\n    do {\n      area = String(randomInt(1, 899)).padStart(3, \"0\");\n    } while (area === \"666\");\n    const group = String(randomInt(1, 99)).padStart(2, \"0\");\n    const serial = String(randomInt(1, 9999)).padStart(\n      4,\n      \"0\",\n    );\n    const ssn = `${area}${group}${serial}`;\n    if (!BLACKLIST.has(ssn)) return ssn;\n  }\n};\n\n/**\n * SSN (U.S. Social Security Number).\n *\n * 9-digit identifier: 3-digit area, 2-digit group,\n * 4-digit serial. No checksum. Area cannot be 000,\n * 666, or 900-999; group cannot be 00; serial\n * cannot be 0000.\n *\n * @see https://en.wikipedia.org/wiki/Social_Security_number\n * @see https://www.ssa.gov/employer/verifySSN.htm\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\n/** Known-invalid SSNs used in advertisements. */\nconst BLACKLIST = new Set([\n  \"078051120\",\n  \"457555462\",\n  \"219099999\",\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      \"SSN must contain only digits\",\n    );\n  }\n  if (v.length !== 9) {\n    return err(\"INVALID_LENGTH\", \"SSN must be 9 digits\");\n  }\n\n  const area = v.slice(0, 3);\n  const group = v.slice(3, 5);\n  const serial = v.slice(5, 9);\n\n  if (area === \"000\" || area === \"666\" || area[0] === \"9\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"SSN area number is invalid\",\n    );\n  }\n  if (group === \"00\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"SSN group number cannot be 00\",\n    );\n  }\n  if (serial === \"0000\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"SSN serial number cannot be 0000\",\n    );\n  }\n  if (BLACKLIST.has(v)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"SSN is on the blacklist\",\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, 3)}-${v.slice(3, 5)}-${v.slice(5)}`;\n  }\n  return v;\n};\n\n/** U.S. Social Security Number. */\nconst ssn: Validator = {\n  name: \"Social Security Number\",\n  localName: \"Social Security Number\",\n  abbreviation: \"SSN\",\n  aliases: [\"SSN\", \"Social Security Number\"] as const,\n  candidatePattern: \"\\\\d{3}-?\\\\d{2}-?\\\\d{4}\",\n  country: \"US\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.ssa.gov/employer/verifySSN.htm\",\n  examples: [\"536904399\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ssn;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;AACA,MAAM,iBAAyB;AAC7B,UAAS;EACP,IAAI;AACJ;AACE,UAAO,OAAO,UAAU,GAAG,IAAI,CAAC,CAAC,SAAS,GAAG,IAAI;SAC1C,SAAS;EAClB,MAAM,QAAQ,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI;EACvD,MAAM,SAAS,OAAO,UAAU,GAAG,KAAK,CAAC,CAAC,SACxC,GACA,IACD;EACD,MAAM,MAAM,GAAG,OAAO,QAAQ;AAC9B,MAAI,CAAC,UAAU,IAAI,IAAI,CAAE,QAAO;;;;AAwBpC,MAAM,YAAY,IAAI,IAAI;CACxB;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;CAGtD,MAAM,OAAO,EAAE,MAAM,GAAG,EAAE;CAC1B,MAAM,QAAQ,EAAE,MAAM,GAAG,EAAE;CAC3B,MAAM,SAAS,EAAE,MAAM,GAAG,EAAE;AAE5B,KAAI,SAAS,SAAS,SAAS,SAAS,KAAK,OAAO,IAClD,QAAO,IACL,qBACA,6BACD;AAEH,KAAI,UAAU,KACZ,QAAO,IACL,qBACA,gCACD;AAEH,KAAI,WAAW,OACb,QAAO,IACL,qBACA,mCACD;AAEH,KAAI,UAAU,IAAI,EAAE,CAClB,QAAO,IACL,qBACA,0BACD;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,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;AAExD,QAAO;;;AAIT,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,yBAAyB;CAC1C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"ssn.js","names":[],"sources":["../../src/us/ssn.ts"],"sourcesContent":["/** Generate a random valid U.S. SSN. */\nconst generate = (): string => {\n  for (;;) {\n    let area: string;\n    do {\n      area = String(randomInt(1, 899)).padStart(3, \"0\");\n    } while (area === \"666\");\n    const group = String(randomInt(1, 99)).padStart(2, \"0\");\n    const serial = String(randomInt(1, 9999)).padStart(\n      4,\n      \"0\",\n    );\n    const ssn = `${area}${group}${serial}`;\n    if (!BLACKLIST.has(ssn)) return ssn;\n  }\n};\n\n/**\n * SSN (U.S. Social Security Number).\n *\n * 9-digit identifier: 3-digit area, 2-digit group,\n * 4-digit serial. No checksum. Area cannot be 000,\n * 666, or 900-999; group cannot be 00; serial\n * cannot be 0000.\n *\n * @see https://en.wikipedia.org/wiki/Social_Security_number\n * @see https://www.ssa.gov/employer/verifySSN.htm\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\n/** Known-invalid SSNs used in advertisements. */\nconst BLACKLIST = new Set([\n  \"078051120\",\n  \"457555462\",\n  \"219099999\",\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      \"SSN must contain only digits\",\n    );\n  }\n  if (v.length !== 9) {\n    return err(\"INVALID_LENGTH\", \"SSN must be 9 digits\");\n  }\n\n  const area = v.slice(0, 3);\n  const group = v.slice(3, 5);\n  const serial = v.slice(5, 9);\n\n  if (area === \"000\" || area === \"666\" || area[0] === \"9\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"SSN area number is invalid\",\n    );\n  }\n  if (group === \"00\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"SSN group number cannot be 00\",\n    );\n  }\n  if (serial === \"0000\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"SSN serial number cannot be 0000\",\n    );\n  }\n  if (BLACKLIST.has(v)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"SSN is on the blacklist\",\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, 3)}-${v.slice(3, 5)}-${v.slice(5)}`;\n  }\n  return v;\n};\n\n/** U.S. Social Security Number. */\nconst ssn: CountryValidator<\"US\"> = {\n  name: \"Social Security Number\",\n  localName: \"Social Security Number\",\n  abbreviation: \"SSN\",\n  aliases: [\"SSN\", \"Social Security Number\"] as const,\n  candidatePattern: \"\\\\d{3}-?\\\\d{2}-?\\\\d{4}\",\n  scope: \"country\",\n  country: \"US\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.ssa.gov/employer/verifySSN.htm\",\n  examples: [\"536904399\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ssn;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AACA,MAAM,iBAAyB;CAC7B,SAAS;EACP,IAAI;EACJ;GACE,OAAO,OAAO,UAAU,GAAG,GAAG,CAAC,EAAE,SAAS,GAAG,GAAG;SACzC,SAAS;EAClB,MAAM,QAAQ,OAAO,UAAU,GAAG,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;EACtD,MAAM,SAAS,OAAO,UAAU,GAAG,IAAI,CAAC,EAAE,SACxC,GACA,GACF;EACA,MAAM,MAAM,GAAG,OAAO,QAAQ;EAC9B,IAAI,CAAC,UAAU,IAAI,GAAG,GAAG,OAAO;CAClC;AACF;;AAyBA,MAAM,YAAY,IAAI,IAAI;CACxB;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;CAGrD,MAAM,OAAO,EAAE,MAAM,GAAG,CAAC;CACzB,MAAM,QAAQ,EAAE,MAAM,GAAG,CAAC;CAC1B,MAAM,SAAS,EAAE,MAAM,GAAG,CAAC;CAE3B,IAAI,SAAS,SAAS,SAAS,SAAS,KAAK,OAAO,KAClD,OAAO,IACL,qBACA,4BACF;CAEF,IAAI,UAAU,MACZ,OAAO,IACL,qBACA,+BACF;CAEF,IAAI,WAAW,QACb,OAAO,IACL,qBACA,kCACF;CAEF,IAAI,UAAU,IAAI,CAAC,GACjB,OAAO,IACL,qBACA,yBACF;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,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC;CAEvD,OAAO;AACT;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,wBAAwB;CACzC,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;AACF"}

package/dist/uy/rut.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/uy/rut.d.ts
 declare const compact: (value: string) => string;
@@ -11,7 +11,7 @@ declare const generate: () => string;
  *
  * Examples sourced from python-stdnum test suite.
  */
-declare const rut: Validator;
+declare const rut: CountryValidator<"UY">;
 //#endregion
 export { compact, rut as default, format, generate, validate };
 //# sourceMappingURL=rut.d.ts.map

package/dist/uy/rut.js

@@ -3,20 +3,6 @@ import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/uy/rut.ts
-/**
-* RUT (Registro Único Tributario).
-*
-* Uruguayan tax identification number issued by the
-* DGI (Dirección General Impositiva). The number is
-* 12 digits: 2-digit document type (01-22), 6-digit
-* sequence, fixed "001" suffix, and a check digit
-* computed via weighted sum mod 11 (Python-style
-* modulo of the negated sum).
-*
-* Format: ############  (12 digits compact)
-*
-* @see https://www.agesic.gub.uy/
-*/
 const WEIGHTS = [
 	4,
 	3,
@@ -89,6 +75,7 @@ const rut = {
 	abbreviation: "RUT",
 	aliases: ["RUT", "Registro Único Tributario"],
 	candidatePattern: "\\d{12}",
+	scope: "country",
 	country: "UY",
 	entityType: "any",
 	lengths: [12],

package/dist/uy/rut.js.map

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

package/dist/ve/rif.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/ve/rif.d.ts
 declare const compact: (value: string) => string;
@@ -11,7 +11,7 @@ declare const generate: () => string;
  *
  * Examples sourced from python-stdnum test suite.
  */
-declare const rif: Validator;
+declare const rif: CountryValidator<"VE">;
 //#endregion
 export { compact, rif as default, format, generate, validate };
 //# sourceMappingURL=rif.d.ts.map

package/dist/ve/rif.js

@@ -4,20 +4,6 @@ import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/ve/rif.ts
 /**
-* RIF (Registro de Información Fiscal).
-*
-* Venezuelan tax identification number issued by the
-* SENIAT. The number consists of 1 letter indicating
-* the entity type (J=juridical, G=government,
-* V=natural/Venezuelan, E=foreign, P=passport)
-* followed by 8 digits and a check digit computed
-* via weighted sum mod 11.
-*
-* Format: X-########-# or X######### (10 chars compact)
-*
-* @see https://en.wikipedia.org/wiki/Tax_Identification_Number#Venezuela
-*/
-/**
 * Map prefix letter to its numeric offset used
 * in the check digit computation.
 */
@@ -80,7 +66,7 @@ const GENERATE_TYPES = [
 const generate = () => {
 	const prefix = randomPick(GENERATE_TYPES);
 	const body = randomDigits(8);
-	return prefix + body + String(calcCheckDigit(prefix, body));
+	return prefix + body + calcCheckDigit(prefix, body);
 };
 /**
 * Venezuelan RIF (tax identification number).
@@ -93,6 +79,7 @@ const rif = {
 	abbreviation: "RIF",
 	aliases: ["RIF", "Registro de Información Fiscal"],
 	candidatePattern: "[VEJPG]-?\\d{8}-?\\d",
+	scope: "country",
 	country: "VE",
 	entityType: "any",
 	lengths: [10],

package/dist/ve/rif.js.map

@@ -1 +1 @@
-{"version":3,"file":"rif.js","names":[],"sources":["../../src/ve/rif.ts"],"sourcesContent":["/**\n * RIF (Registro de Información Fiscal).\n *\n * Venezuelan tax identification number issued by the\n * SENIAT. The number consists of 1 letter indicating\n * the entity type (J=juridical, G=government,\n * V=natural/Venezuelan, E=foreign, P=passport)\n * followed by 8 digits and a check digit computed\n * via weighted sum mod 11.\n *\n * Format: X-########-# or X######### (10 chars compact)\n *\n * @see https://en.wikipedia.org/wiki/Tax_Identification_Number#Venezuela\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 * Map prefix letter to its numeric offset used\n * in the check digit computation.\n */\nconst PREFIX_VALUES: Record<string, number> = {\n  V: 4,\n  E: 8,\n  J: 12,\n  P: 16,\n  G: 20,\n};\n\n/** Weights applied to the 8-digit body. */\nconst WEIGHTS = [3, 2, 7, 6, 5, 4, 3, 2] as const;\n\n/**\n * Lookup table for converting the mod 11 result\n * to the check character.\n */\nconst CHECK_LOOKUP = \"00987654321\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -.\").trim().toUpperCase();\n\nconst calcCheckDigit = (\n  prefix: string,\n  body: string,\n): string => {\n  const pv = PREFIX_VALUES[prefix] ?? 0;\n  let sum = 0;\n  for (const [i, weight] of WEIGHTS.entries()) {\n    sum += Number(body[i]) * weight;\n  }\n  const digit = (pv + (sum % 11)) % 11;\n  // SAFETY: digit ∈ [0, 10] and CHECK_LOOKUP has 11 chars.\n  // eslint-disable-next-line no-non-null-assertion\n  return CHECK_LOOKUP[digit]!;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"RIF must be 10 characters\",\n    );\n  }\n\n  // SAFETY: length check above guarantees v[0] exists.\n  // eslint-disable-next-line no-non-null-assertion\n  const prefix = v[0]!;\n  if (!(prefix in PREFIX_VALUES)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RIF must start with V, E, J, P, or G\",\n    );\n  }\n\n  const body = v.slice(1, 9);\n  const check = v.slice(9);\n  if (!isdigits(v.slice(1))) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RIF body must contain only digits\",\n    );\n  }\n\n  const expected = calcCheckDigit(prefix, body);\n  if (check !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RIF check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v[0]}-${v.slice(1, 9)}-${v.slice(9)}`;\n};\n\nconst GENERATE_TYPES = [\"V\", \"E\", \"J\", \"P\", \"G\"] as const;\n\n/** Generate a random valid Venezuelan RIF. */\nconst generate = (): string => {\n  const prefix = randomPick(GENERATE_TYPES);\n  const body = randomDigits(8);\n  return (\n    prefix + body + String(calcCheckDigit(prefix, body))\n  );\n};\n\n/**\n * Venezuelan RIF (tax identification number).\n *\n * Examples sourced from python-stdnum test suite.\n */\nconst rif: Validator = {\n  name: \"Venezuelan Tax ID\",\n  localName: \"Registro de Información Fiscal\",\n  abbreviation: \"RIF\",\n  aliases: [\n    \"RIF\",\n    \"Registro de Información Fiscal\",\n  ] as const,\n  candidatePattern: \"[VEJPG]-?\\\\d{8}-?\\\\d\",\n  country: \"VE\",\n  entityType: \"any\",\n  lengths: [10] as const,\n  examples: [\"V309876543\", \"J309876546\"] as const,\n  compact,\n  format,\n  validate,\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Tax_Identification_Number#Venezuela\",\n  generate,\n};\n\nexport default rif;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA0BA,MAAM,gBAAwC;CAC5C,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACJ;;AAGD,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;;;;;AAMxC,MAAM,eAAe;AAErB,MAAM,WAAW,UACf,MAAM,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa;AAE1C,MAAM,kBACJ,QACA,SACW;CACX,MAAM,KAAK,cAAc,WAAW;CACpC,IAAI,MAAM;AACV,MAAK,MAAM,CAAC,GAAG,WAAW,QAAQ,SAAS,CACzC,QAAO,OAAO,KAAK,GAAG,GAAG;AAK3B,QAAO,cAHQ,KAAM,MAAM,MAAO;;AAMpC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,4BACD;CAKH,MAAM,SAAS,EAAE;AACjB,KAAI,EAAE,UAAU,eACd,QAAO,IACL,qBACA,uCACD;CAGH,MAAM,OAAO,EAAE,MAAM,GAAG,EAAE;CAC1B,MAAM,QAAQ,EAAE,MAAM,EAAE;AACxB,KAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,CACvB,QAAO,IACL,kBACA,oCACD;AAIH,KAAI,UADa,eAAe,QAAQ,KAAK,CAE3C,QAAO,IACL,oBACA,iCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QAAO,GAAG,EAAE,GAAG,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;;AAG/C,MAAM,iBAAiB;CAAC;CAAK;CAAK;CAAK;CAAK;CAAI;;AAGhD,MAAM,iBAAyB;CAC7B,MAAM,SAAS,WAAW,eAAe;CACzC,MAAM,OAAO,aAAa,EAAE;AAC5B,QACE,SAAS,OAAO,OAAO,eAAe,QAAQ,KAAK,CAAC;;;;;;;AASxD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,OACA,iCACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,cAAc,aAAa;CACtC;CACA;CACA;CACA,WACE;CACF;CACD"}
+{"version":3,"file":"rif.js","names":[],"sources":["../../src/ve/rif.ts"],"sourcesContent":["/**\n * RIF (Registro de Información Fiscal).\n *\n * Venezuelan tax identification number issued by the\n * SENIAT. The number consists of 1 letter indicating\n * the entity type (J=juridical, G=government,\n * V=natural/Venezuelan, E=foreign, P=passport)\n * followed by 8 digits and a check digit computed\n * via weighted sum mod 11.\n *\n * Format: X-########-# or X######### (10 chars compact)\n *\n * @see https://en.wikipedia.org/wiki/Tax_Identification_Number#Venezuela\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 * Map prefix letter to its numeric offset used\n * in the check digit computation.\n */\nconst PREFIX_VALUES: Record<string, number> = {\n  V: 4,\n  E: 8,\n  J: 12,\n  P: 16,\n  G: 20,\n};\n\n/** Weights applied to the 8-digit body. */\nconst WEIGHTS = [3, 2, 7, 6, 5, 4, 3, 2] as const;\n\n/**\n * Lookup table for converting the mod 11 result\n * to the check character.\n */\nconst CHECK_LOOKUP = \"00987654321\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -.\").trim().toUpperCase();\n\nconst calcCheckDigit = (\n  prefix: string,\n  body: string,\n): string => {\n  const pv = PREFIX_VALUES[prefix] ?? 0;\n  let sum = 0;\n  for (const [i, weight] of WEIGHTS.entries()) {\n    sum += Number(body[i]) * weight;\n  }\n  const digit = (pv + (sum % 11)) % 11;\n  // SAFETY: digit ∈ [0, 10] and CHECK_LOOKUP has 11 chars.\n  // eslint-disable-next-line no-non-null-assertion\n  return CHECK_LOOKUP[digit]!;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"RIF must be 10 characters\",\n    );\n  }\n\n  // SAFETY: length check above guarantees v[0] exists.\n  // eslint-disable-next-line no-non-null-assertion\n  const prefix = v[0]!;\n  if (!(prefix in PREFIX_VALUES)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RIF must start with V, E, J, P, or G\",\n    );\n  }\n\n  const body = v.slice(1, 9);\n  const check = v.slice(9);\n  if (!isdigits(v.slice(1))) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RIF body must contain only digits\",\n    );\n  }\n\n  const expected = calcCheckDigit(prefix, body);\n  if (check !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RIF check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v[0]}-${v.slice(1, 9)}-${v.slice(9)}`;\n};\n\nconst GENERATE_TYPES = [\"V\", \"E\", \"J\", \"P\", \"G\"] as const;\n\n/** Generate a random valid Venezuelan RIF. */\nconst generate = (): string => {\n  const prefix = randomPick(GENERATE_TYPES);\n  const body = randomDigits(8);\n  return prefix + body + calcCheckDigit(prefix, body);\n};\n\n/**\n * Venezuelan RIF (tax identification number).\n *\n * Examples sourced from python-stdnum test suite.\n */\nconst rif: CountryValidator<\"VE\"> = {\n  name: \"Venezuelan Tax ID\",\n  localName: \"Registro de Información Fiscal\",\n  abbreviation: \"RIF\",\n  aliases: [\n    \"RIF\",\n    \"Registro de Información Fiscal\",\n  ] as const,\n  candidatePattern: \"[VEJPG]-?\\\\d{8}-?\\\\d\",\n  scope: \"country\",\n  country: \"VE\",\n  entityType: \"any\",\n  lengths: [10] as const,\n  examples: [\"V309876543\", \"J309876546\"] as const,\n  compact,\n  format,\n  validate,\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Tax_Identification_Number#Venezuela\",\n  generate,\n};\n\nexport default rif;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;AA6BA,MAAM,gBAAwC;CAC5C,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;AACL;;AAGA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;;;;;AAMvC,MAAM,eAAe;AAErB,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY;AAEzC,MAAM,kBACJ,QACA,SACW;CACX,MAAM,KAAK,cAAc,WAAW;CACpC,IAAI,MAAM;CACV,KAAK,MAAM,CAAC,GAAG,WAAW,QAAQ,QAAQ,GACxC,OAAO,OAAO,KAAK,EAAE,IAAI;CAK3B,OAAO,cAHQ,KAAM,MAAM,MAAO;AAIpC;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CAEvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,2BACF;CAKF,MAAM,SAAS,EAAE;CACjB,IAAI,EAAE,UAAU,gBACd,OAAO,IACL,qBACA,sCACF;CAGF,MAAM,OAAO,EAAE,MAAM,GAAG,CAAC;CACzB,MAAM,QAAQ,EAAE,MAAM,CAAC;CACvB,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,GACtB,OAAO,IACL,kBACA,mCACF;CAIF,IAAI,UADa,eAAe,QAAQ,IACnB,GACnB,OAAO,IACL,oBACA,gCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,OAAO,GAAG,EAAE,GAAG,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC;AAC9C;AAEA,MAAM,iBAAiB;CAAC;CAAK;CAAK;CAAK;CAAK;AAAG;;AAG/C,MAAM,iBAAyB;CAC7B,MAAM,SAAS,WAAW,cAAc;CACxC,MAAM,OAAO,aAAa,CAAC;CAC3B,OAAO,SAAS,OAAO,eAAe,QAAQ,IAAI;AACpD;;;;;;AAOA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,OACA,gCACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,cAAc,YAAY;CACrC;CACA;CACA;CACA,WACE;CACF;AACF"}

package/dist/vn/mst.d.ts

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

package/dist/vn/mst.js

@@ -3,18 +3,6 @@ import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/vn/mst.ts
-/**
-* MST (Mã số thuế, Vietnam tax number).
-*
-* 10 or 13 digits. The first two digits encode the province
-* where the business was registered. Digits 3-9 are a
-* sequential number (0000001-9999999). Digit 10 is a
-* weighted mod-11 check digit. An optional 3-digit branch
-* suffix (001-999) may follow, separated by a dash.
-*
-* @see https://vi.wikipedia.org/wiki/Thuế_Việt_Nam#Mã_số_thuế_(MST)_của_doanh_nghiệp
-* @see https://easyinvoice.vn/ma-so-thue/
-*/
 const WEIGHTS = [
 	31,
 	29,
@@ -65,6 +53,7 @@ const mst = {
 	abbreviation: "MST",
 	aliases: ["MST", "mã số thuế"],
 	candidatePattern: "\\d{10}(-\\d{3})?",
+	scope: "country",
 	country: "VN",
 	entityType: "company",
 	description: "10- or 13-digit tax identifier for enterprises",

package/dist/vn/mst.js.map

@@ -1 +1 @@
-{"version":3,"file":"mst.js","names":[],"sources":["../../src/vn/mst.ts"],"sourcesContent":["/**\n * MST (Mã số thuế, Vietnam tax number).\n *\n * 10 or 13 digits. The first two digits encode the province\n * where the business was registered. Digits 3-9 are a\n * sequential number (0000001-9999999). Digit 10 is a\n * weighted mod-11 check digit. An optional 3-digit branch\n * suffix (001-999) may follow, separated by a dash.\n *\n * @see https://vi.wikipedia.org/wiki/Thuế_Việt_Nam#Mã_số_thuế_(MST)_của_doanh_nghiệp\n * @see https://easyinvoice.vn/ma-so-thue/\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 = [31, 29, 23, 19, 17, 13, 7, 5, 3] as const;\n\nconst calcCheckDigit = (number: string): string => {\n  let total = 0;\n  for (let i = 0; i < 9; i++) {\n    total += (WEIGHTS[i] ?? 0) * Number(number.charAt(i));\n  }\n  const remainder = 10 - (total % 11);\n  // When remainder is 10, the sequential part is\n  // never issued by GDT. Returning \"0\" keeps the\n  // function correct as a digit calculator (mod 10\n  // wrap) while still rejecting these numbers since\n  // no real MST will have this combination.\n  return String(\n    remainder >= 10 ? remainder - 10 : remainder,\n  );\n};\n\nconst compact = (value: string): string =>\n  clean(value, \" -.\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 10 && v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"MST must be 10 or 13 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"MST must contain only digits\",\n    );\n  }\n\n  // Sequential part (digits 3-9) must not be all zeros\n  if (v.slice(2, 9) === \"0000000\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"MST sequential part must not be 0000000\",\n    );\n  }\n\n  // Branch suffix (last 3 digits) must not be 000\n  if (v.length === 13 && v.slice(10) === \"000\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"MST branch suffix must not be 000\",\n    );\n  }\n\n  // Check digit (position 10, index 9)\n  if (v[9] !== calcCheckDigit(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"MST 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  if (v.length === 13) {\n    return `${v.slice(0, 10)}-${v.slice(10)}`;\n  }\n  return v;\n};\n\n/** Generate a random valid Vietnamese MST. */\nconst generate = (): string => {\n  for (;;) {\n    const province = String(randomInt(1, 99)).padStart(\n      2,\n      \"0\",\n    );\n    const payload = province + randomDigits(7);\n    const c = payload + calcCheckDigit(payload);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Vietnamese Tax Number. */\nconst mst: Validator = {\n  name: \"Vietnamese Tax Number\",\n  localName: \"Mã số thuế\",\n  abbreviation: \"MST\",\n  aliases: [\"MST\", \"mã số thuế\"] as const,\n  candidatePattern: \"\\\\d{10}(-\\\\d{3})?\",\n  country: \"VN\",\n  entityType: \"company\",\n  description:\n    \"10- or 13-digit tax identifier for enterprises\",\n  sourceUrl:\n    \"https://vi.wikipedia.org/wiki/Thu%E1%BA%BF_Vi%E1%BB%87t_Nam#M%C3%A3_s%E1%BB%91_thu%E1%BA%BF_(MST)_c%E1%BB%A7a_doanh_nghi%E1%BB%87p\",\n  lengths: [10, 13] as const,\n  examples: [\"0100233488\", \"0314409058002\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default mst;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;AAoBA,MAAM,UAAU;CAAC;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAG;CAAG;CAAE;AAEjD,MAAM,kBAAkB,WAA2B;CACjD,IAAI,QAAQ;AACZ,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,WAAU,QAAQ,MAAM,KAAK,OAAO,OAAO,OAAO,EAAE,CAAC;CAEvD,MAAM,YAAY,KAAM,QAAQ;AAMhC,QAAO,OACL,aAAa,KAAK,YAAY,KAAK,UACpC;;AAGH,MAAM,WAAW,UACf,MAAM,OAAO,MAAM;AAErB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,MAAM,EAAE,WAAW,GAClC,QAAO,IACL,kBACA,8BACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;AAIH,KAAI,EAAE,MAAM,GAAG,EAAE,KAAK,UACpB,QAAO,IACL,qBACA,0CACD;AAIH,KAAI,EAAE,WAAW,MAAM,EAAE,MAAM,GAAG,KAAK,MACrC,QAAO,IACL,qBACA,oCACD;AAIH,KAAI,EAAE,OAAO,eAAe,EAAE,CAC5B,QAAO,IACL,oBACA,iCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG;AAEzC,QAAO;;;AAIT,MAAM,iBAAyB;AAC7B,UAAS;EAKP,MAAM,UAJW,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,SACxC,GACA,IACD,GAC0B,aAAa,EAAE;EAC1C,MAAM,IAAI,UAAU,eAAe,QAAQ;AAC3C,MAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;AAKlC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,aAAa;CAC9B,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,aACE;CACF,WACE;CACF,SAAS,CAAC,IAAI,GAAG;CACjB,UAAU,CAAC,cAAc,gBAAgB;CACzC;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"mst.js","names":[],"sources":["../../src/vn/mst.ts"],"sourcesContent":["/**\n * MST (Mã số thuế, Vietnam tax number).\n *\n * 10 or 13 digits. The first two digits encode the province\n * where the business was registered. Digits 3-9 are a\n * sequential number (0000001-9999999). Digit 10 is a\n * weighted mod-11 check digit. An optional 3-digit branch\n * suffix (001-999) may follow, separated by a dash.\n *\n * @see https://vi.wikipedia.org/wiki/Thuế_Việt_Nam#Mã_số_thuế_(MST)_của_doanh_nghiệp\n * @see https://easyinvoice.vn/ma-so-thue/\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 WEIGHTS = [31, 29, 23, 19, 17, 13, 7, 5, 3] as const;\n\nconst calcCheckDigit = (number: string): string => {\n  let total = 0;\n  for (let i = 0; i < 9; i++) {\n    total += (WEIGHTS[i] ?? 0) * Number(number.charAt(i));\n  }\n  const remainder = 10 - (total % 11);\n  // When remainder is 10, the sequential part is\n  // never issued by GDT. Returning \"0\" keeps the\n  // function correct as a digit calculator (mod 10\n  // wrap) while still rejecting these numbers since\n  // no real MST will have this combination.\n  return String(\n    remainder >= 10 ? remainder - 10 : remainder,\n  );\n};\n\nconst compact = (value: string): string =>\n  clean(value, \" -.\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 10 && v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"MST must be 10 or 13 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"MST must contain only digits\",\n    );\n  }\n\n  // Sequential part (digits 3-9) must not be all zeros\n  if (v.slice(2, 9) === \"0000000\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"MST sequential part must not be 0000000\",\n    );\n  }\n\n  // Branch suffix (last 3 digits) must not be 000\n  if (v.length === 13 && v.slice(10) === \"000\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"MST branch suffix must not be 000\",\n    );\n  }\n\n  // Check digit (position 10, index 9)\n  if (v[9] !== calcCheckDigit(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"MST 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  if (v.length === 13) {\n    return `${v.slice(0, 10)}-${v.slice(10)}`;\n  }\n  return v;\n};\n\n/** Generate a random valid Vietnamese MST. */\nconst generate = (): string => {\n  for (;;) {\n    const province = String(randomInt(1, 99)).padStart(\n      2,\n      \"0\",\n    );\n    const payload = province + randomDigits(7);\n    const c = payload + calcCheckDigit(payload);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Vietnamese Tax Number. */\nconst mst: CountryValidator<\"VN\"> = {\n  name: \"Vietnamese Tax Number\",\n  localName: \"Mã số thuế\",\n  abbreviation: \"MST\",\n  aliases: [\"MST\", \"mã số thuế\"] as const,\n  candidatePattern: \"\\\\d{10}(-\\\\d{3})?\",\n  scope: \"country\",\n  country: \"VN\",\n  entityType: \"company\",\n  description:\n    \"10- or 13-digit tax identifier for enterprises\",\n  sourceUrl:\n    \"https://vi.wikipedia.org/wiki/Thu%E1%BA%BF_Vi%E1%BB%87t_Nam#M%C3%A3_s%E1%BB%91_thu%E1%BA%BF_(MST)_c%E1%BB%A7a_doanh_nghi%E1%BB%87p\",\n  lengths: [10, 13] as const,\n  examples: [\"0100233488\", \"0314409058002\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default mst;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AAuBA,MAAM,UAAU;CAAC;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAG;CAAG;AAAC;AAEhD,MAAM,kBAAkB,WAA2B;CACjD,IAAI,QAAQ;CACZ,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KACrB,UAAU,QAAQ,MAAM,KAAK,OAAO,OAAO,OAAO,CAAC,CAAC;CAEtD,MAAM,YAAY,KAAM,QAAQ;CAMhC,OAAO,OACL,aAAa,KAAK,YAAY,KAAK,SACrC;AACF;AAEA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CAEvB,IAAI,EAAE,WAAW,MAAM,EAAE,WAAW,IAClC,OAAO,IACL,kBACA,6BACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,8BACF;CAIF,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,WACpB,OAAO,IACL,qBACA,yCACF;CAIF,IAAI,EAAE,WAAW,MAAM,EAAE,MAAM,EAAE,MAAM,OACrC,OAAO,IACL,qBACA,mCACF;CAIF,IAAI,EAAE,OAAO,eAAe,CAAC,GAC3B,OAAO,IACL,oBACA,gCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,GAAG,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;CAExC,OAAO;AACT;;AAGA,MAAM,iBAAyB;CAC7B,SAAS;EAKP,MAAM,UAJW,OAAO,UAAU,GAAG,EAAE,CAAC,EAAE,SACxC,GACA,GAEqB,IAAI,aAAa,CAAC;EACzC,MAAM,IAAI,UAAU,eAAe,OAAO;EAC1C,IAAI,SAAS,CAAC,EAAE,OAAO,OAAO;CAChC;AACF;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,YAAY;CAC7B,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,aACE;CACF,WACE;CACF,SAAS,CAAC,IAAI,EAAE;CAChB,UAAU,CAAC,cAAc,eAAe;CACxC;CACA;CACA;CACA;AACF"}

package/dist/za/idnr.d.ts

@@ -1,4 +1,4 @@
-import { ParsedPersonId, ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ParsedPersonId, ValidateResult } from "../types.js";
 
 //#region src/za/idnr.d.ts
 declare const compact: (value: string) => string;
@@ -12,7 +12,7 @@ declare const parse: (value: string) => ParsedPersonId | null;
 /** Generate a random valid South African ID. */
 declare const generate: () => string;
 /** South African Identity Number. */
-declare const idnr: Validator<ParsedPersonId>;
+declare const idnr: CountryValidator<"ZA", ParsedPersonId>;
 //#endregion
 export { compact, idnr as default, format, generate, parse, validate };
 //# sourceMappingURL=idnr.d.ts.map

package/dist/za/idnr.js

@@ -1,24 +1,10 @@
+import { luhnChecksum, luhnValidate } from "../_checksums/luhn.js";
 import { clean } from "../_util/clean.js";
+import { isValidDate } from "../_util/date.js";
 import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
-import { luhnChecksum, luhnValidate } from "../_checksums/luhn.js";
 import { isdigits } from "../_util/strings.js";
-import { isValidDate } from "../_util/date.js";
 //#region src/za/idnr.ts
-/**
-* South African Identity Number.
-*
-* 13-digit number encoding date of birth, gender,
-* citizenship, and a Luhn check digit.
-* Format: YYMMDD SSSS C A Z
-*   - YYMMDD: date of birth
-*   - SSSS: sequence (0000-4999 female, 5000-9999 male)
-*   - C: citizenship (0 = citizen, 1 = permanent resident)
-*   - A: was used for race (now always 8 or 9)
-*   - Z: Luhn check digit
-*
-* @see https://en.wikipedia.org/wiki/South_African_identity_document
-*/
 const compact = (value) => clean(value, " ");
 /**
 * Resolve the birth date from the 2-digit year.
@@ -93,6 +79,7 @@ const idnr = {
 	abbreviation: "SA ID",
 	aliases: ["ID number", "RSA ID"],
 	candidatePattern: "\\d{13}",
+	scope: "country",
 	country: "ZA",
 	entityType: "person",
 	compact,

package/dist/za/idnr.js.map

@@ -1 +1 @@
-{"version":3,"file":"idnr.js","names":[],"sources":["../../src/za/idnr.ts"],"sourcesContent":["/**\n * South African Identity Number.\n *\n * 13-digit number encoding date of birth, gender,\n * citizenship, and a Luhn check digit.\n * Format: YYMMDD SSSS C A Z\n *   - YYMMDD: date of birth\n *   - SSSS: sequence (0000-4999 female, 5000-9999 male)\n *   - C: citizenship (0 = citizen, 1 = permanent resident)\n *   - A: was used for race (now always 8 or 9)\n *   - Z: Luhn check digit\n *\n * @see https://en.wikipedia.org/wiki/South_African_identity_document\n */\n\nimport {\n  luhnValidate,\n  luhnChecksum,\n} from \"#checksums/luhn\";\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" \");\n\n/**\n * Resolve the birth date from the 2-digit year.\n * Years after the current year are assumed to be\n * in the previous century.\n */\nconst resolveBirthDate = (\n  v: string,\n): { year: number; month: number; day: number } | null => {\n  const today = new Date();\n  const century = Math.floor(today.getFullYear() / 100);\n  let year = century * 100 + Number(v.slice(0, 2));\n  const month = Number(v.slice(2, 4));\n  const day = Number(v.slice(4, 6));\n  if (year > today.getFullYear()) {\n    year -= 100;\n  }\n  if (!isValidDate(year, month, day)) return null;\n  return { year, month, day };\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"SA ID must be exactly 13 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"SA ID must contain only digits\",\n    );\n  }\n  if (resolveBirthDate(v) === null) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"SA ID contains an invalid date of birth\",\n    );\n  }\n  const citizenship = v[10];\n  if (citizenship !== \"0\" && citizenship !== \"1\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"SA ID citizenship digit must be 0 or 1\",\n    );\n  }\n  if (!luhnValidate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"SA ID Luhn check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length === 13) {\n    return `${v.slice(0, 6)} ${v.slice(6, 10)} ${v.slice(10, 12)} ${v.slice(12)}`;\n  }\n  return v;\n};\n\n/**\n * Extract birth date and gender from a South African\n * ID number. Returns null if the value is not valid.\n */\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  const bd = resolveBirthDate(v);\n  if (bd === null) return null;\n\n  const sequence = Number(v.slice(6, 10));\n\n  return {\n    birthDate: new Date(bd.year, bd.month - 1, bd.day),\n    gender: sequence < 5000 ? \"female\" : \"male\",\n  };\n};\n\n/** Generate a random valid South African ID. */\nconst generate = (): string => {\n  for (;;) {\n    const yy = String(randomInt(50, 99)).padStart(2, \"0\");\n    const mm = String(randomInt(1, 12)).padStart(2, \"0\");\n    const dd = String(randomInt(1, 28)).padStart(2, \"0\");\n    const serial = randomDigits(4);\n    const citizen = String(randomInt(0, 1));\n    const payload = yy + mm + dd + serial + citizen + \"8\";\n    const cs = luhnChecksum(payload + \"0\");\n    const c = payload + String((10 - cs) % 10);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** South African Identity Number. */\nconst idnr: Validator<ParsedPersonId> = {\n  name: \"South African Identity Number\",\n  localName: \"South African Identity Number\",\n  abbreviation: \"SA ID\",\n  aliases: [\"ID number\", \"RSA ID\"] as const,\n  candidatePattern: \"\\\\d{13}\",\n  country: \"ZA\",\n  entityType: \"person\",\n  compact,\n  format,\n  parse,\n  validate,\n  description:\n    \"South African personal identification number\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/\" +\n    \"South_African_identity_document\",\n  lengths: [13] as const,\n  examples: [\"7503305044089\", \"8001015009087\"] as const,\n  generate,\n};\n\nexport default idnr;\nexport { compact, format, parse, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA+BA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;;;;;;AAOnB,MAAM,oBACJ,MACwD;CACxD,MAAM,wBAAQ,IAAI,MAAM;CAExB,IAAI,OADY,KAAK,MAAM,MAAM,aAAa,GAAG,IAAI,GAChC,MAAM,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChD,MAAM,QAAQ,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CACnC,MAAM,MAAM,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;AACjC,KAAI,OAAO,MAAM,aAAa,CAC5B,SAAQ;AAEV,KAAI,CAAC,YAAY,MAAM,OAAO,IAAI,CAAE,QAAO;AAC3C,QAAO;EAAE;EAAM;EAAO;EAAK;;AAG7B,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,kCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,iCACD;AAEH,KAAI,iBAAiB,EAAE,KAAK,KAC1B,QAAO,IACL,qBACA,0CACD;CAEH,MAAM,cAAc,EAAE;AACtB,KAAI,gBAAgB,OAAO,gBAAgB,IACzC,QAAO,IACL,qBACA,yCACD;AAEH,KAAI,CAAC,aAAa,EAAE,CAClB,QAAO,IACL,oBACA,kCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG;AAE7E,QAAO;;;;;;AAOT,MAAM,SAAS,UAAyC;CACtD,MAAM,SAAS,SAAS,MAAM;AAC9B,KAAI,CAAC,OAAO,MAAO,QAAO;CAE1B,MAAM,IAAI,OAAO;CACjB,MAAM,KAAK,iBAAiB,EAAE;AAC9B,KAAI,OAAO,KAAM,QAAO;CAExB,MAAM,WAAW,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC;AAEvC,QAAO;EACL,WAAW,IAAI,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,GAAG,IAAI;EAClD,QAAQ,WAAW,MAAO,WAAW;EACtC;;;AAIH,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,KAAK,OAAO,UAAU,IAAI,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI;EACrD,MAAM,KAAK,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI;EACpD,MAAM,KAAK,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI;EACpD,MAAM,SAAS,aAAa,EAAE;EAC9B,MAAM,UAAU,OAAO,UAAU,GAAG,EAAE,CAAC;EACvC,MAAM,UAAU,KAAK,KAAK,KAAK,SAAS,UAAU;EAClD,MAAM,KAAK,aAAa,UAAU,IAAI;EACtC,MAAM,IAAI,UAAU,QAAQ,KAAK,MAAM,GAAG;AAC1C,MAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;AAKlC,MAAM,OAAkC;CACtC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,aAAa,SAAS;CAChC,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ;CACA;CACA;CACA;CACA,aACE;CACF,WACE;CAEF,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,iBAAiB,gBAAgB;CAC5C;CACD"}
+{"version":3,"file":"idnr.js","names":[],"sources":["../../src/za/idnr.ts"],"sourcesContent":["/**\n * South African Identity Number.\n *\n * 13-digit number encoding date of birth, gender,\n * citizenship, and a Luhn check digit.\n * Format: YYMMDD SSSS C A Z\n *   - YYMMDD: date of birth\n *   - SSSS: sequence (0000-4999 female, 5000-9999 male)\n *   - C: citizenship (0 = citizen, 1 = permanent resident)\n *   - A: was used for race (now always 8 or 9)\n *   - Z: Luhn check digit\n *\n * @see https://en.wikipedia.org/wiki/South_African_identity_document\n */\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport {\n  luhnValidate,\n  luhnChecksum,\n} from \"#checksums/luhn\";\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\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 * Resolve the birth date from the 2-digit year.\n * Years after the current year are assumed to be\n * in the previous century.\n */\nconst resolveBirthDate = (\n  v: string,\n): { year: number; month: number; day: number } | null => {\n  const today = new Date();\n  const century = Math.floor(today.getFullYear() / 100);\n  let year = century * 100 + Number(v.slice(0, 2));\n  const month = Number(v.slice(2, 4));\n  const day = Number(v.slice(4, 6));\n  if (year > today.getFullYear()) {\n    year -= 100;\n  }\n  if (!isValidDate(year, month, day)) return null;\n  return { year, month, day };\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"SA ID must be exactly 13 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"SA ID must contain only digits\",\n    );\n  }\n  if (resolveBirthDate(v) === null) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"SA ID contains an invalid date of birth\",\n    );\n  }\n  const citizenship = v[10];\n  if (citizenship !== \"0\" && citizenship !== \"1\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"SA ID citizenship digit must be 0 or 1\",\n    );\n  }\n  if (!luhnValidate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"SA ID Luhn check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length === 13) {\n    return `${v.slice(0, 6)} ${v.slice(6, 10)} ${v.slice(10, 12)} ${v.slice(12)}`;\n  }\n  return v;\n};\n\n/**\n * Extract birth date and gender from a South African\n * ID number. Returns null if the value is not valid.\n */\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  const bd = resolveBirthDate(v);\n  if (bd === null) return null;\n\n  const sequence = Number(v.slice(6, 10));\n\n  return {\n    birthDate: new Date(bd.year, bd.month - 1, bd.day),\n    gender: sequence < 5000 ? \"female\" : \"male\",\n  };\n};\n\n/** Generate a random valid South African ID. */\nconst generate = (): string => {\n  for (;;) {\n    const yy = String(randomInt(50, 99)).padStart(2, \"0\");\n    const mm = String(randomInt(1, 12)).padStart(2, \"0\");\n    const dd = String(randomInt(1, 28)).padStart(2, \"0\");\n    const serial = randomDigits(4);\n    const citizen = String(randomInt(0, 1));\n    const payload = yy + mm + dd + serial + citizen + \"8\";\n    const cs = luhnChecksum(payload + \"0\");\n    const c = payload + String((10 - cs) % 10);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** South African Identity Number. */\nconst idnr: CountryValidator<\"ZA\", ParsedPersonId> = {\n  name: \"South African Identity Number\",\n  localName: \"South African Identity Number\",\n  abbreviation: \"SA ID\",\n  aliases: [\"ID number\", \"RSA ID\"] as const,\n  candidatePattern: \"\\\\d{13}\",\n  scope: \"country\",\n  country: \"ZA\",\n  entityType: \"person\",\n  compact,\n  format,\n  parse,\n  validate,\n  description:\n    \"South African personal identification number\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/\" +\n    \"South_African_identity_document\",\n  lengths: [13] as const,\n  examples: [\"7503305044089\", \"8001015009087\"] as const,\n  generate,\n};\n\nexport default idnr;\nexport { compact, format, parse, validate, generate };\n"],"mappings":";;;;;;;AA+BA,MAAM,WAAW,UACf,MAAM,OAAO,GAAG;;;;;;AAOlB,MAAM,oBACJ,MACwD;CACxD,MAAM,wBAAQ,IAAI,KAAK;CAEvB,IAAI,OADY,KAAK,MAAM,MAAM,YAAY,IAAI,GAChC,IAAI,MAAM,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/C,MAAM,QAAQ,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAClC,MAAM,MAAM,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAChC,IAAI,OAAO,MAAM,YAAY,GAC3B,QAAQ;CAEV,IAAI,CAAC,YAAY,MAAM,OAAO,GAAG,GAAG,OAAO;CAC3C,OAAO;EAAE;EAAM;EAAO;CAAI;AAC5B;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,iCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,gCACF;CAEF,IAAI,iBAAiB,CAAC,MAAM,MAC1B,OAAO,IACL,qBACA,yCACF;CAEF,MAAM,cAAc,EAAE;CACtB,IAAI,gBAAgB,OAAO,gBAAgB,KACzC,OAAO,IACL,qBACA,wCACF;CAEF,IAAI,CAAC,aAAa,CAAC,GACjB,OAAO,IACL,oBACA,iCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;CAE5E,OAAO;AACT;;;;;AAMA,MAAM,SAAS,UAAyC;CACtD,MAAM,SAAS,SAAS,KAAK;CAC7B,IAAI,CAAC,OAAO,OAAO,OAAO;CAE1B,MAAM,IAAI,OAAO;CACjB,MAAM,KAAK,iBAAiB,CAAC;CAC7B,IAAI,OAAO,MAAM,OAAO;CAExB,MAAM,WAAW,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAEtC,OAAO;EACL,WAAW,IAAI,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,GAAG,GAAG;EACjD,QAAQ,WAAW,MAAO,WAAW;CACvC;AACF;;AAGA,MAAM,iBAAyB;CAC7B,SAAS;EACP,MAAM,KAAK,OAAO,UAAU,IAAI,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;EACpD,MAAM,KAAK,OAAO,UAAU,GAAG,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;EACnD,MAAM,KAAK,OAAO,UAAU,GAAG,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;EACnD,MAAM,SAAS,aAAa,CAAC;EAC7B,MAAM,UAAU,OAAO,UAAU,GAAG,CAAC,CAAC;EACtC,MAAM,UAAU,KAAK,KAAK,KAAK,SAAS,UAAU;EAClD,MAAM,KAAK,aAAa,UAAU,GAAG;EACrC,MAAM,IAAI,UAAU,QAAQ,KAAK,MAAM,EAAE;EACzC,IAAI,SAAS,CAAC,EAAE,OAAO,OAAO;CAChC;AACF;;AAGA,MAAM,OAA+C;CACnD,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,aAAa,QAAQ;CAC/B,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ;CACA;CACA;CACA;CACA,aACE;CACF,WACE;CAEF,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,iBAAiB,eAAe;CAC3C;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/stdnum",
-  "version": "1.0.0",
+  "version": "2.0.1",
   "description": "Validate, compact, and format standard identifiers for Node.js and Bun. Pure TypeScript, zero dependencies, tree-shakeable per identifier.",
   "keywords": [
     "credit-card",
@@ -912,23 +912,33 @@
     "oracle": "bun scripts/oracle.ts --mode=gate",
     "oracle:gate": "bun scripts/oracle.ts --mode=gate",
     "oracle:survey": "bun scripts/oracle.ts --mode=survey",
-    "lint": "oxlint . --deny-warnings",
-    "format": "oxfmt .",
-    "format:check": "oxfmt --check .",
-    "typecheck": "tsc -p tsconfig.json"
+    "lint": "bun --bun oxlint -c oxlint.config.ts --report-unused-disable-directives-severity=error --deny-warnings --type-aware .",
+    "format": "oxfmt . \"!.ai/**\" \"!.agents/**\" \"!.claude/**\" \"!AGENTS.md\" \"!CLAUDE.md\" \"!GEMINI.md\"",
+    "format:check": "oxfmt --check . \"!.ai/**\" \"!.agents/**\" \"!.claude/**\" \"!AGENTS.md\" \"!CLAUDE.md\" \"!GEMINI.md\"",
+    "typecheck": "tsc -p tsconfig.json",
+    "sync-ai:check": "bash scripts/sync-ai-skills.sh --check",
+    "lint:fix": "bun --bun oxlint -c oxlint.config.ts --type-aware --fix .",
+    "version:check": "node scripts/version-sync.mjs check",
+    "version:sync": "node scripts/version-sync.mjs sync"
   },
   "devDependencies": {
-    "bun-types": "^1.3.10",
-    "fast-check": "^4.6.0",
+    "@brazilian-utils/brazilian-utils": "^2.3.0",
+    "@stll/oxlint-config": "^0.3.0",
+    "@stll/typescript-config": "^0.3.0",
+    "@types/node": "^25.9.1",
+    "bun-types": "^1.3.14",
+    "fast-check": "^4.8.0",
     "fast-luhn": "^2.0.2",
     "iban": "^0.0.14",
-    "ibantools": "^4.5.1",
+    "ibantools": "^4.5.4",
     "jsvat": "^2.5.4",
     "luhn": "^2.4.1",
-    "oxfmt": "^0.41.0",
-    "oxlint": "^1.55.0",
-    "stdnum": "^1.11.7",
-    "tsdown": "0.21.6",
+    "oxfmt": "^0.52.0",
+    "oxlint": "^1.67.0",
+    "oxlint-tsgolint": "^0.23.0",
+    "rut.js": "^2.1.0",
+    "stdnum": "^1.11.14",
+    "tsdown": "0.22.1",
     "typescript": "^5.9.3",
     "validate-polish": "^2.1.40"
   },

package/src/_checksums/mod1110.ts

@@ -19,6 +19,6 @@ export const mod1110checkDigit = (
 /** Validate a string with a Mod 11,10 check digit. */
 export const mod1110validate = (value: string): boolean => {
   const payload = value.slice(0, -1);
-  const check = Number(value[value.length - 1]);
+  const check = Number(value.at(-1));
   return mod1110checkDigit(payload) === check;
 };

package/src/ad/nrt.ts

@@ -25,6 +25,11 @@ const generate = (): string => {
  * @see https://www.oecd.org/tax/automatic-exchange/crs-implementation-and-assistance/tax-identification-numbers/Andorra-TIN.pdf
  */
 
+import type {
+  ValidateResult,
+  CountryValidator,
+} from "../types";
+
 import { clean } from "#util/clean";
 import {
   randomChar,
@@ -34,8 +39,6 @@ import {
 import { err } from "#util/result";
 import { isdigits } from "#util/strings";
 
-import type { ValidateResult, Validator } from "../types";
-
 const VALID_PREFIXES = "ACDEFGLOPU";
 
 const compact = (value: string): string =>
@@ -98,12 +101,13 @@ const format = (value: string): string => {
 };
 
 /** Andorra NRT (Número de Registre Tributari). */
-const nrt: Validator = {
+const nrt: CountryValidator<"AD"> = {
   name: "Andorra Tax Number",
   localName: "Número de Registre Tributari",
   abbreviation: "NRT",
   aliases: ["NRT", "Número de Registre Tributari"] as const,
   candidatePattern: "[A-Z]-?\\d{6}-?[A-Z]",
+  scope: "country",
   country: "AD",
   entityType: "any",
   sourceUrl: