@fiado/type-kit 3.248.0 → 3.249.0

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

@@ -1,95 +1,95 @@
-import { KycModalityEnum } from '../../../retailCustomer/enums/KycModalityEnum';
-
-/**
- * Metadata que el wizard entrega al SDK de Metamap para que la verificación quede correlacionada
- * con la identidad Fiado. Viaja base64 dentro de `KycPrepareResponse.metadata`.
- *
- * **La arma el wizard, no el front** (`loan-backoffice-webapp/.env.example`): el front no conoce
- * `peopleId` ni `typeOfDirectoryId` — los resuelve el wizard al crear/reusar la identidad.
- *
- * Espeja `kyc-verifications-business/src/core/entities/Metadata.ts`. Es la ÚNICA correlación entre
- * la verificación de Metamap y el cliente Fiado: el webhook crea la fila desde acá (D18/D19).
- *
- * ⚠️ `typeOfDocumentId` e `isPartial` van OPCIONALES a propósito: el tipo del productor los declara
- * requeridos, pero están ausentes en el 100% de los 311 bloques de metadata observados en dev
- * (spec KYC F2 §14.1). Todo indica que los completa el SDK/backend de Metamap. Marcarlos requeridos
- * acá obligaría al wizard a inventar valores. Se cierra cuando el dueño del SDK lo confirme.
- */
-export interface KycSdkMetadata {
-    directoryId: string;
-    typeOfDirectoryId: string;
-    peopleId: string;
-    countryId: string;
-    phoneNumber: string;
-    typeOfDocumentId?: string;
-    isPartial?: boolean;
-    /**
-     * Idioma con el que Metamap fija el flujo del widget. El wizard lo manda como `'es'` para que
-     * la verificación salga en español por defecto (si no viaja, Metamap arranca en su default, inglés).
-     * Va opcional en el tipo porque es un ajuste de presentación del SDK, no parte de la correlación.
-     */
-    fixedLanguage?: string;
-    customInput?: boolean;
-    userPhotoLink?: string;
-    userPhotoLinkHash?: string;
-    /**
-     * Qué producto originó esta verificación. Metamap devuelve la metadata TAL CUAL en cada webhook,
-     * así que este campo es la única marca por la que `kyc-metamap-webhook` puede reconocer que un
-     * KYC salió del wizard de SureKeep.
-     *
-     * **Por qué no basta el `flowId`:** hoy el webhook discrimina comparando contra `SUREKEEP_FLOW_ID`,
-     * pero ese flow (`67b7700699b525001cabb350`, DEVELOPMENT_MEX_WORKFLOW) también lo usa
-     * `fiado-user-wallet-app` — no es exclusivo. Con un evento por verificación el ruido es tolerable
-     * (el consumidor lo descarta en su gate), pero el progreso estación por estación multiplica ese
-     * volumen por ~8 y cada mensaje ajeno cuesta lecturas de DDB en el consumidor.
-     *
-     * Opcional y aditivo: una verificación vieja sin `source` sigue resolviéndose por `flowId`.
-     * La solución de fondo es un flow propio de SureKeep en Metamap — configuración del proveedor,
-     * no código.
-     */
-    source?: KycMetadataSourceEnum;
-}
-
-/**
- * Producto que originó una verificación KYC, tal como viaja en `KycSdkMetadata.source`.
- *
- * Es un enum y no un string libre a propósito: el valor lo escribe un repo (`retail-wizard-business`)
- * y lo compara otro (`kyc-metamap-webhook`). Un typo de un lado no rompería nada visible — el webhook
- * simplemente dejaría de reconocer los KYC de SureKeep y el progreso nunca llegaría a la pantalla,
- * sin un solo error en los logs.
- */
-export enum KycMetadataSourceEnum {
-    SUREKEEP_WIZARD = 'surekeepWizard',
-}
-
-/**
- * POST /wizard/sessions/:id/kyc/prepare — respuesta.
- *
- * **Bifurca por modalidad**, por eso todo es opcional salvo `modality`:
- * - `STORE_DEVICE` → `clientId` + `flowId` + `metadata` para que el front monte el
- *   `<metamap-button>` en la tablet. Única excepción a la regla puente (D25): el widget es un SDK
- *   de un SaaS de terceros que corre en el dispositivo del cliente y habla con Metamap, no con Fiado.
- * - `CUSTOMER_LINK` → `shortUrl` para el QR / SMS al teléfono del cliente.
- *
- * `alreadyVerified` corta el flujo antes de cualquiera de las dos: cuando la consolidación del spec
- * KYC F2 §8.2 ya da `VERIFIED` para ese directorio, no hay identidad que capturar.
- *
- * SureKeep Fase 2 — pista Retail.
- */
-export interface KycPrepareResponse {
-    /**
-     * `MANUAL` NO es una modalidad de `prepare`: la captura manual es su propio endpoint
-     * (`KycManualRequest`). Por eso el tipo se estrecha a las dos que el SDK puede ejecutar.
-     */
-    modality: KycModalityEnum.CUSTOMER_LINK | KycModalityEnum.STORE_DEVICE;
-    /** STORE_DEVICE — clientId de la cuenta Metamap (mismo valor en prod y dev). */
-    clientId?: string;
-    /** STORE_DEVICE — flow de Metamap por país; sale de la configuración del wizard. */
-    flowId?: string;
-    /** STORE_DEVICE — `KycSdkMetadata` serializada en base64. */
-    metadata?: string;
-    /** CUSTOMER_LINK — link corto para el QR o el SMS. */
-    shortUrl?: string;
-    /** El cliente ya tiene una identidad verificada vigente: no hay nada que capturar. */
-    alreadyVerified?: boolean;
-}
+import { KycModalityEnum } from '../../../retailCustomer/enums/KycModalityEnum';
+
+/**
+ * Metadata que el wizard entrega al SDK de Metamap para que la verificación quede correlacionada
+ * con la identidad Fiado. Viaja base64 dentro de `KycPrepareResponse.metadata`.
+ *
+ * **La arma el wizard, no el front** (`loan-backoffice-webapp/.env.example`): el front no conoce
+ * `peopleId` ni `typeOfDirectoryId` — los resuelve el wizard al crear/reusar la identidad.
+ *
+ * Espeja `kyc-verifications-business/src/core/entities/Metadata.ts`. Es la ÚNICA correlación entre
+ * la verificación de Metamap y el cliente Fiado: el webhook crea la fila desde acá (D18/D19).
+ *
+ * ⚠️ `typeOfDocumentId` e `isPartial` van OPCIONALES a propósito: el tipo del productor los declara
+ * requeridos, pero están ausentes en el 100% de los 311 bloques de metadata observados en dev
+ * (spec KYC F2 §14.1). Todo indica que los completa el SDK/backend de Metamap. Marcarlos requeridos
+ * acá obligaría al wizard a inventar valores. Se cierra cuando el dueño del SDK lo confirme.
+ */
+export interface KycSdkMetadata {
+    directoryId: string;
+    typeOfDirectoryId: string;
+    peopleId: string;
+    countryId: string;
+    phoneNumber: string;
+    typeOfDocumentId?: string;
+    isPartial?: boolean;
+    /**
+     * Idioma con el que Metamap fija el flujo del widget. El wizard lo manda como `'es'` para que
+     * la verificación salga en español por defecto (si no viaja, Metamap arranca en su default, inglés).
+     * Va opcional en el tipo porque es un ajuste de presentación del SDK, no parte de la correlación.
+     */
+    fixedLanguage?: string;
+    customInput?: boolean;
+    userPhotoLink?: string;
+    userPhotoLinkHash?: string;
+    /**
+     * Qué producto originó esta verificación. Metamap devuelve la metadata TAL CUAL en cada webhook,
+     * así que este campo es la única marca por la que `kyc-metamap-webhook` puede reconocer que un
+     * KYC salió del wizard de SureKeep.
+     *
+     * **Por qué no basta el `flowId`:** hoy el webhook discrimina comparando contra `SUREKEEP_FLOW_ID`,
+     * pero ese flow (`67b7700699b525001cabb350`, DEVELOPMENT_MEX_WORKFLOW) también lo usa
+     * `fiado-user-wallet-app` — no es exclusivo. Con un evento por verificación el ruido es tolerable
+     * (el consumidor lo descarta en su gate), pero el progreso estación por estación multiplica ese
+     * volumen por ~8 y cada mensaje ajeno cuesta lecturas de DDB en el consumidor.
+     *
+     * Opcional y aditivo: una verificación vieja sin `source` sigue resolviéndose por `flowId`.
+     * La solución de fondo es un flow propio de SureKeep en Metamap — configuración del proveedor,
+     * no código.
+     */
+    source?: KycMetadataSourceEnum;
+}
+
+/**
+ * Producto que originó una verificación KYC, tal como viaja en `KycSdkMetadata.source`.
+ *
+ * Es un enum y no un string libre a propósito: el valor lo escribe un repo (`retail-wizard-business`)
+ * y lo compara otro (`kyc-metamap-webhook`). Un typo de un lado no rompería nada visible — el webhook
+ * simplemente dejaría de reconocer los KYC de SureKeep y el progreso nunca llegaría a la pantalla,
+ * sin un solo error en los logs.
+ */
+export enum KycMetadataSourceEnum {
+    SUREKEEP_WIZARD = 'surekeepWizard',
+}
+
+/**
+ * POST /wizard/sessions/:id/kyc/prepare — respuesta.
+ *
+ * **Bifurca por modalidad**, por eso todo es opcional salvo `modality`:
+ * - `STORE_DEVICE` → `clientId` + `flowId` + `metadata` para que el front monte el
+ *   `<metamap-button>` en la tablet. Única excepción a la regla puente (D25): el widget es un SDK
+ *   de un SaaS de terceros que corre en el dispositivo del cliente y habla con Metamap, no con Fiado.
+ * - `CUSTOMER_LINK` → `shortUrl` para el QR / SMS al teléfono del cliente.
+ *
+ * `alreadyVerified` corta el flujo antes de cualquiera de las dos: cuando la consolidación del spec
+ * KYC F2 §8.2 ya da `VERIFIED` para ese directorio, no hay identidad que capturar.
+ *
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface KycPrepareResponse {
+    /**
+     * `MANUAL` NO es una modalidad de `prepare`: la captura manual es su propio endpoint
+     * (`KycManualRequest`). Por eso el tipo se estrecha a las dos que el SDK puede ejecutar.
+     */
+    modality: KycModalityEnum.CUSTOMER_LINK | KycModalityEnum.STORE_DEVICE;
+    /** STORE_DEVICE — clientId de la cuenta Metamap (mismo valor en prod y dev). */
+    clientId?: string;
+    /** STORE_DEVICE — flow de Metamap por país; sale de la configuración del wizard. */
+    flowId?: string;
+    /** STORE_DEVICE — `KycSdkMetadata` serializada en base64. */
+    metadata?: string;
+    /** CUSTOMER_LINK — link corto para el QR o el SMS. */
+    shortUrl?: string;
+    /** El cliente ya tiene una identidad verificada vigente: no hay nada que capturar. */
+    alreadyVerified?: boolean;
+}

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

