flux_analytics_sdk 0.1.9

Flux Analytics official Flutter SDK for tracking events, sessions, and user identity.

Changelog

All notable changes to this project will be documented in this file.

0.1.9 - 2026-02-06

• Documentation: Added comprehensive guides for Crash Reporting and API Latency tracking.
• Documentation: Added a dedicated "How to Test" section for verifying integration.

0.1.8 - 2026-02-06

• Documentation: Comprehensive overhaul of README.md and added a detailed GUIDE.md for external project integrations.
• Documentation: Updated all code snippets to reflect latest best practices.

0.1.7 - 2026-02-06

• Maintenance: General stability improvements and internal updates for better dashboard compatibility.
• Sync: Version bump for release synchronization.

0.1.6 - 2026-02-05

• Fix: Resolved a critical race condition in the event queue processing where concurrent events (like session_start and app_install) could overwrite each other.
• Fix: Added missing client-side id (UUID) to both installs and events table payloads to ensure consistent database ingestion.
• Improved Stability: Implemented a more robust queue processing loop to prevent data loss during network hiccups or rapid event bursts.
• Reliability: Improved queue persistence by re-syncing with local storage after every successful network request.

0.1.4 - 2026-02-05

• Tools: Added Flux.resetInstallStatus() to manually reset the installation tracking, useful for testing app_install events without manual SharedPreferences manipulation.

0.1.3 - 2026-02-05

• Fix: Implemented UPSERT logic for the sessions table to prevent 409 Conflict errors during session end updates.
• Improved Reliability: SDK now uses on_conflict=session_id for session tracking, ensuring continuous data flow even if network retries occur.

0.1.2 - 2026-02-05

• Diagnostics: Added detailed network error logging for better troubleshooting of failed requests to Supabase.
• Diagnostics: Added queue processing logs to track data flow in real-time.

0.1.1 - 2026-02-05

• Persistence: Implemented flutter_secure_storage for iOS Keychain support. Anonymous IDs now survive app re-installs.
• Dependency Fix: Downgraded flutter_secure_storage to ^9.0.0 to resolve conflicts with aad_oauth and other common packages.
• Data Integrity: Added default fallback values for device info fields to prevent empty strings in database.
• User Identity: Enforced user_id fallback to anonymous_id in all event payloads for complete traceability.

0.1.0 - 2026-02-05

Added

• Full Session Management: Automatic tracking of app sessions with session_id, start_time, end_time, and duration.
• App Lifecycle Awareness: Automatic session restart on app resume and cleanup on app pause.
• Enhanced Event Log Schema: Every event now includes a mandatory session_id and device_id for path analysis.
• Sessions Table Support: Dedicated table tracking for high-fidelity session analytics.

Changed

• Refactored track method to automatically include session and device metadata.
• Internal: Improved type safety for event payloads.

0.0.9 - 2026-02-04

Fixed

• Fixed data ingestion issues by aligning SDK field names with database schema.
• Map event_name to game_type column for better filtering.
• Consolidate all metadata/properties into the metadata JSON column.

Added

• Direct support for the installs table for accurate attribution tracking.
• Polymorphic event queue that supports multiple database endpoints.

0.0.8 - 2026-02-04

Fixed

• Corrected default API URL that was pointing to a test project.
• Handling of trailing slashes in custom API endpoints.

Added

• Optional baseUrl parameter to Flux.init for custom endpoint support.

0.0.7 - 2026-02-04

Fixed

• Resolved iOS deployment issue: Renamed podspec to match the package name (flux_analytics_sdk.podspec).

0.0.6 - 2026-02-04

Changed

• Refined README installation guide to prioritize pub.dev.
• Synchronized Dashboard integration snippets with official package name.

0.0.5 - 2026-02-04

Changed

• Minor metadata updates and documentation refinement for public release.

0.0.4 - 2026-02-04

Added

• Anonymous ID persistence support.
• Automatic iOS identifierForVendor (IDFV) detection.
• Persistent UUID fallback for all platforms.
• Identity stitching: anonymous_id included in all event payloads.

0.0.1 - 2026-02-03

Added

• Initial release of Flux Flutter SDK.
• Core event tracking (track, identify, trackRevenue).
• Session management and automatic screen tracking.
• Offline persistence with automatic queue processing.
• Localization and hardware metrics gathering.