@muni-sanfer/types-gestor-documental 0.0.1-beta.2 → 0.0.1-beta.4

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

@@ -0,0 +1,50 @@
+import { type ProcedureEntity } from '../base/entities';
+import { type ProcedureCreateResponseEntity, type ProcedureGetAllResponseEntity, type ProcedureGetByIdResponseEntity, type ProcedureUpdateResponseEntity } from '../entities';
+import { type RpcPage } from './contract';
+/** Patrones NATS de `procedure`: `<servicio>.<recurso>.<acción>`. */
+export declare const ProcedurePatterns: {
+    readonly getAll: "gestorDocumental.procedure.getAll";
+    readonly getById: "gestorDocumental.procedure.getById";
+    readonly create: "gestorDocumental.procedure.create";
+    readonly update: "gestorDocumental.procedure.update";
+    readonly setEnabled: "gestorDocumental.procedure.setEnabled";
+};
+/** Datos de un procedimiento administrativo al crearlo o editarlo. */
+export interface ProcedureWritePayload {
+    name: string;
+    cpatId?: string | null;
+    cpatCode?: string | null;
+    description?: string | null;
+    enabled?: boolean;
+}
+export interface ProcedureContract {
+    [ProcedurePatterns.getAll]: {
+        payload: {
+            pagination?: {
+                page?: number;
+                limit?: number;
+            };
+            filters?: {
+                search?: string;
+                enabled?: boolean;
+            };
+        };
+        response: RpcPage<ProcedureGetAllResponseEntity[]>;
+    };
+    [ProcedurePatterns.getById]: {
+        payload: Pick<ProcedureEntity, 'id'>;
+        response: ProcedureGetByIdResponseEntity;
+    };
+    [ProcedurePatterns.create]: {
+        payload: ProcedureWritePayload;
+        response: ProcedureCreateResponseEntity;
+    };
+    [ProcedurePatterns.update]: {
+        payload: ProcedureWritePayload & Pick<ProcedureEntity, 'id'>;
+        response: ProcedureUpdateResponseEntity;
+    };
+    [ProcedurePatterns.setEnabled]: {
+        payload: Pick<ProcedureEntity, 'id' | 'enabled'>;
+        response: ProcedureUpdateResponseEntity;
+    };
+}

package/dist/contracts/procedure.contract.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcedurePatterns = void 0;
+/** Patrones NATS de `procedure`: `<servicio>.<recurso>.<acción>`. */
+exports.ProcedurePatterns = {
+    getAll: 'gestorDocumental.procedure.getAll',
+    getById: 'gestorDocumental.procedure.getById',
+    create: 'gestorDocumental.procedure.create',
+    update: 'gestorDocumental.procedure.update',
+    setEnabled: 'gestorDocumental.procedure.setEnabled',
+};

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

