tychat-contracts 1.0.92 → 1.0.94

package/dist/analytics/index.d.ts

@@ -4,5 +4,4 @@ export * from './create-analytic-event.dto';
 export * from './analytics-query.dto';
 export * from './analytics-kafka-topics';
 export * from './analytics-emitter.helper';
-export * from './should-skip-analytics-tenant-lookup';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uCAAuC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC"}

package/dist/analytics/index.js

@@ -20,4 +20,3 @@ __exportStar(require("./create-analytic-event.dto"), exports);
 __exportStar(require("./analytics-query.dto"), exports);
 __exportStar(require("./analytics-kafka-topics"), exports);
 __exportStar(require("./analytics-emitter.helper"), exports);
-__exportStar(require("./should-skip-analytics-tenant-lookup"), exports);

package/dist/notifications/index.d.ts

@@ -1,2 +1,6 @@
 export { NotificationUserCreatedEventPayload, NotificationPasswordResetRequestedEventPayload, } from './notifications-kafka.payloads';
+export { TOPIC_NOTIFICATIONS_FIND_ALL, TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN, } 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';
 //# 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"}
+{"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"}

package/dist/notifications/index.js

@@ -1,6 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NotificationPasswordResetRequestedEventPayload = exports.NotificationUserCreatedEventPayload = void 0;
+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;
 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; } });
+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; } });
+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 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; } });

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

@@ -0,0 +1,15 @@
+export declare const NOTIFICATION_PROVIDER_FILTERS: readonly ["email", "whatsapp", "sms", "push"];
+export type NotificationProviderFilterDto = (typeof NOTIFICATION_PROVIDER_FILTERS)[number];
+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.
+ */
+export declare class ListNotificationsQueryDto {
+    page?: number;
+    limit?: number;
+    provider?: NotificationProviderFilterDto;
+    status?: NotificationStatusFilterDto;
+    notificationEvent?: string;
+}
+//# sourceMappingURL=list-notifications-query.dto.d.ts.map

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

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

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

@@ -0,0 +1,82 @@
+"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.ListNotificationsQueryDto = exports.NOTIFICATION_STATUS_FILTERS = exports.NOTIFICATION_PROVIDER_FILTERS = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+exports.NOTIFICATION_PROVIDER_FILTERS = [
+    'email',
+    'whatsapp',
+    'sms',
+    'push',
+];
+exports.NOTIFICATION_STATUS_FILTERS = [
+    'pending',
+    'sent',
+    'failed',
+];
+/**
+ * Query HTTP + payload Kafka para listar notificações do tenant.
+ */
+class ListNotificationsQueryDto {
+    page;
+    limit;
+    provider;
+    status;
+    notificationEvent;
+}
+exports.ListNotificationsQueryDto = ListNotificationsQueryDto;
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ minimum: 1, default: 1 }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], ListNotificationsQueryDto.prototype, "page", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ minimum: 1, maximum: 100, default: 20 }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], ListNotificationsQueryDto.prototype, "limit", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        enum: exports.NOTIFICATION_PROVIDER_FILTERS,
+        description: 'Filtrar por canal',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsIn)([...exports.NOTIFICATION_PROVIDER_FILTERS]),
+    __metadata("design:type", String)
+], ListNotificationsQueryDto.prototype, "provider", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        enum: exports.NOTIFICATION_STATUS_FILTERS,
+        description: 'Filtrar por status',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsIn)([...exports.NOTIFICATION_STATUS_FILTERS]),
+    __metadata("design:type", String)
+], ListNotificationsQueryDto.prototype, "status", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Filtrar por evento (igualdade exata, ex.: notifications.user_created)',
+        maxLength: 255,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(255),
+    __metadata("design:type", String)
+], ListNotificationsQueryDto.prototype, "notificationEvent", void 0);

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

@@ -0,0 +1,10 @@
+/** Item retornado em GET /notifications (e RPC notifications.findAll). */
+export declare class NotificationListItemDto {
+    id: string;
+    notificationEvent: string;
+    provider: string;
+    status: string;
+    createdAt: string;
+    updatedAt: string;
+}
+//# sourceMappingURL=notification-list-item.dto.d.ts.map

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

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

