tychat-contracts 1.6.7 → 1.6.9

package/src/auth/password-reset-finalize-2fa.dto.ts

@@ -1,36 +1,36 @@
-import { ApiProperty } from '@nestjs/swagger';
-import { IsString, Matches, MaxLength, MinLength } from 'class-validator';
-import { MatchField } from './match-field.decorator';
-
-/** Finaliza recuperação de senha quando o utilizador tem 2FA (após `password-reset/request`). */
-export class PasswordResetFinalize2faDto {
-  @ApiProperty({ description: 'JWT pre_password_reset devolvido no pedido de reset' })
-  @IsString()
-  @MinLength(1, { message: 'pre_recovery_token não pode ser vazio' })
-  @MaxLength(4096)
-  pre_recovery_token: string;
-
-  @ApiProperty({ description: 'Código TOTP de 6 dígitos' })
-  @IsString()
-  @Matches(/^\d{6}$/, { message: 'totp deve ser exatamente 6 dígitos' })
-  totp: string;
-
-  @ApiProperty({ description: 'Nova senha', example: 'senha123', minLength: 6 })
-  @IsString()
-  @MinLength(6, { message: 'password deve ter no mínimo 6 caracteres' })
-  @MaxLength(255)
-  password: string;
-
-  @ApiProperty({
-    description: 'Confirmação da nova senha',
-    example: 'senha123',
-    minLength: 6,
-  })
-  @IsString()
-  @MinLength(6, { message: 'password_confirmation deve ter no mínimo 6 caracteres' })
-  @MaxLength(255)
-  @MatchField('password', {
-    message: 'password_confirmation deve ser igual a password',
-  })
-  password_confirmation: string;
-}
+import { ApiProperty } from '@nestjs/swagger';
+import { IsString, Matches, MaxLength, MinLength } from 'class-validator';
+import { MatchField } from './match-field.decorator';
+
+/** Finaliza recuperação de senha quando o utilizador tem 2FA (após `password-reset/request`). */
+export class PasswordResetFinalize2faDto {
+  @ApiProperty({ description: 'JWT pre_password_reset devolvido no pedido de reset' })
+  @IsString()
+  @MinLength(1, { message: 'pre_recovery_token não pode ser vazio' })
+  @MaxLength(4096)
+  pre_recovery_token: string;
+
+  @ApiProperty({ description: 'Código TOTP de 6 dígitos' })
+  @IsString()
+  @Matches(/^\d{6}$/, { message: 'totp deve ser exatamente 6 dígitos' })
+  totp: string;
+
+  @ApiProperty({ description: 'Nova senha', example: 'senha123', minLength: 6 })
+  @IsString()
+  @MinLength(6, { message: 'password deve ter no mínimo 6 caracteres' })
+  @MaxLength(255)
+  password: string;
+
+  @ApiProperty({
+    description: 'Confirmação da nova senha',
+    example: 'senha123',
+    minLength: 6,
+  })
+  @IsString()
+  @MinLength(6, { message: 'password_confirmation deve ter no mínimo 6 caracteres' })
+  @MaxLength(255)
+  @MatchField('password', {
+    message: 'password_confirmation deve ser igual a password',
+  })
+  password_confirmation: string;
+}

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];