@gymmymac/bob-widget 1.2.2 → 1.4.3

package/dist/BobProvider.d.ts

@@ -2,6 +2,8 @@ import { ReactNode } from 'react';
 import { SupabaseClient } from '@supabase/supabase-js';
 import { QueryClient } from '@tanstack/react-query';
 import { BobConfig, HostApiConfig, HostContext, BobCallbacks } from './types';
+import { BobGA4Config } from './types/analytics';
+import { useBobAnalytics } from './hooks/useBobAnalytics';
 
 /**
  * Internal context value structure
@@ -19,6 +21,14 @@ interface BobContextValue {
     callbacks: BobCallbacks;
     /** Update host context (for dynamic updates) */
     updateHostContext: (updates: Partial<HostContext>) => void;
+    /** GA4 configuration */
+    ga4Config?: BobGA4Config;
+    /** Whether analytics is enabled */
+    analyticsEnabled: boolean;
+    /** Bottom offset in pixels for host navigation bars */
+    bottomOffset: number;
+    /** Base z-index for Bob's UI elements */
+    zIndexBase: number;
 }
 interface BobProviderProps {
     children: ReactNode;
@@ -32,6 +42,14 @@ interface BobProviderProps {
     callbacks?: BobCallbacks;
     /** Optional external QueryClient - if not provided, an internal one is created */
     queryClient?: QueryClient;
+    /** GA4 configuration for analytics */
+    ga4Config?: BobGA4Config;
+    /** Enable/disable analytics tracking */
+    analyticsEnabled?: boolean;
+    /** Bottom offset in pixels for host navigation bars */
+    bottomOffset?: number;
+    /** Base z-index for Bob's UI elements */
+    zIndexBase?: number;
 }
 /**
  * BobProvider - Context provider for the Bob widget
@@ -65,7 +83,7 @@ interface BobProviderProps {
  * </BobProvider>
  * ```
  */
-export declare function BobProvider({ children, bobConfig, hostApiConfig, hostContext: initialHostContext, callbacks, queryClient: externalQueryClient, }: BobProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function BobProvider({ children, bobConfig, hostApiConfig, hostContext: initialHostContext, callbacks, queryClient: externalQueryClient, ga4Config, analyticsEnabled, bottomOffset, zIndexBase, }: BobProviderProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Hook to access Bob context
  * Must be used within a BobProvider
@@ -87,4 +105,23 @@ export declare function useHostApiConfig(): HostApiConfig;
  * Hook to access Bob callbacks
  */
 export declare function useBobCallbacks(): BobCallbacks;
+/**
+ * Hook to access GA4 config and analytics status
+ */
+export declare function useBobAnalyticsConfig(): {
+    ga4Config?: BobGA4Config;
+    enabled: boolean;
+};
+/**
+ * Hook to access layout configuration (bottomOffset, zIndexBase)
+ * Returns safe defaults when used outside BobProvider (for demo/standalone usage)
+ */
+export declare function useBobLayoutConfig(): {
+    bottomOffset: number;
+    zIndexBase: number;
+};
+/**
+ * Re-export the analytics hook with context wiring
+ */
+export { useBobAnalytics };
 export default BobProvider;

package/dist/components/BobWidget.d.ts

@@ -1,6 +1,7 @@
 import { default as React } from 'react';
 import { BobVariant } from './Bob';
 import { BobConfig, HostApiConfig, HostContext, BobCallbacks } from '../types';
+import { BobGA4Config } from '../types/analytics';
 
 /**
  * Props for the self-contained BobWidget component
@@ -34,6 +35,22 @@ export interface BobWidgetProps {
     verticalOffset?: number;
     /** Scale percentage for Bob character */
     scale?: number;
+    /** GA4 configuration for analytics */
+    ga4Config?: BobGA4Config;
+    /** Enable/disable analytics tracking */
+    analyticsEnabled?: boolean;
+    /**
+     * Bottom offset in pixels for host navigation bars.
+     * Bob's UI will be positioned this many pixels above the viewport bottom.
+     * Use this when your host site has a bottom navigation bar.
+     * @example bottomOffset={60} // For a 60px bottom nav
+     */
+    bottomOffset?: number;
+    /**
+     * Base z-index for Bob's UI elements. Default: 50
+     * Bob calculates internal z-indexes relative to this base.
+     */
+    zIndexBase?: number;
 }
 /**
  * BobWidget - Self-contained Bob widget component

package/dist/hooks/useBobAnalytics.d.ts

@@ -0,0 +1,77 @@
+import { BobEventName, BobGA4Config } from '../types/analytics';
+import { HostContext, BobCallbacks } from '../types/context';
+
+declare global {
+    interface Window {
+        gtag?: (command: 'event', eventName: string, eventParams?: Record<string, unknown>) => void;
+        dataLayer?: unknown[];
+    }
+}
+interface UseBobAnalyticsProps {
+    /** GA4 configuration */
+    ga4Config?: BobGA4Config;
+    /** Host context for user/vehicle info */
+    hostContext?: HostContext;
+    /** Callbacks including onAnalyticsEvent */
+    callbacks?: BobCallbacks;
+    /** Whether analytics is enabled */
+    enabled?: boolean;
+}
+interface UseBobAnalyticsReturn {
+    /** Track any event */
+    trackEvent: (eventName: BobEventName, parameters?: Record<string, unknown>) => void;
+    /** Session ID for this widget instance */
+    sessionId: string;
+    /** Track session start */
+    trackSessionStart: () => void;
+    /** Track message sent */
+    trackMessageSent: (messageLength: number, hasVehicle: boolean) => void;
+    /** Track vehicle identified */
+    trackVehicleIdentified: (vehicle: {
+        make?: string;
+        model?: string;
+        year?: string | number;
+        rego?: string;
+    }) => void;
+    /** Track parts viewed */
+    trackPartsViewed: (partCount: number, vehicleId?: string) => void;
+    /** Track product clicked */
+    trackProductClicked: (product: {
+        sku: string;
+        product_name: string;
+        price: number;
+        brand?: string;
+    }) => void;
+    /** Track product viewed (detail) */
+    trackProductViewed: (product: {
+        sku: string;
+        product_name: string;
+        price: number;
+        brand?: string;
+    }) => void;
+    /** Track add to cart */
+    trackAddToCart: (product: {
+        sku: string;
+        product_name: string;
+        price: number;
+        brand?: string;
+        quantity?: number;
+    }) => void;
+    /** Track checkout started */
+    trackCheckoutStarted: (cartValue: number, itemCount: number) => void;
+    /** Track speech played */
+    trackSpeechPlayed: (textLength: number) => void;
+    /** Track speech failed */
+    trackSpeechFailed: (textLength: number) => void;
+    /** Track error */
+    trackError: (errorType: string, errorMessage: string) => void;
+}
+/**
+ * Hook for tracking Bob widget analytics events
+ *
+ * Sends events to:
+ * 1. GA4 via gtag() if configured and available
+ * 2. onAnalyticsEvent callback for server-side storage
+ */
+export declare function useBobAnalytics({ ga4Config, hostContext, callbacks, enabled, }: UseBobAnalyticsProps): UseBobAnalyticsReturn;
+export default useBobAnalytics;

package/dist/index.d.ts

@@ -3,10 +3,12 @@
  *
  * AI-powered automotive parts assistant widget - Full immersive experience
  *
- * v1.1.4+ - Self-contained with internal QueryClientProvider
+ * v1.4.0 - Redesigned PTT button: 3x larger, green "TALK" text, floating cartoon style
+ * v1.3.1 - Bottom offset support for host navigation bars
+ * v1.3.0 - GA4 Analytics integration
  */
 export { BOB_VERSION, getBobVersion } from './version';
-export { BobProvider, useBobContext, useBobSupabase, useHostContext, useHostApiConfig, useBobCallbacks, } from './BobProvider';
+export { BobProvider, useBobContext, useBobSupabase, useHostContext, useHostApiConfig, useBobCallbacks, useBobAnalyticsConfig, useBobAnalytics, useBobLayoutConfig, } from './BobProvider';
 export { BobWidget } from './components/BobWidget';
 export type { BobWidgetProps } from './components/BobWidget';
 export { Bob } from './components/Bob';
@@ -21,8 +23,9 @@ export { useBobAnimationData } from './hooks/useBobAnimationData';
 export { useBobStateTransitions } from './hooks/useBobStateTransitions';
 export { useSpeechRecognition } from './hooks/useSpeechRecognition';
 export { useBobBackdrop } from './hooks/useBobBackdrop';
-export type { HostContext, HostUserContext, HostVehicleContext, HostCartContext, HostHistoryContext, BobConfig, HostApiConfig, BobCallbacks, BobProviderConfig, } from './types/context';
+export type { HostContext, HostUserContext, HostVehicleContext, HostCartContext, HostHistoryContext, BobConfig, HostApiConfig, BobCallbacks, BobProviderConfig, BobLayoutConfig, } from './types/context';
 export type { Vehicle } from './types/vehicle';
 export type { Product, APIPart, CartItem, ServicePackage, } from './types/product';
 export type { Message, HighlightedProduct, } from './types/message';
 export type { BobAnimationConfig, AnimationStateDefinition, BobLook, BobAnimationData, } from './hooks/useBobAnimationData';
+export type { BobEventName, BobAnalyticsEvent, BobGA4Config, SessionStartParams, MessageSentParams, VehicleIdentifiedParams, PartsViewedParams, ProductParams, CheckoutParams, SpeechParams, ErrorParams, } from './types/analytics';