@fiado/type-kit 3.30.0 → 3.32.0

package/src/legal-documents-business/index.ts

@@ -1,6 +1,6 @@
-export * from './dtos/DirectoryAcceptanceRequest';
-export * from './dtos/LegalDocumentResponse';
-export * from './dtos/LegalDocumentCreateRequest';
-export * from './dtos/UpdateLegalDocumentRequest';
-
-
+export * from './dtos/DirectoryAcceptanceRequest';
+export * from './dtos/LegalDocumentResponse';
+export * from './dtos/LegalDocumentCreateRequest';
+export * from './dtos/UpdateLegalDocumentRequest';
+
+

package/src/messagesConnector/dtos/TemplateMessageCreateRequest.ts

@@ -0,0 +1,51 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsNotEmpty, IsOptional, IsString, Validate } from 'class-validator';
+import { ContentTypeEnum, DeliveryChannelEnum } from '../../messaging';
+import { IsTemplatePlaceholders } from '../validators/IsTemplatePlaceholders';
+
+/**
+ * Body para POST /templates (backoffice). Identifica un template por sus 4
+ * componentes de PK (messageType, channelType, language, country) + campos
+ * de contenido. `typeOfDirectoryId` es campo no-key del Row (ver TD pendiente).
+ */
+export class TemplateMessageCreateRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    messageType!: string;
+
+    @Expose()
+    @IsEnum(DeliveryChannelEnum)
+    channelType!: DeliveryChannelEnum;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    language!: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    country!: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    typeOfDirectoryId!: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @Validate(IsTemplatePlaceholders)
+    template!: string;
+
+    @Expose()
+    @IsEnum(ContentTypeEnum)
+    contentType!: ContentTypeEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @Validate(IsTemplatePlaceholders)
+    subject?: string;
+}

package/src/messagesConnector/dtos/TemplateMessageListFiltersRequest.ts

@@ -0,0 +1,47 @@
+import { Expose, Type } from 'class-transformer';
+import { IsEnum, IsInt, IsOptional, IsString, Max, Min } from 'class-validator';
+import { DeliveryChannelEnum } from '../../messaging';
+
+/**
+ * Query string de GET /templates. Todos los filtros son opcionales; si todos
+ * estan vacios, lista todo (scan paginado). `limit` default 20, max 100.
+ */
+export class TemplateMessageListFiltersRequest {
+    @Expose()
+    @IsOptional()
+    @IsString()
+    messageType?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsEnum(DeliveryChannelEnum)
+    channelType?: DeliveryChannelEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    language?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    country?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    typeOfDirectoryId?: string;
+
+    @Expose()
+    @IsOptional()
+    @Type(() => Number)
+    @IsInt()
+    @Min(1)
+    @Max(100)
+    limit?: number;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    cursor?: string;
+}

package/src/messagesConnector/dtos/TemplateMessageListResponse.ts

@@ -0,0 +1,16 @@
+import { Expose, Type } from 'class-transformer';
+import { TemplateMessageResponse } from './TemplateMessageResponse';
+
+/**
+ * Forma del response de GET /templates (list con filtros + paginacion cursor).
+ * `cursor` es opaco (base64 del LastEvaluatedKey de DDB) y el cliente lo pasa
+ * tal cual al siguiente GET. Si no hay mas paginas, se omite.
+ */
+export class TemplateMessageListResponse {
+    @Expose()
+    @Type(() => TemplateMessageResponse)
+    items!: TemplateMessageResponse[];
+
+    @Expose()
+    cursor?: string;
+}

package/src/messagesConnector/dtos/TemplateMessageResponse.ts

