@fiado/type-kit 3.99.1 → 3.99.2

package/src/emailVerification/dtos/EmailVerificationResendRequest.ts

@@ -0,0 +1,15 @@
+import { Expose } from 'class-transformer';
+import { IsEmail, IsString } from 'class-validator';
+
+/**
+ * Body para reenviar el correo de verificación de un email ya iniciado.
+ */
+export class EmailVerificationResendRequest {
+    @Expose()
+    @IsString()
+    directoryId!: string;
+
+    @Expose()
+    @IsEmail()
+    email!: string;
+}

package/src/emailVerification/dtos/EmailVerificationResendResponse.ts

@@ -0,0 +1,13 @@
+import { Expose } from 'class-transformer';
+import { EmailVerificationStatusEnum } from '../enums/EmailVerificationStatusEnum';
+
+/**
+ * Respuesta al reenviar el correo de verificación.
+ */
+export class EmailVerificationResendResponse {
+    @Expose()
+    verificationId!: string;
+
+    @Expose()
+    status!: EmailVerificationStatusEnum;
+}

package/src/emailVerification/dtos/EmailVerificationStartRequest.ts

@@ -0,0 +1,17 @@
+import { Expose } from 'class-transformer';
+import { IsEmail, IsString } from 'class-validator';
+
+/**
+ * Body para iniciar la verificación de un email asociado a un directorio.
+ * `directoryId` es @IsString (NO @IsUUID): el cognitoSub de backoffice es UUID v7
+ * y rompe la validación @IsUUID de class-validator.
+ */
+export class EmailVerificationStartRequest {
+    @Expose()
+    @IsString()
+    directoryId!: string;
+
+    @Expose()
+    @IsEmail()
+    email!: string;
+}

package/src/emailVerification/dtos/EmailVerificationStartResponse.ts

@@ -0,0 +1,16 @@
+import { Expose } from 'class-transformer';
+import { EmailVerificationStatusEnum } from '../enums/EmailVerificationStatusEnum';
+
+/**
+ * Respuesta al iniciar la verificación de un email.
+ */
+export class EmailVerificationStartResponse {
+    @Expose()
+    verificationId!: string;
+
+    @Expose()
+    email!: string;
+
+    @Expose()
+    status!: EmailVerificationStatusEnum;
+}

package/src/emailVerification/dtos/EmailVerificationStatusRequest.ts

@@ -0,0 +1,15 @@
+import { Expose } from 'class-transformer';
+import { IsEmail, IsString } from 'class-validator';
+
+/**
+ * Body para consultar el estado de verificación de un email.
+ */
+export class EmailVerificationStatusRequest {
+    @Expose()
+    @IsString()
+    directoryId!: string;
+
+    @Expose()
+    @IsEmail()
+    email!: string;
+}

package/src/emailVerification/dtos/EmailVerificationStatusResponse.ts

@@ -0,0 +1,19 @@
+import { Expose } from 'class-transformer';
+import { EmailVerificationStatusEnum } from '../enums/EmailVerificationStatusEnum';
+
+/**
+ * Estado de verificación de un email puntual de un directorio.
+ */
+export class EmailVerificationStatusResponse {
+    @Expose()
+    email!: string;
+
+    @Expose()
+    status!: EmailVerificationStatusEnum;
+
+    @Expose()
+    isVerified!: boolean;
+
+    @Expose()
+    isPrincipal!: boolean;
+}

package/src/emailVerification/dtos/internal/EmailsByDirectoryRequest.ts

@@ -0,0 +1,11 @@
+import { Expose } from 'class-transformer';
+import { IsString } from 'class-validator';
+
+/**
+ * Request interno (api-invoker) para listar todos los emails de un directorio.
+ */
+export class EmailsByDirectoryRequest {
+    @Expose()
+    @IsString()
+    directoryId!: string;
+}

package/src/emailVerification/dtos/internal/EmailsByDirectoryResponse.ts

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { EmailItem } from '../EmailItem';
+
+/**
+ * Lista interna de emails de un directorio. Reutiliza el EmailItem público.
+ */
+export class EmailsByDirectoryResponse {
+    @Expose()
+    items!: EmailItem[];
+}

package/src/emailVerification/dtos/internal/PrimaryEmailByDirectoryRequest.ts

@@ -0,0 +1,12 @@
+import { Expose } from 'class-transformer';
+import { IsString } from 'class-validator';
+
+/**
+ * Request interno (api-invoker) para obtener el email principal de un directorio.
+ * `directoryId` es @IsString (cognitoSub UUID v7 — no usar @IsUUID).
+ */
+export class PrimaryEmailByDirectoryRequest {
+    @Expose()
+    @IsString()
+    directoryId!: string;
+}

package/src/emailVerification/dtos/internal/PrimaryEmailResponse.ts

@@ -0,0 +1,16 @@
+import { Expose } from 'class-transformer';
+
+/**
+ * Email principal de un directorio. `email` es null si el directorio todavía
+ * no tiene un email principal definido.
+ */
+export class PrimaryEmailResponse {
+    @Expose()
+    directoryId!: string;
+
+    @Expose()
+    email!: string | null;
+
+    @Expose()
+    isVerified!: boolean;
+}

package/src/emailVerification/enums/EmailVerificationStatusEnum.ts

@@ -0,0 +1,15 @@
+/**
+ * Estado del flujo de verificación de un email asociado a un directorio.
+ * PENDING: creado, todavía no se envió el correo.
+ * SENT: correo de verificación enviado.
+ * VERIFIED: el usuario confirmó el email vía el link.
+ * EXPIRED: el token de verificación venció sin confirmarse.
+ * FAILED: el envío o la verificación falló de forma terminal.
+ */
+export enum EmailVerificationStatusEnum {
+    PENDING = 'PENDING',
+    SENT = 'SENT',
+    VERIFIED = 'VERIFIED',
+    EXPIRED = 'EXPIRED',
+    FAILED = 'FAILED',
+}

package/src/emailVerification/index.ts

@@ -0,0 +1,18 @@
+export * from './enums/EmailVerificationStatusEnum';
+export * from './dtos/EmailVerificationStartRequest';
+export * from './dtos/EmailVerificationStartResponse';
+export * from './dtos/EmailVerificationResendRequest';
+export * from './dtos/EmailVerificationResendResponse';
+export * from './dtos/EmailVerificationStatusRequest';
+export * from './dtos/EmailVerificationStatusResponse';
+export * from './dtos/EmailItem';
+export * from './dtos/EmailListResponse';
+export * from './dtos/EmailSetPrincipalRequest';
+export * from './dtos/EmailSetPrincipalResponse';
+export * from './dtos/EmailDeleteRequest';
+export * from './dtos/EmailDeleteResponse';
+export * from './dtos/EmailConfirmRequest';
+export * from './dtos/internal/PrimaryEmailByDirectoryRequest';
+export * from './dtos/internal/PrimaryEmailResponse';
+export * from './dtos/internal/EmailsByDirectoryRequest';
+export * from './dtos/internal/EmailsByDirectoryResponse';

package/src/index.ts

@@ -88,5 +88,6 @@ export * as TotpSecurity from './totpSecurity';
 // NetworkConnector: módulo del lambda fiado-network-business (Access Card / Digital Business Card).
 // Contiene DTOs y enums para perfiles, leads, lead groups y fotos.
 export * as NetworkConnector from './networkConnector';
+export * as EmailVerification from './emailVerification';
 export * from './messaging';
 export * from './complaint';