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

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

@@ -0,0 +1,137 @@
+import { type PdfSignatureReportEntity } from '../signatureCheck';
+import { type DocumentDispatchResponseEntity, type DocumentExternalRecipientResponseEntity, type DocumentLinkEntity } from '../document';
+/** Institución del Estado en DocDigital. */
+export interface DocDigitalEntityEntity {
+    id: number;
+    name: string;
+    /** Organismo al que pertenece (la entidad padre). */
+    organism: string | null;
+}
+/** Usuario habilitado de una institución en DocDigital. */
+export interface DocDigitalUserEntity {
+    id: number;
+    name: string;
+    position: string | null;
+}
+export interface DocDigitalDocumentTypeEntity {
+    id: number;
+    name: string;
+}
+/** Si DocDigital está configurado en el gestor y cada cuánto se revisa lo recibido. */
+export interface PartsOfficeStatusEntity {
+    configured: boolean;
+    syncMinutes: number;
+}
+/** Totales del Panel de Partes. */
+export interface PartsOfficeSummaryEntity {
+    toDispatch: number;
+    received: number;
+}
+/** Documento firmado que va a otras instituciones: lo despacha Oficina de Partes. */
+export interface PartsOfficeDispatchEntity extends DocumentDispatchResponseEntity {
+    document: DocumentLinkEntity & {
+        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. */
+export interface PartsOfficeInboundEntity {
+    id: string;
+    docDigitalDocumentId: string;
+    status: 'Pending' | 'Registered' | 'Returned';
+    subject: string;
+    description: string | null;
+    folio: string | null;
+    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;
+    fileName: string | null;
+    hasFile: boolean;
+    /** Revisión de las firmas del documento principal al recibirlo. */
+    signatureCheck: PdfSignatureReportEntity | null;
+    attachments: {
+        name: string;
+        url: string | null;
+        hasFile: boolean;
+    }[];
+    createdAt: string;
+    registeredAt: string | null;
+    registeredByFullName: string | null;
+    acknowledgedAt: string | null;
+    acknowledgeError: string | null;
+    returnedAt: string | null;
+    returnedByFullName: string | null;
+    returnReason: string | null;
+    /** El documento con que quedó ingresado al gestor. */
+    document: {
+        id: string;
+        intakeNumber: number | null;
+        intakeYear: number | null;
+    } | null;
+}
+export interface PartsOfficeOkResponseEntity {
+    id: string;
+    ok: boolean;
+    /** Documento al que corresponde el despacho (al despachar o devolver). */
+    documentId?: string;
+}
+export interface PartsOfficeSyncResponseEntity {
+    /** Recibidos nuevos que se trajeron. */
+    created: number;
+    /** Los que no se pudieron traer (se reintentan en la próxima revisión). */
+    failed: number;
+}
+export interface PartsOfficeRegisterResponseEntity {
+    id: string;
+    documentId: string;
+    intakeNumber: number;
+    intakeYear: number;
+    /** `false` si DocDigital no aceptó el acuse de recibo: se puede reintentar. */
+    acknowledged: boolean;
+    ok: boolean;
+}
+/** Archivo de un recibido, ya copiado al gestor. */
+export interface PartsOfficeFileEntity {
+    fileId: string;
+    fileName: string;
+}
+/** Por qué una persona tiene que estar habilitada en DocDigital. */
+export type EnablementRole = 'PartsOffice' | 'Signer';
+/** Persona que se revisa: la arma el gateway con organizacion-ms (permisos de Partes y firmantes por cargo). */
+export interface EnablementPersonInput {
+    employeeId: string;
+    fullName: string;
+    /** RUN del funcionario; sin él no se puede buscar en DocDigital. */
+    rut: string | null;
+    position: string | null;
+    roles: EnablementRole[];
+}
+/** Resultado de una persona: en qué entidades de DocDigital está habilitada. */
+export interface EnablementPersonEntity extends EnablementPersonInput {
+    status: 'Enabled' | 'NotEnabled' | 'NoRut';
+    enabledIn: {
+        entityId: number;
+        entityName: string;
+        docDigitalPosition: string | null;
+    }[];
+}
+export interface PartsOfficeEnablementEntity {
+    checkedAt: string;
+    /** DocDigital configurado en el gestor; sin él no se revisa nada. */
+    configured: boolean;
+    /** Entidades revisadas: la municipalidad y las entidades emisoras con DocDigital. */
+    entities: {
+        entityId: number;
+        entityName: string;
+        userCount: number;
+    }[];
+    people: EnablementPersonEntity[];
+}

package/dist/entities/partsOffice/partsOffice.entity.js

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

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

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

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

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

@@ -0,0 +1,28 @@
+/** Si los avisos push están habilitados y con qué clave pública se suscribe el navegador. */
+export interface PushConfigResponseEntity {
+    /** El servidor tiene sus claves VAPID: se pueden activar. */
+    enabled: boolean;
+    /** Clave pública VAPID (base64url) para `pushManager.subscribe`; `null` si no está habilitado. */
+    publicKey: string | null;
+    /** Dispositivos en que quien consulta tiene los avisos activos. */
+    devices: number;
+}
+export interface PushOkResponseEntity {
+    ok: boolean;
+}
+/** Resultado de un envío: avisos entregados al servicio push, suscripciones vencidas que se borraron y fallas. */
+export interface PushSendResultEntity {
+    sent: number;
+    removed: number;
+    failed: number;
+}
+/**
+ * Un aviso. `url` es una ruta del gestor (`/documentos/…/detalle`): el service worker la abre al tocar el aviso.
+ * `tag` agrupa: un aviso nuevo con el mismo `tag` reemplaza al anterior en el dispositivo.
+ */
+export interface PushNotificationInput {
+    title: string;
+    body: string;
+    url: string;
+    tag?: string | null;
+}

package/dist/entities/push/push.entity.js

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

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

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

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

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

@@ -0,0 +1,48 @@
+/** Libro de registro: el de un tipo documental (sus números) o el de ingresos de Oficina de Partes. */
+export type RegisterBookKind = 'documentType' | 'intake';
+/**
+ * Estado de un número en el libro: vigente, en tramitación (numerado con la primera firma, aún sin todas las firmas),
+ * documento anulado, número anulado por un rechazo, o número sin registro en el gestor (un salto en la numeración).
+ */
+export type RegisterBookRowState = 'Valid' | 'InProgress' | 'Annulled' | 'NumberAnnulled' | 'Unused';
+export interface RegisterBookRowEntity {
+    number: number;
+    /** Fecha del número (o del ingreso), en ISO 8601. `null` en un salto. */
+    date: string | null;
+    state: RegisterBookRowState;
+    documentId: string | null;
+    subject: string | null;
+    /** Quién redactó el documento (o, en el libro de ingresos, quién lo ingresó). */
+    author: string | null;
+    signers: string[];
+    /** Libro de ingresos: institución que lo envió y su folio. */
+    sender: string | null;
+    externalFolio: string | null;
+    /** Libro de ingresos: a quiénes se derivó. */
+    recipients: string[];
+    /** Despacho por DocDigital: «DocDigital N° 777001 · 14-10-2026». */
+    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[];
+    totals: Record<RegisterBookRowState, number>;
+}
+/** Libro exportado, listo para descargar. */
+export interface RegisterBookExportEntity {
+    fileName: string;
+    contentType: string;
+    contentBase64: string;
+}

package/dist/entities/registerBook/registerBook.entity.js

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

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

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

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

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

@@ -0,0 +1,124 @@
+import { type CaseFileExportResponseEntity } from '../caseFile';
+/** Qué documentos: los oficiales (finalizados y anulados) o todos, también borradores y en tramitación. */
+export type RepositoryExportScope = 'official' | 'all';
+/** Un archivo que el gateway descarga y pone en el ZIP, en la ruta indicada. */
+export interface RepositoryExportFile {
+    fileId: string;
+    path: string;
+    kind: 'document' | 'attachment';
+}
+/** Un documento con todos sus datos, como va en `documentos/*.jsonl`. Claves en castellano, como `expediente.json`. */
+export interface RepositoryDocumentRecord {
+    id: string;
+    tipo: {
+        nombre: string;
+        sigla: string | null;
+        serie: {
+            codigo: string;
+            nombre: string;
+        } | null;
+    };
+    entidadEmisora: string;
+    folio: string | null;
+    numero: number | null;
+    anio: number | null;
+    materia: string;
+    palabrasClave: string[];
+    nivelAcceso: string;
+    datosSensibles: boolean;
+    finRestriccion: string | null;
+    estado: string;
+    origen: string;
+    codigoVerificacion: string | null;
+    redactor: {
+        id: string;
+        nombre: string;
+    };
+    unidadEmisora: {
+        codigoDireccion: number | null;
+        departamentoId: string | null;
+    };
+    creado: string;
+    enviado: string | null;
+    finalizado: string | null;
+    anulacion: {
+        fecha: string;
+        motivo: string | null;
+    } | null;
+    numerosAnulados: {
+        numero: number;
+        anio: number;
+        motivo: string;
+        registradoPor: string;
+        fecha: string;
+    }[];
+    participantes: {
+        rol: string;
+        orden: number;
+        etapa: number;
+        nombre: string;
+        cargo: string | null;
+        estado: string;
+        resueltoEl: string | null;
+        observacion: string | null;
+    }[];
+    destinatarios: {
+        tipo: string;
+        nombre: string;
+        cargo: string | null;
+    }[];
+    destinatariosExternos: {
+        entidad: string;
+        usuario: string | null;
+    }[];
+    despacho: {
+        estado: string;
+        folio: string | null;
+        despachadoEl: string | null;
+        idDocDigital: string | null;
+    } | null;
+    ingreso: {
+        folio: string | null;
+        remitente: string | null;
+        folioDeOrigen: string | null;
+    } | null;
+    anexos: {
+        nombre: string;
+        enlace: string | null;
+        archivo: string | null;
+    }[];
+    trazabilidad: {
+        accion: string;
+        quien: string | null;
+        cuando: string;
+        observacion: string | null;
+        sha256: string | null;
+    }[];
+    /** Ruta del PDF vigente (firmado) dentro del ZIP. */
+    archivo: string;
+}
+export interface RepositoryExportSummaryEntity {
+    /** Órgano que exporta (`ORGAN_NAME`). */
+    organ: string;
+    from: string | null;
+    to: string | null;
+    scope: RepositoryExportScope;
+    documents: number;
+    caseFiles: number;
+    /** Catálogos completos: tipos documentales, series, procedimientos, entidades emisoras y feriados. */
+    catalogs: Record<string, unknown[]>;
+}
+export interface RepositoryExportDocumentsPageEntity {
+    items: {
+        record: RepositoryDocumentRecord;
+        files: RepositoryExportFile[];
+    }[];
+    nextCursor: string | null;
+}
+export interface RepositoryExportCaseFilesPageEntity {
+    items: CaseFileExportResponseEntity[];
+    nextCursor: string | null;
+}
+export interface RepositoryExportRecordResponseEntity {
+    ok: boolean;
+}

package/dist/entities/repositoryExport/repositoryExport.entity.js

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

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

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

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

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

@@ -0,0 +1,49 @@
+import { type DispositionKind, type FinalDisposition } from '../../base/entities';
+/** Una serie con su Tabla de Retención y cuánto venció. */
+export interface RetentionSeriesEntity {
+    seriesId: string;
+    code: string;
+    name: string;
+    section: string | null;
+    managementYears: number;
+    centralYears: number;
+    finalDisposition: FinalDisposition;
+    retentionNote: string | null;
+    /** Documentos firmados y expedientes cerrados cuyo plazo terminó y aún no tienen acta. */
+    documentsDue: number;
+    caseFilesDue: number;
+    /** Actas ya emitidas de la serie. */
+    dispositions: number;
+}
+export interface RetentionSummaryEntity {
+    series: RetentionSeriesEntity[];
+    /** Series habilitadas sin plazos: sus documentos no vencen. */
+    seriesWithoutRetention: number;
+}
+/** Un documento o expediente cuyo plazo de retención terminó. */
+export interface RetentionDueItemEntity {
+    kind: 'Document' | 'CaseFile';
+    id: string;
+    /** Folio del documento o IUIe del expediente. */
+    reference: string;
+    title: string;
+    /** Desde cuándo se cuenta: la última firma del documento o el cierre del expediente. */
+    baseDate: string;
+    dueAt: string;
+}
+export interface DispositionRecordResponseEntity {
+    id: string;
+    kind: DispositionKind;
+    number: number;
+    year: number;
+    /** «Acta de transferencia N° 1/2026». */
+    label: string;
+    seriesId: string;
+    seriesCode: string;
+    seriesName: string;
+    observation: string | null;
+    documents: number;
+    caseFiles: number;
+    createdByFullName: string;
+    createdAt: string;
+}

package/dist/entities/retention/retention.entity.js

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

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/signatureBatch/index.d.ts

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

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