posthog-js-lite 3.2.0 → 3.3.0

package/lib/index.d.ts

@@ -317,6 +317,12 @@ declare abstract class PostHogCore extends PostHogCoreStateless {
     onFeatureFlags(cb: (flags: PostHogDecideResponse['featureFlags']) => void): () => void;
     onFeatureFlag(key: string, cb: (value: string | boolean) => void): () => void;
     overrideFeatureFlag(flags: PostHogDecideResponse['featureFlags'] | null): Promise<void>;
+    /***
+     *** ERROR TRACKING
+     ***/
+    captureException(error: Error, additionalProperties?: {
+        [key: string]: any;
+    }): void;
 }
 
 type PostHogOptions = {
@@ -330,6 +336,7 @@ declare class PostHog extends PostHogCore {
     private _storageCache;
     private _storageKey;
     constructor(apiKey: string, options?: PostHogOptions);
+    private getWindow;
     getPersistedProperty<T>(key: PostHogPersistedProperty): T | undefined;
     setPersistedProperty<T>(key: PostHogPersistedProperty, value: T | null): void;
     fetch(url: string, options: PostHogFetchOptions): Promise<PostHogFetchResponse>;

package/lib/index.esm.js

@@ -61,6 +61,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>
@@ -1911,17 +1914,41 @@ class PostHogCore extends PostHogCoreStateless {
             return this.setPersistedProperty(PostHogPersistedProperty.OverrideFeatureFlags, flags);
         });
     }
+    /***
+     *** ERROR TRACKING
+     ***/
+    captureException(error, additionalProperties) {
+        const properties = {
+            $exception_level: 'error',
+            $exception_list: [
+                {
+                    type: error.name,
+                    value: error.message,
+                    mechanism: {
+                        handled: true,
+                        synthetic: false,
+                    },
+                },
+            ],
+            ...additionalProperties,
+        };
+        properties.$exception_personURL = new URL(`/project/${this.apiKey}/person/${this.getDistinctId()}`, this.host).toString();
+        this.capture('$exception', properties);
+    }
 }
 
-var version = "3.2.0";
+var version = "3.3.0";
 
 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),
@@ -2023,6 +2050,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)) {
@@ -2042,7 +2072,7 @@ function os(window) {
   } else if (/CrOS/.test(a)) {
     return 'Chrome OS';
   } else {
-    return '';
+    return undefined;
   }
 }
 function device(userAgent) {
@@ -2146,9 +2176,6 @@ const createStorageLike = store => {
   };
 };
 const checkStoreIsSupported = (storage, key = '__mplssupport__') => {
-  if (!window) {
-    return false;
-  }
   try {
     const val = 'xyz';
     storage.setItem(key, val);
@@ -2220,12 +2247,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) || '{}') || {};
@@ -2244,7 +2274,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';
@@ -2258,7 +2293,7 @@ class PostHog extends PostHogCore {
   getCommonEventProperties() {
     return {
       ...super.getCommonEventProperties(),
-      ...getContext(window)
+      ...getContext(this.getWindow())
     };
   }
 }