tychat-contracts 1.6.7 → 1.6.9

package/src/configurations/configuration-tenant-summary.dto.ts

@@ -1,79 +1,79 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { TenantAiTokenStateDto } from '../tenants/tenant-ai-token-state.dto';
-import { EffectiveAppModulePolicyDto } from './app-module-policy.dto';
-import { PlanSummaryDto } from './plan-summary.dto';
-import { TenantLimitsSummaryDto } from './tenant-limits-summary.dto';
-import { TenantStorageUsageSummaryDto } from './tenant-storage-usage-summary.dto';
-
-/**
- * Tenant branding and subscription info returned with clinic configuration (no DB credentials).
- */
-export class ConfigurationTenantSummaryDto {
-  @ApiProperty({ description: 'Tenant display name', example: 'Clínica Demo' })
-  name: string;
-
-  @ApiProperty({ description: 'CNPJ', example: '12345678000199' })
-  cnpj: string;
-
-  @ApiPropertyOptional({ description: 'Location / address', nullable: true })
-  location: string | null;
-
-  @ApiPropertyOptional({ description: 'Logo URL (light background)', nullable: true })
-  logoWhite: string | null;
-
-  @ApiPropertyOptional({ description: 'Logo URL (dark background)', nullable: true })
-  logoDark: string | null;
-
-  @ApiProperty({ description: 'Tenant status', enum: ['active', 'inactive'] })
-  status: 'active' | 'inactive';
-
-  @ApiPropertyOptional({
-    description: 'Subscription plan',
-    type: () => PlanSummaryDto,
-    nullable: true,
-  })
-  plan: PlanSummaryDto | null;
-
-  @ApiPropertyOptional({
-    description: 'Per-tenant limit overrides',
-    type: () => TenantLimitsSummaryDto,
-    nullable: true,
-  })
-  limits: TenantLimitsSummaryDto | null;
-
-  @ApiPropertyOptional({
-    description: 'Uso acumulado por tipo (bytes como string)',
-    type: () => TenantStorageUsageSummaryDto,
-    nullable: true,
-  })
-  storageUsage: TenantStorageUsageSummaryDto | null;
-
-  @ApiPropertyOptional({
-    description: 'Saldo e cota de tokens de IA no ciclo atual',
-    type: () => TenantAiTokenStateDto,
-    nullable: true,
-  })
-  aiTokenState?: TenantAiTokenStateDto | null;
-
-  @ApiPropertyOptional({ description: 'Limite efetivo de conversas em bytes (plano + extras)' })
-  conversationEffectiveLimitBytes?: string;
-
-  @ApiPropertyOptional({ description: 'Limite efetivo clínico em bytes (plano + extras)' })
-  clinicEffectiveLimitBytes?: string;
-
-  @ApiPropertyOptional({
-    description: 'Valor mensal estimado pelos GB extras de armazenamento (soma dos dois tipos)',
-  })
-  extraStorageCharge?: number;
-
-  @ApiPropertyOptional({
-    description: 'Preço base do plano + extraStorageCharge',
-  })
-  effectivePlanPrice?: number;
-
-  @ApiPropertyOptional({
-    description: 'Módulos do app liberados para o tenant (resolução plano + override)',
-    type: () => [EffectiveAppModulePolicyDto],
-  })
-  appModules?: EffectiveAppModulePolicyDto[];
-}
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { TenantAiTokenStateDto } from '../tenants/tenant-ai-token-state.dto';
+import { EffectiveAppModulePolicyDto } from './app-module-policy.dto';
+import { PlanSummaryDto } from './plan-summary.dto';
+import { TenantLimitsSummaryDto } from './tenant-limits-summary.dto';
+import { TenantStorageUsageSummaryDto } from './tenant-storage-usage-summary.dto';
+
+/**
+ * Tenant branding and subscription info returned with clinic configuration (no DB credentials).
+ */
+export class ConfigurationTenantSummaryDto {
+  @ApiProperty({ description: 'Tenant display name', example: 'Clínica Demo' })
+  name: string;
+
+  @ApiProperty({ description: 'CNPJ', example: '12345678000199' })
+  cnpj: string;
+
+  @ApiPropertyOptional({ description: 'Location / address', nullable: true })
+  location: string | null;
+
+  @ApiPropertyOptional({ description: 'Logo URL (light background)', nullable: true })
+  logoWhite: string | null;
+
+  @ApiPropertyOptional({ description: 'Logo URL (dark background)', nullable: true })
+  logoDark: string | null;
+
+  @ApiProperty({ description: 'Tenant status', enum: ['active', 'inactive'] })
+  status: 'active' | 'inactive';
+
+  @ApiPropertyOptional({
+    description: 'Subscription plan',
+    type: () => PlanSummaryDto,
+    nullable: true,
+  })
+  plan: PlanSummaryDto | null;
+
+  @ApiPropertyOptional({
+    description: 'Per-tenant limit overrides',
+    type: () => TenantLimitsSummaryDto,
+    nullable: true,
+  })
+  limits: TenantLimitsSummaryDto | null;
+
+  @ApiPropertyOptional({
+    description: 'Uso acumulado por tipo (bytes como string)',
+    type: () => TenantStorageUsageSummaryDto,
+    nullable: true,
+  })
+  storageUsage: TenantStorageUsageSummaryDto | null;
+
+  @ApiPropertyOptional({
+    description: 'Saldo e cota de tokens de IA no ciclo atual',
+    type: () => TenantAiTokenStateDto,
+    nullable: true,
+  })
+  aiTokenState?: TenantAiTokenStateDto | null;
+
+  @ApiPropertyOptional({ description: 'Limite efetivo de conversas em bytes (plano + extras)' })
+  conversationEffectiveLimitBytes?: string;
+
+  @ApiPropertyOptional({ description: 'Limite efetivo clínico em bytes (plano + extras)' })
+  clinicEffectiveLimitBytes?: string;
+
+  @ApiPropertyOptional({
+    description: 'Valor mensal estimado pelos GB extras de armazenamento (soma dos dois tipos)',
+  })
+  extraStorageCharge?: number;
+
+  @ApiPropertyOptional({
+    description: 'Preço base do plano + extraStorageCharge',
+  })
+  effectivePlanPrice?: number;
+
+  @ApiPropertyOptional({
+    description: 'Módulos do app liberados para o tenant (resolução plano + override)',
+    type: () => [EffectiveAppModulePolicyDto],
+  })
+  appModules?: EffectiveAppModulePolicyDto[];
+}

