@mikashboks/capture-intelligence-core 0.1.10 → 0.1.19

package/dist/esm/mrz-check-digits.js

@@ -0,0 +1,471 @@
+import { parse as parseMrzPackage } from 'mrz';
+const MRZ_WEIGHTS = [7, 3, 1];
+const MRZ_ALLOWED_CHARS = /^[A-Z0-9<]+$/;
+const MRZ_SUPPORTED_FORMATS = new Set(['TD1', 'TD2', 'TD3']);
+const EMPTY_RESULT = Object.freeze({
+    valid: false,
+    format: null,
+    normalizedLines: [],
+    checks: [],
+    errors: ['empty_mrz'],
+});
+export function getMrzCharacterValue(char) {
+    if (char === '<')
+        return 0;
+    const code = char.charCodeAt(0);
+    if (code >= 48 && code <= 57)
+        return code - 48;
+    if (code >= 65 && code <= 90)
+        return code - 55;
+    return null;
+}
+export function computeMrzCheckDigit(value) {
+    let sum = 0;
+    const normalized = String(value).toUpperCase();
+    for (let index = 0; index < normalized.length; index += 1) {
+        const charValue = getMrzCharacterValue(normalized[index] ?? '');
+        if (charValue === null) {
+            throw new Error(`Invalid MRZ character at index ${index}`);
+        }
+        sum += charValue * MRZ_WEIGHTS[index % MRZ_WEIGHTS.length];
+    }
+    return String(sum % 10);
+}
+export function normalizeMrzLines(input) {
+    const lines = Array.isArray(input) ? input : String(input).split(/\r?\n/g);
+    return lines.map(line => String(line).trim().replace(/\s+/g, '').toUpperCase()).filter(Boolean);
+}
+function isLikelyTd3NameLine(line) {
+    return /^P[A-Z<][A-Z<]{3}[A-Z<]+<<[A-Z<]+/.test(line);
+}
+function isLikelyTd3DataLine(line) {
+    return /^[A-Z0-9<]{9}[0-9A-Z][A-Z<]{3}[0-9A-Z]{6}[0-9A-Z][MF<X]/.test(line);
+}
+function orderLikelyMrzLines(lines) {
+    if (lines.length === 2 &&
+        isLikelyTd3DataLine(lines[0] ?? '') &&
+        isLikelyTd3NameLine(lines[1] ?? '')) {
+        return [lines[1] ?? '', lines[0] ?? ''];
+    }
+    return lines;
+}
+function trimCandidateLines(lines) {
+    const ordered = orderLikelyMrzLines(lines);
+    if (ordered.length === 2 &&
+        isLikelyTd3NameLine(ordered[0] ?? '') &&
+        isLikelyTd3DataLine(ordered[1] ?? '') &&
+        ordered[0].length >= 44 &&
+        ordered[1].length >= 40) {
+        return [ordered[0].slice(0, 44), ordered[1].slice(0, 44).padEnd(44, '<')];
+    }
+    if (ordered.length === 2 && ordered[0].length >= 44 && ordered[1].length >= 44) {
+        return [ordered[0].slice(0, 44), ordered[1].slice(0, 44)];
+    }
+    if (ordered.length === 3 &&
+        ordered[0].length >= 30 &&
+        ordered[1].length >= 30 &&
+        ordered[2].length >= 30) {
+        return [ordered[0].slice(0, 30), ordered[1].slice(0, 30), ordered[2].slice(0, 30)];
+    }
+    if (ordered.length === 2 && ordered[0].length >= 36 && ordered[1].length >= 36) {
+        return [ordered[0].slice(0, 36), ordered[1].slice(0, 36)];
+    }
+    return ordered;
+}
+function inferMrzFormat(lines) {
+    if (lines.length === 2 && lines.every(line => line.length === 44))
+        return 'TD3';
+    if (lines.length === 2 && lines.every(line => line.length === 36))
+        return 'TD2';
+    if (lines.length === 3 && lines.every(line => line.length === 30))
+        return 'TD1';
+    return null;
+}
+function addCheck(checks, field, value, actual) {
+    const expected = computeMrzCheckDigit(value);
+    checks.push({
+        field,
+        value,
+        expected,
+        actual,
+        valid: actual === expected,
+    });
+}
+function validateTd3(lines) {
+    const line2 = lines[1] ?? '';
+    const checks = [];
+    addCheck(checks, 'documentNumber', line2.slice(0, 9), line2[9] ?? '');
+    addCheck(checks, 'dateOfBirth', line2.slice(13, 19), line2[19] ?? '');
+    addCheck(checks, 'expirationDate', line2.slice(21, 27), line2[27] ?? '');
+    addCheck(checks, 'optionalData', line2.slice(28, 42), line2[42] ?? '');
+    addCheck(checks, 'composite', `${line2.slice(0, 10)}${line2.slice(13, 20)}${line2.slice(21, 43)}`, line2[43] ?? '');
+    return checks;
+}
+function validateTd2(lines) {
+    const line2 = lines[1] ?? '';
+    const checks = [];
+    addCheck(checks, 'documentNumber', line2.slice(0, 9), line2[9] ?? '');
+    addCheck(checks, 'dateOfBirth', line2.slice(13, 19), line2[19] ?? '');
+    addCheck(checks, 'expirationDate', line2.slice(21, 27), line2[27] ?? '');
+    addCheck(checks, 'composite', `${line2.slice(0, 10)}${line2.slice(13, 20)}${line2.slice(21, 35)}`, line2[35] ?? '');
+    return checks;
+}
+function validateTd1(lines) {
+    const line1 = lines[0] ?? '';
+    const line2 = lines[1] ?? '';
+    const checks = [];
+    addCheck(checks, 'documentNumber', line1.slice(5, 14), line1[14] ?? '');
+    addCheck(checks, 'dateOfBirth', line2.slice(0, 6), line2[6] ?? '');
+    addCheck(checks, 'expirationDate', line2.slice(8, 14), line2[14] ?? '');
+    addCheck(checks, 'composite', `${line1.slice(5, 30)}${line2.slice(0, 7)}${line2.slice(8, 15)}${line2.slice(18, 29)}`, line2[29] ?? '');
+    return checks;
+}
+const OCR_NUMERIC_CORRECTIONS = {
+    O: '0',
+    Q: '0',
+    D: '0',
+    I: '1',
+    L: '1',
+    Z: '2',
+    S: '5',
+    G: '6',
+    B: '8',
+};
+function correctNumericChar(lines, lineIndex, column, corrections) {
+    const line = lines[lineIndex];
+    const original = line?.[column];
+    if (!line || !original || /[0-9<]/.test(original))
+        return;
+    const corrected = OCR_NUMERIC_CORRECTIONS[original];
+    if (!corrected)
+        return;
+    lines[lineIndex] = `${line.slice(0, column)}${corrected}${line.slice(column + 1)}`;
+    corrections.push({
+        line: lineIndex,
+        column,
+        original,
+        corrected,
+    });
+}
+function correctNumericRange(lines, lineIndex, start, endExclusive, corrections) {
+    for (let column = start; column < endExclusive; column += 1) {
+        correctNumericChar(lines, lineIndex, column, corrections);
+    }
+}
+function autocorrectMrzLines(lines, format) {
+    const corrected = [...lines];
+    const corrections = [];
+    if (format === 'TD3') {
+        correctNumericChar(corrected, 1, 9, corrections);
+        correctNumericRange(corrected, 1, 13, 20, corrections);
+        correctNumericRange(corrected, 1, 21, 28, corrections);
+        correctNumericChar(corrected, 1, 42, corrections);
+        correctNumericChar(corrected, 1, 43, corrections);
+    }
+    else if (format === 'TD2') {
+        correctNumericChar(corrected, 1, 9, corrections);
+        correctNumericRange(corrected, 1, 13, 20, corrections);
+        correctNumericRange(corrected, 1, 21, 28, corrections);
+        correctNumericChar(corrected, 1, 35, corrections);
+    }
+    else if (format === 'TD1') {
+        correctNumericChar(corrected, 0, 14, corrections);
+        correctNumericRange(corrected, 1, 0, 7, corrections);
+        correctNumericRange(corrected, 1, 8, 15, corrections);
+        correctNumericChar(corrected, 1, 29, corrections);
+    }
+    return { lines: corrected, corrections };
+}
+function stripFiller(value) {
+    return value.replace(/<+$/g, '').replace(/</g, '');
+}
+function parseNameLine(value) {
+    const [lastName = '', firstName = ''] = value.split('<<');
+    const clean = (part) => {
+        const cleaned = part.replace(/<+/g, ' ').trim();
+        return cleaned || undefined;
+    };
+    return {
+        lastName: clean(lastName),
+        firstName: clean(firstName),
+    };
+}
+function normalizeSex(value) {
+    if (value === 'M')
+        return 'male';
+    if (value === 'F')
+        return 'female';
+    if (value === '<' || value === 'X')
+        return 'other';
+    return value || undefined;
+}
+function mapFields(format, lines) {
+    if (format === 'TD3') {
+        const line1 = lines[0] ?? '';
+        const line2 = lines[1] ?? '';
+        const names = parseNameLine(line1.slice(5));
+        const dateOfBirth = line2.slice(13, 19);
+        const expirationDate = line2.slice(21, 27);
+        return {
+            documentCode: line1.slice(0, 1) || undefined,
+            issuingState: stripFiller(line1.slice(2, 5)) || undefined,
+            documentNumber: stripFiller(line2.slice(0, 9)) || undefined,
+            dateOfBirth,
+            birthDate: dateOfBirth,
+            expirationDate,
+            expiryDate: expirationDate,
+            nationality: stripFiller(line2.slice(10, 13)) || undefined,
+            sex: normalizeSex(line2.slice(20, 21)),
+            personalNumber: stripFiller(line2.slice(28, 42)) || undefined,
+            ...names,
+        };
+    }
+    if (format === 'TD2') {
+        const line1 = lines[0] ?? '';
+        const line2 = lines[1] ?? '';
+        const names = parseNameLine(line1.slice(5));
+        const dateOfBirth = line2.slice(13, 19);
+        const expirationDate = line2.slice(21, 27);
+        return {
+            documentCode: line1.slice(0, 1) || undefined,
+            issuingState: stripFiller(line1.slice(2, 5)) || undefined,
+            documentNumber: stripFiller(line2.slice(0, 9)) || undefined,
+            dateOfBirth,
+            birthDate: dateOfBirth,
+            expirationDate,
+            expiryDate: expirationDate,
+            nationality: stripFiller(line2.slice(10, 13)) || undefined,
+            sex: normalizeSex(line2.slice(20, 21)),
+            optional: stripFiller(line2.slice(28, 35)) || undefined,
+            ...names,
+        };
+    }
+    const line1 = lines[0] ?? '';
+    const line2 = lines[1] ?? '';
+    const line3 = lines[2] ?? '';
+    const names = parseNameLine(line3);
+    const dateOfBirth = line2.slice(0, 6);
+    const expirationDate = line2.slice(8, 14);
+    return {
+        documentCode: line1.slice(0, 1) || undefined,
+        issuingState: stripFiller(line1.slice(2, 5)) || undefined,
+        documentNumber: stripFiller(line1.slice(5, 14)) || undefined,
+        dateOfBirth,
+        birthDate: dateOfBirth,
+        expirationDate,
+        expiryDate: expirationDate,
+        nationality: stripFiller(line2.slice(15, 18)) || undefined,
+        sex: normalizeSex(line2.slice(7, 8)),
+        optional1: stripFiller(line1.slice(15, 30)) || undefined,
+        optional2: stripFiller(line2.slice(18, 29)) || undefined,
+        ...names,
+    };
+}
+const parseMrzLibrary = parseMrzPackage;
+function getMrzParserSync() {
+    return typeof parseMrzLibrary === 'function' ? parseMrzLibrary : null;
+}
+function isParserResult(value) {
+    return typeof value === 'object' && value !== null;
+}
+function mapParserDetails(raw) {
+    if (!isParserResult(raw) || !Array.isArray(raw.details))
+        return [];
+    return raw.details.map(detail => ({
+        label: detail.label,
+        field: detail.field,
+        value: detail.value,
+        valid: detail.valid,
+        error: detail.error,
+        autocorrect: Array.isArray(detail.autocorrect) ? detail.autocorrect : [],
+    }));
+}
+function mergeParserFields(fields, raw) {
+    if (!isParserResult(raw) || !raw.fields)
+        return fields;
+    const rawFields = raw.fields;
+    return {
+        ...fields,
+        documentCode: rawFields.documentCode ?? fields.documentCode,
+        issuingState: rawFields.issuingState ?? fields.issuingState,
+        documentNumber: rawFields.documentNumber ?? fields.documentNumber,
+        dateOfBirth: rawFields.birthDate ?? fields.dateOfBirth,
+        birthDate: rawFields.birthDate ?? fields.birthDate,
+        expirationDate: rawFields.expirationDate ?? fields.expirationDate,
+        expiryDate: rawFields.expirationDate ?? fields.expiryDate,
+        nationality: rawFields.nationality ?? fields.nationality,
+        sex: rawFields.sex ?? fields.sex,
+        firstName: rawFields.firstName ?? fields.firstName,
+        lastName: rawFields.lastName ?? fields.lastName,
+        optional: rawFields.optional ?? fields.optional,
+        optional1: rawFields.optional1 ?? fields.optional1,
+        optional2: rawFields.optional2 ?? fields.optional2,
+        personalNumber: rawFields.personalNumber ?? fields.personalNumber,
+    };
+}
+function getParserAutocorrections(details) {
+    return details.flatMap(detail => detail.autocorrect ?? []);
+}
+function parseWithLibrary(lines, autocorrect) {
+    const parser = getMrzParserSync();
+    if (!parser) {
+        return {
+            raw: null,
+            parserValid: null,
+            details: [],
+            errors: [],
+        };
+    }
+    try {
+        const raw = parser(lines, { autocorrect });
+        const details = mapParserDetails(raw);
+        const parserValid = isParserResult(raw) && typeof raw.valid === 'boolean' ? raw.valid : null;
+        return {
+            raw,
+            parserValid,
+            details,
+            errors: parserValid === false ? ['parser_invalid'] : [],
+        };
+    }
+    catch (error) {
+        return {
+            raw: null,
+            parserValid: false,
+            details: [],
+            errors: [
+                error instanceof Error && error.message ? `parser_error:${error.message}` : 'parser_error',
+            ],
+        };
+    }
+}
+function buildChecks(format, lines) {
+    if (format === 'TD3')
+        return validateTd3(lines);
+    if (format === 'TD2')
+        return validateTd2(lines);
+    return validateTd1(lines);
+}
+export function parseMrzText(input, options = {}) {
+    const rawNormalizedLines = normalizeMrzLines(input);
+    if (rawNormalizedLines.length === 0) {
+        return {
+            valid: false,
+            format: null,
+            normalizedLines: [],
+            fields: {},
+            checks: [],
+            checkDigitsValid: false,
+            parserValid: null,
+            details: [],
+            autocorrections: [],
+            errors: ['empty_mrz'],
+            raw: null,
+        };
+    }
+    let normalizedLines = trimCandidateLines(rawNormalizedLines);
+    const invalidLine = normalizedLines.find(line => !MRZ_ALLOWED_CHARS.test(line));
+    if (invalidLine) {
+        return {
+            valid: false,
+            format: null,
+            normalizedLines,
+            fields: {},
+            checks: [],
+            checkDigitsValid: false,
+            parserValid: null,
+            details: [],
+            autocorrections: [],
+            errors: ['invalid_characters'],
+            raw: null,
+        };
+    }
+    const format = inferMrzFormat(normalizedLines);
+    if (!format) {
+        return {
+            valid: false,
+            format: null,
+            normalizedLines,
+            checks: [],
+            errors: ['unsupported_mrz_format'],
+            fields: {},
+            checkDigitsValid: false,
+            parserValid: null,
+            details: [],
+            autocorrections: [],
+            raw: null,
+        };
+    }
+    if (options.allowedFormats?.length && !options.allowedFormats.includes(format)) {
+        return {
+            valid: false,
+            format,
+            normalizedLines,
+            fields: {},
+            checks: [],
+            checkDigitsValid: false,
+            parserValid: null,
+            details: [],
+            autocorrections: [],
+            errors: ['unexpected_mrz_format'],
+            raw: null,
+        };
+    }
+    const localAutocorrect = options.autocorrect === false
+        ? { lines: normalizedLines, corrections: [] }
+        : autocorrectMrzLines(normalizedLines, format);
+    normalizedLines = localAutocorrect.lines;
+    const checks = buildChecks(format, normalizedLines);
+    const failedFields = checks.filter(check => !check.valid).map(check => check.field);
+    const checkErrors = failedFields.map(field => `invalid_${field}_check_digit`);
+    const checkDigitsValid = failedFields.length === 0;
+    const parsed = parseWithLibrary(normalizedLines, options.autocorrect !== false);
+    const details = parsed.details.length
+        ? parsed.details
+        : checks.map(check => ({
+            label: `${check.field} check digit`,
+            field: check.field,
+            value: check.actual,
+            valid: check.valid,
+            error: check.valid
+                ? undefined
+                : `invalid check digit: ${check.actual}. Must be ${check.expected}`,
+        }));
+    const parserAutocorrections = getParserAutocorrections(details);
+    const autocorrections = [...localAutocorrect.corrections, ...parserAutocorrections];
+    const parserValid = parsed.parserValid === null ? null : parsed.parserValid && MRZ_SUPPORTED_FORMATS.has(format);
+    const requireParserValidity = options.requireParserValidity !== false;
+    const valid = checkDigitsValid && (requireParserValidity ? parserValid === true : true);
+    const fields = mergeParserFields(mapFields(format, normalizedLines), parsed.raw);
+    return {
+        valid,
+        format,
+        normalizedLines,
+        fields,
+        checks,
+        checkDigitsValid,
+        parserValid,
+        details,
+        autocorrections,
+        errors: [...checkErrors, ...parsed.errors],
+        raw: parsed.raw,
+    };
+}
+export function validateMrzCheckDigits(input) {
+    const result = parseMrzText(input, { requireParserValidity: false });
+    if (result.normalizedLines.length === 0)
+        return { ...EMPTY_RESULT };
+    return {
+        valid: result.checkDigitsValid,
+        format: result.format,
+        normalizedLines: result.normalizedLines,
+        checks: result.checks,
+        errors: result.errors.filter(error => error.startsWith('invalid_') ||
+            error === 'empty_mrz' ||
+            error === 'invalid_characters' ||
+            error === 'unsupported_mrz_format'),
+        checkDigitsValid: result.checkDigitsValid,
+        parserValid: result.parserValid,
+        autocorrections: result.autocorrections,
+    };
+}
+//# sourceMappingURL=mrz-check-digits.js.map