@@ -0,0 +1,169 @@
+import { CaseFileAccessEntity, CaseFileActorEntity, CaseFileEntity, CaseFileEntryEntity, CaseFileMetadataChangeEntity, CaseFileParticipantEntity, CaseFileTrackingEntity, DocumentEntity, ProcedureEntity } from '../../base/entities';
+import { DocumentTypeSummaryEntity } from '../document';
+/** Expediente al que se hace referencia desde otro lado: cómo se cita y en qué estado está. */
+export interface CaseFileLinkEntity {
+    id: CaseFileEntity['id'];
+    code: CaseFileEntity['code'];
+    title: CaseFileEntity['title'];
+    status: CaseFileEntity['status'];
+}
+export interface CaseFileGetAllResponseEntity extends CaseFileLinkEntity {
+    subject: CaseFileEntity['subject'];
+    accessLevel: CaseFileEntity['accessLevel'];
+    hasSensitiveData: CaseFileEntity['hasSensitiveData'];
+    procedure: Pick<ProcedureEntity, 'id' | 'name'>;
+    responsibleEmployeeId: CaseFileEntity['responsibleEmployeeId'];
+    responsibleFullName: CaseFileEntity['responsibleFullName'];
+    /** Actuaciones vigentes del índice (las que quedaron sin efecto no cuentan). */
+    entries: number;
+    participants: number;
+    createdAt: CaseFileEntity['createdAt'];
+    closedAt: CaseFileEntity['closedAt'];
+}
+/** Documento del gestor incorporado al expediente. */
+export interface CaseFileEntryDocumentEntity {
+    id: DocumentEntity['id'];
+    subject: DocumentEntity['subject'];
+    status: DocumentEntity['status'];
+    correlative: DocumentEntity['correlative'];
+    correlativeYear: DocumentEntity['correlativeYear'];
+    documentType: DocumentTypeSummaryEntity;
+}
+/** Entrada del índice electrónico: una actuación, en su orden de incorporación. */
+export interface CaseFileEntryResponseEntity {
+    id: CaseFileEntryEntity['id'];
+    sequence: CaseFileEntryEntity['sequence'];
+    kind: CaseFileEntryEntity['kind'];
+    actuationType: CaseFileEntryEntity['actuationType'];
+    title: CaseFileEntryEntity['title'];
+    document: CaseFileEntryDocumentEntity | null;
+    fileName: CaseFileEntryEntity['fileName'];
+    documentTypeName: CaseFileEntryEntity['documentTypeName'];
+    originDate: CaseFileEntryEntity['originDate'];
+    author: CaseFileEntryEntity['author'];
+    keywords: CaseFileEntryEntity['keywords'];
+    accessLevel: CaseFileEntryEntity['accessLevel'];
+    hasSensitiveData: CaseFileEntryEntity['hasSensitiveData'];
+    linkedCaseFile: CaseFileLinkEntity | null;
+    /** `true` si la entrada tiene un archivo que se puede abrir (un documento o un archivo subido). */
+    hasFile: boolean;
+    sha256: CaseFileEntryEntity['sha256'];
+    size: CaseFileEntryEntity['size'];
+    hasAdvancedSignature: CaseFileEntryEntity['hasAdvancedSignature'];
+    incorporatedByEmployeeId: CaseFileEntryEntity['incorporatedByEmployeeId'];
+    incorporatedByFullName: CaseFileEntryEntity['incorporatedByFullName'];
+    createdAt: CaseFileEntryEntity['createdAt'];
+    voidedAt: CaseFileEntryEntity['voidedAt'];
+    voidedByFullName: CaseFileEntryEntity['voidedByFullName'];
+    voidReason: CaseFileEntryEntity['voidReason'];
+    /** `true` si quien consulta puede dejarla sin efecto: el responsable o quien la incorporó, con el expediente abierto. */
+    canVoid: boolean;
+}
+export interface CaseFileParticipantResponseEntity {
+    id: CaseFileParticipantEntity['id'];
+    employeeId: CaseFileParticipantEntity['employeeId'];
+    fullName: CaseFileParticipantEntity['fullName'];
+    position: CaseFileParticipantEntity['position'];
+    addedByFullName: CaseFileParticipantEntity['addedByFullName'];
+    createdAt: CaseFileParticipantEntity['createdAt'];
+}
+export interface CaseFileActorResponseEntity {
+    id: CaseFileActorEntity['id'];
+    relation: CaseFileActorEntity['relation'];
+    actorType: CaseFileActorEntity['actorType'];
+    identifier: CaseFileActorEntity['identifier'];
+    name: CaseFileActorEntity['name'];
+}
+export interface CaseFileTrackingResponseEntity {
+    id: CaseFileTrackingEntity['id'];
+    action: CaseFileTrackingEntity['action'];
+    observation: CaseFileTrackingEntity['observation'];
+    employeeFullName: CaseFileTrackingEntity['employeeFullName'];
+    createdAt: CaseFileTrackingEntity['createdAt'];
+}
+export interface CaseFileMetadataChangeResponseEntity {
+    id: CaseFileMetadataChangeEntity['id'];
+    /** Código oficial del metadato. Ej: `MGDEE1_5`. */
+    field: CaseFileMetadataChangeEntity['field'];
+    previousValue: CaseFileMetadataChangeEntity['previousValue'];
+    newValue: CaseFileMetadataChangeEntity['newValue'];
+    employeeFullName: CaseFileMetadataChangeEntity['employeeFullName'];
+    createdAt: CaseFileMetadataChangeEntity['createdAt'];
+}
+export interface CaseFileAccessResponseEntity {
+    id: CaseFileAccessEntity['id'];
+    action: CaseFileAccessEntity['action'];
+    entryId: CaseFileAccessEntity['entryId'];
+    /** Título del documento que se abrió, si el acceso fue a uno. */
+    entryTitle: string | null;
+    employeeFullName: CaseFileAccessEntity['employeeFullName'];
+    createdAt: CaseFileAccessEntity['createdAt'];
+}
+export interface CaseFileGetByIdResponseEntity extends CaseFileGetAllResponseEntity {
+    summary: CaseFileEntity['summary'];
+    procedure: Pick<ProcedureEntity, 'id' | 'name' | 'cpatId' | 'cpatCode'>;
+    responsiblePosition: CaseFileEntity['responsiblePosition'];
+    incorporationMechanism: CaseFileEntity['incorporationMechanism'];
+    schemaVersion: CaseFileEntity['schemaVersion'];
+    /** Enlace persistente del expediente (MGDEE4_2). `null` si el servicio no tiene configurada la dirección. */
+    uri: string | null;
+    closedByFullName: CaseFileEntity['closedByFullName'];
+    closingNote: CaseFileEntity['closingNote'];
+    index: CaseFileEntryResponseEntity[];
+    sharedWith: CaseFileParticipantResponseEntity[];
+    actors: CaseFileActorResponseEntity[];
+    trackings: CaseFileTrackingResponseEntity[];
+    metadataChanges: CaseFileMetadataChangeResponseEntity[];
+    /** Registro de accesos. Solo lo recibe el responsable y quien puede ver todos los expedientes. */
+    accesses: CaseFileAccessResponseEntity[];
+    /** Qué puede hacer con el expediente quien lo consulta. Sin `actor` en la consulta, no viene. */
+    actorCapabilities?: {
+        isResponsible: boolean;
+        /** Editar sus metadatos y cerrarlo: el responsable, mientras esté abierto. */
+        canEdit: boolean;
+        /** Incorporar actuaciones: el responsable y aquellos con quienes se compartió, mientras esté abierto. */
+        canIncorporate: boolean;
+        /** Compartirlo con otros funcionarios: el responsable, también después de cerrado. */
+        canShare: boolean;
+    };
+}
+export interface CaseFileCreateResponseEntity {
+    id: CaseFileEntity['id'];
+    code: CaseFileEntity['code'];
+    ok: boolean;
+}
+export interface CaseFileUpdateResponseEntity {
+    id: CaseFileEntity['id'];
+    ok: boolean;
+}
+export interface CaseFileAddEntryResponseEntity {
+    id: CaseFileEntity['id'];
+    entryId: CaseFileEntryEntity['id'];
+    sequence: CaseFileEntryEntity['sequence'];
+    ok: boolean;
+}
+/** Archivo de una entrada del índice, para servirlo a quien puede ver el expediente. */
+export interface CaseFileEntryFileResponseEntity {
+    fileId: string;
+    fileName: string;
+}
+/** Archivo que va dentro del expediente exportado, con la huella que tenía al incorporarse. */
+export interface CaseFileExportFileEntity {
+    entryId: CaseFileEntryEntity['id'];
+    sequence: CaseFileEntryEntity['sequence'];
+    /** Ruta dentro del ZIP. Ej: `documentos/001-decreto-alcaldicio-exento-590-2026.pdf`. */
+    path: string;
+    fileId: string;
+    sha256: string | null;
+}
+/**
+ * Expediente listo para exportar: los metadatos con sus códigos oficiales (va tal cual como `expediente.json`) y los
+ * archivos que hay que agregar. El ZIP lo arma el gateway.
+ */
+export interface CaseFileExportResponseEntity {
+    code: CaseFileEntity['code'];
+    manifest: Record<string, unknown>;
+    files: CaseFileExportFileEntity[];
+}
+/** Expediente en que está incorporado un documento, visto desde el documento. */
+export type DocumentCaseFileEntity = CaseFileLinkEntity;

