posthog-react-native 2.0.0 → 2.1.0

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# 2.1.0 - 2022-09-02
+
+What's new:
+
+1. PosthogProvider `autocapture` can be configured with `captureLifecycleEvents: false` and `captureScreens: false` if you want do disable these autocapture elements. Both of these default to `true`

package/lib/index.cjs.js

@@ -164,6 +164,17 @@ function __generator(thisArg, body) {
             throw op[1];
         return { value: op[0] ? op[1] : void 0, done: true };
     }
+}
+function __spreadArray(to, from, pack) {
+    if (pack || arguments.length === 2)
+        for (var i = 0, l = from.length, ar; i < l; i++) {
+            if (ar || !(i in from)) {
+                if (!ar)
+                    ar = Array.prototype.slice.call(from, 0, i);
+                ar[i] = from[i];
+            }
+        }
+    return to.concat(ar || Array.prototype.slice.call(from));
 }
 
 var PostHogPersistedProperty;
@@ -177,6 +188,8 @@ var PostHogPersistedProperty;
     PostHogPersistedProperty["OptedOut"] = "opted_out";
     PostHogPersistedProperty["SessionId"] = "session_id";
     PostHogPersistedProperty["SessionLastTimestamp"] = "session_timestamp";
+    PostHogPersistedProperty["PersonProperties"] = "person_properties";
+    PostHogPersistedProperty["GroupProperties"] = "group_properties";
 })(PostHogPersistedProperty || (PostHogPersistedProperty = {}));
 
 function assert(truthyValue, message) {
@@ -750,12 +763,14 @@ var PostHogCore = /** @class */ (function () {
     }
     PostHogCore.prototype.getCommonEventProperties = function () {
         var featureFlags = this.getFeatureFlags();
-        return {
-            $lib: this.getLibraryId(),
-            $lib_version: this.getLibraryVersion(),
-            $active_feature_flags: featureFlags ? Object.keys(featureFlags) : undefined,
-            $enabled_feature_flags: featureFlags,
-        };
+        var featureVariantProperties = {};
+        if (featureFlags) {
+            for (var _i = 0, _a = Object.entries(featureFlags); _i < _a.length; _i++) {
+                var _b = _a[_i], feature = _b[0], variant = _b[1];
+                featureVariantProperties["$feature/".concat(feature)] = variant;
+            }
+        }
+        return __assign({ $lib: this.getLibraryId(), $lib_version: this.getLibraryVersion(), $active_feature_flags: featureFlags ? Object.keys(featureFlags) : undefined }, featureVariantProperties);
     };
     Object.defineProperty(PostHogCore.prototype, "props", {
         // NOTE: Props are lazy loaded from localstorage hence the complex getter setter logic
@@ -771,6 +786,9 @@ var PostHogCore = /** @class */ (function () {
         enumerable: false,
         configurable: true
     });
+    PostHogCore.prototype.clearProps = function () {
+        this.props = undefined;
+    };
     Object.defineProperty(PostHogCore.prototype, "optedOut", {
         get: function () {
             var _a, _b;
@@ -788,9 +806,15 @@ var PostHogCore = /** @class */ (function () {
     PostHogCore.prototype.on = function (event, cb) {
         return this._events.on(event, cb);
     };
-    PostHogCore.prototype.reset = function () {
-        for (var key in PostHogPersistedProperty) {
-            this.setPersistedProperty(PostHogPersistedProperty[key], null);
+    PostHogCore.prototype.reset = function (propertiesToKeep) {
+        var allPropertiesToKeep = __spreadArray([PostHogPersistedProperty.Queue], (propertiesToKeep || []), true);
+        // clean up props
+        this.clearProps();
+        for (var _i = 0, _a = Object.keys(PostHogPersistedProperty); _i < _a.length; _i++) {
+            var key = _a[_i];
+            if (!allPropertiesToKeep.includes(PostHogPersistedProperty[key])) {
+                this.setPersistedProperty(PostHogPersistedProperty[key], null);
+            }
         }
     };
     PostHogCore.prototype.debug = function (enabled) {
@@ -865,12 +889,18 @@ var PostHogCore = /** @class */ (function () {
         this.enqueue('identify', payload);
         return this;
     };
-    PostHogCore.prototype.capture = function (event, properties) {
+    PostHogCore.prototype.capture = function (event, properties, forceSendFeatureFlags) {
+        if (forceSendFeatureFlags === void 0) { forceSendFeatureFlags = false; }
         if (properties === null || properties === void 0 ? void 0 : properties.$groups) {
             this.groups(properties.$groups);
         }
-        var payload = this.buildPayload({ event: event, properties: properties });
-        this.enqueue('capture', payload);
+        if (forceSendFeatureFlags) {
+            this._sendFeatureFlags(event, properties);
+        }
+        else {
+            var payload = this.buildPayload({ event: event, properties: properties });
+            this.enqueue('capture', payload);
+        }
         return this;
     };
     PostHogCore.prototype.alias = function (alias) {
@@ -900,7 +930,6 @@ var PostHogCore = /** @class */ (function () {
     PostHogCore.prototype.groups = function (groups) {
         // Get persisted groups
         var existingGroups = this.props.$groups || {};
-        // NOTE: Should we do the same for groups listed in identify / capture?
         this.register({
             $groups: __assign(__assign({}, existingGroups), groups),
         });
@@ -928,31 +957,58 @@ var PostHogCore = /** @class */ (function () {
         this.enqueue('capture', payload);
         return this;
     };
+    /***
+     * PROPERTIES
+     ***/
+    PostHogCore.prototype.personProperties = function (properties) {
+        // Get persisted person properties
+        var existingProperties = this.getPersistedProperty(PostHogPersistedProperty.PersonProperties) || {};
+        this.setPersistedProperty(PostHogPersistedProperty.PersonProperties, __assign(__assign({}, existingProperties), properties));
+        return this;
+    };
+    PostHogCore.prototype.groupProperties = function (properties) {
+        // Get persisted group properties
+        var existingProperties = this.getPersistedProperty(PostHogPersistedProperty.GroupProperties) || {};
+        if (Object.keys(existingProperties).length !== 0) {
+            Object.keys(existingProperties).forEach(function (groupType) {
+                existingProperties[groupType] = __assign(__assign({}, existingProperties[groupType]), properties[groupType]);
+                delete properties[groupType];
+            });
+        }
+        this.setPersistedProperty(PostHogPersistedProperty.GroupProperties, __assign(__assign({}, existingProperties), properties));
+        return this;
+    };
     /***
      *** FEATURE FLAGS
      ***/
-    PostHogCore.prototype.decideAsync = function () {
+    PostHogCore.prototype.decideAsync = function (sendAnonDistinctId) {
+        if (sendAnonDistinctId === void 0) { sendAnonDistinctId = true; }
         if (this._decideResponsePromise) {
             return this._decideResponsePromise;
         }
-        return this._decideAsync();
+        return this._decideAsync(sendAnonDistinctId);
     };
-    PostHogCore.prototype._decideAsync = function () {
+    PostHogCore.prototype._decideAsync = function (sendAnonDistinctId) {
+        if (sendAnonDistinctId === void 0) { sendAnonDistinctId = true; }
         return __awaiter(this, void 0, void 0, function () {
-            var url, distinctId, groups, fetchOptions;
+            var url, distinctId, groups, personProperties, groupProperties, fetchOptions;
             var _this = this;
             return __generator(this, function (_a) {
                 url = "".concat(this.host, "/decide/?v=2");
                 distinctId = this.getDistinctId();
                 groups = this.props.$groups || {};
+                personProperties = this.getPersistedProperty(PostHogPersistedProperty.PersonProperties) || {};
+                groupProperties = this.getPersistedProperty(PostHogPersistedProperty.GroupProperties) || {};
                 fetchOptions = {
                     method: 'POST',
                     headers: { 'Content-Type': 'application/json' },
                     body: JSON.stringify({
                         token: this.apiKey,
                         distinct_id: distinctId,
-                        $anon_distinct_id: this.getAnonymousId(),
+                        $anon_distinct_id: sendAnonDistinctId ? this.getAnonymousId() : undefined,
                         groups: groups,
+                        person_properties: personProperties,
+                        group_properties: groupProperties,
                     }),
                 };
                 this._decideResponsePromise = this.fetchWithRetry(url, fetchOptions)
@@ -971,23 +1027,26 @@ var PostHogCore = /** @class */ (function () {
             });
         });
     };
-    PostHogCore.prototype.getFeatureFlag = function (key, defaultResult) {
-        var _a;
-        if (defaultResult === void 0) { defaultResult = false; }
+    PostHogCore.prototype.getFeatureFlag = function (key) {
         var featureFlags = this.getFeatureFlags();
         if (!featureFlags) {
-            // If we haven't loaded flags yet we respond undefined to indicate this
+            // If we haven't loaded flags yet, or errored out, we respond with undefined
             return undefined;
         }
+        var response = featureFlags[key];
+        if (response === undefined) {
+            // `/decide` returns nothing for flags which are false.
+            response = false;
+        }
         if (this.sendFeatureFlagEvent && !this.flagCallReported[key]) {
             this.flagCallReported[key] = true;
             this.capture('$feature_flag_called', {
                 $feature_flag: key,
-                $feature_flag_response: featureFlags[key],
+                $feature_flag_response: response,
             });
         }
-        // If we have flags we either return the value (true or string) or the defaultResult
-        return (_a = featureFlags[key]) !== null && _a !== void 0 ? _a : defaultResult;
+        // If we have flags we either return the value (true or string) or false
+        return response;
     };
     PostHogCore.prototype.getFeatureFlags = function () {
         var flags = this.getPersistedProperty(PostHogPersistedProperty.FeatureFlags);
@@ -1006,17 +1065,19 @@ var PostHogCore = /** @class */ (function () {
         }
         return flags;
     };
-    PostHogCore.prototype.isFeatureEnabled = function (key, defaultResult) {
-        var _a;
-        if (defaultResult === void 0) { defaultResult = false; }
-        var flag = (_a = this.getFeatureFlag(key, defaultResult)) !== null && _a !== void 0 ? _a : defaultResult;
-        return !!flag;
+    PostHogCore.prototype.isFeatureEnabled = function (key) {
+        var response = this.getFeatureFlag(key);
+        if (response === undefined) {
+            return undefined;
+        }
+        return !!response;
     };
-    PostHogCore.prototype.reloadFeatureFlagsAsync = function () {
+    PostHogCore.prototype.reloadFeatureFlagsAsync = function (sendAnonDistinctId) {
+        if (sendAnonDistinctId === void 0) { sendAnonDistinctId = true; }
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
                 switch (_a.label) {
-                    case 0: return [4 /*yield*/, this.decideAsync()];
+                    case 0: return [4 /*yield*/, this.decideAsync(sendAnonDistinctId)];
                     case 1: return [2 /*return*/, (_a.sent()).featureFlags];
                 }
             });
@@ -1054,6 +1115,14 @@ var PostHogCore = /** @class */ (function () {
         }
         return this.setPersistedProperty(PostHogPersistedProperty.OverrideFeatureFlags, flags);
     };
+    PostHogCore.prototype._sendFeatureFlags = function (event, properties) {
+        var _this = this;
+        this.reloadFeatureFlagsAsync(false).finally(function () {
+            // Try to enqueue message irrespective of errors during feature flag fetching
+            var payload = _this.buildPayload({ event: event, properties: properties });
+            _this.enqueue('capture', payload);
+        });
+    };
     /***
      *** QUEUEING AND FLUSHING
      ***/
@@ -1082,13 +1151,15 @@ var PostHogCore = /** @class */ (function () {
     PostHogCore.prototype.flushAsync = function () {
         var _this = this;
         return new Promise(function (resolve, reject) {
-            _this.flush(function (err, data) { return (err ? reject(err) : resolve(data)); });
+            _this.flush(function (err, data) {
+                return err ? reject(err) : resolve(data);
+            });
         });
     };
     PostHogCore.prototype.flush = function (callback) {
         var _this = this;
         if (this.optedOut) {
-            return callback && safeSetTimeout(callback, 0);
+            return callback === null || callback === void 0 ? void 0 : callback();
         }
         if (this._flushTimer) {
             clearTimeout(this._flushTimer);
@@ -1096,7 +1167,7 @@ var PostHogCore = /** @class */ (function () {
         }
         var queue = this.getPersistedProperty(PostHogPersistedProperty.Queue) || [];
         if (!queue.length) {
-            return callback && safeSetTimeout(callback, 0);
+            return callback === null || callback === void 0 ? void 0 : callback();
         }
         var items = queue.splice(0, this.flushAt);
         this.setPersistedProperty(PostHogPersistedProperty.Queue, queue);
@@ -1367,7 +1438,7 @@ var preloadSemiAsyncStorage = function () {
   return _preloadSemiAsyncStoragePromise;
 };
 
-var version = "2.0.0";
+var version = "2.1.0";
 
 var PostHog =
 /** @class */
@@ -1604,10 +1675,10 @@ function useFeatureFlags(client) {
   return featureFlags;
 }
 
-function useFeatureFlag(flag, defaultValue) {
+function useFeatureFlag(flag) {
   var posthog = usePostHog();
 
-  var _a = React.useState(posthog === null || posthog === void 0 ? void 0 : posthog.getFeatureFlag(flag, defaultValue)),
+  var _a = React.useState(posthog === null || posthog === void 0 ? void 0 : posthog.getFeatureFlag(flag)),
       featureFlag = _a[0],
       setFeatureFlag = _a[1];
 
@@ -1616,11 +1687,11 @@ function useFeatureFlag(flag, defaultValue) {
   }
 
   React.useEffect(function () {
-    setFeatureFlag(posthog.getFeatureFlag(flag, defaultValue));
+    setFeatureFlag(posthog.getFeatureFlag(flag));
     return posthog.onFeatureFlags(function () {
-      setFeatureFlag(posthog.getFeatureFlag(flag, defaultValue));
+      setFeatureFlag(posthog.getFeatureFlag(flag));
     });
-  }, [posthog, flag, defaultValue]);
+  }, [posthog, flag]);
   return featureFlag;
 }
 
@@ -1735,14 +1806,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,
@@ -1755,10 +1832,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 = React.useCallback(function (type, e) {
     // TODO: Improve this to ensure we only capture presses and not just ends of a drag for example
     if (!captureTouches) {
@@ -1768,8 +1848,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__default["default"].createElement(reactNative.View, {
     "ph-label": "PostHogProvider",
     style: style || {
@@ -1782,9 +1861,9 @@ var PostHogProvider = function (_a) {
     value: {
       client: posthogRef.current
     }
-  }, autocaptureEnabled ? /*#__PURE__*/React__default["default"].createElement(PostHogHooks, {
+  }, /*#__PURE__*/React__default["default"].createElement(React__default["default"].Fragment, null, captureScreens ? /*#__PURE__*/React__default["default"].createElement(PostHogNavigationHook, {
     options: autocaptureOptions
-  }) : null, children));
+  }) : null, captureLifecycle ? /*#__PURE__*/React__default["default"].createElement(PostHogLifecycleHook, null) : null), children));
 };
 
 exports.PostHog = PostHog;