@agentuity/analytics 3.0.0-alpha.0

package/README.md

@@ -0,0 +1,116 @@
+# @agentuity/analytics
+
+Browser analytics for Agentuity applications. Track page views, Web Vitals, custom events, and more.
+
+## Installation
+
+```bash
+npm install @agentuity/analytics
+```
+
+## Usage
+
+### Auto-init (Drop-in)
+
+Set configuration via server-side injection, then import the beacon:
+
+```html
+<script>
+  window.__AGENTUITY_ANALYTICS__ = {
+    enabled: true,
+    orgId: 'your-org-id',
+    projectId: 'your-project-id',
+  };
+</script>
+<script type="module" src="/path/to/analytics/beacon.js"></script>
+```
+
+Or in a bundler:
+
+```typescript
+import '@agentuity/analytics/beacon';
+```
+
+### Programmatic
+
+```typescript
+import { init, track, identify, flush } from '@agentuity/analytics';
+
+// Initialize
+init({
+  orgId: 'your-org-id',
+  projectId: 'your-project-id',
+});
+
+// Track events
+track('button_click', { button: 'signup' });
+
+// Identify user
+identify('user-123', { email: 'user@example.com' });
+
+// Flush pending events
+flush();
+```
+
+## Features
+
+- **Page Views** - Automatic tracking with URL, referrer, title
+- **Web Vitals** - FCP, LCP, CLS, INP metrics
+- **Scroll Depth** - Tracks 25%, 50%, 75%, 100% milestones
+- **SPA Navigation** - Tracks route changes in single-page apps
+- **Click Tracking** - Via `[data-analytics]` attributes
+- **Error Tracking** - JS errors and unhandled rejections
+- **Custom Events** - Track any user action
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `enabled` | boolean | `true` | Enable/disable tracking |
+| `orgId` | string | - | Organization ID |
+| `projectId` | string | - | Project ID |
+| `isDevmode` | boolean | `false` | Development mode (logs to console) |
+| `trackClicks` | boolean | `true` | Track `[data-analytics]` clicks |
+| `trackScroll` | boolean | `true` | Track scroll depth |
+| `trackWebVitals` | boolean | `true` | Track Core Web Vitals |
+| `trackErrors` | boolean | `true` | Track JS errors |
+| `trackSPANavigation` | boolean | `true` | Track SPA route changes |
+| `sampleRate` | number | `1` | Sampling rate (0-1) |
+| `endpoint` | string | `/_agentuity/webanalytics/collect` | Collect endpoint |
+
+## Data Collected
+
+The beacon collects:
+
+- **Page**: URL, path, referrer, title
+- **Device**: Screen size, viewport, device pixel ratio, user agent
+- **Performance**: TTFB, DOM ready, load time, Web Vitals
+- **Engagement**: Scroll depth, time on page
+- **Context**: Language, timezone, UTM parameters
+- **Geo**: Country, region, city (from IP, cached)
+
+## Privacy
+
+- Query strings are stripped from URLs to prevent sensitive data leakage
+- No cookies used (uses localStorage for visitor ID)
+- Geo data cached in sessionStorage
+- User opt-out supported via `setOptOut(true)`
+
+## Server Integration
+
+The beacon sends data to `/_agentuity/webanalytics/collect` by default. Configure your server to:
+
+1. Inject `window.__AGENTUITY_ANALYTICS__` config
+2. Handle POST requests to the collect endpoint
+
+## Framework Support
+
+Works with any frontend framework:
+
+- React
+- Vue
+- Svelte
+- Solid
+- Vanilla JS
+
+No framework-specific code required.

package/dist/beacon.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Analytics beacon - auto-initializing script
+ *
+ * Import this module to automatically start tracking:
+ * ```typescript
+ * import '@agentuity/analytics/beacon';
+ * ```
+ *
+ * Requires window.__AGENTUITY_ANALYTICS__ to be set by server.
+ */
+export {};
+//# sourceMappingURL=beacon.d.ts.map

package/dist/beacon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beacon.d.ts","sourceRoot":"","sources":["../src/beacon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/beacon.js

@@ -0,0 +1,300 @@
+/**
+ * Analytics beacon - auto-initializing script
+ *
+ * Import this module to automatically start tracking:
+ * ```typescript
+ * import '@agentuity/analytics/beacon';
+ * ```
+ *
+ * Requires window.__AGENTUITY_ANALYTICS__ to be set by server.
+ */
+import { isEnabled, getConfig, isDevmode } from './config';
+import { initClient, updatePageView, resetSession, send, track, setupGlobal, getPageView, } from './client';
+import { generateId, stripQueryString, getUTMParams, fetchGeo } from './util';
+// Track if already initialized
+let initialized = false;
+/**
+ * Initialize page view data
+ */
+function initPageView() {
+    const pv = {
+        id: generateId(),
+        timestamp: Date.now(),
+        timezone_offset: new Date().getTimezoneOffset(),
+        url: stripQueryString(location.href),
+        path: location.pathname,
+        referrer: stripQueryString(document.referrer),
+        title: document.title || '',
+        screen_width: screen.width || 0,
+        screen_height: screen.height || 0,
+        viewport_width: innerWidth || 0,
+        viewport_height: innerHeight || 0,
+        device_pixel_ratio: devicePixelRatio || 1,
+        user_agent: navigator.userAgent || '',
+        language: navigator.language || '',
+        scroll_depth: 0,
+        time_on_page: 0,
+        scroll_events: [],
+        custom_events: [],
+    };
+    // Add UTM params
+    const utm = getUTMParams();
+    for (const k in utm) {
+        pv[k] = utm[k];
+    }
+    // Capture navigation timing
+    if (typeof performance !== 'undefined' && performance.getEntriesByType) {
+        const nav = performance.getEntriesByType('navigation')[0];
+        if (nav) {
+            pv.dom_ready = Math.round(nav.domContentLoadedEventEnd - nav.startTime);
+            pv.ttfb = Math.round(nav.responseStart - nav.requestStart);
+            if (nav.loadEventEnd > 0) {
+                pv.load_time = Math.round(nav.loadEventEnd - nav.startTime);
+            }
+            else {
+                // Defer reading loadEventEnd
+                setTimeout(() => {
+                    const navAfter = performance.getEntriesByType('navigation')[0];
+                    if (navAfter && navAfter.loadEventEnd > 0) {
+                        updatePageView({
+                            load_time: Math.round(navAfter.loadEventEnd - navAfter.startTime),
+                        });
+                    }
+                }, 0);
+            }
+        }
+    }
+    return pv;
+}
+/**
+ * Set up visibility change handlers
+ */
+function setupVisibilityHandlers() {
+    document.addEventListener('visibilitychange', () => {
+        if (document.visibilityState === 'hidden') {
+            send();
+        }
+        else if (document.visibilityState === 'visible') {
+            // User returned - start new attention session
+            resetSession();
+        }
+    });
+    window.addEventListener('pagehide', () => send());
+    window.addEventListener('beforeunload', () => send());
+}
+/**
+ * Set up scroll tracking
+ */
+function setupScrollTracking() {
+    const config = getConfig();
+    if (config?.trackScroll === false)
+        return;
+    const scrolled = new Set();
+    function getScrollDepth() {
+        const st = window.scrollY || document.documentElement.scrollTop;
+        const sh = document.documentElement.scrollHeight - document.documentElement.clientHeight;
+        return sh <= 0 ? 100 : Math.min(100, Math.round((st / sh) * 100));
+    }
+    window.addEventListener('scroll', () => {
+        const depth = getScrollDepth();
+        updatePageView({ scroll_depth: depth });
+        for (const m of [25, 50, 75, 100]) {
+            if (depth >= m && !scrolled.has(m)) {
+                scrolled.add(m);
+                const pv = getPageView();
+                if (pv) {
+                    pv.scroll_events.push({
+                        depth: m,
+                        timestamp: Date.now(),
+                    });
+                }
+            }
+        }
+    }, { passive: true });
+}
+/**
+ * Set up Web Vitals tracking
+ */
+function setupWebVitals() {
+    const config = getConfig();
+    if (config?.trackWebVitals === false)
+        return;
+    if (typeof PerformanceObserver === 'undefined')
+        return;
+    // FCP
+    try {
+        const fcpObs = new PerformanceObserver((list) => {
+            for (const entry of list.getEntries()) {
+                if (entry.name === 'first-contentful-paint') {
+                    updatePageView({ fcp: Math.round(entry.startTime) });
+                    fcpObs.disconnect();
+                }
+            }
+        });
+        fcpObs.observe({ type: 'paint', buffered: true });
+    }
+    catch {
+        /* Not supported */
+    }
+    // LCP
+    try {
+        new PerformanceObserver((list) => {
+            const entries = list.getEntries();
+            const last = entries[entries.length - 1];
+            if (last) {
+                updatePageView({ lcp: Math.round(last.startTime) });
+            }
+        }).observe({ type: 'largest-contentful-paint', buffered: true });
+    }
+    catch {
+        /* Not supported */
+    }
+    // CLS
+    try {
+        let clsValue = 0;
+        new PerformanceObserver((list) => {
+            for (const entry of list.getEntries()) {
+                const shift = entry;
+                if (!shift.hadRecentInput && shift.value) {
+                    clsValue += shift.value;
+                }
+            }
+            updatePageView({ cls: Math.round(clsValue * 1000) / 1000 });
+        }).observe({ type: 'layout-shift', buffered: true });
+    }
+    catch {
+        /* Not supported */
+    }
+    // INP
+    try {
+        let inpValue = 0;
+        new PerformanceObserver((list) => {
+            for (const entry of list.getEntries()) {
+                const event = entry;
+                if (event.duration && event.duration > inpValue) {
+                    inpValue = event.duration;
+                }
+            }
+            updatePageView({ inp: Math.round(inpValue) });
+        }).observe({ type: 'event', buffered: true });
+    }
+    catch {
+        /* Not supported */
+    }
+}
+/**
+ * Set up SPA navigation tracking
+ */
+function setupSPANavigation() {
+    const config = getConfig();
+    if (config?.trackSPANavigation === false)
+        return;
+    let currentPath = location.pathname + location.search;
+    let lastHref = location.href;
+    function handleNav() {
+        const newPath = location.pathname + location.search;
+        if (newPath !== currentPath) {
+            send(true); // Force send on SPA nav
+            currentPath = newPath;
+            lastHref = location.href;
+            initClient(initPageView());
+        }
+    }
+    // Monkey-patch history
+    const origPush = history.pushState;
+    const origReplace = history.replaceState;
+    history.pushState = function (...args) {
+        origPush.apply(this, args);
+        setTimeout(handleNav, 0);
+    };
+    history.replaceState = function (...args) {
+        origReplace.apply(this, args);
+        setTimeout(handleNav, 0);
+    };
+    window.addEventListener('popstate', handleNav);
+    // Fallback: poll for URL changes
+    setInterval(() => {
+        if (location.href !== lastHref) {
+            lastHref = location.href;
+            handleNav();
+        }
+    }, 200);
+}
+/**
+ * Set up click tracking
+ */
+function setupClickTracking() {
+    const config = getConfig();
+    if (config?.trackClicks === false)
+        return;
+    document.addEventListener('click', (e) => {
+        const target = e.target;
+        if (!target)
+            return;
+        const el = target.closest('[data-analytics]');
+        if (!el)
+            return;
+        const name = 'click:' + el.getAttribute('data-analytics');
+        track(name);
+    }, true);
+}
+/**
+ * Set up error tracking
+ */
+function setupErrorTracking() {
+    const config = getConfig();
+    if (config?.trackErrors === false)
+        return;
+    window.addEventListener('error', (e) => {
+        track('error:js_error', {
+            message: e.message || 'Unknown',
+            filename: e.filename || '',
+            lineno: e.lineno || 0,
+        });
+    });
+    window.addEventListener('unhandledrejection', (e) => {
+        track('error:unhandled_rejection', {
+            message: e.reason instanceof Error ? e.reason.message : String(e.reason),
+        });
+    });
+}
+/**
+ * Initialize the beacon
+ */
+function init() {
+    if (initialized)
+        return;
+    if (!isEnabled())
+        return;
+    initialized = true;
+    // Init page view
+    const pv = initPageView();
+    initClient(pv);
+    // Fetch geo (async)
+    fetchGeo();
+    // Set up all tracking
+    setupVisibilityHandlers();
+    setupScrollTracking();
+    setupWebVitals();
+    setupSPANavigation();
+    setupClickTracking();
+    setupErrorTracking();
+    // Set up global API
+    setupGlobal();
+    // Init on load if not ready
+    if (document.readyState === 'complete') {
+        // Already loaded
+    }
+    else {
+        window.addEventListener('load', () => {
+            // Re-capture timing after load
+            updatePageView(initPageView());
+        });
+    }
+    if (isDevmode()) {
+        console.debug('[Agentuity Analytics] Beacon initialized');
+    }
+}
+// Auto-initialize on import
+init();
+//# sourceMappingURL=beacon.js.map

