tychat-contracts 1.6.21 → 1.6.23

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

@@ -1,102 +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;
-}
+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

@@ -1,23 +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';
+/**
+ * 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';

package/src/cashback/index.ts

@@ -1,7 +1,7 @@
-export * from './cashback-enums';
-export * from './cashback-kafka-topics';
-export * from './cashback-kafka-payloads';
-export * from './cashback-config-response.dto';
-export * from './referral-code-response.dto';
-export * from './use-referral-code-response.dto';
-export * from './cashback-balance-response.dto';
+export * from './cashback-enums';
+export * from './cashback-kafka-topics';
+export * from './cashback-kafka-payloads';
+export * from './cashback-config-response.dto';
+export * from './referral-code-response.dto';
+export * from './use-referral-code-response.dto';
+export * from './cashback-balance-response.dto';

package/src/cashback/referral-code-response.dto.ts

@@ -1,49 +1,49 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { CashbackDiscountTypeDto, CashbackExpirationTypeDto } from './cashback-enums';
-
-/**
- * Response DTO for a referral code
- */
-export class ReferralCodeResponseDto {
-  @ApiProperty({ description: 'Referral code ID (UUID)' })
-  id: string;
-
-  @ApiProperty({ description: 'Patient ID who owns this code' })
-  patientId: string;
-
-  @ApiProperty({ description: 'The 8-character referral code', example: 'ABCD1234' })
-  code: string;
-
-  @ApiProperty({ description: 'Cashback percentage snapshot' })
-  cashbackPercentage: number;
-
-  @ApiProperty({ description: 'Discount type snapshot', enum: CashbackDiscountTypeDto })
-  discountType: CashbackDiscountTypeDto;
-
-  @ApiProperty({ description: 'Discount value snapshot' })
-  discountValue: number;
-
-  @ApiProperty({ description: 'Expiration type snapshot', enum: CashbackExpirationTypeDto })
-  expirationType: CashbackExpirationTypeDto;
-
-  @ApiPropertyOptional({ description: 'Expiration days snapshot' })
-  expirationDays?: number | null;
-
-  @ApiPropertyOptional({ description: 'Max total uses snapshot' })
-  maxTotalUses?: number | null;
-
-  @ApiPropertyOptional({ description: 'Max uses per patient snapshot' })
-  maxUsesPerPatient?: number | null;
-
-  @ApiPropertyOptional({ description: 'Code expiration date' })
-  codeExpiresAt?: string | null;
-
-  @ApiProperty({ description: 'Total number of times used' })
-  totalUsesCount: number;
-
-  @ApiProperty({ description: 'Whether code is active' })
-  isActive: boolean;
-
-  @ApiProperty({ description: 'Creation timestamp' })
-  createdAt: string;
-}
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { CashbackDiscountTypeDto, CashbackExpirationTypeDto } from './cashback-enums';
+
+/**
+ * Response DTO for a referral code
+ */
+export class ReferralCodeResponseDto {
+  @ApiProperty({ description: 'Referral code ID (UUID)' })
+  id: string;
+
+  @ApiProperty({ description: 'Patient ID who owns this code' })
+  patientId: string;
+
+  @ApiProperty({ description: 'The 8-character referral code', example: 'ABCD1234' })
+  code: string;
+
+  @ApiProperty({ description: 'Cashback percentage snapshot' })
+  cashbackPercentage: number;
+
+  @ApiProperty({ description: 'Discount type snapshot', enum: CashbackDiscountTypeDto })
+  discountType: CashbackDiscountTypeDto;
+
+  @ApiProperty({ description: 'Discount value snapshot' })
+  discountValue: number;
+
+  @ApiProperty({ description: 'Expiration type snapshot', enum: CashbackExpirationTypeDto })
+  expirationType: CashbackExpirationTypeDto;
+
+  @ApiPropertyOptional({ description: 'Expiration days snapshot' })
+  expirationDays?: number | null;
+
+  @ApiPropertyOptional({ description: 'Max total uses snapshot' })
+  maxTotalUses?: number | null;
+
+  @ApiPropertyOptional({ description: 'Max uses per patient snapshot' })
+  maxUsesPerPatient?: number | null;
+
+  @ApiPropertyOptional({ description: 'Code expiration date' })
+  codeExpiresAt?: string | null;
+
+  @ApiProperty({ description: 'Total number of times used' })
+  totalUsesCount: number;
+
+  @ApiProperty({ description: 'Whether code is active' })
+  isActive: boolean;
+
+  @ApiProperty({ description: 'Creation timestamp' })
+  createdAt: string;
+}

package/src/cashback/use-referral-code-response.dto.ts

