@fiado/type-kit 3.321.0 → 3.321.1

package/bin/walletFunding/dtos/CancelFundingRequest.js

@@ -0,0 +1,33 @@
+"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.CancelFundingRequest = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Request del cancel via Centro de Beneficios (spec 13 v2.0).
+ * `reference` viaja en el path, `directoryId` se resuelve del JWT.
+ * `providerModuleName` permite al marketplace rutear al publisher correcto
+ * sin tener que persistir el mapping (el wallet-app sabe el moduleName
+ * porque vino en la respuesta del authorize).
+ */
+class CancelFundingRequest {
+}
+exports.CancelFundingRequest = CancelFundingRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CancelFundingRequest.prototype, "idempotencyKey", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(128),
+    __metadata("design:type", String)
+], CancelFundingRequest.prototype, "providerModuleName", void 0);

package/bin/walletFunding/dtos/CancelFundingResponse.d.ts

@@ -0,0 +1,14 @@
+import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
+import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
+/**
+ * Response del cancel via Centro de Beneficios (spec 13 v2.0).
+ * `status` reusa `BenefitPaymentStatusEnum` (APPROVED = cancel aceptado;
+ * REJECTED = no se pudo) para consistencia con `CancelFundingReferenceResponse`
+ * (marketplace ↔ connector). Idempotente: re-cancelar devuelve APPROVED.
+ */
+export declare class CancelFundingResponse {
+    reference: string;
+    status: BenefitPaymentStatusEnum;
+    errorCode?: WalletFundingErrorCodeEnum;
+    message?: string;
+}

package/bin/walletFunding/dtos/CancelFundingResponse.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancelFundingResponse = void 0;
+/**
+ * Response del cancel via Centro de Beneficios (spec 13 v2.0).
+ * `status` reusa `BenefitPaymentStatusEnum` (APPROVED = cancel aceptado;
+ * REJECTED = no se pudo) para consistencia con `CancelFundingReferenceResponse`
+ * (marketplace ↔ connector). Idempotente: re-cancelar devuelve APPROVED.
+ */
+class CancelFundingResponse {
+}
+exports.CancelFundingResponse = CancelFundingResponse;

package/bin/walletFunding/dtos/CancelWalletFundingRequest.d.ts

@@ -0,0 +1,3 @@
+export declare class CancelWalletFundingRequest {
+    idempotencyKey: string;
+}

package/bin/walletFunding/dtos/CancelWalletFundingRequest.js

@@ -0,0 +1,21 @@
+"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.CancelWalletFundingRequest = void 0;
+const class_validator_1 = require("class-validator");
+class CancelWalletFundingRequest {
+}
+exports.CancelWalletFundingRequest = CancelWalletFundingRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CancelWalletFundingRequest.prototype, "idempotencyKey", void 0);

package/bin/walletFunding/dtos/CancelWalletFundingResponse.d.ts

@@ -0,0 +1,7 @@
+import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
+import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
+export declare class CancelWalletFundingResponse {
+    status: BenefitPaymentStatusEnum;
+    errorCode?: WalletFundingErrorCodeEnum;
+    reference?: string;
+}

package/bin/walletFunding/dtos/CancelWalletFundingResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancelWalletFundingResponse = void 0;
+class CancelWalletFundingResponse {
+}
+exports.CancelWalletFundingResponse = CancelWalletFundingResponse;

package/bin/walletFunding/dtos/GetWalletFundingLimitResponse.d.ts