package/dist/esm/mrz-check-digits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mrz-check-digits.js","sourceRoot":"","sources":["../../src/mrz-check-digits.ts"],"names":[],"mappings":"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"}

package/dist/esm/mrz-policy.d.ts

@@ -0,0 +1,18 @@
+import type { MrzDocumentFormat } from './mrz-check-digits.js';
+export type MrzPlacement = 'passport_data_page' | 'card_back';
+export type MrzExpectation = 'expected' | 'none';
+export interface DocumentMrzPolicy {
+    expected: boolean;
+    expectation: MrzExpectation;
+    formats: readonly MrzDocumentFormat[];
+    placement: MrzPlacement | null;
+    reason: string;
+}
+export interface DocumentMrzPolicyInput {
+    documentType?: string | null;
+    documentSide?: 'front' | 'back' | string | null;
+    captureMode?: string | null;
+    overlayVariant?: 'card' | 'passport' | 'a4' | string | null;
+}
+export declare function resolveDocumentMrzPolicy(input?: DocumentMrzPolicyInput): DocumentMrzPolicy;
+//# sourceMappingURL=mrz-policy.d.ts.map

package/dist/esm/mrz-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mrz-policy.d.ts","sourceRoot":"","sources":["../../src/mrz-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,MAAM,YAAY,GAAG,oBAAoB,GAAG,WAAW,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,cAAc,CAAC;IAC5B,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACtC,SAAS,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAChD,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;CAC7D;AA8ED,wBAAgB,wBAAwB,CAAC,KAAK,GAAE,sBAA2B,GAAG,iBAAiB,CA2B9F"}

