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
}

// Wire the SAME idempotent handler to BOTH surfaces.
// Different deeplink delivery cases surface via different paths,
// and a few cases fire both — making the handler idempotent is
// the cleanest way to never special-case which path won.
function applyPayload(data?: UnlockData) {
  if (data?.unlock) applyUnlock(data.unlock);
}

const result = await Mobana.getAttribution<UnlockData>();
if (result.status === 'matched') applyPayload(result.attribution.data);

Mobana.onDeepLink<UnlockData>((event) => applyPayload(event.data));