@senzops/web 1.0.0 → 1.2.0

package/dist/index.d.mts

@@ -1,21 +1,24 @@
-interface Config {
-    webId: string;
-    endpoint?: string;
-}
-declare class SenzorWebAgent {
-    private config;
-    private startTime;
-    private endpoint;
-    constructor();
-    init(config: Config): void;
-    private initSession;
-    private getIds;
-    private trackPageView;
-    private trackPing;
-    private send;
-    private fallbackSend;
-    private setupListeners;
-}
-declare const Senzor: SenzorWebAgent;
-
-export { Senzor };
+interface Config {
+    webId: string;
+    endpoint?: string;
+}
+declare class SenzorWebAgent {
+    private config;
+    private startTime;
+    private endpoint;
+    private initialized;
+    constructor();
+    init(config: Config): void;
+    private normalizeUrl;
+    private manageSession;
+    private determineReferrer;
+    private getIds;
+    private trackPageView;
+    private trackPing;
+    private send;
+    private fallbackSend;
+    private setupListeners;
+}
+declare const Senzor: SenzorWebAgent;
+
+export { Senzor };

package/dist/index.d.ts

@@ -1,21 +1,24 @@
-interface Config {
-    webId: string;
-    endpoint?: string;
-}
-declare class SenzorWebAgent {
-    private config;
-    private startTime;
-    private endpoint;
-    constructor();
-    init(config: Config): void;
-    private initSession;
-    private getIds;
-    private trackPageView;
-    private trackPing;
-    private send;
-    private fallbackSend;
-    private setupListeners;
-}
-declare const Senzor: SenzorWebAgent;
-
-export { Senzor };
+interface Config {
+    webId: string;
+    endpoint?: string;
+}
+declare class SenzorWebAgent {
+    private config;
+    private startTime;
+    private endpoint;
+    private initialized;
+    constructor();
+    init(config: Config): void;
+    private normalizeUrl;
+    private manageSession;
+    private determineReferrer;
+    private getIds;
+    private trackPageView;
+    private trackPing;
+    private send;
+    private fallbackSend;
+    private setupListeners;
+}
+declare const Senzor: SenzorWebAgent;
+
+export { Senzor };

package/dist/index.global.js