@@ -1,25 +1,25 @@
-import { WizardCreditSummary } from '../WizardCreditSummary';
-
-/** Bounds y parámetros del plan que gobiernan el cotizador (slider + plazos) del paso 06. */
-export interface QuotePlanBounds {
-    planId: string;
-    code: string;
-    /** Enganche mínimo como decimal sobre 1 (`0.40` = 40%). */
-    minDownPaymentPct: number;
-    /** Techo de enganche (decimal sobre 1); `null` = sin techo definido. */
-    maxDownPaymentPct: number | null;
-    termWeeksOptions: number[];
-    /** TNA decimal (`2.60` = 260%) — la tasa que manda es la del PLAN. */
-    tnaAnnual: number;
-    openingCommissionPct: number;
-}
-
-/**
- * POST /wizard/sessions/:id/quote — respuesta del cotizador del paso 06: el plan resuelto por
- * nivel + el snapshot financiero del crédito originado/re-cotizado (transitorio, NO se persiste
- * en la sesión — la fuente es loan-credit). SureKeep Fase 2 — pista SOFOM.
- */
-export interface QuoteResponse {
-    plan: QuotePlanBounds;
-    credit: WizardCreditSummary;
-}
+import { WizardCreditSummary } from '../WizardCreditSummary';
+
+/** Bounds y parámetros del plan que gobiernan el cotizador (slider + plazos) del paso 06. */
+export interface QuotePlanBounds {
+    planId: string;
+    code: string;
+    /** Enganche mínimo como decimal sobre 1 (`0.40` = 40%). */
+    minDownPaymentPct: number;
+    /** Techo de enganche (decimal sobre 1); `null` = sin techo definido. */
+    maxDownPaymentPct: number | null;
+    termWeeksOptions: number[];
+    /** TNA decimal (`2.60` = 260%) — la tasa que manda es la del PLAN. */
+    tnaAnnual: number;
+    openingCommissionPct: number;
+}
+
+/**
+ * POST /wizard/sessions/:id/quote — respuesta del cotizador del paso 06: el plan resuelto por
+ * nivel + el snapshot financiero del crédito originado/re-cotizado (transitorio, NO se persiste
+ * en la sesión — la fuente es loan-credit). SureKeep Fase 2 — pista SOFOM.
+ */
+export interface QuoteResponse {
+    plan: QuotePlanBounds;
+    credit: WizardCreditSummary;
+}

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

