@fiado/type-kit 3.317.1 → 3.318.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/_test_/unit/retailWizard/wizardBlocked.test.ts

@@ -0,0 +1,33 @@
+import 'reflect-metadata';
+import * as retailWizard from '../../../src/retailWizard';
+import { BlockedCategoryEnum } from '../../../src/retailWizard/enums/BlockedCategoryEnum';
+import { BlockedReasonEnum } from '../../../src/retailWizard/enums/BlockedReasonEnum';
+
+describe('BlockedReasonEnum', () => {
+  it('distingue la espera normal del bloqueo que detiene la venta', () => {
+    expect(BlockedReasonEnum.ACCOUNT_OPENING).toBe('ACCOUNT_OPENING');
+    expect(BlockedReasonEnum.ACCOUNT_BLOCKED).toBe('ACCOUNT_BLOCKED');
+    expect(Object.keys(BlockedReasonEnum)).toHaveLength(2);
+  });
+});
+
+describe('BlockedCategoryEnum', () => {
+  it('tiene las tres categorias que dicen quien resuelve', () => {
+    expect(BlockedCategoryEnum.CUSTOMER_RECORD).toBe('CUSTOMER_RECORD');
+    expect(BlockedCategoryEnum.UNDER_REVIEW).toBe('UNDER_REVIEW');
+    expect(BlockedCategoryEnum.TEMPORARY).toBe('TEMPORARY');
+    expect(Object.keys(BlockedCategoryEnum)).toHaveLength(3);
+  });
+
+  it('ningun valor nombra listas de cumplimiento ni PLD', () => {
+    const values = Object.values(BlockedCategoryEnum).join(' ');
+    expect(values).not.toMatch(/WATCHLIST|BLACKLIST|PLD|AML|SANCTION/i);
+  });
+});
+
+describe('barril de retailWizard', () => {
+  it('exporta los dos enums del bloqueo', () => {
+    expect(retailWizard.BlockedReasonEnum).toBe(BlockedReasonEnum);
+    expect(retailWizard.BlockedCategoryEnum).toBe(BlockedCategoryEnum);
+  });
+});

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/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

