@bluenath/engage 2.0.3 → 2.0.4

package/dist/core/Analytics.d.ts

@@ -1,15 +1,27 @@
-import { EngageConfig, AnalyticsEvent } from '../types';
+import { EngageConfig, AnalyticsEvent, SentimentValue } from '../types';
 
 export declare class EngagePro {
     private config;
     private context;
     private queue;
     private transport;
+    private sessionId;
+    private countryCode;
+    private currentSentiment;
     constructor(config: EngageConfig);
     identify: (userId: string, traits?: Record<string, unknown>) => void;
     page: (name?: string, properties?: Record<string, unknown>) => void;
     track: (eventName: string, properties?: Record<string, unknown>, intelligence?: Partial<AnalyticsEvent>) => void;
     trackRevenue: (amount: number | string, properties?: Record<string, unknown>, intelligence?: Partial<AnalyticsEvent>) => void;
+    /**
+     * Spec §3.3: Set sentiment for the current session.
+     * Attached to the next emitted event.
+     */
+    setSentiment: (sentiment: SentimentValue) => void;
+    /**
+     * Emit a new-format EngageEvent to the ingest pipeline (Spec §3.1).
+     */
+    private emitEngageEvent;
     private parseRef;
     private processEvent;
 }

package/dist/core/EventQueue.d.ts

@@ -1,18 +1,43 @@
-import { AnalyticsEvent } from '../types';
+import { AnalyticsEvent, EngageEvent } from '../types';
 import { Transport } from './Transport';
 
 export declare class EventQueue {
     private queue;
+    private engageQueue;
     private storage;
     private transport;
     private readonly STORAGE_KEY;
+    private readonly ENGAGE_STORAGE_KEY;
     private isFlushing;
     private flushInterval;
     private retryCount;
+    private readonly MAX_RETRIES;
     constructor(transport: Transport);
     private startTimer;
+    /**
+     * Enqueue a legacy AnalyticsEvent (backward compatibility)
+     */
     enqueue(event: AnalyticsEvent): void;
+    /**
+     * Enqueue a new EngageEvent (Spec §3.1)
+     */
+    enqueueEngageEvent(event: EngageEvent): void;
     private save;
+    private saveEngage;
     private load;
+    /**
+     * Flush legacy events (existing behavior)
+     */
     flush(): Promise<void>;
+    /**
+     * Spec §3.4: Flush EngageEvent[] with exponential backoff retry.
+     * Max 3 retries with 1s/2s/4s backoff. Drop batch after 3 failures.
+     * Do not retry on 401/422 (permanent failures).
+     */
+    flushEngageEvents(): Promise<void>;
+    /**
+     * Spec §3.4: Use navigator.sendBeacon() to flush remaining events on page unload.
+     * This is a best-effort fire-and-forget — no retry possible.
+     */
+    private flushBeacon;
 }

package/dist/core/Transport.d.ts

@@ -1,7 +1,30 @@
-import { AnalyticsEvent } from '../types';
+import { AnalyticsEvent, EngageEvent } from '../types';
 
