React Native

import { Rovenue } from '@rovenue/react-native-sdk';

// After your auth flow completes:
await Rovenue.identify('user_123');

// When your user signs out:
await Rovenue.logOut();

type User = {
  rovenueId: string;        // permanent per-install id (prefix rov_), always present
  appUserId: string | null; // your backend user id, null until identify()
};

type Entitlement = {
  id: string;                // e.g. "pro", "credits_500"
  isActive: boolean;
  productIdentifier: string;
  store: string;             // "app_store" | "play_store" | "stripe"
  expiresIso?: string;       // ISO 8601 — present for time-limited entitlements
};

import { useEntitlement } from '@rovenue/react-native-sdk';

export function ProBadge() {
  const pro = useEntitlement('pro');

  if (!pro?.isActive) {
    return null;
  }

  return <Text>Pro member</Text>;
}

import { useVirtualCurrency, useVirtualCurrencies } from '@rovenue/react-native-sdk';

// Show one currency by code
export function CoinsLabel() {
  const coins = useVirtualCurrency('COINS');
  return <Text>{coins} coins</Text>;
}

// Show all currencies
export function WalletSummary() {
  const balances = useVirtualCurrencies(); // Record<string, number>
  return (
    <>
      {Object.entries(balances).map(([code, amount]) => (
        <Text key={code}>{code}: {amount}</Text>
      ))}
    </>
  );
}

import { Rovenue, RovenueError } from '@rovenue/react-native-sdk';

const offerings = await Rovenue.getOfferings();
const pkg = offerings.current?.packages[0];

if (pkg) {
  try {
    const result = await Rovenue.purchase(pkg);
    if (result.isDeferred) {
      // Ask-to-Buy / parental-control hold — no entitlements yet. The SDK
      // reconciles it in the background; watch addChangeListener for
      // 'ENTITLEMENTS_CHANGED' to know when it resolves.
    } else {
      // result.entitlements and result.virtualCurrencies are already up to date
    }
  } catch (e) {
    if (e instanceof RovenueError && e.kind === 'PurchaseCanceled') {
      // User dismissed the store sheet — no action needed
    } else {
      throw e;
    }
  }
}

await Rovenue.restorePurchases();

type PurchaseResult = {
  entitlements: Entitlement[];
  virtualCurrencies: Record<string, number>;
  productId: string;
  storeTransactionId: string;
  isDeferred: boolean; // true for an Ask-to-Buy / parental-control hold
};

import { RovenueFunnelView } from '@rovenue/react-native-sdk';

const onboarding = <RovenueFunnelView placementIdentifier="onboarding_end" onFinished={() => {}} />;

import { useEffect } from 'react';
import { Rovenue } from '@rovenue/react-native-sdk';

useEffect(() => {
  const unsub = Rovenue.addChangeListener((event) => {
    // event: 'ENTITLEMENTS_CHANGED' | 'IDENTITY_CHANGED' | 'VIRTUAL_CURRENCIES_CHANGED' | 'REMOTE_CONFIG_CHANGED'
    console.log('Rovenue change:', event);
  });

  return () => {
    unsub();
  };
}, []);

import { RovenueFunnelView } from "@rovenue/react-native-sdk";

function OnboardingFunnel() {
  return <RovenueFunnelView placementIdentifier="onboarding" />;
}