@muni-sanfer/types-gestor-documental 0.0.1-beta.20 → 0.0.1-beta.22

package/dist/base/entities.d.ts

@@ -521,6 +521,7 @@ export interface CaseFileEntryEntity {
     sha256?: string | null;
     size?: number | null;
     hasAdvancedSignature: boolean;
+    signatureCheck?: JsonValue | null;
     incorporatedByEmployeeId: string;
     incorporatedByFullName: string;
     voidedAt?: string | null;
@@ -658,6 +659,7 @@ export interface DocDigitalInboundEntity {
     fileId?: string | null;
     fileName?: string | null;
     attachments: JsonValue;
+    signatureCheck?: JsonValue | null;
     registeredAt?: string | null;
     registeredByEmployeeId?: string | null;
     registeredByFullName?: string | null;

package/dist/contracts/index.d.ts

@@ -7,6 +7,7 @@ import { type TextSnippetContract } from './textSnippet.contract';
 import { type HolidayContract } from './holiday.contract';
 import { type IndicatorsContract } from './indicators.contract';
 import { type AuditContract } from './audit.contract';
+import { type SignatureCheckContract } from './signatureCheck.contract';
 import { type ScanContract } from './scan.contract';
 import { type PartsOfficeContract } from './partsOffice.contract';
 import { type ProcedureContract } from './procedure.contract';
@@ -29,6 +30,7 @@ export * from './textSnippet.contract';
 export * from './holiday.contract';
 export * from './indicators.contract';
 export * from './audit.contract';
+export * from './signatureCheck.contract';
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export declare const GestorDocumentalPatterns: {
     readonly documentType: {
@@ -117,6 +119,7 @@ export declare const GestorDocumentalPatterns: {
         readonly acknowledgeInbound: "gestorDocumental.partsOffice.acknowledgeInbound";
         readonly returnInbound: "gestorDocumental.partsOffice.returnInbound";
         readonly getInboundFile: "gestorDocumental.partsOffice.getInboundFile";
+        readonly checkEnablement: "gestorDocumental.partsOffice.checkEnablement";
     };
     readonly registerBook: {
         readonly get: "gestorDocumental.registerBook.get";
@@ -184,6 +187,9 @@ export declare const GestorDocumentalPatterns: {
         readonly getEvents: "gestorDocumental.audit.getEvents";
         readonly export: "gestorDocumental.audit.export";
     };
+    readonly signatureCheck: {
+        readonly check: "gestorDocumental.signatureCheck.check";
+    };
 };
 /** 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 & HolidayContract & IndicatorsContract & AuditContract;
+export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & IssuingEntityContract & CaseFileContract & PartsOfficeContract & RegisterBookContract & SignatureBatchContract & WorkFolderContract & ScanContract & ArchivalSeriesContract & TextSnippetContract & HolidayContract & IndicatorsContract & AuditContract & SignatureCheckContract;

package/dist/contracts/index.js

@@ -24,6 +24,7 @@ const textSnippet_contract_1 = require("./textSnippet.contract");
 const holiday_contract_1 = require("./holiday.contract");
 const indicators_contract_1 = require("./indicators.contract");
 const audit_contract_1 = require("./audit.contract");
+const signatureCheck_contract_1 = require("./signatureCheck.contract");
 const scan_contract_1 = require("./scan.contract");
 const partsOffice_contract_1 = require("./partsOffice.contract");
 const procedure_contract_1 = require("./procedure.contract");
@@ -46,6 +47,7 @@ __exportStar(require("./textSnippet.contract"), exports);
 __exportStar(require("./holiday.contract"), exports);
 __exportStar(require("./indicators.contract"), exports);
 __exportStar(require("./audit.contract"), exports);
+__exportStar(require("./signatureCheck.contract"), exports);
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 exports.GestorDocumentalPatterns = {
     documentType: documentType_contract_1.DocumentTypePatterns,
@@ -63,4 +65,5 @@ exports.GestorDocumentalPatterns = {
     holiday: holiday_contract_1.HolidayPatterns,
     indicators: indicators_contract_1.IndicatorsPatterns,
     audit: audit_contract_1.AuditPatterns,
+    signatureCheck: signatureCheck_contract_1.SignatureCheckPatterns,
 };

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

@@ -1,5 +1,5 @@
 import { type DocumentAccessLevel, type DocumentInstruction } from '../base/entities';
-import { type DocDigitalDocumentTypeEntity, type DocDigitalEntityEntity, type PartsOfficeInboundEntity, type DocDigitalUserEntity, type PartsOfficeDispatchEntity, type PartsOfficeFileEntity, type PartsOfficeOkResponseEntity, type PartsOfficeRegisterResponseEntity, type PartsOfficeStatusEntity, type PartsOfficeSummaryEntity, type PartsOfficeSyncResponseEntity } from '../entities';
+import { type DocDigitalDocumentTypeEntity, type DocDigitalEntityEntity, type PartsOfficeInboundEntity, type DocDigitalUserEntity, type EnablementPersonInput, type PartsOfficeEnablementEntity, type PartsOfficeDispatchEntity, type PartsOfficeFileEntity, type PartsOfficeOkResponseEntity, type PartsOfficeRegisterResponseEntity, type PartsOfficeStatusEntity, type PartsOfficeSummaryEntity, type PartsOfficeSyncResponseEntity } from '../entities';
 import { type RpcPage } from './contract';
 import { type DocumentActor, type DocumentExternalRecipientInput } from './document.contract';
 /** Patrones NATS de `partsOffice` (Oficina de Partes y DocDigital): `<servicio>.<recurso>.<acción>`. */
@@ -21,6 +21,7 @@ export declare const PartsOfficePatterns: {
     readonly acknowledgeInbound: "gestorDocumental.partsOffice.acknowledgeInbound";
     readonly returnInbound: "gestorDocumental.partsOffice.returnInbound";
     readonly getInboundFile: "gestorDocumental.partsOffice.getInboundFile";
+    readonly checkEnablement: "gestorDocumental.partsOffice.checkEnablement";
 };
 /** Destinatario interno de un ingreso, ya resuelto por el gateway (las áreas con sus integrantes). */
 export type PartsOfficeRecipientInput = {
@@ -173,5 +174,15 @@ export interface PartsOfficeContract {
         };
         response: PartsOfficeFileEntity;
     };
+    /**
+     * Quiénes de `people` están habilitados como usuarios de DocDigital en la municipalidad o en sus entidades emisoras
+     * (por RUN). El directorio de cada entidad se guarda 10 minutos.
+     */
+    [PartsOfficePatterns.checkEnablement]: {
+        payload: {
+            people: EnablementPersonInput[];
+        };
+        response: PartsOfficeEnablementEntity;
+    };
 }
 export {};

package/dist/contracts/partsOffice.contract.js

@@ -20,4 +20,5 @@ exports.PartsOfficePatterns = {
     acknowledgeInbound: 'gestorDocumental.partsOffice.acknowledgeInbound',
     returnInbound: 'gestorDocumental.partsOffice.returnInbound',
     getInboundFile: 'gestorDocumental.partsOffice.getInboundFile',
+    checkEnablement: 'gestorDocumental.partsOffice.checkEnablement',
 };

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

@@ -0,0 +1,14 @@
+import { type PdfSignatureReportEntity } from '../entities';
+/** Patrones NATS de `signatureCheck`: revisión de las firmas electrónicas de un PDF. */
+export declare const SignatureCheckPatterns: {
+    readonly check: "gestorDocumental.signatureCheck.check";
+};
+export interface SignatureCheckContract {
+    /** Revisa un PDF ya subido al gestor de archivos (la herramienta «Validar firmas» lo sube antes). */
+    [SignatureCheckPatterns.check]: {
+        payload: {
+            fileId: string;
+        };
+        response: PdfSignatureReportEntity;
+    };
+}

package/dist/contracts/signatureCheck.contract.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignatureCheckPatterns = void 0;
+/** Patrones NATS de `signatureCheck`: revisión de las firmas electrónicas de un PDF. */
+exports.SignatureCheckPatterns = {
+    check: 'gestorDocumental.signatureCheck.check',
+};

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

@@ -1,5 +1,6 @@
 import { CaseFileAccessEntity, CaseFileActorEntity, CaseFileEntity, CaseFileEntryEntity, CaseFileMetadataChangeEntity, CaseFileParticipantEntity, CaseFileTrackingEntity, DocumentEntity, ProcedureEntity } from '../../base/entities';
 import { DocumentTypeSummaryEntity } from '../document';
+import { type PdfSignatureReportEntity } from '../signatureCheck';
 /** Expediente al que se hace referencia desde otro lado: cómo se cita y en qué estado está. */
 export interface CaseFileLinkEntity {
     id: CaseFileEntity['id'];
@@ -56,6 +57,8 @@ export interface CaseFileEntryResponseEntity {
     sha256: CaseFileEntryEntity['sha256'];
     size: CaseFileEntryEntity['size'];
     hasAdvancedSignature: CaseFileEntryEntity['hasAdvancedSignature'];
+    /** Revisión de sus firmas al incorporarlo, en los archivos externos en PDF. */
+    signatureCheck: PdfSignatureReportEntity | null;
     incorporatedByEmployeeId: CaseFileEntryEntity['incorporatedByEmployeeId'];
     incorporatedByFullName: CaseFileEntryEntity['incorporatedByFullName'];
     createdAt: CaseFileEntryEntity['createdAt'];

package/dist/entities/index.d.ts

@@ -13,3 +13,4 @@ export * from './textSnippet';
 export * from './holiday';
 export * from './indicators';
 export * from './audit';
+export * from './signatureCheck';

package/dist/entities/index.js

@@ -29,3 +29,4 @@ __exportStar(require("./textSnippet"), exports);
 __exportStar(require("./holiday"), exports);
 __exportStar(require("./indicators"), exports);
 __exportStar(require("./audit"), exports);
+__exportStar(require("./signatureCheck"), exports);

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

@@ -1,3 +1,4 @@
+import { type PdfSignatureReportEntity } from '../signatureCheck';
 import { type DocumentDispatchResponseEntity, type DocumentExternalRecipientResponseEntity, type DocumentLinkEntity } from '../document';
 /** Institución del Estado en DocDigital. */
 export interface DocDigitalEntityEntity {
@@ -54,6 +55,8 @@ export interface PartsOfficeInboundEntity {
     senderPosition: string | null;
     fileName: string | null;
     hasFile: boolean;
+    /** Revisión de las firmas del documento principal al recibirlo. */
+    signatureCheck: PdfSignatureReportEntity | null;
     attachments: {
         name: string;
         url: string | null;
@@ -100,3 +103,35 @@ export interface PartsOfficeFileEntity {
     fileId: string;
     fileName: string;
 }
+/** Por qué una persona tiene que estar habilitada en DocDigital. */
+export type EnablementRole = 'PartsOffice' | 'Signer';
+/** Persona que se revisa: la arma el gateway con organizacion-ms (permisos de Partes y firmantes por cargo). */
+export interface EnablementPersonInput {
+    employeeId: string;
+    fullName: string;
+    /** RUN del funcionario; sin él no se puede buscar en DocDigital. */
+    rut: string | null;
+    position: string | null;
+    roles: EnablementRole[];
+}
+/** Resultado de una persona: en qué entidades de DocDigital está habilitada. */
+export interface EnablementPersonEntity extends EnablementPersonInput {
+    status: 'Enabled' | 'NotEnabled' | 'NoRut';
+    enabledIn: {
+        entityId: number;
+        entityName: string;
+        docDigitalPosition: string | null;
+    }[];
+}
+export interface PartsOfficeEnablementEntity {
+    checkedAt: string;
+    /** DocDigital configurado en el gestor; sin él no se revisa nada. */
+    configured: boolean;
+    /** Entidades revisadas: la municipalidad y las entidades emisoras con DocDigital. */
+    entities: {
+        entityId: number;
+        entityName: string;
+        userCount: number;
+    }[];
+    people: EnablementPersonEntity[];
+}

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

@@ -0,0 +1 @@
+export * from './signatureCheck.entity';

package/dist/entities/signatureCheck/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./signatureCheck.entity"), exports);

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

@@ -0,0 +1,49 @@
+/**
+ * Resultado de una firma o del archivo completo: válida, inválida (algo no cuadra) o indeterminada (lo firmado está
+ * íntegro, pero falta confirmar algo: la cadena de confianza, la vigencia o cambios posteriores sin firmar).
+ */
+export type PdfSignatureStatus = 'Valid' | 'Invalid' | 'Indeterminate';
+/** Una firma electrónica de un PDF, como se pudo comprobar. */
+export interface PdfSignatureEntity {
+    /** Orden en el archivo: 1 es la primera. */
+    index: number;
+    /** Firma de una persona o sello de tiempo del documento. */
+    kind: 'Signature' | 'Timestamp';
+    signerName: string | null;
+    /** Identificador del titular en el certificado (en Chile, suele ser el RUN). */
+    signerSerialNumber: string | null;
+    organization: string | null;
+    issuerName: string | null;
+    certificateSerial: string | null;
+    certificateValidFrom: string | null;
+    certificateValidTo: string | null;
+    signingTime: string | null;
+    /** De dónde sale la hora de la firma: sello de tiempo (la más confiable), el certificado firmado o el PDF. */
+    signingTimeSource: 'Timestamp' | 'SignedAttribute' | 'PdfDate' | null;
+    reason: string | null;
+    location: string | null;
+    hasTimestamp: boolean;
+    /** Lo firmado no cambió y la firma corresponde al certificado. */
+    intact: boolean;
+    /** La firma abarca el archivo completo (las anteriores a la última, solo su versión). */
+    coversWholeDocument: boolean;
+    /** El certificado estaba vigente al firmar. `null` si no se sabe cuándo se firmó. */
+    certificateValidAtSigning: boolean | null;
+    /** Cadena hasta un certificado raíz de confianza. `null` si no hay raíces configuradas. */
+    trusted: boolean | null;
+    status: PdfSignatureStatus;
+    /** Lo que no cuadra o no se pudo confirmar, en palabras. */
+    problems: string[];
+}
+/** Revisión de las firmas de un PDF. */
+export interface PdfSignatureReportEntity {
+    checkedAt: string;
+    status: 'NoSignatures' | PdfSignatureStatus;
+    signatures: PdfSignatureEntity[];
+    /** Hay contenido agregado después de la última firma, que no está firmado. */
+    modifiedAfterLastSignature: boolean;
+    /** Se configuraron certificados raíz para confirmar la cadena de confianza. */
+    trustConfigured: boolean;
+    /** Huella SHA-256 del archivo revisado. */
+    fileSha256: string;
+}

package/dist/entities/signatureCheck/signatureCheck.entity.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

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

package/src/base/entities.ts

@@ -653,6 +653,7 @@ export interface CaseFileEntryEntity {
   sha256?: string | null;
   size?: number | null;
   hasAdvancedSignature: boolean;
+  signatureCheck?: JsonValue | null;
   incorporatedByEmployeeId: string;
   incorporatedByFullName: string;
   voidedAt?: string | null;
@@ -799,6 +800,7 @@ export interface DocDigitalInboundEntity {
   fileId?: string | null;
   fileName?: string | null;
   attachments: JsonValue;
+  signatureCheck?: JsonValue | null;
   registeredAt?: string | null;
   registeredByEmployeeId?: string | null;
   registeredByFullName?: string | null;

package/src/contracts/index.ts

@@ -7,6 +7,7 @@ import { TextSnippetPatterns, type TextSnippetContract } from './textSnippet.con
 import { HolidayPatterns, type HolidayContract } from './holiday.contract';
 import { IndicatorsPatterns, type IndicatorsContract } from './indicators.contract';
 import { AuditPatterns, type AuditContract } from './audit.contract';
+import { SignatureCheckPatterns, type SignatureCheckContract } from './signatureCheck.contract';
 import { ScanPatterns, type ScanContract } from './scan.contract';
 import { PartsOfficePatterns, type PartsOfficeContract } from './partsOffice.contract';
 import { ProcedurePatterns, type ProcedureContract } from './procedure.contract';
@@ -30,6 +31,7 @@ export * from './textSnippet.contract';
 export * from './holiday.contract';
 export * from './indicators.contract';
 export * from './audit.contract';
+export * from './signatureCheck.contract';
 
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export const GestorDocumentalPatterns = {
@@ -48,6 +50,7 @@ export const GestorDocumentalPatterns = {
   holiday: HolidayPatterns,
   indicators: IndicatorsPatterns,
   audit: AuditPatterns,
+  signatureCheck: SignatureCheckPatterns,
 } as const;
 
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
@@ -65,4 +68,5 @@ export type GestorDocumentalContract = DocumentTypeContract &
   TextSnippetContract &
   HolidayContract &
   IndicatorsContract &
-  AuditContract;
+  AuditContract &
+  SignatureCheckContract;

package/src/contracts/partsOffice.contract.ts

@@ -4,6 +4,8 @@ import {
   type DocDigitalEntityEntity,
   type PartsOfficeInboundEntity,
   type DocDigitalUserEntity,
+  type EnablementPersonInput,
+  type PartsOfficeEnablementEntity,
   type PartsOfficeDispatchEntity,
   type PartsOfficeFileEntity,
   type PartsOfficeOkResponseEntity,
@@ -34,6 +36,7 @@ export const PartsOfficePatterns = {
   acknowledgeInbound: 'gestorDocumental.partsOffice.acknowledgeInbound',
   returnInbound: 'gestorDocumental.partsOffice.returnInbound',
   getInboundFile: 'gestorDocumental.partsOffice.getInboundFile',
+  checkEnablement: 'gestorDocumental.partsOffice.checkEnablement',
 } as const;
 
 /** Destinatario interno de un ingreso, ya resuelto por el gateway (las áreas con sus integrantes). */
@@ -120,4 +123,12 @@ export interface PartsOfficeContract {
     payload: { id: string; attachment?: number };
     response: PartsOfficeFileEntity;
   };
+  /**
+   * Quiénes de `people` están habilitados como usuarios de DocDigital en la municipalidad o en sus entidades emisoras
+   * (por RUN). El directorio de cada entidad se guarda 10 minutos.
+   */
+  [PartsOfficePatterns.checkEnablement]: {
+    payload: { people: EnablementPersonInput[] };
+    response: PartsOfficeEnablementEntity;
+  };
 }

package/src/contracts/signatureCheck.contract.ts

@@ -0,0 +1,11 @@
+import { type PdfSignatureReportEntity } from '../entities';
+
+/** Patrones NATS de `signatureCheck`: revisión de las firmas electrónicas de un PDF. */
+export const SignatureCheckPatterns = {
+  check: 'gestorDocumental.signatureCheck.check',
+} as const;
+
+export interface SignatureCheckContract {
+  /** Revisa un PDF ya subido al gestor de archivos (la herramienta «Validar firmas» lo sube antes). */
+  [SignatureCheckPatterns.check]: { payload: { fileId: string }; response: PdfSignatureReportEntity };
+}

package/src/entities/caseFile/caseFile.entity.ts

@@ -10,6 +10,7 @@ import {
   ProcedureEntity,
 } from '../../base/entities';
 import { DocumentTypeSummaryEntity } from '../document';
+import { type PdfSignatureReportEntity } from '../signatureCheck';
 
 /** Expediente al que se hace referencia desde otro lado: cómo se cita y en qué estado está. */
 export interface CaseFileLinkEntity {
@@ -70,6 +71,8 @@ export interface CaseFileEntryResponseEntity {
   sha256: CaseFileEntryEntity['sha256'];
   size: CaseFileEntryEntity['size'];
   hasAdvancedSignature: CaseFileEntryEntity['hasAdvancedSignature'];
+  /** Revisión de sus firmas al incorporarlo, en los archivos externos en PDF. */
+  signatureCheck: PdfSignatureReportEntity | null;
   incorporatedByEmployeeId: CaseFileEntryEntity['incorporatedByEmployeeId'];
   incorporatedByFullName: CaseFileEntryEntity['incorporatedByFullName'];
   createdAt: CaseFileEntryEntity['createdAt'];

package/src/entities/index.ts

@@ -13,3 +13,4 @@ export * from './textSnippet';
 export * from './holiday';
 export * from './indicators';
 export * from './audit';
+export * from './signatureCheck';

package/src/entities/partsOffice/partsOffice.entity.ts

@@ -1,3 +1,4 @@
+import { type PdfSignatureReportEntity } from '../signatureCheck';
 import {
   type DocumentDispatchResponseEntity,
   type DocumentExternalRecipientResponseEntity,
@@ -63,6 +64,8 @@ export interface PartsOfficeInboundEntity {
   senderPosition: string | null;
   fileName: string | null;
   hasFile: boolean;
+  /** Revisión de las firmas del documento principal al recibirlo. */
+  signatureCheck: PdfSignatureReportEntity | null;
   attachments: { name: string; url: string | null; hasFile: boolean }[];
   createdAt: string;
   registeredAt: string | null;
@@ -105,3 +108,31 @@ export interface PartsOfficeFileEntity {
   fileId: string;
   fileName: string;
 }
+
+/** Por qué una persona tiene que estar habilitada en DocDigital. */
+export type EnablementRole = 'PartsOffice' | 'Signer';
+
+/** Persona que se revisa: la arma el gateway con organizacion-ms (permisos de Partes y firmantes por cargo). */
+export interface EnablementPersonInput {
+  employeeId: string;
+  fullName: string;
+  /** RUN del funcionario; sin él no se puede buscar en DocDigital. */
+  rut: string | null;
+  position: string | null;
+  roles: EnablementRole[];
+}
+
+/** Resultado de una persona: en qué entidades de DocDigital está habilitada. */
+export interface EnablementPersonEntity extends EnablementPersonInput {
+  status: 'Enabled' | 'NotEnabled' | 'NoRut';
+  enabledIn: { entityId: number; entityName: string; docDigitalPosition: string | null }[];
+}
+
+export interface PartsOfficeEnablementEntity {
+  checkedAt: string;
+  /** DocDigital configurado en el gestor; sin él no se revisa nada. */
+  configured: boolean;
+  /** Entidades revisadas: la municipalidad y las entidades emisoras con DocDigital. */
+  entities: { entityId: number; entityName: string; userCount: number }[];
+  people: EnablementPersonEntity[];
+}

package/src/entities/signatureCheck/index.ts

@@ -0,0 +1 @@
+export * from './signatureCheck.entity';

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

@@ -0,0 +1,51 @@
+/**
+ * Resultado de una firma o del archivo completo: válida, inválida (algo no cuadra) o indeterminada (lo firmado está
+ * íntegro, pero falta confirmar algo: la cadena de confianza, la vigencia o cambios posteriores sin firmar).
+ */
+export type PdfSignatureStatus = 'Valid' | 'Invalid' | 'Indeterminate';
+
+/** Una firma electrónica de un PDF, como se pudo comprobar. */
+export interface PdfSignatureEntity {
+  /** Orden en el archivo: 1 es la primera. */
+  index: number;
+  /** Firma de una persona o sello de tiempo del documento. */
+  kind: 'Signature' | 'Timestamp';
+  signerName: string | null;
+  /** Identificador del titular en el certificado (en Chile, suele ser el RUN). */
+  signerSerialNumber: string | null;
+  organization: string | null;
+  issuerName: string | null;
+  certificateSerial: string | null;
+  certificateValidFrom: string | null;
+  certificateValidTo: string | null;
+  signingTime: string | null;
+  /** De dónde sale la hora de la firma: sello de tiempo (la más confiable), el certificado firmado o el PDF. */
+  signingTimeSource: 'Timestamp' | 'SignedAttribute' | 'PdfDate' | null;
+  reason: string | null;
+  location: string | null;
+  hasTimestamp: boolean;
+  /** Lo firmado no cambió y la firma corresponde al certificado. */
+  intact: boolean;
+  /** La firma abarca el archivo completo (las anteriores a la última, solo su versión). */
+  coversWholeDocument: boolean;
+  /** El certificado estaba vigente al firmar. `null` si no se sabe cuándo se firmó. */
+  certificateValidAtSigning: boolean | null;
+  /** Cadena hasta un certificado raíz de confianza. `null` si no hay raíces configuradas. */
+  trusted: boolean | null;
+  status: PdfSignatureStatus;
+  /** Lo que no cuadra o no se pudo confirmar, en palabras. */
+  problems: string[];
+}
+
+/** Revisión de las firmas de un PDF. */
+export interface PdfSignatureReportEntity {
+  checkedAt: string;
+  status: 'NoSignatures' | PdfSignatureStatus;
+  signatures: PdfSignatureEntity[];
+  /** Hay contenido agregado después de la última firma, que no está firmado. */
+  modifiedAfterLastSignature: boolean;
+  /** Se configuraron certificados raíz para confirmar la cadena de confianza. */
+  trustConfigured: boolean;
+  /** Huella SHA-256 del archivo revisado. */
+  fileSha256: string;
+}