tychat-contracts 1.0.73 → 1.0.74

package/dist/appointments/appointment-procedure.dto.d.ts

@@ -8,5 +8,7 @@ export declare class AppointmentProcedureDto {
     finished: boolean;
     finished_at?: string | null;
     observation?: string | null;
+    side_effects?: string | null;
+    return_days?: number | null;
 }
 //# sourceMappingURL=appointment-procedure.dto.d.ts.map

package/dist/appointments/appointment-procedure.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appointment-procedure.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/appointment-procedure.dto.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,qBAAa,uBAAuB;IASlC,IAAI,EAAE,MAAM,CAAC;IAOb,KAAK,EAAE,MAAM,CAAC;IAOd,QAAQ,EAAE,OAAO,CAAC;IAQlB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAU5B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B"}
+{"version":3,"file":"appointment-procedure.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/appointment-procedure.dto.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,qBAAa,uBAAuB;IASlC,IAAI,EAAE,MAAM,CAAC;IAOb,KAAK,EAAE,MAAM,CAAC;IAOd,QAAQ,EAAE,OAAO,CAAC;IAQlB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAU5B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAU5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAQ7B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B"}

package/dist/appointments/appointment-procedure.dto.js

@@ -22,6 +22,8 @@ class AppointmentProcedureDto {
     finished;
     finished_at;
     observation;
+    side_effects;
+    return_days;
 }
 exports.AppointmentProcedureDto = AppointmentProcedureDto;
 __decorate([
@@ -71,3 +73,23 @@ __decorate([
     (0, class_validator_1.MaxLength)(2000),
     __metadata("design:type", Object)
 ], AppointmentProcedureDto.prototype, "observation", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Known side effects of the procedure (used for wellness follow-up after appointment)',
+        example: 'Possivel inchaço na area tratada, sensibilidade ao toque por 24-48h',
+        maxLength: 2000,
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.MaxLength)(2000),
+    __metadata("design:type", Object)
+], AppointmentProcedureDto.prototype, "side_effects", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Recommended number of days until a return visit',
+        example: 30,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 0 }),
+    __metadata("design:type", Object)
+], AppointmentProcedureDto.prototype, "return_days", void 0);

package/dist/appointments/appointment-status.dto.d.ts

@@ -1,3 +1,10 @@
-export declare const APPOINTMENT_STATUSES: readonly ["pending", "processing", "sended", "finished", "canceled"];
+export declare const APPOINTMENT_STATUSES: readonly ["pending", "processing", "sended", "finished", "canceled", "no_show"];
 export type AppointmentStatusDto = (typeof APPOINTMENT_STATUSES)[number];
+/**
+ * Appointment types to differentiate regular appointments from return visits.
+ * - "regular" → standard appointment with procedures.
+ * - "return"  → follow-up return visit linked to a previous appointment.
+ */
+export declare const APPOINTMENT_TYPES: readonly ["regular", "return"];
+export type AppointmentTypeDto = (typeof APPOINTMENT_TYPES)[number];
 //# sourceMappingURL=appointment-status.dto.d.ts.map

package/dist/appointments/appointment-status.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appointment-status.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/appointment-status.dto.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,sEAMvB,CAAC;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"appointment-status.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/appointment-status.dto.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,iFAOvB,CAAC;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,gCAAiC,CAAC;AAChE,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/appointments/appointment-status.dto.js

@@ -1,10 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.APPOINTMENT_STATUSES = void 0;
+exports.APPOINTMENT_TYPES = exports.APPOINTMENT_STATUSES = void 0;
 exports.APPOINTMENT_STATUSES = [
     'pending',
     'processing',
     'sended',
     'finished',
     'canceled',
+    'no_show',
 ];
+/**
+ * Appointment types to differentiate regular appointments from return visits.
+ * - "regular" → standard appointment with procedures.
+ * - "return"  → follow-up return visit linked to a previous appointment.
+ */
+exports.APPOINTMENT_TYPES = ['regular', 'return'];

package/dist/appointments/appointment.dto.d.ts

