Shiny.Mediator.Contracts 4.6.1-beta-0001

Prefix Reserved
This is a prerelease version of Shiny.Mediator.Contracts.
There is a newer version of this package available.
See the version list below for details.
dotnet add package Shiny.Mediator.Contracts --version 4.6.1-beta-0001
                    
NuGet\Install-Package Shiny.Mediator.Contracts -Version 4.6.1-beta-0001
                    
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.Contracts" Version="4.6.1-beta-0001" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Shiny.Mediator.Contracts" Version="4.6.1-beta-0001" />
                    
Directory.Packages.props
<PackageReference Include="Shiny.Mediator.Contracts" />
                    
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.Contracts --version 4.6.1-beta-0001
                    
#r "nuget: Shiny.Mediator.Contracts, 4.6.1-beta-0001"
                    
#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.Contracts@4.6.1-beta-0001
                    
#: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.Contracts&version=4.6.1-beta-0001&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Shiny.Mediator.Contracts&version=4.6.1-beta-0001&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.
  • net8.0

    • No dependencies.
  • net9.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Shiny.Mediator.Contracts:

Package Downloads
Shiny.Mediator

The main Shiny Mediator library where all the infrastructure lives

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
4.10.0-beta-0020 187 9/19/2025
4.10.0-beta-0019 259 9/18/2025
4.10.0-beta-0018 254 9/18/2025
4.10.0-beta-0017 252 9/18/2025
4.10.0-beta-0016 254 9/18/2025
4.10.0-beta-0015 251 9/18/2025
4.10.0-beta-0014 252 9/18/2025
4.10.0-beta-0013 251 9/18/2025
4.10.0-beta-0012 279 9/18/2025
4.10.0-beta-0011 305 9/16/2025
4.10.0-beta-0010 308 9/16/2025
4.10.0-beta-0009 173 9/10/2025
4.10.0-beta-0008 158 9/10/2025
4.10.0-beta-0007 164 9/9/2025
4.10.0-beta-0006 237 8/28/2025
4.10.0-beta-0005 127 8/22/2025
4.10.0-beta-0004 154 8/22/2025
4.10.0-beta-0003 161 8/18/2025
4.10.0-beta-0002 158 8/18/2025
4.10.0-beta-0001 124 7/29/2025
4.9.1 598 7/29/2025
4.9.0 215 7/26/2025
4.9.0-beta-0005 569 7/22/2025
4.9.0-beta-0004 559 7/22/2025
4.9.0-beta-0003 559 7/22/2025
4.9.0-beta-0002 535 7/21/2025
4.9.0-beta-0001 465 7/21/2025
4.8.0 291 7/18/2025
4.8.0-beta-0004 144 7/18/2025
4.8.0-beta-0003 212 7/14/2025
4.8.0-beta-0002 201 7/14/2025
4.8.0-beta-0001 188 7/14/2025
4.7.0 473 6/25/2025
4.7.0-beta-0026 191 7/13/2025
4.7.0-beta-0025 189 7/10/2025
4.7.0-beta-0023 197 6/25/2025
4.7.0-beta-0022 197 6/24/2025
4.7.0-beta-0021 197 6/23/2025
4.7.0-beta-0020 199 6/19/2025
4.7.0-beta-0004 193 6/19/2025
4.6.6 204 6/19/2025
4.6.5 200 6/19/2025
4.6.4 195 6/19/2025
4.6.3 480 6/18/2025
4.6.2 199 6/18/2025
4.6.1 230 6/16/2025
4.6.1-beta-0005 195 6/18/2025
4.6.1-beta-0003 199 6/18/2025
4.6.1-beta-0001 192 6/16/2025
4.6.0 197 6/16/2025
4.5.0 400 6/10/2025
4.5.0-beta-0007 335 6/10/2025
4.5.0-beta-0006 318 6/9/2025
4.5.0-beta-0004 150 6/6/2025
4.5.0-beta-0002 182 6/6/2025
4.4.0 445 6/3/2025
4.4.0-beta-0025 193 6/3/2025
4.4.0-beta-0023 194 5/29/2025
4.4.0-beta-0021 202 5/29/2025
4.4.0-beta-0018 208 5/26/2025
4.4.0-beta-0017 199 5/26/2025
4.4.0-beta-0015 199 5/26/2025
4.4.0-beta-0014 206 5/26/2025
4.4.0-beta-0004 160 5/25/2025
4.2.2 398 5/24/2025
4.2.1 365 5/8/2025
4.2.0 332 4/25/2025
4.2.0-beta-0010 212 5/8/2025
4.2.0-beta-0009 202 5/8/2025
4.2.0-beta-0008 172 4/25/2025
4.2.0-beta-0001 258 4/16/2025
4.1.0 521 3/28/2025
4.1.0-beta-0001 201 3/28/2025
4.0.4 504 3/24/2025
4.0.4-beta-0001 464 3/24/2025
4.0.3 329 3/23/2025
4.0.3-beta-0007 327 3/23/2025
4.0.2 303 3/15/2025
4.0.1 438 3/5/2025
4.0.1-beta-0010 218 3/19/2025
4.0.1-beta-0009 136 3/15/2025
4.0.1-beta-0001 285 3/5/2025
4.0.0 286 3/4/2025
4.0.0-beta-0021 272 3/4/2025
4.0.0-beta-0017 260 3/4/2025
4.0.0-beta-0016 279 3/4/2025
4.0.0-beta-0010 169 3/2/2025
4.0.0-beta-0009 171 3/2/2025
4.0.0-beta-0002 167 3/1/2025
3.3.1 347 2/20/2025
3.3.0 174 2/20/2025
3.3.0-beta-0028 154 2/20/2025
3.3.0-beta-0025 186 2/19/2025
3.3.0-beta-0024 185 2/19/2025
3.3.0-beta-0004 148 2/8/2025
3.2.0 435 1/29/2025
3.2.0-beta-0027 135 1/29/2025
3.2.0-beta-0023 145 1/29/2025
3.2.0-beta-0020 136 1/29/2025
3.1.3 154 1/29/2025
3.1.2 162 1/28/2025
3.1.1 180 1/25/2025
3.1.0 155 1/25/2025
3.1.0-beta-0013 141 1/25/2025
3.1.0-beta-0006 140 1/25/2025
3.1.0-beta-0004 145 1/25/2025
3.0.0 147 1/24/2025
3.0.0-beta-0055 141 1/24/2025
3.0.0-beta-0046 135 1/23/2025
3.0.0-beta-0045 146 1/23/2025
3.0.0-beta-0043 153 1/23/2025
3.0.0-beta-0038 167 1/21/2025
3.0.0-beta-0037 143 1/21/2025
3.0.0-beta-0029 157 1/21/2025
3.0.0-beta-0028 141 1/21/2025
3.0.0-beta-0018 143 1/19/2025
3.0.0-beta-0016 127 1/14/2025
3.0.0-beta-0012 141 1/12/2025
3.0.0-beta-0008 153 1/2/2025
3.0.0-beta-0007 156 12/28/2024
3.0.0-beta-0004 147 12/22/2024
2.2.0-beta-0001 352 10/28/2024
2.1.1 766 10/28/2024
2.1.0 301 10/19/2024
2.1.0-beta-0016 154 10/19/2024
2.1.0-beta-0015 161 10/19/2024
2.1.0-beta-0014 172 10/19/2024
2.1.0-beta-0013 170 10/19/2024
2.1.0-beta-0011 183 10/18/2024
2.1.0-beta-0010 172 10/18/2024
2.1.0-beta-0004 152 10/8/2024
2.1.0-beta-0002 147 10/6/2024
2.0.2 431 10/6/2024
2.0.1 170 10/6/2024
2.0.0 239 10/4/2024
2.0.0-beta-0060 152 10/6/2024
2.0.0-beta-0059 143 10/6/2024
2.0.0-beta-0056 150 10/4/2024
2.0.0-beta-0054 156 10/3/2024
2.0.0-beta-0053 143 10/2/2024
2.0.0-beta-0052 154 10/2/2024
2.0.0-beta-0050 161 10/2/2024
2.0.0-beta-0049 156 10/2/2024
2.0.0-beta-0046 164 10/1/2024
2.0.0-beta-0044 161 9/30/2024
2.0.0-beta-0026 164 9/24/2024
2.0.0-beta-0023 152 9/23/2024
2.0.0-beta-0022 145 9/23/2024
2.0.0-beta-0020 173 9/22/2024
2.0.0-beta-0004 160 9/20/2024
2.0.0-beta-0003 169 9/20/2024
1.9.0-beta-0003 156 9/16/2024
1.9.0-beta-0001 165 9/15/2024
1.9.0-beta 156 9/15/2024
1.8.1 341 9/14/2024
1.8.1-beta-0006 154 9/14/2024
1.8.1-beta-0005 156 9/14/2024
1.8.1-beta-0004 171 9/14/2024
1.8.1-beta-0003 159 9/14/2024
1.8.1-beta-0002 173 9/14/2024
1.8.1-beta-0001 160 9/14/2024
1.8.0 234 9/12/2024
1.8.0-beta-0064 187 9/12/2024
1.8.0-beta-0063 188 9/12/2024
1.8.0-beta-0059 181 9/8/2024
1.8.0-beta-0058 161 9/8/2024
1.8.0-beta-0057 194 9/8/2024
1.8.0-beta-0054 186 9/7/2024
1.8.0-beta-0053 194 9/6/2024
1.8.0-beta-0052 176 9/6/2024
1.8.0-beta-0051 196 9/6/2024
1.8.0-beta-0044 186 9/5/2024
1.8.0-beta-0042 184 9/4/2024
1.8.0-beta-0041 178 9/4/2024
1.8.0-beta-0027 187 8/25/2024
1.8.0-beta-0022 189 8/23/2024
1.8.0-beta-0017 187 8/7/2024
1.8.0-beta-0012 126 7/28/2024
1.8.0-beta-0010 130 7/28/2024
1.7.5 234 8/23/2024
1.7.4 345 8/9/2024
1.7.3 194 8/7/2024
1.7.2 163 7/28/2024
1.7.1 143 7/28/2024
1.7.0 213 7/20/2024
1.7.0-beta-0005 157 7/20/2024
1.7.0-beta-0001 184 7/8/2024
1.6.0 199 7/8/2024
1.6.0-beta-0004 165 7/7/2024
1.5.0 199 7/6/2024
1.5.0-beta-0010 168 7/6/2024
1.5.0-beta-0006 168 7/4/2024
1.4.5 196 7/4/2024
1.4.2 195 6/30/2024
1.4.1 182 6/30/2024
1.4.0 177 6/30/2024
1.4.0-beta-0010 161 6/30/2024
1.3.1 184 6/29/2024
1.3.0 172 6/29/2024
1.3.0-beta-0014 150 6/29/2024
1.3.0-beta-0007 142 6/26/2024
1.2.0 182 6/20/2024
1.2.0-beta-0001 153 6/20/2024
1.1.0 189 6/17/2024
1.1.0-beta-0019 158 6/20/2024
1.1.0-beta-0016 160 6/19/2024
1.1.0-beta-0014 157 6/17/2024
1.1.0-beta-0013 155 6/17/2024
1.0.0 208 6/15/2024
1.0.0-alpha-0054 155 6/15/2024
1.0.0-alpha-0053 156 6/12/2024
1.0.0-alpha-0051 137 6/12/2024
1.0.0-alpha-0048 141 6/10/2024
1.0.0-alpha-0047 140 6/10/2024
1.0.0-alpha-0043 142 6/9/2024
1.0.0-alpha-0042 161 6/7/2024
1.0.0-alpha-0040 141 6/6/2024
1.0.0-alpha-0038 147 6/6/2024
1.0.0-alpha-0036 147 6/5/2024
1.0.0-alpha-0034 163 6/4/2024
1.0.0-alpha-0031 142 6/4/2024
1.0.0-alpha-0025 150 6/3/2024
1.0.0-alpha-0023 145 6/2/2024
1.0.0-alpha-0022 153 6/1/2024
1.0.0-alpha-0019 138 6/1/2024
1.0.0-alpha-0018 146 6/1/2024
1.0.0-alpha-0014 151 6/1/2024
1.0.0-alpha-0013 148 6/1/2024
1.0.0-alpha-0012 165 5/31/2024
1.0.0-alpha-0011 160 5/31/2024
1.0.0-alpha-0010 163 5/31/2024