Skip to main content

serverpod_offline_sync_server 0.0.12 copy "serverpod_offline_sync_server: ^0.0.12" to clipboard
serverpod_offline_sync_server: ^0.0.12 copied to clipboard

Server module for the Serverpod Offline Sync project.

0.0.12 #

  • fix: BREAKING. Each user has their own clock per database, so users writing in different spaces no longer wait on each other. Existing local clocks will be reset with this change. Several interfaces have changed:
    • HlcManager.forSpace is replaced by HlcManager(spaceId, node).
    • mergeChanges takes the syncing userId separately from spaceId.
    • recordSyncCheckpoint takes spaceId instead of userId.
    • transactionForUser locks the user's clock and the space for read and write.
    • Orders writes after facts other users committed to the same space.
  • feat: Add transactionForSpaces(userId, spaceIds, fn) and awaited spaces.runForSpace(spaceId, fn) scopes for atomic local writes across declared spaces, using the acting user's clock. Nested failures roll back their domain, CRDT, and in-memory clock changes.
  • fix: Reject tracked reads and writes between multi-space scopes, including through persistent-user wrappers, and recheck membership within each scope.
  • fix: Reload persistent-user clocks after caller savepoint rollbacks so concurrent commits cannot cause later writes to be skipped by sync.
  • fix: Prevents a local updateBatch from failing with no rows updated when it moves rows to a deleted parent that a restricting child still keeps visible.
  • perf: Keeps SQLite inserts batched when projected nulls and database defaults differ between rows.
  • chore: Requires Serverpod ^4.1.0.

0.0.11 #

  • feat: Supports Serverpod 4.1 typed SQLite watch API with CRDT visibility and live space membership, including nested included lists.
  • fix: Preserves caller include graphs across queries and keep nested object visibility predicates inside their containing list query.
  • chore: Requires Serverpod ^4.1.0-beta.3.

0.0.10 #

  • fix: Prevents concurrent edits from being skipped during sync.
  • fix: Prevents database operations on the web from hanging inside transactions.
  • fix: Respects space access changes made in the same transaction.
  • fix: Prevents sync from stalling after reconnects, including when the device clock moves backward.
  • fix: Prevents previously synced data from being repeatedly resent after reconnects.
  • fix: Rejects checkpoints attributed to the wrong node with ArgumentError.
  • fix: Keeps unique-conflict results consistent across devices after updates and upserts.
  • fix: Keeps foreign key defaults consistent across devices when an upsert supplies null, including after a previously referenced record is restored.
  • perf: Improves performance when applying synced changes.
  • perf: Improves conflict resolution performance.
  • chore: Requires Serverpod >=4.0.4 <4.1.0.

0.0.9 #

  • fix: Refreshes node clocks across sync wrappers.
  • fix: Repairs foreign keys on columns that also carry a unique claim.
  • chore: Release the Serverpod dependency version to ^4.0.0.

0.0.8 #

  • fix: BREAKING. Reject unique-text values ending in __conflict__<UUID>, __hidden__<UUID>, or __park__<UUID>, and unique version-8 UUIDs (except primary keys, foreign keys, and nullable UUID columns). Local writes and incoming sync throw OfflineSyncReservedValueException for these values.
  • fix: Enforce database unique constraints on local writes and restores, and reject upsert batches that target the same record more than once.
  • fix: Retain upserted values and explicit nulls when replacing a conflicting value, including upserts matched through another unique index.
  • fix: Treat restored rows as fresh writes so field values and conflict ages stay consistent across sync and bootstrap.
  • fix: Preserve UUID-shaped text and binary values during conflict resolution and sync, and encode restored values according to their column types.
  • fix: Show UUIDs correctly in errors for references to deleted records.

0.0.7 #

  • fix: Keep non-synced updateRow calls in the test harness transaction.
  • fix: Allow generated client sync sessions to close their SQLite connections.
  • fix: Resolve shared-package models and enums during projection and sync.
  • fix: Preserve boolean types when syncing SQLite column updates.
  • fix: Preserve JSON and JSONB field types and values through inserts, updates, and explicit nulls.

0.0.6 #

  • refactor: BREAKING. Rename integration APIs and ownership scopes:
    • Rename CrdtDatabase* wrappers to OfflineSyncDatabase*.
    • Rename CrdtSync to OfflineSyncEngine and CrdtSyncSession to OfflineSyncSubscription.
    • Access sync through .offlineSync and .offlineSyncDb instead of .crdt and .crdtDb.
    • Replace CrdtScope* models and services with OfflineSyncSpace*
    • Change access to shared spaces through .spaces instead of .scopes.
    • Use spaceId in models and indexes, and offline_sync_spaces in ownership relations.
    • Initialize with initializeOfflineSync and use offlineSyncDatabaseInterceptor.
    • Import client helpers from offline_sync.dart instead of crdt.dart.
    • Rename the synchronization endpoint, serialized events, and space metadata tables.
  • fix: Recompute onDelete=SetDefault repairs when default targets are inserted, deleted, restored, or hidden to preserve authored values.
  • fix: Reject local deletes atomically when a needed SetDefault target is missing, hidden, owned by another space, or deleted in the same batch.
  • fix: Preserve projection-selected nulls during inserts instead of reapplying column defaults, and apply fixed UUID foreign-key defaults in local upserts.
  • fix: Resolve composite unique conflicts when only a fixed discriminator column changes.
  • perf: Avoid redundant foreign-key projection for ordinary local writes and primary-key upserts, and batch dependency checks and field-clock writes.
  • perf: Overlap independent membership reads and skip unnecessary space lookups for untracked tables.
  • chore: Update Serverpod to 4.0.0 and use the published CLI.

0.0.5 #

  • fix: BREAKING. Rebuilds foreign key and unique projection from authored facts.
  • perf: Increases unique-conflict merge throughput by ~40%.
  • perf: Increases foreign-key chain insert merge throughput by ~3.3×.
  • perf: Increases foreign-key chain delete merge throughput by ~44%.
  • perf: Reduces storage used by CRDT metadata on relations.
  • chore: Updated Serverpod to 4.0.0-rc.2.

0.0.4 #

  • chore: Updated Serverpod to 4.0.0-rc.1.

0.0.3 #

  • fix: Requires non-nullable foreign keys to be deferred.
  • fix: Rejects onDelete=Restrict on synced tables in favor of onDelete=NoAction.
  • fix: Throws proper DatabaseException instead of bare Exception on the database.
  • chore: Updated Serverpod to 4.0.0-rc.1.

0.0.2 #

  • fix: Skips tracking FKs for relations with non-sync tables.
  • fix: Fixes batch insert of previously tombstoned rows not being tracked correctly.
  • refactor: Moves the core implementation to the serverpod_offline_sync shared package.
  • chore: Updated Serverpod to 4.0.0-beta.2.

0.0.1 #

  • chore: Initial version.
1
likes
160
points
4.96k
downloads

Documentation

API reference

Publisher

verified publisherserverpod.dev

Weekly Downloads

Server module for the Serverpod Offline Sync project.

Repository (GitHub)
View/report issues

License

BSD-3-Clause (license)

Dependencies

meta, serverpod, serverpod_database, serverpod_offline_sync

More

Packages that depend on serverpod_offline_sync_server