Shiny.Mediator.Blazor 1.0.0-alpha-0010

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 1.0.0-alpha-0010
                    
NuGet\Install-Package Shiny.Mediator.Blazor -Version 1.0.0-alpha-0010
                    
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="1.0.0-alpha-0010" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Shiny.Mediator.Blazor" Version="1.0.0-alpha-0010" />
                    
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 1.0.0-alpha-0010
                    
#r "nuget: Shiny.Mediator.Blazor, 1.0.0-alpha-0010"
                    
#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@1.0.0-alpha-0010
                    
#: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=1.0.0-alpha-0010&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Shiny.Mediator.Blazor&version=1.0.0-alpha-0010&prerelease
                    
Install as a Cake Tool

Shiny Mediator (Preview)

<a href="https://www.nuget.org/packages/Shiny.Mediator" target="_blank"> <img src="https://buildstats.info/nuget/Shiny.Mediator" /> </a>

A mediator pattern, but for apps. Apps have pages with lifecycles that don't necessarily participate in the standard dependency injection lifecycle. .NET MAUI generally tends to favor the Messenger pattern. We hate this pattern for many reasons which we won't get into. That being said, we do offer a messenger subscription in our Mediator for where interfaces and dependency injection can't reach.

Features

  • A Mediator for your .NET Apps (MAUI & Blazor are the main targets for us)
  • Think of "weak" message subscription without the fuss or mess to cleanup
  • Fire & Forget as well as Parallel Event execution
  • Our MAUI & Blazor integrations allow your viewmodels or pages to implement an IEventHandler<TEvent> interface(s) without them having to participate in the dependency injection provider
  • We still have a "messagingcenter" type subscribe off IMediator for cases where you can't have your current type implement an interface

Works With

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

Getting Started

First, let's create our request & event handlers

using Shiny.Mediator;

public record TestRequest(string AnyArgs, int YouWant) : IRequest;
public record TestEvent(MyObject AnyArgs) : IEvent;

// and for request/response requests - we'll come back to this
public record TestResponseRequest : IRequest<TestResponse> {}
public record TestResponse {}

Next - let's wire up a RequestHandler. You can have ONLY 1 request handler per request type. This is where you would do the main business logic or data requests.

Let's create our RequestHandler

using Shiny.Mediator;

// NOTE: Request handlers are registered as singletons
public class TestRequestHandler : IRequestHandler<TestRequest> 
{
    // you can do all dependency injection here
    public async Task Handle(TestRequest request, CancellationToken ct) 
    {
        // do something async here
    }
}

public class TestResponseRequestHandler : IRequestHandler<TestResponseRequest, TestResponse>
{
    public async Task<TestResponse> Handle(TestResponseRequest request, CancellationToken ct)
    {
        var response = await GetResponseThing(ct);
        return response;
    }
}

public class TestEventHandler : IEventHandler<TestEvent> 
{
    // Dependency injection works here
    public async Task Handle(TestEvent @event, CancellationToken ct)
    {
        // Do something async here
    }
}

Now, let's register all of our stuff with our .NET MAUI MauiProgram.cs

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp
            .CreateBuilder()
            .UseMauiApp<App>();
        
        builder.Services.AddShinyMediator();
        builder.Services.AddSingletonAsImplementedInterfaces<TestEventHandler>();
        builder.Services.AddSingletonAsImplementedInterfaces<TestRequestHandler>();
        builder.Services.AddSingltonAsImplementedInterfaces<TestResponseRequestHandler>();
        // OR if you're using our attribute for source generation
    }
}

Lastly, any model model/viewmodel/etc participating in dependency injection can now inject the mediator

public class MyViewModel(Shiny.Mediator.IMediator mediator)
{
    public async Task Execute() 
    {
        await mediator.Send(new TestRequest()); // this will execute TestRequestHandler
        var response = await mediator.Send(new TestResponseRequest()); // this will execute TestResponseRequestHandler and return a value
        
        // this will publish to any service registered that implement IEventHandler<TestEvent>
        // there are additional args here to allow you to execute values in sequentially or wait for all events to complete
        // by default, publish calls are "fire & forget" under the hood and execute in parallel
        await mediator.Publish(new TestEvent()); 
    }
}

What about my ViewModels?

For .NET MAUI, your viewmodels have the ability to participate in the event publishing chain without being part of dependency injection

With this setup, you don't need to worry about deallocating any events, unsubscribing from some service, or hooking to anything.

Lastly, if your page/viewmodel is navigated away from (popped), it will no longer participate in the event broadcast

