React Native lifecycle - ClarioDesk

Four host events interact with the SDK. The concepts are shared across both SDKs (read the overview); this page gives the exact React Native code.

1. App launch (every time)

Identify unconditionally on launch so users who installed before you added ClarioDesk aren’t left as unlabeled devices. identify() is idempotent and cheap.

import 'react-native-get-random-values';
import { ClarioDesk } from '@clariodesk/react-native';

await ClarioDesk.init({ apiKey: 'pk_live_…' });

const user = await yourAuth.currentUser();
if (user) {
  await ClarioDesk.identify({
    externalId: user.id,
    email: user.email,
    traits: { plan: user.plan },
  });
}

await yourAuth.signIn(email, password);
await ClarioDesk.identify({ externalId: user.id, email: user.email });

This overwrites the label on the existing device row. The same device and key are reused.

3. Logout

await ClarioDesk.clearIdentity(); // Verified identity
await yourAuth.signOut();

This preserves the device key while changing the signed identity epoch. In label-only mode, reset() is still available for full installation isolation.

4. User switch (A → B without restart)

await ClarioDesk.clearIdentity();
await yourAuth.switchTo(userB);
await ClarioDesk.identify({ identityMode: 'host' });

Await clear before activating user B. reset() deprovisions this installation; it is not logout or customer erase.

Checking state

ClarioDesk.isInitialized(); // boolean
ClarioDesk.isIdentified();  // boolean