expo-helium 3.0.7 → 3.0.12

package/build/HeliumExperimentInfo.types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * 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;
+}
+//# sourceMappingURL=HeliumExperimentInfo.types.d.ts.map

package/build/HeliumExperimentInfo.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeliumExperimentInfo.types.d.ts","sourceRoot":"","sources":["../src/HeliumExperimentInfo.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEzC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC;IAE5C;;OAEG;IACH,oBAAoB,CAAC,EAAE,cAAc,CAAC;IAEtC;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B"}

package/build/HeliumExperimentInfo.types.js

@@ -0,0 +1,5 @@
+/**
+ * Experiment allocation information types
+ */
+export {};
+//# sourceMappingURL=HeliumExperimentInfo.types.js.map

package/build/HeliumExperimentInfo.types.js.map

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

package/build/HeliumPaywallSdk.types.d.ts

@@ -8,7 +8,7 @@ export type HeliumPaywallSdkModuleEvents = {
     paywallEventHandlers: (params: HeliumPaywallEvent) => void;
 };
 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;
     /**
@@ -43,6 +43,9 @@ export type HeliumPaywallEvent = {
      * Unix timestamp in seconds
      */
     timestamp?: number;
+    paywallUnavailableReason?: string;
+    customPaywallActionName?: string;
+    customPaywallActionParams?: Record<string, any>;
 };
 export type DelegateActionEvent = {
     type: 'purchase' | 'restore';
@@ -100,7 +103,10 @@ export type HeliumPaywallLoadingConfig = {
 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;
@@ -140,6 +146,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';
@@ -167,6 +175,22 @@ 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 declare const HELIUM_CTA_NAMES: {
     SCHEDULE_CALL: string;
     SUBSCRIBE_BUTTON: string;

package/build/HeliumPaywallSdk.types.d.ts.map

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

package/build/HeliumPaywallSdk.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"HeliumPaywallSdk.types.js","sourceRoot":"","sources":["../src/HeliumPaywallSdk.types.ts"],"names":[],"mappings":"AAgFA,sDAAsD;AACtD,MAAM,UAAU,0BAA0B,CAAC,SAG1C;IACC,OAAO;QACL,YAAY,EAAE,SAAS,CAAC,YAAY;QACpC,gBAAgB,EAAE,SAAS,CAAC,gBAAgB;KAC7C,CAAC;AACJ,CAAC;AAkHD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,aAAa,EAAE,eAAe;IAC9B,gBAAgB,EAAE,kBAAkB;CACrC,CAAA","sourcesContent":["import type { StyleProp, ViewStyle } from 'react-native';\n\nexport type OnLoadEventPayload = {\n  url: string;\n};\n\nexport type HeliumPaywallSdkModuleEvents = {\n  onHeliumPaywallEvent: (params: HeliumPaywallEvent) => void;\n  onDelegateActionEvent: (params: DelegateActionEvent) => void;\n  paywallEventHandlers: (params: HeliumPaywallEvent) => void;\n};\nexport type HeliumPaywallEvent = {\n  type: 'paywallOpen' | 'paywallClose' | 'paywallDismissed' |\n    'paywallOpenFailed' | 'paywallSkipped' | 'paywallButtonPressed' |\n    'productSelected' | 'purchasePressed' | 'purchaseSucceeded' |\n    'purchaseCancelled' | 'purchaseFailed' | 'purchaseRestored' |\n    'purchaseRestoreFailed' | 'purchasePending' | 'initializeStart' |\n    'paywallsDownloadSuccess' | 'paywallsDownloadError' | 'paywallWebViewRendered';\n  triggerName?: string;\n  paywallName?: string;\n  /**\n   * @deprecated Use `paywallName` instead.\n   */\n  paywallTemplateName?: string;\n  productId?: string;\n  /**\n   * @deprecated Use `productId` instead.\n   */\n  productKey?: string;\n  buttonName?: string;\n  /**\n   * @deprecated Use `buttonName` instead.\n   */\n  ctaName?: string;\n  configId?: string;\n  numAttempts?: number;\n  downloadTimeTakenMS?: number;\n  webviewRenderTimeTakenMS?: number;\n  imagesDownloadTimeTakenMS?: number;\n  fontsDownloadTimeTakenMS?: number;\n  bundleDownloadTimeMS?: number;\n  dismissAll?: boolean;\n  isSecondTry?: boolean;\n  error?: string;\n  /**\n   * @deprecated Use `error` instead.\n   */\n  errorDescription?: string;\n  /**\n   * Unix timestamp in seconds\n   */\n  timestamp?: number;\n};\nexport type DelegateActionEvent = {\n  type: 'purchase' | 'restore';\n  productId?: string;\n};\n\nexport type HeliumPaywallSdkViewProps = {\n  url: string;\n  onLoad: (event: { nativeEvent: OnLoadEventPayload }) => void;\n  style?: StyleProp<ViewStyle>;\n};\n\nexport type HeliumTransactionStatus = 'purchased' | 'failed' | 'cancelled' | 'pending' | 'restored';\nexport type HeliumPurchaseResult = {\n  status: HeliumTransactionStatus;\n  error?: string; // Optional error message\n};\nexport type HeliumDownloadStatus = 'downloadSuccess' | 'downloadFailure' | 'inProgress' | 'notDownloadedYet';\n\n// --- Purchase Configuration Types ---\n\n/** Interface for providing custom purchase handling logic. */\n\nexport interface HeliumPurchaseConfig {\n  makePurchase: (productId: string) => Promise<HeliumPurchaseResult>;\n  restorePurchases: () => Promise<boolean>;\n}\n\n// Helper function for creating Custom Purchase Config\nexport function createCustomPurchaseConfig(callbacks: {\n  makePurchase: (productId: string) => Promise<HeliumPurchaseResult>;\n  restorePurchases: () => Promise<boolean>;\n}): HeliumPurchaseConfig {\n  return {\n    makePurchase: callbacks.makePurchase,\n    restorePurchases: callbacks.restorePurchases,\n  };\n}\n\nexport type TriggerLoadingConfig = {\n  /** Whether to show loading state for this trigger. Set to nil to use the global `useLoadingState` setting. */\n  useLoadingState?: boolean;\n  /** Maximum seconds to show loading for this trigger. Set to nil to use the global `loadingBudget` setting. */\n  loadingBudget?: number;\n};\n\nexport type HeliumPaywallLoadingConfig = {\n  /**\n   * Whether to show a loading state while fetching paywall configuration.\n   * When true, shows a loading view for up to `loadingBudget` seconds before falling back.\n   * Default: true\n   */\n  useLoadingState?: boolean;\n  /**\n   * Maximum time (in seconds) to show the loading state before displaying fallback.\n   * After this timeout, the fallback view will be shown even if the paywall is still downloading.\n   * Default: 2.0 seconds\n   */\n  loadingBudget?: number;\n  /**\n   * Optional per-trigger loading configuration overrides.\n   * Use this to customize loading behavior for specific triggers.\n   * Keys are trigger names, values are TriggerLoadingConfig instances.\n   * Example: Disable loading for \"onboarding\" trigger while keeping it for others.\n   */\n  perTriggerLoadingConfig?: Record<string, TriggerLoadingConfig>;\n};\n\nexport interface HeliumConfig {\n  /** Your Helium API Key */\n  apiKey: string;\n  /** Configuration for handling purchases. Can be custom functions or a pre-built handler config. */\n  purchaseConfig?: HeliumPurchaseConfig;\n  /** Callback for receiving all Helium paywall events. */\n  onHeliumPaywallEvent: (event: HeliumPaywallEvent) => void; // Still mandatory\n\n  // Optional configurations\n  /** Fallback bundle in the rare situation that paywall is not ready to be shown. Highly recommended. See docs at https://docs.tryhelium.com/guides/fallback-bundle#react-native */\n  fallbackBundle?: object;\n  /** Configure loading behavior for paywalls that are mid-download. */\n  paywallLoadingConfig?: HeliumPaywallLoadingConfig;\n  customUserId?: string;\n  customAPIEndpoint?: string;\n  customUserTraits?: Record<string, any>;\n  revenueCatAppUserId?: string;\n}\n\nexport interface NativeHeliumConfig {\n  apiKey: string;\n  customUserId?: string;\n  customAPIEndpoint?: string;\n  customUserTraits?: Record<string, any>;\n  revenueCatAppUserId?: string;\n  fallbackBundleUrlString?: string;\n  fallbackBundleString?: string;\n  paywallLoadingConfig?: HeliumPaywallLoadingConfig;\n  useDefaultDelegate?: boolean;\n}\n\nexport type PresentUpsellParams = {\n  triggerName: string;\n  /** Optional. This will be called when paywall fails to show due to an unsuccessful paywall download or if an invalid trigger is provided. */\n  onFallback?: () => void;\n  eventHandlers?: PaywallEventHandlers;\n  customPaywallTraits?: Record<string, any>;\n};\n\nexport interface PaywallInfo {\n  paywallTemplateName: string;\n  shouldShow: boolean;\n}\n\n// Event handler types for per-presentation event handling\nexport interface PaywallEventHandlers {\n  onOpen?: (event: PaywallOpenEvent) => void;\n  onClose?: (event: PaywallCloseEvent) => void;\n  onDismissed?: (event: PaywallDismissedEvent) => void;\n  onPurchaseSucceeded?: (event: PurchaseSucceededEvent) => void;\n}\n\n// Typed event interfaces\nexport interface PaywallOpenEvent {\n  type: 'paywallOpen';\n  triggerName: string;\n  paywallName: string;\n  isSecondTry: boolean;\n  viewType?: 'presented' | 'embedded' | 'triggered';\n}\n\nexport interface PaywallCloseEvent {\n  type: 'paywallClose';\n  triggerName: string;\n  paywallName: string;\n  isSecondTry: boolean;\n}\n\nexport interface PaywallDismissedEvent {\n  type: 'paywallDismissed';\n  triggerName: string;\n  paywallName: string;\n  isSecondTry: boolean;\n}\n\nexport interface PurchaseSucceededEvent {\n  type: 'purchaseSucceeded';\n  productId: string;\n  triggerName: string;\n  paywallName: string;\n  isSecondTry: boolean;\n}\n\nexport const HELIUM_CTA_NAMES = {\n  SCHEDULE_CALL: 'schedule_call',\n  SUBSCRIBE_BUTTON: 'subscribe_button',\n}\n"]}
+{"version":3,"file":"HeliumPaywallSdk.types.js","sourceRoot":"","sources":["../src/HeliumPaywallSdk.types.ts"],"names":[],"mappings":"AAoFA,sDAAsD;AACtD,MAAM,UAAU,0BAA0B,CAAC,SAG1C;IACC,OAAO;QACL,YAAY,EAAE,SAAS,CAAC,YAAY;QACpC,gBAAgB,EAAE,SAAS,CAAC,gBAAgB;KAC7C,CAAC;AACJ,CAAC;AAyID,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,aAAa,EAAE,eAAe;IAC9B,gBAAgB,EAAE,kBAAkB;CACrC,CAAA","sourcesContent":["import type { StyleProp, ViewStyle } from 'react-native';\n\nexport type OnLoadEventPayload = {\n  url: string;\n};\n\nexport type HeliumPaywallSdkModuleEvents = {\n  onHeliumPaywallEvent: (params: HeliumPaywallEvent) => void;\n  onDelegateActionEvent: (params: DelegateActionEvent) => void;\n  paywallEventHandlers: (params: HeliumPaywallEvent) => void;\n};\nexport type HeliumPaywallEvent = {\n  type: 'paywallOpen' | 'paywallClose' | 'paywallDismissed' |\n    'paywallOpenFailed' | 'paywallSkipped' | 'paywallButtonPressed' |\n    'productSelected' | 'purchasePressed' | 'purchaseSucceeded' |\n    'purchaseCancelled' | 'purchaseFailed' | 'purchaseRestored' |\n    'purchaseRestoreFailed' | 'purchasePending' | 'initializeStart' |\n    'paywallsDownloadSuccess' | 'paywallsDownloadError' | 'paywallWebViewRendered' |\n    'customPaywallAction' | 'userAllocated';\n  triggerName?: string;\n  paywallName?: string;\n  /**\n   * @deprecated Use `paywallName` instead.\n   */\n  paywallTemplateName?: string;\n  productId?: string;\n  /**\n   * @deprecated Use `productId` instead.\n   */\n  productKey?: string;\n  buttonName?: string;\n  /**\n   * @deprecated Use `buttonName` instead.\n   */\n  ctaName?: string;\n  configId?: string;\n  numAttempts?: number;\n  downloadTimeTakenMS?: number;\n  webviewRenderTimeTakenMS?: number;\n  imagesDownloadTimeTakenMS?: number;\n  fontsDownloadTimeTakenMS?: number;\n  bundleDownloadTimeMS?: number;\n  dismissAll?: boolean;\n  isSecondTry?: boolean;\n  error?: string;\n  /**\n   * @deprecated Use `error` instead.\n   */\n  errorDescription?: string;\n  /**\n   * Unix timestamp in seconds\n   */\n  timestamp?: number;\n  paywallUnavailableReason?: string;\n  customPaywallActionName?: string;\n  customPaywallActionParams?: Record<string, any>;\n};\nexport type DelegateActionEvent = {\n  type: 'purchase' | 'restore';\n  productId?: string;\n};\n\nexport type HeliumPaywallSdkViewProps = {\n  url: string;\n  onLoad: (event: { nativeEvent: OnLoadEventPayload }) => void;\n  style?: StyleProp<ViewStyle>;\n};\n\nexport type HeliumTransactionStatus = 'purchased' | 'failed' | 'cancelled' | 'pending' | 'restored';\nexport type HeliumPurchaseResult = {\n  status: HeliumTransactionStatus;\n  error?: string; // Optional error message\n};\nexport type HeliumDownloadStatus = 'downloadSuccess' | 'downloadFailure' | 'inProgress' | 'notDownloadedYet';\n\n// --- Purchase Configuration Types ---\n\n/** Interface for providing custom purchase handling logic. */\n\nexport interface HeliumPurchaseConfig {\n  makePurchase: (productId: string) => Promise<HeliumPurchaseResult>;\n  restorePurchases: () => Promise<boolean>;\n}\n\n// Helper function for creating Custom Purchase Config\nexport function createCustomPurchaseConfig(callbacks: {\n  makePurchase: (productId: string) => Promise<HeliumPurchaseResult>;\n  restorePurchases: () => Promise<boolean>;\n}): HeliumPurchaseConfig {\n  return {\n    makePurchase: callbacks.makePurchase,\n    restorePurchases: callbacks.restorePurchases,\n  };\n}\n\nexport type TriggerLoadingConfig = {\n  /** Whether to show loading state for this trigger. Set to nil to use the global `useLoadingState` setting. */\n  useLoadingState?: boolean;\n  /** Maximum seconds to show loading for this trigger. Set to nil to use the global `loadingBudget` setting. */\n  loadingBudget?: number;\n};\n\nexport type HeliumPaywallLoadingConfig = {\n  /**\n   * Whether to show a loading state while fetching paywall configuration.\n   * When true, shows a loading view for up to `loadingBudget` seconds before falling back.\n   * Default: true\n   */\n  useLoadingState?: boolean;\n  /**\n   * Maximum time (in seconds) to show the loading state before displaying fallback.\n   * After this timeout, the fallback view will be shown even if the paywall is still downloading.\n   * Default: 2.0 seconds\n   */\n  loadingBudget?: number;\n  /**\n   * Optional per-trigger loading configuration overrides.\n   * Use this to customize loading behavior for specific triggers.\n   * Keys are trigger names, values are TriggerLoadingConfig instances.\n   * Example: Disable loading for \"onboarding\" trigger while keeping it for others.\n   */\n  perTriggerLoadingConfig?: Record<string, TriggerLoadingConfig>;\n};\n\nexport interface HeliumConfig {\n  /** Your Helium API Key */\n  apiKey: string;\n  /**\n   * Configuration for handling purchases. Can be custom functions or a pre-built handler config.\n   * If not provided, Helium will handle purchases for you.\n   */\n  purchaseConfig?: HeliumPurchaseConfig;\n  /** Callback for receiving all Helium paywall events. */\n  onHeliumPaywallEvent: (event: HeliumPaywallEvent) => void; // Still mandatory\n\n  // Optional configurations\n  /** Fallback bundle in the rare situation that paywall is not ready to be shown. Highly recommended. See docs at https://docs.tryhelium.com/guides/fallback-bundle#react-native */\n  fallbackBundle?: object;\n  /** Configure loading behavior for paywalls that are mid-download. */\n  paywallLoadingConfig?: HeliumPaywallLoadingConfig;\n  customUserId?: string;\n  customAPIEndpoint?: string;\n  customUserTraits?: Record<string, any>;\n  revenueCatAppUserId?: string;\n}\n\nexport interface NativeHeliumConfig {\n  apiKey: string;\n  customUserId?: string;\n  customAPIEndpoint?: string;\n  customUserTraits?: Record<string, any>;\n  revenueCatAppUserId?: string;\n  fallbackBundleUrlString?: string;\n  fallbackBundleString?: string;\n  paywallLoadingConfig?: HeliumPaywallLoadingConfig;\n  useDefaultDelegate?: boolean;\n}\n\nexport type PresentUpsellParams = {\n  triggerName: string;\n  /** Optional. This will be called when paywall fails to show due to an unsuccessful paywall download or if an invalid trigger is provided. */\n  onFallback?: () => void;\n  eventHandlers?: PaywallEventHandlers;\n  customPaywallTraits?: Record<string, any>;\n};\n\nexport interface PaywallInfo {\n  paywallTemplateName: string;\n  shouldShow: boolean;\n}\n\n// Event handler types for per-presentation event handling\nexport interface PaywallEventHandlers {\n  onOpen?: (event: PaywallOpenEvent) => void;\n  onClose?: (event: PaywallCloseEvent) => void;\n  onDismissed?: (event: PaywallDismissedEvent) => void;\n  onPurchaseSucceeded?: (event: PurchaseSucceededEvent) => void;\n  onOpenFailed?: (event: PaywallOpenFailedEvent) => void;\n  onCustomPaywallAction?: (event: CustomPaywallActionEvent) => void;\n}\n\n// Typed event interfaces\nexport interface PaywallOpenEvent {\n  type: 'paywallOpen';\n  triggerName: string;\n  paywallName: string;\n  isSecondTry: boolean;\n  viewType?: 'presented' | 'embedded' | 'triggered';\n}\n\nexport interface PaywallCloseEvent {\n  type: 'paywallClose';\n  triggerName: string;\n  paywallName: string;\n  isSecondTry: boolean;\n}\n\nexport interface PaywallDismissedEvent {\n  type: 'paywallDismissed';\n  triggerName: string;\n  paywallName: string;\n  isSecondTry: boolean;\n}\n\nexport interface PurchaseSucceededEvent {\n  type: 'purchaseSucceeded';\n  productId: string;\n  triggerName: string;\n  paywallName: string;\n  isSecondTry: boolean;\n}\n\nexport interface PaywallOpenFailedEvent {\n  type: 'paywallOpenFailed';\n  triggerName: string;\n  paywallName: string;\n  error: string;\n  paywallUnavailableReason?: string;\n  isSecondTry: boolean;\n}\n\nexport interface CustomPaywallActionEvent {\n  type: 'customPaywallAction';\n  triggerName: string;\n  paywallName: string;\n  actionName: string;\n  params: Record<string, any>;\n  isSecondTry: boolean;\n}\n\nexport const HELIUM_CTA_NAMES = {\n  SCHEDULE_CALL: 'schedule_call',\n  SUBSCRIBE_BUTTON: 'subscribe_button',\n}\n"]}

package/build/HeliumPaywallSdkModule.d.ts

@@ -1,13 +1,13 @@
 import { NativeModule } from "expo";
+import { ExperimentInfo } from "./HeliumExperimentInfo.types";
 import { HeliumDownloadStatus, HeliumPaywallSdkModuleEvents, HeliumTransactionStatus, NativeHeliumConfig } from "./HeliumPaywallSdk.types";
 interface PaywallInfoResult {
     errorMsg?: string;
     templateName?: string;
     shouldShow?: boolean;
 }
-interface CanPresentUpsellResult {
-    canPresent?: boolean;
-    reason?: string;
+interface ExperimentInfoResult extends Partial<ExperimentInfo> {
+    getExperimentInfoErrorMsg?: string;
 }
 declare class HeliumPaywallSdkModule extends NativeModule<HeliumPaywallSdkModuleEvents> {
     initialize(config: NativeHeliumConfig): void;
@@ -15,7 +15,6 @@ declare class HeliumPaywallSdkModule extends NativeModule<HeliumPaywallSdkModule
     hideUpsell(): void;
     hideAllUpsells(): void;
     getDownloadStatus(): HeliumDownloadStatus;
-    canPresentUpsell(trigger: string): CanPresentUpsellResult;
     fallbackOpenOrCloseEvent(trigger: string, isOpen: boolean, viewType: string): void;
     handlePurchaseResult(statusString: HeliumTransactionStatus, errorMsg?: string): void;
     handleRestoreResult(success: boolean): void;
@@ -24,6 +23,10 @@ declare class HeliumPaywallSdkModule extends NativeModule<HeliumPaywallSdkModule
     setRevenueCatAppUserId(rcAppUserId: string): void;
     hasAnyActiveSubscription(): Promise<boolean>;
     hasAnyEntitlement(): Promise<boolean>;
+    resetHelium(): void;
+    setCustomRestoreFailedStrings(customTitle?: string, customMessage?: string, customCloseButtonText?: string): void;
+    disableRestoreFailedDialog(): void;
+    getExperimentInfoForTrigger(trigger: string): ExperimentInfoResult;
 }
 declare const _default: HeliumPaywallSdkModule;
 export default _default;

package/build/HeliumPaywallSdkModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HeliumPaywallSdkModule.d.ts","sourceRoot":"","sources":["../src/HeliumPaywallSdkModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,MAAM,CAAC;AAEzD,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAElC,UAAU,iBAAiB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,sBAAsB;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,OAAO,OAAO,sBAAuB,SAAQ,YAAY,CAAC,4BAA4B,CAAC;IACrF,UAAU,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAE5C,aAAa,CACX,WAAW,EAAE,MAAM,EACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxC,IAAI;IAEP,UAAU,IAAI,IAAI;IAElB,cAAc,IAAI,IAAI;IAEtB,iBAAiB,IAAI,oBAAoB;IAEzC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB;IAEzD,wBAAwB,CACtB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,MAAM,GACf,IAAI;IAEP,oBAAoB,CAClB,YAAY,EAAE,uBAAuB,EACrC,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI;IAEP,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAE3C,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB;IAElD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAE1C,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAEjD,wBAAwB,IAAI,OAAO,CAAC,OAAO,CAAC;IAE5C,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;CACtC;;AAGD,wBAA+E"}
+{"version":3,"file":"HeliumPaywallSdkModule.d.ts","sourceRoot":"","sources":["../src/HeliumPaywallSdkModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,MAAM,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAElC,UAAU,iBAAiB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,oBAAqB,SAAQ,OAAO,CAAC,cAAc,CAAC;IAC5D,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,OAAO,OAAO,sBAAuB,SAAQ,YAAY,CAAC,4BAA4B,CAAC;IACrF,UAAU,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAE5C,aAAa,CACX,WAAW,EAAE,MAAM,EACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxC,IAAI;IAEP,UAAU,IAAI,IAAI;IAElB,cAAc,IAAI,IAAI;IAEtB,iBAAiB,IAAI,oBAAoB;IAEzC,wBAAwB,CACtB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,MAAM,GACf,IAAI;IAEP,oBAAoB,CAClB,YAAY,EAAE,uBAAuB,EACrC,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI;IAEP,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAE3C,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB;IAElD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAE1C,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAEjD,wBAAwB,IAAI,OAAO,CAAC,OAAO,CAAC;IAE5C,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;IAErC,WAAW,IAAI,IAAI;IAEnB,6BAA6B,CAC3B,WAAW,CAAC,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,MAAM,EACtB,qBAAqB,CAAC,EAAE,MAAM,GAC7B,IAAI;IAEP,0BAA0B,IAAI,IAAI;IAElC,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB;CACnE;;AAGD,wBAA+E"}

package/build/HeliumPaywallSdkModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"HeliumPaywallSdkModule.js","sourceRoot":"","sources":["../src/HeliumPaywallSdkModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AA4DzD,yDAAyD;AACzD,eAAe,mBAAmB,CAAyB,kBAAkB,CAAC,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from \"expo\";\n\nimport {\n  HeliumDownloadStatus,\n  HeliumPaywallSdkModuleEvents,\n  HeliumTransactionStatus,\n  NativeHeliumConfig,\n} from \"./HeliumPaywallSdk.types\";\n\ninterface PaywallInfoResult {\n  errorMsg?: string;\n  templateName?: string;\n  shouldShow?: boolean;\n}\n\ninterface CanPresentUpsellResult {\n  canPresent?: boolean;\n  reason?: string;\n}\n\ndeclare class HeliumPaywallSdkModule extends NativeModule<HeliumPaywallSdkModuleEvents> {\n  initialize(config: NativeHeliumConfig): void;\n\n  presentUpsell(\n    triggerName: string,\n    customPaywallTraits?: Record<string, any>,\n  ): void;\n\n  hideUpsell(): void;\n\n  hideAllUpsells(): void;\n\n  getDownloadStatus(): HeliumDownloadStatus;\n\n  canPresentUpsell(trigger: string): CanPresentUpsellResult;\n\n  fallbackOpenOrCloseEvent(\n    trigger: string,\n    isOpen: boolean,\n    viewType: string,\n  ): void;\n\n  handlePurchaseResult(\n    statusString: HeliumTransactionStatus,\n    errorMsg?: string,\n  ): void;\n\n  handleRestoreResult(success: boolean): void;\n\n  getPaywallInfo(trigger: string): PaywallInfoResult;\n\n  handleDeepLink(urlString: string): boolean;\n\n  setRevenueCatAppUserId(rcAppUserId: string): void;\n\n  hasAnyActiveSubscription(): Promise<boolean>;\n\n  hasAnyEntitlement(): Promise<boolean>;\n}\n\n// This call loads the native module object from the JSI.\nexport default requireNativeModule<HeliumPaywallSdkModule>(\"HeliumPaywallSdk\");\n"]}
+{"version":3,"file":"HeliumPaywallSdkModule.js","sourceRoot":"","sources":["../src/HeliumPaywallSdkModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAsEzD,yDAAyD;AACzD,eAAe,mBAAmB,CAAyB,kBAAkB,CAAC,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from \"expo\";\n\nimport { ExperimentInfo } from \"./HeliumExperimentInfo.types\";\nimport {\n  HeliumDownloadStatus,\n  HeliumPaywallSdkModuleEvents,\n  HeliumTransactionStatus,\n  NativeHeliumConfig,\n} from \"./HeliumPaywallSdk.types\";\n\ninterface PaywallInfoResult {\n  errorMsg?: string;\n  templateName?: string;\n  shouldShow?: boolean;\n}\n\ninterface ExperimentInfoResult extends Partial<ExperimentInfo> {\n  getExperimentInfoErrorMsg?: string;\n}\n\ndeclare class HeliumPaywallSdkModule extends NativeModule<HeliumPaywallSdkModuleEvents> {\n  initialize(config: NativeHeliumConfig): void;\n\n  presentUpsell(\n    triggerName: string,\n    customPaywallTraits?: Record<string, any>,\n  ): void;\n\n  hideUpsell(): void;\n\n  hideAllUpsells(): void;\n\n  getDownloadStatus(): HeliumDownloadStatus;\n\n  fallbackOpenOrCloseEvent(\n    trigger: string,\n    isOpen: boolean,\n    viewType: string,\n  ): void;\n\n  handlePurchaseResult(\n    statusString: HeliumTransactionStatus,\n    errorMsg?: string,\n  ): void;\n\n  handleRestoreResult(success: boolean): void;\n\n  getPaywallInfo(trigger: string): PaywallInfoResult;\n\n  handleDeepLink(urlString: string): boolean;\n\n  setRevenueCatAppUserId(rcAppUserId: string): void;\n\n  hasAnyActiveSubscription(): Promise<boolean>;\n\n  hasAnyEntitlement(): Promise<boolean>;\n\n  resetHelium(): void;\n\n  setCustomRestoreFailedStrings(\n    customTitle?: string,\n    customMessage?: string,\n    customCloseButtonText?: string,\n  ): void;\n\n  disableRestoreFailedDialog(): void;\n\n  getExperimentInfoForTrigger(trigger: string): ExperimentInfoResult;\n}\n\n// This call loads the native module object from the JSI.\nexport default requireNativeModule<HeliumPaywallSdkModule>(\"HeliumPaywallSdk\");\n"]}

package/build/index.d.ts

@@ -1,6 +1,8 @@
 import { HeliumConfig, PaywallInfo, PresentUpsellParams } from "./HeliumPaywallSdk.types";
+import { ExperimentInfo } from "./HeliumExperimentInfo.types";
 export { default } from './HeliumPaywallSdkModule';
 export * from './HeliumPaywallSdk.types';
+export * from './HeliumExperimentInfo.types';
 export declare const initialize: (config: HeliumConfig) => void;
 export declare const presentUpsell: ({ triggerName, onFallback, eventHandlers, customPaywallTraits, }: PresentUpsellParams) => void;
 export declare const hideUpsell: () => void;
@@ -15,6 +17,27 @@ export declare const hasAnyActiveSubscription: () => Promise<boolean>;
  * Checks if the user has any entitlement
  */
 export declare const hasAnyEntitlement: () => Promise<boolean>;
+/**
+ * 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;
+/**
+ * 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) => ExperimentInfo | undefined;
 export declare const getPaywallInfo: (trigger: string) => PaywallInfo | undefined;
 export declare const handleDeepLink: (url: string | null) => boolean;
 export { createCustomPurchaseConfig, HELIUM_CTA_NAMES } from './HeliumPaywallSdk.types';

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,EAE8B,WAAW,EAAE,mBAAmB,EAC3E,MAAM,0BAA0B,CAAC;AAKlC,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAEnD,cAAe,0BAA0B,CAAC;AAe1C,eAAO,MAAM,UAAU,GAAI,QAAQ,YAAY,SAmD9C,CAAC;AA6CF,eAAO,MAAM,aAAa,GAAI,kEAKG,mBAAmB,SAuBnD,CAAC;AA+DF,eAAO,MAAM,UAAU,YAAoC,CAAC;AAC5D,eAAO,MAAM,cAAc,YAAwC,CAAC;AACpE,eAAO,MAAM,iBAAiB,+DAA2C,CAAC;AAC1E,eAAO,MAAM,sBAAsB,+BAAgD,CAAC;AAEpF;;GAEG;AACH,eAAO,MAAM,wBAAwB,wBAAkD,CAAC;AAExF;;GAEG;AACH,eAAO,MAAM,iBAAiB,wBAA2C,CAAC;AAE1E,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,KAAG,WAAW,GAAG,SAc9D,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,GAAG,IAAI,YAOhD,CAAC;AAmCF,OAAO,EAAC,0BAA0B,EAAE,gBAAgB,EAAC,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,EAE8B,WAAW,EAAE,mBAAmB,EAC3E,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAK9D,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAEnD,cAAe,0BAA0B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAe7C,eAAO,MAAM,UAAU,GAAI,QAAQ,YAAY,SAmD9C,CAAC;AA6CF,eAAO,MAAM,aAAa,GAAI,kEAKG,mBAAmB,SAYnD,CAAC;AAyFF,eAAO,MAAM,UAAU,YAAoC,CAAC;AAC5D,eAAO,MAAM,cAAc,YAAwC,CAAC;AACpE,eAAO,MAAM,iBAAiB,+DAA2C,CAAC;AAC1E,eAAO,MAAM,sBAAsB,+BAAgD,CAAC;AAEpF;;GAEG;AACH,eAAO,MAAM,wBAAwB,wBAAkD,CAAC;AAExF;;GAEG;AACH,eAAO,MAAM,iBAAiB,wBAA2C,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,WAAW,YAAqC,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,6BAA6B,wFAAuD,CAAC;AAElG;;;GAGG;AACH,eAAO,MAAM,0BAA0B,YAAoD,CAAC;AAE5F;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,GAAI,SAAS,MAAM,KAAG,cAAc,GAAG,SAe9E,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,KAAG,WAAW,GAAG,SAc9D,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,GAAG,IAAI,YAOhD,CAAC;AAmCF,OAAO,EAAC,0BAA0B,EAAE,gBAAgB,EAAC,MAAM,0BAA0B,CAAC"}

package/build/index.js

@@ -3,6 +3,7 @@ import * as ExpoFileSystem from 'expo-file-system';
 export { default } from './HeliumPaywallSdkModule';
 // export { default as HeliumPaywallSdkView } from './HeliumPaywallSdkView';
 export * from './HeliumPaywallSdk.types';
+export * from './HeliumExperimentInfo.types';
 function addHeliumPaywallEventListener(listener) {
     return HeliumPaywallSdkModule.addListener('onHeliumPaywallEvent', listener);
 }
@@ -99,20 +100,13 @@ const nativeInitializeAsync = async (config) => {
 let paywallEventHandlers;
 let presentOnFallback;
 export const presentUpsell = ({ triggerName, onFallback, eventHandlers, customPaywallTraits, }) => {
-    const { canPresent, reason } = HeliumPaywallSdkModule.canPresentUpsell(triggerName);
-    if (!canPresent) {
-        console.log(`[Helium] Cannot present trigger "${triggerName}". Reason: ${reason}`);
-        onFallback?.();
-        HeliumPaywallSdkModule.fallbackOpenOrCloseEvent(triggerName, true, 'presented');
-        return;
-    }
     try {
         paywallEventHandlers = eventHandlers;
         presentOnFallback = onFallback;
         HeliumPaywallSdkModule.presentUpsell(triggerName, convertBooleansToMarkers(customPaywallTraits));
     }
     catch (error) {
-        console.log('Helium present error', error);
+        console.log('[Helium] presentUpsell error', error);
         paywallEventHandlers = undefined;
         presentOnFallback = undefined;
         onFallback?.();
@@ -156,6 +150,26 @@ function callPaywallEventHandlers(event) {
                     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;
         }
     }
 }
@@ -173,7 +187,13 @@ function handlePaywallEvent(event) {
             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;
     }
@@ -190,6 +210,42 @@ export const hasAnyActiveSubscription = HeliumPaywallSdkModule.hasAnyActiveSubsc
  * Checks if the user has any entitlement
  */
 export const hasAnyEntitlement = HeliumPaywallSdkModule.hasAnyEntitlement;
+/**
+ * Reset Helium entirely so you can call initialize again. Only for advanced use cases.
+ */
+export const resetHelium = HeliumPaywallSdkModule.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 = HeliumPaywallSdkModule.setCustomRestoreFailedStrings;
+/**
+ * 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 = HeliumPaywallSdkModule.disableRestoreFailedDialog;
+/**
+ * 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 = (trigger) => {
+    const result = HeliumPaywallSdkModule.getExperimentInfoForTrigger(trigger);
+    if (!result) {
+        console.log('[Helium] getExperimentInfoForTrigger unexpected error.');
+        return;
+    }
+    if (result.getExperimentInfoErrorMsg) {
+        return;
+    }
+    // Validate required field exists before casting
+    if (!result.trigger) {
+        console.log('[Helium] getExperimentInfoForTrigger returned data without required trigger field.');
+        return;
+    }
+    return result;
+};
 export const getPaywallInfo = (trigger) => {
     const result = HeliumPaywallSdkModule.getPaywallInfo(trigger);
     if (!result) {

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  DelegateActionEvent,\n  HeliumConfig,\n  HeliumPaywallEvent,\n  NativeHeliumConfig, PaywallEventHandlers, PaywallInfo, PresentUpsellParams,\n} from \"./HeliumPaywallSdk.types\";\nimport HeliumPaywallSdkModule from \"./HeliumPaywallSdkModule\";\nimport { EventSubscription } from 'expo-modules-core';\nimport * as ExpoFileSystem from 'expo-file-system';\n\nexport { default } from './HeliumPaywallSdkModule';\n// export { default as HeliumPaywallSdkView } from './HeliumPaywallSdkView';\nexport * from  './HeliumPaywallSdk.types';\n\nfunction addHeliumPaywallEventListener(listener: (event: HeliumPaywallEvent) => void): EventSubscription {\n  return HeliumPaywallSdkModule.addListener('onHeliumPaywallEvent', listener);\n}\n\nfunction addDelegateActionEventListener(listener: (event: DelegateActionEvent) => void): EventSubscription {\n  return HeliumPaywallSdkModule.addListener('onDelegateActionEvent', listener);\n}\n\nfunction addPaywallEventHandlersListener(listener: (event: HeliumPaywallEvent) => void): EventSubscription {\n  return HeliumPaywallSdkModule.addListener('paywallEventHandlers', listener);\n}\n\nlet isInitialized = false;\nexport const initialize = (config: HeliumConfig) => {\n  if (isInitialized) {\n    return;\n  }\n  isInitialized = true;\n\n  HeliumPaywallSdkModule.removeAllListeners('onHeliumPaywallEvent');\n  HeliumPaywallSdkModule.removeAllListeners('onDelegateActionEvent');\n  HeliumPaywallSdkModule.removeAllListeners('paywallEventHandlers');\n\n  // Set up listener for paywall events\n  addHeliumPaywallEventListener((event) => {\n    handlePaywallEvent(event);\n    config.onHeliumPaywallEvent(event);\n  });\n\n  // Set up delegate action listener for purchase and restore operations\n  const purchaseConfig = config.purchaseConfig;\n  if (purchaseConfig) {\n    addDelegateActionEventListener(async (event) => {\n      try {\n        if (event.type === 'purchase') {\n          if (event.productId) {\n            const result = await purchaseConfig.makePurchase(event.productId);\n            HeliumPaywallSdkModule.handlePurchaseResult(result.status, result.error);\n          } else {\n            HeliumPaywallSdkModule.handlePurchaseResult('failed', 'No product ID for purchase event.');\n          }\n        } else if (event.type === 'restore') {\n          const success = await purchaseConfig.restorePurchases();\n          HeliumPaywallSdkModule.handleRestoreResult(success);\n        }\n      } catch (error) {\n        // Send failure result based on action type\n        if (event.type === 'purchase') {\n          console.log('[Helium] Unexpected error: ', error);\n          HeliumPaywallSdkModule.handlePurchaseResult('failed');\n        } else if (event.type === 'restore') {\n          HeliumPaywallSdkModule.handleRestoreResult(false);\n        }\n      }\n    });\n  }\n\n  addPaywallEventHandlersListener((event) => {\n    callPaywallEventHandlers(event);\n  });\n\n  nativeInitializeAsync(config).catch(error => {\n    console.error('[Helium] Initialization failed:', error);\n  });\n};\n\nconst nativeInitializeAsync = async (config: HeliumConfig) => {\n  let fallbackBundleUrlString;\n  let fallbackBundleString;\n  if (config.fallbackBundle) {\n    try {\n      const jsonContent = JSON.stringify(config.fallbackBundle);\n\n      // Write to documents directory\n      fallbackBundleUrlString = `${ExpoFileSystem.documentDirectory}helium-fallback.json`;\n      // This is ASYNC but that's ok because helium initialize in swift code is async anyways.\n      await ExpoFileSystem.writeAsStringAsync(\n        fallbackBundleUrlString,\n        jsonContent\n      );\n    } catch (error) {\n      // Fallback to string approach if unexpected error occurs\n      console.log(\n        '[Helium] expo-file-system not available, attempting to pass fallback bundle as string.'\n      );\n      fallbackBundleString = JSON.stringify(config.fallbackBundle);\n    }\n  }\n\n\n  // Create native config object\n  const nativeConfig: NativeHeliumConfig = {\n    apiKey: config.apiKey,\n    customUserId: config.customUserId,\n    customAPIEndpoint: config.customAPIEndpoint,\n    customUserTraits: convertBooleansToMarkers(config.customUserTraits),\n    revenueCatAppUserId: config.revenueCatAppUserId,\n    fallbackBundleUrlString: fallbackBundleUrlString,\n    fallbackBundleString: fallbackBundleString,\n    paywallLoadingConfig: convertBooleansToMarkers(config.paywallLoadingConfig),\n    useDefaultDelegate: !config.purchaseConfig,\n  };\n\n  // Initialize the native module\n  HeliumPaywallSdkModule.initialize(nativeConfig);\n};\n\nlet paywallEventHandlers: PaywallEventHandlers | undefined;\nlet presentOnFallback: (() => void) | undefined;\nexport const presentUpsell = ({\n                                triggerName,\n                                onFallback,\n                                eventHandlers,\n                                customPaywallTraits,\n                              }: PresentUpsellParams) => {\n  const {canPresent, reason} = HeliumPaywallSdkModule.canPresentUpsell(triggerName);\n\n  if (!canPresent) {\n    console.log(\n      `[Helium] Cannot present trigger \"${triggerName}\". Reason: ${reason}`\n    );\n    onFallback?.();\n    HeliumPaywallSdkModule.fallbackOpenOrCloseEvent(triggerName, true, 'presented');\n    return;\n  }\n\n  try {\n    paywallEventHandlers = eventHandlers;\n    presentOnFallback = onFallback;\n    HeliumPaywallSdkModule.presentUpsell(triggerName, convertBooleansToMarkers(customPaywallTraits));\n  } catch (error) {\n    console.log('Helium present error', error);\n    paywallEventHandlers = undefined;\n    presentOnFallback = undefined;\n    onFallback?.();\n    HeliumPaywallSdkModule.fallbackOpenOrCloseEvent(triggerName, true, 'presented');\n  }\n};\n\nfunction callPaywallEventHandlers(event: HeliumPaywallEvent) {\n  if (paywallEventHandlers) {\n    switch (event.type) {\n      case 'paywallOpen':\n        paywallEventHandlers?.onOpen?.({\n          type: 'paywallOpen',\n          triggerName: event.triggerName ?? 'unknown',\n          paywallName: event.paywallName ?? 'unknown',\n          isSecondTry: event.isSecondTry ?? false,\n          viewType: 'presented',\n        });\n        break;\n      case 'paywallClose':\n        paywallEventHandlers?.onClose?.({\n          type: 'paywallClose',\n          triggerName: event.triggerName ?? 'unknown',\n          paywallName: event.paywallName ?? 'unknown',\n          isSecondTry: event.isSecondTry ?? false,\n        });\n        break;\n      case 'paywallDismissed':\n        paywallEventHandlers?.onDismissed?.({\n          type: 'paywallDismissed',\n          triggerName: event.triggerName ?? 'unknown',\n          paywallName: event.paywallName ?? 'unknown',\n          isSecondTry: event.isSecondTry ?? false,\n        });\n        break;\n      case 'purchaseSucceeded':\n        paywallEventHandlers?.onPurchaseSucceeded?.({\n          type: 'purchaseSucceeded',\n          productId: event.productId ?? 'unknown',\n          triggerName: event.triggerName ?? 'unknown',\n          paywallName: event.paywallName ?? 'unknown',\n          isSecondTry: event.isSecondTry ?? false,\n        });\n        break;\n    }\n  }\n}\n\nfunction handlePaywallEvent(event: HeliumPaywallEvent) {\n  switch (event.type) {\n    case 'paywallClose':\n      if (!event.isSecondTry) {\n        paywallEventHandlers = undefined;\n      }\n      presentOnFallback = undefined;\n      break;\n    case 'paywallSkipped':\n      paywallEventHandlers = undefined;\n      presentOnFallback = undefined;\n      break;\n    case 'paywallOpenFailed':\n      paywallEventHandlers = undefined;\n      presentOnFallback?.();\n      presentOnFallback = undefined;\n      break;\n  }\n}\n\nexport const hideUpsell = HeliumPaywallSdkModule.hideUpsell;\nexport const hideAllUpsells = HeliumPaywallSdkModule.hideAllUpsells;\nexport const getDownloadStatus = HeliumPaywallSdkModule.getDownloadStatus;\nexport const setRevenueCatAppUserId = HeliumPaywallSdkModule.setRevenueCatAppUserId;\n\n/**\n * Checks if the user has any active subscription (including non-renewable)\n */\nexport const hasAnyActiveSubscription = HeliumPaywallSdkModule.hasAnyActiveSubscription;\n\n/**\n * Checks if the user has any entitlement\n */\nexport const hasAnyEntitlement = HeliumPaywallSdkModule.hasAnyEntitlement;\n\nexport const getPaywallInfo = (trigger: string): PaywallInfo | undefined => {\n  const result = HeliumPaywallSdkModule.getPaywallInfo(trigger);\n  if (!result) {\n    console.log('[Helium] getPaywallInfo unexpected error.');\n    return;\n  }\n  if (result.errorMsg) {\n    console.log(`[Helium] ${result.errorMsg}`);\n    return;\n  }\n  return {\n    paywallTemplateName: result.templateName ?? 'unknown template',\n    shouldShow: result.shouldShow ?? true,\n  };\n};\n\nexport const handleDeepLink = (url: string | null) => {\n  if (url) {\n    const handled = HeliumPaywallSdkModule.handleDeepLink(url);\n    console.log('[Helium] Handled deep link:', handled);\n    return handled;\n  }\n  return false;\n};\n\n/**\n * Recursively converts boolean values to special marker strings to preserve\n * type information when passing through native bridge.\n *\n * Native bridge converts booleans to NSNumber (0/1), making them\n * indistinguishable from actual numeric values. This helper converts:\n * - true -> \"__helium_rn_bool_true__\"\n * - false -> \"__helium_rn_bool_false__\"\n * - All other values remain unchanged\n */\nfunction convertBooleansToMarkers(input: Record<string, any> | undefined): Record<string, any> | undefined {\n  if (!input) return undefined;\n\n  const result: Record<string, any> = {};\n  for (const [key, value] of Object.entries(input)) {\n    result[key] = convertValueBooleansToMarkers(value);\n  }\n  return result;\n}\n/**\n * Helper to recursively convert booleans in any value type\n */\nfunction convertValueBooleansToMarkers(value: any): any {\n  if (typeof value === 'boolean') {\n    return value ? \"__helium_rn_bool_true__\" : \"__helium_rn_bool_false__\";\n  } else if (value && typeof value === 'object' && !Array.isArray(value)) {\n    return convertBooleansToMarkers(value);\n  } else if (value && Array.isArray(value)) {\n    return value.map(convertValueBooleansToMarkers);\n  }\n  return value;\n}\n\nexport {createCustomPurchaseConfig, HELIUM_CTA_NAMES} from './HeliumPaywallSdk.types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  DelegateActionEvent,\n  HeliumConfig,\n  HeliumPaywallEvent,\n  NativeHeliumConfig, PaywallEventHandlers, PaywallInfo, PresentUpsellParams,\n} from \"./HeliumPaywallSdk.types\";\nimport { ExperimentInfo } from \"./HeliumExperimentInfo.types\";\nimport HeliumPaywallSdkModule from \"./HeliumPaywallSdkModule\";\nimport { EventSubscription } from 'expo-modules-core';\nimport * as ExpoFileSystem from 'expo-file-system';\n\nexport { default } from './HeliumPaywallSdkModule';\n// export { default as HeliumPaywallSdkView } from './HeliumPaywallSdkView';\nexport * from  './HeliumPaywallSdk.types';\nexport * from './HeliumExperimentInfo.types';\n\nfunction addHeliumPaywallEventListener(listener: (event: HeliumPaywallEvent) => void): EventSubscription {\n  return HeliumPaywallSdkModule.addListener('onHeliumPaywallEvent', listener);\n}\n\nfunction addDelegateActionEventListener(listener: (event: DelegateActionEvent) => void): EventSubscription {\n  return HeliumPaywallSdkModule.addListener('onDelegateActionEvent', listener);\n}\n\nfunction addPaywallEventHandlersListener(listener: (event: HeliumPaywallEvent) => void): EventSubscription {\n  return HeliumPaywallSdkModule.addListener('paywallEventHandlers', listener);\n}\n\nlet isInitialized = false;\nexport const initialize = (config: HeliumConfig) => {\n  if (isInitialized) {\n    return;\n  }\n  isInitialized = true;\n\n  HeliumPaywallSdkModule.removeAllListeners('onHeliumPaywallEvent');\n  HeliumPaywallSdkModule.removeAllListeners('onDelegateActionEvent');\n  HeliumPaywallSdkModule.removeAllListeners('paywallEventHandlers');\n\n  // Set up listener for paywall events\n  addHeliumPaywallEventListener((event) => {\n    handlePaywallEvent(event);\n    config.onHeliumPaywallEvent(event);\n  });\n\n  // Set up delegate action listener for purchase and restore operations\n  const purchaseConfig = config.purchaseConfig;\n  if (purchaseConfig) {\n    addDelegateActionEventListener(async (event) => {\n      try {\n        if (event.type === 'purchase') {\n          if (event.productId) {\n            const result = await purchaseConfig.makePurchase(event.productId);\n            HeliumPaywallSdkModule.handlePurchaseResult(result.status, result.error);\n          } else {\n            HeliumPaywallSdkModule.handlePurchaseResult('failed', 'No product ID for purchase event.');\n          }\n        } else if (event.type === 'restore') {\n          const success = await purchaseConfig.restorePurchases();\n          HeliumPaywallSdkModule.handleRestoreResult(success);\n        }\n      } catch (error) {\n        // Send failure result based on action type\n        if (event.type === 'purchase') {\n          console.log('[Helium] Unexpected error: ', error);\n          HeliumPaywallSdkModule.handlePurchaseResult('failed');\n        } else if (event.type === 'restore') {\n          HeliumPaywallSdkModule.handleRestoreResult(false);\n        }\n      }\n    });\n  }\n\n  addPaywallEventHandlersListener((event) => {\n    callPaywallEventHandlers(event);\n  });\n\n  nativeInitializeAsync(config).catch(error => {\n    console.error('[Helium] Initialization failed:', error);\n  });\n};\n\nconst nativeInitializeAsync = async (config: HeliumConfig) => {\n  let fallbackBundleUrlString;\n  let fallbackBundleString;\n  if (config.fallbackBundle) {\n    try {\n      const jsonContent = JSON.stringify(config.fallbackBundle);\n\n      // Write to documents directory\n      fallbackBundleUrlString = `${ExpoFileSystem.documentDirectory}helium-fallback.json`;\n      // This is ASYNC but that's ok because helium initialize in swift code is async anyways.\n      await ExpoFileSystem.writeAsStringAsync(\n        fallbackBundleUrlString,\n        jsonContent\n      );\n    } catch (error) {\n      // Fallback to string approach if unexpected error occurs\n      console.log(\n        '[Helium] expo-file-system not available, attempting to pass fallback bundle as string.'\n      );\n      fallbackBundleString = JSON.stringify(config.fallbackBundle);\n    }\n  }\n\n\n  // Create native config object\n  const nativeConfig: NativeHeliumConfig = {\n    apiKey: config.apiKey,\n    customUserId: config.customUserId,\n    customAPIEndpoint: config.customAPIEndpoint,\n    customUserTraits: convertBooleansToMarkers(config.customUserTraits),\n    revenueCatAppUserId: config.revenueCatAppUserId,\n    fallbackBundleUrlString: fallbackBundleUrlString,\n    fallbackBundleString: fallbackBundleString,\n    paywallLoadingConfig: convertBooleansToMarkers(config.paywallLoadingConfig),\n    useDefaultDelegate: !config.purchaseConfig,\n  };\n\n  // Initialize the native module\n  HeliumPaywallSdkModule.initialize(nativeConfig);\n};\n\nlet paywallEventHandlers: PaywallEventHandlers | undefined;\nlet presentOnFallback: (() => void) | undefined;\nexport const presentUpsell = ({\n                                triggerName,\n                                onFallback,\n                                eventHandlers,\n                                customPaywallTraits,\n                              }: PresentUpsellParams) => {\n  try {\n    paywallEventHandlers = eventHandlers;\n    presentOnFallback = onFallback;\n    HeliumPaywallSdkModule.presentUpsell(triggerName, convertBooleansToMarkers(customPaywallTraits));\n  } catch (error) {\n    console.log('[Helium] presentUpsell error', error);\n    paywallEventHandlers = undefined;\n    presentOnFallback = undefined;\n    onFallback?.();\n    HeliumPaywallSdkModule.fallbackOpenOrCloseEvent(triggerName, true, 'presented');\n  }\n};\n\nfunction callPaywallEventHandlers(event: HeliumPaywallEvent) {\n  if (paywallEventHandlers) {\n    switch (event.type) {\n      case 'paywallOpen':\n        paywallEventHandlers?.onOpen?.({\n          type: 'paywallOpen',\n          triggerName: event.triggerName ?? 'unknown',\n          paywallName: event.paywallName ?? 'unknown',\n          isSecondTry: event.isSecondTry ?? false,\n          viewType: 'presented',\n        });\n        break;\n      case 'paywallClose':\n        paywallEventHandlers?.onClose?.({\n          type: 'paywallClose',\n          triggerName: event.triggerName ?? 'unknown',\n          paywallName: event.paywallName ?? 'unknown',\n          isSecondTry: event.isSecondTry ?? false,\n        });\n        break;\n      case 'paywallDismissed':\n        paywallEventHandlers?.onDismissed?.({\n          type: 'paywallDismissed',\n          triggerName: event.triggerName ?? 'unknown',\n          paywallName: event.paywallName ?? 'unknown',\n          isSecondTry: event.isSecondTry ?? false,\n        });\n        break;\n      case 'purchaseSucceeded':\n        paywallEventHandlers?.onPurchaseSucceeded?.({\n          type: 'purchaseSucceeded',\n          productId: event.productId ?? 'unknown',\n          triggerName: event.triggerName ?? 'unknown',\n          paywallName: event.paywallName ?? 'unknown',\n          isSecondTry: event.isSecondTry ?? false,\n        });\n        break;\n      case 'paywallOpenFailed':\n        paywallEventHandlers?.onOpenFailed?.({\n          type: 'paywallOpenFailed',\n          triggerName: event.triggerName ?? 'unknown',\n          paywallName: event.paywallName ?? 'unknown',\n          error: event.error ?? 'Unknown error',\n          paywallUnavailableReason: event.paywallUnavailableReason,\n          isSecondTry: event.isSecondTry ?? false,\n        });\n        break;\n      case 'customPaywallAction':\n        paywallEventHandlers?.onCustomPaywallAction?.({\n          type: 'customPaywallAction',\n          triggerName: event.triggerName ?? 'unknown',\n          paywallName: event.paywallName ?? 'unknown',\n          actionName: event.customPaywallActionName ?? 'unknown',\n          params: event.customPaywallActionParams ?? {},\n          isSecondTry: event.isSecondTry ?? false,\n        });\n        break;\n    }\n  }\n}\n\nfunction handlePaywallEvent(event: HeliumPaywallEvent) {\n  switch (event.type) {\n    case 'paywallClose':\n      if (!event.isSecondTry) {\n        paywallEventHandlers = undefined;\n      }\n      presentOnFallback = undefined;\n      break;\n    case 'paywallSkipped':\n      paywallEventHandlers = undefined;\n      presentOnFallback = undefined;\n      break;\n    case 'paywallOpenFailed':\n      paywallEventHandlers = undefined;\n      const unavailableReason = event.paywallUnavailableReason;\n      if (event.triggerName\n        && unavailableReason !== \"alreadyPresented\"\n        && unavailableReason !== \"secondTryNoMatch\") {\n        console.log('[Helium] paywall open failed', unavailableReason);\n        presentOnFallback?.();\n      }\n      presentOnFallback = undefined;\n      break;\n  }\n}\n\nexport const hideUpsell = HeliumPaywallSdkModule.hideUpsell;\nexport const hideAllUpsells = HeliumPaywallSdkModule.hideAllUpsells;\nexport const getDownloadStatus = HeliumPaywallSdkModule.getDownloadStatus;\nexport const setRevenueCatAppUserId = HeliumPaywallSdkModule.setRevenueCatAppUserId;\n\n/**\n * Checks if the user has any active subscription (including non-renewable)\n */\nexport const hasAnyActiveSubscription = HeliumPaywallSdkModule.hasAnyActiveSubscription;\n\n/**\n * Checks if the user has any entitlement\n */\nexport const hasAnyEntitlement = HeliumPaywallSdkModule.hasAnyEntitlement;\n\n/**\n * Reset Helium entirely so you can call initialize again. Only for advanced use cases.\n */\nexport const resetHelium = HeliumPaywallSdkModule.resetHelium;\n\n/**\n * Set custom strings to show in the dialog that Helium will display if a \"Restore Purchases\" action is not successful.\n * Note that these strings will not be localized by Helium for you.\n */\nexport const setCustomRestoreFailedStrings = HeliumPaywallSdkModule.setCustomRestoreFailedStrings;\n\n/**\n * Disable the default dialog that Helium will display if a \"Restore Purchases\" action is not successful.\n * You can handle this yourself if desired by listening for the PurchaseRestoreFailedEvent.\n */\nexport const disableRestoreFailedDialog = HeliumPaywallSdkModule.disableRestoreFailedDialog;\n\n/**\n * Get experiment allocation info for a specific trigger\n *\n * @param trigger The trigger name to get experiment info for\n * @returns ExperimentInfo if the trigger has experiment data, undefined otherwise\n */\nexport const getExperimentInfoForTrigger = (trigger: string): ExperimentInfo | undefined => {\n  const result = HeliumPaywallSdkModule.getExperimentInfoForTrigger(trigger);\n  if (!result) {\n    console.log('[Helium] getExperimentInfoForTrigger unexpected error.');\n    return;\n  }\n  if (result.getExperimentInfoErrorMsg) {\n    return;\n  }\n  // Validate required field exists before casting\n  if (!result.trigger) {\n    console.log('[Helium] getExperimentInfoForTrigger returned data without required trigger field.');\n    return;\n  }\n  return result as ExperimentInfo;\n};\n\nexport const getPaywallInfo = (trigger: string): PaywallInfo | undefined => {\n  const result = HeliumPaywallSdkModule.getPaywallInfo(trigger);\n  if (!result) {\n    console.log('[Helium] getPaywallInfo unexpected error.');\n    return;\n  }\n  if (result.errorMsg) {\n    console.log(`[Helium] ${result.errorMsg}`);\n    return;\n  }\n  return {\n    paywallTemplateName: result.templateName ?? 'unknown template',\n    shouldShow: result.shouldShow ?? true,\n  };\n};\n\nexport const handleDeepLink = (url: string | null) => {\n  if (url) {\n    const handled = HeliumPaywallSdkModule.handleDeepLink(url);\n    console.log('[Helium] Handled deep link:', handled);\n    return handled;\n  }\n  return false;\n};\n\n/**\n * Recursively converts boolean values to special marker strings to preserve\n * type information when passing through native bridge.\n *\n * Native bridge converts booleans to NSNumber (0/1), making them\n * indistinguishable from actual numeric values. This helper converts:\n * - true -> \"__helium_rn_bool_true__\"\n * - false -> \"__helium_rn_bool_false__\"\n * - All other values remain unchanged\n */\nfunction convertBooleansToMarkers(input: Record<string, any> | undefined): Record<string, any> | undefined {\n  if (!input) return undefined;\n\n  const result: Record<string, any> = {};\n  for (const [key, value] of Object.entries(input)) {\n    result[key] = convertValueBooleansToMarkers(value);\n  }\n  return result;\n}\n/**\n * Helper to recursively convert booleans in any value type\n */\nfunction convertValueBooleansToMarkers(value: any): any {\n  if (typeof value === 'boolean') {\n    return value ? \"__helium_rn_bool_true__\" : \"__helium_rn_bool_false__\";\n  } else if (value && typeof value === 'object' && !Array.isArray(value)) {\n    return convertBooleansToMarkers(value);\n  } else if (value && Array.isArray(value)) {\n    return value.map(convertValueBooleansToMarkers);\n  }\n  return value;\n}\n\nexport {createCustomPurchaseConfig, HELIUM_CTA_NAMES} from './HeliumPaywallSdk.types';\n"]}

package/ios/HeliumPaywallSdk.podspec

@@ -19,7 +19,7 @@ Pod::Spec.new do |s|
   s.static_framework = true
 
   s.dependency 'ExpoModulesCore'
-  s.dependency 'Helium', '3.0.6'
+  s.dependency 'Helium', '3.0.12'
 
   # Swift/Objective-C compatibility
   s.pod_target_xcconfig = {

package/ios/HeliumPaywallSdkModule.swift

@@ -28,13 +28,6 @@ struct PaywallInfoResult: Record {
   var shouldShow: Bool? = nil
 }
 
-struct CanPresentPaywallResult: Record {
-  @Field
-  var canPresent: Bool = false
-  @Field
-  var reason: String? = nil
-}
-
 public class HeliumPaywallSdkModule: Module {
   // Single continuations for ongoing operations
   private var currentProductId: String? = nil
@@ -232,6 +225,12 @@ public class HeliumPaywallSdkModule: Module {
                 },
                 onPurchaseSucceeded: { [weak self] event in
                     self?.sendEvent("paywallEventHandlers", event.toDictionary())
+                },
+                onOpenFailed: { [weak self] event in
+                  self?.sendEvent("paywallEventHandlers", event.toDictionary())
+                },
+                onCustomPaywallAction: { [weak self] event in
+                  self?.sendEvent("paywallEventHandlers", event.toDictionary())
                 }
             ),
             customPaywallTraits: convertMarkersToBooleans(customPaywallTraits)
@@ -251,7 +250,7 @@ public class HeliumPaywallSdkModule: Module {
     }
 
     Function("fallbackOpenOrCloseEvent") { (trigger: String?, isOpen: Bool, viewType: String?) in
-      HeliumPaywallDelegateWrapper.shared.onFallbackOpenCloseEvent(trigger: trigger, isOpen: isOpen, viewType: viewType)
+      HeliumPaywallDelegateWrapper.shared.onFallbackOpenCloseEvent(trigger: trigger, isOpen: isOpen, viewType: viewType, fallbackReason: .bridgingError)
     }
 
     Function("getPaywallInfo") { (trigger: String) in
@@ -270,44 +269,6 @@ public class HeliumPaywallSdkModule: Module {
       )
     }
 
-    Function("canPresentUpsell") { (trigger: String) in
-      // Check if paywalls are downloaded successfully
-      let paywallsLoaded = Helium.shared.paywallsLoaded()
-
-      // Check if trigger exists in fetched triggers
-      let triggerNames = HeliumFetchedConfigManager.shared.getFetchedTriggerNames()
-      let hasTrigger = triggerNames.contains(trigger)
-
-      let canPresent: Bool
-      let reason: String
-
-      let useLoading = Helium.shared.loadingStateEnabledFor(trigger: trigger)
-      let downloadInProgress = Helium.shared.getDownloadStatus() == .inProgress
-
-      if paywallsLoaded && hasTrigger {
-        // Normal case - paywall is ready
-        canPresent = true
-        reason = "ready"
-      } else if downloadInProgress && useLoading {
-        // Loading case - paywall still downloading
-        canPresent = true
-        reason = "loading"
-      } else if HeliumFallbackViewManager.shared.getFallbackInfo(trigger: trigger) != nil {
-        // Fallback is available (via downloaded bundle)
-        canPresent = true
-        reason = "fallback_ready"
-      } else {
-        // No paywall and no fallback bundle
-        canPresent = false
-        reason = !paywallsLoaded ? "download status - \(Helium.shared.getDownloadStatus().rawValue)" : "trigger_not_found"
-      }
-
-      return CanPresentPaywallResult(
-        canPresent: canPresent,
-        reason: reason
-      )
-    }
-
     Function("setRevenueCatAppUserId") { (rcAppUserId: String) in
         Helium.shared.setRevenueCatAppUserId(rcAppUserId)
     }
@@ -328,6 +289,38 @@ public class HeliumPaywallSdkModule: Module {
       return Helium.shared.handleDeepLink(url)
     }
 
+    Function("getExperimentInfoForTrigger") { (trigger: String) -> [String: Any] in
+      guard let experimentInfo = Helium.shared.getExperimentInfoForTrigger(trigger) else {
+        return ["getExperimentInfoErrorMsg": "No experiment info found for trigger: \(trigger)"]
+      }
+
+      // Convert ExperimentInfo to dictionary using JSONEncoder
+      let encoder = JSONEncoder()
+      guard let jsonData = try? encoder.encode(experimentInfo),
+          var dictionary = try? JSONSerialization.jsonObject(with: jsonData, options: []) as? [String: Any] else {
+        return ["getExperimentInfoErrorMsg": "Failed to serialize experiment info"]
+      }
+
+      // Return the dictionary directly - it contains all ExperimentInfo fields
+      return dictionary
+    }
+
+    Function("disableRestoreFailedDialog") {
+        Helium.restorePurchaseConfig.disableRestoreFailedDialog()
+    }
+
+    Function("setCustomRestoreFailedStrings") { (customTitle: String?, customMessage: String?, customCloseButtonText: String?) in
+      Helium.restorePurchaseConfig.setCustomRestoreFailedStrings(
+        customTitle: customTitle,
+        customMessage: customMessage,
+        customCloseButtonText: customCloseButtonText
+      )
+    }
+
+    Function("resetHelium") {
+      Helium.resetHelium()
+    }
+
     // Enables the module to be used as a native view. Definition components that are accepted as part of the
     // view definition: Prop, Events.
     View(HeliumPaywallSdkView.self) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-helium",
-  "version": "3.0.7",
+  "version": "3.0.12",
   "description": "Helium paywalls expo sdk",
   "main": "build/index.js",
   "types": "build/index.d.ts",

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/HeliumPaywallSdk.types.ts

@@ -15,7 +15,8 @@ export type HeliumPaywallEvent = {
     'productSelected' | 'purchasePressed' | 'purchaseSucceeded' |
     'purchaseCancelled' | 'purchaseFailed' | 'purchaseRestored' |
     'purchaseRestoreFailed' | 'purchasePending' | 'initializeStart' |
-    'paywallsDownloadSuccess' | 'paywallsDownloadError' | 'paywallWebViewRendered';
+    'paywallsDownloadSuccess' | 'paywallsDownloadError' | 'paywallWebViewRendered' |
+    'customPaywallAction' | 'userAllocated';
   triggerName?: string;
   paywallName?: string;
   /**
@@ -50,6 +51,9 @@ export type HeliumPaywallEvent = {
    * Unix timestamp in seconds
    */
   timestamp?: number;
+  paywallUnavailableReason?: string;
+  customPaywallActionName?: string;
+  customPaywallActionParams?: Record<string, any>;
 };
 export type DelegateActionEvent = {
   type: 'purchase' | 'restore';
@@ -121,7 +125,10 @@ export type HeliumPaywallLoadingConfig = {
 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; // Still mandatory
@@ -168,6 +175,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
@@ -201,6 +210,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 const HELIUM_CTA_NAMES = {
   SCHEDULE_CALL: 'schedule_call',
   SUBSCRIBE_BUTTON: 'subscribe_button',

package/src/HeliumPaywallSdkModule.ts

@@ -1,5 +1,6 @@
 import { NativeModule, requireNativeModule } from "expo";
 
+import { ExperimentInfo } from "./HeliumExperimentInfo.types";
 import {
   HeliumDownloadStatus,
   HeliumPaywallSdkModuleEvents,
@@ -13,9 +14,8 @@ interface PaywallInfoResult {
   shouldShow?: boolean;
 }
 
-interface CanPresentUpsellResult {
-  canPresent?: boolean;
-  reason?: string;
+interface ExperimentInfoResult extends Partial<ExperimentInfo> {
+  getExperimentInfoErrorMsg?: string;
 }
 
 declare class HeliumPaywallSdkModule extends NativeModule<HeliumPaywallSdkModuleEvents> {
@@ -32,8 +32,6 @@ declare class HeliumPaywallSdkModule extends NativeModule<HeliumPaywallSdkModule
 
   getDownloadStatus(): HeliumDownloadStatus;
 
-  canPresentUpsell(trigger: string): CanPresentUpsellResult;
-
   fallbackOpenOrCloseEvent(
     trigger: string,
     isOpen: boolean,
@@ -56,6 +54,18 @@ declare class HeliumPaywallSdkModule extends NativeModule<HeliumPaywallSdkModule
   hasAnyActiveSubscription(): Promise<boolean>;
 
   hasAnyEntitlement(): Promise<boolean>;
+
+  resetHelium(): void;
+
+  setCustomRestoreFailedStrings(
+    customTitle?: string,
+    customMessage?: string,
+    customCloseButtonText?: string,
+  ): void;
+
+  disableRestoreFailedDialog(): void;
+
+  getExperimentInfoForTrigger(trigger: string): ExperimentInfoResult;
 }
 
 // This call loads the native module object from the JSI.

package/src/index.ts

@@ -4,6 +4,7 @@ import {
   HeliumPaywallEvent,
   NativeHeliumConfig, PaywallEventHandlers, PaywallInfo, PresentUpsellParams,
 } from "./HeliumPaywallSdk.types";
+import { ExperimentInfo } from "./HeliumExperimentInfo.types";
 import HeliumPaywallSdkModule from "./HeliumPaywallSdkModule";
 import { EventSubscription } from 'expo-modules-core';
 import * as ExpoFileSystem from 'expo-file-system';
@@ -11,6 +12,7 @@ import * as ExpoFileSystem from 'expo-file-system';
 export { default } from './HeliumPaywallSdkModule';
 // export { default as HeliumPaywallSdkView } from './HeliumPaywallSdkView';
 export * from  './HeliumPaywallSdk.types';
+export * from './HeliumExperimentInfo.types';
 
 function addHeliumPaywallEventListener(listener: (event: HeliumPaywallEvent) => void): EventSubscription {
   return HeliumPaywallSdkModule.addListener('onHeliumPaywallEvent', listener);
@@ -127,23 +129,12 @@ export const presentUpsell = ({
                                 eventHandlers,
                                 customPaywallTraits,
                               }: PresentUpsellParams) => {
-  const {canPresent, reason} = HeliumPaywallSdkModule.canPresentUpsell(triggerName);
-
-  if (!canPresent) {
-    console.log(
-      `[Helium] Cannot present trigger "${triggerName}". Reason: ${reason}`
-    );
-    onFallback?.();
-    HeliumPaywallSdkModule.fallbackOpenOrCloseEvent(triggerName, true, 'presented');
-    return;
-  }
-
   try {
     paywallEventHandlers = eventHandlers;
     presentOnFallback = onFallback;
     HeliumPaywallSdkModule.presentUpsell(triggerName, convertBooleansToMarkers(customPaywallTraits));
   } catch (error) {
-    console.log('Helium present error', error);
+    console.log('[Helium] presentUpsell error', error);
     paywallEventHandlers = undefined;
     presentOnFallback = undefined;
     onFallback?.();
@@ -188,6 +179,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;
     }
   }
 }
@@ -206,7 +217,13 @@ 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;
   }
@@ -227,6 +244,46 @@ export const hasAnyActiveSubscription = HeliumPaywallSdkModule.hasAnyActiveSubsc
  */
 export const hasAnyEntitlement = HeliumPaywallSdkModule.hasAnyEntitlement;
 
+/**
+ * Reset Helium entirely so you can call initialize again. Only for advanced use cases.
+ */
+export const resetHelium = HeliumPaywallSdkModule.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 = HeliumPaywallSdkModule.setCustomRestoreFailedStrings;
+
+/**
+ * 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 = HeliumPaywallSdkModule.disableRestoreFailedDialog;
+
+/**
+ * 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 = (trigger: string): ExperimentInfo | undefined => {
+  const result = HeliumPaywallSdkModule.getExperimentInfoForTrigger(trigger);
+  if (!result) {
+    console.log('[Helium] getExperimentInfoForTrigger unexpected error.');
+    return;
+  }
+  if (result.getExperimentInfoErrorMsg) {
+    return;
+  }
+  // Validate required field exists before casting
+  if (!result.trigger) {
+    console.log('[Helium] getExperimentInfoForTrigger returned data without required trigger field.');
+    return;
+  }
+  return result as ExperimentInfo;
+};
+
 export const getPaywallInfo = (trigger: string): PaywallInfo | undefined => {
   const result = HeliumPaywallSdkModule.getPaywallInfo(trigger);
   if (!result) {