Fixed: a very rare deadlock when starting sync immediately after creating the Ditto instance.

Released: Fri Sep 9, 2022, 4:11 pm

Changed: reduced total memory overhead during sync.

Fixed: private class inside the Ditto SDK was named CBOR and conflicted with a private Apple class named exactly the same, which produced a warning at launch time.

Released: Thu Jul 7, 2022, 12:53 pm

Changed: HTTP/WebSocket service now allows any origin for CORS, so it may be used from a webapp on localhost.

Fixed: a peer using an online identity would fail to sync peer-to-peer after app restarts.

Fixed: DittoDelegate method dittoIdentityProviderAuthenticationRequest(ditto:request:) would receive a DittoAuthenticationRequest with some properties being incorrectly set to nil.

Released: Wed Jun 15, 2022, 6:27 pm

Released: Wed Jun 8, 2022, 8:12 pm

Fixed: Ditto with onlinePlaygroundV2 identity would fail to sync with the Big Peer if internet access isn't available at the time when Ditto is instantiated.

Fixed: DittoSwift contained an invalid development signature.

Released: Fri Jun 3, 2022, 12:13 am

Released: Fri May 13, 2022, 7:18 am

Fixed: a correctness issue in replication when peer permissions changed in the middle of a replication exchange.

Fixed: error when querying a collection and there was a type mismatch for a field being used in a comparison in the query.

Fixed: restarting an app too quickly could lead to multiple connection attempts to rejoin peers in the mesh.

Fixed: apps using OnlinePlaygroundV2 identities could experience a one minute delay before peer-to-peer sync occurs.

Fixed: cloud sync would stop working when setting a newly created transport config.

Changed: Improvements to Ditto mesh performance via fastest-available-transport prioritization.

Released: Mon May 9, 2022, 5:04 am

Released: Fri Apr 8, 2022, 1:00 am

Changed: improved replication performance in some scenarios.

Released: Thu Apr 7, 2022, 11:25 pm

Added: onlinePlaygroundV2 case to DittoIdentity allowing for basic authentication for playgrounds

Deprecated: onlinePlayground case of DittoIdentity, use newly added onlinePlaygroundV2 instead

Fixed: sync issues due to inconsistent handling of app IDs across SDKs

Fixed: document IDs are now validated when synced and removed if invalid (some of our early versions of the SDK stored malformed IDs under certain circumstances)

Released: Tue Mar 22, 2022, 3:13 am

Added: property isReady to experimental DittoBusStream to check if a message may be enqueued.

Added: method setOfflineOnlyLicenseToken() to class Ditto as replacement for now deprecated setLicenseToken().

Changed: made DittoBusStream, DittoRemotePeerV2, and DittoAddress adopt Equatable and Hashable protocols.

Changed: made DittoRemotePeerV2 adopt the Identifiable.protocol.

Deprecated: method setLicenseToken() of class Ditto, use newly added setOfflineOnlyLicenseToken() instead.

Released: Mon Feb 28, 2022, 6:36 am

Changed: Optimized the performance of accessing the value of a Document.

Added: Combine publisher APIs obviating the CombineDitto extension library

Added: remotePeersPublisher() method to Ditto class

Added: fetchAttachmentPublisher(attachmentToken:) method to DittoCollection class

Added: liveQueryPublisher() method to DittoPendingCursorOperation class

Added: singleDocumentLiveQueryPublisher() method to DittoPendingIDSpecificOperation class

Added: dittoBus(_, didReceiveSingleMessage:) method to DittoBusDelegate protocol

Added: dittoBus(_, didReceiveIncomingStream:, fromPeer:) method to DittoBusDelegate protocol