@@ -1,4 +1,4 @@
-import { AppointmentStatusDto } from "./appointment-status.dto";
+import { AppointmentStatusDto, AppointmentTypeDto } from "./appointment-status.dto";
 /** Procedure as returned nested inside an appointment response. */
 export interface AppointmentProcedureResponseDto {
     id: string;
@@ -8,6 +8,10 @@ export interface AppointmentProcedureResponseDto {
     finished: boolean;
     finishedAt: string | null;
     observation: string | null;
+    /** Known side effects of the procedure (used for wellness follow-up). */
+    sideEffects: string | null;
+    /** Recommended number of days until a return visit (used for return follow-up). */
+    returnDays: number | null;
     createdAt?: string;
     updatedAt?: string;
 }
@@ -22,6 +26,9 @@ export interface AppointmentDto {
     observation?: string;
     cancellationReason?: string;
     status: AppointmentStatusDto;
+    appointmentType: AppointmentTypeDto;
+    rescheduledFromId?: string;
+    returnFromAppointmentId?: string;
     procedures?: AppointmentProcedureResponseDto[];
 }
 //# sourceMappingURL=appointment.dto.d.ts.map

package/dist/appointments/appointment.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appointment.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/appointment.dto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,mEAAmE;AACnE,MAAM,WAAW,+BAA+B;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IAMX,SAAS,EAAE,MAAM,CAAC;IAKlB,MAAM,EAAE,MAAM,CAAC;IAKf,IAAI,EAAE,MAAM,CAAC;IAKb,gBAAgB,EAAE,OAAO,CAAC;IAK1B,iBAAiB,EAAE,OAAO,CAAC;IAK3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAKlB,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAK5B,MAAM,EAAE,oBAAoB,CAAC;IAI7B,UAAU,CAAC,EAAE,+BAA+B,EAAE,CAAC;CAChD"}
+{"version":3,"file":"appointment.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/appointment.dto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEpF,mEAAmE;AACnE,MAAM,WAAW,+BAA+B;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,yEAAyE;IACzE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mFAAmF;IACnF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IAMX,SAAS,EAAE,MAAM,CAAC;IAKlB,MAAM,EAAE,MAAM,CAAC;IAKf,IAAI,EAAE,MAAM,CAAC;IAKb,gBAAgB,EAAE,OAAO,CAAC;IAK1B,iBAAiB,EAAE,OAAO,CAAC;IAK3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAKlB,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAK5B,MAAM,EAAE,oBAAoB,CAAC;IAK7B,eAAe,EAAE,kBAAkB,CAAC;IAKpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAK3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAIjC,UAAU,CAAC,EAAE,+BAA+B,EAAE,CAAC;CAChD"}

package/dist/appointments/create-appointment.dto.d.ts

@@ -1,4 +1,4 @@
-import { AppointmentStatusDto } from './appointment-status.dto';
+import { AppointmentStatusDto, AppointmentTypeDto } from './appointment-status.dto';
 export declare class CreateAppointmentDto {
     patientId: string;
     date: string;
@@ -9,5 +9,8 @@ export declare class CreateAppointmentDto {
     observation?: string;
     cancellationReason?: string;
     status?: AppointmentStatusDto;
+    appointmentType?: AppointmentTypeDto;
+    rescheduledFromId?: string;
+    returnFromAppointmentId?: string;
 }
 //# sourceMappingURL=create-appointment.dto.d.ts.map

package/dist/appointments/create-appointment.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-appointment.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/create-appointment.dto.ts"],"names":[],"mappings":"AAUA,OAAO,EAAwB,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAItF,qBAAa,oBAAoB;IAO/B,SAAS,EAAE,MAAM,CAAC;IAOlB,IAAI,EAAE,MAAM,CAAC;IAQb,MAAM,EAAE,MAAM,CAAC;IASf,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAS3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAQ5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAQlB,WAAW,CAAC,EAAE,MAAM,CAAC;IAQrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAS5B,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B"}
+{"version":3,"file":"create-appointment.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/create-appointment.dto.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAIlC,qBAAa,oBAAoB;IAO/B,SAAS,EAAE,MAAM,CAAC;IAOlB,IAAI,EAAE,MAAM,CAAC;IAQb,MAAM,EAAE,MAAM,CAAC;IASf,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAS3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAQ5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAQlB,WAAW,CAAC,EAAE,MAAM,CAAC;IAQrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAS5B,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAS9B,eAAe,CAAC,EAAE,kBAAkB,CAAC;IAQrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAQ3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC"}

package/dist/appointments/create-appointment.dto.js

@@ -23,6 +23,9 @@ class CreateAppointmentDto {
     observation;
     cancellationReason;
     status;
+    appointmentType;
+    rescheduledFromId;
+    returnFromAppointmentId;
 }
 exports.CreateAppointmentDto = CreateAppointmentDto;
 __decorate([
@@ -108,3 +111,31 @@ __decorate([
     (0, class_validator_1.IsEnum)(appointment_status_dto_1.APPOINTMENT_STATUSES),
     __metadata("design:type", String)
 ], CreateAppointmentDto.prototype, "status", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Tipo do agendamento (regular ou retorno)',
+        enum: appointment_status_dto_1.APPOINTMENT_TYPES,
+        default: 'regular',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(appointment_status_dto_1.APPOINTMENT_TYPES),
+    __metadata("design:type", String)
+], CreateAppointmentDto.prototype, "appointmentType", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'UUID do agendamento original que foi reagendado (se for reagendamento)',
+        example: '550e8400-e29b-41d4-a716-446655440003',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsUUID)('4'),
+    __metadata("design:type", String)
+], CreateAppointmentDto.prototype, "rescheduledFromId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'UUID do agendamento original ao qual este retorno está vinculado',
+        example: '550e8400-e29b-41d4-a716-446655440004',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsUUID)('4'),
+    __metadata("design:type", String)
+], CreateAppointmentDto.prototype, "returnFromAppointmentId", void 0);

package/dist/conversations/conversation-intention.dto.d.ts

@@ -0,0 +1,7 @@
+/**
+ * All possible user intention types detected by the AI during a conversation.
+ * Used to drive follow-up logic when the user becomes inactive.
+ */
+export declare const CONVERSATION_INTENTIONS: readonly ["greeting", "ask_services", "ask_prices", "ask_availability", "select_service", "provide_datetime", "confirm_appointment", "reject_appointment", "provide_data", "reschedule", "cancel_appointment", "check_appointment", "clinic_info", "human_handoff", "out_of_scope", "unclear"];
+export type ConversationIntentionDto = (typeof CONVERSATION_INTENTIONS)[number];
+//# sourceMappingURL=conversation-intention.dto.d.ts.map

