@muni-sanfer/types-gestor-documental 0.0.1-beta.5 → 0.0.1-beta.50

package/dist/base/entities.js

@@ -1,7 +1,8 @@
 "use strict";
 // This file was auto-generated by prisma-generator-typescript-interfaces
 Object.defineProperty(exports, "__esModule", { value: true });
-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.DocumentOrigin = exports.DocumentTrackingAction = exports.DocumentParticipantStatus = exports.DocumentParticipantRole = exports.DocumentAccessLevel = exports.DocumentStatus = exports.DocumentCategory = void 0;
+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.HolidaySource = 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.DraftReviewStatus = exports.DocumentTrackingAction = exports.DocumentParticipantStatus = exports.DocumentParticipantRole = exports.DocumentAccessLevel = exports.DocumentStatus = exports.DocumentCategory = void 0;
+exports.DraftingRequestEventAction = exports.DraftingRequestStatus = exports.MailAuthentication = exports.MailIntakeStatus = exports.DeskFileTarget = exports.DeskFileSource = void 0;
 exports.DocumentCategory = {
     Decree: 'Decree',
     Communication: 'Communication',
@@ -49,11 +50,36 @@ exports.DocumentTrackingAction = {
     Reassigned: 'Reassigned',
     Dispatched: 'Dispatched',
     DispatchReturned: 'DispatchReturned',
+    DispatchedByContingency: 'DispatchedByContingency',
     Received: 'Received',
+    EmailCopySent: 'EmailCopySent',
+    EmailCopyOpened: 'EmailCopyOpened',
+    DispositionRecorded: 'DispositionRecorded',
+    TransparencyRedacted: 'TransparencyRedacted',
+    TransparencyPublished: 'TransparencyPublished',
+    TransparencyExcluded: 'TransparencyExcluded',
+    TransparencyWithdrawn: 'TransparencyWithdrawn',
+    DraftReviewRequested: 'DraftReviewRequested',
+    DraftReviewApproved: 'DraftReviewApproved',
+    DraftReviewRejected: 'DraftReviewRejected',
+    DraftReviewCancelled: 'DraftReviewCancelled',
+};
+exports.DraftReviewStatus = {
+    Pending: 'Pending',
+    Approved: 'Approved',
+    Rejected: 'Rejected',
+    Cancelled: 'Cancelled',
 };
 exports.DocumentOrigin = {
     Internal: 'Internal',
     DocDigital: 'DocDigital',
+    Manual: 'Manual',
+};
+exports.CommunicationMeans = {
+    Paper: 'Paper',
+    Email: 'Email',
+    Courier: 'Courier',
+    Other: 'Other',
 };
 exports.DocumentDispatchStatus = {
     Pending: 'Pending',
@@ -112,6 +138,7 @@ exports.CaseFileEntryKind = {
     Document: 'Document',
     File: 'File',
     CaseFile: 'CaseFile',
+    Physical: 'Physical',
 };
 exports.CaseFileActorRelation = {
     Responsible: 'Responsible',
@@ -132,13 +159,220 @@ exports.CaseFileTrackingAction = {
     Updated: 'Updated',
     EntryAdded: 'EntryAdded',
     EntryVoided: 'EntryVoided',
+    EntryMoved: 'EntryMoved',
     ParticipantAdded: 'ParticipantAdded',
     ParticipantRemoved: 'ParticipantRemoved',
     Closed: 'Closed',
     Exported: 'Exported',
+    ShareLinkCreated: 'ShareLinkCreated',
+    ShareLinkRevoked: 'ShareLinkRevoked',
+    DispositionRecorded: 'DispositionRecorded',
 };
 exports.CaseFileAccessAction = {
     Viewed: 'Viewed',
     FileDownloaded: 'FileDownloaded',
     Exported: 'Exported',
 };
+exports.ScanSessionStatus = {
+    Open: 'Open',
+    Ready: 'Ready',
+};
+exports.TextSnippetSection = {
+    Vistos: 'Vistos',
+    Considerando: 'Considerando',
+    Resolutive: 'Resolutive',
+    Body: 'Body',
+    Closing: 'Closing',
+};
+exports.HolidaySource = {
+    Manual: 'Manual',
+    Api: 'Api',
+};
+exports.WorkFolderItemKind = {
+    Document: 'Document',
+    File: 'File',
+};
+exports.ServiceOutageKind = {
+    Unplanned: 'Unplanned',
+    Planned: 'Planned',
+};
+exports.QualityMetricKey = {
+    Effectiveness: 'Effectiveness',
+    Efficiency: 'Efficiency',
+    Availability: 'Availability',
+    ResponseTime: 'ResponseTime',
+    Accessibility: 'Accessibility',
+    FunctionalCompleteness: 'FunctionalCompleteness',
+    Interoperability: 'Interoperability',
+};
+exports.DocumentAccessAction = {
+    Viewed: 'Viewed',
+    FileDownloaded: 'FileDownloaded',
+    TrailExported: 'TrailExported',
+};
+exports.AuditEntity = {
+    DocumentType: 'DocumentType',
+    IssuingEntity: 'IssuingEntity',
+    ArchivalSeries: 'ArchivalSeries',
+    TextSnippet: 'TextSnippet',
+    Holiday: 'Holiday',
+    Procedure: 'Procedure',
+    QualityMetric: 'QualityMetric',
+    ServiceOutage: 'ServiceOutage',
+    Repository: 'Repository',
+    DataTreatment: 'DataTreatment',
+    DocumentTemplate: 'DocumentTemplate',
+    DirectorateReviewer: 'DirectorateReviewer',
+};
+exports.AuditAction = {
+    Created: 'Created',
+    Updated: 'Updated',
+    Enabled: 'Enabled',
+    Disabled: 'Disabled',
+    Removed: 'Removed',
+    Exported: 'Exported',
+};
+exports.FinalDisposition = {
+    Permanent: 'Permanent',
+    Eliminate: 'Eliminate',
+    Select: 'Select',
+};
+exports.DispositionKind = {
+    Transfer: 'Transfer',
+    Elimination: 'Elimination',
+};
+exports.AccessRequestChannel = {
+    Portal: 'Portal',
+    Email: 'Email',
+    InPerson: 'InPerson',
+    Letter: 'Letter',
+};
+exports.AccessRequestStatus = {
+    Received: 'Received',
+    InCorrection: 'InCorrection',
+    InProgress: 'InProgress',
+    Resolved: 'Resolved',
+};
+exports.AccessRequestResolution = {
+    Delivered: 'Delivered',
+    PartiallyDelivered: 'PartiallyDelivered',
+    Denied: 'Denied',
+    Derived: 'Derived',
+    NonExistent: 'NonExistent',
+    Withdrawn: 'Withdrawn',
+};
+exports.AccessRequestEventAction = {
+    Received: 'Received',
+    Updated: 'Updated',
+    CorrectionRequested: 'CorrectionRequested',
+    Corrected: 'Corrected',
+    Assigned: 'Assigned',
+    ThirdPartyNotified: 'ThirdPartyNotified',
+    OppositionRegistered: 'OppositionRegistered',
+    Extended: 'Extended',
+    Resolved: 'Resolved',
+    AppealRegistered: 'AppealRegistered',
+};
+exports.TransparencyStatus = {
+    Published: 'Published',
+    Excluded: 'Excluded',
+};
+exports.DataLegalBasis = {
+    LegalFunction: 'LegalFunction',
+    LegalObligation: 'LegalObligation',
+    Consent: 'Consent',
+    Contract: 'Contract',
+    VitalInterest: 'VitalInterest',
+};
+exports.DataRight = {
+    Access: 'Access',
+    Rectification: 'Rectification',
+    Suppression: 'Suppression',
+    Opposition: 'Opposition',
+    Portability: 'Portability',
+};
+exports.DataRightsChannel = {
+    Email: 'Email',
+    WebForm: 'WebForm',
+    InPerson: 'InPerson',
+    Letter: 'Letter',
+};
+exports.DataRightsRequestStatus = {
+    Received: 'Received',
+    InProgress: 'InProgress',
+    Resolved: 'Resolved',
+};
+exports.DataRightsResolution = {
+    Granted: 'Granted',
+    PartiallyGranted: 'PartiallyGranted',
+    Denied: 'Denied',
+    Withdrawn: 'Withdrawn',
+};
+exports.DataRightsEventAction = {
+    Received: 'Received',
+    Updated: 'Updated',
+    Acknowledged: 'Acknowledged',
+    IdentityVerified: 'IdentityVerified',
+    Assigned: 'Assigned',
+    BlockingResolved: 'BlockingResolved',
+    BlockingLifted: 'BlockingLifted',
+    Extended: 'Extended',
+    Resolved: 'Resolved',
+    ResponseSent: 'ResponseSent',
+    ComplaintRegistered: 'ComplaintRegistered',
+};
+exports.DataBreachKind = {
+    Destruction: 'Destruction',
+    Leak: 'Leak',
+    Loss: 'Loss',
+    Alteration: 'Alteration',
+    UnauthorizedAccess: 'UnauthorizedAccess',
+};
+exports.DataBreachStatus = {
+    Open: 'Open',
+    Closed: 'Closed',
+};
+exports.DataBreachEventAction = {
+    Registered: 'Registered',
+    Updated: 'Updated',
+    AgencyReported: 'AgencyReported',
+    HoldersNotified: 'HoldersNotified',
+    Closed: 'Closed',
+};
+exports.DataBreachNoticeMeans = {
+    Individual: 'Individual',
+    PublicNotice: 'PublicNotice',
+};
+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',
+};
+exports.DraftingRequestStatus = {
+    Pending: 'Pending',
+    Taken: 'Taken',
+    Declined: 'Declined',
+    Cancelled: 'Cancelled',
+};
+exports.DraftingRequestEventAction = {
+    Created: 'Created',
+    Taken: 'Taken',
+    Released: 'Released',
+    Declined: 'Declined',
+    Cancelled: 'Cancelled',
+    DocumentLinked: 'DocumentLinked',
+};

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

@@ -0,0 +1,109 @@
+import { type AccessRequestChannel, type AccessRequestResolution } from '../base/entities';
+import { type AccessRequestDetailEntity, type AccessRequestListItemEntity, type AccessRequestSummaryEntity } from '../entities';
+import { type RpcPage } from './contract';
+/** Patrones NATS de `accessRequest`: solicitudes de acceso a la información pública (Ley 20.285). */
+export declare const AccessRequestPatterns: {
+    readonly getAll: "gestorDocumental.accessRequest.getAll";
+    readonly getById: "gestorDocumental.accessRequest.getById";
+    readonly getSummary: "gestorDocumental.accessRequest.getSummary";
+    readonly create: "gestorDocumental.accessRequest.create";
+    readonly update: "gestorDocumental.accessRequest.update";
+    readonly act: "gestorDocumental.accessRequest.act";
+};
+export interface AccessRequestWritePayload {
+    externalFolio?: string | null;
+    channel: AccessRequestChannel;
+    /** Fecha y hora de ingreso (ISO): desde ahí corren los 20 días hábiles. */
+    receivedAt: string;
+    requesterName: string;
+    requesterEmail?: string | null;
+    requesterAddress?: string | null;
+    requestText: string;
+    deliveryFormat?: string | null;
+}
+/** Lo que se hace con una solicitud, un paso a la vez. */
+export type AccessRequestAction = {
+    type: 'requestCorrection';
+    note: string;
+} | {
+    type: 'registerCorrection';
+    correctedAt?: string | null;
+    note?: string | null;
+} | {
+    type: 'assign';
+    employeeId: string;
+    fullName: string;
+    note?: string | null;
+} | {
+    type: 'notifyThirdParty';
+    note: string;
+} | {
+    type: 'registerOpposition';
+    opposed: boolean;
+    note?: string | null;
+} | {
+    type: 'extend';
+    note: string;
+} | {
+    type: 'resolve';
+    resolution: AccessRequestResolution;
+    grounds?: string[];
+    derivedTo?: string | null;
+    note?: string | null;
+    responseDocumentId?: string | null;
+    documentIds?: string[];
+} | {
+    type: 'registerAppeal';
+    appealedAt?: string | null;
+    note: string;
+};
+export interface AccessRequestActor {
+    employeeId: string;
+    fullName: string;
+}
+export interface AccessRequestContract {
+    [AccessRequestPatterns.getAll]: {
+        payload: {
+            status?: 'open' | 'resolved' | 'all';
+            year?: number | null;
+            search?: string;
+            page?: number;
+            limit?: number;
+        };
+        response: RpcPage<AccessRequestListItemEntity[]>;
+    };
+    [AccessRequestPatterns.getById]: {
+        payload: {
+            id: string;
+        };
+        response: AccessRequestDetailEntity;
+    };
+    [AccessRequestPatterns.getSummary]: {
+        payload: {
+            year: number;
+        };
+        response: AccessRequestSummaryEntity;
+    };
+    [AccessRequestPatterns.create]: {
+        payload: AccessRequestWritePayload & {
+            actor: AccessRequestActor;
+        };
+        response: AccessRequestDetailEntity;
+    };
+    /** Corrige los datos mientras no está resuelta. */
+    [AccessRequestPatterns.update]: {
+        payload: AccessRequestWritePayload & {
+            id: string;
+            actor: AccessRequestActor;
+        };
+        response: AccessRequestDetailEntity;
+    };
+    [AccessRequestPatterns.act]: {
+        payload: {
+            id: string;
+            action: AccessRequestAction;
+            actor: AccessRequestActor;
+        };
+        response: AccessRequestDetailEntity;
+    };
+}

package/dist/contracts/accessRequest.contract.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccessRequestPatterns = void 0;
+/** Patrones NATS de `accessRequest`: solicitudes de acceso a la información pública (Ley 20.285). */
+exports.AccessRequestPatterns = {
+    getAll: 'gestorDocumental.accessRequest.getAll',
+    getById: 'gestorDocumental.accessRequest.getById',
+    getSummary: 'gestorDocumental.accessRequest.getSummary',
+    create: 'gestorDocumental.accessRequest.create',
+    update: 'gestorDocumental.accessRequest.update',
+    act: 'gestorDocumental.accessRequest.act',
+};

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

@@ -0,0 +1,56 @@
+import { type FinalDisposition } from '../base/entities';
+import { type ArchivalSeriesEntity } from '../base/entities';
+import { type ArchivalSeriesCreateResponseEntity, type ArchivalSeriesGetAllResponseEntity, type ArchivalSeriesGetByIdResponseEntity, type ArchivalSeriesUpdateResponseEntity } from '../entities';
+import { type RpcPage } from './contract';
+/** Patrones NATS de `archivalSeries` (series del Cuadro de Clasificación): `<servicio>.<recurso>.<acción>`. */
+export declare const ArchivalSeriesPatterns: {
+    readonly getAll: "gestorDocumental.archivalSeries.getAll";
+    readonly getById: "gestorDocumental.archivalSeries.getById";
+    readonly create: "gestorDocumental.archivalSeries.create";
+    readonly update: "gestorDocumental.archivalSeries.update";
+    readonly setEnabled: "gestorDocumental.archivalSeries.setEnabled";
+};
+/** Datos de una serie documental al crearla o editarla. */
+export interface ArchivalSeriesWritePayload {
+    code: string;
+    name: string;
+    section?: string | null;
+    description?: string | null;
+    enabled?: boolean;
+    /** Tabla de Retención Documental: los tres juntos o ninguno. */
+    managementYears?: number | null;
+    centralYears?: number | null;
+    finalDisposition?: FinalDisposition | null;
+    retentionNote?: string | null;
+}
+export interface ArchivalSeriesContract {
+    [ArchivalSeriesPatterns.getAll]: {
+        payload: {
+            pagination?: {
+                page?: number;
+                limit?: number;
+            };
+            filters?: {
+                search?: string;
+                enabled?: boolean;
+            };
+        };
+        response: RpcPage<ArchivalSeriesGetAllResponseEntity[]>;
+    };
+    [ArchivalSeriesPatterns.getById]: {
+        payload: Pick<ArchivalSeriesEntity, 'id'>;
+        response: ArchivalSeriesGetByIdResponseEntity;
+    };
+    [ArchivalSeriesPatterns.create]: {
+        payload: ArchivalSeriesWritePayload;
+        response: ArchivalSeriesCreateResponseEntity;
+    };
+    [ArchivalSeriesPatterns.update]: {
+        payload: ArchivalSeriesWritePayload & Pick<ArchivalSeriesEntity, 'id'>;
+        response: ArchivalSeriesUpdateResponseEntity;
+    };
+    [ArchivalSeriesPatterns.setEnabled]: {
+        payload: Pick<ArchivalSeriesEntity, 'id' | 'enabled'>;
+        response: ArchivalSeriesUpdateResponseEntity;
+    };
+}

package/dist/contracts/archivalSeries.contract.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArchivalSeriesPatterns = void 0;
+/** Patrones NATS de `archivalSeries` (series del Cuadro de Clasificación): `<servicio>.<recurso>.<acción>`. */
+exports.ArchivalSeriesPatterns = {
+    getAll: 'gestorDocumental.archivalSeries.getAll',
+    getById: 'gestorDocumental.archivalSeries.getById',
+    create: 'gestorDocumental.archivalSeries.create',
+    update: 'gestorDocumental.archivalSeries.update',
+    setEnabled: 'gestorDocumental.archivalSeries.setEnabled',
+};

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

@@ -0,0 +1,32 @@
+import { type AuditEventEntity, type AuditSource, type IndicatorsFileEntity } from '../entities';
+import { type RpcPage } from './contract';
+/** Patrones NATS de `audit`: la auditoría reúne todos los registros del gestor en una sola vista. */
+export declare const AuditPatterns: {
+    readonly getEvents: "gestorDocumental.audit.getEvents";
+    readonly export: "gestorDocumental.audit.export";
+};
+/** Qué hechos: período (días de Chile «AAAA-MM-DD», hasta un año) y filtros optativos. */
+export interface AuditQuery {
+    from: string;
+    to: string;
+    sources?: AuditSource[];
+    /** Parte del nombre de quien actuó. */
+    person?: string;
+    /** Parte del folio, materia, IUIe, título o nombre de lo afectado. */
+    reference?: string;
+    page?: number;
+    limit?: number;
+}
+export interface AuditContract {
+    [AuditPatterns.getEvents]: {
+        payload: AuditQuery;
+        response: RpcPage<AuditEventEntity[]>;
+    };
+    /** Los hechos filtrados (hasta 10.000) en Excel. `generatedBy`: quién la descarga. */
+    [AuditPatterns.export]: {
+        payload: Omit<AuditQuery, 'page' | 'limit'> & {
+            generatedBy: string;
+        };
+        response: IndicatorsFileEntity;
+    };
+}

package/dist/contracts/audit.contract.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditPatterns = void 0;
+/** Patrones NATS de `audit`: la auditoría reúne todos los registros del gestor en una sola vista. */
+exports.AuditPatterns = {
+    getEvents: 'gestorDocumental.audit.getEvents',
+    export: 'gestorDocumental.audit.export',
+};

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

@@ -1,5 +1,5 @@
 import { type CaseFileActorRelation, type CaseFileActorType, type CaseFileActuationType, type CaseFileEntity, type CaseFileStatus, type DocumentAccessLevel } from '../base/entities';
-import { type CaseFileAddEntryResponseEntity, type CaseFileCreateResponseEntity, type CaseFileEntryFileResponseEntity, type CaseFileExportResponseEntity, type CaseFileGetAllResponseEntity, type CaseFileGetByIdResponseEntity, type CaseFileUpdateResponseEntity } from '../entities';
+import { type CaseFileAddBatchResponseEntity, type CaseFileAddEntryResponseEntity, type CaseFileCreateResponseEntity, type CaseFileEntryFileResponseEntity, type CaseFileExportResponseEntity, type CaseFileGetAllResponseEntity, type CaseFileGetByIdResponseEntity, type CaseFileShareLinkCreateResponseEntity, type CaseFileShareLinkResponseEntity, type CaseFileSharedResponseEntity, type CaseFileUpdateResponseEntity, type CaseFileVerifyExportResponseEntity, type DocumentPublicFileResponseEntity } from '../entities';
 import { type RpcPage } from './contract';
 import { type DocumentActor } from './document.contract';
 /** Patrones NATS de `caseFile`: `<servicio>.<recurso>.<acción>`. */
@@ -9,13 +9,35 @@ export declare const CaseFilePatterns: {
     readonly create: "gestorDocumental.caseFile.create";
     readonly update: "gestorDocumental.caseFile.update";
     readonly addEntry: "gestorDocumental.caseFile.addEntry";
+    readonly addBatch: "gestorDocumental.caseFile.addBatch";
     readonly voidEntry: "gestorDocumental.caseFile.voidEntry";
+    readonly moveEntry: "gestorDocumental.caseFile.moveEntry";
     readonly share: "gestorDocumental.caseFile.share";
     readonly unshare: "gestorDocumental.caseFile.unshare";
     readonly close: "gestorDocumental.caseFile.close";
     readonly getEntryFile: "gestorDocumental.caseFile.getEntryFile";
     readonly getExport: "gestorDocumental.caseFile.getExport";
+    readonly getIntegratedPdf: "gestorDocumental.caseFile.getIntegratedPdf";
+    readonly createShareLink: "gestorDocumental.caseFile.createShareLink";
+    readonly getShareLinks: "gestorDocumental.caseFile.getShareLinks";
+    readonly revokeShareLink: "gestorDocumental.caseFile.revokeShareLink";
+    readonly getShared: "gestorDocumental.caseFile.getShared";
+    readonly getSharedEntryFile: "gestorDocumental.caseFile.getSharedEntryFile";
+    readonly getSharedExport: "gestorDocumental.caseFile.getSharedExport";
+    readonly verifyExport: "gestorDocumental.caseFile.verifyExport";
 };
+/** Enlace temporal para que alguien de fuera consulte el expediente sin sesión. */
+export interface CaseFileShareLinkPayload {
+    /** A quién se entrega. Ej: «Contraloría Regional». */
+    recipient: string;
+    /** Si se indica, el gateway le envía el enlace por correo. */
+    recipientEmail?: string | null;
+    purpose?: string | null;
+    /** Cuántos días dura: de 1 a 30. */
+    days: number;
+    /** Puede descargar el expediente completo (ZIP). Por omisión, sí. */
+    allowExport?: boolean;
+}
 /** Persona u organización relacionada con el expediente (MGDEE54). */
 export interface CaseFileActorInput {
     relation: CaseFileActorRelation;
@@ -31,6 +53,10 @@ export interface CaseFileWritePayload {
     procedureId: string;
     accessLevel: DocumentAccessLevel;
     hasSensitiveData: boolean;
+    /** MGDEE8_2: fin de la restricción de acceso (ISO 8601), si no es público. */
+    restrictionEndsAt?: string | null;
+    /** MGDEE1_2: serie del Cuadro de Clasificación. */
+    archivalSeriesId?: string | null;
     actors?: CaseFileActorInput[];
 }
 /** Actuación que se incorpora al índice: un documento del gestor, un archivo subido u otro expediente. */
@@ -54,6 +80,21 @@ export type CaseFileEntryInput = {
     kind: 'CaseFile';
     actuationType: CaseFileActuationType;
     linkedCaseFileId: string;
+} | {
+    kind: 'Physical';
+    actuationType: CaseFileActuationType;
+    title: string;
+    documentTypeName?: string | null;
+    originDate?: string | null;
+    author?: string | null;
+    /** Dónde está el papel: oficina, archivador, caja (MGDDE5_5). */
+    physicalLocation: string;
+    /** Por qué no se pudo digitalizar. */
+    physicalReason: string;
+    pageCount?: number | null;
+    keywords: string[];
+    accessLevel: DocumentAccessLevel;
+    hasSensitiveData: boolean;
 };
 /** Quién hace la operación (de la sesión) y si puede ver todos los expedientes. */
 interface CaseFileActorPayload {
@@ -97,13 +138,32 @@ export interface CaseFileContract {
         };
         response: CaseFileUpdateResponseEntity;
     };
+    /** Incorpora los documentos finalizados de un lote de firma, en su orden; omite los que ya están en el expediente. */
+    [CaseFilePatterns.addBatch]: {
+        payload: {
+            id: string;
+            batchId: string;
+            actuationType: CaseFileActuationType;
+        } & CaseFileActorPayload;
+        response: CaseFileAddBatchResponseEntity;
+    };
     [CaseFilePatterns.addEntry]: {
         payload: Pick<CaseFileEntity, 'id'> & {
             entry: CaseFileEntryInput;
+            folder?: string | null;
         } & CaseFileActorPayload;
         response: CaseFileAddEntryResponseEntity;
     };
     /** Deja una actuación sin efecto, con su motivo. No se elimina del índice. */
+    /** Pasa una actuación a otra subcarpeta del índice (`null`: a la raíz). El orden de incorporación no cambia. */
+    [CaseFilePatterns.moveEntry]: {
+        payload: {
+            id: string;
+            entryId: string;
+            folder: string | null;
+        } & CaseFileActorPayload;
+        response: CaseFileUpdateResponseEntity;
+    };
     [CaseFilePatterns.voidEntry]: {
         payload: Pick<CaseFileEntity, 'id'> & {
             entryId: string;
@@ -145,5 +205,68 @@ export interface CaseFileContract {
         payload: Pick<CaseFileEntity, 'id'> & CaseFileActorPayload;
         response: CaseFileExportResponseEntity;
     };
+    /**
+     * PDF integrador: todas las actuaciones en un solo PDF, en orden de incorporación, con portada e índice. Queda en la
+     * trazabilidad y en el registro de accesos, como la exportación. Sin el sello de copia autorizada (necesita firma
+     * desatendida).
+     */
+    [CaseFilePatterns.getIntegratedPdf]: {
+        payload: Pick<CaseFileEntity, 'id'> & CaseFileActorPayload;
+        response: DocumentPublicFileResponseEntity;
+    };
+    /** Crea un enlace temporal: solo su responsable. El token viaja solo en esta respuesta. */
+    [CaseFilePatterns.createShareLink]: {
+        payload: Pick<CaseFileEntity, 'id'> & CaseFileShareLinkPayload & {
+            actor: DocumentActor;
+        };
+        response: CaseFileShareLinkCreateResponseEntity;
+    };
+    /** Enlaces del expediente, vigentes o no, con cuántas veces se usaron: su responsable o quien ve todos. */
+    [CaseFilePatterns.getShareLinks]: {
+        payload: Pick<CaseFileEntity, 'id'> & CaseFileActorPayload;
+        response: CaseFileShareLinkResponseEntity[];
+    };
+    [CaseFilePatterns.revokeShareLink]: {
+        payload: Pick<CaseFileEntity, 'id'> & {
+            linkId: string;
+            actor: DocumentActor;
+        };
+        response: CaseFileUpdateResponseEntity;
+    };
+    /** Sin sesión, con el token del enlace: metadatos e índice. Queda en el registro de accesos. */
+    [CaseFilePatterns.getShared]: {
+        payload: {
+            token: string;
+        };
+        response: CaseFileSharedResponseEntity;
+    };
+    [CaseFilePatterns.getSharedEntryFile]: {
+        payload: {
+            token: string;
+            entryId: string;
+        };
+        response: CaseFileEntryFileResponseEntity;
+    };
+    /** El expediente completo, si el enlace lo permite. Queda en la trazabilidad y en el registro de accesos. */
+    /**
+     * Verificador público del ZIP exportado: sin sesión, con el identificador del expediente y la huella SHA-256 que
+     * calculó el navegador para cada actuación (el ZIP no se sube). Se compara con las huellas registradas al incorporar.
+     */
+    [CaseFilePatterns.verifyExport]: {
+        payload: {
+            code: string;
+            entries: {
+                sequence: number;
+                sha256: string;
+            }[];
+        };
+        response: CaseFileVerifyExportResponseEntity;
+    };
+    [CaseFilePatterns.getSharedExport]: {
+        payload: {
+            token: string;
+        };
+        response: CaseFileExportResponseEntity;
+    };
 }
 export {};