@fiado/type-kit 3.118.0 → 3.119.0

package/src/messagesConnector/dtos/TemplateMessageUpdateRequest.ts

@@ -1,39 +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;
-}
+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/dtos/VerifyOtpRequest.ts

@@ -1,12 +1,12 @@
-import { Expose } from 'class-transformer';
-import { IsNotEmpty, IsString } from 'class-validator';
-
-export class VerifyOtpRequest {
-    // directoryId NO se valida como @IsUUID: los cognitoSub de los pools backoffice son UUID v7
-    // (nibble de versión = 7), que class-validator @IsUUID() (v1-5) rechaza → el verify de OTP
-    // tiraba 400 "directoryId must be a UUID" para TODOS esos users. El SEND
-    // (NotificationQueueMessageRequestV2.directoryId) ya usa @IsString — esto lo deja consistente.
-    @Expose() @IsString() @IsNotEmpty() directoryId!: string;
-    @Expose() @IsString() @IsNotEmpty() typeOfDirectoryId!: string;
-    @Expose() @IsString() @IsNotEmpty() message!: string;
-}
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsString } from 'class-validator';
+
+export class VerifyOtpRequest {
+    // directoryId NO se valida como @IsUUID: los cognitoSub de los pools backoffice son UUID v7
+    // (nibble de versión = 7), que class-validator @IsUUID() (v1-5) rechaza → el verify de OTP
+    // tiraba 400 "directoryId must be a UUID" para TODOS esos users. El SEND
+    // (NotificationQueueMessageRequestV2.directoryId) ya usa @IsString — esto lo deja consistente.
+    @Expose() @IsString() @IsNotEmpty() directoryId!: string;
+    @Expose() @IsString() @IsNotEmpty() typeOfDirectoryId!: string;
+    @Expose() @IsString() @IsNotEmpty() message!: string;
+}

package/src/messagesConnector/dtos/VerifyOtpResponse.ts

@@ -1,5 +1,5 @@
-export class VerifyOtpResponse {
-    verified!: boolean;
-    directoryId!: string;
-    typeOfDirectoryId!: string;
-}
+export class VerifyOtpResponse {
+    verified!: boolean;
+    directoryId!: string;
+    typeOfDirectoryId!: string;
+}

package/src/messagesConnector/enums/DeliveryChannelExtendedEnum.ts

@@ -1,5 +1,5 @@
-export enum DeliveryChannelExtendedEnum {
-    SMS = 'SMS',
-    MAIL = 'MAIL',
-    PUSH_NOTIFICATION = 'PUSH_NOTIFICATION',
-}
+export enum DeliveryChannelExtendedEnum {
+    SMS = 'SMS',
+    MAIL = 'MAIL',
+    PUSH_NOTIFICATION = 'PUSH_NOTIFICATION',
+}

package/src/messagesConnector/index.ts

@@ -1,19 +1,19 @@
-export * from './enums/DeliveryChannelExtendedEnum';
-export * from './validators/IsStringValueRecord';
-export * from './dtos/NotificationQueueMessageRequestV2';
-export * from './dtos/SendMessageRequest';
-export * from './dtos/SendMessageResponse';
-export * from './dtos/VerifyOtpRequest';
-export * from './dtos/VerifyOtpResponse';
-export * from './dtos/OtpValidatedResponse';
-export * from './dtos/NotificationResponse';
-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';
+export * from './enums/DeliveryChannelExtendedEnum';
+export * from './validators/IsStringValueRecord';
+export * from './dtos/NotificationQueueMessageRequestV2';
+export * from './dtos/SendMessageRequest';
+export * from './dtos/SendMessageResponse';
+export * from './dtos/VerifyOtpRequest';
+export * from './dtos/VerifyOtpResponse';
+export * from './dtos/OtpValidatedResponse';
+export * from './dtos/NotificationResponse';
+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/IsStringValueRecord.ts

