fix: surface endpoint errors and bump patch version to 1.0.9

[krowvin]

Multi-series reads could still log failures and return incomplete data, malformed JSON could be returned as text, and custom user-management errors could hide CDA response details.

Related work:

• Issue #277: No error raised on multithreaded store failure — original report, including the follow-up about suppressed fetch errors.
• PR #287: fix error suppresion in store_timeseries chunk — Mitch's earlier fix for No error raised on multithreaded store failure #277.
• PR #310: initialize time series before concurrent chunk writes — merged fix for initialization ordering and multi-series write error reporting; this PR extends error propagation across reads and the shared endpoint layer.

Changes:

• Include HTTP status, method, URL, and CDA body in errors, including custom user errors. Route role deletion through the shared API layer and preserve exception causes. Add request outcome and transport failure debug logs without request bodies or authentication headers.
• Raise BatchError (a RuntimeError subclass) for failed concurrent reads/writes, retaining every original exception in failures. Propagate extent lookup failures and invalid JSON responses; restrict chunk retries to transient failures. Successful writes are not rolled back.
• Narrow rating validation catches and document error handling and logging.

Audited all 33 endpoint modules and their request paths. Shared coverage includes GET, XML GET, paginated GET, POST, POST with returned data, PATCH, and DELETE.

Local validation: 186 mock/doctest tests pass, strict mypy passes for 38 source files, and Black/isort/whitespace checks pass. New regressions were also run against merged main to confirm the existing gaps. Tests cover eight HTTP error statuses across all request helpers, transport failures, malformed/empty responses, second-page failures, user-role deletion, partial concurrent reads/writes, initialization ordering, and retry behavior. No live database matrix was run for this change.

Compatibility note: callers now receive errors where incomplete results or fallback text were previously returned. Existing RuntimeError handlers continue to catch batch failures. The shared HTTP adapter's retry policy is unchanged.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud