tychat-contracts 1.6.53 → 1.6.56

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

@@ -0,0 +1,100 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import {
+  IsArray,
+  IsIn,
+  IsInt,
+  IsOptional,
+  IsString,
+  Max,
+  MaxLength,
+  Min,
+  MinLength,
+  ValidateNested,
+} from 'class-validator';
+import {
+  LEGAL_TERM_BLOCK_TYPES,
+  LEGAL_TERM_DOCUMENT_VERSION,
+  type LegalTermBlockType,
+  type LegalTermDocument,
+  type LegalTermSectionLevel,
+} from './legal-term-document.types';
+
+export class LegalTermDocumentBlockDto {
+  @ApiProperty({ description: 'Identificador estável do bloco (UUID ou id preset CFM)' })
+  @IsString()
+  @MinLength(1)
+  @MaxLength(64)
+  id: string;
+
+  @ApiProperty({ enum: LEGAL_TERM_BLOCK_TYPES })
+  @IsIn([...LEGAL_TERM_BLOCK_TYPES])
+  type: LegalTermBlockType;
+
+  @ApiPropertyOptional({ enum: [1, 2, 3] })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  @Max(3)
+  level?: LegalTermSectionLevel;
+
+  @ApiPropertyOptional({ maxLength: 500 })
+  @IsOptional()
+  @IsString()
+  @MaxLength(500)
+  title?: string;
+
+  @ApiPropertyOptional({ maxLength: 50_000 })
+  @IsOptional()
+  @IsString()
+  @MaxLength(50_000)
+  body?: string;
+
+  @ApiPropertyOptional({ enum: ['left', 'center', 'right'] })
+  @IsOptional()
+  @IsIn(['left', 'center', 'right'])
+  titleAlign?: 'left' | 'center' | 'right';
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  titleBold?: boolean;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  titleItalic?: boolean;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  titleUnderline?: boolean;
+
+  @ApiPropertyOptional({ enum: ['left', 'center', 'right'] })
+  @IsOptional()
+  @IsIn(['left', 'center', 'right'])
+  bodyAlign?: 'left' | 'center' | 'right';
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  bodyBold?: boolean;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  bodyItalic?: boolean;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  bodyUnderline?: boolean;
+}
+
+export class LegalTermDocumentDto implements LegalTermDocument {
+  @ApiProperty({ enum: [LEGAL_TERM_DOCUMENT_VERSION] })
+  @IsInt()
+  @Min(1)
+  @Max(1)
+  version: 1;
+
+  @ApiProperty({ type: [LegalTermDocumentBlockDto] })
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => LegalTermDocumentBlockDto)
+  blocks: LegalTermDocumentBlockDto[];
+}

package/src/legal-terms/legal-term-document.types.ts

@@ -0,0 +1,42 @@
+/** Blocos do editor visual do termo jurídico (sem HTML do usuário). */
+export const LEGAL_TERM_BLOCK_TYPES = [
+  'document_title',
+  'legal_reference',
+  'section',
+  'paragraph',
+  'table_side_effects',
+  'signature_footer',
+] as const;
+
+export type LegalTermBlockType = (typeof LEGAL_TERM_BLOCK_TYPES)[number];
+
+export type LegalTermSectionLevel = 1 | 2 | 3;
+
+export const LEGAL_TERM_TEXT_ALIGNS = ['left', 'center', 'right'] as const;
+export type LegalTermTextAlign = (typeof LEGAL_TERM_TEXT_ALIGNS)[number];
+
+export type LegalTermDocumentBlock = {
+  id: string;
+  type: LegalTermBlockType;
+  /** Nível de numeração para `section` (1 → 1., 2 → 1.1., 3 → 1.1.1.). */
+  level?: LegalTermSectionLevel;
+  /** Título visível (seção) ou ignorado em tipos sem título. */
+  title?: string;
+  /** Texto com placeholders `{{ token }}`; vazio em blocos só estruturais. */
+  body?: string;
+  titleAlign?: LegalTermTextAlign;
+  titleBold?: boolean;
+  titleItalic?: boolean;
+  titleUnderline?: boolean;
+  bodyAlign?: LegalTermTextAlign;
+  bodyBold?: boolean;
+  bodyItalic?: boolean;
+  bodyUnderline?: boolean;
+};
+
+export type LegalTermDocument = {
+  version: 1;
+  blocks: LegalTermDocumentBlock[];
+};
+
+export const LEGAL_TERM_DOCUMENT_VERSION = 1 as const;

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