@@ -1,22 +1,68 @@
 /**
- * Response del endpoint `POST /wallet-funding/limit` (processor).
+ * Response del endpoint de limites de wallet funding.
  *
- * Reporta el cap mensual del nivel del usuario (en MXN) y cuanto le queda
- * disponible este mes, para que el wallet-app pueda mostrar "Disponible este
- * mes: $X" antes de que el usuario haga cualquier deposito.
+ * Lo consume el wallet-app para decirle al usuario cuanto puede fondear ANTES
+ * de que vaya a la tienda. Hay dos topes distintos que lo pueden frenar, y el
+ * usuario tiene derecho a saber cual — asi que cada uno viaja en su propia
+ * propiedad en vez de colapsarlos en un solo numero:
  *
- * Semantica de los campos opcionales:
- *  - `monthlyLimit === undefined` → el nivel del usuario es ILIMITADO (el
- *    accountLevel tiene `maxMonthlyIncomingAmount = 0` en UDIs). En ese caso
- *    `remainingAmount` tambien viene undefined; el front muestra "Sin limite".
- *  - `monthlyLimit` definido → hay cap. `remainingAmount = max(0, monthlyLimit
- *    − monthlyConsumed)`. Si el usuario ya copo el cap, `remainingAmount = 0`.
+ *   1. TOPE DEL NIVEL DE CUENTA (`monthly*`) — regulatorio (CFPE / Contrato
+ *      EDM). Cubre TODAS las entradas del usuario: P2P, SPEI, Pomelo y tambien
+ *      el cash-in. Es el TECHO: nada puede pasarlo.
  *
- * `currency` siempre presente (default "MXN").
+ *   2. TOPE DE CASH IN (`cashIn*`) — decision de negocio Fiado, por cliente y
+ *      por mes calendario. Dice cuanto de ese techo puede venir por efectivo en
+ *      tienda. NO lo reemplaza: es un sub-limite dentro de el.
+ *
+ * El cap AGREGADO de exposicion FSA no se reporta aca: es global, no un limite
+ * personal del usuario. Si el servicio esta suspendido se comunica por otra via.
+ *
+ * `availableToFund` es la respuesta a "cuanto puedo depositar ahora": el MENOR
+ * de los dos, ya descontando lo pendiente. Es el unico numero que el front
+ * necesita para habilitar o bloquear; los demas sirven para explicar POR QUE,
+ * que es lo que evita el ticket de soporte.
+ *
+ * Compatibilidad: los cuatro campos originales conservan su semantica exacta.
+ * Los nuevos son opcionales — un caller viejo sigue funcionando igual.
  */
 export declare class GetWalletFundingLimitResponse {
+    /**
+     * Tope mensual de ENTRADAS del nivel de cuenta, en MXN.
+     * `undefined` = nivel ilimitado (`maxMonthlyIncomingAmount = 0` en UDIs);
+     * el front muestra "Sin limite".
+     */
     monthlyLimit?: number;
+    /** Entradas ya recibidas este mes por CUALQUIER via, no solo cash-in. */
     monthlyConsumed?: number;
+    /** `max(0, monthlyLimit − monthlyConsumed)`. `undefined` si no hay tope. */
     remainingAmount?: number;
+    /** Tope mensual de cash-in por cliente, en MXN. */
+    cashInMonthlyLimit?: number;
+    /** Cash-in ya ACREDITADO al cliente este mes. */
+    cashInMonthlyConsumed?: number;
+    /**
+     * Cash-in AUTORIZADO pero todavia no acreditado (pagos en verificacion).
+     *
+     * Cuenta contra el disponible aunque aun no toque el saldo: el cliente ya
+     * entrego ese efectivo en la caja y el dinero esta comprometido. Sin esto,
+     * en la ventana entre autorizar y acreditar el usuario veria un disponible
+     * inflado y podria pasarse del tope.
+     */
+    cashInMonthlyPending?: number;
+    /** `max(0, cashInMonthlyLimit − consumido − pendiente)`. */
+    cashInRemainingAmount?: number;
+    /**
+     * Cuanto puede fondear el usuario AHORA por cash-in: el menor entre
+     * `remainingAmount` y `cashInRemainingAmount`.
+     *
+     * Es el numero que el front debe usar para habilitar o bloquear el flujo.
+     */
+    availableToFund?: number;
+    /**
+     * Que tope esta limitando: `ACCOUNT_LEVEL` (el regulatorio del nivel) o
+     * `CASH_IN` (el de negocio). Permite explicarle al usuario por que no puede
+     * depositar mas, en vez de mostrarle un cero sin razon.
+     */
+    limitedBy?: "ACCOUNT_LEVEL" | "CASH_IN";
     currency: string;
 }

package/bin/walletFunding/dtos/GetWalletFundingLimitResponse.js