@@ -1,15 +1,15 @@
-import { LoanCreditStatusEnum } from '../../../loanCredit/enums/LoanCreditStatusEnum';
-import { ActivationChecklist } from '../../../loanCredit/dtos/ActivationChecklist';
-
-/**
- * POST /wizard/sessions/:id/device — resultado del registro de IMEI + candado (paso 09).
- * `active: true` cuando el checklist quedó 4/4 y el crédito pasó a `ACTIVE` (el front bloquea
- * "Continuar a Bienvenida" hasta entonces; `missingItems` lista lo que falta).
- * SureKeep Fase 2 — pista SOFOM.
- */
-export interface RegisterDeviceResponse {
-    creditStatus: LoanCreditStatusEnum;
-    checklist: ActivationChecklist;
-    missingItems: string[];
-    active: boolean;
-}
+import { LoanCreditStatusEnum } from '../../../loanCredit/enums/LoanCreditStatusEnum';
+import { ActivationChecklist } from '../../../loanCredit/dtos/ActivationChecklist';
+
+/**
+ * POST /wizard/sessions/:id/device — resultado del registro de IMEI + candado (paso 09).
+ * `active: true` cuando el checklist quedó 4/4 y el crédito pasó a `ACTIVE` (el front bloquea
+ * "Continuar a Bienvenida" hasta entonces; `missingItems` lista lo que falta).
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export interface RegisterDeviceResponse {
+    creditStatus: LoanCreditStatusEnum;
+    checklist: ActivationChecklist;
+    missingItems: string[];
+    active: boolean;
+}

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

@@ -1,21 +1,21 @@
-import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
-import { ScoringDecisionEnum } from '../../../loanScoring/enums/ScoringDecisionEnum';
-import { ScoringOffer } from '../../../loanScoring/dtos/ScoringOffer';
-
-/**
- * POST /wizard/sessions/:id/score/consult — resultado de la evaluación SCI del paso 05.
- *
- * El wizard es idempotente por sesión: si la sesión ya tiene `loan.sciEvaluationId`, devuelve el
- * snapshot existente (no re-evalúa — cada evaluate del motor genera un snapshot NUEVO).
- * `REJECTED`/`NO_ELIGIBLE` no matan la venta: el front ofrece financiera externa o contado.
- * SureKeep Fase 2 — pista SOFOM.
- */
-export interface ScoreConsultResponse {
-    /** Decisión normalizada del motor de scoring. */
-    status: ScoringDecisionEnum;
-    level: ClientLevelEnum;
-    /** Puntero al snapshot inmutable en loan-scoring (se persiste en `WizardSession.loan`). */
-    sciEvaluationId: string;
-    /** Oferta del proveedor (display del paso 05; la cotización del 06 usa el PLAN, no esto). */
-    offer: ScoringOffer | null;
-}
+import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
+import { ScoringDecisionEnum } from '../../../loanScoring/enums/ScoringDecisionEnum';
+import { ScoringOffer } from '../../../loanScoring/dtos/ScoringOffer';
+
+/**
+ * POST /wizard/sessions/:id/score/consult — resultado de la evaluación SCI del paso 05.
+ *
+ * El wizard es idempotente por sesión: si la sesión ya tiene `loan.sciEvaluationId`, devuelve el
+ * snapshot existente (no re-evalúa — cada evaluate del motor genera un snapshot NUEVO).
+ * `REJECTED`/`NO_ELIGIBLE` no matan la venta: el front ofrece financiera externa o contado.
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export interface ScoreConsultResponse {
+    /** Decisión normalizada del motor de scoring. */
+    status: ScoringDecisionEnum;
+    level: ClientLevelEnum;
+    /** Puntero al snapshot inmutable en loan-scoring (se persiste en `WizardSession.loan`). */
+    sciEvaluationId: string;
+    /** Oferta del proveedor (display del paso 05; la cotización del 06 usa el PLAN, no esto). */
+    offer: ScoringOffer | null;
+}

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

