@fiado/type-kit 3.220.0 → 3.222.0

package/bin/retailCustomer/dtos/requests/UpsertCustomerFromKycRequest.d.ts

@@ -28,6 +28,12 @@ export declare class UpsertCustomerFromKycRequest {
     pcfAccountId?: string;
     pcfClabe?: string;
     pcfAccountLevel?: 1 | 2;
+    /**
+     * El cliente ya tenía una cuenta PCF ACTIVE en México (rama facematch). Si es `true`, el receptor
+     * marca `accountStatus=LINKED` en vez de `OPENING` y NO dispara la apertura async (D35).
+     * Ausente/`false` = flujo normal (se abre cuenta). SureKeep Fase 2 — bifurcación KYC.
+     */
+    hasActiveMxAccount?: boolean;
     kycStatus: RetailKycStatusEnum;
     kycModality: KycModalityEnum;
     address?: AddressBase;

package/bin/retailCustomer/dtos/requests/UpsertCustomerFromKycRequest.js

@@ -118,6 +118,12 @@ __decorate([
     (0, class_validator_1.IsIn)([1, 2]),
     __metadata("design:type", Number)
 ], UpsertCustomerFromKycRequest.prototype, "pcfAccountLevel", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], UpsertCustomerFromKycRequest.prototype, "hasActiveMxAccount", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsEnum)(RetailKycStatusEnum_1.RetailKycStatusEnum),

package/bin/retailCustomer/enums/AccountStatusEnum.d.ts

@@ -5,5 +5,11 @@
 export declare enum AccountStatusEnum {
     OPENING = "OPENING",
     OPEN = "OPEN",
-    FAILED = "FAILED"
+    FAILED = "FAILED",
+    /**
+     * El cliente YA tenía una cuenta PCF ACTIVE en México al entrar por SureKeep (rama facematch):
+     * no se abre una nueva. No dispara la apertura async (D35) ni el welcome bonus (ese es incentivo
+     * para completar N2). SureKeep Fase 2 — bifurcación KYC.
+     */
+    LINKED = "LINKED"
 }

package/bin/retailCustomer/enums/AccountStatusEnum.js

@@ -10,4 +10,10 @@ var AccountStatusEnum;
     AccountStatusEnum["OPENING"] = "OPENING";
     AccountStatusEnum["OPEN"] = "OPEN";
     AccountStatusEnum["FAILED"] = "FAILED";
+    /**
+     * El cliente YA tenía una cuenta PCF ACTIVE en México al entrar por SureKeep (rama facematch):
+     * no se abre una nueva. No dispara la apertura async (D35) ni el welcome bonus (ese es incentivo
+     * para completar N2). SureKeep Fase 2 — bifurcación KYC.
+     */
+    AccountStatusEnum["LINKED"] = "LINKED";
 })(AccountStatusEnum || (exports.AccountStatusEnum = AccountStatusEnum = {}));

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

@@ -12,7 +12,7 @@ import type { WizardWelcome } from './WizardWelcome';
 /** Modalidad de captura del KYC (M1 §213-329). */
 export type KycModality = 'CUSTOMER_LINK' | 'STORE_DEVICE' | 'MANUAL';
 /** Estado de la apertura de cuenta async (D35) — espejo de `RetailCustomer.accountStatus`. */
-export type AccountStatus = 'OPENING' | 'OPEN' | 'FAILED';
+export type AccountStatus = 'OPENING' | 'OPEN' | 'FAILED' | 'LINKED';
 /**
  * Estado de la SAGA del wizard (modelo-datos §1). ES la tabla de estado: cada paso persiste su
  * avance; reanudable. pk `SESSION#<sessionId>` · sk `META` · GSIs `phone-state-index`,

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

@@ -31,6 +31,33 @@ export interface KycSdkMetadata {
     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 declare enum KycMetadataSourceEnum {
+    SUREKEEP_WIZARD = "surekeepWizard"
 }
 /**
  * POST /wizard/sessions/:id/kyc/prepare — respuesta.

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

@@ -1,2 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.KycMetadataSourceEnum = void 0;
+/**
+ * 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.
+ */
+var KycMetadataSourceEnum;
+(function (KycMetadataSourceEnum) {
+    KycMetadataSourceEnum["SUREKEEP_WIZARD"] = "surekeepWizard";
+})(KycMetadataSourceEnum || (exports.KycMetadataSourceEnum = KycMetadataSourceEnum = {}));

package/package.json

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

package/src/retailCustomer/dtos/requests/UpsertCustomerFromKycRequest.ts

@@ -1,5 +1,6 @@
 import { Expose, Transform, Type } from 'class-transformer';
 import {
+    IsBoolean,
     IsEmail,
     IsEnum,
     IsIn,
@@ -107,6 +108,16 @@ export class UpsertCustomerFromKycRequest {
     @IsIn([1, 2])
     pcfAccountLevel?: 1 | 2;
 
+    /**
+     * El cliente ya tenía una cuenta PCF ACTIVE en México (rama facematch). Si es `true`, el receptor
+     * marca `accountStatus=LINKED` en vez de `OPENING` y NO dispara la apertura async (D35).
+     * Ausente/`false` = flujo normal (se abre cuenta). SureKeep Fase 2 — bifurcación KYC.
+     */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    hasActiveMxAccount?: boolean;
+
     @Expose()
     @IsEnum(RetailKycStatusEnum)
     kycStatus!: RetailKycStatusEnum;

package/src/retailCustomer/enums/AccountStatusEnum.ts

@@ -6,4 +6,10 @@ export enum AccountStatusEnum {
     OPENING = 'OPENING',
     OPEN = 'OPEN',
     FAILED = 'FAILED',
+    /**
+     * El cliente YA tenía una cuenta PCF ACTIVE en México al entrar por SureKeep (rama facematch):
+     * no se abre una nueva. No dispara la apertura async (D35) ni el welcome bonus (ese es incentivo
+     * para completar N2). SureKeep Fase 2 — bifurcación KYC.
+     */
+    LINKED = 'LINKED',
 }

package/src/retailWizard/dtos/WizardSession.ts

@@ -14,7 +14,7 @@ import type { WizardWelcome } from './WizardWelcome';
 export type KycModality = 'CUSTOMER_LINK' | 'STORE_DEVICE' | 'MANUAL';
 
 /** Estado de la apertura de cuenta async (D35) — espejo de `RetailCustomer.accountStatus`. */
-export type AccountStatus = 'OPENING' | 'OPEN' | 'FAILED';
+export type AccountStatus = 'OPENING' | 'OPEN' | 'FAILED' | 'LINKED';
 
 /**
  * Estado de la SAGA del wizard (modelo-datos §1). ES la tabla de estado: cada paso persiste su

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

@@ -32,6 +32,34 @@ export interface KycSdkMetadata {
     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',
 }
 
 /**