@@ -1,12 +1,12 @@
-import { ValidatorConstraint, ValidatorConstraintInterface, ValidationArguments } from 'class-validator';
-
-@ValidatorConstraint({ name: 'IsStringValueRecord', async: false })
-export class IsStringValueRecord implements ValidatorConstraintInterface {
-    validate(value: unknown, _args: ValidationArguments): boolean {
-        if (!value || typeof value !== 'object') return false;
-        return Object.values(value as Record<string, unknown>).every(v => typeof v === 'string');
-    }
-    defaultMessage(_args: ValidationArguments): string {
-        return 'All values in variables must be strings';
-    }
-}
+import { ValidatorConstraint, ValidatorConstraintInterface, ValidationArguments } from 'class-validator';
+
+@ValidatorConstraint({ name: 'IsStringValueRecord', async: false })
+export class IsStringValueRecord implements ValidatorConstraintInterface {
+    validate(value: unknown, _args: ValidationArguments): boolean {
+        if (!value || typeof value !== 'object') return false;
+        return Object.values(value as Record<string, unknown>).every(v => typeof v === 'string');
+    }
+    defaultMessage(_args: ValidationArguments): string {
+        return 'All values in variables must be strings';
+    }
+}

package/src/messagesConnector/validators/IsTemplatePlaceholders.ts

