@pageviews/tracker 0.1.0

package/dist/module/index.cjs

@@ -0,0 +1,514 @@
+'use strict';
+
+function sendEvent(endpoint, payload, callback, siteId) {
+    if (typeof fetch === 'undefined')
+        return;
+    const headers = { 'Content-Type': 'text/plain' };
+    if (siteId)
+        headers['X-Site-ID'] = siteId;
+    fetch(endpoint, {
+        method: 'POST',
+        headers,
+        keepalive: true,
+        body: JSON.stringify(payload),
+    })
+        .then((response) => {
+        if (callback)
+            callback({ status: response.status });
+    })
+        .catch((error) => {
+        if (callback)
+            callback({ error });
+    });
+}
+function sendBeaconEvent(endpoint, payload, siteId) {
+    const body = JSON.stringify(payload);
+    if (typeof navigator !== 'undefined' && navigator.sendBeacon) {
+        // sendBeacon cannot set custom headers; Go service falls back to domain resolution
+        const blob = new Blob([body], { type: 'text/plain' });
+        const queued = navigator.sendBeacon(endpoint, blob);
+        if (queued)
+            return;
+    }
+    // Fallback to fetch with keepalive (can set X-Site-ID)
+    sendEvent(endpoint, payload, undefined, siteId);
+}
+
+// src/core/utils.ts
+function getScreenSize() {
+    return `${window.innerWidth}x${window.innerHeight}`;
+}
+function isLocalhost(hostname) {
+    return (hostname === 'localhost' ||
+        /^127(\.[0-9]+){0,2}\.[0-9]+$/.test(hostname) ||
+        hostname === '[::1]');
+}
+function isIgnored() {
+    try {
+        return window.localStorage.getItem('pageviews_ignore') === 'true';
+    }
+    catch (_a) {
+        return false;
+    }
+}
+function isBot() {
+    const w = window;
+    const nav = navigator;
+    return !!(w._phantom ||
+        w.__nightmare ||
+        nav.webdriver ||
+        w.Cypress ||
+        w.__puppeteer_evaluation_script__ ||
+        w.__playwright);
+}
+
+function createTracker(config) {
+    const ignored = isLocalhost(location.hostname) || isIgnored() || isBot();
+    function send(payload, callback) {
+        if (ignored) {
+            callback === null || callback === void 0 ? void 0 : callback();
+            return;
+        }
+        sendEvent(config.endpoint, payload, callback, config.siteId);
+    }
+    function trackPageview(url) {
+        const payload = {
+            n: 'pageview',
+            d: config.site,
+            u: url || location.href,
+            r: document.referrer || null,
+            s: getScreenSize(),
+        };
+        if (config.hashRouting)
+            payload.h = true;
+        send(payload);
+    }
+    function track(eventName, options) {
+        const payload = {
+            n: eventName,
+            d: config.site,
+            u: (options === null || options === void 0 ? void 0 : options.url) || location.href,
+            r: document.referrer || null,
+            s: getScreenSize(),
+        };
+        if (options === null || options === void 0 ? void 0 : options.props) {
+            // Coerce all prop values to strings — the ingest service stores Map(String,String)
+            const coerced = {};
+            for (const [k, v] of Object.entries(options.props)) {
+                coerced[k] = String(v);
+            }
+            payload.p = coerced;
+        }
+        if (options === null || options === void 0 ? void 0 : options.revenue) {
+            const { amount, currency } = options.revenue;
+            if (amount > 0 && amount <= 1000000000 && currency) {
+                payload.rv = { a: amount, c: currency };
+            }
+        }
+        if (config.hashRouting)
+            payload.h = true;
+        send(payload, options === null || options === void 0 ? void 0 : options.callback);
+    }
+    function identify(data) {
+        const payload = {
+            n: 'identify',
+            d: config.site,
+            u: location.href,
+            r: null,
+            s: getScreenSize(),
+            uid: data.userId,
+        };
+        send(payload);
+    }
+    return { trackPageview, track, identify };
+}
+
+let cleanup = null;
+function startNavTracking(onNavigate, hashRouting) {
+    let lastPathname = location.pathname;
+    const handleNav = () => {
+        if (!hashRouting && location.pathname === lastPathname)
+            return;
+        lastPathname = location.pathname;
+        onNavigate();
+    };
+    // Initial pageview
+    onNavigate();
+    if (hashRouting) {
+        window.addEventListener('hashchange', handleNav);
+        cleanup = () => window.removeEventListener('hashchange', handleNav);
+    }
+    else {
+        const originalPushState = history.pushState;
+        history.pushState = function (...args) {
+            originalPushState.apply(this, args);
+            handleNav();
+        };
+        const onPopState = () => {
+            lastPathname = location.pathname;
+            onNavigate();
+        };
+        window.addEventListener('popstate', onPopState);
+        cleanup = () => {
+            history.pushState = originalPushState;
+            window.removeEventListener('popstate', onPopState);
+        };
+    }
+    // Handle bfcache (back-forward cache)
+    const onPageShow = (e) => {
+        if (e.persisted)
+            onNavigate();
+    };
+    window.addEventListener('pageshow', onPageShow);
+    const prevCleanup = cleanup;
+    cleanup = () => {
+        prevCleanup === null || prevCleanup === void 0 ? void 0 : prevCleanup();
+        window.removeEventListener('pageshow', onPageShow);
+    };
+}
+function stopNavTracking() {
+    cleanup === null || cleanup === void 0 ? void 0 : cleanup();
+    cleanup = null;
+}
+
+let startTime = 0;
+let accumulatedTime = 0;
+let isActive = false;
+let maxScrollDepth = 0;
+let scrollTicking = false;
+let cachedPageHeight = 0;
+function computePageHeight() {
+    const body = document.body || {};
+    const html = document.documentElement || {};
+    return Math.max(body.scrollHeight || 0, body.offsetHeight || 0, html.scrollHeight || 0, html.offsetHeight || 0);
+}
+function getCurrentScrollDepth() {
+    if (cachedPageHeight === 0)
+        return 0;
+    const viewportHeight = window.innerHeight || 0;
+    if (cachedPageHeight <= viewportHeight)
+        return 100;
+    const scrollTop = window.scrollY || document.documentElement.scrollTop || 0;
+    return Math.round(((scrollTop + viewportHeight) / cachedPageHeight) * 100);
+}
+function onResize() {
+    cachedPageHeight = computePageHeight();
+}
+function onVisibilityChange() {
+    if (document.visibilityState === 'hidden') {
+        if (isActive) {
+            accumulatedTime += Date.now() - startTime;
+            isActive = false;
+        }
+    }
+    else if (document.visibilityState === 'visible') {
+        startTime = Date.now();
+        isActive = true;
+    }
+}
+function onScroll() {
+    if (scrollTicking)
+        return;
+    scrollTicking = true;
+    requestAnimationFrame(() => {
+        const depth = getCurrentScrollDepth();
+        if (depth > maxScrollDepth) {
+            maxScrollDepth = depth;
+        }
+        scrollTicking = false;
+    });
+}
+function stopEngagement() {
+    document.removeEventListener('visibilitychange', onVisibilityChange);
+    document.removeEventListener('scroll', onScroll);
+    window.removeEventListener('resize', onResize);
+}
+function startEngagement() {
+    stopEngagement();
+    startTime = Date.now();
+    accumulatedTime = 0;
+    maxScrollDepth = 0;
+    isActive = true;
+    cachedPageHeight = computePageHeight();
+    document.addEventListener('visibilitychange', onVisibilityChange);
+    document.addEventListener('scroll', onScroll, { passive: true });
+    window.addEventListener('resize', onResize, { passive: true });
+}
+function resetEngagement() {
+    startTime = Date.now();
+    accumulatedTime = 0;
+    maxScrollDepth = 0;
+    isActive = true;
+}
+function getEngagementData() {
+    const currentActive = isActive ? Date.now() - startTime : 0;
+    return {
+        activeTime: accumulatedTime + currentActive,
+        maxScrollDepth,
+    };
+}
+
+// src/core/events.ts
+const DEFAULT_FILE_TYPES = [
+    'pdf', 'xlsx', 'docx', 'txt', 'rtf', 'csv', 'exe', 'key', 'pps', 'ppt',
+    'pptx', '7z', 'pkg', 'rar', 'gz', 'zip', 'avi', 'mov', 'mp4', 'mpeg',
+    'wmv', 'midi', 'mp3', 'wav', 'wma', 'dmg',
+];
+let clickHandler = null;
+let submitHandler = null;
+function findLink(target) {
+    let el = target;
+    while (el && el.tagName !== 'A') {
+        el = el.parentElement;
+    }
+    return el;
+}
+function isOutbound(link) {
+    return link.host !== '' && link.host !== location.host;
+}
+function isFileDownload(href) {
+    var _a;
+    const ext = (_a = href.split('?')[0].split('.').pop()) === null || _a === void 0 ? void 0 : _a.toLowerCase();
+    return ext ? DEFAULT_FILE_TYPES.includes(ext) : false;
+}
+function startEventTracking(trackFn, config) {
+    stopEventTracking();
+    clickHandler = (e) => {
+        const link = findLink(e.target);
+        if (!link || !link.href)
+            return;
+        const href = link.href;
+        const cleanUrl = href.split('?')[0];
+        if (config.fileDownloads && isFileDownload(href)) {
+            trackFn('File Download', { props: { url: cleanUrl } });
+            return;
+        }
+        if (config.outboundLinks && isOutbound(link)) {
+            trackFn('Outbound Link: Click', { props: { url: href } });
+        }
+    };
+    document.addEventListener('click', clickHandler);
+    if (config.formSubmissions) {
+        submitHandler = (e) => {
+            const form = e.target;
+            if (form.hasAttribute('novalidate') || form.checkValidity()) {
+                trackFn('Form Submission');
+            }
+        };
+        document.addEventListener('submit', submitHandler, true);
+    }
+}
+function stopEventTracking() {
+    if (clickHandler) {
+        document.removeEventListener('click', clickHandler);
+        clickHandler = null;
+    }
+    if (submitHandler) {
+        document.removeEventListener('submit', submitHandler, true);
+        submitHandler = null;
+    }
+}
+
+let scrollHandler = null;
+function startScrollGoals(trackFn, targets, currentPath) {
+    const matchingTargets = targets.filter((t) => t.path === currentPath);
+    if (matchingTargets.length === 0)
+        return;
+    const fired = new Set();
+    let ticking = false;
+    scrollHandler = () => {
+        if (ticking)
+            return;
+        ticking = true;
+        requestAnimationFrame(() => {
+            var _a;
+            const pageHeight = Math.max(document.documentElement.scrollHeight || 0, ((_a = document.body) === null || _a === void 0 ? void 0 : _a.scrollHeight) || 0);
+            const viewportHeight = window.innerHeight || 0;
+            const scrollTop = window.scrollY || 0;
+            const scrollPercent = pageHeight <= viewportHeight
+                ? 100
+                : Math.round(((scrollTop + viewportHeight) / pageHeight) * 100);
+            for (const target of matchingTargets) {
+                if (!fired.has(target.goalName) && scrollPercent >= target.threshold) {
+                    fired.add(target.goalName);
+                    trackFn(target.goalName);
+                }
+            }
+            ticking = false;
+        });
+    };
+    document.addEventListener('scroll', scrollHandler, { passive: true });
+}
+function stopScrollGoals() {
+    if (scrollHandler) {
+        document.removeEventListener('scroll', scrollHandler);
+        scrollHandler = null;
+    }
+}
+
+/** Minimum active time (ms) before an engagement event is worth sending */
+const MIN_ENGAGEMENT_MS = 1000;
+function setupTracking(config, tracker) {
+    stopEngagement();
+    startEngagement();
+    let isFirstPageview = true;
+    let currentUrl = location.href;
+    startNavTracking(() => {
+        // Send engagement for previous page (skip on first pageview)
+        if (!isFirstPageview) {
+            const engagement = getEngagementData();
+            if (engagement.activeTime >= MIN_ENGAGEMENT_MS) {
+                sendEvent(config.endpoint, {
+                    n: 'engagement',
+                    d: config.site,
+                    u: currentUrl,
+                    r: null,
+                    s: getScreenSize(),
+                    sd: engagement.maxScrollDepth,
+                    e: engagement.activeTime,
+                }, undefined, config.siteId);
+            }
+            resetEngagement();
+        }
+        isFirstPageview = false;
+        currentUrl = location.href;
+        tracker.trackPageview();
+        stopScrollGoals();
+        if (config.scrollTargets.length > 0) {
+            startScrollGoals((goalName) => tracker.track(goalName), config.scrollTargets, location.pathname);
+        }
+    }, config.hashRouting);
+    startEventTracking((name, options) => tracker.track(name, options), {
+        outboundLinks: config.outboundLinks,
+        fileDownloads: config.fileDownloads,
+        formSubmissions: config.formSubmissions,
+    });
+    // Send engagement on page unload
+    const onUnload = () => {
+        if (document.visibilityState === 'hidden') {
+            const engagement = getEngagementData();
+            if (engagement.activeTime >= MIN_ENGAGEMENT_MS) {
+                sendBeaconEvent(config.endpoint, {
+                    n: 'engagement',
+                    d: config.site,
+                    u: currentUrl,
+                    r: null,
+                    s: getScreenSize(),
+                    sd: engagement.maxScrollDepth,
+                    e: engagement.activeTime,
+                }, config.siteId);
+            }
+        }
+    };
+    document.addEventListener('visibilitychange', onUnload);
+    // Return cleanup function
+    return () => {
+        stopNavTracking();
+        stopEngagement();
+        stopEventTracking();
+        stopScrollGoals();
+        document.removeEventListener('visibilitychange', onUnload);
+    };
+}
+function initTracking(config) {
+    const tracker = createTracker(config);
+    let cleanup = null;
+    if (document.visibilityState === 'prerender') {
+        const onVisible = () => {
+            if (document.visibilityState === 'visible') {
+                document.removeEventListener('visibilitychange', onVisible);
+                cleanup = setupTracking(config, tracker);
+            }
+        };
+        document.addEventListener('visibilitychange', onVisible);
+        return {
+            tracker,
+            destroy: () => {
+                document.removeEventListener('visibilitychange', onVisible);
+                cleanup === null || cleanup === void 0 ? void 0 : cleanup();
+            },
+        };
+    }
+    cleanup = setupTracking(config, tracker);
+    return {
+        tracker,
+        destroy: () => { cleanup === null || cleanup === void 0 ? void 0 : cleanup(); },
+    };
+}
+
+const CACHE_KEY = 'pageviews_config';
+const CACHE_TTL = 1000 * 60 * 60; // 1 hour
+let instance = null;
+let initialized = false;
+function getCachedConfig(siteId) {
+    try {
+        const raw = localStorage.getItem(`${CACHE_KEY}_${siteId}`);
+        if (!raw)
+            return null;
+        const { config, ts } = JSON.parse(raw);
+        if (Date.now() - ts > CACHE_TTL)
+            return null;
+        return config;
+    }
+    catch (_a) {
+        return null;
+    }
+}
+function setCachedConfig(siteId, config) {
+    try {
+        localStorage.setItem(`${CACHE_KEY}_${siteId}`, JSON.stringify({ config, ts: Date.now() }));
+    }
+    catch (_a) {
+        // localStorage unavailable
+    }
+}
+async function fetchConfig(endpoint, siteId) {
+    const res = await fetch(`${endpoint}/api/config/${siteId}`);
+    if (!res.ok)
+        throw new Error(`Config fetch failed: HTTP ${res.status}`);
+    return res.json();
+}
+function startTracking(config) {
+    instance = initTracking(config);
+}
+async function init(options) {
+    if (initialized)
+        throw new Error('pageviews.init() can only be called once');
+    initialized = true;
+    const ingestEndpoint = (options.endpoint || 'https://data.pageviews.ai') + '/api/event';
+    const cfgEndpoint = options.configEndpoint || 'https://app.pageviews.ai';
+    const cached = getCachedConfig(options.siteId);
+    if (cached) {
+        startTracking(Object.assign(Object.assign({}, cached), { siteId: options.siteId, endpoint: ingestEndpoint }));
+        // Refresh cache in background
+        fetchConfig(cfgEndpoint, options.siteId).then((fresh) => {
+            setCachedConfig(options.siteId, fresh);
+        }).catch(() => { });
+        return;
+    }
+    const configData = await fetchConfig(cfgEndpoint, options.siteId);
+    setCachedConfig(options.siteId, configData);
+    startTracking(Object.assign(Object.assign({}, configData), { siteId: options.siteId, endpoint: ingestEndpoint }));
+}
+function track(eventName, options) {
+    if (!instance)
+        throw new Error('pageviews.track() requires init() to be called first');
+    instance.tracker.track(eventName, options);
+}
+function identify(data) {
+    if (!instance)
+        throw new Error('pageviews.identify() requires init() to be called first');
+    instance.tracker.identify(data);
+}
+function destroy() {
+    if (!instance)
+        return;
+    instance.destroy();
+    instance = null;
+    initialized = false;
+}
+
+exports.destroy = destroy;
+exports.identify = identify;
+exports.init = init;
+exports.track = track;

