@fiado/type-kit 3.252.0 → 3.253.0

package/bin/biometrics/dtos/responses/BiometricVerificationResponse.d.ts

@@ -0,0 +1,87 @@
+import { BiometricDeliveryModeEnum } from '../../enums/BiometricDeliveryModeEnum';
+import { BiometricProviderEnum } from '../../enums/BiometricProviderEnum';
+import { BiometricResultEnum } from '../../enums/BiometricResultEnum';
+import { BiometricTypeEnum } from '../../enums/BiometricTypeEnum';
+import { BiometricVerificationStatusEnum } from '../../enums/BiometricVerificationStatusEnum';
+import type { BiometricDelivery } from '../BiometricDelivery';
+/**
+ * El estado completo de una verificación biométrica.
+ *
+ * 🔴 **El MISMO tipo lo devuelven el `POST` y el `GET`** (DEC-012). Es una excepción consciente a
+ * "1 DTO por endpoint": el `POST` devuelve el estado inicial del MISMO recurso que el `GET` expone
+ * después. Duplicar el tipo garantizaría drift entre los dos — la clase de bug donde el `GET` gana
+ * un campo y el `POST` no, y el caller descubre la diferencia en producción. Queda registrado acá
+ * para que no haya que re-discutirlo en cada PR.
+ *
+ * `biometrics-business` — Entrega 1.
+ */
+export declare class BiometricVerificationResponse {
+    /**
+     * La llave de todo. Se genera al crear, viaja dentro de la metadata del proveedor, y vuelve
+     * ECOADA en cada webhook — **por eso la correlación es un `get` por PK y no una búsqueda**.
+     */
+    biometricVerificationId: string;
+    /** Eco de lo que pediste. */
+    type: BiometricTypeEnum;
+    /** Eco de lo que pediste. */
+    provider: BiometricProviderEnum;
+    /** Eco de lo que pediste. */
+    directoryId: string;
+    /** Dónde va el PROCESO. Ver `BiometricVerificationStatusEnum`. */
+    status: BiometricVerificationStatusEnum;
+    /**
+     * Qué dijo el BIOMÉTRICO. Ver `BiometricResultEnum`.
+     *
+     * ⚠️ Puede venir poblado con `status` todavía en `IN_PROGRESS`: el veredicto del facematch llega
+     * en el `step_completed`, antes del cierre de la verificación. Eso no es una inconsistencia, es
+     * exactamente la razón de que `status` y `result` sean campos distintos.
+     */
+    result: BiometricResultEnum;
+    /** Discriminador de `delivery`. Ver `BiometricDeliveryModeEnum`. */
+    deliveryMode: BiometricDeliveryModeEnum;
+    /**
+     * Lo que necesitas para ejecutar el biométrico. Su forma depende de `deliveryMode` — haz el
+     * `switch`, no leas `link` a ciegas.
+     *
+     * Sin decorador de validación a propósito: es una unión discriminada y `class-validator` no
+     * sabe validar uniones sin un `@Type()` con discriminador que acá agregaría más ceremonia que
+     * seguridad. El contrato lo garantiza el productor, que es un solo lambda.
+     */
+    delivery: BiometricDelivery;
+    /**
+     * Similitud reportada por el proveedor, 0–100, cuando la expone. Rekognition da score; Metamap
+     * responde pass/fail y esto viene ausente.
+     *
+     * ⚠️ **No lo uses para decidir tú el umbral.** El proveedor ya aplicó el suyo y eso es lo que
+     * dice `result`. Esto es para diagnóstico y para calibrar, no para re-juzgar.
+     */
+    score?: number;
+    /** Umbral que aplicó el proveedor, cuando lo expone. Contexto para leer el `score`. */
+    threshold?: number;
+    /**
+     * El id de la verificación del lado del proveedor (en Metamap, su `verificationId`). Para
+     * soporte y reconciliación: es lo que se busca en el panel del proveedor.
+     */
+    providerRef?: string;
+    /** Tu correlación, tal cual la mandaste. */
+    callerContext?: string;
+    /**
+     * Por qué falló, solo con `status = FAILED`. Texto OPERACIONAL, sin PII y sin nada del
+     * proveedor: describe qué se rompió de nuestro lado (DEC-013).
+     */
+    failureReason?: string;
+    /**
+     * Todas las marcas de tiempo son **`string` ISO-8601 UTC con `Z`**.
+     *
+     * ⚠️ En la tabla se persisten como `Number` (dynamoose serializa `Date` a number, y un GSI
+     * declarado `S` sobre un timestamp se rompe en silencio). El mapeo Row → DTO es explícito. Si
+     * copias este tipo para el `Row`, rompes el índice.
+     */
+    createdAt: string;
+    /** Última vez que cambió algo. ISO-8601 UTC con `Z`. */
+    updatedAt: string;
+    /** Cuándo vence la entrega. Es lo que el `GET` compara para persistir `EXPIRED` (DEC-015). */
+    expiresAt: string;
+    /** Cuándo alcanzó un estado terminal. Ausente mientras siga viva. */
+    completedAt?: string;
+}