@@ -1,15 +1,15 @@
-import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
-import { ScoringDecisionEnum } from '../../../loanScoring/enums/ScoringDecisionEnum';
-import { ScoringOffer } from '../../../loanScoring/dtos/ScoringOffer';
-
-/**
- * GET /wizard/sessions/:id/score/result — lectura del resultado del score del paso 05 (la tablet
- * lee el snapshot ya persistido vía `loan.sciEvaluationId`; no dispara evaluación).
- * SureKeep Fase 2 — pista SOFOM.
- */
-export interface ScoreResultResponse {
-    status: ScoringDecisionEnum;
-    level: ClientLevelEnum;
-    sciEvaluationId: string;
-    offer: ScoringOffer | null;
-}
+import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
+import { ScoringDecisionEnum } from '../../../loanScoring/enums/ScoringDecisionEnum';
+import { ScoringOffer } from '../../../loanScoring/dtos/ScoringOffer';
+
+/**
+ * GET /wizard/sessions/:id/score/result — lectura del resultado del score del paso 05 (la tablet
+ * lee el snapshot ya persistido vía `loan.sciEvaluationId`; no dispara evaluación).
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export interface ScoreResultResponse {
+    status: ScoringDecisionEnum;
+    level: ClientLevelEnum;
+    sciEvaluationId: string;
+    offer: ScoringOffer | null;
+}

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

@@ -1,28 +1,28 @@
-import { FinancierTypeEnum } from '../../../loanOfferings/enums/FinancierTypeEnum';
-
-/**
- * Una opción de financiamiento del paso 04 (pantalla forma de pago): la unión de las financieras
- * ACTIVE del catálogo SOFOM (`loan-offerings GET /private/financiers/active` — display + orden)
- * con la elegibilidad del producto reservado (`eligibleFinanciers` del catálogo retail).
- */
-export interface SessionFinancierOption {
-    code: string;
-    name: string;
-    /** Texto de display de la card (viene del catálogo SOFOM). */
-    label: string;
-    /** INTERNAL = SureKeep (pista crédito propia); EXTERNAL = derivación (PayJoy, CrediYa…). */
-    type: FinancierTypeEnum;
-    displayOrder: number;
-    /** Solo EXTERNAL: URL de derivación. */
-    externalRedirectUrl: string | null;
-    /** El producto reservado admite esta financiera (INTERNAL siempre elegible). */
-    eligible: boolean;
-}
-
-/**
- * GET /wizard/sessions/:id/financiers — las opciones de financiamiento del paso 04 para la sesión
- * (según su producto reservado). Ordenadas por `displayOrder`. SureKeep Fase 2 — pista SOFOM.
- */
-export interface SessionFinanciersResponse {
-    financiers: SessionFinancierOption[];
-}
+import { FinancierTypeEnum } from '../../../loanOfferings/enums/FinancierTypeEnum';
+
+/**
+ * Una opción de financiamiento del paso 04 (pantalla forma de pago): la unión de las financieras
+ * ACTIVE del catálogo SOFOM (`loan-offerings GET /private/financiers/active` — display + orden)
+ * con la elegibilidad del producto reservado (`eligibleFinanciers` del catálogo retail).
+ */
+export interface SessionFinancierOption {
+    code: string;
+    name: string;
+    /** Texto de display de la card (viene del catálogo SOFOM). */
+    label: string;
+    /** INTERNAL = SureKeep (pista crédito propia); EXTERNAL = derivación (PayJoy, CrediYa…). */
+    type: FinancierTypeEnum;
+    displayOrder: number;
+    /** Solo EXTERNAL: URL de derivación. */
+    externalRedirectUrl: string | null;
+    /** El producto reservado admite esta financiera (INTERNAL siempre elegible). */
+    eligible: boolean;
+}
+
+/**
+ * GET /wizard/sessions/:id/financiers — las opciones de financiamiento del paso 04 para la sesión
+ * (según su producto reservado). Ordenadas por `displayOrder`. SureKeep Fase 2 — pista SOFOM.
+ */
+export interface SessionFinanciersResponse {
+    financiers: SessionFinancierOption[];
+}

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

