posthog-js-lite 3.1.0 → 3.2.1

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Next
 
+# 3.2.1 - 2025-01-17
+
+## Fixed
+
+1. fix: check if window and fetch are available before using on web env
+
+# 3.2.0 - 2024-12-12
+
+## Changed
+
+1. Add new debugging property `$feature_flag_bootstrapped_response`, `$feature_flag_bootstrapped_payload` and `$used_bootstrap_value` to `$feature_flag_called` event
+
+
 # 3.1.0 - 2024-11-21
 
 ## Changed

package/lib/index.cjs.js

@@ -9,6 +9,8 @@ var PostHogPersistedProperty;
     PostHogPersistedProperty["Props"] = "props";
     PostHogPersistedProperty["FeatureFlags"] = "feature_flags";
     PostHogPersistedProperty["FeatureFlagPayloads"] = "feature_flag_payloads";
+    PostHogPersistedProperty["BootstrapFeatureFlags"] = "bootstrap_feature_flags";
+    PostHogPersistedProperty["BootstrapFeatureFlagPayloads"] = "bootstrap_feature_flag_payloads";
     PostHogPersistedProperty["OverrideFeatureFlags"] = "override_feature_flags";
     PostHogPersistedProperty["Queue"] = "queue";
     PostHogPersistedProperty["OptedOut"] = "opted_out";
@@ -19,6 +21,7 @@ var PostHogPersistedProperty;
     PostHogPersistedProperty["InstalledAppBuild"] = "installed_app_build";
     PostHogPersistedProperty["InstalledAppVersion"] = "installed_app_version";
     PostHogPersistedProperty["SessionReplay"] = "session_replay";