package/bin/biometrics/dtos/responses/BiometricVerificationResponse.js

@@ -0,0 +1,131 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BiometricVerificationResponse = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const BiometricDeliveryModeEnum_1 = require("../../enums/BiometricDeliveryModeEnum");
+const BiometricProviderEnum_1 = require("../../enums/BiometricProviderEnum");
+const BiometricResultEnum_1 = require("../../enums/BiometricResultEnum");
+const BiometricTypeEnum_1 = require("../../enums/BiometricTypeEnum");
+const BiometricVerificationStatusEnum_1 = require("../../enums/BiometricVerificationStatusEnum");
+/**
+ * El estado completo de una verificación biométrica.
+ *
+ * 🔴 **El MISMO tipo lo devuelven el `POST` y el `GET`** (DEC-012). Es una excepción consciente a
+ * "1 DTO por endpoint": el `POST` devuelve el estado inicial del MISMO recurso que el `GET` expone
+ * después. Duplicar el tipo garantizaría drift entre los dos — la clase de bug donde el `GET` gana
+ * un campo y el `POST` no, y el caller descubre la diferencia en producción. Queda registrado acá
+ * para que no haya que re-discutirlo en cada PR.
+ *
+ * `biometrics-business` — Entrega 1.
+ */
+class BiometricVerificationResponse {
+}
+exports.BiometricVerificationResponse = BiometricVerificationResponse;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], BiometricVerificationResponse.prototype, "biometricVerificationId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(BiometricTypeEnum_1.BiometricTypeEnum),
+    __metadata("design:type", String)
+], BiometricVerificationResponse.prototype, "type", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(BiometricProviderEnum_1.BiometricProviderEnum),
+    __metadata("design:type", String)
+], BiometricVerificationResponse.prototype, "provider", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], BiometricVerificationResponse.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(BiometricVerificationStatusEnum_1.BiometricVerificationStatusEnum),
+    __metadata("design:type", String)
+], BiometricVerificationResponse.prototype, "status", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(BiometricResultEnum_1.BiometricResultEnum),
+    __metadata("design:type", String)
+], BiometricVerificationResponse.prototype, "result", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(BiometricDeliveryModeEnum_1.BiometricDeliveryModeEnum),
+    __metadata("design:type", String)
+], BiometricVerificationResponse.prototype, "deliveryMode", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Object)
+], BiometricVerificationResponse.prototype, "delivery", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], BiometricVerificationResponse.prototype, "score", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], BiometricVerificationResponse.prototype, "threshold", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], BiometricVerificationResponse.prototype, "providerRef", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(256),
+    __metadata("design:type", String)
+], BiometricVerificationResponse.prototype, "callerContext", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], BiometricVerificationResponse.prototype, "failureReason", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsISO8601)({ strict: true }),
+    __metadata("design:type", String)
+], BiometricVerificationResponse.prototype, "createdAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsISO8601)({ strict: true }),
+    __metadata("design:type", String)
+], BiometricVerificationResponse.prototype, "updatedAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsISO8601)({ strict: true }),
+    __metadata("design:type", String)
+], BiometricVerificationResponse.prototype, "expiresAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsISO8601)({ strict: true }),
+    __metadata("design:type", String)
+], BiometricVerificationResponse.prototype, "completedAt", void 0);

