tychat-contracts 1.0.86 → 1.0.88

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

@@ -1,8 +1,11 @@
 import { BillingStatusDto } from './create-billing.dto';
+import { type GatewayPaymentMethodDto, type PaymentGatewayDto } 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;AAE9B,qBAAa,oBAAoB;IAO/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IASlB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAQ1B,SAAS,CAAC,EAAE,MAAM,CAAC;IAWnB,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,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"}

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

@@ -13,10 +13,13 @@ exports.ListBillingsQueryDto = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
 const create_billing_dto_1 = require("./create-billing.dto");
+const payment_gateway_enums_1 = require("../payment-gateway/payment-gateway.enums");
 class ListBillingsQueryDto {
     tenantId;
     status;
     paymentId;
+    method;
+    gateway;
     page;
     limit;
 }
@@ -49,6 +52,24 @@ __decorate([
     (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',
+        enum: payment_gateway_enums_1.GATEWAY_PAYMENT_METHODS,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (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/cashback/cashback-kafka-payloads.d.ts

@@ -32,6 +32,12 @@ export interface UseReferralCodePayload {
     checkoutId: string;
     checkoutAmount: number;
 }
+/** Vínculo de código no cadastro do paciente (sem checkout). */
+export interface LinkReferralAtRegistrationPayload {
+    tenant: string;
+    code: string;
+    referredPatientId: string;
+}
 export interface GetReferralByPatientPayload {
     tenant: string;
     patientId: string;

package/dist/cashback/cashback-kafka-payloads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cashback-kafka-payloads.d.ts","sourceRoot":"","sources":["../../src/cashback/cashback-kafka-payloads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAItF,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,yBAAyB,CAAC;IAC3C,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAID,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB;AAID,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"cashback-kafka-payloads.d.ts","sourceRoot":"","sources":["../../src/cashback/cashback-kafka-payloads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAItF,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,yBAAyB,CAAC;IAC3C,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAID,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,gEAAgE;AAChE,MAAM,WAAW,iCAAiC;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB;AAID,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/payment-gateway/create-gateway-payment.dto.d.ts

@@ -15,7 +15,7 @@ export declare class CreateGatewayPaymentDto {
     tenantId: string;
     billingId: string;
     amount: number;
-    gateway: PaymentGatewayDto;
+    gateway?: PaymentGatewayDto;
     method: GatewayPaymentMethodDto;
     dueDate: string;
     description?: string;

package/dist/payment-gateway/create-gateway-payment.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-gateway-payment.dto.d.ts","sourceRoot":"","sources":["../../src/payment-gateway/create-gateway-payment.dto.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,iBAAiB,EAEjB,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AAEjC;;GAEG;AACH,qBAAa,kBAAkB;IAI7B,IAAI,EAAE,MAAM,CAAC;IAKb,KAAK,EAAE,MAAM,CAAC;IAKd,OAAO,CAAC,EAAE,MAAM,CAAC;IAKjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,uBAAuB;IAOlC,QAAQ,EAAE,MAAM,CAAC;IAQjB,SAAS,EAAE,MAAM,CAAC;IASlB,MAAM,EAAE,MAAM,CAAC;IASf,OAAO,EAAE,iBAAiB,CAAC;IAS3B,MAAM,EAAE,uBAAuB,CAAC;IAOhC,OAAO,EAAE,MAAM,CAAC;IAQhB,WAAW,CAAC,EAAE,MAAM,CAAC;IAQrB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAO9B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}
+{"version":3,"file":"create-gateway-payment.dto.d.ts","sourceRoot":"","sources":["../../src/payment-gateway/create-gateway-payment.dto.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,iBAAiB,EAEjB,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AAEjC;;GAEG;AACH,qBAAa,kBAAkB;IAI7B,IAAI,EAAE,MAAM,CAAC;IAKb,KAAK,EAAE,MAAM,CAAC;IAKd,OAAO,CAAC,EAAE,MAAM,CAAC;IAKjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,uBAAuB;IAOlC,QAAQ,EAAE,MAAM,CAAC;IAQjB,SAAS,EAAE,MAAM,CAAC;IASlB,MAAM,EAAE,MAAM,CAAC;IAUf,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAS5B,MAAM,EAAE,uBAAuB,CAAC;IAOhC,OAAO,EAAE,MAAM,CAAC;IAQhB,WAAW,CAAC,EAAE,MAAM,CAAC;IAQrB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAO9B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/payment-gateway/create-gateway-payment.dto.js

@@ -92,13 +92,13 @@ __decorate([
     __metadata("design:type", Number)
 ], CreateGatewayPaymentDto.prototype, "amount", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({
-        description: 'Payment gateway to use',
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Gateway explícito. Se omitido, o payment-gateway-service resolve pela rota global (prioridade + métodos).',
         enum: payment_gateway_enums_1.PAYMENT_GATEWAYS,
         example: 'ASAAS',
     }),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsEnum)(payment_gateway_enums_1.PAYMENT_GATEWAYS),
-    (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], CreateGatewayPaymentDto.prototype, "gateway", void 0);
 __decorate([

package/dist/payment-gateway/index.d.ts

@@ -1,4 +1,9 @@
 export * from './payment-gateway.enums';
+export * from './payment-gateway-routing-matrix';
+export * from './payment-gateway-routing.dto';
+export * from './initiate-billing-payment-response.dto';
+export * from './initiate-billing-payment.mapper';
+export * from './platform-configuration.topics';
 export * from './create-gateway-payment.dto';
 export * from './update-gateway-payment.dto';
 export * from './gateway-payment-response.dto';

package/dist/payment-gateway/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/payment-gateway/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/payment-gateway/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yCAAyC,CAAC;AACxD,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC"}

package/dist/payment-gateway/index.js

@@ -15,6 +15,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./payment-gateway.enums"), exports);
+__exportStar(require("./payment-gateway-routing-matrix"), exports);
+__exportStar(require("./payment-gateway-routing.dto"), exports);
+__exportStar(require("./initiate-billing-payment-response.dto"), exports);
+__exportStar(require("./initiate-billing-payment.mapper"), exports);
+__exportStar(require("./platform-configuration.topics"), exports);
 __exportStar(require("./create-gateway-payment.dto"), exports);
 __exportStar(require("./update-gateway-payment.dto"), exports);
 __exportStar(require("./gateway-payment-response.dto"), exports);

package/dist/payment-gateway/initiate-billing-payment-response.dto.d.ts

@@ -0,0 +1,13 @@
+import { GatewayPaymentResponseDto } from './gateway-payment-response.dto';
+/**
+ * Resposta de iniciar pagamento de cobrança: inclui o registro do pagamento e
+ * campos explícitos copiados de metadata quando presentes (PIX, checkout, boleto).
+ */
+export declare class InitiateBillingPaymentResponseDto extends GatewayPaymentResponseDto {
+    checkoutUrl?: string | null;
+    pixQrCode?: string | null;
+    pixCopyPaste?: string | null;
+    boletoUrl?: string | null;
+    boletoBarcode?: string | null;
+}
+//# sourceMappingURL=initiate-billing-payment-response.dto.d.ts.map

package/dist/payment-gateway/initiate-billing-payment-response.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initiate-billing-payment-response.dto.d.ts","sourceRoot":"","sources":["../../src/payment-gateway/initiate-billing-payment-response.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E;;;GAGG;AACH,qBAAa,iCAAkC,SAAQ,yBAAyB;IAI9E,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAG5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAG1B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAG7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAG1B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B"}

package/dist/payment-gateway/initiate-billing-payment-response.dto.js

@@ -0,0 +1,48 @@
+"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.InitiateBillingPaymentResponseDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const gateway_payment_response_dto_1 = require("./gateway-payment-response.dto");
+/**
+ * Resposta de iniciar pagamento de cobrança: inclui o registro do pagamento e
+ * campos explícitos copiados de metadata quando presentes (PIX, checkout, boleto).
+ */
+class InitiateBillingPaymentResponseDto extends gateway_payment_response_dto_1.GatewayPaymentResponseDto {
+    checkoutUrl;
+    pixQrCode;
+    pixCopyPaste;
+    boletoUrl;
+    boletoBarcode;
+}
+exports.InitiateBillingPaymentResponseDto = InitiateBillingPaymentResponseDto;
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'URL para fluxo de pagamento (cartão, checkout hospedado, etc.)',
+    }),
+    __metadata("design:type", Object)
+], InitiateBillingPaymentResponseDto.prototype, "checkoutUrl", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'QR Code PIX em base64 quando aplicável' }),
+    __metadata("design:type", Object)
+], InitiateBillingPaymentResponseDto.prototype, "pixQrCode", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'PIX copia e cola quando aplicável' }),
+    __metadata("design:type", Object)
+], InitiateBillingPaymentResponseDto.prototype, "pixCopyPaste", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'URL do boleto quando aplicável' }),
+    __metadata("design:type", Object)
+], InitiateBillingPaymentResponseDto.prototype, "boletoUrl", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Código de barras do boleto quando aplicável' }),
+    __metadata("design:type", Object)
+], InitiateBillingPaymentResponseDto.prototype, "boletoBarcode", void 0);