package/dist/esm/mrz-policy.js

@@ -0,0 +1,87 @@
+const PASSPORT_POLICY = Object.freeze({
+    expected: true,
+    expectation: 'expected',
+    formats: ['TD3'],
+    placement: 'passport_data_page',
+    reason: 'passport_data_page',
+});
+const CARD_BACK_POLICY = Object.freeze({
+    expected: true,
+    expectation: 'expected',
+    formats: ['TD1', 'TD2'],
+    placement: 'card_back',
+    reason: 'card_back',
+});
+const NO_MRZ_POLICY = Object.freeze({
+    expected: false,
+    expectation: 'none',
+    formats: [],
+    placement: null,
+    reason: 'not_expected',
+});
+const MRZ_CARD_BASE_TYPES = new Set([
+    'card',
+    'card_back',
+    'id_card',
+    'identity_card',
+    'national_id',
+    'national_id_card',
+    'sierraleone_national_id',
+    'sierraleone_national_id_card',
+    'ghana_card',
+]);
+function normalizeToken(value) {
+    return String(value || '')
+        .trim()
+        .toLowerCase()
+        .replace(/[\s-]+/g, '_');
+}
+function resolveDocumentSide(input, documentType) {
+    const explicitSide = normalizeToken(input.documentSide);
+    if (explicitSide === 'front' || explicitSide === 'back')
+        return explicitSide;
+    const captureMode = normalizeToken(input.captureMode);
+    if (captureMode.includes('back'))
+        return 'back';
+    if (captureMode.includes('front'))
+        return 'front';
+    if (documentType.endsWith('_back'))
+        return 'back';
+    return null;
+}
+function stripBackSuffix(documentType) {
+    return documentType.endsWith('_back') ? documentType.slice(0, -'_back'.length) : documentType;
+}
+function isAddressOrSelfieType(documentType, overlayVariant) {
+    return (overlayVariant === 'a4' ||
+        documentType.includes('address') ||
+        documentType.includes('proof_of_address') ||
+        documentType.includes('utility_bill') ||
+        documentType.includes('selfie') ||
+        documentType.includes('liveness') ||
+        documentType.includes('mobile_money') ||
+        documentType.includes('business_registration'));
+}
+export function resolveDocumentMrzPolicy(input = {}) {
+    const documentType = normalizeToken(input.documentType);
+    const overlayVariant = normalizeToken(input.overlayVariant);
+    if (isAddressOrSelfieType(documentType, overlayVariant)) {
+        return NO_MRZ_POLICY;
+    }
+    if (documentType.includes('passport') || overlayVariant === 'passport') {
+        return PASSPORT_POLICY;
+    }
+    const side = resolveDocumentSide(input, documentType);
+    if (side !== 'back') {
+        return NO_MRZ_POLICY;
+    }
+    const baseType = stripBackSuffix(documentType);
+    if (MRZ_CARD_BASE_TYPES.has(documentType) || MRZ_CARD_BASE_TYPES.has(baseType)) {
+        return CARD_BACK_POLICY;
+    }
+    if (!documentType && overlayVariant === 'card') {
+        return CARD_BACK_POLICY;
+    }
+    return NO_MRZ_POLICY;
+}
+//# sourceMappingURL=mrz-policy.js.map

