devfeedbackhub_analytics 3.0.0

devfeedbackhub_analytics: ^3.0.0 copied to clipboard

Fixed #

• Device identity (critical). 2.0.0 generated a fresh random UUID as the device id on every launch, so the server could never match the tester (users.device_id) and no goal completion or credit reward could ever fire. The SDK now resolves Settings.Secure.ANDROID_ID - the same value the DevFeedbackHub app stores - and persists a stable UUID fallback when it is unavailable.
• Authorization. Requests carried no auth header, so the track-analytics endpoint rejected every call with 401 UNAUTHORIZED_NO_AUTH_HEADER. The project's public anon key is now sent as apikey / Authorization.
• Unbounded retry queue. Permanently failing responses (400/401/403/404/422) were re-queued forever, growing memory on every flush. They are now dropped; only transient failures (429/5xx/network) are retried, with exponential backoff capped at 5 minutes, and the queue is bounded at 200 events.
• dispose() now clears the pending queue.

Changed #

• BREAKING: requires Flutter. Reading ANDROID_ID needs a platform plugin, so the package depends on flutter, android_id and shared_preferences again (as in 1.x). Pure-Dart projects can no longer depend on this package.
• BREAKING: debug now defaults to kDebugMode instead of true, so release builds stay quiet. Pass debug: true to force logging.
• Logging uses debugPrint instead of print.

Added #

• DFHAnalytics.isInitialized and DFHAnalytics.deviceId getters.
• Debug log noting tester_matched: false, the usual cause of "no credits".

• Add recurring goal tracking support (onRecurringProgress callback)
• Add RecurringProgressItem model for daily progress data
• Event batching (5s interval, 20 max batch)
• Auto-retry on network failure
• Improved debug logging with recurring progress details

Note (added retroactively): 2.0.0 contained two defects that made the SDK non-functional end to end - a randomized device id and a missing auth header. It also removed DFHNotificationConfig, DFHPosition and the showNotification / notificationConfig / messengerKey parameters of init() without a migration note, and changed track() from Future<bool> to void. Upgrade to 3.0.0.

• Initial release
• DFHAnalytics.init() - Initialize with request ID
• DFHAnalytics.track() - Track events
• One-time goal completion callbacks
• Auto device ID generation
• Debug logging support