Refactor api for better readability

**Problem**
When working with parsers, the error messages could be more descriptive.

**Suggestion**
Improve error handling and add detailed error messages.

**Context**
This would help with debugging and maintenance.

Start by locating the parser error-handling paths and the API entry points that produce the current messages. Review the existing behavior and discussion, then define the expected detail and consider the work done when parser failures consistently provide more descriptive errors without changing unrelated behavior.

Written by the indexing model from the issue text.