package/dist/module/index.d.ts

@@ -0,0 +1,46 @@
+interface SiteConfig {
+    site: string;
+    siteId: string;
+    endpoint: string;
+    hashRouting: boolean;
+    outboundLinks: boolean;
+    fileDownloads: boolean;
+    formSubmissions: boolean;
+    scrollTargets: ScrollTarget[];
+}
+interface ScrollTarget {
+    goalName: string;
+    path: string;
+    threshold: number;
+}
+interface TrackOptions {
+    props?: Record<string, string | number | boolean>;
+    revenue?: {
+        amount: number;
+        currency: string;
+    };
+    url?: string;
+    callback?: (result?: {
+        status: number;
+    } | {
+        error: unknown;
+    }) => void;
+}
+interface IdentifyData {
+    userId: string;
+}
+
+interface InitOptions {
+    siteId: string;
+    /** Ingest service base URL for sending events. Default: https://data.pageviews.ai */
+    endpoint?: string;
+    /** Laravel app base URL for fetching site config. Default: https://app.pageviews.ai */
+    configEndpoint?: string;
+}
+declare function init(options: InitOptions): Promise<void>;
+declare function track(eventName: string, options?: TrackOptions): void;
+declare function identify(data: IdentifyData): void;
+declare function destroy(): void;
+
+export { destroy, identify, init, track };
+export type { IdentifyData, SiteConfig, TrackOptions };

