Shiny.Mediator.Resilience 3.3.0-beta-0004

Prefix Reserved
This is a prerelease version of Shiny.Mediator.Resilience.
There is a newer version of this package available.
See the version list below for details.
dotnet add package Shiny.Mediator.Resilience --version 3.3.0-beta-0004
                    
NuGet\Install-Package Shiny.Mediator.Resilience -Version 3.3.0-beta-0004
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Shiny.Mediator.Resilience" Version="3.3.0-beta-0004" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Shiny.Mediator.Resilience" Version="3.3.0-beta-0004" />
                    
Directory.Packages.props
<PackageReference Include="Shiny.Mediator.Resilience" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Shiny.Mediator.Resilience --version 3.3.0-beta-0004
                    
#r "nuget: Shiny.Mediator.Resilience, 3.3.0-beta-0004"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Shiny.Mediator.Resilience@3.3.0-beta-0004
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Shiny.Mediator.Resilience&version=3.3.0-beta-0004&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Shiny.Mediator.Resilience&version=3.3.0-beta-0004&prerelease
                    
Install as a Cake Tool

Shiny Mediator

<a href="https://www.nuget.org/packages/Shiny.Mediator" target="_blank"> <img src="https://img.shields.io/nuget/v/Shiny.Mediator?style=for-the-badge" /> </a>

Mediator is a behavioral design pattern that lets you reduce chaotic dependencies between objects. The pattern restricts direct communications between the objects and forces them to collaborate only via a mediator object.

Shiny Mediator <NugetBadge name="Shiny.Mediator" /> is a mediator pattern implementation, but for built with ALL .NET apps in mind. We provide a TON of middleware out-of-box to get you up and rolling with hardly any effort whatsoever. Checkout our Getting Started guide to see how easy it is. Imagine using 1 line of code to add offline, caching, or validation to your code!

This project is heavily inspired by MediatR with some lesser features that we feel were aimed more at server scenarios, while also adding some features we feel benefit apps

Samples & Documentation

Features

Works With

  • .NET MAUI - all platforms
  • MVVM Frameworks like Prism, ReactiveUI, & .NET MAUI Shell
  • Blazor - Work In Progress
  • Any other .NET platform - but you'll have to come up with your own "event collector" for the out-of-state stuff

What Does It Solve

Problem #1 - Service & Reference Hell

Does this look familiar to you? Look at all of those injections! As your app grows, the list will only grow. I feel sorry for the dude that gets to unit test this bad boy.

public class MyViewModel(
    IConnectivity conn,
    IDataService data,
    IAuthService auth,
    IDialogsService dialogs,
    ILogger<MyViewModel> logger
) {
    // ...
    try {
        if (conn.IsConnected) 
        {
            var myData = await data.GetDataRequest();
        }
        else 
        {
            dialogs.Show("No Connection");
            // cache?
        }
    }
    catch (Exception ex) {
        dialogs.Show(ex.Message);
        logger.LogError(ex);
    }
}

With a bit of our middleware and some events, you can get here:

public class MyViewModel(IMediator mediator) : IEventHandler<ConnectivityChangedEvent>, IEventHandler<AuthChangedEvent> {
    // ...
    var myData = await mediator.Request(new GetDataRequest());

    // logging, exception handling, offline caching can all be bundle into one nice clean call without the need for coupling
}

public class GetDataRequestHandler : IRequestHandler<GetDataRequest, MyData> {

    [OfflineAvailable] // <= boom done
    public async Task<MyData> Handle(GetDataRequest request, CancellationToken cancellationToken) {
        // ...
    }
}

Problem #2 - Messages EVERYWHERE (+ Leaks)

Do you use the MessagingCenter in Xamarin.Forms? It's a great tool, but it can lead to some memory leaks if you're not careful. It also doesn't have a pipeline, so any errors in any of the responders will crash the entire chain. It doesn't have a request/response style setup (not that it was meant for it), but this means you still require other services.

