cuoral-ionic 0.0.2 → 0.0.4

package/README.md

@@ -157,6 +157,89 @@ export class SupportPage implements OnInit, OnDestroy {
 }
 ```
 
+### Enable Page View Tracking (One-Time Setup)
+
+To automatically track page views, add router tracking to your **app.component.ts** (or main app component):
+
+```typescript
+import { Component } from '@angular/core';
+import { Router, NavigationEnd } from '@angular/router';
+import { Cuoral } from 'cuoral-ionic';
+
+@Component({
+  selector: 'app-root',
+  templateUrl: 'app.component.html',
+})
+export class AppComponent {
+  private cuoral: Cuoral;
+
+  constructor(private router: Router) {
+    this.cuoral = new Cuoral({
+      publicKey: 'your-public-key-here',
+      email: 'user@example.com',
+      firstName: 'John',
+      lastName: 'Doe',
+    });
+  }
+
+  async ngOnInit() {
+    // Initialize Cuoral (intelligence auto-enabled from dashboard)
+    await this.cuoral.initialize();
+
+    // Track all page navigation automatically
+    this.router.events.subscribe(event => {
+      if (event instanceof NavigationEnd) {
+        this.cuoral.trackPageView(event.url);
+      }
+    });
+  }
+}
+```
+
+**That's it!** All page views are now automatically tracked. Console errors, network errors, and native crashes are tracked with zero additional setup.
+
+## User Logout & Session Management
+
+When users log out, properly clear and end the session before destroying the Cuoral instance:
+
+```typescript
+async logout() {
+  // Step 1: Clear and end the session
+  await this.cuoral.clearSession();
+
+  // Step 2: Destroy the Cuoral instance
+  this.cuoral.destroy();
+
+  // Step 3: Your logout logic
+  // Navigate to login, clear user data, etc.
+}
+```
+
+When a different user logs in on the same device, create a fresh Cuoral instance:
+
+```typescript
+async login(email: string, firstName: string, lastName: string) {
+  // Create new instance for the new user
+  this.cuoral = new Cuoral({
+    publicKey: 'your-public-key-here',
+    email: email,
+    firstName: firstName,
+    lastName: lastName,
+  });
+
+  // Initialize for new user
+  await this.cuoral.initialize();
+}
+```
+
+**Important Notes:**
+
+- `clearSession()` marks the session as ended on the backend
+- `destroy()` cleans up local resources
+- Always call `clearSession()` before `destroy()` on logout
+- Create a new Cuoral instance for each user login
+- Email, first name, and last name are all required for identified users
+
 ## Configuration
 
 ### CuoralOptions

package/dist/cuoral.d.ts

@@ -56,6 +56,10 @@ export declare class Cuoral {
      * Get the widget URL for iframe embedding
      */
     getWidgetUrl(): string;
+    /**
+     * Clear and end the current session (call before logout)
+     */
+    clearSession(): Promise<void>;
     /**
      * Clean up resources
      */

package/dist/cuoral.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cuoral.d.ts","sourceRoot":"","sources":["../src/cuoral.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAeD;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,KAAK,CAAC,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAC,CAAqB;IAC1C,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAuC;IACpF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAwB;gBAElD,OAAO,EAAE,aAAa;IA2ClC;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAYxC;;OAEG;YACW,sBAAsB;IAwCpC;;OAEG;YACW,yBAAyB;IAoCvC;;OAEG;IACI,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI;IAM1D;;OAEG;IACI,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI;IAM7E;;OAEG;IACI,SAAS,IAAI,IAAI;IAMxB;;OAEG;IACI,UAAU,IAAI,IAAI;IAMzB;;OAEG;IACI,WAAW,IAAI,OAAO;IAI7B;;OAEG;IACI,YAAY,IAAI,MAAM;IAe7B;;OAEG;IACI,OAAO,IAAI,IAAI;IActB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;OAEG;YACW,eAAe;IAmC7B;;OAEG;YACW,UAAU;IAmBxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAuE7B"}
+{"version":3,"file":"cuoral.d.ts","sourceRoot":"","sources":["../src/cuoral.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAeD;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,KAAK,CAAC,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAC,CAAqB;IAC1C,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAuC;IACpF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAwB;gBAElD,OAAO,EAAE,aAAa;IA2ClC;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBxC;;OAEG;YACW,sBAAsB;IAwCpC;;OAEG;YACW,yBAAyB;IAoCvC;;OAEG;IACI,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI;IAM1D;;OAEG;IACI,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI;IAM7E;;OAEG;IACI,SAAS,IAAI,IAAI;IASxB;;OAEG;IACI,UAAU,IAAI,IAAI;IAMzB;;OAEG;IACI,WAAW,IAAI,OAAO;IAI7B;;OAEG;IACI,YAAY,IAAI,MAAM;IAuB7B;;OAEG;IACU,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA6C1C;;OAEG;IACI,OAAO,IAAI,IAAI;IActB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;OAEG;YACW,eAAe;IAkC7B;;OAEG;YACW,UAAU;IAmBxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAuE7B"}

package/dist/cuoral.js

@@ -50,6 +50,11 @@ export class Cuoral {
      */
     async initialize() {
         this.bridge.initialize();
+        // Recreate modal if it was destroyed (e.g., after clearSession)
+        if (this.options.useModal && !this.modal) {
+            const widgetUrl = this.getWidgetUrl();
+            this.modal = new CuoralModal(widgetUrl, this.options.showFloatingButton);
+        }
         // Initialize modal if enabled
         if (this.modal) {
             this.modal.initialize();
@@ -151,6 +156,9 @@ export class Cuoral {
      */
     openModal() {
         if (this.modal) {
+            // Update iframe URL to include current session_id before opening
+            const currentUrl = this.getWidgetUrl();
+            this.modal.updateWidgetUrl(currentUrl);
             this.modal.open();
         }
     }
@@ -176,15 +184,65 @@ export class Cuoral {
         const params = new URLSearchParams({
             auto_start: 'true',
             key: this.options.publicKey,
+            is_mobile: 'true',
             _t: Date.now().toString(),
         });
+        // Add session_id if available
+        const sessionId = localStorage.getItem('__x_loadID');
+        if (sessionId) {
+            params.set('session_id', sessionId);
+        }
         if (this.options.email)
             params.set('email', this.options.email);
         if (this.options.firstName)
             params.set('first_name', this.options.firstName);
         if (this.options.lastName)
             params.set('last_name', this.options.lastName);
-        return `${baseUrl}?${params.toString()}`;
+        const url = `${baseUrl}?${params.toString()}`;
+        return url;
+    }
+    /**
+     * Clear and end the current session (call before logout)
+     */
+    async clearSession() {
+        try {
+            const sessionId = localStorage.getItem('__x_loadID');
+            if (sessionId) {
+                // Notify backend to close the session
+                await fetch('https://api.cuoral.com/conversation/end-session', {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'x-org-id': this.options.publicKey,
+                    },
+                    body: JSON.stringify({
+                        session_id: sessionId
+                    }),
+                });
+            }
+            // Clear local session storage
+            localStorage.removeItem('__x_loadID');
+            // Destroy modal to clear cached iframe
+            if (this.modal) {
+                this.modal.destroy();
+                this.modal = undefined;
+            }
+            // Destroy bridge to clear any cached data
+            this.bridge.destroy();
+            // Clear intelligence session
+            if (this.intelligence) {
+                this.intelligence.destroy();
+                this.intelligence = undefined;
+            }
+        }
+        catch (error) {
+            // Fail silently - always clear local storage
+            localStorage.removeItem('__x_loadID');
+            if (this.modal) {
+                this.modal.destroy();
+                this.modal = undefined;
+            }
+        }
     }
     /**
      * Clean up resources
@@ -224,7 +282,12 @@ export class Cuoral {
                     'Content-Type': 'application/json',
                     'x-org-id': this.options.publicKey,
                 },
-                body: JSON.stringify({ public_key: this.options.publicKey }),
+                body: JSON.stringify({
+                    public_key: this.options.publicKey,
+                    email: this.options.email,
+                    first_name: this.options.firstName,
+                    last_name: this.options.lastName
+                }),
             });
             if (!response.ok) {
                 return null;
@@ -232,16 +295,11 @@ export class Cuoral {
             const data = await response.json();
             if (data.status && data.session_id) {
                 localStorage.setItem('__x_loadID', data.session_id);
-                // Set profile if email, firstName, lastName are provided
-                if (this.options.email && this.options.firstName && this.options.lastName) {
-                    await this.setProfile(data.session_id);
-                }
                 return data.session_id;
             }
             return null;
         }
         catch (error) {
-            console.warn('[Cuoral] Failed to initiate session:', error);
             return null;
         }
     }

package/dist/index.esm.js

@@ -344,6 +344,44 @@ class CuoralModal {
         this.widgetUrl = widgetUrl;
         this.showFloatingButton = showFloatingButton;
     }
+    /**
+     * Update the widget URL (e.g., to include new session_id)
+     * Forces complete iframe recreation if URL changed to clear all cached state
+     */
+    updateWidgetUrl(newUrl) {
+        this.widgetUrl = newUrl;
+        if (!this.iframeElement)
+            return;
+        // Compare URLs without timestamp parameter to check if content changed
+        const stripTimestamp = (url) => url.replace(/[&?]_t=[^&]*/, '');
+        const newUrlWithoutTimestamp = stripTimestamp(newUrl);
+        const lastUrlWithoutTimestamp = this.lastLoadedUrl ? stripTimestamp(this.lastLoadedUrl) : '';
+        // Only reload iframe if the URL actually changed (different session or user)
+        if (newUrlWithoutTimestamp !== lastUrlWithoutTimestamp) {
+            // Store reference to parent container
+            const parentContainer = this.iframeElement.parentElement;
+            if (parentContainer) {
+                // Remove old iframe completely
+                parentContainer.removeChild(this.iframeElement);
+                // Create fresh iframe element with cache-busting attributes
+                this.iframeElement = document.createElement('iframe');
+                this.iframeElement.id = 'cuoral-widget-iframe';
+                // Add cache-busting attributes to force fresh load
+                this.iframeElement.setAttribute('data-cache-bust', Date.now().toString());
+                // Use src with force reload parameter
+                this.iframeElement.src = newUrl + '&_reload=1';
+                Object.assign(this.iframeElement.style, {
+                    width: '100%',
+                    height: '100%',
+                    border: 'none',
+                    backgroundColor: 'white'
+                });
+                // Append new iframe
+                parentContainer.appendChild(this.iframeElement);
+            }
+            this.lastLoadedUrl = newUrl;
+        }
+    }
     /**
      * Initialize the modal and floating button
      */
@@ -420,7 +458,7 @@ class CuoralModal {
             zIndex: '1000000',
             opacity: '0',
             transition: 'opacity 0.3s ease',
-            padding: '60px 0'
+            padding: '60px 0 30px 0'
         });
         // Modal content (with margin)
         const modalContent = document.createElement('div');
@@ -471,6 +509,7 @@ class CuoralModal {
         this.iframeElement = document.createElement('iframe');
         this.iframeElement.id = 'cuoral-widget-iframe';
         this.iframeElement.src = this.widgetUrl;
+        this.lastLoadedUrl = this.widgetUrl; // Track initial URL
         Object.assign(this.iframeElement.style, {
             width: '100%',
             height: '100%',
@@ -1108,6 +1147,11 @@ class Cuoral {
      */
     async initialize() {
         this.bridge.initialize();
+        // Recreate modal if it was destroyed (e.g., after clearSession)
+        if (this.options.useModal && !this.modal) {
+            const widgetUrl = this.getWidgetUrl();
+            this.modal = new CuoralModal(widgetUrl, this.options.showFloatingButton);
+        }
         // Initialize modal if enabled
         if (this.modal) {
             this.modal.initialize();
@@ -1209,6 +1253,9 @@ class Cuoral {
      */
     openModal() {
         if (this.modal) {
+            // Update iframe URL to include current session_id before opening
+            const currentUrl = this.getWidgetUrl();
+            this.modal.updateWidgetUrl(currentUrl);
             this.modal.open();
         }
     }
@@ -1234,15 +1281,65 @@ class Cuoral {
         const params = new URLSearchParams({
             auto_start: 'true',
             key: this.options.publicKey,
+            is_mobile: 'true',
             _t: Date.now().toString(),
         });
+        // Add session_id if available
+        const sessionId = localStorage.getItem('__x_loadID');
+        if (sessionId) {
+            params.set('session_id', sessionId);
+        }
         if (this.options.email)
             params.set('email', this.options.email);
         if (this.options.firstName)
             params.set('first_name', this.options.firstName);
         if (this.options.lastName)
             params.set('last_name', this.options.lastName);
-        return `${baseUrl}?${params.toString()}`;
+        const url = `${baseUrl}?${params.toString()}`;
+        return url;
+    }
+    /**
+     * Clear and end the current session (call before logout)
+     */
+    async clearSession() {
+        try {
+            const sessionId = localStorage.getItem('__x_loadID');
+            if (sessionId) {
+                // Notify backend to close the session
+                await fetch('https://api.cuoral.com/conversation/end-session', {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'x-org-id': this.options.publicKey,
+                    },
+                    body: JSON.stringify({
+                        session_id: sessionId
+                    }),
+                });
+            }
+            // Clear local session storage
+            localStorage.removeItem('__x_loadID');
+            // Destroy modal to clear cached iframe
+            if (this.modal) {
+                this.modal.destroy();
+                this.modal = undefined;
+            }
+            // Destroy bridge to clear any cached data
+            this.bridge.destroy();
+            // Clear intelligence session
+            if (this.intelligence) {
+                this.intelligence.destroy();
+                this.intelligence = undefined;
+            }
+        }
+        catch (error) {
+            // Fail silently - always clear local storage
+            localStorage.removeItem('__x_loadID');
+            if (this.modal) {
+                this.modal.destroy();
+                this.modal = undefined;
+            }
+        }
     }
     /**
      * Clean up resources
@@ -1282,7 +1379,12 @@ class Cuoral {
                     'Content-Type': 'application/json',
                     'x-org-id': this.options.publicKey,
                 },
-                body: JSON.stringify({ public_key: this.options.publicKey }),
+                body: JSON.stringify({
+                    public_key: this.options.publicKey,
+                    email: this.options.email,
+                    first_name: this.options.firstName,
+                    last_name: this.options.lastName
+                }),
             });
             if (!response.ok) {
                 return null;
@@ -1290,16 +1392,11 @@ class Cuoral {
             const data = await response.json();
             if (data.status && data.session_id) {
                 localStorage.setItem('__x_loadID', data.session_id);
-                // Set profile if email, firstName, lastName are provided
-                if (this.options.email && this.options.firstName && this.options.lastName) {
-                    await this.setProfile(data.session_id);
-                }
                 return data.session_id;
             }
             return null;
         }
         catch (error) {
-            console.warn('[Cuoral] Failed to initiate session:', error);
             return null;
         }
     }

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/index.js

@@ -346,6 +346,44 @@ class CuoralModal {
         this.widgetUrl = widgetUrl;
         this.showFloatingButton = showFloatingButton;
     }
+    /**
+     * Update the widget URL (e.g., to include new session_id)
+     * Forces complete iframe recreation if URL changed to clear all cached state
+     */
+    updateWidgetUrl(newUrl) {
+        this.widgetUrl = newUrl;
+        if (!this.iframeElement)
+            return;
+        // Compare URLs without timestamp parameter to check if content changed
+        const stripTimestamp = (url) => url.replace(/[&?]_t=[^&]*/, '');
+        const newUrlWithoutTimestamp = stripTimestamp(newUrl);
+        const lastUrlWithoutTimestamp = this.lastLoadedUrl ? stripTimestamp(this.lastLoadedUrl) : '';
+        // Only reload iframe if the URL actually changed (different session or user)
+        if (newUrlWithoutTimestamp !== lastUrlWithoutTimestamp) {
+            // Store reference to parent container
+            const parentContainer = this.iframeElement.parentElement;
+            if (parentContainer) {
+                // Remove old iframe completely
+                parentContainer.removeChild(this.iframeElement);
+                // Create fresh iframe element with cache-busting attributes
+                this.iframeElement = document.createElement('iframe');
+                this.iframeElement.id = 'cuoral-widget-iframe';
+                // Add cache-busting attributes to force fresh load
+                this.iframeElement.setAttribute('data-cache-bust', Date.now().toString());
+                // Use src with force reload parameter
+                this.iframeElement.src = newUrl + '&_reload=1';
+                Object.assign(this.iframeElement.style, {
+                    width: '100%',
+                    height: '100%',
+                    border: 'none',
+                    backgroundColor: 'white'
+                });
+                // Append new iframe
+                parentContainer.appendChild(this.iframeElement);
+            }
+            this.lastLoadedUrl = newUrl;
+        }
+    }
     /**
      * Initialize the modal and floating button
      */
@@ -422,7 +460,7 @@ class CuoralModal {
             zIndex: '1000000',
             opacity: '0',
             transition: 'opacity 0.3s ease',
-            padding: '60px 0'
+            padding: '60px 0 30px 0'
         });
         // Modal content (with margin)
         const modalContent = document.createElement('div');
@@ -473,6 +511,7 @@ class CuoralModal {
         this.iframeElement = document.createElement('iframe');
         this.iframeElement.id = 'cuoral-widget-iframe';
         this.iframeElement.src = this.widgetUrl;
+        this.lastLoadedUrl = this.widgetUrl; // Track initial URL
         Object.assign(this.iframeElement.style, {
             width: '100%',
             height: '100%',
@@ -1110,6 +1149,11 @@ class Cuoral {
      */
     async initialize() {
         this.bridge.initialize();
+        // Recreate modal if it was destroyed (e.g., after clearSession)
+        if (this.options.useModal && !this.modal) {
+            const widgetUrl = this.getWidgetUrl();
+            this.modal = new CuoralModal(widgetUrl, this.options.showFloatingButton);
+        }
         // Initialize modal if enabled
         if (this.modal) {
             this.modal.initialize();
@@ -1211,6 +1255,9 @@ class Cuoral {
      */
     openModal() {
         if (this.modal) {
+            // Update iframe URL to include current session_id before opening
+            const currentUrl = this.getWidgetUrl();
+            this.modal.updateWidgetUrl(currentUrl);
             this.modal.open();
         }
     }
@@ -1236,15 +1283,65 @@ class Cuoral {
         const params = new URLSearchParams({
             auto_start: 'true',
             key: this.options.publicKey,
+            is_mobile: 'true',
             _t: Date.now().toString(),
         });
+        // Add session_id if available
+        const sessionId = localStorage.getItem('__x_loadID');
+        if (sessionId) {
+            params.set('session_id', sessionId);
+        }
         if (this.options.email)
             params.set('email', this.options.email);
         if (this.options.firstName)
             params.set('first_name', this.options.firstName);
         if (this.options.lastName)
             params.set('last_name', this.options.lastName);
-        return `${baseUrl}?${params.toString()}`;
+        const url = `${baseUrl}?${params.toString()}`;
+        return url;
+    }
+    /**
+     * Clear and end the current session (call before logout)
+     */
+    async clearSession() {
+        try {
+            const sessionId = localStorage.getItem('__x_loadID');
+            if (sessionId) {
+                // Notify backend to close the session
+                await fetch('https://api.cuoral.com/conversation/end-session', {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'x-org-id': this.options.publicKey,
+                    },
+                    body: JSON.stringify({
+                        session_id: sessionId
+                    }),
+                });
+            }
+            // Clear local session storage
+            localStorage.removeItem('__x_loadID');
+            // Destroy modal to clear cached iframe
+            if (this.modal) {
+                this.modal.destroy();
+                this.modal = undefined;
+            }
+            // Destroy bridge to clear any cached data
+            this.bridge.destroy();
+            // Clear intelligence session
+            if (this.intelligence) {
+                this.intelligence.destroy();
+                this.intelligence = undefined;
+            }
+        }
+        catch (error) {
+            // Fail silently - always clear local storage
+            localStorage.removeItem('__x_loadID');
+            if (this.modal) {
+                this.modal.destroy();
+                this.modal = undefined;
+            }
+        }
     }
     /**
      * Clean up resources
@@ -1284,7 +1381,12 @@ class Cuoral {
                     'Content-Type': 'application/json',
                     'x-org-id': this.options.publicKey,
                 },
-                body: JSON.stringify({ public_key: this.options.publicKey }),
+                body: JSON.stringify({
+                    public_key: this.options.publicKey,
+                    email: this.options.email,
+                    first_name: this.options.firstName,
+                    last_name: this.options.lastName
+                }),
             });
             if (!response.ok) {
                 return null;
@@ -1292,16 +1394,11 @@ class Cuoral {
             const data = await response.json();
             if (data.status && data.session_id) {
                 localStorage.setItem('__x_loadID', data.session_id);
-                // Set profile if email, firstName, lastName are provided
-                if (this.options.email && this.options.firstName && this.options.lastName) {
-                    await this.setProfile(data.session_id);
-                }
                 return data.session_id;
             }
             return null;
         }
         catch (error) {
-            console.warn('[Cuoral] Failed to initiate session:', error);
             return null;
         }
     }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/modal.d.ts

@@ -9,7 +9,13 @@ export declare class CuoralModal {
     private isOpen;
     private widgetUrl;
     private showFloatingButton;
+    private lastLoadedUrl?;
     constructor(widgetUrl: string, showFloatingButton?: boolean);
+    /**
+     * Update the widget URL (e.g., to include new session_id)
+     * Forces complete iframe recreation if URL changed to clear all cached state
+     */
+    updateWidgetUrl(newUrl: string): void;
     /**
      * Initialize the modal and floating button
      */

package/dist/modal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"modal.d.ts","sourceRoot":"","sources":["../src/modal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,YAAY,CAAC,CAAiB;IACtC,OAAO,CAAC,aAAa,CAAC,CAAoB;IAC1C,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,kBAAkB,CAAU;gBAExB,SAAS,EAAE,MAAM,EAAE,kBAAkB,UAAO;IAKxD;;OAEG;IACI,UAAU,IAAI,IAAI;IAOzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkD5B;;OAEG;IACH,OAAO,CAAC,WAAW;IAkGnB;;OAEG;IACI,IAAI,IAAI,IAAI;IAsBnB;;OAEG;IACI,KAAK,IAAI,IAAI;IAqBpB;;OAEG;IACI,WAAW,IAAI,OAAO;IAI7B;;OAEG;IACI,OAAO,IAAI,IAAI;IAUtB;;OAEG;IACI,SAAS,IAAI,iBAAiB,GAAG,SAAS;CAGlD"}
+{"version":3,"file":"modal.d.ts","sourceRoot":"","sources":["../src/modal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,YAAY,CAAC,CAAiB;IACtC,OAAO,CAAC,aAAa,CAAC,CAAoB;IAC1C,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,kBAAkB,CAAU;IACpC,OAAO,CAAC,aAAa,CAAC,CAAS;gBAEnB,SAAS,EAAE,MAAM,EAAE,kBAAkB,UAAO;IAKxD;;;OAGG;IACI,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IA4C5C;;OAEG;IACI,UAAU,IAAI,IAAI;IAOzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkD5B;;OAEG;IACH,OAAO,CAAC,WAAW;IAmGnB;;OAEG;IACI,IAAI,IAAI,IAAI;IAsBnB;;OAEG;IACI,KAAK,IAAI,IAAI;IAqBpB;;OAEG;IACI,WAAW,IAAI,OAAO;IAI7B;;OAEG;IACI,OAAO,IAAI,IAAI;IAUtB;;OAEG;IACI,SAAS,IAAI,iBAAiB,GAAG,SAAS;CAGlD"}

package/dist/modal.js

@@ -8,6 +8,44 @@ export class CuoralModal {
         this.widgetUrl = widgetUrl;
         this.showFloatingButton = showFloatingButton;
     }
+    /**
+     * Update the widget URL (e.g., to include new session_id)
+     * Forces complete iframe recreation if URL changed to clear all cached state
+     */
+    updateWidgetUrl(newUrl) {
+        this.widgetUrl = newUrl;
+        if (!this.iframeElement)
+            return;
+        // Compare URLs without timestamp parameter to check if content changed
+        const stripTimestamp = (url) => url.replace(/[&?]_t=[^&]*/, '');
+        const newUrlWithoutTimestamp = stripTimestamp(newUrl);
+        const lastUrlWithoutTimestamp = this.lastLoadedUrl ? stripTimestamp(this.lastLoadedUrl) : '';
+        // Only reload iframe if the URL actually changed (different session or user)
+        if (newUrlWithoutTimestamp !== lastUrlWithoutTimestamp) {
+            // Store reference to parent container
+            const parentContainer = this.iframeElement.parentElement;
+            if (parentContainer) {
+                // Remove old iframe completely
+                parentContainer.removeChild(this.iframeElement);
+                // Create fresh iframe element with cache-busting attributes
+                this.iframeElement = document.createElement('iframe');
+                this.iframeElement.id = 'cuoral-widget-iframe';
+                // Add cache-busting attributes to force fresh load
+                this.iframeElement.setAttribute('data-cache-bust', Date.now().toString());
+                // Use src with force reload parameter
+                this.iframeElement.src = newUrl + '&_reload=1';
+                Object.assign(this.iframeElement.style, {
+                    width: '100%',
+                    height: '100%',
+                    border: 'none',
+                    backgroundColor: 'white'
+                });
+                // Append new iframe
+                parentContainer.appendChild(this.iframeElement);
+            }
+            this.lastLoadedUrl = newUrl;
+        }
+    }
     /**
      * Initialize the modal and floating button
      */
@@ -84,7 +122,7 @@ export class CuoralModal {
             zIndex: '1000000',
             opacity: '0',
             transition: 'opacity 0.3s ease',
-            padding: '60px 0'
+            padding: '60px 0 30px 0'
         });
         // Modal content (with margin)
         const modalContent = document.createElement('div');
@@ -135,6 +173,7 @@ export class CuoralModal {
         this.iframeElement = document.createElement('iframe');
         this.iframeElement.id = 'cuoral-widget-iframe';
         this.iframeElement.src = this.widgetUrl;
+        this.lastLoadedUrl = this.widgetUrl; // Track initial URL
         Object.assign(this.iframeElement.style, {
             width: '100%',
             height: '100%',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cuoral-ionic",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Cuoral Ionic Framework Library - Proactive customer success platform with support ticketing, customer intelligence, screen recording, and engagement tools",
   "type": "module",
   "main": "dist/index.js",

package/src/cuoral.ts

@@ -90,6 +90,12 @@ export class Cuoral {
   public async initialize(): Promise<void> {
     this.bridge.initialize();
     
+    // Recreate modal if it was destroyed (e.g., after clearSession)
+    if (this.options.useModal && !this.modal) {
+      const widgetUrl = this.getWidgetUrl();
+      this.modal = new CuoralModal(widgetUrl, this.options.showFloatingButton);
+    }
+    
     // Initialize modal if enabled
     if (this.modal) {
       this.modal.initialize();
@@ -204,6 +210,9 @@ export class Cuoral {
    */
   public openModal(): void {
     if (this.modal) {
+      // Update iframe URL to include current session_id before opening
+      const currentUrl = this.getWidgetUrl();
+      this.modal.updateWidgetUrl(currentUrl);
       this.modal.open();
     }
   }
@@ -232,14 +241,70 @@ export class Cuoral {
     const params = new URLSearchParams({
       auto_start: 'true',
       key: this.options.publicKey,
+      is_mobile: 'true',
       _t: Date.now().toString(),
     });
     
+    // Add session_id if available
+    const sessionId = localStorage.getItem('__x_loadID');
+    if (sessionId) {
+      params.set('session_id', sessionId);
+    }
+    
     if (this.options.email) params.set('email', this.options.email);
     if (this.options.firstName) params.set('first_name', this.options.firstName);
     if (this.options.lastName) params.set('last_name', this.options.lastName);
     
-    return `${baseUrl}?${params.toString()}`;
+    const url = `${baseUrl}?${params.toString()}`;
+    return url;
+  }
+
+  /**
+   * Clear and end the current session (call before logout)
+   */
+  public async clearSession(): Promise<void> {
+    try {
+      const sessionId = localStorage.getItem('__x_loadID');
+      
+      if (sessionId) {
+        // Notify backend to close the session
+        await fetch('https://api.cuoral.com/conversation/end-session', {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            'x-org-id': this.options.publicKey,
+          },
+          body: JSON.stringify({ 
+            session_id: sessionId
+          }),
+        });
+      }
+      
+      // Clear local session storage
+      localStorage.removeItem('__x_loadID');
+      
+      // Destroy modal to clear cached iframe
+      if (this.modal) {
+        this.modal.destroy();
+        this.modal = undefined;
+      }
+      
+      // Destroy bridge to clear any cached data
+      this.bridge.destroy();
+      
+      // Clear intelligence session
+      if (this.intelligence) {
+        this.intelligence.destroy();
+        this.intelligence = undefined;
+      }
+    } catch (error) {
+      // Fail silently - always clear local storage
+      localStorage.removeItem('__x_loadID');
+      if (this.modal) {
+        this.modal.destroy();
+        this.modal = undefined;
+      }
+    }
   }
 
   /**
@@ -280,13 +345,19 @@ export class Cuoral {
    */
   private async initiateSession(): Promise<string | null> {
     try {
+
       const response = await fetch('https://api.cuoral.com/conversation/initiate-session', {
         method: 'POST',
         headers: {
           'Content-Type': 'application/json',
           'x-org-id': this.options.publicKey,
         },
-        body: JSON.stringify({ public_key: this.options.publicKey }),
+        body: JSON.stringify({ 
+          public_key: this.options.publicKey,
+          email: this.options.email,
+          first_name: this.options.firstName,
+          last_name: this.options.lastName
+        }),
       });
 
       if (!response.ok) {
@@ -297,18 +368,11 @@ export class Cuoral {
       
       if (data.status && data.session_id) {
         localStorage.setItem('__x_loadID', data.session_id);
-        
-        // Set profile if email, firstName, lastName are provided
-        if (this.options.email && this.options.firstName && this.options.lastName) {
-          await this.setProfile(data.session_id);
-        }
-        
         return data.session_id;
       }
       
       return null;
     } catch (error) {
-      console.warn('[Cuoral] Failed to initiate session:', error);
       return null;
     }
   }

package/src/modal.ts

@@ -9,12 +9,61 @@ export class CuoralModal {
   private isOpen = false;
   private widgetUrl: string;
   private showFloatingButton: boolean;
+  private lastLoadedUrl?: string;
 
   constructor(widgetUrl: string, showFloatingButton = true) {
     this.widgetUrl = widgetUrl;
     this.showFloatingButton = showFloatingButton;
   }
 
+  /**
+   * Update the widget URL (e.g., to include new session_id)
+   * Forces complete iframe recreation if URL changed to clear all cached state
+   */
+  public updateWidgetUrl(newUrl: string): void {
+    this.widgetUrl = newUrl;
+    
+    if (!this.iframeElement) return;
+    
+    // Compare URLs without timestamp parameter to check if content changed
+    const stripTimestamp = (url: string) => url.replace(/[&?]_t=[^&]*/, '');
+    const newUrlWithoutTimestamp = stripTimestamp(newUrl);
+    const lastUrlWithoutTimestamp = this.lastLoadedUrl ? stripTimestamp(this.lastLoadedUrl) : '';
+    
+    // Only reload iframe if the URL actually changed (different session or user)
+    if (newUrlWithoutTimestamp !== lastUrlWithoutTimestamp) {
+      // Store reference to parent container
+      const parentContainer = this.iframeElement.parentElement;
+      
+      if (parentContainer) {
+        // Remove old iframe completely
+        parentContainer.removeChild(this.iframeElement);
+        
+        // Create fresh iframe element with cache-busting attributes
+        this.iframeElement = document.createElement('iframe');
+        this.iframeElement.id = 'cuoral-widget-iframe';
+        
+        // Add cache-busting attributes to force fresh load
+        this.iframeElement.setAttribute('data-cache-bust', Date.now().toString());
+        
+        // Use src with force reload parameter
+        this.iframeElement.src = newUrl + '&_reload=1';
+        
+        Object.assign(this.iframeElement.style, {
+          width: '100%',
+          height: '100%',
+          border: 'none',
+          backgroundColor: 'white'
+        });
+        
+        // Append new iframe
+        parentContainer.appendChild(this.iframeElement);
+      }
+      
+      this.lastLoadedUrl = newUrl;
+    }
+  }
+
   /**
    * Initialize the modal and floating button
    */
@@ -99,7 +148,7 @@ export class CuoralModal {
       zIndex: '1000000',
       opacity: '0',
       transition: 'opacity 0.3s ease',
-      padding: '60px 0'
+      padding: '60px 0 30px 0'
     });
 
     // Modal content (with margin)
@@ -157,6 +206,7 @@ export class CuoralModal {
     this.iframeElement = document.createElement('iframe');
     this.iframeElement.id = 'cuoral-widget-iframe';
     this.iframeElement.src = this.widgetUrl;
+    this.lastLoadedUrl = this.widgetUrl; // Track initial URL
     
     Object.assign(this.iframeElement.style, {
       width: '100%',