package/dist/module/index.mjs

@@ -0,0 +1,509 @@
+function sendEvent(endpoint, payload, callback, siteId) {
+    if (typeof fetch === 'undefined')
+        return;
+    const headers = { 'Content-Type': 'text/plain' };
+    if (siteId)
+        headers['X-Site-ID'] = siteId;
+    fetch(endpoint, {
+        method: 'POST',
+        headers,
+        keepalive: true,
+        body: JSON.stringify(payload),
+    })
+        .then((response) => {
+        if (callback)
+            callback({ status: response.status });
+    })
+        .catch((error) => {
+        if (callback)
+            callback({ error });
+    });
+}
+function sendBeaconEvent(endpoint, payload, siteId) {
+    const body = JSON.stringify(payload);
+    if (typeof navigator !== 'undefined' && navigator.sendBeacon) {
+        // sendBeacon cannot set custom headers; Go service falls back to domain resolution
+        const blob = new Blob([body], { type: 'text/plain' });
+        const queued = navigator.sendBeacon(endpoint, blob);
+        if (queued)
+            return;
+    }
+    // Fallback to fetch with keepalive (can set X-Site-ID)
+    sendEvent(endpoint, payload, undefined, siteId);
+}
+
+// src/core/utils.ts
+function getScreenSize() {
+    return `${window.innerWidth}x${window.innerHeight}`;
+}
+function isLocalhost(hostname) {
+    return (hostname === 'localhost' ||
+        /^127(\.[0-9]+){0,2}\.[0-9]+$/.test(hostname) ||
+        hostname === '[::1]');
+}
+function isIgnored() {
+    try {
+        return window.localStorage.getItem('pageviews_ignore') === 'true';
+    }
+    catch (_a) {
+        return false;
+    }
+}
+function isBot() {
+    const w = window;
+    const nav = navigator;
+    return !!(w._phantom ||
+        w.__nightmare ||
+        nav.webdriver ||
+        w.Cypress ||
+        w.__puppeteer_evaluation_script__ ||
+        w.__playwright);
+}
+
+function createTracker(config) {
+    const ignored = isLocalhost(location.hostname) || isIgnored() || isBot();
+    function send(payload, callback) {
+        if (ignored) {
+            callback === null || callback === void 0 ? void 0 : callback();
+            return;
+        }
+        sendEvent(config.endpoint, payload, callback, config.siteId);
+    }
+    function trackPageview(url) {
+        const payload = {
+            n: 'pageview',
+            d: config.site,
+            u: url || location.href,
+            r: document.referrer || null,
+            s: getScreenSize(),
+        };
+        if (config.hashRouting)
+            payload.h = true;
+        send(payload);
+    }
+    function track(eventName, options) {
+        const payload = {
+            n: eventName,
+            d: config.site,
+            u: (options === null || options === void 0 ? void 0 : options.url) || location.href,
+            r: document.referrer || null,
+            s: getScreenSize(),
+        };
+        if (options === null || options === void 0 ? void 0 : options.props) {
+            // Coerce all prop values to strings — the ingest service stores Map(String,String)
+            const coerced = {};
+            for (const [k, v] of Object.entries(options.props)) {
+                coerced[k] = String(v);
+            }
+            payload.p = coerced;
+        }
+        if (options === null || options === void 0 ? void 0 : options.revenue) {
+            const { amount, currency } = options.revenue;
+            if (amount > 0 && amount <= 1000000000 && currency) {
+                payload.rv = { a: amount, c: currency };
+            }
+        }
+        if (config.hashRouting)
+            payload.h = true;
+        send(payload, options === null || options === void 0 ? void 0 : options.callback);
+    }
+    function identify(data) {
+        const payload = {
+            n: 'identify',
+            d: config.site,
+            u: location.href,
+            r: null,
+            s: getScreenSize(),
+            uid: data.userId,
+        };
+        send(payload);
+    }
+    return { trackPageview, track, identify };
+}
+
+let cleanup = null;
+function startNavTracking(onNavigate, hashRouting) {
+    let lastPathname = location.pathname;
+    const handleNav = () => {
+        if (!hashRouting && location.pathname === lastPathname)
+            return;
+        lastPathname = location.pathname;
+        onNavigate();
+    };
+    // Initial pageview
+    onNavigate();
+    if (hashRouting) {
+        window.addEventListener('hashchange', handleNav);
+        cleanup = () => window.removeEventListener('hashchange', handleNav);
+    }
+    else {
+        const originalPushState = history.pushState;
+        history.pushState = function (...args) {
+            originalPushState.apply(this, args);
+            handleNav();
+        };
+        const onPopState = () => {
+            lastPathname = location.pathname;
+            onNavigate();
+        };
+        window.addEventListener('popstate', onPopState);
+        cleanup = () => {
+            history.pushState = originalPushState;
+            window.removeEventListener('popstate', onPopState);
+        };
+    }
+    // Handle bfcache (back-forward cache)
+    const onPageShow = (e) => {
+        if (e.persisted)
+            onNavigate();
+    };
+    window.addEventListener('pageshow', onPageShow);
+    const prevCleanup = cleanup;
+    cleanup = () => {
+        prevCleanup === null || prevCleanup === void 0 ? void 0 : prevCleanup();
+        window.removeEventListener('pageshow', onPageShow);
+    };
+}
+function stopNavTracking() {
+    cleanup === null || cleanup === void 0 ? void 0 : cleanup();
+    cleanup = null;
+}
+
+let startTime = 0;
+let accumulatedTime = 0;
+let isActive = false;
+let maxScrollDepth = 0;
+let scrollTicking = false;
+let cachedPageHeight = 0;
+function computePageHeight() {
+    const body = document.body || {};
+    const html = document.documentElement || {};
+    return Math.max(body.scrollHeight || 0, body.offsetHeight || 0, html.scrollHeight || 0, html.offsetHeight || 0);
+}
+function getCurrentScrollDepth() {
+    if (cachedPageHeight === 0)
+        return 0;
+    const viewportHeight = window.innerHeight || 0;
+    if (cachedPageHeight <= viewportHeight)
+        return 100;
+    const scrollTop = window.scrollY || document.documentElement.scrollTop || 0;
+    return Math.round(((scrollTop + viewportHeight) / cachedPageHeight) * 100);
+}
+function onResize() {
+    cachedPageHeight = computePageHeight();
+}
+function onVisibilityChange() {
+    if (document.visibilityState === 'hidden') {
+        if (isActive) {
+            accumulatedTime += Date.now() - startTime;
+            isActive = false;
+        }
+    }
+    else if (document.visibilityState === 'visible') {
+        startTime = Date.now();
+        isActive = true;
+    }
+}
+function onScroll() {
+    if (scrollTicking)
+        return;
+    scrollTicking = true;
+    requestAnimationFrame(() => {
+        const depth = getCurrentScrollDepth();
+        if (depth > maxScrollDepth) {
+            maxScrollDepth = depth;
+        }
+        scrollTicking = false;
+    });
+}
+function stopEngagement() {
+    document.removeEventListener('visibilitychange', onVisibilityChange);
+    document.removeEventListener('scroll', onScroll);
+    window.removeEventListener('resize', onResize);
+}
+function startEngagement() {
+    stopEngagement();
+    startTime = Date.now();
+    accumulatedTime = 0;
+    maxScrollDepth = 0;
+    isActive = true;
+    cachedPageHeight = computePageHeight();
+    document.addEventListener('visibilitychange', onVisibilityChange);
+    document.addEventListener('scroll', onScroll, { passive: true });
+    window.addEventListener('resize', onResize, { passive: true });
+}
+function resetEngagement() {
+    startTime = Date.now();
+    accumulatedTime = 0;
+    maxScrollDepth = 0;
+    isActive = true;
+}
+function getEngagementData() {
+    const currentActive = isActive ? Date.now() - startTime : 0;
+    return {
+        activeTime: accumulatedTime + currentActive,
+        maxScrollDepth,
+    };
+}
+
+// src/core/events.ts
+const DEFAULT_FILE_TYPES = [
+    'pdf', 'xlsx', 'docx', 'txt', 'rtf', 'csv', 'exe', 'key', 'pps', 'ppt',
+    'pptx', '7z', 'pkg', 'rar', 'gz', 'zip', 'avi', 'mov', 'mp4', 'mpeg',
+    'wmv', 'midi', 'mp3', 'wav', 'wma', 'dmg',
+];
+let clickHandler = null;
+let submitHandler = null;
+function findLink(target) {
+    let el = target;
+    while (el && el.tagName !== 'A') {
+        el = el.parentElement;
+    }
+    return el;
+}
+function isOutbound(link) {
+    return link.host !== '' && link.host !== location.host;
+}
+function isFileDownload(href) {
+    var _a;
+    const ext = (_a = href.split('?')[0].split('.').pop()) === null || _a === void 0 ? void 0 : _a.toLowerCase();
+    return ext ? DEFAULT_FILE_TYPES.includes(ext) : false;
+}
+function startEventTracking(trackFn, config) {
+    stopEventTracking();
+    clickHandler = (e) => {
+        const link = findLink(e.target);
+        if (!link || !link.href)
+            return;
+        const href = link.href;
+        const cleanUrl = href.split('?')[0];
+        if (config.fileDownloads && isFileDownload(href)) {
+            trackFn('File Download', { props: { url: cleanUrl } });
+            return;
+        }
+        if (config.outboundLinks && isOutbound(link)) {
+            trackFn('Outbound Link: Click', { props: { url: href } });
+        }
+    };
+    document.addEventListener('click', clickHandler);
+    if (config.formSubmissions) {
+        submitHandler = (e) => {
+            const form = e.target;
+            if (form.hasAttribute('novalidate') || form.checkValidity()) {
+                trackFn('Form Submission');
+            }
+        };
+        document.addEventListener('submit', submitHandler, true);
+    }
+}
+function stopEventTracking() {
+    if (clickHandler) {
+        document.removeEventListener('click', clickHandler);
+        clickHandler = null;
+    }
+    if (submitHandler) {
+        document.removeEventListener('submit', submitHandler, true);
+        submitHandler = null;
+    }
+}
+
+let scrollHandler = null;
+function startScrollGoals(trackFn, targets, currentPath) {
+    const matchingTargets = targets.filter((t) => t.path === currentPath);
+    if (matchingTargets.length === 0)
+        return;
+    const fired = new Set();
+    let ticking = false;
+    scrollHandler = () => {
+        if (ticking)
+            return;
+        ticking = true;
+        requestAnimationFrame(() => {
+            var _a;
+            const pageHeight = Math.max(document.documentElement.scrollHeight || 0, ((_a = document.body) === null || _a === void 0 ? void 0 : _a.scrollHeight) || 0);
+            const viewportHeight = window.innerHeight || 0;
+            const scrollTop = window.scrollY || 0;
+            const scrollPercent = pageHeight <= viewportHeight
+                ? 100
+                : Math.round(((scrollTop + viewportHeight) / pageHeight) * 100);
+            for (const target of matchingTargets) {
+                if (!fired.has(target.goalName) && scrollPercent >= target.threshold) {
+                    fired.add(target.goalName);
+                    trackFn(target.goalName);
+                }
+            }
+            ticking = false;
+        });
+    };
+    document.addEventListener('scroll', scrollHandler, { passive: true });
+}
+function stopScrollGoals() {
+    if (scrollHandler) {
+        document.removeEventListener('scroll', scrollHandler);
+        scrollHandler = null;
+    }
+}
+
+/** Minimum active time (ms) before an engagement event is worth sending */
+const MIN_ENGAGEMENT_MS = 1000;
+function setupTracking(config, tracker) {
+    stopEngagement();
+    startEngagement();
+    let isFirstPageview = true;
+    let currentUrl = location.href;
+    startNavTracking(() => {
+        // Send engagement for previous page (skip on first pageview)
+        if (!isFirstPageview) {
+            const engagement = getEngagementData();
+            if (engagement.activeTime >= MIN_ENGAGEMENT_MS) {
+                sendEvent(config.endpoint, {
+                    n: 'engagement',
+                    d: config.site,
+                    u: currentUrl,
+                    r: null,
+                    s: getScreenSize(),
+                    sd: engagement.maxScrollDepth,
+                    e: engagement.activeTime,
+                }, undefined, config.siteId);
+            }
+            resetEngagement();
+        }
+        isFirstPageview = false;
+        currentUrl = location.href;
+        tracker.trackPageview();
+        stopScrollGoals();
+        if (config.scrollTargets.length > 0) {
+            startScrollGoals((goalName) => tracker.track(goalName), config.scrollTargets, location.pathname);
+        }
+    }, config.hashRouting);
+    startEventTracking((name, options) => tracker.track(name, options), {
+        outboundLinks: config.outboundLinks,
+        fileDownloads: config.fileDownloads,
+        formSubmissions: config.formSubmissions,
+    });
+    // Send engagement on page unload
+    const onUnload = () => {
+        if (document.visibilityState === 'hidden') {
+            const engagement = getEngagementData();
+            if (engagement.activeTime >= MIN_ENGAGEMENT_MS) {
+                sendBeaconEvent(config.endpoint, {
+                    n: 'engagement',
+                    d: config.site,
+                    u: currentUrl,
+                    r: null,
+                    s: getScreenSize(),
+                    sd: engagement.maxScrollDepth,
+                    e: engagement.activeTime,
+                }, config.siteId);
+            }
+        }
+    };
+    document.addEventListener('visibilitychange', onUnload);
+    // Return cleanup function
+    return () => {
+        stopNavTracking();
+        stopEngagement();
+        stopEventTracking();
+        stopScrollGoals();
+        document.removeEventListener('visibilitychange', onUnload);
+    };
+}
+function initTracking(config) {
+    const tracker = createTracker(config);
+    let cleanup = null;
+    if (document.visibilityState === 'prerender') {
+        const onVisible = () => {
+            if (document.visibilityState === 'visible') {
+                document.removeEventListener('visibilitychange', onVisible);
+                cleanup = setupTracking(config, tracker);
+            }
+        };
+        document.addEventListener('visibilitychange', onVisible);
+        return {
+            tracker,
+            destroy: () => {
+                document.removeEventListener('visibilitychange', onVisible);
+                cleanup === null || cleanup === void 0 ? void 0 : cleanup();
+            },
+        };
+    }
+    cleanup = setupTracking(config, tracker);
+    return {
+        tracker,
+        destroy: () => { cleanup === null || cleanup === void 0 ? void 0 : cleanup(); },
+    };
+}
+
+const CACHE_KEY = 'pageviews_config';
+const CACHE_TTL = 1000 * 60 * 60; // 1 hour
+let instance = null;
+let initialized = false;
+function getCachedConfig(siteId) {
+    try {
+        const raw = localStorage.getItem(`${CACHE_KEY}_${siteId}`);
+        if (!raw)
+            return null;
+        const { config, ts } = JSON.parse(raw);
+        if (Date.now() - ts > CACHE_TTL)
+            return null;
+        return config;
+    }
+    catch (_a) {
+        return null;
+    }
+}
+function setCachedConfig(siteId, config) {
+    try {
+        localStorage.setItem(`${CACHE_KEY}_${siteId}`, JSON.stringify({ config, ts: Date.now() }));
+    }
+    catch (_a) {
+        // localStorage unavailable
+    }
+}
+async function fetchConfig(endpoint, siteId) {
+    const res = await fetch(`${endpoint}/api/config/${siteId}`);
+    if (!res.ok)
+        throw new Error(`Config fetch failed: HTTP ${res.status}`);
+    return res.json();
+}
+function startTracking(config) {
+    instance = initTracking(config);
+}
+async function init(options) {
+    if (initialized)
+        throw new Error('pageviews.init() can only be called once');
+    initialized = true;
+    const ingestEndpoint = (options.endpoint || 'https://data.pageviews.ai') + '/api/event';
+    const cfgEndpoint = options.configEndpoint || 'https://app.pageviews.ai';
+    const cached = getCachedConfig(options.siteId);
+    if (cached) {
+        startTracking(Object.assign(Object.assign({}, cached), { siteId: options.siteId, endpoint: ingestEndpoint }));
+        // Refresh cache in background
+        fetchConfig(cfgEndpoint, options.siteId).then((fresh) => {
+            setCachedConfig(options.siteId, fresh);
+        }).catch(() => { });
+        return;
+    }
+    const configData = await fetchConfig(cfgEndpoint, options.siteId);
+    setCachedConfig(options.siteId, configData);
+    startTracking(Object.assign(Object.assign({}, configData), { siteId: options.siteId, endpoint: ingestEndpoint }));
+}
+function track(eventName, options) {
+    if (!instance)
+        throw new Error('pageviews.track() requires init() to be called first');
+    instance.tracker.track(eventName, options);
+}
+function identify(data) {
+    if (!instance)
+        throw new Error('pageviews.identify() requires init() to be called first');
+    instance.tracker.identify(data);
+}
+function destroy() {
+    if (!instance)
+        return;
+    instance.destroy();
+    instance = null;
+    initialized = false;
+}
+
+export { destroy, identify, init, track };