public class MyViewModel
{
    public MyViewModel()
    {
        MessagingCenter.Subscribe<SomeEvent1>(this, @event => {
            // do something
        });
        MessagingCenter.Subscribe<SomeEvent2>(this, @event => {
            // do something
        });

        MessagingCenter.Send(new SomeEvent1());
        MessagingCenter.Send(new SomeEvent2());

        // and don't forget to unsubscribe
        MessagingCenter.Unsubscribe<SomeEvent1>(this);
        MessagingCenter.Unsubscribe<SomeEvent2>(this);
    }
}

Let's take a look at our mediator in action for this scenarios

public class MyViewModel : IEventHandler<SomeEvent1>, IEventHandler<SomeEvent2>
{
    public MyViewModel(IMediator mediator)
    {
        // no need to unsubscribe
        mediator.Publish(new SomeEvent1());
        mediator.Publish(new SomeEvent2());
    }
}

Problem #3 - Strongly Typed Navigation with Strongly Typed Arguments

Our amazing friends over in Prism offer the "best in class" MVVM framework. We'll them upsell you beyond that, but one of their amazing features is 'Modules'. Modules help break up your navigation registration, services, etc.

What they don't solve is providing a strongly typed nature for this stuff (not their job though). We think we can help addon to their beautiful solution.

A normal call to a navigation service might look like this:

_navigationService.NavigateAsync("MyPage", new NavigationParameters { { "MyArg", "MyValue" } });

This is great. It works, but I don't know the type OR argument requirements of "MyPage" without going to look it up. In a small project with a small dev team, this is fine. In a large project with a large dev team, this can be difficult.

Through our Shiny.Framework library we offer a GlobalNavigationService that can be used to navigate to any page in your app from anywhere, however, for the nature of this example, we'll pass our navigation service FROM our viewmodel through the mediator request to ensure proper scope.

public record MyPageNavigatonRequest(INavigationService navigator, string MyArg) : IRequest;
public class MyPageNavigationHandler : IRequestHandler<MyPageNavigatonRequest>
{
    public async Task Handle(MyPageNavigatonRequest request, CancellationToken cancellationToken)
    {
        await request.navigator.NavigateAsync("MyPage", new NavigationParameters { { "MyArg", request.MyArg } });
    }
}

Now, in your viewmodel, you can do this:

public class MyViewModel
{
    public MyViewModel(IMediator mediator)
    {
        mediator.Request(new MyPageNavigationCommand(_navigationService, "MyValue"));
    }
}

