@bluenath/engage 2.0.2 → 2.0.4

package/README.md

@@ -1,25 +1,35 @@
 # @bluenath/engage
 
-Production-ready analytics SDK for EngagePro attribution and campaign intelligence.
+The official analytics and attribution SDK for [EngagePro](https://engagepro.bluenath.com). Production-ready event capture for campaign ROI measurement and creator attribution.
 
-This SDK captures web events, enriches intent signals, and sends batched payloads to EngagePro ingest for campaign-level ROI measurement.
+Developed by the [Bluenath](https://bluenath.com) team.
 
-## Highlights
+---
 
-- Auto-captures high-value interaction events (page, commerce, form, rage-click)
-- Supports manual business events with value and currency fields
-- Handles offline queueing and retry with backoff
-- Includes lightweight React Provider and hook API
-- Protects sensitive input fields during capture
+## Overview
+
+`@bluenath/engage` is a high-performance analytics SDK designed to bridge the gap between user interactions and campaign attribution. It captures critical web events, enriches intent signals, and securely transmits batched payloads to EngagePro's ingestion servers for real-time ROI analysis.
+
+## Key Features
+
+- **Automated Event Capture**: Seamlessly tracks high-value interactions including page views, commerce events, form submissions, and friction signals (e.g., rage-clicks).
+- **Manual Business Events**: Flexible API for tracking custom conversions with support for value, currency, and campaign metadata.
+- **Resilient Delivery**: Robust offline queueing mechanism with exponential backoff and retry logic.
+- **Framework Integration**: Includes a lightweight React Provider and custom hooks for modern web architectures.
+- **Data Security**: Built-in protection for sensitive input fields and secure handling of attribution identifiers.
 
 ## Installation
 
+Install the package via your preferred package manager:
+
 ```bash
 npm install @bluenath/engage
 ```
 
 ## Quick Start (React)
 
+Initialize the SDK at the root of your application using the `EngageProProvider`.
+
 ```tsx
 import React from "react";
 import ReactDOM from "react-dom/client";
@@ -40,60 +50,62 @@ ReactDOM.createRoot(document.getElementById("root")!).render(
 );
 ```
 
-## Manual Tracking
+## Manual Event Tracking
+
+Use the `useAnalytics` hook to capture specific business outcomes.
 
 ```tsx
 import { useAnalytics } from "@bluenath/engage";
 
-export function CheckoutComplete() {
+export function PurchaseConfirmation() {
   const analytics = useAnalytics();
 
-  const onPurchase = () => {
+  const handlePurchase = () => {
     analytics.track("PURCHASE", {
-      orderId: "ORD-7281",
-      amount: 2499,
+      orderId: "ORD-1029",
+      amount: 4999,
       currency: "INR",
       ref: "camp_<campaignId>_cr_<creatorId>",
     });
   };
 
-  return <button onClick={onPurchase}>Confirm</button>;
+  return <button onClick={handlePurchase}>Confirm Payout</button>;
 }
 ```
 
-## Attribution Reference Format
+### Attribution Reference Format
 
-For campaign-level attribution, include this exact `ref` format in tracked events:
-
-```text
-camp_<campaignId>_cr_<creatorId>
-```
+For accurate campaign attribution, ensure the `ref` field follows the standard EngagePro format:
+`camp_<campaignId>_cr_<creatorId>`
 
-This allows EngagePro to map conversions to creator partnerships and payout logic.
+## API Reference
 
-## Endpoint Policy
+### Provider Configuration
 
-- Production ingest endpoint is fixed to EngagePro managed backend.
-- Optional `apiHost` override is accepted only for local development (`localhost` or `127.0.0.1`).
-- Unsupported hosts are rejected and automatically fall back to the managed endpoint.
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| `writeKey` | `string` | **Yes** | Your public brand write key from the [EngagePro Dashboard](https://engagepro.bluenath.com/app/integration). |
+| `apiHost` | `string` | No | Local development override (restricted to `localhost` or `127.0.0.1`). |
+| `tracking.autoTrack` | `boolean` | **Yes** | Enables automated DOM interaction capture. |
+| `tracking.useCookies`| `boolean` | **Yes** | Persists anonymous identifiers across sessions. |
+| `tracking.fingerprint`| `boolean` | **Yes** | Includes device context for fraud prevention and unique visit tracking. |
+| `debug` | `boolean` | No | Enables console logging for integration testing. |
 
-## Configuration
+## Network & Security Policies
 
-| Field                  | Type      | Required | Description                                     |
-| ---------------------- | --------- | -------- | ----------------------------------------------- |
-| `writeKey`             | `string`  | Yes      | Brand public write key from EngagePro dashboard |
-| `apiHost`              | `string`  | No       | Local override only for local development       |
-| `tracking.autoTrack`   | `boolean` | Yes      | Enable DOM interaction capture                  |
-| `tracking.useCookies`  | `boolean` | Yes      | Persist anonymous identity across sessions      |
-| `tracking.fingerprint` | `boolean` | Yes      | Include device fingerprint context              |
-| `debug`                | `boolean` | No       | Log payloads in console for integration testing |
+- **Endpoint Isolation**: Production data is exclusively routed to EngagePro's managed infrastructure.
+- **Local Development**: The `apiHost` parameter is strictly limited to local environments for testing. External host overrides are rejected for security compliance.
+- **Security Best Practices**: 
+  - Never expose internal service keys in client-side code.
+  - Rotate write keys immediately if leakage is suspected.
+  - Use hashed or anonymous identifiers; do not transmit raw PII (Personally Identifiable Information).
 
-## Security Notes
+## Resources
 
-- Do not use internal service keys in frontend apps.
-- Rotate leaked write keys immediately from EngagePro dashboard.
-- Avoid sending raw PII inside custom properties.
+- [Official Documentation](https://engagepro.bluenath.com/docs)
+- [EngagePro Platform](https://engagepro.bluenath.com)
+- [Bluenath Creator OS](https://bluenath.com)
 
 ## License
 
-MIT
+This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.

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.2",
+  "version": "2.0.4",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",