@agentuity/frontend 0.0.111 → 0.1.0

package/dist/analytics/collectors/spa.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Initialize SPA navigation tracking
+ * Hooks into history.pushState, history.replaceState, and popstate event
+ */
+export declare function initSPATracking(): void;
+/**
+ * Cleanup SPA tracking (for testing)
+ */
+export declare function cleanupSPATracking(): void;
+//# sourceMappingURL=spa.d.ts.map

package/dist/analytics/collectors/spa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spa.d.ts","sourceRoot":"","sources":["../../../src/analytics/collectors/spa.ts"],"names":[],"mappings":"AAiBA;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAuBtC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAUzC"}

package/dist/analytics/collectors/spa.js

@@ -0,0 +1,53 @@
+import { trackPageview } from './pageview';
+let currentPath = '';
+let originalPushState = null;
+let originalReplaceState = null;
+/**
+ * Handle URL change for SPA navigation
+ */
+function handleUrlChange() {
+    const newPath = window.location.pathname;
+    if (newPath !== currentPath) {
+        currentPath = newPath;
+        trackPageview(newPath);
+    }
+}
+/**
+ * Initialize SPA navigation tracking
+ * Hooks into history.pushState, history.replaceState, and popstate event
+ */
+export function initSPATracking() {
+    if (typeof window === 'undefined' || typeof history === 'undefined') {
+        return;
+    }
+    currentPath = window.location.pathname;
+    // Hook into history.pushState
+    originalPushState = history.pushState.bind(history);
+    history.pushState = function (...args) {
+        originalPushState?.apply(this, args);
+        handleUrlChange();
+    };
+    // Hook into history.replaceState
+    originalReplaceState = history.replaceState.bind(history);
+    history.replaceState = function (...args) {
+        originalReplaceState?.apply(this, args);
+        handleUrlChange();
+    };
+    // Listen for popstate (back/forward navigation)
+    window.addEventListener('popstate', handleUrlChange);
+}
+/**
+ * Cleanup SPA tracking (for testing)
+ */
+export function cleanupSPATracking() {
+    if (originalPushState) {
+        history.pushState = originalPushState;
+        originalPushState = null;
+    }
+    if (originalReplaceState) {
+        history.replaceState = originalReplaceState;
+        originalReplaceState = null;
+    }
+    window.removeEventListener('popstate', handleUrlChange);
+}
+//# sourceMappingURL=spa.js.map

package/dist/analytics/collectors/spa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spa.js","sourceRoot":"","sources":["../../../src/analytics/collectors/spa.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,IAAI,WAAW,GAAG,EAAE,CAAC;AACrB,IAAI,iBAAiB,GAAoC,IAAI,CAAC;AAC9D,IAAI,oBAAoB,GAAuC,IAAI,CAAC;AAEpE;;GAEG;AACH,SAAS,eAAe;IACvB,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACzC,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;QAC7B,WAAW,GAAG,OAAO,CAAC;QACtB,aAAa,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC9B,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;QACrE,OAAO;IACR,CAAC;IAED,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAEvC,8BAA8B;IAC9B,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpD,OAAO,CAAC,SAAS,GAAG,UAAU,GAAG,IAAI;QACpC,iBAAiB,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACrC,eAAe,EAAE,CAAC;IACnB,CAAC,CAAC;IAEF,iCAAiC;IACjC,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1D,OAAO,CAAC,YAAY,GAAG,UAAU,GAAG,IAAI;QACvC,oBAAoB,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACxC,eAAe,EAAE,CAAC;IACnB,CAAC,CAAC;IAEF,gDAAgD;IAChD,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IACjC,IAAI,iBAAiB,EAAE,CAAC;QACvB,OAAO,CAAC,SAAS,GAAG,iBAAiB,CAAC;QACtC,iBAAiB,GAAG,IAAI,CAAC;IAC1B,CAAC;IACD,IAAI,oBAAoB,EAAE,CAAC;QAC1B,OAAO,CAAC,YAAY,GAAG,oBAAoB,CAAC;QAC5C,oBAAoB,GAAG,IAAI,CAAC;IAC7B,CAAC;IACD,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;AACzD,CAAC"}