+export interface TransportResult {
+    success: boolean;
+    permanent: boolean;
+    status?: number;
+}
 export declare class Transport {
     private apiEndpoint;
+    private apiKey;
     constructor(apiEndpoint: string);
+    setApiKey(key: string): void;
+    /**
+     * Sends legacy batched events (existing format).
+     * Used by the old EventQueue for backward compatibility.
+     */
     send(events: AnalyticsEvent[]): Promise<boolean>;
+    /**
+     * Sends new EngageEvent[] to the ingest endpoint (Spec §4.1).
+     * Returns detailed result for retry logic.
+     */
+    sendEngageEvents(events: EngageEvent[]): Promise<TransportResult>;
+    private sendRaw;
+    /**
+     * Uses sendBeacon for last-resort page unload flush.
+     * Cannot send auth headers — the ingest endpoint must also accept
+     * the apiKey in the body payload as fallback.
+     */
+    beaconFlush(payload: string): boolean;
 }

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";var t=Object.defineProperty,e=(e,n,i)=>((e,n,i)=>n in e?t(e,n,{enumerable:!0,configurable:!0,writable:!0,value:i}):e[n]=i)(e,"symbol"!=typeof n?n+"":n,i);Object.defineProperties(exports,{t:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const n=require("react/jsx-runtime"),i=require("react");let s;const r=new Uint8Array(16);function o(){if(!s&&(s="undefined"!=typeof crypto&&crypto.getRandomValues&&crypto.getRandomValues.bind(crypto),!s))throw new Error("crypto.getRandomValues() not supported. See https://github.com/uuidjs/uuid#getrandomvalues-not-supported");return s(r)}const a=[];for(let S=0;S<256;++S)a.push((S+256).toString(16).slice(1));const c={randomUUID:"undefined"!=typeof crypto&&crypto.randomUUID&&crypto.randomUUID.bind(crypto)};function d(t,e,n){if(c.randomUUID&&!t)return c.randomUUID();const i=(t=t||{}).random||(t.rng||o)();return i[6]=15&i[6]|64,i[8]=63&i[8]|128,function(t,e=0){return a[t[e+0]]+a[t[e+1]]+a[t[e+2]]+a[t[e+3]]+"-"+a[t[e+4]]+a[t[e+5]]+"-"+a[t[e+6]]+a[t[e+7]]+"-"+a[t[e+8]]+a[t[e+9]]+"-"+a[t[e+10]]+a[t[e+11]]+a[t[e+12]]+a[t[e+13]]+a[t[e+14]]+a[t[e+15]]}(i)}const h=t=>{let e=2166136261;const n=t.length;for(let i=0;i<n;i++)e^=t.charCodeAt(i),e+=(e<<1)+(e<<4)+(e<<7)+(e<<8)+(e<<24);return("0000000"+(e>>>0).toString(16)).substr(-8)};class u{constructor(t="local"){e(this,"memoryStore",{}),e(this,"keyPrefix","engage_"),e(this,"domain"),this.type=t,this.domain=this.getCookieDomain()}getItem(t){const e=this.keyPrefix+t;if(this.memoryStore.hasOwnProperty(e))return this.memoryStore[e];try{if("local"===this.type&&this.isBrowser())return window.localStorage.getItem(e);if("cookie"===this.type&&this.isBrowser())return this.getCookie(e)}catch(n){return null}return null}setItem(t,e){const n=this.keyPrefix+t;this.memoryStore[n]=e;try{"local"===this.type&&this.isBrowser()?window.localStorage.setItem(n,e):"cookie"===this.type&&this.isBrowser()&&this.setCookie(n,e,365)}catch(i){this.isQuotaError(i)&&(this.type="memory")}}removeItem(t){const e=this.keyPrefix+t;delete this.memoryStore[e];try{"local"===this.type&&this.isBrowser()?window.localStorage.removeItem(e):"cookie"===this.type&&this.isBrowser()&&this.setCookie(e,"",-1)}catch(n){}}getCookie(t){const e=t+"=",n=document.cookie.split(";");for(let i=0;i<n.length;i++){let t=n[i];for(;" "===t.charAt(0);)t=t.substring(1,t.length);if(0===t.indexOf(e))return decodeURIComponent(t.substring(e.length,t.length))}return null}setCookie(t,e,n){let i="";if(n){const t=new Date;t.setTime(t.getTime()+24*n*60*60*1e3),i="; expires="+t.toUTCString()}document.cookie=`${t}=${encodeURIComponent(e)}${i}; path=/; domain=${this.domain}; SameSite=Lax; Secure`}getCookieDomain(){if(!this.isBrowser())return"";const t=window.location.hostname,e=t.split(".");return 1===e.length||"localhost"===t?"":e.length>2?"."+e.slice(-2).join("."):"."+t}isBrowser(){try{return"undefined"!=typeof window&&void 0!==window.document}catch(t){return!1}}isQuotaError(t){return t instanceof DOMException&&(22===t.code||1014===t.code||"QuotaExceededError"===t.name||"NS_ERROR_DOM_QUOTA_REACHED"===t.name)}}class l{constructor(t){e(this,"storage"),e(this,"SESSION_TIMEOUT",18e5),e(this,"deviceId"),e(this,"sessionId"),e(this,"userId",null),e(this,"currentUrl"),e(this,"referrer"),this.storage=new u(t.persistence),this.deviceId=this.getOrSetDeviceId(),this.sessionId="",this.manageSession(),"undefined"!=typeof window?(this.currentUrl=window.location.href,this.referrer=document.referrer,this.listenToHistory()):(this.currentUrl="",this.referrer="")}getOrSetDeviceId(){const t=this.storage.getItem("device_id");if(t)return t;const e=(()=>{if("undefined"==typeof window)return"server-side-id";const t=navigator,e=window.screen,n={userAgent:t.userAgent||"",screenRes:`${e.width}x${e.height}`,colorDepth:e.colorDepth||0,timezone:(new Date).getTimezoneOffset(),language:t.language||"en-US",platform:t.platform||"unknown",hardwareConcurrency:t.hardwareConcurrency||1,deviceMemory:t.deviceMemory||0},i=[n.platform,n.language,n.screenRes,n.colorDepth,n.timezone,n.hardwareConcurrency,n.deviceMemory].join("|");return`${h(i)}-${h(n.userAgent)}`})();return this.storage.setItem("device_id",e),e}manageSession(){const t=Date.now(),e=this.storage.getItem("session_id"),n=parseInt(this.storage.getItem("last_activity")||"0");if(!e||t-n>this.SESSION_TIMEOUT?(this.sessionId=`sess_${t}_${Math.random().toString(36).substr(2,9)}`,this.storage.setItem("session_id",this.sessionId)):this.sessionId=e,this.storage.setItem("last_activity",t.toString()),"undefined"!=typeof window){const t=()=>this.storage.setItem("last_activity",Date.now().toString());window.addEventListener("click",t),window.addEventListener("scroll",t)}}listenToHistory(){const t=history.pushState;history.pushState=(...e)=>{t.apply(history,e),this.handleUrlChange()},window.addEventListener("popstate",()=>this.handleUrlChange())}handleUrlChange(){const t=window.location.href;t!==this.currentUrl&&(this.referrer=this.currentUrl,this.currentUrl=t)}getPayload(){var t;return{library:{name:"@engagepro/analytics",version:"2.0.0"},user:{anonymousId:this.deviceId,id:this.userId},session:{id:this.sessionId,startTime:parseInt(this.sessionId.split("_")[1]||Date.now().toString())},page:{path:"undefined"!=typeof window?window.location.pathname:"",referrer:this.referrer,title:"undefined"!=typeof document?document.title:"",search:"undefined"!=typeof window?window.location.search:"",url:this.currentUrl},network:{online:"undefined"==typeof navigator||navigator.onLine,downlink:null==(t=navigator.connection)?void 0:t.downlink},screen:{width:"undefined"!=typeof screen?screen.width:0,height:"undefined"!=typeof screen?screen.height:0,density:"undefined"!=typeof window?window.devicePixelRatio:1},device:{fingerprint:this.deviceId,type:this.getDeviceType(),userAgent:"undefined"!=typeof navigator?navigator.userAgent:"server"},locale:"undefined"!=typeof navigator?navigator.language:"en-US",timezone:Intl.DateTimeFormat().resolvedOptions().timeZone}}getDeviceType(){if("undefined"==typeof navigator)return"desktop";const t=navigator.userAgent;return/(tablet|ipad|playbook|silk)|(android(?!.*mobi))/i.test(t)?"tablet":/Mobile|Android|iP(hone|od)|IEMobile|BlackBerry|Kindle|Silk-Accelerated/.test(t)?"mobile":"desktop"}}class f{constructor(t){e(this,"queue",[]),e(this,"storage"),e(this,"transport"),e(this,"STORAGE_KEY","engage_queue_v1"),e(this,"isFlushing",!1),e(this,"flushInterval"),e(this,"retryCount",0),this.transport=t,this.storage=new u("local"),this.load(),"undefined"!=typeof window&&(window.addEventListener("online",()=>{this.retryCount=0,this.flush()}),window.addEventListener("visibilitychange",()=>{"hidden"===document.visibilityState&&this.flush()})),this.startTimer()}startTimer(){this.flushInterval&&clearInterval(this.flushInterval);const t=3e3*Math.pow(2,this.retryCount);this.flushInterval=setInterval(()=>{this.flush()},Math.min(t,3e4))}enqueue(t){this.queue.push(t),this.save(),(this.queue.length>=10||"PURCHASE"===t.standardEvent)&&this.flush()}save(){this.storage.setItem(this.STORAGE_KEY,JSON.stringify(this.queue))}load(){const t=this.storage.getItem(this.STORAGE_KEY);if(t)try{this.queue=JSON.parse(t)}catch(e){this.queue=[]}}async flush(){if(0===this.queue.length||this.isFlushing)return;if("undefined"!=typeof navigator&&!navigator.onLine)return;this.isFlushing=!0;const t=[...this.queue];this.queue=[],this.save();try{if(!(await this.transport.send(t)))throw new Error("Server rejected batch");this.retryCount=0,this.startTimer()}catch(e){this.queue=[...t,...this.queue],this.save(),this.retryCount++,this.startTimer()}finally{this.isFlushing=!1}}}class p{constructor(t){this.apiEndpoint=t}async send(t){const e=JSON.stringify({batch:t,sentAt:(new Date).toISOString()});if("undefined"!=typeof navigator&&navigator.sendBeacon&&e.length<6e4){const t=new Blob([e],{type:"application/json"});if(navigator.sendBeacon(this.apiEndpoint,t))return!0}try{return(await fetch(this.apiEndpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:e,keepalive:!0})).ok}catch(n){return!1}}}const w="https://engage-api.bluenath.com/api/v1/tracking/ingest",y=new Set(["localhost","127.0.0.1"]),v={$:"USD",US$:"USD",USD:"USD","₹":"INR",RS:"INR","RS.":"INR",INR:"INR","€":"EUR",EUR:"EUR","£":"GBP",GBP:"GBP","¥":"JPY",JPY:"JPY"},m=t=>{if("string"!=typeof t)return;const e=t.trim().toUpperCase();return e?v[e]?v[e]:e.includes("₹")||e.startsWith("RS")?"INR":e.includes("$")&&!e.includes("CAD")?"USD":e.includes("€")?"EUR":e.includes("£")?"GBP":e.includes("¥")?"JPY":/^[A-Z]{3}$/.test(e)?e:void 0:void 0};class g{constructor(t){e(this,"config"),e(this,"context"),e(this,"queue"),e(this,"transport"),e(this,"identify",(t,e)=>{this.context.userId=t,this.processEvent({event:"Identify",properties:{traits:e},standardEvent:"LOGIN",intent:"identity",confidence:1})}),e(this,"page",(t,e)=>{const n=this.context.getPayload().page;this.processEvent({event:t||n.title||"Unknown Page",properties:{path:n.path,referrer:n.referrer,title:n.title,...e},standardEvent:"PAGE_VIEW",intent:"navigation",confidence:1})}),e(this,"track",(t,e,n)=>{this.processEvent({event:t,properties:e||{},...n})}),e(this,"trackRevenue",(t,e,n)=>{const i=Math.max(0,(t=>{if("number"==typeof t)return Number.isFinite(t)?t:0;const e=t.trim().replace(/[^0-9.+-]/g,""),n=Number(e);return Number.isFinite(n)?n:0})(t)),s=m(null==e?void 0:e.currency)||m(null==e?void 0:e.currencyCode)||m(null==e?void 0:e.currencySymbol)||("string"==typeof t?m(t):void 0)||"USD";this.track("PURCHASE",{...e||{},value:i,amount:i,valuePaise:Math.round(100*i),amountPaise:Math.round(100*i),currency:s,currencyCode:s},{standardEvent:"PURCHASE",intent:"commerce",confidence:1,...n})}),this.config=t,this.transport=new p((t=>{if(!t)return w;try{const e=new URL(t);return e.hostname.endsWith("bluenath.com")||y.has(e.hostname)?(e.pathname="/api/v1/tracking/ingest",e.search="",e.hash="",e.toString()):w}catch{return w}})(t.apiHost)),this.context=new l({persistence:t.tracking.useCookies?"cookie":"local"}),this.queue=new f(this.transport)}parseRef(t){if(!t)return{};const e=t.match(/^camp_([^_]+)_cr_([^_]+)$/);return e?{campaignId:e[1],creatorId:e[2]}:{}}processEvent(t){const e=this.context.getPayload(),n=t.properties.ref,i=("string"==typeof n?n:void 0)||new URLSearchParams(e.page.search||"").get("ref")||void 0,s=this.parseRef(i),r=t.properties.value??t.properties.amount??t.properties.valuePaise??t.properties.amountPaise,o=Number(r),a=t.properties.campaignId,c=t.properties.creatorId,h=t.properties.currency,u={event:t.event,properties:t.properties,standardEvent:t.standardEvent,intent:t.intent,confidence:t.confidence,rawLabel:t.rawLabel,timestamp:(new Date).toISOString(),messageId:d(),writeKey:this.config.writeKey,ref:i,campaignId:("string"==typeof a?a:void 0)||s.campaignId,creatorId:("string"==typeof c?c:void 0)||s.creatorId,value:Number.isFinite(o)?Math.round(o):void 0,valuePaise:Number.isFinite(o)?Math.round(100*o):void 0,currency:("string"==typeof h?h:void 0)||"USD",userId:e.user.id||void 0,anonymousId:e.user.anonymousId,context:e};this.config.debug,this.queue.enqueue(u)}}class b{constructor(t){e(this,"analytics"),e(this,"metrics",{}),this.analytics=t,"undefined"!=typeof window&&"PerformanceObserver"in window&&this.observe()}observe(){try{new PerformanceObserver(t=>{for(const e of t.getEntries()){const t=e;t.hadRecentInput||(this.metrics.cls=(this.metrics.cls||0)+t.value)}}).observe({type:"layout-shift",buffered:!0}),new PerformanceObserver(t=>{const e=t.getEntries(),n=e[e.length-1];this.metrics.lcp=n.renderTime||n.loadTime,this.logMetric("LCP",this.metrics.lcp)}).observe({type:"largest-contentful-paint",buffered:!0}),new PerformanceObserver(t=>{const e=t.getEntries()[0];e&&(this.metrics.fid=e.processingStart-e.startTime,this.logMetric("FID",this.metrics.fid))}).observe({type:"first-input",buffered:!0}),window.addEventListener("visibilitychange",()=>{"hidden"===document.visibilityState&&this.metrics.cls&&this.logMetric("CLS",this.metrics.cls)})}catch(t){}}logMetric(t,e){e<0||this.analytics.track(`Core Web Vital: ${t}`,{metric:t,value:Math.round(e)},{standardEvent:"PERFORMANCE",intent:"performance",confidence:1,rawLabel:`${t}: ${Math.round(e)}ms`})}}const E=i.createContext(null);let R=null;exports.EngageProProvider=({children:t,...e})=>{const s=i.useRef(null),r=i.useRef(null);s.current||(s.current=new g(e),"undefined"!=typeof window&&new b(s.current));const o=s.current;return i.useEffect(()=>{if(!e.tracking.autoTrack)return;const t=t=>{const e=t.target.closest('button, a, input[type="submit"], [data-track], .clickable');if(e){const t=Date.now(),n=r.current;n&&n.el===e&&t-n.ts<500?(n.count++,n.ts=t,3===n.count&&(o.track("Rage Click detected",{element:e.tagName},{standardEvent:"RAGE_CLICK",intent:"frustration",confidence:1}),r.current=null)):r.current={el:e,count:1,ts:t};const i=(t=>{let e=(t.innerText||t.value||t.getAttribute("aria-label")||"").trim();if(!e){const n=t.querySelector("img");n&&n.alt&&(e=n.alt);const i=t.querySelector("title");i&&(e=i.textContent||"")}const n=e.slice(0,100),i=n.toLowerCase(),s=(t.id||"").toLowerCase(),r=t.href||"";return/add to (cart|bag)|buy now/.test(i)||s.includes("add-to-cart")?{standard:"ADD_TO_CART",intent:"commerce",label:n,confidence:.9}:/checkout|proceed/.test(i)||r.includes("/checkout")?{standard:"INITIATE_CHECKOUT",intent:"commerce",label:n,confidence:.9}:/place order|pay now/.test(i)||s.includes("place-order")?{standard:"PURCHASE",intent:"commerce",label:n,confidence:.95}:/cancel order/.test(i)||s.includes("cancel")?{standard:"ORDER_CANCEL",intent:"lifecycle",label:n,confidence:.85}:/refund|return/.test(i)||s.includes("refund")?{standard:"ORDER_REFUND",intent:"lifecycle",label:n,confidence:.85}:/track package|shipping/.test(i)?{standard:"TRACK_PACKAGE",intent:"lifecycle",label:n,confidence:.8}:/write review/.test(i)||i.includes("star")&&/^[1-5]/.test(i)?{standard:"RATE_PRODUCT",intent:"engagement",label:n,confidence:.8}:i.includes("search")||s.includes("search")?{standard:"SEARCH",intent:"search",label:n,confidence:.7}:{standard:"GENERIC",intent:"interaction",label:n,confidence:.5}})(e),s="A"===e.tagName;o.track("Interaction",{element:e.tagName.toLowerCase(),id:e.id,destination:s?e.href:void 0},{standardEvent:i.standard,intent:i.intent,rawLabel:i.label,confidence:i.confidence})}},n=t=>{const e=t.target;(t=>"password"===t.getAttribute("type")||"hidden"===t.getAttribute("type")||/password|cvc|card|cc-num|ssn|credit|hidden/i.test(t.getAttribute("name")||t.id||""))(e)||"focusin"!==t.type||e.dataset.tracked||(e.dataset.tracked="true",o.track("Form Start",{field:e.name||e.id},{standardEvent:"FORM_START",intent:"identity"}))},i=()=>{const t=new URLSearchParams(window.location.search);t.has("q")&&o.track("Search Query",{query:t.get("q")},{standardEvent:"SEARCH",intent:"search"}),requestAnimationFrame(()=>o.page())},s=history.pushState;return history.pushState=(...t)=>{s.apply(history,t),i()},window.addEventListener("popstate",i),window.addEventListener("click",t,!0),window.addEventListener("focusin",n,!0),i(),()=>{history.pushState=s,window.removeEventListener("popstate",i),window.removeEventListener("click",t,!0),window.removeEventListener("focusin",n,!0)}},[e.tracking.autoTrack]),n.jsx(E.Provider,{value:o,children:t})},exports.default=g,exports.init=t=>(R||(R=new g(t)),R),exports.useAnalytics=()=>{const t=i.useContext(E);if(!t)throw new Error("useAnalytics must be used within EngageProProvider");return t};
+"use strict";var e=Object.defineProperty,i=(i,t,a)=>((i,t,a)=>t in i?e(i,t,{enumerable:!0,configurable:!0,writable:!0,value:a}):i[t]=a)(i,"symbol"!=typeof t?t+"":t,a);Object.defineProperties(exports,{i:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const t=require("react/jsx-runtime"),a=require("react");let n;const r=new Uint8Array(16);function s(){if(!n&&(n="undefined"!=typeof crypto&&crypto.getRandomValues&&crypto.getRandomValues.bind(crypto),!n))throw new Error("crypto.getRandomValues() not supported. See https://github.com/uuidjs/uuid#getrandomvalues-not-supported");return n(r)}const o=[];for(let _=0;_<256;++_)o.push((_+256).toString(16).slice(1));const c={randomUUID:"undefined"!=typeof crypto&&crypto.randomUUID&&crypto.randomUUID.bind(crypto)};function u(e,i,t){if(c.randomUUID&&!e)return c.randomUUID();const a=(e=e||{}).random||(e.rng||s)();return a[6]=15&a[6]|64,a[8]=63&a[8]|128,function(e,i=0){return o[e[i+0]]+o[e[i+1]]+o[e[i+2]]+o[e[i+3]]+"-"+o[e[i+4]]+o[e[i+5]]+"-"+o[e[i+6]]+o[e[i+7]]+"-"+o[e[i+8]]+o[e[i+9]]+"-"+o[e[i+10]]+o[e[i+11]]+o[e[i+12]]+o[e[i+13]]+o[e[i+14]]+o[e[i+15]]}(a)}const d=e=>{let i=2166136261;const t=e.length;for(let a=0;a<t;a++)i^=e.charCodeAt(a),i+=(i<<1)+(i<<4)+(i<<7)+(i<<8)+(i<<24);return("0000000"+(i>>>0).toString(16)).substr(-8)};class h{constructor(e="local"){i(this,"memoryStore",{}),i(this,"keyPrefix","engage_"),i(this,"domain"),this.type=e,this.domain=this.getCookieDomain()}getItem(e){const i=this.keyPrefix+e;if(this.memoryStore.hasOwnProperty(i))return this.memoryStore[i];try{if("local"===this.type&&this.isBrowser())return window.localStorage.getItem(i);if("cookie"===this.type&&this.isBrowser())return this.getCookie(i)}catch(t){return null}return null}setItem(e,i){const t=this.keyPrefix+e;this.memoryStore[t]=i;try{"local"===this.type&&this.isBrowser()?window.localStorage.setItem(t,i):"cookie"===this.type&&this.isBrowser()&&this.setCookie(t,i,365)}catch(a){this.isQuotaError(a)&&(this.type="memory")}}removeItem(e){const i=this.keyPrefix+e;delete this.memoryStore[i];try{"local"===this.type&&this.isBrowser()?window.localStorage.removeItem(i):"cookie"===this.type&&this.isBrowser()&&this.setCookie(i,"",-1)}catch(t){}}getCookie(e){const i=e+"=",t=document.cookie.split(";");for(let a=0;a<t.length;a++){let e=t[a];for(;" "===e.charAt(0);)e=e.substring(1,e.length);if(0===e.indexOf(i))return decodeURIComponent(e.substring(i.length,e.length))}return null}setCookie(e,i,t){let a="";if(t){const e=new Date;e.setTime(e.getTime()+24*t*60*60*1e3),a="; expires="+e.toUTCString()}document.cookie=`${e}=${encodeURIComponent(i)}${a}; path=/; domain=${this.domain}; SameSite=Lax; Secure`}getCookieDomain(){if(!this.isBrowser())return"";const e=window.location.hostname,i=e.split(".");return 1===i.length||"localhost"===e?"":i.length>2?"."+i.slice(-2).join("."):"."+e}isBrowser(){try{return"undefined"!=typeof window&&void 0!==window.document}catch(e){return!1}}isQuotaError(e){return e instanceof DOMException&&(22===e.code||1014===e.code||"QuotaExceededError"===e.name||"NS_ERROR_DOM_QUOTA_REACHED"===e.name)}}class l{constructor(e){i(this,"storage"),i(this,"SESSION_TIMEOUT",18e5),i(this,"deviceId"),i(this,"sessionId"),i(this,"userId",null),i(this,"currentUrl"),i(this,"referrer"),this.storage=new h(e.persistence),this.deviceId=this.getOrSetDeviceId(),this.sessionId="",this.manageSession(),"undefined"!=typeof window?(this.currentUrl=window.location.href,this.referrer=document.referrer,this.listenToHistory()):(this.currentUrl="",this.referrer="")}getOrSetDeviceId(){const e=this.storage.getItem("device_id");if(e)return e;const i=(()=>{if("undefined"==typeof window)return"server-side-id";const e=navigator,i=window.screen,t={userAgent:e.userAgent||"",screenRes:`${i.width}x${i.height}`,colorDepth:i.colorDepth||0,timezone:(new Date).getTimezoneOffset(),language:e.language||"en-US",platform:e.platform||"unknown",hardwareConcurrency:e.hardwareConcurrency||1,deviceMemory:e.deviceMemory||0},a=[t.platform,t.language,t.screenRes,t.colorDepth,t.timezone,t.hardwareConcurrency,t.deviceMemory].join("|");return`${d(a)}-${d(t.userAgent)}`})();return this.storage.setItem("device_id",i),i}manageSession(){const e=Date.now(),i=this.storage.getItem("session_id"),t=parseInt(this.storage.getItem("last_activity")||"0");if(!i||e-t>this.SESSION_TIMEOUT?(this.sessionId=`sess_${e}_${Math.random().toString(36).substr(2,9)}`,this.storage.setItem("session_id",this.sessionId)):this.sessionId=i,this.storage.setItem("last_activity",e.toString()),"undefined"!=typeof window){const e=()=>this.storage.setItem("last_activity",Date.now().toString());window.addEventListener("click",e),window.addEventListener("scroll",e)}}listenToHistory(){const e=history.pushState;history.pushState=(...i)=>{e.apply(history,i),this.handleUrlChange()},window.addEventListener("popstate",()=>this.handleUrlChange())}handleUrlChange(){const e=window.location.href;e!==this.currentUrl&&(this.referrer=this.currentUrl,this.currentUrl=e)}getPayload(){var e;return{library:{name:"@engagepro/analytics",version:"2.0.0"},user:{anonymousId:this.deviceId,id:this.userId},session:{id:this.sessionId,startTime:parseInt(this.sessionId.split("_")[1]||Date.now().toString())},page:{path:"undefined"!=typeof window?window.location.pathname:"",referrer:this.referrer,title:"undefined"!=typeof document?document.title:"",search:"undefined"!=typeof window?window.location.search:"",url:this.currentUrl},network:{online:"undefined"==typeof navigator||navigator.onLine,downlink:null==(e=navigator.connection)?void 0:e.downlink},screen:{width:"undefined"!=typeof screen?screen.width:0,height:"undefined"!=typeof screen?screen.height:0,density:"undefined"!=typeof window?window.devicePixelRatio:1},device:{fingerprint:this.deviceId,type:this.getDeviceType(),userAgent:"undefined"!=typeof navigator?navigator.userAgent:"server"},locale:"undefined"!=typeof navigator?navigator.language:"en-US",timezone:Intl.DateTimeFormat().resolvedOptions().timeZone}}getDeviceType(){if("undefined"==typeof navigator)return"desktop";const e=navigator.userAgent;return/(tablet|ipad|playbook|silk)|(android(?!.*mobi))/i.test(e)?"tablet":/Mobile|Android|iP(hone|od)|IEMobile|BlackBerry|Kindle|Silk-Accelerated/.test(e)?"mobile":"desktop"}}class A{constructor(e){i(this,"queue",[]),i(this,"engageQueue",[]),i(this,"storage"),i(this,"transport"),i(this,"STORAGE_KEY","engage_queue_v1"),i(this,"ENGAGE_STORAGE_KEY","engage_events_v2"),i(this,"isFlushing",!1),i(this,"flushInterval"),i(this,"retryCount",0),i(this,"MAX_RETRIES",3),this.transport=e,this.storage=new h("local"),this.load(),"undefined"!=typeof window&&(window.addEventListener("online",()=>{this.retryCount=0,this.flush()}),window.addEventListener("visibilitychange",()=>{"hidden"===document.visibilityState&&this.flushBeacon()}),window.addEventListener("beforeunload",()=>{this.flushBeacon()})),this.startTimer()}startTimer(){this.flushInterval&&clearInterval(this.flushInterval),this.flushInterval=setInterval(()=>{this.flush()},5e3)}enqueue(e){this.queue.push(e),this.save(),(this.queue.length>=10||"PURCHASE"===e.standardEvent)&&this.flush()}enqueueEngageEvent(e){this.engageQueue.push(e),this.saveEngage(),this.engageQueue.length>=10&&this.flushEngageEvents()}save(){this.storage.setItem(this.STORAGE_KEY,JSON.stringify(this.queue))}saveEngage(){this.storage.setItem(this.ENGAGE_STORAGE_KEY,JSON.stringify(this.engageQueue))}load(){const e=this.storage.getItem(this.STORAGE_KEY);if(e)try{this.queue=JSON.parse(e)}catch(t){this.queue=[]}const i=this.storage.getItem(this.ENGAGE_STORAGE_KEY);if(i)try{this.engageQueue=JSON.parse(i)}catch(t){this.engageQueue=[]}}async flush(){if(0===this.queue.length||this.isFlushing)return void(this.engageQueue.length>0&&!this.isFlushing&&await this.flushEngageEvents());if("undefined"!=typeof navigator&&!navigator.onLine)return;this.isFlushing=!0;const e=[...this.queue];this.queue=[],this.save();try{if(!(await this.transport.send(e)))throw new Error("Server rejected batch");this.retryCount=0}catch(i){this.queue=[...e,...this.queue],this.save(),this.retryCount++}finally{this.isFlushing=!1}this.engageQueue.length>0&&await this.flushEngageEvents()}async flushEngageEvents(){if(0===this.engageQueue.length||this.isFlushing)return;if("undefined"!=typeof navigator&&!navigator.onLine)return;this.isFlushing=!0;const e=[...this.engageQueue];this.engageQueue=[],this.saveEngage();let i=0,t=!1;for(;i<this.MAX_RETRIES&&!t;){const a=await this.transport.sendEngageEvents(e);if(a.success){t=!0;break}if(a.permanent)return void(this.isFlushing=!1);if(i++,i<this.MAX_RETRIES){const e=1e3*Math.pow(2,i-1);await new Promise(i=>setTimeout(i,e))}}this.isFlushing=!1}flushBeacon(){if(this.queue.length>0){const e=JSON.stringify({batch:this.queue,sentAt:(new Date).toISOString()});this.transport.beaconFlush(e)&&(this.queue=[],this.save())}if(this.engageQueue.length>0){const e=JSON.stringify({events:this.engageQueue});this.transport.beaconFlush(e)&&(this.engageQueue=[],this.saveEngage())}}}class f{constructor(e){i(this,"apiKey",""),this.apiEndpoint=e}setApiKey(e){this.apiKey=e}async send(e){return(await this.sendRaw(JSON.stringify({batch:e,sentAt:(new Date).toISOString()}))).success}async sendEngageEvents(e){const i=JSON.stringify({events:e});return this.sendRaw(i)}async sendRaw(e){const i={"Content-Type":"application/json"};if(this.apiKey&&(i.Authorization=`Bearer ${this.apiKey}`),!this.apiKey&&"undefined"!=typeof navigator&&navigator.sendBeacon&&e.length<6e4){const i=new Blob([e],{type:"application/json"});if(navigator.sendBeacon(this.apiEndpoint,i))return{success:!0,permanent:!1}}try{const t=await fetch(this.apiEndpoint,{method:"POST",headers:i,body:e,keepalive:!0});return 401===t.status||422===t.status?{success:!1,permanent:!0,status:t.status}:{success:t.ok||202===t.status,permanent:!1,status:t.status}}catch(t){return{success:!1,permanent:!1}}}beaconFlush(e){if("undefined"==typeof navigator||!navigator.sendBeacon)return!1;const i=new Blob([e],{type:"application/json"});return navigator.sendBeacon(this.apiEndpoint,i)}}const p={"Asia/Kolkata":"IN","Asia/Calcutta":"IN","Asia/Mumbai":"IN","Asia/Dhaka":"BD","Asia/Kathmandu":"NP","Asia/Colombo":"LK","Asia/Karachi":"PK","Asia/Kabul":"AF","Asia/Tehran":"IR","Asia/Dubai":"AE","Asia/Muscat":"OM","Asia/Bahrain":"BH","Asia/Qatar":"QA","Asia/Kuwait":"KW","Asia/Riyadh":"SA","Asia/Aden":"YE","Asia/Baghdad":"IQ","Asia/Amman":"JO","Asia/Beirut":"LB","Asia/Damascus":"SY","Asia/Jerusalem":"IL","Asia/Tel_Aviv":"IL","Asia/Nicosia":"CY","Asia/Tokyo":"JP","Asia/Seoul":"KR","Asia/Pyongyang":"KP","Asia/Shanghai":"CN","Asia/Chongqing":"CN","Asia/Harbin":"CN","Asia/Urumqi":"CN","Asia/Hong_Kong":"HK","Asia/Macau":"MO","Asia/Taipei":"TW","Asia/Singapore":"SG","Asia/Kuala_Lumpur":"MY","Asia/Brunei":"BN","Asia/Jakarta":"ID","Asia/Makassar":"ID","Asia/Jayapura":"ID","Asia/Bangkok":"TH","Asia/Ho_Chi_Minh":"VN","Asia/Saigon":"VN","Asia/Phnom_Penh":"KH","Asia/Vientiane":"LA","Asia/Yangon":"MM","Asia/Rangoon":"MM","Asia/Manila":"PH","Asia/Ulaanbaatar":"MN","Asia/Hovd":"MN","Asia/Tbilisi":"GE","Asia/Baku":"AZ","Asia/Yerevan":"AM","Asia/Almaty":"KZ","Asia/Bishkek":"KG","Asia/Tashkent":"UZ","Asia/Ashgabat":"TM","Asia/Dushanbe":"TJ","Asia/Thimphu":"BT","Asia/Dili":"TL","Europe/London":"GB","Europe/Dublin":"IE","Europe/Lisbon":"PT","Europe/Madrid":"ES","Europe/Paris":"FR","Europe/Brussels":"BE","Europe/Amsterdam":"NL","Europe/Luxembourg":"LU","Europe/Berlin":"DE","Europe/Zurich":"CH","Europe/Vienna":"AT","Europe/Rome":"IT","Europe/Monaco":"MC","Europe/Vatican":"VA","Europe/Malta":"MT","Europe/Prague":"CZ","Europe/Budapest":"HU","Europe/Warsaw":"PL","Europe/Bratislava":"SK","Europe/Ljubljana":"SI","Europe/Zagreb":"HR","Europe/Belgrade":"RS","Europe/Sarajevo":"BA","Europe/Podgorica":"ME","Europe/Skopje":"MK","Europe/Tirane":"AL","Europe/Sofia":"BG","Europe/Bucharest":"RO","Europe/Chisinau":"MD","Europe/Athens":"GR","Europe/Istanbul":"TR","Europe/Helsinki":"FI","Europe/Stockholm":"SE","Europe/Oslo":"NO","Europe/Copenhagen":"DK","Europe/Tallinn":"EE","Europe/Riga":"LV","Europe/Vilnius":"LT","Europe/Minsk":"BY","Europe/Moscow":"RU","Europe/Kaliningrad":"RU","Europe/Samara":"RU","Europe/Kiev":"UA","Europe/Kyiv":"UA","Europe/Reykjavik":"IS","Europe/Andorra":"AD","Europe/Gibraltar":"GI","Europe/San_Marino":"SM","America/New_York":"US","America/Chicago":"US","America/Denver":"US","America/Los_Angeles":"US","America/Phoenix":"US","America/Anchorage":"US","Pacific/Honolulu":"US","America/Detroit":"US","America/Indianapolis":"US","America/Boise":"US","America/Juneau":"US","America/Adak":"US","America/Toronto":"CA","America/Vancouver":"CA","America/Montreal":"CA","America/Winnipeg":"CA","America/Edmonton":"CA","America/Halifax":"CA","America/St_Johns":"CA","America/Regina":"CA","America/Mexico_City":"MX","America/Cancun":"MX","America/Tijuana":"MX","America/Monterrey":"MX","America/Hermosillo":"MX","America/Guatemala":"GT","America/Belize":"BZ","America/El_Salvador":"SV","America/Tegucigalpa":"HN","America/Managua":"NI","America/Costa_Rica":"CR","America/Panama":"PA","America/Bogota":"CO","America/Lima":"PE","America/Guayaquil":"EC","America/Caracas":"VE","America/La_Paz":"BO","America/Asuncion":"PY","America/Montevideo":"UY","America/Buenos_Aires":"AR","America/Argentina/Buenos_Aires":"AR","America/Santiago":"CL","America/Sao_Paulo":"BR","America/Recife":"BR","America/Manaus":"BR","America/Fortaleza":"BR","America/Bahia":"BR","America/Havana":"CU","America/Jamaica":"JM","America/Port-au-Prince":"HT","America/Santo_Domingo":"DO","America/Puerto_Rico":"PR","America/Port_of_Spain":"TT","America/Barbados":"BB","America/Martinique":"MQ","America/Guyana":"GY","America/Paramaribo":"SR","America/Cayenne":"GF","America/Curacao":"CW","Africa/Cairo":"EG","Africa/Casablanca":"MA","Africa/Tunis":"TN","Africa/Algiers":"DZ","Africa/Tripoli":"LY","Africa/Khartoum":"SD","Africa/Addis_Ababa":"ET","Africa/Nairobi":"KE","Africa/Dar_es_Salaam":"TZ","Africa/Kampala":"UG","Africa/Mogadishu":"SO","Africa/Lagos":"NG","Africa/Accra":"GH","Africa/Abidjan":"CI","Africa/Dakar":"SN","Africa/Bamako":"ML","Africa/Ouagadougou":"BF","Africa/Conakry":"GN","Africa/Freetown":"SL","Africa/Monrovia":"LR","Africa/Lome":"TG","Africa/Porto-Novo":"BJ","Africa/Niamey":"NE","Africa/Douala":"CM","Africa/Libreville":"GA","Africa/Bangui":"CF","Africa/Brazzaville":"CG","Africa/Kinshasa":"CD","Africa/Lubumbashi":"CD","Africa/Luanda":"AO","Africa/Maputo":"MZ","Africa/Harare":"ZW","Africa/Lusaka":"ZM","Africa/Lilongwe":"MW","Africa/Johannesburg":"ZA","Africa/Windhoek":"NA","Africa/Gaborone":"BW","Africa/Maseru":"LS","Africa/Mbabane":"SZ","Indian/Antananarivo":"MG","Indian/Mauritius":"MU","Indian/Reunion":"RE","Indian/Comoro":"KM","Indian/Mayotte":"YT","Africa/Djibouti":"DJ","Africa/Asmara":"ER","Australia/Sydney":"AU","Australia/Melbourne":"AU","Australia/Brisbane":"AU","Australia/Perth":"AU","Australia/Adelaide":"AU","Australia/Hobart":"AU","Australia/Darwin":"AU","Australia/Lord_Howe":"AU","Pacific/Auckland":"NZ","Pacific/Chatham":"NZ","Pacific/Fiji":"FJ","Pacific/Tongatapu":"TO","Pacific/Apia":"WS","Pacific/Port_Moresby":"PG","Pacific/Noumea":"NC","Pacific/Guam":"GU","Pacific/Pago_Pago":"AS","Pacific/Tahiti":"PF","Atlantic/Reykjavik":"IS","Atlantic/Azores":"PT","Atlantic/Canary":"ES","Atlantic/Madeira":"PT","Atlantic/Cape_Verde":"CV","Atlantic/Bermuda":"BM","Indian/Maldives":"MV","Indian/Chagos":"IO","Indian/Christmas":"CX","Indian/Cocos":"CC"},m=new Set(["localhost","127.0.0.1"]),g="engage_session_id",y={$:"USD",US$:"USD",USD:"USD","₹":"INR",RS:"INR","RS.":"INR",INR:"INR","€":"EUR",EUR:"EUR","£":"GBP",GBP:"GBP","¥":"JPY",JPY:"JPY"},v=e=>{if("string"!=typeof e)return;const i=e.trim().toUpperCase();return i?y[i]?y[i]:i.includes("₹")||i.startsWith("RS")?"INR":i.includes("$")&&!i.includes("CAD")?"USD":i.includes("€")?"EUR":i.includes("£")?"GBP":i.includes("¥")?"JPY":/^[A-Z]{3}$/.test(i)?i:void 0:void 0};function w(e){if(!e||"object"!=typeof e)return;const i={},t=Object.keys(e).slice(0,20);for(const a of t){const t=e[a];"boolean"==typeof t||"number"==typeof t?i[a]=t:"string"==typeof t&&(i[a]=t.slice(0,100))}return Object.keys(i).length>0?i:void 0}class E{constructor(e){i(this,"config"),i(this,"context"),i(this,"queue"),i(this,"transport"),i(this,"sessionId"),i(this,"countryCode"),i(this,"currentSentiment"),i(this,"identify",(e,i)=>{this.context.userId=e,this.processEvent({event:"Identify",properties:{traits:i},standardEvent:"LOGIN",intent:"identity",confidence:1})}),i(this,"page",(e,i)=>{const t=this.context.getPayload().page;this.processEvent({event:e||t.title||"Unknown Page",properties:{path:t.path,referrer:t.referrer,title:t.title,...i},standardEvent:"PAGE_VIEW",intent:"navigation",confidence:1}),this.emitEngageEvent("pageview",i)}),i(this,"track",(e,i,t)=>{this.processEvent({event:e,properties:i||{},...t});const a={purchase:"purchase",PURCHASE:"purchase",signup:"signup",SIGNUP:"signup",register:"signup",REGISTER:"signup",add_to_cart:"add_to_cart",ADD_TO_CART:"add_to_cart",product_view:"product_view",VIEW_CONTENT:"product_view",session_start:"session_start",session_end:"session_end"},n=a[e]||a[(null==t?void 0:t.standardEvent)||""]||"custom";this.emitEngageEvent(n,i)}),i(this,"trackRevenue",(e,i,t)=>{const a=Math.max(0,(e=>{if("number"==typeof e)return Number.isFinite(e)?e:0;const i=e.trim().replace(/[^0-9.+-]/g,""),t=Number(i);return Number.isFinite(t)?t:0})(e)),n=v(null==i?void 0:i.currency)||v(null==i?void 0:i.currencyCode)||v(null==i?void 0:i.currencySymbol)||("string"==typeof e?v(e):void 0)||"USD";this.track("PURCHASE",{...i||{},value:a,amount:a,valuePaise:Math.round(100*a),amountPaise:Math.round(100*a),currency:n,currencyCode:n},{standardEvent:"PURCHASE",intent:"commerce",confidence:1,...t})}),i(this,"setSentiment",e=>{this.currentSentiment=e}),this.config=e;const t=e.apiKey||e.writeKey,a=((e,i,t)=>{if(!e)return t;try{const i=new URL(e);return i.hostname.endsWith("bluenath.com")||m.has(i.hostname)?(i.pathname="/api/v1/tracking/ingest",i.search="",i.hash="",i.toString()):t}catch{return t}})(e.apiHost,0,"https://engage-api.bluenath.com/api/v1/tracking/ingest");this.transport=new f(a),this.transport.setApiKey(t),this.context=new l({persistence:e.tracking.useCookies?"cookie":"local"}),this.queue=new A(this.transport),this.sessionId=function(){if("undefined"==typeof sessionStorage)return u();let e=sessionStorage.getItem(g);return e||(e=u(),sessionStorage.setItem(g,e)),e}(),this.countryCode=function(){try{const e=Intl.DateTimeFormat().resolvedOptions().timeZone;if(!e)return;return p[e]}catch{return}}(),e.tracking.autoTrack&&"undefined"!=typeof window&&this.page()}emitEngageEvent(e,i){const t=this.context.getPayload().page,a={type:e,timestamp:(new Date).toISOString(),sessionId:this.sessionId,userId:this.context.getPayload().user.id||void 0,countryCode:this.countryCode,sentiment:this.currentSentiment,referrer:(t.referrer||"").slice(0,500),path:t.path||("undefined"!=typeof window?window.location.pathname:"/"),currency:v(null==i?void 0:i.currency)||v(null==i?void 0:i.currencyCode)||void 0,amount:"number"==typeof(null==i?void 0:i.amountPaise)?i.amountPaise:"number"==typeof(null==i?void 0:i.amount)?Math.round(100*i.amount):void 0,productId:"string"==typeof(null==i?void 0:i.productId)?i.productId:void 0,productName:"string"==typeof(null==i?void 0:i.productName)?i.productName:void 0,productCategory:"string"==typeof(null==i?void 0:i.productCategory)?i.productCategory:void 0,metadata:w(null==i?void 0:i.metadata)};this.queue.enqueueEngageEvent(a),this.currentSentiment&&(this.currentSentiment=void 0)}parseRef(e){if(!e)return{};const i=e.match(/^camp_([^_]+)_cr_([^_]+)$/);return i?{campaignId:i[1],creatorId:i[2]}:{}}processEvent(e){const i=this.context.getPayload(),t=e.properties.ref,a=("string"==typeof t?t:void 0)||new URLSearchParams(i.page.search||"").get("ref")||void 0,n=this.parseRef(a),r=e.properties.value??e.properties.amount??e.properties.valuePaise??e.properties.amountPaise,s=Number(r),o=e.properties.campaignId,c=e.properties.creatorId,d=e.properties.currency,h={event:e.event,properties:e.properties,standardEvent:e.standardEvent,intent:e.intent,confidence:e.confidence,rawLabel:e.rawLabel,timestamp:(new Date).toISOString(),messageId:u(),writeKey:this.config.writeKey||this.config.apiKey||"",ref:a,campaignId:("string"==typeof o?o:void 0)||n.campaignId,creatorId:("string"==typeof c?c:void 0)||n.creatorId,value:Number.isFinite(s)?Math.round(s):void 0,valuePaise:Number.isFinite(s)?Math.round(100*s):void 0,currency:("string"==typeof d?d:void 0)||"USD",userId:i.user.id||void 0,anonymousId:i.user.anonymousId,context:i};this.config.debug,this.queue.enqueue(h)}}class S{constructor(e){i(this,"analytics"),i(this,"metrics",{}),this.analytics=e,"undefined"!=typeof window&&"PerformanceObserver"in window&&this.observe()}observe(){try{new PerformanceObserver(e=>{for(const i of e.getEntries()){const e=i;e.hadRecentInput||(this.metrics.cls=(this.metrics.cls||0)+e.value)}}).observe({type:"layout-shift",buffered:!0}),new PerformanceObserver(e=>{const i=e.getEntries(),t=i[i.length-1];this.metrics.lcp=t.renderTime||t.loadTime,this.logMetric("LCP",this.metrics.lcp)}).observe({type:"largest-contentful-paint",buffered:!0}),new PerformanceObserver(e=>{const i=e.getEntries()[0];i&&(this.metrics.fid=i.processingStart-i.startTime,this.logMetric("FID",this.metrics.fid))}).observe({type:"first-input",buffered:!0}),window.addEventListener("visibilitychange",()=>{"hidden"===document.visibilityState&&this.metrics.cls&&this.logMetric("CLS",this.metrics.cls)})}catch(e){}}logMetric(e,i){i<0||this.analytics.track(`Core Web Vital: ${e}`,{metric:e,value:Math.round(i)},{standardEvent:"PERFORMANCE",intent:"performance",confidence:1,rawLabel:`${e}: ${Math.round(i)}ms`})}}const b=a.createContext(null);let C=null;const R=e=>{if(!C){const i={...e,writeKey:e.writeKey||e.apiKey||"",apiKey:e.apiKey||e.writeKey||""};C=new E(i)}return C},M={init:e=>R({writeKey:e.apiKey,apiKey:e.apiKey,apiHost:e.apiHost,tracking:e.tracking||{useCookies:!0,fingerprint:!0,autoTrack:!0},debug:e.debug}),track(e,i){C&&C.track(e,i)},page(e,i){C&&C.page(e,i)},identify(e,i){C&&C.identify(e,i)},trackRevenue(e,i){C&&C.trackRevenue(e,i)},setSentiment(e){C&&C.setSentiment(e)}};exports.EngageProProvider=({children:e,...i})=>{const n=a.useRef(null),r=a.useRef(null);n.current||(n.current=new E(i),"undefined"!=typeof window&&new S(n.current));const s=n.current;return a.useEffect(()=>{if(!i.tracking.autoTrack)return;const e=e=>{const i=e.target.closest('button, a, input[type="submit"], [data-track], .clickable');if(i){const e=Date.now(),t=r.current;t&&t.el===i&&e-t.ts<500?(t.count++,t.ts=e,3===t.count&&(s.track("Rage Click detected",{element:i.tagName},{standardEvent:"RAGE_CLICK",intent:"frustration",confidence:1}),r.current=null)):r.current={el:i,count:1,ts:e};const a=(e=>{let i=(e.innerText||e.value||e.getAttribute("aria-label")||"").trim();if(!i){const t=e.querySelector("img");t&&t.alt&&(i=t.alt);const a=e.querySelector("title");a&&(i=a.textContent||"")}const t=i.slice(0,100),a=t.toLowerCase(),n=(e.id||"").toLowerCase(),r=e.href||"";return/add to (cart|bag)|buy now/.test(a)||n.includes("add-to-cart")?{standard:"ADD_TO_CART",intent:"commerce",label:t,confidence:.9}:/checkout|proceed/.test(a)||r.includes("/checkout")?{standard:"INITIATE_CHECKOUT",intent:"commerce",label:t,confidence:.9}:/place order|pay now/.test(a)||n.includes("place-order")?{standard:"PURCHASE",intent:"commerce",label:t,confidence:.95}:/cancel order/.test(a)||n.includes("cancel")?{standard:"ORDER_CANCEL",intent:"lifecycle",label:t,confidence:.85}:/refund|return/.test(a)||n.includes("refund")?{standard:"ORDER_REFUND",intent:"lifecycle",label:t,confidence:.85}:/track package|shipping/.test(a)?{standard:"TRACK_PACKAGE",intent:"lifecycle",label:t,confidence:.8}:/write review/.test(a)||a.includes("star")&&/^[1-5]/.test(a)?{standard:"RATE_PRODUCT",intent:"engagement",label:t,confidence:.8}:a.includes("search")||n.includes("search")?{standard:"SEARCH",intent:"search",label:t,confidence:.7}:{standard:"GENERIC",intent:"interaction",label:t,confidence:.5}})(i),n="A"===i.tagName;s.track("Interaction",{element:i.tagName.toLowerCase(),id:i.id,destination:n?i.href:void 0},{standardEvent:a.standard,intent:a.intent,rawLabel:a.label,confidence:a.confidence})}},t=e=>{const i=e.target;(e=>"password"===e.getAttribute("type")||"hidden"===e.getAttribute("type")||/password|cvc|card|cc-num|ssn|credit|hidden/i.test(e.getAttribute("name")||e.id||""))(i)||"focusin"!==e.type||i.dataset.tracked||(i.dataset.tracked="true",s.track("Form Start",{field:i.name||i.id},{standardEvent:"FORM_START",intent:"identity"}))},a=()=>{const e=new URLSearchParams(window.location.search);e.has("q")&&s.track("Search Query",{query:e.get("q")},{standardEvent:"SEARCH",intent:"search"}),requestAnimationFrame(()=>s.page())},n=history.pushState;return history.pushState=(...e)=>{n.apply(history,e),a()},window.addEventListener("popstate",a),window.addEventListener("click",e,!0),window.addEventListener("focusin",t,!0),a(),()=>{history.pushState=n,window.removeEventListener("popstate",a),window.removeEventListener("click",e,!0),window.removeEventListener("focusin",t,!0)}},[i.tracking.autoTrack]),t.jsx(b.Provider,{value:s,children:e})},exports.default=E,exports.engage=M,exports.init=R,exports.useAnalytics=()=>{const e=a.useContext(b);if(!e)throw new Error("useAnalytics must be used within EngageProProvider");return e};

package/dist/index.d.ts

@@ -5,3 +5,20 @@ export default EngagePro;
 export { EngageProProvider, useAnalytics } from './react/EngageProProvider';
 export * from './types';
 export declare const init: (config: EngageConfig) => EngagePro;
+/**
+ * Spec §3.5 — The `engage` singleton object for non-React apps.
+ * Brands integrate like:
+ *   import { engage } from '@bluenath/engage';
+ *   engage.init({ apiKey: 'ep_live_xxxxx' });
+ *   engage.track('purchase', { amount: 49900, currency: 'INR' });
+ */
+export declare const engage: {
+    init(config: Partial<EngageConfig> & {
+        apiKey: string;
+    }): EngagePro;
+    track(eventName: string, properties?: Record<string, unknown>): void;
+    page(name?: string, properties?: Record<string, unknown>): void;
+    identify(userId: string, traits?: Record<string, unknown>): void;
+    trackRevenue(amount: number | string, properties?: Record<string, unknown>): void;
+    setSentiment(sentiment: "positive" | "neutral" | "negative"): void;
+};

package/dist/index.js

@@ -299,14 +299,18 @@ class Context {
   }
 }
 class EventQueue {
+  // Spec §3.4
   constructor(transport) {
     __publicField(this, "queue", []);
+    __publicField(this, "engageQueue", []);
     __publicField(this, "storage");
     __publicField(this, "transport");
     __publicField(this, "STORAGE_KEY", "engage_queue_v1");
+    __publicField(this, "ENGAGE_STORAGE_KEY", "engage_events_v2");
     __publicField(this, "isFlushing", false);
     __publicField(this, "flushInterval");
     __publicField(this, "retryCount", 0);
+    __publicField(this, "MAX_RETRIES", 3);
     this.transport = transport;
     this.storage = new StorageEngine("local");
     this.load();
@@ -316,21 +320,23 @@ class EventQueue {
         this.flush();
       });
       window.addEventListener("visibilitychange", () => {
-        if (document.visibilityState === "hidden") this.flush();
+        if (document.visibilityState === "hidden") this.flushBeacon();
+      });
+      window.addEventListener("beforeunload", () => {
+        this.flushBeacon();
       });
     }
     this.startTimer();
   }
   startTimer() {
     if (this.flushInterval) clearInterval(this.flushInterval);
-    const delay = 3e3 * Math.pow(2, this.retryCount);
-    this.flushInterval = setInterval(
-      () => {
-        this.flush();
-      },
-      Math.min(delay, 3e4)
-    );
+    this.flushInterval = setInterval(() => {
+      this.flush();
+    }, 5e3);
   }
