tychat-contracts 1.0.100 → 1.0.102

package/dist/analytics/analytics-query.dto.d.ts

@@ -32,6 +32,18 @@ export declare class AnalyticsDashboardTopProcedureDto {
     name: string;
     count: number;
 }
+/** Média de `message.sent` por hora do relógio durante o expediente configurado. */
+export declare class AnalyticsDashboardMessageHourDto {
+    hour: number;
+    averageSent: number;
+    totalSent: number;
+    openOccurrencesInPeriod: number;
+}
+export declare class AnalyticsDashboardMessagePeakDto {
+    hour: number;
+    totalSent: number;
+    averageSent: number;
+}
 /**
  * Resposta enriquecida de `GET /analytics/dashboard` (mantém campos legados `total`, `byEventType`, `byDomain`).
  */
@@ -44,6 +56,9 @@ export declare class AnalyticsDashboardResponseDto {
     noShowRatePercent: number;
     financialSummary: AnalyticsDashboardFinancialDto;
     topProcedures: AnalyticsDashboardTopProcedureDto[];
+    messagesByClinicHour: AnalyticsDashboardMessageHourDto[];
+    messagesPeakHour: AnalyticsDashboardMessagePeakDto | null;
+    clinicTimezone: string;
     total: number;
     byEventType: Array<{
         eventType: string;

package/dist/analytics/analytics-query.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analytics-query.dto.d.ts","sourceRoot":"","sources":["../../src/analytics/analytics-query.dto.ts"],"names":[],"mappings":"AAYA,OAAO,EAAwB,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,kBAAkB,2CAA4C,CAAC;AAC5E,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE;;GAEG;AACH,qBAAa,uBAAuB;IAMlC,SAAS,EAAE,MAAM,CAAC;IAOlB,OAAO,EAAE,MAAM,CAAC;IAShB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAS9B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAO3B,IAAI,CAAC,EAAE,MAAM,CAAC;IAOd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,0BAA0B;IAMrC,SAAS,EAAE,MAAM,CAAC;IAOlB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,8FAA8F;AAC9F,qBAAa,8BAA8B;IAKzC,OAAO,EAAE,MAAM,CAAC;IAMhB,aAAa,EAAE,MAAM,CAAC;IAMtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,iCAAiC;IAE5C,IAAI,EAAE,MAAM,CAAC;IAGb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,6BAA6B;IAExC,mBAAmB,EAAE,MAAM,CAAC;IAG5B,oBAAoB,EAAE,MAAM,CAAC;IAM7B,mBAAmB,EAAE,MAAM,CAAC;IAK5B,kBAAkB,EAAE,MAAM,CAAC;IAO3B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAMnC,iBAAiB,EAAE,MAAM,CAAC;IAG1B,gBAAgB,EAAE,8BAA8B,CAAC;IAGjD,aAAa,EAAE,iCAAiC,EAAE,CAAC;IAGnD,KAAK,EAAE,MAAM,CAAC;IAKd,WAAW,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAKzD,QAAQ,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD"}
+{"version":3,"file":"analytics-query.dto.d.ts","sourceRoot":"","sources":["../../src/analytics/analytics-query.dto.ts"],"names":[],"mappings":"AAYA,OAAO,EAAwB,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,kBAAkB,2CAA4C,CAAC;AAC5E,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE;;GAEG;AACH,qBAAa,uBAAuB;IAMlC,SAAS,EAAE,MAAM,CAAC;IAOlB,OAAO,EAAE,MAAM,CAAC;IAShB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAS9B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAO3B,IAAI,CAAC,EAAE,MAAM,CAAC;IAOd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,0BAA0B;IAMrC,SAAS,EAAE,MAAM,CAAC;IAOlB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,8FAA8F;AAC9F,qBAAa,8BAA8B;IAKzC,OAAO,EAAE,MAAM,CAAC;IAMhB,aAAa,EAAE,MAAM,CAAC;IAMtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,iCAAiC;IAE5C,IAAI,EAAE,MAAM,CAAC;IAGb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,oFAAoF;AACpF,qBAAa,gCAAgC;IAE3C,IAAI,EAAE,MAAM,CAAC;IAMb,WAAW,EAAE,MAAM,CAAC;IAGpB,SAAS,EAAE,MAAM,CAAC;IAMlB,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED,qBAAa,gCAAgC;IAE3C,IAAI,EAAE,MAAM,CAAC;IAEE,SAAS,EAAE,MAAM,CAAC;IAElB,WAAW,EAAE,MAAM,CAAC;CACpC;AAED;;GAEG;AACH,qBAAa,6BAA6B;IAExC,mBAAmB,EAAE,MAAM,CAAC;IAG5B,oBAAoB,EAAE,MAAM,CAAC;IAM7B,mBAAmB,EAAE,MAAM,CAAC;IAK5B,kBAAkB,EAAE,MAAM,CAAC;IAO3B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAMnC,iBAAiB,EAAE,MAAM,CAAC;IAG1B,gBAAgB,EAAE,8BAA8B,CAAC;IAGjD,aAAa,EAAE,iCAAiC,EAAE,CAAC;IAOnD,oBAAoB,EAAE,gCAAgC,EAAE,CAAC;IAOzD,gBAAgB,EAAE,gCAAgC,GAAG,IAAI,CAAC;IAM1D,cAAc,EAAE,MAAM,CAAC;IAGvB,KAAK,EAAE,MAAM,CAAC;IAKd,WAAW,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAKzD,QAAQ,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD"}

package/dist/analytics/analytics-query.dto.js

@@ -9,7 +9,7 @@ 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.AnalyticsDashboardResponseDto = exports.AnalyticsDashboardTopProcedureDto = exports.AnalyticsDashboardFinancialDto = exports.AnalyticsDashboardQueryDto = exports.AnalyticsReportQueryDto = exports.ANALYTICS_GROUP_BY = void 0;
+exports.AnalyticsDashboardResponseDto = exports.AnalyticsDashboardMessagePeakDto = exports.AnalyticsDashboardMessageHourDto = exports.AnalyticsDashboardTopProcedureDto = exports.AnalyticsDashboardFinancialDto = exports.AnalyticsDashboardQueryDto = exports.AnalyticsReportQueryDto = exports.ANALYTICS_GROUP_BY = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
 const class_transformer_1 = require("class-transformer");
@@ -127,7 +127,7 @@ __decorate([
 ], AnalyticsDashboardFinancialDto.prototype, "averageTicket", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Volume de cobranças criadas no período ainda não quitadas no momento do registro: soma de `payment.created` + faturas `billing.invoice_created` com status PENDING ou OVERDUE no metadata (aproximação; não substitui saldo contábil)',
+        description: 'Valor ainda em aberto no fim do período (exclusive endDate): soma de `payment.created` no intervalo sem `payment.payed` correspondente (mesmo paymentId) com occurredAt anterior a endDate; mais faturas `billing.invoice_created` PENDING/OVERDUE sem `billing.invoice_paid` (mesmo invoiceId). Baseado em eventos de analytics.',
     }),
     __metadata("design:type", Number)
 ], AnalyticsDashboardFinancialDto.prototype, "pending", void 0);
