soulprint-verify 0.1.0 → 0.1.2

package/dist/document/cedula-validator.d.ts

@@ -21,19 +21,51 @@ export declare function validateCedulaNumber(cedula: string): {
     error?: string;
 };
 export declare function parseCedulaOCR(ocrText: string): DocumentValidationResult;
+/**
+ * Calcula el dígito de control ICAO 9303 (estándar internacional MRTD).
+ * Algoritmo: suma ponderada con pesos 7, 3, 1 (cíclicos) sobre cada carácter.
+ *
+ * Tabla de valores:
+ *   '0'-'9' → 0-9
+ *   'A'-'Z' → 10-35
+ *   '<'     → 0
+ *
+ * Resultado: suma mod 10
+ *
+ * Referencia: ICAO Doc 9303 Part 3, §4.9
+ */
+export declare function icaoCheckDigit(field: string): number;
+/**
+ * Verifica si el dígito de control ICAO de un campo es correcto.
+ * `fieldWithCheck`: el campo + el dígito de control como último carácter.
+ */
+export declare function verifyCheckDigit(field: string, expected: string | number): {
+    valid: boolean;
+    computed: number;
+    expected: number;
+};
 /**
  * Parsea el MRZ TD1 del reverso de la cédula colombiana digital.
  * Formato: 3 líneas de 30 caracteres cada una.
  *
+ * Línea 1 (TD1): IDCOL<NUMDOC<CHECK<<<<<<<<<<<<<<<<
+ *   - [0-1]   = tipo doc "ID"
+ *   - [2-4]   = país emisor "COL"
+ *   - [5-14]  = número documento (cédula, 9 chars relleno <)
+ *   - [14]    = check digit del número de documento
+ *
  * Línea 2: DDMMYYCSEXEXPIRYNATCHECKNUMDOC<CHECK
  *   - [0-5]   = fecha nacimiento YYMMDD
- *   - [6]     = dígito verificador
+ *   - [6]     = check digit fecha nac
  *   - [7]     = sexo M/F
  *   - [8-13]  = fecha expiración YYMMDD
- *   - [14]    = dígito verificador
+ *   - [14]    = check digit expiración
  *   - [15-17] = código país (COL)
  *   - [18-28] = número documento (cédula)
+ *   - [29]    = check digit compuesto
  *
  * Línea 3: APELLIDOS<<NOMBRES<<<...
+ *
+ * Todos los check digits se verifican con ICAO 9303 (peso 7/3/1 mod 10).
  */
 export declare function parseMRZ(mrzText: string): DocumentValidationResult;

package/dist/document/cedula-validator.js

@@ -11,6 +11,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateCedulaNumber = validateCedulaNumber;
 exports.parseCedulaOCR = parseCedulaOCR;
+exports.icaoCheckDigit = icaoCheckDigit;
+exports.verifyCheckDigit = verifyCheckDigit;
 exports.parseMRZ = parseMRZ;
 // ── Rangos válidos de cédulas colombianas ─────────────────────────────────────
 // Fuente: Registraduría Nacional — rangos históricos por décadas
@@ -127,24 +129,72 @@ function parseCedulaOCR(ocrText) {
         raw_ocr: ocrText,
     };
 }
