tychat-contracts 1.0.74 → 1.0.75

package/dist/conversations/followup-config-response.dto.d.ts

@@ -6,7 +6,6 @@
  */
 export declare class FollowupConfigResponseDto {
     id: string;
-    tenant: string;
     unitId?: number;
     abandonmentThresholdMinutes: number;
     followup1DelayMinutes: number;

package/dist/conversations/followup-config-response.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"followup-config-response.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/followup-config-response.dto.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,qBAAa,yBAAyB;IAIpC,EAAE,EAAE,MAAM,CAAC;IAKX,MAAM,EAAE,MAAM,CAAC;IAMf,MAAM,CAAC,EAAE,MAAM,CAAC;IAYhB,2BAA2B,EAAE,MAAM,CAAC;IAKpC,qBAAqB,EAAE,MAAM,CAAC;IAK9B,qBAAqB,EAAE,MAAM,CAAC;IAK9B,qBAAqB,EAAE,MAAM,CAAC;IAK9B,qBAAqB,EAAE,MAAM,CAAC;IAK9B,qBAAqB,EAAE,MAAM,CAAC;IAS9B,yBAAyB,EAAE,MAAM,CAAC;IAIlC,mBAAmB,EAAE,OAAO,CAAC;IAS7B,+BAA+B,EAAE,MAAM,CAAC;IAIxC,0BAA0B,EAAE,OAAO,CAAC;IAKpC,gCAAgC,EAAE,MAAM,CAAC;IAIzC,2BAA2B,EAAE,OAAO,CAAC;IASrC,kBAAkB,EAAE,MAAM,CAAC;IAI3B,aAAa,EAAE,OAAO,CAAC;IASvB,yBAAyB,EAAE,MAAM,CAAC;IAIlC,oBAAoB,EAAE,OAAO,CAAC;IAS9B,4BAA4B,EAAE,MAAM,CAAC;IAIrC,uBAAuB,EAAE,OAAO,CAAC;IAQjC,OAAO,EAAE,OAAO,CAAC;CAClB"}
+{"version":3,"file":"followup-config-response.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/followup-config-response.dto.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,qBAAa,yBAAyB;IAIpC,EAAE,EAAE,MAAM,CAAC;IAMX,MAAM,CAAC,EAAE,MAAM,CAAC;IAYhB,2BAA2B,EAAE,MAAM,CAAC;IAKpC,qBAAqB,EAAE,MAAM,CAAC;IAK9B,qBAAqB,EAAE,MAAM,CAAC;IAK9B,qBAAqB,EAAE,MAAM,CAAC;IAK9B,qBAAqB,EAAE,MAAM,CAAC;IAK9B,qBAAqB,EAAE,MAAM,CAAC;IAS9B,yBAAyB,EAAE,MAAM,CAAC;IAIlC,mBAAmB,EAAE,OAAO,CAAC;IAS7B,+BAA+B,EAAE,MAAM,CAAC;IAIxC,0BAA0B,EAAE,OAAO,CAAC;IAKpC,gCAAgC,EAAE,MAAM,CAAC;IAIzC,2BAA2B,EAAE,OAAO,CAAC;IASrC,kBAAkB,EAAE,MAAM,CAAC;IAI3B,aAAa,EAAE,OAAO,CAAC;IASvB,yBAAyB,EAAE,MAAM,CAAC;IAIlC,oBAAoB,EAAE,OAAO,CAAC;IAS9B,4BAA4B,EAAE,MAAM,CAAC;IAIrC,uBAAuB,EAAE,OAAO,CAAC;IAQjC,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/conversations/followup-config-response.dto.js

@@ -20,7 +20,6 @@ const class_validator_1 = require("class-validator");
  */
 class FollowupConfigResponseDto {
     id;
-    tenant;
     unitId;
     // ---------------------------------------------------------------------------
     // Abandonment follow-up settings
@@ -70,12 +69,6 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], FollowupConfigResponseDto.prototype, "id", void 0);
-__decorate([
-    (0, swagger_1.ApiProperty)({ description: 'Tenant slug', example: 'clinic-alpha' }),
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsNotEmpty)(),
-    __metadata("design:type", String)
-], FollowupConfigResponseDto.prototype, "tenant", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({ description: 'Tenant unit id', example: 1 }),
     (0, class_validator_1.IsOptional)(),

