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

package/dist/base/entities.d.ts

@@ -220,7 +220,7 @@ export declare const DocumentAccessAction: {
     FileDownloaded: "FileDownloaded";
     TrailExported: "TrailExported";
 };
-export type AuditEntity = 'DocumentType' | 'IssuingEntity' | 'ArchivalSeries' | 'TextSnippet' | 'Holiday' | 'Procedure' | 'QualityMetric' | 'ServiceOutage' | 'Repository';
+export type AuditEntity = 'DocumentType' | 'IssuingEntity' | 'ArchivalSeries' | 'TextSnippet' | 'Holiday' | 'Procedure' | 'QualityMetric' | 'ServiceOutage' | 'Repository' | 'DataTreatment';
 export declare const AuditEntity: {
     DocumentType: "DocumentType";
     IssuingEntity: "IssuingEntity";
@@ -231,6 +231,7 @@ export declare const AuditEntity: {
     QualityMetric: "QualityMetric";
     ServiceOutage: "ServiceOutage";
     Repository: "Repository";
+    DataTreatment: "DataTreatment";
 };
 export type AuditAction = 'Created' | 'Updated' | 'Enabled' | 'Disabled' | 'Removed' | 'Exported';
 export declare const AuditAction: {
@@ -293,6 +294,55 @@ export declare const TransparencyStatus: {
     Published: "Published";
     Excluded: "Excluded";
 };
+export type DataLegalBasis = 'LegalFunction' | 'LegalObligation' | 'Consent' | 'Contract' | 'VitalInterest';
+export declare const DataLegalBasis: {
+    LegalFunction: "LegalFunction";
+    LegalObligation: "LegalObligation";
+    Consent: "Consent";
+    Contract: "Contract";
+    VitalInterest: "VitalInterest";
+};
+export type DataRight = 'Access' | 'Rectification' | 'Suppression' | 'Opposition' | 'Portability';
+export declare const DataRight: {
+    Access: "Access";
+    Rectification: "Rectification";
+    Suppression: "Suppression";
+    Opposition: "Opposition";
+    Portability: "Portability";
+};
+export type DataRightsChannel = 'Email' | 'WebForm' | 'InPerson' | 'Letter';
+export declare const DataRightsChannel: {
+    Email: "Email";
+    WebForm: "WebForm";
+    InPerson: "InPerson";
+    Letter: "Letter";
+};
+export type DataRightsRequestStatus = 'Received' | 'InProgress' | 'Resolved';
+export declare const DataRightsRequestStatus: {
+    Received: "Received";
+    InProgress: "InProgress";
+    Resolved: "Resolved";
+};
+export type DataRightsResolution = 'Granted' | 'PartiallyGranted' | 'Denied' | 'Withdrawn';
+export declare const DataRightsResolution: {
+    Granted: "Granted";
+    PartiallyGranted: "PartiallyGranted";
+    Denied: "Denied";
+    Withdrawn: "Withdrawn";
+};
+export type DataRightsEventAction = 'Received' | 'Updated' | 'Acknowledged' | 'IdentityVerified' | 'Assigned' | 'BlockingResolved' | 'Extended' | 'Resolved' | 'ResponseSent' | 'ComplaintRegistered';
+export declare const DataRightsEventAction: {
+    Received: "Received";
+    Updated: "Updated";
+    Acknowledged: "Acknowledged";
+    IdentityVerified: "IdentityVerified";
+    Assigned: "Assigned";
+    BlockingResolved: "BlockingResolved";
+    Extended: "Extended";
+    Resolved: "Resolved";
+    ResponseSent: "ResponseSent";
+    ComplaintRegistered: "ComplaintRegistered";
+};
 export interface DocumentTypeEntity {
     id: string;
     name: string;
@@ -386,6 +436,7 @@ export interface DocumentEntity {
     redactedFileId?: string | null;
     redactedFileName?: string | null;
     accessRequestResponses?: AccessRequestEntity[];
+    dataRightsResponses?: DataRightsRequestEntity[];
     accessRequestDeliveries?: AccessRequestDocumentEntity[];
     dispatch?: DocumentDispatchEntity | null;
     docDigitalInbound?: DocDigitalInboundEntity | null;
@@ -978,6 +1029,85 @@ export interface AccessRequestEventEntity {
     accessRequestId: string;
     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/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.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.DataRightsEventAction = exports.DataRightsResolution = exports.DataRightsRequestStatus = exports.DataRightsChannel = exports.DataRight = exports.DataLegalBasis = exports.TransparencyStatus = exports.AccessRequestEventAction = exports.AccessRequestResolution = exports.AccessRequestStatus = exports.AccessRequestChannel = exports.DispositionKind = exports.FinalDisposition = exports.AuditAction = exports.AuditEntity = exports.DocumentAccessAction = exports.QualityMetricKey = exports.ServiceOutageKind = exports.WorkFolderItemKind = exports.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',
@@ -205,6 +205,7 @@ exports.AuditEntity = {
     QualityMetric: 'QualityMetric',
     ServiceOutage: 'ServiceOutage',
     Repository: 'Repository',
+    DataTreatment: 'DataTreatment',
 };
 exports.AuditAction = {
     Created: 'Created',
@@ -259,3 +260,46 @@ exports.TransparencyStatus = {
     Published: 'Published',
     Excluded: 'Excluded',
 };
+exports.DataLegalBasis = {
+    LegalFunction: 'LegalFunction',
+    LegalObligation: 'LegalObligation',
+    Consent: 'Consent',
+    Contract: 'Contract',
+    VitalInterest: 'VitalInterest',
+};
+exports.DataRight = {
+    Access: 'Access',
+    Rectification: 'Rectification',
+    Suppression: 'Suppression',
+    Opposition: 'Opposition',
+    Portability: 'Portability',
+};
+exports.DataRightsChannel = {
+    Email: 'Email',
+    WebForm: 'WebForm',
+    InPerson: 'InPerson',
+    Letter: 'Letter',
+};
+exports.DataRightsRequestStatus = {
+    Received: 'Received',
+    InProgress: 'InProgress',
+    Resolved: 'Resolved',
+};
+exports.DataRightsResolution = {
+    Granted: 'Granted',
+    PartiallyGranted: 'PartiallyGranted',
+    Denied: 'Denied',
+    Withdrawn: 'Withdrawn',
+};
+exports.DataRightsEventAction = {
+    Received: 'Received',
+    Updated: 'Updated',
+    Acknowledged: 'Acknowledged',
+    IdentityVerified: 'IdentityVerified',
+    Assigned: 'Assigned',
+    BlockingResolved: 'BlockingResolved',
+    Extended: 'Extended',
+    Resolved: 'Resolved',
+    ResponseSent: 'ResponseSent',
+    ComplaintRegistered: 'ComplaintRegistered',
+};

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

@@ -0,0 +1,168 @@
+import { type CommunicationMeans, type DataLegalBasis, type DataRight, type DataRightsChannel, type DataRightsResolution } from '../base/entities';
+import { type DataProtectionPolicyEntity, type DataRightsRequestDetailEntity, type DataRightsRequestListItemEntity, type DataRightsSummaryEntity, type DataTreatmentResponseEntity } from '../entities';
+import { type RpcPage } from './contract';
+/** Patrones NATS de `dataProtection`: tratamientos de datos y solicitudes de los titulares (Ley 19.628). */
+export declare const DataProtectionPatterns: {
+    readonly getTreatments: "gestorDocumental.dataProtection.getTreatments";
+    readonly createTreatment: "gestorDocumental.dataProtection.createTreatment";
+    readonly updateTreatment: "gestorDocumental.dataProtection.updateTreatment";
+    readonly setTreatmentEnabled: "gestorDocumental.dataProtection.setTreatmentEnabled";
+    readonly getPolicy: "gestorDocumental.dataProtection.getPolicy";
+    readonly getRequests: "gestorDocumental.dataProtection.getRequests";
+    readonly getRequest: "gestorDocumental.dataProtection.getRequest";
+    readonly getSummary: "gestorDocumental.dataProtection.getSummary";
+    readonly createRequest: "gestorDocumental.dataProtection.createRequest";
+    readonly updateRequest: "gestorDocumental.dataProtection.updateRequest";
+    readonly actOnRequest: "gestorDocumental.dataProtection.actOnRequest";
+};
+type TActor = {
+    employeeId: string;
+    fullName: string;
+};
+/** Datos de un tratamiento al crearlo o editarlo. */
+export interface DataTreatmentWritePayload {
+    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;
+}
+/** Datos de una solicitud al ingresarla o corregirla. */
+export interface DataRightsRequestWritePayload {
+    channel: DataRightsChannel;
+    receivedAt: string;
+    rights: DataRight[];
+    requesterName: string;
+    requesterRut?: string | null;
+    requesterEmail?: string | null;
+    requesterAddress?: string | null;
+    representativeName?: string | null;
+    requestText: string;
+    treatmentId?: string | null;
+    /** Bloqueo temporal: solo con rectificación, supresión u oposición, y fundado. */
+    blockingRequested?: boolean;
+    blockingReason?: string | null;
+}
+/** Un paso de la tramitación. */
+export type DataRightsAction = {
+    type: 'acknowledge';
+    note?: string | null;
+} | {
+    type: 'verifyIdentity';
+    note?: string | null;
+} | {
+    type: 'assign';
+    employeeId: string;
+    fullName: string;
+    note?: string | null;
+}
+/** Bloqueo temporal, en 2 días hábiles; si se rechaza, fundado (y se comunica a la Agencia). */
+ | {
+    type: 'resolveBlocking';
+    granted: boolean;
+    note?: string | null;
+} | {
+    type: 'extend';
+    note: string;
+} | {
+    type: 'resolve';
+    resolution: DataRightsResolution;
+    grounds?: string[];
+    note?: string | null;
+    responseDocumentId?: string | null;
+}
+/** Respaldo del envío de la respuesta escrita (art. 11). */
+ | {
+    type: 'registerResponseSent';
+    sentAt?: string | null;
+    sentTo: string;
+    means: CommunicationMeans;
+    note?: string | null;
+} | {
+    type: 'registerComplaint';
+    complaintAt?: string | null;
+    note: string;
+};
+export interface DataProtectionContract {
+    [DataProtectionPatterns.getTreatments]: {
+        payload: {
+            enabled?: boolean | null;
+        };
+        response: DataTreatmentResponseEntity[];
+    };
+    [DataProtectionPatterns.createTreatment]: {
+        payload: DataTreatmentWritePayload;
+        response: DataTreatmentResponseEntity;
+    };
+    [DataProtectionPatterns.updateTreatment]: {
+        payload: DataTreatmentWritePayload & {
+            id: string;
+        };
+        response: DataTreatmentResponseEntity;
+    };
+    [DataProtectionPatterns.setTreatmentEnabled]: {
+        payload: {
+            id: string;
+            enabled: boolean;
+        };
+        response: DataTreatmentResponseEntity;
+    };
+    /** Lo que se publica sin sesión (art. 14 ter): los tratamientos habilitados y publicados. */
+    [DataProtectionPatterns.getPolicy]: {
+        payload: Record<string, never>;
+        response: DataProtectionPolicyEntity;
+    };
+    [DataProtectionPatterns.getRequests]: {
+        payload: {
+            status?: 'open' | 'resolved' | 'all';
+            year?: number | null;
+            search?: string;
+            page?: number;
+            limit?: number;
+        };
+        response: RpcPage<DataRightsRequestListItemEntity[]>;
+    };
+    [DataProtectionPatterns.getRequest]: {
+        payload: {
+            id: string;
+        };
+        response: DataRightsRequestDetailEntity;
+    };
+    [DataProtectionPatterns.getSummary]: {
+        payload: {
+            year: number;
+        };
+        response: DataRightsSummaryEntity;
+    };
+    [DataProtectionPatterns.createRequest]: {
+        payload: DataRightsRequestWritePayload & {
+            actor: TActor;
+        };
+        response: DataRightsRequestDetailEntity;
+    };
+    [DataProtectionPatterns.updateRequest]: {
+        payload: DataRightsRequestWritePayload & {
+            id: string;
+            actor: TActor;
+        };
+        response: DataRightsRequestDetailEntity;
+    };
+    [DataProtectionPatterns.actOnRequest]: {
+        payload: {
+            id: string;
+            action: DataRightsAction;
+            actor: TActor;
+        };
+        response: DataRightsRequestDetailEntity;
+    };
+}
+export {};

package/dist/contracts/dataProtection.contract.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataProtectionPatterns = void 0;
+/** Patrones NATS de `dataProtection`: tratamientos de datos y solicitudes de los titulares (Ley 19.628). */
+exports.DataProtectionPatterns = {
+    getTreatments: 'gestorDocumental.dataProtection.getTreatments',
+    createTreatment: 'gestorDocumental.dataProtection.createTreatment',
+    updateTreatment: 'gestorDocumental.dataProtection.updateTreatment',
+    setTreatmentEnabled: 'gestorDocumental.dataProtection.setTreatmentEnabled',
+    getPolicy: 'gestorDocumental.dataProtection.getPolicy',
+    getRequests: 'gestorDocumental.dataProtection.getRequests',
+    getRequest: 'gestorDocumental.dataProtection.getRequest',
+    getSummary: 'gestorDocumental.dataProtection.getSummary',
+    createRequest: 'gestorDocumental.dataProtection.createRequest',
+    updateRequest: 'gestorDocumental.dataProtection.updateRequest',
+    actOnRequest: 'gestorDocumental.dataProtection.actOnRequest',
+};

package/dist/contracts/index.d.ts

@@ -12,6 +12,7 @@ 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 DataProtectionContract } from './dataProtection.contract';
 import { type ScanContract } from './scan.contract';
 import { type PartsOfficeContract } from './partsOffice.contract';
 import { type ProcedureContract } from './procedure.contract';
@@ -39,6 +40,7 @@ export * from './repositoryExport.contract';
 export * from './retention.contract';
 export * from './accessRequest.contract';
 export * from './transparency.contract';
+export * from './dataProtection.contract';
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export declare const GestorDocumentalPatterns: {
     readonly documentType: {
@@ -229,6 +231,19 @@ export declare const GestorDocumentalPatterns: {
         readonly getPublic: "gestorDocumental.transparency.getPublic";
         readonly getPublicFile: "gestorDocumental.transparency.getPublicFile";
     };
+    readonly dataProtection: {
+        readonly getTreatments: "gestorDocumental.dataProtection.getTreatments";
+        readonly createTreatment: "gestorDocumental.dataProtection.createTreatment";
+        readonly updateTreatment: "gestorDocumental.dataProtection.updateTreatment";
+        readonly setTreatmentEnabled: "gestorDocumental.dataProtection.setTreatmentEnabled";
+        readonly getPolicy: "gestorDocumental.dataProtection.getPolicy";
+        readonly getRequests: "gestorDocumental.dataProtection.getRequests";
+        readonly getRequest: "gestorDocumental.dataProtection.getRequest";
+        readonly getSummary: "gestorDocumental.dataProtection.getSummary";
+        readonly createRequest: "gestorDocumental.dataProtection.createRequest";
+        readonly updateRequest: "gestorDocumental.dataProtection.updateRequest";
+        readonly actOnRequest: "gestorDocumental.dataProtection.actOnRequest";
+    };
 };
 /** 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 & TransparencyContract;
+export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & IssuingEntityContract & CaseFileContract & PartsOfficeContract & RegisterBookContract & SignatureBatchContract & WorkFolderContract & ScanContract & ArchivalSeriesContract & TextSnippetContract & HolidayContract & IndicatorsContract & AuditContract & SignatureCheckContract & RepositoryExportContract & RetentionContract & AccessRequestContract & TransparencyContract & DataProtectionContract;

package/dist/contracts/index.js

@@ -29,6 +29,7 @@ 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 dataProtection_contract_1 = require("./dataProtection.contract");
 const scan_contract_1 = require("./scan.contract");
 const partsOffice_contract_1 = require("./partsOffice.contract");
 const procedure_contract_1 = require("./procedure.contract");
@@ -56,6 +57,7 @@ __exportStar(require("./repositoryExport.contract"), exports);
 __exportStar(require("./retention.contract"), exports);
 __exportStar(require("./accessRequest.contract"), exports);
 __exportStar(require("./transparency.contract"), exports);
+__exportStar(require("./dataProtection.contract"), exports);
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 exports.GestorDocumentalPatterns = {
     documentType: documentType_contract_1.DocumentTypePatterns,
@@ -78,4 +80,5 @@ exports.GestorDocumentalPatterns = {
     retention: retention_contract_1.RetentionPatterns,
     accessRequest: accessRequest_contract_1.AccessRequestPatterns,
     transparency: transparency_contract_1.TransparencyPatterns,
+    dataProtection: dataProtection_contract_1.DataProtectionPatterns,
 };

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

@@ -0,0 +1,129 @@
+import { type CommunicationMeans, type DataLegalBasis, type DataRight, type DataRightsChannel, type DataRightsEventAction, type DataRightsRequestStatus, type DataRightsResolution } from '../../base/entities';
+/** Tratamiento de datos personales de la municipalidad: lo que se informa al público (Ley 19.628, art. 14 ter). */
+export interface DataTreatmentResponseEntity {
+    id: string;
+    name: string;
+    purpose: string;
+    legalBasis: DataLegalBasis;
+    legalBasisDetail: string | null;
+    dataCategories: string[];
+    sensitiveData: boolean;
+    dataSubjects: string;
+    recipients: string | null;
+    source: string | null;
+    retention: string | null;
+    securityMeasures: string | null;
+    internationalTransfer: string | null;
+    responsibleUnit: string | null;
+    published: boolean;
+    enabled: boolean;
+    /** Solicitudes de titulares que lo mencionan. */
+    requests: number;
+    updatedAt: string;
+}
+/** Página pública de protección de datos: quién es el responsable, cómo ejercer los derechos y qué se trata. */
+export interface DataProtectionPolicyEntity {
+    organ: string;
+    /** Correo o medio en que se reciben las solicitudes de los titulares (art. 14 ter letra c). */
+    contact: string | null;
+    /** Dirección de la política de tratamiento, si está publicada aparte. */
+    policyUrl: string | null;
+    treatments: Omit<DataTreatmentResponseEntity, 'published' | 'enabled' | 'requests' | 'securityMeasures'>[];
+}
+/** Semáforo del plazo: a tiempo, por vencer (5 días corridos o menos) o vencido. */
+export type DataRightsDueStatus = 'OnTime' | 'DueSoon' | 'Overdue';
+export interface DataRightsRequestListItemEntity {
+    id: string;
+    /** «N° 4/2026». */
+    label: string;
+    channel: DataRightsChannel;
+    rights: DataRight[];
+    requesterName: string;
+    requestText: string;
+    treatmentName: string | null;
+    receivedAt: string;
+    dueAt: string;
+    status: DataRightsRequestStatus;
+    resolution: DataRightsResolution | null;
+    assigneeFullName: string | null;
+    acknowledged: boolean;
+    identityVerified: boolean;
+    /** Bloqueo temporal pedido y sin resolver. */
+    blockingPending: boolean;
+    /** Solo mientras está abierta. */
+    dueStatus: DataRightsDueStatus | null;
+    daysLeft: number | null;
+    resolvedOnTime: boolean | null;
+}
+export interface DataRightsDocumentLinkEntity {
+    id: string;
+    folio: string | null;
+    subject: string;
+}
+export interface DataRightsRequestDetailEntity extends DataRightsRequestListItemEntity {
+    year: number;
+    number: number;
+    requesterRut: string | null;
+    requesterEmail: string | null;
+    requesterAddress: string | null;
+    representativeName: string | null;
+    identityVerifiedAt: string | null;
+    identityNote: string | null;
+    treatmentId: string | null;
+    acknowledgedAt: string | null;
+    extendedAt: string | null;
+    extensionNote: string | null;
+    blockingRequested: boolean;
+    blockingReason: string | null;
+    blockingDueAt: string | null;
+    blockingGranted: boolean | null;
+    blockingResolvedAt: string | null;
+    blockingNote: string | null;
+    assigneeEmployeeId: string | null;
+    resolvedAt: string | null;
+    denialGrounds: string[];
+    resolutionNote: string | null;
+    responseDocument: DataRightsDocumentLinkEntity | null;
+    responseSentAt: string | null;
+    responseSentTo: string | null;
+    responseSentMeans: CommunicationMeans | null;
+    /** Hasta cuándo el titular puede reclamar ante la Agencia (30 días hábiles), si se denegó en todo o en parte. */
+    complaintDeadline: string | null;
+    complaintAt: string | null;
+    complaintNote: string | null;
+    createdByFullName: string;
+    /** Se puede prorrogar: abierta, sin prórroga y antes de vencer. */
+    canExtend: boolean;
+    /** El titular ya puede reclamar ante la Agencia: denegación o plazo vencido sin respuesta. */
+    canRegisterComplaint: boolean;
+    events: {
+        action: DataRightsEventAction;
+        note: string | null;
+        employeeFullName: string;
+        createdAt: string;
+    }[];
+}
+export interface DataRightsSummaryEntity {
+    year: number;
+    total: number;
+    open: number;
+    overdue: number;
+    dueSoon: number;
+    /** Abiertas sin acuse de recibo. */
+    unacknowledged: number;
+    /** Bloqueos temporales pedidos y sin resolver. */
+    blockingPending: number;
+    byRight: Record<DataRight, number>;
+    resolved: Record<DataRightsResolution, number>;
+    /** Respondidas dentro del plazo sobre las respondidas, en %. */
+    onTimeRate: number | null;
+    complaints: number;
+}
+/** Datos personales que se reconocen en el texto de un documento, enmascarados: ayudan a tarjar. */
+export interface PersonalDataHintsEntity {
+    ruts: number;
+    emails: number;
+    phones: number;
+    /** Algunos ejemplos enmascarados («11.1••.•••-1»). */
+    samples: string[];
+}

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

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

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

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

package/dist/entities/dataProtection/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./dataProtection.entity"), exports);

package/dist/entities/index.d.ts

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

package/dist/entities/index.js

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

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

@@ -1,4 +1,5 @@
 import { type DocumentAccessLevel, type DocumentStatus } from '../../base/entities';
+import { type PersonalDataHintsEntity } from '../dataProtection';
 /** 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. */
@@ -24,6 +25,8 @@ export interface TransparencyItemEntity {
     /** Para publicarlo hace falta antes la versión tarjada. */
     needsRedacted: boolean;
     redactedFileName: string | null;
+    /** RUN, correos y teléfonos que se reconocen en el texto del original (`null` si no tiene texto): ayudan a tarjar. */
+    personalData: PersonalDataHintsEntity | null;
     status: TransparencyItemStatus;
     /** Dirección de la publicación en el Portal de Transparencia, si se anotó. */
     transparencyUrl: string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@muni-sanfer/types-gestor-documental",
-  "version": "0.0.1-beta.27",
+  "version": "0.0.1-beta.28",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {

package/src/contracts/dataProtection.contract.ts

@@ -0,0 +1,137 @@
+import {
+  type CommunicationMeans,
+  type DataLegalBasis,
+  type DataRight,
+  type DataRightsChannel,
+  type DataRightsResolution,
+} from '../base/entities';
+import {
+  type DataProtectionPolicyEntity,
+  type DataRightsRequestDetailEntity,
+  type DataRightsRequestListItemEntity,
+  type DataRightsSummaryEntity,
+  type DataTreatmentResponseEntity,
+} from '../entities';
+import { type RpcPage } from './contract';
+
+/** Patrones NATS de `dataProtection`: tratamientos de datos y solicitudes de los titulares (Ley 19.628). */
+export const DataProtectionPatterns = {
+  getTreatments: 'gestorDocumental.dataProtection.getTreatments',
+  createTreatment: 'gestorDocumental.dataProtection.createTreatment',
+  updateTreatment: 'gestorDocumental.dataProtection.updateTreatment',
+  setTreatmentEnabled: 'gestorDocumental.dataProtection.setTreatmentEnabled',
+  getPolicy: 'gestorDocumental.dataProtection.getPolicy',
+  getRequests: 'gestorDocumental.dataProtection.getRequests',
+  getRequest: 'gestorDocumental.dataProtection.getRequest',
+  getSummary: 'gestorDocumental.dataProtection.getSummary',
+  createRequest: 'gestorDocumental.dataProtection.createRequest',
+  updateRequest: 'gestorDocumental.dataProtection.updateRequest',
+  actOnRequest: 'gestorDocumental.dataProtection.actOnRequest',
+} as const;
+
+type TActor = { employeeId: string; fullName: string };
+
+/** Datos de un tratamiento al crearlo o editarlo. */
+export interface DataTreatmentWritePayload {
+  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;
+}
+
+/** Datos de una solicitud al ingresarla o corregirla. */
+export interface DataRightsRequestWritePayload {
+  channel: DataRightsChannel;
+  receivedAt: string;
+  rights: DataRight[];
+  requesterName: string;
+  requesterRut?: string | null;
+  requesterEmail?: string | null;
+  requesterAddress?: string | null;
+  representativeName?: string | null;
+  requestText: string;
+  treatmentId?: string | null;
+  /** Bloqueo temporal: solo con rectificación, supresión u oposición, y fundado. */
+  blockingRequested?: boolean;
+  blockingReason?: string | null;
+}
+
+/** Un paso de la tramitación. */
+export type DataRightsAction =
+  | { type: 'acknowledge'; note?: string | null }
+  | { type: 'verifyIdentity'; note?: string | null }
+  | { type: 'assign'; employeeId: string; fullName: string; note?: string | null }
+  /** Bloqueo temporal, en 2 días hábiles; si se rechaza, fundado (y se comunica a la Agencia). */
+  | { type: 'resolveBlocking'; granted: boolean; note?: string | null }
+  | { type: 'extend'; note: string }
+  | {
+      type: 'resolve';
+      resolution: DataRightsResolution;
+      grounds?: string[];
+      note?: string | null;
+      responseDocumentId?: string | null;
+    }
+  /** Respaldo del envío de la respuesta escrita (art. 11). */
+  | {
+      type: 'registerResponseSent';
+      sentAt?: string | null;
+      sentTo: string;
+      means: CommunicationMeans;
+      note?: string | null;
+    }
+  | { type: 'registerComplaint'; complaintAt?: string | null; note: string };
+
+export interface DataProtectionContract {
+  [DataProtectionPatterns.getTreatments]: {
+    payload: { enabled?: boolean | null };
+    response: DataTreatmentResponseEntity[];
+  };
+  [DataProtectionPatterns.createTreatment]: {
+    payload: DataTreatmentWritePayload;
+    response: DataTreatmentResponseEntity;
+  };
+  [DataProtectionPatterns.updateTreatment]: {
+    payload: DataTreatmentWritePayload & { id: string };
+    response: DataTreatmentResponseEntity;
+  };
+  [DataProtectionPatterns.setTreatmentEnabled]: {
+    payload: { id: string; enabled: boolean };
+    response: DataTreatmentResponseEntity;
+  };
+  /** Lo que se publica sin sesión (art. 14 ter): los tratamientos habilitados y publicados. */
+  [DataProtectionPatterns.getPolicy]: { payload: Record<string, never>; response: DataProtectionPolicyEntity };
+  [DataProtectionPatterns.getRequests]: {
+    payload: {
+      status?: 'open' | 'resolved' | 'all';
+      year?: number | null;
+      search?: string;
+      page?: number;
+      limit?: number;
+    };
+    response: RpcPage<DataRightsRequestListItemEntity[]>;
+  };
+  [DataProtectionPatterns.getRequest]: { payload: { id: string }; response: DataRightsRequestDetailEntity };
+  [DataProtectionPatterns.getSummary]: { payload: { year: number }; response: DataRightsSummaryEntity };
+  [DataProtectionPatterns.createRequest]: {
+    payload: DataRightsRequestWritePayload & { actor: TActor };
+    response: DataRightsRequestDetailEntity;
+  };
+  [DataProtectionPatterns.updateRequest]: {
+    payload: DataRightsRequestWritePayload & { id: string; actor: TActor };
+    response: DataRightsRequestDetailEntity;
+  };
+  [DataProtectionPatterns.actOnRequest]: {
+    payload: { id: string; action: DataRightsAction; actor: TActor };
+    response: DataRightsRequestDetailEntity;
+  };
+}

package/src/contracts/index.ts

@@ -12,6 +12,7 @@ import { RepositoryExportPatterns, type RepositoryExportContract } from './repos
 import { RetentionPatterns, type RetentionContract } from './retention.contract';
 import { AccessRequestPatterns, type AccessRequestContract } from './accessRequest.contract';
 import { TransparencyPatterns, type TransparencyContract } from './transparency.contract';
+import { DataProtectionPatterns, type DataProtectionContract } from './dataProtection.contract';
 import { ScanPatterns, type ScanContract } from './scan.contract';
 import { PartsOfficePatterns, type PartsOfficeContract } from './partsOffice.contract';
 import { ProcedurePatterns, type ProcedureContract } from './procedure.contract';
@@ -40,6 +41,7 @@ export * from './repositoryExport.contract';
 export * from './retention.contract';
 export * from './accessRequest.contract';
 export * from './transparency.contract';
+export * from './dataProtection.contract';
 
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export const GestorDocumentalPatterns = {
@@ -63,6 +65,7 @@ export const GestorDocumentalPatterns = {
   retention: RetentionPatterns,
   accessRequest: AccessRequestPatterns,
   transparency: TransparencyPatterns,
+  dataProtection: DataProtectionPatterns,
 } as const;
 
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
@@ -85,4 +88,5 @@ export type GestorDocumentalContract = DocumentTypeContract &
   RepositoryExportContract &
   RetentionContract &
   AccessRequestContract &
-  TransparencyContract;
+  TransparencyContract &
+  DataProtectionContract;

package/src/entities/dataProtection/dataProtection.entity.ts

@@ -0,0 +1,140 @@
+import {
+  type CommunicationMeans,
+  type DataLegalBasis,
+  type DataRight,
+  type DataRightsChannel,
+  type DataRightsEventAction,
+  type DataRightsRequestStatus,
+  type DataRightsResolution,
+} from '../../base/entities';
+
+/** Tratamiento de datos personales de la municipalidad: lo que se informa al público (Ley 19.628, art. 14 ter). */
+export interface DataTreatmentResponseEntity {
+  id: string;
+  name: string;
+  purpose: string;
+  legalBasis: DataLegalBasis;
+  legalBasisDetail: string | null;
+  dataCategories: string[];
+  sensitiveData: boolean;
+  dataSubjects: string;
+  recipients: string | null;
+  source: string | null;
+  retention: string | null;
+  securityMeasures: string | null;
+  internationalTransfer: string | null;
+  responsibleUnit: string | null;
+  published: boolean;
+  enabled: boolean;
+  /** Solicitudes de titulares que lo mencionan. */
+  requests: number;
+  updatedAt: string;
+}
+
+/** Página pública de protección de datos: quién es el responsable, cómo ejercer los derechos y qué se trata. */
+export interface DataProtectionPolicyEntity {
+  organ: string;
+  /** Correo o medio en que se reciben las solicitudes de los titulares (art. 14 ter letra c). */
+  contact: string | null;
+  /** Dirección de la política de tratamiento, si está publicada aparte. */
+  policyUrl: string | null;
+  treatments: Omit<DataTreatmentResponseEntity, 'published' | 'enabled' | 'requests' | 'securityMeasures'>[];
+}
+
+/** Semáforo del plazo: a tiempo, por vencer (5 días corridos o menos) o vencido. */
+export type DataRightsDueStatus = 'OnTime' | 'DueSoon' | 'Overdue';
+
+export interface DataRightsRequestListItemEntity {
+  id: string;
+  /** «N° 4/2026». */
+  label: string;
+  channel: DataRightsChannel;
+  rights: DataRight[];
+  requesterName: string;
+  requestText: string;
+  treatmentName: string | null;
+  receivedAt: string;
+  dueAt: string;
+  status: DataRightsRequestStatus;
+  resolution: DataRightsResolution | null;
+  assigneeFullName: string | null;
+  acknowledged: boolean;
+  identityVerified: boolean;
+  /** Bloqueo temporal pedido y sin resolver. */
+  blockingPending: boolean;
+  /** Solo mientras está abierta. */
+  dueStatus: DataRightsDueStatus | null;
+  daysLeft: number | null;
+  resolvedOnTime: boolean | null;
+}
+
+export interface DataRightsDocumentLinkEntity {
+  id: string;
+  folio: string | null;
+  subject: string;
+}
+
+export interface DataRightsRequestDetailEntity extends DataRightsRequestListItemEntity {
+  year: number;
+  number: number;
+  requesterRut: string | null;
+  requesterEmail: string | null;
+  requesterAddress: string | null;
+  representativeName: string | null;
+  identityVerifiedAt: string | null;
+  identityNote: string | null;
+  treatmentId: string | null;
+  acknowledgedAt: string | null;
+  extendedAt: string | null;
+  extensionNote: string | null;
+  blockingRequested: boolean;
+  blockingReason: string | null;
+  blockingDueAt: string | null;
+  blockingGranted: boolean | null;
+  blockingResolvedAt: string | null;
+  blockingNote: string | null;
+  assigneeEmployeeId: string | null;
+  resolvedAt: string | null;
+  denialGrounds: string[];
+  resolutionNote: string | null;
+  responseDocument: DataRightsDocumentLinkEntity | null;
+  responseSentAt: string | null;
+  responseSentTo: string | null;
+  responseSentMeans: CommunicationMeans | null;
+  /** Hasta cuándo el titular puede reclamar ante la Agencia (30 días hábiles), si se denegó en todo o en parte. */
+  complaintDeadline: string | null;
+  complaintAt: string | null;
+  complaintNote: string | null;
+  createdByFullName: string;
+  /** Se puede prorrogar: abierta, sin prórroga y antes de vencer. */
+  canExtend: boolean;
+  /** El titular ya puede reclamar ante la Agencia: denegación o plazo vencido sin respuesta. */
+  canRegisterComplaint: boolean;
+  events: { action: DataRightsEventAction; note: string | null; employeeFullName: string; createdAt: string }[];
+}
+
+export interface DataRightsSummaryEntity {
+  year: number;
+  total: number;
+  open: number;
+  overdue: number;
+  dueSoon: number;
+  /** Abiertas sin acuse de recibo. */
+  unacknowledged: number;
+  /** Bloqueos temporales pedidos y sin resolver. */
+  blockingPending: number;
+  byRight: Record<DataRight, number>;
+  resolved: Record<DataRightsResolution, number>;
+  /** Respondidas dentro del plazo sobre las respondidas, en %. */
+  onTimeRate: number | null;
+  complaints: number;
+}
+
+/** Datos personales que se reconocen en el texto de un documento, enmascarados: ayudan a tarjar. */
+export interface PersonalDataHintsEntity {
+  ruts: number;
+  emails: number;
+  phones: number;
+  /** Algunos ejemplos enmascarados («11.1••.•••-1»). */
+  samples: string[];
+}

package/src/entities/dataProtection/index.ts

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

package/src/entities/index.ts

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

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

@@ -1,4 +1,5 @@
 import { type DocumentAccessLevel, type DocumentStatus } from '../../base/entities';
+import { type PersonalDataHintsEntity } from '../dataProtection';
 
 /** En qué quedó un documento en Transparencia Activa: aún sin decidir, publicado o excluido con su motivo. */
 export type TransparencyItemStatus = 'Pending' | 'Published' | 'Excluded';
@@ -26,6 +27,8 @@ export interface TransparencyItemEntity {
   /** Para publicarlo hace falta antes la versión tarjada. */
   needsRedacted: boolean;
   redactedFileName: string | null;
+  /** RUN, correos y teléfonos que se reconocen en el texto del original (`null` si no tiene texto): ayudan a tarjar. */
+  personalData: PersonalDataHintsEntity | null;
   status: TransparencyItemStatus;
   /** Dirección de la publicación en el Portal de Transparencia, si se anotó. */
   transparencyUrl: string | null;