+// ── ICAO 9303 check digit ──────────────────────────────────────────────────────
+/**
+ * Calcula el dígito de control ICAO 9303 (estándar internacional MRTD).
+ * Algoritmo: suma ponderada con pesos 7, 3, 1 (cíclicos) sobre cada carácter.
+ *
+ * Tabla de valores:
+ *   '0'-'9' → 0-9
+ *   'A'-'Z' → 10-35
+ *   '<'     → 0
+ *
+ * Resultado: suma mod 10
+ *
+ * Referencia: ICAO Doc 9303 Part 3, §4.9
+ */
+function icaoCheckDigit(field) {
+    const WEIGHTS = [7, 3, 1];
+    const charValue = (ch) => {
+        if (ch >= "0" && ch <= "9")
+            return parseInt(ch, 10);
+        if (ch >= "A" && ch <= "Z")
+            return ch.charCodeAt(0) - 65 + 10; // A=10, B=11...
+        return 0; // '<' y cualquier relleno = 0
+    };
+    let sum = 0;
+    for (let i = 0; i < field.length; i++) {
+        sum += charValue(field[i]) * WEIGHTS[i % 3];
+    }
+    return sum % 10;
+}
+/**
+ * Verifica si el dígito de control ICAO de un campo es correcto.
+ * `fieldWithCheck`: el campo + el dígito de control como último carácter.
+ */
+function verifyCheckDigit(field, expected) {
+    const computed = icaoCheckDigit(field);
+    const exp = typeof expected === "string" ? parseInt(expected, 10) : expected;
+    return { valid: computed === exp, computed, expected: exp };
+}
 // ── MRZ TD1 parser (reverso cédula digital colombiana) ────────────────────────
 /**
  * Parsea el MRZ TD1 del reverso de la cédula colombiana digital.
  * Formato: 3 líneas de 30 caracteres cada una.
  *
+ * Línea 1 (TD1): IDCOL<NUMDOC<CHECK<<<<<<<<<<<<<<<<
+ *   - [0-1]   = tipo doc "ID"
+ *   - [2-4]   = país emisor "COL"
+ *   - [5-14]  = número documento (cédula, 9 chars relleno <)
+ *   - [14]    = check digit del número de documento
+ *
  * Línea 2: DDMMYYCSEXEXPIRYNATCHECKNUMDOC<CHECK
  *   - [0-5]   = fecha nacimiento YYMMDD
- *   - [6]     = dígito verificador
+ *   - [6]     = check digit fecha nac
  *   - [7]     = sexo M/F
  *   - [8-13]  = fecha expiración YYMMDD
- *   - [14]    = dígito verificador
+ *   - [14]    = check digit expiración
  *   - [15-17] = código país (COL)
  *   - [18-28] = número documento (cédula)
+ *   - [29]    = check digit compuesto
  *
  * Línea 3: APELLIDOS<<NOMBRES<<<...
+ *
+ * Todos los check digits se verifican con ICAO 9303 (peso 7/3/1 mod 10).
  */
 function parseMRZ(mrzText) {
     const errors = [];
+    const warnings = [];
     // Limpiar y encontrar líneas MRZ
     const allLines = mrzText
         .split("\n")
@@ -154,7 +204,22 @@ function parseMRZ(mrzText) {
     if (lines.length < 2) {
         return { valid: false, errors: ["MRZ incompleto — se necesitan al menos 2 líneas"] };
     }
-    // Línea 2: datos biográficos
+    // ── Línea 1: número de documento + check digit ───────────────────────────
+    const line1 = lines[0];
+    let docNumFromLine1;
+    if (line1.length >= 15) {
+        const docRaw = line1.slice(5, 14); // posiciones 5-13 (9 chars)
+        const checkCh = line1[14]; // posición 14 = check digit
+        const checkResult = verifyCheckDigit(docRaw, checkCh);
+        if (!checkResult.valid) {
+            errors.push(`MRZ línea 1: check digit inválido en número de documento ` +
+                `(calculado=${checkResult.computed}, encontrado=${checkResult.expected})`);
+        }
+        else {
+            docNumFromLine1 = docRaw.replace(/</g, "").replace(/^0+/, "");
+        }
+    }
+    // ── Línea 2: fecha nacimiento + sexo + expiración + check digits ─────────
     const line2 = lines.find(l => /^\d{6}[0-9<][MF<]/.test(l));
     if (!line2) {
         return { valid: false, errors: ["No se encontró línea MRZ con datos biográficos"] };
@@ -163,14 +228,39 @@ function parseMRZ(mrzText) {
     const mm = line2.slice(2, 4);
     const dd = line2.slice(4, 6);
     const sex = line2[7];
-    // Inferir siglo (si YY > 24 → 19xx, si <= 24 → 20xx)
+    // Verificar check digit de fecha de nacimiento (posición 6)
+    const dobField = line2.slice(0, 6);
+    const dobCheck = line2[6];
+    const dobVerify = verifyCheckDigit(dobField, dobCheck);
+    if (!dobVerify.valid && dobCheck !== "<") {
+        errors.push(`MRZ: check digit inválido en fecha de nacimiento ` +
+            `(calculado=${dobVerify.computed}, encontrado=${dobVerify.expected})`);
+    }
+    // Verificar check digit de fecha de expiración (posición 14)
+    const expField = line2.slice(8, 14);
+    const expCheck = line2[14];
+    const expVerify = verifyCheckDigit(expField, expCheck);
+    if (!expVerify.valid && expCheck !== "<") {
+        warnings.push(`MRZ: check digit de expiración no coincide ` +
+            `(calculado=${expVerify.computed}, encontrado=${expVerify.expected})`);
+    }
+    // Inferir siglo: YY > 24 → 19xx, YY <= 24 → 20xx
     const century = parseInt(yy) > 24 ? "19" : "20";
     const fecha_nacimiento = `${century}${yy}-${mm}-${dd}`;
-    // Número de cédula: aparece en línea 2 posición 18-27 (o en línea 1)
-    const docNumRaw = line2.slice(18, 29).replace(/</g, "").trim();
-    const docNum = docNumRaw.replace(/^0+/, ""); // quitar ceros a la izquierda
+    // ── Número de cédula: prioridad línea 1 → fallback línea 2 pos 18-27 ────
+    let docNum;
+    if (docNumFromLine1) {
+        docNum = docNumFromLine1;
+    }
+    else {
+        const raw = line2.slice(18, 29).replace(/</g, "").trim();
+        docNum = raw.replace(/^0+/, "");
+    }
     const numValidation = validateCedulaNumber(docNum);
-    // Línea 3: nombre — buscar en TODAS las líneas (puede ser más corta)
+    if (!numValidation.valid) {
+        errors.push(`Número en MRZ inválido: ${numValidation.error}`);
+    }
+    // ── Línea 3: nombre ───────────────────────────────────────────────────────
     const line3 = allLines.find(l => l.includes("<<") &&
         !/^\d{6}/.test(l) &&
         /^[A-Z]{3,}<</.test(l));
@@ -179,13 +269,12 @@ function parseMRZ(mrzText) {
         const parts = line3.split("<<");
         const apellido = parts[0]?.replace(/</g, " ").trim();
         const nombres = parts.slice(1).join(" ").replace(/</g, " ").replace(/\s+/g, " ").trim();
-        nombre = nombres && apellido ? `${nombres} ${apellido}`.trim() : (apellido || nombres);
-    }
-    if (!numValidation.valid) {
-        errors.push(`Número en MRZ inválido: ${numValidation.error}`);
+        nombre = nombres && apellido
+            ? `${nombres} ${apellido}`.trim()
+            : (apellido || nombres);
     }
     return {
-        valid: errors.length === 0,
+        valid: errors.length === 0 && numValidation.valid,
         cedula_number: numValidation.valid ? docNum : undefined,
         nombre,
         fecha_nacimiento,

package/dist/document/countries/AR.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 🇦🇷 Argentina — Documento Nacional de Identidad (DNI)
+ * =========================================================
+ * Supported documents:
+ *   - DNI (Documento Nacional de Identidad) — TD1 format since 2009
+ *   - Old DNI (libreta) — pre-2009, no MRZ
+ *
+ * Issuing authority: Registro Nacional de las Personas (RENAPER)
+ * Format: 7–8 digits (new DNI), may have leading zeros
+ * MRZ: TD1 (3 lines × 30 chars) on back of card DNI
+ *
+ * Key fields:
+ *   - "DOCUMENTO NACIONAL DE IDENTIDAD"
+ *   - CUIL/CUIT derived: 20/DNI/1 (men) or 27/DNI/1 (women)
+ *
+ * Resources:
+ *   - RENAPER: https://www.argentina.gob.ar/interior/renaper
+ *   - DNI spec: TD1 ICAO 9303
+ *
+ * 👋 CONTRIBUTOR: implement parse(), parseMRZ()
+ * Status: STUB — contributions welcome!
+ */
+import type { CountryVerifier } from "../verifier.interface.js";
+declare const AR: CountryVerifier;
+export default AR;

package/dist/document/countries/AR.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * 🇦🇷 Argentina — Documento Nacional de Identidad (DNI)
+ * =========================================================
+ * Supported documents:
+ *   - DNI (Documento Nacional de Identidad) — TD1 format since 2009
+ *   - Old DNI (libreta) — pre-2009, no MRZ
+ *
+ * Issuing authority: Registro Nacional de las Personas (RENAPER)
+ * Format: 7–8 digits (new DNI), may have leading zeros
+ * MRZ: TD1 (3 lines × 30 chars) on back of card DNI
+ *
+ * Key fields:
+ *   - "DOCUMENTO NACIONAL DE IDENTIDAD"
+ *   - CUIL/CUIT derived: 20/DNI/1 (men) or 27/DNI/1 (women)
+ *
+ * Resources:
+ *   - RENAPER: https://www.argentina.gob.ar/interior/renaper
+ *   - DNI spec: TD1 ICAO 9303
+ *
+ * 👋 CONTRIBUTOR: implement parse(), parseMRZ()
+ * Status: STUB — contributions welcome!
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const AR = {
+    countryCode: "AR",
+    countryName: "Argentina",
+    documentTypes: ["dni"],
+    parse(ocrText) {
+        const errors = [];
+        const text = ocrText.toUpperCase().replace(/\s+/g, " ").trim();
+        // ── Extract DNI number ────────────────────────────────────────────────
+        let doc_number;
+        const dniPatterns = [
+            /DNI[:\s#Nº]+([0-9][0-9.\s]{6,9})/,
+            /NÚMERO[:\s]+([0-9][0-9.\s]{6,9})/,
+            /(?<![0-9])(\d{2}\.?\d{3}\.?\d{3})(?![0-9])/, // XX.XXX.XXX
+        ];
+        for (const pat of dniPatterns) {
+            const m = text.match(pat);
+            if (m) {
+                const candidate = m[1].replace(/[.\s]/g, "");
+                const v = AR.validate(candidate);
+                if (v.valid) {
+                    doc_number = v.normalized;
+                    break;
+                }
+            }
+        }
+        const isArgentina = /ARGENTINA|RENAPER|DOCUMENTO NACIONAL/i.test(text);
+        if (!isArgentina)
+            errors.push("El documento no parece ser un DNI argentino");
+        if (!doc_number)
+            errors.push("No se pudo extraer número de DNI válido");
+        // TODO: extract full_name, date_of_birth, sex, expiry_date
+        return {
+            valid: errors.length === 0 && !!doc_number,
+            doc_number,
+            document_type: "dni",
+            country: "AR",
+            errors,
+            raw_ocr: ocrText,
+        };
+    },
+    validate(docNumber) {
+        const clean = docNumber.replace(/[.\s\-]/g, "");
+        if (!/^\d+$/.test(clean))
+            return { valid: false, error: "El DNI solo debe contener números" };
+        if (clean.length < 7 || clean.length > 8)
+            return { valid: false, error: `Longitud inválida: ${clean.length} dígitos (debe ser 7-8)` };
+        if (/^(\d)\1+$/.test(clean))
+            return { valid: false, error: "Número inválido (todos los dígitos iguales)" };
+        return { valid: true, normalized: clean };
+    },
+    parseMRZ(mrzText) {
+        // TODO: implement TD1 MRZ parser for DNI argentino
+        // Similar structure to Colombian cedula — see CO.ts
+        return {
+            valid: false,
+            country: "AR",
+            errors: ["MRZ parser para Argentina no implementado — contribuye en GitHub!"],
+        };
+    },
+};
+exports.default = AR;

package/dist/document/countries/BR.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 🇧🇷 Brazil — RG (Registro Geral) & CPF
+ * ==========================================
+ * Supported documents:
+ *   - RG (Registro Geral) — state-issued, format varies by state
+ *   - CPF (Cadastro de Pessoas Físicas) — federal tax ID, 11 digits
+ *   - CNH (Carteira Nacional de Habilitação) — driver's license
+ *
+ * Issuing authorities: Secretarias de Segurança Pública (RG), Receita Federal (CPF)
+ * CPF format: XXX.XXX.XXX-YY (11 digits, last 2 = check digits)
+ * CPF check: mod 11 algorithm (distinct from ICAO)
+ *
+ * Resources:
+ *   - CPF: https://www.gov.br/receitafederal/pt-br
+ *   - RG: varies by state
+ *
+ * 👋 CONTRIBUTOR: implement parse(), full CPF check digit validation
+ * Status: PARTIAL — CPF validation done, OCR parser is stub
+ */
+import type { CountryVerifier } from "../verifier.interface.js";
+declare const BR: CountryVerifier;
+export default BR;

package/dist/document/countries/BR.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * 🇧🇷 Brazil — RG (Registro Geral) & CPF
+ * ==========================================
+ * Supported documents:
+ *   - RG (Registro Geral) — state-issued, format varies by state
+ *   - CPF (Cadastro de Pessoas Físicas) — federal tax ID, 11 digits
+ *   - CNH (Carteira Nacional de Habilitação) — driver's license
+ *
+ * Issuing authorities: Secretarias de Segurança Pública (RG), Receita Federal (CPF)
+ * CPF format: XXX.XXX.XXX-YY (11 digits, last 2 = check digits)
+ * CPF check: mod 11 algorithm (distinct from ICAO)
+ *
+ * Resources:
+ *   - CPF: https://www.gov.br/receitafederal/pt-br
+ *   - RG: varies by state
+ *
+ * 👋 CONTRIBUTOR: implement parse(), full CPF check digit validation
+ * Status: PARTIAL — CPF validation done, OCR parser is stub
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * CPF check digit validation — mod 11 algorithm (Brazilian Receita Federal)
+ * Different from ICAO! Two check digits, each computed with decreasing weights.
+ */
+function validateCPF(cpf) {
+    const clean = cpf.replace(/[.\-\s]/g, "");
+    if (clean.length !== 11 || /^(\d)\1+$/.test(clean))
+        return false;
+    const calcDigit = (digits, len) => {
+        let sum = 0;
+        for (let i = 0; i < len; i++)
+            sum += parseInt(digits[i]) * (len + 1 - i);
+        const rem = (sum * 10) % 11;
+        return rem === 10 ? 0 : rem;
+    };
+    const d1 = calcDigit(clean, 9);
+    const d2 = calcDigit(clean, 10);
+    return parseInt(clean[9]) === d1 && parseInt(clean[10]) === d2;
+}
+const BR = {
+    countryCode: "BR",
+    countryName: "Brazil",
+    documentTypes: ["rg", "cpf", "cnh"],
+    parse(ocrText) {
+        const errors = [];
+        const text = ocrText.toUpperCase().replace(/\s+/g, " ").trim();
+        // Try CPF first (more reliable pattern)
+        let doc_number;
+        let document_type = "rg";
+        const cpfMatch = text.match(/CPF[:\s]*([0-9]{3}\.?[0-9]{3}\.?[0-9]{3}-?[0-9]{2})/);
+        if (cpfMatch) {
+            const v = BR.validate(cpfMatch[1]);
+            if (v.valid) {
+                doc_number = v.normalized;
+                document_type = "cpf";
+            }
+        }
+        // TODO: extract RG number, full_name, date_of_birth, sex
+        // RG format varies by issuing state (SP: X.XXX.XXX-X, MG: XXXXXXXXX, etc.)
+        const isBrazil = /BRASIL|BRAZIL|REPÚBLICA FEDERATIVA|FEDERATIVA DO BRASIL/i.test(text);
+        if (!isBrazil)
+            errors.push("O documento não parece ser brasileiro");
+        if (!doc_number)
+            errors.push("Não foi possível extrair CPF ou RG válido");
+        return {
+            valid: errors.length === 0 && !!doc_number,
+            doc_number,
+            document_type,
+            country: "BR",
+            errors,
+            raw_ocr: ocrText,
+        };
+    },
+    validate(docNumber) {
+        const clean = docNumber.replace(/[.\-\s]/g, "");
+        // CPF: 11 digits
+        if (/^\d{11}$/.test(clean)) {
+            if (!validateCPF(clean))
+                return { valid: false, error: "CPF inválido (dígitos verificadores incorretos)" };
+            return { valid: true, normalized: clean };
+        }
+        // RG: 7-9 digits (state-dependent) — basic check only
+        if (/^\d{7,9}$/.test(clean))
+            return { valid: true, normalized: clean };
+        return { valid: false, error: "Não é um CPF (11 dígitos) nem RG válido (7-9 dígitos)" };
+    },
+};
+exports.default = BR;

package/dist/document/countries/CL.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 🇨🇱 Chile — Cédula de Identidad (RUN/RUT)
+ * =============================================
+ * Supported documents:
+ *   - Cédula de Identidad chilena — TD1 format
+ *
+ * Issuing authority: Servicio de Registro Civil e Identificación (SRCeI)
+ * Format: XXXXXXXX-Y (RUN: 7-8 digits + verifier digit, '0'-'9' or 'K')
+ * Check digit: mod 11 with weights 2,3,4,5,6,7 (right to left)
+ *
+ * Resources:
+ *   - SRCeI: https://www.registrocivil.cl
+ *   - RUN format: https://www.srcei.cl/run
+ *
+ * 👋 CONTRIBUTOR: implement parse(), parseMRZ()
+ * Status: PARTIAL — RUN validation done, OCR parser is stub
+ */
+import type { CountryVerifier } from "../verifier.interface.js";
+declare const CL: CountryVerifier;
+export default CL;

package/dist/document/countries/CL.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * 🇨🇱 Chile — Cédula de Identidad (RUN/RUT)
+ * =============================================
+ * Supported documents:
+ *   - Cédula de Identidad chilena — TD1 format
+ *
+ * Issuing authority: Servicio de Registro Civil e Identificación (SRCeI)
+ * Format: XXXXXXXX-Y (RUN: 7-8 digits + verifier digit, '0'-'9' or 'K')
+ * Check digit: mod 11 with weights 2,3,4,5,6,7 (right to left)
+ *
+ * Resources:
+ *   - SRCeI: https://www.registrocivil.cl
+ *   - RUN format: https://www.srcei.cl/run
+ *
+ * 👋 CONTRIBUTOR: implement parse(), parseMRZ()
+ * Status: PARTIAL — RUN validation done, OCR parser is stub
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+/** Chile RUN check digit — mod 11, returns '0'-'9' or 'K' */
+function runCheckDigit(num) {
+    const digits = num.replace(/\./g, "").split("").reverse();
+    const weights = [2, 3, 4, 5, 6, 7];
+    let sum = 0;
+    digits.forEach((d, i) => { sum += parseInt(d) * weights[i % weights.length]; });
+    const rem = 11 - (sum % 11);
+    if (rem === 11)
+        return "0";
+    if (rem === 10)
+        return "K";
+    return rem.toString();
+}
+const CL = {
+    countryCode: "CL",
+    countryName: "Chile",
+    documentTypes: ["cedula_identidad", "rut"],
+    parse(ocrText) {
+        const errors = [];
+        const text = ocrText.toUpperCase().replace(/\s+/g, " ").trim();
+        let doc_number;
+        const runPatterns = [
+            /RUN[:\s]*(\d{1,2}\.?\d{3}\.?\d{3}-?[0-9K])/i,
+            /RUT[:\s]*(\d{1,2}\.?\d{3}\.?\d{3}-?[0-9K])/i,
+            /(\d{1,2}\.?\d{3}\.?\d{3}-[0-9K])/,
+        ];
+        for (const pat of runPatterns) {
+            const m = text.match(pat);
+            if (m) {
+                const v = CL.validate(m[1]);
+                if (v.valid) {
+                    doc_number = v.normalized;
+                    break;
+                }
+            }
+        }
+        const isChile = /CHILE|REGISTRO CIVIL|REPÚBLICA DE CHILE/i.test(text);
+        if (!isChile)
+            errors.push("El documento no parece ser una cédula chilena");
+        if (!doc_number)
+            errors.push("No se pudo extraer RUN válido");
+        // TODO: extract full_name, date_of_birth, sex, expiry_date
+        return {
+            valid: errors.length === 0 && !!doc_number,
+            doc_number,
+            document_type: "cedula_identidad",
+            country: "CL",
+            errors,
+            raw_ocr: ocrText,
+        };
+    },
+    validate(docNumber) {
+        const clean = docNumber.replace(/[.\s]/g, "").toUpperCase();
+        const m = clean.match(/^(\d{7,8})-?([0-9K])$/);
+        if (!m)
+            return { valid: false, error: "Formato inválido. Debe ser XXXXXXXX-Y (dígito verificador 0-9 o K)" };
+        const expected = runCheckDigit(m[1]);
+        if (m[2] !== expected)
+            return { valid: false, error: `Dígito verificador incorrecto (esperado: ${expected}, encontrado: ${m[2]})` };
+        return { valid: true, normalized: `${m[1]}-${m[2]}` };
+    },
+};
+exports.default = CL;

package/dist/document/countries/CO.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 🇨🇴 Colombia — Cédula de Ciudadanía & Cédula de Extranjería
+ * ================================================================
+ * Supported documents:
+ *   - Cédula de Ciudadanía (CC) — TD1 format, MRZ on back
+ *   - Cédula de Extranjería (CE) — for foreign residents
+ *
+ * Issuing authority: Registraduría Nacional del Estado Civil
+ * Format: 5–10 numeric digits
+ * MRZ: TD1 (3 lines × 30 chars), ICAO 9303
+ *
+ * Contributor: @manuelariasfz
+ */
+import type { CountryVerifier } from "../verifier.interface.js";
+declare const CO: CountryVerifier;
+export default CO;

package/dist/document/countries/CO.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * 🇨🇴 Colombia — Cédula de Ciudadanía & Cédula de Extranjería
+ * ================================================================
+ * Supported documents:
+ *   - Cédula de Ciudadanía (CC) — TD1 format, MRZ on back
+ *   - Cédula de Extranjería (CE) — for foreign residents
+ *
+ * Issuing authority: Registraduría Nacional del Estado Civil
+ * Format: 5–10 numeric digits
+ * MRZ: TD1 (3 lines × 30 chars), ICAO 9303
+ *
+ * Contributor: @manuelariasfz
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const cedula_validator_js_1 = require("../cedula-validator.js");
+const CO = {
+    countryCode: "CO",
+    countryName: "Colombia",
+    documentTypes: ["cedula", "cedula_extranjeria"],
+    parse(ocrText) {
+        const r = (0, cedula_validator_js_1.parseCedulaOCR)(ocrText);
+        return {
+            valid: r.valid,
+            doc_number: r.cedula_number,
+            full_name: r.nombre,
+            date_of_birth: r.fecha_nacimiento,
+            sex: r.sexo,
+            document_type: "cedula",
+            country: "CO",
+            errors: r.errors,
+            raw_ocr: r.raw_ocr,
+        };
+    },
+    validate(docNumber) {
+        const r = (0, cedula_validator_js_1.validateCedulaNumber)(docNumber);
+        if (!r.valid)
+            return { valid: false, error: r.error };
+        const normalized = docNumber.replace(/[\s\-\.]/g, "");
+        return { valid: true, normalized };
+    },
+    parseMRZ(mrzText) {
+        const r = (0, cedula_validator_js_1.parseMRZ)(mrzText);
+        return {
+            valid: r.valid,
+            doc_number: r.cedula_number,
+            full_name: r.nombre,
+            date_of_birth: r.fecha_nacimiento,
+            sex: r.sexo,
+            document_type: "cedula",
+            country: "CO",
+            errors: r.errors,
+            raw_ocr: r.raw_ocr,
+        };
+    },
+    async quickValidate(imagePath) {
+        try {
+            const sharp = (await import("sharp")).default;
+            const meta = await sharp(imagePath).metadata();
+            if (!meta.width || !meta.height)
+                return { valid: false, error: "No se pudo leer dimensiones" };
+            const ratio = meta.width / meta.height;
+            const isLandscape = meta.width > meta.height;
+            if (!isLandscape)
+                return { valid: false, error: "La cédula debe estar en horizontal" };
+            if (ratio < 1.2 || ratio > 2.0)
+                return { valid: false, error: `Proporción inusual (${ratio.toFixed(2)}) — fotografia solo la cédula` };
+            if (meta.width < 400 || meta.height < 250)
+                return { valid: false, error: "Imagen muy pequeña — usa al menos 400×250px" };
+            return { valid: true };
+        }
+        catch (e) {
+            return { valid: false, error: `Error leyendo imagen: ${e.message}` };
+        }
+    },
+};
+exports.default = CO;

package/dist/document/countries/MX.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 🇲🇽 Mexico — Credencial para Votar (INE/IFE) & Pasaporte
+ * =============================================================
+ * Supported documents:
+ *   - Credencial para Votar (INE) — issued by Instituto Nacional Electoral
+ *   - Pasaporte mexicano — ICAO TD3
+ *
+ * Key fields on INE:
+ *   - CURP: 18-char alphanumeric (Clave Única de Registro de Población)
+ *   - Clave de elector: 18 chars
+ *   - Número de emisión: 2 digits
+ *
+ * Resources:
+ *   - CURP format: https://www.gob.mx/curp
+ *   - INE layout: https://www.ine.mx/credencial/
+ *
+ * 👋 CONTRIBUTOR: implement parse(), validate(), parseMRZ()
+ * Status: STUB — contributions welcome!
+ */
+import type { CountryVerifier } from "../verifier.interface.js";
+declare const MX: CountryVerifier;
+export default MX;