@@ -0,0 +1,52 @@
+import { Expose } from 'class-transformer';
+import { ContentTypeEnum, DeliveryChannelEnum } from '../../messaging';
+
+/**
+ * Forma del template retornada por GET /templates/{id}, POST, PUT.
+ * El `id` es opaco (base64url de la PK compuesta) y el cliente lo trata como
+ * string sin parsear. El `pk` se incluye para auditoria/debug pero NO se usa
+ * como identificador del recurso en otras llamadas.
+ */
+export class TemplateMessageResponse {
+    @Expose()
+    id!: string;
+
+    @Expose()
+    pk!: string;
+
+    @Expose()
+    messageType!: string;
+
+    @Expose()
+    channelType!: DeliveryChannelEnum;
+
+    @Expose()
+    language!: string;
+
+    @Expose()
+    country!: string;
+
+    @Expose()
+    typeOfDirectoryId!: string;
+
+    @Expose()
+    template!: string;
+
+    @Expose()
+    contentType!: ContentTypeEnum;
+
+    @Expose()
+    subject?: string;
+
+    @Expose()
+    createdAt!: number;
+
+    @Expose()
+    updatedAt!: number;
+
+    @Expose()
+    createdBy?: string;
+
+    @Expose()
+    updatedBy?: string;
+}

package/src/messagesConnector/dtos/TemplateMessageUpdateRequest.ts

@@ -0,0 +1,39 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsNotEmpty, IsOptional, IsString, Validate } from 'class-validator';
+import { ContentTypeEnum } from '../../messaging';
+import { IsTemplatePlaceholders } from '../validators/IsTemplatePlaceholders';
+
+/**
+ * Body para PUT /templates/{id} (backoffice). Solo campos no-key son mutables.
+ * Los componentes del PK (messageType, channelType, language, country) viven
+ * en el `{id}` opaco del path y NO se aceptan en el body (PK structurally
+ * immutable - ver spec seccion "Mutabilidad PK").
+ *
+ * La validacion cross-field (subject required ⇔ MAIL, HTML solo en MAIL) se
+ * hace en el manager con el channelType decodificado del path, no aca.
+ */
+export class TemplateMessageUpdateRequest {
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    typeOfDirectoryId?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @Validate(IsTemplatePlaceholders)
+    template?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsEnum(ContentTypeEnum)
+    contentType?: ContentTypeEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @Validate(IsTemplatePlaceholders)
+    subject?: string;
+}

package/src/messagesConnector/index.ts

@@ -9,3 +9,9 @@ export * from './dtos/NotificationsPageResponse';
 export * from './dtos/NotificationsCursorResponse';
 export * from './dtos/NotificationsV3Response';
 export * from './dtos/MessagesByDestinationResponse';
+export * from './validators/IsTemplatePlaceholders';
+export * from './dtos/TemplateMessageCreateRequest';
+export * from './dtos/TemplateMessageUpdateRequest';
+export * from './dtos/TemplateMessageResponse';
+export * from './dtos/TemplateMessageListResponse';
+export * from './dtos/TemplateMessageListFiltersRequest';

package/src/messagesConnector/validators/IsTemplatePlaceholders.ts

@@ -0,0 +1,45 @@
+import { ValidatorConstraint, ValidatorConstraintInterface, ValidationArguments } from 'class-validator';
+
+const VALID_PLACEHOLDER = /^[a-zA-Z][a-zA-Z0-9_]*$/;
+
+/**
+ * Valida que un string solo contenga placeholders bien formados `{varName}` donde
+ * `varName` matchea `^[a-zA-Z][a-zA-Z0-9_]*$`. Rechaza:
+ *  - Placeholders con espacios o caracteres invalidos (`{var name}`, `{var-1}`).
+ *  - Llaves sin balancear (`abc {def`, `abc } def`, `{ {nested}` ).
+ *  - Placeholders vacios (`{}`).
+ * Acepta texto sin placeholders en absoluto.
+ *
+ * Uso en DTOs: `@Validate(IsTemplatePlaceholders)` sobre un campo string.
+ */
+@ValidatorConstraint({ name: 'IsTemplatePlaceholders', async: false })
+export class IsTemplatePlaceholders implements ValidatorConstraintInterface {
+    validate(value: unknown): boolean {
+        if (typeof value !== 'string') return false;
+
+        // Detectar llaves desbalanceadas con un single-pass.
+        let depth = 0;
+        for (const ch of value) {
+            if (ch === '{') {
+                if (depth > 0) return false; // anidado no permitido
+                depth = 1;
+            } else if (ch === '}') {
+                if (depth === 0) return false; // cierre sin apertura
+                depth = 0;
+            }
+        }
+        if (depth !== 0) return false; // apertura sin cierre
+
+        // Validar que cada `{...}` matchea el regex.
+        const matches = value.match(/\{([^}]*)\}/g) ?? [];
+        for (const raw of matches) {
+            const inner = raw.slice(1, -1);
+            if (!VALID_PLACEHOLDER.test(inner)) return false;
+        }
+        return true;
+    }
+
+    defaultMessage(args: ValidationArguments): string {
+        return `${args.property} contiene placeholders mal formados; debe seguir el patron {nombre} con nombre = [a-zA-Z][a-zA-Z0-9_]*`;
+    }
+}

