tychat-contracts 1.0.64 → 1.0.66

package/dist/ai/agent-response.dto.d.ts

@@ -5,6 +5,8 @@ export declare class AgentResponseDto {
     unitId: number;
     integration: AiIntegrationDto;
     model: string;
+    transcriptionIntegration: AiIntegrationDto;
+    transcriptionModel: string;
     systemPrompt: string;
     temperature: number;
     active: boolean;

package/dist/ai/agent-response.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-response.dto.d.ts","sourceRoot":"","sources":["../../src/ai/agent-response.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE/E,qBAAa,gBAAgB;IAM3B,EAAE,EAAE,MAAM,CAAC;IAQX,MAAM,EAAE,MAAM,CAAC;IAOf,MAAM,EAAE,MAAM,CAAC;IAQf,WAAW,EAAE,gBAAgB,CAAC;IAO9B,KAAK,EAAE,MAAM,CAAC;IAOd,YAAY,EAAE,MAAM,CAAC;IAOrB,WAAW,EAAE,MAAM,CAAC;IAOpB,MAAM,EAAE,OAAO,CAAC;IAQhB,YAAY,CAAC,EAAE,MAAM,CAAC;IAQtB,YAAY,CAAC,EAAE,MAAM,CAAC;IAOtB,SAAS,EAAE,MAAM,CAAC;IAOlB,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"agent-response.dto.d.ts","sourceRoot":"","sources":["../../src/ai/agent-response.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE/E,qBAAa,gBAAgB;IAM3B,EAAE,EAAE,MAAM,CAAC;IAQX,MAAM,EAAE,MAAM,CAAC;IAOf,MAAM,EAAE,MAAM,CAAC;IAQf,WAAW,EAAE,gBAAgB,CAAC;IAO9B,KAAK,EAAE,MAAM,CAAC;IAQd,wBAAwB,EAAE,gBAAgB,CAAC;IAO3C,kBAAkB,EAAE,MAAM,CAAC;IAO3B,YAAY,EAAE,MAAM,CAAC;IAOrB,WAAW,EAAE,MAAM,CAAC;IAOpB,MAAM,EAAE,OAAO,CAAC;IAQhB,YAAY,CAAC,EAAE,MAAM,CAAC;IAQtB,YAAY,CAAC,EAAE,MAAM,CAAC;IAOtB,SAAS,EAAE,MAAM,CAAC;IAOlB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/ai/agent-response.dto.js

@@ -19,6 +19,8 @@ class AgentResponseDto {
     unitId;
     integration;
     model;
+    transcriptionIntegration;
+    transcriptionModel;
     systemPrompt;
     temperature;
     active;
@@ -70,6 +72,23 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], AgentResponseDto.prototype, "model", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Integration provider used for audio transcription',
+        enum: integration_provider_dto_1.AI_INTEGRATIONS,
+        example: 'OPENAI',
+    }),
+    (0, class_validator_1.IsEnum)(integration_provider_dto_1.AI_INTEGRATIONS),
+    __metadata("design:type", String)
+], AgentResponseDto.prototype, "transcriptionIntegration", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Model name used for audio transcription',
+        example: 'gpt-4o-mini-transcribe',
+    }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AgentResponseDto.prototype, "transcriptionModel", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'System prompt used by this agent',

package/dist/ai/create-agent.dto.d.ts

