@muni-sanfer/types-gestor-documental 0.0.1-beta.17 → 0.0.1-beta.18

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 } 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 } from '../entities';
 import { type RpcPage } from './contract';
 import { type DocumentActor } from './document.contract';
 /** Patrones NATS de `caseFile`: `<servicio>.<recurso>.<acción>`. */
@@ -23,6 +23,7 @@ export declare const CaseFilePatterns: {
     readonly getShared: "gestorDocumental.caseFile.getShared";
     readonly getSharedEntryFile: "gestorDocumental.caseFile.getSharedEntryFile";
     readonly getSharedExport: "gestorDocumental.caseFile.getSharedExport";
+    readonly verifyExport: "gestorDocumental.caseFile.verifyExport";
 };
 /** Enlace temporal para que alguien de fuera consulte el expediente sin sesión. */
 export interface CaseFileShareLinkPayload {
@@ -237,6 +238,20 @@ export interface CaseFileContract {
         response: CaseFileEntryFileResponseEntity;
     };
     /** El expediente completo, si el enlace lo permite. Queda en la trazabilidad y en el registro de accesos. */
+    /**
+     * Verificador público del ZIP exportado: sin sesión, con el identificador del expediente y la huella SHA-256 que
+     * calculó el navegador para cada actuación (el ZIP no se sube). Se compara con las huellas registradas al incorporar.
+     */
+    [CaseFilePatterns.verifyExport]: {
+        payload: {
+            code: string;
+            entries: {
+                sequence: number;
+                sha256: string;
+            }[];
+        };
+        response: CaseFileVerifyExportResponseEntity;
+    };
     [CaseFilePatterns.getSharedExport]: {
         payload: {
             token: string;

package/dist/contracts/caseFile.contract.js

@@ -22,4 +22,5 @@ exports.CaseFilePatterns = {
     getShared: 'gestorDocumental.caseFile.getShared',
     getSharedEntryFile: 'gestorDocumental.caseFile.getSharedEntryFile',
     getSharedExport: 'gestorDocumental.caseFile.getSharedExport',
+    verifyExport: 'gestorDocumental.caseFile.verifyExport',
 };

package/dist/contracts/index.d.ts

@@ -93,6 +93,7 @@ export declare const GestorDocumentalPatterns: {
         readonly getShared: "gestorDocumental.caseFile.getShared";
         readonly getSharedEntryFile: "gestorDocumental.caseFile.getSharedEntryFile";
         readonly getSharedExport: "gestorDocumental.caseFile.getSharedExport";
+        readonly verifyExport: "gestorDocumental.caseFile.verifyExport";
     };
     readonly partsOffice: {
         readonly getStatus: "gestorDocumental.partsOffice.getStatus";

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

@@ -267,3 +267,31 @@ export interface CaseFileSharedResponseEntity {
     allowExport: boolean;
     entries: CaseFileSharedEntryEntity[];
 }
+/** Resultado de una actuación al verificar un ZIP exportado. */
+export type CaseFileVerifyEntryResult = 
+/** La huella coincide con la registrada al incorporarla. */
+'Match'
+/** La huella no coincide: el archivo cambió. */
+ | 'Altered'
+/** El ZIP trae una actuación con esa secuencia que el expediente no tiene. */
+ | 'NotInRegistry'
+/** El expediente tiene esa actuación con archivo, pero el ZIP no la trae. */
+ | 'Missing'
+/** La actuación no tiene huella registrada (incorporada antes de que se guardaran). */
+ | 'NoFingerprint';
+export interface CaseFileVerifyExportResponseEntity {
+    code: string;
+    status: CaseFileEntity['status'];
+    closedAt: string | null;
+    /** Solo si el expediente es público y sin datos sensibles. */
+    title: string | null;
+    /** Cuántas actuaciones con archivo tiene el expediente registradas. */
+    registeredFiles: number;
+    /** `true` si todo lo registrado está en el ZIP y todo coincide. */
+    intact: boolean;
+    entries: {
+        sequence: number;
+        result: CaseFileVerifyEntryResult;
+        voided: boolean;
+    }[];
+}

package/package.json

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

package/src/contracts/caseFile.contract.ts

@@ -18,6 +18,7 @@ import {
   type CaseFileShareLinkResponseEntity,
   type CaseFileSharedResponseEntity,
   type CaseFileUpdateResponseEntity,
+  type CaseFileVerifyExportResponseEntity,
 } from '../entities';
 import { type RpcPage } from './contract';
 import { type DocumentActor } from './document.contract';
@@ -43,6 +44,7 @@ export const CaseFilePatterns = {
   getShared: 'gestorDocumental.caseFile.getShared',
   getSharedEntryFile: 'gestorDocumental.caseFile.getSharedEntryFile',
   getSharedExport: 'gestorDocumental.caseFile.getSharedExport',
+  verifyExport: 'gestorDocumental.caseFile.verifyExport',
 } as const;
 
 /** Enlace temporal para que alguien de fuera consulte el expediente sin sesión. */
@@ -211,6 +213,14 @@ export interface CaseFileContract {
     response: CaseFileEntryFileResponseEntity;
   };
   /** El expediente completo, si el enlace lo permite. Queda en la trazabilidad y en el registro de accesos. */
+  /**
+   * Verificador público del ZIP exportado: sin sesión, con el identificador del expediente y la huella SHA-256 que
+   * calculó el navegador para cada actuación (el ZIP no se sube). Se compara con las huellas registradas al incorporar.
+   */
+  [CaseFilePatterns.verifyExport]: {
+    payload: { code: string; entries: { sequence: number; sha256: string }[] };
+    response: CaseFileVerifyExportResponseEntity;
+  };
   [CaseFilePatterns.getSharedExport]: {
     payload: { token: string };
     response: CaseFileExportResponseEntity;

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

@@ -293,3 +293,29 @@ export interface CaseFileSharedResponseEntity {
   allowExport: boolean;
   entries: CaseFileSharedEntryEntity[];
 }
+
+/** Resultado de una actuación al verificar un ZIP exportado. */
+export type CaseFileVerifyEntryResult =
+  /** La huella coincide con la registrada al incorporarla. */
+  | 'Match'
+  /** La huella no coincide: el archivo cambió. */
+  | 'Altered'
+  /** El ZIP trae una actuación con esa secuencia que el expediente no tiene. */
+  | 'NotInRegistry'
+  /** El expediente tiene esa actuación con archivo, pero el ZIP no la trae. */
+  | 'Missing'
+  /** La actuación no tiene huella registrada (incorporada antes de que se guardaran). */
+  | 'NoFingerprint';
+
+export interface CaseFileVerifyExportResponseEntity {
+  code: string;
+  status: CaseFileEntity['status'];
+  closedAt: string | null;
+  /** Solo si el expediente es público y sin datos sensibles. */
+  title: string | null;
+  /** Cuántas actuaciones con archivo tiene el expediente registradas. */
+  registeredFiles: number;
+  /** `true` si todo lo registrado está en el ZIP y todo coincide. */
+  intact: boolean;
+  entries: { sequence: number; result: CaseFileVerifyEntryResult; voided: boolean }[];
+}