@muni-sanfer/types-gestor-documental 0.0.1-beta.41 → 0.0.1-beta.43

package/dist/base/entities.d.ts

@@ -450,6 +450,7 @@ export interface DocumentTypeEntity {
     annulledNumbers?: DocumentAnnulledNumberEntity[];
     flowSteps?: DocumentTypeFlowStepEntity[];
     signatureBatches?: SignatureBatchEntity[];
+    template?: DocumentTemplateEntity | null;
     deleted: boolean;
     createdAt: string;
     updatedAt: string;
@@ -927,6 +928,8 @@ export interface DocumentTemplateEntity {
     name: string;
     description?: string | null;
     documentTypeIds: string[];
+    documentType?: DocumentTypeEntity | null;
+    documentTypeId?: string | null;
     content: JsonValue;
     version: number;
     enabled: boolean;
@@ -1441,6 +1444,18 @@ export interface DocumentInternalNoteEntity {
     text: string;
     createdAt: string;
 }
+export interface RichImageEntity {
+    id: string;
+    fileId: string;
+    name: string;
+    mimeType: string;
+    width: number;
+    height: number;
+    sha256: string;
+    sizeBytes: number;
+    employeeId: string;
+    createdAt: string;
+}
 type JsonValue = string | number | boolean | {
     [key in string]?: JsonValue;
 } | Array<JsonValue> | null;

package/dist/contracts/documentType.contract.d.ts

@@ -1,5 +1,5 @@
 import { type DocumentCategory, type DocumentParticipantRole, type DocumentTypeEntity } from '../base/entities';
-import { type DocumentTypeCreateResponseEntity, type DocumentTypeGetAllResponseEntity, type DocumentTypeGetByIdResponseEntity, type DocumentTypeUpdateResponseEntity } from '../entities';
+import { type DocumentTemplateContent, type DocumentTypeCreateResponseEntity, type DocumentTypeGetAllResponseEntity, type DocumentTypeGetByIdResponseEntity, type DocumentTypeUpdateResponseEntity } from '../entities';
 import { type RpcPage } from './contract';
 /** Patrones NATS de `documentType`: `<servicio>.<recurso>.<acción>`. */
 export declare const DocumentTypePatterns: {
@@ -46,6 +46,7 @@ export interface DocumentTypeWritePayload {
     sharesNumberingWithId?: string | null;
     enabled?: boolean;
     flowSteps?: DocumentFlowStepInput[];
+    template?: DocumentTemplateContent | null;
 }
 /**
  * Qué se envía y qué se responde en cada patrón. Generado desde los handlers y los DTO del microservicio.

package/dist/contracts/index.d.ts

@@ -25,6 +25,7 @@ import { type SignatureBatchContract } from './signatureBatch.contract';
 import { type WorkFolderContract } from './workFolder.contract';
 import { type DraftingRequestContract } from './draftingRequest.contract';
 import { type InternalReviewContract } from './internalReview.contract';
+import { type RichImageContract } from './richImage.contract';
 export * from './contract';
 export * from './document.contract';
 export * from './documentType.contract';
@@ -53,6 +54,7 @@ export * from './mailIntake.contract';
 export * from './push.contract';
 export * from './draftingRequest.contract';
 export * from './internalReview.contract';
+export * from './richImage.contract';
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export declare const GestorDocumentalPatterns: {
     readonly documentType: {
@@ -317,6 +319,10 @@ export declare const GestorDocumentalPatterns: {
         readonly getNotes: "gestorDocumental.internalReview.getNotes";
         readonly addNote: "gestorDocumental.internalReview.addNote";
     };
+    readonly richImage: {
+        readonly register: "gestorDocumental.richImage.register";
+        readonly getFile: "gestorDocumental.richImage.getFile";
+    };
 };
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
-export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & IssuingEntityContract & CaseFileContract & PartsOfficeContract & RegisterBookContract & SignatureBatchContract & WorkFolderContract & ScanContract & ArchivalSeriesContract & TextSnippetContract & DocumentTemplateContract & HolidayContract & IndicatorsContract & AuditContract & SignatureCheckContract & RepositoryExportContract & RetentionContract & AccessRequestContract & TransparencyContract & DataProtectionContract & DeskContract & MailIntakeContract & PushContract & DraftingRequestContract & InternalReviewContract;
+export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & IssuingEntityContract & CaseFileContract & PartsOfficeContract & RegisterBookContract & SignatureBatchContract & WorkFolderContract & ScanContract & ArchivalSeriesContract & TextSnippetContract & DocumentTemplateContract & HolidayContract & IndicatorsContract & AuditContract & SignatureCheckContract & RepositoryExportContract & RetentionContract & AccessRequestContract & TransparencyContract & DataProtectionContract & DeskContract & MailIntakeContract & PushContract & DraftingRequestContract & InternalReviewContract & RichImageContract;

package/dist/contracts/index.js

@@ -42,6 +42,7 @@ const signatureBatch_contract_1 = require("./signatureBatch.contract");
 const workFolder_contract_1 = require("./workFolder.contract");
 const draftingRequest_contract_1 = require("./draftingRequest.contract");
 const internalReview_contract_1 = require("./internalReview.contract");
+const richImage_contract_1 = require("./richImage.contract");
 __exportStar(require("./contract"), exports);
 __exportStar(require("./document.contract"), exports);
 __exportStar(require("./documentType.contract"), exports);
@@ -70,6 +71,7 @@ __exportStar(require("./mailIntake.contract"), exports);
 __exportStar(require("./push.contract"), exports);
 __exportStar(require("./draftingRequest.contract"), exports);
 __exportStar(require("./internalReview.contract"), exports);
+__exportStar(require("./richImage.contract"), exports);
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 exports.GestorDocumentalPatterns = {
     documentType: documentType_contract_1.DocumentTypePatterns,
@@ -99,4 +101,5 @@ exports.GestorDocumentalPatterns = {
     push: push_contract_1.PushPatterns,
     draftingRequest: draftingRequest_contract_1.DraftingRequestPatterns,
     internalReview: internalReview_contract_1.InternalReviewPatterns,
+    richImage: richImage_contract_1.RichImagePatterns,
 };

package/dist/contracts/richImage.contract.d.ts

@@ -0,0 +1,33 @@
+import { type RichImageResponseEntity } from '../entities';
+/** Patrones NATS de `richImage`: imágenes del editor (logos de membrete e imágenes del texto). */
+export declare const RichImagePatterns: {
+    readonly register: "gestorDocumental.richImage.register";
+    readonly getFile: "gestorDocumental.richImage.getFile";
+};
+export interface RichImageContract {
+    /**
+     * Registra una imagen ya subida a Drive por el gateway (en la carpeta de los documentos). El ms descarga el archivo, comprueba que sea PNG o JPEG y de
+     * tamaño aceptable, y guarda sus medidas y su huella.
+     */
+    [RichImagePatterns.register]: {
+        payload: {
+            fileId: string;
+            name: string;
+            actor: {
+                employeeId: string;
+            };
+        };
+        response: RichImageResponseEntity;
+    };
+    /** El archivo de una imagen registrada, para mostrarla en el editor. */
+    [RichImagePatterns.getFile]: {
+        payload: {
+            id: string;
+        };
+        response: {
+            fileId: string;
+            fileName: string;
+            mimeType: string;
+        };
+    };
+}

package/dist/contracts/richImage.contract.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RichImagePatterns = void 0;
+/** Patrones NATS de `richImage`: imágenes del editor (logos de membrete e imágenes del texto). */
+exports.RichImagePatterns = {
+    register: 'gestorDocumental.richImage.register',
+    getFile: 'gestorDocumental.richImage.getFile',
+};

package/dist/entities/document/document.entity.d.ts

@@ -1,4 +1,5 @@
 import { type CommunicationMeans, DocumentAnnulledNumberEntity, DocumentAttachmentEntity, DocumentDeliveryEntity, DocumentEntity, DocumentParticipantEntity, DocumentRecipientEntity, type DocumentStatus, DocumentTrackingEntity, DocumentTypeEntity } from '../../base/entities';
+import { type RichLetterhead, type RichPage, type RichSpacing, type RichTextStyle } from './richStyle';
 import { type DocumentDraftingRequestEntity } from '../draftingRequest/draftingRequest.entity';
 /** Tipo documental de un documento, con lo necesario para citarlo. */
 export interface DocumentTypeSummaryEntity {
@@ -407,8 +408,8 @@ export interface DocumentTrailExportEntity {
 }
 /** Plantilla oficial con que se redacta un documento en el sistema. */
 export type DocumentTemplateKind = 'Decree' | 'Office' | 'Memorandum' | 'General';
-/** Formato de un trozo de texto en el editor del gestor. */
-export type RichMark = 'bold' | 'italic' | 'underline';
+/** Formato de un trozo de texto en el editor del gestor. Superíndice y subíndice no van juntos. */
+export type RichMark = 'bold' | 'italic' | 'underline' | 'strike' | 'superscript' | 'subscript';
 /**
  * Texto con su formato, o un campo de la plantilla (`field`: su clave), que se reemplaza por su valor al armar el PDF.
  * Un salto de línea dentro del texto (`\n`) es un salto de línea del párrafo.
@@ -416,8 +417,11 @@ export type RichMark = 'bold' | 'italic' | 'underline';
 export type RichInline = {
     text: string;
     marks?: RichMark[];
+    style?: RichTextStyle;
 } | {
     field: string;
+    marks?: RichMark[];
+    style?: RichTextStyle;
 };
 export type RichAlign = 'left' | 'center' | 'right' | 'justify';
 /** Numeración de una lista: viñetas, «1.» o la de los decretos, «1.-». */
@@ -435,6 +439,7 @@ export type RichBlock = {
     id: string;
     type: 'paragraph';
     align?: RichAlign;
+    spacing?: RichSpacing;
     locked?: boolean;
     content: RichInline[];
 } | {
@@ -442,6 +447,7 @@ export type RichBlock = {
     type: 'heading';
     level: 1 | 2;
     align?: RichAlign;
+    spacing?: RichSpacing;
     locked?: boolean;
     content: RichInline[];
 } | {
@@ -449,9 +455,20 @@ export type RichBlock = {
     type: 'listItem';
     list: RichListStyle;
     level: number;
+    spacing?: RichSpacing;
     locked?: boolean;
     content: RichInline[];
 }
+/** Imagen registrada en el gestor (`imageId`), con su ancho en puntos (sin pasar el del texto) y alineación. */
+ | {
+    id: string;
+    type: 'image';
+    imageId: string;
+    width: number;
+    align?: 'left' | 'center' | 'right';
+    caption?: string;
+    locked?: boolean;
+}
 /** `rows[fila][columna]`: el contenido de cada celda. */
  | {
     id: string;
@@ -526,6 +543,9 @@ export type DocumentComposition = {
     blocks: RichBlock[];
     fields: RichField[];
     distribution: string[];
+    /** Página y membrete. En una plantilla propia los pone su versión: lo que mande el navegador no cuenta. */
+    page?: RichPage;
+    letterhead?: RichLetterhead;
 };
 /** PDF armado con una plantilla: para la vista previa (`contentBase64`) o ya subido (`fileId`). */
 export interface DocumentComposeResponseEntity {

package/dist/entities/document/index.d.ts

@@ -1 +1,2 @@
 export * from './document.entity';
+export * from './richStyle';

package/dist/entities/document/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./document.entity"), exports);
+__exportStar(require("./richStyle"), exports);

package/dist/entities/document/richStyle.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Formato del editor del gestor que comparten el navegador y el microservicio: tipografías, colores, tamaños de hoja y
+ * márgenes. Todo lo que el PDF muestra sale de aquí, así que el editor y el documento oficial se ven igual.
+ */
+/**
+ * Tipografías incrustadas en el PDF (PDF/A exige fuentes incrustadas). Liberation Sans, Liberation Serif y Carlito
+ * miden igual que Arial, Times New Roman y Calibri: lo que se pegó desde Word ocupa lo mismo.
+ */
+export declare const RICH_FONTS: {
+    readonly Roboto: "Roboto";
+    readonly LiberationSans: "Liberation Sans (Arial)";
+    readonly LiberationSerif: "Liberation Serif (Times New Roman)";
+    readonly Carlito: "Carlito (Calibri)";
+};
+export type RichFont = keyof typeof RICH_FONTS;
+/** Tamaños de letra que se ofrecen, en puntos. */
+export declare const RICH_FONT_SIZES: readonly [8, 9, 10, 11, 12, 13, 14, 16, 18, 20, 24];
+/** Colores de letra: una paleta acotada, sobria, para documentos oficiales. */
+export declare const RICH_COLORS: {
+    readonly black: {
+        readonly label: "Negro";
+        readonly hex: "#111827";
+    };
+    readonly gray: {
+        readonly label: "Gris";
+        readonly hex: "#4B5563";
+    };
+    readonly blue: {
+        readonly label: "Azul";
+        readonly hex: "#1E40AF";
+    };
+    readonly red: {
+        readonly label: "Rojo";
+        readonly hex: "#B91C1C";
+    };
+    readonly green: {
+        readonly label: "Verde";
+        readonly hex: "#166534";
+    };
+    readonly brown: {
+        readonly label: "Café";
+        readonly hex: "#78350F";
+    };
+};
+export type RichColor = keyof typeof RICH_COLORS;
+/** Resaltado del texto. */
+export declare const RICH_HIGHLIGHTS: {
+    readonly yellow: {
+        readonly label: "Amarillo";
+        readonly hex: "#FEF08A";
+    };
+    readonly green: {
+        readonly label: "Verde";
+        readonly hex: "#BBF7D0";
+    };
+    readonly blue: {
+        readonly label: "Celeste";
+        readonly hex: "#BFDBFE";
+    };
+    readonly pink: {
+        readonly label: "Rosado";
+        readonly hex: "#FBCFE8";
+    };
+    readonly gray: {
+        readonly label: "Gris";
+        readonly hex: "#E5E7EB";
+    };
+};
+export type RichHighlight = keyof typeof RICH_HIGHLIGHTS;
+/** Formato propio de un trozo de texto, además de sus marcas. Sin valor, el de la página. */
+export interface RichTextStyle {
+    font?: RichFont;
+    size?: number;
+    color?: RichColor;
+    highlight?: RichHighlight;
+}
+/** Espaciado y sangría de un párrafo, título o punto de lista, en puntos (el interlineado, en veces la letra). */
+export interface RichSpacing {
+    before?: number;
+    after?: number;
+    lineHeight?: number;
+    /** Sangría de la primera línea. */
+    firstLine?: number;
+    /** Sangría de todo el párrafo, desde el margen izquierdo. */
+    left?: number;
+}
+/** Límites del espaciado, en puntos. */
+export declare const RICH_SPACING_LIMITS: {
+    readonly maxSpace: 72;
+    readonly maxIndent: 216;
+    readonly minLineHeight: 0.8;
+    readonly maxLineHeight: 3;
+};
+/** Tamaños de hoja, en puntos. Oficio es el chileno: 216 x 330 mm. */
+export declare const RICH_PAGE_SIZES: {
+    readonly letter: {
+        readonly label: "Carta (216 x 279 mm)";
+        readonly width: 612;
+        readonly height: 792;
+    };
+    readonly oficio: {
+        readonly label: "Oficio (216 x 330 mm)";
+        readonly width: 612;
+        readonly height: 936;
+    };
+};
+export type RichPageSize = keyof typeof RICH_PAGE_SIZES;
+export interface RichMargins {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+/**
+ * Márgenes mínimos, en puntos: arriba van el membrete y el número con la fecha que estampa el sistema; abajo, la
+ * franja del QR en cada página; a los costados, los sellos. Con menos, lo estampado taparía el texto.
+ */
+export declare const RICH_MIN_MARGINS: RichMargins;
+/** Márgenes máximos, en puntos (unos 5 cm). */
+export declare const RICH_MAX_MARGIN = 144;
+/** Página de un documento: tamaño, márgenes y letra base. La define la plantilla; quien redacta no la cambia. */
+export interface RichPage {
+    size: RichPageSize;
+    margins: RichMargins;
+    font: RichFont;
+    fontSize: number;
+    lineHeight: number;
+}
+/** Página de siempre: Carta, con el espacio del membrete y los sellos, en Roboto 11. */
+export declare const RICH_DEFAULT_PAGE: RichPage;
+/**
+ * Membrete de la plantilla, en el margen superior de cada página: un logo o escudo (opcional) y el nombre de la
+ * municipalidad y de la unidad que emite. Va a la izquierda: a la derecha el sistema estampa el número y la fecha.
+ */
+export interface RichLetterhead {
+    /** Imagen registrada en el gestor (`RichImage`), no un archivo de Drive. */
+    imageId?: string | null;
+    /** Alto del logo, en puntos. */
+    imageHeight?: number;
+    showOrganName: boolean;
+    showUnitName: boolean;
+    /** Líneas propias bajo el nombre, como la dirección o el teléfono. */
+    lines?: string[];
+}
+export declare const RICH_DEFAULT_LETTERHEAD: RichLetterhead;
+/** Límites de una imagen: formatos, peso y tamaño en el texto. */
+export declare const RICH_IMAGE_LIMITS: {
+    readonly types: readonly ["image/png", "image/jpeg"];
+    readonly maxBytes: 2000000;
+    readonly minWidth: 24;
+    readonly maxLetterheadHeight: 56;
+};
+/** Imagen subida al gestor para el editor: se usa por su id; el archivo está en Drive. */
+export interface RichImageResponseEntity {
+    id: string;
+    name: string;
+    mimeType: string;
+    width: number;
+    height: number;
+}

package/dist/entities/document/richStyle.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * Formato del editor del gestor que comparten el navegador y el microservicio: tipografías, colores, tamaños de hoja y
+ * márgenes. Todo lo que el PDF muestra sale de aquí, así que el editor y el documento oficial se ven igual.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RICH_IMAGE_LIMITS = exports.RICH_DEFAULT_LETTERHEAD = exports.RICH_DEFAULT_PAGE = exports.RICH_MAX_MARGIN = exports.RICH_MIN_MARGINS = exports.RICH_PAGE_SIZES = exports.RICH_SPACING_LIMITS = exports.RICH_HIGHLIGHTS = exports.RICH_COLORS = exports.RICH_FONT_SIZES = exports.RICH_FONTS = void 0;
+/**
+ * Tipografías incrustadas en el PDF (PDF/A exige fuentes incrustadas). Liberation Sans, Liberation Serif y Carlito
+ * miden igual que Arial, Times New Roman y Calibri: lo que se pegó desde Word ocupa lo mismo.
+ */
+exports.RICH_FONTS = {
+    Roboto: 'Roboto',
+    LiberationSans: 'Liberation Sans (Arial)',
+    LiberationSerif: 'Liberation Serif (Times New Roman)',
+    Carlito: 'Carlito (Calibri)',
+};
+/** Tamaños de letra que se ofrecen, en puntos. */
+exports.RICH_FONT_SIZES = [8, 9, 10, 11, 12, 13, 14, 16, 18, 20, 24];
+/** Colores de letra: una paleta acotada, sobria, para documentos oficiales. */
+exports.RICH_COLORS = {
+    black: { label: 'Negro', hex: '#111827' },
+    gray: { label: 'Gris', hex: '#4B5563' },
+    blue: { label: 'Azul', hex: '#1E40AF' },
+    red: { label: 'Rojo', hex: '#B91C1C' },
+    green: { label: 'Verde', hex: '#166534' },
+    brown: { label: 'Café', hex: '#78350F' },
+};
+/** Resaltado del texto. */
+exports.RICH_HIGHLIGHTS = {
+    yellow: { label: 'Amarillo', hex: '#FEF08A' },
+    green: { label: 'Verde', hex: '#BBF7D0' },
+    blue: { label: 'Celeste', hex: '#BFDBFE' },
+    pink: { label: 'Rosado', hex: '#FBCFE8' },
+    gray: { label: 'Gris', hex: '#E5E7EB' },
+};
+/** Límites del espaciado, en puntos. */
+exports.RICH_SPACING_LIMITS = { maxSpace: 72, maxIndent: 216, minLineHeight: 0.8, maxLineHeight: 3 };
+/** Tamaños de hoja, en puntos. Oficio es el chileno: 216 x 330 mm. */
+exports.RICH_PAGE_SIZES = {
+    letter: { label: 'Carta (216 x 279 mm)', width: 612, height: 792 },
+    oficio: { label: 'Oficio (216 x 330 mm)', width: 612, height: 936 },
+};
+/**
+ * Márgenes mínimos, en puntos: arriba van el membrete y el número con la fecha que estampa el sistema; abajo, la
+ * franja del QR en cada página; a los costados, los sellos. Con menos, lo estampado taparía el texto.
+ */
+exports.RICH_MIN_MARGINS = { top: 64, right: 42, bottom: 64, left: 42 };
+/** Márgenes máximos, en puntos (unos 5 cm). */
+exports.RICH_MAX_MARGIN = 144;
+/** Página de siempre: Carta, con el espacio del membrete y los sellos, en Roboto 11. */
+exports.RICH_DEFAULT_PAGE = {
+    size: 'letter',
+    margins: { top: 104, right: 64, bottom: 76, left: 72 },
+    font: 'Roboto',
+    fontSize: 11,
+    lineHeight: 1.2,
+};
+exports.RICH_DEFAULT_LETTERHEAD = { imageId: null, showOrganName: true, showUnitName: true };
+/** Límites de una imagen: formatos, peso y tamaño en el texto. */
+exports.RICH_IMAGE_LIMITS = {
+    types: ['image/png', 'image/jpeg'],
+    maxBytes: 2000000,
+    minWidth: 24,
+    maxLetterheadHeight: 56,
+};

package/dist/entities/documentTemplate/documentTemplate.entity.d.ts

@@ -1,5 +1,6 @@
 import { type DocumentTemplateEntity } from '../../base/entities';
 import { type RichBlock, type RichField } from '../document/document.entity';
+import { type RichLetterhead, type RichPage } from '../document/richStyle';
 /**
  * Contenido de una plantilla propia: los bloques del editor (con sus partes fijas) y los campos que completa quien
  * redacta (en la plantilla, sin valor).
@@ -7,6 +8,10 @@ import { type RichBlock, type RichField } from '../document/document.entity';
 export interface DocumentTemplateContent {
     blocks: RichBlock[];
     fields: RichField[];
+    /** Tamaño de hoja, márgenes y letra base. Sin valor, la página de siempre (`RICH_DEFAULT_PAGE`). */
+    page?: RichPage;
+    /** Membrete con logo. Sin valor, el nombre de la municipalidad y de la unidad. */
+    letterhead?: RichLetterhead;
 }
 /** Plantilla propia en el listado de quien las administra. */
 export interface DocumentTemplateGetAllResponseEntity {
@@ -38,6 +43,8 @@ export interface DocumentTemplateAvailableResponseEntity {
     description: string | null;
     version: DocumentTemplateEntity['version'];
     content: DocumentTemplateContent;
+    /** Es la plantilla del tipo documental pedido: se aplica sola al redactar. */
+    ownedByType: boolean;
 }
 export interface DocumentTemplateCreateResponseEntity {
     id: DocumentTemplateEntity['id'];

package/dist/entities/documentType/documentType.entity.d.ts

@@ -1,4 +1,5 @@
 import { DocumentTypeEntity, DocumentTypeFlowStepEntity } from '../../base/entities';
+import { type DocumentTemplateContent } from '../documentTemplate/documentTemplate.entity';
 /** Paso del flujo sugerido de un tipo documental: quién visa o firma, en su orden. */
 export interface DocumentTypeFlowStepResponseEntity {
     id: DocumentTypeFlowStepEntity['id'];
@@ -50,10 +51,18 @@ export interface DocumentTypeGetAllResponseEntity {
         visa: number;
         signature: number;
     };
+    hasTemplate: boolean;
+}
+/** Plantilla propia de un tipo documental: la versión vigente de su contenido. */
+export interface DocumentTypeTemplateResponseEntity {
+    id: string;
+    version: number;
+    content: DocumentTemplateContent;
 }
 export interface DocumentTypeGetByIdResponseEntity extends DocumentTypeGetAllResponseEntity {
     lastCorrelative: number | null;
     flowSteps: DocumentTypeFlowStepResponseEntity[];
+    template: DocumentTypeTemplateResponseEntity | null;
 }
 export interface DocumentTypeCreateResponseEntity {
     id: DocumentTypeEntity['id'];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@muni-sanfer/types-gestor-documental",
-  "version": "0.0.1-beta.41",
+  "version": "0.0.1-beta.43",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {

package/src/base/entities.ts

@@ -654,6 +654,7 @@ export interface DocumentTypeEntity {
   annulledNumbers?: DocumentAnnulledNumberEntity[];
   flowSteps?: DocumentTypeFlowStepEntity[];
   signatureBatches?: SignatureBatchEntity[];
+  template?: DocumentTemplateEntity | null;
   deleted: boolean;
   createdAt: string;
   updatedAt: string;
@@ -1158,6 +1159,8 @@ export interface DocumentTemplateEntity {
   name: string;
   description?: string | null;
   documentTypeIds: string[];
+  documentType?: DocumentTypeEntity | null;
+  documentTypeId?: string | null;
   content: JsonValue;
   version: number;
   enabled: boolean;
@@ -1706,4 +1709,17 @@ export interface DocumentInternalNoteEntity {
   createdAt: string;
 }
 
+export interface RichImageEntity {
+  id: string;
+  fileId: string;
+  name: string;
+  mimeType: string;
+  width: number;
+  height: number;
+  sha256: string;
+  sizeBytes: number;
+  employeeId: string;
+  createdAt: string;
+}
+
 type JsonValue = string | number | boolean | { [key in string]?: JsonValue } | Array<JsonValue> | null;

package/src/contracts/documentType.contract.ts

@@ -1,5 +1,6 @@
 import { type DocumentCategory, type DocumentParticipantRole, type DocumentTypeEntity } from '../base/entities';
 import {
+  type DocumentTemplateContent,
   type DocumentTypeCreateResponseEntity,
   type DocumentTypeGetAllResponseEntity,
   type DocumentTypeGetByIdResponseEntity,
@@ -57,6 +58,8 @@ export interface DocumentTypeWritePayload {
   enabled?: boolean;
   // Flujo sugerido, en el orden en que les toca dentro de cada rol. Al editar, si no viene, el flujo no cambia.
   flowSteps?: DocumentFlowStepInput[];
+  // Plantilla propia del tipo: se aplica sola al redactar. `null` la quita; al editar, si no viene, no cambia.
+  template?: DocumentTemplateContent | null;
 }
 
 /**

package/src/contracts/index.ts

@@ -25,6 +25,7 @@ import { SignatureBatchPatterns, type SignatureBatchContract } from './signature
 import { WorkFolderPatterns, type WorkFolderContract } from './workFolder.contract';
 import { DraftingRequestPatterns, type DraftingRequestContract } from './draftingRequest.contract';
 import { InternalReviewPatterns, type InternalReviewContract } from './internalReview.contract';
+import { RichImagePatterns, type RichImageContract } from './richImage.contract';
 
 export * from './contract';
 export * from './document.contract';
@@ -54,6 +55,7 @@ export * from './mailIntake.contract';
 export * from './push.contract';
 export * from './draftingRequest.contract';
 export * from './internalReview.contract';
+export * from './richImage.contract';
 
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export const GestorDocumentalPatterns = {
@@ -84,6 +86,7 @@ export const GestorDocumentalPatterns = {
   push: PushPatterns,
   draftingRequest: DraftingRequestPatterns,
   internalReview: InternalReviewPatterns,
+  richImage: RichImagePatterns,
 } as const;
 
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
@@ -113,4 +116,5 @@ export type GestorDocumentalContract = DocumentTypeContract &
   MailIntakeContract &
   PushContract &
   DraftingRequestContract &
-  InternalReviewContract;
+  InternalReviewContract &
+  RichImageContract;

package/src/contracts/richImage.contract.ts

@@ -0,0 +1,23 @@
+import { type RichImageResponseEntity } from '../entities';
+
+/** Patrones NATS de `richImage`: imágenes del editor (logos de membrete e imágenes del texto). */
+export const RichImagePatterns = {
+  register: 'gestorDocumental.richImage.register',
+  getFile: 'gestorDocumental.richImage.getFile',
+} as const;
+
+export interface RichImageContract {
+  /**
+   * Registra una imagen ya subida a Drive por el gateway (en la carpeta de los documentos). El ms descarga el archivo, comprueba que sea PNG o JPEG y de
+   * tamaño aceptable, y guarda sus medidas y su huella.
+   */
+  [RichImagePatterns.register]: {
+    payload: { fileId: string; name: string; actor: { employeeId: string } };
+    response: RichImageResponseEntity;
+  };
+  /** El archivo de una imagen registrada, para mostrarla en el editor. */
+  [RichImagePatterns.getFile]: {
+    payload: { id: string };
+    response: { fileId: string; fileName: string; mimeType: string };
+  };
+}

package/src/entities/document/document.entity.ts

@@ -10,6 +10,7 @@ import {
   DocumentTrackingEntity,
   DocumentTypeEntity,
 } from '../../base/entities';
+import { type RichLetterhead, type RichPage, type RichSpacing, type RichTextStyle } from './richStyle';
 import { type DocumentDraftingRequestEntity } from '../draftingRequest/draftingRequest.entity';
 
 /** Tipo documental de un documento, con lo necesario para citarlo. */
@@ -453,14 +454,16 @@ export interface DocumentTrailExportEntity {
 /** Plantilla oficial con que se redacta un documento en el sistema. */
 export type DocumentTemplateKind = 'Decree' | 'Office' | 'Memorandum' | 'General';
 
-/** Formato de un trozo de texto en el editor del gestor. */
-export type RichMark = 'bold' | 'italic' | 'underline';
+/** Formato de un trozo de texto en el editor del gestor. Superíndice y subíndice no van juntos. */
+export type RichMark = 'bold' | 'italic' | 'underline' | 'strike' | 'superscript' | 'subscript';
 
 /**
  * Texto con su formato, o un campo de la plantilla (`field`: su clave), que se reemplaza por su valor al armar el PDF.
  * Un salto de línea dentro del texto (`\n`) es un salto de línea del párrafo.
  */
-export type RichInline = { text: string; marks?: RichMark[] } | { field: string };
+export type RichInline =
+  | { text: string; marks?: RichMark[]; style?: RichTextStyle }
+  | { field: string; marks?: RichMark[]; style?: RichTextStyle };
 
 export type RichAlign = 'left' | 'center' | 'right' | 'justify';
 
@@ -478,9 +481,35 @@ export type RichTableVariant = 'grid' | 'labels' | 'labelsRight';
  * bloques seguidos del mismo estilo (su nivel es la sangría, desde 0); un título o un párrafo reinicia la numeración.
  */
 export type RichBlock =
-  | { id: string; type: 'paragraph'; align?: RichAlign; locked?: boolean; content: RichInline[] }
-  | { id: string; type: 'heading'; level: 1 | 2; align?: RichAlign; locked?: boolean; content: RichInline[] }
-  | { id: string; type: 'listItem'; list: RichListStyle; level: number; locked?: boolean; content: RichInline[] }
+  | { id: string; type: 'paragraph'; align?: RichAlign; spacing?: RichSpacing; locked?: boolean; content: RichInline[] }
+  | {
+      id: string;
+      type: 'heading';
+      level: 1 | 2;
+      align?: RichAlign;
+      spacing?: RichSpacing;
+      locked?: boolean;
+      content: RichInline[];
+    }
+  | {
+      id: string;
+      type: 'listItem';
+      list: RichListStyle;
+      level: number;
+      spacing?: RichSpacing;
+      locked?: boolean;
+      content: RichInline[];
+    }
+  /** Imagen registrada en el gestor (`imageId`), con su ancho en puntos (sin pasar el del texto) y alineación. */
+  | {
+      id: string;
+      type: 'image';
+      imageId: string;
+      width: number;
+      align?: 'left' | 'center' | 'right';
+      caption?: string;
+      locked?: boolean;
+    }
   /** `rows[fila][columna]`: el contenido de cada celda. */
   | { id: string; type: 'table'; variant: RichTableVariant; locked?: boolean; rows: RichInline[][][] }
   | { id: string; type: 'rule'; locked?: boolean }
@@ -544,6 +573,9 @@ export type DocumentComposition =
       blocks: RichBlock[];
       fields: RichField[];
       distribution: string[];
+      /** Página y membrete. En una plantilla propia los pone su versión: lo que mande el navegador no cuenta. */
+      page?: RichPage;
+      letterhead?: RichLetterhead;
     };
 
 /** PDF armado con una plantilla: para la vista previa (`contentBase64`) o ya subido (`fileId`). */

package/src/entities/document/index.ts

@@ -1 +1,2 @@
 export * from './document.entity';
+export * from './richStyle';

package/src/entities/document/richStyle.ts

@@ -0,0 +1,141 @@
+/**
+ * Formato del editor del gestor que comparten el navegador y el microservicio: tipografías, colores, tamaños de hoja y
+ * márgenes. Todo lo que el PDF muestra sale de aquí, así que el editor y el documento oficial se ven igual.
+ */
+
+/**
+ * Tipografías incrustadas en el PDF (PDF/A exige fuentes incrustadas). Liberation Sans, Liberation Serif y Carlito
+ * miden igual que Arial, Times New Roman y Calibri: lo que se pegó desde Word ocupa lo mismo.
+ */
+export const RICH_FONTS = {
+  Roboto: 'Roboto',
+  LiberationSans: 'Liberation Sans (Arial)',
+  LiberationSerif: 'Liberation Serif (Times New Roman)',
+  Carlito: 'Carlito (Calibri)',
+} as const;
+
+export type RichFont = keyof typeof RICH_FONTS;
+
+/** Tamaños de letra que se ofrecen, en puntos. */
+export const RICH_FONT_SIZES = [8, 9, 10, 11, 12, 13, 14, 16, 18, 20, 24] as const;
+
+/** Colores de letra: una paleta acotada, sobria, para documentos oficiales. */
+export const RICH_COLORS = {
+  black: { label: 'Negro', hex: '#111827' },
+  gray: { label: 'Gris', hex: '#4B5563' },
+  blue: { label: 'Azul', hex: '#1E40AF' },
+  red: { label: 'Rojo', hex: '#B91C1C' },
+  green: { label: 'Verde', hex: '#166534' },
+  brown: { label: 'Café', hex: '#78350F' },
+} as const;
+
+export type RichColor = keyof typeof RICH_COLORS;
+
+/** Resaltado del texto. */
+export const RICH_HIGHLIGHTS = {
+  yellow: { label: 'Amarillo', hex: '#FEF08A' },
+  green: { label: 'Verde', hex: '#BBF7D0' },
+  blue: { label: 'Celeste', hex: '#BFDBFE' },
+  pink: { label: 'Rosado', hex: '#FBCFE8' },
+  gray: { label: 'Gris', hex: '#E5E7EB' },
+} as const;
+
+export type RichHighlight = keyof typeof RICH_HIGHLIGHTS;
+
+/** Formato propio de un trozo de texto, además de sus marcas. Sin valor, el de la página. */
+export interface RichTextStyle {
+  font?: RichFont;
+  size?: number;
+  color?: RichColor;
+  highlight?: RichHighlight;
+}
+
+/** Espaciado y sangría de un párrafo, título o punto de lista, en puntos (el interlineado, en veces la letra). */
+export interface RichSpacing {
+  before?: number;
+  after?: number;
+  lineHeight?: number;
+  /** Sangría de la primera línea. */
+  firstLine?: number;
+  /** Sangría de todo el párrafo, desde el margen izquierdo. */
+  left?: number;
+}
+
+/** Límites del espaciado, en puntos. */
+export const RICH_SPACING_LIMITS = { maxSpace: 72, maxIndent: 216, minLineHeight: 0.8, maxLineHeight: 3 } as const;
+
+/** Tamaños de hoja, en puntos. Oficio es el chileno: 216 x 330 mm. */
+export const RICH_PAGE_SIZES = {
+  letter: { label: 'Carta (216 x 279 mm)', width: 612, height: 792 },
+  oficio: { label: 'Oficio (216 x 330 mm)', width: 612, height: 936 },
+} as const;
+
+export type RichPageSize = keyof typeof RICH_PAGE_SIZES;
+
+export interface RichMargins {
+  top: number;
+  right: number;
+  bottom: number;
+  left: number;
+}
+
+/**
+ * Márgenes mínimos, en puntos: arriba van el membrete y el número con la fecha que estampa el sistema; abajo, la
+ * franja del QR en cada página; a los costados, los sellos. Con menos, lo estampado taparía el texto.
+ */
+export const RICH_MIN_MARGINS: RichMargins = { top: 64, right: 42, bottom: 64, left: 42 };
+
+/** Márgenes máximos, en puntos (unos 5 cm). */
+export const RICH_MAX_MARGIN = 144;
+
+/** Página de un documento: tamaño, márgenes y letra base. La define la plantilla; quien redacta no la cambia. */
+export interface RichPage {
+  size: RichPageSize;
+  margins: RichMargins;
+  font: RichFont;
+  fontSize: number;
+  lineHeight: number;
+}
+
+/** Página de siempre: Carta, con el espacio del membrete y los sellos, en Roboto 11. */
+export const RICH_DEFAULT_PAGE: RichPage = {
+  size: 'letter',
+  margins: { top: 104, right: 64, bottom: 76, left: 72 },
+  font: 'Roboto',
+  fontSize: 11,
+  lineHeight: 1.2,
+};
+
+/**
+ * Membrete de la plantilla, en el margen superior de cada página: un logo o escudo (opcional) y el nombre de la
+ * municipalidad y de la unidad que emite. Va a la izquierda: a la derecha el sistema estampa el número y la fecha.
+ */
+export interface RichLetterhead {
+  /** Imagen registrada en el gestor (`RichImage`), no un archivo de Drive. */
+  imageId?: string | null;
+  /** Alto del logo, en puntos. */
+  imageHeight?: number;
+  showOrganName: boolean;
+  showUnitName: boolean;
+  /** Líneas propias bajo el nombre, como la dirección o el teléfono. */
+  lines?: string[];
+}
+
+export const RICH_DEFAULT_LETTERHEAD: RichLetterhead = { imageId: null, showOrganName: true, showUnitName: true };
+
+/** Límites de una imagen: formatos, peso y tamaño en el texto. */
+export const RICH_IMAGE_LIMITS = {
+  types: ['image/png', 'image/jpeg'],
+  maxBytes: 2_000_000,
+  minWidth: 24,
+  maxLetterheadHeight: 56,
+} as const;
+
+/** Imagen subida al gestor para el editor: se usa por su id; el archivo está en Drive. */
+export interface RichImageResponseEntity {
+  id: string;
+  name: string;
+  mimeType: string;
+  width: number;
+  height: number;
+}

package/src/entities/documentTemplate/documentTemplate.entity.ts

@@ -1,5 +1,6 @@
 import { type DocumentTemplateEntity } from '../../base/entities';
 import { type RichBlock, type RichField } from '../document/document.entity';
+import { type RichLetterhead, type RichPage } from '../document/richStyle';
 
 /**
  * Contenido de una plantilla propia: los bloques del editor (con sus partes fijas) y los campos que completa quien
@@ -8,6 +9,10 @@ import { type RichBlock, type RichField } from '../document/document.entity';
 export interface DocumentTemplateContent {
   blocks: RichBlock[];
   fields: RichField[];
+  /** Tamaño de hoja, márgenes y letra base. Sin valor, la página de siempre (`RICH_DEFAULT_PAGE`). */
+  page?: RichPage;
+  /** Membrete con logo. Sin valor, el nombre de la municipalidad y de la unidad. */
+  letterhead?: RichLetterhead;
 }
 
 /** Plantilla propia en el listado de quien las administra. */
@@ -43,6 +48,8 @@ export interface DocumentTemplateAvailableResponseEntity {
   description: string | null;
   version: DocumentTemplateEntity['version'];
   content: DocumentTemplateContent;
+  /** Es la plantilla del tipo documental pedido: se aplica sola al redactar. */
+  ownedByType: boolean;
 }
 
 export interface DocumentTemplateCreateResponseEntity {

package/src/entities/documentType/documentType.entity.ts

@@ -1,4 +1,5 @@
 import { DocumentTypeEntity, DocumentTypeFlowStepEntity } from '../../base/entities';
+import { type DocumentTemplateContent } from '../documentTemplate/documentTemplate.entity';
 
 /** Paso del flujo sugerido de un tipo documental: quién visa o firma, en su orden. */
 export interface DocumentTypeFlowStepResponseEntity {
@@ -45,6 +46,15 @@ export interface DocumentTypeGetAllResponseEntity {
   enabled: DocumentTypeEntity['enabled'];
   // Cuántos visadores y firmantes tiene su flujo sugerido.
   flow: { visa: number; signature: number };
+  // Tiene plantilla propia: se aplica sola al redactar.
+  hasTemplate: boolean;
+}
+
+/** Plantilla propia de un tipo documental: la versión vigente de su contenido. */
+export interface DocumentTypeTemplateResponseEntity {
+  id: string;
+  version: number;
+  content: DocumentTemplateContent;
 }
 
 export interface DocumentTypeGetByIdResponseEntity extends DocumentTypeGetAllResponseEntity {
@@ -53,6 +63,8 @@ export interface DocumentTypeGetByIdResponseEntity extends DocumentTypeGetAllRes
   lastCorrelative: number | null;
   // Flujo sugerido: primero los visadores y después los firmantes, cada grupo en su orden.
   flowSteps: DocumentTypeFlowStepResponseEntity[];
+  // Plantilla propia del tipo (sin valor: no la tiene).
+  template: DocumentTypeTemplateResponseEntity | null;
 }
 
 export interface DocumentTypeCreateResponseEntity {