@fiado/type-kit 3.406.0 → 3.408.0

package/_test_/unit/biometrics/BiometricReferenceSourceEnum.test.ts

@@ -0,0 +1,18 @@
+import 'reflect-metadata';
+import { BiometricReferenceSourceEnum } from '../../../src/biometrics/index';
+
+describe('BiometricReferenceSourceEnum', () => {
+  it('tiene exactamente los tres valores del contrato', () => {
+    expect(Object.values(BiometricReferenceSourceEnum).sort()).toEqual([
+      'CALLER_PROVIDED',
+      'ID_DOCUMENT',
+      'KYC_SELFIE',
+    ]);
+  });
+
+  it('cada clave es igual a su valor', () => {
+    for (const [clave, valor] of Object.entries(BiometricReferenceSourceEnum)) {
+      expect(clave).toBe(valor);
+    }
+  });
+});

package/_test_/unit/biometrics/BiometricVerificationResponse.test.ts

@@ -0,0 +1,63 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+  BiometricVerificationResponse,
+  BiometricReferenceSourceEnum,
+} from '../../../src/biometrics/index';
+
+/** La respuesta mínima válida: todos los campos obligatorios del contrato. */
+const base = {
+  biometricVerificationId: 'bio-1',
+  type: 'FACEMATCH',
+  provider: 'METAMAP',
+  directoryId: 'dir-1',
+  status: 'IN_PROGRESS',
+  result: 'UNKNOWN',
+  deliveryMode: 'REDIRECT',
+  delivery: { link: 'https://sk.fiado.test/abc', expiresAt: '2026-09-04T17:00:00.000Z' },
+  referenceImageSource: 'KYC_SELFIE',
+  createdAt: '2026-09-04T16:00:00.000Z',
+  updatedAt: '2026-09-04T16:00:00.000Z',
+  expiresAt: '2026-09-04T17:00:00.000Z',
+};
+
+const instancia = (raw: Record<string, unknown>): BiometricVerificationResponse =>
+  plainToInstance(BiometricVerificationResponse, raw, { excludeExtraneousValues: true });
+
+const propiedadesConError = async (raw: Record<string, unknown>): Promise<string[]> =>
+  (await validate(instancia(raw) as object)).map((e) => e.property);
+
+describe('BiometricVerificationResponse', () => {
+  it('valida la respuesta mínima', async () => {
+    expect(await propiedadesConError(base)).toEqual([]);
+  });
+
+  /**
+   * El eco de contra qué foto se comparó. Acá sí entran los TRES valores: `CALLER_PROVIDED` es de
+   * salida y decir `KYC_SELFIE` cuando la foto la puso el caller sería mentir sobre la comparación.
+   */
+  describe('referenceImageSource', () => {
+    it.each(['KYC_SELFIE', 'ID_DOCUMENT', 'CALLER_PROVIDED'])('acepta %s', async (fuente) => {
+      const dto = instancia({ ...base, referenceImageSource: fuente });
+
+      expect(await validate(dto as object)).toHaveLength(0);
+      expect(dto.referenceImageSource).toBe(fuente);
+    });
+
+    it('rechaza la respuesta sin referenceImageSource: siempre viene poblado', async () => {
+      const { referenceImageSource: _omitido, ...sinFuente } = base;
+
+      expect(await propiedadesConError(sinFuente)).toContain('referenceImageSource');
+    });
+
+    it('rechaza un valor fuera del enum', async () => {
+      expect(await propiedadesConError({ ...base, referenceImageSource: 'PROFILE_PICTURE' }))
+        .toContain('referenceImageSource');
+    });
+
+    it('sobrevive al plainToInstance con excludeExtraneousValues (lleva @Expose)', () => {
+      expect(instancia(base).referenceImageSource).toBe(BiometricReferenceSourceEnum.KYC_SELFIE);
+    });
+  });
+});

package/_test_/unit/biometrics/CreateBiometricVerificationRequest.test.ts

@@ -5,6 +5,7 @@ import {
   CreateBiometricVerificationRequest,
   BiometricProviderEnum,
   BiometricTypeEnum,
+  BiometricReferenceSourceEnum,
 } from '../../../src/biometrics/index';
 
 /** El request mínimo válido: los 4 campos obligatorios. */
@@ -133,4 +134,60 @@ describe('CreateBiometricVerificationRequest', () => {
       expect(instancia({ ...base, deliveryMode: 'EMBEDDED_SDK' }).deliveryMode).toBe('EMBEDDED_SDK');
     });
   });
+
+  /**
+   * `referenceImageSource` elige contra QUÉ foto se compara. Solo dos de los tres valores del enum
+   * son legales de entrada: `CALLER_PROVIDED` lo emite la respuesta, no lo pide el caller.
+   */
+  describe('referenceImageSource', () => {
+    it('acepta ID_DOCUMENT', async () => {
+      const dto = instancia({ ...base, referenceImageSource: 'ID_DOCUMENT' });
+
+      expect(await validate(dto as object)).toHaveLength(0);
+      expect(dto.referenceImageSource).toBe(BiometricReferenceSourceEnum.ID_DOCUMENT);
+    });
+
+    it('acepta KYC_SELFIE', async () => {
+      const dto = instancia({ ...base, referenceImageSource: 'KYC_SELFIE' });
+
+      expect(await validate(dto as object)).toHaveLength(0);
+      expect(dto.referenceImageSource).toBe(BiometricReferenceSourceEnum.KYC_SELFIE);
+    });
+
+    /**
+     * Llega ausente, no con el default puesto: el default lo aplica el manager. Poblarlo acá haría
+     * indistinguible el request que mandó la fuente del que solo mandó `referenceImageUrl`.
+     */
+    it('es opcional y NO se autopobla con el default', async () => {
+      const dto = instancia(base);
+
+      expect(await validate(dto as object)).toHaveLength(0);
+      expect(dto.referenceImageSource).toBeUndefined();
+    });
+
+    it('RECHAZA CALLER_PROVIDED, que es solo de salida', async () => {
+      expect(await propiedadesConError({ ...base, referenceImageSource: 'CALLER_PROVIDED' }))
+        .toContain('referenceImageSource');
+    });
+
+    it('rechaza un valor que no está en el enum', async () => {
+      expect(await propiedadesConError({ ...base, referenceImageSource: 'PROFILE_PICTURE' }))
+        .toContain('referenceImageSource');
+    });
+  });
+
+    // El par tiene que pasar el DTO LIMPIO: quien rechaza el choque es el manager, con
+    // `422 CONFLICTING_REFERENCE_IMAGE`. Un validador cross-field acá le daria al caller un
+    // `400 VALIDATION_ERROR` generico en vez del codigo tipado que el front espera.
+    it('acepta referenceImageUrl y referenceImageSource juntos: el choque lo resuelve el manager', async () => {
+        const dto = instancia({
+            ...base,
+            referenceImageUrl: 'https://cdn.tufiado.com/foto.jpg',
+            referenceImageSource: BiometricReferenceSourceEnum.ID_DOCUMENT,
+        });
+
+        expect(await validate(dto)).toHaveLength(0);
+        expect(dto.referenceImageUrl).toBe('https://cdn.tufiado.com/foto.jpg');
+        expect(dto.referenceImageSource).toBe(BiometricReferenceSourceEnum.ID_DOCUMENT);
+    });
 });

package/_test_/unit/identity/PeopleIdPhotoResponse.test.ts

