alphana-sdk 1.8.0 → 1.9.0

package/dist/react/index.d.mts

@@ -64,15 +64,11 @@ interface TrackerConfig {
      */
     trackLogs?: boolean;
     /**
-     * List of page paths for which heatmap data should be captured client-side.
-     * Paths should match the dashboard "Heatmap pages" list (decoded Unicode is
-     * fine — the SDK normalizes percent-encoding vs `window.location` mismatches).
-     *
-     * If empty or undefined, the SDK may still collect moves locally, but the
-     * backend only persists points when the app has at least one registered
-     * heatmap page and the path matches.
-     *
-     * Example: `heatmapPages: ["/", "/pricing", "/dashboard"]`
+     * @deprecated Optional client-side path filter only. Heatmap pages are
+     * registered in the Alphana dashboard; the backend persists points only for
+     * those paths. Leave unset so the SDK collects on every page and the server
+     * filters — no SDK configuration is required when you add a page in the
+     * dashboard.
      */
     heatmapPages?: string[];
     /**
@@ -162,11 +158,23 @@ interface HeatmapPoint {
     pw?: number;
     /** Page scrollHeight at the time of the event (used for accurate remapping) */
     ph?: number;
+    /** Viewport (innerWidth) at capture time — disambiguates responsive layouts. */
+    vw?: number;
     type: "move" | "click" | "scroll";
     path: string;
     timestamp: number;
     /** Text/label of the clicked element — only present on click events. */
     target?: string;
+    /**
+     * Stable CSS selector of the anchored element (clicks only). Lets the
+     * dashboard place the point relative to the element in the screenshot, so it
+     * stays accurate even when the visitor's layout differed from the capture.
+     */
+    selector?: string;
+    /** Click X as a fraction (0–1) of the anchored element's width (clicks only). */
+    relX?: number;
+    /** Click Y as a fraction (0–1) of the anchored element's height (clicks only). */
+    relY?: number;
 }
 interface RageClick {
     path: string;

package/dist/react/index.d.ts

@@ -64,15 +64,11 @@ interface TrackerConfig {
      */
     trackLogs?: boolean;
     /**
-     * List of page paths for which heatmap data should be captured client-side.
-     * Paths should match the dashboard "Heatmap pages" list (decoded Unicode is
-     * fine — the SDK normalizes percent-encoding vs `window.location` mismatches).
-     *
-     * If empty or undefined, the SDK may still collect moves locally, but the
-     * backend only persists points when the app has at least one registered
-     * heatmap page and the path matches.
-     *
-     * Example: `heatmapPages: ["/", "/pricing", "/dashboard"]`
+     * @deprecated Optional client-side path filter only. Heatmap pages are
+     * registered in the Alphana dashboard; the backend persists points only for
+     * those paths. Leave unset so the SDK collects on every page and the server
+     * filters — no SDK configuration is required when you add a page in the
+     * dashboard.
      */
     heatmapPages?: string[];
     /**
@@ -162,11 +158,23 @@ interface HeatmapPoint {
     pw?: number;
     /** Page scrollHeight at the time of the event (used for accurate remapping) */
     ph?: number;
+    /** Viewport (innerWidth) at capture time — disambiguates responsive layouts. */
+    vw?: number;
     type: "move" | "click" | "scroll";
     path: string;
     timestamp: number;
     /** Text/label of the clicked element — only present on click events. */
     target?: string;
+    /**
+     * Stable CSS selector of the anchored element (clicks only). Lets the
+     * dashboard place the point relative to the element in the screenshot, so it
+     * stays accurate even when the visitor's layout differed from the capture.
+     */
+    selector?: string;
+    /** Click X as a fraction (0–1) of the anchored element's width (clicks only). */
+    relX?: number;
+    /** Click Y as a fraction (0–1) of the anchored element's height (clicks only). */
+    relY?: number;
 }
 interface RageClick {
     path: string;