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 entry points and their existing error-handling paths in the repository. Review how current parser failures are reported and identify the relevant tests, if any; done means the requested readability refactor is scoped and detailed error messages are covered by tests.

Written by the indexing model from the issue text.