@@ -11,8 +11,11 @@ import {
   MaxLength,
   MinLength,
   ValidateIf,
+  ValidateNested,
 } from 'class-validator';
+import { Type } from 'class-transformer';
 import { LEGAL_TERM_BODY_FORMATS, type LegalTermBodyFormat } from './legal-term-body-format';
+import { LegalTermDocumentDto } from './legal-term-document.dto';
 
 const LEGAL_TERM_SIGNATURE_METHODS = ['digital', 'printed'] as const;
 export type LegalTermSignatureMethodDto = (typeof LEGAL_TERM_SIGNATURE_METHODS)[number];
@@ -20,7 +23,16 @@ export type LegalTermSignatureMethodDto = (typeof LEGAL_TERM_SIGNATURE_METHODS)[
 /** Valores explícitos para substituição na pré-visualização (sem inferência heurística). */
 export class LegalTermPreviewRequestDto {
   @ApiPropertyOptional({
-    description: 'HTML atual do editor (rascunho); se omitido, usa o modelo salvo no banco',
+    description: 'Rascunho do documento visual; se omitido, usa o modelo salvo',
+    type: LegalTermDocumentDto,
+  })
+  @IsOptional()
+  @ValidateNested()
+  @Type(() => LegalTermDocumentDto)
+  body_document?: LegalTermDocumentDto;
+
+  @ApiPropertyOptional({
+    description: 'HTML legado (rascunho); ignorado se body_document for enviado',
     maxLength: 500_000,
   })
   @IsOptional()

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

@@ -1,4 +1,5 @@
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
 import {
   IsArray,
   IsIn,
@@ -7,24 +8,32 @@ import {
   IsUUID,
   MaxLength,
   MinLength,
+  ValidateNested,
 } from 'class-validator';
 import { LEGAL_TERM_BODY_FORMATS, type LegalTermBodyFormat } from './legal-term-body-format';
+import { LegalTermDocumentDto } from './legal-term-document.dto';
 
 export class LegalTermTemplateDto {
   @ApiProperty({ format: 'uuid' })
   id: string;
 
   @ApiProperty({
-    description: 'Conteúdo do modelo (HTML, Markdown ou texto conforme body_format)',
+    description: 'HTML compilado a partir de body_document (cache para PDF)',
   })
   body_html: string;
 
   @ApiProperty({
     enum: LEGAL_TERM_BODY_FORMATS,
-    description: 'Como interpretar body_html antes de gerar PDF',
+    description: 'structured: editor visual; demais formatos legados',
   })
   body_format: LegalTermBodyFormat;
 
+  @ApiProperty({
+    description: 'Documento estruturado do editor visual',
+    type: LegalTermDocumentDto,
+  })
+  body_document: LegalTermDocumentDto;
+
   @ApiProperty({
     type: [String],
     format: 'uuid',
@@ -41,18 +50,25 @@ export class LegalTermTemplateDto {
 
 export class UpsertLegalTermTemplateDto {
   @ApiProperty({
-    description: 'Corpo do termo (HTML, Markdown ou texto puro conforme body_format)',
-    minLength: 1,
+    description: 'Documento do editor visual (obrigatório no fluxo structured)',
+    type: LegalTermDocumentDto,
+  })
+  @ValidateNested()
+  @Type(() => LegalTermDocumentDto)
+  body_document: LegalTermDocumentDto;
+
+  @ApiPropertyOptional({
+    description: 'Ignorado no fluxo structured; servidor compila body_html',
     maxLength: 500_000,
   })
+  @IsOptional()
   @IsString()
-  @MinLength(1)
   @MaxLength(500_000)
-  body_html: string;
+  body_html?: string;
 
   @ApiPropertyOptional({
     enum: LEGAL_TERM_BODY_FORMATS,
-    description: 'Padrão: html',
+    description: 'Padrão: structured',
   })
   @IsOptional()
   @IsIn(LEGAL_TERM_BODY_FORMATS)