@zaplier/sdk 1.8.2 → 1.8.4

package/dist/v2/core.d.ts

@@ -1,7 +1,278 @@
+/**
+ * Visitor-related types for SDK responses
+ */
+/**
+ * Visitor information returned by getVisitorInfo()
+ */
+interface VisitorInfo {
+    visitorId: string;
+    workspaceId: string;
+    location: {
+        country?: string;
+        countryCode?: string;
+        city?: string;
+    };
+    device: {
+        browser?: string;
+        os?: string;
+        deviceType?: string;
+        userAgent?: string;
+    };
+    stats: {
+        visitCount: number;
+        firstSeenAt: string;
+        lastSeenAt: string;
+        identificationScore?: number;
+    };
+    signals?: {
+        smartSignals?: any;
+        tlsFingerprint?: string | null;
+        cookieFingerprint?: string | null;
+    };
+}
+/**
+ * Visit history entry
+ */
+interface VisitHistoryEntry {
+    id: string;
+    timestamp: string;
+    location: string | null;
+    country?: string | null;
+    countryCode?: string | null;
+    city?: string | null;
+    ip: string | null;
+    browser: string | null;
+    os: string | null;
+    deviceType: string | null;
+    isIncognito: boolean;
+    vpnDetected: boolean;
+    suspectScore: number;
+}
+/**
+ * Visitor history response
+ */
+interface VisitorHistory {
+    visitorId: string;
+    visits: VisitHistoryEntry[];
+    summary: {
+        totalVisits: number;
+        uniqueIPs: number;
+        uniqueLocations: number;
+        incognitoSessions: number;
+    };
+}
+/**
+ * User data returned by getUserData()
+ */
+interface UserData {
+    sessionId: string;
+    visitorId?: string;
+    userId?: string;
+    location: {
+        city?: string;
+        country?: string;
+        coordinates?: {
+            lat: number;
+            lng: number;
+        };
+    };
+    device: {
+        userAgent: string;
+        language: string;
+        screen: {
+            width: number;
+            height: number;
+        };
+    };
+    journey: any[];
+    fingerprint?: string;
+}
+
+/**
+ * SDK Configuration Types
+ *
+ * 100% Cookieless tracking using fingerprinting only.
+ * No storage dependencies - fully GDPR/LGPD compliant.
+ */
+interface SDKConfig {
+    /** Workspace token (required) */
+    token: string;
+    /** Enable session replay recording (default: false) */
+    replay?: boolean;
+    /** Enable heatmap tracking (default: false) */
+    heatmap?: boolean;
+    /** Enable debug mode for development (default: false) */
+    debug?: boolean;
+    /** Allow tracking on localhost (default: false) */
+    allow_localhost?: boolean;
+    /** GDPR mode - limits invasive fingerprinting (default: false) */
+    gdprMode?: boolean;
+}
+/**
+ * Internal configuration with optimized defaults
+ * These settings are not exposed to the user but can be referenced internally
+ */
+interface InternalConfig extends SDKConfig {
+    apiEndpoint: string;
+    retryEnabled: boolean;
+    maxRetries: number;
+    retryDelays: number[];
+    autoTrack: boolean;
+    dedupeEnabled: boolean;
+    fingerprintEnabled: boolean;
+    presenceTracking: boolean;
+    heartbeatInterval: number;
+    scrollTracking: boolean;
+    scrollDepthTracking: boolean;
+    gdprCompliant: boolean;
+    enhancedTracking: 'ask' | 'true' | 'false';
+    replaySampling: number;
+    replayMaskInputs: boolean;
+}
+
+/**
+ * Event and Tracking Types
+ */
+interface BaseEventData {
+    eventType: string;
+    eventName?: string;
+    customData?: Record<string, any>;
+}
+interface PageViewEvent extends BaseEventData {
+    eventType: 'page_view';
+    url?: string;
+    pageTitle?: string;
+    referrer?: string;
+    spaNavigation?: boolean;
+    navigationType?: 'manual' | 'spa' | 'direct';
+}
+
+/**
+ * Method parameter types for SDK calls
+ */
+/**
+ * Parameters for trackPurchase()
+ */
+interface TrackPurchaseParams {
+    value?: number;
+    revenue?: number;
+    currency?: string;
+    quantity?: number;
+    productId?: string;
+    productName?: string;
+    orderId?: string;
+    customData?: Record<string, any>;
+}
+/**
+ * Parameters for trackAddToCart()
+ */
+interface TrackAddToCartParams {
+    productId?: string;
+    productName?: string;
+    price?: number;
+    quantity?: number;
+    customData?: Record<string, any>;
+}
+/**
+ * Parameters for trackViewContent()
+ */
+interface TrackViewContentParams {
+    productId?: string;
+    productName?: string;
+    category?: string;
+    customData?: Record<string, any>;
+}
+/**
+ * Parameters for trackInitiateCheckout()
+ */
+interface TrackInitiateCheckoutParams {
+    value?: number;
+    currency?: string;
+    numItems?: number;
+    customData?: Record<string, any>;
+}
+/**
+ * Parameters for identify()
+ */
+interface IdentifyParams {
+    email?: string;
+    phone?: string;
+    [key: string]: any;
+}
+/**
+ * Response from trackConversion()
+ */
+interface ConversionLikelihoodResponse {
+    score: number;
+    factors: string[];
+}
+/**
+ * Response from getUserSegment()
+ */
+interface UserSegmentResponse {
+    type: "high_intent" | "medium_intent" | "exploring";
+    confidence: number;
+}
+
+/**
+ * Main SDK interface
+ */
+interface ZaplierSDK {
+    track(eventType: string, eventData?: Record<string, any>): void;
+    trackCustomEvent(eventName: string, metadata?: Record<string, any>): boolean;
+    trackConversion(eventName: string, value?: number, currency?: string, metadata?: Record<string, any>): boolean;
+    trackPageView(data?: Partial<PageViewEvent>): void;
+    trackPurchase(data: TrackPurchaseParams): void;
+    trackAddToCart(data?: TrackAddToCartParams): void;
+    trackViewContent(data?: TrackViewContentParams): void;
+    trackInitiateCheckout(data?: TrackInitiateCheckoutParams): void;
+    trackLead(data?: Record<string, any>): void;
+    identify(userData: IdentifyParams): void;
+    trackSPANavigation(url?: string, title?: string): void;
+    resetScrollTracking(): void;
+    startPresenceTracking(): void;
+    stopPresenceTracking(): void;
+    heatmap: {
+        enable(): void;
+        disable(): void;
+    };
+    replay: {
+        enable(): void;
+        disable(): void;
+        addFunnelStep(stepData: Record<string, any>): void;
+        markConversion(data: Record<string, any>): void;
+    };
+    enableEnhancedTracking(): boolean;
+    disableEnhancedTracking(): void;
+    isEnhancedMode(): boolean;
+    getVisitorId(): string | null;
+    getVisitorInfo(): Promise<VisitorInfo | null>;
+    getVisitorHistory(): Promise<VisitorHistory | null>;
+    getUserData(): UserData;
+    getConversionLikelihood(): ConversionLikelihoodResponse;
+    getUserSegment(): UserSegmentResponse;
+    config: InternalConfig;
+    version: string;
+}
+/**
+ * Global window interface extension
+ */
+declare global {
+    interface Window {
+        Zaplier?: ZaplierSDK;
+        zaplier?: ZaplierSDK;
+        stalker?: {
+            config?: Partial<SDKConfig>;
+            q?: any[][];
+        } & ZaplierSDK;
+    }
+}
+
 /**
  * Zaplier SDK Core v2.0.0 - Performance Optimized
  * Minimal core for instant initialization with lazy loading
  */
