Shiny.Mediator.Blazor 4.4.0-beta-0017

Prefix Reserved
This is a prerelease version of Shiny.Mediator.Blazor.
There is a newer version of this package available.
See the version list below for details.
dotnet add package Shiny.Mediator.Blazor --version 4.4.0-beta-0017
                    
NuGet\Install-Package Shiny.Mediator.Blazor -Version 4.4.0-beta-0017
                    
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.Blazor" Version="4.4.0-beta-0017" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Shiny.Mediator.Blazor" Version="4.4.0-beta-0017" />
                    
Directory.Packages.props
<PackageReference Include="Shiny.Mediator.Blazor" />
                    
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.Blazor --version 4.4.0-beta-0017
                    
#r "nuget: Shiny.Mediator.Blazor, 4.4.0-beta-0017"
                    
#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.Blazor@4.4.0-beta-0017
                    
#: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.Blazor&version=4.4.0-beta-0017&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Shiny.Mediator.Blazor&version=4.4.0-beta-0017&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 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-0006 170 8/28/2025
4.10.0-beta-0005 84 8/22/2025
4.10.0-beta-0004 116 8/22/2025
4.10.0-beta-0003 121 8/18/2025
4.10.0-beta-0002 120 8/18/2025
4.10.0-beta-0001 94 7/29/2025
4.9.1 104 7/29/2025
4.9.0 208 7/26/2025
4.9.0-beta-0005 493 7/22/2025
4.9.0-beta-0004 494 7/22/2025
4.9.0-beta-0003 490 7/22/2025
4.9.0-beta-0002 454 7/21/2025
4.9.0-beta-0001 378 7/21/2025
4.8.0 70 7/18/2025
4.8.0-beta-0004 63 7/18/2025
4.8.0-beta-0003 147 7/14/2025
4.8.0-beta-0002 136 7/14/2025
4.8.0-beta-0001 134 7/14/2025
4.7.0 157 6/25/2025
4.7.0-beta-0026 131 7/13/2025
4.7.0-beta-0025 135 7/10/2025
4.7.0-beta-0023 145 6/25/2025
4.7.0-beta-0022 138 6/24/2025
4.7.0-beta-0021 146 6/23/2025
4.7.0-beta-0020 145 6/19/2025
4.7.0-beta-0004 136 6/19/2025
4.6.6 148 6/19/2025
4.6.5 140 6/19/2025
4.6.4 141 6/19/2025
4.6.3 144 6/18/2025
4.6.2 141 6/18/2025
4.6.1 155 6/16/2025
4.6.1-beta-0005 144 6/18/2025
4.6.1-beta-0003 142 6/18/2025
4.6.1-beta-0001 138 6/16/2025
4.6.0 146 6/16/2025
4.5.0 300 6/10/2025
4.5.0-beta-0007 285 6/10/2025
4.5.0-beta-0006 271 6/9/2025
4.5.0-beta-0004 97 6/6/2025
4.5.0-beta-0002 134 6/6/2025
4.4.0 155 6/3/2025
4.4.0-beta-0025 151 6/3/2025
4.4.0-beta-0023 153 5/29/2025
4.4.0-beta-0021 148 5/29/2025
4.4.0-beta-0018 149 5/26/2025
4.4.0-beta-0017 148 5/26/2025
4.4.0-beta-0015 143 5/26/2025
4.4.0-beta-0014 144 5/26/2025
4.4.0-beta-0004 100 5/25/2025
4.2.2 83 5/24/2025
4.2.1 184 5/8/2025
4.2.0 112 4/25/2025
4.2.0-beta-0010 156 5/8/2025
4.2.0-beta-0009 144 5/8/2025
4.2.0-beta-0008 106 4/25/2025
4.2.0-beta-0001 189 4/16/2025
4.1.0 169 3/28/2025
4.1.0-beta-0001 145 3/28/2025
4.0.4 424 3/24/2025
4.0.4-beta-0001 400 3/24/2025
4.0.3 282 3/23/2025
4.0.3-beta-0007 271 3/23/2025
4.0.2 91 3/15/2025
4.0.1 223 3/5/2025
4.0.1-beta-0010 159 3/19/2025
4.0.1-beta-0009 75 3/15/2025
4.0.1-beta-0001 211 3/5/2025
4.0.0 218 3/4/2025
4.0.0-beta-0021 210 3/4/2025
4.0.0-beta-0017 215 3/4/2025
4.0.0-beta-0016 207 3/4/2025
4.0.0-beta-0010 101 3/2/2025
4.0.0-beta-0009 95 3/2/2025
4.0.0-beta-0002 97 3/1/2025
3.3.1 129 2/20/2025
3.3.0 115 2/20/2025
3.3.0-beta-0028 102 2/20/2025
3.3.0-beta-0025 98 2/19/2025
3.3.0-beta-0024 101 2/19/2025
3.3.0-beta-0004 103 2/8/2025
3.2.0 107 1/29/2025
3.2.0-beta-0027 90 1/29/2025
3.2.0-beta-0023 90 1/29/2025
3.2.0-beta-0020 95 1/29/2025
3.1.3 104 1/29/2025
3.1.2 105 1/28/2025
3.1.1 114 1/25/2025
3.1.0 103 1/25/2025
3.1.0-beta-0013 91 1/25/2025
3.1.0-beta-0006 94 1/25/2025
3.1.0-beta-0004 93 1/25/2025
3.0.0 108 1/24/2025
3.0.0-beta-0055 95 1/24/2025
3.0.0-beta-0046 94 1/23/2025
3.0.0-beta-0045 87 1/23/2025
3.0.0-beta-0043 96 1/23/2025
3.0.0-beta-0038 95 1/21/2025
3.0.0-beta-0037 106 1/21/2025
3.0.0-beta-0029 105 1/21/2025
3.0.0-beta-0028 95 1/21/2025
3.0.0-beta-0018 85 1/19/2025
3.0.0-beta-0016 77 1/14/2025
3.0.0-beta-0012 106 1/12/2025
3.0.0-beta-0008 97 1/2/2025
3.0.0-beta-0007 101 12/28/2024
3.0.0-beta-0004 109 12/22/2024
2.2.0-beta-0001 101 10/28/2024
2.1.1 134 10/28/2024
2.1.0 132 10/19/2024
2.1.0-beta-0016 97 10/19/2024
2.1.0-beta-0015 93 10/19/2024
2.1.0-beta-0014 107 10/19/2024
2.1.0-beta-0013 117 10/19/2024
2.1.0-beta-0011 136 10/18/2024
2.1.0-beta-0010 129 10/18/2024
2.1.0-beta-0004 98 10/8/2024
2.1.0-beta-0002 95 10/6/2024
2.0.2 130 10/6/2024
2.0.1 123 10/6/2024
2.0.0 123 10/4/2024
2.0.0-beta-0060 97 10/6/2024
2.0.0-beta-0059 99 10/6/2024
2.0.0-beta-0056 95 10/4/2024
2.0.0-beta-0054 111 10/3/2024
2.0.0-beta-0053 107 10/2/2024
2.0.0-beta-0052 114 10/2/2024
2.0.0-beta-0050 104 10/2/2024
2.0.0-beta-0049 105 10/2/2024
2.0.0-beta-0046 104 10/1/2024
2.0.0-beta-0044 108 9/30/2024
2.0.0-beta-0026 106 9/24/2024
2.0.0-beta-0023 94 9/23/2024
2.0.0-beta-0022 85 9/23/2024
2.0.0-beta-0020 98 9/22/2024
2.0.0-beta-0004 90 9/20/2024
2.0.0-beta-0003 104 9/20/2024
1.9.0-beta-0003 102 9/16/2024
1.9.0-beta-0001 99 9/15/2024
1.9.0-beta 97 9/15/2024
1.8.1 130 9/14/2024
1.8.1-beta-0006 96 9/14/2024
1.8.1-beta-0005 113 9/14/2024
1.8.1-beta-0004 96 9/14/2024
1.8.1-beta-0003 95 9/14/2024
1.8.1-beta-0002 125 9/14/2024
1.8.1-beta-0001 95 9/14/2024
1.8.0 163 9/12/2024
1.8.0-beta-0064 107 9/12/2024
1.8.0-beta-0063 120 9/12/2024
1.8.0-beta-0059 93 9/8/2024
1.8.0-beta-0058 107 9/8/2024
1.8.0-beta-0057 112 9/8/2024
1.8.0-beta-0054 113 9/7/2024
1.8.0-beta-0053 114 9/6/2024
1.8.0-beta-0052 106 9/6/2024
1.8.0-beta-0051 120 9/6/2024
1.8.0-beta-0044 126 9/5/2024
1.8.0-beta-0042 103 9/4/2024
1.8.0-beta-0041 98 9/4/2024
1.8.0-beta-0027 134 8/25/2024
1.8.0-beta-0022 120 8/23/2024
1.8.0-beta-0017 105 8/7/2024
1.8.0-beta-0012 91 7/28/2024
1.8.0-beta-0010 105 7/28/2024
1.7.5 156 8/23/2024
1.7.4 147 8/9/2024
1.7.3 135 8/7/2024
1.7.2 105 7/28/2024
1.7.1 102 7/28/2024
1.7.0 151 7/20/2024
1.7.0-beta-0005 124 7/20/2024
1.7.0-beta-0001 109 7/8/2024
1.6.0 141 7/8/2024
1.6.0-beta-0004 116 7/7/2024
1.5.0 129 7/6/2024
1.5.0-beta-0010 125 7/6/2024
1.5.0-beta-0006 114 7/4/2024
1.4.5 143 7/4/2024
1.4.2 144 6/30/2024
1.4.1 145 6/30/2024
1.4.0 128 6/30/2024
1.4.0-beta-0010 125 6/30/2024
1.3.1 136 6/29/2024
1.3.0 138 6/29/2024
1.3.0-beta-0014 118 6/29/2024
1.3.0-beta-0007 109 6/26/2024
1.2.0 145 6/20/2024
1.2.0-beta-0001 115 6/20/2024
1.1.0 133 6/17/2024
1.1.0-beta-0019 115 6/20/2024
1.1.0-beta-0016 116 6/19/2024
1.1.0-beta-0014 128 6/17/2024
1.1.0-beta-0013 115 6/17/2024
1.0.0 149 6/15/2024
1.0.0-alpha-0054 121 6/15/2024
1.0.0-alpha-0053 117 6/12/2024
1.0.0-alpha-0051 115 6/12/2024
1.0.0-alpha-0048 122 6/10/2024
1.0.0-alpha-0047 113 6/10/2024
1.0.0-alpha-0043 125 6/9/2024
1.0.0-alpha-0042 127 6/7/2024
1.0.0-alpha-0040 125 6/6/2024
1.0.0-alpha-0038 124 6/6/2024
1.0.0-alpha-0036 123 6/5/2024
1.0.0-alpha-0034 137 6/4/2024
1.0.0-alpha-0031 117 6/4/2024
1.0.0-alpha-0025 124 6/3/2024
1.0.0-alpha-0023 124 6/2/2024
1.0.0-alpha-0022 122 6/1/2024
1.0.0-alpha-0019 127 6/1/2024
1.0.0-alpha-0018 121 6/1/2024
1.0.0-alpha-0014 134 6/1/2024
1.0.0-alpha-0013 115 6/1/2024
1.0.0-alpha-0012 119 5/31/2024
1.0.0-alpha-0011 121 5/31/2024
1.0.0-alpha-0010 124 5/31/2024