@amplitude/analytics-react-native 0.5.1 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amplitude/analytics-react-native",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Official React Native SDK",
   "keywords": [
     "analytics",
@@ -57,9 +57,9 @@
     "url": "https://github.com/amplitude/Amplitude-TypeScript/issues"
   },
   "dependencies": {
-    "@amplitude/analytics-client-common": "^0.4.0",
-    "@amplitude/analytics-core": "^0.10.0",
-    "@amplitude/analytics-types": "^0.12.0",
+    "@amplitude/analytics-client-common": "^0.4.1",
+    "@amplitude/analytics-core": "^0.10.1",
+    "@amplitude/analytics-types": "^0.13.0",
     "@amplitude/ua-parser-js": "^0.7.31",
     "@react-native-async-storage/async-storage": "^1.17.7",
     "tslib": "^2.3.1"
@@ -89,5 +89,5 @@
       ]
     ]
   },
-  "gitHead": "c3ea56594ea49edd5d63f67bdc4223e6ae5be9b2"
+  "gitHead": "c67ec6c06b029eaeaa01ffbe14852334bee9370c"
 }

package/src/config.ts

@@ -43,6 +43,7 @@ export const getDefaultConfig = () => {
     storageProvider: new MemoryStorage<Event[]>(),
     trackingOptions,
     transportProvider: new FetchTransport(),
+    trackingSessionEvents: false,
   };
 };
 
