@amplitude/plugin-engagement-react-native 0.1.1-alpha.9 → 0.2.0-alpha.1

package/PluginEngagementReactNative.podspec

@@ -15,8 +15,8 @@ Pod::Spec.new do |s|
 
   s.source_files = "ios/**/*.{h,m,mm,cpp,swift}"
   s.private_header_files = "ios/**/*.h"
-  #s.dependency "AmplitudeEngagementSwift"
-  s.dependency "AmplitudeEngagementSwift"
-  
+
+  s.dependency "AmplitudeEngagementSwift", ">=1.0.6"
+
   install_modules_dependencies(s)
 end

package/README.md

@@ -5,29 +5,19 @@ Amplitude Engagement plugin for React Native
 ## Installation
 
 To install:
+
 - Add `@amplitude/analytics-react-native` and `@amplitude/plugin-engagement-react-native`
 - Also, add `@react-native-async-storage/async-storage`
   - Why? This is used by the `engagement` native module, but the CLI only auto links native modules which you directly depend on in your app’s `package.json`
 
-
 ```sh
 npm install @amplitude/analytics-react-native
-npm install @amplitude/plugin-engagement-react-native
 npm install @react-native-async-storage/async-storage
-```
-
-Add the source for the `AmplitudeEngagementSwift` pod to your Podfile:
-```rb
-target '<your appname>' do
-  ...
-
-  pod "AmplitudeEngagementSwift", :git => "https://github.com/amplitude/Amplitude-Engagement-Swift"
-
-  ...
-end
+npm install @amplitude/plugin-engagement-react-native
 ```
 
 Re-run `pod install` in the `ios` directory:
+
 ```sh
 $ cd ios
 $ bundle exec pod install
@@ -68,6 +58,7 @@ Linking.addEventListener('url', async ({ url }) => {
 ```
 
 ### Linking setup
+
 If you don't already have it set up, please follow this guide to enable deep-linking support in your React Native app in addition to adding the above Linking code:
 https://reactnative.dev/docs/linking#enabling-deep-links
 
@@ -75,21 +66,30 @@ Then, following the Alpha Onboarding guide to setup the "scheme" for the deep li
 
 ### Boot
 
-Finally, “boot” with the user’s ID:
+Finally, “boot” the plugin with the user’s ID; "booting" the SDK enables Guides and Surveys to be shown:
 
 ```
 import {
-  boot
-} from '@amplitude/plugin-engagement-react-native';
+  track,
+  setDeviceId,
+  setUserId,
+} from '@amplitude/analytics-react-native';
+import { useEffect } from 'react';
 
 export default function App() {
   useEffect(() => {
-    boot('rn-test-user-1', 'test-device-1');
+    //
+    // NOTE: setting the User ID in @amplitude/analytics-react-native
+    // --and-- passing it to boot() is necessary for now, but in a
+    // future version will not be necessary
+    //
+    setUserId('rn-test-user-1');
+    setDeviceId('test-device-1');
+    getPlugin().boot('rn-test-user-1', 'test-device-1');
   }, []);
 
 ```
 
-
 ## License
 
-MIT
+MIT

package/android/build.gradle

@@ -76,7 +76,7 @@ dependencies {
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
 
   // Amplitude Engagement SDK
-  implementation "com.amplitude:amplitude-engagement-android:1.0.14"
+  implementation "com.amplitude:amplitude-engagement-android:1.0.15"
 
   // Amplitude Analytics SDK (required dependency)
   implementation "com.amplitude:analytics-android:1.+"

package/android/src/main/java/com/amplitude/pluginengagementreactnative/PluginEngagementReactNativeModule.kt

@@ -6,7 +6,9 @@ import android.content.Intent
 import android.os.Bundle
 import android.util.Log
 import androidx.core.net.toUri
+import com.amplitude.android.engagement.AmplitudeBootOptions
 import com.amplitude.android.engagement.AmplitudeEngagement
+import com.amplitude.android.engagement.__ReactNative__AESDK
 import com.amplitude.android.engagement.AmplitudeInitOptions
 import com.amplitude.android.engagement.ui.theme.ThemeMode
 import com.amplitude.core.events.BaseEvent
@@ -74,12 +76,25 @@ class PluginEngagementReactNativeModule(val reactContext: ReactApplicationContex
     }
   }
 