package/src/milestone-business/dtos/MilestonesByEventKeyDateRangeParams.ts

@@ -1,9 +1,9 @@
-export interface MilestonesByEventKeyDateRangeParams {
-    /** Inicio del rango de eventDate. Acepta epoch ms o ISO/yyyy-mm-dd. */
-    startDate: string | number;
-    /** Fin del rango de eventDate. Acepta epoch ms o ISO/yyyy-mm-dd. */
-    endDate: string | number;
-    pageSize?: number | string;
-    index?: string;
-    sort?: 'ascending' | 'descending';
-}
+export interface MilestonesByEventKeyDateRangeParams {
+    /** Inicio del rango de eventDate. Acepta epoch ms o ISO/yyyy-mm-dd. */
+    startDate: string | number;
+    /** Fin del rango de eventDate. Acepta epoch ms o ISO/yyyy-mm-dd. */
+    endDate: string | number;
+    pageSize?: number | string;
+    index?: string;
+    sort?: 'ascending' | 'descending';
+}

package/src/milestone-business/index.ts

@@ -1,2 +1,2 @@
-// dtos
-export { MilestonesByEventKeyDateRangeParams } from "./dtos/MilestonesByEventKeyDateRangeParams";
+// dtos
+export { MilestonesByEventKeyDateRangeParams } from "./dtos/MilestonesByEventKeyDateRangeParams";

package/src/notificationMessages/dtos/NotificationQueueMessageRequest.ts