@@ -2,20 +2,31 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetWalletFundingLimitResponse = void 0;
 /**
- * Response del endpoint `POST /wallet-funding/limit` (processor).
+ * Response del endpoint de limites de wallet funding.
  *
- * Reporta el cap mensual del nivel del usuario (en MXN) y cuanto le queda
- * disponible este mes, para que el wallet-app pueda mostrar "Disponible este
- * mes: $X" antes de que el usuario haga cualquier deposito.
+ * Lo consume el wallet-app para decirle al usuario cuanto puede fondear ANTES
+ * de que vaya a la tienda. Hay dos topes distintos que lo pueden frenar, y el
+ * usuario tiene derecho a saber cual — asi que cada uno viaja en su propia
+ * propiedad en vez de colapsarlos en un solo numero:
  *
- * Semantica de los campos opcionales:
- *  - `monthlyLimit === undefined` → el nivel del usuario es ILIMITADO (el
- *    accountLevel tiene `maxMonthlyIncomingAmount = 0` en UDIs). En ese caso
- *    `remainingAmount` tambien viene undefined; el front muestra "Sin limite".
- *  - `monthlyLimit` definido → hay cap. `remainingAmount = max(0, monthlyLimit
- *    − monthlyConsumed)`. Si el usuario ya copo el cap, `remainingAmount = 0`.
+ *   1. TOPE DEL NIVEL DE CUENTA (`monthly*`) — regulatorio (CFPE / Contrato
+ *      EDM). Cubre TODAS las entradas del usuario: P2P, SPEI, Pomelo y tambien
+ *      el cash-in. Es el TECHO: nada puede pasarlo.
  *
- * `currency` siempre presente (default "MXN").
+ *   2. TOPE DE CASH IN (`cashIn*`) — decision de negocio Fiado, por cliente y
+ *      por mes calendario. Dice cuanto de ese techo puede venir por efectivo en
+ *      tienda. NO lo reemplaza: es un sub-limite dentro de el.
+ *
+ * El cap AGREGADO de exposicion FSA no se reporta aca: es global, no un limite
+ * personal del usuario. Si el servicio esta suspendido se comunica por otra via.
+ *
+ * `availableToFund` es la respuesta a "cuanto puedo depositar ahora": el MENOR
+ * de los dos, ya descontando lo pendiente. Es el unico numero que el front
+ * necesita para habilitar o bloquear; los demas sirven para explicar POR QUE,
+ * que es lo que evita el ticket de soporte.
+ *
+ * Compatibilidad: los cuatro campos originales conservan su semantica exacta.
+ * Los nuevos son opcionales — un caller viejo sigue funcionando igual.
  */
 class GetWalletFundingLimitResponse {
 }

package/package.json

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

package/src/common/decorators/Trim.ts

@@ -0,0 +1,8 @@
+import { Transform } from 'class-transformer';
+
+/**
+ * Recorta los espacios del borde de un string; deja pasar cualquier otro tipo sin tocarlo.
+ * Se aplica antes de los validadores, así que `'   '` llega como `''` y `@IsNotEmpty` lo rechaza.
+ */
+export const Trim = (): PropertyDecorator =>
+    Transform(({ value }) => (typeof value === 'string' ? value.trim() : value));

package/src/common/index.ts

@@ -1,3 +1,6 @@
+//decorators
+export * from './decorators/Trim';
+
 //dtos
 export * from './dtos/ProcessValidationResultDto';
 

package/src/networkConnector/dtos/CreateProfileRequest.ts

@@ -1,5 +1,5 @@
 import { Expose } from 'class-transformer';