@@ -0,0 +1,33 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { PeopleIdPhotoResponse } from '../../../src/identity/index';
+
+const base = {
+    directoryId: '4cdc2e82-4bdc-4421-8c3a-c77dadea23b7',
+    url: 'https://s3.amazonaws.com/bucket/USER/dir/x_PASSPORT_FRONT.jpeg?X-Amz-Expires=900',
+    key: 'x_PASSPORT_FRONT.jpeg',
+    expiresInSeconds: 900,
+};
+
+const instancia = (raw: Record<string, unknown>): PeopleIdPhotoResponse =>
+    plainToInstance(PeopleIdPhotoResponse, raw, { excludeExtraneousValues: true });
+
+describe('PeopleIdPhotoResponse', () => {
+    it('acepta la respuesta completa', async () => {
+        const dto = instancia(base);
+        expect(await validate(dto)).toHaveLength(0);
+        expect(dto.key).toBe('x_PASSPORT_FRONT.jpeg');
+    });
+
+    it.each(['directoryId', 'url', 'key', 'expiresInSeconds'])('exige %s', async (campo) => {
+        const { [campo]: _, ...sinCampo } = base as Record<string, unknown>;
+        const errores = await validate(instancia(sinCampo));
+        expect(errores.map((e) => e.property)).toContain(campo);
+    });
+
+    it('rechaza una vigencia no positiva', async () => {
+        const errores = await validate(instancia({ ...base, expiresInSeconds: 0 }));
+        expect(errores.map((e) => e.property)).toContain('expiresInSeconds');
+    });
+});

package/bin/biometrics/dtos/requests/CreateBiometricVerificationRequest.d.ts

@@ -1,5 +1,6 @@
 import { BiometricDeliveryModeEnum } from '../../enums/BiometricDeliveryModeEnum';
 import { BiometricProviderEnum } from '../../enums/BiometricProviderEnum';
+import { BiometricReferenceSourceEnum } from '../../enums/BiometricReferenceSourceEnum';
 import { BiometricTypeEnum } from '../../enums/BiometricTypeEnum';
 import { BiometricSubject } from '../BiometricSubject';
 /**
@@ -56,6 +57,18 @@ export declare class CreateBiometricVerificationRequest {
      * Úsalo solo si ya tienes la foto correcta a mano y quieres ahorrarte el round-trip.
      */
     referenceImageUrl?: string;
+    /**
+     * Contra QUÉ foto se compara. Default `KYC_SELFIE`, que aplica el servicio: acá viaja ausente
+     * cuando no lo mandas, para que se pueda distinguir de haberlo pedido explícitamente.
+     *
+     * **Sin fallback:** si la fuente pedida no tiene foto, responde `REFERENCE_PHOTO_UNAVAILABLE`;
+     * no se busca la otra. Quien pide contra el documento y recibe un match sabe que fue contra el
+     * documento.
+     *
+     * 🔴 `CALLER_PROVIDED` NO es válido acá — solo lo emite la respuesta. Y mandar esto junto con
+     * `referenceImageUrl` responde `422 CONFLICTING_REFERENCE_IMAGE`: son contradictorios.
+     */
+    referenceImageSource?: BiometricReferenceSourceEnum.KYC_SELFIE | BiometricReferenceSourceEnum.ID_DOCUMENT;
     /**
      * Vigencia de la entrega, en segundos. Default 3600.
      *

package/bin/biometrics/dtos/requests/CreateBiometricVerificationRequest.js

@@ -14,6 +14,7 @@ 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 BiometricReferenceSourceEnum_1 = require("../../enums/BiometricReferenceSourceEnum");
 const BiometricTypeEnum_1 = require("../../enums/BiometricTypeEnum");
 const BiometricSubject_1 = require("../BiometricSubject");
 /**
@@ -65,6 +66,12 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], CreateBiometricVerificationRequest.prototype, "referenceImageUrl", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsIn)([BiometricReferenceSourceEnum_1.BiometricReferenceSourceEnum.KYC_SELFIE, BiometricReferenceSourceEnum_1.BiometricReferenceSourceEnum.ID_DOCUMENT]),
+    __metadata("design:type", String)
+], CreateBiometricVerificationRequest.prototype, "referenceImageSource", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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

@@ -1,5 +1,6 @@
 import { BiometricDeliveryModeEnum } from '../../enums/BiometricDeliveryModeEnum';
 import { BiometricProviderEnum } from '../../enums/BiometricProviderEnum';
+import { BiometricReferenceSourceEnum } from '../../enums/BiometricReferenceSourceEnum';
 import { BiometricResultEnum } from '../../enums/BiometricResultEnum';
 import { BiometricTypeEnum } from '../../enums/BiometricTypeEnum';
 import { BiometricVerificationStatusEnum } from '../../enums/BiometricVerificationStatusEnum';
@@ -48,6 +49,14 @@ export declare class BiometricVerificationResponse {
      * seguridad. El contrato lo garantiza el productor, que es un solo lambda.
      */
     delivery: BiometricDelivery;
+    /**
+     * Contra qué foto se comparó. **Siempre poblado.**
+     *
+     * `CALLER_PROVIDED` significa que la foto la mandaste tú en `referenceImageUrl`. Es un valor
+     * distinto y no el default, porque decir `KYC_SELFIE` cuando la foto la pusiste tú sería mentir
+     * sobre contra qué se comparó — y eso es exactamente lo que este campo existe para evitar.
+     */
+    referenceImageSource: BiometricReferenceSourceEnum;
     /**
      * Similitud reportada por el proveedor, 0–100, cuando la expone. Rekognition da score; Metamap
      * responde pass/fail y esto viene ausente.

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

@@ -14,6 +14,7 @@ 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 BiometricReferenceSourceEnum_1 = require("../../enums/BiometricReferenceSourceEnum");
 const BiometricResultEnum_1 = require("../../enums/BiometricResultEnum");
 const BiometricTypeEnum_1 = require("../../enums/BiometricTypeEnum");
 const BiometricVerificationStatusEnum_1 = require("../../enums/BiometricVerificationStatusEnum");
@@ -72,6 +73,11 @@ __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.IsEnum)(BiometricReferenceSourceEnum_1.BiometricReferenceSourceEnum),
+    __metadata("design:type", String)
+], BiometricVerificationResponse.prototype, "referenceImageSource", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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

@@ -0,0 +1,14 @@
+/**
+ * Contra QUÉ foto compara el biométrico.
+ *
+ * `CALLER_PROVIDED` es SOLO DE SALIDA: lo emite la respuesta cuando el caller mandó su propia
+ * `referenceImageUrl`. El request lo rechaza — pedirlo no significa nada.
+ */
+export declare enum BiometricReferenceSourceEnum {
+    /** La selfie del KYC. El default. */
+    KYC_SELFIE = "KYC_SELFIE",
+    /** El frente de la identificación, resuelto por `fiado-identity-lambda`. */
+    ID_DOCUMENT = "ID_DOCUMENT",
+    /** Solo de salida: la foto la puso el caller en `referenceImageUrl`. */
+    CALLER_PROVIDED = "CALLER_PROVIDED"
+}

package/bin/biometrics/enums/BiometricReferenceSourceEnum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BiometricReferenceSourceEnum = void 0;
+/**
+ * Contra QUÉ foto compara el biométrico.
+ *
+ * `CALLER_PROVIDED` es SOLO DE SALIDA: lo emite la respuesta cuando el caller mandó su propia
+ * `referenceImageUrl`. El request lo rechaza — pedirlo no significa nada.
+ */
+var BiometricReferenceSourceEnum;
+(function (BiometricReferenceSourceEnum) {
+    /** La selfie del KYC. El default. */
+    BiometricReferenceSourceEnum["KYC_SELFIE"] = "KYC_SELFIE";
+    /** El frente de la identificación, resuelto por `fiado-identity-lambda`. */
+    BiometricReferenceSourceEnum["ID_DOCUMENT"] = "ID_DOCUMENT";
+    /** Solo de salida: la foto la puso el caller en `referenceImageUrl`. */
+    BiometricReferenceSourceEnum["CALLER_PROVIDED"] = "CALLER_PROVIDED";
+})(BiometricReferenceSourceEnum || (exports.BiometricReferenceSourceEnum = BiometricReferenceSourceEnum = {}));