package/dist/conversations/followup-events.dto.d.ts

@@ -0,0 +1,30 @@
+export declare const TOPIC_MESSAGE_SENT = "MESSAGE_SENT";
+export declare const TOPIC_MESSAGE_RECEIVED = "MESSAGE_RECEIVED";
+export declare const TOPIC_FOLLOWUP_CONFIG_UPDATED = "FOLLOWUP_CONFIG_UPDATED";
+export declare const TOPIC_APPOINTMENT_CHANGED = "APPOINTMENT_CHANGED";
+export declare class FollowupConversationEventPayload {
+    tenant: string;
+    patientId: string;
+    sessionUuid: string;
+    unitId?: number;
+    messageType: 'ia' | 'human' | 'patient';
+    isFollowup?: boolean;
+    occurredAt: string;
+}
+export declare class FollowupConfigUpdatedEventPayload {
+    tenant: string;
+    unitId?: number;
+    config: Record<string, unknown>;
+    occurredAt: string;
+}
+export declare class AppointmentChangedEventPayload {
+    tenant: string;
+    appointmentId: string;
+    patientId: string;
+    status: string;
+    previousStatus?: string;
+    date?: string;
+    exitTime?: string;
+    occurredAt: string;
+}
+//# sourceMappingURL=followup-events.dto.d.ts.map

package/dist/conversations/followup-events.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"followup-events.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/followup-events.dto.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AACjD,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AACzD,eAAO,MAAM,6BAA6B,4BAA4B,CAAC;AACvE,eAAO,MAAM,yBAAyB,wBAAwB,CAAC;AAE/D,qBAAa,gCAAgC;IAK3C,MAAM,EAAE,MAAM,CAAC;IAMf,SAAS,EAAE,MAAM,CAAC;IAIlB,WAAW,EAAE,MAAM,CAAC;IAIpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAMhB,WAAW,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC;IAKxC,UAAU,CAAC,EAAE,OAAO,CAAC;IAIrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,iCAAiC;IAK5C,MAAM,EAAE,MAAM,CAAC;IAIf,MAAM,CAAC,EAAE,MAAM,CAAC;IAMhB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIhC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,8BAA8B;IAKzC,MAAM,EAAE,MAAM,CAAC;IAIf,aAAa,EAAE,MAAM,CAAC;IAMtB,SAAS,EAAE,MAAM,CAAC;IAMlB,MAAM,EAAE,MAAM,CAAC;IAMf,cAAc,CAAC,EAAE,MAAM,CAAC;IAKxB,IAAI,CAAC,EAAE,MAAM,CAAC;IAKd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAIlB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/conversations/followup-events.dto.js

