alphana-sdk 1.9.0 → 2.0.2

package/dist/index.d.mts

@@ -93,6 +93,12 @@ interface TrackerConfig {
     sessionReplayMaskTextClass?: string;
     /** CSS class name for DOM subtrees that rrweb should not capture. */
     sessionReplayBlockClass?: string;
+    /**
+     * Cookie consent mode.
+     * - `auto` (default): honor the dashboard cookie-consent widget when enabled.
+     * - `disabled`: never show the consent banner; track immediately.
+     */
+    consentMode?: "auto" | "disabled";
     /** Called synchronously for every emitted event. */
     onEvent?: (event: TrackerEvent) => void;
 }
@@ -431,6 +437,10 @@ declare class UserTracker {
     /** Public so consumers can call logCapture.capture() for manual log entries. */
     logCapture?: LogCapture;
     private initialized;
+    private trackingAllowed;
+    private trackingBlocked;
+    private visitorPersisted;
+    private elementBindings?;
     private readonly subscribers;
     /** In-memory queue of events waiting to be flushed. */
     private queue;
@@ -448,8 +458,17 @@ declare class UserTracker {
      * Attach event listeners and start tracking.
      * Safe to call during SSR — returns `this` immediately if `window` is
      * undefined so it can be chained: `const tracker = new UserTracker(cfg).init()`.
+     *
+     * When the dashboard cookie-consent widget is enabled, tracking waits until
+     * the visitor accepts (or resumes a prior decision for the same config version).
      */
     init(): this;
+    private bootstrapRuntime;
+    private applyElementBindings;
+    private persistVisitorIfNeeded;
+    /** Start plugins, network flush, and element listeners after consent is OK. */
+    private startTracking;
+    private blockTracking;
     /** Remove all event listeners, flush remaining queue, and reset state. */
     destroy(): void;
     private handleVisibilityChange;
@@ -569,6 +588,7 @@ declare class UserTracker {
     /** Heatmap points for all tracked paths. */
     getHeatmapData(): Record<string, HeatmapPoint[]>;
     private get collectUrl();
+    private fetchRuntimeConfig;
     private currentPath;
     /**
      * Immediately drain the event queue and POST pending events to `/batch`.
@@ -606,7 +626,7 @@ declare class UserTracker {
  */
 declare function renderHeatmap(canvas: HTMLCanvasElement, points: HeatmapPoint[], options?: HeatmapRenderOptions): void;
 
-declare const ALPHANA_SDK_VERSION = "1.0.2";
+declare const ALPHANA_SDK_VERSION = "2.0.2";
 
 /**
  * Canonical URL path (+ optional query) for analytics / heatmap matching.

package/dist/index.d.ts

@@ -93,6 +93,12 @@ interface TrackerConfig {
     sessionReplayMaskTextClass?: string;
     /** CSS class name for DOM subtrees that rrweb should not capture. */
     sessionReplayBlockClass?: string;
+    /**
+     * Cookie consent mode.
+     * - `auto` (default): honor the dashboard cookie-consent widget when enabled.
+     * - `disabled`: never show the consent banner; track immediately.
+     */
+    consentMode?: "auto" | "disabled";
     /** Called synchronously for every emitted event. */
     onEvent?: (event: TrackerEvent) => void;
 }
@@ -431,6 +437,10 @@ declare class UserTracker {
     /** Public so consumers can call logCapture.capture() for manual log entries. */
     logCapture?: LogCapture;
     private initialized;
+    private trackingAllowed;
+    private trackingBlocked;
+    private visitorPersisted;
+    private elementBindings?;
     private readonly subscribers;
     /** In-memory queue of events waiting to be flushed. */
     private queue;
@@ -448,8 +458,17 @@ declare class UserTracker {
      * Attach event listeners and start tracking.
      * Safe to call during SSR — returns `this` immediately if `window` is
      * undefined so it can be chained: `const tracker = new UserTracker(cfg).init()`.
+     *
+     * When the dashboard cookie-consent widget is enabled, tracking waits until
+     * the visitor accepts (or resumes a prior decision for the same config version).
      */
     init(): this;
+    private bootstrapRuntime;
+    private applyElementBindings;
+    private persistVisitorIfNeeded;
+    /** Start plugins, network flush, and element listeners after consent is OK. */
+    private startTracking;
+    private blockTracking;
     /** Remove all event listeners, flush remaining queue, and reset state. */
     destroy(): void;
     private handleVisibilityChange;
@@ -569,6 +588,7 @@ declare class UserTracker {
     /** Heatmap points for all tracked paths. */
     getHeatmapData(): Record<string, HeatmapPoint[]>;
     private get collectUrl();
+    private fetchRuntimeConfig;
     private currentPath;
     /**
      * Immediately drain the event queue and POST pending events to `/batch`.
@@ -606,7 +626,7 @@ declare class UserTracker {
  */
 declare function renderHeatmap(canvas: HTMLCanvasElement, points: HeatmapPoint[], options?: HeatmapRenderOptions): void;
 
-declare const ALPHANA_SDK_VERSION = "1.0.2";
+declare const ALPHANA_SDK_VERSION = "2.0.2";
 
 /**
  * Canonical URL path (+ optional query) for analytics / heatmap matching.