@@ -1,15 +1,15 @@
-import { ApiProperty } from '@nestjs/swagger';
-
-/**
- * Response DTO for using a referral code
- */
-export class UseReferralCodeResponseDto {
-  @ApiProperty({ description: 'Cashback amount awarded to the referrer' })
-  cashbackAmount: number;
-
-  @ApiProperty({ description: 'Discount amount applied to the referred patient' })
-  discountAmount: number;
-
-  @ApiProperty({ description: 'Patient ID of the referrer (code owner)' })
-  referrerPatientId: string;
-}
+import { ApiProperty } from '@nestjs/swagger';
+
+/**
+ * Response DTO for using a referral code
+ */
+export class UseReferralCodeResponseDto {
+  @ApiProperty({ description: 'Cashback amount awarded to the referrer' })
+  cashbackAmount: number;
+
+  @ApiProperty({ description: 'Discount amount applied to the referred patient' })
+  discountAmount: number;
+
+  @ApiProperty({ description: 'Patient ID of the referrer (code owner)' })
+  referrerPatientId: string;
+}

package/src/configurations/clinic-configuration.dto.ts

@@ -1,39 +1,39 @@
-import { ApiProperty } from '@nestjs/swagger';
-import { OpeningHoursSlotDto } from './opening-hours-slot.dto';
-import { AnamnesisCustomFieldDto } from './anamnesis-custom-field.dto';
-
-/**
- * Response DTO for clinic configuration (opening hours, etc.).
- */
-export class ClinicConfigurationDto {
-  @ApiProperty({
-    description: 'Configuration ID (UUID)',
-    example: '5e8f9e3b-3b9a-4d9a-9f4b-2a1c1b9e9f1a',
-  })
-  id: string;
-
-  @ApiProperty({
-    description: 'Opening hours slots per day of week (0=Sun..6=Sat)',
-    type: [OpeningHoursSlotDto],
-  })
-  opening_hours: OpeningHoursSlotDto[];
-
-  @ApiProperty({
-    description: 'Campos adicionais de anamnese configurados pela clínica',
-    type: [AnamnesisCustomFieldDto],
-    required: false,
-  })
-  anamnesis_custom_fields?: AnamnesisCustomFieldDto[];
-
-  @ApiProperty({
-    description: 'Creation timestamp',
-    example: '2026-03-10T12:00:00.000Z',
-  })
-  createdAt: Date;
-
-  @ApiProperty({
-    description: 'Last update timestamp',
-    example: '2026-03-10T12:00:00.000Z',
-  })
-  updatedAt: Date;
-}
+import { ApiProperty } from '@nestjs/swagger';
+import { OpeningHoursSlotDto } from './opening-hours-slot.dto';
+import { AnamnesisCustomFieldDto } from './anamnesis-custom-field.dto';
+
+/**
+ * Response DTO for clinic configuration (opening hours, etc.).
+ */
+export class ClinicConfigurationDto {
+  @ApiProperty({
+    description: 'Configuration ID (UUID)',
+    example: '5e8f9e3b-3b9a-4d9a-9f4b-2a1c1b9e9f1a',
+  })
+  id: string;
+
+  @ApiProperty({
+    description: 'Opening hours slots per day of week (0=Sun..6=Sat)',
+    type: [OpeningHoursSlotDto],
+  })
+  opening_hours: OpeningHoursSlotDto[];
+
+  @ApiProperty({
+    description: 'Campos adicionais de anamnese configurados pela clínica',
+    type: [AnamnesisCustomFieldDto],
+    required: false,
+  })
+  anamnesis_custom_fields?: AnamnesisCustomFieldDto[];
+
+  @ApiProperty({
+    description: 'Creation timestamp',
+    example: '2026-03-10T12:00:00.000Z',
+  })
+  createdAt: Date;
+
+  @ApiProperty({
+    description: 'Last update timestamp',
+    example: '2026-03-10T12:00:00.000Z',
+  })
+  updatedAt: Date;
+}

package/src/configurations/opening-hours-slot.dto.ts