package/dist/beacon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"beacon.js","sourceRoot":"","sources":["../src/beacon.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Analytics client - programmatic API
+ */
+import type { AnalyticsClient, PageViewData } from './types';
+/**
+ * Initialize client with page view data
+ * Called by beacon or can be called manually
+ */
+export declare function initClient(pv: PageViewData): void;
+/**
+ * Update page view data
+ */
+export declare function updatePageView(updates: Partial<PageViewData>): void;
+/**
+ * Get current page view data
+ */
+export declare function getPageView(): PageViewData | null;
+/**
+ * Reset session (keep page-level metrics, reset session metrics)
+ */
+export declare function resetSession(): void;
+/**
+ * Send analytics data
+ */
+export declare function send(force?: boolean): void;
+/**
+ * Track a custom event
+ */
+export declare function track(name: string, properties?: Record<string, unknown>): void;
+/**
+ * Identify a user
+ */
+export declare function identify(id: string, traits?: Record<string, unknown>): void;
+/**
+ * Flush pending events
+ */
+export declare function flush(): void;
+/**
+ * Get the analytics client
+ */
+export declare function getClient(): AnalyticsClient;
+/**
+ * Set up client as window.global
+ */
+export declare function setupGlobal(): void;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAoB,MAAM,SAAS,CAAC;AAoB/E;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAKjD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAInE;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,YAAY,GAAG,IAAI,CAEjD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAWnC;AA0BD;;GAEG;AACH,wBAAgB,IAAI,CAAC,KAAK,UAAQ,GAAG,IAAI,CAsCxC;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAS9E;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAQ3E;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,IAAI,CAE5B;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,eAAe,CAM3C;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAIlC"}

package/dist/client.js

@@ -0,0 +1,171 @@
+/**
+ * Analytics client - programmatic API
+ */
+import { isEnabled, getConfig, getEndpoint } from './config';
+import { generateId, safeStringify, getVisitorId } from './util';
+/** Pending custom events */
+let customEvents = [];
+/** Current user ID */
+let userId = '';
+/** Current user traits */
+let userTraits = {};
+/** Current page view data */
+let pageView = null;
+/** Whether current page view was sent */
+let sent = false;
+/** Page view start time */
+let pageStart = Date.now();
+/**
+ * Initialize client with page view data
+ * Called by beacon or can be called manually
+ */
+export function initClient(pv) {
+    pageView = pv;
+    customEvents = [];
+    sent = false;
+    pageStart = Date.now();
+}
+/**
+ * Update page view data
+ */
+export function updatePageView(updates) {
+    if (pageView) {
+        Object.assign(pageView, updates);
+    }
+}
+/**
+ * Get current page view data
+ */
+export function getPageView() {
+    return pageView;
+}
+/**
+ * Reset session (keep page-level metrics, reset session metrics)
+ */
+export function resetSession() {
+    if (pageView) {
+        pageView.id = generateId();
+        pageView.timestamp = Date.now();
+        pageView.scroll_events = [];
+        pageView.custom_events = customEvents;
+        pageView.scroll_depth = 0;
+        pageView.time_on_page = 0;
+    }
+    sent = false;
+    pageStart = Date.now();
+}
+/**
+ * Build payload for sending
+ */
+function buildPayload() {
+    if (!pageView)
+        return null;
+    const config = getConfig();
+    if (!config)
+        return null;
+    return {
+        org_id: config.orgId,
+        project_id: config.projectId,
+        visitor_id: getVisitorId(),
+        user_id: userId,
+        user_traits: userTraits,
+        is_devmode: config.isDevmode ?? false,
+        pageview: {
+            ...pageView,
+            custom_events: customEvents,
+            time_on_page: Date.now() - pageStart,
+        },
+    };
+}
+/**
+ * Send analytics data
+ */
+export function send(force = false) {
+    if (sent && !force)
+        return;
+    if (!isEnabled())
+        return;
+    const config = getConfig();
+    if (!config)
+        return;
+    // Check sample rate
+    if (config.sampleRate !== undefined && config.sampleRate < 1) {
+        if (Math.random() > config.sampleRate)
+            return;
+    }
+    sent = true;
+    const payload = buildPayload();
+    if (!payload)
+        return;
+    // Dev mode: just log
+    if (config.isDevmode) {
+        console.debug('[Agentuity Analytics]', JSON.stringify(payload, null, 2));
+        return;
+    }
+    // Production: send to endpoint
+    const body = JSON.stringify(payload);
+    const endpoint = getEndpoint();
+    if (navigator.sendBeacon) {
+        navigator.sendBeacon(endpoint, body);
+    }
+    else {
+        fetch(endpoint, {
+            method: 'POST',
+            body,
+            keepalive: true,
+        }).catch(() => {
+            // Silent failure
+        });
+    }
+}
+/**
+ * Track a custom event
+ */
+export function track(name, properties) {
+    if (!isEnabled())
+        return;
+    if (customEvents.length >= 1000)
+        return;
+    customEvents.push({
+        timestamp: Date.now(),
+        name,
+        data: safeStringify(properties),
+    });
+}
+/**
+ * Identify a user
+ */
+export function identify(id, traits) {
+    userId = id;
+    if (traits) {
+        userTraits = {};
+        for (const [key, value] of Object.entries(traits)) {
+            userTraits[key] = String(value);
+        }
+    }
+}
+/**
+ * Flush pending events
+ */
+export function flush() {
+    send(true);
+}
+/**
+ * Get the analytics client
+ */
+export function getClient() {
+    return {
+        track,
+        identify,
+        flush,
+    };
+}
+/**
+ * Set up client as window.global
+ */
+export function setupGlobal() {
+    if (typeof window !== 'undefined') {
+        window.agentuityAnalytics = getClient();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}