+
 interface CoreConfig {
     token: string;
     debug?: boolean;
@@ -23,6 +294,8 @@ declare class ZaplierCore {
     private sessionId?;
     private visitorId?;
     private modules;
+    private backendVisitorId?;
+    private cachedVisitorInfo?;
     private readonly version;
     /** Cached dev environment flag, computed once at init time */
     private _isDev;
@@ -77,14 +350,17 @@ declare class ZaplierCore {
      */
     private generateTempVisitorId;
     /**
-     * Get visitor info (for compatibility)
+     * Get the visitor ID (backend UUID if available, otherwise temp ID)
      */
-    getVisitorInfo(): {
-        visitorId: string | undefined;
-        sessionId: string | undefined;
-        isReady: boolean;
-        hasFingerprint: boolean;
-    };
+    getVisitorId(): string | null;
+    /**
+     * Get client-side user data synchronously (SSR-safe)
+     */
+    getUserData(): UserData;
+    /**
+     * Get full visitor info from backend (async, only fetches when backend UUID is available)
+     */
+    getVisitorInfo(): Promise<VisitorInfo | null>;
 }
 /**
  * Factory function for easy initialization

package/dist/v2/core.min.js

@@ -3,4 +3,4 @@
  * Advanced privacy-first tracking with code splitting
  * (c) 2026 Zaplier Team
  */
-class e{constructor(e){if(this.eventQueue=[],this.isInitialized=!1,this.modules=new Map,this.version="2.0.0",this.t=!1,!e.token)throw console.error('[Zaplier] Missing required "token" option. Get your token at https://app.zaplier.com/dashboard/keys'),new Error("Zaplier: token is required");if("string"!=typeof e.token||e.token.trim().length<5)throw console.error('[Zaplier] Invalid token format. Token should be a workspace API key (e.g., "ws_abc123...")'),new Error("Zaplier: invalid token format");this.config={deferAdvanced:!0,loadTimeout:5e3,debug:!1,...e},this.t=this.isDevEnvironment(),this.initializeCore()}isDevEnvironment(){if("undefined"==typeof window)return!1;const e=window.location.hostname;return"localhost"===e||"127.0.0.1"===e||"[::1]"===e||e.endsWith(".local")||e.endsWith(".test")||!0===this.config.debug}initializeCore(){try{this.config.debug&&this.version,this.sessionId=this.generateTempSessionId(),this.visitorId=this.generateTempVisitorId(),this.isInitialized=!0,this.processEventQueue(),this.config.debug,this.config.deferAdvanced||this.scheduleAdvancedLoading()}catch(e){console.error("[Zaplier Core] Initialization failed:",e)}}trackPageView(e={}){this.config.debug;const t={eventType:"page_view",eventName:"page_view",sessionId:this.sessionId,visitorId:this.visitorId,url:window.location.href,referrer:document.referrer,timestamp:(new Date).toISOString(),...e};this.sendEvent(t)}track(e,t={}){this.config.debug;const i={eventType:"custom",eventName:e,sessionId:this.sessionId,visitorId:this.visitorId,timestamp:(new Date).toISOString(),...t};this.sendEvent(i)}async enableAdvancedFeatures(){this.config.debug;try{await this.loadFingerprinting(),this.config.replay&&await this.loadReplayModule(),this.config.debug}catch(e){console.error("[Zaplier Core] Failed to load advanced features:",e)}}async loadFingerprinting(){if(!this.modules.has("fingerprint"))try{const{getCompleteFingerprint:e}=await import("./chunks/fingerprint-FfUEEIAd.min.js").then(function(e){return e.f}),t=await e();t.success&&t.data&&(this.visitorId=t.data.hash||this.visitorId,this.modules.set("fingerprint",t.data),this.config.debug)}catch(e){console.error("[Zaplier Core] Fingerprinting failed:",e)}}async loadReplayModule(){if(!this.modules.has("replay"))try{const{SessionReplayEngine:e}=await import("./chunks/session-replay-C5Tp0d16.min.js"),t=new e(this.sessionId,this.visitorId,{sampleRate:this.config.replaySampling||.1});t.start()&&(this.modules.set("replay",t),this.config.debug)}catch(e){console.error("[Zaplier Core] Replay loading failed:",e)}}scheduleAdvancedLoading(){((e,t=100)=>{"undefined"!=typeof requestIdleCallback?requestIdleCallback(e,{timeout:this.config.loadTimeout}):setTimeout(e,t)})(()=>this.enableAdvancedFeatures())}async sendEvent(e){try{const t={...e,isDev:this.t},i=await fetch(`${this.config.apiEndpoint||"https://api.zaplier.com"}/events?token=${encodeURIComponent(this.config.token)}`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t),keepalive:!0});this.config.debug&&!i.ok&&console.warn(`[Zaplier Core] Event sending failed: ${i.status}`)}catch(t){this.eventQueue.push(e),this.config.debug&&console.warn("[Zaplier Core] Event queued for retry:",t)}}processEventQueue(){if(0===this.eventQueue.length)return;const e=[...this.eventQueue];this.eventQueue=[],e.forEach(e=>this.sendEvent(e))}generateTempSessionId(){const e=new Date,t=e.getFullYear()+(e.getMonth()+1).toString().padStart(2,"0")+e.getDate().toString().padStart(2,"0"),i=e.getHours().toString().padStart(2,"0");return`temp_${Date.now()}_${t}_${i}`}generateTempVisitorId(){return`temp_visitor_${Date.now()}_${Math.random().toString(36).substr(2,9)}`}getVisitorInfo(){return{visitorId:this.visitorId,sessionId:this.sessionId,isReady:this.isInitialized,hasFingerprint:this.modules.has("fingerprint")}}}function t(t){return new e(t)}if("undefined"!=typeof window){window.Zaplier={init:t,version:"2.0.0"};const e=()=>{const e=document.getElementsByTagName("script");for(const i of Array.from(e))if(i.src&&(i.src.includes("zaplier")||i.src.includes("core.min.js"))&&i.dataset.token){const e=t({token:i.dataset.token,debug:"true"===i.dataset.debug,replay:"true"===i.dataset.replay,deferAdvanced:"false"!==i.dataset.deferAdvanced});return window.Zaplier.instance=e,e.trackPageView(),void(e.config.deferAdvanced&&e.enableAdvancedFeatures())}};"loading"===document.readyState?document.addEventListener("DOMContentLoaded",e):e()}export{e as ZaplierCore,e as default,t as initZaplierCore};
+class e{constructor(e){if(this.eventQueue=[],this.isInitialized=!1,this.modules=new Map,this.version="2.0.0",this.t=!1,!e.token)throw console.error('[Zaplier] Missing required "token" option. Get your token at https://app.zaplier.com/dashboard/keys'),new Error("Zaplier: token is required");if("string"!=typeof e.token||e.token.trim().length<5)throw console.error('[Zaplier] Invalid token format. Token should be a workspace API key (e.g., "ws_abc123...")'),new Error("Zaplier: invalid token format");this.config={deferAdvanced:!0,loadTimeout:5e3,debug:!1,...e},this.t=this.isDevEnvironment(),this.initializeCore()}isDevEnvironment(){if("undefined"==typeof window)return!1;const e=window.location.hostname;return"localhost"===e||"127.0.0.1"===e||"[::1]"===e||e.endsWith(".local")||e.endsWith(".test")||!0===this.config.debug}initializeCore(){try{this.config.debug&&this.version,this.sessionId=this.generateTempSessionId(),this.visitorId=this.generateTempVisitorId(),this.isInitialized=!0,this.processEventQueue(),this.config.debug,this.config.deferAdvanced||this.scheduleAdvancedLoading()}catch(e){console.error("[Zaplier Core] Initialization failed:",e)}}trackPageView(e={}){this.config.debug;const t={eventType:"page_view",eventName:"page_view",sessionId:this.sessionId,visitorId:this.visitorId,url:window.location.href,referrer:document.referrer,timestamp:(new Date).toISOString(),...e};this.sendEvent(t)}track(e,t={}){this.config.debug;const i={eventType:"custom",eventName:e,sessionId:this.sessionId,visitorId:this.visitorId,timestamp:(new Date).toISOString(),...t};this.sendEvent(i)}async enableAdvancedFeatures(){this.config.debug;try{await this.loadFingerprinting(),this.config.replay&&await this.loadReplayModule(),this.config.debug}catch(e){console.error("[Zaplier Core] Failed to load advanced features:",e)}}async loadFingerprinting(){if(!this.modules.has("fingerprint"))try{const{getCompleteFingerprint:e}=await import("./chunks/fingerprint-FfUEEIAd.min.js").then(function(e){return e.f}),t=await e();t.success&&t.data&&(this.visitorId=t.data.hash||this.visitorId,this.modules.set("fingerprint",t.data),this.config.debug)}catch(e){console.error("[Zaplier Core] Fingerprinting failed:",e)}}async loadReplayModule(){if(!this.modules.has("replay"))try{const{SessionReplayEngine:e}=await import("./chunks/session-replay-C5Tp0d16.min.js"),t=new e(this.sessionId,this.visitorId,{sampleRate:this.config.replaySampling||.1});t.start()&&(this.modules.set("replay",t),this.config.debug)}catch(e){console.error("[Zaplier Core] Replay loading failed:",e)}}scheduleAdvancedLoading(){((e,t=100)=>{"undefined"!=typeof requestIdleCallback?requestIdleCallback(e,{timeout:this.config.loadTimeout}):setTimeout(e,t)})(()=>this.enableAdvancedFeatures())}async sendEvent(e){try{const t={...e,isDev:this.t},i=await fetch(`${this.config.apiEndpoint||"https://api.zaplier.com"}/events?token=${encodeURIComponent(this.config.token)}`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t),keepalive:!0});if(this.config.debug&&!i.ok&&console.warn(`[Zaplier Core] Event sending failed: ${i.status}`),i.ok){const e=await i.json().catch(()=>null);(null==e?void 0:e.visitorId)&&(this.backendVisitorId=e.visitorId)}}catch(t){this.eventQueue.push(e),this.config.debug&&console.warn("[Zaplier Core] Event queued for retry:",t)}}processEventQueue(){if(0===this.eventQueue.length)return;const e=[...this.eventQueue];this.eventQueue=[],e.forEach(e=>this.sendEvent(e))}generateTempSessionId(){const e=new Date,t=e.getFullYear()+(e.getMonth()+1).toString().padStart(2,"0")+e.getDate().toString().padStart(2,"0"),i=e.getHours().toString().padStart(2,"0");return`temp_${Date.now()}_${t}_${i}`}generateTempVisitorId(){return`temp_visitor_${Date.now()}_${Math.random().toString(36).substr(2,9)}`}getVisitorId(){var e,t;return null!==(t=null!==(e=this.backendVisitorId)&&void 0!==e?e:this.visitorId)&&void 0!==t?t:null}getUserData(){var e,t,i,n,s,o,r;const a="undefined"!=typeof navigator?{userAgent:navigator.userAgent,language:navigator.language,screen:{width:null!==(t=null===(e=window.screen)||void 0===e?void 0:e.width)&&void 0!==t?t:0,height:null!==(n=null===(i=window.screen)||void 0===i?void 0:i.height)&&void 0!==n?n:0}}:{userAgent:"",language:"",screen:{width:0,height:0}};return{sessionId:null!==(s=this.sessionId)&&void 0!==s?s:"",visitorId:null!==(o=this.getVisitorId())&&void 0!==o?o:void 0,location:{},device:a,journey:[],fingerprint:null===(r=this.modules.get("fingerprint"))||void 0===r?void 0:r.hash}}async getVisitorInfo(){var e;const t=this.backendVisitorId;if(!t)return this.config.debug&&console.warn("[Zaplier Core] No backend visitor ID yet. Track an event first."),null;if(!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(t))return null;if(this.cachedVisitorInfo)return this.cachedVisitorInfo;try{const i=null!==(e=this.config.apiEndpoint)&&void 0!==e?e:"https://api.zaplier.com",n=await fetch(`${i}/tracking/visitor/${t}?token=${encodeURIComponent(this.config.token)}`,{method:"GET",headers:{"Content-Type":"application/json"}});if(!n.ok)return null;const s=await n.json();return this.cachedVisitorInfo=s,s}catch{return null}}}function t(t){return new e(t)}if("undefined"!=typeof window){window.Zaplier={init:t,version:"2.0.0"};const e=()=>{const e=document.getElementsByTagName("script");for(const i of Array.from(e))if(i.src&&(i.src.includes("zaplier")||i.src.includes("core.min.js"))&&i.dataset.token){const e=t({token:i.dataset.token,debug:"true"===i.dataset.debug,replay:"true"===i.dataset.replay,deferAdvanced:"false"!==i.dataset.deferAdvanced});return window.Zaplier.instance=e,e.trackPageView(),void(e.config.deferAdvanced&&e.enableAdvancedFeatures())}};"loading"===document.readyState?document.addEventListener("DOMContentLoaded",e):e()}export{e as ZaplierCore,e as default,t as initZaplierCore};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaplier/sdk",
-  "version": "1.8.2",
+  "version": "1.8.4",
   "description": "Advanced privacy-first tracking SDK with session replay, heatmaps, and anti-adblock technology",
   "type": "module",
   "main": "dist/index.cjs",