@muni-sanfer/types-gestor-documental 0.0.1-beta.4 → 0.0.1-beta.40

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'];
@@ -28,11 +29,19 @@ export interface CaseFileEntryDocumentEntity {
     correlative: DocumentEntity['correlative'];
     correlativeYear: DocumentEntity['correlativeYear'];
     documentType: DocumentTypeSummaryEntity;
+    /** N° del documento en DocDigital, si se despachó o se recibió por ahí: tiene comprobante de trazabilidad. */
+    docDigitalDocumentId: string | null;
 }
 /** Entrada del índice electrónico: una actuación, en su orden de incorporación. */
 export interface CaseFileEntryResponseEntity {
     id: CaseFileEntryEntity['id'];
     sequence: CaseFileEntryEntity['sequence'];
+    /** Subcarpeta del índice (sin valor: en la raíz). */
+    folder: CaseFileEntryEntity['folder'];
+    /** Documento en papel: dónde está, por qué no se digitalizó y cuántas páginas tiene. */
+    physicalLocation: CaseFileEntryEntity['physicalLocation'];
+    physicalReason: CaseFileEntryEntity['physicalReason'];
+    pageCount: CaseFileEntryEntity['pageCount'];
     kind: CaseFileEntryEntity['kind'];
     actuationType: CaseFileEntryEntity['actuationType'];
     title: CaseFileEntryEntity['title'];
@@ -50,6 +59,10 @@ 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'];
     incorporatedByFullName: CaseFileEntryEntity['incorporatedByFullName'];
     createdAt: CaseFileEntryEntity['createdAt'];
@@ -96,7 +109,10 @@ export interface CaseFileAccessResponseEntity {
     entryId: CaseFileAccessEntity['entryId'];
     /** Título del documento que se abrió, si el acceso fue a uno. */
     entryTitle: string | null;
+    /** El funcionario o, si fue por un enlace temporal, su destinatario externo. */
     employeeFullName: CaseFileAccessEntity['employeeFullName'];
+    /** Fue por un enlace temporal, sin sesión. */
+    external: boolean;
     createdAt: CaseFileAccessEntity['createdAt'];
 }
 export interface CaseFileGetByIdResponseEntity extends CaseFileGetAllResponseEntity {
@@ -109,6 +125,16 @@ export interface CaseFileGetByIdResponseEntity extends CaseFileGetAllResponseEnt
     uri: string | null;
     closedByFullName: CaseFileEntity['closedByFullName'];
     closingNote: CaseFileEntity['closingNote'];
+    /** Expediente híbrido: tiene documentos en papel que no se pudieron digitalizar. */
+    isHybrid: boolean;
+    /** MGDEE1_2: serie del Cuadro de Clasificación. */
+    archivalSeries: {
+        id: string;
+        code: string;
+        name: string;
+    } | null;
+    /** MGDEE8_2: fin de la restricción de acceso. */
+    restrictionEndsAt: string | null;
     index: CaseFileEntryResponseEntity[];
     sharedWith: CaseFileParticipantResponseEntity[];
     actors: CaseFileActorResponseEntity[];
@@ -136,6 +162,13 @@ export interface CaseFileUpdateResponseEntity {
     id: CaseFileEntity['id'];
     ok: boolean;
 }
+/** Lote incorporado: cuántos documentos entraron y cuántos se omitieron (ya estaban, o no finalizados). */
+export interface CaseFileAddBatchResponseEntity {
+    id: CaseFileEntity['id'];
+    added: number;
+    skipped: number;
+    ok: boolean;
+}
 export interface CaseFileAddEntryResponseEntity {
     id: CaseFileEntity['id'];
     entryId: CaseFileEntryEntity['id'];
@@ -167,3 +200,105 @@ export interface CaseFileExportResponseEntity {
 }
 /** Expediente en que está incorporado un documento, visto desde el documento. */
 export type DocumentCaseFileEntity = CaseFileLinkEntity;
+/** Estado de un enlace temporal: vigente, vencido o revocado. */
+export type CaseFileShareLinkStatus = 'Active' | 'Expired' | 'Revoked';
+/** Enlace temporal de un expediente, como lo ve su responsable. El token no se vuelve a mostrar. */
+export interface CaseFileShareLinkResponseEntity {
+    id: string;
+    recipient: string;
+    recipientEmail: string | null;
+    purpose: string | null;
+    allowExport: boolean;
+    expiresAt: string;
+    status: CaseFileShareLinkStatus;
+    createdByFullName: string;
+    createdAt: string;
+    revokedAt: string | null;
+    revokedByFullName: string | null;
+    /** Cuántas consultas, descargas y exportaciones se hicieron con él. */
+    accessCount: number;
+    lastAccessAt: string | null;
+}
+/** Enlace recién creado: el token va solo aquí; la dirección la arma quien lo muestra. */
+export interface CaseFileShareLinkCreateResponseEntity {
+    id: string;
+    token: string;
+    recipient: string;
+    recipientEmail: string | null;
+    purpose: string | null;
+    expiresAt: string;
+    /** Para avisarle al destinatario: qué expediente, de qué órgano y quién se lo comparte. */
+    caseFile: {
+        code: string;
+        title: string;
+    };
+    organName: string;
+    createdByFullName: string;
+}
+/** Actuación del índice como la ve el destinatario externo. */
+export interface CaseFileSharedEntryEntity {
+    id: string;
+    sequence: number;
+    folder: string | null;
+    kind: CaseFileEntryEntity['kind'];
+    actuationType: CaseFileEntryEntity['actuationType'];
+    title: string;
+    /** Tipo y número del documento («D.E. N° 590/2026») o el tipo declarado del archivo. */
+    reference: string | null;
+    originDate: string | null;
+    createdAt: string;
+    hasFile: boolean;
+    sha256: string | null;
+    hasAdvancedSignature: boolean;
+    physicalLocation: string | null;
+    pageCount: number | null;
+    voidedAt: string | null;
+    voidReason: string | null;
+}
+/** Expediente abierto con un enlace temporal: metadatos e índice, sin participantes ni registros internos. */
+export interface CaseFileSharedResponseEntity {
+    code: string;
+    title: string;
+    subject: string;
+    summary: string | null;
+    procedureName: string;
+    status: CaseFileEntity['status'];
+    organName: string;
+    responsibleFullName: string;
+    responsiblePosition: string | null;
+    createdAt: string;
+    closedAt: string | null;
+    recipient: string;
+    purpose: string | null;
+    expiresAt: string;
+    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/dist/entities/dataProtection/dataProtection.entity.d.ts

@@ -0,0 +1,180 @@
+import { type CommunicationMeans, type DataBreachEventAction, type DataBreachKind, type DataBreachNoticeMeans, type DataBreachStatus, type DataLegalBasis, type DataRight, type DataRightsChannel, type DataRightsEventAction, type DataRightsRequestStatus, type DataRightsResolution } from '../../base/entities';
+/** Tratamiento de datos personales de la municipalidad: lo que se informa al público (Ley 19.628, art. 14 ter). */
+export interface DataTreatmentResponseEntity {
+    id: string;
+    name: string;
+    purpose: string;
+    legalBasis: DataLegalBasis;
+    legalBasisDetail: string | null;
+    dataCategories: string[];
+    sensitiveData: boolean;
+    dataSubjects: string;
+    recipients: string | null;
+    source: string | null;
+    retention: string | null;
+    securityMeasures: string | null;
+    internationalTransfer: string | null;
+    responsibleUnit: string | null;
+    published: boolean;
+    enabled: boolean;
+    /** Solicitudes de titulares que lo mencionan. */
+    requests: number;
+    updatedAt: string;
+}
+/** Página pública de protección de datos: quién es el responsable, cómo ejercer los derechos y qué se trata. */
+export interface DataProtectionPolicyEntity {
+    organ: string;
+    /** Correo o medio en que se reciben las solicitudes de los titulares (art. 14 ter letra c). */
+    contact: string | null;
+    /** Dirección de la política de tratamiento, si está publicada aparte. */
+    policyUrl: string | null;
+    treatments: Omit<DataTreatmentResponseEntity, 'published' | 'enabled' | 'requests' | 'securityMeasures'>[];
+}
+/** Semáforo del plazo: a tiempo, por vencer (5 días corridos o menos) o vencido. */
+export type DataRightsDueStatus = 'OnTime' | 'DueSoon' | 'Overdue';
+export interface DataRightsRequestListItemEntity {
+    id: string;
+    /** «N° 4/2026». */
+    label: string;
+    channel: DataRightsChannel;
+    rights: DataRight[];
+    requesterName: string;
+    requestText: string;
+    treatmentName: string | null;
+    receivedAt: string;
+    dueAt: string;
+    status: DataRightsRequestStatus;
+    resolution: DataRightsResolution | null;
+    assigneeFullName: string | null;
+    acknowledged: boolean;
+    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;
+    resolvedOnTime: boolean | null;
+}
+export interface DataRightsDocumentLinkEntity {
+    id: string;
+    folio: string | null;
+    subject: string;
+}
+export interface DataRightsRequestDetailEntity extends DataRightsRequestListItemEntity {
+    year: number;
+    number: number;
+    requesterRut: string | null;
+    requesterEmail: string | null;
+    requesterAddress: string | null;
+    representativeName: string | null;
+    identityVerifiedAt: string | null;
+    identityNote: string | null;
+    treatmentId: string | null;
+    acknowledgedAt: string | null;
+    extendedAt: string | null;
+    extensionNote: string | null;
+    blockingRequested: boolean;
+    blockingReason: string | null;
+    blockingDueAt: string | null;
+    blockingGranted: boolean | null;
+    blockingResolvedAt: string | null;
+    blockingNote: string | null;
+    blockingLiftedAt: string | null;
+    blockingLiftNote: string | null;
+    assigneeEmployeeId: string | null;
+    resolvedAt: string | null;
+    denialGrounds: string[];
+    resolutionNote: string | null;
+    responseDocument: DataRightsDocumentLinkEntity | null;
+    responseSentAt: string | null;
+    responseSentTo: string | null;
+    responseSentMeans: CommunicationMeans | null;
+    /** Hasta cuándo el titular puede reclamar ante la Agencia (30 días hábiles), si se denegó en todo o en parte. */
+    complaintDeadline: string | null;
+    complaintAt: string | null;
+    complaintNote: string | null;
+    createdByFullName: string;
+    /** Se puede prorrogar: abierta, sin prórroga y antes de vencer. */
+    canExtend: boolean;
+    /** El titular ya puede reclamar ante la Agencia: denegación o plazo vencido sin respuesta. */
+    canRegisterComplaint: boolean;
+    events: {
+        action: DataRightsEventAction;
+        note: string | null;
+        employeeFullName: string;
+        createdAt: string;
+    }[];
+}
+export interface DataRightsSummaryEntity {
+    year: number;
+    total: number;
+    open: number;
+    overdue: number;
+    dueSoon: number;
+    /** Abiertas sin acuse de recibo. */
+    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 %. */
+    onTimeRate: number | null;
+    complaints: number;
+}
+/** Datos personales que se reconocen en el texto de un documento, enmascarados: ayudan a tarjar. */
+export interface PersonalDataHintsEntity {
+    ruts: number;
+    emails: number;
+    phones: number;
+    /** Algunos ejemplos enmascarados («11.1••.•••-1»). */
+    samples: string[];
+}
+/** Vulneración de las medidas de seguridad que afecta datos personales (Ley 19.628, art. 14 sexies). */
+export interface DataBreachResponseEntity {
+    id: string;
+    /** «N° 2/2026». */
+    label: string;
+    year: number;
+    number: number;
+    detectedAt: string;
+    occurredAt: string | null;
+    kinds: DataBreachKind[];
+    description: string;
+    effects: string | null;
+    dataCategories: string[];
+    affectedCount: number | null;
+    measures: string | null;
+    sensitiveData: boolean;
+    minorsData: boolean;
+    financialData: boolean;
+    riskToRights: boolean;
+    treatmentId: string | null;
+    treatmentName: string | null;
+    status: DataBreachStatus;
+    /** Hay riesgo razonable para los titulares: se reporta a la Agencia sin dilaciones indebidas. */
+    mustReportAgency: boolean;
+    /** Además, datos sensibles, de menores de 14 o de obligaciones económicas: se comunica a los titulares. */
+    mustNotifyHolders: boolean;
+    agencyReportedAt: string | null;
+    agencyReportNote: string | null;
+    /** Horas entre la detección y el reporte a la Agencia (o hasta ahora, si falta reportarla). */
+    agencyDelayHours: number | null;
+    holdersNotifiedAt: string | null;
+    holdersNoticeMeans: DataBreachNoticeMeans | null;
+    holdersNoticeNote: string | null;
+    closedAt: string | null;
+    closeNote: string | null;
+    createdByFullName: string;
+    /** Por qué todavía no se puede cerrar, o `null` si se puede. */
+    closeBlock: string | null;
+    events: {
+        action: DataBreachEventAction;
+        note: string | null;
+        employeeFullName: string;
+        createdAt: string;
+    }[];
+}

package/dist/entities/dataProtection/dataProtection.entity.js

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

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

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

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

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

@@ -0,0 +1,25 @@
+import { type DeskFileSource } from '../../base/entities';
+/** Archivo suelto del escritorio de un funcionario («Sin clasificar»). */
+export interface DeskFileResponseEntity {
+    id: string;
+    fileName: string;
+    size: number;
+    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;
+}
+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;
+    ok: boolean;
+}

package/dist/entities/desk/desk.entity.js

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

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

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

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