package/dist/conversations/conversation-intention.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-intention.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/conversation-intention.dto.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,uBAAuB,gSAiB1B,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/conversations/conversation-intention.dto.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONVERSATION_INTENTIONS = void 0;
+/**
+ * All possible user intention types detected by the AI during a conversation.
+ * Used to drive follow-up logic when the user becomes inactive.
+ */
+exports.CONVERSATION_INTENTIONS = [
+    'greeting',
+    'ask_services',
+    'ask_prices',
+    'ask_availability',
+    'select_service',
+    'provide_datetime',
+    'confirm_appointment',
+    'reject_appointment',
+    'provide_data',
+    'reschedule',
+    'cancel_appointment',
+    'check_appointment',
+    'clinic_info',
+    'human_handoff',
+    'out_of_scope',
+    'unclear',
+];

package/dist/conversations/conversation-session-response.dto.d.ts

@@ -1,3 +1,4 @@
+import { ConversationIntentionDto } from './conversation-intention.dto';
 /**
  * Represents a conversation session record returned by the API.
  * A session is valid for 24 hours from its start time.
@@ -8,6 +9,7 @@ export declare class ConversationSessionResponseDto {
     tenant: string;
     patientId: string;
     unitId?: number;
+    intention?: ConversationIntentionDto;
     startedAt: string;
     expiresAt: string;
 }

package/dist/conversations/conversation-session-response.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-session-response.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/conversation-session-response.dto.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,qBAAa,8BAA8B;IAIzC,EAAE,EAAE,MAAM,CAAC;IAQX,WAAW,EAAE,MAAM,CAAC;IAKpB,MAAM,EAAE,MAAM,CAAC;IASf,SAAS,EAAE,MAAM,CAAC;IAIlB,MAAM,CAAC,EAAE,MAAM,CAAC;IAQhB,SAAS,EAAE,MAAM,CAAC;IAQlB,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"conversation-session-response.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/conversation-session-response.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2B,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAEjG;;;GAGG;AACH,qBAAa,8BAA8B;IAIzC,EAAE,EAAE,MAAM,CAAC;IAQX,WAAW,EAAE,MAAM,CAAC;IAKpB,MAAM,EAAE,MAAM,CAAC;IASf,SAAS,EAAE,MAAM,CAAC;IAIlB,MAAM,CAAC,EAAE,MAAM,CAAC;IAShB,SAAS,CAAC,EAAE,wBAAwB,CAAC;IAQrC,SAAS,EAAE,MAAM,CAAC;IAQlB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/conversations/conversation-session-response.dto.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConversationSessionResponseDto = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
+const conversation_intention_dto_1 = require("./conversation-intention.dto");
 /**
  * Represents a conversation session record returned by the API.
  * A session is valid for 24 hours from its start time.
@@ -22,6 +23,7 @@ class ConversationSessionResponseDto {
     tenant;
     patientId;
     unitId;
+    intention;
     startedAt;
     expiresAt;
 }
@@ -62,6 +64,16 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     __metadata("design:type", Number)
 ], ConversationSessionResponseDto.prototype, "unitId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'User intention detected by the AI for this session',
+        enum: conversation_intention_dto_1.CONVERSATION_INTENTIONS,
+        example: 'ask_services',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(conversation_intention_dto_1.CONVERSATION_INTENTIONS),
+    __metadata("design:type", String)
+], ConversationSessionResponseDto.prototype, "intention", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'Session start timestamp (ISO 8601)',

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

@@ -0,0 +1,31 @@
+/**
+ * Represents a follow-up timing configuration for a tenant.
+ * Defines timing and enabled flags for all follow-up types:
+ * abandonment, appointment confirmation, satisfaction surveys,
+ * no-show reschedule, wellness check, and return suggestion.
+ */
+export declare class FollowupConfigResponseDto {
+    id: string;
+    tenant: string;
+    unitId?: number;
+    abandonmentThresholdMinutes: number;
+    followup1DelayMinutes: number;
+    followup2DelayMinutes: number;
+    followup3DelayMinutes: number;
+    followup4DelayMinutes: number;
+    followup5DelayMinutes: number;
+    confirmationMinutesBefore: number;
+    confirmationEnabled: boolean;
+    satisfactionBookingDelayMinutes: number;
+    satisfactionBookingEnabled: boolean;
+    satisfactionFinishedDelayMinutes: number;
+    satisfactionFinishedEnabled: boolean;
+    noShowDelayMinutes: number;
+    noShowEnabled: boolean;
+    wellnessCheckDelayMinutes: number;
+    wellnessCheckEnabled: boolean;
+    returnSuggestionDelayMinutes: number;
+    returnSuggestionEnabled: boolean;
+    enabled: boolean;
+}
+//# sourceMappingURL=followup-config-response.dto.d.ts.map

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

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

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

