react-native-hubspot-wrapper 0.4.0 → 0.4.1

package/README.md

@@ -12,7 +12,7 @@ Early release (`0.x`). The public API may evolve before `1.0`.
 Currently supported:
 
 - `initialize()`
-- `openChat(chatflow)`
+- `openChat(chatflow, options?)`
 - `setIdentity({ identityToken, email? })`
 - `setProperties(properties)`
 - `clearUserData()`
@@ -61,14 +61,39 @@ await HubspotWrapper.setProperties([{ name: 'plan', value: 'pro' }]);
 await HubspotWrapper.openChat('support');
 ```
 
+By default, `openChat` hides HubSpot's "back to inbox" / conversations-list
+button inside the chat widget. This wrapper is opinionated toward single-chat
+support flows, but you can preserve HubSpot's stock UI per chat:
+
+```ts
+await HubspotWrapper.openChat('support', {
+  hideBackToInboxButton: false,
+});
+```
+
 ## API
 
 - `initialize(): Promise<void>`
-- `openChat(chatflow: string): Promise<void>`
+- `openChat(chatflow: string, options?: { hideBackToInboxButton?: boolean }): Promise<void>`
 - `setIdentity({ identityToken, email? }): Promise<void>`
 - `setProperties(properties): Promise<void>`
 - `clearUserData(): Promise<void>`
 
+### `openChat(chatflow, options?)`
+
+Opens the HubSpot chat UI for the provided chatflow.
+
+- `hideBackToInboxButton` defaults to `true`.
+- Set `hideBackToInboxButton: false` to keep HubSpot's default conversations
+  navigation visible.
+
+### `clearUserData()`
+
+Clears the native SDK's current user/session state and waits for HubSpot chat
+visitor cookies/data cleanup to finish before resolving. This is intended for
+logout or account-switch flows so the next chat session does not reuse the
+previous visitor identity.
+
 ## iOS SDK source strategy
 
 This package vendors HubSpot iOS SDK source files under `ios/HubspotMobileSDK`.

package/android/src/main/java/com/reactnativehubspotwrapper/HubspotBackButtonHider.kt

@@ -9,6 +9,7 @@ import android.util.Log
 import android.view.View
 import android.view.ViewGroup
 import android.webkit.WebView
+import java.util.WeakHashMap
 
 /**
  * Hides the HubSpot chat widget's "back to inbox" / conversations-list navigation
@@ -38,6 +39,9 @@ import android.webkit.WebView
 internal object HubspotBackButtonHider {
   private const val TAG = "HubspotWrapper"
 
+  const val EXTRA_HIDE_BACK_TO_INBOX_BUTTON =
+    "com.marcinolek.reactnativehubspotwrapper.HIDE_BACK_TO_INBOX_BUTTON"
+
   /**
    * The fully-qualified name of HubSpot's chat activity in the AAR. Matched by
    * string so we don't have to import / depend on it for compile-time resolution.
@@ -57,6 +61,9 @@ internal object HubspotBackButtonHider {
   @Volatile
   private var installed = false
 
+  private val handler = Handler(Looper.getMainLooper())
+  private val scheduledInjections = WeakHashMap<WebView, Runnable>()
+
   @Synchronized
   fun installOnce(app: Application) {
     if (installed) return
@@ -65,6 +72,10 @@ internal object HubspotBackButtonHider {
     app.registerActivityLifecycleCallbacks(object : Application.ActivityLifecycleCallbacks {
       override fun onActivityResumed(activity: Activity) {
         if (activity.javaClass.name != WEB_ACTIVITY_NAME) return
+        if (!activity.intent.getBooleanExtra(EXTRA_HIDE_BACK_TO_INBOX_BUTTON, true)) {
+          cancelHiderInjection(findWebView(activity.window.decorView))
+          return
+        }
         val webView = findWebView(activity.window.decorView)
         if (webView == null) {
           Log.w(TAG, "installBackButtonHider: WebView not found in $WEB_ACTIVITY_NAME view tree")
@@ -76,10 +87,18 @@ internal object HubspotBackButtonHider {
 
       override fun onActivityCreated(activity: Activity, savedInstanceState: Bundle?) {}
       override fun onActivityStarted(activity: Activity) {}
-      override fun onActivityPaused(activity: Activity) {}
+      override fun onActivityPaused(activity: Activity) {
+        if (activity.javaClass.name == WEB_ACTIVITY_NAME) {
+          cancelHiderInjection(findWebView(activity.window.decorView))
+        }
+      }
       override fun onActivityStopped(activity: Activity) {}
       override fun onActivitySaveInstanceState(activity: Activity, outState: Bundle) {}
-      override fun onActivityDestroyed(activity: Activity) {}
+      override fun onActivityDestroyed(activity: Activity) {
+        if (activity.javaClass.name == WEB_ACTIVITY_NAME) {
+          cancelHiderInjection(findWebView(activity.window.decorView))
+        }
+      }
     })
   }
 
@@ -95,7 +114,8 @@ internal object HubspotBackButtonHider {
   }
 
   private fun scheduleHiderInjection(webView: WebView) {
-    val handler = Handler(Looper.getMainLooper())
+    cancelHiderInjection(webView)
+
     val start = System.currentTimeMillis()
     val runnable = object : Runnable {
       override fun run() {
@@ -106,12 +126,21 @@ internal object HubspotBackButtonHider {
         }
         if (System.currentTimeMillis() - start < MAX_SCAN_DURATION_MS) {
           handler.postDelayed(this, RESCAN_INTERVAL_MS)
+        } else {
+          scheduledInjections.remove(webView)
         }
       }
     }
+    scheduledInjections[webView] = runnable
     handler.post(runnable)
   }
 
+  private fun cancelHiderInjection(webView: WebView?) {
+    if (webView == null) return
+    val runnable = scheduledInjections.remove(webView) ?: return
+    handler.removeCallbacks(runnable)
+  }
+
   /**
    * Heuristic-based hider for the chat widget's back/inbox button. Identical in
    * shape to the iOS version in `HubspotWrapperImpl.swift`. Designed to be safe

package/android/src/main/java/com/reactnativehubspotwrapper/HubspotWrapperModule.kt

@@ -42,11 +42,12 @@ class HubspotWrapperModule(reactContext: ReactApplicationContext) :
     }
   }
 
-  override fun openChat(chatflow: String, promise: Promise) {
+  override fun openChat(chatflow: String, hideBackToInboxButton: Boolean, promise: Promise) {
     try {
       val intent = Intent(appContext, HubspotWebActivity::class.java)
       intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
       intent.putExtra("chatflow", chatflow)
+      intent.putExtra(HubspotBackButtonHider.EXTRA_HIDE_BACK_TO_INBOX_BUTTON, hideBackToInboxButton)
       appContext.startActivity(intent)
       promise.resolve(null)
     } catch (error: Exception) {

package/ios/HubspotWrapperImpl.swift

@@ -5,6 +5,8 @@ import WebKit
 
 @objcMembers
 public class HubspotWrapperImpl: NSObject {
+  private static var shouldHideBackToInboxButton = true
+
   /// Substrings used to match `WKWebsiteDataRecord.displayName` (which is the host /
   /// eTLD+1, e.g. `hubspot.com`, `hs-banner.com`, `hsadspixel.net`) for the various
   /// domains the chat widget loads from. Anything matching is wiped on `clearUserData`.
@@ -46,7 +48,7 @@ public class HubspotWrapperImpl: NSObject {
     return true
   }
 
-  public func openChat(_ chatflow: String, error outError: NSErrorPointer) -> Bool {
+  public func openChat(_ chatflow: String, hideBackToInboxButton: Bool, error outError: NSErrorPointer) -> Bool {
     var didSucceed = false
     let presentBlock = {
       guard let rootVC = Self.topViewController() else {
@@ -58,6 +60,7 @@ public class HubspotWrapperImpl: NSObject {
         return
       }
 
+      Self.shouldHideBackToInboxButton = hideBackToInboxButton
       let chatView = HubspotChatView(chatFlow: chatflow)
       let hostingController = UIHostingController(rootView: chatView)
       rootVC.present(hostingController, animated: true)
@@ -164,6 +167,8 @@ public class HubspotWrapperImpl: NSObject {
   /// and visible text. Re-scans periodically for the first few seconds to cover
   /// late-mounted shadow roots. Injected at document start in every frame.
   @objc public static func installBackButtonHider(on controller: WKUserContentController) {
+    guard shouldHideBackToInboxButton else { return }
+
     let script = WKUserScript(
       source: backButtonHiderJS,
       injectionTime: .atDocumentStart,

package/ios/RNHubspotWrapper.mm

@@ -34,10 +34,10 @@ RCT_EXPORT_MODULE(NativeHubspotWrapper)
   reject(@"INIT_ERROR", @"Failed to initialize HubSpot SDK", error);
 }
 
-- (void)openChat:(NSString *)chatflow resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject
+- (void)openChat:(NSString *)chatflow hideBackToInboxButton:(BOOL)hideBackToInboxButton resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject
 {
   NSError *error = nil;
-  BOOL didOpen = [_impl openChat:chatflow error:&error];
+  BOOL didOpen = [_impl openChat:chatflow hideBackToInboxButton:hideBackToInboxButton error:&error];
   if (didOpen) {
     resolve(nil);
     return;

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "react-native-hubspot-wrapper",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "TurboModule wrapper for HubSpot mobile chat SDK",
   "main": "src/index.ts",
   "types": "src/index.ts",
   "files": [
     "src",
-    "android",
+    "android/build.gradle",
+    "android/src",
     "ios",
     "ReactNativeHubspotWrapper.podspec",
     "react-native.config.js",

package/src/index.ts

@@ -7,6 +7,10 @@ export type SetIdentityParams = {
   email?: string | null;
 };
 
+export type OpenChatOptions = {
+  hideBackToInboxButton?: boolean;
+};
+
 function ensureNonEmpty(value: string, fieldName: string): void {
   if (!value || !value.trim()) {
     throw new Error(`\`${fieldName}\` must be a non-empty string.`);
