posthog-react-native 2.1.3 → 2.2.0-alpha1

package/lib/index.esm.js

@@ -1,8 +1,4 @@
 import { Platform, Dimensions, AppState, View } from 'react-native';
-import * as ExpoApplication from 'expo-application';
-import * as ExpoDevice from 'expo-device';
-import * as ExpoLocalization from 'expo-localization';
-import * as FileSystem from 'expo-file-system';
 import React, { useRef, useEffect, useState, useCallback } from 'react';
 
 /******************************************************************************
@@ -742,6 +738,26 @@ var PostHogCore = /** @class */ (function () {
         }
         return __assign({ $lib: this.getLibraryId(), $lib_version: this.getLibraryVersion(), $active_feature_flags: featureFlags ? Object.keys(featureFlags) : undefined }, featureVariantProperties);
     };
+    PostHogCore.prototype.setupBootstrap = function (options) {
+        var _a, _b, _c, _d;
+        if ((_a = options === null || options === void 0 ? void 0 : options.bootstrap) === null || _a === void 0 ? void 0 : _a.distinctId) {
+            if ((_b = options === null || options === void 0 ? void 0 : options.bootstrap) === null || _b === void 0 ? void 0 : _b.isIdentifiedId) {
+                this.setPersistedProperty(PostHogPersistedProperty.DistinctId, options.bootstrap.distinctId);
+            }
+            else {
+                this.setPersistedProperty(PostHogPersistedProperty.AnonymousId, options.bootstrap.distinctId);
+            }
+        }
+        if ((_c = options === null || options === void 0 ? void 0 : options.bootstrap) === null || _c === void 0 ? void 0 : _c.featureFlags) {
+            var activeFlags = Object.keys(((_d = options.bootstrap) === null || _d === void 0 ? void 0 : _d.featureFlags) || {})
+                .filter(function (flag) { var _a, _b; return !!((_b = (_a = options.bootstrap) === null || _a === void 0 ? void 0 : _a.featureFlags) === null || _b === void 0 ? void 0 : _b[flag]); })
+                .reduce(function (res, key) {
+                var _a, _b;
+                return ((res[key] = ((_b = (_a = options.bootstrap) === null || _a === void 0 ? void 0 : _a.featureFlags) === null || _b === void 0 ? void 0 : _b[key]) || false), res);
+            }, {});
+            this.setKnownFeatureFlags(activeFlags);
+        }
+    };
     Object.defineProperty(PostHogCore.prototype, "props", {
         // NOTE: Props are lazy loaded from localstorage hence the complex getter setter logic
         get: function () {
@@ -985,8 +1001,7 @@ var PostHogCore = /** @class */ (function () {
                     .then(function (r) { return r.json(); })
                     .then(function (res) {
                     if (res.featureFlags) {
-                        _this.setPersistedProperty(PostHogPersistedProperty.FeatureFlags, res.featureFlags);
-                        _this._events.emit('featureflags', res.featureFlags);
+                        _this.setKnownFeatureFlags(res.featureFlags);
                     }
                     return res;
                 })
@@ -997,6 +1012,10 @@ var PostHogCore = /** @class */ (function () {
             });
         });
     };
+    PostHogCore.prototype.setKnownFeatureFlags = function (featureFlags) {
+        this.setPersistedProperty(PostHogPersistedProperty.FeatureFlags, featureFlags);
+        this._events.emit('featureflags', featureFlags);
+    };
     PostHogCore.prototype.getFeatureFlag = function (key) {
         var featureFlags = this.getFeatureFlags();
         if (!featureFlags) {
@@ -1224,6 +1243,22 @@ var PostHogMemoryStorage = /** @class */ (function () {
     return PostHogMemoryStorage;
 }());
 
+var _OptionalExpoApplication = undefined;
+
+try {
+  _OptionalExpoApplication = require('expo-application');
+} catch (e) {}
+
+var OptionalExpoApplication = _OptionalExpoApplication;
+
+var _OptionalExpoFileSystem = undefined;
+
+try {
+  _OptionalExpoFileSystem = require('expo-file-system');
+} catch (e) {}
+
+var OptionalExpoFileSystem = _OptionalExpoFileSystem;
+
 var getLegacyValues = function () {
   return __awaiter(void 0, void 0, void 0, function () {
     var posthogFileDirectory, posthogDistinctIdFile, posthogAnonymousIdFile, res, _a, _b, _c, _d, _e, _f;
@@ -1231,10 +1266,18 @@ var getLegacyValues = function () {
     return __generator(this, function (_g) {
       switch (_g.label) {
         case 0:
+          // NOTE: The old react-native lib stored data in files on the filesystem.
+          // This function takes care of pulling the legacy IDs to ensure we are using them if already present
+          if (!OptionalExpoFileSystem || !OptionalExpoApplication) {
+            return [2
+            /*return*/
+            ];
+          }
+
           if (!(Platform.OS === 'ios')) return [3
           /*break*/
           , 8];
-          posthogFileDirectory = "".concat(FileSystem.documentDirectory, "../Library/Application%20Support/").concat(ExpoApplication.applicationId, "/");
+          posthogFileDirectory = "".concat(OptionalExpoFileSystem.documentDirectory, "../Library/Application%20Support/").concat(OptionalExpoApplication.applicationId, "/");
           posthogDistinctIdFile = posthogFileDirectory + 'posthog.distinctId';
           posthogAnonymousIdFile = posthogFileDirectory + 'posthog.anonymousId';
           res = {
@@ -1250,7 +1293,7 @@ var getLegacyValues = function () {
           _c = (_b = JSON).parse;
           return [4
           /*yield*/
-          , FileSystem.readAsStringAsync(posthogDistinctIdFile)];
+          , OptionalExpoFileSystem.readAsStringAsync(posthogDistinctIdFile)];
 
         case 2:
           _a.distinctId = _c.apply(_b, [_g.sent()])['posthog.distinctId'];
@@ -1271,7 +1314,7 @@ var getLegacyValues = function () {
           _f = (_e = JSON).parse;
           return [4
           /*yield*/
-          , FileSystem.readAsStringAsync(posthogAnonymousIdFile)];
+          , OptionalExpoFileSystem.readAsStringAsync(posthogAnonymousIdFile)];
 
         case 5:
           _d.anonymousId = _f.apply(_e, [_g.sent()])['posthog.anonymousId'];
@@ -1300,115 +1343,222 @@ var getLegacyValues = function () {
 };
 
 var POSTHOG_STORAGE_KEY = '.posthog-rn.json';
-var POSTHOG_STORAGE_VERSION = 'v1';
-
-var loadStorageAsync = function () {
-  return __awaiter(void 0, void 0, void 0, function () {
-    var uri, stringContent;
-    return __generator(this, function (_a) {
-      switch (_a.label) {
-        case 0:
-          uri = FileSystem.documentDirectory + POSTHOG_STORAGE_KEY;
-          _a.label = 1;
+var POSTHOG_STORAGE_VERSION = 'v1'; // NOTE: The core prefers a synchronous storage so we mimic this by pre-loading all keys
 
-        case 1:
-          _a.trys.push([1, 3,, 4]);
+var SemiAsyncStorage =
+/** @class */
+function () {
+  function SemiAsyncStorage(asyncStorage) {
+    this._memoryCache = {};
+    this._asyncStorage = asyncStorage;
+  }
 
-          return [4
-          /*yield*/
-          , FileSystem.readAsStringAsync(uri)];
+  SemiAsyncStorage.prototype.preloadAsync = function () {
+    var _this = this;
 
-        case 2:
-          stringContent = _a.sent();
-          return [2
-          /*return*/
-          , JSON.parse(stringContent).content];
+    if (this._preloadSemiAsyncStoragePromise) {
+      return this._preloadSemiAsyncStoragePromise;
+    }
 
-        case 3:
-          _a.sent();
-          return [2
-          /*return*/
-          , {}];
+    this._preloadSemiAsyncStoragePromise = this._asyncStorage.getItem(POSTHOG_STORAGE_KEY).then(function (res) {
+      try {
+        var data = res ? JSON.parse(res).content : {};
 
-        case 4:
-          return [2
-          /*return*/
-          ];
+        for (var key in data) {
+          _this._memoryCache[key] = _this._memoryCache[key] === undefined ? data[key] : _this._memoryCache[key];
+        }
+      } catch (e) {
+        console.warn("PostHog failed to load persisted data from storage. This is likely because the storage format is. We'll reset the storage.", e);
       }
     });
-  });
-};
+    return this._preloadSemiAsyncStoragePromise;
+  };
 
-var persitStorageAsync = function (content) {
-  return __awaiter(void 0, void 0, void 0, function () {
-    var uri, data;
-    return __generator(this, function (_a) {
-      switch (_a.label) {
-        case 0:
-          uri = FileSystem.documentDirectory + POSTHOG_STORAGE_KEY;
-          data = {
-            version: POSTHOG_STORAGE_VERSION,
-            content: content
-          };
-          return [4
-          /*yield*/
-          , FileSystem.writeAsStringAsync(uri, JSON.stringify(data)).catch(function (e) {
-            console.error('PostHog failed to persist data to storage', e);
-          })];
+  SemiAsyncStorage.prototype.persist = function () {
+    var payload = {
+      version: POSTHOG_STORAGE_VERSION,
+      content: this._memoryCache
+    };
+    void this._asyncStorage.setItem(POSTHOG_STORAGE_KEY, JSON.stringify(payload));
+  };
 
-        case 1:
-          _a.sent();
+  SemiAsyncStorage.prototype.getItem = function (key) {
+    return this._memoryCache[key];
+  };
 
-          return [2
-          /*return*/
-          ];
-      }
-    });
-  });
-}; // NOTE: The core prefers a synchronous storage so we mimic this by pre-loading all keys
-
-
-var _memoryCache = {};
-var SemiAsyncStorage = {
-  getItem: function (key) {
-    return _memoryCache[key];
-  },
-  setItem: function (key, value) {
-    _memoryCache[key] = value;
-    void persitStorageAsync(_memoryCache);
-  },
-  removeItem: function (key) {
-    delete _memoryCache[key];
-    void persitStorageAsync(_memoryCache);
-  },
-  clear: function () {
-    for (var key in _memoryCache) {
-      delete _memoryCache[key];
+  SemiAsyncStorage.prototype.setItem = function (key, value) {
+    this._memoryCache[key] = value;
+    this.persist();
+  };
+
+  SemiAsyncStorage.prototype.removeItem = function (key) {
+    delete this._memoryCache[key];
+    this.persist();
+  };
+
+  SemiAsyncStorage.prototype.clear = function () {
+    for (var key in this._memoryCache) {
+      delete this._memoryCache[key];
     }
 
-    void persitStorageAsync(_memoryCache);
-  },
-  getAllKeys: function () {
-    return Object.keys(_memoryCache);
-  }
+    this.persist();
+  };
+
+  SemiAsyncStorage.prototype.getAllKeys = function () {
+    return Object.keys(this._memoryCache);
+  };
+
+  return SemiAsyncStorage;
+}();
+
+var version = "2.2.0-alpha1";
+
+var warn = function (name) {
+  console.warn("PostHog: Missing ".concat(name, " optional dependency. Some functions may not work as expected..."));
 };
 
-var _preloadSemiAsyncStoragePromise;
+var _OptionalAsyncStorage = undefined;
+
+try {
+  _OptionalAsyncStorage = require('@react-native-async-storage/async-storage').default;
+} catch (e) {
+  warn('@react-native-async-storage/async-storage');
+}
+
+var OptionalAsyncStorage = _OptionalAsyncStorage;
+
+var _OptionalExpoDevice = undefined;
+
+try {
+  _OptionalExpoDevice = require('expo-device');
+} catch (e) {}
+
+var OptionalExpoDevice = _OptionalExpoDevice;
 
-var preloadSemiAsyncStorage = function () {
-  if (_preloadSemiAsyncStoragePromise) {
-    return _preloadSemiAsyncStoragePromise;
+var _OptionalExpoLocalization = undefined;
+
+try {
+  _OptionalExpoLocalization = require('expo-localization');
+} catch (e) {}
+
+var OptionalExpoLocalization = _OptionalExpoLocalization;
+
+var _OptionalReactNativeDeviceInfo = undefined;
+
+try {
+  _OptionalReactNativeDeviceInfo = require('react-native-device-info');
+} catch (e) {
+  warn('react-native-device-info');
+}
+
+var OptionalReactNativeDeviceInfo = _OptionalReactNativeDeviceInfo;
+
+var getAppProperties = function () {
+  var properties = {};
+
+  if (OptionalExpoApplication) {
+    properties.$app_build = OptionalExpoApplication.nativeBuildVersion;
+    properties.$app_name = OptionalExpoApplication.applicationName;
+    properties.$app_namespace = OptionalExpoApplication.applicationId;
+    properties.$app_version = OptionalExpoApplication.nativeApplicationVersion;
   }
 
-  _preloadSemiAsyncStoragePromise = loadStorageAsync().then(function (res) {
-    for (var key in res) {
-      _memoryCache[key] = res[key];
-    }
-  });
-  return _preloadSemiAsyncStoragePromise;
+  if (OptionalExpoDevice) {
+    properties.$device_manufacturer = OptionalExpoDevice.manufacturer;
+    properties.$device_name = OptionalExpoDevice.modelName;
+    properties.$os_name = OptionalExpoDevice.osName;
+    properties.$os_version = OptionalExpoDevice.osVersion;
+  }
+
+  if (OptionalExpoLocalization) {
+    properties.$locale = OptionalExpoLocalization.locale;
+    properties.$timezone = OptionalExpoLocalization.timezone;
+  }
+
+  if (OptionalReactNativeDeviceInfo) {
+    properties.$app_build = OptionalReactNativeDeviceInfo.getBuildIdSync();
+    properties.$app_name = OptionalReactNativeDeviceInfo.getApplicationName();
+    properties.$app_namespace = OptionalReactNativeDeviceInfo.getBundleId();
+    properties.$app_version = OptionalReactNativeDeviceInfo.getVersion();
+    properties.$device_manufacturer = OptionalReactNativeDeviceInfo.getManufacturerSync();
+    properties.$device_name = OptionalReactNativeDeviceInfo.getDeviceNameSync();
+    properties.$os_name = OptionalReactNativeDeviceInfo.getSystemName();
+    properties.$os_version = OptionalReactNativeDeviceInfo.getSystemVersion();
+  }
+
+  return properties;
 };
+var buildOptimisiticAsyncStorage = function () {
+  if (OptionalExpoFileSystem) {
+    var filesystem_1 = OptionalExpoFileSystem;
+    return {
+      getItem: function (key) {
+        return __awaiter(this, void 0, void 0, function () {
+          var uri, stringContent;
+          return __generator(this, function (_a) {
+            switch (_a.label) {
+              case 0:
+                uri = (filesystem_1.documentDirectory || '') + key;
+                _a.label = 1;
+
+              case 1:
+                _a.trys.push([1, 3,, 4]);
+
+                return [4
+                /*yield*/
+                , filesystem_1.readAsStringAsync(uri)];
+
+              case 2:
+                stringContent = _a.sent();
+                return [2
+                /*return*/
+                , stringContent];
+
+              case 3:
+                _a.sent();
+                return [2
+                /*return*/
+                , null];
+
+              case 4:
+                return [2
+                /*return*/
+                ];
+            }
+          });
+        });
+      },
+      setItem: function (key, value) {
+        return __awaiter(this, void 0, void 0, function () {
+          var uri;
+          return __generator(this, function (_a) {
+            switch (_a.label) {
+              case 0:
+                uri = (filesystem_1.documentDirectory || '') + key;
+                return [4
+                /*yield*/
+                , filesystem_1.writeAsStringAsync(uri, value)];
+
+              case 1:
+                _a.sent();
+
+                return [2
+                /*return*/
+                ];
+            }
+          });
+        });
+      }
+    };
+  }
+
+  if (OptionalAsyncStorage) {
+    return OptionalAsyncStorage;
+  }
 
-var version = "2.0.0";
+  console.log(OptionalAsyncStorage);
+  throw new Error('PostHog: No storage available. Please install expo-filesystem or react-native-async-storage OR implement a custom storage provider.');
+};
 
 var PostHog =
 /** @class */
@@ -1419,27 +1569,51 @@ function (_super) {
     var _this = _super.call(this, apiKey, options) || this;
 
     _this._memoryStorage = new PostHogMemoryStorage();
+    _this._appProperties = {};
     _this._persistence = options === null || options === void 0 ? void 0 : options.persistence;
+    _this._appProperties = (options === null || options === void 0 ? void 0 : options.customAppProperties) || getAppProperties();
+    _this._semiAsyncStorage = new SemiAsyncStorage((options === null || options === void 0 ? void 0 : options.customAsyncStorage) || buildOptimisiticAsyncStorage());
     AppState.addEventListener('change', function () {
       _this.flush();
     }); // Ensure the async storage has been preloaded (this call is cached)
     // It is possible that the old library was used so we try to get the legacy distinctID
 
-    void preloadSemiAsyncStorage().then(function () {
-      if (!SemiAsyncStorage.getItem(PostHogPersistedProperty.AnonymousId)) {
+    void _this._semiAsyncStorage.preloadAsync().then(function () {
+      _this.setupBootstrap(options);
+
+      if (!_this._semiAsyncStorage.getItem(PostHogPersistedProperty.AnonymousId)) {
         getLegacyValues().then(function (legacyValues) {
           if (legacyValues === null || legacyValues === void 0 ? void 0 : legacyValues.distinctId) {
-            SemiAsyncStorage.setItem(PostHogPersistedProperty.DistinctId, legacyValues.distinctId);
-            SemiAsyncStorage.setItem(PostHogPersistedProperty.AnonymousId, legacyValues.anonymousId);
+            _this._semiAsyncStorage.setItem(PostHogPersistedProperty.DistinctId, legacyValues.distinctId);
+
+            _this._semiAsyncStorage.setItem(PostHogPersistedProperty.AnonymousId, legacyValues.anonymousId);
           }
         });
       }
     });
     return _this;
   }
+  /** Await this method to ensure that all state has been loaded from the async provider */
 
-  PostHog.initAsync = function () {
-    return preloadSemiAsyncStorage();
+
+  PostHog.prototype.initAsync = function () {
+    return __awaiter(this, void 0, void 0, function () {
+      return __generator(this, function (_a) {
+        switch (_a.label) {
+          case 0:
+            return [4
+            /*yield*/
+            , this._semiAsyncStorage];
+
+          case 1:
+            _a.sent();
+
+            return [2
+            /*return*/
+            ];
+        }
+      });
+    });
   };
 
   PostHog.prototype.getPersistedProperty = function (key) {
@@ -1447,15 +1621,15 @@ function (_super) {
       return this._memoryStorage.getProperty(key);
     }
 
-    return SemiAsyncStorage.getItem(key) || undefined;
+    return this._semiAsyncStorage.getItem(key) || undefined;
   };
 
   PostHog.prototype.setPersistedProperty = function (key, value) {
     if (this._persistence === 'memory') {
-      return this._memoryStorage.getProperty(key);
+      return this._memoryStorage.setProperty(key, value);
     }
 
-    return value !== null ? SemiAsyncStorage.setItem(key, value) : SemiAsyncStorage.removeItem(key);
+    return value !== null ? this._semiAsyncStorage.setItem(key, value) : this._semiAsyncStorage.removeItem(key);
   };
 
   PostHog.prototype.fetch = function (url, options) {
@@ -1475,20 +1649,10 @@ function (_super) {
   };
 
   PostHog.prototype.getCommonEventProperties = function () {
-    return __assign(__assign({}, _super.prototype.getCommonEventProperties.call(this)), {
-      $app_build: '1',
-      $app_name: ExpoApplication.applicationName,
-      $app_namespace: ExpoApplication.applicationId,
-      $app_version: ExpoApplication.nativeApplicationVersion,
-      $device_manufacturer: ExpoDevice.manufacturer,
-      $device_name: ExpoDevice.modelName,
+    return __assign(__assign(__assign({}, _super.prototype.getCommonEventProperties.call(this)), this._appProperties), {
       $device_type: Platform.OS,
-      $locale: ExpoLocalization.locale,
-      $os_name: ExpoDevice.osName,
-      $os_version: ExpoDevice.osVersion,
       $screen_height: Dimensions.get('screen').height,
-      $screen_width: Dimensions.get('screen').width,
-      $timezone: ExpoLocalization.timezone
+      $screen_width: Dimensions.get('screen').width
     });
   }; // Custom methods
 
@@ -1501,9 +1665,6 @@ function (_super) {
 
   return PostHog;
 }(PostHogCore);
-// is used
-
-void PostHog.initAsync();
 
 var PostHogContext = /*#__PURE__*/React.createContext({
   client: undefined
@@ -1548,10 +1709,6 @@ function useLifecycleTracker(client) {
 
 var _OptionalReactNativeNavigation = undefined;
 
-var warn = function (name) {
-  console.warn("PostHog: Missing ".concat(name, " optional dependency. Some functions may not work as expected..."));
-};
-
 try {
   _OptionalReactNativeNavigation = require('@react-navigation/native');
 } catch (e) {
@@ -1776,14 +1933,20 @@ var autocaptureFromTouchEvent = function (e, posthog, options) {
   }
 };
 
-function PostHogHooks(_a) {
+function PostHogNavigationHook(_a) {
   var options = _a.options;
   useNavigationTracker(options === null || options === void 0 ? void 0 : options.navigation);
+  return null;
+}
+
+function PostHogLifecycleHook() {
   useLifecycleTracker();
   return null;
 }
 
 var PostHogProvider = function (_a) {
+  var _b, _c;
+
   var children = _a.children,
       client = _a.client,
       options = _a.options,
@@ -1796,10 +1959,13 @@ var PostHogProvider = function (_a) {
     posthogRef.current = client ? client : apiKey ? new PostHog(apiKey, options) : undefined;
   }
 
-  var autocaptureEnabled = !!autocapture;
   var autocaptureOptions = autocapture && typeof autocapture !== 'boolean' ? autocapture : {};
   var posthog = posthogRef.current;
   var captureTouches = posthog && (autocapture === true || (autocaptureOptions === null || autocaptureOptions === void 0 ? void 0 : autocaptureOptions.captureTouches));
+  var captureScreens = posthog && (autocapture === true || ((_b = autocaptureOptions === null || autocaptureOptions === void 0 ? void 0 : autocaptureOptions.captureScreens) !== null && _b !== void 0 ? _b : true)); // Default to true if not set
+
+  var captureLifecycle = posthog && (autocapture === true || ((_c = autocaptureOptions === null || autocaptureOptions === void 0 ? void 0 : autocaptureOptions.captureLifecycleEvents) !== null && _c !== void 0 ? _c : true)); // Default to true if not set
+
   var onTouch = useCallback(function (type, e) {
     // TODO: Improve this to ensure we only capture presses and not just ends of a drag for example
     if (!captureTouches) {
@@ -1809,8 +1975,7 @@ var PostHogProvider = function (_a) {
     if (type === 'end') {
       autocaptureFromTouchEvent(e, posthog, autocaptureOptions);
     }
-  }, [posthog, autocapture]); // TODO: Improve this to ensure we only capture presses and not just ends of a drag for example
-
+  }, [posthog, autocapture]);
   return /*#__PURE__*/React.createElement(View, {
     "ph-label": "PostHogProvider",
     style: style || {
@@ -1823,9 +1988,9 @@ var PostHogProvider = function (_a) {
     value: {
       client: posthogRef.current
     }
-  }, autocaptureEnabled ? /*#__PURE__*/React.createElement(PostHogHooks, {
+  }, /*#__PURE__*/React.createElement(React.Fragment, null, captureScreens ? /*#__PURE__*/React.createElement(PostHogNavigationHook, {
     options: autocaptureOptions
-  }) : null, children));
+  }) : null, captureLifecycle ? /*#__PURE__*/React.createElement(PostHogLifecycleHook, null) : null), children));
 };
 
 export { PostHog, PostHogProvider, PostHog as default, useFeatureFlag, useFeatureFlags, useLifecycleTracker, useNavigationTracker, usePostHog };