package/bin/biometrics/events/BiometricVerificationChangedV1.d.ts

@@ -4,20 +4,15 @@ import { BiometricResultEnum } from '../enums/BiometricResultEnum';
 /**
  * Lo que le pasó a una verificación biométrica, según el proveedor.
  *
- * **El recorrido:** Metamap → `kyc-metamap-webhook` (que valida la firma HMAC y traduce) →
- * `BiometricsInboundQueue` → el consumer de `biometrics-business`, que aplica la transición.
+ * **El recorrido:** Metamap → `kyc-metamap-webhook`, que valida la firma HMAC y traduce → llamada
+ * HTTP síncrona a `biometrics-business`, que aplica la transición.
  *
- * **Por qué el webhook no llama directo:** ese lambda tiene una disciplina explícita — *un fallo de
- * publish NUNCA puede tumbar el webhook*, porque si lanza, Metamap reintenta el webhook completo y
- * se duplican las actualizaciones de identidad. Con esa regla, una llamada síncrona que falle se
- * traga el evento en silencio y la verificación queda `IN_PROGRESS` para siempre, con el caller
- * poleando al vacío y sin alarma. La cola da durabilidad, DLQ y alarma sin tocar esa disciplina.
+ * 🔴 **No se loguea entero:**
+ * loguea los campos que necesites, nunca el objeto. El resto son identificadores operacionales y el
+ * veredicto.
  *
- * 🔴 **Cola propia, NO `RetailKycInboundQueue`.** SQS no hace broadcast: dos lambdas sobre la misma
- * cola son consumidores en competencia y cada mensaje le llega a UNO solo. Reusar la de SureKeep
- * partiría sus KYC a la mitad, en producción, al azar y sin un solo error en los logs.
- *
- * 🔴 **Sin PII.** Solo identificadores operacionales y el veredicto.
+ * Los duplicados son la norma —Metamap reintenta el webhook completo ante cualquier fallo—, así que
+ * el consumer deduplica por `eventId` y ordena por `occurredAt`.
  *
  * `biometrics-business` — Entrega 1.
  */
@@ -30,15 +25,12 @@ export declare class BiometricVerificationChangedV1 {
     /**
      * 🔴 **Identificador ÚNICO de este evento. La clave de deduplicación.**
      *
-     * SQS es *at-least-once*: los duplicados son la norma, no la excepción. Y **el candado temporal
-     * por `occurredAt` NO alcanza para esto**: dos entregas del mismo evento traen exactamente el
-     * mismo `occurredAt`, así que una regla "descartar si es más viejo" las deja pasar a las dos.
+     * La entrega es *at-least-once*: Metamap reintenta el webhook completo, así que los duplicados
+     * son la norma, no la excepción. Y **el candado temporal por `occurredAt` NO alcanza para
+     * esto**: dos entregas del mismo evento traen exactamente el mismo `occurredAt`, así que una
+     * regla "descartar si es más viejo" las deja pasar a las dos.
      *
      * El consumer guarda los `eventId` ya aplicados y descarta los repetidos.
-     *
-     * ⚠️ **No deduplicar por el `MessageId` de SQS**: cambia en cada reintento de entrega, así que
-     * no deduplica nada. Es el error clásico y por eso queda escrito acá y no en la cabeza de cada
-     * consumidor.
      */
     eventId: string;
     /**
@@ -73,7 +65,7 @@ export declare class BiometricVerificationChangedV1 {
      * el evento real, y la transición no se aplicaría nunca — sin un solo error.
      *
      * Normalizar a UTC es trabajo del traductor del proveedor (`kyc-metamap-webhook`). Este candado
-     * existe para que si algún día deja de hacerlo, el mensaje caiga al DLQ en el boundary en vez de
+     * existe para que si algún día deja de hacerlo, el evento se rechace en el boundary en vez de
      * corromper el orden en silencio.
      */
     occurredAt: string;

package/bin/biometrics/events/BiometricVerificationChangedV1.js

@@ -18,20 +18,15 @@ const BiometricResultEnum_1 = require("../enums/BiometricResultEnum");
 /**
  * Lo que le pasó a una verificación biométrica, según el proveedor.
  *
- * **El recorrido:** Metamap → `kyc-metamap-webhook` (que valida la firma HMAC y traduce) →
- * `BiometricsInboundQueue` → el consumer de `biometrics-business`, que aplica la transición.
+ * **El recorrido:** Metamap → `kyc-metamap-webhook`, que valida la firma HMAC y traduce → llamada
+ * HTTP síncrona a `biometrics-business`, que aplica la transición.
  *
- * **Por qué el webhook no llama directo:** ese lambda tiene una disciplina explícita — *un fallo de
- * publish NUNCA puede tumbar el webhook*, porque si lanza, Metamap reintenta el webhook completo y
- * se duplican las actualizaciones de identidad. Con esa regla, una llamada síncrona que falle se
- * traga el evento en silencio y la verificación queda `IN_PROGRESS` para siempre, con el caller
- * poleando al vacío y sin alarma. La cola da durabilidad, DLQ y alarma sin tocar esa disciplina.
+ * 🔴 **No se loguea entero:**
+ * loguea los campos que necesites, nunca el objeto. El resto son identificadores operacionales y el
+ * veredicto.
  *
- * 🔴 **Cola propia, NO `RetailKycInboundQueue`.** SQS no hace broadcast: dos lambdas sobre la misma
- * cola son consumidores en competencia y cada mensaje le llega a UNO solo. Reusar la de SureKeep
- * partiría sus KYC a la mitad, en producción, al azar y sin un solo error en los logs.
- *
- * 🔴 **Sin PII.** Solo identificadores operacionales y el veredicto.
+ * Los duplicados son la norma —Metamap reintenta el webhook completo ante cualquier fallo—, así que
+ * el consumer deduplica por `eventId` y ordena por `occurredAt`.
  *
  * `biometrics-business` — Entrega 1.
  */

package/bin/biometrics/index.d.ts

@@ -4,6 +4,7 @@ export * from './enums/BiometricDeliveryModeEnum';
 export * from './enums/BiometricVerificationStatusEnum';
 export * from './enums/BiometricResultEnum';
 export * from './enums/BiometricEventTypeEnum';
+export * from './enums/BiometricReferenceSourceEnum';
 export * from './dtos/BiometricSubject';
 export * from './dtos/BiometricDelivery';
 export * from './dtos/requests/CreateBiometricVerificationRequest';

package/bin/biometrics/index.js

@@ -24,6 +24,7 @@ __exportStar(require("./enums/BiometricDeliveryModeEnum"), exports);
 __exportStar(require("./enums/BiometricVerificationStatusEnum"), exports);
 __exportStar(require("./enums/BiometricResultEnum"), exports);
 __exportStar(require("./enums/BiometricEventTypeEnum"), exports);
+__exportStar(require("./enums/BiometricReferenceSourceEnum"), exports);
 // DTOs compartidos
 __exportStar(require("./dtos/BiometricSubject"), exports);
 __exportStar(require("./dtos/BiometricDelivery"), exports);

package/bin/identity/dtos/PeopleIdPhotoResponse.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Respuesta del endpoint privado que devuelve el FRENTE de la identificación de un usuario:
+ * el URL presignado de S3 + su vigencia. Gemelo de `PeopleSelfieResponse`.
+ *
+ * Es la otra fuente posible del `userPhotoLink` del facematch. Se declara aparte y no se reusa
+ * `PeopleSelfieResponse` porque son dos endpoints distintos: compartir el tipo haría que un cambio
+ * en uno arrastrara al otro sin que nadie lo decida.
+ */
+export declare class PeopleIdPhotoResponse {
+    directoryId: string;
+    /** URL presignado de S3 del frente del documento. */
+    url: string;
+    /** Nombre del archivo en S3, sin el prefijo `USER/{directoryId}/`. */
+    key: string;
+    /** Vigencia del presigned URL en segundos. */
+    expiresInSeconds: number;
+}

package/bin/identity/dtos/PeopleIdPhotoResponse.js

@@ -0,0 +1,49 @@
+"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.PeopleIdPhotoResponse = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Respuesta del endpoint privado que devuelve el FRENTE de la identificación de un usuario:
+ * el URL presignado de S3 + su vigencia. Gemelo de `PeopleSelfieResponse`.
+ *
+ * Es la otra fuente posible del `userPhotoLink` del facematch. Se declara aparte y no se reusa
+ * `PeopleSelfieResponse` porque son dos endpoints distintos: compartir el tipo haría que un cambio
+ * en uno arrastrara al otro sin que nadie lo decida.
+ */
+class PeopleIdPhotoResponse {
+}
+exports.PeopleIdPhotoResponse = PeopleIdPhotoResponse;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], PeopleIdPhotoResponse.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], PeopleIdPhotoResponse.prototype, "url", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], PeopleIdPhotoResponse.prototype, "key", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.IsPositive)(),
+    __metadata("design:type", Number)
+], PeopleIdPhotoResponse.prototype, "expiresInSeconds", void 0);

