feat(llc)!: bound and authenticate a connection attempt - #160

Merged

xsahil03x merged 120 commits into

mainfrom

feat/ws-connection-lifecycle

Aug 25, 2026

Commits on Aug 19, 2026

feat(llc)!: let a TokenManager switch users

xsahil03x
and
claude
committed
56bf6dc
docs(llc): drop the AuthInterceptor user_id entry from the changelog

xsahil03x
and
claude
committed
84e948e
test(llc): cover the deliberate user_id/token divergence in AuthInterceptor

xsahil03x
and
claude
committed
8e963f4
fix(llc): discard a token load invalidated while it was in flight

xsahil03x
and
claude
committed
ed252e8
refactor(llc): make token provider mismatches assertable without their text

xsahil03x
and
claude
committed
a64dbb0
refactor(llc): drop the redundant prefix from token mismatch messages

xsahil03x
and
claude
committed
64a85e0
test(llc): share one JWT builder across the token tests

xsahil03x
and
claude
committed
07db567
refactor(llc)!: remove AuthInterceptor.withProvider

xsahil03x
and
claude
committed
c91b3af
style(llc): align with STYLE_GUIDE and TESTING conventions

xsahil03x
and
claude
committed
0d88226
test(llc): keep the JWT builder local to each test file

xsahil03x
and
claude
committed
b9d1928
test(llc): share one JWT builder, and document the pattern

xsahil03x
and
claude
committed
8f834a4
docs(repo): drop the incident detail from the test-fixture rule

xsahil03x
and
claude
committed
500beee
refactor(llc): restore the original token mismatch messages

xsahil03x
and
claude
committed
5215424
refactor(llc): drop the ArgumentError name argument

xsahil03x
and
claude
committed
df2d4f9
docs(llc): drop an inaccurate comment on the token type check

xsahil03x
and
claude
committed
6c5eeca
test(llc): reach the type check now that the user id is validated first

xsahil03x
and
claude
committed
a6bb26c

Commits on Aug 20, 2026

feat(llc): let a TokenManager exist before its user does

xsahil03x
and
claude
committed
1d50f2c
feat(llc)!: bound and authenticate a connection attempt

xsahil03x
and
claude
committed
1abd7d4
fix(llc): report a wrong-type token as such, not as a wrong user

xsahil03x
and
claude
committed
06747e0
fix(llc): stop serving a token for a user the manager has dropped

xsahil03x
and
claude
committed
1ed6718
fix(llc): keep the token-expired error when there is no user to refresh for

xsahil03x
and
claude
committed
7541144
docs(llc): record the behaviour changes raised in review

xsahil03x
and
claude
committed
49f63f3
Merge feat/token-manager-user-switching into feat/ws-connection-lifecycle
xsahil03x
committed
15e5016
fix(llc)!: return the result's own type from Result's failure-side helpers

xsahil03x
and
claude
committed
64c7af7
fix(llc): make a connection going down report why, once, and stay down

xsahil03x
and
claude
committed
705123f
docs(llc): document fromUser and record this round of changes

xsahil03x
and
claude
committed
ba79c6a
docs(llc): show how to widen a Result now that the helpers do not

xsahil03x
and
claude
committed
bc46b99
docs(llc): note where widening happens for recover

xsahil03x
and
claude
committed
39952e5
fix(llc): compare a replacement provider by instance, not by equality

xsahil03x
and
claude
committed
c03f7fd
Merge feat/token-manager-user-switching into feat/ws-connection-lifecycle
xsahil03x
committed
32c5a40
fix(llc): do not open a socket while the previous one is still closing

xsahil03x
and
claude
committed
b0f94d1
feat(llc): bound a token load so one provider cannot block the rest

xsahil03x
and
claude
committed
0605c01
Merge feat/token-manager-user-switching into feat/ws-connection-lifecycle
xsahil03x
committed
47b346d
Revert "feat(llc): bound a token load so one provider cannot block the rest"

xsahil03x
and
claude
committed
19a1a91
Merge feat/token-manager-user-switching into feat/ws-connection-lifecycle
xsahil03x
committed
e321b8e
fix(llc): allow 30 seconds for a connection to establish, not 15

xsahil03x
and
claude
committed
e3d700b
test(llc): keep a connection alive the way production does

xsahil03x
and
claude
committed
7c772d5
test(llc): let the connect-timeout tests reach the state they are about

