@muni-sanfer/types-gestor-documental 0.0.1-beta.14 → 0.0.1-beta.16

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

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

@@ -102,7 +102,10 @@ export interface CaseFileAccessResponseEntity {
     entryId: CaseFileAccessEntity['entryId'];
     /** Título del documento que se abrió, si el acceso fue a uno. */
     entryTitle: string | null;
+    /** El funcionario o, si fue por un enlace temporal, su destinatario externo. */
     employeeFullName: CaseFileAccessEntity['employeeFullName'];
+    /** Fue por un enlace temporal, sin sesión. */
+    external: boolean;
     createdAt: CaseFileAccessEntity['createdAt'];
 }
 export interface CaseFileGetByIdResponseEntity extends CaseFileGetAllResponseEntity {
@@ -117,6 +120,14 @@ export interface CaseFileGetByIdResponseEntity extends CaseFileGetAllResponseEnt
     closingNote: CaseFileEntity['closingNote'];
     /** Expediente híbrido: tiene documentos en papel que no se pudieron digitalizar. */
     isHybrid: boolean;
+    /** MGDEE1_2: serie del Cuadro de Clasificación. */
+    archivalSeries: {
+        id: string;
+        code: string;
+        name: string;
+    } | null;
+    /** MGDEE8_2: fin de la restricción de acceso. */
+    restrictionEndsAt: string | null;
     index: CaseFileEntryResponseEntity[];
     sharedWith: CaseFileParticipantResponseEntity[];
     actors: CaseFileActorResponseEntity[];
@@ -182,3 +193,77 @@ export interface CaseFileExportResponseEntity {
 }
 /** Expediente en que está incorporado un documento, visto desde el documento. */
 export type DocumentCaseFileEntity = CaseFileLinkEntity;
+/** Estado de un enlace temporal: vigente, vencido o revocado. */
+export type CaseFileShareLinkStatus = 'Active' | 'Expired' | 'Revoked';
+/** Enlace temporal de un expediente, como lo ve su responsable. El token no se vuelve a mostrar. */
+export interface CaseFileShareLinkResponseEntity {
+    id: string;
+    recipient: string;
+    recipientEmail: string | null;
+    purpose: string | null;
+    allowExport: boolean;
+    expiresAt: string;
+    status: CaseFileShareLinkStatus;
+    createdByFullName: string;
+    createdAt: string;
+    revokedAt: string | null;
+    revokedByFullName: string | null;
+    /** Cuántas consultas, descargas y exportaciones se hicieron con él. */
+    accessCount: number;
+    lastAccessAt: string | null;
+}
+/** Enlace recién creado: el token va solo aquí; la dirección la arma quien lo muestra. */
+export interface CaseFileShareLinkCreateResponseEntity {
+    id: string;
+    token: string;
+    recipient: string;
+    recipientEmail: string | null;
+    purpose: string | null;
+    expiresAt: string;
+    /** Para avisarle al destinatario: qué expediente, de qué órgano y quién se lo comparte. */
+    caseFile: {
+        code: string;
+        title: string;
+    };
+    organName: string;
+    createdByFullName: string;
+}
+/** Actuación del índice como la ve el destinatario externo. */
+export interface CaseFileSharedEntryEntity {
+    id: string;
+    sequence: number;
+    folder: string | null;
+    kind: CaseFileEntryEntity['kind'];
+    actuationType: CaseFileEntryEntity['actuationType'];
+    title: string;
+    /** Tipo y número del documento («D.E. N° 590/2026») o el tipo declarado del archivo. */
+    reference: string | null;
+    originDate: string | null;
+    createdAt: string;
+    hasFile: boolean;
+    sha256: string | null;
+    hasAdvancedSignature: boolean;
+    physicalLocation: string | null;
+    pageCount: number | null;
+    voidedAt: string | null;
+    voidReason: string | null;
+}
+/** Expediente abierto con un enlace temporal: metadatos e índice, sin participantes ni registros internos. */
+export interface CaseFileSharedResponseEntity {
+    code: string;
+    title: string;
+    subject: string;
+    summary: string | null;
+    procedureName: string;
+    status: CaseFileEntity['status'];
+    organName: string;
+    responsibleFullName: string;
+    responsiblePosition: string | null;
+    createdAt: string;
+    closedAt: string | null;
+    recipient: string;
+    purpose: string | null;
+    expiresAt: string;
+    allowExport: boolean;
+    entries: CaseFileSharedEntryEntity[];
+}

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

@@ -115,6 +115,12 @@ export interface DocumentInboxItemEntity extends DocumentDeliveryResponseEntity
 export interface DocumentGetByIdResponseEntity {
     id: DocumentEntity['id'];
     issuerName: string;
+    archivalSeries: {
+        id: string;
+        code: string;
+        name: string;
+    } | null;
+    restrictionEndsAt: string | null;
     subject: DocumentEntity['subject'];
     keywords: DocumentEntity['keywords'];
     accessLevel: DocumentEntity['accessLevel'];
@@ -174,6 +180,7 @@ export interface DocumentGetByIdResponseEntity {
     /** Instituciones de DocDigital a quienes va dirigido, y su despacho por Oficina de Partes. */
     externalRecipients: DocumentExternalRecipientResponseEntity[];
     dispatch: DocumentDispatchResponseEntity | null;
+    emailCopies: DocumentEmailCopyResponseEntity[];
     documentType: DocumentTypeSummaryEntity;
     participants: DocumentParticipantResponseEntity[];
     attachments: {
@@ -403,3 +410,43 @@ export interface DocumentComposeResponseEntity {
     fileId?: string;
     contentBase64?: string;
 }
+/** Copia por correo de un documento, como la ve quien lo consulta en el gestor. */
+export interface DocumentEmailCopyResponseEntity {
+    id: string;
+    name: string;
+    email: string;
+    /** Cuándo se envió (sin valor: aún no corresponde). */
+    issuedAt: string | null;
+    expiresAt: string | null;
+    openedAt: string | null;
+    downloadCount: number;
+}
+/** Copia recién emitida: el gateway le envía el enlace a su destinatario. El token viaja solo aquí. */
+export interface DocumentEmailCopyIssuedEntity {
+    copyId: string;
+    documentId: string;
+    name: string;
+    email: string;
+    token: string;
+    expiresAt: string;
+    /** Cómo se cita: «D.E. N° 590/2026», o el tipo si no lleva número. */
+    folio: string;
+    subject: string;
+    issuerName: string;
+}
+/** El documento como lo ve quien abre su copia por correo. */
+export interface DocumentEmailCopyViewEntity {
+    recipientName: string;
+    expiresAt: string;
+    documentTypeName: string;
+    folio: string;
+    subject: string;
+    issuerName: string;
+    finishedAt: string | null;
+    verificationCode: string | null;
+    signers: {
+        fullName: string;
+        position: string | null;
+        signedAt: string | null;
+    }[];
+}

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

@@ -22,6 +22,11 @@ export interface DocumentTypeGetAllResponseEntity {
     resetsYearly: DocumentTypeEntity['resetsYearly'];
     numbered: DocumentTypeEntity['numbered'];
     directorateCodeReference: DocumentTypeEntity['directorateCodeReference'];
+    archivalSeries: {
+        id: string;
+        code: string;
+        name: string;
+    } | null;
     issuingEntity: {
         id: string;
         name: string;

package/dist/entities/index.d.ts

@@ -7,3 +7,5 @@ export * from './partsOffice';
 export * from './registerBook';
 export * from './signatureBatch';
 export * from './workFolder';
+export * from './scan';
+export * from './archivalSeries';

package/dist/entities/index.js

@@ -23,3 +23,5 @@ __exportStar(require("./partsOffice"), exports);
 __exportStar(require("./registerBook"), exports);
 __exportStar(require("./signatureBatch"), exports);
 __exportStar(require("./workFolder"), exports);
+__exportStar(require("./scan"), exports);
+__exportStar(require("./archivalSeries"), exports);

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

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

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

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

@@ -0,0 +1,29 @@
+/** Sesión recién abierta: el token y el QR viajan solo aquí. */
+export interface ScanSessionCreateResponseEntity {
+    id: string;
+    token: string;
+    /** Dirección que abre el celular, con el token. */
+    url: string;
+    /** El QR de esa dirección, como imagen PNG en data URL. */
+    qrDataUrl: string;
+    expiresAt: string;
+}
+/** Estado de la sesión, como lo ve en el escritorio quien la abrió. */
+export interface ScanSessionResponseEntity {
+    id: string;
+    status: 'Open' | 'Ready';
+    pageCount: number;
+    expiresAt: string;
+    fileName: string | null;
+}
+export interface ScanSessionFileResponseEntity {
+    fileId: string;
+    fileName: string;
+}
+/** La sesión como la ve el celular. */
+export interface ScanSessionPublicEntity {
+    status: 'Open' | 'Ready';
+    pageCount: number;
+    maxPages: number;
+    expiresAt: string;
+}

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

package/src/base/entities.ts

@@ -63,7 +63,9 @@ export type DocumentTrackingAction =
   | 'Reassigned'
   | 'Dispatched'
   | 'DispatchReturned'
-  | 'Received';
+  | 'Received'
+  | 'EmailCopySent'
+  | 'EmailCopyOpened';
 
 export const DocumentTrackingAction = {
   Created: 'Created',
@@ -83,6 +85,8 @@ export const DocumentTrackingAction = {
   Dispatched: 'Dispatched',
   DispatchReturned: 'DispatchReturned',
   Received: 'Received',
+  EmailCopySent: 'EmailCopySent',
+  EmailCopyOpened: 'EmailCopyOpened',
 } satisfies Record<string, DocumentTrackingAction>;
 
 export type DocumentOrigin = 'Internal' | 'DocDigital';
@@ -222,7 +226,9 @@ export type CaseFileTrackingAction =
   | 'ParticipantAdded'
   | 'ParticipantRemoved'
   | 'Closed'
-  | 'Exported';
+  | 'Exported'
+  | 'ShareLinkCreated'
+  | 'ShareLinkRevoked';
 
 export const CaseFileTrackingAction = {
   Created: 'Created',
@@ -234,6 +240,8 @@ export const CaseFileTrackingAction = {
   ParticipantRemoved: 'ParticipantRemoved',
   Closed: 'Closed',
   Exported: 'Exported',
+  ShareLinkCreated: 'ShareLinkCreated',
+  ShareLinkRevoked: 'ShareLinkRevoked',
 } satisfies Record<string, CaseFileTrackingAction>;
 
 export type CaseFileAccessAction = 'Viewed' | 'FileDownloaded' | 'Exported';
@@ -244,6 +252,13 @@ export const CaseFileAccessAction = {
   Exported: 'Exported',
 } satisfies Record<string, CaseFileAccessAction>;
 
+export type ScanSessionStatus = 'Open' | 'Ready';
+
+export const ScanSessionStatus = {
+  Open: 'Open',
+  Ready: 'Ready',
+} satisfies Record<string, ScanSessionStatus>;
+
 export type WorkFolderItemKind = 'Document' | 'File';
 
 export const WorkFolderItemKind = {
@@ -262,6 +277,8 @@ export interface DocumentTypeEntity {
   resetsYearly: boolean;
   numbered: boolean;
   directorateCodeReference?: number | null;
+  archivalSeries?: ArchivalSeriesEntity | null;
+  archivalSeriesId?: string | null;
   issuingEntity?: IssuingEntityEntity | null;
   issuingEntityId?: string | null;
   sharesNumberingWith?: DocumentTypeEntity | null;
@@ -283,6 +300,7 @@ export interface DocumentEntity {
   keywords: string[];
   accessLevel: DocumentAccessLevel;
   hasSensitiveData: boolean;
+  restrictionEndsAt?: string | null;
   status: DocumentStatus;
   correlative?: number | null;
   correlativeYear?: number | null;
@@ -327,6 +345,7 @@ export interface DocumentEntity {
   caseFileEntries?: CaseFileEntryEntity[];
   workFolderItems?: WorkFolderItemEntity[];
   externalRecipients?: DocumentExternalRecipientEntity[];
+  emailCopies?: DocumentEmailCopyEntity[];
   dispatch?: DocumentDispatchEntity | null;
   docDigitalInbound?: DocDigitalInboundEntity | null;
   deleted: boolean;
@@ -481,6 +500,9 @@ export interface CaseFileEntity {
   status: CaseFileStatus;
   accessLevel: DocumentAccessLevel;
   hasSensitiveData: boolean;
+  restrictionEndsAt?: string | null;
+  archivalSeries?: ArchivalSeriesEntity | null;
+  archivalSeriesId?: string | null;
   incorporationMechanism: CaseFileIncorporationMechanism;
   schemaVersion: string;
   procedure?: ProcedureEntity;
@@ -499,6 +521,7 @@ export interface CaseFileEntity {
   trackings?: CaseFileTrackingEntity[];
   metadataChanges?: CaseFileMetadataChangeEntity[];
   accesses?: CaseFileAccessEntity[];
+  shareLinks?: CaseFileShareLinkEntity[];
   createdAt: string;
   updatedAt: string;
   workFolder?: WorkFolderEntity | null;
@@ -590,13 +613,61 @@ export interface CaseFileAccessEntity {
   id: string;
   action: CaseFileAccessAction;
   entryId?: string | null;
-  employeeId: string;
+  employeeId?: string | null;
   employeeFullName: string;
+  shareLink?: CaseFileShareLinkEntity | null;
+  shareLinkId?: string | null;
   caseFile?: CaseFileEntity;
   caseFileId: string;
   createdAt: string;
 }
 
+export interface CaseFileShareLinkEntity {
+  id: string;
+  tokenHash: string;
+  recipient: string;
+  recipientEmail?: string | null;
+  purpose?: string | null;
+  allowExport: boolean;
+  expiresAt: string;
+  createdByEmployeeId: string;
+  createdByFullName: string;
+  revokedAt?: string | null;
+  revokedByEmployeeId?: string | null;
+  revokedByFullName?: string | null;
+  caseFile?: CaseFileEntity;
+  caseFileId: string;
+  accesses?: CaseFileAccessEntity[];
+  createdAt: string;
+}
+
+export interface DocumentEmailCopyEntity {
+  id: string;
+  name: string;
+  email: string;
+  tokenHash?: string | null;
+  expiresAt?: string | null;
+  issuedAt?: string | null;
+  openedAt?: string | null;
+  downloadCount: number;
+  document?: DocumentEntity;
+  documentId: string;
+  createdAt: string;
+}
+
+export interface ScanSessionEntity {
+  id: string;
+  tokenHash: string;
+  status: ScanSessionStatus;
+  employeeId: string;
+  pages: JsonValue;
+  fileId?: string | null;
+  fileName?: string | null;
+  expiresAt: string;
+  finishedAt?: string | null;
+  createdAt: string;
+}
+
 export interface DocumentExternalRecipientEntity {
   id: string;
   entityId: number;
@@ -665,6 +736,20 @@ export interface DocDigitalInboundEntity {
   updatedAt: string;
 }
 
+export interface ArchivalSeriesEntity {
+  id: string;
+  code: string;
+  name: string;
+  section?: string | null;
+  description?: string | null;
+  enabled: boolean;
+  documentTypes?: DocumentTypeEntity[];
+  caseFiles?: CaseFileEntity[];
+  deleted: boolean;
+  createdAt: string;
+  updatedAt: string;
+}
+
 export interface IssuingEntityEntity {
   id: string;
   name: string;

package/src/contracts/archivalSeries.contract.ts

@@ -0,0 +1,53 @@
+import { type ArchivalSeriesEntity } from '../base/entities';
+import {
+  type ArchivalSeriesCreateResponseEntity,
+  type ArchivalSeriesGetAllResponseEntity,
+  type ArchivalSeriesGetByIdResponseEntity,
+  type ArchivalSeriesUpdateResponseEntity,
+} from '../entities';
+import { type RpcPage } from './contract';
+
+/** Patrones NATS de `archivalSeries` (series del Cuadro de Clasificación): `<servicio>.<recurso>.<acción>`. */
+export const ArchivalSeriesPatterns = {
+  getAll: 'gestorDocumental.archivalSeries.getAll',
+  getById: 'gestorDocumental.archivalSeries.getById',
+  create: 'gestorDocumental.archivalSeries.create',
+  update: 'gestorDocumental.archivalSeries.update',
+  setEnabled: 'gestorDocumental.archivalSeries.setEnabled',
+} as const;
+
+/** Datos de una serie documental al crearla o editarla. */
+export interface ArchivalSeriesWritePayload {
+  code: string;
+  name: string;
+  section?: string | null;
+  description?: string | null;
+  enabled?: boolean;
+}
+
+export interface ArchivalSeriesContract {
+  [ArchivalSeriesPatterns.getAll]: {
+    // sin `page` y `limit` responde todas en una sola página
+    payload: {
+      pagination?: { page?: number; limit?: number };
+      filters?: { search?: string; enabled?: boolean };
+    };
+    response: RpcPage<ArchivalSeriesGetAllResponseEntity[]>;
+  };
+  [ArchivalSeriesPatterns.getById]: {
+    payload: Pick<ArchivalSeriesEntity, 'id'>;
+    response: ArchivalSeriesGetByIdResponseEntity;
+  };
+  [ArchivalSeriesPatterns.create]: {
+    payload: ArchivalSeriesWritePayload;
+    response: ArchivalSeriesCreateResponseEntity;
+  };
+  [ArchivalSeriesPatterns.update]: {
+    payload: ArchivalSeriesWritePayload & Pick<ArchivalSeriesEntity, 'id'>;
+    response: ArchivalSeriesUpdateResponseEntity;
+  };
+  [ArchivalSeriesPatterns.setEnabled]: {
+    payload: Pick<ArchivalSeriesEntity, 'id' | 'enabled'>;
+    response: ArchivalSeriesUpdateResponseEntity;
+  };
+}

package/src/contracts/caseFile.contract.ts

@@ -14,6 +14,9 @@ import {
   type CaseFileExportResponseEntity,
   type CaseFileGetAllResponseEntity,
   type CaseFileGetByIdResponseEntity,
+  type CaseFileShareLinkCreateResponseEntity,
+  type CaseFileShareLinkResponseEntity,
+  type CaseFileSharedResponseEntity,
   type CaseFileUpdateResponseEntity,
 } from '../entities';
 import { type RpcPage } from './contract';
@@ -34,8 +37,27 @@ export const CaseFilePatterns = {
   close: 'gestorDocumental.caseFile.close',
   getEntryFile: 'gestorDocumental.caseFile.getEntryFile',
   getExport: 'gestorDocumental.caseFile.getExport',
+  createShareLink: 'gestorDocumental.caseFile.createShareLink',
+  getShareLinks: 'gestorDocumental.caseFile.getShareLinks',
+  revokeShareLink: 'gestorDocumental.caseFile.revokeShareLink',
+  getShared: 'gestorDocumental.caseFile.getShared',
+  getSharedEntryFile: 'gestorDocumental.caseFile.getSharedEntryFile',
+  getSharedExport: 'gestorDocumental.caseFile.getSharedExport',
 } as const;
 
+/** Enlace temporal para que alguien de fuera consulte el expediente sin sesión. */
+export interface CaseFileShareLinkPayload {
+  /** A quién se entrega. Ej: «Contraloría Regional». */
+  recipient: string;
+  /** Si se indica, el gateway le envía el enlace por correo. */
+  recipientEmail?: string | null;
+  purpose?: string | null;
+  /** Cuántos días dura: de 1 a 30. */
+  days: number;
+  /** Puede descargar el expediente completo (ZIP). Por omisión, sí. */
+  allowExport?: boolean;
+}
+
 /** Persona u organización relacionada con el expediente (MGDEE54). */
 export interface CaseFileActorInput {
   relation: CaseFileActorRelation;
@@ -52,6 +74,10 @@ export interface CaseFileWritePayload {
   procedureId: string;
   accessLevel: DocumentAccessLevel;
   hasSensitiveData: boolean;
+  /** MGDEE8_2: fin de la restricción de acceso (ISO 8601), si no es público. */
+  restrictionEndsAt?: string | null;
+  /** MGDEE1_2: serie del Cuadro de Clasificación. */
+  archivalSeriesId?: string | null;
   actors?: CaseFileActorInput[];
 }
 
@@ -161,4 +187,32 @@ export interface CaseFileContract {
     payload: Pick<CaseFileEntity, 'id'> & CaseFileActorPayload;
     response: CaseFileExportResponseEntity;
   };
+  /** Crea un enlace temporal: solo su responsable. El token viaja solo en esta respuesta. */
+  [CaseFilePatterns.createShareLink]: {
+    payload: Pick<CaseFileEntity, 'id'> & CaseFileShareLinkPayload & { actor: DocumentActor };
+    response: CaseFileShareLinkCreateResponseEntity;
+  };
+  /** Enlaces del expediente, vigentes o no, con cuántas veces se usaron: su responsable o quien ve todos. */
+  [CaseFilePatterns.getShareLinks]: {
+    payload: Pick<CaseFileEntity, 'id'> & CaseFileActorPayload;
+    response: CaseFileShareLinkResponseEntity[];
+  };
+  [CaseFilePatterns.revokeShareLink]: {
+    payload: Pick<CaseFileEntity, 'id'> & { linkId: string; actor: DocumentActor };
+    response: CaseFileUpdateResponseEntity;
+  };
+  /** Sin sesión, con el token del enlace: metadatos e índice. Queda en el registro de accesos. */
+  [CaseFilePatterns.getShared]: {
+    payload: { token: string };
+    response: CaseFileSharedResponseEntity;
+  };
+  [CaseFilePatterns.getSharedEntryFile]: {
+    payload: { token: string; entryId: string };
+    response: CaseFileEntryFileResponseEntity;
+  };
+  /** El expediente completo, si el enlace lo permite. Queda en la trazabilidad y en el registro de accesos. */
+  [CaseFilePatterns.getSharedExport]: {
+    payload: { token: string };
+    response: CaseFileExportResponseEntity;
+  };
 }

package/src/contracts/document.contract.ts

@@ -13,6 +13,8 @@ import {
   type DocumentCreateResponseEntity,
   type DocumentDeriveResponseEntity,
   type DocumentDiscardResponseEntity,
+  type DocumentEmailCopyIssuedEntity,
+  type DocumentEmailCopyViewEntity,
   type DocumentGetAllResponseEntity,
   type DocumentGetByIdResponseEntity,
   type DocumentGetSummaryResponseEntity,
@@ -51,6 +53,9 @@ export const DocumentPatterns = {
   getAgenda: 'gestorDocumental.document.getAgenda',
   exportTrail: 'gestorDocumental.document.exportTrail',
   compose: 'gestorDocumental.document.compose',
+  issueEmailCopies: 'gestorDocumental.document.issueEmailCopies',
+  getEmailCopy: 'gestorDocumental.document.getEmailCopy',
+  getEmailCopyFile: 'gestorDocumental.document.getEmailCopyFile',
 } as const;
 
 /**
@@ -119,10 +124,20 @@ export interface DocumentWritePayload extends Pick<DocumentEntity, 'subject' | '
   replyToDocumentId?: string | null;
   // Instituciones (y usuarios) de DocDigital a quienes va: al terminar la firma pasa a Oficina de Partes.
   externalRecipients?: DocumentExternalRecipientInput[];
+  // Fin de la restricción de acceso (ISO 8601), si no es público.
+  restrictionEndsAt?: string | null;
+  // Copia por correo a quienes están fuera del Estado: sale al finalizar o, si también va por DocDigital, al despacharlo.
+  emailCopies?: DocumentEmailCopyInput[];
   action?: 'Submit';
   actor: DocumentActor;
 }
 
+/** Persona u organización fuera del Estado que recibe una copia por correo. */
+export interface DocumentEmailCopyInput {
+  name: string;
+  email: string;
+}
+
 /** Destinatario externo: una institución de DocDigital y, si se indica, uno de sus usuarios. */
 export interface DocumentExternalRecipientInput {
   entityId: number;
@@ -303,6 +318,23 @@ export interface DocumentContract {
     payload: { code: string };
     response: DocumentPublicFileResponseEntity;
   };
+  /**
+   * Emite las copias por correo pendientes de estos documentos, si ya corresponde (finalizado y, si va por DocDigital,
+   * despachado): genera el enlace de cada una. Se puede pedir de más: lo ya emitido no se repite.
+   */
+  [DocumentPatterns.issueEmailCopies]: {
+    payload: { documentIds: string[] };
+    response: DocumentEmailCopyIssuedEntity[];
+  };
+  /** Sin sesión, con el token de la copia: el documento y quién lo emitió. */
+  [DocumentPatterns.getEmailCopy]: {
+    payload: { token: string };
+    response: DocumentEmailCopyViewEntity;
+  };
+  [DocumentPatterns.getEmailCopyFile]: {
+    payload: { token: string };
+    response: DocumentPublicFileResponseEntity;
+  };
   /** Carpeta de Drive de los documentos y sus anexos: el gateway la pide antes de subir cada archivo. */
   [DocumentPatterns.getFilesFolder]: {
     payload: Record<string, never>;

package/src/contracts/documentType.contract.ts

@@ -41,6 +41,8 @@ export interface DocumentTypeWritePayload {
   // Sus documentos llevan número (por omisión, sí).
   numbered?: boolean;
   directorateCodeReference?: number | null;
+  // Serie documental del Cuadro de Clasificación (sin valor: sin clasificar).
+  archivalSeriesId?: string | null;
   // Entidad emisora (sin valor: la municipalidad).
   issuingEntityId?: string | null;
   // Tipo cuyo correlativo comparte (sin valor: el suyo propio).