flowgrid-sdk 1.2.0 → 1.3.0

package/dist/lib/frameworks/vue/CookieBanner.js

@@ -0,0 +1,165 @@
+/**
+ * @fileoverview FlowGrid Cookie Banner — Vue 3 Component
+ * @module frameworks/vue/CookieBanner
+ *
+ * @description
+ * A customisable cookie consent banner for Vue 3 applications.
+ * Works with the FlowGrid {@link ConsentManager}.
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { CookieBanner } from 'flowgrid-sdk/vue';
+ * import { ConsentManager, FlowGridTransport } from 'flowgrid-sdk';
+ *
+ * const consent = new ConsentManager({
+ *   onChange: (prefs) => {
+ *     FlowGridTransport.setConsent({
+ *       analytics: prefs.analytics,
+ *       marketing: prefs.marketing,
+ *     });
+ *   },
+ * });
+ * </script>
+ *
+ * <template>
+ *   <CookieBanner
+ *     :consent="consent"
+ *     :config="{
+ *       title: 'We use cookies',
+ *       description: 'We use cookies to improve your experience.',
+ *       privacyPolicyUrl: '/privacy',
+ *       theme: { position: 'bottom', primaryColor: '#4F46E5' },
+ *     }"
+ *   />
+ * </template>
+ * ```
+ */
+import { defineComponent, ref, onMounted, h } from 'vue';
+/**
+ * Vue 3 Cookie Banner component.
+ *
+ * Renders a GDPR-compliant cookie consent banner with accept, reject,
+ * and customise options. Uses the {@link ConsentManager} to persist choices.
+ *
+ * @example
+ * ```vue
+ * <template>
+ *   <CookieBanner
+ *     :consent="consentManager"
+ *     :config="{ title: 'Cookies', theme: { position: 'bottom-right' } }"
+ *     @close="onBannerClosed"
+ *   />
+ * </template>
+ * ```
+ */
+export const CookieBanner = defineComponent({
+    name: 'FlowGridCookieBanner',
+    props: {
+        consent: {
+            type: Object,
+            required: true,
+        },
+        config: {
+            type: Object,
+            default: () => ({}),
+        },
+    },
+    emits: ['close'],
+    setup(props, { emit }) {
+        const visible = ref(false);
+        const showDetails = ref(false);
+        const prefs = ref(props.consent.getPreferences());
+        onMounted(() => {
+            if (props.config?.forceShow || !props.consent.hasConsented()) {
+                visible.value = true;
+            }
+        });
+        const close = () => {
+            visible.value = false;
+            emit('close');
+        };
+        const acceptAll = () => {
+            props.consent.acceptAll();
+            close();
+        };
+        const rejectAll = () => {
+            props.consent.rejectNonEssential();
+            close();
+        };
+        const save = () => {
+            props.consent.update(prefs.value);
+            close();
+        };
+        const toggle = (cat) => {
+            prefs.value = { ...prefs.value, [cat]: !prefs.value[cat] };
+        };
+        return () => {
+            if (!visible.value)
+                return null;
+            const theme = props.config?.theme ?? {};
+            const position = theme.position ?? 'bottom';
+            const accent = theme.primaryColor ?? '#4F46E5';
+            const descriptions = props.config?.categoryDescriptions ?? {};
+            const containerStyle = {
+                position: 'fixed',
+                zIndex: theme.zIndex ?? 9999,
+                left: 0,
+                right: 0,
+                padding: '20px',
+                boxSizing: 'border-box',
+                fontFamily: theme.fontFamily ?? 'system-ui, -apple-system, sans-serif',
+                backgroundColor: theme.backgroundColor ?? '#FFFFFF',
+                color: theme.textColor ?? '#1F2937',
+                boxShadow: '0 -2px 16px rgba(0,0,0,0.1)',
+                ...(position === 'top' ? { top: 0 } : {}),
+                ...(position === 'bottom' ? { bottom: 0 } : {}),
+                ...(position === 'bottom-left' ? { bottom: '20px', left: '20px', right: 'auto', maxWidth: '420px', borderRadius: theme.borderRadius ?? '12px' } : {}),
+                ...(position === 'bottom-right' ? { bottom: '20px', right: '20px', left: 'auto', maxWidth: '420px', borderRadius: theme.borderRadius ?? '12px' } : {}),
+                ...(position === 'center' ? { top: '50%', left: '50%', right: 'auto', transform: 'translate(-50%, -50%)', maxWidth: '540px', borderRadius: theme.borderRadius ?? '12px' } : {}),
+            };
+            const btnPrimary = {
+                padding: '10px 20px', border: 'none', borderRadius: '6px', cursor: 'pointer',
+                fontSize: '14px', fontWeight: 600, backgroundColor: accent, color: '#FFFFFF',
+            };
+            const btnSecondary = {
+                ...btnPrimary, backgroundColor: 'transparent', color: accent, border: `1px solid ${accent}`,
+            };
+            const title = props.config?.title ?? 'Cookie Preferences';
+            const desc = props.config?.description ?? 'We use cookies to improve your experience and analyse site traffic.';
+            const categories = showDetails.value
+                ? [
+                    h('label', { style: { display: 'flex', alignItems: 'center', marginBottom: '10px', fontSize: '14px' } }, [
+                        h('input', { type: 'checkbox', checked: true, disabled: true, style: { marginRight: '8px' } }),
+                        h('span', {}, [h('strong', {}, 'Necessary'), h('span', { style: { opacity: 0.7, marginLeft: '8px' } }, descriptions.necessary ?? 'Required for the site to function.')]),
+                    ]),
+                    ...['analytics', 'marketing', 'preferences'].map((cat) => h('label', { style: { display: 'flex', alignItems: 'center', marginBottom: '10px', fontSize: '14px', cursor: 'pointer' } }, [
+                        h('input', { type: 'checkbox', checked: prefs.value[cat], onChange: () => toggle(cat), style: { marginRight: '8px' } }),
+                        h('span', {}, [
+                            h('strong', {}, cat.charAt(0).toUpperCase() + cat.slice(1)),
+                            h('span', { style: { opacity: 0.7, marginLeft: '8px' } }, descriptions[cat] ?? ''),
+                        ]),
+                    ])),
+                ]
+                : [];
+            return h('div', { style: containerStyle, role: 'dialog', 'aria-label': title }, [
+                h('div', { style: { maxWidth: '960px', margin: '0 auto' } }, [
+                    h('h3', { style: { margin: '0 0 8px', fontSize: '18px', fontWeight: 700 } }, title),
+                    h('p', { style: { margin: '0 0 16px', fontSize: '14px', lineHeight: 1.5, opacity: 0.8 } }, desc),
+                    ...(showDetails.value ? [h('div', { style: { marginBottom: '16px' } }, categories)] : []),
+                    h('div', { style: { display: 'flex', gap: '10px', flexWrap: 'wrap', alignItems: 'center' } }, [
+                        h('button', { style: btnPrimary, onClick: acceptAll }, props.config?.acceptAllLabel ?? 'Accept All'),
+                        h('button', { style: btnSecondary, onClick: rejectAll }, props.config?.rejectAllLabel ?? 'Reject All'),
+                        !showDetails.value
+                            ? h('button', { style: { ...btnSecondary, border: 'none', textDecoration: 'underline' }, onClick: () => { showDetails.value = true; } }, props.config?.customizeLabel ?? 'Customize')
+                            : h('button', { style: btnPrimary, onClick: save }, props.config?.saveLabel ?? 'Save Preferences'),
+                        props.config?.privacyPolicyUrl
+                            ? h('a', { href: props.config.privacyPolicyUrl, style: { fontSize: '13px', opacity: 0.7, marginLeft: 'auto' }, target: '_blank', rel: 'noopener noreferrer' }, 'Privacy Policy')
+                            : null,
+                    ]),
+                ]),
+            ]);
+        };
+    },
+});
+//# sourceMappingURL=CookieBanner.js.map