package/src/configurations/index.ts

@@ -1,13 +1,13 @@
-export * from './opening-hours-slot.dto';
-export * from './anamnesis-custom-field.dto';
-export * from './update-clinic-configuration.dto';
-export * from './clinic-configuration.dto';
-export * from './ai-tool-policy.enums';
-export * from './ai-tool-policy.dto';
-export * from './app-module-policy.enums';
-export * from './app-module-policy.dto';
-export * from './plan-summary.dto';
-export * from './tenant-limits-summary.dto';
-export * from './tenant-storage-usage-summary.dto';
-export * from './configuration-tenant-summary.dto';
-export * from './clinic-configuration-with-tenant.dto';
+export * from './opening-hours-slot.dto';
+export * from './anamnesis-custom-field.dto';
+export * from './update-clinic-configuration.dto';
+export * from './clinic-configuration.dto';
+export * from './ai-tool-policy.enums';
+export * from './ai-tool-policy.dto';
+export * from './app-module-policy.enums';
+export * from './app-module-policy.dto';
+export * from './plan-summary.dto';
+export * from './tenant-limits-summary.dto';
+export * from './tenant-storage-usage-summary.dto';
+export * from './configuration-tenant-summary.dto';
+export * from './clinic-configuration-with-tenant.dto';

package/src/legal-terms/legal-term-dispatch.dto.ts

@@ -7,7 +7,17 @@ export type SignatureDocumentStatusValue =
   | 'signed'
   | 'refused'
   | 'cancelled'