@@ -0,0 +1,162 @@
+"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.AppointmentChangedEventPayload = exports.FollowupConfigUpdatedEventPayload = exports.FollowupConversationEventPayload = exports.TOPIC_APPOINTMENT_CHANGED = exports.TOPIC_FOLLOWUP_CONFIG_UPDATED = exports.TOPIC_MESSAGE_RECEIVED = exports.TOPIC_MESSAGE_SENT = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+exports.TOPIC_MESSAGE_SENT = 'MESSAGE_SENT';
+exports.TOPIC_MESSAGE_RECEIVED = 'MESSAGE_RECEIVED';
+exports.TOPIC_FOLLOWUP_CONFIG_UPDATED = 'FOLLOWUP_CONFIG_UPDATED';
+exports.TOPIC_APPOINTMENT_CHANGED = 'APPOINTMENT_CHANGED';
+class FollowupConversationEventPayload {
+    tenant;
+    patientId;
+    sessionUuid;
+    unitId;
+    messageType;
+    isFollowup;
+    occurredAt;
+}
+exports.FollowupConversationEventPayload = FollowupConversationEventPayload;
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 'homolog' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(255),
+    __metadata("design:type", String)
+], FollowupConversationEventPayload.prototype, "tenant", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: '3c593727-4505-495a-a054-c052acb4cf19' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(255),
+    __metadata("design:type", String)
+], FollowupConversationEventPayload.prototype, "patientId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 'f3f50ecb-fb71-4d4b-a0dd-910ef6e3fd0a' }),
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], FollowupConversationEventPayload.prototype, "sessionUuid", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ required: false, example: 1 }),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Number)
+], FollowupConversationEventPayload.prototype, "unitId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 'ia' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(50),
+    __metadata("design:type", String)
+], FollowupConversationEventPayload.prototype, "messageType", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ required: false, example: false }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], FollowupConversationEventPayload.prototype, "isFollowup", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: '2026-03-30T12:03:14.000Z' }),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], FollowupConversationEventPayload.prototype, "occurredAt", void 0);
+class FollowupConfigUpdatedEventPayload {
+    tenant;
+    unitId;
+    config;
+    occurredAt;
+}
+exports.FollowupConfigUpdatedEventPayload = FollowupConfigUpdatedEventPayload;
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 'homolog' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(255),
+    __metadata("design:type", String)
+], FollowupConfigUpdatedEventPayload.prototype, "tenant", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ required: false, example: 1 }),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Number)
+], FollowupConfigUpdatedEventPayload.prototype, "unitId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Serialized follow-up configuration snapshot stored in cache.',
+        type: Object,
+    }),
+    __metadata("design:type", Object)
+], FollowupConfigUpdatedEventPayload.prototype, "config", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: '2026-03-30T12:03:14.000Z' }),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], FollowupConfigUpdatedEventPayload.prototype, "occurredAt", void 0);
+class AppointmentChangedEventPayload {
+    tenant;
+    appointmentId;
+    patientId;
+    status;
+    previousStatus;
+    date;
+    exitTime;
+    occurredAt;
+}
+exports.AppointmentChangedEventPayload = AppointmentChangedEventPayload;
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 'homolog' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(255),
+    __metadata("design:type", String)
+], AppointmentChangedEventPayload.prototype, "tenant", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 'f3f50ecb-fb71-4d4b-a0dd-910ef6e3fd0a' }),
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], AppointmentChangedEventPayload.prototype, "appointmentId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: '3c593727-4505-495a-a054-c052acb4cf19' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(255),
+    __metadata("design:type", String)
+], AppointmentChangedEventPayload.prototype, "patientId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 'sended' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(50),
+    __metadata("design:type", String)
+], AppointmentChangedEventPayload.prototype, "status", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ required: false, example: 'pending' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(50),
+    __metadata("design:type", String)
+], AppointmentChangedEventPayload.prototype, "previousStatus", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ required: false, example: '2026-03-30T15:00:00.000Z' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], AppointmentChangedEventPayload.prototype, "date", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ required: false, example: '2026-03-30T16:00:00.000Z' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], AppointmentChangedEventPayload.prototype, "exitTime", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: '2026-03-30T12:03:14.000Z' }),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], AppointmentChangedEventPayload.prototype, "occurredAt", void 0);

package/dist/conversations/followup-log-response.dto.d.ts