package/dist/payment-gateway/initiate-billing-payment.mapper.d.ts

@@ -0,0 +1,7 @@
+import type { GatewayPaymentResponseDto } from './gateway-payment-response.dto';
+import { InitiateBillingPaymentResponseDto } from './initiate-billing-payment-response.dto';
+/**
+ * Copia campos conhecidos de `metadata` para a resposta explícita de checkout/PIX/boleto.
+ */
+export declare function toInitiateBillingPaymentResponseDto(payment: GatewayPaymentResponseDto): InitiateBillingPaymentResponseDto;
+//# sourceMappingURL=initiate-billing-payment.mapper.d.ts.map

package/dist/payment-gateway/initiate-billing-payment.mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initiate-billing-payment.mapper.d.ts","sourceRoot":"","sources":["../../src/payment-gateway/initiate-billing-payment.mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EAAE,iCAAiC,EAAE,MAAM,yCAAyC,CAAC;AAE5F;;GAEG;AACH,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,yBAAyB,GACjC,iCAAiC,CAUnC"}

package/dist/payment-gateway/initiate-billing-payment.mapper.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toInitiateBillingPaymentResponseDto = toInitiateBillingPaymentResponseDto;
+/**
+ * Copia campos conhecidos de `metadata` para a resposta explícita de checkout/PIX/boleto.
+ */
+function toInitiateBillingPaymentResponseDto(payment) {
+    const meta = (payment.metadata ?? {});
+    return {
+        ...payment,
+        checkoutUrl: meta.paymentUrl ?? undefined,
+        pixQrCode: meta.pixQrCode ?? undefined,
+        pixCopyPaste: meta.pixCopyPaste ?? undefined,
+        boletoUrl: meta.boletoUrl ?? undefined,
+        boletoBarcode: meta.boletoBarcode ?? undefined,
+    };
+}

