Skip to content

docs(capability-matrix): add specs for database and storage auto_retry - #190

Draft
grdsdev wants to merge 1 commit into
mainfrom
guilherme/sdk-1791-auto-retry-specs
Draft

grdsdev wants to merge 1 commit into
mainfrom
guilherme/sdk-1791-auto-retry-specs

Conversation

@grdsdev

@grdsdev grdsdev commented Sep 15, 2026

Copy link
Copy Markdown
Collaborator

Adds spec files for two existing feature IDs that had none:

  • database.configuration.auto_retry — the fixed postgrest-js rule: GET/HEAD only, 503/520 only, 4 attempts, a per-client switch and a per-request override of that switch, and nothing else configurable. Full-jitter capped backoff, Retry-After honoured up to the cap, stop on cancellation, X-Retry-Count on replays, and no retry of errors thrown by caller-supplied code.
  • storage.configuration.auto_retry — the configurable counterpart: idempotent methods (or any method with an Idempotency-Key), the transient status set including Cloudflare 520–524/530, a configurable attempt count with 1 meaning off, and the rule that a one-shot upload body is never replayed.

Both describe observable behavior only, per CONTRIBUTING. npm run validate passes (OK — capability matrix is valid.).

Written alongside the Swift implementation in supabase/supabase-swift#1341, which declares both features implemented in its sdk-compliance.yaml. Linear: SDK-1791.

PostgREST's rule is fixed (GET/HEAD, 503/520, 4 attempts, on/off switch
only); Storage's is configurable. Both share full-jitter capped backoff,
Retry-After honoured up to the cap, stop on cancellation, and no replay
of one-shot bodies or of errors thrown by caller-supplied code.

Refs SDK-1791, supabase/supabase-swift#1341.

Co-Authored-By: Claude <[email protected]>
@coderabbitai

coderabbitai Bot commented Sep 15, 2026

Copy link
Copy Markdown

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

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