package/dist/tracker.js

@@ -0,0 +1 @@
+!function(){"use strict";function t(t,e,n,i){if("undefined"==typeof fetch)return;const o={"Content-Type":"text/plain"};i&&(o["X-Site-ID"]=i),fetch(t,{method:"POST",headers:o,keepalive:!0,body:JSON.stringify(e)}).then(t=>{n&&n({status:t.status})}).catch(t=>{n&&n({error:t})})}function e(){return`${window.innerWidth}x${window.innerHeight}`}let n=null,i=0,o=0,r=!1,s=0,c=!1,a=0;function l(){const t=document.body||{},e=document.documentElement||{};return Math.max(t.scrollHeight||0,t.offsetHeight||0,e.scrollHeight||0,e.offsetHeight||0)}function u(){a=l()}function d(){"hidden"===document.visibilityState?r&&(o+=Date.now()-i,r=!1):"visible"===document.visibilityState&&(i=Date.now(),r=!0)}function v(){c||(c=!0,requestAnimationFrame(()=>{const t=function(){if(0===a)return 0;const t=window.innerHeight||0;if(a<=t)return 100;const e=window.scrollY||document.documentElement.scrollTop||0;return Math.round((e+t)/a*100)}();t>s&&(s=t),c=!1}))}function m(){document.removeEventListener("visibilitychange",d),document.removeEventListener("scroll",v),window.removeEventListener("resize",u)}function f(){const t=r?Date.now()-i:0;return{activeTime:o+t,maxScrollDepth:s}}const h=["pdf","xlsx","docx","txt","rtf","csv","exe","key","pps","ppt","pptx","7z","pkg","rar","gz","zip","avi","mov","mp4","mpeg","wmv","midi","mp3","wav","wma","dmg"];let p=null,g=null;function w(){p&&(document.removeEventListener("click",p),p=null),g&&(document.removeEventListener("submit",g,!0),g=null)}let y=null;function b(){y&&(document.removeEventListener("scroll",y),y=null)}function E(c,E){m(),m(),i=Date.now(),o=0,s=0,r=!0,a=l(),document.addEventListener("visibilitychange",d),document.addEventListener("scroll",v,{passive:!0}),window.addEventListener("resize",u,{passive:!0});let L=!0,S=location.href;!function(t,e){let i=location.pathname;const o=()=>{(e||location.pathname!==i)&&(i=location.pathname,t())};if(t(),e)window.addEventListener("hashchange",o),n=()=>window.removeEventListener("hashchange",o);else{const e=history.pushState;history.pushState=function(...t){e.apply(this,t),o()};const r=()=>{i=location.pathname,t()};window.addEventListener("popstate",r),n=()=>{history.pushState=e,window.removeEventListener("popstate",r)}}const r=e=>{e.persisted&&t()};window.addEventListener("pageshow",r);const s=n;n=()=>{null==s||s(),window.removeEventListener("pageshow",r)}}(()=>{if(!L){const n=f();n.activeTime>=1e3&&t(c.endpoint,{n:"engagement",d:c.site,u:S,r:null,s:e(),sd:n.maxScrollDepth,e:n.activeTime},void 0,c.siteId),i=Date.now(),o=0,s=0,r=!0}L=!1,S=location.href,E.trackPageview(),b(),c.scrollTargets.length>0&&function(t,e,n){const i=e.filter(t=>t.path===n);if(0===i.length)return;const o=new Set;let r=!1;y=()=>{r||(r=!0,requestAnimationFrame(()=>{var e;const n=Math.max(document.documentElement.scrollHeight||0,(null===(e=document.body)||void 0===e?void 0:e.scrollHeight)||0),s=window.innerHeight||0,c=window.scrollY||0,a=n<=s?100:Math.round((c+s)/n*100);for(const e of i)!o.has(e.goalName)&&a>=e.threshold&&(o.add(e.goalName),t(e.goalName));r=!1}))},document.addEventListener("scroll",y,{passive:!0})}(t=>E.track(t),c.scrollTargets,location.pathname)},c.hashRouting),function(t,e){w(),p=n=>{const i=function(t){let e=t;for(;e&&"A"!==e.tagName;)e=e.parentElement;return e}(n.target);if(!i||!i.href)return;const o=i.href,r=o.split("?")[0];e.fileDownloads&&function(t){var e;const n=null===(e=t.split("?")[0].split(".").pop())||void 0===e?void 0:e.toLowerCase();return!!n&&h.includes(n)}(o)?t("File Download",{props:{url:r}}):e.outboundLinks&&function(t){return""!==t.host&&t.host!==location.host}(i)&&t("Outbound Link: Click",{props:{url:o}})},document.addEventListener("click",p),e.formSubmissions&&(g=e=>{const n=e.target;(n.hasAttribute("novalidate")||n.checkValidity())&&t("Form Submission")},document.addEventListener("submit",g,!0))}((t,e)=>E.track(t,e),{outboundLinks:c.outboundLinks,fileDownloads:c.fileDownloads,formSubmissions:c.formSubmissions});const k=()=>{if("hidden"===document.visibilityState){const n=f();n.activeTime>=1e3&&function(e,n,i){const o=JSON.stringify(n);if("undefined"!=typeof navigator&&navigator.sendBeacon){const t=new Blob([o],{type:"text/plain"});if(navigator.sendBeacon(e,t))return}t(e,n,void 0,i)}(c.endpoint,{n:"engagement",d:c.site,u:S,r:null,s:e(),sd:n.maxScrollDepth,e:n.activeTime},c.siteId)}};return document.addEventListener("visibilitychange",k),()=>{null==n||n(),n=null,m(),w(),b(),document.removeEventListener("visibilitychange",k)}}!function(){var n;const i=document.currentScript;if(!i)return;const o="undefined"!=typeof __PAGEVIEWS_CONFIG__?__PAGEVIEWS_CONFIG__:null;if(!o)return;const r=i.getAttribute("data-api")||void 0,s=function(t,e){return e||"https://data.pageviews.ai/api/event"}(i.src,r),c=Object.assign(Object.assign({},o),{endpoint:s}),{tracker:a}=function(n){const i=function(n){const i="localhost"===(o=location.hostname)||/^127(\.[0-9]+){0,2}\.[0-9]+$/.test(o)||"[::1]"===o||function(){try{return"true"===window.localStorage.getItem("pageviews_ignore")}catch(t){return!1}}()||function(){const t=window,e=navigator;return!!(t._phantom||t.__nightmare||e.webdriver||t.Cypress||t.__puppeteer_evaluation_script__||t.__playwright)}();var o;function r(e,o){i?null==o||o():t(n.endpoint,e,o,n.siteId)}return{trackPageview:function(t){const i={n:"pageview",d:n.site,u:t||location.href,r:document.referrer||null,s:e()};n.hashRouting&&(i.h=!0),r(i)},track:function(t,i){const o={n:t,d:n.site,u:(null==i?void 0:i.url)||location.href,r:document.referrer||null,s:e()};if(null==i?void 0:i.props){const t={};for(const[e,n]of Object.entries(i.props))t[e]=String(n);o.p=t}if(null==i?void 0:i.revenue){const{amount:t,currency:e}=i.revenue;t>0&&t<=1e9&&e&&(o.rv={a:t,c:e})}n.hashRouting&&(o.h=!0),r(o,null==i?void 0:i.callback)},identify:function(t){r({n:"identify",d:n.site,u:location.href,r:null,s:e(),uid:t.userId})}}}(n);let o=null;if("prerender"===document.visibilityState){const t=()=>{"visible"===document.visibilityState&&(document.removeEventListener("visibilitychange",t),o=E(n,i))};return document.addEventListener("visibilitychange",t),{tracker:i,destroy:()=>{document.removeEventListener("visibilitychange",t),null==o||o()}}}return o=E(n,i),{tracker:i,destroy:()=>{null==o||o()}}}(c),l=i.getAttribute("data-user-id");l&&a.identify({userId:l});const u=(t,...e)=>{"track"===t?a.track(e[0],e[1]):"identify"===t&&a.identify(e[0])},d=null===(n=window.pageviews)||void 0===n?void 0:n.q;Array.isArray(d)&&d.forEach(t=>u(t[0],...t.slice(1))),window.pageviews=u}()}();

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@pageviews/tracker",
+  "version": "0.1.0",
+  "description": "Lightweight, cookie-free analytics tracker for PageViews.ai",
+  "author": "Pageviews <hello@pageviews.ai>",
+  "homepage": "https://pageviews.ai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pageviews-ai/tracker"
+  },
+  "keywords": [
+    "analytics",
+    "pageviews",
+    "tracking",
+    "cookie-free",
+    "privacy",
+    "gdpr"
+  ],
+  "main": "dist/module/index.cjs",
+  "module": "dist/module/index.mjs",
+  "types": "dist/module/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/module/index.d.ts",
+      "import": "./dist/module/index.mjs",
+      "require": "./dist/module/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "prepublishOnly": "npm run test && npm run typecheck && npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@rollup/plugin-terser": "^1.0.0",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "jsdom": "^28.1.0",
+    "rollup": "^4.59.0",
+    "rollup-plugin-dts": "^6.3.0",
+    "tslib": "^2.8.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  }
+}