@@ -144,6 +144,52 @@ __decorate([
     (0, swagger_1.ApiProperty)({ description: 'Quantidade de ocorrências no período' }),
     __metadata("design:type", Number)
 ], AnalyticsDashboardTopProcedureDto.prototype, "count", void 0);
+/** Média de `message.sent` por hora do relógio durante o expediente configurado. */
+class AnalyticsDashboardMessageHourDto {
+    hour;
+    averageSent;
+    totalSent;
+    openOccurrencesInPeriod;
+}
+exports.AnalyticsDashboardMessageHourDto = AnalyticsDashboardMessageHourDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Hora local (0–23) no fuso clinicTimezone' }),
+    __metadata("design:type", Number)
+], AnalyticsDashboardMessageHourDto.prototype, "hour", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Média de mensagens enviadas nessa hora: totalSent / openOccurrencesInPeriod (0 se não houve expediente nessa hora no período)',
+    }),
+    __metadata("design:type", Number)
+], AnalyticsDashboardMessageHourDto.prototype, "averageSent", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Total de eventos message.sent nessa hora local, só dentro do horário da clínica' }),
+    __metadata("design:type", Number)
+], AnalyticsDashboardMessageHourDto.prototype, "totalSent", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Quantas vezes essa hora calendário integrou o expediente (dias locais no intervalo × slots de opening_hours)',
+    }),
+    __metadata("design:type", Number)
+], AnalyticsDashboardMessageHourDto.prototype, "openOccurrencesInPeriod", void 0);
+class AnalyticsDashboardMessagePeakDto {
+    hour;
+    totalSent;
+    averageSent;
+}
+exports.AnalyticsDashboardMessagePeakDto = AnalyticsDashboardMessagePeakDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Hora local (0–23) com maior totalSent entre as horas de expediente' }),
+    __metadata("design:type", Number)
+], AnalyticsDashboardMessagePeakDto.prototype, "hour", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)(),
+    __metadata("design:type", Number)
+], AnalyticsDashboardMessagePeakDto.prototype, "totalSent", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)(),
+    __metadata("design:type", Number)
+], AnalyticsDashboardMessagePeakDto.prototype, "averageSent", void 0);
 /**
  * Resposta enriquecida de `GET /analytics/dashboard` (mantém campos legados `total`, `byEventType`, `byDomain`).
  */
