tychat-contracts 1.3.6 → 1.3.8

package/dist/notifications/admin-broadcast-push.dto.d.ts

@@ -1,3 +1,5 @@
+export declare const ADMIN_NOTIFICATION_KINDS: readonly ["notification", "alert"];
+export type AdminNotificationKind = (typeof ADMIN_NOTIFICATION_KINDS)[number];
 /**
  * Pedido de envio em massa de push (FCM) disparado pelo painel admin.
  * O tenant-service publica no Kafka; o notifications-service consome e envia.
@@ -9,6 +11,7 @@ export declare class AdminBroadcastPushDto {
     userIds?: string[];
     title: string;
     body: string;
+    notificationKind?: AdminNotificationKind;
     data?: Record<string, string>;
 }
 //# sourceMappingURL=admin-broadcast-push.dto.d.ts.map

package/dist/notifications/admin-broadcast-push.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"admin-broadcast-push.dto.d.ts","sourceRoot":"","sources":["../../src/notifications/admin-broadcast-push.dto.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,qBAAa,qBAAqB;IAGhC,UAAU,EAAG,OAAO,CAAC;IAUrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAIvB,QAAQ,EAAG,OAAO,CAAC;IAUnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAKnB,KAAK,EAAG,MAAM,CAAC;IAKf,IAAI,EAAG,MAAM,CAAC;IASd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B"}
+{"version":3,"file":"admin-broadcast-push.dto.d.ts","sourceRoot":"","sources":["../../src/notifications/admin-broadcast-push.dto.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,wBAAwB,oCAAqC,CAAC;AAC3E,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E;;;GAGG;AACH,qBAAa,qBAAqB;IAGhC,UAAU,EAAG,OAAO,CAAC;IAUrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAIvB,QAAQ,EAAG,OAAO,CAAC;IAUnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAKnB,KAAK,EAAG,MAAM,CAAC;IAKf,IAAI,EAAG,MAAM,CAAC;IAUd,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IASzC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B"}

package/dist/notifications/admin-broadcast-push.dto.js

@@ -9,9 +9,10 @@ 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.AdminBroadcastPushDto = void 0;
+exports.AdminBroadcastPushDto = exports.ADMIN_NOTIFICATION_KINDS = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
+exports.ADMIN_NOTIFICATION_KINDS = ['notification', 'alert'];
 /**
  * Pedido de envio em massa de push (FCM) disparado pelo painel admin.
  * O tenant-service publica no Kafka; o notifications-service consome e envia.
@@ -23,6 +24,7 @@ class AdminBroadcastPushDto {
     userIds;
     title;
     body;
+    notificationKind;
     data;
 }
 exports.AdminBroadcastPushDto = AdminBroadcastPushDto;
@@ -70,6 +72,17 @@ __decorate([
     (0, class_validator_1.MaxLength)(4000),
     __metadata("design:type", String)
 ], AdminBroadcastPushDto.prototype, "body", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Categoria de entrega no app (notification = centro; alert = modal no login).',
+        enum: exports.ADMIN_NOTIFICATION_KINDS,
+        default: 'notification',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsIn)(exports.ADMIN_NOTIFICATION_KINDS),
+    __metadata("design:type", String)
+], AdminBroadcastPushDto.prototype, "notificationKind", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
         description: 'Payload FCM `data` (valores devem ser strings)',

package/dist/notifications/index.d.ts

@@ -1,6 +1,6 @@
-export { NotificationUserCreatedEventPayload, NotificationPasswordResetRequestedEventPayload, NotificationConversationChangeToHumanEventPayload, } from './notifications-kafka.payloads';
-export { TOPIC_NOTIFICATIONS_FIND_ALL, TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN, TOPIC_NOTIFICATIONS_UPDATE_VIEWED, EVENT_NOTIFICATIONS_ADMIN_BROADCAST_PUSH, EVENT_NOTIFICATIONS_CONVERSATION_HANDOFF_PUSH, } from './notifications-kafka-topics';
-export { AdminBroadcastPushDto } from './admin-broadcast-push.dto';
+export { NotificationUserCreatedEventPayload, NotificationPasswordResetRequestedEventPayload, NotificationConversationChangeToHumanEventPayload, NotificationTenantAiTokensThresholdEventPayload, } from './notifications-kafka.payloads';
+export { TOPIC_NOTIFICATIONS_FIND_ALL, TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN, TOPIC_NOTIFICATIONS_UPDATE_VIEWED, EVENT_NOTIFICATIONS_ADMIN_BROADCAST_PUSH, EVENT_NOTIFICATIONS_CONVERSATION_HANDOFF_PUSH, EVENT_NOTIFICATIONS_TENANT_AI_TOKENS_THRESHOLD, } from './notifications-kafka-topics';
+export { AdminBroadcastPushDto, ADMIN_NOTIFICATION_KINDS, type AdminNotificationKind, } 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';

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,EAC9C,iDAAiD,GAClD,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,4BAA4B,EAC5B,uCAAuC,EACvC,iCAAiC,EACjC,wCAAwC,EACxC,6CAA6C,GAC9C,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mCAAmC,EACnC,8CAA8C,EAC9C,iDAAiD,EACjD,+CAA+C,GAChD,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,4BAA4B,EAC5B,uCAAuC,EACvC,iCAAiC,EACjC,wCAAwC,EACxC,6CAA6C,EAC7C,8CAA8C,GAC/C,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,4BAA4B,CAAC;AACpC,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,18 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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_CONVERSATION_HANDOFF_PUSH = exports.EVENT_NOTIFICATIONS_ADMIN_BROADCAST_PUSH = exports.TOPIC_NOTIFICATIONS_UPDATE_VIEWED = exports.TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN = exports.TOPIC_NOTIFICATIONS_FIND_ALL = exports.NotificationConversationChangeToHumanEventPayload = 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.ADMIN_NOTIFICATION_KINDS = exports.AdminBroadcastPushDto = exports.EVENT_NOTIFICATIONS_TENANT_AI_TOKENS_THRESHOLD = exports.EVENT_NOTIFICATIONS_CONVERSATION_HANDOFF_PUSH = exports.EVENT_NOTIFICATIONS_ADMIN_BROADCAST_PUSH = exports.TOPIC_NOTIFICATIONS_UPDATE_VIEWED = exports.TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN = exports.TOPIC_NOTIFICATIONS_FIND_ALL = exports.NotificationTenantAiTokensThresholdEventPayload = exports.NotificationConversationChangeToHumanEventPayload = 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; } });
 Object.defineProperty(exports, "NotificationConversationChangeToHumanEventPayload", { enumerable: true, get: function () { return notifications_kafka_payloads_1.NotificationConversationChangeToHumanEventPayload; } });
+Object.defineProperty(exports, "NotificationTenantAiTokensThresholdEventPayload", { enumerable: true, get: function () { return notifications_kafka_payloads_1.NotificationTenantAiTokensThresholdEventPayload; } });
 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; } });
 Object.defineProperty(exports, "EVENT_NOTIFICATIONS_ADMIN_BROADCAST_PUSH", { enumerable: true, get: function () { return notifications_kafka_topics_1.EVENT_NOTIFICATIONS_ADMIN_BROADCAST_PUSH; } });
 Object.defineProperty(exports, "EVENT_NOTIFICATIONS_CONVERSATION_HANDOFF_PUSH", { enumerable: true, get: function () { return notifications_kafka_topics_1.EVENT_NOTIFICATIONS_CONVERSATION_HANDOFF_PUSH; } });
+Object.defineProperty(exports, "EVENT_NOTIFICATIONS_TENANT_AI_TOKENS_THRESHOLD", { enumerable: true, get: function () { return notifications_kafka_topics_1.EVENT_NOTIFICATIONS_TENANT_AI_TOKENS_THRESHOLD; } });
 var admin_broadcast_push_dto_1 = require("./admin-broadcast-push.dto");
 Object.defineProperty(exports, "AdminBroadcastPushDto", { enumerable: true, get: function () { return admin_broadcast_push_dto_1.AdminBroadcastPushDto; } });
+Object.defineProperty(exports, "ADMIN_NOTIFICATION_KINDS", { enumerable: true, get: function () { return admin_broadcast_push_dto_1.ADMIN_NOTIFICATION_KINDS; } });
 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; } });

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

@@ -1,9 +1,11 @@
+import { type AdminNotificationKind } from './admin-broadcast-push.dto';
 /** Item retornado em GET /notifications (e RPC notifications.findAll). */
 export declare class NotificationListItemDto {
     id: string;
     notificationEvent: string;
     provider: string;
     status: string;
+    kind: AdminNotificationKind;
     createdAt: string;
     updatedAt: string;
     viewed: boolean;

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;IAMlB,MAAM,EAAE,OAAO,CAAC;IAOhB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAOxB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAOvB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAOtB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB"}
+{"version":3,"file":"notification-list-item.dto.d.ts","sourceRoot":"","sources":["../../src/notifications/notification-list-item.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAA4B,KAAK,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAElG,0EAA0E;AAC1E,qBAAa,uBAAuB;IAElC,EAAE,EAAE,MAAM,CAAC;IAGX,iBAAiB,EAAE,MAAM,CAAC;IAG1B,QAAQ,EAAE,MAAM,CAAC;IAGjB,MAAM,EAAE,MAAM,CAAC;IAOf,IAAI,EAAE,qBAAqB,CAAC;IAG5B,SAAS,EAAE,MAAM,CAAC;IAGlB,SAAS,EAAE,MAAM,CAAC;IAMlB,MAAM,EAAE,OAAO,CAAC;IAOhB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAOxB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAOvB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAOtB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB"}

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

@@ -11,12 +11,14 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NotificationListItemDto = void 0;
 const swagger_1 = require("@nestjs/swagger");
+const admin_broadcast_push_dto_1 = require("./admin-broadcast-push.dto");
 /** Item retornado em GET /notifications (e RPC notifications.findAll). */
 class NotificationListItemDto {
     id;
     notificationEvent;
     provider;
     status;
+    kind;
     createdAt;
     updatedAt;
     viewed;
@@ -42,6 +44,14 @@ __decorate([
     (0, swagger_1.ApiProperty)({ enum: ['pending', 'sent', 'failed'] }),
     __metadata("design:type", String)
 ], NotificationListItemDto.prototype, "status", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Categoria de exibição no app.',
+        enum: admin_broadcast_push_dto_1.ADMIN_NOTIFICATION_KINDS,
+        default: 'notification',
+    }),
+    __metadata("design:type", String)
+], NotificationListItemDto.prototype, "kind", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({ example: '2026-04-08T12:00:00.000Z' }),
     __metadata("design:type", String)

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

@@ -7,4 +7,6 @@ export declare const TOPIC_NOTIFICATIONS_UPDATE_VIEWED = "notifications.updateVi
 export declare const EVENT_NOTIFICATIONS_ADMIN_BROADCAST_PUSH = "notifications.admin_broadcast_push";
 /** Registo `notifications` / FCM quando a clínica recebe alerta de conversa para humano. */
 export declare const EVENT_NOTIFICATIONS_CONVERSATION_HANDOFF_PUSH = "notifications.conversation_change_to_human_push";
+/** Evento Kafka: alerta de cota mensal de tokens de IA para administradores do tenant. */
+export declare const EVENT_NOTIFICATIONS_TENANT_AI_TOKENS_THRESHOLD = "notifications.tenant_ai_tokens_threshold";
 //# 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;AAEpC,iFAAiF;AACjF,eAAO,MAAM,iCAAiC,+BAA+B,CAAC;AAE9E,8DAA8D;AAC9D,eAAO,MAAM,wCAAwC,uCACf,CAAC;AAEvC,4FAA4F;AAC5F,eAAO,MAAM,6CAA6C,oDACP,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;AAE9E,8DAA8D;AAC9D,eAAO,MAAM,wCAAwC,uCACf,CAAC;AAEvC,4FAA4F;AAC5F,eAAO,MAAM,6CAA6C,oDACP,CAAC;AAEpD,0FAA0F;AAC1F,eAAO,MAAM,8CAA8C,6CACf,CAAC"}

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EVENT_NOTIFICATIONS_CONVERSATION_HANDOFF_PUSH = exports.EVENT_NOTIFICATIONS_ADMIN_BROADCAST_PUSH = exports.TOPIC_NOTIFICATIONS_UPDATE_VIEWED = exports.TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN = exports.TOPIC_NOTIFICATIONS_FIND_ALL = void 0;
+exports.EVENT_NOTIFICATIONS_TENANT_AI_TOKENS_THRESHOLD = exports.EVENT_NOTIFICATIONS_CONVERSATION_HANDOFF_PUSH = exports.EVENT_NOTIFICATIONS_ADMIN_BROADCAST_PUSH = 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';
@@ -10,3 +10,5 @@ exports.TOPIC_NOTIFICATIONS_UPDATE_VIEWED = 'notifications.updateViewed';
 exports.EVENT_NOTIFICATIONS_ADMIN_BROADCAST_PUSH = 'notifications.admin_broadcast_push';
 /** Registo `notifications` / FCM quando a clínica recebe alerta de conversa para humano. */
 exports.EVENT_NOTIFICATIONS_CONVERSATION_HANDOFF_PUSH = 'notifications.conversation_change_to_human_push';
+/** Evento Kafka: alerta de cota mensal de tokens de IA para administradores do tenant. */
+exports.EVENT_NOTIFICATIONS_TENANT_AI_TOKENS_THRESHOLD = 'notifications.tenant_ai_tokens_threshold';

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

@@ -26,4 +26,17 @@ export declare class NotificationConversationChangeToHumanEventPayload {
     isUrgent?: boolean;
     handoffSource?: 'ai' | 'manual';
 }
+/** Evento Kafka `notifications.tenant_ai_tokens_threshold` para alertas de cota de IA. */
+export declare class NotificationTenantAiTokensThresholdEventPayload {
+    eventId: string;
+    tenant: string;
+    thresholdPercent: 70 | 80 | 90 | 100;
+    consumedPercent: number;
+    remainingPercent: number;
+    currentBalance: number;
+    monthlyAllowance: number;
+    cycleStartedAt: string;
+    nextRenewalAt: string;
+    occurredAt: string;
+}
 //# sourceMappingURL=notifications-kafka.payloads.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"notifications-kafka.payloads.d.ts","sourceRoot":"","sources":["../../src/notifications/notifications-kafka.payloads.ts"],"names":[],"mappings":"AAcA,qBAAa,mCAAmC;IAM9C,OAAO,EAAE,MAAM,CAAC;IAShB,MAAM,EAAE,MAAM,CAAC;IAQf,KAAK,EAAE,MAAM,CAAC;IASd,IAAI,EAAE,MAAM,CAAC;IASb,QAAQ,EAAE,MAAM,CAAC;IAOjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,8CAA8C;IAMzD,OAAO,EAAE,MAAM,CAAC;IAShB,MAAM,EAAE,MAAM,CAAC;IAQf,KAAK,EAAE,MAAM,CAAC;IASd,WAAW,EAAE,MAAM,CAAC;IAOpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,+FAA+F;AAC/F,qBAAa,iDAAiD;IAG5D,OAAO,EAAE,MAAM,CAAC;IAMhB,MAAM,EAAE,MAAM,CAAC;IAIf,SAAS,EAAE,MAAM,CAAC;IAKlB,WAAW,EAAE,MAAM,CAAC;IAMpB,MAAM,EAAE,MAAM,CAAC;IAIf,UAAU,EAAE,MAAM,CAAC;IAMnB,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAOhB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAKnB,aAAa,CAAC,EAAE,IAAI,GAAG,QAAQ,CAAC;CACjC"}
+{"version":3,"file":"notifications-kafka.payloads.d.ts","sourceRoot":"","sources":["../../src/notifications/notifications-kafka.payloads.ts"],"names":[],"mappings":"AAiBA,qBAAa,mCAAmC;IAM9C,OAAO,EAAE,MAAM,CAAC;IAShB,MAAM,EAAE,MAAM,CAAC;IAQf,KAAK,EAAE,MAAM,CAAC;IASd,IAAI,EAAE,MAAM,CAAC;IASb,QAAQ,EAAE,MAAM,CAAC;IAOjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,8CAA8C;IAMzD,OAAO,EAAE,MAAM,CAAC;IAShB,MAAM,EAAE,MAAM,CAAC;IAQf,KAAK,EAAE,MAAM,CAAC;IASd,WAAW,EAAE,MAAM,CAAC;IAOpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,+FAA+F;AAC/F,qBAAa,iDAAiD;IAG5D,OAAO,EAAE,MAAM,CAAC;IAMhB,MAAM,EAAE,MAAM,CAAC;IAIf,SAAS,EAAE,MAAM,CAAC;IAKlB,WAAW,EAAE,MAAM,CAAC;IAMpB,MAAM,EAAE,MAAM,CAAC;IAIf,UAAU,EAAE,MAAM,CAAC;IAMnB,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAOhB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAKnB,aAAa,CAAC,EAAE,IAAI,GAAG,QAAQ,CAAC;CACjC;AAED,0FAA0F;AAC1F,qBAAa,+CAA+C;IAG1D,OAAO,EAAE,MAAM,CAAC;IAMhB,MAAM,EAAE,MAAM,CAAC;IASf,gBAAgB,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;IAMrC,eAAe,EAAE,MAAM,CAAC;IAMxB,gBAAgB,EAAE,MAAM,CAAC;IAKzB,cAAc,EAAE,MAAM,CAAC;IAKvB,gBAAgB,EAAE,MAAM,CAAC;IAIzB,cAAc,EAAE,MAAM,CAAC;IAIvB,aAAa,EAAE,MAAM,CAAC;IAItB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/notifications/notifications-kafka.payloads.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.NotificationConversationChangeToHumanEventPayload = exports.NotificationPasswordResetRequestedEventPayload = exports.NotificationUserCreatedEventPayload = void 0;
+exports.NotificationTenantAiTokensThresholdEventPayload = exports.NotificationConversationChangeToHumanEventPayload = exports.NotificationPasswordResetRequestedEventPayload = exports.NotificationUserCreatedEventPayload = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
 class NotificationUserCreatedEventPayload {
@@ -205,3 +205,80 @@ __decorate([
     (0, class_validator_1.IsIn)(['ai', 'manual']),
     __metadata("design:type", String)
 ], NotificationConversationChangeToHumanEventPayload.prototype, "handoffSource", void 0);
+/** Evento Kafka `notifications.tenant_ai_tokens_threshold` para alertas de cota de IA. */
+class NotificationTenantAiTokensThresholdEventPayload {
+    eventId;
+    tenant;
+    thresholdPercent;
+    consumedPercent;
+    remainingPercent;
+    currentBalance;
+    monthlyAllowance;
+    cycleStartedAt;
+    nextRenewalAt;
+    occurredAt;
+}
+exports.NotificationTenantAiTokensThresholdEventPayload = NotificationTenantAiTokensThresholdEventPayload;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Idempotência do evento' }),
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], NotificationTenantAiTokensThresholdEventPayload.prototype, "eventId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Slug do tenant', example: 'default' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(255),
+    __metadata("design:type", String)
+], NotificationTenantAiTokensThresholdEventPayload.prototype, "tenant", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Limiar de consumo atingido em percentual',
+        example: 70,
+        enum: [70, 80, 90, 100],
+    }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.IsIn)([70, 80, 90, 100]),
+    __metadata("design:type", Number)
+], NotificationTenantAiTokensThresholdEventPayload.prototype, "thresholdPercent", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Percentual consumido após o débito', example: 72 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], NotificationTenantAiTokensThresholdEventPayload.prototype, "consumedPercent", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Percentual restante após o débito', example: 28 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], NotificationTenantAiTokensThresholdEventPayload.prototype, "remainingPercent", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Saldo atual de tokens após o débito', example: 2800 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], NotificationTenantAiTokensThresholdEventPayload.prototype, "currentBalance", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Cota mensal total do ciclo', example: 10000 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], NotificationTenantAiTokensThresholdEventPayload.prototype, "monthlyAllowance", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Data de início do ciclo atual (UTC ISO-8601)' }),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], NotificationTenantAiTokensThresholdEventPayload.prototype, "cycleStartedAt", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Data prevista para renovação do ciclo (UTC ISO-8601)' }),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], NotificationTenantAiTokensThresholdEventPayload.prototype, "nextRenewalAt", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Timestamp do disparo (UTC ISO-8601)' }),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], NotificationTenantAiTokensThresholdEventPayload.prototype, "occurredAt", void 0);

