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

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

@@ -22,6 +22,19 @@ export interface DocumentTypeGetAllResponseEntity {
     resetsYearly: DocumentTypeEntity['resetsYearly'];
     numbered: DocumentTypeEntity['numbered'];
     directorateCodeReference: DocumentTypeEntity['directorateCodeReference'];
+    issuingEntity: {
+        id: string;
+        name: string;
+        shortName: string | null;
+    } | null;
+    sharesNumberingWith: {
+        id: string;
+        name: string;
+    } | null;
+    numberingMembers: {
+        id: string;
+        name: string;
+    }[];
     enabled: DocumentTypeEntity['enabled'];
     flow: {
         visa: number;

package/dist/entities/index.d.ts

@@ -1,6 +1,7 @@
 export * from './documentType';
 export * from './document';
 export * from './procedure';
+export * from './issuingEntity';
 export * from './caseFile';
 export * from './partsOffice';
 export * from './registerBook';

package/dist/entities/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./documentType"), exports);
 __exportStar(require("./document"), exports);
 __exportStar(require("./procedure"), exports);
+__exportStar(require("./issuingEntity"), exports);
 __exportStar(require("./caseFile"), exports);
 __exportStar(require("./partsOffice"), exports);
 __exportStar(require("./registerBook"), exports);

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

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

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

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

@@ -0,0 +1,20 @@
+import { IssuingEntityEntity } from '../../base/entities';
+export interface IssuingEntityGetAllResponseEntity {
+    id: IssuingEntityEntity['id'];
+    name: IssuingEntityEntity['name'];
+    shortName: IssuingEntityEntity['shortName'];
+    directorateCodeReferences: IssuingEntityEntity['directorateCodeReferences'];
+    docDigitalEntityId: IssuingEntityEntity['docDigitalEntityId'];
+    enabled: IssuingEntityEntity['enabled'];
+    /** Cuántos tipos documentales emite. */
+    documentTypes: number;
+}
+export type IssuingEntityGetByIdResponseEntity = IssuingEntityGetAllResponseEntity;
+export interface IssuingEntityCreateResponseEntity {
+    id: IssuingEntityEntity['id'];
+    ok: boolean;
+}
+export interface IssuingEntityUpdateResponseEntity {
+    id: IssuingEntityEntity['id'];
+    ok: boolean;
+}

package/dist/entities/issuingEntity/issuingEntity.entity.js

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

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

@@ -32,6 +32,8 @@ export interface PartsOfficeDispatchEntity extends DocumentDispatchResponseEntit
         accessLevel: string;
     };
     externalRecipients: DocumentExternalRecipientResponseEntity[];
+    /** A nombre de quién sale: la entidad emisora del tipo documental o la municipalidad. */
+    issuerName: string;
     createdAt: string;
 }
 /** Documento que llegó por DocDigital. */
