@fiado/type-kit 3.242.0 → 3.244.0

package/bin/kyc/events/KycVerificationChangedV1.d.ts

@@ -60,4 +60,15 @@ export declare class KycVerificationChangedV1 {
      * ⚠️ PII: nunca loguear.
      */
     address?: KycAddress;
+    /**
+     * ¿El webhook YA persistió este domicilio en `fiado-address-lambda`? Solo es `true` cuando el
+     * documento es mexicano (único caso en que el webhook escribe) y el POST aterrizó.
+     *
+     * El consumidor lo necesita para NO volver a escribirlo: el address-lambda APILA — un segundo
+     * create sobre el mismo domicilio deja una fila duplicada en el expediente.
+     *
+     * OPCIONAL y aditivo: ausente o `false` significan "nadie lo guardó todavía", que es la
+     * degradación segura (el consumidor lo pide y lo guarda él).
+     */
+    addressPushedToFiado?: boolean;
 }

package/bin/kyc/events/KycVerificationChangedV1.js

@@ -98,3 +98,9 @@ __decorate([
     (0, class_transformer_1.Type)(() => KycAddress_1.KycAddress),
     __metadata("design:type", KycAddress_1.KycAddress)
 ], KycVerificationChangedV1.prototype, "address", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], KycVerificationChangedV1.prototype, "addressPushedToFiado", void 0);

package/bin/retailWizard/dtos/requests/SaveBeneficiaryRequest.d.ts

@@ -1,5 +1,22 @@
 import { WizardBeneficiary } from '../WizardBeneficiary';
-/** POST /wizard/sessions/:id/beneficiary — captura el beneficiario (opcional en N1 simplificado). SureKeep Fase 2 — pista Retail. */
+/**
+ * POST /wizard/sessions/:id/beneficiary — captura del beneficiario (opcional en N1 simplificado).
+ * SureKeep Fase 2 — pista Retail.
+ *
+ * 2026-07-29 (aditivo, retrocompatible): el reparto se puede repartir entre VARIOS beneficiarios, así
+ * que llega `beneficiaries` como lista. El destino (`beneficiary-business`) ya recibe un arreglo, y
+ * mandarlos juntos es lo que permite validar que el reparto cierre en 100 sin depender de leer lo que
+ * ya había — el GET privado del expediente todavía no está en todos los ambientes.
+ *
+ * `beneficiary` (singular) se conserva para los callers viejos: equivale a una lista de uno. El
+ * manager exige que llegue exactamente UNA de las dos formas.
+ */
 export declare class SaveBeneficiaryRequest {
-    beneficiary: WizardBeneficiary;
+    /** @deprecated Usar `beneficiaries`. Se mantiene para no romper callers desplegados. */
+    beneficiary?: WizardBeneficiary;
+    /**
+     * El reparto completo. Los porcentajes deben sumar 100 — el manager lo valida, porque un reparto
+     * parcial deja parte del saldo sin dueño y el destino no exige que cierre.
+     */
+    beneficiaries?: WizardBeneficiary[];
 }

package/bin/retailWizard/dtos/requests/SaveBeneficiaryRequest.js

@@ -13,13 +13,35 @@ exports.SaveBeneficiaryRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const WizardBeneficiary_1 = require("../WizardBeneficiary");
-/** POST /wizard/sessions/:id/beneficiary — captura el beneficiario (opcional en N1 simplificado). SureKeep Fase 2 — pista Retail. */
+/**
+ * POST /wizard/sessions/:id/beneficiary — captura del beneficiario (opcional en N1 simplificado).
+ * SureKeep Fase 2 — pista Retail.
+ *
+ * 2026-07-29 (aditivo, retrocompatible): el reparto se puede repartir entre VARIOS beneficiarios, así
+ * que llega `beneficiaries` como lista. El destino (`beneficiary-business`) ya recibe un arreglo, y
+ * mandarlos juntos es lo que permite validar que el reparto cierre en 100 sin depender de leer lo que
+ * ya había — el GET privado del expediente todavía no está en todos los ambientes.
+ *
+ * `beneficiary` (singular) se conserva para los callers viejos: equivale a una lista de uno. El
+ * manager exige que llegue exactamente UNA de las dos formas.
+ */
 class SaveBeneficiaryRequest {
 }
 exports.SaveBeneficiaryRequest = SaveBeneficiaryRequest;
 __decorate([
     (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
     (0, class_transformer_1.Type)(() => WizardBeneficiary_1.WizardBeneficiary),
     (0, class_validator_1.ValidateNested)(),
     __metadata("design:type", WizardBeneficiary_1.WizardBeneficiary)
 ], SaveBeneficiaryRequest.prototype, "beneficiary", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ArrayMaxSize)(10),
+    (0, class_transformer_1.Type)(() => WizardBeneficiary_1.WizardBeneficiary),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    __metadata("design:type", Array)
+], SaveBeneficiaryRequest.prototype, "beneficiaries", void 0);

