tychat-contracts 1.6.75 → 1.6.76

package/src/appointments/schedule-block-rmq-patterns.ts

@@ -0,0 +1,6 @@
+export const SCHEDULE_BLOCKS_PREVIEW = 'scheduleBlocks.preview';
+export const SCHEDULE_BLOCKS_APPLY = 'scheduleBlocks.apply';
+export const SCHEDULE_BLOCKS_FIND_IN_RANGE = 'scheduleBlocks.findInRange';
+export const SCHEDULE_BLOCKS_REMOVE = 'scheduleBlocks.remove';
+export const SCHEDULE_BLOCKS_EXPIRE_PENDING = 'scheduleBlocks.expirePending';
+export const SCHEDULE_BLOCKS_COMPLETE_RESCHEDULE = 'scheduleBlocks.completeReschedule';

package/src/appointments/schedule-block.dto.ts

@@ -0,0 +1,155 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import {
+  IsArray,
+  IsDateString,
+  IsEnum,
+  IsNotEmpty,
+  IsOptional,
+  IsString,
+  IsUUID,
+  MaxLength,
+  ValidateNested,
+} from 'class-validator';
+
+export class ScheduleBlockIntervalDto {
+  @ApiProperty({ description: 'Início do bloqueio (ISO 8601)', example: '2026-06-15T14:00:00.000Z' })
+  @IsDateString()
+  startAt: string;
+
+  @ApiProperty({ description: 'Fim do bloqueio (ISO 8601)', example: '2026-06-15T16:00:00.000Z' })
+  @IsDateString()
+  endAt: string;
+}
+
+export const SCHEDULE_BLOCK_CONFLICT_ACTIONS = ['cancel', 'ai_reschedule'] as const;
+export type ScheduleBlockConflictActionDto = (typeof SCHEDULE_BLOCK_CONFLICT_ACTIONS)[number];
+
+export class ScheduleBlockConflictActionDtoClass {
+  @ApiProperty({ description: 'ID do agendamento em conflito' })
+  @IsUUID('4')
+  appointmentId: string;
+
+  @ApiProperty({ enum: SCHEDULE_BLOCK_CONFLICT_ACTIONS })
+  @IsEnum(SCHEDULE_BLOCK_CONFLICT_ACTIONS)
+  action: ScheduleBlockConflictActionDto;
+}
+
+export class PreviewScheduleBlockDto {
+  @ApiProperty({ description: 'ID do profissional (userId)' })
+  @IsUUID('4')
+  userId: string;
+
+  @ApiProperty({ type: [ScheduleBlockIntervalDto] })
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => ScheduleBlockIntervalDto)
+  intervals: ScheduleBlockIntervalDto[];
+}
+
+export class ScheduleBlockConflictDto {
+  @ApiProperty()
+  appointmentId: string;
+
+  @ApiProperty()
+  patientId: string;
+
+  @ApiProperty()
+  patientName: string;
+
+  @ApiProperty({ type: [String] })
+  procedureNames: string[];
+
+  @ApiProperty()
+  start: string;
+
+  @ApiProperty()
+  end: string;
+
+  @ApiProperty()
+  status: string;
+}
+
+export class PreviewScheduleBlockResponseDto {
+  @ApiProperty({ type: [ScheduleBlockIntervalDto] })
+  intervals: ScheduleBlockIntervalDto[];
+
+  @ApiProperty({ type: [ScheduleBlockConflictDto] })
+  conflicts: ScheduleBlockConflictDto[];
+}
+
+export class ApplyScheduleBlockDto extends PreviewScheduleBlockDto {
+  @ApiPropertyOptional({ description: 'Motivo opcional do bloqueio', maxLength: 500 })
+  @IsOptional()
+  @IsString()
+  @MaxLength(500)
+  reason?: string;
+
+  @ApiProperty({ description: 'ID do usuário que criou o bloqueio' })
+  @IsUUID('4')
+  createdByUserId: string;
+
+  @ApiPropertyOptional({ type: [ScheduleBlockConflictActionDtoClass] })
+  @IsOptional()
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => ScheduleBlockConflictActionDtoClass)
+  conflictActions?: ScheduleBlockConflictActionDtoClass[];
+}
+
+export class ScheduleBlockDto {
+  @ApiProperty()
+  id: string;
+
+  @ApiProperty()
+  userId: string;
+
+  @ApiProperty()
+  startAt: string;
+
+  @ApiProperty()
+  endAt: string;
+
+  @ApiPropertyOptional()
+  reason?: string | null;
+
+  @ApiProperty()
+  createdByUserId: string;
+
+  @ApiProperty()
+  createdAt: string;
+}
+
+export class ApplyScheduleBlockResponseDto {
+  @ApiProperty({ type: [ScheduleBlockDto] })
+  blocks: ScheduleBlockDto[];
+
+  @ApiProperty({ description: 'IDs de agendamentos cancelados' })
+  cancelledAppointmentIds: string[];
+
+  @ApiProperty({ description: 'IDs de agendamentos com pedido de reagendamento IA iniciado' })
+  aiRescheduleAppointmentIds: string[];
+}
+
+export class FindScheduleBlocksInRangeQueryDto {
+  @ApiProperty()
+  @IsUUID('4')
+  userId: string;
+
+  @ApiProperty({ example: '2026-06-01' })
+  @IsDateString()
+  startDate: string;
+
+  @ApiProperty({ example: '2026-06-30' })
+  @IsDateString()
+  endDate: string;
+}
+
+export const SCHEDULE_BLOCK_RESCHEDULE_STATUSES = [
+  'pending_patient',
+  'confirmed',
+  'expired',
+  'cancelled',
+] as const;
+export type ScheduleBlockRescheduleStatusDto =
+  (typeof SCHEDULE_BLOCK_RESCHEDULE_STATUSES)[number];

