@stll/stdnum 0.0.1 → 2.0.0

package/dist/eu/vat.js.map

@@ -1 +1 @@
-{"version":3,"file":"vat.js","names":["atUid","beVat","bgVat","cyVat","czDic","deVat","dkVat","eeVat","grVat","esVat","fiVat","frTva","hrVat","huVat","ieVat","itIva","ltVat","luVat","lvVat","mtVat","nlVat","plNip","ptVat","roVat","seVat","siVat","skDic","gbVat"],"sources":["../../src/eu/vat.ts"],"sourcesContent":["/**\n * EU VAT (European Union VAT Number).\n *\n * Dispatcher that routes to per-country VAT\n * validators. Extracts the 2-letter country prefix\n * and delegates to the matching country module.\n *\n * Special cases:\n *   - EL → Greece (gr.vat)\n *   - XI → Northern Ireland (gb.vat)\n *\n * @see https://ec.europa.eu/taxation_customs/vies/\n */\n\nimport { clean } from \"#util/clean\";\nimport { err } from \"#util/result\";\n\nimport atUid from \"../at/uid\";\nimport beVat from \"../be/vat\";\nimport bgVat from \"../bg/vat\";\nimport cyVat from \"../cy/vat\";\nimport czDic from \"../cz/dic\";\nimport deVat from \"../de/vat\";\nimport dkVat from \"../dk/vat\";\nimport eeVat from \"../ee/vat\";\nimport esVat from \"../es/vat\";\nimport fiVat from \"../fi/vat\";\nimport frTva from \"../fr/tva\";\nimport gbVat from \"../gb/vat\";\nimport grVat from \"../gr/vat\";\nimport hrVat from \"../hr/vat\";\nimport huVat from \"../hu/vat\";\nimport ieVat from \"../ie/vat\";\nimport itIva from \"../it/iva\";\nimport ltVat from \"../lt/vat\";\nimport luVat from \"../lu/vat\";\nimport lvVat from \"../lv/vat\";\nimport mtVat from \"../mt/vat\";\nimport nlVat from \"../nl/vat\";\nimport plNip from \"../pl/nip\";\nimport ptVat from \"../pt/vat\";\nimport roVat from \"../ro/vat\";\nimport seVat from \"../se/vat\";\nimport siVat from \"../si/vat\";\nimport skDic from \"../sk/dic\";\nimport type { Validator, ValidateResult } from \"../types\";\n\ntype CountryValidator = {\n  compact: (value: string) => string;\n  validate: (value: string) => ValidateResult;\n  format: (value: string) => string;\n};\n\n/**\n * Map of EU VAT country prefixes to their\n * country-specific validators.\n */\nconst VALIDATORS: Record<string, CountryValidator> = {\n  AT: atUid,\n  BE: beVat,\n  BG: bgVat,\n  CY: cyVat,\n  CZ: czDic,\n  DE: deVat,\n  DK: dkVat,\n  EE: eeVat,\n  EL: grVat, // Greece uses EL prefix in EU VAT\n  ES: esVat,\n  FI: fiVat,\n  FR: frTva,\n  GR: grVat,\n  HR: hrVat,\n  HU: huVat,\n  IE: ieVat,\n  IT: itIva,\n  LT: ltVat,\n  LU: luVat,\n  LV: lvVat,\n  MT: mtVat,\n  NL: nlVat,\n  PL: plNip,\n  PT: ptVat,\n  RO: roVat,\n  SE: seVat,\n  SI: siVat,\n  SK: skDic,\n  XI: gbVat, // Northern Ireland\n};\n\n/**\n * Extract the 2-letter country prefix and the\n * remaining number from an EU VAT string.\n */\nconst splitPrefix = (\n  value: string,\n): { cc: string; rest: string } | undefined => {\n  const v = clean(value, \" -\").toUpperCase();\n  if (v.length < 3) return undefined;\n  const cc = v.slice(0, 2);\n  if (!/^[A-Z]{2}$/.test(cc)) return undefined;\n  return { cc, rest: v.slice(2) };\n};\n\nconst compact = (value: string): string => {\n  const parts = splitPrefix(value);\n  if (parts === undefined) {\n    return clean(value, \" -\").toUpperCase();\n  }\n  const validator = VALIDATORS[parts.cc];\n  if (validator === undefined) {\n    return clean(value, \" -\").toUpperCase();\n  }\n  return `${parts.cc}${validator.compact(parts.rest)}`;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const parts = splitPrefix(value);\n  if (parts === undefined) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"EU VAT must start with a 2-letter country code\",\n    );\n  }\n  const validator = VALIDATORS[parts.cc];\n  if (validator === undefined) {\n    return err(\n      \"INVALID_COMPONENT\",\n      `Unsupported EU VAT country: ${parts.cc}`,\n    );\n  }\n  const result = validator.validate(parts.rest);\n  if (!result.valid) return result;\n  return {\n    valid: true,\n    compact: `${parts.cc}${result.compact}`,\n  };\n};\n\n/**\n * Format returns the compact EU VAT form:\n * `CC` + country-compacted number. Equivalent to\n * compact() because country format() methods\n * prepend their own prefix (e.g., AT UID format\n * returns \"ATU...\"), which would cause double-\n * prefixing if used here.\n */\nconst format = (value: string): string => {\n  const parts = splitPrefix(value);\n  if (parts === undefined) return value;\n  const validator = VALIDATORS[parts.cc];\n  if (validator === undefined) return value;\n  return `${parts.cc}${validator.compact(parts.rest)}`;\n};\n\n/** European Union VAT Number. */\nconst euVat: Validator = {\n  name: \"EU VAT Number\",\n  localName: \"EU VAT Number\",\n  abbreviation: \"EU VAT\",\n  aliases: [\"EU VAT\", \"VAT identification number\"] as const,\n  candidatePattern: \"[A-Z]{2}\\\\d{8,12}\",\n  entityType: \"company\",\n  sourceUrl: \"https://ec.europa.eu/taxation_customs/vies/\",\n  examples: [\"ATU13585627\", \"DE136695976\"] as const,\n  compact,\n  format,\n  validate,\n};\n\nexport default euVat;\nexport { compact, format, validate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyDA,MAAM,aAA+C;CACnD,IAAIA;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIH;CACJ,IAAII;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACL;;;;;AAMD,MAAM,eACJ,UAC6C;CAC7C,MAAM,IAAI,MAAM,OAAO,KAAK,CAAC,aAAa;AAC1C,KAAI,EAAE,SAAS,EAAG,QAAO,KAAA;CACzB,MAAM,KAAK,EAAE,MAAM,GAAG,EAAE;AACxB,KAAI,CAAC,aAAa,KAAK,GAAG,CAAE,QAAO,KAAA;AACnC,QAAO;EAAE;EAAI,MAAM,EAAE,MAAM,EAAE;EAAE;;AAGjC,MAAM,WAAW,UAA0B;CACzC,MAAM,QAAQ,YAAY,MAAM;AAChC,KAAI,UAAU,KAAA,EACZ,QAAO,MAAM,OAAO,KAAK,CAAC,aAAa;CAEzC,MAAM,YAAY,WAAW,MAAM;AACnC,KAAI,cAAc,KAAA,EAChB,QAAO,MAAM,OAAO,KAAK,CAAC,aAAa;AAEzC,QAAO,GAAG,MAAM,KAAK,UAAU,QAAQ,MAAM,KAAK;;AAGpD,MAAM,YAAY,UAAkC;CAClD,MAAM,QAAQ,YAAY,MAAM;AAChC,KAAI,UAAU,KAAA,EACZ,QAAO,IACL,kBACA,iDACD;CAEH,MAAM,YAAY,WAAW,MAAM;AACnC,KAAI,cAAc,KAAA,EAChB,QAAO,IACL,qBACA,+BAA+B,MAAM,KACtC;CAEH,MAAM,SAAS,UAAU,SAAS,MAAM,KAAK;AAC7C,KAAI,CAAC,OAAO,MAAO,QAAO;AAC1B,QAAO;EACL,OAAO;EACP,SAAS,GAAG,MAAM,KAAK,OAAO;EAC/B;;;;;;;;;;AAWH,MAAM,UAAU,UAA0B;CACxC,MAAM,QAAQ,YAAY,MAAM;AAChC,KAAI,UAAU,KAAA,EAAW,QAAO;CAChC,MAAM,YAAY,WAAW,MAAM;AACnC,KAAI,cAAc,KAAA,EAAW,QAAO;AACpC,QAAO,GAAG,MAAM,KAAK,UAAU,QAAQ,MAAM,KAAK;;;AAIpD,MAAM,QAAmB;CACvB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,UAAU,4BAA4B;CAChD,kBAAkB;CAClB,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,eAAe,cAAc;CACxC;CACA;CACA;CACD"}
+{"version":3,"file":"vat.js","names":["atUid","beVat","bgVat","cyVat","czDic","deVat","dkVat","eeVat","grVat","esVat","fiVat","frTva","hrVat","huVat","ieVat","itIva","ltVat","luVat","lvVat","mtVat","nlVat","plNip","ptVat","roVat","seVat","siVat","skDic","gbVat"],"sources":["../../src/eu/vat.ts"],"sourcesContent":["/**\n * EU VAT (European Union VAT Number).\n *\n * Dispatcher that routes to per-country VAT\n * validators. Extracts the 2-letter country prefix\n * and delegates to the matching country module.\n *\n * Special cases:\n *   - EL → Greece (gr.vat)\n *   - XI → Northern Ireland (gb.vat)\n *\n * @see https://ec.europa.eu/taxation_customs/vies/\n */\n\nimport atUid from \"../at/uid\";\nimport beVat from \"../be/vat\";\nimport bgVat from \"../bg/vat\";\nimport cyVat from \"../cy/vat\";\nimport czDic from \"../cz/dic\";\nimport deVat from \"../de/vat\";\nimport dkVat from \"../dk/vat\";\nimport eeVat from \"../ee/vat\";\nimport esVat from \"../es/vat\";\nimport fiVat from \"../fi/vat\";\nimport frTva from \"../fr/tva\";\nimport gbVat from \"../gb/vat\";\nimport grVat from \"../gr/vat\";\nimport hrVat from \"../hr/vat\";\nimport huVat from \"../hu/vat\";\nimport ieVat from \"../ie/vat\";\nimport itIva from \"../it/iva\";\nimport ltVat from \"../lt/vat\";\nimport luVat from \"../lu/vat\";\nimport lvVat from \"../lv/vat\";\nimport mtVat from \"../mt/vat\";\nimport nlVat from \"../nl/vat\";\nimport plNip from \"../pl/nip\";\nimport ptVat from \"../pt/vat\";\nimport roVat from \"../ro/vat\";\nimport seVat from \"../se/vat\";\nimport siVat from \"../si/vat\";\nimport skDic from \"../sk/dic\";\nimport type {\n  GlobalValidator,\n  ValidateResult,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\ntype CountryValidator = {\n  compact: (value: string) => string;\n  validate: (value: string) => ValidateResult;\n  format: (value: string) => string;\n};\n\n/**\n * Map of EU VAT country prefixes to their\n * country-specific validators.\n */\nconst VALIDATORS: Record<string, CountryValidator> = {\n  AT: atUid,\n  BE: beVat,\n  BG: bgVat,\n  CY: cyVat,\n  CZ: czDic,\n  DE: deVat,\n  DK: dkVat,\n  EE: eeVat,\n  EL: grVat, // Greece uses EL prefix in EU VAT\n  ES: esVat,\n  FI: fiVat,\n  FR: frTva,\n  GR: grVat,\n  HR: hrVat,\n  HU: huVat,\n  IE: ieVat,\n  IT: itIva,\n  LT: ltVat,\n  LU: luVat,\n  LV: lvVat,\n  MT: mtVat,\n  NL: nlVat,\n  PL: plNip,\n  PT: ptVat,\n  RO: roVat,\n  SE: seVat,\n  SI: siVat,\n  SK: skDic,\n  XI: gbVat, // Northern Ireland\n};\n\n/**\n * Extract the 2-letter country prefix and the\n * remaining number from an EU VAT string.\n */\nconst splitPrefix = (\n  value: string,\n): { cc: string; rest: string } | undefined => {\n  const v = clean(value, \" -\").toUpperCase();\n  if (v.length < 3) return undefined;\n  const cc = v.slice(0, 2);\n  if (!/^[A-Z]{2}$/.test(cc)) return undefined;\n  return { cc, rest: v.slice(2) };\n};\n\nconst compact = (value: string): string => {\n  const parts = splitPrefix(value);\n  if (parts === undefined) {\n    return clean(value, \" -\").toUpperCase();\n  }\n  const validator = VALIDATORS[parts.cc];\n  if (validator === undefined) {\n    return clean(value, \" -\").toUpperCase();\n  }\n  return `${parts.cc}${validator.compact(parts.rest)}`;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const parts = splitPrefix(value);\n  if (parts === undefined) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"EU VAT must start with a 2-letter country code\",\n    );\n  }\n  const validator = VALIDATORS[parts.cc];\n  if (validator === undefined) {\n    return err(\n      \"INVALID_COMPONENT\",\n      `Unsupported EU VAT country: ${parts.cc}`,\n    );\n  }\n  const result = validator.validate(parts.rest);\n  if (!result.valid) return result;\n  return {\n    valid: true,\n    compact: `${parts.cc}${result.compact}`,\n  };\n};\n\n/**\n * Format returns the compact EU VAT form:\n * `CC` + country-compacted number. Equivalent to\n * compact() because country format() methods\n * prepend their own prefix (e.g., AT UID format\n * returns \"ATU...\"), which would cause double-\n * prefixing if used here.\n */\nconst format = (value: string): string => {\n  const parts = splitPrefix(value);\n  if (parts === undefined) return value;\n  const validator = VALIDATORS[parts.cc];\n  if (validator === undefined) return value;\n  return `${parts.cc}${validator.compact(parts.rest)}`;\n};\n\nconst GENERATORS = [\n  [\"AT\", atUid],\n  [\"BE\", beVat],\n  [\"BG\", bgVat],\n  [\"CY\", cyVat],\n  [\"CZ\", czDic],\n  [\"DE\", deVat],\n  [\"DK\", dkVat],\n  [\"EE\", eeVat],\n  [\"ES\", esVat],\n  [\"FI\", fiVat],\n  [\"FR\", frTva],\n  [\"GR\", grVat],\n  [\"HR\", hrVat],\n  [\"HU\", huVat],\n  [\"IE\", ieVat],\n  [\"IT\", itIva],\n  [\"LT\", ltVat],\n  [\"LU\", luVat],\n  [\"LV\", lvVat],\n  [\"MT\", mtVat],\n  [\"NL\", nlVat],\n  [\"PL\", plNip],\n  [\"PT\", ptVat],\n  [\"RO\", roVat],\n  [\"SE\", seVat],\n  [\"SI\", siVat],\n  [\"SK\", skDic],\n] as const;\n\n/** Generate a random EU VAT number from a member validator. */\nconst generate = (): string => {\n  for (;;) {\n    const candidate =\n      GENERATORS[randomInt(0, GENERATORS.length - 1)];\n    if (!candidate) continue;\n\n    const [prefix, validator] = candidate;\n    if (validator.generate === undefined) continue;\n    return `${prefix}${validator.generate()}`;\n  }\n};\n\n/** European Union VAT Number. */\nconst euVat: GlobalValidator = {\n  scope: \"global\",\n  name: \"EU VAT Number\",\n  localName: \"EU VAT Number\",\n  abbreviation: \"EU VAT\",\n  aliases: [\"EU VAT\", \"VAT identification number\"] as const,\n  candidatePattern: \"[A-Z]{2}\\\\d{8,12}\",\n  entityType: \"company\",\n  sourceUrl: \"https://ec.europa.eu/taxation_customs/vies/\",\n  examples: [\"ATU13585627\", \"DE136695976\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default euVat;\nexport { compact, format, generate, validate };\n"],"mappings":"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"}

package/dist/fi/hetu.d.ts

@@ -1,7 +1,6 @@
-import { ParsedPersonId, ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ParsedPersonId, ValidateResult } from "../types.js";
 
 //#region src/fi/hetu.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
@@ -10,8 +9,10 @@ declare const format: (value: string) => string;
  * Returns null if the value is not valid.
  */
 declare const parse: (value: string) => ParsedPersonId | null;
+/** Generate a random valid HETU. */
+declare const generate: () => string;
 /** Finnish Personal Identity Code. */
-declare const hetu: Validator;
+declare const hetu: CountryValidator<"FI", ParsedPersonId>;
 //#endregion
-export { compact, hetu as default, format, parse, validate };
+export { compact, hetu as default, format, generate, parse, validate };
 //# sourceMappingURL=hetu.d.ts.map

package/dist/fi/hetu.js

@@ -1,17 +1,9 @@
 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";
 //#region src/fi/hetu.ts
-/**
-* HETU (Henkilötunnus).
-*
-* Finnish personal identity code. 11 characters in
-* format DDMMYY+CCC+X where the separator indicates
-* the century and X is a check character.
-*
-* @see https://dvv.fi/en/personal-identity-code
-*/
 const CHECK_CHARS = "0123456789ABCDEFHJKLMNPRSTUVWXY";
 const SEPARATORS_1800 = new Set(["+"]);
 const SEPARATORS_1900 = new Set([
@@ -82,6 +74,17 @@ const parse = (value) => {
 		gender: serial % 2 === 0 ? "female" : "male"
 	};
 };
+/** Generate a random valid HETU. */
+const generate = () => {
+	const year = randomInt(1900, 2024);
+	const month = String(randomInt(1, 12)).padStart(2, "0");
+	const day = String(randomInt(1, 28)).padStart(2, "0");
+	const yy = String(year % 100).padStart(2, "0");
+	const separator = year >= 2e3 ? "A" : "-";
+	const serial = String(randomInt(2, 899)).padStart(3, "0");
+	const checkNum = Number(`${day}${month}${yy}${serial}`);
+	return `${day}${month}${yy}${separator}${serial}${CHECK_CHARS.charAt(checkNum % 31)}`;
+};
 /** Finnish Personal Identity Code. */
 const hetu = {
 	name: "Finnish Personal ID",
@@ -93,15 +96,19 @@ const hetu = {
 		"sosiaaliturvatunnus"
 	],
 	candidatePattern: "\\d{6}[-+A]\\d{3}[\\dA-Z]",
+	scope: "country",
 	country: "FI",
 	entityType: "person",
 	sourceUrl: "https://dvv.fi/en/personal-identity-code",
+	lengths: [11],
 	examples: ["131052-308T"],
 	compact,
 	format,
-	validate
+	parse,
+	validate,
+	generate
 };
 //#endregion
-export { compact, hetu as default, format, parse, validate };
+export { compact, hetu as default, format, generate, parse, validate };
 
 //# sourceMappingURL=hetu.js.map

package/dist/fi/hetu.js.map

@@ -1 +1 @@
-{"version":3,"file":"hetu.js","names":[],"sources":["../../src/fi/hetu.ts"],"sourcesContent":["/**\n * HETU (Henkilötunnus).\n *\n * Finnish personal identity code. 11 characters in\n * format DDMMYY+CCC+X where the separator indicates\n * the century and X is a check character.\n *\n * @see https://dvv.fi/en/personal-identity-code\n */\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\nconst CHECK_CHARS = \"0123456789ABCDEFHJKLMNPRSTUVWXY\";\n\nconst SEPARATORS_1800 = new Set([\"+\"]);\nconst SEPARATORS_1900 = new Set([\n  \"-\",\n  \"Y\",\n  \"X\",\n  \"W\",\n  \"V\",\n  \"U\",\n]);\nconst SEPARATORS_2000 = new Set([\n  \"A\",\n  \"B\",\n  \"C\",\n  \"D\",\n  \"E\",\n  \"F\",\n]);\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 !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"HETU must be exactly 11 characters\",\n    );\n  }\n\n  const dd = v.slice(0, 2);\n  const mm = v.slice(2, 4);\n  const yy = v.slice(4, 6);\n  const separator = v.charAt(6);\n  const serial = v.slice(7, 10);\n  const checkChar = v.charAt(10);\n\n  if (!isdigits(dd) || !isdigits(mm) || !isdigits(yy)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"HETU date part must be digits\",\n    );\n  }\n  if (!isdigits(serial)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"HETU serial must be digits\",\n    );\n  }\n\n  let century: number;\n  if (SEPARATORS_1800.has(separator)) {\n    century = 1800;\n  } else if (SEPARATORS_1900.has(separator)) {\n    century = 1900;\n  } else if (SEPARATORS_2000.has(separator)) {\n    century = 2000;\n  } else {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"HETU separator is invalid\",\n    );\n  }\n\n  const year = century + Number(yy);\n  const month = Number(mm);\n  const day = Number(dd);\n\n  if (!isValidDate(year, month, day)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"HETU contains an invalid date\",\n    );\n  }\n\n  // Individual number must be >= 002\n  const serialNum = Number(serial);\n  if (serialNum < 2) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"HETU individual number must be >= 002\",\n    );\n  }\n  // Temporary range 900-999 is not valid\n  if (serialNum >= 900) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"HETU temporary individual range 900-999\",\n    );\n  }\n\n  const checkNum = Number(`${dd}${mm}${yy}${serial}`);\n  const expected = CHECK_CHARS.charAt(checkNum % 31);\n  if (checkChar !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"HETU 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 a HETU.\n * Returns null if the value is not valid.\n */\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  const dd = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const yy = Number(v.slice(4, 6));\n  const separator = v.charAt(6);\n  const serial = Number(v.slice(7, 10));\n\n  let century: number;\n  if (SEPARATORS_1800.has(separator)) {\n    century = 1800;\n  } else if (SEPARATORS_1900.has(separator)) {\n    century = 1900;\n  } else {\n    century = 2000;\n  }\n\n  const year = century + yy;\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n    gender: serial % 2 === 0 ? \"female\" : \"male\",\n  };\n};\n\n/** Finnish Personal Identity Code. */\nconst hetu: Validator = {\n  name: \"Finnish Personal ID\",\n  localName: \"Henkilötunnus\",\n  abbreviation: \"HETU\",\n  aliases: [\n    \"henkilötunnus\",\n    \"HETU\",\n    \"sosiaaliturvatunnus\",\n  ] as const,\n  candidatePattern: \"\\\\d{6}[-+A]\\\\d{3}[\\\\dA-Z]\",\n  country: \"FI\",\n  entityType: \"person\",\n  sourceUrl: \"https://dvv.fi/en/personal-identity-code\",\n  examples: [\"131052-308T\"] as const,\n  compact,\n  format,\n  validate,\n};\n\nexport default hetu;\nexport { compact, format, parse, validate };\n"],"mappings":";;;;;;;;;;;;;;AAqBA,MAAM,cAAc;AAEpB,MAAM,kBAAkB,IAAI,IAAI,CAAC,IAAI,CAAC;AACtC,MAAM,kBAAkB,IAAI,IAAI;CAC9B;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AACF,MAAM,kBAAkB,IAAI,IAAI;CAC9B;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,MAAM,WAAW,UACf,MAAM,OAAO,IAAI,CAAC,aAAa;AAEjC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,qCACD;CAGH,MAAM,KAAK,EAAE,MAAM,GAAG,EAAE;CACxB,MAAM,KAAK,EAAE,MAAM,GAAG,EAAE;CACxB,MAAM,KAAK,EAAE,MAAM,GAAG,EAAE;CACxB,MAAM,YAAY,EAAE,OAAO,EAAE;CAC7B,MAAM,SAAS,EAAE,MAAM,GAAG,GAAG;CAC7B,MAAM,YAAY,EAAE,OAAO,GAAG;AAE9B,KAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,GAAG,CACjD,QAAO,IACL,kBACA,gCACD;AAEH,KAAI,CAAC,SAAS,OAAO,CACnB,QAAO,IACL,kBACA,6BACD;CAGH,IAAI;AACJ,KAAI,gBAAgB,IAAI,UAAU,CAChC,WAAU;UACD,gBAAgB,IAAI,UAAU,CACvC,WAAU;UACD,gBAAgB,IAAI,UAAU,CACvC,WAAU;KAEV,QAAO,IACL,qBACA,4BACD;AAOH,KAAI,CAAC,YAJQ,UAAU,OAAO,GAAG,EACnB,OAAO,GAAG,EACZ,OAAO,GAAG,CAEY,CAChC,QAAO,IACL,qBACA,gCACD;CAIH,MAAM,YAAY,OAAO,OAAO;AAChC,KAAI,YAAY,EACd,QAAO,IACL,qBACA,wCACD;AAGH,KAAI,aAAa,IACf,QAAO,IACL,qBACA,0CACD;CAGH,MAAM,WAAW,OAAO,GAAG,KAAK,KAAK,KAAK,SAAS;AAEnD,KAAI,cADa,YAAY,OAAO,WAAW,GAAG,CAEhD,QAAO,IACL,oBACA,sCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;;;;AAMxD,MAAM,SAAS,UAAyC;CACtD,MAAM,SAAS,SAAS,MAAM;AAC9B,KAAI,CAAC,OAAO,MAAO,QAAO;CAE1B,MAAM,IAAI,OAAO;CACjB,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,YAAY,EAAE,OAAO,EAAE;CAC7B,MAAM,SAAS,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC;CAErC,IAAI;AACJ,KAAI,gBAAgB,IAAI,UAAU,CAChC,WAAU;UACD,gBAAgB,IAAI,UAAU,CACvC,WAAU;KAEV,WAAU;CAGZ,MAAM,OAAO,UAAU;AAEvB,QAAO;EACL,WAAW,IAAI,KAAK,MAAM,KAAK,GAAG,GAAG;EACrC,QAAQ,SAAS,MAAM,IAAI,WAAW;EACvC;;;AAIH,MAAM,OAAkB;CACtB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,cAAc;CACzB;CACA;CACA;CACD"}
+{"version":3,"file":"hetu.js","names":[],"sources":["../../src/fi/hetu.ts"],"sourcesContent":["/**\n * HETU (Henkilötunnus).\n *\n * Finnish personal identity code. 11 characters in\n * format DDMMYY+CCC+X where the separator indicates\n * the century and X is a check character.\n *\n * @see https://dvv.fi/en/personal-identity-code\n */\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\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 CHECK_CHARS = \"0123456789ABCDEFHJKLMNPRSTUVWXY\";\n\nconst SEPARATORS_1800 = new Set([\"+\"]);\nconst SEPARATORS_1900 = new Set([\n  \"-\",\n  \"Y\",\n  \"X\",\n  \"W\",\n  \"V\",\n  \"U\",\n]);\nconst SEPARATORS_2000 = new Set([\n  \"A\",\n  \"B\",\n  \"C\",\n  \"D\",\n  \"E\",\n  \"F\",\n]);\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 !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"HETU must be exactly 11 characters\",\n    );\n  }\n\n  const dd = v.slice(0, 2);\n  const mm = v.slice(2, 4);\n  const yy = v.slice(4, 6);\n  const separator = v.charAt(6);\n  const serial = v.slice(7, 10);\n  const checkChar = v.charAt(10);\n\n  if (!isdigits(dd) || !isdigits(mm) || !isdigits(yy)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"HETU date part must be digits\",\n    );\n  }\n  if (!isdigits(serial)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"HETU serial must be digits\",\n    );\n  }\n\n  let century: number;\n  if (SEPARATORS_1800.has(separator)) {\n    century = 1800;\n  } else if (SEPARATORS_1900.has(separator)) {\n    century = 1900;\n  } else if (SEPARATORS_2000.has(separator)) {\n    century = 2000;\n  } else {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"HETU separator is invalid\",\n    );\n  }\n\n  const year = century + Number(yy);\n  const month = Number(mm);\n  const day = Number(dd);\n\n  if (!isValidDate(year, month, day)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"HETU contains an invalid date\",\n    );\n  }\n\n  // Individual number must be >= 002\n  const serialNum = Number(serial);\n  if (serialNum < 2) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"HETU individual number must be >= 002\",\n    );\n  }\n  // Temporary range 900-999 is not valid\n  if (serialNum >= 900) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"HETU temporary individual range 900-999\",\n    );\n  }\n\n  const checkNum = Number(`${dd}${mm}${yy}${serial}`);\n  const expected = CHECK_CHARS.charAt(checkNum % 31);\n  if (checkChar !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"HETU 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 a HETU.\n * Returns null if the value is not valid.\n */\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  const dd = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const yy = Number(v.slice(4, 6));\n  const separator = v.charAt(6);\n  const serial = Number(v.slice(7, 10));\n\n  let century: number;\n  if (SEPARATORS_1800.has(separator)) {\n    century = 1800;\n  } else if (SEPARATORS_1900.has(separator)) {\n    century = 1900;\n  } else {\n    century = 2000;\n  }\n\n  const year = century + yy;\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n    gender: serial % 2 === 0 ? \"female\" : \"male\",\n  };\n};\n\n/** Generate a random valid HETU. */\nconst generate = (): string => {\n  const year = randomInt(1900, 2024);\n  const month = String(randomInt(1, 12)).padStart(2, \"0\");\n  const day = String(randomInt(1, 28)).padStart(2, \"0\");\n  const yy = String(year % 100).padStart(2, \"0\");\n  const separator = year >= 2000 ? \"A\" : \"-\";\n  const serial = String(randomInt(2, 899)).padStart(3, \"0\");\n  const checkNum = Number(`${day}${month}${yy}${serial}`);\n  const checkChar = CHECK_CHARS.charAt(checkNum % 31);\n  return `${day}${month}${yy}${separator}${serial}${checkChar}`;\n};\n\n/** Finnish Personal Identity Code. */\nconst hetu: CountryValidator<\"FI\", ParsedPersonId> = {\n  name: \"Finnish Personal ID\",\n  localName: \"Henkilötunnus\",\n  abbreviation: \"HETU\",\n  aliases: [\n    \"henkilötunnus\",\n    \"HETU\",\n    \"sosiaaliturvatunnus\",\n  ] as const,\n  candidatePattern: \"\\\\d{6}[-+A]\\\\d{3}[\\\\dA-Z]\",\n  scope: \"country\",\n  country: \"FI\",\n  entityType: \"person\",\n  sourceUrl: \"https://dvv.fi/en/personal-identity-code\",\n  lengths: [11] as const,\n  examples: [\"131052-308T\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default hetu;\nexport { compact, format, generate, parse, validate };\n"],"mappings":";;;;;;AAsBA,MAAM,cAAc;AAEpB,MAAM,kBAAkB,IAAI,IAAI,CAAC,GAAG,CAAC;AACrC,MAAM,kBAAkB,IAAI,IAAI;CAC9B;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AACD,MAAM,kBAAkB,IAAI,IAAI;CAC9B;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,MAAM,WAAW,UACf,MAAM,OAAO,GAAG,EAAE,YAAY;AAEhC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,oCACF;CAGF,MAAM,KAAK,EAAE,MAAM,GAAG,CAAC;CACvB,MAAM,KAAK,EAAE,MAAM,GAAG,CAAC;CACvB,MAAM,KAAK,EAAE,MAAM,GAAG,CAAC;CACvB,MAAM,YAAY,EAAE,OAAO,CAAC;CAC5B,MAAM,SAAS,EAAE,MAAM,GAAG,EAAE;CAC5B,MAAM,YAAY,EAAE,OAAO,EAAE;CAE7B,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,GAChD,OAAO,IACL,kBACA,+BACF;CAEF,IAAI,CAAC,SAAS,MAAM,GAClB,OAAO,IACL,kBACA,4BACF;CAGF,IAAI;CACJ,IAAI,gBAAgB,IAAI,SAAS,GAC/B,UAAU;MACL,IAAI,gBAAgB,IAAI,SAAS,GACtC,UAAU;MACL,IAAI,gBAAgB,IAAI,SAAS,GACtC,UAAU;MAEV,OAAO,IACL,qBACA,2BACF;CAOF,IAAI,CAAC,YAJQ,UAAU,OAAO,EAAE,GAClB,OAAO,EAGM,GAFf,OAAO,EAEa,CAAC,GAC/B,OAAO,IACL,qBACA,+BACF;CAIF,MAAM,YAAY,OAAO,MAAM;CAC/B,IAAI,YAAY,GACd,OAAO,IACL,qBACA,uCACF;CAGF,IAAI,aAAa,KACf,OAAO,IACL,qBACA,yCACF;CAGF,MAAM,WAAW,OAAO,GAAG,KAAK,KAAK,KAAK,QAAQ;CAElD,IAAI,cADa,YAAY,OAAO,WAAW,EACtB,GACvB,OAAO,IACL,oBACA,qCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;;;;AAMvD,MAAM,SAAS,UAAyC;CACtD,MAAM,SAAS,SAAS,KAAK;CAC7B,IAAI,CAAC,OAAO,OAAO,OAAO;CAE1B,MAAM,IAAI,OAAO;CACjB,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,YAAY,EAAE,OAAO,CAAC;CAC5B,MAAM,SAAS,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAEpC,IAAI;CACJ,IAAI,gBAAgB,IAAI,SAAS,GAC/B,UAAU;MACL,IAAI,gBAAgB,IAAI,SAAS,GACtC,UAAU;MAEV,UAAU;CAGZ,MAAM,OAAO,UAAU;CAEvB,OAAO;EACL,WAAW,IAAI,KAAK,MAAM,KAAK,GAAG,EAAE;EACpC,QAAQ,SAAS,MAAM,IAAI,WAAW;CACxC;AACF;;AAGA,MAAM,iBAAyB;CAC7B,MAAM,OAAO,UAAU,MAAM,IAAI;CACjC,MAAM,QAAQ,OAAO,UAAU,GAAG,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;CACtD,MAAM,MAAM,OAAO,UAAU,GAAG,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;CACpD,MAAM,KAAK,OAAO,OAAO,GAAG,EAAE,SAAS,GAAG,GAAG;CAC7C,MAAM,YAAY,QAAQ,MAAO,MAAM;CACvC,MAAM,SAAS,OAAO,UAAU,GAAG,GAAG,CAAC,EAAE,SAAS,GAAG,GAAG;CACxD,MAAM,WAAW,OAAO,GAAG,MAAM,QAAQ,KAAK,QAAQ;CAEtD,OAAO,GAAG,MAAM,QAAQ,KAAK,YAAY,SADvB,YAAY,OAAO,WAAW,EACU;AAC5D;;AAGA,MAAM,OAA+C;CACnD,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;CACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,aAAa;CACxB;CACA;CACA;CACA;CACA;AACF"}

package/dist/fi/mod.d.ts

@@ -1,10 +1,11 @@
-import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import hetu from "./hetu.js";
 import vat from "./vat.js";
 import ytunnus from "./ytunnus.js";
 
 //#region src/fi/mod.d.ts
-
+declare namespace mod_d_exports {
+  export { hetu, vat, ytunnus };
+}
 //#endregion
 export { hetu, mod_d_exports, vat, ytunnus };
 //# sourceMappingURL=mod.d.ts.map

package/dist/fi/vat.d.ts

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

package/dist/fi/vat.js

@@ -1,18 +1,9 @@
+import { weightedSum } from "../_checksums/weighted-sum.js";
 import { clean } from "../_util/clean.js";
 import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
-import { weightedSum } from "../_checksums/weighted-sum.js";
 //#region src/fi/vat.ts
-/**
-* ALV nro (Finnish VAT number).
-*
-* 8 digits. Weights [7,9,10,5,8,4,2,1],
-* sum % 11 === 0.
-*
-* @see https://www.vatify.eu/finland-vat-number.html
-* @see https://www.ytj.fi/en/index/businessid.html
-*/
 const WEIGHTS = [
 	7,
 	9,
@@ -53,9 +44,11 @@ const vat = {
 	abbreviation: "ALV nro",
 	aliases: ["ALV-numero", "Y-tunnus"],
 	candidatePattern: "FI\\d{8}",
+	scope: "country",
 	country: "FI",
 	entityType: "company",
 	sourceUrl: "https://www.ytj.fi/en/index/businessid.html",
+	lengths: [8],
 	examples: ["20774740"],
 	compact,
 	format,

package/dist/fi/vat.js.map

@@ -1 +1 @@
-{"version":3,"file":"vat.js","names":[],"sources":["../../src/fi/vat.ts"],"sourcesContent":["/**\n * ALV nro (Finnish VAT number).\n *\n * 8 digits. Weights [7,9,10,5,8,4,2,1],\n * sum % 11 === 0.\n *\n * @see https://www.vatify.eu/finland-vat-number.html\n * @see https://www.ytj.fi/en/index/businessid.html\n */\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst WEIGHTS = [7, 9, 10, 5, 8, 4, 2, 1];\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -/.\");\n  if (v.startsWith(\"FI\") || v.startsWith(\"fi\")) {\n    v = v.slice(2);\n  }\n  return v;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 8) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Finnish VAT number must be 8 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Finnish VAT number must contain only digits\",\n    );\n  }\n  const sum = weightedSum(v, WEIGHTS, 11);\n  if (sum !== 0) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Finnish VAT number check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `FI${compact(value)}`;\n\n/** Generate a random valid Finnish VAT number. */\nconst generate = (): string => {\n  for (;;) {\n    const c = randomDigits(8);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Finnish VAT Number. */\nconst vat: Validator = {\n  name: \"Finnish VAT Number\",\n  localName: \"Arvonlisäveronumero\",\n  abbreviation: \"ALV nro\",\n  aliases: [\"ALV-numero\", \"Y-tunnus\"] as const,\n  candidatePattern: \"FI\\\\d{8}\",\n  country: \"FI\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.ytj.fi/en/index/businessid.html\",\n  examples: [\"20774740\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vat;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAI;CAAG;CAAG;CAAG;CAAG;CAAE;AAEzC,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,OAAO;AAC5B,KAAI,EAAE,WAAW,KAAK,IAAI,EAAE,WAAW,KAAK,CAC1C,KAAI,EAAE,MAAM,EAAE;AAEhB,QAAO;;AAGT,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,sCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,8CACD;AAGH,KADY,YAAY,GAAG,SAAS,GAAG,KAC3B,EACV,QAAO,IACL,oBACA,0CACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UACd,KAAK,QAAQ,MAAM;;AAGrB,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,IAAI,aAAa,EAAE;AACzB,MAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;AAKlC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,cAAc,WAAW;CACnC,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"vat.js","names":[],"sources":["../../src/fi/vat.ts"],"sourcesContent":["/**\n * ALV nro (Finnish VAT number).\n *\n * 8 digits. Weights [7,9,10,5,8,4,2,1],\n * sum % 11 === 0.\n *\n * @see https://www.vatify.eu/finland-vat-number.html\n * @see https://www.ytj.fi/en/index/businessid.html\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst WEIGHTS = [7, 9, 10, 5, 8, 4, 2, 1];\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -/.\");\n  if (v.startsWith(\"FI\") || v.startsWith(\"fi\")) {\n    v = v.slice(2);\n  }\n  return v;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 8) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Finnish VAT number must be 8 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Finnish VAT number must contain only digits\",\n    );\n  }\n  const sum = weightedSum(v, WEIGHTS, 11);\n  if (sum !== 0) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Finnish VAT number check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `FI${compact(value)}`;\n\n/** Generate a random valid Finnish VAT number. */\nconst generate = (): string => {\n  for (;;) {\n    const c = randomDigits(8);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Finnish VAT Number. */\nconst vat: CountryValidator<\"FI\"> = {\n  name: \"Finnish VAT Number\",\n  localName: \"Arvonlisäveronumero\",\n  abbreviation: \"ALV nro\",\n  aliases: [\"ALV-numero\", \"Y-tunnus\"] as const,\n  candidatePattern: \"FI\\\\d{8}\",\n  scope: \"country\",\n  country: \"FI\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.ytj.fi/en/index/businessid.html\",\n  lengths: [8] as const,\n  examples: [\"20774740\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vat;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AAqBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAI;CAAG;CAAG;CAAG;CAAG;AAAC;AAExC,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,MAAM;CAC3B,IAAI,EAAE,WAAW,IAAI,KAAK,EAAE,WAAW,IAAI,GACzC,IAAI,EAAE,MAAM,CAAC;CAEf,OAAO;AACT;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,GACf,OAAO,IACL,kBACA,qCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,6CACF;CAGF,IADY,YAAY,GAAG,SAAS,EAC9B,MAAM,GACV,OAAO,IACL,oBACA,yCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UACd,KAAK,QAAQ,KAAK;;AAGpB,MAAM,iBAAyB;CAC7B,SAAS;EACP,MAAM,IAAI,aAAa,CAAC;EACxB,IAAI,SAAS,CAAC,EAAE,OAAO,OAAO;CAChC;AACF;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,cAAc,UAAU;CAClC,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,SAAS,CAAC,CAAC;CACX,UAAU,CAAC,UAAU;CACrB;CACA;CACA;CACA;AACF"}

package/dist/fi/ytunnus.d.ts

@@ -1,14 +1,13 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/fi/ytunnus.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** Generate a random valid Finnish Y-tunnus. */
 declare const generate: () => string;
 /** Finnish Business ID. */
-declare const ytunnus: Validator;
+declare const ytunnus: CountryValidator<"FI">;
 //#endregion
 export { compact, ytunnus as default, format, generate, validate };
 //# sourceMappingURL=ytunnus.d.ts.map

package/dist/fi/ytunnus.js

@@ -1,18 +1,9 @@
+import { weightedSum } from "../_checksums/weighted-sum.js";
 import { clean } from "../_util/clean.js";
 import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
-import { weightedSum } from "../_checksums/weighted-sum.js";
 //#region src/fi/ytunnus.ts
-/**
-* Y-tunnus (Finnish Business ID).
-*
-* 8 digits. Weights [7,9,10,5,8,4,2,1],
-* sum % 11 === 0. Same algorithm as FI VAT.
-* Display format: NNNNNNN-C.
-*
-* @see https://www.ytj.fi/en/index/businessid.html
-*/
 const WEIGHTS = [
 	7,
 	9,
@@ -56,6 +47,7 @@ const ytunnus = {
 		"FO-nummer"
 	],
 	candidatePattern: "\\d{7}-\\d",
+	scope: "country",
 	country: "FI",
 	entityType: "company",
 	sourceUrl: "https://www.ytj.fi/en/index/businessid.html",

package/dist/fi/ytunnus.js.map

@@ -1 +1 @@
-{"version":3,"file":"ytunnus.js","names":[],"sources":["../../src/fi/ytunnus.ts"],"sourcesContent":["/**\n * Y-tunnus (Finnish Business ID).\n *\n * 8 digits. Weights [7,9,10,5,8,4,2,1],\n * sum % 11 === 0. Same algorithm as FI VAT.\n * Display format: NNNNNNN-C.\n *\n * @see https://www.ytj.fi/en/index/businessid.html\n */\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst WEIGHTS = [7, 9, 10, 5, 8, 4, 2, 1];\n\nconst compact = (value: string): string =>\n  clean(value, \" -/.\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 8) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Finnish Y-tunnus must be 8 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Finnish Y-tunnus must contain only digits\",\n    );\n  }\n  const sum = weightedSum(v, WEIGHTS, 11);\n  if (sum !== 0) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Finnish Y-tunnus check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 7)}-${v[7]}`;\n};\n\n/** Generate a random valid Finnish Y-tunnus. */\nconst generate = (): string => {\n  for (;;) {\n    const c = randomDigits(8);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Finnish Business ID. */\nconst ytunnus: Validator = {\n  name: \"Finnish Business ID\",\n  localName: \"Y-tunnus\",\n  abbreviation: \"Y-tunnus\",\n  aliases: [\n    \"Y-tunnus\",\n    \"yritystunnus\",\n    \"FO-nummer\",\n  ] as const,\n  candidatePattern: \"\\\\d{7}-\\\\d\",\n  country: \"FI\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.ytj.fi/en/index/businessid.html\",\n  examples: [\"20774740\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ytunnus;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAI;CAAG;CAAG;CAAG;CAAG;CAAE;AAEzC,MAAM,WAAW,UACf,MAAM,OAAO,OAAO;AAEtB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,oCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,4CACD;AAGH,KADY,YAAY,GAAG,SAAS,GAAG,KAC3B,EACV,QAAO,IACL,oBACA,wCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE;;;AAI/B,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,IAAI,aAAa,EAAE;AACzB,MAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;AAKlC,MAAM,UAAqB;CACzB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"ytunnus.js","names":[],"sources":["../../src/fi/ytunnus.ts"],"sourcesContent":["/**\n * Y-tunnus (Finnish Business ID).\n *\n * 8 digits. Weights [7,9,10,5,8,4,2,1],\n * sum % 11 === 0. Same algorithm as FI VAT.\n * Display format: NNNNNNN-C.\n *\n * @see https://www.ytj.fi/en/index/businessid.html\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst WEIGHTS = [7, 9, 10, 5, 8, 4, 2, 1];\n\nconst compact = (value: string): string =>\n  clean(value, \" -/.\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 8) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Finnish Y-tunnus must be 8 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Finnish Y-tunnus must contain only digits\",\n    );\n  }\n  const sum = weightedSum(v, WEIGHTS, 11);\n  if (sum !== 0) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Finnish Y-tunnus check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 7)}-${v[7]}`;\n};\n\n/** Generate a random valid Finnish Y-tunnus. */\nconst generate = (): string => {\n  for (;;) {\n    const c = randomDigits(8);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Finnish Business ID. */\nconst ytunnus: CountryValidator<\"FI\"> = {\n  name: \"Finnish Business ID\",\n  localName: \"Y-tunnus\",\n  abbreviation: \"Y-tunnus\",\n  aliases: [\n    \"Y-tunnus\",\n    \"yritystunnus\",\n    \"FO-nummer\",\n  ] as const,\n  candidatePattern: \"\\\\d{7}-\\\\d\",\n  scope: \"country\",\n  country: \"FI\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.ytj.fi/en/index/businessid.html\",\n  examples: [\"20774740\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ytunnus;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AAqBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAI;CAAG;CAAG;CAAG;CAAG;AAAC;AAExC,MAAM,WAAW,UACf,MAAM,OAAO,MAAM;AAErB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,GACf,OAAO,IACL,kBACA,mCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,2CACF;CAGF,IADY,YAAY,GAAG,SAAS,EAC9B,MAAM,GACV,OAAO,IACL,oBACA,uCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,OAAO,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE;AAC/B;;AAGA,MAAM,iBAAyB;CAC7B,SAAS;EACP,MAAM,IAAI,aAAa,CAAC;EACxB,IAAI,SAAS,CAAC,EAAE,OAAO,OAAO;CAChC;AACF;;AAGA,MAAM,UAAkC;CACtC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;CACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,UAAU;CACrB;CACA;CACA;CACA;AACF"}

package/dist/fr/mod.d.ts

@@ -1,4 +1,3 @@
-import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import nif from "./nif.js";
 import nir from "./nir.js";
 import siren from "./siren.js";
@@ -6,7 +5,9 @@ import siret from "./siret.js";
 import tva from "./tva.js";
 
 //#region src/fr/mod.d.ts
-
+declare namespace mod_d_exports {
+  export { nif, nir, siren, siret, tva };
+}
 //#endregion
 export { mod_d_exports, nif, nir, siren, siret, tva };
 //# sourceMappingURL=mod.d.ts.map

package/dist/fr/nif.d.ts

@@ -1,14 +1,13 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/fr/nif.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** Generate a random valid French NIF. */
 declare const generate: () => string;
 /** French Tax Identification Number. */
-declare const nif: Validator;
+declare const nif: CountryValidator<"FR">;
 //#endregion
 export { compact, nif as default, format, generate, validate };
 //# sourceMappingURL=nif.d.ts.map

package/dist/fr/nif.js

@@ -3,15 +3,6 @@ import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/fr/nif.ts
-/**
-* NIF (Numéro d'Identification Fiscale).
-*
-* French tax identification number. 13 digits;
-* first digit is 0-3. Last 3 digits are a
-* check: first_10_digits % 511 == last_3.
-*
-* @see https://www.impots.gouv.fr/
-*/
 const compact = (value) => clean(value, " -");
 const validate = (value) => {
 	const v = compact(value);
@@ -49,6 +40,7 @@ const nif = {
 		"numéro d'identification fiscale"
 	],
 	candidatePattern: "\\d{13}",
+	scope: "country",
 	country: "FR",
 	entityType: "person",
 	sourceUrl: "https://www.impots.gouv.fr/",

package/dist/fr/nif.js.map

@@ -1 +1 @@
-{"version":3,"file":"nif.js","names":[],"sources":["../../src/fr/nif.ts"],"sourcesContent":["/**\n * NIF (Numéro d'Identification Fiscale).\n *\n * French tax identification number. 13 digits;\n * first digit is 0-3. Last 3 digits are a\n * check: first_10_digits % 511 == last_3.\n *\n * @see https://www.impots.gouv.fr/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"French NIF must be exactly 13 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French NIF must contain only digits\",\n    );\n  }\n  const first = v[0];\n  if (\n    first !== \"0\" &&\n    first !== \"1\" &&\n    first !== \"2\" &&\n    first !== \"3\"\n  ) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"French NIF must start with 0-3\",\n    );\n  }\n  const front = Number(v.slice(0, 10));\n  const check = Number(v.slice(10));\n  if (front % 511 !== check) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"French NIF check digits mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 2)} ${v.slice(2, 4)} ${v.slice(4, 7)} ${v.slice(7, 10)} ${v.slice(10)}`;\n};\n\n/** Generate a random valid French NIF. */\nconst generate = (): string => {\n  for (;;) {\n    const c = String(randomInt(0, 3)) + randomDigits(12);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** French Tax Identification Number. */\nconst nif: Validator = {\n  name: \"French Tax ID\",\n  localName: \"Numéro d'Identification Fiscale\",\n  abbreviation: \"NIF\",\n  aliases: [\n    \"numéro fiscal\",\n    \"NIF\",\n    \"numéro d'identification fiscale\",\n  ] as const,\n  candidatePattern: \"\\\\d{13}\",\n  country: \"FR\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.impots.gouv.fr/\",\n  examples: [\"3023217600053\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nif;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;AAiBA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,uCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,sCACD;CAEH,MAAM,QAAQ,EAAE;AAChB,KACE,UAAU,OACV,UAAU,OACV,UAAU,OACV,UAAU,IAEV,QAAO,IACL,qBACA,iCACD;CAEH,MAAM,QAAQ,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC;CACpC,MAAM,QAAQ,OAAO,EAAE,MAAM,GAAG,CAAC;AACjC,KAAI,QAAQ,QAAQ,MAClB,QAAO,IACL,oBACA,mCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG;;;AAI5F,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,IAAI,OAAO,UAAU,GAAG,EAAE,CAAC,GAAG,aAAa,GAAG;AACpD,MAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;AAKlC,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,gBAAgB;CAC3B;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"nif.js","names":[],"sources":["../../src/fr/nif.ts"],"sourcesContent":["/**\n * NIF (Numéro d'Identification Fiscale).\n *\n * French tax identification number. 13 digits;\n * first digit is 0-3. Last 3 digits are a\n * check: first_10_digits % 511 == last_3.\n *\n * @see https://www.impots.gouv.fr/\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"French NIF must be exactly 13 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French NIF must contain only digits\",\n    );\n  }\n  const first = v[0];\n  if (\n    first !== \"0\" &&\n    first !== \"1\" &&\n    first !== \"2\" &&\n    first !== \"3\"\n  ) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"French NIF must start with 0-3\",\n    );\n  }\n  const front = Number(v.slice(0, 10));\n  const check = Number(v.slice(10));\n  if (front % 511 !== check) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"French NIF check digits mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 2)} ${v.slice(2, 4)} ${v.slice(4, 7)} ${v.slice(7, 10)} ${v.slice(10)}`;\n};\n\n/** Generate a random valid French NIF. */\nconst generate = (): string => {\n  for (;;) {\n    const c = String(randomInt(0, 3)) + randomDigits(12);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** French Tax Identification Number. */\nconst nif: CountryValidator<\"FR\"> = {\n  name: \"French Tax ID\",\n  localName: \"Numéro d'Identification Fiscale\",\n  abbreviation: \"NIF\",\n  aliases: [\n    \"numéro fiscal\",\n    \"NIF\",\n    \"numéro d'identification fiscale\",\n  ] as const,\n  candidatePattern: \"\\\\d{13}\",\n  scope: \"country\",\n  country: \"FR\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.impots.gouv.fr/\",\n  examples: [\"3023217600053\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nif;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AAoBA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;AAEnB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,sCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,qCACF;CAEF,MAAM,QAAQ,EAAE;CAChB,IACE,UAAU,OACV,UAAU,OACV,UAAU,OACV,UAAU,KAEV,OAAO,IACL,qBACA,gCACF;CAEF,MAAM,QAAQ,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CACnC,MAAM,QAAQ,OAAO,EAAE,MAAM,EAAE,CAAC;CAChC,IAAI,QAAQ,QAAQ,OAClB,OAAO,IACL,oBACA,kCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,OAAO,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;AAC3F;;AAGA,MAAM,iBAAyB;CAC7B,SAAS;EACP,MAAM,IAAI,OAAO,UAAU,GAAG,CAAC,CAAC,IAAI,aAAa,EAAE;EACnD,IAAI,SAAS,CAAC,EAAE,OAAO,OAAO;CAChC;AACF;;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,eAAe;CAC1B;CACA;CACA;CACA;AACF"}

package/dist/fr/nir.d.ts

@@ -1,7 +1,6 @@
-import { ParsedPersonId, ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ParsedPersonId, ValidateResult } from "../types.js";
 
 //#region src/fr/nir.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
@@ -9,7 +8,7 @@ declare const parse: (value: string) => ParsedPersonId | null;
 /** Generate a random valid French NIR. */
 declare const generate: () => string;
 /** French Social Security Number. */
-declare const nir: Validator;
+declare const nir: CountryValidator<"FR", ParsedPersonId>;
 //#endregion
 export { compact, nir as default, format, generate, parse, validate };
 //# sourceMappingURL=nir.d.ts.map

package/dist/fr/nir.js

@@ -1,21 +1,8 @@
 import { clean } from "../_util/clean.js";
+import { resolveTwoDigitYear } from "../_util/date.js";
 import { randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
-import { resolveTwoDigitYear } from "../_util/date.js";
 //#region src/fr/nir.ts
-/**
-* NIR (Numero d'Inscription au Repertoire).
-*
-* French social security number (numero de securite
-* sociale). 15 digits: 13 identity digits + 2 check
-* digits. Encodes gender, year/month of birth, and
-* department of birth.
-*
-* Corsican departments 2A/2B are encoded as 19/18
-* for the mod-97 checksum computation.
-*
-* @see https://en.wikipedia.org/wiki/INSEE_code
-*/
 const compact = (value) => clean(value, " -.");
 const validate = (value) => {
 	const v = compact(value).toUpperCase();
@@ -89,6 +76,7 @@ const nir = {
 		"sécu"
 	],
 	candidatePattern: "[12]\\s?\\d{2}\\s?\\d{2}\\s?\\d{2}\\s?\\d{3}\\s?\\d{3}\\s?\\d{2}",
+	scope: "country",
 	country: "FR",
 	entityType: "person",
 	description: "French social security number encoding gender, birth date, and department",
@@ -97,6 +85,7 @@ const nir = {
 	examples: ["295117823456784"],
 	compact,
 	format,
+	parse,
 	validate,
 	generate
 };

package/dist/fr/nir.js.map

@@ -1 +1 @@
-{"version":3,"file":"nir.js","names":[],"sources":["../../src/fr/nir.ts"],"sourcesContent":["/**\n * NIR (Numero d'Inscription au Repertoire).\n *\n * French social security number (numero de securite\n * sociale). 15 digits: 13 identity digits + 2 check\n * digits. Encodes gender, year/month of birth, and\n * department of birth.\n *\n * Corsican departments 2A/2B are encoded as 19/18\n * for the mod-97 checksum computation.\n *\n * @see https://en.wikipedia.org/wiki/INSEE_code\n */\n\nimport { clean } from \"#util/clean\";\nimport { resolveTwoDigitYear } from \"#util/date\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -.\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value).toUpperCase();\n  if (v.length !== 15) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"French NIR must be 15 characters\",\n    );\n  }\n\n  const gender = v[0];\n  if (gender !== \"1\" && gender !== \"2\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"French NIR first digit must be 1 or 2\",\n    );\n  }\n\n  const yearPart = v.slice(1, 3);\n  if (!/^\\d{2}$/.test(yearPart)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French NIR year must be 2 digits\",\n    );\n  }\n\n  const monthPart = v.slice(3, 5);\n  if (!/^\\d{2}$/.test(monthPart) || monthPart === \"00\") {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French NIR month must be 01-99\",\n    );\n  }\n\n  const deptPart = v.slice(5, 7);\n  const isCorsica = deptPart === \"2A\" || deptPart === \"2B\";\n  if (!isCorsica && !/^\\d{2}$/.test(deptPart)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French NIR department must be 2 digits or 2A/2B\",\n    );\n  }\n\n  const communePart = v.slice(7, 10);\n  if (!/^\\d{3}$/.test(communePart)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French NIR commune must be 3 digits\",\n    );\n  }\n\n  const serialPart = v.slice(10, 13);\n  if (!/^\\d{3}$/.test(serialPart)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French NIR serial must be 3 digits\",\n    );\n  }\n\n  const checkPart = v.slice(13, 15);\n  if (!/^\\d{2}$/.test(checkPart)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French NIR check must be 2 digits\",\n    );\n  }\n\n  let numericBase: string;\n  if (deptPart === \"2A\") {\n    numericBase = v.slice(0, 5) + \"19\" + v.slice(7, 13);\n  } else if (deptPart === \"2B\") {\n    numericBase = v.slice(0, 5) + \"18\" + v.slice(7, 13);\n  } else {\n    numericBase = v.slice(0, 13);\n  }\n\n  const base = BigInt(numericBase);\n  const expected = 97n - (base % 97n);\n  const actual = BigInt(checkPart);\n\n  if (expected !== actual) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"French NIR check digits mismatch\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value).toUpperCase();\n  return (\n    `${v.slice(0, 1)} ${v.slice(1, 3)}` +\n    ` ${v.slice(3, 5)} ${v.slice(5, 7)}` +\n    ` ${v.slice(7, 10)} ${v.slice(10, 13)}` +\n    ` ${v.slice(13)}`\n  );\n};\n\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  const genderDigit = v[0];\n  const yy = Number(v.slice(1, 3));\n  const mm = Number(v.slice(3, 5));\n\n  if (mm < 1 || mm > 12) return null;\n\n  const year = resolveTwoDigitYear(yy);\n  const gender = genderDigit === \"1\" ? \"male\" : \"female\";\n\n  return {\n    birthDate: new Date(year, mm - 1, 1),\n    gender,\n  };\n};\n\n/** Generate a random valid French NIR. */\nconst generate = (): string => {\n  for (;;) {\n    const g = String(randomInt(1, 2));\n    const yy = String(randomInt(50, 99)).padStart(2, \"0\");\n    const mm = String(randomInt(1, 12)).padStart(2, \"0\");\n    const dept = String(randomInt(1, 95)).padStart(2, \"0\");\n    const com = String(randomInt(1, 999)).padStart(3, \"0\");\n    const s = String(randomInt(1, 999)).padStart(3, \"0\");\n    const base = g + yy + mm + dept + com + s;\n    const check = String(97 - (Number(base) % 97)).padStart(\n      2,\n      \"0\",\n    );\n    const c = base + check;\n    if (validate(c).valid) return c;\n  }\n};\n\n/** French Social Security Number. */\nconst nir: Validator = {\n  name: \"French Social Security Number\",\n  localName: \"Numero d'Inscription au Repertoire\",\n  abbreviation: \"NIR\",\n  aliases: [\n    \"NIR\",\n    \"numéro de sécurité sociale\",\n    \"numéro SS\",\n    \"sécu\",\n  ] as const,\n  candidatePattern:\n    \"[12]\\\\s?\\\\d{2}\\\\s?\\\\d{2}\\\\s?\\\\d{2}\\\\s?\\\\d{3}\\\\s?\\\\d{3}\\\\s?\\\\d{2}\",\n  country: \"FR\",\n  entityType: \"person\",\n  description:\n    \"French social security number encoding \" +\n    \"gender, birth date, and department\",\n  sourceUrl: \"https://en.wikipedia.org/wiki/INSEE_code\",\n  lengths: [15] as const,\n  examples: [\"295117823456784\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nir;\nexport { compact, format, parse, validate, generate };\n"],"mappings":"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"}
+{"version":3,"file":"nir.js","names":[],"sources":["../../src/fr/nir.ts"],"sourcesContent":["/**\n * NIR (Numero d'Inscription au Repertoire).\n *\n * French social security number (numero de securite\n * sociale). 15 digits: 13 identity digits + 2 check\n * digits. Encodes gender, year/month of birth, and\n * department of birth.\n *\n * Corsican departments 2A/2B are encoded as 19/18\n * for the mod-97 checksum computation.\n *\n * @see https://en.wikipedia.org/wiki/INSEE_code\n */\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { resolveTwoDigitYear } from \"#util/date\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -.\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value).toUpperCase();\n  if (v.length !== 15) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"French NIR must be 15 characters\",\n    );\n  }\n\n  const gender = v[0];\n  if (gender !== \"1\" && gender !== \"2\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"French NIR first digit must be 1 or 2\",\n    );\n  }\n\n  const yearPart = v.slice(1, 3);\n  if (!/^\\d{2}$/.test(yearPart)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French NIR year must be 2 digits\",\n    );\n  }\n\n  const monthPart = v.slice(3, 5);\n  if (!/^\\d{2}$/.test(monthPart) || monthPart === \"00\") {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French NIR month must be 01-99\",\n    );\n  }\n\n  const deptPart = v.slice(5, 7);\n  const isCorsica = deptPart === \"2A\" || deptPart === \"2B\";\n  if (!isCorsica && !/^\\d{2}$/.test(deptPart)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French NIR department must be 2 digits or 2A/2B\",\n    );\n  }\n\n  const communePart = v.slice(7, 10);\n  if (!/^\\d{3}$/.test(communePart)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French NIR commune must be 3 digits\",\n    );\n  }\n\n  const serialPart = v.slice(10, 13);\n  if (!/^\\d{3}$/.test(serialPart)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French NIR serial must be 3 digits\",\n    );\n  }\n\n  const checkPart = v.slice(13, 15);\n  if (!/^\\d{2}$/.test(checkPart)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French NIR check must be 2 digits\",\n    );\n  }\n\n  let numericBase: string;\n  if (deptPart === \"2A\") {\n    numericBase = v.slice(0, 5) + \"19\" + v.slice(7, 13);\n  } else if (deptPart === \"2B\") {\n    numericBase = v.slice(0, 5) + \"18\" + v.slice(7, 13);\n  } else {\n    numericBase = v.slice(0, 13);\n  }\n\n  const base = BigInt(numericBase);\n  const expected = 97n - (base % 97n);\n  const actual = BigInt(checkPart);\n\n  if (expected !== actual) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"French NIR check digits mismatch\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value).toUpperCase();\n  return (\n    `${v.slice(0, 1)} ${v.slice(1, 3)}` +\n    ` ${v.slice(3, 5)} ${v.slice(5, 7)}` +\n    ` ${v.slice(7, 10)} ${v.slice(10, 13)}` +\n    ` ${v.slice(13)}`\n  );\n};\n\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  const genderDigit = v[0];\n  const yy = Number(v.slice(1, 3));\n  const mm = Number(v.slice(3, 5));\n\n  if (mm < 1 || mm > 12) return null;\n\n  const year = resolveTwoDigitYear(yy);\n  const gender = genderDigit === \"1\" ? \"male\" : \"female\";\n\n  return {\n    birthDate: new Date(year, mm - 1, 1),\n    gender,\n  };\n};\n\n/** Generate a random valid French NIR. */\nconst generate = (): string => {\n  for (;;) {\n    const g = String(randomInt(1, 2));\n    const yy = String(randomInt(50, 99)).padStart(2, \"0\");\n    const mm = String(randomInt(1, 12)).padStart(2, \"0\");\n    const dept = String(randomInt(1, 95)).padStart(2, \"0\");\n    const com = String(randomInt(1, 999)).padStart(3, \"0\");\n    const s = String(randomInt(1, 999)).padStart(3, \"0\");\n    const base = g + yy + mm + dept + com + s;\n    const check = String(97 - (Number(base) % 97)).padStart(\n      2,\n      \"0\",\n    );\n    const c = base + check;\n    if (validate(c).valid) return c;\n  }\n};\n\n/** French Social Security Number. */\nconst nir: CountryValidator<\"FR\", ParsedPersonId> = {\n  name: \"French Social Security Number\",\n  localName: \"Numero d'Inscription au Repertoire\",\n  abbreviation: \"NIR\",\n  aliases: [\n    \"NIR\",\n    \"numéro de sécurité sociale\",\n    \"numéro SS\",\n    \"sécu\",\n  ] as const,\n  candidatePattern:\n    \"[12]\\\\s?\\\\d{2}\\\\s?\\\\d{2}\\\\s?\\\\d{2}\\\\s?\\\\d{3}\\\\s?\\\\d{3}\\\\s?\\\\d{2}\",\n  scope: \"country\",\n  country: \"FR\",\n  entityType: \"person\",\n  description:\n    \"French social security number encoding \" +\n    \"gender, birth date, and department\",\n  sourceUrl: \"https://en.wikipedia.org/wiki/INSEE_code\",\n  lengths: [15] as const,\n  examples: [\"295117823456784\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default nir;\nexport { compact, format, parse, validate, generate };\n"],"mappings":"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"}

package/dist/fr/siren.d.ts

@@ -1,14 +1,13 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/fr/siren.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** Generate a random valid French SIREN. */
 declare const generate: () => string;
 /** French Company Identification Number. */
-declare const siren: Validator;
+declare const siren: CountryValidator<"FR">;
 //#endregion
 export { compact, siren as default, format, generate, validate };
 //# sourceMappingURL=siren.d.ts.map

package/dist/fr/siren.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/fr/siren.ts
-/**
-* SIREN (Système d'Identification du Répertoire
-* des Entreprises).
-*
-* French company identification number. 9 digits
-* validated with standard Luhn algorithm.
-*
-* @see https://www.insee.fr/fr/information/2549588
-*/
 const compact = (value) => clean(value, " -.");
 const validate = (value) => {
 	const v = compact(value);
@@ -41,6 +32,7 @@ const siren = {
 	abbreviation: "SIREN",
 	aliases: ["SIREN", "numéro SIREN"],
 	candidatePattern: "\\d{3}\\s?\\d{3}\\s?\\d{3}",
+	scope: "country",
 	country: "FR",
 	entityType: "company",
 	sourceUrl: "https://www.insee.fr/fr/information/2549588",

package/dist/fr/siren.js.map

@@ -1 +1 @@
-{"version":3,"file":"siren.js","names":[],"sources":["../../src/fr/siren.ts"],"sourcesContent":["/**\n * SIREN (Système d'Identification du Répertoire\n * des Entreprises).\n *\n * French company identification number. 9 digits\n * validated with standard Luhn algorithm.\n *\n * @see https://www.insee.fr/fr/information/2549588\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 compact = (value: string): string =>\n  clean(value, \" -.\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"SIREN must be exactly 9 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"SIREN must contain only digits\",\n    );\n  }\n  if (!luhnValidate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"SIREN fails Luhn check\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 3)} ${v.slice(3, 6)} ${v.slice(6)}`;\n};\n\n/** Generate a random valid French SIREN. */\nconst generate = (): string => {\n  const payload = randomDigits(8);\n  const cs = luhnChecksum(payload + \"0\");\n  return payload + String((10 - cs) % 10);\n};\n\n/** French Company Identification Number. */\nconst siren: Validator = {\n  name: \"French Company ID\",\n  localName:\n    \"Système d'Identification du Répertoire des Entreprises\",\n  abbreviation: \"SIREN\",\n  aliases: [\"SIREN\", \"numéro SIREN\"] as const,\n  candidatePattern: \"\\\\d{3}\\\\s?\\\\d{3}\\\\s?\\\\d{3}\",\n  country: \"FR\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.insee.fr/fr/information/2549588\",\n  examples: [\"552008443\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default siren;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;AAqBA,MAAM,WAAW,UACf,MAAM,OAAO,MAAM;AAErB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,iCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,iCACD;AAEH,KAAI,CAAC,aAAa,EAAE,CAClB,QAAO,IACL,oBACA,yBACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;;;AAIxD,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,EAAE;CAC/B,MAAM,KAAK,aAAa,UAAU,IAAI;AACtC,QAAO,UAAU,QAAQ,KAAK,MAAM,GAAG;;;AAIzC,MAAM,QAAmB;CACvB,MAAM;CACN,WACE;CACF,cAAc;CACd,SAAS,CAAC,SAAS,eAAe;CAClC,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"siren.js","names":[],"sources":["../../src/fr/siren.ts"],"sourcesContent":["/**\n * SIREN (Système d'Identification du Répertoire\n * des Entreprises).\n *\n * French company identification number. 9 digits\n * validated with standard Luhn algorithm.\n *\n * @see https://www.insee.fr/fr/information/2549588\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 compact = (value: string): string =>\n  clean(value, \" -.\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"SIREN must be exactly 9 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"SIREN must contain only digits\",\n    );\n  }\n  if (!luhnValidate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"SIREN fails Luhn check\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 3)} ${v.slice(3, 6)} ${v.slice(6)}`;\n};\n\n/** Generate a random valid French SIREN. */\nconst generate = (): string => {\n  const payload = randomDigits(8);\n  const cs = luhnChecksum(payload + \"0\");\n  return payload + String((10 - cs) % 10);\n};\n\n/** French Company Identification Number. */\nconst siren: CountryValidator<\"FR\"> = {\n  name: \"French Company ID\",\n  localName:\n    \"Système d'Identification du Répertoire des Entreprises\",\n  abbreviation: \"SIREN\",\n  aliases: [\"SIREN\", \"numéro SIREN\"] as const,\n  candidatePattern: \"\\\\d{3}\\\\s?\\\\d{3}\\\\s?\\\\d{3}\",\n  scope: \"country\",\n  country: \"FR\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.insee.fr/fr/information/2549588\",\n  examples: [\"552008443\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default siren;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AAwBA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,GACf,OAAO,IACL,kBACA,gCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,gCACF;CAEF,IAAI,CAAC,aAAa,CAAC,GACjB,OAAO,IACL,oBACA,wBACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,OAAO,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC;AACvD;;AAGA,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,CAAC;CAC9B,MAAM,KAAK,aAAa,UAAU,GAAG;CACrC,OAAO,UAAU,QAAQ,KAAK,MAAM,EAAE;AACxC;;AAGA,MAAM,QAAgC;CACpC,MAAM;CACN,WACE;CACF,cAAc;CACd,SAAS,CAAC,SAAS,cAAc;CACjC,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;AACF"}

package/dist/fr/siret.d.ts

@@ -1,14 +1,13 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/fr/siret.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** Generate a random valid French SIRET. */
 declare const generate: () => string;
 /** French Establishment Identification Number. */
-declare const siret: Validator;
+declare const siret: CountryValidator<"FR">;
 //#endregion
 export { compact, siret as default, format, generate, validate };
 //# sourceMappingURL=siret.d.ts.map