feat(llc)!: rework the error layer around a sealed StreamException root - #168

Open

xsahil03x wants to merge 60 commits into

mainfrom

feat/error-layer

Commits on Aug 27, 2026

wip: error layer design doc and ClientException cleanup (temp)

xsahil03x
and
claude
committed
52f2712
wip: error layer implementation against old main (pre-rebase checkpoint)

xsahil03x
and
claude
committed
114df46
feat(llc)!: rework the error layer around a sealed StreamException root

xsahil03x
and
claude
committed
b7b0acd
docs(llc): state the real reason details tolerates non-numeric shapes

xsahil03x
and
claude
committed
07d636b
docs(llc): keep server-side specifics out of the public dartdoc

xsahil03x
and
claude
committed
f2e2225
docs(llc): split a two-sentence first paragraph per Effective Dart

xsahil03x
and
claude
committed
0506968
docs(llc): describe the auth exception's condition in one tense

xsahil03x
and
claude
committed
adcd050
style(llc): conform the error layer to the repo style guide

xsahil03x
and
claude
committed
a7c0b92
docs(repo): vendor Effective Dart's documentation guide and point the rulebooks at it

xsahil03x
and
claude
committed
ee189e4
feat(llc): name the API's error-code registry as StreamErrorCode

xsahil03x
and
claude
committed
fc61344
docs(llc): sharpen three error-code descriptions against their real conditions

xsahil03x
and
claude
committed
8a2e933
feat(llc): type StreamApiError.code as StreamErrorCode

xsahil03x
and
claude
committed
d61ab86
refactor(llc): put the code predicates on StreamErrorCode and adopt chat's json pattern

xsahil03x
and
claude
committed
47fda4b
refactor(llc): follow chat's hand-written extension-type conventions

xsahil03x
and
claude
committed
0828790
docs(llc): repoint the exception's predicate references at the code constants

xsahil03x
and
claude
committed
c2b862b
refactor(llc): drop the runtimeType ignores for Flutter's assert-gated pattern

xsahil03x
and
claude
committed
51f8c48
refactor(llc): print every fact that changes what a caller does, and build fromApiError as a factory

xsahil03x
and
claude
committed
af5769e
feat(llc): ship objectRuntimeType as a core utility

xsahil03x
and
claude
committed
362e184
style(llc): adapt objectRuntimeType to this repo's stricter lints

xsahil03x
and
claude
committed
76c7f7b
refactor(llc): give every exception kind its own independent toString

xsahil03x
and
claude
committed
9ae25ac
docs: state precisely who sets unrecoverable

xsahil03x
and
claude
committed
e142e53
docs: write the retry decision procedure into the error layer doc

xsahil03x
and
claude
committed
64b104d
docs: correct the retry table against the backend's raise sites

xsahil03x
and
claude
committed
413d380
docs(repo): follow the vendored guide's rename in its references

xsahil03x
and
claude
committed
d8d5e22
docs(llc): scope unrecoverable to Video, the one product that sets it deliberately

xsahil03x
and
claude
committed
61d8ea1
feat(llc): ship the retry helpers — isRetriable and RetryPolicy.standard()

xsahil03x
and
claude
committed
92311ea
refactor(llc): route the provider load through Result

xsahil03x
and
claude
committed
c9e8a89
docs: teach the errors-vs-exceptions split where contributors look

xsahil03x
and
claude
committed
365f911
fix(llc)!: raise conditions as exceptions everywhere the audit found errors

xsahil03x
and
claude
committed
873f1dc
fix(llc): let Dio supply the missing stack trace

xsahil03x
and
claude
committed
809a166
fix(llc): keep the classification of a Stream exception Dio wrapped

xsahil03x
and
claude
committed
f2c811c
feat(llc): add runApiSafely, the call seam that delivers StreamExceptions

xsahil03x
and
claude
committed
d203b10
style(llc): shape runApiSafely the way runSafely reads

xsahil03x
and
claude
committed
5e7f462
style(llc): drop async from runApiSafely test closures the FutureOr signature made needless

xsahil03x
and
claude
committed
6a2a5ac
refactor(llc): give the WebSocket client one error boundary, shaped like the HTTP one

xsahil03x
and
claude
committed
adaa24c
refactor(llc): share the boundary normalization as StreamException.from

xsahil03x
and
claude
committed
bdbb35a
style(llc): flatten the boundary fallbacks onto tryFrom and ??

xsahil03x
and
claude
committed
7ca5825
style(llc): normalize boundary errors as a named local filled by ??=

xsahil03x
and
claude
committed
7f14316
refactor(llc): hand the authentication failure's stack trace to onFailure

xsahil03x
and
claude
committed
eca45e8
style(llc): expression-body tryFrom and accept a nullable error

xsahil03x
and
claude
committed
10b5ae0
fix(llc)!: make the engine's failures speak the exception kinds

xsahil03x
and
claude
committed
8b77a56
refactor(llc): keep the engine dumb — the client is the normalization seam

xsahil03x
and
claude
committed
5c34b0b
refactor(llc): let the engine report raw truth on send too

xsahil03x
and
claude
committed
c395571
refactor(llc): report a double open through the Result like every engine outcome

xsahil03x
and
claude
committed
29c26fd
feat(llc)!: shape the attachment uploader for its real consumers

xsahil03x
and
claude
committed
1000b12
test(llc): cover the attachment uploader properly

xsahil03x
and
claude
committed
40b75d1
test(llc): cover the upload cancellation flows the chat SDK drives

xsahil03x
and
claude
committed
dda2280
test(llc): cover the remaining chat upload flows in the uploader

xsahil03x
and
claude
committed
2225b8f
feat(llc): let uploadAll skip failures instead of failing as one

xsahil03x
and
claude
committed
88631e1
feat(llc): report the eager batch failure as an outcome, not a throw

xsahil03x
and
claude
committed
a16b8f1

Commits on Aug 28, 2026

revert(llc): hold the attachment uploader rework back for a follow-up

xsahil03x
and
claude
committed
e02b77f
Merge remote-tracking branch 'origin/main' into feat/error-layer
xsahil03x
committed
e1710e1
revert(llc): pull the retry helpers until chat consumes them

xsahil03x
and
claude
committed
d47a7a1
fix(llc): address the review — apiError counts in equality, docs match the seams

xsahil03x
and
claude
committed
d1effc5
fix(llc): close the review's gaps — send gets its seam, auth reconnect reads the facts

xsahil03x
and
claude
committed
1294f0e
style(llc): drop an async the no-op connect never needed

xsahil03x
and
claude
committed
a3c5ae0
test(llc): keep only the tests that pin a decision

xsahil03x
and
claude
committed
153282b
docs(changelog): one short bullet per entry, the way the policy asks

xsahil03x
and
claude
committed
e847a0b
docs(changelog): speak only of what shipped, in the file's own voice

xsahil03x
and
claude
committed
12697a8
docs: teach the no-code case in the catch example

xsahil03x
and
claude
committed
536e56d