tychat-contracts 1.0.101 → 1.0.103

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":"AAWA,OAAO,EAAE,gCAAgC,EAAE,MAAM,0CAA0C,CAAC;AAyB5F,qBAAa,gCAAgC;IAU3C,IAAI,CAAC,EAAE,MAAM,CAAC;IAad,KAAK,CAAC,EAAE,MAAM,CAAC;IAcf,OAAO,CAAC,EAAE,gCAAgC,EAAE,CAAC;CAC9C"}
+{"version":3,"file":"list-conversation-contacts-query.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/list-conversation-contacts-query.dto.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,gCAAgC,EAAE,MAAM,0CAA0C,CAAC;AAE5F,qBAAa,gCAAgC;IAU3C,IAAI,CAAC,EAAE,MAAM,CAAC;IAad,KAAK,CAAC,EAAE,MAAM,CAAC;IAgBf,OAAO,CAAC,EAAE,gCAAgC,EAAE,CAAC;CAC9C"}

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

@@ -13,28 +13,8 @@ exports.ListConversationContactsQueryDto = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const parse_filters_from_query_util_1 = require("../utils/parse-filters-from-query.util");
 const list_conversation_contacts_filters_dto_1 = require("./list-conversation-contacts-filters.dto");
-function parseFiltersFromQuery(value) {
-    if (value === undefined || value === null || value === '') {
-        return undefined;
-    }
-    if (Array.isArray(value)) {
-        return value;
-    }
-    if (typeof value === 'string') {
-        try {
-            const parsed = JSON.parse(value);
-            if (!Array.isArray(parsed)) {
-                return undefined;
-            }
-            return parsed;
-        }
-        catch {
-            return undefined;
-        }
-    }
-    return undefined;
-}
 class ListConversationContactsQueryDto {
     page;
     limit;
@@ -69,12 +49,12 @@ __decorate([
 ], ListConversationContactsQueryDto.prototype, "limit", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
-        description: 'Lista `{ key, op, value }`. Na query HTTP: string JSON (ex.: `[{"key":"conversationType","op":"==","value":"ia"}]`). Ops: ==, !=, >, <, >=, <=, in.',
-        type: [list_conversation_contacts_filters_dto_1.ConversationContactListFilterDto],
-        isArray: true,
+        description: 'Lista `{ key, op, value }` em **uma única** query string JSON (recomendado no Swagger). Ex.: `[{"key":"conversationType","op":"==","value":"ia"}]`. Ops: ==, !=, >, <, >=, <=, in.',
+        type: String,
+        example: '[{"key":"intention","op":"==","value":"greeting"}]',
     }),
     (0, class_validator_1.IsOptional)(),
-    (0, class_transformer_1.Transform)(({ value }) => parseFiltersFromQuery(value)),
+    (0, class_transformer_1.Transform)(({ value }) => (0, parse_filters_from_query_util_1.parseFilterObjectsFromQuery)(value)),
     (0, class_validator_1.IsArray)(),
     (0, class_validator_1.ArrayMinSize)(0),
     (0, class_validator_1.ValidateNested)({ each: true }),

package/dist/notifications/index.d.ts

@@ -1,6 +1,7 @@
 export { NotificationUserCreatedEventPayload, NotificationPasswordResetRequestedEventPayload, } from './notifications-kafka.payloads';
