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

package/dist/base/entities.d.ts

@@ -370,16 +370,29 @@ export declare const DataBreachNoticeMeans: {
     Individual: "Individual";
     PublicNotice: "PublicNotice";
 };
-export type DeskFileSource = 'Upload' | 'Scan';
+export type DeskFileSource = 'Upload' | 'Scan' | 'Email';
 export declare const DeskFileSource: {
     Upload: "Upload";
     Scan: "Scan";
+    Email: "Email";
 };
 export type DeskFileTarget = 'Document' | 'CaseFile';
 export declare const DeskFileTarget: {
     Document: "Document";
     CaseFile: "CaseFile";
 };
+export type MailIntakeStatus = 'Pending' | 'Accepted' | 'Discarded';
+export declare const MailIntakeStatus: {
+    Pending: "Pending";
+    Accepted: "Accepted";
+    Discarded: "Discarded";
+};
+export type MailAuthentication = 'Pass' | 'Fail' | 'Unknown';
+export declare const MailAuthentication: {
+    Pass: "Pass";
+    Fail: "Fail";
+    Unknown: "Unknown";
+};
 export interface DocumentTypeEntity {
     id: string;
     name: string;
@@ -448,6 +461,7 @@ export interface DocumentEntity {
     originalFileName: string;
     currentFileId?: string | null;
     currentFileUrl?: string | null;
+    fileFormat?: string | null;
     submittedAt?: string | null;
     finishedAt?: string | null;
     documentType?: DocumentTypeEntity;
@@ -696,6 +710,7 @@ export interface CaseFileEntryEntity {
     sha256?: string | null;
     size?: number | null;
     hasAdvancedSignature: boolean;
+    fileFormat?: string | null;
     signatureCheck?: JsonValue | null;
     incorporatedByEmployeeId: string;
     incorporatedByFullName: string;
@@ -1206,6 +1221,42 @@ export interface DeskFileEntity {
     targetId?: string | null;
     targetLabel?: string | null;
     removedAt?: string | null;
+    mailIntake?: MailIntakeEntity | null;
+    mailIntakeId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface MailIntakeEntity {
+    id: string;
+    sha256: string;
+    messageId?: string | null;
+    fromAddress: string;
+    fromName?: string | null;
+    subject: string;
+    textPreview?: string | null;
+    sentAt?: string | null;
+    emlFileId: string;
+    emlFileName: string;
+    size: number;
+    attachments: JsonValue;
+    authentication: MailAuthentication;
+    authDetail?: string | null;
+    status: MailIntakeStatus;
+    resolvedAt?: string | null;
+    resolvedByEmployeeId?: string | null;
+    deskFiles?: DeskFileEntity[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PushSubscriptionEntity {
+    id: string;
+    employeeId: string;
+    endpoint: string;
+    p256dh: string;
+    auth: string;
+    userAgent?: string | null;
+    lastSuccessAt?: string | null;
+    failures: number;
     createdAt: string;
     updatedAt: string;
 }

package/dist/base/entities.js

@@ -2,6 +2,7 @@
 // This file was auto-generated by prisma-generator-typescript-interfaces
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DeskFileTarget = exports.DeskFileSource = exports.DataBreachNoticeMeans = exports.DataBreachEventAction = exports.DataBreachStatus = exports.DataBreachKind = exports.DataRightsEventAction = exports.DataRightsResolution = exports.DataRightsRequestStatus = exports.DataRightsChannel = exports.DataRight = exports.DataLegalBasis = exports.TransparencyStatus = exports.AccessRequestEventAction = exports.AccessRequestResolution = exports.AccessRequestStatus = exports.AccessRequestChannel = exports.DispositionKind = exports.FinalDisposition = exports.AuditAction = exports.AuditEntity = exports.DocumentAccessAction = exports.QualityMetricKey = exports.ServiceOutageKind = exports.WorkFolderItemKind = exports.TextSnippetSection = exports.ScanSessionStatus = exports.CaseFileAccessAction = exports.CaseFileTrackingAction = exports.CaseFileActorType = exports.CaseFileActorRelation = exports.CaseFileEntryKind = exports.CaseFileActuationType = exports.CaseFileIncorporationMechanism = exports.CaseFileStatus = exports.DocumentInstruction = exports.DocumentDeliveryOrigin = exports.DocumentRecipientType = exports.DocumentAttachmentType = exports.DocumentFlowStepType = exports.DocDigitalInboundStatus = exports.DocumentDispatchStatus = exports.CommunicationMeans = exports.DocumentOrigin = exports.DocumentTrackingAction = exports.DocumentParticipantStatus = exports.DocumentParticipantRole = exports.DocumentAccessLevel = exports.DocumentStatus = exports.DocumentCategory = void 0;
+exports.MailAuthentication = exports.MailIntakeStatus = void 0;
 exports.DocumentCategory = {
     Decree: 'Decree',
     Communication: 'Communication',
@@ -329,8 +330,19 @@ exports.DataBreachNoticeMeans = {
 exports.DeskFileSource = {
     Upload: 'Upload',
     Scan: 'Scan',
+    Email: 'Email',
 };
 exports.DeskFileTarget = {
     Document: 'Document',
     CaseFile: 'CaseFile',
 };
+exports.MailIntakeStatus = {
+    Pending: 'Pending',
+    Accepted: 'Accepted',
+    Discarded: 'Discarded',
+};
+exports.MailAuthentication = {
+    Pass: 'Pass',
+    Fail: 'Fail',
+    Unknown: 'Unknown',
+};

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

@@ -19,8 +19,10 @@ export interface DeskContract {
         };
         response: DeskFileResponseEntity[];
     };
+    /** `email`, el correo institucional de la sesión, cuenta también los correos que esperan que elija sus adjuntos. */
     [DeskPatterns.getSummary]: {
         payload: {
+            email?: string | null;
             actor: DocumentActor;
         };
         response: DeskSummaryEntity;

package/dist/contracts/index.d.ts

@@ -14,6 +14,8 @@ import { type AccessRequestContract } from './accessRequest.contract';
 import { type TransparencyContract } from './transparency.contract';
 import { type DataProtectionContract } from './dataProtection.contract';
 import { type DeskContract } from './desk.contract';
+import { type MailIntakeContract } from './mailIntake.contract';
+import { type PushContract } from './push.contract';
 import { type ScanContract } from './scan.contract';
 import { type PartsOfficeContract } from './partsOffice.contract';
 import { type ProcedureContract } from './procedure.contract';
@@ -43,6 +45,8 @@ export * from './accessRequest.contract';
 export * from './transparency.contract';
 export * from './dataProtection.contract';
 export * from './desk.contract';
+export * from './mailIntake.contract';
+export * from './push.contract';
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export declare const GestorDocumentalPatterns: {
     readonly documentType: {
@@ -267,6 +271,20 @@ export declare const GestorDocumentalPatterns: {
         readonly classify: "gestorDocumental.desk.classify";
         readonly moveToCaseFile: "gestorDocumental.desk.moveToCaseFile";
     };
+    readonly mailIntake: {
+        readonly getMine: "gestorDocumental.mailIntake.getMine";
+        readonly accept: "gestorDocumental.mailIntake.accept";
+        readonly discard: "gestorDocumental.mailIntake.discard";
+        readonly getEml: "gestorDocumental.mailIntake.getEml";
+        readonly sync: "gestorDocumental.mailIntake.sync";
+    };
+    readonly push: {
+        readonly getConfig: "gestorDocumental.push.getConfig";
+        readonly subscribe: "gestorDocumental.push.subscribe";
+        readonly unsubscribe: "gestorDocumental.push.unsubscribe";
+        readonly test: "gestorDocumental.push.test";
+        readonly send: "gestorDocumental.push.send";
+    };
 };
 /** 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 & SignatureCheckContract & RepositoryExportContract & RetentionContract & AccessRequestContract & TransparencyContract & DataProtectionContract & DeskContract;
+export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & IssuingEntityContract & CaseFileContract & PartsOfficeContract & RegisterBookContract & SignatureBatchContract & WorkFolderContract & ScanContract & ArchivalSeriesContract & TextSnippetContract & HolidayContract & IndicatorsContract & AuditContract & SignatureCheckContract & RepositoryExportContract & RetentionContract & AccessRequestContract & TransparencyContract & DataProtectionContract & DeskContract & MailIntakeContract & PushContract;

package/dist/contracts/index.js

@@ -31,6 +31,8 @@ const accessRequest_contract_1 = require("./accessRequest.contract");
 const transparency_contract_1 = require("./transparency.contract");
 const dataProtection_contract_1 = require("./dataProtection.contract");
 const desk_contract_1 = require("./desk.contract");
+const mailIntake_contract_1 = require("./mailIntake.contract");
+const push_contract_1 = require("./push.contract");
 const scan_contract_1 = require("./scan.contract");
 const partsOffice_contract_1 = require("./partsOffice.contract");
 const procedure_contract_1 = require("./procedure.contract");
@@ -60,6 +62,8 @@ __exportStar(require("./accessRequest.contract"), exports);
 __exportStar(require("./transparency.contract"), exports);
 __exportStar(require("./dataProtection.contract"), exports);
 __exportStar(require("./desk.contract"), exports);
+__exportStar(require("./mailIntake.contract"), exports);
+__exportStar(require("./push.contract"), exports);
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 exports.GestorDocumentalPatterns = {
     documentType: documentType_contract_1.DocumentTypePatterns,
@@ -84,4 +88,6 @@ exports.GestorDocumentalPatterns = {
     transparency: transparency_contract_1.TransparencyPatterns,
     dataProtection: dataProtection_contract_1.DataProtectionPatterns,
     desk: desk_contract_1.DeskPatterns,
+    mailIntake: mailIntake_contract_1.MailIntakePatterns,
+    push: push_contract_1.PushPatterns,
 };

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

@@ -0,0 +1,61 @@
+import { type DeskFileResponseEntity, type DeskOkResponseEntity, type DocumentPublicFileResponseEntity, type MailIntakeInboxEntity, type MailIntakeSyncEntity } from '../entities';
+import { type DocumentActor } from './document.contract';
+/**
+ * Patrones NATS de `mailIntake`: el ingreso por correo. Un funcionario reenvía un correo a la casilla del gestor y
+ * después elige qué adjuntos entran a su escritorio. `email` es el correo institucional de la sesión, que agrega el
+ * gateway: solo con él se ven los correos que envió.
+ */
+export declare const MailIntakePatterns: {
+    readonly getMine: "gestorDocumental.mailIntake.getMine";
+    readonly accept: "gestorDocumental.mailIntake.accept";
+    readonly discard: "gestorDocumental.mailIntake.discard";
+    readonly getEml: "gestorDocumental.mailIntake.getEml";
+    readonly sync: "gestorDocumental.mailIntake.sync";
+};
+export interface MailIntakeContract {
+    /** Los correos pendientes que envió quien tiene la sesión, del más reciente al más antiguo. */
+    [MailIntakePatterns.getMine]: {
+        payload: {
+            email: string | null;
+            actor: DocumentActor;
+        };
+        response: MailIntakeInboxEntity;
+    };
+    /**
+     * Lleva al escritorio los adjuntos elegidos (por su `index`) y, si se pide, el correo completo en EML. El correo
+     * queda aceptado: no se puede volver a procesar.
+     */
+    [MailIntakePatterns.accept]: {
+        payload: {
+            id: string;
+            email: string | null;
+            attachments: number[];
+            includeEml: boolean;
+            actor: DocumentActor;
+        };
+        response: DeskFileResponseEntity[];
+    };
+    /** Lo descarta sin traer nada. El EML se conserva. */
+    [MailIntakePatterns.discard]: {
+        payload: {
+            id: string;
+            email: string | null;
+            actor: DocumentActor;
+        };
+        response: DeskOkResponseEntity;
+    };
+    /** El correo completo (EML), para su remitente. */
+    [MailIntakePatterns.getEml]: {
+        payload: {
+            id: string;
+            email: string | null;
+            actor: DocumentActor;
+        };
+        response: DocumentPublicFileResponseEntity;
+    };
+    /** Revisa la casilla ahora, sin esperar a la revisión periódica. */
+    [MailIntakePatterns.sync]: {
+        payload: Record<string, never>;
+        response: MailIntakeSyncEntity;
+    };
+}

package/dist/contracts/mailIntake.contract.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MailIntakePatterns = void 0;
+/**
+ * Patrones NATS de `mailIntake`: el ingreso por correo. Un funcionario reenvía un correo a la casilla del gestor y
+ * después elige qué adjuntos entran a su escritorio. `email` es el correo institucional de la sesión, que agrega el
+ * gateway: solo con él se ven los correos que envió.
+ */
+exports.MailIntakePatterns = {
+    getMine: 'gestorDocumental.mailIntake.getMine',
+    accept: 'gestorDocumental.mailIntake.accept',
+    discard: 'gestorDocumental.mailIntake.discard',
+    getEml: 'gestorDocumental.mailIntake.getEml',
+    sync: 'gestorDocumental.mailIntake.sync',
+};

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

@@ -0,0 +1,59 @@
+import { type PushConfigResponseEntity, type PushNotificationInput, type PushOkResponseEntity, type PushSendResultEntity } from '../entities';
+import { type DocumentActor } from './document.contract';
+/**
+ * Patrones NATS de `push`: avisos en el celular o el computador (Web Push), además del correo. Cada funcionario los
+ * activa en sus dispositivos; el gateway los envía junto con los correos de aviso.
+ */
+export declare const PushPatterns: {
+    readonly getConfig: "gestorDocumental.push.getConfig";
+    readonly subscribe: "gestorDocumental.push.subscribe";
+    readonly unsubscribe: "gestorDocumental.push.unsubscribe";
+    readonly test: "gestorDocumental.push.test";
+    readonly send: "gestorDocumental.push.send";
+};
+export interface PushContract {
+    [PushPatterns.getConfig]: {
+        payload: {
+            actor: DocumentActor;
+        };
+        response: PushConfigResponseEntity;
+    };
+    /** Registra el dispositivo (o lo actualiza, si ya estaba) a nombre de quien tiene la sesión. */
+    [PushPatterns.subscribe]: {
+        payload: {
+            subscription: {
+                endpoint: string;
+                keys: {
+                    p256dh: string;
+                    auth: string;
+                };
+            };
+            userAgent?: string | null;
+            actor: DocumentActor;
+        };
+        response: PushOkResponseEntity;
+    };
+    /** Quita el dispositivo, solo si es de quien tiene la sesión. */
+    [PushPatterns.unsubscribe]: {
+        payload: {
+            endpoint: string;
+            actor: DocumentActor;
+        };
+        response: PushOkResponseEntity;
+    };
+    /** Un aviso de prueba a los dispositivos de quien tiene la sesión. */
+    [PushPatterns.test]: {
+        payload: {
+            actor: DocumentActor;
+        };
+        response: PushSendResultEntity;
+    };
+    /** Envía un aviso a los dispositivos de esos funcionarios. Lo usa el gateway, no el navegador. */
+    [PushPatterns.send]: {
+        payload: {
+            employeeIds: string[];
+            notification: PushNotificationInput;
+        };
+        response: PushSendResultEntity;
+    };
+}

package/dist/contracts/push.contract.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PushPatterns = void 0;
+/**
+ * Patrones NATS de `push`: avisos en el celular o el computador (Web Push), además del correo. Cada funcionario los
+ * activa en sus dispositivos; el gateway los envía junto con los correos de aviso.
+ */
+exports.PushPatterns = {
+    getConfig: 'gestorDocumental.push.getConfig',
+    subscribe: 'gestorDocumental.push.subscribe',
+    unsubscribe: 'gestorDocumental.push.unsubscribe',
+    test: 'gestorDocumental.push.test',
+    send: 'gestorDocumental.push.send',
+};

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

@@ -59,6 +59,8 @@ export interface CaseFileEntryResponseEntity {
     sha256: CaseFileEntryEntity['sha256'];
     size: CaseFileEntryEntity['size'];
     hasAdvancedSignature: CaseFileEntryEntity['hasAdvancedSignature'];
+    /** Conformidad PDF/A que declara el archivo («PDF/A-2B»), «PDF», o `null` si no es un PDF o no se revisó. */
+    fileFormat: CaseFileEntryEntity['fileFormat'];
     /** Revisión de sus firmas al incorporarlo, en los archivos externos en PDF. */
     signatureCheck: PdfSignatureReportEntity | null;
     incorporatedByEmployeeId: CaseFileEntryEntity['incorporatedByEmployeeId'];

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

@@ -7,6 +7,8 @@ export interface DeskFileResponseEntity {
     sha256: string;
     source: DeskFileSource;
     description: string | null;
+    /** Correo del que salió, si llegó por correo. */
+    mailIntakeId: string | null;
     /** Es un PDF: se puede redactar una comunicación con él o firmarlo como documento suelto. */
     isPdf: boolean;
     createdAt: string;
@@ -14,6 +16,8 @@ export interface DeskFileResponseEntity {
 export interface DeskSummaryEntity {
     /** Archivos del escritorio aún sin clasificar. */
     unclassified: number;
+    /** Correos reenviados a la casilla del gestor que esperan que elija sus adjuntos. */
+    pendingMails: number;
 }
 export interface DeskOkResponseEntity {
     id: string;

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

@@ -139,6 +139,11 @@ export interface DocumentGetByIdResponseEntity {
     keywords: DocumentEntity['keywords'];
     accessLevel: DocumentEntity['accessLevel'];
     hasSensitiveData: DocumentEntity['hasSensitiveData'];
+    /**
+     * Formato del archivo vigente: la conformidad PDF/A que declara («PDF/A-2B») o «PDF». `null` si no se revisó (los
+     * documentos anteriores a esta revisión, o aún sin firmar).
+     */
+    fileFormat: DocumentEntity['fileFormat'];
     status: DocumentEntity['status'];
     correlative: DocumentEntity['correlative'];
     correlativeYear: DocumentEntity['correlativeYear'];

package/dist/entities/index.d.ts

@@ -20,3 +20,5 @@ export * from './accessRequest';
 export * from './transparency';
 export * from './dataProtection';
 export * from './desk';
+export * from './mailIntake';
+export * from './push';

package/dist/entities/index.js

@@ -36,3 +36,5 @@ __exportStar(require("./accessRequest"), exports);
 __exportStar(require("./transparency"), exports);
 __exportStar(require("./dataProtection"), exports);
 __exportStar(require("./desk"), exports);
+__exportStar(require("./mailIntake"), exports);
+__exportStar(require("./push"), exports);

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

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

package/dist/entities/mailIntake/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("./mailIntake.entity"), exports);

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

@@ -0,0 +1,51 @@
+import { type MailAuthentication } from '../../base/entities';
+/** Adjunto de un correo recibido. `index` lo identifica al elegir qué entra al escritorio. */
+export interface MailIntakeAttachmentEntity {
+    index: number;
+    fileName: string;
+    contentType: string;
+    size: number;
+    sha256: string;
+    /** Su tipo de archivo puede entrar al escritorio (PDF, documentos de oficina, imágenes). */
+    supported: boolean;
+}
+/** Correo reenviado a la casilla del gestor, a la espera de que su remitente elija qué adjuntos entran. */
+export interface MailIntakeItemEntity {
+    id: string;
+    fromAddress: string;
+    fromName: string | null;
+    subject: string;
+    /** Comienzo del texto del correo, para reconocerlo. */
+    textPreview: string | null;
+    /** Fecha del correo, según su remitente. */
+    sentAt: string | null;
+    /** Cuándo lo trajo el gestor desde la casilla. */
+    receivedAt: string;
+    /** Tamaño del correo completo (EML), en bytes. */
+    size: number;
+    /** Lo que informó el servidor de correo sobre el remitente: `Fail` puede ser un remitente suplantado. */
+    authentication: MailAuthentication;
+    authDetail: string | null;
+    attachments: MailIntakeAttachmentEntity[];
+}
+/** Los correos pendientes de quien tiene la sesión y a qué casilla reenviarlos. */
+export interface MailIntakeInboxEntity {
+    /** La casilla está configurada y se revisa. */
+    enabled: boolean;
+    /** Dirección a la que se reenvían los correos; `null` si no está configurada. */
+    address: string | null;
+    /** Los dominios desde los que se aceptan correos (los institucionales). */
+    domains: string[];
+    mails: MailIntakeItemEntity[];
+}
+/** Resultado de una revisión de la casilla. */
+export interface MailIntakeSyncEntity {
+    /** Correos sin leer que se revisaron. */
+    checked: number;
+    /** Los que quedaron registrados. */
+    created: number;
+    /** Repetidos o de un dominio que no es institucional: no se guardan. */
+    ignored: number;
+    /** Los que no se pudieron procesar; se reintentan en la próxima revisión. */
+    failed: number;
+}

package/dist/entities/mailIntake/mailIntake.entity.js

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

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

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

package/dist/entities/push/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("./push.entity"), exports);

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

@@ -0,0 +1,28 @@
+/** Si los avisos push están habilitados y con qué clave pública se suscribe el navegador. */
+export interface PushConfigResponseEntity {
+    /** El servidor tiene sus claves VAPID: se pueden activar. */
+    enabled: boolean;
+    /** Clave pública VAPID (base64url) para `pushManager.subscribe`; `null` si no está habilitado. */
+    publicKey: string | null;
+    /** Dispositivos en que quien consulta tiene los avisos activos. */
+    devices: number;
+}
+export interface PushOkResponseEntity {
+    ok: boolean;
+}
+/** Resultado de un envío: avisos entregados al servicio push, suscripciones vencidas que se borraron y fallas. */
+export interface PushSendResultEntity {
+    sent: number;
+    removed: number;
+    failed: number;
+}
+/**
+ * Un aviso. `url` es una ruta del gestor (`/documentos/…/detalle`): el service worker la abre al tocar el aviso.
+ * `tag` agrupa: un aviso nuevo con el mismo `tag` reemplaza al anterior en el dispositivo.
+ */
+export interface PushNotificationInput {
+    title: string;
+    body: string;
+    url: string;
+    tag?: string | null;
+}

package/dist/entities/push/push.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.33",
+  "version": "0.0.1-beta.35",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {

package/src/base/entities.ts

@@ -554,11 +554,12 @@ export const DataBreachNoticeMeans = {
   PublicNotice: 'PublicNotice',
 } satisfies Record<string, DataBreachNoticeMeans>;
 
-export type DeskFileSource = 'Upload' | 'Scan';
+export type DeskFileSource = 'Upload' | 'Scan' | 'Email';
 
 export const DeskFileSource = {
   Upload: 'Upload',
   Scan: 'Scan',
+  Email: 'Email',
 } satisfies Record<string, DeskFileSource>;
 
 export type DeskFileTarget = 'Document' | 'CaseFile';
@@ -568,6 +569,22 @@ export const DeskFileTarget = {
   CaseFile: 'CaseFile',
 } satisfies Record<string, DeskFileTarget>;
 
+export type MailIntakeStatus = 'Pending' | 'Accepted' | 'Discarded';
+
+export const MailIntakeStatus = {
+  Pending: 'Pending',
+  Accepted: 'Accepted',
+  Discarded: 'Discarded',
+} satisfies Record<string, MailIntakeStatus>;
+
+export type MailAuthentication = 'Pass' | 'Fail' | 'Unknown';
+
+export const MailAuthentication = {
+  Pass: 'Pass',
+  Fail: 'Fail',
+  Unknown: 'Unknown',
+} satisfies Record<string, MailAuthentication>;
+
 export interface DocumentTypeEntity {
   id: string;
   name: string;
@@ -637,6 +654,7 @@ export interface DocumentEntity {
   originalFileName: string;
   currentFileId?: string | null;
   currentFileUrl?: string | null;
+  fileFormat?: string | null;
   submittedAt?: string | null;
   finishedAt?: string | null;
   documentType?: DocumentTypeEntity;
@@ -899,6 +917,7 @@ export interface CaseFileEntryEntity {
   sha256?: string | null;
   size?: number | null;
   hasAdvancedSignature: boolean;
+  fileFormat?: string | null;
   signatureCheck?: JsonValue | null;
   incorporatedByEmployeeId: string;
   incorporatedByFullName: string;
@@ -1441,6 +1460,44 @@ export interface DeskFileEntity {
   targetId?: string | null;
   targetLabel?: string | null;
   removedAt?: string | null;
+  mailIntake?: MailIntakeEntity | null;
+  mailIntakeId?: string | null;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface MailIntakeEntity {
+  id: string;
+  sha256: string;
+  messageId?: string | null;
+  fromAddress: string;
+  fromName?: string | null;
+  subject: string;
+  textPreview?: string | null;
+  sentAt?: string | null;
+  emlFileId: string;
+  emlFileName: string;
+  size: number;
+  attachments: JsonValue;
+  authentication: MailAuthentication;
+  authDetail?: string | null;
+  status: MailIntakeStatus;
+  resolvedAt?: string | null;
+  resolvedByEmployeeId?: string | null;
+  deskFiles?: DeskFileEntity[];
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface PushSubscriptionEntity {
+  id: string;
+  employeeId: string;
+  endpoint: string;
+  p256dh: string;
+  auth: string;
+  userAgent?: string | null;
+  lastSuccessAt?: string | null;
+  failures: number;
   createdAt: string;
   updatedAt: string;
 }

package/src/contracts/desk.contract.ts

@@ -22,7 +22,11 @@ export const DeskPatterns = {
 export interface DeskContract {
   /** Los archivos sin clasificar de quien tiene la sesión, del más reciente al más antiguo. */
   [DeskPatterns.getFiles]: { payload: { actor: DocumentActor }; response: DeskFileResponseEntity[] };
-  [DeskPatterns.getSummary]: { payload: { actor: DocumentActor }; response: DeskSummaryEntity };
+  /** `email`, el correo institucional de la sesión, cuenta también los correos que esperan que elija sus adjuntos. */
+  [DeskPatterns.getSummary]: {
+    payload: { email?: string | null; actor: DocumentActor };
+    response: DeskSummaryEntity;
+  };
   /** Archivos ya subidos a la carpeta del gestor (por el gateway), que quedan en el escritorio. */
   [DeskPatterns.addFiles]: {
     payload: {

package/src/contracts/index.ts

@@ -14,6 +14,8 @@ import { AccessRequestPatterns, type AccessRequestContract } from './accessReque
 import { TransparencyPatterns, type TransparencyContract } from './transparency.contract';
 import { DataProtectionPatterns, type DataProtectionContract } from './dataProtection.contract';
 import { DeskPatterns, type DeskContract } from './desk.contract';
+import { MailIntakePatterns, type MailIntakeContract } from './mailIntake.contract';
+import { PushPatterns, type PushContract } from './push.contract';
 import { ScanPatterns, type ScanContract } from './scan.contract';
 import { PartsOfficePatterns, type PartsOfficeContract } from './partsOffice.contract';
 import { ProcedurePatterns, type ProcedureContract } from './procedure.contract';
@@ -44,6 +46,8 @@ export * from './accessRequest.contract';
 export * from './transparency.contract';
 export * from './dataProtection.contract';
 export * from './desk.contract';
+export * from './mailIntake.contract';
+export * from './push.contract';
 
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export const GestorDocumentalPatterns = {
@@ -69,6 +73,8 @@ export const GestorDocumentalPatterns = {
   transparency: TransparencyPatterns,
   dataProtection: DataProtectionPatterns,
   desk: DeskPatterns,
+  mailIntake: MailIntakePatterns,
+  push: PushPatterns,
 } as const;
 
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
@@ -93,4 +99,6 @@ export type GestorDocumentalContract = DocumentTypeContract &
   AccessRequestContract &
   TransparencyContract &
   DataProtectionContract &
-  DeskContract;
+  DeskContract &
+  MailIntakeContract &
+  PushContract;

package/src/contracts/mailIntake.contract.ts

@@ -0,0 +1,49 @@
+import {
+  type DeskFileResponseEntity,
+  type DeskOkResponseEntity,
+  type DocumentPublicFileResponseEntity,
+  type MailIntakeInboxEntity,
+  type MailIntakeSyncEntity,
+} from '../entities';
+import { type DocumentActor } from './document.contract';
+
+/**
+ * Patrones NATS de `mailIntake`: el ingreso por correo. Un funcionario reenvía un correo a la casilla del gestor y
+ * después elige qué adjuntos entran a su escritorio. `email` es el correo institucional de la sesión, que agrega el
+ * gateway: solo con él se ven los correos que envió.
+ */
+export const MailIntakePatterns = {
+  getMine: 'gestorDocumental.mailIntake.getMine',
+  accept: 'gestorDocumental.mailIntake.accept',
+  discard: 'gestorDocumental.mailIntake.discard',
+  getEml: 'gestorDocumental.mailIntake.getEml',
+  sync: 'gestorDocumental.mailIntake.sync',
+} as const;
+
+export interface MailIntakeContract {
+  /** Los correos pendientes que envió quien tiene la sesión, del más reciente al más antiguo. */
+  [MailIntakePatterns.getMine]: {
+    payload: { email: string | null; actor: DocumentActor };
+    response: MailIntakeInboxEntity;
+  };
+  /**
+   * Lleva al escritorio los adjuntos elegidos (por su `index`) y, si se pide, el correo completo en EML. El correo
+   * queda aceptado: no se puede volver a procesar.
+   */
+  [MailIntakePatterns.accept]: {
+    payload: { id: string; email: string | null; attachments: number[]; includeEml: boolean; actor: DocumentActor };
+    response: DeskFileResponseEntity[];
+  };
+  /** Lo descarta sin traer nada. El EML se conserva. */
+  [MailIntakePatterns.discard]: {
+    payload: { id: string; email: string | null; actor: DocumentActor };
+    response: DeskOkResponseEntity;
+  };
+  /** El correo completo (EML), para su remitente. */
+  [MailIntakePatterns.getEml]: {
+    payload: { id: string; email: string | null; actor: DocumentActor };
+    response: DocumentPublicFileResponseEntity;
+  };
+  /** Revisa la casilla ahora, sin esperar a la revisión periódica. */
+  [MailIntakePatterns.sync]: { payload: Record<string, never>; response: MailIntakeSyncEntity };
+}

package/src/contracts/push.contract.ts

@@ -0,0 +1,41 @@
+import {
+  type PushConfigResponseEntity,
+  type PushNotificationInput,
+  type PushOkResponseEntity,
+  type PushSendResultEntity,
+} from '../entities';
+import { type DocumentActor } from './document.contract';
+
+/**
+ * Patrones NATS de `push`: avisos en el celular o el computador (Web Push), además del correo. Cada funcionario los
+ * activa en sus dispositivos; el gateway los envía junto con los correos de aviso.
+ */
+export const PushPatterns = {
+  getConfig: 'gestorDocumental.push.getConfig',
+  subscribe: 'gestorDocumental.push.subscribe',
+  unsubscribe: 'gestorDocumental.push.unsubscribe',
+  test: 'gestorDocumental.push.test',
+  send: 'gestorDocumental.push.send',
+} as const;
+
+export interface PushContract {
+  [PushPatterns.getConfig]: { payload: { actor: DocumentActor }; response: PushConfigResponseEntity };
+  /** Registra el dispositivo (o lo actualiza, si ya estaba) a nombre de quien tiene la sesión. */
+  [PushPatterns.subscribe]: {
+    payload: {
+      subscription: { endpoint: string; keys: { p256dh: string; auth: string } };
+      userAgent?: string | null;
+      actor: DocumentActor;
+    };
+    response: PushOkResponseEntity;
+  };
+  /** Quita el dispositivo, solo si es de quien tiene la sesión. */
+  [PushPatterns.unsubscribe]: { payload: { endpoint: string; actor: DocumentActor }; response: PushOkResponseEntity };
+  /** Un aviso de prueba a los dispositivos de quien tiene la sesión. */
+  [PushPatterns.test]: { payload: { actor: DocumentActor }; response: PushSendResultEntity };
+  /** Envía un aviso a los dispositivos de esos funcionarios. Lo usa el gateway, no el navegador. */
+  [PushPatterns.send]: {
+    payload: { employeeIds: string[]; notification: PushNotificationInput };
+    response: PushSendResultEntity;
+  };
+}

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

@@ -73,6 +73,8 @@ export interface CaseFileEntryResponseEntity {
   sha256: CaseFileEntryEntity['sha256'];
   size: CaseFileEntryEntity['size'];
   hasAdvancedSignature: CaseFileEntryEntity['hasAdvancedSignature'];
+  /** Conformidad PDF/A que declara el archivo («PDF/A-2B»), «PDF», o `null` si no es un PDF o no se revisó. */
+  fileFormat: CaseFileEntryEntity['fileFormat'];
   /** Revisión de sus firmas al incorporarlo, en los archivos externos en PDF. */
   signatureCheck: PdfSignatureReportEntity | null;
   incorporatedByEmployeeId: CaseFileEntryEntity['incorporatedByEmployeeId'];

package/src/entities/desk/desk.entity.ts

@@ -8,6 +8,8 @@ export interface DeskFileResponseEntity {
   sha256: string;
   source: DeskFileSource;
   description: string | null;
+  /** Correo del que salió, si llegó por correo. */
+  mailIntakeId: string | null;
   /** Es un PDF: se puede redactar una comunicación con él o firmarlo como documento suelto. */
   isPdf: boolean;
   createdAt: string;
@@ -16,6 +18,8 @@ export interface DeskFileResponseEntity {
 export interface DeskSummaryEntity {
   /** Archivos del escritorio aún sin clasificar. */
   unclassified: number;
+  /** Correos reenviados a la casilla del gestor que esperan que elija sus adjuntos. */
+  pendingMails: number;
 }
 
 export interface DeskOkResponseEntity {

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

@@ -163,6 +163,11 @@ export interface DocumentGetByIdResponseEntity {
   keywords: DocumentEntity['keywords'];
   accessLevel: DocumentEntity['accessLevel'];
   hasSensitiveData: DocumentEntity['hasSensitiveData'];
+  /**
+   * Formato del archivo vigente: la conformidad PDF/A que declara («PDF/A-2B») o «PDF». `null` si no se revisó (los
+   * documentos anteriores a esta revisión, o aún sin firmar).
+   */
+  fileFormat: DocumentEntity['fileFormat'];
   status: DocumentEntity['status'];
   correlative: DocumentEntity['correlative'];
   correlativeYear: DocumentEntity['correlativeYear'];

package/src/entities/index.ts

@@ -20,3 +20,5 @@ export * from './accessRequest';
 export * from './transparency';
 export * from './dataProtection';
 export * from './desk';
+export * from './mailIntake';
+export * from './push';

package/src/entities/mailIntake/index.ts

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

package/src/entities/mailIntake/mailIntake.entity.ts

@@ -0,0 +1,55 @@
+import { type MailAuthentication } from '../../base/entities';
+
+/** Adjunto de un correo recibido. `index` lo identifica al elegir qué entra al escritorio. */
+export interface MailIntakeAttachmentEntity {
+  index: number;
+  fileName: string;
+  contentType: string;
+  size: number;
+  sha256: string;
+  /** Su tipo de archivo puede entrar al escritorio (PDF, documentos de oficina, imágenes). */
+  supported: boolean;
+}
+
+/** Correo reenviado a la casilla del gestor, a la espera de que su remitente elija qué adjuntos entran. */
+export interface MailIntakeItemEntity {
+  id: string;
+  fromAddress: string;
+  fromName: string | null;
+  subject: string;
+  /** Comienzo del texto del correo, para reconocerlo. */
+  textPreview: string | null;
+  /** Fecha del correo, según su remitente. */
+  sentAt: string | null;
+  /** Cuándo lo trajo el gestor desde la casilla. */
+  receivedAt: string;
+  /** Tamaño del correo completo (EML), en bytes. */
+  size: number;
+  /** Lo que informó el servidor de correo sobre el remitente: `Fail` puede ser un remitente suplantado. */
+  authentication: MailAuthentication;
+  authDetail: string | null;
+  attachments: MailIntakeAttachmentEntity[];
+}
+
+/** Los correos pendientes de quien tiene la sesión y a qué casilla reenviarlos. */
+export interface MailIntakeInboxEntity {
+  /** La casilla está configurada y se revisa. */
+  enabled: boolean;
+  /** Dirección a la que se reenvían los correos; `null` si no está configurada. */
+  address: string | null;
+  /** Los dominios desde los que se aceptan correos (los institucionales). */
+  domains: string[];
+  mails: MailIntakeItemEntity[];
+}
+
+/** Resultado de una revisión de la casilla. */
+export interface MailIntakeSyncEntity {
+  /** Correos sin leer que se revisaron. */
+  checked: number;
+  /** Los que quedaron registrados. */
+  created: number;
+  /** Repetidos o de un dominio que no es institucional: no se guardan. */
+  ignored: number;
+  /** Los que no se pudieron procesar; se reintentan en la próxima revisión. */
+  failed: number;
+}

package/src/entities/push/index.ts

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

package/src/entities/push/push.entity.ts

@@ -0,0 +1,31 @@
+/** Si los avisos push están habilitados y con qué clave pública se suscribe el navegador. */
+export interface PushConfigResponseEntity {
+  /** El servidor tiene sus claves VAPID: se pueden activar. */
+  enabled: boolean;
+  /** Clave pública VAPID (base64url) para `pushManager.subscribe`; `null` si no está habilitado. */
+  publicKey: string | null;
+  /** Dispositivos en que quien consulta tiene los avisos activos. */
+  devices: number;
+}
+
+export interface PushOkResponseEntity {
+  ok: boolean;
+}
+
+/** Resultado de un envío: avisos entregados al servicio push, suscripciones vencidas que se borraron y fallas. */
+export interface PushSendResultEntity {
+  sent: number;
+  removed: number;
+  failed: number;
+}
+
+/**
+ * Un aviso. `url` es una ruta del gestor (`/documentos/…/detalle`): el service worker la abre al tocar el aviso.
+ * `tag` agrupa: un aviso nuevo con el mismo `tag` reemplaza al anterior en el dispositivo.
+ */
+export interface PushNotificationInput {
+  title: string;
+  body: string;
+  url: string;
+  tag?: string | null;
+}