-  override fun boot(id: Double, userId: String, deviceId: String) {
+  override fun boot(id: Double, userId: String?, deviceId: String?) {
     val instance = instances[id]?.instance ?: return
-
+    val self = this
     runBlocking(Dispatchers.Main) {
       Log.d("PluginEngagementReactNativeModule", "boot: $userId, $deviceId")
-      instance.boot(userId, deviceId)
+      val options = AmplitudeBootOptions(userId=userId ?: "", deviceId=deviceId, integrations = arrayOf(
+        { event: BaseEvent ->
+          try {
+            val serializedEvent = mapOf(
+              "event_type" to event.eventType,
+              "event_properties" to event.eventProperties
+            ).toWritableMap()
+            self.emitOnTrackEvent(serializedEvent)
+          } catch (e: Exception) {
+            Log.e("PluginEngagementReactNativeModule", "Error tracking Event", e)
+          }
+        }
+      ))
+      instance.boot(options)
     }
   }
 

package/android/src/main/java/com/amplitude/pluginengagementreactnative/Util.kt

@@ -0,0 +1,51 @@
+package com.amplitude.pluginengagementreactnative
+
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.WritableArray
+import com.facebook.react.bridge.WritableMap
+
+fun Iterable<*>.toWritableArray(): WritableArray {
+  val iter = this.iterator()
+
+  val writableArray: WritableArray = Arguments.createArray()
+
+  while (iter.hasNext()) {
+    val value = iter.next()
+
+    when (value) {
+      null -> writableArray.pushNull()
+      is Boolean -> writableArray.pushBoolean(value)
+      is Double -> writableArray.pushDouble(value)
+      is Int -> writableArray.pushInt(value)
+      is String -> writableArray.pushString(value)
+      is Map<*, *> -> writableArray.pushMap((value as Map<String, Any?>).toWritableMap())
+      else -> throw IllegalArgumentException("Cannot convert value of type ${value.javaClass.simpleName}")
+    }
+  }
+
+  return writableArray
+}
+
+
+fun Map<String, *>.toWritableMap(): WritableMap {
+  val writableMap: WritableMap = Arguments.createMap()
+  val iterator = entries.iterator()
+
+  while (iterator.hasNext()) {
+    val pair = iterator.next()
+    val value = pair.value
+
+    when {
+      value == null -> writableMap.putNull(pair.key)
+      value is Boolean -> writableMap.putBoolean(pair.key, value)
+      value is Double -> writableMap.putDouble(pair.key, value)
+      value is Int -> writableMap.putInt(pair.key, value)
+      value is String -> writableMap.putString(pair.key, value)
+      value is Map<*, *> -> writableMap.putMap(pair.key, (value as Map<String, *>).toWritableMap())
+      value is Iterable<*> -> writableMap.putArray(pair.key, value.toWritableArray())
+      else -> throw IllegalArgumentException("Cannot convert value of type ${value.javaClass.simpleName}")
+    }
+  }
+
+  return writableMap
+}

package/ios/AmplitudeEngagementAdapter.swift

@@ -5,117 +5,148 @@
 //  Created by Jared Luxenberg on 5/19/25.
 //
 
-import Foundation
 import AmplitudeEngagementSwift
-
+import Foundation
 
 extension Encodable {
-    /// Converting object to postable dictionary
-    func toDictionary(_ encoder: JSONEncoder = JSONEncoder()) throws -> [String: Any] {
-        let data = try encoder.encode(self)
-        let object = try JSONSerialization.jsonObject(with: data)
-        if let json = object as? [String: Any]  { return json }
-        
-        let context = DecodingError.Context(codingPath: [], debugDescription: "Deserialized object is not a dictionary")
-        throw DecodingError.typeMismatch(type(of: object), context)
-    }
+  /// Converting object to postable dictionary
+  func toDictionary(_ encoder: JSONEncoder = JSONEncoder()) throws -> [String: Any] {
+    let data = try encoder.encode(self)
+    let object = try JSONSerialization.jsonObject(with: data)
+    if let json = object as? [String: Any] { return json }
+
+    let context = DecodingError.Context(
+      codingPath: [], debugDescription: "Deserialized object is not a dictionary")
+    throw DecodingError.typeMismatch(type(of: object), context)
+  }
 }
 
 // id -> (api_key, amplitude engagement instance)
 var instances: [Int: (String, AmplitudeEngagement)] = [:]
 var _id = 0
 
-/** `@objc` attribute exposes Swift methods to the Objective-C runtime**/
+/// `@objc` attribute exposes Swift methods to the Objective-C runtime*
 @objc public class AmplitudeEngagementAdapter: NSObject {
   @objc public func newInstance(_ apiKey: String) -> Int {
     if let existingId = instances.first(where: { $0.value.0 == apiKey })?.key {
-        return existingId
+      return existingId
     }
-    
+
     return DispatchQueue.main.sync {
-      _id += 1;
-      let id = _id + 1;
-      instances[id] = (apiKey, __ReactNative__AESDK(apiKey, AmplitudeInitOptions(logLevel: AmplitudeLogLevel.verbose)))
+      _id += 1
+      let id = _id + 1
+      instances[id] = (
+        apiKey,
+        __ReactNative__AESDK(apiKey, AmplitudeInitOptions(logLevel: AmplitudeLogLevel.verbose))
+      )
       return id
     }
   }
-  
-  
-  @objc public func boot(_ instanceId: Int, _ user_id: String, device_id: String? = nil) {
+
+  @objc public func boot(
+    _ instanceId: Int, _ user_id: String, device_id: String? = nil,
+    integration: @escaping (_ event_type: String, _ event: [String: Any]) -> Void
+  ) {
     DispatchQueue.main.sync {
       guard let (_, instance) = instances[instanceId] else { return }
-      
-      return instance.boot(user_id, device_id: device_id)
+      let options = AmplitudeBootOptions(
+        user_id: user_id, device_id: device_id,
+        integrations: [
+          { event, props in
+            integration(event, props)
+          }
+        ])
+      return instance.boot(options: options)
     }
   }
-  
+
   @objc public func setThemeMode(_ instanceId: Int, themeMode: String) {
     DispatchQueue.main.sync {
-      guard let (_, instance) = instances[instanceId] else { fatalError("🚨 Runtime exception: no instance found for id “\(instanceId)”") }
+      guard let (_, instance) = instances[instanceId] else {
+        fatalError("🚨 Runtime exception: no instance found for id “\(instanceId)”")
+      }
       guard let themeModeParsed = ThemeMode(rawValue: themeMode) else { return }
-      
+
       return instance.setThemeMode(themeMode: themeModeParsed)
     }
   }
-  
+
   @objc public func reset(_ instanceId: Int, key: String, stepIndex: Int = 0) {
     DispatchQueue.main.sync {
-      guard let (_, instance) = instances[instanceId] else { fatalError("🚨 Runtime exception: no instance found for id “\(instanceId)”") }
-      
+      guard let (_, instance) = instances[instanceId] else {
+        fatalError("🚨 Runtime exception: no instance found for id “\(instanceId)”")
+      }
+
       return instance.reset(key: key, stepIndex: stepIndex)
     }
   }
-  
+
   @objc public func list(_ instanceId: Int) -> [[String: Any]] {
     DispatchQueue.main.sync {
-      guard let (_, instance) = instances[instanceId] else { fatalError("🚨 Runtime exception: no instance found for id “\(instanceId)”") }
-      
+      guard let (_, instance) = instances[instanceId] else {
+        fatalError("🚨 Runtime exception: no instance found for id “\(instanceId)”")
+      }
+
       return instance.list().compactMap { x in try? x.toDictionary() }
     }
   }
-  
+
   @objc public func handleUrl(_ instanceId: Int, _ url: String) -> Bool {
     DispatchQueue.main.sync {
-      guard let (_, instance) = instances[instanceId] else { fatalError("🚨 Runtime exception: no instance found for id “\(instanceId)”") }
-      guard let url = URL(string: url) else { return false; }
-      
+      guard let (_, instance) = instances[instanceId] else {
+        fatalError("🚨 Runtime exception: no instance found for id “\(instanceId)”")
+      }
+      guard let url = URL(string: url) else { return false }
+
       return instance.handleUrl(url)
     }
   }
-  
+
   @objc public func show(_ instanceId: Int, key: String, stepIndex: Int = 0) {
     DispatchQueue.main.sync {
-      guard let (_, instance) = instances[instanceId] else { fatalError("🚨 Runtime exception: no instance found for id “\(instanceId)”") }
+      guard let (_, instance) = instances[instanceId] else {
+        fatalError("🚨 Runtime exception: no instance found for id “\(instanceId)”")
+      }
       return instance.show(key: key, stepIndex: stepIndex)
     }
   }
-  
+
   @objc public func screen(_ instanceId: Int, _ screenName: String) {
     DispatchQueue.main.sync {
-      guard let (_, instance) = instances[instanceId] else { fatalError("🚨 Runtime exception: no instance found for id “\(instanceId)”") }
+      guard let (_, instance) = instances[instanceId] else {
+        fatalError("🚨 Runtime exception: no instance found for id “\(instanceId)”")
+      }
       return instance.screen(screenName)
     }
   }
-  
+
   @objc public func closeAll(_ instanceId: Int) {
     DispatchQueue.main.sync {
-      guard let (_, instance) = instances[instanceId] else { fatalError("🚨 Runtime exception: no instance found for id “\(instanceId)”") }
+      guard let (_, instance) = instances[instanceId] else {
+        fatalError("🚨 Runtime exception: no instance found for id “\(instanceId)”")
+      }
       return instance.closeAll()
     }
   }
-  
+
   @objc public func forwardEvent(_ instanceId: Int, _ event: [String: Any]) {
     DispatchQueue.main.sync {
-      guard let (_, instance) = instances[instanceId] else { fatalError("🚨 Runtime exception: no instance found for id “\(instanceId)”") }
+      guard let (_, instance) = instances[instanceId] else {
+        fatalError("🚨 Runtime exception: no instance found for id “\(instanceId)”")
+      }
       return instance.forwardEvent(event)
     }
   }
-  
-  @objc(addCallback:::) public func addCallback(_ instanceId: Int, _ key: String, _ function: @escaping () -> Void) {
+
+  @objc(addCallback:::) public func addCallback(
+    _ instanceId: Int, _ key: String, _ function: @escaping () -> Void
+  ) {
     DispatchQueue.main.sync {
-      guard let (_, instance) = instances[instanceId] else { fatalError("🚨 Runtime exception: no instance found for id “\(instanceId)”") }
+      guard let (_, instance) = instances[instanceId] else {
+        fatalError("🚨 Runtime exception: no instance found for id “\(instanceId)”")
+      }
       return instance.addCallback(key, function)
     }
   }
-  
+
 }

package/ios/PluginEngagementReactNative.h

@@ -1,5 +1,5 @@
 #import <PluginEngagementReactNativeSpec/PluginEngagementReactNativeSpec.h>
 
-@interface PluginEngagementReactNative : NSObject <NativePluginEngagementReactNativeSpec>
+@interface PluginEngagementReactNative : NativePluginEngagementReactNativeSpecBase <NativePluginEngagementReactNativeSpec>
 
 @end

package/ios/PluginEngagementReactNative.mm

@@ -29,7 +29,11 @@
 }
 
 - (void)boot:(double)id user_id:(nonnull NSString *)user_id device_id:(nonnull NSString *)device_id {
-  [adapter boot:id :user_id device_id:device_id];
+  void (^callback)(NSString *, NSDictionary *) = ^(NSString *event_type, NSDictionary *event) {
+    [self emitOnTrackEvent:@{@"event_type": event_type, @"event_properties": event}];
+  };
+
+  [adapter boot:id :user_id device_id:device_id integration:callback];
 }
 
 - (nonnull NSArray<NSDictionary *> *)list:(double)id {

package/lib/module/AmplitudeEngagement.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeModules","isTurboModuleEnabled","global","__turboModuleProxy","PluginEngagementReactNative","require","default","AmplitudeEngagement","constructor","apiKey","id","newInstance","boot","user_id","device_id","setThemeMode","themeMode","reset","key","stepIndex","list","show","screen","screenName","closeAll","forwardEvent","event","addCallback","func","handleURL","url"],"sourceRoot":"../../src","sources":["AmplitudeEngagement.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,cAAc;AAM5C,MAAMC,oBAAoB,GAAIC,MAAM,CAASC,kBAAkB,IAAI,IAAI;AAEvE,MAAMC,2BAA4D,GAChEH,oBAAoB,GAChBI,OAAO,CAAC,qCAAqC,CAAC,CAACC,OAAO,GACtDN,aAAa,CAACI,2BAA2B;AAE/C,OAAO,MAAMG,mBAAmB,CAAC;EAG/BC,WAAWA,CAACC,MAAc,EAAE;IAC1B;IACA,IAAI,CAACC,EAAE,GAAGN,2BAA2B,CAACO,WAAW,CAACF,MAAM,CAAC;EAC3D;EAEAG,IAAIA,CAACC,OAAe,EAAEC,SAAiB,EAAQ;IAC7CV,2BAA2B,CAACQ,IAAI,CAAC,IAAI,CAACF,EAAE,EAAEG,OAAO,EAAEC,SAAS,CAAC;EAC/D;EAEAC,YAAYA,CAACC,SAAoB,EAAQ;IACvC,OAAOZ,2BAA2B,CAACW,YAAY,CAAC,IAAI,CAACL,EAAE,EAAEM,SAAS,CAAC;EACrE;EAEAC,KAAKA,CAACC,GAAW,EAAEC,SAAiB,EAAQ;IAC1C,OAAOf,2BAA2B,CAACa,KAAK,CAAC,IAAI,CAACP,EAAE,EAAEQ,GAAG,EAAEC,SAAS,CAAC;EACnE;EAEAC,IAAIA,CAAA,EAAoB;IACtB,OAAOhB,2BAA2B,CAACgB,IAAI,CAAC,IAAI,CAACV,EAAE,CAAC;EAClD;EAEAW,IAAIA,CAACH,GAAW,EAAEC,SAAiB,EAAQ;IACzC,OAAOf,2BAA2B,CAACiB,IAAI,CAAC,IAAI,CAACX,EAAE,EAAEQ,GAAG,EAAEC,SAAS,CAAC;EAClE;EAEAG,MAAMA,CAACC,UAAkB,EAAQ;IAC/B,OAAOnB,2BAA2B,CAACkB,MAAM,CAAC,IAAI,CAACZ,EAAE,EAAEa,UAAU,CAAC;EAChE;EAEAC,QAAQA,CAAA,EAAS;IACf,OAAOpB,2BAA2B,CAACoB,QAAQ,CAAC,IAAI,CAACd,EAAE,CAAC;EACtD;EAEAe,YAAYA,CAACC,KAAgB,EAAQ;IACnC,OAAOtB,2BAA2B,CAACqB,YAAY,CAAC,IAAI,CAACf,EAAE,EAAEgB,KAAK,CAAC;EACjE;EAEAC,WAAWA,CAACT,GAAW,EAAEU,IAAgB,EAAQ;IAC/C,OAAOxB,2BAA2B,CAACuB,WAAW,CAAC,IAAI,CAACjB,EAAE,EAAEQ,GAAG,EAAEU,IAAI,CAAC;EACpE;EAEAC,SAASA,CAACC,GAAW,EAAW;IAC9B,OAAO1B,2BAA2B,CAACyB,SAAS,CAAC,IAAI,CAACnB,EAAE,EAAEoB,GAAG,CAAC;EAC5D;AACF","ignoreList":[]}
+{"version":3,"names":["NativeModules","isTurboModuleEnabled","global","__turboModuleProxy","PluginEngagementReactNative","require","default","AmplitudeEngagement","constructor","apiKey","id","newInstance","boot","user_id","device_id","setThemeMode","themeMode","reset","key","stepIndex","list","show","screen","screenName","closeAll","forwardEvent","event","addCallback","func","handleURL","url"],"sourceRoot":"../../src","sources":["AmplitudeEngagement.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,cAAc;AAM5C,MAAMC,oBAAoB,GAAIC,MAAM,CAASC,kBAAkB,IAAI,IAAI;AAEvE,MAAMC,2BAA4D,GAChEH,oBAAoB,GAChBI,OAAO,CAAC,qCAAqC,CAAC,CAACC,OAAO,GACtDN,aAAa,CAACI,2BAA2B;AAE/C,OAAO,MAAMG,mBAAmB,CAAC;EAG/BC,WAAWA,CAACC,MAAc,EAAE;IAC1B;IACA,IAAI,CAACC,EAAE,GAAGN,2BAA2B,CAACO,WAAW,CAACF,MAAM,CAAC;EAC3D;EAEAG,IAAIA,CAACC,OAAgB,EAAEC,SAAkB,EAAQ;IAC/CV,2BAA2B,CAACQ,IAAI,CAAC,IAAI,CAACF,EAAE,EAAEG,OAAO,EAAEC,SAAS,CAAC;EAC/D;EAEAC,YAAYA,CAACC,SAAoB,EAAQ;IACvC,OAAOZ,2BAA2B,CAACW,YAAY,CAAC,IAAI,CAACL,EAAE,EAAEM,SAAS,CAAC;EACrE;EAEAC,KAAKA,CAACC,GAAW,EAAEC,SAAiB,EAAQ;IAC1C,OAAOf,2BAA2B,CAACa,KAAK,CAAC,IAAI,CAACP,EAAE,EAAEQ,GAAG,EAAEC,SAAS,CAAC;EACnE;EAEAC,IAAIA,CAAA,EAAoB;IACtB,OAAOhB,2BAA2B,CAACgB,IAAI,CAAC,IAAI,CAACV,EAAE,CAAC;EAClD;EAEAW,IAAIA,CAACH,GAAW,EAAEC,SAAiB,EAAQ;IACzC,OAAOf,2BAA2B,CAACiB,IAAI,CAAC,IAAI,CAACX,EAAE,EAAEQ,GAAG,EAAEC,SAAS,CAAC;EAClE;EAEAG,MAAMA,CAACC,UAAkB,EAAQ;IAC/B,OAAOnB,2BAA2B,CAACkB,MAAM,CAAC,IAAI,CAACZ,EAAE,EAAEa,UAAU,CAAC;EAChE;EAEAC,QAAQA,CAAA,EAAS;IACf,OAAOpB,2BAA2B,CAACoB,QAAQ,CAAC,IAAI,CAACd,EAAE,CAAC;EACtD;EAEAe,YAAYA,CAACC,KAAgB,EAAQ;IACnC,OAAOtB,2BAA2B,CAACqB,YAAY,CAAC,IAAI,CAACf,EAAE,EAAEgB,KAAK,CAAC;EACjE;EAEAC,WAAWA,CAACT,GAAW,EAAEU,IAAgB,EAAQ;IAC/C,OAAOxB,2BAA2B,CAACuB,WAAW,CAAC,IAAI,CAACjB,EAAE,EAAEQ,GAAG,EAAEU,IAAI,CAAC;EACpE;EAEAC,SAASA,CAACC,GAAW,EAAW;IAC9B,OAAO1B,2BAA2B,CAACyB,SAAS,CAAC,IAAI,CAACnB,EAAE,EAAEoB,GAAG,CAAC;EAC5D;AACF","ignoreList":[]}

package/lib/module/AmplitudeEngagementPlugin.js

@@ -1,23 +1,44 @@
 "use strict";
 
-import { forwardEvent, init, screen } from "./index.js";
+import { forwardEvent, init, screen, boot } from "./index.js";
+import NativePluginEngagementReactNative from "./NativePluginEngagementReactNative.js";
 import { Logger } from "./logger.js";
 export class AmplitudeEngagementPlugin {
   name = 'AmplitudeEngagementPlugin';
   type = 'enrichment';
   logger = new Logger('AmplitudeEngagementPlugin');
-  async setup(config, _client) {
+  trackEventSubscription = null;
+  async setup(config, client) {
     try {
-      console.log('initializing with apiKey', config.apiKey);
+      this.logger.log('initializing with apiKey', config.apiKey);
       init(config.apiKey);
+      this.client = client;
+      // TODO: grab identity from client when available -- need to wait until it's added.
+      // Need to wait until https://amplitude.atlassian.net/browse/AMP-133461 is resolved
+      // then; follow the same pattern as in the `AmplitudeEngagementPlugin` in the Swift/iOS code
     } catch (error) {
       this.logger.error('AmplitudeEngagementPlugin#setup failed to initialize', error);
     }
+  }
 
-    // TODO: call "boot" here -- but we don't have the user_id and device_id yet so we cannot
+  // TODO: for now, you must call `boot()` manually
+  // but once we have access to the identity from the client,
+  // we can call `boot()` automatically in `setup` and `onIdentityChanged`
+  boot(user_id, device_id) {
+    boot(user_id, device_id);
+    if (this.trackEventSubscription) {
+      this.trackEventSubscription.remove();
+    }
+    this.trackEventSubscription = NativePluginEngagementReactNative.onTrackEvent(event => {
+      if (!this.client) {
+        this.logger.error('AmplitudeEngagementPlugin#onIdentityChanged client is not initialized');
+        return;
+      }
+      this.client?.track(event.event_type, event.event_properties);
+    });
   }
   async execute(context) {
-    console.log(`AmplitudeEngagement#execute event=${JSON.stringify(context)}`);
+    this.logger.log(`AmplitudeEngagement#execute event=${JSON.stringify(context)}`);
     if (context.event_type === '[Amplitude] Screen Viewed' && typeof context.event_properties?.['[Amplitude] Screen Name'] === 'string') {
       const screenName = context.event_properties['[Amplitude] Screen Name'];
       screen(screenName);

package/lib/module/AmplitudeEngagementPlugin.js.map

@@ -1 +1 @@
-{"version":3,"names":["forwardEvent","init","screen","Logger","AmplitudeEngagementPlugin","name","type","logger","setup","config","_client","console","log","apiKey","error","execute","context","JSON","stringify","event_type","event_properties","screenName"],"sourceRoot":"../../src","sources":["AmplitudeEngagementPlugin.ts"],"mappings":";;AAMA,SAASA,YAAY,EAAEC,IAAI,EAAEC,MAAM,QAAQ,YAAG;AAC9C,SAASC,MAAM,QAA8B,aAAU;AAEvD,OAAO,MAAMC,yBAAyB,CAA6B;EACjEC,IAAI,GAAG,2BAA2B;EAClCC,IAAI,GAAG,YAAY;EAEnBC,MAAM,GAAoB,IAAIJ,MAAM,CAAC,2BAA2B,CAAC;EAEjE,MAAMK,KAAKA,CAACC,MAAc,EAAEC,OAAmB,EAAiB;IAC9D,IAAI;MACFC,OAAO,CAACC,GAAG,CAAC,0BAA0B,EAAEH,MAAM,CAACI,MAAM,CAAC;MACtDZ,IAAI,CAACQ,MAAM,CAACI,MAAM,CAAC;IACrB,CAAC,CAAC,OAAOC,KAAK,EAAE;MACd,IAAI,CAACP,MAAM,CAACO,KAAK,CACf,sDAAsD,EACtDA,KACF,CAAC;IACH;;IAEA;EACF;EAEA,MAAMC,OAAOA,CAACC,OAAc,EAAyB;IACnDL,OAAO,CAACC,GAAG,CAAC,qCAAqCK,IAAI,CAACC,SAAS,CAACF,OAAO,CAAC,EAAE,CAAC;IAE3E,IACEA,OAAO,CAACG,UAAU,KAAK,2BAA2B,IAClD,OAAOH,OAAO,CAACI,gBAAgB,GAAG,yBAAyB,CAAC,KAAK,QAAQ,EACzE;MACA,MAAMC,UAAU,GAAGL,OAAO,CAACI,gBAAgB,CACzC,yBAAyB,CAChB;MACXlB,MAAM,CAACmB,UAAU,CAAC;IACpB;IAEArB,YAAY,CAACgB,OAAO,CAAC;IAErB,OAAOA,OAAO;EAChB;AACF","ignoreList":[]}
+{"version":3,"names":["forwardEvent","init","screen","boot","NativePluginEngagementReactNative","Logger","AmplitudeEngagementPlugin","name","type","logger","trackEventSubscription","setup","config","client","log","apiKey","error","user_id","device_id","remove","onTrackEvent","event","track","event_type","event_properties","execute","context","JSON","stringify","screenName"],"sourceRoot":"../../src","sources":["AmplitudeEngagementPlugin.ts"],"mappings":";;AAMA,SAASA,YAAY,EAAEC,IAAI,EAAEC,MAAM,EAAEC,IAAI,QAAQ,YAAG;AACpD,OAAOC,iCAAiC,MAAM,wCAAqC;AAEnF,SAASC,MAAM,QAA8B,aAAU;AAGvD,OAAO,MAAMC,yBAAyB,CAA6B;EACjEC,IAAI,GAAG,2BAA2B;EAClCC,IAAI,GAAG,YAAY;EASnBC,MAAM,GAAoB,IAAIJ,MAAM,CAAC,2BAA2B,CAAC;EAEjEK,sBAAsB,GAA6B,IAAI;EAEvD,MAAMC,KAAKA,CAACC,MAAc,EAAEC,MAAkB,EAAiB;IAC7D,IAAI;MACF,IAAI,CAACJ,MAAM,CAACK,GAAG,CAAC,0BAA0B,EAAEF,MAAM,CAACG,MAAM,CAAC;MAC1Dd,IAAI,CAACW,MAAM,CAACG,MAAM,CAAC;MACnB,IAAI,CAACF,MAAM,GAAGA,MAAM;MACpB;MACA;MACA;IACF,CAAC,CAAC,OAAOG,KAAK,EAAE;MACd,IAAI,CAACP,MAAM,CAACO,KAAK,CACf,sDAAsD,EACtDA,KACF,CAAC;IACH;EACF;;EAEA;EACA;EACA;EACAb,IAAIA,CAACc,OAAgB,EAAEC,SAAkB,EAAQ;IAC/Cf,IAAI,CAACc,OAAO,EAAEC,SAAS,CAAC;IACxB,IAAI,IAAI,CAACR,sBAAsB,EAAE;MAC/B,IAAI,CAACA,sBAAsB,CAACS,MAAM,CAAC,CAAC;IACtC;IAEA,IAAI,CAACT,sBAAsB,GACzBN,iCAAiC,CAACgB,YAAY,CAAEC,KAAK,IAAK;MACxD,IAAI,CAAC,IAAI,CAACR,MAAM,EAAE;QAChB,IAAI,CAACJ,MAAM,CAACO,KAAK,CACf,uEACF,CAAC;QACD;MACF;MACA,IAAI,CAACH,MAAM,EAAES,KAAK,CAACD,KAAK,CAACE,UAAU,EAAEF,KAAK,CAACG,gBAAgB,CAAC;IAC9D,CAAC,CAAC;EACN;EAEA,MAAMC,OAAOA,CAACC,OAAc,EAAyB;IACnD,IAAI,CAACjB,MAAM,CAACK,GAAG,CACb,qCAAqCa,IAAI,CAACC,SAAS,CAACF,OAAO,CAAC,EAC9D,CAAC;IAED,IACEA,OAAO,CAACH,UAAU,KAAK,2BAA2B,IAClD,OAAOG,OAAO,CAACF,gBAAgB,GAAG,yBAAyB,CAAC,KAAK,QAAQ,EACzE;MACA,MAAMK,UAAU,GAAGH,OAAO,CAACF,gBAAgB,CACzC,yBAAyB,CAChB;MACXtB,MAAM,CAAC2B,UAAU,CAAC;IACpB;IAEA7B,YAAY,CAAC0B,OAAO,CAAC;IAErB,OAAOA,OAAO;EAChB;AACF","ignoreList":[]}

package/lib/module/NativePluginEngagementReactNative.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativePluginEngagementReactNative.ts"],"mappings":";;AACA,SAASA,mBAAmB,QAAQ,cAAc;AAwBlD,eAAeA,mBAAmB,CAACC,YAAY,CAC7C,6BACF,CAAC","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativePluginEngagementReactNative.ts"],"mappings":";;AACA,SAASA,mBAAmB,QAAQ,cAAc;AA+BlD,eAAeA,mBAAmB,CAACC,YAAY,CAC7C,6BACF,CAAC","ignoreList":[]}

package/lib/module/index.js

@@ -58,7 +58,11 @@ export async function handleURL(url) {
   const e = await getGlobalEngagement();
   return e.handleURL(url);
 }
+let plugin = null;
 export function getPlugin() {
-  return new AmplitudeEngagementPlugin();
+  if (!plugin) {
+    plugin = new AmplitudeEngagementPlugin();
+  }
+  return plugin;
 }
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["AmplitudeEngagement","AmplitudeEngagementPlugin","globalEngagement","toNotify","getGlobalEngagement","Promise","resolve","_reject","push","engagement","init","apiKey","Error","forEach","callback","boot","user_id","device_id","e","list","show","key","stepIndex","screen","screenName","closeAll","forwardEvent","event","addCallback","func","handleURL","url","getPlugin"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,mBAAmB,QAAQ,0BAAuB;AAC3D,SAASC,yBAAyB,QAAQ,gCAA6B;AAIvE,IAAIC,gBAAqC,GAAG,IAAW;AACvD,IAAIC,QAAuD,GAAG,EAAE;AAEhE,eAAeC,mBAAmBA,CAAA,EAAiC;EACjE,IAAIF,gBAAgB,EAAE;IACpB,OAAOA,gBAAgB;EACzB,CAAC,MAAM;IACL,OAAO,MAAM,IAAIG,OAAO,CAAC,CAACC,OAAO,EAAEC,OAAO,KAAK;MAC7CJ,QAAQ,CAACK,IAAI,CAAEC,UAAU,IAAK;QAC5BH,OAAO,CAACG,UAAU,CAAC;MACrB,CAAC,CAAC;IACJ,CAAC,CAAC;EACJ;AACF;AAEA,OAAO,SAASC,IAAIA,CAACC,MAAc,EAAQ;EACzC;EACA,IAAIT,gBAAgB,EAAE;IACpB,MAAM,IAAIU,KAAK,CAAC,yCAAyC,CAAC;EAC5D;EACAV,gBAAgB,GAAG,IAAIF,mBAAmB,CAACW,MAAM,CAAC;EAClDR,QAAQ,CAACU,OAAO,CAAEC,QAAQ,IAAK;IAC7BA,QAAQ,CAACZ,gBAAgB,CAAC;EAC5B,CAAC,CAAC;EACFC,QAAQ,GAAG,EAAE;AACf;AAEA,OAAO,eAAeY,IAAIA,CAACC,OAAe,EAAEC,SAAiB,EAAiB;EAC5E,MAAMC,CAAC,GAAG,MAAMd,mBAAmB,CAAC,CAAC;EACrC,OAAOc,CAAC,CAACH,IAAI,CAACC,OAAO,EAAEC,SAAS,CAAC;AACnC;AAEA,OAAO,eAAeE,IAAIA,CAAA,EAA6B;EACrD,MAAMD,CAAC,GAAG,MAAMd,mBAAmB,CAAC,CAAC;EACrC,OAAOc,CAAC,CAACC,IAAI,CAAC,CAAC;AACjB;AAEA,OAAO,eAAeC,IAAIA,CAACC,GAAW,EAAEC,SAAiB,EAAiB;EACxE,MAAMJ,CAAC,GAAG,MAAMd,mBAAmB,CAAC,CAAC;EACrC,OAAOc,CAAC,CAACE,IAAI,CAACC,GAAG,EAAEC,SAAS,CAAC;AAC/B;AAEA,OAAO,eAAeC,MAAMA,CAACC,UAAkB,EAAiB;EAC9D,MAAMN,CAAC,GAAG,MAAMd,mBAAmB,CAAC,CAAC;EACrC,OAAOc,CAAC,CAACK,MAAM,CAACC,UAAU,CAAC;AAC7B;AAEA,OAAO,eAAeC,QAAQA,CAAA,EAAkB;EAC9C,MAAMP,CAAC,GAAG,MAAMd,mBAAmB,CAAC,CAAC;EACrC,OAAOc,CAAC,CAACO,QAAQ,CAAC,CAAC;AACrB;AAEA,OAAO,eAAeC,YAAYA,CAACC,KAAgB,EAAiB;EAClE,MAAMT,CAAC,GAAG,MAAMd,mBAAmB,CAAC,CAAC;EACrC,OAAOc,CAAC,CAACQ,YAAY,CAACC,KAAK,CAAC;AAC9B;AAEA,OAAO,eAAeC,WAAWA,CAC/BP,GAAW,EACXQ,IAAgB,EACD;EACf,MAAMX,CAAC,GAAG,MAAMd,mBAAmB,CAAC,CAAC;EACrC,OAAOc,CAAC,CAACU,WAAW,CAACP,GAAG,EAAEQ,IAAI,CAAC;AACjC;AAEA,OAAO,eAAeC,SAASA,CAACC,GAAW,EAAoB;EAC7D,MAAMb,CAAC,GAAG,MAAMd,mBAAmB,CAAC,CAAC;EACrC,OAAOc,CAAC,CAACY,SAAS,CAACC,GAAG,CAAC;AACzB;AAEA,OAAO,SAASC,SAASA,CAAA,EAAW;EAClC,OAAO,IAAI/B,yBAAyB,CAAC,CAAC;AACxC","ignoreList":[]}
+{"version":3,"names":["AmplitudeEngagement","AmplitudeEngagementPlugin","globalEngagement","toNotify","getGlobalEngagement","Promise","resolve","_reject","push","engagement","init","apiKey","Error","forEach","callback","boot","user_id","device_id","e","list","show","key","stepIndex","screen","screenName","closeAll","forwardEvent","event","addCallback","func","handleURL","url","plugin","getPlugin"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,mBAAmB,QAAQ,0BAAuB;AAC3D,SAASC,yBAAyB,QAAQ,gCAA6B;AAIvE,IAAIC,gBAAqC,GAAG,IAAW;AACvD,IAAIC,QAAuD,GAAG,EAAE;AAEhE,eAAeC,mBAAmBA,CAAA,EAAiC;EACjE,IAAIF,gBAAgB,EAAE;IACpB,OAAOA,gBAAgB;EACzB,CAAC,MAAM;IACL,OAAO,MAAM,IAAIG,OAAO,CAAC,CAACC,OAAO,EAAEC,OAAO,KAAK;MAC7CJ,QAAQ,CAACK,IAAI,CAAEC,UAAU,IAAK;QAC5BH,OAAO,CAACG,UAAU,CAAC;MACrB,CAAC,CAAC;IACJ,CAAC,CAAC;EACJ;AACF;AAEA,OAAO,SAASC,IAAIA,CAACC,MAAc,EAAQ;EACzC;EACA,IAAIT,gBAAgB,EAAE;IACpB,MAAM,IAAIU,KAAK,CAAC,yCAAyC,CAAC;EAC5D;EACAV,gBAAgB,GAAG,IAAIF,mBAAmB,CAACW,MAAM,CAAC;EAClDR,QAAQ,CAACU,OAAO,CAAEC,QAAQ,IAAK;IAC7BA,QAAQ,CAACZ,gBAAgB,CAAC;EAC5B,CAAC,CAAC;EACFC,QAAQ,GAAG,EAAE;AACf;AAEA,OAAO,eAAeY,IAAIA,CACxBC,OAAgB,EAChBC,SAAkB,EACH;EACf,MAAMC,CAAC,GAAG,MAAMd,mBAAmB,CAAC,CAAC;EACrC,OAAOc,CAAC,CAACH,IAAI,CAACC,OAAO,EAAEC,SAAS,CAAC;AACnC;AAEA,OAAO,eAAeE,IAAIA,CAAA,EAA6B;EACrD,MAAMD,CAAC,GAAG,MAAMd,mBAAmB,CAAC,CAAC;EACrC,OAAOc,CAAC,CAACC,IAAI,CAAC,CAAC;AACjB;AAEA,OAAO,eAAeC,IAAIA,CAACC,GAAW,EAAEC,SAAiB,EAAiB;EACxE,MAAMJ,CAAC,GAAG,MAAMd,mBAAmB,CAAC,CAAC;EACrC,OAAOc,CAAC,CAACE,IAAI,CAACC,GAAG,EAAEC,SAAS,CAAC;AAC/B;AAEA,OAAO,eAAeC,MAAMA,CAACC,UAAkB,EAAiB;EAC9D,MAAMN,CAAC,GAAG,MAAMd,mBAAmB,CAAC,CAAC;EACrC,OAAOc,CAAC,CAACK,MAAM,CAACC,UAAU,CAAC;AAC7B;AAEA,OAAO,eAAeC,QAAQA,CAAA,EAAkB;EAC9C,MAAMP,CAAC,GAAG,MAAMd,mBAAmB,CAAC,CAAC;EACrC,OAAOc,CAAC,CAACO,QAAQ,CAAC,CAAC;AACrB;AAEA,OAAO,eAAeC,YAAYA,CAACC,KAAgB,EAAiB;EAClE,MAAMT,CAAC,GAAG,MAAMd,mBAAmB,CAAC,CAAC;EACrC,OAAOc,CAAC,CAACQ,YAAY,CAACC,KAAK,CAAC;AAC9B;AAEA,OAAO,eAAeC,WAAWA,CAC/BP,GAAW,EACXQ,IAAgB,EACD;EACf,MAAMX,CAAC,GAAG,MAAMd,mBAAmB,CAAC,CAAC;EACrC,OAAOc,CAAC,CAACU,WAAW,CAACP,GAAG,EAAEQ,IAAI,CAAC;AACjC;AAEA,OAAO,eAAeC,SAASA,CAACC,GAAW,EAAoB;EAC7D,MAAMb,CAAC,GAAG,MAAMd,mBAAmB,CAAC,CAAC;EACrC,OAAOc,CAAC,CAACY,SAAS,CAACC,GAAG,CAAC;AACzB;AAEA,IAAIC,MAAwC,GAAG,IAAI;AACnD,OAAO,SAASC,SAASA,CAAA,EAA8B;EACrD,IAAI,CAACD,MAAM,EAAE;IACXA,MAAM,GAAG,IAAI/B,yBAAyB,CAAC,CAAC;EAC1C;EAEA,OAAO+B,MAAM;AACf","ignoreList":[]}

package/lib/typescript/src/AmplitudeEngagement.d.ts

@@ -1,9 +1,9 @@
 import type { GuideOrSurvey, ThemeMode } from './types';
-import type { BaseEvent } from '@amplitude/analytics-types';
+import type { BaseEvent } from '@amplitude/analytics-core';
 export declare class AmplitudeEngagement {
     id: number;
     constructor(apiKey: string);
-    boot(user_id: string, device_id: string): void;
+    boot(user_id?: string, device_id?: string): void;
     setThemeMode(themeMode: ThemeMode): void;
     reset(key: string, stepIndex: number): void;
     list(): GuideOrSurvey[];

package/lib/typescript/src/AmplitudeEngagement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AmplitudeEngagement.d.ts","sourceRoot":"","sources":["../../../src/AmplitudeEngagement.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAW5D,qBAAa,mBAAmB;IAC9B,EAAE,EAAE,MAAM,CAAC;gBAEC,MAAM,EAAE,MAAM;IAK1B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAI9C,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAIxC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAI3C,IAAI,IAAI,aAAa,EAAE;IAIvB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAI1C,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIhC,QAAQ,IAAI,IAAI;IAIhB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAIpC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI;IAIhD,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAGhC"}
+{"version":3,"file":"AmplitudeEngagement.d.ts","sourceRoot":"","sources":["../../../src/AmplitudeEngagement.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAW3D,qBAAa,mBAAmB;IAC9B,EAAE,EAAE,MAAM,CAAC;gBAEC,MAAM,EAAE,MAAM;IAK1B,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAIhD,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAIxC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAI3C,IAAI,IAAI,aAAa,EAAE;IAIvB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAI1C,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIhC,QAAQ,IAAI,IAAI;IAIhB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAIpC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI;IAIhD,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAGhC"}

package/lib/typescript/src/AmplitudeEngagementPlugin.d.ts

@@ -1,10 +1,18 @@
-import type { Config, CoreClient, EnrichmentPlugin, Event } from '@amplitude/analytics-types';
+import type { Config, CoreClient, EnrichmentPlugin, Event } from '@amplitude/analytics-core';
 import { type AmplitudeLogger } from './logger';
+import type { EventSubscription } from 'react-native';
 export declare class AmplitudeEngagementPlugin implements EnrichmentPlugin {
     name: string;
     type: "enrichment";
+    client?: CoreClient;
+    userId?: string;
+    deviceId?: string;
+    sessionId?: number;
+    userProperties?: Record<string, any>;
     logger: AmplitudeLogger;
-    setup(config: Config, _client: CoreClient): Promise<void>;
+    trackEventSubscription: EventSubscription | null;
+    setup(config: Config, client: CoreClient): Promise<void>;
+    boot(user_id?: string, device_id?: string): void;
     execute(context: Event): Promise<Event | null>;
 }
 //# sourceMappingURL=AmplitudeEngagementPlugin.d.ts.map

package/lib/typescript/src/AmplitudeEngagementPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AmplitudeEngagementPlugin.d.ts","sourceRoot":"","sources":["../../../src/AmplitudeEngagementPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EACV,gBAAgB,EAChB,KAAK,EACN,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAU,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAExD,qBAAa,yBAA0B,YAAW,gBAAgB;IAChE,IAAI,SAA+B;IACnC,IAAI,EAAG,YAAY,CAAU;IAE7B,MAAM,EAAE,eAAe,CAA2C;IAE5D,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAczD,OAAO,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;CAiBrD"}
+{"version":3,"file":"AmplitudeEngagementPlugin.d.ts","sourceRoot":"","sources":["../../../src/AmplitudeEngagementPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EACV,gBAAgB,EAChB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAInC,OAAO,EAAU,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,qBAAa,yBAA0B,YAAW,gBAAgB;IAChE,IAAI,SAA+B;IACnC,IAAI,EAAG,YAAY,CAAU;IAE7B,MAAM,CAAC,EAAE,UAAU,CAAC;IAEpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAErC,MAAM,EAAE,eAAe,CAA2C;IAElE,sBAAsB,EAAE,iBAAiB,GAAG,IAAI,CAAQ;IAElD,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB9D,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAkB1C,OAAO,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;CAmBrD"}

package/lib/typescript/src/NativePluginEngagementReactNative.d.ts

@@ -1,8 +1,13 @@
 import type { TurboModule } from 'react-native';
 import type { GuideOrSurvey } from './types';
+import type { EventEmitter } from 'react-native/Libraries/Types/CodegenTypes';
+export type AnalyticsEvent = {
+    event_type: string;
+    event_properties: Object;
+};
 export interface Spec extends TurboModule {
     newInstance(apiKey: string): number;
-    boot(id: number, user_id: string, device_id: string): void;
+    boot(id: number, user_id?: string, device_id?: string): void;
     setThemeMode(id: number, themeMode: 'auto' | 'dark_mode' | 'light_mode'): void;
     reset(id: number, key: string, stepIndex: number): void;
     list(id: number): GuideOrSurvey[];
@@ -12,6 +17,7 @@ export interface Spec extends TurboModule {
     forwardEvent(id: number, event: Object): void;
     addCallback(id: number, key: string, func: () => void): void;
     handleURL(id: number, url: string): boolean;
+    readonly onTrackEvent: EventEmitter<AnalyticsEvent>;
 }
 declare const _default: Spec;
 export default _default;

package/lib/typescript/src/NativePluginEngagementReactNative.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativePluginEngagementReactNative.d.ts","sourceRoot":"","sources":["../../../src/NativePluginEngagementReactNative.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAEpC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3D,YAAY,CACV,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,YAAY,GAC7C,IAAI,CAAC;IACR,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAExD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,EAAE,CAAC;IAElC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACvD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAmB,IAAI,CAAC;IAC9D,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAE7D,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7C;;AAED,wBAEE"}
+{"version":3,"file":"NativePluginEngagementReactNative.d.ts","sourceRoot":"","sources":["../../../src/NativePluginEngagementReactNative.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAE9E,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AACF,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAEpC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7D,YAAY,CACV,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,YAAY,GAC7C,IAAI,CAAC;IACR,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAExD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,EAAE,CAAC;IAElC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACvD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAmB,IAAI,CAAC;IAC9D,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAE7D,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE5C,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;CACrD;;AAED,wBAEE"}

package/lib/typescript/src/index.d.ts

@@ -1,7 +1,8 @@
+import { AmplitudeEngagementPlugin } from './AmplitudeEngagementPlugin';
 import type { GuideOrSurvey } from './types';
-import type { BaseEvent, Plugin } from '@amplitude/analytics-types';
+import type { BaseEvent } from '@amplitude/analytics-core';
 export declare function init(apiKey: string): void;
-export declare function boot(user_id: string, device_id: string): Promise<void>;
+export declare function boot(user_id?: string, device_id?: string): Promise<void>;
 export declare function list(): Promise<GuideOrSurvey[]>;
 export declare function show(key: string, stepIndex: number): Promise<void>;
 export declare function screen(screenName: string): Promise<void>;
@@ -9,5 +10,5 @@ export declare function closeAll(): Promise<void>;
 export declare function forwardEvent(event: BaseEvent): Promise<void>;
 export declare function addCallback(key: string, func: () => void): Promise<void>;
 export declare function handleURL(url: string): Promise<boolean>;
-export declare function getPlugin(): Plugin;
+export declare function getPlugin(): AmplitudeEngagementPlugin;
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAiBpE,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAUzC;AAED,wBAAsB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5E;AAED,wBAAsB,IAAI,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAGrD;AAED,wBAAsB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxE;AAED,wBAAsB,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG9D;AAED,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAG9C;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE;AAED,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,IAAI,GACf,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG7D;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAiB3D,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAUzC;AAED,wBAAsB,IAAI,CACxB,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAsB,IAAI,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAGrD;AAED,wBAAsB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxE;AAED,wBAAsB,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG9D;AAED,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAG9C;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE;AAED,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,IAAI,GACf,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG7D;AAGD,wBAAgB,SAAS,IAAI,yBAAyB,CAMrD"}

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

@@ -4,4 +4,17 @@ export type GuideOrSurvey = {
     title: string;
 };
 export type ThemeMode = 'auto' | 'dark_mode' | 'light_mode';
+export type AmplitudeEndUser = {
+    user_id?: string;
+    device_id?: string;
+    user_properties: {
+        [key: string]: any;
+    };
+};
+export type AmplitudeBootOptions = {
+    user: AmplitudeEndUser;
+    integrations: ((eventType: string, eventProperties: {
+        [key: string]: any;
+    }) => void)[];
+};
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,YAAY,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,YAAY,CAAC;AAE5D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,YAAY,EAAE,CAAC,CACb,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,KACpC,IAAI,CAAC,EAAE,CAAC;CACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amplitude/plugin-engagement-react-native",
-  "version": "0.1.1-alpha.9",
+  "version": "0.2.0-alpha.1",
   "description": "Amplitude Engagement plugin for React Native",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -163,6 +163,6 @@
     "version": "0.50.3"
   },
   "dependencies": {
-    "@amplitude/analytics-types": "^1.3.5"
+    "@amplitude/analytics-core": "^2.12.3"
   }
 }

package/src/AmplitudeEngagement.ts

@@ -1,7 +1,7 @@
 import type { Spec } from './NativePluginEngagementReactNative';
 import { NativeModules } from 'react-native';
 import type { GuideOrSurvey, ThemeMode } from './types';
-import type { BaseEvent } from '@amplitude/analytics-types';
+import type { BaseEvent } from '@amplitude/analytics-core';
 
 type PluginEngagementReactNativeType = Exclude<Spec, 'getConstants'>;
 
@@ -20,7 +20,7 @@ export class AmplitudeEngagement {
     this.id = PluginEngagementReactNative.newInstance(apiKey);
   }
 
-  boot(user_id: string, device_id: string): void {
+  boot(user_id?: string, device_id?: string): void {
     PluginEngagementReactNative.boot(this.id, user_id, device_id);
   }
 

package/src/AmplitudeEngagementPlugin.ts

@@ -3,32 +3,69 @@ import type {
   CoreClient,
   EnrichmentPlugin,
   Event,
-} from '@amplitude/analytics-types';
-import { forwardEvent, init, screen } from '.';
+} from '@amplitude/analytics-core';
+import { forwardEvent, init, screen, boot } from '.';
+import NativePluginEngagementReactNative from './NativePluginEngagementReactNative';
+
 import { Logger, type AmplitudeLogger } from './logger';
+import type { EventSubscription } from 'react-native';
 
 export class AmplitudeEngagementPlugin implements EnrichmentPlugin {
   name = 'AmplitudeEngagementPlugin';
   type = 'enrichment' as const;
 
+  client?: CoreClient;
+
+  userId?: string;
+  deviceId?: string;
+  sessionId?: number;
+  userProperties?: Record<string, any>;
+
   logger: AmplitudeLogger = new Logger('AmplitudeEngagementPlugin');
 
-  async setup(config: Config, _client: CoreClient): Promise<void> {
+  trackEventSubscription: EventSubscription | null = null;
+
+  async setup(config: Config, client: CoreClient): Promise<void> {
     try {
-      console.log('initializing with apiKey', config.apiKey);
+      this.logger.log('initializing with apiKey', config.apiKey);
       init(config.apiKey);
+      this.client = client;
+      // TODO: grab identity from client when available -- need to wait until it's added.
+      // Need to wait until https://amplitude.atlassian.net/browse/AMP-133461 is resolved
+      // then; follow the same pattern as in the `AmplitudeEngagementPlugin` in the Swift/iOS code
     } catch (error) {
       this.logger.error(
         'AmplitudeEngagementPlugin#setup failed to initialize',
         error
       );
     }
+  }
+
+  // TODO: for now, you must call `boot()` manually
+  // but once we have access to the identity from the client,
+  // we can call `boot()` automatically in `setup` and `onIdentityChanged`
+  boot(user_id?: string, device_id?: string): void {
+    boot(user_id, device_id);
+    if (this.trackEventSubscription) {
+      this.trackEventSubscription.remove();
+    }
 
-    // TODO: call "boot" here -- but we don't have the user_id and device_id yet so we cannot
+    this.trackEventSubscription =
+      NativePluginEngagementReactNative.onTrackEvent((event) => {
+        if (!this.client) {
+          this.logger.error(
+            'AmplitudeEngagementPlugin#onIdentityChanged client is not initialized'
+          );
+          return;
+        }
+        this.client?.track(event.event_type, event.event_properties);
+      });
   }
 
   async execute(context: Event): Promise<Event | null> {
-    console.log(`AmplitudeEngagement#execute event=${JSON.stringify(context)}`);
+    this.logger.log(
+      `AmplitudeEngagement#execute event=${JSON.stringify(context)}`
+    );
 
     if (
       context.event_type === '[Amplitude] Screen Viewed' &&

package/src/NativePluginEngagementReactNative.ts

@@ -1,11 +1,16 @@
 import type { TurboModule } from 'react-native';
 import { TurboModuleRegistry } from 'react-native';
 import type { GuideOrSurvey } from './types';
+import type { EventEmitter } from 'react-native/Libraries/Types/CodegenTypes';
 
+export type AnalyticsEvent = {
+  event_type: string;
+  event_properties: Object;
+};
 export interface Spec extends TurboModule {
   newInstance(apiKey: string): number;
 
-  boot(id: number, user_id: string, device_id: string): void;
+  boot(id: number, user_id?: string, device_id?: string): void;
   setThemeMode(
     id: number,
     themeMode: 'auto' | 'dark_mode' | 'light_mode' /* ThemeMode */
@@ -21,6 +26,8 @@ export interface Spec extends TurboModule {
   addCallback(id: number, key: string, func: () => void): void;
 
   handleURL(id: number, url: string): boolean;
+
+  readonly onTrackEvent: EventEmitter<AnalyticsEvent>;
 }
 
 export default TurboModuleRegistry.getEnforcing<Spec>(

package/src/index.tsx

@@ -1,7 +1,7 @@
 import { AmplitudeEngagement } from './AmplitudeEngagement';
 import { AmplitudeEngagementPlugin } from './AmplitudeEngagementPlugin';
 import type { GuideOrSurvey } from './types';
-import type { BaseEvent, Plugin } from '@amplitude/analytics-types';
+import type { BaseEvent } from '@amplitude/analytics-core';
 
 let globalEngagement: AmplitudeEngagement = null as any;
 let toNotify: ((engagement: AmplitudeEngagement) => void)[] = [];
@@ -30,7 +30,10 @@ export function init(apiKey: string): void {
   toNotify = [];
 }
 
-export async function boot(user_id: string, device_id: string): Promise<void> {
+export async function boot(
+  user_id?: string,
+  device_id?: string
+): Promise<void> {
   const e = await getGlobalEngagement();
   return e.boot(user_id, device_id);
 }
@@ -73,6 +76,11 @@ export async function handleURL(url: string): Promise<boolean> {
   return e.handleURL(url);
 }
 
-export function getPlugin(): Plugin {
-  return new AmplitudeEngagementPlugin();
+let plugin: AmplitudeEngagementPlugin | null = null;
+export function getPlugin(): AmplitudeEngagementPlugin {
+  if (!plugin) {
+    plugin = new AmplitudeEngagementPlugin();
+  }
+
+  return plugin;
 }

package/src/types.ts

@@ -5,3 +5,17 @@ export type GuideOrSurvey = {
 };
 
 export type ThemeMode = 'auto' | 'dark_mode' | 'light_mode';
+
+export type AmplitudeEndUser = {
+  user_id?: string;
+  device_id?: string;
+  user_properties: { [key: string]: any };
+};
+
+export type AmplitudeBootOptions = {
+  user: AmplitudeEndUser;
+  integrations: ((
+    eventType: string,
+    eventProperties: { [key: string]: any }
+  ) => void)[];
+};