-import { IsString, IsOptional, IsNotEmpty, IsObject, MaxLength, MinLength } from 'class-validator';
+import { IsString, IsOptional, IsObject, MaxLength, MinLength } from 'class-validator';
 
 export class CreateProfileRequest {
     @Expose() @IsString() @MinLength(1) @MaxLength(100) firstName!: string;
@@ -8,10 +8,7 @@ export class CreateProfileRequest {
     @Expose() @IsOptional() @IsString() @MaxLength(200) company?: string;
     @Expose() @IsString() @MinLength(2) @MaxLength(100) slug!: string;
     @Expose() @IsString() directoryId!: string;
-    /** Requerido desde DEC: se usa como llave para resolver el codigo de referido
-     * (IOnboardingBusinessApi.getByPhoneNumber) al crear el perfil. Inmutable tras la creacion
-     * (UpdateProfileRequest ya no acepta este campo). */
-    @Expose() @IsString() @IsNotEmpty() phone!: string;
+    @Expose() @IsOptional() @IsString() phone?: string;
     @Expose() @IsOptional() @IsString() email?: string;
     @Expose() @IsOptional() @IsString() @MaxLength(500) bio?: string;
     @Expose() @IsOptional() @IsObject() socialLinks?: Record<string, string>;

package/src/networkConnector/dtos/ProfileResponse.ts

@@ -13,9 +13,6 @@ export interface ProfileResponse {
     logoUrl?: string;
     bio?: string;
     socialLinks?: Record<string, string>;
-    /** Codigo de referido del promotor (myReferralCode de Onboarding), resuelto por telefono al
-     * crear el perfil. null si el telefono no tiene codigo asociado en Onboarding. */
-    referralCode?: string | null;
     status: ProfileStatusEnum;
     directoryId: string;
     createdAt: number;

package/src/networkConnector/dtos/UpdateProfileRequest.ts

@@ -8,8 +8,7 @@ export class UpdateProfileRequest {
     @Expose() @IsOptional() @IsString() @MaxLength(200) title?: string;
     @Expose() @IsOptional() @IsString() @MaxLength(200) company?: string;
     @Expose() @IsOptional() @IsString() @MinLength(2) @MaxLength(100) slug?: string;
-    // phone es inmutable tras la creacion del perfil (queda asociado al numero con el que se
-    // creo la cuenta, usado para resolver el codigo de referido). No se acepta en Update.
+    @Expose() @IsOptional() @IsString() phone?: string;
     @Expose() @IsOptional() @IsString() email?: string;
     @Expose() @IsOptional() @IsString() @MaxLength(500) bio?: string;
     @Expose() @IsOptional() @IsObject() socialLinks?: Record<string, string>;

package/src/retailCustomer/dtos/requests/WelcomeAccreditationRequest.ts

@@ -1,31 +1,26 @@
-import { Expose, Transform } from 'class-transformer';
+import { Expose } from 'class-transformer';
 import { IsEnum, IsInt, IsNotEmpty, IsOptional, IsPositive, IsString } from 'class-validator';
+import { Trim } from '../../../common/decorators/Trim';
 import { WelcomeBonusAmountSourceEnum } from '../../enums/WelcomeBonusAmountSourceEnum';
 
-/** Recorta los strings del borde: un valor con espacios ensucia claves y cortes de conciliación. */
-const trim = (): PropertyDecorator =>
-    Transform(({ value }) => (typeof value === 'string' ? value.trim() : value));
-
 /**
  * Datos de la venta que acompañan la reserva del bono de bienvenida (D33):
  * `POST /private/customers/:id/welcome-accreditation`. SureKeep Fase 2 — pista Retail.
  *
- * **TODOS los campos son opcionales a propósito.** El customer despliega antes que el wizard, así que
- * durante la ventana el wizard viejo sigue llamando sin body: el asiento nace incompleto y se acredita
- * igual. Exigirlos convertiría esa ventana en un 400 que deja al cliente sin bono.
+ * Todos los campos son opcionales: un caller que no los manda abre el asiento igual, incompleto.
  */
 export class WelcomeAccreditationRequest {
     /** Tienda donde se dio el bono — es la partición del asiento. */
     @Expose()
     @IsOptional()
-    @trim()
+    @Trim()
     @IsString()
     @IsNotEmpty()
     storeId?: string;
 
     @Expose()
     @IsOptional()
-    @trim()
+    @Trim()
     @IsString()
     @IsNotEmpty()
     retailerId?: string;
@@ -33,14 +28,14 @@ export class WelcomeAccreditationRequest {
     /** Vendedor que cerró la venta. */
     @Expose()
     @IsOptional()
-    @trim()
+    @Trim()
     @IsString()
     @IsNotEmpty()
     sellerRetailUserId?: string;
 
     @Expose()
     @IsOptional()
-    @trim()
+    @Trim()
     @IsString()
     @IsNotEmpty()
     saleId?: string;
@@ -48,14 +43,14 @@ export class WelcomeAccreditationRequest {
     /** Folio de la venta, tal como lo ve el vendedor en el ticket. */
     @Expose()
     @IsOptional()
-    @trim()
+    @Trim()
     @IsString()
     @IsNotEmpty()
     folio?: string;
 
     @Expose()
     @IsOptional()
-    @trim()
+    @Trim()
     @IsString()
     @IsNotEmpty()
     wizardSessionId?: string;
@@ -69,7 +64,7 @@ export class WelcomeAccreditationRequest {
     /** ISO-4217. Ausente ⇒ el server asienta `MXN`. */
     @Expose()
     @IsOptional()
-    @trim()
+    @Trim()
     @IsString()
     @IsNotEmpty()
     currency?: string;
@@ -82,14 +77,14 @@ export class WelcomeAccreditationRequest {
     /** Clave con la que el caller acredita en el processor — ata el asiento al movimiento de plata. */
     @Expose()
     @IsOptional()
-    @trim()
+    @Trim()
     @IsString()
     @IsNotEmpty()
     idempotencyKey?: string;
 
     @Expose()
     @IsOptional()
-    @trim()
+    @Trim()
     @IsString()
     @IsNotEmpty()
     providerName?: string;

package/src/retailCustomer/dtos/requests/WelcomeAccreditationResultRequest.ts

@@ -1,10 +1,10 @@
-import { Expose, Transform } from 'class-transformer';
-import { IsIn, IsNotEmpty, IsOptional, IsString, ValidateIf } from 'class-validator';
+import { Expose } from 'class-transformer';
+import { IsIn, IsNotEmpty, IsOptional, IsString, MaxLength, ValidateIf } from 'class-validator';
+import { Trim } from '../../../common/decorators/Trim';
 import { WelcomeBonusStatusEnum } from '../../enums/WelcomeBonusStatusEnum';
 
-/** Recorta los strings del borde: un valor con espacios ensucia claves y cortes de conciliación. */
-const trim = (): PropertyDecorator =>
-    Transform(({ value }) => (typeof value === 'string' ? value.trim() : value));
+/** Tope de los textos libres que el caller escribe en el asiento. */
+const FREE_TEXT_MAX_LENGTH = 256;
 
 /** Resultados que el caller puede asentar. `PENDING` lo escribe el server al reservar, no el caller. */
 const RESULT_STATUSES = [
@@ -26,11 +26,14 @@ const STATUSES_REQUIRING_REASON: WelcomeBonusStatusEnum[] = [
  * `FAILED` libera el candado `welcomeAccredited` para que la venta se reintente. `UNVERIFIED` lo deja
  * tomado: el `walletFundingCredit` del processor no deduplica, así que liberar tras un timeout podría
  * acreditar plata real dos veces.
+ *
+ * Un asiento `UNVERIFIED` se cierra después con `ACCREDITED` o `FAILED` mandando además `reconciledBy`
+ * y `reconciliationReason` — ese par es lo que marca el cierre como reconciliación.
  */
 export class WelcomeAccreditationResultRequest {
     /** Referencia opaca del asiento, tal como la devolvió la reserva. */
     @Expose()
-    @trim()
+    @Trim()
     @IsString()
     @IsNotEmpty()
     bonusKey!: string;
@@ -41,22 +44,42 @@ export class WelcomeAccreditationResultRequest {
 
     @Expose()
     @ValidateIf((o: WelcomeAccreditationResultRequest) => o.status === WelcomeBonusStatusEnum.ACCREDITED)
-    @trim()
+    @Trim()
     @IsString()
     @IsNotEmpty({ message: 'processorTransactionId es obligatorio cuando status es ACCREDITED' })
     processorTransactionId?: string;
 
+    /** Motivo legible del fallo — un resumen, NO el payload crudo del processor (el libro va sin PII). */
     @Expose()
     @ValidateIf((o: WelcomeAccreditationResultRequest) => STATUSES_REQUIRING_REASON.includes(o.status))
-    @trim()
+    @Trim()
     @IsString()
     @IsNotEmpty({ message: 'failReason es obligatorio cuando status es FAILED o UNVERIFIED' })
+    @MaxLength(FREE_TEXT_MAX_LENGTH)
     failReason?: string;
 
     @Expose()
     @IsOptional()
-    @trim()
+    @Trim()
     @IsString()
     @IsNotEmpty()
     providerName?: string;
+
+    /** Quién cierra a mano un asiento `UNVERIFIED`. Va junto con `reconciliationReason`. */
+    @Expose()
+    @ValidateIf((o: WelcomeAccreditationResultRequest) => o.reconciliationReason !== undefined)
+    @Trim()
+    @IsString()
+    @IsNotEmpty({ message: 'reconciledBy es obligatorio en un cierre de reconciliación' })
+    @MaxLength(FREE_TEXT_MAX_LENGTH)
+    reconciledBy?: string;
+
+    /** Por qué se cerró a mano — un resumen, NO el payload crudo del processor. */
+    @Expose()
+    @ValidateIf((o: WelcomeAccreditationResultRequest) => o.reconciledBy !== undefined)
+    @Trim()
+    @IsString()
+    @IsNotEmpty({ message: 'reconciliationReason es obligatorio en un cierre de reconciliación' })
+    @MaxLength(FREE_TEXT_MAX_LENGTH)
+    reconciliationReason?: string;
 }

package/src/retailCustomer/dtos/responses/WelcomeBonusResponse.ts

@@ -32,6 +32,10 @@ export interface WelcomeBonusResponse {
     failReason: string | null;
     requestedAt: string;
     resolvedAt: string | null;
+    /** Instante del cierre de reconciliación. No nulo = el asiento se cerró a mano, no por el flujo. */
+    reconciledAt: string | null;
+    reconciledBy: string | null;
+    reconciliationReason: string | null;
     processorTransactionId: string | null;
     idempotencyKey: string | null;
     providerName: string | null;

package/src/retailWizard/dtos/WizardBlocked.ts

@@ -24,10 +24,15 @@ export interface WizardBlocked {
 }
 
 /**
- * Lo mínimo del bloqueo que necesita la ficha de Prospectos: la etiqueta y el «hace N días». Deja
- * fuera `code` y `detail`, que son de soporte y admin.
+ * Lo del bloqueo que puede viajar al navegador del vendedor: qué pantalla toca, la etiqueta y el
+ * «hace N días». Deja fuera `code` y `detail`, que son de soporte y admin.
  */
 export interface WizardBlockedSummary {
+    /**
+     * Cuál de las dos pantallas del paso 02 toca: la espera, o «no se pudo abrir». Opcional: la ficha
+     * de Prospectos no lo manda, y un consumidor que no lo conoce sigue leyendo `category`.
+     */
+    reason?: BlockedReasonEnum;
     category: BlockedCategoryEnum | null;
     /** ISO 8601, copiado tal cual de `WizardBlocked.since`. */
     since: string;

package/src/retailWizard/dtos/WizardSession.ts

@@ -4,7 +4,7 @@ import type { FiadoPhoneStatusEnum } from '../enums/FiadoPhoneStatusEnum';
 import type { PaymentMethodEnum } from '../enums/PaymentMethodEnum';
 import type { ExternalProviderEnum } from '../enums/ExternalProviderEnum';
 import type { OccupationEnum } from '../enums/OccupationEnum';
-import type { WizardBlocked } from './WizardBlocked';
+import type { WizardBlockedSummary } from './WizardBlocked';
 import type { WizardConsents } from './WizardConsents';
 import type { WizardLoan } from './WizardLoan';
 import type { WizardPayment } from './WizardPayment';
@@ -98,12 +98,11 @@ export interface WizardSession {
   accountOpened: boolean;
   accountStatus: AccountStatus | null;
   /**
-   * La venta está detenida esperando la cuenta. Es un campo y no un estado: `state` sigue `ACTIVE`,
-   * así el retorno, las mutaciones del paso 10 y los barridos de mantenimiento siguen corriendo.
-   *
-   * Opcional por lo mismo que `resumeOtpRequired`. Ausente o `null` = la venta va bien.
+   * La venta está detenida esperando la cuenta. Resumen y no el bloqueo entero: el motivo crudo del
+   * emisor puede nombrar una coincidencia en listas de PLD, y avisarlo es delito — se sirve por su
+   * propio endpoint con permiso. Ausente o `null` = la venta va bien.
    */
-  blocked?: WizardBlocked | null;
+  blocked?: WizardBlockedSummary | null;
   reservedSku: string | null;
   reservedImei: string | null;
   /**

package/src/walletFunding/dtos/GetWalletFundingLimitResponse.ts

@@ -1,22 +1,71 @@
 /**
- * Response del endpoint `POST /wallet-funding/limit` (processor).
+ * Response del endpoint de limites de wallet funding.
  *
- * Reporta el cap mensual del nivel del usuario (en MXN) y cuanto le queda
- * disponible este mes, para que el wallet-app pueda mostrar "Disponible este
- * mes: $X" antes de que el usuario haga cualquier deposito.
+ * Lo consume el wallet-app para decirle al usuario cuanto puede fondear ANTES
+ * de que vaya a la tienda. Hay dos topes distintos que lo pueden frenar, y el
+ * usuario tiene derecho a saber cual — asi que cada uno viaja en su propia
+ * propiedad en vez de colapsarlos en un solo numero:
  *
- * Semantica de los campos opcionales:
- *  - `monthlyLimit === undefined` → el nivel del usuario es ILIMITADO (el
- *    accountLevel tiene `maxMonthlyIncomingAmount = 0` en UDIs). En ese caso
- *    `remainingAmount` tambien viene undefined; el front muestra "Sin limite".
- *  - `monthlyLimit` definido → hay cap. `remainingAmount = max(0, monthlyLimit
- *    − monthlyConsumed)`. Si el usuario ya copo el cap, `remainingAmount = 0`.
+ *   1. TOPE DEL NIVEL DE CUENTA (`monthly*`) — regulatorio (CFPE / Contrato
+ *      EDM). Cubre TODAS las entradas del usuario: P2P, SPEI, Pomelo y tambien
+ *      el cash-in. Es el TECHO: nada puede pasarlo.
  *
- * `currency` siempre presente (default "MXN").
+ *   2. TOPE DE CASH IN (`cashIn*`) — decision de negocio Fiado, por cliente y
+ *      por mes calendario. Dice cuanto de ese techo puede venir por efectivo en
+ *      tienda. NO lo reemplaza: es un sub-limite dentro de el.
+ *
+ * El cap AGREGADO de exposicion FSA no se reporta aca: es global, no un limite
+ * personal del usuario. Si el servicio esta suspendido se comunica por otra via.
+ *
+ * `availableToFund` es la respuesta a "cuanto puedo depositar ahora": el MENOR
+ * de los dos, ya descontando lo pendiente. Es el unico numero que el front
+ * necesita para habilitar o bloquear; los demas sirven para explicar POR QUE,
+ * que es lo que evita el ticket de soporte.
+ *
+ * Compatibilidad: los cuatro campos originales conservan su semantica exacta.
+ * Los nuevos son opcionales — un caller viejo sigue funcionando igual.
  */
 export class GetWalletFundingLimitResponse {
+    /**
+     * Tope mensual de ENTRADAS del nivel de cuenta, en MXN.
+     * `undefined` = nivel ilimitado (`maxMonthlyIncomingAmount = 0` en UDIs);
+     * el front muestra "Sin limite".
+     */
     monthlyLimit?: number;
+    /** Entradas ya recibidas este mes por CUALQUIER via, no solo cash-in. */
     monthlyConsumed?: number;
+    /** `max(0, monthlyLimit − monthlyConsumed)`. `undefined` si no hay tope. */
     remainingAmount?: number;
+
+    /** Tope mensual de cash-in por cliente, en MXN. */
+    cashInMonthlyLimit?: number;
+    /** Cash-in ya ACREDITADO al cliente este mes. */
+    cashInMonthlyConsumed?: number;
+    /**
+     * Cash-in AUTORIZADO pero todavia no acreditado (pagos en verificacion).
+     *
+     * Cuenta contra el disponible aunque aun no toque el saldo: el cliente ya
+     * entrego ese efectivo en la caja y el dinero esta comprometido. Sin esto,
+     * en la ventana entre autorizar y acreditar el usuario veria un disponible
+     * inflado y podria pasarse del tope.
+     */
+    cashInMonthlyPending?: number;
+    /** `max(0, cashInMonthlyLimit − consumido − pendiente)`. */
+    cashInRemainingAmount?: number;
+
+    /**
+     * Cuanto puede fondear el usuario AHORA por cash-in: el menor entre
+     * `remainingAmount` y `cashInRemainingAmount`.
+     *
+     * Es el numero que el front debe usar para habilitar o bloquear el flujo.
+     */
+    availableToFund?: number;
+    /**
+     * Que tope esta limitando: `ACCOUNT_LEVEL` (el regulatorio del nivel) o
+     * `CASH_IN` (el de negocio). Permite explicarle al usuario por que no puede
+     * depositar mas, en vez de mostrarle un cero sin razon.
+     */
+    limitedBy?: "ACCOUNT_LEVEL" | "CASH_IN";
+
     currency!: string;
 }