@stll/stdnum 1.0.0 → 2.0.1

package/dist/fi/hetu.js

@@ -1,18 +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([
@@ -105,6 +96,7 @@ 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",

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 { 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 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: Validator<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  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":"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"}
+{"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":"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"}

package/dist/fi/vat.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/fi/vat.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ 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,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/fi/ytunnus.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ 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/nif.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/fr/nif.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ 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,4 +1,4 @@
-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;
@@ -8,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<ParsedPersonId>;
+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",

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<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  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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"}
+{"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,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/fr/siren.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ 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,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/fr/siret.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ 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

package/dist/fr/siret.js

@@ -1,19 +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/siret.ts
-/**
-* SIRET (Système d'Identification du Répertoire
-* des Établissements).
-*
-* French establishment identification number.
-* 14 digits: SIREN (9) + NIC (5). Validated
-* with Luhn, with a special case for La Poste.
-*
-* @see https://www.insee.fr/fr/information/2549588
-*/
 const compact = (value) => clean(value, " -.");
 /**
 * La Poste SIRET uses digit sum % 5 instead of
@@ -58,6 +48,7 @@ const siret = {
 	abbreviation: "SIRET",
 	aliases: ["SIRET", "numéro SIRET"],
 	candidatePattern: "\\d{3}\\s?\\d{3}\\s?\\d{3}\\s?\\d{5}",
+	scope: "country",
 	country: "FR",
 	entityType: "company",
 	sourceUrl: "https://www.insee.fr/fr/information/2549588",

package/dist/fr/siret.js.map

@@ -1 +1 @@
-{"version":3,"file":"siret.js","names":[],"sources":["../../src/fr/siret.ts"],"sourcesContent":["/**\n * SIRET (Système d'Identification du Répertoire\n * des Établissements).\n *\n * French establishment identification number.\n * 14 digits: SIREN (9) + NIC (5). Validated\n * with Luhn, with a special case for La Poste.\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\n/**\n * La Poste SIRET uses digit sum % 5 instead of\n * Luhn, EXCEPT the head office (35600000000048)\n * which uses standard Luhn.\n */\nconst isLaPoste = (v: string): boolean =>\n  v.startsWith(\"356000000\") && v !== \"35600000000048\";\n\nconst digitSum = (v: string): number => {\n  let sum = 0;\n  for (let i = 0; i < v.length; i++) {\n    sum += Number(v[i]);\n  }\n  return sum;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 14) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"SIRET must be exactly 14 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"SIRET must contain only digits\",\n    );\n  }\n\n  // Validate SIREN part (first 9 digits)\n  const siren = v.slice(0, 9);\n  if (!luhnValidate(siren) && !isLaPoste(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"SIRET SIREN part fails Luhn check\",\n    );\n  }\n\n  // La Poste: digit sum mod 5\n  if (isLaPoste(v)) {\n    if (digitSum(v) % 5 !== 0) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"SIRET La Poste digit sum check failed\",\n      );\n    }\n  } else {\n    // Standard: full 14-digit Luhn\n    if (!luhnValidate(v)) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"SIRET fails Luhn check\",\n      );\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, 6)} ${v.slice(6, 9)} ${v.slice(9)}`;\n};\n\n/** Generate a random valid French SIRET. */\nconst generate = (): string => {\n  const sp = randomDigits(8);\n  const sc = luhnChecksum(sp + \"0\");\n  const siren = sp + String((10 - sc) % 10);\n  const nic = randomDigits(4);\n  const payload = siren + nic;\n  const cs = luhnChecksum(payload + \"0\");\n  return payload + String((10 - cs) % 10);\n};\n\n/** French Establishment Identification Number. */\nconst siret: Validator = {\n  name: \"French Establishment ID\",\n  localName:\n    \"Système d'Identification du Répertoire des Établissements\",\n  abbreviation: \"SIRET\",\n  aliases: [\"SIRET\", \"numéro SIRET\"] as const,\n  candidatePattern: \"\\\\d{3}\\\\s?\\\\d{3}\\\\s?\\\\d{3}\\\\s?\\\\d{5}\",\n  country: \"FR\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.insee.fr/fr/information/2549588\",\n  examples: [\"73282932000074\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default siret;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;AAsBA,MAAM,WAAW,UACf,MAAM,OAAO,MAAM;;;;;;AAOrB,MAAM,aAAa,MACjB,EAAE,WAAW,YAAY,IAAI,MAAM;AAErC,MAAM,YAAY,MAAsB;CACtC,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,EAAE,QAAQ,IAC5B,QAAO,OAAO,EAAE,GAAG;AAErB,QAAO;;AAGT,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,kCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,iCACD;AAKH,KAAI,CAAC,aADS,EAAE,MAAM,GAAG,EAAE,CACH,IAAI,CAAC,UAAU,EAAE,CACvC,QAAO,IACL,oBACA,oCACD;AAIH,KAAI,UAAU,EAAE;MACV,SAAS,EAAE,GAAG,MAAM,EACtB,QAAO,IACL,oBACA,wCACD;YAIC,CAAC,aAAa,EAAE,CAClB,QAAO,IACL,oBACA,yBACD;AAIL,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;;;AAIzE,MAAM,iBAAyB;CAC7B,MAAM,KAAK,aAAa,EAAE;CAC1B,MAAM,KAAK,aAAa,KAAK,IAAI;CAGjC,MAAM,UAFQ,KAAK,QAAQ,KAAK,MAAM,GAAG,GAC7B,aAAa,EAAE;CAE3B,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,iBAAiB;CAC5B;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"siret.js","names":[],"sources":["../../src/fr/siret.ts"],"sourcesContent":["/**\n * SIRET (Système d'Identification du Répertoire\n * des Établissements).\n *\n * French establishment identification number.\n * 14 digits: SIREN (9) + NIC (5). Validated\n * with Luhn, with a special case for La Poste.\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\n/**\n * La Poste SIRET uses digit sum % 5 instead of\n * Luhn, EXCEPT the head office (35600000000048)\n * which uses standard Luhn.\n */\nconst isLaPoste = (v: string): boolean =>\n  v.startsWith(\"356000000\") && v !== \"35600000000048\";\n\nconst digitSum = (v: string): number => {\n  let sum = 0;\n  for (let i = 0; i < v.length; i++) {\n    sum += Number(v[i]);\n  }\n  return sum;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 14) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"SIRET must be exactly 14 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"SIRET must contain only digits\",\n    );\n  }\n\n  // Validate SIREN part (first 9 digits)\n  const siren = v.slice(0, 9);\n  if (!luhnValidate(siren) && !isLaPoste(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"SIRET SIREN part fails Luhn check\",\n    );\n  }\n\n  // La Poste: digit sum mod 5\n  if (isLaPoste(v)) {\n    if (digitSum(v) % 5 !== 0) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"SIRET La Poste digit sum check failed\",\n      );\n    }\n  } else {\n    // Standard: full 14-digit Luhn\n    if (!luhnValidate(v)) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"SIRET fails Luhn check\",\n      );\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, 6)} ${v.slice(6, 9)} ${v.slice(9)}`;\n};\n\n/** Generate a random valid French SIRET. */\nconst generate = (): string => {\n  const sp = randomDigits(8);\n  const sc = luhnChecksum(sp + \"0\");\n  const siren = sp + String((10 - sc) % 10);\n  const nic = randomDigits(4);\n  const payload = siren + nic;\n  const cs = luhnChecksum(payload + \"0\");\n  return payload + String((10 - cs) % 10);\n};\n\n/** French Establishment Identification Number. */\nconst siret: CountryValidator<\"FR\"> = {\n  name: \"French Establishment ID\",\n  localName:\n    \"Système d'Identification du Répertoire des Établissements\",\n  abbreviation: \"SIRET\",\n  aliases: [\"SIRET\", \"numéro SIRET\"] as const,\n  candidatePattern: \"\\\\d{3}\\\\s?\\\\d{3}\\\\s?\\\\d{3}\\\\s?\\\\d{5}\",\n  scope: \"country\",\n  country: \"FR\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.insee.fr/fr/information/2549588\",\n  examples: [\"73282932000074\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default siret;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AAyBA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;;;;;;AAOpB,MAAM,aAAa,MACjB,EAAE,WAAW,WAAW,KAAK,MAAM;AAErC,MAAM,YAAY,MAAsB;CACtC,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,EAAE,QAAQ,KAC5B,OAAO,OAAO,EAAE,EAAE;CAEpB,OAAO;AACT;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,iCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,gCACF;CAKF,IAAI,CAAC,aADS,EAAE,MAAM,GAAG,CACH,CAAC,KAAK,CAAC,UAAU,CAAC,GACtC,OAAO,IACL,oBACA,mCACF;CAIF,IAAI,UAAU,CAAC;MACT,SAAS,CAAC,IAAI,MAAM,GACtB,OAAO,IACL,oBACA,uCACF;CAAA,OAIF,IAAI,CAAC,aAAa,CAAC,GACjB,OAAO,IACL,oBACA,wBACF;CAIJ,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,OAAO,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC;AACxE;;AAGA,MAAM,iBAAyB;CAC7B,MAAM,KAAK,aAAa,CAAC;CACzB,MAAM,KAAK,aAAa,KAAK,GAAG;CAGhC,MAAM,UAFQ,KAAK,QAAQ,KAAK,MAAM,EAAE,IAC5B,aAAa,CACC;CAC1B,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,gBAAgB;CAC3B;CACA;CACA;CACA;AACF"}

package/dist/fr/tva.d.ts

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

package/dist/fr/tva.js

@@ -1,20 +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/tva.ts
-/**
-* n° TVA (Numéro de TVA intracommunautaire).
-*
-* French VAT number. 11 characters: 2-char
-* check prefix + 9-digit SIREN. The prefix
-* can be numeric (old style) or alphanumeric
-* (new style, letters from a restricted
-* alphabet excluding I and O).
-*
-* @see https://www.economie.gouv.fr/
-*/
 const ALPHABET = "0123456789ABCDEFGHJKLMNPQRSTUVWXYZ";
 const compact = (value) => {
 	let v = clean(value, " -.");
@@ -65,6 +54,7 @@ const tva = {
 		"FR VAT"
 	],
 	candidatePattern: "FR[A-Z0-9]{2}\\d{9}",
+	scope: "country",
 	country: "FR",
 	entityType: "company",
 	sourceUrl: "https://www.economie.gouv.fr/",

package/dist/fr/tva.js.map

@@ -1 +1 @@
-{"version":3,"file":"tva.js","names":[],"sources":["../../src/fr/tva.ts"],"sourcesContent":["/**\n * n° TVA (Numéro de TVA intracommunautaire).\n *\n * French VAT number. 11 characters: 2-char\n * check prefix + 9-digit SIREN. The prefix\n * can be numeric (old style) or alphanumeric\n * (new style, letters from a restricted\n * alphabet excluding I and O).\n *\n * @see https://www.economie.gouv.fr/\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 ALPHABET = \"0123456789ABCDEFGHJKLMNPQRSTUVWXYZ\";\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -.\");\n  if (v.startsWith(\"FR\") || v.startsWith(\"fr\")) {\n    v = v.slice(2);\n  }\n  return v.toUpperCase();\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"French TVA must be 11 characters\",\n    );\n  }\n\n  const prefix = v.slice(0, 2);\n  const siren = v.slice(2);\n\n  if (!isdigits(siren)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French TVA SIREN part must be digits\",\n    );\n  }\n\n  // Validate prefix characters are in alphabet\n  const p0 = prefix[0] ?? \"\";\n  const p1 = prefix[1] ?? \"\";\n  if (\n    ALPHABET.indexOf(p0) < 0 ||\n    ALPHABET.indexOf(p1) < 0\n  ) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French TVA prefix contains invalid chars\",\n    );\n  }\n\n  // SIREN validation (skip Monaco: starts with 000)\n  if (!siren.startsWith(\"000\") && !luhnValidate(siren)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"French TVA SIREN part fails Luhn check\",\n    );\n  }\n\n  const c0 = ALPHABET.indexOf(p0);\n  const c1 = ALPHABET.indexOf(p1);\n\n  if (c0 < 10 && c1 < 10) {\n    // Old-style: both digits numeric\n    const check = Number(prefix);\n    const expected = Number(siren + \"12\") % 97;\n    if (check !== expected) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"French TVA check digits mismatch\",\n      );\n    }\n  } else {\n    // New-style: at least one letter\n    let cvalue: number;\n    if (c0 < 10) {\n      cvalue = c0 * 24 + c1 - 10;\n    } else {\n      cvalue = c0 * 34 + c1 - 100;\n    }\n    const sirenNum = Number(siren);\n    if (\n      (sirenNum + 1 + Math.floor(cvalue / 11)) % 11 !==\n      cvalue % 11\n    ) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"French TVA check digits mismatch\",\n      );\n    }\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `FR${compact(value)}`;\n\n/** Generate a random valid French TVA. */\nconst generate = (): string => {\n  const sp = randomDigits(8);\n  const cs = luhnChecksum(sp + \"0\");\n  const siren = sp + String((10 - cs) % 10);\n  const prefix = String(\n    (12 + 3 * (Number(siren) % 97)) % 97,\n  ).padStart(2, \"0\");\n  return prefix + siren;\n};\n\n/** French VAT Number. */\nconst tva: Validator = {\n  name: \"French VAT Number\",\n  localName: \"Numéro de TVA intracommunautaire\",\n  abbreviation: \"TVA\",\n  aliases: [\n    \"numéro de TVA\",\n    \"TVA intracommunautaire\",\n    \"FR VAT\",\n  ] as const,\n  candidatePattern: \"FR[A-Z0-9]{2}\\\\d{9}\",\n  country: \"FR\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.economie.gouv.fr/\",\n  examples: [\"40303265045\", \"K7399859412\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default tva;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;AAuBA,MAAM,WAAW;AAEjB,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,MAAM;AAC3B,KAAI,EAAE,WAAW,KAAK,IAAI,EAAE,WAAW,KAAK,CAC1C,KAAI,EAAE,MAAM,EAAE;AAEhB,QAAO,EAAE,aAAa;;AAGxB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,mCACD;CAGH,MAAM,SAAS,EAAE,MAAM,GAAG,EAAE;CAC5B,MAAM,QAAQ,EAAE,MAAM,EAAE;AAExB,KAAI,CAAC,SAAS,MAAM,CAClB,QAAO,IACL,kBACA,uCACD;CAIH,MAAM,KAAK,OAAO,MAAM;CACxB,MAAM,KAAK,OAAO,MAAM;AACxB,KACE,SAAS,QAAQ,GAAG,GAAG,KACvB,SAAS,QAAQ,GAAG,GAAG,EAEvB,QAAO,IACL,kBACA,2CACD;AAIH,KAAI,CAAC,MAAM,WAAW,MAAM,IAAI,CAAC,aAAa,MAAM,CAClD,QAAO,IACL,oBACA,yCACD;CAGH,MAAM,KAAK,SAAS,QAAQ,GAAG;CAC/B,MAAM,KAAK,SAAS,QAAQ,GAAG;AAE/B,KAAI,KAAK,MAAM,KAAK;MAEJ,OAAO,OAAO,KACX,OAAO,QAAQ,KAAK,GAAG,GAEtC,QAAO,IACL,oBACA,mCACD;QAEE;EAEL,IAAI;AACJ,MAAI,KAAK,GACP,UAAS,KAAK,KAAK,KAAK;MAExB,UAAS,KAAK,KAAK,KAAK;AAG1B,OADiB,OAAO,MAAM,GAEhB,IAAI,KAAK,MAAM,SAAS,GAAG,IAAI,OAC3C,SAAS,GAET,QAAO,IACL,oBACA,mCACD;;AAIL,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UACd,KAAK,QAAQ,MAAM;;AAGrB,MAAM,iBAAyB;CAC7B,MAAM,KAAK,aAAa,EAAE;CAC1B,MAAM,KAAK,aAAa,KAAK,IAAI;CACjC,MAAM,QAAQ,KAAK,QAAQ,KAAK,MAAM,GAAG;AAIzC,QAHe,QACZ,KAAK,KAAK,OAAO,MAAM,GAAG,OAAO,GACnC,CAAC,SAAS,GAAG,IAAI,GACF;;;AAIlB,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,cAAc;CACxC;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"tva.js","names":[],"sources":["../../src/fr/tva.ts"],"sourcesContent":["/**\n * n° TVA (Numéro de TVA intracommunautaire).\n *\n * French VAT number. 11 characters: 2-char\n * check prefix + 9-digit SIREN. The prefix\n * can be numeric (old style) or alphanumeric\n * (new style, letters from a restricted\n * alphabet excluding I and O).\n *\n * @see https://www.economie.gouv.fr/\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 ALPHABET = \"0123456789ABCDEFGHJKLMNPQRSTUVWXYZ\";\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -.\");\n  if (v.startsWith(\"FR\") || v.startsWith(\"fr\")) {\n    v = v.slice(2);\n  }\n  return v.toUpperCase();\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"French TVA must be 11 characters\",\n    );\n  }\n\n  const prefix = v.slice(0, 2);\n  const siren = v.slice(2);\n\n  if (!isdigits(siren)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French TVA SIREN part must be digits\",\n    );\n  }\n\n  // Validate prefix characters are in alphabet\n  const p0 = prefix[0] ?? \"\";\n  const p1 = prefix[1] ?? \"\";\n  if (\n    ALPHABET.indexOf(p0) < 0 ||\n    ALPHABET.indexOf(p1) < 0\n  ) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French TVA prefix contains invalid chars\",\n    );\n  }\n\n  // SIREN validation (skip Monaco: starts with 000)\n  if (!siren.startsWith(\"000\") && !luhnValidate(siren)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"French TVA SIREN part fails Luhn check\",\n    );\n  }\n\n  const c0 = ALPHABET.indexOf(p0);\n  const c1 = ALPHABET.indexOf(p1);\n\n  if (c0 < 10 && c1 < 10) {\n    // Old-style: both digits numeric\n    const check = Number(prefix);\n    const expected = Number(siren + \"12\") % 97;\n    if (check !== expected) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"French TVA check digits mismatch\",\n      );\n    }\n  } else {\n    // New-style: at least one letter\n    let cvalue: number;\n    if (c0 < 10) {\n      cvalue = c0 * 24 + c1 - 10;\n    } else {\n      cvalue = c0 * 34 + c1 - 100;\n    }\n    const sirenNum = Number(siren);\n    if (\n      (sirenNum + 1 + Math.floor(cvalue / 11)) % 11 !==\n      cvalue % 11\n    ) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"French TVA check digits mismatch\",\n      );\n    }\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `FR${compact(value)}`;\n\n/** Generate a random valid French TVA. */\nconst generate = (): string => {\n  const sp = randomDigits(8);\n  const cs = luhnChecksum(sp + \"0\");\n  const siren = sp + String((10 - cs) % 10);\n  const prefix = String(\n    (12 + 3 * (Number(siren) % 97)) % 97,\n  ).padStart(2, \"0\");\n  return prefix + siren;\n};\n\n/** French VAT Number. */\nconst tva: CountryValidator<\"FR\"> = {\n  name: \"French VAT Number\",\n  localName: \"Numéro de TVA intracommunautaire\",\n  abbreviation: \"TVA\",\n  aliases: [\n    \"numéro de TVA\",\n    \"TVA intracommunautaire\",\n    \"FR VAT\",\n  ] as const,\n  candidatePattern: \"FR[A-Z0-9]{2}\\\\d{9}\",\n  scope: \"country\",\n  country: \"FR\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.economie.gouv.fr/\",\n  examples: [\"40303265045\", \"K7399859412\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default tva;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AA0BA,MAAM,WAAW;AAEjB,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,KAAK;CAC1B,IAAI,EAAE,WAAW,IAAI,KAAK,EAAE,WAAW,IAAI,GACzC,IAAI,EAAE,MAAM,CAAC;CAEf,OAAO,EAAE,YAAY;AACvB;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,kCACF;CAGF,MAAM,SAAS,EAAE,MAAM,GAAG,CAAC;CAC3B,MAAM,QAAQ,EAAE,MAAM,CAAC;CAEvB,IAAI,CAAC,SAAS,KAAK,GACjB,OAAO,IACL,kBACA,sCACF;CAIF,MAAM,KAAK,OAAO,MAAM;CACxB,MAAM,KAAK,OAAO,MAAM;CACxB,IACE,SAAS,QAAQ,EAAE,IAAI,KACvB,SAAS,QAAQ,EAAE,IAAI,GAEvB,OAAO,IACL,kBACA,0CACF;CAIF,IAAI,CAAC,MAAM,WAAW,KAAK,KAAK,CAAC,aAAa,KAAK,GACjD,OAAO,IACL,oBACA,wCACF;CAGF,MAAM,KAAK,SAAS,QAAQ,EAAE;CAC9B,MAAM,KAAK,SAAS,QAAQ,EAAE;CAE9B,IAAI,KAAK,MAAM,KAAK;MAEJ,OAAO,MAEb,MADS,OAAO,QAAQ,IAAI,IAAI,IAEtC,OAAO,IACL,oBACA,kCACF;CAAA,OAEG;EAEL,IAAI;EACJ,IAAI,KAAK,IACP,SAAS,KAAK,KAAK,KAAK;OAExB,SAAS,KAAK,KAAK,KAAK;EAG1B,KADiB,OAAO,KAEd,IAAI,IAAI,KAAK,MAAM,SAAS,EAAE,KAAK,OAC3C,SAAS,IAET,OAAO,IACL,oBACA,kCACF;CAEJ;CAEA,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UACd,KAAK,QAAQ,KAAK;;AAGpB,MAAM,iBAAyB;CAC7B,MAAM,KAAK,aAAa,CAAC;CACzB,MAAM,KAAK,aAAa,KAAK,GAAG;CAChC,MAAM,QAAQ,KAAK,QAAQ,KAAK,MAAM,EAAE;CAIxC,OAHe,QACZ,KAAK,KAAK,OAAO,KAAK,IAAI,OAAO,EACpC,EAAE,SAAS,GAAG,GACF,IAAI;AAClB;;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,aAAa;CACvC;CACA;CACA;CACA;AACF"}