onDeepLink()

Mobana.onDeepLink<T = Record<string, unknown>>(
  handler: (event: DeepLinkEvent<T>) => void
): () => void;

import { Mobana } from '@mobana/react-native-sdk';

interface UnlockData { unlock?: string; ref?: string }

const unsubscribe = Mobana.onDeepLink<UnlockData>((event) => {
  if (event.data?.unlock) applyUnlock(event.data.unlock);
  if (event.data?.ref) trackReferral(event.data.ref);

  // Optionally branch on delivery source
  if (event.source === 'universal_link') {
    // Tap-to-open from a real link tap.
  } else if (event.source === 'probabilistic') {
    // Re-engagement after the OS failed to intercept the URL.
  } else if (event.source === 'deferred') {
    // First-launch delivery from the install-attribution path.
  }
});

// Later, when you no longer need it (e.g. user logs out)
unsubscribe();

<MobanaProvider
  onDeepLink={(event) => {
    if (event.data?.unlock) applyUnlock(event.data.unlock);
  }}
>
  <App />
</MobanaProvider>

interface DeepLinkEvent<T = Record<string, unknown>> {
  url: string;                    // Raw URL the OS / probe surfaced (empty string for 'deferred')
  data?: T;                       // Typed payload from ?data= JSON
  utm: {
    source?: string;
    medium?: string;
    campaign?: string;
    content?: string;
    term?: string;
  };
  clickParams: Record<string, string>;  // ttclid / fbclid / gclid / etc.
  source: 'universal_link' | 'probabilistic' | 'deferred';
  timestamp: number;              // ms since epoch when the SDK captured the event
}