@@ -0,0 +1,195 @@
+"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.FollowupConfigResponseDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+/**
+ * Represents a follow-up timing configuration for a tenant.
+ * Defines timing and enabled flags for all follow-up types:
+ * abandonment, appointment confirmation, satisfaction surveys,
+ * no-show reschedule, wellness check, and return suggestion.
+ */
+class FollowupConfigResponseDto {
+    id;
+    tenant;
+    unitId;
+    // ---------------------------------------------------------------------------
+    // Abandonment follow-up settings
+    // ---------------------------------------------------------------------------
+    abandonmentThresholdMinutes;
+    followup1DelayMinutes;
+    followup2DelayMinutes;
+    followup3DelayMinutes;
+    followup4DelayMinutes;
+    followup5DelayMinutes;
+    // ---------------------------------------------------------------------------
+    // Appointment confirmation settings
+    // ---------------------------------------------------------------------------
+    confirmationMinutesBefore;
+    confirmationEnabled;
+    // ---------------------------------------------------------------------------
+    // Satisfaction survey settings
+    // ---------------------------------------------------------------------------
+    satisfactionBookingDelayMinutes;
+    satisfactionBookingEnabled;
+    satisfactionFinishedDelayMinutes;
+    satisfactionFinishedEnabled;
+    // ---------------------------------------------------------------------------
+    // No-show reschedule settings
+    // ---------------------------------------------------------------------------
+    noShowDelayMinutes;
+    noShowEnabled;
+    // ---------------------------------------------------------------------------
+    // Wellness check settings
+    // ---------------------------------------------------------------------------
+    wellnessCheckDelayMinutes;
+    wellnessCheckEnabled;
+    // ---------------------------------------------------------------------------
+    // Return suggestion settings
+    // ---------------------------------------------------------------------------
+    returnSuggestionDelayMinutes;
+    returnSuggestionEnabled;
+    // ---------------------------------------------------------------------------
+    // Global setting
+    // ---------------------------------------------------------------------------
+    enabled;
+}
+exports.FollowupConfigResponseDto = FollowupConfigResponseDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Config primary key (UUID)' }),
+    (0, class_validator_1.IsString)(),
+    (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)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], FollowupConfigResponseDto.prototype, "unitId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Minutes since last AI/human message to consider the session as abandoned',
+        example: 30,
+    }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], FollowupConfigResponseDto.prototype, "abandonmentThresholdMinutes", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Minutes to wait before sending follow-up #1 after abandonment', example: 5 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], FollowupConfigResponseDto.prototype, "followup1DelayMinutes", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Minutes to wait before sending follow-up #2 after #1', example: 15 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], FollowupConfigResponseDto.prototype, "followup2DelayMinutes", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Minutes to wait before sending follow-up #3 after #2', example: 60 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], FollowupConfigResponseDto.prototype, "followup3DelayMinutes", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Minutes to wait before sending follow-up #4 after #3', example: 1440 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], FollowupConfigResponseDto.prototype, "followup4DelayMinutes", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Minutes to wait before sending follow-up #5 (final) after #4', example: 2880 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], FollowupConfigResponseDto.prototype, "followup5DelayMinutes", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Minutes before the appointment to send the confirmation reminder', example: 60 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], FollowupConfigResponseDto.prototype, "confirmationMinutesBefore", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Whether appointment confirmation follow-up is enabled' }),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], FollowupConfigResponseDto.prototype, "confirmationEnabled", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Minutes after booking confirmation to send the satisfaction survey', example: 10 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], FollowupConfigResponseDto.prototype, "satisfactionBookingDelayMinutes", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Whether satisfaction survey after booking is enabled' }),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], FollowupConfigResponseDto.prototype, "satisfactionBookingEnabled", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Minutes after appointment finishes to send the satisfaction survey', example: 30 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], FollowupConfigResponseDto.prototype, "satisfactionFinishedDelayMinutes", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Whether satisfaction survey after finished appointment is enabled' }),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], FollowupConfigResponseDto.prototype, "satisfactionFinishedEnabled", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Minutes after a no-show to send the reschedule follow-up', example: 60 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], FollowupConfigResponseDto.prototype, "noShowDelayMinutes", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Whether no-show follow-up is enabled' }),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], FollowupConfigResponseDto.prototype, "noShowEnabled", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Minutes after appointment finishes to send the wellness check', example: 1440 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], FollowupConfigResponseDto.prototype, "wellnessCheckDelayMinutes", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Whether wellness check follow-up is enabled' }),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], FollowupConfigResponseDto.prototype, "wellnessCheckEnabled", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Minutes after appointment finishes to send the return suggestion', example: 2880 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], FollowupConfigResponseDto.prototype, "returnSuggestionDelayMinutes", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Whether return suggestion follow-up is enabled' }),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], FollowupConfigResponseDto.prototype, "returnSuggestionEnabled", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Whether abandonment follow-up is enabled for this tenant' }),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], FollowupConfigResponseDto.prototype, "enabled", void 0);

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

@@ -0,0 +1,18 @@
+import { FollowupTypeDto } from './followup-type.dto';
+/**
+ * Represents a follow-up attempt log entry.
+ * Tracks each follow-up message sent to a patient within a session or appointment.
+ */
+export declare class FollowupLogResponseDto {
+    id: string;
+    tenant: string;
+    sessionUuid?: string | null;
+    patientId: string;
+    attempt: number;
+    message: string;
+    intention?: string;
+    followupType: FollowupTypeDto;
+    appointmentId?: string | null;
+    sentAt: string;
+}
+//# sourceMappingURL=followup-log-response.dto.d.ts.map

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

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

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