package/bin/biometrics/enums/BiometricDeliveryModeEnum.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CÓMO se le entrega al caller lo que necesita para ejecutar el biométrico. **Es el discriminador
+ * de `BiometricVerificationResponse.delivery`.**
+ *
+ * 🔴 **Esta es la pieza que hace genérico al contrato, y la razón de que exista este servicio.**
+ * Los proveedores no se parecen en nada:
+ *
+ * | Proveedor | Qué entrega | Quién ejecuta | Cómo vuelve el resultado |
+ * |---|---|---|---|
+ * | Metamap  | un link hospedado | el navegador del usuario | webhook async |
+ * | Apple/Google | un challenge + nonce | el dispositivo, on-device | attestation que devuelve el cliente |
+ * | Amazon   | nada (se mandan imágenes) | nuestro servidor | síncrono, con score |
+ *
+ * Si la respuesta fuera `{ link }` a secas, **solo Metamap entraría** y el día que llegue Apple
+ * habría que romper el contrato con todos los callers ya escritos. Discriminar por el MODO —y no
+ * por el proveedor— deja que entre cualquiera de los tres sin tocar a nadie.
+ *
+ * El `GET` de polling NO cambia entre modos: devuelve estado, no mecanismo.
+ *
+ * `biometrics-business` — Entrega 1 (solo `REDIRECT` produce valores reales).
+ */
+export declare enum BiometricDeliveryModeEnum {
+    /** `delivery` trae `{ link, expiresAt }`. El usuario abre el link y ejecuta ahí. */
+    REDIRECT = "REDIRECT",
+    /** `delivery` trae `{ challenge, nonce, expiresAt }`. El dispositivo firma y devuelve. */
+    CHALLENGE = "CHALLENGE",
+    /** `delivery` viene vacío: el biométrico ya corrió y `result` viene poblado en la misma respuesta. */
+    IMMEDIATE = "IMMEDIATE"
+}

package/bin/biometrics/enums/BiometricDeliveryModeEnum.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BiometricDeliveryModeEnum = void 0;
+/**
+ * CÓMO se le entrega al caller lo que necesita para ejecutar el biométrico. **Es el discriminador
+ * de `BiometricVerificationResponse.delivery`.**
+ *
+ * 🔴 **Esta es la pieza que hace genérico al contrato, y la razón de que exista este servicio.**
+ * Los proveedores no se parecen en nada:
+ *
+ * | Proveedor | Qué entrega | Quién ejecuta | Cómo vuelve el resultado |
+ * |---|---|---|---|
+ * | Metamap  | un link hospedado | el navegador del usuario | webhook async |
+ * | Apple/Google | un challenge + nonce | el dispositivo, on-device | attestation que devuelve el cliente |
+ * | Amazon   | nada (se mandan imágenes) | nuestro servidor | síncrono, con score |
+ *
+ * Si la respuesta fuera `{ link }` a secas, **solo Metamap entraría** y el día que llegue Apple
+ * habría que romper el contrato con todos los callers ya escritos. Discriminar por el MODO —y no
+ * por el proveedor— deja que entre cualquiera de los tres sin tocar a nadie.
+ *
+ * El `GET` de polling NO cambia entre modos: devuelve estado, no mecanismo.
+ *
+ * `biometrics-business` — Entrega 1 (solo `REDIRECT` produce valores reales).
+ */
+var BiometricDeliveryModeEnum;
+(function (BiometricDeliveryModeEnum) {
+    /** `delivery` trae `{ link, expiresAt }`. El usuario abre el link y ejecuta ahí. */
+    BiometricDeliveryModeEnum["REDIRECT"] = "REDIRECT";
+    /** `delivery` trae `{ challenge, nonce, expiresAt }`. El dispositivo firma y devuelve. */
+    BiometricDeliveryModeEnum["CHALLENGE"] = "CHALLENGE";
+    /** `delivery` viene vacío: el biométrico ya corrió y `result` viene poblado en la misma respuesta. */
+    BiometricDeliveryModeEnum["IMMEDIATE"] = "IMMEDIATE";
+})(BiometricDeliveryModeEnum || (exports.BiometricDeliveryModeEnum = BiometricDeliveryModeEnum = {}));

