tychat-contracts 1.0.97 → 1.0.99

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

@@ -1,7 +1,7 @@
 import { AppointmentDto } from './appointment.dto';
 import { AppointmentStatusDto } from './appointment-status.dto';
 /** Campo principal de ordenação na listagem de agendamentos. */
-export declare const APPOINTMENT_LIST_SORT_BY: readonly ["date", "checkin_completed"];
+export declare const APPOINTMENT_LIST_SORT_BY: readonly ["date", "checkin_completed", "checkout_completed"];
 export type AppointmentListSortByDto = (typeof APPOINTMENT_LIST_SORT_BY)[number];
 export declare const APPOINTMENT_LIST_SORT_ORDER: readonly ["ASC", "DESC"];
 export type AppointmentListSortOrderDto = (typeof APPOINTMENT_LIST_SORT_ORDER)[number];
@@ -12,6 +12,7 @@ export declare class ListAppointmentsQueryDto {
     dateTo?: string;
     userId?: string;
     checkinCompleted?: boolean;
+    checkoutCompleted?: boolean;
     patientId?: string;
     status?: AppointmentStatusDto;
     sortBy?: AppointmentListSortByDto;

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

@@ -1 +1 @@
-{"version":3,"file":"list-appointments-query.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/list-appointments-query.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAwB,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,gEAAgE;AAChE,eAAO,MAAM,wBAAwB,wCAAyC,CAAC;AAC/E,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjF,eAAO,MAAM,2BAA2B,0BAA2B,CAAC;AACpE,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvF,qBAAa,wBAAwB;IAUnC,IAAI,CAAC,EAAE,MAAM,CAAC;IAad,KAAK,CAAC,EAAE,MAAM,CAAC;IAQf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAQlB,MAAM,CAAC,EAAE,MAAM,CAAC;IAQhB,MAAM,CAAC,EAAE,MAAM,CAAC;IAQhB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAQ3B,SAAS,CAAC,EAAE,MAAM,CAAC;IAUnB,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAU9B,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAUlC,SAAS,CAAC,EAAE,2BAA2B,CAAC;CACzC;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf"}
+{"version":3,"file":"list-appointments-query.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/list-appointments-query.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAwB,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,gEAAgE;AAChE,eAAO,MAAM,wBAAwB,8DAI3B,CAAC;AACX,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjF,eAAO,MAAM,2BAA2B,0BAA2B,CAAC;AACpE,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvF,qBAAa,wBAAwB;IAUnC,IAAI,CAAC,EAAE,MAAM,CAAC;IAad,KAAK,CAAC,EAAE,MAAM,CAAC;IAQf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAQlB,MAAM,CAAC,EAAE,MAAM,CAAC;IAQhB,MAAM,CAAC,EAAE,MAAM,CAAC;IAQhB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAQ3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAQ5B,SAAS,CAAC,EAAE,MAAM,CAAC;IAUnB,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAU9B,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAUlC,SAAS,CAAC,EAAE,2BAA2B,CAAC;CACzC;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf"}

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

@@ -14,7 +14,11 @@ const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
 const appointment_status_dto_1 = require("./appointment-status.dto");
 /** Campo principal de ordenação na listagem de agendamentos. */
-exports.APPOINTMENT_LIST_SORT_BY = ['date', 'checkin_completed'];
+exports.APPOINTMENT_LIST_SORT_BY = [
+    'date',
+    'checkin_completed',
+    'checkout_completed',
+];
 exports.APPOINTMENT_LIST_SORT_ORDER = ['ASC', 'DESC'];
 class ListAppointmentsQueryDto {
     page;
@@ -23,6 +27,7 @@ class ListAppointmentsQueryDto {
     dateTo;
     userId;
     checkinCompleted;
+    checkoutCompleted;
     patientId;
     status;
     sortBy;
@@ -91,6 +96,15 @@ __decorate([
     (0, class_validator_1.IsBoolean)(),
     __metadata("design:type", Boolean)
 ], ListAppointmentsQueryDto.prototype, "checkinCompleted", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Filtrar por status de check-out realizado',
+        example: false,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], ListAppointmentsQueryDto.prototype, "checkoutCompleted", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
         description: 'Filtrar por paciente (UUID) - histórico de consultas',
@@ -113,7 +127,7 @@ __decorate([
 ], ListAppointmentsQueryDto.prototype, "status", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
-        description: 'Ordenação principal: `date` (data do agendamento) ou `checkin_completed` (check-in feito ou pendente). Omisso = `date`.',
+        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: exports.APPOINTMENT_LIST_SORT_BY,
         example: 'checkin_completed',
     }),
@@ -123,7 +137,7 @@ __decorate([
 ], ListAppointmentsQueryDto.prototype, "sortBy", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
-        description: 'Direção: `ASC` ou `DESC`. Com `sortBy=checkin_completed`, `ASC` coloca pendentes (false) primeiro; `DESC` coloca concluídos (true) primeiro. Com ordenação por data, aplica-se à coluna `date`.',
+        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: exports.APPOINTMENT_LIST_SORT_ORDER,
         example: 'ASC',
     }),

package/dist/conversations/index.d.ts

@@ -1,5 +1,7 @@
 export * from './conversation-type.dto';
 export * from './conversation-intention.dto';
+export * from './list-conversation-contacts-filters.dto';
+export * from './list-conversation-contacts-query.dto';
 export * from './create-conversation-session.dto';
 export * from './conversation-session-response.dto';
 export * from './create-conversation.dto';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conversations/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,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,0CAA0C,CAAC;AACzD,cAAc,wCAAwC,CAAC;AACvD,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC"}

package/dist/conversations/index.js

@@ -16,6 +16,8 @@ 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("./list-conversation-contacts-filters.dto"), exports);
+__exportStar(require("./list-conversation-contacts-query.dto"), exports);
 __exportStar(require("./create-conversation-session.dto"), exports);
 __exportStar(require("./conversation-session-response.dto"), exports);
 __exportStar(require("./create-conversation.dto"), exports);

