@fiado/type-kit 3.528.0 → 3.529.0

package/_test_/unit/emailVerification/dtos/EmailSetTrustedRequest.test.ts

@@ -50,4 +50,20 @@ describe('EmailSetTrustedRequest', () => {
         const errors = await validate(dto);
         expect(errors.some(e => e.property === 'type')).toBe(true);
     });
+
+    it('acepta isPrincipal en true', async () => {
+        const dto = plainToInstance(EmailSetTrustedRequest, { ...valid, isPrincipal: true });
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+        expect(dto.isPrincipal).toBe(true);
+    });
+
+    it('falla si isPrincipal no es booleano', async () => {
+        const dto = plainToInstance(EmailSetTrustedRequest, {
+            ...valid,
+            isPrincipal: 'si' as unknown as boolean,
+        });
+        const errors = await validate(dto);
+        expect(errors.some(e => e.property === 'isPrincipal')).toBe(true);
+    });
 });

package/_test_/unit/retailWizard/emailOtpRequests.test.ts

@@ -0,0 +1,53 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import { SendEmailOtpRequest } from '../../../src/retailWizard/dtos/requests/SendEmailOtpRequest';
+import { VerifyEmailOtpRequest } from '../../../src/retailWizard/dtos/requests/VerifyEmailOtpRequest';
+import { EmailStateEnum } from '../../../src/retailWizard/enums/EmailStateEnum';
+import { EmailTypeEnum } from '../../../src/emailVerification/enums/EmailTypeEnum';
+import * as RetailWizard from '../../../src/retailWizard';
+
+function errorsOf<T extends object>(cls: new () => T, payload: Record<string, unknown>): string[] {
+  const dto = plainToInstance(cls, payload, { excludeExtraneousValues: true });
+  return validateSync(dto).map((e) => e.property);
+}
+
+describe('SendEmailOtpRequest', () => {
+  it('acepta correo y tipo válidos', () => {
+    expect(errorsOf(SendEmailOtpRequest, { email: 'cliente@correo.com', type: EmailTypeEnum.PERSONAL })).toEqual([]);
+  });
+
+  it('rechaza un correo mal formado', () => {
+    expect(errorsOf(SendEmailOtpRequest, { email: 'no-es-correo', type: EmailTypeEnum.PERSONAL })).toContain('email');
+  });
+
+  it('rechaza un tipo fuera del enum', () => {
+    expect(errorsOf(SendEmailOtpRequest, { email: 'cliente@correo.com', type: 'WORK' })).toContain('type');
+  });
+
+  it('exige el tipo', () => {
+    expect(errorsOf(SendEmailOtpRequest, { email: 'cliente@correo.com' })).toContain('type');
+  });
+});
+
+describe('VerifyEmailOtpRequest', () => {
+  it('acepta un código de 4 dígitos', () => {
+    expect(errorsOf(VerifyEmailOtpRequest, { code: '1234' })).toEqual([]);
+  });
+
+  it('rechaza un código vacío', () => {
+    expect(errorsOf(VerifyEmailOtpRequest, { code: '' })).toContain('code');
+  });
+});
+
+describe('EmailStateEnum', () => {
+  it('tiene los tres estados del correo de la sesión', () => {
+    expect(Object.values(EmailStateEnum)).toEqual(['EXISTING', 'CAPTURED', 'PENDING']);
+  });
+
+  it('se exporta desde el índice de retailWizard junto con los requests', () => {
+    expect(RetailWizard.EmailStateEnum).toBe(EmailStateEnum);
+    expect(RetailWizard.SendEmailOtpRequest).toBe(SendEmailOtpRequest);
+    expect(RetailWizard.VerifyEmailOtpRequest).toBe(VerifyEmailOtpRequest);
+  });
+});

package/_test_/unit/retailWizard/wizardSessionEmail.test.ts