package/dist/analytics/collectors/visibility.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Initialize visibility tracking
+ * Tracks when user leaves/returns to the page
+ */
+export declare function initVisibilityTracking(): void;
+/**
+ * Remove visibility tracking listener
+ */
+export declare function removeVisibilityTracking(): void;
+/**
+ * Reset visibility tracking (for SPA navigation)
+ */
+export declare function resetVisibilityTracking(): void;
+/**
+ * Get current time on page
+ */
+export declare function getCurrentTimeOnPage(): number;
+//# sourceMappingURL=visibility.d.ts.map

package/dist/analytics/collectors/visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../../src/analytics/collectors/visibility.ts"],"names":[],"mappings":"AAsBA;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAwC7C;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAM/C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAI9C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}

package/dist/analytics/collectors/visibility.js

@@ -0,0 +1,81 @@
+import { createBaseEvent } from './pageview';
+import { queueEvent } from '../events';
+import { getMaxScrollDepth } from './scroll';
+let pageEntryTime = 0;
+let hiddenTime = 0;
+let lastHiddenTimestamp = 0;
+let visibilityTrackingInitialized = false;
+let visibilityChangeHandler = null;
+/**
+ * Get total time spent on page (excluding hidden time)
+ */
+function getTimeOnPage() {
+    if (pageEntryTime === 0) {
+        return 0;
+    }
+    const totalTime = Date.now() - pageEntryTime;
+    return Math.max(0, totalTime - hiddenTime);
+}
+/**
+ * Initialize visibility tracking
+ * Tracks when user leaves/returns to the page
+ */
+export function initVisibilityTracking() {
+    if (typeof document === 'undefined') {
+        return;
+    }
+    if (visibilityTrackingInitialized) {
+        return;
+    }
+    visibilityTrackingInitialized = true;
+    pageEntryTime = Date.now();
+    hiddenTime = 0;
+    lastHiddenTimestamp = 0;
+    visibilityChangeHandler = () => {
+        if (document.visibilityState === 'hidden') {
+            lastHiddenTimestamp = Date.now();
+            // Track page leave with engagement metrics
+            const event = createBaseEvent('visibility');
+            event.event_name = 'page_hidden';
+            event.time_on_page = getTimeOnPage();
+            event.scroll_depth = getMaxScrollDepth();
+            queueEvent(event);
+        }
+        else if (document.visibilityState === 'visible') {
+            // Calculate hidden duration
+            if (lastHiddenTimestamp > 0) {
+                hiddenTime += Date.now() - lastHiddenTimestamp;
+                lastHiddenTimestamp = 0;
+            }
+            const event = createBaseEvent('visibility');
+            event.event_name = 'page_visible';
+            queueEvent(event);
+        }
+    };
+    document.addEventListener('visibilitychange', visibilityChangeHandler);
+}
+/**
+ * Remove visibility tracking listener
+ */
+export function removeVisibilityTracking() {
+    if (visibilityChangeHandler) {
+        document.removeEventListener('visibilitychange', visibilityChangeHandler);
+        visibilityChangeHandler = null;
+    }
+    visibilityTrackingInitialized = false;
+}
+/**
+ * Reset visibility tracking (for SPA navigation)
+ */
+export function resetVisibilityTracking() {
+    pageEntryTime = Date.now();
+    hiddenTime = 0;
+    lastHiddenTimestamp = 0;
+}
+/**
+ * Get current time on page
+ */
+export function getCurrentTimeOnPage() {
+    return getTimeOnPage();
+}
+//# sourceMappingURL=visibility.js.map

