tychat-contracts 1.6.21 → 1.6.24

package/src/payment-gateway/payment-gateway.enums.ts

@@ -1,34 +1,34 @@
-/**
- * Supported payment gateways.
- */
-export const PAYMENT_GATEWAYS = ['ASAAS', 'MERCADO_PAGO', 'STRIPE'] as const;
-export type PaymentGatewayDto = (typeof PAYMENT_GATEWAYS)[number];
-
-/**
- * Payment methods supported across gateways.
- */
-export const GATEWAY_PAYMENT_METHODS = [
-  'PIX',
-  'CREDIT_CARD',
-  'DEBIT_CARD',
-  'BOLETO',
-  'VOUCHER',
-  'CASH',
-] as const;
-export type GatewayPaymentMethodDto = (typeof GATEWAY_PAYMENT_METHODS)[number];
-
-/**
- * Payment statuses tracked by the payment gateway.
- */
-export const GATEWAY_PAYMENT_STATUSES = [
-  'PENDING',
-  'PROCESSING',
-  'CONFIRMED',
-  'PAYED',
-  'REFUNDED',
-  'CANCELED',
-  'FAILED',
-  'OVERDUE',
-  'EXPIRED',
-] as const;
-export type GatewayPaymentStatusDto = (typeof GATEWAY_PAYMENT_STATUSES)[number];
+/**
+ * Supported payment gateways.
+ */
+export const PAYMENT_GATEWAYS = ['ASAAS', 'MERCADO_PAGO', 'STRIPE'] as const;
+export type PaymentGatewayDto = (typeof PAYMENT_GATEWAYS)[number];
+
+/**
+ * Payment methods supported across gateways.
+ */
+export const GATEWAY_PAYMENT_METHODS = [
+  'PIX',
+  'CREDIT_CARD',
+  'DEBIT_CARD',
+  'BOLETO',
+  'VOUCHER',
+  'CASH',
+] as const;
+export type GatewayPaymentMethodDto = (typeof GATEWAY_PAYMENT_METHODS)[number];
+
+/**
+ * Payment statuses tracked by the payment gateway.
+ */
+export const GATEWAY_PAYMENT_STATUSES = [
+  'PENDING',
+  'PROCESSING',
+  'CONFIRMED',
+  'PAYED',
+  'REFUNDED',
+  'CANCELED',
+  'FAILED',
+  'OVERDUE',
+  'EXPIRED',
+] as const;
+export type GatewayPaymentStatusDto = (typeof GATEWAY_PAYMENT_STATUSES)[number];

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

@@ -1,7 +1,7 @@
-import { PartialType } from '@nestjs/swagger';
-import { CreateGatewayPaymentDto } from './create-gateway-payment.dto';
-
-/**
- * DTO for updating an existing gateway payment (all fields optional).
- */
-export class UpdateGatewayPaymentDto extends PartialType(CreateGatewayPaymentDto) {}
+import { PartialType } from '@nestjs/swagger';
+import { CreateGatewayPaymentDto } from './create-gateway-payment.dto';
+
+/**
+ * DTO for updating an existing gateway payment (all fields optional).
+ */
+export class UpdateGatewayPaymentDto extends PartialType(CreateGatewayPaymentDto) {}

package/src/payment-gateway/webhook-payload.dto.ts