@@ -1,10 +1,10 @@
-/**
- * POST /wizard/sessions/:id/signature/send-otp — firma FES tiempo 1 (paso 08): loan-credit
- * congela términos, genera los PDFs y despacha el OTP dedicado de firma (4 dígitos, 5 min) al
- * teléfono del cliente vía messages-business. SureKeep Fase 2 — pista SOFOM.
- */
-export interface SignatureSendOtpResponse {
-    otpSent: boolean;
-    /** Teléfono destino enmascarado para la pantalla (`****1234`) — nunca el número completo. */
-    otpDestinationMasked: string;
-}
+/**
+ * POST /wizard/sessions/:id/signature/send-otp — firma FES tiempo 1 (paso 08): loan-credit
+ * congela términos, genera los PDFs y despacha el OTP dedicado de firma (4 dígitos, 5 min) al
+ * teléfono del cliente vía messages-business. SureKeep Fase 2 — pista SOFOM.
+ */
+export interface SignatureSendOtpResponse {
+    otpSent: boolean;
+    /** Teléfono destino enmascarado para la pantalla (`****1234`) — nunca el número completo. */
+    otpDestinationMasked: string;
+}

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

@@ -1,11 +1,11 @@
-import { ActivationChecklist } from '../../../loanCredit/dtos/ActivationChecklist';
-
-/**
- * POST /wizard/sessions/:id/signature/sign — resultado de la firma FES tiempo 2 (paso 08).
- * `signed: true` implica `checklist.contractSigned: true` (condición 2 de activación).
- * SureKeep Fase 2 — pista SOFOM.
- */
-export interface SignatureSignResponse {
-    signed: boolean;
-    checklist: ActivationChecklist;
-}
+import { ActivationChecklist } from '../../../loanCredit/dtos/ActivationChecklist';
+
+/**
+ * POST /wizard/sessions/:id/signature/sign — resultado de la firma FES tiempo 2 (paso 08).
+ * `signed: true` implica `checklist.contractSigned: true` (condición 2 de activación).
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export interface SignatureSignResponse {
+    signed: boolean;
+    checklist: ActivationChecklist;
+}

package/src/retailWizard/enums/BeneficiaryRelationEnum.ts

@@ -1,18 +1,18 @@
-/**
- * Parentesco del beneficiario (catálogo de 9 valores Fiado; dropdown del paso 10).
- * SureKeep Fase 2 — pista Retail.
- *
- * SPOUSE - Cónyuge · CHILD - Hijo(a) · PARENT - Padre/Madre · SIBLING - Hermano(a) ·
- * GRANDPARENT - Abuelo(a) · GRANDCHILD - Nieto(a) · PARTNER - Concubino(a) · FRIEND - Amigo(a) · OTHER - Otro.
- */
-export enum BeneficiaryRelationEnum {
-    SPOUSE = 'SPOUSE',
-    CHILD = 'CHILD',
-    PARENT = 'PARENT',
-    SIBLING = 'SIBLING',
-    GRANDPARENT = 'GRANDPARENT',
-    GRANDCHILD = 'GRANDCHILD',
-    PARTNER = 'PARTNER',
-    FRIEND = 'FRIEND',
-    OTHER = 'OTHER',
-}
+/**
+ * Parentesco del beneficiario (catálogo de 9 valores Fiado; dropdown del paso 10).
+ * SureKeep Fase 2 — pista Retail.
+ *
+ * SPOUSE - Cónyuge · CHILD - Hijo(a) · PARENT - Padre/Madre · SIBLING - Hermano(a) ·
+ * GRANDPARENT - Abuelo(a) · GRANDCHILD - Nieto(a) · PARTNER - Concubino(a) · FRIEND - Amigo(a) · OTHER - Otro.
+ */
+export enum BeneficiaryRelationEnum {
+    SPOUSE = 'SPOUSE',
+    CHILD = 'CHILD',
+    PARENT = 'PARENT',
+    SIBLING = 'SIBLING',
+    GRANDPARENT = 'GRANDPARENT',
+    GRANDCHILD = 'GRANDCHILD',
+    PARTNER = 'PARTNER',
+    FRIEND = 'FRIEND',
+    OTHER = 'OTHER',
+}

