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

package/dist/base/entities.d.ts

@@ -33,7 +33,7 @@ export declare const DocumentParticipantStatus: {
     Resolved: "Resolved";
     Rejected: "Rejected";
 };
-export type DocumentTrackingAction = 'Created' | 'Updated' | 'Submitted' | 'Visaed' | 'Signed' | 'Rejected' | 'Finished' | 'Discarded' | 'Numbered' | 'NumberAnnulled' | 'Annulled' | 'Delivered' | 'Derived' | 'Reassigned' | 'Dispatched' | 'DispatchReturned' | 'Received';
+export type DocumentTrackingAction = 'Created' | 'Updated' | 'Submitted' | 'Visaed' | 'Signed' | 'Rejected' | 'Finished' | 'Discarded' | 'Numbered' | 'NumberAnnulled' | 'Annulled' | 'Delivered' | 'Derived' | 'Reassigned' | 'Dispatched' | 'DispatchReturned' | 'Received' | 'EmailCopySent' | 'EmailCopyOpened';
 export declare const DocumentTrackingAction: {
     Created: "Created";
     Updated: "Updated";
@@ -52,6 +52,8 @@ export declare const DocumentTrackingAction: {
     Dispatched: "Dispatched";
     DispatchReturned: "DispatchReturned";
     Received: "Received";
+    EmailCopySent: "EmailCopySent";
+    EmailCopyOpened: "EmailCopyOpened";
 };
 export type DocumentOrigin = 'Internal' | 'DocDigital';
 export declare const DocumentOrigin: {
@@ -144,7 +146,7 @@ export declare const CaseFileActorType: {
     PrivateInstitution: "PrivateInstitution";
     Official: "Official";
 };
-export type CaseFileTrackingAction = 'Created' | 'Updated' | 'EntryAdded' | 'EntryVoided' | 'EntryMoved' | 'ParticipantAdded' | 'ParticipantRemoved' | 'Closed' | 'Exported';
+export type CaseFileTrackingAction = 'Created' | 'Updated' | 'EntryAdded' | 'EntryVoided' | 'EntryMoved' | 'ParticipantAdded' | 'ParticipantRemoved' | 'Closed' | 'Exported' | 'ShareLinkCreated' | 'ShareLinkRevoked';
 export declare const CaseFileTrackingAction: {
     Created: "Created";
     Updated: "Updated";
@@ -155,6 +157,8 @@ export declare const CaseFileTrackingAction: {
     ParticipantRemoved: "ParticipantRemoved";
     Closed: "Closed";
     Exported: "Exported";
+    ShareLinkCreated: "ShareLinkCreated";
+    ShareLinkRevoked: "ShareLinkRevoked";
 };
 export type CaseFileAccessAction = 'Viewed' | 'FileDownloaded' | 'Exported';
 export declare const CaseFileAccessAction: {
@@ -242,6 +246,7 @@ export interface DocumentEntity {
     caseFileEntries?: CaseFileEntryEntity[];
     workFolderItems?: WorkFolderItemEntity[];
     externalRecipients?: DocumentExternalRecipientEntity[];
+    emailCopies?: DocumentEmailCopyEntity[];
     dispatch?: DocumentDispatchEntity | null;
     docDigitalInbound?: DocDigitalInboundEntity | null;
     deleted: boolean;
@@ -403,6 +408,7 @@ export interface CaseFileEntity {
     trackings?: CaseFileTrackingEntity[];
     metadataChanges?: CaseFileMetadataChangeEntity[];
     accesses?: CaseFileAccessEntity[];
+    shareLinks?: CaseFileShareLinkEntity[];
     createdAt: string;
     updatedAt: string;
     workFolder?: WorkFolderEntity | null;
@@ -488,10 +494,43 @@ 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 DocumentExternalRecipientEntity {

package/dist/base/entities.js

@@ -50,6 +50,8 @@ exports.DocumentTrackingAction = {
     Dispatched: 'Dispatched',
     DispatchReturned: 'DispatchReturned',
     Received: 'Received',
+    EmailCopySent: 'EmailCopySent',
+    EmailCopyOpened: 'EmailCopyOpened',
 };
 exports.DocumentOrigin = {
     Internal: 'Internal',
@@ -138,6 +140,8 @@ exports.CaseFileTrackingAction = {
     ParticipantRemoved: 'ParticipantRemoved',
     Closed: 'Closed',
     Exported: 'Exported',
+    ShareLinkCreated: 'ShareLinkCreated',
+    ShareLinkRevoked: 'ShareLinkRevoked',
 };
 exports.CaseFileAccessAction = {
     Viewed: 'Viewed',

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

@@ -1,5 +1,5 @@
 import { type CaseFileActorRelation, type CaseFileActorType, type CaseFileActuationType, type CaseFileEntity, type CaseFileStatus, type DocumentAccessLevel } from '../base/entities';
-import { type CaseFileAddBatchResponseEntity, type CaseFileAddEntryResponseEntity, type CaseFileCreateResponseEntity, type CaseFileEntryFileResponseEntity, type CaseFileExportResponseEntity, type CaseFileGetAllResponseEntity, type CaseFileGetByIdResponseEntity, type CaseFileUpdateResponseEntity } from '../entities';
+import { type CaseFileAddBatchResponseEntity, type CaseFileAddEntryResponseEntity, type CaseFileCreateResponseEntity, type CaseFileEntryFileResponseEntity, type CaseFileExportResponseEntity, type CaseFileGetAllResponseEntity, type CaseFileGetByIdResponseEntity, type CaseFileShareLinkCreateResponseEntity, type CaseFileShareLinkResponseEntity, type CaseFileSharedResponseEntity, type CaseFileUpdateResponseEntity } from '../entities';
 import { type RpcPage } from './contract';
 import { type DocumentActor } from './document.contract';
 /** Patrones NATS de `caseFile`: `<servicio>.<recurso>.<acción>`. */
@@ -17,7 +17,25 @@ export declare const CaseFilePatterns: {
     readonly close: "gestorDocumental.caseFile.close";
     readonly getEntryFile: "gestorDocumental.caseFile.getEntryFile";
     readonly getExport: "gestorDocumental.caseFile.getExport";
+    readonly createShareLink: "gestorDocumental.caseFile.createShareLink";
+    readonly getShareLinks: "gestorDocumental.caseFile.getShareLinks";
+    readonly revokeShareLink: "gestorDocumental.caseFile.revokeShareLink";
+    readonly getShared: "gestorDocumental.caseFile.getShared";
+    readonly getSharedEntryFile: "gestorDocumental.caseFile.getSharedEntryFile";
+    readonly getSharedExport: "gestorDocumental.caseFile.getSharedExport";
 };
+/** 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;
@@ -181,5 +199,45 @@ 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;
+    };
 }
 export {};

package/dist/contracts/caseFile.contract.js

@@ -16,4 +16,10 @@ exports.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',
 };

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

@@ -1,5 +1,5 @@
 import { type DocumentAccessLevel, type DocumentAttachmentEntity, type DocumentDeliveryEntity, type DocumentEntity, type DocumentInstruction, type DocumentParticipantEntity, type DocumentStatus } from '../base/entities';
-import { type DocumentAnnulResponseEntity, type DocumentCloseDeliveryResponseEntity, type DocumentCreateResponseEntity, type DocumentDeriveResponseEntity, type DocumentDiscardResponseEntity, type DocumentGetAllResponseEntity, type DocumentGetByIdResponseEntity, type DocumentGetSummaryResponseEntity, type DocumentInboxItemEntity, type DocumentPublicFileResponseEntity, type DocumentReassignResponseEntity, type DocumentReviewResponseEntity, type DocumentSignManyResponseEntity, type DocumentAgendaResponseEntity, type DocumentComposeResponseEntity, type DocumentComposition, type DocumentTrailExportEntity, type DocumentUpdateResponseEntity, type DocumentVerifyResponseEntity } from '../entities';
+import { type DocumentAnnulResponseEntity, type DocumentCloseDeliveryResponseEntity, type DocumentCreateResponseEntity, type DocumentDeriveResponseEntity, type DocumentDiscardResponseEntity, type DocumentEmailCopyIssuedEntity, type DocumentEmailCopyViewEntity, type DocumentGetAllResponseEntity, type DocumentGetByIdResponseEntity, type DocumentGetSummaryResponseEntity, type DocumentInboxItemEntity, type DocumentPublicFileResponseEntity, type DocumentReassignResponseEntity, type DocumentReviewResponseEntity, type DocumentSignManyResponseEntity, type DocumentAgendaResponseEntity, type DocumentComposeResponseEntity, type DocumentComposition, type DocumentTrailExportEntity, type DocumentUpdateResponseEntity, type DocumentVerifyResponseEntity } from '../entities';
 import { type RpcPage } from './contract';
 /** Patrones NATS de `document`: `<servicio>.<recurso>.<acción>`. */
 export declare const DocumentPatterns: {
@@ -22,6 +22,9 @@ export declare const DocumentPatterns: {
     readonly getAgenda: "gestorDocumental.document.getAgenda";
     readonly exportTrail: "gestorDocumental.document.exportTrail";
     readonly compose: "gestorDocumental.document.compose";
+    readonly issueEmailCopies: "gestorDocumental.document.issueEmailCopies";
+    readonly getEmailCopy: "gestorDocumental.document.getEmailCopy";
+    readonly getEmailCopyFile: "gestorDocumental.document.getEmailCopyFile";
 };
 /**
  * Funcionario que hace la operación y sus áreas (direcciones y departamentos a los que pertenece o que dirige). Lo
@@ -81,9 +84,15 @@ export interface DocumentWritePayload extends Pick<DocumentEntity, 'subject' | '
     responseDueAt?: string | null;
     replyToDocumentId?: string | null;
     externalRecipients?: DocumentExternalRecipientInput[];
+    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;
@@ -295,6 +304,29 @@ export interface DocumentContract {
         };
         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/dist/contracts/document.contract.js

@@ -22,4 +22,7 @@ exports.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',
 };

package/dist/contracts/index.d.ts

@@ -46,6 +46,9 @@ export declare const GestorDocumentalPatterns: {
         readonly getAgenda: "gestorDocumental.document.getAgenda";
         readonly exportTrail: "gestorDocumental.document.exportTrail";
         readonly compose: "gestorDocumental.document.compose";
+        readonly issueEmailCopies: "gestorDocumental.document.issueEmailCopies";
+        readonly getEmailCopy: "gestorDocumental.document.getEmailCopy";
+        readonly getEmailCopyFile: "gestorDocumental.document.getEmailCopyFile";
     };
     readonly procedure: {
         readonly getAll: "gestorDocumental.procedure.getAll";
@@ -75,6 +78,12 @@ export declare const GestorDocumentalPatterns: {
         readonly close: "gestorDocumental.caseFile.close";
         readonly getEntryFile: "gestorDocumental.caseFile.getEntryFile";
         readonly getExport: "gestorDocumental.caseFile.getExport";
+        readonly createShareLink: "gestorDocumental.caseFile.createShareLink";
+        readonly getShareLinks: "gestorDocumental.caseFile.getShareLinks";
+        readonly revokeShareLink: "gestorDocumental.caseFile.revokeShareLink";
+        readonly getShared: "gestorDocumental.caseFile.getShared";
+        readonly getSharedEntryFile: "gestorDocumental.caseFile.getSharedEntryFile";
+        readonly getSharedExport: "gestorDocumental.caseFile.getSharedExport";
     };
     readonly partsOffice: {
         readonly getStatus: "gestorDocumental.partsOffice.getStatus";

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 {
@@ -182,3 +185,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

@@ -174,6 +174,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 +404,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@muni-sanfer/types-gestor-documental",
-  "version": "0.0.1-beta.14",
+  "version": "0.0.1-beta.15",
   "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';
@@ -327,6 +335,7 @@ export interface DocumentEntity {
   caseFileEntries?: CaseFileEntryEntity[];
   workFolderItems?: WorkFolderItemEntity[];
   externalRecipients?: DocumentExternalRecipientEntity[];
+  emailCopies?: DocumentEmailCopyEntity[];
   dispatch?: DocumentDispatchEntity | null;
   docDigitalInbound?: DocDigitalInboundEntity | null;
   deleted: boolean;
@@ -499,6 +508,7 @@ export interface CaseFileEntity {
   trackings?: CaseFileTrackingEntity[];
   metadataChanges?: CaseFileMetadataChangeEntity[];
   accesses?: CaseFileAccessEntity[];
+  shareLinks?: CaseFileShareLinkEntity[];
   createdAt: string;
   updatedAt: string;
   workFolder?: WorkFolderEntity | null;
@@ -590,10 +600,45 @@ 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;
 }
 

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;
@@ -161,4 +183,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,18 @@ 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[];
+  // 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 +316,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/entities/caseFile/caseFile.entity.ts

@@ -121,7 +121,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'];
 }
 
@@ -210,3 +213,79 @@ 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/src/entities/document/document.entity.ts

@@ -199,6 +199,8 @@ export interface DocumentGetByIdResponseEntity {
   /** Instituciones de DocDigital a quienes va dirigido, y su despacho por Oficina de Partes. */
   externalRecipients: DocumentExternalRecipientResponseEntity[];
   dispatch: DocumentDispatchResponseEntity | null;
+  // Copias por correo a quienes están fuera del Estado, con su envío y apertura.
+  emailCopies: DocumentEmailCopyResponseEntity[];
   documentType: DocumentTypeSummaryEntity;
   participants: DocumentParticipantResponseEntity[];
   attachments: {
@@ -450,3 +452,42 @@ 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 }[];
+}