@stll/stdnum 1.0.0 → 2.0.1

package/dist/bg/egn.js

@@ -1,26 +1,10 @@
+import { weightedSum } from "../_checksums/weighted-sum.js";
 import { clean } from "../_util/clean.js";
+import { isValidDate } from "../_util/date.js";
 import { randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
-import { weightedSum } from "../_checksums/weighted-sum.js";
-import { isValidDate } from "../_util/date.js";
 //#region src/bg/egn.ts
-/**
-* EGN (Единен граждански номер).
-*
-* Bulgarian personal identification number.
-* 10 digits encoding date of birth, serial number,
-* and a check digit.
-*
-* Canonical source:
-* - GRAO regulation PDF describing the EGN structure.
-*
-* We treat this as authoritative over third-party
-* oracle libraries when the checksum or date rules
-* disagree.
-*
-* @see https://www.grao.bg/normact/NaredbaFunkcESGR.pdf
-*/
 const WEIGHTS = [
 	2,
 	4,
@@ -113,6 +97,7 @@ const egn = {
 		"EGN"
 	],
 	candidatePattern: "\\d{10}",
+	scope: "country",
 	country: "BG",
 	entityType: "person",
 	sourceUrl: "https://www.grao.bg/normact/NaredbaFunkcESGR.pdf",

package/dist/bg/egn.js.map

@@ -1 +1 @@
-{"version":3,"file":"egn.js","names":[],"sources":["../../src/bg/egn.ts"],"sourcesContent":["/**\n * EGN (Единен граждански номер).\n *\n * Bulgarian personal identification number.\n * 10 digits encoding date of birth, serial number,\n * and a check digit.\n *\n * Canonical source:\n * - GRAO regulation PDF describing the EGN structure.\n *\n * We treat this as authoritative over third-party\n * oracle libraries when the checksum or date rules\n * disagree.\n *\n * @see https://www.grao.bg/normact/NaredbaFunkcESGR.pdf\n */\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { 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 WEIGHTS = [2, 4, 8, 5, 10, 9, 7, 3, 6] as const;\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"EGN must be exactly 10 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"EGN must contain only digits\",\n    );\n  }\n\n  const yy = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const dd = Number(v.slice(4, 6));\n\n  let year: number;\n  let month: number;\n  if (mm > 40) {\n    year = 2000 + yy;\n    month = mm - 40;\n  } else if (mm > 20) {\n    year = 1800 + yy;\n    month = mm - 20;\n  } else {\n    year = 1900 + yy;\n    month = mm;\n  }\n\n  if (!isValidDate(year, month, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"EGN contains an invalid date\",\n    );\n  }\n\n  const sum = weightedSum(v.slice(0, 9), WEIGHTS, 11);\n  const check = sum % 10;\n  if (check !== Number(v[9])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"EGN check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/**\n * Extract birth date and gender from an EGN.\n * 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 yy = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const dd = Number(v.slice(4, 6));\n  const serial = Number(v.slice(6, 9));\n\n  let year: number;\n  let month: number;\n  if (mm > 40) {\n    year = 2000 + yy;\n    month = mm - 40;\n  } else if (mm > 20) {\n    year = 1800 + yy;\n    month = mm - 20;\n  } else {\n    year = 1900 + yy;\n    month = mm;\n  }\n\n  return {\n    birthDate: new Date(year, month - 1, dd),\n    gender: serial % 2 === 0 ? \"male\" : \"female\",\n  };\n};\n\n/** Generate a random valid EGN. */\nconst generate = (): string => {\n  for (;;) {\n    const yy = String(randomInt(0, 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 = String(randomInt(0, 999)).padStart(\n      3,\n      \"0\",\n    );\n    const payload = yy + mm + dd + serial;\n    const sum = weightedSum(payload, WEIGHTS, 11);\n    const c = payload + String(sum % 10);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Bulgarian Personal Identification Number. */\nconst egn: Validator<ParsedPersonId> = {\n  name: \"Bulgarian Personal ID\",\n  localName: \"Единен граждански номер\",\n  abbreviation: \"ЕГН\",\n  aliases: [\n    \"ЕГН\",\n    \"единен граждански номер\",\n    \"EGN\",\n  ] as const,\n  candidatePattern: \"\\\\d{10}\",\n  country: \"BG\",\n  entityType: \"person\",\n  sourceUrl:\n    \"https://www.grao.bg/normact/NaredbaFunkcESGR.pdf\",\n  examples: [\"7523169263\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default egn;\nexport { compact, format, parse, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA8BA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAI;CAAG;CAAG;CAAG;CAAE;AAE5C,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;CAGH,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAEhC,IAAI;CACJ,IAAI;AACJ,KAAI,KAAK,IAAI;AACX,SAAO,MAAO;AACd,UAAQ,KAAK;YACJ,KAAK,IAAI;AAClB,SAAO,OAAO;AACd,UAAQ,KAAK;QACR;AACL,SAAO,OAAO;AACd,UAAQ;;AAGV,KAAI,CAAC,YAAY,MAAM,OAAO,GAAG,CAC/B,QAAO,IACL,qBACA,+BACD;AAKH,KAFY,YAAY,EAAE,MAAM,GAAG,EAAE,EAAE,SAAS,GAAG,GAC/B,OACN,OAAO,EAAE,GAAG,CACxB,QAAO,IACL,oBACA,iCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;;;;AAMxD,MAAM,SAAS,UAAyC;CACtD,MAAM,SAAS,SAAS,MAAM;AAC9B,KAAI,CAAC,OAAO,MAAO,QAAO;CAE1B,MAAM,IAAI,OAAO;CACjB,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,SAAS,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAEpC,IAAI;CACJ,IAAI;AACJ,KAAI,KAAK,IAAI;AACX,SAAO,MAAO;AACd,UAAQ,KAAK;YACJ,KAAK,IAAI;AAClB,SAAO,OAAO;AACd,UAAQ,KAAK;QACR;AACL,SAAO,OAAO;AACd,UAAQ;;AAGV,QAAO;EACL,WAAW,IAAI,KAAK,MAAM,QAAQ,GAAG,GAAG;EACxC,QAAQ,SAAS,MAAM,IAAI,SAAS;EACrC;;;AAIH,MAAM,iBAAyB;AAC7B,UAAS;EACP,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,KAAK,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI;EACpD,MAAM,SAAS,OAAO,UAAU,GAAG,IAAI,CAAC,CAAC,SACvC,GACA,IACD;EACD,MAAM,UAAU,KAAK,KAAK,KAAK;EAC/B,MAAM,MAAM,YAAY,SAAS,SAAS,GAAG;EAC7C,MAAM,IAAI,UAAU,OAAO,MAAM,GAAG;AACpC,MAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;AAKlC,MAAM,MAAiC;CACrC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WACE;CACF,UAAU,CAAC,aAAa;CACxB;CACA;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"egn.js","names":[],"sources":["../../src/bg/egn.ts"],"sourcesContent":["/**\n * EGN (Единен граждански номер).\n *\n * Bulgarian personal identification number.\n * 10 digits encoding date of birth, serial number,\n * and a check digit.\n *\n * Canonical source:\n * - GRAO regulation PDF describing the EGN structure.\n *\n * We treat this as authoritative over third-party\n * oracle libraries when the checksum or date rules\n * disagree.\n *\n * @see https://www.grao.bg/normact/NaredbaFunkcESGR.pdf\n */\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst WEIGHTS = [2, 4, 8, 5, 10, 9, 7, 3, 6] as const;\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"EGN must be exactly 10 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"EGN must contain only digits\",\n    );\n  }\n\n  const yy = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const dd = Number(v.slice(4, 6));\n\n  let year: number;\n  let month: number;\n  if (mm > 40) {\n    year = 2000 + yy;\n    month = mm - 40;\n  } else if (mm > 20) {\n    year = 1800 + yy;\n    month = mm - 20;\n  } else {\n    year = 1900 + yy;\n    month = mm;\n  }\n\n  if (!isValidDate(year, month, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"EGN contains an invalid date\",\n    );\n  }\n\n  const sum = weightedSum(v.slice(0, 9), WEIGHTS, 11);\n  const check = sum % 10;\n  if (check !== Number(v[9])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"EGN check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/**\n * Extract birth date and gender from an EGN.\n * 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 yy = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const dd = Number(v.slice(4, 6));\n  const serial = Number(v.slice(6, 9));\n\n  let year: number;\n  let month: number;\n  if (mm > 40) {\n    year = 2000 + yy;\n    month = mm - 40;\n  } else if (mm > 20) {\n    year = 1800 + yy;\n    month = mm - 20;\n  } else {\n    year = 1900 + yy;\n    month = mm;\n  }\n\n  return {\n    birthDate: new Date(year, month - 1, dd),\n    gender: serial % 2 === 0 ? \"male\" : \"female\",\n  };\n};\n\n/** Generate a random valid EGN. */\nconst generate = (): string => {\n  for (;;) {\n    const yy = String(randomInt(0, 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 = String(randomInt(0, 999)).padStart(\n      3,\n      \"0\",\n    );\n    const payload = yy + mm + dd + serial;\n    const sum = weightedSum(payload, WEIGHTS, 11);\n    const c = payload + String(sum % 10);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Bulgarian Personal Identification Number. */\nconst egn: CountryValidator<\"BG\", ParsedPersonId> = {\n  name: \"Bulgarian Personal ID\",\n  localName: \"Единен граждански номер\",\n  abbreviation: \"ЕГН\",\n  aliases: [\n    \"ЕГН\",\n    \"единен граждански номер\",\n    \"EGN\",\n  ] as const,\n  candidatePattern: \"\\\\d{10}\",\n  scope: \"country\",\n  country: \"BG\",\n  entityType: \"person\",\n  sourceUrl:\n    \"https://www.grao.bg/normact/NaredbaFunkcESGR.pdf\",\n  examples: [\"7523169263\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default egn;\nexport { compact, format, parse, validate, generate };\n"],"mappings":";;;;;;;AA8BA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAI;CAAG;CAAG;CAAG;AAAC;AAE3C,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;CAGF,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAE/B,IAAI;CACJ,IAAI;CACJ,IAAI,KAAK,IAAI;EACX,OAAO,MAAO;EACd,QAAQ,KAAK;CACf,OAAO,IAAI,KAAK,IAAI;EAClB,OAAO,OAAO;EACd,QAAQ,KAAK;CACf,OAAO;EACL,OAAO,OAAO;EACd,QAAQ;CACV;CAEA,IAAI,CAAC,YAAY,MAAM,OAAO,EAAE,GAC9B,OAAO,IACL,qBACA,8BACF;CAKF,IAFY,YAAY,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,EAChC,IAAI,OACN,OAAO,EAAE,EAAE,GACvB,OAAO,IACL,oBACA,gCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;;;;AAMvD,MAAM,SAAS,UAAyC;CACtD,MAAM,SAAS,SAAS,KAAK;CAC7B,IAAI,CAAC,OAAO,OAAO,OAAO;CAE1B,MAAM,IAAI,OAAO;CACjB,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,SAAS,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAEnC,IAAI;CACJ,IAAI;CACJ,IAAI,KAAK,IAAI;EACX,OAAO,MAAO;EACd,QAAQ,KAAK;CACf,OAAO,IAAI,KAAK,IAAI;EAClB,OAAO,OAAO;EACd,QAAQ,KAAK;CACf,OAAO;EACL,OAAO,OAAO;EACd,QAAQ;CACV;CAEA,OAAO;EACL,WAAW,IAAI,KAAK,MAAM,QAAQ,GAAG,EAAE;EACvC,QAAQ,SAAS,MAAM,IAAI,SAAS;CACtC;AACF;;AAGA,MAAM,iBAAyB;CAC7B,SAAS;EACP,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,KAAK,OAAO,UAAU,GAAG,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;EACnD,MAAM,SAAS,OAAO,UAAU,GAAG,GAAG,CAAC,EAAE,SACvC,GACA,GACF;EACA,MAAM,UAAU,KAAK,KAAK,KAAK;EAC/B,MAAM,MAAM,YAAY,SAAS,SAAS,EAAE;EAC5C,MAAM,IAAI,UAAU,OAAO,MAAM,EAAE;EACnC,IAAI,SAAS,CAAC,EAAE,OAAO,OAAO;CAChC;AACF;;AAGA,MAAM,MAA8C;CAClD,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;CACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WACE;CACF,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;CACA;AACF"}

package/dist/bg/pnf.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/bg/pnf.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid PNF. */
 declare const generate: () => string;
 /** Bulgarian Personal Number of a Foreigner. */
-declare const pnf: Validator;
+declare const pnf: CountryValidator<"BG">;
 //#endregion
 export { compact, pnf as default, format, generate, validate };
 //# sourceMappingURL=pnf.d.ts.map

package/dist/bg/pnf.js

@@ -3,14 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/bg/pnf.ts
-/**
-* PNF (ЛНЧ, Личен номер на чужденец).
-*
-* Bulgarian personal number of a foreigner.
-* 10 digits; the last digit is a weighted checksum.
-*
-* @see https://en.wikipedia.org/wiki/Unique_citizenship_number
-*/
 const WEIGHTS = [
 	21,
 	19,
@@ -55,6 +47,7 @@ const pnf = {
 		"PNF"
 	],
 	candidatePattern: "\\d{10}",
+	scope: "country",
 	country: "BG",
 	entityType: "person",
 	sourceUrl: "https://en.wikipedia.org/wiki/Unique_citizenship_number",

package/dist/bg/pnf.js.map

@@ -1 +1 @@
-{"version":3,"file":"pnf.js","names":[],"sources":["../../src/bg/pnf.ts"],"sourcesContent":["/**\n * PNF (ЛНЧ, Личен номер на чужденец).\n *\n * Bulgarian personal number of a foreigner.\n * 10 digits; the last digit is a weighted checksum.\n *\n * @see https://en.wikipedia.org/wiki/Unique_citizenship_number\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 = [21, 19, 17, 13, 11, 9, 7, 3, 1] as const;\n\nconst compact = (value: string): string =>\n  clean(value, \" -.\");\n\nconst calcCheckDigit = (number: string): string => {\n  let sum = 0;\n  for (let i = 0; i < 9; i++) {\n    // SAFETY: WEIGHTS has exactly 9 entries\n    // eslint-disable-next-line no-non-null-assertion\n    sum += WEIGHTS[i]! * Number(number[i]);\n  }\n  return String(sum % 10);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"PNF must be exactly 10 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"PNF must contain only digits\",\n    );\n  }\n  if (calcCheckDigit(v.slice(0, 9)) !== v[9]) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"PNF check digit does not match\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid PNF. */\nconst generate = (): string => {\n  const payload = randomDigits(9);\n  return payload + calcCheckDigit(payload);\n};\n\n/** Bulgarian Personal Number of a Foreigner. */\nconst pnf: Validator = {\n  name: \"Bulgarian Foreigner Number\",\n  localName: \"Личен номер на чужденец\",\n  abbreviation: \"ЛНЧ\",\n  aliases: [\n    \"ЛНЧ\",\n    \"личен номер на чужденец\",\n    \"PNF\",\n  ] as const,\n  candidatePattern: \"\\\\d{10}\",\n  country: \"BG\",\n  entityType: \"person\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Unique_citizenship_number\",\n  examples: [\"7111042925\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default pnf;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;AAgBA,MAAM,UAAU;CAAC;CAAI;CAAI;CAAI;CAAI;CAAI;CAAG;CAAG;CAAG;CAAE;AAEhD,MAAM,WAAW,UACf,MAAM,OAAO,MAAM;AAErB,MAAM,kBAAkB,WAA2B;CACjD,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IAGrB,QAAO,QAAQ,KAAM,OAAO,OAAO,GAAG;AAExC,QAAO,OAAO,MAAM,GAAG;;AAGzB,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;AAEH,KAAI,eAAe,EAAE,MAAM,GAAG,EAAE,CAAC,KAAK,EAAE,GACtC,QAAO,IACL,oBACA,iCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,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;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WACE;CACF,UAAU,CAAC,aAAa;CACxB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"pnf.js","names":[],"sources":["../../src/bg/pnf.ts"],"sourcesContent":["/**\n * PNF (ЛНЧ, Личен номер на чужденец).\n *\n * Bulgarian personal number of a foreigner.\n * 10 digits; the last digit is a weighted checksum.\n *\n * @see https://en.wikipedia.org/wiki/Unique_citizenship_number\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 = [21, 19, 17, 13, 11, 9, 7, 3, 1] as const;\n\nconst compact = (value: string): string =>\n  clean(value, \" -.\");\n\nconst calcCheckDigit = (number: string): string => {\n  let sum = 0;\n  for (let i = 0; i < 9; i++) {\n    // SAFETY: WEIGHTS has exactly 9 entries\n    // eslint-disable-next-line no-non-null-assertion\n    sum += WEIGHTS[i]! * Number(number[i]);\n  }\n  return String(sum % 10);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"PNF must be exactly 10 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"PNF must contain only digits\",\n    );\n  }\n  if (calcCheckDigit(v.slice(0, 9)) !== v[9]) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"PNF check digit does not match\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid PNF. */\nconst generate = (): string => {\n  const payload = randomDigits(9);\n  return payload + calcCheckDigit(payload);\n};\n\n/** Bulgarian Personal Number of a Foreigner. */\nconst pnf: CountryValidator<\"BG\"> = {\n  name: \"Bulgarian Foreigner Number\",\n  localName: \"Личен номер на чужденец\",\n  abbreviation: \"ЛНЧ\",\n  aliases: [\n    \"ЛНЧ\",\n    \"личен номер на чужденец\",\n    \"PNF\",\n  ] as const,\n  candidatePattern: \"\\\\d{10}\",\n  scope: \"country\",\n  country: \"BG\",\n  entityType: \"person\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Unique_citizenship_number\",\n  examples: [\"7111042925\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default pnf;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AAmBA,MAAM,UAAU;CAAC;CAAI;CAAI;CAAI;CAAI;CAAI;CAAG;CAAG;CAAG;AAAC;AAE/C,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,kBAAkB,WAA2B;CACjD,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAGrB,OAAO,QAAQ,KAAM,OAAO,OAAO,EAAE;CAEvC,OAAO,OAAO,MAAM,EAAE;AACxB;AAEA,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;CAEF,IAAI,eAAe,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,IACtC,OAAO,IACL,oBACA,gCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,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;EACP;EACA;EACA;CACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WACE;CACF,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;AACF"}

package/dist/bg/vat.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/bg/vat.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid 9-digit Bulgarian VAT. */
 declare const generate: () => string;
 /** Bulgarian VAT Number. */
-declare const vat: Validator;
+declare const vat: CountryValidator<"BG">;
 //#endregion
 export { compact, vat as default, format, generate, validate };
 //# sourceMappingURL=vat.d.ts.map

package/dist/bg/vat.js

@@ -1,17 +1,9 @@
+import { weightedSum } from "../_checksums/weighted-sum.js";
 import { clean } from "../_util/clean.js";
 import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
-import { weightedSum } from "../_checksums/weighted-sum.js";
 //#region src/bg/vat.ts
-/**
-* ИН по ДДС (Bulgarian VAT number).
-*
-* 9 or 10 digits with weighted checksum.
-*
-* @see https://www.vatify.eu/bulgaria-vat-number.html
-* @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/bulgaria-tin.pdf
-*/
 const compact = (value) => {
 	let v = clean(value, " -/.");
 	if (v.startsWith("BG") || v.startsWith("bg")) v = v.slice(2);
@@ -138,9 +130,11 @@ const vat = {
 	abbreviation: "ИН по ДДС",
 	aliases: ["ДДС", "идентификационен номер по ДДС"],
 	candidatePattern: "BG\\d{9,10}",
+	scope: "country",
 	country: "BG",
 	entityType: "any",
 	sourceUrl: "https://www.nra.bg/",
+	lengths: [9, 10],
 	examples: ["175074752"],
 	compact,
 	format,

package/dist/bg/vat.js.map

@@ -1 +1 @@
-{"version":3,"file":"vat.js","names":[],"sources":["../../src/bg/vat.ts"],"sourcesContent":["/**\n * ИН по ДДС (Bulgarian VAT number).\n *\n * 9 or 10 digits with weighted checksum.\n *\n * @see https://www.vatify.eu/bulgaria-vat-number.html\n * @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/bulgaria-tin.pdf\n */\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\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  let v = clean(value, \" -/.\");\n  if (v.startsWith(\"BG\") || v.startsWith(\"bg\")) {\n    v = v.slice(2);\n  }\n  return v;\n};\n\nconst d = (v: string, i: number): number => Number(v[i]);\n\nconst WEIGHTS_9_PASS1 = [1, 2, 3, 4, 5, 6, 7, 8];\nconst WEIGHTS_9_PASS2 = [3, 4, 5, 6, 7, 8, 9, 10];\nconst WEIGHTS_EGN = [2, 4, 8, 5, 10, 9, 7, 3, 6];\nconst WEIGHTS_PNF = [21, 19, 17, 13, 11, 9, 7, 3, 1];\nconst WEIGHTS_OTHER = [4, 3, 2, 7, 6, 5, 4, 3, 2];\n\nconst validate9 = (v: string): boolean => {\n  let check = weightedSum(\n    v.slice(0, 8),\n    WEIGHTS_9_PASS1,\n    11,\n  );\n  if (check === 10) {\n    check = weightedSum(v.slice(0, 8), WEIGHTS_9_PASS2, 11);\n  }\n  return check % 10 === d(v, 8);\n};\n\n/**\n * Validate a 10-digit EGN (personal code).\n * First 6 digits encode birth date (YYMMDD with month\n * offsets: +20 for 1800s, +40 for 2000s). Check digit\n * uses weights [2,4,8,5,10,9,7,3,6], sum % 11 % 10.\n */\nconst validateEgn = (v: string): boolean => {\n  const year = d(v, 0) * 10 + d(v, 1);\n  let month = d(v, 2) * 10 + d(v, 3);\n  const day = d(v, 4) * 10 + d(v, 5);\n  let fullYear = year + 1900;\n  if (month > 40) {\n    fullYear += 100;\n    month -= 40;\n  } else if (month > 20) {\n    fullYear -= 100;\n    month -= 20;\n  }\n  // Validate the birth date\n  const date = new Date(fullYear, month - 1, day);\n  if (\n    date.getFullYear() !== fullYear ||\n    date.getMonth() !== month - 1 ||\n    date.getDate() !== day\n  ) {\n    return false;\n  }\n  const sum = weightedSum(v.slice(0, 9), WEIGHTS_EGN, 11);\n  return sum % 10 === d(v, 9);\n};\n\n/**\n * Validate a 10-digit PNF (foreigner personal number).\n * Weights [21,19,17,13,11,9,7,3,1], sum % 10.\n */\nconst validatePnf = (v: string): boolean => {\n  const sum = weightedSum(v.slice(0, 9), WEIGHTS_PNF, 10);\n  return sum === d(v, 9);\n};\n\n/**\n * Validate a 10-digit \"other\" VAT number.\n * Weights [4,3,2,7,6,5,4,3,2], (11 - sum%11) % 11.\n */\nconst validateOther = (v: string): boolean => {\n  const sum = weightedSum(v.slice(0, 9), WEIGHTS_OTHER, 11);\n  return (11 - sum) % 11 === d(v, 9);\n};\n\nconst validate10 = (v: string): boolean =>\n  validateEgn(v) || validatePnf(v) || validateOther(v);\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9 && v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Bulgarian VAT number must be 9 or 10 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Bulgarian VAT number must contain only digits\",\n    );\n  }\n  const valid =\n    v.length === 9 ? validate9(v) : validate10(v);\n  if (!valid) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Bulgarian VAT number check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `BG${compact(value)}`;\n\n/** Generate a random valid 9-digit Bulgarian VAT. */\nconst generate = (): string => {\n  for (;;) {\n    const c = randomDigits(9);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Bulgarian VAT Number. */\nconst vat: Validator = {\n  name: \"Bulgarian VAT Number\",\n  localName: \"ИН по ДДС\",\n  abbreviation: \"ИН по ДДС\",\n  aliases: [\n    \"ДДС\",\n    \"идентификационен номер по ДДС\",\n  ] as const,\n  candidatePattern: \"BG\\\\d{9,10}\",\n  country: \"BG\",\n  entityType: \"any\",\n  sourceUrl: \"https://www.nra.bg/\",\n  examples: [\"175074752\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vat;\nexport { compact, format, validate, generate };\n"],"mappings":"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"}
+{"version":3,"file":"vat.js","names":[],"sources":["../../src/bg/vat.ts"],"sourcesContent":["/**\n * ИН по ДДС (Bulgarian VAT number).\n *\n * 9 or 10 digits with weighted checksum.\n *\n * @see https://www.vatify.eu/bulgaria-vat-number.html\n * @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/bulgaria-tin.pdf\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\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  let v = clean(value, \" -/.\");\n  if (v.startsWith(\"BG\") || v.startsWith(\"bg\")) {\n    v = v.slice(2);\n  }\n  return v;\n};\n\nconst d = (v: string, i: number): number => Number(v[i]);\n\nconst WEIGHTS_9_PASS1 = [1, 2, 3, 4, 5, 6, 7, 8];\nconst WEIGHTS_9_PASS2 = [3, 4, 5, 6, 7, 8, 9, 10];\nconst WEIGHTS_EGN = [2, 4, 8, 5, 10, 9, 7, 3, 6];\nconst WEIGHTS_PNF = [21, 19, 17, 13, 11, 9, 7, 3, 1];\nconst WEIGHTS_OTHER = [4, 3, 2, 7, 6, 5, 4, 3, 2];\n\nconst validate9 = (v: string): boolean => {\n  let check = weightedSum(\n    v.slice(0, 8),\n    WEIGHTS_9_PASS1,\n    11,\n  );\n  if (check === 10) {\n    check = weightedSum(v.slice(0, 8), WEIGHTS_9_PASS2, 11);\n  }\n  return check % 10 === d(v, 8);\n};\n\n/**\n * Validate a 10-digit EGN (personal code).\n * First 6 digits encode birth date (YYMMDD with month\n * offsets: +20 for 1800s, +40 for 2000s). Check digit\n * uses weights [2,4,8,5,10,9,7,3,6], sum % 11 % 10.\n */\nconst validateEgn = (v: string): boolean => {\n  const year = d(v, 0) * 10 + d(v, 1);\n  let month = d(v, 2) * 10 + d(v, 3);\n  const day = d(v, 4) * 10 + d(v, 5);\n  let fullYear = year + 1900;\n  if (month > 40) {\n    fullYear += 100;\n    month -= 40;\n  } else if (month > 20) {\n    fullYear -= 100;\n    month -= 20;\n  }\n  // Validate the birth date\n  const date = new Date(fullYear, month - 1, day);\n  if (\n    date.getFullYear() !== fullYear ||\n    date.getMonth() !== month - 1 ||\n    date.getDate() !== day\n  ) {\n    return false;\n  }\n  const sum = weightedSum(v.slice(0, 9), WEIGHTS_EGN, 11);\n  return sum % 10 === d(v, 9);\n};\n\n/**\n * Validate a 10-digit PNF (foreigner personal number).\n * Weights [21,19,17,13,11,9,7,3,1], sum % 10.\n */\nconst validatePnf = (v: string): boolean => {\n  const sum = weightedSum(v.slice(0, 9), WEIGHTS_PNF, 10);\n  return sum === d(v, 9);\n};\n\n/**\n * Validate a 10-digit \"other\" VAT number.\n * Weights [4,3,2,7,6,5,4,3,2], (11 - sum%11) % 11.\n */\nconst validateOther = (v: string): boolean => {\n  const sum = weightedSum(v.slice(0, 9), WEIGHTS_OTHER, 11);\n  return (11 - sum) % 11 === d(v, 9);\n};\n\nconst validate10 = (v: string): boolean =>\n  validateEgn(v) || validatePnf(v) || validateOther(v);\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9 && v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Bulgarian VAT number must be 9 or 10 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Bulgarian VAT number must contain only digits\",\n    );\n  }\n  const valid =\n    v.length === 9 ? validate9(v) : validate10(v);\n  if (!valid) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Bulgarian VAT number check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `BG${compact(value)}`;\n\n/** Generate a random valid 9-digit Bulgarian VAT. */\nconst generate = (): string => {\n  for (;;) {\n    const c = randomDigits(9);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Bulgarian VAT Number. */\nconst vat: CountryValidator<\"BG\"> = {\n  name: \"Bulgarian VAT Number\",\n  localName: \"ИН по ДДС\",\n  abbreviation: \"ИН по ДДС\",\n  aliases: [\n    \"ДДС\",\n    \"идентификационен номер по ДДС\",\n  ] as const,\n  candidatePattern: \"BG\\\\d{9,10}\",\n  scope: \"country\",\n  country: \"BG\",\n  entityType: \"any\",\n  sourceUrl: \"https://www.nra.bg/\",\n  lengths: [9, 10] as const,\n  examples: [\"175074752\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vat;\nexport { compact, format, validate, generate };\n"],"mappings":"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"}

package/dist/bh/cpr.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/bh/cpr.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ declare const format: (value: string) => string;
 /** Generate a random structurally valid Bahrain CPR. */
 declare const generate: () => string;
 /** Bahrain Central Population Registration number. */
-declare const cpr: Validator;
+declare const cpr: CountryValidator<"BH">;
 //#endregion
 export { compact, cpr as default, format, generate, validate };
 //# sourceMappingURL=cpr.d.ts.map

package/dist/bh/cpr.js

@@ -3,23 +3,6 @@ import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/bh/cpr.ts
-/**
-* CPR (Central Population Registration number, Bahrain).
-*
-* 9-digit personal identification number:
-*   YYMM  = year and month of birth
-*   NNNN  = serial number
-*   C     = check digit
-*
-* The check digit algorithm is not publicly
-* documented; validation is structural only
-* (length, digits, and valid birth month).
-*
-* Note: a minority of older CPR numbers do not
-* follow the YYMMNNNNC format.
-*
-* @see https://www.bahrain.bh/wps/portal/IDInfo_en
-*/
 const compact = (value) => clean(value, " -");
 const validate = (value) => {
 	const v = compact(value);
@@ -47,6 +30,7 @@ const cpr = {
 	abbreviation: "CPR",
 	aliases: ["CPR", "الرقم السكاني"],
 	candidatePattern: "\\d{9}",
+	scope: "country",
 	country: "BH",
 	entityType: "person",
 	lengths: [9],

package/dist/bh/cpr.js.map

@@ -1 +1 @@
-{"version":3,"file":"cpr.js","names":[],"sources":["../../src/bh/cpr.ts"],"sourcesContent":["/**\n * CPR (Central Population Registration number, Bahrain).\n *\n * 9-digit personal identification number:\n *   YYMM  = year and month of birth\n *   NNNN  = serial number\n *   C     = check digit\n *\n * The check digit algorithm is not publicly\n * documented; validation is structural only\n * (length, digits, and valid birth month).\n *\n * Note: a minority of older CPR numbers do not\n * follow the YYMMNNNNC format.\n *\n * @see https://www.bahrain.bh/wps/portal/IDInfo_en\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\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Bahrain CPR must be 9 digits\",\n    );\n  }\n\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Bahrain CPR must contain only digits\",\n    );\n  }\n\n  // Validate birth month (digits 3-4) is 01-12\n  const mm = Number(v.slice(2, 4));\n  if (mm < 1 || mm > 12) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"CPR birth month must be 01-12\",\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, 4)}-${v.slice(4)}`;\n};\n\n/** Generate a random structurally valid Bahrain CPR. */\nconst generate = (): string => {\n  const yy = String(randomInt(0, 99)).padStart(2, \"0\");\n  const mm = String(randomInt(1, 12)).padStart(2, \"0\");\n  return `${yy}${mm}${randomDigits(5)}`;\n};\n\n/** Bahrain Central Population Registration number. */\nconst cpr: Validator = {\n  name: \"Central Population Registration Number\",\n  localName: \"الرقم السكاني\",\n  abbreviation: \"CPR\",\n  aliases: [\"CPR\", \"الرقم السكاني\"] as const,\n  candidatePattern: \"\\\\d{9}\",\n  country: \"BH\",\n  entityType: \"person\",\n  lengths: [9] as const,\n  examples: [\"890112345\", \"000612345\"] as const,\n  description: \"9-digit personal identification number\",\n  sourceUrl: \"https://www.bahrain.bh/wps/portal/IDInfo_en\",\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default cpr;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAyBA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,+BACD;AAGH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,uCACD;CAIH,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;AAChC,KAAI,KAAK,KAAK,KAAK,GACjB,QAAO,IACL,qBACA,gCACD;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,EAAE;;;AAIxD,MAAM,iBAAyB;AAG7B,QAAO,GAFI,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI,GACzC,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI,GAChC,aAAa,EAAE;;;AAIrC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,gBAAgB;CACjC,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,aAAa,YAAY;CACpC,aAAa;CACb,WAAW;CACX;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"cpr.js","names":[],"sources":["../../src/bh/cpr.ts"],"sourcesContent":["/**\n * CPR (Central Population Registration number, Bahrain).\n *\n * 9-digit personal identification number:\n *   YYMM  = year and month of birth\n *   NNNN  = serial number\n *   C     = check digit\n *\n * The check digit algorithm is not publicly\n * documented; validation is structural only\n * (length, digits, and valid birth month).\n *\n * Note: a minority of older CPR numbers do not\n * follow the YYMMNNNNC format.\n *\n * @see https://www.bahrain.bh/wps/portal/IDInfo_en\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\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Bahrain CPR must be 9 digits\",\n    );\n  }\n\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Bahrain CPR must contain only digits\",\n    );\n  }\n\n  // Validate birth month (digits 3-4) is 01-12\n  const mm = Number(v.slice(2, 4));\n  if (mm < 1 || mm > 12) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"CPR birth month must be 01-12\",\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, 4)}-${v.slice(4)}`;\n};\n\n/** Generate a random structurally valid Bahrain CPR. */\nconst generate = (): string => {\n  const yy = String(randomInt(0, 99)).padStart(2, \"0\");\n  const mm = String(randomInt(1, 12)).padStart(2, \"0\");\n  return `${yy}${mm}${randomDigits(5)}`;\n};\n\n/** Bahrain Central Population Registration number. */\nconst cpr: CountryValidator<\"BH\"> = {\n  name: \"Central Population Registration Number\",\n  localName: \"الرقم السكاني\",\n  abbreviation: \"CPR\",\n  aliases: [\"CPR\", \"الرقم السكاني\"] as const,\n  candidatePattern: \"\\\\d{9}\",\n  scope: \"country\",\n  country: \"BH\",\n  entityType: \"person\",\n  lengths: [9] as const,\n  examples: [\"890112345\", \"000612345\"] as const,\n  description: \"9-digit personal identification number\",\n  sourceUrl: \"https://www.bahrain.bh/wps/portal/IDInfo_en\",\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default cpr;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;AA4BA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;AAEnB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CAEvB,IAAI,EAAE,WAAW,GACf,OAAO,IACL,kBACA,8BACF;CAGF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,sCACF;CAIF,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,IAAI,KAAK,KAAK,KAAK,IACjB,OAAO,IACL,qBACA,+BACF;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,CAAC;AACvD;;AAGA,MAAM,iBAAyB;CAG7B,OAAO,GAFI,OAAO,UAAU,GAAG,EAAE,CAAC,EAAE,SAAS,GAAG,GAErC,IADA,OAAO,UAAU,GAAG,EAAE,CAAC,EAAE,SAAS,GAAG,GAChC,IAAI,aAAa,CAAC;AACpC;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,eAAe;CAChC,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,CAAC;CACX,UAAU,CAAC,aAAa,WAAW;CACnC,aAAa;CACb,WAAW;CACX;CACA;CACA;CACA;AACF"}

package/dist/bic.d.ts

@@ -1,13 +1,24 @@
-import { ValidateResult, Validator } from "./types.js";
+import { GlobalValidator, ValidateResult } from "./types.js";
 
 //#region src/bic.d.ts
 /** Generate a random valid BIC (8-character). */
 declare const generate: () => string;
+/**
+ * BIC (Business Identifier Code).
+ *
+ * ISO 9362. 8 or 11 character code identifying
+ * financial institutions. Format:
+ * [A-Z]{4} (institution) + [A-Z]{2} (country) +
+ * [0-9A-Z]{2} (location) + [0-9A-Z]{3} (branch,
+ * optional).
+ *
+ * @see https://www.swift.com/
+ */
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** Business Identifier Code (SWIFT/BIC). */
-declare const bic: Validator;
+declare const bic: GlobalValidator;
 //#endregion
 export { compact, bic as default, format, generate, validate };
 //# sourceMappingURL=bic.d.ts.map

package/dist/bic.js

@@ -2,17 +2,6 @@ import { clean } from "./_util/clean.js";
 import { randomChar, randomInt, randomPick } from "./_util/generate.js";
 import { err } from "./_util/result.js";
 //#region src/bic.ts
-/**
-* BIC (Business Identifier Code).
-*
-* ISO 9362. 8 or 11 character code identifying
-* financial institutions. Format:
-* [A-Z]{4} (institution) + [A-Z]{2} (country) +
-* [0-9A-Z]{2} (location) + [0-9A-Z]{3} (branch,
-* optional).
-*
-* @see https://www.swift.com/
-*/
 const BIC_ALPHANUM = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
 const BIC_COUNTRIES = [
 	"DE",
@@ -47,6 +36,7 @@ const format = (value) => {
 };
 /** Business Identifier Code (SWIFT/BIC). */
 const bic = {
+	scope: "global",
 	name: "Business Identifier Code",
 	localName: "Business Identifier Code",
 	abbreviation: "BIC",

package/dist/bic.js.map

@@ -1 +1 @@
-{"version":3,"file":"bic.js","names":[],"sources":["../src/bic.ts"],"sourcesContent":["const BIC_ALPHANUM = \"ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\";\nconst BIC_COUNTRIES = [\n  \"DE\",\n  \"GB\",\n  \"US\",\n  \"FR\",\n  \"CH\",\n  \"NL\",\n  \"AT\",\n] as const;\n\n/** Generate a random valid BIC (8-character). */\nconst generate = (): string => {\n  const randomLetter = (): string =>\n    String.fromCodePoint(65 + randomInt(0, 25));\n  const country = randomPick(BIC_COUNTRIES);\n  const bank =\n    randomLetter() +\n    randomLetter() +\n    randomLetter() +\n    randomLetter();\n  const location =\n    randomChar(BIC_ALPHANUM) + randomChar(BIC_ALPHANUM);\n  return `${bank}${country}${location}`;\n};\n\n/**\n * BIC (Business Identifier Code).\n *\n * ISO 9362. 8 or 11 character code identifying\n * financial institutions. Format:\n * [A-Z]{4} (institution) + [A-Z]{2} (country) +\n * [0-9A-Z]{2} (location) + [0-9A-Z]{3} (branch,\n * optional).\n *\n * @see https://www.swift.com/\n */\n\nimport { clean } from \"#util/clean\";\nimport {\n  randomChar,\n  randomInt,\n  randomPick,\n} from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nimport type { ValidateResult, Validator } from \"./types\";\n\nconst BIC_RE =\n  /^[A-Z]{4}[A-Z]{2}[0-9A-Z]{2}([0-9A-Z]{3})?$/;\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").toUpperCase();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 8 && v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"BIC must be 8 or 11 characters\",\n    );\n  }\n  if (!BIC_RE.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"BIC must be 8 or 11 alphanumeric characters\",\n    );\n  }\n  // Country code at positions 4-5 is already\n  // validated as [A-Z]{2} by the regex above.\n  // SWIFT accepts all ISO 3166-1 alpha-2 codes\n  // plus XK (Kosovo); we don't restrict further.\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length === 11) {\n    return `${v.slice(0, 4)} ${v.slice(4, 6)} ${v.slice(6, 8)} ${v.slice(8)}`;\n  }\n  return `${v.slice(0, 4)} ${v.slice(4, 6)} ${v.slice(6)}`;\n};\n\n/** Business Identifier Code (SWIFT/BIC). */\nconst bic: Validator = {\n  name: \"Business Identifier Code\",\n  localName: \"Business Identifier Code\",\n  abbreviation: \"BIC\",\n  aliases: [\"BIC\", \"SWIFT\", \"BIC/SWIFT\"] as const,\n  candidatePattern: \"[A-Z]{6}[A-Z0-9]{2}(?:[A-Z0-9]{3})?\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.swift.com/\",\n  examples: [\"DEUTDEFF\", \"DEUTDEFF500\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default bic;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;AAAA,MAAM,eAAe;AACrB,MAAM,gBAAgB;CACpB;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;AAGD,MAAM,iBAAyB;CAC7B,MAAM,qBACJ,OAAO,cAAc,KAAK,UAAU,GAAG,GAAG,CAAC;CAC7C,MAAM,UAAU,WAAW,cAAc;AAQzC,QAAO,GANL,cAAc,GACd,cAAc,GACd,cAAc,GACd,cAAc,GAGC,UADf,WAAW,aAAa,GAAG,WAAW,aAAa;;AA0BvD,MAAM,SACJ;AAEF,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,aAAa;AAElC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,KAAK,EAAE,WAAW,GACjC,QAAO,IACL,kBACA,iCACD;AAEH,KAAI,CAAC,OAAO,KAAK,EAAE,CACjB,QAAO,IACL,kBACA,8CACD;AAMH,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,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;AAEzE,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;;;AAIxD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EAAC;EAAO;EAAS;EAAY;CACtC,kBAAkB;CAClB,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,YAAY,cAAc;CACrC;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"bic.js","names":[],"sources":["../src/bic.ts"],"sourcesContent":["const BIC_ALPHANUM = \"ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\";\nconst BIC_COUNTRIES = [\n  \"DE\",\n  \"GB\",\n  \"US\",\n  \"FR\",\n  \"CH\",\n  \"NL\",\n  \"AT\",\n] as const;\n\n/** Generate a random valid BIC (8-character). */\nconst generate = (): string => {\n  const randomLetter = (): string =>\n    String.fromCodePoint(65 + randomInt(0, 25));\n  const country = randomPick(BIC_COUNTRIES);\n  const bank =\n    randomLetter() +\n    randomLetter() +\n    randomLetter() +\n    randomLetter();\n  const location =\n    randomChar(BIC_ALPHANUM) + randomChar(BIC_ALPHANUM);\n  return `${bank}${country}${location}`;\n};\n\n/**\n * BIC (Business Identifier Code).\n *\n * ISO 9362. 8 or 11 character code identifying\n * financial institutions. Format:\n * [A-Z]{4} (institution) + [A-Z]{2} (country) +\n * [0-9A-Z]{2} (location) + [0-9A-Z]{3} (branch,\n * optional).\n *\n * @see https://www.swift.com/\n */\n\nimport type {\n  ValidateResult,\n  GlobalValidator,\n} from \"./types\";\n\nimport { clean } from \"#util/clean\";\nimport {\n  randomChar,\n  randomInt,\n  randomPick,\n} from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nconst BIC_RE =\n  /^[A-Z]{4}[A-Z]{2}[0-9A-Z]{2}([0-9A-Z]{3})?$/;\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").toUpperCase();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 8 && v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"BIC must be 8 or 11 characters\",\n    );\n  }\n  if (!BIC_RE.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"BIC must be 8 or 11 alphanumeric characters\",\n    );\n  }\n  // Country code at positions 4-5 is already\n  // validated as [A-Z]{2} by the regex above.\n  // SWIFT accepts all ISO 3166-1 alpha-2 codes\n  // plus XK (Kosovo); we don't restrict further.\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length === 11) {\n    return `${v.slice(0, 4)} ${v.slice(4, 6)} ${v.slice(6, 8)} ${v.slice(8)}`;\n  }\n  return `${v.slice(0, 4)} ${v.slice(4, 6)} ${v.slice(6)}`;\n};\n\n/** Business Identifier Code (SWIFT/BIC). */\nconst bic: GlobalValidator = {\n  scope: \"global\",\n  name: \"Business Identifier Code\",\n  localName: \"Business Identifier Code\",\n  abbreviation: \"BIC\",\n  aliases: [\"BIC\", \"SWIFT\", \"BIC/SWIFT\"] as const,\n  candidatePattern: \"[A-Z]{6}[A-Z0-9]{2}(?:[A-Z0-9]{3})?\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.swift.com/\",\n  examples: [\"DEUTDEFF\", \"DEUTDEFF500\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default bic;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;AAAA,MAAM,eAAe;AACrB,MAAM,gBAAgB;CACpB;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;AAGA,MAAM,iBAAyB;CAC7B,MAAM,qBACJ,OAAO,cAAc,KAAK,UAAU,GAAG,EAAE,CAAC;CAC5C,MAAM,UAAU,WAAW,aAAa;CAQxC,OAAO,GANL,aAAa,IACb,aAAa,IACb,aAAa,IACb,aAAa,IAGE,UADf,WAAW,YAAY,IAAI,WAAW,YAAY;AAEtD;AA2BA,MAAM,SACJ;AAEF,MAAM,WAAW,UACf,MAAM,OAAO,IAAI,EAAE,YAAY;AAEjC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,KAAK,EAAE,WAAW,IACjC,OAAO,IACL,kBACA,gCACF;CAEF,IAAI,CAAC,OAAO,KAAK,CAAC,GAChB,OAAO,IACL,kBACA,6CACF;CAMF,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,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC;CAExE,OAAO,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC;AACvD;;AAGA,MAAM,MAAuB;CAC3B,OAAO;CACP,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EAAC;EAAO;EAAS;CAAW;CACrC,kBAAkB;CAClB,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,YAAY,aAAa;CACpC;CACA;CACA;CACA;AACF"}

package/dist/br/cnpj.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/br/cnpj.d.ts
 declare const compact: (value: string) => string;
@@ -14,7 +14,7 @@ declare const generate: () => string;
  * - Petrobras: 33.000.167/0001-01
  * - Banco do Brasil: 00.000.000/0001-91
  */
-declare const cnpj: Validator;
+declare const cnpj: CountryValidator<"BR">;
 //#endregion
 export { compact, cnpj as default, format, generate, validate };
 //# sourceMappingURL=cnpj.d.ts.map

package/dist/br/cnpj.js

@@ -2,26 +2,6 @@ import { clean } from "../_util/clean.js";
 import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 //#region src/br/cnpj.ts
-/**
-* CNPJ (Cadastro Nacional da Pessoa Jurídica).
-*
-* Brazilian company tax identification number assigned by
-* the Receita Federal (Federal Revenue Service). The
-* number consists of 14 characters: 8 identifying the
-* company, 4 identifying the establishment (0001 for
-* headquarters), and 2 check digits computed using a
-* weighted modulo 11 algorithm.
-*
-* As of July 2026 the Receita Federal will begin issuing
-* alphanumeric CNPJs (letters A-Z in place of some
-* digits). The check digit algorithm uses ordinal values
-* (0-9 = 0-9, A-Z = 17-42) to support this.
-*
-* Format: NN.NNN.NNN/NNNN-DD (14 characters).
-*
-* @see https://www.gov.br/en/categories/finance-taxes-and-public-management/cpf-cnpj-and-other-records
-* @see https://en.wikipedia.org/wiki/CNPJ
-*/
 const CNPJ_RE = /^[\dA-Z]+$/;
 const compact = (value) => clean(value, " -./").trim().toUpperCase();
 /**
@@ -117,6 +97,7 @@ const cnpj = {
 	abbreviation: "CNPJ",
 	aliases: ["CNPJ", "Cadastro Nacional da Pessoa Jurídica"],
 	candidatePattern: "\\d{2}\\.?\\d{3}\\.?\\d{3}/?\\d{4}-?\\d{2}",
+	scope: "country",
 	country: "BR",
 	entityType: "company",
 	sourceUrl: "https://www.gov.br/receitafederal/",

package/dist/br/cnpj.js.map

@@ -1 +1 @@
-{"version":3,"file":"cnpj.js","names":[],"sources":["../../src/br/cnpj.ts"],"sourcesContent":["/**\n * CNPJ (Cadastro Nacional da Pessoa Jurídica).\n *\n * Brazilian company tax identification number assigned by\n * the Receita Federal (Federal Revenue Service). The\n * number consists of 14 characters: 8 identifying the\n * company, 4 identifying the establishment (0001 for\n * headquarters), and 2 check digits computed using a\n * weighted modulo 11 algorithm.\n *\n * As of July 2026 the Receita Federal will begin issuing\n * alphanumeric CNPJs (letters A-Z in place of some\n * digits). The check digit algorithm uses ordinal values\n * (0-9 = 0-9, A-Z = 17-42) to support this.\n *\n * Format: NN.NNN.NNN/NNNN-DD (14 characters).\n *\n * @see https://www.gov.br/en/categories/finance-taxes-and-public-management/cpf-cnpj-and-other-records\n * @see https://en.wikipedia.org/wiki/CNPJ\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst CNPJ_RE = /^[\\dA-Z]+$/;\n\nconst compact = (value: string): string =>\n  clean(value, \" -./\").trim().toUpperCase();\n\n/**\n * Convert a CNPJ character to its numeric value.\n * Digits 0-9 map to 0-9; letters A-Z map to their\n * char code minus 48 (matching python-stdnum's\n * `ord(n) - 48` convention: A=17, B=18, ..., Z=42).\n */\nconst charToValue = (ch: string): number =>\n  ch.charCodeAt(0) - 48;\n\n/**\n * Calculate the two CNPJ check digits using the\n * Receita Federal modulo 11 algorithm.\n *\n * First check digit: weights [5,4,3,2,9,8,7,6,5,4,3,2]\n * applied to the first 12 characters.\n *\n * Second check digit: weights [6,5,4,3,2,9,8,7,6,5,4,3,2]\n * applied to the first 12 characters plus the first\n * check digit.\n */\nconst calcCheckDigits = (number: string): string => {\n  const w1 = [5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2];\n  let sum = 0;\n  for (let i = 0; i < 12; i++) {\n    sum += (w1[i] ?? 0) * charToValue(number.charAt(i));\n  }\n  const d1 = ((11 - (sum % 11)) % 11) % 10;\n\n  const w2 = [6, 5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2];\n  sum = 0;\n  for (let i = 0; i < 12; i++) {\n    sum += (w2[i] ?? 0) * charToValue(number.charAt(i));\n  }\n  // Use the computed d1 (not the stored digit at\n  // number[12]) so both check digits are derived\n  // from the base alone.\n  sum += (w2[12] ?? 0) * d1;\n  const d2 = ((11 - (sum % 11)) % 11) % 10;\n\n  return `${d1}${d2}`;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 14) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"CNPJ must be 14 characters\",\n    );\n  }\n  if (!CNPJ_RE.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"CNPJ must contain only digits and uppercase letters\",\n    );\n  }\n  // Reject all-zero base (first 12 chars).\n  // Unlike CPF, we do not reject all-same-digit CNPJs;\n  // python-stdnum only blocks the all-zero base, and\n  // there is no official Receita Federal list of\n  // blocked same-digit CNPJ sequences.\n  if (v.startsWith(\"000000000000\")) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"CNPJ base must not be all zeros\",\n    );\n  }\n  if (calcCheckDigits(v) !== v.slice(12)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"CNPJ check digit mismatch\",\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, 5)}.${v.slice(5, 8)}/${v.slice(8, 12)}-${v.slice(12)}`;\n};\n\n/** Generate a random valid CNPJ. */\nconst generate = (): string => {\n  for (;;) {\n    const base = randomDigits(12);\n    if (base === \"000000000000\") continue;\n    return base + calcCheckDigits(base);\n  }\n};\n\n/**\n * Brazilian CNPJ (company tax ID).\n *\n * Examples sourced from publicly available Brazilian\n * corporate registries:\n * - Petrobras: 33.000.167/0001-01\n * - Banco do Brasil: 00.000.000/0001-91\n */\nconst cnpj: Validator = {\n  name: \"Brazilian CNPJ\",\n  localName: \"Cadastro Nacional da Pessoa Jurídica\",\n  abbreviation: \"CNPJ\",\n  aliases: [\n    \"CNPJ\",\n    \"Cadastro Nacional da Pessoa Jurídica\",\n  ] as const,\n  candidatePattern:\n    \"\\\\d{2}\\\\.?\\\\d{3}\\\\.?\\\\d{3}/?\\\\d{4}-?\\\\d{2}\",\n  country: \"BR\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.gov.br/receitafederal/\",\n  examples: [\"33000167000101\", \"00000000000191\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default cnpj;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA2BA,MAAM,UAAU;AAEhB,MAAM,WAAW,UACf,MAAM,OAAO,OAAO,CAAC,MAAM,CAAC,aAAa;;;;;;;AAQ3C,MAAM,eAAe,OACnB,GAAG,WAAW,EAAE,GAAG;;;;;;;;;;;;AAarB,MAAM,mBAAmB,WAA2B;CAClD,MAAM,KAAK;EAAC;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAE;CAC/C,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,IACtB,SAAQ,GAAG,MAAM,KAAK,YAAY,OAAO,OAAO,EAAE,CAAC;CAErD,MAAM,MAAO,KAAM,MAAM,MAAO,KAAM;CAEtC,MAAM,KAAK;EAAC;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAE;AAClD,OAAM;AACN,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,IACtB,SAAQ,GAAG,MAAM,KAAK,YAAY,OAAO,OAAO,EAAE,CAAC;AAKrD,SAAQ,GAAG,OAAO,KAAK;AAGvB,QAAO,GAAG,MAFG,KAAM,MAAM,MAAO,KAAM;;AAKxC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,6BACD;AAEH,KAAI,CAAC,QAAQ,KAAK,EAAE,CAClB,QAAO,IACL,kBACA,sDACD;AAOH,KAAI,EAAE,WAAW,eAAe,CAC9B,QAAO,IACL,kBACA,kCACD;AAEH,KAAI,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,CACpC,QAAO,IACL,oBACA,4BACD;AAEH,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,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG;;;AAI5F,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,OAAO,aAAa,GAAG;AAC7B,MAAI,SAAS,eAAgB;AAC7B,SAAO,OAAO,gBAAgB,KAAK;;;;;;;;;;;AAYvC,MAAM,OAAkB;CACtB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,QACA,uCACD;CACD,kBACE;CACF,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,kBAAkB,iBAAiB;CAC9C;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"cnpj.js","names":[],"sources":["../../src/br/cnpj.ts"],"sourcesContent":["/**\n * CNPJ (Cadastro Nacional da Pessoa Jurídica).\n *\n * Brazilian company tax identification number assigned by\n * the Receita Federal (Federal Revenue Service). The\n * number consists of 14 characters: 8 identifying the\n * company, 4 identifying the establishment (0001 for\n * headquarters), and 2 check digits computed using a\n * weighted modulo 11 algorithm.\n *\n * As of July 2026 the Receita Federal will begin issuing\n * alphanumeric CNPJs (letters A-Z in place of some\n * digits). The check digit algorithm uses ordinal values\n * (0-9 = 0-9, A-Z = 17-42) to support this.\n *\n * Format: NN.NNN.NNN/NNNN-DD (14 characters).\n *\n * @see https://www.gov.br/en/categories/finance-taxes-and-public-management/cpf-cnpj-and-other-records\n * @see https://en.wikipedia.org/wiki/CNPJ\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\";\n\nconst CNPJ_RE = /^[\\dA-Z]+$/;\n\nconst compact = (value: string): string =>\n  clean(value, \" -./\").trim().toUpperCase();\n\n/**\n * Convert a CNPJ character to its numeric value.\n * Digits 0-9 map to 0-9; letters A-Z map to their\n * char code minus 48 (matching python-stdnum's\n * `ord(n) - 48` convention: A=17, B=18, ..., Z=42).\n */\nconst charToValue = (ch: string): number =>\n  ch.charCodeAt(0) - 48;\n\n/**\n * Calculate the two CNPJ check digits using the\n * Receita Federal modulo 11 algorithm.\n *\n * First check digit: weights [5,4,3,2,9,8,7,6,5,4,3,2]\n * applied to the first 12 characters.\n *\n * Second check digit: weights [6,5,4,3,2,9,8,7,6,5,4,3,2]\n * applied to the first 12 characters plus the first\n * check digit.\n */\nconst calcCheckDigits = (number: string): string => {\n  const w1 = [5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2];\n  let sum = 0;\n  for (let i = 0; i < 12; i++) {\n    sum += (w1[i] ?? 0) * charToValue(number.charAt(i));\n  }\n  const d1 = ((11 - (sum % 11)) % 11) % 10;\n\n  const w2 = [6, 5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2];\n  sum = 0;\n  for (let i = 0; i < 12; i++) {\n    sum += (w2[i] ?? 0) * charToValue(number.charAt(i));\n  }\n  // Use the computed d1 (not the stored digit at\n  // number[12]) so both check digits are derived\n  // from the base alone.\n  sum += (w2[12] ?? 0) * d1;\n  const d2 = ((11 - (sum % 11)) % 11) % 10;\n\n  return `${d1}${d2}`;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 14) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"CNPJ must be 14 characters\",\n    );\n  }\n  if (!CNPJ_RE.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"CNPJ must contain only digits and uppercase letters\",\n    );\n  }\n  // Reject all-zero base (first 12 chars).\n  // Unlike CPF, we do not reject all-same-digit CNPJs;\n  // python-stdnum only blocks the all-zero base, and\n  // there is no official Receita Federal list of\n  // blocked same-digit CNPJ sequences.\n  if (v.startsWith(\"000000000000\")) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"CNPJ base must not be all zeros\",\n    );\n  }\n  if (calcCheckDigits(v) !== v.slice(12)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"CNPJ check digit mismatch\",\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, 5)}.${v.slice(5, 8)}/${v.slice(8, 12)}-${v.slice(12)}`;\n};\n\n/** Generate a random valid CNPJ. */\nconst generate = (): string => {\n  for (;;) {\n    const base = randomDigits(12);\n    if (base === \"000000000000\") continue;\n    return base + calcCheckDigits(base);\n  }\n};\n\n/**\n * Brazilian CNPJ (company tax ID).\n *\n * Examples sourced from publicly available Brazilian\n * corporate registries:\n * - Petrobras: 33.000.167/0001-01\n * - Banco do Brasil: 00.000.000/0001-91\n */\nconst cnpj: CountryValidator<\"BR\"> = {\n  name: \"Brazilian CNPJ\",\n  localName: \"Cadastro Nacional da Pessoa Jurídica\",\n  abbreviation: \"CNPJ\",\n  aliases: [\n    \"CNPJ\",\n    \"Cadastro Nacional da Pessoa Jurídica\",\n  ] as const,\n  candidatePattern:\n    \"\\\\d{2}\\\\.?\\\\d{3}\\\\.?\\\\d{3}/?\\\\d{4}-?\\\\d{2}\",\n  scope: \"country\",\n  country: \"BR\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.gov.br/receitafederal/\",\n  examples: [\"33000167000101\", \"00000000000191\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default cnpj;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;AA8BA,MAAM,UAAU;AAEhB,MAAM,WAAW,UACf,MAAM,OAAO,MAAM,EAAE,KAAK,EAAE,YAAY;;;;;;;AAQ1C,MAAM,eAAe,OACnB,GAAG,WAAW,CAAC,IAAI;;;;;;;;;;;;AAarB,MAAM,mBAAmB,WAA2B;CAClD,MAAM,KAAK;EAAC;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;CAAC;CAC9C,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KACtB,QAAQ,GAAG,MAAM,KAAK,YAAY,OAAO,OAAO,CAAC,CAAC;CAEpD,MAAM,MAAO,KAAM,MAAM,MAAO,KAAM;CAEtC,MAAM,KAAK;EAAC;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;CAAC;CACjD,MAAM;CACN,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KACtB,QAAQ,GAAG,MAAM,KAAK,YAAY,OAAO,OAAO,CAAC,CAAC;CAKpD,QAAQ,GAAG,OAAO,KAAK;CAGvB,OAAO,GAAG,MAFG,KAAM,MAAM,MAAO,KAAM;AAGxC;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,4BACF;CAEF,IAAI,CAAC,QAAQ,KAAK,CAAC,GACjB,OAAO,IACL,kBACA,qDACF;CAOF,IAAI,EAAE,WAAW,cAAc,GAC7B,OAAO,IACL,kBACA,iCACF;CAEF,IAAI,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GACnC,OAAO,IACL,oBACA,2BACF;CAEF,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,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;AAC3F;;AAGA,MAAM,iBAAyB;CAC7B,SAAS;EACP,MAAM,OAAO,aAAa,EAAE;EAC5B,IAAI,SAAS,gBAAgB;EAC7B,OAAO,OAAO,gBAAgB,IAAI;CACpC;AACF;;;;;;;;;AAUA,MAAM,OAA+B;CACnC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,QACA,sCACF;CACA,kBACE;CACF,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,kBAAkB,gBAAgB;CAC7C;CACA;CACA;CACA;AACF"}

package/dist/br/cpf.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/br/cpf.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid CPF. */
 declare const generate: () => string;
 /** Brazilian CPF (personal tax ID). */
-declare const cpf: Validator;
+declare const cpf: CountryValidator<"BR">;
 //#endregion
 export { compact, cpf as default, format, generate, validate };
 //# sourceMappingURL=cpf.d.ts.map

package/dist/br/cpf.js

@@ -3,20 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/br/cpf.ts
-/**
-* CPF (Cadastro de Pessoas Físicas).
-*
-* Brazilian personal tax identification number assigned
-* by the Receita Federal (Federal Revenue Service) to
-* individuals. The number consists of 11 digits: 9 base
-* digits followed by 2 check digits computed using a
-* weighted modulo 11 algorithm.
-*
-* Format: NNN.NNN.NNN-DD (11 digits, purely numeric).
-*
-* @see https://www.gov.br/en/categories/finance-taxes-and-public-management/cpf-cnpj-and-other-records
-* @see https://en.wikipedia.org/wiki/CPF_number
-*/
 const compact = (value) => clean(value, " -.").trim();
 /**
 * Calculate the two CPF check digits using the
@@ -68,6 +54,7 @@ const cpf = {
 	abbreviation: "CPF",
 	aliases: ["CPF", "Cadastro de Pessoas Físicas"],
 	candidatePattern: "\\d{3}\\.?\\d{3}\\.?\\d{3}-?\\d{2}",
+	scope: "country",
 	country: "BR",
 	entityType: "person",
 	sourceUrl: "https://www.gov.br/receitafederal/",

package/dist/br/cpf.js.map

@@ -1 +1 @@
-{"version":3,"file":"cpf.js","names":[],"sources":["../../src/br/cpf.ts"],"sourcesContent":["/**\n * CPF (Cadastro de Pessoas Físicas).\n *\n * Brazilian personal tax identification number assigned\n * by the Receita Federal (Federal Revenue Service) to\n * individuals. The number consists of 11 digits: 9 base\n * digits followed by 2 check digits computed using a\n * weighted modulo 11 algorithm.\n *\n * Format: NNN.NNN.NNN-DD (11 digits, purely numeric).\n *\n * @see https://www.gov.br/en/categories/finance-taxes-and-public-management/cpf-cnpj-and-other-records\n * @see https://en.wikipedia.org/wiki/CPF_number\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, \" -.\").trim();\n\n/**\n * Calculate the two CPF check digits using the\n * Receita Federal modulo 11 algorithm.\n *\n * First check digit: multiply digits 0..8 by weights\n * 10..2, sum, then (11 - sum % 11) % 11 % 10.\n *\n * Second check digit: multiply digits 0..8 by weights\n * 11..3, add 2 * first check digit, then\n * (11 - sum % 11) % 11 % 10.\n */\nconst calcCheckDigits = (number: string): string => {\n  let sum = 0;\n  for (let i = 0; i < 9; i++) {\n    sum += (10 - i) * Number(number[i]);\n  }\n  const d1 = ((11 - (sum % 11)) % 11) % 10;\n\n  sum = 0;\n  for (let i = 0; i < 9; i++) {\n    sum += (11 - i) * Number(number[i]);\n  }\n  sum += 2 * d1;\n  const d2 = ((11 - (sum % 11)) % 11) % 10;\n\n  return `${d1}${d2}`;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\"INVALID_LENGTH\", \"CPF must be 11 digits\");\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"CPF must contain only digits\",\n    );\n  }\n  // All-same-digit CPFs (e.g. 000.000.000-00) pass the\n  // checksum but are not valid registrations.\n  if (/^(\\d)\\1{10}$/.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"CPF must not be a repeated digit sequence\",\n    );\n  }\n  if (calcCheckDigits(v) !== v.slice(9)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"CPF check digit mismatch\",\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, 3)}.${v.slice(3, 6)}.${v.slice(6, 9)}-${v.slice(9)}`;\n};\n\n/** Generate a random valid CPF. */\nconst generate = (): string => {\n  for (;;) {\n    const base = randomDigits(9);\n    if (/^(\\d)\\1{8}$/.test(base)) continue;\n    return base + calcCheckDigits(base);\n  }\n};\n\n/** Brazilian CPF (personal tax ID). */\nconst cpf: Validator = {\n  name: \"Brazilian CPF\",\n  localName: \"Cadastro de Pessoas Físicas\",\n  abbreviation: \"CPF\",\n  aliases: [\"CPF\", \"Cadastro de Pessoas Físicas\"] as const,\n  candidatePattern: \"\\\\d{3}\\\\.?\\\\d{3}\\\\.?\\\\d{3}-?\\\\d{2}\",\n  country: \"BR\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.gov.br/receitafederal/\",\n  examples: [\"39053344705\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default cpf;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAsBA,MAAM,WAAW,UACf,MAAM,OAAO,MAAM,CAAC,MAAM;;;;;;;;;;;;AAa5B,MAAM,mBAAmB,WAA2B;CAClD,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,SAAQ,KAAK,KAAK,OAAO,OAAO,GAAG;CAErC,MAAM,MAAO,KAAM,MAAM,MAAO,KAAM;AAEtC,OAAM;AACN,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,SAAQ,KAAK,KAAK,OAAO,OAAO,GAAG;AAErC,QAAO,IAAI;AAGX,QAAO,GAAG,MAFG,KAAM,MAAM,MAAO,KAAM;;AAKxC,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;AAIH,KAAI,eAAe,KAAK,EAAE,CACxB,QAAO,IACL,kBACA,4CACD;AAEH,KAAI,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,CACnC,QAAO,IACL,oBACA,2BACD;AAEH,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,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;;;AAIzE,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,OAAO,aAAa,EAAE;AAC5B,MAAI,cAAc,KAAK,KAAK,CAAE;AAC9B,SAAO,OAAO,gBAAgB,KAAK;;;;AAKvC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,8BAA8B;CAC/C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,cAAc;CACzB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"cpf.js","names":[],"sources":["../../src/br/cpf.ts"],"sourcesContent":["/**\n * CPF (Cadastro de Pessoas Físicas).\n *\n * Brazilian personal tax identification number assigned\n * by the Receita Federal (Federal Revenue Service) to\n * individuals. The number consists of 11 digits: 9 base\n * digits followed by 2 check digits computed using a\n * weighted modulo 11 algorithm.\n *\n * Format: NNN.NNN.NNN-DD (11 digits, purely numeric).\n *\n * @see https://www.gov.br/en/categories/finance-taxes-and-public-management/cpf-cnpj-and-other-records\n * @see https://en.wikipedia.org/wiki/CPF_number\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, \" -.\").trim();\n\n/**\n * Calculate the two CPF check digits using the\n * Receita Federal modulo 11 algorithm.\n *\n * First check digit: multiply digits 0..8 by weights\n * 10..2, sum, then (11 - sum % 11) % 11 % 10.\n *\n * Second check digit: multiply digits 0..8 by weights\n * 11..3, add 2 * first check digit, then\n * (11 - sum % 11) % 11 % 10.\n */\nconst calcCheckDigits = (number: string): string => {\n  let sum = 0;\n  for (let i = 0; i < 9; i++) {\n    sum += (10 - i) * Number(number[i]);\n  }\n  const d1 = ((11 - (sum % 11)) % 11) % 10;\n\n  sum = 0;\n  for (let i = 0; i < 9; i++) {\n    sum += (11 - i) * Number(number[i]);\n  }\n  sum += 2 * d1;\n  const d2 = ((11 - (sum % 11)) % 11) % 10;\n\n  return `${d1}${d2}`;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\"INVALID_LENGTH\", \"CPF must be 11 digits\");\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"CPF must contain only digits\",\n    );\n  }\n  // All-same-digit CPFs (e.g. 000.000.000-00) pass the\n  // checksum but are not valid registrations.\n  if (/^(\\d)\\1{10}$/.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"CPF must not be a repeated digit sequence\",\n    );\n  }\n  if (calcCheckDigits(v) !== v.slice(9)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"CPF check digit mismatch\",\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, 3)}.${v.slice(3, 6)}.${v.slice(6, 9)}-${v.slice(9)}`;\n};\n\n/** Generate a random valid CPF. */\nconst generate = (): string => {\n  for (;;) {\n    const base = randomDigits(9);\n    if (/^(\\d)\\1{8}$/.test(base)) continue;\n    return base + calcCheckDigits(base);\n  }\n};\n\n/** Brazilian CPF (personal tax ID). */\nconst cpf: CountryValidator<\"BR\"> = {\n  name: \"Brazilian CPF\",\n  localName: \"Cadastro de Pessoas Físicas\",\n  abbreviation: \"CPF\",\n  aliases: [\"CPF\", \"Cadastro de Pessoas Físicas\"] as const,\n  candidatePattern: \"\\\\d{3}\\\\.?\\\\d{3}\\\\.?\\\\d{3}-?\\\\d{2}\",\n  scope: \"country\",\n  country: \"BR\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.gov.br/receitafederal/\",\n  examples: [\"39053344705\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default cpf;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AAyBA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,EAAE,KAAK;;;;;;;;;;;;AAa3B,MAAM,mBAAmB,WAA2B;CAClD,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KACrB,QAAQ,KAAK,KAAK,OAAO,OAAO,EAAE;CAEpC,MAAM,MAAO,KAAM,MAAM,MAAO,KAAM;CAEtC,MAAM;CACN,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KACrB,QAAQ,KAAK,KAAK,OAAO,OAAO,EAAE;CAEpC,OAAO,IAAI;CAGX,OAAO,GAAG,MAFG,KAAM,MAAM,MAAO,KAAM;AAGxC;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;CAIF,IAAI,eAAe,KAAK,CAAC,GACvB,OAAO,IACL,kBACA,2CACF;CAEF,IAAI,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,OAAO,IACL,oBACA,0BACF;CAEF,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,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC;AACxE;;AAGA,MAAM,iBAAyB;CAC7B,SAAS;EACP,MAAM,OAAO,aAAa,CAAC;EAC3B,IAAI,cAAc,KAAK,IAAI,GAAG;EAC9B,OAAO,OAAO,gBAAgB,IAAI;CACpC;AACF;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,6BAA6B;CAC9C,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,aAAa;CACxB;CACA;CACA;CACA;AACF"}

package/dist/by/unp.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/by/unp.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid Belarus UNP. */
 declare const generate: () => string;
 /** Belarus UNP (Учётный номер плательщика). */
-declare const unp: Validator;
+declare const unp: CountryValidator<"BY">;
 //#endregion
 export { compact, unp as default, format, generate, validate };
 //# sourceMappingURL=unp.d.ts.map

package/dist/by/unp.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/by/unp.ts
-/**
-* UNP (Учётный номер плательщика, Belarus tax number).
-*
-* 9 characters: the first two identify the region (numeric
-* for organisations, letters from ABCEHKMOPT for
-* individuals), followed by 7 digits. The last digit is a
-* weighted check digit (mod 11; if remainder > 9 the
-* number is invalid).
-*
-* @see https://be.wikipedia.org/wiki/Уліковы_нумар_плацельшчыка
-* @see https://www.nalog.gov.by/
-*/
 /** Cyrillic to Latin mapping for the letter positions. */
 const CYRILLIC_TO_LATIN = {
 	А: "A",
@@ -45,7 +33,7 @@ const compact = (value) => {
 	let v = clean(value, " ").toUpperCase().trim();
 	if (v.startsWith("УНП")) v = v.slice(3);
 	else if (v.startsWith("UNP")) v = v.slice(3);
-	return [...v].map((ch) => CYRILLIC_TO_LATIN[ch] ?? ch).join("");
+	return v.split("").map((ch) => CYRILLIC_TO_LATIN[ch] ?? ch).join("");
 };
 const calcCheckDigit = (number) => {
 	let work = number;
@@ -73,7 +61,7 @@ const validate = (value) => {
 	if (v.length !== 9) return err("INVALID_LENGTH", "Belarus UNP must be 9 characters");
 	if (!isdigits(v.slice(2))) return err("INVALID_FORMAT", "Belarus UNP positions 3-9 must be digits");
 	const first2 = v.slice(0, 2);
-	if (!isdigits(first2) && ![...first2].every((ch) => ALPHA_SET.includes(ch))) return err("INVALID_FORMAT", "Belarus UNP first two characters must be digits or letters from ABCEHKMOPT");
+	if (!isdigits(first2) && !first2.split("").every((ch) => ALPHA_SET.includes(ch))) return err("INVALID_FORMAT", "Belarus UNP first two characters must be digits or letters from ABCEHKMOPT");
 	if (!VALID_FIRST.includes(v[0])) return err("INVALID_COMPONENT", "Belarus UNP has an invalid region prefix");
 	const expected = calcCheckDigit(v);
 	if (expected === null) return err("INVALID_CHECKSUM", "Belarus UNP check digit is invalid (mod 11 remainder > 9)");
@@ -102,6 +90,7 @@ const unp = {
 	abbreviation: "УНП",
 	aliases: ["УНП", "UNP"],
 	candidatePattern: "\\d{9}",
+	scope: "country",
 	country: "BY",
 	entityType: "any",
 	sourceUrl: "https://www.nalog.gov.by/",