EML2PDF

EML2PDF is a .NET CLI utility that converts an email file (.eml) into a PDF.

What the solution currently does

At runtime, the app:

1. Loads settings from appsettings.json located next to the executable.
2. Configures Serilog with:
   • rolling local file logs (logs/log-*.txt)
   • Seq sink (address from config)
3. Reads the input path either:
   • from the first CLI argument, or
   • from console prompt input.
4. Validates that the file exists.
5. Searches for PDF attachments at the deepest nesting level:
   • If any PDF attachments are found, all of them are extracted and saved to the same folder, using each attachment's original filename.
   • If no PDF attachments are found, the deepest nested .eml body is rendered via headless Chromium (PuppeteerSharp) and exported to PDF as <originalName>.eml.pdf.
6. Writes the output in the same folder as input using <originalName>.eml.pdf.
7. If successful, renames the source .eml to <yyyyMMddHHmmss> - <name>.eml.bak in the same folder (UTC timestamp, no spaces, seconds precision).

Usage

Download the latest release package. It contains the executable and appsettings.json.

Run one of:

• Interactive mode:

  EML2PDF.exe

• Direct argument mode:

  EML2PDF.exe "C:\path\to\mail.eml"

Configuration

appsettings.json keys currently used by the app:

• Seq:ServerAddress: Seq endpoint URL.
• Seq:AppName: value added as Serilog property.

Example:

{
  "Seq": {
	 "ServerAddress": "http://localhost:5341/",
	 "AppName": "EML2PDF"
  }
}

Output and Exit Codes

• Success output: a line prefixed with RET-OUTPUT: <pdfPath>.
• Exit code 0: conversion/extraction succeeded (or all output files already existed).
• When multiple PDF attachments are extracted, one RET-OUTPUT: line is printed per file.
• Exit code 1: invalid input path or runtime error.

Known resilience gaps (current implementation)

The following issues are currently present in code and should be considered known limitations:

1. Startup errors are not globally guarded. Fixed: all of Main is wrapped in a single try/catch(Exception)/finally; CloseAndFlushAsync is called unconditionally in the finally block.
2. Seq sink is always enabled when logger is built.
   • Bad/missing Seq endpoint can cause logging pipeline failures depending on environment/config.
3. BrowserFetcher().DownloadAsync() runs for every conversion.
   • Network or filesystem failures can break processing; cold-start latency is high.
4. Output file name is fixed to <input>.eml.pdf.
   • Existing file causes an early return instead of deterministic overwrite/versioning policy.
5. Source file cleanup (delete/move) is not wrapped in local error handling.
   • Permission/lock issues can fail after a successful conversion.
6. Backup naming has minute-level timestamp resolution.
   • Multiple runs in same minute can collide on .bak name.
7. MIME traversal/decoding assumes all nested payloads are valid.
   • Corrupt nested .eml or malformed parts can throw and abort.
8. HTML rendering does not sanitize/contain remote resources.
   • Embedded/linked assets may fail to load or behave inconsistently in headless rendering.
9. PDF page sizing uses document.body.scrollHeight as a single page height.
   • Very long messages can create oversized single-page PDFs and stress rendering.
10. No cancellation or timeout boundaries.
    • Stalls in MIME parsing, browser startup, network download, or PDF generation can hang the process.

Dependencies

• .NET 10
• MimeKit
• PuppeteerSharp (Chromium download and headless rendering)
• Serilog + File sink + Seq sink