@muni-sanfer/types-gestor-documental 0.0.1-beta.35 → 0.0.1-beta.37

package/dist/base/entities.d.ts

@@ -660,6 +660,7 @@ export interface CaseFileEntity {
     metadataChanges?: CaseFileMetadataChangeEntity[];
     accesses?: CaseFileAccessEntity[];
     shareLinks?: CaseFileShareLinkEntity[];
+    integratedPdf?: JsonValue | null;
     createdAt: string;
     updatedAt: string;
     workFolder?: WorkFolderEntity | null;

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

@@ -1,5 +1,5 @@
 import { type CaseFileActorRelation, type CaseFileActorType, type CaseFileActuationType, type CaseFileEntity, type CaseFileStatus, type DocumentAccessLevel } from '../base/entities';
-import { type CaseFileAddBatchResponseEntity, type CaseFileAddEntryResponseEntity, type CaseFileCreateResponseEntity, type CaseFileEntryFileResponseEntity, type CaseFileExportResponseEntity, type CaseFileGetAllResponseEntity, type CaseFileGetByIdResponseEntity, type CaseFileShareLinkCreateResponseEntity, type CaseFileShareLinkResponseEntity, type CaseFileSharedResponseEntity, type CaseFileUpdateResponseEntity, type CaseFileVerifyExportResponseEntity } from '../entities';
+import { type CaseFileAddBatchResponseEntity, type CaseFileAddEntryResponseEntity, type CaseFileCreateResponseEntity, type CaseFileEntryFileResponseEntity, type CaseFileExportResponseEntity, type CaseFileGetAllResponseEntity, type CaseFileGetByIdResponseEntity, type CaseFileShareLinkCreateResponseEntity, type CaseFileShareLinkResponseEntity, type CaseFileSharedResponseEntity, type CaseFileUpdateResponseEntity, type CaseFileVerifyExportResponseEntity, type DocumentPublicFileResponseEntity } from '../entities';
 import { type RpcPage } from './contract';
 import { type DocumentActor } from './document.contract';
 /** Patrones NATS de `caseFile`: `<servicio>.<recurso>.<acción>`. */
@@ -17,6 +17,7 @@ export declare const CaseFilePatterns: {
     readonly close: "gestorDocumental.caseFile.close";
     readonly getEntryFile: "gestorDocumental.caseFile.getEntryFile";
     readonly getExport: "gestorDocumental.caseFile.getExport";
+    readonly getIntegratedPdf: "gestorDocumental.caseFile.getIntegratedPdf";
     readonly createShareLink: "gestorDocumental.caseFile.createShareLink";
     readonly getShareLinks: "gestorDocumental.caseFile.getShareLinks";
     readonly revokeShareLink: "gestorDocumental.caseFile.revokeShareLink";
@@ -204,6 +205,15 @@ export interface CaseFileContract {
         payload: Pick<CaseFileEntity, 'id'> & CaseFileActorPayload;
         response: CaseFileExportResponseEntity;
     };
+    /**
+     * PDF integrador: todas las actuaciones en un solo PDF, en orden de incorporación, con portada e índice. Queda en la
+     * trazabilidad y en el registro de accesos, como la exportación. Sin el sello de copia autorizada (necesita firma
+     * desatendida).
+     */
+    [CaseFilePatterns.getIntegratedPdf]: {
+        payload: Pick<CaseFileEntity, 'id'> & CaseFileActorPayload;
+        response: DocumentPublicFileResponseEntity;
+    };
     /** Crea un enlace temporal: solo su responsable. El token viaja solo en esta respuesta. */
     [CaseFilePatterns.createShareLink]: {
         payload: Pick<CaseFileEntity, 'id'> & CaseFileShareLinkPayload & {

package/dist/contracts/caseFile.contract.js

@@ -16,6 +16,7 @@ exports.CaseFilePatterns = {
     close: 'gestorDocumental.caseFile.close',
     getEntryFile: 'gestorDocumental.caseFile.getEntryFile',
     getExport: 'gestorDocumental.caseFile.getExport',
+    getIntegratedPdf: 'gestorDocumental.caseFile.getIntegratedPdf',
     createShareLink: 'gestorDocumental.caseFile.createShareLink',
     getShareLinks: 'gestorDocumental.caseFile.getShareLinks',
     revokeShareLink: 'gestorDocumental.caseFile.revokeShareLink',

package/dist/contracts/index.d.ts

@@ -114,6 +114,7 @@ export declare const GestorDocumentalPatterns: {
         readonly close: "gestorDocumental.caseFile.close";
         readonly getEntryFile: "gestorDocumental.caseFile.getEntryFile";
         readonly getExport: "gestorDocumental.caseFile.getExport";
+        readonly getIntegratedPdf: "gestorDocumental.caseFile.getIntegratedPdf";
         readonly createShareLink: "gestorDocumental.caseFile.createShareLink";
         readonly getShareLinks: "gestorDocumental.caseFile.getShareLinks";
         readonly revokeShareLink: "gestorDocumental.caseFile.revokeShareLink";

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

@@ -390,6 +390,77 @@ 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';
+/**
+ * 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 RichAlign = 'left' | 'center' | 'right' | 'justify';
+/** Numeración de una lista: viñetas, «1.» o la de los decretos, «1.-». */
+export type RichListStyle = 'bullet' | 'decimal' | 'decree';
+/**
+ * Cómo se ve una tabla: con bordes (`grid`), o como las líneas «DE:», «A:», «MAT.:» de un oficio, con la etiqueta en
+ * negrita y sin bordes (`labels`, o `labelsRight`, en la mitad derecha, como «ANT.» y «MAT.» de un oficio).
+ */
+export type RichTableVariant = 'grid' | 'labels' | 'labelsRight';
+/**
+ * Un bloque del texto. Los de una plantilla pueden ser fijos (`locked`): quien redacta no los cambia. Las listas son
+ * 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[];
+}
+/** `rows[fila][columna]`: el contenido de cada celda. */
+ | {
+    id: string;
+    type: 'table';
+    variant: RichTableVariant;
+    locked?: boolean;
+    rows: RichInline[][][];
+} | {
+    id: string;
+    type: 'rule';
+    locked?: boolean;
+} | {
+    id: string;
+    type: 'pageBreak';
+    locked?: boolean;
+};
+/**
+ * Campo de una plantilla, con el valor que le dio quien redacta. `materia` es el asunto del documento: no se escribe
+ * aparte.
+ */
+export interface RichField {
+    key: string;
+    label: string;
+    value: string;
+    required?: boolean;
+}
 /**
  * Contenido de un documento redactado en el sistema. Cada plantilla tiene su estructura; los párrafos son texto
  * (un salto de línea dentro de un párrafo se respeta). La materia es el asunto del documento.
@@ -426,6 +497,18 @@ export type DocumentComposition = {
     title: string;
     body: string[];
     closing?: string | null;
+}
+/**
+ * Redactado con el editor del gestor: los bloques del texto, los campos de la plantilla con su valor y la
+ * distribución. `templateKey` y `templateVersion`: de qué plantilla salió, si salió de una.
+ */
+ | {
+    template: 'Rich';
+    templateKey?: string | null;
+    templateVersion?: number | null;
+    blocks: RichBlock[];
+    fields: RichField[];
+    distribution: string[];
 };
 /** PDF armado con una plantilla: para la vista previa (`contentBase64`) o ya subido (`fileId`). */
 export interface DocumentComposeResponseEntity {

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

@@ -4,6 +4,15 @@
  */
 export type PdfSignatureStatus = 'Valid' | 'Invalid' | 'Indeterminate';
 /** Una firma electrónica de un PDF, como se pudo comprobar. */
+/** Si el certificado de una firma fue revocado, según su emisor (OCSP o lista de revocación). */
+export interface PdfRevocationEntity {
+    /** `NotChecked`: la revisión está desactivada en el servidor. `Unknown`: no se pudo confirmar. */
+    status: 'Good' | 'Revoked' | 'Unknown' | 'NotChecked';
+    source: 'OCSP' | 'CRL' | null;
+    revokedAt: string | null;
+    /** Por qué no se pudo confirmar. */
+    detail: string | null;
+}
 export interface PdfSignatureEntity {
     /** Orden en el archivo: 1 es la primera. */
     index: number;
@@ -31,6 +40,8 @@ export interface PdfSignatureEntity {
     certificateValidAtSigning: boolean | null;
     /** Cadena hasta un certificado raíz de confianza. `null` si no hay raíces configuradas. */
     trusted: boolean | null;
+    /** Si el certificado fue revocado. Falta en las revisiones anteriores a que se consultara. */
+    revocation?: PdfRevocationEntity;
     status: PdfSignatureStatus;
     /** Lo que no cuadra o no se pudo confirmar, en palabras. */
     problems: string[];

package/package.json

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

package/src/base/entities.ts

@@ -864,6 +864,7 @@ export interface CaseFileEntity {
   metadataChanges?: CaseFileMetadataChangeEntity[];
   accesses?: CaseFileAccessEntity[];
   shareLinks?: CaseFileShareLinkEntity[];
+  integratedPdf?: JsonValue | null;
   createdAt: string;
   updatedAt: string;
   workFolder?: WorkFolderEntity | null;

package/src/contracts/caseFile.contract.ts

@@ -19,6 +19,7 @@ import {
   type CaseFileSharedResponseEntity,
   type CaseFileUpdateResponseEntity,
   type CaseFileVerifyExportResponseEntity,
+  type DocumentPublicFileResponseEntity,
 } from '../entities';
 import { type RpcPage } from './contract';
 import { type DocumentActor } from './document.contract';
@@ -38,6 +39,7 @@ export const CaseFilePatterns = {
   close: 'gestorDocumental.caseFile.close',
   getEntryFile: 'gestorDocumental.caseFile.getEntryFile',
   getExport: 'gestorDocumental.caseFile.getExport',
+  getIntegratedPdf: 'gestorDocumental.caseFile.getIntegratedPdf',
   createShareLink: 'gestorDocumental.caseFile.createShareLink',
   getShareLinks: 'gestorDocumental.caseFile.getShareLinks',
   revokeShareLink: 'gestorDocumental.caseFile.revokeShareLink',
@@ -189,6 +191,15 @@ export interface CaseFileContract {
     payload: Pick<CaseFileEntity, 'id'> & CaseFileActorPayload;
     response: CaseFileExportResponseEntity;
   };
+  /**
+   * PDF integrador: todas las actuaciones en un solo PDF, en orden de incorporación, con portada e índice. Queda en la
+   * trazabilidad y en el registro de accesos, como la exportación. Sin el sello de copia autorizada (necesita firma
+   * desatendida).
+   */
+  [CaseFilePatterns.getIntegratedPdf]: {
+    payload: Pick<CaseFileEntity, 'id'> & CaseFileActorPayload;
+    response: DocumentPublicFileResponseEntity;
+  };
   /** Crea un enlace temporal: solo su responsable. El token viaja solo en esta respuesta. */
   [CaseFilePatterns.createShareLink]: {
     payload: Pick<CaseFileEntity, 'id'> & CaseFileShareLinkPayload & { actor: DocumentActor };

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

@@ -439,6 +439,50 @@ 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';
+
+/**
+ * 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 RichAlign = 'left' | 'center' | 'right' | 'justify';
+
+/** Numeración de una lista: viñetas, «1.» o la de los decretos, «1.-». */
+export type RichListStyle = 'bullet' | 'decimal' | 'decree';
+
+/**
+ * Cómo se ve una tabla: con bordes (`grid`), o como las líneas «DE:», «A:», «MAT.:» de un oficio, con la etiqueta en
+ * negrita y sin bordes (`labels`, o `labelsRight`, en la mitad derecha, como «ANT.» y «MAT.» de un oficio).
+ */
+export type RichTableVariant = 'grid' | 'labels' | 'labelsRight';
+
+/**
+ * Un bloque del texto. Los de una plantilla pueden ser fijos (`locked`): quien redacta no los cambia. Las listas son
+ * 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[] }
+  /** `rows[fila][columna]`: el contenido de cada celda. */
+  | { id: string; type: 'table'; variant: RichTableVariant; locked?: boolean; rows: RichInline[][][] }
+  | { id: string; type: 'rule'; locked?: boolean }
+  | { id: string; type: 'pageBreak'; locked?: boolean };
+
+/**
+ * Campo de una plantilla, con el valor que le dio quien redacta. `materia` es el asunto del documento: no se escribe
+ * aparte.
+ */
+export interface RichField {
+  key: string;
+  label: string;
+  value: string;
+  required?: boolean;
+}
+
 /**
  * Contenido de un documento redactado en el sistema. Cada plantilla tiene su estructura; los párrafos son texto
  * (un salto de línea dentro de un párrafo se respeta). La materia es el asunto del documento.
@@ -474,7 +518,19 @@ export type DocumentComposition =
       closing?: string | null;
       distribution: string[];
     }
-  | { template: 'General'; title: string; body: string[]; closing?: string | null };
+  | { template: 'General'; title: string; body: string[]; closing?: string | null }
+  /**
+   * Redactado con el editor del gestor: los bloques del texto, los campos de la plantilla con su valor y la
+   * distribución. `templateKey` y `templateVersion`: de qué plantilla salió, si salió de una.
+   */
+  | {
+      template: 'Rich';
+      templateKey?: string | null;
+      templateVersion?: number | null;
+      blocks: RichBlock[];
+      fields: RichField[];
+      distribution: string[];
+    };
 
 /** PDF armado con una plantilla: para la vista previa (`contentBase64`) o ya subido (`fileId`). */
 export interface DocumentComposeResponseEntity {

package/src/entities/signatureCheck/signatureCheck.entity.ts

@@ -5,6 +5,16 @@
 export type PdfSignatureStatus = 'Valid' | 'Invalid' | 'Indeterminate';
 
 /** Una firma electrónica de un PDF, como se pudo comprobar. */
+/** Si el certificado de una firma fue revocado, según su emisor (OCSP o lista de revocación). */
+export interface PdfRevocationEntity {
+  /** `NotChecked`: la revisión está desactivada en el servidor. `Unknown`: no se pudo confirmar. */
+  status: 'Good' | 'Revoked' | 'Unknown' | 'NotChecked';
+  source: 'OCSP' | 'CRL' | null;
+  revokedAt: string | null;
+  /** Por qué no se pudo confirmar. */
+  detail: string | null;
+}
+
 export interface PdfSignatureEntity {
   /** Orden en el archivo: 1 es la primera. */
   index: number;
@@ -32,6 +42,8 @@ export interface PdfSignatureEntity {
   certificateValidAtSigning: boolean | null;
   /** Cadena hasta un certificado raíz de confianza. `null` si no hay raíces configuradas. */
   trusted: boolean | null;
+  /** Si el certificado fue revocado. Falta en las revisiones anteriores a que se consultara. */
+  revocation?: PdfRevocationEntity;
   status: PdfSignatureStatus;
   /** Lo que no cuadra o no se pudo confirmar, en palabras. */
   problems: string[];