tychat-contracts 1.0.112 → 1.0.115

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

@@ -1,5 +1,9 @@
+import type { ParsedFilterDto } from '../filters/parsed-filter.dto';
 import { AppointmentDto } from './appointment.dto';
 import { AppointmentStatusDto } from './appointment-status.dto';
+/** Colunas permitidas na listagem de agendamentos (camelCase). */
+export declare const APPOINTMENT_LIST_FILTER_KEYS: readonly ["id", "patientId", "userId", "date", "checkinCompleted", "checkoutCompleted", "exitTime", "observation", "cancellationReason", "status", "appointmentType", "rescheduledFromId", "returnFromAppointmentId", "createdAt", "updatedAt"];
+export type AppointmentListFilterKeyDto = (typeof APPOINTMENT_LIST_FILTER_KEYS)[number];
 /** Campo principal de ordenação na listagem de agendamentos. */
 export declare const APPOINTMENT_LIST_SORT_BY: readonly ["date", "checkin_completed", "checkout_completed"];
 export type AppointmentListSortByDto = (typeof APPOINTMENT_LIST_SORT_BY)[number];
@@ -17,6 +21,7 @@ export declare class ListAppointmentsQueryDto {
     status?: AppointmentStatusDto;
     sortBy?: AppointmentListSortByDto;
     sortOrder?: AppointmentListSortOrderDto;
+    filters?: ParsedFilterDto[];
 }
 export interface AppointmentListResult {
     items: AppointmentDto[];

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,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"}
+{"version":3,"file":"list-appointments-query.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/list-appointments-query.dto.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAwB,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,kEAAkE;AAClE,eAAO,MAAM,4BAA4B,iPAgB/B,CAAC;AACX,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAC;AAExF,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;IAWxC,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;CAC7B;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

@@ -9,10 +9,28 @@ 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.ListAppointmentsQueryDto = exports.APPOINTMENT_LIST_SORT_ORDER = exports.APPOINTMENT_LIST_SORT_BY = void 0;
+exports.ListAppointmentsQueryDto = exports.APPOINTMENT_LIST_SORT_ORDER = exports.APPOINTMENT_LIST_SORT_BY = exports.APPOINTMENT_LIST_FILTER_KEYS = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
 const appointment_status_dto_1 = require("./appointment-status.dto");
+/** Colunas permitidas na listagem de agendamentos (camelCase). */
+exports.APPOINTMENT_LIST_FILTER_KEYS = [
+    'id',
+    'patientId',
+    'userId',
+    'date',
+    'checkinCompleted',
+    'checkoutCompleted',
+    'exitTime',
+    'observation',
+    'cancellationReason',
+    'status',
+    'appointmentType',
+    'rescheduledFromId',
+    'returnFromAppointmentId',
+    'createdAt',
+    'updatedAt',
+];
 /** Campo principal de ordenação na listagem de agendamentos. */
 exports.APPOINTMENT_LIST_SORT_BY = [
     'date',
@@ -32,6 +50,7 @@ class ListAppointmentsQueryDto {
     status;
     sortBy;
     sortOrder;
+    filters;
 }
 exports.ListAppointmentsQueryDto = ListAppointmentsQueryDto;
 __decorate([
@@ -145,3 +164,14 @@ __decorate([
     (0, class_validator_1.IsIn)(exports.APPOINTMENT_LIST_SORT_ORDER),
     __metadata("design:type", String)
 ], ListAppointmentsQueryDto.prototype, "sortOrder", void 0);
+__decorate([
+    (0, swagger_1.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`).',
+        type: String,
+        example: '[{"key":"status","op":"==","value":"pending"}]',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Array)
+], ListAppointmentsQueryDto.prototype, "filters", void 0);

package/dist/billing/billing-detail-response.dto.d.ts

@@ -0,0 +1,9 @@
+import { BillingLinkedPaymentDto } from './billing-linked-payment.dto';
+import { BillingResponseDto } from './billing-response.dto';
+/**
+ * Resposta de GET /billings/{id}: fatura + histórico de pagamentos no gateway.
+ */
+export declare class BillingDetailResponseDto extends BillingResponseDto {
+    payments: BillingLinkedPaymentDto[];
+}
+//# sourceMappingURL=billing-detail-response.dto.d.ts.map

package/dist/billing/billing-detail-response.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-detail-response.dto.d.ts","sourceRoot":"","sources":["../../src/billing/billing-detail-response.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,kBAAkB;IAO9D,QAAQ,EAAG,uBAAuB,EAAE,CAAC;CACtC"}

package/dist/billing/billing-detail-response.dto.js

@@ -0,0 +1,31 @@
+"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.BillingDetailResponseDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
+const billing_linked_payment_dto_1 = require("./billing-linked-payment.dto");
+const billing_response_dto_1 = require("./billing-response.dto");
+/**
+ * Resposta de GET /billings/{id}: fatura + histórico de pagamentos no gateway.
+ */
+class BillingDetailResponseDto extends billing_response_dto_1.BillingResponseDto {
+    payments;
+}
+exports.BillingDetailResponseDto = BillingDetailResponseDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        type: [billing_linked_payment_dto_1.BillingLinkedPaymentDto],
+        description: 'Todos os registros de pagamento no gateway para esta fatura (qualquer status), mais recentes primeiro.',
+    }),
+    (0, class_transformer_1.Type)(() => billing_linked_payment_dto_1.BillingLinkedPaymentDto),
+    __metadata("design:type", Array)
+], BillingDetailResponseDto.prototype, "payments", void 0);

package/dist/billing/billing-linked-payment.dto.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Resumo de um pagamento no gateway vinculado a uma fatura (listagem).
+ * Sem `metadata` para evitar payload grande (PIX QR, etc.).
+ */
+export declare class BillingLinkedPaymentDto {
+    id: string;
+    billingId: string;
+    amount: number;
+    gateway: string;
+    method: string;
+    status: string;
+    externalId?: string | null;
+    paidAt?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+//# sourceMappingURL=billing-linked-payment.dto.d.ts.map

package/dist/billing/billing-linked-payment.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-linked-payment.dto.d.ts","sourceRoot":"","sources":["../../src/billing/billing-linked-payment.dto.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,uBAAuB;IAElC,EAAE,EAAE,MAAM,CAAC;IAGX,SAAS,EAAE,MAAM,CAAC;IAGlB,MAAM,EAAE,MAAM,CAAC;IAGf,OAAO,EAAE,MAAM,CAAC;IAGhB,MAAM,EAAE,MAAM,CAAC;IAGf,MAAM,EAAE,MAAM,CAAC;IAGf,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAG3B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAGvB,SAAS,EAAE,MAAM,CAAC;IAGlB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/billing/billing-linked-payment.dto.js

@@ -0,0 +1,70 @@
+"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.BillingLinkedPaymentDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+/**
+ * Resumo de um pagamento no gateway vinculado a uma fatura (listagem).
+ * Sem `metadata` para evitar payload grande (PIX QR, etc.).
+ */
+class BillingLinkedPaymentDto {
+    id;
+    billingId;
+    amount;
+    gateway;
+    method;
+    status;
+    externalId;
+    paidAt;
+    createdAt;
+    updatedAt;
+}
+exports.BillingLinkedPaymentDto = BillingLinkedPaymentDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'ID do pagamento no gateway (UUID)' }),
+    __metadata("design:type", String)
+], BillingLinkedPaymentDto.prototype, "id", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'ID da fatura (UUID)' }),
+    __metadata("design:type", String)
+], BillingLinkedPaymentDto.prototype, "billingId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Valor cobrado' }),
+    __metadata("design:type", Number)
+], BillingLinkedPaymentDto.prototype, "amount", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'PSP (ASAAS, MERCADO_PAGO, STRIPE)' }),
+    __metadata("design:type", String)
+], BillingLinkedPaymentDto.prototype, "gateway", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Meio (PIX, CREDIT_CARD, …)' }),
+    __metadata("design:type", String)
+], BillingLinkedPaymentDto.prototype, "method", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Status no gateway' }),
+    __metadata("design:type", String)
+], BillingLinkedPaymentDto.prototype, "status", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'ID externo no PSP' }),
+    __metadata("design:type", Object)
+], BillingLinkedPaymentDto.prototype, "externalId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Data de confirmação/pagamento (ISO 8601)' }),
+    __metadata("design:type", Object)
+], BillingLinkedPaymentDto.prototype, "paidAt", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Criação (ISO 8601)' }),
+    __metadata("design:type", String)
+], BillingLinkedPaymentDto.prototype, "createdAt", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Atualização (ISO 8601)' }),
+    __metadata("design:type", String)
+], BillingLinkedPaymentDto.prototype, "updatedAt", void 0);

package/dist/billing/index.d.ts

@@ -1,5 +1,7 @@
 export * from './create-billing.dto';
 export * from './update-billing.dto';
 export * from './list-billings-query.dto';
+export * from './billing-linked-payment.dto';
 export * from './billing-response.dto';
+export * from './billing-detail-response.dto';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/billing/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/billing/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC"}

package/dist/billing/index.js

@@ -17,4 +17,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./create-billing.dto"), exports);
 __exportStar(require("./update-billing.dto"), exports);
 __exportStar(require("./list-billings-query.dto"), exports);
+__exportStar(require("./billing-linked-payment.dto"), exports);
 __exportStar(require("./billing-response.dto"), exports);
+__exportStar(require("./billing-detail-response.dto"), exports);

package/dist/conversations/followup-log-list-query.dto.d.ts

@@ -1,5 +1,8 @@
+import type { ParsedFilterDto } from '../filters/parsed-filter.dto';
 import { ConversationIntentionDto } from './conversation-intention.dto';
 import { FollowupTypeDto } from './followup-type.dto';
+export declare const FOLLOWUP_LOG_LIST_FILTER_KEYS: readonly ["id", "sessionUuid", "patientId", "attempt", "message", "intention", "followupType", "appointmentId", "sentAt"];
+export type FollowupLogListFilterKeyDto = (typeof FOLLOWUP_LOG_LIST_FILTER_KEYS)[number];
 /**
  * Query parameters for listing follow-up logs (HTTP query + Kafka payload).
  */
@@ -10,5 +13,6 @@ export declare class FollowupLogListQueryDto {
     sessionUuid?: string;
     intention?: ConversationIntentionDto;
     followupType?: FollowupTypeDto;
+    filters?: ParsedFilterDto[];
 }
 //# sourceMappingURL=followup-log-list-query.dto.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"followup-log-list-query.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/followup-log-list-query.dto.ts"],"names":[],"mappings":"AAUA,OAAO,EAEL,wBAAwB,EACzB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAkB,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtE;;GAEG;AACH,qBAAa,uBAAuB;IAMlC,IAAI,CAAC,EAAE,MAAM,CAAC;IAQd,KAAK,CAAC,EAAE,MAAM,CAAC;IAKf,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,WAAW,CAAC,EAAE,MAAM,CAAC;IAQrB,SAAS,CAAC,EAAE,wBAAwB,CAAC;IAQrC,YAAY,CAAC,EAAE,eAAe,CAAC;CAChC"}
+{"version":3,"file":"followup-log-list-query.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/followup-log-list-query.dto.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAEL,wBAAwB,EACzB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAkB,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtE,eAAO,MAAM,6BAA6B,2HAUhC,CAAC;AACX,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzF;;GAEG;AACH,qBAAa,uBAAuB;IAMlC,IAAI,CAAC,EAAE,MAAM,CAAC;IAQd,KAAK,CAAC,EAAE,MAAM,CAAC;IAKf,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,WAAW,CAAC,EAAE,MAAM,CAAC;IAQrB,SAAS,CAAC,EAAE,wBAAwB,CAAC;IAQrC,YAAY,CAAC,EAAE,eAAe,CAAC;IAW/B,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;CAC7B"}

package/dist/conversations/followup-log-list-query.dto.js

@@ -9,12 +9,23 @@ 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.FollowupLogListQueryDto = void 0;
+exports.FollowupLogListQueryDto = exports.FOLLOWUP_LOG_LIST_FILTER_KEYS = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const conversation_intention_dto_1 = require("./conversation-intention.dto");
 const followup_type_dto_1 = require("./followup-type.dto");
+exports.FOLLOWUP_LOG_LIST_FILTER_KEYS = [
+    'id',
+    'sessionUuid',
+    'patientId',
+    'attempt',
+    'message',
+    'intention',
+    'followupType',
+    'appointmentId',
+    'sentAt',
+];
 /**
  * Query parameters for listing follow-up logs (HTTP query + Kafka payload).
  */
@@ -25,6 +36,7 @@ class FollowupLogListQueryDto {
     sessionUuid;
     intention;
     followupType;
+    filters;
 }
 exports.FollowupLogListQueryDto = FollowupLogListQueryDto;
 __decorate([
@@ -74,3 +86,14 @@ __decorate([
     (0, class_validator_1.IsIn)([...followup_type_dto_1.FOLLOWUP_TYPES]),
     __metadata("design:type", String)
 ], FollowupLogListQueryDto.prototype, "followupType", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'JSON string with an array of filter objects `{ key, op, value }`. ' +
+            'Example: `[{"key":"followupType","op":"==","value":"abandonment"}]`. ' +
+            'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`).',
+        type: String,
+        example: '[{"key":"followupType","op":"==","value":"abandonment"}]',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Array)
+], FollowupLogListQueryDto.prototype, "filters", void 0);

package/dist/conversations/index.d.ts

@@ -3,6 +3,7 @@ export * from './conversation-intention.dto';
 export * from './list-conversation-contacts-filters.dto';
 export * from './conversation-contact-filters-query.validator';
 export * from './list-conversation-contacts-query.dto';
+export * from './list-conversation-sessions-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,0CAA0C,CAAC;AACzD,cAAc,gDAAgD,CAAC;AAC/D,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"}
+{"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,gDAAgD,CAAC;AAC/D,cAAc,wCAAwC,CAAC;AACvD,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

@@ -19,6 +19,7 @@ __exportStar(require("./conversation-intention.dto"), exports);
 __exportStar(require("./list-conversation-contacts-filters.dto"), exports);
 __exportStar(require("./conversation-contact-filters-query.validator"), exports);
 __exportStar(require("./list-conversation-contacts-query.dto"), exports);
+__exportStar(require("./list-conversation-sessions-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-sessions-query.dto.d.ts

@@ -0,0 +1,14 @@
+import type { ParsedFilterDto } from '../filters/parsed-filter.dto';
+/**
+ * Allowed `conversation_sessions` columns for structured filters (camelCase).
+ * Same whitelist as contact list session filters.
+ */
+export declare const CONVERSATION_SESSION_LIST_FILTER_KEYS: readonly ["id", "sessionUuid", "patientId", "unitId", "tenantEvogoInstanceId", "conversationType", "intention", "unreadCount", "startedAt", "expiresAt"];
+export type ConversationSessionListFilterKeyDto = (typeof CONVERSATION_SESSION_LIST_FILTER_KEYS)[number];
+export declare class ListConversationSessionsQueryDto {
+    page?: number;
+    limit?: number;
+    patientId?: string;
+    filters?: ParsedFilterDto[];
+}
+//# sourceMappingURL=list-conversation-sessions-query.dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-conversation-sessions-query.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/list-conversation-sessions-query.dto.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,qCAAqC,0JAWxC,CAAC;AACX,MAAM,MAAM,mCAAmC,GAC7C,CAAC,OAAO,qCAAqC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,qBAAa,gCAAgC;IAM3C,IAAI,CAAC,EAAE,MAAM,CAAC;IAQd,KAAK,CAAC,EAAE,MAAM,CAAC;IAKf,SAAS,CAAC,EAAE,MAAM,CAAC;IAWnB,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;CAC7B"}

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

@@ -0,0 +1,72 @@
+"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.ListConversationSessionsQueryDto = exports.CONVERSATION_SESSION_LIST_FILTER_KEYS = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Allowed `conversation_sessions` columns for structured filters (camelCase).
+ * Same whitelist as contact list session filters.
+ */
+exports.CONVERSATION_SESSION_LIST_FILTER_KEYS = [
+    'id',
+    'sessionUuid',
+    'patientId',
+    'unitId',
+    'tenantEvogoInstanceId',
+    'conversationType',
+    'intention',
+    'unreadCount',
+    'startedAt',
+    'expiresAt',
+];
+class ListConversationSessionsQueryDto {
+    page;
+    limit;
+    patientId;
+    filters;
+}
+exports.ListConversationSessionsQueryDto = ListConversationSessionsQueryDto;
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ minimum: 1, default: 1 }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], ListConversationSessionsQueryDto.prototype, "page", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ minimum: 1, maximum: 100, default: 20 }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], ListConversationSessionsQueryDto.prototype, "limit", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ format: 'uuid', description: 'Filtrar sessões deste paciente' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsUUID)('4'),
+    __metadata("design:type", String)
+], ListConversationSessionsQueryDto.prototype, "patientId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'JSON string with an array of filter objects `{ key, op, value }`. ' +
+            'Example: `[{"key":"conversationType","op":"==","value":"ia"}]`. ' +
+            'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`).',
+        type: String,
+        example: '[{"key":"intention","op":"==","value":"confirm_appointment"}]',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Array)
+], ListConversationSessionsQueryDto.prototype, "filters", void 0);

