🚀 PDF Generator Service

Сервис для генерации PDF документов из Handlebars шаблонов с использованием Nitro.js и Puppeteer.

Доступные эндпоинты:

{
  "template": "имя_шаблона",           // ИЛИ
  "templateString": "{{title}}",      // строка шаблона
  "data": {                           // данные для шаблона
    "title": "Заголовок",
    "content": "Содержимое"
  },
  "options": {                        // опции PDF (необязательно)
    "format": "A4",                   // A4, A3, A5, Letter, Legal, Tabloid
    "orientation": "portrait",        // portrait, landscape
    "margin": {
      "top": "20mm",
      "right": "20mm", 
      "bottom": "20mm",
      "left": "20mm"
    },
    "printBackground": true,          // печать фона
    "displayHeaderFooter": false,     // показать заголовок/подвал
    "scale": 1                        // масштаб (0.1 - 2.0)
  },
  "filename": "document.pdf"          // имя файла (необязательно)
}

Примеры использования:

1. Генерация PDF из строки шаблона:

curl -X POST http://localhost:3000/v1/generate-pdf \
  -H "Content-Type: application/json" \
  -d '{
    "templateString": "<h1>{{title}}</h1><p>{{content}}</p>",
    "data": {
      "title": "Привет, мир!",
      "content": "Это мой первый PDF документ."
    },
    "filename": "hello-world.pdf"
  }' \
  --output hello-world.pdf

2. Генерация с настройками PDF:

curl -X POST http://localhost:3000/v1/generate-pdf \
  -H "Content-Type: application/json" \
  -d '{
    "templateString": "<h1>{{title}}</h1><p>{{content}}</p>",
    "data": {
      "title": "Отчет",
      "content": "Содержание отчета..."
    },
    "options": {
      "format": "A4",
      "orientation": "landscape",
      "margin": {
        "top": "15mm",
        "bottom": "15mm",
        "left": "15mm", 
        "right": "15mm"
      }
    }
  }' \
  --output report.pdf

3. Использование с JavaScript:

const response = await fetch('/v1/generate-pdf', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    templateString: '<h1>{{title}}</h1>',
    data: { title: 'Мой документ' }
  })
});

if (response.ok) {
  const blob = await response.blob();
  const url = URL.createObjectURL(blob);
  const a = document.createElement('a');
  a.href = url;
  a.download = 'document.pdf';
  a.click();
}

Возможности:

• Handlebars шаблоны - поддержка .hbs файлов и строковых шаблонов
• Гибкие настройки PDF - формат, ориентация, отступы
• TypeScript - полная типизация и валидация
• Автоочистка - планировщик задач для оптимизации ресурсов

Структура проекта:

• server/routes/v1/ - API эндпоинты версии 1
• server/services/v1/ - сервисы приложения
• server/utils/ - утилиты и валидация
• server/tasks/ - планировщик задач
• server/types/ - TypeScript типы

Обработка ошибок:

API возвращает стандартные HTTP статус коды:

• 200 - Успешная генерация PDF
• 400 - Ошибка валидации или некорректные данные
• 404 - Шаблон не найден
• 405 - Неподдерживаемый HTTP метод
• 500 - Внутренняя ошибка сервера

Полезные ссылки:
📚 Nitro.js | 🎨 Handlebars | 🤖 Puppeteer