@fiado/type-kit 3.410.0 → 3.411.0

package/_test_/unit/messagesConnector/NotificationQueueMessageRequestV2.test.ts

@@ -0,0 +1,49 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { NotificationQueueMessageRequestV2 } from '../../../src/messagesConnector/dtos/NotificationQueueMessageRequestV2';
+import { NotificationOriginEnum } from '../../../src/messagesConnector/enums/NotificationOriginEnum';
+import { DeliveryChannelExtendedEnum } from '../../../src/messagesConnector/enums/DeliveryChannelExtendedEnum';
+
+const base = {
+    templateId: 'OTP_CODE',
+    channelType: DeliveryChannelExtendedEnum.SMS,
+    language: 'es',
+    country: 'MX',
+    typeOfDirectoryId: 'PHONE',
+    directoryId: '4422194128',
+    destination: '4422194128',
+    variables: { code: '123456' },
+};
+
+const errorsOn = async (payload: Record<string, unknown>, property: string) => {
+    const dto = plainToInstance(NotificationQueueMessageRequestV2, { ...base, ...payload });
+    const errors = await validate(dto);
+    return errors.filter((e) => e.property === property);
+};
+
+/**
+ * Candado: `origin` NO lleva default en el DTO. Un default borraria la diferencia
+ * entre "no vino" y "vino EVENT", y platform-rbac-business, el unico productor real
+ * hoy, no manda el campo.
+ */
+describe('NotificationQueueMessageRequestV2.origin', () => {
+    it('acepta los tres valores del enum', async () => {
+        expect(await errorsOn({ origin: NotificationOriginEnum.MANUAL }, 'origin')).toHaveLength(0);
+        expect(await errorsOn({ origin: NotificationOriginEnum.TEST }, 'origin')).toHaveLength(0);
+        expect(await errorsOn({ origin: NotificationOriginEnum.EVENT }, 'origin')).toHaveLength(0);
+    });
+
+    it('sigue siendo valido cuando el productor no lo manda', async () => {
+        expect(await errorsOn({}, 'origin')).toHaveLength(0);
+    });
+
+    it('no se rellena solo: ausente queda undefined, no EVENT', async () => {
+        const dto = plainToInstance(NotificationQueueMessageRequestV2, base);
+        expect(dto.origin).toBeUndefined();
+    });
+
+    it('rechaza un valor fuera del enum', async () => {
+        expect(await errorsOn({ origin: 'CRON' }, 'origin')).not.toHaveLength(0);
+    });
+});

package/_test_/unit/messagesConnector/TemplateMessageUpdateRequest.test.ts

@@ -0,0 +1,51 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { TemplateMessageUpdateRequest } from '../../../src/messagesConnector/dtos/TemplateMessageUpdateRequest';
+
+/**
+ * Candado: sin `providerTemplateId` ni `slotVariables` en el PUT, una plantilla de
+ * WhatsApp se puede crear pero no corregir, y arreglar un contentSid o un slot mal
+ * cargado obliga a DELETE + POST.
+ */
+const errorsOn = async (payload: Record<string, unknown>, property: string) => {
+    const dto = plainToInstance(TemplateMessageUpdateRequest, payload);
+    const errors = await validate(dto);
+    return errors.filter((e) => e.property === property);
+};
+
+describe('TemplateMessageUpdateRequest.providerTemplateId', () => {
+    it('acepta un contentSid HX de Twilio', async () => {
+        expect(await errorsOn({ providerTemplateId: 'HX1234567890abcdef' }, 'providerTemplateId')).toHaveLength(0);
+    });
+
+    it('es opcional: el PUT que no toca WhatsApp no lo manda', async () => {
+        expect(await errorsOn({ template: 'Hola {{name}}' }, 'providerTemplateId')).toHaveLength(0);
+    });
+
+    it('rechaza un valor que no es string', async () => {
+        expect(await errorsOn({ providerTemplateId: 12345 }, 'providerTemplateId')).not.toHaveLength(0);
+    });
+});
+
+describe('TemplateMessageUpdateRequest.slotVariables', () => {
+    it('acepta el arreglo de nombres de variable por slot', async () => {
+        expect(await errorsOn({ slotVariables: ['code', 'expiresIn'] }, 'slotVariables')).toHaveLength(0);
+    });
+
+    it('acepta el arreglo vacio (plantilla sin slots)', async () => {
+        expect(await errorsOn({ slotVariables: [] }, 'slotVariables')).toHaveLength(0);
+    });
+
+    it('es opcional: el PUT que no toca WhatsApp no lo manda', async () => {
+        expect(await errorsOn({ template: 'Hola {{name}}' }, 'slotVariables')).toHaveLength(0);
+    });
+
+    it('rechaza un valor que no es arreglo', async () => {
+        expect(await errorsOn({ slotVariables: 'code' }, 'slotVariables')).not.toHaveLength(0);
+    });
+
+    it('rechaza los elementos que no son string', async () => {
+        expect(await errorsOn({ slotVariables: ['code', 7] }, 'slotVariables')).not.toHaveLength(0);
+    });
+});