+  /**
+   * Enqueue a legacy AnalyticsEvent (backward compatibility)
+   */
   enqueue(event) {
     this.queue.push(event);
     this.save();
@@ -338,9 +344,25 @@ class EventQueue {
       this.flush();
     }
   }
+  /**
+   * Enqueue a new EngageEvent (Spec §3.1)
+   */
+  enqueueEngageEvent(event) {
+    this.engageQueue.push(event);
+    this.saveEngage();
+    if (this.engageQueue.length >= 10) {
+      this.flushEngageEvents();
+    }
+  }
   save() {
     this.storage.setItem(this.STORAGE_KEY, JSON.stringify(this.queue));
   }
+  saveEngage() {
+    this.storage.setItem(
+      this.ENGAGE_STORAGE_KEY,
+      JSON.stringify(this.engageQueue)
+    );
+  }
   load() {
     const data = this.storage.getItem(this.STORAGE_KEY);
     if (data) {
@@ -350,9 +372,25 @@ class EventQueue {
         this.queue = [];
       }
     }
+    const engageData = this.storage.getItem(this.ENGAGE_STORAGE_KEY);
+    if (engageData) {
+      try {
+        this.engageQueue = JSON.parse(engageData);
+      } catch (e) {
+        this.engageQueue = [];
+      }
+    }
   }
