@agentuity/frontend 0.0.111 → 0.1.0

package/dist/analytics/offline.js

@@ -0,0 +1,145 @@
+const DB_NAME = 'agentuity_analytics';
+const STORE_NAME = 'events';
+const DB_VERSION = 1;
+const MAX_QUEUE_SIZE = 1000;
+let db = null;
+let dbInitPromise = null;
+/**
+ * Initialize IndexedDB for offline event storage
+ */
+async function initDB() {
+    if (typeof indexedDB === 'undefined') {
+        return null;
+    }
+    return new Promise((resolve) => {
+        try {
+            const request = indexedDB.open(DB_NAME, DB_VERSION);
+            request.onerror = () => {
+                resolve(null);
+            };
+            request.onsuccess = () => {
+                resolve(request.result);
+            };
+            request.onupgradeneeded = (e) => {
+                const database = e.target.result;
+                if (!database.objectStoreNames.contains(STORE_NAME)) {
+                    database.createObjectStore(STORE_NAME, { keyPath: 'id' });
+                }
+            };
+        }
+        catch {
+            resolve(null);
+        }
+    });
+}
+/**
+ * Get database instance
+ */
+async function getDB() {
+    if (db) {
+        return db;
+    }
+    if (!dbInitPromise) {
+        dbInitPromise = initDB();
+    }
+    db = await dbInitPromise;
+    return db;
+}
+/**
+ * Store event in IndexedDB for offline persistence
+ */
+export async function storeOfflineEvent(event) {
+    const database = await getDB();
+    if (!database) {
+        return;
+    }
+    try {
+        const transaction = database.transaction(STORE_NAME, 'readwrite');
+        const store = transaction.objectStore(STORE_NAME);
+        // Check current count and evict old events if needed before adding
+        const count = await new Promise((resolve) => {
+            const countRequest = store.count();
+            countRequest.onsuccess = () => resolve(countRequest.result);
+            countRequest.onerror = () => resolve(0);
+        });
+        if (count >= MAX_QUEUE_SIZE) {
+            // Evict oldest event (FIFO) before adding new one
+            await new Promise((resolve) => {
+                const cursorRequest = store.openCursor();
+                cursorRequest.onsuccess = () => {
+                    const cursor = cursorRequest.result;
+                    if (cursor) {
+                        const deleteRequest = cursor.delete();
+                        deleteRequest.onsuccess = () => resolve();
+                        deleteRequest.onerror = () => resolve();
+                    }
+                    else {
+                        resolve();
+                    }
+                };
+                cursorRequest.onerror = () => resolve();
+            });
+        }
+        store.add(event);
+    }
+    catch {
+        // Silent failure
+    }
+}
+/**
+ * Get all offline events and clear them
+ */
+export async function getAndClearOfflineEvents() {
+    const database = await getDB();
+    if (!database) {
+        return [];
+    }
+    return new Promise((resolve) => {
+        try {
+            const transaction = database.transaction(STORE_NAME, 'readwrite');
+            const store = transaction.objectStore(STORE_NAME);
+            const events = [];
+            const request = store.openCursor();
+            request.onsuccess = () => {
+                const cursor = request.result;
+                if (cursor) {
+                    events.push(cursor.value);
+                    cursor.delete();
+                    cursor.continue();
+                }
+                else {
+                    resolve(events);
+                }
+            };
+            request.onerror = () => {
+                resolve([]);
+            };
+        }
+        catch {
+            resolve([]);
+        }
+    });
+}
+/**
+ * Check if we're online
+ */
+export function isOnline() {
+    if (typeof navigator === 'undefined') {
+        return true;
+    }
+    return navigator.onLine !== false;
+}
+/**
+ * Initialize offline support
+ * Listens for online event to flush queued events
+ */
+export function initOfflineSupport(flushCallback) {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    window.addEventListener('online', () => {
+        // Flush offline events when coming back online
+        flushCallback();
+    });
+}
+//# sourceMappingURL=offline.js.map

package/dist/analytics/offline.js.map

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