package/dist/payment-gateway/payment-gateway-routing-matrix.d.ts

@@ -0,0 +1,3 @@
+import type { GatewayPaymentMethodDto, PaymentGatewayDto } from './payment-gateway.enums';
+export declare function isMethodSupportedByGateway(gateway: PaymentGatewayDto, method: GatewayPaymentMethodDto): boolean;
+//# sourceMappingURL=payment-gateway-routing-matrix.d.ts.map

package/dist/payment-gateway/payment-gateway-routing-matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-gateway-routing-matrix.d.ts","sourceRoot":"","sources":["../../src/payment-gateway/payment-gateway-routing-matrix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAY1F,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAET"}

package/dist/payment-gateway/payment-gateway-routing-matrix.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMethodSupportedByGateway = isMethodSupportedByGateway;
+/**
+ * Matriz fixa gateway × meio (alinhada ao README do payment-gateway-service).
+ * Usada para validar configuração persistida e para checagens determinísticas.
+ */
+const SUPPORTED = {
+    ASAAS: new Set(['PIX', 'CREDIT_CARD', 'DEBIT_CARD', 'BOLETO']),
+    MERCADO_PAGO: new Set(['PIX', 'CREDIT_CARD', 'DEBIT_CARD']),
+    STRIPE: new Set(['CREDIT_CARD', 'DEBIT_CARD']),
+};
+function isMethodSupportedByGateway(gateway, method) {
+    return SUPPORTED[gateway]?.has(method) ?? false;
+}