@@ -1,32 +1,32 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { IsEnum, IsNotEmpty, IsOptional, IsString } from 'class-validator';
-import { PAYMENT_GATEWAYS, PaymentGatewayDto, GATEWAY_PAYMENT_STATUSES, GatewayPaymentStatusDto } from './payment-gateway.enums';
-
-/**
- * Normalized webhook event payload received from any payment gateway.
- */
-export class GatewayWebhookEventDto {
-  @ApiProperty({ description: 'Payment gateway that originated the event', enum: PAYMENT_GATEWAYS })
-  @IsEnum(PAYMENT_GATEWAYS)
-  @IsNotEmpty()
-  gateway: PaymentGatewayDto;
-
-  @ApiProperty({ description: 'Event type from the gateway', example: 'PAYMENT_RECEIVED' })
-  @IsString()
-  @IsNotEmpty()
-  eventType: string;
-
-  @ApiProperty({ description: 'External payment ID from the gateway', example: 'pay_abc123' })
-  @IsString()
-  @IsNotEmpty()
-  externalId: string;
-
-  @ApiPropertyOptional({ description: 'New payment status after the event', enum: GATEWAY_PAYMENT_STATUSES })
-  @IsOptional()
-  @IsEnum(GATEWAY_PAYMENT_STATUSES)
-  status?: GatewayPaymentStatusDto;
-
-  @ApiPropertyOptional({ description: 'Raw payload from the gateway for auditing' })
-  @IsOptional()
-  rawPayload?: Record<string, unknown>;
-}
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsEnum, IsNotEmpty, IsOptional, IsString } from 'class-validator';
+import { PAYMENT_GATEWAYS, PaymentGatewayDto, GATEWAY_PAYMENT_STATUSES, GatewayPaymentStatusDto } from './payment-gateway.enums';
+
+/**
+ * Normalized webhook event payload received from any payment gateway.
+ */
+export class GatewayWebhookEventDto {
+  @ApiProperty({ description: 'Payment gateway that originated the event', enum: PAYMENT_GATEWAYS })
+  @IsEnum(PAYMENT_GATEWAYS)
+  @IsNotEmpty()
+  gateway: PaymentGatewayDto;
+
+  @ApiProperty({ description: 'Event type from the gateway', example: 'PAYMENT_RECEIVED' })
+  @IsString()
+  @IsNotEmpty()
+  eventType: string;
+
+  @ApiProperty({ description: 'External payment ID from the gateway', example: 'pay_abc123' })
+  @IsString()
+  @IsNotEmpty()
+  externalId: string;
+
+  @ApiPropertyOptional({ description: 'New payment status after the event', enum: GATEWAY_PAYMENT_STATUSES })
+  @IsOptional()
+  @IsEnum(GATEWAY_PAYMENT_STATUSES)
+  status?: GatewayPaymentStatusDto;
+
+  @ApiPropertyOptional({ description: 'Raw payload from the gateway for auditing' })
+  @IsOptional()
+  rawPayload?: Record<string, unknown>;
+}

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

@@ -1,73 +1,73 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import {
-  IsDateString,
-  IsEnum,
-  IsNotEmpty,
-  IsNumber,
-  IsOptional,
-  IsUUID,
-  Min,
-} from 'class-validator';
-import { PAYMENT_METHODS, PaymentMethodDto } from './payment-method.dto';
-import { PAYMENT_STATUSES, PaymentStatusDto } from './payment-status.dto';
-
-export class CreatePaymentDto {
-  @ApiProperty({
-    description: 'Payment method',
-    enum: PAYMENT_METHODS,
-    example: 'PIX',
-  })
-  @IsEnum(PAYMENT_METHODS)
-  @IsNotEmpty()
-  method: PaymentMethodDto;
-
-  @ApiProperty({
-    description: 'Payment value (must be greater than 0)',
-    example: 150.5,
-    minimum: 0.01,
-  })
-  @IsNumber()
-  @Min(0.01)
-  value: number;
-
-  @ApiProperty({
-    description: 'Patient ID (UUID)',
-    example: '550e8400-e29b-41d4-a716-446655440000',
-  })
-  @IsUUID('4')
-  @IsNotEmpty()
-  patientId: string;
-
-  @ApiProperty({
-    description: 'Appointment ID (UUID)',
-    example: '550e8400-e29b-41d4-a716-446655440001',
-  })
-  @IsUUID('4')
-  @IsNotEmpty()
-  appointmentId: string;
-
-  @ApiPropertyOptional({
-    description: 'Due date (ISO 8601). Defaults to now if not provided.',
-    example: '2026-03-15T23:59:59.000Z',
-  })
-  @IsOptional()
-  @IsDateString()
-  dueDate?: string;
-
-  @ApiPropertyOptional({
-    description: 'Payment status. Defaults to PENDING if not provided.',
-    enum: PAYMENT_STATUSES,
-    default: 'PENDING',
-  })
-  @IsOptional()
-  @IsEnum(PAYMENT_STATUSES)
-  status?: PaymentStatusDto;
-
-  @ApiPropertyOptional({
-    description: 'Date when payment was completed (ISO 8601). Set when status is PAYED.',
-    example: '2026-03-15T14:30:00.000Z',
-  })
-  @IsOptional()
-  @IsDateString()
-  payedAt?: string;
-}
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import {
+  IsDateString,
+  IsEnum,
+  IsNotEmpty,
+  IsNumber,
+  IsOptional,
+  IsUUID,
+  Min,
+} from 'class-validator';
+import { PAYMENT_METHODS, PaymentMethodDto } from './payment-method.dto';
+import { PAYMENT_STATUSES, PaymentStatusDto } from './payment-status.dto';
+
+export class CreatePaymentDto {
+  @ApiProperty({
+    description: 'Payment method',
+    enum: PAYMENT_METHODS,
+    example: 'PIX',
+  })
+  @IsEnum(PAYMENT_METHODS)
+  @IsNotEmpty()
+  method: PaymentMethodDto;
+
+  @ApiProperty({
+    description: 'Payment value (must be greater than 0)',
+    example: 150.5,
+    minimum: 0.01,
+  })
+  @IsNumber()
+  @Min(0.01)
+  value: number;
+
+  @ApiProperty({
+    description: 'Patient ID (UUID)',
+    example: '550e8400-e29b-41d4-a716-446655440000',
+  })
+  @IsUUID('4')
+  @IsNotEmpty()
+  patientId: string;
+
+  @ApiProperty({
+    description: 'Appointment ID (UUID)',
+    example: '550e8400-e29b-41d4-a716-446655440001',
+  })
+  @IsUUID('4')
+  @IsNotEmpty()
+  appointmentId: string;
+
+  @ApiPropertyOptional({
+    description: 'Due date (ISO 8601). Defaults to now if not provided.',
+    example: '2026-03-15T23:59:59.000Z',
+  })
+  @IsOptional()
+  @IsDateString()
+  dueDate?: string;
+
+  @ApiPropertyOptional({
+    description: 'Payment status. Defaults to PENDING if not provided.',
+    enum: PAYMENT_STATUSES,
+    default: 'PENDING',
+  })
+  @IsOptional()
+  @IsEnum(PAYMENT_STATUSES)
+  status?: PaymentStatusDto;
+
+  @ApiPropertyOptional({
+    description: 'Date when payment was completed (ISO 8601). Set when status is PAYED.',
+    example: '2026-03-15T14:30:00.000Z',
+  })
+  @IsOptional()
+  @IsDateString()
+  payedAt?: string;
+}