+    PostHogPersistedProperty["DecideEndpointWasHit"] = "decide_endpoint_was_hit";
 })(PostHogPersistedProperty || (PostHogPersistedProperty = {}));
 
 function assert(truthyValue, message) {
@@ -62,6 +65,9 @@ function safeSetTimeout(fn, timeout) {
     // We unref if available to prevent Node.js hanging on exit
     t?.unref && t?.unref();
     return t;
+}
+function getFetch() {
+    return typeof fetch !== 'undefined' ? fetch : typeof global.fetch !== 'undefined' ? global.fetch : undefined;
 }
 
 // Copyright (c) 2013 Pieroxy <pieroxy@pieroxy.net>
@@ -1442,12 +1448,14 @@ class PostHogCore extends PostHogCoreStateless {
                 .filter((flag) => !!bootstrapfeatureFlags[flag])
                 .reduce((res, key) => ((res[key] = bootstrapfeatureFlags[key] || false), res), {});
             if (Object.keys(bootstrapFlags).length) {
+                this.setPersistedProperty(PostHogPersistedProperty.BootstrapFeatureFlags, bootstrapFlags);
                 const currentFlags = this.getPersistedProperty(PostHogPersistedProperty.FeatureFlags) || {};
                 const newFeatureFlags = { ...bootstrapFlags, ...currentFlags };
                 this.setKnownFeatureFlags(newFeatureFlags);
             }
             const bootstrapFlagPayloads = bootstrap.featureFlagPayloads;
             if (bootstrapFlagPayloads && Object.keys(bootstrapFlagPayloads).length) {
+                this.setPersistedProperty(PostHogPersistedProperty.BootstrapFeatureFlagPayloads, bootstrapFlagPayloads);
                 const currentFlagPayloads = this.getPersistedProperty(PostHogPersistedProperty.FeatureFlagPayloads) || {};
                 const newFeatureFlagPayloads = { ...bootstrapFlagPayloads, ...currentFlagPayloads };
                 this.setKnownFeatureFlagPayloads(newFeatureFlagPayloads);
@@ -1763,6 +1771,8 @@ class PostHogCore extends PostHogCoreStateless {
                     }
                     this.setKnownFeatureFlags(newFeatureFlags);
                     this.setKnownFeatureFlagPayloads(Object.fromEntries(Object.entries(newFeatureFlagPayloads || {}).map(([k, v]) => [k, this._parsePayload(v)])));
+                    // Mark that we hit the /decide endpoint so we can capture this in the $feature_flag_called event
+                    this.setPersistedProperty(PostHogPersistedProperty.DecideEndpointWasHit, true);
                     const sessionReplay = res?.sessionRecording;
                     if (sessionReplay) {
                         this.setPersistedProperty(PostHogPersistedProperty.SessionReplay, sessionReplay);
@@ -1809,6 +1819,10 @@ class PostHogCore extends PostHogCoreStateless {
             this.capture('$feature_flag_called', {
                 $feature_flag: key,
                 $feature_flag_response: response,
+                $feature_flag_bootstrapped_response: this.getPersistedProperty(PostHogPersistedProperty.BootstrapFeatureFlags)?.[key],
+                $feature_flag_bootstrapped_payload: this.getPersistedProperty(PostHogPersistedProperty.BootstrapFeatureFlagPayloads)?.[key],
+                // If we haven't yet received a response from the /decide endpoint, we must have used the bootstrapped value
+                $used_bootstrap_value: !this.getPersistedProperty(PostHogPersistedProperty.DecideEndpointWasHit),
             });
         }
         // If we have flags we either return the value (true or string) or false
@@ -1906,15 +1920,18 @@ class PostHogCore extends PostHogCoreStateless {
     }
 }
 
-var version = "3.1.0";
+var version = "3.2.1";
 
 function getContext(window) {
   let context = {};
-  if (window.navigator) {
+  if (window?.navigator) {
     const userAgent = window.navigator.userAgent;
+    const osValue = os(window);
     context = {
       ...context,
-      $os: os(window),
+      ...(osValue !== undefined && {
+        $os: osValue
+      }),
       $browser: browser(userAgent, window.navigator.vendor, !!window.opera),
       $referrer: window.document.referrer,
       $referring_domain: referringDomain(window.document.referrer),
@@ -2016,6 +2033,9 @@ function browserVersion(userAgent, vendor, opera) {
   return parseFloat(matches[matches.length - 2]);
 }
 function os(window) {
+  if (!window?.navigator) {
+    return undefined;
+  }
   const a = window.navigator.userAgent;
   if (/Windows/i.test(a)) {
     if (/Phone/.test(a) || /WPDesktop/.test(a)) {
@@ -2035,7 +2055,7 @@ function os(window) {
   } else if (/CrOS/.test(a)) {
     return 'Chrome OS';
   } else {
-    return '';
+    return undefined;
   }
 }
 function device(userAgent) {
@@ -2139,9 +2159,6 @@ const createStorageLike = store => {
   };
 };
 const checkStoreIsSupported = (storage, key = '__mplssupport__') => {
-  if (!window) {
-    return false;
-  }
   try {
     const val = 'xyz';
     storage.setItem(key, val);
@@ -2213,12 +2230,15 @@ class PostHog extends PostHogCore {
     super(apiKey, options);
     // posthog-js stores options in one object on
     this._storageKey = options?.persistence_name ? `ph_${options.persistence_name}` : `ph_${apiKey}_posthog`;
-    this._storage = getStorage(options?.persistence || 'localStorage', window);
+    this._storage = getStorage(options?.persistence || 'localStorage', this.getWindow());
     this.setupBootstrap(options);
     if (options?.preloadFeatureFlags !== false) {
       this.reloadFeatureFlags();
     }
   }
+  getWindow() {
+    return typeof window !== 'undefined' ? window : undefined;
+  }
   getPersistedProperty(key) {
     if (!this._storageCache) {
       this._storageCache = JSON.parse(this._storage.getItem(this._storageKey) || '{}') || {};
@@ -2237,7 +2257,12 @@ class PostHog extends PostHogCore {
     this._storage.setItem(this._storageKey, JSON.stringify(this._storageCache));
   }
   fetch(url, options) {
-    return window.fetch(url, options);
+    const fetchFn = getFetch();
+    if (!fetchFn) {
+      // error will be handled by the caller (fetchWithRetry)
+      return Promise.reject(new Error('Fetch API is not available in this environment.'));
+    }
+    return fetchFn(url, options);
   }
   getLibraryId() {
     return 'posthog-js-lite';
@@ -2251,7 +2276,7 @@ class PostHog extends PostHogCore {
   getCommonEventProperties() {
     return {
       ...super.getCommonEventProperties(),
-      ...getContext(window)
+      ...getContext(this.getWindow())
     };
   }
 }