seenn_flutter 0.5.0

Flutter SDK for Seenn - Real-time job progress tracking with SSE, Polling (self-hosted), and Live Activity support.

Changelog

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

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.4.1 - 2026-01-28

Fixed

• Critical: Push token race condition - tokens arriving before Dart listener was ready were silently dropped
• Added token buffering: tokens received before EventChannel.listen() are now queued and emitted when listener connects

0.4.0 - 2026-01-28

Changed

• BREAKING: Live Activity now requires bridge registration
• Removed internal SeennJobAttributes to fix "ActivityInput error 0" iOS module isolation bug
• Added SeennLiveActivityBridge protocol for app-level implementation
• Added SeennLiveActivityRegistry for bridge registration

Added

• isBridgeRegistered() method in LiveActivityService
• LiveActivityResult.bridgeNotRegistered() error type
• Bridge implementation template in example app

Migration

Users must now:

1. Copy SeennLiveActivityBridgeImpl.swift to their app
2. Copy SeennJobAttributes.swift to both app and Widget Extension targets
3. Register bridge in AppDelegate: SeennLiveActivityRegistry.shared.register(SeennLiveActivityBridgeImpl.shared)
4. See docs: https://docs.seenn.io/client/flutter#live-activity-setup

0.3.0 - 2026-01-24

Added

• Polling Mode - Alternative to SSE for self-hosted backends
  • ConnectionMode enum: .sse (default) or .polling
  • PollingService for REST-based job polling
  • SeennConfig.selfHosted() factory for easy setup
  • subscribeJob(), subscribeJobs(), unsubscribeJob() methods
  • Configurable pollInterval (default: 5 seconds)
  • Auto-unsubscribe from terminal jobs

Changed

• SeennConfig now includes mode, pollInterval, initialJobIds
• SDK version bumped to 0.3.0

0.2.0 - 2026-01-24

Added

• Android Ongoing Notification - Persistent notification with progress bar
  • OngoingNotificationService for direct Android control
  • JobNotificationService for unified cross-platform API
• ETA Countdown - Real-time countdown with server sync
  • EtaCountdownService with formatted output
  • etaCountdownStream() convenience function
• Parent-Child Jobs - Hierarchical job relationships
  • ParentInfo, ChildrenStats, ChildJobSummary models
  • childrenOf(), parents, children in JobsService
• New Job Fields - Full @seenn/types alignment
  • jobType, workflowId, estimatedCompletionAt
  • etaConfidence, etaBasedOn, childProgressMode
  • parent, children, startedAt
• JobTracker Enhancements
  • onCancelled stream
  • onChildProgress stream for parent jobs

Changed

• StageInfo fields: name, current, total, description
• QueueInfo added queueName field
• JobStatus added cancelled status

Deprecated

• StageInfo.id → use name
• StageInfo.label → use name
• StageInfo.index → use current

0.1.0 - 2026-01-22

Added

• Initial release
• SSE connection with auto-reconnect
• iOS Live Activity support
• Job state management with RxDart
• JobsService with reactive streams
• LiveActivityService for iOS