package/dist/analytics/collectors/visibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.js","sourceRoot":"","sources":["../../../src/analytics/collectors/visibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,IAAI,aAAa,GAAG,CAAC,CAAC;AACtB,IAAI,UAAU,GAAG,CAAC,CAAC;AACnB,IAAI,mBAAmB,GAAG,CAAC,CAAC;AAC5B,IAAI,6BAA6B,GAAG,KAAK,CAAC;AAC1C,IAAI,uBAAuB,GAAwB,IAAI,CAAC;AAExD;;GAEG;AACH,SAAS,aAAa;IACrB,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,CAAC;IACV,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC;IAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACrC,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACrC,OAAO;IACR,CAAC;IAED,IAAI,6BAA6B,EAAE,CAAC;QACnC,OAAO;IACR,CAAC;IACD,6BAA6B,GAAG,IAAI,CAAC;IAErC,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,UAAU,GAAG,CAAC,CAAC;IACf,mBAAmB,GAAG,CAAC,CAAC;IAExB,uBAAuB,GAAG,GAAG,EAAE;QAC9B,IAAI,QAAQ,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;YAC3C,mBAAmB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAEjC,2CAA2C;YAC3C,MAAM,KAAK,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;YAC5C,KAAK,CAAC,UAAU,GAAG,aAAa,CAAC;YACjC,KAAK,CAAC,YAAY,GAAG,aAAa,EAAE,CAAC;YACrC,KAAK,CAAC,YAAY,GAAG,iBAAiB,EAAE,CAAC;YAEzC,UAAU,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;aAAM,IAAI,QAAQ,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACnD,4BAA4B;YAC5B,IAAI,mBAAmB,GAAG,CAAC,EAAE,CAAC;gBAC7B,UAAU,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,mBAAmB,CAAC;gBAC/C,mBAAmB,GAAG,CAAC,CAAC;YACzB,CAAC;YAED,MAAM,KAAK,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;YAC5C,KAAK,CAAC,UAAU,GAAG,cAAc,CAAC;YAElC,UAAU,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;IACF,CAAC,CAAC;IAEF,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,uBAAuB,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACvC,IAAI,uBAAuB,EAAE,CAAC;QAC7B,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,uBAAuB,CAAC,CAAC;QAC1E,uBAAuB,GAAG,IAAI,CAAC;IAChC,CAAC;IACD,6BAA6B,GAAG,KAAK,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACtC,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,UAAU,GAAG,CAAC,CAAC;IACf,mBAAmB,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IACnC,OAAO,aAAa,EAAE,CAAC;AACxB,CAAC"}

package/dist/analytics/collectors/webvitals.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Initialize Core Web Vitals tracking
+ * Uses PerformanceObserver to track LCP, FCP, CLS, INP
+ */
+export declare function initWebVitalsTracking(): void;
+//# sourceMappingURL=webvitals.d.ts.map

package/dist/analytics/collectors/webvitals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webvitals.d.ts","sourceRoot":"","sources":["../../../src/analytics/collectors/webvitals.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAyH5C"}

package/dist/analytics/collectors/webvitals.js

@@ -0,0 +1,111 @@
+import { createBaseEvent } from './pageview';
+import { queueEvent, flushEvents } from '../events';
+/**
+ * Initialize Core Web Vitals tracking
+ * Uses PerformanceObserver to track LCP, FCP, CLS, INP
+ */
+export function initWebVitalsTracking() {
+    if (typeof window === 'undefined' || typeof PerformanceObserver === 'undefined') {
+        return;
+    }
+    // Track First Contentful Paint (FCP)
+    try {
+        const fcpObserver = new PerformanceObserver((list) => {
+            for (const entry of list.getEntries()) {
+                if (entry.name === 'first-contentful-paint') {
+                    const event = createBaseEvent('web_vital');
+                    event.event_name = 'fcp';
+                    event.fcp = Math.round(entry.startTime);
+                    queueEvent(event);
+                    flushEvents();
+                    fcpObserver.disconnect();
+                }
+            }
+        });
+        fcpObserver.observe({ type: 'paint', buffered: true });
+    }
+    catch {
+        // PerformanceObserver not supported for this entry type
+    }
+    // Track Largest Contentful Paint (LCP)
+    try {
+        let lcpValue = 0;
+        const lcpObserver = new PerformanceObserver((list) => {
+            const entries = list.getEntries();
+            const lastEntry = entries[entries.length - 1];
+            if (lastEntry) {
+                lcpValue = lastEntry.startTime;
+            }
+        });
+        lcpObserver.observe({ type: 'largest-contentful-paint', buffered: true });
+        // Report LCP when page becomes hidden
+        document.addEventListener('visibilitychange', () => {
+            if (document.visibilityState === 'hidden' && lcpValue > 0) {
+                const event = createBaseEvent('web_vital');
+                event.event_name = 'lcp';
+                event.lcp = Math.round(lcpValue);
+                queueEvent(event);
+                flushEvents();
+                lcpObserver.disconnect();
+            }
+        }, { once: true });
+    }
+    catch {
+        // PerformanceObserver not supported for this entry type
+    }
+    // Track Cumulative Layout Shift (CLS)
+    try {
+        let clsValue = 0;
+        const clsObserver = new PerformanceObserver((list) => {
+            for (const entry of list.getEntries()) {
+                const layoutShift = entry;
+                if (!layoutShift.hadRecentInput && layoutShift.value) {
+                    clsValue += layoutShift.value;
+                }
+            }
+        });
+        clsObserver.observe({ type: 'layout-shift', buffered: true });
+        // Report CLS when page becomes hidden
+        document.addEventListener('visibilitychange', () => {
+            if (document.visibilityState === 'hidden') {
+                const event = createBaseEvent('web_vital');
+                event.event_name = 'cls';
+                event.cls = Math.round(clsValue * 1000) / 1000; // Round to 3 decimal places
+                queueEvent(event);
+                flushEvents();
+                clsObserver.disconnect();
+            }
+        }, { once: true });
+    }
+    catch {
+        // PerformanceObserver not supported for this entry type
+    }
+    // Track Interaction to Next Paint (INP)
+    try {
+        let inpValue = 0;
+        const inpObserver = new PerformanceObserver((list) => {
+            for (const entry of list.getEntries()) {
+                const eventEntry = entry;
+                if (eventEntry.duration && eventEntry.duration > inpValue) {
+                    inpValue = eventEntry.duration;
+                }
+            }
+        });
+        inpObserver.observe({ type: 'event', buffered: true });
+        // Report INP when page becomes hidden
+        document.addEventListener('visibilitychange', () => {
+            if (document.visibilityState === 'hidden' && inpValue > 0) {
+                const event = createBaseEvent('web_vital');
+                event.event_name = 'inp';
+                event.inp = Math.round(inpValue);
+                queueEvent(event);
+                flushEvents();
+                inpObserver.disconnect();
+            }
+        }, { once: true });
+    }
+    catch {
+        // PerformanceObserver not supported for this entry type
+    }
+}
+//# sourceMappingURL=webvitals.js.map