-export { TOPIC_NOTIFICATIONS_FIND_ALL, TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN, } from './notifications-kafka-topics';
+export { TOPIC_NOTIFICATIONS_FIND_ALL, TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN, TOPIC_NOTIFICATIONS_UPDATE_VIEWED, } from './notifications-kafka-topics';
 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 { 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,GACxC,MAAM,8BAA8B,CAAC;AACtC,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"}
+{"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,GAClC,MAAM,8BAA8B,CAAC;AACtC,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"}

package/dist/notifications/index.js

@@ -1,12 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NotificationListItemDto = exports.NOTIFICATION_STATUS_FILTERS = exports.NOTIFICATION_PROVIDER_FILTERS = exports.ListNotificationsQueryDto = exports.NotificationsRegisterPushTokenKafkaDto = exports.RegisterPushTokenDto = exports.TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN = exports.TOPIC_NOTIFICATIONS_FIND_ALL = exports.NotificationPasswordResetRequestedEventPayload = exports.NotificationUserCreatedEventPayload = void 0;
+exports.NotificationsUpdateViewedKafkaDto = exports.UpdateNotificationViewedDto = exports.NotificationListItemDto = exports.NOTIFICATION_STATUS_FILTERS = exports.NOTIFICATION_PROVIDER_FILTERS = exports.ListNotificationsQueryDto = exports.NotificationsRegisterPushTokenKafkaDto = exports.RegisterPushTokenDto = 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; } });
 var notifications_kafka_topics_1 = require("./notifications-kafka-topics");
 Object.defineProperty(exports, "TOPIC_NOTIFICATIONS_FIND_ALL", { enumerable: true, get: function () { return notifications_kafka_topics_1.TOPIC_NOTIFICATIONS_FIND_ALL; } });
 Object.defineProperty(exports, "TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN", { enumerable: true, get: function () { return notifications_kafka_topics_1.TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN; } });
+Object.defineProperty(exports, "TOPIC_NOTIFICATIONS_UPDATE_VIEWED", { enumerable: true, get: function () { return notifications_kafka_topics_1.TOPIC_NOTIFICATIONS_UPDATE_VIEWED; } });
 var register_push_token_dto_1 = require("./register-push-token.dto");
 Object.defineProperty(exports, "RegisterPushTokenDto", { enumerable: true, get: function () { return register_push_token_dto_1.RegisterPushTokenDto; } });
 Object.defineProperty(exports, "NotificationsRegisterPushTokenKafkaDto", { enumerable: true, get: function () { return register_push_token_dto_1.NotificationsRegisterPushTokenKafkaDto; } });
@@ -16,3 +17,6 @@ Object.defineProperty(exports, "NOTIFICATION_PROVIDER_FILTERS", { enumerable: tr
 Object.defineProperty(exports, "NOTIFICATION_STATUS_FILTERS", { enumerable: true, get: function () { return list_notifications_query_dto_1.NOTIFICATION_STATUS_FILTERS; } });
 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");
+Object.defineProperty(exports, "UpdateNotificationViewedDto", { enumerable: true, get: function () { return update_notification_viewed_dto_1.UpdateNotificationViewedDto; } });
+Object.defineProperty(exports, "NotificationsUpdateViewedKafkaDto", { enumerable: true, get: function () { return update_notification_viewed_dto_1.NotificationsUpdateViewedKafkaDto; } });

package/dist/notifications/notification-list-item.dto.d.ts

@@ -6,5 +6,7 @@ export declare class NotificationListItemDto {
     status: string;
     createdAt: string;
     updatedAt: string;
+    viewed: boolean;
+    viewedAt: string | null;
 }
 //# sourceMappingURL=notification-list-item.dto.d.ts.map

package/dist/notifications/notification-list-item.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notification-list-item.dto.d.ts","sourceRoot":"","sources":["../../src/notifications/notification-list-item.dto.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,qBAAa,uBAAuB;IAElC,EAAE,EAAE,MAAM,CAAC;IAGX,iBAAiB,EAAE,MAAM,CAAC;IAG1B,QAAQ,EAAE,MAAM,CAAC;IAGjB,MAAM,EAAE,MAAM,CAAC;IAGf,SAAS,EAAE,MAAM,CAAC;IAGlB,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"notification-list-item.dto.d.ts","sourceRoot":"","sources":["../../src/notifications/notification-list-item.dto.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,qBAAa,uBAAuB;IAElC,EAAE,EAAE,MAAM,CAAC;IAGX,iBAAiB,EAAE,MAAM,CAAC;IAG1B,QAAQ,EAAE,MAAM,CAAC;IAGjB,MAAM,EAAE,MAAM,CAAC;IAGf,SAAS,EAAE,MAAM,CAAC;IAGlB,SAAS,EAAE,MAAM,CAAC;IAMlB,MAAM,EAAE,OAAO,CAAC;IAOhB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB"}

package/dist/notifications/notification-list-item.dto.js

@@ -19,6 +19,8 @@ class NotificationListItemDto {
     status;
     createdAt;
     updatedAt;
+    viewed;
+    viewedAt;
 }
 exports.NotificationListItemDto = NotificationListItemDto;
 __decorate([
@@ -45,3 +47,18 @@ __decorate([
     (0, swagger_1.ApiProperty)({ example: '2026-04-08T12:00:00.000Z' }),
     __metadata("design:type", String)
 ], NotificationListItemDto.prototype, "updatedAt", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Indica se foi marcada como visualizada (viewedAt != null)',
+        example: false,
+    }),
+    __metadata("design:type", Boolean)
+], NotificationListItemDto.prototype, "viewed", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Instante em que foi marcada como visualizada; null se não visualizada',
+        nullable: true,
+        example: null,
+    }),
+    __metadata("design:type", Object)
+], NotificationListItemDto.prototype, "viewedAt", void 0);

