voo_analytics 2.1.0

Local analytics and heat map tracking package for Flutter applications with touch event capture.

2.1.0

Improvements

• REFACTOR: Replace print statements with debugPrint across analytics repository and route-aware touch tracker
• REFACTOR: Clean up debug statements across analytics services
• REFACTOR: Update imports to use centralized voo_core package
• DEPS: Requires voo_core: ^1.2.0, voo_telemetry: ^1.1.0

Tests

• TEST: Enhance test cases for attribution, funnel, and user path models
• TEST: Add tests for deep link service, funnel span tracker, screen view span manager, and touch event metrics

---

2.0.0

BREAKING CHANGE: Full migration to OpenTelemetry (OTEL) as the default telemetry export mechanism.

Breaking Changes

• REMOVED: AnalyticsCloudSyncService and AnalyticsCloudSyncConfig classes deleted
• REMOVED: VooAnalyticsPlugin.cloudSyncService property
• REMOVED: VooAnalyticsPlugin.enableOtel() method - OTEL is now auto-enabled
• CHANGED: All analytics data automatically exported via OTLP when Voo.context is available

New Features

• FEAT: Auto-enable OTEL export via Voo.context - no manual configuration needed
• FEAT: Screen views exported as OTEL spans to /v1/traces
• FEAT: Touch events exported as OTEL metrics to /v1/metrics
• FEAT: Custom events added as span events for trace correlation
• FEAT: ScreenViewSpanManager for automatic screen engagement tracking
• FEAT: TouchEventMetrics with counters and histograms for heatmap data
• FEAT: FunnelSpanTracker for funnel analysis with linked spans
• FEAT: ReplayTraceCorrelator for session replay trace correlation

Migration Guide

// Before (1.x)
_analyticsCloudSync = AnalyticsCloudSyncService(
  config: AnalyticsCloudSyncConfig(...),
);
_analyticsCloudSync.initialize();
await VooAnalytics.initialize(cloudSyncService: _analyticsCloudSync);
VooAnalyticsPlugin.instance.cloudSyncService = _analyticsCloudSync;

// After (2.0) - OTEL auto-enabled via Voo.context
await Voo.initializeApp(
  config: VooConfig(
    endpoint: 'https://api.example.com',
    apiKey: 'your-key',
  ),
);
await VooAnalytics.initialize(); // OTEL auto-configured!

// Events automatically exported via OTLP
await VooAnalytics.logEvent('button_click', parameters: {'button': 'submit'});

---

1.1.1

New Features

• FEAT: Add VooFunnelProgress, VooFunnelStep, VooFunnelStepCompletion models for enhanced funnel tracking
• FEAT: Add VooPathNode and VooUserPathBuilder for user path analytics
• FEAT: Add HeatMapPoint entity for improved heat map data representation
• FEAT: Add ScreenViewEvent and VooInteractionEvent presentation models
• FEAT: Add AnalyticsRouteObserver widget for route-aware analytics tracking
• FEAT: Add TouchableWidget for declarative touch tracking

Improvements

• REFACTOR: Simplified Funnel and UserPath models with cleaner architecture
• REFACTOR: Enhanced FunnelTrackingService with FunnelEvent support
• REFACTOR: Improved NavigationObserver with better screen view tracking
• REFACTOR: Simplified HeatMapData and TouchEvent entities
• REFACTOR: Enhanced VooTrackable widget with improved tracking logic
• REFACTOR: Removed deprecated RouteAwareTouchTracker (replaced by AnalyticsRouteObserver)

---

1.1.0

Improvements

• ENHANCEMENT: Make projectId optional in AnalyticsCloudSyncConfig - the API key is now sufficient for authentication as the server derives the project from it
• ENHANCEMENT: Updated factory constructors (production, development) to not require projectId
• DEPS: Requires voo_core: ^1.1.0

---

1.0.0

Note: This release marks the first stable major version with breaking changes.

Breaking Changes

• Requires voo_core: ^1.0.0
• Cloud sync now uses shared BaseSyncService from voo_core
• TouchEvent constructor updated with position and id parameters

New Features

• FEAT: Add touch event queue with intelligent memory management
• FEAT: Implement session replay capture functionality for user interaction recording
• FEAT: Add feature toggle system for analytics services with configuration management
• FEAT: Implement user path tracking and funnel tracking services
• FEAT: Add ScreenEngagementService for tracking screen engagement metrics
• FEAT: Add VooTrackable widget for declarative user interaction tracking
• FEAT: Integrate breadcrumb service for tracking user navigation and actions
• FEAT: Add AppUsageService for tracking app usage statistics
• FEAT: Add InstallReferrer service for tracking app installation sources
• FEAT: Revenue tracking integration for e-commerce analytics

Improvements

