Skip to content

Custom Checkpoint Request Rollout Docs - #614

Draft
stevensJourney wants to merge 1 commit into
mainfrom
custom-checkpoints-rollout-docs
Draft

Custom Checkpoint Request Rollout Docs#614
stevensJourney wants to merge 1 commit into
mainfrom
custom-checkpoints-rollout-docs

Conversation

@stevensJourney

Copy link
Copy Markdown
Contributor

Existing users of custom write checkpoints will most likely need to upgrade to custom checkpoint requests in the future. During an upgrade, developers will probably need to simultaneously cater for older applications which still use legacy custom write checkpoints and newer applications which use checkpoint requests.

On the PowerSync service side, the behaviour for the two share quite a lot of implementation. The main difference is that the newer checkpoint requests are temporary - they are deleted after a period. This is fine since those requests are retried by the client. Legacy write checkpoints are not temporary, they should not be deleted.

The PowerSync service needs some manner to distinguish between the two checkpoint events. This adds docs for that and some general recommendations for rolling out an upgrade to checkpoint_requests.

For context of limitations and implementations, see:

AI usage: These docs were generated with the help of Codex 5.6.

@mintlify

mintlify Bot commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
powersync 🟢 Ready View Preview Sep 2, 2026, 8:45 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

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