@fiado/type-kit 3.314.0 → 3.316.0

package/src/identity/dtos/InfoSelfVerifiedFields.ts

@@ -0,0 +1,25 @@
+/**
+ * Confirmación de datos POR CAMPO, no por lado.
+ *
+ * La app dejó de mandar un "confirmo / no confirmo" a secas: ahora manda qué campo está bien y cuál
+ * mal. `false` significa INCORRECTO — el usuario pide que se corrija ese dato.
+ *
+ * Sólo llegan las claves de los campos que el usuario efectivamente pudo responder: si el expediente
+ * no tiene nombre US, la app no manda `verifyNameUS`. Ausente ≠ incorrecto.
+ *
+ * Acompaña a `MEX_InfoSelfVerified` / `USA_InfoSelfVerified` sin reemplazarlos: esos dos siguen
+ * siendo el enum de siempre y dicen SI el lado quedó confirmado; éste dice QUÉ campo falló, que es
+ * lo que permite reabrir el paso correcto y saber qué documento pedir.
+ *
+ * Se guarda aparte y no concatenado dentro del propio `*_InfoSelfVerified` porque las ~30
+ * comparaciones que hay contra ese campo en los distintos repos son todas por igualdad exacta:
+ * un valor compuesto no matchearía con ninguna y caería en el `else` de todas, sin error.
+ */
+export interface InfoSelfVerifiedFields {
+    /** Nombre estadounidense (`usNames` + `usLastNames`). Es el que abre el lado azul. */
+    verifyNameUS?: boolean;
+    /** Nombre latino (`latNames` + apellidos). Es el que abre el lado rosa. */
+    verifyNameLAT?: boolean;
+    /** Domicilio de Estados Unidos. */
+    verifyAddressUS?: boolean;
+}

package/src/identity/dtos/PeopleResponse.ts

@@ -6,6 +6,7 @@ import { CPStatusEnum } from '../enums/CPStatusEnum';
 import { InfoSelfVerifiedStatus } from '../enums/InfoSelfVerifiedStatus';
 import { SexDocument } from '../enums/SexDocument';
 import { IdentificationDocument } from './IdentificationDocument';
+import { InfoSelfVerifiedFields } from './InfoSelfVerifiedFields';
 import { ManualApproval } from './ManualApproval';
 import { PeopleName } from './PeopleName';
 