package/dist/payment-gateway/list-gateway-payments-query.dto.d.ts

@@ -5,6 +5,7 @@ import { PaymentGatewayDto, GatewayPaymentMethodDto, GatewayPaymentStatusDto } f
 export declare class ListGatewayPaymentsQueryDto {
     tenantId?: string;
     billingId?: string;
+    billingIds?: string[];
     gateway?: PaymentGatewayDto;
     method?: GatewayPaymentMethodDto;
     status?: GatewayPaymentStatusDto;

package/dist/payment-gateway/list-gateway-payments-query.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-gateway-payments-query.dto.d.ts","sourceRoot":"","sources":["../../src/payment-gateway/list-gateway-payments-query.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,iBAAiB,EAEjB,uBAAuB,EAEvB,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AAEjC;;GAEG;AACH,qBAAa,2BAA2B;IAItC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAKlB,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAK5B,MAAM,CAAC,EAAE,uBAAuB,CAAC;IAKjC,MAAM,CAAC,EAAE,uBAAuB,CAAC;IAMjC,IAAI,CAAC,EAAE,MAAM,CAAC;IAOd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"list-gateway-payments-query.dto.d.ts","sourceRoot":"","sources":["../../src/payment-gateway/list-gateway-payments-query.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,iBAAiB,EAEjB,uBAAuB,EAEvB,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AAEjC;;GAEG;AACH,qBAAa,2BAA2B;IAItC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAKlB,SAAS,CAAC,EAAE,MAAM,CAAC;IAUnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAKtB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAK5B,MAAM,CAAC,EAAE,uBAAuB,CAAC;IAKjC,MAAM,CAAC,EAAE,uBAAuB,CAAC;IAMjC,IAAI,CAAC,EAAE,MAAM,CAAC;IAOd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/payment-gateway/list-gateway-payments-query.dto.js

@@ -19,6 +19,7 @@ const payment_gateway_enums_1 = require("./payment-gateway.enums");
 class ListGatewayPaymentsQueryDto {
     tenantId;
     billingId;
+    billingIds;
     gateway;
     method;
     status;
@@ -38,6 +39,17 @@ __decorate([
     (0, class_validator_1.IsUUID)('4'),
     __metadata("design:type", String)
 ], ListGatewayPaymentsQueryDto.prototype, "billingId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Filtra por várias faturas (UUID). Ignorado se `billingId` estiver definido.',
+        type: [String],
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(200),
+    (0, class_validator_1.IsUUID)('4', { each: true }),
+    __metadata("design:type", Array)
+], ListGatewayPaymentsQueryDto.prototype, "billingIds", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({ description: 'Gateway filter', enum: payment_gateway_enums_1.PAYMENT_GATEWAYS }),
     (0, class_validator_1.IsOptional)(),
@@ -64,10 +76,10 @@ __decorate([
     __metadata("design:type", Number)
 ], ListGatewayPaymentsQueryDto.prototype, "page", void 0);
 __decorate([
-    (0, swagger_1.ApiPropertyOptional)({ description: 'Records per page', example: 20, minimum: 1, maximum: 100, default: 20 }),
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Records per page', example: 20, minimum: 1, maximum: 500, default: 20 }),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsInt)(),
     (0, class_validator_1.Min)(1),
-    (0, class_validator_1.Max)(100),
+    (0, class_validator_1.Max)(500),
     __metadata("design:type", Number)
 ], ListGatewayPaymentsQueryDto.prototype, "limit", void 0);

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

@@ -1,5 +1,9 @@
+import type { ParsedFilterDto } from '../filters/parsed-filter.dto';
+export declare const PROCEDURE_LIST_FILTER_KEYS: readonly ["id", "name", "category", "description", "blockTime", "defaultValue", "returnDays", "value", "duration", "sideEffects", "specialtyId", "createdAt", "updatedAt", "deletedAt"];
+export type ProcedureListFilterKeyDto = (typeof PROCEDURE_LIST_FILTER_KEYS)[number];
 export declare class ListProceduresQueryDto {
     page?: number;
     limit?: number;
+    filters?: ParsedFilterDto[];
 }
 //# sourceMappingURL=list-procedures-query.dto.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"list-procedures-query.dto.d.ts","sourceRoot":"","sources":["../../src/procedures/list-procedures-query.dto.ts"],"names":[],"mappings":"AAGA,qBAAa,sBAAsB;IAUjC,IAAI,CAAC,EAAE,MAAM,CAAC;IAad,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"list-procedures-query.dto.d.ts","sourceRoot":"","sources":["../../src/procedures/list-procedures-query.dto.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,0BAA0B,yLAe7B,CAAC;AACX,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpF,qBAAa,sBAAsB;IAUjC,IAAI,CAAC,EAAE,MAAM,CAAC;IAad,KAAK,CAAC,EAAE,MAAM,CAAC;IAYf,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;CAC7B"}

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

@@ -9,12 +9,29 @@ 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.ListProceduresQueryDto = void 0;
+exports.ListProceduresQueryDto = exports.PROCEDURE_LIST_FILTER_KEYS = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
+exports.PROCEDURE_LIST_FILTER_KEYS = [
+    'id',
+    'name',
+    'category',
+    'description',
+    'blockTime',
+    'defaultValue',
+    'returnDays',
+    'value',
+    'duration',
+    'sideEffects',
+    'specialtyId',
+    'createdAt',
+    'updatedAt',
+    'deletedAt',
+];
 class ListProceduresQueryDto {
     page;
     limit;
+    filters;
 }
 exports.ListProceduresQueryDto = ListProceduresQueryDto;
 __decorate([
@@ -43,3 +60,15 @@ __decorate([
     (0, class_validator_1.Max)(100),
     __metadata("design:type", Number)
 ], ListProceduresQueryDto.prototype, "limit", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'JSON string with an array of filter objects `{ key, op, value }`. ' +
+            'Example: `[{"key":"specialtyId","op":"==","value":"550e8400-e29b-41d4-a716-446655440000"}]`. ' +
+            'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`). ' +
+            'Use key `sideEffects` for the `side_effects` column.',
+        type: String,
+        example: '[{"key":"name","op":"==","value":"Consulta"}]',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Array)
+], ListProceduresQueryDto.prototype, "filters", void 0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tychat-contracts",
-  "version": "1.0.112",
+  "version": "1.0.115",
   "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

@@ -1,8 +1,29 @@
 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',
@@ -116,6 +137,17 @@ export class ListAppointmentsQueryDto {
   @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`).',
+    type: String,
+    example: '[{"key":"status","op":"==","value":"pending"}]',
+  })
+  @IsOptional()
+  filters?: ParsedFilterDto[];
 }
 
 export interface AppointmentListResult {

package/src/billing/billing-detail-response.dto.ts

@@ -0,0 +1,17 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import { BillingLinkedPaymentDto } from './billing-linked-payment.dto';
+import { BillingResponseDto } from './billing-response.dto';
+
+/**
+ * Resposta de GET /billings/{id}: fatura + histórico de pagamentos no gateway.
+ */
+export class BillingDetailResponseDto extends BillingResponseDto {
+  @ApiProperty({
+    type: [BillingLinkedPaymentDto],
+    description:
+      'Todos os registros de pagamento no gateway para esta fatura (qualquer status), mais recentes primeiro.',
+  })
+  @Type(() => BillingLinkedPaymentDto)
+  payments!: BillingLinkedPaymentDto[];
+}

package/src/billing/billing-linked-payment.dto.ts

@@ -0,0 +1,37 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+
+/**
+ * Resumo de um pagamento no gateway vinculado a uma fatura (listagem).
+ * Sem `metadata` para evitar payload grande (PIX QR, etc.).
+ */
+export class BillingLinkedPaymentDto {
+  @ApiProperty({ description: 'ID do pagamento no gateway (UUID)' })
+  id: string;
+
+  @ApiProperty({ description: 'ID da fatura (UUID)' })
+  billingId: string;
+
+  @ApiProperty({ description: 'Valor cobrado' })
+  amount: number;
+
+  @ApiProperty({ description: 'PSP (ASAAS, MERCADO_PAGO, STRIPE)' })
+  gateway: string;
+
+  @ApiProperty({ description: 'Meio (PIX, CREDIT_CARD, …)' })
+  method: string;
+
+  @ApiProperty({ description: 'Status no gateway' })
+  status: string;
+
+  @ApiPropertyOptional({ description: 'ID externo no PSP' })
+  externalId?: string | null;
+
+  @ApiPropertyOptional({ description: 'Data de confirmação/pagamento (ISO 8601)' })
+  paidAt?: string | null;
+
+  @ApiProperty({ description: 'Criação (ISO 8601)' })
+  createdAt: string;
+
+  @ApiProperty({ description: 'Atualização (ISO 8601)' })
+  updatedAt: string;
+}

package/src/billing/index.ts

@@ -1,4 +1,6 @@
 export * from './create-billing.dto';
 export * from './update-billing.dto';
 export * from './list-billings-query.dto';
+export * from './billing-linked-payment.dto';
 export * from './billing-response.dto';
+export * from './billing-detail-response.dto';

package/src/conversations/followup-log-list-query.dto.ts

@@ -8,12 +8,26 @@ import {
   Max,
   Min,
 } from 'class-validator';
+import type { ParsedFilterDto } from '../filters/parsed-filter.dto';
 import {
   CONVERSATION_INTENTIONS,
   ConversationIntentionDto,
 } from './conversation-intention.dto';
 import { FOLLOWUP_TYPES, FollowupTypeDto } from './followup-type.dto';
 
+export const FOLLOWUP_LOG_LIST_FILTER_KEYS = [
+  'id',
+  'sessionUuid',
+  'patientId',
+  'attempt',
+  'message',
+  'intention',
+  'followupType',
+  'appointmentId',
+  'sentAt',
+] as const;
+export type FollowupLogListFilterKeyDto = (typeof FOLLOWUP_LOG_LIST_FILTER_KEYS)[number];
+
 /**
  * Query parameters for listing follow-up logs (HTTP query + Kafka payload).
  */
@@ -58,4 +72,15 @@ export class FollowupLogListQueryDto {
   @IsOptional()
   @IsIn([...FOLLOWUP_TYPES])
   followupType?: FollowupTypeDto;
+
+  @ApiPropertyOptional({
+    description:
+      'JSON string with an array of filter objects `{ key, op, value }`. ' +
+      'Example: `[{"key":"followupType","op":"==","value":"abandonment"}]`. ' +
+      'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`).',
+    type: String,
+    example: '[{"key":"followupType","op":"==","value":"abandonment"}]',
+  })
+  @IsOptional()
+  filters?: ParsedFilterDto[];
 }

package/src/conversations/index.ts

@@ -3,6 +3,7 @@ export * from './conversation-intention.dto';
 export * from './list-conversation-contacts-filters.dto';
 export * from './conversation-contact-filters-query.validator';
 export * from './list-conversation-contacts-query.dto';
+export * from './list-conversation-sessions-query.dto';
 export * from './create-conversation-session.dto';
 export * from './conversation-session-response.dto';
 export * from './create-conversation.dto';

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

@@ -0,0 +1,56 @@
+import { ApiPropertyOptional } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import { IsInt, IsOptional, IsUUID, Max, Min } from 'class-validator';
+import type { ParsedFilterDto } from '../filters/parsed-filter.dto';
+
+/**
+ * Allowed `conversation_sessions` columns for structured filters (camelCase).
+ * Same whitelist as contact list session filters.
+ */
+export const CONVERSATION_SESSION_LIST_FILTER_KEYS = [
+  'id',
+  'sessionUuid',
+  'patientId',
+  'unitId',
+  'tenantEvogoInstanceId',
+  'conversationType',
+  'intention',
+  'unreadCount',
+  'startedAt',
+  'expiresAt',
+] as const;
+export type ConversationSessionListFilterKeyDto =
+  (typeof CONVERSATION_SESSION_LIST_FILTER_KEYS)[number];
+
+export class ListConversationSessionsQueryDto {
+  @ApiPropertyOptional({ minimum: 1, default: 1 })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  page?: number;
+
+  @ApiPropertyOptional({ minimum: 1, maximum: 100, default: 20 })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  @Max(100)
+  limit?: number;
+
+  @ApiPropertyOptional({ format: 'uuid', description: 'Filtrar sessões deste paciente' })
+  @IsOptional()
+  @IsUUID('4')
+  patientId?: string;
+
+  @ApiPropertyOptional({
+    description:
+      'JSON string with an array of filter objects `{ key, op, value }`. ' +
+      'Example: `[{"key":"conversationType","op":"==","value":"ia"}]`. ' +
+      'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`).',
+    type: String,
+    example: '[{"key":"intention","op":"==","value":"confirm_appointment"}]',
+  })
+  @IsOptional()
+  filters?: ParsedFilterDto[];
+}

package/src/payment-gateway/list-gateway-payments-query.dto.ts

@@ -1,5 +1,5 @@
 import { ApiPropertyOptional } from '@nestjs/swagger';
-import { IsEnum, IsInt, IsOptional, IsUUID, Max, Min } from 'class-validator';
+import { ArrayMaxSize, IsArray, IsEnum, IsInt, IsOptional, IsUUID, Max, Min } from 'class-validator';
 import {
   PAYMENT_GATEWAYS,
   PaymentGatewayDto,
@@ -23,6 +23,16 @@ export class ListGatewayPaymentsQueryDto {
   @IsUUID('4')
   billingId?: string;
 
+  @ApiPropertyOptional({
+    description: 'Filtra por várias faturas (UUID). Ignorado se `billingId` estiver definido.',
+    type: [String],
+  })
+  @IsOptional()
+  @IsArray()
+  @ArrayMaxSize(200)
+  @IsUUID('4', { each: true })
+  billingIds?: string[];
+
   @ApiPropertyOptional({ description: 'Gateway filter', enum: PAYMENT_GATEWAYS })
   @IsOptional()
   @IsEnum(PAYMENT_GATEWAYS)
@@ -44,10 +54,10 @@ export class ListGatewayPaymentsQueryDto {
   @Min(1)
   page?: number;
 
-  @ApiPropertyOptional({ description: 'Records per page', example: 20, minimum: 1, maximum: 100, default: 20 })
+  @ApiPropertyOptional({ description: 'Records per page', example: 20, minimum: 1, maximum: 500, default: 20 })
   @IsOptional()
   @IsInt()
   @Min(1)
-  @Max(100)
+  @Max(500)
   limit?: number;
 }

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

@@ -1,5 +1,24 @@
 import { ApiPropertyOptional } from '@nestjs/swagger';
 import { IsInt, IsOptional, Max, Min } from 'class-validator';
+import type { ParsedFilterDto } from '../filters/parsed-filter.dto';
+
+export const PROCEDURE_LIST_FILTER_KEYS = [
+  'id',
+  'name',
+  'category',
+  'description',
+  'blockTime',
+  'defaultValue',
+  'returnDays',
+  'value',
+  'duration',
+  'sideEffects',
+  'specialtyId',
+  'createdAt',
+  'updatedAt',
+  'deletedAt',
+] as const;
+export type ProcedureListFilterKeyDto = (typeof PROCEDURE_LIST_FILTER_KEYS)[number];
 
 export class ListProceduresQueryDto {
   @ApiPropertyOptional({
@@ -25,4 +44,16 @@ export class ListProceduresQueryDto {
   @Min(1)
   @Max(100)
   limit?: number;
+
+  @ApiPropertyOptional({
+    description:
+      'JSON string with an array of filter objects `{ key, op, value }`. ' +
+      'Example: `[{"key":"specialtyId","op":"==","value":"550e8400-e29b-41d4-a716-446655440000"}]`. ' +
+      'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`). ' +
+      'Use key `sideEffects` for the `side_effects` column.',
+    type: String,
+    example: '[{"key":"name","op":"==","value":"Consulta"}]',
+  })
+  @IsOptional()
+  filters?: ParsedFilterDto[];
 }