# barchart/aws-lambda-pdf-generator architecture

> Architecture diagram of the GitHub repository barchart/aws-lambda-pdf-generator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/barchart/aws-lambda-pdf-generator
- Repository: https://github.com/barchart/aws-lambda-pdf-generator

## Overview

This repository implements an AWS Lambda web service that converts submitted HTML into PDF responses. The main workflow accepts a request, validates and decodes its HTML, renders it with headless Chromium via Puppeteer, and returns a PDF; a separate handler reports service metadata. Shared Lambda handling provides processing and logging, while print-specific failure types and response generators support the conversion path. The README documents API Gateway, Lambda, Puppeteer, and Chromium; deployment configuration exists in the tree, but its routing details were not sampled.

Main entry points: [`packages/api/print/print.js`](https://github.com/barchart/aws-lambda-pdf-generator/blob/master/packages/api/print/print.js) (Print handler), [`packages/api/common/aws/LambdaHelper.js`](https://github.com/barchart/aws-lambda-pdf-generator/blob/master/packages/api/common/aws/LambdaHelper.js) (Lambda helper), [`packages/api/service/version.js`](https://github.com/barchart/aws-lambda-pdf-generator/blob/master/packages/api/service/version.js) (Metadata handler), [`packages/api/common/api/PrinterFailureTypes.js`](https://github.com/barchart/aws-lambda-pdf-generator/blob/master/packages/api/common/api/PrinterFailureTypes.js) (Print failures)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Service handlers"]
  node_print_handler["Print handler<br/>[print.js]"]
  node_metadata_handler["Metadata handler<br/>[version.js]"]
end

subgraph group_render["PDF rendering"]
  node_puppeteer["Puppeteer"]
  node_chromium["Chromium"]
  node_gzip_response["Gzip response generator"]
  node_s3_response["S3 response generator"]
end

subgraph group_shared["Shared Lambda support"]
  node_lambda_helper["Lambda helper<br/>[LambdaHelper.js]"]
  node_failure_types["Print failures"]
  node_logger_config["Logger configuration<br/>[log4js.config.js]"]
end

node_client(("HTTP client"))
node_gateway{{"API Gateway"}}
node_pdf_client(("PDF response"))

node_client -->|"submits HTML"| node_gateway
node_gateway -.->|"invokes service"| node_print_handler
node_print_handler -->|"processes request"| node_lambda_helper
node_print_handler -->|"rejects missing HTML"| node_failure_types
node_print_handler -->|"launches browser"| node_puppeteer
node_puppeteer -->|"uses runtime"| node_chromium
node_print_handler -->|"registers generator"| node_gzip_response
node_print_handler -->|"registers generator"| node_s3_response
node_print_handler -->|"sends PDF"| node_pdf_client
node_metadata_handler -->|"processes request"| node_lambda_helper
node_lambda_helper -->|"loads configuration"| node_logger_config

click node_print_handler "https://github.com/barchart/aws-lambda-pdf-generator/blob/master/packages/api/print/print.js"
click node_metadata_handler "https://github.com/barchart/aws-lambda-pdf-generator/blob/master/packages/api/service/version.js"
click node_lambda_helper "https://github.com/barchart/aws-lambda-pdf-generator/blob/master/packages/api/common/aws/LambdaHelper.js"
click node_failure_types "https://github.com/barchart/aws-lambda-pdf-generator/blob/master/packages/api/common/api/PrinterFailureTypes.js"
click node_logger_config "https://github.com/barchart/aws-lambda-pdf-generator/blob/master/packages/api/log4js.config.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_print_handler,node_metadata_handler,node_client toneBlue
class node_puppeteer,node_chromium,node_gzip_response,node_s3_response toneAmber
class node_lambda_helper,node_failure_types,node_logger_config,node_gateway toneMint
class node_pdf_client toneIndigo
```

## Components

### Service handlers

- [Print handler](https://github.com/barchart/aws-lambda-pdf-generator/blob/master/packages/api/print/print.js): `packages/api/print/print.js`
- [Metadata handler](https://github.com/barchart/aws-lambda-pdf-generator/blob/master/packages/api/service/version.js): `packages/api/service/version.js`

### PDF rendering

- **Puppeteer**
- **Chromium**
- **Gzip response generator**
- **S3 response generator**

### Shared Lambda support

- [Lambda helper](https://github.com/barchart/aws-lambda-pdf-generator/blob/master/packages/api/common/aws/LambdaHelper.js): `packages/api/common/aws/LambdaHelper.js`
- [Print failures](https://github.com/barchart/aws-lambda-pdf-generator/blob/master/packages/api/common/api/PrinterFailureTypes.js): `packages/api/common/api/PrinterFailureTypes.js`
- [Logger configuration](https://github.com/barchart/aws-lambda-pdf-generator/blob/master/packages/api/log4js.config.js): `packages/api/log4js.config.js`

### Other components

- **HTTP client**
- **API Gateway**
- **PDF response**

## Connections

- HTTP client → API Gateway: submits HTML (evidence: `README.md`)
- API Gateway → Print handler: invokes service
- Print handler → Lambda helper: processes request (evidence: `packages/api/print/print.js`)
- Print handler → Print failures: rejects missing HTML (evidence: `packages/api/print/print.js`)
- Print handler → Puppeteer: launches browser (evidence: `packages/api/print/print.js`)
- Puppeteer → Chromium: uses runtime (evidence: `README.md`)
- Print handler → Gzip response generator: registers generator (evidence: `packages/api/print/print.js`)
- Print handler → S3 response generator: registers generator (evidence: `packages/api/print/print.js`)
- Print handler → PDF response: sends PDF (evidence: `packages/api/print/print.js`)
- Metadata handler → Lambda helper: processes request (evidence: `packages/api/service/version.js`)
- Lambda helper → Logger configuration: loads configuration (evidence: `packages/api/common/aws/LambdaHelper.js`)
