@fiado/type-kit 3.311.0 → 3.315.0

package/_test_/unit/retailCards/cardStockRequests.test.ts

@@ -30,6 +30,29 @@ describe('RegisterCardBatchRequest — el lote se recibe por cantidad, no por n
         ).toContain('supplierBatchRef');
     });
 
+    it('rechaza un folio en blanco: degradaría la clave del marcador a una constante por tienda', () => {
+        for (const supplierBatchRef of ['', '   ']) {
+            expect(
+                errorsOf(RegisterCardBatchRequest, {
+                    storeId: 'STORE#1',
+                    quantity: 50,
+                    supplierBatchRef,
+                }),
+            ).toContain('supplierBatchRef');
+        }
+    });
+
+    // El folio es la clave de idempotencia: sin recortar, reteclearlo con un espacio de más registra
+    // el mismo lote dos veces y suma el stock doble.
+    it('recorta los espacios del folio antes de que llegue al dominio', () => {
+        const dto = plainToInstance(RegisterCardBatchRequest, {
+            storeId: 'STORE#1',
+            quantity: 50,
+            supplierBatchRef: '  L-4471 ',
+        });
+        expect(dto.supplierBatchRef).toBe('L-4471');
+    });
+
     it('rechaza una cantidad de 0, negativa o fraccionaria', () => {
         for (const quantity of [0, -1, 1.5]) {
             expect(
@@ -103,18 +126,44 @@ describe('RegisterCardDeliveryRequest — entrega en un solo acto, idempotente p
 });
 
 describe('WriteOffCardStockRequest — baja de inventario por cantidad', () => {
-    it('acepta cantidad + motivo del catálogo', () => {
+    const OPERATION_ID = '3f1a9c52-8d0e-4b7a-9c31-6ad2f0e15b74';
+
+    it('acepta cantidad + motivo del catálogo + clave de operación', () => {
         expect(
             errorsOf(WriteOffCardStockRequest, {
                 quantity: 3,
                 reason: CardWriteOffReasonEnum.PLASTIC_DAMAGED,
+                operationId: OPERATION_ID,
             }),
         ).toEqual([]);
     });
 
+    it('la clave de operación es obligatoria: sin ella un doble clic descuenta dos veces', () => {
+        expect(
+            errorsOf(WriteOffCardStockRequest, {
+                quantity: 3,
+                reason: CardWriteOffReasonEnum.LOST,
+            }),
+        ).toContain('operationId');
+    });
+
+    it('rechaza una clave de operación que no sea un UUID', () => {
+        expect(
+            errorsOf(WriteOffCardStockRequest, {
+                quantity: 3,
+                reason: CardWriteOffReasonEnum.LOST,
+                operationId: 'baja-del-martes',
+            }),
+        ).toContain('operationId');
+    });
+
     it('rechaza un motivo fuera del catálogo', () => {
         expect(
-            errorsOf(WriteOffCardStockRequest, { quantity: 3, reason: 'THEFT_REPORTED' }),
+            errorsOf(WriteOffCardStockRequest, {
+                quantity: 3,
+                reason: 'THEFT_REPORTED',
+                operationId: OPERATION_ID,
+            }),
         ).toContain('reason');
     });
 
@@ -124,6 +173,7 @@ describe('WriteOffCardStockRequest — baja de inventario por cantidad', () => {
                 errorsOf(WriteOffCardStockRequest, {
                     quantity,
                     reason: CardWriteOffReasonEnum.LOST,
+                    operationId: OPERATION_ID,
                 }),
             ).toContain('quantity');
         }

package/_test_/unit/retailWizard/deleteProductRequest.test.ts

@@ -0,0 +1,24 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import { DeleteProductRequest } from '../../../src/retailWizard/dtos/requests/DeleteProductRequest';
+
+function errorsOf(payload: Record<string, unknown>): string[] {
+  const dto = plainToInstance(DeleteProductRequest, payload, { excludeExtraneousValues: true });
+  return validateSync(dto).map((e) => e.property);
+}
+
+describe('DeleteProductRequest — liberar el equipo no exige el imei', () => {
+  // Un caller que no manda `imei` produce `{}` al serializar: el silo debe atenderlo igual.
+  it('acepta un request sin imei', () => {
+    expect(errorsOf({})).toEqual([]);
+  });
+
+  it('acepta un request con imei explícito', () => {
+    expect(errorsOf({ imei: '356938035643809' })).toEqual([]);
+  });
+
+  it('rechaza un imei que no es string', () => {
+    expect(errorsOf({ imei: 356938035643809 })).toContain('imei');
+  });
+});

package/bin/retailCards/dtos/requests/RegisterCardBatchRequest.d.ts

@@ -5,7 +5,10 @@
 export declare class RegisterCardBatchRequest {
     storeId: string;
     quantity: number;
-    /** Folio de la remesa del proveedor: lo único que distingue dos entradas iguales a la misma tienda. */
+    /**
+     * Folio de la remesa del proveedor: lo único que distingue dos entradas iguales a la misma tienda.
+     * Se recorta y no admite blanco, porque es la clave de idempotencia de la recepción.
+     */
     supplierBatchRef: string;
     notes?: string | null;
 }

package/bin/retailCards/dtos/requests/RegisterCardBatchRequest.js

@@ -10,6 +10,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RegisterCardBatchRequest = void 0;
+const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 /**
  * Body del registro (recepción) de un lote de tarjetas para una tienda. Los sobres llegan sellados:
@@ -30,6 +31,8 @@ __decorate([
 ], RegisterCardBatchRequest.prototype, "quantity", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
+    (0, class_transformer_1.Transform)(({ value }) => (typeof value === 'string' ? value.trim() : value)),
+    (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], RegisterCardBatchRequest.prototype, "supplierBatchRef", void 0);
 __decorate([

package/bin/retailCards/dtos/requests/WriteOffCardStockRequest.d.ts

@@ -3,5 +3,10 @@ import { CardWriteOffReasonEnum } from '../../enums/CardWriteOffReasonEnum';
 export declare class WriteOffCardStockRequest {
     quantity: number;
     reason: CardWriteOffReasonEnum;
+    /**
+     * Clave de idempotencia de la baja, generada por el caller una vez por intento. Un reintento
+     * devuelve el asiento original: sin ella un doble clic descontaría el doble.
+     */
+    operationId: string;
     notes?: string | null;
 }

package/bin/retailCards/dtos/requests/WriteOffCardStockRequest.js

@@ -25,6 +25,10 @@ __decorate([
     (0, class_validator_1.IsEnum)(CardWriteOffReasonEnum_1.CardWriteOffReasonEnum),
     __metadata("design:type", String)
 ], WriteOffCardStockRequest.prototype, "reason", void 0);
+__decorate([
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], WriteOffCardStockRequest.prototype, "operationId", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),

package/bin/retailCards/dtos/responses/CardDeliveryResponse.d.ts

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

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

@@ -0,0 +1,11 @@
+import { AppOnboardingStepEnum } from '../enums/AppOnboardingStepEnum';
+import { AppOnboardingStepStatusEnum } from '../enums/AppOnboardingStepStatusEnum';
+/**
+ * Una condición del onboarding en la app con su estado. SureKeep Fase 2 — pista Retail.
+ */
+export interface AppOnboardingStep {
+    step: AppOnboardingStepEnum;
+    status: AppOnboardingStepStatusEnum;
+    /** Por qué no se pudo verificar. Solo viaja con `UNVERIFIABLE`. */
+    reason?: string;
+}

package/bin/retailWizard/dtos/AppOnboardingStep.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,4 +1,5 @@
 /** DELETE /wizard/sessions/:id/product — libera la reserva del equipo (vuelve al catálogo). SureKeep Fase 2 — pista Retail. */
 export declare class DeleteProductRequest {
-    imei: string;
+    /** Opcional a propósito: exigirlo rompe a los callers que liberan la reserva sin mandar el imei. */
+    imei?: string;
 }

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

@@ -18,6 +18,7 @@ class DeleteProductRequest {
 exports.DeleteProductRequest = DeleteProductRequest;
 __decorate([
     (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], DeleteProductRequest.prototype, "imei", void 0);

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

@@ -0,0 +1,21 @@
+import type { WizardStateEnum } from '../../enums/WizardStateEnum';
+import type { WizardStepEnum } from '../../enums/WizardStepEnum';
+/**
+ * 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.
+ *
+ * `found: false` es la respuesta NORMAL: la mayoria de los prospectos no tienen venta empezada, y una
+ * sesion activa de OTRA tienda devuelve lo mismo (DEC-018 la trata como inexistente para el vendedor).
+ *
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface ActiveSessionByPhoneResponse {
+    /** Unico campo con el que el front decide si pinta el paso o un guion. */
+    found: boolean;
+    /** `null` cuando `found` es `false`. */
+    sessionId: string | null;
+    /** Paso en el que se quedo la venta. `null` cuando `found` es `false`. */
+    currentStep: WizardStepEnum | null;
+    /** Hoy siempre `ACTIVE`: la busqueda filtra por ese estado. `null` cuando `found` es `false`. */
+    state: WizardStateEnum | null;
+}

package/bin/retailWizard/dtos/responses/ActiveSessionByPhoneResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,14 @@
+import { AppOnboardingStep } from '../AppOnboardingStep';
+/**
+ * GET /wizard/sessions/:id/app-onboarding — las condiciones del onboarding que el cliente hace en
+ * la app Fiado.
+ *
+ * Lo pollea el paso 09 del wizard, que dejó de pedirle al vendedor que teclee el número de tarjeta.
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface AppOnboardingResponse {
+    /** Las cuatro condiciones, siempre las cuatro, en orden fijo. */
+    steps: AppOnboardingStep[];
+    /** Ninguna quedó en `PENDING`. Una `UNVERIFIABLE` NO bloquea: cuenta como saldada. */
+    allSettled: boolean;
+}

package/bin/retailWizard/dtos/responses/AppOnboardingResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,14 @@
+/**
+ * Condiciones del onboarding que el cliente hace en la app Fiado, y que el paso 09 del wizard
+ * pollea en vez de pedirle al vendedor que las teclee. SureKeep Fase 2 — pista Retail.
+ */
+export declare enum AppOnboardingStepEnum {
+    /** Ya puso su contraseña sobre la cuenta que abrió la tienda. */
+    PASSWORD = "PASSWORD",
+    /** Ya firmó el contrato MX. */
+    CONTRACT_SIGNED = "CONTRACT_SIGNED",
+    /** Ya activó su número secreto de la app (2FA/transacciones, NO el NIP de la tarjeta). */
+    SECRET_NUMBER = "SECRET_NUMBER",
+    /** Ya tiene una tarjeta física vigente. */
+    PHYSICAL_CARD = "PHYSICAL_CARD"
+}

package/bin/retailWizard/enums/AppOnboardingStepEnum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppOnboardingStepEnum = void 0;
+/**
+ * Condiciones del onboarding que el cliente hace en la app Fiado, y que el paso 09 del wizard
+ * pollea en vez de pedirle al vendedor que las teclee. SureKeep Fase 2 — pista Retail.
+ */
+var AppOnboardingStepEnum;
+(function (AppOnboardingStepEnum) {
+    /** Ya puso su contraseña sobre la cuenta que abrió la tienda. */
+    AppOnboardingStepEnum["PASSWORD"] = "PASSWORD";
+    /** Ya firmó el contrato MX. */
+    AppOnboardingStepEnum["CONTRACT_SIGNED"] = "CONTRACT_SIGNED";
+    /** Ya activó su número secreto de la app (2FA/transacciones, NO el NIP de la tarjeta). */
+    AppOnboardingStepEnum["SECRET_NUMBER"] = "SECRET_NUMBER";
+    /** Ya tiene una tarjeta física vigente. */
+    AppOnboardingStepEnum["PHYSICAL_CARD"] = "PHYSICAL_CARD";
+})(AppOnboardingStepEnum || (exports.AppOnboardingStepEnum = AppOnboardingStepEnum = {}));

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

@@ -0,0 +1,12 @@
+/**
+ * Estado de una condición del onboarding en la app. SureKeep Fase 2 — pista Retail.
+ *
+ * `UNVERIFIABLE` existe para no aplastar «no cumplió» contra «no pudimos saber»: un booleano le
+ * mostraría al vendedor la palomita apagada de un cliente que sí lo hizo, cuando lo que se cayó es
+ * un lambda nuestro. NO bloquea: cuenta como saldada.
+ */
+export declare enum AppOnboardingStepStatusEnum {
+    COMPLETED = "COMPLETED",
+    PENDING = "PENDING",
+    UNVERIFIABLE = "UNVERIFIABLE"
+}

package/bin/retailWizard/enums/AppOnboardingStepStatusEnum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppOnboardingStepStatusEnum = void 0;
+/**
+ * Estado de una condición del onboarding en la app. SureKeep Fase 2 — pista Retail.
+ *
+ * `UNVERIFIABLE` existe para no aplastar «no cumplió» contra «no pudimos saber»: un booleano le
+ * mostraría al vendedor la palomita apagada de un cliente que sí lo hizo, cuando lo que se cayó es
+ * un lambda nuestro. NO bloquea: cuenta como saldada.
+ */
+var AppOnboardingStepStatusEnum;
+(function (AppOnboardingStepStatusEnum) {
+    AppOnboardingStepStatusEnum["COMPLETED"] = "COMPLETED";
+    AppOnboardingStepStatusEnum["PENDING"] = "PENDING";
+    AppOnboardingStepStatusEnum["UNVERIFIABLE"] = "UNVERIFIABLE";
+})(AppOnboardingStepStatusEnum || (exports.AppOnboardingStepStatusEnum = AppOnboardingStepStatusEnum = {}));

package/bin/retailWizard/index.d.ts

@@ -17,6 +17,8 @@ export * from './enums/AccountVerdictEnum';
 export * from './enums/AccountOutcomeEnum';
 export * from './enums/AccountStepStatusEnum';
 export * from './enums/ResumeReasonEnum';
+export * from './enums/AppOnboardingStepEnum';
+export * from './enums/AppOnboardingStepStatusEnum';
 export * from './dtos/WizardConsents';
 export * from './dtos/WizardPayment';
 export * from './dtos/WizardProduct';
@@ -27,6 +29,7 @@ export * from './dtos/WizardBeneficiary';
 export * from './dtos/WizardLoan';
 export * from './dtos/WizardCreditSummary';
 export * from './dtos/AccountStep';
+export * from './dtos/AppOnboardingStep';
 export * from './dtos/WizardResumeTarget';
 export * from './dtos/WizardSession';
 export * from './dtos/OtpVerification';
@@ -75,6 +78,8 @@ export * from './dtos/responses/SignatureSendOtpResponse';
 export * from './dtos/responses/SignatureSignResponse';
 export * from './dtos/responses/RegisterDeviceResponse';
 export * from './dtos/responses/AccountStatusResponse';
+export * from './dtos/responses/ActiveSessionByPhoneResponse';
+export * from './dtos/responses/AppOnboardingResponse';
 export * from './enums/SaleFinancierEnum';
 export * from './enums/SaleExceptionTypeEnum';
 export * from './enums/SaleExceptionStatusEnum';

package/bin/retailWizard/index.js

@@ -35,6 +35,8 @@ __exportStar(require("./enums/AccountVerdictEnum"), exports);
 __exportStar(require("./enums/AccountOutcomeEnum"), exports);
 __exportStar(require("./enums/AccountStepStatusEnum"), exports);
 __exportStar(require("./enums/ResumeReasonEnum"), exports);
+__exportStar(require("./enums/AppOnboardingStepEnum"), exports);
+__exportStar(require("./enums/AppOnboardingStepStatusEnum"), exports);
 // DTOs anidados
 __exportStar(require("./dtos/WizardConsents"), exports);
 __exportStar(require("./dtos/WizardPayment"), exports);
@@ -46,6 +48,7 @@ __exportStar(require("./dtos/WizardBeneficiary"), exports);
 __exportStar(require("./dtos/WizardLoan"), exports);
 __exportStar(require("./dtos/WizardCreditSummary"), exports);
 __exportStar(require("./dtos/AccountStep"), exports);
+__exportStar(require("./dtos/AppOnboardingStep"), exports);
 __exportStar(require("./dtos/WizardResumeTarget"), exports);
 // Entidades principales (shapes de estado/persistencia — planas)
 __exportStar(require("./dtos/WizardSession"), exports);
@@ -98,6 +101,8 @@ __exportStar(require("./dtos/responses/SignatureSendOtpResponse"), exports);
 __exportStar(require("./dtos/responses/SignatureSignResponse"), exports);
 __exportStar(require("./dtos/responses/RegisterDeviceResponse"), exports);
 __exportStar(require("./dtos/responses/AccountStatusResponse"), exports);
+__exportStar(require("./dtos/responses/ActiveSessionByPhoneResponse"), exports);
+__exportStar(require("./dtos/responses/AppOnboardingResponse"), exports);
 // ── F3 · Backoffice VentasLuga ────────────────────────────────────────────────
 // Enums
 __exportStar(require("./enums/SaleFinancierEnum"), exports);

package/package.json

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

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

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

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

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

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

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

package/src/retailWizard/dtos/AppOnboardingStep.ts

@@ -0,0 +1,12 @@
+import { AppOnboardingStepEnum } from '../enums/AppOnboardingStepEnum';
+import { AppOnboardingStepStatusEnum } from '../enums/AppOnboardingStepStatusEnum';
+
+/**
+ * Una condición del onboarding en la app con su estado. SureKeep Fase 2 — pista Retail.
+ */
+export interface AppOnboardingStep {
+    step: AppOnboardingStepEnum;
+    status: AppOnboardingStepStatusEnum;
+    /** Por qué no se pudo verificar. Solo viaja con `UNVERIFIABLE`. */
+    reason?: string;
+}

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

@@ -1,9 +1,11 @@
 import { Expose } from 'class-transformer';
-import { IsString } from 'class-validator';
+import { IsOptional, IsString } from 'class-validator';
 
 /** DELETE /wizard/sessions/:id/product — libera la reserva del equipo (vuelve al catálogo). SureKeep Fase 2 — pista Retail. */
 export class DeleteProductRequest {
+  /** Opcional a propósito: exigirlo rompe a los callers que liberan la reserva sin mandar el imei. */
   @Expose()
+  @IsOptional()
   @IsString()
-  imei!: string;
+  imei?: string;
 }

package/src/retailWizard/dtos/responses/ActiveSessionByPhoneResponse.ts

@@ -0,0 +1,22 @@
+import type { WizardStateEnum } from '../../enums/WizardStateEnum';
+import type { WizardStepEnum } from '../../enums/WizardStepEnum';
+
+/**
+ * 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.
+ *
+ * `found: false` es la respuesta NORMAL: la mayoria de los prospectos no tienen venta empezada, y una
+ * sesion activa de OTRA tienda devuelve lo mismo (DEC-018 la trata como inexistente para el vendedor).
+ *
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface ActiveSessionByPhoneResponse {
+    /** Unico campo con el que el front decide si pinta el paso o un guion. */
+    found: boolean;
+    /** `null` cuando `found` es `false`. */
+    sessionId: string | null;
+    /** Paso en el que se quedo la venta. `null` cuando `found` es `false`. */
+    currentStep: WizardStepEnum | null;
+    /** Hoy siempre `ACTIVE`: la busqueda filtra por ese estado. `null` cuando `found` es `false`. */
+    state: WizardStateEnum | null;
+}

package/src/retailWizard/dtos/responses/AppOnboardingResponse.ts

@@ -0,0 +1,15 @@
+import { AppOnboardingStep } from '../AppOnboardingStep';
+
+/**
+ * GET /wizard/sessions/:id/app-onboarding — las condiciones del onboarding que el cliente hace en
+ * la app Fiado.
+ *
+ * Lo pollea el paso 09 del wizard, que dejó de pedirle al vendedor que teclee el número de tarjeta.
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface AppOnboardingResponse {
+    /** Las cuatro condiciones, siempre las cuatro, en orden fijo. */
+    steps: AppOnboardingStep[];
+    /** Ninguna quedó en `PENDING`. Una `UNVERIFIABLE` NO bloquea: cuenta como saldada. */
+    allSettled: boolean;
+}

package/src/retailWizard/enums/AppOnboardingStepEnum.ts

@@ -0,0 +1,14 @@
+/**
+ * Condiciones del onboarding que el cliente hace en la app Fiado, y que el paso 09 del wizard
+ * pollea en vez de pedirle al vendedor que las teclee. SureKeep Fase 2 — pista Retail.
+ */
+export enum AppOnboardingStepEnum {
+    /** Ya puso su contraseña sobre la cuenta que abrió la tienda. */
+    PASSWORD = 'PASSWORD',
+    /** Ya firmó el contrato MX. */
+    CONTRACT_SIGNED = 'CONTRACT_SIGNED',
+    /** Ya activó su número secreto de la app (2FA/transacciones, NO el NIP de la tarjeta). */
+    SECRET_NUMBER = 'SECRET_NUMBER',
+    /** Ya tiene una tarjeta física vigente. */
+    PHYSICAL_CARD = 'PHYSICAL_CARD',
+}

package/src/retailWizard/enums/AppOnboardingStepStatusEnum.ts

@@ -0,0 +1,12 @@
+/**
+ * Estado de una condición del onboarding en la app. SureKeep Fase 2 — pista Retail.
+ *
+ * `UNVERIFIABLE` existe para no aplastar «no cumplió» contra «no pudimos saber»: un booleano le
+ * mostraría al vendedor la palomita apagada de un cliente que sí lo hizo, cuando lo que se cayó es
+ * un lambda nuestro. NO bloquea: cuenta como saldada.
+ */
+export enum AppOnboardingStepStatusEnum {
+    COMPLETED = 'COMPLETED',
+    PENDING = 'PENDING',
+    UNVERIFIABLE = 'UNVERIFIABLE',
+}

package/src/retailWizard/index.ts

@@ -20,6 +20,8 @@ export * from './enums/AccountVerdictEnum';
 export * from './enums/AccountOutcomeEnum';
 export * from './enums/AccountStepStatusEnum';
 export * from './enums/ResumeReasonEnum';
+export * from './enums/AppOnboardingStepEnum';
+export * from './enums/AppOnboardingStepStatusEnum';
 
 // DTOs anidados
 export * from './dtos/WizardConsents';
@@ -32,6 +34,7 @@ export * from './dtos/WizardBeneficiary';
 export * from './dtos/WizardLoan';
 export * from './dtos/WizardCreditSummary';
 export * from './dtos/AccountStep';
+export * from './dtos/AppOnboardingStep';
 export * from './dtos/WizardResumeTarget';
 
 // Entidades principales (shapes de estado/persistencia — planas)
@@ -88,6 +91,8 @@ export * from './dtos/responses/SignatureSendOtpResponse';
 export * from './dtos/responses/SignatureSignResponse';
 export * from './dtos/responses/RegisterDeviceResponse';
 export * from './dtos/responses/AccountStatusResponse';
+export * from './dtos/responses/ActiveSessionByPhoneResponse';
+export * from './dtos/responses/AppOnboardingResponse';
 
 // ── F3 · Backoffice VentasLuga ────────────────────────────────────────────────
 // Enums