evently_plus 2.1.1

An independently maintained Flutter SDK for persistent event tracking and background-only analytics delivery.

Changelog

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

2.1.1 - 2026-08-05

• Updated the README for the published pub.dev package.
• Added pub.dev version, score, and API-documentation links.
• Corrected the changelog so features shipped in 2.1.0 are grouped with that release.
• Kept the SDK version reported in uploads and logs synchronized with the package version.

2.1.0 - 2026-08-05

• Added EventlyNavigatorObserver for foreground-visible screen-time tracking.
• Replaced the hard-coded /store upload path with a required, consumer-owned uploadEndpoint URI.
• Replaced Bearer-specific apiKey configuration with generic requestHeaders.
• Made the Android background-upload frequency configurable, with a one-hour default and 15-minute minimum.
• Removed the synthetic "1" fallback for missing session identifiers.
• Added migration for background configuration persisted by earlier local versions.
• Documented the HTTP upload contract and background credential-storage model.
• Added an hourly Workmanager task for uploading queued events in the background.
• Made event logging local-only; the Workmanager callback is the sole sender.
• Persist events so the background isolate can access the durable queue.
• Keep queued events until background delivery succeeds; no count-based eviction.
• Removed foreground batching, retry, flush, and HTTP-client APIs.
• Added Android and iOS background-upload setup and documentation.
• Released the independently maintained fork as evently_plus.

2.0.1 - 2026-01-08

🐛 Fixed

• Fixed pubspec.yaml repository URL mismatch to match the actual GitHub repository URL.

2.0.0 - 2026-01-08

🎉 Major Release - Complete Rewrite

This is a complete architectural rewrite of Evently with breaking changes.

✨ Added

Security

• Secure ID Generation - Used uuid (v4) for cryptographically secure event IDs

Architecture

• Clean Architecture implementation with clear separation of concerns
• Domain Layer with entities and repository interfaces
• Data Layer with models, datasources, and repository implementations
• Core Infrastructure with error handling, configuration, and logging

Features

• Automatic Event Batching - Configurable batch size and interval
• Offline Queue - Local storage for events when network is unavailable
• Retry Logic - Exponential backoff for failed network requests
• Error Handling - Custom exceptions and functional error handling with Either
• Structured Logging - Pluggable logger interface with console and silent implementations
• Configuration System - Comprehensive EventlyConfig with validation
• API Key Support - Optional authentication for server requests
• Environment Support - Track which environment events come from
• HTTP Client - Real HTTP implementation using http package
• Local Storage - Persistent offline queue using shared_preferences
• Type Safety - Strong typing throughout with immutable entities
• Input Validation - Automatic validation of events and configuration

Testing

• Comprehensive Test Suite covering all major components
• Mock Support using mocktail for unit testing
• Integration Tests for full event lifecycle

Documentation

• Complete README with quick start, configuration guide, and examples
• API Documentation with inline dartdocs
• Migration Guide from v1.x
• Example App demonstrating all features

🔄 Changed

• BREAKING: Evently() singleton replaced with EventlyClient
• BREAKING: Synchronous initialize() now async
• BREAKING: Configuration now uses EventlyConfig object
• BREAKING: logEvent() parameters changed to named parameters
• BREAKING: description parameter replaced with properties map
• BREAKING: Initialization now required before using SDK
• Enhanced error messages and error handling
• Improved performance with batching
• Better developer experience with clear APIs

🗑️ Removed

• BREAKING: Removed simple description field (use properties instead)
• BREAKING: Removed direct print() statements (use logger)
• BREAKING: Removed silent failures (now throws exceptions)

🔧 Technical Details

Dependencies Added

• dartz: ^0.10.1 - Functional programming utilities
• equatable: ^2.0.5 - Value equality
• http: ^1.2.0 - HTTP client
• shared_preferences: ^2.2.2 - Local storage
• mocktail: ^1.0.3 (dev) - Testing mocks

Version

• Updated from 0.1.0 to 2.0.0

0.1.0 - 2026-01-02

Initial Release

• Basic event tracking with logEvent()
• Simple initialization with server URL
• Console logging for debugging
• Singleton pattern for easy access
• MIT License

---