@@ -0,0 +1,96 @@
+"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.FollowupLogResponseDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+const followup_type_dto_1 = require("./followup-type.dto");
+/**
+ * Represents a follow-up attempt log entry.
+ * Tracks each follow-up message sent to a patient within a session or appointment.
+ */
+class FollowupLogResponseDto {
+    id;
+    tenant;
+    sessionUuid;
+    patientId;
+    attempt;
+    message;
+    intention;
+    followupType;
+    appointmentId;
+    sentAt;
+}
+exports.FollowupLogResponseDto = FollowupLogResponseDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Log primary key (UUID)' }),
+    (0, class_validator_1.IsString)(),
+    (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)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", Object)
+], FollowupLogResponseDto.prototype, "sessionUuid", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Patient UUID' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], FollowupLogResponseDto.prototype, "patientId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Follow-up attempt number (1-5 for abandonment, 1 for appointment-based)', example: 1 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(5),
+    __metadata("design:type", Number)
+], FollowupLogResponseDto.prototype, "attempt", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'The follow-up message sent to the patient' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], FollowupLogResponseDto.prototype, "message", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'The intention detected at the time of follow-up' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], FollowupLogResponseDto.prototype, "intention", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Type of follow-up',
+        enum: followup_type_dto_1.FOLLOWUP_TYPES,
+        example: 'abandonment',
+    }),
+    (0, class_validator_1.IsIn)(followup_type_dto_1.FOLLOWUP_TYPES),
+    __metadata("design:type", String)
+], FollowupLogResponseDto.prototype, "followupType", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Appointment UUID (for appointment-based follow-ups)' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", Object)
+], FollowupLogResponseDto.prototype, "appointmentId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Timestamp when the follow-up was sent (ISO 8601)' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], FollowupLogResponseDto.prototype, "sentAt", void 0);

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

@@ -0,0 +1,14 @@
+/**
+ * All follow-up types supported by the follow-up service.
+ *
+ * - "abandonment"              → Patient stopped responding during a conversation.
+ * - "appointment_confirmation" → Reminder sent before an upcoming appointment.
+ * - "satisfaction_booking"     → Satisfaction survey after the patient books an appointment.
+ * - "satisfaction_finished"    → Satisfaction survey after an appointment is marked as finished.
+ * - "no_show_reschedule"       → Follow-up for patients who did not show up (no_show status).
+ * - "wellness_check"           → Check on patient well-being after procedures (side effects).
+ * - "return_suggestion"        → Suggest a return visit based on procedure return_days.
+ */
+export declare const FOLLOWUP_TYPES: readonly ["abandonment", "appointment_confirmation", "satisfaction_booking", "satisfaction_finished", "no_show_reschedule", "wellness_check", "return_suggestion"];
+export type FollowupTypeDto = (typeof FOLLOWUP_TYPES)[number];
+//# sourceMappingURL=followup-type.dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"followup-type.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/followup-type.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,oKAQjB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC"}

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

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FOLLOWUP_TYPES = void 0;
+/**
+ * All follow-up types supported by the follow-up service.
+ *
+ * - "abandonment"              → Patient stopped responding during a conversation.
+ * - "appointment_confirmation" → Reminder sent before an upcoming appointment.
+ * - "satisfaction_booking"     → Satisfaction survey after the patient books an appointment.
+ * - "satisfaction_finished"    → Satisfaction survey after an appointment is marked as finished.
+ * - "no_show_reschedule"       → Follow-up for patients who did not show up (no_show status).
+ * - "wellness_check"           → Check on patient well-being after procedures (side effects).
+ * - "return_suggestion"        → Suggest a return visit based on procedure return_days.
+ */
+exports.FOLLOWUP_TYPES = [
+    'abandonment',
+    'appointment_confirmation',
+    'satisfaction_booking',
+    'satisfaction_finished',
+    'no_show_reschedule',
+    'wellness_check',
+    'return_suggestion',
+];

package/dist/conversations/index.d.ts

@@ -1,6 +1,10 @@
 export * from './conversation-type.dto';
+export * from './conversation-intention.dto';
 export * from './create-conversation-session.dto';
 export * from './conversation-session-response.dto';
 export * from './create-conversation.dto';
 export * from './conversation-response.dto';
+export * from './followup-type.dto';
+export * from './followup-config-response.dto';
+export * from './followup-log-response.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,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,2BAA2B,CAAC;AAC1C,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"}

package/dist/conversations/index.js

@@ -15,7 +15,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./conversation-type.dto"), exports);
+__exportStar(require("./conversation-intention.dto"), exports);
 __exportStar(require("./create-conversation-session.dto"), exports);
 __exportStar(require("./conversation-session-response.dto"), exports);
 __exportStar(require("./create-conversation.dto"), exports);
 __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);

package/dist/patients/index.d.ts

@@ -3,4 +3,5 @@ export * from './update-patient.dto';
 export * from './patient-history-entry.dto';
 export * from './list-patients-query.dto';
 export * from './upsert-patient-by-phone.dto';
+export * from './patient-status.dto';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/patients/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/patients/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC"}

package/dist/patients/index.js

@@ -19,3 +19,4 @@ __exportStar(require("./update-patient.dto"), exports);
 __exportStar(require("./patient-history-entry.dto"), exports);
 __exportStar(require("./list-patients-query.dto"), exports);
 __exportStar(require("./upsert-patient-by-phone.dto"), exports);
+__exportStar(require("./patient-status.dto"), exports);

package/dist/patients/patient-status.dto.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Allowed patient engagement statuses.
+ * - "active"   → patient is actively engaged in conversations.
+ * - "inactive" → patient stopped responding after all follow-up attempts.
+ *                Reactivated automatically when the patient sends a new message.
+ */
+export declare const PATIENT_STATUSES: readonly ["active", "inactive"];
+export type PatientStatusDto = (typeof PATIENT_STATUSES)[number];
+//# sourceMappingURL=patient-status.dto.d.ts.map

