<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Davish.Sendr</title><link>https://davidchen617.github.io/Davish.Sendr/</link><description>Recent content on Davish.Sendr</description><generator>Hugo</generator><language>en-US</language><atom:link href="https://davidchen617.github.io/Davish.Sendr/index.xml" rel="self" type="application/rss+xml"/><item><title>Dispatch model</title><link>https://davidchen617.github.io/Davish.Sendr/concepts/dispatch-model/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/concepts/dispatch-model/</guid><description>&lt;h2 id="three-independent-message-kinds"&gt;Three independent message kinds&lt;a class="anchor" href="#three-independent-message-kinds"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Davish.Sendr has three kinds of message contracts, all dispatched through &lt;code&gt;ISender&lt;/code&gt;:&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;code&gt;IRequest&lt;/code&gt; / &lt;code&gt;IRequest&amp;lt;TResponse&amp;gt;&lt;/code&gt; — general request/response.&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;ICommand&lt;/code&gt; / &lt;code&gt;ICommand&amp;lt;TResponse&amp;gt;&lt;/code&gt; — explicit CQRS command contracts.&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;IQuery&amp;lt;TResponse&amp;gt;&lt;/code&gt; — explicit CQRS query contracts.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;&lt;code&gt;ICommand&lt;/code&gt;/&lt;code&gt;IQuery&lt;/code&gt; are independent of &lt;code&gt;IRequest&lt;/code&gt; — a command handler implements&#10;&lt;code&gt;ICommandHandler&lt;/code&gt;, not &lt;code&gt;IRequestHandler&lt;/code&gt;. Each kind has its own handler interface,&#10;&lt;code&gt;ISender.SendAsync&lt;/code&gt; overload, registration method&#10;(&lt;code&gt;AddRequestHandler&lt;/code&gt;/&lt;code&gt;AddCommandHandler&lt;/code&gt;/&lt;code&gt;AddQueryHandler&lt;/code&gt;), and decorator interface. At the&#10;call site, &lt;code&gt;ISender.SendAsync&lt;/code&gt; picks the right overload from the argument&amp;rsquo;s static type, so&#10;callers don&amp;rsquo;t need to know which kind a message belongs to.&lt;/p&gt;</description></item><item><title>Getting started</title><link>https://davidchen617.github.io/Davish.Sendr/getting-started/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/getting-started/</guid><description>&lt;h2 id="install"&gt;Install&lt;a class="anchor" href="#install"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;dotnet add package Davish.Sendr&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;If a domain/application assembly should reference the message contracts (&lt;code&gt;IRequest&lt;/code&gt;,&#10;&lt;code&gt;IRequestHandler&lt;/code&gt;, &lt;code&gt;ISender&lt;/code&gt;, …) without pulling in the DI implementation, reference the&#10;contracts package instead:&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;dotnet add package Davish.Sendr.Abstractions&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;Davish.Sendr&lt;/code&gt; already depends on &lt;code&gt;Davish.Sendr.Abstractions&lt;/code&gt;, so an application&amp;rsquo;s entry&#10;point project only needs the former.&lt;/p&gt;&#10;&lt;h2 id="register-addsendr-and-a-handler"&gt;Register &lt;code&gt;AddSendr&lt;/code&gt; and a handler&lt;a class="anchor" href="#register-addsendr-and-a-handler"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-csharp" data-lang="csharp"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;builder.Services&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .AddSendr()&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .AddRequestHandler&amp;lt;CreateOrder, CreateOrderHandler&amp;gt;()&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .AddRequestHandler&amp;lt;GetOrder, OrderDto, GetOrderHandler&amp;gt;();&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;AddRequestHandler&amp;lt;TRequest, THandler&amp;gt;&lt;/code&gt; is for requests with no response&#10;(&lt;code&gt;IRequest&lt;/code&gt;); &lt;code&gt;AddRequestHandler&amp;lt;TRequest, TResponse, THandler&amp;gt;&lt;/code&gt; is for requests that return&#10;a value (&lt;code&gt;IRequest&amp;lt;TResponse&amp;gt;&lt;/code&gt;). Register at most one handler per request/response pair —&#10;see &lt;a href="https://davidchen617.github.io/Davish.Sendr/concepts/dispatch-model/"&gt;Dispatch model&lt;/a&gt; for what happens if you register a second&#10;one, or none at all.&lt;/p&gt;</description></item><item><title>Packages</title><link>https://davidchen617.github.io/Davish.Sendr/reference/packages/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/reference/packages/</guid><description>&lt;p&gt;Every package this repository produces, its purpose, and its current version (from each&#10;project&amp;rsquo;s &lt;code&gt;.csproj&lt;/code&gt;; check the &lt;code&gt;.csproj&lt;/code&gt; for the current value, since this table is a&#10;snapshot).&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;PackageId&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Version&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Status&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Purpose&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;3.6.0&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Current&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Request/response and stream dispatch, notification publishing, decorator pipeline, tracing (&lt;code&gt;SendrActivitySource&lt;/code&gt;), DI registration (&lt;code&gt;AddSendr&lt;/code&gt;, &lt;code&gt;AddSendrNotification&lt;/code&gt;). Depends on &lt;code&gt;Davish.Sendr.Abstractions&lt;/code&gt;.&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Abstractions&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;4.0.0&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Current&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Contracts only: &lt;code&gt;IRequest&lt;/code&gt;, &lt;code&gt;IRequestHandler&lt;/code&gt;, &lt;code&gt;IRequestDecorator&lt;/code&gt;, &lt;code&gt;ISender&lt;/code&gt;, &lt;code&gt;ICommand&lt;/code&gt;, &lt;code&gt;IQuery&lt;/code&gt;, &lt;code&gt;INotification&lt;/code&gt;, &lt;code&gt;INotificationHandler&lt;/code&gt;, &lt;code&gt;INotificationDecorator&lt;/code&gt;, &lt;code&gt;IPublisher&lt;/code&gt;, and related types. No DI implementation.&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Generators&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;2.2.0&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Current, opt-in&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Roslyn incremental source generator: compile-time handler discovery, &lt;code&gt;[DecorateWith&amp;lt;...&amp;gt;]&lt;/code&gt; wiring, reflection-free &lt;code&gt;ISender&lt;/code&gt;/&lt;code&gt;IStreamSender&lt;/code&gt;/&lt;code&gt;IPublisher&lt;/code&gt; via &lt;code&gt;UseGenerators()&lt;/code&gt;.&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Message&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;2.0.0&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Deprecated&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Compatibility shim for &lt;code&gt;ICommand&lt;/code&gt;/&lt;code&gt;ICommandHandler&lt;/code&gt;/&lt;code&gt;IQuery&lt;/code&gt;/&lt;code&gt;IQueryHandler&lt;/code&gt;, now in &lt;code&gt;Davish.Sendr.Abstractions&lt;/code&gt;. No content of its own; will be removed in a future major version.&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Notification&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;3.0.0&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Deprecated&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Compatibility shim for notification publishing (&lt;code&gt;IPublisher&lt;/code&gt;, &lt;code&gt;AddSendrNotification&lt;/code&gt;, &lt;code&gt;AddNotificationHandler&lt;/code&gt;, …), now in &lt;code&gt;Davish.Sendr&lt;/code&gt;. No content of its own; will be removed in a future major version.&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Notification.Abstractions&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;4.0.0&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Deprecated&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Compatibility shim for &lt;code&gt;INotification&lt;/code&gt;/&lt;code&gt;INotificationHandler&lt;/code&gt;/&lt;code&gt;INotificationDecorator&lt;/code&gt;/&lt;code&gt;IPublisher&lt;/code&gt; contracts, now in &lt;code&gt;Davish.Sendr.Abstractions&lt;/code&gt;. No content of its own; will be removed in a future major version.&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;See &lt;a href="https://davidchen617.github.io/Davish.Sendr/guides/migrating-from-deprecated-packages/"&gt;Migrating from deprecated packages&lt;/a&gt;&#10;for moving off the deprecated ones.&lt;/p&gt;</description></item><item><title>Registering handlers</title><link>https://davidchen617.github.io/Davish.Sendr/guides/registering-handlers/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/guides/registering-handlers/</guid><description>&lt;p&gt;Covers manual registration for requests, commands, and queries. For streams, see the&#10;&amp;ldquo;Streams&amp;rdquo; section below. For the source-generated alternative, see&#10;&lt;a href="https://davidchen617.github.io/Davish.Sendr/guides/enabling-source-generation/"&gt;Enabling source generation&lt;/a&gt;. Background on how these&#10;kinds relate is in &lt;a href="https://davidchen617.github.io/Davish.Sendr/concepts/dispatch-model/"&gt;Dispatch model&lt;/a&gt;.&lt;/p&gt;&#10;&lt;h2 id="requests"&gt;Requests&lt;a class="anchor" href="#requests"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;IRequest&lt;/code&gt; for a command with no return value:&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-csharp" data-lang="csharp"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;record&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;CreateOrder&lt;/span&gt;(Guid Id) : IRequest;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;class&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;CreateOrderHandler&lt;/span&gt; : IRequestHandler&amp;lt;CreateOrder&amp;gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;{&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; Task HandleAsync(CreateOrder request, CancellationToken cancellationToken = &lt;span style="color:#66d9ef"&gt;default&lt;/span&gt;)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;return&lt;/span&gt; Task.CompletedTask;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;IRequest&amp;lt;TResponse&amp;gt;&lt;/code&gt; for request/response:&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-csharp" data-lang="csharp"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;record&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;GetOrder&lt;/span&gt;(Guid Id) : IRequest&amp;lt;OrderDto&amp;gt;;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;record&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;OrderDto&lt;/span&gt;(Guid Id, &lt;span style="color:#66d9ef"&gt;string&lt;/span&gt; Number);&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;class&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;GetOrderHandler&lt;/span&gt; : IRequestHandler&amp;lt;GetOrder, OrderDto&amp;gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;{&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; Task&amp;lt;OrderDto&amp;gt; HandleAsync(GetOrder request, CancellationToken cancellationToken = &lt;span style="color:#66d9ef"&gt;default&lt;/span&gt;)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;return&lt;/span&gt; Task.FromResult(&lt;span style="color:#66d9ef"&gt;new&lt;/span&gt; OrderDto(request.Id, &lt;span style="color:#e6db74"&gt;&amp;#34;SO-001&amp;#34;&lt;/span&gt;));&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Register both, then dispatch through &lt;code&gt;ISender&lt;/code&gt;:&lt;/p&gt;</description></item><item><title>Decorator pipeline</title><link>https://davidchen617.github.io/Davish.Sendr/concepts/decorator-pipeline/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/concepts/decorator-pipeline/</guid><description>&lt;p&gt;A decorator is a non-generic pipeline behavior that wraps handler execution — logging,&#10;transactions, validation, and similar cross-cutting concerns. &amp;ldquo;Non-generic&amp;rdquo; means one&#10;decorator class can wrap any number of unrelated request/command/query/stream/notification&#10;types, unlike a handler, which is written against one specific message type.&lt;/p&gt;&#10;&lt;h2 id="one-interface-per-message-kind-plus-a-response-variant"&gt;One interface per message kind, plus a response variant&lt;a class="anchor" href="#one-interface-per-message-kind-plus-a-response-variant"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Message kind&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Decorator interface&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;IRequest&lt;/code&gt; (no response)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;IRequestDecorator&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;IRequest&amp;lt;TResponse&amp;gt;&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;IRequestDecorator.WithResponse&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;ICommand&lt;/code&gt; (no response)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;ICommandDecorator&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;ICommand&amp;lt;TResponse&amp;gt;&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;ICommandDecorator.WithResponse&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;IQuery&amp;lt;TResponse&amp;gt;&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;IQueryDecorator&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;IStreamRequest&amp;lt;TResponse&amp;gt;&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;IStreamRequestDecorator&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;INotification&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;INotificationDecorator&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;A class can implement both the no-response and &lt;code&gt;WithResponse&lt;/code&gt; variants of a kind at once&#10;(the README&amp;rsquo;s &lt;code&gt;LoggingDecorator&lt;/code&gt; example implements both &lt;code&gt;IRequestDecorator&lt;/code&gt; and&#10;&lt;code&gt;IRequestDecorator.WithResponse&lt;/code&gt;), letting one decorator wrap every shape of that kind.&lt;/p&gt;</description></item><item><title>Exceptions and diagnostics</title><link>https://davidchen617.github.io/Davish.Sendr/reference/exceptions-and-diagnostics/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/reference/exceptions-and-diagnostics/</guid><description>&lt;h2 id="runtime-exceptions"&gt;Runtime exceptions&lt;a class="anchor" href="#runtime-exceptions"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;h3 id="missing-handler--invalidoperationexception"&gt;Missing handler — &lt;code&gt;InvalidOperationException&lt;/code&gt;&lt;a class="anchor" href="#missing-handler--invalidoperationexception"&gt;&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;Thrown when dispatching a request/command/query/stream with no registered handler (for&#10;streams, when enumeration starts). The message names the specific registration call that&amp;rsquo;s&#10;missing:&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;Davish.Sendr: no handler is registered for &amp;#39;&amp;lt;requestType&amp;gt;&amp;#39;. Call services.&amp;lt;registrationMethod&amp;gt;&amp;lt;&amp;lt;requestType&amp;gt;, YourHandler&amp;gt;() during startup.&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;or, for a request/command/query with a response type:&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;Davish.Sendr: no handler is registered for &amp;#39;&amp;lt;requestType&amp;gt;&amp;#39; with response &amp;#39;&amp;lt;responseType&amp;gt;&amp;#39;. Call services.&amp;lt;registrationMethod&amp;gt;&amp;lt;&amp;lt;requestType&amp;gt;, &amp;lt;responseType&amp;gt;, YourHandler&amp;gt;() during startup.&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;&amp;lt;registrationMethod&amp;gt;&lt;/code&gt; is whichever of &lt;code&gt;AddRequestHandler&lt;/code&gt;/&lt;code&gt;AddCommandHandler&lt;/code&gt;/&#10;&lt;code&gt;AddQueryHandler&lt;/code&gt;/&lt;code&gt;AddStreamRequestHandler&lt;/code&gt; matches the message&amp;rsquo;s kind.&lt;/p&gt;</description></item><item><title>Using decorators</title><link>https://davidchen617.github.io/Davish.Sendr/guides/using-decorators/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/guides/using-decorators/</guid><description>&lt;p&gt;Background on the pipeline model and ordering rules is in&#10;&lt;a href="https://davidchen617.github.io/Davish.Sendr/concepts/decorator-pipeline/"&gt;Decorator pipeline&lt;/a&gt;. This guide shows the manual and&#10;generated ways to attach one.&lt;/p&gt;&#10;&lt;h2 id="manual-xdecoratorwitht"&gt;Manual: &lt;code&gt;x.Decorator.With&amp;lt;T&amp;gt;()&lt;/code&gt;&lt;a class="anchor" href="#manual-xdecoratorwitht"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Pass a &lt;code&gt;configure&lt;/code&gt; delegate to the registration call and chain &lt;code&gt;With&amp;lt;T&amp;gt;()&lt;/code&gt; in outer-to-inner&#10;order:&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-csharp" data-lang="csharp"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;builder.Services&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .AddSendr()&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .AddRequestHandler&amp;lt;GetOrder, OrderDto, GetOrderHandler&amp;gt;(x =&amp;gt; x.Decorator&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .With&amp;lt;TransactionDecorator&amp;gt;()&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .With&amp;lt;LoggingDecorator&amp;gt;());&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Here &lt;code&gt;TransactionDecorator&lt;/code&gt; is outermost (runs first and last); &lt;code&gt;LoggingDecorator&lt;/code&gt; is nested&#10;inside it.&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-csharp" data-lang="csharp"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;class&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;LoggingDecorator&lt;/span&gt;(ILogger&amp;lt;LoggingDecorator&amp;gt; logger)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; : IRequestDecorator, IRequestDecorator.WithResponse&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;{&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;async&lt;/span&gt; Task HandleAsync&amp;lt;TRequest&amp;gt;(&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; TRequest request,&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; RequestHandlerDelegate next,&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; CancellationToken cancellationToken = &lt;span style="color:#66d9ef"&gt;default&lt;/span&gt;)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;where&lt;/span&gt; TRequest : IRequest&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; logger.LogInformation(&lt;span style="color:#e6db74"&gt;&amp;#34;Handling {Request}&amp;#34;&lt;/span&gt;, &lt;span style="color:#66d9ef"&gt;typeof&lt;/span&gt;(TRequest).Name);&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;await&lt;/span&gt; next();&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; logger.LogInformation(&lt;span style="color:#e6db74"&gt;&amp;#34;Handled {Request}&amp;#34;&lt;/span&gt;, &lt;span style="color:#66d9ef"&gt;typeof&lt;/span&gt;(TRequest).Name);&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;async&lt;/span&gt; Task&amp;lt;TResponse&amp;gt; HandleAsync&amp;lt;TRequest, TResponse&amp;gt;(&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; TRequest request,&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; RequestHandlerDelegate&amp;lt;TResponse&amp;gt; next,&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; CancellationToken cancellationToken = &lt;span style="color:#66d9ef"&gt;default&lt;/span&gt;)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;where&lt;/span&gt; TRequest : IRequest&amp;lt;TResponse&amp;gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; logger.LogInformation(&lt;span style="color:#e6db74"&gt;&amp;#34;Handling {Request}&amp;#34;&lt;/span&gt;, &lt;span style="color:#66d9ef"&gt;typeof&lt;/span&gt;(TRequest).Name);&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;var&lt;/span&gt; response = &lt;span style="color:#66d9ef"&gt;await&lt;/span&gt; next();&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; logger.LogInformation(&lt;span style="color:#e6db74"&gt;&amp;#34;Handled {Request}&amp;#34;&lt;/span&gt;, &lt;span style="color:#66d9ef"&gt;typeof&lt;/span&gt;(TRequest).Name);&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;return&lt;/span&gt; response;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Implementing both &lt;code&gt;IRequestDecorator&lt;/code&gt; and &lt;code&gt;IRequestDecorator.WithResponse&lt;/code&gt; on one class lets&#10;it wrap both &lt;code&gt;IRequest&lt;/code&gt; and &lt;code&gt;IRequest&amp;lt;TResponse&amp;gt;&lt;/code&gt; handlers. The same pattern applies to&#10;&lt;code&gt;ICommandDecorator&lt;/code&gt;/&lt;code&gt;ICommandDecorator.WithResponse&lt;/code&gt;, &lt;code&gt;IQueryDecorator&lt;/code&gt;,&#10;&lt;code&gt;IStreamRequestDecorator&lt;/code&gt;, and &lt;code&gt;INotificationDecorator&lt;/code&gt; — see&#10;&lt;a href="https://davidchen617.github.io/Davish.Sendr/guides/publishing-notifications/"&gt;Publishing notifications&lt;/a&gt; for the notification-specific setup.&lt;/p&gt;</description></item><item><title>Extensibility</title><link>https://davidchen617.github.io/Davish.Sendr/reference/extensibility/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/reference/extensibility/</guid><description>&lt;p&gt;For plugging in a custom &lt;code&gt;ISender&lt;/code&gt;/&lt;code&gt;IStreamSender&lt;/code&gt; or &lt;code&gt;IPublisher&lt;/code&gt; implementation instead of&#10;the default reflection-based one or the generated one.&lt;/p&gt;&#10;&lt;h2 id="sendroptions"&gt;&lt;code&gt;SendrOptions&lt;/code&gt;&lt;a class="anchor" href="#sendroptions"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Passed to the &lt;code&gt;configure&lt;/code&gt; delegate of &lt;code&gt;AddSendr(configure)&lt;/code&gt;.&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Member&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Signature&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Notes&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Services&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;IServiceCollection Services { get; }&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;The collection being configured by &lt;code&gt;AddSendr&lt;/code&gt;. An extension (such as the generated &lt;code&gt;UseGenerators()&lt;/code&gt;) uses this to register handlers/decorators alongside a custom sender.&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;UseSender&amp;lt;TSender&amp;gt;()&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;SendrOptions UseSender&amp;lt;TSender&amp;gt;() where TSender : class, ISender, IStreamSender&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Registers &lt;code&gt;TSender&lt;/code&gt; as both &lt;code&gt;ISender&lt;/code&gt; and &lt;code&gt;IStreamSender&lt;/code&gt;, replacing the default sender. Returns &lt;code&gt;this&lt;/code&gt; for chaining. This is what &lt;code&gt;UseGenerators()&lt;/code&gt; calls internally to install the generated sender.&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;&lt;code&gt;TSender&lt;/code&gt; is resolved as the same instance for both &lt;code&gt;ISender&lt;/code&gt; and &lt;code&gt;IStreamSender&lt;/code&gt; within a&#10;scope (&lt;code&gt;IStreamSender&lt;/code&gt; resolves through &lt;code&gt;ISender&lt;/code&gt; rather than constructing its own&#10;instance), but each interface is still its own DI registration. If &lt;code&gt;TSender&lt;/code&gt; is&#10;&lt;code&gt;IDisposable&lt;/code&gt;/&lt;code&gt;IAsyncDisposable&lt;/code&gt;, a scope that resolves both interfaces causes the container&#10;to invoke disposal once per registration (twice total) — implement disposal idempotently.&lt;/p&gt;</description></item><item><title>Notification model</title><link>https://davidchen617.github.io/Davish.Sendr/concepts/notification-model/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/concepts/notification-model/</guid><description>&lt;h2 id="zero-or-more-handlers-in-two-groups"&gt;Zero or more handlers, in two groups&lt;a class="anchor" href="#zero-or-more-handlers-in-two-groups"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Unlike a request/command/query (exactly one handler), an &lt;code&gt;INotification&lt;/code&gt; can have any number&#10;of handlers, including zero. &lt;code&gt;IPublisher.PublishAsync&lt;/code&gt; with no registered handlers for the&#10;notification&amp;rsquo;s type is a no-op.&lt;/p&gt;&#10;&lt;p&gt;Handlers for a given notification type are organized into two named groups:&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;Sequence&lt;/strong&gt; — runs one handler at a time, in registration order. A handler that throws&#10;does not stop the remaining Sequence handlers from running.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Parallel&lt;/strong&gt; — starts every handler in the group concurrently.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;The Sequence group and the Parallel group run concurrently &lt;em&gt;with each other&lt;/em&gt; — a Parallel&#10;handler does not wait for the Sequence group to finish, and vice versa:&lt;/p&gt;</description></item><item><title>Publishing notifications</title><link>https://davidchen617.github.io/Davish.Sendr/guides/publishing-notifications/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/guides/publishing-notifications/</guid><description>&lt;p&gt;Background on Sequence/Parallel semantics and exception aggregation is in&#10;&lt;a href="https://davidchen617.github.io/Davish.Sendr/concepts/notification-model/"&gt;Notification model&lt;/a&gt;.&lt;/p&gt;&#10;&lt;h2 id="define-the-notification-and-its-handlers"&gt;Define the notification and its handlers&lt;a class="anchor" href="#define-the-notification-and-its-handlers"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-csharp" data-lang="csharp"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;record&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;OrderPlaced&lt;/span&gt;(Guid OrderId) : INotification;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;class&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;ReserveInventoryHandler&lt;/span&gt; : INotificationHandler&amp;lt;OrderPlaced&amp;gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;{&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; Task HandleAsync(OrderPlaced notification, CancellationToken cancellationToken = &lt;span style="color:#66d9ef"&gt;default&lt;/span&gt;)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;return&lt;/span&gt; Task.CompletedTask;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;class&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;SendConfirmationEmailHandler&lt;/span&gt; : INotificationHandler&amp;lt;OrderPlaced&amp;gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;{&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; Task HandleAsync(OrderPlaced notification, CancellationToken cancellationToken = &lt;span style="color:#66d9ef"&gt;default&lt;/span&gt;)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;return&lt;/span&gt; Task.CompletedTask;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 id="register-manual"&gt;Register: manual&lt;a class="anchor" href="#register-manual"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Call &lt;code&gt;AddSendrNotification()&lt;/code&gt; once, then register every handler for a notification type in a&#10;single &lt;code&gt;AddNotificationHandler&lt;/code&gt; call, assigning each one to the Sequence and/or Parallel&#10;group:&lt;/p&gt;</description></item><item><title>Compile-time discovery</title><link>https://davidchen617.github.io/Davish.Sendr/concepts/compile-time-discovery/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/concepts/compile-time-discovery/</guid><description>&lt;p&gt;&lt;code&gt;Davish.Sendr.Generators&lt;/code&gt; is a Roslyn incremental source generator. It discovers handler&#10;implementations at compile time and emits a reflection-free &lt;code&gt;ISender&lt;/code&gt;/&lt;code&gt;IStreamSender&lt;/code&gt;&#10;(and, separately, a reflection-free &lt;code&gt;IPublisher&lt;/code&gt; for notifications), avoiding both runtime&#10;assembly scanning and reflection-based invocation. Manual registration (see&#10;&lt;a href="https://davidchen617.github.io/Davish.Sendr/concepts/dispatch-model/"&gt;Dispatch model&lt;/a&gt;) never scans assemblies either, but still resolves and&#10;invokes handlers reflectively at dispatch time; the generator removes that reflection too.&lt;/p&gt;&#10;&lt;h2 id="opting-in"&gt;Opting in&lt;a class="anchor" href="#opting-in"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;AddSendr(o =&amp;gt; o.UseGenerators())&lt;/code&gt; installs the generated sender; &lt;code&gt;AddSendr()&lt;/code&gt; alone keeps&#10;the default reflection-based one. The two are mutually exclusive per application — once&#10;&lt;code&gt;UseGenerators()&lt;/code&gt; is active, manual &lt;code&gt;AddRequestHandler&lt;/code&gt;/&lt;code&gt;AddCommandHandler&lt;/code&gt;/&lt;code&gt;AddQueryHandler&lt;/code&gt;/&#10;&lt;code&gt;AddStreamRequestHandler&lt;/code&gt; calls do not extend the generated dispatch table. The same relationship&#10;holds independently for notifications, via &lt;code&gt;AddSendrNotification(o =&amp;gt; o.UseGenerators())&lt;/code&gt;.&lt;/p&gt;</description></item><item><title>Enabling source generation</title><link>https://davidchen617.github.io/Davish.Sendr/guides/enabling-source-generation/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/guides/enabling-source-generation/</guid><description>&lt;p&gt;Background on what the generator does and why is in&#10;&lt;a href="https://davidchen617.github.io/Davish.Sendr/concepts/compile-time-discovery/"&gt;Compile-time discovery&lt;/a&gt;.&lt;/p&gt;&#10;&lt;h2 id="install"&gt;Install&lt;a class="anchor" href="#install"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-xml" data-lang="xml"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#f92672"&gt;&amp;lt;PackageReference&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;Include=&lt;/span&gt;&lt;span style="color:#e6db74"&gt;&amp;#34;Davish.Sendr&amp;#34;&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;Version=&lt;/span&gt;&lt;span style="color:#e6db74"&gt;&amp;#34;3.5.0&amp;#34;&lt;/span&gt; &lt;span style="color:#f92672"&gt;/&amp;gt;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#f92672"&gt;&amp;lt;PackageReference&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;Include=&lt;/span&gt;&lt;span style="color:#e6db74"&gt;&amp;#34;Davish.Sendr.Generators&amp;#34;&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;Version=&lt;/span&gt;&lt;span style="color:#e6db74"&gt;&amp;#34;2.1.0&amp;#34;&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;PrivateAssets=&lt;/span&gt;&lt;span style="color:#e6db74"&gt;&amp;#34;all&amp;#34;&lt;/span&gt; &lt;span style="color:#f92672"&gt;/&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;PrivateAssets=&amp;quot;all&amp;quot;&lt;/code&gt; keeps the generator itself (an analyzer-style package) from flowing&#10;into downstream consumers of the project.&lt;/p&gt;&#10;&lt;h2 id="turn-it-on"&gt;Turn it on&lt;a class="anchor" href="#turn-it-on"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-csharp" data-lang="csharp"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;builder.Services.AddSendr(o =&amp;gt; o.UseGenerators());&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;builder.Services.AddSendrNotification(o =&amp;gt; o.UseGenerators());&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;AddSendr()&lt;/code&gt;/&lt;code&gt;AddSendrNotification()&lt;/code&gt; alone (without &lt;code&gt;UseGenerators()&lt;/code&gt;) keep the default&#10;reflection-based sender/publisher. Once &lt;code&gt;UseGenerators()&lt;/code&gt; is used, manual &lt;code&gt;AddXHandler&lt;/code&gt;/&#10;&lt;code&gt;AddNotificationHandler&lt;/code&gt; calls for that same sender/publisher do not extend its dispatch&#10;table — pick one registration style per sender and per publisher.&lt;/p&gt;</description></item><item><title>Tracing spans and tags</title><link>https://davidchen617.github.io/Davish.Sendr/reference/tracing-spans-and-tags/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/reference/tracing-spans-and-tags/</guid><description>&lt;p&gt;Every span comes from the &lt;code&gt;ActivitySource&lt;/code&gt; named &lt;code&gt;Davish.Sendr&lt;/code&gt;&#10;(&lt;code&gt;SendrActivitySource.Name&lt;/code&gt;) and has &lt;code&gt;ActivityKind.Internal&lt;/code&gt;. How to subscribe to it is in&#10;&lt;a href="https://davidchen617.github.io/Davish.Sendr/guides/tracing/"&gt;Tracing&lt;/a&gt;.&lt;/p&gt;&#10;&lt;h2 id="spans"&gt;Spans&lt;a class="anchor" href="#spans"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Span&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Display name&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Emitted for&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Send&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Send &amp;lt;TypeName&amp;gt;&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Each &lt;code&gt;ISender.SendAsync&lt;/code&gt; call for a request, command, or query.&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Publish&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Publish &amp;lt;TypeName&amp;gt;&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Each &lt;code&gt;IPublisher.PublishAsync&lt;/code&gt; call whose notification has at least one handler.&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Handle&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Handle &amp;lt;HandlerTypeName&amp;gt;&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Each notification handler that runs, including its decorators. A child of the &lt;code&gt;Publish&lt;/code&gt; span.&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;&lt;code&gt;&amp;lt;TypeName&amp;gt;&lt;/code&gt; and &lt;code&gt;&amp;lt;HandlerTypeName&amp;gt;&lt;/code&gt; are the type&amp;rsquo;s short name without its namespace. The&#10;full name is in a tag.&lt;/p&gt;</description></item><item><title>Limitations</title><link>https://davidchen617.github.io/Davish.Sendr/reference/limitations/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/reference/limitations/</guid><description>&lt;p&gt;Behavior that is by design but easy to run into.&lt;/p&gt;&#10;&lt;h2 id="one-class-several-handler-interfaces"&gt;One class, several handler interfaces&lt;a class="anchor" href="#one-class-several-handler-interfaces"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;[DecorateWith&amp;lt;...&amp;gt;]&lt;/code&gt; applies to every handler interface the class implements. The generator&#10;checks each decorator against the decorator interface of every message kind the class handles.&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-csharp" data-lang="csharp"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#a6e22e"&gt;[DecorateWith&amp;lt;AuditCommandDecorator&amp;gt;]&lt;/span&gt; &lt;span style="color:#75715e"&gt;// implements ICommandDecorator only&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;class&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;OrderHandlers&lt;/span&gt; : ICommandHandler&amp;lt;PlaceOrder&amp;gt;, IQueryHandler&amp;lt;GetOrder, OrderDto&amp;gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;{&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#75715e"&gt;// ...&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;This reports &lt;code&gt;SENDR001&lt;/code&gt;: &lt;code&gt;'AuditCommandDecorator' does not implement Davish.Sendr.IQueryDecorator, required to decorate 'OrderHandlers'.&lt;/code&gt;&lt;/p&gt;&#10;&lt;p&gt;What to do:&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;Split the class into one handler per message, and put &lt;code&gt;[DecorateWith&amp;lt;...&amp;gt;]&lt;/code&gt; only on the handlers&#10;that need it.&lt;/li&gt;&#10;&lt;li&gt;Or use a decorator that implements every decorator interface the class needs (here,&#10;&lt;code&gt;ICommandDecorator&lt;/code&gt; and &lt;code&gt;IQueryDecorator&lt;/code&gt;).&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="a-derived-request-is-not-dispatched-to-the-base-handler"&gt;A derived request is not dispatched to the base handler&lt;a class="anchor" href="#a-derived-request-is-not-dispatched-to-the-base-handler"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Both senders look up the handler by the message&amp;rsquo;s runtime type, and Microsoft.Extensions.DependencyInjection&#10;does not resolve variant handler types. A handler for a base type does not handle a derived type:&lt;/p&gt;</description></item><item><title>Migrating from deprecated packages</title><link>https://davidchen617.github.io/Davish.Sendr/guides/migrating-from-deprecated-packages/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/guides/migrating-from-deprecated-packages/</guid><description>&lt;p&gt;Three packages are deprecated compatibility shims. Each has no content of its own — it&#10;exists only so that a project already referencing it keeps resolving, via a dependency on&#10;the package it was merged into — and each is slated for removal in a future major version.&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Deprecated package&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Merged into&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Since&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Message&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Abstractions&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Abstractions&lt;/code&gt; 3.1.0+&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Notification&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;—&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Notification.Abstractions&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Abstractions&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;—&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;&lt;code&gt;Davish.Sendr.Message&lt;/code&gt; carried &lt;code&gt;ICommand&lt;/code&gt;/&lt;code&gt;ICommandHandler&lt;/code&gt;/&lt;code&gt;IQuery&lt;/code&gt;/&lt;code&gt;IQueryHandler&lt;/code&gt;.&#10;&lt;code&gt;Davish.Sendr.Notification&lt;/code&gt; and &lt;code&gt;Davish.Sendr.Notification.Abstractions&lt;/code&gt; carried&#10;&lt;code&gt;INotification&lt;/code&gt;/&lt;code&gt;INotificationHandler&lt;/code&gt;/&lt;code&gt;INotificationDecorator&lt;/code&gt;/&lt;code&gt;IPublisher&lt;/code&gt; (and the&#10;&lt;code&gt;AddSendrNotification&lt;/code&gt;/&lt;code&gt;AddNotificationHandler&lt;/code&gt; registration surface). All of these types&#10;live in the &lt;code&gt;Davish.Sendr&lt;/code&gt; namespace both before and after the move, so migrating is a&#10;package-reference change, not a &lt;code&gt;using&lt;/code&gt;/namespace change:&lt;/p&gt;</description></item><item><title>Tracing</title><link>https://davidchen617.github.io/Davish.Sendr/guides/tracing/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/guides/tracing/</guid><description>&lt;p&gt;Sendr emits &lt;a href="https://learn.microsoft.com/dotnet/api/system.diagnostics.activity"&gt;&lt;code&gt;Activity&lt;/code&gt;&lt;/a&gt;&#10;spans for every request, command, query, and notification it dispatches. The spans come from&#10;one &lt;code&gt;ActivitySource&lt;/code&gt; named &lt;code&gt;Davish.Sendr&lt;/code&gt;, so any listener that can subscribe to an&#10;&lt;code&gt;ActivitySource&lt;/code&gt; by name — OpenTelemetry&amp;rsquo;s tracer provider, or your own &lt;code&gt;ActivityListener&lt;/code&gt; —&#10;can collect them.&lt;/p&gt;&#10;&lt;p&gt;Nothing is emitted until a listener subscribes. There is no switch to turn on in&#10;&lt;code&gt;AddSendr()&lt;/code&gt;, &lt;code&gt;AddSendrNotification()&lt;/code&gt;, or &lt;code&gt;UseGenerators()&lt;/code&gt;.&lt;/p&gt;&#10;&lt;p&gt;The exact span names and tags are listed in&#10;&lt;a href="https://davidchen617.github.io/Davish.Sendr/reference/tracing-spans-and-tags/"&gt;Tracing spans and tags&lt;/a&gt;.&lt;/p&gt;</description></item></channel></rss>