• Adds support for additional options for watch in RemoteMongoCollection.
  • Watch for events on all documents.
  • Watch for all events matching a provided $match filter.

• Fixes a bug where attempting to access a local app in a different region would result in an error.
• Fix bug where stream would sometimes fail to open because an expired session was not being refreshed.
• Various internal fixes and improvements.

• Support for Swift 5 and Xcode 10.2
• Added support for "compact" watch streams.
• Various API documentation improvements.
• Internal improvements
  • Streamlined release process
  • Added performance testing suite

• Introduces multi-user support for iOS SDK
• Adds the ability to watch a set of documents for changes
• Adds support for MongoDB findOne, findOneAndUpdate, findOneAndReplace, findOneAndDelete operations
• Various sync performance improvements

NOTE: This release has breaking changes for the Mobile Sync Beta.

• The methods configure, syncOne, syncMany, desyncOne, desyncMany, getSyncedIds, getPausedDocumentIds, and resumeSyncForDocument are now asynchronous and accept a completion listener. This is to prevent accidentally freezing the UI on sync tasks.
• Existing code that calls configure, syncOne, syncMany, desyncOne, and desyncMany, getSyncedIds, getPausedDocumentIDs and resumeSyncForDocument will need to be modified to pass in a completion listener. A no-op closure can be used if you do not need to react to the event.

In this release we have released the beta of Stitch Mobile Sync! Documentation to follow shortly.

We've also upgraded the underlying Swift Driver and MongoMobile libraries.

• Support for contacting applications deployed with a "local" deployment model
  • Before the first call to the client v2 API, the SDK now contacts the global MongoDB Stitch server to find out the deployment model and localized hostname for the application. The call is then redirected to the localized hostname (e.g. calls to Stitch for an app deployed locally to US-VA will hit a stitch server residing specifically in that location, while an app deployed globally will always use the global Stitch URL)
  • Subsequent calls to the API use the cached result
• Added toArray to all find operations, with soft deprecation of asArray
• Linted internal code and fixed documentation generation issues.

• Fix build issues that people were encountering related to pod installations
• Document initialization changes. BsonValue is now also BSONValue.

• Fixed a bug where the MongoSwift dependency was not properly being built with bitcode for all architectures.
• Minimum version for watchOS builds is now 4.2 (was 4.3)

• Added generic AWS service
  • New CocoaPod:
    • StitchSDK/StitchAWSService
• Exposed StitchServiceClient to support services which are not well-defined by the SDK

• Update README to reflect new pod version.

• Bitcode-enabled builds are now possible when not using the MongoDB Mobile beta.

Changelog

Updated PromiseKit from 5.0 to 6.0.

Usage of StitchClient

StitchClient can longer be constructed directly. Instead, StitchClientFactory has been introduced to asynchronously perform any initialization steps needed to create a StitchClient. StitchClientFactory has a function called create that will return a Promise that will resolve with a StitchClient after initialization. The resolved client should be used for the lifetime of the application.

PromiseKit is now the Promise library of choice. StitchTask has been completely removed. Please see https://github.com/mxcl/PromiseKit/ for more information.

Migration Path

// old, 2.x.x usage
import StitchCore
let stitchClient = StitchClient(appId: "<app-id>");
stitchClient.anonymousAuth().then { authedId in print(authedId) }
// app initialization code

// new, 3.x.x usage
import StitchCore
let stitchClientPromise = StitchClientFactory.create(appId: "<app-id>")
var stitchClient: StitchClient!
stitchClientPromise.then { client in 
    stitchClient = client
    return stitchClient.login()
}.done { _ in
    initializeApp(stitchClient)
}

Since the StitchClient is only available after the Promise resolves, initialization of an app should be deferred until this time and the client reference should be passed to some initialization component/function.

NOTE: Attempting to construct a StitchClient without using StitchClientFactory will result in an error being thrown.

Multiple Apps

• Add support for multiple StitchClients (with different associated applications).

Authentication

Previously, logging in with a provider while already logging caused no log in to happen which proved to be confusing. These new semantics are in effect:

• Authenticating multiple times with anonymous authentication while already authenticated anonymously does nothing and returns the current user ID.
• Authenticating with any provider but anonymous will log out the current user and then log in with the new provider.
• Add isAuthenticated() method to the StitchClient class. This method should be used to check if any authentication work needs to happen. It returns a boolean declaring whether or not the current client is authenticated.
• Add Client API key management. This feature allows one to create API keys linked to the currently logged in user. This does not work on anonymous users or Server API key users.