@builtonveya/analytics-web 4.0.0

package/dist/esm/core/VeyaAnalyticsCore.js

@@ -0,0 +1,673 @@
+/**
+ * Veya Analytics SDK - Core
+ * Platform-agnostic core that works on Web and React Native
+ *
+ * @version 4.0.0
+ */
+// ============================================================================
+// DEFAULT CONFIG
+// ============================================================================
+const DEFAULT_CONFIG = {
+    tenantSlug: '',
+    tenantId: '',
+    storeId: '',
+    storeName: '',
+    endpoint: 'https://analytics.veya.io/v1/events',
+    aiEndpoint: 'https://analytics.veya.io/v1/classify',
+    batchSize: 10,
+    flushInterval: 5000,
+    sessionTimeout: 30 * 60 * 1000,
+    debug: false,
+    autoDetect: true,
+    autoTrackProducts: true,
+    autoTrackCart: true,
+    interceptOloApi: true,
+    useAiClassification: true,
+    confidenceThreshold: 0.7,
+    platform: 'web'
+};
+// ============================================================================
+// UTILITIES
+// ============================================================================
+export function generateUUID() {
+    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);
+    });
+}
+export function getTimestamp() {
+    return new Date().toISOString();
+}
+// ============================================================================
+// CORE ANALYTICS CLASS
+// ============================================================================
+export class VeyaAnalyticsCore {
+    constructor() {
+        this.initialized = false;
+        this.eventQueue = [];
+        this.flushTimer = null;
+        // Identifiers
+        this.sessionId = '';
+        this.visitorId = '';
+        this.customerId = null;
+        // State
+        this.sessionData = {
+            is_logged_in: false,
+            login_method: null,
+            logged_in_at: null,
+            login_funnel_step: null,
+            experiment_assignments: {}
+        };
+        this.cartState = {
+            items: [],
+            itemCount: 0,
+            total: 0
+        };
+        this.deviceInfo = null;
+        this.currentScreenName = '';
+        this.currentPageType = '';
+        this.currentFunnelStep = null;
+        // Storage adapter - must be set by platform-specific implementation
+        this.storage = null;
+        this.config = { ...DEFAULT_CONFIG };
+    }
+    // ============================================================================
+    // INITIALIZATION
+    // ============================================================================
+    async init(options) {
+        if (this.initialized) {
+            this.log('warn', 'SDK already initialized');
+            return this;
+        }
+        if (!options.tenantSlug && !options.tenantId) {
+            throw new Error('VeyaAnalytics: tenantSlug is required');
+        }
+        this.config = { ...DEFAULT_CONFIG, ...options };
+        // Sync: tenantSlug takes precedence, fall back to tenantId
+        if (!this.config.tenantSlug) {
+            this.config.tenantSlug = this.config.tenantId;
+        }
+        // Initialize visitor and session
+        await this.initVisitor();
+        await this.initSession();
+        // Get device info (implemented by platform-specific class)
+        this.deviceInfo = await this.getDeviceInfo();
+        // Start flush timer
+        this.startFlushTimer();
+        // Track session start
+        this.trackSessionStart();
+        this.initialized = true;
+        this.log('info', 'VeyaAnalytics initialized', {
+            tenantSlug: this.config.tenantSlug,
+            visitorId: this.visitorId,
+            sessionId: this.sessionId,
+            platform: this.config.platform
+        });
+        return this;
+    }
+    async initVisitor() {
+        if (!this.storage) {
+            this.visitorId = generateUUID();
+            return;
+        }
+        const stored = await this.storage.getItem('veya_visitor_id');
+        if (stored) {
+            this.visitorId = stored;
+        }
+        else {
+            this.visitorId = generateUUID();
+            await this.storage.setItem('veya_visitor_id', this.visitorId);
+        }
+    }
+    async initSession() {
+        if (!this.storage) {
+            this.sessionId = generateUUID();
+            return;
+        }
+        const stored = await this.storage.getItem('veya_session');
+        const now = Date.now();
+        if (stored) {
+            try {
+                const sessionData = JSON.parse(stored);
+                if ((now - sessionData.lastActivity) < this.config.sessionTimeout) {
+                    this.sessionId = sessionData.sessionId;
+                    this.sessionData = { ...this.sessionData, ...sessionData.data };
+                    await this.saveSession();
+                    return;
+                }
+            }
+            catch (e) { }
+        }
+        // New session
+        this.sessionId = generateUUID();
+        await this.saveSession();
+    }
+    async saveSession() {
+        if (!this.storage)
+            return;
+        await this.storage.setItem('veya_session', JSON.stringify({
+            sessionId: this.sessionId,
+            lastActivity: Date.now(),
+            data: this.sessionData
+        }));
+    }
+    // Override in platform-specific implementations
+    async getDeviceInfo() {
+        return {
+            device_type: 'unknown',
+            platform: this.config.platform || 'unknown',
+            os: 'unknown',
+            screen_width: 0,
+            screen_height: 0,
+            language: 'en',
+            timezone: 'UTC'
+        };
+    }
+    // ============================================================================
+    // CORE TRACKING
+    // ============================================================================
+    track(eventName, properties = {}) {
+        if (!this.initialized) {
+            this.log('warn', 'SDK not initialized');
+            return this;
+        }
+        const event = this.buildEvent(eventName, properties);
+        this.queueEvent(event);
+        this.log('debug', 'Event tracked', event);
+        return this;
+    }
+    buildEvent(eventName, properties) {
+        return {
+            event_id: generateUUID(),
+            event_name: eventName,
+            event_category: properties.category || this.inferCategory(eventName),
+            event_timestamp: getTimestamp(),
+            // Identifiers
+            tenant_id: this.config.tenantSlug || this.config.tenantId || '',
+            tenant_slug: this.config.tenantSlug || this.config.tenantId || '',
+            session_id: this.sessionId,
+            visitor_id: this.visitorId,
+            customer_id: this.customerId || undefined,
+            store_id: this.config.storeId || properties.store_id,
+            store_name: this.config.storeName || properties.store_name,
+            // Context
+            page_url: properties.page_url,
+            page_title: properties.page_title,
+            page_type: properties.page_type || this.currentPageType,
+            screen_name: properties.screen_name || this.currentScreenName,
+            referrer: properties.referrer,
+            // Device info
+            ...this.deviceInfo,
+            // Session state
+            is_logged_in: this.sessionData.is_logged_in,
+            login_method: this.sessionData.login_method || undefined,
+            // Funnel
+            funnel_step: properties.funnel_step || this.currentFunnelStep?.name,
+            funnel_step_number: properties.funnel_step_number || this.currentFunnelStep?.number,
+            // Cart
+            cart_value: this.cartState.total,
+            cart_item_count: this.cartState.itemCount,
+            // Experiments
+            experiment_assignments: this.sessionData.experiment_assignments,
+            // Custom properties
+            properties: this.sanitizeProperties(properties)
+        };
+    }
+    inferCategory(eventName) {
+        if (eventName.includes('cart'))
+            return 'cart';
+        if (eventName.includes('checkout') || eventName.includes('order'))
+            return 'checkout';
+        if (eventName.includes('product') || eventName.includes('menu'))
+            return 'catalog';
+        if (eventName.includes('login') || eventName.includes('auth'))
+            return 'auth';
+        if (eventName.includes('error'))
+            return 'error';
+        if (eventName.includes('screen') || eventName.includes('page') || eventName.includes('session'))
+            return 'navigation';
+        return 'engagement';
+    }
+    sanitizeProperties(properties) {
+        const sanitized = { ...properties };
+        // Remove internal properties
+        delete sanitized.category;
+        delete sanitized.page_type;
+        delete sanitized.store_id;
+        delete sanitized.page_url;
+        delete sanitized.page_title;
+        delete sanitized.screen_name;
+        delete sanitized.referrer;
+        delete sanitized.funnel_step;
+        delete sanitized.funnel_step_number;
+        // Remove PII
+        const piiFields = ['email', 'phone', 'password', 'ssn', 'credit_card', 'cvv'];
+        piiFields.forEach(field => delete sanitized[field]);
+        return sanitized;
+    }
+    // ============================================================================
+    // SESSION TRACKING
+    // ============================================================================
+    trackSessionStart() {
+        this.track('session_start', {
+            platform: this.config.platform
+        });
+    }
+    trackSessionEnd() {
+        this.track('session_end', {});
+        this.flush(true);
+    }
+    // ============================================================================
+    // SCREEN / PAGE TRACKING
+    // ============================================================================
+    screenView(screenName, properties = {}) {
+        this.currentScreenName = screenName;
+        this.currentPageType = this.inferPageType(screenName);
+        this.updateFunnelStep(this.currentPageType);
+        return this.track('screen_view', {
+            screen_name: screenName,
+            page_type: this.currentPageType,
+            ...properties
+        });
+    }
+    pageView(properties = {}) {
+        const pageType = properties.pageType || properties.page_type || 'unknown';
+        this.currentPageType = pageType;
+        this.updateFunnelStep(pageType);
+        return this.track('page_view', {
+            page_type: pageType,
+            ...properties
+        });
+    }
+    inferPageType(screenName) {
+        const name = screenName.toLowerCase();
+        if (name.includes('menu') || name.includes('order') || name.includes('food'))
+            return 'menu';
+        if (name.includes('cart') || name.includes('basket') || name.includes('bag'))
+            return 'cart';
+        if (name.includes('checkout') || name.includes('payment'))
+            return 'checkout';
+        if (name.includes('confirm') || name.includes('success') || name.includes('thank'))
+            return 'confirmation';
+        if (name.includes('product') || name.includes('item') || name.includes('detail'))
+            return 'product';
+        if (name.includes('location') || name.includes('store'))
+            return 'location';
+        if (name.includes('account') || name.includes('profile') || name.includes('login'))
+            return 'account';
+        if (name.includes('reward') || name.includes('loyalty') || name.includes('point'))
+            return 'rewards';
+        if (name.includes('home') || name.includes('landing'))
+            return 'home';
+        return 'other';
+    }
+    updateFunnelStep(pageType) {
+        const funnelMap = {
+            home: { name: 'landing', number: 1 },
+            location: { name: 'location', number: 1 },
+            menu: { name: 'menu', number: 2 },
+            product: { name: 'menu', number: 2 },
+            cart: { name: 'cart', number: 3 },
+            checkout: { name: 'checkout', number: 4 },
+            confirmation: { name: 'confirmation', number: 5 }
+        };
+        this.currentFunnelStep = funnelMap[pageType] || null;
+    }
+    // ============================================================================
+    // PRODUCT TRACKING
+    // ============================================================================
+    productView(product, properties = {}) {
+        return this.track('product_view', {
+            product_id: product.id || product.product_id,
+            product_name: product.name || product.product_name,
+            product_category: product.category,
+            product_price: product.price,
+            ...properties
+        });
+    }
+    productClick(product, properties = {}) {
+        return this.track('product_click', {
+            product_id: product.id || product.product_id,
+            product_name: product.name || product.product_name,
+            product_category: product.category,
+            product_price: product.price,
+            ...properties
+        });
+    }
+    // ============================================================================
+    // CART TRACKING
+    // ============================================================================
+    addToCart(product, quantity = 1, properties = {}) {
+        this.cartState.itemCount += quantity;
+        this.cartState.total += (product.price || 0) * quantity;
+        this.cartState.items.push({ ...product, quantity });
+        return this.track('add_to_cart', {
+            product_id: product.id || product.product_id,
+            product_name: product.name || product.product_name,
+            product_category: product.category,
+            product_price: product.price,
+            quantity,
+            ...properties
+        });
+    }
+    removeFromCart(product, quantity = 1, properties = {}) {
+        this.cartState.itemCount = Math.max(0, this.cartState.itemCount - quantity);
+        this.cartState.total = Math.max(0, this.cartState.total - (product.price || 0) * quantity);
+        return this.track('remove_from_cart', {
+            product_id: product.id || product.product_id,
+            product_name: product.name || product.product_name,
+            product_category: product.category,
+            product_price: product.price,
+            quantity,
+            ...properties
+        });
+    }
+    updateCartQuantity(product, oldQuantity, newQuantity) {
+        const diff = newQuantity - oldQuantity;
+        this.cartState.itemCount += diff;
+        this.cartState.total += (product.price || 0) * diff;
+        return this.track('update_cart_quantity', {
+            product_id: product.id || product.product_id,
+            product_name: product.name || product.product_name,
+            old_quantity: oldQuantity,
+            new_quantity: newQuantity
+        });
+    }
+    setCart(cart) {
+        this.cartState = {
+            items: cart.items || [],
+            itemCount: cart.itemCount || 0,
+            total: cart.total || 0
+        };
+        return this;
+    }
+    viewCart(properties = {}) {
+        return this.track('cart_view', {
+            cart_value: this.cartState.total,
+            cart_item_count: this.cartState.itemCount,
+            ...properties
+        });
+    }
+    // ============================================================================
+    // CHECKOUT TRACKING
+    // ============================================================================
+    checkoutStart(properties = {}) {
+        this.updateFunnelStep('checkout');
+        return this.track('checkout_start', {
+            cart_value: this.cartState.total,
+            cart_item_count: this.cartState.itemCount,
+            ...properties
+        });
+    }
+    checkoutStep(step, properties = {}) {
+        return this.track('checkout_step', {
+            checkout_step: step,
+            ...properties
+        });
+    }
+    checkoutComplete(order, properties = {}) {
+        this.updateFunnelStep('confirmation');
+        const event = this.track('checkout_complete', {
+            order_id: order.id || order.order_id,
+            olo_order_id: order.olo_order_id,
+            order_total: order.total,
+            subtotal: order.subtotal,
+            tax: order.tax,
+            tip: order.tip,
+            item_count: order.itemCount || order.item_count,
+            order_type: order.orderType || order.order_type,
+            payment_method: order.paymentMethod || order.payment_method,
+            ...properties
+        });
+        // Clear cart
+        this.cartState = { items: [], itemCount: 0, total: 0 };
+        return event;
+    }
+    // ============================================================================
+    // AUTH TRACKING
+    // ============================================================================
+    loginAttempt(method, properties = {}) {
+        return this.track('login_attempt', {
+            login_method: method,
+            funnel_step: this.currentFunnelStep?.name,
+            ...properties
+        });
+    }
+    loginSuccess(method, customerId, properties = {}) {
+        this.sessionData.is_logged_in = true;
+        this.sessionData.login_method = method;
+        this.sessionData.logged_in_at = getTimestamp();
+        this.sessionData.login_funnel_step = this.currentFunnelStep?.name || null;
+        if (customerId) {
+            this.customerId = customerId;
+        }
+        this.saveSession();
+        return this.track('login_success', {
+            login_method: method,
+            customer_id: customerId,
+            funnel_step: this.currentFunnelStep?.name,
+            ...properties
+        });
+    }
+    loginFailure(method, error, properties = {}) {
+        return this.track('login_failure', {
+            login_method: method,
+            error_message: error,
+            ...properties
+        });
+    }
+    logout(properties = {}) {
+        const previousCustomerId = this.customerId;
+        this.sessionData.is_logged_in = false;
+        this.customerId = null;
+        this.saveSession();
+        return this.track('logout', {
+            previous_customer_id: previousCustomerId,
+            ...properties
+        });
+    }
+    identify(customerId, traits = {}) {
+        this.customerId = customerId;
+        this.sessionData.is_logged_in = true;
+        this.saveSession();
+        return this.track('identify', {
+            customer_id: customerId,
+            traits: this.sanitizeProperties(traits)
+        });
+    }
+    // ============================================================================
+    // STORE SELECTION
+    // ============================================================================
+    storeSelect(store, properties = {}) {
+        const storeId = store.id || store.store_id;
+        const storeName = store.name || store.store_name;
+        if (storeId) {
+            this.config.storeId = storeId;
+        }
+        if (storeName) {
+            // Persist so every subsequent event carries the name (the warehouse
+            // resolves location names via ANY_VALUE(store_name) per store_id).
+            this.config.storeName = storeName;
+        }
+        return this.track('store_select', {
+            store_id: storeId,
+            store_name: storeName,
+            ...properties
+        });
+    }
+    setStore(storeId, storeName) {
+        this.config.storeId = storeId;
+        if (storeName) {
+            this.config.storeName = storeName;
+        }
+        return this;
+    }
+    // ============================================================================
+    // SEARCH
+    // ============================================================================
+    search(query, resultCount, properties = {}) {
+        return this.track('search', {
+            search_query: query,
+            result_count: resultCount,
+            ...properties
+        });
+    }
+    // ============================================================================
+    // LOYALTY / REWARDS
+    // ============================================================================
+    loyaltyLogin(customer, properties = {}) {
+        const customerId = customer.id || customer.customer_id;
+        if (customerId) {
+            this.customerId = customerId;
+        }
+        return this.track('loyalty_login', {
+            customer_id: customerId,
+            loyalty_tier: customer.tier,
+            points_balance: customer.points,
+            ...properties
+        });
+    }
+    rewardView(reward, properties = {}) {
+        return this.track('reward_view', {
+            reward_id: reward.id,
+            reward_name: reward.name,
+            reward_value: reward.value,
+            points_required: reward.points_required,
+            ...properties
+        });
+    }
+    rewardApply(reward, properties = {}) {
+        return this.track('reward_apply', {
+            reward_id: reward.id,
+            reward_name: reward.name,
+            reward_value: reward.value,
+            points_used: reward.points_used,
+            ...properties
+        });
+    }
+    rewardRemove(reward, properties = {}) {
+        return this.track('reward_remove', {
+            reward_id: reward.id,
+            reward_name: reward.name,
+            ...properties
+        });
+    }
+    // ============================================================================
+    // PROMO CODES
+    // ============================================================================
+    promoApply(promo, properties = {}) {
+        return this.track('promo_apply', {
+            promo_code: promo.code,
+            discount_amount: promo.discount,
+            success: promo.success,
+            error_message: promo.error,
+            ...properties
+        });
+    }
+    promoRemove(promoCode, properties = {}) {
+        return this.track('promo_remove', {
+            promo_code: promoCode,
+            ...properties
+        });
+    }
+    // ============================================================================
+    // EXPERIMENTS
+    // ============================================================================
+    setExperiment(experimentKey, variantKey) {
+        this.sessionData.experiment_assignments[experimentKey] = variantKey;
+        this.saveSession();
+        return this.track('experiment_assigned', {
+            experiment_key: experimentKey,
+            variant_key: variantKey
+        });
+    }
+    // ============================================================================
+    // ERRORS
+    // ============================================================================
+    error(errorType, errorMessage, context = {}) {
+        return this.track('error', {
+            error_type: errorType,
+            error_message: errorMessage,
+            ...context
+        });
+    }
+    // ============================================================================
+    // QUEUE & FLUSH
+    // ============================================================================
+    queueEvent(event) {
+        this.eventQueue.push(event);
+        if (this.eventQueue.length >= this.config.batchSize) {
+            this.flush();
+        }
+    }
+    startFlushTimer() {
+        this.flushTimer = setInterval(() => {
+            if (this.eventQueue.length > 0) {
+                this.flush();
+            }
+        }, this.config.flushInterval);
+    }
+    async flush(sync = false) {
+        if (this.eventQueue.length === 0)
+            return;
+        const events = [...this.eventQueue];
+        this.eventQueue = [];
+        const payload = {
+            batch_id: generateUUID(),
+            tenant_slug: this.config.tenantSlug || this.config.tenantId,
+            events,
+            sent_at: getTimestamp()
+        };
+        try {
+            await fetch(this.config.endpoint, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(payload)
+            });
+            this.log('debug', 'Flushed events', { count: events.length });
+        }
+        catch (error) {
+            this.log('error', 'Failed to send events', error);
+            // Re-queue events
+            this.eventQueue = [...events, ...this.eventQueue];
+        }
+    }
+    // ============================================================================
+    // UTILITIES
+    // ============================================================================
+    getSessionId() {
+        return this.sessionId;
+    }
+    getVisitorId() {
+        return this.visitorId;
+    }
+    getCustomerId() {
+        return this.customerId;
+    }
+    isLoggedIn() {
+        return this.sessionData.is_logged_in;
+    }
+    log(level, message, data) {
+        if (!this.config.debug && level === 'debug')
+            return;
+        const prefix = '[VeyaAnalytics]';
+        if (level === 'error') {
+            console.error(prefix, message, data || '');
+        }
+        else if (level === 'warn') {
+            console.warn(prefix, message, data || '');
+        }
+        else {
+            console.log(prefix, message, data || '');
+        }
+    }
+    destroy() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+        }
+        this.flush(true);
+    }
+}
+export default VeyaAnalyticsCore;
+//# sourceMappingURL=VeyaAnalyticsCore.js.map