zenify 1.9.0

Powerful asynchronous state management, automatic caching, hierarchical DI, and zero-boilerplate reactivity. A holistic architecture for modern Flutter apps.

1.9.0

Added

• tags parameter on ZenQuery for group-based cache management
• ZenQueryCache.invalidateQueriesByTag(tag) and refetchQueriesByTag(tag)
• ZenQueryCache.invalidateQueriesByPattern(pattern) and refetchQueriesByPattern(pattern) — supports glob-style * wildcards
• ZenQueryCache.getQueriesByTag(tag) and getKeysByTag(tag) for tag inspection
• InMemoryStorage — a built-in zero-dependency ZenStorage adapter for testing and ephemeral storage
• Warning log when a wildcard pattern matches all queries (e.g. '*')

---

1.8.0

Breaking Changes

• Removed ZenInspectorOverlay widget. Remove the wrapper from your app — Zen.init(registerDevTools: true) continues to work as before.

// Before
runApp(ZenInspectorOverlay(child: MyApp()));

// After
runApp(MyApp()); // DevTools integration unchanged

Changed

• DevTools UI moved to a separate optional package: zenify_devtools_extension
• Core package is ~25MB smaller as a result

---

1.7.0

Added

• Flutter DevTools extension with 3-tab inspector: Scope Inspector, Query Cache Viewer, Metrics Dashboard
• ZenServiceExtensions class for VM Service Protocol integration
• Automatic service extension registration via Zen.init(registerDevTools: true) in debug builds
• Zero performance impact in release builds

---

1.6.6

Added

• ZenException base class with compact (default) and verbose (ZenConfig.verboseErrors = true) error formatting
• Specific exception types: ZenDependencyNotFoundException, ZenCircularDependencyException, ZenDisposedScopeException, ZenScopeNotFoundException, ZenControllerNotFoundException, ZenControllerDisposedException, ZenOfflineException, ZenQueryException, ZenMutationException, ZenModuleException, ZenLifecycleException, ZenRouteException
• ZenLogger.logException(e) for formatted exception output
• ZenConfig.verboseErrors toggle

---

1.6.5

Added

• "Pending Mutations" card in DevTools Stats View
• ZenMutationQueue.pendingCount and pendingJobs for debugging
• Visual offline queue status indicator in DevTools

---

1.6.4

Added

• ZenObserver — alias for Obx widget
• scope.get<T>() — alias for scope.find<T>()
• scope.remove<T>() — alias for scope.delete<T>()
• scope.has<T>() — alias for scope.exists<T>()

---

1.6.3

Added

• Zen.get<T>() — alias for Zen.find<T>()
• Zen.remove<T>() — alias for Zen.delete<T>()
• Zen.has<T>() — alias for Zen.exists<T>()
• Zen.queryCache — shorthand for ZenQueryCache.instance

---

1.6.2

Breaking Changes

• OptimisticMutation renamed to ZenMutation (helpers are now static methods)
• listAdd → listPut, listUpdate → listSet, add → put, update → set

// Before
OptimisticMutation.listAdd<Post>(queryKey: 'posts', mutationKey: 'create', mutationFn: ...)

// After
ZenMutation.listPut<Post>(queryKey: 'posts', mutationFn: ...) // mutationKey auto-generated

Changed

• mutationKey is now optional; auto-generated from queryKey if omitted

---

1.6.1

Added

• ZenMutation.listPut<T>, listSet<T>, listRemove<T> — optimistic list helpers with automatic rollback
• ZenMutation.put<T>, set<T>, remove() — optimistic single-value helpers

---

1.6.0

Added

• ZenStorage interface for pluggable persistence backends (SharedPreferences, Hive, SQLite, etc.)
• Auto-hydration: queries load cached data from storage on startup
• Offline mutation queue: mutations triggered while offline are queued and replayed on reconnect
• ZenQueryCache.setQueryData() for function-based optimistic cache updates
• NetworkMode enum: online, offlineFirst, always
• example/zen_offline — full offline-first example app

---

1.5.0

Breaking Changes

• refetchOnMount, refetchOnFocus, refetchOnReconnect changed from bool to RefetchBehavior enum

// Before
ZenQueryConfig(refetchOnMount: true)

// After
ZenQueryConfig(refetchOnMount: RefetchBehavior.ifStale)
// New option: RefetchBehavior.always — force refetch regardless of staleness

Added

• RefetchBehavior.always for real-time/critical data use cases
• ZenQueryConfig.retryDelayFn — custom function for error-aware retry delays

---

1.4.4

Fixed

• ZenInspectorOverlay crashes when used without a Scaffold — replaced ScaffoldMessenger with internal toast system
• Layout overflows and data preview scrolling in inspector

