@agentuity/analytics 3.0.0-alpha.0

package/dist/config.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Analytics configuration resolution
+ */
+import type { AnalyticsConfig } from './types';
+/** Window with Agentuity analytics globals */
+declare global {
+    interface Window {
+        __AGENTUITY_ANALYTICS__?: AnalyticsConfig;
+        agentuityAnalytics?: import('./types').AnalyticsClient;
+    }
+}
+/** Default collect endpoint */
+export declare const DEFAULT_ENDPOINT = "/_agentuity/webanalytics/collect";
+/** Maximum custom events per page view */
+export declare const MAX_CUSTOM_EVENTS = 1000;
+/**
+ * Get analytics config from window global
+ */
+export declare function getConfig(): AnalyticsConfig | null;
+/**
+ * Check if analytics is enabled
+ */
+export declare function isEnabled(): boolean;
+/**
+ * Check if running in dev mode
+ */
+export declare function isDevmode(): boolean;
+/**
+ * Get the collect endpoint
+ */
+export declare function getEndpoint(): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,8CAA8C;AAC9C,OAAO,CAAC,MAAM,CAAC;IACd,UAAU,MAAM;QACf,uBAAuB,CAAC,EAAE,eAAe,CAAC;QAC1C,kBAAkB,CAAC,EAAE,OAAO,SAAS,EAAE,eAAe,CAAC;KACvD;CACD;AAED,+BAA+B;AAC/B,eAAO,MAAM,gBAAgB,qCAAqC,CAAC;AAEnE,0CAA0C;AAC1C,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC;;GAEG;AACH,wBAAgB,SAAS,IAAI,eAAe,GAAG,IAAI,CAElD;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAGnC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC"}

package/dist/config.js