@@ -0,0 +1,22 @@
+import type { WizardSession } from '../../../src/retailWizard/dtos/WizardSession';
+import { EmailStateEnum } from '../../../src/retailWizard/enums/EmailStateEnum';
+import { EmailTypeEnum } from '../../../src/emailVerification/enums/EmailTypeEnum';
+
+type SessionEmail = Pick<WizardSession, 'emailState' | 'emailType' | 'emailMasked' | 'email'>;
+
+describe('WizardSession — correo del paso 01', () => {
+  it('declara los cuatro campos del correo', () => {
+    const captured: SessionEmail = {
+      emailState: EmailStateEnum.CAPTURED,
+      emailType: EmailTypeEnum.PERSONAL,
+      emailMasked: 'ju•••••@gmail.com',
+      email: 'juan@gmail.com',
+    };
+    expect(captured.emailState).toBe('CAPTURED');
+  });
+
+  it('los cuatro son opcionales: una sesión vieja no los trae', () => {
+    const legacy: SessionEmail = {};
+    expect(legacy).toEqual({});
+  });
+});

package/bin/emailVerification/dtos/EmailSetTrustedRequest.d.ts

@@ -7,4 +7,6 @@ export declare class EmailSetTrustedRequest {
     directoryId: string;
     email: string;
     type: EmailTypeEnum;
+    /** En true, el correo queda como principal del directorio. Sin el campo, no cambia el principal. */
+    isPrincipal?: boolean;
 }

package/bin/emailVerification/dtos/EmailSetTrustedRequest.js

@@ -35,3 +35,9 @@ __decorate([
     (0, class_validator_1.IsEnum)(EmailTypeEnum_1.EmailTypeEnum),
     __metadata("design:type", String)
 ], EmailSetTrustedRequest.prototype, "type", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], EmailSetTrustedRequest.prototype, "isPrincipal", void 0);

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

@@ -15,6 +15,8 @@ import type { WizardReservedLine } from './WizardReservedLine';
 import type { WizardResumeTarget } from './WizardResumeTarget';
 import type { WizardWelcome } from './WizardWelcome';
 import type { WizardCreditPromotionBonus } from './WizardCreditPromotionBonus';
+import type { EmailStateEnum } from '../enums/EmailStateEnum';
+import type { EmailTypeEnum } from '../../emailVerification/enums/EmailTypeEnum';
 /** 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`. */
@@ -64,6 +66,14 @@ export interface WizardSession {
      */
     resumeTarget?: WizardResumeTarget | null;
     consents: WizardConsents | null;
+    /** Estado del correo del cliente en el paso 01. Ausente en sesiones anteriores al correo. */
+    emailState?: EmailStateEnum;
+    /** Tipo del correo: personal o corporativo. */
+    emailType?: EmailTypeEnum;
+    /** Correo enmascarado (`ju•••••@gmail.com`); viaja siempre que la sesión tenga correo. */
+    emailMasked?: string;
+    /** Correo completo: solo con `emailState` CAPTURED, porque lo tecleó el vendedor. */
+    email?: string;
     /** Espejo del estado KYC (fuente = customer). */
     kycStatus: string | null;
     kycModality: KycModality | null;

package/bin/retailWizard/dtos/requests/SendEmailOtpRequest.d.ts

@@ -0,0 +1,6 @@
+import { EmailTypeEnum } from '../../../emailVerification/enums/EmailTypeEnum';
+/** POST /wizard/sessions/:id/email/otp/send — manda el código al correo que capturó el vendedor. */
+export declare class SendEmailOtpRequest {
+    email: string;
+    type: EmailTypeEnum;
+}

package/bin/retailWizard/dtos/requests/SendEmailOtpRequest.js

@@ -0,0 +1,29 @@
+"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.SendEmailOtpRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const EmailTypeEnum_1 = require("../../../emailVerification/enums/EmailTypeEnum");
+/** POST /wizard/sessions/:id/email/otp/send — manda el código al correo que capturó el vendedor. */
+class SendEmailOtpRequest {
+}
+exports.SendEmailOtpRequest = SendEmailOtpRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEmail)(),
+    __metadata("design:type", String)
+], SendEmailOtpRequest.prototype, "email", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(EmailTypeEnum_1.EmailTypeEnum),
+    __metadata("design:type", String)
+], SendEmailOtpRequest.prototype, "type", void 0);

package/bin/retailWizard/dtos/requests/VerifyEmailOtpRequest.d.ts

@@ -0,0 +1,4 @@
+/** POST /wizard/sessions/:id/email/otp/verify — verifica el código que llegó al correo. */
+export declare class VerifyEmailOtpRequest {
+    code: string;
+}

package/bin/retailWizard/dtos/requests/VerifyEmailOtpRequest.js