@@ -45,6 +47,8 @@ export interface PartsOfficeInboundEntity {
     folioDate: string | null;
     typeName: string | null;
     reserved: boolean;
+    /** Entidad propia a la que llegó (la municipalidad o una entidad emisora). */
+    recipientEntityName: string | null;
     senderEntityName: string | null;
     senderName: string | null;
     senderPosition: string | null;

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

@@ -24,11 +24,17 @@ export interface RegisterBookRowEntity {
     dispatch: string | null;
     /** Motivo de la anulación (del documento o del número). */
     observation: string | null;
+    /** Numeración compartida: tipo documental del número (`null` en un salto o si el libro es de un solo tipo). */
+    documentTypeName: string | null;
 }
 export interface RegisterBookEntity {
     kind: RegisterBookKind;
     /** «Decreto alcaldicio exento» o «Ingresos de Oficina de Partes». */
     title: string;
+    /** Quién lleva el libro: la entidad emisora del tipo o la municipalidad. */
+    issuerName: string;
+    /** Numeración compartida: los tipos que numeran en la serie del libro (vacío si es de un solo tipo). */
+    series: string[];
     year: number;
     month: number | null;
     rows: RegisterBookRowEntity[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@muni-sanfer/types-gestor-documental",
-  "version": "0.0.1-beta.13",
+  "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';
@@ -262,6 +270,11 @@ export interface DocumentTypeEntity {
   resetsYearly: boolean;
   numbered: boolean;
   directorateCodeReference?: number | null;
+  issuingEntity?: IssuingEntityEntity | null;
+  issuingEntityId?: string | null;
+  sharesNumberingWith?: DocumentTypeEntity | null;
+  sharesNumberingWithId?: string | null;
+  numberingMembers?: DocumentTypeEntity[];
   enabled: boolean;
   documents?: DocumentEntity[];
   annulledNumbers?: DocumentAnnulledNumberEntity[];
@@ -322,6 +335,7 @@ export interface DocumentEntity {
   caseFileEntries?: CaseFileEntryEntity[];
   workFolderItems?: WorkFolderItemEntity[];
   externalRecipients?: DocumentExternalRecipientEntity[];
+  emailCopies?: DocumentEmailCopyEntity[];
   dispatch?: DocumentDispatchEntity | null;
   docDigitalInbound?: DocDigitalInboundEntity | null;
   deleted: boolean;
@@ -494,6 +508,7 @@ export interface CaseFileEntity {
   trackings?: CaseFileTrackingEntity[];
   metadataChanges?: CaseFileMetadataChangeEntity[];
   accesses?: CaseFileAccessEntity[];
+  shareLinks?: CaseFileShareLinkEntity[];
   createdAt: string;
   updatedAt: string;
   workFolder?: WorkFolderEntity | null;
@@ -585,13 +600,48 @@ 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 {
   id: string;
   entityId: number;
@@ -640,6 +690,8 @@ export interface DocDigitalInboundEntity {
   senderEntityName?: string | null;
   senderName?: string | null;
   senderPosition?: string | null;
+  recipientEntityId?: number | null;
+  recipientEntityName?: string | null;
   fileId?: string | null;
   fileName?: string | null;
   attachments: JsonValue;
@@ -658,6 +710,19 @@ export interface DocDigitalInboundEntity {
   updatedAt: string;
 }
 
+export interface IssuingEntityEntity {
+  id: string;
+  name: string;
+  shortName?: string | null;
+  directorateCodeReferences: number[];
+  docDigitalEntityId?: number | null;
+  enabled: boolean;
+  documentTypes?: DocumentTypeEntity[];
+  deleted: boolean;
+  createdAt: string;
+  updatedAt: string;
+}
+
 export interface IntakeSequenceEntity {
   year: number;
   next: number;

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/contracts/documentType.contract.ts

@@ -41,6 +41,10 @@ export interface DocumentTypeWritePayload {
   // Sus documentos llevan número (por omisión, sí).
   numbered?: boolean;
   directorateCodeReference?: number | null;
+  // Entidad emisora (sin valor: la municipalidad).
+  issuingEntityId?: string | null;
+  // Tipo cuyo correlativo comparte (sin valor: el suyo propio).
+  sharesNumberingWithId?: string | null;
   enabled?: boolean;
   // Flujo sugerido, en el orden en que les toca dentro de cada rol. Al editar, si no viene, el flujo no cambia.
   flowSteps?: DocumentFlowStepInput[];
@@ -58,7 +62,8 @@ export interface DocumentTypeContract {
         search?: string;
         enabled?: boolean;
         category?: DocumentCategory;
-        // Solo los que puede usar quien redacta: los de toda la municipalidad y los de estas direcciones.
+        // Solo los que puede usar quien redacta: los de toda la municipalidad y los de estas direcciones (o de una
+        // entidad emisora por la que actúan).
         usableByDirectorates?: number[];
       };
     };

package/src/contracts/index.ts

@@ -1,6 +1,7 @@
 import { CaseFilePatterns, type CaseFileContract } from './caseFile.contract';
 import { DocumentPatterns, type DocumentContract } from './document.contract';
 import { DocumentTypePatterns, type DocumentTypeContract } from './documentType.contract';
+import { IssuingEntityPatterns, type IssuingEntityContract } from './issuingEntity.contract';
 import { PartsOfficePatterns, type PartsOfficeContract } from './partsOffice.contract';
 import { ProcedurePatterns, type ProcedureContract } from './procedure.contract';
 import { RegisterBookPatterns, type RegisterBookContract } from './registerBook.contract';
@@ -11,6 +12,7 @@ export * from './contract';
 export * from './document.contract';
 export * from './documentType.contract';
 export * from './procedure.contract';
+export * from './issuingEntity.contract';
 export * from './caseFile.contract';
 export * from './partsOffice.contract';
 export * from './registerBook.contract';
@@ -22,6 +24,7 @@ export const GestorDocumentalPatterns = {
   documentType: DocumentTypePatterns,
   document: DocumentPatterns,
   procedure: ProcedurePatterns,
+  issuingEntity: IssuingEntityPatterns,
   caseFile: CaseFilePatterns,
   partsOffice: PartsOfficePatterns,
   registerBook: RegisterBookPatterns,
@@ -33,6 +36,7 @@ export const GestorDocumentalPatterns = {
 export type GestorDocumentalContract = DocumentTypeContract &
   DocumentContract &
   ProcedureContract &
+  IssuingEntityContract &
   CaseFileContract &
   PartsOfficeContract &
   RegisterBookContract &

package/src/contracts/issuingEntity.contract.ts

@@ -0,0 +1,55 @@
+import { type IssuingEntityEntity } from '../base/entities';
+import {
+  type IssuingEntityCreateResponseEntity,
+  type IssuingEntityGetAllResponseEntity,
+  type IssuingEntityGetByIdResponseEntity,
+  type IssuingEntityUpdateResponseEntity,
+} from '../entities';
+import { type RpcPage } from './contract';
+
+/** Patrones NATS de `issuingEntity`: `<servicio>.<recurso>.<acción>`. */
+export const IssuingEntityPatterns = {
+  getAll: 'gestorDocumental.issuingEntity.getAll',
+  getById: 'gestorDocumental.issuingEntity.getById',
+  create: 'gestorDocumental.issuingEntity.create',
+  update: 'gestorDocumental.issuingEntity.update',
+  setEnabled: 'gestorDocumental.issuingEntity.setEnabled',
+} as const;
+
+/** Datos de una entidad emisora al crearla o editarla. */
+export interface IssuingEntityWritePayload {
+  name: string;
+  shortName?: string | null;
+  /** Direcciones (código de caschile) cuyos funcionarios actúan por la entidad. */
+  directorateCodeReferences: number[];
+  /** Su entidad en DocDigital, entre las asociadas a las credenciales del gestor. */
+  docDigitalEntityId?: number | null;
+  enabled?: boolean;
+}
+
+export interface IssuingEntityContract {
+  [IssuingEntityPatterns.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<IssuingEntityGetAllResponseEntity[]>;
+  };
+  [IssuingEntityPatterns.getById]: {
+    payload: Pick<IssuingEntityEntity, 'id'>;
+    response: IssuingEntityGetByIdResponseEntity;
+  };
+  [IssuingEntityPatterns.create]: {
+    payload: IssuingEntityWritePayload;
+    response: IssuingEntityCreateResponseEntity;
+  };
+  [IssuingEntityPatterns.update]: {
+    payload: IssuingEntityWritePayload & Pick<IssuingEntityEntity, 'id'>;
+    response: IssuingEntityUpdateResponseEntity;
+  };
+  [IssuingEntityPatterns.setEnabled]: {
+    payload: Pick<IssuingEntityEntity, 'id' | 'enabled'>;
+    response: IssuingEntityUpdateResponseEntity;
+  };
+}

package/src/contracts/partsOffice.contract.ts

@@ -20,6 +20,7 @@ export const PartsOfficePatterns = {
   getStatus: 'gestorDocumental.partsOffice.getStatus',
   getSummary: 'gestorDocumental.partsOffice.getSummary',
   getEntities: 'gestorDocumental.partsOffice.getEntities',
+  getOwnEntities: 'gestorDocumental.partsOffice.getOwnEntities',
   getUsers: 'gestorDocumental.partsOffice.getUsers',
   getDocumentTypes: 'gestorDocumental.partsOffice.getDocumentTypes',
   getDispatches: 'gestorDocumental.partsOffice.getDispatches',
@@ -51,6 +52,8 @@ export interface PartsOfficeContract {
   [PartsOfficePatterns.getSummary]: { payload: Record<string, never>; response: PartsOfficeSummaryEntity };
   /** Directorio de DocDigital: instituciones por nombre. */
   [PartsOfficePatterns.getEntities]: { payload: { search?: string }; response: DocDigitalEntityEntity[] };
+  /** Entidades asociadas a las credenciales del gestor: la del municipio y las de sus entidades emisoras. */
+  [PartsOfficePatterns.getOwnEntities]: { payload: Record<string, never>; response: DocDigitalEntityEntity[] };
   [PartsOfficePatterns.getUsers]: {
     payload: { entityId: number; search?: string };
     response: DocDigitalUserEntity[];

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[];
+}