@fiado/type-kit 3.310.1 → 3.314.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';
@@ -49,9 +52,7 @@ export * from './dtos/requests/DeleteProductRequest';
 export * from './dtos/requests/SetPaymentMethodRequest';
 export * from './dtos/requests/ExternalReferralRequest';
 export * from './dtos/requests/RegisterPaymentRequest';
-export * from './dtos/requests/CompleteSaleRequest';
 export * from './dtos/requests/AppInstallLinkRequest';
-export * from './dtos/requests/MarkPcfCardDeliveredRequest';
 export * from './dtos/requests/ConfirmAddressRequest';
 export * from './dtos/requests/ProfileQuestionsRequest';
 export * from './dtos/requests/SaveBeneficiaryRequest';
@@ -77,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);
@@ -71,9 +74,7 @@ __exportStar(require("./dtos/requests/DeleteProductRequest"), exports);
 __exportStar(require("./dtos/requests/SetPaymentMethodRequest"), exports);
 __exportStar(require("./dtos/requests/ExternalReferralRequest"), exports);
 __exportStar(require("./dtos/requests/RegisterPaymentRequest"), exports);
-__exportStar(require("./dtos/requests/CompleteSaleRequest"), exports);
 __exportStar(require("./dtos/requests/AppInstallLinkRequest"), exports);
-__exportStar(require("./dtos/requests/MarkPcfCardDeliveredRequest"), exports);
 __exportStar(require("./dtos/requests/ConfirmAddressRequest"), exports);
 __exportStar(require("./dtos/requests/ProfileQuestionsRequest"), exports);
 __exportStar(require("./dtos/requests/SaveBeneficiaryRequest"), exports);
@@ -100,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.310.1",
+  "version": "3.314.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

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

@@ -1,6 +1,9 @@
-import { ArrayMaxSize, IsArray, IsInt, IsOptional, IsString, Max, Min } from 'class-validator';
+import { IsInt, IsOptional, IsString, Max, Min } from 'class-validator';
 