package/bin/biometrics/enums/BiometricEventTypeEnum.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Qué le pasó a la verificación, según el proveedor. Viaja en `BiometricVerificationChangedV1` y es
+ * lo que el consumer usa para decidir la transición de estado.
+ *
+ * Es el vocabulario NUESTRO, no el de Metamap: `kyc-metamap-webhook` traduce sus `eventName` a
+ * estos cuatro antes de publicar. Así el consumer no aprende el catálogo de un proveedor externo, y
+ * el día que entre otro proveedor traduce a los mismos cuatro.
+ *
+ * `biometrics-business` — Entrega 1.
+ */
+export declare enum BiometricEventTypeEnum {
+    /** El usuario arrancó la verificación. → `IN_PROGRESS`. */
+    VERIFICATION_STARTED = "VERIFICATION_STARTED",
+    /**
+     * Cerró una estación con resultado. Es el que trae el veredicto del facematch, ANTES del cierre:
+     * por eso `result` puede quedar poblado con `status` todavía en `IN_PROGRESS`.
+     */
+    STEP_COMPLETED = "STEP_COMPLETED",
+    /** El proveedor cerró la verificación. → `COMPLETED`. */
+    VERIFICATION_COMPLETED = "VERIFICATION_COMPLETED",
+    /**
+     * El proveedor la dio por vencida. → `EXPIRED`.
+     *
+     * ⚠️ **No se depende de este evento para expirar.** El `GET` persiste `EXPIRED` comparando
+     * contra `expiresAt` (DEC-015), así que una verificación vence aunque este evento nunca llegue.
+     */
+    VERIFICATION_EXPIRED = "VERIFICATION_EXPIRED"
+}

package/bin/biometrics/enums/BiometricEventTypeEnum.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BiometricEventTypeEnum = void 0;
+/**
+ * Qué le pasó a la verificación, según el proveedor. Viaja en `BiometricVerificationChangedV1` y es
+ * lo que el consumer usa para decidir la transición de estado.
+ *
+ * Es el vocabulario NUESTRO, no el de Metamap: `kyc-metamap-webhook` traduce sus `eventName` a
+ * estos cuatro antes de publicar. Así el consumer no aprende el catálogo de un proveedor externo, y
+ * el día que entre otro proveedor traduce a los mismos cuatro.
+ *
+ * `biometrics-business` — Entrega 1.
+ */
+var BiometricEventTypeEnum;
+(function (BiometricEventTypeEnum) {
+    /** El usuario arrancó la verificación. → `IN_PROGRESS`. */
+    BiometricEventTypeEnum["VERIFICATION_STARTED"] = "VERIFICATION_STARTED";
+    /**
+     * Cerró una estación con resultado. Es el que trae el veredicto del facematch, ANTES del cierre:
+     * por eso `result` puede quedar poblado con `status` todavía en `IN_PROGRESS`.
+     */
+    BiometricEventTypeEnum["STEP_COMPLETED"] = "STEP_COMPLETED";
+    /** El proveedor cerró la verificación. → `COMPLETED`. */
+    BiometricEventTypeEnum["VERIFICATION_COMPLETED"] = "VERIFICATION_COMPLETED";
+    /**
+     * El proveedor la dio por vencida. → `EXPIRED`.
+     *
+     * ⚠️ **No se depende de este evento para expirar.** El `GET` persiste `EXPIRED` comparando
+     * contra `expiresAt` (DEC-015), así que una verificación vence aunque este evento nunca llegue.
+     */
+    BiometricEventTypeEnum["VERIFICATION_EXPIRED"] = "VERIFICATION_EXPIRED";
+})(BiometricEventTypeEnum || (exports.BiometricEventTypeEnum = BiometricEventTypeEnum = {}));

package/bin/biometrics/enums/BiometricProviderEnum.d.ts

@@ -0,0 +1,25 @@
+/**
+ * QUIÉN ejecuta el biométrico. Ortogonal a `BiometricTypeEnum`: el mismo `FACEMATCH` lo puede
+ * resolver Metamap con un link o Amazon con una llamada síncrona.
+ *
+ * 🔴 **Es OBLIGATORIO en el request** (DEC-004, decisión de Andres 2026-07-30). El caller nombra al
+ * proveedor en vez de dejar que `biometrics-business` resuelva un default.
+ *
+ * **Consecuencia registrada (TD-001):** cambiar de proveedor obliga a tocar y redesplegar a TODOS
+ * los callers. Se aceptó a cambio de que la elección sea explícita y auditable en cada request.
+ *
+ * Solo `METAMAP` está implementado. Los otros tres cambian el MODO DE ENTREGA, no solo el
+ * proveedor — por eso existe `BiometricDeliveryModeEnum`.
+ *
+ * `biometrics-business` — Entrega 1.
+ */
+export declare enum BiometricProviderEnum {
+    /** El único implementado. Entrega por link hospedado + webhook async → `REDIRECT`. */
+    METAMAP = "METAMAP",
+    /** Face ID, on-device. Entregaría un challenge y recibiría una attestation → `CHALLENGE`. */
+    APPLE = "APPLE",
+    /** Biometría de Android, on-device. Mismo modo que Apple → `CHALLENGE`. */
+    GOOGLE = "GOOGLE",
+    /** Rekognition: comparación en servidor, con score. Respuesta síncrona → `IMMEDIATE`. */
+    AWS = "AWS"
+}

