@muni-sanfer/types-gestor-documental 0.0.1-beta.32 → 0.0.1-beta.34

package/dist/base/entities.d.ts

@@ -330,7 +330,7 @@ export declare const DataRightsResolution: {
     Denied: "Denied";
     Withdrawn: "Withdrawn";
 };
-export type DataRightsEventAction = 'Received' | 'Updated' | 'Acknowledged' | 'IdentityVerified' | 'Assigned' | 'BlockingResolved' | 'Extended' | 'Resolved' | 'ResponseSent' | 'ComplaintRegistered';
+export type DataRightsEventAction = 'Received' | 'Updated' | 'Acknowledged' | 'IdentityVerified' | 'Assigned' | 'BlockingResolved' | 'BlockingLifted' | 'Extended' | 'Resolved' | 'ResponseSent' | 'ComplaintRegistered';
 export declare const DataRightsEventAction: {
     Received: "Received";
     Updated: "Updated";
@@ -338,6 +338,7 @@ export declare const DataRightsEventAction: {
     IdentityVerified: "IdentityVerified";
     Assigned: "Assigned";
     BlockingResolved: "BlockingResolved";
+    BlockingLifted: "BlockingLifted";
     Extended: "Extended";
     Resolved: "Resolved";
     ResponseSent: "ResponseSent";
@@ -369,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;
@@ -1118,6 +1132,8 @@ export interface DataRightsRequestEntity {
     blockingGranted?: boolean | null;
     blockingResolvedAt?: string | null;
     blockingNote?: string | null;
+    blockingLiftedAt?: string | null;
+    blockingLiftNote?: string | null;
     assigneeEmployeeId?: string | null;
     assigneeFullName?: string | null;
     resolution?: DataRightsResolution | null;
@@ -1203,6 +1219,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',
@@ -298,6 +299,7 @@ exports.DataRightsEventAction = {
     IdentityVerified: 'IdentityVerified',
     Assigned: 'Assigned',
     BlockingResolved: 'BlockingResolved',
+    BlockingLifted: 'BlockingLifted',
     Extended: 'Extended',
     Resolved: 'Resolved',
     ResponseSent: 'ResponseSent',
@@ -328,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/dataProtection.contract.d.ts

@@ -76,6 +76,11 @@ export type DataRightsAction = {
     type: 'resolveBlocking';
     granted: boolean;
     note?: string | null;
+}
+/** Levanta el bloqueo concedido (también después de responder): esos datos se vuelven a tratar. */
+ | {
+    type: 'liftBlocking';
+    note?: string | null;
 } | {
     type: 'extend';
     note: string;

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/dataProtection/dataProtection.entity.d.ts

@@ -50,6 +50,8 @@ export interface DataRightsRequestListItemEntity {
     identityVerified: boolean;
     /** Bloqueo temporal pedido y sin resolver. */
     blockingPending: boolean;
+    /** Bloqueo temporal concedido y todavía no levantado: esos datos no se tratan. */
+    blockingActive: boolean;
     /** Solo mientras está abierta. */
     dueStatus: DataRightsDueStatus | null;
     daysLeft: number | null;
@@ -79,6 +81,8 @@ export interface DataRightsRequestDetailEntity extends DataRightsRequestListItem
     blockingGranted: boolean | null;
     blockingResolvedAt: string | null;
     blockingNote: string | null;
+    blockingLiftedAt: string | null;
+    blockingLiftNote: string | null;
     assigneeEmployeeId: string | null;
     resolvedAt: string | null;
     denialGrounds: string[];
@@ -113,6 +117,8 @@ export interface DataRightsSummaryEntity {
     unacknowledged: number;
     /** Bloqueos temporales pedidos y sin resolver. */
     blockingPending: number;
+    /** Bloqueos temporales concedidos y no levantados, de cualquier año. */
+    blockingActive: number;
     byRight: Record<DataRight, number>;
     resolved: Record<DataRightsResolution, number>;
     /** Respondidas dentro del plazo sobre las respondidas, en %. */

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/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.32",
+  "version": "0.0.1-beta.34",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {

package/src/base/entities.ts

@@ -500,6 +500,7 @@ export type DataRightsEventAction =
   | 'IdentityVerified'
   | 'Assigned'
   | 'BlockingResolved'
+  | 'BlockingLifted'
   | 'Extended'
   | 'Resolved'
   | 'ResponseSent'
@@ -512,6 +513,7 @@ export const DataRightsEventAction = {
   IdentityVerified: 'IdentityVerified',
   Assigned: 'Assigned',
   BlockingResolved: 'BlockingResolved',
+  BlockingLifted: 'BlockingLifted',
   Extended: 'Extended',
   Resolved: 'Resolved',
   ResponseSent: 'ResponseSent',
@@ -552,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';
@@ -566,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;
@@ -1348,6 +1367,8 @@ export interface DataRightsRequestEntity {
   blockingGranted?: boolean | null;
   blockingResolvedAt?: string | null;
   blockingNote?: string | null;
+  blockingLiftedAt?: string | null;
+  blockingLiftNote?: string | null;
   assigneeEmployeeId?: string | null;
   assigneeFullName?: string | null;
   resolution?: DataRightsResolution | null;
@@ -1437,6 +1458,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/dataProtection.contract.ts

@@ -83,6 +83,8 @@ export type DataRightsAction =
   | { type: 'assign'; employeeId: string; fullName: string; note?: string | null }
   /** Bloqueo temporal, en 2 días hábiles; si se rechaza, fundado (y se comunica a la Agencia). */
   | { type: 'resolveBlocking'; granted: boolean; note?: string | null }
+  /** Levanta el bloqueo concedido (también después de responder): esos datos se vuelven a tratar. */
+  | { type: 'liftBlocking'; note?: string | null }
   | { type: 'extend'; note: string }
   | {
       type: 'resolve';

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/dataProtection/dataProtection.entity.ts

@@ -66,6 +66,8 @@ export interface DataRightsRequestListItemEntity {
   identityVerified: boolean;
   /** Bloqueo temporal pedido y sin resolver. */
   blockingPending: boolean;
+  /** Bloqueo temporal concedido y todavía no levantado: esos datos no se tratan. */
+  blockingActive: boolean;
   /** Solo mientras está abierta. */
   dueStatus: DataRightsDueStatus | null;
   daysLeft: number | null;
@@ -97,6 +99,8 @@ export interface DataRightsRequestDetailEntity extends DataRightsRequestListItem
   blockingGranted: boolean | null;
   blockingResolvedAt: string | null;
   blockingNote: string | null;
+  blockingLiftedAt: string | null;
+  blockingLiftNote: string | null;
   assigneeEmployeeId: string | null;
   resolvedAt: string | null;
   denialGrounds: string[];
@@ -127,6 +131,8 @@ export interface DataRightsSummaryEntity {
   unacknowledged: number;
   /** Bloqueos temporales pedidos y sin resolver. */
   blockingPending: number;
+  /** Bloqueos temporales concedidos y no levantados, de cualquier año. */
+  blockingActive: number;
   byRight: Record<DataRight, number>;
   resolved: Record<DataRightsResolution, number>;
   /** Respondidas dentro del plazo sobre las respondidas, en %. */

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/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;
+}