@@ -0,0 +1,33 @@
+/**
+ * Analytics configuration resolution
+ */
+/** Default collect endpoint */
+export const DEFAULT_ENDPOINT = '/_agentuity/webanalytics/collect';
+/** Maximum custom events per page view */
+export const MAX_CUSTOM_EVENTS = 1000;
+/**
+ * Get analytics config from window global
+ */
+export function getConfig() {
+    return window.__AGENTUITY_ANALYTICS__ ?? null;
+}
+/**
+ * Check if analytics is enabled
+ */
+export function isEnabled() {
+    const config = getConfig();
+    return config?.enabled === true;
+}
+/**
+ * Check if running in dev mode
+ */
+export function isDevmode() {
+    return getConfig()?.isDevmode ?? false;
+}
+/**
+ * Get the collect endpoint
+ */
+export function getEndpoint() {
+    return getConfig()?.endpoint ?? DEFAULT_ENDPOINT;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,+BAA+B;AAC/B,MAAM,CAAC,MAAM,gBAAgB,GAAG,kCAAkC,CAAC;AAEnE,0CAA0C;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAEtC;;GAEG;AACH,MAAM,UAAU,SAAS;IACxB,OAAO,MAAM,CAAC,uBAAuB,IAAI,IAAI,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,OAAO,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACxB,OAAO,SAAS,EAAE,EAAE,SAAS,IAAI,KAAK,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IAC1B,OAAO,SAAS,EAAE,EAAE,QAAQ,IAAI,gBAAgB,CAAC;AAClD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @agentuity/analytics - Browser analytics for Agentuity applications
+ *
+ * ## Usage
+ *
+ * ### Auto-init (drop-in)
+ * ```typescript
+ * // Just import - uses window.__AGENTUITY_ANALYTICS__ config
+ * import '@agentuity/analytics/beacon';
+ * ```
+ *
+ * ### Programmatic
+ * ```typescript
+ * import { init, track, identify, flush } from '@agentuity/analytics';
+ *
+ * init({
+ *   orgId: 'your-org-id',
+ *   projectId: 'your-project-id',
+ * });
+ *
+ * track('button_click', { button: 'signup' });
+ * identify('user-123', { email: 'user@example.com' });
+ * flush();
+ * ```
+ *
+ * ### With React
+ * ```typescript
+ * import { useEffect } from 'react';
+ * import { track } from '@agentuity/analytics';
+ *
+ * function SignupButton() {
+ *   const handleClick = () => {
+ *     track('signup_click');
+ *   };
+ *   return <button onClick={handleClick}>Sign Up</button>;
+ * }
+ * ```
+ */
+export type { AnalyticsConfig, AnalyticsClient, AnalyticsPayload, PageViewData, ScrollEvent, AnalyticsCustomEvent, GeoLocation, } from './types';
+export { getConfig, isEnabled, isDevmode, getEndpoint, DEFAULT_ENDPOINT, } from './config';
+export { generateId, getVisitorId, getUTMParams, stripQueryString, } from './util';
+export { initClient, track, identify, flush, send, getClient, } from './client';
+/**
+ * Initialize analytics with explicit config
+ * Alternative to using window.__AGENTUITY_ANALYTICS__
+ */
+export declare function init(config: import('./types').AnalyticsConfig): void;
+/**
+ * Get the global analytics client
+ */
+export declare function getAnalytics(): import('./types').AnalyticsClient | null;
+/**
+ * Check if user has opted out of analytics via localStorage.
+ */
+export declare function isOptedOut(): boolean;
+/**
+ * Set the analytics opt-out status in localStorage.
+ */
+export declare function setOptOut(optOut: boolean): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAGH,YAAY,EACX,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,WAAW,GACX,MAAM,SAAS,CAAC;AAGjB,OAAO,EACN,SAAS,EACT,SAAS,EACT,SAAS,EACT,WAAW,EACX,gBAAgB,GAChB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACN,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,gBAAgB,GAChB,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACN,UAAU,EACV,KAAK,EACL,QAAQ,EACR,KAAK,EACL,IAAI,EACJ,SAAS,GACT,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,OAAO,SAAS,EAAE,eAAe,GAAG,IAAI,CAMpE;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,SAAS,EAAE,eAAe,GAAG,IAAI,CAKvE;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAMpC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAU/C"}

package/dist/index.js

@@ -0,0 +1,92 @@
+/**
+ * @agentuity/analytics - Browser analytics for Agentuity applications
+ *
+ * ## Usage
+ *
+ * ### Auto-init (drop-in)
+ * ```typescript
+ * // Just import - uses window.__AGENTUITY_ANALYTICS__ config
+ * import '@agentuity/analytics/beacon';
+ * ```
+ *
+ * ### Programmatic
+ * ```typescript
+ * import { init, track, identify, flush } from '@agentuity/analytics';
+ *
+ * init({
+ *   orgId: 'your-org-id',
+ *   projectId: 'your-project-id',
+ * });
+ *
+ * track('button_click', { button: 'signup' });
+ * identify('user-123', { email: 'user@example.com' });
+ * flush();
+ * ```
+ *
+ * ### With React
+ * ```typescript
+ * import { useEffect } from 'react';
+ * import { track } from '@agentuity/analytics';
+ *
+ * function SignupButton() {
+ *   const handleClick = () => {
+ *     track('signup_click');
+ *   };
+ *   return <button onClick={handleClick}>Sign Up</button>;
+ * }
+ * ```
+ */
+// Config utilities
+export { getConfig, isEnabled, isDevmode, getEndpoint, DEFAULT_ENDPOINT, } from './config';
+// Utility functions
+export { generateId, getVisitorId, getUTMParams, stripQueryString, } from './util';
+// Programmatic API
+export { initClient, track, identify, flush, send, getClient, } from './client';
+/**
+ * Initialize analytics with explicit config
+ * Alternative to using window.__AGENTUITY_ANALYTICS__
+ */
+export function init(config) {
+    if (typeof window !== 'undefined') {
+        window.__AGENTUITY_ANALYTICS__ = config;
+        // Import beacon to trigger auto-init
+        import('./beacon');
+    }
+}
+/**
+ * Get the global analytics client
+ */
+export function getAnalytics() {
+    if (typeof window !== 'undefined' && window.agentuityAnalytics) {
+        return window.agentuityAnalytics;
+    }
+    return null;
+}
+/**
+ * Check if user has opted out of analytics via localStorage.
+ */
+export function isOptedOut() {
+    try {
+        return localStorage.getItem('agentuity_opt_out') === 'true';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Set the analytics opt-out status in localStorage.
+ */
+export function setOptOut(optOut) {
+    try {
+        if (optOut) {
+            localStorage.setItem('agentuity_opt_out', 'true');
+        }
+        else {
+            localStorage.removeItem('agentuity_opt_out');
+        }
+    }
+    catch {
+        // localStorage not available
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAaH,mBAAmB;AACnB,OAAO,EACN,SAAS,EACT,SAAS,EACT,SAAS,EACT,WAAW,EACX,gBAAgB,GAChB,MAAM,UAAU,CAAC;AAElB,oBAAoB;AACpB,OAAO,EACN,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,gBAAgB,GAChB,MAAM,QAAQ,CAAC;AAEhB,mBAAmB;AACnB,OAAO,EACN,UAAU,EACV,KAAK,EACL,QAAQ,EACR,KAAK,EACL,IAAI,EACJ,SAAS,GACT,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,MAAyC;IAC7D,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QACnC,MAAM,CAAC,uBAAuB,GAAG,MAAM,CAAC;QACxC,qCAAqC;QACrC,MAAM,CAAC,UAAU,CAAC,CAAC;IACpB,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC3B,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;QAChE,OAAO,MAAM,CAAC,kBAAkB,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACzB,IAAI,CAAC;QACJ,OAAO,YAAY,CAAC,OAAO,CAAC,mBAAmB,CAAC,KAAK,MAAM,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,MAAe;IACxC,IAAI,CAAC;QACJ,IAAI,MAAM,EAAE,CAAC;YACZ,YAAY,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACP,YAAY,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;QAC9C,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,6BAA6B;IAC9B,CAAC;AACF,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Analytics type definitions
+ */
+/** Scroll depth milestone event */
+export interface ScrollEvent {
+    depth: number;
+    timestamp: number;
+}
+/** Custom analytics event */
+export interface AnalyticsCustomEvent {
+    timestamp: number;
+    name: string;
+    data: string;
+}
+/** Geo location data from IP */
+export interface GeoLocation {
+    country?: string;
+    country_latitude?: string | number;
+    country_longitude?: string | number;
+    region?: string;
+    region_latitude?: string | number;
+    region_longitude?: string | number;
+    city?: string;
+    city_latitude?: string | number;
+    city_longitude?: string | number;
+    timezone?: string;
+    latitude?: string | number;
+    longitude?: string | number;
+}
+/** Page view data collected by the beacon */
+export interface PageViewData {
+    id: string;
+    timestamp: number;
+    timezone_offset: number;
+    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;
+    scroll_depth: number;
+    time_on_page: number;
+    scroll_events: ScrollEvent[];
+    custom_events: AnalyticsCustomEvent[];
+    load_time?: number;
+    dom_ready?: number;
+    ttfb?: number;
+    fcp?: number;
+    lcp?: number;
+    cls?: number;
+    inp?: number;
+    country?: string;
+    country_latitude?: number;
+    country_longitude?: number;
+    region?: string;
+    region_latitude?: number;
+    region_longitude?: number;
+    city?: string;
+    city_latitude?: number;
+    city_longitude?: number;
+    timezone?: string;
+    latitude?: number;
+    longitude?: number;
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    utm_term?: string;
+    utm_content?: string;
+    [key: string]: unknown;
+}
+/** Analytics configuration */
+export interface AnalyticsConfig {
+    /** Enable/disable tracking */
+    enabled: boolean;
+    /** Organization ID */
+    orgId: string;
+    /** Project ID */
+    projectId: string;
+    /** Running in development mode */
+    isDevmode?: boolean;
+    /** Track clicks on [data-analytics] elements */
+    trackClicks?: boolean;
+    /** Track scroll depth */
+    trackScroll?: boolean;
+    /** Track Web Vitals (FCP, LCP, CLS, INP) */
+    trackWebVitals?: boolean;
+    /** Track JS errors */
+    trackErrors?: boolean;
+    /** Track SPA navigation */
+    trackSPANavigation?: boolean;
+    /** Sampling rate (0-1) */
+    sampleRate?: number;
+    /** Custom collect endpoint */
+    endpoint?: string;
+}
+/** Analytics client API */
+export interface AnalyticsClient {
+    /** Track a custom event */
+    track: (name: string, properties?: Record<string, unknown>) => void;
+    /** Identify a user */
+    identify: (userId: string, traits?: Record<string, unknown>) => void;
+    /** Flush pending events */
+    flush: () => void;
+}
+/** Payload sent to collect endpoint */
+export interface AnalyticsPayload {
+    org_id: string;
+    project_id: string;
+    visitor_id: string;
+    user_id: string;
+    user_traits: Record<string, string>;
+    is_devmode: boolean;
+    pageview: PageViewData;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Analytics type definitions
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/util.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Analytics utility functions
+ */
+import type { GeoLocation } from './types';
+/**
+ * Generate a unique ID
+ */
+export declare function generateId(): string;
+/**
+ * Safely stringify an object, handling circular references
+ */
+export declare function safeStringify(obj: unknown): string;
+/**
+ * Strip query string from URL to prevent sensitive data leakage
+ */
+export declare function stripQueryString(url: string): string;
+/**
+ * Get UTM parameters from URL
+ */
+export declare function getUTMParams(): Record<string, string>;
+/**
+ * Get or create visitor ID from localStorage
+ */
+export declare function getVisitorId(): string;
+/**
+ * Get cached geo location
+ */
+export declare function getCachedGeo(): GeoLocation | null;
+/**
+ * Cache geo location
+ */
+export declare function setCachedGeo(geo: GeoLocation): void;
+/**
+ * Fetch geo location from service
+ */
+export declare function fetchGeo(): Promise<GeoLocation | null>;
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAKnC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAoBlD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQpD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQrD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAcrC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,WAAW,GAAG,IAAI,CAQjD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAMnD;AAED;;GAEG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAS5D"}

package/dist/util.js

@@ -0,0 +1,125 @@
+/**
+ * Analytics utility functions
+ */
+/**
+ * Generate a unique ID
+ */
+export function generateId() {
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
+}
+/**
+ * Safely stringify an object, handling circular references
+ */
+export function safeStringify(obj) {
+    if (obj === undefined || obj === null) {
+        return '';
+    }
+    try {
+        const seen = new WeakSet();
+        return JSON.stringify(obj, (_key, value) => {
+            if (typeof value === 'object' && value !== null) {
+                if (seen.has(value)) {
+                    return '[Circular]';
+                }
+                seen.add(value);
+            }
+            return value;
+        });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.warn('[Agentuity Analytics] Failed to stringify:', message);
+        return `[unserializable: ${message}]`;
+    }
+}
+/**
+ * Strip query string from URL to prevent sensitive data leakage
+ */
+export function stripQueryString(url) {
+    if (!url)
+        return '';
+    try {
+        const parsed = new URL(url);
+        return parsed.origin + parsed.pathname;
+    }
+    catch {
+        return url.split('?')[0] ?? url;
+    }
+}
+/**
+ * Get UTM parameters from URL
+ */
+export function getUTMParams() {
+    const params = new URLSearchParams(location.search);
+    const utm = {};
+    for (const key of ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content']) {
+        const value = params.get(key);
+        if (value)
+            utm[key] = value;
+    }
+    return utm;
+}
+/**
+ * Get or create visitor ID from localStorage
+ */
+export function getVisitorId() {
+    try {
+        const stored = localStorage.getItem('agentuity_visitor_id');
+        if (stored)
+            return stored;
+    }
+    catch {
+        // localStorage not available
+    }
+    const id = 'vid_' + generateId();
+    try {
+        localStorage.setItem('agentuity_visitor_id', id);
+    }
+    catch {
+        // localStorage not available
+    }
+    return id;
+}
+/**
+ * Get cached geo location
+ */
+export function getCachedGeo() {
+    try {
+        const cached = sessionStorage.getItem('agentuity_geo');
+        if (cached)
+            return JSON.parse(cached);
+    }
+    catch {
+        // sessionStorage not available
+    }
+    return null;
+}
+/**
+ * Cache geo location
+ */
+export function setCachedGeo(geo) {
+    try {
+        sessionStorage.setItem('agentuity_geo', JSON.stringify(geo));
+    }
+    catch {
+        // sessionStorage not available
+    }
+}
+/**
+ * Fetch geo location from service
+ */
+export async function fetchGeo() {
+    try {
+        const response = await fetch('https://agentuity.sh/location');
+        const geo = await response.json();
+        setCachedGeo(geo);
+        return geo;
+    }
+    catch {
+        return getCachedGeo();
+    }
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+	"name": "@agentuity/analytics",
+	"version": "3.0.0-alpha.0",
+	"license": "Apache-2.0",
+	"author": "Agentuity employees and contributors",
+	"description": "Browser analytics for Agentuity applications",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		},
+		"./beacon": {
+			"import": "./dist/beacon.js",
+			"types": "./dist/beacon.d.ts"
+		}
+	},
+	"files": [
+		"README.md",
+		"dist",
+		"src"
+	],
+	"scripts": {
+		"clean": "rm -rf dist tsconfig.tsbuildinfo",
+		"build": "bunx tsc --build",
+		"typecheck": "bunx tsc --noEmit",
+		"prepublishOnly": "bun run clean && bun run build"
+	},
+	"devDependencies": {
+		"@types/bun": "latest",
+		"bun-types": "latest",
+		"typescript": "^5.9.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"sideEffects": [
+		"**/beacon.ts"
+	],
+	"keywords": [
+		"analytics",
+		"web-vitals",
+		"page-views",
+		"browser",
+		"agentuity"
+	],
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/agentuity/sdk.git",
+		"directory": "packages/analytics"
+	}
+}