@@ -58,6 +59,7 @@ export class ReactNativeConfig extends Config implements IReactNativeConfig {
   sessionTimeout: number;
   trackingOptions: ReactNativeTrackingOptions;
   sessionManager: ISessionManager;
+  trackingSessionEvents: boolean;
 
   constructor(apiKey: string, userId?: string, options?: ReactNativeOptions) {
     const defaultConfig = getDefaultConfig();
@@ -87,6 +89,7 @@ export class ReactNativeConfig extends Config implements IReactNativeConfig {
     this.sessionId = options?.sessionId;
     this.trackingOptions = options?.trackingOptions ?? defaultConfig.trackingOptions;
     this.userId = userId;
+    this.trackingSessionEvents = options?.trackingSessionEvents ?? defaultConfig.trackingSessionEvents;
   }
 
   get deviceId() {

package/src/plugins/context.ts

@@ -55,15 +55,6 @@ export class Context implements BeforePlugin {
   }
 
   async execute(context: Event): Promise<Event> {
-    /**
-     * Manages user session triggered by new events
-     */
-    if (!this.isSessionValid()) {
-      // Creates new session
-      this.config.sessionId = Date.now();
-    } // else use previously creates session
-    // Updates last event time to extend time-based session
-    this.config.lastEventTime = Date.now();
     const time = new Date().getTime();
     const nativeContext = await this.nativeModule?.getApplicationContext();
     const appVersion = nativeContext?.version || this.config.appVersion;
@@ -106,10 +97,4 @@ export class Context implements BeforePlugin {
     };
     return event;
   }
-
-  isSessionValid() {
-    const lastEventTime = this.config.lastEventTime || Date.now();
-    const timeSinceLastEvent = Date.now() - lastEventTime;
-    return timeSinceLastEvent < this.config.sessionTimeout;
-  }
 }

package/src/react-native-client.ts

@@ -1,3 +1,4 @@
+import { AppState, AppStateStatus } from 'react-native';
 import {
   AmplitudeCore,
   Destination,
@@ -16,19 +17,28 @@ import {
   ReactNativeClient,
   Identify as IIdentify,
   EventOptions,
+  Event,
+  Result,
 } from '@amplitude/analytics-types';
 import { Context } from './plugins/context';
 import { useReactNativeConfig, createFlexibleStorage } from './config';
 import { parseOldCookies } from './cookie-migration';
 import { isNative } from './utils/platform';
 
+const START_SESSION_EVENT = 'session_start';
+const END_SESSION_EVENT = 'session_end';
+
 export class AmplitudeReactNative extends AmplitudeCore<ReactNativeConfig> {
+  appState: AppStateStatus = 'background';
+  explicitSessionId: number | undefined;
+
   async init(apiKey = '', userId?: string, options?: ReactNativeOptions) {
     // Step 0: Block concurrent initialization
     if (this.initializing) {
       return;
     }
     this.initializing = true;
+    this.explicitSessionId = options?.sessionId;
 
     // Step 1: Read cookies stored by old SDK
     const oldCookies = await parseOldCookies(apiKey, options);
@@ -37,25 +47,12 @@ export class AmplitudeReactNative extends AmplitudeCore<ReactNativeConfig> {
     const reactNativeOptions = await useReactNativeConfig(apiKey, userId || oldCookies.userId, {
       ...options,
       deviceId: oldCookies.deviceId ?? options?.deviceId,
-      sessionId: oldCookies.sessionId ?? options?.sessionId,
+      sessionId: oldCookies.sessionId,
       optOut: options?.optOut ?? oldCookies.optOut,
       lastEventTime: oldCookies.lastEventTime,
     });
     await super._init(reactNativeOptions);
 
-    // Step 3: Manage session
-    let isNewSession = !this.config.lastEventTime;
-    if (
-      !this.config.sessionId ||
-      (this.config.lastEventTime && Date.now() - this.config.lastEventTime > this.config.sessionTimeout)
-    ) {
-      // Either
-      // 1) No previous session; or
-      // 2) Previous session expired
-      this.setSessionId(Date.now());
-      isNewSession = true;
-    }
-
     // Set up the analytics connector to integrate with the experiment SDK.
     // Send events from the experiment SDK and forward identifies to the
     // identity store.
@@ -68,27 +65,36 @@ export class AmplitudeReactNative extends AmplitudeCore<ReactNativeConfig> {
       deviceId: this.config.deviceId,
     });
 
-    // Step 4: Install plugins
+    // Step 3: Install plugins
     // Do not track any events before this
     await this.add(new Context());
     await this.add(new IdentityEventSender());
     await this.add(new Destination());
 
+    // Step 4: Manage session
+    this.appState = AppState.currentState;
+    const isNewSession = this.startNewSessionIfNeeded();
+    AppState.addEventListener('change', this.handleAppStateChange);
+
     this.initializing = false;
 
     // Step 5: Track attributions
     await this.runAttributionStrategy(options?.attribution, isNewSession);
 
-    // Step 6: Run queued dispatch functions
+    // Step 6: Run queued functions
     await this.runQueuedFunctions('dispatchQ');
   }
 
+  shutdown() {
+    AppState.removeEventListener('change', this.handleAppStateChange);
+  }
+
   async runAttributionStrategy(attributionConfig?: AttributionOptions, isNewSession = false) {
     if (isNative()) {
       return;
     }
     const track = this.track.bind(this);
-    const onNewCampaign = this.setSessionId.bind(this, Date.now());
+    const onNewCampaign = this.setSessionId.bind(this, this.currentTimeMillis());
 
     const storage = await createFlexibleStorage<Campaign>(this.config);
     const campaignTracker = new CampaignTracker(this.config.apiKey, {
@@ -161,8 +167,98 @@ export class AmplitudeReactNative extends AmplitudeCore<ReactNativeConfig> {
       this.q.push(this.setSessionId.bind(this, sessionId));
       return;
     }
+
+    this.explicitSessionId = sessionId;
+    void this.setSessionIdInternal(sessionId, this.currentTimeMillis());
+  }
+
+  private setSessionIdInternal(sessionId: number, eventTime: number) {
+    const previousSessionId = this.config.sessionId;
+    if (previousSessionId === sessionId) {
+      return;
+    }
+
     this.config.sessionId = sessionId;
+
+    if (this.config.trackingSessionEvents) {
+      if (previousSessionId !== undefined) {
+        const sessionEndEvent: Event = {
+          event_type: END_SESSION_EVENT,
+          time: this.config.lastEventTime !== undefined ? this.config.lastEventTime + 1 : sessionId, // increment lastEventTime to sort events properly in UI - session_end should be the last event in a session
+          session_id: previousSessionId,
+        };
+        void this.track(sessionEndEvent);
+      }
+
+      const sessionStartEvent: Event = {
+        event_type: START_SESSION_EVENT,
+        time: eventTime,
+        session_id: sessionId,
+      };
+      void this.track(sessionStartEvent);
+    }
+
+    this.config.lastEventTime = eventTime;
   }
+
+  async process(event: Event): Promise<Result> {
+    if (!this.config.optOut) {
+      const eventTime = event.time ?? this.currentTimeMillis();
+      if (event.time === undefined) {
+        event = { ...event, time: eventTime };
+      }
+
+      if (event.event_type != START_SESSION_EVENT && event.event_type != END_SESSION_EVENT) {
+        if (this.appState !== 'active') {
+          this.startNewSessionIfNeeded(eventTime);
+        }
+      }
+      this.config.lastEventTime = eventTime;
+
+      if (event.session_id == undefined) {
+        event.session_id = this.getSessionId();
+      }
+    }
+
+    return super.process(event);
+  }
+
+  currentTimeMillis() {
+    return Date.now();
+  }
+
+  private startNewSessionIfNeeded(eventTime?: number): boolean {
+    eventTime = eventTime ?? this.currentTimeMillis();
+    const sessionId = this.explicitSessionId ?? eventTime;
+
+    if (
+      this.inSession() &&
+      (this.explicitSessionId === this.config.sessionId ||
+        (this.explicitSessionId === undefined && this.isWithinMinTimeBetweenSessions(sessionId)))
+    ) {
+      this.config.lastEventTime = eventTime;
+      return false;
+    }
+
+    this.setSessionIdInternal(sessionId, eventTime);
+    return true;
+  }
+
+  private isWithinMinTimeBetweenSessions(eventTime: number) {
+    return eventTime - (this.config.lastEventTime ?? 0) < this.config.sessionTimeout;
+  }
+
+  private inSession() {
+    return this.config.sessionId != undefined;
+  }
+
+  private readonly handleAppStateChange = (nextAppState: AppStateStatus) => {
+    const currentAppState = this.appState;
+    this.appState = nextAppState;
+    if (currentAppState !== nextAppState && nextAppState === 'active') {
+      this.startNewSessionIfNeeded();
+    }
+  };
 }
 
 export const createInstance = (): ReactNativeClient => {

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.5.1';
+export const VERSION = '0.6.0';

package/lib/typescript/config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,kBAAkB,EAClB,iBAAiB,IAAI,kBAAkB,EACvC,OAAO,EACP,0BAA0B,EAC1B,WAAW,EACX,cAAc,IAAI,eAAe,EAClC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAQ,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAIL,cAAc,EACd,cAAc,EACf,MAAM,oCAAoC,CAAC;AAI5C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;CA0B5B,CAAC;AAEF,qBAAa,iBAAkB,SAAQ,MAAO,YAAW,kBAAkB;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,0BAA0B,CAAC;IAC5C,cAAc,EAAE,eAAe,CAAC;gBAEpB,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB;IA8BzE,IAAI,QAAQ,IAIW,MAAM,GAAG,SAAS,CAFxC;IAED,IAAI,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAExC;IAED,IAAI,MAAM,IAIS,MAAM,GAAG,SAAS,CAFpC;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAEpC;IAED,IAAI,SAAS,IAIY,MAAM,GAAG,SAAS,CAF1C;IAED,IAAI,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAE1C;IAED,IAAI,MAAM,IAIS,OAAO,CAFzB;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,EAEzB;IAED,IAAI,aAAa,IAIgB,MAAM,GAAG,SAAS,CAFlD;IAED,IAAI,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,EAElD;CACF;AAED,eAAO,MAAM,oBAAoB,WACvB,MAAM,4EAGb,QAAQ,kBAAkB,CAqB5B,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;MAG7B,QAAQ,QAAQ,WAAW,CAAC,CAO9B,CAAC;AAEF,eAAO,MAAM,qBAAqB,eAAsB,kBAAkB,wBAczE,CAAC;AAEF,eAAO,MAAM,mBAAmB,kDAA2C,QAAQ,QAAQ,KAAK,EAAE,CAAC,GAAG,SAAS,CAe9G,CAAC;AAEF,eAAO,MAAM,cAAc,4HAE1B,CAAC;AAEF,eAAO,MAAM,iBAAiB,+CA0B7B,CAAC"}

package/lib/typescript/cookie-migration/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cookie-migration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAW,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAIlF,eAAO,MAAM,eAAe,WAAkB,MAAM,2CAA6B,QAAQ,WAAW,CA6BnG,CAAC;AAEF,eAAO,MAAM,SAAS,QAAS,MAAM,uBAMpC,CAAC;AAEF,eAAO,MAAM,MAAM,kCAAqB,MAAM,GAAG,SAShD,CAAC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,eAAO,MACL,GAAG,yDACH,KAAK,qCACL,WAAW,4BACX,YAAY,4BACZ,SAAS,4BACT,aAAa,qKACb,QAAQ,oHACR,IAAI,gIACJ,QAAQ,mLACR,MAAM,uDACN,KAAK,cACL,OAAO,kHACP,WAAW,8BACX,QAAQ,2IACR,SAAS,6BACT,YAAY,+BACZ,SAAS,wCACT,KAAK,iLACG,CAAC;AACX,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,KAAK,KAAK,MAAM,4BAA4B,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/lib/typescript/plugins/context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/plugins/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAChG,OAAO,QAAQ,MAAM,yBAAyB,CAAC;AAS/C,aAAK,aAAa,GAAG;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,qBAAqB,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CACjD;AAED,qBAAa,OAAQ,YAAW,YAAY;IAC1C,IAAI,SAAa;IACjB,IAAI,oBAA8B;IAKlC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,SAAK;IACZ,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC;IAC3B,YAAY,EAAE,oBAAoB,GAAG,SAAS,CAEhC;IACd,OAAO,SAA0C;;IAWjD,KAAK,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC;IAK9C,OAAO,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAqD7C,cAAc;CAKf"}

package/lib/typescript/react-native-client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"react-native-client.d.ts","sourceRoot":"","sources":["../../src/react-native-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAOd,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,iBAAiB,EAEjB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,IAAI,SAAS,EACrB,YAAY,EACb,MAAM,4BAA4B,CAAC;AAMpC,qBAAa,oBAAqB,SAAQ,aAAa,CAAC,iBAAiB,CAAC;IAClE,IAAI,CAAC,MAAM,SAAK,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB;IA4D/D,sBAAsB,CAAC,iBAAiB,CAAC,EAAE,kBAAkB,EAAE,YAAY,UAAQ;IAkBzF,SAAS;IAIT,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAcpC,WAAW;IAIX,WAAW,CAAC,QAAQ,EAAE,MAAM;IAc5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,YAAY,CAAC,EAAE,YAAY;IAUzD,KAAK;IAKL,YAAY;IAIZ,YAAY,CAAC,SAAS,EAAE,MAAM;CAO/B;AAED,eAAO,MAAM,cAAc,QAAO,iBAgHjC,CAAC;;AAEF,wBAAgC"}

package/lib/typescript/storage/local-storage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"local-storage.d.ts","sourceRoot":"","sources":["../../../src/storage/local-storage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAGrD,qBAAa,YAAY,CAAC,CAAC,CAAE,YAAW,OAAO,CAAC,CAAC,CAAC;IAC1C,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAqB7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAcxC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAIhD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}

package/lib/typescript/utils/platform.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../../src/utils/platform.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,KAAK,QAAO,OAExB,CAAC;AAEF,eAAO,MAAM,QAAQ,QAAO,OAE3B,CAAC"}

package/lib/typescript/version.d.ts

@@ -1,2 +0,0 @@
-export declare const VERSION = "0.5.1";
-//# sourceMappingURL=version.d.ts.map

package/lib/typescript/version.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}