feat(core): add TAPI error classification types and utilities#1156
Merged
feat(core): add TAPI error classification types and utilities#1156
Conversation
3 tasks
abueide
force-pushed
the
tapi/types-and-errors
branch
2 times, most recently
from
eedad38 to
36997ac
Compare
packages/core/src/types.ts
Outdated
| * When true, automatically triggers a flush when the retry manager's wait | ||
| * period expires and transitions back to READY. Disabled by default. | ||
| */ | ||
| autoFlushOnRetryReady?: boolean; |
Contributor
There was a problem hiding this comment.
likewise. Part of me wants this to go in every SDK, but I think existing flush policy with timers is enough control for users.
Open to debating it tho
Contributor
Author
There was a problem hiding this comment.
I can agree I don't have any qualms with removing it.
4 tasks
abueide
force-pushed
the
tapi/types-and-errors
branch
3 times, most recently
from
b1cd5f5 to
ff837e7
Compare
Add foundation types (HttpConfig, BackoffConfig, RateLimitConfig, ErrorClassification) and error classification utilities (classifyError, parseRetryAfter, translateHTTPError improvements) for TAPI-compliant retry handling. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Remnants from the removed BackoffManager and UploadStateMachine classes, never imported anywhere. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Convert ErrorClassification from a plain type to a class with a getter, eliminating redundant isRetryable field that was always derivable from errorType !== 'permanent'. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
parseRetryAfter now returns undefined for negative seconds instead of falling through to date parsing where the behavior was ambiguous. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…verage Use regex /^\d+$/ instead of parseInt to prevent date strings starting with digits from being misclassified as seconds. Add test for 429+override='drop' precedence and date-string edge case. Run formatter to fix CI. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Restore JSDoc on ErrorType enum and inline comments in translateHTTPError that were inadvertently removed during cleanup. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Redundant with TimerFlushPolicy which already drives periodic flushes. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
abueide
force-pushed
the
tapi/types-and-errors
branch
from
ff837e7 to
a3ac0e5
Compare
- Remove retryStrategy config option from Config type (hardcoded to eager in RetryManager downstream) - Add 14 SDD-default config tests verifying all spec status codes (408/410/460=retry, 501/505=drop, 429=rate_limit, etc.) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
abueide
force-pushed
the
tapi/types-and-errors
branch
from
ec82caa to
6b03226
Compare
MichaelGHSeg
approved these changes
Mar 19, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
HttpConfig,BackoffConfig,RateLimitConfig,ErrorClassification, and related config fields toConfigandSegmentAPISettingsclassifyError(),parseRetryAfter(), and improvedtranslateHTTPError()parseRetryAfterto use strict/^\d+$/regex instead ofparseInt, preventing date strings starting with digits from being misclassified as secondsstatusCodeOverride='drop'precedence behaviorformat-checkPR 1 of 5 in the TAPI backoff/retry stack. See #1154 for full context.
Test plan
parseRetryAfter("01 Jan 2026 00:01:00 GMT")correctly parses as date (60s), not as integer (1s)classifyError(429, { statusCodeOverrides: { '429': 'drop' } })returnspermanentformat-checkpasses🤖 Generated with Claude Code