@stll/stdnum 1.0.0 → 2.0.1

package/dist/il/idnr.d.ts

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

package/dist/il/idnr.js

@@ -1,17 +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/il/idnr.ts
-/**
-* Identity Number (Mispar Zehut, מספר זהות).
-*
-* Israeli personal identity number. 9 digits
-* (zero-padded) with a Luhn checksum.
-*
-* @see https://en.wikipedia.org/wiki/Israeli_identity_card
-*/
 const compact = (value) => clean(value, " -").padStart(9, "0");
 const validate = (value) => {
 	const v = compact(value);
@@ -44,6 +36,7 @@ const idnr = {
 		"ID number"
 	],
 	candidatePattern: "\\d{9}",
+	scope: "country",
 	country: "IL",
 	entityType: "person",
 	compact,

package/dist/il/idnr.js.map

@@ -1 +1 @@
-{"version":3,"file":"idnr.js","names":[],"sources":["../../src/il/idnr.ts"],"sourcesContent":["/**\n * Identity Number (Mispar Zehut, מספר זהות).\n *\n * Israeli personal identity number. 9 digits\n * (zero-padded) with a Luhn checksum.\n *\n * @see https://en.wikipedia.org/wiki/Israeli_identity_card\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, \" -\").padStart(9, \"0\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length > 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Israeli ID must be at most 9 digits\",\n    );\n  }\n  if (!isdigits(v) || Number(v) === 0) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Israeli ID must contain only digits\" +\n        \" and not be zero\",\n    );\n  }\n  if (!luhnValidate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Israeli ID Luhn check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, -1)}-${v.slice(-1)}`;\n};\n\n/** Generate a random valid Israeli ID number. */\nconst generate = (): string => {\n  const payload = randomDigits(8);\n  const cs = luhnChecksum(payload + \"0\");\n  return payload + String((10 - cs) % 10);\n};\n\n/** Israeli Identity Number (Mispar Zehut). */\nconst idnr: Validator = {\n  name: \"Israeli Identity Number\",\n  localName: \"מספר זהות\",\n  abbreviation: \"ת.ז.\",\n  aliases: [\n    \"תעודת זהות\",\n    \"Teudat Zehut\",\n    \"ID number\",\n  ] as const,\n  candidatePattern: \"\\\\d{9}\",\n  country: \"IL\",\n  entityType: \"person\",\n  compact,\n  format,\n  validate,\n  description:\n    \"Israeli personal identification number\" +\n    \" (Mispar Zehut)\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Israeli_identity_card\",\n  lengths: [9] as const,\n  examples: [\"039337423\", \"000000018\"] as const,\n  generate,\n};\n\nexport default idnr;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;AAoBA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,SAAS,GAAG,IAAI;AAErC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,SAAS,EACb,QAAO,IACL,kBACA,sCACD;AAEH,KAAI,CAAC,SAAS,EAAE,IAAI,OAAO,EAAE,KAAK,EAChC,QAAO,IACL,kBACA,sDAED;AAEH,KAAI,CAAC,aAAa,EAAE,CAClB,QAAO,IACL,oBACA,uCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QAAO,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG;;;AAIzC,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,EAAE;CAC/B,MAAM,KAAK,aAAa,UAAU,IAAI;AACtC,QAAO,UAAU,QAAQ,KAAK,MAAM,GAAG;;;AAIzC,MAAM,OAAkB;CACtB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ;CACA;CACA;CACA,aACE;CAEF,WACE;CACF,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,aAAa,YAAY;CACpC;CACD"}
+{"version":3,"file":"idnr.js","names":[],"sources":["../../src/il/idnr.ts"],"sourcesContent":["/**\n * Identity Number (Mispar Zehut, מספר זהות).\n *\n * Israeli personal identity number. 9 digits\n * (zero-padded) with a Luhn checksum.\n *\n * @see https://en.wikipedia.org/wiki/Israeli_identity_card\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, \" -\").padStart(9, \"0\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length > 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Israeli ID must be at most 9 digits\",\n    );\n  }\n  if (!isdigits(v) || Number(v) === 0) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Israeli ID must contain only digits\" +\n        \" and not be zero\",\n    );\n  }\n  if (!luhnValidate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Israeli ID Luhn check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, -1)}-${v.slice(-1)}`;\n};\n\n/** Generate a random valid Israeli ID number. */\nconst generate = (): string => {\n  const payload = randomDigits(8);\n  const cs = luhnChecksum(payload + \"0\");\n  return payload + String((10 - cs) % 10);\n};\n\n/** Israeli Identity Number (Mispar Zehut). */\nconst idnr: CountryValidator<\"IL\"> = {\n  name: \"Israeli Identity Number\",\n  localName: \"מספר זהות\",\n  abbreviation: \"ת.ז.\",\n  aliases: [\n    \"תעודת זהות\",\n    \"Teudat Zehut\",\n    \"ID number\",\n  ] as const,\n  candidatePattern: \"\\\\d{9}\",\n  scope: \"country\",\n  country: \"IL\",\n  entityType: \"person\",\n  compact,\n  format,\n  validate,\n  description:\n    \"Israeli personal identification number\" +\n    \" (Mispar Zehut)\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Israeli_identity_card\",\n  lengths: [9] as const,\n  examples: [\"039337423\", \"000000018\"] as const,\n  generate,\n};\n\nexport default idnr;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AAuBA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI,EAAE,SAAS,GAAG,GAAG;AAEpC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,SAAS,GACb,OAAO,IACL,kBACA,qCACF;CAEF,IAAI,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,MAAM,GAChC,OAAO,IACL,kBACA,qDAEF;CAEF,IAAI,CAAC,aAAa,CAAC,GACjB,OAAO,IACL,oBACA,sCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,OAAO,GAAG,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;AACxC;;AAGA,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,CAAC;CAC9B,MAAM,KAAK,aAAa,UAAU,GAAG;CACrC,OAAO,UAAU,QAAQ,KAAK,MAAM,EAAE;AACxC;;AAGA,MAAM,OAA+B;CACnC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;CACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ;CACA;CACA;CACA,aACE;CAEF,WACE;CACF,SAAS,CAAC,CAAC;CACX,UAAU,CAAC,aAAa,WAAW;CACnC;AACF"}

package/dist/in/aadhaar.d.ts

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

package/dist/in/aadhaar.js

@@ -1,20 +1,9 @@
+import { verhoeffCheckDigit, verhoeffValidate } from "../_checksums/verhoeff.js";
 import { clean } from "../_util/clean.js";
 import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
-import { verhoeffCheckDigit, verhoeffValidate } from "../_checksums/verhoeff.js";
 //#region src/in/aadhaar.ts
-/**
-* Aadhaar (Indian unique identity number).
-*
-* 12 digits with Verhoeff checksum (last digit).
-* Cannot start with 0 or 1.
-* Issued by the Unique Identification Authority
-* of India (UIDAI).
-*
-* @see https://en.wikipedia.org/wiki/Aadhaar
-* @see https://uidai.gov.in/
-*/
 const compact = (value) => clean(value, " -");
 const validate = (value) => {
 	const v = compact(value);
@@ -44,6 +33,7 @@ const aadhaar = {
 	abbreviation: "Aadhaar",
 	aliases: ["Aadhaar", "आधार"],
 	candidatePattern: "\\d{4}\\s?\\d{4}\\s?\\d{4}",
+	scope: "country",
 	country: "IN",
 	entityType: "person",
 	lengths: [12],

package/dist/in/aadhaar.js.map

@@ -1 +1 @@
-{"version":3,"file":"aadhaar.js","names":[],"sources":["../../src/in/aadhaar.ts"],"sourcesContent":["/**\n * Aadhaar (Indian unique identity number).\n *\n * 12 digits with Verhoeff checksum (last digit).\n * Cannot start with 0 or 1.\n * Issued by the Unique Identification Authority\n * of India (UIDAI).\n *\n * @see https://en.wikipedia.org/wiki/Aadhaar\n * @see https://uidai.gov.in/\n */\n\nimport {\n  verhoeffValidate,\n  verhoeffCheckDigit,\n} from \"#checksums/verhoeff\";\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 !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Aadhaar must be 12 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Aadhaar must contain only digits\",\n    );\n  }\n  if (v[0] === \"0\" || v[0] === \"1\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Aadhaar cannot start with 0 or 1\",\n    );\n  }\n  // Aadhaar cannot be a palindrome\n  if (v === v.split(\"\").reverse().join(\"\")) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Aadhaar cannot be a palindrome\",\n    );\n  }\n  if (!verhoeffValidate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Aadhaar 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, 4)} ${v.slice(4, 8)} ${v.slice(8)}`;\n};\n\n/** Generate a random valid Aadhaar number. */\nconst generate = (): string => {\n  const first = String(randomInt(2, 9));\n  const payload = first + randomDigits(10);\n  return payload + String(verhoeffCheckDigit(payload));\n};\n\n/** Indian Unique Identity Number. */\nconst aadhaar: Validator = {\n  name: \"Indian Unique Identity Number\",\n  localName: \"Aadhaar\",\n  abbreviation: \"Aadhaar\",\n  aliases: [\"Aadhaar\", \"आधार\"] as const,\n  candidatePattern: \"\\\\d{4}\\\\s?\\\\d{4}\\\\s?\\\\d{4}\",\n  country: \"IN\",\n  entityType: \"person\",\n  lengths: [12],\n  examples: [\"234123412346\", \"295274982189\"],\n  description:\n    \"12-digit unique identity number issued by UIDAI\",\n  sourceUrl: \"https://uidai.gov.in/\",\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default aadhaar;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;AAuBA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,4BACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,mCACD;AAEH,KAAI,EAAE,OAAO,OAAO,EAAE,OAAO,IAC3B,QAAO,IACL,qBACA,mCACD;AAGH,KAAI,MAAM,EAAE,MAAM,GAAG,CAAC,SAAS,CAAC,KAAK,GAAG,CACtC,QAAO,IACL,kBACA,iCACD;AAEH,KAAI,CAAC,iBAAiB,EAAE,CACtB,QAAO,IACL,oBACA,+BACD;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;CAE7B,MAAM,UADQ,OAAO,UAAU,GAAG,EAAE,CAAC,GACb,aAAa,GAAG;AACxC,QAAO,UAAU,OAAO,mBAAmB,QAAQ,CAAC;;;AAItD,MAAM,UAAqB;CACzB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,WAAW,OAAO;CAC5B,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,gBAAgB,eAAe;CAC1C,aACE;CACF,WAAW;CACX;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"aadhaar.js","names":[],"sources":["../../src/in/aadhaar.ts"],"sourcesContent":["/**\n * Aadhaar (Indian unique identity number).\n *\n * 12 digits with Verhoeff checksum (last digit).\n * Cannot start with 0 or 1.\n * Issued by the Unique Identification Authority\n * of India (UIDAI).\n *\n * @see https://en.wikipedia.org/wiki/Aadhaar\n * @see https://uidai.gov.in/\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport {\n  verhoeffValidate,\n  verhoeffCheckDigit,\n} from \"#checksums/verhoeff\";\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 !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Aadhaar must be 12 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Aadhaar must contain only digits\",\n    );\n  }\n  if (v[0] === \"0\" || v[0] === \"1\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Aadhaar cannot start with 0 or 1\",\n    );\n  }\n  // Aadhaar cannot be a palindrome\n  if (v === v.split(\"\").reverse().join(\"\")) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Aadhaar cannot be a palindrome\",\n    );\n  }\n  if (!verhoeffValidate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Aadhaar 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, 4)} ${v.slice(4, 8)} ${v.slice(8)}`;\n};\n\n/** Generate a random valid Aadhaar number. */\nconst generate = (): string => {\n  const first = String(randomInt(2, 9));\n  const payload = first + randomDigits(10);\n  return payload + String(verhoeffCheckDigit(payload));\n};\n\n/** Indian Unique Identity Number. */\nconst aadhaar: CountryValidator<\"IN\"> = {\n  name: \"Indian Unique Identity Number\",\n  localName: \"Aadhaar\",\n  abbreviation: \"Aadhaar\",\n  aliases: [\"Aadhaar\", \"आधार\"] as const,\n  candidatePattern: \"\\\\d{4}\\\\s?\\\\d{4}\\\\s?\\\\d{4}\",\n  scope: \"country\",\n  country: \"IN\",\n  entityType: \"person\",\n  lengths: [12],\n  examples: [\"234123412346\", \"295274982189\"],\n  description:\n    \"12-digit unique identity number issued by UIDAI\",\n  sourceUrl: \"https://uidai.gov.in/\",\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default aadhaar;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AA0BA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;AAEnB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,2BACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,kCACF;CAEF,IAAI,EAAE,OAAO,OAAO,EAAE,OAAO,KAC3B,OAAO,IACL,qBACA,kCACF;CAGF,IAAI,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,GACrC,OAAO,IACL,kBACA,gCACF;CAEF,IAAI,CAAC,iBAAiB,CAAC,GACrB,OAAO,IACL,oBACA,8BACF;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;CAE7B,MAAM,UADQ,OAAO,UAAU,GAAG,CAAC,CACf,IAAI,aAAa,EAAE;CACvC,OAAO,UAAU,OAAO,mBAAmB,OAAO,CAAC;AACrD;;AAGA,MAAM,UAAkC;CACtC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,WAAW,MAAM;CAC3B,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,gBAAgB,cAAc;CACzC,aACE;CACF,WAAW;CACX;CACA;CACA;CACA;AACF"}

package/dist/in/gstin.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/in/gstin.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid GSTIN. */
 declare const generate: () => string;
 /** Indian Goods and Services Tax ID. */
-declare const gstin: Validator;
+declare const gstin: CountryValidator<"IN">;
 //#endregion
 export { compact, gstin as default, format, generate, validate };
 //# sourceMappingURL=gstin.d.ts.map

package/dist/in/gstin.js

@@ -3,16 +3,6 @@ import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { charValue } from "../_util/strings.js";
 //#region src/in/gstin.ts
-/**
-* GSTIN (Goods and Services Tax Identification
-* Number, India).
-*
-* 15 characters: 2-digit state code + 10-char PAN +
-* 1 entity number (1-9, A-Z) + "Z" + 1 check digit.
-* Check digit uses the Luhn mod 36 algorithm.
-*
-* @see https://en.wikipedia.org/wiki/Goods_and_Services_Tax_Identification_Number
-*/
 const GSTIN_RE = /^[0-9]{2}[A-Z]{5}[0-9]{4}[A-Z][0-9A-Z]Z[0-9A-Z]$/;
 /** Valid Indian state/UT codes: 01-37. */
 const VALID_STATE_CODES = new Set([
@@ -115,6 +105,7 @@ const gstin = {
 	abbreviation: "GSTIN",
 	aliases: ["GSTIN", "GST number"],
 	candidatePattern: "\\d{2}[A-Z]{5}\\d{4}[A-Z][A-Z\\d][Z][A-Z\\d]",
+	scope: "country",
 	country: "IN",
 	entityType: "company",
 	lengths: [15],

package/dist/in/gstin.js.map

@@ -1 +1 @@
-{"version":3,"file":"gstin.js","names":[],"sources":["../../src/in/gstin.ts"],"sourcesContent":["/**\n * GSTIN (Goods and Services Tax Identification\n * Number, India).\n *\n * 15 characters: 2-digit state code + 10-char PAN +\n * 1 entity number (1-9, A-Z) + \"Z\" + 1 check digit.\n * Check digit uses the Luhn mod 36 algorithm.\n *\n * @see https://en.wikipedia.org/wiki/Goods_and_Services_Tax_Identification_Number\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { charValue } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst GSTIN_RE =\n  /^[0-9]{2}[A-Z]{5}[0-9]{4}[A-Z][0-9A-Z]Z[0-9A-Z]$/;\n\n/** Valid Indian state/UT codes: 01-37. */\nconst VALID_STATE_CODES = new Set([\n  \"01\",\n  \"02\",\n  \"03\",\n  \"04\",\n  \"05\",\n  \"06\",\n  \"07\",\n  \"08\",\n  \"09\",\n  \"10\",\n  \"11\",\n  \"12\",\n  \"13\",\n  \"14\",\n  \"15\",\n  \"16\",\n  \"17\",\n  \"18\",\n  \"19\",\n  \"20\",\n  \"21\",\n  \"22\",\n  \"23\",\n  \"24\",\n  \"25\",\n  \"26\",\n  \"27\",\n  \"28\",\n  \"29\",\n  \"30\",\n  \"31\",\n  \"32\",\n  \"33\",\n  \"34\",\n  \"35\",\n  \"36\",\n  \"37\",\n]);\n\nconst BASE = 36;\n\n/**\n * Luhn mod 36 checksum over the full GSTIN.\n * Returns 0 for a valid number.\n */\nconst luhn36Checksum = (value: string): number => {\n  let sum = 0;\n  let double = false;\n  for (let i = value.length - 1; i >= 0; i--) {\n    const ch = value[i];\n    if (ch === undefined) continue;\n    let v = charValue(ch);\n    if (double) {\n      v *= 2;\n      sum += Math.floor(v / BASE) + (v % BASE);\n    } else {\n      sum += v;\n    }\n    double = !double;\n  }\n  return sum % BASE;\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 !== 15) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"GSTIN must be 15 characters\",\n    );\n  }\n  if (!GSTIN_RE.test(v)) {\n    return err(\"INVALID_FORMAT\", \"GSTIN format is invalid\");\n  }\n  const stateCode = v.slice(0, 2);\n  if (!VALID_STATE_CODES.has(stateCode)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"GSTIN state code is invalid\",\n    );\n  }\n  if (v[12] === \"0\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"GSTIN entity number cannot be 0\",\n    );\n  }\n  if (luhn36Checksum(v) !== 0) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"GSTIN check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid GSTIN. */\nconst generate = (): string => {\n  for (;;) {\n    const state = String(randomInt(1, 37)).padStart(2, \"0\");\n    let pan = \"\";\n    for (let i = 0; i < 5; i++)\n      pan += String.fromCharCode(65 + randomInt(0, 25));\n    pan +=\n      randomDigits(4) +\n      String.fromCharCode(65 + randomInt(0, 25));\n    const entity = String(randomInt(1, 9));\n    const partial = state + pan + entity + \"Z\";\n    for (let d = 0; d <= 9; d++) {\n      const c = partial + String(d);\n      if (validate(c).valid) return c;\n    }\n    for (let c = 65; c <= 90; c++) {\n      const cand = partial + String.fromCharCode(c);\n      if (validate(cand).valid) return cand;\n    }\n  }\n};\n\n/** Indian Goods and Services Tax ID. */\nconst gstin: Validator = {\n  name: \"Indian Goods and Services Tax ID\",\n  localName: \"Goods and Services Tax Identification Number\",\n  abbreviation: \"GSTIN\",\n  aliases: [\"GSTIN\", \"GST number\"] as const,\n  candidatePattern:\n    \"\\\\d{2}[A-Z]{5}\\\\d{4}[A-Z][A-Z\\\\d][Z][A-Z\\\\d]\",\n  country: \"IN\",\n  entityType: \"company\",\n  lengths: [15],\n  examples: [\"27AAPFU0939F1ZV\", \"29AAGCB7383J1Z4\"],\n  description:\n    \"15-character tax identifier for GST-registered businesses\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Goods_and_Services_Tax_Identification_Number\",\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default gstin;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,MAAM,WACJ;;AAGF,MAAM,oBAAoB,IAAI,IAAI;CAChC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,MAAM,OAAO;;;;;AAMb,MAAM,kBAAkB,UAA0B;CAChD,IAAI,MAAM;CACV,IAAI,SAAS;AACb,MAAK,IAAI,IAAI,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK;EAC1C,MAAM,KAAK,MAAM;AACjB,MAAI,OAAO,KAAA,EAAW;EACtB,IAAI,IAAI,UAAU,GAAG;AACrB,MAAI,QAAQ;AACV,QAAK;AACL,UAAO,KAAK,MAAM,IAAI,KAAK,GAAI,IAAI;QAEnC,QAAO;AAET,WAAS,CAAC;;AAEZ,QAAO,MAAM;;AAGf,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,aAAa;AAElC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,8BACD;AAEH,KAAI,CAAC,SAAS,KAAK,EAAE,CACnB,QAAO,IAAI,kBAAkB,0BAA0B;CAEzD,MAAM,YAAY,EAAE,MAAM,GAAG,EAAE;AAC/B,KAAI,CAAC,kBAAkB,IAAI,UAAU,CACnC,QAAO,IACL,qBACA,8BACD;AAEH,KAAI,EAAE,QAAQ,IACZ,QAAO,IACL,qBACA,kCACD;AAEH,KAAI,eAAe,EAAE,KAAK,EACxB,QAAO,IACL,oBACA,6BACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,QAAQ,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI;EACvD,IAAI,MAAM;AACV,OAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,QAAO,OAAO,aAAa,KAAK,UAAU,GAAG,GAAG,CAAC;AACnD,SACE,aAAa,EAAE,GACf,OAAO,aAAa,KAAK,UAAU,GAAG,GAAG,CAAC;EAC5C,MAAM,SAAS,OAAO,UAAU,GAAG,EAAE,CAAC;EACtC,MAAM,UAAU,QAAQ,MAAM,SAAS;AACvC,OAAK,IAAI,IAAI,GAAG,KAAK,GAAG,KAAK;GAC3B,MAAM,IAAI,UAAU,OAAO,EAAE;AAC7B,OAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;AAEhC,OAAK,IAAI,IAAI,IAAI,KAAK,IAAI,KAAK;GAC7B,MAAM,OAAO,UAAU,OAAO,aAAa,EAAE;AAC7C,OAAI,SAAS,KAAK,CAAC,MAAO,QAAO;;;;;AAMvC,MAAM,QAAmB;CACvB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,SAAS,aAAa;CAChC,kBACE;CACF,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,mBAAmB,kBAAkB;CAChD,aACE;CACF,WACE;CACF;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"gstin.js","names":[],"sources":["../../src/in/gstin.ts"],"sourcesContent":["/**\n * GSTIN (Goods and Services Tax Identification\n * Number, India).\n *\n * 15 characters: 2-digit state code + 10-char PAN +\n * 1 entity number (1-9, A-Z) + \"Z\" + 1 check digit.\n * Check digit uses the Luhn mod 36 algorithm.\n *\n * @see https://en.wikipedia.org/wiki/Goods_and_Services_Tax_Identification_Number\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 { charValue } from \"#util/strings\";\n\nconst GSTIN_RE =\n  /^[0-9]{2}[A-Z]{5}[0-9]{4}[A-Z][0-9A-Z]Z[0-9A-Z]$/;\n\n/** Valid Indian state/UT codes: 01-37. */\nconst VALID_STATE_CODES = new Set([\n  \"01\",\n  \"02\",\n  \"03\",\n  \"04\",\n  \"05\",\n  \"06\",\n  \"07\",\n  \"08\",\n  \"09\",\n  \"10\",\n  \"11\",\n  \"12\",\n  \"13\",\n  \"14\",\n  \"15\",\n  \"16\",\n  \"17\",\n  \"18\",\n  \"19\",\n  \"20\",\n  \"21\",\n  \"22\",\n  \"23\",\n  \"24\",\n  \"25\",\n  \"26\",\n  \"27\",\n  \"28\",\n  \"29\",\n  \"30\",\n  \"31\",\n  \"32\",\n  \"33\",\n  \"34\",\n  \"35\",\n  \"36\",\n  \"37\",\n]);\n\nconst BASE = 36;\n\n/**\n * Luhn mod 36 checksum over the full GSTIN.\n * Returns 0 for a valid number.\n */\nconst luhn36Checksum = (value: string): number => {\n  let sum = 0;\n  let double = false;\n  for (let i = value.length - 1; i >= 0; i--) {\n    const ch = value[i];\n    if (ch === undefined) continue;\n    let v = charValue(ch);\n    if (double) {\n      v *= 2;\n      sum += Math.floor(v / BASE) + (v % BASE);\n    } else {\n      sum += v;\n    }\n    double = !double;\n  }\n  return sum % BASE;\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 !== 15) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"GSTIN must be 15 characters\",\n    );\n  }\n  if (!GSTIN_RE.test(v)) {\n    return err(\"INVALID_FORMAT\", \"GSTIN format is invalid\");\n  }\n  const stateCode = v.slice(0, 2);\n  if (!VALID_STATE_CODES.has(stateCode)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"GSTIN state code is invalid\",\n    );\n  }\n  if (v[12] === \"0\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"GSTIN entity number cannot be 0\",\n    );\n  }\n  if (luhn36Checksum(v) !== 0) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"GSTIN check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid GSTIN. */\nconst generate = (): string => {\n  for (;;) {\n    const state = String(randomInt(1, 37)).padStart(2, \"0\");\n    let pan = \"\";\n    for (let i = 0; i < 5; i++)\n      pan += String.fromCharCode(65 + randomInt(0, 25));\n    pan +=\n      randomDigits(4) +\n      String.fromCharCode(65 + randomInt(0, 25));\n    const entity = String(randomInt(1, 9));\n    const partial = state + pan + entity + \"Z\";\n    for (let d = 0; d <= 9; d++) {\n      const c = partial + String(d);\n      if (validate(c).valid) return c;\n    }\n    for (let c = 65; c <= 90; c++) {\n      const cand = partial + String.fromCharCode(c);\n      if (validate(cand).valid) return cand;\n    }\n  }\n};\n\n/** Indian Goods and Services Tax ID. */\nconst gstin: CountryValidator<\"IN\"> = {\n  name: \"Indian Goods and Services Tax ID\",\n  localName: \"Goods and Services Tax Identification Number\",\n  abbreviation: \"GSTIN\",\n  aliases: [\"GSTIN\", \"GST number\"] as const,\n  candidatePattern:\n    \"\\\\d{2}[A-Z]{5}\\\\d{4}[A-Z][A-Z\\\\d][Z][A-Z\\\\d]\",\n  scope: \"country\",\n  country: \"IN\",\n  entityType: \"company\",\n  lengths: [15],\n  examples: [\"27AAPFU0939F1ZV\", \"29AAGCB7383J1Z4\"],\n  description:\n    \"15-character tax identifier for GST-registered businesses\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Goods_and_Services_Tax_Identification_Number\",\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default gstin;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AAqBA,MAAM,WACJ;;AAGF,MAAM,oBAAoB,IAAI,IAAI;CAChC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,MAAM,OAAO;;;;;AAMb,MAAM,kBAAkB,UAA0B;CAChD,IAAI,MAAM;CACV,IAAI,SAAS;CACb,KAAK,IAAI,IAAI,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK;EAC1C,MAAM,KAAK,MAAM;EACjB,IAAI,OAAO,KAAA,GAAW;EACtB,IAAI,IAAI,UAAU,EAAE;EACpB,IAAI,QAAQ;GACV,KAAK;GACL,OAAO,KAAK,MAAM,IAAI,IAAI,IAAK,IAAI;EACrC,OACE,OAAO;EAET,SAAS,CAAC;CACZ;CACA,OAAO,MAAM;AACf;AAEA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI,EAAE,YAAY;AAEjC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,6BACF;CAEF,IAAI,CAAC,SAAS,KAAK,CAAC,GAClB,OAAO,IAAI,kBAAkB,yBAAyB;CAExD,MAAM,YAAY,EAAE,MAAM,GAAG,CAAC;CAC9B,IAAI,CAAC,kBAAkB,IAAI,SAAS,GAClC,OAAO,IACL,qBACA,6BACF;CAEF,IAAI,EAAE,QAAQ,KACZ,OAAO,IACL,qBACA,iCACF;CAEF,IAAI,eAAe,CAAC,MAAM,GACxB,OAAO,IACL,oBACA,4BACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,iBAAyB;CAC7B,SAAS;EACP,MAAM,QAAQ,OAAO,UAAU,GAAG,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;EACtD,IAAI,MAAM;EACV,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KACrB,OAAO,OAAO,aAAa,KAAK,UAAU,GAAG,EAAE,CAAC;EAClD,OACE,aAAa,CAAC,IACd,OAAO,aAAa,KAAK,UAAU,GAAG,EAAE,CAAC;EAC3C,MAAM,SAAS,OAAO,UAAU,GAAG,CAAC,CAAC;EACrC,MAAM,UAAU,QAAQ,MAAM,SAAS;EACvC,KAAK,IAAI,IAAI,GAAG,KAAK,GAAG,KAAK;GAC3B,MAAM,IAAI,UAAU,OAAO,CAAC;GAC5B,IAAI,SAAS,CAAC,EAAE,OAAO,OAAO;EAChC;EACA,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,KAAK;GAC7B,MAAM,OAAO,UAAU,OAAO,aAAa,CAAC;GAC5C,IAAI,SAAS,IAAI,EAAE,OAAO,OAAO;EACnC;CACF;AACF;;AAGA,MAAM,QAAgC;CACpC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,SAAS,YAAY;CAC/B,kBACE;CACF,OAAO;CACP,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,mBAAmB,iBAAiB;CAC/C,aACE;CACF,WACE;CACF;CACA;CACA;CACA;AACF"}

package/dist/in/pan.d.ts

@@ -1,13 +1,26 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/in/pan.d.ts
 /** Generate a random valid Indian PAN. */
 declare const generate: () => string;
+/**
+ * PAN (Permanent Account Number, Indian tax ID).
+ *
+ * 10 characters: 5 letters + 4 digits + 1 letter.
+ * The 4th letter encodes the holder type
+ * (P=person, C=company, H=HUF, A=AOP, B=BOI,
+ * G=government, J=AJP, L=local authority, F=FOP,
+ * T=trust). The 5th letter is the first letter
+ * of the surname or entity name.
+ * No checksum; format validation only.
+ *
+ * @see https://en.wikipedia.org/wiki/Permanent_account_number
+ */
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** Indian Permanent Account Number. */
-declare const pan: Validator;
+declare const pan: CountryValidator<"IN">;
 //#endregion
 export { compact, pan as default, format, generate, validate };
 //# sourceMappingURL=pan.d.ts.map

package/dist/in/pan.js

@@ -2,19 +2,6 @@ import { clean } from "../_util/clean.js";
 import { randomChar, randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 //#region src/in/pan.ts
-/**
-* PAN (Permanent Account Number, Indian tax ID).
-*
-* 10 characters: 5 letters + 4 digits + 1 letter.
-* The 4th letter encodes the holder type
-* (P=person, C=company, H=HUF, A=AOP, B=BOI,
-* G=government, J=AJP, L=local authority, F=FOP,
-* T=trust). The 5th letter is the first letter
-* of the surname or entity name.
-* No checksum; format validation only.
-*
-* @see https://en.wikipedia.org/wiki/Permanent_account_number
-*/
 /** Generate a random valid Indian PAN. */
 const generate = () => {
 	const randomLetter = () => String.fromCodePoint(65 + randomInt(0, 25));
@@ -41,6 +28,7 @@ const pan = {
 	abbreviation: "PAN",
 	aliases: ["PAN", "Permanent Account Number"],
 	candidatePattern: "[A-Z]{5}\\d{4}[A-Z]",
+	scope: "country",
 	country: "IN",
 	entityType: "any",
 	lengths: [10],

package/dist/in/pan.js.map

@@ -1 +1 @@
-{"version":3,"file":"pan.js","names":[],"sources":["../../src/in/pan.ts"],"sourcesContent":["/** Generate a random valid Indian PAN. */\nconst generate = (): string => {\n  const randomLetter = (): string =>\n    String.fromCodePoint(65 + randomInt(0, 25));\n  const first3 =\n    randomLetter() + randomLetter() + randomLetter();\n  const holderType = randomChar(HOLDER_TYPES);\n  const fifth = randomLetter();\n  const digits = randomDigits(4);\n  const last = randomLetter();\n  return `${first3}${holderType}${fifth}${digits}${last}`;\n};\n\n/**\n * PAN (Permanent Account Number, Indian tax ID).\n *\n * 10 characters: 5 letters + 4 digits + 1 letter.\n * The 4th letter encodes the holder type\n * (P=person, C=company, H=HUF, A=AOP, B=BOI,\n * G=government, J=AJP, L=local authority, F=FOP,\n * T=trust). The 5th letter is the first letter\n * of the surname or entity name.\n * No checksum; format validation only.\n *\n * @see https://en.wikipedia.org/wiki/Permanent_account_number\n */\n\nimport { clean } from \"#util/clean\";\nimport {\n  randomChar,\n  randomDigits,\n  randomInt,\n} from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst PAN_RE = /^[A-Z]{5}\\d{4}[A-Z]$/;\n\nconst HOLDER_TYPES = \"ABCFGHJLPT\";\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 !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"PAN must be 10 characters\",\n    );\n  }\n  if (!PAN_RE.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"PAN must be 5 letters + 4 digits + 1 letter\",\n    );\n  }\n  // SAFETY: regex above guarantees v.length === 10.\n  // eslint-disable-next-line no-non-null-assertion\n  if (!HOLDER_TYPES.includes(v[3]!)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"PAN 4th character must be a valid holder type\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Indian Permanent Account Number. */\nconst pan: Validator = {\n  name: \"Indian Permanent Account Number\",\n  localName: \"Permanent Account Number\",\n  abbreviation: \"PAN\",\n  aliases: [\"PAN\", \"Permanent Account Number\"] as const,\n  candidatePattern: \"[A-Z]{5}\\\\d{4}[A-Z]\",\n  country: \"IN\",\n  entityType: \"any\",\n  lengths: [10],\n  examples: [\"ABCPP1234C\", \"AAACR5055K\"],\n  description: \"10-character alphanumeric tax identifier\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Permanent_account_number\",\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default pan;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;AACA,MAAM,iBAAyB;CAC7B,MAAM,qBACJ,OAAO,cAAc,KAAK,UAAU,GAAG,GAAG,CAAC;AAO7C,QAAO,GALL,cAAc,GAAG,cAAc,GAAG,cAAc,GAC/B,WAAW,aAAa,GAC7B,cAAc,GACb,aAAa,EAAE,GACjB,cAAc;;AA4B7B,MAAM,SAAS;AAEf,MAAM,eAAe;AAErB,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,aAAa;AAElC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,4BACD;AAEH,KAAI,CAAC,OAAO,KAAK,EAAE,CACjB,QAAO,IACL,kBACA,8CACD;AAIH,KAAI,CAAC,aAAa,SAAS,EAAE,GAAI,CAC/B,QAAO,IACL,qBACA,gDACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,2BAA2B;CAC5C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,cAAc,aAAa;CACtC,aAAa;CACb,WACE;CACF;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"pan.js","names":[],"sources":["../../src/in/pan.ts"],"sourcesContent":["/** Generate a random valid Indian PAN. */\nconst generate = (): string => {\n  const randomLetter = (): string =>\n    String.fromCodePoint(65 + randomInt(0, 25));\n  const first3 =\n    randomLetter() + randomLetter() + randomLetter();\n  const holderType = randomChar(HOLDER_TYPES);\n  const fifth = randomLetter();\n  const digits = randomDigits(4);\n  const last = randomLetter();\n  return `${first3}${holderType}${fifth}${digits}${last}`;\n};\n\n/**\n * PAN (Permanent Account Number, Indian tax ID).\n *\n * 10 characters: 5 letters + 4 digits + 1 letter.\n * The 4th letter encodes the holder type\n * (P=person, C=company, H=HUF, A=AOP, B=BOI,\n * G=government, J=AJP, L=local authority, F=FOP,\n * T=trust). The 5th letter is the first letter\n * of the surname or entity name.\n * No checksum; format validation only.\n *\n * @see https://en.wikipedia.org/wiki/Permanent_account_number\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport {\n  randomChar,\n  randomDigits,\n  randomInt,\n} from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nconst PAN_RE = /^[A-Z]{5}\\d{4}[A-Z]$/;\n\nconst HOLDER_TYPES = \"ABCFGHJLPT\";\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 !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"PAN must be 10 characters\",\n    );\n  }\n  if (!PAN_RE.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"PAN must be 5 letters + 4 digits + 1 letter\",\n    );\n  }\n  // SAFETY: regex above guarantees v.length === 10.\n  // eslint-disable-next-line no-non-null-assertion\n  if (!HOLDER_TYPES.includes(v[3]!)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"PAN 4th character must be a valid holder type\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Indian Permanent Account Number. */\nconst pan: CountryValidator<\"IN\"> = {\n  name: \"Indian Permanent Account Number\",\n  localName: \"Permanent Account Number\",\n  abbreviation: \"PAN\",\n  aliases: [\"PAN\", \"Permanent Account Number\"] as const,\n  candidatePattern: \"[A-Z]{5}\\\\d{4}[A-Z]\",\n  scope: \"country\",\n  country: \"IN\",\n  entityType: \"any\",\n  lengths: [10],\n  examples: [\"ABCPP1234C\", \"AAACR5055K\"],\n  description: \"10-character alphanumeric tax identifier\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Permanent_account_number\",\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default pan;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AACA,MAAM,iBAAyB;CAC7B,MAAM,qBACJ,OAAO,cAAc,KAAK,UAAU,GAAG,EAAE,CAAC;CAO5C,OAAO,GALL,aAAa,IAAI,aAAa,IAAI,aAAa,IAC9B,WAAW,YAIF,IAHd,aAGsB,IAFrB,aAAa,CAEiB,IADhC,aACuC;AACtD;AA6BA,MAAM,SAAS;AAEf,MAAM,eAAe;AAErB,MAAM,WAAW,UACf,MAAM,OAAO,IAAI,EAAE,YAAY;AAEjC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,2BACF;CAEF,IAAI,CAAC,OAAO,KAAK,CAAC,GAChB,OAAO,IACL,kBACA,6CACF;CAIF,IAAI,CAAC,aAAa,SAAS,EAAE,EAAG,GAC9B,OAAO,IACL,qBACA,+CACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,0BAA0B;CAC3C,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,cAAc,YAAY;CACrC,aAAa;CACb,WACE;CACF;CACA;CACA;CACA;AACF"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { CountryCode, ErrorCode, ParsableValidator, ParsedBirthDate, ParsedIdentifier, ParsedPersonId, StdnumError, ValidateResult, Validator } from "./types.js";
+import { CountryCode, CountryValidator, ErrorCode, GlobalValidator, ParsableValidator, ParsedBirthDate, ParsedIdentifier, ParsedPersonId, StdnumError, ValidateResult, Validator, ValidatorScope } from "./types.js";
 import { mod_d_exports } from "./ad/mod.js";
 import { mod_d_exports as mod_d_exports$1 } from "./ae/mod.js";
 import { mod_d_exports as mod_d_exports$2 } from "./ai/mod.js";
@@ -102,4 +102,4 @@ import { mod_d_exports as mod_d_exports$93 } from "./uy/mod.js";
 import { mod_d_exports as mod_d_exports$94 } from "./ve/mod.js";
 import { mod_d_exports as mod_d_exports$95 } from "./vn/mod.js";
 import { mod_d_exports as mod_d_exports$96 } from "./za/mod.js";
-export { type CardNetwork, type CountryCode, type ErrorCode, type ParsableValidator, type ParsedBirthDate, type ParsedIdentifier, type ParsedPersonId, type StdnumError, type ValidateResult, type Validator, mod_d_exports as ad, mod_d_exports$1 as ae, mod_d_exports$2 as ai, mod_d_exports$3 as al, mod_d_exports$4 as am, mod_d_exports$5 as ar, mod_d_exports$6 as at, mod_d_exports$7 as au, mod_d_exports$8 as az, mod_d_exports$9 as ba, mod_d_exports$10 as bd, mod_d_exports$11 as be, mod_d_exports$12 as bg, mod_d_exports$13 as bh, bic, mod_d_exports$14 as br, mod_d_exports$15 as by, mod_d_exports$16 as bz, mod_d_exports$17 as ca, mod_d_exports$18 as ch, mod_d_exports$19 as cl, mod_d_exports$20 as cn, mod_d_exports$21 as co, mod_d_exports$22 as cr, creditCard as creditcard, mod_d_exports$23 as cu, mod_d_exports$24 as cy, mod_d_exports$25 as cz, mod_d_exports$26 as de, detectNetwork, mod_d_exports$27 as dk, mod_d_exports$28 as do_, mod_d_exports$29 as ec, mod_d_exports$30 as ee, mod_d_exports$31 as eg, mod_d_exports$32 as es, mod_d_exports$33 as eu, mod_d_exports$34 as fi, mod_d_exports$35 as fr, mod_d_exports$36 as gb, mod_d_exports$37 as ge, mod_d_exports$38 as gh, mod_d_exports$39 as gr, mod_d_exports$40 as gt, mod_d_exports$41 as hk, mod_d_exports$42 as hr, mod_d_exports$43 as hu, iban, mod_d_exports$44 as id, mod_d_exports$45 as ie, mod_d_exports$46 as il, mod_d_exports$47 as in_, mod_d_exports$48 as iq, mod_d_exports$49 as ir, mod_d_exports$50 as is_, isin, mod_d_exports$51 as it, mod_d_exports$52 as jp, mod_d_exports$53 as kr, mod_d_exports$54 as kw, mod_d_exports$55 as kz, lei, mod_d_exports$56 as li, mod_d_exports$57 as lk, mod_d_exports$58 as lt, mod_d_exports$59 as lu, luhn, mod_d_exports$60 as lv, mod_d_exports$61 as ma, mod_d_exports$62 as mc, mod_d_exports$63 as md, mod_d_exports$64 as me, mod_d_exports$65 as mk, mod_d_exports$66 as mt, mod_d_exports$67 as mu, mod_d_exports$68 as mx, mod_d_exports$69 as my, mod_d_exports$70 as ng, mod_d_exports$71 as ni, mod_d_exports$72 as nl, mod_d_exports$73 as no, mod_d_exports$74 as nz, mod_d_exports$75 as pa, mod_d_exports$76 as pe, mod_d_exports$77 as ph, mod_d_exports$78 as pk, mod_d_exports$79 as pl, mod_d_exports$80 as pt, mod_d_exports$81 as ro, mod_d_exports$82 as rs, mod_d_exports$83 as ru, mod_d_exports$84 as se, mod_d_exports$85 as sg, mod_d_exports$86 as si, mod_d_exports$87 as sk, mod_d_exports$88 as th, mod_d_exports$89 as tr, mod_d_exports$90 as tw, mod_d_exports$91 as ua, mod_d_exports$92 as us, mod_d_exports$93 as uy, mod_d_exports$94 as ve, mod_d_exports$95 as vn, mod_d_exports$96 as za };
+export { type CardNetwork, type CountryCode, type CountryValidator, type ErrorCode, type GlobalValidator, type ParsableValidator, type ParsedBirthDate, type ParsedIdentifier, type ParsedPersonId, type StdnumError, type ValidateResult, type Validator, type ValidatorScope, mod_d_exports as ad, mod_d_exports$1 as ae, mod_d_exports$2 as ai, mod_d_exports$3 as al, mod_d_exports$4 as am, mod_d_exports$5 as ar, mod_d_exports$6 as at, mod_d_exports$7 as au, mod_d_exports$8 as az, mod_d_exports$9 as ba, mod_d_exports$10 as bd, mod_d_exports$11 as be, mod_d_exports$12 as bg, mod_d_exports$13 as bh, bic, mod_d_exports$14 as br, mod_d_exports$15 as by, mod_d_exports$16 as bz, mod_d_exports$17 as ca, mod_d_exports$18 as ch, mod_d_exports$19 as cl, mod_d_exports$20 as cn, mod_d_exports$21 as co, mod_d_exports$22 as cr, creditCard as creditcard, mod_d_exports$23 as cu, mod_d_exports$24 as cy, mod_d_exports$25 as cz, mod_d_exports$26 as de, detectNetwork, mod_d_exports$27 as dk, mod_d_exports$28 as do_, mod_d_exports$29 as ec, mod_d_exports$30 as ee, mod_d_exports$31 as eg, mod_d_exports$32 as es, mod_d_exports$33 as eu, mod_d_exports$34 as fi, mod_d_exports$35 as fr, mod_d_exports$36 as gb, mod_d_exports$37 as ge, mod_d_exports$38 as gh, mod_d_exports$39 as gr, mod_d_exports$40 as gt, mod_d_exports$41 as hk, mod_d_exports$42 as hr, mod_d_exports$43 as hu, iban, mod_d_exports$44 as id, mod_d_exports$45 as ie, mod_d_exports$46 as il, mod_d_exports$47 as in_, mod_d_exports$48 as iq, mod_d_exports$49 as ir, mod_d_exports$50 as is_, isin, mod_d_exports$51 as it, mod_d_exports$52 as jp, mod_d_exports$53 as kr, mod_d_exports$54 as kw, mod_d_exports$55 as kz, lei, mod_d_exports$56 as li, mod_d_exports$57 as lk, mod_d_exports$58 as lt, mod_d_exports$59 as lu, luhn, mod_d_exports$60 as lv, mod_d_exports$61 as ma, mod_d_exports$62 as mc, mod_d_exports$63 as md, mod_d_exports$64 as me, mod_d_exports$65 as mk, mod_d_exports$66 as mt, mod_d_exports$67 as mu, mod_d_exports$68 as mx, mod_d_exports$69 as my, mod_d_exports$70 as ng, mod_d_exports$71 as ni, mod_d_exports$72 as nl, mod_d_exports$73 as no, mod_d_exports$74 as nz, mod_d_exports$75 as pa, mod_d_exports$76 as pe, mod_d_exports$77 as ph, mod_d_exports$78 as pk, mod_d_exports$79 as pl, mod_d_exports$80 as pt, mod_d_exports$81 as ro, mod_d_exports$82 as rs, mod_d_exports$83 as ru, mod_d_exports$84 as se, mod_d_exports$85 as sg, mod_d_exports$86 as si, mod_d_exports$87 as sk, mod_d_exports$88 as th, mod_d_exports$89 as tr, mod_d_exports$90 as tw, mod_d_exports$91 as ua, mod_d_exports$92 as us, mod_d_exports$93 as uy, mod_d_exports$94 as ve, mod_d_exports$95 as vn, mod_d_exports$96 as za };

package/dist/index.js

@@ -1,9 +1,3 @@
-import bic from "./bic.js";
-import creditCard, { detectNetwork } from "./creditcard.js";
-import iban from "./iban.js";
-import isin from "./isin.js";
-import lei from "./lei.js";
-import luhn from "./luhn.js";
 import { ad_exports } from "./ad/mod.js";
 import { ae_exports } from "./ae/mod.js";
 import { ai_exports } from "./ai/mod.js";
@@ -18,6 +12,7 @@ import { bd_exports } from "./bd/mod.js";
 import { be_exports } from "./be/mod.js";
 import { bg_exports } from "./bg/mod.js";
 import { bh_exports } from "./bh/mod.js";
+import bic from "./bic.js";
 import { br_exports } from "./br/mod.js";
 import { by_exports } from "./by/mod.js";
 import { bz_exports } from "./bz/mod.js";
@@ -27,6 +22,7 @@ import { cl_exports } from "./cl/mod.js";
 import { cn_exports } from "./cn/mod.js";
 import { co_exports } from "./co/mod.js";
 import { cr_exports } from "./cr/mod.js";
+import creditCard, { detectNetwork } from "./creditcard.js";
 import { cu_exports } from "./cu/mod.js";
 import { cy_exports } from "./cy/mod.js";
 import { cz_exports } from "./cz/mod.js";
@@ -48,10 +44,14 @@ import { gt_exports } from "./gt/mod.js";
 import { hk_exports } from "./hk/mod.js";
 import { hr_exports } from "./hr/mod.js";
 import { hu_exports } from "./hu/mod.js";
+import iban from "./iban.js";
 import { id_exports } from "./id/mod.js";
 import { ie_exports } from "./ie/mod.js";
 import { il_exports } from "./il/mod.js";
 import { in_exports } from "./in/mod.js";
+import isin from "./isin.js";
+import lei from "./lei.js";
+import luhn from "./luhn.js";
 import { iq_exports } from "./iq/mod.js";
 import { ir_exports } from "./ir/mod.js";
 import { is_exports } from "./is/mod.js";

package/dist/iq/nid.d.ts

@@ -1,14 +1,28 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/iq/nid.d.ts
 /** Generate a random valid Iraqi NID. */
 declare const generate: () => string;
+/**
+ * NID (Iraqi National ID, البطاقة الوطنية الموحدة).
+ *
+ * 12-digit personal identification number on the
+ * Iraqi National Card (Unified National Card), issued
+ * by the Ministry of Interior since 2016.
+ *
+ * No public checksum algorithm is documented.
+ * Validation is limited to format: exactly 12 decimal
+ * digits. Accepts both Arabic-Indic (U+066x) and
+ * Extended Arabic-Indic (U+06Fx) digits.
+ *
+ * @see https://mofa.gov.iq/the-civil-status-id/
+ */
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 /** Iraqi NIDs are displayed without separators. */
 declare const format: (value: string) => string;
 /** Iraqi National Identification Number. */
-declare const nid: Validator;
+declare const nid: CountryValidator<"IQ">;
 //#endregion
 export { compact, nid as default, format, generate, validate };
 //# sourceMappingURL=nid.d.ts.map

package/dist/iq/nid.js

@@ -1,23 +1,9 @@
+import { normalizeArabicDigits } from "../_util/arabic.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 { normalizeArabicDigits } from "../_util/arabic.js";
 //#region src/iq/nid.ts
-/**
-* NID (Iraqi National ID, البطاقة الوطنية الموحدة).
-*
-* 12-digit personal identification number on the
-* Iraqi National Card (Unified National Card), issued
-* by the Ministry of Interior since 2016.
-*
-* No public checksum algorithm is documented.
-* Validation is limited to format: exactly 12 decimal
-* digits. Accepts both Arabic-Indic (U+066x) and
-* Extended Arabic-Indic (U+06Fx) digits.
-*
-* @see https://mofa.gov.iq/the-civil-status-id/
-*/
 /** Generate a random valid Iraqi NID. */
 const generate = () => randomDigits(12);
 const compact = (value) => normalizeArabicDigits(clean(value, " -./"));
@@ -39,6 +25,7 @@ const nid = {
 	abbreviation: "NID",
 	aliases: ["NID", "البطاقة الوطنية الموحدة"],
 	candidatePattern: "\\d{12}",
+	scope: "country",
 	country: "IQ",
 	entityType: "person",
 	sourceUrl: "https://mofa.gov.iq/the-civil-status-id/",

package/dist/iq/nid.js.map

@@ -1 +1 @@
-{"version":3,"file":"nid.js","names":[],"sources":["../../src/iq/nid.ts"],"sourcesContent":["/** Generate a random valid Iraqi NID. */\nconst generate = (): string => randomDigits(12);\n\n/**\n * NID (Iraqi National ID, البطاقة الوطنية الموحدة).\n *\n * 12-digit personal identification number on the\n * Iraqi National Card (Unified National Card), issued\n * by the Ministry of Interior since 2016.\n *\n * No public checksum algorithm is documented.\n * Validation is limited to format: exactly 12 decimal\n * digits. Accepts both Arabic-Indic (U+066x) and\n * Extended Arabic-Indic (U+06Fx) digits.\n *\n * @see https://mofa.gov.iq/the-civil-status-id/\n */\n\nimport { normalizeArabicDigits } from \"#util/arabic\";\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  normalizeArabicDigits(clean(value, \" -./\"));\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Iraqi NID must be exactly 12 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Iraqi NID must contain only digits\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\n/** Iraqi NIDs are displayed without separators. */\nconst format = (value: string): string => compact(value);\n\n/** Iraqi National Identification Number. */\nconst nid: Validator = {\n  name: \"Iraqi National ID\",\n  localName: \"البطاقة الوطنية الموحدة\",\n  abbreviation: \"NID\",\n  aliases: [\"NID\", \"البطاقة الوطنية الموحدة\"] as const,\n  candidatePattern: \"\\\\d{12}\",\n  country: \"IQ\",\n  entityType: \"person\",\n  sourceUrl: \"https://mofa.gov.iq/the-civil-status-id/\",\n  description:\n    \"Iraqi personal identification number (National Card)\",\n  lengths: [12] as const,\n  examples: [\"012345678901\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nid;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AACA,MAAM,iBAAyB,aAAa,GAAG;AAyB/C,MAAM,WAAW,UACf,sBAAsB,MAAM,OAAO,OAAO,CAAC;AAE7C,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,sCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,qCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;;AAIpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,0BAA0B;CAC3C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,aACE;CACF,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,eAAe;CAC1B;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"nid.js","names":[],"sources":["../../src/iq/nid.ts"],"sourcesContent":["/** Generate a random valid Iraqi NID. */\nconst generate = (): string => randomDigits(12);\n\n/**\n * NID (Iraqi National ID, البطاقة الوطنية الموحدة).\n *\n * 12-digit personal identification number on the\n * Iraqi National Card (Unified National Card), issued\n * by the Ministry of Interior since 2016.\n *\n * No public checksum algorithm is documented.\n * Validation is limited to format: exactly 12 decimal\n * digits. Accepts both Arabic-Indic (U+066x) and\n * Extended Arabic-Indic (U+06Fx) digits.\n *\n * @see https://mofa.gov.iq/the-civil-status-id/\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { normalizeArabicDigits } from \"#util/arabic\";\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  normalizeArabicDigits(clean(value, \" -./\"));\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Iraqi NID must be exactly 12 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Iraqi NID must contain only digits\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\n/** Iraqi NIDs are displayed without separators. */\nconst format = (value: string): string => compact(value);\n\n/** Iraqi National Identification Number. */\nconst nid: CountryValidator<\"IQ\"> = {\n  name: \"Iraqi National ID\",\n  localName: \"البطاقة الوطنية الموحدة\",\n  abbreviation: \"NID\",\n  aliases: [\"NID\", \"البطاقة الوطنية الموحدة\"] as const,\n  candidatePattern: \"\\\\d{12}\",\n  scope: \"country\",\n  country: \"IQ\",\n  entityType: \"person\",\n  sourceUrl: \"https://mofa.gov.iq/the-civil-status-id/\",\n  description:\n    \"Iraqi personal identification number (National Card)\",\n  lengths: [12] as const,\n  examples: [\"012345678901\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nid;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;AACA,MAAM,iBAAyB,aAAa,EAAE;AA4B9C,MAAM,WAAW,UACf,sBAAsB,MAAM,OAAO,MAAM,CAAC;AAE5C,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,qCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,oCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;;AAGA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,yBAAyB;CAC1C,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,aACE;CACF,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,cAAc;CACzB;CACA;CACA;CACA;AACF"}

package/dist/ir/nid.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/ir/nid.d.ts
 declare const compact: (value: string) => string;
@@ -11,7 +11,7 @@ declare const format: (value: string) => string;
  */
 declare const generate: () => string;
 /** Iranian National Identification Number. */
-declare const nid: Validator;
+declare const nid: CountryValidator<"IR">;
 //#endregion
 export { compact, nid as default, format, generate, validate };
 //# sourceMappingURL=nid.d.ts.map

package/dist/ir/nid.js

@@ -1,32 +1,9 @@
+import { normalizeArabicDigits } from "../_util/arabic.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 { normalizeArabicDigits } from "../_util/arabic.js";
 //#region src/ir/nid.ts
-/**
-* NID (Iranian National ID, کد ملی, Code Melli).
-*
-* 10-digit personal identification number assigned to
-* every Iranian citizen. Digits 1-3 encode the province,
-* digits 4-9 are a sequential identifier, and digit 10
-* is a check digit.
-*
-* Check digit algorithm (mod 11):
-*   sum = Σ(digit[i] × (10 − i)) for i = 0..8
-*   r   = sum mod 11
-*   if r < 2: check digit = r
-*   if r ≥ 2: check digit = 11 − r
-*
-* Numbers where all digits are identical (e.g.
-* 0000000000, 1111111111) are rejected.
-*
-* Accepts both Persian (Extended Arabic-Indic, U+06Fx)
-* and Arabic-Indic (U+066x) digits.
-*
-* @see https://www.sabteahval.ir/
-* @see https://persian-tools.js.org/functions/verifyIranianNationalId.html
-*/
 /** All-same-digit patterns (0000000000 .. 9999999999). */
 const ALL_SAME = new Set(Array.from({ length: 10 }, (_, i) => String(i).repeat(10)));
 const compact = (value) => normalizeArabicDigits(clean(value, " -./"));
@@ -73,6 +50,7 @@ const nid = {
 		"national code"
 	],
 	candidatePattern: "\\d{10}",
+	scope: "country",
 	country: "IR",
 	entityType: "person",
 	sourceUrl: "https://www.sabteahval.ir/",

package/dist/ir/nid.js.map

@@ -1 +1 @@
-{"version":3,"file":"nid.js","names":[],"sources":["../../src/ir/nid.ts"],"sourcesContent":["/**\n * NID (Iranian National ID, کد ملی, Code Melli).\n *\n * 10-digit personal identification number assigned to\n * every Iranian citizen. Digits 1-3 encode the province,\n * digits 4-9 are a sequential identifier, and digit 10\n * is a check digit.\n *\n * Check digit algorithm (mod 11):\n *   sum = Σ(digit[i] × (10 − i)) for i = 0..8\n *   r   = sum mod 11\n *   if r < 2: check digit = r\n *   if r ≥ 2: check digit = 11 − r\n *\n * Numbers where all digits are identical (e.g.\n * 0000000000, 1111111111) are rejected.\n *\n * Accepts both Persian (Extended Arabic-Indic, U+06Fx)\n * and Arabic-Indic (U+066x) digits.\n *\n * @see https://www.sabteahval.ir/\n * @see https://persian-tools.js.org/functions/verifyIranianNationalId.html\n */\n\nimport { normalizeArabicDigits } from \"#util/arabic\";\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\n/** All-same-digit patterns (0000000000 .. 9999999999). */\nconst ALL_SAME = new Set(\n  Array.from({ length: 10 }, (_, i) =>\n    String(i).repeat(10),\n  ),\n);\n\nconst compact = (value: string): string =>\n  normalizeArabicDigits(clean(value, \" -./\"));\n\n/**\n * Calculate the check digit from the first 9 digits.\n */\nconst calcCheckDigit = (number: string): number => {\n  let sum = 0;\n  for (let i = 0; i < 9; i++) {\n    sum += Number(number[i]) * (10 - i);\n  }\n  const r = sum % 11;\n  return r < 2 ? r : 11 - r;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Iranian NID must be exactly 10 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Iranian NID must contain only digits\",\n    );\n  }\n  if (ALL_SAME.has(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Iranian NID must not have all identical digits\",\n    );\n  }\n  if (calcCheckDigit(v) !== Number(v[9])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Iranian NID check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\n/** Iranian NIDs are displayed without separators. */\nconst format = (value: string): string => compact(value);\n\n/**\n * Generate a random valid Iranian NID.\n * NOT cryptographically secure.\n */\nconst generate = (): string => {\n  const base = randomDigits(9);\n  const check = calcCheckDigit(base);\n  const result = `${base}${check}`;\n  if (ALL_SAME.has(result)) return generate();\n  return result;\n};\n\n/** Iranian National Identification Number. */\nconst nid: Validator = {\n  name: \"Iranian National ID\",\n  localName: \"کد ملی\",\n  abbreviation: \"NID\",\n  aliases: [\"NID\", \"کد ملی\", \"national code\"] as const,\n  candidatePattern: \"\\\\d{10}\",\n  country: \"IR\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.sabteahval.ir/\",\n  description:\n    \"Iranian personal identification number (Code Melli)\",\n  lengths: [10] as const,\n  examples: [\"0932833810\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nid;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,MAAM,WAAW,IAAI,IACnB,MAAM,KAAK,EAAE,QAAQ,IAAI,GAAG,GAAG,MAC7B,OAAO,EAAE,CAAC,OAAO,GAAG,CACrB,CACF;AAED,MAAM,WAAW,UACf,sBAAsB,MAAM,OAAO,OAAO,CAAC;;;;AAK7C,MAAM,kBAAkB,WAA2B;CACjD,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,QAAO,OAAO,OAAO,GAAG,IAAI,KAAK;CAEnC,MAAM,IAAI,MAAM;AAChB,QAAO,IAAI,IAAI,IAAI,KAAK;;AAG1B,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,wCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,uCACD;AAEH,KAAI,SAAS,IAAI,EAAE,CACjB,QAAO,IACL,kBACA,iDACD;AAEH,KAAI,eAAe,EAAE,KAAK,OAAO,EAAE,GAAG,CACpC,QAAO,IACL,oBACA,mCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;;AAIpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;;;;AAMxD,MAAM,iBAAyB;CAC7B,MAAM,OAAO,aAAa,EAAE;CAE5B,MAAM,SAAS,GAAG,OADJ,eAAe,KAAK;AAElC,KAAI,SAAS,IAAI,OAAO,CAAE,QAAO,UAAU;AAC3C,QAAO;;;AAIT,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EAAC;EAAO;EAAU;EAAgB;CAC3C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,aACE;CACF,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,aAAa;CACxB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"nid.js","names":[],"sources":["../../src/ir/nid.ts"],"sourcesContent":["/**\n * NID (Iranian National ID, کد ملی, Code Melli).\n *\n * 10-digit personal identification number assigned to\n * every Iranian citizen. Digits 1-3 encode the province,\n * digits 4-9 are a sequential identifier, and digit 10\n * is a check digit.\n *\n * Check digit algorithm (mod 11):\n *   sum = Σ(digit[i] × (10 − i)) for i = 0..8\n *   r   = sum mod 11\n *   if r < 2: check digit = r\n *   if r ≥ 2: check digit = 11 − r\n *\n * Numbers where all digits are identical (e.g.\n * 0000000000, 1111111111) are rejected.\n *\n * Accepts both Persian (Extended Arabic-Indic, U+06Fx)\n * and Arabic-Indic (U+066x) digits.\n *\n * @see https://www.sabteahval.ir/\n * @see https://persian-tools.js.org/functions/verifyIranianNationalId.html\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { normalizeArabicDigits } from \"#util/arabic\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\n/** All-same-digit patterns (0000000000 .. 9999999999). */\nconst ALL_SAME = new Set(\n  Array.from({ length: 10 }, (_, i) =>\n    String(i).repeat(10),\n  ),\n);\n\nconst compact = (value: string): string =>\n  normalizeArabicDigits(clean(value, \" -./\"));\n\n/**\n * Calculate the check digit from the first 9 digits.\n */\nconst calcCheckDigit = (number: string): number => {\n  let sum = 0;\n  for (let i = 0; i < 9; i++) {\n    sum += Number(number[i]) * (10 - i);\n  }\n  const r = sum % 11;\n  return r < 2 ? r : 11 - r;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Iranian NID must be exactly 10 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Iranian NID must contain only digits\",\n    );\n  }\n  if (ALL_SAME.has(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Iranian NID must not have all identical digits\",\n    );\n  }\n  if (calcCheckDigit(v) !== Number(v[9])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Iranian NID check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\n/** Iranian NIDs are displayed without separators. */\nconst format = (value: string): string => compact(value);\n\n/**\n * Generate a random valid Iranian NID.\n * NOT cryptographically secure.\n */\nconst generate = (): string => {\n  const base = randomDigits(9);\n  const check = calcCheckDigit(base);\n  const result = `${base}${check}`;\n  if (ALL_SAME.has(result)) return generate();\n  return result;\n};\n\n/** Iranian National Identification Number. */\nconst nid: CountryValidator<\"IR\"> = {\n  name: \"Iranian National ID\",\n  localName: \"کد ملی\",\n  abbreviation: \"NID\",\n  aliases: [\"NID\", \"کد ملی\", \"national code\"] as const,\n  candidatePattern: \"\\\\d{10}\",\n  scope: \"country\",\n  country: \"IR\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.sabteahval.ir/\",\n  description:\n    \"Iranian personal identification number (Code Melli)\",\n  lengths: [10] as const,\n  examples: [\"0932833810\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nid;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;AAoCA,MAAM,WAAW,IAAI,IACnB,MAAM,KAAK,EAAE,QAAQ,GAAG,IAAI,GAAG,MAC7B,OAAO,CAAC,EAAE,OAAO,EAAE,CACrB,CACF;AAEA,MAAM,WAAW,UACf,sBAAsB,MAAM,OAAO,MAAM,CAAC;;;;AAK5C,MAAM,kBAAkB,WAA2B;CACjD,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KACrB,OAAO,OAAO,OAAO,EAAE,KAAK,KAAK;CAEnC,MAAM,IAAI,MAAM;CAChB,OAAO,IAAI,IAAI,IAAI,KAAK;AAC1B;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,uCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,sCACF;CAEF,IAAI,SAAS,IAAI,CAAC,GAChB,OAAO,IACL,kBACA,gDACF;CAEF,IAAI,eAAe,CAAC,MAAM,OAAO,EAAE,EAAE,GACnC,OAAO,IACL,oBACA,kCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;;AAGA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;;;;AAMvD,MAAM,iBAAyB;CAC7B,MAAM,OAAO,aAAa,CAAC;CAE3B,MAAM,SAAS,GAAG,OADJ,eAAe,IACA;CAC7B,IAAI,SAAS,IAAI,MAAM,GAAG,OAAO,SAAS;CAC1C,OAAO;AACT;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EAAC;EAAO;EAAU;CAAe;CAC1C,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,aACE;CACF,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;AACF"}

package/dist/is/kennitala.d.ts

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

package/dist/is/kennitala.js

@@ -1,21 +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/is/kennitala.ts
-/**
-* Kennitala (Icelandic identification number).
-*
-* 10 digits: DDMMYY + 2 random + 1 check + 1 century.
-* Weights [3,2,7,6,5,4,3,2] on first 8 digits,
-* check digit at position 9, century at position 10
-* (weight 0, does not participate in checksum).
-* Organizations use day + 40. Century digit: 9 = 1900s,
-* 0 = 2000s.
-*
-* @see https://www.skra.is/
-*/
 const WEIGHTS = [
 	3,
 	2,
@@ -77,6 +65,7 @@ const kennitala = {
 	abbreviation: "kt.",
 	aliases: ["kennitala", "kt."],
 	candidatePattern: "\\d{6}-?\\d{4}",
+	scope: "country",
 	country: "IS",
 	entityType: "any",
 	sourceUrl: "https://www.skra.is/",

package/dist/is/kennitala.js.map

@@ -1 +1 @@
-{"version":3,"file":"kennitala.js","names":[],"sources":["../../src/is/kennitala.ts"],"sourcesContent":["/**\n * Kennitala (Icelandic identification number).\n *\n * 10 digits: DDMMYY + 2 random + 1 check + 1 century.\n * Weights [3,2,7,6,5,4,3,2] on first 8 digits,\n * check digit at position 9, century at position 10\n * (weight 0, does not participate in checksum).\n * Organizations use day + 40. Century digit: 9 = 1900s,\n * 0 = 2000s.\n *\n * @see https://www.skra.is/\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 { ValidateResult, Validator } from \"../types\";\n\nconst WEIGHTS = [3, 2, 7, 6, 5, 4, 3, 2, 0, 0] as const;\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Kennitala must be 10 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Kennitala must contain only digits\",\n    );\n  }\n\n  // Checksum: weights on first 8 digits, check is 9th\n  let sum = 0;\n  for (let i = 0; i < 8; i++) {\n    sum += Number(v.charAt(i)) * (WEIGHTS[i] ?? 0);\n  }\n  const remainder = (11 - (sum % 11)) % 11;\n  if (remainder === 10 || remainder !== Number(v[8])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Kennitala check digit mismatch\",\n    );\n  }\n\n  // Parse date\n  let dd = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const yy = Number(v.slice(4, 6));\n  const centuryDigit = Number(v[9]);\n\n  // Organizations use day + 40\n  if (dd > 40) dd -= 40;\n\n  let century: number;\n  if (centuryDigit === 9) {\n    century = 1900;\n  } else if (centuryDigit === 0) {\n    century = 2000;\n  } else {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Kennitala century digit must be 0 or 9\",\n    );\n  }\n\n  const year = century + yy;\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Kennitala contains an invalid date\",\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, 6)}-${v.slice(6)}`;\n};\n\n/** Generate a random valid Icelandic kennitala. */\nconst generate = (): string => {\n  for (;;) {\n    const dd = String(randomInt(1, 28)).padStart(2, \"0\");\n    const mm = String(randomInt(1, 12)).padStart(2, \"0\");\n    const yy = String(randomInt(50, 99)).padStart(2, \"0\");\n    const rr = String(randomInt(20, 99)).padStart(2, \"0\");\n    const partial = dd + mm + yy + rr;\n    for (let d = 0; d <= 9; d++) {\n      const c = partial + String(d) + \"9\";\n      if (validate(c).valid) return c;\n    }\n  }\n};\n\n/** Icelandic Identification Number. */\nconst kennitala: Validator = {\n  name: \"Icelandic ID Number\",\n  localName: \"Kennitala\",\n  abbreviation: \"kt.\",\n  aliases: [\"kennitala\", \"kt.\"] as const,\n  candidatePattern: \"\\\\d{6}-?\\\\d{4}\",\n  country: \"IS\",\n  entityType: \"any\",\n  sourceUrl: \"https://www.skra.is/\",\n  examples: [\"4504013150\", \"1201743399\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default kennitala;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;AAqBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AAE9C,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,8BACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,qCACD;CAIH,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,QAAO,OAAO,EAAE,OAAO,EAAE,CAAC,IAAI,QAAQ,MAAM;CAE9C,MAAM,aAAa,KAAM,MAAM,MAAO;AACtC,KAAI,cAAc,MAAM,cAAc,OAAO,EAAE,GAAG,CAChD,QAAO,IACL,oBACA,iCACD;CAIH,IAAI,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAC9B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,eAAe,OAAO,EAAE,GAAG;AAGjC,KAAI,KAAK,GAAI,OAAM;CAEnB,IAAI;AACJ,KAAI,iBAAiB,EACnB,WAAU;UACD,iBAAiB,EAC1B,WAAU;KAEV,QAAO,IACL,qBACA,yCACD;AAIH,KAAI,CAAC,YADQ,UAAU,IACA,IAAI,GAAG,CAC5B,QAAO,IACL,qBACA,qCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;;;AAIvC,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,KAAK,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI;EACpD,MAAM,KAAK,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI;EACpD,MAAM,KAAK,OAAO,UAAU,IAAI,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI;EACrD,MAAM,KAAK,OAAO,UAAU,IAAI,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI;EACrD,MAAM,UAAU,KAAK,KAAK,KAAK;AAC/B,OAAK,IAAI,IAAI,GAAG,KAAK,GAAG,KAAK;GAC3B,MAAM,IAAI,UAAU,OAAO,EAAE,GAAG;AAChC,OAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;;AAMpC,MAAM,YAAuB;CAC3B,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,aAAa,MAAM;CAC7B,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,cAAc,aAAa;CACtC;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"kennitala.js","names":[],"sources":["../../src/is/kennitala.ts"],"sourcesContent":["/**\n * Kennitala (Icelandic identification number).\n *\n * 10 digits: DDMMYY + 2 random + 1 check + 1 century.\n * Weights [3,2,7,6,5,4,3,2] on first 8 digits,\n * check digit at position 9, century at position 10\n * (weight 0, does not participate in checksum).\n * Organizations use day + 40. Century digit: 9 = 1900s,\n * 0 = 2000s.\n *\n * @see https://www.skra.is/\n */\n\nimport type {\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 WEIGHTS = [3, 2, 7, 6, 5, 4, 3, 2, 0, 0] as const;\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Kennitala must be 10 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Kennitala must contain only digits\",\n    );\n  }\n\n  // Checksum: weights on first 8 digits, check is 9th\n  let sum = 0;\n  for (let i = 0; i < 8; i++) {\n    sum += Number(v.charAt(i)) * (WEIGHTS[i] ?? 0);\n  }\n  const remainder = (11 - (sum % 11)) % 11;\n  if (remainder === 10 || remainder !== Number(v[8])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Kennitala check digit mismatch\",\n    );\n  }\n\n  // Parse date\n  let dd = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const yy = Number(v.slice(4, 6));\n  const centuryDigit = Number(v[9]);\n\n  // Organizations use day + 40\n  if (dd > 40) dd -= 40;\n\n  let century: number;\n  if (centuryDigit === 9) {\n    century = 1900;\n  } else if (centuryDigit === 0) {\n    century = 2000;\n  } else {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Kennitala century digit must be 0 or 9\",\n    );\n  }\n\n  const year = century + yy;\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Kennitala contains an invalid date\",\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, 6)}-${v.slice(6)}`;\n};\n\n/** Generate a random valid Icelandic kennitala. */\nconst generate = (): string => {\n  for (;;) {\n    const dd = String(randomInt(1, 28)).padStart(2, \"0\");\n    const mm = String(randomInt(1, 12)).padStart(2, \"0\");\n    const yy = String(randomInt(50, 99)).padStart(2, \"0\");\n    const rr = String(randomInt(20, 99)).padStart(2, \"0\");\n    const partial = dd + mm + yy + rr;\n    for (let d = 0; d <= 9; d++) {\n      const c = partial + String(d) + \"9\";\n      if (validate(c).valid) return c;\n    }\n  }\n};\n\n/** Icelandic Identification Number. */\nconst kennitala: CountryValidator<\"IS\"> = {\n  name: \"Icelandic ID Number\",\n  localName: \"Kennitala\",\n  abbreviation: \"kt.\",\n  aliases: [\"kennitala\", \"kt.\"] as const,\n  candidatePattern: \"\\\\d{6}-?\\\\d{4}\",\n  scope: \"country\",\n  country: \"IS\",\n  entityType: \"any\",\n  sourceUrl: \"https://www.skra.is/\",\n  examples: [\"4504013150\", \"1201743399\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default kennitala;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AAwBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;AAE7C,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;AAEnB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,6BACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,oCACF;CAIF,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KACrB,OAAO,OAAO,EAAE,OAAO,CAAC,CAAC,KAAK,QAAQ,MAAM;CAE9C,MAAM,aAAa,KAAM,MAAM,MAAO;CACtC,IAAI,cAAc,MAAM,cAAc,OAAO,EAAE,EAAE,GAC/C,OAAO,IACL,oBACA,gCACF;CAIF,IAAI,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC7B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,eAAe,OAAO,EAAE,EAAE;CAGhC,IAAI,KAAK,IAAI,MAAM;CAEnB,IAAI;CACJ,IAAI,iBAAiB,GACnB,UAAU;MACL,IAAI,iBAAiB,GAC1B,UAAU;MAEV,OAAO,IACL,qBACA,wCACF;CAIF,IAAI,CAAC,YADQ,UAAU,IACA,IAAI,EAAE,GAC3B,OAAO,IACL,qBACA,oCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,OAAO,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC;AACtC;;AAGA,MAAM,iBAAyB;CAC7B,SAAS;EACP,MAAM,KAAK,OAAO,UAAU,GAAG,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;EACnD,MAAM,KAAK,OAAO,UAAU,GAAG,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;EACnD,MAAM,KAAK,OAAO,UAAU,IAAI,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;EACpD,MAAM,KAAK,OAAO,UAAU,IAAI,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;EACpD,MAAM,UAAU,KAAK,KAAK,KAAK;EAC/B,KAAK,IAAI,IAAI,GAAG,KAAK,GAAG,KAAK;GAC3B,MAAM,IAAI,UAAU,OAAO,CAAC,IAAI;GAChC,IAAI,SAAS,CAAC,EAAE,OAAO,OAAO;EAChC;CACF;AACF;;AAGA,MAAM,YAAoC;CACxC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,aAAa,KAAK;CAC5B,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,cAAc,YAAY;CACrC;CACA;CACA;CACA;AACF"}