@stll/stdnum 0.0.1 → 1.0.0

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, randomInt } 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]!;\n  let sum = 0;\n  for (let i = 0; i < 8; i++) {\n    sum += Number(body[i]) * WEIGHTS[i]!;\n  }\n  const digit = (pv + (sum % 11)) % 11;\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  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\n/** Generate a random valid Venezuelan RIF. */\nconst generate = (): string => {\n  const types = [\"V\", \"E\", \"J\", \"P\", \"G\"] as const;\n  const prefix = types[randomInt(0, types.length - 1)]!;\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;CACzB,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,QAAO,OAAO,KAAK,GAAG,GAAG,QAAQ;AAGnC,QAAO,cADQ,KAAM,MAAM,MAAO;;AAIpC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,4BACD;CAGH,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;;;AAI/C,MAAM,iBAAyB;CAC7B,MAAM,QAAQ;EAAC;EAAK;EAAK;EAAK;EAAK;EAAI;CACvC,MAAM,SAAS,MAAM,UAAU,GAAG,MAAM,SAAS,EAAE;CACnD,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 { 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"}

package/dist/vn/mod.d.ts

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

package/dist/vn/mst.d.ts

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

package/dist/za/idnr.d.ts

@@ -1,7 +1,6 @@
 import { ParsedPersonId, ValidateResult, Validator } from "../types.js";
 
 //#region src/za/idnr.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
@@ -13,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;
+declare const idnr: Validator<ParsedPersonId>;
 //#endregion
 export { compact, idnr as default, format, generate, parse, validate };
 //# sourceMappingURL=idnr.d.ts.map

package/dist/za/idnr.js

@@ -97,6 +97,7 @@ const idnr = {
 	entityType: "person",
 	compact,
 	format,
+	parse,
 	validate,
 	description: "South African personal identification number",
 	sourceUrl: "https://en.wikipedia.org/wiki/South_African_identity_document",

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 = {\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  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,OAAkB;CACtB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,aAAa,SAAS;CAChC,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ;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 {\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"}

package/dist/za/mod.d.ts

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stll/stdnum",
-  "version": "0.0.1",
-  "description": "Validate, compact, and format standard identifiers (IČO, IBAN, VAT, birth numbers, credit cards). Pure TypeScript, zero dependencies.",
+  "version": "1.0.0",
+  "description": "Validate, compact, and format standard identifiers for Node.js and Bun. Pure TypeScript, zero dependencies, tree-shakeable per identifier.",
   "keywords": [
     "credit-card",
     "czech",
@@ -31,10 +31,6 @@
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
-  "imports": {
-    "#checksums/*": "./dist/_checksums/*.js",
-    "#util/*": "./dist/_util/*.js"
-  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -902,15 +898,24 @@
       "default": "./dist/za/idnr.js"
     }
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "tsdown",
-    "prepublishOnly": "bun run build",
+    "prepublishOnly": "bun run typecheck && bun run build && bun run sync-exports:check",
     "catalog": "bun scripts/catalog.ts",
+    "sync-ai": "bash scripts/sync-ai-skills.sh",
     "sync-exports": "bun scripts/sync-exports.ts",
+    "sync-exports:check": "bun scripts/sync-exports.ts --check",
     "test": "bun test",
-    "oracle": "bun scripts/oracle.ts",
-    "lint": "oxlint .",
-    "format": "oxfmt ."
+    "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"
   },
   "devDependencies": {
     "bun-types": "^1.3.10",
@@ -923,14 +928,12 @@
     "oxfmt": "^0.41.0",
     "oxlint": "^1.55.0",
     "stdnum": "^1.11.7",
-    "tsdown": "^0.12.4",
+    "tsdown": "0.21.6",
     "typescript": "^5.9.3",
     "validate-polish": "^2.1.40"
   },
-  "publishConfig": {
-    "access": "restricted"
-  },
   "engines": {
     "node": ">= 18"
-  }
+  },
+  "packageManager": "bun@1.3.12"
 }

package/src/_checksums/mod112.ts

@@ -23,10 +23,11 @@ export const mod112checkChar = (
   payload: string,
 ): string => {
   let sum = 0;
-  for (let i = 0; i < 17; i++) {
-    sum += Number(payload[i]) * WEIGHTS[i]!;
+  for (const [i, weight] of WEIGHTS.entries()) {
+    sum += Number(payload[i]) * weight;
   }
-  return CHECK_CHARS[sum % 11]!;
+  // SAFETY: sum % 11 is in 0..10 and CHECK_CHARS has 11 chars.
+  return CHECK_CHARS[sum % 11] ?? "";
 };
 
 /**
@@ -34,7 +35,7 @@ export const mod112checkChar = (
  * check character (last char is 0-9 or X).
  */
 export const mod112validate = (value: string): boolean => {
-  const payload = value.slice(0, 17);
-  const check = value[17]!.toUpperCase();
-  return mod112checkChar(payload) === check;
+  const check = value[17]?.toUpperCase();
+  if (check === undefined) return false;
+  return mod112checkChar(value.slice(0, 17)) === check;
 };

package/src/_util/generate.ts

@@ -22,3 +22,41 @@ export const randomInt = (
   max: number,
 ): number =>
   min + Math.floor(Math.random() * (max - min + 1));
+
+/**
+ * Pick a random element from a non-empty array.
+ * Throws if the array is empty so generators that
+ * declare a fixed pool fail loudly instead of
+ * returning `undefined`.
+ */
+export const randomPick = <T>(values: readonly T[]): T => {
+  if (values.length === 0) {
+    throw new Error("randomPick called with empty array");
+  }
+  const idx = randomInt(0, values.length - 1);
+  // SAFETY: idx is bounded by values.length and the
+  // array is non-empty (checked above).
+  const value = values[idx];
+  if (value === undefined) {
+    throw new Error("randomPick produced undefined");
+  }
+  return value;
+};
+
+/**
+ * Pick a random character from a non-empty string.
+ * Same contract as `randomPick` for arrays.
+ */
+export const randomChar = (chars: string): string => {
+  if (chars.length === 0) {
+    throw new Error("randomChar called with empty string");
+  }
+  const idx = randomInt(0, chars.length - 1);
+  // SAFETY: idx is bounded by chars.length and the
+  // string is non-empty (checked above).
+  const ch = chars[idx];
+  if (ch === undefined) {
+    throw new Error("randomChar produced undefined");
+  }
+  return ch;
+};

package/src/ad/nrt.ts

@@ -1,8 +1,8 @@
+const NRT_PREFIXES = "CDEGOPU";
+
 /** Generate a random valid Andorra NRT. */
 const generate = (): string => {
-  const prefixes = "CDEGOPU";
-  const prefix =
-    prefixes[randomInt(0, prefixes.length - 1)]!;
+  const prefix = randomChar(NRT_PREFIXES);
   const digits = randomDigits(6);
   const suffix = String.fromCodePoint(
     65 + randomInt(0, 25),
@@ -26,7 +26,11 @@ const generate = (): string => {
  */
 
 import { clean } from "#util/clean";
-import { randomDigits, randomInt } from "#util/generate";
+import {
+  randomChar,
+  randomDigits,
+  randomInt,
+} from "#util/generate";
 import { err } from "#util/result";
 import { isdigits } from "#util/strings";
 
@@ -45,7 +49,11 @@ const validate = (value: string): ValidateResult => {
       "Andorra NRT must be 8 characters",
     );
   }
+  // SAFETY: v.length === 8 guarantees both positions
+  // exist; oxlint cannot see the length guard.
+  // eslint-disable-next-line no-non-null-assertion
   const prefix = v[0]!;
+  // eslint-disable-next-line no-non-null-assertion
   const tail = v[7]!;
   const digits = v.slice(1, 7);
   if (!/^[A-Z]$/.test(prefix) || !/^[A-Z]$/.test(tail)) {

package/src/ar/cbu.ts

@@ -28,8 +28,8 @@ const calcCheck = (
   weights: readonly number[],
 ): number => {
   let sum = 0;
-  for (let i = 0; i < digits.length; i++) {
-    sum += Number(digits[i]) * weights[i]!;
+  for (const [i, weight] of weights.entries()) {
+    sum += Number(digits[i]) * weight;
   }
   return (10 - (sum % 10)) % 10;
 };

package/src/ar/cuit.ts

@@ -17,7 +17,7 @@
  */
 
 import { clean } from "#util/clean";
-import { randomDigits } from "#util/generate";
+import { randomDigits, randomPick } from "#util/generate";
 import { err } from "#util/result";
 import { isdigits } from "#util/strings";
 
@@ -36,7 +36,17 @@ const VALID_TYPES = new Set([
   "55",
 ]);
 
-const WEIGHTS = [5, 4, 3, 2, 7, 6, 5, 4, 3, 2];
+const WEIGHTS = [5, 4, 3, 2, 7, 6, 5, 4, 3, 2] as const;
+
+const GENERATE_TYPES = [
+  "20",
+  "23",
+  "24",
+  "27",
+  "30",
+  "33",
+  "34",
+] as const;
 
 const compact = (value: string): string =>
   clean(value, " -.").trim();
@@ -49,8 +59,8 @@ const compact = (value: string): string =>
  */
 const calcCheckDigit = (body: string): number => {
   let sum = 0;
-  for (let i = 0; i < 10; i++) {
-    sum += Number(body[i]) * WEIGHTS[i]!;
+  for (const [i, weight] of WEIGHTS.entries()) {
+    sum += Number(body[i]) * weight;
   }
   const remainder = 11 - (sum % 11);
   if (remainder === 11) return 0;
@@ -98,9 +108,7 @@ const format = (value: string): string => {
 
 /** Generate a random valid CUIT. */
 const generate = (): string => {
-  const types = ["20", "23", "24", "27", "30", "33", "34"];
-  const type =
-    types[Math.floor(Math.random() * types.length)]!;
+  const type = randomPick(GENERATE_TYPES);
   const body = type + randomDigits(8);
   const check = calcCheckDigit(body);
   return body + String(check);

package/src/at/vnr.ts

@@ -11,6 +11,7 @@
  */
 
 import { clean } from "#util/clean";
+import { randomDigits, randomInt } from "#util/generate";
 import { err } from "#util/result";
 import { isdigits } from "#util/strings";
 
@@ -21,7 +22,7 @@ import type { ValidateResult, Validator } from "../types";
  * 0,1,2, then 4,5,6,7,8,9). Check digit is at
  * position 3 and equals the weighted sum mod 11.
  */
-const WEIGHTS = [3, 7, 9, 5, 8, 4, 2, 1, 6];
+const WEIGHTS = [3, 7, 9, 5, 8, 4, 2, 1, 6] as const;
 
 const compact = (value: string): string =>
   clean(value, " -/").trim();
@@ -58,8 +59,8 @@ const validate = (value: string): ValidateResult => {
   // number is invalid.
   const digits = v.slice(0, 3) + v.slice(4);
   let sum = 0;
-  for (let i = 0; i < 9; i++) {
-    sum += Number(digits[i]) * WEIGHTS[i]!;
+  for (const [i, weight] of WEIGHTS.entries()) {
+    sum += Number(digits[i]) * weight;
   }
   const check = sum % 11;
   if (check === 10) {
@@ -84,6 +85,26 @@ const format = (value: string): string => {
   return `${v.slice(0, 4)} ${v.slice(4, 6)}${v.slice(6, 8)}${v.slice(8)}`;
 };
 
+/** Generate a random valid Austrian VNR. */
+const generate = (): string => {
+  for (;;) {
+    const serial = randomDigits(3);
+    const day = String(randomInt(1, 28)).padStart(2, "0");
+    const month = String(randomInt(1, 12)).padStart(2, "0");
+    const year = String(randomInt(0, 99)).padStart(2, "0");
+    const digits = `${serial}${day}${month}${year}`;
+
+    let sum = 0;
+    for (const [i, weight] of WEIGHTS.entries()) {
+      sum += Number(digits[i]) * weight;
+    }
+
+    const check = sum % 11;
+    if (check === 10) continue;
+    return `${serial}${String(check)}${day}${month}${year}`;
+  }
+};
+
 /** Austrian Social Insurance Number. */
 const vnr: Validator = {
   name: "Austrian Social Insurance Number",
@@ -105,7 +126,8 @@ const vnr: Validator = {
   compact,
   format,
   validate,
+  generate,
 };
 
 export default vnr;
-export { compact, format, validate };
+export { compact, format, generate, validate };

package/src/az/voen.ts

@@ -63,6 +63,8 @@ const validate = (value: string): ValidateResult => {
     );
   }
 
+  // SAFETY: regex above guarantees length === 10.
+  // eslint-disable-next-line no-non-null-assertion
   const lastDigit = v[9]!;
   if (lastDigit !== "1" && lastDigit !== "2") {
     return err(

package/src/ba/jmbg.ts

@@ -106,7 +106,7 @@ const generate = (): string => {
 };
 
 /** Bosnian Unique Master Citizen Number. */
-const jmbg: Validator = {
+const jmbg: Validator<ParsedPersonId> = {
   name: "Bosnian Personal ID",
   localName: "Jedinstveni matični broj građana",
   abbreviation: "JMBG",
@@ -120,6 +120,7 @@ const jmbg: Validator = {
   examples: ["0101006500006"] as const,
   compact,
   format,
+  parse,
   validate,
   generate,
 };

package/src/bd/nid.ts

@@ -1,9 +1,9 @@
+const RMO_VALUES = ["1", "2", "3", "4", "5", "9"] as const;
+
 /** Generate a random valid Bangladesh NID (13-digit). */
 const generate = (): string => {
   const district = randomDigits(2);
-  const rmoValues = ["1", "2", "3", "4", "5", "9"];
-  const rmo =
-    rmoValues[randomInt(0, rmoValues.length - 1)]!;
+  const rmo = randomPick(RMO_VALUES);
   const rest = randomDigits(10);
   return `${district}${rmo}${rest}`;
 };
@@ -31,7 +31,7 @@ const generate = (): string => {
  */
 
 import { clean } from "#util/clean";
-import { randomDigits, randomInt } from "#util/generate";
+import { randomDigits, randomPick } from "#util/generate";
 import { err } from "#util/result";
 import { isdigits } from "#util/strings";
 

package/src/bg/egn.ts

@@ -5,8 +5,14 @@
  * 10 digits encoding date of birth, serial number,
  * and a check digit.
  *
- * @see https://en.wikipedia.org/wiki/Unique_citizenship_number
- * @see https://www.grao.bg/
+ * 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
  */
 
 import { weightedSum } from "#checksums/weighted-sum";
@@ -131,7 +137,7 @@ const generate = (): string => {
 };
 
 /** Bulgarian Personal Identification Number. */
-const egn: Validator = {
+const egn: Validator<ParsedPersonId> = {
   name: "Bulgarian Personal ID",
   localName: "Единен граждански номер",
   abbreviation: "ЕГН",
@@ -143,10 +149,12 @@ const egn: Validator = {
   candidatePattern: "\\d{10}",
   country: "BG",
   entityType: "person",
-  sourceUrl: "https://www.grao.bg/",
+  sourceUrl:
+    "https://www.grao.bg/normact/NaredbaFunkcESGR.pdf",
   examples: ["7523169263"] as const,
   compact,
   format,
+  parse,
   validate,
   generate,
 };

package/src/bh/cpr.ts

@@ -17,6 +17,7 @@
  */
 
 import { clean } from "#util/clean";
+import { randomDigits, randomInt } from "#util/generate";
 import { err } from "#util/result";
 import { isdigits } from "#util/strings";
 
@@ -59,6 +60,13 @@ const format = (value: string): string => {
   return `${v.slice(0, 2)}-${v.slice(2, 4)}-${v.slice(4)}`;
 };
 
+/** Generate a random structurally valid Bahrain CPR. */
+const generate = (): string => {
+  const yy = String(randomInt(0, 99)).padStart(2, "0");
+  const mm = String(randomInt(1, 12)).padStart(2, "0");
+  return `${yy}${mm}${randomDigits(5)}`;
+};
+
 /** Bahrain Central Population Registration number. */
 const cpr: Validator = {
   name: "Central Population Registration Number",
@@ -75,7 +83,8 @@ const cpr: Validator = {
   compact,
   format,
   validate,
+  generate,
 };
 
 export default cpr;
-export { compact, format, validate };
+export { compact, format, generate, validate };

package/src/bic.ts

@@ -1,28 +1,26 @@
+const BIC_ALPHANUM = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
+const BIC_COUNTRIES = [
+  "DE",
+  "GB",
+  "US",
+  "FR",
+  "CH",
+  "NL",
+  "AT",
+] as const;
+
 /** Generate a random valid BIC (8-character). */
 const generate = (): string => {
   const randomLetter = (): string =>
     String.fromCodePoint(65 + randomInt(0, 25));
-  const randomAlphaNum = (): string => {
-    const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
-    return chars[randomInt(0, chars.length - 1)]!;
-  };
-  const countries = [
-    "DE",
-    "GB",
-    "US",
-    "FR",
-    "CH",
-    "NL",
-    "AT",
-  ];
-  const country =
-    countries[randomInt(0, countries.length - 1)]!;
+  const country = randomPick(BIC_COUNTRIES);
   const bank =
     randomLetter() +
     randomLetter() +
     randomLetter() +
     randomLetter();
-  const location = randomAlphaNum() + randomAlphaNum();
+  const location =
+    randomChar(BIC_ALPHANUM) + randomChar(BIC_ALPHANUM);
   return `${bank}${country}${location}`;
 };
 
@@ -39,7 +37,11 @@ const generate = (): string => {
  */
 
 import { clean } from "#util/clean";
-import { randomInt } from "#util/generate";
+import {
+  randomChar,
+  randomInt,
+  randomPick,
+} from "#util/generate";
 import { err } from "#util/result";
 
 import type { ValidateResult, Validator } from "./types";

package/src/by/unp.ts

@@ -52,16 +52,19 @@ const compact = (value: string): string => {
 const calcCheckDigit = (number: string): number | null => {
   let work = number;
   if (!isdigits(number)) {
-    const idx = ALPHA_SET.indexOf(number[1]!);
+    const second = number[1];
+    if (second === undefined) return null;
+    const idx = ALPHA_SET.indexOf(second);
     if (idx === -1) return null;
     work = number[0] + String(idx) + number.slice(2);
   }
   let sum = 0;
-  for (let i = 0; i < 8; i++) {
-    const ch = work[i]!;
+  for (const [i, weight] of WEIGHTS.entries()) {
+    const ch = work[i];
+    if (ch === undefined) return null;
     const val = ALPHABET.indexOf(ch);
     if (val === -1) return null;
-    sum += (WEIGHTS[i] ?? 0) * val;
+    sum += weight * val;
   }
   const remainder = sum % 11;
   if (remainder > 9) return null;
@@ -93,6 +96,8 @@ const validate = (value: string): ValidateResult => {
         " digits or letters from ABCEHKMOPT",
     );
   }
+  // SAFETY: v.length === 9 guarantees v[0] exists.
+  // eslint-disable-next-line no-non-null-assertion
   if (!VALID_FIRST.includes(v[0]!)) {
     return err(
       "INVALID_COMPONENT",