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

Merged

xsahil03x merged 78 commits into

mainfrom

feat/error-layer

Sep 2, 2026

Commits on Aug 31, 2026

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

xsahil03x
and
claude
authored
ac38fe8
wip: error layer implementation against old main (pre-rebase checkpoint)

xsahil03x
and
claude
authored
550f8a2
feat(llc)!: rework the error layer around a sealed StreamException root

xsahil03x
and
claude
authored
27623c1
docs(llc): state the real reason details tolerates non-numeric shapes

xsahil03x
and
claude
authored
160f82d
docs(llc): keep server-side specifics out of the public dartdoc

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

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

xsahil03x
and
claude
authored
df819db
style(llc): conform the error layer to the repo style guide

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

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

xsahil03x
and
claude
authored
749f2e6
docs(llc): sharpen three error-code descriptions against their real conditions

xsahil03x
and
claude
authored
d67b261
feat(llc): type StreamApiError.code as StreamErrorCode

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

xsahil03x
and
claude
authored
eedb704
refactor(llc): follow chat's hand-written extension-type conventions

xsahil03x
and
claude
authored
1cb0f4a
docs(llc): repoint the exception's predicate references at the code constants

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

xsahil03x
and
claude
authored
4466ff1
refactor(llc): print every fact that changes what a caller does, and build fromApiError as a factory

xsahil03x
and
claude
authored
8d7a513
feat(llc): ship objectRuntimeType as a core utility

xsahil03x
and
claude
authored
2daafb8
style(llc): adapt objectRuntimeType to this repo's stricter lints

xsahil03x
and
claude
authored
4b1f6c7
refactor(llc): give every exception kind its own independent toString

xsahil03x
and
claude
authored
c542528
docs: state precisely who sets unrecoverable

xsahil03x
and
claude
authored
244cb0e
docs: write the retry decision procedure into the error layer doc

xsahil03x
and
claude
authored
fe44228
docs: correct the retry table against the backend's raise sites

xsahil03x
and
claude
authored
0650fab
docs(repo): follow the vendored guide's rename in its references

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

xsahil03x
and
claude
authored
c8f20ab
feat(llc): ship the retry helpers — isRetriable and RetryPolicy.standard()

xsahil03x
and
claude
authored
c409dd8
refactor(llc): route the provider load through Result

xsahil03x
and
claude
authored
deeb26d
docs: teach the errors-vs-exceptions split where contributors look

xsahil03x
and
claude
authored
60a7f63
fix(llc)!: raise conditions as exceptions everywhere the audit found errors

xsahil03x
and
claude
authored
b5c3c84
fix(llc): let Dio supply the missing stack trace

xsahil03x
and
claude
authored
aa72796
fix(llc): keep the classification of a Stream exception Dio wrapped

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

xsahil03x
and
claude
authored
d720cf8
style(llc): shape runApiSafely the way runSafely reads

xsahil03x
and
claude
authored
6d2d9a1
style(llc): drop async from runApiSafely test closures the FutureOr signature made needless

xsahil03x
and
claude
authored
3b7930e
refactor(llc): give the WebSocket client one error boundary, shaped like the HTTP one

xsahil03x
and
claude
authored
5511d47
refactor(llc): share the boundary normalization as StreamException.from

xsahil03x
and
claude
authored
544510b
style(llc): flatten the boundary fallbacks onto tryFrom and ??

xsahil03x
and
claude
authored
bad8ac8
style(llc): normalize boundary errors as a named local filled by ??=

xsahil03x
and
claude
authored
5a54594
refactor(llc): hand the authentication failure's stack trace to onFailure

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

xsahil03x
and
claude
authored
e085232
fix(llc)!: make the engine's failures speak the exception kinds

xsahil03x
and
claude
authored
c53a1f3
refactor(llc): keep the engine dumb — the client is the normalization seam

xsahil03x
and
claude
authored
b6d2b36
refactor(llc): let the engine report raw truth on send too

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

xsahil03x
and
claude
authored
4b64adc
feat(llc)!: shape the attachment uploader for its real consumers

xsahil03x
and
claude
authored
2f11eaf
test(llc): cover the attachment uploader properly

xsahil03x
and
claude
authored
ac1108b
test(llc): cover the upload cancellation flows the chat SDK drives

xsahil03x
and
claude
authored
37558d4
test(llc): cover the remaining chat upload flows in the uploader

xsahil03x
and
claude
authored
0c374dc
feat(llc): let uploadAll skip failures instead of failing as one

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

xsahil03x
and
claude
authored
03d8d05
revert(llc): hold the attachment uploader rework back for a follow-up

xsahil03x
and
claude
authored
5bfed7a
revert(llc): pull the retry helpers until chat consumes them

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

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

xsahil03x
and
claude
authored
b9e0365
style(llc): drop an async the no-op connect never needed

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

xsahil03x
and
claude
authored
d3c76b4
docs(changelog): one short bullet per entry, the way the policy asks

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

xsahil03x
and
claude
authored
5eb3ae3
docs: teach the no-code case in the catch example

xsahil03x
and
claude
authored
59adec5
fix(llc): reconnect on a server-side processing timeout, and stop parsing errors twice

xsahil03x
and
claude
committed
1aed17b
revert(llc): leave the error mapping to ApiErrorInterceptor alone

xsahil03x
and
claude
committed
2a111ef
refactor(llc): name the 408 condition rather than matching the number

xsahil03x
and
claude
committed
6d158c6
docs(llc): say what a 408 is without guessing which end was slow

xsahil03x
and
claude
committed
c1cedd1
fix(llc): stop reconnecting on a timeout a socket cannot deliver

xsahil03x
and
claude
committed
302add2
revert(llc): drop isRequestTimeout until something needs it

xsahil03x
and
claude
committed
f69edec
fix(llc)!: stop re-exporting dart:typed_data from the barrel

xsahil03x
and
claude
committed
13e6af8
docs(llc): say when a failed authentication reconnects, and read it that way

xsahil03x
and
claude
committed
9c1e57a

Commits on Sep 1, 2026

fix(llc): let a token provider name the moment, not the credentials

xsahil03x
and
claude
committed
790ee43
fix(llc): stop exporting objectRuntimeType, which collides with Flutter's

xsahil03x
and
claude
committed
7f7569b
docs: reconcile the two 408 rows, and say what misuse still throws

xsahil03x
and
claude
committed
ec62b0e
fix(llc): classify what the HTTP client could not read

xsahil03x
and
claude
committed
4f4343f
fix(llc): decode an error payload missing the fields that carry least

xsahil03x
and
claude
committed
da1dbd8
fix(llc): classify a token provider's transport failure

xsahil03x
and
claude
committed
73d172c
fix(llc): tell misuse from a condition, and keep the trace beside the failure

xsahil03x
and
claude
committed
275dad5
docs: say where the connection path parts from the retry table

xsahil03x
and
claude
committed
ca848a0
docs(changelog): record what this round changed

xsahil03x
and
claude
committed
ac6e9e1
docs(changelog): say that exceptions stopped carrying a trace

xsahil03x
and
claude
committed
3f55637
docs: say where a stack trace lives in the error layer

xsahil03x
and
claude
committed
5730f8c