@fiado/type-kit 3.311.0 → 3.314.0

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/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.314.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

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