@stll/stdnum 0.0.1

package/dist/mx/curp.js

@@ -0,0 +1,140 @@
+import { clean } from "../_util/clean.js";
+import { err } from "../_util/result.js";
+import { isValidDate } from "../_util/date.js";
+//#region src/mx/curp.ts
+/**
+* CURP (Clave Única de Registro de Población).
+*
+* Mexican personal identification number. 18 characters:
+* 4 letters (name encoding) + 6 digits (YYMMDD birth
+* date) + 1 letter (gender: H=male, M=female) + 2
+* letters (state code) + 3 consonants (name
+* disambiguation) + 1 digit (century discriminator) +
+* 1 check digit.
+*
+* The check digit is computed as a weighted sum mod 10
+* using an alphabet mapping (0-9, A-N, &, O-Z).
+*
+* @see https://en.wikipedia.org/wiki/CURP
+*/
+/** Valid Mexican state codes (2-letter). */
+const STATE_CODES = new Set([
+	"AS",
+	"BC",
+	"BS",
+	"CC",
+	"CL",
+	"CM",
+	"CS",
+	"CH",
+	"DF",
+	"DG",
+	"GT",
+	"GR",
+	"HG",
+	"JC",
+	"MC",
+	"MN",
+	"MS",
+	"NT",
+	"NL",
+	"OC",
+	"PL",
+	"QT",
+	"QR",
+	"SP",
+	"SL",
+	"SR",
+	"TC",
+	"TS",
+	"TL",
+	"VZ",
+	"YN",
+	"ZS",
+	"NE"
+]);
+/**
+* Alphabet for CURP check digit computation.
+* Matches python-stdnum: digits 0-9, then A-N,
+* ampersand, O-Z.
+*/
+const ALPHABET = "0123456789ABCDEFGHIJKLMN&OPQRSTUVWXYZ";
+const CHAR_MAP = /* @__PURE__ */ new Map();
+for (let i = 0; i < 37; i++) CHAR_MAP.set(ALPHABET[i], i);
+const compact = (value) => clean(value, " -").trim().toUpperCase();
+/**
+* Compute the CURP check digit. Sum each of the first
+* 17 characters multiplied by weight (18 - position),
+* then check = (10 - sum % 10) % 10.
+*/
+const calcCheckDigit = (value) => {
+	let sum = 0;
+	for (let i = 0; i < 17; i++) sum += (CHAR_MAP.get(value[i]) ?? 0) * (18 - i);
+	return String((10 - sum % 10) % 10);
+};
+/**
+* Resolve full year from 2-digit year and century
+* discriminator: 0-9 = 1900s, letter = 2000s.
+*/
+const resolveCurpYear = (yy, centuryChar) => centuryChar >= "0" && centuryChar <= "9" ? 1900 + yy : 2e3 + yy;
+const CURP_RE = /^[A-Z]{4}\d{6}[HM][A-Z]{2}[A-Z]{3}[0-9A-Z]\d$/;
+const validate = (value) => {
+	const v = compact(value);
+	if (v.length !== 18) return err("INVALID_LENGTH", "CURP must be 18 characters");
+	if (!CURP_RE.test(v)) return err("INVALID_FORMAT", "CURP has an invalid format");
+	const yy = Number(v.slice(4, 6));
+	const mm = Number(v.slice(6, 8));
+	const dd = Number(v.slice(8, 10));
+	if (!isValidDate(resolveCurpYear(yy, v[16]), mm, dd)) return err("INVALID_COMPONENT", "CURP contains an invalid birth date");
+	const state = v.slice(11, 13);
+	if (!STATE_CODES.has(state)) return err("INVALID_COMPONENT", "CURP contains an invalid state code");
+	const expected = calcCheckDigit(v);
+	if (v[17] !== expected) return err("INVALID_CHECKSUM", "CURP check digit does not match");
+	return {
+		valid: true,
+		compact: v
+	};
+};
+const format = (value) => compact(value);
+/**
+* Extract birth date and gender from a CURP.
+* Returns null if the value is not valid.
+*/
+const parse = (value) => {
+	const result = validate(value);
+	if (!result.valid) return null;
+	const v = result.compact;
+	const yy = Number(v.slice(4, 6));
+	const mm = Number(v.slice(6, 8));
+	const dd = Number(v.slice(8, 10));
+	const year = resolveCurpYear(yy, v[16]);
+	const gender = v[10] === "H" ? "male" : "female";
+	return {
+		birthDate: new Date(year, mm - 1, dd),
+		gender
+	};
+};
+/**
+* Mexican CURP (personal identification number).
+*
+* Example sourced from python-stdnum test suite.
+*/
+const curp = {
+	name: "Mexican Personal ID",
+	localName: "Clave Única de Registro de Población",
+	abbreviation: "CURP",
+	aliases: ["CURP", "Clave Única de Registro de Población"],
+	candidatePattern: "[A-Z]{4}\\d{6}[HM][A-Z]{5}[A-Z\\d]\\d",
+	country: "MX",
+	entityType: "person",
+	lengths: [18],
+	examples: ["BOXW310820HNERXN09"],
+	compact,
+	format,
+	validate,
+	sourceUrl: "https://en.wikipedia.org/wiki/CURP"
+};
+//#endregion
+export { compact, curp as default, format, parse, validate };
+
+//# sourceMappingURL=curp.js.map

