@muni-sanfer/types-gestor-documental 0.0.1-beta.43 → 0.0.1-beta.45

package/dist/base/entities.d.ts

@@ -205,6 +205,11 @@ export declare const TextSnippetSection: {
     Body: "Body";
     Closing: "Closing";
 };
+export type HolidaySource = 'Manual' | 'Api';
+export declare const HolidaySource: {
+    Manual: "Manual";
+    Api: "Api";
+};
 export type WorkFolderItemKind = 'Document' | 'File';
 export declare const WorkFolderItemKind: {
     Document: "Document";
@@ -458,6 +463,7 @@ export interface DocumentTypeEntity {
 export interface DocumentEntity {
     id: string;
     subject: string;
+    description?: string | null;
     keywords: string[];
     accessLevel: DocumentAccessLevel;
     hasSensitiveData: boolean;
@@ -471,6 +477,9 @@ export interface DocumentEntity {
     annulledAt?: string | null;
     annulmentReason?: string | null;
     responseDueAt?: string | null;
+    responseDueBusinessDays?: number | null;
+    procedure?: ProcedureEntity | null;
+    procedureId?: string | null;
     origin: DocumentOrigin;
     intakeNumber?: number | null;
     intakeYear?: number | null;
@@ -653,6 +662,7 @@ export interface ProcedureEntity {
     description?: string | null;
     enabled: boolean;
     caseFiles?: CaseFileEntity[];
+    documents?: DocumentEntity[];
     deleted: boolean;
     createdAt: string;
     updatedAt: string;
@@ -910,7 +920,16 @@ export interface HolidayEntity {
     id: string;
     date: string;
     name: string;
+    source: HolidaySource;
+    kind?: string | null;
+    excluded: boolean;
     createdAt: string;
+    updatedAt: string;
+}
+export interface HolidaySyncEntity {
+    year: number;
+    syncedAt: string;
+    total: number;
 }
 export interface TextSnippetEntity {
     id: string;

package/dist/base/entities.js

@@ -1,8 +1,8 @@
 "use strict";
 // This file was auto-generated by prisma-generator-typescript-interfaces
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DeskFileSource = exports.DataBreachNoticeMeans = exports.DataBreachEventAction = exports.DataBreachStatus = exports.DataBreachKind = exports.DataRightsEventAction = exports.DataRightsResolution = exports.DataRightsRequestStatus = exports.DataRightsChannel = exports.DataRight = exports.DataLegalBasis = exports.TransparencyStatus = exports.AccessRequestEventAction = exports.AccessRequestResolution = exports.AccessRequestStatus = exports.AccessRequestChannel = exports.DispositionKind = exports.FinalDisposition = exports.AuditAction = exports.AuditEntity = exports.DocumentAccessAction = exports.QualityMetricKey = exports.ServiceOutageKind = exports.WorkFolderItemKind = exports.TextSnippetSection = exports.ScanSessionStatus = exports.CaseFileAccessAction = exports.CaseFileTrackingAction = exports.CaseFileActorType = exports.CaseFileActorRelation = exports.CaseFileEntryKind = exports.CaseFileActuationType = exports.CaseFileIncorporationMechanism = exports.CaseFileStatus = exports.DocumentInstruction = exports.DocumentDeliveryOrigin = exports.DocumentRecipientType = exports.DocumentAttachmentType = exports.DocumentFlowStepType = exports.DocDigitalInboundStatus = exports.DocumentDispatchStatus = exports.CommunicationMeans = exports.DocumentOrigin = exports.DraftReviewStatus = exports.DocumentTrackingAction = exports.DocumentParticipantStatus = exports.DocumentParticipantRole = exports.DocumentAccessLevel = exports.DocumentStatus = exports.DocumentCategory = void 0;
-exports.DraftingRequestEventAction = exports.DraftingRequestStatus = exports.MailAuthentication = exports.MailIntakeStatus = exports.DeskFileTarget = void 0;
+exports.DataBreachNoticeMeans = exports.DataBreachEventAction = exports.DataBreachStatus = exports.DataBreachKind = exports.DataRightsEventAction = exports.DataRightsResolution = exports.DataRightsRequestStatus = exports.DataRightsChannel = exports.DataRight = exports.DataLegalBasis = exports.TransparencyStatus = exports.AccessRequestEventAction = exports.AccessRequestResolution = exports.AccessRequestStatus = exports.AccessRequestChannel = exports.DispositionKind = exports.FinalDisposition = exports.AuditAction = exports.AuditEntity = exports.DocumentAccessAction = exports.QualityMetricKey = exports.ServiceOutageKind = exports.WorkFolderItemKind = exports.HolidaySource = exports.TextSnippetSection = exports.ScanSessionStatus = exports.CaseFileAccessAction = exports.CaseFileTrackingAction = exports.CaseFileActorType = exports.CaseFileActorRelation = exports.CaseFileEntryKind = exports.CaseFileActuationType = exports.CaseFileIncorporationMechanism = exports.CaseFileStatus = exports.DocumentInstruction = exports.DocumentDeliveryOrigin = exports.DocumentRecipientType = exports.DocumentAttachmentType = exports.DocumentFlowStepType = exports.DocDigitalInboundStatus = exports.DocumentDispatchStatus = exports.CommunicationMeans = exports.DocumentOrigin = exports.DraftReviewStatus = exports.DocumentTrackingAction = exports.DocumentParticipantStatus = exports.DocumentParticipantRole = exports.DocumentAccessLevel = exports.DocumentStatus = exports.DocumentCategory = void 0;
+exports.DraftingRequestEventAction = exports.DraftingRequestStatus = exports.MailAuthentication = exports.MailIntakeStatus = exports.DeskFileTarget = exports.DeskFileSource = void 0;
 exports.DocumentCategory = {
     Decree: 'Decree',
     Communication: 'Communication',
@@ -184,6 +184,10 @@ exports.TextSnippetSection = {
     Body: 'Body',
     Closing: 'Closing',
 };
+exports.HolidaySource = {
+    Manual: 'Manual',
+    Api: 'Api',
+};
 exports.WorkFolderItemKind = {
     Document: 'Document',
     File: 'File',

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

@@ -78,6 +78,10 @@ export type DocumentReviewAction = 'Visa' | 'Sign' | 'Reject';
  */
 export interface DocumentWritePayload extends Pick<DocumentEntity, 'subject' | 'documentTypeId'> {
     keywords: string[];
+    /** Resumen breve (hasta 250 caracteres): va a DocDigital como «descripcion» al despacharlo. */
+    description?: string | null;
+    /** Procedimiento administrativo del catálogo propio. */
+    procedureId?: string | null;
     /** Qué cambió, si el guardado crea una versión nueva (otro PDF, otro texto u otro asunto). */
     versionNote?: string | null;
     /** Al crearlo: solicitud de redacción que atiende (la tomó quien redacta). */
@@ -99,6 +103,7 @@ export interface DocumentWritePayload extends Pick<DocumentEntity, 'subject' | '
     signatureSheet?: boolean;
     recipients?: DocumentRecipientInput[];
     responseDueAt?: string | null;
+    responseDueBusinessDays?: number | null;
     replyToDocumentId?: string | null;
     externalRecipients?: DocumentExternalRecipientInput[];
     restrictionEndsAt?: string | null;

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

@@ -1,19 +1,20 @@
-import { type HolidayRemoveResponseEntity, type HolidayResponseEntity } from '../entities';
+import { type HolidayListResponseEntity, type HolidayRemoveResponseEntity, type HolidayResponseEntity, type HolidaySyncResponseEntity } from '../entities';
 /** Patrones NATS de `holiday`: feriados para contar días hábiles. */
 export declare const HolidayPatterns: {
     readonly getAll: "gestorDocumental.holiday.getAll";
     readonly create: "gestorDocumental.holiday.create";
     readonly remove: "gestorDocumental.holiday.remove";
+    readonly sync: "gestorDocumental.holiday.sync";
 };
 export interface HolidayContract {
-    /** Feriados de un año, en orden. */
+    /** Feriados de un año, en orden (también los de la API que se quitaron a mano). */
     [HolidayPatterns.getAll]: {
         payload: {
             year: number;
         };
-        response: HolidayResponseEntity[];
+        response: HolidayListResponseEntity;
     };
-    /** `date` como «AAAA-MM-DD». */
+    /** `date` como «AAAA-MM-DD». Si es uno de la API que se había quitado, vuelve a contar. */
     [HolidayPatterns.create]: {
         payload: {
             date: string;
@@ -21,10 +22,18 @@ export interface HolidayContract {
         };
         response: HolidayResponseEntity;
     };
+    /** Uno cargado a mano se borra; uno de la API se marca como quitado. */
     [HolidayPatterns.remove]: {
         payload: {
             id: string;
         };
         response: HolidayRemoveResponseEntity;
     };
+    /** Trae de la API pública los feriados de un año. Lo cargado o quitado a mano se respeta. */
+    [HolidayPatterns.sync]: {
+        payload: {
+            year: number;
+        };
+        response: HolidaySyncResponseEntity;
+    };
 }

package/dist/contracts/holiday.contract.js

@@ -6,4 +6,5 @@ exports.HolidayPatterns = {
     getAll: 'gestorDocumental.holiday.getAll',
     create: 'gestorDocumental.holiday.create',
     remove: 'gestorDocumental.holiday.remove',
+    sync: 'gestorDocumental.holiday.sync',
 };

package/dist/contracts/index.d.ts

@@ -214,6 +214,7 @@ export declare const GestorDocumentalPatterns: {
         readonly getAll: "gestorDocumental.holiday.getAll";
         readonly create: "gestorDocumental.holiday.create";
         readonly remove: "gestorDocumental.holiday.remove";
+        readonly sync: "gestorDocumental.holiday.sync";
     };
     readonly indicators: {
         readonly getManagement: "gestorDocumental.indicators.getManagement";

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

@@ -138,6 +138,14 @@ export interface DocumentGetByIdResponseEntity {
     } | null;
     restrictionEndsAt: string | null;
     subject: DocumentEntity['subject'];
+    /** Resumen breve; va a DocDigital como «descripcion» al despacharlo. */
+    description: string | null;
+    /** Procedimiento administrativo al que corresponde. */
+    procedure: {
+        id: string;
+        name: string;
+        cpatCode: string | null;
+    } | null;
     keywords: DocumentEntity['keywords'];
     accessLevel: DocumentEntity['accessLevel'];
     hasSensitiveData: DocumentEntity['hasSensitiveData'];
@@ -173,6 +181,7 @@ export interface DocumentGetByIdResponseEntity {
         createdAt: DocumentAnnulledNumberEntity['createdAt'];
     }[];
     responseDueAt: DocumentEntity['responseDueAt'];
+    responseDueBusinessDays: number | null;
     recipients: DocumentRecipientResponseEntity[];
     deliveries: DocumentDeliveryResponseEntity[];
     replyTo: DocumentLinkEntity | null;

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

@@ -1,10 +1,32 @@
+import { type HolidaySource } from '../../base/entities';
 /** Feriado: el día («AAAA-MM-DD») no cuenta como hábil en los plazos. */
 export interface HolidayResponseEntity {
     id: string;
     date: string;
     name: string;
+    /** Cargado a mano o traído de la API pública de feriados. */
+    source: HolidaySource;
+    /** Como lo informa la API. Ej: «Civil e Irrenunciable». */
+    kind: string | null;
+    /** Uno de la API que se quitó a mano: no cuenta, y la próxima actualización no lo vuelve a agregar. */
+    excluded: boolean;
+}
+/** Feriados de un año y cuándo se trajeron de la API por última vez (`null` si nunca). */
+export interface HolidayListResponseEntity {
+    holidays: HolidayResponseEntity[];
+    syncedAt: string | null;
 }
 export interface HolidayRemoveResponseEntity {
     id: string;
     ok: boolean;
 }
+/** Resultado de traer de la API los feriados de un año: los agregados, actualizados y quitados por la API. */
+export interface HolidaySyncResponseEntity {
+    year: number;
+    added: number;
+    updated: number;
+    removed: number;
+    /** Cuántos informó la API para ese año. */
+    total: number;
+    syncedAt: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@muni-sanfer/types-gestor-documental",
-  "version": "0.0.1-beta.43",
+  "version": "0.0.1-beta.45",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {

package/src/base/entities.ts

@@ -310,6 +310,13 @@ export const TextSnippetSection = {
   Closing: 'Closing',
 } satisfies Record<string, TextSnippetSection>;
 
+export type HolidaySource = 'Manual' | 'Api';
+
+export const HolidaySource = {
+  Manual: 'Manual',
+  Api: 'Api',
+} satisfies Record<string, HolidaySource>;
+
 export type WorkFolderItemKind = 'Document' | 'File';
 
 export const WorkFolderItemKind = {
@@ -663,6 +670,7 @@ export interface DocumentTypeEntity {
 export interface DocumentEntity {
   id: string;
   subject: string;
+  description?: string | null;
   keywords: string[];
   accessLevel: DocumentAccessLevel;
   hasSensitiveData: boolean;
@@ -676,6 +684,9 @@ export interface DocumentEntity {
   annulledAt?: string | null;
   annulmentReason?: string | null;
   responseDueAt?: string | null;
+  responseDueBusinessDays?: number | null;
+  procedure?: ProcedureEntity | null;
+  procedureId?: string | null;
   origin: DocumentOrigin;
   intakeNumber?: number | null;
   intakeYear?: number | null;
@@ -867,6 +878,7 @@ export interface ProcedureEntity {
   description?: string | null;
   enabled: boolean;
   caseFiles?: CaseFileEntity[];
+  documents?: DocumentEntity[];
   deleted: boolean;
   createdAt: string;
   updatedAt: string;
@@ -1139,7 +1151,17 @@ export interface HolidayEntity {
   id: string;
   date: string;
   name: string;
+  source: HolidaySource;
+  kind?: string | null;
+  excluded: boolean;
   createdAt: string;
+  updatedAt: string;
+}
+
+export interface HolidaySyncEntity {
+  year: number;
+  syncedAt: string;
+  total: number;
 }
 
 export interface TextSnippetEntity {

package/src/contracts/document.contract.ts

@@ -118,6 +118,10 @@ export type DocumentReviewAction = 'Visa' | 'Sign' | 'Reject';
  */
 export interface DocumentWritePayload extends Pick<DocumentEntity, 'subject' | 'documentTypeId'> {
   keywords: string[];
+  /** Resumen breve (hasta 250 caracteres): va a DocDigital como «descripcion» al despacharlo. */
+  description?: string | null;
+  /** Procedimiento administrativo del catálogo propio. */
+  procedureId?: string | null;
   /** Qué cambió, si el guardado crea una versión nueva (otro PDF, otro texto u otro asunto). */
   versionNote?: string | null;
   /** Al crearlo: solicitud de redacción que atiende (la tomó quien redacta). */
@@ -142,8 +146,9 @@ export interface DocumentWritePayload extends Pick<DocumentEntity, 'subject' | '
   signatureSheet?: boolean;
   // A quién va dirigido: le llega a su bandeja cuando el documento termina su tramitación.
   recipients?: DocumentRecipientInput[];
-  // Plazo en que se espera respuesta de los destinatarios (ISO 8601).
+  // Plazo en que se espera respuesta de los destinatarios (ISO 8601), o en días hábiles desde que lo reciben (uno u otro).
   responseDueAt?: string | null;
+  responseDueBusinessDays?: number | null;
   // Documento al que este responde.
   replyToDocumentId?: string | null;
   // Instituciones (y usuarios) de DocDigital a quienes va: al terminar la firma pasa a Oficina de Partes.

package/src/contracts/holiday.contract.ts

@@ -1,16 +1,25 @@
-import { type HolidayRemoveResponseEntity, type HolidayResponseEntity } from '../entities';
+import {
+  type HolidayListResponseEntity,
+  type HolidayRemoveResponseEntity,
+  type HolidayResponseEntity,
+  type HolidaySyncResponseEntity,
+} 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',
+  sync: 'gestorDocumental.holiday.sync',
 } as const;
 
 export interface HolidayContract {
-  /** Feriados de un año, en orden. */
-  [HolidayPatterns.getAll]: { payload: { year: number }; response: HolidayResponseEntity[] };
-  /** `date` como «AAAA-MM-DD». */
+  /** Feriados de un año, en orden (también los de la API que se quitaron a mano). */
+  [HolidayPatterns.getAll]: { payload: { year: number }; response: HolidayListResponseEntity };
+  /** `date` como «AAAA-MM-DD». Si es uno de la API que se había quitado, vuelve a contar. */
   [HolidayPatterns.create]: { payload: { date: string; name: string }; response: HolidayResponseEntity };
+  /** Uno cargado a mano se borra; uno de la API se marca como quitado. */
   [HolidayPatterns.remove]: { payload: { id: string }; response: HolidayRemoveResponseEntity };
+  /** Trae de la API pública los feriados de un año. Lo cargado o quitado a mano se respeta. */
+  [HolidayPatterns.sync]: { payload: { year: number }; response: HolidaySyncResponseEntity };
 }

package/src/entities/document/document.entity.ts

@@ -162,6 +162,10 @@ export interface DocumentGetByIdResponseEntity {
   // Fin de la restricción de acceso: desde entonces se consulta como público si no tiene datos sensibles.
   restrictionEndsAt: string | null;
   subject: DocumentEntity['subject'];
+  /** Resumen breve; va a DocDigital como «descripcion» al despacharlo. */
+  description: string | null;
+  /** Procedimiento administrativo al que corresponde. */
+  procedure: { id: string; name: string; cpatCode: string | null } | null;
   keywords: DocumentEntity['keywords'];
   accessLevel: DocumentEntity['accessLevel'];
   hasSensitiveData: DocumentEntity['hasSensitiveData'];
@@ -202,8 +206,10 @@ export interface DocumentGetByIdResponseEntity {
     employeeFullName: DocumentAnnulledNumberEntity['employeeFullName'];
     createdAt: DocumentAnnulledNumberEntity['createdAt'];
   }[];
-  // Plazo en que el redactor espera respuesta de los destinatarios.
+  // Plazo en que el redactor espera respuesta de los destinatarios: una fecha o, mientras no se finaliza, N días
+  // hábiles desde que lo reciban (al finalizar queda la fecha en `responseDueAt`).
   responseDueAt: DocumentEntity['responseDueAt'];
+  responseDueBusinessDays: number | null;
   // A quién va dirigido, como lo indicó el redactor (personas y áreas).
   recipients: DocumentRecipientResponseEntity[];
   // En la bandeja de quién está: destinatarios y derivaciones, con su lectura y atención.

package/src/entities/holiday/holiday.entity.ts

@@ -1,11 +1,36 @@
+import { type HolidaySource } from '../../base/entities';
+
 /** Feriado: el día («AAAA-MM-DD») no cuenta como hábil en los plazos. */
 export interface HolidayResponseEntity {
   id: string;
   date: string;
   name: string;
+  /** Cargado a mano o traído de la API pública de feriados. */
+  source: HolidaySource;
+  /** Como lo informa la API. Ej: «Civil e Irrenunciable». */
+  kind: string | null;
+  /** Uno de la API que se quitó a mano: no cuenta, y la próxima actualización no lo vuelve a agregar. */
+  excluded: boolean;
+}
+
+/** Feriados de un año y cuándo se trajeron de la API por última vez (`null` si nunca). */
+export interface HolidayListResponseEntity {
+  holidays: HolidayResponseEntity[];
+  syncedAt: string | null;
 }
 
 export interface HolidayRemoveResponseEntity {
   id: string;
   ok: boolean;
 }
+
+/** Resultado de traer de la API los feriados de un año: los agregados, actualizados y quitados por la API. */
+export interface HolidaySyncResponseEntity {
+  year: number;
+  added: number;
+  updated: number;
+  removed: number;
+  /** Cuántos informó la API para ese año. */
+  total: number;
+  syncedAt: string;
+}