@muni-sanfer/types-gestor-documental 0.0.1-beta.22 → 0.0.1-beta.24

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: {
@@ -205,7 +207,7 @@ export declare const DocumentAccessAction: {
     FileDownloaded: "FileDownloaded";
     TrailExported: "TrailExported";
 };
-export type AuditEntity = 'DocumentType' | 'IssuingEntity' | 'ArchivalSeries' | 'TextSnippet' | 'Holiday' | 'Procedure' | 'QualityMetric' | 'ServiceOutage';
+export type AuditEntity = 'DocumentType' | 'IssuingEntity' | 'ArchivalSeries' | 'TextSnippet' | 'Holiday' | 'Procedure' | 'QualityMetric' | 'ServiceOutage' | 'Repository';
 export declare const AuditEntity: {
     DocumentType: "DocumentType";
     IssuingEntity: "IssuingEntity";
@@ -215,14 +217,27 @@ export declare const AuditEntity: {
     Procedure: "Procedure";
     QualityMetric: "QualityMetric";
     ServiceOutage: "ServiceOutage";
+    Repository: "Repository";
 };
-export type AuditAction = 'Created' | 'Updated' | 'Enabled' | 'Disabled' | 'Removed';
+export type AuditAction = 'Created' | 'Updated' | 'Enabled' | 'Disabled' | 'Removed' | 'Exported';
 export declare const AuditAction: {
     Created: "Created";
     Updated: "Updated";
     Enabled: "Enabled";
     Disabled: "Disabled";
     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 interface DocumentTypeEntity {
     id: string;
@@ -304,6 +319,8 @@ export interface DocumentEntity {
     externalRecipients?: DocumentExternalRecipientEntity[];
     emailCopies?: DocumentEmailCopyEntity[];
     accesses?: DocumentAccessEntity[];
+    disposition?: DispositionRecordEntity | null;
+    dispositionId?: string | null;
     dispatch?: DocumentDispatchEntity | null;
     docDigitalInbound?: DocDigitalInboundEntity | null;
     deleted: boolean;
@@ -460,6 +477,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;
@@ -697,9 +716,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;
@@ -813,6 +837,20 @@ 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;
+}
 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.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',
@@ -190,6 +192,7 @@ exports.AuditEntity = {
     Procedure: 'Procedure',
     QualityMetric: 'QualityMetric',
     ServiceOutage: 'ServiceOutage',
+    Repository: 'Repository',
 };
 exports.AuditAction = {
     Created: 'Created',
@@ -197,4 +200,14 @@ exports.AuditAction = {
     Enabled: 'Enabled',
     Disabled: 'Disabled',
     Removed: 'Removed',
+    Exported: 'Exported',
+};
+exports.FinalDisposition = {
+    Permanent: 'Permanent',
+    Eliminate: 'Eliminate',
+    Select: 'Select',
+};
+exports.DispositionKind = {
+    Transfer: 'Transfer',
+    Elimination: 'Elimination',
 };

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

@@ -8,6 +8,8 @@ import { type HolidayContract } from './holiday.contract';
 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 ScanContract } from './scan.contract';
 import { type PartsOfficeContract } from './partsOffice.contract';
 import { type ProcedureContract } from './procedure.contract';
@@ -31,6 +33,8 @@ export * from './holiday.contract';
 export * from './indicators.contract';
 export * from './audit.contract';
 export * from './signatureCheck.contract';
+export * from './repositoryExport.contract';
+export * from './retention.contract';
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export declare const GestorDocumentalPatterns: {
     readonly documentType: {
@@ -190,6 +194,19 @@ export declare const GestorDocumentalPatterns: {
     readonly signatureCheck: {
         readonly check: "gestorDocumental.signatureCheck.check";
     };
+    readonly repositoryExport: {
+        readonly getSummary: "gestorDocumental.repositoryExport.getSummary";
+        readonly getDocuments: "gestorDocumental.repositoryExport.getDocuments";
+        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";
+    };
 };
 /** 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;
+export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & IssuingEntityContract & CaseFileContract & PartsOfficeContract & RegisterBookContract & SignatureBatchContract & WorkFolderContract & ScanContract & ArchivalSeriesContract & TextSnippetContract & HolidayContract & IndicatorsContract & AuditContract & SignatureCheckContract & RepositoryExportContract & RetentionContract;

package/dist/contracts/index.js

@@ -25,6 +25,8 @@ const holiday_contract_1 = require("./holiday.contract");
 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 scan_contract_1 = require("./scan.contract");
 const partsOffice_contract_1 = require("./partsOffice.contract");
 const procedure_contract_1 = require("./procedure.contract");
@@ -48,6 +50,8 @@ __exportStar(require("./holiday.contract"), exports);
 __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);
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 exports.GestorDocumentalPatterns = {
     documentType: documentType_contract_1.DocumentTypePatterns,
@@ -66,4 +70,6 @@ exports.GestorDocumentalPatterns = {
     indicators: indicators_contract_1.IndicatorsPatterns,
     audit: audit_contract_1.AuditPatterns,
     signatureCheck: signatureCheck_contract_1.SignatureCheckPatterns,
+    repositoryExport: repositoryExport_contract_1.RepositoryExportPatterns,
+    retention: retention_contract_1.RetentionPatterns,
 };

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

@@ -0,0 +1,57 @@
+import { type RepositoryExportCaseFilesPageEntity, type RepositoryExportRecordResponseEntity, type RepositoryExportDocumentsPageEntity, type RepositoryExportScope, type RepositoryExportSummaryEntity } from '../entities';
+/**
+ * Patrones NATS de `repositoryExport`: exportación completa del repositorio (portabilidad). El ms entrega los datos
+ * por páginas, porque un mensaje NATS no admite más de 1 MB; el gateway arma el ZIP con ellos y los archivos.
+ */
+export declare const RepositoryExportPatterns: {
+    readonly getSummary: "gestorDocumental.repositoryExport.getSummary";
+    readonly getDocuments: "gestorDocumental.repositoryExport.getDocuments";
+    readonly getCaseFiles: "gestorDocumental.repositoryExport.getCaseFiles";
+    readonly record: "gestorDocumental.repositoryExport.record";
+};
+/** Período por fecha de creación (días de Chile «AAAA-MM-DD»); sin él, todo. */
+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]: {
+        payload: RepositoryExportQuery;
+        response: RepositoryExportSummaryEntity;
+    };
+    /** Hasta 50 documentos por página, en orden de creación. */
+    [RepositoryExportPatterns.getDocuments]: {
+        payload: RepositoryExportQuery & {
+            cursor?: string | null;
+            limit?: number;
+        };
+        response: RepositoryExportDocumentsPageEntity;
+    };
+    /** Hasta 10 expedientes por página; cada uno queda con «Exportó» en su trazabilidad, a nombre de quien exporta. */
+    [RepositoryExportPatterns.getCaseFiles]: {
+        payload: Omit<RepositoryExportQuery, 'scope'> & {
+            cursor?: string | null;
+            limit?: number;
+            actor: {
+                employeeId: string | null;
+                fullName: string;
+            };
+        };
+        response: RepositoryExportCaseFilesPageEntity;
+    };
+    /** Deja la exportación en la bitácora: quién, qué período y si llevó archivos. */
+    [RepositoryExportPatterns.record]: {
+        payload: RepositoryExportQuery & {
+            includeFiles: boolean;
+            complete: boolean;
+            actor: {
+                employeeId: string | null;
+                fullName: string;
+            };
+        };
+        response: RepositoryExportRecordResponseEntity;
+    };
+}

package/dist/contracts/repositoryExport.contract.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RepositoryExportPatterns = void 0;
+/**
+ * Patrones NATS de `repositoryExport`: exportación completa del repositorio (portabilidad). El ms entrega los datos
+ * por páginas, porque un mensaje NATS no admite más de 1 MB; el gateway arma el ZIP con ellos y los archivos.
+ */
+exports.RepositoryExportPatterns = {
+    getSummary: 'gestorDocumental.repositoryExport.getSummary',
+    getDocuments: 'gestorDocumental.repositoryExport.getDocuments',
+    getCaseFiles: 'gestorDocumental.repositoryExport.getCaseFiles',
+    record: 'gestorDocumental.repositoryExport.record',
+};

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

package/dist/entities/index.d.ts

@@ -14,3 +14,5 @@ export * from './holiday';
 export * from './indicators';
 export * from './audit';
 export * from './signatureCheck';
+export * from './repositoryExport';
+export * from './retention';

package/dist/entities/index.js

@@ -30,3 +30,5 @@ __exportStar(require("./holiday"), exports);
 __exportStar(require("./indicators"), exports);
 __exportStar(require("./audit"), exports);
 __exportStar(require("./signatureCheck"), exports);
+__exportStar(require("./repositoryExport"), exports);
+__exportStar(require("./retention"), exports);

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

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

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

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

@@ -0,0 +1,124 @@
+import { type CaseFileExportResponseEntity } from '../caseFile';
+/** Qué documentos: los oficiales (finalizados y anulados) o todos, también borradores y en tramitación. */
+export type RepositoryExportScope = 'official' | 'all';
+/** Un archivo que el gateway descarga y pone en el ZIP, en la ruta indicada. */
+export interface RepositoryExportFile {
+    fileId: string;
+    path: string;
+    kind: 'document' | 'attachment';
+}
+/** Un documento con todos sus datos, como va en `documentos/*.jsonl`. Claves en castellano, como `expediente.json`. */
+export interface RepositoryDocumentRecord {
+    id: string;
+    tipo: {
+        nombre: string;
+        sigla: string | null;
+        serie: {
+            codigo: string;
+            nombre: string;
+        } | null;
+    };
+    entidadEmisora: string;
+    folio: string | null;
+    numero: number | null;
+    anio: number | null;
+    materia: string;
+    palabrasClave: string[];
+    nivelAcceso: string;
+    datosSensibles: boolean;
+    finRestriccion: string | null;
+    estado: string;
+    origen: string;
+    codigoVerificacion: string | null;
+    redactor: {
+        id: string;
+        nombre: string;
+    };
+    unidadEmisora: {
+        codigoDireccion: number | null;
+        departamentoId: string | null;
+    };
+    creado: string;
+    enviado: string | null;
+    finalizado: string | null;
+    anulacion: {
+        fecha: string;
+        motivo: string | null;
+    } | null;
+    numerosAnulados: {
+        numero: number;
+        anio: number;
+        motivo: string;
+        registradoPor: string;
+        fecha: string;
+    }[];
+    participantes: {
+        rol: string;
+        orden: number;
+        etapa: number;
+        nombre: string;
+        cargo: string | null;
+        estado: string;
+        resueltoEl: string | null;
+        observacion: string | null;
+    }[];
+    destinatarios: {
+        tipo: string;
+        nombre: string;
+        cargo: string | null;
+    }[];
+    destinatariosExternos: {
+        entidad: string;
+        usuario: string | null;
+    }[];
+    despacho: {
+        estado: string;
+        folio: string | null;
+        despachadoEl: string | null;
+        idDocDigital: string | null;
+    } | null;
+    ingreso: {
+        folio: string | null;
+        remitente: string | null;
+        folioDeOrigen: string | null;
+    } | null;
+    anexos: {
+        nombre: string;
+        enlace: string | null;
+        archivo: string | null;
+    }[];
+    trazabilidad: {
+        accion: string;
+        quien: string | null;
+        cuando: string;
+        observacion: string | null;
+        sha256: string | null;
+    }[];
+    /** Ruta del PDF vigente (firmado) dentro del ZIP. */
+    archivo: string;
+}
+export interface RepositoryExportSummaryEntity {
+    /** Órgano que exporta (`ORGAN_NAME`). */
+    organ: string;
+    from: string | null;
+    to: string | null;
+    scope: RepositoryExportScope;
+    documents: number;
+    caseFiles: number;
+    /** Catálogos completos: tipos documentales, series, procedimientos, entidades emisoras y feriados. */
+    catalogs: Record<string, unknown[]>;
+}
+export interface RepositoryExportDocumentsPageEntity {
+    items: {
+        record: RepositoryDocumentRecord;
+        files: RepositoryExportFile[];
+    }[];
+    nextCursor: string | null;
+}
+export interface RepositoryExportCaseFilesPageEntity {
+    items: CaseFileExportResponseEntity[];
+    nextCursor: string | null;
+}
+export interface RepositoryExportRecordResponseEntity {
+    ok: boolean;
+}

package/dist/entities/repositoryExport/repositoryExport.entity.js

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

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

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

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

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

@@ -0,0 +1,49 @@
+import { type DispositionKind, type FinalDisposition } from '../../base/entities';
+/** Una serie con su Tabla de Retención y cuánto venció. */
+export interface RetentionSeriesEntity {
+    seriesId: string;
+    code: string;
+    name: string;
+    section: string | null;
+    managementYears: number;
+    centralYears: number;
+    finalDisposition: FinalDisposition;
+    retentionNote: string | null;
+    /** Documentos firmados y expedientes cerrados cuyo plazo terminó y aún no tienen acta. */
+    documentsDue: number;
+    caseFilesDue: number;
+    /** Actas ya emitidas de la serie. */
+    dispositions: number;
+}
+export interface RetentionSummaryEntity {
+    series: RetentionSeriesEntity[];
+    /** Series habilitadas sin plazos: sus documentos no vencen. */
+    seriesWithoutRetention: number;
+}
+/** Un documento o expediente cuyo plazo de retención terminó. */
+export interface RetentionDueItemEntity {
+    kind: 'Document' | 'CaseFile';
+    id: string;
+    /** Folio del documento o IUIe del expediente. */
+    reference: string;
+    title: string;
+    /** Desde cuándo se cuenta: la última firma del documento o el cierre del expediente. */
+    baseDate: string;
+    dueAt: string;
+}
+export interface DispositionRecordResponseEntity {
+    id: string;
+    kind: DispositionKind;
+    number: number;
+    year: number;
+    /** «Acta de transferencia N° 1/2026». */
+    label: string;
+    seriesId: string;
+    seriesCode: string;
+    seriesName: string;
+    observation: string | null;
+    documents: number;
+    caseFiles: number;
+    createdByFullName: string;
+    createdAt: string;
+}

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

package/src/base/entities.ts

@@ -65,7 +65,8 @@ export type DocumentTrackingAction =
   | 'DispatchReturned'
   | 'Received'
   | 'EmailCopySent'
-  | 'EmailCopyOpened';
+  | 'EmailCopyOpened'
+  | 'DispositionRecorded';
 
 export const DocumentTrackingAction = {
   Created: 'Created',
@@ -87,6 +88,7 @@ export const DocumentTrackingAction = {
   Received: 'Received',
   EmailCopySent: 'EmailCopySent',
   EmailCopyOpened: 'EmailCopyOpened',
+  DispositionRecorded: 'DispositionRecorded',
 } satisfies Record<string, DocumentTrackingAction>;
 
 export type DocumentOrigin = 'Internal' | 'DocDigital';
@@ -228,7 +230,8 @@ export type CaseFileTrackingAction =
   | 'Closed'
   | 'Exported'
   | 'ShareLinkCreated'
-  | 'ShareLinkRevoked';
+  | 'ShareLinkRevoked'
+  | 'DispositionRecorded';
 
 export const CaseFileTrackingAction = {
   Created: 'Created',
@@ -242,6 +245,7 @@ export const CaseFileTrackingAction = {
   Exported: 'Exported',
   ShareLinkCreated: 'ShareLinkCreated',
   ShareLinkRevoked: 'ShareLinkRevoked',
+  DispositionRecorded: 'DispositionRecorded',
 } satisfies Record<string, CaseFileTrackingAction>;
 
 export type CaseFileAccessAction = 'Viewed' | 'FileDownloaded' | 'Exported';
@@ -318,7 +322,8 @@ export type AuditEntity =
   | 'Holiday'
   | 'Procedure'
   | 'QualityMetric'
-  | 'ServiceOutage';
+  | 'ServiceOutage'
+  | 'Repository';
 
 export const AuditEntity = {
   DocumentType: 'DocumentType',
@@ -329,9 +334,10 @@ export const AuditEntity = {
   Procedure: 'Procedure',
   QualityMetric: 'QualityMetric',
   ServiceOutage: 'ServiceOutage',
+  Repository: 'Repository',
 } satisfies Record<string, AuditEntity>;
 
-export type AuditAction = 'Created' | 'Updated' | 'Enabled' | 'Disabled' | 'Removed';
+export type AuditAction = 'Created' | 'Updated' | 'Enabled' | 'Disabled' | 'Removed' | 'Exported';
 
 export const AuditAction = {
   Created: 'Created',
@@ -339,8 +345,24 @@ export const AuditAction = {
   Enabled: 'Enabled',
   Disabled: 'Disabled',
   Removed: 'Removed',
+  Exported: 'Exported',
 } satisfies Record<string, AuditAction>;
 
+export type FinalDisposition = 'Permanent' | 'Eliminate' | 'Select';
+
+export const FinalDisposition = {
+  Permanent: 'Permanent',
+  Eliminate: 'Eliminate',
+  Select: 'Select',
+} satisfies Record<string, FinalDisposition>;
+
+export type DispositionKind = 'Transfer' | 'Elimination';
+
+export const DispositionKind = {
+  Transfer: 'Transfer',
+  Elimination: 'Elimination',
+} satisfies Record<string, DispositionKind>;
+
 export interface DocumentTypeEntity {
   id: string;
   name: string;
@@ -422,6 +444,8 @@ export interface DocumentEntity {
   externalRecipients?: DocumentExternalRecipientEntity[];
   emailCopies?: DocumentEmailCopyEntity[];
   accesses?: DocumentAccessEntity[];
+  disposition?: DispositionRecordEntity | null;
+  dispositionId?: string | null;
   dispatch?: DocumentDispatchEntity | null;
   docDigitalInbound?: DocDigitalInboundEntity | null;
   deleted: boolean;
@@ -589,6 +613,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;
@@ -841,9 +867,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;
@@ -968,4 +999,19 @@ export interface AuditLogEntity {
   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;
+}
+
 type JsonValue = string | number | boolean | { [key in string]?: JsonValue } | Array<JsonValue> | null;

package/src/contracts/archivalSeries.contract.ts

@@ -1,3 +1,4 @@
+import { type FinalDisposition } from '../base/entities';
 import { type ArchivalSeriesEntity } from '../base/entities';
 import {
   type ArchivalSeriesCreateResponseEntity,
@@ -23,6 +24,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 {

package/src/contracts/index.ts

@@ -8,6 +8,8 @@ import { HolidayPatterns, type HolidayContract } from './holiday.contract';
 import { IndicatorsPatterns, type IndicatorsContract } from './indicators.contract';
 import { AuditPatterns, type AuditContract } from './audit.contract';
 import { SignatureCheckPatterns, type SignatureCheckContract } from './signatureCheck.contract';
+import { RepositoryExportPatterns, type RepositoryExportContract } from './repositoryExport.contract';
+import { RetentionPatterns, type RetentionContract } from './retention.contract';
 import { ScanPatterns, type ScanContract } from './scan.contract';
 import { PartsOfficePatterns, type PartsOfficeContract } from './partsOffice.contract';
 import { ProcedurePatterns, type ProcedureContract } from './procedure.contract';
@@ -32,6 +34,8 @@ export * from './holiday.contract';
 export * from './indicators.contract';
 export * from './audit.contract';
 export * from './signatureCheck.contract';
+export * from './repositoryExport.contract';
+export * from './retention.contract';
 
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export const GestorDocumentalPatterns = {
@@ -51,6 +55,8 @@ export const GestorDocumentalPatterns = {
   indicators: IndicatorsPatterns,
   audit: AuditPatterns,
   signatureCheck: SignatureCheckPatterns,
+  repositoryExport: RepositoryExportPatterns,
+  retention: RetentionPatterns,
 } as const;
 
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
@@ -69,4 +75,6 @@ export type GestorDocumentalContract = DocumentTypeContract &
   HolidayContract &
   IndicatorsContract &
   AuditContract &
-  SignatureCheckContract;
+  SignatureCheckContract &
+  RepositoryExportContract &
+  RetentionContract;

package/src/contracts/repositoryExport.contract.ts

@@ -0,0 +1,54 @@
+import {
+  type RepositoryExportCaseFilesPageEntity,
+  type RepositoryExportRecordResponseEntity,
+  type RepositoryExportDocumentsPageEntity,
+  type RepositoryExportScope,
+  type RepositoryExportSummaryEntity,
+} from '../entities';
+
+/**
+ * Patrones NATS de `repositoryExport`: exportación completa del repositorio (portabilidad). El ms entrega los datos
+ * por páginas, porque un mensaje NATS no admite más de 1 MB; el gateway arma el ZIP con ellos y los archivos.
+ */
+export const RepositoryExportPatterns = {
+  getSummary: 'gestorDocumental.repositoryExport.getSummary',
+  getDocuments: 'gestorDocumental.repositoryExport.getDocuments',
+  getCaseFiles: 'gestorDocumental.repositoryExport.getCaseFiles',
+  record: 'gestorDocumental.repositoryExport.record',
+} as const;
+
+/** Período por fecha de creación (días de Chile «AAAA-MM-DD»); sin él, todo. */
+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]: { payload: RepositoryExportQuery; response: RepositoryExportSummaryEntity };
+  /** Hasta 50 documentos por página, en orden de creación. */
+  [RepositoryExportPatterns.getDocuments]: {
+    payload: RepositoryExportQuery & { cursor?: string | null; limit?: number };
+    response: RepositoryExportDocumentsPageEntity;
+  };
+  /** Hasta 10 expedientes por página; cada uno queda con «Exportó» en su trazabilidad, a nombre de quien exporta. */
+  [RepositoryExportPatterns.getCaseFiles]: {
+    payload: Omit<RepositoryExportQuery, 'scope'> & {
+      cursor?: string | null;
+      limit?: number;
+      actor: { employeeId: string | null; fullName: string };
+    };
+    response: RepositoryExportCaseFilesPageEntity;
+  };
+  /** Deja la exportación en la bitácora: quién, qué período y si llevó archivos. */
+  [RepositoryExportPatterns.record]: {
+    payload: RepositoryExportQuery & {
+      includeFiles: boolean;
+      complete: boolean;
+      actor: { employeeId: string | null; fullName: string };
+    };
+    response: RepositoryExportRecordResponseEntity;
+  };
+}

package/src/contracts/retention.contract.ts

@@ -0,0 +1,44 @@
+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 const RetentionPatterns = {
+  getSummary: 'gestorDocumental.retention.getSummary',
+  getDueItems: 'gestorDocumental.retention.getDueItems',
+  createRecord: 'gestorDocumental.retention.createRecord',
+  getRecords: 'gestorDocumental.retention.getRecords',
+  getRecordPdf: 'gestorDocumental.retention.getRecordPdf',
+} as const;
+
+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/src/entities/archivalSeries/archivalSeries.entity.ts

@@ -7,6 +7,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;

package/src/entities/index.ts

@@ -14,3 +14,5 @@ export * from './holiday';
 export * from './indicators';
 export * from './audit';
 export * from './signatureCheck';
+export * from './repositoryExport';
+export * from './retention';

package/src/entities/repositoryExport/index.ts

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

package/src/entities/repositoryExport/repositoryExport.entity.ts

@@ -0,0 +1,86 @@
+import { type CaseFileExportResponseEntity } from '../caseFile';
+
+/** Qué documentos: los oficiales (finalizados y anulados) o todos, también borradores y en tramitación. */
+export type RepositoryExportScope = 'official' | 'all';
+
+/** Un archivo que el gateway descarga y pone en el ZIP, en la ruta indicada. */
+export interface RepositoryExportFile {
+  fileId: string;
+  path: string;
+  kind: 'document' | 'attachment';
+}
+
+/** Un documento con todos sus datos, como va en `documentos/*.jsonl`. Claves en castellano, como `expediente.json`. */
+export interface RepositoryDocumentRecord {
+  id: string;
+  tipo: { nombre: string; sigla: string | null; serie: { codigo: string; nombre: string } | null };
+  entidadEmisora: string;
+  folio: string | null;
+  numero: number | null;
+  anio: number | null;
+  materia: string;
+  palabrasClave: string[];
+  nivelAcceso: string;
+  datosSensibles: boolean;
+  finRestriccion: string | null;
+  estado: string;
+  origen: string;
+  codigoVerificacion: string | null;
+  redactor: { id: string; nombre: string };
+  unidadEmisora: { codigoDireccion: number | null; departamentoId: string | null };
+  creado: string;
+  enviado: string | null;
+  finalizado: string | null;
+  anulacion: { fecha: string; motivo: string | null } | null;
+  numerosAnulados: { numero: number; anio: number; motivo: string; registradoPor: string; fecha: string }[];
+  participantes: {
+    rol: string;
+    orden: number;
+    etapa: number;
+    nombre: string;
+    cargo: string | null;
+    estado: string;
+    resueltoEl: string | null;
+    observacion: string | null;
+  }[];
+  destinatarios: { tipo: string; nombre: string; cargo: string | null }[];
+  destinatariosExternos: { entidad: string; usuario: string | null }[];
+  despacho: { estado: string; folio: string | null; despachadoEl: string | null; idDocDigital: string | null } | null;
+  ingreso: { folio: string | null; remitente: string | null; folioDeOrigen: string | null } | null;
+  anexos: { nombre: string; enlace: string | null; archivo: string | null }[];
+  trazabilidad: {
+    accion: string;
+    quien: string | null;
+    cuando: string;
+    observacion: string | null;
+    sha256: string | null;
+  }[];
+  /** Ruta del PDF vigente (firmado) dentro del ZIP. */
+  archivo: string;
+}
+
+export interface RepositoryExportSummaryEntity {
+  /** Órgano que exporta (`ORGAN_NAME`). */
+  organ: string;
+  from: string | null;
+  to: string | null;
+  scope: RepositoryExportScope;
+  documents: number;
+  caseFiles: number;
+  /** Catálogos completos: tipos documentales, series, procedimientos, entidades emisoras y feriados. */
+  catalogs: Record<string, unknown[]>;
+}
+
+export interface RepositoryExportDocumentsPageEntity {
+  items: { record: RepositoryDocumentRecord; files: RepositoryExportFile[] }[];
+  nextCursor: string | null;
+}
+
+export interface RepositoryExportCaseFilesPageEntity {
+  items: CaseFileExportResponseEntity[];
+  nextCursor: string | null;
+}
+
+export interface RepositoryExportRecordResponseEntity {
+  ok: boolean;
+}

package/src/entities/retention/index.ts

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

package/src/entities/retention/retention.entity.ts

@@ -0,0 +1,53 @@
+import { type DispositionKind, type FinalDisposition } from '../../base/entities';
+
+/** Una serie con su Tabla de Retención y cuánto venció. */
+export interface RetentionSeriesEntity {
+  seriesId: string;
+  code: string;
+  name: string;
+  section: string | null;
+  managementYears: number;
+  centralYears: number;
+  finalDisposition: FinalDisposition;
+  retentionNote: string | null;
+  /** Documentos firmados y expedientes cerrados cuyo plazo terminó y aún no tienen acta. */
+  documentsDue: number;
+  caseFilesDue: number;
+  /** Actas ya emitidas de la serie. */
+  dispositions: number;
+}
+
+export interface RetentionSummaryEntity {
+  series: RetentionSeriesEntity[];
+  /** Series habilitadas sin plazos: sus documentos no vencen. */
+  seriesWithoutRetention: number;
+}
+
+/** Un documento o expediente cuyo plazo de retención terminó. */
+export interface RetentionDueItemEntity {
+  kind: 'Document' | 'CaseFile';
+  id: string;
+  /** Folio del documento o IUIe del expediente. */
+  reference: string;
+  title: string;
+  /** Desde cuándo se cuenta: la última firma del documento o el cierre del expediente. */
+  baseDate: string;
+  dueAt: string;
+}
+
+export interface DispositionRecordResponseEntity {
+  id: string;
+  kind: DispositionKind;
+  number: number;
+  year: number;
+  /** «Acta de transferencia N° 1/2026». */
+  label: string;
+  seriesId: string;
+  seriesCode: string;
+  seriesName: string;
+  observation: string | null;
+  documents: number;
+  caseFiles: number;
+  createdByFullName: string;
+  createdAt: string;
+}