package/bin/identity/index.d.ts

@@ -12,6 +12,7 @@ export * from './dtos/PeopleSelfVerifiedRequest';
 export * from './dtos/AgentDocumentKeyResponse';
 export * from './dtos/DocumentUploadResponse';
 export * from './dtos/PeopleSelfieResponse';
+export * from './dtos/PeopleIdPhotoResponse';
 export * from './enums/IdentificationDocumentStatus';
 export * from './enums/SexDocument';
 export * from './enums/InfoSelfVerifiedStatus';

package/bin/identity/index.js

@@ -29,6 +29,7 @@ __exportStar(require("./dtos/PeopleSelfVerifiedRequest"), exports);
 __exportStar(require("./dtos/AgentDocumentKeyResponse"), exports);
 __exportStar(require("./dtos/DocumentUploadResponse"), exports);
 __exportStar(require("./dtos/PeopleSelfieResponse"), exports);
+__exportStar(require("./dtos/PeopleIdPhotoResponse"), exports);
 //enums
 __exportStar(require("./enums/IdentificationDocumentStatus"), exports);
 __exportStar(require("./enums/SexDocument"), exports);

package/bin/loanCredit/constants/creditPaymentHook.d.ts

@@ -0,0 +1,2 @@
+/** Largo máximo del actor y de la referencia de pago de los dos hooks de cobranza del crédito. */
+export declare const CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH = 120;

package/bin/loanCredit/constants/creditPaymentHook.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH = void 0;
+/** Largo máximo del actor y de la referencia de pago de los dos hooks de cobranza del crédito. */
+exports.CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH = 120;

package/bin/loanCredit/dtos/requests/CreditPaymentAppliedRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Body de `POST /private/credits/:creditId/payment-applied` (loan-credit-business). Es OPCIONAL:
+ * sin él el pago se atribuye al sistema. `paymentReference` es sólo trazabilidad — no decide nada.
+ */
+export declare class CreditPaymentAppliedRequest {
+    /** Quién aplicó el pago; queda en la bitácora del expediente. */
+    actor?: string;
+    /** Referencia del pago en el sistema que lo aplicó. Sólo trazabilidad. */
+    paymentReference?: string;
+}

package/bin/loanCredit/dtos/requests/CreditPaymentAppliedRequest.js

@@ -0,0 +1,38 @@
+"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.CreditPaymentAppliedRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const creditPaymentHook_1 = require("../../constants/creditPaymentHook");
+/**
+ * Body de `POST /private/credits/:creditId/payment-applied` (loan-credit-business). Es OPCIONAL:
+ * sin él el pago se atribuye al sistema. `paymentReference` es sólo trazabilidad — no decide nada.
+ */
+class CreditPaymentAppliedRequest {
+}
+exports.CreditPaymentAppliedRequest = CreditPaymentAppliedRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(creditPaymentHook_1.CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH),
+    __metadata("design:type", String)
+], CreditPaymentAppliedRequest.prototype, "actor", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(creditPaymentHook_1.CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH),
+    __metadata("design:type", String)
+], CreditPaymentAppliedRequest.prototype, "paymentReference", void 0);

package/bin/loanCredit/dtos/requests/CreditSettledRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Body de `POST /private/credits/:creditId/settled` (loan-credit-business). También opcional.
+ * La ruta VERIFICA que el crédito no deba nada: no le cree al caller.
+ */
+export declare class CreditSettledRequest {
+    /** Quién declaró la liquidación; queda en la bitácora del expediente. */
+    actor?: string;
+    /** Referencia del pago que liquidó. Sólo trazabilidad. */
+    paymentReference?: string;
+}

package/bin/loanCredit/dtos/requests/CreditSettledRequest.js

@@ -0,0 +1,38 @@
+"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.CreditSettledRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const creditPaymentHook_1 = require("../../constants/creditPaymentHook");
+/**
+ * Body de `POST /private/credits/:creditId/settled` (loan-credit-business). También opcional.
+ * La ruta VERIFICA que el crédito no deba nada: no le cree al caller.
+ */
+class CreditSettledRequest {
+}
+exports.CreditSettledRequest = CreditSettledRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(creditPaymentHook_1.CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH),
+    __metadata("design:type", String)
+], CreditSettledRequest.prototype, "actor", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(creditPaymentHook_1.CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH),
+    __metadata("design:type", String)
+], CreditSettledRequest.prototype, "paymentReference", void 0);

package/bin/loanCredit/dtos/responses/CreditPaymentAppliedResponse.d.ts

@@ -0,0 +1,8 @@
+import { CreditPaymentUnlockDecisionEnum } from '../../enums/CreditPaymentUnlockDecisionEnum';
+/** Resultado de aplicar un pago: el crédito sale de mora y el equipo se suelta si corresponde. */
+export interface CreditPaymentAppliedResponse {
+    creditId: string;
+    /** El crédito salió de mora. Pasa aunque no haya equipo, esté sin candado, o sea SCHEDULED. */
+    creditReactivated: boolean;
+    unlockDecision: CreditPaymentUnlockDecisionEnum;
+}

package/bin/loanCredit/dtos/responses/CreditPaymentAppliedResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/loanCredit/dtos/responses/CreditSettledResponse.d.ts

@@ -0,0 +1,8 @@
+import { CreditSettlementDecisionEnum } from '../../enums/CreditSettlementDecisionEnum';
+import { CreditSettlementReleaseDecisionEnum } from '../../enums/CreditSettlementReleaseDecisionEnum';
+/** Resultado de liquidar el crédito; `releaseDecision` es null si el equipo no salió al proveedor. */
+export interface CreditSettledResponse {
+    creditId: string;
+    settlementDecision: CreditSettlementDecisionEnum;
+    releaseDecision: CreditSettlementReleaseDecisionEnum | null;
+}