package/bin/biometrics/enums/BiometricProviderEnum.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BiometricProviderEnum = void 0;
+/**
+ * QUIÉN ejecuta el biométrico. Ortogonal a `BiometricTypeEnum`: el mismo `FACEMATCH` lo puede
+ * resolver Metamap con un link o Amazon con una llamada síncrona.
+ *
+ * 🔴 **Es OBLIGATORIO en el request** (DEC-004, decisión de Andres 2026-07-30). El caller nombra al
+ * proveedor en vez de dejar que `biometrics-business` resuelva un default.
+ *
+ * **Consecuencia registrada (TD-001):** cambiar de proveedor obliga a tocar y redesplegar a TODOS
+ * los callers. Se aceptó a cambio de que la elección sea explícita y auditable en cada request.
+ *
+ * Solo `METAMAP` está implementado. Los otros tres cambian el MODO DE ENTREGA, no solo el
+ * proveedor — por eso existe `BiometricDeliveryModeEnum`.
+ *
+ * `biometrics-business` — Entrega 1.
+ */
+var BiometricProviderEnum;
+(function (BiometricProviderEnum) {
+    /** El único implementado. Entrega por link hospedado + webhook async → `REDIRECT`. */
+    BiometricProviderEnum["METAMAP"] = "METAMAP";
+    /** Face ID, on-device. Entregaría un challenge y recibiría una attestation → `CHALLENGE`. */
+    BiometricProviderEnum["APPLE"] = "APPLE";
+    /** Biometría de Android, on-device. Mismo modo que Apple → `CHALLENGE`. */
+    BiometricProviderEnum["GOOGLE"] = "GOOGLE";
+    /** Rekognition: comparación en servidor, con score. Respuesta síncrona → `IMMEDIATE`. */
+    BiometricProviderEnum["AWS"] = "AWS";
+})(BiometricProviderEnum || (exports.BiometricProviderEnum = BiometricProviderEnum = {}));

package/bin/biometrics/enums/BiometricResultEnum.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Qué dijo el BIOMÉTRICO. Ortogonal a `BiometricVerificationStatusEnum`, que dice dónde va el
+ * proceso — ver el comentario de ese enum para por qué van separados.
+ *
+ * `biometrics-business` — Entrega 1.
+ */
+export declare enum BiometricResultEnum {
+    /**
+     * Todavía no hay veredicto. Es el valor inicial y también el de los terminales que cierran sin
+     * resultado (`EXPIRED`, `FAILED`).
+     *
+     * ⚠️ `UNKNOWN` **no es** `NO_MATCH`. Tratarlos igual convierte "el usuario nunca abrió el link"
+     * en "el usuario no es quien dice ser" — que es una acusación, no un dato.
+     */
+    UNKNOWN = "UNKNOWN",
+    /** Coincide con la referencia. En Metamap: el step `facematch-service-validation` sin `error`. */
+    MATCH = "MATCH",
+    /** No coincide. Es un veredicto real del proveedor, no una falla de proceso. */
+    NO_MATCH = "NO_MATCH",
+    /**
+     * El biométrico corrió pero no concluye (mala iluminación, foto de referencia pobre, score en la
+     * zona gris). Distinto de `UNKNOWN`: acá sí hubo intento.
+     */
+    INCONCLUSIVE = "INCONCLUSIVE"
+}