Removed: dittoBus(_, didReceive:) method from `DittoBusDelegate protocol

Added: setMeshRole(meshRole:, ditto:) method to DittoExperimental class

Added: setPriorityForMeshRole(_, forMeshRole:, ditto:) to DittoExperimental class

Fixed: Improved AWDL reliability on iOS 12

Released: Fri Feb 11, 2022, 9:38 pm

Changed: improved peer-to-peer algorithms to create meshes that are more efficient and diverse.

Changed: improved routing algorithms for more efficiency.

Changed: improved performance of query parsing.

Added: property isSyncActive to class Ditto.

Added: method logout() to class DittoAuthenticator.

Added: set of APIs to observe authentication status (see API reference for DittoAuthenticator and DittoAuthenticationDelegate).

Added: method upsert() to classes DittoCollection and DittoScopedWriteTransaction (as a replacement for insert() & friends) which by default merges the newly inserted document if one with the same ID already exists.

Deprecated: properties isAuthenticated and userID of class DittoAuthenticator in favor of newly introduced property status.

Deprecated: methods insert() & frinds of classes DittoCollection and DittoScopedWriteTransaction in favor of newly introduced upsert().

Released: Fri Jan 28, 2022, 3:21 am

Fixed: collections were not appearing in the data browser under certain permission configurations.

Fixed: race condition when subscriptions were configured from multiple threads in parallel (sometimes leading to a crash).

Released: Thu Dec 23, 2021, 12:42 pm

Fixed a number of Codable-related bugs. One of the more notable fixes involves Codable-conforming types from Foundation now working as you'd expect.

Reduced the opportunity for rapid memory growth in some scenarios.

Released: Mon Dec 20, 2021, 5:22 am

Fix an issue where memory usage could grow very quickly when using a live query and performing lots of operations that led to a live query update.

Released: Tue Dec 14, 2021, 8:32 am

Fixed an issue where document IDs that were specified inside the document's value as opposed to being specified explicitly (as a separate argument to insert) weren't being processed correctly, potentially leading to bugs with merge and overwrite behaviors.

macOS (including Apple Silicon) and iOS simulator (on an Apple Silicon device) support has been added.

Released: Wed Dec 8, 2021, 9:25 am

Fix an issue with write strategies not working correctly. Unexpected results could occur when performing sequences of operations on documents.

Fix a bug with Codable-conforming enums that was causing a runtime error.

Released: Thu Nov 25, 2021, 4:11 pm

Fix an issue with live queries that involved a limit, no offset, at least one document being deleted, and some other conditions being met. Live queries that met these conditions could report incorrect sets of matching documents.

Fix an issue that could potentially lead to an infinite loop in the replication system, meaning no sync progress would be made.

Released: Fri Nov 19, 2021, 2:39 pm

Ensure that when performing a sort that if a document that matches the filter specified via the accompanying find call doesn't have the key specified in the sort expression then it won't lead to an error. 

Now, if you're sorting in a descending order then the documents without the key specified in the sort will appear at the end of the set of results, after all of the documents that do have the key present. If you're sorting in an ascending order then the documents without the sort key will appear first in the set of documents, before all of the documents that do contain the sort key.

Fixed handling of large integers in documents. Integers larger than Int.max were still trying to be handled as Ints, leading to crashes. We now correctly handle them as UInts when appropriate.

Add the ability to directly set values inside the closure passed to an update call with assignments done via = sets, e.g. collection.findByID("123").update { $0!["color"] = "white" }

Fix a bug where some transports related calls were not being run on the correct thread and so could lead to a crash.

Released: Fri Nov 5, 2021, 3:03 pm

Fix a bug where large integers (greater than Int.max) would mistakenly try to get internally represented by an Int. They are now correctly represented using a UInt instead.

Released: Wed Oct 27, 2021, 3:33 am

Add support for array projections to DittoQL.

Deprecate the online identity in favor of the new onlineWithAuthentication identity.

Deprecate the development identity in favor of the new offlinePlayground identity.

Add an auth property to Ditto that provides access to a DittoAuthenticator when using an appropriate identity with your Ditto instance.

Add support for using a document ID that is an object that conforms to Codable.

Released: Mon Oct 25, 2021, 1:31 am

Released: Mon Oct 18, 2021, 10:02 am

Added global section to TransportConfig allowing P2P sync to be contained within certain groups of devices by putting them in the same "sync group".

Fixed Xcode warning regarding .swiftsourceinfo files being present.

Released: Mon Oct 18, 2021, 3:00 am

Added method insertWithStrategy() to DittoCollection, allowing to specify the behavior when inserting a document with an ID that matches the ID of a document already in the store.

Fixed AWDL peers never re-connecting after transport is toggled.

Fixed sporadic hangs and crashes when using Online identity.

Added isAuthenticated() method and userID property to DittoAuthenticator.

Fixed Codable support for non-string IDs and Float and Double types.

Released: Thu Oct 7, 2021, 10:09 pm

Fix to stop a change in site ID from leading to an unnecessary error.

Improve handling of persisted authentication data. Note that this might lead to a one-off change to a peer's site ID if you weren't and continue to not be specifying an explicit site ID when creating your identity.

Released: Fri Sep 10, 2021, 9:21 am

Added support for getting information about all of the collections that the device is aware of. This is achieved by accessing collections() through the store object and then using the same sort of API used when getting documents in collections, i.e. exec/observe/etc.

Added multicast as a transport option to the LAN config part of TransportConfig.

Added new identity types: Online and OnlinePlayground. An Online identity should be used when running Ditto in secure production mode, logging on to Ditto Cloud, or using an on-premises authentication server. User permissions are centrally managed. Sync will not work until a successful login has occurred. An OnlinePlayground identity should be used when you want to test a Ditto Cloud app without authentication ("Playground mode"). This mode offers no security and must only be used for development.

The Production identity has been renamed to Manual.

Added a DittoAuthenticator type, accessible via the Ditto object, which allows you to perform login operations when you're using an Online identity.

Similarly, added an DittoAuthenticationDelegate type that needs to be used when using an Online identity.

Report an error if more than one Ditto instance is started using the same working directory.

Released: Fri Sep 3, 2021, 3:38 pm

Released: Mon Aug 2, 2021, 9:19 am

Fix bug where sync may fail if an unusually long deviceName is configured

Fix intermittent crash when Bluetooth L2CAP connections fail

Fix intermittent crash when using the presence viewer component and the app is backgrounded

Released: Thu Jul 22, 2021, 4:38 pm

Add value accessor on DittoDocumentPath, DittoMutableDocumentPath, and DittoDocumentIDPath types to allow accessing a nested value in a document/ID as an Any?.

Released: Thu Jul 8, 2021, 11:22 am

Added a new find function that accepts a query containing placeholders in the form of $args.my_arg along with a map of query arguments in the form of { "my_arg": "some value" }. The placeholders in the query will be replaced by a query-appropriate representation of the relevant value from the map of query arguments.

For example, a query of color == $args.color with a query arguments map of { "color": "red" } would internally be treated as a query of: color == "red".

Added the ability to get a hash and/or a mnemonic (string) representation of the matching documents from a live query event. This means you can do something like this:

let liveQuery = collection.findAll().observe() { docs, event in
    event.hash(docs); // e.g. `1950015808188223905`
    event.hashMnemonic(docs); // e.g. `locate-quality-tina--helena-remote-cat`
    // ...
}

Accessing the store property of a Ditto instance will no longer throw an error if you have not yet activated your Ditto instance with a valid license token.

Deprecated setAccessLicense and added a new function, setLicenseToken, which will throw an appropriate error if your provided license token is expired or invalid somehow.

Deprecated startSync and added a new function, tryStartSync, which will throw an error if your Ditto instance hasn't yet been activated via a successful call to setLicenseToken.

Released: Fri Jun 25, 2021, 3:36 pm

Fix issue with AWDL transport where it could end up in a stuck state.

Deprecate the find(query:) function on DittoScopedWriteTransaction and add a new version of find(:) that doesn't require the query argument label. This makes this consistent with the find(:) function on DittoCollection.

Ditto v1 for Swift