package/dist/mx/curp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"curp.js","names":[],"sources":["../../src/mx/curp.ts"],"sourcesContent":["/**\n * CURP (Clave Única de Registro de Población).\n *\n * Mexican personal identification number. 18 characters:\n * 4 letters (name encoding) + 6 digits (YYMMDD birth\n * date) + 1 letter (gender: H=male, M=female) + 2\n * letters (state code) + 3 consonants (name\n * disambiguation) + 1 digit (century discriminator) +\n * 1 check digit.\n *\n * The check digit is computed as a weighted sum mod 10\n * using an alphabet mapping (0-9, A-N, &, O-Z).\n *\n * @see https://en.wikipedia.org/wiki/CURP\n */\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { err } from \"#util/result\";\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\n/** Valid Mexican state codes (2-letter). */\nconst STATE_CODES = new Set([\n  \"AS\",\n  \"BC\",\n  \"BS\",\n  \"CC\",\n  \"CL\",\n  \"CM\",\n  \"CS\",\n  \"CH\",\n  \"DF\",\n  \"DG\",\n  \"GT\",\n  \"GR\",\n  \"HG\",\n  \"JC\",\n  \"MC\",\n  \"MN\",\n  \"MS\",\n  \"NT\",\n  \"NL\",\n  \"OC\",\n  \"PL\",\n  \"QT\",\n  \"QR\",\n  \"SP\",\n  \"SL\",\n  \"SR\",\n  \"TC\",\n  \"TS\",\n  \"TL\",\n  \"VZ\",\n  \"YN\",\n  \"ZS\",\n  \"NE\", // Born abroad\n]);\n\n/**\n * Alphabet for CURP check digit computation.\n * Matches python-stdnum: digits 0-9, then A-N,\n * ampersand, O-Z.\n */\nconst ALPHABET = \"0123456789ABCDEFGHIJKLMN&OPQRSTUVWXYZ\";\n\nconst CHAR_MAP = new Map<string, number>();\nfor (let i = 0; i < ALPHABET.length; i++) {\n  CHAR_MAP.set(ALPHABET[i]!, i);\n}\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").trim().toUpperCase();\n\n/**\n * Compute the CURP check digit. Sum each of the first\n * 17 characters multiplied by weight (18 - position),\n * then check = (10 - sum % 10) % 10.\n */\nconst calcCheckDigit = (value: string): string => {\n  let sum = 0;\n  for (let i = 0; i < 17; i++) {\n    sum += (CHAR_MAP.get(value[i]!) ?? 0) * (18 - i);\n  }\n  return String((10 - (sum % 10)) % 10);\n};\n\n/**\n * Resolve full year from 2-digit year and century\n * discriminator: 0-9 = 1900s, letter = 2000s.\n */\nconst resolveCurpYear = (\n  yy: number,\n  centuryChar: string,\n): number =>\n  centuryChar >= \"0\" && centuryChar <= \"9\"\n    ? 1900 + yy\n    : 2000 + yy;\n\nconst CURP_RE =\n  /^[A-Z]{4}\\d{6}[HM][A-Z]{2}[A-Z]{3}[0-9A-Z]\\d$/;\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 18) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"CURP must be 18 characters\",\n    );\n  }\n\n  if (!CURP_RE.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"CURP has an invalid format\",\n    );\n  }\n\n  // Validate the embedded date (YYMMDD at positions 4-9).\n  const yy = Number(v.slice(4, 6));\n  const mm = Number(v.slice(6, 8));\n  const dd = Number(v.slice(8, 10));\n\n  const year = resolveCurpYear(yy, v[16]!);\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"CURP contains an invalid birth date\",\n    );\n  }\n\n  // Validate state code at positions 11-12.\n  const state = v.slice(11, 13);\n  if (!STATE_CODES.has(state)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"CURP contains an invalid state code\",\n    );\n  }\n\n  // Verify check digit (last character).\n  const expected = calcCheckDigit(v);\n  if (v[17] !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"CURP check digit 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 CURP.\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 yy = Number(v.slice(4, 6));\n  const mm = Number(v.slice(6, 8));\n  const dd = Number(v.slice(8, 10));\n\n  const year = resolveCurpYear(yy, v[16]!);\n\n  const genderChar = v[10];\n  const gender: \"male\" | \"female\" =\n    genderChar === \"H\" ? \"male\" : \"female\";\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n    gender,\n  };\n};\n\n/**\n * Mexican CURP (personal identification number).\n *\n * Example sourced from python-stdnum test suite.\n */\nconst curp: Validator = {\n  name: \"Mexican Personal ID\",\n  localName: \"Clave Única de Registro de Población\",\n  abbreviation: \"CURP\",\n  aliases: [\n    \"CURP\",\n    \"Clave Única de Registro de Población\",\n  ] as const,\n  candidatePattern: \"[A-Z]{4}\\\\d{6}[HM][A-Z]{5}[A-Z\\\\d]\\\\d\",\n  country: \"MX\",\n  entityType: \"person\",\n  lengths: [18] as const,\n  examples: [\"BOXW310820HNERXN09\"] as const,\n  compact,\n  format,\n  validate,\n  sourceUrl: \"https://en.wikipedia.org/wiki/CURP\",\n};\n\nexport default curp;\nexport { compact, format, parse, validate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA2BA,MAAM,cAAc,IAAI,IAAI;CAC1B;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;;;;;;AAOF,MAAM,WAAW;AAEjB,MAAM,2BAAW,IAAI,KAAqB;AAC1C,KAAK,IAAI,IAAI,GAAG,IAAI,IAAiB,IACnC,UAAS,IAAI,SAAS,IAAK,EAAE;AAG/B,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,MAAM,CAAC,aAAa;;;;;;AAOzC,MAAM,kBAAkB,UAA0B;CAChD,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,IACtB,SAAQ,SAAS,IAAI,MAAM,GAAI,IAAI,MAAM,KAAK;AAEhD,QAAO,QAAQ,KAAM,MAAM,MAAO,GAAG;;;;;;AAOvC,MAAM,mBACJ,IACA,gBAEA,eAAe,OAAO,eAAe,MACjC,OAAO,KACP,MAAO;AAEb,MAAM,UACJ;AAEF,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,6BACD;AAGH,KAAI,CAAC,QAAQ,KAAK,EAAE,CAClB,QAAO,IACL,kBACA,6BACD;CAIH,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC;AAGjC,KAAI,CAAC,YADQ,gBAAgB,IAAI,EAAE,IAAK,EACjB,IAAI,GAAG,CAC5B,QAAO,IACL,qBACA,sCACD;CAIH,MAAM,QAAQ,EAAE,MAAM,IAAI,GAAG;AAC7B,KAAI,CAAC,YAAY,IAAI,MAAM,CACzB,QAAO,IACL,qBACA,sCACD;CAIH,MAAM,WAAW,eAAe,EAAE;AAClC,KAAI,EAAE,QAAQ,SACZ,QAAO,IACL,oBACA,kCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;;;;AAMxD,MAAM,SAAS,UAAyC;CACtD,MAAM,SAAS,SAAS,MAAM;AAC9B,KAAI,CAAC,OAAO,MAAO,QAAO;CAE1B,MAAM,IAAI,OAAO;CACjB,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC;CAEjC,MAAM,OAAO,gBAAgB,IAAI,EAAE,IAAK;CAGxC,MAAM,SADa,EAAE,QAEJ,MAAM,SAAS;AAEhC,QAAO;EACL,WAAW,IAAI,KAAK,MAAM,KAAK,GAAG,GAAG;EACrC;EACD;;;;;;;AAQH,MAAM,OAAkB;CACtB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,QACA,uCACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,qBAAqB;CAChC;CACA;CACA;CACA,WAAW;CACZ"}

