Refactor types for better readability

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

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

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

The issue does not name any files, tests, or service entry points. Start by locating the service error-handling code and determine which messages are currently produced. Done is not precisely defined beyond making errors more descriptive for debugging and maintenance.

Written by the indexing model from the issue text.