xsahil03x
and
claude
committed
68cedda
docs(llc): say that a provider's equality is never consulted

xsahil03x
and
claude
committed
4253b38
Merge feat/token-manager-user-switching into feat/ws-connection-lifecycle
xsahil03x
committed
d88bb57
Revert "fix(llc): compare a replacement provider by instance, not by equality"

xsahil03x
and
claude
committed
7a19674
Merge feat/token-manager-user-switching into feat/ws-connection-lifecycle
xsahil03x
committed
c613345
refactor(llc): name the anonymous token's claim as the user id it is

xsahil03x
and
claude
committed
a2e4abe
Merge feat/token-manager-user-switching into feat/ws-connection-lifecycle
xsahil03x
committed
b3454b7
fix(llc): recover connections that existed, not attempts that never landed

xsahil03x
and
claude
committed
300908c
fix(llc): hand connecting back to the caller after a deliberate disconnect

xsahil03x
and
claude
committed
0737726
docs(llc): describe the recovery gate as it ended up

xsahil03x
and
claude
committed
2ad554c
refactor(llc): make the connection-state switch a dispatch, not a body

xsahil03x
and
claude
committed
f4a8f73
feat(llc): reconnect an expired token only when another one exists

xsahil03x
and
claude
committed
72b1447
fix(llc): classify token errors the way the iOS SDK does

xsahil03x
and
claude
committed
1949cbc
refactor(llc): keep the reconnection rules in the switch

xsahil03x
and
claude
committed
0a6d8e6
refactor(llc): name the close code with the type that models close codes

xsahil03x
and
claude
committed
e4ac1b4
fix(llc): reconnect after a rate limit, which clears on its own

xsahil03x
and
claude
committed
dd48bce
fix(llc): let the caller replace a refused token, and stop trying to help

xsahil03x
and
claude
committed
0e4b96a

Commits on Aug 21, 2026

Commits on Aug 24, 2026

feat(llc)!: keep an authenticated attempt to the attempt it belongs to

xsahil03x
and
claude
committed
d568f05
fix(llc): read a Stream error from a body the server sent as text

xsahil03x
and
claude
committed
b30ab0f
docs(llc): tighten the docs the connection work touched

xsahil03x
and
claude
committed
b33ef0a
test(llc): drive the websocket client through a fake server

xsahil03x
and
claude
committed
e7bd778
test(llc): rebuild the auth interceptor tests around one fake backend

xsahil03x
and
claude
committed
89db687
test(llc): drop tests that restate the source

xsahil03x
and
claude
committed
55c8f6c
docs(llc): record the connection work in the changelog

xsahil03x
and
claude
committed
0ad17b3
fix(llc): replace a cached token the server would refuse for having expired

xsahil03x
and
claude
committed
863c881
Merge branch 'feat/token-manager-user-switching' into feat/ws-connection-lifecycle
xsahil03x
committed
086bdc9
fix(llc): stop an auth retry crossing a user switch

xsahil03x
and
claude
committed
ba53f98
fix(llc): record an authentication failure on a connection already down

xsahil03x
and
claude
committed
f95b138
refactor(llc): ask a disconnection source whether it is worth reconnecting

xsahil03x
and
claude
committed
b5c34ee
test(llc): pin the refusal handed on after a closure not worth retrying

xsahil03x
and
claude
committed
9c666e0
fix(llc): report why a handshake failed, so a retry does not end the recovery

xsahil03x
and
claude
committed
cc4ae54
docs(llc): correct the connection docs that describe what the code does not do

xsahil03x
and
claude
committed
a790721
docs(repo): follow Effective Dart on referring to parameters

xsahil03x
and
claude
committed
03d5648
docs(llc): document what a Dio error converts into, not how it is read

xsahil03x
and
claude
committed
ece0b67
docs(llc): name whose response, and say the fallback once

xsahil03x
and
claude
committed
0763f3f
refactor(llc): read a Stream error from one place, whichever way it arrived

xsahil03x
and
claude
committed
bd9b2dd
docs(llc): drop what the field these two methods write already says

xsahil03x
and
claude
committed
616fc9c
docs(llc): say it plainly

xsahil03x
and
claude
committed
d08dfd3
refactor(llc): abandon a failed attempt as a chain, not a branch

xsahil03x
and
claude
committed
c4c0839
refactor(llc): report a failed close as a chain too