package/bin/biometrics/enums/BiometricResultEnum.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BiometricResultEnum = void 0;
+/**
+ * Qué dijo el BIOMÉTRICO. Ortogonal a `BiometricVerificationStatusEnum`, que dice dónde va el
+ * proceso — ver el comentario de ese enum para por qué van separados.
+ *
+ * `biometrics-business` — Entrega 1.
+ */
+var BiometricResultEnum;
+(function (BiometricResultEnum) {
+    /**
+     * Todavía no hay veredicto. Es el valor inicial y también el de los terminales que cierran sin
+     * resultado (`EXPIRED`, `FAILED`).
+     *
+     * ⚠️ `UNKNOWN` **no es** `NO_MATCH`. Tratarlos igual convierte "el usuario nunca abrió el link"
+     * en "el usuario no es quien dice ser" — que es una acusación, no un dato.
+     */
+    BiometricResultEnum["UNKNOWN"] = "UNKNOWN";
+    /** Coincide con la referencia. En Metamap: el step `facematch-service-validation` sin `error`. */
+    BiometricResultEnum["MATCH"] = "MATCH";
+    /** No coincide. Es un veredicto real del proveedor, no una falla de proceso. */
+    BiometricResultEnum["NO_MATCH"] = "NO_MATCH";
+    /**
+     * El biométrico corrió pero no concluye (mala iluminación, foto de referencia pobre, score en la
+     * zona gris). Distinto de `UNKNOWN`: acá sí hubo intento.
+     */
+    BiometricResultEnum["INCONCLUSIVE"] = "INCONCLUSIVE";
+})(BiometricResultEnum || (exports.BiometricResultEnum = BiometricResultEnum = {}));

package/bin/biometrics/enums/BiometricTypeEnum.d.ts

@@ -0,0 +1,20 @@
+/**
+ * QUÉ biométrico se pide. Es el discriminador del caso de uso, independiente de quién lo ejecute
+ * (eso lo dice `BiometricProviderEnum`).
+ *
+ * 🔴 **Solo `FACEMATCH` está implementado.** Los demás están declarados a propósito: el contrato
+ * nace genérico para que agregar un biométrico no obligue a romperlo. Pedir uno no implementado
+ * devuelve `BIOMETRIC_NOT_SUPPORTED` (422) — un error explícito y accionable, nunca un 500.
+ *
+ * `biometrics-business` — Entrega 1.
+ */
+export declare enum BiometricTypeEnum {
+    /** Comparar la selfie del momento contra una foto de referencia ya registrada. */
+    FACEMATCH = "FACEMATCH",
+    /** ¿Hay una persona viva frente a la cámara? Declarado, sin implementar. */
+    LIVENESS = "LIVENESS",
+    /** Verificación por voz. Declarado, sin implementar. */
+    VOICE = "VOICE",
+    /** Comparar la cara contra la foto impresa en el documento. Declarado, sin implementar. */
+    DOCUMENT_MATCH = "DOCUMENT_MATCH"
+}

package/bin/biometrics/enums/BiometricTypeEnum.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BiometricTypeEnum = void 0;
+/**
+ * QUÉ biométrico se pide. Es el discriminador del caso de uso, independiente de quién lo ejecute
+ * (eso lo dice `BiometricProviderEnum`).
+ *
+ * 🔴 **Solo `FACEMATCH` está implementado.** Los demás están declarados a propósito: el contrato
+ * nace genérico para que agregar un biométrico no obligue a romperlo. Pedir uno no implementado
+ * devuelve `BIOMETRIC_NOT_SUPPORTED` (422) — un error explícito y accionable, nunca un 500.
+ *
+ * `biometrics-business` — Entrega 1.
+ */
+var BiometricTypeEnum;
+(function (BiometricTypeEnum) {
+    /** Comparar la selfie del momento contra una foto de referencia ya registrada. */
+    BiometricTypeEnum["FACEMATCH"] = "FACEMATCH";
+    /** ¿Hay una persona viva frente a la cámara? Declarado, sin implementar. */
+    BiometricTypeEnum["LIVENESS"] = "LIVENESS";
+    /** Verificación por voz. Declarado, sin implementar. */
+    BiometricTypeEnum["VOICE"] = "VOICE";
+    /** Comparar la cara contra la foto impresa en el documento. Declarado, sin implementar. */
+    BiometricTypeEnum["DOCUMENT_MATCH"] = "DOCUMENT_MATCH";
+})(BiometricTypeEnum || (exports.BiometricTypeEnum = BiometricTypeEnum = {}));

