tychat-contracts 1.6.21 → 1.6.24

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

@@ -1,153 +1,153 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { Type } from 'class-transformer';
-import {
-  IsArray,
-  IsBoolean,
-  IsDateString,
-  IsEnum,
-  IsNotEmpty,
-  IsOptional,
-  IsString,
-  IsUUID,
-  ValidateNested,
-} from 'class-validator';
-import { AppointmentProcedureDto } from './appointment-procedure.dto';
-import {
-  APPOINTMENT_STATUSES,
-  APPOINTMENT_TYPES,
-  AppointmentStatusDto,
-  AppointmentTypeDto,
-} from './appointment-status.dto';
-
-
-
-export class CreateAppointmentDto {
-  @ApiProperty({
-    description: 'ID do paciente (UUID)',
-    example: '550e8400-e29b-41d4-a716-446655440000',
-  })
-  @IsUUID('4')
-  @IsNotEmpty()
-  patientId: string;
-
-  @ApiProperty({
-    description: 'Data e hora do agendamento (ISO 8601)',
-    example: '2026-03-15T14:00:00.000Z',
-  })
-  @IsDateString()
-  date: string;
-
-  @ApiProperty({
-    description: 'ID do profissional de saúde atrelado ao agendamento (UUID)',
-    example: '550e8400-e29b-41d4-a716-446655440001',
-  })
-  @IsUUID('4')
-  @IsNotEmpty()
-  userId: string;
-
-  @ApiPropertyOptional({
-    description: 'Indica se o check-in foi realizado',
-    example: false,
-    default: false,
-  })
-  @IsOptional()
-  @IsBoolean()
-  checkinCompleted?: boolean;
-
-  @ApiPropertyOptional({
-    description: 'Indica se o check-out foi realizado',
-    example: false,
-    default: false,
-  })
-  @IsOptional()
-  @IsBoolean()
-  checkoutCompleted?: boolean;
-
-  @ApiPropertyOptional({
-    description: 'Horário de saída do atendimento (ISO 8601)',
-    example: '2026-03-15T14:45:00.000Z',
-  })
-  @IsOptional()
-  @IsDateString()
-  exitTime?: string;
-
-  @ApiPropertyOptional({
-    description: 'Observação do agendamento',
-    example: 'Paciente solicitou prioridade no retorno.',
-  })
-  @IsOptional()
-  @IsString()
-  observation?: string;
-
-  @ApiPropertyOptional({
-    description: 'Motivo do cancelamento',
-    example: 'Paciente não compareceu.',
-  })
-  @IsOptional()
-  @IsString()
-  cancellationReason?: string;
-
-  @ApiPropertyOptional({
-    description: 'Status do agendamento',
-    enum: APPOINTMENT_STATUSES,
-    default: 'pending',
-  })
-  @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;
-
-  @ApiPropertyOptional({
-    description:
-      'Procedimentos a gravar junto com o agendamento (analytics `appointment.created` inclui a lista)',
-    type: [AppointmentProcedureDto],
-  })
-  @IsOptional()
-  @IsArray()
-  @ValidateNested({ each: true })
-  @Type(() => AppointmentProcedureDto)
-  initialProcedures?: AppointmentProcedureDto[];
-
-  @ApiPropertyOptional({
-    description: 'Sinaliza que o fluxo de criação já pediu disparo de termo jurídico para o paciente',
-    default: false,
-  })
-  @IsOptional()
-  @IsBoolean()
-  legalTermRequested?: boolean;
-
-  @ApiPropertyOptional({
-    description:
-      'IDs de procedimentos (UUID) usados como contexto do termo jurídico solicitado na criação do agendamento',
-    type: [String],
-    format: 'uuid',
-  })
-  @IsOptional()
-  @IsArray()
-  @IsUUID('4', { each: true })
-  legalTermProcedureIds?: string[];
-}
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import {
+  IsArray,
+  IsBoolean,
+  IsDateString,
+  IsEnum,
+  IsNotEmpty,
+  IsOptional,
+  IsString,
+  IsUUID,
+  ValidateNested,
+} from 'class-validator';
+import { AppointmentProcedureDto } from './appointment-procedure.dto';
+import {
+  APPOINTMENT_STATUSES,
+  APPOINTMENT_TYPES,
+  AppointmentStatusDto,
+  AppointmentTypeDto,
+} from './appointment-status.dto';
+
+
+
+export class CreateAppointmentDto {
+  @ApiProperty({
+    description: 'ID do paciente (UUID)',
+    example: '550e8400-e29b-41d4-a716-446655440000',
+  })
+  @IsUUID('4')
+  @IsNotEmpty()
+  patientId: string;
+
+  @ApiProperty({
+    description: 'Data e hora do agendamento (ISO 8601)',
+    example: '2026-03-15T14:00:00.000Z',
+  })
+  @IsDateString()
+  date: string;
+
+  @ApiProperty({
+    description: 'ID do profissional de saúde atrelado ao agendamento (UUID)',
+    example: '550e8400-e29b-41d4-a716-446655440001',
+  })
+  @IsUUID('4')
+  @IsNotEmpty()
+  userId: string;
+
+  @ApiPropertyOptional({
+    description: 'Indica se o check-in foi realizado',
+    example: false,
+    default: false,
+  })
+  @IsOptional()
+  @IsBoolean()
+  checkinCompleted?: boolean;
+
+  @ApiPropertyOptional({
+    description: 'Indica se o check-out foi realizado',
+    example: false,
+    default: false,
+  })
+  @IsOptional()
+  @IsBoolean()
+  checkoutCompleted?: boolean;
+
+  @ApiPropertyOptional({
+    description: 'Horário de saída do atendimento (ISO 8601)',
+    example: '2026-03-15T14:45:00.000Z',
+  })
+  @IsOptional()
+  @IsDateString()
+  exitTime?: string;
+
+  @ApiPropertyOptional({
+    description: 'Observação do agendamento',
+    example: 'Paciente solicitou prioridade no retorno.',
+  })
+  @IsOptional()
+  @IsString()
+  observation?: string;
+
+  @ApiPropertyOptional({
+    description: 'Motivo do cancelamento',
+    example: 'Paciente não compareceu.',
+  })
+  @IsOptional()
+  @IsString()
+  cancellationReason?: string;
+
+  @ApiPropertyOptional({
+    description: 'Status do agendamento',
+    enum: APPOINTMENT_STATUSES,
+    default: 'pending',
+  })
+  @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;
+
+  @ApiPropertyOptional({
+    description:
+      'Procedimentos a gravar junto com o agendamento (analytics `appointment.created` inclui a lista)',
+    type: [AppointmentProcedureDto],
+  })
+  @IsOptional()
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => AppointmentProcedureDto)
+  initialProcedures?: AppointmentProcedureDto[];
+
+  @ApiPropertyOptional({
+    description: 'Sinaliza que o fluxo de criação já pediu disparo de termo jurídico para o paciente',
+    default: false,
+  })
+  @IsOptional()
+  @IsBoolean()
+  legalTermRequested?: boolean;
+
+  @ApiPropertyOptional({
+    description:
+      'IDs de procedimentos (UUID) usados como contexto do termo jurídico solicitado na criação do agendamento',
+    type: [String],
+    format: 'uuid',
+  })
+  @IsOptional()
+  @IsArray()
+  @IsUUID('4', { each: true })
+  legalTermProcedureIds?: string[];
+}