@@ -0,0 +1,24 @@
+"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.VerifyEmailOtpRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** POST /wizard/sessions/:id/email/otp/verify — verifica el código que llegó al correo. */
+class VerifyEmailOtpRequest {
+}
+exports.VerifyEmailOtpRequest = VerifyEmailOtpRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(4, 8),
+    __metadata("design:type", String)
+], VerifyEmailOtpRequest.prototype, "code", void 0);

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

@@ -0,0 +1,9 @@
+/**
+ * Correo de la sesión del wizard: EXISTING = ya verificado en contacts; CAPTURED = lo tecleó el
+ * vendedor y se verificó con OTP; PENDING = falta capturarlo o verificarlo.
+ */
+export declare enum EmailStateEnum {
+    EXISTING = "EXISTING",
+    CAPTURED = "CAPTURED",
+    PENDING = "PENDING"
+}

package/bin/retailWizard/enums/EmailStateEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailStateEnum = void 0;
+/**
+ * Correo de la sesión del wizard: EXISTING = ya verificado en contacts; CAPTURED = lo tecleó el
+ * vendedor y se verificó con OTP; PENDING = falta capturarlo o verificarlo.
+ */
+var EmailStateEnum;
+(function (EmailStateEnum) {
+    EmailStateEnum["EXISTING"] = "EXISTING";
+    EmailStateEnum["CAPTURED"] = "CAPTURED";
+    EmailStateEnum["PENDING"] = "PENDING";
+})(EmailStateEnum || (exports.EmailStateEnum = EmailStateEnum = {}));

package/bin/retailWizard/index.d.ts

@@ -26,6 +26,7 @@ export * from './enums/BlockedCategoryEnum';
 export * from './enums/WizardLineStatusEnum';
 export * from './enums/LinePaymentTypeEnum';
 export * from './enums/WizardLineRoleEnum';
+export * from './enums/EmailStateEnum';
 export * from './dtos/WizardConsents';
 export * from './dtos/WizardPayment';
 export * from './dtos/WizardProduct';
@@ -90,6 +91,8 @@ export * from './dtos/requests/SignatureSignRequest';
 export * from './dtos/requests/RegisterDeviceRequest';
 export * from './dtos/requests/CompleteSaleRequest';
 export * from './dtos/requests/SuggestIdentifiersQuery';
+export * from './dtos/requests/SendEmailOtpRequest';
+export * from './dtos/requests/VerifyEmailOtpRequest';
 export * from './dtos/responses/KycPrepareResponse';
 export * from './dtos/responses/ProofOfAddressPrepareResponse';
 export * from './dtos/responses/SessionFinanciersResponse';

package/bin/retailWizard/index.js

@@ -45,6 +45,7 @@ __exportStar(require("./enums/BlockedCategoryEnum"), exports);
 __exportStar(require("./enums/WizardLineStatusEnum"), exports);
 __exportStar(require("./enums/LinePaymentTypeEnum"), exports);
 __exportStar(require("./enums/WizardLineRoleEnum"), exports);
+__exportStar(require("./enums/EmailStateEnum"), exports);
 // DTOs anidados
 __exportStar(require("./dtos/WizardConsents"), exports);
 __exportStar(require("./dtos/WizardPayment"), exports);
@@ -115,6 +116,8 @@ __exportStar(require("./dtos/requests/SignatureSignRequest"), exports);
 __exportStar(require("./dtos/requests/RegisterDeviceRequest"), exports);
 __exportStar(require("./dtos/requests/CompleteSaleRequest"), exports);
 __exportStar(require("./dtos/requests/SuggestIdentifiersQuery"), exports);
+__exportStar(require("./dtos/requests/SendEmailOtpRequest"), exports);
+__exportStar(require("./dtos/requests/VerifyEmailOtpRequest"), exports);
 // Response DTOs (output tipado por endpoint)
 __exportStar(require("./dtos/responses/KycPrepareResponse"), exports);
 __exportStar(require("./dtos/responses/ProofOfAddressPrepareResponse"), exports);

package/package.json

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

package/src/emailVerification/dtos/EmailSetTrustedRequest.ts

@@ -1,5 +1,5 @@
 import { Expose } from 'class-transformer';