package/dist/patients/patient-status.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patient-status.dto.d.ts","sourceRoot":"","sources":["../../src/patients/patient-status.dto.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,iCAAkC,CAAC;AAEhE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/patients/patient-status.dto.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PATIENT_STATUSES = void 0;
+/**
+ * Allowed patient engagement statuses.
+ * - "active"   → patient is actively engaged in conversations.
+ * - "inactive" → patient stopped responding after all follow-up attempts.
+ *                Reactivated automatically when the patient sends a new message.
+ */
+exports.PATIENT_STATUSES = ['active', 'inactive'];

package/package.json

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

package/src/appointments/appointment-procedure.dto.ts

@@ -55,4 +55,22 @@ export class AppointmentProcedureDto {
   @IsOptional()
   @MaxLength(2000)
   observation?: string | null;
+
+  @ApiPropertyOptional({
+    description: 'Known side effects of the procedure (used for wellness follow-up after appointment)',
+    example: 'Possivel inchaço na area tratada, sensibilidade ao toque por 24-48h',
+    maxLength: 2000,
+  })
+  @IsString()
+  @IsOptional()
+  @MaxLength(2000)
+  side_effects?: string | null;
+
+  @ApiPropertyOptional({
+    description: 'Recommended number of days until a return visit',
+    example: 30,
+  })
+  @IsOptional()
+  @IsNumber({ maxDecimalPlaces: 0 })
+  return_days?: number | null;
 }

package/src/appointments/appointment-status.dto.ts

@@ -4,5 +4,14 @@ export const APPOINTMENT_STATUSES = [
     'sended',
     'finished',
     'canceled',
+    'no_show',
 ] as const;
-export type AppointmentStatusDto = (typeof APPOINTMENT_STATUSES)[number];
+export type AppointmentStatusDto = (typeof APPOINTMENT_STATUSES)[number];
+
+/**
+ * Appointment types to differentiate regular appointments from return visits.
+ * - "regular" → standard appointment with procedures.
+ * - "return"  → follow-up return visit linked to a previous appointment.
+ */
+export const APPOINTMENT_TYPES = ['regular', 'return'] as const;
+export type AppointmentTypeDto = (typeof APPOINTMENT_TYPES)[number];

package/src/appointments/appointment.dto.ts