-/** Body del registro (recepción) de un lote de tarjetas para una tienda. */
+/**
+ * Body del registro (recepción) de un lote de tarjetas para una tienda. Los sobres llegan sellados:
+ * el lote lleva cantidad, no números.
+ */
 export class RegisterCardBatchRequest {
     @IsString()
     storeId!: string;
@@ -8,12 +11,11 @@ export class RegisterCardBatchRequest {
     @IsInt()
     @Min(1)
     @Max(1000)
-    totalCards!: number;
+    quantity!: number;
 
-    @IsArray()
-    @ArrayMaxSize(1000)
-    @IsString({ each: true })
-    cardNumbers!: string[];
+    /** Folio de la remesa del proveedor: lo único que distingue dos entradas iguales a la misma tienda. */
+    @IsString()
+    supplierBatchRef!: string;
 
     @IsOptional()
     @IsString()

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

@@ -0,0 +1,21 @@
+import { IsOptional, IsString } from 'class-validator';
+
+/**
+ * Body de la entrega de una tarjeta física a un cliente. Descuenta el saldo de la tienda y asienta el
+ * movimiento en una sola operación: en mostrador asignar y entregar son el mismo acto.
+ */
+export class RegisterCardDeliveryRequest {
+    @IsString()
+    customerId!: string;
+
+    @IsString()
+    deliveredByUserId!: string;
+
+    /** Clave de idempotencia de la entrega: un reintento devuelve el `deliveryId` original. */
+    @IsString()
+    sessionId!: string;
+
+    @IsOptional()
+    @IsString()
+    creditId?: string;
+}

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

@@ -0,0 +1,14 @@
+import { IsString } from 'class-validator';
+
+/**
+ * Body del contraasiento que revierte un movimiento del libro mayor. No borra el asiento original:
+ * escribe uno nuevo que lo compensa.
+ */
+export class ReverseCardMovementRequest {
+    /** `sk` del asiento que se revierte (`MOV#<isoTs>#<uuid>`). */
+    @IsString()
+    movementSk!: string;
+
+    @IsString()
+    reason!: string;
+}

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

@@ -0,0 +1,16 @@
+import { IsEnum, IsInt, IsOptional, IsString, Min } from 'class-validator';
+import { CardWriteOffReasonEnum } from '../../enums/CardWriteOffReasonEnum';
+
+/** Body de la baja de inventario de tarjetas de una tienda, por cantidad. */
+export class WriteOffCardStockRequest {
+    @IsInt()
+    @Min(1)
+    quantity!: number;
+
+    @IsEnum(CardWriteOffReasonEnum)
+    reason!: CardWriteOffReasonEnum;
+
+    @IsOptional()
+    @IsString()
+    notes?: string | null;
+}

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

@@ -1,18 +1,15 @@
-import { CardBatchStatusEnum } from '../../enums/CardBatchStatusEnum';
-
-/** Representación de un lote de tarjetas hacia el cliente. */
+/**
+ * Lote de tarjetas recibido por una tienda (`sk = BATCH#<isoTs>#<uuid>`). Es un hecho histórico: el
+ * lote no cambia de estado ni lleva conteos, esos viven en el saldo.
+ */
 export interface CardBatchResponse {
-    batchId: string;
-    retailerId: string;
+    batchSk: string;
+    /** Folio de la remesa del proveedor. */
+    supplierBatchRef: string;
     storeId: string;
-    totalCards: number;
-    expectedCardCount: number;
-    loadedCount: number;
-    availableCount: number;
-    assignedCount: number;
-    cancelledCount: number;
-    status: CardBatchStatusEnum;
+    retailerId: string;
+    quantity: number;
+    notes: string | null;
     receivedAt: string;
     receivedByUserId: string;
-    notes: string | null;
 }

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

@@ -0,0 +1,11 @@
+/**
+ * Resultado de entregar una tarjeta física a un cliente. Un reintento con el mismo `sessionId`
+ * devuelve este mismo `deliveryId` con 200, no un error.
+ */
+export interface CardDeliveryResponse {
+    deliveryId: string;
+    movementSk: string;
+    /** Saldo disponible que quedó en la tienda después de descontar la entrega. */
+    availableAfter: number;
+    occurredAt: string;
+}

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

@@ -0,0 +1,13 @@
+/**
+ * Saldo vigente de tarjetas físicas de una tienda (`sk = BALANCE`). Es reconstruible sumando los
+ * asientos del libro mayor.
+ */
+export interface CardStockBalanceResponse {
+    storeId: string;
+    retailerId: string;
+    /** Unidades disponibles para entregar. Sin saldo no hay entrega. */
+    available: number;
+    deliveredTotal: number;
+    writtenOffTotal: number;
+    updatedAt: string;
+}

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

@@ -0,0 +1,20 @@
+import { CardStockMovementTypeEnum } from '../../enums/CardStockMovementTypeEnum';
+import { CardWriteOffReasonEnum } from '../../enums/CardWriteOffReasonEnum';
+
+/** Asiento del libro mayor de tarjetas de una tienda (`sk = MOV#<isoTs>#<uuid>`). */
+export interface CardStockMovementResponse {
+    movementSk: string;
+    type: CardStockMovementTypeEnum;
+    /** Con signo: positiva en las entradas, negativa en las salidas. */
+    quantity: number;
+    occurredAt: string;
+    actorUserId: string;
+    /** Cliente que recibió la tarjeta; solo en `OUT_DELIVERY`. */
+    customerId: string | null;
+    /** Motivo catalogado de la baja; solo en `OUT_WRITE_OFF`. */
+    reason: CardWriteOffReasonEnum | null;
+    /** Explicación libre del contraasiento; solo en `REVERSAL`. */
+    reversalReason: string | null;
+    /** `sk` referenciado: el lote en `IN_BATCH`, el asiento revertido en `REVERSAL`. */
+    refSk: string | null;
+}

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

@@ -0,0 +1,13 @@
+import { CardStockBalanceResponse } from './CardStockBalanceResponse';
+import { CardStockMovementResponse } from './CardStockMovementResponse';
+
+/**
+ * Pantalla de inventario de una tienda: el saldo vigente más una página de asientos. Ambos salen de
+ * la misma partición, así que viajan en una sola respuesta.
+ */
+export interface CardStockResponse {
+    balance: CardStockBalanceResponse;
+    movements: CardStockMovementResponse[];
+    count: number;
+    nextToken?: string;
+}

package/src/retailCards/enums/CardStockMovementTypeEnum.ts

@@ -0,0 +1,15 @@
+/**
+ * Tipo de asiento del libro mayor de tarjetas físicas (`sk = MOV#<isoTs>#<uuid>`).
+ * @enum {string}
+ *
+ * @property {string} IN_BATCH - Entrada por recepción de un lote del proveedor (cantidad positiva).
+ * @property {string} OUT_DELIVERY - Salida por entrega de una tarjeta a un cliente en mostrador.
+ * @property {string} OUT_WRITE_OFF - Salida por baja de inventario (plástico dañado, extravío, robo).
+ * @property {string} REVERSAL - Contraasiento que revierte un movimiento previo vía `refSk`.
+ */
+export enum CardStockMovementTypeEnum {
+    IN_BATCH = 'IN_BATCH',
+    OUT_DELIVERY = 'OUT_DELIVERY',
+    OUT_WRITE_OFF = 'OUT_WRITE_OFF',
+    REVERSAL = 'REVERSAL',
+}

package/src/retailCards/enums/CardWriteOffReasonEnum.ts

@@ -0,0 +1,13 @@
+/**
+ * Motivo de una baja de inventario de tarjetas físicas por cantidad.
+ * @enum {string}
+ *
+ * @property {string} PLASTIC_DAMAGED - Plásticos dañados, inservibles para entregar.
+ * @property {string} LOST - Unidades extraviadas en la tienda.
+ * @property {string} STOLEN - Unidades robadas del inventario de la tienda.
+ */
+export enum CardWriteOffReasonEnum {
+    PLASTIC_DAMAGED = 'PLASTIC_DAMAGED',
+    LOST = 'LOST',
+    STOLEN = 'STOLEN',
+}

package/src/retailCards/events/CardBatchReceivedV1.ts

@@ -1,9 +1,11 @@
-/** Emitido cuando un lote de tarjetas se recibe (RECEIVED). */
+/** Emitido cuando una tienda recibe un lote de tarjetas físicas. */
 export interface CardBatchReceivedV1 {
-    batchId: string;
+    /** `sk` del lote en la partición de la tienda (`BATCH#<isoTs>#<uuid>`). */
+    batchSk: string;
+    supplierBatchRef: string;
     retailerId: string;
     storeId: string;
-    totalCards: number;
+    quantity: number;
     receivedByUserId: string;
     occurredAt: string;
 }

package/src/retailCards/index.ts

@@ -1,20 +1,20 @@
-export * from './enums/RetailCardStatusEnum';
-export * from './enums/CardBatchStatusEnum';
-export * from './enums/CardCancelReasonEnum';
+export * from './enums/CardStockMovementTypeEnum';
+export * from './enums/CardWriteOffReasonEnum';
 
 // Request DTOs (input validado por endpoint)
 export * from './dtos/requests/RegisterCardBatchRequest';
-export * from './dtos/requests/CancelCardRequest';
-export * from './dtos/requests/AssignCardRequest';
+export * from './dtos/requests/RegisterCardDeliveryRequest';
+export * from './dtos/requests/WriteOffCardStockRequest';
+export * from './dtos/requests/ReverseCardMovementRequest';
 
 // Response DTOs
 export * from './dtos/responses/CardBatchResponse';
-export * from './dtos/responses/RetailCardResponse';
+export * from './dtos/responses/CardDeliveryResponse';
+export * from './dtos/responses/CardStockBalanceResponse';
+export * from './dtos/responses/CardStockMovementResponse';
+export * from './dtos/responses/CardStockResponse';
 export * from './dtos/responses/StockAlertItem';
 export * from './dtos/responses/StockAlertsResponse';
 
 // Contratos de eventos (PascalCase + sufijo V1)
 export * from './events/CardBatchReceivedV1';
-export * from './events/RetailCardAssignedV1';
-export * from './events/RetailCardReleasedV1';
-export * from './events/RetailCardCancelledV1';

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/Sale.ts

@@ -43,7 +43,8 @@ export interface Sale {
   folio: string;
   paymentDetail: SalePaymentDetail | null;
   soldAt: string;
-  cardNumberDelivered: string | null;
+  /** Puntero a la entrega de la tarjeta física en `retail-cards-business`. */
+  cardDeliveryId: string | null;
   centralSyncStatus: CentralSyncStatusEnum;
   centralTag: string | null;
   status: SaleStatusEnum;

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)
@@ -60,9 +63,7 @@ export * from './dtos/requests/DeleteProductRequest';
 export * from './dtos/requests/SetPaymentMethodRequest';
 export * from './dtos/requests/ExternalReferralRequest';
 export * from './dtos/requests/RegisterPaymentRequest';
-export * from './dtos/requests/CompleteSaleRequest';
 export * from './dtos/requests/AppInstallLinkRequest';
-export * from './dtos/requests/MarkPcfCardDeliveredRequest';
 export * from './dtos/requests/ConfirmAddressRequest';
 export * from './dtos/requests/ProfileQuestionsRequest';
 export * from './dtos/requests/SaveBeneficiaryRequest';
@@ -90,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

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

@@ -1,6 +0,0 @@
-/** Body de la asignación de una tarjeta física a un cliente. */
-export declare class AssignCardRequest {
-    assignedToCustomerId: string;
-    assignedByUserId: string;
-    creditId?: string;
-}

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

@@ -1,5 +0,0 @@
-import { CardCancelReasonEnum } from '../../enums/CardCancelReasonEnum';
-/** Body de la cancelación (anulación) de una tarjeta física. */
-export declare class CancelCardRequest {
-    reason: CardCancelReasonEnum;
-}

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

@@ -1,22 +0,0 @@
-"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.CancelCardRequest = void 0;
-const class_validator_1 = require("class-validator");
-const CardCancelReasonEnum_1 = require("../../enums/CardCancelReasonEnum");
-/** Body de la cancelación (anulación) de una tarjeta física. */
-class CancelCardRequest {
-}
-exports.CancelCardRequest = CancelCardRequest;
-__decorate([
-    (0, class_validator_1.IsEnum)(CardCancelReasonEnum_1.CardCancelReasonEnum),
-    __metadata("design:type", String)
-], CancelCardRequest.prototype, "reason", void 0);