@@ -1 +1 @@
-(()=>{function o(){return typeof crypto<"u"&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,n=>{let e=Math.random()*16|0;return(n==="x"?e:e&3|8).toString(16)})}var i=class{config;startTime;endpoint;constructor(){this.config={webId:"",endpoint:"https://api.senzor.dev/api/ingest/web"},this.startTime=Date.now(),this.endpoint=""}init(e){if(this.config={...this.config,...e},this.endpoint=this.config.endpoint||"https://api.senzor.dev/api/ingest/web",!this.config.webId){console.error("[Senzor] WebId is required to initialize analytics.");return}this.initSession(),this.trackPageView(),this.setupListeners()}initSession(){let e=localStorage.getItem("senzor_vid");e||(e=o(),localStorage.setItem("senzor_vid",e));let t=sessionStorage.getItem("senzor_sid");t||(t=o(),sessionStorage.setItem("senzor_sid",t))}getIds(){return{visitorId:localStorage.getItem("senzor_vid")||"unknown",sessionId:sessionStorage.getItem("senzor_sid")||"unknown"}}trackPageView(){this.startTime=Date.now();let e={type:"pageview",webId:this.config.webId,...this.getIds(),url:window.location.href,path:window.location.pathname,referrer:document.referrer,width:window.innerWidth,timezone:Intl.DateTimeFormat().resolvedOptions().timeZone};this.send(e)}trackPing(){let e=Math.floor((Date.now()-this.startTime)/1e3);if(e<1)return;let t={type:"ping",webId:this.config.webId,...this.getIds(),url:window.location.href,path:window.location.pathname,referrer:document.referrer,width:window.innerWidth,timezone:Intl.DateTimeFormat().resolvedOptions().timeZone,duration:e};this.send(t)}send(e){if(navigator.sendBeacon){let t=new Blob([JSON.stringify(e)],{type:"application/json"});navigator.sendBeacon(this.endpoint,t)||this.fallbackSend(e)}else this.fallbackSend(e)}fallbackSend(e){fetch(this.endpoint,{method:"POST",body:JSON.stringify(e),keepalive:!0,headers:{"Content-Type":"application/json"}}).catch(t=>console.error("[Senzor] Failed to send telemetry:",t))}setupListeners(){let e=history.pushState;history.pushState=(...t)=>{this.trackPing(),e.apply(history,t),this.trackPageView()},window.addEventListener("popstate",()=>{this.trackPing(),this.trackPageView()}),document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"?this.trackPing():this.startTime=Date.now()}),window.addEventListener("beforeunload",()=>{this.trackPing()})}},s=new i;typeof window<"u"&&(window.Senzor=s);})();
+(()=>{function d(){return typeof crypto<"u"&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,a=>{let e=Math.random()*16|0;return(a==="x"?e:e&3|8).toString(16)})}var o=class{config;startTime;endpoint;initialized;constructor(){this.config={webId:"",endpoint:"https://api.senzor.dev/api/ingest/web"},this.startTime=Date.now(),this.endpoint="",this.initialized=!1}init(e){if(this.initialized){console.warn("[Senzor] Agent already initialized.");return}if(this.initialized=!0,this.config={...this.config,...e},this.endpoint=this.config.endpoint||"https://api.senzor.dev/api/ingest/web",!this.config.webId){console.error("[Senzor] WebId is required.");return}this.manageSession(),this.trackPageView(),this.setupListeners()}normalizeUrl(e){return e?e.replace(/^https?:\/\//,""):""}manageSession(){let e=Date.now(),t=parseInt(localStorage.getItem("senzor_last_activity")||"0",10),r=1800*1e3;localStorage.getItem("senzor_vid")||localStorage.setItem("senzor_vid",d());let i=sessionStorage.getItem("senzor_sid"),n=e-t>r;!i||n?(i=d(),sessionStorage.setItem("senzor_sid",i),this.determineReferrer(!0)):this.determineReferrer(!1),localStorage.setItem("senzor_last_activity",e.toString())}determineReferrer(e){let t=document.referrer,r=window.location.hostname,i=sessionStorage.getItem("senzor_ref"),n=!1;if(t)try{new URL(t).hostname!==r&&(n=!0)}catch{n=!0}if(n){let s=this.normalizeUrl(t);s!==i&&sessionStorage.setItem("senzor_ref",s)}else e&&!i&&sessionStorage.setItem("senzor_ref","Direct")}getIds(){return localStorage.setItem("senzor_last_activity",Date.now().toString()),{visitorId:localStorage.getItem("senzor_vid")||"unknown",sessionId:sessionStorage.getItem("senzor_sid")||"unknown",referrer:sessionStorage.getItem("senzor_ref")||"Direct"}}trackPageView(){this.manageSession(),this.startTime=Date.now();let e={type:"pageview",webId:this.config.webId,...this.getIds(),url:window.location.href,path:window.location.pathname,title:document.title,width:window.innerWidth,timezone:Intl.DateTimeFormat().resolvedOptions().timeZone,referrer:this.getIds().referrer};this.send(e)}trackPing(){let e=Math.floor((Date.now()-this.startTime)/1e3);if(e<1)return;let t={type:"ping",webId:this.config.webId,...this.getIds(),url:window.location.href,path:window.location.pathname,title:document.title,width:window.innerWidth,timezone:Intl.DateTimeFormat().resolvedOptions().timeZone,referrer:this.getIds().referrer,duration:e};this.send(t)}send(e){if(navigator.sendBeacon){let t=new Blob([JSON.stringify(e)],{type:"application/json"});navigator.sendBeacon(this.endpoint,t)||this.fallbackSend(e)}else this.fallbackSend(e)}fallbackSend(e){fetch(this.endpoint,{method:"POST",body:JSON.stringify(e),keepalive:!0,headers:{"Content-Type":"application/json"}}).catch(t=>console.error("[Senzor] Telemetry Error:",t))}setupListeners(){let e=history.pushState;history.pushState=(...t)=>{this.trackPing(),e.apply(history,t),this.trackPageView()},window.addEventListener("popstate",()=>{this.trackPing(),this.trackPageView()}),document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"?this.trackPing():(this.startTime=Date.now(),this.manageSession())}),window.addEventListener("beforeunload",()=>{this.trackPing()})}},c=new o;typeof window<"u"&&(window.Senzor=c);})();

package/dist/index.js

@@ -1 +1 @@
-var s=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var h=(i,e)=>{for(var t in e)s(i,t,{get:e[t],enumerable:!0})},l=(i,e,t,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of p(e))!g.call(i,n)&&n!==t&&s(i,n,{get:()=>e[n],enumerable:!(o=c(e,n))||o.enumerable});return i};var w=i=>l(s({},"__esModule",{value:!0}),i);var f={};h(f,{Senzor:()=>d});module.exports=w(f);function a(){return typeof crypto<"u"&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,i=>{let e=Math.random()*16|0;return(i==="x"?e:e&3|8).toString(16)})}var r=class{config;startTime;endpoint;constructor(){this.config={webId:"",endpoint:"https://api.senzor.dev/api/ingest/web"},this.startTime=Date.now(),this.endpoint=""}init(e){if(this.config={...this.config,...e},this.endpoint=this.config.endpoint||"https://api.senzor.dev/api/ingest/web",!this.config.webId){console.error("[Senzor] WebId is required to initialize analytics.");return}this.initSession(),this.trackPageView(),this.setupListeners()}initSession(){let e=localStorage.getItem("senzor_vid");e||(e=a(),localStorage.setItem("senzor_vid",e));let t=sessionStorage.getItem("senzor_sid");t||(t=a(),sessionStorage.setItem("senzor_sid",t))}getIds(){return{visitorId:localStorage.getItem("senzor_vid")||"unknown",sessionId:sessionStorage.getItem("senzor_sid")||"unknown"}}trackPageView(){this.startTime=Date.now();let e={type:"pageview",webId:this.config.webId,...this.getIds(),url:window.location.href,path:window.location.pathname,referrer:document.referrer,width:window.innerWidth,timezone:Intl.DateTimeFormat().resolvedOptions().timeZone};this.send(e)}trackPing(){let e=Math.floor((Date.now()-this.startTime)/1e3);if(e<1)return;let t={type:"ping",webId:this.config.webId,...this.getIds(),url:window.location.href,path:window.location.pathname,referrer:document.referrer,width:window.innerWidth,timezone:Intl.DateTimeFormat().resolvedOptions().timeZone,duration:e};this.send(t)}send(e){if(navigator.sendBeacon){let t=new Blob([JSON.stringify(e)],{type:"application/json"});navigator.sendBeacon(this.endpoint,t)||this.fallbackSend(e)}else this.fallbackSend(e)}fallbackSend(e){fetch(this.endpoint,{method:"POST",body:JSON.stringify(e),keepalive:!0,headers:{"Content-Type":"application/json"}}).catch(t=>console.error("[Senzor] Failed to send telemetry:",t))}setupListeners(){let e=history.pushState;history.pushState=(...t)=>{this.trackPing(),e.apply(history,t),this.trackPageView()},window.addEventListener("popstate",()=>{this.trackPing(),this.trackPageView()}),document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"?this.trackPing():this.startTime=Date.now()}),window.addEventListener("beforeunload",()=>{this.trackPing()})}},d=new r;typeof window<"u"&&(window.Senzor=d);0&&(module.exports={Senzor});
+var a=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var f=(n,e)=>{for(var t in e)a(n,t,{get:e[t],enumerable:!0})},w=(n,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of h(e))!p.call(n,i)&&i!==t&&a(n,i,{get:()=>e[i],enumerable:!(r=g(e,i))||r.enumerable});return n};var m=n=>w(a({},"__esModule",{value:!0}),n);var u={};f(u,{Senzor:()=>l});module.exports=m(u);function c(){return typeof crypto<"u"&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,n=>{let e=Math.random()*16|0;return(n==="x"?e:e&3|8).toString(16)})}var d=class{config;startTime;endpoint;initialized;constructor(){this.config={webId:"",endpoint:"https://api.senzor.dev/api/ingest/web"},this.startTime=Date.now(),this.endpoint="",this.initialized=!1}init(e){if(this.initialized){console.warn("[Senzor] Agent already initialized.");return}if(this.initialized=!0,this.config={...this.config,...e},this.endpoint=this.config.endpoint||"https://api.senzor.dev/api/ingest/web",!this.config.webId){console.error("[Senzor] WebId is required.");return}this.manageSession(),this.trackPageView(),this.setupListeners()}normalizeUrl(e){return e?e.replace(/^https?:\/\//,""):""}manageSession(){let e=Date.now(),t=parseInt(localStorage.getItem("senzor_last_activity")||"0",10),r=1800*1e3;localStorage.getItem("senzor_vid")||localStorage.setItem("senzor_vid",c());let i=sessionStorage.getItem("senzor_sid"),s=e-t>r;!i||s?(i=c(),sessionStorage.setItem("senzor_sid",i),this.determineReferrer(!0)):this.determineReferrer(!1),localStorage.setItem("senzor_last_activity",e.toString())}determineReferrer(e){let t=document.referrer,r=window.location.hostname,i=sessionStorage.getItem("senzor_ref"),s=!1;if(t)try{new URL(t).hostname!==r&&(s=!0)}catch{s=!0}if(s){let o=this.normalizeUrl(t);o!==i&&sessionStorage.setItem("senzor_ref",o)}else e&&!i&&sessionStorage.setItem("senzor_ref","Direct")}getIds(){return localStorage.setItem("senzor_last_activity",Date.now().toString()),{visitorId:localStorage.getItem("senzor_vid")||"unknown",sessionId:sessionStorage.getItem("senzor_sid")||"unknown",referrer:sessionStorage.getItem("senzor_ref")||"Direct"}}trackPageView(){this.manageSession(),this.startTime=Date.now();let e={type:"pageview",webId:this.config.webId,...this.getIds(),url:window.location.href,path:window.location.pathname,title:document.title,width:window.innerWidth,timezone:Intl.DateTimeFormat().resolvedOptions().timeZone,referrer:this.getIds().referrer};this.send(e)}trackPing(){let e=Math.floor((Date.now()-this.startTime)/1e3);if(e<1)return;let t={type:"ping",webId:this.config.webId,...this.getIds(),url:window.location.href,path:window.location.pathname,title:document.title,width:window.innerWidth,timezone:Intl.DateTimeFormat().resolvedOptions().timeZone,referrer:this.getIds().referrer,duration:e};this.send(t)}send(e){if(navigator.sendBeacon){let t=new Blob([JSON.stringify(e)],{type:"application/json"});navigator.sendBeacon(this.endpoint,t)||this.fallbackSend(e)}else this.fallbackSend(e)}fallbackSend(e){fetch(this.endpoint,{method:"POST",body:JSON.stringify(e),keepalive:!0,headers:{"Content-Type":"application/json"}}).catch(t=>console.error("[Senzor] Telemetry Error:",t))}setupListeners(){let e=history.pushState;history.pushState=(...t)=>{this.trackPing(),e.apply(history,t),this.trackPageView()},window.addEventListener("popstate",()=>{this.trackPing(),this.trackPageView()}),document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"?this.trackPing():(this.startTime=Date.now(),this.manageSession())}),window.addEventListener("beforeunload",()=>{this.trackPing()})}},l=new d;typeof window<"u"&&(window.Senzor=l);0&&(module.exports={Senzor});

package/dist/index.mjs

@@ -1 +1 @@
-function o(){return typeof crypto<"u"&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,n=>{let e=Math.random()*16|0;return(n==="x"?e:e&3|8).toString(16)})}var i=class{config;startTime;endpoint;constructor(){this.config={webId:"",endpoint:"https://api.senzor.dev/api/ingest/web"},this.startTime=Date.now(),this.endpoint=""}init(e){if(this.config={...this.config,...e},this.endpoint=this.config.endpoint||"https://api.senzor.dev/api/ingest/web",!this.config.webId){console.error("[Senzor] WebId is required to initialize analytics.");return}this.initSession(),this.trackPageView(),this.setupListeners()}initSession(){let e=localStorage.getItem("senzor_vid");e||(e=o(),localStorage.setItem("senzor_vid",e));let t=sessionStorage.getItem("senzor_sid");t||(t=o(),sessionStorage.setItem("senzor_sid",t))}getIds(){return{visitorId:localStorage.getItem("senzor_vid")||"unknown",sessionId:sessionStorage.getItem("senzor_sid")||"unknown"}}trackPageView(){this.startTime=Date.now();let e={type:"pageview",webId:this.config.webId,...this.getIds(),url:window.location.href,path:window.location.pathname,referrer:document.referrer,width:window.innerWidth,timezone:Intl.DateTimeFormat().resolvedOptions().timeZone};this.send(e)}trackPing(){let e=Math.floor((Date.now()-this.startTime)/1e3);if(e<1)return;let t={type:"ping",webId:this.config.webId,...this.getIds(),url:window.location.href,path:window.location.pathname,referrer:document.referrer,width:window.innerWidth,timezone:Intl.DateTimeFormat().resolvedOptions().timeZone,duration:e};this.send(t)}send(e){if(navigator.sendBeacon){let t=new Blob([JSON.stringify(e)],{type:"application/json"});navigator.sendBeacon(this.endpoint,t)||this.fallbackSend(e)}else this.fallbackSend(e)}fallbackSend(e){fetch(this.endpoint,{method:"POST",body:JSON.stringify(e),keepalive:!0,headers:{"Content-Type":"application/json"}}).catch(t=>console.error("[Senzor] Failed to send telemetry:",t))}setupListeners(){let e=history.pushState;history.pushState=(...t)=>{this.trackPing(),e.apply(history,t),this.trackPageView()},window.addEventListener("popstate",()=>{this.trackPing(),this.trackPageView()}),document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"?this.trackPing():this.startTime=Date.now()}),window.addEventListener("beforeunload",()=>{this.trackPing()})}},s=new i;typeof window<"u"&&(window.Senzor=s);export{s as Senzor};
+function d(){return typeof crypto<"u"&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,a=>{let e=Math.random()*16|0;return(a==="x"?e:e&3|8).toString(16)})}var o=class{config;startTime;endpoint;initialized;constructor(){this.config={webId:"",endpoint:"https://api.senzor.dev/api/ingest/web"},this.startTime=Date.now(),this.endpoint="",this.initialized=!1}init(e){if(this.initialized){console.warn("[Senzor] Agent already initialized.");return}if(this.initialized=!0,this.config={...this.config,...e},this.endpoint=this.config.endpoint||"https://api.senzor.dev/api/ingest/web",!this.config.webId){console.error("[Senzor] WebId is required.");return}this.manageSession(),this.trackPageView(),this.setupListeners()}normalizeUrl(e){return e?e.replace(/^https?:\/\//,""):""}manageSession(){let e=Date.now(),t=parseInt(localStorage.getItem("senzor_last_activity")||"0",10),r=1800*1e3;localStorage.getItem("senzor_vid")||localStorage.setItem("senzor_vid",d());let i=sessionStorage.getItem("senzor_sid"),n=e-t>r;!i||n?(i=d(),sessionStorage.setItem("senzor_sid",i),this.determineReferrer(!0)):this.determineReferrer(!1),localStorage.setItem("senzor_last_activity",e.toString())}determineReferrer(e){let t=document.referrer,r=window.location.hostname,i=sessionStorage.getItem("senzor_ref"),n=!1;if(t)try{new URL(t).hostname!==r&&(n=!0)}catch{n=!0}if(n){let s=this.normalizeUrl(t);s!==i&&sessionStorage.setItem("senzor_ref",s)}else e&&!i&&sessionStorage.setItem("senzor_ref","Direct")}getIds(){return localStorage.setItem("senzor_last_activity",Date.now().toString()),{visitorId:localStorage.getItem("senzor_vid")||"unknown",sessionId:sessionStorage.getItem("senzor_sid")||"unknown",referrer:sessionStorage.getItem("senzor_ref")||"Direct"}}trackPageView(){this.manageSession(),this.startTime=Date.now();let e={type:"pageview",webId:this.config.webId,...this.getIds(),url:window.location.href,path:window.location.pathname,title:document.title,width:window.innerWidth,timezone:Intl.DateTimeFormat().resolvedOptions().timeZone,referrer:this.getIds().referrer};this.send(e)}trackPing(){let e=Math.floor((Date.now()-this.startTime)/1e3);if(e<1)return;let t={type:"ping",webId:this.config.webId,...this.getIds(),url:window.location.href,path:window.location.pathname,title:document.title,width:window.innerWidth,timezone:Intl.DateTimeFormat().resolvedOptions().timeZone,referrer:this.getIds().referrer,duration:e};this.send(t)}send(e){if(navigator.sendBeacon){let t=new Blob([JSON.stringify(e)],{type:"application/json"});navigator.sendBeacon(this.endpoint,t)||this.fallbackSend(e)}else this.fallbackSend(e)}fallbackSend(e){fetch(this.endpoint,{method:"POST",body:JSON.stringify(e),keepalive:!0,headers:{"Content-Type":"application/json"}}).catch(t=>console.error("[Senzor] Telemetry Error:",t))}setupListeners(){let e=history.pushState;history.pushState=(...t)=>{this.trackPing(),e.apply(history,t),this.trackPageView()},window.addEventListener("popstate",()=>{this.trackPing(),this.trackPageView()}),document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"?this.trackPing():(this.startTime=Date.now(),this.manageSession())}),window.addEventListener("beforeunload",()=>{this.trackPing()})}},c=new o;typeof window<"u"&&(window.Senzor=c);export{c as Senzor};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@senzops/web",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Senzor Web Analytics SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -16,4 +16,4 @@
   "publishConfig": {
     "access": "public"
   }
-}
+}

package/src/index.ts

@@ -1,6 +1,3 @@
-// Remove the external uuid import causing the crash
-// import { v4 as uuidv4 } from 'uuid'; 
-
 interface Config {
   webId: string;
   endpoint?: string;
@@ -13,19 +10,18 @@ interface Payload {
   sessionId: string;
   url: string;
   path: string;
+  title: string;
   referrer: string;
   width: number;
   timezone: string;
-  duration?: number; // Only for pings/unload
+  duration?: number;
 }
 
-// --- Native UUID Helper (Fixes "require('crypto')" error) ---
+// Browser-Native UUID (No Node.js dependencies)
 function generateUUID(): string {
-  // Use native crypto API if available (Modern Browsers)
   if (typeof crypto !== 'undefined' && crypto.randomUUID) {
     return crypto.randomUUID();
   }
-  // Fallback for older environments
   return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
     const r = (Math.random() * 16) | 0;
     const v = c === 'x' ? r : (r & 0x3) | 0x8;
@@ -37,76 +33,130 @@ class SenzorWebAgent {
   private config: Config;
   private startTime: number;
   private endpoint: string;
+  private initialized: boolean;
 
   constructor() {
     this.config = { webId: '', endpoint: 'https://api.senzor.dev/api/ingest/web' };
     this.startTime = Date.now();
     this.endpoint = '';
+    this.initialized = false;
   }
 
   public init(config: Config) {
+    if (this.initialized) {
+      console.warn('[Senzor] Agent already initialized.');
+      return;
+    }
+    this.initialized = true;
+
     this.config = { ...this.config, ...config };
-    // Allow overriding endpoint for self-hosting or dev
     this.endpoint = this.config.endpoint || 'https://api.senzor.dev/api/ingest/web';
 
     if (!this.config.webId) {
-      console.error('[Senzor] WebId is required to initialize analytics.');
+      console.error('[Senzor] WebId is required.');
       return;
     }
 
-    // 1. Initialize Session
-    this.initSession();
-
-    // 2. Track Initial Page View
+    this.manageSession();
     this.trackPageView();
-
-    // 3. Setup Listeners
     this.setupListeners();
   }
 
-  private initSession() {
-    // Persistent Visitor ID (1 year)
-    let vid = localStorage.getItem('senzor_vid');
-    if (!vid) {
-      vid = generateUUID();
-      localStorage.setItem('senzor_vid', vid!);
+  // Helper to normalize referrer (strip protocol)
+  private normalizeUrl(url: string): string {
+    if (!url) return '';
+    return url.replace(/^https?:\/\//, '');
+  }
+
+  private manageSession() {
+    const now = Date.now();
+    const lastActivity = parseInt(localStorage.getItem('senzor_last_activity') || '0', 10);
+    const sessionTimeout = 30 * 60 * 1000; // 30 mins
+
+    // Visitor ID (Persistent 1 Year)
+    if (!localStorage.getItem('senzor_vid')) {
+      localStorage.setItem('senzor_vid', generateUUID());
     }
 
-    // Session ID (Expires when browser closes)
-    let sid = sessionStorage.getItem('senzor_sid');
-    if (!sid) {
-      sid = generateUUID();
-      sessionStorage.setItem('senzor_sid', sid!);
+    // Session ID
+    let sessionId = sessionStorage.getItem('senzor_sid');
+    const isExpired = (now - lastActivity > sessionTimeout);
+
+    // Session logic
+    if (!sessionId || isExpired) {
+      sessionId = generateUUID();
+      sessionStorage.setItem('senzor_sid', sessionId);
+      this.determineReferrer(true);
+    } else {
+      // Ongoing session: Check if external source changed
+      this.determineReferrer(false);
+    }
+
+    localStorage.setItem('senzor_last_activity', now.toString());
+  }
+
+  private determineReferrer(isNewSession: boolean) {
+    const rawReferrer = document.referrer;
+    const currentHost = window.location.hostname;
+    let storedReferrer = sessionStorage.getItem('senzor_ref');
+
+    let isExternal = false;
+    if (rawReferrer) {
+      try {
+        const refUrl = new URL(rawReferrer);
+        // Compare hosts
+        if (refUrl.hostname !== currentHost) {
+          isExternal = true;
+        }
+      } catch (e) {
+        isExternal = true;
+      }
+    }
+
+    if (isExternal) {
+      // Always overwrite if it's a new external source
+      const cleanRef = this.normalizeUrl(rawReferrer);
+      // Only update if different to avoid redundant writes
+      if (cleanRef !== storedReferrer) {
+        sessionStorage.setItem('senzor_ref', cleanRef);
+      }
+    } else if (isNewSession && !storedReferrer) {
+      // New session with internal/no referrer = Direct
+      sessionStorage.setItem('senzor_ref', 'Direct');
     }
   }
 
   private getIds() {
+    localStorage.setItem('senzor_last_activity', Date.now().toString());
     return {
       visitorId: localStorage.getItem('senzor_vid') || 'unknown',
-      sessionId: sessionStorage.getItem('senzor_sid') || 'unknown'
+      sessionId: sessionStorage.getItem('senzor_sid') || 'unknown',
+      referrer: sessionStorage.getItem('senzor_ref') || 'Direct'
     };
   }
 
   private trackPageView() {
-    this.startTime = Date.now(); // Reset timer for new page
+    this.manageSession();
+    this.startTime = Date.now();
+
     const payload: Payload = {
       type: 'pageview',
       webId: this.config.webId,
       ...this.getIds(),
       url: window.location.href,
       path: window.location.pathname,
-      referrer: document.referrer,
+      title: document.title,
       width: window.innerWidth,
       timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+      referrer: this.getIds().referrer
     };
 
     this.send(payload);
   }
 
-  // Captures time spent on page when user leaves or hides tab
   private trackPing() {
     const duration = Math.floor((Date.now() - this.startTime) / 1000);
-    if (duration < 1) return; // Ignore accidental bounces
+    if (duration < 1) return;
 
     const payload: Payload = {
       type: 'ping',
@@ -114,9 +164,10 @@ class SenzorWebAgent {
       ...this.getIds(),
       url: window.location.href,
       path: window.location.pathname,
-      referrer: document.referrer,
+      title: document.title,
       width: window.innerWidth,
       timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+      referrer: this.getIds().referrer,
       duration: duration
     };
 
@@ -124,10 +175,8 @@ class SenzorWebAgent {
   }
 
   private send(data: Payload) {
-    // Use sendBeacon for reliability during unload, fallback to fetch
     if (navigator.sendBeacon) {
       const blob = new Blob([JSON.stringify(data)], { type: 'application/json' });
-      // sendBeacon returns false if it fails (e.g. payload too large)
       const success = navigator.sendBeacon(this.endpoint, blob);
       if (!success) this.fallbackSend(data);
     } else {
@@ -141,16 +190,16 @@ class SenzorWebAgent {
       body: JSON.stringify(data),
       keepalive: true,
       headers: { 'Content-Type': 'application/json' }
-    }).catch(err => console.error('[Senzor] Failed to send telemetry:', err));
+    }).catch(err => console.error('[Senzor] Telemetry Error:', err));
   }
 
   private setupListeners() {
-    // 1. History API Support (SPA - React/Next.js/Vue)
+    // SPA Support
     const originalPushState = history.pushState;
     history.pushState = (...args) => {
-      this.trackPing(); // Send duration for previous page
+      this.trackPing();
       originalPushState.apply(history, args);
-      this.trackPageView(); // Track new page
+      this.trackPageView();
     };
 
     window.addEventListener('popstate', () => {
@@ -158,27 +207,25 @@ class SenzorWebAgent {
       this.trackPageView();
     });
 
-    // 2. Visibility Change (Tab switch / Minimize)
+    // Visibility & Unload
     document.addEventListener('visibilitychange', () => {
       if (document.visibilityState === 'hidden') {
         this.trackPing();
       } else {
-        // User came back, reset timer so we don't count background time
+        // User returned, restart timer (don't count background time)
         this.startTime = Date.now();
+        this.manageSession();
       }
     });
 
-    // 3. Before Unload (Closing tab)
     window.addEventListener('beforeunload', () => {
       this.trackPing();
     });
   }
 }
 
-// Export Singleton
 export const Senzor = new SenzorWebAgent();
 
-// Allow window access for script tag usage
 if (typeof window !== 'undefined') {
   (window as any).Senzor = Senzor;
 }