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

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

@@ -109,12 +109,24 @@ export interface DocumentGetAllResponseEntity {
     } | null;
 }
 /** Una entrada de la bandeja de recibidos: la entrega y el documento al que corresponde. */
+/** Semáforo de un plazo pendiente: a tiempo, por vencer (2 días hábiles o menos) o vencido. */
+export type DocumentDueStatus = 'OnTime' | 'DueSoon' | 'Overdue';
 export interface DocumentInboxItemEntity extends DocumentDeliveryResponseEntity {
+    /** Semáforo de lo pendiente con plazo (sin plazo o ya atendido, `null`). */
+    dueStatus: DocumentDueStatus | null;
+    /** Días hábiles que quedan, sin contar hoy (vencido: `null`). */
+    businessDaysLeft: number | null;
     document: DocumentLinkEntity;
 }
 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'];
@@ -322,6 +334,10 @@ export interface DocumentReassignResponseEntity {
  */
 export interface DocumentAgendaItemEntity {
     kind: 'Received' | 'Sent';
+    /** Semáforo de lo pendiente (atendido o ya respondido por todos: `null`). */
+    dueStatus: DocumentDueStatus | null;
+    /** Días hábiles que quedan, sin contar hoy (vencido: `null`). */
+    businessDaysLeft: number | null;
     /** La entrega (lo recibido) o el documento (lo enviado). */
     id: string;
     documentId: DocumentEntity['id'];
@@ -444,3 +460,17 @@ export interface DocumentEmailCopyViewEntity {
         signedAt: string | null;
     }[];
 }
+/** Recordatorio de un plazo: al recibido y, si venció, también a su jefatura (la resuelve el gateway). */
+export interface DocumentReminderEntity {
+    deliveryId: string;
+    kind: 'DueSoon' | 'Overdue';
+    employeeId: string;
+    fullName: string;
+    documentId: string;
+    /** Cómo se cita: «D.E. N° 590/2026», el folio de ingreso o el tipo. */
+    folio: string;
+    subject: string;
+    dueAt: string;
+    instruction: DocumentDeliveryEntity['instruction'];
+    sentByFullName: 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/holiday/holiday.entity.d.ts

@@ -0,0 +1,10 @@
+/** Feriado: el día («AAAA-MM-DD») no cuenta como hábil en los plazos. */
+export interface HolidayResponseEntity {
+    id: string;
+    date: string;
+    name: string;
+}
+export interface HolidayRemoveResponseEntity {
+    id: string;
+    ok: boolean;
+}

package/dist/entities/holiday/holiday.entity.js

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

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

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

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

package/dist/entities/index.d.ts

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

package/dist/entities/index.js

@@ -23,3 +23,7 @@ __exportStar(require("./partsOffice"), exports);
 __exportStar(require("./registerBook"), exports);
 __exportStar(require("./signatureBatch"), exports);
 __exportStar(require("./workFolder"), exports);
+__exportStar(require("./scan"), exports);
+__exportStar(require("./archivalSeries"), exports);
+__exportStar(require("./textSnippet"), exports);
+__exportStar(require("./holiday"), 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/dist/entities/textSnippet/index.d.ts

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

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

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

@@ -0,0 +1,20 @@
+import { TextSnippetEntity } from '../../base/entities';
+/** Texto de la biblioteca de vistos y cláusulas. */
+export interface TextSnippetGetAllResponseEntity {
+    id: TextSnippetEntity['id'];
+    title: TextSnippetEntity['title'];
+    text: TextSnippetEntity['text'];
+    section: TextSnippetEntity['section'];
+    keywords: TextSnippetEntity['keywords'];
+    enabled: TextSnippetEntity['enabled'];
+    updatedAt: TextSnippetEntity['updatedAt'];
+}
+export type TextSnippetGetByIdResponseEntity = TextSnippetGetAllResponseEntity;
+export interface TextSnippetCreateResponseEntity {
+    id: TextSnippetEntity['id'];
+    ok: boolean;
+}
+export interface TextSnippetUpdateResponseEntity {
+    id: TextSnippetEntity['id'];
+    ok: boolean;
+}

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

package/src/base/entities.ts

@@ -252,6 +252,23 @@ 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 TextSnippetSection = 'Vistos' | 'Considerando' | 'Resolutive' | 'Body' | 'Closing';
+
+export const TextSnippetSection = {
+  Vistos: 'Vistos',
+  Considerando: 'Considerando',
+  Resolutive: 'Resolutive',
+  Body: 'Body',
+  Closing: 'Closing',
+} satisfies Record<string, TextSnippetSection>;
+
 export type WorkFolderItemKind = 'Document' | 'File';
 
 export const WorkFolderItemKind = {
@@ -270,6 +287,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;
@@ -291,6 +310,7 @@ export interface DocumentEntity {
   keywords: string[];
   accessLevel: DocumentAccessLevel;
   hasSensitiveData: boolean;
+  restrictionEndsAt?: string | null;
   status: DocumentStatus;
   correlative?: number | null;
   correlativeYear?: number | null;
@@ -441,6 +461,8 @@ export interface DocumentDeliveryEntity {
   readAt?: string | null;
   closedAt?: string | null;
   closingNote?: string | null;
+  dueSoonRemindedAt?: string | null;
+  overdueRemindedAt?: string | null;
   document?: DocumentEntity;
   documentId: string;
   createdAt: string;
@@ -490,6 +512,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;
@@ -642,6 +667,19 @@ export interface DocumentEmailCopyEntity {
   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;
@@ -710,6 +748,39 @@ export interface DocDigitalInboundEntity {
   updatedAt: string;
 }
 
+export interface HolidayEntity {
+  id: string;
+  date: string;
+  name: string;
+  createdAt: string;
+}
+
+export interface TextSnippetEntity {
+  id: string;
+  title: string;
+  text: string;
+  section: TextSnippetSection;
+  keywords: string[];
+  enabled: boolean;
+  deleted: boolean;
+  createdAt: string;
+  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

@@ -74,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[];
 }
 

package/src/contracts/document.contract.ts

@@ -15,6 +15,7 @@ import {
   type DocumentDiscardResponseEntity,
   type DocumentEmailCopyIssuedEntity,
   type DocumentEmailCopyViewEntity,
+  type DocumentReminderEntity,
   type DocumentGetAllResponseEntity,
   type DocumentGetByIdResponseEntity,
   type DocumentGetSummaryResponseEntity,
@@ -56,6 +57,7 @@ export const DocumentPatterns = {
   issueEmailCopies: 'gestorDocumental.document.issueEmailCopies',
   getEmailCopy: 'gestorDocumental.document.getEmailCopy',
   getEmailCopyFile: 'gestorDocumental.document.getEmailCopyFile',
+  claimReminders: 'gestorDocumental.document.claimReminders',
 } as const;
 
 /**
@@ -124,6 +126,8 @@ 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';
@@ -296,6 +300,8 @@ export interface DocumentContract {
       note?: string | null;
       // Plazo para atenderlo (ISO 8601).
       dueAt?: string | null;
+      // O el plazo en días hábiles (Ley 19.880): el servicio calcula la fecha con los feriados cargados.
+      dueBusinessDays?: number | null;
       actor: DocumentActor;
       viewAll?: boolean;
     };
@@ -329,6 +335,14 @@ export interface DocumentContract {
     payload: { token: string };
     response: DocumentEmailCopyViewEntity;
   };
+  /**
+   * Recordatorios de plazos que corresponde enviar ahora: lo que vence en un día hábil y lo vencido sin atender. Cada
+   * uno se entrega una sola vez (queda marcado al reclamarlo), aunque lo pidan varias instancias del gateway a la vez.
+   */
+  [DocumentPatterns.claimReminders]: {
+    payload: Record<string, never>;
+    response: DocumentReminderEntity[];
+  };
   [DocumentPatterns.getEmailCopyFile]: {
     payload: { token: string };
     response: DocumentPublicFileResponseEntity;

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).

package/src/contracts/holiday.contract.ts

@@ -0,0 +1,16 @@
+import { type HolidayRemoveResponseEntity, type HolidayResponseEntity } from '../entities';
+
+/** Patrones NATS de `holiday`: feriados para contar días hábiles. */
+export const HolidayPatterns = {
+  getAll: 'gestorDocumental.holiday.getAll',
+  create: 'gestorDocumental.holiday.create',
+  remove: 'gestorDocumental.holiday.remove',
+} as const;
+
+export interface HolidayContract {
+  /** Feriados de un año, en orden. */
+  [HolidayPatterns.getAll]: { payload: { year: number }; response: HolidayResponseEntity[] };
+  /** `date` como «AAAA-MM-DD». */
+  [HolidayPatterns.create]: { payload: { date: string; name: string }; response: HolidayResponseEntity };
+  [HolidayPatterns.remove]: { payload: { id: string }; response: HolidayRemoveResponseEntity };
+}

package/src/contracts/index.ts

@@ -2,6 +2,10 @@ 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 { ArchivalSeriesPatterns, type ArchivalSeriesContract } from './archivalSeries.contract';
+import { TextSnippetPatterns, type TextSnippetContract } from './textSnippet.contract';
+import { HolidayPatterns, type HolidayContract } from './holiday.contract';
+import { ScanPatterns, type ScanContract } from './scan.contract';
 import { PartsOfficePatterns, type PartsOfficeContract } from './partsOffice.contract';
 import { ProcedurePatterns, type ProcedureContract } from './procedure.contract';
 import { RegisterBookPatterns, type RegisterBookContract } from './registerBook.contract';
@@ -18,6 +22,10 @@ export * from './partsOffice.contract';
 export * from './registerBook.contract';
 export * from './signatureBatch.contract';
 export * from './workFolder.contract';
+export * from './scan.contract';
+export * from './archivalSeries.contract';
+export * from './textSnippet.contract';
+export * from './holiday.contract';
 
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export const GestorDocumentalPatterns = {
@@ -30,6 +38,10 @@ export const GestorDocumentalPatterns = {
   registerBook: RegisterBookPatterns,
   signatureBatch: SignatureBatchPatterns,
   workFolder: WorkFolderPatterns,
+  scan: ScanPatterns,
+  archivalSeries: ArchivalSeriesPatterns,
+  textSnippet: TextSnippetPatterns,
+  holiday: HolidayPatterns,
 } as const;
 
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
@@ -41,4 +53,8 @@ export type GestorDocumentalContract = DocumentTypeContract &
   PartsOfficeContract &
   RegisterBookContract &
   SignatureBatchContract &
-  WorkFolderContract;
+  WorkFolderContract &
+  ScanContract &
+  ArchivalSeriesContract &
+  TextSnippetContract &
+  HolidayContract;

package/src/contracts/scan.contract.ts

@@ -0,0 +1,52 @@
+import {
+  type ScanSessionCreateResponseEntity,
+  type ScanSessionFileResponseEntity,
+  type ScanSessionPublicEntity,
+  type ScanSessionResponseEntity,
+} from '../entities';
+import { type DocumentActor } from './document.contract';
+
+/** Patrones NATS de `scan`: escanear con el celular. */
+export const ScanPatterns = {
+  create: 'gestorDocumental.scan.create',
+  getById: 'gestorDocumental.scan.getById',
+  getFile: 'gestorDocumental.scan.getFile',
+  getByToken: 'gestorDocumental.scan.getByToken',
+  addPage: 'gestorDocumental.scan.addPage',
+  finish: 'gestorDocumental.scan.finish',
+} as const;
+
+export interface ScanContract {
+  /**
+   * Abre una sesión de escaneo para el funcionario. `url` es la dirección pública del celular (sin el token): con ella
+   * se arma el QR que se muestra en el escritorio.
+   */
+  [ScanPatterns.create]: {
+    payload: { url: string; actor: DocumentActor };
+    response: ScanSessionCreateResponseEntity;
+  };
+  /** Estado de la sesión, para quien la abrió: el escritorio la consulta hasta que el PDF esté listo. */
+  [ScanPatterns.getById]: {
+    payload: { id: string; actor: DocumentActor };
+    response: ScanSessionResponseEntity;
+  };
+  [ScanPatterns.getFile]: {
+    payload: { id: string; actor: DocumentActor };
+    response: ScanSessionFileResponseEntity;
+  };
+  /** Sin sesión, desde el celular, con el token del QR. */
+  [ScanPatterns.getByToken]: {
+    payload: { token: string };
+    response: ScanSessionPublicEntity;
+  };
+  /** Agrega una foto ya subida al gestor de archivos (la sube el gateway). */
+  [ScanPatterns.addPage]: {
+    payload: { token: string; fileId: string; contentType: string; size: number };
+    response: ScanSessionPublicEntity;
+  };
+  /** Junta las fotos en un PDF y cierra la sesión. */
+  [ScanPatterns.finish]: {
+    payload: { token: string };
+    response: ScanSessionPublicEntity;
+  };
+}

package/src/contracts/textSnippet.contract.ts

@@ -0,0 +1,53 @@
+import { type TextSnippetEntity, type TextSnippetSection } from '../base/entities';
+import {
+  type TextSnippetCreateResponseEntity,
+  type TextSnippetGetAllResponseEntity,
+  type TextSnippetGetByIdResponseEntity,
+  type TextSnippetUpdateResponseEntity,
+} from '../entities';
+import { type RpcPage } from './contract';
+
+/** Patrones NATS de `textSnippet` (biblioteca de vistos y cláusulas): `<servicio>.<recurso>.<acción>`. */
+export const TextSnippetPatterns = {
+  getAll: 'gestorDocumental.textSnippet.getAll',
+  getById: 'gestorDocumental.textSnippet.getById',
+  create: 'gestorDocumental.textSnippet.create',
+  update: 'gestorDocumental.textSnippet.update',
+  setEnabled: 'gestorDocumental.textSnippet.setEnabled',
+} as const;
+
+/** Datos de un texto de la biblioteca al crearlo o editarlo. */
+export interface TextSnippetWritePayload {
+  title: string;
+  text: string;
+  section: TextSnippetSection;
+  keywords?: string[];
+  enabled?: boolean;
+}
+
+export interface TextSnippetContract {
+  [TextSnippetPatterns.getAll]: {
+    // sin `page` y `limit` responde todas en una sola página
+    payload: {
+      pagination?: { page?: number; limit?: number };
+      filters?: { search?: string; enabled?: boolean; section?: TextSnippetSection };
+    };
+    response: RpcPage<TextSnippetGetAllResponseEntity[]>;
+  };
+  [TextSnippetPatterns.getById]: {
+    payload: Pick<TextSnippetEntity, 'id'>;
+    response: TextSnippetGetByIdResponseEntity;
+  };
+  [TextSnippetPatterns.create]: {
+    payload: TextSnippetWritePayload;
+    response: TextSnippetCreateResponseEntity;
+  };
+  [TextSnippetPatterns.update]: {
+    payload: TextSnippetWritePayload & Pick<TextSnippetEntity, 'id'>;
+    response: TextSnippetUpdateResponseEntity;
+  };
+  [TextSnippetPatterns.setEnabled]: {
+    payload: Pick<TextSnippetEntity, 'id' | 'enabled'>;
+    response: TextSnippetUpdateResponseEntity;
+  };
+}