changelog.md for @push.rocks/smartpdf

2026-03-09 - 4.2.0 - feat(smartpdf)
replace internal Express server with @push.rocks/smartserve, add PDF→WebP rendering, improve start/stop handling and bump dependencies
Replace internal Express HTTP implementation with @push.rocks/smartserve and update README wording to reflect HTTP server usage
Add PDF→WebP rendering: use pdf.js in-page rendering, capture canvases via Puppeteer to produce WebP buffers; added robust wait/timeout and error handling
Add start/stop guards: _isRunning flag, reset readiness Deferred on start, and throw if start called while running
Remove direct http/express exports from plugins and stop exporting express; export smartserve from plugins
Improve JPEG conversion to produce progressive JPEGs via SmartJimp (sharp mode)
Bump dependencies/devDependencies: @push.rocks/smartfs to ^1.5.0, add @push.rocks/smartserve ^2.0.1; devDeps @git.zone/tsbuild ^4.3.0, @git.zone/tstest ^3.3.0, @types/node ^25.3.5
2026-03-01 - 4.1.3 - fix(tests)
use example.com in image conversion test and relax JPEG size assertion
Replaced https://www.wikipedia.org with https://example.com in test/test.ts for the third PDF generation test
Removed the strict expectation that JPEG size must be smaller than PNG; now only asserts that WebP is smaller than PNG
Updated test comment to note that JPEG may not be smaller for simple graphics pages
2026-03-01 - 4.1.2 - fix(smartfs)
replace smartfile with smartfs, update file reading to use SmartFs, remove GraphicsMagick/Ghostscript dependency checks, bump dev and runtime dependencies, update tests and docs, and adjust npmextra configuration
Replace usage/export of @push.rocks/smartfile with @push.rocks/smartfs and update readFileToPdfObject to use SmartFs + SmartFsProviderNode
Remove execFile import and the GraphicsMagick/Ghostscript dependency-checking helpers from smartpdf (no more gm/gs checks)
Bump devDependencies: @git.zone/tsbuild ^4.1.2, @git.zone/tsdoc ^1.12.0, @git.zone/tsrun ^2.0.1, @git.zone/tstest ^3.1.8, @types/node ^25.3.2
Bump runtime dependencies: @push.rocks/smartfs ^1.3.1, @push.rocks/smartnetwork ^4.4.0, @tsclass/tsclass ^9.3.0, @types/express ^5.0.6, express ^5.2.1, pdf2json ^4.0.2
Tests updated: switched example URLs to example.com, added a third PDF generation test that writes .nogit/3.pdf, and exported tap.start() as default
npmextra.json reorganized to namespaced keys, added release.registries and accessLevel, and adjusted tsdoc/legal entries
Documentation/readme refreshed: added issue reporting/security section, feature table, and various wording/formatting updates
2025-08-02 - 4.1.0 - feat(smartpdf)
Add progressive JPEG generation support
Added new convertPDFToJpegBytes method for progressive JPEG generation
Integrated @push.rocks/smartjimp for true progressive JPEG encoding
Progressive JPEGs load in multiple passes, showing low-quality preview first
Supports quality and scale options like other image generation methods
Updated readme with comprehensive documentation and modern styling
Updated legal section to reflect Task Venture Capital GmbH ownership
2025-08-02 - 4.0.0 - BREAKING CHANGE(smartpdf)
Improve image generation quality and API consistency
BREAKING: Renamed 
convertPDFToWebpPreviews to 
convertPDFToWebpBytes for API consistency
Added configurable scale options to 
convertPDFToPngBytes method
Changed default scale from 1.0 to 3.0 for PNG generation (216 DPI)
Changed default scale from 0.5 to 3.0 for WebP generation (216 DPI)
Added DPI helper methods: 
getScaleForDPI() and scale constants (SCALE_SCREEN, SCALE_HIGH, SCALE_PRINT)
Added maxWidth/maxHeight constraints for both PNG and WebP generation
Improved test file organization with clear naming conventions
Updated documentation with DPI/scale guidance and examples
2025-08-01 - 3.3.0 - feat(smartpdf)
Add automatic port allocation and multi-instance support
Added ISmartPdfOptions interface with port configuration options
Implemented automatic port allocation between 20000-30000 by default
Added support for custom port ranges via portRangeStart/portRangeEnd options
Added support for specific port assignment via port option
Fixed resource cleanup when port allocation fails
Multiple SmartPdf instances can now run simultaneously without port conflicts
Updated readme with comprehensive documentation for all features
2025-02-25 - 3.2.2 - fix(SmartPdf)
Fix buffer handling for PDF conversion and text extraction
Ensure Uint8Array is converted to Node Buffer for PDF conversion.
Correct the PDF page viewport handling by using document dimensions.
Fix extractTextFromPdfBuffer argument type from Uint8Array to Buffer.
2025-02-25 - 3.2.1 - fix(SmartPdf)
Fix type for extractTextFromPdfBuffer function
Corrected the parameter type from Buffer to Uint8Array for extractTextFromPdfBuffer function.
2025-02-25 - 3.2.0 - feat(smartpdf)
Improve dependency versions and optimize PDF to PNG conversion.
Update several dependencies to newer versions for better stability and performance.
Refactor tests to enhance readability and add directory creation validations.
Optimize PDF to PNG conversion by switching to a more efficient Puppeteer and PDF.js-based method.
Add checks for presence of required dependencies (GraphicsMagick and Ghostscript).
Fix media emulation issue by properly awaiting the emulateMediaType function.
2024-11-30 - 3.1.8 - fix(core)
Fix candidate handling in PDF generation
Added error handling for missing PDF candidates in server requests.
Updated devDependencies and dependencies to latest versions for better stability and new features.
Patched header retrieval logic during PDF generation for security check.
2024-09-27 - 3.1.7 - fix(dependencies)
Update dependencies to latest versions
Updated @git.zone/tsbuild to version ^2.1.84
Updated @git.zone/tsdoc to version ^1.3.12
Updated @git.zone/tsrun to version ^1.2.49
Updated @push.rocks/tapbundle to version ^5.3.0
Updated @types/node to version ^22.7.4
Updated @push.rocks/smartfile to version ^11.0.21
Updated @push.rocks/smartpromise to version ^4.0.4
Updated @tsclass/tsclass to version ^4.1.2
Updated express to version ^4.21.0
Updated pdf2pic to version ^3.1.3
2024-05-29 - 3.1.6 - Core
Updated description
Minor changes to documentation and internal text.
2024-04-25 to 2024-04-30 - 3.1.0 to 3.1.5 - Core
Fix updates in core functionality
Fixes and updates in core function in versions 3.1.0 to 3.1.5.
2024-04-25 - 3.0.17 - Feature
Now supports PDF to JPG conversion
Added support for converting PDF files to JPG format.
2024-03-19 to 2024-04-14 - 3.0.17 - Maintenance
Various updates to project configuration files
Updated 
tsconfig.
Updated 
npmextra.json.
2023-07-11 to 2024-03-19 - 3.0.15 to 3.0.16 - Organization
Switch to new organization scheme and core updates
Switched to new organization scheme.
Applied core updates and bug fixes.
2022-11-07 to 2023-07-10 - 3.0.13 to 3.0.14 - Core
Fixes and updates to core functionality
Various minor bug fixes and updates to core components.
2022-09-13 to 2022-11-07 - 3.0.10 to 3.0.12 - Core
Ongoing core updates and maintenance
Regular fixes and operational improvements in core functionalities.
2022-06-12 to 2022-09-13 - 3.0.7 to 3.0.9 - Core
Continued focus on high-priority bug fixes and core functionalities
Regular fixes for critical bugs and enhancements.
2022-03-24 to 2022-06-29 - 3.0.3 to 3.0.6 - Core
Further optimization and maintenance releases
Further improvements and refinements of issues in core functionalities.
2022-01-05 to 2022-03-25 - 3.0.0 to 3.0.2 - Major Version Release
Major release for version 3.0.x, including core fixes
Increased version from 2.x to 3.0. New significant changes and fixes.
2022-01-05 to 2022-03-24 - 2.0.13 to 2.0.19 - Core
Routine core updates and bug fixes
Regular bug fixes in core components.
2019-11-19 to 2022-01-06 - 2.0.0 to 2.0.11 - Core
Multiple core updates and a few performance improvements
Some performance enhancements and multiple bug fixes.
2019-11-16 to 2019-11-19 - 1.0.27 to 1.0.29 - API
Breaking change in API
Naming PDF results to better represent their content.
2019-05-29 to 2019-11-15 - 1.0.13 to 1.0.26 - Core
Core functional updates and some major restructuring
Introduced multiple updates to the core, addressing bugs and improving stability.
2019-04-10 to 2019-05-28 - 1.0.4 to 1.0.12 - Core
Fixes and updates in the core
Implementation of multiple essential fixes for core components.
2018-10-06 - 1.0.1 to 1.0.3 - Core and Typings
Initial implementation and core fixes
Initial implementation of the project.
Fixed compilation problems in typings.
2016-01-29 - unknown - Initial
Initial commit
Initial commit for the project setup.