package/dist/notifications/notification-list-item.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.NotificationListItemDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+/** Item retornado em GET /notifications (e RPC notifications.findAll). */
+class NotificationListItemDto {
+    id;
+    notificationEvent;
+    provider;
+    status;
+    createdAt;
+    updatedAt;
+}
+exports.NotificationListItemDto = NotificationListItemDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ format: 'uuid' }),
+    __metadata("design:type", String)
+], NotificationListItemDto.prototype, "id", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 'notifications.user_created' }),
+    __metadata("design:type", String)
+], NotificationListItemDto.prototype, "notificationEvent", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ enum: ['email', 'whatsapp', 'sms', 'push'] }),
+    __metadata("design:type", String)
+], NotificationListItemDto.prototype, "provider", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ enum: ['pending', 'sent', 'failed'] }),
+    __metadata("design:type", String)
+], NotificationListItemDto.prototype, "status", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: '2026-04-08T12:00:00.000Z' }),
+    __metadata("design:type", String)
+], NotificationListItemDto.prototype, "createdAt", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: '2026-04-08T12:00:00.000Z' }),
+    __metadata("design:type", String)
+], NotificationListItemDto.prototype, "updatedAt", void 0);

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

@@ -0,0 +1,4 @@
+/** 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";
+//# sourceMappingURL=notifications-kafka-topics.d.ts.map

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

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

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

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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';

package/dist/notifications/register-push-token.dto.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Corpo HTTP e campo `payload` no RPC Kafka para registrar token FCM do utilizador autenticado.
+ */
+export declare class RegisterPushTokenDto {
+    token: string;
+}
+/**
+ * Payload Kafka `notifications.registerPushToken`.
+ */
+export declare class NotificationsRegisterPushTokenKafkaDto {
+    tenant: string;
+    userId: string;
+    payload: RegisterPushTokenDto;
+}
+//# sourceMappingURL=register-push-token.dto.d.ts.map

package/dist/notifications/register-push-token.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-push-token.dto.d.ts","sourceRoot":"","sources":["../../src/notifications/register-push-token.dto.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,qBAAa,oBAAoB;IAS/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,sCAAsC;IAGjD,MAAM,EAAE,MAAM,CAAC;IAGf,MAAM,EAAE,MAAM,CAAC;IAIf,OAAO,EAAE,oBAAoB,CAAC;CAC/B"}

package/dist/notifications/register-push-token.dto.js

@@ -0,0 +1,56 @@
+"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.NotificationsRegisterPushTokenKafkaDto = exports.RegisterPushTokenDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Corpo HTTP e campo `payload` no RPC Kafka para registrar token FCM do utilizador autenticado.
+ */
+class RegisterPushTokenDto {
+    token;
+}
+exports.RegisterPushTokenDto = RegisterPushTokenDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Token FCM (Firebase Cloud Messaging) do dispositivo',
+        example: 'dK3p...',
+        maxLength: 4096,
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(4096),
+    __metadata("design:type", String)
+], RegisterPushTokenDto.prototype, "token", void 0);
+/**
+ * Payload Kafka `notifications.registerPushToken`.
+ */
+class NotificationsRegisterPushTokenKafkaDto {
+    tenant;
+    userId;
+    payload;
+}
+exports.NotificationsRegisterPushTokenKafkaDto = NotificationsRegisterPushTokenKafkaDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], NotificationsRegisterPushTokenKafkaDto.prototype, "tenant", void 0);
+__decorate([
+    (0, class_validator_1.IsUUID)('4'),
+    __metadata("design:type", String)
+], NotificationsRegisterPushTokenKafkaDto.prototype, "userId", void 0);
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => RegisterPushTokenDto),
+    __metadata("design:type", RegisterPushTokenDto)
+], NotificationsRegisterPushTokenKafkaDto.prototype, "payload", void 0);

package/package.json

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

package/src/analytics/index.ts

@@ -4,4 +4,3 @@ export * from './create-analytic-event.dto';
 export * from './analytics-query.dto';
 export * from './analytics-kafka-topics';
 export * from './analytics-emitter.helper';
-export * from './should-skip-analytics-tenant-lookup';

package/src/notifications/index.ts

@@ -2,3 +2,19 @@ export {
   NotificationUserCreatedEventPayload,
   NotificationPasswordResetRequestedEventPayload,
 } from './notifications-kafka.payloads';
+export {
+  TOPIC_NOTIFICATIONS_FIND_ALL,
+  TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN,
+} 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';

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

