From 3955ee9f398bd305aa6bc2e6015e8afbfd1aad2c Mon Sep 17 00:00:00 2001
From: TekH <h.tek@digitaldata.works>
Date: Wed, 8 Apr 2026 15:34:39 +0200
Subject: [PATCH] Refactor Mediator GetOr API for naming consistency

Renamed MediatorExtensions to MediatorGetOrContext and GetOrContext<TResponse> to MediatorGetOrContext<TResponse> for consistent naming. Moved the GetOr extension method into the new static class. Updated XML docs and reorganized declarations; no functional changes.
---
 ...rExtensions.cs => MediatorGetOrContext.cs} | 38 +++++++++----------
 1 file changed, 19 insertions(+), 19 deletions(-)
 rename EnvelopeGenerator.Application/Common/Extensions/{MediatorExtensions.cs => MediatorGetOrContext.cs} (89%)

diff --git a/EnvelopeGenerator.Application/Common/Extensions/MediatorExtensions.cs b/EnvelopeGenerator.Application/Common/Extensions/MediatorGetOrContext.cs
similarity index 89%
rename from EnvelopeGenerator.Application/Common/Extensions/MediatorExtensions.cs
rename to EnvelopeGenerator.Application/Common/Extensions/MediatorGetOrContext.cs
index 010c3154..f43cd0a3 100644
--- a/EnvelopeGenerator.Application/Common/Extensions/MediatorExtensions.cs
+++ b/EnvelopeGenerator.Application/Common/Extensions/MediatorGetOrContext.cs
@@ -4,35 +4,18 @@ using System.Collections;
 
 namespace EnvelopeGenerator.Application.Common.Extensions;
 
-/// <summary>
-/// Extension methods for <see cref="ISender"/> that provide a fluent API for enforcing non-null responses.
-/// </summary>
-public static class MediatorExtensions
-{
-    /// <summary>
-    /// Begins a fluent chain that sends <paramref name="request"/> and lets you choose how to handle a <c>null</c> or empty response.
-    /// <para>Usage:</para>
-    /// <code>
-    /// await sender.GetOr(query).ThrowNotFound();
-    /// await sender.GetOr(query, cancel).Throw(() => new MyException());
-    /// </code>
-    /// </summary>
-    public static GetOrContext<TResponse> GetOr<TResponse>(this ISender sender, IRequest<TResponse?> request, CancellationToken cancel = default)
-        => new(sender, request, cancel);
-}
-
 /// <summary>
 /// Holds a pending MediatR request and exposes <c>Throw…</c> methods that send the request
 /// and throw a chosen exception when the response is <c>null</c> or an empty collection.
 /// </summary>
 /// <typeparam name="TResponse">The expected response type.</typeparam>
-public readonly struct GetOrContext<TResponse>
+public readonly struct MediatorGetOrContext<TResponse>
 {
     private readonly ISender _sender;
     private readonly IRequest<TResponse?> _request;
     private readonly CancellationToken _cancel;
 
-    internal GetOrContext(ISender sender, IRequest<TResponse?> request, CancellationToken cancel)
+    internal MediatorGetOrContext(ISender sender, IRequest<TResponse?> request, CancellationToken cancel)
     {
         _sender = sender;
         _request = request;
@@ -74,4 +57,21 @@ public readonly struct GetOrContext<TResponse>
     /// </summary>
     public Task<TResponse> ThrowBadRequest(string? message = null)
         => Throw(() => new BadRequestException(message ?? $"The request for {typeof(TResponse).Name} is invalid."));
+}
+
+/// <summary>
+/// Extension methods for <see cref="ISender"/> that provide a fluent API for enforcing non-null responses.
+/// </summary>
+public static class MediatorGetOrContext
+{
+    /// <summary>
+    /// Begins a fluent chain that sends <paramref name="request"/> and lets you choose how to handle a <c>null</c> or empty response.
+    /// <para>Usage:</para>
+    /// <code>
+    /// await sender.GetOr(query).ThrowNotFound();
+    /// await sender.GetOr(query, cancel).Throw(() => new MyException());
+    /// </code>
+    /// </summary>
+    public static MediatorGetOrContext<TResponse> GetOr<TResponse>(this ISender sender, IRequest<TResponse?> request, CancellationToken cancel = default)
+        => new(sender, request, cancel);
 }
\ No newline at end of file