package/dist/mx/mod.d.ts

@@ -0,0 +1,10 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import clabe from "./clabe.js";
+import curp from "./curp.js";
+import rfc from "./rfc.js";
+
+//#region src/mx/mod.d.ts
+
+//#endregion
+export { clabe, curp, mod_d_exports, rfc };
+//# sourceMappingURL=mod.d.ts.map

package/dist/mx/mod.js

@@ -0,0 +1,14 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import clabe from "./clabe.js";
+import curp from "./curp.js";
+import rfc from "./rfc.js";
+//#region src/mx/mod.ts
+var mx_exports = /* @__PURE__ */ __exportAll({
+	clabe: () => clabe,
+	curp: () => curp,
+	rfc: () => rfc
+});
+//#endregion
+export { clabe, curp, mx_exports, rfc };
+
+//# sourceMappingURL=mod.js.map

package/dist/mx/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","names":[],"sources":["../../src/mx/mod.ts"],"sourcesContent":["export { default as clabe } from \"./clabe\";\nexport { default as curp } from \"./curp\";\nexport { default as rfc } from \"./rfc\";\n"],"mappings":""}

package/dist/mx/rfc.d.ts

@@ -0,0 +1,16 @@
+import { ValidateResult, Validator } from "../types.js";
+
+//#region src/mx/rfc.d.ts
+
+declare const compact: (value: string) => string;
+declare const validate: (value: string) => ValidateResult;
+declare const format: (value: string) => string;
+/**
+ * Mexican RFC (tax identification number).
+ *
+ * Examples sourced from python-stdnum test suite.
+ */
+declare const rfc: Validator;
+//#endregion
+export { compact, rfc as default, format, validate };
+//# sourceMappingURL=rfc.d.ts.map

package/dist/mx/rfc.js