package/package.json

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

package/src/kyc/events/KycVerificationChangedV1.ts

@@ -1,5 +1,5 @@
 import { Expose, Type } from 'class-transformer';
-import { IsEnum, IsISO8601, IsNotEmpty, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { IsBoolean, IsEnum, IsISO8601, IsNotEmpty, IsOptional, IsString, ValidateNested } from 'class-validator';
 import { IdentificationDocumentStatus } from '../../identity/enums/IdentificationDocumentStatus';
 import { KycVerificationStatusEnum } from '../enums/KycVerificationStatusEnum';
 import { KycSubChecks } from '../dtos/KycSubChecks';
@@ -82,4 +82,17 @@ export class KycVerificationChangedV1 {
      */
     @Expose() @IsOptional() @ValidateNested() @Type(() => KycAddress)
     address?: KycAddress;
+
+    /**
+     * ¿El webhook YA persistió este domicilio en `fiado-address-lambda`? Solo es `true` cuando el
+     * documento es mexicano (único caso en que el webhook escribe) y el POST aterrizó.
+     *
+     * El consumidor lo necesita para NO volver a escribirlo: el address-lambda APILA — un segundo
+     * create sobre el mismo domicilio deja una fila duplicada en el expediente.
+     *
+     * OPCIONAL y aditivo: ausente o `false` significan "nadie lo guardó todavía", que es la
+     * degradación segura (el consumidor lo pide y lo guarda él).
+     */
+    @Expose() @IsOptional() @IsBoolean()
+    addressPushedToFiado?: boolean;
 }

package/src/retailWizard/dtos/requests/SaveBeneficiaryRequest.ts

@@ -1,11 +1,37 @@
 import { Expose, Type } from 'class-transformer';
-import { ValidateNested } from 'class-validator';
+import { ArrayMaxSize, ArrayMinSize, IsArray, IsOptional, ValidateNested } from 'class-validator';
 import { WizardBeneficiary } from '../WizardBeneficiary';
 
-/** POST /wizard/sessions/:id/beneficiary — captura el beneficiario (opcional en N1 simplificado). SureKeep Fase 2 — pista Retail. */
+/**
+ * POST /wizard/sessions/:id/beneficiary — captura del beneficiario (opcional en N1 simplificado).
+ * SureKeep Fase 2 — pista Retail.
+ *
+ * 2026-07-29 (aditivo, retrocompatible): el reparto se puede repartir entre VARIOS beneficiarios, así
+ * que llega `beneficiaries` como lista. El destino (`beneficiary-business`) ya recibe un arreglo, y
+ * mandarlos juntos es lo que permite validar que el reparto cierre en 100 sin depender de leer lo que
+ * ya había — el GET privado del expediente todavía no está en todos los ambientes.
+ *
+ * `beneficiary` (singular) se conserva para los callers viejos: equivale a una lista de uno. El
+ * manager exige que llegue exactamente UNA de las dos formas.
+ */
 export class SaveBeneficiaryRequest {
+  /** @deprecated Usar `beneficiaries`. Se mantiene para no romper callers desplegados. */
   @Expose()
+  @IsOptional()
   @Type(() => WizardBeneficiary)
   @ValidateNested()
-  beneficiary!: WizardBeneficiary;
+  beneficiary?: WizardBeneficiary;
+
+  /**
+   * El reparto completo. Los porcentajes deben sumar 100 — el manager lo valida, porque un reparto
+   * parcial deja parte del saldo sin dueño y el destino no exige que cierre.
+   */
+  @Expose()
+  @IsOptional()
+  @IsArray()
+  @ArrayMinSize(1)
+  @ArrayMaxSize(10)
+  @Type(() => WizardBeneficiary)
+  @ValidateNested({ each: true })
+  beneficiaries?: WizardBeneficiary[];
 }