package/src/payments/index.ts

@@ -1,7 +1,7 @@
-export * from './create-payment.dto';
-export * from './update-payment.dto';
-export * from './list-payments-query.dto';
-export * from './payment-response.dto';
-export * from './payment-method.dto';
-export * from './payment-status.dto';
+export * from './create-payment.dto';
+export * from './update-payment.dto';
+export * from './list-payments-query.dto';
+export * from './payment-response.dto';
+export * from './payment-method.dto';
+export * from './payment-status.dto';
 export * from './list-payment-response.dto';

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

@@ -1,44 +1,44 @@
-import { ApiPropertyOptional } from '@nestjs/swagger';
-import { IsInt, IsOptional, IsUUID, Max, Min } from 'class-validator';
-
-export class ListPaymentsQueryDto {
-  @ApiPropertyOptional({
-    description: 'Filter by appointment ID (UUID)',
-    example: '550e8400-e29b-41d4-a716-446655440001',
-  })
-  @IsOptional()
-  @IsUUID('4')
-  appointmentId?: string;
-
-  @ApiPropertyOptional({
-    description: 'Filter by patient ID (UUID)',
-    example: '550e8400-e29b-41d4-a716-446655440000',
-  })
-  @IsOptional()
-  @IsUUID('4')
-  patientId?: string;
-
-  @ApiPropertyOptional({
-    description: 'Page number (starting at 1)',
-    example: 1,
-    minimum: 1,
-    default: 1,
-  })
-  @IsOptional()
-  @IsInt()
-  @Min(1)
-  page?: number;
-
-  @ApiPropertyOptional({
-    description: 'Number of records per page',
-    example: 20,
-    minimum: 1,
-    maximum: 100,
-    default: 20,
-  })
-  @IsOptional()
-  @IsInt()
-  @Min(1)
-  @Max(100)
-  limit?: number;
-}
+import { ApiPropertyOptional } from '@nestjs/swagger';
+import { IsInt, IsOptional, IsUUID, Max, Min } from 'class-validator';
+
+export class ListPaymentsQueryDto {
+  @ApiPropertyOptional({
+    description: 'Filter by appointment ID (UUID)',
+    example: '550e8400-e29b-41d4-a716-446655440001',
+  })
+  @IsOptional()
+  @IsUUID('4')
+  appointmentId?: string;
+
+  @ApiPropertyOptional({
+    description: 'Filter by patient ID (UUID)',
+    example: '550e8400-e29b-41d4-a716-446655440000',
+  })
+  @IsOptional()
+  @IsUUID('4')
+  patientId?: string;
+
+  @ApiPropertyOptional({
+    description: 'Page number (starting at 1)',
+    example: 1,
+    minimum: 1,
+    default: 1,
+  })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  page?: number;
+
+  @ApiPropertyOptional({
+    description: 'Number of records per page',
+    example: 20,
+    minimum: 1,
+    maximum: 100,
+    default: 20,
+  })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  @Max(100)
+  limit?: number;
+}