package/dist/conversations/list-conversation-contacts-filters.dto.d.ts

@@ -0,0 +1,20 @@
+import { ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
+/** Campos da sessão (`conversation_sessions`) em `filters[].key` (camelCase da API). */
+export declare const CONVERSATION_CONTACT_LIST_FILTER_KEYS: readonly ["id", "sessionUuid", "patientId", "unitId", "tenantEvogoInstanceId", "conversationType", "intention", "unreadCount", "startedAt", "expiresAt"];
+export type ConversationContactListFilterKeyDto = (typeof CONVERSATION_CONTACT_LIST_FILTER_KEYS)[number];
+export declare const CONVERSATION_CONTACT_LIST_FILTER_OPS: readonly ["==", ">", "<", ">=", "<=", "!=", "in"];
+export type ConversationContactListFilterOpDto = (typeof CONVERSATION_CONTACT_LIST_FILTER_OPS)[number];
+export declare class ConversationContactListFilterValueConstraint implements ValidatorConstraintInterface {
+    validate(value: unknown, args: ValidationArguments): boolean;
+    defaultMessage(): string;
+}
+/**
+ * Critério de filtro na listagem de contatos (sessão mais recente por paciente).
+ * Apenas `key`, `op` e `value`.
+ */
+export declare class ConversationContactListFilterDto {
+    key: ConversationContactListFilterKeyDto;
+    op: ConversationContactListFilterOpDto;
+    value: unknown;
+}
+//# sourceMappingURL=list-conversation-contacts-filters.dto.d.ts.map

package/dist/conversations/list-conversation-contacts-filters.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-conversation-contacts-filters.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/list-conversation-contacts-filters.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAML,mBAAmB,EAEnB,4BAA4B,EAC7B,MAAM,iBAAiB,CAAC;AAEzB,wFAAwF;AACxF,eAAO,MAAM,qCAAqC,0JAWxC,CAAC;AACX,MAAM,MAAM,mCAAmC,GAC7C,CAAC,OAAO,qCAAqC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAO,MAAM,oCAAoC,mDAQvC,CAAC;AACX,MAAM,MAAM,kCAAkC,GAC5C,CAAC,OAAO,oCAAoC,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,qBACa,4CACX,YAAW,4BAA4B;IAEvC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO;IAS5D,cAAc,IAAI,MAAM;CAKzB;AAED;;;GAGG;AACH,qBAAa,gCAAgC;IAQ3C,GAAG,EAAE,mCAAmC,CAAC;IASzC,EAAE,EAAE,kCAAkC,CAAC;IAQvC,KAAK,EAAE,OAAO,CAAC;CAChB"}

package/dist/conversations/list-conversation-contacts-filters.dto.js

@@ -0,0 +1,91 @@
+"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.ConversationContactListFilterDto = exports.ConversationContactListFilterValueConstraint = exports.CONVERSATION_CONTACT_LIST_FILTER_OPS = exports.CONVERSATION_CONTACT_LIST_FILTER_KEYS = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+/** Campos da sessão (`conversation_sessions`) em `filters[].key` (camelCase da API). */
+exports.CONVERSATION_CONTACT_LIST_FILTER_KEYS = [
+    'id',
+    'sessionUuid',
+    'patientId',
+    'unitId',
+    'tenantEvogoInstanceId',
+    'conversationType',
+    'intention',
+    'unreadCount',
+    'startedAt',
+    'expiresAt',
+];
+exports.CONVERSATION_CONTACT_LIST_FILTER_OPS = [
+    '==',
+    '>',
+    '<',
+    '>=',
+    '<=',
+    '!=',
+    'in',
+];
+let ConversationContactListFilterValueConstraint = class ConversationContactListFilterValueConstraint {
+    validate(value, args) {
+        const obj = args.object;
+        const op = obj?.op;
+        if (op === 'in') {
+            return Array.isArray(value) && value.length >= 1;
+        }
+        return !Array.isArray(value);
+    }
+    defaultMessage() {
+        return ('Para op "in", value deve ser um array não vazio; para as demais operações, value não pode ser array');
+    }
+};
+exports.ConversationContactListFilterValueConstraint = ConversationContactListFilterValueConstraint;
+exports.ConversationContactListFilterValueConstraint = ConversationContactListFilterValueConstraint = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'conversationContactListFilterValueShape', async: false })
+], ConversationContactListFilterValueConstraint);
+/**
+ * Critério de filtro na listagem de contatos (sessão mais recente por paciente).
+ * Apenas `key`, `op` e `value`.
+ */
+class ConversationContactListFilterDto {
+    key;
+    op;
+    value;
+}
+exports.ConversationContactListFilterDto = ConversationContactListFilterDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Campo da sessão (camelCase)',
+        enum: exports.CONVERSATION_CONTACT_LIST_FILTER_KEYS,
+        example: 'patientId',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsIn)(exports.CONVERSATION_CONTACT_LIST_FILTER_KEYS),
+    __metadata("design:type", String)
+], ConversationContactListFilterDto.prototype, "key", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Operador de comparação',
+        enum: exports.CONVERSATION_CONTACT_LIST_FILTER_OPS,
+        example: '==',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsIn)(exports.CONVERSATION_CONTACT_LIST_FILTER_OPS),
+    __metadata("design:type", String)
+], ConversationContactListFilterDto.prototype, "op", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Valor escalar ou, com op "in", array. null permitido para == / != em colunas opcionais (ex.: intention, unitId).',
+        example: '00000000-0000-4000-8000-000000000000',
+    }),
+    (0, class_validator_1.Validate)(ConversationContactListFilterValueConstraint),
+    __metadata("design:type", Object)
+], ConversationContactListFilterDto.prototype, "value", void 0);

