@stll/stdnum 1.0.0 → 2.0.1

package/dist/by/unp.js.map

@@ -1 +1 @@
-{"version":3,"file":"unp.js","names":[],"sources":["../../src/by/unp.ts"],"sourcesContent":["/**\n * UNP (Учётный номер плательщика, Belarus tax number).\n *\n * 9 characters: the first two identify the region (numeric\n * for organisations, letters from ABCEHKMOPT for\n * individuals), followed by 7 digits. The last digit is a\n * weighted check digit (mod 11; if remainder > 9 the\n * number is invalid).\n *\n * @see https://be.wikipedia.org/wiki/Уліковы_нумар_плацельшчыка\n * @see https://www.nalog.gov.by/\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/** Cyrillic to Latin mapping for the letter positions. */\nconst CYRILLIC_TO_LATIN: Record<string, string> = {\n  А: \"A\",\n  В: \"B\",\n  Е: \"E\",\n  К: \"K\",\n  М: \"M\",\n  Н: \"H\",\n  О: \"O\",\n  Р: \"P\",\n  С: \"C\",\n  Т: \"T\",\n};\n\nconst WEIGHTS = [29, 23, 19, 17, 13, 7, 5, 3] as const;\nconst ALPHA_SET = \"ABCEHKMOPT\";\nconst VALID_FIRST = \"1234567ABCEHKM\";\nconst ALPHABET = \"0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ\";\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" \").toUpperCase().trim();\n  if (v.startsWith(\"УНП\")) {\n    v = v.slice(3);\n  } else if (v.startsWith(\"UNP\")) {\n    v = v.slice(3);\n  }\n  return [...v]\n    .map((ch) => CYRILLIC_TO_LATIN[ch] ?? ch)\n    .join(\"\");\n};\n\nconst calcCheckDigit = (number: string): number | null => {\n  let work = number;\n  if (!isdigits(number)) {\n    const second = number[1];\n    if (second === undefined) return null;\n    const idx = ALPHA_SET.indexOf(second);\n    if (idx === -1) return null;\n    work = number[0] + String(idx) + number.slice(2);\n  }\n  let sum = 0;\n  for (const [i, weight] of WEIGHTS.entries()) {\n    const ch = work[i];\n    if (ch === undefined) return null;\n    const val = ALPHABET.indexOf(ch);\n    if (val === -1) return null;\n    sum += weight * val;\n  }\n  const remainder = sum % 11;\n  if (remainder > 9) return null;\n  return remainder;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Belarus UNP must be 9 characters\",\n    );\n  }\n  if (!isdigits(v.slice(2))) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Belarus UNP positions 3-9 must be digits\",\n    );\n  }\n  const first2 = v.slice(0, 2);\n  if (\n    !isdigits(first2) &&\n    ![...first2].every((ch) => ALPHA_SET.includes(ch))\n  ) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Belarus UNP first two characters must be\" +\n        \" digits or letters from ABCEHKMOPT\",\n    );\n  }\n  // SAFETY: v.length === 9 guarantees v[0] exists.\n  // eslint-disable-next-line no-non-null-assertion\n  if (!VALID_FIRST.includes(v[0]!)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Belarus UNP has an invalid region prefix\",\n    );\n  }\n  const expected = calcCheckDigit(v);\n  if (expected === null) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Belarus UNP check digit is invalid\" +\n        \" (mod 11 remainder > 9)\",\n    );\n  }\n  if (v[8] !== String(expected)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Belarus UNP check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Belarus UNP. */\nconst generate = (): string => {\n  for (let i = 0; i < 100; i++) {\n    const prefix = String(randomInt(1, 7));\n    const rest = randomDigits(7);\n    const payload = prefix + rest;\n    const check = calcCheckDigit(payload);\n    if (check === null) continue;\n    const c = payload.slice(0, 8) + String(check);\n    if (validate(c).valid) return c;\n  }\n  throw new Error(\"Failed to generate valid UNP\");\n};\n\n/** Belarus UNP (Учётный номер плательщика). */\nconst unp: Validator = {\n  name: \"Belarus Tax Number\",\n  localName: \"Учётный номер плательщика\",\n  abbreviation: \"УНП\",\n  aliases: [\"УНП\", \"UNP\"] as const,\n  candidatePattern: \"\\\\d{9}\",\n  country: \"BY\",\n  entityType: \"any\",\n  sourceUrl: \"https://www.nalog.gov.by/\",\n  examples: [\"200988541\", \"MA1953684\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default unp;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;AAqBA,MAAM,oBAA4C;CAChD,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACJ;AAED,MAAM,UAAU;CAAC;CAAI;CAAI;CAAI;CAAI;CAAI;CAAG;CAAG;CAAE;AAC7C,MAAM,YAAY;AAClB,MAAM,cAAc;AACpB,MAAM,WAAW;AAEjB,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM;AAC9C,KAAI,EAAE,WAAW,MAAM,CACrB,KAAI,EAAE,MAAM,EAAE;UACL,EAAE,WAAW,MAAM,CAC5B,KAAI,EAAE,MAAM,EAAE;AAEhB,QAAO,CAAC,GAAG,EAAE,CACV,KAAK,OAAO,kBAAkB,OAAO,GAAG,CACxC,KAAK,GAAG;;AAGb,MAAM,kBAAkB,WAAkC;CACxD,IAAI,OAAO;AACX,KAAI,CAAC,SAAS,OAAO,EAAE;EACrB,MAAM,SAAS,OAAO;AACtB,MAAI,WAAW,KAAA,EAAW,QAAO;EACjC,MAAM,MAAM,UAAU,QAAQ,OAAO;AACrC,MAAI,QAAQ,GAAI,QAAO;AACvB,SAAO,OAAO,KAAK,OAAO,IAAI,GAAG,OAAO,MAAM,EAAE;;CAElD,IAAI,MAAM;AACV,MAAK,MAAM,CAAC,GAAG,WAAW,QAAQ,SAAS,EAAE;EAC3C,MAAM,KAAK,KAAK;AAChB,MAAI,OAAO,KAAA,EAAW,QAAO;EAC7B,MAAM,MAAM,SAAS,QAAQ,GAAG;AAChC,MAAI,QAAQ,GAAI,QAAO;AACvB,SAAO,SAAS;;CAElB,MAAM,YAAY,MAAM;AACxB,KAAI,YAAY,EAAG,QAAO;AAC1B,QAAO;;AAGT,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,mCACD;AAEH,KAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,CACvB,QAAO,IACL,kBACA,2CACD;CAEH,MAAM,SAAS,EAAE,MAAM,GAAG,EAAE;AAC5B,KACE,CAAC,SAAS,OAAO,IACjB,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,OAAO,UAAU,SAAS,GAAG,CAAC,CAElD,QAAO,IACL,kBACA,6EAED;AAIH,KAAI,CAAC,YAAY,SAAS,EAAE,GAAI,CAC9B,QAAO,IACL,qBACA,2CACD;CAEH,MAAM,WAAW,eAAe,EAAE;AAClC,KAAI,aAAa,KACf,QAAO,IACL,oBACA,4DAED;AAEH,KAAI,EAAE,OAAO,OAAO,SAAS,CAC3B,QAAO,IACL,oBACA,mCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;AAC7B,MAAK,IAAI,IAAI,GAAG,IAAI,KAAK,KAAK;EAG5B,MAAM,UAFS,OAAO,UAAU,GAAG,EAAE,CAAC,GACzB,aAAa,EAAE;EAE5B,MAAM,QAAQ,eAAe,QAAQ;AACrC,MAAI,UAAU,KAAM;EACpB,MAAM,IAAI,QAAQ,MAAM,GAAG,EAAE,GAAG,OAAO,MAAM;AAC7C,MAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;AAEhC,OAAM,IAAI,MAAM,+BAA+B;;;AAIjD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,MAAM;CACvB,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,aAAa,YAAY;CACpC;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"unp.js","names":[],"sources":["../../src/by/unp.ts"],"sourcesContent":["/**\n * UNP (Учётный номер плательщика, Belarus tax number).\n *\n * 9 characters: the first two identify the region (numeric\n * for organisations, letters from ABCEHKMOPT for\n * individuals), followed by 7 digits. The last digit is a\n * weighted check digit (mod 11; if remainder > 9 the\n * number is invalid).\n *\n * @see https://be.wikipedia.org/wiki/Уліковы_нумар_плацельшчыка\n * @see https://www.nalog.gov.by/\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\n/** Cyrillic to Latin mapping for the letter positions. */\nconst CYRILLIC_TO_LATIN: Record<string, string> = {\n  А: \"A\",\n  В: \"B\",\n  Е: \"E\",\n  К: \"K\",\n  М: \"M\",\n  Н: \"H\",\n  О: \"O\",\n  Р: \"P\",\n  С: \"C\",\n  Т: \"T\",\n};\n\nconst WEIGHTS = [29, 23, 19, 17, 13, 7, 5, 3] as const;\nconst ALPHA_SET = \"ABCEHKMOPT\";\nconst VALID_FIRST = \"1234567ABCEHKM\";\nconst ALPHABET = \"0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ\";\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" \").toUpperCase().trim();\n  if (v.startsWith(\"УНП\")) {\n    v = v.slice(3);\n  } else if (v.startsWith(\"UNP\")) {\n    v = v.slice(3);\n  }\n  return v\n    .split(\"\")\n    .map((ch) => CYRILLIC_TO_LATIN[ch] ?? ch)\n    .join(\"\");\n};\n\nconst calcCheckDigit = (number: string): number | null => {\n  let work = number;\n  if (!isdigits(number)) {\n    const second = number[1];\n    if (second === undefined) return null;\n    const idx = ALPHA_SET.indexOf(second);\n    if (idx === -1) return null;\n    work = number[0] + String(idx) + number.slice(2);\n  }\n  let sum = 0;\n  for (const [i, weight] of WEIGHTS.entries()) {\n    const ch = work[i];\n    if (ch === undefined) return null;\n    const val = ALPHABET.indexOf(ch);\n    if (val === -1) return null;\n    sum += weight * val;\n  }\n  const remainder = sum % 11;\n  if (remainder > 9) return null;\n  return remainder;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Belarus UNP must be 9 characters\",\n    );\n  }\n  if (!isdigits(v.slice(2))) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Belarus UNP positions 3-9 must be digits\",\n    );\n  }\n  const first2 = v.slice(0, 2);\n  if (\n    !isdigits(first2) &&\n    !first2.split(\"\").every((ch) => ALPHA_SET.includes(ch))\n  ) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Belarus UNP first two characters must be\" +\n        \" digits or letters from ABCEHKMOPT\",\n    );\n  }\n  // SAFETY: v.length === 9 guarantees v[0] exists.\n  // eslint-disable-next-line no-non-null-assertion\n  if (!VALID_FIRST.includes(v[0]!)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Belarus UNP has an invalid region prefix\",\n    );\n  }\n  const expected = calcCheckDigit(v);\n  if (expected === null) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Belarus UNP check digit is invalid\" +\n        \" (mod 11 remainder > 9)\",\n    );\n  }\n  if (v[8] !== String(expected)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Belarus UNP check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Belarus UNP. */\nconst generate = (): string => {\n  for (let i = 0; i < 100; i++) {\n    const prefix = String(randomInt(1, 7));\n    const rest = randomDigits(7);\n    const payload = prefix + rest;\n    const check = calcCheckDigit(payload);\n    if (check === null) continue;\n    const c = payload.slice(0, 8) + String(check);\n    if (validate(c).valid) return c;\n  }\n  throw new Error(\"Failed to generate valid UNP\");\n};\n\n/** Belarus UNP (Учётный номер плательщика). */\nconst unp: CountryValidator<\"BY\"> = {\n  name: \"Belarus Tax Number\",\n  localName: \"Учётный номер плательщика\",\n  abbreviation: \"УНП\",\n  aliases: [\"УНП\", \"UNP\"] as const,\n  candidatePattern: \"\\\\d{9}\",\n  scope: \"country\",\n  country: \"BY\",\n  entityType: \"any\",\n  sourceUrl: \"https://www.nalog.gov.by/\",\n  examples: [\"200988541\", \"MA1953684\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default unp;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AAwBA,MAAM,oBAA4C;CAChD,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;AACL;AAEA,MAAM,UAAU;CAAC;CAAI;CAAI;CAAI;CAAI;CAAI;CAAG;CAAG;AAAC;AAC5C,MAAM,YAAY;AAClB,MAAM,cAAc;AACpB,MAAM,WAAW;AAEjB,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,GAAG,EAAE,YAAY,EAAE,KAAK;CAC7C,IAAI,EAAE,WAAW,KAAK,GACpB,IAAI,EAAE,MAAM,CAAC;MACR,IAAI,EAAE,WAAW,KAAK,GAC3B,IAAI,EAAE,MAAM,CAAC;CAEf,OAAO,EACJ,MAAM,EAAE,EACR,KAAK,OAAO,kBAAkB,OAAO,EAAE,EACvC,KAAK,EAAE;AACZ;AAEA,MAAM,kBAAkB,WAAkC;CACxD,IAAI,OAAO;CACX,IAAI,CAAC,SAAS,MAAM,GAAG;EACrB,MAAM,SAAS,OAAO;EACtB,IAAI,WAAW,KAAA,GAAW,OAAO;EACjC,MAAM,MAAM,UAAU,QAAQ,MAAM;EACpC,IAAI,QAAQ,IAAI,OAAO;EACvB,OAAO,OAAO,KAAK,OAAO,GAAG,IAAI,OAAO,MAAM,CAAC;CACjD;CACA,IAAI,MAAM;CACV,KAAK,MAAM,CAAC,GAAG,WAAW,QAAQ,QAAQ,GAAG;EAC3C,MAAM,KAAK,KAAK;EAChB,IAAI,OAAO,KAAA,GAAW,OAAO;EAC7B,MAAM,MAAM,SAAS,QAAQ,EAAE;EAC/B,IAAI,QAAQ,IAAI,OAAO;EACvB,OAAO,SAAS;CAClB;CACA,MAAM,YAAY,MAAM;CACxB,IAAI,YAAY,GAAG,OAAO;CAC1B,OAAO;AACT;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,GACf,OAAO,IACL,kBACA,kCACF;CAEF,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,GACtB,OAAO,IACL,kBACA,0CACF;CAEF,MAAM,SAAS,EAAE,MAAM,GAAG,CAAC;CAC3B,IACE,CAAC,SAAS,MAAM,KAChB,CAAC,OAAO,MAAM,EAAE,EAAE,OAAO,OAAO,UAAU,SAAS,EAAE,CAAC,GAEtD,OAAO,IACL,kBACA,4EAEF;CAIF,IAAI,CAAC,YAAY,SAAS,EAAE,EAAG,GAC7B,OAAO,IACL,qBACA,0CACF;CAEF,MAAM,WAAW,eAAe,CAAC;CACjC,IAAI,aAAa,MACf,OAAO,IACL,oBACA,2DAEF;CAEF,IAAI,EAAE,OAAO,OAAO,QAAQ,GAC1B,OAAO,IACL,oBACA,kCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,iBAAyB;CAC7B,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,KAAK;EAG5B,MAAM,UAFS,OAAO,UAAU,GAAG,CAAC,CAEf,IADR,aAAa,CACE;EAC5B,MAAM,QAAQ,eAAe,OAAO;EACpC,IAAI,UAAU,MAAM;EACpB,MAAM,IAAI,QAAQ,MAAM,GAAG,CAAC,IAAI,OAAO,KAAK;EAC5C,IAAI,SAAS,CAAC,EAAE,OAAO,OAAO;CAChC;CACA,MAAM,IAAI,MAAM,8BAA8B;AAChD;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,KAAK;CACtB,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,aAAa,WAAW;CACnC;CACA;CACA;CACA;AACF"}

package/dist/bz/tin.d.ts

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

package/dist/bz/tin.js

@@ -2,32 +2,6 @@ import { clean } from "../_util/clean.js";
 import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 //#region src/bz/tin.ts
-/**
-* TIN (Belize Tax Identification Number).
-*
-* Issued by the Belize Tax Service Department to
-* individuals, sole proprietors, partnerships, and
-* companies. The base number is 6 digits generated
-* by the Revenue Management System. A 2-digit
-* suffix code may be appended to indicate entity
-* type:
-*   - 10: individual
-*   - 13: company
-*   - 66: company (alternate)
-*
-* The OECD spec mentions a 7th check digit that is
-* not visible to the taxpayer; in practice the
-* number circulates as 6 or 8 digits (6 + suffix).
-*
-* Formatted as NNNNNN-SS (when suffix is present).
-*
-* Source: OECD CRS TIN information sheet; Belize
-* Tax Service (https://bts.gov.bz/).
-*
-* PERSON/ENTITY
-*
-* @see https://www.oecd.org/tax/automatic-exchange/crs-implementation-and-assistance/tax-identification-numbers/Belize-TIN.pdf
-*/
 /** Valid 2-digit suffix codes. */
 const SUFFIX_CODES = [
 	"10",
@@ -72,6 +46,7 @@ const tin = {
 	abbreviation: "TIN",
 	aliases: ["TIN"],
 	candidatePattern: "\\d{6}",
+	scope: "country",
 	country: "BZ",
 	entityType: "any",
 	lengths: [6, 8],

package/dist/bz/tin.js.map

@@ -1 +1 @@
-{"version":3,"file":"tin.js","names":[],"sources":["../../src/bz/tin.ts"],"sourcesContent":["/**\n * TIN (Belize Tax Identification Number).\n *\n * Issued by the Belize Tax Service Department to\n * individuals, sole proprietors, partnerships, and\n * companies. The base number is 6 digits generated\n * by the Revenue Management System. A 2-digit\n * suffix code may be appended to indicate entity\n * type:\n *   - 10: individual\n *   - 13: company\n *   - 66: company (alternate)\n *\n * The OECD spec mentions a 7th check digit that is\n * not visible to the taxpayer; in practice the\n * number circulates as 6 or 8 digits (6 + suffix).\n *\n * Formatted as NNNNNN-SS (when suffix is present).\n *\n * Source: OECD CRS TIN information sheet; Belize\n * Tax Service (https://bts.gov.bz/).\n *\n * PERSON/ENTITY\n *\n * @see https://www.oecd.org/tax/automatic-exchange/crs-implementation-and-assistance/tax-identification-numbers/Belize-TIN.pdf\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\n/** Valid 2-digit suffix codes. */\nconst SUFFIX_CODES = [\"10\", \"13\", \"66\"] as const;\n\nconst compact = (value: string): string => {\n  return clean(value, \" -\").trim();\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 6 && v.length !== 8) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Belize TIN must be 6 or 8 digits\",\n    );\n  }\n\n  if (!/^\\d+$/.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Belize TIN must contain only digits\",\n    );\n  }\n\n  if (v.length === 8) {\n    const suffix = v.slice(6);\n    if (\n      !SUFFIX_CODES.includes(\n        suffix as (typeof SUFFIX_CODES)[number],\n      )\n    ) {\n      return err(\n        \"INVALID_COMPONENT\",\n        \"Belize TIN suffix must be 10, 13, or 66\",\n      );\n    }\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length <= 6) {\n    return v;\n  }\n  return `${v.slice(0, 6)}-${v.slice(6)}`;\n};\n\n/** Generate a random valid Belize TIN. */\nconst generate = (): string => {\n  const base = randomDigits(6);\n  const suffixes = [\"\", ...SUFFIX_CODES] as const;\n  const suffix =\n    suffixes[randomInt(0, suffixes.length - 1)] ?? \"\";\n  return `${base}${suffix}`;\n};\n\n/**\n * Belize Tax Identification Number.\n *\n * Examples derived from stdnum-js test suite.\n */\nconst tin: Validator = {\n  name: \"Belize Tax Identification Number\",\n  localName: \"Tax Identification Number\",\n  abbreviation: \"TIN\",\n  aliases: [\"TIN\"] as const,\n  candidatePattern: \"\\\\d{6}\",\n  country: \"BZ\",\n  entityType: \"any\",\n  lengths: [6, 8] as const,\n  examples: [\"000005\", \"00000510\", \"00000513\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n  description:\n    \"Belize tax number issued by the Belize Tax Service Department\",\n  sourceUrl:\n    \"https://www.oecd.org/tax/automatic-exchange/crs-implementation-and-assistance/tax-identification-numbers/Belize-TIN.pdf\",\n};\n\nexport default tin;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,MAAM,eAAe;CAAC;CAAM;CAAM;CAAK;AAEvC,MAAM,WAAW,UAA0B;AACzC,QAAO,MAAM,OAAO,KAAK,CAAC,MAAM;;AAGlC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,KAAK,EAAE,WAAW,EACjC,QAAO,IACL,kBACA,mCACD;AAGH,KAAI,CAAC,QAAQ,KAAK,EAAE,CAClB,QAAO,IACL,kBACA,sCACD;AAGH,KAAI,EAAE,WAAW,GAAG;EAClB,MAAM,SAAS,EAAE,MAAM,EAAE;AACzB,MACE,CAAC,aAAa,SACZ,OACD,CAED,QAAO,IACL,qBACA,0CACD;;AAIL,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,UAAU,EACd,QAAO;AAET,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;;;AAIvC,MAAM,iBAAyB;CAC7B,MAAM,OAAO,aAAa,EAAE;CAC5B,MAAM,WAAW,CAAC,IAAI,GAAG,aAAa;AAGtC,QAAO,GAAG,OADR,SAAS,UAAU,GAAG,SAAS,SAAS,EAAE,KAAK;;;;;;;AASnD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,MAAM;CAChB,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG,EAAE;CACf,UAAU;EAAC;EAAU;EAAY;EAAW;CAC5C;CACA;CACA;CACA;CACA,aACE;CACF,WACE;CACH"}
+{"version":3,"file":"tin.js","names":[],"sources":["../../src/bz/tin.ts"],"sourcesContent":["/**\n * TIN (Belize Tax Identification Number).\n *\n * Issued by the Belize Tax Service Department to\n * individuals, sole proprietors, partnerships, and\n * companies. The base number is 6 digits generated\n * by the Revenue Management System. A 2-digit\n * suffix code may be appended to indicate entity\n * type:\n *   - 10: individual\n *   - 13: company\n *   - 66: company (alternate)\n *\n * The OECD spec mentions a 7th check digit that is\n * not visible to the taxpayer; in practice the\n * number circulates as 6 or 8 digits (6 + suffix).\n *\n * Formatted as NNNNNN-SS (when suffix is present).\n *\n * Source: OECD CRS TIN information sheet; Belize\n * Tax Service (https://bts.gov.bz/).\n *\n * PERSON/ENTITY\n *\n * @see https://www.oecd.org/tax/automatic-exchange/crs-implementation-and-assistance/tax-identification-numbers/Belize-TIN.pdf\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\";\n\n/** Valid 2-digit suffix codes. */\nconst SUFFIX_CODES = [\"10\", \"13\", \"66\"] as const;\n\nconst compact = (value: string): string => {\n  return clean(value, \" -\").trim();\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 6 && v.length !== 8) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Belize TIN must be 6 or 8 digits\",\n    );\n  }\n\n  if (!/^\\d+$/.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Belize TIN must contain only digits\",\n    );\n  }\n\n  if (v.length === 8) {\n    const suffix = v.slice(6);\n    if (\n      !SUFFIX_CODES.includes(\n        suffix as (typeof SUFFIX_CODES)[number],\n      )\n    ) {\n      return err(\n        \"INVALID_COMPONENT\",\n        \"Belize TIN suffix must be 10, 13, or 66\",\n      );\n    }\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length <= 6) {\n    return v;\n  }\n  return `${v.slice(0, 6)}-${v.slice(6)}`;\n};\n\n/** Generate a random valid Belize TIN. */\nconst generate = (): string => {\n  const base = randomDigits(6);\n  const suffixes = [\"\", ...SUFFIX_CODES] as const;\n  const suffix =\n    suffixes[randomInt(0, suffixes.length - 1)] ?? \"\";\n  return `${base}${suffix}`;\n};\n\n/**\n * Belize Tax Identification Number.\n *\n * Examples derived from stdnum-js test suite.\n */\nconst tin: CountryValidator<\"BZ\"> = {\n  name: \"Belize Tax Identification Number\",\n  localName: \"Tax Identification Number\",\n  abbreviation: \"TIN\",\n  aliases: [\"TIN\"] as const,\n  candidatePattern: \"\\\\d{6}\",\n  scope: \"country\",\n  country: \"BZ\",\n  entityType: \"any\",\n  lengths: [6, 8] as const,\n  examples: [\"000005\", \"00000510\", \"00000513\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n  description:\n    \"Belize tax number issued by the Belize Tax Service Department\",\n  sourceUrl:\n    \"https://www.oecd.org/tax/automatic-exchange/crs-implementation-and-assistance/tax-identification-numbers/Belize-TIN.pdf\",\n};\n\nexport default tin;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;AAqCA,MAAM,eAAe;CAAC;CAAM;CAAM;AAAI;AAEtC,MAAM,WAAW,UAA0B;CACzC,OAAO,MAAM,OAAO,IAAI,EAAE,KAAK;AACjC;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CAEvB,IAAI,EAAE,WAAW,KAAK,EAAE,WAAW,GACjC,OAAO,IACL,kBACA,kCACF;CAGF,IAAI,CAAC,QAAQ,KAAK,CAAC,GACjB,OAAO,IACL,kBACA,qCACF;CAGF,IAAI,EAAE,WAAW,GAAG;EAClB,MAAM,SAAS,EAAE,MAAM,CAAC;EACxB,IACE,CAAC,aAAa,SACZ,MACF,GAEA,OAAO,IACL,qBACA,yCACF;CAEJ;CAEA,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,UAAU,GACd,OAAO;CAET,OAAO,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC;AACtC;;AAGA,MAAM,iBAAyB;CAC7B,MAAM,OAAO,aAAa,CAAC;CAC3B,MAAM,WAAW,CAAC,IAAI,GAAG,YAAY;CAGrC,OAAO,GAAG,OADR,SAAS,UAAU,GAAG,SAAS,SAAS,CAAC,MAAM;AAEnD;;;;;;AAOA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,KAAK;CACf,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG,CAAC;CACd,UAAU;EAAC;EAAU;EAAY;CAAU;CAC3C;CACA;CACA;CACA;CACA,aACE;CACF,WACE;AACJ"}

package/dist/ca/bn.d.ts

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

package/dist/ca/bn.js

@@ -1,18 +1,9 @@
+import { luhnChecksum, luhnValidate } from "../_checksums/luhn.js";
 import { clean } from "../_util/clean.js";
 import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
-import { luhnChecksum, luhnValidate } from "../_checksums/luhn.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/ca/bn.ts
-/**
-* BN (Canadian Business Number).
-*
-* 9-digit BN root (Luhn checksum) optionally
-* followed by a 2-letter program type (RC, RM,
-* RP, RT) and a 4-digit reference number (BN15).
-*
-* @see https://www.canada.ca/en/services/taxes/business-number.html
-*/
 const VALID_PROGRAMS = new Set([
 	"RC",
 	"RM",
@@ -58,6 +49,7 @@ const bn = {
 		"numéro d'entreprise"
 	],
 	candidatePattern: "\\d{9}\\s?[A-Z]{2}\\s?\\d{4}",
+	scope: "country",
 	country: "CA",
 	entityType: "company",
 	sourceUrl: "https://www.canada.ca/en/services/taxes/business-number.html",

package/dist/ca/bn.js.map

@@ -1 +1 @@
-{"version":3,"file":"bn.js","names":[],"sources":["../../src/ca/bn.ts"],"sourcesContent":["/**\n * BN (Canadian Business Number).\n *\n * 9-digit BN root (Luhn checksum) optionally\n * followed by a 2-letter program type (RC, RM,\n * RP, RT) and a 4-digit reference number (BN15).\n *\n * @see https://www.canada.ca/en/services/taxes/business-number.html\n */\n\nimport {\n  luhnValidate,\n  luhnChecksum,\n} from \"#checksums/luhn\";\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 VALID_PROGRAMS = new Set([\"RC\", \"RM\", \"RP\", \"RT\"]);\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9 && v.length !== 15) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"BN must be 9 or 15 characters\",\n    );\n  }\n  if (!isdigits(v.slice(0, 9))) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"BN root must contain only digits\",\n    );\n  }\n  if (!luhnValidate(v.slice(0, 9))) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"BN Luhn check digit mismatch\",\n    );\n  }\n  if (v.length === 15) {\n    const program = v.slice(9, 11);\n    if (!VALID_PROGRAMS.has(program)) {\n      return err(\n        \"INVALID_COMPONENT\",\n        \"BN program type must be RC, RM, RP, or RT\",\n      );\n    }\n    if (!isdigits(v.slice(11))) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"BN reference number must be digits\",\n      );\n    }\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length === 15) {\n    return `${v.slice(0, 3)} ${v.slice(3, 6)} ${v.slice(6, 9)} ${v.slice(9, 11)} ${v.slice(11)}`;\n  }\n  if (v.length === 9) {\n    return `${v.slice(0, 3)} ${v.slice(3, 6)} ${v.slice(6)}`;\n  }\n  return v;\n};\n\n/** Generate a random valid Canadian BN. */\nconst generate = (): string => {\n  const payload = randomDigits(8);\n  const cs = luhnChecksum(payload + \"0\");\n  return payload + String((10 - cs) % 10);\n};\n\n/** Canadian Business Number. */\nconst bn: Validator = {\n  name: \"Business Number\",\n  localName: \"Business Number\",\n  abbreviation: \"BN\",\n  aliases: [\n    \"BN\",\n    \"Business Number\",\n    \"numéro d'entreprise\",\n  ] as const,\n  candidatePattern: \"\\\\d{9}\\\\s?[A-Z]{2}\\\\s?\\\\d{4}\",\n  country: \"CA\",\n  entityType: \"company\",\n  sourceUrl:\n    \"https://www.canada.ca/en/services/taxes/business-number.html\",\n  examples: [\"123026635\", \"123026635RC0001\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default bn;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;AAqBA,MAAM,iBAAiB,IAAI,IAAI;CAAC;CAAM;CAAM;CAAM;CAAK,CAAC;AAExD,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,KAAK,EAAE,WAAW,GACjC,QAAO,IACL,kBACA,gCACD;AAEH,KAAI,CAAC,SAAS,EAAE,MAAM,GAAG,EAAE,CAAC,CAC1B,QAAO,IACL,kBACA,mCACD;AAEH,KAAI,CAAC,aAAa,EAAE,MAAM,GAAG,EAAE,CAAC,CAC9B,QAAO,IACL,oBACA,+BACD;AAEH,KAAI,EAAE,WAAW,IAAI;EACnB,MAAM,UAAU,EAAE,MAAM,GAAG,GAAG;AAC9B,MAAI,CAAC,eAAe,IAAI,QAAQ,CAC9B,QAAO,IACL,qBACA,4CACD;AAEH,MAAI,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,CACxB,QAAO,IACL,kBACA,qCACD;;AAIL,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,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG;AAE5F,KAAI,EAAE,WAAW,EACf,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;AAExD,QAAO;;;AAIT,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,EAAE;CAC/B,MAAM,KAAK,aAAa,UAAU,IAAI;AACtC,QAAO,UAAU,QAAQ,KAAK,MAAM,GAAG;;;AAIzC,MAAM,KAAgB;CACpB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WACE;CACF,UAAU,CAAC,aAAa,kBAAkB;CAC1C;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"bn.js","names":[],"sources":["../../src/ca/bn.ts"],"sourcesContent":["/**\n * BN (Canadian Business Number).\n *\n * 9-digit BN root (Luhn checksum) optionally\n * followed by a 2-letter program type (RC, RM,\n * RP, RT) and a 4-digit reference number (BN15).\n *\n * @see https://www.canada.ca/en/services/taxes/business-number.html\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport {\n  luhnValidate,\n  luhnChecksum,\n} from \"#checksums/luhn\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst VALID_PROGRAMS = new Set([\"RC\", \"RM\", \"RP\", \"RT\"]);\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9 && v.length !== 15) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"BN must be 9 or 15 characters\",\n    );\n  }\n  if (!isdigits(v.slice(0, 9))) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"BN root must contain only digits\",\n    );\n  }\n  if (!luhnValidate(v.slice(0, 9))) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"BN Luhn check digit mismatch\",\n    );\n  }\n  if (v.length === 15) {\n    const program = v.slice(9, 11);\n    if (!VALID_PROGRAMS.has(program)) {\n      return err(\n        \"INVALID_COMPONENT\",\n        \"BN program type must be RC, RM, RP, or RT\",\n      );\n    }\n    if (!isdigits(v.slice(11))) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"BN reference number must be digits\",\n      );\n    }\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length === 15) {\n    return `${v.slice(0, 3)} ${v.slice(3, 6)} ${v.slice(6, 9)} ${v.slice(9, 11)} ${v.slice(11)}`;\n  }\n  if (v.length === 9) {\n    return `${v.slice(0, 3)} ${v.slice(3, 6)} ${v.slice(6)}`;\n  }\n  return v;\n};\n\n/** Generate a random valid Canadian BN. */\nconst generate = (): string => {\n  const payload = randomDigits(8);\n  const cs = luhnChecksum(payload + \"0\");\n  return payload + String((10 - cs) % 10);\n};\n\n/** Canadian Business Number. */\nconst bn: CountryValidator<\"CA\"> = {\n  name: \"Business Number\",\n  localName: \"Business Number\",\n  abbreviation: \"BN\",\n  aliases: [\n    \"BN\",\n    \"Business Number\",\n    \"numéro d'entreprise\",\n  ] as const,\n  candidatePattern: \"\\\\d{9}\\\\s?[A-Z]{2}\\\\s?\\\\d{4}\",\n  scope: \"country\",\n  country: \"CA\",\n  entityType: \"company\",\n  sourceUrl:\n    \"https://www.canada.ca/en/services/taxes/business-number.html\",\n  examples: [\"123026635\", \"123026635RC0001\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default bn;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AAwBA,MAAM,iBAAiB,IAAI,IAAI;CAAC;CAAM;CAAM;CAAM;AAAI,CAAC;AAEvD,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;AAEnB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,KAAK,EAAE,WAAW,IACjC,OAAO,IACL,kBACA,+BACF;CAEF,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,CAAC,GACzB,OAAO,IACL,kBACA,kCACF;CAEF,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,CAAC,CAAC,GAC7B,OAAO,IACL,oBACA,8BACF;CAEF,IAAI,EAAE,WAAW,IAAI;EACnB,MAAM,UAAU,EAAE,MAAM,GAAG,EAAE;EAC7B,IAAI,CAAC,eAAe,IAAI,OAAO,GAC7B,OAAO,IACL,qBACA,2CACF;EAEF,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,GACvB,OAAO,IACL,kBACA,oCACF;CAEJ;CAEA,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,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;CAE3F,IAAI,EAAE,WAAW,GACf,OAAO,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC;CAEvD,OAAO;AACT;;AAGA,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,CAAC;CAC9B,MAAM,KAAK,aAAa,UAAU,GAAG;CACrC,OAAO,UAAU,QAAQ,KAAK,MAAM,EAAE;AACxC;;AAGA,MAAM,KAA6B;CACjC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;CACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WACE;CACF,UAAU,CAAC,aAAa,iBAAiB;CACzC;CACA;CACA;CACA;AACF"}

package/dist/ca/sin.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/ca/sin.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid Canadian SIN. */
 declare const generate: () => string;
 /** Canadian Social Insurance Number. */
-declare const sin: Validator;
+declare const sin: CountryValidator<"CA">;
 //#endregion
 export { compact, sin as default, format, generate, validate };
 //# sourceMappingURL=sin.d.ts.map

package/dist/ca/sin.js

@@ -1,18 +1,9 @@
+import { luhnChecksum, luhnValidate } from "../_checksums/luhn.js";
 import { clean } from "../_util/clean.js";
 import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
-import { luhnChecksum, luhnValidate } from "../_checksums/luhn.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/ca/sin.ts
-/**
-* SIN (Canadian Social Insurance Number).
-*
-* 9-digit identifier with Luhn checksum. First
-* digit cannot be 0 or 8.
-*
-* @see https://www.canada.ca/en/employment-social-development/services/sin.html
-* @see https://en.wikipedia.org/wiki/Social_Insurance_Number
-*/
 const compact = (value) => clean(value, " -");
 const validate = (value) => {
 	const v = compact(value);
@@ -47,6 +38,7 @@ const sin = {
 		"NAS"
 	],
 	candidatePattern: "\\d{3}-?\\d{3}-?\\d{3}",
+	scope: "country",
 	country: "CA",
 	entityType: "person",
 	sourceUrl: "https://www.canada.ca/en/employment-social-development/services/sin.html",

package/dist/ca/sin.js.map

@@ -1 +1 @@
-{"version":3,"file":"sin.js","names":[],"sources":["../../src/ca/sin.ts"],"sourcesContent":["/**\n * SIN (Canadian Social Insurance Number).\n *\n * 9-digit identifier with Luhn checksum. First\n * digit cannot be 0 or 8.\n *\n * @see https://www.canada.ca/en/employment-social-development/services/sin.html\n * @see https://en.wikipedia.org/wiki/Social_Insurance_Number\n */\n\nimport {\n  luhnValidate,\n  luhnChecksum,\n} from \"#checksums/luhn\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"SIN must contain only digits\",\n    );\n  }\n  if (v.length !== 9) {\n    return err(\"INVALID_LENGTH\", \"SIN must be 9 digits\");\n  }\n  if (v[0] === \"0\" || v[0] === \"8\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"SIN cannot start with 0 or 8\",\n    );\n  }\n  if (!luhnValidate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"SIN Luhn check digit mismatch\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length === 9) {\n    return `${v.slice(0, 3)}-${v.slice(3, 6)}-${v.slice(6)}`;\n  }\n  return v;\n};\n\n/** Generate a random valid Canadian SIN. */\nconst generate = (): string => {\n  const first = String(randomInt(1, 7));\n  const payload = first + randomDigits(7);\n  const cs = luhnChecksum(payload + \"0\");\n  return payload + String((10 - cs) % 10);\n};\n\n/** Canadian Social Insurance Number. */\nconst sin: Validator = {\n  name: \"Social Insurance Number\",\n  localName: \"Social Insurance Number\",\n  abbreviation: \"SIN\",\n  aliases: [\n    \"SIN\",\n    \"Social Insurance Number\",\n    \"NAS\",\n  ] as const,\n  candidatePattern: \"\\\\d{3}-?\\\\d{3}-?\\\\d{3}\",\n  country: \"CA\",\n  entityType: \"person\",\n  sourceUrl:\n    \"https://www.canada.ca/en/employment-social-development/services/sin.html\",\n  examples: [\"123456782\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default sin;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;AAqBA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;AAEH,KAAI,EAAE,WAAW,EACf,QAAO,IAAI,kBAAkB,uBAAuB;AAEtD,KAAI,EAAE,OAAO,OAAO,EAAE,OAAO,IAC3B,QAAO,IACL,qBACA,+BACD;AAEH,KAAI,CAAC,aAAa,EAAE,CAClB,QAAO,IACL,oBACA,gCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;AAExD,QAAO;;;AAIT,MAAM,iBAAyB;CAE7B,MAAM,UADQ,OAAO,UAAU,GAAG,EAAE,CAAC,GACb,aAAa,EAAE;CACvC,MAAM,KAAK,aAAa,UAAU,IAAI;AACtC,QAAO,UAAU,QAAQ,KAAK,MAAM,GAAG;;;AAIzC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WACE;CACF,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"sin.js","names":[],"sources":["../../src/ca/sin.ts"],"sourcesContent":["/**\n * SIN (Canadian Social Insurance Number).\n *\n * 9-digit identifier with Luhn checksum. First\n * digit cannot be 0 or 8.\n *\n * @see https://www.canada.ca/en/employment-social-development/services/sin.html\n * @see https://en.wikipedia.org/wiki/Social_Insurance_Number\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport {\n  luhnValidate,\n  luhnChecksum,\n} from \"#checksums/luhn\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"SIN must contain only digits\",\n    );\n  }\n  if (v.length !== 9) {\n    return err(\"INVALID_LENGTH\", \"SIN must be 9 digits\");\n  }\n  if (v[0] === \"0\" || v[0] === \"8\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"SIN cannot start with 0 or 8\",\n    );\n  }\n  if (!luhnValidate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"SIN Luhn check digit mismatch\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length === 9) {\n    return `${v.slice(0, 3)}-${v.slice(3, 6)}-${v.slice(6)}`;\n  }\n  return v;\n};\n\n/** Generate a random valid Canadian SIN. */\nconst generate = (): string => {\n  const first = String(randomInt(1, 7));\n  const payload = first + randomDigits(7);\n  const cs = luhnChecksum(payload + \"0\");\n  return payload + String((10 - cs) % 10);\n};\n\n/** Canadian Social Insurance Number. */\nconst sin: CountryValidator<\"CA\"> = {\n  name: \"Social Insurance Number\",\n  localName: \"Social Insurance Number\",\n  abbreviation: \"SIN\",\n  aliases: [\n    \"SIN\",\n    \"Social Insurance Number\",\n    \"NAS\",\n  ] as const,\n  candidatePattern: \"\\\\d{3}-?\\\\d{3}-?\\\\d{3}\",\n  scope: \"country\",\n  country: \"CA\",\n  entityType: \"person\",\n  sourceUrl:\n    \"https://www.canada.ca/en/employment-social-development/services/sin.html\",\n  examples: [\"123456782\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default sin;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AAwBA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;AAEnB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,8BACF;CAEF,IAAI,EAAE,WAAW,GACf,OAAO,IAAI,kBAAkB,sBAAsB;CAErD,IAAI,EAAE,OAAO,OAAO,EAAE,OAAO,KAC3B,OAAO,IACL,qBACA,8BACF;CAEF,IAAI,CAAC,aAAa,CAAC,GACjB,OAAO,IACL,oBACA,+BACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,GACf,OAAO,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC;CAEvD,OAAO;AACT;;AAGA,MAAM,iBAAyB;CAE7B,MAAM,UADQ,OAAO,UAAU,GAAG,CAAC,CACf,IAAI,aAAa,CAAC;CACtC,MAAM,KAAK,aAAa,UAAU,GAAG;CACrC,OAAO,UAAU,QAAQ,KAAK,MAAM,EAAE;AACxC;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;CACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WACE;CACF,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;AACF"}

package/dist/ch/ssn.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/ch/ssn.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid Swiss SSN. */
 declare const generate: () => string;
 /** Swiss Social Security Number. */
-declare const ssn: Validator;
+declare const ssn: CountryValidator<"CH">;
 //#endregion
 export { compact, ssn as default, format, generate, validate };
 //# sourceMappingURL=ssn.d.ts.map

package/dist/ch/ssn.js

@@ -3,15 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/ch/ssn.ts
-/**
-* Swiss Social Security Number (AHV/AVS).
-*
-* 13 digits starting with 756. Uses EAN-13 checksum:
-* alternating weights (1, 3) from left, check digit
-* is (10 - sum % 10) % 10.
-*
-* @see https://www.bsv.admin.ch/
-*/
 const compact = (value) => clean(value, " -.");
 const validate = (value) => {
 	const v = compact(value);
@@ -52,6 +43,7 @@ const ssn = {
 		"AHV"
 	],
 	candidatePattern: "756\\.?\\d{4}\\.?\\d{4}\\.?\\d{2}",
+	scope: "country",
 	country: "CH",
 	entityType: "person",
 	sourceUrl: "https://www.bsv.admin.ch/",

package/dist/ch/ssn.js.map

@@ -1 +1 @@
-{"version":3,"file":"ssn.js","names":[],"sources":["../../src/ch/ssn.ts"],"sourcesContent":["/**\n * Swiss Social Security Number (AHV/AVS).\n *\n * 13 digits starting with 756. Uses EAN-13 checksum:\n * alternating weights (1, 3) from left, check digit\n * is (10 - sum % 10) % 10.\n *\n * @see https://www.bsv.admin.ch/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -.\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Swiss SSN must be 13 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Swiss SSN must contain only digits\",\n    );\n  }\n  if (!v.startsWith(\"756\")) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Swiss SSN must start with 756\",\n    );\n  }\n\n  let sum = 0;\n  for (let i = 0; i < 12; i++) {\n    const weight = i % 2 === 0 ? 1 : 3;\n    sum += Number(v[i]) * weight;\n  }\n  const check = (10 - (sum % 10)) % 10;\n  if (check !== Number(v[12])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Swiss SSN check digit mismatch\",\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, 3)}.${v.slice(3, 7)}.${v.slice(7, 11)}.${v.slice(11)}`;\n};\n\n/** Generate a random valid Swiss SSN. */\nconst generate = (): string => {\n  const payload = \"756\" + randomDigits(9);\n  let sum = 0;\n  for (let i = 0; i < 12; i++)\n    sum += Number(payload[i]) * (i % 2 === 0 ? 1 : 3);\n  return payload + String((10 - (sum % 10)) % 10);\n};\n\n/** Swiss Social Security Number. */\nconst ssn: Validator = {\n  name: \"Swiss Social Security Number\",\n  localName: \"AHV-Versichertennummer\",\n  abbreviation: \"AHV\",\n  aliases: [\n    \"AHV-Nummer\",\n    \"numéro AVS\",\n    \"AVS\",\n    \"AHV\",\n  ] as const,\n  candidatePattern: \"756\\\\.?\\\\d{4}\\\\.?\\\\d{4}\\\\.?\\\\d{2}\",\n  country: \"CH\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.bsv.admin.ch/\",\n  examples: [\"7561234567897\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ssn;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;AAiBA,MAAM,WAAW,UACf,MAAM,OAAO,MAAM;AAErB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,8BACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,qCACD;AAEH,KAAI,CAAC,EAAE,WAAW,MAAM,CACtB,QAAO,IACL,qBACA,gCACD;CAGH,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;EAC3B,MAAM,SAAS,IAAI,MAAM,IAAI,IAAI;AACjC,SAAO,OAAO,EAAE,GAAG,GAAG;;AAGxB,MADe,KAAM,MAAM,MAAO,OACpB,OAAO,EAAE,IAAI,CACzB,QAAO,IACL,oBACA,iCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG;;;AAI3E,MAAM,iBAAyB;CAC7B,MAAM,UAAU,QAAQ,aAAa,EAAE;CACvC,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,IACtB,QAAO,OAAO,QAAQ,GAAG,IAAI,IAAI,MAAM,IAAI,IAAI;AACjD,QAAO,UAAU,QAAQ,KAAM,MAAM,MAAO,GAAG;;;AAIjD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,gBAAgB;CAC3B;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"ssn.js","names":[],"sources":["../../src/ch/ssn.ts"],"sourcesContent":["/**\n * Swiss Social Security Number (AHV/AVS).\n *\n * 13 digits starting with 756. Uses EAN-13 checksum:\n * alternating weights (1, 3) from left, check digit\n * is (10 - sum % 10) % 10.\n *\n * @see https://www.bsv.admin.ch/\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -.\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Swiss SSN must be 13 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Swiss SSN must contain only digits\",\n    );\n  }\n  if (!v.startsWith(\"756\")) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Swiss SSN must start with 756\",\n    );\n  }\n\n  let sum = 0;\n  for (let i = 0; i < 12; i++) {\n    const weight = i % 2 === 0 ? 1 : 3;\n    sum += Number(v[i]) * weight;\n  }\n  const check = (10 - (sum % 10)) % 10;\n  if (check !== Number(v[12])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Swiss SSN check digit mismatch\",\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, 3)}.${v.slice(3, 7)}.${v.slice(7, 11)}.${v.slice(11)}`;\n};\n\n/** Generate a random valid Swiss SSN. */\nconst generate = (): string => {\n  const payload = \"756\" + randomDigits(9);\n  let sum = 0;\n  for (let i = 0; i < 12; i++)\n    sum += Number(payload[i]) * (i % 2 === 0 ? 1 : 3);\n  return payload + String((10 - (sum % 10)) % 10);\n};\n\n/** Swiss Social Security Number. */\nconst ssn: CountryValidator<\"CH\"> = {\n  name: \"Swiss Social Security Number\",\n  localName: \"AHV-Versichertennummer\",\n  abbreviation: \"AHV\",\n  aliases: [\n    \"AHV-Nummer\",\n    \"numéro AVS\",\n    \"AVS\",\n    \"AHV\",\n  ] as const,\n  candidatePattern: \"756\\\\.?\\\\d{4}\\\\.?\\\\d{4}\\\\.?\\\\d{2}\",\n  scope: \"country\",\n  country: \"CH\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.bsv.admin.ch/\",\n  examples: [\"7561234567897\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ssn;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AAoBA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,6BACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,oCACF;CAEF,IAAI,CAAC,EAAE,WAAW,KAAK,GACrB,OAAO,IACL,qBACA,+BACF;CAGF,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;EAC3B,MAAM,SAAS,IAAI,MAAM,IAAI,IAAI;EACjC,OAAO,OAAO,EAAE,EAAE,IAAI;CACxB;CAEA,KADe,KAAM,MAAM,MAAO,OACpB,OAAO,EAAE,GAAG,GACxB,OAAO,IACL,oBACA,gCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,OAAO,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;AAC1E;;AAGA,MAAM,iBAAyB;CAC7B,MAAM,UAAU,QAAQ,aAAa,CAAC;CACtC,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KACtB,OAAO,OAAO,QAAQ,EAAE,KAAK,IAAI,MAAM,IAAI,IAAI;CACjD,OAAO,UAAU,QAAQ,KAAM,MAAM,MAAO,EAAE;AAChD;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACA;CACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,eAAe;CAC1B;CACA;CACA;CACA;AACF"}

package/dist/ch/uid.d.ts

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

package/dist/ch/uid.js

@@ -3,15 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/ch/uid.ts
-/**
-* UID (Unternehmens-Identifikationsnummer).
-*
-* Swiss business identification number. 12 characters:
-* "CHE" prefix + 9 digits. Check digit uses weights
-* [5,4,3,2,7,6,5,4] on the first 8 digits.
-*
-* @see https://www.uid.admin.ch/
-*/
 const WEIGHTS = [
 	5,
 	4,
@@ -66,6 +57,7 @@ const uid = {
 		"IDE"
 	],
 	candidatePattern: "CHE-?\\d{3}\\.?\\d{3}\\.?\\d{3}",
+	scope: "country",
 	country: "CH",
 	entityType: "company",
 	sourceUrl: "https://www.uid.admin.ch/",

package/dist/ch/uid.js.map

@@ -1 +1 @@
-{"version":3,"file":"uid.js","names":[],"sources":["../../src/ch/uid.ts"],"sourcesContent":["/**\n * UID (Unternehmens-Identifikationsnummer).\n *\n * Swiss business identification number. 12 characters:\n * \"CHE\" prefix + 9 digits. Check digit uses weights\n * [5,4,3,2,7,6,5,4] on the first 8 digits.\n *\n * @see https://www.uid.admin.ch/\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 = [5, 4, 3, 2, 7, 6, 5, 4] as const;\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 !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Swiss UID must be CHE + 9 digits\",\n    );\n  }\n  if (!v.startsWith(\"CHE\")) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Swiss UID must start with CHE\",\n    );\n  }\n  const digits = v.slice(3);\n  if (!isdigits(digits)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Swiss UID must be CHE + 9 digits\",\n    );\n  }\n\n  let sum = 0;\n  for (let i = 0; i < 8; i++) {\n    sum += Number(digits.charAt(i)) * (WEIGHTS[i] ?? 0);\n  }\n  const check = (11 - (sum % 11)) % 11;\n  if (check === 10) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Swiss UID check digit is invalid\",\n    );\n  }\n  if (check !== Number(digits[8])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Swiss UID check digit mismatch\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  const d = v.slice(3);\n  return `CHE-${d.slice(0, 3)}.${d.slice(3, 6)}.${d.slice(6)}`;\n};\n\n/** Generate a random valid Swiss UID. */\nconst generate = (): string => {\n  for (let i = 0; i < 100; i++) {\n    const payload = randomDigits(8);\n    let sum = 0;\n    for (let j = 0; j < 8; j++)\n      sum += Number(payload.charAt(j)) * (WEIGHTS[j] ?? 0);\n    const check = (11 - (sum % 11)) % 11;\n    if (check === 10) continue;\n    return \"CHE\" + payload + String(check);\n  }\n  throw new Error(\"Failed to generate valid Swiss UID\");\n};\n\n/** Swiss Business Identification Number. */\nconst uid: Validator = {\n  name: \"Swiss Business ID\",\n  localName: \"Unternehmens-Identifikationsnummer\",\n  abbreviation: \"UID\",\n  aliases: [\n    \"Unternehmens-Identifikationsnummer\",\n    \"UID\",\n    \"IDE\",\n  ] as const,\n  candidatePattern: \"CHE-?\\\\d{3}\\\\.?\\\\d{3}\\\\.?\\\\d{3}\",\n  country: \"CH\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.uid.admin.ch/\",\n  examples: [\"CHE100155212\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default uid;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;AAiBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AAExC,MAAM,WAAW,UACf,MAAM,OAAO,OAAO,CAAC,aAAa;AAEpC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,mCACD;AAEH,KAAI,CAAC,EAAE,WAAW,MAAM,CACtB,QAAO,IACL,qBACA,gCACD;CAEH,MAAM,SAAS,EAAE,MAAM,EAAE;AACzB,KAAI,CAAC,SAAS,OAAO,CACnB,QAAO,IACL,kBACA,mCACD;CAGH,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,QAAO,OAAO,OAAO,OAAO,EAAE,CAAC,IAAI,QAAQ,MAAM;CAEnD,MAAM,SAAS,KAAM,MAAM,MAAO;AAClC,KAAI,UAAU,GACZ,QAAO,IACL,oBACA,mCACD;AAEH,KAAI,UAAU,OAAO,OAAO,GAAG,CAC7B,QAAO,IACL,oBACA,iCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CAExC,MAAM,IADI,QAAQ,MAAM,CACZ,MAAM,EAAE;AACpB,QAAO,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;;;AAI5D,MAAM,iBAAyB;AAC7B,MAAK,IAAI,IAAI,GAAG,IAAI,KAAK,KAAK;EAC5B,MAAM,UAAU,aAAa,EAAE;EAC/B,IAAI,MAAM;AACV,OAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,QAAO,OAAO,QAAQ,OAAO,EAAE,CAAC,IAAI,QAAQ,MAAM;EACpD,MAAM,SAAS,KAAM,MAAM,MAAO;AAClC,MAAI,UAAU,GAAI;AAClB,SAAO,QAAQ,UAAU,OAAO,MAAM;;AAExC,OAAM,IAAI,MAAM,qCAAqC;;;AAIvD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,eAAe;CAC1B;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"uid.js","names":[],"sources":["../../src/ch/uid.ts"],"sourcesContent":["/**\n * UID (Unternehmens-Identifikationsnummer).\n *\n * Swiss business identification number. 12 characters:\n * \"CHE\" prefix + 9 digits. Check digit uses weights\n * [5,4,3,2,7,6,5,4] on the first 8 digits.\n *\n * @see https://www.uid.admin.ch/\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 = [5, 4, 3, 2, 7, 6, 5, 4] as const;\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 !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Swiss UID must be CHE + 9 digits\",\n    );\n  }\n  if (!v.startsWith(\"CHE\")) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Swiss UID must start with CHE\",\n    );\n  }\n  const digits = v.slice(3);\n  if (!isdigits(digits)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Swiss UID must be CHE + 9 digits\",\n    );\n  }\n\n  let sum = 0;\n  for (let i = 0; i < 8; i++) {\n    sum += Number(digits.charAt(i)) * (WEIGHTS[i] ?? 0);\n  }\n  const check = (11 - (sum % 11)) % 11;\n  if (check === 10) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Swiss UID check digit is invalid\",\n    );\n  }\n  if (check !== Number(digits[8])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Swiss UID check digit mismatch\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  const d = v.slice(3);\n  return `CHE-${d.slice(0, 3)}.${d.slice(3, 6)}.${d.slice(6)}`;\n};\n\n/** Generate a random valid Swiss UID. */\nconst generate = (): string => {\n  for (let i = 0; i < 100; i++) {\n    const payload = randomDigits(8);\n    let sum = 0;\n    for (let j = 0; j < 8; j++)\n      sum += Number(payload.charAt(j)) * (WEIGHTS[j] ?? 0);\n    const check = (11 - (sum % 11)) % 11;\n    if (check === 10) continue;\n    return \"CHE\" + payload + String(check);\n  }\n  throw new Error(\"Failed to generate valid Swiss UID\");\n};\n\n/** Swiss Business Identification Number. */\nconst uid: CountryValidator<\"CH\"> = {\n  name: \"Swiss Business ID\",\n  localName: \"Unternehmens-Identifikationsnummer\",\n  abbreviation: \"UID\",\n  aliases: [\n    \"Unternehmens-Identifikationsnummer\",\n    \"UID\",\n    \"IDE\",\n  ] as const,\n  candidatePattern: \"CHE-?\\\\d{3}\\\\.?\\\\d{3}\\\\.?\\\\d{3}\",\n  scope: \"country\",\n  country: \"CH\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.uid.admin.ch/\",\n  examples: [\"CHE100155212\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default uid;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AAoBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;AAEvC,MAAM,WAAW,UACf,MAAM,OAAO,MAAM,EAAE,YAAY;AAEnC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,kCACF;CAEF,IAAI,CAAC,EAAE,WAAW,KAAK,GACrB,OAAO,IACL,qBACA,+BACF;CAEF,MAAM,SAAS,EAAE,MAAM,CAAC;CACxB,IAAI,CAAC,SAAS,MAAM,GAClB,OAAO,IACL,kBACA,kCACF;CAGF,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KACrB,OAAO,OAAO,OAAO,OAAO,CAAC,CAAC,KAAK,QAAQ,MAAM;CAEnD,MAAM,SAAS,KAAM,MAAM,MAAO;CAClC,IAAI,UAAU,IACZ,OAAO,IACL,oBACA,kCACF;CAEF,IAAI,UAAU,OAAO,OAAO,EAAE,GAC5B,OAAO,IACL,oBACA,gCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CAExC,MAAM,IADI,QAAQ,KACR,EAAE,MAAM,CAAC;CACnB,OAAO,OAAO,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC;AAC3D;;AAGA,MAAM,iBAAyB;CAC7B,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,KAAK;EAC5B,MAAM,UAAU,aAAa,CAAC;EAC9B,IAAI,MAAM;EACV,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KACrB,OAAO,OAAO,QAAQ,OAAO,CAAC,CAAC,KAAK,QAAQ,MAAM;EACpD,MAAM,SAAS,KAAM,MAAM,MAAO;EAClC,IAAI,UAAU,IAAI;EAClB,OAAO,QAAQ,UAAU,OAAO,KAAK;CACvC;CACA,MAAM,IAAI,MAAM,oCAAoC;AACtD;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;CACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,cAAc;CACzB;CACA;CACA;CACA;AACF"}

package/dist/ch/vat.d.ts

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

package/dist/ch/vat.js

@@ -2,15 +2,6 @@ import { clean } from "../_util/clean.js";
 import { err } from "../_util/result.js";
 import { generate as generate$1, validate as validate$1 } from "./uid.js";
 //#region src/ch/vat.ts
-/**
-* Swiss VAT number.
-*
-* Format: CHE + 9 digits + suffix (MWST|TVA|IVA|TPV).
-* The numeric part is validated as a UID.
-*
-* @see https://www.ch.ch/en/value-added-tax-number-und-business-identification-number/
-* @see https://www.estv.admin.ch/
-*/
 const SUFFIXES = [
 	"MWST",
 	"TVA",
@@ -55,6 +46,7 @@ const vat = {
 		"IVA"
 	],
 	candidatePattern: "CHE-?\\d{3}\\.?\\d{3}\\.?\\d{3}\\s?(?:MWST|TVA|IVA)",
+	scope: "country",
 	country: "CH",
 	entityType: "company",
 	sourceUrl: "https://www.estv.admin.ch/",

package/dist/ch/vat.js.map

@@ -1 +1 @@
-{"version":3,"file":"vat.js","names":["validateUid","generateUid"],"sources":["../../src/ch/vat.ts"],"sourcesContent":["/**\n * Swiss VAT number.\n *\n * Format: CHE + 9 digits + suffix (MWST|TVA|IVA|TPV).\n * The numeric part is validated as a UID.\n *\n * @see https://www.ch.ch/en/value-added-tax-number-und-business-identification-number/\n * @see https://www.estv.admin.ch/\n */\n\nimport { clean } from \"#util/clean\";\nimport { err } from \"#util/result\";\n\nimport type { ValidateResult, Validator } from \"../types\";\nimport {\n  validate as validateUid,\n  generate as generateUid,\n} from \"./uid\";\n\nconst SUFFIXES = [\"MWST\", \"TVA\", \"IVA\", \"TPV\"] as const;\n\nconst compact = (value: string): string =>\n  clean(value, \" -./\").toUpperCase();\n\nconst extractParts = (\n  v: string,\n): { uid: string; suffix: string } | undefined => {\n  for (const s of SUFFIXES) {\n    if (v.endsWith(s)) {\n      return { uid: v.slice(0, -s.length), suffix: s };\n    }\n  }\n  return undefined;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  const parts = extractParts(v);\n  if (!parts) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Swiss VAT must end with MWST, TVA, IVA, or TPV\",\n    );\n  }\n\n  const uidResult = validateUid(parts.uid);\n  if (!uidResult.valid) {\n    return uidResult;\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  const parts = extractParts(v);\n  if (!parts) return v;\n  const d = parts.uid.slice(3);\n  return `CHE-${d.slice(0, 3)}.${d.slice(3, 6)}.${d.slice(6)} ${parts.suffix}`;\n};\n\n/** Generate a random valid Swiss VAT number. */\nconst generate = (): string => generateUid() + \"MWST\";\n\n/** Swiss VAT Number. */\nconst vat: Validator = {\n  name: \"Swiss VAT Number\",\n  localName: \"Mehrwertsteuernummer\",\n  abbreviation: \"MWST\",\n  aliases: [\"MWST\", \"TVA\", \"IVA\"] as const,\n  candidatePattern:\n    \"CHE-?\\\\d{3}\\\\.?\\\\d{3}\\\\.?\\\\d{3}\\\\s?(?:MWST|TVA|IVA)\",\n  country: \"CH\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.estv.admin.ch/\",\n  examples: [\"CHE107787577IVA\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vat;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;AAmBA,MAAM,WAAW;CAAC;CAAQ;CAAO;CAAO;CAAM;AAE9C,MAAM,WAAW,UACf,MAAM,OAAO,OAAO,CAAC,aAAa;AAEpC,MAAM,gBACJ,MACgD;AAChD,MAAK,MAAM,KAAK,SACd,KAAI,EAAE,SAAS,EAAE,CACf,QAAO;EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,OAAO;EAAE,QAAQ;EAAG;;AAMtD,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;CAExB,MAAM,QAAQ,aAAa,EAAE;AAC7B,KAAI,CAAC,MACH,QAAO,IACL,kBACA,iDACD;CAGH,MAAM,YAAYA,WAAY,MAAM,IAAI;AACxC,KAAI,CAAC,UAAU,MACb,QAAO;AAGT,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;CACxB,MAAM,QAAQ,aAAa,EAAE;AAC7B,KAAI,CAAC,MAAO,QAAO;CACnB,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE;AAC5B,QAAO,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM;;;AAItE,MAAM,iBAAyBC,YAAa,GAAG;;AAG/C,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EAAC;EAAQ;EAAO;EAAM;CAC/B,kBACE;CACF,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,kBAAkB;CAC7B;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"vat.js","names":["validateUid","generateUid"],"sources":["../../src/ch/vat.ts"],"sourcesContent":["/**\n * Swiss VAT number.\n *\n * Format: CHE + 9 digits + suffix (MWST|TVA|IVA|TPV).\n * The numeric part is validated as a UID.\n *\n * @see https://www.ch.ch/en/value-added-tax-number-und-business-identification-number/\n * @see https://www.estv.admin.ch/\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\nimport {\n  validate as validateUid,\n  generate as generateUid,\n} from \"./uid\";\n\nimport { clean } from \"#util/clean\";\nimport { err } from \"#util/result\";\n\nconst SUFFIXES = [\"MWST\", \"TVA\", \"IVA\", \"TPV\"] as const;\n\nconst compact = (value: string): string =>\n  clean(value, \" -./\").toUpperCase();\n\nconst extractParts = (\n  v: string,\n): { uid: string; suffix: string } | undefined => {\n  for (const s of SUFFIXES) {\n    if (v.endsWith(s)) {\n      return { uid: v.slice(0, -s.length), suffix: s };\n    }\n  }\n  return undefined;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  const parts = extractParts(v);\n  if (!parts) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Swiss VAT must end with MWST, TVA, IVA, or TPV\",\n    );\n  }\n\n  const uidResult = validateUid(parts.uid);\n  if (!uidResult.valid) {\n    return uidResult;\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  const parts = extractParts(v);\n  if (!parts) return v;\n  const d = parts.uid.slice(3);\n  return `CHE-${d.slice(0, 3)}.${d.slice(3, 6)}.${d.slice(6)} ${parts.suffix}`;\n};\n\n/** Generate a random valid Swiss VAT number. */\nconst generate = (): string => generateUid() + \"MWST\";\n\n/** Swiss VAT Number. */\nconst vat: CountryValidator<\"CH\"> = {\n  name: \"Swiss VAT Number\",\n  localName: \"Mehrwertsteuernummer\",\n  abbreviation: \"MWST\",\n  aliases: [\"MWST\", \"TVA\", \"IVA\"] as const,\n  candidatePattern:\n    \"CHE-?\\\\d{3}\\\\.?\\\\d{3}\\\\.?\\\\d{3}\\\\s?(?:MWST|TVA|IVA)\",\n  scope: \"country\",\n  country: \"CH\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.estv.admin.ch/\",\n  examples: [\"CHE107787577IVA\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vat;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;AAsBA,MAAM,WAAW;CAAC;CAAQ;CAAO;CAAO;AAAK;AAE7C,MAAM,WAAW,UACf,MAAM,OAAO,MAAM,EAAE,YAAY;AAEnC,MAAM,gBACJ,MACgD;CAChD,KAAK,MAAM,KAAK,UACd,IAAI,EAAE,SAAS,CAAC,GACd,OAAO;EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,MAAM;EAAG,QAAQ;CAAE;AAIrD;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CAEvB,MAAM,QAAQ,aAAa,CAAC;CAC5B,IAAI,CAAC,OACH,OAAO,IACL,kBACA,gDACF;CAGF,MAAM,YAAYA,WAAY,MAAM,GAAG;CACvC,IAAI,CAAC,UAAU,OACb,OAAO;CAGT,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,MAAM,QAAQ,aAAa,CAAC;CAC5B,IAAI,CAAC,OAAO,OAAO;CACnB,MAAM,IAAI,MAAM,IAAI,MAAM,CAAC;CAC3B,OAAO,OAAO,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,MAAM;AACtE;;AAGA,MAAM,iBAAyBC,WAAY,IAAI;;AAG/C,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EAAC;EAAQ;EAAO;CAAK;CAC9B,kBACE;CACF,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,iBAAiB;CAC5B;CACA;CACA;CACA;AACF"}

package/dist/cl/rut.d.ts

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

package/dist/cl/rut.js

@@ -2,20 +2,6 @@ import { clean } from "../_util/clean.js";
 import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 //#region src/cl/rut.ts
-/**
-* RUT (Rol Único Tributario).
-*
-* Chilean tax identification number assigned by the SII
-* (Servicio de Impuestos Internos). The number consists
-* of 7 or 8 digits followed by a check digit (0-9 or K),
-* computed using a modulo 11 algorithm with weights
-* [2, 3, 4, 5, 6, 7] cycling right-to-left.
-*
-* Format: XX.XXX.XXX-C (7-8 digits + check digit).
-*
-* @see https://www.sii.cl/
-* @see https://en.wikipedia.org/wiki/Rol_%C3%9Anico_Tributario
-*/
 const RUT_RE = /^\d{7,8}[\dK]$/;
 const compact = (value) => {
 	let v = clean(value, " -.").trim().toUpperCase();
@@ -79,6 +65,7 @@ const rut = {
 	abbreviation: "RUT",
 	aliases: ["RUT", "Rol Único Tributario"],
 	candidatePattern: "\\d{1,2}\\.?\\d{3}\\.?\\d{3}-?[\\dkK]",
+	scope: "country",
 	country: "CL",
 	entityType: "any",
 	compact,

package/dist/cl/rut.js.map

@@ -1 +1 @@
-{"version":3,"file":"rut.js","names":[],"sources":["../../src/cl/rut.ts"],"sourcesContent":["/**\n * RUT (Rol Único Tributario).\n *\n * Chilean tax identification number assigned by the SII\n * (Servicio de Impuestos Internos). The number consists\n * of 7 or 8 digits followed by a check digit (0-9 or K),\n * computed using a modulo 11 algorithm with weights\n * [2, 3, 4, 5, 6, 7] cycling right-to-left.\n *\n * Format: XX.XXX.XXX-C (7-8 digits + check digit).\n *\n * @see https://www.sii.cl/\n * @see https://en.wikipedia.org/wiki/Rol_%C3%9Anico_Tributario\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 RUT_RE = /^\\d{7,8}[\\dK]$/;\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -.\").trim().toUpperCase();\n  if (v.startsWith(\"CL\")) v = v.slice(2);\n  return v;\n};\n\n/**\n * Compute the RUT check digit using mod 11 with\n * weights [2, 3, 4, 5, 6, 7] cycling right-to-left.\n *\n * remainder = 11 - (weighted sum % 11)\n * 11 -> \"0\", 10 -> \"K\", else the digit as string.\n */\nconst calcCheckDigit = (body: string): string => {\n  const weights = [2, 3, 4, 5, 6, 7] as const;\n  let sum = 0;\n  for (let i = body.length - 1, w = 0; i >= 0; i--, w++) {\n    // SAFETY: w % weights.length is a valid index.\n    // eslint-disable-next-line no-non-null-assertion\n    sum += Number(body[i]) * weights[w % weights.length]!;\n  }\n  const remainder = 11 - (sum % 11);\n  if (remainder === 11) return \"0\";\n  if (remainder === 10) return \"K\";\n  return String(remainder);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 8 && v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"RUT must be 8 or 9 characters\",\n    );\n  }\n\n  if (!RUT_RE.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RUT must contain only digits and optionally K\",\n    );\n  }\n\n  const body = v.slice(0, -1);\n  const expected = calcCheckDigit(body);\n  if (v.at(-1) !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RUT check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  const check = v.at(-1);\n  const body = v.slice(0, -1);\n  return (\n    `${body.slice(0, -6)}.${body.slice(-6, -3)}` +\n    `.${body.slice(-3)}-${check}`\n  );\n};\n\n/** Generate a random valid Chilean RUT. */\nconst generate = (): string => {\n  const body = randomDigits(8);\n  return body + calcCheckDigit(body);\n};\n\n/**\n * Chilean RUT (tax identification number).\n *\n * Examples sourced from python-stdnum test suite\n * (cl.rut module).\n */\nconst rut: Validator = {\n  name: \"Chilean Tax ID\",\n  localName: \"Rol Único Tributario\",\n  abbreviation: \"RUT\",\n  aliases: [\"RUT\", \"Rol Único Tributario\"] as const,\n  candidatePattern: \"\\\\d{1,2}\\\\.?\\\\d{3}\\\\.?\\\\d{3}-?[\\\\dkK]\",\n  country: \"CL\",\n  entityType: \"any\",\n  compact,\n  format,\n  validate,\n  sourceUrl: \"https://www.sii.cl/\",\n  lengths: [8, 9] as const,\n  examples: [\"760864285\", \"125319092\"] as const,\n  generate,\n};\n\nexport default rut;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;AAqBA,MAAM,SAAS;AAEf,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa;AAChD,KAAI,EAAE,WAAW,KAAK,CAAE,KAAI,EAAE,MAAM,EAAE;AACtC,QAAO;;;;;;;;;AAUT,MAAM,kBAAkB,SAAyB;CAC/C,MAAM,UAAU;EAAC;EAAG;EAAG;EAAG;EAAG;EAAG;EAAE;CAClC,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,KAAK,SAAS,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,IAGhD,QAAO,OAAO,KAAK,GAAG,GAAG,QAAQ,IAAI,QAAQ;CAE/C,MAAM,YAAY,KAAM,MAAM;AAC9B,KAAI,cAAc,GAAI,QAAO;AAC7B,KAAI,cAAc,GAAI,QAAO;AAC7B,QAAO,OAAO,UAAU;;AAG1B,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,KAAK,EAAE,WAAW,EACjC,QAAO,IACL,kBACA,gCACD;AAGH,KAAI,CAAC,OAAO,KAAK,EAAE,CACjB,QAAO,IACL,kBACA,gDACD;CAIH,MAAM,WAAW,eADJ,EAAE,MAAM,GAAG,GAAG,CACU;AACrC,KAAI,EAAE,GAAG,GAAG,KAAK,SACf,QAAO,IACL,oBACA,iCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;CACxB,MAAM,QAAQ,EAAE,GAAG,GAAG;CACtB,MAAM,OAAO,EAAE,MAAM,GAAG,GAAG;AAC3B,QACE,GAAG,KAAK,MAAM,GAAG,GAAG,CAAC,GAAG,KAAK,MAAM,IAAI,GAAG,CAAA,GACtC,KAAK,MAAM,GAAG,CAAC,GAAG;;;AAK1B,MAAM,iBAAyB;CAC7B,MAAM,OAAO,aAAa,EAAE;AAC5B,QAAO,OAAO,eAAe,KAAK;;;;;;;;AASpC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,uBAAuB;CACxC,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ;CACA;CACA;CACA,WAAW;CACX,SAAS,CAAC,GAAG,EAAE;CACf,UAAU,CAAC,aAAa,YAAY;CACpC;CACD"}
+{"version":3,"file":"rut.js","names":[],"sources":["../../src/cl/rut.ts"],"sourcesContent":["/**\n * RUT (Rol Único Tributario).\n *\n * Chilean tax identification number assigned by the SII\n * (Servicio de Impuestos Internos). The number consists\n * of 7 or 8 digits followed by a check digit (0-9 or K),\n * computed using a modulo 11 algorithm with weights\n * [2, 3, 4, 5, 6, 7] cycling right-to-left.\n *\n * Format: XX.XXX.XXX-C (7-8 digits + check digit).\n *\n * @see https://www.sii.cl/\n * @see https://en.wikipedia.org/wiki/Rol_%C3%9Anico_Tributario\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 RUT_RE = /^\\d{7,8}[\\dK]$/;\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -.\").trim().toUpperCase();\n  if (v.startsWith(\"CL\")) v = v.slice(2);\n  return v;\n};\n\n/**\n * Compute the RUT check digit using mod 11 with\n * weights [2, 3, 4, 5, 6, 7] cycling right-to-left.\n *\n * remainder = 11 - (weighted sum % 11)\n * 11 -> \"0\", 10 -> \"K\", else the digit as string.\n */\nconst calcCheckDigit = (body: string): string => {\n  const weights = [2, 3, 4, 5, 6, 7] as const;\n  let sum = 0;\n  for (let i = body.length - 1, w = 0; i >= 0; i--, w++) {\n    // SAFETY: w % weights.length is a valid index.\n    // eslint-disable-next-line no-non-null-assertion\n    sum += Number(body[i]) * weights[w % weights.length]!;\n  }\n  const remainder = 11 - (sum % 11);\n  if (remainder === 11) return \"0\";\n  if (remainder === 10) return \"K\";\n  return String(remainder);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 8 && v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"RUT must be 8 or 9 characters\",\n    );\n  }\n\n  if (!RUT_RE.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RUT must contain only digits and optionally K\",\n    );\n  }\n\n  const body = v.slice(0, -1);\n  const expected = calcCheckDigit(body);\n  if (v.at(-1) !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RUT check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  const check = v.at(-1);\n  const body = v.slice(0, -1);\n  return (\n    `${body.slice(0, -6)}.${body.slice(-6, -3)}` +\n    `.${body.slice(-3)}-${check}`\n  );\n};\n\n/** Generate a random valid Chilean RUT. */\nconst generate = (): string => {\n  const body = randomDigits(8);\n  return body + calcCheckDigit(body);\n};\n\n/**\n * Chilean RUT (tax identification number).\n *\n * Examples sourced from python-stdnum test suite\n * (cl.rut module).\n */\nconst rut: CountryValidator<\"CL\"> = {\n  name: \"Chilean Tax ID\",\n  localName: \"Rol Único Tributario\",\n  abbreviation: \"RUT\",\n  aliases: [\"RUT\", \"Rol Único Tributario\"] as const,\n  candidatePattern: \"\\\\d{1,2}\\\\.?\\\\d{3}\\\\.?\\\\d{3}-?[\\\\dkK]\",\n  scope: \"country\",\n  country: \"CL\",\n  entityType: \"any\",\n  compact,\n  format,\n  validate,\n  sourceUrl: \"https://www.sii.cl/\",\n  lengths: [8, 9] as const,\n  examples: [\"760864285\", \"125319092\"] as const,\n  generate,\n};\n\nexport default rut;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;AAwBA,MAAM,SAAS;AAEf,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY;CAC/C,IAAI,EAAE,WAAW,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC;CACrC,OAAO;AACT;;;;;;;;AASA,MAAM,kBAAkB,SAAyB;CAC/C,MAAM,UAAU;EAAC;EAAG;EAAG;EAAG;EAAG;EAAG;CAAC;CACjC,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,KAAK,SAAS,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,KAGhD,OAAO,OAAO,KAAK,EAAE,IAAI,QAAQ,IAAI,QAAQ;CAE/C,MAAM,YAAY,KAAM,MAAM;CAC9B,IAAI,cAAc,IAAI,OAAO;CAC7B,IAAI,cAAc,IAAI,OAAO;CAC7B,OAAO,OAAO,SAAS;AACzB;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CAEvB,IAAI,EAAE,WAAW,KAAK,EAAE,WAAW,GACjC,OAAO,IACL,kBACA,+BACF;CAGF,IAAI,CAAC,OAAO,KAAK,CAAC,GAChB,OAAO,IACL,kBACA,+CACF;CAIF,MAAM,WAAW,eADJ,EAAE,MAAM,GAAG,EACW,CAAC;CACpC,IAAI,EAAE,GAAG,EAAE,MAAM,UACf,OAAO,IACL,oBACA,gCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,MAAM,QAAQ,EAAE,GAAG,EAAE;CACrB,MAAM,OAAO,EAAE,MAAM,GAAG,EAAE;CAC1B,OACE,GAAG,KAAK,MAAM,GAAG,EAAE,EAAE,GAAG,KAAK,MAAM,IAAI,EAAE,EAAA,GACrC,KAAK,MAAM,EAAE,EAAE,GAAG;AAE1B;;AAGA,MAAM,iBAAyB;CAC7B,MAAM,OAAO,aAAa,CAAC;CAC3B,OAAO,OAAO,eAAe,IAAI;AACnC;;;;;;;AAQA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,sBAAsB;CACvC,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ;CACA;CACA;CACA,WAAW;CACX,SAAS,CAAC,GAAG,CAAC;CACd,UAAU,CAAC,aAAa,WAAW;CACnC;AACF"}

package/dist/cn/ric.d.ts

@@ -1,4 +1,4 @@
-import { ParsedPersonId, ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ParsedPersonId, ValidateResult } from "../types.js";
 
 //#region src/cn/ric.d.ts
 declare const compact: (value: string) => string;
@@ -12,7 +12,7 @@ declare const parse: (value: string) => ParsedPersonId | null;
 /** Generate a random valid 18-digit RIC. */
 declare const generate: () => string;
 /** Chinese Resident Identity Card number. */
-declare const ric: Validator<ParsedPersonId>;
+declare const ric: CountryValidator<"CN", ParsedPersonId>;
 //#endregion
 export { compact, ric as default, format, generate, parse, validate };
 //# sourceMappingURL=ric.d.ts.map

package/dist/cn/ric.js

@@ -1,22 +1,10 @@
+import { mod112checkChar, mod112validate } from "../_checksums/mod112.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 { isValidDate } from "../_util/date.js";
-import { mod112checkChar, mod112validate } from "../_checksums/mod112.js";
 //#region src/cn/ric.ts
-/**
-* RIC (Resident Identity Card number, 居民身份证号码).
-*
-* Chinese national identifier. 18 characters:
-* 6 (area code) + 8 (YYYYMMDD birth) + 3 (sequence,
-* odd = male) + 1 (check, 0-9 or X).
-*
-* Also accepts the legacy 15-digit format (no check
-* digit, 2-digit year).
-*
-* @see https://en.wikipedia.org/wiki/Resident_Identity_Card
-*/
 const compact = (value) => clean(value, " -").toUpperCase();
 const validate = (value) => {
 	const v = compact(value);
@@ -91,6 +79,7 @@ const ric = {
 		"RIC"
 	],
 	candidatePattern: "\\d{17}[\\dX]",
+	scope: "country",
 	country: "CN",
 	entityType: "person",
 	description: "18-character national ID encoding area, birth date, gender, and check digit",