@stll/stdnum 1.0.0 → 2.0.0

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",

package/dist/cn/ric.js.map

@@ -1 +1 @@
-{"version":3,"file":"ric.js","names":[],"sources":["../../src/cn/ric.ts"],"sourcesContent":["/**\n * RIC (Resident Identity Card number, 居民身份证号码).\n *\n * Chinese national identifier. 18 characters:\n * 6 (area code) + 8 (YYYYMMDD birth) + 3 (sequence,\n * odd = male) + 1 (check, 0-9 or X).\n *\n * Also accepts the legacy 15-digit format (no check\n * digit, 2-digit year).\n *\n * @see https://en.wikipedia.org/wiki/Resident_Identity_Card\n */\n\nimport {\n  mod112checkChar,\n  mod112validate,\n} from \"#checksums/mod112\";\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").toUpperCase();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 15 && v.length !== 18) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"RIC must be 15 or 18 characters\",\n    );\n  }\n\n  if (v.length === 15) {\n    if (!isdigits(v)) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"15-digit RIC must contain only digits\",\n      );\n    }\n    // Validate date: digits 6-11 are YYMMDD\n    const year = 1900 + Number(v.slice(6, 8));\n    const month = Number(v.slice(8, 10));\n    const day = Number(v.slice(10, 12));\n    if (!isValidDate(year, month, day)) {\n      return err(\n        \"INVALID_COMPONENT\",\n        \"RIC contains an invalid birth date\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // 18-character format\n  if (!isdigits(v.slice(0, 17))) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RIC must contain only digits (plus check char)\",\n    );\n  }\n  // SAFETY: 18-character branch guarantees v[17] exists.\n  // eslint-disable-next-line no-non-null-assertion\n  const lastChar = v[17]!;\n  if (!isdigits(lastChar) && lastChar !== \"X\") {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RIC check character must be 0-9 or X\",\n    );\n  }\n\n  // Validate date: digits 6-13 are YYYYMMDD\n  const year = Number(v.slice(6, 10));\n  const month = Number(v.slice(10, 12));\n  const day = Number(v.slice(12, 14));\n  if (!isValidDate(year, month, day)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RIC contains an invalid birth date\",\n    );\n  }\n\n  if (!mod112validate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RIC check character does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/**\n * Extract birth date and gender from an RIC number.\n * Returns null if the value is not valid.\n */\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n\n  let year: number;\n  let month: number;\n  let day: number;\n  let seq: number;\n\n  if (v.length === 15) {\n    year = 1900 + Number(v.slice(6, 8));\n    month = Number(v.slice(8, 10));\n    day = Number(v.slice(10, 12));\n    seq = Number(v.slice(12, 15));\n  } else {\n    year = Number(v.slice(6, 10));\n    month = Number(v.slice(10, 12));\n    day = Number(v.slice(12, 14));\n    seq = Number(v.slice(14, 17));\n  }\n\n  const gender = seq % 2 === 1 ? \"male\" : \"female\";\n\n  return {\n    birthDate: new Date(year, month - 1, day),\n    gender,\n  };\n};\n\n/** Generate a random valid 18-digit RIC. */\nconst generate = (): string => {\n  // Use a simple area code prefix\n  const area = String(randomInt(110000, 659999));\n  const year = randomInt(1950, 2005);\n  const month = randomInt(1, 12);\n  const day = randomInt(1, 28);\n  const seqNum = randomInt(1, 999);\n  const seq = String(seqNum).padStart(3, \"0\");\n\n  const yStr = String(year);\n  const mStr = String(month).padStart(2, \"0\");\n  const dStr = String(day).padStart(2, \"0\");\n\n  const payload = `${area}${yStr}${mStr}${dStr}${seq}`;\n  const check = mod112checkChar(payload);\n  return `${payload}${check}`;\n};\n\n/** Chinese Resident Identity Card number. */\nconst ric: Validator<ParsedPersonId> = {\n  name: \"Chinese Resident Identity Card\",\n  localName: \"居民身份证号码\",\n  abbreviation: \"RIC\",\n  aliases: [\"身份证\", \"居民身份证号码\", \"RIC\"] as const,\n  candidatePattern: \"\\\\d{17}[\\\\dX]\",\n  country: \"CN\",\n  entityType: \"person\",\n  description:\n    \"18-character national ID encoding area, birth date, gender, and check digit\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Resident_Identity_Card\",\n  lengths: [15, 18] as const,\n  examples: [\n    \"11010519491231002X\",\n    \"440524188001010014\",\n  ] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default ric;\nexport { compact, format, generate, parse, validate };\n"],"mappings":"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"}
+{"version":3,"file":"ric.js","names":[],"sources":["../../src/cn/ric.ts"],"sourcesContent":["/**\n * RIC (Resident Identity Card number, 居民身份证号码).\n *\n * Chinese national identifier. 18 characters:\n * 6 (area code) + 8 (YYYYMMDD birth) + 3 (sequence,\n * odd = male) + 1 (check, 0-9 or X).\n *\n * Also accepts the legacy 15-digit format (no check\n * digit, 2-digit year).\n *\n * @see https://en.wikipedia.org/wiki/Resident_Identity_Card\n */\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport {\n  mod112checkChar,\n  mod112validate,\n} from \"#checksums/mod112\";\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").toUpperCase();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 15 && v.length !== 18) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"RIC must be 15 or 18 characters\",\n    );\n  }\n\n  if (v.length === 15) {\n    if (!isdigits(v)) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"15-digit RIC must contain only digits\",\n      );\n    }\n    // Validate date: digits 6-11 are YYMMDD\n    const year = 1900 + Number(v.slice(6, 8));\n    const month = Number(v.slice(8, 10));\n    const day = Number(v.slice(10, 12));\n    if (!isValidDate(year, month, day)) {\n      return err(\n        \"INVALID_COMPONENT\",\n        \"RIC contains an invalid birth date\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // 18-character format\n  if (!isdigits(v.slice(0, 17))) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RIC must contain only digits (plus check char)\",\n    );\n  }\n  // SAFETY: 18-character branch guarantees v[17] exists.\n  // eslint-disable-next-line no-non-null-assertion\n  const lastChar = v[17]!;\n  if (!isdigits(lastChar) && lastChar !== \"X\") {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RIC check character must be 0-9 or X\",\n    );\n  }\n\n  // Validate date: digits 6-13 are YYYYMMDD\n  const year = Number(v.slice(6, 10));\n  const month = Number(v.slice(10, 12));\n  const day = Number(v.slice(12, 14));\n  if (!isValidDate(year, month, day)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RIC contains an invalid birth date\",\n    );\n  }\n\n  if (!mod112validate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RIC check character does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/**\n * Extract birth date and gender from an RIC number.\n * Returns null if the value is not valid.\n */\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n\n  let year: number;\n  let month: number;\n  let day: number;\n  let seq: number;\n\n  if (v.length === 15) {\n    year = 1900 + Number(v.slice(6, 8));\n    month = Number(v.slice(8, 10));\n    day = Number(v.slice(10, 12));\n    seq = Number(v.slice(12, 15));\n  } else {\n    year = Number(v.slice(6, 10));\n    month = Number(v.slice(10, 12));\n    day = Number(v.slice(12, 14));\n    seq = Number(v.slice(14, 17));\n  }\n\n  const gender = seq % 2 === 1 ? \"male\" : \"female\";\n\n  return {\n    birthDate: new Date(year, month - 1, day),\n    gender,\n  };\n};\n\n/** Generate a random valid 18-digit RIC. */\nconst generate = (): string => {\n  // Use a simple area code prefix\n  const area = String(randomInt(110000, 659999));\n  const year = randomInt(1950, 2005);\n  const month = randomInt(1, 12);\n  const day = randomInt(1, 28);\n  const seqNum = randomInt(1, 999);\n  const seq = String(seqNum).padStart(3, \"0\");\n\n  const yStr = String(year);\n  const mStr = String(month).padStart(2, \"0\");\n  const dStr = String(day).padStart(2, \"0\");\n\n  const payload = `${area}${yStr}${mStr}${dStr}${seq}`;\n  const check = mod112checkChar(payload);\n  return `${payload}${check}`;\n};\n\n/** Chinese Resident Identity Card number. */\nconst ric: CountryValidator<\"CN\", ParsedPersonId> = {\n  name: \"Chinese Resident Identity Card\",\n  localName: \"居民身份证号码\",\n  abbreviation: \"RIC\",\n  aliases: [\"身份证\", \"居民身份证号码\", \"RIC\"] as const,\n  candidatePattern: \"\\\\d{17}[\\\\dX]\",\n  scope: \"country\",\n  country: \"CN\",\n  entityType: \"person\",\n  description:\n    \"18-character national ID encoding area, birth date, gender, and check digit\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Resident_Identity_Card\",\n  lengths: [15, 18] as const,\n  examples: [\n    \"11010519491231002X\",\n    \"440524188001010014\",\n  ] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default ric;\nexport { compact, format, generate, parse, validate };\n"],"mappings":"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"}

package/dist/cn/uscc.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/cn/uscc.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid USCC. */
 declare const generate: () => string;
 /** Chinese Unified Social Credit Code. */
-declare const uscc: Validator;
+declare const uscc: CountryValidator<"CN">;
 //#endregion
 export { compact, uscc as default, format, generate, validate };
 //# sourceMappingURL=uscc.d.ts.map