@@ -4,6 +4,8 @@ export declare class CreateAgentDto {
     unitId: number;
     integration: AiIntegrationDto;
     model: string;
+    transcriptionIntegration?: AiIntegrationDto;
+    transcriptionModel?: string;
     systemPrompt: string;
     temperature: number;
     active: boolean;

package/dist/ai/create-agent.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-agent.dto.d.ts","sourceRoot":"","sources":["../../src/ai/create-agent.dto.ts"],"names":[],"mappings":"AAYA,OAAO,EAAmB,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE/E,qBAAa,cAAc;IAOzB,MAAM,EAAE,MAAM,CAAC;IAQf,MAAM,EAAE,MAAM,CAAC;IAQf,WAAW,EAAE,gBAAgB,CAAC;IAQ9B,KAAK,EAAE,MAAM,CAAC;IAQd,YAAY,EAAE,MAAM,CAAC;IAWrB,WAAW,EAAE,MAAM,CAAC;IAOpB,MAAM,EAAE,OAAO,CAAC;IAShB,YAAY,CAAC,EAAE,MAAM,CAAC;IAStB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}
+{"version":3,"file":"create-agent.dto.d.ts","sourceRoot":"","sources":["../../src/ai/create-agent.dto.ts"],"names":[],"mappings":"AAYA,OAAO,EAAmB,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE/E,qBAAa,cAAc;IAOzB,MAAM,EAAE,MAAM,CAAC;IAQf,MAAM,EAAE,MAAM,CAAC;IAQf,WAAW,EAAE,gBAAgB,CAAC;IAQ9B,KAAK,EAAE,MAAM,CAAC;IAUd,wBAAwB,CAAC,EAAE,gBAAgB,CAAC;IAU5C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAQ5B,YAAY,EAAE,MAAM,CAAC;IAWrB,WAAW,EAAE,MAAM,CAAC;IAOpB,MAAM,EAAE,OAAO,CAAC;IAShB,YAAY,CAAC,EAAE,MAAM,CAAC;IAStB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/ai/create-agent.dto.js

@@ -18,6 +18,8 @@ class CreateAgentDto {
     unitId;
     integration;
     model;
+    transcriptionIntegration;
+    transcriptionModel;
     systemPrompt;
     temperature;
     active;
@@ -61,6 +63,26 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], CreateAgentDto.prototype, "model", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Integration provider used specifically for audio transcription. Defaults to "integration" when omitted.',
+        enum: integration_provider_dto_1.AI_INTEGRATIONS,
+        example: 'GEMINI',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(integration_provider_dto_1.AI_INTEGRATIONS),
+    __metadata("design:type", String)
+], CreateAgentDto.prototype, "transcriptionIntegration", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Model name used specifically for audio transcription. Defaults to "model" when omitted.',
+        example: 'gemini-2.0-flash',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateAgentDto.prototype, "transcriptionModel", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'System prompt applied before user messages',

package/dist/ai/update-agent.dto.d.ts

@@ -3,6 +3,8 @@ export declare class UpdateAgentDto {
     unitId?: number;
     integration?: AiIntegrationDto;
     model?: string;
+    transcriptionIntegration?: AiIntegrationDto;
+    transcriptionModel?: string;
     systemPrompt?: string;
     temperature?: number;
     active?: boolean;

package/dist/ai/update-agent.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-agent.dto.d.ts","sourceRoot":"","sources":["../../src/ai/update-agent.dto.ts"],"names":[],"mappings":"AAYA,OAAO,EAAmB,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE/E,qBAAa,cAAc;IAQzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAShB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAS/B,KAAK,CAAC,EAAE,MAAM,CAAC;IASf,YAAY,CAAC,EAAE,MAAM,CAAC;IAYtB,WAAW,CAAC,EAAE,MAAM,CAAC;IAQrB,MAAM,CAAC,EAAE,OAAO,CAAC;IASjB,YAAY,CAAC,EAAE,MAAM,CAAC;IAStB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}
+{"version":3,"file":"update-agent.dto.d.ts","sourceRoot":"","sources":["../../src/ai/update-agent.dto.ts"],"names":[],"mappings":"AAYA,OAAO,EAAmB,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE/E,qBAAa,cAAc;IAQzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAShB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAS/B,KAAK,CAAC,EAAE,MAAM,CAAC;IAUf,wBAAwB,CAAC,EAAE,gBAAgB,CAAC;IAS5C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAS5B,YAAY,CAAC,EAAE,MAAM,CAAC;IAYtB,WAAW,CAAC,EAAE,MAAM,CAAC;IAQrB,MAAM,CAAC,EAAE,OAAO,CAAC;IASjB,YAAY,CAAC,EAAE,MAAM,CAAC;IAStB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/ai/update-agent.dto.js

@@ -17,6 +17,8 @@ class UpdateAgentDto {
     unitId;
     integration;
     model;
+    transcriptionIntegration;
+    transcriptionModel;
     systemPrompt;
     temperature;
     active;
@@ -54,6 +56,26 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], UpdateAgentDto.prototype, "model", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Integration provider used specifically for audio transcription',
+        enum: integration_provider_dto_1.AI_INTEGRATIONS,
+        example: 'OPENAI',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(integration_provider_dto_1.AI_INTEGRATIONS),
+    __metadata("design:type", String)
+], UpdateAgentDto.prototype, "transcriptionIntegration", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Model name used specifically for audio transcription',
+        example: 'gpt-4o-mini-transcribe',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], UpdateAgentDto.prototype, "transcriptionModel", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
         description: 'System prompt applied before user messages',

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