package/dist/analytics/collectors/webvitals.js.map

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

package/dist/analytics/events.d.ts

@@ -0,0 +1,18 @@
+import type { AnalyticsEvent, AnalyticsPageConfig } from './types';
+/**
+ * Initialize the event queue with config
+ */
+export declare function initEventQueue(pageConfig: AnalyticsPageConfig): void;
+/**
+ * Queue an event for sending
+ */
+export declare function queueEvent(event: AnalyticsEvent): void;
+/**
+ * Flush all queued events
+ */
+export declare function flushEvents(): void;
+/**
+ * Get current queue length (for testing)
+ */
+export declare function getQueueLength(): number;
+//# sourceMappingURL=events.d.ts.map

package/dist/analytics/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/analytics/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAyB,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAW1F;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAepE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CA6CtD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAoDlC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/analytics/events.js

@@ -0,0 +1,126 @@
+import { getVisitorId } from './utils/storage';
+const BATCH_SIZE = 10;
+const BATCH_TIMEOUT_MS = 5000;
+const COLLECT_ENDPOINT = '/_agentuity/webanalytics/collect';
+let eventQueue = [];
+let batchTimeout = null;
+let config = null;
+/**
+ * Initialize the event queue with config
+ */
+export function initEventQueue(pageConfig) {
+    config = pageConfig;
+    // Flush on page unload
+    if (typeof window !== 'undefined') {
+        window.addEventListener('visibilitychange', () => {
+            if (document.visibilityState === 'hidden') {
+                flushEvents();
+            }
+        });
+        window.addEventListener('pagehide', () => {
+            flushEvents();
+        });
+    }
+}
+/**
+ * Queue an event for sending
+ */
+export function queueEvent(event) {
+    if (!config) {
+        return;
+    }
+    // Apply sample rate (default: 1 = 100%)
+    const sampleRate = config.sampleRate ?? 1;
+    if (sampleRate < 1 && Math.random() > sampleRate) {
+        return;
+    }
+    // Check exclude patterns
+    const excludePatterns = config.excludePatterns ?? [];
+    if (excludePatterns.length > 0) {
+        const currentPath = window.location.pathname;
+        for (const pattern of excludePatterns) {
+            try {
+                if (new RegExp(pattern).test(currentPath)) {
+                    return;
+                }
+            }
+            catch {
+                // Invalid regex, skip
+            }
+        }
+    }
+    // Add global properties to event data
+    if (config.globalProperties && Object.keys(config.globalProperties).length > 0) {
+        event.event_data = {
+            ...config.globalProperties,
+            ...event.event_data,
+        };
+    }
+    eventQueue.push(event);
+    // Flush if batch size reached
+    if (eventQueue.length >= BATCH_SIZE) {
+        flushEvents();
+    }
+    else if (!batchTimeout) {
+        // Set timeout for batch flush
+        batchTimeout = setTimeout(() => {
+            flushEvents();
+        }, BATCH_TIMEOUT_MS);
+    }
+}
+/**
+ * Flush all queued events
+ */
+export function flushEvents() {
+    if (batchTimeout) {
+        clearTimeout(batchTimeout);
+        batchTimeout = null;
+    }
+    if (eventQueue.length === 0 || !config) {
+        return;
+    }
+    const events = eventQueue;
+    eventQueue = [];
+    // In dev mode, log to console instead of sending
+    if (config.isDevmode) {
+        console.debug('[Agentuity Analytics] Events:', events);
+        return;
+    }
+    const payload = {
+        org_id: config.orgId,
+        project_id: config.projectId,
+        session_id: config.sessionId,
+        thread_id: config.threadId,
+        visitor_id: getVisitorId(),
+        is_devmode: config.isDevmode,
+        events,
+    };
+    const body = JSON.stringify(payload);
+    // Use sendBeacon for reliable delivery
+    if (typeof navigator !== 'undefined' && navigator.sendBeacon) {
+        const sent = navigator.sendBeacon(COLLECT_ENDPOINT, body);
+        if (sent) {
+            return;
+        }
+    }
+    // Fallback to fetch with keepalive
+    if (typeof fetch !== 'undefined') {
+        fetch(COLLECT_ENDPOINT, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body,
+            keepalive: true,
+        }).catch(() => {
+            // Silent failure - analytics is best effort
+        });
+    }
+}
+/**
+ * Get current queue length (for testing)
+ */
+export function getQueueLength() {
+    return eventQueue.length;
+}
+//# sourceMappingURL=events.js.map