-  | 'expired';
+  | 'expired'
+  /** Fluxo impresso: aguardando upload da digitalização assinada (sem registro em signature-service). */
+  | 'upload_required';
+
+/** Método de assinatura escolhido no envio do termo. */
+export type LegalTermSignatureMethodValue = 'digital' | 'printed';
+
+/** Política por tenant (admin): quais métodos o produto oferece. */
+export type LegalTermSignaturePolicyValue =
+  | 'printed_only'
+  | 'printed_and_integrations';
 
 /** Item agregado para a ficha do paciente (API: clinic + signature). */
 export type PatientLegalTermDispatchItemDto = {
@@ -17,6 +27,7 @@ export type PatientLegalTermDispatchItemDto = {
   procedure_names: string[];
   dispatch_status: LegalTermDispatchStatusValue;
   error_code: string | null;
+  signature_method: LegalTermSignatureMethodValue;
   signature_document_id: string | null;
   signature_status: SignatureDocumentStatusValue | null;
   signed_at: string | null;

package/src/legal-terms/legal-term-preview.dto.ts

@@ -14,6 +14,9 @@ import {
 } from 'class-validator';
 import { LEGAL_TERM_BODY_FORMATS, type LegalTermBodyFormat } from './legal-term-body-format';
 
+const LEGAL_TERM_SIGNATURE_METHODS = ['digital', 'printed'] as const;
+export type LegalTermSignatureMethodDto = (typeof LEGAL_TERM_SIGNATURE_METHODS)[number];
+
 /** Valores explícitos para substituição na pré-visualização (sem inferência heurística). */
 export class LegalTermPreviewRequestDto {
   @ApiPropertyOptional({
@@ -69,13 +72,24 @@ export class LegalTermPreviewRequestDto {
 }
 
 export class LegalTermSendDto {
+  @ApiPropertyOptional({
+    enum: LEGAL_TERM_SIGNATURE_METHODS,
+    description:
+      'Método de assinatura: digital (Clicksign + link no WhatsApp) ou printed (PDF para impressão, sem Clicksign). Padrão: digital.',
+    default: 'digital',
+  })
+  @IsOptional()
+  @IsIn(LEGAL_TERM_SIGNATURE_METHODS)
+  signatureMethod?: LegalTermSignatureMethodDto;
+
   @ApiProperty({ type: [String], format: 'uuid' })
   @IsArray()
   @IsUUID('4', { each: true })
   procedureIds: string[];
 
   @ApiProperty({
-    description: 'Mensagem WhatsApp; deve conter exatamente {{ link_termo_juridico }}',
+    description:
+      'Mensagem WhatsApp. Com signatureMethod digital (padrão), deve conter exatamente {{ link_termo_juridico }}. Com printed, qualquer texto (sem esse placeholder).',
     example: 'Olá, assine seu termo: {{ link_termo_juridico }}',
   })
   @IsString()
@@ -129,4 +143,15 @@ export class LegalTermSendDto {
   @MinLength(11)
   @MaxLength(14)
   tenantSignerDocumentation?: string;
+
+  @ApiPropertyOptional({
+    description:
+      'Celular do representante (BR) para Clicksign notificar via WhatsApp; opcional (sem isso a Clicksign usa e-mail).',
+  })
+  @ValidateIf((o: LegalTermSendDto) => o.tenantAutoSign === true)
+  @IsOptional()
+  @IsString()
+  @MinLength(8)
+  @MaxLength(32)
+  tenantSignerPhone?: string;
 }

package/src/legal-terms/legal-term-signature-rpc.dto.ts

@@ -41,6 +41,16 @@ export class CreateLegalSigningEnvelopeRpcDto {
   @MaxLength(320)
   signerEmail: string;
 
+  @ApiPropertyOptional({
+    description:
+      'Telefone do paciente (BR) para Clicksign: com WhatsApp em `document_signed` exige 10–11 dígitos nacionais; normalizado no signature-service.',
+  })
+  @IsOptional()
+  @IsString()
+  @MinLength(8)
+  @MaxLength(32)
+  signerPhone?: string;
+
   @ApiPropertyOptional({ description: 'PDF em base64 (sem prefixo data:); omitir se enviar renderedHtml' })
   @ValidateIf((o: CreateLegalSigningEnvelopeRpcDto) => !o.renderedHtml?.trim())
   @IsString()
@@ -111,6 +121,17 @@ export class CreateLegalSigningEnvelopeRpcDto {
   @MinLength(11)
   @MaxLength(14)
   tenantSignerDocumentation?: string;
+
+  @ApiPropertyOptional({
+    description:
+      'Celular do representante (BR) para notificação Clicksign via WhatsApp após assinatura; se omitido, usa-se e-mail.',
+  })
+  @ValidateIf((o: CreateLegalSigningEnvelopeRpcDto) => o.tenantAutoSign === true)
+  @IsOptional()
+  @IsString()
+  @MinLength(8)
+  @MaxLength(32)
+  tenantSignerPhone?: string;
 }
 
 export class CreateLegalSigningEnvelopeRpcResultDto {

package/src/storage/presign-download-rpc.dto.ts

@@ -1,38 +1,38 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { IsInt, IsOptional, IsString, Max, MaxLength, Min, MinLength } from 'class-validator';
-
-/** RMQ: `tychat-api` pede URL presigned GET após validar o documento no patient-service (confiança interna). */
-export class PresignDownloadRpcDto {
-  @ApiProperty({ description: 'Tenant slug (deve corresponder ao prefixo do objectKey)', example: 'clinica_sampaio' })
-  @IsString()
-  @MinLength(1)
-  @MaxLength(255)
-  tenantSlug: string;
-
-  @ApiProperty({ description: 'Chave S3 do objeto', example: 'tenants/clinica_sampaio/patients/.../doc.pdf' })
-  @IsString()
-  @MinLength(1)
-  @MaxLength(2048)
-  objectKey: string;
-
-  @ApiPropertyOptional({
-    description: 'TTL da URL em segundos (60–3600; predefinido no storage)',
-    example: 300,
-  })
-  @IsOptional()
-  @IsInt()
-  @Min(60)
-  @Max(3600)
-  expiresInSeconds?: number;
-}
-
-export class PresignDownloadRpcResultDto {
-  @ApiProperty({ description: 'URL GET presigned' })
-  url: string;
-
-  @ApiProperty({ description: 'Unix timestamp (ms) quando a URL expira' })
-  expiresAt: number;
-
-  @ApiProperty({ description: 'TTL em segundos' })
-  expiresInSeconds: number;
-}
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsInt, IsOptional, IsString, Max, MaxLength, Min, MinLength } from 'class-validator';
+
+/** RMQ: `tychat-api` pede URL presigned GET após validar o documento no patient-service (confiança interna). */
+export class PresignDownloadRpcDto {
+  @ApiProperty({ description: 'Tenant slug (deve corresponder ao prefixo do objectKey)', example: 'clinica_sampaio' })
+  @IsString()
+  @MinLength(1)
+  @MaxLength(255)
+  tenantSlug: string;
+
+  @ApiProperty({ description: 'Chave S3 do objeto', example: 'tenants/clinica_sampaio/patients/.../doc.pdf' })
+  @IsString()
+  @MinLength(1)
+  @MaxLength(2048)
+  objectKey: string;
+
+  @ApiPropertyOptional({
+    description: 'TTL da URL em segundos (60–3600; predefinido no storage)',
+    example: 300,
+  })
+  @IsOptional()
+  @IsInt()
+  @Min(60)
+  @Max(3600)
+  expiresInSeconds?: number;
+}
+
+export class PresignDownloadRpcResultDto {
+  @ApiProperty({ description: 'URL GET presigned' })
+  url: string;
+
+  @ApiProperty({ description: 'Unix timestamp (ms) quando a URL expira' })
+  expiresAt: number;
+
+  @ApiProperty({ description: 'TTL em segundos' })
+  expiresInSeconds: number;
+}

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

@@ -1,5 +1,5 @@
-/** Pedido de token OTT para HTTP POST /storage/presign-upload */
-export const STORAGE_ISSUE_UPLOAD_TOKEN = 'storage.issueUploadToken';
-
-/** URL presigned GET (chamada interna; sem JWT HTTP para o storage) */
-export const STORAGE_PRESIGN_DOWNLOAD = 'storage.presignDownload';
+/** Pedido de token OTT para HTTP POST /storage/presign-upload */
+export const STORAGE_ISSUE_UPLOAD_TOKEN = 'storage.issueUploadToken';
+
+/** URL presigned GET (chamada interna; sem JWT HTTP para o storage) */
+export const STORAGE_PRESIGN_DOWNLOAD = 'storage.presignDownload';