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

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' | 'DispositionRecorded';
+export type DocumentTrackingAction = 'Created' | 'Updated' | 'Submitted' | 'Visaed' | 'Signed' | 'Rejected' | 'Finished' | 'Discarded' | 'Numbered' | 'NumberAnnulled' | 'Annulled' | 'Delivered' | 'Derived' | 'Reassigned' | 'Dispatched' | 'DispatchReturned' | 'DispatchedByContingency' | 'Received' | 'EmailCopySent' | 'EmailCopyOpened' | 'DispositionRecorded' | 'TransparencyRedacted' | 'TransparencyPublished' | 'TransparencyExcluded' | 'TransparencyWithdrawn';
 export declare const DocumentTrackingAction: {
     Created: "Created";
     Updated: "Updated";
@@ -51,15 +51,28 @@ export declare const 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";
 };
-export type DocumentOrigin = 'Internal' | 'DocDigital';
+export type DocumentOrigin = 'Internal' | 'DocDigital' | 'Manual';
 export declare const DocumentOrigin: {
     Internal: "Internal";
     DocDigital: "DocDigital";
+    Manual: "Manual";
+};
+export type CommunicationMeans = 'Paper' | 'Email' | 'Courier' | 'Other';
+export declare const CommunicationMeans: {
+    Paper: "Paper";
+    Email: "Email";
+    Courier: "Courier";
+    Other: "Other";
 };
 export type DocumentDispatchStatus = 'Pending' | 'Dispatched' | 'Returned';
 export declare const DocumentDispatchStatus: {
@@ -275,6 +288,11 @@ export declare const AccessRequestEventAction: {
     Resolved: "Resolved";
     AppealRegistered: "AppealRegistered";
 };
+export type TransparencyStatus = 'Published' | 'Excluded';
+export declare const TransparencyStatus: {
+    Published: "Published";
+    Excluded: "Excluded";
+};
 export interface DocumentTypeEntity {
     id: string;
     name: string;
@@ -285,6 +303,8 @@ export interface DocumentTypeEntity {
     correlativeYear?: number | null;
     resetsYearly: boolean;
     numbered: boolean;
+    activeTransparency: boolean;
+    transparencySection?: string | null;
     directorateCodeReference?: number | null;
     archivalSeries?: ArchivalSeriesEntity | null;
     archivalSeriesId?: string | null;
@@ -324,6 +344,7 @@ export interface DocumentEntity {
     externalFolio?: string | null;
     externalSender?: string | null;
     externalDate?: string | null;
+    intakeMeans?: CommunicationMeans | null;
     composition?: JsonValue | null;
     contentText?: string | null;
     textExtractedAt?: string | null;
@@ -357,6 +378,13 @@ export interface DocumentEntity {
     accesses?: DocumentAccessEntity[];
     disposition?: DispositionRecordEntity | null;
     dispositionId?: string | null;
+    transparencyStatus?: TransparencyStatus | null;
+    transparencyUrl?: string | null;
+    transparencyNote?: string | null;
+    transparencyAt?: string | null;
+    transparencyByFullName?: string | null;
+    redactedFileId?: string | null;
+    redactedFileName?: string | null;
     accessRequestResponses?: AccessRequestEntity[];
     accessRequestDeliveries?: AccessRequestDocumentEntity[];
     dispatch?: DocumentDispatchEntity | null;
@@ -691,6 +719,11 @@ export interface DocumentDispatchEntity {
     returnedByEmployeeId?: string | null;
     returnedByFullName?: string | null;
     returnReason?: string | null;
+    contingencyMeans?: CommunicationMeans | null;
+    contingencySentTo?: string | null;
+    contingencyReason?: string | null;
+    contingencyReceiptFileId?: string | null;
+    contingencyReceiptName?: string | null;
     document?: DocumentEntity;
     documentId: string;
     createdAt: string;

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.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.TransparencyStatus = exports.AccessRequestEventAction = exports.AccessRequestResolution = exports.AccessRequestStatus = exports.AccessRequestChannel = exports.DispositionKind = exports.FinalDisposition = exports.AuditAction = exports.AuditEntity = exports.DocumentAccessAction = exports.QualityMetricKey = exports.ServiceOutageKind = exports.WorkFolderItemKind = exports.TextSnippetSection = exports.ScanSessionStatus = exports.CaseFileAccessAction = exports.CaseFileTrackingAction = exports.CaseFileActorType = exports.CaseFileActorRelation = exports.CaseFileEntryKind = exports.CaseFileActuationType = exports.CaseFileIncorporationMechanism = exports.CaseFileStatus = exports.DocumentInstruction = exports.DocumentDeliveryOrigin = exports.DocumentRecipientType = exports.DocumentAttachmentType = exports.DocumentFlowStepType = exports.DocDigitalInboundStatus = exports.DocumentDispatchStatus = exports.CommunicationMeans = exports.DocumentOrigin = exports.DocumentTrackingAction = exports.DocumentParticipantStatus = exports.DocumentParticipantRole = exports.DocumentAccessLevel = exports.DocumentStatus = exports.DocumentCategory = void 0;
 exports.DocumentCategory = {
     Decree: 'Decree',
     Communication: 'Communication',
@@ -49,14 +49,26 @@ 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',
 };
 exports.DocumentOrigin = {
     Internal: 'Internal',
     DocDigital: 'DocDigital',
+    Manual: 'Manual',
+};
+exports.CommunicationMeans = {
+    Paper: 'Paper',
+    Email: 'Email',
+    Courier: 'Courier',
+    Other: 'Other',
 };
 exports.DocumentDispatchStatus = {
     Pending: 'Pending',
@@ -243,3 +255,7 @@ exports.AccessRequestEventAction = {
     Resolved: 'Resolved',
     AppealRegistered: 'AppealRegistered',
 };
+exports.TransparencyStatus = {
+    Published: 'Published',
+    Excluded: 'Excluded',
+};

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

@@ -35,6 +35,9 @@ export interface DocumentTypeWritePayload {
     nextCorrelative?: number;
     resetsYearly?: boolean;
     numbered?: boolean;
+    /** Transparencia Activa: sus documentos se publican cada mes, en esta sección del Portal. */
+    activeTransparency?: boolean;
+    transparencySection?: string | null;
     directorateCodeReference?: number | null;
     archivalSeriesId?: string | null;
     issuingEntityId?: string | null;

package/dist/contracts/index.d.ts

@@ -11,6 +11,7 @@ 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 TransparencyContract } from './transparency.contract';
 import { type ScanContract } from './scan.contract';
 import { type PartsOfficeContract } from './partsOffice.contract';
 import { type ProcedureContract } from './procedure.contract';
@@ -37,6 +38,7 @@ export * from './signatureCheck.contract';
 export * from './repositoryExport.contract';
 export * from './retention.contract';
 export * from './accessRequest.contract';
+export * from './transparency.contract';
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export declare const GestorDocumentalPatterns: {
     readonly documentType: {
@@ -126,6 +128,8 @@ export declare const GestorDocumentalPatterns: {
         readonly returnInbound: "gestorDocumental.partsOffice.returnInbound";
         readonly getInboundFile: "gestorDocumental.partsOffice.getInboundFile";
         readonly checkEnablement: "gestorDocumental.partsOffice.checkEnablement";
+        readonly dispatchByContingency: "gestorDocumental.partsOffice.dispatchByContingency";
+        readonly registerManualIntake: "gestorDocumental.partsOffice.registerManualIntake";
     };
     readonly registerBook: {
         readonly get: "gestorDocumental.registerBook.get";
@@ -217,6 +221,14 @@ export declare const GestorDocumentalPatterns: {
         readonly update: "gestorDocumental.accessRequest.update";
         readonly act: "gestorDocumental.accessRequest.act";
     };
+    readonly transparency: {
+        readonly getMonth: "gestorDocumental.transparency.getMonth";
+        readonly update: "gestorDocumental.transparency.update";
+        readonly export: "gestorDocumental.transparency.export";
+        readonly getRedactedFile: "gestorDocumental.transparency.getRedactedFile";
+        readonly getPublic: "gestorDocumental.transparency.getPublic";
+        readonly getPublicFile: "gestorDocumental.transparency.getPublicFile";
+    };
 };
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
-export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & IssuingEntityContract & CaseFileContract & PartsOfficeContract & RegisterBookContract & SignatureBatchContract & WorkFolderContract & ScanContract & ArchivalSeriesContract & TextSnippetContract & HolidayContract & IndicatorsContract & AuditContract & SignatureCheckContract & RepositoryExportContract & RetentionContract & AccessRequestContract;
+export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & IssuingEntityContract & CaseFileContract & PartsOfficeContract & RegisterBookContract & SignatureBatchContract & WorkFolderContract & ScanContract & ArchivalSeriesContract & TextSnippetContract & HolidayContract & IndicatorsContract & AuditContract & SignatureCheckContract & RepositoryExportContract & RetentionContract & AccessRequestContract & TransparencyContract;

package/dist/contracts/index.js

@@ -28,6 +28,7 @@ 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 transparency_contract_1 = require("./transparency.contract");
 const scan_contract_1 = require("./scan.contract");
 const partsOffice_contract_1 = require("./partsOffice.contract");
 const procedure_contract_1 = require("./procedure.contract");
@@ -54,6 +55,7 @@ __exportStar(require("./signatureCheck.contract"), exports);
 __exportStar(require("./repositoryExport.contract"), exports);
 __exportStar(require("./retention.contract"), exports);
 __exportStar(require("./accessRequest.contract"), exports);
+__exportStar(require("./transparency.contract"), exports);
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 exports.GestorDocumentalPatterns = {
     documentType: documentType_contract_1.DocumentTypePatterns,
@@ -75,4 +77,5 @@ exports.GestorDocumentalPatterns = {
     repositoryExport: repositoryExport_contract_1.RepositoryExportPatterns,
     retention: retention_contract_1.RetentionPatterns,
     accessRequest: accessRequest_contract_1.AccessRequestPatterns,
+    transparency: transparency_contract_1.TransparencyPatterns,
 };

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

@@ -1,4 +1,4 @@
-import { type DocumentAccessLevel, type DocumentInstruction } from '../base/entities';
+import { type CommunicationMeans, type DocumentAccessLevel, type DocumentInstruction } from '../base/entities';
 import { type DocDigitalDocumentTypeEntity, type DocDigitalEntityEntity, type PartsOfficeInboundEntity, type DocDigitalUserEntity, type EnablementPersonInput, type PartsOfficeEnablementEntity, type PartsOfficeDispatchEntity, type PartsOfficeFileEntity, type PartsOfficeOkResponseEntity, type PartsOfficeRegisterResponseEntity, type PartsOfficeStatusEntity, type PartsOfficeSummaryEntity, type PartsOfficeSyncResponseEntity } from '../entities';
 import { type RpcPage } from './contract';
 import { type DocumentActor, type DocumentExternalRecipientInput } from './document.contract';
@@ -22,6 +22,8 @@ export declare const PartsOfficePatterns: {
     readonly returnInbound: "gestorDocumental.partsOffice.returnInbound";
     readonly getInboundFile: "gestorDocumental.partsOffice.getInboundFile";
     readonly checkEnablement: "gestorDocumental.partsOffice.checkEnablement";
+    readonly dispatchByContingency: "gestorDocumental.partsOffice.dispatchByContingency";
+    readonly registerManualIntake: "gestorDocumental.partsOffice.registerManualIntake";
 };
 /** Destinatario interno de un ingreso, ya resuelto por el gateway (las áreas con sus integrantes). */
 export type PartsOfficeRecipientInput = {
@@ -48,6 +50,35 @@ interface IListPayload<S> {
         status?: S;
     };
 }
+/** Lo que llegó fuera de DocDigital y Oficina de Partes ingresa a mano. */
+export interface ManualIntakePayload {
+    file: {
+        fileId: string;
+        name: string;
+    };
+    attachments?: {
+        fileId: string;
+        name: string;
+    }[];
+    means: CommunicationMeans;
+    /** Cuándo llegó (ISO); sin él, ahora. */
+    receivedAt?: string | null;
+    senderEntityName: string;
+    senderName?: string | null;
+    externalFolio?: string | null;
+    externalDate?: string | null;
+    subject: string;
+    documentTypeId: string;
+    keywords: string[];
+    accessLevel?: DocumentAccessLevel;
+    hasSensitiveData?: boolean;
+    recipients: unknown[];
+    instruction: DocumentInstruction;
+    note?: string | null;
+    dueAt?: string | null;
+    dueBusinessDays?: number | null;
+    actor: DocumentActor;
+}
 export interface PartsOfficeContract {
     [PartsOfficePatterns.getStatus]: {
         payload: Record<string, never>;
@@ -118,6 +149,7 @@ export interface PartsOfficeContract {
     [PartsOfficePatterns.getDispatchFile]: {
         payload: {
             id: string;
+            receipt?: boolean;
         };
         response: PartsOfficeFileEntity;
     };
@@ -184,5 +216,33 @@ export interface PartsOfficeContract {
         };
         response: PartsOfficeEnablementEntity;
     };
+    /**
+     * Registro por contingencia: el documento no se pudo despachar por DocDigital y salió por otro medio. Queda
+     * despachado, con el medio, a quién, el motivo y el comprobante; si después se registra en DocDigital, su número.
+     */
+    [PartsOfficePatterns.dispatchByContingency]: {
+        payload: {
+            id: string;
+            means: CommunicationMeans;
+            sentAt: string;
+            sentTo: string;
+            reason: string;
+            receipt?: {
+                fileId: string;
+                name: string;
+            } | null;
+            docDigitalDocumentId?: string | null;
+            actor: DocumentActor;
+        };
+        response: PartsOfficeOkResponseEntity;
+    };
+    /**
+     * Ingreso manual: lo que llegó fuera de DocDigital (papel, correo) entra con folio de ingreso, como lo recibido
+     * por DocDigital, y se deriva.
+     */
+    [PartsOfficePatterns.registerManualIntake]: {
+        payload: ManualIntakePayload;
+        response: PartsOfficeRegisterResponseEntity;
+    };
 }
 export {};

package/dist/contracts/partsOffice.contract.js

@@ -21,4 +21,6 @@ exports.PartsOfficePatterns = {
     returnInbound: 'gestorDocumental.partsOffice.returnInbound',
     getInboundFile: 'gestorDocumental.partsOffice.getInboundFile',
     checkEnablement: 'gestorDocumental.partsOffice.checkEnablement',
+    dispatchByContingency: 'gestorDocumental.partsOffice.dispatchByContingency',
+    registerManualIntake: 'gestorDocumental.partsOffice.registerManualIntake',
 };

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

@@ -0,0 +1,96 @@
+import { type DocumentPublicFileResponseEntity, type IndicatorsFileEntity, type TransparencyItemEntity, type TransparencyItemStatus, type TransparencyMonthEntity, type TransparencyPublicEntity } from '../entities';
+/** Patrones NATS de `transparency`: Transparencia Activa de los documentos firmados (Ley 20.285, art. 7°). */
+export declare const TransparencyPatterns: {
+    readonly getMonth: "gestorDocumental.transparency.getMonth";
+    readonly update: "gestorDocumental.transparency.update";
+    readonly export: "gestorDocumental.transparency.export";
+    readonly getRedactedFile: "gestorDocumental.transparency.getRedactedFile";
+    readonly getPublic: "gestorDocumental.transparency.getPublic";
+    readonly getPublicFile: "gestorDocumental.transparency.getPublicFile";
+};
+type TTransparencyActor = {
+    employeeId: string;
+    fullName: string;
+};
+/** Lo que se decide sobre un documento en Transparencia Activa. */
+export type TransparencyUpdatePayload = 
+/** Publicarlo (o corregir el enlace): si el original no es público, exige antes la versión tarjada. */
+{
+    action: 'publish';
+    documentId: string;
+    url?: string | null;
+    note?: string | null;
+    actor: TTransparencyActor;
+}
+/** No se publica, con su motivo (p. ej. reservado por el art. 21 de la Ley 20.285). */
+ | {
+    action: 'exclude';
+    documentId: string;
+    reason: string;
+    actor: TTransparencyActor;
+}
+/** Vuelve a pendiente: se retiró la publicación o se revisó la exclusión. */
+ | {
+    action: 'withdraw';
+    documentId: string;
+    reason: string;
+    actor: TTransparencyActor;
+}
+/** Versión tarjada ya subida al gestor de archivos (PDF). */
+ | {
+    action: 'setRedacted';
+    documentId: string;
+    fileId: string;
+    fileName: string;
+    actor: TTransparencyActor;
+} | {
+    action: 'removeRedacted';
+    documentId: string;
+    actor: TTransparencyActor;
+};
+export interface TransparencyContract {
+    /** Lo firmado en el mes (hora de Chile) de los tipos que se publican, y lo que ya se publicó aunque el tipo cambie. */
+    [TransparencyPatterns.getMonth]: {
+        payload: {
+            year: number;
+            month: number;
+            status?: TransparencyItemStatus | null;
+        };
+        response: TransparencyMonthEntity;
+    };
+    [TransparencyPatterns.update]: {
+        payload: TransparencyUpdatePayload;
+        response: TransparencyItemEntity;
+    };
+    /** Planilla del mes (Excel) para cargar en el Portal de Transparencia. */
+    [TransparencyPatterns.export]: {
+        payload: {
+            year: number;
+            month: number;
+            generatedBy: string;
+        };
+        response: IndicatorsFileEntity;
+    };
+    /** La versión tarjada cargada, para revisarla antes de publicar. */
+    [TransparencyPatterns.getRedactedFile]: {
+        payload: {
+            documentId: string;
+        };
+        response: DocumentPublicFileResponseEntity;
+    };
+    /** Página pública de un documento publicado, por su código de verificación. No exige sesión. */
+    [TransparencyPatterns.getPublic]: {
+        payload: {
+            code: string;
+        };
+        response: TransparencyPublicEntity;
+    };
+    /** La versión publicada: la tarjada si existe; si no, el original público. Solo de un documento vigente. */
+    [TransparencyPatterns.getPublicFile]: {
+        payload: {
+            code: string;
+        };
+        response: DocumentPublicFileResponseEntity;
+    };
+}
+export {};

package/dist/contracts/transparency.contract.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransparencyPatterns = void 0;
+/** Patrones NATS de `transparency`: Transparencia Activa de los documentos firmados (Ley 20.285, art. 7°). */
+exports.TransparencyPatterns = {
+    getMonth: 'gestorDocumental.transparency.getMonth',
+    update: 'gestorDocumental.transparency.update',
+    export: 'gestorDocumental.transparency.export',
+    getRedactedFile: 'gestorDocumental.transparency.getRedactedFile',
+    getPublic: 'gestorDocumental.transparency.getPublic',
+    getPublicFile: 'gestorDocumental.transparency.getPublicFile',
+};

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

@@ -1,4 +1,4 @@
-import { DocumentAnnulledNumberEntity, DocumentAttachmentEntity, DocumentDeliveryEntity, DocumentEntity, DocumentParticipantEntity, DocumentRecipientEntity, DocumentTrackingEntity, DocumentTypeEntity } from '../../base/entities';
+import { type CommunicationMeans, DocumentAnnulledNumberEntity, DocumentAttachmentEntity, DocumentDeliveryEntity, DocumentEntity, DocumentParticipantEntity, DocumentRecipientEntity, DocumentTrackingEntity, DocumentTypeEntity } from '../../base/entities';
 /** Tipo documental de un documento, con lo necesario para citarlo. */
 export interface DocumentTypeSummaryEntity {
     id: DocumentTypeEntity['id'];
@@ -82,6 +82,14 @@ export interface DocumentDispatchResponseEntity {
     returnedAt: string | null;
     returnedByFullName: string | null;
     returnReason: string | null;
+    /** Registro por contingencia: salió por otro medio porque no se pudo por DocDigital. */
+    contingency: {
+        means: CommunicationMeans;
+        sentTo: string | null;
+        reason: string | null;
+        /** Nombre del comprobante, si se adjuntó. */
+        receiptName: string | null;
+    } | null;
 }
 export interface DocumentGetAllResponseEntity {
     id: DocumentEntity['id'];

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

@@ -21,6 +21,9 @@ export interface DocumentTypeGetAllResponseEntity {
     correlativeYear: DocumentTypeEntity['correlativeYear'];
     resetsYearly: DocumentTypeEntity['resetsYearly'];
     numbered: DocumentTypeEntity['numbered'];
+    /** Transparencia Activa: sus documentos se publican cada mes, en esta sección del Portal. */
+    activeTransparency: DocumentTypeEntity['activeTransparency'];
+    transparencySection: DocumentTypeEntity['transparencySection'];
     directorateCodeReference: DocumentTypeEntity['directorateCodeReference'];
     archivalSeries: {
         id: string;

package/dist/entities/index.d.ts

@@ -17,3 +17,4 @@ export * from './signatureCheck';
 export * from './repositoryExport';
 export * from './retention';
 export * from './accessRequest';
+export * from './transparency';

package/dist/entities/index.js

@@ -33,3 +33,4 @@ __exportStar(require("./signatureCheck"), exports);
 __exportStar(require("./repositoryExport"), exports);
 __exportStar(require("./retention"), exports);
 __exportStar(require("./accessRequest"), exports);
+__exportStar(require("./transparency"), exports);

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

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

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

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

@@ -0,0 +1,74 @@
+import { type DocumentAccessLevel, type DocumentStatus } from '../../base/entities';
+/** En qué quedó un documento en Transparencia Activa: aún sin decidir, publicado o excluido con su motivo. */
+export type TransparencyItemStatus = 'Pending' | 'Published' | 'Excluded';
+/** Un documento que se publica en Transparencia Activa (Ley 20.285, art. 7°), con lo que se decidió de él. */
+export interface TransparencyItemEntity {
+    documentId: string;
+    documentStatus: DocumentStatus;
+    verificationCode: string | null;
+    documentTypeName: string;
+    documentTypeAbbreviation: string | null;
+    /** Sección del Portal en que se publica, según su tipo documental. */
+    section: string | null;
+    /** Folio del documento (`Decreto Alcaldicio N° 15/2026`), o el nombre del tipo si no lleva número. */
+    reference: string;
+    correlative: number | null;
+    correlativeYear: number | null;
+    subject: string;
+    finishedAt: string | null;
+    annulledAt: string | null;
+    accessLevel: DocumentAccessLevel;
+    hasSensitiveData: boolean;
+    /** El original se puede publicar tal cual: es público (o su restricción terminó) y no tiene datos sensibles. */
+    originalIsPublic: boolean;
+    /** Para publicarlo hace falta antes la versión tarjada. */
+    needsRedacted: boolean;
+    redactedFileName: string | null;
+    status: TransparencyItemStatus;
+    /** Dirección de la publicación en el Portal de Transparencia, si se anotó. */
+    transparencyUrl: string | null;
+    /** Motivo de la exclusión, u observación de la publicación. */
+    transparencyNote: string | null;
+    transparencyAt: string | null;
+    transparencyByFullName: string | null;
+    /** Enlace público estable a la versión que se publica (`<TRANSPARENCY_URL>/<código>`), si está configurado. */
+    publicLink: string | null;
+}
+export interface TransparencyMonthCountsEntity {
+    total: number;
+    pending: number;
+    published: number;
+    excluded: number;
+    /** Publicados que después se anularon: hay que retirarlos o actualizarlos en el Portal. */
+    annulledPublished: number;
+}
+/** Lo firmado en un mes de los tipos documentales que se publican, con lo que falta por decidir. */
+export interface TransparencyMonthEntity {
+    year: number;
+    month: number;
+    counts: TransparencyMonthCountsEntity;
+    /** Tipos documentales marcados para Transparencia Activa. Sin ninguno, la bandeja queda vacía. */
+    documentTypes: {
+        id: string;
+        name: string;
+        section: string | null;
+    }[];
+    items: TransparencyItemEntity[];
+}
+/** Lo que muestra la página pública de un documento publicado en Transparencia Activa. No exige sesión. */
+export interface TransparencyPublicEntity {
+    verificationCode: string;
+    documentTypeName: string;
+    issuerName: string;
+    section: string | null;
+    reference: string;
+    /** La materia solo se muestra si el original es público; si se publicó tarjado, se lee en el archivo. */
+    subject: string | null;
+    finishedAt: string | null;
+    /** Anulado después de publicarse: se informa y ya no se descarga. */
+    annulled: boolean;
+    /** Se publicó una versión tarjada (sin datos personales o reservados). */
+    redacted: boolean;
+    canDownload: boolean;
+    publishedAt: string | null;
+}

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

package/src/base/entities.ts

@@ -63,10 +63,15 @@ export type DocumentTrackingAction =
   | 'Reassigned'
   | 'Dispatched'
   | 'DispatchReturned'
+  | 'DispatchedByContingency'
   | 'Received'
   | 'EmailCopySent'
   | 'EmailCopyOpened'
-  | 'DispositionRecorded';
+  | 'DispositionRecorded'
+  | 'TransparencyRedacted'
+  | 'TransparencyPublished'
+  | 'TransparencyExcluded'
+  | 'TransparencyWithdrawn';
 
 export const DocumentTrackingAction = {
   Created: 'Created',
@@ -85,19 +90,34 @@ export const 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',
 } satisfies Record<string, DocumentTrackingAction>;
 
-export type DocumentOrigin = 'Internal' | 'DocDigital';
+export type DocumentOrigin = 'Internal' | 'DocDigital' | 'Manual';
 
 export const DocumentOrigin = {
   Internal: 'Internal',
   DocDigital: 'DocDigital',
+  Manual: 'Manual',
 } satisfies Record<string, DocumentOrigin>;
 
+export type CommunicationMeans = 'Paper' | 'Email' | 'Courier' | 'Other';
+
+export const CommunicationMeans = {
+  Paper: 'Paper',
+  Email: 'Email',
+  Courier: 'Courier',
+  Other: 'Other',
+} satisfies Record<string, CommunicationMeans>;
+
 export type DocumentDispatchStatus = 'Pending' | 'Dispatched' | 'Returned';
 
 export const DocumentDispatchStatus = {
@@ -323,7 +343,8 @@ export type AuditEntity =
   | 'Procedure'
   | 'QualityMetric'
   | 'ServiceOutage'
-  | 'Repository';
+  | 'Repository'
+  | 'DataTreatment';
 
 export const AuditEntity = {
   DocumentType: 'DocumentType',
@@ -335,6 +356,7 @@ export const AuditEntity = {
   QualityMetric: 'QualityMetric',
   ServiceOutage: 'ServiceOutage',
   Repository: 'Repository',
+  DataTreatment: 'DataTreatment',
 } satisfies Record<string, AuditEntity>;
 
 export type AuditAction = 'Created' | 'Updated' | 'Enabled' | 'Disabled' | 'Removed' | 'Exported';
@@ -418,6 +440,84 @@ export const AccessRequestEventAction = {
   AppealRegistered: 'AppealRegistered',
 } satisfies Record<string, AccessRequestEventAction>;
 
+export type TransparencyStatus = 'Published' | 'Excluded';
+
+export const TransparencyStatus = {
+  Published: 'Published',
+  Excluded: 'Excluded',
+} satisfies Record<string, TransparencyStatus>;
+
+export type DataLegalBasis = 'LegalFunction' | 'LegalObligation' | 'Consent' | 'Contract' | 'VitalInterest';
+
+export const DataLegalBasis = {
+  LegalFunction: 'LegalFunction',
+  LegalObligation: 'LegalObligation',
+  Consent: 'Consent',
+  Contract: 'Contract',
+  VitalInterest: 'VitalInterest',
+} satisfies Record<string, DataLegalBasis>;
+
+export type DataRight = 'Access' | 'Rectification' | 'Suppression' | 'Opposition' | 'Portability';
+
+export const DataRight = {
+  Access: 'Access',
+  Rectification: 'Rectification',
+  Suppression: 'Suppression',
+  Opposition: 'Opposition',
+  Portability: 'Portability',
+} satisfies Record<string, DataRight>;
+
+export type DataRightsChannel = 'Email' | 'WebForm' | 'InPerson' | 'Letter';
+
+export const DataRightsChannel = {
+  Email: 'Email',
+  WebForm: 'WebForm',
+  InPerson: 'InPerson',
+  Letter: 'Letter',
+} satisfies Record<string, DataRightsChannel>;
+
+export type DataRightsRequestStatus = 'Received' | 'InProgress' | 'Resolved';
+
+export const DataRightsRequestStatus = {
+  Received: 'Received',
+  InProgress: 'InProgress',
+  Resolved: 'Resolved',
+} satisfies Record<string, DataRightsRequestStatus>;
+
+export type DataRightsResolution = 'Granted' | 'PartiallyGranted' | 'Denied' | 'Withdrawn';
+
+export const DataRightsResolution = {
+  Granted: 'Granted',
+  PartiallyGranted: 'PartiallyGranted',
+  Denied: 'Denied',
+  Withdrawn: 'Withdrawn',
+} satisfies Record<string, DataRightsResolution>;
+
+export type DataRightsEventAction =
+  | 'Received'
+  | 'Updated'
+  | 'Acknowledged'
+  | 'IdentityVerified'
+  | 'Assigned'
+  | 'BlockingResolved'
+  | 'Extended'
+  | 'Resolved'
+  | 'ResponseSent'
+  | 'ComplaintRegistered';
+
+export const DataRightsEventAction = {
+  Received: 'Received',
+  Updated: 'Updated',
+  Acknowledged: 'Acknowledged',
+  IdentityVerified: 'IdentityVerified',
+  Assigned: 'Assigned',
+  BlockingResolved: 'BlockingResolved',
+  Extended: 'Extended',
+  Resolved: 'Resolved',
+  ResponseSent: 'ResponseSent',
+  ComplaintRegistered: 'ComplaintRegistered',
+} satisfies Record<string, DataRightsEventAction>;
+
 export interface DocumentTypeEntity {
   id: string;
   name: string;
@@ -428,6 +528,8 @@ export interface DocumentTypeEntity {
   correlativeYear?: number | null;
   resetsYearly: boolean;
   numbered: boolean;
+  activeTransparency: boolean;
+  transparencySection?: string | null;
   directorateCodeReference?: number | null;
   archivalSeries?: ArchivalSeriesEntity | null;
   archivalSeriesId?: string | null;
@@ -468,6 +570,7 @@ export interface DocumentEntity {
   externalFolio?: string | null;
   externalSender?: string | null;
   externalDate?: string | null;
+  intakeMeans?: CommunicationMeans | null;
   composition?: JsonValue | null;
   contentText?: string | null;
   textExtractedAt?: string | null;
@@ -501,7 +604,15 @@ export interface DocumentEntity {
   accesses?: DocumentAccessEntity[];
   disposition?: DispositionRecordEntity | null;
   dispositionId?: string | null;
+  transparencyStatus?: TransparencyStatus | null;
+  transparencyUrl?: string | null;
+  transparencyNote?: string | null;
+  transparencyAt?: string | null;
+  transparencyByFullName?: string | null;
+  redactedFileId?: string | null;
+  redactedFileName?: string | null;
   accessRequestResponses?: AccessRequestEntity[];
+  dataRightsResponses?: DataRightsRequestEntity[];
   accessRequestDeliveries?: AccessRequestDocumentEntity[];
   dispatch?: DocumentDispatchEntity | null;
   docDigitalInbound?: DocDigitalInboundEntity | null;
@@ -857,6 +968,11 @@ export interface DocumentDispatchEntity {
   returnedByEmployeeId?: string | null;
   returnedByFullName?: string | null;
   returnReason?: string | null;
+  contingencyMeans?: CommunicationMeans | null;
+  contingencySentTo?: string | null;
+  contingencyReason?: string | null;
+  contingencyReceiptFileId?: string | null;
+  contingencyReceiptName?: string | null;
   document?: DocumentEntity;
   documentId: string;
   createdAt: string;
@@ -1130,4 +1246,86 @@ export interface AccessRequestEventEntity {
   createdAt: string;
 }
 
+export interface DataTreatmentEntity {
+  id: string;
+  name: string;
+  purpose: string;
+  legalBasis: DataLegalBasis;
+  legalBasisDetail?: string | null;
+  dataCategories: string[];
+  sensitiveData: boolean;
+  dataSubjects: string;
+  recipients?: string | null;
+  source?: string | null;
+  retention?: string | null;
+  securityMeasures?: string | null;
+  internationalTransfer?: string | null;
+  responsibleUnit?: string | null;
+  published: boolean;
+  requests?: DataRightsRequestEntity[];
+  enabled: boolean;
+  deleted: boolean;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface DataRightsRequestEntity {
+  id: string;
+  number: number;
+  year: number;
+  channel: DataRightsChannel;
+  receivedAt: string;
+  rights: DataRight[];
+  requesterName: string;
+  requesterRut?: string | null;
+  requesterEmail?: string | null;
+  requesterAddress?: string | null;
+  representativeName?: string | null;
+  identityVerifiedAt?: string | null;
+  identityNote?: string | null;
+  requestText: string;
+  treatment?: DataTreatmentEntity | null;
+  treatmentId?: string | null;
+  status: DataRightsRequestStatus;
+  acknowledgedAt?: string | null;
+  dueAt: string;
+  extendedAt?: string | null;
+  extensionNote?: string | null;
+  blockingRequested: boolean;
+  blockingReason?: string | null;
+  blockingDueAt?: string | null;
+  blockingGranted?: boolean | null;
+  blockingResolvedAt?: string | null;
+  blockingNote?: string | null;
+  assigneeEmployeeId?: string | null;
+  assigneeFullName?: string | null;
+  resolution?: DataRightsResolution | null;
+  resolvedAt?: string | null;
+  denialGrounds: string[];
+  resolutionNote?: string | null;
+  responseDocument?: DocumentEntity | null;
+  responseDocumentId?: string | null;
+  responseSentAt?: string | null;
+  responseSentTo?: string | null;
+  responseSentMeans?: CommunicationMeans | null;
+  complaintAt?: string | null;
+  complaintNote?: string | null;
+  createdByEmployeeId: string;
+  createdByFullName: string;
+  events?: DataRightsEventEntity[];
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface DataRightsEventEntity {
+  id: string;
+  action: DataRightsEventAction;
+  note?: string | null;
+  employeeId?: string | null;
+  employeeFullName: string;
+  request?: DataRightsRequestEntity;
+  requestId: string;
+  createdAt: string;
+}
+
 type JsonValue = string | number | boolean | { [key in string]?: JsonValue } | Array<JsonValue> | null;

package/src/contracts/documentType.contract.ts

@@ -40,6 +40,9 @@ export interface DocumentTypeWritePayload {
   resetsYearly?: boolean;
   // Sus documentos llevan número (por omisión, sí).
   numbered?: boolean;
+  /** Transparencia Activa: sus documentos se publican cada mes, en esta sección del Portal. */
+  activeTransparency?: boolean;
+  transparencySection?: string | null;
   directorateCodeReference?: number | null;
   // Serie documental del Cuadro de Clasificación (sin valor: sin clasificar).
   archivalSeriesId?: string | null;

package/src/contracts/index.ts

@@ -11,6 +11,7 @@ import { SignatureCheckPatterns, type SignatureCheckContract } from './signature
 import { RepositoryExportPatterns, type RepositoryExportContract } from './repositoryExport.contract';
 import { RetentionPatterns, type RetentionContract } from './retention.contract';
 import { AccessRequestPatterns, type AccessRequestContract } from './accessRequest.contract';
+import { TransparencyPatterns, type TransparencyContract } from './transparency.contract';
 import { ScanPatterns, type ScanContract } from './scan.contract';
 import { PartsOfficePatterns, type PartsOfficeContract } from './partsOffice.contract';
 import { ProcedurePatterns, type ProcedureContract } from './procedure.contract';
@@ -38,6 +39,7 @@ export * from './signatureCheck.contract';
 export * from './repositoryExport.contract';
 export * from './retention.contract';
 export * from './accessRequest.contract';
+export * from './transparency.contract';
 
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export const GestorDocumentalPatterns = {
@@ -60,6 +62,7 @@ export const GestorDocumentalPatterns = {
   repositoryExport: RepositoryExportPatterns,
   retention: RetentionPatterns,
   accessRequest: AccessRequestPatterns,
+  transparency: TransparencyPatterns,
 } as const;
 
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
@@ -81,4 +84,5 @@ export type GestorDocumentalContract = DocumentTypeContract &
   SignatureCheckContract &
   RepositoryExportContract &
   RetentionContract &
-  AccessRequestContract;
+  AccessRequestContract &
+  TransparencyContract;

package/src/contracts/partsOffice.contract.ts

@@ -1,4 +1,4 @@
-import { type DocumentAccessLevel, type DocumentInstruction } from '../base/entities';
+import { type CommunicationMeans, type DocumentAccessLevel, type DocumentInstruction } from '../base/entities';
 import {
   type DocDigitalDocumentTypeEntity,
   type DocDigitalEntityEntity,
@@ -37,6 +37,8 @@ export const PartsOfficePatterns = {
   returnInbound: 'gestorDocumental.partsOffice.returnInbound',
   getInboundFile: 'gestorDocumental.partsOffice.getInboundFile',
   checkEnablement: 'gestorDocumental.partsOffice.checkEnablement',
+  dispatchByContingency: 'gestorDocumental.partsOffice.dispatchByContingency',
+  registerManualIntake: 'gestorDocumental.partsOffice.registerManualIntake',
 } as const;
 
 /** Destinatario interno de un ingreso, ya resuelto por el gateway (las áreas con sus integrantes). */
@@ -50,6 +52,30 @@ interface IListPayload<S> {
   filters?: { search?: string; status?: S };
 }
 
+/** Lo que llegó fuera de DocDigital y Oficina de Partes ingresa a mano. */
+export interface ManualIntakePayload {
+  file: { fileId: string; name: string };
+  attachments?: { fileId: string; name: string }[];
+  means: CommunicationMeans;
+  /** Cuándo llegó (ISO); sin él, ahora. */
+  receivedAt?: string | null;
+  senderEntityName: string;
+  senderName?: string | null;
+  externalFolio?: string | null;
+  externalDate?: string | null;
+  subject: string;
+  documentTypeId: string;
+  keywords: string[];
+  accessLevel?: DocumentAccessLevel;
+  hasSensitiveData?: boolean;
+  recipients: unknown[];
+  instruction: DocumentInstruction;
+  note?: string | null;
+  dueAt?: string | null;
+  dueBusinessDays?: number | null;
+  actor: DocumentActor;
+}
+
 export interface PartsOfficeContract {
   [PartsOfficePatterns.getStatus]: { payload: Record<string, never>; response: PartsOfficeStatusEntity };
   [PartsOfficePatterns.getSummary]: { payload: Record<string, never>; response: PartsOfficeSummaryEntity };
@@ -82,7 +108,11 @@ export interface PartsOfficeContract {
     response: PartsOfficeOkResponseEntity;
   };
   /** PDF firmado de un documento por despachar, para que Oficina de Partes lo revise. */
-  [PartsOfficePatterns.getDispatchFile]: { payload: { id: string }; response: PartsOfficeFileEntity };
+  [PartsOfficePatterns.getDispatchFile]: {
+    // con `receipt`, el comprobante del despacho por contingencia
+    payload: { id: string; receipt?: boolean };
+    response: PartsOfficeFileEntity;
+  };
   [PartsOfficePatterns.getInbound]: {
     payload: IListPayload<'Pending' | 'Registered' | 'Returned'>;
     response: RpcPage<PartsOfficeInboundEntity[]>;
@@ -131,4 +161,29 @@ export interface PartsOfficeContract {
     payload: { people: EnablementPersonInput[] };
     response: PartsOfficeEnablementEntity;
   };
+  /**
+   * Registro por contingencia: el documento no se pudo despachar por DocDigital y salió por otro medio. Queda
+   * despachado, con el medio, a quién, el motivo y el comprobante; si después se registra en DocDigital, su número.
+   */
+  [PartsOfficePatterns.dispatchByContingency]: {
+    payload: {
+      id: string;
+      means: CommunicationMeans;
+      sentAt: string;
+      sentTo: string;
+      reason: string;
+      receipt?: { fileId: string; name: string } | null;
+      docDigitalDocumentId?: string | null;
+      actor: DocumentActor;
+    };
+    response: PartsOfficeOkResponseEntity;
+  };
+  /**
+   * Ingreso manual: lo que llegó fuera de DocDigital (papel, correo) entra con folio de ingreso, como lo recibido
+   * por DocDigital, y se deriva.
+   */
+  [PartsOfficePatterns.registerManualIntake]: {
+    payload: ManualIntakePayload;
+    response: PartsOfficeRegisterResponseEntity;
+  };
 }

package/src/contracts/transparency.contract.ts

@@ -0,0 +1,55 @@
+import {
+  type DocumentPublicFileResponseEntity,
+  type IndicatorsFileEntity,
+  type TransparencyItemEntity,
+  type TransparencyItemStatus,
+  type TransparencyMonthEntity,
+  type TransparencyPublicEntity,
+} from '../entities';
+
+/** Patrones NATS de `transparency`: Transparencia Activa de los documentos firmados (Ley 20.285, art. 7°). */
+export const TransparencyPatterns = {
+  getMonth: 'gestorDocumental.transparency.getMonth',
+  update: 'gestorDocumental.transparency.update',
+  export: 'gestorDocumental.transparency.export',
+  getRedactedFile: 'gestorDocumental.transparency.getRedactedFile',
+  getPublic: 'gestorDocumental.transparency.getPublic',
+  getPublicFile: 'gestorDocumental.transparency.getPublicFile',
+} as const;
+
+type TTransparencyActor = { employeeId: string; fullName: string };
+
+/** Lo que se decide sobre un documento en Transparencia Activa. */
+export type TransparencyUpdatePayload =
+  /** Publicarlo (o corregir el enlace): si el original no es público, exige antes la versión tarjada. */
+  | { action: 'publish'; documentId: string; url?: string | null; note?: string | null; actor: TTransparencyActor }
+  /** No se publica, con su motivo (p. ej. reservado por el art. 21 de la Ley 20.285). */
+  | { action: 'exclude'; documentId: string; reason: string; actor: TTransparencyActor }
+  /** Vuelve a pendiente: se retiró la publicación o se revisó la exclusión. */
+  | { action: 'withdraw'; documentId: string; reason: string; actor: TTransparencyActor }
+  /** Versión tarjada ya subida al gestor de archivos (PDF). */
+  | { action: 'setRedacted'; documentId: string; fileId: string; fileName: string; actor: TTransparencyActor }
+  | { action: 'removeRedacted'; documentId: string; actor: TTransparencyActor };
+
+export interface TransparencyContract {
+  /** Lo firmado en el mes (hora de Chile) de los tipos que se publican, y lo que ya se publicó aunque el tipo cambie. */
+  [TransparencyPatterns.getMonth]: {
+    payload: { year: number; month: number; status?: TransparencyItemStatus | null };
+    response: TransparencyMonthEntity;
+  };
+  [TransparencyPatterns.update]: { payload: TransparencyUpdatePayload; response: TransparencyItemEntity };
+  /** Planilla del mes (Excel) para cargar en el Portal de Transparencia. */
+  [TransparencyPatterns.export]: {
+    payload: { year: number; month: number; generatedBy: string };
+    response: IndicatorsFileEntity;
+  };
+  /** La versión tarjada cargada, para revisarla antes de publicar. */
+  [TransparencyPatterns.getRedactedFile]: {
+    payload: { documentId: string };
+    response: DocumentPublicFileResponseEntity;
+  };
+  /** Página pública de un documento publicado, por su código de verificación. No exige sesión. */
+  [TransparencyPatterns.getPublic]: { payload: { code: string }; response: TransparencyPublicEntity };
+  /** La versión publicada: la tarjada si existe; si no, el original público. Solo de un documento vigente. */
+  [TransparencyPatterns.getPublicFile]: { payload: { code: string }; response: DocumentPublicFileResponseEntity };
+}

package/src/entities/document/document.entity.ts

@@ -1,4 +1,5 @@
 import {
+  type CommunicationMeans,
   DocumentAnnulledNumberEntity,
   DocumentAttachmentEntity,
   DocumentDeliveryEntity,
@@ -101,6 +102,14 @@ export interface DocumentDispatchResponseEntity {
   returnedAt: string | null;
   returnedByFullName: string | null;
   returnReason: string | null;
+  /** Registro por contingencia: salió por otro medio porque no se pudo por DocDigital. */
+  contingency: {
+    means: CommunicationMeans;
+    sentTo: string | null;
+    reason: string | null;
+    /** Nombre del comprobante, si se adjuntó. */
+    receiptName: string | null;
+  } | null;
 }
 
 export interface DocumentGetAllResponseEntity {

package/src/entities/documentType/documentType.entity.ts

@@ -26,6 +26,9 @@ export interface DocumentTypeGetAllResponseEntity {
   resetsYearly: DocumentTypeEntity['resetsYearly'];
   // Sin numeración, sus documentos solo llevan fecha, código de verificación y QR.
   numbered: DocumentTypeEntity['numbered'];
+  /** Transparencia Activa: sus documentos se publican cada mes, en esta sección del Portal. */
+  activeTransparency: DocumentTypeEntity['activeTransparency'];
+  transparencySection: DocumentTypeEntity['transparencySection'];
   directorateCodeReference: DocumentTypeEntity['directorateCodeReference'];
   // Serie documental del Cuadro de Clasificación a la que van sus documentos (MGDDE1_2).
   archivalSeries: { id: string; code: string; name: string } | null;

package/src/entities/index.ts

@@ -17,3 +17,4 @@ export * from './signatureCheck';
 export * from './repositoryExport';
 export * from './retention';
 export * from './accessRequest';
+export * from './transparency';

package/src/entities/transparency/index.ts

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

package/src/entities/transparency/transparency.entity.ts

@@ -0,0 +1,75 @@
+import { type DocumentAccessLevel, type DocumentStatus } from '../../base/entities';
+
+/** En qué quedó un documento en Transparencia Activa: aún sin decidir, publicado o excluido con su motivo. */
+export type TransparencyItemStatus = 'Pending' | 'Published' | 'Excluded';
+
+/** Un documento que se publica en Transparencia Activa (Ley 20.285, art. 7°), con lo que se decidió de él. */
+export interface TransparencyItemEntity {
+  documentId: string;
+  documentStatus: DocumentStatus;
+  verificationCode: string | null;
+  documentTypeName: string;
+  documentTypeAbbreviation: string | null;
+  /** Sección del Portal en que se publica, según su tipo documental. */
+  section: string | null;
+  /** Folio del documento (`Decreto Alcaldicio N° 15/2026`), o el nombre del tipo si no lleva número. */
+  reference: string;
+  correlative: number | null;
+  correlativeYear: number | null;
+  subject: string;
+  finishedAt: string | null;
+  annulledAt: string | null;
+  accessLevel: DocumentAccessLevel;
+  hasSensitiveData: boolean;
+  /** El original se puede publicar tal cual: es público (o su restricción terminó) y no tiene datos sensibles. */
+  originalIsPublic: boolean;
+  /** Para publicarlo hace falta antes la versión tarjada. */
+  needsRedacted: boolean;
+  redactedFileName: string | null;
+  status: TransparencyItemStatus;
+  /** Dirección de la publicación en el Portal de Transparencia, si se anotó. */
+  transparencyUrl: string | null;
+  /** Motivo de la exclusión, u observación de la publicación. */
+  transparencyNote: string | null;
+  transparencyAt: string | null;
+  transparencyByFullName: string | null;
+  /** Enlace público estable a la versión que se publica (`<TRANSPARENCY_URL>/<código>`), si está configurado. */
+  publicLink: string | null;
+}
+
+export interface TransparencyMonthCountsEntity {
+  total: number;
+  pending: number;
+  published: number;
+  excluded: number;
+  /** Publicados que después se anularon: hay que retirarlos o actualizarlos en el Portal. */
+  annulledPublished: number;
+}
+
+/** Lo firmado en un mes de los tipos documentales que se publican, con lo que falta por decidir. */
+export interface TransparencyMonthEntity {
+  year: number;
+  month: number;
+  counts: TransparencyMonthCountsEntity;
+  /** Tipos documentales marcados para Transparencia Activa. Sin ninguno, la bandeja queda vacía. */
+  documentTypes: { id: string; name: string; section: string | null }[];
+  items: TransparencyItemEntity[];
+}
+
+/** Lo que muestra la página pública de un documento publicado en Transparencia Activa. No exige sesión. */
+export interface TransparencyPublicEntity {
+  verificationCode: string;
+  documentTypeName: string;
+  issuerName: string;
+  section: string | null;
+  reference: string;
+  /** La materia solo se muestra si el original es público; si se publicó tarjado, se lee en el archivo. */
+  subject: string | null;
+  finishedAt: string | null;
+  /** Anulado después de publicarse: se informa y ya no se descarga. */
+  annulled: boolean;
+  /** Se publicó una versión tarjada (sin datos personales o reservados). */
+  redacted: boolean;
+  canDownload: boolean;
+  publishedAt: string | null;
+}