@@ -0,0 +1,92 @@
+import { clean } from "../_util/clean.js";
+import { err } from "../_util/result.js";
+import { isValidDate } from "../_util/date.js";
+//#region src/mx/rfc.ts
+/**
+* RFC (Registro Federal de Contribuyentes).
+*
+* Mexican tax identification number issued by the SAT
+* (Servicio de Administración Tributaria). The number is
+* 13 characters for individuals (4 letters + 6 digits
+* YYMMDD + 3 alphanumeric) or 12 characters for
+* companies (3 letters + 6 digits YYMMDD + 3
+* alphanumeric). The last character is a check digit
+* computed with a mod 11 algorithm over a specific
+* alphabet mapping.
+*
+* Format: AAAA######XXX (persons, 13 chars)
+*         AAA######XXX  (companies, 12 chars)
+*
+* @see https://en.wikipedia.org/wiki/Tax_Identification_Number_(Mexico)
+*/
+/** Alphabet for RFC check digit computation. */
+const ALPHABET = "0123456789ABCDEFGHIJKLMN&OPQRSTUVWXYZ Ñ";
+const CHAR_MAP = /* @__PURE__ */ new Map();
+for (let i = 0; i < 39; i++) CHAR_MAP.set(ALPHABET[i], i);
+const compact = (value) => clean(value, " -.").trim().toUpperCase();
+/**
+* Compute the RFC check digit using mod 11 with
+* the SAT alphabet mapping.
+*
+* Each character is mapped to its position in the
+* ALPHABET, then multiplied by a weight that starts
+* at (len + 1) and decreases by 1. The check digit
+* is (11 - sum % 11) % 11, mapped to 0-9 or "A".
+*/
+const calcCheckDigit = (value) => {
+	const padded = value.length === 11 ? ` ${value}` : value;
+	let sum = 0;
+	for (let i = 0; i < 12; i++) {
+		const ch = padded[i];
+		const v = CHAR_MAP.get(ch) ?? 0;
+		sum += v * (13 - i);
+	}
+	const remainder = sum % 11;
+	if (remainder === 0) return "0";
+	const digit = 11 - remainder;
+	return digit === 10 ? "A" : String(digit);
+};
+const PERSON_RE = /^[A-ZÑ&]{4}\d{6}[A-Z\d]{3}$/;
+const COMPANY_RE = /^[A-ZÑ&]{3}\d{6}[A-Z\d]{3}$/;
+const validate = (value) => {
+	const v = compact(value);
+	if (v.length !== 12 && v.length !== 13) return err("INVALID_LENGTH", "RFC must be 12 or 13 characters");
+	const isPerson = v.length === 13;
+	if (!(isPerson ? PERSON_RE : COMPANY_RE).test(v)) return err("INVALID_FORMAT", "RFC has an invalid format");
+	const dateOffset = isPerson ? 4 : 3;
+	const yy = Number(v.slice(dateOffset, dateOffset + 2));
+	const mm = Number(v.slice(dateOffset + 2, dateOffset + 4));
+	const dd = Number(v.slice(dateOffset + 4, dateOffset + 6));
+	if (!isValidDate(2e3 + yy, mm, dd)) return err("INVALID_COMPONENT", "RFC contains an invalid date");
+	const expected = calcCheckDigit(v.slice(0, -1));
+	if (v.at(-1) !== expected) return err("INVALID_CHECKSUM", "RFC check digit does not match");
+	return {
+		valid: true,
+		compact: v
+	};
+};
+const format = (value) => compact(value);
+/**
+* Mexican RFC (tax identification number).
+*
+* Examples sourced from python-stdnum test suite.
+*/
+const rfc = {
+	name: "Mexican Tax ID",
+	localName: "Registro Federal de Contribuyentes",
+	abbreviation: "RFC",
+	aliases: ["RFC", "Registro Federal de Contribuyentes"],
+	candidatePattern: "[A-ZÑ&]{3,4}\\d{6}[A-Z\\d]{3}",
+	country: "MX",
+	entityType: "any",
+	lengths: [12, 13],
+	examples: ["GODE561231GR8", "MAB9307148T4"],
+	compact,
+	format,
+	validate,
+	sourceUrl: "https://en.wikipedia.org/wiki/Tax_Identification_Number_(Mexico)"
+};
+//#endregion
+export { compact, rfc as default, format, validate };
+
+//# sourceMappingURL=rfc.js.map

