@flybits/react-native-concierge 0.0.0 → 0.1.8

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2024 Flybits
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+![Flybits-Header-Rect-Native-SDK](https://github.com/user-attachments/assets/a50b7d37-1376-4634-ae00-9024d5aca6ce)
+# react-native-concierge
+A React Native wrapper for the Flybits Concierge solution that brings personalized UI and Content into your React Native applications. 
+
+## Quickstart
+
+Here is the bare minimum code required to quickly integrate Concierge to your React Native application.
+
+More information can be referenced at [React Native Concierge SDK](https://flybits.gitbook.io/customer-documentation)
+
+1. Install
+```sh
+npm install react-native-concierge --save
+```
+2. Configure
+```javascript
+import {
+  configure,
+} from '@flybits/react-native-concierge';
+
+configure({
+  projectId: '<your project ID>',
+  gateway: 'https://api.$REGION.flybits.com',
+  webService: 'https://static-files-concierge.$REGION.flybits.com/latest',
+  pushNetwork: 'fcm', // 'fcm' | 'apns' | 'huawei'
+  locationPlugin: true,
+  logLevel: 'debug',
+  locales: JSON.stringify(['en-ca', 'en']),
+});
+```
+3. Authenticate
+```javascript
+import {
+  connect,
+} from '@flybits/react-native-concierge';
+
+const resultJson = JSON.parse(await connect());
+if (resultJson.success) {
+  console.log(`Connected: ${resultJson.result}`);
+} else {
+  console.log(`Error: ${resultJson.message}`);
+}
+```
+4. Display
+```javascript
+import {
+  Concierge,
+  ConciergeAction,
+} from '@flybits/react-native-concierge';
+
+
+export const ConciergeScreen = () => {
+  ...
+  return (
+    <>
+      <Concierge
+        actionlink={
+          {
+            action: 'concierge',
+            params: { zoneReferenceId: 'default_zone' },
+          } as ConciergeAction
+        }
+      />
+    </>
+  );
+}
+```
+
+## License
+
+MIT
+
+---
+
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

package/android/build.gradle

@@ -0,0 +1,102 @@
+println('android/build.gradle invoked.')
+buildscript {
+  // Buildscript is evaluated before everything else so we can't use getExtOrDefault
+  def kotlin_version = rootProject.ext.has("kotlinVersion") ? rootProject.ext.get("kotlinVersion") :
+    project.properties["Concierge_kotlinVersion"]
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:7.2.1"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
+  }
+}
+
+def reactNativeArchitectures() {
+  def value = rootProject.getProperties().get("reactNativeArchitectures")
+  return value ? value.split(",") : ["armeabi-v7a", "x86", "x86_64", "arm64-v8a"]
+}
+
+def isNewArchitectureEnabled() {
+  return rootProject.hasProperty("newArchEnabled") && rootProject.getProperty("newArchEnabled") == "true"
+}
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+if (isNewArchitectureEnabled()) {
+  apply plugin: "com.facebook.react"
+}
+
+def getExtOrDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties["Concierge_" + name]
+}
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["Concierge_" + name]).toInteger()
+}
+
+def supportsNamespace() {
+  def parsed = com.android.Version.ANDROID_GRADLE_PLUGIN_VERSION.tokenize('.')
+  def major = parsed[0].toInteger()
+  def minor = parsed[1].toInteger()
+
+  // Namespace support was added in 7.3.0
+  return (major == 7 && minor >= 3) || major >= 8
+}
+
+android {
+  if (supportsNamespace()) {
+    namespace "com.concierge"
+
+    sourceSets {
+      main {
+        manifest.srcFile "src/main/AndroidManifestNew.xml"
+      }
+    }
+  }
+
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+     minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+     targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+
+dependencies {
+  // For < 0.71, this will be from the local maven repo
+  // For > 0.71, this will be replaced by `com.facebook.react:react-android:$version` by react gradle plugin
+  //noinspection GradleDynamicVersion
+  implementation "com.facebook.react:react-native:+"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+
+  api "com.flybits.android:concierge:5.1.5"
+}
+

package/android/gradle.properties

@@ -0,0 +1,5 @@
+Concierge_kotlinVersion=1.7.0
+Concierge_minSdkVersion=24
+Concierge_targetSdkVersion=34
+Concierge_compileSdkVersion=34
+Concierge_ndkversion=21.4.7075529

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,3 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+          package="com.concierge">
+</manifest>

package/android/src/main/AndroidManifestNew.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/com/concierge/AuthModule.kt

@@ -0,0 +1,104 @@
+import android.content.Context
+import android.util.Log
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.modules.core.DeviceEventManagerModule
+import com.flybits.commons.library.api.FlybitsManager
+import com.flybits.commons.library.api.FlybitsScope
+import com.flybits.commons.library.api.ScopeAuthState
+import com.flybits.commons.library.models.User
+import org.json.JSONObject
+
+const val TAG_AUTH_MODULE = "AuthModule"
+
+class AuthModule internal constructor(private val reactContext: ReactApplicationContext) : ReactContextBaseJavaModule(reactContext) {
+  override fun getName(): String {
+    return "Auth"
+  }
+
+  private val authModuleScope = AuthModuleScope()
+
+  private var listenerCount = 0
+
+  internal fun sendEvent(reactContext: ReactContext, eventName: String, params: WritableMap?) {
+    reactContext
+      .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+      .emit(eventName, params)
+  }
+
+  @ReactMethod
+  fun addListener(eventName: String) {
+    if (listenerCount == 0) {
+      FlybitsManager.addScope(authModuleScope, reactContext)
+    }
+
+    listenerCount += 1
+  }
+
+  @ReactMethod
+  fun removeListeners(count: Int) {
+    listenerCount -= count
+    if (listenerCount == 0) {
+      FlybitsManager.removeScope(authModuleScope)
+    }
+  }
+
+  private inner class AuthModuleScope: FlybitsScope("ConciergeViewManagerScope") {
+    override fun onConnected(context: Context, user: User) {
+      val params = Arguments.createMap().apply {
+        val body = Arguments.createMap()
+        body.putString("authState", scopeAuthStateAsString(ScopeAuthState.CONNECTED_OPT_IN))
+        putMap("body", body)
+      }
+      sendEvent(reactContext = reactContext, eventName = "Authentication-onStart", params = params)
+    }
+
+    override fun onConnecting() {
+    }
+
+
+    override fun onDisconnected(context: Context) {
+      val params = Arguments.createMap().apply {
+        val body =Arguments.createMap()
+        body.putString("authState", scopeAuthStateAsString(ScopeAuthState.DISCONNECTED))
+        putMap("body", body)
+      }
+      sendEvent(reactContext = reactContext, eventName = "Authentication-onStart", params = params)
+    }
+
+    override fun onFailedToConnect() {
+      // No-op
+    }
+
+    override fun onOptedStateChange(context: Context, optedState: Boolean) {
+      // No-op
+    }
+
+    override fun onStart(authState: ScopeAuthState) {
+      val params = Arguments.createMap().apply {
+        val body =Arguments.createMap()
+        body.putString("authState", scopeAuthStateAsString(authState))
+        putMap("body", body)
+      }
+      sendEvent(reactContext = reactContext, eventName = "Authentication-onStart", params = params)
+    }
+
+    override fun onStop() {
+      // No-op
+    }
+
+    private fun scopeAuthStateAsString(authState: ScopeAuthState) : String {
+      return when(authState) {
+        ScopeAuthState.DISCONNECTED -> "disconnected"
+        ScopeAuthState.CONNECTED_OPT_IN -> "connected"
+        ScopeAuthState.CONNECTED_OPT_OUT -> "connectedOptOut"
+        ScopeAuthState.CONNECTING -> "connecting"
+        ScopeAuthState.INITIATED -> "initiated"
+      }
+    }
+  }
+}

package/android/src/main/java/com/concierge/ConciergePackage.kt

@@ -0,0 +1,19 @@
+package com.concierge
+
+import AuthModule
+import android.util.Log
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.ViewManager
+
+const val TAG_CONCIERGE_PACKAGE = "ConciergePackage"
+class ConciergePackage : ReactPackage {
+  override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
+    return listOf(FlybitsModule(reactContext), AuthModule(reactContext))
+  }
+
+  override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
+    return listOf(ConciergeViewManager(reactContext))
+  }
+}

package/android/src/main/java/com/concierge/ConciergeViewManager.kt

@@ -0,0 +1,280 @@
+package com.concierge
+
+import android.annotation.SuppressLint
+import android.content.BroadcastReceiver
+import android.content.Context
+import android.content.Intent
+import android.content.IntentFilter
+import android.net.Uri
+import android.os.Build
+import android.view.Choreographer
+import android.view.View
+import android.view.ViewGroup
+import android.widget.FrameLayout
+import androidx.core.content.ContextCompat
+import androidx.fragment.app.Fragment
+import androidx.fragment.app.FragmentActivity
+import androidx.localbroadcastmanager.content.LocalBroadcastManager
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.LifecycleEventListener
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReadableArray
+import com.facebook.react.bridge.ReadableMap
+import com.facebook.react.modules.core.DeviceEventManagerModule
+import com.facebook.react.uimanager.ThemedReactContext
+import com.facebook.react.uimanager.ViewGroupManager
+import com.facebook.react.uimanager.annotations.ReactProp
+import com.flybits.concierge.Concierge
+import com.flybits.concierge.ConciergeConstants
+import com.flybits.concierge.ConciergeConstants.BROADCAST_CONCIERGE_EVENT
+import com.flybits.concierge.ConciergeConstants.CONCIERGE_IDENTIFIER
+import com.flybits.concierge.enums.ConciergeParams
+import com.flybits.concierge.enums.Container
+
+const val TAG_CONCIERGE_VIEW_MANAGER = "ConciergeViewManager"
+
+class ConciergeViewManager(private val reactContext: ReactApplicationContext)
+  : ViewGroupManager<FrameLayout>(),
+    LifecycleEventListener {
+  private var propWidth: Int? = null
+  private var propHeight: Int? = null
+  private var broadcastReceiver: BroadcastReceiver? = null
+  private var actionLink: ActionLink? = null
+
+  companion object {
+    private const val REACT_CLASS = "ConciergeView"
+    private const val COMMAND_CREATE = 1
+  }
+
+  override fun getName() = REACT_CLASS
+
+  override fun createViewInstance(reactContext: ThemedReactContext): FrameLayout {
+    reactContext.reactApplicationContext.addLifecycleEventListener(this)
+    return FrameLayout(reactContext)
+  }
+
+  override fun getCommandsMap(): Map<String, Int> {
+    return mapOf("create" to COMMAND_CREATE)
+  }
+
+  override fun receiveCommand(
+    root: FrameLayout,
+    commandId: String,
+    args: ReadableArray?
+  ) {
+    super.receiveCommand(root, commandId, args)
+    val reactNativeViewId = requireNotNull(args).getInt(0)
+    val style = args.getMap(1)
+    val action = args.getMap(2)
+    when (commandId.toInt()) {
+      COMMAND_CREATE -> createFragment(root, reactNativeViewId)
+    }
+  }
+
+  private fun createFragment(root: FrameLayout, reactNativeViewId: Int) {
+    val parentView = root.findViewById<ViewGroup>(reactNativeViewId)
+    setupLayout(parentView)
+
+    var conciergeFragment: Fragment? =
+      if (actionLink != null && actionLink!!.actionableLink != null) {
+        actionLink!!.actionableLink?.let {
+          Concierge.handleActionableLink(context = reactContext, actionableLink = it,
+            conciergeTheme = null,
+            requestEvents = ConciergeParams.RequestEvents(), conciergeOptions = arrayListOf())
+        }
+      } else {
+        Concierge.fragment(
+          reactContext,
+          Container.Configured,
+          arrayListOf(), arrayListOf())
+      }
+
+    val activity = reactContext.currentActivity as FragmentActivity
+
+    conciergeFragment?.let {
+      activity.supportFragmentManager
+        .beginTransaction()
+        .replace(reactNativeViewId, conciergeFragment!!, reactNativeViewId.toString())
+        .commit()
+    }
+  }
+
+  private fun setupLayout(view: View) {
+    Choreographer.getInstance().postFrameCallback(object : Choreographer.FrameCallback {
+      override fun doFrame(frameTimeNanos: Long) {
+        manuallyLayoutChildren(view)
+        view.viewTreeObserver.dispatchOnGlobalLayout()
+        Choreographer.getInstance().postFrameCallback(this)
+      }
+    })
+  }
+
+  private fun manuallyLayoutChildren(view: View) {
+    val width: Int
+    val height: Int
+    if (propWidth != null && propHeight != null) {
+      width = requireNotNull(propWidth)
+      height = requireNotNull(propHeight)
+    } else {
+      width = view.measuredWidth
+      height = view.measuredHeight
+    }
+
+    view.measure(
+      View.MeasureSpec.makeMeasureSpec(width, View.MeasureSpec.EXACTLY),
+      View.MeasureSpec.makeMeasureSpec(height, View.MeasureSpec.EXACTLY))
+
+    view.layout(0, 0, width, height)
+  }
+
+  override fun onHostResume() {
+    if (broadcastReceiver == null) {
+      broadcastReceiver = object : BroadcastReceiver() {
+        override fun onReceive(context: Context?, intent: Intent?) {
+          val identifier = intent?.extras?.getString(CONCIERGE_IDENTIFIER)
+
+          val actionableLink = intent?.extras?.getString(ConciergeConstants.ACTIONABLE_URL)
+          actionableLink?.let {
+            val uri = Uri.parse(actionableLink)
+            val action = uri.scheme
+
+            val params = Arguments.createMap().apply {
+              putString("type", "conciergeAction")
+              val p = Arguments.createMap().apply {
+                uri.queryParameterNames.forEach { key ->
+                  putString(key, uri.getQueryParameter(key))
+                }
+              }
+              val actionable = Arguments.createMap().apply {
+                putString("action", action)
+                putMap("params", p)
+                putString("identifier", identifier)
+              }
+              putMap("actionableLink", actionable)
+            }
+            val body = Arguments.createMap().apply {
+              putMap("body", params)
+            }
+
+            reactContext
+              .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+              .emit("Concierge-Event", body)
+          }
+
+          val analyticsType = intent?.extras?.getString(ConciergeConstants.ANALYTICS_TYPE)
+          val contentData: HashMap<String, Any>? = intent?.extras?.getSerializable(ConciergeConstants.CONTENT_DATA) as HashMap<String, Any>?
+          val contentInfo: HashMap<String, String>? = intent?.extras?.getSerializable(ConciergeConstants.CONTENT_INFO) as HashMap<String, String>?
+          analyticsType?.let {
+            val cData = Arguments.createMap().apply {
+              contentData?.let { data ->
+                for ((k, v) in data) {
+                  putString(k, v.toString())
+                }
+              }
+            }
+            val cInfo = Arguments.createMap().apply {
+              contentInfo?.let { info ->
+                for ((k, v) in info) {
+                  putString(k, v.toString())
+                }
+              }
+            }
+            val params = Arguments.createMap().apply {
+              putString("type", "conciergeAnalytics")
+              putString("analyticsType", analyticsType)
+              putMap("contentData", cData)
+              putMap("contentInfo", cInfo)
+            }
+            val body = Arguments.createMap().apply {
+              putMap("body", params)
+            }
+
+            reactContext
+              .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+              .emit("Concierge-Event", body)
+          }
+
+          val hasContent = intent?.extras?.getString(ConciergeConstants.HAS_CONTENT)
+          hasContent?.let {
+            val params = Arguments.createMap().apply {
+              putString("type", "conciergeContentFetch")
+              putBoolean("hasContent", hasContent.toBoolean())
+              putString("identifier", identifier)
+            }
+            val body = Arguments.createMap().apply {
+              putMap("body", params)
+            }
+
+            reactContext
+              .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+              .emit("Concierge-Event", body)
+          }
+        }
+      }
+    }
+    val intentFilter = IntentFilter()
+    intentFilter.addAction(BROADCAST_CONCIERGE_EVENT)
+    @SuppressLint("WrongConstant")
+    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+      ContextCompat.registerReceiver(reactContext, broadcastReceiver, intentFilter, ContextCompat.RECEIVER_NOT_EXPORTED)
+    } else {
+      LocalBroadcastManager.getInstance(reactContext)
+        .registerReceiver(broadcastReceiver as BroadcastReceiver, intentFilter)
+    }
+  }
+
+  override fun onHostPause() {
+    if (broadcastReceiver != null) {
+      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+        reactContext.unregisterReceiver(broadcastReceiver)
+      } else {
+        LocalBroadcastManager.getInstance(reactContext).unregisterReceiver(broadcastReceiver as BroadcastReceiver)
+      }
+    }
+  }
+
+  override fun onHostDestroy() {
+    // No-op
+  }
+
+  @ReactProp(name = "style")
+  fun setStyle(view: FrameLayout, value: ReadableMap) {
+  }
+
+  @ReactProp(name = "actionlink")
+  fun setActionLink(view: FrameLayout, value: ReadableMap) {
+    val action = if (value.getString("action") != null) "${value.getString("action")}://" else "concierge://"
+    val identifier = value.getString("identifier")
+    val params = if (value.getMap("params") != null) value.getMap("params")!!.toHashMap() else hashMapOf()
+    val linkBuilder = StringBuilder()
+    linkBuilder.append("$action?")
+    for ((k, v) in params) {
+      linkBuilder.append("$k=${v}")
+      linkBuilder.append("&")
+    }
+    val link = linkBuilder.toString().dropLast(1)
+    actionLink = ActionLink(Uri.parse(link), identifier)
+  }
+
+  @ReactProp(name = "zoneReferenceIDs")
+  fun setZoneReferenceIds(view: FrameLayout, value: ReadableMap) {
+  }
+
+  @ReactProp(name = "onActionEvent")
+  fun setOnActionEvent(view: FrameLayout, value: Boolean) {
+  }
+
+  @ReactProp(name = "onContentArrived")
+  fun setOnContentArrived(view: FrameLayout, value: Boolean) {
+  }
+
+  @ReactProp(name = "onConciergeChange")
+  fun setOnConciergeChange(view: FrameLayout, value: Boolean) {
+  }
+
+  @ReactProp(name = "onAnalyticsEvent")
+  fun setOnAnalyticsEvent(view: FrameLayout, value: Boolean) {
+  }
+
+  internal data class ActionLink(val actionableLink: Uri?, val identifier: String?)
+}