package/dist/analytics/types.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Analytics event types
+ */
+export type AnalyticsEventType = 'pageview' | 'click' | 'scroll' | 'visibility' | 'error' | 'custom' | 'web_vital' | 'form_submit' | 'outbound_link';
+/**
+ * Analytics event sent to the collection endpoint
+ */
+export interface AnalyticsEvent {
+    id: string;
+    timestamp: number;
+    timezone_offset: number;
+    event_type: AnalyticsEventType;
+    event_name?: string;
+    event_data?: Record<string, unknown>;
+    url: string;
+    path: string;
+    referrer: string;
+    title: string;
+    screen_width: number;
+    screen_height: number;
+    viewport_width: number;
+    viewport_height: number;
+    device_pixel_ratio: number;
+    user_agent: string;
+    language: string;
+    load_time?: number;
+    dom_ready?: number;
+    ttfb?: number;
+    fcp?: number;
+    lcp?: number;
+    cls?: number;
+    inp?: number;
+    scroll_depth?: number;
+    time_on_page?: number;
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    utm_term?: string;
+    utm_content?: string;
+}
+/**
+ * Batch payload sent to /_agentuity/webanalytics/collect
+ */
+export interface AnalyticsBatchPayload {
+    org_id: string;
+    project_id: string;
+    session_id: string;
+    thread_id: string;
+    visitor_id: string;
+    is_devmode: boolean;
+    events: AnalyticsEvent[];
+}
+/**
+ * Configuration injected by SDK runtime into window.__AGENTUITY_ANALYTICS__
+ */
+export interface AnalyticsPageConfig {
+    enabled: boolean;
+    orgId: string;
+    projectId: string;
+    sessionId: string;
+    threadId: string;
+    isDevmode: boolean;
+    trackClicks?: boolean;
+    trackScroll?: boolean;
+    trackOutboundLinks?: boolean;
+    trackForms?: boolean;
+    trackWebVitals?: boolean;
+    trackErrors?: boolean;
+    trackSPANavigation?: boolean;
+    requireConsent?: boolean;
+    sampleRate?: number;
+    excludePatterns?: string[];
+    globalProperties?: Record<string, unknown>;
+}
+/**
+ * Public analytics client interface
+ */
+export interface AnalyticsClient {
+    /**
+     * Track a custom event
+     */
+    track(eventName: string, properties?: Record<string, unknown>): void;
+    /**
+     * Identify the current user (sets visitor properties)
+     */
+    identify(userId: string, traits?: Record<string, unknown>): void;
+    /**
+     * Manually track a page view
+     */
+    pageview(path?: string): void;
+    /**
+     * Flush pending events immediately
+     */
+    flush(): Promise<void>;
+    /**
+     * Opt out of analytics
+     */
+    optOut(): void;
+    /**
+     * Opt back in to analytics
+     */
+    optIn(): void;
+    /**
+     * Check if analytics is currently enabled
+     */
+    isEnabled(): boolean;
+}
+declare global {
+    interface Window {
+        __AGENTUITY_ANALYTICS__?: AnalyticsPageConfig;
+    }
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/analytics/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/analytics/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/analytics/types.ts"],"names":[],"mappings":""}

package/dist/analytics/utils/storage.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Get or create the visitor ID from localStorage
+ */
+export declare function getVisitorId(): string;
+/**
+ * Check if user has opted out
+ */
+export declare function isOptedOut(): boolean;
+/**
+ * Set opt-out status
+ */
+export declare function setOptOut(optOut: boolean): void;
+//# sourceMappingURL=storage.d.ts.map

package/dist/analytics/utils/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/analytics/utils/storage.ts"],"names":[],"mappings":"AAiBA;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAerC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAKpC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAa/C"}

package/dist/analytics/utils/storage.js

@@ -0,0 +1,63 @@
+const VISITOR_ID_KEY = 'agentuity_visitor_id';
+const OPT_OUT_KEY = 'agentuity_analytics_optout';
+/**
+ * Generate a random UUID v4
+ */
+function generateUUID() {
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+/**
+ * Get or create the visitor ID from localStorage
+ */
+export function getVisitorId() {
+    if (typeof localStorage === 'undefined') {
+        return generateUUID();
+    }
+    let visitorId = localStorage.getItem(VISITOR_ID_KEY);
+    if (!visitorId) {
+        visitorId = `vid_${generateUUID()}`;
+        try {
+            localStorage.setItem(VISITOR_ID_KEY, visitorId);
+        }
+        catch {
+            // localStorage might be full or disabled
+        }
+    }
+    return visitorId;
+}
+/**
+ * Check if user has opted out
+ */
+export function isOptedOut() {
+    if (typeof localStorage === 'undefined') {
+        return false;
+    }
+    return localStorage.getItem(OPT_OUT_KEY) === 'true';
+}
+/**
+ * Set opt-out status
+ */
+export function setOptOut(optOut) {
+    if (typeof localStorage === 'undefined') {
+        return;
+    }
+    try {
+        if (optOut) {
+            localStorage.setItem(OPT_OUT_KEY, 'true');
+        }
+        else {
+            localStorage.removeItem(OPT_OUT_KEY);
+        }
+    }
+    catch {
+        // localStorage might be full or disabled
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/analytics/utils/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/analytics/utils/storage.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAC9C,MAAM,WAAW,GAAG,4BAA4B,CAAC;AAEjD;;GAEG;AACH,SAAS,YAAY;IACpB,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACxD,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,sCAAsC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;QACpE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAC1C,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC3B,IAAI,OAAO,YAAY,KAAK,WAAW,EAAE,CAAC;QACzC,OAAO,YAAY,EAAE,CAAC;IACvB,CAAC;IAED,IAAI,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACrD,IAAI,CAAC,SAAS,EAAE,CAAC;QAChB,SAAS,GAAG,OAAO,YAAY,EAAE,EAAE,CAAC;QACpC,IAAI,CAAC;YACJ,YAAY,CAAC,OAAO,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACR,yCAAyC;QAC1C,CAAC;IACF,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACzB,IAAI,OAAO,YAAY,KAAK,WAAW,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC;IACd,CAAC;IACD,OAAO,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,MAAM,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,MAAe;IACxC,IAAI,OAAO,YAAY,KAAK,WAAW,EAAE,CAAC;QACzC,OAAO;IACR,CAAC;IACD,IAAI,CAAC;QACJ,IAAI,MAAM,EAAE,CAAC;YACZ,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACP,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QACtC,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,yCAAyC;IAC1C,CAAC;AACF,CAAC"}

package/dist/analytics/utils/utm.d.ts

@@ -0,0 +1,12 @@
+export interface UTMParams {
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    utm_term?: string;
+    utm_content?: string;
+}
+/**
+ * Extract UTM parameters from the current URL
+ */
+export declare function getUTMParams(): UTMParams;
+//# sourceMappingURL=utm.d.ts.map

package/dist/analytics/utils/utm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utm.d.ts","sourceRoot":"","sources":["../../../src/analytics/utils/utm.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAwBxC"}

package/dist/analytics/utils/utm.js

@@ -0,0 +1,27 @@
+/**
+ * Extract UTM parameters from the current URL
+ */
+export function getUTMParams() {
+    if (typeof window === 'undefined') {
+        return {};
+    }
+    const params = new URLSearchParams(window.location.search);
+    const utm = {};
+    const source = params.get('utm_source');
+    if (source)
+        utm.utm_source = source;
+    const medium = params.get('utm_medium');
+    if (medium)
+        utm.utm_medium = medium;
+    const campaign = params.get('utm_campaign');
+    if (campaign)
+        utm.utm_campaign = campaign;
+    const term = params.get('utm_term');
+    if (term)
+        utm.utm_term = term;
+    const content = params.get('utm_content');
+    if (content)
+        utm.utm_content = content;
+    return utm;
+}
+//# sourceMappingURL=utm.js.map

package/dist/analytics/utils/utm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utm.js","sourceRoot":"","sources":["../../../src/analytics/utils/utm.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,UAAU,YAAY;IAC3B,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QACnC,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAc,EAAE,CAAC;IAE1B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACxC,IAAI,MAAM;QAAE,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC;IAEpC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACxC,IAAI,MAAM;QAAE,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC;IAEpC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC5C,IAAI,QAAQ;QAAE,GAAG,CAAC,YAAY,GAAG,QAAQ,CAAC;IAE1C,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,IAAI;QAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC;IAE9B,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC1C,IAAI,OAAO;QAAE,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC;IAEvC,OAAO,GAAG,CAAC;AACZ,CAAC"}

package/dist/index.d.ts

@@ -8,4 +8,5 @@ export { WebSocketManager, type MessageHandler as WebSocketMessageHandler, type
 export { EventStreamManager, type MessageHandler as EventStreamMessageHandler, type EventStreamCallbacks, type EventStreamManagerOptions, type EventStreamManagerState, } from './eventstream-manager';
 export { createClient } from './client/index';
 export type { Client, ClientOptions, RouteEndpoint, WebSocketClient, EventStreamClient, StreamClient, EventHandler, } from './client/types';
+export { getAnalytics, track, initBeacon, trackPageview, createBaseEvent, getVisitorId, isOptedOut, setOptOut, getUTMParams, type AnalyticsClient, type AnalyticsEvent, type AnalyticsEventType, type AnalyticsBatchPayload, type AnalyticsPageConfig, } from './analytics';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACjG,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EACN,gBAAgB,EAChB,KAAK,cAAc,IAAI,uBAAuB,EAC9C,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,kBAAkB,EAClB,KAAK,cAAc,IAAI,yBAAyB,EAChD,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,GAC5B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACX,MAAM,EACN,aAAa,EACb,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,YAAY,GACZ,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACjG,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EACN,gBAAgB,EAChB,KAAK,cAAc,IAAI,uBAAuB,EAC9C,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,kBAAkB,EAClB,KAAK,cAAc,IAAI,yBAAyB,EAChD,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,GAC5B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACX,MAAM,EACN,aAAa,EACb,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,YAAY,GACZ,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACN,YAAY,EACZ,KAAK,EACL,UAAU,EACV,aAAa,EACb,eAAe,EACf,YAAY,EACZ,UAAU,EACV,SAAS,EACT,YAAY,EACZ,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACxB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -7,4 +7,6 @@ export { WebSocketManager, } from './websocket-manager';
 export { EventStreamManager, } from './eventstream-manager';
 // Export client implementation (local to this package)
 export { createClient } from './client/index';
+// Export analytics
+export { getAnalytics, track, initBeacon, trackPageview, createBaseEvent, getVisitorId, isOptedOut, setOptOut, getUTMParams, } from './analytics';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAgD,MAAM,aAAa,CAAC;AAEnG,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EACN,gBAAgB,GAKhB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,kBAAkB,GAKlB,MAAM,uBAAuB,CAAC;AAE/B,uDAAuD;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAgD,MAAM,aAAa,CAAC;AAEnG,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EACN,gBAAgB,GAKhB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,kBAAkB,GAKlB,MAAM,uBAAuB,CAAC;AAE/B,uDAAuD;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAW9C,mBAAmB;AACnB,OAAO,EACN,YAAY,EACZ,KAAK,EACL,UAAU,EACV,aAAa,EACb,eAAe,EACf,YAAY,EACZ,UAAU,EACV,SAAS,EACT,YAAY,GAMZ,MAAM,aAAa,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agentuity/frontend",
-	"version": "0.0.111",
+	"version": "0.1.0",
 	"license": "Apache-2.0",
 	"author": "Agentuity employees and contributors",
 	"type": "module",
@@ -26,10 +26,10 @@
 		"prepublishOnly": "bun run clean && bun run build"
 	},
 	"dependencies": {
-		"@agentuity/core": "0.0.111"
+		"@agentuity/core": "0.1.0"
 	},
 	"devDependencies": {
-		"@agentuity/test-utils": "0.0.111",
+		"@agentuity/test-utils": "0.1.0",
 		"@types/bun": "latest",
 		"bun-types": "latest",
 		"typescript": "^5.9.0"

package/src/analytics/beacon.ts

@@ -0,0 +1,203 @@
+import type { AnalyticsPageConfig, AnalyticsClient } from './types';
+import { initEventQueue, queueEvent, flushEvents } from './events';
+import { initPageviewTracking, createBaseEvent, trackPageview } from './collectors/pageview';
+import { initSPATracking } from './collectors/spa';
+import { initClickTracking, initOutboundLinkTracking } from './collectors/clicks';
+import { initScrollTracking } from './collectors/scroll';
+import { initErrorTracking } from './collectors/errors';
+import { initVisibilityTracking } from './collectors/visibility';
+import { initFormTracking } from './collectors/forms';
+import { initWebVitalsTracking } from './collectors/webvitals';
+import { isOptedOut, setOptOut } from './utils/storage';
+import { initOfflineSupport, getAndClearOfflineEvents } from './offline';
+
+let initialized = false;
+let trackingStarted = false;
+let analyticsEnabled = true;
+let consentRequired = false;
+let consentGiven = false;
+
+/**
+ * Check if analytics should run
+ */
+function shouldTrack(): boolean {
+	if (!analyticsEnabled) return false;
+	if (isOptedOut()) return false;
+	if (consentRequired && !consentGiven) return false;
+	return true;
+}
+
+/**
+ * Initialize the analytics beacon
+ * Called automatically when the script loads
+ */
+export function initBeacon(): void {
+	if (initialized) {
+		return;
+	}
+
+	const config = window.__AGENTUITY_ANALYTICS__;
+	if (!config || !config.enabled) {
+		analyticsEnabled = false;
+		return;
+	}
+
+	initialized = true;
+	consentRequired = config.requireConsent ?? false;
+
+	// If consent is required and not given, wait for optIn
+	if (consentRequired && !consentGiven) {
+		return;
+	}
+
+	startTracking(config);
+}
+
+/**
+ * Start all tracking based on config
+ */
+function startTracking(config: AnalyticsPageConfig): void {
+	if (trackingStarted) {
+		return;
+	}
+	trackingStarted = true;
+
+	// Initialize event queue
+	initEventQueue(config);
+
+	// Initialize offline support
+	initOfflineSupport(async () => {
+		// Flush offline events when coming back online
+		const offlineEvents = await getAndClearOfflineEvents();
+		for (const event of offlineEvents) {
+			queueEvent(event);
+		}
+		flushEvents();
+	});
+
+	// Always track pageviews
+	initPageviewTracking();
+
+	// Initialize visibility tracking (for time on page)
+	initVisibilityTracking();
+
+	// Conditional tracking based on config (all default to true except requireConsent)
+	if (config.trackSPANavigation !== false) {
+		initSPATracking();
+	}
+
+	if (config.trackClicks !== false) {
+		initClickTracking();
+	}
+
+	if (config.trackOutboundLinks !== false) {
+		initOutboundLinkTracking();
+	}
+
+	if (config.trackScroll !== false) {
+		initScrollTracking();
+	}
+
+	if (config.trackErrors !== false) {
+		initErrorTracking();
+	}
+
+	if (config.trackForms !== false) {
+		initFormTracking();
+	}
+
+	if (config.trackWebVitals !== false) {
+		initWebVitalsTracking();
+	}
+}
+
+/**
+ * Create the analytics client API
+ */
+function createClient(): AnalyticsClient {
+	return {
+		track(eventName: string, properties?: Record<string, unknown>): void {
+			if (!shouldTrack()) return;
+
+			const event = createBaseEvent('custom');
+			event.event_name = eventName;
+			if (properties) {
+				event.event_data = properties;
+			}
+			queueEvent(event);
+		},
+
+		identify(userId: string, traits?: Record<string, unknown>): void {
+			if (!shouldTrack()) return;
+
+			const event = createBaseEvent('custom');
+			event.event_name = 'identify';
+			event.event_data = {
+				user_id: userId,
+				...traits,
+			};
+			queueEvent(event);
+		},
+
+		pageview(path?: string): void {
+			if (!shouldTrack()) return;
+			trackPageview(path);
+		},
+
+		async flush(): Promise<void> {
+			flushEvents();
+		},
+
+		optOut(): void {
+			setOptOut(true);
+			analyticsEnabled = false;
+		},
+
+		optIn(): void {
+			setOptOut(false);
+			analyticsEnabled = true;
+			consentGiven = true;
+
+			// If consent was required and now given, start tracking
+			if (consentRequired && !trackingStarted) {
+				const config = window.__AGENTUITY_ANALYTICS__;
+				if (config) {
+					startTracking(config);
+				}
+			}
+		},
+
+		isEnabled(): boolean {
+			return shouldTrack();
+		},
+	};
+}
+
+// Singleton client instance
+let clientInstance: AnalyticsClient | null = null;
+
+/**
+ * Get the analytics client instance
+ */
+export function getAnalytics(): AnalyticsClient {
+	if (!clientInstance) {
+		clientInstance = createClient();
+	}
+	return clientInstance;
+}
+
+/**
+ * Convenience function to track a custom event
+ */
+export function track(eventName: string, properties?: Record<string, unknown>): void {
+	getAnalytics().track(eventName, properties);
+}
+
+// Auto-initialize when script loads
+if (typeof window !== 'undefined') {
+	if (document.readyState === 'loading') {
+		document.addEventListener('DOMContentLoaded', initBeacon);
+	} else {
+		initBeacon();
+	}
+}