@fiado/type-kit 3.321.0 → 3.322.0

package/_test_/unit/retailCustomer/welcomeBonusRequests.test.ts

@@ -131,6 +131,77 @@ describe('WelcomeAccreditationResultRequest — cerrar el asiento', () => {
             ).toContain('bonusKey');
         }
     });
+
+    // El asiento se declara SIN PII y `failReason` es el único texto libre que escribe el caller: un
+    // payload crudo del processor podría meterle una CLABE al libro.
+    it('rechaza un failReason de más de 256 caracteres', () => {
+        expect(
+            errorsOf(WelcomeAccreditationResultRequest, {
+                bonusKey: 'key-1',
+                status: WelcomeBonusStatusEnum.FAILED,
+                failReason: 'x'.repeat(257),
+            }),
+        ).toContain('failReason');
+    });
+
+    it('acepta un failReason de 256 caracteres', () => {
+        expect(
+            errorsOf(WelcomeAccreditationResultRequest, {
+                bonusKey: 'key-1',
+                status: WelcomeBonusStatusEnum.FAILED,
+                failReason: 'x'.repeat(256),
+            }),
+        ).toEqual([]);
+    });
+});
+
+describe('WelcomeAccreditationResultRequest — cierre de reconciliación', () => {
+    const RECONCILED = {
+        bonusKey: 'key-1',
+        status: WelcomeBonusStatusEnum.ACCREDITED,
+        processorTransactionId: 'tx-1',
+        reconciledBy: 'ops@somosfiado.com',
+        reconciliationReason: 'confirmado en el estado de cuenta del processor',
+    };
+
+    it('acepta el cierre con actor y motivo', () => {
+        expect(errorsOf(WelcomeAccreditationResultRequest, RECONCILED)).toEqual([]);
+    });
+
+    // Media reconciliación no sirve: un asiento cerrado a mano sin quién o sin por qué no es auditable.
+    it('exige el motivo cuando viene el actor', () => {
+        expect(
+            errorsOf(WelcomeAccreditationResultRequest, {
+                ...RECONCILED,
+                reconciliationReason: undefined,
+            }),
+        ).toContain('reconciliationReason');
+    });
+
+    it('exige el actor cuando viene el motivo', () => {
+        expect(
+            errorsOf(WelcomeAccreditationResultRequest, { ...RECONCILED, reconciledBy: undefined }),
+        ).toContain('reconciledBy');
+    });
+
+    it('rechaza un motivo de más de 256 caracteres', () => {
+        expect(
+            errorsOf(WelcomeAccreditationResultRequest, {
+                ...RECONCILED,
+                reconciliationReason: 'x'.repeat(257),
+            }),
+        ).toContain('reconciliationReason');
+    });
+
+    it('recorta los espacios del actor y del motivo', () => {
+        const dto = plainToInstance(
+            WelcomeAccreditationResultRequest,
+            { ...RECONCILED, reconciledBy: '  ops@somosfiado.com ', reconciliationReason: ' ok ' },
+            { excludeExtraneousValues: true },
+        );
+        expect(dto.reconciledBy).toBe('ops@somosfiado.com');
+        expect(dto.reconciliationReason).toBe('ok');
+    });
 });
 
 describe('enums del bono de bienvenida', () => {

package/bin/common/decorators/Trim.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 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 declare const Trim: () => PropertyDecorator;

package/bin/common/decorators/Trim.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Trim = void 0;
+const class_transformer_1 = require("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.
+ */
+const Trim = () => (0, class_transformer_1.Transform)(({ value }) => (typeof value === 'string' ? value.trim() : value));
+exports.Trim = Trim;

package/bin/common/index.d.ts

@@ -1,3 +1,4 @@
+export * from './decorators/Trim';
 export * from './dtos/ProcessValidationResultDto';
 export * from './enums/ProcessValidationEnum';
 export * from './enums/ProcessResultEnum';

package/bin/common/index.js

@@ -14,6 +14,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+//decorators
+__exportStar(require("./decorators/Trim"), exports);
 //dtos
 __exportStar(require("./dtos/ProcessValidationResultDto"), exports);
 //Enums

package/bin/networkConnector/dtos/CreateProfileRequest.d.ts

@@ -5,10 +5,7 @@ export declare class CreateProfileRequest {
     company?: string;
     slug: string;
     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). */
-    phone: string;
+    phone?: string;
     email?: string;
     bio?: string;
     socialLinks?: Record<string, string>;

package/bin/networkConnector/dtos/CreateProfileRequest.js

@@ -57,8 +57,8 @@ __decorate([
 ], CreateProfileRequest.prototype, "directoryId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], CreateProfileRequest.prototype, "phone", void 0);
 __decorate([

package/bin/networkConnector/dtos/ProfileResponse.d.ts

@@ -12,9 +12,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/bin/networkConnector/dtos/UpdateProfileRequest.d.ts

@@ -5,6 +5,7 @@ export declare class UpdateProfileRequest {
     title?: string;
     company?: string;
     slug?: string;
+    phone?: string;
     email?: string;
     bio?: string;
     socialLinks?: Record<string, string>;

package/bin/networkConnector/dtos/UpdateProfileRequest.js

@@ -54,6 +54,12 @@ __decorate([
     (0, class_validator_1.MaxLength)(100),
     __metadata("design:type", String)
 ], UpdateProfileRequest.prototype, "slug", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateProfileRequest.prototype, "phone", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

package/bin/retailCustomer/dtos/requests/WelcomeAccreditationRequest.d.ts

@@ -3,9 +3,7 @@ import { WelcomeBonusAmountSourceEnum } from '../../enums/WelcomeBonusAmountSour
  * 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 declare class WelcomeAccreditationRequest {
     /** Tienda donde se dio el bono — es la partición del asiento. */

package/bin/retailCustomer/dtos/requests/WelcomeAccreditationRequest.js

@@ -12,16 +12,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.WelcomeAccreditationRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const Trim_1 = require("../../../common/decorators/Trim");
 const WelcomeBonusAmountSourceEnum_1 = require("../../enums/WelcomeBonusAmountSourceEnum");
-/** Recorta los strings del borde: un valor con espacios ensucia claves y cortes de conciliación. */
-const trim = () => (0, class_transformer_1.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.
  */
 class WelcomeAccreditationRequest {
 }
@@ -29,7 +26,7 @@ exports.WelcomeAccreditationRequest = WelcomeAccreditationRequest;
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
-    trim(),
+    (0, Trim_1.Trim)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
@@ -37,7 +34,7 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
-    trim(),
+    (0, Trim_1.Trim)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
@@ -45,7 +42,7 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
-    trim(),
+    (0, Trim_1.Trim)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
@@ -53,7 +50,7 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
-    trim(),
+    (0, Trim_1.Trim)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
@@ -61,7 +58,7 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
-    trim(),
+    (0, Trim_1.Trim)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
@@ -69,7 +66,7 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
-    trim(),
+    (0, Trim_1.Trim)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
@@ -84,7 +81,7 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
-    trim(),
+    (0, Trim_1.Trim)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
@@ -98,7 +95,7 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
-    trim(),
+    (0, Trim_1.Trim)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
@@ -106,7 +103,7 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
-    trim(),
+    (0, Trim_1.Trim)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)

package/bin/retailCustomer/dtos/requests/WelcomeAccreditationResultRequest.d.ts

@@ -6,12 +6,20 @@ import { WelcomeBonusStatusEnum } from '../../enums/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 declare class WelcomeAccreditationResultRequest {
     /** Referencia opaca del asiento, tal como la devolvió la reserva. */
     bonusKey: string;
     status: WelcomeBonusStatusEnum;
     processorTransactionId?: string;
+    /** Motivo legible del fallo — un resumen, NO el payload crudo del processor (el libro va sin PII). */
     failReason?: string;
     providerName?: string;
+    /** Quién cierra a mano un asiento `UNVERIFIED`. Va junto con `reconciliationReason`. */
+    reconciledBy?: string;
+    /** Por qué se cerró a mano — un resumen, NO el payload crudo del processor. */
+    reconciliationReason?: string;
 }

package/bin/retailCustomer/dtos/requests/WelcomeAccreditationResultRequest.js

@@ -12,9 +12,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.WelcomeAccreditationResultRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const Trim_1 = require("../../../common/decorators/Trim");
 const WelcomeBonusStatusEnum_1 = require("../../enums/WelcomeBonusStatusEnum");
-/** Recorta los strings del borde: un valor con espacios ensucia claves y cortes de conciliación. */
-const trim = () => (0, class_transformer_1.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 = [
     WelcomeBonusStatusEnum_1.WelcomeBonusStatusEnum.ACCREDITED,
@@ -33,13 +34,16 @@ const STATUSES_REQUIRING_REASON = [
  * `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.
  */
 class WelcomeAccreditationResultRequest {
 }
 exports.WelcomeAccreditationResultRequest = WelcomeAccreditationResultRequest;
 __decorate([
     (0, class_transformer_1.Expose)(),
-    trim(),
+    (0, Trim_1.Trim)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
@@ -52,7 +56,7 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.ValidateIf)((o) => o.status === WelcomeBonusStatusEnum_1.WelcomeBonusStatusEnum.ACCREDITED),
-    trim(),
+    (0, Trim_1.Trim)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)({ message: 'processorTransactionId es obligatorio cuando status es ACCREDITED' }),
     __metadata("design:type", String)
@@ -60,16 +64,35 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.ValidateIf)((o) => STATUSES_REQUIRING_REASON.includes(o.status)),
-    trim(),
+    (0, Trim_1.Trim)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)({ message: 'failReason es obligatorio cuando status es FAILED o UNVERIFIED' }),
+    (0, class_validator_1.MaxLength)(FREE_TEXT_MAX_LENGTH),
     __metadata("design:type", String)
 ], WelcomeAccreditationResultRequest.prototype, "failReason", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
-    trim(),
+    (0, Trim_1.Trim)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], WelcomeAccreditationResultRequest.prototype, "providerName", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)((o) => o.reconciliationReason !== undefined),
+    (0, Trim_1.Trim)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)({ message: 'reconciledBy es obligatorio en un cierre de reconciliación' }),
+    (0, class_validator_1.MaxLength)(FREE_TEXT_MAX_LENGTH),
+    __metadata("design:type", String)
+], WelcomeAccreditationResultRequest.prototype, "reconciledBy", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)((o) => o.reconciledBy !== undefined),
+    (0, Trim_1.Trim)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)({ message: 'reconciliationReason es obligatorio en un cierre de reconciliación' }),
+    (0, class_validator_1.MaxLength)(FREE_TEXT_MAX_LENGTH),
+    __metadata("design:type", String)
+], WelcomeAccreditationResultRequest.prototype, "reconciliationReason", void 0);

package/bin/retailCustomer/dtos/responses/WelcomeBonusResponse.d.ts

@@ -31,6 +31,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/bin/retailWizard/dtos/WizardBlocked.d.ts

@@ -22,10 +22,15 @@ export interface WizardBlocked {
     since: string;
 }
 /**
- * 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/bin/retailWizard/dtos/WizardSession.d.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';
@@ -94,12 +94,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/bin/retailWizard/dtos/requests/CreateProspectRequest.d.ts

@@ -12,4 +12,6 @@ export declare class CreateProspectRequest {
     freeReason?: string;
     nextContactAt?: string;
     notes?: string;
+    /** La venta de la que sale el prospecto: el único camino de vuelta del prospecto a su sesión. */
+    wizardSessionId?: string;
 }

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

@@ -65,3 +65,9 @@ __decorate([
     (0, class_validator_1.MaxLength)(200),
     __metadata("design:type", String)
 ], CreateProspectRequest.prototype, "notes", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateProspectRequest.prototype, "wizardSessionId", void 0);

package/bin/retailWizard/enums/PendingReasonEnum.d.ts

@@ -1,5 +1,8 @@
 /**
- * Motivo por el que un cliente quedó como prospecto (15 valores, filtrados por paso).
+ * Motivo por el que un cliente quedó como prospecto, filtrados por paso.
+ *
+ * Los primeros quince son objeciones del CLIENTE y los elige el vendedor. Los dos últimos los pone
+ * el sistema cuando la venta se traba por la cuenta: no se ofrecen en el desplegable ni se editan.
  * SureKeep Fase 2 — pista Retail.
  */
 export declare enum PendingReasonEnum {
@@ -17,5 +20,14 @@ export declare enum PendingReasonEnum {
     CONTRACT_DOUBTS = "CONTRACT_DOUBTS",
     DEVICE_ISSUE = "DEVICE_ISSUE",
     CLIENT_THINKING = "CLIENT_THINKING",
-    OTHER = "OTHER"
+    OTHER = "OTHER",
+    /**
+     * La cuenta espera a que una persona la revise. Nunca nombra el área ni la causa: decir que hubo
+     * coincidencia en una lista de PLD es aviso indebido.
+     */
+    ACCOUNT_UNDER_REVIEW = "ACCOUNT_UNDER_REVIEW",
+    /** La cuenta no abrió por un dato del expediente o una falla del proveedor. */
+    ACCOUNT_OPEN_FAILED = "ACCOUNT_OPEN_FAILED"
 }
+/** Los que pone el sistema al trabarse la venta: no se ofrecen al vendedor ni se pueden editar. */
+export declare const SYSTEM_PENDING_REASONS: readonly PendingReasonEnum[];

package/bin/retailWizard/enums/PendingReasonEnum.js

@@ -1,8 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PendingReasonEnum = void 0;
+exports.SYSTEM_PENDING_REASONS = exports.PendingReasonEnum = void 0;
 /**
- * Motivo por el que un cliente quedó como prospecto (15 valores, filtrados por paso).
+ * Motivo por el que un cliente quedó como prospecto, filtrados por paso.
+ *
+ * Los primeros quince son objeciones del CLIENTE y los elige el vendedor. Los dos últimos los pone
+ * el sistema cuando la venta se traba por la cuenta: no se ofrecen en el desplegable ni se editan.
  * SureKeep Fase 2 — pista Retail.
  */
 var PendingReasonEnum;
@@ -22,4 +25,16 @@ var PendingReasonEnum;
     PendingReasonEnum["DEVICE_ISSUE"] = "DEVICE_ISSUE";
     PendingReasonEnum["CLIENT_THINKING"] = "CLIENT_THINKING";
     PendingReasonEnum["OTHER"] = "OTHER";
+    /**
+     * La cuenta espera a que una persona la revise. Nunca nombra el área ni la causa: decir que hubo
+     * coincidencia en una lista de PLD es aviso indebido.
+     */
+    PendingReasonEnum["ACCOUNT_UNDER_REVIEW"] = "ACCOUNT_UNDER_REVIEW";
+    /** La cuenta no abrió por un dato del expediente o una falla del proveedor. */
+    PendingReasonEnum["ACCOUNT_OPEN_FAILED"] = "ACCOUNT_OPEN_FAILED";
 })(PendingReasonEnum || (exports.PendingReasonEnum = PendingReasonEnum = {}));
+/** Los que pone el sistema al trabarse la venta: no se ofrecen al vendedor ni se pueden editar. */
+exports.SYSTEM_PENDING_REASONS = [
+    PendingReasonEnum.ACCOUNT_UNDER_REVIEW,
+    PendingReasonEnum.ACCOUNT_OPEN_FAILED,
+];

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 {
 }