@@ -5,7 +5,6 @@ import { FollowupTypeDto } from './followup-type.dto';
  */
 export declare class FollowupLogResponseDto {
     id: string;
-    tenant: string;
     sessionUuid?: string | null;
     patientId: string;
     attempt: number;

package/dist/conversations/followup-log-response.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"followup-log-response.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/followup-log-response.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtE;;;GAGG;AACH,qBAAa,sBAAsB;IAIjC,EAAE,EAAE,MAAM,CAAC;IAKX,MAAM,EAAE,MAAM,CAAC;IAKf,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAK5B,SAAS,EAAE,MAAM,CAAC;IAMlB,OAAO,EAAE,MAAM,CAAC;IAKhB,OAAO,EAAE,MAAM,CAAC;IAKhB,SAAS,CAAC,EAAE,MAAM,CAAC;IAQnB,YAAY,EAAE,eAAe,CAAC;IAK9B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAK9B,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"followup-log-response.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/followup-log-response.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtE;;;GAGG;AACH,qBAAa,sBAAsB;IAIjC,EAAE,EAAE,MAAM,CAAC;IAKX,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAK5B,SAAS,EAAE,MAAM,CAAC;IAMlB,OAAO,EAAE,MAAM,CAAC;IAKhB,OAAO,EAAE,MAAM,CAAC;IAKhB,SAAS,CAAC,EAAE,MAAM,CAAC;IAQnB,YAAY,EAAE,eAAe,CAAC;IAK9B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAK9B,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/conversations/followup-log-response.dto.js

@@ -19,7 +19,6 @@ const followup_type_dto_1 = require("./followup-type.dto");
  */
 class FollowupLogResponseDto {
     id;
-    tenant;
     sessionUuid;
     patientId;
     attempt;
@@ -36,12 +35,6 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], FollowupLogResponseDto.prototype, "id", void 0);
-__decorate([
-    (0, swagger_1.ApiProperty)({ description: 'Tenant slug', example: 'clinic-alpha' }),
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsNotEmpty)(),
-    __metadata("design:type", String)
-], FollowupLogResponseDto.prototype, "tenant", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({ description: 'Session UUID from conversation_sessions (null for appointment-based)' }),
     (0, class_validator_1.IsOptional)(),

package/dist/conversations/index.d.ts

@@ -7,4 +7,6 @@ export * from './conversation-response.dto';
 export * from './followup-type.dto';
 export * from './followup-config-response.dto';
 export * from './followup-log-response.dto';
+export * from './satisfaction-response.dto';
+export * from './followup-events.dto';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conversations/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conversations/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC"}

package/dist/conversations/index.js

@@ -23,3 +23,5 @@ __exportStar(require("./conversation-response.dto"), exports);
 __exportStar(require("./followup-type.dto"), exports);
 __exportStar(require("./followup-config-response.dto"), exports);
 __exportStar(require("./followup-log-response.dto"), exports);
+__exportStar(require("./satisfaction-response.dto"), exports);
+__exportStar(require("./followup-events.dto"), exports);

package/dist/conversations/satisfaction-response.dto.d.ts

@@ -0,0 +1,36 @@
+/** Valid satisfaction survey types. */
+export declare const SATISFACTION_TYPES: readonly ["satisfaction_booking", "satisfaction_finished"];
+export type SatisfactionTypeDto = (typeof SATISFACTION_TYPES)[number];
+/**
+ * Payload to save a patient's satisfaction rating.
+ * Sent from the conversation-service to the followup-service
+ * when the AI detects a numeric satisfaction response.
+ */
+export declare class SaveSatisfactionRequestDto {
+    tenant: string;
+    patientId: string;
+    appointmentId: string;
+    satisfactionType: SatisfactionTypeDto;
+    rating: number;
+    comment?: string;
+}
+/**
+ * Response DTO for a saved satisfaction rating.
+ */
+export declare class SatisfactionResponseDto {
+    id: string;
+    patientId: string;
+    appointmentId: string;
+    satisfactionType: SatisfactionTypeDto;
+    rating: number;
+    comment?: string | null;
+    createdAt: string;
+}
+/**
+ * Response DTO for average satisfaction stats.
+ */
+export declare class SatisfactionAverageDto {
+    average: number;
+    count: number;
+}
+//# sourceMappingURL=satisfaction-response.dto.d.ts.map

package/dist/conversations/satisfaction-response.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"satisfaction-response.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/satisfaction-response.dto.ts"],"names":[],"mappings":"AAYA,uCAAuC;AACvC,eAAO,MAAM,kBAAkB,4DAGrB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE;;;;GAIG;AACH,qBAAa,0BAA0B;IAIrC,MAAM,EAAE,MAAM,CAAC;IAKf,SAAS,EAAE,MAAM,CAAC;IAKlB,aAAa,EAAE,MAAM,CAAC;IAQtB,gBAAgB,EAAE,mBAAmB,CAAC;IAMtC,MAAM,EAAE,MAAM,CAAC;IAMf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,uBAAuB;IAIlC,EAAE,EAAE,MAAM,CAAC;IAKX,SAAS,EAAE,MAAM,CAAC;IAKlB,aAAa,EAAE,MAAM,CAAC;IAQtB,gBAAgB,EAAE,mBAAmB,CAAC;IAMtC,MAAM,EAAE,MAAM,CAAC;IAKf,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAKxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,sBAAsB;IAEjC,OAAO,EAAE,MAAM,CAAC;IAGhB,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/conversations/satisfaction-response.dto.js

