onOutcome()

​

Signature

onOutcome(handler: (outcome: PlacementOutcome) => void): () => void

type PlacementOutcome = PresentationOutcome | StrictUnlockVerifiedOutcome;

interface PresentationOutcome {
  type: 'presentation';
  placementId: string;
  result: PresentationResult;
}

interface StrictUnlockVerifiedOutcome {
  type: 'strict_unlock_verified';
  transactionId: string;
}

​

Usage

import { useEffect } from 'react';
import Encore from '@encorekit/react-native';

useEffect(
  () =>
    Encore.onOutcome((outcome) => {
      if (outcome.type === 'presentation') {
        analytics.track('encore_presentation', {
          placementId: outcome.placementId,
          result: outcome.result,
        });
      } else {
        // Entitlements are already refreshed natively by the time this lands.
        refreshEntitlements();
      }
    }),
  [],
);

​

Behavior

• It appends. Unlike the 1.x on* setters, which replaced the previous handler, this is a real subscription: several observers can listen at once, matching the multicast streams both native SDKs expose.
• There is no replay. The native streams buffer nothing for late subscribers, by design, since outcomes can carry user-scoped claim data. Subscribe at startup if you want all of them.
• Every show() the SDK resolves emits, including the ones that presented nothing. A not_presented resolution is still a presentation event, carrying the same PresentationResult the call site received. A call the bridge rejects before it reaches the SDK resolves at the call site without reaching the stream.

​

Late strict-unlock verification

​

Related

• PresentationResult, the payload of presentation events.
• configure() for the unlock option that makes strict_unlock_verified reachable.