Skip to content

5.1.0

Choose a tag to compare

@gfreezy gfreezy released this 13 Sep 09:46
· 10 commits to main since this release

Adds @Entity(sync: false) for local-only entities in a database that also contains synchronized entities.

  • Local-only entities retain normal schema migrations, CRUD, writable field requirements, and shared transactions. Writable entities participate in sync by default; readonly entities do not.
  • Change tracking and initial snapshots exclude local-only entities.
  • Uploads skip existing logs for explicitly local-only entities. The upload cursor advances only through a continuous prefix of skipped or confirmed events, without crossing an unconfirmed synchronized event. Entirely local batches are confirmed locally without empty CloudKit uploads.
  • Downloads ignore explicitly local-only entities and commit the page checkpoint normally. Unknown entity types and invalid synchronized records still block progress.
  • Sync participation is fixed for a manager lifetime. The option does not delete existing cloud records or define a resynchronization policy for re-enabling an entity.

Validation: 406 tests passed after a clean build during implementation, with no compiler warnings. Local tests, builds, formatting and lint checks were skipped for this release as requested. The release workflow builds, smoke-tests, packages and verifies the published macOS arm64 CLI.

Usage documentation · Sync architecture