package/dist/esm/mrz-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mrz-policy.js","sourceRoot":"","sources":["../../src/mrz-policy.ts"],"names":[],"mappings":"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"}

package/dist/esm/quality-checks.d.ts

@@ -57,6 +57,20 @@ export declare function shouldShowSubmitAnyway(state: QualityFailureState, stepS
  * missing face from the submitted asset.
  */
 export declare function hasHardBlockingQualityFailure(checks: QualityCheckResults, reviewMode?: ReviewMode): boolean;
+/**
+ * A document corner failure is "retry-escapable" when there is no confident
+ * cut-off evidence. The live detector (especially the sobel fallback on iOS
+ * Safari) can under-bound a document that is fully in frame and report
+ * corners_visible=false — the off-center "Show all 4 corners of the ID."
+ * loop-trap, where the user is stuck on Retake forever.
+ *
+ * This lets the bounded Submit-Anyway override (only after the retry threshold)
+ * apply to those false positives, while a genuine cut-off (cutOffRisk 'high' —
+ * a truly clipped ID missing data/MRZ) stays non-escapable. The submitted image
+ * is the uncropped original and the case is still routed for manual review, so
+ * this is bounded relief, not blind trust.
+ */
+export declare function isRetryEscapableDocumentCornerFailure(checks: QualityCheckResults, cutOffRisk?: string | null, reviewMode?: ReviewMode): boolean;
 /**
  * Infer the non-ID review mode from the submitted document/proof type.
  *

package/dist/esm/quality-checks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quality-checks.d.ts","sourceRoot":"","sources":["../../src/quality-checks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"quality-checks.d.ts","sourceRoot":"","sources":["../../src/quality-checks.ts"],"names":[],"mappings":"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"}