package/src/retailWizard/enums/CentralSyncStatusEnum.ts

@@ -1,14 +1,14 @@
-/**
- * Estado de sincronización de la venta con Central (local-first; badge en BO). SureKeep Fase 2 — pista Retail.
- *
- * PENDING - Aún no sincronizada.
- * SENT - Enviada a Central.
- * FAILED - Falló la sincronización.
- * N_A - No aplica (p. ej. derivación externa).
- */
-export enum CentralSyncStatusEnum {
-    PENDING = 'PENDING',
-    SENT = 'SENT',
-    FAILED = 'FAILED',
-    N_A = 'N_A',
-}
+/**
+ * Estado de sincronización de la venta con Central (local-first; badge en BO). SureKeep Fase 2 — pista Retail.
+ *
+ * PENDING - Aún no sincronizada.
+ * SENT - Enviada a Central.
+ * FAILED - Falló la sincronización.
+ * N_A - No aplica (p. ej. derivación externa).
+ */
+export enum CentralSyncStatusEnum {
+    PENDING = 'PENDING',
+    SENT = 'SENT',
+    FAILED = 'FAILED',
+    N_A = 'N_A',
+}

package/src/retailWizard/enums/ExternalProviderEnum.ts

@@ -1,7 +1,7 @@
-/** Proveedor externo de financiamiento al que se deriva la venta. SureKeep Fase 2 — pista Retail. */
-export enum ExternalProviderEnum {
-    PAYJOY = 'PAYJOY',
-    CREDIYA = 'CREDIYA',
-    LESPAGO = 'LESPAGO',
-    INNOVA = 'INNOVA',
-}
+/** Proveedor externo de financiamiento al que se deriva la venta. SureKeep Fase 2 — pista Retail. */
+export enum ExternalProviderEnum {
+    PAYJOY = 'PAYJOY',
+    CREDIYA = 'CREDIYA',
+    LESPAGO = 'LESPAGO',
+    INNOVA = 'INNOVA',
+}

