feat: react-native with web support

.gitignore

@@ -1,5 +1,7 @@
 node_modules/
 
+.DS_Store
+
 lib/
 *.tsbuildinfo
 coverage/

packages/analytics-browser/README.md

@@ -32,7 +32,7 @@ Alternatively, the package is also distributed through a CDN. Copy and paste the
 <!-- README_SNIPPET_BLOCK -->
 ```html
 <script type="text/javascript">
-!function(){"use strict";!function(e,t){var r=e.amplitude||{_q:[]};if(r.invoked)e.console&&console.error&&console.error("Amplitude snippet has been loaded.");else{r.invoked=!0;var n=t.createElement("script");n.type="text/javascript",n.integrity="sha384-GS6YJWyepBi+TL3uXx5i7xx1UTA9iHaZr9q+5uNsuhzMb8c1SfkKW4Wee/IxZOW5",n.crossOrigin="anonymous",n.async=!0,n.src="https://cdn.amplitude.com/libs/analytics-browser-1.0.0-min.js.gz",n.onload=function(){e.amplitude.runQueuedFunctions||console.log("[Amplitude] Error: could not load SDK")};var s=t.getElementsByTagName("script")[0];function v(e,t){e.prototype[t]=function(){return this._q.push({name:t,args:Array.prototype.slice.call(arguments,0)}),this}}s.parentNode.insertBefore(n,s);for(var o=function(){return this._q=[],this},i=["add","append","clearAll","prepend","set","setOnce","unset","preInsert","postInsert","remove","getUserProperties"],a=0;a<i.length;a++)v(o,i[a]);r.Identify=o;for(var u=function(){return this._q=[],this},c=["getEventProperties","setProductId","setQuantity","setPrice","setRevenue","setRevenueType","setEventProperties"],p=0;p<c.length;p++)v(u,c[p]);r.Revenue=u;var d=["getDeviceId","setDeviceId","regenerateDeviceId","getSessionId","setSessionId","getUserId","setUserId","setOptOut","setTransport"],l=["init","add","remove","track","logEvent","identify","groupIdentify","setGroup","revenue"];function f(e){function t(t,r){e[t]=function(){var n={promise:new Promise((r=>{e._q.push({name:t,args:Array.prototype.slice.call(arguments,0),resolve:r})}))};if(r)return n}}for(var r=0;r<d.length;r++)t(d[r],!1);for(var n=0;n<l.length;n++)t(l[n],!0)}f(r),e.amplitude=r}}(window,document)}();
+!function(){"use strict";!function(e,t){var r=e.amplitude||{_q:[]};if(r.invoked)e.console&&console.error&&console.error("Amplitude snippet has been loaded.");else{r.invoked=!0;var n=t.createElement("script");n.type="text/javascript",n.integrity="sha384-LRqQslnCLN5Y5/WML9z04UjXrLxTaaAlEcWCBN5yhzUYR+3bekPziHIuZlJCwBuk",n.crossOrigin="anonymous",n.async=!0,n.src="https://cdn.amplitude.com/libs/analytics-browser-0.6.1-min.js.gz",n.onload=function(){e.amplitude.runQueuedFunctions||console.log("[Amplitude] Error: could not load SDK")};var s=t.getElementsByTagName("script")[0];function v(e,t){e.prototype[t]=function(){return this._q.push({name:t,args:Array.prototype.slice.call(arguments,0)}),this}}s.parentNode.insertBefore(n,s);for(var o=function(){return this._q=[],this},i=["add","append","clearAll","prepend","set","setOnce","unset","preInsert","postInsert","remove","getUserProperties"],a=0;a<i.length;a++)v(o,i[a]);r.Identify=o;for(var u=function(){return this._q=[],this},c=["getEventProperties","setProductId","setQuantity","setPrice","setRevenue","setRevenueType","setEventProperties"],l=0;l<c.length;l++)v(u,c[l]);r.Revenue=u;var p=["getDeviceId","setDeviceId","regenerateDeviceId","getSessionId","setSessionId","getUserId","setUserId","setOptOut","setTransport"],d=["init","add","remove","track","logEvent","identify","groupIdentify","setGroup","revenue"];function f(e){function t(t,r){e[t]=function(){var n={promise:new Promise((r=>{e._q.push({name:t,args:Array.prototype.slice.call(arguments,0),resolve:r})}))};if(r)return n}}for(var r=0;r<p.length;r++)t(p[r],!1);for(var n=0;n<d.length;n++)t(d[n],!0)}f(r),e.amplitude=r}}(window,document)}();
 
 amplitude.init("YOUR_API_KEY_HERE");
 </script>

packages/analytics-react-native/.gitattributes

@@ -0,0 +1,3 @@
+*.pbxproj -text
+# specific for windows script files
+*.bat text eol=crlf

packages/analytics-react-native/.gitignore

@@ -0,0 +1,61 @@
+# OSX
+#
+.DS_Store
+
+# XDE
+.expo/
+
+# VSCode
+.vscode/
+jsconfig.json
+
+# Xcode
+#
+build/
+*.pbxuser
+!default.pbxuser
+*.mode1v3
+!default.mode1v3
+*.mode2v3
+!default.mode2v3
+*.perspectivev3
+!default.perspectivev3
+xcuserdata
+*.xccheckout
+*.moved-aside
+DerivedData
+*.hmap
+*.ipa
+*.xcuserstate
+project.xcworkspace
+
+# Android/IJ
+#
+.idea
+.gradle
+local.properties
+android.iml
+**/*/.project
+
+# Cocoapods
+#
+ios/Pods
+
+# node.js
+#
+node_modules/
+npm-debug.log
+yarn-debug.log
+yarn-error.log
+
+# BUCK
+buck-out/
+\.buckd/
+android/app/libs
+android/keystores/debug.keystore
+
+# Expo
+.expo/*
+
+# generated by bob
+lib/

packages/analytics-react-native/README.md

@@ -0,0 +1,152 @@
+<p align="center">
+  <a href="https://amplitude.com" target="_blank" align="center">
+    <img src="https://static.amplitude.com/lightning/46c85bfd91905de8047f1ee65c7c93d6fa9ee6ea/static/media/amplitude-logo-with-text.4fb9e463.svg" width="280">
+  </a>
+  <br />
+</p>
+
+# @amplitude/analytics-react-native
+
+Official Amplitude SDK for React Native (Beta)
+
+## Installation
+
+To get started with using Amplitude React Native SDK, install the package to your project via NPM or script loader.
+
+### Using Node package
+
+This package is published on NPM registry and is available to be installed using npm and yarn.
+
+```sh
+# npm
+npm install @amplitude/analytics-react-native
+
+# yarn
+yarn add @amplitude/analytics-react-native
+```
+
+## Usage
+
+### Initializing SDK
+
+Initialization is necessary before any instrumentation is done. The API key for your Amplitude project is required.
+
+```typescript
+amplitude.init(API_KEY)
+```
+
+### Tracking an Event
+
+Events represent how users interact with your application. For example, “Button Clicked” may be an action you want to note.
+
+```typescript
+import { track } from '@amplitude/analytics-react-native';
+
+// Track a basic event
+track('Button Clicked');
+
+// Track events with additional properties
+const eventProperties = {
+  selectedColors: ['red', 'blue'],
+};
+track('Button Clicked', eventProperties);
+```
+
+### User Properties
+
+User properties help you understand your users at the time they performed some action within your app such as their device details, their preferences, or language.
+
+```typescript
+import { Identify, identify } from '@amplitude/analytics-react-native';
+
+const event = new Identify();
+
+// sets the value of a user property
+event.set('key1', 'value1');
+
+// sets the value of a user property only once
+event.setOnce('key1', 'value1');
+
+// increments a user property by some numerical value.
+event.add('value1', 10);
+
+// pre inserts a value or values to a user property
+event.preInsert('ab-tests', 'new-user-test');
+
+// post inserts a value or values to a user property
+event.postInsert('ab-tests', 'new-user-test');
+
+// removes a value or values to a user property
+event.remove('ab-tests', 'new-user-test')
+
+// sends identify event
+identify(event);
+```
+
+### prepend/append
+
+* append will append a value or values to a user property array.
+* prepend will prepend a value or values to a user property.
+
+### User Groups
+
+```typescript
+import { setGroup } from '@amplitude/analytics-react-native';
+
+// set group with single group name
+setGroup('orgId', '15');
+
+// set group with multiple group names
+setGroup('sport', ['soccer', 'tennis']);
+```
+
+### Group Identify
+
+This feature is only available to Growth and Enterprise customers who have purchased the [Accounts add-on](https://amplitude.zendesk.com/hc/en-us/articles/115001765532).
+
+Use the Group Identify API to set or update properties of particular groups. However, these updates will only affect events going forward.
+
+```typescript
+import { Identify, groupIdentify } from '@amplitude/analytics-react-native';
+
+const groupType = 'plan';
+const groupName = 'enterprise';
+const event = new Identify()
+event.set('key1', 'value1');
+
+groupIdentify(groupType, groupName, identify);
+```
+
+### Track Revenue
+
+Revenue instances will store each revenue transaction and allow you to define several special revenue properties (such as 'revenueType', 'productIdentifier', etc.) that are used in Amplitude's Event Segmentation and Revenue LTV charts. These Revenue instance objects are then passed into `revenue` to send as revenue events to Amplitude. This allows us to automatically display data relevant to revenue in the platform. You can use this to track both in-app and non-in-app purchases.
+
+```typescript
+import { Revenue, revenue } from '@amplitude/analytics-react-native';
+
+const event = new Revenue()
+  .setProductId('com.company.productId')
+  .setPrice(3.99)
+  .setQuantity(3);
+
+revenue(event);
+```
+
+### Callback
+
+All asynchronous API are optionally awaitable through a specific Promise interface. This also serves as callback interface.
+
+```typescript
+// Using async/await
+const results = await track('Button Clicked').promise;
+result.event; // {...} (The final event object sent to Amplitude)
+result.code; // 200 (The HTTP response status code of the request.
+result.message; // "Event tracked successfully" (The response message)
+
+// Using promises
+track('Button Clicked').promise.then((result) => {
+  result.event; // {...} (The final event object sent to Amplitude)
+  result.code; // 200 (The HTTP response status code of the request.
+  result.message; // "Event tracked successfully" (The response message)
+});
+```

packages/analytics-react-native/amplitude-react-native.podspec

@@ -0,0 +1,21 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name = "amplitude-react-native"
+  s.version = package["version"]
+  s.summary = package["description"]
+  s.homepage = package["homepage"]
+  s.license = package["license"]
+  s.authors = package["author"]
+
+  s.swift_version = "5.0"
+
+  s.platforms = { :ios => "10.0", :tvos => "10.0" }
+  s.source = { :git => "https://github.com/amplitude/Amplitude-TypeScript.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift}"
+
+  s.dependency "React-Core"
+end

packages/analytics-react-native/android/build.gradle

@@ -0,0 +1,59 @@
+buildscript {
+    ext.kotlinVersion = "1.5.30"
+    repositories {
+        google()
+        jcenter()
+    }
+
+    dependencies {
+        classpath 'com.android.tools.build:gradle:3.5.3'
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlinVersion"
+    }
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+
+def safeExtGet(prop, fallback) {
+    rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+}
+
+android {
+    compileSdkVersion safeExtGet('compileSdkVersion', 29)
+    buildToolsVersion safeExtGet('buildToolsVersion', '29.0.2')
+    defaultConfig {
+        minSdkVersion safeExtGet('minSdkVersion', 16)
+        targetSdkVersion safeExtGet('targetSdkVersion', 29)
+        versionCode 1
+        versionName "1.0"
+
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+        }
+    }
+    lintOptions {
+        disable 'GradleCompatible'
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+}
+
+repositories {
+    mavenLocal()
+    maven {
+        // All of React Native (JS, Obj-C sources, Android binaries) is installed from npm
+        url("$rootDir/../node_modules/react-native/android")
+    }
+    google()
+    jcenter()
+}
+
+dependencies {
+    //noinspection GradleDynamicVersion
+    implementation "com.facebook.react:react-native:+"  // From node_modules
+}

packages/analytics-react-native/android/gradle.properties

@@ -0,0 +1,3 @@
+android.useAndroidX=true
+android.enableJetifier=true
+kotlin.code.style=official

packages/analytics-react-native/android/src/main/AndroidManifest.xml

@@ -0,0 +1,4 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+          package="com.amplitude.reactnative">
+  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
+</manifest>

packages/analytics-react-native/android/src/main/java/com/amplitude/reactnative/AmplitudeReactNativeModule.kt

@@ -0,0 +1,36 @@
+package com.amplitude.reactnative
+
+import com.facebook.react.bridge.Promise
+import com.facebook.react.module.annotations.ReactModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.bridge.ReadableMap
+import com.facebook.react.bridge.WritableNativeMap
+
+const val MODULE_NAME = "AmplitudeReactNative"
+
+@ReactModule(name = MODULE_NAME)
+class AmplitudeReactNativeModule(private val reactContext: ReactApplicationContext) : ReactContextBaseJavaModule(reactContext) {
+
+    private val androidContextProvider = AndroidContextProvider(reactContext.applicationContext, false)
+
+    override fun getName(): String {
+        return MODULE_NAME
+    }
+
+    @ReactMethod
+    private fun getApplicationContext(promise: Promise) {
+        promise.resolve(WritableNativeMap().apply {
+            putString("version", androidContextProvider.versionName)
+            putString("platform", androidContextProvider.osName)
+            putString("language", androidContextProvider.language)
+            putString("os_name", androidContextProvider.osName)
+            putString("os_version", androidContextProvider.osVersion)
+            putString("device_brand", androidContextProvider.brand)
+            putString("device_manufacturer", androidContextProvider.manufacturer)
+            putString("device_model", androidContextProvider.model)
+            putString("carrier", androidContextProvider.carrier)
+        })
+    }
+}

packages/analytics-react-native/android/src/main/java/com/amplitude/reactnative/AmplitudeReactNativePackage.java

@@ -0,0 +1,28 @@
+package com.amplitude.reactnative;
+
+import androidx.annotation.NonNull;
+
+import com.facebook.react.ReactPackage;
+import com.facebook.react.bridge.NativeModule;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.uimanager.ViewManager;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+
+public class AmplitudeReactNativePackage implements ReactPackage {
+    @NonNull
+    @Override
+    public List<NativeModule> createNativeModules(@NonNull ReactApplicationContext reactContext) {
+        List<NativeModule> modules = new ArrayList<>();
+        modules.add(new AmplitudeReactNativeModule(reactContext));
+        return modules;
+    }
+
+    @NonNull
+    @Override
+    public List<ViewManager> createViewManagers(@NonNull ReactApplicationContext reactContext) {
+        return Collections.emptyList();
+    }
+}