xsahil03x
and
claude
committed
990707a
fix(llc): do not leave a failed attempt disconnecting when its socket will not close

xsahil03x
and
claude
committed
049e1a1
refactor(llc): abandon a failed attempt through disconnect

xsahil03x
and
claude
committed
49679be
refactor(llc): read the error off the result rather than destructuring it

xsahil03x
and
claude
committed
32ff783
refactor(llc): abandon a failed attempt with getOrElse

xsahil03x
and
claude
committed
8421c01
refactor(llc): use getOrElse on both failure paths

xsahil03x
and
claude
committed
86ab178
feat(llc): report an attempt that never opened a socket as its own source

xsahil03x
and
claude
committed
c8807dc
Revert "feat(llc): report an attempt that never opened a socket as its own source"

xsahil03x
and
claude
committed
927bdee
docs(llc): drop a changelog entry for a bug that never shipped, and fix the example

xsahil03x
and
claude
committed
223d643
docs(llc): name the right product, and key the reconnection rules to their sources

xsahil03x
and
claude
committed
c1f707a
docs(llc): share the reconnection rules through a macro

xsahil03x
and
claude
committed
d4c9de2
style(llc): name the engine exception through the dot shorthand

xsahil03x
and
claude
committed
33deddb
docs(llc): trim the changelog to what a consumer needs

xsahil03x
and
claude
committed
be4bc4a
docs(llc): fold the changelog entries that share a cause

xsahil03x
and
claude
committed
dd17dae
Merge branch 'main' into feat/ws-connection-lifecycle

xsahil03x
and
claude
committed
1b0af24
docs(llc): state the engine contract as obligations, not as observations

xsahil03x
and
claude
committed
24fd7a9
docs(llc): describe the engine's behaviour, not the implementer's duty

xsahil03x
and
claude
committed
d096fe4
fix(llc): keep a stale handshake or closure from reporting on its successor

xsahil03x
and
claude
committed
885a3fa
fix(llc): ignore a pong that lands before the credentials go out

xsahil03x
and
claude
committed
c2b7959
fix(llc): tell a newer refusal from the one being answered by identity

xsahil03x
and
claude
committed
e7c5236
docs(changelog): log the Dart SDK bump as a breaking change

xsahil03x
and
claude
committed
8756fa4
fix(llc): leave the unset connect details out of the payload

xsahil03x
and
claude
committed
1bb50a4
test(llc): cover how a refused request is turned into an exception

xsahil03x
and
claude
committed
61a0045
docs(llc): say the connection comments in one line where one will do

xsahil03x
and
claude
committed
a0e5762
revert(llc): restore the logger files this PR never meant to remove
xsahil03x
committed
df49bb8
feat(llc): let a disconnection source report what closed the connection

xsahil03x
and
claude
committed
61d45d8
docs(changelog): say what `cause` is, not why it exists

xsahil03x
and
claude
committed
385d4b5
docs(llc): say what `cause` hands back, not how it is put together

xsahil03x
and
claude
committed
c3050fc

Commits on Aug 25, 2026

style(llc): give the disconnection source getters expression bodies

xsahil03x
and
claude
committed
37c5038
docs(changelog): list the connectTimeout change as breaking

xsahil03x
and
claude
committed
0fd5c2d
docs(llc): stop the pong guard claiming it tracks credentials

xsahil03x
and
claude
committed
8b82cd3
refactor(llc): name the states a pong means something in

xsahil03x
and
claude
committed
85c4830
style(llc): read the connection state the way the other guards do

xsahil03x
and
claude
committed
ea83422
refactor(llc): decide on a health check where the other events are decided

xsahil03x
and
claude
committed
3c61b94
fix(llc): stop a token arriving late from ending automatic reconnection

xsahil03x
and
claude
committed
8394950
Merge branch 'main' into feat/ws-connection-lifecycle

xsahil03x
and
claude
committed
c1673ef
docs(changelog): drop the fix for a fault that never shipped

xsahil03x
and
claude
committed
d7c793c
fix(llc): drop a health check the client declined, and pin the staleness rule where it lives

xsahil03x
and
claude
committed
762c7ce
docs(changelog): say what the connect timeout means for a caller

xsahil03x
and
claude
committed
1b5c90a
style(llc): format the handler test file

xsahil03x
and
claude
committed
086748c