package/dist/payment-gateway/payment-gateway-routing.dto.d.ts

@@ -0,0 +1,14 @@
+import { ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
+import { type GatewayPaymentMethodDto, type PaymentGatewayDto } from './payment-gateway.enums';
+export declare class PaymentGatewayRoutingEntriesConstraint implements ValidatorConstraintInterface {
+    validate(entries: unknown, _args: ValidationArguments): boolean;
+    defaultMessage(): string;
+}
+export declare class PaymentGatewayRoutingEntryDto {
+    gateway: PaymentGatewayDto;
+    methods: GatewayPaymentMethodDto[];
+}
+export declare class PaymentGatewayRoutingDto {
+    entries: PaymentGatewayRoutingEntryDto[];
+}
+//# sourceMappingURL=payment-gateway-routing.dto.d.ts.map

package/dist/payment-gateway/payment-gateway-routing.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-gateway-routing.dto.d.ts","sourceRoot":"","sources":["../../src/payment-gateway/payment-gateway-routing.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,mBAAmB,EAEnB,4BAA4B,EAC7B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,uBAAuB,EAE5B,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAGjC,qBACa,sCAAuC,YAAW,4BAA4B;IACzF,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO;IAiC/D,cAAc,IAAI,MAAM;CAMzB;AAED,qBAAa,6BAA6B;IAGxC,OAAO,EAAE,iBAAiB,CAAC;IAM3B,OAAO,EAAE,uBAAuB,EAAE,CAAC;CACpC;AAED,qBAAa,wBAAwB;IAOnC,OAAO,EAAE,6BAA6B,EAAE,CAAC;CAC1C"}

package/dist/payment-gateway/payment-gateway-routing.dto.js

@@ -0,0 +1,89 @@
+"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.PaymentGatewayRoutingDto = exports.PaymentGatewayRoutingEntryDto = exports.PaymentGatewayRoutingEntriesConstraint = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const payment_gateway_enums_1 = require("./payment-gateway.enums");
+const payment_gateway_routing_matrix_1 = require("./payment-gateway-routing-matrix");
+let PaymentGatewayRoutingEntriesConstraint = class PaymentGatewayRoutingEntriesConstraint {
+    validate(entries, _args) {
+        if (!Array.isArray(entries) || entries.length < 1) {
+            return false;
+        }
+        const seenGateways = new Set();
+        for (const raw of entries) {
+            if (!raw || typeof raw !== 'object') {
+                return false;
+            }
+            const e = raw;
+            if (typeof e.gateway !== 'string' || !payment_gateway_enums_1.PAYMENT_GATEWAYS.includes(e.gateway)) {
+                return false;
+            }
+            const gateway = e.gateway;
+            if (seenGateways.has(gateway)) {
+                return false;
+            }
+            seenGateways.add(gateway);
+            if (!Array.isArray(e.methods) || e.methods.length < 1) {
+                return false;
+            }
+            for (const m of e.methods) {
+                if (typeof m !== 'string' || !payment_gateway_enums_1.GATEWAY_PAYMENT_METHODS.includes(m)) {
+                    return false;
+                }
+                if (!(0, payment_gateway_routing_matrix_1.isMethodSupportedByGateway)(gateway, m)) {
+                    return false;
+                }
+            }
+        }
+        return true;
+    }
+    defaultMessage() {
+        return ('paymentGatewayRouting.entries inválido: ordem vazia, gateway duplicado, methods vazio ' +
+            'ou combinação gateway/método não suportada pela plataforma');
+    }
+};
+exports.PaymentGatewayRoutingEntriesConstraint = PaymentGatewayRoutingEntriesConstraint;
+exports.PaymentGatewayRoutingEntriesConstraint = PaymentGatewayRoutingEntriesConstraint = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'paymentGatewayRoutingEntriesValid', async: false })
+], PaymentGatewayRoutingEntriesConstraint);
+class PaymentGatewayRoutingEntryDto {
+    gateway;
+    methods;
+}
+exports.PaymentGatewayRoutingEntryDto = PaymentGatewayRoutingEntryDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ enum: payment_gateway_enums_1.PAYMENT_GATEWAYS }),
+    (0, class_validator_1.IsEnum)(payment_gateway_enums_1.PAYMENT_GATEWAYS),
+    __metadata("design:type", String)
+], PaymentGatewayRoutingEntryDto.prototype, "gateway", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ enum: payment_gateway_enums_1.GATEWAY_PAYMENT_METHODS, isArray: true }),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.IsEnum)(payment_gateway_enums_1.GATEWAY_PAYMENT_METHODS, { each: true }),
+    __metadata("design:type", Array)
+], PaymentGatewayRoutingEntryDto.prototype, "methods", void 0);
+class PaymentGatewayRoutingDto {
+    entries;
+}
+exports.PaymentGatewayRoutingDto = PaymentGatewayRoutingDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: [PaymentGatewayRoutingEntryDto] }),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => PaymentGatewayRoutingEntryDto),
+    (0, class_validator_1.Validate)(PaymentGatewayRoutingEntriesConstraint),
+    __metadata("design:type", Array)
+], PaymentGatewayRoutingDto.prototype, "entries", void 0);