@@ -156,6 +202,9 @@ class AnalyticsDashboardResponseDto {
     noShowRatePercent;
     financialSummary;
     topProcedures;
+    messagesByClinicHour;
+    messagesPeakHour;
+    clinicTimezone;
     total;
     byEventType;
     byDomain;
@@ -202,6 +251,28 @@ __decorate([
     (0, swagger_1.ApiProperty)({ type: [AnalyticsDashboardTopProcedureDto], maxItems: 5 }),
     __metadata("design:type", Array)
 ], AnalyticsDashboardResponseDto.prototype, "topProcedures", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Pico / distribuição de mensagens no horário da clínica: médias por hora local (só `message.sent` dentro de opening_hours). Ordenado por hora crescente. Vazio se não houver opening_hours.',
+        type: [AnalyticsDashboardMessageHourDto],
+    }),
+    __metadata("design:type", Array)
+], AnalyticsDashboardResponseDto.prototype, "messagesByClinicHour", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Hora com maior volume de mensagens no expediente; null se não houver dados ou horário configurado',
+        nullable: true,
+        type: AnalyticsDashboardMessagePeakDto,
+    }),
+    __metadata("design:type", Object)
+], AnalyticsDashboardResponseDto.prototype, "messagesPeakHour", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Fuso IANA usado para hora local e opening_hours (env ANALYTICS_CLINIC_TIMEZONE ou America/Sao_Paulo)',
+        example: 'America/Sao_Paulo',
+    }),
+    __metadata("design:type", String)
+], AnalyticsDashboardResponseDto.prototype, "clinicTimezone", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({ description: 'Total de eventos de analytics no período (legado)' }),
     __metadata("design:type", Number)

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/package.json

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

package/src/analytics/analytics-query.dto.ts

@@ -104,7 +104,7 @@ export class AnalyticsDashboardFinancialDto {
 
   @ApiProperty({
     description:
-      'Volume de cobranças criadas no período ainda não quitadas no momento do registro: soma de `payment.created` + faturas `billing.invoice_created` com status PENDING ou OVERDUE no metadata (aproximação; não substitui saldo contábil)',
+      'Valor ainda em aberto no fim do período (exclusive endDate): soma de `payment.created` no intervalo sem `payment.payed` correspondente (mesmo paymentId) com occurredAt anterior a endDate; mais faturas `billing.invoice_created` PENDING/OVERDUE sem `billing.invoice_paid` (mesmo invoiceId). Baseado em eventos de analytics.',
   })
   pending: number;
 }
@@ -117,6 +117,36 @@ export class AnalyticsDashboardTopProcedureDto {
   count: number;
 }
 
+/** Média de `message.sent` por hora do relógio durante o expediente configurado. */
+export class AnalyticsDashboardMessageHourDto {
+  @ApiProperty({ description: 'Hora local (0–23) no fuso clinicTimezone' })
+  hour: number;
+
+  @ApiProperty({
+    description:
+      'Média de mensagens enviadas nessa hora: totalSent / openOccurrencesInPeriod (0 se não houve expediente nessa hora no período)',
+  })
+  averageSent: number;
+
+  @ApiProperty({ description: 'Total de eventos message.sent nessa hora local, só dentro do horário da clínica' })
+  totalSent: number;
+
+  @ApiProperty({
+    description:
+      'Quantas vezes essa hora calendário integrou o expediente (dias locais no intervalo × slots de opening_hours)',
+  })
+  openOccurrencesInPeriod: number;
+}
+
+export class AnalyticsDashboardMessagePeakDto {
+  @ApiProperty({ description: 'Hora local (0–23) com maior totalSent entre as horas de expediente' })
+  hour: number;
+
+  @ApiProperty() totalSent: number;
+
+  @ApiProperty() averageSent: number;
+}
+
 /**
  * Resposta enriquecida de `GET /analytics/dashboard` (mantém campos legados `total`, `byEventType`, `byDomain`).
  */
@@ -157,6 +187,26 @@ export class AnalyticsDashboardResponseDto {
   @ApiProperty({ type: [AnalyticsDashboardTopProcedureDto], maxItems: 5 })
   topProcedures: AnalyticsDashboardTopProcedureDto[];
 
+  @ApiProperty({
+    description:
+      'Pico / distribuição de mensagens no horário da clínica: médias por hora local (só `message.sent` dentro de opening_hours). Ordenado por hora crescente. Vazio se não houver opening_hours.',
+    type: [AnalyticsDashboardMessageHourDto],
+  })
+  messagesByClinicHour: AnalyticsDashboardMessageHourDto[];
+
+  @ApiProperty({
+    description: 'Hora com maior volume de mensagens no expediente; null se não houver dados ou horário configurado',
+    nullable: true,
+    type: AnalyticsDashboardMessagePeakDto,
+  })
+  messagesPeakHour: AnalyticsDashboardMessagePeakDto | null;
+
+  @ApiProperty({
+    description: 'Fuso IANA usado para hora local e opening_hours (env ANALYTICS_CLINIC_TIMEZONE ou America/Sao_Paulo)',
+    example: 'America/Sao_Paulo',
+  })
+  clinicTimezone: string;
+
   @ApiProperty({ description: 'Total de eventos de analytics no período (legado)' })
   total: number;
 

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;
+}