React Native SDK

@revenuehog/react-native is pure TypeScript with no native code, so it works in Expo Go. It has zero runtime dependencies and detects optional modules at runtime.

InstallCopy Anchor Link

The package is not published to npm yet. Build it from a checkout of the SDK repository (dist/ is not committed) and install it as a local file dependency:

git clone https://github.com/Parra-Inc/revenue-hog-sdks
cd revenue-hog-sdks/react-native && npm install && npm run build
cd <your app> && npm install file:../revenue-hog-sdks/react-native

Optional modules, detected automatically and never required:

Without AsyncStorage the SDK falls back to in-memory storage: the anonymous ID does not survive a relaunch. That is fine in development.

QuickstartCopy Anchor Link

import RevenueHog from '@revenuehog/react-native';

RevenueHog.configure();

await RevenueHog.identify('user_42'); // after login
await RevenueHog.reset();             // on logout

How auth worksCopy Anchor Link

There is no API key and no attestation yet. Requests carry no Authorization header; RevenueHog resolves them by bundle ID and labels the data unverified. One exception: on iOS, a purchase attributed with a StoreKit 2 signed transaction (jws) is verified against Apple's signature, so that purchase link is trusted. See Authentication.

Attributing purchasesCopy Anchor Link

Automatic. When react-native-iap is installed and autoAttribution is not false, the SDK hooks purchaseUpdatedListener and attributes every purchase. It uses originalTransactionIdentifierIOS, falling back to transactionId, and passes the signed transaction from jwsRepresentationIos, jwsRepresentationIOS or verificationResultIOS when the value looks like a JWS (three dot-separated segments).

Manual. Call attributePurchase from your own listener:

import { purchaseUpdatedListener } from 'react-native-iap';

purchaseUpdatedListener((purchase) => {
  RevenueHog.attributePurchase({
    originalTransactionId:
      purchase.originalTransactionIdentifierIOS ?? purchase.transactionId!,
    productId: purchase.productId,
    jws: purchase.jwsRepresentationIos,
  });
});

// expo-in-app-purchases
setPurchaseListener(({ results }) => {
  for (const p of results ?? []) {
    RevenueHog.attributePurchase({
      originalTransactionId: p.originalOrderId ?? p.orderId,
      productId: p.productId,
    });
  }
});

On Android, pass the Play purchase token as originalTransactionId.

API referenceCopy Anchor Link

Every method returns a promise that resolves normally, even on failure.

The module also exports HogClient, memoryStorage and the types AttributePurchaseInput, LogLevel, Paywall, PaywallOptions, PaywallSku, PaywallSkuKind, RevenueHogConfig and StorageAdapter.

RevenueHogConfigCopy Anchor Link

RevenueHog.configure({
  baseUrl: 'https://hog.internal.example',
  bundleId: 'com.your.app',
  autoAttribution: true,
  storage: myStorageAdapter,
  logLevel: 'warn',
  storeEnvironment: 'Sandbox',
});

PaywallCopy Anchor Link

interface Paywall {
  entitlement: string;
  skus: { productId: string; kind: 'subscription' | 'iap' | 'unknown' }[];
  productIds: string[];
  experimentId?: string;
  variantKey?: string;
  isFallback: boolean;
}

const paywall = await RevenueHog.paywall('pro', ['app_pro_annual', 'app_pro_monthly']);
const products = await getSubscriptions({ skus: paywall.productIds });
const ordered = paywall.productIds
  .map((id) => products.find((p) => p.productId === id))
  .filter(Boolean);
// after render:
RevenueHog.paywallShown(paywall, ordered.map((p) => p.productId));

options.forceVariant previews a variant for QA (see Experiments). The fetch deadline is 2.5 seconds.

Install ID stickinessCopy Anchor Link

The install ID is a UUID persisted in your storage adapter. AsyncStorage survives logout but not reinstall, so experiment assignment is less sticky than on iOS, where the Keychain keeps the ID across reinstalls.

Behavior notesCopy Anchor Link

• Failed requests (network, 429, 5xx) retry up to 3 times with 500 ms then 1 s backoff, then queue (cap 100).
• Other non-2xx responses are logged and dropped.
• The SDK skips transactions already reported for the current user.

TroubleshootingCopy Anchor Link

RelatedCopy Anchor Link