@fiado/type-kit 3.303.0 → 3.304.0

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

@@ -0,0 +1,11 @@
+import type { ResumeReasonEnum } from '../enums/ResumeReasonEnum';
+import type { WizardStepEnum } from '../enums/WizardStepEnum';
+/**
+ * A qué paso aterriza el comprador al reanudar una venta a medias, y por qué. Lo calcula el silo:
+ * es regla de negocio y el front solo navega a lo que le digan.
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface WizardResumeTarget {
+    step: WizardStepEnum;
+    reason: ResumeReasonEnum;
+}

package/bin/retailWizard/dtos/WizardResumeTarget.js

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

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

@@ -8,6 +8,7 @@ import type { WizardConsents } from './WizardConsents';
 import type { WizardLoan } from './WizardLoan';
 import type { WizardPayment } from './WizardPayment';
 import type { WizardProduct } from './WizardProduct';
+import type { WizardResumeTarget } from './WizardResumeTarget';
 import type { WizardWelcome } from './WizardWelcome';
 /** Modalidad de captura del KYC (M1 §213-329). */
 export type KycModality = 'CUSTOMER_LINK' | 'STORE_DEVICE' | 'MANUAL';
@@ -43,6 +44,20 @@ export interface WizardSession {
     state: WizardStateEnum;
     otpVerified: boolean;
     otpSkipped: boolean;
+    /**
+     * Hay una reanudación esperando su OTP. Retomar una venta a medias pide la prueba del teléfono de
+     * nuevo, aunque `otpVerified` ya esté en `true` de la vez anterior — por eso son campos distintos.
+     *
+     * Opcional: es aditivo sobre un contrato ya publicado. Ausente = no hay reanudación en curso.
+     */
+    resumeOtpRequired?: boolean;
+    /**
+     * Primer hueco del onboarding: a qué paso aterriza el comprador al reanudar, y por qué. Lo calcula
+     * el silo — es regla de negocio, no navegación.
+     *
+     * Opcional por lo mismo que `resumeOtpRequired`: un consumidor que no lo conoce sigue igual.
+     */
+    resumeTarget?: WizardResumeTarget | null;
     consents: WizardConsents | null;
     /** Espejo del estado KYC (fuente = customer). */
     kycStatus: string | null;

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

@@ -0,0 +1,17 @@
+/**
+ * Por qué el wizard manda al comprador a ese paso al reanudar una venta a medias. El silo busca el
+ * PRIMER hueco del onboarding de arriba hacia abajo: cuenta → KYC → domicilio → preguntas.
+ * SureKeep Fase 2 — pista Retail.
+ */
+export declare enum ResumeReasonEnum {
+    /** La cuenta PagoConFiado ya está lista: no falta nada del onboarding, se vuelve al paso donde quedó. */
+    ACCOUNT_READY = "ACCOUNT_READY",
+    /** El KYC no cerró verificado: se rehace desde el principio. */
+    KYC_PENDING = "KYC_PENDING",
+    /** El expediente quedó sin domicilio: toca el comprobante. */
+    ADDRESS_PENDING = "ADDRESS_PENDING",
+    /** 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"
+}

package/bin/retailWizard/enums/ResumeReasonEnum.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResumeReasonEnum = void 0;
+/**
+ * Por qué el wizard manda al comprador a ese paso al reanudar una venta a medias. El silo busca el
+ * PRIMER hueco del onboarding de arriba hacia abajo: cuenta → KYC → domicilio → preguntas.
+ * SureKeep Fase 2 — pista Retail.
+ */
+var ResumeReasonEnum;
+(function (ResumeReasonEnum) {
+    /** La cuenta PagoConFiado ya está lista: no falta nada del onboarding, se vuelve al paso donde quedó. */
+    ResumeReasonEnum["ACCOUNT_READY"] = "ACCOUNT_READY";
+    /** El KYC no cerró verificado: se rehace desde el principio. */
+    ResumeReasonEnum["KYC_PENDING"] = "KYC_PENDING";
+    /** El expediente quedó sin domicilio: toca el comprobante. */
+    ResumeReasonEnum["ADDRESS_PENDING"] = "ADDRESS_PENDING";
+    /** Falta la ocupación o el ingreso mensual. */
+    ResumeReasonEnum["PROFILE_PENDING"] = "PROFILE_PENDING";
+    /** El expediente está completo y la cuenta todavía no abre. */
+    ResumeReasonEnum["ACCOUNT_PENDING"] = "ACCOUNT_PENDING";
+})(ResumeReasonEnum || (exports.ResumeReasonEnum = ResumeReasonEnum = {}));

package/bin/retailWizard/index.d.ts

@@ -16,6 +16,7 @@ export * from './enums/BeneficiaryRelationEnum';
 export * from './enums/AccountVerdictEnum';
 export * from './enums/AccountOutcomeEnum';
 export * from './enums/AccountStepStatusEnum';
+export * from './enums/ResumeReasonEnum';
 export * from './dtos/WizardConsents';
 export * from './dtos/WizardPayment';
 export * from './dtos/WizardProduct';
@@ -26,6 +27,7 @@ export * from './dtos/WizardBeneficiary';
 export * from './dtos/WizardLoan';
 export * from './dtos/WizardCreditSummary';
 export * from './dtos/AccountStep';
+export * from './dtos/WizardResumeTarget';
 export * from './dtos/WizardSession';
 export * from './dtos/OtpVerification';
 export * from './dtos/Sale';

package/bin/retailWizard/index.js

@@ -34,6 +34,7 @@ __exportStar(require("./enums/BeneficiaryRelationEnum"), exports);
 __exportStar(require("./enums/AccountVerdictEnum"), exports);
 __exportStar(require("./enums/AccountOutcomeEnum"), exports);
 __exportStar(require("./enums/AccountStepStatusEnum"), exports);
+__exportStar(require("./enums/ResumeReasonEnum"), exports);
 // DTOs anidados
 __exportStar(require("./dtos/WizardConsents"), exports);
 __exportStar(require("./dtos/WizardPayment"), exports);
@@ -45,6 +46,7 @@ __exportStar(require("./dtos/WizardBeneficiary"), exports);
 __exportStar(require("./dtos/WizardLoan"), exports);
 __exportStar(require("./dtos/WizardCreditSummary"), exports);
 __exportStar(require("./dtos/AccountStep"), exports);
+__exportStar(require("./dtos/WizardResumeTarget"), 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.303.0",
+  "version": "3.304.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/retailWizard/dtos/WizardResumeTarget.ts

@@ -0,0 +1,12 @@
+import type { ResumeReasonEnum } from '../enums/ResumeReasonEnum';
+import type { WizardStepEnum } from '../enums/WizardStepEnum';
+
+/**
+ * A qué paso aterriza el comprador al reanudar una venta a medias, y por qué. Lo calcula el silo:
+ * es regla de negocio y el front solo navega a lo que le digan.
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface WizardResumeTarget {
+    step: WizardStepEnum;
+    reason: ResumeReasonEnum;
+}

package/src/retailWizard/dtos/WizardSession.ts

@@ -8,6 +8,7 @@ import type { WizardConsents } from './WizardConsents';
 import type { WizardLoan } from './WizardLoan';
 import type { WizardPayment } from './WizardPayment';
 import type { WizardProduct } from './WizardProduct';
+import type { WizardResumeTarget } from './WizardResumeTarget';
 import type { WizardWelcome } from './WizardWelcome';
 
 /** Modalidad de captura del KYC (M1 §213-329). */
@@ -47,6 +48,20 @@ export interface WizardSession {
   state: WizardStateEnum;
   otpVerified: boolean;
   otpSkipped: boolean;
+  /**
+   * Hay una reanudación esperando su OTP. Retomar una venta a medias pide la prueba del teléfono de
+   * nuevo, aunque `otpVerified` ya esté en `true` de la vez anterior — por eso son campos distintos.
+   *
+   * Opcional: es aditivo sobre un contrato ya publicado. Ausente = no hay reanudación en curso.
+   */
+  resumeOtpRequired?: boolean;
+  /**
+   * Primer hueco del onboarding: a qué paso aterriza el comprador al reanudar, y por qué. Lo calcula
+   * el silo — es regla de negocio, no navegación.
+   *
+   * Opcional por lo mismo que `resumeOtpRequired`: un consumidor que no lo conoce sigue igual.
+   */
+  resumeTarget?: WizardResumeTarget | null;
   consents: WizardConsents | null;
   /** Espejo del estado KYC (fuente = customer). */
   kycStatus: string | null;

package/src/retailWizard/enums/ResumeReasonEnum.ts

@@ -0,0 +1,17 @@
+/**
+ * Por qué el wizard manda al comprador a ese paso al reanudar una venta a medias. El silo busca el
+ * PRIMER hueco del onboarding de arriba hacia abajo: cuenta → KYC → domicilio → preguntas.
+ * SureKeep Fase 2 — pista Retail.
+ */
+export enum ResumeReasonEnum {
+    /** La cuenta PagoConFiado ya está lista: no falta nada del onboarding, se vuelve al paso donde quedó. */
+    ACCOUNT_READY = 'ACCOUNT_READY',
+    /** El KYC no cerró verificado: se rehace desde el principio. */
+    KYC_PENDING = 'KYC_PENDING',
+    /** El expediente quedó sin domicilio: toca el comprobante. */
+    ADDRESS_PENDING = 'ADDRESS_PENDING',
+    /** 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',
+}

package/src/retailWizard/index.ts

@@ -19,6 +19,7 @@ export * from './enums/BeneficiaryRelationEnum';
 export * from './enums/AccountVerdictEnum';
 export * from './enums/AccountOutcomeEnum';
 export * from './enums/AccountStepStatusEnum';
+export * from './enums/ResumeReasonEnum';
 
 // DTOs anidados
 export * from './dtos/WizardConsents';
@@ -31,6 +32,7 @@ export * from './dtos/WizardBeneficiary';
 export * from './dtos/WizardLoan';
 export * from './dtos/WizardCreditSummary';
 export * from './dtos/AccountStep';
+export * from './dtos/WizardResumeTarget';
 
 // Entidades principales (shapes de estado/persistencia — planas)
 export * from './dtos/WizardSession';