package/src/appointments/index.ts

@@ -1,11 +1,11 @@
-export * from './create-appointment.dto';
-export * from './update-appointment.dto';
-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-procedure.dto';
-export * from './update-appointment-procedure.dto';
-export * from './care-queue.dto';
+export * from './create-appointment.dto';
+export * from './update-appointment.dto';
+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-procedure.dto';
+export * from './update-appointment-procedure.dto';
+export * from './care-queue.dto';
 export * from './appointment-calendar.dto';

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

@@ -1,158 +1,158 @@
-import { ApiPropertyOptional } from '@nestjs/swagger';
-import { IsBoolean, IsDateString, IsIn, IsInt, IsOptional, IsString, IsUUID, Max, Min } from 'class-validator';
-import type { ParsedFilterDto } from '../filters/parsed-filter.dto';
-import { AppointmentDto } from './appointment.dto';
-import { APPOINTMENT_STATUSES, AppointmentStatusDto } from './appointment-status.dto';
-
-/** Colunas permitidas na listagem de agendamentos (camelCase). */
-export const APPOINTMENT_LIST_FILTER_KEYS = [
-  'id',
-  'patientId',
-  'userId',
-  'date',
-  'checkinCompleted',
-  'checkoutCompleted',
-  'exitTime',
-  'observation',
-  'cancellationReason',
-  'status',
-  'appointmentType',
-  'rescheduledFromId',
-  'returnFromAppointmentId',
-  'createdAt',
-  'updatedAt',
-] as const;
-export type AppointmentListFilterKeyDto = (typeof APPOINTMENT_LIST_FILTER_KEYS)[number];
-
-/** Campo principal de ordenação na listagem de agendamentos. */
-export const APPOINTMENT_LIST_SORT_BY = [
-  'date',
-  'checkin_completed',
-  'checkout_completed',
-] as const;
-export type AppointmentListSortByDto = (typeof APPOINTMENT_LIST_SORT_BY)[number];
-
-export const APPOINTMENT_LIST_SORT_ORDER = ['ASC', 'DESC'] as const;
-export type AppointmentListSortOrderDto = (typeof APPOINTMENT_LIST_SORT_ORDER)[number];
-
-export class ListAppointmentsQueryDto {
-  @ApiPropertyOptional({
-    description: 'Número da página (iniciando em 1)',
-    example: 1,
-    minimum: 1,
-    default: 1,
-  })
-  @IsOptional()
-  @IsInt()
-  @Min(1)
-  page?: number;
-
-  @ApiPropertyOptional({
-    description: 'Quantidade de registros por página',
-    example: 20,
-    minimum: 1,
-    maximum: 100,
-    default: 20,
-  })
-  @IsOptional()
-  @IsInt()
-  @Min(1)
-  @Max(100)
-  limit?: number;
-
-  @ApiPropertyOptional({
-    description: 'Filtrar agendamentos a partir desta data (ISO 8601)',
-    example: '2026-03-01T00:00:00.000Z',
-  })
-  @IsOptional()
-  @IsDateString()
-  dateFrom?: string;
-
-  @ApiPropertyOptional({
-    description: 'Filtrar agendamentos até esta data (ISO 8601)',
-    example: '2026-03-31T23:59:59.999Z',
-  })
-  @IsOptional()
-  @IsDateString()
-  dateTo?: string;
-
-  @ApiPropertyOptional({
-    description: 'Filtrar por profissional (UUID)',
-    example: '550e8400-e29b-41d4-a716-446655440001',
-  })
-  @IsOptional()
-  @IsUUID('4')
-  userId?: string;
-
-  @ApiPropertyOptional({
-    description: 'Filtrar por status de check-in realizado',
-    example: true,
-  })
-  @IsOptional()
-  @IsBoolean()
-  checkinCompleted?: boolean;
-
-  @ApiPropertyOptional({
-    description: 'Filtrar por status de check-out realizado',
-    example: false,
-  })
-  @IsOptional()
-  @IsBoolean()
-  checkoutCompleted?: boolean;
-
-  @ApiPropertyOptional({
-    description: 'Filtrar por paciente (UUID) - histórico de consultas',
-    example: '550e8400-e29b-41d4-a716-446655440000',
-  })
-  @IsOptional()
-  @IsUUID('4')
-  patientId?: string;
-
-  @ApiPropertyOptional({
-    description: 'Filtrar por status do agendamento',
-    example: 'processing',
-    enum: APPOINTMENT_STATUSES,
-  })
-  @IsOptional()
-  @IsString()
-  @IsIn(APPOINTMENT_STATUSES)
-  status?: AppointmentStatusDto;
-
-  @ApiPropertyOptional({
-    description:
-      'Ordenação principal: `date`, `checkin_completed` (check-in pendente vs concluído) ou `checkout_completed` (check-out pendente vs concluído). Omisso = `date`.',
-    enum: APPOINTMENT_LIST_SORT_BY,
-    example: 'checkin_completed',
-  })
-  @IsOptional()
-  @IsIn(APPOINTMENT_LIST_SORT_BY)
-  sortBy?: AppointmentListSortByDto;
-
-  @ApiPropertyOptional({
-    description:
-      'Direção: `ASC` ou `DESC`. Com `checkin_completed` ou `checkout_completed`, `ASC` coloca pendentes (false) primeiro; `DESC` coloca concluídos (true) primeiro. Com `date`, aplica-se à coluna `date`.',
-    enum: APPOINTMENT_LIST_SORT_ORDER,
-    example: 'ASC',
-  })
-  @IsOptional()
-  @IsIn(APPOINTMENT_LIST_SORT_ORDER)
-  sortOrder?: AppointmentListSortOrderDto;
-
-  @ApiPropertyOptional({
-    description:
-      'JSON string with an array of filter objects `{ key, op, value }`. ' +
-      'Example: `[{"key":"status","op":"==","value":"pending"}]`. ' +
-      'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`), like, unlike (string pattern).',
-    type: String,
-    example: '[{"key":"status","op":"==","value":"pending"}]',
-  })
-  @IsOptional()
-  filters?: ParsedFilterDto[];
-}
-
-export interface AppointmentListResult {
-  items: AppointmentDto[];
-  total: number;
-  page: number;
-  limit: number;
+import { ApiPropertyOptional } from '@nestjs/swagger';
+import { IsBoolean, IsDateString, IsIn, IsInt, IsOptional, IsString, IsUUID, Max, Min } from 'class-validator';
+import type { ParsedFilterDto } from '../filters/parsed-filter.dto';
+import { AppointmentDto } from './appointment.dto';
+import { APPOINTMENT_STATUSES, AppointmentStatusDto } from './appointment-status.dto';
+
+/** Colunas permitidas na listagem de agendamentos (camelCase). */
+export const APPOINTMENT_LIST_FILTER_KEYS = [
+  'id',
+  'patientId',
+  'userId',
+  'date',
+  'checkinCompleted',
+  'checkoutCompleted',
+  'exitTime',
+  'observation',
+  'cancellationReason',
+  'status',
+  'appointmentType',
+  'rescheduledFromId',
+  'returnFromAppointmentId',
+  'createdAt',
+  'updatedAt',
+] as const;
+export type AppointmentListFilterKeyDto = (typeof APPOINTMENT_LIST_FILTER_KEYS)[number];
+
+/** Campo principal de ordenação na listagem de agendamentos. */
+export const APPOINTMENT_LIST_SORT_BY = [
+  'date',
+  'checkin_completed',
+  'checkout_completed',
+] as const;
+export type AppointmentListSortByDto = (typeof APPOINTMENT_LIST_SORT_BY)[number];
+
+export const APPOINTMENT_LIST_SORT_ORDER = ['ASC', 'DESC'] as const;
+export type AppointmentListSortOrderDto = (typeof APPOINTMENT_LIST_SORT_ORDER)[number];
+
+export class ListAppointmentsQueryDto {
+  @ApiPropertyOptional({
+    description: 'Número da página (iniciando em 1)',
+    example: 1,
+    minimum: 1,
+    default: 1,
+  })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  page?: number;
+
+  @ApiPropertyOptional({
+    description: 'Quantidade de registros por página',
+    example: 20,
+    minimum: 1,
+    maximum: 100,
+    default: 20,
+  })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  @Max(100)
+  limit?: number;
+
+  @ApiPropertyOptional({
+    description: 'Filtrar agendamentos a partir desta data (ISO 8601)',
+    example: '2026-03-01T00:00:00.000Z',
+  })
+  @IsOptional()
+  @IsDateString()
+  dateFrom?: string;
+
+  @ApiPropertyOptional({
+    description: 'Filtrar agendamentos até esta data (ISO 8601)',
+    example: '2026-03-31T23:59:59.999Z',
+  })
+  @IsOptional()
+  @IsDateString()
+  dateTo?: string;
+
+  @ApiPropertyOptional({
+    description: 'Filtrar por profissional (UUID)',
+    example: '550e8400-e29b-41d4-a716-446655440001',
+  })
+  @IsOptional()
+  @IsUUID('4')
+  userId?: string;
+
+  @ApiPropertyOptional({
+    description: 'Filtrar por status de check-in realizado',
+    example: true,
+  })
+  @IsOptional()
+  @IsBoolean()
+  checkinCompleted?: boolean;
+
+  @ApiPropertyOptional({
+    description: 'Filtrar por status de check-out realizado',
+    example: false,
+  })
+  @IsOptional()
+  @IsBoolean()
+  checkoutCompleted?: boolean;
+
+  @ApiPropertyOptional({
+    description: 'Filtrar por paciente (UUID) - histórico de consultas',
+    example: '550e8400-e29b-41d4-a716-446655440000',
+  })
+  @IsOptional()
+  @IsUUID('4')
+  patientId?: string;
+
+  @ApiPropertyOptional({
+    description: 'Filtrar por status do agendamento',
+    example: 'processing',
+    enum: APPOINTMENT_STATUSES,
+  })
+  @IsOptional()
+  @IsString()
+  @IsIn(APPOINTMENT_STATUSES)
+  status?: AppointmentStatusDto;
+
+  @ApiPropertyOptional({
+    description:
+      'Ordenação principal: `date`, `checkin_completed` (check-in pendente vs concluído) ou `checkout_completed` (check-out pendente vs concluído). Omisso = `date`.',
+    enum: APPOINTMENT_LIST_SORT_BY,
+    example: 'checkin_completed',
+  })
+  @IsOptional()
+  @IsIn(APPOINTMENT_LIST_SORT_BY)
+  sortBy?: AppointmentListSortByDto;
+
+  @ApiPropertyOptional({
+    description:
+      'Direção: `ASC` ou `DESC`. Com `checkin_completed` ou `checkout_completed`, `ASC` coloca pendentes (false) primeiro; `DESC` coloca concluídos (true) primeiro. Com `date`, aplica-se à coluna `date`.',
+    enum: APPOINTMENT_LIST_SORT_ORDER,
+    example: 'ASC',
+  })
+  @IsOptional()
+  @IsIn(APPOINTMENT_LIST_SORT_ORDER)
+  sortOrder?: AppointmentListSortOrderDto;
+
+  @ApiPropertyOptional({
+    description:
+      'JSON string with an array of filter objects `{ key, op, value }`. ' +
+      'Example: `[{"key":"status","op":"==","value":"pending"}]`. ' +
+      'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`), like, unlike (string pattern).',
+    type: String,
+    example: '[{"key":"status","op":"==","value":"pending"}]',
+  })
+  @IsOptional()
+  filters?: ParsedFilterDto[];
+}
+
+export interface AppointmentListResult {
+  items: AppointmentDto[];
+  total: number;
+  page: number;
+  limit: number;
 }

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

@@ -1,10 +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,
-) {}
+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,
+) {}

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

@@ -1,4 +1,4 @@
-import { PartialType } from '@nestjs/swagger';
-import { CreateAppointmentDto } from './create-appointment.dto';
-
-export class UpdateAppointmentDto extends PartialType(CreateAppointmentDto) {}
+import { PartialType } from '@nestjs/swagger';
+import { CreateAppointmentDto } from './create-appointment.dto';
+
+export class UpdateAppointmentDto extends PartialType(CreateAppointmentDto) {}