package/dist/conversations/list-conversation-contacts-query.dto.d.ts

@@ -0,0 +1,7 @@
+import { ConversationContactListFilterDto } from './list-conversation-contacts-filters.dto';
+export declare class ListConversationContactsQueryDto {
+    page?: number;
+    limit?: number;
+    filters?: ConversationContactListFilterDto[];
+}
+//# sourceMappingURL=list-conversation-contacts-query.dto.d.ts.map

package/dist/conversations/list-conversation-contacts-query.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-conversation-contacts-query.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/list-conversation-contacts-query.dto.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,gCAAgC,EAAE,MAAM,0CAA0C,CAAC;AAyB5F,qBAAa,gCAAgC;IAU3C,IAAI,CAAC,EAAE,MAAM,CAAC;IAad,KAAK,CAAC,EAAE,MAAM,CAAC;IAcf,OAAO,CAAC,EAAE,gCAAgC,EAAE,CAAC;CAC9C"}

package/dist/conversations/list-conversation-contacts-query.dto.js

@@ -0,0 +1,83 @@
+"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.ListConversationContactsQueryDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const list_conversation_contacts_filters_dto_1 = require("./list-conversation-contacts-filters.dto");
+function parseFiltersFromQuery(value) {
+    if (value === undefined || value === null || value === '') {
+        return undefined;
+    }
+    if (Array.isArray(value)) {
+        return value;
+    }
+    if (typeof value === 'string') {
+        try {
+            const parsed = JSON.parse(value);
+            if (!Array.isArray(parsed)) {
+                return undefined;
+            }
+            return parsed;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return undefined;
+}
+class ListConversationContactsQueryDto {
+    page;
+    limit;
+    filters;
+}
+exports.ListConversationContactsQueryDto = ListConversationContactsQueryDto;
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Número da página (iniciando em 1)',
+        example: 1,
+        minimum: 1,
+        default: 1,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], ListConversationContactsQueryDto.prototype, "page", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Registros por página',
+        example: 20,
+        minimum: 1,
+        maximum: 100,
+        default: 20,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], ListConversationContactsQueryDto.prototype, "limit", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Lista `{ key, op, value }`. Na query HTTP: string JSON (ex.: `[{"key":"conversationType","op":"==","value":"ia"}]`). Ops: ==, !=, >, <, >=, <=, in.',
+        type: [list_conversation_contacts_filters_dto_1.ConversationContactListFilterDto],
+        isArray: true,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => parseFiltersFromQuery(value)),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(0),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => list_conversation_contacts_filters_dto_1.ConversationContactListFilterDto),
+    __metadata("design:type", Array)
+], ListConversationContactsQueryDto.prototype, "filters", void 0);