package/bin/loanCredit/dtos/responses/CreditSettledResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/loanCredit/enums/CreditPaymentUnlockDecisionEnum.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Qué pasó con el equipo cuando se aplicó un pago al crédito.
+ * @enum {string}
+ */
+export declare enum CreditPaymentUnlockDecisionEnum {
+    CREDIT_NOT_FOUND = "CREDIT_NOT_FOUND",
+    /** El crédito no está en un estado al que el pago le suelte el equipo. */
+    CREDIT_NOT_UNLOCKABLE = "CREDIT_NOT_UNLOCKABLE",
+    NOT_ENROLLED = "NOT_ENROLLED",
+    /** El equipo no estaba bloqueado: no hay nada que soltar. */
+    NOT_LOCKED = "NOT_LOCKED",
+    /** El candado no es el de la mora (fraude, manual, o sin motivo): un pago no lo suelta. */
+    LOCKED_FOR_OTHER_REASON = "LOCKED_FOR_OTHER_REASON",
+    /** El pago no alcanzó el umbral escalonado: sigue bloqueado y no se reprograma nada. */
+    THRESHOLD_NOT_MET = "THRESHOLD_NOT_MET",
+    UNLOCKED = "UNLOCKED",
+    /** El proveedor aceptó la orden y todavía no la dio por hecha. */
+    UNLOCK_PENDING = "UNLOCK_PENDING",
+    UNLOCK_FAILED = "UNLOCK_FAILED"
+}

package/bin/loanCredit/enums/CreditPaymentUnlockDecisionEnum.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditPaymentUnlockDecisionEnum = void 0;
+/**
+ * Qué pasó con el equipo cuando se aplicó un pago al crédito.
+ * @enum {string}
+ */
+var CreditPaymentUnlockDecisionEnum;
+(function (CreditPaymentUnlockDecisionEnum) {
+    CreditPaymentUnlockDecisionEnum["CREDIT_NOT_FOUND"] = "CREDIT_NOT_FOUND";
+    /** El crédito no está en un estado al que el pago le suelte el equipo. */
+    CreditPaymentUnlockDecisionEnum["CREDIT_NOT_UNLOCKABLE"] = "CREDIT_NOT_UNLOCKABLE";
+    CreditPaymentUnlockDecisionEnum["NOT_ENROLLED"] = "NOT_ENROLLED";
+    /** El equipo no estaba bloqueado: no hay nada que soltar. */
+    CreditPaymentUnlockDecisionEnum["NOT_LOCKED"] = "NOT_LOCKED";
+    /** El candado no es el de la mora (fraude, manual, o sin motivo): un pago no lo suelta. */
+    CreditPaymentUnlockDecisionEnum["LOCKED_FOR_OTHER_REASON"] = "LOCKED_FOR_OTHER_REASON";
+    /** El pago no alcanzó el umbral escalonado: sigue bloqueado y no se reprograma nada. */
+    CreditPaymentUnlockDecisionEnum["THRESHOLD_NOT_MET"] = "THRESHOLD_NOT_MET";
+    CreditPaymentUnlockDecisionEnum["UNLOCKED"] = "UNLOCKED";
+    /** El proveedor aceptó la orden y todavía no la dio por hecha. */
+    CreditPaymentUnlockDecisionEnum["UNLOCK_PENDING"] = "UNLOCK_PENDING";
+    CreditPaymentUnlockDecisionEnum["UNLOCK_FAILED"] = "UNLOCK_FAILED";
+})(CreditPaymentUnlockDecisionEnum || (exports.CreditPaymentUnlockDecisionEnum = CreditPaymentUnlockDecisionEnum = {}));

package/bin/loanCredit/enums/CreditSettlementDecisionEnum.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Qué pasó al intentar dejar el crédito liquidado. La ruta VERIFICA el saldo, no cree al caller.
+ * @enum {string}
+ */
+export declare enum CreditSettlementDecisionEnum {
+    CREDIT_NOT_FOUND = "CREDIT_NOT_FOUND",
+    /** Ya estaba liquidado: la ruta es idempotente y la liberación corre igual. */
+    ALREADY_SETTLED = "ALREADY_SETTLED",
+    /** El estado del crédito no admite liquidación (sólo ACTIVE e IN_ARREARS la admiten). */
+    CREDIT_NOT_SETTLEABLE = "CREDIT_NOT_SETTLEABLE",
+    /** Sin plan de cuotas no hay evidencia de que deba cero; fail-closed. */
+    NO_INSTALLMENTS = "NO_INSTALLMENTS",
+    /** Al plan le falta alguna cuota del plazo: la deuda que no se persistió no se puede saldar. */
+    INCOMPLETE_PLAN = "INCOMPLETE_PLAN",
+    /** Alguna cuota sigue debiendo: liquidar acá liberaría un equipo con deuda viva. */
+    BALANCE_OUTSTANDING = "BALANCE_OUTSTANDING",
+    SETTLED = "SETTLED",
+    /** Otro movió el estado entre la lectura y la escritura; el caller relee y reintenta. */
+    SETTLE_CONFLICT = "SETTLE_CONFLICT",
+    SETTLE_FAILED = "SETTLE_FAILED"
+}

package/bin/loanCredit/enums/CreditSettlementDecisionEnum.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditSettlementDecisionEnum = void 0;
+/**
+ * Qué pasó al intentar dejar el crédito liquidado. La ruta VERIFICA el saldo, no cree al caller.
+ * @enum {string}
+ */
+var CreditSettlementDecisionEnum;
+(function (CreditSettlementDecisionEnum) {
+    CreditSettlementDecisionEnum["CREDIT_NOT_FOUND"] = "CREDIT_NOT_FOUND";
+    /** Ya estaba liquidado: la ruta es idempotente y la liberación corre igual. */
+    CreditSettlementDecisionEnum["ALREADY_SETTLED"] = "ALREADY_SETTLED";
+    /** El estado del crédito no admite liquidación (sólo ACTIVE e IN_ARREARS la admiten). */
+    CreditSettlementDecisionEnum["CREDIT_NOT_SETTLEABLE"] = "CREDIT_NOT_SETTLEABLE";
+    /** Sin plan de cuotas no hay evidencia de que deba cero; fail-closed. */
+    CreditSettlementDecisionEnum["NO_INSTALLMENTS"] = "NO_INSTALLMENTS";
+    /** Al plan le falta alguna cuota del plazo: la deuda que no se persistió no se puede saldar. */
+    CreditSettlementDecisionEnum["INCOMPLETE_PLAN"] = "INCOMPLETE_PLAN";
+    /** Alguna cuota sigue debiendo: liquidar acá liberaría un equipo con deuda viva. */
+    CreditSettlementDecisionEnum["BALANCE_OUTSTANDING"] = "BALANCE_OUTSTANDING";
+    CreditSettlementDecisionEnum["SETTLED"] = "SETTLED";
+    /** Otro movió el estado entre la lectura y la escritura; el caller relee y reintenta. */
+    CreditSettlementDecisionEnum["SETTLE_CONFLICT"] = "SETTLE_CONFLICT";
+    CreditSettlementDecisionEnum["SETTLE_FAILED"] = "SETTLE_FAILED";
+})(CreditSettlementDecisionEnum || (exports.CreditSettlementDecisionEnum = CreditSettlementDecisionEnum = {}));

package/bin/loanCredit/enums/CreditSettlementReleaseDecisionEnum.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Qué pasó con el equipo al liquidarse el crédito. El verbo es Release, terminal: el equipo SALE
+ * del enrolamiento, no se queda desbloqueado.
+ * @enum {string}
+ */
+export declare enum CreditSettlementReleaseDecisionEnum {
+    CREDIT_NOT_FOUND = "CREDIT_NOT_FOUND",
+    /** El crédito no está liquidado: liberar el equipo sería irreversible y prematuro. */
+    CREDIT_NOT_SETTLED = "CREDIT_NOT_SETTLED",
+    NOT_ENROLLED = "NOT_ENROLLED",
+    /** El expediente ya salió del MDM; la liberación es idempotente y no vuelve a salir. */
+    ALREADY_RELEASED = "ALREADY_RELEASED",
+    RELEASED = "RELEASED",
+    /** El proveedor aceptó la liberación y todavía no la dio por hecha. */
+    RELEASE_PENDING = "RELEASE_PENDING",
+    RELEASE_FAILED = "RELEASE_FAILED"
+}

