@elementor/events 4.0.0-manual → 4.1.0-684

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-declare const useMixpanel: () => {
-    dispatchEvent: ((name: string, data: unknown) => void) | undefined;
+declare const getMixpanel: () => {
+    dispatchEvent: ((name: string, data: unknown, options?: Record<string, unknown>) => void) | undefined;
     config: {
         locations?: Record<string, string>;
         secondaryLocations?: Record<string, string>;
@@ -11,12 +11,15 @@ declare const useMixpanel: () => {
         interactionResults?: Record<string, string>;
         targetNames?: Record<string, Record<string, string>>;
     } | undefined;
+    canSendEvents: (() => boolean) | undefined;
+    initializeMixpanel: ((onLoaded: (mpInstance?: unknown) => void) => void) | undefined;
+    enableTracking: (() => void) | undefined;
+    isMixpanelReady: (() => boolean) | undefined;
+    trackingEnabled: boolean;
+    getMixpanelInstance: (() => unknown) | undefined;
 };
-declare const trackEvent: <T extends {
-    eventName: string;
-} & Record<string, unknown>>(event: T) => void;
-declare const getMixpanel: () => {
-    dispatchEvent: ((name: string, data: unknown) => void) | undefined;
+declare const useMixpanel: () => {
+    dispatchEvent: ((name: string, data: unknown, options?: Record<string, unknown>) => void) | undefined;
     config: {
         locations?: Record<string, string>;
         secondaryLocations?: Record<string, string>;
@@ -29,5 +32,15 @@ declare const getMixpanel: () => {
         targetNames?: Record<string, Record<string, string>>;
     } | undefined;
 };
+declare const trackEvent: <T extends {
+    eventName: string;
+} & Record<string, unknown>>(event: T) => void;
+declare const canSendEvents: () => boolean;
+declare const setCanSendEvents: (value: boolean) => void;
+declare const isMixpanelReady: () => boolean;
+declare const isTrackingEnabled: () => boolean;
+declare const enableTracking: () => void;
+declare const initializeMixpanel: (onLoaded?: () => void) => void;
+declare function initializeAndEnableTracking(onReady?: (mpInstance?: unknown) => void): void;
 
-export { getMixpanel, trackEvent, useMixpanel };
+export { canSendEvents, enableTracking, getMixpanel, initializeAndEnableTracking, initializeMixpanel, isMixpanelReady, isTrackingEnabled, setCanSendEvents, trackEvent, useMixpanel };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-declare const useMixpanel: () => {
-    dispatchEvent: ((name: string, data: unknown) => void) | undefined;
+declare const getMixpanel: () => {
+    dispatchEvent: ((name: string, data: unknown, options?: Record<string, unknown>) => void) | undefined;
     config: {
         locations?: Record<string, string>;
         secondaryLocations?: Record<string, string>;
@@ -11,12 +11,15 @@ declare const useMixpanel: () => {
         interactionResults?: Record<string, string>;
         targetNames?: Record<string, Record<string, string>>;
     } | undefined;
+    canSendEvents: (() => boolean) | undefined;
+    initializeMixpanel: ((onLoaded: (mpInstance?: unknown) => void) => void) | undefined;
+    enableTracking: (() => void) | undefined;
+    isMixpanelReady: (() => boolean) | undefined;
+    trackingEnabled: boolean;
+    getMixpanelInstance: (() => unknown) | undefined;
 };
-declare const trackEvent: <T extends {
-    eventName: string;
-} & Record<string, unknown>>(event: T) => void;
-declare const getMixpanel: () => {
-    dispatchEvent: ((name: string, data: unknown) => void) | undefined;
+declare const useMixpanel: () => {
+    dispatchEvent: ((name: string, data: unknown, options?: Record<string, unknown>) => void) | undefined;
     config: {
         locations?: Record<string, string>;
         secondaryLocations?: Record<string, string>;
@@ -29,5 +32,15 @@ declare const getMixpanel: () => {
         targetNames?: Record<string, Record<string, string>>;
     } | undefined;
 };
+declare const trackEvent: <T extends {
+    eventName: string;
+} & Record<string, unknown>>(event: T) => void;
+declare const canSendEvents: () => boolean;
+declare const setCanSendEvents: (value: boolean) => void;
+declare const isMixpanelReady: () => boolean;
+declare const isTrackingEnabled: () => boolean;
+declare const enableTracking: () => void;
+declare const initializeMixpanel: (onLoaded?: () => void) => void;
+declare function initializeAndEnableTracking(onReady?: (mpInstance?: unknown) => void): void;
 
-export { getMixpanel, trackEvent, useMixpanel };
+export { canSendEvents, enableTracking, getMixpanel, initializeAndEnableTracking, initializeMixpanel, isMixpanelReady, isTrackingEnabled, setCanSendEvents, trackEvent, useMixpanel };

package/dist/index.js

@@ -20,13 +20,33 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  canSendEvents: () => canSendEvents,
+  enableTracking: () => enableTracking,
   getMixpanel: () => getMixpanel,
+  initializeAndEnableTracking: () => initializeAndEnableTracking,
+  initializeMixpanel: () => initializeMixpanel,
+  isMixpanelReady: () => isMixpanelReady,
+  isTrackingEnabled: () => isTrackingEnabled,
+  setCanSendEvents: () => setCanSendEvents,
   trackEvent: () => trackEvent,
   useMixpanel: () => useMixpanel
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/use-mixpanel.ts
+var getMixpanel = () => {
+  const eventsManager = window.elementorCommon?.eventsManager || {};
+  return {
+    dispatchEvent: eventsManager.dispatchEvent?.bind(eventsManager),
+    config: eventsManager.config,
+    canSendEvents: eventsManager.canSendEvents?.bind(eventsManager),
+    initializeMixpanel: eventsManager.initializeMixpanel?.bind(eventsManager),
+    enableTracking: eventsManager.enableTracking?.bind(eventsManager),
+    isMixpanelReady: eventsManager.isMixpanelReady?.bind(eventsManager),
+    trackingEnabled: eventsManager.trackingEnabled ?? false,
+    getMixpanelInstance: eventsManager.getMixpanelInstance?.bind(eventsManager)
+  };
+};
 var useMixpanel = () => {
   const { dispatchEvent, config } = getMixpanel();
   return {
@@ -38,16 +58,47 @@ var trackEvent = (event) => {
   const { dispatchEvent } = getMixpanel();
   dispatchEvent?.(event.eventName, event);
 };
-var getMixpanel = () => {
-  const eventsManager = window.elementorCommon?.eventsManager || {};
-  return {
-    dispatchEvent: eventsManager.dispatchEvent?.bind(eventsManager),
-    config: eventsManager.config
-  };
+var canSendEvents = () => getMixpanel().canSendEvents?.() ?? false;
+var setCanSendEvents = (value) => {
+  const editorEvents = window.elementorCommon?.config?.editor_events;
+  if (editorEvents) {
+    editorEvents.can_send_events = value;
+  }
 };
+var isMixpanelReady = () => getMixpanel().isMixpanelReady?.() ?? false;
+var isTrackingEnabled = () => getMixpanel().trackingEnabled;
+var enableTracking = () => getMixpanel().enableTracking?.();
+var initializeMixpanel = (onLoaded) => getMixpanel().initializeMixpanel?.(onLoaded ?? (() => {
+}));
+function initializeAndEnableTracking(onReady) {
+  const mixpanel = getMixpanel();
+  if (!mixpanel.dispatchEvent) {
+    return;
+  }
+  if (mixpanel.trackingEnabled) {
+    onReady?.(mixpanel.getMixpanelInstance?.());
+    return;
+  }
+  if (mixpanel.isMixpanelReady?.()) {
+    mixpanel.enableTracking?.();
+    onReady?.(mixpanel.getMixpanelInstance?.());
+    return;
+  }
+  mixpanel.initializeMixpanel?.((mpInstance) => {
+    mixpanel.enableTracking?.();
+    onReady?.(mpInstance);
+  });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  canSendEvents,
+  enableTracking,
   getMixpanel,
+  initializeAndEnableTracking,
+  initializeMixpanel,
+  isMixpanelReady,
+  isTrackingEnabled,
+  setCanSendEvents,
   trackEvent,
   useMixpanel
 });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/use-mixpanel.ts"],"sourcesContent":["export * from './use-mixpanel';\n","export const useMixpanel = () => {\n\tconst { dispatchEvent, config } = getMixpanel();\n\n\treturn {\n\t\tdispatchEvent,\n\t\tconfig,\n\t};\n};\n\nexport const trackEvent = < T extends { eventName: string } & Record< string, unknown > >( event: T ) => {\n\tconst { dispatchEvent } = getMixpanel();\n\tdispatchEvent?.( event.eventName, event );\n};\n\nexport const getMixpanel = () => {\n\tconst eventsManager = window.elementorCommon?.eventsManager || {};\n\treturn {\n\t\tdispatchEvent: eventsManager.dispatchEvent?.bind( eventsManager ),\n\t\tconfig: eventsManager.config,\n\t};\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAM,cAAc,MAAM;AAChC,QAAM,EAAE,eAAe,OAAO,IAAI,YAAY;AAE9C,SAAO;AAAA,IACN;AAAA,IACA;AAAA,EACD;AACD;AAEO,IAAM,aAAa,CAAiE,UAAc;AACxG,QAAM,EAAE,cAAc,IAAI,YAAY;AACtC,kBAAiB,MAAM,WAAW,KAAM;AACzC;AAEO,IAAM,cAAc,MAAM;AAChC,QAAM,gBAAgB,OAAO,iBAAiB,iBAAiB,CAAC;AAChE,SAAO;AAAA,IACN,eAAe,cAAc,eAAe,KAAM,aAAc;AAAA,IAChE,QAAQ,cAAc;AAAA,EACvB;AACD;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/use-mixpanel.ts"],"sourcesContent":["export * from './use-mixpanel';\n","export const getMixpanel = () => {\n\tconst eventsManager = window.elementorCommon?.eventsManager || {};\n\treturn {\n\t\tdispatchEvent: eventsManager.dispatchEvent?.bind( eventsManager ),\n\t\tconfig: eventsManager.config,\n\t\tcanSendEvents: eventsManager.canSendEvents?.bind( eventsManager ),\n\t\tinitializeMixpanel: eventsManager.initializeMixpanel?.bind( eventsManager ),\n\t\tenableTracking: eventsManager.enableTracking?.bind( eventsManager ),\n\t\tisMixpanelReady: eventsManager.isMixpanelReady?.bind( eventsManager ),\n\t\ttrackingEnabled: eventsManager.trackingEnabled ?? false,\n\t\tgetMixpanelInstance: eventsManager.getMixpanelInstance?.bind( eventsManager ),\n\t};\n};\n\nexport const useMixpanel = () => {\n\tconst { dispatchEvent, config } = getMixpanel();\n\n\treturn {\n\t\tdispatchEvent,\n\t\tconfig,\n\t};\n};\n\nexport const trackEvent = < T extends { eventName: string } & Record< string, unknown > >( event: T ) => {\n\tconst { dispatchEvent } = getMixpanel();\n\tdispatchEvent?.( event.eventName, event );\n};\n\nexport const canSendEvents = (): boolean => getMixpanel().canSendEvents?.() ?? false;\n\nexport const setCanSendEvents = ( value: boolean ): void => {\n\tconst editorEvents = window.elementorCommon?.config?.editor_events;\n\tif ( editorEvents ) {\n\t\teditorEvents.can_send_events = value;\n\t}\n};\n\nexport const isMixpanelReady = (): boolean => getMixpanel().isMixpanelReady?.() ?? false;\n\nexport const isTrackingEnabled = (): boolean => getMixpanel().trackingEnabled;\n\nexport const enableTracking = (): void => getMixpanel().enableTracking?.();\n\nexport const initializeMixpanel = ( onLoaded?: () => void ): void =>\n\tgetMixpanel().initializeMixpanel?.( onLoaded ?? ( () => {} ) );\n\nexport function initializeAndEnableTracking( onReady?: ( mpInstance?: unknown ) => void ): void {\n\tconst mixpanel = getMixpanel();\n\n\tif ( ! mixpanel.dispatchEvent ) {\n\t\treturn;\n\t}\n\n\tif ( mixpanel.trackingEnabled ) {\n\t\tonReady?.( mixpanel.getMixpanelInstance?.() );\n\t\treturn;\n\t}\n\n\tif ( mixpanel.isMixpanelReady?.() ) {\n\t\tmixpanel.enableTracking?.();\n\t\tonReady?.( mixpanel.getMixpanelInstance?.() );\n\t\treturn;\n\t}\n\n\tmixpanel.initializeMixpanel?.( ( mpInstance: unknown ) => {\n\t\tmixpanel.enableTracking?.();\n\t\tonReady?.( mpInstance );\n\t} );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAM,cAAc,MAAM;AAChC,QAAM,gBAAgB,OAAO,iBAAiB,iBAAiB,CAAC;AAChE,SAAO;AAAA,IACN,eAAe,cAAc,eAAe,KAAM,aAAc;AAAA,IAChE,QAAQ,cAAc;AAAA,IACtB,eAAe,cAAc,eAAe,KAAM,aAAc;AAAA,IAChE,oBAAoB,cAAc,oBAAoB,KAAM,aAAc;AAAA,IAC1E,gBAAgB,cAAc,gBAAgB,KAAM,aAAc;AAAA,IAClE,iBAAiB,cAAc,iBAAiB,KAAM,aAAc;AAAA,IACpE,iBAAiB,cAAc,mBAAmB;AAAA,IAClD,qBAAqB,cAAc,qBAAqB,KAAM,aAAc;AAAA,EAC7E;AACD;AAEO,IAAM,cAAc,MAAM;AAChC,QAAM,EAAE,eAAe,OAAO,IAAI,YAAY;AAE9C,SAAO;AAAA,IACN;AAAA,IACA;AAAA,EACD;AACD;AAEO,IAAM,aAAa,CAAiE,UAAc;AACxG,QAAM,EAAE,cAAc,IAAI,YAAY;AACtC,kBAAiB,MAAM,WAAW,KAAM;AACzC;AAEO,IAAM,gBAAgB,MAAe,YAAY,EAAE,gBAAgB,KAAK;AAExE,IAAM,mBAAmB,CAAE,UAA0B;AAC3D,QAAM,eAAe,OAAO,iBAAiB,QAAQ;AACrD,MAAK,cAAe;AACnB,iBAAa,kBAAkB;AAAA,EAChC;AACD;AAEO,IAAM,kBAAkB,MAAe,YAAY,EAAE,kBAAkB,KAAK;AAE5E,IAAM,oBAAoB,MAAe,YAAY,EAAE;AAEvD,IAAM,iBAAiB,MAAY,YAAY,EAAE,iBAAiB;AAElE,IAAM,qBAAqB,CAAE,aACnC,YAAY,EAAE,qBAAsB,aAAc,MAAM;AAAC,EAAI;AAEvD,SAAS,4BAA6B,SAAmD;AAC/F,QAAM,WAAW,YAAY;AAE7B,MAAK,CAAE,SAAS,eAAgB;AAC/B;AAAA,EACD;AAEA,MAAK,SAAS,iBAAkB;AAC/B,cAAW,SAAS,sBAAsB,CAAE;AAC5C;AAAA,EACD;AAEA,MAAK,SAAS,kBAAkB,GAAI;AACnC,aAAS,iBAAiB;AAC1B,cAAW,SAAS,sBAAsB,CAAE;AAC5C;AAAA,EACD;AAEA,WAAS,qBAAsB,CAAE,eAAyB;AACzD,aAAS,iBAAiB;AAC1B,cAAW,UAAW;AAAA,EACvB,CAAE;AACH;","names":[]}

package/dist/index.mjs

@@ -1,4 +1,17 @@
 // src/use-mixpanel.ts
+var getMixpanel = () => {
+  const eventsManager = window.elementorCommon?.eventsManager || {};
+  return {
+    dispatchEvent: eventsManager.dispatchEvent?.bind(eventsManager),
+    config: eventsManager.config,
+    canSendEvents: eventsManager.canSendEvents?.bind(eventsManager),
+    initializeMixpanel: eventsManager.initializeMixpanel?.bind(eventsManager),
+    enableTracking: eventsManager.enableTracking?.bind(eventsManager),
+    isMixpanelReady: eventsManager.isMixpanelReady?.bind(eventsManager),
+    trackingEnabled: eventsManager.trackingEnabled ?? false,
+    getMixpanelInstance: eventsManager.getMixpanelInstance?.bind(eventsManager)
+  };
+};
 var useMixpanel = () => {
   const { dispatchEvent, config } = getMixpanel();
   return {
@@ -10,15 +23,46 @@ var trackEvent = (event) => {
   const { dispatchEvent } = getMixpanel();
   dispatchEvent?.(event.eventName, event);
 };
-var getMixpanel = () => {
-  const eventsManager = window.elementorCommon?.eventsManager || {};
-  return {
-    dispatchEvent: eventsManager.dispatchEvent?.bind(eventsManager),
-    config: eventsManager.config
-  };
+var canSendEvents = () => getMixpanel().canSendEvents?.() ?? false;
+var setCanSendEvents = (value) => {
+  const editorEvents = window.elementorCommon?.config?.editor_events;
+  if (editorEvents) {
+    editorEvents.can_send_events = value;
+  }
 };
+var isMixpanelReady = () => getMixpanel().isMixpanelReady?.() ?? false;
+var isTrackingEnabled = () => getMixpanel().trackingEnabled;
+var enableTracking = () => getMixpanel().enableTracking?.();
+var initializeMixpanel = (onLoaded) => getMixpanel().initializeMixpanel?.(onLoaded ?? (() => {
+}));
+function initializeAndEnableTracking(onReady) {
+  const mixpanel = getMixpanel();
+  if (!mixpanel.dispatchEvent) {
+    return;
+  }
+  if (mixpanel.trackingEnabled) {
+    onReady?.(mixpanel.getMixpanelInstance?.());
+    return;
+  }
+  if (mixpanel.isMixpanelReady?.()) {
+    mixpanel.enableTracking?.();
+    onReady?.(mixpanel.getMixpanelInstance?.());
+    return;
+  }
+  mixpanel.initializeMixpanel?.((mpInstance) => {
+    mixpanel.enableTracking?.();
+    onReady?.(mpInstance);
+  });
+}
 export {
+  canSendEvents,
+  enableTracking,
   getMixpanel,
+  initializeAndEnableTracking,
+  initializeMixpanel,
+  isMixpanelReady,
+  isTrackingEnabled,
+  setCanSendEvents,
   trackEvent,
   useMixpanel
 };

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/use-mixpanel.ts"],"sourcesContent":["export const useMixpanel = () => {\n\tconst { dispatchEvent, config } = getMixpanel();\n\n\treturn {\n\t\tdispatchEvent,\n\t\tconfig,\n\t};\n};\n\nexport const trackEvent = < T extends { eventName: string } & Record< string, unknown > >( event: T ) => {\n\tconst { dispatchEvent } = getMixpanel();\n\tdispatchEvent?.( event.eventName, event );\n};\n\nexport const getMixpanel = () => {\n\tconst eventsManager = window.elementorCommon?.eventsManager || {};\n\treturn {\n\t\tdispatchEvent: eventsManager.dispatchEvent?.bind( eventsManager ),\n\t\tconfig: eventsManager.config,\n\t};\n};\n"],"mappings":";AAAO,IAAM,cAAc,MAAM;AAChC,QAAM,EAAE,eAAe,OAAO,IAAI,YAAY;AAE9C,SAAO;AAAA,IACN;AAAA,IACA;AAAA,EACD;AACD;AAEO,IAAM,aAAa,CAAiE,UAAc;AACxG,QAAM,EAAE,cAAc,IAAI,YAAY;AACtC,kBAAiB,MAAM,WAAW,KAAM;AACzC;AAEO,IAAM,cAAc,MAAM;AAChC,QAAM,gBAAgB,OAAO,iBAAiB,iBAAiB,CAAC;AAChE,SAAO;AAAA,IACN,eAAe,cAAc,eAAe,KAAM,aAAc;AAAA,IAChE,QAAQ,cAAc;AAAA,EACvB;AACD;","names":[]}
+{"version":3,"sources":["../src/use-mixpanel.ts"],"sourcesContent":["export const getMixpanel = () => {\n\tconst eventsManager = window.elementorCommon?.eventsManager || {};\n\treturn {\n\t\tdispatchEvent: eventsManager.dispatchEvent?.bind( eventsManager ),\n\t\tconfig: eventsManager.config,\n\t\tcanSendEvents: eventsManager.canSendEvents?.bind( eventsManager ),\n\t\tinitializeMixpanel: eventsManager.initializeMixpanel?.bind( eventsManager ),\n\t\tenableTracking: eventsManager.enableTracking?.bind( eventsManager ),\n\t\tisMixpanelReady: eventsManager.isMixpanelReady?.bind( eventsManager ),\n\t\ttrackingEnabled: eventsManager.trackingEnabled ?? false,\n\t\tgetMixpanelInstance: eventsManager.getMixpanelInstance?.bind( eventsManager ),\n\t};\n};\n\nexport const useMixpanel = () => {\n\tconst { dispatchEvent, config } = getMixpanel();\n\n\treturn {\n\t\tdispatchEvent,\n\t\tconfig,\n\t};\n};\n\nexport const trackEvent = < T extends { eventName: string } & Record< string, unknown > >( event: T ) => {\n\tconst { dispatchEvent } = getMixpanel();\n\tdispatchEvent?.( event.eventName, event );\n};\n\nexport const canSendEvents = (): boolean => getMixpanel().canSendEvents?.() ?? false;\n\nexport const setCanSendEvents = ( value: boolean ): void => {\n\tconst editorEvents = window.elementorCommon?.config?.editor_events;\n\tif ( editorEvents ) {\n\t\teditorEvents.can_send_events = value;\n\t}\n};\n\nexport const isMixpanelReady = (): boolean => getMixpanel().isMixpanelReady?.() ?? false;\n\nexport const isTrackingEnabled = (): boolean => getMixpanel().trackingEnabled;\n\nexport const enableTracking = (): void => getMixpanel().enableTracking?.();\n\nexport const initializeMixpanel = ( onLoaded?: () => void ): void =>\n\tgetMixpanel().initializeMixpanel?.( onLoaded ?? ( () => {} ) );\n\nexport function initializeAndEnableTracking( onReady?: ( mpInstance?: unknown ) => void ): void {\n\tconst mixpanel = getMixpanel();\n\n\tif ( ! mixpanel.dispatchEvent ) {\n\t\treturn;\n\t}\n\n\tif ( mixpanel.trackingEnabled ) {\n\t\tonReady?.( mixpanel.getMixpanelInstance?.() );\n\t\treturn;\n\t}\n\n\tif ( mixpanel.isMixpanelReady?.() ) {\n\t\tmixpanel.enableTracking?.();\n\t\tonReady?.( mixpanel.getMixpanelInstance?.() );\n\t\treturn;\n\t}\n\n\tmixpanel.initializeMixpanel?.( ( mpInstance: unknown ) => {\n\t\tmixpanel.enableTracking?.();\n\t\tonReady?.( mpInstance );\n\t} );\n}\n"],"mappings":";AAAO,IAAM,cAAc,MAAM;AAChC,QAAM,gBAAgB,OAAO,iBAAiB,iBAAiB,CAAC;AAChE,SAAO;AAAA,IACN,eAAe,cAAc,eAAe,KAAM,aAAc;AAAA,IAChE,QAAQ,cAAc;AAAA,IACtB,eAAe,cAAc,eAAe,KAAM,aAAc;AAAA,IAChE,oBAAoB,cAAc,oBAAoB,KAAM,aAAc;AAAA,IAC1E,gBAAgB,cAAc,gBAAgB,KAAM,aAAc;AAAA,IAClE,iBAAiB,cAAc,iBAAiB,KAAM,aAAc;AAAA,IACpE,iBAAiB,cAAc,mBAAmB;AAAA,IAClD,qBAAqB,cAAc,qBAAqB,KAAM,aAAc;AAAA,EAC7E;AACD;AAEO,IAAM,cAAc,MAAM;AAChC,QAAM,EAAE,eAAe,OAAO,IAAI,YAAY;AAE9C,SAAO;AAAA,IACN;AAAA,IACA;AAAA,EACD;AACD;AAEO,IAAM,aAAa,CAAiE,UAAc;AACxG,QAAM,EAAE,cAAc,IAAI,YAAY;AACtC,kBAAiB,MAAM,WAAW,KAAM;AACzC;AAEO,IAAM,gBAAgB,MAAe,YAAY,EAAE,gBAAgB,KAAK;AAExE,IAAM,mBAAmB,CAAE,UAA0B;AAC3D,QAAM,eAAe,OAAO,iBAAiB,QAAQ;AACrD,MAAK,cAAe;AACnB,iBAAa,kBAAkB;AAAA,EAChC;AACD;AAEO,IAAM,kBAAkB,MAAe,YAAY,EAAE,kBAAkB,KAAK;AAE5E,IAAM,oBAAoB,MAAe,YAAY,EAAE;AAEvD,IAAM,iBAAiB,MAAY,YAAY,EAAE,iBAAiB;AAElE,IAAM,qBAAqB,CAAE,aACnC,YAAY,EAAE,qBAAsB,aAAc,MAAM;AAAC,EAAI;AAEvD,SAAS,4BAA6B,SAAmD;AAC/F,QAAM,WAAW,YAAY;AAE7B,MAAK,CAAE,SAAS,eAAgB;AAC/B;AAAA,EACD;AAEA,MAAK,SAAS,iBAAkB;AAC/B,cAAW,SAAS,sBAAsB,CAAE;AAC5C;AAAA,EACD;AAEA,MAAK,SAAS,kBAAkB,GAAI;AACnC,aAAS,iBAAiB;AAC1B,cAAW,SAAS,sBAAsB,CAAE;AAC5C;AAAA,EACD;AAEA,WAAS,qBAAsB,CAAE,eAAyB;AACzD,aAAS,iBAAiB;AAC1B,cAAW,UAAW;AAAA,EACvB,CAAE;AACH;","names":[]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@elementor/events",
   "description": "Elementor Events package",
-  "version": "4.0.0-manual",
+  "version": "4.1.0-684",
   "private": false,
   "author": "Elementor Team",
   "homepage": "https://elementor.com/",

package/src/use-mixpanel.ts

@@ -1,3 +1,17 @@
+export const getMixpanel = () => {
+	const eventsManager = window.elementorCommon?.eventsManager || {};
+	return {
+		dispatchEvent: eventsManager.dispatchEvent?.bind( eventsManager ),
+		config: eventsManager.config,
+		canSendEvents: eventsManager.canSendEvents?.bind( eventsManager ),
+		initializeMixpanel: eventsManager.initializeMixpanel?.bind( eventsManager ),
+		enableTracking: eventsManager.enableTracking?.bind( eventsManager ),
+		isMixpanelReady: eventsManager.isMixpanelReady?.bind( eventsManager ),
+		trackingEnabled: eventsManager.trackingEnabled ?? false,
+		getMixpanelInstance: eventsManager.getMixpanelInstance?.bind( eventsManager ),
+	};
+};
+
 export const useMixpanel = () => {
 	const { dispatchEvent, config } = getMixpanel();
 
@@ -12,10 +26,44 @@ export const trackEvent = < T extends { eventName: string } & Record< string, un
 	dispatchEvent?.( event.eventName, event );
 };
 
-export const getMixpanel = () => {
-	const eventsManager = window.elementorCommon?.eventsManager || {};
-	return {
-		dispatchEvent: eventsManager.dispatchEvent?.bind( eventsManager ),
-		config: eventsManager.config,
-	};
+export const canSendEvents = (): boolean => getMixpanel().canSendEvents?.() ?? false;
+
+export const setCanSendEvents = ( value: boolean ): void => {
+	const editorEvents = window.elementorCommon?.config?.editor_events;
+	if ( editorEvents ) {
+		editorEvents.can_send_events = value;
+	}
 };
+
+export const isMixpanelReady = (): boolean => getMixpanel().isMixpanelReady?.() ?? false;
+
+export const isTrackingEnabled = (): boolean => getMixpanel().trackingEnabled;
+
+export const enableTracking = (): void => getMixpanel().enableTracking?.();
+
+export const initializeMixpanel = ( onLoaded?: () => void ): void =>
+	getMixpanel().initializeMixpanel?.( onLoaded ?? ( () => {} ) );
+
+export function initializeAndEnableTracking( onReady?: ( mpInstance?: unknown ) => void ): void {
+	const mixpanel = getMixpanel();
+
+	if ( ! mixpanel.dispatchEvent ) {
+		return;
+	}
+
+	if ( mixpanel.trackingEnabled ) {
+		onReady?.( mixpanel.getMixpanelInstance?.() );
+		return;
+	}
+
+	if ( mixpanel.isMixpanelReady?.() ) {
+		mixpanel.enableTracking?.();
+		onReady?.( mixpanel.getMixpanelInstance?.() );
+		return;
+	}
+
+	mixpanel.initializeMixpanel?.( ( mpInstance: unknown ) => {
+		mixpanel.enableTracking?.();
+		onReady?.( mpInstance );
+	} );
+}