package/src/campaigns/campaign-template-header-media.dto.ts

@@ -1,25 +1,25 @@
-/** Formato do header de template oficial (Meta Cloud API). */
-export type TemplateHeaderFormatDto = 'TEXT' | 'IMAGE' | 'VIDEO' | 'DOCUMENT';
-
-/** Resposta do upload de mídia para header de template (Meta + storage opcional). */
-export interface UploadTemplateHeaderMediaResponseDto {
-  headerHandle: string;
-  messagingMediaId: string;
-  mimeType: string;
-  sizeBytes: number;
-  /** URL pública opcional persistida no storage da plataforma. */
-  previewUrl?: string;
-}
-
-/** URL temporária da Meta (GET /{media-id}) para pré-visualização. */
-export interface TemplateHeaderMediaPreviewUrlResponseDto {
-  mediaId: string;
-  url: string;
-  mimeType: string;
-}
-
-/** Bytes da mídia de header para proxy de pré-visualização. */
-export interface TemplateHeaderMediaPreviewBinaryResponseDto {
-  mimeType: string;
-  fileBase64: string;
-}
+/** Formato do header de template oficial (Meta Cloud API). */
+export type TemplateHeaderFormatDto = 'TEXT' | 'IMAGE' | 'VIDEO' | 'DOCUMENT';
+
+/** Resposta do upload de mídia para header de template (Meta + storage opcional). */
+export interface UploadTemplateHeaderMediaResponseDto {
+  headerHandle: string;
+  messagingMediaId: string;
+  mimeType: string;
+  sizeBytes: number;
+  /** URL pública opcional persistida no storage da plataforma. */
+  previewUrl?: string;
+}
+
+/** URL temporária da Meta (GET /{media-id}) para pré-visualização. */
+export interface TemplateHeaderMediaPreviewUrlResponseDto {
+  mediaId: string;
+  url: string;
+  mimeType: string;
+}
+
+/** Bytes da mídia de header para proxy de pré-visualização. */
+export interface TemplateHeaderMediaPreviewBinaryResponseDto {
+  mimeType: string;
+  fileBase64: string;
+}

package/src/campaigns/campaign-template.dto.ts

