react-native-hubspot-wrapper 0.1.0

package/ios/HubspotWrapperImpl.swift

@@ -0,0 +1,108 @@
+import Foundation
+import SwiftUI
+import UIKit
+
+@objcMembers
+public class HubspotWrapperImpl: NSObject {
+  public func initialize(_ outError: NSErrorPointer) -> Bool {
+    let semaphore = DispatchSemaphore(value: 0)
+    var configureError: NSError?
+
+    Task { @MainActor in
+      do {
+        try HubspotManager.configure()
+      } catch let error {
+        configureError = error as NSError
+      }
+      semaphore.signal()
+    }
+
+    semaphore.wait()
+
+    if let configureError {
+      outError?.pointee = configureError
+      return false
+    }
+    return true
+  }
+
+  public func openChat(_ chatflow: String, error outError: NSErrorPointer) -> Bool {
+    var didSucceed = false
+    let presentBlock = {
+      guard let rootVC = Self.topViewController() else {
+        outError?.pointee = NSError(
+          domain: "HubspotWrapper",
+          code: 1,
+          userInfo: [NSLocalizedDescriptionKey: "No root view controller available"]
+        )
+        return
+      }
+
+      let chatView = HubspotChatView(chatFlow: chatflow)
+      let hostingController = UIHostingController(rootView: chatView)
+      rootVC.present(hostingController, animated: true)
+      didSucceed = true
+    }
+
+    if Thread.isMainThread {
+      presentBlock()
+    } else {
+      DispatchQueue.main.sync(execute: presentBlock)
+    }
+
+    return didSucceed
+  }
+
+  public func setIdentity(_ identityToken: String, email: String?) {
+    let semaphore = DispatchSemaphore(value: 0)
+    Task { @MainActor in
+      HubspotManager.shared.setUserIdentity(identityToken: identityToken, email: email ?? "")
+      semaphore.signal()
+    }
+    semaphore.wait()
+  }
+
+  public func setProperties(_ properties: [NSDictionary]) {
+    var mapped: [String: String] = [:]
+
+    for item in properties {
+      guard
+        let name = item["name"] as? String,
+        let value = item["value"] as? String
+      else {
+        continue
+      }
+      mapped[name] = value
+    }
+
+    Task {
+      await HubspotManager.shared.setChatProperties(data: mapped)
+    }
+  }
+
+  public func clearUserData() {
+    Task {
+      await HubspotManager.shared.clearUserData()
+    }
+  }
+
+  private static func topViewController(
+    base: UIViewController? = UIApplication.shared.connectedScenes
+      .compactMap { $0 as? UIWindowScene }
+      .flatMap { $0.windows }
+      .first(where: \.isKeyWindow)?
+      .rootViewController
+  ) -> UIViewController? {
+    if let navigationController = base as? UINavigationController {
+      return topViewController(base: navigationController.visibleViewController)
+    }
+    if let tabBarController = base as? UITabBarController,
+       let selected = tabBarController.selectedViewController {
+      return topViewController(base: selected)
+    }
+    if let presented = base?.presentedViewController {
+      return topViewController(base: presented)
+    }
+    return base
+  }
+}

package/ios/RNHubspotWrapper.h

@@ -0,0 +1,9 @@
+#import <Foundation/Foundation.h>
+#import <HubspotWrapperSpec/HubspotWrapperSpec.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface RNHubspotWrapper : NSObject <NativeHubspotWrapperSpec>
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/RNHubspotWrapper.mm

@@ -0,0 +1,66 @@
+#import "RNHubspotWrapper.h"
+#import <UserNotifications/UserNotifications.h>
+#import "ReactNativeHubspotWrapper-Swift.h"
+
+@implementation RNHubspotWrapper {
+  HubspotWrapperImpl *_impl;
+}
+
+RCT_EXPORT_MODULE(NativeHubspotWrapper)
+
+- (instancetype)init
+{
+  self = [super init];
+  if (self) {
+    _impl = [HubspotWrapperImpl new];
+  }
+  return self;
+}
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params
+{
+  return std::make_shared<facebook::react::NativeHubspotWrapperSpecJSI>(params);
+}
+
+- (void)initialize:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject
+{
+  NSError *error = nil;
+  BOOL didInitialize = [_impl initialize:&error];
+  if (didInitialize) {
+    resolve(nil);
+    return;
+  }
+  reject(@"INIT_ERROR", @"Failed to initialize HubSpot SDK", error);
+}
+
+- (void)openChat:(NSString *)chatflow resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject
+{
+  NSError *error = nil;
+  BOOL didOpen = [_impl openChat:chatflow error:&error];
+  if (didOpen) {
+    resolve(nil);
+    return;
+  }
+  reject(@"OPEN_CHAT_ERROR", @"Failed to open HubSpot chat", error);
+}
+
+- (void)setIdentity:(NSString *)identityToken email:(NSString * _Nullable)email resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject
+{
+  [_impl setIdentity:identityToken email:email];
+  resolve(nil);
+}
+
+- (void)setProperties:(NSArray<NSDictionary *> *)properties resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject
+{
+  [_impl setProperties:properties];
+  resolve(nil);
+}
+
+- (void)clearUserData:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject
+{
+  [_impl clearUserData];
+  resolve(nil);
+}
+
+@end

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "react-native-hubspot-wrapper",
+  "version": "0.1.0",
+  "description": "TurboModule wrapper for HubSpot mobile chat SDK",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "files": [
+    "src",
+    "android",
+    "ios",
+    "ReactNativeHubspotWrapper.podspec",
+    "react-native.config.js",
+    "README.md",
+    "MIGRATION.md",
+    "HUBSPOT_IOS_SDK_VERSION.json",
+    "scripts",
+    "LICENSE"
+  ],
+  "keywords": [
+    "react-native",
+    "hubspot",
+    "chat",
+    "turbomodule"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/marcinolek/react-native-hubspot-wrapper.git"
+  },
+  "author": "Marcin Olek",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "update:hubspot:ios": "bash ./scripts/update-hubspot-ios-sdk.sh"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": ">=0.81.0"
+  },
+  "codegenConfig": {
+    "name": "HubspotWrapperSpec",
+    "type": "modules",
+    "jsSrcsDir": "src/specs",
+    "android": {
+      "javaPackageName": "com.marcinolek.reactnativehubspotwrapper"
+    },
+    "ios": {
+      "modulesProvider": {
+        "NativeHubspotWrapper": "RNHubspotWrapper"
+      }
+    }
+  },
+  "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
+}

package/react-native.config.js

@@ -0,0 +1,11 @@
+module.exports = {
+  dependency: {
+    platforms: {
+      android: {
+        packageImportPath:
+          'import com.marcinolek.reactnativehubspotwrapper.HubspotWrapperPackage;',
+        packageInstance: 'new HubspotWrapperPackage()'
+      }
+    }
+  }
+};

package/scripts/update-hubspot-ios-sdk.sh

@@ -0,0 +1,142 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+REPO_URL="https://github.com/HubSpot/mobile-chat-sdk-ios.git"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
+TARGET_DIR="${ROOT_DIR}/ios/HubspotMobileSDK"
+VERSION_FILE="${ROOT_DIR}/HUBSPOT_IOS_SDK_VERSION.json"
+
+resolve_latest_tag() {
+  git ls-remote --tags --refs "${REPO_URL}" \
+    | awk -F'/' '{print $3}' \
+    | sort -V \
+    | tail -n 1
+}
+
+apply_cocoapods_compat_patches() {
+  python3 - "${TARGET_DIR}" <<'PY'
+from pathlib import Path
+import sys
+
+target_dir = Path(sys.argv[1])
+
+def replace_once(path: Path, old: str, new: str) -> None:
+    content = path.read_text()
+    if old not in content:
+        raise RuntimeError(f"Expected snippet not found in {path}")
+    path.write_text(content.replace(old, new, 1))
+
+# 1) Replace SPM-only asset symbol usage in FloatingActionButton.
+replace_once(
+    target_dir / "Views/Buttons/FloatingActionButton.swift",
+    "Image(.genericChatIcon)",
+    "Image.hubspotChat",
+)
+
+# 2) Replace SPM-only asset/localization usage in TextChatButton.
+replace_once(
+    target_dir / "Views/Buttons/TextChatButtonChatButton.swift",
+    "Image(.genericChatIcon)",
+    "Image.hubspotChat",
+)
+replace_once(
+    target_dir / "Views/Buttons/TextChatButtonChatButton.swift",
+    'Text("chat.label", bundle: .module)',
+    'Text("chat.label", bundle: .hubspotResources)',
+)
+
+# 3) Add Bundle helper + shared image helper in HubspotManager.
+hubspot_manager = target_dir / "HubspotManager.swift"
+content = hubspot_manager.read_text()
+old_block = """extension Image {
+    /// Exporting chat icon - initially for demo use - but maybe sharing some resources that aren't buttons or views might be needed eventually, if so refactor this
+    public static var hubspotChat: Image {
+        Image(.genericChatIcon)
+    }
+}
+"""
+new_block = """extension Image {
+    /// Exporting chat icon - initially for demo use - but maybe sharing some resources that aren't buttons or views might be needed eventually, if so refactor this
+    public static var hubspotChat: Image {
+        Image("GenericChatIcon", bundle: .hubspotResources)
+    }
+}
+
+extension Bundle {
+    static var hubspotResources: Bundle? {
+        // CocoaPods bundles resources into a separate bundle, unlike Swift Package's `Bundle.module`.
+        Bundle.main.url(forResource: "HubspotMobileSDKResources", withExtension: "bundle")
+            .flatMap { Bundle(url: $0) }
+    }
+}
+"""
+if old_block not in content:
+    raise RuntimeError("Expected Image extension block was not found in HubspotManager.swift")
+hubspot_manager.write_text(content.replace(old_block, new_block, 1))
+PY
+}
+
+TAG="${1:-}"
+if [[ -z "${TAG}" ]]; then
+  TAG="$(resolve_latest_tag)"
+  if [[ -z "${TAG}" ]]; then
+    echo "Could not determine latest tag from ${REPO_URL}" >&2
+    exit 1
+  fi
+fi
+
+TMP_DIR="$(mktemp -d)"
+cleanup() {
+  rm -rf "${TMP_DIR}"
+}
+trap cleanup EXIT
+
+echo "Cloning ${REPO_URL} at tag ${TAG}..."
+git clone --depth 1 --branch "${TAG}" "${REPO_URL}" "${TMP_DIR}/upstream"
+
+if [[ ! -d "${TMP_DIR}/upstream/Sources/HubspotMobileSDK" ]]; then
+  echo "Expected Sources/HubspotMobileSDK was not found in tag ${TAG}" >&2
+  exit 1
+fi
+
+echo "Updating vendored iOS SDK sources..."
+rm -rf "${TARGET_DIR}"
+mkdir -p "$(dirname "${TARGET_DIR}")"
+cp -R "${TMP_DIR}/upstream/Sources/HubspotMobileSDK" "${TARGET_DIR}"
+
+# Drop upstream Xcode documentation bundle: ~800KB of PNGs and markdown files
+# that the podspec does not pick up and that aren't needed by consumers.
+rm -rf "${TARGET_DIR}/Documentation.docc"
+
+# MIT requires distributing the upstream license alongside the vendored sources.
+UPSTREAM_LICENSE=""
+for candidate in LICENSE.txt LICENSE LICENSE.md; do
+  if [[ -f "${TMP_DIR}/upstream/${candidate}" ]]; then
+    UPSTREAM_LICENSE="${TMP_DIR}/upstream/${candidate}"
+    break
+  fi
+done
+if [[ -z "${UPSTREAM_LICENSE}" ]]; then
+  echo "Could not find an upstream LICENSE file at tag ${TAG}" >&2
+  exit 1
+fi
+cp "${UPSTREAM_LICENSE}" "${TARGET_DIR}/LICENSE.txt"
+
+echo "Applying CocoaPods compatibility patches..."
+apply_cocoapods_compat_patches
+
+UPSTREAM_COMMIT="$(git -C "${TMP_DIR}/upstream" rev-parse HEAD)"
+
+cat > "${VERSION_FILE}" <<EOF
+{
+  "sourceRepository": "${REPO_URL}",
+  "tag": "${TAG}",
+  "commit": "${UPSTREAM_COMMIT}"
+}
+EOF
+
+echo "Updated:"
+echo "  - ${TARGET_DIR}"
+echo "  - ${VERSION_FILE}"

package/src/index.ts

@@ -0,0 +1,41 @@
+import NativeHubspotWrapper, { HubspotProperty } from './specs/NativeHubspotWrapper';
+
+export type { HubspotProperty };
+
+export type SetIdentityParams = {
+  identityToken: string;
+  email?: string | null;
+};
+
+function ensureNonEmpty(value: string, fieldName: string): void {
+  if (!value || !value.trim()) {
+    throw new Error(`\`${fieldName}\` must be a non-empty string.`);
+  }
+}
+
+const HubspotWrapper = {
+  initialize(): Promise<void> {
+    return NativeHubspotWrapper.initialize();
+  },
+
+  openChat(chatflow: string): Promise<void> {
+    ensureNonEmpty(chatflow, 'chatflow');
+    return NativeHubspotWrapper.openChat(chatflow);
+  },
+
+  setIdentity(params: SetIdentityParams): Promise<void> {
+    ensureNonEmpty(params.identityToken, 'identityToken');
+    const email = params.email?.trim() || null;
+    return NativeHubspotWrapper.setIdentity(params.identityToken, email);
+  },
+
+  setProperties(properties: HubspotProperty[]): Promise<void> {
+    return NativeHubspotWrapper.setProperties(properties);
+  },
+
+  clearUserData(): Promise<void> {
+    return NativeHubspotWrapper.clearUserData();
+  }
+};
+
+export default HubspotWrapper;

package/src/specs/NativeHubspotWrapper.ts

@@ -0,0 +1,17 @@
+import type { TurboModule } from 'react-native';
+import { TurboModuleRegistry } from 'react-native';
+
+export type HubspotProperty = {
+  name: string;
+  value: string;
+};
+
+export interface Spec extends TurboModule {
+  initialize(): Promise<void>;
+  openChat(chatflow: string): Promise<void>;
+  setIdentity(identityToken: string, email: string | null): Promise<void>;
+  setProperties(properties: ReadonlyArray<HubspotProperty>): Promise<void>;
+  clearUserData(): Promise<void>;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>('NativeHubspotWrapper');