@fiado/type-kit 3.416.0 → 3.418.0

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

@@ -47,3 +47,34 @@ describe('NotificationQueueMessageRequestV2.origin', () => {
         expect(await errorsOn({ origin: 'CRON' }, 'origin')).not.toHaveLength(0);
     });
 });
+
+describe('referenceMessageId — la llave de idempotencia de la cola', () => {
+    const validQueueMessage = {
+        templateId: 'COLLECTION_PRE_DUE_2_DAYS',
+        channelType: DeliveryChannelExtendedEnum.SMS,
+        language: 'es',
+        country: 'MX',
+        typeOfDirectoryId: 'USER',
+        directoryId: '01M0B5D7FQA3T06K4REEVPRM33',
+        destination: '+525512345678',
+        variables: { name: 'Ana' },
+    };
+
+    // A diferencia de los DTOs HTTP, aca NO es @IsUUID: el productor manda su referencia de
+    // negocio, y messages-business la usa como llave junto con el tenant.
+    it('acepta una referencia que no es UUID', async () => {
+        const dto = plainToInstance(NotificationQueueMessageRequestV2,
+            { ...validQueueMessage, referenceMessageId: 'collections-2026-09-09-MORNING-0001' });
+        expect(await validate(dto)).toEqual([]);
+    });
+
+    it('sigue valido sin referencia: sin ella no hay deduplicacion, que es el comportamiento de siempre', async () => {
+        const dto = plainToInstance(NotificationQueueMessageRequestV2, validQueueMessage);
+        expect(await validate(dto)).toEqual([]);
+        expect(dto.referenceMessageId).toBeUndefined();
+    });
+
+    it('ya no acepta messageLogId: era plomeria del lote retirado', () => {
+        expect(Object.keys(new NotificationQueueMessageRequestV2())).not.toContain('messageLogId');
+    });
+});

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

@@ -11,6 +11,10 @@ export declare class NotificationQueueMessageRequestV2 {
     directoryId: string;
     destination: string;
     variables: Record<string, string>;
+    /**
+     * Referencia del productor. Cuando viaja, messages-business la usa como llave de
+     * idempotencia: el par (tenantId, referenceMessageId) se entrega UNA sola vez.
+     */
     referenceMessageId?: string;
     data?: unknown;
     /** Quien disparo la notificacion. Sin default: su ausencia ya significa EVENT. */

package/package.json

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

package/src/messagesConnector/dtos/NotificationQueueMessageRequestV2.ts

@@ -50,6 +50,10 @@ export class NotificationQueueMessageRequestV2 {
     @Validate(IsStringValueRecord)
     variables!: Record<string, string>;
 
+    /**
+     * Referencia del productor. Cuando viaja, messages-business la usa como llave de
+     * idempotencia: el par (tenantId, referenceMessageId) se entrega UNA sola vez.
+     */
     @Expose()
     @IsOptional()
     @IsString()