developerModeRequestUpdate

abstract suspend fun developerModeRequestUpdate(documentId: String, requestRemoteDeletion: Boolean, notifyApplicationOfUpdate: Boolean)

Request update of the document data

This is a developer-mode feature for the application to request a document update update. This is optional for an issuing authority to implement, it may be a no-op.

When this is called the issuer should generate a new DocumentConfiguration, put the document into the DocumentCondition.CONFIGURATION_AVAILABLE condition and post a notification to the application if the passed notifyApplicationOfUpdate is set to true.

Upon receiving this notification the application will show an UI notification to the user, delete existing credentials, download the new DocumentConfiguration, and request new credentials.

The sole reason for this feature is to make it easy to test the data update flow both from an application and an issuer point of view. The notifyApplicationOfUpdate parameter can be set to false used to simulate a lossy notification distribution network.

Parameters

documentId

the document to request an update for.

requestRemoteDeletion

request that the document is deleted.

notifyApplicationOfUpdate

true if the issuer should send a notification to the application about this, false to not send a notification

Throws

UnknownDocumentException

if the given documentId isn't valid.