Skip to content

chore: Say in the README that closing the client ends a write that the client has started to send with an OutcomeUnknownException. - #23

Merged
goloroden merged 2 commits into
mainfrom
readme-close-during-write
Oct 19, 2026
Merged

goloroden merged 2 commits into
mainfrom
readme-close-during-write

Conversation

@goloroden

@goloroden goloroden commented Oct 19, 2026 •

Copy link
Copy Markdown
Member

The README said that closing the client ends every running request with a CancellationException, and did not mention writes. A write that the client has started to send ends with an OutcomeUnknownException instead, whose cause is the CancellationException, even while the client is still connecting: close() aborts the running requests (Requests.java:213), receive turns that into a CancellationException (Requests.java:155), and write hands every failure after sending to Outcomes.ofWrite (Requests.java:117), which wraps whatever is neither a refusal nor a failed connection (Outcomes.java:49-58). The Javadoc of Client.close() says so (Client.java:384-388), and CloseTest checks it (CloseTest.java:100-103).

"Closing the Client" and "Handling Errors" now say so, as the docs on eventfoundation.io do.

🤖 Generated with Claude Code

https://claude.ai/code/session_01QykegdHe7vhHMBN3kWxgfH

…s sent with an OutcomeUnknownException.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QykegdHe7vhHMBN3kWxgfH
@goloroden
goloroden requested a review from a team as a code owner October 19, 2026 08:17
@goloroden goloroden self-assigned this Oct 19, 2026
…e client has started to send with an OutcomeUnknownException.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QykegdHe7vhHMBN3kWxgfH
@goloroden goloroden changed the title chore: Say in the README that closing the client ends a write that was sent with an OutcomeUnknownException. chore: Say in the README that closing the client ends a write that the client has started to send with an OutcomeUnknownException. Oct 19, 2026
@goloroden
goloroden merged commit 8f79756 into main Oct 19, 2026
3 of 4 checks passed
@goloroden
goloroden deleted the readme-close-during-write branch October 19, 2026 08:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant