tychat-contracts 1.6.8 → 1.6.9

package/src/auth/request-password-reset-response.dto.ts

@@ -1,26 +1,26 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-
-/**
- * Resposta de `POST /auth/password-reset/request`.
- * - Sem utilizador ou utilizador sem 2FA: apenas mensagem genérica (e e-mail com senha provisória se existir conta sem 2FA).
- * - Utilizador com 2FA: inclui token para o passo seguinte (`finalize-2fa`).
- */
-export class RequestPasswordResetResponseDto {
-  @ApiProperty({ example: true })
-  success: boolean;
-
-  @ApiProperty({
-    description: 'Mensagem genérica (não revela se o e-mail existe, exceto quando two_factor_required é true)',
-  })
-  message: string;
-
-  @ApiPropertyOptional({
-    description: 'Presente quando o e-mail existe e o utilizador tem 2FA ativo',
-  })
-  two_factor_required?: boolean;
-
-  @ApiPropertyOptional({
-    description: 'JWT de curta duração para `POST /auth/password-reset/finalize-2fa`',
-  })
-  pre_recovery_token?: string;
-}
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+
+/**
+ * Resposta de `POST /auth/password-reset/request`.
+ * - Sem utilizador ou utilizador sem 2FA: apenas mensagem genérica (e e-mail com senha provisória se existir conta sem 2FA).
+ * - Utilizador com 2FA: inclui token para o passo seguinte (`finalize-2fa`).
+ */
+export class RequestPasswordResetResponseDto {
+  @ApiProperty({ example: true })
+  success: boolean;
+
+  @ApiProperty({
+    description: 'Mensagem genérica (não revela se o e-mail existe, exceto quando two_factor_required é true)',
+  })
+  message: string;
+
+  @ApiPropertyOptional({
+    description: 'Presente quando o e-mail existe e o utilizador tem 2FA ativo',
+  })
+  two_factor_required?: boolean;
+
+  @ApiPropertyOptional({
+    description: 'JWT de curta duração para `POST /auth/password-reset/finalize-2fa`',
+  })
+  pre_recovery_token?: string;
+}

package/src/auth/revoke-device-session.dto.ts

@@ -1,19 +1,19 @@
-import { ApiPropertyOptional } from '@nestjs/swagger';
-import { IsOptional, IsString, MaxLength, MinLength } from 'class-validator';
-
-/** Corpo de `POST /device-sessions/:id/revoke` — confirma identidade antes do logout remoto. */
-export class RevokeDeviceSessionDto {
-  @ApiPropertyOptional({ description: 'Senha atual (obrigatória se 2FA não estiver ativo)' })
-  @IsOptional()
-  @IsString()
-  @MinLength(1)
-  @MaxLength(255)
-  password?: string;
-
-  @ApiPropertyOptional({ description: 'Código TOTP de 6 dígitos (obrigatório se 2FA estiver ativo)' })
-  @IsOptional()
-  @IsString()
-  @MinLength(6)
-  @MaxLength(6)
-  totp?: string;
-}
+import { ApiPropertyOptional } from '@nestjs/swagger';
+import { IsOptional, IsString, MaxLength, MinLength } from 'class-validator';
+
+/** Corpo de `POST /device-sessions/:id/revoke` — confirma identidade antes do logout remoto. */
+export class RevokeDeviceSessionDto {
+  @ApiPropertyOptional({ description: 'Senha atual (obrigatória se 2FA não estiver ativo)' })
+  @IsOptional()
+  @IsString()
+  @MinLength(1)
+  @MaxLength(255)
+  password?: string;
+
+  @ApiPropertyOptional({ description: 'Código TOTP de 6 dígitos (obrigatório se 2FA estiver ativo)' })
+  @IsOptional()
+  @IsString()
+  @MinLength(6)
+  @MaxLength(6)
+  totp?: string;
+}

package/src/auth/totp-user.dto.ts

@@ -1,58 +1,58 @@
-import { ApiProperty } from '@nestjs/swagger';
-import { IsString, Matches, MaxLength, MinLength, ValidateIf } from 'class-validator';
-
-export class TotpSetupConfirmDto {
-  @ApiProperty({ description: 'Código TOTP de 6 dígitos para confirmar o pareamento' })
-  @IsString()
-  @Matches(/^\d{6}$/, { message: 'totp deve ser exatamente 6 dígitos' })
-  totp: string;
-}
-
-/** Resposta após confirmar o 2FA: códigos de recuperação mostrados uma única vez. */
-export class TotpSetupConfirmResponseDto {
-  @ApiProperty({ description: 'Confirmação de sucesso' })
-  success: true;
-
-  @ApiProperty({
-    type: [String],
-    description:
-      'Seis códigos de recuperação (hex, 10 caracteres). Guardar em local seguro; não serão repetidos pela API.',
-  })
-  recovery_codes: string[];
-}
-
-export class TotpDisableDto {
-  @ApiProperty({ description: 'Senha atual do utilizador' })
-  @IsString()
-  @MinLength(1, { message: 'current_password não pode ser vazio' })
-  current_password: string;
-
-  @ApiProperty({
-    required: false,
-    description: 'Código TOTP atual de 6 dígitos (obrigatório se não enviar recovery_code)',
-  })
-  @ValidateIf((o) => o.recovery_code == null || String(o.recovery_code).trim() === '')
-  @IsString()
-  @Matches(/^\d{6}$/, { message: 'totp deve ser exatamente 6 dígitos' })
-  totp?: string;
-
-  @ApiProperty({
-    required: false,
-    description:
-      'Um dos códigos de recuperação gerados na ativação (obrigatório se não enviar totp)',
-  })
-  @ValidateIf((o) => o.totp == null || String(o.totp).trim() === '')
-  @IsString()
-  @MinLength(10, { message: 'recovery_code inválido' })
-  @MaxLength(64, { message: 'recovery_code inválido' })
-  @Matches(/^[a-fA-F0-9\s-]+$/, { message: 'recovery_code inválido' })
-  recovery_code?: string;
-}
-
-export class TotpSetupStartResponseDto {
-  @ApiProperty({ description: 'URI otpauth para QR code' })
-  otpauth_url: string;
-
-  @ApiProperty({ description: 'Segredo em Base32 para entrada manual' })
-  secret_base32: string;
-}
+import { ApiProperty } from '@nestjs/swagger';
+import { IsString, Matches, MaxLength, MinLength, ValidateIf } from 'class-validator';
+
+export class TotpSetupConfirmDto {
+  @ApiProperty({ description: 'Código TOTP de 6 dígitos para confirmar o pareamento' })
+  @IsString()
+  @Matches(/^\d{6}$/, { message: 'totp deve ser exatamente 6 dígitos' })
+  totp: string;
+}
+
+/** Resposta após confirmar o 2FA: códigos de recuperação mostrados uma única vez. */
+export class TotpSetupConfirmResponseDto {
+  @ApiProperty({ description: 'Confirmação de sucesso' })
+  success: true;
+
+  @ApiProperty({
+    type: [String],
+    description:
+      'Seis códigos de recuperação (hex, 10 caracteres). Guardar em local seguro; não serão repetidos pela API.',
+  })
+  recovery_codes: string[];
+}
+
+export class TotpDisableDto {
+  @ApiProperty({ description: 'Senha atual do utilizador' })
+  @IsString()
+  @MinLength(1, { message: 'current_password não pode ser vazio' })
+  current_password: string;
+
+  @ApiProperty({
+    required: false,
+    description: 'Código TOTP atual de 6 dígitos (obrigatório se não enviar recovery_code)',
+  })
+  @ValidateIf((o) => o.recovery_code == null || String(o.recovery_code).trim() === '')
+  @IsString()
+  @Matches(/^\d{6}$/, { message: 'totp deve ser exatamente 6 dígitos' })
+  totp?: string;
+
+  @ApiProperty({
+    required: false,
+    description:
+      'Um dos códigos de recuperação gerados na ativação (obrigatório se não enviar totp)',
+  })
+  @ValidateIf((o) => o.totp == null || String(o.totp).trim() === '')
+  @IsString()
+  @MinLength(10, { message: 'recovery_code inválido' })
+  @MaxLength(64, { message: 'recovery_code inválido' })
+  @Matches(/^[a-fA-F0-9\s-]+$/, { message: 'recovery_code inválido' })
+  recovery_code?: string;
+}
+
+export class TotpSetupStartResponseDto {
+  @ApiProperty({ description: 'URI otpauth para QR code' })
+  otpauth_url: string;
+
+  @ApiProperty({ description: 'Segredo em Base32 para entrada manual' })
+  secret_base32: string;
+}

