@muni-sanfer/types-gestor-documental 0.0.1-beta.23 → 0.0.1-beta.25

package/dist/base/entities.d.ts

@@ -33,7 +33,7 @@ export declare const DocumentParticipantStatus: {
     Resolved: "Resolved";
     Rejected: "Rejected";
 };
-export type DocumentTrackingAction = 'Created' | 'Updated' | 'Submitted' | 'Visaed' | 'Signed' | 'Rejected' | 'Finished' | 'Discarded' | 'Numbered' | 'NumberAnnulled' | 'Annulled' | 'Delivered' | 'Derived' | 'Reassigned' | 'Dispatched' | 'DispatchReturned' | 'Received' | 'EmailCopySent' | 'EmailCopyOpened';
+export type DocumentTrackingAction = 'Created' | 'Updated' | 'Submitted' | 'Visaed' | 'Signed' | 'Rejected' | 'Finished' | 'Discarded' | 'Numbered' | 'NumberAnnulled' | 'Annulled' | 'Delivered' | 'Derived' | 'Reassigned' | 'Dispatched' | 'DispatchReturned' | 'Received' | 'EmailCopySent' | 'EmailCopyOpened' | 'DispositionRecorded';
 export declare const DocumentTrackingAction: {
     Created: "Created";
     Updated: "Updated";
@@ -54,6 +54,7 @@ export declare const DocumentTrackingAction: {
     Received: "Received";
     EmailCopySent: "EmailCopySent";
     EmailCopyOpened: "EmailCopyOpened";
+    DispositionRecorded: "DispositionRecorded";
 };
 export type DocumentOrigin = 'Internal' | 'DocDigital';
 export declare const DocumentOrigin: {
@@ -146,7 +147,7 @@ export declare const CaseFileActorType: {
     PrivateInstitution: "PrivateInstitution";
     Official: "Official";
 };
-export type CaseFileTrackingAction = 'Created' | 'Updated' | 'EntryAdded' | 'EntryVoided' | 'EntryMoved' | 'ParticipantAdded' | 'ParticipantRemoved' | 'Closed' | 'Exported' | 'ShareLinkCreated' | 'ShareLinkRevoked';
+export type CaseFileTrackingAction = 'Created' | 'Updated' | 'EntryAdded' | 'EntryVoided' | 'EntryMoved' | 'ParticipantAdded' | 'ParticipantRemoved' | 'Closed' | 'Exported' | 'ShareLinkCreated' | 'ShareLinkRevoked' | 'DispositionRecorded';
 export declare const CaseFileTrackingAction: {
     Created: "Created";
     Updated: "Updated";
@@ -159,6 +160,7 @@ export declare const CaseFileTrackingAction: {
     Exported: "Exported";
     ShareLinkCreated: "ShareLinkCreated";
     ShareLinkRevoked: "ShareLinkRevoked";
+    DispositionRecorded: "DispositionRecorded";
 };
 export type CaseFileAccessAction = 'Viewed' | 'FileDownloaded' | 'Exported';
 export declare const CaseFileAccessAction: {
@@ -226,6 +228,53 @@ export declare const AuditAction: {
     Removed: "Removed";
     Exported: "Exported";
 };
+export type FinalDisposition = 'Permanent' | 'Eliminate' | 'Select';
+export declare const FinalDisposition: {
+    Permanent: "Permanent";
+    Eliminate: "Eliminate";
+    Select: "Select";
+};
+export type DispositionKind = 'Transfer' | 'Elimination';
+export declare const DispositionKind: {
+    Transfer: "Transfer";
+    Elimination: "Elimination";
+};
+export type AccessRequestChannel = 'Portal' | 'Email' | 'InPerson' | 'Letter';
+export declare const AccessRequestChannel: {
+    Portal: "Portal";
+    Email: "Email";
+    InPerson: "InPerson";
+    Letter: "Letter";
+};
+export type AccessRequestStatus = 'Received' | 'InCorrection' | 'InProgress' | 'Resolved';
+export declare const AccessRequestStatus: {
+    Received: "Received";
+    InCorrection: "InCorrection";
+    InProgress: "InProgress";
+    Resolved: "Resolved";
+};
+export type AccessRequestResolution = 'Delivered' | 'PartiallyDelivered' | 'Denied' | 'Derived' | 'NonExistent' | 'Withdrawn';
+export declare const AccessRequestResolution: {
+    Delivered: "Delivered";
+    PartiallyDelivered: "PartiallyDelivered";
+    Denied: "Denied";
+    Derived: "Derived";
+    NonExistent: "NonExistent";
+    Withdrawn: "Withdrawn";
+};
+export type AccessRequestEventAction = 'Received' | 'Updated' | 'CorrectionRequested' | 'Corrected' | 'Assigned' | 'ThirdPartyNotified' | 'OppositionRegistered' | 'Extended' | 'Resolved' | 'AppealRegistered';
+export declare const AccessRequestEventAction: {
+    Received: "Received";
+    Updated: "Updated";
+    CorrectionRequested: "CorrectionRequested";
+    Corrected: "Corrected";
+    Assigned: "Assigned";
+    ThirdPartyNotified: "ThirdPartyNotified";
+    OppositionRegistered: "OppositionRegistered";
+    Extended: "Extended";
+    Resolved: "Resolved";
+    AppealRegistered: "AppealRegistered";
+};
 export interface DocumentTypeEntity {
     id: string;
     name: string;
@@ -306,6 +355,10 @@ export interface DocumentEntity {
     externalRecipients?: DocumentExternalRecipientEntity[];
     emailCopies?: DocumentEmailCopyEntity[];
     accesses?: DocumentAccessEntity[];
+    disposition?: DispositionRecordEntity | null;
+    dispositionId?: string | null;
+    accessRequestResponses?: AccessRequestEntity[];
+    accessRequestDeliveries?: AccessRequestDocumentEntity[];
     dispatch?: DocumentDispatchEntity | null;
     docDigitalInbound?: DocDigitalInboundEntity | null;
     deleted: boolean;
@@ -462,6 +515,8 @@ export interface CaseFileEntity {
     responsibleFullName: string;
     responsiblePosition?: string | null;
     closedAt?: string | null;
+    disposition?: DispositionRecordEntity | null;
+    dispositionId?: string | null;
     closedByEmployeeId?: string | null;
     closedByFullName?: string | null;
     closingNote?: string | null;
@@ -699,9 +754,14 @@ export interface ArchivalSeriesEntity {
     name: string;
     section?: string | null;
     description?: string | null;
+    managementYears?: number | null;
+    centralYears?: number | null;
+    finalDisposition?: FinalDisposition | null;
+    retentionNote?: string | null;
     enabled: boolean;
     documentTypes?: DocumentTypeEntity[];
     caseFiles?: CaseFileEntity[];
+    dispositions?: DispositionRecordEntity[];
     deleted: boolean;
     createdAt: string;
     updatedAt: string;
@@ -815,6 +875,76 @@ export interface AuditLogEntity {
     employeeFullName: string;
     createdAt: string;
 }
+export interface DispositionRecordEntity {
+    id: string;
+    kind: DispositionKind;
+    number: number;
+    year: number;
+    observation?: string | null;
+    series?: ArchivalSeriesEntity;
+    seriesId: string;
+    documents?: DocumentEntity[];
+    caseFiles?: CaseFileEntity[];
+    createdByEmployeeId: string;
+    createdByFullName: string;
+    createdAt: string;
+}
+export interface AccessRequestEntity {
+    id: string;
+    number: number;
+    year: number;
+    externalFolio?: string | null;
+    channel: AccessRequestChannel;
+    receivedAt: string;
+    requesterName: string;
+    requesterEmail?: string | null;
+    requesterAddress?: string | null;
+    requestText: string;
+    deliveryFormat?: string | null;
+    status: AccessRequestStatus;
+    correctionRequestedAt?: string | null;
+    correctionDueAt?: string | null;
+    correctedAt?: string | null;
+    dueAt: string;
+    extendedAt?: string | null;
+    extensionNote?: string | null;
+    assigneeEmployeeId?: string | null;
+    assigneeFullName?: string | null;
+    thirdPartyNotifiedAt?: string | null;
+    oppositionDueAt?: string | null;
+    thirdPartyOpposed?: boolean | null;
+    resolution?: AccessRequestResolution | null;
+    resolvedAt?: string | null;
+    denialGrounds: string[];
+    derivedTo?: string | null;
+    resolutionNote?: string | null;
+    responseDocument?: DocumentEntity | null;
+    responseDocumentId?: string | null;
+    appealedAt?: string | null;
+    appealNote?: string | null;
+    createdByEmployeeId: string;
+    createdByFullName: string;
+    documents?: AccessRequestDocumentEntity[];
+    events?: AccessRequestEventEntity[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AccessRequestDocumentEntity {
+    accessRequest?: AccessRequestEntity;
+    accessRequestId: string;
+    document?: DocumentEntity;
+    documentId: string;
+}
+export interface AccessRequestEventEntity {
+    id: string;
+    action: AccessRequestEventAction;
+    note?: string | null;
+    employeeId?: string | null;
+    employeeFullName: string;
+    accessRequest?: AccessRequestEntity;
+    accessRequestId: string;
+    createdAt: string;
+}
 type JsonValue = string | number | boolean | {
     [key in string]?: JsonValue;
 } | Array<JsonValue> | null;

package/dist/base/entities.js

@@ -1,7 +1,7 @@
 "use strict";
 // This file was auto-generated by prisma-generator-typescript-interfaces
 Object.defineProperty(exports, "__esModule", { value: true });
-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.DocumentOrigin = exports.DocumentTrackingAction = exports.DocumentParticipantStatus = exports.DocumentParticipantRole = exports.DocumentAccessLevel = exports.DocumentStatus = exports.DocumentCategory = void 0;
+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.DocumentOrigin = exports.DocumentTrackingAction = exports.DocumentParticipantStatus = exports.DocumentParticipantRole = exports.DocumentAccessLevel = exports.DocumentStatus = exports.DocumentCategory = void 0;
 exports.DocumentCategory = {
     Decree: 'Decree',
     Communication: 'Communication',
@@ -52,6 +52,7 @@ exports.DocumentTrackingAction = {
     Received: 'Received',
     EmailCopySent: 'EmailCopySent',
     EmailCopyOpened: 'EmailCopyOpened',
+    DispositionRecorded: 'DispositionRecorded',
 };
 exports.DocumentOrigin = {
     Internal: 'Internal',
@@ -142,6 +143,7 @@ exports.CaseFileTrackingAction = {
     Exported: 'Exported',
     ShareLinkCreated: 'ShareLinkCreated',
     ShareLinkRevoked: 'ShareLinkRevoked',
+    DispositionRecorded: 'DispositionRecorded',
 };
 exports.CaseFileAccessAction = {
     Viewed: 'Viewed',
@@ -200,3 +202,44 @@ exports.AuditAction = {
     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',
+};

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

@@ -1,3 +1,4 @@
+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';
@@ -16,6 +17,11 @@ export interface ArchivalSeriesWritePayload {
     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]: {

package/dist/contracts/index.d.ts

@@ -9,6 +9,8 @@ import { type IndicatorsContract } from './indicators.contract';
 import { type AuditContract } from './audit.contract';
 import { type SignatureCheckContract } from './signatureCheck.contract';
 import { type RepositoryExportContract } from './repositoryExport.contract';
+import { type RetentionContract } from './retention.contract';
+import { type AccessRequestContract } from './accessRequest.contract';
 import { type ScanContract } from './scan.contract';
 import { type PartsOfficeContract } from './partsOffice.contract';
 import { type ProcedureContract } from './procedure.contract';
@@ -33,6 +35,8 @@ export * from './indicators.contract';
 export * from './audit.contract';
 export * from './signatureCheck.contract';
 export * from './repositoryExport.contract';
+export * from './retention.contract';
+export * from './accessRequest.contract';
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export declare const GestorDocumentalPatterns: {
     readonly documentType: {
@@ -198,6 +202,21 @@ export declare const GestorDocumentalPatterns: {
         readonly getCaseFiles: "gestorDocumental.repositoryExport.getCaseFiles";
         readonly record: "gestorDocumental.repositoryExport.record";
     };
+    readonly retention: {
+        readonly getSummary: "gestorDocumental.retention.getSummary";
+        readonly getDueItems: "gestorDocumental.retention.getDueItems";
+        readonly createRecord: "gestorDocumental.retention.createRecord";
+        readonly getRecords: "gestorDocumental.retention.getRecords";
+        readonly getRecordPdf: "gestorDocumental.retention.getRecordPdf";
+    };
+    readonly accessRequest: {
+        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";
+    };
 };
 /** 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;
+export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & IssuingEntityContract & CaseFileContract & PartsOfficeContract & RegisterBookContract & SignatureBatchContract & WorkFolderContract & ScanContract & ArchivalSeriesContract & TextSnippetContract & HolidayContract & IndicatorsContract & AuditContract & SignatureCheckContract & RepositoryExportContract & RetentionContract & AccessRequestContract;

package/dist/contracts/index.js

@@ -26,6 +26,8 @@ const indicators_contract_1 = require("./indicators.contract");
 const audit_contract_1 = require("./audit.contract");
 const signatureCheck_contract_1 = require("./signatureCheck.contract");
 const repositoryExport_contract_1 = require("./repositoryExport.contract");
+const retention_contract_1 = require("./retention.contract");
+const accessRequest_contract_1 = require("./accessRequest.contract");
 const scan_contract_1 = require("./scan.contract");
 const partsOffice_contract_1 = require("./partsOffice.contract");
 const procedure_contract_1 = require("./procedure.contract");
@@ -50,6 +52,8 @@ __exportStar(require("./indicators.contract"), exports);
 __exportStar(require("./audit.contract"), exports);
 __exportStar(require("./signatureCheck.contract"), exports);
 __exportStar(require("./repositoryExport.contract"), exports);
+__exportStar(require("./retention.contract"), exports);
+__exportStar(require("./accessRequest.contract"), exports);
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 exports.GestorDocumentalPatterns = {
     documentType: documentType_contract_1.DocumentTypePatterns,
@@ -69,4 +73,6 @@ exports.GestorDocumentalPatterns = {
     audit: audit_contract_1.AuditPatterns,
     signatureCheck: signatureCheck_contract_1.SignatureCheckPatterns,
     repositoryExport: repositoryExport_contract_1.RepositoryExportPatterns,
+    retention: retention_contract_1.RetentionPatterns,
+    accessRequest: accessRequest_contract_1.AccessRequestPatterns,
 };

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

@@ -14,6 +14,8 @@ export interface RepositoryExportQuery {
     from?: string | null;
     to?: string | null;
     scope?: RepositoryExportScope;
+    /** Solo lo incluido en un acta de transferencia: el paquete para el Archivo Nacional. */
+    dispositionId?: string | null;
 }
 export interface RepositoryExportContract {
     [RepositoryExportPatterns.getSummary]: {

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

@@ -0,0 +1,58 @@
+import { type DispositionKind } from '../base/entities';
+import { type DispositionRecordResponseEntity, type IndicatorsFileEntity, type RetentionDueItemEntity, type RetentionSummaryEntity } from '../entities';
+import { type RpcPage } from './contract';
+/** Patrones NATS de `retention`: plazos de retención por serie y actas de transferencia o eliminación. */
+export declare const RetentionPatterns: {
+    readonly getSummary: "gestorDocumental.retention.getSummary";
+    readonly getDueItems: "gestorDocumental.retention.getDueItems";
+    readonly createRecord: "gestorDocumental.retention.createRecord";
+    readonly getRecords: "gestorDocumental.retention.getRecords";
+    readonly getRecordPdf: "gestorDocumental.retention.getRecordPdf";
+};
+export interface RetentionContract {
+    [RetentionPatterns.getSummary]: {
+        payload: Record<string, never>;
+        response: RetentionSummaryEntity;
+    };
+    /** Lo vencido de una serie, de lo más antiguo a lo más reciente. */
+    [RetentionPatterns.getDueItems]: {
+        payload: {
+            seriesId: string;
+            page?: number;
+            limit?: number;
+        };
+        response: RpcPage<RetentionDueItemEntity[]>;
+    };
+    /**
+     * Emite el acta con lo elegido (todo debe estar vencido y sin acta). Según la serie: conservación permanente →
+     * transferencia; eliminación → eliminación; selección → cualquiera de las dos.
+     */
+    [RetentionPatterns.createRecord]: {
+        payload: {
+            kind: DispositionKind;
+            seriesId: string;
+            documentIds: string[];
+            caseFileIds: string[];
+            observation?: string | null;
+            actor: {
+                employeeId: string;
+                fullName: string;
+            };
+        };
+        response: DispositionRecordResponseEntity;
+    };
+    [RetentionPatterns.getRecords]: {
+        payload: {
+            year: number;
+        };
+        response: DispositionRecordResponseEntity[];
+    };
+    /** El acta en PDF, con lo que incluye, para firmarla y archivarla. */
+    [RetentionPatterns.getRecordPdf]: {
+        payload: {
+            id: string;
+            generatedBy: string;
+        };
+        response: IndicatorsFileEntity;
+    };
+}

package/dist/contracts/retention.contract.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetentionPatterns = void 0;
+/** Patrones NATS de `retention`: plazos de retención por serie y actas de transferencia o eliminación. */
+exports.RetentionPatterns = {
+    getSummary: 'gestorDocumental.retention.getSummary',
+    getDueItems: 'gestorDocumental.retention.getDueItems',
+    createRecord: 'gestorDocumental.retention.createRecord',
+    getRecords: 'gestorDocumental.retention.getRecords',
+    getRecordPdf: 'gestorDocumental.retention.getRecordPdf',
+};

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

@@ -0,0 +1,73 @@
+import { type AccessRequestChannel, type AccessRequestEventAction, type AccessRequestResolution, type AccessRequestStatus } from '../../base/entities';
+/** Semáforo del plazo de respuesta: a tiempo, por vencer (2 días hábiles o menos) o vencido. */
+export type AccessRequestDueStatus = 'OnTime' | 'DueSoon' | 'Overdue';
+export interface AccessRequestListItemEntity {
+    id: string;
+    /** «N° 15/2026». */
+    label: string;
+    externalFolio: string | null;
+    channel: AccessRequestChannel;
+    requesterName: string;
+    requestText: string;
+    receivedAt: string;
+    dueAt: string;
+    status: AccessRequestStatus;
+    resolution: AccessRequestResolution | null;
+    assigneeFullName: string | null;
+    /** Solo mientras está abierta. */
+    dueStatus: AccessRequestDueStatus | null;
+    businessDaysLeft: number | null;
+    /** Ya resuelta: si se respondió dentro del plazo. */
+    resolvedOnTime: boolean | null;
+}
+export interface AccessRequestDocumentLinkEntity {
+    id: string;
+    folio: string | null;
+    subject: string;
+}
+export interface AccessRequestDetailEntity extends AccessRequestListItemEntity {
+    year: number;
+    number: number;
+    requesterEmail: string | null;
+    requesterAddress: string | null;
+    deliveryFormat: string | null;
+    correctionRequestedAt: string | null;
+    correctionDueAt: string | null;
+    correctedAt: string | null;
+    extendedAt: string | null;
+    extensionNote: string | null;
+    assigneeEmployeeId: string | null;
+    thirdPartyNotifiedAt: string | null;
+    oppositionDueAt: string | null;
+    thirdPartyOpposed: boolean | null;
+    resolvedAt: string | null;
+    denialGrounds: string[];
+    derivedTo: string | null;
+    resolutionNote: string | null;
+    responseDocument: AccessRequestDocumentLinkEntity | null;
+    documents: AccessRequestDocumentLinkEntity[];
+    appealedAt: string | null;
+    appealNote: string | null;
+    createdByFullName: string;
+    /** Se puede prorrogar: abierta, sin prórroga y antes de vencer. */
+    canExtend: boolean;
+    events: {
+        action: AccessRequestEventAction;
+        note: string | null;
+        employeeFullName: string;
+        createdAt: string;
+    }[];
+}
+export interface AccessRequestSummaryEntity {
+    year: number;
+    total: number;
+    open: number;
+    overdue: number;
+    dueSoon: number;
+    resolved: Record<AccessRequestResolution, number>;
+    /** Respondidas dentro del plazo sobre las respondidas, en %. */
+    onTimeRate: number | null;
+    /** Días hábiles promedio entre el ingreso (o la subsanación) y la respuesta. */
+    averageBusinessDays: number | null;
+    appealed: number;
+}

package/dist/entities/accessRequest/accessRequest.entity.js

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

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

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

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

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

@@ -6,6 +6,11 @@ export interface ArchivalSeriesGetAllResponseEntity {
     section: ArchivalSeriesEntity['section'];
     description: ArchivalSeriesEntity['description'];
     enabled: ArchivalSeriesEntity['enabled'];
+    /** Tabla de Retención Documental: años en archivo de gestión y central, y qué se hace después. */
+    managementYears: ArchivalSeriesEntity['managementYears'];
+    centralYears: ArchivalSeriesEntity['centralYears'];
+    finalDisposition: ArchivalSeriesEntity['finalDisposition'];
+    retentionNote: ArchivalSeriesEntity['retentionNote'];
     /** Cuántos tipos documentales y expedientes la usan. */
     documentTypes: number;
     caseFiles: number;