@linkzly/web-sdk 1.0.0

package/README.md

@@ -0,0 +1,330 @@
+# @linkzly/web-sdk
+
+[![Platform](https://img.shields.io/badge/platform-Web-blue.svg)](https://developer.mozilla.org)
+[![TypeScript](https://img.shields.io/badge/language-TypeScript-blue.svg)](https://www.typescriptlang.org)
+[![License](https://img.shields.io/badge/license-MIT-lightgrey.svg)](LICENSE)
+
+Full-featured browser SDK for Linkzly — event tracking, attribution, session management, and deep linking for web applications. Zero dependencies, < 6KB gzipped.
+
+## Features
+
+- **Event Tracking** — Custom events, page views, purchases with automatic batching
+- **Session Management** — Automatic visibility-based sessions (30s timeout, matching mobile SDKs)
+- **Attribution Tracking** — UTM parameters, referrer capture, smart link handling
+- **Deep Link / Smart Link** — Parse and handle Linkzly smart links with SPA support
+- **User Identification** — Persistent visitor ID + custom user ID
+- **Privacy Controls** — DNT/GPC respect, opt-out controls, GDPR-friendly
+- **Offline Queue** — localStorage-backed event queue with retry and sendBeacon on unload
+- **Scroll Depth** — Automatic max scroll depth tracking per page
+- **Outbound Click Tracking** — Automatic external link click tracking
+- **Time on Page** — Automatic session duration tracking
+- **SPA Support** — History API hooks for pushState/popstate navigation
+
+## Requirements
+
+- Any modern browser (Chrome 66+, Firefox 60+, Safari 12+, Edge 79+)
+- No dependencies
+
+## Installation
+
+### npm / yarn
+
+```bash
+npm install @linkzly/web-sdk
+# or
+yarn add @linkzly/web-sdk
+```
+
+### CDN (UMD)
+
+```html
+<script src="https://cdn.linkzly.com/web-sdk/latest/index.js"></script>
+<script>
+  LinkzlySDK.configure('YOUR_SDK_KEY');
+</script>
+```
+
+## Quick Start
+
+```typescript
+import LinkzlySDK from '@linkzly/web-sdk';
+
+// Initialize
+LinkzlySDK.configure('YOUR_SDK_KEY');
+
+// Track events
+LinkzlySDK.trackEvent('button_click', { button_id: 'signup' });
+
+// Track purchases
+LinkzlySDK.trackPurchase({
+  order_id: 'ORD-123',
+  amount: 99.99,
+  currency: 'USD',
+});
+
+// Set user ID after login
+LinkzlySDK.setUserID('user_12345');
+```
+
+### Named Imports (Tree-Shakeable)
+
+```typescript
+import { configure, trackEvent, trackPageView, setUserID } from '@linkzly/web-sdk';
+
+configure('YOUR_SDK_KEY');
+trackEvent('signup_completed', { method: 'google' });
+```
+
+## API Reference
+
+### Configuration
+
+#### `configure(sdkKey, environment?, options?)`
+
+Initialize the SDK. Must be called before any other method.
+
+```typescript
+import LinkzlySDK, { Environment } from '@linkzly/web-sdk';
+
+LinkzlySDK.configure('YOUR_SDK_KEY', Environment.PRODUCTION, {
+  autoTrackPageViews: false,  // opt-in SPA page view tracking (default: false)
+  autoTrackSessions: true,    // visibility-based sessions (default: true)
+  autoExtractUTM: true,       // auto-capture UTM params (default: true)
+  autoCaptureReferrer: true,  // auto-capture document.referrer (default: true)
+  respectDNT: true,           // honor Do Not Track / GPC (default: true)
+  batchSize: 20,              // events per batch (default: 20)
+  flushIntervalMs: 30000,     // flush timer (default: 30s)
+  sessionTimeoutMs: 30000,    // session timeout (default: 30s)
+  debug: false,               // console logging (default: false, auto-true in DEVELOPMENT)
+});
+```
+
+**Environments:**
+- `Environment.PRODUCTION` — Production endpoint (default)
+- `Environment.STAGING` — Staging endpoint
+- `Environment.DEVELOPMENT` — Development endpoint with verbose logging
+
+### Event Tracking
+
+#### `trackEvent(eventName, parameters?)`
+
+Track a custom event.
+
+```typescript
+LinkzlySDK.trackEvent('add_to_cart', {
+  product_id: 'SKU-123',
+  quantity: 2,
+  price: 49.99,
+});
+```
+
+#### `trackPageView(pageUrl?, parameters?)`
+
+Track a page view. Called automatically if `autoTrackPageViews: true`.
+
+```typescript
+LinkzlySDK.trackPageView(); // current page
+LinkzlySDK.trackPageView('/products/123', { category: 'electronics' });
+```
+
+#### `trackPurchase(parameters?)`
+
+Track a purchase event.
+
+```typescript
+LinkzlySDK.trackPurchase({
+  order_id: 'ORD-98765',
+  total: 599.99,
+  currency: 'USD',
+  items: 3,
+});
+```
+
+#### `trackEventBatch(events)`
+
+Track multiple events in one call.
+
+```typescript
+LinkzlySDK.trackEventBatch([
+  { eventName: 'screen_view', parameters: { screen: 'home' } },
+  { eventName: 'button_click', parameters: { button: 'signup' } },
+]);
+```
+
+#### `flushEvents()`
+
+Manually flush all queued events to the server.
+
+```typescript
+await LinkzlySDK.flushEvents();
+```
+
+#### `getPendingEventCount()`
+
+Get the number of events waiting in the queue.
+
+```typescript
+const count = LinkzlySDK.getPendingEventCount();
+```
+
+### Deep Link / Smart Link
+
+#### `handleSmartLink(url?)`
+
+Parse a URL into deep link data (matching mobile SDK pattern).
+
+```typescript
+const data = LinkzlySDK.handleSmartLink();
+// { url, path, parameters, smartLinkId, clickId }
+
+const data = LinkzlySDK.handleSmartLink('https://example.com/product?id=123&slid=abc');
+```
+
+#### `addDeepLinkListener(listener)`
+
+Listen for SPA navigation events (requires `autoTrackPageViews: true`).
+
+```typescript
+const unsubscribe = LinkzlySDK.addDeepLinkListener((data) => {
+  console.log('Navigation:', data.path, data.parameters);
+});
+
+// Cleanup
+unsubscribe();
+```
+
+### User Management
+
+#### `setUserID(userID)` / `getUserID()` / `clearUserID()`
+
+```typescript
+LinkzlySDK.setUserID('user_12345');
+const id = LinkzlySDK.getUserID(); // 'user_12345'
+LinkzlySDK.clearUserID();
+```
+
+#### `getVisitorID()` / `resetVisitorID()`
+
+Persistent device/browser identifier (survives across sessions).
+
+```typescript
+const visitorId = LinkzlySDK.getVisitorID(); // UUID persisted in localStorage
+const newId = LinkzlySDK.resetVisitorID();   // generates new UUID
+```
+
+### Session Management
+
+```typescript
+const sessionId = LinkzlySDK.getSessionId();
+LinkzlySDK.startSession();  // force new session
+LinkzlySDK.endSession();    // end current session
+```
+
+Sessions auto-manage via the Page Visibility API — a new session starts when the page becomes visible after 30+ seconds of being hidden.
+
+### Privacy Controls
+
+```typescript
+LinkzlySDK.setTrackingEnabled(false); // disable all tracking
+const enabled = LinkzlySDK.isTrackingEnabled();
+```
+
+The SDK respects `navigator.doNotTrack` and `navigator.globalPrivacyControl` by default. Set `respectDNT: false` in config to override.
+
+### Cleanup
+
+```typescript
+LinkzlySDK.destroy(); // remove all listeners, flush events, stop timers
+```
+
+## Framework Examples
+
+### React / Next.js
+
+```tsx
+import { useEffect } from 'react';
+import LinkzlySDK, { Environment } from '@linkzly/web-sdk';
+
+export default function App({ children }) {
+  useEffect(() => {
+    LinkzlySDK.configure('YOUR_SDK_KEY', Environment.PRODUCTION, {
+      autoTrackPageViews: true, // enable for Next.js SPA navigation
+    });
+
+    return () => LinkzlySDK.destroy();
+  }, []);
+
+  return <>{children}</>;
+}
+```
+
+### Vue 3
+
+```typescript
+// main.ts
+import { createApp } from 'vue';
+import LinkzlySDK from '@linkzly/web-sdk';
+import App from './App.vue';
+
+LinkzlySDK.configure('YOUR_SDK_KEY');
+createApp(App).mount('#app');
+```
+
+### Vanilla JS
+
+```html
+<script type="module">
+  import LinkzlySDK from '@linkzly/web-sdk';
+
+  LinkzlySDK.configure('YOUR_SDK_KEY');
+
+  document.getElementById('buy-btn').addEventListener('click', () => {
+    LinkzlySDK.trackEvent('button_click', { button: 'buy' });
+  });
+</script>
+```
+
+## Auto-Tracked Web Features
+
+These features use the existing event payload structure (`customData` field) — no database changes required.
+
+| Feature | Event Name | Data Collected |
+|---------|-----------|----------------|
+| **Scroll Depth** | `scroll_depth` | `max_depth_percent`, `page_url` |
+| **Time on Page** | `time_on_page` | `duration_seconds`, `page_url` |
+| **Outbound Clicks** | `outbound_click` | `destination_url`, `link_text`, `page_url` |
+
+Scroll depth and time on page are sent automatically on page unload via `sendBeacon`. Outbound clicks are tracked in real-time.
+
+## Event Delivery
+
+- **Batching**: Up to 20 events per batch (configurable), max 100 per network request
+- **Queue**: Events persisted in localStorage (up to 500, 24h expiry)
+- **Flush triggers**: Batch size reached, 30s timer, `flushEvents()`, page unload
+- **Unload**: `navigator.sendBeacon()` for reliable delivery on page close
+- **Retry**: Exponential backoff (1s, 2s, 4s) with max 3 retries on 5xx/429
+
+## Data Collected
+
+When tracking is enabled, the SDK collects:
+- Browser information (user agent, language, screen size, viewport, timezone)
+- Page URL and referrer (external only)
+- UTM parameters from URL
+- Smart link / click attribution IDs
+- Custom event data (provided by your application)
+
+**Not collected:**
+- Personal user information (unless explicitly provided via `setUserID`)
+- Location data (beyond IP-based geo-location server-side)
+
+> **Note:** For affiliate attribution tracking (cookie-based click IDs, checkout form helpers, S2S conversion payloads), use the separate [`@linkzly/affiliate-web`](../linkzly-affiliate-web) package.
+
+## License
+
+MIT
+
+## Support
+
+- Documentation: https://docs.linkzly.com
+- Issues: https://github.com/linkzly/linkzly-web-sdk/issues
+- Email: support@linkzly.com

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var x=Object.defineProperty;var X=Object.getOwnPropertyDescriptor;var Y=Object.getOwnPropertyNames;var G=Object.prototype.hasOwnProperty;var W=(r,e)=>{for(var t in e)x(r,t,{get:e[t],enumerable:!0})},j=(r,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of Y(e))!G.call(r,i)&&i!==t&&x(r,i,{get:()=>e[i],enumerable:!(n=X(e,i))||n.enumerable});return r};var Z=r=>j(x({},"__esModule",{value:!0}),r);var De={};W(De,{Environment:()=>f,LinkzlyWebSDK:()=>v,addDeepLinkListener:()=>he,clearUserID:()=>ve,configure:()=>ie,default:()=>Ee,destroy:()=>Ie,endSession:()=>we,flushEvents:()=>ce,getPendingEventCount:()=>de,getSessionId:()=>Se,getUserID:()=>me,getVisitorID:()=>ke,handleSmartLink:()=>ge,isTrackingEnabled:()=>Le,removeAllListeners:()=>pe,resetVisitorID:()=>be,setTrackingEnabled:()=>Te,setUserID:()=>fe,startSession:()=>ye,trackEvent:()=>ae,trackEventBatch:()=>ue,trackFirstVisit:()=>re,trackOpen:()=>se,trackPageView:()=>oe,trackPurchase:()=>le});module.exports=Z(De);var f=(n=>(n[n.PRODUCTION=0]="PRODUCTION",n[n.STAGING=1]="STAGING",n[n.DEVELOPMENT=2]="DEVELOPMENT",n))(f||{});var ee={0:"https://ske.linkzly.com",1:"https://ske-staging.linkzly.com",2:"https://ske-dev.linkzly.com"},d={autoTrackPageViews:!1,autoTrackSessions:!0,autoExtractUTM:!0,autoCaptureReferrer:!0,respectDNT:!0,batchSize:20,flushIntervalMs:3e4,sessionTimeoutMs:3e4,debug:!1};function N(r,e,t){return{sdkKey:r,environment:e,baseURL:ee[e],autoTrackPageViews:t?.autoTrackPageViews??d.autoTrackPageViews,autoTrackSessions:t?.autoTrackSessions??d.autoTrackSessions,autoExtractUTM:t?.autoExtractUTM??d.autoExtractUTM,autoCaptureReferrer:t?.autoCaptureReferrer??d.autoCaptureReferrer,respectDNT:t?.respectDNT??d.respectDNT,batchSize:t?.batchSize??d.batchSize,flushIntervalMs:t?.flushIntervalMs??d.flushIntervalMs,sessionTimeoutMs:t?.sessionTimeoutMs??d.sessionTimeoutMs,debug:t?.debug??e===2}}var y=class{constructor(e){this.enabled=e}info(...e){this.enabled&&console.log("[LinkzlySDK]",...e)}debug(...e){this.enabled&&console.debug("[LinkzlySDK]",...e)}warn(...e){this.enabled&&console.warn("[LinkzlySDK]",...e)}error(...e){console.error("[LinkzlySDK]",...e)}};function z(){let r=typeof navigator<"u"?navigator:null,e=typeof window<"u"?window:null,t=typeof document<"u"?document:null,n=typeof window<"u"?window.screen:null;return{userAgent:r?.userAgent??"unknown",language:r?.language??"unknown",languages:r?.languages?.join(",")??"",screenSize:n?`${n.width}x${n.height}`:"unknown",viewportSize:e?`${e.innerWidth}x${e.innerHeight}`:"unknown",timezone:Intl?.DateTimeFormat?.()?.resolvedOptions?.()?.timeZone??"unknown",timezoneOffset:new Date().getTimezoneOffset(),colorDepth:n?.colorDepth??0,pixelRatio:e?.devicePixelRatio??1,platform:r?.platform??"unknown",cookiesEnabled:r?.cookieEnabled??!1,online:r?.onLine??!0,referrer:t?.referrer??"",pageUrl:e?.location?.href??""}}function O(r){return{userAgent:r.userAgent,language:r.language,languages:r.languages,screenSize:r.screenSize,viewportSize:r.viewportSize,timezone:r.timezone,timezoneOffset:r.timezoneOffset,colorDepth:r.colorDepth,pixelRatio:r.pixelRatio,platform:r.platform,cookiesEnabled:r.cookiesEnabled,online:r.online,referrer:r.referrer,pageUrl:r.pageUrl}}function l(){return typeof crypto<"u"&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,r=>{let e=Math.random()*16|0;return(r==="x"?e:e&3|8).toString(16)})}function m(r){if(!r)return!1;try{let e="__lz_test__";return r.setItem(e,"1"),r.removeItem(e),!0}catch{return!1}}function h(r){if(typeof localStorage>"u"||!m(localStorage))return null;try{return localStorage.getItem("lz_"+r)}catch{return null}}function c(r,e){if(!(typeof localStorage>"u"||!m(localStorage)))try{localStorage.setItem("lz_"+r,e)}catch{}}function q(r){if(!(typeof localStorage>"u"||!m(localStorage)))try{localStorage.removeItem("lz_"+r)}catch{}}function p(r){if(typeof sessionStorage>"u"||!m(sessionStorage))return null;try{return sessionStorage.getItem("lz_"+r)}catch{return null}}function u(r,e){if(!(typeof sessionStorage>"u"||!m(sessionStorage)))try{sessionStorage.setItem("lz_"+r,e)}catch{}}function R(r){if(!(typeof sessionStorage>"u"||!m(sessionStorage)))try{sessionStorage.removeItem("lz_"+r)}catch{}}function B(r){let e=h(r);if(!e)return null;try{return JSON.parse(e)}catch{return null}}function H(r,e){try{c(r,JSON.stringify(e))}catch{}}var w=3,F=1e3,te="Bearer linkzly-production-shared-secret-key-2024-secure-min-64",S=class{constructor(e,t){this.config=e,this.logger=t}async sendEvent(e){let t=`${this.config.baseURL}/v1/sdk/events`;return this.logger.debug("Sending event:",e.eventType,e.eventName??""),this.postJSON(t,e)}async sendBatch(e){if(e.length===0)return{success:!0};let t=`${this.config.baseURL}/v1/sdk/events/batch`,n={type:"sdk_event",events:e,batchId:l(),clientTimestamp:Date.now()};return this.logger.debug(`Sending batch of ${e.length} events`),this.postJSON(t,n)}sendBeacon(e){if(e.length===0)return!0;if(typeof navigator>"u"||!navigator.sendBeacon)return!1;let t=`${this.config.baseURL}/v1/sdk/events/batch`,n={type:"sdk_event",events:e,batchId:l(),clientTimestamp:Date.now()};try{let i=new Blob([JSON.stringify(n)],{type:"application/json"}),o=navigator.sendBeacon(t,i);return this.logger.debug(`Beacon ${o?"accepted":"rejected"}: ${e.length} events`),o}catch(i){return this.logger.error("sendBeacon failed:",i),!1}}async postJSON(e,t,n=0){try{let i=await fetch(e,{method:"POST",headers:{"Content-Type":"application/json","X-Linkzly-SDK":"web/1.0.0",Authorization:te},body:JSON.stringify(t),keepalive:!0});if(!i.ok){if((i.status>=500||i.status===429)&&n<w){let a=F*Math.pow(2,n);return this.logger.warn(`HTTP ${i.status}, retrying in ${a}ms (attempt ${n+1}/${w})`),await this.sleep(a),this.postJSON(e,t,n+1)}return this.logger.error(`HTTP ${i.status}: ${i.statusText}`),{success:!1,message:`HTTP ${i.status}`}}let o=await i.json().catch(()=>({}));return this.logger.debug("Response:",i.status),{success:!0,...o}}catch(i){if(n<w){let o=F*Math.pow(2,n);return this.logger.warn(`Network error, retrying in ${o}ms (attempt ${n+1}/${w}):`,i),await this.sleep(o),this.postJSON(e,t,n+1)}return this.logger.error("Network request failed after retries:",i),{success:!1,message:String(i)}}}sleep(e){return new Promise(t=>setTimeout(t,e))}};var V="event_queue",C=500,$=100,T=class{constructor(e,t,n){this.queue=[];this.flushTimer=null;this.isFlushing=!1;this.config=e,this.logger=t,this.network=n,this.restoreQueue(),this.startFlushTimer(),typeof window<"u"&&(window.addEventListener("beforeunload",()=>this.flushBeacon()),document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&this.flushBeacon()}))}enqueue(e){let t={id:l(),payload:e,createdAt:Date.now(),retryCount:0};this.queue.push(t),this.queue.length>C&&(this.queue=this.queue.slice(-C)),this.persistQueue(),this.logger.debug(`Event queued (${this.queue.length} pending): ${e.eventType}/${e.eventName??""}`),this.queue.length>=this.config.batchSize&&this.flush().catch(n=>this.logger.error("Auto-flush failed:",n))}async flush(){if(this.isFlushing||this.queue.length===0)return!0;this.isFlushing=!0;try{let e=this.queue.slice(0,$),t=e.map(i=>i.payload);if((await this.network.sendBatch(t)).success){let i=new Set(e.map(o=>o.id));return this.queue=this.queue.filter(o=>!i.has(o.id)),this.persistQueue(),this.logger.debug(`Flushed ${e.length} events, ${this.queue.length} remaining`),!0}return this.logger.warn(`Batch send failed, ${this.queue.length} events remain in queue`),!1}finally{this.isFlushing=!1}}getPendingCount(){return this.queue.length}destroy(){this.flushTimer&&(clearInterval(this.flushTimer),this.flushTimer=null)}startFlushTimer(){this.flushTimer||(this.flushTimer=setInterval(()=>{this.flush().catch(e=>this.logger.error("Periodic flush failed:",e))},this.config.flushIntervalMs))}flushBeacon(){if(this.queue.length===0)return;let e=this.queue.slice(0,$),t=e.map(i=>i.payload);if(this.network.sendBeacon(t)){let i=new Set(e.map(o=>o.id));this.queue=this.queue.filter(o=>!i.has(o.id)),this.persistQueue()}}persistQueue(){let e=this.queue.slice(-C);H(V,e)}restoreQueue(){let e=B(V);if(e&&Array.isArray(e)){let t=Date.now()-864e5;this.queue=e.filter(n=>n.createdAt>t),this.queue.length!==e.length&&(this.logger.debug(`Pruned ${e.length-this.queue.length} expired events from queue`),this.persistQueue()),this.queue.length>0&&this.logger.debug(`Restored ${this.queue.length} queued events from storage`)}}};var U="session_id",L="session_last_active",K="first_visit_done",I=class{constructor(e,t){this.callback=null;this.visibilityHandler=null;this.config=e,this.logger=t,this.lastActiveTime=Date.now();let n=p(U),i=p(L);n&&i?Date.now()-parseInt(i,10)<this.config.sessionTimeoutMs?(this.sessionId=n,this.lastActiveTime=parseInt(i,10),this.logger.debug("Resumed session:",this.sessionId)):this.sessionId=this.createNewSession():this.sessionId=this.createNewSession(),this.config.autoTrackSessions&&this.setupVisibilityTracking()}getSessionId(){return this.sessionId}isFirstVisit(){return h(K)===null}markFirstVisitDone(){c(K,String(Date.now()))}onSessionEvent(e){this.callback=e}touch(){this.lastActiveTime=Date.now(),u(L,String(this.lastActiveTime))}startSession(){return this.callback&&this.callback("end",this.sessionId),this.sessionId=this.createNewSession(),this.sessionId}endSession(){this.callback&&this.callback("end",this.sessionId),R(U),R(L)}destroy(){this.visibilityHandler&&typeof document<"u"&&(document.removeEventListener("visibilitychange",this.visibilityHandler),this.visibilityHandler=null)}createNewSession(){let e=l();return u(U,e),this.lastActiveTime=Date.now(),u(L,String(this.lastActiveTime)),this.logger.debug("New session started:",e),this.callback&&this.callback("start",e),e}setupVisibilityTracking(){typeof document>"u"||(this.visibilityHandler=()=>{if(document.visibilityState==="visible"){let e=Date.now()-this.lastActiveTime;e>=this.config.sessionTimeoutMs?(this.logger.debug(`Session timeout (${Math.round(e/1e3)}s idle), starting new session`),this.sessionId=this.createNewSession()):this.touch()}else this.touch()},document.addEventListener("visibilitychange",this.visibilityHandler))}};var Q="utm_",E="referrer",J="landing_page",ne=[{key:"utmSource",urlParam:"utm_source"},{key:"utmMedium",urlParam:"utm_medium"},{key:"utmCampaign",urlParam:"utm_campaign"},{key:"utmTerm",urlParam:"utm_term"},{key:"utmContent",urlParam:"utm_content"}],D=class{constructor(e,t){this.smartLinkId=null;this.clickId=null;this.deepLinkListeners=new Set;this.popStateHandler=null;this.config=e,this.logger=t,this.utm=this.initUTM(),this.referrer=this.initReferrer(),this.landingPage=this.initLandingPage(),this.initSmartLinkParams(),this.config.autoTrackPageViews&&this.setupSPATracking()}getUTM(){return{...this.utm}}getReferrer(){return this.referrer}getLandingPage(){return this.landingPage}getSmartLinkId(){return this.smartLinkId}getClickId(){return this.clickId}getAttributionData(){return{utm:this.getUTM(),referrer:this.referrer,smartLinkId:this.smartLinkId,clickId:this.clickId,landingPage:this.landingPage}}parseDeepLink(e){let t=e??(typeof window<"u"?window.location.href:""),n={},i="/";try{let g=new URL(t,"https://placeholder.com");i=g.pathname,g.searchParams.forEach((b,k)=>{n[k]=b})}catch{let g=t.split("?");g[0]&&(i=g[0].match(/^[^:]+:\/\/[^/]+(\/.*)?$/)?.[1]??"/"),g[1]&&g[1].split("&").forEach(b=>{let[k,P]=b.split("=");if(k&&P)try{n[decodeURIComponent(k)]=decodeURIComponent(P)}catch{n[k]=P}})}let o=n.slid??n.smartLinkId??null,a=n.cid??n.clickId??null;return delete n.slid,delete n.smartLinkId,delete n.cid,delete n.clickId,{url:t,path:i,parameters:n,smartLinkId:o,clickId:a}}addDeepLinkListener(e){return this.deepLinkListeners.add(e),()=>{this.deepLinkListeners.delete(e)}}removeAllListeners(){this.deepLinkListeners.clear()}destroy(){this.deepLinkListeners.clear(),typeof window<"u"&&this.popStateHandler&&window.removeEventListener("popstate",this.popStateHandler)}initUTM(){let e={utmSource:null,utmMedium:null,utmCampaign:null,utmTerm:null,utmContent:null};if(!this.config.autoExtractUTM)return e;let t=typeof window<"u"?new URLSearchParams(window.location.search):null;for(let{key:n,urlParam:i}of ne){let o=t?.get(i)??null;o?(e[n]=o,u(Q+i,o)):e[n]=p(Q+i)}return e.utmSource&&this.logger.debug("UTM parameters captured:",e),e}initReferrer(){if(!this.config.autoCaptureReferrer)return null;let e=p(E);if(e!==null)return e||null;let t=typeof document<"u"?document.referrer:"";if(t){try{let n=new URL(t).hostname,i=typeof window<"u"?window.location.hostname:"";if(n===i)return u(E,""),null}catch{}return u(E,t),this.logger.debug("Referrer captured:",t),t}return u(E,""),null}initLandingPage(){let e=p(J);if(e)return e;let t=typeof window<"u"?window.location.href:null;return t&&u(J,t),t}initSmartLinkParams(){if(typeof window>"u")return;let e=new URLSearchParams(window.location.search);this.smartLinkId=e.get("slid")??e.get("smartLinkId")??null,this.clickId=e.get("cid")??e.get("clickId")??null,this.smartLinkId&&this.logger.debug("Smart link ID captured:",this.smartLinkId)}setupSPATracking(){if(typeof window>"u")return;let e=history.pushState.bind(history),t=history.replaceState.bind(history),n=()=>{let i=this.parseDeepLink();this.deepLinkListeners.forEach(o=>{try{o(i)}catch(a){this.logger.error("Deep link listener error:",a)}})};history.pushState=(...i)=>{e(...i),n()},history.replaceState=(...i)=>{t(...i),n()},this.popStateHandler=n,window.addEventListener("popstate",this.popStateHandler)}};var _="visitor_id",M="user_id",A="tracking_enabled",v=class{constructor(){this.config=null;this.isConfigured=!1;this.scrollDepthHandler=null;this.maxScrollDepth=0;this.pageEntryTime=0;this.outboundClickHandler=null}configure(e,t=0,n){if(this.isConfigured){this.logger?.warn("SDK already configured, ignoring reconfiguration");return}this.config=N(e,t,n),this.logger=new y(this.config.debug),this.config.respectDNT&&this.isDNTEnabled()&&(this.logger.info("DNT/GPC detected \u2014 tracking disabled by default"),c(A,"false")),this.network=new S(this.config,this.logger),this.eventQueue=new T(this.config,this.logger,this.network),this.session=new I(this.config,this.logger),this.attribution=new D(this.config,this.logger),this.session.onSessionEvent((i,o)=>{i==="start"&&(this.logger.debug("Session started, auto-tracking open"),this.trackOpen().catch(a=>this.logger.error("Auto trackOpen failed:",a)))}),this.getVisitorID(),this.isConfigured=!0,this.logger.info(`SDK configured (env: ${f[t]}, key: ${e.substring(0,8)}...)`),this.session.isFirstVisit()&&(this.trackFirstVisit().catch(i=>this.logger.error("trackFirstVisit failed:",i)),this.session.markFirstVisitDone()),this.config.autoTrackPageViews&&this.trackPageView().catch(i=>this.logger.error("Auto trackPageView failed:",i)),this.setupScrollDepthTracking(),this.setupOutboundClickTracking(),this.pageEntryTime=Date.now()}async trackFirstVisit(){this.ensureConfigured();let e=this.buildPayload("install",null);this.eventQueue.enqueue(e),this.logger.info("First visit tracked")}async trackOpen(){this.ensureConfigured();let e=this.buildPayload("open",null);this.eventQueue.enqueue(e),this.logger.debug("App open tracked")}async trackPageView(e,t){this.ensureConfigured();let n=e??(typeof window<"u"?window.location.href:""),i=this.buildPayload("page_view","page_view",{page_url:n,page_title:typeof document<"u"?document.title:"",...t});this.eventQueue.enqueue(i),this.session.touch(),this.logger.debug("Page view tracked:",n)}async trackEvent(e,t){this.ensureConfigured();let n=this.buildPayload("custom",e,t);this.eventQueue.enqueue(n),this.session.touch(),this.logger.debug("Event tracked:",e)}async trackPurchase(e){this.ensureConfigured();let t=this.buildPayload("purchase","purchase",e);this.eventQueue.enqueue(t),this.session.touch(),this.logger.debug("Purchase tracked")}async trackEventBatch(e){this.ensureConfigured();for(let t of e){let n=this.buildPayload("custom",t.eventName,t.parameters);this.eventQueue.enqueue(n)}return this.session.touch(),this.logger.debug(`Batch of ${e.length} events queued`),!0}async flushEvents(){return this.ensureConfigured(),this.eventQueue.flush()}getPendingEventCount(){return this.ensureConfigured(),this.eventQueue.getPendingCount()}handleSmartLink(e){return this.ensureConfigured(),this.attribution.parseDeepLink(e)}addDeepLinkListener(e){return this.ensureConfigured(),this.attribution.addDeepLinkListener(e)}removeAllListeners(){this.attribution&&this.attribution.removeAllListeners()}setUserID(e){c(M,e),this.logger?.debug("User ID set:",e)}getUserID(){return h(M)}clearUserID(){q(M),this.logger?.debug("User ID cleared")}getVisitorID(){let e=h(_);return e||(e=l(),c(_,e),this.logger?.debug("New visitor ID generated:",e)),e}resetVisitorID(){let e=l();return c(_,e),this.logger?.debug("Visitor ID reset:",e),e}startSession(){return this.ensureConfigured(),this.session.startSession()}endSession(){this.ensureConfigured(),this.trackTimeOnPage(),this.session.endSession()}getSessionId(){return this.ensureConfigured(),this.session.getSessionId()}setTrackingEnabled(e){c(A,String(e)),this.logger?.info("Tracking",e?"enabled":"disabled")}isTrackingEnabled(){return h(A)!=="false"}setupScrollDepthTracking(){typeof window>"u"||typeof document>"u"||(this.maxScrollDepth=0,this.scrollDepthHandler=()=>{let e=window.scrollY||document.documentElement.scrollTop,t=Math.max(document.body.scrollHeight,document.documentElement.scrollHeight)-window.innerHeight;if(t<=0)return;let n=Math.round(e/t*100);n>this.maxScrollDepth&&(this.maxScrollDepth=n)},window.addEventListener("scroll",this.scrollDepthHandler,{passive:!0}),window.addEventListener("beforeunload",()=>{if(this.maxScrollDepth>0&&this.isTrackingEnabled()){let e=this.buildPayload("custom","scroll_depth",{max_depth_percent:this.maxScrollDepth,page_url:window.location.href});this.network?.sendBeacon([e])}}))}trackTimeOnPage(){if(!this.pageEntryTime||!this.isTrackingEnabled())return;let e=Math.round((Date.now()-this.pageEntryTime)/1e3);if(e>0){let t=this.buildPayload("custom","time_on_page",{duration_seconds:e,page_url:typeof window<"u"?window.location.href:""});this.eventQueue?.enqueue(t)}}setupOutboundClickTracking(){typeof document>"u"||typeof window>"u"||(this.outboundClickHandler=e=>{let t=e.target?.closest?.("a");if(t?.href)try{let n=new URL(t.href).hostname,i=window.location.hostname;if(n!==i&&this.isTrackingEnabled()){let o=this.buildPayload("custom","outbound_click",{destination_url:t.href,link_text:t.textContent?.trim()?.substring(0,100)??"",page_url:window.location.href});this.eventQueue?.enqueue(o)}}catch{}},document.addEventListener("click",this.outboundClickHandler))}destroy(){this.trackTimeOnPage(),this.scrollDepthHandler&&typeof window<"u"&&(window.removeEventListener("scroll",this.scrollDepthHandler),this.scrollDepthHandler=null),this.outboundClickHandler&&typeof document<"u"&&(document.removeEventListener("click",this.outboundClickHandler),this.outboundClickHandler=null),this.eventQueue?.destroy(),this.session?.destroy(),this.attribution?.destroy(),this.isConfigured=!1,this.logger?.info("SDK destroyed")}ensureConfigured(){if(!this.isConfigured||!this.config)throw new Error("LinkzlySDK is not configured. Call LinkzlySDK.configure() first.")}buildPayload(e,t,n){if(!this.config)throw new Error("SDK not configured");if(!this.isTrackingEnabled())return{type:"sdk_event",sdkKey:this.config.sdkKey,eventType:e,eventName:t,appUserId:null,sessionId:"",visitorId:"",platform:"web",deviceFingerprint:{},deepLinkMatched:!1,deepLinkData:null,customData:null,utmSource:null,utmMedium:null,utmCampaign:null,utmTerm:null,utmContent:null,smartLinkId:null,clickId:null,timestamp:Date.now()};let i=z(),o=this.attribution.getUTM(),a=this.attribution.getAttributionData();return{type:"sdk_event",sdkKey:this.config.sdkKey,eventType:e,eventName:t,appUserId:this.getUserID(),sessionId:this.session.getSessionId(),visitorId:this.getVisitorID(),platform:"web",deviceFingerprint:O(i),deepLinkMatched:!!(a.smartLinkId||a.clickId),deepLinkData:a.smartLinkId||a.clickId?{...a.smartLinkId?{slid:a.smartLinkId}:{},...a.clickId?{cid:a.clickId}:{}}:null,customData:n??null,utmSource:o.utmSource,utmMedium:o.utmMedium,utmCampaign:o.utmCampaign,utmTerm:o.utmTerm,utmContent:o.utmContent,smartLinkId:a.smartLinkId,clickId:a.clickId,timestamp:Date.now()}}isDNTEnabled(){return typeof navigator>"u"?!1:navigator.doNotTrack==="1"||navigator.globalPrivacyControl===!0}};var s=new v,ie=s.configure.bind(s),re=s.trackFirstVisit.bind(s),se=s.trackOpen.bind(s),oe=s.trackPageView.bind(s),ae=s.trackEvent.bind(s),le=s.trackPurchase.bind(s),ue=s.trackEventBatch.bind(s),ce=s.flushEvents.bind(s),de=s.getPendingEventCount.bind(s),ge=s.handleSmartLink.bind(s),he=s.addDeepLinkListener.bind(s),pe=s.removeAllListeners.bind(s),fe=s.setUserID.bind(s),me=s.getUserID.bind(s),ve=s.clearUserID.bind(s),ke=s.getVisitorID.bind(s),be=s.resetVisitorID.bind(s),ye=s.startSession.bind(s),we=s.endSession.bind(s),Se=s.getSessionId.bind(s),Te=s.setTrackingEnabled.bind(s),Le=s.isTrackingEnabled.bind(s),Ie=s.destroy.bind(s),Ee=s;0&&(module.exports={Environment,LinkzlyWebSDK,addDeepLinkListener,clearUserID,configure,destroy,endSession,flushEvents,getPendingEventCount,getSessionId,getUserID,getVisitorID,handleSmartLink,isTrackingEnabled,removeAllListeners,resetVisitorID,setTrackingEnabled,setUserID,startSession,trackEvent,trackEventBatch,trackFirstVisit,trackOpen,trackPageView,trackPurchase});

package/dist/index.d.cts

@@ -0,0 +1,163 @@
+declare enum Environment {
+    PRODUCTION = 0,
+    STAGING = 1,
+    DEVELOPMENT = 2
+}
+interface LinkzlyWebConfig {
+    /** Auto-track page views on SPA navigation (default: false — industry standard opt-in) */
+    autoTrackPageViews?: boolean;
+    /** Auto-track session start/end via visibility API (default: true) */
+    autoTrackSessions?: boolean;
+    /** Auto-extract UTM parameters from URL (default: true) */
+    autoExtractUTM?: boolean;
+    /** Auto-capture referrer (default: true) */
+    autoCaptureReferrer?: boolean;
+    /** Respect navigator.doNotTrack / globalPrivacyControl (default: true) */
+    respectDNT?: boolean;
+    /** Event batch size before auto-flush (default: 20) */
+    batchSize?: number;
+    /** Flush interval in milliseconds (default: 30000) */
+    flushIntervalMs?: number;
+    /** Session timeout in milliseconds (default: 30000 — 30s, matching mobile SDKs) */
+    sessionTimeoutMs?: number;
+    /** Enable debug logging (default: false) */
+    debug?: boolean;
+}
+type EventType = 'install' | 'open' | 'page_view' | 'purchase' | 'custom';
+interface EventParameters {
+    [key: string]: string | number | boolean | null | undefined | EventParameters | Array<string | number | boolean>;
+}
+interface BatchEvent {
+    eventName: string;
+    parameters?: EventParameters;
+}
+interface TrackingPayload {
+    type: 'sdk_event';
+    sdkKey: string;
+    eventType: EventType;
+    eventName: string | null;
+    appUserId: string | null;
+    sessionId: string;
+    visitorId: string;
+    platform: 'web';
+    deviceFingerprint: Record<string, string | number | boolean | null>;
+    deepLinkMatched: boolean;
+    deepLinkData: Record<string, string> | null;
+    customData: EventParameters | null;
+    utmSource: string | null;
+    utmMedium: string | null;
+    utmCampaign: string | null;
+    utmTerm: string | null;
+    utmContent: string | null;
+    smartLinkId: string | null;
+    clickId: string | null;
+    timestamp: number;
+}
+interface DeepLinkData {
+    url: string;
+    path: string;
+    parameters: Record<string, string>;
+    smartLinkId: string | null;
+    clickId: string | null;
+}
+type DeepLinkListener = (data: DeepLinkData) => void;
+interface UTMParameters {
+    utmSource: string | null;
+    utmMedium: string | null;
+    utmCampaign: string | null;
+    utmTerm: string | null;
+    utmContent: string | null;
+}
+interface AttributionData {
+    utm: UTMParameters;
+    referrer: string | null;
+    smartLinkId: string | null;
+    clickId: string | null;
+    landingPage: string | null;
+}
+interface BrowserFingerprint {
+    userAgent: string;
+    language: string;
+    languages: string;
+    screenSize: string;
+    viewportSize: string;
+    timezone: string;
+    timezoneOffset: number;
+    colorDepth: number;
+    pixelRatio: number;
+    platform: string;
+    cookiesEnabled: boolean;
+    online: boolean;
+    referrer: string;
+    pageUrl: string;
+}
+
+declare class LinkzlyWebSDK {
+    private config;
+    private logger;
+    private network;
+    private eventQueue;
+    private session;
+    private attribution;
+    private isConfigured;
+    private scrollDepthHandler;
+    private maxScrollDepth;
+    private pageEntryTime;
+    private outboundClickHandler;
+    configure(sdkKey: string, environment?: Environment, options?: LinkzlyWebConfig): void;
+    trackFirstVisit(): Promise<void>;
+    trackOpen(): Promise<void>;
+    trackPageView(pageUrl?: string, params?: EventParameters): Promise<void>;
+    trackEvent(eventName: string, parameters?: EventParameters): Promise<void>;
+    trackPurchase(parameters?: EventParameters): Promise<void>;
+    trackEventBatch(events: BatchEvent[]): Promise<boolean>;
+    flushEvents(): Promise<boolean>;
+    getPendingEventCount(): number;
+    handleSmartLink(url?: string): DeepLinkData;
+    addDeepLinkListener(listener: DeepLinkListener): () => void;
+    removeAllListeners(): void;
+    setUserID(userID: string): void;
+    getUserID(): string | null;
+    clearUserID(): void;
+    getVisitorID(): string;
+    resetVisitorID(): string;
+    startSession(): string;
+    endSession(): void;
+    getSessionId(): string;
+    setTrackingEnabled(enabled: boolean): void;
+    isTrackingEnabled(): boolean;
+    private setupScrollDepthTracking;
+    private trackTimeOnPage;
+    private setupOutboundClickTracking;
+    destroy(): void;
+    private ensureConfigured;
+    private buildPayload;
+    private isDNTEnabled;
+}
+
+declare const instance: LinkzlyWebSDK;
+declare const configure: (sdkKey: string, environment?: Environment, options?: LinkzlyWebConfig) => void;
+declare const trackFirstVisit: () => Promise<void>;
+declare const trackOpen: () => Promise<void>;
+declare const trackPageView: (pageUrl?: string, params?: EventParameters) => Promise<void>;
+declare const trackEvent: (eventName: string, parameters?: EventParameters) => Promise<void>;
+declare const trackPurchase: (parameters?: EventParameters) => Promise<void>;
+declare const trackEventBatch: (events: BatchEvent[]) => Promise<boolean>;
+declare const flushEvents: () => Promise<boolean>;
+declare const getPendingEventCount: () => number;
+declare const handleSmartLink: (url?: string) => DeepLinkData;
+declare const addDeepLinkListener: (listener: DeepLinkListener) => () => void;
+declare const removeAllListeners: () => void;
+declare const setUserID: (userID: string) => void;
+declare const getUserID: () => string | null;
+declare const clearUserID: () => void;
+declare const getVisitorID: () => string;
+declare const resetVisitorID: () => string;
+declare const startSession: () => string;
+declare const endSession: () => void;
+declare const getSessionId: () => string;
+declare const setTrackingEnabled: (enabled: boolean) => void;
+declare const isTrackingEnabled: () => boolean;
+declare const destroy: () => void;
+
+export { type AttributionData, type BatchEvent, type BrowserFingerprint, type DeepLinkData, type DeepLinkListener, Environment, type EventParameters, type EventType, type LinkzlyWebConfig, LinkzlyWebSDK, type TrackingPayload, type UTMParameters, addDeepLinkListener, clearUserID, configure, instance as default, destroy, endSession, flushEvents, getPendingEventCount, getSessionId, getUserID, getVisitorID, handleSmartLink, isTrackingEnabled, removeAllListeners, resetVisitorID, setTrackingEnabled, setUserID, startSession, trackEvent, trackEventBatch, trackFirstVisit, trackOpen, trackPageView, trackPurchase };

package/dist/index.d.ts

@@ -0,0 +1,163 @@
+declare enum Environment {
+    PRODUCTION = 0,
+    STAGING = 1,
+    DEVELOPMENT = 2
+}
+interface LinkzlyWebConfig {
+    /** Auto-track page views on SPA navigation (default: false — industry standard opt-in) */
+    autoTrackPageViews?: boolean;
+    /** Auto-track session start/end via visibility API (default: true) */
+    autoTrackSessions?: boolean;
+    /** Auto-extract UTM parameters from URL (default: true) */
+    autoExtractUTM?: boolean;
+    /** Auto-capture referrer (default: true) */
+    autoCaptureReferrer?: boolean;
+    /** Respect navigator.doNotTrack / globalPrivacyControl (default: true) */
+    respectDNT?: boolean;
+    /** Event batch size before auto-flush (default: 20) */
+    batchSize?: number;
+    /** Flush interval in milliseconds (default: 30000) */
+    flushIntervalMs?: number;
+    /** Session timeout in milliseconds (default: 30000 — 30s, matching mobile SDKs) */
+    sessionTimeoutMs?: number;
+    /** Enable debug logging (default: false) */
+    debug?: boolean;
+}
+type EventType = 'install' | 'open' | 'page_view' | 'purchase' | 'custom';
+interface EventParameters {
+    [key: string]: string | number | boolean | null | undefined | EventParameters | Array<string | number | boolean>;
+}
+interface BatchEvent {
+    eventName: string;
+    parameters?: EventParameters;
+}
+interface TrackingPayload {
+    type: 'sdk_event';
+    sdkKey: string;
+    eventType: EventType;
+    eventName: string | null;
+    appUserId: string | null;
+    sessionId: string;
+    visitorId: string;
+    platform: 'web';
+    deviceFingerprint: Record<string, string | number | boolean | null>;
+    deepLinkMatched: boolean;
+    deepLinkData: Record<string, string> | null;
+    customData: EventParameters | null;
+    utmSource: string | null;
+    utmMedium: string | null;
+    utmCampaign: string | null;
+    utmTerm: string | null;
+    utmContent: string | null;
+    smartLinkId: string | null;
+    clickId: string | null;
+    timestamp: number;
+}
+interface DeepLinkData {
+    url: string;
+    path: string;
+    parameters: Record<string, string>;
+    smartLinkId: string | null;
+    clickId: string | null;
+}
+type DeepLinkListener = (data: DeepLinkData) => void;
+interface UTMParameters {
+    utmSource: string | null;
+    utmMedium: string | null;
+    utmCampaign: string | null;
+    utmTerm: string | null;
+    utmContent: string | null;
+}
+interface AttributionData {
+    utm: UTMParameters;
+    referrer: string | null;
+    smartLinkId: string | null;
+    clickId: string | null;
+    landingPage: string | null;
+}
+interface BrowserFingerprint {
+    userAgent: string;
+    language: string;
+    languages: string;
+    screenSize: string;
+    viewportSize: string;
+    timezone: string;
+    timezoneOffset: number;
+    colorDepth: number;
+    pixelRatio: number;
+    platform: string;
+    cookiesEnabled: boolean;
+    online: boolean;
+    referrer: string;
+    pageUrl: string;
+}
+
+declare class LinkzlyWebSDK {
+    private config;
+    private logger;
+    private network;
+    private eventQueue;
+    private session;
+    private attribution;
+    private isConfigured;
+    private scrollDepthHandler;
+    private maxScrollDepth;
+    private pageEntryTime;
+    private outboundClickHandler;
+    configure(sdkKey: string, environment?: Environment, options?: LinkzlyWebConfig): void;
+    trackFirstVisit(): Promise<void>;
+    trackOpen(): Promise<void>;
+    trackPageView(pageUrl?: string, params?: EventParameters): Promise<void>;
+    trackEvent(eventName: string, parameters?: EventParameters): Promise<void>;
+    trackPurchase(parameters?: EventParameters): Promise<void>;
+    trackEventBatch(events: BatchEvent[]): Promise<boolean>;
+    flushEvents(): Promise<boolean>;
+    getPendingEventCount(): number;
+    handleSmartLink(url?: string): DeepLinkData;
+    addDeepLinkListener(listener: DeepLinkListener): () => void;
+    removeAllListeners(): void;
+    setUserID(userID: string): void;
+    getUserID(): string | null;
+    clearUserID(): void;
+    getVisitorID(): string;
+    resetVisitorID(): string;
+    startSession(): string;
+    endSession(): void;
+    getSessionId(): string;
+    setTrackingEnabled(enabled: boolean): void;
+    isTrackingEnabled(): boolean;
+    private setupScrollDepthTracking;
+    private trackTimeOnPage;
+    private setupOutboundClickTracking;
+    destroy(): void;
+    private ensureConfigured;
+    private buildPayload;
+    private isDNTEnabled;
+}
+
+declare const instance: LinkzlyWebSDK;
+declare const configure: (sdkKey: string, environment?: Environment, options?: LinkzlyWebConfig) => void;
+declare const trackFirstVisit: () => Promise<void>;
+declare const trackOpen: () => Promise<void>;
+declare const trackPageView: (pageUrl?: string, params?: EventParameters) => Promise<void>;
+declare const trackEvent: (eventName: string, parameters?: EventParameters) => Promise<void>;
+declare const trackPurchase: (parameters?: EventParameters) => Promise<void>;
+declare const trackEventBatch: (events: BatchEvent[]) => Promise<boolean>;
+declare const flushEvents: () => Promise<boolean>;
+declare const getPendingEventCount: () => number;
+declare const handleSmartLink: (url?: string) => DeepLinkData;
+declare const addDeepLinkListener: (listener: DeepLinkListener) => () => void;
+declare const removeAllListeners: () => void;
+declare const setUserID: (userID: string) => void;
+declare const getUserID: () => string | null;
+declare const clearUserID: () => void;
+declare const getVisitorID: () => string;
+declare const resetVisitorID: () => string;
+declare const startSession: () => string;
+declare const endSession: () => void;
+declare const getSessionId: () => string;
+declare const setTrackingEnabled: (enabled: boolean) => void;
+declare const isTrackingEnabled: () => boolean;
+declare const destroy: () => void;
+
+export { type AttributionData, type BatchEvent, type BrowserFingerprint, type DeepLinkData, type DeepLinkListener, Environment, type EventParameters, type EventType, type LinkzlyWebConfig, LinkzlyWebSDK, type TrackingPayload, type UTMParameters, addDeepLinkListener, clearUserID, configure, instance as default, destroy, endSession, flushEvents, getPendingEventCount, getSessionId, getUserID, getVisitorID, handleSmartLink, isTrackingEnabled, removeAllListeners, resetVisitorID, setTrackingEnabled, setUserID, startSession, trackEvent, trackEventBatch, trackFirstVisit, trackOpen, trackPageView, trackPurchase };

package/dist/index.js

@@ -0,0 +1 @@
+var v=(n=>(n[n.PRODUCTION=0]="PRODUCTION",n[n.STAGING=1]="STAGING",n[n.DEVELOPMENT=2]="DEVELOPMENT",n))(v||{});var J={0:"https://ske.linkzly.com",1:"https://ske-staging.linkzly.com",2:"https://ske-dev.linkzly.com"},d={autoTrackPageViews:!1,autoTrackSessions:!0,autoExtractUTM:!0,autoCaptureReferrer:!0,respectDNT:!0,batchSize:20,flushIntervalMs:3e4,sessionTimeoutMs:3e4,debug:!1};function A(r,e,t){return{sdkKey:r,environment:e,baseURL:J[e],autoTrackPageViews:t?.autoTrackPageViews??d.autoTrackPageViews,autoTrackSessions:t?.autoTrackSessions??d.autoTrackSessions,autoExtractUTM:t?.autoExtractUTM??d.autoExtractUTM,autoCaptureReferrer:t?.autoCaptureReferrer??d.autoCaptureReferrer,respectDNT:t?.respectDNT??d.respectDNT,batchSize:t?.batchSize??d.batchSize,flushIntervalMs:t?.flushIntervalMs??d.flushIntervalMs,sessionTimeoutMs:t?.sessionTimeoutMs??d.sessionTimeoutMs,debug:t?.debug??e===2}}var y=class{constructor(e){this.enabled=e}info(...e){this.enabled&&console.log("[LinkzlySDK]",...e)}debug(...e){this.enabled&&console.debug("[LinkzlySDK]",...e)}warn(...e){this.enabled&&console.warn("[LinkzlySDK]",...e)}error(...e){console.error("[LinkzlySDK]",...e)}};function N(){let r=typeof navigator<"u"?navigator:null,e=typeof window<"u"?window:null,t=typeof document<"u"?document:null,n=typeof window<"u"?window.screen:null;return{userAgent:r?.userAgent??"unknown",language:r?.language??"unknown",languages:r?.languages?.join(",")??"",screenSize:n?`${n.width}x${n.height}`:"unknown",viewportSize:e?`${e.innerWidth}x${e.innerHeight}`:"unknown",timezone:Intl?.DateTimeFormat?.()?.resolvedOptions?.()?.timeZone??"unknown",timezoneOffset:new Date().getTimezoneOffset(),colorDepth:n?.colorDepth??0,pixelRatio:e?.devicePixelRatio??1,platform:r?.platform??"unknown",cookiesEnabled:r?.cookieEnabled??!1,online:r?.onLine??!0,referrer:t?.referrer??"",pageUrl:e?.location?.href??""}}function z(r){return{userAgent:r.userAgent,language:r.language,languages:r.languages,screenSize:r.screenSize,viewportSize:r.viewportSize,timezone:r.timezone,timezoneOffset:r.timezoneOffset,colorDepth:r.colorDepth,pixelRatio:r.pixelRatio,platform:r.platform,cookiesEnabled:r.cookiesEnabled,online:r.online,referrer:r.referrer,pageUrl:r.pageUrl}}function l(){return typeof crypto<"u"&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,r=>{let e=Math.random()*16|0;return(r==="x"?e:e&3|8).toString(16)})}function f(r){if(!r)return!1;try{let e="__lz_test__";return r.setItem(e,"1"),r.removeItem(e),!0}catch{return!1}}function h(r){if(typeof localStorage>"u"||!f(localStorage))return null;try{return localStorage.getItem("lz_"+r)}catch{return null}}function c(r,e){if(!(typeof localStorage>"u"||!f(localStorage)))try{localStorage.setItem("lz_"+r,e)}catch{}}function O(r){if(!(typeof localStorage>"u"||!f(localStorage)))try{localStorage.removeItem("lz_"+r)}catch{}}function p(r){if(typeof sessionStorage>"u"||!f(sessionStorage))return null;try{return sessionStorage.getItem("lz_"+r)}catch{return null}}function u(r,e){if(!(typeof sessionStorage>"u"||!f(sessionStorage)))try{sessionStorage.setItem("lz_"+r,e)}catch{}}function x(r){if(!(typeof sessionStorage>"u"||!f(sessionStorage)))try{sessionStorage.removeItem("lz_"+r)}catch{}}function q(r){let e=h(r);if(!e)return null;try{return JSON.parse(e)}catch{return null}}function B(r,e){try{c(r,JSON.stringify(e))}catch{}}var w=3,H=1e3,X="Bearer linkzly-production-shared-secret-key-2024-secure-min-64",S=class{constructor(e,t){this.config=e,this.logger=t}async sendEvent(e){let t=`${this.config.baseURL}/v1/sdk/events`;return this.logger.debug("Sending event:",e.eventType,e.eventName??""),this.postJSON(t,e)}async sendBatch(e){if(e.length===0)return{success:!0};let t=`${this.config.baseURL}/v1/sdk/events/batch`,n={type:"sdk_event",events:e,batchId:l(),clientTimestamp:Date.now()};return this.logger.debug(`Sending batch of ${e.length} events`),this.postJSON(t,n)}sendBeacon(e){if(e.length===0)return!0;if(typeof navigator>"u"||!navigator.sendBeacon)return!1;let t=`${this.config.baseURL}/v1/sdk/events/batch`,n={type:"sdk_event",events:e,batchId:l(),clientTimestamp:Date.now()};try{let i=new Blob([JSON.stringify(n)],{type:"application/json"}),o=navigator.sendBeacon(t,i);return this.logger.debug(`Beacon ${o?"accepted":"rejected"}: ${e.length} events`),o}catch(i){return this.logger.error("sendBeacon failed:",i),!1}}async postJSON(e,t,n=0){try{let i=await fetch(e,{method:"POST",headers:{"Content-Type":"application/json","X-Linkzly-SDK":"web/1.0.0",Authorization:X},body:JSON.stringify(t),keepalive:!0});if(!i.ok){if((i.status>=500||i.status===429)&&n<w){let a=H*Math.pow(2,n);return this.logger.warn(`HTTP ${i.status}, retrying in ${a}ms (attempt ${n+1}/${w})`),await this.sleep(a),this.postJSON(e,t,n+1)}return this.logger.error(`HTTP ${i.status}: ${i.statusText}`),{success:!1,message:`HTTP ${i.status}`}}let o=await i.json().catch(()=>({}));return this.logger.debug("Response:",i.status),{success:!0,...o}}catch(i){if(n<w){let o=H*Math.pow(2,n);return this.logger.warn(`Network error, retrying in ${o}ms (attempt ${n+1}/${w}):`,i),await this.sleep(o),this.postJSON(e,t,n+1)}return this.logger.error("Network request failed after retries:",i),{success:!1,message:String(i)}}}sleep(e){return new Promise(t=>setTimeout(t,e))}};var F="event_queue",R=500,V=100,T=class{constructor(e,t,n){this.queue=[];this.flushTimer=null;this.isFlushing=!1;this.config=e,this.logger=t,this.network=n,this.restoreQueue(),this.startFlushTimer(),typeof window<"u"&&(window.addEventListener("beforeunload",()=>this.flushBeacon()),document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&this.flushBeacon()}))}enqueue(e){let t={id:l(),payload:e,createdAt:Date.now(),retryCount:0};this.queue.push(t),this.queue.length>R&&(this.queue=this.queue.slice(-R)),this.persistQueue(),this.logger.debug(`Event queued (${this.queue.length} pending): ${e.eventType}/${e.eventName??""}`),this.queue.length>=this.config.batchSize&&this.flush().catch(n=>this.logger.error("Auto-flush failed:",n))}async flush(){if(this.isFlushing||this.queue.length===0)return!0;this.isFlushing=!0;try{let e=this.queue.slice(0,V),t=e.map(i=>i.payload);if((await this.network.sendBatch(t)).success){let i=new Set(e.map(o=>o.id));return this.queue=this.queue.filter(o=>!i.has(o.id)),this.persistQueue(),this.logger.debug(`Flushed ${e.length} events, ${this.queue.length} remaining`),!0}return this.logger.warn(`Batch send failed, ${this.queue.length} events remain in queue`),!1}finally{this.isFlushing=!1}}getPendingCount(){return this.queue.length}destroy(){this.flushTimer&&(clearInterval(this.flushTimer),this.flushTimer=null)}startFlushTimer(){this.flushTimer||(this.flushTimer=setInterval(()=>{this.flush().catch(e=>this.logger.error("Periodic flush failed:",e))},this.config.flushIntervalMs))}flushBeacon(){if(this.queue.length===0)return;let e=this.queue.slice(0,V),t=e.map(i=>i.payload);if(this.network.sendBeacon(t)){let i=new Set(e.map(o=>o.id));this.queue=this.queue.filter(o=>!i.has(o.id)),this.persistQueue()}}persistQueue(){let e=this.queue.slice(-R);B(F,e)}restoreQueue(){let e=q(F);if(e&&Array.isArray(e)){let t=Date.now()-864e5;this.queue=e.filter(n=>n.createdAt>t),this.queue.length!==e.length&&(this.logger.debug(`Pruned ${e.length-this.queue.length} expired events from queue`),this.persistQueue()),this.queue.length>0&&this.logger.debug(`Restored ${this.queue.length} queued events from storage`)}}};var C="session_id",L="session_last_active",$="first_visit_done",I=class{constructor(e,t){this.callback=null;this.visibilityHandler=null;this.config=e,this.logger=t,this.lastActiveTime=Date.now();let n=p(C),i=p(L);n&&i?Date.now()-parseInt(i,10)<this.config.sessionTimeoutMs?(this.sessionId=n,this.lastActiveTime=parseInt(i,10),this.logger.debug("Resumed session:",this.sessionId)):this.sessionId=this.createNewSession():this.sessionId=this.createNewSession(),this.config.autoTrackSessions&&this.setupVisibilityTracking()}getSessionId(){return this.sessionId}isFirstVisit(){return h($)===null}markFirstVisitDone(){c($,String(Date.now()))}onSessionEvent(e){this.callback=e}touch(){this.lastActiveTime=Date.now(),u(L,String(this.lastActiveTime))}startSession(){return this.callback&&this.callback("end",this.sessionId),this.sessionId=this.createNewSession(),this.sessionId}endSession(){this.callback&&this.callback("end",this.sessionId),x(C),x(L)}destroy(){this.visibilityHandler&&typeof document<"u"&&(document.removeEventListener("visibilitychange",this.visibilityHandler),this.visibilityHandler=null)}createNewSession(){let e=l();return u(C,e),this.lastActiveTime=Date.now(),u(L,String(this.lastActiveTime)),this.logger.debug("New session started:",e),this.callback&&this.callback("start",e),e}setupVisibilityTracking(){typeof document>"u"||(this.visibilityHandler=()=>{if(document.visibilityState==="visible"){let e=Date.now()-this.lastActiveTime;e>=this.config.sessionTimeoutMs?(this.logger.debug(`Session timeout (${Math.round(e/1e3)}s idle), starting new session`),this.sessionId=this.createNewSession()):this.touch()}else this.touch()},document.addEventListener("visibilitychange",this.visibilityHandler))}};var K="utm_",E="referrer",Q="landing_page",Y=[{key:"utmSource",urlParam:"utm_source"},{key:"utmMedium",urlParam:"utm_medium"},{key:"utmCampaign",urlParam:"utm_campaign"},{key:"utmTerm",urlParam:"utm_term"},{key:"utmContent",urlParam:"utm_content"}],D=class{constructor(e,t){this.smartLinkId=null;this.clickId=null;this.deepLinkListeners=new Set;this.popStateHandler=null;this.config=e,this.logger=t,this.utm=this.initUTM(),this.referrer=this.initReferrer(),this.landingPage=this.initLandingPage(),this.initSmartLinkParams(),this.config.autoTrackPageViews&&this.setupSPATracking()}getUTM(){return{...this.utm}}getReferrer(){return this.referrer}getLandingPage(){return this.landingPage}getSmartLinkId(){return this.smartLinkId}getClickId(){return this.clickId}getAttributionData(){return{utm:this.getUTM(),referrer:this.referrer,smartLinkId:this.smartLinkId,clickId:this.clickId,landingPage:this.landingPage}}parseDeepLink(e){let t=e??(typeof window<"u"?window.location.href:""),n={},i="/";try{let g=new URL(t,"https://placeholder.com");i=g.pathname,g.searchParams.forEach((b,m)=>{n[m]=b})}catch{let g=t.split("?");g[0]&&(i=g[0].match(/^[^:]+:\/\/[^/]+(\/.*)?$/)?.[1]??"/"),g[1]&&g[1].split("&").forEach(b=>{let[m,P]=b.split("=");if(m&&P)try{n[decodeURIComponent(m)]=decodeURIComponent(P)}catch{n[m]=P}})}let o=n.slid??n.smartLinkId??null,a=n.cid??n.clickId??null;return delete n.slid,delete n.smartLinkId,delete n.cid,delete n.clickId,{url:t,path:i,parameters:n,smartLinkId:o,clickId:a}}addDeepLinkListener(e){return this.deepLinkListeners.add(e),()=>{this.deepLinkListeners.delete(e)}}removeAllListeners(){this.deepLinkListeners.clear()}destroy(){this.deepLinkListeners.clear(),typeof window<"u"&&this.popStateHandler&&window.removeEventListener("popstate",this.popStateHandler)}initUTM(){let e={utmSource:null,utmMedium:null,utmCampaign:null,utmTerm:null,utmContent:null};if(!this.config.autoExtractUTM)return e;let t=typeof window<"u"?new URLSearchParams(window.location.search):null;for(let{key:n,urlParam:i}of Y){let o=t?.get(i)??null;o?(e[n]=o,u(K+i,o)):e[n]=p(K+i)}return e.utmSource&&this.logger.debug("UTM parameters captured:",e),e}initReferrer(){if(!this.config.autoCaptureReferrer)return null;let e=p(E);if(e!==null)return e||null;let t=typeof document<"u"?document.referrer:"";if(t){try{let n=new URL(t).hostname,i=typeof window<"u"?window.location.hostname:"";if(n===i)return u(E,""),null}catch{}return u(E,t),this.logger.debug("Referrer captured:",t),t}return u(E,""),null}initLandingPage(){let e=p(Q);if(e)return e;let t=typeof window<"u"?window.location.href:null;return t&&u(Q,t),t}initSmartLinkParams(){if(typeof window>"u")return;let e=new URLSearchParams(window.location.search);this.smartLinkId=e.get("slid")??e.get("smartLinkId")??null,this.clickId=e.get("cid")??e.get("clickId")??null,this.smartLinkId&&this.logger.debug("Smart link ID captured:",this.smartLinkId)}setupSPATracking(){if(typeof window>"u")return;let e=history.pushState.bind(history),t=history.replaceState.bind(history),n=()=>{let i=this.parseDeepLink();this.deepLinkListeners.forEach(o=>{try{o(i)}catch(a){this.logger.error("Deep link listener error:",a)}})};history.pushState=(...i)=>{e(...i),n()},history.replaceState=(...i)=>{t(...i),n()},this.popStateHandler=n,window.addEventListener("popstate",this.popStateHandler)}};var U="visitor_id",_="user_id",M="tracking_enabled",k=class{constructor(){this.config=null;this.isConfigured=!1;this.scrollDepthHandler=null;this.maxScrollDepth=0;this.pageEntryTime=0;this.outboundClickHandler=null}configure(e,t=0,n){if(this.isConfigured){this.logger?.warn("SDK already configured, ignoring reconfiguration");return}this.config=A(e,t,n),this.logger=new y(this.config.debug),this.config.respectDNT&&this.isDNTEnabled()&&(this.logger.info("DNT/GPC detected \u2014 tracking disabled by default"),c(M,"false")),this.network=new S(this.config,this.logger),this.eventQueue=new T(this.config,this.logger,this.network),this.session=new I(this.config,this.logger),this.attribution=new D(this.config,this.logger),this.session.onSessionEvent((i,o)=>{i==="start"&&(this.logger.debug("Session started, auto-tracking open"),this.trackOpen().catch(a=>this.logger.error("Auto trackOpen failed:",a)))}),this.getVisitorID(),this.isConfigured=!0,this.logger.info(`SDK configured (env: ${v[t]}, key: ${e.substring(0,8)}...)`),this.session.isFirstVisit()&&(this.trackFirstVisit().catch(i=>this.logger.error("trackFirstVisit failed:",i)),this.session.markFirstVisitDone()),this.config.autoTrackPageViews&&this.trackPageView().catch(i=>this.logger.error("Auto trackPageView failed:",i)),this.setupScrollDepthTracking(),this.setupOutboundClickTracking(),this.pageEntryTime=Date.now()}async trackFirstVisit(){this.ensureConfigured();let e=this.buildPayload("install",null);this.eventQueue.enqueue(e),this.logger.info("First visit tracked")}async trackOpen(){this.ensureConfigured();let e=this.buildPayload("open",null);this.eventQueue.enqueue(e),this.logger.debug("App open tracked")}async trackPageView(e,t){this.ensureConfigured();let n=e??(typeof window<"u"?window.location.href:""),i=this.buildPayload("page_view","page_view",{page_url:n,page_title:typeof document<"u"?document.title:"",...t});this.eventQueue.enqueue(i),this.session.touch(),this.logger.debug("Page view tracked:",n)}async trackEvent(e,t){this.ensureConfigured();let n=this.buildPayload("custom",e,t);this.eventQueue.enqueue(n),this.session.touch(),this.logger.debug("Event tracked:",e)}async trackPurchase(e){this.ensureConfigured();let t=this.buildPayload("purchase","purchase",e);this.eventQueue.enqueue(t),this.session.touch(),this.logger.debug("Purchase tracked")}async trackEventBatch(e){this.ensureConfigured();for(let t of e){let n=this.buildPayload("custom",t.eventName,t.parameters);this.eventQueue.enqueue(n)}return this.session.touch(),this.logger.debug(`Batch of ${e.length} events queued`),!0}async flushEvents(){return this.ensureConfigured(),this.eventQueue.flush()}getPendingEventCount(){return this.ensureConfigured(),this.eventQueue.getPendingCount()}handleSmartLink(e){return this.ensureConfigured(),this.attribution.parseDeepLink(e)}addDeepLinkListener(e){return this.ensureConfigured(),this.attribution.addDeepLinkListener(e)}removeAllListeners(){this.attribution&&this.attribution.removeAllListeners()}setUserID(e){c(_,e),this.logger?.debug("User ID set:",e)}getUserID(){return h(_)}clearUserID(){O(_),this.logger?.debug("User ID cleared")}getVisitorID(){let e=h(U);return e||(e=l(),c(U,e),this.logger?.debug("New visitor ID generated:",e)),e}resetVisitorID(){let e=l();return c(U,e),this.logger?.debug("Visitor ID reset:",e),e}startSession(){return this.ensureConfigured(),this.session.startSession()}endSession(){this.ensureConfigured(),this.trackTimeOnPage(),this.session.endSession()}getSessionId(){return this.ensureConfigured(),this.session.getSessionId()}setTrackingEnabled(e){c(M,String(e)),this.logger?.info("Tracking",e?"enabled":"disabled")}isTrackingEnabled(){return h(M)!=="false"}setupScrollDepthTracking(){typeof window>"u"||typeof document>"u"||(this.maxScrollDepth=0,this.scrollDepthHandler=()=>{let e=window.scrollY||document.documentElement.scrollTop,t=Math.max(document.body.scrollHeight,document.documentElement.scrollHeight)-window.innerHeight;if(t<=0)return;let n=Math.round(e/t*100);n>this.maxScrollDepth&&(this.maxScrollDepth=n)},window.addEventListener("scroll",this.scrollDepthHandler,{passive:!0}),window.addEventListener("beforeunload",()=>{if(this.maxScrollDepth>0&&this.isTrackingEnabled()){let e=this.buildPayload("custom","scroll_depth",{max_depth_percent:this.maxScrollDepth,page_url:window.location.href});this.network?.sendBeacon([e])}}))}trackTimeOnPage(){if(!this.pageEntryTime||!this.isTrackingEnabled())return;let e=Math.round((Date.now()-this.pageEntryTime)/1e3);if(e>0){let t=this.buildPayload("custom","time_on_page",{duration_seconds:e,page_url:typeof window<"u"?window.location.href:""});this.eventQueue?.enqueue(t)}}setupOutboundClickTracking(){typeof document>"u"||typeof window>"u"||(this.outboundClickHandler=e=>{let t=e.target?.closest?.("a");if(t?.href)try{let n=new URL(t.href).hostname,i=window.location.hostname;if(n!==i&&this.isTrackingEnabled()){let o=this.buildPayload("custom","outbound_click",{destination_url:t.href,link_text:t.textContent?.trim()?.substring(0,100)??"",page_url:window.location.href});this.eventQueue?.enqueue(o)}}catch{}},document.addEventListener("click",this.outboundClickHandler))}destroy(){this.trackTimeOnPage(),this.scrollDepthHandler&&typeof window<"u"&&(window.removeEventListener("scroll",this.scrollDepthHandler),this.scrollDepthHandler=null),this.outboundClickHandler&&typeof document<"u"&&(document.removeEventListener("click",this.outboundClickHandler),this.outboundClickHandler=null),this.eventQueue?.destroy(),this.session?.destroy(),this.attribution?.destroy(),this.isConfigured=!1,this.logger?.info("SDK destroyed")}ensureConfigured(){if(!this.isConfigured||!this.config)throw new Error("LinkzlySDK is not configured. Call LinkzlySDK.configure() first.")}buildPayload(e,t,n){if(!this.config)throw new Error("SDK not configured");if(!this.isTrackingEnabled())return{type:"sdk_event",sdkKey:this.config.sdkKey,eventType:e,eventName:t,appUserId:null,sessionId:"",visitorId:"",platform:"web",deviceFingerprint:{},deepLinkMatched:!1,deepLinkData:null,customData:null,utmSource:null,utmMedium:null,utmCampaign:null,utmTerm:null,utmContent:null,smartLinkId:null,clickId:null,timestamp:Date.now()};let i=N(),o=this.attribution.getUTM(),a=this.attribution.getAttributionData();return{type:"sdk_event",sdkKey:this.config.sdkKey,eventType:e,eventName:t,appUserId:this.getUserID(),sessionId:this.session.getSessionId(),visitorId:this.getVisitorID(),platform:"web",deviceFingerprint:z(i),deepLinkMatched:!!(a.smartLinkId||a.clickId),deepLinkData:a.smartLinkId||a.clickId?{...a.smartLinkId?{slid:a.smartLinkId}:{},...a.clickId?{cid:a.clickId}:{}}:null,customData:n??null,utmSource:o.utmSource,utmMedium:o.utmMedium,utmCampaign:o.utmCampaign,utmTerm:o.utmTerm,utmContent:o.utmContent,smartLinkId:a.smartLinkId,clickId:a.clickId,timestamp:Date.now()}}isDNTEnabled(){return typeof navigator>"u"?!1:navigator.doNotTrack==="1"||navigator.globalPrivacyControl===!0}};var s=new k,Te=s.configure.bind(s),Le=s.trackFirstVisit.bind(s),Ie=s.trackOpen.bind(s),Ee=s.trackPageView.bind(s),De=s.trackEvent.bind(s),Pe=s.trackPurchase.bind(s),xe=s.trackEventBatch.bind(s),Re=s.flushEvents.bind(s),Ce=s.getPendingEventCount.bind(s),Ue=s.handleSmartLink.bind(s),_e=s.addDeepLinkListener.bind(s),Me=s.removeAllListeners.bind(s),Ae=s.setUserID.bind(s),Ne=s.getUserID.bind(s),ze=s.clearUserID.bind(s),Oe=s.getVisitorID.bind(s),qe=s.resetVisitorID.bind(s),Be=s.startSession.bind(s),He=s.endSession.bind(s),Fe=s.getSessionId.bind(s),Ve=s.setTrackingEnabled.bind(s),$e=s.isTrackingEnabled.bind(s),Ke=s.destroy.bind(s),Qe=s;export{v as Environment,k as LinkzlyWebSDK,_e as addDeepLinkListener,ze as clearUserID,Te as configure,Qe as default,Ke as destroy,He as endSession,Re as flushEvents,Ce as getPendingEventCount,Fe as getSessionId,Ne as getUserID,Oe as getVisitorID,Ue as handleSmartLink,$e as isTrackingEnabled,Me as removeAllListeners,qe as resetVisitorID,Ve as setTrackingEnabled,Ae as setUserID,Be as startSession,De as trackEvent,xe as trackEventBatch,Le as trackFirstVisit,Ie as trackOpen,Ee as trackPageView,Pe as trackPurchase};

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@linkzly/web-sdk",
+  "version": "1.0.0",
+  "description": "Full-featured browser SDK for Linkzly — event tracking, attribution, sessions, deep linking, and affiliate tracking",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --minify",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  },
+  "keywords": [
+    "linkzly",
+    "analytics",
+    "attribution",
+    "tracking",
+    "deep-linking",
+    "affiliate",
+    "events",
+    "sessions",
+    "web-sdk"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/linkzly/linkzly-sdks"
+  }
+}