@tryheliumai/paywall-sdk-react-native 3.0.7 → 3.0.15

package/lib/typescript/module/src/native-interface.d.ts

@@ -1,13 +1,24 @@
-import type { HeliumConfig, HeliumUpsellViewProps, HeliumDownloadStatus, PaywallInfo, PresentUpsellParams } from './types';
+import type { HeliumConfig, HeliumUpsellViewProps, HeliumDownloadStatus, HeliumLightDarkMode, PaywallInfo, PresentUpsellParams } from './types';
+import type { ExperimentInfo } from './HeliumExperimentInfo.types';
 export declare const NativeHeliumUpsellView: import("react-native").HostComponent<HeliumUpsellViewProps>;
 export declare const getDownloadStatus: () => HeliumDownloadStatus;
 export declare const initialize: (config: HeliumConfig) => Promise<void>;
-export declare const presentUpsell: ({ triggerName, onFallback, eventHandlers, customPaywallTraits, }: PresentUpsellParams) => void;
+export declare const presentUpsell: ({ triggerName, onFallback, eventHandlers, customPaywallTraits, dontShowIfAlreadyEntitled, }: PresentUpsellParams) => void;
 export declare const hideUpsell: () => void;
 export declare const hideAllUpsells: () => void;
 export declare const getPaywallInfo: (trigger: string) => Promise<PaywallInfo | undefined>;
 export declare const handleDeepLink: (url: string | null) => Promise<boolean>;
 export declare const setRevenueCatAppUserId: (rcAppUserId: string) => void;
+/**
+ * Set a custom user ID for the current user
+ */
+export declare const setCustomUserId: (newUserId: string) => void;
+/**
+ * Checks if the user has an active entitlement for any product attached to the paywall that will show for provided trigger.
+ * @param trigger The trigger name to check entitlement for
+ * @returns Promise resolving to true if entitled, false if not, or undefined if not known (i.e. the paywall is not downloaded yet)
+ */
+export declare const hasEntitlementForPaywall: (trigger: string) => Promise<boolean | undefined>;
 /**
  * Checks if the user has any active subscription (including non-renewable)
  */
@@ -16,6 +27,32 @@ export declare const hasAnyActiveSubscription: () => Promise<boolean>;
  * Checks if the user has any entitlement
  */
 export declare const hasAnyEntitlement: () => Promise<boolean>;