• REFACTOR: Simplified constructor parameters and improved code readability
• REFACTOR: Enhanced analytics repository with better memory management
• ENHANCEMENT: Better integration with VooUserContext for session tracking
• ENHANCEMENT: Batch-level metadata support for sync payloads

---

0.4.4

• FIX: Add missing http dependency to pubspec.yaml.
• FIX: Update integration test to use new TouchEvent constructor with position and id parameters.

0.4.3

• FEAT: add example modules and run configurations for VooFlutter packages.

0.4.2

• FEAT: Introduce voo_tokens package for design tokens and responsive utilities.
• FEAT: Enhance form components with configurable options and improved theming.

0.4.1

fixed error causing repeated error in console DebugService: Error serving requestsError: Unsupported operation: Cannot send Null

0.4.0

Note: This release has breaking changes.

• REFACTOR: remove deprecated performance sync entity and update plugin structure.
• REFACTOR: Remove obsolete integration and widget tests; streamline HeatMapData and VooPerformance initialization.
• FEAT: Refactor network list and performance list to use new empty state widget.
• FEAT: Refactor NetworkList to support both log and request models.
• FEAT: Update changelogs for voo_analytics, voo_core, voo_logging, and voo_performance packages to reflect deprecation and migration to voo_telemetry.
• FEAT: Enhance topics in pubspec.yaml files for voo_analytics, voo_core, voo_logging, voo_performance, and voo_telemetry packages.
• FEAT: Add comprehensive test suite and configuration for VooTelemetry package.
• FEAT: Update package versions and descriptions; enhance import statements for consistency.
• FEAT: Enhance logging configuration with enableDevToolsJson option; update LogSyncEntity and SyncStorage for improved functionality.
• FEAT: Add cloud sync support for analytics and performance metrics; enhance VooAnalytics and VooPerformance plugins; update CHANGELOGs and tests.
• FEAT: Implement cloud sync functionality for analytics, logging, and performance data; add SyncEntity and CloudSyncManager classes; update version to 0.1.0.
• FEAT: Add license files and update package versions to 0.0.1 for voo_core, voo_analytics, and voo_performance.
• FEAT: Implement route-aware touch tracking and heat map visualization; enhance analytics data collection and UI components.
• FEAT: Enhance touch event logging and heat map visualization; improve coordinate normalization and rendering.
• FEAT: Integrate Voo Analytics and Performance tracking; add example pages for analytics and performance metrics.
• FEAT: Enhance Voo DevTools extension with heat map visualization and analytics improvements.
• FEAT: Update package versions and enhance analytics, performance, and logging functionalities.
• FEAT: Add analytics tracking and UI components to Voo DevTools extension.
• FEAT: Add VooFlutter example app with integration and widget tests.
• FEAT: Add logs and network details panels for improved logging functionality.
• BREAKING FEAT(voo_telemetry): Complete OpenTelemetry migration for VooFlutter.

0.3.0

• Added WASM support for web platform
• Improved documentation and API comments
• Added comprehensive examples
• Enhanced pub.dev score compliance
• Performance optimizations
• Restored active maintenance - package is no longer deprecated
• Enhanced heat map visualization
• Improved touch event tracking

0.2.0

• Improved analytics event tracking
• Enhanced route-aware analytics
• Better integration with DevTools extension
• Added touch tracking widget components

0.1.1

• Initial analytics implementation
• Basic heat map functionality
• Touch event capture system
  • Better performance and reliability

Migration Guide

// Before
import 'package:voo_analytics/voo_analytics.dart';
VooAnalytics.trackEvent('event_name', properties: {...});

// After
import 'package:voo_telemetry/voo_telemetry.dart';
VooTelemetry.instance.trackEvent('event_name', properties: {...});

0.1.0

• BREAKING CHANGE: Now requires voo_core ^0.1.0
• Added automatic cloud sync support for analytics events
• Introduced AnalyticsSyncEntity for cloud synchronization
• Integrated with CloudSyncManager from voo_core
• Analytics events and touch events are automatically synced to cloud
• Added support for batch syncing of analytics data
• Enhanced repository to support cloud sync without breaking existing functionality
• Improved offline-first architecture with automatic retry
• User properties and custom events are now cloud-syncable

0.0.2

• Updated dependencies (voo_core ^0.0.2, voo_logging ^0.0.15)
• Implemented heat map data tracking functionality
• Added touch event tracking for user interaction analytics
• Created TouchTrackerWidget for automatic touch tracking
• Implemented analytics repository with clean architecture
• Added support for heat map visualization data
• Enhanced integration with voo_logging for analytics events
• Improved JSON serialization for analytics data
• Added comprehensive analytics event structure

0.0.1

• Initial release
• Basic analytics infrastructure
• Foundation for heat map and touch tracking