@@ -0,0 +1,65 @@
+import { ApiPropertyOptional } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import { IsIn, IsInt, IsOptional, IsString, Max, MaxLength, Min } from 'class-validator';
+
+export const NOTIFICATION_PROVIDER_FILTERS = [
+  'email',
+  'whatsapp',
+  'sms',
+  'push',
+] as const;
+export type NotificationProviderFilterDto =
+  (typeof NOTIFICATION_PROVIDER_FILTERS)[number];
+
+export const NOTIFICATION_STATUS_FILTERS = [
+  'pending',
+  'sent',
+  'failed',
+] as const;
+export type NotificationStatusFilterDto =
+  (typeof NOTIFICATION_STATUS_FILTERS)[number];
+
+/**
+ * Query HTTP + payload Kafka para listar notificações do tenant.
+ */
+export class ListNotificationsQueryDto {
+  @ApiPropertyOptional({ minimum: 1, default: 1 })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  page?: number;
+
+  @ApiPropertyOptional({ minimum: 1, maximum: 100, default: 20 })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  @Max(100)
+  limit?: number;
+
+  @ApiPropertyOptional({
+    enum: NOTIFICATION_PROVIDER_FILTERS,
+    description: 'Filtrar por canal',
+  })
+  @IsOptional()
+  @IsIn([...NOTIFICATION_PROVIDER_FILTERS])
+  provider?: NotificationProviderFilterDto;
+
+  @ApiPropertyOptional({
+    enum: NOTIFICATION_STATUS_FILTERS,
+    description: 'Filtrar por status',
+  })
+  @IsOptional()
+  @IsIn([...NOTIFICATION_STATUS_FILTERS])
+  status?: NotificationStatusFilterDto;
+
+  @ApiPropertyOptional({
+    description: 'Filtrar por evento (igualdade exata, ex.: notifications.user_created)',
+    maxLength: 255,
+  })
+  @IsOptional()
+  @IsString()
+  @MaxLength(255)
+  notificationEvent?: string;
+}

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

@@ -0,0 +1,22 @@
+import { ApiProperty } from '@nestjs/swagger';
+
+/** Item retornado em GET /notifications (e RPC notifications.findAll). */
+export class NotificationListItemDto {
+  @ApiProperty({ format: 'uuid' })
+  id: string;
+
+  @ApiProperty({ example: 'notifications.user_created' })
+  notificationEvent: string;
+
+  @ApiProperty({ enum: ['email', 'whatsapp', 'sms', 'push'] })
+  provider: string;
+
+  @ApiProperty({ enum: ['pending', 'sent', 'failed'] })
+  status: string;
+
+  @ApiProperty({ example: '2026-04-08T12:00:00.000Z' })
+  createdAt: string;
+
+  @ApiProperty({ example: '2026-04-08T12:00:00.000Z' })
+  updatedAt: string;
+}

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

@@ -0,0 +1,5 @@
+/** Kafka request–reply: lista notificações persistidas no banco do tenant. */
+export const TOPIC_NOTIFICATIONS_FIND_ALL = 'notifications.findAll';
+
+export const TOPIC_NOTIFICATIONS_REGISTER_PUSH_TOKEN =
+  'notifications.registerPushToken';

package/src/notifications/register-push-token.dto.ts

@@ -0,0 +1,40 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import {
+  IsNotEmpty,
+  IsString,
+  IsUUID,
+  MaxLength,
+  ValidateNested,
+} from 'class-validator';
+
+/**
+ * Corpo HTTP e campo `payload` no RPC Kafka para registrar token FCM do utilizador autenticado.
+ */
+export class RegisterPushTokenDto {
+  @ApiProperty({
+    description: 'Token FCM (Firebase Cloud Messaging) do dispositivo',
+    example: 'dK3p...',
+    maxLength: 4096,
+  })
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(4096)
+  token: string;
+}
+
+/**
+ * Payload Kafka `notifications.registerPushToken`.
+ */
+export class NotificationsRegisterPushTokenKafkaDto {
+  @IsString()
+  @IsNotEmpty()
+  tenant: string;
+
+  @IsUUID('4')
+  userId: string;
+
+  @ValidateNested()
+  @Type(() => RegisterPushTokenDto)
+  payload: RegisterPushTokenDto;
+}

package/src/analytics/should-skip-analytics-tenant-lookup.ts

@@ -1,10 +0,0 @@
-/**
- * Tenants that must not trigger tenant-service DB resolution for analytics ingestion.
- * Events for these slugs are acknowledged without persistence (no per-tenant DB row).
- */
-export const TYCHAT_ANALYTICS_SKIP_TENANT_LOOKUP_SLUG = '__tychat_system__';
-
-export function shouldSkipAnalyticsTenantLookup(tenantSlug: string): boolean {
-  const t = tenantSlug?.trim();
-  return t === TYCHAT_ANALYTICS_SKIP_TENANT_LOOKUP_SLUG;
-}