+/**
+ * Get experiment allocation info for a specific trigger
+ *
+ * @param trigger The trigger name to get experiment info for
+ * @returns ExperimentInfo if the trigger has experiment data, undefined otherwise
+ */
+export declare const getExperimentInfoForTrigger: (trigger: string) => Promise<ExperimentInfo | undefined>;
+/**
+ * Reset Helium entirely so you can call initialize again. Only for advanced use cases.
+ */
+export declare const resetHelium: () => void;
+/**
+ * Set custom strings to show in the dialog that Helium will display if a "Restore Purchases" action is not successful.
+ * Note that these strings will not be localized by Helium for you.
+ */
+export declare const setCustomRestoreFailedStrings: (customTitle?: string, customMessage?: string, customCloseButtonText?: string) => void;
+/**
+ * Disable the default dialog that Helium will display if a "Restore Purchases" action is not successful.
+ * You can handle this yourself if desired by listening for the PurchaseRestoreFailedEvent.
+ */
+export declare const disableRestoreFailedDialog: () => void;
+/**
+ * Override the light/dark mode for Helium paywalls
+ * @param mode The mode to set: 'light', 'dark', or 'system' (follows device setting)
+ */
+export declare const setLightDarkModeOverride: (mode: HeliumLightDarkMode) => void;
 export declare const HELIUM_CTA_NAMES: {
     SCHEDULE_CALL: string;
     SUBSCRIBE_BUTTON: string;

package/lib/typescript/module/src/native-interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native-interface.d.ts","sourceRoot":"","sources":["../../../../src/native-interface.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,mBAAmB,EAGpB,MAAM,SAAS,CAAC;AAMjB,eAAO,MAAM,sBAAsB,6DACgC,CAAC;AAMpE,eAAO,MAAM,iBAAiB,4BAA6B,CAAC;AAM5D,eAAO,MAAM,UAAU,WAAkB,YAAY,kBA0HpD,CAAC;AAIF,eAAO,MAAM,aAAa,qEAKvB,mBAAmB,SA6BrB,CAAC;AA+DF,eAAO,MAAM,UAAU,YAEtB,CAAC;AAEF,eAAO,MAAM,cAAc,YAE1B,CAAC;AAEF,eAAO,MAAM,cAAc,YAChB,MAAM,KACd,OAAO,CAAC,WAAW,GAAG,SAAS,CAiBjC,CAAC;AAEF,eAAO,MAAM,cAAc,QAAe,MAAM,GAAG,IAAI,KAAG,OAAO,CAAC,OAAO,CAWxE,CAAC;AAEF,eAAO,MAAM,sBAAsB,gBAAiB,MAAM,SAEzD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,QAAa,OAAO,CAAC,OAAO,CAEhE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC,OAAO,CAEzD,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;CAG5B,CAAC"}
+{"version":3,"file":"native-interface.d.ts","sourceRoot":"","sources":["../../../../src/native-interface.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EAGpB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAMnE,eAAO,MAAM,sBAAsB,6DACgC,CAAC;AAMpE,eAAO,MAAM,iBAAiB,4BAA6B,CAAC;AAM5D,eAAO,MAAM,UAAU,WAAkB,YAAY,kBA0HpD,CAAC;AAIF,eAAO,MAAM,aAAa,gGAMvB,mBAAmB,SAgBrB,CAAC;AA2FF,eAAO,MAAM,UAAU,YAEtB,CAAC;AAEF,eAAO,MAAM,cAAc,YAE1B,CAAC;AAEF,eAAO,MAAM,cAAc,YAChB,MAAM,KACd,OAAO,CAAC,WAAW,GAAG,SAAS,CAiBjC,CAAC;AAEF,eAAO,MAAM,cAAc,QAAe,MAAM,GAAG,IAAI,KAAG,OAAO,CAAC,OAAO,CAWxE,CAAC;AAEF,eAAO,MAAM,sBAAsB,gBAAiB,MAAM,SAEzD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,cAAe,MAAM,SAEhD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,YAC1B,MAAM,KACd,OAAO,CAAC,OAAO,GAAG,SAAS,CAE7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,QAAa,OAAO,CAAC,OAAO,CAEhE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC,OAAO,CAEzD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,YAC7B,MAAM,KACd,OAAO,CAAC,cAAc,GAAG,SAAS,CAapC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,YAEvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,6BAA6B,iBAC1B,MAAM,kBACJ,MAAM,0BACE,MAAM,SAO/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,YAEtC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,SAAU,mBAAmB,SAEjE,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;CAG5B,CAAC"}

package/lib/typescript/module/src/types.d.ts

@@ -4,6 +4,7 @@ export type HeliumPurchaseResult = {
     error?: string;
 };
 export type HeliumDownloadStatus = 'success' | 'failed' | 'inProgress' | 'notStarted';
+export type HeliumLightDarkMode = 'light' | 'dark' | 'system';
 /** Interface for providing custom purchase handling logic. */
 export interface HeliumPurchaseConfig {
     makePurchase: (productId: string) => Promise<HeliumPurchaseResult>;
@@ -45,6 +46,8 @@ export interface PaywallEventHandlers {
     onClose?: (event: PaywallCloseEvent) => void;
     onDismissed?: (event: PaywallDismissedEvent) => void;
     onPurchaseSucceeded?: (event: PurchaseSucceededEvent) => void;
+    onOpenFailed?: (event: PaywallOpenFailedEvent) => void;
+    onCustomPaywallAction?: (event: CustomPaywallActionEvent) => void;
 }
 export interface PaywallOpenEvent {
     type: 'paywallOpen';
@@ -72,8 +75,24 @@ export interface PurchaseSucceededEvent {
     paywallName: string;
     isSecondTry: boolean;
 }
+export interface PaywallOpenFailedEvent {
+    type: 'paywallOpenFailed';
+    triggerName: string;
+    paywallName: string;
+    error: string;
+    paywallUnavailableReason?: string;
+    isSecondTry: boolean;
+}
+export interface CustomPaywallActionEvent {
+    type: 'customPaywallAction';
+    triggerName: string;
+    paywallName: string;
+    actionName: string;
+    params: Record<string, any>;
+    isSecondTry: boolean;
+}
 export type HeliumPaywallEvent = {
-    type: 'paywallOpen' | 'paywallClose' | 'paywallDismissed' | 'paywallOpenFailed' | 'paywallSkipped' | 'paywallButtonPressed' | 'productSelected' | 'purchasePressed' | 'purchaseSucceeded' | 'purchaseCancelled' | 'purchaseFailed' | 'purchaseRestored' | 'purchaseRestoreFailed' | 'purchasePending' | 'initializeStart' | 'paywallsDownloadSuccess' | 'paywallsDownloadError' | 'paywallWebViewRendered';
+    type: 'paywallOpen' | 'paywallClose' | 'paywallDismissed' | 'paywallOpenFailed' | 'paywallSkipped' | 'paywallButtonPressed' | 'productSelected' | 'purchasePressed' | 'purchaseSucceeded' | 'purchaseCancelled' | 'purchaseFailed' | 'purchaseRestored' | 'purchaseRestoreFailed' | 'purchasePending' | 'initializeStart' | 'paywallsDownloadSuccess' | 'paywallsDownloadError' | 'paywallWebViewRendered' | 'customPaywallAction' | 'userAllocated';
     triggerName?: string;
     paywallName?: string;
     /**
@@ -107,6 +126,9 @@ export type HeliumPaywallEvent = {
      * Unix timestamp in seconds
      */
     timestamp?: number;
+    paywallUnavailableReason?: string;
+    customPaywallActionName?: string;
+    customPaywallActionParams?: Record<string, any>;
 };
 export type PresentUpsellParams = {
     triggerName: string;
@@ -114,11 +136,16 @@ export type PresentUpsellParams = {
     onFallback?: () => void;
     eventHandlers?: PaywallEventHandlers;
     customPaywallTraits?: Record<string, any>;
+    /** Optional. If true, the paywall will not be shown if the user already has an entitlement for a product in the paywall. */
+    dontShowIfAlreadyEntitled?: boolean;
 };
 export interface HeliumConfig {
     /** Your Helium API Key */
     apiKey: string;
-    /** Configuration for handling purchases. Can be custom functions or a pre-built handler config. */
+    /**
+     * Configuration for handling purchases. Can be custom functions or a pre-built handler config.
+     * If not provided, Helium will handle purchases for you.
+     */
     purchaseConfig?: HeliumPurchaseConfig;
     /** Callback for receiving all Helium paywall events. */
     onHeliumPaywallEvent: (event: HeliumPaywallEvent) => void;

package/lib/typescript/module/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryheliumai/paywall-sdk-react-native",
-  "version": "3.0.7",
+  "version": "3.0.15",
   "description": "Paywall SDK Helium",
   "source": "./src/index.ts",
   "main": "./lib/commonjs/index.js",

package/src/HeliumExperimentInfo.types.ts

@@ -0,0 +1,109 @@
+/**
+ * Experiment allocation information types
+ */
+
+/**
+ * Details about user hash bucketing for allocation
+ */
+export interface HashDetails {
+  /**
+   * User hash bucket (1-100) - used for consistent allocation
+   */
+  hashedUserIdBucket1To100?: number;
+
+  /**
+   * User ID that was hashed for allocation
+   */
+  hashedUserId?: string;
+
+  /**
+   * Hash method used (e.g., "HASH_USER_ID", "HASH_HELIUM_PERSISTENT_ID")
+   */
+  hashMethod?: string;
+}
+
+/**
+ * Details about the chosen variant in an experiment
+ */
+export interface VariantDetails {
+  /**
+   * Name or identifier of the allocation/variant (e.g., paywall template name)
+   */
+  allocationName?: string;
+
+  /**
+   * Unique identifier for this allocation (paywall UUID)
+   */
+  allocationId?: string;
+
+  /**
+   * Index of chosen variant (1 to len(variants))
+   */
+  allocationIndex?: number;
+
+  /**
+   * Additional allocation metadata as a dictionary
+   */
+  allocationMetadata?: Record<string, any>;
+}
+
+/**
+ * Complete experiment allocation information for a user
+ */
+export interface ExperimentInfo {
+  /**
+   * Trigger name at which user was enrolled
+   */
+  trigger: string;
+
+  /**
+   * Experiment name
+   */
+  experimentName?: string;
+
+  /**
+   * Experiment ID
+   */
+  experimentId?: string;
+
+  /**
+   * Experiment type (e.g., "A/B/n test")
+   */
+  experimentType?: string;
+
+  /**
+   * Additional experiment metadata as a dictionary
+   */
+  experimentMetadata?: Record<string, any>;
+
+  /**
+   * When the experiment started (ISO8601 string)
+   */
+  startDate?: string;
+
+  /**
+   * When the experiment ends (ISO8601 string)
+   */
+  endDate?: string;
+
+  /**
+   * Audience ID that user matched
+   */
+  audienceId?: string;
+
+  /**
+   * Audience data as structured object
+   * Note: This may be returned as a string from native bridge, but will be parsed
+   */
+  audienceData?: Record<string, any> | string;
+
+  /**
+   * Details about the chosen variant
+   */
+  chosenVariantDetails?: VariantDetails;
+
+  /**
+   * Hash bucketing details
+   */
+  hashDetails?: HashDetails;
+}

package/src/index.ts

@@ -8,8 +8,15 @@ export {
   getPaywallInfo,
   handleDeepLink,
   setRevenueCatAppUserId,
+  setCustomUserId,
+  hasEntitlementForPaywall,
   hasAnyActiveSubscription,
   hasAnyEntitlement,
+  getExperimentInfoForTrigger,
+  resetHelium,
+  setCustomRestoreFailedStrings,
+  disableRestoreFailedDialog,
+  setLightDarkModeOverride,
   HELIUM_CTA_NAMES,
   NativeHeliumUpsellView,
 } from './native-interface';
@@ -19,12 +26,21 @@ export type {
   HeliumConfig,
   HeliumUpsellViewProps,
   HeliumPaywallLoadingConfig,
+  HeliumLightDarkMode,
   TriggerLoadingConfig,
   PaywallEventHandlers,
   PaywallOpenEvent,
   PaywallCloseEvent,
   PaywallDismissedEvent,
   PurchaseSucceededEvent,
+  PaywallOpenFailedEvent,
+  CustomPaywallActionEvent,
   HeliumPaywallEvent,
   PresentUpsellParams,
 } from './types';
+
+export type {
+  ExperimentInfo,
+  HashDetails,
+  VariantDetails,
+} from './HeliumExperimentInfo.types';

package/src/native-interface.tsx

@@ -7,11 +7,13 @@ import type {
   HeliumConfig,
   HeliumUpsellViewProps,
   HeliumDownloadStatus,
+  HeliumLightDarkMode,
   PaywallInfo,
   PresentUpsellParams,
   PaywallEventHandlers,
   HeliumPaywallEvent,
 } from './types';
+import type { ExperimentInfo } from './HeliumExperimentInfo.types';
 
 const { HeliumBridge } = NativeModules;
 const heliumEventEmitter = new NativeEventEmitter(HeliumBridge);
@@ -161,35 +163,23 @@ export const presentUpsell = ({
   onFallback,
   eventHandlers,
   customPaywallTraits,
+  dontShowIfAlreadyEntitled,
 }: PresentUpsellParams) => {
-  HeliumBridge.canPresentUpsell(
-    triggerName,
-    (canPresent: boolean, reason: string) => {
-      if (!canPresent) {
-        console.log(
-          `[Helium] Cannot present trigger "${triggerName}". Reason: ${reason}`
-        );
-        onFallback?.();
-        HeliumBridge.fallbackOpenOrCloseEvent(triggerName, true, 'presented');
-        return;
-      }
-
-      try {
-        paywallEventHandlers = eventHandlers;
-        presentOnFallback = onFallback;
-        HeliumBridge.presentUpsell(
-          triggerName,
-          convertBooleansToMarkers(customPaywallTraits) || null
-        );
-      } catch (error) {
-        console.log('[Helium] Present error', error);
-        paywallEventHandlers = undefined;
-        presentOnFallback = undefined;
-        onFallback?.();
-        HeliumBridge.fallbackOpenOrCloseEvent(triggerName, true, 'presented');
-      }
-    }
-  );
+  try {
+    paywallEventHandlers = eventHandlers;
+    presentOnFallback = onFallback;
+    HeliumBridge.presentUpsell(
+      triggerName,
+      convertBooleansToMarkers(customPaywallTraits) || null,
+      dontShowIfAlreadyEntitled ?? false
+    );
+  } catch (error) {
+    console.log('[Helium] presentUpsell error', error);
+    paywallEventHandlers = undefined;
+    presentOnFallback = undefined;
+    onFallback?.();
+    HeliumBridge.fallbackOpenOrCloseEvent(triggerName, true, 'presented');
+  }
 };
 
 function callPaywallEventHandlers(event: HeliumPaywallEvent) {
@@ -229,6 +219,26 @@ function callPaywallEventHandlers(event: HeliumPaywallEvent) {
           isSecondTry: event.isSecondTry ?? false,
         });
         break;
+      case 'paywallOpenFailed':
+        paywallEventHandlers?.onOpenFailed?.({
+          type: 'paywallOpenFailed',
+          triggerName: event.triggerName ?? 'unknown',
+          paywallName: event.paywallName ?? 'unknown',
+          error: event.error ?? 'Unknown error',
+          paywallUnavailableReason: event.paywallUnavailableReason,
+          isSecondTry: event.isSecondTry ?? false,
+        });
+        break;
+      case 'customPaywallAction':
+        paywallEventHandlers?.onCustomPaywallAction?.({
+          type: 'customPaywallAction',
+          triggerName: event.triggerName ?? 'unknown',
+          paywallName: event.paywallName ?? 'unknown',
+          actionName: event.customPaywallActionName ?? 'unknown',
+          params: event.customPaywallActionParams ?? {},
+          isSecondTry: event.isSecondTry ?? false,
+        });
+        break;
     }
   }
 }
@@ -247,7 +257,15 @@ function handlePaywallEvent(event: HeliumPaywallEvent) {
       break;
     case 'paywallOpenFailed':
       paywallEventHandlers = undefined;
-      presentOnFallback?.();
+      const unavailableReason = event.paywallUnavailableReason;
+      if (
+        event.triggerName &&
+        unavailableReason !== 'alreadyPresented' &&
+        unavailableReason !== 'secondTryNoMatch'
+      ) {
+        console.log('[Helium] paywall open failed', unavailableReason);
+        presentOnFallback?.();
+      }
       presentOnFallback = undefined;
       break;
   }
@@ -299,6 +317,24 @@ export const setRevenueCatAppUserId = (rcAppUserId: string) => {
   HeliumBridge.setRevenueCatAppUserId(rcAppUserId);
 };
 
+/**
+ * Set a custom user ID for the current user
+ */
+export const setCustomUserId = (newUserId: string) => {
+  HeliumBridge.setCustomUserId(newUserId);
+};
+
+/**
+ * Checks if the user has an active entitlement for any product attached to the paywall that will show for provided trigger.
+ * @param trigger The trigger name to check entitlement for
+ * @returns Promise resolving to true if entitled, false if not, or undefined if not known (i.e. the paywall is not downloaded yet)
+ */
+export const hasEntitlementForPaywall = async (
+  trigger: string
+): Promise<boolean | undefined> => {
+  return HeliumBridge.hasEntitlementForPaywall(trigger);
+};
+
 /**
  * Checks if the user has any active subscription (including non-renewable)
  */
@@ -313,6 +349,68 @@ export const hasAnyEntitlement = async (): Promise<boolean> => {
   return HeliumBridge.hasAnyEntitlement();
 };
 
+/**
+ * Get experiment allocation info for a specific trigger
+ *
+ * @param trigger The trigger name to get experiment info for
+ * @returns ExperimentInfo if the trigger has experiment data, undefined otherwise
+ */
+export const getExperimentInfoForTrigger = async (
+  trigger: string
+): Promise<ExperimentInfo | undefined> => {
+  return new Promise((resolve) => {
+    HeliumBridge.getExperimentInfoForTrigger(
+      trigger,
+      (success: boolean, data: any) => {
+        if (!success) {
+          resolve(undefined);
+          return;
+        }
+        resolve(data as ExperimentInfo);
+      }
+    );
+  });
+};
+
+/**
+ * Reset Helium entirely so you can call initialize again. Only for advanced use cases.
+ */
+export const resetHelium = () => {
+  HeliumBridge.resetHelium();
+};
+
+/**
+ * Set custom strings to show in the dialog that Helium will display if a "Restore Purchases" action is not successful.
+ * Note that these strings will not be localized by Helium for you.
+ */
+export const setCustomRestoreFailedStrings = (
+  customTitle?: string,
+  customMessage?: string,
+  customCloseButtonText?: string
+) => {
+  HeliumBridge.setCustomRestoreFailedStrings(
+    customTitle,
+    customMessage,
+    customCloseButtonText
+  );
+};
+
+/**
+ * Disable the default dialog that Helium will display if a "Restore Purchases" action is not successful.
+ * You can handle this yourself if desired by listening for the PurchaseRestoreFailedEvent.
+ */
+export const disableRestoreFailedDialog = () => {
+  HeliumBridge.disableRestoreFailedDialog();
+};
+
+/**
+ * Override the light/dark mode for Helium paywalls
+ * @param mode The mode to set: 'light', 'dark', or 'system' (follows device setting)
+ */
+export const setLightDarkModeOverride = (mode: HeliumLightDarkMode) => {
+  HeliumBridge.setLightDarkModeOverride(mode);
+};
+
 export const HELIUM_CTA_NAMES = {
   SCHEDULE_CALL: 'schedule_call',
   SUBSCRIBE_BUTTON: 'subscribe_button',

package/src/types.ts

@@ -13,6 +13,7 @@ export type HeliumDownloadStatus =
   | 'failed'
   | 'inProgress'
   | 'notStarted';
+export type HeliumLightDarkMode = 'light' | 'dark' | 'system';
 
 // --- Purchase Configuration Types ---
 
@@ -69,6 +70,8 @@ export interface PaywallEventHandlers {
   onClose?: (event: PaywallCloseEvent) => void;
   onDismissed?: (event: PaywallDismissedEvent) => void;
   onPurchaseSucceeded?: (event: PurchaseSucceededEvent) => void;
+  onOpenFailed?: (event: PaywallOpenFailedEvent) => void;
+  onCustomPaywallAction?: (event: CustomPaywallActionEvent) => void;
 }
 
 // Typed event interfaces
@@ -102,6 +105,24 @@ export interface PurchaseSucceededEvent {
   isSecondTry: boolean;
 }
 
+export interface PaywallOpenFailedEvent {
+  type: 'paywallOpenFailed';
+  triggerName: string;
+  paywallName: string;
+  error: string;
+  paywallUnavailableReason?: string;
+  isSecondTry: boolean;
+}
+
+export interface CustomPaywallActionEvent {
+  type: 'customPaywallAction';
+  triggerName: string;
+  paywallName: string;
+  actionName: string;
+  params: Record<string, any>;
+  isSecondTry: boolean;
+}
+
 export type HeliumPaywallEvent = {
   type:
     | 'paywallOpen'
@@ -121,7 +142,9 @@ export type HeliumPaywallEvent = {
     | 'initializeStart'
     | 'paywallsDownloadSuccess'
     | 'paywallsDownloadError'
-    | 'paywallWebViewRendered';
+    | 'paywallWebViewRendered'
+    | 'customPaywallAction'
+    | 'userAllocated';
   triggerName?: string;
   paywallName?: string;
   /**
@@ -155,6 +178,9 @@ export type HeliumPaywallEvent = {
    * Unix timestamp in seconds
    */
   timestamp?: number;
+  paywallUnavailableReason?: string;
+  customPaywallActionName?: string;
+  customPaywallActionParams?: Record<string, any>;
 };
 
 export type PresentUpsellParams = {
@@ -163,13 +189,18 @@ export type PresentUpsellParams = {
   onFallback?: () => void;
   eventHandlers?: PaywallEventHandlers;
   customPaywallTraits?: Record<string, any>;
+  /** Optional. If true, the paywall will not be shown if the user already has an entitlement for a product in the paywall. */
+  dontShowIfAlreadyEntitled?: boolean;
 };
 
 // --- Main Helium Configuration ---
 export interface HeliumConfig {
   /** Your Helium API Key */
   apiKey: string;
-  /** Configuration for handling purchases. Can be custom functions or a pre-built handler config. */
+  /**
+   * Configuration for handling purchases. Can be custom functions or a pre-built handler config.
+   * If not provided, Helium will handle purchases for you.
+   */
   purchaseConfig?: HeliumPurchaseConfig;
   /** Callback for receiving all Helium paywall events. */
   onHeliumPaywallEvent: (event: HeliumPaywallEvent) => void;