---

1.4.3

Fixed

• invalidate() now automatically refetches active queries (previously only marked stale)

---

1.4.2

Changed

• Removed unnecessary type parameter from ZenQueryClient.getQueryDefaults()

---

1.4.1

Added

• ZenQueryClient and ZenQueryClientOptions for managing global query defaults
• ZenQueryConfig.copyWith() for partial config overrides

---

1.4.0

Added

• pause() and resume() methods on ZenQuery and ZenStreamQuery
• ZenQueryConfig.autoPauseOnBackground and refetchOnResume
• ZenQueryCache.getAllQueries() for lifecycle management
• Exponential backoff: maxRetryDelay, retryBackoffMultiplier, retryWithJitter

Breaking Changes

• ZenStreamQuery now defaults to autoPauseOnBackground: false (was true in 1.3.x)

// To restore previous behavior
ZenStreamQuery(config: ZenQueryConfig(autoPauseOnBackground: true))

---

1.3.6

Fixed

• Zen.reset() no longer requires testWidgets() — works in plain test() blocks
• ZenLifecycleManager handles missing WidgetsBinding in test environments gracefully

---

1.3.5

Changed

• Restructured README and documentation for clarity
• Added doc/real_world_patterns.md

---

1.3.4

Changed

• Fixed createController syntax in all documentation
• Rewrote state_management_patterns.md with clearer examples

---

1.3.3

Fixed

• 1-pixel RenderFlex overflow in ZenInspectorOverlay on iOS/Android with no dependencies
• Improved overlay positioning with explicit Positioned.fill

---

1.3.2

Added

• ZenInspectorOverlay — in-app debug overlay with real-time scope hierarchy, query cache, and performance stats

---

1.3.1

Added

• Automatic query tracking: queries created in onInit() are automatically disposed when the controller closes — no onClose() boilerplate required

---

1.3.0

Changed

• Internal architecture refactoring: replaced ZenScopeManager (541 lines) and ZenScopeStackTracker with a single Zen.currentScope navigation bridge (~80% reduction in scope management code)
• ZenRoute reduced from 526 to 336 lines

Added

• parentScope parameter on ZenRoute for explicit scope control

Breaking Changes

• None. All public APIs unchanged.

---

1.2.3

Fixed

• ZenStreamQuery now pauses on inactive and hidden app states (web tab switching)
• Lifecycle events (onPause, onResume) now fire correctly when query is not registered in DI

---

1.2.2

Changed

• Expanded zen_query example app with additional features

---

1.2.1

Added

• ZenInfiniteQuery.getPreviousPageParam() and fetchPreviousPage() for bidirectional pagination
• hasPreviousPage and isFetchingPreviousPage reactive properties
• Call-time callbacks on mutate(): onSuccess, onError, onSettled
• placeholderData in ZenQueryConfig — temporary initial data that doesn't persist to cache
• keepPreviousData on ZenQueryBuilder and ZenStreamQueryBuilder to prevent flash-of-loading on key changes

---

1.2.0

Added

• ZenStreamQuery — reactive wrapper for Stream<T> with lifecycle management and optimistic updates
• ZenStreamQueryBuilder widget

Changed

• Folder restructure: builders moved to lib/widgets/builders/, query internals to lib/query/core|logic|extensions/
• import 'package:zenify/zenify.dart' is unaffected

---

1.1.9

Added

• ZenStorage interface (foundation for 1.6.0 offline engine)
• persist, fromJson, toJson, storage options on ZenQueryConfig
• Auto-hydration from storage on query initialization

---

1.1.8

Breaking Changes

• Fetcher signature now requires a ZenCancelToken parameter

// Before
fetcher: () => api.getData()

// After
fetcher: (_) => api.getData()

Added

• ZenCancelToken for platform-agnostic request cancellation
• Automatic cancel on dispose and on re-trigger (prevents stale data race conditions)

---

1.1.7

Added

• Smart refetching: stale queries auto-refetch on app resume and network reconnect
• ZenQueryConfig.refetchOnFocus and refetchOnReconnect
• Zen.setNetworkStream() for connectivity integration

Changed

• App lifecycle observation centralized to ZenLifecycleManager (single observer)

---

1.1.6

Added

• enabled parameter and RxBool enabled property on ZenQuery for dependent queries
• ZenQueryCache.instance.prefetch() for pre-loading data without creating listeners

---

1.1.5

Added

• ZenQuery.select() — derived queries that only update when specific data changes

---

1.1.4

Added

• ZenInfiniteQuery for paginated lists and infinite scrolling
• queryKey now accepts Object (including List) in addition to String

---

1.1.3

Added