package/package.json

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

package/src/notifications/admin-broadcast-push.dto.ts

@@ -3,6 +3,7 @@ import {
   ArrayMinSize,
   IsArray,
   IsBoolean,
+  IsIn,
   IsObject,
   IsOptional,
   IsString,
@@ -11,6 +12,9 @@ import {
   ValidateIf,
 } from 'class-validator';
 
+export const ADMIN_NOTIFICATION_KINDS = ['notification', 'alert'] as const;
+export type AdminNotificationKind = (typeof ADMIN_NOTIFICATION_KINDS)[number];
+
 /**
  * Pedido de envio em massa de push (FCM) disparado pelo painel admin.
  * O tenant-service publica no Kafka; o notifications-service consome e envia.
@@ -54,6 +58,16 @@ export class AdminBroadcastPushDto {
   @MaxLength(4000)
   body!: string;
 
+  @ApiPropertyOptional({
+    description: 'Categoria de entrega no app (notification = centro; alert = modal no login).',
+    enum: ADMIN_NOTIFICATION_KINDS,
+    default: 'notification',
+  })
+  @IsOptional()
+  @IsString()
+  @IsIn(ADMIN_NOTIFICATION_KINDS)
+  notificationKind?: AdminNotificationKind;
+
   @ApiPropertyOptional({
     description: 'Payload FCM `data` (valores devem ser strings)',
     type: 'object',

package/src/notifications/index.ts

@@ -2,6 +2,7 @@ export {
   NotificationUserCreatedEventPayload,
   NotificationPasswordResetRequestedEventPayload,
   NotificationConversationChangeToHumanEventPayload,
+  NotificationTenantAiTokensThresholdEventPayload,
 } from './notifications-kafka.payloads';
 export {
   TOPIC_NOTIFICATIONS_FIND_ALL,
@@ -9,8 +10,13 @@ export {
   TOPIC_NOTIFICATIONS_UPDATE_VIEWED,
   EVENT_NOTIFICATIONS_ADMIN_BROADCAST_PUSH,
   EVENT_NOTIFICATIONS_CONVERSATION_HANDOFF_PUSH,
+  EVENT_NOTIFICATIONS_TENANT_AI_TOKENS_THRESHOLD,
 } from './notifications-kafka-topics';
-export { AdminBroadcastPushDto } from './admin-broadcast-push.dto';
+export {
+  AdminBroadcastPushDto,
+  ADMIN_NOTIFICATION_KINDS,
+  type AdminNotificationKind,
+} from './admin-broadcast-push.dto';
 export {
   RegisterPushTokenDto,
   NotificationsRegisterPushTokenKafkaDto,

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

@@ -1,4 +1,5 @@
 import { ApiProperty } from '@nestjs/swagger';
+import { ADMIN_NOTIFICATION_KINDS, type AdminNotificationKind } from './admin-broadcast-push.dto';
 
 /** Item retornado em GET /notifications (e RPC notifications.findAll). */
 export class NotificationListItemDto {
@@ -14,6 +15,13 @@ export class NotificationListItemDto {
   @ApiProperty({ enum: ['pending', 'sent', 'failed'] })
   status: string;
 
+  @ApiProperty({
+    description: 'Categoria de exibição no app.',
+    enum: ADMIN_NOTIFICATION_KINDS,
+    default: 'notification',
+  })
+  kind: AdminNotificationKind;
+
   @ApiProperty({ example: '2026-04-08T12:00:00.000Z' })
   createdAt: string;
 

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

@@ -14,3 +14,7 @@ export const EVENT_NOTIFICATIONS_ADMIN_BROADCAST_PUSH =
 /** Registo `notifications` / FCM quando a clínica recebe alerta de conversa para humano. */
 export const EVENT_NOTIFICATIONS_CONVERSATION_HANDOFF_PUSH =
   'notifications.conversation_change_to_human_push';
+
+/** Evento Kafka: alerta de cota mensal de tokens de IA para administradores do tenant. */
+export const EVENT_NOTIFICATIONS_TENANT_AI_TOKENS_THRESHOLD =
+  'notifications.tenant_ai_tokens_threshold';

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

@@ -4,11 +4,14 @@ import {
   IsEmail,
   IsIn,
   IsISO8601,
+  IsInt,
   IsNumber,
   IsOptional,
   IsString,
   IsUUID,
+  Max,
   MaxLength,
+  Min,
   MinLength,
 } from 'class-validator';
 
@@ -159,3 +162,59 @@ export class NotificationConversationChangeToHumanEventPayload {
   @IsIn(['ai', 'manual'])
   handoffSource?: 'ai' | 'manual';
 }
+
+/** Evento Kafka `notifications.tenant_ai_tokens_threshold` para alertas de cota de IA. */
+export class NotificationTenantAiTokensThresholdEventPayload {
+  @ApiProperty({ description: 'Idempotência do evento' })
+  @IsUUID()
+  eventId: string;
+
+  @ApiProperty({ description: 'Slug do tenant', example: 'default' })
+  @IsString()
+  @MinLength(1)
+  @MaxLength(255)
+  tenant: string;
+
+  @ApiProperty({
+    description: 'Limiar de consumo atingido em percentual',
+    example: 70,
+    enum: [70, 80, 90, 100],
+  })
+  @IsInt()
+  @IsIn([70, 80, 90, 100])
+  thresholdPercent: 70 | 80 | 90 | 100;
+
+  @ApiProperty({ description: 'Percentual consumido após o débito', example: 72 })
+  @IsInt()
+  @Min(0)
+  @Max(100)
+  consumedPercent: number;
+
+  @ApiProperty({ description: 'Percentual restante após o débito', example: 28 })
+  @IsInt()
+  @Min(0)
+  @Max(100)
+  remainingPercent: number;
+
+  @ApiProperty({ description: 'Saldo atual de tokens após o débito', example: 2800 })
+  @IsInt()
+  @Min(0)
+  currentBalance: number;
+
+  @ApiProperty({ description: 'Cota mensal total do ciclo', example: 10000 })
+  @IsInt()
+  @Min(0)
+  monthlyAllowance: number;
+
+  @ApiProperty({ description: 'Data de início do ciclo atual (UTC ISO-8601)' })
+  @IsISO8601()
+  cycleStartedAt: string;
+
+  @ApiProperty({ description: 'Data prevista para renovação do ciclo (UTC ISO-8601)' })
+  @IsISO8601()
+  nextRenewalAt: string;
+
+  @ApiProperty({ description: 'Timestamp do disparo (UTC ISO-8601)' })
+  @IsISO8601()
+  occurredAt: string;
+}