@@ -1,45 +1,45 @@
-import type { TemplateCategoryDto, TemplateMetaStatusDto } from './campaign-status.dto';
-import type { TemplateHeaderFormatDto } from './campaign-template-header-media.dto';
-
-export type { TemplateHeaderFormatDto };
-
-export interface CampaignTemplateDto {
-  id: string;
-  tenantId: string;
-  name: string;
-  languageCode: string;
-  category: TemplateCategoryDto | null;
-  metaTemplateName: string | null;
-  metaTemplateId: string | null;
-  metaStatus: TemplateMetaStatusDto | null;
-  headerText: string | null;
-  headerFormat?: TemplateHeaderFormatDto | null;
-  headerMediaHandle?: string | null;
-  headerMediaId?: string | null;
-  headerMediaPreviewUrl?: string | null;
-  bodyText: string;
-  footerText: string | null;
-  buttons: Record<string, unknown>[] | null;
-  isOfficial: boolean;
-  metaSyncedAt: string | null;
-  createdAt: string;
-  updatedAt: string;
-}
-
-export interface CampaignTemplateListResponseDto {
-  items: CampaignTemplateDto[];
-}
-
-export interface TemplateVariablePreviewDto {
-  variableName: string;
-  sampleValue: string;
-}
-
-export interface TemplatePreviewRequestDto {
-  bodyText: string;
-  variables: TemplateVariablePreviewDto[];
-}
-
-export interface TemplatePreviewResponseDto {
-  previewText: string;
-}
+import type { TemplateCategoryDto, TemplateMetaStatusDto } from './campaign-status.dto';
+import type { TemplateHeaderFormatDto } from './campaign-template-header-media.dto';
+
+export type { TemplateHeaderFormatDto };
+
+export interface CampaignTemplateDto {
+  id: string;
+  tenantId: string;
+  name: string;
+  languageCode: string;
+  category: TemplateCategoryDto | null;
+  metaTemplateName: string | null;
+  metaTemplateId: string | null;
+  metaStatus: TemplateMetaStatusDto | null;
+  headerText: string | null;
+  headerFormat?: TemplateHeaderFormatDto | null;
+  headerMediaHandle?: string | null;
+  headerMediaId?: string | null;
+  headerMediaPreviewUrl?: string | null;
+  bodyText: string;
+  footerText: string | null;
+  buttons: Record<string, unknown>[] | null;
+  isOfficial: boolean;
+  metaSyncedAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface CampaignTemplateListResponseDto {
+  items: CampaignTemplateDto[];
+}
+
+export interface TemplateVariablePreviewDto {
+  variableName: string;
+  sampleValue: string;
+}
+
+export interface TemplatePreviewRequestDto {
+  bodyText: string;
+  variables: TemplateVariablePreviewDto[];
+}
+
+export interface TemplatePreviewResponseDto {
+  previewText: string;
+}

package/src/campaigns/create-campaign.dto.ts

@@ -1,80 +1,80 @@
-import type { TemplateCategoryDto } from './campaign-status.dto';
-import type { TemplateHeaderFormatDto } from './campaign-template-header-media.dto';
-
-export type { TemplateHeaderFormatDto };
-
-export interface CreateCampaignRequestDto {
-  name: string;
-  templateId?: string;
-  isOfficial?: boolean;
-  audienceFilters?: Record<string, unknown>[];
-  delayBetweenSendsMs?: number;
-  scheduledAt?: string;
-}
-
-export interface UpdateCampaignRequestDto {
-  name?: string;
-  templateId?: string;
-  audienceFilters?: Record<string, unknown>[];
-  delayBetweenSendsMs?: number;
-  scheduledAt?: string;
-}
-
-export interface CreateCampaignTemplateRequestDto {
-  name: string;
-  languageCode?: string;
-  category?: TemplateCategoryDto;
-  bodyText: string;
-  headerText?: string;
-  headerFormat?: TemplateHeaderFormatDto;
-  headerMediaHandle?: string;
-  /** Numeric Meta messaging media id from header upload (required to send media headers). */
-  headerMediaId?: string;
-  headerMediaPreviewUrl?: string;
-  headerMediaMimeType?: string;
-  headerMediaSizeBytes?: number;
-  footerText?: string;
-  isOfficial?: boolean;
-  buttons?: Record<string, unknown>[];
-}
-
-export interface StartCampaignRequestDto {
-  campaignId: string;
-}
-
-export interface PauseCampaignRequestDto {
-  campaignId: string;
-}
-
-export interface ResumeCampaignRequestDto {
-  campaignId: string;
-}
-
-export interface CancelCampaignRequestDto {
-  campaignId: string;
-  reason?: string;
-}
-
-export interface ConfirmCampaignPaymentRequestDto {
-  campaignId: string;
-  billingId: string;
-}
-
-export interface PopulateRecipientsRequestDto {
-  campaignId: string;
-}
-
-export interface PopulateRecipientsResponseDto {
-  count: number;
-}
-
-export interface CampaignCostEstimateRequestDto {
-  campaignId: string;
-}
-
-export interface CampaignCostEstimateResponseDto {
-  totalRecipients: number;
-  costPerMessageCents: number;
-  estimatedTotalCents: number;
-  category: TemplateCategoryDto;
-}
+import type { TemplateCategoryDto } from './campaign-status.dto';
+import type { TemplateHeaderFormatDto } from './campaign-template-header-media.dto';
+
+export type { TemplateHeaderFormatDto };
+
+export interface CreateCampaignRequestDto {
+  name: string;
+  templateId?: string;
+  isOfficial?: boolean;
+  audienceFilters?: Record<string, unknown>[];
+  delayBetweenSendsMs?: number;
+  scheduledAt?: string;
+}
+
+export interface UpdateCampaignRequestDto {
+  name?: string;
+  templateId?: string;
+  audienceFilters?: Record<string, unknown>[];
+  delayBetweenSendsMs?: number;
+  scheduledAt?: string;
+}
+
+export interface CreateCampaignTemplateRequestDto {
+  name: string;
+  languageCode?: string;
+  category?: TemplateCategoryDto;
+  bodyText: string;
+  headerText?: string;
+  headerFormat?: TemplateHeaderFormatDto;
+  headerMediaHandle?: string;
+  /** Numeric Meta messaging media id from header upload (required to send media headers). */
+  headerMediaId?: string;
+  headerMediaPreviewUrl?: string;
+  headerMediaMimeType?: string;
+  headerMediaSizeBytes?: number;
+  footerText?: string;
+  isOfficial?: boolean;
+  buttons?: Record<string, unknown>[];
+}
+
+export interface StartCampaignRequestDto {
+  campaignId: string;
+}
+
+export interface PauseCampaignRequestDto {
+  campaignId: string;
+}
+
+export interface ResumeCampaignRequestDto {
+  campaignId: string;
+}
+
+export interface CancelCampaignRequestDto {
+  campaignId: string;
+  reason?: string;
+}
+
+export interface ConfirmCampaignPaymentRequestDto {
+  campaignId: string;
+  billingId: string;
+}
+
+export interface PopulateRecipientsRequestDto {
+  campaignId: string;
+}
+
+export interface PopulateRecipientsResponseDto {
+  count: number;
+}
+
+export interface CampaignCostEstimateRequestDto {
+  campaignId: string;
+}
+
+export interface CampaignCostEstimateResponseDto {
+  totalRecipients: number;
+  costPerMessageCents: number;
+  estimatedTotalCents: number;
+  category: TemplateCategoryDto;
+}

package/src/fiscal/enqueue-nfe.dto.ts

@@ -1,15 +1,5 @@
 import { ApiPropertyOptional } from '@nestjs/swagger';
-import {
-  IsIn,
-  IsInt,
-  IsNotEmpty,
-  IsObject,
-  IsOptional,
-  IsString,
-  IsUUID,
-  Max,
-  Min,
-} from 'class-validator';
+import { IsIn, IsInt, IsNotEmpty, IsObject, IsOptional, IsString, Max, Min } from 'class-validator';
 
 export const FISCAL_DOCUMENT_TYPES = ['nfe', 'nfce', 'nfse'] as const;
 export type FiscalDocumentType = (typeof FISCAL_DOCUMENT_TYPES)[number];
@@ -43,11 +33,6 @@ export class EnqueueNfeDto {
   @IsString()
   @IsOptional()
   referenceId?: string;
-
-  @ApiPropertyOptional({ description: 'Paciente vinculado (UUID)' })
-  @IsOptional()
-  @IsUUID()
-  patientId?: string;
 }
 
 export class ListFiscalDocumentsQueryDto {
@@ -66,11 +51,6 @@ export class ListFiscalDocumentsQueryDto {
   @IsString()
   referenceId?: string;
 
-  @ApiPropertyOptional({ description: 'Busca por paciente (UUID)' })
-  @IsOptional()
-  @IsUUID()
-  patientId?: string;
-
   @ApiPropertyOptional({ description: 'Busca por ACBR ID (parcial ou completo)' })
   @IsOptional()
   @IsString()
@@ -105,7 +85,6 @@ export type FiscalDocumentListItemDto = {
   documentType: FiscalDocumentType;
   companyCpfCnpj: string;
   referenceId: string | null;
-  patientId: string | null;
   acbrId: string | null;
   status: FiscalDocumentStatusDto;
   lastError: string | null;

package/src/fiscal/fiscal-rmq-patterns.ts

@@ -15,7 +15,6 @@ export const FISCAL_COMPANIES_NFSE_CONFIG_PUT =
   'fiscal.companies.nfse_config.put';
 export const FISCAL_COMPANIES_SETTINGS_GET = 'fiscal.companies.settings.get';
 export const FISCAL_COMPANIES_SETTINGS_PUT = 'fiscal.companies.settings.put';
-export const FISCAL_CEP_GET = 'fiscal.cep.get';
 
 export const FISCAL_DOCUMENTS_ENQUEUE = 'fiscal.documents.enqueue';
 export const FISCAL_DOCUMENTS_LIST = 'fiscal.documents.list';

package/src/patients/index.ts

@@ -1,10 +1,10 @@
-export * from './create-patient.dto';
-export * from './update-patient.dto';
-export * from './patient-history-entry.dto';
-export * from './list-patients-query.dto';
-export * from './list-patients-filters.dto';
-export * from './upsert-patient-by-phone.dto';
-export * from './patient-status.dto';
-export * from './patient-document-response.dto';
-export * from './update-patient-document.dto';
-
+export * from './create-patient.dto';
+export * from './update-patient.dto';
+export * from './patient-history-entry.dto';
+export * from './list-patients-query.dto';
+export * from './list-patients-filters.dto';
+export * from './upsert-patient-by-phone.dto';
+export * from './patient-status.dto';
+export * from './patient-document-response.dto';
+export * from './update-patient-document.dto';
+

package/src/tenants/anamnesis-public-frontend-url.spec.ts

@@ -1,45 +1,45 @@
-import {
-  hostnameMatchesTenantSlug,
-  resolveTenantScopedFrontendBaseUrl,
-} from './anamnesis-public-frontend-url';
-
-describe('resolveTenantScopedFrontendBaseUrl', () => {
-  it('keeps tenant-specific tychat.app host', () => {
-    expect(
-      resolveTenantScopedFrontendBaseUrl(
-        'clinica_sampaio',
-        'https://clinica-sampaio.tychat.app',
-      ),
-    ).toBe('https://clinica-sampaio.tychat.app');
-  });
-
-  it('scopes shared QA host with tenant subdomain', () => {
-    expect(
-      resolveTenantScopedFrontendBaseUrl('clinica_sampaio', 'https://qa.tychat.app'),
-    ).toBe('https://clinica-sampaio.qa.tychat.app');
-  });
-
-  it('keeps custom domain unchanged', () => {
-    expect(
-      resolveTenantScopedFrontendBaseUrl(
-        'clinica_sampaio',
-        'https://app.minhaclinica.com.br',
-      ),
-    ).toBe('https://app.minhaclinica.com.br');
-  });
-
-  it('uses slug fallback when host is empty', () => {
-    expect(resolveTenantScopedFrontendBaseUrl('homolog', '')).toBe(
-      'https://homolog.tychat.app',
-    );
-  });
-});
-
-describe('hostnameMatchesTenantSlug', () => {
-  it('matches first DNS label to slug segment', () => {
-    expect(hostnameMatchesTenantSlug('clinica-sampaio.qa.tychat.app', 'clinica_sampaio')).toBe(
-      true,
-    );
-    expect(hostnameMatchesTenantSlug('qa.tychat.app', 'clinica_sampaio')).toBe(false);
-  });
-});
+import {
+  hostnameMatchesTenantSlug,
+  resolveTenantScopedFrontendBaseUrl,
+} from './anamnesis-public-frontend-url';
+
+describe('resolveTenantScopedFrontendBaseUrl', () => {
+  it('keeps tenant-specific tychat.app host', () => {
+    expect(
+      resolveTenantScopedFrontendBaseUrl(
+        'clinica_sampaio',
+        'https://clinica-sampaio.tychat.app',
+      ),
+    ).toBe('https://clinica-sampaio.tychat.app');
+  });
+
+  it('scopes shared QA host with tenant subdomain', () => {
+    expect(
+      resolveTenantScopedFrontendBaseUrl('clinica_sampaio', 'https://qa.tychat.app'),
+    ).toBe('https://clinica-sampaio.qa.tychat.app');
+  });
+
+  it('keeps custom domain unchanged', () => {
+    expect(
+      resolveTenantScopedFrontendBaseUrl(
+        'clinica_sampaio',
+        'https://app.minhaclinica.com.br',
+      ),
+    ).toBe('https://app.minhaclinica.com.br');
+  });
+
+  it('uses slug fallback when host is empty', () => {
+    expect(resolveTenantScopedFrontendBaseUrl('homolog', '')).toBe(
+      'https://homolog.tychat.app',
+    );
+  });
+});
+
+describe('hostnameMatchesTenantSlug', () => {
+  it('matches first DNS label to slug segment', () => {
+    expect(hostnameMatchesTenantSlug('clinica-sampaio.qa.tychat.app', 'clinica_sampaio')).toBe(
+      true,
+    );
+    expect(hostnameMatchesTenantSlug('qa.tychat.app', 'clinica_sampaio')).toBe(false);
+  });
+});