HazelJS LogoHazelJS
HazelJS v0.2.0-beta.27: PDF-to-Audio, Logging, and Reliability
HazelJS Blog

HazelJS v0.2.0-beta.27: PDF-to-Audio, Logging, and Reliability

Author
HazelJS Team
2/17/2026
General
← Back to Blog

Physical file storage for PDF-to-audio, summary-only mode, configurable logging (LOG_ENABLED, LOG_PACKAGE), and BullMQ improvements for long-running jobs.

What's New

We're shipping v0.2.0-beta.27 with focused improvements to @hazeljs/pdf-to-audio, the core logger, and long-running job stability.

@hazeljs/pdf-to-audio: Physical File Storage

Completed audio files are now written to disk instead of Redis. This reduces memory pressure and makes files easier to serve or archive.

PdfToAudioModule.forRoot({
  connection: { host: 'localhost', port: 6379 },
  outputDir: './data/pdf-to-audio',
});

@hazeljs/pdf-to-audio: Summary-Only Mode

Output only the AI-generated summary (2–4 sentences) without reading the full document aloud.

hazel pdf-to-audio convert report.pdf --summary-only --wait -o summary.mp3

@hazeljs/pdf-to-audio: Long Job Reliability

Long conversions no longer stall. We increased the worker lockDuration to 30 minutes and added lockRenewTime so BullMQ doesn't mark jobs as stalled.

@hazeljs/core: Configurable Logging

The logger now respects LOG_ENABLED (false = silence console) and LOG_PACKAGE=http (show only HTTP request logs).

Upgrade

npm install @hazeljs/core@0.2.0-beta.27 @hazeljs/pdf-to-audio@0.2.0-beta.27

No breaking changes. See the PDF-to-Audio package docs and the PDF-to-Audio blog post for details.