@pushwoosh/kit-helpers 4.8.6 → 4.8.8

package/analytics/identifyMixpanel.d.ts

@@ -0,0 +1,2 @@
+import { type MixpanelProperties } from './utils';
+export declare const identifyMixpanel: (properties: MixpanelProperties) => void;

package/analytics/identifyMixpanel.js

@@ -0,0 +1,14 @@
+import { isProductionMode, isUserActionsTrackingOff } from './utils';
+export const identifyMixpanel = properties => {
+  if (!isProductionMode() || isUserActionsTrackingOff()) {
+    return;
+  }
+  if (!window.mixpanel) {
+    const store = window.pwMixpanelIdentifyStore || [];
+    store.push(properties);
+    window.pwMixpanelIdentifyStore = store;
+  } else {
+    window.mixpanel?.identify(properties?.$email);
+    window.mixpanel?.people?.set(properties);
+  }
+};

package/analytics/identifyOpenReplay.d.ts

@@ -0,0 +1,2 @@
+import { type OpenReplayProperties } from './utils';
+export declare const identifyOpenReplaySession: (properties: OpenReplayProperties) => void;

package/analytics/identifyOpenReplay.js

@@ -0,0 +1,16 @@
+import { isProductionMode, isUserActionsTrackingOff } from './utils';
+export const identifyOpenReplaySession = properties => {
+  if (!isProductionMode() || isUserActionsTrackingOff()) {
+    return;
+  }
+  if (!window.OpenReplay) {
+    const store = window.pwOpenReplayIdentifyStore || [];
+    store.push(properties);
+    window.pwOpenReplayIdentifyStore = store;
+  } else {
+    window.OpenReplay?.setUserID(properties.email);
+    if (properties.accountID) {
+      window.OpenReplay?.setMetadata('AccountID', `${properties.accountID}`);
+    }
+  }
+};

package/analytics/trackMixpanel.d.ts

@@ -0,0 +1,2 @@
+import { type Event } from './utils';
+export declare function trackMixpanelEvent(event: Event): void;

package/analytics/trackMixpanel.js

@@ -0,0 +1,13 @@
+import { isProductionMode, isUserActionsTrackingOff } from './utils';
+export function trackMixpanelEvent(event) {
+  if (!isProductionMode() || isUserActionsTrackingOff()) {
+    return;
+  }
+  if (!window.mixpanel) {
+    const store = window.pwMixpanelTrackingEventsStore || [];
+    store.push(event);
+    window.pwMixpanelTrackingEventsStore = store;
+  } else {
+    window.mixpanel?.track(event.name, event.properties);
+  }
+}

package/analytics/utils.d.ts

@@ -0,0 +1,31 @@
+import { type Mixpanel } from 'mixpanel-browser';
+interface IOpenReplay {
+    setUserID(id: string): void;
+    setMetadata(key: string, value: string): void;
+}
+export type Event = {
+    readonly name: string;
+    readonly properties?: Record<string, unknown>;
+};
+export type MixpanelProperties = {
+    $email: string;
+    $name?: string;
+    AccountID?: string;
+    Restriction?: string;
+};
+export type OpenReplayProperties = {
+    email: string;
+    accountID?: string;
+};
+declare global {
+    interface Window {
+        mixpanel?: Mixpanel;
+        OpenReplay?: IOpenReplay;
+        pwMixpanelIdentifyStore?: MixpanelProperties[];
+        pwOpenReplayIdentifyStore?: OpenReplayProperties[];
+        pwMixpanelTrackingEventsStore?: Event[];
+    }
+}
+export declare const isProductionMode: () => boolean;
+export declare const isUserActionsTrackingOff: () => boolean;
+export {};

package/analytics/utils.js

@@ -0,0 +1,7 @@
+export const isProductionMode = () => process.env.NODE_ENV === 'production';
+export const isUserActionsTrackingOff = () => {
+  const turnOffTracking = localStorage.getItem('pw_off_user_actions_tracking');
+  // Any value other than these specific "falsey" ones means tracking is off.
+  const trackingOnValues = [null, '', '0', 'false'];
+  return !trackingOnValues.includes(turnOffTracking);
+};

package/index.d.ts

@@ -1,6 +1,9 @@
 export * from './grid';
 export * from './expand';
 export * from './hooks/useClickAway';
+export { trackMixpanelEvent } from './analytics/trackMixpanel';
+export { identifyMixpanel } from './analytics/identifyMixpanel';
+export { identifyOpenReplaySession } from './analytics/identifyOpenReplay';
 export { formatNumber } from './formatNumber';
 export { default as usePersistentFunction } from './hooks/usePersistentFunction';
 export { default as useEffectOnce } from './hooks/useEffectOnce';

package/index.js

@@ -1,6 +1,9 @@
 export * from './grid';
 export * from './expand';
 export * from './hooks/useClickAway';
+export { trackMixpanelEvent } from './analytics/trackMixpanel';
+export { identifyMixpanel } from './analytics/identifyMixpanel';
+export { identifyOpenReplaySession } from './analytics/identifyOpenReplay';
 export { formatNumber } from './formatNumber';
 export { default as usePersistentFunction } from './hooks/usePersistentFunction';
 export { default as useEffectOnce } from './hooks/useEffectOnce';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushwoosh/kit-helpers",
-  "version": "4.8.6",
+  "version": "4.8.8",
   "description": "React component for build Pushwoosh products",
   "main": "index.js",
   "module": "index.js",
@@ -16,6 +16,7 @@
   },
   "pre-commit": "check",
   "dependencies": {
+    "mixpanel-browser": "^2.71.0",
     "react-transition-group": "^4.4.5"
   },
   "devDependencies": {