posthog-js-lite 3.2.0 → 3.3.0

package/lib/posthog-core/src/index.d.ts

@@ -183,6 +183,12 @@ export 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;
 }
 export * from './types';
 export { LZString };

package/lib/posthog-core/src/types.d.ts

@@ -129,3 +129,4 @@ export type PostHogFlagsAndPayloadsResponse = {
 export type JsonType = string | number | boolean | null | {
     [key: string]: JsonType;
 } | Array<JsonType>;
+export type FetchLike = (url: string, options: PostHogFetchOptions) => Promise<PostHogFetchResponse>;

package/lib/posthog-core/src/utils.d.ts

@@ -1,3 +1,4 @@
+import { FetchLike } from './types';
 export declare function assert(truthyValue: any, message: string): void;
 export declare function removeTrailingSlash(url: string): string;
 export interface RetriableOptions {
@@ -10,3 +11,4 @@ export declare function currentTimestamp(): number;
 export declare function currentISOTime(): string;
 export declare function safeSetTimeout(fn: () => void, timeout: number): any;
 export declare const isPromise: (obj: any) => obj is Promise<any>;
+export declare function getFetch(): FetchLike | undefined;

package/lib/posthog-web/src/context.d.ts

@@ -1 +1 @@
-export declare function getContext(window: Window): any;
+export declare function getContext(window: Window | undefined): any;

package/lib/posthog-web/src/posthog-web.d.ts

@@ -5,6 +5,7 @@ export 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posthog-js-lite",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "main": "lib/index.cjs.js",
   "module": "lib/index.esm.js",
   "types": "lib/index.d.ts",

package/src/context.ts

@@ -1,13 +1,14 @@
 import { utils } from '../../posthog-core'
 import { version } from '../package.json'
 
-export function getContext(window: Window): any {
+export function getContext(window: Window | undefined): any {
   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 as any).opera),
       $referrer: window.document.referrer,
       $referring_domain: referringDomain(window.document.referrer),
@@ -21,6 +22,7 @@ export function getContext(window: Window): any {
       $screen_dpr: window.devicePixelRatio,
     }
   }
+
   context = {
     ...context,
     $lib: 'js',
@@ -114,7 +116,10 @@ function browserVersion(userAgent: string, vendor: string, opera: boolean): numb
   return parseFloat(matches[matches.length - 2])
 }
 
-function os(window: Window): string {
+function os(window: Window | undefined): string | undefined {
+  if (!window?.navigator) {
+    return undefined
+  }
   const a = window.navigator.userAgent
   if (/Windows/i.test(a)) {
     if (/Phone/.test(a) || /WPDesktop/.test(a)) {
@@ -134,7 +139,7 @@ function os(window: Window): string {
   } else if (/CrOS/.test(a)) {
     return 'Chrome OS'
   } else {
-    return ''
+    return undefined
   }
 }
 

package/src/posthog-web.ts

@@ -8,6 +8,7 @@ import { getContext } from './context'
 import { PostHogStorage, getStorage } from './storage'
 import { version } from '../package.json'
 import { PostHogOptions } from './types'
+import { getFetch } from 'posthog-core/src/utils'
 
 export class PostHog extends PostHogCore {
   private _storage: PostHogStorage
@@ -19,7 +20,8 @@ export class PostHog extends PostHogCore {
 
     // 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) {
@@ -27,6 +29,10 @@ export class PostHog extends PostHogCore {
     }
   }
 
+  private getWindow(): Window | undefined {
+    return typeof window !== 'undefined' ? window : undefined
+  }
+
   getPersistedProperty<T>(key: PostHogPersistedProperty): T | undefined {
     if (!this._storageCache) {
       this._storageCache = JSON.parse(this._storage.getItem(this._storageKey) || '{}') || {}
@@ -50,7 +56,14 @@ export class PostHog extends PostHogCore {
   }
 
   fetch(url: string, options: PostHogFetchOptions): Promise<PostHogFetchResponse> {
-    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(): string {
@@ -68,7 +81,7 @@ export class PostHog extends PostHogCore {
   getCommonEventProperties(): any {
     return {
       ...super.getCommonEventProperties(),
-      ...getContext(window),
+      ...getContext(this.getWindow()),
     }
   }
 }

package/src/storage.ts

@@ -93,9 +93,6 @@ const createStorageLike = (store: any): PostHogStorage => {
 }
 
 const checkStoreIsSupported = (storage: PostHogStorage, key = '__mplssupport__'): boolean => {
-  if (!window) {
-    return false
-  }
   try {
     const val = 'xyz'
     storage.setItem(key, val)