package/src/configurations/app-module-policy.dto.ts

@@ -1,72 +1,72 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { Type } from 'class-transformer';
-import {
-  IsArray,
-  IsBoolean,
-  IsEnum,
-  IsNotEmpty,
-  IsOptional,
-  IsString,
-  ValidateNested,
-} from 'class-validator';
-import {
-  TYCHAT_APP_MODULE_KEYS,
-  TYCHAT_APP_MODULE_POLICY_LEVELS,
-  type TychatAppModuleKey,
-  type TychatAppModulePolicyLevel,
-} from './app-module-policy.enums';
-
-export class AppModulePolicyDto {
-  @ApiProperty({ enum: TYCHAT_APP_MODULE_KEYS })
-  @IsEnum(TYCHAT_APP_MODULE_KEYS)
-  moduleKey: TychatAppModuleKey;
-
-  @ApiProperty()
-  @IsBoolean()
-  enabled: boolean;
-
-  @ApiPropertyOptional({ enum: TYCHAT_APP_MODULE_POLICY_LEVELS })
-  @IsOptional()
-  @IsEnum(TYCHAT_APP_MODULE_POLICY_LEVELS)
-  level?: TychatAppModulePolicyLevel;
-}
-
-export class UpdateAppModulePolicyDto {
-  @ApiProperty({ enum: TYCHAT_APP_MODULE_KEYS })
-  @IsEnum(TYCHAT_APP_MODULE_KEYS)
-  moduleKey: TychatAppModuleKey;
-
-  @ApiProperty()
-  @IsBoolean()
-  enabled: boolean;
-}
-
-export class UpdateAppModulePoliciesDto {
-  @ApiProperty({ type: () => [UpdateAppModulePolicyDto] })
-  @IsArray()
-  @ValidateNested({ each: true })
-  @Type(() => UpdateAppModulePolicyDto)
-  policies: UpdateAppModulePolicyDto[];
-}
-
-export class ResolveAppModulePoliciesQueryDto {
-  @ApiProperty()
-  @IsString()
-  @IsNotEmpty()
-  tenantId: string;
-}
-
-export class EffectiveAppModulePolicyDto extends AppModulePolicyDto {
-  @ApiPropertyOptional()
-  @IsOptional()
-  @IsString()
-  reasonCode?: string;
-}
-
-export class EffectiveAppModulePoliciesDto {
-  @ApiProperty({ type: () => [EffectiveAppModulePolicyDto] })
-  @IsArray()
-  @ValidateNested({ each: true })
-  @Type(() => EffectiveAppModulePolicyDto)
-  policies: EffectiveAppModulePolicyDto[];
-}
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import {
+  IsArray,
+  IsBoolean,
+  IsEnum,
+  IsNotEmpty,
+  IsOptional,
+  IsString,
+  ValidateNested,
+} from 'class-validator';
+import {
+  TYCHAT_APP_MODULE_KEYS,
+  TYCHAT_APP_MODULE_POLICY_LEVELS,
+  type TychatAppModuleKey,
+  type TychatAppModulePolicyLevel,
+} from './app-module-policy.enums';
+
+export class AppModulePolicyDto {
+  @ApiProperty({ enum: TYCHAT_APP_MODULE_KEYS })
+  @IsEnum(TYCHAT_APP_MODULE_KEYS)
+  moduleKey: TychatAppModuleKey;
+
+  @ApiProperty()
+  @IsBoolean()
+  enabled: boolean;
+
+  @ApiPropertyOptional({ enum: TYCHAT_APP_MODULE_POLICY_LEVELS })
+  @IsOptional()
+  @IsEnum(TYCHAT_APP_MODULE_POLICY_LEVELS)
+  level?: TychatAppModulePolicyLevel;
+}
+
+export class UpdateAppModulePolicyDto {
+  @ApiProperty({ enum: TYCHAT_APP_MODULE_KEYS })
+  @IsEnum(TYCHAT_APP_MODULE_KEYS)
+  moduleKey: TychatAppModuleKey;
+
+  @ApiProperty()
+  @IsBoolean()
+  enabled: boolean;
+}
+
+export class UpdateAppModulePoliciesDto {
+  @ApiProperty({ type: () => [UpdateAppModulePolicyDto] })
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => UpdateAppModulePolicyDto)
+  policies: UpdateAppModulePolicyDto[];
+}
+
+export class ResolveAppModulePoliciesQueryDto {
+  @ApiProperty()
+  @IsString()
+  @IsNotEmpty()
+  tenantId: string;
+}
+
+export class EffectiveAppModulePolicyDto extends AppModulePolicyDto {
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  reasonCode?: string;
+}
+
+export class EffectiveAppModulePoliciesDto {
+  @ApiProperty({ type: () => [EffectiveAppModulePolicyDto] })
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => EffectiveAppModulePolicyDto)
+  policies: EffectiveAppModulePolicyDto[];
+}