package/dist/notifications/notifications-kafka-topics.d.ts

@@ -1,4 +1,6 @@
 /** Kafka request–reply: lista notificações persistidas no banco do tenant. */
 export declare const TOPIC_NOTIFICATIONS_FIND_ALL = "notifications.findAll";
 export declare const TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN = "notifications.registerPushToken";
+/** Kafka request–reply: atualizar visualização de uma notificação persistida. */
+export declare const TOPIC_NOTIFICATIONS_UPDATE_VIEWED = "notifications.updateViewed";
 //# sourceMappingURL=notifications-kafka-topics.d.ts.map

package/dist/notifications/notifications-kafka-topics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notifications-kafka-topics.d.ts","sourceRoot":"","sources":["../../src/notifications/notifications-kafka-topics.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,eAAO,MAAM,4BAA4B,0BAA0B,CAAC;AAEpE,eAAO,MAAM,uCAAuC,oCACjB,CAAC"}
+{"version":3,"file":"notifications-kafka-topics.d.ts","sourceRoot":"","sources":["../../src/notifications/notifications-kafka-topics.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,eAAO,MAAM,4BAA4B,0BAA0B,CAAC;AAEpE,eAAO,MAAM,uCAAuC,oCACjB,CAAC;AAEpC,iFAAiF;AACjF,eAAO,MAAM,iCAAiC,+BAA+B,CAAC"}

package/dist/notifications/notifications-kafka-topics.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN = exports.TOPIC_NOTIFICATIONS_FIND_ALL = void 0;
+exports.TOPIC_NOTIFICATIONS_UPDATE_VIEWED = exports.TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN = exports.TOPIC_NOTIFICATIONS_FIND_ALL = void 0;
 /** Kafka request–reply: lista notificações persistidas no banco do tenant. */
 exports.TOPIC_NOTIFICATIONS_FIND_ALL = 'notifications.findAll';
 exports.TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN = 'notifications.registerPushToken';
+/** Kafka request–reply: atualizar visualização de uma notificação persistida. */
+exports.TOPIC_NOTIFICATIONS_UPDATE_VIEWED = 'notifications.updateViewed';

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

@@ -0,0 +1,15 @@
+/**
+ * Corpo HTTP PUT /notifications/:id — marca se o registo foi visualizado.
+ */
+export declare class UpdateNotificationViewedDto {
+    viewed: boolean;
+}
+/**
+ * Payload Kafka `notifications.updateViewed`.
+ */
+export declare class NotificationsUpdateViewedKafkaDto {
+    tenant: string;
+    id: string;
+    payload: UpdateNotificationViewedDto;
+}
+//# sourceMappingURL=update-notification-viewed.dto.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,53 @@
+"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.NotificationsUpdateViewedKafkaDto = exports.UpdateNotificationViewedDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Corpo HTTP PUT /notifications/:id — marca se o registo foi visualizado.
+ */
+class UpdateNotificationViewedDto {
+    viewed;
+}
+exports.UpdateNotificationViewedDto = UpdateNotificationViewedDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'true = visualizada (grava viewedAt); false = não visualizada (limpa viewedAt)',
+        example: true,
+    }),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], UpdateNotificationViewedDto.prototype, "viewed", void 0);
+/**
+ * Payload Kafka `notifications.updateViewed`.
+ */
+class NotificationsUpdateViewedKafkaDto {
+    tenant;
+    id;
+    payload;
+}
+exports.NotificationsUpdateViewedKafkaDto = NotificationsUpdateViewedKafkaDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (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, "id", void 0);
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => UpdateNotificationViewedDto),
+    __metadata("design:type", UpdateNotificationViewedDto)
+], NotificationsUpdateViewedKafkaDto.prototype, "payload", void 0);

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