@@ -0,0 +1,149 @@
+"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.SatisfactionAverageDto = exports.SatisfactionResponseDto = exports.SaveSatisfactionRequestDto = exports.SATISFACTION_TYPES = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+/** Valid satisfaction survey types. */
+exports.SATISFACTION_TYPES = [
+    'satisfaction_booking',
+    'satisfaction_finished',
+];
+/**
+ * Payload to save a patient's satisfaction rating.
+ * Sent from the conversation-service to the followup-service
+ * when the AI detects a numeric satisfaction response.
+ */
+class SaveSatisfactionRequestDto {
+    tenant;
+    patientId;
+    appointmentId;
+    satisfactionType;
+    rating;
+    comment;
+}
+exports.SaveSatisfactionRequestDto = SaveSatisfactionRequestDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Tenant slug', example: 'clinic-alpha' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SaveSatisfactionRequestDto.prototype, "tenant", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Patient UUID' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SaveSatisfactionRequestDto.prototype, "patientId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Appointment UUID linked to the satisfaction survey' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SaveSatisfactionRequestDto.prototype, "appointmentId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Type of satisfaction survey',
+        enum: exports.SATISFACTION_TYPES,
+        example: 'satisfaction_booking',
+    }),
+    (0, class_validator_1.IsIn)(exports.SATISFACTION_TYPES),
+    __metadata("design:type", String)
+], SaveSatisfactionRequestDto.prototype, "satisfactionType", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Patient satisfaction rating (1-5)', example: 4 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(5),
+    __metadata("design:type", Number)
+], SaveSatisfactionRequestDto.prototype, "rating", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Optional text comment from the patient', example: 'Otimo atendimento!' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(2000),
+    __metadata("design:type", String)
+], SaveSatisfactionRequestDto.prototype, "comment", void 0);
+/**
+ * Response DTO for a saved satisfaction rating.
+ */
+class SatisfactionResponseDto {
+    id;
+    patientId;
+    appointmentId;
+    satisfactionType;
+    rating;
+    comment;
+    createdAt;
+}
+exports.SatisfactionResponseDto = SatisfactionResponseDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Primary key (UUID)' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SatisfactionResponseDto.prototype, "id", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Patient UUID' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SatisfactionResponseDto.prototype, "patientId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Appointment UUID' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SatisfactionResponseDto.prototype, "appointmentId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Type of satisfaction survey',
+        enum: exports.SATISFACTION_TYPES,
+        example: 'satisfaction_finished',
+    }),
+    (0, class_validator_1.IsIn)(exports.SATISFACTION_TYPES),
+    __metadata("design:type", String)
+], SatisfactionResponseDto.prototype, "satisfactionType", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Patient satisfaction rating (1-5)', example: 5 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(5),
+    __metadata("design:type", Number)
+], SatisfactionResponseDto.prototype, "rating", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Optional text comment from the patient' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", Object)
+], SatisfactionResponseDto.prototype, "comment", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Timestamp when the response was recorded (ISO 8601)' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SatisfactionResponseDto.prototype, "createdAt", void 0);
+/**
+ * Response DTO for average satisfaction stats.
+ */
+class SatisfactionAverageDto {
+    average;
+    count;
+}
+exports.SatisfactionAverageDto = SatisfactionAverageDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Average rating', example: 4.2 }),
+    __metadata("design:type", Number)
+], SatisfactionAverageDto.prototype, "average", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Total number of responses', example: 42 }),
+    __metadata("design:type", Number)
+], SatisfactionAverageDto.prototype, "count", void 0);

package/package.json

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

package/src/conversations/followup-config-response.dto.ts

@@ -13,11 +13,6 @@ export class FollowupConfigResponseDto {
   @IsNotEmpty()
   id: string;
 
-  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
-  @IsString()
-  @IsNotEmpty()
-  tenant: string;
-
   @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })
   @IsOptional()
   @IsInt()

