Add TypeScript types for lib

**Problem**
When working with utils, 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 lib and its utils, then compare the TypeScript-related request in the title with the error-handling problem described in the body. Clarify which change is in scope before editing. Done should include the requested TypeScript types or more descriptive utility errors, with checks showing the chosen behavior works.

Written by the indexing model from the issue text.