tychat-contracts 1.0.113 → 1.0.118

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

@@ -168,7 +168,7 @@ __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`).',
+            'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`), like, unlike (string pattern).',
         type: String,
         example: '[{"key":"status","op":"==","value":"pending"}]',
     }),

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/billing/list-billings-query.dto.d.ts

@@ -1,11 +1,9 @@
 import { BillingStatusDto } from './create-billing.dto';
-import { type GatewayPaymentMethodDto, type PaymentGatewayDto } from '../payment-gateway/payment-gateway.enums';
+import { type GatewayPaymentMethodDto } from '../payment-gateway/payment-gateway.enums';
 export declare class ListBillingsQueryDto {
     tenantId?: string;
     status?: BillingStatusDto;
-    paymentId?: string;
     method?: GatewayPaymentMethodDto;
-    gateway?: PaymentGatewayDto;
     page?: number;
     limit?: number;
 }

package/dist/billing/list-billings-query.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-billings-query.dto.d.ts","sourceRoot":"","sources":["../../src/billing/list-billings-query.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,uBAAuB,EAE5B,KAAK,iBAAiB,EACvB,MAAM,0CAA0C,CAAC;AAElD,qBAAa,oBAAoB;IAO/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IASlB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAQ1B,SAAS,CAAC,EAAE,MAAM,CAAC;IAQnB,MAAM,CAAC,EAAE,uBAAuB,CAAC;IAQjC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAW5B,IAAI,CAAC,EAAE,MAAM,CAAC;IAad,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"list-billings-query.dto.d.ts","sourceRoot":"","sources":["../../src/billing/list-billings-query.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,0CAA0C,CAAC;AAElD,qBAAa,oBAAoB;IAO/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IASlB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAQ1B,MAAM,CAAC,EAAE,uBAAuB,CAAC;IAWjC,IAAI,CAAC,EAAE,MAAM,CAAC;IAad,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/billing/list-billings-query.dto.js

@@ -17,9 +17,7 @@ const payment_gateway_enums_1 = require("../payment-gateway/payment-gateway.enum
 class ListBillingsQueryDto {
     tenantId;
     status;
-    paymentId;
     method;
-    gateway;
     page;
     limit;
 }
@@ -43,15 +41,6 @@ __decorate([
     (0, class_validator_1.IsEnum)(create_billing_dto_1.BILLING_STATUSES),
     __metadata("design:type", String)
 ], ListBillingsQueryDto.prototype, "status", void 0);
-__decorate([
-    (0, swagger_1.ApiPropertyOptional)({
-        description: 'Payment ID filter (UUID)',
-        example: '550e8400-e29b-41d4-a716-446655440002',
-    }),
-    (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsUUID)('4'),
-    __metadata("design:type", String)
-], ListBillingsQueryDto.prototype, "paymentId", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
         description: 'Filtro por método de pagamento associado à cobrança',
@@ -61,15 +50,6 @@ __decorate([
     (0, class_validator_1.IsEnum)(payment_gateway_enums_1.GATEWAY_PAYMENT_METHODS),
     __metadata("design:type", String)
 ], ListBillingsQueryDto.prototype, "method", void 0);
-__decorate([
-    (0, swagger_1.ApiPropertyOptional)({
-        description: 'Filtro por gateway de pagamento',
-        enum: payment_gateway_enums_1.PAYMENT_GATEWAYS,
-    }),
-    (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsEnum)(payment_gateway_enums_1.PAYMENT_GATEWAYS),
-    __metadata("design:type", String)
-], ListBillingsQueryDto.prototype, "gateway", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
         description: 'Page number (starting at 1)',

package/dist/conversations/conversation-contact-filters-query.validator.spec.js

@@ -140,7 +140,7 @@ describe('ConversationContactFiltersQueryConstraint', () => {
     });
     it('should reject a filter with invalid operator', async () => {
         const raw = {
-            filters: '{"key":"intention","op":"like","value":"x"}',
+            filters: '{"key":"intention","op":"contains","value":"x"}',
         };
         const dto = simulateValidationPipe(raw);
         const errors = await (0, class_validator_1.validate)(dto, {

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

@@ -90,7 +90,7 @@ __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`).',
+            'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`), like, unlike (string pattern).',
         type: String,
         example: '[{"key":"followupType","op":"==","value":"abandonment"}]',
     }),

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

@@ -64,7 +64,7 @@ __decorate([
     (0, swagger_1.ApiPropertyOptional)({
         description: 'JSON string with an array of filter objects `{ key, op, value }`. ' +
             'Example: `[{"key":"intention","op":"==","value":"clinic_info"}]`. ' +
-            'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`).',
+            'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`), like, unlike (value must be string pattern for SQL LIKE).',
         type: String,
         example: '[{"key":"intention","op":"==","value":"clinic_info"}]',
     }),

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

@@ -63,7 +63,7 @@ __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`).',
+            'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`), like, unlike (string pattern).',
         type: String,
         example: '[{"key":"intention","op":"==","value":"confirm_appointment"}]',
     }),

package/dist/filters/parsed-filter.dto.d.ts

@@ -8,8 +8,10 @@
  * - `>=`  : Greater than or equal
  * - `<=`  : Less than or equal
  * - `in`  : Value is one of the elements in the array
+ * - `like`   : SQL `LIKE` (value must be a string pattern, e.g. `%foo%`)
+ * - `unlike` : SQL `NOT LIKE` (value must be a string pattern)
  */
-export declare const VALID_FILTER_OPS: readonly ["==", "!=", ">", "<", ">=", "<=", "in"];
+export declare const VALID_FILTER_OPS: readonly ["==", "!=", ">", "<", ">=", "<=", "in", "like", "unlike"];
 export type FilterOp = (typeof VALID_FILTER_OPS)[number];
 /**
  * Generic parsed filter object.
@@ -23,7 +25,7 @@ export interface ParsedFilterDto {
     key: string;
     /** Comparison operator. */
     op: FilterOp;
-    /** Scalar value (string | number) or, for `in`, an array of string | number. */
+    /** Scalar value (string | number), array for `in`, or string pattern for `like` / `unlike`. */
     value: string | number | (string | number)[];
 }
 //# sourceMappingURL=parsed-filter.dto.d.ts.map

package/dist/filters/parsed-filter.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parsed-filter.dto.d.ts","sourceRoot":"","sources":["../../src/filters/parsed-filter.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,mDAQnB,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,qFAAqF;IACrF,GAAG,EAAE,MAAM,CAAC;IACZ,2BAA2B;IAC3B,EAAE,EAAE,QAAQ,CAAC;IACb,gFAAgF;IAChF,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CAC9C"}
+{"version":3,"file":"parsed-filter.dto.d.ts","sourceRoot":"","sources":["../../src/filters/parsed-filter.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,qEAUnB,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,qFAAqF;IACrF,GAAG,EAAE,MAAM,CAAC;IACZ,2BAA2B;IAC3B,EAAE,EAAE,QAAQ,CAAC;IACb,+FAA+F;IAC/F,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CAC9C"}

package/dist/filters/parsed-filter.dto.js

@@ -11,6 +11,8 @@ exports.VALID_FILTER_OPS = void 0;
  * - `>=`  : Greater than or equal
  * - `<=`  : Less than or equal
  * - `in`  : Value is one of the elements in the array
+ * - `like`   : SQL `LIKE` (value must be a string pattern, e.g. `%foo%`)
+ * - `unlike` : SQL `NOT LIKE` (value must be a string pattern)
  */
 exports.VALID_FILTER_OPS = [
     '==',
@@ -20,4 +22,6 @@ exports.VALID_FILTER_OPS = [
     '>=',
     '<=',
     'in',
+    'like',
+    'unlike',
 ];

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

@@ -67,7 +67,7 @@ __decorate([
     (0, swagger_1.ApiPropertyOptional)({
         description: 'JSON string with an array of filter objects `{ key, op, value }`. ' +
             'Example: `[{"key":"cpf","op":"==","value":"12211117411"}]`. ' +
-            'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`).',
+            'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`), like, unlike (string pattern).',
         type: String,
         example: '[{"key":"cpf","op":"==","value":"12211117411"}]',
     }),

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.js

@@ -64,7 +64,7 @@ __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`). ' +
+            'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`), like, unlike (string pattern). ' +
             'Use key `sideEffects` for the `side_effects` column.',
         type: String,
         example: '[{"key":"name","op":"==","value":"Consulta"}]',

package/package.json

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

@@ -142,7 +142,7 @@ export class ListAppointmentsQueryDto {
     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`).',
+      'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`), like, unlike (string pattern).',
     type: String,
     example: '[{"key":"status","op":"==","value":"pending"}]',
   })

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/billing/list-billings-query.dto.ts

@@ -7,8 +7,6 @@ import {
 import {
   GATEWAY_PAYMENT_METHODS,
   type GatewayPaymentMethodDto,
-  PAYMENT_GATEWAYS,
-  type PaymentGatewayDto,
 } from '../payment-gateway/payment-gateway.enums';
 
 export class ListBillingsQueryDto {
@@ -29,14 +27,6 @@ export class ListBillingsQueryDto {
   @IsEnum(BILLING_STATUSES)
   status?: BillingStatusDto;
 
-  @ApiPropertyOptional({
-    description: 'Payment ID filter (UUID)',
-    example: '550e8400-e29b-41d4-a716-446655440002',
-  })
-  @IsOptional()
-  @IsUUID('4')
-  paymentId?: string;
-
   @ApiPropertyOptional({
     description: 'Filtro por método de pagamento associado à cobrança',
     enum: GATEWAY_PAYMENT_METHODS,
@@ -45,14 +35,6 @@ export class ListBillingsQueryDto {
   @IsEnum(GATEWAY_PAYMENT_METHODS)
   method?: GatewayPaymentMethodDto;
 
-  @ApiPropertyOptional({
-    description: 'Filtro por gateway de pagamento',
-    enum: PAYMENT_GATEWAYS,
-  })
-  @IsOptional()
-  @IsEnum(PAYMENT_GATEWAYS)
-  gateway?: PaymentGatewayDto;
-
   @ApiPropertyOptional({
     description: 'Page number (starting at 1)',
     example: 1,

package/src/conversations/conversation-contact-filters-query.validator.spec.ts

@@ -153,7 +153,7 @@ describe('ConversationContactFiltersQueryConstraint', () => {
 
   it('should reject a filter with invalid operator', async () => {
     const raw = {
-      filters: '{"key":"intention","op":"like","value":"x"}',
+      filters: '{"key":"intention","op":"contains","value":"x"}',
     };
     const dto = simulateValidationPipe(raw);
     const errors = await validate(dto, {

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

@@ -77,7 +77,7 @@ export class FollowupLogListQueryDto {
     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`).',
+      'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`), like, unlike (string pattern).',
     type: String,
     example: '[{"key":"followupType","op":"==","value":"abandonment"}]',
   })

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

@@ -50,7 +50,7 @@ export class ListConversationContactsQueryDto {
     description:
       'JSON string with an array of filter objects `{ key, op, value }`. ' +
       'Example: `[{"key":"intention","op":"==","value":"clinic_info"}]`. ' +
-      'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`).',
+      'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`), like, unlike (value must be string pattern for SQL LIKE).',
     type: String,
     example: '[{"key":"intention","op":"==","value":"clinic_info"}]',
   })

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

@@ -47,7 +47,7 @@ export class ListConversationSessionsQueryDto {
     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`).',
+      'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`), like, unlike (string pattern).',
     type: String,
     example: '[{"key":"intention","op":"==","value":"confirm_appointment"}]',
   })

package/src/filters/parsed-filter.dto.ts

@@ -8,6 +8,8 @@
  * - `>=`  : Greater than or equal
  * - `<=`  : Less than or equal
  * - `in`  : Value is one of the elements in the array
+ * - `like`   : SQL `LIKE` (value must be a string pattern, e.g. `%foo%`)
+ * - `unlike` : SQL `NOT LIKE` (value must be a string pattern)
  */
 export const VALID_FILTER_OPS = [
   '==',
@@ -17,6 +19,8 @@ export const VALID_FILTER_OPS = [
   '>=',
   '<=',
   'in',
+  'like',
+  'unlike',
 ] as const;
 export type FilterOp = (typeof VALID_FILTER_OPS)[number];
 
@@ -32,6 +36,6 @@ export interface ParsedFilterDto {
   key: string;
   /** Comparison operator. */
   op: FilterOp;
-  /** Scalar value (string | number) or, for `in`, an array of string | number. */
+  /** Scalar value (string | number), array for `in`, or string pattern for `like` / `unlike`. */
   value: string | number | (string | number)[];
 }

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

@@ -52,7 +52,7 @@ export class ListPatientsQueryDto {
     description:
       'JSON string with an array of filter objects `{ key, op, value }`. ' +
       'Example: `[{"key":"cpf","op":"==","value":"12211117411"}]`. ' +
-      'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`).',
+      'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`), like, unlike (string pattern).',
     type: String,
     example: '[{"key":"cpf","op":"==","value":"12211117411"}]',
   })

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

@@ -49,7 +49,7 @@ export class ListProceduresQueryDto {
     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`). ' +
+      'Ops: ==, !=, >, <, >=, <=, in (value must be array for `in`), like, unlike (string pattern). ' +
       'Use key `sideEffects` for the `side_effects` column.',
     type: String,
     example: '[{"key":"name","op":"==","value":"Consulta"}]',