-import { IsEmail, IsEnum, IsString } from 'class-validator';
+import { IsBoolean, IsEmail, IsEnum, IsOptional, IsString } from 'class-validator';
 import { EmailTypeEnum } from '../enums/EmailTypeEnum';
 
 /**
@@ -18,4 +18,10 @@ export class EmailSetTrustedRequest {
     @Expose()
     @IsEnum(EmailTypeEnum)
     type!: EmailTypeEnum;
+
+    /** En true, el correo queda como principal del directorio. Sin el campo, no cambia el principal. */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    isPrincipal?: boolean;
 }

package/src/retailWizard/dtos/WizardSession.ts

@@ -15,6 +15,8 @@ import type { WizardReservedLine } from './WizardReservedLine';
 import type { WizardResumeTarget } from './WizardResumeTarget';
 import type { WizardWelcome } from './WizardWelcome';
 import type { WizardCreditPromotionBonus } from './WizardCreditPromotionBonus';
+import type { EmailStateEnum } from '../enums/EmailStateEnum';
+import type { EmailTypeEnum } from '../../emailVerification/enums/EmailTypeEnum';
 
 /** Modalidad de captura del KYC (M1 §213-329). */
 export type KycModality = 'CUSTOMER_LINK' | 'STORE_DEVICE' | 'MANUAL';
@@ -68,6 +70,14 @@ export interface WizardSession {
    */
   resumeTarget?: WizardResumeTarget | null;
   consents: WizardConsents | null;
+  /** Estado del correo del cliente en el paso 01. Ausente en sesiones anteriores al correo. */
+  emailState?: EmailStateEnum;
+  /** Tipo del correo: personal o corporativo. */
+  emailType?: EmailTypeEnum;
+  /** Correo enmascarado (`ju•••••@gmail.com`); viaja siempre que la sesión tenga correo. */
+  emailMasked?: string;
+  /** Correo completo: solo con `emailState` CAPTURED, porque lo tecleó el vendedor. */
+  email?: string;
   /** Espejo del estado KYC (fuente = customer). */
   kycStatus: string | null;
   kycModality: KycModality | null;

package/src/retailWizard/dtos/requests/SendEmailOtpRequest.ts

@@ -0,0 +1,14 @@
+import { Expose } from 'class-transformer';
+import { IsEmail, IsEnum } from 'class-validator';
+import { EmailTypeEnum } from '../../../emailVerification/enums/EmailTypeEnum';
+
+/** POST /wizard/sessions/:id/email/otp/send — manda el código al correo que capturó el vendedor. */
+export class SendEmailOtpRequest {
+  @Expose()
+  @IsEmail()
+  email!: string;
+
+  @Expose()
+  @IsEnum(EmailTypeEnum)
+  type!: EmailTypeEnum;
+}

package/src/retailWizard/dtos/requests/VerifyEmailOtpRequest.ts

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { IsString, Length } from 'class-validator';
+
+/** POST /wizard/sessions/:id/email/otp/verify — verifica el código que llegó al correo. */
+export class VerifyEmailOtpRequest {
+  @Expose()
+  @IsString()
+  @Length(4, 8)
+  code!: string;
+}

package/src/retailWizard/enums/EmailStateEnum.ts

@@ -0,0 +1,9 @@
+/**
+ * Correo de la sesión del wizard: EXISTING = ya verificado en contacts; CAPTURED = lo tecleó el
+ * vendedor y se verificó con OTP; PENDING = falta capturarlo o verificarlo.
+ */
+export enum EmailStateEnum {
+    EXISTING = 'EXISTING',
+    CAPTURED = 'CAPTURED',
+    PENDING = 'PENDING',
+}

package/src/retailWizard/index.ts

@@ -29,6 +29,7 @@ export * from './enums/BlockedCategoryEnum';
 export * from './enums/WizardLineStatusEnum';
 export * from './enums/LinePaymentTypeEnum';
 export * from './enums/WizardLineRoleEnum';
+export * from './enums/EmailStateEnum';
 
 // DTOs anidados
 export * from './dtos/WizardConsents';
@@ -101,6 +102,8 @@ export * from './dtos/requests/SignatureSignRequest';
 export * from './dtos/requests/RegisterDeviceRequest';
 export * from './dtos/requests/CompleteSaleRequest';
 export * from './dtos/requests/SuggestIdentifiersQuery';
+export * from './dtos/requests/SendEmailOtpRequest';
+export * from './dtos/requests/VerifyEmailOtpRequest';
 
 // Response DTOs (output tipado por endpoint)
 export * from './dtos/responses/KycPrepareResponse';