package/bin/messagesConnector/dtos/NotificationQueueMessageRequestV2.d.ts

@@ -1,5 +1,8 @@
 import { DeliveryChannelExtendedEnum } from '../enums/DeliveryChannelExtendedEnum';
+import { NotificationOriginEnum } from '../enums/NotificationOriginEnum';
 export declare class NotificationQueueMessageRequestV2 {
+    /** Tenant emisor del mensaje. Si se omite, messages-business asume FIADO. */
+    tenantId?: string;
     templateId: string;
     channelType: DeliveryChannelExtendedEnum;
     language: string;
@@ -10,4 +13,6 @@ export declare class NotificationQueueMessageRequestV2 {
     variables: Record<string, string>;
     referenceMessageId?: string;
     data?: unknown;
+    /** Quien disparo la notificacion. Sin default: su ausencia ya significa EVENT. */
+    origin?: NotificationOriginEnum;
 }

package/bin/messagesConnector/dtos/NotificationQueueMessageRequestV2.js

@@ -13,10 +13,17 @@ exports.NotificationQueueMessageRequestV2 = void 0;
 const class_validator_1 = require("class-validator");
 const class_transformer_1 = require("class-transformer");
 const DeliveryChannelExtendedEnum_1 = require("../enums/DeliveryChannelExtendedEnum");
+const NotificationOriginEnum_1 = require("../enums/NotificationOriginEnum");
 const IsStringValueRecord_1 = require("../validators/IsStringValueRecord");
 class NotificationQueueMessageRequestV2 {
 }
 exports.NotificationQueueMessageRequestV2 = NotificationQueueMessageRequestV2;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], NotificationQueueMessageRequestV2.prototype, "tenantId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
@@ -75,3 +82,9 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     __metadata("design:type", Object)
 ], NotificationQueueMessageRequestV2.prototype, "data", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(NotificationOriginEnum_1.NotificationOriginEnum),
+    __metadata("design:type", String)
+], NotificationQueueMessageRequestV2.prototype, "origin", void 0);

package/bin/messagesConnector/dtos/TemplateMessageCreateRequest.d.ts

@@ -1,16 +1,23 @@
-import { ContentTypeEnum, DeliveryChannelEnum } from '../../messaging';
+import { ContentTypeEnum } from '../../messaging';
+import { DeliveryChannelExtendedEnum } from '../enums/DeliveryChannelExtendedEnum';
 /**
- * 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).
+ * Body para POST /templates (backoffice). Identifica un template por sus 5
+ * componentes de PK (tenantId, messageType, channelType, language, country) +
+ * campos de contenido. `typeOfDirectoryId` es campo no-key del Row (ver TD pendiente).
  */
 export declare class TemplateMessageCreateRequest {
+    /** Tenant al que pertenece la plantilla. Si se omite, se asume FIADO. */
+    tenantId?: string;
     messageType: string;
-    channelType: DeliveryChannelEnum;
+    channelType: DeliveryChannelExtendedEnum;
     language: string;
     country: string;
     typeOfDirectoryId: string;
     template: string;
     contentType: ContentTypeEnum;
     subject?: string;
+    /** contentSid HX de Twilio. Solo en plantillas de WhatsApp. */
+    providerTemplateId?: string;
+    /** Que variable va en cada slot posicional de Twilio. Solo en plantillas de WhatsApp. */
+    slotVariables?: string[];
 }