package/bin/loanCredit/enums/CreditSettlementReleaseDecisionEnum.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditSettlementReleaseDecisionEnum = void 0;
+/**
+ * Qué pasó con el equipo al liquidarse el crédito. El verbo es Release, terminal: el equipo SALE
+ * del enrolamiento, no se queda desbloqueado.
+ * @enum {string}
+ */
+var CreditSettlementReleaseDecisionEnum;
+(function (CreditSettlementReleaseDecisionEnum) {
+    CreditSettlementReleaseDecisionEnum["CREDIT_NOT_FOUND"] = "CREDIT_NOT_FOUND";
+    /** El crédito no está liquidado: liberar el equipo sería irreversible y prematuro. */
+    CreditSettlementReleaseDecisionEnum["CREDIT_NOT_SETTLED"] = "CREDIT_NOT_SETTLED";
+    CreditSettlementReleaseDecisionEnum["NOT_ENROLLED"] = "NOT_ENROLLED";
+    /** El expediente ya salió del MDM; la liberación es idempotente y no vuelve a salir. */
+    CreditSettlementReleaseDecisionEnum["ALREADY_RELEASED"] = "ALREADY_RELEASED";
+    CreditSettlementReleaseDecisionEnum["RELEASED"] = "RELEASED";
+    /** El proveedor aceptó la liberación y todavía no la dio por hecha. */
+    CreditSettlementReleaseDecisionEnum["RELEASE_PENDING"] = "RELEASE_PENDING";
+    CreditSettlementReleaseDecisionEnum["RELEASE_FAILED"] = "RELEASE_FAILED";
+})(CreditSettlementReleaseDecisionEnum || (exports.CreditSettlementReleaseDecisionEnum = CreditSettlementReleaseDecisionEnum = {}));

package/bin/loanCredit/index.d.ts

@@ -17,6 +17,14 @@ export * from './dtos/requests/OriginateLoanCreditRequest';
 export * from './dtos/requests/QuoteLoanCreditRequest';
 export * from './dtos/requests/SignLoanCreditRequest';
 export * from './dtos/requests/ActivationCheckRequest';
+export * from './dtos/requests/CreditPaymentAppliedRequest';
+export * from './dtos/requests/CreditSettledRequest';
+export * from './dtos/responses/CreditPaymentAppliedResponse';
+export * from './dtos/responses/CreditSettledResponse';
+export * from './enums/CreditPaymentUnlockDecisionEnum';
+export * from './enums/CreditSettlementDecisionEnum';
+export * from './enums/CreditSettlementReleaseDecisionEnum';
+export * from './constants/creditPaymentHook';
 export * from './dtos/requests/ChangeLoanCreditStatusRequest';
 export * from './dtos/responses/LoanBorrowerResponse';
 export * from './dtos/responses/LoanCreditResponse';

package/bin/loanCredit/index.js

@@ -39,6 +39,14 @@ __exportStar(require("./dtos/requests/OriginateLoanCreditRequest"), exports);
 __exportStar(require("./dtos/requests/QuoteLoanCreditRequest"), exports);
 __exportStar(require("./dtos/requests/SignLoanCreditRequest"), exports);
 __exportStar(require("./dtos/requests/ActivationCheckRequest"), exports);
