flowgrid-sdk 1.2.1 → 1.4.1

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.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>;
+}

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

@@ -0,0 +1,30 @@
+export class EventTracker {
+    constructor(client) {
+        this.client = client;
+    }
+    /** Track a custom event. */
+    track(eventName, properties, opts) {
+        return this.client.track({ eventName, properties, userId: opts?.userId, sessionId: opts?.sessionId });
+    }
+    /** Track many events in one request. */
+    batch(events) {
+        return this.client.trackBatch({ events });
+    }
+    /** Track a click on a tagged element. */
+    click(elementId, elementText, properties) {
+        return this.client.trackClick({ elementId, elementText, properties });
+    }
+    /** Track a form interaction. */
+    form(formId, formName, properties) {
+        return this.client.trackForm({ formId, formName, properties });
+    }
+    /** Track a search query. */
+    search(query, category, properties) {
+        return this.client.trackSearch({ query, category, properties });
+    }
+    /** Track a runtime error. */
+    error(message, type, properties) {
+        return this.client.trackError({ message, type, properties });
+    }
+}
+//# sourceMappingURL=events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../../src/lib/tracking/analytics/events.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,YAAY;IACvB,YAA4B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAE9C,4BAA4B;IAC5B,KAAK,CAAC,SAAiB,EAAE,UAAoC,EAAE,IAA8C;QAC3G,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IACxG,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,MAA0E;QAC9E,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,SAAiB,EAAE,WAAmB,EAAE,UAAoC;QAChF,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,gCAAgC;IAChC,IAAI,CAAC,MAAc,EAAE,QAAgB,EAAE,UAAoC;QACzE,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,4BAA4B;IAC5B,MAAM,CAAC,KAAa,EAAE,QAAgB,EAAE,UAAoC;QAC1E,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,6BAA6B;IAC7B,KAAK,CAAC,OAAe,EAAE,IAAY,EAAE,UAAoC;QACvE,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IAC/D,CAAC;CACF"}

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

@@ -0,0 +1,16 @@
+/**
+ * Funnel shortcuts.
+ */
+import { Funnels } from "../../features/analytics/funnels";
+export declare class FunnelTracker {
+    readonly client: Funnels;
+    constructor(client: Funnels);
+    /** Define a new funnel (admin / setup). */
+    define(definition: Parameters<Funnels["define"]>[0]): Promise<import("../../features/analytics/funnels").FunnelStepResponse>;
+    /** Record a step completion in a funnel. */
+    step(funnelId: string, step: string, stepNumber: number, userId?: string, properties?: Record<string, unknown>): Promise<import("../../features/analytics/funnels").FunnelStepResponse>;
+    /** Mark a funnel as completed. */
+    complete(funnelId: string, userId?: string, properties?: Record<string, unknown>): Promise<import("../../features/analytics/funnels").FunnelStepResponse>;
+    /** Mark a funnel as abandoned. */
+    abandon(funnelId: string, lastStep: string, userId?: string, reason?: string): Promise<import("../../features/analytics/funnels").FunnelStepResponse>;
+}

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

@@ -0,0 +1,22 @@
+export class FunnelTracker {
+    constructor(client) {
+        this.client = client;
+    }
+    /** Define a new funnel (admin / setup). */
+    define(definition) {
+        return this.client.define(definition);
+    }
+    /** Record a step completion in a funnel. */
+    step(funnelId, step, stepNumber, userId, properties) {
+        return this.client.trackStep({ funnelId, step, stepNumber, userId, properties });
+    }
+    /** Mark a funnel as completed. */
+    complete(funnelId, userId, properties) {
+        return this.client.trackComplete(funnelId, userId, properties);
+    }
+    /** Mark a funnel as abandoned. */
+    abandon(funnelId, lastStep, userId, reason) {
+        return this.client.trackAbandon(funnelId, lastStep, userId, reason);
+    }
+}
+//# sourceMappingURL=funnels.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"funnels.js","sourceRoot":"","sources":["../../../../src/lib/tracking/analytics/funnels.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,aAAa;IACxB,YAA4B,MAAe;QAAf,WAAM,GAAN,MAAM,CAAS;IAAG,CAAC;IAE/C,2CAA2C;IAC3C,MAAM,CAAC,UAA4C;QACjD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAED,4CAA4C;IAC5C,IAAI,CAAC,QAAgB,EAAE,IAAY,EAAE,UAAkB,EAAE,MAAe,EAAE,UAAoC;QAC5G,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,kCAAkC;IAClC,QAAQ,CAAC,QAAgB,EAAE,MAAe,EAAE,UAAoC;QAC9E,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IACjE,CAAC;IAED,kCAAkC;IAClC,OAAO,CAAC,QAAgB,EAAE,QAAgB,EAAE,MAAe,EAAE,MAAe;QAC1E,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtE,CAAC;CACF"}

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

