flux_analytics_sdk 0.1.28

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.28 - 2026-03-10

• Migration: Complete transition from Supabase to AWS Tracking infrastructure.
• Header Update: Switched from apikey / Authorization to x-api-key for AWS API Gateway compliance.
• Cleanup: Removed Supabase-specific Prefer headers and on_conflict query parameters.
• Improved Alignment: Ensured data ingestion paths match new AWS Lambda endpoints.

0.1.27 - 2026-02-18

• Feature: Significant documentation expansion with detailed usage scenarios.
• Consistency: Aligned all parameter names and examples across SDK platforms.

0.1.26 - 2026-02-18

• Fix: Renamed extraMetadata parameter to metadata in trackMetric for consistency with JS SDK and documentation.

0.1.25 - 2026-02-18

• Feature: Added trackMetric helper method for easier integration with Advanced Metric Analysis.
• Documentation: Major overhaul of README.md with detailed examples and best practices.
• Maintenance: Version bump for release synchronization.

0.1.24 - 2026-02-18

• Maintenance: Final release synchronization and documentation update.

0.1.23 - 2026-02-18

• Maintenance: Final code cleanup and release synchronization.

0.1.22 - 2026-02-18

• Fix: Resolved internal type mismatches in _sendToBackend method.
• Maintenance: Cleaned up code for a warning-free publication.

0.1.21 - 2026-02-18

• Fix: Resolved "stuck queue" issue where old events missing an id field blocked all subsequent ingestion.
• Robustness: SDK now automatically fixes missing id fields for old events and discards "poisoned" payloads (HTTP 4xx errors) to prevent queue blocking.

0.1.20 - 2026-02-18

• Documentation: Comprehensive overhaul of README.md with detailed instructions on all SDK features.
• Maintenance: Version bump for release synchronization and documentation updates.

0.1.14 - 2026-02-07

• UUID Validation: Added strict UUID validation for firmId and appId in init() to ensure compatibility with PostgreSQL UUID columns.
• Latency Tracking: Implemented automatic latency measurement for session_start, app_install, and first_open events.
• Database Compatibility: Ensured full compatibility with UUID-based database schema (all tables now use UUID for firm_id and app_id).
• Error Messages: Improved error messages with clear examples for UUID format requirements.

0.1.13 - 2026-02-06

• Fix: Removed on_conflict requirement for installs endpoint to avoid PostgREST constraint recognition issues.
• Robustness: SDK now treats HTTP 409 (Conflict/Duplicate) as success, ensuring queue never gets stuck on duplicate entries.
• Reliability: Improved graceful handling of database constraint variations.

0.1.12 - 2026-02-06

• Robustness: Implemented on_conflict handling for all data ingestion endpoints (events, installs, sessions). This prevents the queue from getting stuck on 409 Conflict errors during network retries.
• Reliability: Improved "at-least-once" delivery guarantee by ensuring duplicate events are gracefully ignored by the backend.

0.1.11 - 2026-02-06

• Schema Alignment: Updated sessions and installs data mapping to ensure compatibility with the latest dashboard analytics features.
• Bug Fix: Resolved ingestion issues caused by missing database columns.
• Documentation: Added SQL migration guides for self-hosted or custom Supabase setups.

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.