@@ -99,6 +100,12 @@ export class PeopleResponse {
         MEX_Signed:boolean | null;
         USA_Beneficiaries:boolean | null;
         USA_InfoSelfVerified:InfoSelfVerifiedStatus;
+        /**
+         * Qué campo marcó el usuario como incorrecto. Detalla a los dos `*_InfoSelfVerified`.
+         * Opcional a diferencia del resto: los expedientes anteriores a la confirmación por campo
+         * no lo tienen.
+         */
+        infoSelfVerifiedFields?:InfoSelfVerifiedFields;
         USA_Signed:boolean | null;
         older18:boolean | null;
         signature:boolean;

package/src/identity/dtos/PeopleUpdateRequest.ts

@@ -4,6 +4,7 @@ import { CPStatusEnum } from "../enums/CPStatusEnum";
 import { InfoSelfVerifiedStatus } from "../enums/InfoSelfVerifiedStatus";
 import { SexDocument } from "../enums/SexDocument";
 import { IdentificationDocument } from "./IdentificationDocument";
+import { InfoSelfVerifiedFields } from "./InfoSelfVerifiedFields";
 import { ManualApproval } from "./ManualApproval";
 import { PeopleName } from "./PeopleName";
 
@@ -90,6 +91,12 @@ export class PeopleUpdateRequest {
     pepLevel?: string | null;
     USA_InfoSelfVerified?: InfoSelfVerifiedStatus;
     MEX_InfoSelfVerified?: InfoSelfVerifiedStatus;
+    /**
+     * Qué campo marcó el usuario como incorrecto al revisar sus datos. Lo manda la app en el PUT y
+     * de acá se derivan los dos `*_InfoSelfVerified` de arriba: un lado se confirma cuando todas
+     * sus banderas están en `true`, y pide corrección si alguna está en `false`.
+     */
+    infoSelfVerifiedFields?: InfoSelfVerifiedFields;
     infoSelfVerified?: InfoSelfVerifiedStatus;
     beneficialOwner?: string | null;
     weeklyIncomeUSD?: string | null;

package/src/identity/index.ts

@@ -3,6 +3,7 @@
 export * from './dtos/IdentificationDocument'
 export * from './dtos/ManualApproval';
 export * from './dtos/PeopleCreateRequest';
+export * from './dtos/InfoSelfVerifiedFields';
 export * from './dtos/PeopleResponse';
 export * from './dtos/PeopleName';
 export * from './dtos/TypeOfDocument';

package/src/onboarding/dtos/ExpedienteUpdatedMessage.ts

@@ -0,0 +1,37 @@
+import { Equals, IsEnum, IsISO8601, IsUUID, Matches } from "class-validator";
+import { ExpedienteUpdatedSourceEnum } from "../enums/ExpedienteUpdatedSourceEnum";
+
+/**
+ * Evento EXPEDIENTE_UPDATED (cola OnboardingReadinessQueue).
+ * Producer: fiado-identity-lambda (tras cada escritura exitosa de People/ARC).
+ * Consumer: onboarding-business (ExpedienteUpdatedSubscriber, DEC-025).
+ * Payload anémico a propósito: el subscriber SIEMPRE lee el expediente fresco;
+ * nada de datos de negocio acá para que un mensaje viejo no decida con datos viejos.
+ */
+export class ExpedienteUpdatedMessage {
+
+    /**
+     * Discriminador. La cola es dedicada hoy, pero agregarlo ahora es gratis y
+     * agregarlo después de publicar sería breaking (mismo criterio que
+     * KycStepCompletedV1.eventType).
+     */
+    @Equals("EXPEDIENTE_UPDATED")
+    eventType: "EXPEDIENTE_UPDATED";
+
+    @IsUUID()
+    eventId: string;
+
+    @IsUUID()
+    directoryId: string;
+
+    @IsUUID()
+    peopleId: string;
+
+    @IsEnum(ExpedienteUpdatedSourceEnum)
+    source: ExpedienteUpdatedSourceEnum;
+
+    /** ISO-8601 estricto y en UTC (sufijo Z) — @IsISO8601 pelado acepta fechas sin hora y offsets locales (precedente: KycStepCompletedV1). */
+    @IsISO8601({ strict: true })
+    @Matches(/Z$/, { message: "occurredAt debe estar en UTC (sufijo Z)" })
+    occurredAt: string;
+}

package/src/onboarding/enums/ExpedienteUpdatedSourceEnum.ts

@@ -0,0 +1,7 @@
+/** Qué write-path de fiado-identity-lambda originó el evento (solo diagnóstico — el subscriber no decide por source). */
+export enum ExpedienteUpdatedSourceEnum {
+    PEOPLE = "PEOPLE",
+    ACCOUNT_REQUIREMENT_CONTROL = "ACCOUNT_REQUIREMENT_CONTROL",
+    DOCUMENT = "DOCUMENT",
+    AGENT = "AGENT",
+}

package/src/onboarding/index.ts

@@ -4,6 +4,10 @@ export * from './enums/OnboardingStepStatusEnum';
 export * from './enums/OnboardingAccountStatusEnum';
 export * from './enums/OnboardingAccountReasonEnum';
 export * from './enums/OnboardingAccountMessageKeyEnum';
+export * from './enums/ExpedienteUpdatedSourceEnum';
 
 // Response DTOs
 export * from './dtos/responses/OnboardingStepsResponse';
+
+// Queue messages
+export * from './dtos/ExpedienteUpdatedMessage';

package/src/retailCards/dtos/requests/RegisterCardBatchRequest.ts

@@ -1,4 +1,5 @@
-import { IsInt, IsOptional, IsString, Max, Min } from 'class-validator';
+import { Transform } from 'class-transformer';
+import { IsInt, IsNotEmpty, IsOptional, IsString, Max, Min } from 'class-validator';
 
 /**
  * Body del registro (recepción) de un lote de tarjetas para una tienda. Los sobres llegan sellados:
@@ -13,8 +14,13 @@ export class RegisterCardBatchRequest {
     @Max(1000)
     quantity!: number;
 
-    /** Folio de la remesa del proveedor: lo único que distingue dos entradas iguales a la misma tienda. */
+    /**
+     * Folio de la remesa del proveedor: lo único que distingue dos entradas iguales a la misma tienda.
+     * Se recorta y no admite blanco, porque es la clave de idempotencia de la recepción.
+     */
     @IsString()
+    @Transform(({ value }) => (typeof value === 'string' ? value.trim() : value))
+    @IsNotEmpty()
     supplierBatchRef!: string;
 
     @IsOptional()

package/src/retailCards/dtos/requests/WriteOffCardStockRequest.ts

@@ -1,4 +1,4 @@
-import { IsEnum, IsInt, IsOptional, IsString, Min } from 'class-validator';
+import { IsEnum, IsInt, IsOptional, IsString, IsUUID, Min } from 'class-validator';
 import { CardWriteOffReasonEnum } from '../../enums/CardWriteOffReasonEnum';
 
 /** Body de la baja de inventario de tarjetas de una tienda, por cantidad. */
@@ -10,6 +10,13 @@ export class WriteOffCardStockRequest {
     @IsEnum(CardWriteOffReasonEnum)
     reason!: CardWriteOffReasonEnum;
 
+    /**
+     * Clave de idempotencia de la baja, generada por el caller una vez por intento. Un reintento
+     * devuelve el asiento original: sin ella un doble clic descontaría el doble.
+     */
+    @IsUUID()
+    operationId!: string;
+
     @IsOptional()
     @IsString()
     notes?: string | null;

package/src/retailCards/dtos/responses/CardDeliveryResponse.ts

@@ -5,7 +5,10 @@
 export interface CardDeliveryResponse {
     deliveryId: string;
     movementSk: string;
-    /** Saldo disponible que quedó en la tienda después de descontar la entrega. */
-    availableAfter: number;
+    /**
+     * Saldo disponible de la tienda al momento de responder, leído después de la transacción. No es
+     * el saldo del instante del asiento: si otra entrega cae en medio, refleja las dos.
+     */
+    availableNow: number;
     occurredAt: string;
 }