package/dist/mx/rfc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rfc.js","names":[],"sources":["../../src/mx/rfc.ts"],"sourcesContent":["/**\n * RFC (Registro Federal de Contribuyentes).\n *\n * Mexican tax identification number issued by the SAT\n * (Servicio de Administración Tributaria). The number is\n * 13 characters for individuals (4 letters + 6 digits\n * YYMMDD + 3 alphanumeric) or 12 characters for\n * companies (3 letters + 6 digits YYMMDD + 3\n * alphanumeric). The last character is a check digit\n * computed with a mod 11 algorithm over a specific\n * alphabet mapping.\n *\n * Format: AAAA######XXX (persons, 13 chars)\n *         AAA######XXX  (companies, 12 chars)\n *\n * @see https://en.wikipedia.org/wiki/Tax_Identification_Number_(Mexico)\n */\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { err } from \"#util/result\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\n/** Alphabet for RFC check digit computation. */\nconst ALPHABET = \"0123456789ABCDEFGHIJKLMN&OPQRSTUVWXYZ Ñ\";\n\nconst CHAR_MAP = new Map<string, number>();\nfor (let i = 0; i < ALPHABET.length; i++) {\n  CHAR_MAP.set(ALPHABET[i]!, i);\n}\n\nconst compact = (value: string): string =>\n  clean(value, \" -.\").trim().toUpperCase();\n\n/**\n * Compute the RFC check digit using mod 11 with\n * the SAT alphabet mapping.\n *\n * Each character is mapped to its position in the\n * ALPHABET, then multiplied by a weight that starts\n * at (len + 1) and decreases by 1. The check digit\n * is (11 - sum % 11) % 11, mapped to 0-9 or \"A\".\n */\nconst calcCheckDigit = (value: string): string => {\n  // Pad 12-char company RFCs with a leading space\n  // to align weights with the 13-char algorithm.\n  const padded = value.length === 11 ? ` ${value}` : value;\n  let sum = 0;\n  for (let i = 0; i < 12; i++) {\n    const ch = padded[i]!;\n    const v = CHAR_MAP.get(ch) ?? 0;\n    sum += v * (13 - i);\n  }\n  const remainder = sum % 11;\n  if (remainder === 0) return \"0\";\n  const digit = 11 - remainder;\n  return digit === 10 ? \"A\" : String(digit);\n};\n\nconst PERSON_RE = /^[A-ZÑ&]{4}\\d{6}[A-Z\\d]{3}$/;\nconst COMPANY_RE = /^[A-ZÑ&]{3}\\d{6}[A-Z\\d]{3}$/;\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 12 && v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"RFC must be 12 or 13 characters\",\n    );\n  }\n\n  const isPerson = v.length === 13;\n  const re = isPerson ? PERSON_RE : COMPANY_RE;\n  if (!re.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RFC has an invalid format\",\n    );\n  }\n\n  // Validate the embedded date (YYMMDD).\n  const dateOffset = isPerson ? 4 : 3;\n  const yy = Number(v.slice(dateOffset, dateOffset + 2));\n  const mm = Number(\n    v.slice(dateOffset + 2, dateOffset + 4),\n  );\n  const dd = Number(\n    v.slice(dateOffset + 4, dateOffset + 6),\n  );\n\n  // RFC dates use 2-digit years; use 2000 century for\n  // date validation (any valid calendar date is accepted).\n  const year = 2000 + yy;\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RFC contains an invalid date\",\n    );\n  }\n\n  // Verify check digit (last character).\n  const body = v.slice(0, -1);\n  const expected = calcCheckDigit(body);\n  if (v.at(-1) !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RFC check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/**\n * Mexican RFC (tax identification number).\n *\n * Examples sourced from python-stdnum test suite.\n */\nconst rfc: Validator = {\n  name: \"Mexican Tax ID\",\n  localName: \"Registro Federal de Contribuyentes\",\n  abbreviation: \"RFC\",\n  aliases: [\n    \"RFC\",\n    \"Registro Federal de Contribuyentes\",\n  ] as const,\n  candidatePattern: \"[A-ZÑ&]{3,4}\\\\d{6}[A-Z\\\\d]{3}\",\n  country: \"MX\",\n  entityType: \"any\",\n  lengths: [12, 13] as const,\n  examples: [\"GODE561231GR8\", \"MAB9307148T4\"] as const,\n  compact,\n  format,\n  validate,\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Tax_Identification_Number_(Mexico)\",\n};\n\nexport default rfc;\nexport { compact, format, validate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAyBA,MAAM,WAAW;AAEjB,MAAM,2BAAW,IAAI,KAAqB;AAC1C,KAAK,IAAI,IAAI,GAAG,IAAI,IAAiB,IACnC,UAAS,IAAI,SAAS,IAAK,EAAE;AAG/B,MAAM,WAAW,UACf,MAAM,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa;;;;;;;;;;AAW1C,MAAM,kBAAkB,UAA0B;CAGhD,MAAM,SAAS,MAAM,WAAW,KAAK,IAAI,UAAU;CACnD,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;EAC3B,MAAM,KAAK,OAAO;EAClB,MAAM,IAAI,SAAS,IAAI,GAAG,IAAI;AAC9B,SAAO,KAAK,KAAK;;CAEnB,MAAM,YAAY,MAAM;AACxB,KAAI,cAAc,EAAG,QAAO;CAC5B,MAAM,QAAQ,KAAK;AACnB,QAAO,UAAU,KAAK,MAAM,OAAO,MAAM;;AAG3C,MAAM,YAAY;AAClB,MAAM,aAAa;AAEnB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,MAAM,EAAE,WAAW,GAClC,QAAO,IACL,kBACA,kCACD;CAGH,MAAM,WAAW,EAAE,WAAW;AAE9B,KAAI,EADO,WAAW,YAAY,YAC1B,KAAK,EAAE,CACb,QAAO,IACL,kBACA,4BACD;CAIH,MAAM,aAAa,WAAW,IAAI;CAClC,MAAM,KAAK,OAAO,EAAE,MAAM,YAAY,aAAa,EAAE,CAAC;CACtD,MAAM,KAAK,OACT,EAAE,MAAM,aAAa,GAAG,aAAa,EAAE,CACxC;CACD,MAAM,KAAK,OACT,EAAE,MAAM,aAAa,GAAG,aAAa,EAAE,CACxC;AAKD,KAAI,CAAC,YADQ,MAAO,IACG,IAAI,GAAG,CAC5B,QAAO,IACL,qBACA,+BACD;CAKH,MAAM,WAAW,eADJ,EAAE,MAAM,GAAG,GAAG,CACU;AACrC,KAAI,EAAE,GAAG,GAAG,KAAK,SACf,QAAO,IACL,oBACA,iCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;;;;;AAOxD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,OACA,qCACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,IAAI,GAAG;CACjB,UAAU,CAAC,iBAAiB,eAAe;CAC3C;CACA;CACA;CACA,WACE;CACH"}

package/dist/my/mod.d.ts

@@ -0,0 +1,8 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import nric from "./nric.js";
+
+//#region src/my/mod.d.ts
+
+//#endregion
+export { mod_d_exports, nric };
+//# sourceMappingURL=mod.d.ts.map

package/dist/my/mod.js

@@ -0,0 +1,8 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import nric from "./nric.js";
+//#region src/my/mod.ts
+var my_exports = /* @__PURE__ */ __exportAll({ nric: () => nric });
+//#endregion
+export { my_exports, nric };
+
+//# sourceMappingURL=mod.js.map

package/dist/my/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","names":[],"sources":["../../src/my/mod.ts"],"sourcesContent":["export { default as nric } from \"./nric\";\n"],"mappings":""}

package/dist/my/nric.d.ts

@@ -0,0 +1,17 @@
+import { ParsedPersonId, ValidateResult, Validator } from "../types.js";
+
+//#region src/my/nric.d.ts
+
+declare const compact: (value: string) => string;
+declare const validate: (value: string) => ValidateResult;
+declare const format: (value: string) => string;
+/**
+ * Extract birth date and gender from an NRIC.
+ * Returns null if the value is not valid.
+ */
+declare const parse: (value: string) => ParsedPersonId | null;
+/** Malaysian National Registration Identity Card. */
+declare const nric: Validator;
+//#endregion
+export { compact, nric as default, format, parse, validate };
+//# sourceMappingURL=nric.d.ts.map