@@ -1,45 +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_]*`;
-    }
-}
+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/messaging/dtos/MessageDeliveryRequest.ts

@@ -1,29 +1,29 @@
-import { Expose } from 'class-transformer';
-import { IsEnum, Validate, ValidateIf } from 'class-validator';
-import { DeliveryChannelEnum } from '../enums/DeliveryChannelEnum';
-import { ContentTypeEnum } from '../enums/ContentTypeEnum';
-import { IsDestinationByChannel } from '../validators/IsDestinationByChannel';
-import { IsNotBlank } from '../validators/IsNotBlank';
-
-export class MessageDeliveryRequest {
-    @Expose()
-    @IsEnum(DeliveryChannelEnum)
-    deliveryChannel: DeliveryChannelEnum;
-
-    @Expose()
-    @Validate(IsDestinationByChannel)
-    destination: string;
-
-    @Expose()
-    @ValidateIf(o => o.deliveryChannel === DeliveryChannelEnum.MAIL)
-    @Validate(IsNotBlank)
-    subject: string;
-
-    @Expose()
-    @Validate(IsNotBlank)
-    message: string;
-
-    @Expose()
-    @IsEnum(ContentTypeEnum)
-    contentType: ContentTypeEnum;
-}
+import { Expose } from 'class-transformer';
+import { IsEnum, Validate, ValidateIf } from 'class-validator';
+import { DeliveryChannelEnum } from '../enums/DeliveryChannelEnum';
+import { ContentTypeEnum } from '../enums/ContentTypeEnum';
+import { IsDestinationByChannel } from '../validators/IsDestinationByChannel';
+import { IsNotBlank } from '../validators/IsNotBlank';
+
+export class MessageDeliveryRequest {
+    @Expose()
+    @IsEnum(DeliveryChannelEnum)
+    deliveryChannel: DeliveryChannelEnum;
+
+    @Expose()
+    @Validate(IsDestinationByChannel)
+    destination: string;
+
+    @Expose()
+    @ValidateIf(o => o.deliveryChannel === DeliveryChannelEnum.MAIL)
+    @Validate(IsNotBlank)
+    subject: string;
+
+    @Expose()
+    @Validate(IsNotBlank)
+    message: string;
+
+    @Expose()
+    @IsEnum(ContentTypeEnum)
+    contentType: ContentTypeEnum;
+}

package/src/messaging/dtos/MessageDeliveryResponse.ts

@@ -1,6 +1,6 @@
-import { DeliveryChannelEnum } from '../enums/DeliveryChannelEnum';
-
-export class MessageDeliveryResponse {
-    messageId: string;
-    channel: DeliveryChannelEnum;
-}
+import { DeliveryChannelEnum } from '../enums/DeliveryChannelEnum';
+
+export class MessageDeliveryResponse {
+    messageId: string;
+    channel: DeliveryChannelEnum;
+}

package/src/messaging/enums/ContentTypeEnum.ts

@@ -1,4 +1,4 @@
-export enum ContentTypeEnum {
-    TEXT = 'TEXT',
-    HTML = 'HTML',
-}
+export enum ContentTypeEnum {
+    TEXT = 'TEXT',
+    HTML = 'HTML',
+}

package/src/messaging/enums/DeliveryChannelEnum.ts

@@ -1,4 +1,4 @@
-export enum DeliveryChannelEnum {
-    SMS = 'SMS',
-    MAIL = 'MAIL',
-}
+export enum DeliveryChannelEnum {
+    SMS = 'SMS',
+    MAIL = 'MAIL',
+}

package/src/messaging/index.ts

@@ -1,6 +1,6 @@
-export * from './enums/DeliveryChannelEnum';
-export * from './enums/ContentTypeEnum';
-export * from './validators/IsDestinationByChannel';
-export * from './validators/IsNotBlank';
-export * from './dtos/MessageDeliveryRequest';
-export * from './dtos/MessageDeliveryResponse';
+export * from './enums/DeliveryChannelEnum';
+export * from './enums/ContentTypeEnum';
+export * from './validators/IsDestinationByChannel';
+export * from './validators/IsNotBlank';
+export * from './dtos/MessageDeliveryRequest';
+export * from './dtos/MessageDeliveryResponse';

package/src/messaging/validators/IsDestinationByChannel.ts

@@ -1,61 +1,61 @@
-import { ValidatorConstraint, ValidatorConstraintInterface, ValidationArguments } from 'class-validator';
-import { DeliveryChannelEnum } from '../enums/DeliveryChannelEnum';
-
-/**
- * Valida que `destination` matchee el formato correcto segun el `deliveryChannel`
- * declarado en el mismo DTO.
- *
- * Por que un custom validator en lugar de dos `@ValidateIf` + `@IsEmail`/`@Matches`:
- * - `@ValidateIf` afecta a **toda la propiedad**, no solo a los decoradores que
- *   vienen despues. Cuando se ponen dos `@ValidateIf` consecutivos sobre la
- *   misma propiedad, el segundo sobrescribe al primero y class-validator
- *   ignora silenciosamente los validators afectados.
- * - Originalmente descubierto en `sns-ses-connector/tests/RUN_LOG.md` T7/T10/T11
- *   (2026-05-21) — la version anterior del DTO dejaba pasar
- *   `destination: "12345"` con canal SMS y `destination: "no-es-email"` con
- *   canal MAIL. Validator migrado del connector al type-kit en 3.29.0 para
- *   eliminar el DTO_LOCAL del connector y exponer la regla a todos los
- *   callers de `MessageDeliveryRequest`.
- *
- * Reglas:
- * - Canal `SMS` → `destination` debe matchear E.164: `^\+\d{10,15}$`
- * - Canal `MAIL` → `destination` debe matchear formato email
- * - Canal invalido o ausente → falla (el `@IsEnum` del DTO genera su propio mensaje aparte)
- * - String vacio o whitespace → falla
- *
- * Uso tipico:
- * ```ts
- *   @Validate(IsDestinationByChannel)
- *   destination: string;
- * ```
- */
-const E164_REGEX = /^\+\d{10,15}$/;
-const EMAIL_REGEX = /^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}$/;
-
-@ValidatorConstraint({ name: 'IsDestinationByChannel', async: false })
-export class IsDestinationByChannel implements ValidatorConstraintInterface {
-    validate(value: unknown, args: ValidationArguments): boolean {
-        if (typeof value !== 'string' || value.trim().length === 0) return false;
-
-        const obj = args.object as { deliveryChannel?: unknown };
-        const channel = obj.deliveryChannel;
-
-        if (channel === DeliveryChannelEnum.SMS) return E164_REGEX.test(value);
-        if (channel === DeliveryChannelEnum.MAIL) return EMAIL_REGEX.test(value);
-
-        return false;
-    }
-
-    defaultMessage(args: ValidationArguments): string {
-        const obj = args.object as { deliveryChannel?: unknown };
-        const channel = obj.deliveryChannel;
-
-        if (channel === DeliveryChannelEnum.SMS) {
-            return 'destination debe ser un telefono en formato E.164 (ej. +5215512345678) para canal SMS';
-        }
-        if (channel === DeliveryChannelEnum.MAIL) {
-            return 'destination debe ser un email valido para canal MAIL';
-        }
-        return 'destination requerido y debe corresponder al deliveryChannel';
-    }
-}
+import { ValidatorConstraint, ValidatorConstraintInterface, ValidationArguments } from 'class-validator';
+import { DeliveryChannelEnum } from '../enums/DeliveryChannelEnum';
+
+/**
+ * Valida que `destination` matchee el formato correcto segun el `deliveryChannel`
+ * declarado en el mismo DTO.
+ *
+ * Por que un custom validator en lugar de dos `@ValidateIf` + `@IsEmail`/`@Matches`:
+ * - `@ValidateIf` afecta a **toda la propiedad**, no solo a los decoradores que
+ *   vienen despues. Cuando se ponen dos `@ValidateIf` consecutivos sobre la
+ *   misma propiedad, el segundo sobrescribe al primero y class-validator
+ *   ignora silenciosamente los validators afectados.
+ * - Originalmente descubierto en `sns-ses-connector/tests/RUN_LOG.md` T7/T10/T11
+ *   (2026-05-21) — la version anterior del DTO dejaba pasar
+ *   `destination: "12345"` con canal SMS y `destination: "no-es-email"` con
+ *   canal MAIL. Validator migrado del connector al type-kit en 3.29.0 para
+ *   eliminar el DTO_LOCAL del connector y exponer la regla a todos los
+ *   callers de `MessageDeliveryRequest`.
+ *
+ * Reglas:
+ * - Canal `SMS` → `destination` debe matchear E.164: `^\+\d{10,15}$`
+ * - Canal `MAIL` → `destination` debe matchear formato email
+ * - Canal invalido o ausente → falla (el `@IsEnum` del DTO genera su propio mensaje aparte)
+ * - String vacio o whitespace → falla
+ *
+ * Uso tipico:
+ * ```ts
+ *   @Validate(IsDestinationByChannel)
+ *   destination: string;
+ * ```
+ */
+const E164_REGEX = /^\+\d{10,15}$/;
+const EMAIL_REGEX = /^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}$/;
+
+@ValidatorConstraint({ name: 'IsDestinationByChannel', async: false })
+export class IsDestinationByChannel implements ValidatorConstraintInterface {
+    validate(value: unknown, args: ValidationArguments): boolean {
+        if (typeof value !== 'string' || value.trim().length === 0) return false;
+
+        const obj = args.object as { deliveryChannel?: unknown };
+        const channel = obj.deliveryChannel;
+
+        if (channel === DeliveryChannelEnum.SMS) return E164_REGEX.test(value);
+        if (channel === DeliveryChannelEnum.MAIL) return EMAIL_REGEX.test(value);
+
+        return false;
+    }
+
+    defaultMessage(args: ValidationArguments): string {
+        const obj = args.object as { deliveryChannel?: unknown };
+        const channel = obj.deliveryChannel;
+
+        if (channel === DeliveryChannelEnum.SMS) {
+            return 'destination debe ser un telefono en formato E.164 (ej. +5215512345678) para canal SMS';
+        }
+        if (channel === DeliveryChannelEnum.MAIL) {
+            return 'destination debe ser un email valido para canal MAIL';
+        }
+        return 'destination requerido y debe corresponder al deliveryChannel';
+    }
+}

package/src/messaging/validators/IsNotBlank.ts

@@ -1,31 +1,31 @@
-import { ValidatorConstraint, ValidatorConstraintInterface, ValidationArguments } from 'class-validator';
-
-/**
- * Valida que el valor sea un string con al menos un caracter no-whitespace.
- *
- * Por que no usar `@IsNotEmpty()` de class-validator:
- * - `@IsNotEmpty()` solo rechaza `""`, `null`, `undefined`, `false`, `0`.
- * - **No** rechaza strings de solo whitespace (`"   "`).
- *
- * En el sns-ses-connector eso era un bug latente: un `message: "   "` pasaba la
- * validacion, llegaba al SDK de SNS/SES, y se enviaba un SMS o email con
- * contenido vacio al usuario final (y AWS cobraba). Originalmente descubierto
- * en `sns-ses-connector/tests/RUN_LOG.md` T8b (2026-05-21). Validator migrado
- * al type-kit en 3.29.0 para eliminar el DTO_LOCAL del connector.
- *
- * Uso tipico:
- * ```ts
- *   @Validate(IsNotBlank)
- *   message: string;
- * ```
- */
-@ValidatorConstraint({ name: 'IsNotBlank', async: false })
-export class IsNotBlank implements ValidatorConstraintInterface {
-    validate(value: unknown, _args: ValidationArguments): boolean {
-        return typeof value === 'string' && value.trim().length > 0;
-    }
-
-    defaultMessage(args: ValidationArguments): string {
-        return `${args.property} no puede ser vacio ni solo espacios en blanco`;
-    }
-}
+import { ValidatorConstraint, ValidatorConstraintInterface, ValidationArguments } from 'class-validator';
+
+/**
+ * Valida que el valor sea un string con al menos un caracter no-whitespace.
+ *
+ * Por que no usar `@IsNotEmpty()` de class-validator:
+ * - `@IsNotEmpty()` solo rechaza `""`, `null`, `undefined`, `false`, `0`.
+ * - **No** rechaza strings de solo whitespace (`"   "`).
+ *
+ * En el sns-ses-connector eso era un bug latente: un `message: "   "` pasaba la
+ * validacion, llegaba al SDK de SNS/SES, y se enviaba un SMS o email con
+ * contenido vacio al usuario final (y AWS cobraba). Originalmente descubierto
+ * en `sns-ses-connector/tests/RUN_LOG.md` T8b (2026-05-21). Validator migrado
+ * al type-kit en 3.29.0 para eliminar el DTO_LOCAL del connector.
+ *
+ * Uso tipico:
+ * ```ts
+ *   @Validate(IsNotBlank)
+ *   message: string;
+ * ```
+ */
+@ValidatorConstraint({ name: 'IsNotBlank', async: false })
+export class IsNotBlank implements ValidatorConstraintInterface {
+    validate(value: unknown, _args: ValidationArguments): boolean {
+        return typeof value === 'string' && value.trim().length > 0;
+    }
+
+    defaultMessage(args: ValidationArguments): string {
+        return `${args.property} no puede ser vacio ni solo espacios en blanco`;
+    }
+}

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

@@ -1,24 +1,24 @@
-/**
- * Forma completa de un Milestone tal como lo persiste y devuelve el lambda
- * `milestone-business`. Es la representación canónica del item de la tabla DDB
- * `Milestones` expuesta a consumers server-to-server (api-invoker).
- *
- * `value` es metadata libre asociada al evento (objeto de forma variable).
- * `createdAt` / `updatedAt` son epoch ms (Dynamoose `timestamps: true`).
- */
-export interface Milestone {
-    /** Identificador único del milestone. Determinístico: `${directoryId}#${eventKey}`. */
-    id: string;
-    /** directoryId del usuario al que pertenece el evento. */
-    directoryId: string;
-    /** Fecha en la que ocurrió el evento (epoch en milisegundos). */
-    eventDate: number;
-    /** Llave que identifica el tipo de evento/milestone. */
-    eventKey: string;
-    /** Metadata libre asociada al milestone (objeto con forma variable). */
-    value?: Record<string, unknown>;
-    /** Epoch ms de creación (Dynamoose timestamps). */
-    createdAt?: number;
-    /** Epoch ms de última actualización (Dynamoose timestamps). */
-    updatedAt?: number;
-}
+/**
+ * Forma completa de un Milestone tal como lo persiste y devuelve el lambda
+ * `milestone-business`. Es la representación canónica del item de la tabla DDB
+ * `Milestones` expuesta a consumers server-to-server (api-invoker).
+ *
+ * `value` es metadata libre asociada al evento (objeto de forma variable).
+ * `createdAt` / `updatedAt` son epoch ms (Dynamoose `timestamps: true`).
+ */
+export interface Milestone {
+    /** Identificador único del milestone. Determinístico: `${directoryId}#${eventKey}`. */
+    id: string;
+    /** directoryId del usuario al que pertenece el evento. */
+    directoryId: string;
+    /** Fecha en la que ocurrió el evento (epoch en milisegundos). */
+    eventDate: number;
+    /** Llave que identifica el tipo de evento/milestone. */
+    eventKey: string;
+    /** Metadata libre asociada al milestone (objeto con forma variable). */
+    value?: Record<string, unknown>;
+    /** Epoch ms de creación (Dynamoose timestamps). */
+    createdAt?: number;
+    /** Epoch ms de última actualización (Dynamoose timestamps). */
+    updatedAt?: number;
+}