tychat-contracts 1.0.85 → 1.0.87

package/dist/cashback/use-referral-code-response.dto.js

@@ -0,0 +1,34 @@
+"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.UseReferralCodeResponseDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+/**
+ * Response DTO for using a referral code
+ */
+class UseReferralCodeResponseDto {
+    cashbackAmount;
+    discountAmount;
+    referrerPatientId;
+}
+exports.UseReferralCodeResponseDto = UseReferralCodeResponseDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Cashback amount awarded to the referrer' }),
+    __metadata("design:type", Number)
+], UseReferralCodeResponseDto.prototype, "cashbackAmount", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Discount amount applied to the referred patient' }),
+    __metadata("design:type", Number)
+], UseReferralCodeResponseDto.prototype, "discountAmount", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Patient ID of the referrer (code owner)' }),
+    __metadata("design:type", String)
+], UseReferralCodeResponseDto.prototype, "referrerPatientId", void 0);

package/dist/index.d.ts

@@ -16,4 +16,5 @@ export * from './tenants';
 export * from './conversations';
 export * from './connections';
 export * from './analytics';
+export * from './cashback';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,MAAM,CAAC;AACrB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,MAAM,CAAC;AACrB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -32,3 +32,4 @@ __exportStar(require("./tenants"), exports);
 __exportStar(require("./conversations"), exports);
 __exportStar(require("./connections"), exports);
 __exportStar(require("./analytics"), exports);
+__exportStar(require("./cashback"), exports);

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.85",
+  "version": "1.0.87",
   "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-balance-response.dto.ts

@@ -0,0 +1,33 @@
+import { ApiProperty } from '@nestjs/swagger';
+
+/**
+ * Response DTO for cashback balance
+ */
+export class CashbackBalanceResponseDto {
+  @ApiProperty({ description: 'Balance ID (UUID)' })
+  id: string;
+
+  @ApiProperty({ description: 'Patient ID' })
+  patientId: string;
+
+  @ApiProperty({ description: 'Available (usable) balance' })
+  availableBalance: number;
+
+  @ApiProperty({ description: 'Pending balance (future use)' })
+  pendingBalance: number;
+
+  @ApiProperty({ description: 'Lifetime total earned' })
+  totalEarned: number;
+
+  @ApiProperty({ description: 'Lifetime total used/redeemed' })
+  totalUsed: number;
+
+  @ApiProperty({ description: 'Lifetime total expired' })
+  totalExpired: number;
+
+  @ApiProperty({ description: 'Creation timestamp' })
+  createdAt: string;
+
+  @ApiProperty({ description: 'Last update timestamp' })
+  updatedAt: string;
+}

package/src/cashback/cashback-config-response.dto.ts

@@ -0,0 +1,43 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { CashbackDiscountTypeDto, CashbackExpirationTypeDto } from './cashback-enums';
+
+/**
+ * Response DTO for cashback configuration
+ */
+export class CashbackConfigResponseDto {
+  @ApiProperty({ description: 'Config ID (UUID)' })
+  id: string;
+
+  @ApiProperty({ description: 'Whether cashback system is active' })
+  isActive: boolean;
+
+  @ApiProperty({ description: 'Cashback percentage for referrer', example: 10.0 })
+  cashbackPercentage: number;
+
+  @ApiProperty({ description: 'Discount type for referred patient', enum: CashbackDiscountTypeDto })
+  discountType: CashbackDiscountTypeDto;
+
+  @ApiProperty({ description: 'Discount value', example: 10.0 })
+  discountValue: number;
+
+  @ApiProperty({ description: 'Expiration type', enum: CashbackExpirationTypeDto })
+  expirationType: CashbackExpirationTypeDto;
+
+  @ApiPropertyOptional({ description: 'Expiration days (PERIOD_PER_PATIENT)' })
+  expirationDays?: number | null;
+
+  @ApiPropertyOptional({ description: 'Max total uses (LIMITED)' })
+  maxTotalUses?: number | null;
+
+  @ApiPropertyOptional({ description: 'Max uses per patient (LIMITED)' })
+  maxUsesPerPatient?: number | null;
+
+  @ApiPropertyOptional({ description: 'Code expiration days (LIMITED)' })
+  codeExpirationDays?: number | null;
+
+  @ApiProperty({ description: 'Creation timestamp' })
+  createdAt: string;
+
+  @ApiProperty({ description: 'Last update timestamp' })
+  updatedAt: string;
+}

package/src/cashback/cashback-enums.ts