package/dist/my/nric.js

@@ -0,0 +1,186 @@
+import { clean } from "../_util/clean.js";
+import { err } from "../_util/result.js";
+import { isdigits } from "../_util/strings.js";
+import { isValidDate } from "../_util/date.js";
+//#region src/my/nric.ts
+/**
+* NRIC (Malaysian National Registration Identity
+* Card Number, Nombor Kad Pengenalan).
+*
+* 12 digits: YYMMDD (birth date) + PB (place of
+* birth, 2 digits) + SSS (serial) + G (gender:
+* odd = male, even = female).
+*
+* No checksum; validation is structural (valid date
+* and valid place-of-birth code).
+*
+* @see https://en.wikipedia.org/wiki/Malaysian_identity_card
+*/
+/**
+* Valid place-of-birth codes (2-digit).
+* Codes 01-16 are states, 21-59 are pre-2000
+* state codes, 60-68 born outside (ASEAN),
+* 71-72/74-79 foreign nationals, 82-93 regions,
+* 98-99 legacy.
+*/
+const VALID_PB_CODES = new Set([
+	"01",
+	"02",
+	"03",
+	"04",
+	"05",
+	"06",
+	"07",
+	"08",
+	"09",
+	"10",
+	"11",
+	"12",
+	"13",
+	"14",
+	"15",
+	"16",
+	"21",
+	"22",
+	"23",
+	"24",
+	"25",
+	"26",
+	"27",
+	"28",
+	"29",
+	"30",
+	"31",
+	"32",
+	"33",
+	"34",
+	"35",
+	"36",
+	"37",
+	"38",
+	"39",
+	"40",
+	"41",
+	"42",
+	"43",
+	"44",
+	"45",
+	"46",
+	"47",
+	"48",
+	"49",
+	"50",
+	"51",
+	"52",
+	"53",
+	"54",
+	"55",
+	"56",
+	"57",
+	"58",
+	"59",
+	"60",
+	"61",
+	"62",
+	"63",
+	"64",
+	"65",
+	"66",
+	"67",
+	"68",
+	"71",
+	"72",
+	"74",
+	"75",
+	"76",
+	"77",
+	"78",
+	"79",
+	"82",
+	"83",
+	"84",
+	"85",
+	"86",
+	"87",
+	"88",
+	"89",
+	"90",
+	"91",
+	"92",
+	"93",
+	"98",
+	"99"
+]);
+const compact = (value) => clean(value, " -");
+/**
+* Resolve the birth year from a 2-digit year.
+* Years after the reference year are assumed to be
+* in the previous century. Accepts an explicit
+* reference year to avoid multiple clock reads.
+*/
+const resolveYear = (yy, referenceYear) => {
+	const year = Math.floor(referenceYear / 100) * 100 + yy;
+	return year > referenceYear ? year - 100 : year;
+};
+const validate = (value) => {
+	const v = compact(value);
+	if (v.length !== 12) return err("INVALID_LENGTH", "NRIC must be exactly 12 digits");
+	if (!isdigits(v)) return err("INVALID_FORMAT", "NRIC must contain only digits");
+	const yy = Number(v.slice(0, 2));
+	const mm = Number(v.slice(2, 4));
+	const dd = Number(v.slice(4, 6));
+	if (!isValidDate(resolveYear(yy, (/* @__PURE__ */ new Date()).getFullYear()), mm, dd)) return err("INVALID_COMPONENT", "NRIC contains an invalid birth date");
+	const pb = v.slice(6, 8);
+	if (!VALID_PB_CODES.has(pb)) return err("INVALID_COMPONENT", "Invalid place-of-birth code: " + pb);
+	return {
+		valid: true,
+		compact: v
+	};
+};
+const format = (value) => {
+	const v = compact(value);
+	return v.slice(0, 6) + "-" + v.slice(6, 8) + "-" + v.slice(8);
+};
+/**
+* Extract birth date and gender from an NRIC.
+* Returns null if the value is not valid.
+*/
+const parse = (value) => {
+	const result = validate(value);
+	if (!result.valid) return null;
+	const v = result.compact;
+	const yy = Number(v.slice(0, 2));
+	const mm = Number(v.slice(2, 4));
+	const dd = Number(v.slice(4, 6));
+	const year = resolveYear(yy, (/* @__PURE__ */ new Date()).getFullYear());
+	const gender = Number(v[11]) % 2 === 1 ? "male" : "female";
+	return {
+		birthDate: new Date(year, mm - 1, dd),
+		gender
+	};
+};
+/** Malaysian National Registration Identity Card. */
+const nric = {
+	name: "Malaysian National Registration Identity Card Number",
+	localName: "Nombor Kad Pengenalan",
+	abbreviation: "NRIC",
+	aliases: [
+		"NRIC",
+		"MyKad",
+		"kad pengenalan"
+	],
+	candidatePattern: "\\d{6}-?\\d{2}-?\\d{4}",
+	country: "MY",
+	entityType: "person",
+	description: "12-digit identity card number encoding birth date, place of birth, and gender",
+	sourceUrl: "https://en.wikipedia.org/wiki/Malaysian_identity_card",
+	lengths: [12],
+	examples: ["770305021234", "880715141234"],
+	compact,
+	format,
+	validate
+};
+//#endregion
+export { compact, nric as default, format, parse, validate };
+
+//# sourceMappingURL=nric.js.map