package/dist/payment-gateway/platform-configuration.topics.d.ts

@@ -0,0 +1,3 @@
+/** RPC: retorno da configuração global da plataforma (tenant-service → consumidores). */
+export declare const TOPIC_PLATFORM_CONFIGURATION_GET = "platform.configuration.get";
+//# sourceMappingURL=platform-configuration.topics.d.ts.map

package/dist/payment-gateway/platform-configuration.topics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-configuration.topics.d.ts","sourceRoot":"","sources":["../../src/payment-gateway/platform-configuration.topics.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,eAAO,MAAM,gCAAgC,+BAA+B,CAAC"}

package/dist/payment-gateway/platform-configuration.topics.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOPIC_PLATFORM_CONFIGURATION_GET = void 0;
+/** RPC: retorno da configuração global da plataforma (tenant-service → consumidores). */
+exports.TOPIC_PLATFORM_CONFIGURATION_GET = 'platform.configuration.get';

package/package.json

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

package/src/billing/list-billings-query.dto.ts

@@ -4,6 +4,12 @@ import {
   BILLING_STATUSES,
   BillingStatusDto,
 } from './create-billing.dto';
+import {
+  GATEWAY_PAYMENT_METHODS,
+  type GatewayPaymentMethodDto,
+  PAYMENT_GATEWAYS,
+  type PaymentGatewayDto,
+} from '../payment-gateway/payment-gateway.enums';
 
 export class ListBillingsQueryDto {
   @ApiPropertyOptional({
@@ -31,6 +37,22 @@ export class ListBillingsQueryDto {
   @IsUUID('4')
   paymentId?: string;
 
+  @ApiPropertyOptional({
+    description: 'Filtro por método de pagamento associado à cobrança',
+    enum: GATEWAY_PAYMENT_METHODS,
+  })
+  @IsOptional()
+  @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/cashback/cashback-kafka-payloads.ts

@@ -42,6 +42,13 @@ export interface UseReferralCodePayload {
   checkoutAmount: number;
 }
 
+/** Vínculo de código no cadastro do paciente (sem checkout). */
+export interface LinkReferralAtRegistrationPayload {
+  tenant: string;
+  code: string;
+  referredPatientId: string;
+}
+
 export interface GetReferralByPatientPayload {
   tenant: string;
   patientId: string;

package/src/payment-gateway/create-gateway-payment.dto.ts

@@ -72,14 +72,15 @@ export class CreateGatewayPaymentDto {
   @Min(0.01)
   amount: number;
 
-  @ApiProperty({
-    description: 'Payment gateway to use',
+  @ApiPropertyOptional({
+    description:
+      'Gateway explícito. Se omitido, o payment-gateway-service resolve pela rota global (prioridade + métodos).',
     enum: PAYMENT_GATEWAYS,
     example: 'ASAAS',
   })
+  @IsOptional()
   @IsEnum(PAYMENT_GATEWAYS)
-  @IsNotEmpty()
-  gateway: PaymentGatewayDto;
+  gateway?: PaymentGatewayDto;
 
   @ApiProperty({
     description: 'Payment method',

package/src/payment-gateway/index.ts

@@ -1,4 +1,9 @@
 export * from './payment-gateway.enums';
+export * from './payment-gateway-routing-matrix';
+export * from './payment-gateway-routing.dto';
+export * from './initiate-billing-payment-response.dto';
+export * from './initiate-billing-payment.mapper';
+export * from './platform-configuration.topics';
 export * from './create-gateway-payment.dto';
 export * from './update-gateway-payment.dto';
 export * from './gateway-payment-response.dto';

package/src/payment-gateway/initiate-billing-payment-response.dto.ts

@@ -0,0 +1,25 @@
+import { ApiPropertyOptional } from '@nestjs/swagger';
+import { GatewayPaymentResponseDto } from './gateway-payment-response.dto';
+
+/**
+ * Resposta de iniciar pagamento de cobrança: inclui o registro do pagamento e
+ * campos explícitos copiados de metadata quando presentes (PIX, checkout, boleto).
+ */
+export class InitiateBillingPaymentResponseDto extends GatewayPaymentResponseDto {
+  @ApiPropertyOptional({
+    description: 'URL para fluxo de pagamento (cartão, checkout hospedado, etc.)',
+  })
+  checkoutUrl?: string | null;
+
+  @ApiPropertyOptional({ description: 'QR Code PIX em base64 quando aplicável' })
+  pixQrCode?: string | null;
+
+  @ApiPropertyOptional({ description: 'PIX copia e cola quando aplicável' })
+  pixCopyPaste?: string | null;
+
+  @ApiPropertyOptional({ description: 'URL do boleto quando aplicável' })
+  boletoUrl?: string | null;
+
+  @ApiPropertyOptional({ description: 'Código de barras do boleto quando aplicável' })
+  boletoBarcode?: string | null;
+}

package/src/payment-gateway/initiate-billing-payment.mapper.ts

@@ -0,0 +1,19 @@
+import type { GatewayPaymentResponseDto } from './gateway-payment-response.dto';
+import { InitiateBillingPaymentResponseDto } from './initiate-billing-payment-response.dto';
+
+/**
+ * Copia campos conhecidos de `metadata` para a resposta explícita de checkout/PIX/boleto.
+ */
+export function toInitiateBillingPaymentResponseDto(
+  payment: GatewayPaymentResponseDto,
+): InitiateBillingPaymentResponseDto {
+  const meta = (payment.metadata ?? {}) as Record<string, unknown>;
+  return {
+    ...payment,
+    checkoutUrl: (meta.paymentUrl as string | undefined) ?? undefined,
+    pixQrCode: (meta.pixQrCode as string | undefined) ?? undefined,
+    pixCopyPaste: (meta.pixCopyPaste as string | undefined) ?? undefined,
+    boletoUrl: (meta.boletoUrl as string | undefined) ?? undefined,
+    boletoBarcode: (meta.boletoBarcode as string | undefined) ?? undefined,
+  };
+}

package/src/payment-gateway/payment-gateway-routing-matrix.ts

@@ -0,0 +1,18 @@
+import type { GatewayPaymentMethodDto, PaymentGatewayDto } from './payment-gateway.enums';
+
+/**
+ * Matriz fixa gateway × meio (alinhada ao README do payment-gateway-service).
+ * Usada para validar configuração persistida e para checagens determinísticas.
+ */
+const SUPPORTED: Record<PaymentGatewayDto, ReadonlySet<GatewayPaymentMethodDto>> = {
+  ASAAS: new Set(['PIX', 'CREDIT_CARD', 'DEBIT_CARD', 'BOLETO']),
+  MERCADO_PAGO: new Set(['PIX', 'CREDIT_CARD', 'DEBIT_CARD']),
+  STRIPE: new Set(['CREDIT_CARD', 'DEBIT_CARD']),
+};
+
+export function isMethodSupportedByGateway(
+  gateway: PaymentGatewayDto,
+  method: GatewayPaymentMethodDto,
+): boolean {
+  return SUPPORTED[gateway]?.has(method) ?? false;
+}

package/src/payment-gateway/payment-gateway-routing.dto.ts

@@ -0,0 +1,84 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import {
+  ArrayMinSize,
+  IsArray,
+  IsEnum,
+  Validate,
+  ValidateNested,
+  ValidationArguments,
+  ValidatorConstraint,
+  ValidatorConstraintInterface,
+} from 'class-validator';
+import {
+  GATEWAY_PAYMENT_METHODS,
+  type GatewayPaymentMethodDto,
+  PAYMENT_GATEWAYS,
+  type PaymentGatewayDto,
+} from './payment-gateway.enums';
+import { isMethodSupportedByGateway } from './payment-gateway-routing-matrix';
+
+@ValidatorConstraint({ name: 'paymentGatewayRoutingEntriesValid', async: false })
+export class PaymentGatewayRoutingEntriesConstraint implements ValidatorConstraintInterface {
+  validate(entries: unknown, _args: ValidationArguments): boolean {
+    if (!Array.isArray(entries) || entries.length < 1) {
+      return false;
+    }
+    const seenGateways = new Set<string>();
+    for (const raw of entries) {
+      if (!raw || typeof raw !== 'object') {
+        return false;
+      }
+      const e = raw as { gateway?: unknown; methods?: unknown };
+      if (typeof e.gateway !== 'string' || !PAYMENT_GATEWAYS.includes(e.gateway as PaymentGatewayDto)) {
+        return false;
+      }
+      const gateway = e.gateway as PaymentGatewayDto;
+      if (seenGateways.has(gateway)) {
+        return false;
+      }
+      seenGateways.add(gateway);
+      if (!Array.isArray(e.methods) || e.methods.length < 1) {
+        return false;
+      }
+      for (const m of e.methods) {
+        if (typeof m !== 'string' || !GATEWAY_PAYMENT_METHODS.includes(m as GatewayPaymentMethodDto)) {
+          return false;
+        }
+        if (!isMethodSupportedByGateway(gateway, m as GatewayPaymentMethodDto)) {
+          return false;
+        }
+      }
+    }
+    return true;
+  }
+
+  defaultMessage(): string {
+    return (
+      'paymentGatewayRouting.entries inválido: ordem vazia, gateway duplicado, methods vazio ' +
+      'ou combinação gateway/método não suportada pela plataforma'
+    );
+  }
+}
+
+export class PaymentGatewayRoutingEntryDto {
+  @ApiProperty({ enum: PAYMENT_GATEWAYS })
+  @IsEnum(PAYMENT_GATEWAYS as unknown as object)
+  gateway: PaymentGatewayDto;
+
+  @ApiProperty({ enum: GATEWAY_PAYMENT_METHODS, isArray: true })
+  @IsArray()
+  @ArrayMinSize(1)
+  @IsEnum(GATEWAY_PAYMENT_METHODS as unknown as object, { each: true })
+  methods: GatewayPaymentMethodDto[];
+}
+
+export class PaymentGatewayRoutingDto {
+  @ApiProperty({ type: [PaymentGatewayRoutingEntryDto] })
+  @IsArray()
+  @ArrayMinSize(1)
+  @ValidateNested({ each: true })
+  @Type(() => PaymentGatewayRoutingEntryDto)
+  @Validate(PaymentGatewayRoutingEntriesConstraint)
+  entries: PaymentGatewayRoutingEntryDto[];
+}

package/src/payment-gateway/platform-configuration.topics.ts

@@ -0,0 +1,2 @@
+/** RPC: retorno da configuração global da plataforma (tenant-service → consumidores). */
+export const TOPIC_PLATFORM_CONFIGURATION_GET = 'platform.configuration.get';