@@ -0,0 +1,32 @@
+import type { BlockedCategoryEnum } from '../enums/BlockedCategoryEnum';
+import type { BlockedReasonEnum } from '../enums/BlockedReasonEnum';
+import type { WizardStepEnum } from '../enums/WizardStepEnum';
+/**
+ * La venta detenida porque la cuenta PagoConFiado del comprador no está lista
+ * (`WizardSession.blocked`). Ausente o `null` = la venta va bien. SureKeep Fase 2 — pista Retail.
+ */
+export interface WizardBlocked {
+    reason: BlockedReasonEnum;
+    /** Quién resuelve. `null` durante la espera normal: todavía no hay bloqueo que categorizar. */
+    category: BlockedCategoryEnum | null;
+    /** Código del motivo que trae el diario del emisor. `null` mientras ese diario no se lee. */
+    code: string | null;
+    /** Motivo crudo escrito por el emisor, para soporte y admin. Nunca se le muestra al vendedor. */
+    detail: string | null;
+    /** Paso donde se trabó la venta. Hoy siempre `S02`, el único punto de corte por cuenta. */
+    atStep: WizardStepEnum;
+    /**
+     * Desde cuándo lleva trabada, ISO 8601. Es el «hace N días» de Prospectos, y es un campo propio
+     * porque el reintento va a mover `updatedAt` en cada vuelta.
+     */
+    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.
+ */
+export interface WizardBlockedSummary {
+    category: BlockedCategoryEnum | null;
+    /** ISO 8601, copiado tal cual de `WizardBlocked.since`. */
+    since: string;
+}

package/bin/retailWizard/dtos/WizardSession.d.ts

@@ -4,6 +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 { WizardConsents } from './WizardConsents';
 import type { WizardLoan } from './WizardLoan';
 import type { WizardPayment } from './WizardPayment';
@@ -92,6 +93,13 @@ export interface WizardSession {
     pcfProvisioned: boolean;
     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.
+     */
+    blocked?: WizardBlocked | null;
     reservedSku: string | null;
     reservedImei: string | null;
     /**

package/bin/retailWizard/dtos/responses/ActiveSessionByPhoneResponse.d.ts

@@ -1,5 +1,6 @@
 import type { WizardStateEnum } from '../../enums/WizardStateEnum';
 import type { WizardStepEnum } from '../../enums/WizardStepEnum';
+import type { WizardBlockedSummary } from '../WizardBlocked';
 /**
  * GET /wizard/sessions?phone=... — la venta en curso de un telefono, para la pestana «Wizard» de la
  * pantalla Prospectos. El prospecto no guarda la sesion, asi que el telefono es la unica llave.
@@ -18,4 +19,9 @@ export interface ActiveSessionByPhoneResponse {
     currentStep: WizardStepEnum | null;
     /** Hoy siempre `ACTIVE`: la busqueda filtra por ese estado. `null` cuando `found` es `false`. */
     state: WizardStateEnum | null;
+    /**
+     * El bloqueo de la venta, para pintar la etiqueta y el «hace N dias». `null` cuando la venta va
+     * bien o cuando `found` es `false`.
+     */
+    blocked?: WizardBlockedSummary | null;
 }

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

@@ -0,0 +1,15 @@
+/**
+ * Quién resuelve el bloqueo de la venta, sin decir por qué. Es lo único del motivo que se muestra en
+ * la ficha de Prospectos. SureKeep Fase 2 — pista Retail.
+ */
+export declare enum BlockedCategoryEnum {
+    /** Falta corregir información del expediente; lo resuelve un agente de Fiado en su backoffice. */
+    CUSTOMER_RECORD = "CUSTOMER_RECORD",
+    /**
+     * El caso lo está mirando alguien. No es exclusiva de listas de cumplimiento: verla NO afirma que
+     * hubo coincidencia, y avisar de una coincidencia es delito.
+     */
+    UNDER_REVIEW = "UNDER_REVIEW",
+    /** Falla pasajera del proveedor o de la lectura; cede sola cuando el servicio vuelve. */
+    TEMPORARY = "TEMPORARY"
+}

package/bin/retailWizard/enums/BlockedCategoryEnum.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlockedCategoryEnum = void 0;
+/**
+ * Quién resuelve el bloqueo de la venta, sin decir por qué. Es lo único del motivo que se muestra en
+ * la ficha de Prospectos. SureKeep Fase 2 — pista Retail.
+ */
+var BlockedCategoryEnum;
+(function (BlockedCategoryEnum) {
+    /** Falta corregir información del expediente; lo resuelve un agente de Fiado en su backoffice. */
+    BlockedCategoryEnum["CUSTOMER_RECORD"] = "CUSTOMER_RECORD";
+    /**
+     * El caso lo está mirando alguien. No es exclusiva de listas de cumplimiento: verla NO afirma que
+     * hubo coincidencia, y avisar de una coincidencia es delito.
+     */
+    BlockedCategoryEnum["UNDER_REVIEW"] = "UNDER_REVIEW";
+    /** Falla pasajera del proveedor o de la lectura; cede sola cuando el servicio vuelve. */
+    BlockedCategoryEnum["TEMPORARY"] = "TEMPORARY";
+})(BlockedCategoryEnum || (exports.BlockedCategoryEnum = BlockedCategoryEnum = {}));

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

@@ -0,0 +1,10 @@
+/**
+ * Por qué la venta está detenida esperando la cuenta PagoConFiado del comprador.
+ * SureKeep Fase 2 — pista Retail.
+ */
+export declare enum BlockedReasonEnum {
+    /** La cuenta se está abriendo: espera normal, mediana de 13 segundos. */
+    ACCOUNT_OPENING = "ACCOUNT_OPENING",
+    /** La cuenta no se pudo abrir: la venta se detiene hasta que se resuelva fuera del wizard. */
+    ACCOUNT_BLOCKED = "ACCOUNT_BLOCKED"
+}

package/bin/retailWizard/enums/BlockedReasonEnum.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlockedReasonEnum = void 0;
+/**
+ * Por qué la venta está detenida esperando la cuenta PagoConFiado del comprador.
+ * SureKeep Fase 2 — pista Retail.
+ */
+var BlockedReasonEnum;
+(function (BlockedReasonEnum) {
+    /** La cuenta se está abriendo: espera normal, mediana de 13 segundos. */
+    BlockedReasonEnum["ACCOUNT_OPENING"] = "ACCOUNT_OPENING";
+    /** La cuenta no se pudo abrir: la venta se detiene hasta que se resuelva fuera del wizard. */
+    BlockedReasonEnum["ACCOUNT_BLOCKED"] = "ACCOUNT_BLOCKED";
+})(BlockedReasonEnum || (exports.BlockedReasonEnum = BlockedReasonEnum = {}));

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

@@ -13,5 +13,7 @@ export declare enum ResumeReasonEnum {
     /** Falta la ocupación o el ingreso mensual. */
     PROFILE_PENDING = "PROFILE_PENDING",
     /** El expediente está completo y la cuenta todavía no abre. */
-    ACCOUNT_PENDING = "ACCOUNT_PENDING"
+    ACCOUNT_PENDING = "ACCOUNT_PENDING",
+    /** La apertura no prosperó: la venta está detenida hasta que alguien más la resuelva. */
+    ACCOUNT_BLOCKED = "ACCOUNT_BLOCKED"
 }

package/bin/retailWizard/enums/ResumeReasonEnum.js

@@ -18,4 +18,6 @@ var ResumeReasonEnum;
     ResumeReasonEnum["PROFILE_PENDING"] = "PROFILE_PENDING";
     /** El expediente está completo y la cuenta todavía no abre. */
     ResumeReasonEnum["ACCOUNT_PENDING"] = "ACCOUNT_PENDING";
+    /** La apertura no prosperó: la venta está detenida hasta que alguien más la resuelva. */
+    ResumeReasonEnum["ACCOUNT_BLOCKED"] = "ACCOUNT_BLOCKED";
 })(ResumeReasonEnum || (exports.ResumeReasonEnum = ResumeReasonEnum = {}));

