Mediator Releases

vNext - TBD

Enhancement

NEW MAUI Event collector now watches application events to collect MAUI pages. This allows for better management of nested pages and events

Enhancement

ConnectivityBroadcaster now uses a technique similar to new MAUI event collector to find event handlers

Fix

HTTP source generator will now use double instead of int when number format is not set

Enhancement

Improvements to how diagnostic activities are created and managed through the pipeline - Sentry is now deprecated because of this. Use Sentry.DiagnosticSource to hook into standard diagnostics

BREAKING Enhancement

Handler registration in source generator will now use ShinyMediatorBuilder so it can be used inside of Add

BREAKING Enhancement

HTTP timeout is now set via configuration and has been removed from attribute

4.2.2 - May 23, 2025

Enhancement

Source generator target name now uses a more specific name to not conflict with other libraries

Enhancement

Bump Uno to v6

4.2.1 - May 8, 2025

Fix

Exception handlers were meant to be optional - Mediator will now properly manage exception handler optionally and ensure they aren’t pinned in scope which causes an error for Microsoft Extensions DI

4.2.0 - April 25, 2025

Feature

[GitHub #25] by codelisk

Prism Region Event Collector

Enhancement

[GitHub #27] by JeremyBP

MAUI Event collector will iterate the page modal stack

Enhancement

ASPNET extension now offers a ValidationJsonExceptionHandler which takes a middleware exception and translates it back to the client

Enhancement

Sentry extension will no longer attempt to do transactions if Sentry is not active in dependency injection (due to debug mode or code flags of some sort)

Fix

[GitHub #30]

MSFT memorycache extension was not committing Set values properly (only seen during force cache refresh)

Fix

[GitHub #28] by codelisk

Fix timer refresh stream middleware when no header is present in mediator context

Fix

Timer refresh stream middleware using proper timespan value and ensuring cancellation on timer

Fix

Timer refresh stream middleware will now fire the initial request immediately instead of imposing a wait

Fix

Command scheduling when header is not present in command scheduling

BREAKING Chore

Command scheduler does not need to validate due date - middleware already handles it

Enhancement

Timer refresh now has lots of debug logging to help users detect issues

4.1.0 - March 28, 2025

Fix

Cache configuration values not checked properly in middleware

BREAKING Enhancement

ICacheControl has been removed as it polluted the contract model AND could reset cache values used by other calls to that cached value

Enhancement

IMediatorContext.ForceCacheRefresh and SetCacheConfig are now proper extension methods off IMediatorContext

Enhancement

ICacheService.Set now returns the CacheEntry

Fix

ForceCacheRefresh now returns cache information

4.0.4 - March 24, 2025

Fix

[GitHub #22] by codelisk

Caching middleware not returning value

Fix

Fixed Microsoft Extensions MemoryCache extension method ‘GetEntries’ to work on NET9

4.0.3 - March 23, 2025

Fix

CachingRequestMiddleware throws NullReferenceException

>

Fix

Ensure cache expiration or hit on StorageCacheService

Enhancement

HTTP handling now uses proper logging templates

Enhancement

Adding Mediator:Http:Debug = true to your configuration allows mediator HTTP request to log out all of the HTTP request & responses

4.0.2 - March 14, 2025

Fix

If deserialization in file store fails for any reason, return default

Fix

Remove unnecessary library from Dapper extension

Fix

Proper generic constraint added to RequestMiddleware

Fix

InMemoryCommandScheduler now bypasses middleware and exception handling

Chore

Move to SLNX

Chore

Move to centralized nuget packages

4.0.1 - March 5, 2025

Enhancement

IHttpRequestDecorator now takes in an IMediatorContext argument

4.0.0 - March 4, 2025

Feature

ICommandExecuter, IEventExecutor, IStreamRequestExecutor, and IRequestExecutor all added behind mediator to allow more plug points for things like Sentry to watch scope

BREAKING Enhancement

IMediator.Request now returns a tuple with context and result instead of having a separate extension

BREAKING Enhancement

RequestContext, EventContext, CommandContext, and EventAggregatedContext are now all MediatorContext. (I)MediatorContext has ChildContexts to replace EventAggregatedContext

BREAKING Enhancement

BypassMiddleware & BypassExceptionHandling is now built directly into the mediator context

BREAKING Enhancement

You no longer pass headers to mediator calls, there is a callback that provides an IMediatorContext where you can setup all the necessary headers directly

Enhancement

MediatorContext now has an activity source for providing telemetry through handlers and middleware

Enhancement

MAUI connectivity broadcaster now watches for pages (and their binding context) appearing to see if it should receive connectivity event as well as sending last event value immediately

Fix

Stream Requests now have their service scope properly disposed even if an error occurs during enumeration

BREAKING Chore

MediatorContext Values is now called Headers

BREAKING Chore

ShinyConfigurator is now called ShinyMediatorBuilder

Enhancement

Ability to skip source generation using

<PropertyGroup>
  <ShinyMediatorSkipGenerate>true</ShinyMediatorSkipGenerate>
</PropertyGroup>

3.3.1 - February 20, 2025

Feature

Uno Platform Integration

Feature

Sentry Integration

Enhancement

Ability to bypass middleware using headers - mediator.Send(…, cancelToken, Headers.BypassMiddleware)

Enhancement

Ability to bypass error traps using Headers.BypassExceptionHandling - all Shiny Mediator middleware that error trap will respect this header

Enhancement

Performance middleware uses the better, allocation free version of the Stopwatch

BREAKING Fix

Offline and persistent cache could collide if the same type used both

Fix

[GitHub #16] by ss-lordjay

HTTP post bodies do not serialize property

Chore

Remove Sourcelink as it is built in now

3.2.0 - January 30, 2025

Feature

Global Exception Handling via new IExceptionHandler

Enhancement

User error notification now works on global exception handling

MAUI

Feature

ConnectivityBroadcaster allows your services to take IEventHandler<ConnectivityChanged> to have your services listen to one central location of connectivity change events

3.1.2 - January 28, 2025

Fix

Event handlers were not getting their sent headers set in the event context

Fix

Removed cancellation token from event context to prevent misuse

Fix

RequestContext property RequestHandler has been renamed to Handler to be consistent with other context objects

Fix

Ensure only one cache service can be installed

App Support

Enhancement

Internet service now has an event to monitor connectivity

MAUI

Enhancement

Support Multi-Window MAUI apps in event collector

Enhancement

AlertDialogService now looks at Windows like event collector

Fix

MauiHttpRequestDecorator safeties geolocation header appending and improves configuration

Prism

Enhancement

Add PrismNavigationCommand & PrismNavigationRecord bases to inherit

3.1.0 - January 25, 2025

Core

Enhancement

Ability to control timer refresh through header arguments

Enhancement

You can now force cache refreshing through Request(contract, cancel token, CacheExtensions.ForceCacheRefreshHeader)

Enhancement

Ability to set cache arguments through header arguments

Enhancement

Commands can now be scheduled through headers

Dapper Extension

Enhancement

Dapper requests now have requests keys built-in to their request objects

Enhancement

Dapper requests now accept transactions and command types

3.0.0 - January 24, 2025

Feature

New Dapper Extension that allows you to easily (and smartly) use Dapper with InterpolatedSql in a smart way that allows you to take advantage of all the mediator middleware. This further allows you to make the middleware act as a SQL interceptor as well.

BREAKING Feature

Commands replace Requests and also have their own pipeline

Feature

Command Scheduling with basic in-memory scheduler

Feature

Ability to send headers to a mediator command/request/stream that is added to the context

Enhancement

ReplayStreamMiddleware now sets values on the context as it passes each layer

BREAKING Enhancement

AddShinyMediator now has a flag to allow you to remove all of the default middleware (defaults to true)

Enhancement

Timeout support for HTTP handler

Enhancement

Full logging in HTTP handler to debug your requests

Enhancement

Replay middleware will not try to return handler result when timeout detection (removes downstream crash)

Enhancement

Caching setup is now in the base Shiny.Mediator allowing for easier caching extension

Enhancement

Shiny.Mediator.AppSupport has a ‘Persistent Cache’ that survives app restarts - Works great for offline scenarios too

Enhancement

Replay will now optional grab cache if available first and ONLY then will it fall back to online

Enhancement

ASP.NET extensions now include MapMediatorPost extension methods of the IEndpointRouteBuilder to work well with minimal APIs

BREAKING Enhancement

EventContext is passed to event handlers as well as middleware

BREAKING Enhancement

Command and Request contexts are now available at the handlers

BREAKING Enhancement

Stream request handlers now bring in request contexts

Fix

Offline middleware returns offline result when TimeoutException is thrown by internal middleware or handler

Chore

Shiny.Mediator.Caching is deprecated and replaced by Shiny.Mediator.Caching.MicrosoftMemoryCache

BREAKING Chore

ExecutionContext has been renamed to RequestContext

BREAKING Chore

EventExecutionContext is now called EventContext

2.1.1 - Oct 30, 2024

Enhancement

More Prism navigation contract control

2.1.0 - Oct 19, 2024

Enhancement

Reducing some infrastructure reflection as we work towards a potential AOT compliant library

Enhancement

Downgrading source generator libraries to work with older net8 SDKs

Enhancement

OpenAPI generator now factors in TimeSpans

Enhancement

Serializer service now exists in the main library with optional configuration

Enhancement

IMediator Publish now allows you to setup publish in parallel or sequential

Fix

HttpRequestHandler will use serializer service

2.0.3 - Oct 7, 2024

Enhancement

Easy extensions methods for AddShinyMediator for the MauiAppBuilder and WebAssemblyHostBuilder

2.0.2 - Oct 6, 2024

Fix

ASPNET extension was not generating the proper result type for POST & PUT

2.0.1 - Oct 6, 2024

Fix

OpenApiGenerator was not returning subtypes from string

Enhancement

ASPNET OperationId is not enforced through the attribute constructor

Chore

Improved source generator logging

2.0.0 - Oct 4, 2024

Feature

Most middleware and internal handlers now support configuration via Microsoft.Extensions.Configuration vs using attributes - HTTP, Timer Refresh, Offline, Stream Replay, Performance Logging, Caching, User Notifications

Feature

Blazor now supports offline, stream replay, and user notification middleware

Feature

ExecutionContext allows you to add metadata from middleware that can be consumed by the caller (IMediator.RequestWithContext return ExecutionResult, Send now returns ExecutionContext)

Feature

EventAggregatedExecutionContext(List of EventExecutionContext) allows you to add metadata from middleware that can be consumed by the caller - IMediator.Publish now returns this by default

Enhancement

OpenApiGenerator now allows DateOnly, TimeOnly, and Stream results

Enhancement

OpenApiGenerator offers better support for inline enums and subtypes (node based APIs)

Enhancement

Improved logging, so you can see your pipeline execution pipeline front to back

Enhancement

Request Handlers that return a result that is marked with IEvent will now publish it automatically

Enhancement

Stream Replay will now also wait for internet connectivity before pumping a new data request

Fix

OpenApiGenerator now tacks on global namespace to all object types

Fix

Registration source generator did not default the library namespace

Fix

[GitHub #11] by osyyyS

Shell and NRE fixes for MAUI Event Collector

Fix

OpenApiGenerator returns INT by default when no format is supplied

BREAKING Chore

IRequestMiddleware and IStreamRequestMiddleware signature changed to support ExecutionContext and reduce argument count

BREAKING Chore

Contract feature attributes have been removed for ReplayStream, Cache, Resilience, & Offline

BREAKING Chore

ReplayStream and Offline are only across sessions now

BREAKING Chore

TimedLoggingRequestMiddleware has been renamed to PerformanceLoggingMiddleware (including registration extensions)

BREAKING Chore

TimedLoggingAttribute has been removed in favour of ONLY using configuration going forward

BREAKING Chore

UserNotifyAttribute has been removed in favour of ONLY using configuration going forward

1.8.1 - September 14, 2024

Fix

OpenApiGenerator was not writing return results if they were arrays

1.8.0 - September 11, 2024

Feature

New HTTP Request Handler and framework

Feature

New HTTP Request OpenAPI source generator

Enhancement

ICacheControl is now available for contracts that allows more direct control over your cached calls

Fix

OfflineAvailableAttribute was not allowed to be applied to contracts

1.7.4 - August 9, 2024

Fix

Fix implicit namespace usage

1.7.3 - August 7, 2024

Fix

Source generators were not generating scoped handlers

Enhancement

aspnet HttpGet and HttpDelete is now supported. Contracts are mapped using [AsParamters]

1.7.2 - July 28, 2024

Enhancement

IRequestKey now has default interface implement to use ReflectKey

Enhancement

Minor timestampedresult signature improvement

1.7.1 - July 28, 2024

Enhancement

Attributes for offline, caches, etc can now be applied on the request contract AND/OR the request handlers

Enhancement

IRequestKey.ReflectKey looks through all public, instance, getters that are not null into part of the key

Enhancement

Logging is now built into the core mediator library

Enhancement

Request pipeline now has logging built-in

Enhancement

ExceptionHandlerEventMiddleware & TimedLoggingRequestMiddleware moved from MAUI to main library

1.7.0 - July 20, 2024

Feature

New contract validation middleware using data annotations or fluentvalidation

Enhancement

Add new contract TimestampedResult generic to help with timestamps of when a cache or offline bundle is from

1.6.0 - July 7, 2024

Enhancement

Refresh timer middleware is now installed by default

Enhancement

Add Name to HTTP attribute in ASP.NET extension

Enhancement

Streaming AsyncEnumerables now mapped by ASP.NET extension

More MemoryCache extensions (clear by partial key, get entries)

1.5.0 - July 5, 2024

Feature

Shiny.Mediator.AspNet - that allows you to map your request handlers directly to HTTP endpoints

BREAKING Enhancement

Source Generator attributes have been renamed from RegisterHandler & RegisterMiddleware to SingletonHandler/ScopedHandler & SingletonMiddleware/ScopedMiddleware

1.4.5 - July 3, 2024

Feature

Strongly typed navigation now exists for Shell, just like Prism. This functionality is built into Shiny.Mediator.Maui

1.4.0 - June 30, 2024

Feature

Shiny.Mediator.Prism - this new package allows you to easily create strongly typed navigation routes & arguments while working across modules

1.3.0 - June 29, 2024

Enhancement

Request Keys can be controlled by implementing IRequestKey on your request object allowing you to return a cache/offline/replay key based on your arg values

Enhancement

MainThread middleware can now be used on request handlers as well

Enhancement

UserExceptionRequestMiddleware is now configurable and can be appled with attribute [UserExceptionRequestMiddleware] on each request handler method

Feature

Mediator middleware that has some form of store (cache/replay/offline) now responds to a global event called Shiny.Mediator.Middleware.FlushAllStoresEvent in Shiny.Mediator that calls all stores to be flushed

Feature

Resiliency middleware (Shiny.Mediator.Resilience} based on Microsoft.Extensions.Resilience

Feature

Offline Availability Middleware separated from caching and allows you to store across app sessions as needed (part of Shiny.Mediator.Maui)

BREAKING Feature

Caching middleware is now Shiny.Mediator.Caching and uses IMemoryCache under the hood

1.2.0 - June 19, 2024

Feature

Streaming Requests that request IAsyncEnumerable

Feature

Streaming Request Middleware

Feature

OOTB Streaming Request Middleware - Timer Refresh & Replay

1.1.0 - June 17, 2024

Fix

Void requests IRequestHandler<T> would not always resolve

Fix

Relaxed generic constraints on RequestMiddleware

Enhancement

MAUI CacheRequestMiddleware can hnow have cache flushed per item or all

1.0.0 - June 15, 2024

Our initial release - checkout the following:

• Getting Started
• Blog Post