ainamika-sdk 1.2.7 → 1.2.9

package/dist/sdk.d.ts

@@ -202,6 +202,7 @@ declare class AInamikaSDKPro {
     private generateSessionId;
     private getPageContext;
     private getCommonEventData;
+    private sendSessionStartEvent;
     private getUserId;
     identifyUser(authenticatedUserId: string, userProperties?: Record<string, any>): void;
     /**
@@ -233,21 +234,71 @@ declare class AInamikaSDKPro {
     private setupDynamicDomTracking;
     private computeDomHash;
     /**
-     * Generates a stable fingerprint for an element based on stable attributes.
-     * This fingerprint is used to ensure consistent event naming across all users.
+     * Generates a stable fingerprint for an element that remains consistent
+     * across page loads and different users viewing the same element.
+     *
+     * IMPORTANT: This fingerprint is designed to be i18n-safe and user-agnostic.
+     * It does NOT use textContent, aria-label, or other user/locale-specific attributes.
      *
      * Priority order for fingerprint generation:
-     * 1. data-testid, data-track, data-analytics (explicit tracking attributes)
-     * 2. id (if unique and stable)
+     * 1. All data-* attributes (generalized, not just specific ones)
+     * 2. id (if stable, not dynamically generated)
      * 3. name attribute (for form elements)
-     * 4. aria-label (accessibility attribute)
-     * 5. Combination of tag + text + stable parent context
+     * 4. className (filtered to exclude hashed/dynamic classes)
+     * 5. onclick function signature (if inline)
+     * 6. href path (for links, without query params)
+     * 7. tag + type + role (semantic HTML)
+     * 8. Structural aria attributes (aria-controls, aria-haspopup, etc.)
+     * 9. Parent chain (structural context using tags and stable classes)
      */
     private generateElementFingerprint;
+    /**
+     * Extracts all data-* attributes from an element, sorted for consistency.
+     * Returns array like ["action=checkout", "component=cart", "id=123"]
+     */
+    private extractDataAttributes;
+    /**
+     * Checks if a data attribute likely contains dynamic/user-specific values
+     */
+    private isDynamicDataAttribute;
+    /**
+     * Checks if an ID appears to be dynamically generated
+     */
+    private isDynamicId;
+    /**
+     * Extracts stable class names, filtering out hashed/dynamic ones
+     */
+    private extractStableClasses;
+    /**
+     * Determines if a class name is stable (not hashed/dynamic)
+     */
+    private isStableClassName;
+    /**
+     * Extracts function signature from onclick attribute
+     */
+    private extractOnclickSignature;
+    /**
+     * Extracts path from href, removing query params and normalizing
+     */
+    private extractHrefPath;
+    /**
+     * Extracts structural aria attributes (not aria-label which contains text)
+     */
+    private extractStructuralAriaAttributes;
+    /**
+     * Builds a structural parent chain signature using tags and stable classes
+     */
+    private buildParentChainSignature;
     /**
      * Simple hash function for fingerprinting (MD5-like, but faster)
      */
     private hashString;
+    /**
+     * Detects if an element has a click handler attached via any framework.
+     * Works with React, Vue, Angular, Svelte, and vanilla JS.
+     * Also checks cursor: pointer as a universal fallback.
+     */
+    private hasFrameworkClickHandler;
     private readonly MAX_CACHED_CONFIGS;
     private getLastKnownConfig;
     private setLastKnownConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ainamika-sdk",
-  "version": "1.2.7",
+  "version": "1.2.9",
   "description": "AI-powered analytics SDK with Web Vitals, engagement tracking, error monitoring, and real-time insights for web applications",
   "main": "dist/ainamika-sdk.js",
   "types": "dist/sdk.d.ts",