+  /**
+   * Flush legacy events (existing behavior)
+   */
   async flush() {
-    if (this.queue.length === 0 || this.isFlushing) return;
+    if (this.queue.length === 0 || this.isFlushing) {
+      if (this.engageQueue.length > 0 && !this.isFlushing) {
+        await this.flushEngageEvents();
+      }
+      return;
+    }
     if (typeof navigator !== "undefined" && !navigator.onLine) return;
     this.isFlushing = true;
     const batch = [...this.queue];
@@ -362,7 +400,6 @@ class EventQueue {
       const success = await this.transport.send(batch);
       if (success) {
         this.retryCount = 0;
-        this.startTimer();
       } else {
         throw new Error("Server rejected batch");
       }
@@ -370,45 +407,410 @@ class EventQueue {
       this.queue = [...batch, ...this.queue];
       this.save();
       this.retryCount++;
-      this.startTimer();
     } finally {
       this.isFlushing = false;
     }
+    if (this.engageQueue.length > 0) {
+      await this.flushEngageEvents();
+    }
+  }
+  /**
+   * Spec §3.4: Flush EngageEvent[] with exponential backoff retry.
+   * Max 3 retries with 1s/2s/4s backoff. Drop batch after 3 failures.
+   * Do not retry on 401/422 (permanent failures).
+   */
+  async flushEngageEvents() {
+    if (this.engageQueue.length === 0 || this.isFlushing) return;
+    if (typeof navigator !== "undefined" && !navigator.onLine) return;
+    this.isFlushing = true;
+    const batch = [...this.engageQueue];
+    this.engageQueue = [];
+    this.saveEngage();
+    let attempt = 0;
+    let success = false;
+    while (attempt < this.MAX_RETRIES && !success) {
+      const result = await this.transport.sendEngageEvents(batch);
+      if (result.success) {
+        success = true;
+        break;
+      }
+      if (result.permanent) {
+        console.warn(
+          `[EngagePro] Permanent failure (${result.status}). Dropping ${batch.length} events.`
+        );
+        this.isFlushing = false;
+        return;
+      }
+      attempt++;
+      if (attempt < this.MAX_RETRIES) {
+        const delay = Math.pow(2, attempt - 1) * 1e3;
+        await new Promise((resolve) => setTimeout(resolve, delay));
+      }
+    }
+    if (!success) {
+      console.warn(
+        `[EngagePro] Dropped ${batch.length} events after ${this.MAX_RETRIES} failed retries.`
+      );
+    }
+    this.isFlushing = false;
+  }
+  /**
+   * Spec §3.4: Use navigator.sendBeacon() to flush remaining events on page unload.
+   * This is a best-effort fire-and-forget — no retry possible.
+   */
+  flushBeacon() {
+    if (this.queue.length > 0) {
+      const payload = JSON.stringify({
+        batch: this.queue,
+        sentAt: (/* @__PURE__ */ new Date()).toISOString()
+      });
+      const sent = this.transport.beaconFlush(payload);
+      if (sent) {
+        this.queue = [];
+        this.save();
+      }
+    }
+    if (this.engageQueue.length > 0) {
+      const payload = JSON.stringify({ events: this.engageQueue });
+      const sent = this.transport.beaconFlush(payload);
+      if (sent) {
+        this.engageQueue = [];
+        this.saveEngage();
+      }
+    }
   }
 }
 class Transport {
   constructor(apiEndpoint) {
+    __publicField(this, "apiKey", "");
     this.apiEndpoint = apiEndpoint;
   }
+  setApiKey(key) {
+    this.apiKey = key;
+  }
+  /**
+   * Sends legacy batched events (existing format).
+   * Used by the old EventQueue for backward compatibility.
+   */
   async send(events) {
-    const payload = JSON.stringify({
-      batch: events,
-      sentAt: (/* @__PURE__ */ new Date()).toISOString()
-    });
-    if (typeof navigator !== "undefined" && navigator.sendBeacon && payload.length < 6e4) {
+    const result = await this.sendRaw(
+      JSON.stringify({ batch: events, sentAt: (/* @__PURE__ */ new Date()).toISOString() })
+    );
+    return result.success;
+  }
+  /**
+   * Sends new EngageEvent[] to the ingest endpoint (Spec §4.1).
+   * Returns detailed result for retry logic.
+   */
+  async sendEngageEvents(events) {
+    const payload = JSON.stringify({ events });
+    return this.sendRaw(payload);
+  }
+  async sendRaw(payload) {
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (this.apiKey) {
+      headers["Authorization"] = `Bearer ${this.apiKey}`;
+    }
+    if (!this.apiKey && typeof navigator !== "undefined" && navigator.sendBeacon && payload.length < 6e4) {
       const blob = new Blob([payload], { type: "application/json" });
       const success = navigator.sendBeacon(this.apiEndpoint, blob);
-      if (success) return true;
+      if (success) return { success: true, permanent: false };
     }
     try {
       const response = await fetch(this.apiEndpoint, {
         method: "POST",
-        headers: { "Content-Type": "application/json" },
+        headers,
         body: payload,
         keepalive: true
-        // Tries to keep request alive during navigation
       });
-      return response.ok;
+      if (response.status === 401 || response.status === 422) {
+        return { success: false, permanent: true, status: response.status };
+      }
+      return {
+        success: response.ok || response.status === 202,
+        permanent: false,
+        status: response.status
+      };
     } catch (e) {
       console.error("[EngagePro] Transport Failed:", e);
-      return false;
+      return { success: false, permanent: false };
     }
   }
+  /**
+   * Uses sendBeacon for last-resort page unload flush.
+   * Cannot send auth headers — the ingest endpoint must also accept
+   * the apiKey in the body payload as fallback.
+   */
+  beaconFlush(payload) {
+    if (typeof navigator === "undefined" || !navigator.sendBeacon) return false;
+    const blob = new Blob([payload], { type: "application/json" });
+    return navigator.sendBeacon(this.apiEndpoint, blob);
+  }
+}
+const TIMEZONE_TO_COUNTRY = {
+  // Asia
+  "Asia/Kolkata": "IN",
+  "Asia/Calcutta": "IN",
+  "Asia/Mumbai": "IN",
+  "Asia/Dhaka": "BD",
+  "Asia/Kathmandu": "NP",
+  "Asia/Colombo": "LK",
+  "Asia/Karachi": "PK",
+  "Asia/Kabul": "AF",
+  "Asia/Tehran": "IR",
+  "Asia/Dubai": "AE",
+  "Asia/Muscat": "OM",
+  "Asia/Bahrain": "BH",
+  "Asia/Qatar": "QA",
+  "Asia/Kuwait": "KW",
+  "Asia/Riyadh": "SA",
+  "Asia/Aden": "YE",
+  "Asia/Baghdad": "IQ",
+  "Asia/Amman": "JO",
+  "Asia/Beirut": "LB",
+  "Asia/Damascus": "SY",
+  "Asia/Jerusalem": "IL",
+  "Asia/Tel_Aviv": "IL",
+  "Asia/Nicosia": "CY",
+  "Asia/Tokyo": "JP",
+  "Asia/Seoul": "KR",
+  "Asia/Pyongyang": "KP",
+  "Asia/Shanghai": "CN",
+  "Asia/Chongqing": "CN",
+  "Asia/Harbin": "CN",
+  "Asia/Urumqi": "CN",
+  "Asia/Hong_Kong": "HK",
+  "Asia/Macau": "MO",
+  "Asia/Taipei": "TW",
+  "Asia/Singapore": "SG",
+  "Asia/Kuala_Lumpur": "MY",
+  "Asia/Brunei": "BN",
+  "Asia/Jakarta": "ID",
+  "Asia/Makassar": "ID",
+  "Asia/Jayapura": "ID",
+  "Asia/Bangkok": "TH",
+  "Asia/Ho_Chi_Minh": "VN",
+  "Asia/Saigon": "VN",
+  "Asia/Phnom_Penh": "KH",
+  "Asia/Vientiane": "LA",
+  "Asia/Yangon": "MM",
+  "Asia/Rangoon": "MM",
+  "Asia/Manila": "PH",
+  "Asia/Ulaanbaatar": "MN",
+  "Asia/Hovd": "MN",
+  "Asia/Tbilisi": "GE",
+  "Asia/Baku": "AZ",
+  "Asia/Yerevan": "AM",
+  "Asia/Almaty": "KZ",
+  "Asia/Bishkek": "KG",
+  "Asia/Tashkent": "UZ",
+  "Asia/Ashgabat": "TM",
+  "Asia/Dushanbe": "TJ",
+  "Asia/Thimphu": "BT",
+  "Asia/Dili": "TL",
+  // Europe
+  "Europe/London": "GB",
+  "Europe/Dublin": "IE",
+  "Europe/Lisbon": "PT",
+  "Europe/Madrid": "ES",
+  "Europe/Paris": "FR",
+  "Europe/Brussels": "BE",
+  "Europe/Amsterdam": "NL",
+  "Europe/Luxembourg": "LU",
+  "Europe/Berlin": "DE",
+  "Europe/Zurich": "CH",
+  "Europe/Vienna": "AT",
+  "Europe/Rome": "IT",
+  "Europe/Monaco": "MC",
+  "Europe/Vatican": "VA",
+  "Europe/Malta": "MT",
+  "Europe/Prague": "CZ",
+  "Europe/Budapest": "HU",
+  "Europe/Warsaw": "PL",
+  "Europe/Bratislava": "SK",
+  "Europe/Ljubljana": "SI",
+  "Europe/Zagreb": "HR",
+  "Europe/Belgrade": "RS",
+  "Europe/Sarajevo": "BA",
+  "Europe/Podgorica": "ME",
+  "Europe/Skopje": "MK",
+  "Europe/Tirane": "AL",
+  "Europe/Sofia": "BG",
+  "Europe/Bucharest": "RO",
+  "Europe/Chisinau": "MD",
+  "Europe/Athens": "GR",
+  "Europe/Istanbul": "TR",
+  "Europe/Helsinki": "FI",
+  "Europe/Stockholm": "SE",
+  "Europe/Oslo": "NO",
+  "Europe/Copenhagen": "DK",
+  "Europe/Tallinn": "EE",
+  "Europe/Riga": "LV",
+  "Europe/Vilnius": "LT",
+  "Europe/Minsk": "BY",
+  "Europe/Moscow": "RU",
+  "Europe/Kaliningrad": "RU",
+  "Europe/Samara": "RU",
+  "Europe/Kiev": "UA",
+  "Europe/Kyiv": "UA",
+  "Europe/Reykjavik": "IS",
+  "Europe/Andorra": "AD",
+  "Europe/Gibraltar": "GI",
+  "Europe/San_Marino": "SM",
+  // Americas
+  "America/New_York": "US",
+  "America/Chicago": "US",
+  "America/Denver": "US",
+  "America/Los_Angeles": "US",
+  "America/Phoenix": "US",
+  "America/Anchorage": "US",
+  "Pacific/Honolulu": "US",
+  "America/Detroit": "US",
+  "America/Indianapolis": "US",
+  "America/Boise": "US",
+  "America/Juneau": "US",
+  "America/Adak": "US",
+  "America/Toronto": "CA",
+  "America/Vancouver": "CA",
+  "America/Montreal": "CA",
+  "America/Winnipeg": "CA",
+  "America/Edmonton": "CA",
+  "America/Halifax": "CA",
+  "America/St_Johns": "CA",
+  "America/Regina": "CA",
+  "America/Mexico_City": "MX",
+  "America/Cancun": "MX",
+  "America/Tijuana": "MX",
+  "America/Monterrey": "MX",
+  "America/Hermosillo": "MX",
+  "America/Guatemala": "GT",
+  "America/Belize": "BZ",
+  "America/El_Salvador": "SV",
+  "America/Tegucigalpa": "HN",
+  "America/Managua": "NI",
+  "America/Costa_Rica": "CR",
+  "America/Panama": "PA",
+  "America/Bogota": "CO",
+  "America/Lima": "PE",
+  "America/Guayaquil": "EC",
+  "America/Caracas": "VE",
+  "America/La_Paz": "BO",
+  "America/Asuncion": "PY",
+  "America/Montevideo": "UY",
+  "America/Buenos_Aires": "AR",
+  "America/Argentina/Buenos_Aires": "AR",
+  "America/Santiago": "CL",
+  "America/Sao_Paulo": "BR",
+  "America/Recife": "BR",
+  "America/Manaus": "BR",
+  "America/Fortaleza": "BR",
+  "America/Bahia": "BR",
+  "America/Havana": "CU",
+  "America/Jamaica": "JM",
+  "America/Port-au-Prince": "HT",
+  "America/Santo_Domingo": "DO",
+  "America/Puerto_Rico": "PR",
+  "America/Port_of_Spain": "TT",
+  "America/Barbados": "BB",
+  "America/Martinique": "MQ",
+  "America/Guyana": "GY",
+  "America/Paramaribo": "SR",
+  "America/Cayenne": "GF",
+  "America/Curacao": "CW",
+  // Africa
+  "Africa/Cairo": "EG",
+  "Africa/Casablanca": "MA",
+  "Africa/Tunis": "TN",
+  "Africa/Algiers": "DZ",
+  "Africa/Tripoli": "LY",
+  "Africa/Khartoum": "SD",
+  "Africa/Addis_Ababa": "ET",
+  "Africa/Nairobi": "KE",
+  "Africa/Dar_es_Salaam": "TZ",
+  "Africa/Kampala": "UG",
+  "Africa/Mogadishu": "SO",
+  "Africa/Lagos": "NG",
+  "Africa/Accra": "GH",
+  "Africa/Abidjan": "CI",
+  "Africa/Dakar": "SN",
+  "Africa/Bamako": "ML",
+  "Africa/Ouagadougou": "BF",
+  "Africa/Conakry": "GN",
+  "Africa/Freetown": "SL",
+  "Africa/Monrovia": "LR",
+  "Africa/Lome": "TG",
+  "Africa/Porto-Novo": "BJ",
+  "Africa/Niamey": "NE",
+  "Africa/Douala": "CM",
+  "Africa/Libreville": "GA",
+  "Africa/Bangui": "CF",
+  "Africa/Brazzaville": "CG",
+  "Africa/Kinshasa": "CD",
+  "Africa/Lubumbashi": "CD",
+  "Africa/Luanda": "AO",
+  "Africa/Maputo": "MZ",
+  "Africa/Harare": "ZW",
+  "Africa/Lusaka": "ZM",
+  "Africa/Lilongwe": "MW",
+  "Africa/Johannesburg": "ZA",
+  "Africa/Windhoek": "NA",
+  "Africa/Gaborone": "BW",
+  "Africa/Maseru": "LS",
+  "Africa/Mbabane": "SZ",
+  "Indian/Antananarivo": "MG",
+  "Indian/Mauritius": "MU",
+  "Indian/Reunion": "RE",
+  "Indian/Comoro": "KM",
+  "Indian/Mayotte": "YT",
+  "Africa/Djibouti": "DJ",
+  "Africa/Asmara": "ER",
+  // Oceania
+  "Australia/Sydney": "AU",
+  "Australia/Melbourne": "AU",
+  "Australia/Brisbane": "AU",
+  "Australia/Perth": "AU",
+  "Australia/Adelaide": "AU",
+  "Australia/Hobart": "AU",
+  "Australia/Darwin": "AU",
+  "Australia/Lord_Howe": "AU",
+  "Pacific/Auckland": "NZ",
+  "Pacific/Chatham": "NZ",
+  "Pacific/Fiji": "FJ",
+  "Pacific/Tongatapu": "TO",
+  "Pacific/Apia": "WS",
+  "Pacific/Port_Moresby": "PG",
+  "Pacific/Noumea": "NC",
+  "Pacific/Guam": "GU",
+  "Pacific/Pago_Pago": "AS",
+  "Pacific/Tahiti": "PF",
+  // Atlantic / Indian Ocean
+  "Atlantic/Reykjavik": "IS",
+  "Atlantic/Azores": "PT",
+  "Atlantic/Canary": "ES",
+  "Atlantic/Madeira": "PT",
+  "Atlantic/Cape_Verde": "CV",
+  "Atlantic/Bermuda": "BM",
+  "Indian/Maldives": "MV",
+  "Indian/Chagos": "IO",
+  "Indian/Christmas": "CX",
+  "Indian/Cocos": "CC"
+};
+function detectCountryFromTimezone() {
+  try {
+    const tz = Intl.DateTimeFormat().resolvedOptions().timeZone;
+    if (!tz) return void 0;
+    return TIMEZONE_TO_COUNTRY[tz];
+  } catch {
+    return void 0;
+  }
 }
 const DEFAULT_INGEST_ENDPOINT = "https://engage-api.bluenath.com/api/v1/tracking/ingest";
 const FIXED_INGEST_PATH = "/api/v1/tracking/ingest";
 const ALLOWED_DEV_HOSTS = /* @__PURE__ */ new Set(["localhost", "127.0.0.1"]);
 const DEFAULT_CURRENCY = "USD";
+const SESSION_KEY = "engage_session_id";
 const SYMBOL_TO_CURRENCY = {
   $: "USD",
   US$: "USD",
@@ -424,8 +826,8 @@ const SYMBOL_TO_CURRENCY = {
   "¥": "JPY",
   JPY: "JPY"
 };
-const resolveIngestEndpoint = (apiHost) => {
-  if (!apiHost) return DEFAULT_INGEST_ENDPOINT;
+const resolveEndpoint = (apiHost, path, defaultUrl) => {
+  if (!apiHost) return defaultUrl;
   try {
     const parsed = new URL(apiHost);
     const isAllowedHost = parsed.hostname.endsWith("bluenath.com") || ALLOWED_DEV_HOSTS.has(parsed.hostname);
@@ -433,14 +835,14 @@ const resolveIngestEndpoint = (apiHost) => {
       console.warn(
         `[EngagePro] Ignoring unsupported apiHost "${parsed.hostname}". Falling back to managed endpoint.`
       );
-      return DEFAULT_INGEST_ENDPOINT;
+      return defaultUrl;
     }
-    parsed.pathname = FIXED_INGEST_PATH;
+    parsed.pathname = path;
     parsed.search = "";
     parsed.hash = "";
     return parsed.toString();
   } catch {
-    return DEFAULT_INGEST_ENDPOINT;
+    return defaultUrl;
   }
 };
 const parseCurrencyToken = (value) => {
@@ -462,6 +864,29 @@ const parseRevenueAmount = (value) => {
   const parsed = Number(numeric);
   return Number.isFinite(parsed) ? parsed : 0;
 };
+function getOrCreateSessionId() {
+  if (typeof sessionStorage === "undefined") return v4();
+  let sessionId = sessionStorage.getItem(SESSION_KEY);
+  if (!sessionId) {
+    sessionId = v4();
+    sessionStorage.setItem(SESSION_KEY, sessionId);
+  }
+  return sessionId;
+}
+function validateMetadata(meta) {
+  if (!meta || typeof meta !== "object") return void 0;
+  const result = {};
+  const keys = Object.keys(meta).slice(0, 20);
+  for (const key of keys) {
+    const val = meta[key];
+    if (typeof val === "boolean" || typeof val === "number") {
+      result[key] = val;
+    } else if (typeof val === "string") {
+      result[key] = val.slice(0, 100);
+    }
+  }
+  return Object.keys(result).length > 0 ? result : void 0;
+}
 class EngagePro {
   constructor(config) {
     __publicField(this, "config");
@@ -469,6 +894,11 @@ class EngagePro {
     __publicField(this, "context");
     __publicField(this, "queue");
     __publicField(this, "transport");
+    // Spec §3.2: Auto-detected fields
+    __publicField(this, "sessionId");
+    __publicField(this, "countryCode");
+    // Spec §3.3: Current sentiment (set by brand, attached to next event)
+    __publicField(this, "currentSentiment");
     // ✅ ARROW FUNCTION (Auto-bound 'this')
     __publicField(this, "identify", (userId, traits) => {
       this.context.userId = userId;
@@ -495,6 +925,7 @@ class EngagePro {
         intent: "navigation",
         confidence: 1
       });
+      this.emitEngageEvent("pageview", properties);
     });
     // ✅ ARROW FUNCTION
     __publicField(this, "track", (eventName, properties, intelligence) => {
@@ -503,6 +934,22 @@ class EngagePro {
         properties: properties || {},
         ...intelligence
       });
+      const typeMap = {
+        purchase: "purchase",
+        PURCHASE: "purchase",
+        signup: "signup",
+        SIGNUP: "signup",
+        register: "signup",
+        REGISTER: "signup",
+        add_to_cart: "add_to_cart",
+        ADD_TO_CART: "add_to_cart",
+        product_view: "product_view",
+        VIEW_CONTENT: "product_view",
+        session_start: "session_start",
+        session_end: "session_end"
+      };
+      const engageType = typeMap[eventName] || typeMap[(intelligence == null ? void 0 : intelligence.standardEvent) || ""] || "custom";
+      this.emitEngageEvent(engageType, properties);
     });
     __publicField(this, "trackRevenue", (amount, properties, intelligence) => {
       const parsedAmount = Math.max(0, parseRevenueAmount(amount));
@@ -526,12 +973,53 @@ class EngagePro {
         }
       );
     });
+    /**
+     * Spec §3.3: Set sentiment for the current session.
+     * Attached to the next emitted event.
+     */
+    __publicField(this, "setSentiment", (sentiment) => {
+      this.currentSentiment = sentiment;
+    });
     this.config = config;
-    this.transport = new Transport(resolveIngestEndpoint(config.apiHost));
+    const apiKey = config.apiKey || config.writeKey;
+    const legacyEndpoint = resolveEndpoint(config.apiHost, FIXED_INGEST_PATH, DEFAULT_INGEST_ENDPOINT);
+    this.transport = new Transport(legacyEndpoint);
+    this.transport.setApiKey(apiKey);
     this.context = new Context({
       persistence: config.tracking.useCookies ? "cookie" : "local"
     });
     this.queue = new EventQueue(this.transport);
+    this.sessionId = getOrCreateSessionId();
+    this.countryCode = detectCountryFromTimezone();
+    if (config.tracking.autoTrack && typeof window !== "undefined") {
+      this.page();
+    }
+  }
+  /**
+   * Emit a new-format EngageEvent to the ingest pipeline (Spec §3.1).
+   */
+  emitEngageEvent(type, properties) {
+    const pageCtx = this.context.getPayload().page;
+    const event = {
+      type,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      sessionId: this.sessionId,
+      userId: this.context.getPayload().user.id || void 0,
+      countryCode: this.countryCode,
+      sentiment: this.currentSentiment,
+      referrer: (pageCtx.referrer || "").slice(0, 500),
+      path: pageCtx.path || (typeof window !== "undefined" ? window.location.pathname : "/"),
+      currency: parseCurrencyToken(properties == null ? void 0 : properties.currency) || parseCurrencyToken(properties == null ? void 0 : properties.currencyCode) || void 0,
+      amount: typeof (properties == null ? void 0 : properties.amountPaise) === "number" ? properties.amountPaise : typeof (properties == null ? void 0 : properties.amount) === "number" ? Math.round(properties.amount * 100) : void 0,
+      productId: typeof (properties == null ? void 0 : properties.productId) === "string" ? properties.productId : void 0,
+      productName: typeof (properties == null ? void 0 : properties.productName) === "string" ? properties.productName : void 0,
+      productCategory: typeof (properties == null ? void 0 : properties.productCategory) === "string" ? properties.productCategory : void 0,
+      metadata: validateMetadata(properties == null ? void 0 : properties.metadata)
+    };
+    this.queue.enqueueEngageEvent(event);
+    if (this.currentSentiment) {
+      this.currentSentiment = void 0;
+    }
   }
   parseRef(ref) {
     if (!ref) return {};
@@ -539,7 +1027,7 @@ class EngagePro {
     if (!m) return {};
     return { campaignId: m[1], creatorId: m[2] };
   }
-  // Internal Helper
+  // Internal Helper (legacy event processing)
   processEvent(data) {
     const baseContext = this.context.getPayload();
     const refValue = data.properties.ref;
@@ -561,7 +1049,7 @@ class EngagePro {
       // Metadata
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
       messageId: v4(),
-      writeKey: this.config.writeKey,
+      writeKey: this.config.writeKey || this.config.apiKey || "",
       ref,
       campaignId: (typeof campaignIdValue === "string" ? campaignIdValue : void 0) || refParts.campaignId,
       creatorId: (typeof creatorIdValue === "string" ? creatorIdValue : void 0) || refParts.creatorId,
@@ -823,13 +1311,69 @@ const EngageProProvider = ({
 let instance = null;
 const init = (config) => {
   if (!instance) {
-    instance = new EngagePro(config);
+    const normalizedConfig = {
+      ...config,
+      writeKey: config.writeKey || config.apiKey || "",
+      apiKey: config.apiKey || config.writeKey || ""
+    };
+    instance = new EngagePro(normalizedConfig);
   }
   return instance;
 };
+const engage = {
+  init(config) {
+    return init({
+      writeKey: config.apiKey,
+      apiKey: config.apiKey,
+      apiHost: config.apiHost,
+      tracking: config.tracking || {
+        useCookies: true,
+        fingerprint: true,
+        autoTrack: true
+      },
+      debug: config.debug
+    });
+  },
+  track(eventName, properties) {
+    if (!instance) {
+      console.warn("[EngagePro] Not initialized. Call engage.init() first.");
+      return;
+    }
+    instance.track(eventName, properties);
+  },
+  page(name, properties) {
+    if (!instance) {
+      console.warn("[EngagePro] Not initialized. Call engage.init() first.");
+      return;
+    }
+    instance.page(name, properties);
+  },
+  identify(userId, traits) {
+    if (!instance) {
+      console.warn("[EngagePro] Not initialized. Call engage.init() first.");
+      return;
+    }
+    instance.identify(userId, traits);
+  },
+  trackRevenue(amount, properties) {
+    if (!instance) {
+      console.warn("[EngagePro] Not initialized. Call engage.init() first.");
+      return;
+    }
+    instance.trackRevenue(amount, properties);
+  },
+  setSentiment(sentiment) {
+    if (!instance) {
+      console.warn("[EngagePro] Not initialized. Call engage.init() first.");
+      return;
+    }
+    instance.setSentiment(sentiment);
+  }
+};
 export {
   EngageProProvider,
   EngagePro as default,
+  engage,
   init,
   useAnalytics
 };

package/dist/lib/timezone-country.d.ts

@@ -0,0 +1,6 @@
+export declare const TIMEZONE_TO_COUNTRY: Record<string, string>;
+/**
+ * Detects country code from browser timezone.
+ * Returns ISO 3166-1 alpha-2 code or undefined.
+ */
+export declare function detectCountryFromTimezone(): string | undefined;

package/dist/types/index.d.ts

@@ -64,6 +64,7 @@ export interface AnalyticsEvent {
 }
 export interface EngageConfig {
     writeKey: string;
+    apiKey?: string;
     apiHost?: string;
     tracking: {
         useCookies: boolean;
@@ -72,3 +73,25 @@ export interface EngageConfig {
     };
     debug?: boolean;
 }
+export type EngageEventType = "pageview" | "product_view" | "add_to_cart" | "purchase" | "signup" | "session_start" | "session_end" | "custom";
+export type SentimentValue = "positive" | "neutral" | "negative";
+/**
+ * Spec §3.1 — The event schema emitted by the engage module
+ * to POST /api/v1/analytics/ingest. Backend validates against this.
+ */
+export interface EngageEvent {
+    type: EngageEventType;
+    timestamp: string;
+    sessionId: string;
+    userId?: string;
+    currency?: string;
+    amount?: number;
+    productId?: string;
+    productName?: string;
+    productCategory?: string;
+    countryCode?: string;
+    sentiment?: SentimentValue;
+    referrer?: string;
+    path: string;
+    metadata?: Record<string, string | number | boolean>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluenath/engage",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",