@@ -0,0 +1,33 @@
+/**
+ * Expiration type for referral codes
+ */
+export enum CashbackExpirationTypeDto {
+  /** Each referred patient can only use the code once */
+  SINGLE_USE_PER_PATIENT = 'SINGLE_USE_PER_PATIENT',
+  /** Code stays active for a limited period per patient */
+  PERIOD_PER_PATIENT = 'PERIOD_PER_PATIENT',
+  /** Code has total use limit and optional per-patient limit */
+  LIMITED = 'LIMITED',
+}
+
+/**
+ * Discount type for referred patients
+ */
+export enum CashbackDiscountTypeDto {
+  /** Discount is a percentage of the checkout amount */
+  PERCENTAGE = 'PERCENTAGE',
+  /** Discount is a fixed amount */
+  FIXED = 'FIXED',
+}
+
+/**
+ * Cashback ledger transaction type
+ */
+export enum CashbackLedgerTypeDto {
+  /** Cashback earned from referral */
+  CREDIT = 'CREDIT',
+  /** Cashback redeemed/used */
+  DEBIT = 'DEBIT',
+  /** Credits expired */
+  EXPIRATION = 'EXPIRATION',
+}

package/src/cashback/cashback-kafka-payloads.ts

@@ -0,0 +1,102 @@
+import { CashbackDiscountTypeDto, CashbackExpirationTypeDto } from './cashback-enums';
+
+// ─── Config Payloads ───
+
+export interface GetCashbackConfigPayload {
+  tenant: string;
+}
+
+export interface UpdateCashbackConfigPayload {
+  tenant: string;
+  isActive?: boolean;
+  cashbackPercentage?: number;
+  discountType?: CashbackDiscountTypeDto;
+  discountValue?: number;
+  expirationType?: CashbackExpirationTypeDto;
+  expirationDays?: number | null;
+  maxTotalUses?: number | null;
+  maxUsesPerPatient?: number | null;
+  codeExpirationDays?: number | null;
+}
+
+// ─── Referral Payloads ───
+
+export interface GenerateReferralCodePayload {
+  tenant: string;
+  patientId: string;
+  /** Se true, não cria código novo quando cashback global está inativo (resposta null). */
+  onlyIfActive?: boolean;
+}
+
+export interface ValidateReferralCodePayload {
+  tenant: string;
+  code: string;
+  referredPatientId: string;
+}
+
+export interface UseReferralCodePayload {
+  tenant: string;
+  code: string;
+  referredPatientId: string;
+  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;
+}
+
+export interface GetReferralByCodePayload {
+  tenant: string;
+  code: string;
+}
+
+export interface GetReferralUsagesPayload {
+  tenant: string;
+  referralCodeId: string;
+}
+
+// ─── Balance / Ledger Payloads ───
+
+export interface GetCashbackBalancePayload {
+  tenant: string;
+  patientId: string;
+}
+
+export interface CreditCashbackPayload {
+  tenant: string;
+  patientId: string;
+  amount: number;
+  description: string;
+  referenceId?: string;
+  referenceType?: string;
+  expiresAt?: string;
+}
+
+export interface DebitCashbackPayload {
+  tenant: string;
+  patientId: string;
+  amount: number;
+  description: string;
+  referenceId?: string;
+  referenceType?: string;
+}
+
+export interface GetCashbackLedgerPayload {
+  tenant: string;
+  patientId: string;
+  page?: number;
+  limit?: number;
+}
+
+export interface ExpireCashbackCreditsPayload {
+  tenant: string;
+}

package/src/cashback/cashback-kafka-topics.ts

@@ -0,0 +1,23 @@
+/**
+ * Kafka topic constants for the cashback microservice.
+ * All topics follow the pattern: cashback.<module>.<action>
+ */
+
+// ─── Promotion / Config ───
+export const TOPIC_CASHBACK_CONFIG_GET = 'cashback.config.get';
+export const TOPIC_CASHBACK_CONFIG_UPDATE = 'cashback.config.update';
+
+// ─── Referral ───
+export const TOPIC_CASHBACK_REFERRAL_GENERATE = 'cashback.referral.generate';
+export const TOPIC_CASHBACK_REFERRAL_VALIDATE = 'cashback.referral.validate';
+export const TOPIC_CASHBACK_REFERRAL_USE = 'cashback.referral.use';
+export const TOPIC_CASHBACK_REFERRAL_GET_BY_PATIENT = 'cashback.referral.getByPatient';
+export const TOPIC_CASHBACK_REFERRAL_GET_BY_CODE = 'cashback.referral.getByCode';
+export const TOPIC_CASHBACK_REFERRAL_GET_USAGES = 'cashback.referral.getUsagesByCode';
+
+// ─── Balance / Ledger ───
+export const TOPIC_CASHBACK_BALANCE_GET = 'cashback.balance.get';
+export const TOPIC_CASHBACK_BALANCE_CREDIT = 'cashback.balance.credit';
+export const TOPIC_CASHBACK_BALANCE_DEBIT = 'cashback.balance.debit';
+export const TOPIC_CASHBACK_LEDGER_GET = 'cashback.ledger.get';
+export const TOPIC_CASHBACK_CREDITS_EXPIRE = 'cashback.credits.expire';