package/dist/lib/frameworks/vue/CookieBanner.js.map

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

package/dist/lib/frameworks/vue/index.d.ts

@@ -15,7 +15,7 @@
  * const app = createApp(App);
  * app.use(FlowGridPlugin, {
  *   webId: 'your-web-id',
- *   endpoint: 'https://api.flowgrid.io',
+ *   endpoint: 'https://api.flow-grid.xyz',
  *   apiKey: 'your-api-key'
  * });
  * app.mount('#app');
@@ -60,7 +60,7 @@ export interface FlowGridInstance {
  * createApp(App)
  *   .use(FlowGridPlugin, {
  *     webId: 'web_123',
- *     endpoint: 'https://api.flowgrid.io',
+ *     endpoint: 'https://api.flow-grid.xyz',
  *     apiKey: 'key_abc',
  *     autoTrackPageViews: true
  *   })

package/dist/lib/frameworks/vue/index.js

@@ -0,0 +1,390 @@
+/**
+ * @fileoverview FlowGrid SDK - Vue 3 Integration
+ * @module frameworks/vue
+ *
+ * @description
+ * Vue 3 composables and plugin for FlowGrid SDK.
+ * Uses Composition API for reactive state management.
+ *
+ * @example
+ * ```ts
+ * // main.ts
+ * import { createApp } from 'vue';
+ * import { FlowGridPlugin } from 'flowgrid-sdk/vue';
+ *
+ * const app = createApp(App);
+ * app.use(FlowGridPlugin, {
+ *   webId: 'your-web-id',
+ *   endpoint: 'https://api.flow-grid.xyz',
+ *   apiKey: 'your-api-key'
+ * });
+ * app.mount('#app');
+ * ```
+ */
+import { inject, ref, onMounted, watch } from 'vue';
+// Import core SDK
+import { Activation, TrackFeature, TrackPrompt, Experiment, PageViews, Sessions, Events, Identify, Funnels, Products, CartTracking, Checkout, Purchases } from '../../../index';
+import { getVisitorId } from '../../utils/storage';
+import { IdentityManager } from '../../utils/identity';
+// ============================================================================
+// INJECTION KEY
+// ============================================================================
+const FlowGridKey = Symbol('FlowGrid');
+// ============================================================================
+// PLUGIN
+// ============================================================================
+/**
+ * Vue plugin for FlowGrid SDK.
+ *
+ * @example
+ * ```ts
+ * import { createApp } from 'vue';
+ * import { FlowGridPlugin } from 'flowgrid-sdk/vue';
+ *
+ * createApp(App)
+ *   .use(FlowGridPlugin, {
+ *     webId: 'web_123',
+ *     endpoint: 'https://api.flow-grid.xyz',
+ *     apiKey: 'key_abc',
+ *     autoTrackPageViews: true
+ *   })
+ *   .mount('#app');
+ * ```
+ */
+export const FlowGridPlugin = {
+    install(app, options) {
+        const { webId, endpoint, apiKey, debug = false } = options;
+        const isReady = ref(false);
+        const sessionId = ref(null);
+        // Create identity manager for visitor/session lifecycle
+        const identity = new IdentityManager({
+            visitorId: options.visitorId || getVisitorId() || undefined,
+        });
+        const resolvedVisitorId = identity.getVisitorId() || undefined;
+        // Initialize SDK instances
+        const instance = {
+            activation: new Activation(webId, endpoint, apiKey, resolvedVisitorId, identity),
+            trackFeature: new TrackFeature(webId, endpoint, apiKey, resolvedVisitorId, identity),
+            trackPrompt: new TrackPrompt(webId, endpoint, apiKey, resolvedVisitorId, identity),
+            experiment: new Experiment(webId, endpoint, apiKey, resolvedVisitorId, identity),
+            pageViews: new PageViews(webId, endpoint, apiKey, resolvedVisitorId, identity),
+            sessions: new Sessions(webId, endpoint, apiKey, resolvedVisitorId, identity),
+            events: new Events(webId, endpoint, apiKey, resolvedVisitorId, identity),
+            identify: new Identify(webId, endpoint, apiKey, resolvedVisitorId, identity),
+            funnels: new Funnels(webId, endpoint, apiKey, resolvedVisitorId, identity),
+            products: new Products(webId, endpoint, apiKey, resolvedVisitorId, identity),
+            cart: new CartTracking(webId, endpoint, apiKey, resolvedVisitorId, identity),
+            checkout: new Checkout(webId, endpoint, apiKey, resolvedVisitorId, identity),
+            purchases: new Purchases(webId, endpoint, apiKey, resolvedVisitorId, identity),
+            isReady,
+            sessionId,
+        };
+        // Auto-start session
+        if (options.autoTrackSessions !== false && typeof window !== 'undefined') {
+            instance.sessions.start({
+                referrer: document.referrer,
+                landingPage: window.location.pathname,
+            }).then((result) => {
+                sessionId.value = result.response?.sessionId || null;
+                isReady.value = true;
+                if (debug)
+                    console.log('[FlowGrid] Session started:', sessionId.value);
+            });
+            // End session on unload
+            window.addEventListener('beforeunload', () => {
+                if (sessionId.value) {
+                    instance.sessions.end(sessionId.value);
+                }
+            });
+        }
+        else {
+            isReady.value = true;
+        }
+        // Provide globally
+        app.provide(FlowGridKey, instance);
+        // Also add to globalProperties for Options API
+        app.config.globalProperties.$flowgrid = instance;
+    }
+};
+// ============================================================================
+// COMPOSABLES
+// ============================================================================
+/**
+ * Access the FlowGrid SDK instance.
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useFlowGrid } from 'flowgrid-sdk/vue';
+ *
+ * const { events, trackEvent } = useFlowGrid();
+ *
+ * const handleClick = () => {
+ *   trackEvent('button_clicked', { id: 'cta' });
+ * };
+ * </script>
+ * ```
+ */
+export function useFlowGrid() {
+    const instance = inject(FlowGridKey);
+    if (!instance) {
+        throw new Error('FlowGrid plugin not installed. Call app.use(FlowGridPlugin, config) first.');
+    }
+    const trackEvent = async (name, properties) => {
+        await instance.events.track({ eventName: name, properties: properties || {} });
+    };
+    const identifyUser = async (userId, traits) => {
+        await instance.identify.user({ userId, traits: traits || {} });
+    };
+    return {
+        ...instance,
+        trackEvent,
+        identifyUser,
+    };
+}
+/**
+ * Track page views with Vue Router integration.
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { usePageView } from 'flowgrid-sdk/vue';
+ * import { useRoute } from 'vue-router';
+ *
+ * const route = useRoute();
+ * usePageView(() => route.path);
+ * </script>
+ * ```
+ */
+export function usePageView(pathGetter) {
+    const { pageViews, isReady } = useFlowGrid();
+    const trackPage = () => {
+        if (typeof window === 'undefined')
+            return;
+        pageViews.track({
+            url: window.location.href,
+            path: pathGetter ? pathGetter() : window.location.pathname,
+            title: document.title,
+            referrer: document.referrer,
+        });
+    };
+    onMounted(() => {
+        if (isReady.value) {
+            trackPage();
+        }
+    });
+    // Watch for path changes if getter provided
+    if (pathGetter) {
+        watch(pathGetter, () => {
+            if (isReady.value) {
+                trackPage();
+            }
+        });
+    }
+}
+/**
+ * Track an event on component mount.
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useTrackEvent } from 'flowgrid-sdk/vue';
+ *
+ * useTrackEvent('pricing_page_viewed', { source: 'navbar' });
+ * </script>
+ * ```
+ */
+export function useTrackEvent(eventName, properties) {
+    const { trackEvent, isReady } = useFlowGrid();
+    onMounted(() => {
+        if (isReady.value) {
+            trackEvent(eventName, properties);
+        }
+    });
+}
+/**
+ * Use an experiment variant.
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useExperiment } from 'flowgrid-sdk/vue';
+ *
+ * const { variant, isLoading } = useExperiment('checkout_v2', 'user_123');
+ * </script>
+ *
+ * <template>
+ *   <NewCheckout v-if="variant === 'treatment'" />
+ *   <OldCheckout v-else />
+ * </template>
+ * ```
+ */
+export function useExperiment(experimentId, userId) {
+    const { experiment } = useFlowGrid();
+    const variant = ref(null);
+    const isLoading = ref(true);
+    onMounted(async () => {
+        try {
+            await experiment.trackExposure(experimentId, userId, 'control');
+            variant.value = 'control'; // Would come from API
+        }
+        finally {
+            isLoading.value = false;
+        }
+    });
+    return { variant, isLoading };
+}
+/**
+ * Identify a user.
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useIdentify } from 'flowgrid-sdk/vue';
+ *
+ * const props = defineProps<{ userId: string; email: string }>();
+ *
+ * useIdentify(() => props.userId, () => ({ email: props.email }));
+ * </script>
+ * ```
+ */
+export function useIdentify(userIdGetter, traitsGetter) {
+    const { identifyUser, isReady } = useFlowGrid();
+    watch([userIdGetter, isReady], ([userId, ready]) => {
+        if (ready && userId) {
+            identifyUser(userId, traitsGetter?.() || {});
+        }
+    }, { immediate: true });
+}
+/**
+ * Ecommerce composable.
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useEcommerce } from 'flowgrid-sdk/vue';
+ *
+ * const { trackProductView, trackAddToCart } = useEcommerce();
+ *
+ * onMounted(() => {
+ *   trackProductView(product);
+ * });
+ * </script>
+ * ```
+ */
+export function useEcommerce() {
+    const { products, cart, checkout, purchases } = useFlowGrid();
+    const trackProductView = async (product) => {
+        await products.view({
+            productId: product.id,
+            name: product.name,
+            price: product.price,
+            currency: (product.currency || 'USD'),
+        });
+    };
+    const trackAddToCart = async (product, quantity = 1) => {
+        await cart.addItem({
+            product: {
+                productId: product.id,
+                name: product.name,
+                price: product.price,
+                currency: (product.currency || 'USD'),
+            },
+            quantity,
+            cartId: 'current',
+        });
+    };
+    const trackCheckoutStart = async (cartItems) => {
+        await checkout.begin({
+            cart: {
+                cartId: 'current',
+                items: cartItems.map(i => ({
+                    productId: i.productId,
+                    name: i.name,
+                    price: i.price,
+                    quantity: i.quantity,
+                    lineTotal: i.price * i.quantity,
+                    currency: 'USD',
+                })),
+                subtotal: cartItems.reduce((sum, i) => sum + i.price * i.quantity, 0),
+                discountTotal: 0,
+                total: cartItems.reduce((sum, i) => sum + i.price * i.quantity, 0),
+                currency: 'USD',
+                itemCount: cartItems.length,
+            },
+        });
+    };
+    const trackPurchase = async (orderData) => {
+        await purchases.track({
+            order: {
+                orderId: orderData.orderId,
+                items: orderData.items.map(i => ({
+                    productId: i.id,
+                    name: i.name,
+                    price: i.price,
+                    quantity: i.quantity,
+                    lineTotal: i.price * i.quantity,
+                    currency: 'USD',
+                })),
+                subtotal: orderData.revenue,
+                discountTotal: 0,
+                shippingTotal: 0,
+                taxTotal: 0,
+                total: orderData.revenue,
+                currency: 'USD',
+            },
+        });
+    };
+    return {
+        trackProductView,
+        trackAddToCart,
+        trackCheckoutStart,
+        trackPurchase,
+        products,
+        cart,
+        checkout,
+        purchases,
+    };
+}
+// ============================================================================
+// VUE ROUTER PLUGIN
+// ============================================================================
+/**
+ * Vue Router plugin for automatic page view tracking.
+ *
+ * @example
+ * ```ts
+ * import { createRouter } from 'vue-router';
+ * import { createRouterPlugin } from 'flowgrid-sdk/vue';
+ *
+ * const router = createRouter({ ... });
+ * router.afterEach(createRouterPlugin());
+ * ```
+ */
+export function createRouterPlugin() {
+    return (to, from) => {
+        // This would be called from the consuming app after router is set up
+        if (typeof window === 'undefined')
+            return;
+        // The app should call usePageView or manually track
+        console.log('[FlowGrid] Route change:', from.path, '->', to.path);
+    };
+}
+// ============================================================================
+// EXPORTS
+// ============================================================================
+// Cookie Banner
+import { CookieBanner as _CookieBanner } from './CookieBanner';
+export { CookieBanner } from './CookieBanner';
+export default {
+    FlowGridPlugin,
+    useFlowGrid,
+    usePageView,
+    useTrackEvent,
+    useExperiment,
+    useIdentify,
+    useEcommerce,
+    createRouterPlugin,
+    CookieBanner: _CookieBanner,
+};
+//# sourceMappingURL=index.js.map

package/dist/lib/frameworks/vue/index.js.map

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

package/dist/lib/tracking/analytics/attribution.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Multi-touch attribution shortcuts.
+ */
+import { Attribution, ConversionEvent } from "../../features/analytics/attribution";
+export declare class AttributionTracker {
+    readonly client: Attribution;
+    constructor(client: Attribution);
+    /** Record a marketing touchpoint. */
+    touchpoint(userId: string, channel: string, properties?: Record<string, unknown>): Promise<import("../../features/analytics/attribution").TouchpointResponse>;
+    /** Record a conversion that should be attributed. */
+    conversion(userId: string, conversionType: ConversionEvent["conversionType"], properties?: Record<string, unknown>): Promise<import("../../features/analytics/attribution").TouchpointResponse>;
+    /** Auto-capture a touchpoint from `utm_*` params + `document.referrer`. */
+    captureFromUrl(userId: string): import("../../features/analytics/attribution").TouchpointConfig | null;
+}

package/dist/lib/tracking/analytics/attribution.js

@@ -0,0 +1,18 @@
+export class AttributionTracker {
+    constructor(client) {
+        this.client = client;
+    }
+    /** Record a marketing touchpoint. */
+    touchpoint(userId, channel, properties) {
+        return this.client.trackTouchpoint({ userId, channel, properties });
+    }
+    /** Record a conversion that should be attributed. */
+    conversion(userId, conversionType, properties) {
+        return this.client.recordConversion({ userId, conversionType, properties });
+    }
+    /** Auto-capture a touchpoint from `utm_*` params + `document.referrer`. */
+    captureFromUrl(userId) {
+        return this.client.captureFromUrl(userId);
+    }
+}
+//# sourceMappingURL=attribution.js.map

package/dist/lib/tracking/analytics/attribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.js","sourceRoot":"","sources":["../../../../src/lib/tracking/analytics/attribution.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,kBAAkB;IAC7B,YAA4B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEnD,qCAAqC;IACrC,UAAU,CAAC,MAAc,EAAE,OAAe,EAAE,UAAoC;QAC9E,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,qDAAqD;IACrD,UAAU,CAAC,MAAc,EAAE,cAAiD,EAAE,UAAoC;QAChH,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,2EAA2E;IAC3E,cAAc,CAAC,MAAc;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/dist/lib/tracking/analytics/events.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Custom event shortcuts.
+ */
+import { Events } from "../../features/analytics/events";
+export declare class EventTracker {
+    readonly client: Events;
+    constructor(client: Events);
+    /** Track a custom event. */
+    track(eventName: string, properties?: Record<string, unknown>, opts?: {
+        userId?: string;
+        sessionId?: string;
+    }): Promise<import("../../features/analytics/events").EventResponse>;
+    /** Track many events in one request. */
+    batch(events: Array<{
+        eventName: string;
+        properties?: Record<string, unknown>;
+    }>): Promise<import("../../features/analytics/events").BatchEventResponse>;
+    /** Track a click on a tagged element. */
+    click(elementId: string, elementText: string, properties?: Record<string, unknown>): Promise<import("../../features/analytics/events").EventResponse>;
+    /** Track a form interaction. */
+    form(formId: string, formName: string, properties?: Record<string, unknown>): Promise<import("../../features/analytics/events").EventResponse>;
+    /** Track a search query. */
+    search(query: string, category: string, properties?: Record<string, unknown>): Promise<import("../../features/analytics/events").EventResponse>;
+    /** Track a runtime error. */
+    error(message: string, type: string, properties?: Record<string, unknown>): Promise<import("../../features/analytics/events").EventResponse>;
+}