@@ -1,4 +1,4 @@
-import { AppointmentStatusDto } from "./appointment-status.dto";
+import { AppointmentStatusDto, AppointmentTypeDto } from "./appointment-status.dto";
 
 /** Procedure as returned nested inside an appointment response. */
 export interface AppointmentProcedureResponseDto {
@@ -9,6 +9,10 @@ export interface AppointmentProcedureResponseDto {
   finished: boolean;
   finishedAt: string | null;
   observation: string | null;
+  /** Known side effects of the procedure (used for wellness follow-up). */
+  sideEffects: string | null;
+  /** Recommended number of days until a return visit (used for return follow-up). */
+  returnDays: number | null;
   createdAt?: string;
   updatedAt?: string;
 }
@@ -62,6 +66,21 @@ export interface AppointmentDto {
   */
   status: AppointmentStatusDto;
   /*
+  * Type of the appointment (regular or return visit)
+  * @example 'regular'
+  */
+  appointmentType: AppointmentTypeDto;
+  /*
+  * UUID of the original appointment this was rescheduled from (null if not a reschedule)
+  * @example '550e8400-e29b-41d4-a716-446655440003'
+  */
+  rescheduledFromId?: string;
+  /*
+  * UUID of the original appointment this return visit is linked to (null if not a return)
+  * @example '550e8400-e29b-41d4-a716-446655440004'
+  */
+  returnFromAppointmentId?: string;
+  /*
   * Procedures linked to this appointment (loaded via relation)
   */
   procedures?: AppointmentProcedureResponseDto[];

package/src/appointments/create-appointment.dto.ts

@@ -8,7 +8,12 @@ import {
   IsString,
   IsUUID,
 } from 'class-validator';
-import { APPOINTMENT_STATUSES, AppointmentStatusDto } from './appointment-status.dto';
+import {
+  APPOINTMENT_STATUSES,
+  APPOINTMENT_TYPES,
+  AppointmentStatusDto,
+  AppointmentTypeDto,
+} from './appointment-status.dto';
 
 
 
@@ -86,4 +91,29 @@ export class CreateAppointmentDto {
   @IsOptional()
   @IsEnum(APPOINTMENT_STATUSES)
   status?: AppointmentStatusDto;
+
+  @ApiPropertyOptional({
+    description: 'Tipo do agendamento (regular ou retorno)',
+    enum: APPOINTMENT_TYPES,
+    default: 'regular',
+  })
+  @IsOptional()
+  @IsEnum(APPOINTMENT_TYPES)
+  appointmentType?: AppointmentTypeDto;
+
+  @ApiPropertyOptional({
+    description: 'UUID do agendamento original que foi reagendado (se for reagendamento)',
+    example: '550e8400-e29b-41d4-a716-446655440003',
+  })
+  @IsOptional()
+  @IsUUID('4')
+  rescheduledFromId?: string;
+
+  @ApiPropertyOptional({
+    description: 'UUID do agendamento original ao qual este retorno está vinculado',
+    example: '550e8400-e29b-41d4-a716-446655440004',
+  })
+  @IsOptional()
+  @IsUUID('4')
+  returnFromAppointmentId?: string;
 }

package/src/conversations/conversation-intention.dto.ts

@@ -0,0 +1,24 @@
+/**
+ * All possible user intention types detected by the AI during a conversation.
+ * Used to drive follow-up logic when the user becomes inactive.
+ */
+export const CONVERSATION_INTENTIONS = [
+  'greeting',
+  'ask_services',
+  'ask_prices',
+  'ask_availability',
+  'select_service',
+  'provide_datetime',
+  'confirm_appointment',
+  'reject_appointment',
+  'provide_data',
+  'reschedule',
+  'cancel_appointment',
+  'check_appointment',
+  'clinic_info',
+  'human_handoff',
+  'out_of_scope',
+  'unclear',
+] as const;
+
+export type ConversationIntentionDto = (typeof CONVERSATION_INTENTIONS)[number];

package/src/conversations/conversation-session-response.dto.ts

@@ -1,5 +1,6 @@
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { IsNotEmpty, IsOptional, IsString, IsUUID } from 'class-validator';
+import { IsEnum, IsNotEmpty, IsOptional, IsString, IsUUID } from 'class-validator';
+import { CONVERSATION_INTENTIONS, ConversationIntentionDto } from './conversation-intention.dto';
 
 /**
  * Represents a conversation session record returned by the API.
@@ -37,6 +38,15 @@ export class ConversationSessionResponseDto {
   @IsOptional()
   unitId?: number;
 
+  @ApiPropertyOptional({
+    description: 'User intention detected by the AI for this session',
+    enum: CONVERSATION_INTENTIONS,
+    example: 'ask_services',
+  })
+  @IsOptional()
+  @IsEnum(CONVERSATION_INTENTIONS)
+  intention?: ConversationIntentionDto;
+
   @ApiProperty({
     description: 'Session start timestamp (ISO 8601)',
     example: '2024-01-01T00:00:00.000Z',

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

@@ -0,0 +1,145 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsBoolean, IsInt, IsNotEmpty, IsOptional, IsString, Min } from 'class-validator';
+
+/**
+ * Represents a follow-up timing configuration for a tenant.
+ * Defines timing and enabled flags for all follow-up types:
+ * abandonment, appointment confirmation, satisfaction surveys,
+ * no-show reschedule, wellness check, and return suggestion.
+ */
+export class FollowupConfigResponseDto {
+  @ApiProperty({ description: 'Config primary key (UUID)' })
+  @IsString()
+  @IsNotEmpty()
+  id: string;
+
+  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
+  @IsString()
+  @IsNotEmpty()
+  tenant: string;
+
+  @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  unitId?: number;
+
+  // ---------------------------------------------------------------------------
+  // Abandonment follow-up settings
+  // ---------------------------------------------------------------------------
+
+  @ApiProperty({
+    description: 'Minutes since last AI/human message to consider the session as abandoned',
+    example: 30,
+  })
+  @IsInt()
+  @Min(1)
+  abandonmentThresholdMinutes: number;
+
+  @ApiProperty({ description: 'Minutes to wait before sending follow-up #1 after abandonment', example: 5 })
+  @IsInt()
+  @Min(1)
+  followup1DelayMinutes: number;
+
+  @ApiProperty({ description: 'Minutes to wait before sending follow-up #2 after #1', example: 15 })
+  @IsInt()
+  @Min(1)
+  followup2DelayMinutes: number;
+
+  @ApiProperty({ description: 'Minutes to wait before sending follow-up #3 after #2', example: 60 })
+  @IsInt()
+  @Min(1)
+  followup3DelayMinutes: number;
+
+  @ApiProperty({ description: 'Minutes to wait before sending follow-up #4 after #3', example: 1440 })
+  @IsInt()
+  @Min(1)
+  followup4DelayMinutes: number;
+
+  @ApiProperty({ description: 'Minutes to wait before sending follow-up #5 (final) after #4', example: 2880 })
+  @IsInt()
+  @Min(1)
+  followup5DelayMinutes: number;
+
+  // ---------------------------------------------------------------------------
+  // Appointment confirmation settings
+  // ---------------------------------------------------------------------------
+
+  @ApiProperty({ description: 'Minutes before the appointment to send the confirmation reminder', example: 60 })
+  @IsInt()
+  @Min(1)
+  confirmationMinutesBefore: number;
+
+  @ApiProperty({ description: 'Whether appointment confirmation follow-up is enabled' })
+  @IsBoolean()
+  confirmationEnabled: boolean;
+
+  // ---------------------------------------------------------------------------
+  // Satisfaction survey settings
+  // ---------------------------------------------------------------------------
+
+  @ApiProperty({ description: 'Minutes after booking confirmation to send the satisfaction survey', example: 10 })
+  @IsInt()
+  @Min(1)
+  satisfactionBookingDelayMinutes: number;
+
+  @ApiProperty({ description: 'Whether satisfaction survey after booking is enabled' })
+  @IsBoolean()
+  satisfactionBookingEnabled: boolean;
+
+  @ApiProperty({ description: 'Minutes after appointment finishes to send the satisfaction survey', example: 30 })
+  @IsInt()
+  @Min(1)
+  satisfactionFinishedDelayMinutes: number;
+
+  @ApiProperty({ description: 'Whether satisfaction survey after finished appointment is enabled' })
+  @IsBoolean()
+  satisfactionFinishedEnabled: boolean;
+
+  // ---------------------------------------------------------------------------
+  // No-show reschedule settings
+  // ---------------------------------------------------------------------------
+
+  @ApiProperty({ description: 'Minutes after a no-show to send the reschedule follow-up', example: 60 })
+  @IsInt()
+  @Min(1)
+  noShowDelayMinutes: number;
+
+  @ApiProperty({ description: 'Whether no-show follow-up is enabled' })
+  @IsBoolean()
+  noShowEnabled: boolean;
+
+  // ---------------------------------------------------------------------------
+  // Wellness check settings
+  // ---------------------------------------------------------------------------
+
+  @ApiProperty({ description: 'Minutes after appointment finishes to send the wellness check', example: 1440 })
+  @IsInt()
+  @Min(1)
+  wellnessCheckDelayMinutes: number;
+
+  @ApiProperty({ description: 'Whether wellness check follow-up is enabled' })
+  @IsBoolean()
+  wellnessCheckEnabled: boolean;
+
+  // ---------------------------------------------------------------------------
+  // Return suggestion settings
+  // ---------------------------------------------------------------------------
+
+  @ApiProperty({ description: 'Minutes after appointment finishes to send the return suggestion', example: 2880 })
+  @IsInt()
+  @Min(1)
+  returnSuggestionDelayMinutes: number;
+
+  @ApiProperty({ description: 'Whether return suggestion follow-up is enabled' })
+  @IsBoolean()
+  returnSuggestionEnabled: boolean;
+
+  // ---------------------------------------------------------------------------
+  // Global setting
+  // ---------------------------------------------------------------------------
+
+  @ApiProperty({ description: 'Whether abandonment follow-up is enabled for this tenant' })
+  @IsBoolean()
+  enabled: boolean;
+}

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

@@ -0,0 +1,63 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsIn, IsInt, IsNotEmpty, IsOptional, IsString, Max, Min } from 'class-validator';
+import { FOLLOWUP_TYPES, FollowupTypeDto } from './followup-type.dto';
+
+/**
+ * Represents a follow-up attempt log entry.
+ * Tracks each follow-up message sent to a patient within a session or appointment.
+ */
+export class FollowupLogResponseDto {
+  @ApiProperty({ description: 'Log primary key (UUID)' })
+  @IsString()
+  @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()
+  sessionUuid?: string | null;
+
+  @ApiProperty({ description: 'Patient UUID' })
+  @IsString()
+  @IsNotEmpty()
+  patientId: string;
+
+  @ApiProperty({ description: 'Follow-up attempt number (1-5 for abandonment, 1 for appointment-based)', example: 1 })
+  @IsInt()
+  @Min(1)
+  @Max(5)
+  attempt: number;
+
+  @ApiProperty({ description: 'The follow-up message sent to the patient' })
+  @IsString()
+  @IsNotEmpty()
+  message: string;
+
+  @ApiPropertyOptional({ description: 'The intention detected at the time of follow-up' })
+  @IsOptional()
+  @IsString()
+  intention?: string;
+
+  @ApiProperty({
+    description: 'Type of follow-up',
+    enum: FOLLOWUP_TYPES,
+    example: 'abandonment',
+  })
+  @IsIn(FOLLOWUP_TYPES)
+  followupType: FollowupTypeDto;
+
+  @ApiPropertyOptional({ description: 'Appointment UUID (for appointment-based follow-ups)' })
+  @IsOptional()
+  @IsString()
+  appointmentId?: string | null;
+
+  @ApiProperty({ description: 'Timestamp when the follow-up was sent (ISO 8601)' })
+  @IsString()
+  @IsNotEmpty()
+  sentAt: string;
+}

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

@@ -0,0 +1,22 @@
+/**
+ * All follow-up types supported by the follow-up service.
+ *
+ * - "abandonment"              → Patient stopped responding during a conversation.
+ * - "appointment_confirmation" → Reminder sent before an upcoming appointment.
+ * - "satisfaction_booking"     → Satisfaction survey after the patient books an appointment.
+ * - "satisfaction_finished"    → Satisfaction survey after an appointment is marked as finished.
+ * - "no_show_reschedule"       → Follow-up for patients who did not show up (no_show status).
+ * - "wellness_check"           → Check on patient well-being after procedures (side effects).
+ * - "return_suggestion"        → Suggest a return visit based on procedure return_days.
+ */
+export const FOLLOWUP_TYPES = [
+  'abandonment',
+  'appointment_confirmation',
+  'satisfaction_booking',
+  'satisfaction_finished',
+  'no_show_reschedule',
+  'wellness_check',
+  'return_suggestion',
+] as const;
+
+export type FollowupTypeDto = (typeof FOLLOWUP_TYPES)[number];

package/src/conversations/index.ts

@@ -1,5 +1,9 @@
 export * from './conversation-type.dto';
+export * from './conversation-intention.dto';
 export * from './create-conversation-session.dto';
 export * from './conversation-session-response.dto';
 export * from './create-conversation.dto';
 export * from './conversation-response.dto';
+export * from './followup-type.dto';
+export * from './followup-config-response.dto';
+export * from './followup-log-response.dto';

package/src/patients/index.ts

@@ -3,4 +3,5 @@ export * from './update-patient.dto';
 export * from './patient-history-entry.dto';
 export * from './list-patients-query.dto';
 export * from './upsert-patient-by-phone.dto';
+export * from './patient-status.dto';
 

package/src/patients/patient-status.dto.ts

@@ -0,0 +1,9 @@
+/**
+ * Allowed patient engagement statuses.
+ * - "active"   → patient is actively engaged in conversations.
+ * - "inactive" → patient stopped responding after all follow-up attempts.
+ *                Reactivated automatically when the patient sends a new message.
+ */
+export const PATIENT_STATUSES = ['active', 'inactive'] as const;
+
+export type PatientStatusDto = (typeof PATIENT_STATUSES)[number];