@@ -1,41 +1,41 @@
-import { ApiProperty } from '@nestjs/swagger';
-import { IsNumber, IsString, Matches, Max, Min } from 'class-validator';
-
-/**
- * Day of week: 0 = Sunday, 1 = Monday, ..., 6 = Saturday.
- * open/close: time in HH:mm (24h).
- */
-export class OpeningHoursSlotDto {
-  @ApiProperty({
-    description: 'Day of week (0 = Sunday, 1 = Monday, ..., 6 = Saturday)',
-    example: 1,
-    minimum: 0,
-    maximum: 6,
-  })
-  @IsNumber()
-  @Min(0)
-  @Max(6)
-  dayOfWeek: number;
-
-  @ApiProperty({
-    description: 'Opening time in HH:mm (24h)',
-    example: '08:00',
-    pattern: '^([01]\\d|2[0-3]):([0-5]\\d)$',
-  })
-  @IsString()
-  @Matches(/^([01]\d|2[0-3]):([0-5]\d)$/, {
-    message: 'open must be HH:mm (24h)',
-  })
-  open: string;
-
-  @ApiProperty({
-    description: 'Closing time in HH:mm (24h)',
-    example: '18:00',
-    pattern: '^([01]\\d|2[0-3]):([0-5]\\d)$',
-  })
-  @IsString()
-  @Matches(/^([01]\d|2[0-3]):([0-5]\d)$/, {
-    message: 'close must be HH:mm (24h)',
-  })
-  close: string;
-}
+import { ApiProperty } from '@nestjs/swagger';
+import { IsNumber, IsString, Matches, Max, Min } from 'class-validator';
+
+/**
+ * Day of week: 0 = Sunday, 1 = Monday, ..., 6 = Saturday.
+ * open/close: time in HH:mm (24h).
+ */
+export class OpeningHoursSlotDto {
+  @ApiProperty({
+    description: 'Day of week (0 = Sunday, 1 = Monday, ..., 6 = Saturday)',
+    example: 1,
+    minimum: 0,
+    maximum: 6,
+  })
+  @IsNumber()
+  @Min(0)
+  @Max(6)
+  dayOfWeek: number;
+
+  @ApiProperty({
+    description: 'Opening time in HH:mm (24h)',
+    example: '08:00',
+    pattern: '^([01]\\d|2[0-3]):([0-5]\\d)$',
+  })
+  @IsString()
+  @Matches(/^([01]\d|2[0-3]):([0-5]\d)$/, {
+    message: 'open must be HH:mm (24h)',
+  })
+  open: string;
+
+  @ApiProperty({
+    description: 'Closing time in HH:mm (24h)',
+    example: '18:00',
+    pattern: '^([01]\\d|2[0-3]):([0-5]\\d)$',
+  })
+  @IsString()
+  @Matches(/^([01]\d|2[0-3]):([0-5]\d)$/, {
+    message: 'close must be HH:mm (24h)',
+  })
+  close: string;
+}

package/src/configurations/update-clinic-configuration.dto.ts

@@ -1,39 +1,39 @@
-import { ApiProperty } from '@nestjs/swagger';
-import { Type } from 'class-transformer';
-import {
-  IsArray,
-  IsOptional,
-  ValidateNested,
-} from 'class-validator';
-import { OpeningHoursSlotDto } from './opening-hours-slot.dto';
-import { AnamnesisCustomFieldDto } from './anamnesis-custom-field.dto';
-
-export class UpdateClinicConfigurationDto {
-  @ApiProperty({
-    description: 'Opening hours slots per day of week (0=Sun..6=Sat)',
-    type: [OpeningHoursSlotDto],
-    example: [
-      { dayOfWeek: 1, open: '08:00', close: '18:00' },
-      { dayOfWeek: 2, open: '08:00', close: '18:00' },
-    ],
-  })
-  @IsArray()
-  @ValidateNested({ each: true })
-  @Type(() => OpeningHoursSlotDto)
-  opening_hours: OpeningHoursSlotDto[];
-
-  @ApiProperty({
-    description: 'Campos adicionais de anamnese configurados pela clínica',
-    type: [AnamnesisCustomFieldDto],
-    required: false,
-    example: [
-      { enabled: true, question: 'Qual foi sua última glicemia?', type: 'number' },
-      { enabled: true, question: 'Data do último exame?', type: 'date' },
-    ],
-  })
-  @IsOptional()
-  @IsArray()
-  @ValidateNested({ each: true })
-  @Type(() => AnamnesisCustomFieldDto)
-  anamnesis_custom_fields?: AnamnesisCustomFieldDto[];
-}
+import { ApiProperty } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import {
+  IsArray,
+  IsOptional,
+  ValidateNested,
+} from 'class-validator';
+import { OpeningHoursSlotDto } from './opening-hours-slot.dto';
+import { AnamnesisCustomFieldDto } from './anamnesis-custom-field.dto';
+
+export class UpdateClinicConfigurationDto {
+  @ApiProperty({
+    description: 'Opening hours slots per day of week (0=Sun..6=Sat)',
+    type: [OpeningHoursSlotDto],
+    example: [
+      { dayOfWeek: 1, open: '08:00', close: '18:00' },
+      { dayOfWeek: 2, open: '08:00', close: '18:00' },
+    ],
+  })
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => OpeningHoursSlotDto)
+  opening_hours: OpeningHoursSlotDto[];
+
+  @ApiProperty({
+    description: 'Campos adicionais de anamnese configurados pela clínica',
+    type: [AnamnesisCustomFieldDto],
+    required: false,
+    example: [
+      { enabled: true, question: 'Qual foi sua última glicemia?', type: 'number' },
+      { enabled: true, question: 'Data do último exame?', type: 'date' },
+    ],
+  })
+  @IsOptional()
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => AnamnesisCustomFieldDto)
+  anamnesis_custom_fields?: AnamnesisCustomFieldDto[];
+}