• 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.

• 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.

• 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.

• 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.

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

• 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.

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

• 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.

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

• 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.

• 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.

• 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.

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.

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.

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.

Fixed #

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

Changed #

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

Changed #

• Minor metadata updates and documentation refinement for public release.

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.

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.