mytart 0.6.5 → 0.6.7

package/README.md

@@ -271,7 +271,7 @@ When enabled:
 
 - The official `https://www.clarity.ms/tag/{projectId}` script is loaded once on the first `track()`, `identify()`, or `page()` call
 - `track()` fires `clarity('event', eventName)` and sets each property as a custom tag via `clarity('set', key, value)`
-- `identify()` calls `clarity('identify', userId)` with an optional friendly name from `traits.name`, and sets remaining traits as custom tags
+- `identify()` calls `clarity('identify', userId, sessionId, undefined, friendlyName)` with session ID as the native `custom-session-id` parameter, and sets remaining traits as custom tags
 - `page()` fires a `PageView` event and sets `pageUrl`, `pageName`, and `referrer` as custom tags
 - SSR-safe: silently succeeds when `window` is undefined
 
@@ -419,13 +419,15 @@ await analytics.identify({ userId: 'user-789', traits: { email: 'alice@example.c
 
 All providers receive the current state in their `track()`, `identify()`, and `page()` calls. Each provider maps state to its API correctly:
 
-- **GA4** — `user_id` and `session_id` in Measurement Protocol
+- **GA4** — `user_id` and `session_id` in Measurement Protocol and gtag.js event params
 - **Segment** — `userId`, `anonymousId`, `sessionId` in track/identify/page
 - **Amplitude** — `user_id`, `device_id`, `session_id` in events
 - **PostHog** — `distinct_id` and `$session_id` in properties
-- **Mixpanel** — `distinct_id` in events
+- **Mixpanel** — `distinct_id` and `$session_id` in events
 - **Meta Pixel (server)** — `external_id` in user_data, `xpl_anonymous_id` and `xpl_session_id` in custom_data
-- **Clarity** — `userId` passed to `clarity('identify')`
+- **Meta Pixel (browser)** — `xpl_session_id` in event properties
+- **Clarity** — `userId` passed to `clarity('identify', userId, sessionId, undefined, friendlyName)`, `sessionId` also set as custom tag
+- **Plausible** — does not support user identification (privacy-first, by design)
 
 ## API Reference
 
@@ -549,12 +551,14 @@ All types are exported:
 
 ```typescript
 import type {
-  MytartConfig, BaseProviderConfig, ProviderConfig, TrackOptions, IdentifyOptions, PageOptions,
+  MytartConfig, MytartState, BaseProviderConfig, ProviderConfig, TrackOptions, IdentifyOptions, PageOptions,
   TrackResult, MytartError, EventContext, ProviderName, GoogleAnalyticsAppType,
   GoogleAnalyticsConfig, ConsentSettings, ConsentState, MixpanelConfig, SegmentConfig,
   AmplitudeConfig, PlausibleConfig, PostHogConfig, MetaPixelConfig, MetaPixelAppType,
   MetaPixelAdvancedMatching, ClarityConfig,
 } from 'mytart';
+
+import type { MytartLike } from 'mytart'; // interface for custom providers
 ```
 
 ## Custom Providers

package/dist/index.d.mts

@@ -791,9 +791,9 @@ declare class MixpanelProvider extends BaseProvider {
     private readonly http;
     constructor(config: MixpanelConfig, mytart: MytartLike);
     private encodeData;
-    track({ event, properties, userId, anonymousId, timestamp }: TrackOptions): Promise<TrackResult>;
-    identify({ userId, traits }: IdentifyOptions): Promise<TrackResult>;
-    page({ name, url, userId, anonymousId, properties }: PageOptions): Promise<TrackResult>;
+    track({ event, properties, userId, anonymousId, sessionId, timestamp }: TrackOptions): Promise<TrackResult>;
+    identify({ userId, traits, sessionId }: IdentifyOptions): Promise<TrackResult>;
+    page({ name, url, userId, anonymousId, sessionId, properties }: PageOptions): Promise<TrackResult>;
 }
 
 declare class SegmentProvider extends BaseProvider {
@@ -828,7 +828,7 @@ declare class PlausibleProvider extends BaseProvider {
     private buildHeaders;
     track({ event, properties, context }: TrackOptions): Promise<TrackResult>;
     identify(_options: IdentifyOptions): Promise<TrackResult>;
-    page({ name, url, properties }: PageOptions): Promise<TrackResult>;
+    page({ name, url, referrer, properties }: PageOptions): Promise<TrackResult>;
 }
 
 declare class PostHogProvider extends BaseProvider {
@@ -945,4 +945,4 @@ declare class ClarityProvider extends BaseProvider {
     page(options: PageOptions): Promise<TrackResult>;
 }
 
-export { type AmplitudeConfig, AmplitudeProvider, BaseProvider, type BaseProviderConfig, type CapturedIds, type ClarityConfig, ClarityProvider, type ConsentSettings, type ConsentState, type EventContext, type GoogleAnalyticsAppType, type GoogleAnalyticsConfig, GoogleAnalyticsProvider, type IdentifyOptions, type MetaPixelAdvancedMatching, type MetaPixelAppType, type MetaPixelConfig, MetaPixelProvider, type MixpanelConfig, MixpanelProvider, Mytart, type MytartConfig, type MytartError, type PageOptions, type PlausibleConfig, PlausibleProvider, type PostHogConfig, PostHogProvider, type ProviderConfig, type ProviderName, type SegmentConfig, SegmentProvider, type TrackOptions, type TrackResult };
+export { type AmplitudeConfig, AmplitudeProvider, BaseProvider, type BaseProviderConfig, type CapturedIds, type ClarityConfig, ClarityProvider, type ConsentSettings, type ConsentState, type EventContext, type GoogleAnalyticsAppType, type GoogleAnalyticsConfig, GoogleAnalyticsProvider, type IdentifyOptions, type MetaPixelAdvancedMatching, type MetaPixelAppType, type MetaPixelConfig, MetaPixelProvider, type MixpanelConfig, MixpanelProvider, Mytart, type MytartConfig, type MytartError, type MytartLike, type MytartState, type PageOptions, type PlausibleConfig, PlausibleProvider, type PostHogConfig, PostHogProvider, type ProviderConfig, type ProviderName, type SegmentConfig, SegmentProvider, type TrackOptions, type TrackResult };

package/dist/index.d.ts

@@ -791,9 +791,9 @@ declare class MixpanelProvider extends BaseProvider {
     private readonly http;
     constructor(config: MixpanelConfig, mytart: MytartLike);
     private encodeData;
-    track({ event, properties, userId, anonymousId, timestamp }: TrackOptions): Promise<TrackResult>;
-    identify({ userId, traits }: IdentifyOptions): Promise<TrackResult>;
-    page({ name, url, userId, anonymousId, properties }: PageOptions): Promise<TrackResult>;
+    track({ event, properties, userId, anonymousId, sessionId, timestamp }: TrackOptions): Promise<TrackResult>;
+    identify({ userId, traits, sessionId }: IdentifyOptions): Promise<TrackResult>;
+    page({ name, url, userId, anonymousId, sessionId, properties }: PageOptions): Promise<TrackResult>;
 }
 
 declare class SegmentProvider extends BaseProvider {
@@ -828,7 +828,7 @@ declare class PlausibleProvider extends BaseProvider {
     private buildHeaders;
     track({ event, properties, context }: TrackOptions): Promise<TrackResult>;
     identify(_options: IdentifyOptions): Promise<TrackResult>;
-    page({ name, url, properties }: PageOptions): Promise<TrackResult>;
+    page({ name, url, referrer, properties }: PageOptions): Promise<TrackResult>;
 }
 
 declare class PostHogProvider extends BaseProvider {
@@ -945,4 +945,4 @@ declare class ClarityProvider extends BaseProvider {
     page(options: PageOptions): Promise<TrackResult>;
 }
 
-export { type AmplitudeConfig, AmplitudeProvider, BaseProvider, type BaseProviderConfig, type CapturedIds, type ClarityConfig, ClarityProvider, type ConsentSettings, type ConsentState, type EventContext, type GoogleAnalyticsAppType, type GoogleAnalyticsConfig, GoogleAnalyticsProvider, type IdentifyOptions, type MetaPixelAdvancedMatching, type MetaPixelAppType, type MetaPixelConfig, MetaPixelProvider, type MixpanelConfig, MixpanelProvider, Mytart, type MytartConfig, type MytartError, type PageOptions, type PlausibleConfig, PlausibleProvider, type PostHogConfig, PostHogProvider, type ProviderConfig, type ProviderName, type SegmentConfig, SegmentProvider, type TrackOptions, type TrackResult };
+export { type AmplitudeConfig, AmplitudeProvider, BaseProvider, type BaseProviderConfig, type CapturedIds, type ClarityConfig, ClarityProvider, type ConsentSettings, type ConsentState, type EventContext, type GoogleAnalyticsAppType, type GoogleAnalyticsConfig, GoogleAnalyticsProvider, type IdentifyOptions, type MetaPixelAdvancedMatching, type MetaPixelAppType, type MetaPixelConfig, MetaPixelProvider, type MixpanelConfig, MixpanelProvider, Mytart, type MytartConfig, type MytartError, type MytartLike, type MytartState, type PageOptions, type PlausibleConfig, PlausibleProvider, type PostHogConfig, PostHogProvider, type ProviderConfig, type ProviderName, type SegmentConfig, SegmentProvider, type TrackOptions, type TrackResult };

package/dist/index.js

@@ -166,6 +166,9 @@ var GoogleAnalyticsProvider = class extends BaseProvider {
     this.http = createHttpClient();
     this.endpoint = config.debug ? GA4_DEBUG_ENDPOINT : GA4_ENDPOINT;
     this.isBrowser = config.appType === "browser";
+    if (this.isBrowser) {
+      this.gtagReady = this.initGtag();
+    }
   }
   /**
    * Initializes the gtag.js snippet exactly as Google's official documentation
@@ -245,7 +248,7 @@ var GoogleAnalyticsProvider = class extends BaseProvider {
   // ---------------------------------------------------------------------------
   // Browser mode methods — delegate to gtag()
   // ---------------------------------------------------------------------------
-  async trackBrowser({ event, properties, userId }) {
+  async trackBrowser({ event, properties, userId, sessionId }) {
     if (typeof window === "undefined") {
       return this.buildGtagResult();
     }
@@ -253,21 +256,28 @@ var GoogleAnalyticsProvider = class extends BaseProvider {
     if (userId) {
       window.gtag("set", { user_id: userId });
     }
-    window.gtag("event", event, properties ?? {});
+    const params = { ...properties };
+    if (sessionId) {
+      params["session_id"] = sessionId;
+    }
+    window.gtag("event", event, params);
     return this.buildGtagResult();
   }
-  async identifyBrowser({ userId, traits }) {
+  async identifyBrowser({ userId, traits, sessionId }) {
     if (typeof window === "undefined") {
       return this.buildGtagResult();
     }
     await this.ensureGtag();
     window.gtag("set", { user_id: userId });
+    if (sessionId) {
+      window.gtag("set", { session_id: sessionId });
+    }
     if (traits) {
       window.gtag("set", "user_properties", traits);
     }
     return this.buildGtagResult();
   }
-  async pageBrowser({ name, url, referrer, userId }) {
+  async pageBrowser({ name, url, referrer, userId, sessionId }) {
     if (typeof window === "undefined") {
       return this.buildGtagResult();
     }
@@ -275,11 +285,15 @@ var GoogleAnalyticsProvider = class extends BaseProvider {
     if (userId) {
       window.gtag("set", { user_id: userId });
     }
-    window.gtag("event", "page_view", {
+    const params = {
       page_title: name,
       page_location: url,
       page_referrer: referrer
-    });
+    };
+    if (sessionId) {
+      params["session_id"] = sessionId;
+    }
+    window.gtag("event", "page_view", params);
     return this.buildGtagResult();
   }
   buildGtagResult() {
@@ -356,14 +370,17 @@ var GoogleAnalyticsProvider = class extends BaseProvider {
       return this.identifyBrowser({ userId, traits, sessionId });
     }
     try {
+      const params = {};
+      if (sessionId) {
+        params["session_id"] = sessionId;
+      }
       const body = {
         client_id: userId,
         user_id: userId,
-        session_id: sessionId,
         user_properties: traits ? Object.fromEntries(
           Object.entries(traits).map(([k, v]) => [k, { value: v }])
         ) : void 0,
-        events: [{ name: "identify", params: {} }]
+        events: [{ name: "identify", params }]
       };
       const response = await this.http.post(this.endpoint, body, {
         params: {
@@ -416,20 +433,19 @@ var MixpanelProvider = class extends BaseProvider {
     const base64 = Buffer.from(json).toString("base64");
     return base64;
   }
-  async track({ event, properties, userId, anonymousId, timestamp }) {
+  async track({ event, properties, userId, anonymousId, sessionId, timestamp }) {
     try {
       const distinctId = userId ?? anonymousId ?? "anonymous";
-      const eventPayload = [
-        {
-          event,
-          properties: {
-            token: this.config.token,
-            distinct_id: distinctId,
-            time: timestamp ? Math.floor(timestamp.getTime() / 1e3) : Math.floor(Date.now() / 1e3),
-            ...properties
-          }
-        }
-      ];
+      const props = {
+        token: this.config.token,
+        distinct_id: distinctId,
+        time: timestamp ? Math.floor(timestamp.getTime() / 1e3) : Math.floor(Date.now() / 1e3),
+        ...properties
+      };
+      if (sessionId) {
+        props["$session_id"] = sessionId;
+      }
+      const eventPayload = [{ event, properties: props }];
       const endpoint = this.config.apiUrl ?? MIXPANEL_TRACK_ENDPOINT;
       const response = await this.http.post(
         endpoint,
@@ -450,13 +466,17 @@ var MixpanelProvider = class extends BaseProvider {
       return this.buildError(String(error), "MIXPANEL_UNKNOWN_ERROR", error);
     }
   }
-  async identify({ userId, traits }) {
+  async identify({ userId, traits, sessionId }) {
     try {
+      const setData = { ...traits };
+      if (sessionId) {
+        setData["$session_id"] = sessionId;
+      }
       const engagePayload = [
         {
           $token: this.config.token,
           $distinct_id: userId,
-          $set: traits ?? {}
+          $set: setData
         }
       ];
       const endpoint = this.config.apiUrl ? this.config.apiUrl.replace("/track", "/engage") : MIXPANEL_ENGAGE_ENDPOINT;
@@ -479,7 +499,7 @@ var MixpanelProvider = class extends BaseProvider {
       return this.buildError(String(error), "MIXPANEL_UNKNOWN_ERROR", error);
     }
   }
-  async page({ name, url, userId, anonymousId, properties }) {
+  async page({ name, url, userId, anonymousId, sessionId, properties }) {
     return this.track({
       event: "Page View",
       properties: {
@@ -488,7 +508,8 @@ var MixpanelProvider = class extends BaseProvider {
         ...properties
       },
       userId,
-      anonymousId
+      anonymousId,
+      sessionId
     });
   }
 };
@@ -741,6 +762,7 @@ var PlausibleProvider = class extends BaseProvider {
       return this.buildError(String(error), "PLAUSIBLE_UNKNOWN_ERROR", error);
     }
   }
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
   async identify(_options) {
     return {
       provider: this.name,
@@ -752,12 +774,13 @@ var PlausibleProvider = class extends BaseProvider {
       }
     };
   }
-  async page({ name, url, properties }) {
+  async page({ name, url, referrer, properties }) {
     try {
       const body = {
         name: "pageview",
         url,
         domain: this.config.domain,
+        referrer,
         props: {
           page_name: name,
           ...properties
@@ -781,7 +804,7 @@ var PlausibleProvider = class extends BaseProvider {
 };
 
 // src/providers/posthog.ts
-var POSTHOG_ENDPOINT = "https://app.posthog.com/capture/";
+var POSTHOG_ENDPOINT = "https://us.i.posthog.com/capture/";
 var PostHogProvider = class extends BaseProvider {
   constructor(config, mytart) {
     super(mytart);
@@ -1023,14 +1046,18 @@ var MetaPixelProvider = class extends BaseProvider {
       return this.buildFbqResult();
     }
     await this.ensureFbq();
-    const { event, properties, context } = options;
+    const { event, properties, context, sessionId } = options;
     const eventId = context?.eventId;
     const isStandard = STANDARD_EVENTS.has(event);
     const command = isStandard ? "track" : "trackCustom";
+    const params = { ...properties };
+    if (sessionId) {
+      params["xpl_session_id"] = sessionId;
+    }
     if (eventId) {
-      window.fbq(command, event, properties ?? {}, { eventID: eventId });
+      window.fbq(command, event, params, { eventID: eventId });
     } else {
-      window.fbq(command, event, properties ?? {});
+      window.fbq(command, event, params);
     }
     return this.buildFbqResult();
   }
@@ -1049,7 +1076,8 @@ var MetaPixelProvider = class extends BaseProvider {
     return this.buildFbqResult();
   }
   // -- browser page --
-  async pageBrowser(options) {
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  async pageBrowser(_options) {
     if (typeof window === "undefined") {
       return this.buildFbqResult();
     }
@@ -1138,6 +1166,9 @@ var MetaPixelProvider = class extends BaseProvider {
       Object.assign(this.cachedUserData, options.traits);
     }
     this.cachedUserData["external_id"] = options.userId;
+    if (options.sessionId) {
+      this.cachedUserData["xpl_session_id"] = options.sessionId;
+    }
     return this.buildSuccess(200);
   }
   // -- server page --
@@ -1259,6 +1290,9 @@ var ClarityProvider = class extends BaseProvider {
     if (options.userId) {
       window.clarity("identify", options.userId);
     }
+    if (options.sessionId) {
+      window.clarity("set", "sessionId", options.sessionId);
+    }
     window.clarity("event", options.event);
     if (options.properties) {
       for (const [key, value] of Object.entries(options.properties)) {
@@ -1273,7 +1307,10 @@ var ClarityProvider = class extends BaseProvider {
     }
     await this.ensureClarity();
     const friendlyName = options.traits?.name ?? void 0;
-    window.clarity("identify", options.userId, void 0, void 0, friendlyName);
+    window.clarity("identify", options.userId, options.sessionId, void 0, friendlyName);
+    if (options.sessionId) {
+      window.clarity("set", "sessionId", options.sessionId);
+    }
     if (options.traits) {
       for (const [key, value] of Object.entries(options.traits)) {
         if (key !== "name") {
@@ -1289,6 +1326,9 @@ var ClarityProvider = class extends BaseProvider {
     }
     await this.ensureClarity();
     window.clarity("event", "PageView");
+    if (options.sessionId) {
+      window.clarity("set", "sessionId", options.sessionId);
+    }
     if (options.url) {
       window.clarity("set", "pageUrl", options.url);
     }

package/dist/index.mjs

@@ -121,6 +121,9 @@ var GoogleAnalyticsProvider = class extends BaseProvider {
     this.http = createHttpClient();
     this.endpoint = config.debug ? GA4_DEBUG_ENDPOINT : GA4_ENDPOINT;
     this.isBrowser = config.appType === "browser";
+    if (this.isBrowser) {
+      this.gtagReady = this.initGtag();
+    }
   }
   /**
    * Initializes the gtag.js snippet exactly as Google's official documentation
@@ -200,7 +203,7 @@ var GoogleAnalyticsProvider = class extends BaseProvider {
   // ---------------------------------------------------------------------------
   // Browser mode methods — delegate to gtag()
   // ---------------------------------------------------------------------------
-  async trackBrowser({ event, properties, userId }) {
+  async trackBrowser({ event, properties, userId, sessionId }) {
     if (typeof window === "undefined") {
       return this.buildGtagResult();
     }
@@ -208,21 +211,28 @@ var GoogleAnalyticsProvider = class extends BaseProvider {
     if (userId) {
       window.gtag("set", { user_id: userId });
     }
-    window.gtag("event", event, properties ?? {});
+    const params = { ...properties };
+    if (sessionId) {
+      params["session_id"] = sessionId;
+    }
+    window.gtag("event", event, params);
     return this.buildGtagResult();
   }
-  async identifyBrowser({ userId, traits }) {
+  async identifyBrowser({ userId, traits, sessionId }) {
     if (typeof window === "undefined") {
       return this.buildGtagResult();
     }
     await this.ensureGtag();
     window.gtag("set", { user_id: userId });
+    if (sessionId) {
+      window.gtag("set", { session_id: sessionId });
+    }
     if (traits) {
       window.gtag("set", "user_properties", traits);
     }
     return this.buildGtagResult();
   }
-  async pageBrowser({ name, url, referrer, userId }) {
+  async pageBrowser({ name, url, referrer, userId, sessionId }) {
     if (typeof window === "undefined") {
       return this.buildGtagResult();
     }
@@ -230,11 +240,15 @@ var GoogleAnalyticsProvider = class extends BaseProvider {
     if (userId) {
       window.gtag("set", { user_id: userId });
     }
-    window.gtag("event", "page_view", {
+    const params = {
       page_title: name,
       page_location: url,
       page_referrer: referrer
-    });
+    };
+    if (sessionId) {
+      params["session_id"] = sessionId;
+    }
+    window.gtag("event", "page_view", params);
     return this.buildGtagResult();
   }
   buildGtagResult() {
@@ -311,14 +325,17 @@ var GoogleAnalyticsProvider = class extends BaseProvider {
       return this.identifyBrowser({ userId, traits, sessionId });
     }
     try {
+      const params = {};
+      if (sessionId) {
+        params["session_id"] = sessionId;
+      }
       const body = {
         client_id: userId,
         user_id: userId,
-        session_id: sessionId,
         user_properties: traits ? Object.fromEntries(
           Object.entries(traits).map(([k, v]) => [k, { value: v }])
         ) : void 0,
-        events: [{ name: "identify", params: {} }]
+        events: [{ name: "identify", params }]
       };
       const response = await this.http.post(this.endpoint, body, {
         params: {
@@ -371,20 +388,19 @@ var MixpanelProvider = class extends BaseProvider {
     const base64 = Buffer.from(json).toString("base64");
     return base64;
   }
-  async track({ event, properties, userId, anonymousId, timestamp }) {
+  async track({ event, properties, userId, anonymousId, sessionId, timestamp }) {
     try {
       const distinctId = userId ?? anonymousId ?? "anonymous";
-      const eventPayload = [
-        {
-          event,
-          properties: {
-            token: this.config.token,
-            distinct_id: distinctId,
-            time: timestamp ? Math.floor(timestamp.getTime() / 1e3) : Math.floor(Date.now() / 1e3),
-            ...properties
-          }
-        }
-      ];
+      const props = {
+        token: this.config.token,
+        distinct_id: distinctId,
+        time: timestamp ? Math.floor(timestamp.getTime() / 1e3) : Math.floor(Date.now() / 1e3),
+        ...properties
+      };
+      if (sessionId) {
+        props["$session_id"] = sessionId;
+      }
+      const eventPayload = [{ event, properties: props }];
       const endpoint = this.config.apiUrl ?? MIXPANEL_TRACK_ENDPOINT;
       const response = await this.http.post(
         endpoint,
@@ -405,13 +421,17 @@ var MixpanelProvider = class extends BaseProvider {
       return this.buildError(String(error), "MIXPANEL_UNKNOWN_ERROR", error);
     }
   }
-  async identify({ userId, traits }) {
+  async identify({ userId, traits, sessionId }) {
     try {
+      const setData = { ...traits };
+      if (sessionId) {
+        setData["$session_id"] = sessionId;
+      }
       const engagePayload = [
         {
           $token: this.config.token,
           $distinct_id: userId,
-          $set: traits ?? {}
+          $set: setData
         }
       ];
       const endpoint = this.config.apiUrl ? this.config.apiUrl.replace("/track", "/engage") : MIXPANEL_ENGAGE_ENDPOINT;
@@ -434,7 +454,7 @@ var MixpanelProvider = class extends BaseProvider {
       return this.buildError(String(error), "MIXPANEL_UNKNOWN_ERROR", error);
     }
   }
-  async page({ name, url, userId, anonymousId, properties }) {
+  async page({ name, url, userId, anonymousId, sessionId, properties }) {
     return this.track({
       event: "Page View",
       properties: {
@@ -443,7 +463,8 @@ var MixpanelProvider = class extends BaseProvider {
         ...properties
       },
       userId,
-      anonymousId
+      anonymousId,
+      sessionId
     });
   }
 };
@@ -696,6 +717,7 @@ var PlausibleProvider = class extends BaseProvider {
       return this.buildError(String(error), "PLAUSIBLE_UNKNOWN_ERROR", error);
     }
   }
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
   async identify(_options) {
     return {
       provider: this.name,
@@ -707,12 +729,13 @@ var PlausibleProvider = class extends BaseProvider {
       }
     };
   }
-  async page({ name, url, properties }) {
+  async page({ name, url, referrer, properties }) {
     try {
       const body = {
         name: "pageview",
         url,
         domain: this.config.domain,
+        referrer,
         props: {
           page_name: name,
           ...properties
@@ -736,7 +759,7 @@ var PlausibleProvider = class extends BaseProvider {
 };
 
 // src/providers/posthog.ts
-var POSTHOG_ENDPOINT = "https://app.posthog.com/capture/";
+var POSTHOG_ENDPOINT = "https://us.i.posthog.com/capture/";
 var PostHogProvider = class extends BaseProvider {
   constructor(config, mytart) {
     super(mytart);
@@ -978,14 +1001,18 @@ var MetaPixelProvider = class extends BaseProvider {
       return this.buildFbqResult();
     }
     await this.ensureFbq();
-    const { event, properties, context } = options;
+    const { event, properties, context, sessionId } = options;
     const eventId = context?.eventId;
     const isStandard = STANDARD_EVENTS.has(event);
     const command = isStandard ? "track" : "trackCustom";
+    const params = { ...properties };
+    if (sessionId) {
+      params["xpl_session_id"] = sessionId;
+    }
     if (eventId) {
-      window.fbq(command, event, properties ?? {}, { eventID: eventId });
+      window.fbq(command, event, params, { eventID: eventId });
     } else {
-      window.fbq(command, event, properties ?? {});
+      window.fbq(command, event, params);
     }
     return this.buildFbqResult();
   }
@@ -1004,7 +1031,8 @@ var MetaPixelProvider = class extends BaseProvider {
     return this.buildFbqResult();
   }
   // -- browser page --
-  async pageBrowser(options) {
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  async pageBrowser(_options) {
     if (typeof window === "undefined") {
       return this.buildFbqResult();
     }
@@ -1093,6 +1121,9 @@ var MetaPixelProvider = class extends BaseProvider {
       Object.assign(this.cachedUserData, options.traits);
     }
     this.cachedUserData["external_id"] = options.userId;
+    if (options.sessionId) {
+      this.cachedUserData["xpl_session_id"] = options.sessionId;
+    }
     return this.buildSuccess(200);
   }
   // -- server page --
@@ -1214,6 +1245,9 @@ var ClarityProvider = class extends BaseProvider {
     if (options.userId) {
       window.clarity("identify", options.userId);
     }
+    if (options.sessionId) {
+      window.clarity("set", "sessionId", options.sessionId);
+    }
     window.clarity("event", options.event);
     if (options.properties) {
       for (const [key, value] of Object.entries(options.properties)) {
@@ -1228,7 +1262,10 @@ var ClarityProvider = class extends BaseProvider {
     }
     await this.ensureClarity();
     const friendlyName = options.traits?.name ?? void 0;
-    window.clarity("identify", options.userId, void 0, void 0, friendlyName);
+    window.clarity("identify", options.userId, options.sessionId, void 0, friendlyName);
+    if (options.sessionId) {
+      window.clarity("set", "sessionId", options.sessionId);
+    }
     if (options.traits) {
       for (const [key, value] of Object.entries(options.traits)) {
         if (key !== "name") {
@@ -1244,6 +1281,9 @@ var ClarityProvider = class extends BaseProvider {
     }
     await this.ensureClarity();
     window.clarity("event", "PageView");
+    if (options.sessionId) {
+      window.clarity("set", "sessionId", options.sessionId);
+    }
     if (options.url) {
       window.clarity("set", "pageUrl", options.url);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mytart",
-  "version": "0.6.5",
+  "version": "0.6.7",
   "description": "Multi-Yield Tracking & Analytics Relay Tool — framework-agnostic analytics for any project",
   "keywords": [
     "analytics",