package/dist/my/nric.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nric.js","names":[],"sources":["../../src/my/nric.ts"],"sourcesContent":["/**\n * NRIC (Malaysian National Registration Identity\n * Card Number, Nombor Kad Pengenalan).\n *\n * 12 digits: YYMMDD (birth date) + PB (place of\n * birth, 2 digits) + SSS (serial) + G (gender:\n * odd = male, even = female).\n *\n * No checksum; validation is structural (valid date\n * and valid place-of-birth code).\n *\n * @see https://en.wikipedia.org/wiki/Malaysian_identity_card\n */\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\n/**\n * Valid place-of-birth codes (2-digit).\n * Codes 01-16 are states, 21-59 are pre-2000\n * state codes, 60-68 born outside (ASEAN),\n * 71-72/74-79 foreign nationals, 82-93 regions,\n * 98-99 legacy.\n */\nconst VALID_PB_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  \"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  \"38\",\n  \"39\",\n  \"40\",\n  \"41\",\n  \"42\",\n  \"43\",\n  \"44\",\n  \"45\",\n  \"46\",\n  \"47\",\n  \"48\",\n  \"49\",\n  \"50\",\n  \"51\",\n  \"52\",\n  \"53\",\n  \"54\",\n  \"55\",\n  \"56\",\n  \"57\",\n  \"58\",\n  \"59\",\n  \"60\",\n  \"61\",\n  \"62\",\n  \"63\",\n  \"64\",\n  \"65\",\n  \"66\",\n  \"67\",\n  \"68\",\n  \"71\",\n  \"72\",\n  \"74\",\n  \"75\",\n  \"76\",\n  \"77\",\n  \"78\",\n  \"79\",\n  \"82\",\n  \"83\",\n  \"84\",\n  \"85\",\n  \"86\",\n  \"87\",\n  \"88\",\n  \"89\",\n  \"90\",\n  \"91\",\n  \"92\",\n  \"93\",\n  \"98\",\n  \"99\",\n]);\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\n/**\n * Resolve the birth year from a 2-digit year.\n * Years after the reference year are assumed to be\n * in the previous century. Accepts an explicit\n * reference year to avoid multiple clock reads.\n */\nconst resolveYear = (\n  yy: number,\n  referenceYear: number,\n): number => {\n  const century = Math.floor(referenceYear / 100);\n  const year = century * 100 + yy;\n  return year > referenceYear ? year - 100 : year;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"NRIC must be exactly 12 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"NRIC must contain only digits\",\n    );\n  }\n\n  // Validate birth date (YYMMDD)\n  const yy = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const dd = Number(v.slice(4, 6));\n\n  const now = new Date().getFullYear();\n  const year = resolveYear(yy, now);\n\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"NRIC contains an invalid birth date\",\n    );\n  }\n\n  // Validate place-of-birth code\n  const pb = v.slice(6, 8);\n  if (!VALID_PB_CODES.has(pb)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Invalid place-of-birth code: \" + pb,\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return (\n    v.slice(0, 6) + \"-\" + v.slice(6, 8) + \"-\" + v.slice(8)\n  );\n};\n\n/**\n * Extract birth date and gender from an NRIC.\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 yy = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const dd = Number(v.slice(4, 6));\n  const now = new Date().getFullYear();\n  const year = resolveYear(yy, now);\n\n  // Last digit: odd = male, even = female\n  const lastDigit = Number(v[11]);\n  const gender = lastDigit % 2 === 1 ? \"male\" : \"female\";\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n    gender,\n  };\n};\n\n/** Malaysian National Registration Identity Card. */\nconst nric: Validator = {\n  name: \"Malaysian National Registration Identity Card Number\",\n  localName: \"Nombor Kad Pengenalan\",\n  abbreviation: \"NRIC\",\n  aliases: [\"NRIC\", \"MyKad\", \"kad pengenalan\"] as const,\n  candidatePattern: \"\\\\d{6}-?\\\\d{2}-?\\\\d{4}\",\n  country: \"MY\",\n  entityType: \"person\",\n  description:\n    \"12-digit identity card number encoding birth date, place of birth, and gender\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Malaysian_identity_card\",\n  lengths: [12] as const,\n  examples: [\"770305021234\", \"880715141234\"] as const,\n  compact,\n  format,\n  validate,\n};\n\nexport default nric;\nexport { compact, format, parse, validate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,MAAM,iBAAiB,IAAI,IAAI;CAC7B;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;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;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;;;;;;;AAQpB,MAAM,eACJ,IACA,kBACW;CAEX,MAAM,OADU,KAAK,MAAM,gBAAgB,IAAI,GACxB,MAAM;AAC7B,QAAO,OAAO,gBAAgB,OAAO,MAAM;;AAG7C,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,iCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,gCACD;CAIH,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;AAKhC,KAAI,CAAC,YAFQ,YAAY,qBADb,IAAI,MAAM,EAAC,aAAa,CACH,EAEV,IAAI,GAAG,CAC5B,QAAO,IACL,qBACA,sCACD;CAIH,MAAM,KAAK,EAAE,MAAM,GAAG,EAAE;AACxB,KAAI,CAAC,eAAe,IAAI,GAAG,CACzB,QAAO,IACL,qBACA,kCAAkC,GACnC;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QACE,EAAE,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE;;;;;;AAQ1D,MAAM,SAAS,UAAyC;CACtD,MAAM,SAAS,SAAS,MAAM;AAC9B,KAAI,CAAC,OAAO,MAAO,QAAO;CAE1B,MAAM,IAAI,OAAO;CACjB,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAEhC,MAAM,OAAO,YAAY,qBADb,IAAI,MAAM,EAAC,aAAa,CACH;CAIjC,MAAM,SADY,OAAO,EAAE,IAAI,GACJ,MAAM,IAAI,SAAS;AAE9C,QAAO;EACL,WAAW,IAAI,KAAK,MAAM,KAAK,GAAG,GAAG;EACrC;EACD;;;AAIH,MAAM,OAAkB;CACtB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EAAC;EAAQ;EAAS;EAAiB;CAC5C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,aACE;CACF,WACE;CACF,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,gBAAgB,eAAe;CAC1C;CACA;CACA;CACD"}