package/src/payments/payment-response.dto.ts

@@ -1,67 +1,67 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { PAYMENT_METHODS, PaymentMethodDto } from './payment-method.dto';
-import { PAYMENT_STATUSES, PaymentStatusDto } from './payment-status.dto';
-
-export class PaymentResponseDto {
-  @ApiProperty({
-    description: 'Payment ID (UUID)',
-    example: '550e8400-e29b-41d4-a716-446655440002',
-  })
-  id: string;
-
-  @ApiProperty({
-    description: 'Payment method',
-    enum: PAYMENT_METHODS,
-    example: 'PIX',
-  })
-  method: PaymentMethodDto;
-
-  @ApiProperty({
-    description: 'Payment status',
-    enum: PAYMENT_STATUSES,
-    example: 'PENDING',
-  })
-  status: PaymentStatusDto;
-
-  @ApiProperty({
-    description: 'Payment value',
-    example: 150.5,
-  })
-  value: number;
-
-  @ApiProperty({
-    description: 'Due date (ISO 8601)',
-    example: '2026-03-15T23:59:59.000Z',
-  })
-  dueDate: string;
-
-  @ApiPropertyOptional({
-    description: 'Date when payment was completed (ISO 8601)',
-    example: '2026-03-15T14:30:00.000Z',
-  })
-  payedAt?: string | null;
-
-  @ApiProperty({
-    description: 'Creation timestamp (ISO 8601)',
-    example: '2026-03-10T12:00:00.000Z',
-  })
-  createdAt: string;
-
-  @ApiProperty({
-    description: 'Last update timestamp (ISO 8601)',
-    example: '2026-03-10T12:00:00.000Z',
-  })
-  updatedAt: string;
-
-  @ApiProperty({
-    description: 'Patient ID (UUID)',
-    example: '550e8400-e29b-41d4-a716-446655440000',
-  })
-  patientId: string;
-
-  @ApiProperty({
-    description: 'Appointment ID (UUID)',
-    example: '550e8400-e29b-41d4-a716-446655440001',
-  })
-  appointmentId: string;
-}
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { PAYMENT_METHODS, PaymentMethodDto } from './payment-method.dto';
+import { PAYMENT_STATUSES, PaymentStatusDto } from './payment-status.dto';
+
+export class PaymentResponseDto {
+  @ApiProperty({
+    description: 'Payment ID (UUID)',
+    example: '550e8400-e29b-41d4-a716-446655440002',
+  })
+  id: string;
+
+  @ApiProperty({
+    description: 'Payment method',
+    enum: PAYMENT_METHODS,
+    example: 'PIX',
+  })
+  method: PaymentMethodDto;
+
+  @ApiProperty({
+    description: 'Payment status',
+    enum: PAYMENT_STATUSES,
+    example: 'PENDING',
+  })
+  status: PaymentStatusDto;
+
+  @ApiProperty({
+    description: 'Payment value',
+    example: 150.5,
+  })
+  value: number;
+
+  @ApiProperty({
+    description: 'Due date (ISO 8601)',
+    example: '2026-03-15T23:59:59.000Z',
+  })
+  dueDate: string;
+
+  @ApiPropertyOptional({
+    description: 'Date when payment was completed (ISO 8601)',
+    example: '2026-03-15T14:30:00.000Z',
+  })
+  payedAt?: string | null;
+
+  @ApiProperty({
+    description: 'Creation timestamp (ISO 8601)',
+    example: '2026-03-10T12:00:00.000Z',
+  })
+  createdAt: string;
+
+  @ApiProperty({
+    description: 'Last update timestamp (ISO 8601)',
+    example: '2026-03-10T12:00:00.000Z',
+  })
+  updatedAt: string;
+
+  @ApiProperty({
+    description: 'Patient ID (UUID)',
+    example: '550e8400-e29b-41d4-a716-446655440000',
+  })
+  patientId: string;
+
+  @ApiProperty({
+    description: 'Appointment ID (UUID)',
+    example: '550e8400-e29b-41d4-a716-446655440001',
+  })
+  appointmentId: string;
+}

package/src/payments/update-payment.dto.ts

@@ -1,4 +1,4 @@
-import { PartialType } from '@nestjs/swagger';
-import { CreatePaymentDto } from './create-payment.dto';
-
-export class UpdatePaymentDto extends PartialType(CreatePaymentDto) {}
+import { PartialType } from '@nestjs/swagger';
+import { CreatePaymentDto } from './create-payment.dto';
+
+export class UpdatePaymentDto extends PartialType(CreatePaymentDto) {}