package/src/conversations/followup-events.dto.ts

@@ -0,0 +1,111 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsBoolean, IsISO8601, IsOptional, IsString, IsUUID, MaxLength, MinLength } from 'class-validator';
+
+export const TOPIC_MESSAGE_SENT = 'MESSAGE_SENT';
+export const TOPIC_MESSAGE_RECEIVED = 'MESSAGE_RECEIVED';
+export const TOPIC_FOLLOWUP_CONFIG_UPDATED = 'FOLLOWUP_CONFIG_UPDATED';
+export const TOPIC_APPOINTMENT_CHANGED = 'APPOINTMENT_CHANGED';
+
+export class FollowupConversationEventPayload {
+  @ApiProperty({ example: 'homolog' })
+  @IsString()
+  @MinLength(1)
+  @MaxLength(255)
+  tenant: string;
+
+  @ApiProperty({ example: '3c593727-4505-495a-a054-c052acb4cf19' })
+  @IsString()
+  @MinLength(1)
+  @MaxLength(255)
+  patientId: string;
+
+  @ApiProperty({ example: 'f3f50ecb-fb71-4d4b-a0dd-910ef6e3fd0a' })
+  @IsUUID()
+  sessionUuid: string;
+
+  @ApiProperty({ required: false, example: 1 })
+  @IsOptional()
+  unitId?: number;
+
+  @ApiProperty({ example: 'ia' })
+  @IsString()
+  @MinLength(1)
+  @MaxLength(50)
+  messageType: 'ia' | 'human' | 'patient';
+
+  @ApiProperty({ required: false, example: false })
+  @IsOptional()
+  @IsBoolean()
+  isFollowup?: boolean;
+
+  @ApiProperty({ example: '2026-03-30T12:03:14.000Z' })
+  @IsISO8601()
+  occurredAt: string;
+}
+
+export class FollowupConfigUpdatedEventPayload {
+  @ApiProperty({ example: 'homolog' })
+  @IsString()
+  @MinLength(1)
+  @MaxLength(255)
+  tenant: string;
+
+  @ApiProperty({ required: false, example: 1 })
+  @IsOptional()
+  unitId?: number;
+
+  @ApiProperty({
+    description: 'Serialized follow-up configuration snapshot stored in cache.',
+    type: Object,
+  })
+  config: Record<string, unknown>;
+
+  @ApiProperty({ example: '2026-03-30T12:03:14.000Z' })
+  @IsISO8601()
+  occurredAt: string;
+}
+
+export class AppointmentChangedEventPayload {
+  @ApiProperty({ example: 'homolog' })
+  @IsString()
+  @MinLength(1)
+  @MaxLength(255)
+  tenant: string;
+
+  @ApiProperty({ example: 'f3f50ecb-fb71-4d4b-a0dd-910ef6e3fd0a' })
+  @IsUUID()
+  appointmentId: string;
+
+  @ApiProperty({ example: '3c593727-4505-495a-a054-c052acb4cf19' })
+  @IsString()
+  @MinLength(1)
+  @MaxLength(255)
+  patientId: string;
+
+  @ApiProperty({ example: 'sended' })
+  @IsString()
+  @MinLength(1)
+  @MaxLength(50)
+  status: string;
+
+  @ApiProperty({ required: false, example: 'pending' })
+  @IsOptional()
+  @IsString()
+  @MaxLength(50)
+  previousStatus?: string;
+
+  @ApiProperty({ required: false, example: '2026-03-30T15:00:00.000Z' })
+  @IsOptional()
+  @IsISO8601()
+  date?: string;
+
+  @ApiProperty({ required: false, example: '2026-03-30T16:00:00.000Z' })
+  @IsOptional()
+  @IsISO8601()
+  exitTime?: string;
+
+  @ApiProperty({ example: '2026-03-30T12:03:14.000Z' })
+  @IsISO8601()
+  occurredAt: string;
+}
+

package/src/conversations/followup-log-response.dto.ts

