hive_box_manager 1.1.1

Type-safe, FP-style abstraction layers for Hive's boxes. Provides Managers for almost all conceivable use-cases and scenarios.

1.1.1 - 2026-08-28

Added

• UndecodableValueException, naming the key whose stored value failed to decode

Changed

• Bump Dart SDK to ^3.13

Fixed

• [#20] values and the dual queryBy* no longer fold one undecodable record into an opaque ParallelWaitError. They throw UndecodableValueException naming the key as your codec reports it, so the record can be deleted and compacted away. An eager box still cannot open over one at all: that is hive_ce decoding every value inside openBox, tracked in hive_ce#318 with a fix in hive_ce#321
• Eager whole-box reads name the key whose value failed to decode, rather than surfacing a bare cast error that says nothing about which record caused it
• Watch events name the key whose value failed to decode, rather than putting a bare cast error on the stream with no way to tell which record caused it

1.1.0 - 2026-07-27

Added

• [#17] Bring back putAllBy/putAllGrouped, the 0.0.x self-keying batch write

Changed

• BREAKING: renamed IterableBox to ListBox and LazyIterableBox to LazyListBox. Members, contracts, and on-disk frames are unchanged, so a find-and-replace on the two names is the entire migration. Iterable was a misnomer: the box takes and returns a List, hive rejects non-List iterables at write time, and the name would have made the planned SetBox look like a subtype rather than a sibling, with no room for Map at all.

Fixed

• [#13] Correct the DualKeyBox overhead figures and name their real cause
• [#14] Reduce DualKeyBox eager reads to near-native Hive speed

1.0.0 - 2026-07-22

Added

• KeyedBox and LazyKeyedBox: typed key/value boxes with ready-made get, put, update, delete, clear, and watch.
• SingleValueBox and LazySingleValueBox: single-slot boxes for one value (a token, one config blob, the theme), reading 0.0.x single-box data in place.
• IterableBox and LazyIterableBox: a typed list per key, reifying the element type at the read boundary so collections of custom types survive a restart.
• DualKeyBox and LazyDualKeyBox: two-part composite keys with folded reverse queries (queryByPrimary and queryBySecondary).
• Key-codec seam (KeyCodec and DualKeyCodec) with shipped IntKeyCodec, StringKeyCodec, StringCompositeDualCodec, and PackedIntDualCodec (bit-identical to the 0.0.x .bitShift keys, so those boxes read in place).
• BoxObserver and PrintingBoxObserver for per-instance semantic event observation, with typed TypedBoxEvent and LazyTypedBoxEvent watch events.
• Write-path key validation that rejects out-of-range int keys and oversized String keys with an ArgumentError, before hive can silently corrupt the box.

Changed

• Rewritten from scratch as an fpdart-first surface: reads return Option or TaskOption, writes and lifecycle effects return Task, acquisition encodes openness, and there is no null and no defaultValue. Breaking change from 0.0.x; see MIGRATION.md.
• Raised the Dart SDK floor to 3.12.0.
• Raised the hive_ce constraint to ^2.19.3.

Fixed

• watch() no longer crashes on delete: eager events carry the removed value and lazy events carry an Option, replacing the 0.0.x nullable-cast crash.
• Collections of custom types no longer leak dynamic or throw on the first read after a restart (hive_ce issue #150), via the IterableBox read-boundary reification.
• Lowered the meta lower bound to ^1.14.0 so Flutter apps resolve the package against the Flutter-pinned meta.

Removed

• Removed the entire 0.0.x API: BoxManager and LazyBoxManager, the SingleIndex and CollectionLazyBoxManager managers, the DualIntIndex and QueryDualIntIndex families, plus defaultValue, tryGet, getAll, storedIds, watchStream, and assignManagerLogCallback. See MIGRATION.md for the mapping to 1.0.
• Dropped collection from the runtime dependencies.

0.0.8 - 2026-07-05

Changed

• Loosen final classes for tesing mockability

0.0.7 - 2026-01-23

Added

• delete from disk
• some box based extensions

Changed

• Much better Readme

Removed

• delete from SingleBox

0.0.6 - 2025-11-26

Added

• expose watchable stream
• box.keys proxy for the managers

0.0.5 - 2025-11-07

Added

• forgotten putAll for eager box manager

0.0.4 - 2025-11-07

Added

• Add eager box variant for dual boxes

0.0.3+1 - 2025-11-06

Added

• Some missing clears from all box types

0.0.3 - 2025-11-04

Changed

• single place setter for LogCallback to reduce constructor boilerplate

0.0.2 - 2025-11-03

Added

• Query variant for retrieving by either of the indices

0.0.1 - 2025-11-03

Added

• Simple BoxManagers
• Single BoxManagers
• Collection BoxManagers
• (Lazy) Dual Int Index LazyBoxManager