package/dist/ng/mod.d.ts

@@ -0,0 +1,8 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import nin from "./nin.js";
+
+//#region src/ng/mod.d.ts
+
+//#endregion
+export { mod_d_exports, nin };
+//# sourceMappingURL=mod.d.ts.map

package/dist/ng/mod.js

@@ -0,0 +1,8 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import nin from "./nin.js";
+//#region src/ng/mod.ts
+var ng_exports = /* @__PURE__ */ __exportAll({ nin: () => nin });
+//#endregion
+export { ng_exports, nin };
+
+//# sourceMappingURL=mod.js.map

package/dist/ng/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","names":[],"sources":["../../src/ng/mod.ts"],"sourcesContent":["export { default as nin } from \"./nin\";\n"],"mappings":""}

package/dist/ng/nin.d.ts

@@ -0,0 +1,13 @@
+import { ValidateResult, Validator } from "../types.js";
+
+//#region src/ng/nin.d.ts
+/** Generate a random valid Nigerian NIN. */
+declare const generate: () => string;
+declare const compact: (value: string) => string;
+declare const validate: (value: string) => ValidateResult;
+declare const format: (value: string) => string;
+/** Nigerian National Identification Number. */
+declare const nin: Validator;
+//#endregion
+export { compact, nin as default, format, generate, validate };
+//# sourceMappingURL=nin.d.ts.map

package/dist/ng/nin.js

@@ -0,0 +1,54 @@
+import { clean } from "../_util/clean.js";
+import { randomDigits } from "../_util/generate.js";
+import { err } from "../_util/result.js";
+import { isdigits } from "../_util/strings.js";
+//#region src/ng/nin.ts
+/**
+* NIN (National Identification Number, Nigeria).
+*
+* 11-digit number randomly assigned by NIMC (National
+* Identity Management Commission). No checksum; the
+* digits are non-intelligible and carry no embedded
+* meaning. Once assigned, a NIN is permanent and
+* cannot be reassigned.
+*
+* @see https://nimc.gov.ng/about-nin/
+*/
+/** Generate a random valid Nigerian NIN. */
+const generate = () => randomDigits(11);
+const compact = (value) => clean(value, " -");
+const validate = (value) => {
+	const v = compact(value);
+	if (v.length !== 11) return err("INVALID_LENGTH", "Nigerian NIN must be 11 digits");
+	if (!isdigits(v)) return err("INVALID_FORMAT", "Nigerian NIN must contain only digits");
+	return {
+		valid: true,
+		compact: v
+	};
+};
+const format = (value) => {
+	const v = compact(value);
+	return `${v.slice(0, 3)} ${v.slice(3, 7)} ${v.slice(7)}`;
+};
+/** Nigerian National Identification Number. */
+const nin = {
+	name: "National Identification Number",
+	localName: "National Identification Number",
+	abbreviation: "NIN",
+	aliases: ["NIN", "National Identification Number"],
+	candidatePattern: "\\d{11}",
+	country: "NG",
+	entityType: "person",
+	lengths: [11],
+	examples: ["13478900989", "70123456789"],
+	description: "11-digit national identity number issued by NIMC",
+	sourceUrl: "https://nimc.gov.ng/about-nin/",
+	compact,
+	format,
+	validate,
+	generate
+};
+//#endregion
+export { compact, nin as default, format, generate, validate };
+
+//# sourceMappingURL=nin.js.map

package/dist/ng/nin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nin.js","names":[],"sources":["../../src/ng/nin.ts"],"sourcesContent":["/** Generate a random valid Nigerian NIN. */\nconst generate = (): string => randomDigits(11);\n\n/**\n * NIN (National Identification Number, Nigeria).\n *\n * 11-digit number randomly assigned by NIMC (National\n * Identity Management Commission). No checksum; the\n * digits are non-intelligible and carry no embedded\n * meaning. Once assigned, a NIN is permanent and\n * cannot be reassigned.\n *\n * @see https://nimc.gov.ng/about-nin/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Nigerian NIN must be 11 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Nigerian NIN must contain only digits\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 3)} ${v.slice(3, 7)} ${v.slice(7)}`;\n};\n\n/** Nigerian National Identification Number. */\nconst nin: Validator = {\n  name: \"National Identification Number\",\n  localName: \"National Identification Number\",\n  abbreviation: \"NIN\",\n  aliases: [\n    \"NIN\",\n    \"National Identification Number\",\n  ] as const,\n  candidatePattern: \"\\\\d{11}\",\n  country: \"NG\",\n  entityType: \"person\",\n  lengths: [11] as const,\n  examples: [\"13478900989\", \"70123456789\"] as const,\n  description:\n    \"11-digit national identity number issued by NIMC\",\n  sourceUrl: \"https://nimc.gov.ng/about-nin/\",\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nin;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;AACA,MAAM,iBAAyB,aAAa,GAAG;AAqB/C,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,iCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,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,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;;;AAIxD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,OACA,iCACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,eAAe,cAAc;CACxC,aACE;CACF,WAAW;CACX;CACA;CACA;CACA;CACD"}