Strongly typed. No page required page knowledge from the module upfront. The other dev team of the module can define HOW things work.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
4.10.0-beta-0020 185 9/19/2025
4.10.0-beta-0019 262 9/18/2025
4.10.0-beta-0018 247 9/18/2025
4.10.0-beta-0017 259 9/18/2025
4.10.0-beta-0016 256 9/18/2025
4.10.0-beta-0015 258 9/18/2025
4.10.0-beta-0014 260 9/18/2025
4.10.0-beta-0013 256 9/18/2025
4.10.0-beta-0012 263 9/18/2025
4.10.0-beta-0011 263 9/16/2025
4.10.0-beta-0010 271 9/16/2025
4.10.0-beta-0009 137 9/10/2025
4.10.0-beta-0008 126 9/10/2025
4.10.0-beta-0007 129 9/9/2025
4.10.0-beta-0006 213 8/28/2025
4.10.0-beta-0005 101 8/22/2025
4.10.0-beta-0004 121 8/22/2025
4.10.0-beta-0003 139 8/18/2025
4.10.0-beta-0002 131 8/18/2025
4.10.0-beta-0001 125 7/29/2025
4.9.1 277 7/29/2025
4.9.0 221 7/26/2025
4.9.0-beta-0005 521 7/22/2025
4.9.0-beta-0004 524 7/22/2025
4.9.0-beta-0003 511 7/22/2025
4.9.0-beta-0002 489 7/21/2025
4.9.0-beta-0001 409 7/21/2025
4.8.0 104 7/18/2025
4.8.0-beta-0004 85 7/18/2025
4.8.0-beta-0003 146 7/14/2025
4.8.0-beta-0002 147 7/14/2025
4.8.0-beta-0001 144 7/14/2025
4.7.0 247 6/25/2025
4.7.0-beta-0026 146 7/13/2025
4.7.0-beta-0025 143 7/10/2025
4.7.0-beta-0023 155 6/25/2025
4.7.0-beta-0022 138 6/24/2025
4.7.0-beta-0021 165 6/23/2025
4.7.0-beta-0020 145 6/19/2025
4.7.0-beta-0004 160 6/19/2025
4.6.6 167 6/19/2025
4.6.5 164 6/19/2025
4.6.4 150 6/19/2025
4.6.3 175 6/18/2025
4.6.2 152 6/18/2025
4.6.1 178 6/16/2025
4.6.1-beta-0005 152 6/18/2025
4.6.1-beta-0003 140 6/18/2025
4.6.1-beta-0001 138 6/16/2025
4.6.0 157 6/16/2025
4.5.0 304 6/10/2025
4.5.0-beta-0007 282 6/10/2025
4.5.0-beta-0006 278 6/9/2025
4.5.0-beta-0004 111 6/6/2025
4.5.0-beta-0002 149 6/6/2025
4.4.0 174 6/3/2025
4.4.0-beta-0025 154 6/3/2025
4.4.0-beta-0023 160 5/29/2025
4.4.0-beta-0021 160 5/29/2025
4.4.0-beta-0018 159 5/26/2025
4.4.0-beta-0017 150 5/26/2025
4.4.0-beta-0015 153 5/26/2025
4.4.0-beta-0014 161 5/26/2025
4.4.0-beta-0004 93 5/25/2025
4.2.2 207 5/24/2025
4.2.1 224 5/8/2025
4.2.0 194 4/25/2025
4.2.0-beta-0010 153 5/8/2025
4.2.0-beta-0009 151 5/8/2025
4.2.0-beta-0008 114 4/25/2025
4.2.0-beta-0001 220 4/16/2025
4.1.0 180 3/28/2025
4.1.0-beta-0001 146 3/28/2025
4.0.4 439 3/24/2025
4.0.4-beta-0001 430 3/24/2025
4.0.3 286 3/23/2025
4.0.3-beta-0007 278 3/23/2025
4.0.2 91 3/15/2025
4.0.1 234 3/5/2025
4.0.1-beta-0010 153 3/19/2025
4.0.1-beta-0009 88 3/15/2025
4.0.1-beta-0001 217 3/5/2025
4.0.0 230 3/4/2025
4.0.0-beta-0021 215 3/4/2025
4.0.0-beta-0017 216 3/4/2025
4.0.0-beta-0016 229 3/4/2025
4.0.0-beta-0010 109 3/2/2025
4.0.0-beta-0009 95 3/2/2025
4.0.0-beta-0002 105 3/1/2025
3.3.1 192 2/20/2025
3.3.0 131 2/20/2025
3.3.0-beta-0028 116 2/20/2025
3.3.0-beta-0025 108 2/19/2025
3.3.0-beta-0024 114 2/19/2025
3.3.0-beta-0004 104 2/8/2025
3.2.0 181 1/29/2025
3.2.0-beta-0027 121 1/29/2025
3.2.0-beta-0023 114 1/29/2025
3.2.0-beta-0020 106 1/29/2025
3.1.3 109 1/29/2025
3.1.2 97 1/28/2025
3.1.1 113 1/25/2025
3.1.0 124 1/25/2025
3.1.0-beta-0013 102 1/25/2025
3.1.0-beta-0006 117 1/25/2025
3.1.0-beta-0004 110 1/25/2025
3.0.0 106 1/24/2025
3.0.0-beta-0055 102 1/24/2025
3.0.0-beta-0046 116 1/23/2025
3.0.0-beta-0045 107 1/23/2025
3.0.0-beta-0043 100 1/23/2025
3.0.0-beta-0038 110 1/21/2025
3.0.0-beta-0037 124 1/21/2025
3.0.0-beta-0029 109 1/21/2025
3.0.0-beta-0028 107 1/21/2025
3.0.0-beta-0018 96 1/19/2025
3.0.0-beta-0016 83 1/14/2025
3.0.0-beta-0012 108 1/12/2025
3.0.0-beta-0008 117 1/2/2025
3.0.0-beta-0007 107 12/28/2024
3.0.0-beta-0004 106 12/22/2024
2.2.0-beta-0001 98 10/28/2024
2.1.1 383 10/28/2024
2.1.0 165 10/19/2024
2.1.0-beta-0016 111 10/19/2024
2.1.0-beta-0015 126 10/19/2024
2.1.0-beta-0014 107 10/19/2024
2.1.0-beta-0013 120 10/19/2024
2.1.0-beta-0011 134 10/18/2024
2.1.0-beta-0010 127 10/18/2024
2.1.0-beta-0004 100 10/8/2024
2.1.0-beta-0002 99 10/6/2024
2.0.2 127 10/6/2024
2.0.1 116 10/6/2024
2.0.0 138 10/4/2024
2.0.0-beta-0060 110 10/6/2024
2.0.0-beta-0059 145 10/6/2024
2.0.0-beta-0056 107 10/4/2024
2.0.0-beta-0054 97 10/3/2024
2.0.0-beta-0053 109 10/2/2024
2.0.0-beta-0052 103 10/2/2024
2.0.0-beta-0050 98 10/2/2024
2.0.0-beta-0049 100 10/2/2024
2.0.0-beta-0046 106 10/1/2024
2.0.0-beta-0044 102 9/30/2024
2.0.0-beta-0026 108 9/24/2024
2.0.0-beta-0023 109 9/23/2024
2.0.0-beta-0022 102 9/23/2024
2.0.0-beta-0020 102 9/22/2024
2.0.0-beta-0004 100 9/20/2024
2.0.0-beta-0003 113 9/20/2024
1.9.0-beta-0003 123 9/16/2024
1.9.0-beta-0001 134 9/15/2024
1.9.0-beta 130 9/15/2024
1.8.1 159 9/14/2024
1.8.1-beta-0006 124 9/14/2024
1.8.1-beta-0005 127 9/14/2024
1.8.1-beta-0004 121 9/14/2024
1.8.1-beta-0003 114 9/14/2024
1.8.1-beta-0002 109 9/14/2024
1.8.1-beta-0001 108 9/14/2024
1.8.0 139 9/12/2024
1.8.0-beta-0064 116 9/12/2024
1.8.0-beta-0063 132 9/12/2024
1.8.0-beta-0059 115 9/8/2024
1.8.0-beta-0058 111 9/8/2024
1.8.0-beta-0057 106 9/8/2024
1.8.0-beta-0054 131 9/7/2024
1.8.0-beta-0053 137 9/6/2024
1.8.0-beta-0052 104 9/6/2024
1.8.0-beta-0051 124 9/6/2024
1.8.0-beta-0044 120 9/5/2024
1.8.0-beta-0042 130 9/4/2024
1.8.0-beta-0041 111 9/4/2024
1.8.0-beta-0027 145 8/25/2024
1.8.0-beta-0022 127 8/23/2024
1.8.0-beta-0017 124 8/7/2024
1.8.0-beta-0012 95 7/28/2024
1.8.0-beta-0010 113 7/28/2024
1.7.5 169 8/23/2024
1.7.4 170 8/9/2024
1.7.3 137 8/7/2024
1.7.2 109 7/28/2024
1.7.1 102 7/28/2024
1.7.0 134 7/20/2024
1.7.0-beta-0005 120 7/20/2024
1.7.0-beta-0001 144 7/8/2024
1.6.0 133 7/8/2024
1.6.0-beta-0004 129 7/7/2024
1.5.0 155 7/6/2024
1.5.0-beta-0010 156 7/6/2024
1.5.0-beta-0006 136 7/4/2024
1.4.5 163 7/4/2024
1.4.2 142 6/30/2024
1.4.1 162 6/30/2024
1.4.0 139 6/30/2024
1.4.0-beta-0010 137 6/30/2024
1.3.1 141 6/29/2024
1.3.0 139 6/29/2024
1.3.0-beta-0014 122 6/29/2024
1.3.0-beta-0007 117 6/26/2024
1.2.0 153 6/20/2024
1.2.0-beta-0001 113 6/20/2024
1.1.0 185 6/17/2024
1.1.0-beta-0019 137 6/20/2024
1.1.0-beta-0016 125 6/19/2024
1.1.0-beta-0014 133 6/17/2024
1.1.0-beta-0013 130 6/17/2024