Changelog of @hackage/shared-resource-cache 0.2.0.3

Changelog for `shared-resource-cache`

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 the Haskell Package Versioning Policy.

Fixed a bug where an exception thrown by the onRemove callback in the broom sweep loop would take down the background sweep thread. Exceptions from onRemove are now caught and silently discarded.

SharedResourceCache is now parameterised over the key type (key) rather than being fixed to Text, allowing any Hashable key type to be used.
Type parameters of SharedResourceCache reordered and renamed: was SharedResourceCache err a, now SharedResourceCache key value err.
All public functions that accept or return a resource ID now use the generic key type instead of Text.

Fixed a resource leak where an async exception delivered during handleSharerLeave (between getCurrentTime and the atomically call, or during the atomically if it blocks) could leave a cache entry's sharer count permanently elevated, preventing eviction. handleSharerLeave is now wrapped in uninterruptibleMask_.

Fixed a bug where an async exception delivered after loadIntoCache returned (but before signalCacheLoaded executed) would leave waiting threads permanently blocked on the semaphore MVar. The signalCacheLoaded call is now inside uninterruptibleMask_ alongside adjustCacheEntryOnLoadError, ensuring the semaphore is always signalled regardless of async exceptions.

Fixed a resource leak where an async exception delivered to the loading thread after a successful putIntoCache STM commit could leave a cache entry with its sharer count permanently stuck at 1, preventing eviction. The entry is now correctly decremented (and scheduled for eviction if no other sharers remain) via adjustCacheEntryOnLoadError.

Initial release
makeGlobalResourceCache for caches that live for the lifetime of the program
makeResourceCache for caches with a scoped lifetime managed via resourcet
getCacheableResource to retrieve (and load if necessary) a cached resource
withCacheableResource as a convenience wrapper around getCacheableResource
peekCacheableResource to retrieve a cached resource without loading it if absent
withPeekCacheableResource to peek at a cached resource within an STM transaction
Background sweep thread to periodically evict expired, unused cache entries
Reference counting via STM to track active sharers of each cached resource