Change App-code

It is already possible to change the app-code used in an app with the current SDK and the current version of me-client-service. This current solution is implemented in the SDK and inherently fragile since it needs to make several requests to the backend to make the change.

Proposed solution

The goal is to let the SDK change the app-code in a single request to the backend. By sending a POST request to the /v4/apps/:app_code/client/app endpoint a previously registered client will be moved to the new app.

To support all use-cases in the same way the contact will always be set to an anonymous contact when changing the app-code and the application will need to set the contact to the identified one if needed.

Actions

  1. Reset the client, push-token and contact with the old app-code (taken from client-state header) in dynamodb and big-query.

  2. Register client with the new app-code in dynamodb and big-query.

  3. Register, if available, push-token with the new app-code in dynamodb and big-query.

  4. Link the client with the new app-code to an anonymous contact or no contact in case the new app does not allow anonymous contacts.

Considerations

If the request fails the SDK needs to handle the error and rollback any local changes.