package/bin/messagesConnector/dtos/TemplateMessageCreateRequest.js

@@ -13,15 +13,22 @@ exports.TemplateMessageCreateRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const messaging_1 = require("../../messaging");
+const DeliveryChannelExtendedEnum_1 = require("../enums/DeliveryChannelExtendedEnum");
 const IsTemplatePlaceholders_1 = require("../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).
+ * Body para POST /templates (backoffice). Identifica un template por sus 5
+ * componentes de PK (tenantId, messageType, channelType, language, country) +
+ * campos de contenido. `typeOfDirectoryId` es campo no-key del Row (ver TD pendiente).
  */
 class TemplateMessageCreateRequest {
 }
 exports.TemplateMessageCreateRequest = TemplateMessageCreateRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], TemplateMessageCreateRequest.prototype, "tenantId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
@@ -30,7 +37,7 @@ __decorate([
 ], TemplateMessageCreateRequest.prototype, "messageType", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsEnum)(messaging_1.DeliveryChannelEnum),
+    (0, class_validator_1.IsEnum)(DeliveryChannelExtendedEnum_1.DeliveryChannelExtendedEnum),
     __metadata("design:type", String)
 ], TemplateMessageCreateRequest.prototype, "channelType", void 0);
 __decorate([
@@ -70,3 +77,16 @@ __decorate([
     (0, class_validator_1.Validate)(IsTemplatePlaceholders_1.IsTemplatePlaceholders),
     __metadata("design:type", String)
 ], TemplateMessageCreateRequest.prototype, "subject", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], TemplateMessageCreateRequest.prototype, "providerTemplateId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], TemplateMessageCreateRequest.prototype, "slotVariables", void 0);

package/bin/messagesConnector/dtos/TemplateMessageListFiltersRequest.d.ts

@@ -1,11 +1,13 @@
-import { DeliveryChannelEnum } from '../../messaging';
+import { DeliveryChannelExtendedEnum } from '../enums/DeliveryChannelExtendedEnum';
 /**
  * Query string de GET /templates. Todos los filtros son opcionales; si todos
  * estan vacios, lista todo (scan paginado). `limit` default 20, max 100.
  */
 export declare class TemplateMessageListFiltersRequest {
+    /** Filtra por tenant. Si se omite, no filtra por tenant. */
+    tenantId?: string;
     messageType?: string;
-    channelType?: DeliveryChannelEnum;
+    channelType?: DeliveryChannelExtendedEnum;
     language?: string;
     country?: string;
     typeOfDirectoryId?: string;

package/bin/messagesConnector/dtos/TemplateMessageListFiltersRequest.js

@@ -12,7 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TemplateMessageListFiltersRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
-const messaging_1 = require("../../messaging");
+const DeliveryChannelExtendedEnum_1 = require("../enums/DeliveryChannelExtendedEnum");
 /**
  * Query string de GET /templates. Todos los filtros son opcionales; si todos
  * estan vacios, lista todo (scan paginado). `limit` default 20, max 100.
@@ -20,6 +20,12 @@ const messaging_1 = require("../../messaging");
 class TemplateMessageListFiltersRequest {
 }
 exports.TemplateMessageListFiltersRequest = TemplateMessageListFiltersRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], TemplateMessageListFiltersRequest.prototype, "tenantId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
@@ -29,7 +35,7 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsEnum)(messaging_1.DeliveryChannelEnum),
+    (0, class_validator_1.IsEnum)(DeliveryChannelExtendedEnum_1.DeliveryChannelExtendedEnum),
     __metadata("design:type", String)
 ], TemplateMessageListFiltersRequest.prototype, "channelType", void 0);
 __decorate([

package/bin/messagesConnector/dtos/TemplateMessageResponse.d.ts

@@ -1,4 +1,5 @@
-import { ContentTypeEnum, DeliveryChannelEnum } from '../../messaging';
+import { ContentTypeEnum } from '../../messaging';
+import { DeliveryChannelExtendedEnum } from '../enums/DeliveryChannelExtendedEnum';
 /**
  * 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
@@ -8,14 +9,20 @@ import { ContentTypeEnum, DeliveryChannelEnum } from '../../messaging';
 export declare class TemplateMessageResponse {
     id: string;
     pk: string;
+    /** Tenant al que pertenece la plantilla. Ausente en las plantillas legacy de FIADO. */
+    tenantId?: string;
     messageType: string;
-    channelType: DeliveryChannelEnum;
+    channelType: DeliveryChannelExtendedEnum;
     language: string;
     country: string;
     typeOfDirectoryId: string;
     template: string;
     contentType: ContentTypeEnum;
     subject?: string;
+    /** contentSid HX de Twilio. Solo en plantillas de WhatsApp. */
+    providerTemplateId?: string;
+    /** Que variable va en cada slot posicional de Twilio. Solo en plantillas de WhatsApp. */
+    slotVariables?: string[];
     createdAt: number;
     updatedAt: number;
     createdBy?: string;

package/bin/messagesConnector/dtos/TemplateMessageResponse.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TemplateMessageResponse = void 0;
 const class_transformer_1 = require("class-transformer");
 const messaging_1 = require("../../messaging");
+const DeliveryChannelExtendedEnum_1 = require("../enums/DeliveryChannelExtendedEnum");
 /**
  * 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
@@ -29,6 +30,10 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", String)
 ], TemplateMessageResponse.prototype, "pk", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], TemplateMessageResponse.prototype, "tenantId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", String)
@@ -61,6 +66,14 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", String)
 ], TemplateMessageResponse.prototype, "subject", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], TemplateMessageResponse.prototype, "providerTemplateId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Array)
+], TemplateMessageResponse.prototype, "slotVariables", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", Number)

package/bin/messagesConnector/dtos/TemplateMessageUpdateRequest.d.ts

@@ -1,7 +1,7 @@
 import { ContentTypeEnum } from '../../messaging';
 /**
  * Body para PUT /templates/{id} (backoffice). Solo campos no-key son mutables.
- * Los componentes del PK (messageType, channelType, language, country) viven
+ * Los componentes del PK (tenantId, 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").
  *
@@ -13,4 +13,8 @@ export declare class TemplateMessageUpdateRequest {
     template?: string;
     contentType?: ContentTypeEnum;
     subject?: string;
+    /** contentSid HX de Twilio. Solo en plantillas de WhatsApp. */
+    providerTemplateId?: string;
+    /** Que variable va en cada slot posicional de Twilio. Solo en plantillas de WhatsApp. */
+    slotVariables?: string[];
 }

package/bin/messagesConnector/dtos/TemplateMessageUpdateRequest.js

@@ -16,7 +16,7 @@ const messaging_1 = require("../../messaging");
 const IsTemplatePlaceholders_1 = require("../validators/IsTemplatePlaceholders");
 /**
  * Body para PUT /templates/{id} (backoffice). Solo campos no-key son mutables.
- * Los componentes del PK (messageType, channelType, language, country) viven
+ * Los componentes del PK (tenantId, 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").
  *
@@ -54,3 +54,16 @@ __decorate([
     (0, class_validator_1.Validate)(IsTemplatePlaceholders_1.IsTemplatePlaceholders),
     __metadata("design:type", String)
 ], TemplateMessageUpdateRequest.prototype, "subject", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], TemplateMessageUpdateRequest.prototype, "providerTemplateId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], TemplateMessageUpdateRequest.prototype, "slotVariables", void 0);

package/bin/messagesConnector/enums/NotificationOriginEnum.d.ts

@@ -0,0 +1,9 @@
+/** Quien disparo la notificacion. Su ausencia significa EVENT. */
+export declare enum NotificationOriginEnum {
+    /** Un admin lo disparo a mano desde el backoffice. */
+    MANUAL = "MANUAL",
+    /** Envio de prueba del editor de plantillas, a un solo destinatario. */
+    TEST = "TEST",
+    /** Lo publico un productor del ciclo de vida. */
+    EVENT = "EVENT"
+}

package/bin/messagesConnector/enums/NotificationOriginEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationOriginEnum = void 0;
+/** Quien disparo la notificacion. Su ausencia significa EVENT. */
+var NotificationOriginEnum;
+(function (NotificationOriginEnum) {
+    /** Un admin lo disparo a mano desde el backoffice. */
+    NotificationOriginEnum["MANUAL"] = "MANUAL";
+    /** Envio de prueba del editor de plantillas, a un solo destinatario. */
+    NotificationOriginEnum["TEST"] = "TEST";
+    /** Lo publico un productor del ciclo de vida. */
+    NotificationOriginEnum["EVENT"] = "EVENT";
+})(NotificationOriginEnum || (exports.NotificationOriginEnum = NotificationOriginEnum = {}));

package/bin/messagesConnector/index.d.ts

@@ -1,4 +1,5 @@
 export * from './enums/DeliveryChannelExtendedEnum';
+export * from './enums/NotificationOriginEnum';
 export * from './validators/IsStringValueRecord';
 export * from './dtos/NotificationQueueMessageRequestV2';
 export * from './dtos/SendMessageRequest';

package/bin/messagesConnector/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./enums/DeliveryChannelExtendedEnum"), exports);
+__exportStar(require("./enums/NotificationOriginEnum"), exports);
 __exportStar(require("./validators/IsStringValueRecord"), exports);
 __exportStar(require("./dtos/NotificationQueueMessageRequestV2"), exports);
 __exportStar(require("./dtos/SendMessageRequest"), exports);

package/bin/messaging/dtos/MessageDeliveryRequest.d.ts

@@ -6,4 +6,9 @@ export declare class MessageDeliveryRequest {
     subject: string;
     message: string;
     contentType: ContentTypeEnum;
+    /**
+     * Remitente ya resuelto: direccion From de SES para MAIL, sender ID de SNS para SMS.
+     * Si se omite, el connector usa su remitente por defecto.
+     */
+    sender?: string;
 }

package/bin/messaging/dtos/MessageDeliveryRequest.js

@@ -45,3 +45,9 @@ __decorate([
     (0, class_validator_1.IsEnum)(ContentTypeEnum_1.ContentTypeEnum),
     __metadata("design:type", String)
 ], MessageDeliveryRequest.prototype, "contentType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], MessageDeliveryRequest.prototype, "sender", void 0);

package/bin/twilioConnector/dtos/SelectedProvider.d.ts

@@ -13,7 +13,7 @@ export declare class SelectedProvider {
     contentVariables?: Record<string, string>;
     /**
      * Referencia (nombre/ARN) al secret de Secrets Manager con las credenciales
-     * de la cuenta de Twilio de este `(tenant, channel)`. Ej: "twilio/FIADO/credentials".
+     * de la cuenta de Twilio de este `(tenant, channel)`. Ej: "twilio-<tenant>-credentials".
      * El connector resuelve el secret real con esta referencia justo antes de enviar.
      * Opcional: si se omite, el connector usa su secret por defecto (TWILIO_SECRET_NAME).
      */

package/package.json

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

package/src/messagesConnector/dtos/NotificationQueueMessageRequestV2.ts

@@ -1,9 +1,16 @@
 import { IsEnum, IsNotEmpty, IsObject, IsOptional, IsString, Validate } from 'class-validator';
 import { Expose } from 'class-transformer';
 import { DeliveryChannelExtendedEnum } from '../enums/DeliveryChannelExtendedEnum';
+import { NotificationOriginEnum } from '../enums/NotificationOriginEnum';
 import { IsStringValueRecord } from '../validators/IsStringValueRecord';
 
 export class NotificationQueueMessageRequestV2 {
+    /** Tenant emisor del mensaje. Si se omite, messages-business asume FIADO. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    tenantId?: string;
+
     @Expose()
     @IsString()
     @IsNotEmpty()
@@ -51,4 +58,10 @@ export class NotificationQueueMessageRequestV2 {
     @Expose()
     @IsOptional()
     data?: unknown;
+
+    /** Quien disparo la notificacion. Sin default: su ausencia ya significa EVENT. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(NotificationOriginEnum)
+    origin?: NotificationOriginEnum;
 }

package/src/messagesConnector/dtos/TemplateMessageCreateRequest.ts

@@ -1,22 +1,29 @@
 import { Expose } from 'class-transformer';
-import { IsEnum, IsNotEmpty, IsOptional, IsString, Validate } from 'class-validator';
-import { ContentTypeEnum, DeliveryChannelEnum } from '../../messaging';
+import { IsArray, IsEnum, IsNotEmpty, IsOptional, IsString, Validate } from 'class-validator';
+import { ContentTypeEnum } from '../../messaging';
+import { DeliveryChannelExtendedEnum } from '../enums/DeliveryChannelExtendedEnum';
 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).
+ * Body para POST /templates (backoffice). Identifica un template por sus 5
+ * componentes de PK (tenantId, messageType, channelType, language, country) +
+ * campos de contenido. `typeOfDirectoryId` es campo no-key del Row (ver TD pendiente).
  */
 export class TemplateMessageCreateRequest {
+    /** Tenant al que pertenece la plantilla. Si se omite, se asume FIADO. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    tenantId?: string;
+
     @Expose()
     @IsString()
     @IsNotEmpty()
     messageType!: string;
 
     @Expose()
-    @IsEnum(DeliveryChannelEnum)
-    channelType!: DeliveryChannelEnum;
+    @IsEnum(DeliveryChannelExtendedEnum)
+    channelType!: DeliveryChannelExtendedEnum;
 
     @Expose()
     @IsString()
@@ -48,4 +55,17 @@ export class TemplateMessageCreateRequest {
     @IsString()
     @Validate(IsTemplatePlaceholders)
     subject?: string;
+
+    /** contentSid HX de Twilio. Solo en plantillas de WhatsApp. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    providerTemplateId?: string;
+
+    /** Que variable va en cada slot posicional de Twilio. Solo en plantillas de WhatsApp. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    slotVariables?: string[];
 }

package/src/messagesConnector/dtos/TemplateMessageListFiltersRequest.ts

@@ -1,12 +1,18 @@
 import { Expose, Type } from 'class-transformer';
 import { IsEnum, IsInt, IsOptional, IsString, Max, Min } from 'class-validator';
-import { DeliveryChannelEnum } from '../../messaging';
+import { DeliveryChannelExtendedEnum } from '../enums/DeliveryChannelExtendedEnum';
 
 /**
  * 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 {
+    /** Filtra por tenant. Si se omite, no filtra por tenant. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    tenantId?: string;
+
     @Expose()
     @IsOptional()
     @IsString()
@@ -14,8 +20,8 @@ export class TemplateMessageListFiltersRequest {
 
     @Expose()
     @IsOptional()
-    @IsEnum(DeliveryChannelEnum)
-    channelType?: DeliveryChannelEnum;
+    @IsEnum(DeliveryChannelExtendedEnum)
+    channelType?: DeliveryChannelExtendedEnum;
 
     @Expose()
     @IsOptional()

package/src/messagesConnector/dtos/TemplateMessageResponse.ts

@@ -1,5 +1,6 @@
 import { Expose } from 'class-transformer';
-import { ContentTypeEnum, DeliveryChannelEnum } from '../../messaging';
+import { ContentTypeEnum } from '../../messaging';
+import { DeliveryChannelExtendedEnum } from '../enums/DeliveryChannelExtendedEnum';
 
 /**
  * Forma del template retornada por GET /templates/{id}, POST, PUT.
@@ -14,11 +15,15 @@ export class TemplateMessageResponse {
     @Expose()
     pk!: string;
 
+    /** Tenant al que pertenece la plantilla. Ausente en las plantillas legacy de FIADO. */
+    @Expose()
+    tenantId?: string;
+
     @Expose()
     messageType!: string;
 
     @Expose()
-    channelType!: DeliveryChannelEnum;
+    channelType!: DeliveryChannelExtendedEnum;
 
     @Expose()
     language!: string;
@@ -38,6 +43,14 @@ export class TemplateMessageResponse {
     @Expose()
     subject?: string;
 
+    /** contentSid HX de Twilio. Solo en plantillas de WhatsApp. */
+    @Expose()
+    providerTemplateId?: string;
+
+    /** Que variable va en cada slot posicional de Twilio. Solo en plantillas de WhatsApp. */
+    @Expose()
+    slotVariables?: string[];
+
     @Expose()
     createdAt!: number;
 

package/src/messagesConnector/dtos/TemplateMessageUpdateRequest.ts

@@ -1,11 +1,11 @@
 import { Expose } from 'class-transformer';
-import { IsEnum, IsNotEmpty, IsOptional, IsString, Validate } from 'class-validator';
+import { IsArray, 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
+ * Los componentes del PK (tenantId, 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").
  *
@@ -36,4 +36,17 @@ export class TemplateMessageUpdateRequest {
     @IsString()
     @Validate(IsTemplatePlaceholders)
     subject?: string;
+
+    /** contentSid HX de Twilio. Solo en plantillas de WhatsApp. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    providerTemplateId?: string;
+
+    /** Que variable va en cada slot posicional de Twilio. Solo en plantillas de WhatsApp. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    slotVariables?: string[];
 }

package/src/messagesConnector/enums/NotificationOriginEnum.ts

@@ -0,0 +1,9 @@
+/** Quien disparo la notificacion. Su ausencia significa EVENT. */
+export enum NotificationOriginEnum {
+    /** Un admin lo disparo a mano desde el backoffice. */
+    MANUAL = 'MANUAL',
+    /** Envio de prueba del editor de plantillas, a un solo destinatario. */
+    TEST = 'TEST',
+    /** Lo publico un productor del ciclo de vida. */
+    EVENT = 'EVENT',
+}

package/src/messagesConnector/index.ts

@@ -1,4 +1,5 @@
 export * from './enums/DeliveryChannelExtendedEnum';
+export * from './enums/NotificationOriginEnum';
 export * from './validators/IsStringValueRecord';
 export * from './dtos/NotificationQueueMessageRequestV2';
 export * from './dtos/SendMessageRequest';

package/src/messaging/dtos/MessageDeliveryRequest.ts

@@ -1,5 +1,5 @@
 import { Expose } from 'class-transformer';
-import { IsEnum, Validate, ValidateIf } from 'class-validator';
+import { IsEnum, IsOptional, IsString, Validate, ValidateIf } from 'class-validator';
 import { DeliveryChannelEnum } from '../enums/DeliveryChannelEnum';
 import { ContentTypeEnum } from '../enums/ContentTypeEnum';
 import { IsDestinationByChannel } from '../validators/IsDestinationByChannel';
@@ -26,4 +26,13 @@ export class MessageDeliveryRequest {
     @Expose()
     @IsEnum(ContentTypeEnum)
     contentType: ContentTypeEnum;
+
+    /**
+     * Remitente ya resuelto: direccion From de SES para MAIL, sender ID de SNS para SMS.
+     * Si se omite, el connector usa su remitente por defecto.
+     */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    sender?: string;
 }

package/src/twilioConnector/dtos/SelectedProvider.ts

@@ -19,7 +19,7 @@ export class SelectedProvider {
 
     /**
      * Referencia (nombre/ARN) al secret de Secrets Manager con las credenciales
-     * de la cuenta de Twilio de este `(tenant, channel)`. Ej: "twilio/FIADO/credentials".
+     * de la cuenta de Twilio de este `(tenant, channel)`. Ej: "twilio-<tenant>-credentials".
      * El connector resuelve el secret real con esta referencia justo antes de enviar.
      * Opcional: si se omite, el connector usa su secret por defecto (TWILIO_SECRET_NAME).
      */