package/src/retailWizard/enums/FiadoPhoneStatusEnum.ts

@@ -1,15 +1,15 @@
-/**
- * Estado del teléfono en el gate `signInPhoneNumber` del paso 01a (D27) — decide si el 01d crea o
- * vincula la identidad Fiado y habilita el UX "Cliente reconocido". SureKeep Fase 2 — pista Retail.
- *
- * SIGN_UP - Teléfono nuevo (onboarding recién creado por el gate).
- * PENDING_PASSWORD_CREATION - Cliente existente sin contraseña aún.
- * ACTIVE - Cliente Fiado activo.
- * USER_TEMP_BLOCKED - Bloqueo temporal.
- */
-export enum FiadoPhoneStatusEnum {
-    SIGN_UP = 'SIGN_UP',
-    PENDING_PASSWORD_CREATION = 'PENDING_PASSWORD_CREATION',
-    ACTIVE = 'ACTIVE',
-    USER_TEMP_BLOCKED = 'USER_TEMP_BLOCKED',
-}
+/**
+ * Estado del teléfono en el gate `signInPhoneNumber` del paso 01a (D27) — decide si el 01d crea o
+ * vincula la identidad Fiado y habilita el UX "Cliente reconocido". SureKeep Fase 2 — pista Retail.
+ *
+ * SIGN_UP - Teléfono nuevo (onboarding recién creado por el gate).
+ * PENDING_PASSWORD_CREATION - Cliente existente sin contraseña aún.
+ * ACTIVE - Cliente Fiado activo.
+ * USER_TEMP_BLOCKED - Bloqueo temporal.
+ */
+export enum FiadoPhoneStatusEnum {
+    SIGN_UP = 'SIGN_UP',
+    PENDING_PASSWORD_CREATION = 'PENDING_PASSWORD_CREATION',
+    ACTIVE = 'ACTIVE',
+    USER_TEMP_BLOCKED = 'USER_TEMP_BLOCKED',
+}

