Errors and troubleshooting
Understand stable error codes and the most common failure scenarios.
Stable error model
The package throws PdfToImagesError with a stable code.
That lets you distinguish:
- bad caller input
- malformed or encrypted documents
- native runtime setup failures
- rendering failures
Common problems
Production guidance
If you expose conversion through an API:
- map stable error codes into HTTP status codes
- log the native failure message on the server
- avoid returning full native diagnostics to untrusted clients