package/bin/biometrics/enums/BiometricVerificationStatusEnum.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Dónde va el PROCESO de la verificación. **No dice cómo salió el biométrico** — eso es
+ * `BiometricResultEnum`.
+ *
+ * 🔴 **Están separados a propósito.** Aplastar los dos en un solo campo hace ambiguo un caso real y
+ * frecuente: el facematch ya dio `MATCH` (llegó el `step_completed`) pero la verificación todavía no
+ * cerró (falta el `verification_completed`). Con un campo único no hay forma de decir eso sin
+ * mentir en alguna dirección.
+ *
+ * **Los terminales no retroceden.** `COMPLETED`, `EXPIRED` y `FAILED` no vuelven a `IN_PROGRESS`
+ * aunque llegue un evento posterior — SQS no garantiza orden y la cola es at-least-once.
+ *
+ * `biometrics-business` — Entrega 1.
+ */
+export declare enum BiometricVerificationStatusEnum {
+    /** Se emitió la entrega (link/challenge) y nadie la ha ejecutado todavía. */
+    PENDING = "PENDING",
+    /** El usuario arrancó. Puede haber resultados parciales de estaciones. */
+    IN_PROGRESS = "IN_PROGRESS",
+    /** El proveedor cerró la verificación. `result` tiene el veredicto final. */
+    COMPLETED = "COMPLETED",
+    /**
+     * Venció sin completarse. Lo escribe el proveedor (`verification_expired`) **o** el propio `GET`
+     * al detectar `now > expiresAt` — y en ese caso lo PERSISTE (DEC-015). Si se calculara sin
+     * persistir, un cierre tardío escribiría `COMPLETED` sobre algo que el caller ya vio `EXPIRED`.
+     */
+    EXPIRED = "EXPIRED",
+    /**
+     * Falla interna procesando la verificación. **El proveedor NO lo produce**: el catálogo de
+     * eventos de Metamap no tiene ninguno de error (DEC-013). `failureReason` es nuestro.
+     */
+    FAILED = "FAILED"
+}

package/bin/biometrics/enums/BiometricVerificationStatusEnum.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BiometricVerificationStatusEnum = void 0;
+/**
+ * Dónde va el PROCESO de la verificación. **No dice cómo salió el biométrico** — eso es
+ * `BiometricResultEnum`.
+ *
+ * 🔴 **Están separados a propósito.** Aplastar los dos en un solo campo hace ambiguo un caso real y
+ * frecuente: el facematch ya dio `MATCH` (llegó el `step_completed`) pero la verificación todavía no
+ * cerró (falta el `verification_completed`). Con un campo único no hay forma de decir eso sin
+ * mentir en alguna dirección.
+ *
+ * **Los terminales no retroceden.** `COMPLETED`, `EXPIRED` y `FAILED` no vuelven a `IN_PROGRESS`
+ * aunque llegue un evento posterior — SQS no garantiza orden y la cola es at-least-once.
+ *
+ * `biometrics-business` — Entrega 1.
+ */
+var BiometricVerificationStatusEnum;
+(function (BiometricVerificationStatusEnum) {
+    /** Se emitió la entrega (link/challenge) y nadie la ha ejecutado todavía. */
+    BiometricVerificationStatusEnum["PENDING"] = "PENDING";
+    /** El usuario arrancó. Puede haber resultados parciales de estaciones. */
+    BiometricVerificationStatusEnum["IN_PROGRESS"] = "IN_PROGRESS";
+    /** El proveedor cerró la verificación. `result` tiene el veredicto final. */
+    BiometricVerificationStatusEnum["COMPLETED"] = "COMPLETED";
+    /**
+     * Venció sin completarse. Lo escribe el proveedor (`verification_expired`) **o** el propio `GET`
+     * al detectar `now > expiresAt` — y en ese caso lo PERSISTE (DEC-015). Si se calculara sin
+     * persistir, un cierre tardío escribiría `COMPLETED` sobre algo que el caller ya vio `EXPIRED`.
+     */
+    BiometricVerificationStatusEnum["EXPIRED"] = "EXPIRED";
+    /**
+     * Falla interna procesando la verificación. **El proveedor NO lo produce**: el catálogo de
+     * eventos de Metamap no tiene ninguno de error (DEC-013). `failureReason` es nuestro.
+     */
+    BiometricVerificationStatusEnum["FAILED"] = "FAILED";
+})(BiometricVerificationStatusEnum || (exports.BiometricVerificationStatusEnum = BiometricVerificationStatusEnum = {}));