package/dist/entities/caseFile/caseFile.entity.js

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

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

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

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

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

@@ -116,6 +116,13 @@ export interface DocumentGetByIdResponseEntity {
     deliveries: DocumentDeliveryResponseEntity[];
     replyTo: DocumentLinkEntity | null;
     replies: DocumentLinkEntity[];
+    /** Expedientes en que está incorporado y que quien consulta puede ver. */
+    caseFiles: {
+        id: string;
+        code: string;
+        title: string;
+        status: 'Open' | 'Closed';
+    }[];
     documentType: DocumentTypeSummaryEntity;
     participants: DocumentParticipantResponseEntity[];
     attachments: {
@@ -139,6 +146,7 @@ export interface DocumentGetByIdResponseEntity {
         canDiscard: boolean;
         canDerive: boolean;
         canReply: boolean;
+        canReassign: boolean;
         inbox: DocumentDeliveryResponseEntity[];
     };
     signatureRequiresOtp: boolean;
@@ -222,3 +230,7 @@ export interface DocumentCloseDeliveryResponseEntity {
     id: DocumentDeliveryEntity['id'];
     ok: boolean;
 }
+export interface DocumentReassignResponseEntity {
+    id: DocumentEntity['id'];
+    ok: boolean;
+}

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

@@ -1,4 +1,15 @@
-import { DocumentTypeEntity } from '../../base/entities';
+import { DocumentTypeEntity, DocumentTypeFlowStepEntity } from '../../base/entities';
+/** Paso del flujo sugerido de un tipo documental: quién visa o firma, en su orden. */
+export interface DocumentTypeFlowStepResponseEntity {
+    id: DocumentTypeFlowStepEntity['id'];
+    role: DocumentTypeFlowStepEntity['role'];
+    order: DocumentTypeFlowStepEntity['order'];
+    type: DocumentTypeFlowStepEntity['type'];
+    employeeId: DocumentTypeFlowStepEntity['employeeId'];
+    directorateCodeReference: DocumentTypeFlowStepEntity['directorateCodeReference'];
+    name: DocumentTypeFlowStepEntity['name'];
+    position: DocumentTypeFlowStepEntity['position'];
+}
 export interface DocumentTypeGetAllResponseEntity {
     id: DocumentTypeEntity['id'];
     name: DocumentTypeEntity['name'];
@@ -10,9 +21,14 @@ export interface DocumentTypeGetAllResponseEntity {
     resetsYearly: DocumentTypeEntity['resetsYearly'];
     directorateCodeReference: DocumentTypeEntity['directorateCodeReference'];
     enabled: DocumentTypeEntity['enabled'];
+    flow: {
+        visa: number;
+        signature: number;
+    };
 }
 export interface DocumentTypeGetByIdResponseEntity extends DocumentTypeGetAllResponseEntity {
     lastCorrelative: number | null;
+    flowSteps: DocumentTypeFlowStepResponseEntity[];
 }
 export interface DocumentTypeCreateResponseEntity {
     id: DocumentTypeEntity['id'];

package/dist/entities/index.d.ts

@@ -1,2 +1,4 @@
 export * from './documentType';
 export * from './document';
+export * from './procedure';
+export * from './caseFile';

package/dist/entities/index.js

@@ -16,3 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./documentType"), exports);
 __exportStar(require("./document"), exports);
+__exportStar(require("./procedure"), exports);
+__exportStar(require("./caseFile"), exports);

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

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

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

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

@@ -0,0 +1,20 @@
+import { ProcedureEntity } from '../../base/entities';
+export interface ProcedureGetAllResponseEntity {
+    id: ProcedureEntity['id'];
+    name: ProcedureEntity['name'];
+    cpatId: ProcedureEntity['cpatId'];
+    cpatCode: ProcedureEntity['cpatCode'];
+    description: ProcedureEntity['description'];
+    enabled: ProcedureEntity['enabled'];
+    /** Cuántos expedientes pertenecen a este procedimiento. */
+    caseFiles: number;
+}
+export type ProcedureGetByIdResponseEntity = ProcedureGetAllResponseEntity;
+export interface ProcedureCreateResponseEntity {
+    id: ProcedureEntity['id'];
+    ok: boolean;
+}
+export interface ProcedureUpdateResponseEntity {
+    id: ProcedureEntity['id'];
+    ok: boolean;
+}

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