tychat-contracts 1.0.124 → 1.0.126

package/dist/conversations/conversation-contact-filters-query.validator.spec.js

@@ -110,6 +110,21 @@ describe('ConversationContactFiltersQueryConstraint', () => {
         expect(errors).toHaveLength(0);
         expect(dto.filters).toBeUndefined();
     });
+    it('should accept sortBy and sortOrder query params', async () => {
+        const dto = simulateValidationPipe({
+            page: '1',
+            limit: '20',
+            sortBy: 'startedAt',
+            sortOrder: 'desc',
+        });
+        const errors = await (0, class_validator_1.validate)(dto, {
+            whitelist: true,
+            forbidNonWhitelisted: true,
+        });
+        expect(errors).toHaveLength(0);
+        expect(dto.sortBy).toBe('startedAt');
+        expect(dto.sortOrder).toBe('DESC');
+    });
     it('should accept empty string filters', async () => {
         const dto = simulateValidationPipe({ filters: '' });
         const errors = await (0, class_validator_1.validate)(dto, {

package/dist/conversations/list-conversation-contacts-query.dto.d.ts

@@ -8,6 +8,8 @@ export type ConversationContactListFilterKeyDto = (typeof CONVERSATION_CONTACT_L
 export declare class ListConversationContactsQueryDto {
     page?: number;
     limit?: number;
+    sortBy?: 'startedAt' | 'unreadCount';
+    sortOrder?: 'ASC' | 'DESC';
     filters?: ParsedFilterDto[];
 }
 //# sourceMappingURL=list-conversation-contacts-query.dto.d.ts.map

package/dist/conversations/list-conversation-contacts-query.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-conversation-contacts-query.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/list-conversation-contacts-query.dto.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,qCAAqC,0JAWxC,CAAC;AACX,MAAM,MAAM,mCAAmC,GAC7C,CAAC,OAAO,qCAAqC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,qBAAa,gCAAgC;IAU3C,IAAI,CAAC,EAAE,MAAM,CAAC;IAad,KAAK,CAAC,EAAE,MAAM,CAAC;IAWf,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;CAC7B"}
+{"version":3,"file":"list-conversation-contacts-query.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/list-conversation-contacts-query.dto.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,qCAAqC,0JAWxC,CAAC;AACX,MAAM,MAAM,mCAAmC,GAC7C,CAAC,OAAO,qCAAqC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,qBAAa,gCAAgC;IAU3C,IAAI,CAAC,EAAE,MAAM,CAAC;IAad,KAAK,CAAC,EAAE,MAAM,CAAC;IAUf,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC;IAWrC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAW3B,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;CAC7B"}

package/dist/conversations/list-conversation-contacts-query.dto.js

@@ -11,6 +11,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ListConversationContactsQueryDto = exports.CONVERSATION_CONTACT_LIST_FILTER_KEYS = void 0;
 const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 /**
  * Allowed conversation session entity columns for filtering (camelCase API keys).
@@ -31,6 +32,8 @@ exports.CONVERSATION_CONTACT_LIST_FILTER_KEYS = [
 class ListConversationContactsQueryDto {
     page;
     limit;
+    sortBy;
+    sortOrder;
     filters;
 }
 exports.ListConversationContactsQueryDto = ListConversationContactsQueryDto;
@@ -60,6 +63,26 @@ __decorate([
     (0, class_validator_1.Max)(100),
     __metadata("design:type", Number)
 ], ListConversationContactsQueryDto.prototype, "limit", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Campo de ordenação: `startedAt` (padrão na API) ou `unreadCount`.',
+        enum: ['startedAt', 'unreadCount'],
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => (typeof value === 'string' ? value.trim() : value)),
+    (0, class_validator_1.IsIn)(['startedAt', 'unreadCount']),
+    __metadata("design:type", String)
+], ListConversationContactsQueryDto.prototype, "sortBy", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Direção: `ASC` ou `DESC` (case-insensitive na query string).',
+        enum: ['ASC', 'DESC'],
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => typeof value === 'string' ? value.trim().toUpperCase() : value),
+    (0, class_validator_1.IsIn)(['ASC', 'DESC']),
+    __metadata("design:type", String)
+], ListConversationContactsQueryDto.prototype, "sortOrder", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
         description: 'JSON string with an array of filter objects `{ key, op, value }`. ' +

package/dist/notifications/index.d.ts

@@ -3,6 +3,7 @@ export { TOPIC_NOTIFICATIONS_FIND_ALL, TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN,
 export { AdminBroadcastPushDto } from './admin-broadcast-push.dto';
 export { RegisterPushTokenDto, NotificationsRegisterPushTokenKafkaDto, } from './register-push-token.dto';
 export { ListNotificationsQueryDto, NOTIFICATION_PROVIDER_FILTERS, NOTIFICATION_STATUS_FILTERS, type NotificationProviderFilterDto, type NotificationStatusFilterDto, } from './list-notifications-query.dto';
+export { NotificationsFindAllKafkaDto } from './notifications-find-all-kafka.dto';
 export { NotificationListItemDto } from './notification-list-item.dto';
 export { UpdateNotificationViewedDto, NotificationsUpdateViewedKafkaDto, } from './update-notification-viewed.dto';
 //# sourceMappingURL=index.d.ts.map

package/dist/notifications/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mCAAmC,EACnC,8CAA8C,GAC/C,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,4BAA4B,EAC5B,uCAAuC,EACvC,iCAAiC,EACjC,wCAAwC,GACzC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EACL,oBAAoB,EACpB,sCAAsC,GACvC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,2BAA2B,EAC3B,KAAK,6BAA6B,EAClC,KAAK,2BAA2B,GACjC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EACL,2BAA2B,EAC3B,iCAAiC,GAClC,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mCAAmC,EACnC,8CAA8C,GAC/C,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,4BAA4B,EAC5B,uCAAuC,EACvC,iCAAiC,EACjC,wCAAwC,GACzC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EACL,oBAAoB,EACpB,sCAAsC,GACvC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,2BAA2B,EAC3B,KAAK,6BAA6B,EAClC,KAAK,2BAA2B,GACjC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EACL,2BAA2B,EAC3B,iCAAiC,GAClC,MAAM,kCAAkC,CAAC"}

package/dist/notifications/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NotificationsUpdateViewedKafkaDto = exports.UpdateNotificationViewedDto = exports.NotificationListItemDto = exports.NOTIFICATION_STATUS_FILTERS = exports.NOTIFICATION_PROVIDER_FILTERS = exports.ListNotificationsQueryDto = exports.NotificationsRegisterPushTokenKafkaDto = exports.RegisterPushTokenDto = exports.AdminBroadcastPushDto = exports.EVENT_NOTIFICATIONS_ADMIN_BROADCAST_PUSH = exports.TOPIC_NOTIFICATIONS_UPDATE_VIEWED = exports.TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN = exports.TOPIC_NOTIFICATIONS_FIND_ALL = exports.NotificationPasswordResetRequestedEventPayload = exports.NotificationUserCreatedEventPayload = void 0;
+exports.NotificationsUpdateViewedKafkaDto = exports.UpdateNotificationViewedDto = exports.NotificationListItemDto = exports.NotificationsFindAllKafkaDto = exports.NOTIFICATION_STATUS_FILTERS = exports.NOTIFICATION_PROVIDER_FILTERS = exports.ListNotificationsQueryDto = exports.NotificationsRegisterPushTokenKafkaDto = exports.RegisterPushTokenDto = exports.AdminBroadcastPushDto = exports.EVENT_NOTIFICATIONS_ADMIN_BROADCAST_PUSH = exports.TOPIC_NOTIFICATIONS_UPDATE_VIEWED = exports.TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN = exports.TOPIC_NOTIFICATIONS_FIND_ALL = exports.NotificationPasswordResetRequestedEventPayload = exports.NotificationUserCreatedEventPayload = void 0;
 var notifications_kafka_payloads_1 = require("./notifications-kafka.payloads");
 Object.defineProperty(exports, "NotificationUserCreatedEventPayload", { enumerable: true, get: function () { return notifications_kafka_payloads_1.NotificationUserCreatedEventPayload; } });
 Object.defineProperty(exports, "NotificationPasswordResetRequestedEventPayload", { enumerable: true, get: function () { return notifications_kafka_payloads_1.NotificationPasswordResetRequestedEventPayload; } });
@@ -18,6 +18,8 @@ var list_notifications_query_dto_1 = require("./list-notifications-query.dto");
 Object.defineProperty(exports, "ListNotificationsQueryDto", { enumerable: true, get: function () { return list_notifications_query_dto_1.ListNotificationsQueryDto; } });
 Object.defineProperty(exports, "NOTIFICATION_PROVIDER_FILTERS", { enumerable: true, get: function () { return list_notifications_query_dto_1.NOTIFICATION_PROVIDER_FILTERS; } });
 Object.defineProperty(exports, "NOTIFICATION_STATUS_FILTERS", { enumerable: true, get: function () { return list_notifications_query_dto_1.NOTIFICATION_STATUS_FILTERS; } });
+var notifications_find_all_kafka_dto_1 = require("./notifications-find-all-kafka.dto");
+Object.defineProperty(exports, "NotificationsFindAllKafkaDto", { enumerable: true, get: function () { return notifications_find_all_kafka_dto_1.NotificationsFindAllKafkaDto; } });
 var notification_list_item_dto_1 = require("./notification-list-item.dto");
 Object.defineProperty(exports, "NotificationListItemDto", { enumerable: true, get: function () { return notification_list_item_dto_1.NotificationListItemDto; } });
 var update_notification_viewed_dto_1 = require("./update-notification-viewed.dto");

package/dist/notifications/list-notifications-query.dto.d.ts

@@ -3,7 +3,8 @@ export type NotificationProviderFilterDto = (typeof NOTIFICATION_PROVIDER_FILTER
 export declare const NOTIFICATION_STATUS_FILTERS: readonly ["pending", "sent", "failed"];
 export type NotificationStatusFilterDto = (typeof NOTIFICATION_STATUS_FILTERS)[number];
 /**
- * Query HTTP + payload Kafka para listar notificações do tenant.
+ * Query HTTP + filhos de `payload` no Kafka `notifications.findAll`.
+ * A lista é sempre filtrada pelo `userId` enviado no envelope Kafka (JWT na API).
  */
 export declare class ListNotificationsQueryDto {
     page?: number;

package/dist/notifications/list-notifications-query.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-notifications-query.dto.d.ts","sourceRoot":"","sources":["../../src/notifications/list-notifications-query.dto.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,6BAA6B,+CAKhC,CAAC;AACX,MAAM,MAAM,6BAA6B,GACvC,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD,eAAO,MAAM,2BAA2B,wCAI9B,CAAC;AACX,MAAM,MAAM,2BAA2B,GACrC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/C;;GAEG;AACH,qBAAa,yBAAyB;IAMpC,IAAI,CAAC,EAAE,MAAM,CAAC;IAQd,KAAK,CAAC,EAAE,MAAM,CAAC;IAQf,QAAQ,CAAC,EAAE,6BAA6B,CAAC;IAQzC,MAAM,CAAC,EAAE,2BAA2B,CAAC;IASrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B"}
+{"version":3,"file":"list-notifications-query.dto.d.ts","sourceRoot":"","sources":["../../src/notifications/list-notifications-query.dto.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,6BAA6B,+CAKhC,CAAC;AACX,MAAM,MAAM,6BAA6B,GACvC,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD,eAAO,MAAM,2BAA2B,wCAI9B,CAAC;AACX,MAAM,MAAM,2BAA2B,GACrC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/C;;;GAGG;AACH,qBAAa,yBAAyB;IAMpC,IAAI,CAAC,EAAE,MAAM,CAAC;IAQd,KAAK,CAAC,EAAE,MAAM,CAAC;IAQf,QAAQ,CAAC,EAAE,6BAA6B,CAAC;IAQzC,MAAM,CAAC,EAAE,2BAA2B,CAAC;IASrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B"}

package/dist/notifications/list-notifications-query.dto.js

@@ -25,7 +25,8 @@ exports.NOTIFICATION_STATUS_FILTERS = [
     'failed',
 ];
 /**
- * Query HTTP + payload Kafka para listar notificações do tenant.
+ * Query HTTP + filhos de `payload` no Kafka `notifications.findAll`.
+ * A lista é sempre filtrada pelo `userId` enviado no envelope Kafka (JWT na API).
  */
 class ListNotificationsQueryDto {
     page;

package/dist/notifications/notifications-find-all-kafka.dto.d.ts

@@ -0,0 +1,11 @@
+import { ListNotificationsQueryDto } from './list-notifications-query.dto';
+/**
+ * Payload Kafka `notifications.findAll`.
+ * O `userId` deve ser o sub do JWT — só esse utilizador vê as suas notificações.
+ */
+export declare class NotificationsFindAllKafkaDto {
+    tenant: string;
+    userId: string;
+    payload?: ListNotificationsQueryDto;
+}
+//# sourceMappingURL=notifications-find-all-kafka.dto.d.ts.map

package/dist/notifications/notifications-find-all-kafka.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications-find-all-kafka.dto.d.ts","sourceRoot":"","sources":["../../src/notifications/notifications-find-all-kafka.dto.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E;;;GAGG;AACH,qBAAa,4BAA4B;IAIvC,MAAM,EAAE,MAAM,CAAC;IAOf,MAAM,EAAE,MAAM,CAAC;IAMf,OAAO,CAAC,EAAE,yBAAyB,CAAC;CACrC"}

package/dist/notifications/notifications-find-all-kafka.dto.js

@@ -0,0 +1,47 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationsFindAllKafkaDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const list_notifications_query_dto_1 = require("./list-notifications-query.dto");
+/**
+ * Payload Kafka `notifications.findAll`.
+ * O `userId` deve ser o sub do JWT — só esse utilizador vê as suas notificações.
+ */
+class NotificationsFindAllKafkaDto {
+    tenant;
+    userId;
+    payload;
+}
+exports.NotificationsFindAllKafkaDto = NotificationsFindAllKafkaDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 'default' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], NotificationsFindAllKafkaDto.prototype, "tenant", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'ID do utilizador (ex.: JWT sub). Lista apenas linhas com este user_id.',
+        format: 'uuid',
+    }),
+    (0, class_validator_1.IsUUID)('4'),
+    __metadata("design:type", String)
+], NotificationsFindAllKafkaDto.prototype, "userId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ type: list_notifications_query_dto_1.ListNotificationsQueryDto }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => list_notifications_query_dto_1.ListNotificationsQueryDto),
+    __metadata("design:type", list_notifications_query_dto_1.ListNotificationsQueryDto)
+], NotificationsFindAllKafkaDto.prototype, "payload", void 0);

package/dist/notifications/update-notification-viewed.dto.d.ts

@@ -9,6 +9,7 @@ export declare class UpdateNotificationViewedDto {
  */
 export declare class NotificationsUpdateViewedKafkaDto {
     tenant: string;
+    userId: string;
     id: string;
     payload: UpdateNotificationViewedDto;
 }

package/dist/notifications/update-notification-viewed.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-notification-viewed.dto.d.ts","sourceRoot":"","sources":["../../src/notifications/update-notification-viewed.dto.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,qBAAa,2BAA2B;IAMtC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,iCAAiC;IAG5C,MAAM,EAAE,MAAM,CAAC;IAGf,EAAE,EAAE,MAAM,CAAC;IAIX,OAAO,EAAE,2BAA2B,CAAC;CACtC"}
+{"version":3,"file":"update-notification-viewed.dto.d.ts","sourceRoot":"","sources":["../../src/notifications/update-notification-viewed.dto.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,qBAAa,2BAA2B;IAMtC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,iCAAiC;IAG5C,MAAM,EAAE,MAAM,CAAC;IAGf,MAAM,EAAE,MAAM,CAAC;IAGf,EAAE,EAAE,MAAM,CAAC;IAIX,OAAO,EAAE,2BAA2B,CAAC;CACtC"}

package/dist/notifications/update-notification-viewed.dto.js

@@ -33,6 +33,7 @@ __decorate([
  */
 class NotificationsUpdateViewedKafkaDto {
     tenant;
+    userId;
     id;
     payload;
 }
@@ -42,6 +43,10 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], NotificationsUpdateViewedKafkaDto.prototype, "tenant", void 0);
+__decorate([
+    (0, class_validator_1.IsUUID)('4'),
+    __metadata("design:type", String)
+], NotificationsUpdateViewedKafkaDto.prototype, "userId", void 0);
 __decorate([
     (0, class_validator_1.IsUUID)('4'),
     __metadata("design:type", String)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tychat-contracts",
-  "version": "1.0.124",
+  "version": "1.0.126",
   "description": "DTOs compartilhados com class-validator (API e microserviços)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/conversations/conversation-contact-filters-query.validator.spec.ts

@@ -120,6 +120,22 @@ describe('ConversationContactFiltersQueryConstraint', () => {
     expect(dto.filters).toBeUndefined();
   });
 
+  it('should accept sortBy and sortOrder query params', async () => {
+    const dto = simulateValidationPipe({
+      page: '1',
+      limit: '20',
+      sortBy: 'startedAt',
+      sortOrder: 'desc',
+    });
+    const errors = await validate(dto, {
+      whitelist: true,
+      forbidNonWhitelisted: true,
+    });
+    expect(errors).toHaveLength(0);
+    expect(dto.sortBy).toBe('startedAt');
+    expect(dto.sortOrder).toBe('DESC');
+  });
+
   it('should accept empty string filters', async () => {
     const dto = simulateValidationPipe({ filters: '' });
     const errors = await validate(dto, {

package/src/conversations/list-conversation-contacts-query.dto.ts

@@ -1,5 +1,6 @@
 import { ApiPropertyOptional } from '@nestjs/swagger';
-import { IsInt, IsOptional, Max, Min } from 'class-validator';
+import { Transform } from 'class-transformer';
+import { IsIn, IsInt, IsOptional, Max, Min } from 'class-validator';
 import type { ParsedFilterDto } from '../filters/parsed-filter.dto';
 
 /**
@@ -46,6 +47,27 @@ export class ListConversationContactsQueryDto {
   @Max(100)
   limit?: number;
 
+  @ApiPropertyOptional({
+    description:
+      'Campo de ordenação: `startedAt` (padrão na API) ou `unreadCount`.',
+    enum: ['startedAt', 'unreadCount'],
+  })
+  @IsOptional()
+  @Transform(({ value }) => (typeof value === 'string' ? value.trim() : value))
+  @IsIn(['startedAt', 'unreadCount'])
+  sortBy?: 'startedAt' | 'unreadCount';
+
+  @ApiPropertyOptional({
+    description: 'Direção: `ASC` ou `DESC` (case-insensitive na query string).',
+    enum: ['ASC', 'DESC'],
+  })
+  @IsOptional()
+  @Transform(({ value }) =>
+    typeof value === 'string' ? value.trim().toUpperCase() : value,
+  )
+  @IsIn(['ASC', 'DESC'])
+  sortOrder?: 'ASC' | 'DESC';
+
   @ApiPropertyOptional({
     description:
       'JSON string with an array of filter objects `{ key, op, value }`. ' +

package/src/notifications/index.ts

@@ -20,6 +20,7 @@ export {
   type NotificationProviderFilterDto,
   type NotificationStatusFilterDto,
 } from './list-notifications-query.dto';
+export { NotificationsFindAllKafkaDto } from './notifications-find-all-kafka.dto';
 export { NotificationListItemDto } from './notification-list-item.dto';
 export {
   UpdateNotificationViewedDto,

package/src/notifications/list-notifications-query.dto.ts

@@ -20,7 +20,8 @@ export type NotificationStatusFilterDto =
   (typeof NOTIFICATION_STATUS_FILTERS)[number];
 
 /**
- * Query HTTP + payload Kafka para listar notificações do tenant.
+ * Query HTTP + filhos de `payload` no Kafka `notifications.findAll`.
+ * A lista é sempre filtrada pelo `userId` enviado no envelope Kafka (JWT na API).
  */
 export class ListNotificationsQueryDto {
   @ApiPropertyOptional({ minimum: 1, default: 1 })

package/src/notifications/notifications-find-all-kafka.dto.ts

@@ -0,0 +1,34 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import {
+  IsNotEmpty,
+  IsOptional,
+  IsString,
+  IsUUID,
+  ValidateNested,
+} from 'class-validator';
+import { ListNotificationsQueryDto } from './list-notifications-query.dto';
+
+/**
+ * Payload Kafka `notifications.findAll`.
+ * O `userId` deve ser o sub do JWT — só esse utilizador vê as suas notificações.
+ */
+export class NotificationsFindAllKafkaDto {
+  @ApiProperty({ example: 'default' })
+  @IsString()
+  @IsNotEmpty()
+  tenant: string;
+
+  @ApiProperty({
+    description: 'ID do utilizador (ex.: JWT sub). Lista apenas linhas com este user_id.',
+    format: 'uuid',
+  })
+  @IsUUID('4')
+  userId: string;
+
+  @ApiPropertyOptional({ type: ListNotificationsQueryDto })
+  @IsOptional()
+  @ValidateNested()
+  @Type(() => ListNotificationsQueryDto)
+  payload?: ListNotificationsQueryDto;
+}

package/src/notifications/update-notification-viewed.dto.ts

@@ -28,6 +28,9 @@ export class NotificationsUpdateViewedKafkaDto {
   @IsNotEmpty()
   tenant: string;
 
+  @IsUUID('4')
+  userId: string;
+
   @IsUUID('4')
   id: string;