@workleap/mixpanel 2.1.8 → 3.0.0

package/dist/js/properties.js

@@ -45,25 +45,7 @@ function getTelemetryProperties(context) {
 const OtherProperties = {
     LogRocketSessionUrl: "LogRocket Session Url"
 };
-// Equivalent to: https://docs.mixpanel.com/docs/tracking-methods/sdks/javascript#setting-super-properties.
-const superProperties = new Map();
-function setSuperProperty(key, value) {
-    superProperties.set(key, value);
-}
-function setSuperProperties(values) {
-    Object.keys(values).forEach((x)=>{
-        superProperties.set(x, values[x]);
-    });
-}
-// Must always return the actual reference to the super properties, not a copy
-// because it will breaks the global context.
-function getSuperProperties() {
-    return superProperties;
-}
-function __clearSuperProperties() {
-    superProperties.clear();
-}
 
-export { BaseProperties, OtherProperties, TelemetryProperties, __clearSuperProperties, getBaseProperties, getSuperProperties, getTelemetryProperties, setSuperProperties, setSuperProperty };
+export { BaseProperties, OtherProperties, TelemetryProperties, getBaseProperties, getTelemetryProperties };
 
 //# sourceMappingURL=properties.js.map

package/dist/js/properties.js.map

@@ -1 +1 @@
-{"version":3,"file":"js/properties.js","sources":["webpack://@workleap/mixpanel/./src/js/properties.ts"],"sourcesContent":["\nimport type { TelemetryContext } from \"@workleap/telemetry\";\nimport { browserName, browserVersion, deviceType, osName, referringDomain } from \"./utils.ts\";\n\nexport type MixpanelEventProperties = Record<string, unknown>;\n\nexport const BaseProperties = {\n    Browser: \"$browser\",\n    BrowserVersion: \"$browser_version\",\n    CurrentUrl: \"$current_url\",\n    Device: \"$device\",\n    IsMobile: \"Is Mobile\",\n    Os: \"$os\",\n    Referrer: \"$referrer\",\n    ReferringDomain: \"$referring_domain\",\n    ScreenHeight: \"$screen_height\",\n    ScreenWidth: \"$screen_width\"\n} as const;\n\nexport function getBaseProperties() {\n    const userAgent = navigator.userAgent;\n    const device = deviceType(userAgent);\n\n    return {\n        [BaseProperties.Os]: osName(userAgent),\n        [BaseProperties.Browser]: browserName(userAgent, navigator.vendor),\n        [BaseProperties.Referrer]: document.referrer,\n        [BaseProperties.ReferringDomain]: referringDomain(document.referrer),\n        [BaseProperties.Device]: device,\n        [BaseProperties.CurrentUrl]: window.location.href,\n        [BaseProperties.BrowserVersion]: browserVersion(userAgent, navigator.vendor),\n        [BaseProperties.ScreenHeight]: window.screen.height,\n        [BaseProperties.ScreenWidth]: window.screen.width,\n        [BaseProperties.IsMobile]: device.length > 0\n    } satisfies MixpanelEventProperties;\n}\n\nexport const TelemetryProperties = {\n    DeviceId: \"Device Id\",\n    TelemetryId: \"Telemetry Id\"\n} as const;\n\nexport function getTelemetryProperties(context: TelemetryContext) {\n    return {\n        [TelemetryProperties.TelemetryId]: context.telemetryId,\n        [TelemetryProperties.DeviceId]: context.deviceId\n    } satisfies MixpanelEventProperties;\n}\n\nexport const OtherProperties = {\n    LogRocketSessionUrl: \"LogRocket Session Url\"\n};\n\n//////////////////////\n\nexport type SuperProperties = Map<string, unknown>;\n\n// Equivalent to: https://docs.mixpanel.com/docs/tracking-methods/sdks/javascript#setting-super-properties.\nconst superProperties: SuperProperties = new Map<string, unknown>();\n\nexport function setSuperProperty(key: string, value: unknown) {\n    superProperties.set(key, value);\n}\n\nexport function setSuperProperties(values: Record<string, unknown>) {\n    Object.keys(values).forEach(x => {\n        superProperties.set(x, values[x]);\n    });\n}\n\n// Must always return the actual reference to the super properties, not a copy\n// because it will breaks the global context.\nexport function getSuperProperties() {\n    return superProperties;\n}\n\nexport function __clearSuperProperties() {\n    superProperties.clear();\n}\n"],"names":["browserName","browserVersion","deviceType","osName","referringDomain","BaseProperties","getBaseProperties","userAgent","navigator","device","document","window","TelemetryProperties","getTelemetryProperties","context","OtherProperties","superProperties","Map","setSuperProperty","key","value","setSuperProperties","values","Object","x","getSuperProperties","__clearSuperProperties"],"mappings":";;;;;AAE8F;AAIvF,MAAMK,iBAAiB;IAC1B,SAAS;IACT,gBAAgB;IAChB,YAAY;IACZ,QAAQ;IACR,UAAU;IACV,IAAI;IACJ,UAAU;IACV,iBAAiB;IACjB,cAAc;IACd,aAAa;AACjB,EAAW;AAEJ,SAASC;IACZ,MAAMC,YAAYC,UAAU,SAAS;IACrC,MAAMC,SAASP,UAAUA,CAACK;IAE1B,OAAO;QACH,CAACF,eAAe,EAAE,CAAC,EAAEF,MAAMA,CAACI;QAC5B,CAACF,eAAe,OAAO,CAAC,EAAEL,WAAWA,CAACO,WAAWC,UAAU,MAAM;QACjE,CAACH,eAAe,QAAQ,CAAC,EAAEK,SAAS,QAAQ;QAC5C,CAACL,eAAe,eAAe,CAAC,EAAED,eAAeA,CAACM,SAAS,QAAQ;QACnE,CAACL,eAAe,MAAM,CAAC,EAAEI;QACzB,CAACJ,eAAe,UAAU,CAAC,EAAEM,OAAO,QAAQ,CAAC,IAAI;QACjD,CAACN,eAAe,cAAc,CAAC,EAAEJ,cAAcA,CAACM,WAAWC,UAAU,MAAM;QAC3E,CAACH,eAAe,YAAY,CAAC,EAAEM,OAAO,MAAM,CAAC,MAAM;QACnD,CAACN,eAAe,WAAW,CAAC,EAAEM,OAAO,MAAM,CAAC,KAAK;QACjD,CAACN,eAAe,QAAQ,CAAC,EAAEI,OAAO,MAAM,GAAG;IAC/C;AACJ;AAEO,MAAMG,sBAAsB;IAC/B,UAAU;IACV,aAAa;AACjB,EAAW;AAEJ,SAASC,uBAAuBC,OAAyB;IAC5D,OAAO;QACH,CAACF,oBAAoB,WAAW,CAAC,EAAEE,QAAQ,WAAW;QACtD,CAACF,oBAAoB,QAAQ,CAAC,EAAEE,QAAQ,QAAQ;IACpD;AACJ;AAEO,MAAMC,kBAAkB;IAC3B,qBAAqB;AACzB,EAAE;AAMF,2GAA2G;AAC3G,MAAMC,kBAAmC,IAAIC;AAEtC,SAASC,iBAAiBC,GAAW,EAAEC,KAAc;IACxDJ,gBAAgB,GAAG,CAACG,KAAKC;AAC7B;AAEO,SAASC,mBAAmBC,MAA+B;IAC9DC,OAAO,IAAI,CAACD,QAAQ,OAAO,CAACE,CAAAA;QACxBR,gBAAgB,GAAG,CAACQ,GAAGF,MAAM,CAACE,EAAE;IACpC;AACJ;AAEA,8EAA8E;AAC9E,6CAA6C;AACtC,SAASC;IACZ,OAAOT;AACX;AAEO,SAASU;IACZV,gBAAgB,KAAK;AACzB"}
+{"version":3,"file":"js/properties.js","sources":["webpack://@workleap/mixpanel/./src/js/properties.ts"],"sourcesContent":["\nimport type { TelemetryContext } from \"@workleap-telemetry/core\";\nimport { browserName, browserVersion, deviceType, osName, referringDomain } from \"./utils.ts\";\n\nexport type MixpanelEventProperties = Record<string, unknown>;\n\nexport const BaseProperties = {\n    Browser: \"$browser\",\n    BrowserVersion: \"$browser_version\",\n    CurrentUrl: \"$current_url\",\n    Device: \"$device\",\n    IsMobile: \"Is Mobile\",\n    Os: \"$os\",\n    Referrer: \"$referrer\",\n    ReferringDomain: \"$referring_domain\",\n    ScreenHeight: \"$screen_height\",\n    ScreenWidth: \"$screen_width\"\n} as const;\n\nexport function getBaseProperties() {\n    const userAgent = navigator.userAgent;\n    const device = deviceType(userAgent);\n\n    return {\n        [BaseProperties.Os]: osName(userAgent),\n        [BaseProperties.Browser]: browserName(userAgent, navigator.vendor),\n        [BaseProperties.Referrer]: document.referrer,\n        [BaseProperties.ReferringDomain]: referringDomain(document.referrer),\n        [BaseProperties.Device]: device,\n        [BaseProperties.CurrentUrl]: window.location.href,\n        [BaseProperties.BrowserVersion]: browserVersion(userAgent, navigator.vendor),\n        [BaseProperties.ScreenHeight]: window.screen.height,\n        [BaseProperties.ScreenWidth]: window.screen.width,\n        [BaseProperties.IsMobile]: device.length > 0\n    } satisfies MixpanelEventProperties;\n}\n\nexport const TelemetryProperties = {\n    DeviceId: \"Device Id\",\n    TelemetryId: \"Telemetry Id\"\n} as const;\n\nexport function getTelemetryProperties(context: TelemetryContext) {\n    return {\n        [TelemetryProperties.TelemetryId]: context.telemetryId,\n        [TelemetryProperties.DeviceId]: context.deviceId\n    } satisfies MixpanelEventProperties;\n}\n\nexport const OtherProperties = {\n    LogRocketSessionUrl: \"LogRocket Session Url\"\n};\n"],"names":["browserName","browserVersion","deviceType","osName","referringDomain","BaseProperties","getBaseProperties","userAgent","navigator","device","document","window","TelemetryProperties","getTelemetryProperties","context","OtherProperties"],"mappings":";;;;;AAE8F;AAIvF,MAAMK,iBAAiB;IAC1B,SAAS;IACT,gBAAgB;IAChB,YAAY;IACZ,QAAQ;IACR,UAAU;IACV,IAAI;IACJ,UAAU;IACV,iBAAiB;IACjB,cAAc;IACd,aAAa;AACjB,EAAW;AAEJ,SAASC;IACZ,MAAMC,YAAYC,UAAU,SAAS;IACrC,MAAMC,SAASP,UAAUA,CAACK;IAE1B,OAAO;QACH,CAACF,eAAe,EAAE,CAAC,EAAEF,MAAMA,CAACI;QAC5B,CAACF,eAAe,OAAO,CAAC,EAAEL,WAAWA,CAACO,WAAWC,UAAU,MAAM;QACjE,CAACH,eAAe,QAAQ,CAAC,EAAEK,SAAS,QAAQ;QAC5C,CAACL,eAAe,eAAe,CAAC,EAAED,eAAeA,CAACM,SAAS,QAAQ;QACnE,CAACL,eAAe,MAAM,CAAC,EAAEI;QACzB,CAACJ,eAAe,UAAU,CAAC,EAAEM,OAAO,QAAQ,CAAC,IAAI;QACjD,CAACN,eAAe,cAAc,CAAC,EAAEJ,cAAcA,CAACM,WAAWC,UAAU,MAAM;QAC3E,CAACH,eAAe,YAAY,CAAC,EAAEM,OAAO,MAAM,CAAC,MAAM;QACnD,CAACN,eAAe,WAAW,CAAC,EAAEM,OAAO,MAAM,CAAC,KAAK;QACjD,CAACN,eAAe,QAAQ,CAAC,EAAEI,OAAO,MAAM,GAAG;IAC/C;AACJ;AAEO,MAAMG,sBAAsB;IAC/B,UAAU;IACV,aAAa;AACjB,EAAW;AAEJ,SAASC,uBAAuBC,OAAyB;IAC5D,OAAO;QACH,CAACF,oBAAoB,WAAW,CAAC,EAAEE,QAAQ,WAAW;QACtD,CAACF,oBAAoB,QAAQ,CAAC,EAAEE,QAAQ,QAAQ;IACpD;AACJ;AAEO,MAAMC,kBAAkB;IAC3B,qBAAqB;AACzB,EAAE"}

package/dist/react/MixpanelContext.d.ts

@@ -0,0 +1,18 @@
+import { type PropsWithChildren } from "react";
+import type { MixpanelClient } from "../js/MixpanelClient.ts";
+export declare const MixpanelContext: import("react").Context<MixpanelClient | undefined>;
+/**
+ * @see {@link https://workleap.github.io/wl-telemetry}
+ */
+export interface MixpanelProviderProps extends PropsWithChildren {
+    client: MixpanelClient;
+}
+/**
+ * @see {@link https://workleap.github.io/wl-telemetry}
+ */
+export declare function MixpanelProvider(props: MixpanelProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Retrieve the Mixpanel client.
+ * @see {@link https://workleap.github.io/wl-telemetry}
+ */
+export declare function useMixpanelClient(): MixpanelClient;

package/dist/react/MixpanelContext.js

@@ -0,0 +1,34 @@
+import { jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+
+;// CONCATENATED MODULE: external "react/jsx-runtime"
+
+;// CONCATENATED MODULE: external "react"
+
+;// CONCATENATED MODULE: ./src/react/MixpanelContext.tsx
+
+
+const MixpanelContext = /*#__PURE__*/ createContext(undefined);
+/**
+ * @see {@link https://workleap.github.io/wl-telemetry}
+ */ function MixpanelProvider(props) {
+    const { client, children } = props;
+    return /*#__PURE__*/ jsx(MixpanelContext.Provider, {
+        value: client,
+        children: children
+    });
+}
+/**
+ * Retrieve the Mixpanel client.
+ * @see {@link https://workleap.github.io/wl-telemetry}
+ */ function useMixpanelClient() {
+    const client = useContext(MixpanelContext);
+    if (!client) {
+        throw new Error("[mixpanel] The useMixpanelClient function is called before a MixpanelClient instance has been provided.");
+    }
+    return client;
+}
+
+export { MixpanelContext, MixpanelProvider, useMixpanelClient };
+
+//# sourceMappingURL=MixpanelContext.js.map

package/dist/react/MixpanelContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react/MixpanelContext.js","sources":["webpack://@workleap/mixpanel/./src/react/MixpanelContext.tsx"],"sourcesContent":["import { createContext, type PropsWithChildren, useContext } from \"react\";\nimport type { MixpanelClient } from \"../js/MixpanelClient.ts\";\n\nexport const MixpanelContext = createContext<MixpanelClient | undefined>(undefined);\n\n/**\n * @see {@link https://workleap.github.io/wl-telemetry}\n */\nexport interface MixpanelProviderProps extends PropsWithChildren {\n    client: MixpanelClient;\n}\n\n/**\n * @see {@link https://workleap.github.io/wl-telemetry}\n */\nexport function MixpanelProvider(props: MixpanelProviderProps) {\n    const {\n        client,\n        children\n    } = props;\n\n    return (\n        <MixpanelContext.Provider value={client}>\n            {children}\n        </MixpanelContext.Provider>\n    );\n}\n\n/**\n * Retrieve the Mixpanel client.\n * @see {@link https://workleap.github.io/wl-telemetry}\n */\nexport function useMixpanelClient() {\n    const client = useContext(MixpanelContext);\n\n    if (!client) {\n        throw new Error(\"[mixpanel] The useMixpanelClient function is called before a MixpanelClient instance has been provided.\");\n    }\n\n    return client;\n}\n"],"names":["createContext","useContext","MixpanelContext","undefined","MixpanelProvider","props","client","children","useMixpanelClient","Error"],"mappings":";;;;;;;;;AAA0E;AAGnE,MAAME,gCAAkBF,aAAaA,CAA6BG,WAAW;AASpF;;CAEC,GACM,SAASC,iBAAiBC,KAA4B;IACzD,MAAM,EACFC,MAAM,EACNC,QAAQ,EACX,GAAGF;IAEJ,qBACI,IAACH,gBAAgB,QAAQ;QAAC,OAAOI;kBAC5BC;;AAGb;AAEA;;;CAGC,GACM,SAASC;IACZ,MAAMF,SAASL,UAAUA,CAACC;IAE1B,IAAI,CAACI,QAAQ;QACT,MAAM,IAAIG,MAAM;IACpB;IAEA,OAAOH;AACX"}

package/dist/react/index.d.ts

@@ -1 +1,3 @@
+export * from "../js/index.ts";
+export { MixpanelProvider, useMixpanelClient } from "./MixpanelContext.tsx";
 export { useTrackingFunction, type UseTrackingFunctionOptions } from "./useTrackingFunction.ts";

package/dist/react/index.js

@@ -1,10 +1,16 @@
+import { MixpanelProvider, useMixpanelClient } from "./MixpanelContext.js";
 import { useTrackingFunction } from "./useTrackingFunction.js";
+export * from "../js/index.js";
+
+;// CONCATENATED MODULE: external "./MixpanelContext.js"
 
 ;// CONCATENATED MODULE: external "./useTrackingFunction.js"
 
 ;// CONCATENATED MODULE: ./src/react/index.ts
 
 
-export { useTrackingFunction };
+
+
+export { MixpanelProvider, useMixpanelClient, useTrackingFunction };
 
 //# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"react/index.js","sources":["webpack://@workleap/mixpanel/./src/react/index.ts"],"sourcesContent":["export { useTrackingFunction, type UseTrackingFunctionOptions } from \"./useTrackingFunction.ts\";\n\n"],"names":["useTrackingFunction"],"mappings":";;;;;AAAgG"}
+{"version":3,"file":"react/index.js","sources":["webpack://@workleap/mixpanel/./src/react/index.ts"],"sourcesContent":["export * from \"../js/index.ts\";\nexport { MixpanelProvider, useMixpanelClient } from \"./MixpanelContext.tsx\";\nexport { useTrackingFunction, type UseTrackingFunctionOptions } from \"./useTrackingFunction.ts\";\n\n"],"names":["MixpanelProvider","useMixpanelClient","useTrackingFunction"],"mappings":";;;;;;;;;AAA+B;AAC6C;AACoB"}

package/dist/react/useTrackingFunction.d.ts

@@ -1,3 +1,10 @@
-import { type CreateTrackingFunctionOptions } from "../js/createTrackingFunction.ts";
-export type UseTrackingFunctionOptions = CreateTrackingFunctionOptions;
-export declare function useTrackingFunction(options?: UseTrackingFunctionOptions): import("../js/createTrackingFunction.ts").TrackingFunction;
+import { type CreateMixpanelTrackingFunctionOptions } from "../js/createTrackingFunction.ts";
+/**
+ * @see {@link https://workleap.github.io/wl-telemetry}
+ */
+export type UseTrackingFunctionOptions = CreateMixpanelTrackingFunctionOptions;
+/**
+ * Create a Mixpanel tracking function.
+ * @see {@link https://workleap.github.io/wl-telemetry}
+ */
+export declare function useTrackingFunction(options?: UseTrackingFunctionOptions): import("../js/createTrackingFunction.ts").MixpanelTrackingFunction;

package/dist/react/useTrackingFunction.js

@@ -1,20 +1,33 @@
-import { useMemo } from "react";
+import { useContext, useMemo } from "react";
 import { createTrackingFunction } from "../js/createTrackingFunction.js";
+import { MixpanelContext } from "./MixpanelContext.js";
 
 ;// CONCATENATED MODULE: external "react"
 
 ;// CONCATENATED MODULE: external "../js/createTrackingFunction.js"
 
+;// CONCATENATED MODULE: external "./MixpanelContext.js"
+
 ;// CONCATENATED MODULE: ./src/react/useTrackingFunction.ts
 
 
-function useTrackingFunction(options = {}) {
+
+/**
+ * Create a Mixpanel tracking function.
+ * @see {@link https://workleap.github.io/wl-telemetry}
+ */ function useTrackingFunction(options = {}) {
     const { targetProductId } = options;
+    const client = useContext(MixpanelContext);
     return useMemo(()=>{
-        return createTrackingFunction({
+        const trackOptions = {
             targetProductId
-        });
+        };
+        // DEPRECATED: Grace period ends on January 1th 2026.
+        // After the grace period, only create the tracking function from the client, remove the fallback
+        // and also use "useMixpanelClient" to retrieve the client rather than "useContext".
+        return client ? client.createTrackingFunction(trackOptions) : createTrackingFunction(trackOptions);
     }, [
+        client,
         targetProductId
     ]);
 }

package/dist/react/useTrackingFunction.js.map

@@ -1 +1 @@
-{"version":3,"file":"react/useTrackingFunction.js","sources":["webpack://@workleap/mixpanel/./src/react/useTrackingFunction.ts"],"sourcesContent":["import { useMemo } from \"react\";\nimport { createTrackingFunction, type CreateTrackingFunctionOptions } from \"../js/createTrackingFunction.ts\";\n\nexport type UseTrackingFunctionOptions = CreateTrackingFunctionOptions;\n\nexport function useTrackingFunction(options: UseTrackingFunctionOptions = {}) {\n    const {\n        targetProductId\n    } = options;\n\n    return useMemo(() => {\n        return createTrackingFunction({ targetProductId });\n    }, [targetProductId]);\n}\n"],"names":["useMemo","createTrackingFunction","useTrackingFunction","options","targetProductId"],"mappings":";;;;;;;;AAAgC;AAC6E;AAItG,SAASE,oBAAoBC,UAAsC,CAAC,CAAC;IACxE,MAAM,EACFC,eAAe,EAClB,GAAGD;IAEJ,OAAOH,OAAOA,CAAC;QACX,OAAOC,sBAAsBA,CAAC;YAAEG;QAAgB;IACpD,GAAG;QAACA;KAAgB;AACxB"}
+{"version":3,"file":"react/useTrackingFunction.js","sources":["webpack://@workleap/mixpanel/./src/react/useTrackingFunction.ts"],"sourcesContent":["import { useContext, useMemo } from \"react\";\nimport { createTrackingFunction, type CreateMixpanelTrackingFunctionOptions } from \"../js/createTrackingFunction.ts\";\nimport { MixpanelContext } from \"./MixpanelContext.tsx\";\n\n/**\n * @see {@link https://workleap.github.io/wl-telemetry}\n */\nexport type UseTrackingFunctionOptions = CreateMixpanelTrackingFunctionOptions;\n\n/**\n * Create a Mixpanel tracking function.\n * @see {@link https://workleap.github.io/wl-telemetry}\n */\nexport function useTrackingFunction(options: UseTrackingFunctionOptions = {}) {\n    const {\n        targetProductId\n    } = options;\n\n    const client = useContext(MixpanelContext);\n\n    return useMemo(() => {\n        const trackOptions = {\n            targetProductId\n        } satisfies CreateMixpanelTrackingFunctionOptions;\n\n        // DEPRECATED: Grace period ends on January 1th 2026.\n        // After the grace period, only create the tracking function from the client, remove the fallback\n        // and also use \"useMixpanelClient\" to retrieve the client rather than \"useContext\".\n        return client\n            ? client.createTrackingFunction(trackOptions)\n            : createTrackingFunction(trackOptions);\n    }, [client, targetProductId]);\n}\n"],"names":["useContext","useMemo","createTrackingFunction","MixpanelContext","useTrackingFunction","options","targetProductId","client","trackOptions"],"mappings":";;;;;;;;;;;AAA4C;AACyE;AAC7D;AAOxD;;;CAGC,GACM,SAASI,oBAAoBC,UAAsC,CAAC,CAAC;IACxE,MAAM,EACFC,eAAe,EAClB,GAAGD;IAEJ,MAAME,SAASP,UAAUA,CAACG,eAAeA;IAEzC,OAAOF,OAAOA,CAAC;QACX,MAAMO,eAAe;YACjBF;QACJ;QAEA,qDAAqD;QACrD,iGAAiG;QACjG,oFAAoF;QACpF,OAAOC,SACDA,OAAO,sBAAsB,CAACC,gBAC9BN,sBAAsBA,CAACM;IACjC,GAAG;QAACD;QAAQD;KAAgB;AAChC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@workleap/mixpanel",
   "author": "Workleap",
-  "version": "2.1.8",
+  "version": "3.0.0",
   "description": "A package containing utilities for Mixpanel telemetry.",
   "license": "Apache-2.0",
   "repository": {
@@ -24,11 +24,6 @@
       "types": "./dist/react/index.d.ts",
       "import": "./dist/react/index.js",
       "default": "./dist/react/index.js"
-    },
-    "./internal": {
-      "types": "./dist/internal.d.ts",
-      "import": "./dist/internal.js",
-      "default": "./dist/internal.js"
     }
   },
   "files": [
@@ -39,9 +34,13 @@
   ],
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
-    "react-dom": "^18.0.0 || ^19.0.0"
+    "react-dom": "^18.0.0 || ^19.0.0",
+    "@workleap/logrocket": "2.0.0"
   },
   "peerDependenciesMeta": {
+    "@workleap/logrocket": {
+      "optional": true
+    },
     "react": {
       "optional": true
     },
@@ -50,19 +49,19 @@
     }
   },
   "dependencies": {
-    "@workleap/logging": "^1.2.5",
-    "@workleap/telemetry": "1.1.6"
+    "@workleap/logging": "^1.3.0",
+    "@workleap-telemetry/core": "1.0.0"
   },
   "devDependencies": {
-    "@rsbuild/core": "1.4.6",
-    "@rslib/core": "0.10.5",
-    "@types/react": "19.1.8",
-    "@workleap/eslint-plugin": "3.4.2",
-    "@workleap/rslib-configs": "1.0.6",
+    "@rsbuild/core": "1.5.13",
+    "@rslib/core": "0.15.0",
+    "@types/react": "19.2.0",
+    "@workleap/eslint-plugin": "3.5.0",
+    "@workleap/rslib-configs": "1.1.0",
     "@workleap/typescript-configs": "3.0.4",
     "eslint": "8.57.1",
-    "happy-dom": "18.0.1",
-    "typescript": "5.8.3",
+    "happy-dom": "19.0.2",
+    "typescript": "5.9.3",
     "vitest": "3.2.4"
   },
   "sideEffects": false,

package/src/js/MixpanelClient.ts

@@ -0,0 +1,85 @@
+import type { Logger } from "@workleap/logging";
+import type { CreateMixpanelTrackingFunctionOptions, MixpanelTrackingFunction } from "./createTrackingFunction.ts";
+import { getBaseProperties } from "./properties.ts";
+
+export type MixpanelGlobalEventProperties = Map<string, unknown>;
+
+/**
+ * @see {@link https://workleap.github.io/wl-telemetry}
+ */
+export class MixpanelClient {
+    readonly #productId: string;
+    readonly #endpoint: string;
+    readonly #globalEventProperties: MixpanelGlobalEventProperties;
+    readonly #logger: Logger;
+
+    constructor(productId: string, endpoint: string, globalEventProperties: MixpanelGlobalEventProperties, logger: Logger) {
+        this.#productId = productId;
+        this.#endpoint = endpoint;
+        this.#globalEventProperties = globalEventProperties;
+        this.#logger = logger;
+    }
+
+    /**
+     * @see {@link https://workleap.github.io/wl-telemetry}
+     */
+    createTrackingFunction(options: CreateMixpanelTrackingFunctionOptions = {}) {
+        const {
+            targetProductId
+        } = options;
+
+        const trackFunction: MixpanelTrackingFunction = async (eventName, properties, _options = {}) => {
+            try {
+                const {
+                    keepAlive = false
+                } = _options;
+
+                const baseProperties = getBaseProperties();
+
+                const allProperties = {
+                    ...baseProperties,
+                    ...Object.fromEntries(this.#globalEventProperties),
+                    ...properties
+                };
+
+                await fetch(this.#endpoint, {
+                    method: "POST",
+                    credentials: "include",
+                    keepalive: keepAlive,
+                    headers: { "Content-Type": "application/json" },
+                    body: JSON.stringify({
+                        eventName,
+                        productIdentifier: this.#productId,
+                        // Not sure why, but it seems important to send "null" if not target product identifier
+                        // are provided.
+                        targetProductIdentifier : targetProductId ?? null,
+                        properties: allProperties
+                    })
+                });
+            } catch (error: unknown) {
+                this.#logger
+                    .withText(`[mixpanel] An error occurred while sending a tracking event to "${this.#endpoint}":`)
+                    .withError(error as Error)
+                    .error();
+            }
+        };
+
+        return trackFunction;
+    }
+
+    /**
+     * @see {@link https://workleap.github.io/wl-telemetry}
+     */
+    setGlobalEventProperty(key: string, value: unknown) {
+        this.#globalEventProperties.set(key, value);
+    }
+
+    /**
+     * @see {@link https://workleap.github.io/wl-telemetry}
+     */
+    setGlobalEventProperties(values: Record<string, unknown>) {
+        Object.keys(values).forEach(x => {
+            this.#globalEventProperties.set(x, values[x]);
+        });
+    }
+}

package/src/js/context.ts

@@ -1,12 +1,16 @@
+// DEPRECATED: Grace period ends on January 1th 2026.
+// Must keep this code until the end of the grace period because host applications using version 2.* of
+// this package would get runtime errors from the Platform Widgets CDN otherwise.
+
 import type { Logger } from "@workleap/logging";
-import type { SuperProperties } from "./properties.ts";
+import type { MixpanelGlobalEventProperties } from "./MixpanelClient.ts";
 
 export const MixpanelContextVariableName = "__WLP_MIXPANEL_CONTEXT__";
 
 export interface MixpanelContext {
     productId: string;
     endpoint: string;
-    superProperties: SuperProperties;
+    globalEventProperties: MixpanelGlobalEventProperties;
     logger: Logger;
 }
 

package/src/js/createTrackingFunction.ts

@@ -1,10 +1,14 @@
+// DEPRECATED: Grace period ends on January 1th 2026.
+// Must keep this code until the end of the grace period because host applications using version 2.* of
+// this package would get runtime errors from the Platform Widgets CDN otherwise.
+
 import { getMixpanelContext } from "./context.ts";
 import { getBaseProperties, type MixpanelEventProperties } from "./properties.ts";
 
 /**
  * @see {@link https://workleap.github.io/wl-telemetry}
  */
-export interface CreateTrackingFunctionOptions {
+export interface CreateMixpanelTrackingFunctionOptions {
     /**
      * The product identifier of the target product.
      */
@@ -14,7 +18,7 @@ export interface CreateTrackingFunctionOptions {
 /**
  * @see {@link https://workleap.github.io/wl-telemetry}
  */
-export interface TrackingFunctionOptions {
+export interface MixpanelTrackingFunctionOptions {
     /**
    * Whether to keep the connection alive for the tracking request.
    * It is mostly used for tracking links where the user might navigate away before the request is completed.
@@ -35,12 +39,12 @@ export interface TrackingFunctionOptions {
  * @param options Options for tracking the event.
  * @see {@link https://workleap.github.io/wl-telemetry}
  */
-export type TrackingFunction = (eventName: string, properties: MixpanelEventProperties, options?: TrackingFunctionOptions) => Promise<void>;
+export type MixpanelTrackingFunction = (eventName: string, properties: MixpanelEventProperties, options?: MixpanelTrackingFunctionOptions) => Promise<void>;
 
 /**
  * @see {@link https://workleap.github.io/wl-telemetry}
  */
-export function createTrackingFunction(options: CreateTrackingFunctionOptions = {}) {
+export function createTrackingFunction(options: CreateMixpanelTrackingFunctionOptions = {}) {
     const {
         targetProductId
     } = options;
@@ -48,11 +52,11 @@ export function createTrackingFunction(options: CreateTrackingFunctionOptions =
     const {
         productId,
         endpoint,
-        superProperties,
+        globalEventProperties,
         logger
     } = getMixpanelContext();
 
-    const trackFunction: TrackingFunction = async (eventName, properties, _options = {}) => {
+    const trackFunction: MixpanelTrackingFunction = async (eventName, properties, _options = {}) => {
         try {
             const {
                 keepAlive = false
@@ -62,7 +66,7 @@ export function createTrackingFunction(options: CreateTrackingFunctionOptions =
 
             const allProperties = {
                 ...baseProperties,
-                ...Object.fromEntries(superProperties),
+                ...Object.fromEntries(globalEventProperties),
                 ...properties
             };
 

package/src/js/env.ts

@@ -1,9 +1,8 @@
-
 const EnvironmentList = ["development", "staging", "production", "local", "msw"] as const;
 
-export type Environment = typeof EnvironmentList[number];
+export type MixpanelEnvironment = typeof EnvironmentList[number];
 
-const NavigationApiBaseUrl: Record<Environment, string> = {
+const NavigationApiBaseUrl: Record<MixpanelEnvironment, string> = {
     "production": "https://api.platform.workleap.com/shell/navigation/",
     "staging": "https://api.platform.workleap-stg.com/shell/navigation/",
     "development": "https://api.platform.workleap-dev.com/shell/navigation/",
@@ -16,11 +15,11 @@ function resolveApiUrl(path: string, baseUrl: string | undefined) : string {
     return `${baseUrl}${baseUrl!.endsWith("/") ? "" : "/"}${path.startsWith("/") ? path.substring(1) : path}`;
 }
 
-export function getTrackingEndpoint(envOrTrackingApiBaseUrl: Environment | (string & {}), trackingEndpoint = "tracking/track"): string {
+export function getTrackingEndpoint(envOrTrackingApiBaseUrl: MixpanelEnvironment | (string & {}), trackingEndpoint = "tracking/track"): string {
     let baseUrl: string;
 
-    if (EnvironmentList.includes(envOrTrackingApiBaseUrl as Environment)) {
-        baseUrl = NavigationApiBaseUrl[envOrTrackingApiBaseUrl as Environment];
+    if (EnvironmentList.includes(envOrTrackingApiBaseUrl as MixpanelEnvironment)) {
+        baseUrl = NavigationApiBaseUrl[envOrTrackingApiBaseUrl as MixpanelEnvironment];
     } else {
         baseUrl = envOrTrackingApiBaseUrl;
     }

package/src/js/index.ts

@@ -1,5 +1,7 @@
-export { createTrackingFunction, type CreateTrackingFunctionOptions, type TrackingFunction, type TrackingFunctionOptions } from "./createTrackingFunction.ts";
-export type { Environment } from "./env.ts";
+export { createTelemetryContext, type CreateTelemetryContextOptions, type TelemetryContext } from "@workleap-telemetry/core";
+export { createTrackingFunction, type CreateMixpanelTrackingFunctionOptions, type MixpanelTrackingFunction, type MixpanelTrackingFunctionOptions } from "./createTrackingFunction.ts";
+export type { MixpanelEnvironment } from "./env.ts";
 export { initializeMixpanel, type InitializeMixpanelOptions } from "./initializeMixpanel.ts";
-export { setSuperProperties, setSuperProperty, type MixpanelEventProperties } from "./properties.ts";
+export { MixpanelClient, type MixpanelGlobalEventProperties } from "./MixpanelClient.ts";
+export { type MixpanelEventProperties } from "./properties.ts";