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

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/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,5 @@ export * from './signatureCheck';
 export * from './repositoryExport';
 export * from './retention';
 export * from './accessRequest';
+export * from './transparency';
+export * from './dataProtection';

package/dist/entities/index.js

@@ -33,3 +33,5 @@ __exportStar(require("./signatureCheck"), exports);
 __exportStar(require("./repositoryExport"), exports);
 __exportStar(require("./retention"), exports);
 __exportStar(require("./accessRequest"), exports);
+__exportStar(require("./transparency"), exports);
+__exportStar(require("./dataProtection"), 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,77 @@
+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. */
+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;
+    /** 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;
+    /** 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.26",
+  "version": "0.0.1-beta.28",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {

package/src/base/entities.ts

@@ -67,7 +67,11 @@ export type DocumentTrackingAction =
   | 'Received'
   | 'EmailCopySent'
   | 'EmailCopyOpened'
-  | 'DispositionRecorded';
+  | 'DispositionRecorded'
+  | 'TransparencyRedacted'
+  | 'TransparencyPublished'
+  | 'TransparencyExcluded'
+  | 'TransparencyWithdrawn';
 
 export const DocumentTrackingAction = {
   Created: 'Created',
@@ -91,6 +95,10 @@ export const DocumentTrackingAction = {
   EmailCopySent: 'EmailCopySent',
   EmailCopyOpened: 'EmailCopyOpened',
   DispositionRecorded: 'DispositionRecorded',
+  TransparencyRedacted: 'TransparencyRedacted',
+  TransparencyPublished: 'TransparencyPublished',
+  TransparencyExcluded: 'TransparencyExcluded',
+  TransparencyWithdrawn: 'TransparencyWithdrawn',
 } satisfies Record<string, DocumentTrackingAction>;
 
 export type DocumentOrigin = 'Internal' | 'DocDigital' | 'Manual';
@@ -335,7 +343,8 @@ export type AuditEntity =
   | 'Procedure'
   | 'QualityMetric'
   | 'ServiceOutage'
-  | 'Repository';
+  | 'Repository'
+  | 'DataTreatment';
 
 export const AuditEntity = {
   DocumentType: 'DocumentType',
@@ -347,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';
@@ -430,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;
@@ -440,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;
@@ -514,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;
@@ -1148,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/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/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;