Let's go back to MauiProgram.cs and alter the AddShinyMediator

builder.Services.AddShinyMediator<MauiEventCollector>();

Now your viewmodel (or page) can simply implement the IEventHandler<T> interface to participate

NOTE: Further example to below - you can implement multiple event handlers (or request handlers)

public class MyViewModel : BaseViewModel, 
                           Shiny.Mediator.IEventHandler<TestEvent>,
                           Shiny.Mediator.IEventHandler<TestEvent>
{
    public async Task Handle(TestEvent @event, CancellationToken ct)
    {
    }
    
    public async Task Handle(TestEvent2 @event, CancellationToken ct)
    {
    }
}

Sample

There is a sample in this repo. You do not need any other part of Shiny, Prism, ReactiveUI, etc - those are included as I write things faster with it. Focus on the interfaces from the mediator & the mediator calls itself

Ideas for Workflows

  • Use Prism with Modules - want strongly typed navigation parameters, navigations, and have them available to other modules - we're the guy to help!
    • Example TBD
  • Using a Shiny Foreground Job - want to push data an event that new data came in to anyone listening?
  • Have a Shiny Push Delegate that is executing on the delegate but want to push it to the UI, Mediator has a plan!

TODO

  • Pipelines

    • Error handlers - requests and events?
    • Pre/Post Execution - Time how long events took, time how long a command took
  • Explain Event Handlers

  • Streams - IAsyncEnumerable or IObservable

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 was computed.  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
5.1.0-beta-0001 26 10/25/2025
5.0.0 33 10/25/2025
5.0.0-beta-0012 140 10/23/2025
5.0.0-beta-0011 139 10/22/2025
5.0.0-beta-0010 141 10/22/2025
5.0.0-beta-0009 145 10/21/2025
5.0.0-beta-0008 153 10/19/2025
5.0.0-beta-0007 91 10/18/2025
5.0.0-beta-0006 96 10/17/2025
5.0.0-beta-0005 140 10/17/2025
5.0.0-beta-0004 144 10/10/2025
5.0.0-beta-0003 153 10/9/2025
5.0.0-beta-0002 155 10/8/2025
5.0.0-beta-0001 156 10/7/2025
4.10.0-beta-0020 221 9/19/2025
4.10.0-beta-0019 288 9/18/2025
4.10.0-beta-0018 278 9/18/2025
4.10.0-beta-0017 293 9/18/2025
4.10.0-beta-0016 293 9/18/2025
4.10.0-beta-0015 296 9/18/2025
4.10.0-beta-0014 291 9/18/2025
4.10.0-beta-0013 279 9/18/2025
4.10.0-beta-0012 278 9/18/2025
4.10.0-beta-0011 295 9/16/2025
4.10.0-beta-0010 292 9/16/2025
4.10.0-beta-0009 160 9/10/2025
4.10.0-beta-0008 148 9/10/2025
4.10.0-beta-0007 162 9/9/2025
4.10.0-beta-0006 209 8/28/2025
4.10.0-beta-0005 119 8/22/2025
4.10.0-beta-0004 152 8/22/2025
4.10.0-beta-0003 147 8/18/2025
4.10.0-beta-0002 156 8/18/2025
4.10.0-beta-0001 117 7/29/2025
4.9.1 133 7/29/2025
4.9.0 241 7/26/2025
4.9.0-beta-0005 557 7/22/2025
4.9.0-beta-0004 555 7/22/2025
4.9.0-beta-0003 550 7/22/2025
4.9.0-beta-0002 500 7/21/2025
4.9.0-beta-0001 417 7/21/2025
4.8.0 104 7/18/2025
4.8.0-beta-0004 97 7/18/2025
4.8.0-beta-0003 175 7/14/2025
4.8.0-beta-0002 163 7/14/2025
4.8.0-beta-0001 164 7/14/2025
4.7.0 180 6/25/2025
4.7.0-beta-0026 156 7/13/2025
4.7.0-beta-0025 159 7/10/2025
4.7.0-beta-0023 167 6/25/2025
4.7.0-beta-0022 160 6/24/2025
4.7.0-beta-0021 181 6/23/2025
4.7.0-beta-0020 170 6/19/2025
4.7.0-beta-0004 168 6/19/2025
4.6.6 188 6/19/2025
4.6.5 165 6/19/2025
4.6.4 163 6/19/2025
4.6.3 167 6/18/2025
4.6.2 158 6/18/2025
4.6.1 179 6/16/2025
4.6.1-beta-0005 181 6/18/2025
4.6.1-beta-0003 176 6/18/2025
4.6.1-beta-0001 165 6/16/2025
4.6.0 180 6/16/2025
4.5.0 321 6/10/2025
4.5.0-beta-0007 316 6/10/2025
4.5.0-beta-0006 305 6/9/2025
4.5.0-beta-0004 111 6/6/2025
4.5.0-beta-0002 171 6/6/2025
4.4.0 174 6/3/2025
4.4.0-beta-0025 182 6/3/2025
4.4.0-beta-0023 191 5/29/2025
4.4.0-beta-0021 178 5/29/2025
4.4.0-beta-0018 179 5/26/2025
4.4.0-beta-0017 189 5/26/2025
4.4.0-beta-0015 182 5/26/2025
4.4.0-beta-0014 168 5/26/2025
4.4.0-beta-0004 131 5/25/2025
4.2.2 126 5/24/2025
4.2.1 221 5/8/2025
4.2.0 148 4/25/2025
4.2.0-beta-0010 184 5/8/2025
4.2.0-beta-0009 167 5/8/2025
4.2.0-beta-0008 147 4/25/2025
4.2.0-beta-0001 229 4/16/2025
4.1.0 196 3/28/2025
4.1.0-beta-0001 181 3/28/2025
4.0.4 453 3/24/2025
4.0.4-beta-0001 423 3/24/2025
4.0.3 318 3/23/2025
4.0.3-beta-0007 303 3/23/2025
4.0.2 131 3/15/2025
4.0.1 247 3/5/2025
4.0.1-beta-0010 194 3/19/2025
4.0.1-beta-0009 108 3/15/2025
4.0.1-beta-0001 238 3/5/2025
4.0.0 242 3/4/2025
4.0.0-beta-0021 244 3/4/2025
4.0.0-beta-0017 245 3/4/2025
4.0.0-beta-0016 220 3/4/2025
4.0.0-beta-0010 138 3/2/2025
4.0.0-beta-0009 130 3/2/2025
4.0.0-beta-0002 121 3/1/2025
3.3.1 163 2/20/2025
3.3.0 150 2/20/2025
3.3.0-beta-0028 124 2/20/2025
3.3.0-beta-0025 120 2/19/2025
3.3.0-beta-0024 122 2/19/2025
3.3.0-beta-0004 142 2/8/2025
3.2.0 142 1/29/2025
3.2.0-beta-0027 122 1/29/2025
3.2.0-beta-0023 114 1/29/2025
3.2.0-beta-0020 131 1/29/2025
3.1.3 140 1/29/2025
3.1.2 147 1/28/2025
3.1.1 149 1/25/2025
3.1.0 138 1/25/2025
3.1.0-beta-0013 113 1/25/2025
3.1.0-beta-0006 125 1/25/2025
3.1.0-beta-0004 129 1/25/2025
3.0.0 154 1/24/2025
3.0.0-beta-0055 132 1/24/2025
3.0.0-beta-0046 117 1/23/2025
3.0.0-beta-0045 109 1/23/2025
3.0.0-beta-0043 143 1/23/2025
3.0.0-beta-0038 118 1/21/2025
3.0.0-beta-0037 128 1/21/2025
3.0.0-beta-0029 137 1/21/2025
3.0.0-beta-0028 135 1/21/2025
3.0.0-beta-0018 106 1/19/2025
3.0.0-beta-0016 112 1/14/2025
3.0.0-beta-0012 142 1/12/2025
3.0.0-beta-0008 120 1/2/2025
3.0.0-beta-0007 133 12/28/2024
3.0.0-beta-0004 148 12/22/2024
2.2.0-beta-0001 126 10/28/2024
2.1.1 166 10/28/2024
2.1.0 154 10/19/2024
2.1.0-beta-0016 121 10/19/2024
2.1.0-beta-0015 114 10/19/2024
2.1.0-beta-0014 129 10/19/2024
2.1.0-beta-0013 142 10/19/2024
2.1.0-beta-0011 174 10/18/2024
2.1.0-beta-0010 164 10/18/2024
2.1.0-beta-0004 131 10/8/2024
2.1.0-beta-0002 119 10/6/2024
2.0.2 162 10/6/2024
2.0.1 155 10/6/2024
2.0.0 172 10/4/2024
2.0.0-beta-0060 118 10/6/2024
2.0.0-beta-0059 130 10/6/2024
2.0.0-beta-0056 130 10/4/2024
2.0.0-beta-0054 150 10/3/2024
2.0.0-beta-0053 144 10/2/2024
2.0.0-beta-0052 146 10/2/2024
2.0.0-beta-0050 125 10/2/2024
2.0.0-beta-0049 135 10/2/2024
2.0.0-beta-0046 139 10/1/2024
2.0.0-beta-0044 132 9/30/2024
2.0.0-beta-0026 128 9/24/2024
2.0.0-beta-0023 118 9/23/2024
2.0.0-beta-0022 108 9/23/2024
2.0.0-beta-0020 131 9/22/2024
2.0.0-beta-0004 120 9/20/2024
2.0.0-beta-0003 125 9/20/2024
1.9.0-beta-0003 135 9/16/2024
1.9.0-beta-0001 132 9/15/2024
1.9.0-beta 119 9/15/2024
1.8.1 157 9/14/2024
1.8.1-beta-0006 122 9/14/2024
1.8.1-beta-0005 140 9/14/2024
1.8.1-beta-0004 121 9/14/2024
1.8.1-beta-0003 115 9/14/2024
1.8.1-beta-0002 165 9/14/2024
1.8.1-beta-0001 106 9/14/2024
1.8.0 195 9/12/2024
1.8.0-beta-0064 130 9/12/2024
1.8.0-beta-0063 145 9/12/2024
1.8.0-beta-0059 115 9/8/2024
1.8.0-beta-0058 143 9/8/2024
1.8.0-beta-0057 153 9/8/2024
1.8.0-beta-0054 124 9/7/2024
1.8.0-beta-0053 147 9/6/2024
1.8.0-beta-0052 117 9/6/2024
1.8.0-beta-0051 151 9/6/2024
1.8.0-beta-0044 158 9/5/2024
1.8.0-beta-0042 125 9/4/2024
1.8.0-beta-0041 131 9/4/2024
1.8.0-beta-0027 152 8/25/2024
1.8.0-beta-0022 157 8/23/2024
1.8.0-beta-0017 128 8/7/2024
1.8.0-beta-0012 121 7/28/2024
1.8.0-beta-0010 141 7/28/2024
1.7.5 177 8/23/2024
1.7.4 178 8/9/2024
1.7.3 171 8/7/2024
1.7.2 127 7/28/2024
1.7.1 135 7/28/2024
1.7.0 191 7/20/2024
1.7.0-beta-0005 148 7/20/2024
1.7.0-beta-0001 122 7/8/2024
1.6.0 172 7/8/2024
1.6.0-beta-0004 154 7/7/2024
1.5.0 151 7/6/2024
1.5.0-beta-0010 161 7/6/2024
1.5.0-beta-0006 137 7/4/2024
1.4.5 166 7/4/2024
1.4.2 173 6/30/2024
1.4.1 171 6/30/2024
1.4.0 150 6/30/2024
1.4.0-beta-0010 158 6/30/2024
1.3.1 148 6/29/2024
1.3.0 166 6/29/2024
1.3.0-beta-0014 143 6/29/2024
1.3.0-beta-0007 142 6/26/2024
1.2.0 177 6/20/2024
1.2.0-beta-0001 137 6/20/2024
1.1.0 167 6/17/2024
1.1.0-beta-0019 151 6/20/2024
1.1.0-beta-0016 137 6/19/2024
1.1.0-beta-0014 161 6/17/2024
1.1.0-beta-0013 151 6/17/2024
1.0.0 180 6/15/2024
1.0.0-alpha-0054 152 6/15/2024
1.0.0-alpha-0053 135 6/12/2024
1.0.0-alpha-0051 138 6/12/2024
1.0.0-alpha-0048 144 6/10/2024
1.0.0-alpha-0047 146 6/10/2024
1.0.0-alpha-0043 161 6/9/2024
1.0.0-alpha-0042 181 6/7/2024
1.0.0-alpha-0040 167 6/6/2024
1.0.0-alpha-0038 164 6/6/2024
1.0.0-alpha-0036 145 6/5/2024
1.0.0-alpha-0034 175 6/4/2024
1.0.0-alpha-0031 128 6/4/2024
1.0.0-alpha-0025 157 6/3/2024
1.0.0-alpha-0023 151 6/2/2024
1.0.0-alpha-0022 158 6/1/2024
1.0.0-alpha-0019 164 6/1/2024
1.0.0-alpha-0018 158 6/1/2024
1.0.0-alpha-0014 169 6/1/2024
1.0.0-alpha-0013 149 6/1/2024
1.0.0-alpha-0012 155 5/31/2024
1.0.0-alpha-0011 144 5/31/2024
1.0.0-alpha-0010 146 5/31/2024