• ZenMutation for reactive write operations (create, update, delete)
• Lifecycle hooks: onMutate, onSuccess, onError, onSettled
• ZenQueryCache.invalidateQuery() integration pattern

---

1.1.2

Added

• ZenScopeQueryExtension: scope.putQuery<T>() and scope.putCachedQuery<T>()

---

1.1.1

Added

• scope parameter on ZenQuery for automatic disposal with scope lifecycle
• ZenQueryCache.invalidateScope(), refetchScope(), clearScope(), getScopeQueries(), getScopeStats()

---

1.1.0

Added

• ZenQuery — async state management with caching, deduplication, retries, and background refetch
• ZenQueryBuilder — reactive widget with loading/error/success states and SWR pattern
• ZenQueryCache — global cache manager with invalidation and memory management

---

1.0.1

Added

• doc/testing_guide.md

Changed

• Removed Zen.putFactory() — use Zen.putLazy(..., alwaysNew: true) instead
• Route and controller lifecycle events now use logInfo() level

Fixed

• ZenScope.put() default parameter handling
• Factory cleanup logic in scope disposal

---

1.0.0

Breaking Changes

• EagerRef, LazyRef, ControllerRef, ZenRef replaced by a single Ref<T>
• .put(), .asRef(), .register() extension methods removed — use Zen.put()
• Zen.putFactory() removed — use Zen.putLazy(..., isPermanent: false)
• Debug methods moved to ZenDebug class: ZenDebug.dumpScopes() etc.

Added

• Ref<T> universal reference with call() shorthand
• Improved ZenBuilder with proper DI cleanup and ownership tracking

---

0.6.3

Added

• ZenEnvironment.productionVerbose environment preset
• ZenConfig.shouldLogRoutes and shouldLogNavigation helpers

---

0.6.2

Fixed

• Inverted logic in shouldLog() causing logs to appear when suppressed
• Rx tracking logs now respect ZenConfig.enableRxTracking

---

0.6.1

Breaking Changes

• enableDebugLogs replaced by ZenLogLevel enum: none, error, warning, info, debug, trace

Added

• ZenEnvironment enum for type-safe environment configuration: production, staging, development, debug, trace, test

---

0.6.0

Breaking Changes

• ZenController.onDispose() → onClose()
• ZenService.onDelete() → onClose()
• ZenScope.put() parameter permanent → isPermanent

Added

• Automatic ZenService disposal when its scope disposes

---

0.5.5

Added

• ZenService base class with onInit and onClose lifecycle hooks

---

0.5.4

Changed

• Updated pub.dev example application

---

0.5.3

Fixed

• Linting, formatting, and analysis issues for pub.dev score compliance

---

0.5.2

Changed

• Updated package topics for better pub.dev discoverability

---

0.5.1

Fixed

• Deprecated RadioListTile API usage — migrated to RadioGroup widget

---

0.5.0

Initial pub.dev release.

---

0.4.1

Changed

• README and package metadata improvements for pub.dev

Fixed

• const keyword consistency across codebase
• Documentation path corrections (docs/ → doc/)

---

0.4.0

Breaking Changes

• ZenModulePage renamed to ZenRoute

Added

• ZenModule base class and comprehensive module system
• ZenRoute widget for module-based dependency injection
• ZenConsumer widget for dependency access without rebuild
• Stack-based scope tracking and automatic lifecycle management

---

0.3.0

Added

• RxResult<T> for success/failure error handling patterns
• RxComputed for automatic dependency tracking
• RxFuture for reactive async operations
• Circuit breaker pattern for resilient reactive operations
• Batch operations and bulk updates for collections

---

0.2.0

Added

• ZenConsumer widget with automatic caching

---

0.1.9

Added

• Memory leak detection test suite
• Dependency resolution benchmark suite

---

0.1.8

Added

• ZenView base class for automatic controller management in pages

---

0.1.7

Changed

• lookup renamed to find

Added

• findOrNull() for non-throwing dependency lookup
• EagerRef and LazyRef reference types

---

0.1.6

Added

• ZenLogger system with debug, warning, error levels
• Comprehensive DI test suite

---

0.1.5

Added

• Hierarchical scope system
• Circular dependency detection
• Module/binding system for organized registration
• Lazy initialization support

---

0.1.4

Added

• Generic type constraints on RxList<E>, RxMap<K,V>, RxSet<E>
• ControllerRef<T> typed provider references

---

0.1.3

Added

• ZenEffect for async operations with loading states
• Worker compatibility improvements

---

0.1.2

Fixed

• Minimum Dart SDK updated to 2.19.0
• Deprecated IndexError usage
• Collection type safety in RxList, RxMap, RxSet

---

0.1.1

Initial release — reactive state, controller lifecycle management, route-based disposal.