@@ -18,9 +22,9 @@ const HubspotWrapper = {
     return NativeHubspotWrapper.initialize();
   },
 
-  openChat(chatflow: string): Promise<void> {
+  openChat(chatflow: string, options: OpenChatOptions = {}): Promise<void> {
     ensureNonEmpty(chatflow, 'chatflow');
-    return NativeHubspotWrapper.openChat(chatflow);
+    return NativeHubspotWrapper.openChat(chatflow, options.hideBackToInboxButton ?? true);
   },
 
   setIdentity(params: SetIdentityParams): Promise<void> {

package/src/specs/NativeHubspotWrapper.ts

@@ -8,7 +8,7 @@ export type HubspotProperty = {
 
 export interface Spec extends TurboModule {
   initialize(): Promise<void>;
-  openChat(chatflow: string): Promise<void>;
+  openChat(chatflow: string, hideBackToInboxButton: boolean): Promise<void>;
   setIdentity(identityToken: string, email: string | null): Promise<void>;
   setProperties(properties: ReadonlyArray<HubspotProperty>): Promise<void>;
   clearUserData(): Promise<void>;

package/android/.gradle/buildOutputCleanup/cache.properties

@@ -1,2 +0,0 @@
-#Tue Apr 28 11:02:36 CEST 2026
-gradle.version=8.13