@@ -1,8 +1,8 @@
-import {QueueMessageDestination} from "./QueueMessageDestination";
-
-export class NotificationQueueMessageRequest {
-    templateId: string; // Nombre de la plantilla de mensaje a enviar
-    broadcast?: boolean; // Si el mensaje es masivo o no (a todos los dispositivos registrados)
-    destinations: QueueMessageDestination[]; // Grupo de destinos (directory y variables)
-    data?: any; // Informacion adicional a enviar al destino
+import {QueueMessageDestination} from "./QueueMessageDestination";
+
+export class NotificationQueueMessageRequest {
+    templateId: string; // Nombre de la plantilla de mensaje a enviar
+    broadcast?: boolean; // Si el mensaje es masivo o no (a todos los dispositivos registrados)
+    destinations: QueueMessageDestination[]; // Grupo de destinos (directory y variables)
+    data?: any; // Informacion adicional a enviar al destino
 }

package/src/notificationMessages/dtos/NotificationTemplate.ts

@@ -1,31 +1,31 @@
-import {Expose, Transform} from "class-transformer";
-import { NotificationTypeEnum } from "../enums/NotificationType";
-
-export const NO_DATA: string = "NO_DATA";
-export class NotificationTemplate {
-    @Expose()
-    id: string;
-
-    @Expose()
-    notificationType: NotificationTypeEnum;
-
-    @Expose()
-    @Transform(({value}) => value === null || true)
-    userNotification: boolean;
-
-    @Expose()
-    @Transform(({value}) => !value || value.trim().length === 0 ? NO_DATA : value)
-    title: string | null;
-
-    @Expose()
-    @Transform(({value}) => !value || value.trim().length === 0 ? NO_DATA : value)
-    body: string | null;
-
-    @Expose()
-    @Transform(({value}) => !value || value.trim().length === 0 ? NO_DATA : value)
-    imageUrl: string | null;
-
-    @Expose()
-    @Transform(({value}) => value ?? [])
-    templateVariables: string[] | [];
+import {Expose, Transform} from "class-transformer";
+import { NotificationTypeEnum } from "../enums/NotificationType";
+
+export const NO_DATA: string = "NO_DATA";
+export class NotificationTemplate {
+    @Expose()
+    id: string;
+
+    @Expose()
+    notificationType: NotificationTypeEnum;
+
+    @Expose()
+    @Transform(({value}) => value === null || true)
+    userNotification: boolean;
+
+    @Expose()
+    @Transform(({value}) => !value || value.trim().length === 0 ? NO_DATA : value)
+    title: string | null;
+
+    @Expose()
+    @Transform(({value}) => !value || value.trim().length === 0 ? NO_DATA : value)
+    body: string | null;
+
+    @Expose()
+    @Transform(({value}) => !value || value.trim().length === 0 ? NO_DATA : value)
+    imageUrl: string | null;
+
+    @Expose()
+    @Transform(({value}) => value ?? [])
+    templateVariables: string[] | [];
 }

package/src/notificationMessages/dtos/QueueMessageDestination.ts

@@ -1,7 +1,7 @@
-import {QueueMessageVariableValues} from "./QueueMessageVariableValues";
-
-export class QueueMessageDestination {
-    directoryId: string;
-    templateVariables?: QueueMessageVariableValues[];
-    data?: any;
+import {QueueMessageVariableValues} from "./QueueMessageVariableValues";
+
+export class QueueMessageDestination {
+    directoryId: string;
+    templateVariables?: QueueMessageVariableValues[];
+    data?: any;
 }

package/src/notificationMessages/dtos/QueueMessageVariableValues.ts

@@ -1,4 +1,4 @@
-export class QueueMessageVariableValues {
-    key: string;
-    value: string;
+export class QueueMessageVariableValues {
+    key: string;
+    value: string;
 }

package/src/notificationMessages/enums/NotificationId.ts

@@ -1,14 +1,14 @@
-
-
-
-export enum NotificationId {
-
-    ISSUED_ACCOUNT_USA = "ISSUED_ACCOUNT_USA",      //Mesnaje de apertura de cuentas y tarjeta USA
-    ISSUED_ACCOUNT_MEX = "ISSUED_ACCOUNT_MEX",      //Mesnaje de apertura de cuentas y tarjeta MEX
-    ONB_ERROR_VALID_DOCUMENT = "ONB_ERROR_VALID_DOCUMENT",  // Mensaje cuando el resultado del onboarding es error en la validación del documento
-    ONB_ERROR_FACEMATCH = "ONB_ERROR_FACEMATCH",   //  Mensaje cuando el resultado del onboarding es error porque no hace match en video selfie con el documento
-
-
-
-
+
+
+
+export enum NotificationId {
+
+    ISSUED_ACCOUNT_USA = "ISSUED_ACCOUNT_USA",      //Mesnaje de apertura de cuentas y tarjeta USA
+    ISSUED_ACCOUNT_MEX = "ISSUED_ACCOUNT_MEX",      //Mesnaje de apertura de cuentas y tarjeta MEX
+    ONB_ERROR_VALID_DOCUMENT = "ONB_ERROR_VALID_DOCUMENT",  // Mensaje cuando el resultado del onboarding es error en la validación del documento
+    ONB_ERROR_FACEMATCH = "ONB_ERROR_FACEMATCH",   //  Mensaje cuando el resultado del onboarding es error porque no hace match en video selfie con el documento
+
+
+
+
 }

package/src/notificationMessages/enums/NotificationType.ts

@@ -1,5 +1,5 @@
-export enum NotificationTypeEnum {
-    SYSTEM_NOTIFICATION = "SYSTEM_NOTIFICATION",
-    STATIC_NOTIFICATION = "STATIC_NOTIFICATION",
-    DYNAMIC_NOTIFICATION = "DYNAMIC_NOTIFICATION"
+export enum NotificationTypeEnum {
+    SYSTEM_NOTIFICATION = "SYSTEM_NOTIFICATION",
+    STATIC_NOTIFICATION = "STATIC_NOTIFICATION",
+    DYNAMIC_NOTIFICATION = "DYNAMIC_NOTIFICATION"
 }

package/src/notificationMessages/index.ts

@@ -1,8 +1,8 @@
-export * from './dtos/NotificationQueueMessageRequest';
-export * from './dtos/QueueMessageDestination';
-export * from './dtos/QueueMessageVariableValues';
-export * from './dtos/NotificationTemplate';
-
-
-export * from "./enums/NotificationId";
+export * from './dtos/NotificationQueueMessageRequest';
+export * from './dtos/QueueMessageDestination';
+export * from './dtos/QueueMessageVariableValues';
+export * from './dtos/NotificationTemplate';
+
+
+export * from "./enums/NotificationId";
 export * from "./enums/NotificationType";

package/src/notificationWS/dtos/NotificationWSQueueMessageRequest.ts

@@ -1,7 +1,7 @@
-
-export class NotificationWSQueueMessageRequest<T> {
-    type: string; // Nombre de la plantilla de mensaje a enviar
-    destinations?: string[]; // Grupo de destinos (directory y variables)
-    roles?: string[]; // Roles de usuarios a notificar
-    metadata?: T; // Informacion adicional a enviar al destino
+
+export class NotificationWSQueueMessageRequest<T> {
+    type: string; // Nombre de la plantilla de mensaje a enviar
+    destinations?: string[]; // Grupo de destinos (directory y variables)
+    roles?: string[]; // Roles de usuarios a notificar
+    metadata?: T; // Informacion adicional a enviar al destino
 }

package/src/observations/dtos/ObservationCreateRequest.ts

@@ -1,31 +1,31 @@
-
-
-import { IsEnum, IsOptional, IsString } from 'class-validator';
-import { ObservationStatus } from '../enums/ObservationStatus';
-
-export class ObservationCreateRequest {
-
-  @IsString()
-  tableName: string;
-
-  @IsString()
-  relatedId: string;
-
-  @IsString()
-  comment: string;
-
-  @IsString()
-  tag: string;
-
-  @IsString()
-  userId: string;
-
-  @IsOptional()
-  @IsEnum(ObservationStatus)
-  status: ObservationStatus;
-
-  @IsOptional()
-  @IsString()
-  assignedTo?: string;
-
-}
+
+
+import { IsEnum, IsOptional, IsString } from 'class-validator';
+import { ObservationStatus } from '../enums/ObservationStatus';
+
+export class ObservationCreateRequest {
+
+  @IsString()
+  tableName: string;
+
+  @IsString()
+  relatedId: string;
+
+  @IsString()
+  comment: string;
+
+  @IsString()
+  tag: string;
+
+  @IsString()
+  userId: string;
+
+  @IsOptional()
+  @IsEnum(ObservationStatus)
+  status: ObservationStatus;
+
+  @IsOptional()
+  @IsString()
+  assignedTo?: string;
+
+}

package/src/observations/dtos/ObservationStatusUpdateRequest.ts

@@ -1,16 +1,16 @@
-import { IsEnum, IsNotEmpty, IsString } from "class-validator";
-import { ObservationStatus } from "../enums/ObservationStatus";
-
-export class ObservationStatusUpdateRequest {
-    @IsString()
-    @IsNotEmpty()
-    id: string;
-
-    @IsEnum(ObservationStatus)
-    @IsNotEmpty()
-    status: ObservationStatus;
-
-    @IsString()
-    @IsNotEmpty()
-    updatedBy: string;
-}
+import { IsEnum, IsNotEmpty, IsString } from "class-validator";
+import { ObservationStatus } from "../enums/ObservationStatus";
+
+export class ObservationStatusUpdateRequest {
+    @IsString()
+    @IsNotEmpty()
+    id: string;
+
+    @IsEnum(ObservationStatus)
+    @IsNotEmpty()
+    status: ObservationStatus;
+
+    @IsString()
+    @IsNotEmpty()
+    updatedBy: string;
+}

package/src/observations/enums/ObservationStatus.ts

@@ -1,13 +1,13 @@
-
-
-export enum ObservationStatus {
-    PENDING_REVIEW = 'PENDING_REVIEW',           // Comentario nuevo que aún no ha sido revisado
-    UNDER_INVESTIGATION = 'UNDER_INVESTIGATION', // Requiere atención y se está revisando
-    ACTION_REQUIRED = 'ACTION_REQUIRED',         // Se confirmó que requiere acción por parte del equipo
-    RESOLVED = 'RESOLVED',                       // Ya se atendió y resolvió
-    NO_ACTION_NEEDED = 'NO_ACTION_NEEDED',       // Se revisó pero no requiere acción
-    ESCALATED = 'ESCALATED',                     // Se escaló a otro equipo
-    DUPLICATE = 'DUPLICATE',                     // Comentario duplicado de otro ya existente
-    INVALID = 'INVALID',                         // Comentario irrelevante, erróneo o fuera de contexto
-    CLOSED = 'CLOSED'                            // Cerrado manualmente (usado cuando no aplica otro estado)
+
+
+export enum ObservationStatus {
+    PENDING_REVIEW = 'PENDING_REVIEW',           // Comentario nuevo que aún no ha sido revisado
+    UNDER_INVESTIGATION = 'UNDER_INVESTIGATION', // Requiere atención y se está revisando
+    ACTION_REQUIRED = 'ACTION_REQUIRED',         // Se confirmó que requiere acción por parte del equipo
+    RESOLVED = 'RESOLVED',                       // Ya se atendió y resolvió
+    NO_ACTION_NEEDED = 'NO_ACTION_NEEDED',       // Se revisó pero no requiere acción
+    ESCALATED = 'ESCALATED',                     // Se escaló a otro equipo
+    DUPLICATE = 'DUPLICATE',                     // Comentario duplicado de otro ya existente
+    INVALID = 'INVALID',                         // Comentario irrelevante, erróneo o fuera de contexto
+    CLOSED = 'CLOSED'                            // Cerrado manualmente (usado cuando no aplica otro estado)
 }

package/src/observations/index.ts

@@ -1,8 +1,8 @@
-
-//dtos 
-export * from './dtos/ObservationCreateRequest';
-export * from './dtos/ObservationStatusUpdateRequest';
-
-
-//enums
+
+//dtos 
+export * from './dtos/ObservationCreateRequest';
+export * from './dtos/ObservationStatusUpdateRequest';
+
+
+//enums
 export * from './enums/ObservationStatus';

package/src/p2pContact/dtos/CreateP2pContactRequest.ts

@@ -1,11 +1,11 @@
-import {CountryId} from "../../country";
-import { Provider } from "../../provider";
-
-export class CreateP2pContactRequest {
-    nickname: string;
-    countryId: CountryId;
-    isDeleted: boolean;
-    directoryId: string;
-    directoryIdOfNickname: string;
-    provider:Provider;
+import {CountryId} from "../../country";
+import { Provider } from "../../provider";
+
+export class CreateP2pContactRequest {
+    nickname: string;
+    countryId: CountryId;
+    isDeleted: boolean;
+    directoryId: string;
+    directoryIdOfNickname: string;
+    provider:Provider;
 }