package/src/configurations/app-module-policy.enums.ts

@@ -1,30 +1,30 @@
-/**
- * Módulos da aplicação web do tenant (Tychat-v2), controlados por plano e override por tenant.
- * Valores estáveis para API e persistência.
- */
-export const TYCHAT_APP_MODULE_KEYS = [
-  'dashboard',
-  'check_in',
-  'check_out',
-  'schedule',
-  'conversations',
-  'patients',
-  'patients_documents',
-  'patients_legal_terms',
-  'clinic_legal_terms',
-  'patients_anamneses',
-  'clinic_anamneses',
-  'ai_conversation',
-  'follow_up',
-  'funnel',
-  'satisfaction',
-  'clinic',
-  'billings',
-  'connections',
-  'settings',
-] as const;
-
-export type TychatAppModuleKey = (typeof TYCHAT_APP_MODULE_KEYS)[number];
-
-export const TYCHAT_APP_MODULE_POLICY_LEVELS = ['default', 'plan', 'tenant'] as const;
-export type TychatAppModulePolicyLevel = (typeof TYCHAT_APP_MODULE_POLICY_LEVELS)[number];
+/**
+ * Módulos da aplicação web do tenant (Tychat-v2), controlados por plano e override por tenant.
+ * Valores estáveis para API e persistência.
+ */
+export const TYCHAT_APP_MODULE_KEYS = [
+  'dashboard',
+  'check_in',
+  'check_out',
+  'schedule',
+  'conversations',
+  'patients',
+  'patients_documents',
+  'patients_legal_terms',
+  'clinic_legal_terms',
+  'patients_anamneses',
+  'clinic_anamneses',
+  'ai_conversation',
+  'follow_up',
+  'funnel',
+  'satisfaction',
+  'clinic',
+  'billings',
+  'connections',
+  'settings',
+] as const;
+
+export type TychatAppModuleKey = (typeof TYCHAT_APP_MODULE_KEYS)[number];
+
+export const TYCHAT_APP_MODULE_POLICY_LEVELS = ['default', 'plan', 'tenant'] as const;
+export type TychatAppModulePolicyLevel = (typeof TYCHAT_APP_MODULE_POLICY_LEVELS)[number];

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()