+__exportStar(require("./dtos/requests/CreditPaymentAppliedRequest"), exports);
+__exportStar(require("./dtos/requests/CreditSettledRequest"), exports);
+__exportStar(require("./dtos/responses/CreditPaymentAppliedResponse"), exports);
+__exportStar(require("./dtos/responses/CreditSettledResponse"), exports);
+__exportStar(require("./enums/CreditPaymentUnlockDecisionEnum"), exports);
+__exportStar(require("./enums/CreditSettlementDecisionEnum"), exports);
+__exportStar(require("./enums/CreditSettlementReleaseDecisionEnum"), exports);
+__exportStar(require("./constants/creditPaymentHook"), exports);
 __exportStar(require("./dtos/requests/ChangeLoanCreditStatusRequest"), exports);
 // Response DTOs
 __exportStar(require("./dtos/responses/LoanBorrowerResponse"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.406.0",
+  "version": "3.408.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/biometrics/dtos/requests/CreateBiometricVerificationRequest.ts

@@ -1,6 +1,7 @@
 import { Expose, Type } from 'class-transformer';
 import {
     IsEnum,
+    IsIn,
     IsInt,
     IsNotEmpty,
     IsOptional,
@@ -12,6 +13,7 @@ import {
 } from 'class-validator';
 import { BiometricDeliveryModeEnum } from '../../enums/BiometricDeliveryModeEnum';
 import { BiometricProviderEnum } from '../../enums/BiometricProviderEnum';
+import { BiometricReferenceSourceEnum } from '../../enums/BiometricReferenceSourceEnum';
 import { BiometricTypeEnum } from '../../enums/BiometricTypeEnum';
 import { BiometricSubject } from '../BiometricSubject';
 
@@ -81,6 +83,24 @@ export class CreateBiometricVerificationRequest {
     @Expose() @IsOptional() @IsString() @IsNotEmpty()
     referenceImageUrl?: string;
 
+    /**
+     * Contra QUÉ foto se compara. Default `KYC_SELFIE`, que aplica el servicio: acá viaja ausente
+     * cuando no lo mandas, para que se pueda distinguir de haberlo pedido explícitamente.
+     *
+     * **Sin fallback:** si la fuente pedida no tiene foto, responde `REFERENCE_PHOTO_UNAVAILABLE`;
+     * no se busca la otra. Quien pide contra el documento y recibe un match sabe que fue contra el
+     * documento.
+     *
+     * 🔴 `CALLER_PROVIDED` NO es válido acá — solo lo emite la respuesta. Y mandar esto junto con
+     * `referenceImageUrl` responde `422 CONFLICTING_REFERENCE_IMAGE`: son contradictorios.
+     */
+    @Expose()
+    @IsOptional()
+    @IsIn([BiometricReferenceSourceEnum.KYC_SELFIE, BiometricReferenceSourceEnum.ID_DOCUMENT])
+    referenceImageSource?:
+        | BiometricReferenceSourceEnum.KYC_SELFIE
+        | BiometricReferenceSourceEnum.ID_DOCUMENT;
+
     /**
      * Vigencia de la entrega, en segundos. Default 3600.
      *

package/src/biometrics/dtos/responses/BiometricVerificationResponse.ts

@@ -12,6 +12,7 @@ import {
 } from 'class-validator';
 import { BiometricDeliveryModeEnum } from '../../enums/BiometricDeliveryModeEnum';
 import { BiometricProviderEnum } from '../../enums/BiometricProviderEnum';
+import { BiometricReferenceSourceEnum } from '../../enums/BiometricReferenceSourceEnum';
 import { BiometricResultEnum } from '../../enums/BiometricResultEnum';
 import { BiometricTypeEnum } from '../../enums/BiometricTypeEnum';
 import { BiometricVerificationStatusEnum } from '../../enums/BiometricVerificationStatusEnum';
@@ -77,6 +78,16 @@ export class BiometricVerificationResponse {
     @Expose()
     delivery!: BiometricDelivery;
 
+    /**
+     * Contra qué foto se comparó. **Siempre poblado.**
+     *
+     * `CALLER_PROVIDED` significa que la foto la mandaste tú en `referenceImageUrl`. Es un valor
+     * distinto y no el default, porque decir `KYC_SELFIE` cuando la foto la pusiste tú sería mentir
+     * sobre contra qué se comparó — y eso es exactamente lo que este campo existe para evitar.
+     */
+    @Expose() @IsEnum(BiometricReferenceSourceEnum)
+    referenceImageSource!: BiometricReferenceSourceEnum;
+
     /**
      * Similitud reportada por el proveedor, 0–100, cuando la expone. Rekognition da score; Metamap
      * responde pass/fail y esto viene ausente.

package/src/biometrics/enums/BiometricReferenceSourceEnum.ts

@@ -0,0 +1,16 @@
+/**
+ * Contra QUÉ foto compara el biométrico.
+ *
+ * `CALLER_PROVIDED` es SOLO DE SALIDA: lo emite la respuesta cuando el caller mandó su propia
+ * `referenceImageUrl`. El request lo rechaza — pedirlo no significa nada.
+ */
+export enum BiometricReferenceSourceEnum {
+    /** La selfie del KYC. El default. */
+    KYC_SELFIE = 'KYC_SELFIE',
+
+    /** El frente de la identificación, resuelto por `fiado-identity-lambda`. */
+    ID_DOCUMENT = 'ID_DOCUMENT',
+
+    /** Solo de salida: la foto la puso el caller en `referenceImageUrl`. */
+    CALLER_PROVIDED = 'CALLER_PROVIDED',
+}

package/src/biometrics/events/BiometricVerificationChangedV1.ts

@@ -18,20 +18,15 @@ import { BiometricResultEnum } from '../enums/BiometricResultEnum';
 /**
  * Lo que le pasó a una verificación biométrica, según el proveedor.
  *
- * **El recorrido:** Metamap → `kyc-metamap-webhook` (que valida la firma HMAC y traduce) →
- * `BiometricsInboundQueue` → el consumer de `biometrics-business`, que aplica la transición.
+ * **El recorrido:** Metamap → `kyc-metamap-webhook`, que valida la firma HMAC y traduce → llamada
+ * HTTP síncrona a `biometrics-business`, que aplica la transición.
  *
- * **Por qué el webhook no llama directo:** ese lambda tiene una disciplina explícita — *un fallo de
- * publish NUNCA puede tumbar el webhook*, porque si lanza, Metamap reintenta el webhook completo y
- * se duplican las actualizaciones de identidad. Con esa regla, una llamada síncrona que falle se
- * traga el evento en silencio y la verificación queda `IN_PROGRESS` para siempre, con el caller
- * poleando al vacío y sin alarma. La cola da durabilidad, DLQ y alarma sin tocar esa disciplina.
+ * 🔴 **No se loguea entero:**
+ * loguea los campos que necesites, nunca el objeto. El resto son identificadores operacionales y el
+ * veredicto.
  *
- * 🔴 **Cola propia, NO `RetailKycInboundQueue`.** SQS no hace broadcast: dos lambdas sobre la misma
- * cola son consumidores en competencia y cada mensaje le llega a UNO solo. Reusar la de SureKeep
- * partiría sus KYC a la mitad, en producción, al azar y sin un solo error en los logs.
- *
- * 🔴 **Sin PII.** Solo identificadores operacionales y el veredicto.
+ * Los duplicados son la norma —Metamap reintenta el webhook completo ante cualquier fallo—, así que
+ * el consumer deduplica por `eventId` y ordena por `occurredAt`.
  *
  * `biometrics-business` — Entrega 1.
  */
@@ -46,15 +41,12 @@ export class BiometricVerificationChangedV1 {
     /**
      * 🔴 **Identificador ÚNICO de este evento. La clave de deduplicación.**
      *
-     * SQS es *at-least-once*: los duplicados son la norma, no la excepción. Y **el candado temporal
-     * por `occurredAt` NO alcanza para esto**: dos entregas del mismo evento traen exactamente el
-     * mismo `occurredAt`, así que una regla "descartar si es más viejo" las deja pasar a las dos.
+     * La entrega es *at-least-once*: Metamap reintenta el webhook completo, así que los duplicados
+     * son la norma, no la excepción. Y **el candado temporal por `occurredAt` NO alcanza para
+     * esto**: dos entregas del mismo evento traen exactamente el mismo `occurredAt`, así que una
+     * regla "descartar si es más viejo" las deja pasar a las dos.
      *
      * El consumer guarda los `eventId` ya aplicados y descarta los repetidos.
-     *
-     * ⚠️ **No deduplicar por el `MessageId` de SQS**: cambia en cada reintento de entrega, así que
-     * no deduplica nada. Es el error clásico y por eso queda escrito acá y no en la cabeza de cada
-     * consumidor.
      */
     @Expose() @IsString() @IsNotEmpty()
     eventId!: string;
@@ -103,7 +95,7 @@ export class BiometricVerificationChangedV1 {
      * el evento real, y la transición no se aplicaría nunca — sin un solo error.
      *
      * Normalizar a UTC es trabajo del traductor del proveedor (`kyc-metamap-webhook`). Este candado
-     * existe para que si algún día deja de hacerlo, el mensaje caiga al DLQ en el boundary en vez de
+     * existe para que si algún día deja de hacerlo, el evento se rechace en el boundary en vez de
      * corromper el orden en silencio.
      */
     @Expose() @IsString() @IsISO8601({ strict: true })

package/src/biometrics/index.ts

@@ -9,6 +9,7 @@ export * from './enums/BiometricDeliveryModeEnum';
 export * from './enums/BiometricVerificationStatusEnum';
 export * from './enums/BiometricResultEnum';
 export * from './enums/BiometricEventTypeEnum';
+export * from './enums/BiometricReferenceSourceEnum';
 
 // DTOs compartidos
 export * from './dtos/BiometricSubject';

package/src/identity/dtos/PeopleIdPhotoResponse.ts

@@ -0,0 +1,27 @@
+import { Expose } from 'class-transformer';
+import { IsInt, IsNotEmpty, IsPositive, IsString } from 'class-validator';
+
+/**
+ * Respuesta del endpoint privado que devuelve el FRENTE de la identificación de un usuario:
+ * el URL presignado de S3 + su vigencia. Gemelo de `PeopleSelfieResponse`.
+ *
+ * Es la otra fuente posible del `userPhotoLink` del facematch. Se declara aparte y no se reusa
+ * `PeopleSelfieResponse` porque son dos endpoints distintos: compartir el tipo haría que un cambio
+ * en uno arrastrara al otro sin que nadie lo decida.
+ */
+export class PeopleIdPhotoResponse {
+    @Expose() @IsString() @IsNotEmpty()
+    directoryId!: string;
+
+    /** URL presignado de S3 del frente del documento. */
+    @Expose() @IsString() @IsNotEmpty()
+    url!: string;
+
+    /** Nombre del archivo en S3, sin el prefijo `USER/{directoryId}/`. */
+    @Expose() @IsString() @IsNotEmpty()
+    key!: string;
+
+    /** Vigencia del presigned URL en segundos. */
+    @Expose() @IsInt() @IsPositive()
+    expiresInSeconds!: number;
+}

package/src/identity/index.ts

@@ -14,6 +14,7 @@ export * from './dtos/PeopleSelfVerifiedRequest';
 export * from './dtos/AgentDocumentKeyResponse';
 export * from './dtos/DocumentUploadResponse';
 export * from './dtos/PeopleSelfieResponse';
+export * from './dtos/PeopleIdPhotoResponse';
 
 
 //enums

package/src/loanCredit/constants/creditPaymentHook.ts

@@ -0,0 +1,2 @@
+/** Largo máximo del actor y de la referencia de pago de los dos hooks de cobranza del crédito. */
+export const CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH = 120;

package/src/loanCredit/dtos/requests/CreditPaymentAppliedRequest.ts

@@ -0,0 +1,25 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsOptional, IsString, MaxLength } from 'class-validator';
+import { CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH } from '../../constants/creditPaymentHook';
+
+/**
+ * Body de `POST /private/credits/:creditId/payment-applied` (loan-credit-business). Es OPCIONAL:
+ * sin él el pago se atribuye al sistema. `paymentReference` es sólo trazabilidad — no decide nada.
+ */
+export class CreditPaymentAppliedRequest {
+    /** Quién aplicó el pago; queda en la bitácora del expediente. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH)
+    actor?: string;
+
+    /** Referencia del pago en el sistema que lo aplicó. Sólo trazabilidad. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH)
+    paymentReference?: string;
+}

package/src/loanCredit/dtos/requests/CreditSettledRequest.ts

@@ -0,0 +1,25 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsOptional, IsString, MaxLength } from 'class-validator';
+import { CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH } from '../../constants/creditPaymentHook';
+
+/**
+ * Body de `POST /private/credits/:creditId/settled` (loan-credit-business). También opcional.
+ * La ruta VERIFICA que el crédito no deba nada: no le cree al caller.
+ */
+export class CreditSettledRequest {
+    /** Quién declaró la liquidación; queda en la bitácora del expediente. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH)
+    actor?: string;
+
+    /** Referencia del pago que liquidó. Sólo trazabilidad. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH)
+    paymentReference?: string;
+}

package/src/loanCredit/dtos/responses/CreditPaymentAppliedResponse.ts

@@ -0,0 +1,9 @@
+import { CreditPaymentUnlockDecisionEnum } from '../../enums/CreditPaymentUnlockDecisionEnum';
+
+/** Resultado de aplicar un pago: el crédito sale de mora y el equipo se suelta si corresponde. */
+export interface CreditPaymentAppliedResponse {
+    creditId: string;
+    /** El crédito salió de mora. Pasa aunque no haya equipo, esté sin candado, o sea SCHEDULED. */
+    creditReactivated: boolean;
+    unlockDecision: CreditPaymentUnlockDecisionEnum;
+}

package/src/loanCredit/dtos/responses/CreditSettledResponse.ts

@@ -0,0 +1,9 @@
+import { CreditSettlementDecisionEnum } from '../../enums/CreditSettlementDecisionEnum';
+import { CreditSettlementReleaseDecisionEnum } from '../../enums/CreditSettlementReleaseDecisionEnum';
+
+/** Resultado de liquidar el crédito; `releaseDecision` es null si el equipo no salió al proveedor. */
+export interface CreditSettledResponse {
+    creditId: string;
+    settlementDecision: CreditSettlementDecisionEnum;
+    releaseDecision: CreditSettlementReleaseDecisionEnum | null;
+}

package/src/loanCredit/enums/CreditPaymentUnlockDecisionEnum.ts

@@ -0,0 +1,20 @@
+/**
+ * Qué pasó con el equipo cuando se aplicó un pago al crédito.
+ * @enum {string}
+ */
+export enum CreditPaymentUnlockDecisionEnum {
+    CREDIT_NOT_FOUND = 'CREDIT_NOT_FOUND',
+    /** El crédito no está en un estado al que el pago le suelte el equipo. */
+    CREDIT_NOT_UNLOCKABLE = 'CREDIT_NOT_UNLOCKABLE',
+    NOT_ENROLLED = 'NOT_ENROLLED',
+    /** El equipo no estaba bloqueado: no hay nada que soltar. */
+    NOT_LOCKED = 'NOT_LOCKED',
+    /** El candado no es el de la mora (fraude, manual, o sin motivo): un pago no lo suelta. */
+    LOCKED_FOR_OTHER_REASON = 'LOCKED_FOR_OTHER_REASON',
+    /** El pago no alcanzó el umbral escalonado: sigue bloqueado y no se reprograma nada. */
+    THRESHOLD_NOT_MET = 'THRESHOLD_NOT_MET',
+    UNLOCKED = 'UNLOCKED',
+    /** El proveedor aceptó la orden y todavía no la dio por hecha. */
+    UNLOCK_PENDING = 'UNLOCK_PENDING',
+    UNLOCK_FAILED = 'UNLOCK_FAILED',
+}

package/src/loanCredit/enums/CreditSettlementDecisionEnum.ts

@@ -0,0 +1,21 @@
+/**
+ * Qué pasó al intentar dejar el crédito liquidado. La ruta VERIFICA el saldo, no cree al caller.
+ * @enum {string}
+ */
+export enum CreditSettlementDecisionEnum {
+    CREDIT_NOT_FOUND = 'CREDIT_NOT_FOUND',
+    /** Ya estaba liquidado: la ruta es idempotente y la liberación corre igual. */
+    ALREADY_SETTLED = 'ALREADY_SETTLED',
+    /** El estado del crédito no admite liquidación (sólo ACTIVE e IN_ARREARS la admiten). */
+    CREDIT_NOT_SETTLEABLE = 'CREDIT_NOT_SETTLEABLE',
+    /** Sin plan de cuotas no hay evidencia de que deba cero; fail-closed. */
+    NO_INSTALLMENTS = 'NO_INSTALLMENTS',
+    /** Al plan le falta alguna cuota del plazo: la deuda que no se persistió no se puede saldar. */
+    INCOMPLETE_PLAN = 'INCOMPLETE_PLAN',
+    /** Alguna cuota sigue debiendo: liquidar acá liberaría un equipo con deuda viva. */
+    BALANCE_OUTSTANDING = 'BALANCE_OUTSTANDING',
+    SETTLED = 'SETTLED',
+    /** Otro movió el estado entre la lectura y la escritura; el caller relee y reintenta. */
+    SETTLE_CONFLICT = 'SETTLE_CONFLICT',
+    SETTLE_FAILED = 'SETTLE_FAILED',
+}

package/src/loanCredit/enums/CreditSettlementReleaseDecisionEnum.ts

@@ -0,0 +1,17 @@
+/**
+ * Qué pasó con el equipo al liquidarse el crédito. El verbo es Release, terminal: el equipo SALE
+ * del enrolamiento, no se queda desbloqueado.
+ * @enum {string}
+ */
+export enum CreditSettlementReleaseDecisionEnum {
+    CREDIT_NOT_FOUND = 'CREDIT_NOT_FOUND',
+    /** El crédito no está liquidado: liberar el equipo sería irreversible y prematuro. */
+    CREDIT_NOT_SETTLED = 'CREDIT_NOT_SETTLED',
+    NOT_ENROLLED = 'NOT_ENROLLED',
+    /** El expediente ya salió del MDM; la liberación es idempotente y no vuelve a salir. */
+    ALREADY_RELEASED = 'ALREADY_RELEASED',
+    RELEASED = 'RELEASED',
+    /** El proveedor aceptó la liberación y todavía no la dio por hecha. */
+    RELEASE_PENDING = 'RELEASE_PENDING',
+    RELEASE_FAILED = 'RELEASE_FAILED',
+}

package/src/loanCredit/index.ts

@@ -23,6 +23,14 @@ export * from './dtos/requests/OriginateLoanCreditRequest';
 export * from './dtos/requests/QuoteLoanCreditRequest';
 export * from './dtos/requests/SignLoanCreditRequest';
 export * from './dtos/requests/ActivationCheckRequest';
+export * from './dtos/requests/CreditPaymentAppliedRequest';
+export * from './dtos/requests/CreditSettledRequest';
+export * from './dtos/responses/CreditPaymentAppliedResponse';
+export * from './dtos/responses/CreditSettledResponse';
+export * from './enums/CreditPaymentUnlockDecisionEnum';
+export * from './enums/CreditSettlementDecisionEnum';
+export * from './enums/CreditSettlementReleaseDecisionEnum';
+export * from './constants/creditPaymentHook';
 export * from './dtos/requests/ChangeLoanCreditStatusRequest';
 
 // Response DTOs