Update utils documentation

**Problem**
When working with middleware, 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 utils and middleware code paths in the repository and reading the current error-handling behavior. Identify which middleware failures produce unclear messages; done means those messages are more descriptive and the related behavior is covered by the repository's existing checks.

Written by the indexing model from the issue text.