@muni-sanfer/types-gestor-documental 0.0.1-beta.5 → 0.0.1-beta.7

package/dist/base/entities.d.ts

@@ -169,11 +169,13 @@ export interface DocumentTypeEntity {
     nextCorrelative: number;
     correlativeYear?: number | null;
     resetsYearly: boolean;
+    numbered: boolean;
     directorateCodeReference?: number | null;
     enabled: boolean;
     documents?: DocumentEntity[];
     annulledNumbers?: DocumentAnnulledNumberEntity[];
     flowSteps?: DocumentTypeFlowStepEntity[];
+    signatureBatches?: SignatureBatchEntity[];
     deleted: boolean;
     createdAt: string;
     updatedAt: string;
@@ -199,6 +201,10 @@ export interface DocumentEntity {
     externalFolio?: string | null;
     externalSender?: string | null;
     externalDate?: string | null;
+    contentText?: string | null;
+    textExtractedAt?: string | null;
+    batch?: SignatureBatchEntity | null;
+    batchId?: string | null;
     replyTo?: DocumentEntity | null;
     replyToDocumentId?: string | null;
     replies?: DocumentEntity[];
@@ -228,6 +234,18 @@ export interface DocumentEntity {
     createdAt: string;
     updatedAt: string;
 }
+export interface SignatureBatchEntity {
+    id: string;
+    name: string;
+    createdByEmployeeId: string;
+    createdByFullName: string;
+    documentType?: DocumentTypeEntity;
+    documentTypeId: string;
+    documents?: DocumentEntity[];
+    deleted: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
 export interface DocumentParticipantEntity {
     id: string;
     role: DocumentParticipantRole;

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

@@ -1,5 +1,5 @@
 import { type DocumentAccessLevel, type DocumentAttachmentEntity, type DocumentDeliveryEntity, type DocumentEntity, type DocumentInstruction, type DocumentParticipantEntity, type DocumentStatus } from '../base/entities';
-import { type DocumentAnnulResponseEntity, type DocumentCloseDeliveryResponseEntity, type DocumentCreateResponseEntity, type DocumentDeriveResponseEntity, type DocumentDiscardResponseEntity, type DocumentGetAllResponseEntity, type DocumentGetByIdResponseEntity, type DocumentGetSummaryResponseEntity, type DocumentInboxItemEntity, type DocumentPublicFileResponseEntity, type DocumentReassignResponseEntity, type DocumentReviewResponseEntity, type DocumentUpdateResponseEntity, type DocumentVerifyResponseEntity } from '../entities';
+import { type DocumentAnnulResponseEntity, type DocumentCloseDeliveryResponseEntity, type DocumentCreateResponseEntity, type DocumentDeriveResponseEntity, type DocumentDiscardResponseEntity, type DocumentGetAllResponseEntity, type DocumentGetByIdResponseEntity, type DocumentGetSummaryResponseEntity, type DocumentInboxItemEntity, type DocumentPublicFileResponseEntity, type DocumentReassignResponseEntity, type DocumentReviewResponseEntity, type DocumentSignManyResponseEntity, type DocumentUpdateResponseEntity, type DocumentVerifyResponseEntity } from '../entities';
 import { type RpcPage } from './contract';
 /** Patrones NATS de `document`: `<servicio>.<recurso>.<acción>`. */
 export declare const DocumentPatterns: {
@@ -10,6 +10,7 @@ export declare const DocumentPatterns: {
     readonly create: "gestorDocumental.document.create";
     readonly update: "gestorDocumental.document.update";
     readonly review: "gestorDocumental.document.review";
+    readonly signMany: "gestorDocumental.document.signMany";
     readonly reassign: "gestorDocumental.document.reassign";
     readonly discard: "gestorDocumental.document.discard";
     readonly annul: "gestorDocumental.document.annul";
@@ -99,6 +100,12 @@ export interface DocumentContract {
                 documentTypeId?: string;
                 dateFrom?: string;
                 dateTo?: string;
+                number?: number;
+                year?: number;
+                signerEmployeeId?: string;
+                authorEmployeeId?: string;
+                directorateCodeReference?: number;
+                text?: string;
             };
             actor?: DocumentActor;
         };
@@ -155,6 +162,25 @@ export interface DocumentContract {
         };
         response: DocumentReviewResponseEntity;
     };
+    /**
+     * Firma con un solo OTP varios documentos que el funcionario tiene en su turno de firma (los de un lote, o los que
+     * marcó en su bandeja). Cada uno queda firmado aparte; los que no caben en la solicitud quedan en `remaining`.
+     */
+    [DocumentPatterns.signMany]: {
+        payload: {
+            ids: DocumentEntity['id'][];
+            observation?: string | null;
+            signer: {
+                rut: string;
+                fullName: string;
+                role: string;
+                areaName: string;
+            };
+            otp?: string;
+            actor: DocumentActor;
+        };
+        response: DocumentSignManyResponseEntity;
+    };
     /**
      * Pasa un turno pendiente (de visación o de firma) a otro funcionario, por ausencia o por error, y lo deja en la
      * trazabilidad con su motivo. Puede hacerlo quien redactó el documento; con `anyDocument`, quien lleva el registro.

package/dist/contracts/document.contract.js

@@ -10,6 +10,7 @@ exports.DocumentPatterns = {
     create: 'gestorDocumental.document.create',
     update: 'gestorDocumental.document.update',
     review: 'gestorDocumental.document.review',
+    signMany: 'gestorDocumental.document.signMany',
     reassign: 'gestorDocumental.document.reassign',
     discard: 'gestorDocumental.document.discard',
     annul: 'gestorDocumental.document.annul',

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

@@ -32,6 +32,7 @@ export interface DocumentTypeWritePayload {
     description?: string | null;
     nextCorrelative?: number;
     resetsYearly?: boolean;
+    numbered?: boolean;
     directorateCodeReference?: number | null;
     enabled?: boolean;
     flowSteps?: DocumentFlowStepInput[];

package/dist/contracts/index.d.ts

@@ -3,12 +3,16 @@ import { type DocumentContract } from './document.contract';
 import { type DocumentTypeContract } from './documentType.contract';
 import { type PartsOfficeContract } from './partsOffice.contract';
 import { type ProcedureContract } from './procedure.contract';
+import { type RegisterBookContract } from './registerBook.contract';
+import { type SignatureBatchContract } from './signatureBatch.contract';
 export * from './contract';
 export * from './document.contract';
 export * from './documentType.contract';
 export * from './procedure.contract';
 export * from './caseFile.contract';
 export * from './partsOffice.contract';
+export * from './registerBook.contract';
+export * from './signatureBatch.contract';
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export declare const GestorDocumentalPatterns: {
     readonly documentType: {
@@ -26,6 +30,7 @@ export declare const GestorDocumentalPatterns: {
         readonly create: "gestorDocumental.document.create";
         readonly update: "gestorDocumental.document.update";
         readonly review: "gestorDocumental.document.review";
+        readonly signMany: "gestorDocumental.document.signMany";
         readonly reassign: "gestorDocumental.document.reassign";
         readonly discard: "gestorDocumental.document.discard";
         readonly annul: "gestorDocumental.document.annul";
@@ -73,6 +78,18 @@ export declare const GestorDocumentalPatterns: {
         readonly returnInbound: "gestorDocumental.partsOffice.returnInbound";
         readonly getInboundFile: "gestorDocumental.partsOffice.getInboundFile";
     };
+    readonly registerBook: {
+        readonly get: "gestorDocumental.registerBook.get";
+        readonly export: "gestorDocumental.registerBook.export";
+    };
+    readonly signatureBatch: {
+        readonly getAll: "gestorDocumental.signatureBatch.getAll";
+        readonly getById: "gestorDocumental.signatureBatch.getById";
+        readonly create: "gestorDocumental.signatureBatch.create";
+        readonly visa: "gestorDocumental.signatureBatch.visa";
+        readonly sign: "gestorDocumental.signatureBatch.sign";
+        readonly reject: "gestorDocumental.signatureBatch.reject";
+    };
 };
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
-export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & CaseFileContract & PartsOfficeContract;
+export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & CaseFileContract & PartsOfficeContract & RegisterBookContract & SignatureBatchContract;

package/dist/contracts/index.js

@@ -20,12 +20,16 @@ const document_contract_1 = require("./document.contract");
 const documentType_contract_1 = require("./documentType.contract");
 const partsOffice_contract_1 = require("./partsOffice.contract");
 const procedure_contract_1 = require("./procedure.contract");
+const registerBook_contract_1 = require("./registerBook.contract");
+const signatureBatch_contract_1 = require("./signatureBatch.contract");
 __exportStar(require("./contract"), exports);
 __exportStar(require("./document.contract"), exports);
 __exportStar(require("./documentType.contract"), exports);
 __exportStar(require("./procedure.contract"), exports);
 __exportStar(require("./caseFile.contract"), exports);
 __exportStar(require("./partsOffice.contract"), exports);
+__exportStar(require("./registerBook.contract"), exports);
+__exportStar(require("./signatureBatch.contract"), exports);
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 exports.GestorDocumentalPatterns = {
     documentType: documentType_contract_1.DocumentTypePatterns,
@@ -33,4 +37,6 @@ exports.GestorDocumentalPatterns = {
     procedure: procedure_contract_1.ProcedurePatterns,
     caseFile: caseFile_contract_1.CaseFilePatterns,
     partsOffice: partsOffice_contract_1.PartsOfficePatterns,
+    registerBook: registerBook_contract_1.RegisterBookPatterns,
+    signatureBatch: signatureBatch_contract_1.SignatureBatchPatterns,
 };

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

@@ -0,0 +1,27 @@
+import { type RegisterBookEntity, type RegisterBookExportEntity, type RegisterBookKind } from '../entities';
+/** Patrones NATS de `registerBook` (libros de registro): `<servicio>.<recurso>.<acción>`. */
+export declare const RegisterBookPatterns: {
+    readonly get: "gestorDocumental.registerBook.get";
+    readonly export: "gestorDocumental.registerBook.export";
+};
+/** Qué libro y qué período: un año y, si se indica, un mes. El de un tipo documental exige el tipo. */
+export interface RegisterBookQuery {
+    kind: RegisterBookKind;
+    documentTypeId?: string;
+    year: number;
+    month?: number | null;
+}
+export interface RegisterBookContract {
+    [RegisterBookPatterns.get]: {
+        payload: RegisterBookQuery;
+        response: RegisterBookEntity;
+    };
+    /** El libro en Excel o PDF. `generatedBy`: quién lo descarga (va en el encabezado). */
+    [RegisterBookPatterns.export]: {
+        payload: RegisterBookQuery & {
+            format: 'xlsx' | 'pdf';
+            generatedBy: string;
+        };
+        response: RegisterBookExportEntity;
+    };
+}

package/dist/contracts/registerBook.contract.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RegisterBookPatterns = void 0;
+/** Patrones NATS de `registerBook` (libros de registro): `<servicio>.<recurso>.<acción>`. */
+exports.RegisterBookPatterns = {
+    get: 'gestorDocumental.registerBook.get',
+    export: 'gestorDocumental.registerBook.export',
+};

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

@@ -0,0 +1,108 @@
+import { type DocumentAccessLevel } from '../base/entities';
+import { type SignatureBatchCreateResponseEntity, type SignatureBatchGetAllResponseEntity, type SignatureBatchGetByIdResponseEntity, type SignatureBatchRejectResponseEntity, type SignatureBatchSignResponseEntity, type SignatureBatchTab, type SignatureBatchVisaResponseEntity } from '../entities';
+import { type RpcPage } from './contract';
+import { type DocumentActor } from './document.contract';
+/** Patrones NATS de `signatureBatch` (lotes de firma): `<servicio>.<recurso>.<acción>`. */
+export declare const SignatureBatchPatterns: {
+    readonly getAll: "gestorDocumental.signatureBatch.getAll";
+    readonly getById: "gestorDocumental.signatureBatch.getById";
+    readonly create: "gestorDocumental.signatureBatch.create";
+    readonly visa: "gestorDocumental.signatureBatch.visa";
+    readonly sign: "gestorDocumental.signatureBatch.sign";
+    readonly reject: "gestorDocumental.signatureBatch.reject";
+};
+/** Datos de quien firma, para el sello de la firma (los resuelve el gateway desde la sesión). */
+export interface SignatureBatchSigner {
+    rut: string;
+    fullName: string;
+    role: string;
+    areaName: string;
+}
+export interface SignatureBatchContract {
+    [SignatureBatchPatterns.getAll]: {
+        payload: {
+            pagination?: {
+                page?: number;
+                limit?: number;
+            };
+            filters?: {
+                search?: string;
+                tab?: SignatureBatchTab;
+            };
+            actor: DocumentActor;
+        };
+        response: RpcPage<SignatureBatchGetAllResponseEntity[]>;
+    };
+    /** Lo ven su redactor y quienes visan o firman sus documentos; con `viewAll`, quien lleva el registro. */
+    [SignatureBatchPatterns.getById]: {
+        payload: {
+            id: string;
+            actor: DocumentActor;
+            viewAll?: boolean;
+        };
+        response: SignatureBatchGetByIdResponseEntity;
+    };
+    /**
+     * Crea el lote y lo envía a tramitación: un documento por cada PDF, todos del mismo tipo y con el mismo flujo.
+     * Cada documento recibe su código de verificación y, con su primera firma, su número (si el tipo lo lleva).
+     */
+    [SignatureBatchPatterns.create]: {
+        payload: {
+            name: string;
+            documentTypeId: string;
+            keywords: string[];
+            accessLevel?: DocumentAccessLevel;
+            hasSensitiveData?: boolean;
+            directorateCodeReference?: number | null;
+            departmentId?: string | null;
+            visaEmployeeIds?: string[];
+            signatureEmployeeIds: string[];
+            signatureSheet?: boolean;
+            documents: {
+                subject: string;
+                file: {
+                    fileId: string;
+                    name: string;
+                };
+            }[];
+            actor: DocumentActor;
+        };
+        response: SignatureBatchCreateResponseEntity;
+    };
+    /** Visa de una vez los documentos del lote que el funcionario tiene en su turno de visación. */
+    [SignatureBatchPatterns.visa]: {
+        payload: {
+            id: string;
+            observation?: string | null;
+            actor: DocumentActor;
+        };
+        response: SignatureBatchVisaResponseEntity;
+    };
+    /**
+     * Firma con un solo OTP los documentos del lote que el funcionario tiene en su turno de firma. FirmaGob admite 5 MB
+     * por solicitud: los que no caben quedan en `remaining`, para firmarlos con un OTP nuevo.
+     */
+    [SignatureBatchPatterns.sign]: {
+        payload: {
+            id: string;
+            observation?: string | null;
+            signer: SignatureBatchSigner;
+            otp?: string;
+            actor: DocumentActor;
+        };
+        response: SignatureBatchSignResponseEntity;
+    };
+    /**
+     * Devuelve a su redactor los documentos del lote que el funcionario tiene en su turno: todos, o los indicados en
+     * `documentIds`. Los demás siguen su curso.
+     */
+    [SignatureBatchPatterns.reject]: {
+        payload: {
+            id: string;
+            observation: string;
+            documentIds?: string[];
+            actor: DocumentActor;
+        };
+        response: SignatureBatchRejectResponseEntity;
+    };
+}

package/dist/contracts/signatureBatch.contract.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignatureBatchPatterns = void 0;
+/** Patrones NATS de `signatureBatch` (lotes de firma): `<servicio>.<recurso>.<acción>`. */
+exports.SignatureBatchPatterns = {
+    getAll: 'gestorDocumental.signatureBatch.getAll',
+    getById: 'gestorDocumental.signatureBatch.getById',
+    create: 'gestorDocumental.signatureBatch.create',
+    visa: 'gestorDocumental.signatureBatch.visa',
+    sign: 'gestorDocumental.signatureBatch.sign',
+    reject: 'gestorDocumental.signatureBatch.reject',
+};

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

@@ -97,6 +97,8 @@ export interface DocumentGetAllResponseEntity {
     intakeNumber: DocumentEntity['intakeNumber'];
     intakeYear: DocumentEntity['intakeYear'];
     origin: DocumentEntity['origin'];
+    /** Con búsqueda de texto completo: el fragmento donde aparece lo buscado, con lo encontrado entre ⟦ y ⟧. */
+    snippet?: string | null;
     currentParticipant: Pick<DocumentParticipantResponseEntity, 'role' | 'employeeId' | 'fullName'> | null;
     distribution: {
         total: number;
@@ -143,6 +145,11 @@ export interface DocumentGetByIdResponseEntity {
     recipients: DocumentRecipientResponseEntity[];
     deliveries: DocumentDeliveryResponseEntity[];
     replyTo: DocumentLinkEntity | null;
+    /** Lote de firma al que pertenece. */
+    batch: {
+        id: string;
+        name: string;
+    } | null;
     replies: DocumentLinkEntity[];
     /** Expedientes en que está incorporado y que quien consulta puede ver. */
     caseFiles: {
@@ -195,6 +202,11 @@ export interface DocumentGetByIdResponseEntity {
 export interface DocumentGetSummaryResponseEntity {
     toVisa: number;
     toSign: number;
+    /** Lotes de firma con documentos en su turno (los documentos de un lote no se cuentan en `toVisa` ni `toSign`). */
+    batches: {
+        toVisa: number;
+        toSign: number;
+    };
     created: {
         drafted: number;
         inProgress: number;
@@ -220,6 +232,27 @@ export interface DocumentReviewResponseEntity {
     ok: boolean;
     status: DocumentEntity['status'];
 }
+/** Resultado de un documento en una firma de varios documentos. */
+export interface DocumentSignManyResultEntity {
+    id: DocumentEntity['id'];
+    ok: boolean;
+    /** Estado en que quedó, si se firmó. */
+    status?: DocumentEntity['status'];
+    /** Por qué no se firmó. */
+    message?: string;
+}
+/**
+ * Firma de varios documentos con un solo OTP. FirmaGob admite 5 MB por solicitud: los que no cupieron quedan en
+ * `remaining`, en el turno del firmante, para firmarlos con un OTP nuevo.
+ */
+export interface DocumentSignManyResponseEntity {
+    results: DocumentSignManyResultEntity[];
+    signed: number;
+    failed: number;
+    remaining: DocumentEntity['id'][];
+    /** FirmaGob avisó que el OTP venció antes de firmar todos los documentos de la solicitud. */
+    otpExpired: boolean;
+}
 export interface DocumentDiscardResponseEntity {
     id: DocumentEntity['id'];
     ok: boolean;

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

@@ -19,6 +19,7 @@ export interface DocumentTypeGetAllResponseEntity {
     nextCorrelative: DocumentTypeEntity['nextCorrelative'];
     correlativeYear: DocumentTypeEntity['correlativeYear'];
     resetsYearly: DocumentTypeEntity['resetsYearly'];
+    numbered: DocumentTypeEntity['numbered'];
     directorateCodeReference: DocumentTypeEntity['directorateCodeReference'];
     enabled: DocumentTypeEntity['enabled'];
     flow: {

package/dist/entities/index.d.ts

@@ -3,3 +3,5 @@ export * from './document';
 export * from './procedure';
 export * from './caseFile';
 export * from './partsOffice';
+export * from './registerBook';
+export * from './signatureBatch';

package/dist/entities/index.js

@@ -19,3 +19,5 @@ __exportStar(require("./document"), exports);
 __exportStar(require("./procedure"), exports);
 __exportStar(require("./caseFile"), exports);
 __exportStar(require("./partsOffice"), exports);
+__exportStar(require("./registerBook"), exports);
+__exportStar(require("./signatureBatch"), exports);

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,42 @@
+/** 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;
+}
+export interface RegisterBookEntity {
+    kind: RegisterBookKind;
+    /** «Decreto alcaldicio exento» o «Ingresos de Oficina de Partes». */
+    title: 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/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);

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

@@ -0,0 +1,106 @@
+import { type DocumentAccessLevel, type DocumentEntity, type DocumentParticipantRole, type DocumentStatus, type SignatureBatchEntity } from '../../base/entities';
+import { type DocumentSignManyResponseEntity, type DocumentSignManyResultEntity } from '../document';
+/**
+ * Estado de un lote, deducido del de sus documentos: en tramitación mientras alguno lo esté; devuelto si no queda
+ * ninguno en tramitación y alguno volvió a su redactor; finalizado si todos terminaron (o se anularon después).
+ */
+export type SignatureBatchStatus = 'InProgress' | 'Returned' | 'Finished';
+/** Lista de lotes: los que esperan al funcionario, los que redactó o todos en que participa. */
+export type SignatureBatchTab = 'pending' | 'created' | 'participated';
+/** Cuántos documentos del lote hay en cada situación. */
+export interface SignatureBatchCountsEntity {
+    total: number;
+    inProgress: number;
+    finished: number;
+    /** Devueltos a su redactor (rechazados), para corregirlos y reenviarlos. */
+    returned: number;
+    annulled: number;
+}
+export interface SignatureBatchGetAllResponseEntity {
+    id: string;
+    name: string;
+    documentType: {
+        id: string;
+        name: string;
+    };
+    createdByEmployeeId: string;
+    createdByFullName: string;
+    createdAt: SignatureBatchEntity['createdAt'];
+    status: SignatureBatchStatus;
+    counts: SignatureBatchCountsEntity;
+    /** Documentos del lote que esperan al funcionario que consulta, por rol. */
+    myPending: {
+        visa: number;
+        signature: number;
+    };
+}
+/** Un documento del lote, con su turno vigente. */
+export interface SignatureBatchDocumentEntity {
+    id: string;
+    subject: string;
+    status: DocumentStatus;
+    correlative: number | null;
+    correlativeYear: number | null;
+    numberedAt: DocumentEntity['numberedAt'];
+    verificationCode: string | null;
+    originalFileName: string;
+    currentTurn: {
+        employeeId: string;
+        fullName: string;
+        role: DocumentParticipantRole;
+    } | null;
+    /** Si el turno vigente es del funcionario que consulta, qué le toca hacer. */
+    myTurn: DocumentParticipantRole | null;
+}
+export interface SignatureBatchGetByIdResponseEntity extends SignatureBatchGetAllResponseEntity {
+    documentType: {
+        id: string;
+        name: string;
+        abbreviation: string | null;
+        numbered: boolean;
+    };
+    keywords: string[];
+    accessLevel: DocumentAccessLevel;
+    hasSensitiveData: boolean;
+    /** Visadores y firmantes del lote, en orden (los del primer documento: todos parten con el mismo flujo). */
+    flow: {
+        role: DocumentParticipantRole;
+        employeeId: string;
+        fullName: string;
+        position: string | null;
+    }[];
+    documents: SignatureBatchDocumentEntity[];
+}
+/** A quién le quedó el turno después de una operación sobre el lote: para avisarle una sola vez por lote. */
+export interface SignatureBatchTurnEntity {
+    employeeId: string;
+    fullName: string;
+    role: DocumentParticipantRole;
+    count: number;
+}
+/** Lo que el gateway necesita para avisar: el lote, su redactor, a quién le toca ahora y cuántos terminaron. */
+export interface SignatureBatchOutcomeEntity {
+    id: string;
+    name: string;
+    createdByEmployeeId: string;
+    nextTurns: SignatureBatchTurnEntity[];
+    /** Documentos que quedaron finalizados con esta operación. */
+    finished: number;
+}
+export interface SignatureBatchCreateResponseEntity extends SignatureBatchOutcomeEntity {
+    ok: boolean;
+    documentIds: string[];
+}
+export interface SignatureBatchVisaResponseEntity extends SignatureBatchOutcomeEntity {
+    ok: boolean;
+    visaed: number;
+    /** Los que no se pudieron visar, con el motivo. */
+    failures: DocumentSignManyResultEntity[];
+}
+export type SignatureBatchSignResponseEntity = SignatureBatchOutcomeEntity & DocumentSignManyResponseEntity;
+export interface SignatureBatchRejectResponseEntity extends SignatureBatchOutcomeEntity {
+    ok: boolean;
+    /** Documentos devueltos a su redactor. */
+    rejected: number;
+    observation: string;
+}

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

package/src/base/entities.ts

@@ -250,11 +250,13 @@ export interface DocumentTypeEntity {
   nextCorrelative: number;
   correlativeYear?: number | null;
   resetsYearly: boolean;
+  numbered: boolean;
   directorateCodeReference?: number | null;
   enabled: boolean;
   documents?: DocumentEntity[];
   annulledNumbers?: DocumentAnnulledNumberEntity[];
   flowSteps?: DocumentTypeFlowStepEntity[];
+  signatureBatches?: SignatureBatchEntity[];
   deleted: boolean;
   createdAt: string;
   updatedAt: string;
@@ -281,6 +283,10 @@ export interface DocumentEntity {
   externalFolio?: string | null;
   externalSender?: string | null;
   externalDate?: string | null;
+  contentText?: string | null;
+  textExtractedAt?: string | null;
+  batch?: SignatureBatchEntity | null;
+  batchId?: string | null;
   replyTo?: DocumentEntity | null;
   replyToDocumentId?: string | null;
   replies?: DocumentEntity[];
@@ -311,6 +317,19 @@ export interface DocumentEntity {
   updatedAt: string;
 }
 
+export interface SignatureBatchEntity {
+  id: string;
+  name: string;
+  createdByEmployeeId: string;
+  createdByFullName: string;
+  documentType?: DocumentTypeEntity;
+  documentTypeId: string;
+  documents?: DocumentEntity[];
+  deleted: boolean;
+  createdAt: string;
+  updatedAt: string;
+}
+
 export interface DocumentParticipantEntity {
   id: string;
   role: DocumentParticipantRole;

package/src/contracts/document.contract.ts

@@ -20,6 +20,7 @@ import {
   type DocumentPublicFileResponseEntity,
   type DocumentReassignResponseEntity,
   type DocumentReviewResponseEntity,
+  type DocumentSignManyResponseEntity,
   type DocumentUpdateResponseEntity,
   type DocumentVerifyResponseEntity,
 } from '../entities';
@@ -34,6 +35,7 @@ export const DocumentPatterns = {
   create: 'gestorDocumental.document.create',
   update: 'gestorDocumental.document.update',
   review: 'gestorDocumental.document.review',
+  signMany: 'gestorDocumental.document.signMany',
   reassign: 'gestorDocumental.document.reassign',
   discard: 'gestorDocumental.document.discard',
   annul: 'gestorDocumental.document.annul',
@@ -129,6 +131,14 @@ export interface DocumentContract {
         // Rango de fechas de creación (ISO 8601).
         dateFrom?: string;
         dateTo?: string;
+        // Búsqueda avanzada: número (del documento o folio de ingreso) y año, firmante, redactor y unidad emisora.
+        number?: number;
+        year?: number;
+        signerEmployeeId?: string;
+        authorEmployeeId?: string;
+        directorateCodeReference?: number;
+        // Texto completo, en el asunto y en el contenido del PDF.
+        text?: string;
       };
       // Obligatorio en todas las bandejas salvo `all`.
       actor?: DocumentActor;
@@ -176,6 +186,21 @@ export interface DocumentContract {
     };
     response: DocumentReviewResponseEntity;
   };
+  /**
+   * Firma con un solo OTP varios documentos que el funcionario tiene en su turno de firma (los de un lote, o los que
+   * marcó en su bandeja). Cada uno queda firmado aparte; los que no caben en la solicitud quedan en `remaining`.
+   */
+  [DocumentPatterns.signMany]: {
+    payload: {
+      ids: DocumentEntity['id'][];
+      observation?: string | null;
+      // Datos de quien firma, para el sello de la firma (los resuelve el gateway desde la sesión).
+      signer: { rut: string; fullName: string; role: string; areaName: string };
+      otp?: string;
+      actor: DocumentActor;
+    };
+    response: DocumentSignManyResponseEntity;
+  };
   /**
    * Pasa un turno pendiente (de visación o de firma) a otro funcionario, por ausencia o por error, y lo deja en la
    * trazabilidad con su motivo. Puede hacerlo quien redactó el documento; con `anyDocument`, quien lleva el registro.

package/src/contracts/documentType.contract.ts

@@ -34,6 +34,8 @@ export interface DocumentTypeWritePayload {
   // Próximo número que se asignará: permite partir desde el correlativo que la municipalidad ya lleva.
   nextCorrelative?: number;
   resetsYearly?: boolean;
+  // Sus documentos llevan número (por omisión, sí).
+  numbered?: boolean;
   directorateCodeReference?: number | 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.

package/src/contracts/index.ts

@@ -3,6 +3,8 @@ import { DocumentPatterns, type DocumentContract } from './document.contract';
 import { DocumentTypePatterns, type DocumentTypeContract } from './documentType.contract';
 import { PartsOfficePatterns, type PartsOfficeContract } from './partsOffice.contract';
 import { ProcedurePatterns, type ProcedureContract } from './procedure.contract';
+import { RegisterBookPatterns, type RegisterBookContract } from './registerBook.contract';
+import { SignatureBatchPatterns, type SignatureBatchContract } from './signatureBatch.contract';
 
 export * from './contract';
 export * from './document.contract';
@@ -10,6 +12,8 @@ export * from './documentType.contract';
 export * from './procedure.contract';
 export * from './caseFile.contract';
 export * from './partsOffice.contract';
+export * from './registerBook.contract';
+export * from './signatureBatch.contract';
 
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export const GestorDocumentalPatterns = {
@@ -18,6 +22,8 @@ export const GestorDocumentalPatterns = {
   procedure: ProcedurePatterns,
   caseFile: CaseFilePatterns,
   partsOffice: PartsOfficePatterns,
+  registerBook: RegisterBookPatterns,
+  signatureBatch: SignatureBatchPatterns,
 } as const;
 
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
@@ -25,4 +31,6 @@ export type GestorDocumentalContract = DocumentTypeContract &
   DocumentContract &
   ProcedureContract &
   CaseFileContract &
-  PartsOfficeContract;
+  PartsOfficeContract &
+  RegisterBookContract &
+  SignatureBatchContract;

package/src/contracts/registerBook.contract.ts

@@ -0,0 +1,24 @@
+import { type RegisterBookEntity, type RegisterBookExportEntity, type RegisterBookKind } from '../entities';
+
+/** Patrones NATS de `registerBook` (libros de registro): `<servicio>.<recurso>.<acción>`. */
+export const RegisterBookPatterns = {
+  get: 'gestorDocumental.registerBook.get',
+  export: 'gestorDocumental.registerBook.export',
+} as const;
+
+/** Qué libro y qué período: un año y, si se indica, un mes. El de un tipo documental exige el tipo. */
+export interface RegisterBookQuery {
+  kind: RegisterBookKind;
+  documentTypeId?: string;
+  year: number;
+  month?: number | null;
+}
+
+export interface RegisterBookContract {
+  [RegisterBookPatterns.get]: { payload: RegisterBookQuery; response: RegisterBookEntity };
+  /** El libro en Excel o PDF. `generatedBy`: quién lo descarga (va en el encabezado). */
+  [RegisterBookPatterns.export]: {
+    payload: RegisterBookQuery & { format: 'xlsx' | 'pdf'; generatedBy: string };
+    response: RegisterBookExportEntity;
+  };
+}

package/src/contracts/signatureBatch.contract.ts

@@ -0,0 +1,94 @@
+import { type DocumentAccessLevel } from '../base/entities';
+import {
+  type SignatureBatchCreateResponseEntity,
+  type SignatureBatchGetAllResponseEntity,
+  type SignatureBatchGetByIdResponseEntity,
+  type SignatureBatchRejectResponseEntity,
+  type SignatureBatchSignResponseEntity,
+  type SignatureBatchTab,
+  type SignatureBatchVisaResponseEntity,
+} from '../entities';
+import { type RpcPage } from './contract';
+import { type DocumentActor } from './document.contract';
+
+/** Patrones NATS de `signatureBatch` (lotes de firma): `<servicio>.<recurso>.<acción>`. */
+export const SignatureBatchPatterns = {
+  getAll: 'gestorDocumental.signatureBatch.getAll',
+  getById: 'gestorDocumental.signatureBatch.getById',
+  create: 'gestorDocumental.signatureBatch.create',
+  visa: 'gestorDocumental.signatureBatch.visa',
+  sign: 'gestorDocumental.signatureBatch.sign',
+  reject: 'gestorDocumental.signatureBatch.reject',
+} as const;
+
+/** Datos de quien firma, para el sello de la firma (los resuelve el gateway desde la sesión). */
+export interface SignatureBatchSigner {
+  rut: string;
+  fullName: string;
+  role: string;
+  areaName: string;
+}
+
+export interface SignatureBatchContract {
+  [SignatureBatchPatterns.getAll]: {
+    payload: {
+      pagination?: { page?: number; limit?: number };
+      filters?: { search?: string; tab?: SignatureBatchTab };
+      actor: DocumentActor;
+    };
+    response: RpcPage<SignatureBatchGetAllResponseEntity[]>;
+  };
+  /** Lo ven su redactor y quienes visan o firman sus documentos; con `viewAll`, quien lleva el registro. */
+  [SignatureBatchPatterns.getById]: {
+    payload: { id: string; actor: DocumentActor; viewAll?: boolean };
+    response: SignatureBatchGetByIdResponseEntity;
+  };
+  /**
+   * Crea el lote y lo envía a tramitación: un documento por cada PDF, todos del mismo tipo y con el mismo flujo.
+   * Cada documento recibe su código de verificación y, con su primera firma, su número (si el tipo lo lleva).
+   */
+  [SignatureBatchPatterns.create]: {
+    payload: {
+      name: string;
+      documentTypeId: string;
+      keywords: string[];
+      accessLevel?: DocumentAccessLevel;
+      hasSensitiveData?: boolean;
+      directorateCodeReference?: number | null;
+      departmentId?: string | null;
+      visaEmployeeIds?: string[];
+      signatureEmployeeIds: string[];
+      signatureSheet?: boolean;
+      documents: { subject: string; file: { fileId: string; name: string } }[];
+      actor: DocumentActor;
+    };
+    response: SignatureBatchCreateResponseEntity;
+  };
+  /** Visa de una vez los documentos del lote que el funcionario tiene en su turno de visación. */
+  [SignatureBatchPatterns.visa]: {
+    payload: { id: string; observation?: string | null; actor: DocumentActor };
+    response: SignatureBatchVisaResponseEntity;
+  };
+  /**
+   * Firma con un solo OTP los documentos del lote que el funcionario tiene en su turno de firma. FirmaGob admite 5 MB
+   * por solicitud: los que no caben quedan en `remaining`, para firmarlos con un OTP nuevo.
+   */
+  [SignatureBatchPatterns.sign]: {
+    payload: {
+      id: string;
+      observation?: string | null;
+      signer: SignatureBatchSigner;
+      otp?: string;
+      actor: DocumentActor;
+    };
+    response: SignatureBatchSignResponseEntity;
+  };
+  /**
+   * Devuelve a su redactor los documentos del lote que el funcionario tiene en su turno: todos, o los indicados en
+   * `documentIds`. Los demás siguen su curso.
+   */
+  [SignatureBatchPatterns.reject]: {
+    payload: { id: string; observation: string; documentIds?: string[]; actor: DocumentActor };
+    response: SignatureBatchRejectResponseEntity;
+  };
+}

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

@@ -117,6 +117,8 @@ export interface DocumentGetAllResponseEntity {
   intakeNumber: DocumentEntity['intakeNumber'];
   intakeYear: DocumentEntity['intakeYear'];
   origin: DocumentEntity['origin'];
+  /** Con búsqueda de texto completo: el fragmento donde aparece lo buscado, con lo encontrado entre ⟦ y ⟧. */
+  snippet?: string | null;
   // A quién le toca visar o firmar (null si el documento no está en tramitación).
   currentParticipant: Pick<DocumentParticipantResponseEntity, 'role' | 'employeeId' | 'fullName'> | null;
   // A cuántos funcionarios llegó y cuántos ya lo abrieron (null si aún no se distribuye a nadie).
@@ -174,6 +176,8 @@ export interface DocumentGetByIdResponseEntity {
   deliveries: DocumentDeliveryResponseEntity[];
   // Documento al que este responde, y los que le responden (solo los ya finalizados, más los propios de quien consulta).
   replyTo: DocumentLinkEntity | null;
+  /** Lote de firma al que pertenece. */
+  batch: { id: string; name: string } | null;
   replies: DocumentLinkEntity[];
   /** Expedientes en que está incorporado y que quien consulta puede ver. */
   caseFiles: { id: string; code: string; title: string; status: 'Open' | 'Closed' }[];
@@ -228,6 +232,8 @@ export interface DocumentGetByIdResponseEntity {
 export interface DocumentGetSummaryResponseEntity {
   toVisa: number;
   toSign: number;
+  /** Lotes de firma con documentos en su turno (los documentos de un lote no se cuentan en `toVisa` ni `toSign`). */
+  batches: { toVisa: number; toSign: number };
   created: {
     drafted: number;
     inProgress: number;
@@ -258,6 +264,29 @@ export interface DocumentReviewResponseEntity {
   status: DocumentEntity['status'];
 }
 
+/** Resultado de un documento en una firma de varios documentos. */
+export interface DocumentSignManyResultEntity {
+  id: DocumentEntity['id'];
+  ok: boolean;
+  /** Estado en que quedó, si se firmó. */
+  status?: DocumentEntity['status'];
+  /** Por qué no se firmó. */
+  message?: string;
+}
+
+/**
+ * Firma de varios documentos con un solo OTP. FirmaGob admite 5 MB por solicitud: los que no cupieron quedan en
+ * `remaining`, en el turno del firmante, para firmarlos con un OTP nuevo.
+ */
+export interface DocumentSignManyResponseEntity {
+  results: DocumentSignManyResultEntity[];
+  signed: number;
+  failed: number;
+  remaining: DocumentEntity['id'][];
+  /** FirmaGob avisó que el OTP venció antes de firmar todos los documentos de la solicitud. */
+  otpExpired: boolean;
+}
+
 export interface DocumentDiscardResponseEntity {
   id: DocumentEntity['id'];
   ok: boolean;

package/src/entities/documentType/documentType.entity.ts

@@ -22,6 +22,8 @@ export interface DocumentTypeGetAllResponseEntity {
   nextCorrelative: DocumentTypeEntity['nextCorrelative'];
   correlativeYear: DocumentTypeEntity['correlativeYear'];
   resetsYearly: DocumentTypeEntity['resetsYearly'];
+  // Sin numeración, sus documentos solo llevan fecha, código de verificación y QR.
+  numbered: DocumentTypeEntity['numbered'];
   directorateCodeReference: DocumentTypeEntity['directorateCodeReference'];
   enabled: DocumentTypeEntity['enabled'];
   // Cuántos visadores y firmantes tiene su flujo sugerido.

package/src/entities/index.ts

@@ -3,3 +3,5 @@ export * from './document';
 export * from './procedure';
 export * from './caseFile';
 export * from './partsOffice';
+export * from './registerBook';
+export * from './signatureBatch';

package/src/entities/registerBook/index.ts

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

package/src/entities/registerBook/registerBook.entity.ts

@@ -0,0 +1,46 @@
+/** 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;
+}
+
+export interface RegisterBookEntity {
+  kind: RegisterBookKind;
+  /** «Decreto alcaldicio exento» o «Ingresos de Oficina de Partes». */
+  title: 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/src/entities/signatureBatch/index.ts

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

package/src/entities/signatureBatch/signatureBatch.entity.ts

@@ -0,0 +1,104 @@
+import {
+  type DocumentAccessLevel,
+  type DocumentEntity,
+  type DocumentParticipantRole,
+  type DocumentStatus,
+  type SignatureBatchEntity,
+} from '../../base/entities';
+import { type DocumentSignManyResponseEntity, type DocumentSignManyResultEntity } from '../document';
+
+/**
+ * Estado de un lote, deducido del de sus documentos: en tramitación mientras alguno lo esté; devuelto si no queda
+ * ninguno en tramitación y alguno volvió a su redactor; finalizado si todos terminaron (o se anularon después).
+ */
+export type SignatureBatchStatus = 'InProgress' | 'Returned' | 'Finished';
+
+/** Lista de lotes: los que esperan al funcionario, los que redactó o todos en que participa. */
+export type SignatureBatchTab = 'pending' | 'created' | 'participated';
+
+/** Cuántos documentos del lote hay en cada situación. */
+export interface SignatureBatchCountsEntity {
+  total: number;
+  inProgress: number;
+  finished: number;
+  /** Devueltos a su redactor (rechazados), para corregirlos y reenviarlos. */
+  returned: number;
+  annulled: number;
+}
+
+export interface SignatureBatchGetAllResponseEntity {
+  id: string;
+  name: string;
+  documentType: { id: string; name: string };
+  createdByEmployeeId: string;
+  createdByFullName: string;
+  createdAt: SignatureBatchEntity['createdAt'];
+  status: SignatureBatchStatus;
+  counts: SignatureBatchCountsEntity;
+  /** Documentos del lote que esperan al funcionario que consulta, por rol. */
+  myPending: { visa: number; signature: number };
+}
+
+/** Un documento del lote, con su turno vigente. */
+export interface SignatureBatchDocumentEntity {
+  id: string;
+  subject: string;
+  status: DocumentStatus;
+  correlative: number | null;
+  correlativeYear: number | null;
+  numberedAt: DocumentEntity['numberedAt'];
+  verificationCode: string | null;
+  originalFileName: string;
+  currentTurn: { employeeId: string; fullName: string; role: DocumentParticipantRole } | null;
+  /** Si el turno vigente es del funcionario que consulta, qué le toca hacer. */
+  myTurn: DocumentParticipantRole | null;
+}
+
+export interface SignatureBatchGetByIdResponseEntity extends SignatureBatchGetAllResponseEntity {
+  documentType: { id: string; name: string; abbreviation: string | null; numbered: boolean };
+  keywords: string[];
+  accessLevel: DocumentAccessLevel;
+  hasSensitiveData: boolean;
+  /** Visadores y firmantes del lote, en orden (los del primer documento: todos parten con el mismo flujo). */
+  flow: { role: DocumentParticipantRole; employeeId: string; fullName: string; position: string | null }[];
+  documents: SignatureBatchDocumentEntity[];
+}
+
+/** A quién le quedó el turno después de una operación sobre el lote: para avisarle una sola vez por lote. */
+export interface SignatureBatchTurnEntity {
+  employeeId: string;
+  fullName: string;
+  role: DocumentParticipantRole;
+  count: number;
+}
+
+/** Lo que el gateway necesita para avisar: el lote, su redactor, a quién le toca ahora y cuántos terminaron. */
+export interface SignatureBatchOutcomeEntity {
+  id: string;
+  name: string;
+  createdByEmployeeId: string;
+  nextTurns: SignatureBatchTurnEntity[];
+  /** Documentos que quedaron finalizados con esta operación. */
+  finished: number;
+}
+
+export interface SignatureBatchCreateResponseEntity extends SignatureBatchOutcomeEntity {
+  ok: boolean;
+  documentIds: string[];
+}
+
+export interface SignatureBatchVisaResponseEntity extends SignatureBatchOutcomeEntity {
+  ok: boolean;
+  visaed: number;
+  /** Los que no se pudieron visar, con el motivo. */
+  failures: DocumentSignManyResultEntity[];
+}
+
+export type SignatureBatchSignResponseEntity = SignatureBatchOutcomeEntity & DocumentSignManyResponseEntity;
+
+export interface SignatureBatchRejectResponseEntity extends SignatureBatchOutcomeEntity {
+  ok: boolean;
+  /** Documentos devueltos a su redactor. */
+  rejected: number;
+  observation: string;
+}

package/tsconfig.json

@@ -9,7 +9,5 @@
     "skipLibCheck": true,
     "rootDir": "./src"
   },
-  "include": [
-    "src"
-  ]
+  "include": ["src"]
 }