@zola_do/document-manipulator

PDF and DOCX merge, conversion, and template population for NestJS.

Installation

# Install individually
npm install @zola_do/document-manipulator

# Or via meta package
npm install @zola_do/nestjs-shared

Dependencies

This package depends on:

• @zola_do/minio — Object storage for documents
• docx-templates — DOCX template filling
• pdf-lib — PDF manipulation
• libreoffice-convert — Document format conversion (requires LibreOffice installed)

Usage

Module Setup

import { Module } from '@nestjs/common';
import { DocumentManipulatorModule } from '@zola_do/document-manipulator';
import { MinIoModule } from '@zola_do/minio';

@Module({
  imports: [MinIoModule, DocumentManipulatorModule],
})
export class AppModule {}

Merging PDFs

import { Injectable } from '@nestjs/common';
import { DocumentManipulatorService } from '@zola_do/document-manipulator';

@Injectable()
export class ReportService {
  constructor(private readonly docService: DocumentManipulatorService) {}

  async mergePdfs(pdfBuffers: Buffer[]) {
    await this.docService.mergePdf(pdfBuffers);
    // Merged PDF uploaded to MinIO
  }
}

Merging DOCX

await this.docService.mergeDocx(docxBuffers);

Populating Templates

Fill DOCX templates with data:

const populatedBuffer = await this.docService.populateTemplate(
  templateBuffer,
  { public_body: 'Procurement of procedure' },
);

Converting Documents

Convert between formats (requires LibreOffice):

const htmlBuffer = await this.docService.convertDocument(
  docxBuffer,
  '.html',
);

Exports

• DocumentManipulatorModule — Register the module
• DocumentManipulatorService — Merge, convert, populate templates
• FileHelperService — File utilities

Related Packages

• @zola_do/docx — DOCX template processing
• @zola_do/minio — Required for storage