package/src/retailWizard/enums/OccupationEnum.ts

@@ -1,13 +1,13 @@
-/**
- * Ocupación del cliente (micro-paso del 02; dropdown de 7 valores + OTHER abre texto libre ≤60).
- * Sin ocupación NO se abre la cuenta (Manual v1.4 §8.13). SureKeep Fase 2 — pista Retail.
- */
-export enum OccupationEnum {
-    EMPLOYED = 'EMPLOYED',
-    SELF_EMPLOYED = 'SELF_EMPLOYED',
-    STUDENT = 'STUDENT',
-    HOMEMAKER = 'HOMEMAKER',
-    RETIRED = 'RETIRED',
-    UNEMPLOYED = 'UNEMPLOYED',
-    OTHER = 'OTHER',
-}
+/**
+ * Ocupación del cliente (micro-paso del 02; dropdown de 7 valores + OTHER abre texto libre ≤60).
+ * Sin ocupación NO se abre la cuenta (Manual v1.4 §8.13). SureKeep Fase 2 — pista Retail.
+ */
+export enum OccupationEnum {
+    EMPLOYED = 'EMPLOYED',
+    SELF_EMPLOYED = 'SELF_EMPLOYED',
+    STUDENT = 'STUDENT',
+    HOMEMAKER = 'HOMEMAKER',
+    RETIRED = 'RETIRED',
+    UNEMPLOYED = 'UNEMPLOYED',
+    OTHER = 'OTHER',
+}

package/src/retailWizard/enums/OtpPurposeEnum.ts

@@ -1,10 +1,10 @@
-/**
- * Propósito de un OTP dentro del wizard (v0.1 `otp_purpose`). SureKeep Fase 2 — pista Retail.
- *
- * IDENTITY - OTP de verificación de identidad (teléfono).
- * SIGNATURE - OTP de firma (F3).
- */
-export enum OtpPurposeEnum {
-    IDENTITY = 'IDENTITY',
-    SIGNATURE = 'SIGNATURE',
-}
+/**
+ * Propósito de un OTP dentro del wizard (v0.1 `otp_purpose`). SureKeep Fase 2 — pista Retail.
+ *
+ * IDENTITY - OTP de verificación de identidad (teléfono).
+ * SIGNATURE - OTP de firma (F3).
+ */
+export enum OtpPurposeEnum {
+    IDENTITY = 'IDENTITY',
+    SIGNATURE = 'SIGNATURE',
+}

package/src/retailWizard/enums/PaymentMethodEnum.ts

@@ -1,12 +1,12 @@
-/**
- * Router del paso 04 — método de pago elegido en el wizard. SureKeep Fase 2 — pista Retail.
- *
- * SUREKEEP - Crédito SureKeep (pista SOFOM, F2).
- * CASH_SALE - Venta de contado.
- * EXTERNAL - Derivación a proveedor externo.
- */
-export enum PaymentMethodEnum {
-    SUREKEEP = 'SUREKEEP',
-    CASH_SALE = 'CASH_SALE',
-    EXTERNAL = 'EXTERNAL',
-}
+/**
+ * Router del paso 04 — método de pago elegido en el wizard. SureKeep Fase 2 — pista Retail.
+ *
+ * SUREKEEP - Crédito SureKeep (pista SOFOM, F2).
+ * CASH_SALE - Venta de contado.
+ * EXTERNAL - Derivación a proveedor externo.
+ */
+export enum PaymentMethodEnum {
+    SUREKEEP = 'SUREKEEP',
+    CASH_SALE = 'CASH_SALE',
+    EXTERNAL = 'EXTERNAL',
+}