Changed: Improved clarity of error messages when data on disk cannot be read by this version following a downgrade from a newer version of Ditto. (#9267)

Changed: Print some internal errors in a more human-readable format. (#9495)

Fixed: a potential crash if a document attachment was malformed (#9045)

Fixed: a crash when using the

Synchronized version bump release

Added: dSYMs are now bundled inside the XCFramework to improve crash report symbolication.

Changed: The dSYMs directory has been removed from the root directory of the CocoaPods artifact since it's no longer required now that dSYMs are bundled inside XCFreameworks.

Fixed: Resolved an issue with logging when the stdout is not available.

Fixed: Issue where Ditto instance using

Fixed: Potential crash on Windows and Linux from invoking

Changed: some threads spawned by the SDK no longer wait up to 30 seconds before being stopped.

Changed: added more logging when a peer is unable to connect to another peer because of no overlapping supported protocol versions.

Fixed: replication hanging under some circumstances, especially WebSocket connections to Big Peer

Fixed: canceling subscriptions for queries with args would not work, the subscription would remain active indefinitely.

Fixed: some memory leaks.

Changed: Slow or blocked write transactions now log hints showing the waiting and blocking transactions

Fixed: an issue that could cause Ditto to hang if more than 500 peers were encountered.

Resolved an issue where presence evictions could deadlock on startup with large numbers of peers

Fixed issue preventing clean Ditto shutdown

Added: DiskUsage class which can be used to monitor disk usage.

Added: diskUsage property to Ditto class for access to a DiskUsage instance.

Added: diskUsagePublisher() method to Ditto class, returning a DiskUsagePublisher.

Added: DiskUsageItem class which contains data about the space used by files in the Ditto working directory.

Changed: better readability of data sizes and durations in logs.

Removed: the DittoRGA constructor. You cannot create new RGAs.

Removed: the deprecated DittoMutableRGA type. You cannot mutate existing RGAs.

Deprecated: DittoDocument.typed<Codable>(as:) method.

Deprecated: DittoMutableDocument.typed<Codable>(as:) method.

Deprecated: DittoTypedDocument<Decodable> class.

Deprecated: DittoCollection.upsert<Encodable>(_,writeStrategy:) method.

Deprecated: DittoPendingIDSpecificOperation.update<Codable>(using:) method.

Deprecated: DittoScopedWriteTransaction.upsert<Codable>(_,writeStrategy:) method.

Deprecated: DittoWriteTransactionPendingIDSpecificOperation.update<Codable>(using:) method.

Removed: observe() and observeWithNextSignal() methods of DittoPendingCollectionsOperation, DittoPendingCursorOperation, and DittoPendingIDSpecificOperation. Please use the corresponding observeLocal(deliverOn:eventHandler:) and observeLocalWithNextSignal(deliverOn:eventHandler:) variants along with a separate call to subscribe() instead. See https://docs.ditto.live/ios/common/concepts/syncing-data#subscribe

Added: class DittoPresence as entry point for all of presence functionality, accessible via the newly introduced presence property on the Ditto object.

Added: struct DittoPresenceGraph and related sub-types DittoAddress, DittoConnection, DittoConnectionType, and DittoPeer.

Added DittoPresence.GraphPublisher, replaces the now deprecated Ditto.RemotePeersPublisher. You can get a graph publisher via the graphPublisher() on the newly introduced DittoPresence (accessible via newly introduced presence property of Ditto).

Deprecated: methods observePeers() and observePeersV2() of Ditto, please use observe() of DittoPresence instead (accessible via newly introduced presence property of Ditto).

Deprecated: DITRemotePeer, replaced by DITPeer.

Deprecated: DITPeersObserver, replaced by DITObserver protocol.

Deprecated: DITPeersObserverV2, replaced by DITObserver protocol.

Deprecated: Ditto.RemotePeersPublisher and corresponding remotePeersPublisher() method on Ditto. Please use newly introduced DittoPresence.GraphPublisher and method graphPublisher() of DittoPresence instead.

Removed: all persistenceDirectory arguments from all of the identity type constructors.

Changed: performance improvements.

Added: disableSyncWithV2 method to Ditto. This allows you to explicitly opt-in to disabling the ability to sync with Ditto peers running any version of the SDK in the v2 series of releases. Assuming this succeeds then this peer will only be able to sync with other peers using SDKs in the v3 series of releases. Note that this disabling of sync spreads to peers that sync with a peer that has disabled, or has (transitively) had disabled, syncing with v2 SDK peers.

Improved: reliability if app crashes occur while persisting authentication data.

Added: statusPublisher() method to DittoAuthenticator.

Added: DittoAuthenticator.StatusPublisher, a Combine publisher for DittoAuthenticationStatus change events.

Improved: log increased detail to help debug blocked write transactions.

Synchronized version bump release

Fixed: Incorrect import of DITAddress.h header in DittoObjC, which was causing an issue in DittoSwift.

Improved: reliability if app crashes occur while persisting authentication data.

Removed: the DittoRGA constructor. You cannot create new RGAs.

Removed: the deprecated DittoMutableRGA type. You cannot mutate existing RGAs.

Deprecated: DittoDocument.typed<Codable>(as:) method.

Deprecated: DittoMutableDocument.typed<Codable>(as:) method.

Deprecated: DittoTypedDocument<Decodable> class.

Deprecated: DittoCollection.upsert<Encodable>(_,writeStrategy:) method.

Deprecated: DittoPendingIDSpecificOperation.update<Codable>(using:) method.

Deprecated: DittoScopedWriteTransaction.upsert<Codable>(_,writeStrategy:) method.

Deprecated: DittoWriteTransactionPendingIDSpecificOperation.update<Codable>(using:) method.

Removed: observe() and observeWithNextSignal() methods of DittoPendingCollectionsOperation, DittoPendingCursorOperation, and DittoPendingIDSpecificOperation. Please use the corresponding observeLocal(deliverOn:eventHandler:) and observeLocalWithNextSignal(deliverOn:eventHandler:) variants along with a separate call to subscribe() instead. See https://docs.ditto.live/ios/common/concepts/syncing-data#subscribe

Added: class DittoPresence as entry point for all of presence functionality, accessible via the newly introduced presence property on the Ditto object.

Added: struct DittoPresenceGraph and related sub-types DittoAddress, DittoConnection, DittoConnectionType, and DittoPeer.

Added DittoPresence.GraphPublisher, replaces the now deprecated Ditto.RemotePeersPublisher. You can get a graph publisher via the graphPublisher() on the newly introduced DittoPresence (accessible via newly introduced presence property of Ditto).

Deprecated: methods observePeers() and observePeersV2() of Ditto, please use observe() of DittoPresence instead (accessible via newly introduced presence property of Ditto).

Deprecated: DITRemotePeer, replaced by DITPeer.

Deprecated: DITPeersObserver, replaced by DITObserver protocol.

Deprecated: DITPeersObserverV2, replaced by DITObserver protocol.

Deprecated: Ditto.RemotePeersPublisher and corresponding remotePeersPublisher() method on Ditto. Please use newly introduced DittoPresence.GraphPublisher and method graphPublisher() of DittoPresence instead.

Removed: all persistenceDirectory arguments from all of the identity type constructors.

Changed: performance improvements.

Added disableSyncWithV2 method to Ditto. This allows you to explicitly opt-in to disabling the ability to sync with Ditto peers running any version of the SDK in the v2 series of releases. Assuming this succeeds then this peer will only be able to sync with other peers using SDKs in the v3 series of releases. Note that this disabling of sync spreads to peers that sync with a peer that has disabled, or has (transitively) had disabled, syncing with v2 SDK peers.