@@ -12,11 +12,6 @@ export class FollowupLogResponseDto {
   @IsNotEmpty()
   id: string;
 
-  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
-  @IsString()
-  @IsNotEmpty()
-  tenant: string;
-
   @ApiPropertyOptional({ description: 'Session UUID from conversation_sessions (null for appointment-based)' })
   @IsOptional()
   @IsString()

package/src/conversations/index.ts

@@ -7,3 +7,5 @@ export * from './conversation-response.dto';
 export * from './followup-type.dto';
 export * from './followup-config-response.dto';
 export * from './followup-log-response.dto';
+export * from './satisfaction-response.dto';
+export * from './followup-events.dto';

package/src/conversations/satisfaction-response.dto.ts

@@ -0,0 +1,116 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import {
+  IsIn,
+  IsInt,
+  IsNotEmpty,
+  IsOptional,
+  IsString,
+  Max,
+  MaxLength,
+  Min,
+} from 'class-validator';
+
+/** Valid satisfaction survey types. */
+export const SATISFACTION_TYPES = [
+  'satisfaction_booking',
+  'satisfaction_finished',
+] as const;
+
+export type SatisfactionTypeDto = (typeof SATISFACTION_TYPES)[number];
+
+/**
+ * Payload to save a patient's satisfaction rating.
+ * Sent from the conversation-service to the followup-service
+ * when the AI detects a numeric satisfaction response.
+ */
+export class SaveSatisfactionRequestDto {
+  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
+  @IsString()
+  @IsNotEmpty()
+  tenant: string;
+
+  @ApiProperty({ description: 'Patient UUID' })
+  @IsString()
+  @IsNotEmpty()
+  patientId: string;
+
+  @ApiProperty({ description: 'Appointment UUID linked to the satisfaction survey' })
+  @IsString()
+  @IsNotEmpty()
+  appointmentId: string;
+
+  @ApiProperty({
+    description: 'Type of satisfaction survey',
+    enum: SATISFACTION_TYPES,
+    example: 'satisfaction_booking',
+  })
+  @IsIn(SATISFACTION_TYPES)
+  satisfactionType: SatisfactionTypeDto;
+
+  @ApiProperty({ description: 'Patient satisfaction rating (1-5)', example: 4 })
+  @IsInt()
+  @Min(1)
+  @Max(5)
+  rating: number;
+
+  @ApiPropertyOptional({ description: 'Optional text comment from the patient', example: 'Otimo atendimento!' })
+  @IsOptional()
+  @IsString()
+  @MaxLength(2000)
+  comment?: string;
+}
+
+/**
+ * Response DTO for a saved satisfaction rating.
+ */
+export class SatisfactionResponseDto {
+  @ApiProperty({ description: 'Primary key (UUID)' })
+  @IsString()
+  @IsNotEmpty()
+  id: string;
+
+  @ApiProperty({ description: 'Patient UUID' })
+  @IsString()
+  @IsNotEmpty()
+  patientId: string;
+
+  @ApiProperty({ description: 'Appointment UUID' })
+  @IsString()
+  @IsNotEmpty()
+  appointmentId: string;
+
+  @ApiProperty({
+    description: 'Type of satisfaction survey',
+    enum: SATISFACTION_TYPES,
+    example: 'satisfaction_finished',
+  })
+  @IsIn(SATISFACTION_TYPES)
+  satisfactionType: SatisfactionTypeDto;
+
+  @ApiProperty({ description: 'Patient satisfaction rating (1-5)', example: 5 })
+  @IsInt()
+  @Min(1)
+  @Max(5)
+  rating: number;
+
+  @ApiPropertyOptional({ description: 'Optional text comment from the patient' })
+  @IsOptional()
+  @IsString()
+  comment?: string | null;
+
+  @ApiProperty({ description: 'Timestamp when the response was recorded (ISO 8601)' })
+  @IsString()
+  @IsNotEmpty()
+  createdAt: string;
+}
+
+/**
+ * Response DTO for average satisfaction stats.
+ */
+export class SatisfactionAverageDto {
+  @ApiProperty({ description: 'Average rating', example: 4.2 })
+  average: number;
+
+  @ApiProperty({ description: 'Total number of responses', example: 42 })
+  count: number;
+}