Summary
Strengthen runtime error handling and consumer-facing diagnostics across the library.
Problem
Several APIs assume happy-path configuration and fall back to generic browser errors when something is missing or invalid. Production libraries should fail clearly and point consumers to the real integration mistake.
Scope
- Audit component factories and adapter entry points for unclear failures
- Replace generic throws and null-reference crashes with targeted error messages
- Add validation for required inputs, mount roots, and backend configuration
- Document the expected failure modes where useful
Acceptance Criteria
- Misconfigured mounts fail with clear actionable errors
- Invalid or incomplete configuration is detected before deeper runtime failure
- Error text identifies the affected API surface and the missing or invalid input
- Tests cover representative misconfiguration scenarios
Notes
This issue pairs well with the backend-contract and test-coverage work.
Summary
Strengthen runtime error handling and consumer-facing diagnostics across the library.
Problem
Several APIs assume happy-path configuration and fall back to generic browser errors when something is missing or invalid. Production libraries should fail clearly and point consumers to the real integration mistake.
Scope
Acceptance Criteria
Notes
This issue pairs well with the backend-contract and test-coverage work.