@@ -1 +1 @@
-{"version":3,"file":"list-patients-query.dto.d.ts","sourceRoot":"","sources":["../../src/patients/list-patients-query.dto.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAuBnE,qBAAa,oBAAoB;IAU/B,IAAI,CAAC,EAAE,MAAM,CAAC;IAad,KAAK,CAAC,EAAE,MAAM,CAAC;IAcf,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAClC"}
+{"version":3,"file":"list-patients-query.dto.d.ts","sourceRoot":"","sources":["../../src/patients/list-patients-query.dto.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,qBAAa,oBAAoB;IAU/B,IAAI,CAAC,EAAE,MAAM,CAAC;IAad,KAAK,CAAC,EAAE,MAAM,CAAC;IAgBf,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAClC"}

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

@@ -13,28 +13,8 @@ exports.ListPatientsQueryDto = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const parse_filters_from_query_util_1 = require("../utils/parse-filters-from-query.util");
 const list_patients_filters_dto_1 = require("./list-patients-filters.dto");
-function parseFiltersFromQuery(value) {
-    if (value === undefined || value === null || value === '') {
-        return undefined;
-    }
-    if (Array.isArray(value)) {
-        return value;
-    }
-    if (typeof value === 'string') {
-        try {
-            const parsed = JSON.parse(value);
-            if (!Array.isArray(parsed)) {
-                return undefined;
-            }
-            return parsed;
-        }
-        catch {
-            return undefined;
-        }
-    }
-    return undefined;
-}
 class ListPatientsQueryDto {
     page;
     limit;
@@ -69,12 +49,12 @@ __decorate([
 ], ListPatientsQueryDto.prototype, "limit", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
-        description: 'Lista de filtros `{ key, op, value }`. Query HTTP: enviar JSON string (ex.: `filters=[{"key":"cpf","op":"==","value":"12225217416"}]`). Operações: ==, !=, >, <, >=, <=, in (value array).',
-        type: [list_patients_filters_dto_1.PatientListFilterDto],
-        isArray: true,
+        description: 'Lista de filtros `{ key, op, value }` em **uma única** query string JSON. Ex.: `[{"key":"cpf","op":"==","value":"12225217416"}]`. Operações: ==, !=, >, <, >=, <=, in (value array).',
+        type: String,
+        example: '[{"key":"cpf","op":"==","value":"12225217416"}]',
     }),
     (0, class_validator_1.IsOptional)(),
-    (0, class_transformer_1.Transform)(({ value }) => parseFiltersFromQuery(value)),
+    (0, class_transformer_1.Transform)(({ value }) => (0, parse_filters_from_query_util_1.parseFilterObjectsFromQuery)(value)),
     (0, class_validator_1.IsArray)(),
     (0, class_validator_1.ArrayMinSize)(0),
     (0, class_validator_1.ValidateNested)({ each: true }),

package/dist/utils/parse-filters-from-query.util.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Normaliza o parâmetro de query `filters` para um array de objetos DTO.
+ *
+ * Aceita:
+ * - string JSON: `[{"key":"a","op":"==","value":"x"}]`
+ * - array de objetos (já parseado pelo framework)
+ * - array com um único string (JSON do array inteiro) — UI Swagger “array” com um item
+ * - array de strings, cada uma um JSON de um único objeto filtro
+ */
+export declare function parseFilterObjectsFromQuery<T>(value: unknown): T[] | undefined;
+//# sourceMappingURL=parse-filters-from-query.util.d.ts.map

package/dist/utils/parse-filters-from-query.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-filters-from-query.util.d.ts","sourceRoot":"","sources":["../../src/utils/parse-filters-from-query.util.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,EAAE,GAAG,SAAS,CA2D9E"}

package/dist/utils/parse-filters-from-query.util.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFilterObjectsFromQuery = parseFilterObjectsFromQuery;
+/**
+ * Normaliza o parâmetro de query `filters` para um array de objetos DTO.
+ *
+ * Aceita:
+ * - string JSON: `[{"key":"a","op":"==","value":"x"}]`
+ * - array de objetos (já parseado pelo framework)
+ * - array com um único string (JSON do array inteiro) — UI Swagger “array” com um item
+ * - array de strings, cada uma um JSON de um único objeto filtro
+ */
+function parseFilterObjectsFromQuery(value) {
+    if (value === undefined || value === null || value === '') {
+        return undefined;
+    }
+    const asObjectArray = (arr) => {
+        if (!Array.isArray(arr))
+            return undefined;
+        if (arr.length === 0)
+            return [];
+        if (arr.every((item) => item !== null && typeof item === 'object' && !Array.isArray(item))) {
+            return arr;
+        }
+        return undefined;
+    };
+    if (typeof value === 'string') {
+        try {
+            const parsed = JSON.parse(value);
+            return asObjectArray(parsed);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    if (Array.isArray(value)) {
+        const direct = asObjectArray(value);
+        if (direct)
+            return direct;
+        if (value.length === 1 && typeof value[0] === 'string') {
+            return parseFilterObjectsFromQuery(value[0]);
+        }
+        if (value.length > 0 && value.every((v) => typeof v === 'string')) {
+            const out = [];
+            for (const s of value) {
+                let parsed;
+                try {
+                    parsed = JSON.parse(s);
+                }
+                catch {
+                    return undefined;
+                }
+                if (parsed === null ||
+                    typeof parsed !== 'object' ||
+                    Array.isArray(parsed)) {
+                    return undefined;
+                }
+                out.push(parsed);
+            }
+            return out;
+        }
+    }
+    return undefined;
+}

package/package.json

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

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

@@ -9,31 +9,9 @@ import {
   Min,
   ValidateNested,
 } from 'class-validator';
+import { parseFilterObjectsFromQuery } from '../utils/parse-filters-from-query.util';
 import { ConversationContactListFilterDto } from './list-conversation-contacts-filters.dto';
 
-function parseFiltersFromQuery(
-  value: unknown,
-): ConversationContactListFilterDto[] | undefined {
-  if (value === undefined || value === null || value === '') {
-    return undefined;
-  }
-  if (Array.isArray(value)) {
-    return value as ConversationContactListFilterDto[];
-  }
-  if (typeof value === 'string') {
-    try {
-      const parsed = JSON.parse(value) as unknown;
-      if (!Array.isArray(parsed)) {
-        return undefined;
-      }
-      return parsed as ConversationContactListFilterDto[];
-    } catch {
-      return undefined;
-    }
-  }
-  return undefined;
-}
-
 export class ListConversationContactsQueryDto {
   @ApiPropertyOptional({
     description: 'Número da página (iniciando em 1)',
@@ -61,12 +39,14 @@ export class ListConversationContactsQueryDto {
 
   @ApiPropertyOptional({
     description:
-      'Lista `{ key, op, value }`. Na query HTTP: string JSON (ex.: `[{"key":"conversationType","op":"==","value":"ia"}]`). Ops: ==, !=, >, <, >=, <=, in.',
-    type: [ConversationContactListFilterDto],
-    isArray: true,
+      'Lista `{ key, op, value }` em **uma única** query string JSON (recomendado no Swagger). Ex.: `[{"key":"conversationType","op":"==","value":"ia"}]`. Ops: ==, !=, >, <, >=, <=, in.',
+    type: String,
+    example: '[{"key":"intention","op":"==","value":"greeting"}]',
   })
   @IsOptional()
-  @Transform(({ value }) => parseFiltersFromQuery(value))
+  @Transform(({ value }) =>
+    parseFilterObjectsFromQuery<ConversationContactListFilterDto>(value),
+  )
   @IsArray()
   @ArrayMinSize(0)
   @ValidateNested({ each: true })

package/src/notifications/index.ts

@@ -5,6 +5,7 @@ export {
 export {
   TOPIC_NOTIFICATIONS_FIND_ALL,
   TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN,
+  TOPIC_NOTIFICATIONS_UPDATE_VIEWED,
 } from './notifications-kafka-topics';
 export {
   RegisterPushTokenDto,
@@ -18,3 +19,7 @@ export {
   type NotificationStatusFilterDto,
 } from './list-notifications-query.dto';
 export { NotificationListItemDto } from './notification-list-item.dto';
+export {
+  UpdateNotificationViewedDto,
+  NotificationsUpdateViewedKafkaDto,
+} from './update-notification-viewed.dto';

package/src/notifications/notification-list-item.dto.ts

@@ -19,4 +19,17 @@ export class NotificationListItemDto {
 
   @ApiProperty({ example: '2026-04-08T12:00:00.000Z' })
   updatedAt: string;
+
+  @ApiProperty({
+    description: 'Indica se foi marcada como visualizada (viewedAt != null)',
+    example: false,
+  })
+  viewed: boolean;
+
+  @ApiProperty({
+    description: 'Instante em que foi marcada como visualizada; null se não visualizada',
+    nullable: true,
+    example: null,
+  })
+  viewedAt: string | null;
 }

package/src/notifications/notifications-kafka-topics.ts

@@ -3,3 +3,6 @@ export const TOPIC_NOTIFICATIONS_FIND_ALL = 'notifications.findAll';
 
 export const TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN =
   'notifications.registerPushToken';
+
+/** Kafka request–reply: atualizar visualização de uma notificação persistida. */
+export const TOPIC_NOTIFICATIONS_UPDATE_VIEWED = 'notifications.updateViewed';

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

@@ -0,0 +1,37 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import {
+  IsBoolean,
+  IsNotEmpty,
+  IsString,
+  IsUUID,
+  ValidateNested,
+} from 'class-validator';
+
+/**
+ * Corpo HTTP PUT /notifications/:id — marca se o registo foi visualizado.
+ */
+export class UpdateNotificationViewedDto {
+  @ApiProperty({
+    description: 'true = visualizada (grava viewedAt); false = não visualizada (limpa viewedAt)',
+    example: true,
+  })
+  @IsBoolean()
+  viewed: boolean;
+}
+
+/**
+ * Payload Kafka `notifications.updateViewed`.
+ */
+export class NotificationsUpdateViewedKafkaDto {
+  @IsString()
+  @IsNotEmpty()
+  tenant: string;
+
+  @IsUUID('4')
+  id: string;
+
+  @ValidateNested()
+  @Type(() => UpdateNotificationViewedDto)
+  payload: UpdateNotificationViewedDto;
+}

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

@@ -9,29 +9,9 @@ import {
   Min,
   ValidateNested,
 } from 'class-validator';
+import { parseFilterObjectsFromQuery } from '../utils/parse-filters-from-query.util';
 import { PatientListFilterDto } from './list-patients-filters.dto';
 
-function parseFiltersFromQuery(value: unknown): PatientListFilterDto[] | undefined {
-  if (value === undefined || value === null || value === '') {
-    return undefined;
-  }
-  if (Array.isArray(value)) {
-    return value as PatientListFilterDto[];
-  }
-  if (typeof value === 'string') {
-    try {
-      const parsed = JSON.parse(value) as unknown;
-      if (!Array.isArray(parsed)) {
-        return undefined;
-      }
-      return parsed as PatientListFilterDto[];
-    } catch {
-      return undefined;
-    }
-  }
-  return undefined;
-}
-
 export class ListPatientsQueryDto {
   @ApiPropertyOptional({
     description: 'Número da página (iniciando em 1)',
@@ -59,12 +39,14 @@ export class ListPatientsQueryDto {
 
   @ApiPropertyOptional({
     description:
-      'Lista de filtros `{ key, op, value }`. Query HTTP: enviar JSON string (ex.: `filters=[{"key":"cpf","op":"==","value":"12225217416"}]`). Operações: ==, !=, >, <, >=, <=, in (value array).',
-    type: [PatientListFilterDto],
-    isArray: true,
+      'Lista de filtros `{ key, op, value }` em **uma única** query string JSON. Ex.: `[{"key":"cpf","op":"==","value":"12225217416"}]`. Operações: ==, !=, >, <, >=, <=, in (value array).',
+    type: String,
+    example: '[{"key":"cpf","op":"==","value":"12225217416"}]',
   })
   @IsOptional()
-  @Transform(({ value }) => parseFiltersFromQuery(value))
+  @Transform(({ value }) =>
+    parseFilterObjectsFromQuery<PatientListFilterDto>(value),
+  )
   @IsArray()
   @ArrayMinSize(0)
   @ValidateNested({ each: true })

package/src/utils/parse-filters-from-query.util.ts

@@ -0,0 +1,69 @@
+/**
+ * Normaliza o parâmetro de query `filters` para um array de objetos DTO.
+ *
+ * Aceita:
+ * - string JSON: `[{"key":"a","op":"==","value":"x"}]`
+ * - array de objetos (já parseado pelo framework)
+ * - array com um único string (JSON do array inteiro) — UI Swagger “array” com um item
+ * - array de strings, cada uma um JSON de um único objeto filtro
+ */
+export function parseFilterObjectsFromQuery<T>(value: unknown): T[] | undefined {
+  if (value === undefined || value === null || value === '') {
+    return undefined;
+  }
+
+  const asObjectArray = (arr: unknown): T[] | undefined => {
+    if (!Array.isArray(arr)) return undefined;
+    if (arr.length === 0) return [];
+    if (
+      arr.every(
+        (item) =>
+          item !== null && typeof item === 'object' && !Array.isArray(item),
+      )
+    ) {
+      return arr as T[];
+    }
+    return undefined;
+  };
+
+  if (typeof value === 'string') {
+    try {
+      const parsed = JSON.parse(value) as unknown;
+      return asObjectArray(parsed);
+    } catch {
+      return undefined;
+    }
+  }
+
+  if (Array.isArray(value)) {
+    const direct = asObjectArray(value);
+    if (direct) return direct;
+
+    if (value.length === 1 && typeof value[0] === 'string') {
+      return parseFilterObjectsFromQuery<T>(value[0]);
+    }
+
+    if (value.length > 0 && value.every((v) => typeof v === 'string')) {
+      const out: T[] = [];
+      for (const s of value) {
+        let parsed: unknown;
+        try {
+          parsed = JSON.parse(s);
+        } catch {
+          return undefined;
+        }
+        if (
+          parsed === null ||
+          typeof parsed !== 'object' ||
+          Array.isArray(parsed)
+        ) {
+          return undefined;
+        }
+        out.push(parsed as T);
+      }
+      return out;
+    }
+  }
+
+  return undefined;
+}