package/bin/retailWizard/index.d.ts

@@ -19,6 +19,8 @@ export * from './enums/AccountStepStatusEnum';
 export * from './enums/ResumeReasonEnum';
 export * from './enums/AppOnboardingStepEnum';
 export * from './enums/AppOnboardingStepStatusEnum';
+export * from './enums/BlockedReasonEnum';
+export * from './enums/BlockedCategoryEnum';
 export * from './dtos/WizardConsents';
 export * from './dtos/WizardPayment';
 export * from './dtos/WizardProduct';
@@ -31,6 +33,7 @@ export * from './dtos/WizardCreditSummary';
 export * from './dtos/AccountStep';
 export * from './dtos/AppOnboardingStep';
 export * from './dtos/WizardResumeTarget';
+export * from './dtos/WizardBlocked';
 export * from './dtos/WizardSession';
 export * from './dtos/OtpVerification';
 export * from './dtos/Sale';

package/bin/retailWizard/index.js

@@ -37,6 +37,8 @@ __exportStar(require("./enums/AccountStepStatusEnum"), exports);
 __exportStar(require("./enums/ResumeReasonEnum"), exports);
 __exportStar(require("./enums/AppOnboardingStepEnum"), exports);
 __exportStar(require("./enums/AppOnboardingStepStatusEnum"), exports);
+__exportStar(require("./enums/BlockedReasonEnum"), exports);
+__exportStar(require("./enums/BlockedCategoryEnum"), exports);
 // DTOs anidados
 __exportStar(require("./dtos/WizardConsents"), exports);
 __exportStar(require("./dtos/WizardPayment"), exports);
@@ -50,6 +52,7 @@ __exportStar(require("./dtos/WizardCreditSummary"), exports);
 __exportStar(require("./dtos/AccountStep"), exports);
 __exportStar(require("./dtos/AppOnboardingStep"), exports);
 __exportStar(require("./dtos/WizardResumeTarget"), exports);
+__exportStar(require("./dtos/WizardBlocked"), exports);
 // Entidades principales (shapes de estado/persistencia — planas)
 __exportStar(require("./dtos/WizardSession"), exports);
 __exportStar(require("./dtos/OtpVerification"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.317.1",
+  "version": "3.318.0",
   "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';