tychat-contracts 1.0.113 → 1.0.115

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/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/package.json

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

package/src/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/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;
 }