package/dist/analytics/events.js.map

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

package/dist/analytics/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Web Analytics for Agentuity SDK applications
+ *
+ * This module provides client-side analytics tracking for web applications
+ * built with the Agentuity SDK.
+ */
+export { getAnalytics, track, initBeacon } from './beacon';
+export type { AnalyticsClient, AnalyticsEvent, AnalyticsEventType, AnalyticsBatchPayload, AnalyticsPageConfig, } from './types';
+export { trackPageview, createBaseEvent } from './collectors/pageview';
+export { getVisitorId, isOptedOut, setOptOut } from './utils/storage';
+export { getUTMParams } from './utils/utm';
+//# sourceMappingURL=index.d.ts.map

package/dist/analytics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3D,YAAY,EACX,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/analytics/index.js

@@ -0,0 +1,12 @@
+/**
+ * Web Analytics for Agentuity SDK applications
+ *
+ * This module provides client-side analytics tracking for web applications
+ * built with the Agentuity SDK.
+ */
+export { getAnalytics, track, initBeacon } from './beacon';
+// Re-export utilities for advanced usage
+export { trackPageview, createBaseEvent } from './collectors/pageview';
+export { getVisitorId, isOptedOut, setOptOut } from './utils/storage';
+export { getUTMParams } from './utils/utm';
+//# sourceMappingURL=index.js.map

package/dist/analytics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAU3D,yCAAyC;AACzC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/analytics/offline.d.ts

@@ -0,0 +1,19 @@
+import type { AnalyticsEvent } from './types';
+/**
+ * Store event in IndexedDB for offline persistence
+ */
+export declare function storeOfflineEvent(event: AnalyticsEvent): Promise<void>;
+/**
+ * Get all offline events and clear them
+ */
+export declare function getAndClearOfflineEvents(): Promise<AnalyticsEvent[]>;
+/**
+ * Check if we're online
+ */
+export declare function isOnline(): boolean;
+/**
+ * Initialize offline support
+ * Listens for online event to flush queued events
+ */
+export declare function initOfflineSupport(flushCallback: () => void): void;
+//# sourceMappingURL=offline.d.ts.map

package/dist/analytics/offline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline.d.ts","sourceRoot":"","sources":["../../src/analytics/offline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA0D9C;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAuC5E;AAED;;GAEG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAgC1E;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAKlC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,IAAI,GAAG,IAAI,CASlE"}