@@ -0,0 +1,12 @@
+/**
+ * DTO for creating a procedure linked to an appointment.
+ * Procedures belong to appointments (not directly to patients).
+ */
+export declare class AppointmentProcedureDto {
+    name: string;
+    value: number;
+    finished: boolean;
+    finished_at?: string | null;
+    observation?: string | null;
+}
+//# sourceMappingURL=appointment-procedure.dto.d.ts.map

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

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

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

@@ -0,0 +1,73 @@
+"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.AppointmentProcedureDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+/**
+ * DTO for creating a procedure linked to an appointment.
+ * Procedures belong to appointments (not directly to patients).
+ */
+class AppointmentProcedureDto {
+    name;
+    value;
+    finished;
+    finished_at;
+    observation;
+}
+exports.AppointmentProcedureDto = AppointmentProcedureDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Name of the procedure to be performed or already performed',
+        example: 'Consulta clínica',
+        maxLength: 255,
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(255),
+    __metadata("design:type", String)
+], AppointmentProcedureDto.prototype, "name", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Monetary value of the procedure',
+        example: 150.5,
+    }),
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 2 }),
+    __metadata("design:type", Number)
+], AppointmentProcedureDto.prototype, "value", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Indicates whether the procedure has been completed',
+        example: false,
+    }),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], AppointmentProcedureDto.prototype, "finished", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Date and time when the procedure was completed (ISO 8601)',
+        example: '2026-03-10T14:30:00.000Z',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsDateString)(),
+    __metadata("design:type", Object)
+], AppointmentProcedureDto.prototype, "finished_at", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Additional observation about the procedure',
+        example: 'Paciente chegou em jejum',
+        maxLength: 2000,
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.MaxLength)(2000),
+    __metadata("design:type", Object)
+], AppointmentProcedureDto.prototype, "observation", void 0);

package/dist/appointments/index.d.ts

@@ -5,4 +5,6 @@ export * from './available-slots-query.dto';
 export * from './available-slots-response.dto';
 export * from './appointment-status.dto';
 export * from './appointment.dto';
+export * from './appointment-procedure.dto';
+export * from './update-appointment-procedure.dto';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/appointments/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/appointments/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC"}

package/dist/appointments/index.js

@@ -21,3 +21,5 @@ __exportStar(require("./available-slots-query.dto"), exports);
 __exportStar(require("./available-slots-response.dto"), exports);
 __exportStar(require("./appointment-status.dto"), exports);
 __exportStar(require("./appointment.dto"), exports);
+__exportStar(require("./appointment-procedure.dto"), exports);
+__exportStar(require("./update-appointment-procedure.dto"), exports);

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

@@ -0,0 +1,10 @@
+import { AppointmentProcedureDto } from './appointment-procedure.dto';
+declare const UpdateAppointmentProcedureDto_base: import("@nestjs/common").Type<Partial<AppointmentProcedureDto>>;
+/**
+ * DTO for partially updating an appointment procedure.
+ * All fields are optional.
+ */
+export declare class UpdateAppointmentProcedureDto extends UpdateAppointmentProcedureDto_base {
+}
+export {};
+//# sourceMappingURL=update-appointment-procedure.dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-appointment-procedure.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/update-appointment-procedure.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;;AAEtE;;;GAGG;AACH,qBAAa,6BAA8B,SAAQ,kCAElD;CAAG"}

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

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateAppointmentProcedureDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const appointment_procedure_dto_1 = require("./appointment-procedure.dto");
+/**
+ * DTO for partially updating an appointment procedure.
+ * All fields are optional.
+ */
+class UpdateAppointmentProcedureDto extends (0, swagger_1.PartialType)(appointment_procedure_dto_1.AppointmentProcedureDto) {
+}
+exports.UpdateAppointmentProcedureDto = UpdateAppointmentProcedureDto;

package/package.json

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

package/src/ai/agent-response.dto.ts