@@ -0,0 +1,27 @@
+/**
+ * Heatmap shortcuts.
+ */
+import { Heatmaps } from "../../features/analytics/heatmaps";
+export declare class HeatmapTracker {
+    readonly client: Heatmaps;
+    constructor(client: Heatmaps);
+    /** Record a click point. */
+    click(pageUrl: string, x: number, y: number, viewportWidth: number, viewportHeight: number): Promise<import("../../features/analytics/heatmaps").HeatmapResponse>;
+    /** Record a mouse-movement path. */
+    movement(pageUrl: string, path: Array<{
+        x: number;
+        y: number;
+        t: number;
+    }>, viewport: {
+        width: number;
+        height: number;
+    }): Promise<import("../../features/analytics/heatmaps").HeatmapResponse>;
+    /** Record scroll behaviour. */
+    scroll(pageUrl: string, maxScrollDepth: number, pageHeight: number, viewportHeight: number): Promise<import("../../features/analytics/heatmaps").HeatmapResponse>;
+    /** Auto-attach click + scroll listeners (and optionally mousemove). */
+    autoTrack(options?: {
+        movement?: boolean;
+        userId?: string;
+        sessionId?: string;
+    }): import("../../utils/browser").Teardown;
+}

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

@@ -0,0 +1,22 @@
+export class HeatmapTracker {
+    constructor(client) {
+        this.client = client;
+    }
+    /** Record a click point. */
+    click(pageUrl, x, y, viewportWidth, viewportHeight) {
+        return this.client.trackClick({ pageUrl, x, y, viewportWidth, viewportHeight });
+    }
+    /** Record a mouse-movement path. */
+    movement(pageUrl, path, viewport) {
+        return this.client.trackMovement({ pageUrl, path, viewport });
+    }
+    /** Record scroll behaviour. */
+    scroll(pageUrl, maxScrollDepth, pageHeight, viewportHeight) {
+        return this.client.trackScroll({ pageUrl, maxScrollDepth, pageHeight, viewportHeight });
+    }
+    /** Auto-attach click + scroll listeners (and optionally mousemove). */
+    autoTrack(options) {
+        return this.client.autoTrack(options);
+    }
+}
+//# sourceMappingURL=heatmaps.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"heatmaps.js","sourceRoot":"","sources":["../../../../src/lib/tracking/analytics/heatmaps.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,cAAc;IACzB,YAA4B,MAAgB;QAAhB,WAAM,GAAN,MAAM,CAAU;IAAG,CAAC;IAEhD,4BAA4B;IAC5B,KAAK,CAAC,OAAe,EAAE,CAAS,EAAE,CAAS,EAAE,aAAqB,EAAE,cAAsB;QACxF,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,oCAAoC;IACpC,QAAQ,CAAC,OAAe,EAAE,IAAgD,EAAE,QAA2C;QACrH,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,+BAA+B;IAC/B,MAAM,CAAC,OAAe,EAAE,cAAsB,EAAE,UAAkB,EAAE,cAAsB;QACxF,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,uEAAuE;IACvE,SAAS,CAAC,OAAqE;QAC7E,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;CACF"}

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

@@ -0,0 +1,16 @@
+/**
+ * User identification shortcuts.
+ */
+import { Identify } from "../../features/analytics/identify";
+export declare class IdentifyTracker {
+    readonly client: Identify;
+    constructor(client: Identify);
+    /** Identify a user with traits. */
+    user(userId: string, traits?: Record<string, unknown>, anonymousId?: string): Promise<import("../../features/analytics/identify").IdentifyResponse>;
+    /** Update traits on an existing user. */
+    updateTraits(userId: string, traits: Record<string, unknown>): Promise<import("../../features/analytics/identify").IdentifyResponse>;
+    /** Alias an anonymous ID to a known user ID. */
+    alias(previousId: string, userId: string): Promise<import("../../features/analytics/identify").IdentifyResponse>;
+    /** Associate a user with a group/company. */
+    group(userId: string, groupId: string, traits?: Record<string, unknown>): Promise<import("../../features/analytics/identify").IdentifyResponse>;
+}