package/package.json

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

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

@@ -4,7 +4,11 @@ import { AppointmentDto } from './appointment.dto';
 import { APPOINTMENT_STATUSES, AppointmentStatusDto } from './appointment-status.dto';
 
 /** Campo principal de ordenação na listagem de agendamentos. */
-export const APPOINTMENT_LIST_SORT_BY = ['date', 'checkin_completed'] as const;
+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;
@@ -67,6 +71,14 @@ export class ListAppointmentsQueryDto {
   @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',
@@ -87,7 +99,7 @@ export class ListAppointmentsQueryDto {
 
   @ApiPropertyOptional({
     description:
-      'Ordenação principal: `date` (data do agendamento) ou `checkin_completed` (check-in feito ou pendente). Omisso = `date`.',
+      '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',
   })
@@ -97,7 +109,7 @@ export class ListAppointmentsQueryDto {
 
   @ApiPropertyOptional({
     description:
-      'Direção: `ASC` ou `DESC`. Com `sortBy=checkin_completed`, `ASC` coloca pendentes (false) primeiro; `DESC` coloca concluídos (true) primeiro. Com ordenação por data, aplica-se à coluna `date`.',
+      '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',
   })

package/src/conversations/index.ts

@@ -1,5 +1,7 @@
 export * from './conversation-type.dto';
 export * from './conversation-intention.dto';
+export * from './list-conversation-contacts-filters.dto';
+export * from './list-conversation-contacts-query.dto';
 export * from './create-conversation-session.dto';
 export * from './conversation-session-response.dto';
 export * from './create-conversation.dto';

package/src/conversations/list-conversation-contacts-filters.dto.ts

@@ -0,0 +1,91 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import {
+  ArrayMinSize,
+  IsArray,
+  IsIn,
+  IsString,
+  Validate,
+  ValidationArguments,
+  ValidatorConstraint,
+  ValidatorConstraintInterface,
+} from 'class-validator';
+
+/** Campos da sessão (`conversation_sessions`) em `filters[].key` (camelCase da API). */
+export const CONVERSATION_CONTACT_LIST_FILTER_KEYS = [
+  'id',
+  'sessionUuid',
+  'patientId',
+  'unitId',
+  'tenantEvogoInstanceId',
+  'conversationType',
+  'intention',
+  'unreadCount',
+  'startedAt',
+  'expiresAt',
+] as const;
+export type ConversationContactListFilterKeyDto =
+  (typeof CONVERSATION_CONTACT_LIST_FILTER_KEYS)[number];
+
+export const CONVERSATION_CONTACT_LIST_FILTER_OPS = [
+  '==',
+  '>',
+  '<',
+  '>=',
+  '<=',
+  '!=',
+  'in',
+] as const;
+export type ConversationContactListFilterOpDto =
+  (typeof CONVERSATION_CONTACT_LIST_FILTER_OPS)[number];
+
+@ValidatorConstraint({ name: 'conversationContactListFilterValueShape', async: false })
+export class ConversationContactListFilterValueConstraint
+  implements ValidatorConstraintInterface
+{
+  validate(value: unknown, args: ValidationArguments): boolean {
+    const obj = args.object as ConversationContactListFilterDto;
+    const op = obj?.op;
+    if (op === 'in') {
+      return Array.isArray(value) && value.length >= 1;
+    }
+    return !Array.isArray(value);
+  }
+
+  defaultMessage(): string {
+    return (
+      'Para op "in", value deve ser um array não vazio; para as demais operações, value não pode ser array'
+    );
+  }
+}
+
+/**
+ * Critério de filtro na listagem de contatos (sessão mais recente por paciente).
+ * Apenas `key`, `op` e `value`.
+ */
+export class ConversationContactListFilterDto {
+  @ApiProperty({
+    description: 'Campo da sessão (camelCase)',
+    enum: CONVERSATION_CONTACT_LIST_FILTER_KEYS,
+    example: 'patientId',
+  })
+  @IsString()
+  @IsIn(CONVERSATION_CONTACT_LIST_FILTER_KEYS)
+  key: ConversationContactListFilterKeyDto;
+
+  @ApiProperty({
+    description: 'Operador de comparação',
+    enum: CONVERSATION_CONTACT_LIST_FILTER_OPS,
+    example: '==',
+  })
+  @IsString()
+  @IsIn(CONVERSATION_CONTACT_LIST_FILTER_OPS)
+  op: ConversationContactListFilterOpDto;
+
+  @ApiPropertyOptional({
+    description:
+      'Valor escalar ou, com op "in", array. null permitido para == / != em colunas opcionais (ex.: intention, unitId).',
+    example: '00000000-0000-4000-8000-000000000000',
+  })
+  @Validate(ConversationContactListFilterValueConstraint)
+  value: unknown;
+}

package/src/conversations/list-conversation-contacts-query.dto.ts

@@ -0,0 +1,75 @@
+import { ApiPropertyOptional } from '@nestjs/swagger';
+import { Transform, Type } from 'class-transformer';
+import {
+  ArrayMinSize,
+  IsArray,
+  IsInt,
+  IsOptional,
+  Max,
+  Min,
+  ValidateNested,
+} from 'class-validator';
+import { ConversationContactListFilterDto } from './list-conversation-contacts-filters.dto';
+
+function parseFiltersFromQuery(
+  value: unknown,
+): ConversationContactListFilterDto[] | undefined {
+  if (value === undefined || value === null || value === '') {
+    return undefined;
+  }
+  if (Array.isArray(value)) {
+    return value as ConversationContactListFilterDto[];
+  }
+  if (typeof value === 'string') {
+    try {
+      const parsed = JSON.parse(value) as unknown;
+      if (!Array.isArray(parsed)) {
+        return undefined;
+      }
+      return parsed as ConversationContactListFilterDto[];
+    } catch {
+      return undefined;
+    }
+  }
+  return undefined;
+}
+
+export class ListConversationContactsQueryDto {
+  @ApiPropertyOptional({
+    description: 'Número da página (iniciando em 1)',
+    example: 1,
+    minimum: 1,
+    default: 1,
+  })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  page?: number;
+
+  @ApiPropertyOptional({
+    description: 'Registros por página',
+    example: 20,
+    minimum: 1,
+    maximum: 100,
+    default: 20,
+  })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  @Max(100)
+  limit?: number;
+
+  @ApiPropertyOptional({
+    description:
+      'Lista `{ key, op, value }`. Na query HTTP: string JSON (ex.: `[{"key":"conversationType","op":"==","value":"ia"}]`). Ops: ==, !=, >, <, >=, <=, in.',
+    type: [ConversationContactListFilterDto],
+    isArray: true,
+  })
+  @IsOptional()
+  @Transform(({ value }) => parseFiltersFromQuery(value))
+  @IsArray()
+  @ArrayMinSize(0)
+  @ValidateNested({ each: true })
+  @Type(() => ConversationContactListFilterDto)
+  filters?: ConversationContactListFilterDto[];
+}