@@ -40,6 +40,21 @@ export class AgentResponseDto {
   @IsString()
   model: string;
 
+  @ApiProperty({
+    description: 'Integration provider used for audio transcription',
+    enum: AI_INTEGRATIONS,
+    example: 'OPENAI',
+  })
+  @IsEnum(AI_INTEGRATIONS)
+  transcriptionIntegration: AiIntegrationDto;
+
+  @ApiProperty({
+    description: 'Model name used for audio transcription',
+    example: 'gpt-4o-mini-transcribe',
+  })
+  @IsString()
+  transcriptionModel: string;
+
   @ApiProperty({
     description: 'System prompt used by this agent',
     example: 'You are a helpful assistant.',

package/src/ai/create-agent.dto.ts

@@ -45,6 +45,26 @@ export class CreateAgentDto {
   @IsNotEmpty()
   model: string;
 
+  @ApiPropertyOptional({
+    description:
+      'Integration provider used specifically for audio transcription. Defaults to "integration" when omitted.',
+    enum: AI_INTEGRATIONS,
+    example: 'GEMINI',
+  })
+  @IsOptional()
+  @IsEnum(AI_INTEGRATIONS)
+  transcriptionIntegration?: AiIntegrationDto;
+
+  @ApiPropertyOptional({
+    description:
+      'Model name used specifically for audio transcription. Defaults to "model" when omitted.',
+    example: 'gemini-2.0-flash',
+  })
+  @IsOptional()
+  @IsString()
+  @IsNotEmpty()
+  transcriptionModel?: string;
+
   @ApiProperty({
     description: 'System prompt applied before user messages',
     example: 'You are an assistant for healthcare front-desk tasks.',

package/src/ai/update-agent.dto.ts

@@ -40,6 +40,25 @@ export class UpdateAgentDto {
   @IsNotEmpty()
   model?: string;
 
+  @ApiPropertyOptional({
+    description:
+      'Integration provider used specifically for audio transcription',
+    enum: AI_INTEGRATIONS,
+    example: 'OPENAI',
+  })
+  @IsOptional()
+  @IsEnum(AI_INTEGRATIONS)
+  transcriptionIntegration?: AiIntegrationDto;
+
+  @ApiPropertyOptional({
+    description: 'Model name used specifically for audio transcription',
+    example: 'gpt-4o-mini-transcribe',
+  })
+  @IsOptional()
+  @IsString()
+  @IsNotEmpty()
+  transcriptionModel?: string;
+
   @ApiPropertyOptional({
     description: 'System prompt applied before user messages',
     example: 'You are a concise assistant for customer support.',

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

@@ -0,0 +1,58 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import {
+  IsBoolean,
+  IsDateString,
+  IsNotEmpty,
+  IsNumber,
+  IsOptional,
+  IsString,
+  MaxLength,
+} from 'class-validator';
+
+/**
+ * DTO for creating a procedure linked to an appointment.
+ * Procedures belong to appointments (not directly to patients).
+ */
+export class AppointmentProcedureDto {
+  @ApiProperty({
+    description: 'Name of the procedure to be performed or already performed',
+    example: 'Consulta clínica',
+    maxLength: 255,
+  })
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(255)
+  name: string;
+
+  @ApiProperty({
+    description: 'Monetary value of the procedure',
+    example: 150.5,
+  })
+  @IsNumber({ maxDecimalPlaces: 2 })
+  value: number;
+
+  @ApiProperty({
+    description: 'Indicates whether the procedure has been completed',
+    example: false,
+  })
+  @IsBoolean()
+  finished: boolean;
+
+  @ApiPropertyOptional({
+    description: 'Date and time when the procedure was completed (ISO 8601)',
+    example: '2026-03-10T14:30:00.000Z',
+  })
+  @IsOptional()
+  @IsDateString()
+  finished_at?: string | null;
+
+  @ApiPropertyOptional({
+    description: 'Additional observation about the procedure',
+    example: 'Paciente chegou em jejum',
+    maxLength: 2000,
+  })
+  @IsString()
+  @IsOptional()
+  @MaxLength(2000)
+  observation?: string | null;
+}

package/src/appointments/index.ts

@@ -4,4 +4,6 @@ export * from './list-appointments-query.dto';
 export * from './available-slots-query.dto';
 export * from './available-slots-response.dto';
 export * from './appointment-status.dto';
-export * from './appointment.dto';
+export * from './appointment.dto';
+export * from './appointment-procedure.dto';
+export * from './update-appointment-procedure.dto';

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

@@ -0,0 +1,10 @@
+import { PartialType } from '@nestjs/swagger';
+import { AppointmentProcedureDto } from './appointment-procedure.dto';
+
+/**
+ * DTO for partially updating an appointment procedure.
+ * All fields are optional.
+ */
+export class UpdateAppointmentProcedureDto extends PartialType(
+  AppointmentProcedureDto,
+) {}