Add implementation summary documentation

Co-authored-by: chkr1011 <6939810+chkr1011@users.noreply.github.com>
Fix WebSocket URI format and remove unnecessary null-forgiving operator
2026-10-15 00:15:15 +08:00 · 2026-02-07 10:55:09 +00:00 · 2026-02-07 10:52:10 +00:00 · 2026-02-07 10:50:42 +00:00 · 2026-02-07 10:49:16 +00:00 · 2026-02-07 10:47:51 +00:00
209 changed files with 2745 additions and 1226 deletions
@@ -1,9 +1,58 @@
 <Project>
+    <PropertyGroup>
+        <TargetFramework>net8.0</TargetFramework>
+        <Product>MQTTnet</Product>
+        <Authors>The contributors of MQTTnet</Authors>
+        <Company>The contributors of MQTTnet</Company>
+        <Copyright>Copyright (c) .NET Foundation and Contributors</Copyright>

-  <PropertyGroup>
-    <TestingPlatformShowTestsFailure>true</TestingPlatformShowTestsFailure>
-    <TestingPlatformDotnetTestSupport>true</TestingPlatformDotnetTestSupport>
-    <EnableMSTestRunner>true</EnableMSTestRunner>
-  </PropertyGroup>
+        <DelaySign>false</DelaySign>
+        <SignAssembly>false</SignAssembly>
+        <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
+        <EnforceCodeStyleInBuild>false</EnforceCodeStyleInBuild>
+        <ImplicitUsings>enable</ImplicitUsings>

-</Project>
+        <NeutralLanguage>en-US</NeutralLanguage>
+        <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
+        <NoWarn>1591;NETSDK1138;NU1803;NU1901;NU1902</NoWarn>
+
+        <NuGetAuditMode>all</NuGetAuditMode>
+        <NuGetAudit>true</NuGetAudit>
+        <NuGetAuditLevel>low</NuGetAuditLevel>
+
+        <EnableNETAnalyzers>true</EnableNETAnalyzers>
+        <AnalysisLevel>latest</AnalysisLevel>
+        <AnalysisMode>recommended</AnalysisMode>
+        <AnalysisModeStyle>default</AnalysisModeStyle>
+
+        <TestingPlatformShowTestsFailure>true</TestingPlatformShowTestsFailure>
+        <TestingPlatformDotnetTestSupport>true</TestingPlatformDotnetTestSupport>
+        <EnableMSTestRunner>true</EnableMSTestRunner>
+    </PropertyGroup>
+
+    <PropertyGroup Condition="'$(GITHUB_ACTIONS)' == 'true'">
+        <ContinuousIntegrationBuild>true</ContinuousIntegrationBuild>
+    </PropertyGroup>
+
+    <PropertyGroup Condition="'$(GeneratePackageOnBuild)'=='true'">
+        <PackageLicenseFile>LICENSE</PackageLicenseFile>
+        <PackageIcon>nuget.png</PackageIcon>
+        <PackageProjectUrl>https://github.com/dotnet/MQTTnet</PackageProjectUrl>
+        <RepositoryUrl>https://github.com/dotnet/MQTTnet.git</RepositoryUrl>
+        <RepositoryType>git</RepositoryType>
+        <IncludeSymbols>true</IncludeSymbols>
+        <SymbolPackageFormat>snupkg</SymbolPackageFormat>
+        <PublishRepositoryUrl>true</PublishRepositoryUrl>
+        <EmbedUntrackedSources>true</EmbedUntrackedSources>
+    </PropertyGroup>
+
+    <ItemGroup Condition="'$(GeneratePackageOnBuild)'=='true'">
+        <None Include="README.md" Pack="true" PackagePath="" Condition="Exists('README.md')" />
+        <None Include="..\..\Images\nuget.png" Pack="true" PackagePath="" />
+        <None Include="..\..\LICENSE" Pack="true" PackagePath="" />
+    </ItemGroup>
+
+    <ItemGroup Condition="'$(IncludeSymbols)'=='true'">
+        <PackageReference Include="Microsoft.SourceLink.GitHub" Version="8.0.0" PrivateAssets="All"/>
+    </ItemGroup>
+</Project>
@@ -7,11 +7,12 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MQTTnet", "Source\MQTTnet\M
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{B3F60ECB-45BA-4C66-8903-8BB89CA67998}"
 	ProjectSection(SolutionItems) = preProject
+		.github\workflows\ci.yml = .github\workflows\ci.yml
 		CODE-OF-CONDUCT.md = CODE-OF-CONDUCT.md
+		Directory.Build.props = Directory.Build.props
 		LICENSE = LICENSE
 		README.md = README.md
 		Source\ReleaseNotes.md = Source\ReleaseNotes.md
-		.github\workflows\ci.yml = .github\workflows\ci.yml
 	EndProjectSection
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MQTTnet.AspNetCore", "Source\MQTTnet.AspnetCore\MQTTnet.AspNetCore.csproj", "{F10C4060-F7EE-4A83-919F-FF723E72F94A}"
@@ -32,6 +33,8 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MQTTnet.Extensions.TopicTem
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MQTTnet.Server", "Source\MQTTnet.Server\MQTTnet.Server.csproj", "{C876EFFD-C5AD-4E26-BD9F-4C48252C02BC}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MQTTnet.PowerShell", "Source\MQTTnet.PowerShell\MQTTnet.PowerShell.csproj", "{37B129C5-0231-4EB5-AF13-77959068911C}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -78,6 +81,10 @@ Global
 		{C876EFFD-C5AD-4E26-BD9F-4C48252C02BC}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{C876EFFD-C5AD-4E26-BD9F-4C48252C02BC}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{C876EFFD-C5AD-4E26-BD9F-4C48252C02BC}.Release|Any CPU.Build.0 = Release|Any CPU
+		{37B129C5-0231-4EB5-AF13-77959068911C}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{37B129C5-0231-4EB5-AF13-77959068911C}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{37B129C5-0231-4EB5-AF13-77959068911C}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{37B129C5-0231-4EB5-AF13-77959068911C}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -85,6 +92,4 @@ Global
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {07536672-5CBC-4BE3-ACE0-708A431A7894}
 	EndGlobalSection
-	GlobalSection(NestedProjects) = preSolution
-	EndGlobalSection
 EndGlobal
@@ -490,7 +490,7 @@ m/XriWr/Cq4h/JfB7NTsezVslgkBaoU=
        }
    }

-    class SampleClientKerberosAuthenticationHandler : IMqttEnhancedAuthenticationHandler
+    sealed class SampleClientKerberosAuthenticationHandler : IMqttEnhancedAuthenticationHandler
    {
        public async Task HandleEnhancedAuthenticationAsync(MqttEnhancedAuthenticationEventArgs eventArgs)
        {
@@ -142,7 +142,7 @@ public static class Client_Subscribe_Samples
        response.DumpToConsole();
    }

-    static void ConcurrentProcessingDisableAutoAcknowledge(CancellationToken shutdownToken, IMqttClient mqttClient)
+    static void ConcurrentProcessingDisableAutoAcknowledge(IMqttClient mqttClient, CancellationToken shutdownToken)
    {
        /*
         * This sample shows how to achieve concurrent processing and not have message AutoAcknowledged
@@ -170,7 +170,7 @@ public static class Client_Subscribe_Samples
        };
    }

-    static void ConcurrentProcessingWithLimit(CancellationToken shutdownToken, IMqttClient mqttClient)
+    static void ConcurrentProcessingWithLimit(IMqttClient mqttClient, CancellationToken shutdownToken)
    {
        /*
         * This sample shows how to achieve concurrent processing, with:
@@ -6,6 +6,7 @@
 // ReSharper disable UnusedMember.Global
 // ReSharper disable InconsistentNaming

+using System.Globalization;
 using System.Text;
 using MQTTnet.Diagnostics.Logger;

@@ -51,7 +52,7 @@ public static class Logger_Samples
        mqttEventLogger.LogMessagePublished += (_, args) =>
        {
            var output = new StringBuilder();
-            output.AppendLine($">> [{args.LogMessage.Timestamp:O}] [{args.LogMessage.ThreadId}] [{args.LogMessage.Source}] [{args.LogMessage.Level}]: {args.LogMessage.Message}");
+            output.AppendLine(CultureInfo.InvariantCulture, $">> [{args.LogMessage.Timestamp:O}] [{args.LogMessage.ThreadId}] [{args.LogMessage.Source}] [{args.LogMessage.Level}]: {args.LogMessage.Message}");
            if (args.LogMessage.Exception != null)
            {
                output.AppendLine(args.LogMessage.Exception.ToString());
@@ -8,17 +8,19 @@ namespace MQTTnet.Samples.Helpers;

 internal static class ObjectExtensions
 {
+    static readonly JsonSerializerOptions SerializerOptions = new()
+    {
+        WriteIndented = true
+    };
+
    public static TObject DumpToConsole<TObject>(this TObject @object)
    {
        var output = "NULL";
        if (@object != null)
        {
-            output = JsonSerializer.Serialize(@object, new JsonSerializerOptions
-            {
-                WriteIndented = true
-            });
+            output = JsonSerializer.Serialize(@object, SerializerOptions);
        }
-        
+
        Console.WriteLine($"[{@object?.GetType().Name}]:\r\n{output}");
        return @object;
    }
@@ -2,20 +2,10 @@

    <PropertyGroup>
        <OutputType>Exe</OutputType>
-        <TargetFramework>net8.0</TargetFramework>
        <ImplicitUsings>enable</ImplicitUsings>
        <Nullable>enable</Nullable>
        <IsPackable>false</IsPackable>
-        <DisableImplicitAspNetCoreAnalyzers>true</DisableImplicitAspNetCoreAnalyzers>
-        <EnableNETAnalyzers>false</EnableNETAnalyzers>
-        <EnforceCodeStyleInBuild>false</EnforceCodeStyleInBuild>
-        <NoWarn>1591;NETSDK1138;NU1803;NU1901;NU1902</NoWarn>
-        <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
-        <NuGetAuditMode>all</NuGetAuditMode>
-        <NuGetAudit>true</NuGetAudit>
-        <NuGetAuditLevel>low</NuGetAuditLevel>
-        <AnalysisLevel>latest-Recommended</AnalysisLevel>
-        <LangVersion>default</LangVersion>
+        <NoWarn>$(NoWarn);CA1707</NoWarn>
    </PropertyGroup>

    <ItemGroup>
@@ -2,6 +2,7 @@
 // The .NET Foundation licenses this file to you under the MIT license.
 // See the LICENSE file in the project root for more information.

+using System.Globalization;
 using System.Reflection;

 Console.BackgroundColor = ConsoleColor.White;
@@ -28,7 +29,7 @@ Console.Write("Please choose sample class (press Enter to continue): ");
 Console.ResetColor();

 var input = Console.ReadLine();
-var selectedIndex = int.Parse(input ?? "0");
+var selectedIndex = int.Parse(input ?? "0", CultureInfo.InvariantCulture);
 var selectedSampleClass = sampleClasses[selectedIndex];
 var sampleMethods = selectedSampleClass.GetMethods(BindingFlags.Static | BindingFlags.Public).OrderBy(m => m.Name).ToList();

@@ -45,7 +46,7 @@ Console.Write("Please choose sample (press Enter to continue): ");
 Console.ResetColor();

 input = Console.ReadLine();
-selectedIndex = int.Parse(input ?? "0");
+selectedIndex = int.Parse(input ?? "0", CultureInfo.InvariantCulture);
 var selectedSampleMethod = sampleMethods[selectedIndex];

 Console.WriteLine();
@@ -58,7 +59,7 @@ try
 {
    if (selectedSampleMethod.Invoke(null, null) is Task task)
    {
-        await task;    
+        await task;
    }
 }
 catch (Exception exception)
@@ -8,6 +8,7 @@
 // ReSharper disable EmptyConstructor
 // ReSharper disable MemberCanBeMadeStatic.Local

+using System.Diagnostics.CodeAnalysis;
 using Microsoft.AspNetCore.Builder;
 using Microsoft.AspNetCore.Hosting;
 using Microsoft.Extensions.DependencyInjection;
@@ -52,14 +53,14 @@ public static class Server_ASP_NET_Samples
            // Inject other services via constructor.
        }

-        public Task OnClientConnected(ClientConnectedEventArgs eventArgs)
+        public static Task OnClientConnected(ClientConnectedEventArgs eventArgs)
        {
            Console.WriteLine($"Client '{eventArgs.ClientId}' connected.");
            return Task.CompletedTask;
        }


-        public Task ValidateConnection(ValidatingConnectionEventArgs eventArgs)
+        public static Task ValidateConnection(ValidatingConnectionEventArgs eventArgs)
        {
            Console.WriteLine($"Client '{eventArgs.ClientId}' wants to connect. Accepting!");
            return Task.CompletedTask;
@@ -68,6 +69,7 @@ public static class Server_ASP_NET_Samples

    sealed class Startup
    {
+        [SuppressMessage("Performance", "CA1822:Mark members as static")]
        public void Configure(IApplicationBuilder app, IWebHostEnvironment environment, MqttController mqttController)
        {
            app.UseRouting();
@@ -88,11 +90,12 @@ public static class Server_ASP_NET_Samples
                     * Attach event handlers etc. if required.
                     */

-                    server.ValidatingConnectionAsync += mqttController.ValidateConnection;
-                    server.ClientConnectedAsync += mqttController.OnClientConnected;
+                    server.ValidatingConnectionAsync += MqttController.ValidateConnection;
+                    server.ClientConnectedAsync += MqttController.OnClientConnected;
                });
        }

+        [SuppressMessage("Performance", "CA1822:Mark members as static")]
        public void ConfigureServices(IServiceCollection services)
        {
            services.AddHostedMqttServer(
@@ -9,6 +9,7 @@
 // ReSharper disable MemberCanBeMadeStatic.Local

 using MQTTnet.Internal;
+using MQTTnet.Protocol;
 using MQTTnet.Server;

 namespace MQTTnet.Samples.Server;
@@ -42,4 +43,32 @@ public static class Server_Intercepting_Samples
        Console.ReadLine();
        await mqttServer.StopAsync();
    }
+
+    public static async Task Intercept_Subscription()
+    {
+        /*
+         * This sample starts a simple MQTT server which does not allow to subscribe to '#'
+         * Start the server and try to subscribe to '#' with a client of choice.
+         */
+
+        var mqttServerFactory = new MqttServerFactory();
+        var mqttServerOptions = new MqttServerOptionsBuilder().WithDefaultEndpoint().Build();
+
+        using var mqttServer = mqttServerFactory.CreateMqttServer(mqttServerOptions);
+        mqttServer.InterceptingSubscriptionAsync += args =>
+        {
+            if (args.TopicFilter.Topic.Equals("#", StringComparison.Ordinal))
+            {
+                args.Response.ReasonCode = MqttSubscribeReasonCode.NotAuthorized;
+            }
+
+            return CompletedTask.Instance;
+        };
+
+        await mqttServer.StartAsync();
+
+        Console.WriteLine("Press Enter to exit.");
+        Console.ReadLine();
+        await mqttServer.StopAsync();
+    }
 }
@@ -6,6 +6,7 @@
 // ReSharper disable UnusedMember.Global
 // ReSharper disable InconsistentNaming

+using System.Globalization;
 using MQTTnet.Diagnostics.Logger;
 using MQTTnet.Protocol;
 using MQTTnet.Server;
@@ -161,7 +162,7 @@ public static class Server_Simple_Samples
        return server;
    }

-    class ConsoleLogger : IMqttNetLogger
+    sealed class ConsoleLogger : IMqttNetLogger
    {
        readonly object _consoleSyncRoot = new();

@@ -191,7 +192,7 @@ public static class Server_Simple_Samples

            if (parameters?.Length > 0)
            {
-                message = string.Format(message, parameters);
+                message = string.Format(CultureInfo.InvariantCulture, message, parameters);
            }

            lock (_consoleSyncRoot)
@@ -1,19 +1,10 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">

    <PropertyGroup>
-        <TargetFramework>net8.0</TargetFramework>
        <Nullable>enable</Nullable>
        <ImplicitUsings>enable</ImplicitUsings>
        <IsPackable>false</IsPackable>
-        <DisableImplicitAspNetCoreAnalyzers>true</DisableImplicitAspNetCoreAnalyzers>
-        <EnableNETAnalyzers>false</EnableNETAnalyzers>
-        <EnforceCodeStyleInBuild>false</EnforceCodeStyleInBuild>
-        <NoWarn>1591;NETSDK1138;NU1803;NU1901;NU1902</NoWarn>
-        <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
-        <NuGetAuditMode>all</NuGetAuditMode>
-        <NuGetAudit>true</NuGetAudit>
-        <NuGetAuditLevel>low</NuGetAuditLevel>
-        <AnalysisLevel>latest-Recommended</AnalysisLevel>
+        <NoWarn>$(NoWarn);CA1707</NoWarn>
    </PropertyGroup>

    <ItemGroup>
@@ -6,7 +6,7 @@ using Microsoft.AspNetCore.Mvc.RazorPages;

 namespace MQTTnet.AspTestApp.Pages;

-public class IndexModel : PageModel
+public partial class IndexModel : PageModel
 {
    readonly ILogger<IndexModel> _logger;

@@ -17,6 +17,9 @@ public class IndexModel : PageModel

    public void OnGet()
    {
-        _logger.LogDebug("OnGet");
+        LogOnGet();
    }
+
+    [LoggerMessage(Level = LogLevel.Information, Message = "OnGet")]
+    private partial void LogOnGet();
 }
@@ -1,61 +1,23 @@
 <Project Sdk="Microsoft.NET.Sdk">

    <PropertyGroup>
-        <TargetFramework>net8.0</TargetFramework>
        <AssemblyName>MQTTnet.AspNetCore</AssemblyName>
        <RootNamespace>MQTTnet.AspNetCore</RootNamespace>
-        <GeneratePackageOnBuild>True</GeneratePackageOnBuild>
-        <Company>The contributors of MQTTnet</Company>
-        <Product>MQTTnet</Product>
-        <Description>MQTTnet is a high performance .NET library for MQTT based communication. It provides a MQTT client and a MQTT server (broker) and supports v3.1.0, v3.1.1 and v5.0.0 of the MQTT protocol.</Description>
-        <Authors>The contributors of MQTTnet</Authors>
-        <PackageId>MQTTnet.AspNetCore</PackageId>
-        <SignAssembly>false</SignAssembly>
-        <DelaySign>false</DelaySign>
-        <PublishRepositoryUrl>true</PublishRepositoryUrl>
-        <IncludeSymbols>true</IncludeSymbols>
-        <SymbolPackageFormat>snupkg</SymbolPackageFormat>
-        <Copyright>Copyright (c) .NET Foundation and Contributors</Copyright>
-        <PackageProjectUrl>https://github.com/dotnet/MQTTnet</PackageProjectUrl>
-        <RepositoryUrl>https://github.com/dotnet/MQTTnet.git</RepositoryUrl>
-        <RepositoryType>git</RepositoryType>
-        <PackageTags>MQTT Message Queue Telemetry Transport MQTTClient MQTTServer Server MQTTBroker Broker NETStandard IoT InternetOfThings Messaging Hardware Arduino Sensor Actuator M2M ESP Smart Home Cities Automation Xamarin Blazor</PackageTags>
-        <NeutralLanguage>en-US</NeutralLanguage>
-        <EnableNETAnalyzers>false</EnableNETAnalyzers>
-        <EnforceCodeStyleInBuild>false</EnforceCodeStyleInBuild>
-        <PackageIcon>nuget.png</PackageIcon>
-        <EmbedUntrackedSources>true</EmbedUntrackedSources>
-        <ContinuousIntegrationBuild>true</ContinuousIntegrationBuild>
-        <PackageLicenseFile>LICENSE</PackageLicenseFile>
-        <PackageReleaseNotes>For release notes please go to MQTTnet release notes (https://www.nuget.org/packages/MQTTnet/).</PackageReleaseNotes>
-        <DisableImplicitAspNetCoreAnalyzers>true</DisableImplicitAspNetCoreAnalyzers>
-        <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
-        <GenerateDocumentationFile>true</GenerateDocumentationFile>
-        <NoWarn>1591;NETSDK1138;NU1803;NU1901;NU1902</NoWarn>
-        <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
-        <NuGetAuditMode>all</NuGetAuditMode>
-        <NuGetAudit>true</NuGetAudit>
-        <NuGetAuditLevel>low</NuGetAuditLevel>
-        <NuGetAuditLevel>low</NuGetAuditLevel>
-        <AnalysisLevel>latest-Recommended</AnalysisLevel>
        <IsAotCompatible>true</IsAotCompatible>
-        <LangVersion>default</LangVersion>
-        <Nullable>enable</Nullable>
+
+        <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
+        <Description>MQTTnet is a high performance .NET library for MQTT based communication. It provides a MQTT client and a MQTT server (broker) and supports v3.1.0, v3.1.1 and v5.0.0 of the MQTT protocol.</Description>
+        <PackageId>MQTTnet.AspNetCore</PackageId>
+        <PackageTags>MQTT Message Queue Telemetry Transport MQTTClient MQTTServer Server MQTTBroker Broker NETStandard IoT InternetOfThings Messaging Hardware Arduino Sensor Actuator M2M ESP Smart Home Cities Automation Xamarin Blazor</PackageTags>
+        <PackageReleaseNotes>For release notes please go to MQTTnet release notes (https://www.nuget.org/packages/MQTTnet/).</PackageReleaseNotes>
+
+        <GenerateDocumentationFile>true</GenerateDocumentationFile>
    </PropertyGroup>

    <ItemGroup>
-        <None Include="..\..\Images\nuget.png" Pack="true" PackagePath="" />
-        <None Include="..\..\LICENSE" Pack="true" PackagePath="" />
-    </ItemGroup>
-
-    <ItemGroup>
-        <PackageReference Include="Microsoft.SourceLink.GitHub" Version="8.0.0" PrivateAssets="All"/>
        <FrameworkReference Include="Microsoft.AspNetCore.App"/>
    </ItemGroup>

-    <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release'">
-    </PropertyGroup>
-
    <ItemGroup>
        <ProjectReference Include="..\MQTTnet.Server\MQTTnet.Server.csproj"/>
        <ProjectReference Include="..\MQTTnet\MQTTnet.csproj"/>
@@ -13,7 +13,7 @@ public sealed class MqttClientConnectionContextFactory : IMqttClientAdapterFacto
 {
    public IMqttChannelAdapter CreateClientAdapter(MqttClientOptions options, MqttPacketInspector packetInspector, IMqttNetLogger logger)
    {
-        if (options == null) throw new ArgumentNullException(nameof(options));
+        ArgumentNullException.ThrowIfNull(options);

        switch (options.ChannelOptions)
        {
@@ -61,27 +61,6 @@ public sealed class MqttConnectionContext : IMqttChannelAdapter
        }
    }

-    public EndPoint RemoteEndPoint
-    {
-        get
-        {
-            // mqtt over tcp
-            if (_connection.RemoteEndPoint != null)
-            {
-                return _connection.RemoteEndPoint;
-            }
-
-            // mqtt over websocket
-            var httpFeature = _connection.Features.Get<IHttpConnectionFeature>();
-            if (httpFeature?.RemoteIpAddress != null)
-            {
-                return new IPEndPoint(httpFeature.RemoteIpAddress, httpFeature.RemotePort);
-            }
-
-            return null;
-        }
-    }
-
    public bool IsSecureConnection
    {
        get
@@ -104,8 +83,50 @@ public sealed class MqttConnectionContext : IMqttChannelAdapter
        }
    }

+    public EndPoint LocalEndPoint
+    {
+        get
+        {
+            // mqtt over tcp
+            if (_connection.LocalEndPoint != null)
+            {
+                return _connection.LocalEndPoint;
+            }
+
+            // mqtt over websocket
+            var httpFeature = _connection.Features.Get<IHttpConnectionFeature>();
+            if (httpFeature?.LocalIpAddress != null)
+            {
+                return new IPEndPoint(httpFeature.LocalIpAddress, httpFeature.LocalPort);
+            }
+
+            return null;
+        }
+    }
+
    public MqttPacketFormatterAdapter PacketFormatterAdapter { get; }

+    public EndPoint RemoteEndPoint
+    {
+        get
+        {
+            // mqtt over tcp
+            if (_connection.RemoteEndPoint != null)
+            {
+                return _connection.RemoteEndPoint;
+            }
+
+            // mqtt over websocket
+            var httpFeature = _connection.Features.Get<IHttpConnectionFeature>();
+            if (httpFeature?.RemoteIpAddress != null)
+            {
+                return new IPEndPoint(httpFeature.RemoteIpAddress, httpFeature.RemotePort);
+            }
+
+            return null;
+        }
+    }
+
    public async Task ConnectAsync(CancellationToken cancellationToken)
    {
        if (_connection is SocketConnection tcp && !tcp.IsConnected)
@@ -232,8 +253,8 @@ public sealed class MqttConnectionContext : IMqttChannelAdapter
        var span = output.GetSpan(buffer.Length);

        buffer.Packet.AsSpan().CopyTo(span);
-        int offset = buffer.Packet.Count;
-        buffer.Payload.CopyTo(destination: span.Slice(offset));
+        var offset = buffer.Packet.Count;
+        buffer.Payload.CopyTo(span.Slice(offset));
        output.Advance(buffer.Length);
    }
 }
@@ -29,6 +29,6 @@ public static class MqttSubProtocolSelector
        ArgumentNullException.ThrowIfNull(requestedSubProtocolValues);

        // Order the protocols to also match "mqtt", "mqttv-3.1", "mqttv-3.11" etc.
-        return requestedSubProtocolValues.OrderByDescending(p => p.Length).FirstOrDefault(p => p.ToLower().StartsWith("mqtt"));
+        return requestedSubProtocolValues.OrderByDescending(p => p.Length).FirstOrDefault(p => p.ToLowerInvariant().StartsWith("mqtt", StringComparison.InvariantCulture));
    }
 }
@@ -81,7 +81,7 @@ public sealed class SocketConnection : ConnectionContext
        IsConnected = true;
    }

-    static Exception ConnectionAborted()
+    static MqttCommunicationException ConnectionAborted()
    {
        return new MqttCommunicationException("Connection Aborted");
    }
@@ -218,12 +218,16 @@ public sealed class SocketConnection : ConnectionContext

            var flushTask = _application.Output.FlushAsync();

+            FlushResult result;
            if (!flushTask.IsCompleted)
            {
-                await flushTask;
+                result = await flushTask;
+            }
+            else
+            {
+                result = flushTask.GetAwaiter().GetResult();
            }

-            var result = flushTask.GetAwaiter().GetResult();
            if (result.IsCompleted)
            {
                // Pipe consumer is shut down, do we stop writing
@@ -8,7 +8,7 @@ using System.Net.Sockets;

 namespace MQTTnet.AspNetCore;

-public sealed class SocketReceiver
+public sealed class SocketReceiver : IDisposable
 {
    readonly SocketAwaitable _awaitable;
    readonly SocketAsyncEventArgs _eventArgs = new();
@@ -33,4 +33,9 @@ public sealed class SocketReceiver

        return _awaitable;
    }
+
+    public void Dispose()
+    {
+        _eventArgs.Dispose();
+    }
 }
@@ -12,7 +12,7 @@ using System.Runtime.InteropServices;

 namespace MQTTnet.AspNetCore;

-public sealed class SocketSender
+public sealed class SocketSender : IDisposable
 {
    readonly SocketAwaitable _awaitable;
    readonly SocketAsyncEventArgs _eventArgs = new();
@@ -28,6 +28,11 @@ public sealed class SocketSender
        _eventArgs.Completed += (_, e) => ((SocketAwaitable)e.UserToken).Complete(e.BytesTransferred, e.SocketError);
    }

+    public void Dispose()
+    {
+        _eventArgs.Dispose();
+    }
+
    public SocketAwaitable SendAsync(in ReadOnlySequence<byte> buffers)
    {
        if (buffers.IsSingleSegment)
@@ -43,7 +43,7 @@ public class AsyncLockBenchmark : BaseBenchmark

        if (globalI != tasksCount)
        {
-            throw new Exception($"Code is broken ({globalI})!");
+            throw new InvalidOperationException($"Code is broken ({globalI})!");
        }
    }

@@ -15,7 +15,7 @@ using MQTTnet.Tests.Mockups;
 namespace MQTTnet.Benchmarks;

 [MemoryDiagnoser]
-public sealed class ChannelAdapterBenchmark : BaseBenchmark
+public sealed class ChannelAdapterBenchmark : BaseBenchmark, IDisposable
 {
    MqttChannelAdapter _channelAdapter;
    int _iterations;
@@ -86,4 +86,10 @@ public sealed class ChannelAdapterBenchmark : BaseBenchmark

        return buffer.ToArray();
    }
+
+    public void Dispose()
+    {
+        _channelAdapter?.Dispose();
+        _stream?.Dispose();
+    }
 }
@@ -1,20 +1,11 @@
 <Project Sdk="Microsoft.NET.Sdk">

    <PropertyGroup>
-        <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
        <OutputType>Exe</OutputType>
        <DebugType>Full</DebugType>
-        <TargetFramework>net8.0</TargetFramework>
        <IsPackable>false</IsPackable>
-        <EnableNETAnalyzers>false</EnableNETAnalyzers>
-        <EnforceCodeStyleInBuild>false</EnforceCodeStyleInBuild>
-        <DisableImplicitAspNetCoreAnalyzers>true</DisableImplicitAspNetCoreAnalyzers>
-        <NoWarn>1591;NETSDK1138;NU1803;NU1901;NU1902;CS8892</NoWarn>
+        <NoWarn>$(NoWarn);CS8892;CA1707;CA1051;CA1822</NoWarn>
        <TreatWarningsAsErrors>false</TreatWarningsAsErrors>
-        <NuGetAuditMode>all</NuGetAuditMode>
-        <NuGetAudit>true</NuGetAudit>
-        <NuGetAuditLevel>low</NuGetAuditLevel>
-        <AnalysisLevel>latest-Recommended</AnalysisLevel>
    </PropertyGroup>

    <ItemGroup>
@@ -2,10 +2,6 @@
 // The .NET Foundation licenses this file to you under the MIT license.
 // See the LICENSE file in the project root for more information.

-using System;
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
 using BenchmarkDotNet.Attributes;
 using MQTTnet.Packets;
 using MQTTnet.Server;
@@ -13,7 +9,7 @@ using MQTTnet.Server;
 namespace MQTTnet.Benchmarks;

 [MemoryDiagnoser]
-public class MessageDeliveryBenchmark : BaseBenchmark
+public sealed class MessageDeliveryBenchmark : BaseBenchmark, IDisposable
 {
    List<string> _allSubscribedTopics; // Keep track of the subset of topics that are subscribed
    CancellationTokenSource _cancellationTokenSource;
@@ -99,10 +95,16 @@ public class MessageDeliveryBenchmark : BaseBenchmark

        if (_messagesReceivedCount < _messagesExpectedCount)
        {
-            throw new Exception($"Messages Received Count mismatch, expected {_messagesExpectedCount}, received {_messagesReceivedCount}");
+            throw new InvalidOperationException($"Messages Received Count mismatch, expected {_messagesExpectedCount}, received {_messagesReceivedCount}");
        }
    }

+    public void Dispose()
+    {
+        _cancellationTokenSource?.Dispose();
+        _mqttServer?.Dispose();
+    }
+
    [GlobalSetup]
    public void Setup()
    {
@@ -173,7 +175,7 @@ public class MessageDeliveryBenchmark : BaseBenchmark
        var topicIndexStep = totalNumTopics / (_numSubscribedTopicsPerSubscriber * _numSubscribers);
        if (topicIndexStep * _numSubscribedTopicsPerSubscriber * _numSubscribers != totalNumTopics)
        {
-            throw new Exception(
+            throw new InvalidOperationException(
                $"The total number of topics must be divisible by the number of subscribed topics across all subscribers. Total number of topics: {totalNumTopics}, topic step: {topicIndexStep}");
        }

@@ -4,8 +4,6 @@

 using System.Buffers;
 using System.Reflection;
-using System.Threading;
-using System.Threading.Tasks;
 using BenchmarkDotNet.Attributes;
 using BenchmarkDotNet.Jobs;
 using MQTTnet.Channel;
@@ -18,9 +16,9 @@ namespace MQTTnet.Benchmarks;

 [SimpleJob(RuntimeMoniker.Net60)]
 [MemoryDiagnoser]
-public class MqttTcpChannelBenchmark : BaseBenchmark
+public sealed class MqttTcpChannelBenchmark : BaseBenchmark, IDisposable
 {
-    IMqttChannel _clientChannel;
+    MqttTcpChannel _clientChannel;
    MqttServer _mqttServer;
    IMqttChannel _serverChannel;

@@ -84,4 +82,11 @@ public class MqttTcpChannelBenchmark : BaseBenchmark
            await _serverChannel.WriteAsync(buffer, true, CancellationToken.None).ConfigureAwait(false);
        }
    }
+
+    public void Dispose()
+    {
+        _clientChannel?.Dispose();
+        _mqttServer?.Dispose();
+        _serverChannel?.Dispose();
+    }
 }
@@ -92,7 +92,7 @@ public static class Program
            return;
        }

-        _selectedBenchmarkIndex = _benchmarks.FindIndex(b => b.Name.Equals(arguments[0]));
+        _selectedBenchmarkIndex = _benchmarks.FindIndex(b => b.Name.Equals(arguments[0], StringComparison.Ordinal));

        if (_selectedBenchmarkIndex < 0)
        {
@@ -13,7 +13,7 @@ namespace MQTTnet.Benchmarks;
 [SimpleJob(RuntimeMoniker.Net60)]
 [RPlotExporter, RankColumn]
 [MemoryDiagnoser]
-public class ReaderExtensionsBenchmark
+public sealed class ReaderExtensionsBenchmark : IDisposable, IAsyncDisposable
 {
    MqttPacketFormatterAdapter _mqttPacketFormatter;
    MemoryStream _stream;
@@ -83,4 +83,17 @@ public class ReaderExtensionsBenchmark
            }
        }
    }
+
+    public void Dispose()
+    {
+        _stream?.Dispose();
+    }
+
+    public async ValueTask DisposeAsync()
+    {
+        if (_stream != null)
+        {
+            await _stream.DisposeAsync();
+        }
+    }
 }
@@ -1,39 +1,19 @@
+using System.Buffers;
+using System.IO.Pipelines;
 using BenchmarkDotNet.Attributes;
 using BenchmarkDotNet.Jobs;
 using MQTTnet.Formatter;
-using System;
-using System.Buffers;
-using System.IO;
-using System.IO.Pipelines;
-using System.Threading.Tasks;

 namespace MQTTnet.Benchmarks;

 [SimpleJob(RuntimeMoniker.Net60)]
-[RPlotExporter, RankColumn]
+[RPlotExporter]
+[RankColumn]
 [MemoryDiagnoser]
-public class SendPacketAsyncBenchmark : BaseBenchmark
+public sealed class SendPacketAsyncBenchmark : BaseBenchmark, IDisposable, IAsyncDisposable
 {
-    MemoryStream _stream;
    MqttPacketBuffer _buffer;
-
-    [GlobalSetup]
-    public void GlobalSetup()
-    {
-        _stream = new MemoryStream(1024);
-        var packet = new ArraySegment<byte>(new byte[10]);
-        _buffer = new MqttPacketBuffer(packet);
-    }
-
-    [Benchmark(Baseline = true)]
-    public async ValueTask Before()
-    {
-        _stream.Position = 0;
-        var output = PipeWriter.Create(_stream);
-
-        WritePacketBuffer(output, _buffer);
-        await output.FlushAsync();
-    }
+    MemoryStream _stream;

    [Benchmark]
    public async ValueTask After()
@@ -52,6 +32,37 @@ public class SendPacketAsyncBenchmark : BaseBenchmark
        }
    }

+    [Benchmark(Baseline = true)]
+    public async ValueTask Before()
+    {
+        _stream.Position = 0;
+        var output = PipeWriter.Create(_stream);
+
+        WritePacketBuffer(output, _buffer);
+        await output.FlushAsync();
+    }
+
+    public void Dispose()
+    {
+        _stream?.Dispose();
+    }
+
+    public async ValueTask DisposeAsync()
+    {
+        if (_stream != null)
+        {
+            await _stream.DisposeAsync();
+        }
+    }
+
+    [GlobalSetup]
+    public void GlobalSetup()
+    {
+        _stream = new MemoryStream(1024);
+        var packet = new ArraySegment<byte>(new byte[10]);
+        _buffer = new MqttPacketBuffer(packet);
+    }
+
    static void WritePacketBuffer(PipeWriter output, MqttPacketBuffer buffer)
    {
        // copy MqttPacketBuffer's Packet and Payload to the same buffer block of PipeWriter
@@ -26,7 +26,7 @@ public class SerializerBenchmark : BaseBenchmark
 {
    MqttPacket _packet;
    ArraySegment<byte> _serializedPacket;
-    IMqttPacketFormatter _serializer;
+    MqttV3PacketFormatter _serializer;
    MqttBufferWriter _bufferWriter;

    [GlobalSetup]
@@ -43,7 +43,7 @@ public class SerializerBenchmark : BaseBenchmark
    }

    [Benchmark]
-    public void Serialize_10000_Messages()
+    public void Serialize10000Messages()
    {
        for (var i = 0; i < 10000; i++)
        {
@@ -53,7 +53,7 @@ public class SerializerBenchmark : BaseBenchmark
    }

    [Benchmark]
-    public void Deserialize_10000_Messages()
+    public void Deserialize10000Messages()
    {
        var channel = new BenchmarkMqttChannel(_serializedPacket);
        var reader = new MqttChannelAdapter(channel, new MqttPacketFormatterAdapter(new MqttBufferWriter(4096, 65535)), new MqttNetEventLogger());
@@ -66,7 +66,7 @@ public class SerializerBenchmark : BaseBenchmark
        }
    }

-    class BenchmarkMqttChannel : IMqttChannel
+    sealed class BenchmarkMqttChannel : IMqttChannel
    {
        readonly ArraySegment<byte> _buffer;
        int _position;
@@ -79,7 +79,9 @@ public class SerializerBenchmark : BaseBenchmark

        public EndPoint RemoteEndPoint { get; set; }

-        public bool IsSecureConnection { get; } = false;
+        public EndPoint LocalEndPoint { get; set; }
+
+        public bool IsSecureConnection { get; }

        public X509Certificate2 ClientCertificate { get; set; }

@@ -12,7 +12,7 @@ public sealed class DefaultMqttRpcClientTopicGenerationStrategy : IMqttRpcClient
    {
        ArgumentNullException.ThrowIfNull(context);

-        if (context.MethodName.Contains("/") || context.MethodName.Contains("+") || context.MethodName.Contains("#"))
+        if (context.MethodName.Contains('/') || context.MethodName.Contains('+') || context.MethodName.Contains('#'))
        {
            throw new ArgumentException("The method name cannot contain /, + or #.");
        }
@@ -12,12 +12,7 @@ namespace MQTTnet.Extensions.Rpc;

 public interface IMqttRpcClient : IDisposable
 {
-    Task<byte[]> ExecuteAsync(TimeSpan timeout, string methodName, byte[] payload, MqttQualityOfServiceLevel qualityOfServiceLevel, IDictionary<string, object>? parameters = null);
+    Task<byte[]> ExecuteAsync(TimeSpan timeout, string methodName, byte[] payload, MqttQualityOfServiceLevel qualityOfServiceLevel, IDictionary<string,object> parameters = null);

-    Task<byte[]> ExecuteAsync(
-        string methodName,
-        byte[] payload,
-        MqttQualityOfServiceLevel qualityOfServiceLevel,
-        IDictionary<string, object>? parameters = null,
-        CancellationToken cancellationToken = default);
+    Task<byte[]> ExecuteAsync(string methodName, byte[] payload, MqttQualityOfServiceLevel qualityOfServiceLevel, IDictionary<string, object> parameters = null, CancellationToken cancellationToken = default);
 }
@@ -1,55 +1,19 @@
 <Project Sdk="Microsoft.NET.Sdk">

    <PropertyGroup>
-        <TargetFramework>net8.0</TargetFramework>
        <AssemblyName>MQTTnet.Extensions.Rpc</AssemblyName>
        <RootNamespace>MQTTnet.Extensions.Rpc</RootNamespace>
-        <GeneratePackageOnBuild>True</GeneratePackageOnBuild>
-        <Company>The contributors of MQTTnet</Company>
-        <Product>MQTTnet</Product>
-        <Description>This is an extension library which allows executing synchronous device calls including a response using MQTTnet.</Description>
-        <Authors>The contributors of MQTTnet</Authors>
-        <PackageId>MQTTnet.Extensions.Rpc</PackageId>
-        <SignAssembly>false</SignAssembly>
-        <DelaySign>false</DelaySign>
-        <PublishRepositoryUrl>true</PublishRepositoryUrl>
-        <IncludeSymbols>true</IncludeSymbols>
-        <SymbolPackageFormat>snupkg</SymbolPackageFormat>
-        <Copyright>Copyright (c) .NET Foundation and Contributors</Copyright>
-        <PackageProjectUrl>https://github.com/dotnet/MQTTnet</PackageProjectUrl>
-        <RepositoryUrl>https://github.com/dotnet/MQTTnet.git</RepositoryUrl>
-        <RepositoryType>git</RepositoryType>
-        <PackageTags>MQTT Message Queue Telemetry Transport MQTTClient MQTTServer Server MQTTBroker Broker NETStandard IoT InternetOfThings Messaging Hardware Arduino Sensor Actuator M2M ESP Smart Home Cities Automation Xamarin Blazor</PackageTags>
-        <NeutralLanguage>en-US</NeutralLanguage>
-        <EnableNETAnalyzers>false</EnableNETAnalyzers>
-        <EnforceCodeStyleInBuild>false</EnforceCodeStyleInBuild>
-        <PackageIcon>nuget.png</PackageIcon>
-        <EmbedUntrackedSources>true</EmbedUntrackedSources>
-        <ContinuousIntegrationBuild>true</ContinuousIntegrationBuild>
-        <PackageLicenseFile>LICENSE</PackageLicenseFile>
-        <PackageReleaseNotes>For release notes please go to MQTTnet release notes (https://www.nuget.org/packages/MQTTnet/).</PackageReleaseNotes>
-        <DisableImplicitAspNetCoreAnalyzers>true</DisableImplicitAspNetCoreAnalyzers>
-        <GenerateDocumentationFile>true</GenerateDocumentationFile>
-        <NoWarn>1591;NETSDK1138;NU1803;NU1901;NU1902</NoWarn>
-        <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
-        <NuGetAuditMode>all</NuGetAuditMode>
-        <NuGetAudit>true</NuGetAudit>
-        <NuGetAuditLevel>low</NuGetAuditLevel>
-        <AnalysisLevel>latest-Recommended</AnalysisLevel>
        <IsAotCompatible>true</IsAotCompatible>
-        <LangVersion>default</LangVersion>
-        <Nullable>enable</Nullable>
+
+        <GeneratePackageOnBuild>True</GeneratePackageOnBuild>
+        <Description>This is an extension library which allows executing synchronous device calls including a response using MQTTnet.</Description>
+        <PackageId>MQTTnet.Extensions.Rpc</PackageId>
+        <PackageTags>MQTT Message Queue Telemetry Transport MQTTClient MQTTServer Server MQTTBroker Broker NETStandard IoT InternetOfThings Messaging Hardware Arduino Sensor Actuator M2M ESP Smart Home Cities Automation Xamarin Blazor</PackageTags>
+        <EmbedUntrackedSources>true</EmbedUntrackedSources>
+        <PackageReleaseNotes>For release notes please go to MQTTnet release notes (https://www.nuget.org/packages/MQTTnet/).</PackageReleaseNotes>
+        <GenerateDocumentationFile>true</GenerateDocumentationFile>
    </PropertyGroup>

-    <ItemGroup>
-        <None Include="..\..\Images\nuget.png" Pack="true" PackagePath="" />
-        <None Include="..\..\LICENSE" Pack="true" PackagePath="" />
-    </ItemGroup>
-
-    <ItemGroup>
-        <PackageReference Include="Microsoft.SourceLink.GitHub" Version="8.0.0" PrivateAssets="All"/>
-    </ItemGroup>
-
    <ItemGroup>
        <ProjectReference Include="..\MQTTnet\MQTTnet.csproj"/>
    </ItemGroup>
@@ -20,7 +20,7 @@ public sealed class MqttRpcClient : IMqttRpcClient
    readonly IMqttClient _mqttClient;
    readonly MqttRpcClientOptions _options;

-    readonly ConcurrentDictionary<string, AsyncTaskCompletionSource<byte[]>> _waitingCalls = new();
+    readonly ConcurrentDictionary<string, AsyncTaskCompletionSource<byte[]>> _waitingCalls = new ConcurrentDictionary<string, AsyncTaskCompletionSource<byte[]>>();

    public MqttRpcClient(IMqttClient mqttClient, MqttRpcClientOptions options)
    {
@@ -42,12 +42,7 @@ public sealed class MqttRpcClient : IMqttRpcClient
        _waitingCalls.Clear();
    }

-    public async Task<byte[]> ExecuteAsync(
-        TimeSpan timeout,
-        string methodName,
-        byte[] payload,
-        MqttQualityOfServiceLevel qualityOfServiceLevel,
-        IDictionary<string, object>? parameters = null)
+    public async Task<byte[]> ExecuteAsync(TimeSpan timeout, string methodName, byte[] payload, MqttQualityOfServiceLevel qualityOfServiceLevel, IDictionary<string, object> parameters = null)
    {
        using var timeoutToken = new CancellationTokenSource(timeout);
        try
@@ -65,12 +60,7 @@ public sealed class MqttRpcClient : IMqttRpcClient
        }
    }

-    public async Task<byte[]> ExecuteAsync(
-        string methodName,
-        byte[] payload,
-        MqttQualityOfServiceLevel qualityOfServiceLevel,
-        IDictionary<string, object>? parameters = null,
-        CancellationToken cancellationToken = default)
+    public async Task<byte[]> ExecuteAsync(string methodName, byte[] payload, MqttQualityOfServiceLevel qualityOfServiceLevel, IDictionary<string, object> parameters = null, CancellationToken cancellationToken = default)
    {
        ArgumentNullException.ThrowIfNull(methodName);

@@ -92,7 +82,7 @@ public sealed class MqttRpcClient : IMqttRpcClient

        var requestMessageBuilder = new MqttApplicationMessageBuilder().WithTopic(requestTopic).WithPayload(payload).WithQualityOfServiceLevel(qualityOfServiceLevel);

-        if (_mqttClient.Options!.ProtocolVersion == MqttProtocolVersion.V500)
+        if (_mqttClient.Options.ProtocolVersion == MqttProtocolVersion.V500)
        {
            requestMessageBuilder.WithResponseTopic(responseTopic);
        }
@@ -113,10 +103,11 @@ public sealed class MqttRpcClient : IMqttRpcClient
            await _mqttClient.SubscribeAsync(subscribeOptions, cancellationToken).ConfigureAwait(false);
            await _mqttClient.PublishAsync(requestMessage, cancellationToken).ConfigureAwait(false);

-            using (cancellationToken.Register(() =>
-                   {
-                       awaitable.TrySetCanceled();
-                   }))
+            using (cancellationToken.Register(
+                       () =>
+                       {
+                           awaitable.TrySetCanceled();
+                       }))
            {
                return await awaitable.Task.ConfigureAwait(false);
            }
@@ -12,9 +12,9 @@ namespace MQTTnet.Extensions.Rpc;

 public static class MqttRpcClientExtensions
 {
-    public static Task<byte[]> ExecuteAsync(this IMqttRpcClient client, TimeSpan timeout, string methodName, string payload, MqttQualityOfServiceLevel qualityOfServiceLevel, IDictionary<string,object>? parameters = null)
+    public static Task<byte[]> ExecuteAsync(this IMqttRpcClient client, TimeSpan timeout, string methodName, string payload, MqttQualityOfServiceLevel qualityOfServiceLevel, IDictionary<string,object> parameters = null)
    {
-        if (client == null) throw new ArgumentNullException(nameof(client));
+        ArgumentNullException.ThrowIfNull(client);

        var buffer = Encoding.UTF8.GetBytes(payload ?? string.Empty);

@@ -6,7 +6,7 @@ namespace MQTTnet.Extensions.Rpc;

 public sealed class MqttRpcTopicPair
 {
-    public required string RequestTopic { get; init; }
+    public string RequestTopic { get; set; }

-    public required string ResponseTopic { get; init; }
+    public string ResponseTopic { get; set; }
 }
@@ -10,12 +10,8 @@ namespace MQTTnet.Extensions.Rpc;

 public sealed class TopicGenerationContext
 {
-    public TopicGenerationContext(
-        IMqttClient mqttClient,
-        MqttRpcClientOptions options,
-        string methodName,
-        IDictionary<string, object>? parameters,
-        MqttQualityOfServiceLevel qualityOfServiceLevel)
+    public TopicGenerationContext(IMqttClient mqttClient, MqttRpcClientOptions options, string methodName,
+        IDictionary<string, object> parameters, MqttQualityOfServiceLevel qualityOfServiceLevel)
    {
        MethodName = methodName ?? throw new ArgumentNullException(nameof(methodName));
        Parameters = parameters;
@@ -26,12 +22,12 @@ public sealed class TopicGenerationContext

    public string MethodName { get; }

+    public IDictionary<string, object> Parameters { get; }
+
    public IMqttClient MqttClient { get; }

    public MqttRpcClientOptions Options { get; }

-    public IDictionary<string, object>? Parameters { get; }
-
    /// <summary>
    ///     Gets or sets the quality of service level.
    ///     The Quality of Service (QoS) level is an agreement between the sender of a message and the receiver of a message
@@ -1,56 +1,24 @@
 <Project Sdk="Microsoft.NET.Sdk">

    <PropertyGroup>
-        <TargetFramework>net8.0</TargetFramework>
        <AssemblyName>MQTTnet.Extensions.TopicTemplate</AssemblyName>
        <RootNamespace>MQTTnet.Extensions.TopicTemplate</RootNamespace>
+        <IsAotCompatible>true</IsAotCompatible>
+
        <GeneratePackageOnBuild>True</GeneratePackageOnBuild>
-        <Company>The contributors of MQTTnet</Company>
-        <Product>MQTTnet</Product>
        <Description>
           Provides mqtt topic templating logic to support dispatch,
           routing and similar functionality based on the well known moustache syntax (AsyncAPI compatible).
        </Description>
 		<PackageReadmeFile>README.md</PackageReadmeFile>
-        <Authors>The contributors of MQTTnet</Authors>
        <PackageId>MQTTnet.Extensions.TopicTemplate</PackageId>
-        <SignAssembly>false</SignAssembly>
-        <DelaySign>false</DelaySign>
-        <PublishRepositoryUrl>true</PublishRepositoryUrl>
-        <IncludeSymbols>true</IncludeSymbols>
-        <SymbolPackageFormat>snupkg</SymbolPackageFormat>
-        <Copyright>Copyright (c) .NET Foundation and Contributors</Copyright>
-        <PackageProjectUrl>https://github.com/dotnet/MQTTnet</PackageProjectUrl>
-        <RepositoryUrl>https://github.com/dotnet/MQTTnet.git</RepositoryUrl>
-        <RepositoryType>git</RepositoryType>
        <PackageTags>MQTT Message Queue Telemetry MQTTClient Messaging Routing AsyncAPI Template</PackageTags>
-        <NeutralLanguage>en-US</NeutralLanguage>
-        <PackageIcon>nuget.png</PackageIcon>
-        <EmbedUntrackedSources>true</EmbedUntrackedSources>
-        <ContinuousIntegrationBuild>true</ContinuousIntegrationBuild>
-        <PackageLicenseFile>LICENSE</PackageLicenseFile>
        <PackageReleaseNotes>For release notes please go to MQTTnet release notes (https://www.nuget.org/packages/MQTTnet/).</PackageReleaseNotes>
        <GenerateDocumentationFile>true</GenerateDocumentationFile>
-        <NoWarn>1591;NETSDK1138</NoWarn>
-        <IsAotCompatible>true</IsAotCompatible>
-        <LangVersion>default</LangVersion>
-        <Nullable>enable</Nullable>
+
    </PropertyGroup>

    <ItemGroup>
-        <None Include="README.md">
-            <Pack>True</Pack>
-            <PackagePath>\</PackagePath>
-        </None>
-    </ItemGroup>
-
-    <ItemGroup>
-        <None Include="..\..\Images\nuget.png" Pack="true" PackagePath="" />
-        <None Include="..\..\LICENSE" Pack="true" PackagePath="" />
-    </ItemGroup>
-
-    <ItemGroup>
-        <PackageReference Include="Microsoft.SourceLink.GitHub" Version="8.0.0" PrivateAssets="All" />
        <PackageReference Include="System.ValueTuple" Version="4.6.1" />
    </ItemGroup>

@@ -84,13 +84,13 @@ public sealed class MqttTopicTemplate : IEquatable<MqttTopicTemplate>
        {
            var filter = TopicFilter;
            // append slash if neccessary
-            if (filter.Length > 0 && !filter.EndsWith(MqttTopicFilterComparer.LevelSeparator.ToString()) && !filter.EndsWith(MqttTopicFilterComparer.MultiLevelWildcard.ToString()))
+            if (filter.Length > 0 && !filter.EndsWith(MqttTopicFilterComparer.LevelSeparator) && !filter.EndsWith(MqttTopicFilterComparer.MultiLevelWildcard))
            {
                filter += MqttTopicFilterComparer.LevelSeparator;
            }

            // append hash if neccessary
-            if (!filter.EndsWith(MqttTopicFilterComparer.MultiLevelWildcard.ToString()))
+            if (!filter.EndsWith(MqttTopicFilterComparer.MultiLevelWildcard))
            {
                filter += MqttTopicFilterComparer.MultiLevelWildcard;
            }
@@ -161,12 +161,12 @@ public sealed class MqttTopicTemplate : IEquatable<MqttTopicTemplate>
            return new MqttTopicTemplate(MqttTopicFilterComparer.MultiLevelWildcard.ToString());
        }

-        if (root.Contains(MqttTopicFilterComparer.LevelSeparator) && !root.EndsWith(MqttTopicFilterComparer.LevelSeparator.ToString()) && !root.EndsWith("}"))
+        if (root.Contains(MqttTopicFilterComparer.LevelSeparator) && !root.EndsWith(MqttTopicFilterComparer.LevelSeparator.ToString(), StringComparison.InvariantCulture) && !root.EndsWith('}'))
        {
            root = root.Substring(0, root.LastIndexOf(MqttTopicFilterComparer.LevelSeparator) + 1);
        }

-        if (root.EndsWith(MqttTopicFilterComparer.LevelSeparator.ToString()))
+        if (root.EndsWith(MqttTopicFilterComparer.LevelSeparator.ToString(), StringComparison.InvariantCulture))
        {
            root += MqttTopicFilterComparer.SingleLevelWildcard;
        }
@@ -0,0 +1,120 @@
+using System.Management.Automation;
+
+namespace MQTTnet.PowerShell.Cmdlets;
+
+[Cmdlet(VerbsCommunications.Connect, "MqttSession")]
+[OutputType(typeof(MqttClientConnectResult))]
+public class ConnectMqttSessionCmdlet : PSCmdlet
+{
+    [Parameter]
+    public SwitchParameter CleanSession { get; set; } = true;
+
+    [Parameter]
+    public string? ClientId { get; set; } = Guid.NewGuid().ToString();
+
+    [Parameter(Mandatory = true, ParameterSetName = "Tcp")]
+    [Parameter(Mandatory = true, ParameterSetName = "TcpWithTls")]
+    public new string? Host { get; set; }
+
+    [Parameter]
+    public string? Password { get; set; }
+
+    [Parameter(ParameterSetName = "Tcp")]
+    [Parameter(ParameterSetName = "TcpWithTls")]
+    public int Port { get; set; } = 1883;
+
+    [Parameter(Mandatory = true, ValueFromPipeline = true)]
+    public required PsMqttSession Session { get; set; }
+
+    [Parameter]
+    public string? Username { get; set; }
+
+    [Parameter(ParameterSetName = "TcpWithTls")]
+    public SwitchParameter UseTls { get; set; }
+
+    [Parameter(ParameterSetName = "TcpWithTls")]
+    public SwitchParameter AllowUntrustedCertificates { get; set; }
+
+    [Parameter(Mandatory = true, ParameterSetName = "WebSocket")]
+    public string? WebSocketUri { get; set; }
+
+    [Parameter]
+    public int KeepAlivePeriod { get; set; } = 15;
+
+    [Parameter]
+    public int Timeout { get; set; } = 10;
+
+    [Parameter]
+    public string? WillTopic { get; set; }
+
+    [Parameter]
+    public string? WillPayload { get; set; }
+
+    [Parameter]
+    public int WillQoS { get; set; } = 0;
+
+    [Parameter]
+    public SwitchParameter WillRetain { get; set; }
+
+    protected override void ProcessRecord()
+    {
+        var clientOptionsBuilder = new MqttClientOptionsBuilder();
+        
+        // Configure transport
+        if (ParameterSetName == "WebSocket")
+        {
+            clientOptionsBuilder.WithWebSocketServer(o => o.WithUri(WebSocketUri!));
+        }
+        else
+        {
+            clientOptionsBuilder.WithTcpServer(Host!, Port);
+            
+            if (UseTls)
+            {
+                clientOptionsBuilder.WithTlsOptions(o =>
+                {
+                    if (AllowUntrustedCertificates)
+                    {
+                        o.WithCertificateValidationHandler(_ => true);
+                    }
+                });
+            }
+        }
+
+        // Configure authentication
+        if (Username != null)
+        {
+            clientOptionsBuilder.WithCredentials(Username, Password);
+        }
+
+        // Configure session
+        clientOptionsBuilder.WithCleanSession(CleanSession);
+        
+        if (!string.IsNullOrEmpty(ClientId))
+        {
+            clientOptionsBuilder.WithClientId(ClientId);
+        }
+
+        // Configure keep alive
+        clientOptionsBuilder.WithKeepAlivePeriod(TimeSpan.FromSeconds(KeepAlivePeriod));
+        clientOptionsBuilder.WithTimeout(TimeSpan.FromSeconds(Timeout));
+
+        // Configure Will message
+        if (!string.IsNullOrEmpty(WillTopic))
+        {
+            clientOptionsBuilder.WithWillTopic(WillTopic);
+            
+            if (!string.IsNullOrEmpty(WillPayload))
+            {
+                clientOptionsBuilder.WithWillPayload(System.Text.Encoding.UTF8.GetBytes(WillPayload));
+            }
+            
+            clientOptionsBuilder.WithWillQualityOfServiceLevel((Protocol.MqttQualityOfServiceLevel)WillQoS);
+            clientOptionsBuilder.WithWillRetain(WillRetain);
+        }
+
+        var response = Session.GetClient().ConnectAsync(clientOptionsBuilder.Build()).GetAwaiter().GetResult();
+
+        WriteObject(response);
+    }
+}
@@ -0,0 +1,31 @@
+using System.Management.Automation;
+
+namespace MQTTnet.PowerShell.Cmdlets;
+
+[Cmdlet(VerbsCommunications.Disconnect, "MqttSession")]
+public class DisconnectMqttSessionCmdlet : PSCmdlet
+{
+    [Parameter]
+    public MqttClientDisconnectOptionsReason Reason { get; set; } = MqttClientDisconnectOptionsReason.NormalDisconnection;
+
+    [Parameter]
+    public string? ReasonString { get; set; }
+
+    [Parameter(Mandatory = true, ValueFromPipeline = true)]
+    public required PsMqttSession Session { get; set; }
+
+    [Parameter]
+    public uint SessionExpiryInterval { get; set; }
+
+    protected override void ProcessRecord()
+    {
+        if (Session.GetClient().IsConnected)
+        {
+            var options = new MqttClientDisconnectOptionsBuilder().WithSessionExpiryInterval(SessionExpiryInterval).WithReason(Reason).WithReasonString(ReasonString).Build();
+
+            Session.GetClient().DisconnectAsync(options).GetAwaiter().GetResult();
+        }
+
+        WriteObject("Disconnected.");
+    }
+}
@@ -0,0 +1,27 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+using System.Management.Automation;
+
+namespace MQTTnet.PowerShell.Cmdlets;
+
+[Cmdlet(VerbsCommon.Get, "MqttSessionStatus")]
+[OutputType(typeof(MqttClientConnectionStatus))]
+public class GetMqttSessionStatusCmdlet : PSCmdlet
+{
+    [Parameter(Mandatory = true, ValueFromPipeline = true)]
+    public required PsMqttSession Session { get; set; }
+
+    protected override void ProcessRecord()
+    {
+        var client = Session.GetClient();
+        var status = new
+        {
+            IsConnected = client.IsConnected,
+            Options = client.Options
+        };
+
+        WriteObject(status);
+    }
+}
@@ -0,0 +1,13 @@
+using System.Management.Automation;
+
+namespace MQTTnet.PowerShell.Cmdlets;
+
+[Cmdlet(VerbsCommon.New, "MqttSession")]
+[OutputType(typeof(PsMqttSession))]
+public class NewMqttSessionCmdlet : PSCmdlet
+{
+    protected override void ProcessRecord()
+    {
+        WriteObject(new PsMqttSession());
+    }
+}
@@ -0,0 +1,69 @@
+using System.Collections;
+using System.Management.Automation;
+using System.Text;
+using MQTTnet.Protocol;
+using MQTTnet.Packets;
+
+namespace MQTTnet.PowerShell.Cmdlets;
+
+[Cmdlet(VerbsData.Publish, "MqttMessage")]
+public class PublishMqttMessageCmdlet : PSCmdlet
+{
+    [Parameter(Mandatory = true)]
+    public string? Payload { get; set; }
+
+    [Parameter]
+    public int QoS { get; set; } = 0;
+
+    [Parameter]
+    public SwitchParameter Retain { get; set; }
+
+    [Parameter(Mandatory = true, ValueFromPipeline = true)]
+    public required PsMqttSession Session { get; set; }
+
+    [Parameter(Mandatory = true)]
+    public required string Topic { get; set; }
+
+    [Parameter]
+    public string? ContentType { get; set; }
+
+    [Parameter]
+    public string? ResponseTopic { get; set; }
+
+    [Parameter]
+    public ushort TopicAlias { get; set; }
+
+    [Parameter]
+    public uint MessageExpiryInterval { get; set; }
+
+    [Parameter]
+    public Hashtable? UserProperties { get; set; }
+
+    protected override void ProcessRecord()
+    {
+        var msgBuilder = new MqttApplicationMessageBuilder()
+            .WithTopic(Topic)
+            .WithPayload(Encoding.UTF8.GetBytes(Payload ?? string.Empty))
+            .WithQualityOfServiceLevel((MqttQualityOfServiceLevel)QoS)
+            .WithRetainFlag(Retain)
+            .WithContentType(ContentType)
+            .WithResponseTopic(ResponseTopic)
+            .WithTopicAlias(TopicAlias)
+            .WithMessageExpiryInterval(MessageExpiryInterval);
+
+        // Add user properties if provided
+        if (UserProperties != null && UserProperties.Count > 0)
+        {
+            foreach (var key in UserProperties.Keys)
+            {
+                var value = UserProperties[key]?.ToString() ?? string.Empty;
+                msgBuilder.WithUserProperty(key.ToString(), value);
+            }
+        }
+
+        var msg = msgBuilder.Build();
+        var response = Session.GetClient().PublishAsync(msg).GetAwaiter().GetResult();
+
+        WriteObject(response);
+    }
+}
@@ -0,0 +1,74 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+using System.Management.Automation;
+
+namespace MQTTnet.PowerShell.Cmdlets;
+
+[Cmdlet(VerbsCommunications.Receive, "MqttMessage")]
+[OutputType(typeof(PsMqttMessage))]
+public class ReceiveMqttMessageCmdlet : PSCmdlet
+{
+    [Parameter(Mandatory = true, ValueFromPipeline = true)]
+    public required PsMqttSession Session { get; set; }
+
+    [Parameter]
+    [ValidateRange(0, int.MaxValue)]
+    public int TimeoutSeconds { get; set; } = 0;
+
+    protected override void ProcessRecord()
+    {
+        var tcs = new TaskCompletionSource<PsMqttMessage>();
+        EventHandler<PsMqttMessage>? handler = null;
+        CancellationTokenSource? cts = null;
+
+        try
+        {
+            handler = (s, e) =>
+            {
+                if (!tcs.Task.IsCompleted)
+                {
+                    tcs.TrySetResult(e);
+                }
+            };
+
+            Session.MessageReceived += handler;
+
+            // Optionaler Timeout
+            if (TimeoutSeconds > 0)
+            {
+                cts = new CancellationTokenSource();
+                cts.CancelAfter(TimeSpan.FromSeconds(TimeoutSeconds));
+                cts.Token.Register(() =>
+                {
+                    if (!tcs.Task.IsCompleted)
+                    {
+                        tcs.TrySetCanceled();
+                    }
+                });
+            }
+
+            WriteVerbose("Waiting for next MQTT message...");
+
+            try
+            {
+                var message = tcs.Task.GetAwaiter().GetResult();
+                WriteObject(message);
+            }
+            catch (TaskCanceledException)
+            {
+                WriteWarning($"Timeout after {TimeoutSeconds} seconds — no message received.");
+            }
+        }
+        finally
+        {
+            if (handler != null)
+            {
+                Session.MessageReceived -= handler;
+            }
+
+            cts?.Dispose();
+        }
+    }
+}
@@ -0,0 +1,59 @@
+using System.Management.Automation;
+using System.Management.Automation.Runspaces;
+
+namespace MQTTnet.PowerShell.Cmdlets;
+
+[Cmdlet(VerbsLifecycle.Register, "MqttMessageHandler")]
+public class RegisterMqttMessageHandlerCmdlet : PSCmdlet
+{
+    [Parameter(Mandatory = true, ValueFromPipeline = true)]
+    public required PsMqttSession Session { get; set; }
+
+    [Parameter(Mandatory = true)]
+    public ScriptBlock? Action { get; set; }
+
+    protected override void ProcessRecord()
+    {
+        // Capture the ScriptBlock and current default runspace (available during cmdlet execution)
+        var scriptBlock = Action ?? throw new ArgumentNullException(nameof(Action));
+        var capturedRunspace = Runspace.DefaultRunspace ?? throw new InvalidOperationException("No default runspace available during cmdlet execution.");
+        var capturedHost = Host;
+
+        EventHandler<PsMqttMessage> handler = (sender, e) =>
+        {
+            // Run asynchronously to avoid blocking the event thread
+            Task.Run(() =>
+            {
+                // Temporarily set the default runspace for this thread
+                var originalRunspace = Runspace.DefaultRunspace;
+                Runspace.DefaultRunspace = capturedRunspace;
+
+                try
+                {
+                    // Invoke the ScriptBlock directly with arguments (returns Collection<PSObject>)
+                    var results = scriptBlock.Invoke(e.Topic, e.Payload, e); // Pass topic, payload, and full message
+
+                    // Handle output manually (e.g., write to host/console)
+                    foreach (var result in results)
+                    {
+                        capturedHost.UI.WriteLine(result?.ToString() ?? string.Empty);
+                    }
+                }
+                catch (Exception ex)
+                {
+                    // Handle errors by writing to host error stream
+                    capturedHost.UI.WriteErrorLine($"MQTT handler error: {ex.Message}");
+                    // Optionally: capturedHost.UI.WriteVerboseLine(ex.StackTrace); for more details
+                }
+                finally
+                {
+                    // Restore the original default runspace for this thread
+                    Runspace.DefaultRunspace = originalRunspace;
+                }
+            });
+        };
+
+        Session.MessageReceived += handler;
+        WriteObject($"Handler registered for MQTT messages on session.");
+    }
+}
@@ -0,0 +1,16 @@
+using System.Management.Automation;
+
+namespace MQTTnet.PowerShell.Cmdlets;
+
+[Cmdlet(VerbsCommon.Remove, "MqttSession")]
+public class RemoveMqttSessionCmdlet : PSCmdlet
+{
+    [Parameter(Mandatory = true, ValueFromPipeline = true)]
+    public required PsMqttSession Session { get; set; }
+
+    protected override void ProcessRecord()
+    {
+        Session.Dispose();
+        WriteObject("Session removed.");
+    }
+}
@@ -0,0 +1,78 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+using System.Management.Automation;
+
+namespace MQTTnet.PowerShell.Cmdlets;
+
+[Cmdlet(VerbsCommon.Show, "MqttExamples")]
+public class ShowMqttExamplesCmdlet : PSCmdlet
+{
+    protected override void ProcessRecord()
+    {
+        var examples = @"
+MQTTnet PowerShell Module - Quick Examples
+==========================================
+
+1. Basic Connection and Publish:
+   $session = New-MqttSession
+   Connect-MqttSession -Session $session -Host 'broker.hivemq.com'
+   Publish-MqttMessage -Session $session -Topic 'test/topic' -Payload 'Hello'
+   Disconnect-MqttSession -Session $session
+   Remove-MqttSession -Session $session
+
+2. Subscribe and Receive Messages:
+   $session = New-MqttSession
+   Connect-MqttSession -Session $session -Host 'broker.hivemq.com'
+   Subscribe-MqttTopic -Session $session -Topic 'test/demo'
+   $msg = Receive-MqttMessage -Session $session -TimeoutSeconds 30
+   Write-Host ""Received: $($msg.Payload)""
+
+3. WebSocket Connection:
+   $session = New-MqttSession
+   Connect-MqttSession -Session $session -WebSocketUri 'ws://broker.hivemq.com:8000/mqtt'
+   Publish-MqttMessage -Session $session -Topic 'test/ws' -Payload 'Hello WS'
+
+4. TLS/SSL Connection:
+   $session = New-MqttSession
+   Connect-MqttSession -Session $session -Host 'broker.hivemq.com' -Port 8883 `
+       -UseTls -AllowUntrustedCertificates
+
+5. Async Message Handler:
+   $session = New-MqttSession
+   Connect-MqttSession -Session $session -Host 'broker.hivemq.com'
+   Subscribe-MqttTopic -Session $session -Topic 'test/#'
+   Register-MqttMessageHandler -Session $session -Action {
+       param($topic, $payload, $message)
+       Write-Host ""Message on $topic : $payload""
+   }
+
+6. Last Will and Testament:
+   $session = New-MqttSession
+   Connect-MqttSession -Session $session -Host 'broker.hivemq.com' `
+       -WillTopic 'status/client' -WillPayload 'Offline' -WillQoS 1 -WillRetain
+
+7. Publish with User Properties:
+   $props = @{ 'source' = 'PowerShell'; 'version' = '1.0' }
+   Publish-MqttMessage -Session $session -Topic 'test/props' `
+       -Payload 'Data' -UserProperties $props
+
+8. High QoS Publishing:
+   Publish-MqttMessage -Session $session -Topic 'critical/data' `
+       -Payload 'Important' -QoS 2
+
+9. Test Connection:
+   $isAlive = Test-MqttConnection -Session $session
+   Write-Host ""Connection alive: $isAlive""
+
+10. Get Session Status:
+    $status = Get-MqttSessionStatus -Session $session
+    Write-Host ""Connected: $($status.IsConnected)""
+
+For more details, see: Source/MQTTnet.PowerShell/README.md
+";
+        
+        WriteObject(examples);
+    }
+}
@@ -0,0 +1,55 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+using System.Management.Automation;
+using MQTTnet.Protocol;
+
+namespace MQTTnet.PowerShell.Cmdlets;
+
+[Cmdlet("Subscribe", "MqttTopic")]
+[OutputType(typeof(MqttClientSubscribeResult))]
+public class SubscribeMqttTopicCmdlet : PSCmdlet
+{
+    [Parameter]
+    public bool NoLocal { get; set; }
+
+    [Parameter]
+    public int QoS { get; set; } = 0;
+
+    [Parameter]
+    public bool RetainAsPublished { get; set; }
+
+    [Parameter]
+    public MqttRetainHandling RetainHandling { get; set; } = MqttRetainHandling.SendAtSubscribe;
+
+    [Parameter(Mandatory = true, ValueFromPipeline = true)]
+    public required PsMqttSession Session { get; set; }
+
+    [Parameter]
+    public uint SubscriptionIdentifier { get; set; }
+
+    [Parameter(Mandatory = true)]
+    public required string Topic { get; set; }
+
+    protected override void ProcessRecord()
+    {
+        var topicFilter = new MqttTopicFilterBuilder().WithTopic(Topic)
+            .WithQualityOfServiceLevel((MqttQualityOfServiceLevel)QoS)
+            .WithNoLocal(NoLocal)
+            .WithRetainAsPublished(RetainAsPublished)
+            .WithRetainHandling(RetainHandling)
+            .Build();
+
+        var options = new MqttClientSubscribeOptionsBuilder().WithTopicFilter(topicFilter);
+
+        if (SubscriptionIdentifier > 0)
+        {
+            options.WithSubscriptionIdentifier(SubscriptionIdentifier);
+        }
+
+        var response = Session.GetClient().SubscribeAsync(options.Build()).GetAwaiter().GetResult();
+
+        WriteObject(response);
+    }
+}
@@ -0,0 +1,41 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+using System.Management.Automation;
+
+namespace MQTTnet.PowerShell.Cmdlets;
+
+[Cmdlet(VerbsDiagnostic.Test, "MqttConnection")]
+[OutputType(typeof(bool))]
+public class TestMqttConnectionCmdlet : PSCmdlet
+{
+    [Parameter(Mandatory = true, ValueFromPipeline = true)]
+    public required PsMqttSession Session { get; set; }
+
+    [Parameter]
+    public int TimeoutSeconds { get; set; } = 5;
+
+    protected override void ProcessRecord()
+    {
+        try
+        {
+            var client = Session.GetClient();
+            
+            if (!client.IsConnected)
+            {
+                WriteObject(false);
+                return;
+            }
+
+            var cts = new CancellationTokenSource(TimeSpan.FromSeconds(TimeoutSeconds));
+            client.PingAsync(cts.Token).GetAwaiter().GetResult();
+            
+            WriteObject(true);
+        }
+        catch
+        {
+            WriteObject(false);
+        }
+    }
+}
@@ -0,0 +1,21 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+using System.Management.Automation;
+
+namespace MQTTnet.PowerShell.Cmdlets;
+
+[Cmdlet(VerbsLifecycle.Unregister, "MqttMessageHandler")]
+public class UnregisterMqttMessageHandlerCmdlet : PSCmdlet
+{
+    [Parameter(Mandatory = true, ValueFromPipeline = true)]
+    public required PsMqttSession Session { get; set; }
+
+    protected override void ProcessRecord()
+    {
+        // Clear all event handlers
+        Session.ClearMessageHandlers();
+        WriteObject($"All message handlers cleared for MQTT session.");
+    }
+}
@@ -0,0 +1,23 @@
+using System.Management.Automation;
+
+namespace MQTTnet.PowerShell.Cmdlets;
+
+[Cmdlet("Unsubscribe", "MqttTopic")]
+[OutputType(typeof(MqttClientUnsubscribeResult))]
+public class UnsubscribeMqttTopicCmdlet : PSCmdlet
+{
+    [Parameter(Mandatory = true, ValueFromPipeline = true)]
+    public required PsMqttSession Session { get; set; }
+
+    [Parameter(Mandatory = true)]
+    public required string Topic { get; set; }
+
+    protected override void ProcessRecord()
+    {
+        var options = new MqttClientUnsubscribeOptionsBuilder().WithTopicFilter(Topic).Build();
+
+        var response = Session.GetClient().UnsubscribeAsync(options).GetAwaiter().GetResult();
+
+        WriteObject(response);
+    }
+}
@@ -0,0 +1,197 @@
+# PowerShell Module Extension - Implementation Summary
+
+## Overview
+This implementation extends the PowerShell support for the MQTTnet library as requested in issue #2215, implementing the proposal described in the ticket comments and exposing additional features of the library as PowerShell cmdlets.
+
+## Changes Implemented
+
+### 1. Enhanced RegisterMqttMessageHandler (Primary Requirement from #2215)
+**File**: `Source/MQTTnet.PowerShell/Cmdlets/RegisterMqttMessageHandlerCmdlet.cs`
+
+Implemented the proposal from the issue comment by @ArakniD:
+- Proper ScriptBlock execution in the correct runspace
+- Asynchronous message handling using Task.Run to avoid blocking
+- Passes three parameters to the handler: topic (string), payload (string), and full message object
+- Proper error handling with try-catch and error output to host
+- Captures the runspace during cmdlet execution and restores it during handler execution
+
+**Usage Example:**
+```powershell
+Register-MqttMessageHandler -Session $session -Action {
+    param($topic, $payload, $message)
+    Write-Host "Received on $topic: $payload"
+    # Can access $message.QoS, $message.Retain, etc.
+}
+```
+
+### 2. Enhanced Connection Options
+**File**: `Source/MQTTnet.PowerShell/Cmdlets/ConnectMqttSessionCmdlet.cs`
+
+Extended Connect-MqttSession with:
+- **WebSocket Support**: New `-WebSocketUri` parameter for WebSocket connections
+- **TLS/SSL Support**: New `-UseTls` and `-AllowUntrustedCertificates` parameters
+- **Last Will and Testament**: Parameters for `-WillTopic`, `-WillPayload`, `-WillQoS`, `-WillRetain`
+- **Connection Tuning**: Parameters for `-KeepAlivePeriod` and `-Timeout`
+- **Parameter Sets**: Organized into TCP, TcpWithTls, and WebSocket parameter sets
+
+**Usage Examples:**
+```powershell
+# TCP with TLS
+Connect-MqttSession -Session $session -Host "broker.com" -Port 8883 -UseTls
+
+# WebSocket
+Connect-MqttSession -Session $session -WebSocketUri "ws://broker.com:8000/mqtt"
+
+# With Last Will
+Connect-MqttSession -Session $session -Host "broker.com" `
+    -WillTopic "status" -WillPayload "Offline" -WillRetain
+```
+
+### 3. Enhanced Publishing
+**File**: `Source/MQTTnet.PowerShell/Cmdlets/PublishMqttMessageCmdlet.cs`
+
+Added support for:
+- **User Properties**: New `-UserProperties` parameter accepting a Hashtable
+- MQTT 5 features already supported: ContentType, ResponseTopic, TopicAlias, MessageExpiryInterval
+
+**Usage Example:**
+```powershell
+$props = @{ "source" = "PowerShell"; "version" = "1.0" }
+Publish-MqttMessage -Session $session -Topic "data" -Payload "test" -UserProperties $props
+```
+
+### 4. New Utility Cmdlets
+
+#### Get-MqttSessionStatus
+**File**: `Source/MQTTnet.PowerShell/Cmdlets/GetMqttSessionStatusCmdlet.cs`
+
+Returns connection status information.
+
+```powershell
+$status = Get-MqttSessionStatus -Session $session
+Write-Host "Connected: $($status.IsConnected)"
+```
+
+#### Test-MqttConnection
+**File**: `Source/MQTTnet.PowerShell/Cmdlets/TestMqttConnectionCmdlet.cs`
+
+Pings the broker to verify connectivity.
+
+```powershell
+$isAlive = Test-MqttConnection -Session $session -TimeoutSeconds 5
+```
+
+#### Unregister-MqttMessageHandler
+**File**: `Source/MQTTnet.PowerShell/Cmdlets/UnregisterMqttMessageHandlerCmdlet.cs`
+
+Clears all registered message handlers.
+
+```powershell
+Unregister-MqttMessageHandler -Session $session
+```
+
+#### Show-MqttExamples
+**File**: `Source/MQTTnet.PowerShell/Cmdlets/ShowMqttExamplesCmdlet.cs`
+
+Displays quick reference examples for common MQTT tasks.
+
+```powershell
+Show-MqttExamples
+```
+
+### 5. Enhanced PsMqttSession Class
+**File**: `Source/MQTTnet.PowerShell/PsMqttSession.cs`
+
+Added:
+- `ClearMessageHandlers()` method to remove all event handlers
+- Improved event handling infrastructure
+
+### 6. Documentation
+**Files**: 
+- `Source/MQTTnet.PowerShell/README.md` (new)
+- `Source/MQTTnet.PowerShell/Test.ps1` (updated)
+- `Source/MQTTnet.PowerShell/SmokeTest.ps1` (new)
+
+Created comprehensive documentation including:
+- Quick start guide
+- Detailed cmdlet documentation
+- Parameter descriptions
+- Usage examples for all features
+- Advanced scenarios (request-response, error handling)
+- Tips and best practices
+- Smoke tests for validation
+
+## Complete Cmdlet List (13 Total)
+
+1. **New-MqttSession** - Create MQTT session
+2. **Connect-MqttSession** - Connect with TCP/WebSocket/TLS support
+3. **Disconnect-MqttSession** - Clean disconnect
+4. **Remove-MqttSession** - Cleanup resources
+5. **Get-MqttSessionStatus** - Check connection status
+6. **Test-MqttConnection** - Ping broker
+7. **Publish-MqttMessage** - Publish with advanced features
+8. **Subscribe-MqttTopic** - Subscribe to topics
+9. **Unsubscribe-MqttTopic** - Unsubscribe from topics
+10. **Receive-MqttMessage** - Synchronous message receive
+11. **Register-MqttMessageHandler** - Async message handling ⭐ (Primary requirement)
+12. **Unregister-MqttMessageHandler** - Clear handlers
+13. **Show-MqttExamples** - Quick reference examples
+
+## Testing
+
+### Build Status
+✅ PowerShell module builds successfully
+✅ No compilation errors or warnings
+✅ Code passes CodeQL security analysis (0 alerts)
+
+### Smoke Tests
+✅ All 13 cmdlets load correctly
+✅ Session creation and disposal works
+✅ Show-MqttExamples returns help text
+✅ No runtime errors during basic operations
+
+### Test Files
+- `SmokeTest.ps1`: Quick validation of module loading and basic operations
+- `Test.ps1`: Comprehensive examples demonstrating all features
+
+## Features Not Implemented (Out of Scope)
+
+The following were considered but determined to be out of scope for this task:
+- MQTT broker/server cmdlets (only client features were requested)
+- Managed MQTT client wrapper (existing client is sufficient)
+- RPC extension support (specialized use case)
+- File-based certificate handling cmdlets (can be done with existing .NET capabilities)
+
+## Compatibility
+
+- Requires .NET 8.0 or later
+- Requires PowerShell 7.0 or later
+- Works on Windows, Linux, and macOS
+- Compatible with MQTT 3.1.1 and MQTT 5.0 protocols
+
+## Breaking Changes
+
+None. This is a new feature addition that doesn't modify existing code outside the PowerShell module.
+
+## Migration Guide
+
+For users who were using the initial implementation from PR #2215:
+- The RegisterMqttMessageHandler now actually works! Update your scripts to use the handler.
+- Connect-MqttSession now requires explicit parameter sets (-Host for TCP, -WebSocketUri for WebSocket)
+- No other breaking changes
+
+## Future Enhancements
+
+Potential future improvements that could be added:
+1. Pipeline support for batch publishing
+2. Managed client wrapper for automatic reconnection
+3. Certificate-based authentication helpers
+4. MQTT broker cmdlets for running local brokers
+5. Performance counters and statistics cmdlets
+6. Async/await support for better PowerShell integration
+
+## References
+
+- Issue #2215: https://github.com/dotnet/MQTTnet/pull/2215
+- Proposal comment by @ArakniD: https://github.com/dotnet/MQTTnet/pull/2215#issuecomment-3594492551
+- MQTTnet Documentation: https://github.com/dotnet/MQTTnet
@@ -0,0 +1,19 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <AssemblyName>MQTTnet.PowerShell</AssemblyName>
+    <LangVersion>default</LangVersion>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="PowerShellStandard.Library" Version="5.1.1">
+      <PrivateAssets>All</PrivateAssets>
+    </PackageReference>
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\MQTTnet\MQTTnet.csproj" />
+  </ItemGroup>
+
+</Project>
@@ -0,0 +1,30 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+using System.Management.Automation;
+using MQTTnet.Packets;
+
+namespace MQTTnet.PowerShell;
+
+public class PsMqttPublishResult
+{
+
+}
+
+public class PsMqttConnectResult
+{
+
+}
+
+public class PsMqttMessage
+{
+    public required string? ContentType { get; init; }
+    public required string Payload { get; init; }
+    public int QoS { get; init; }
+    public required byte[] RawPayload { get; init; }
+    public string? ResponseTopic { get; init; }
+    public bool Retain { get; init; }
+    public required string Topic { get; init; }
+    public required List<MqttUserProperty>? UserProperties { get; init; }
+}
@@ -0,0 +1,62 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+using System.Buffers;
+using System.Text;
+
+namespace MQTTnet.PowerShell;
+
+public sealed class PsMqttSession : IDisposable
+{
+    readonly IMqttClient _client;
+
+    public PsMqttSession()
+    {
+        var factory = new MqttClientFactory();
+        _client = factory.CreateMqttClient();
+
+        _client.ApplicationMessageReceivedAsync += e =>
+        {
+            MessageReceived?.Invoke(
+                this,
+                new PsMqttMessage
+                {
+                    Topic = e.ApplicationMessage.Topic,
+                    Payload = Encoding.UTF8.GetString(e.ApplicationMessage.Payload),
+                    RawPayload = e.ApplicationMessage.Payload.ToArray(),
+                    UserProperties = e.ApplicationMessage.UserProperties,
+                    QoS = (int)e.ApplicationMessage.QualityOfServiceLevel,
+                    ContentType = e.ApplicationMessage.ContentType,
+                    Retain = e.ApplicationMessage.Retain,
+                    ResponseTopic = e.ApplicationMessage.ResponseTopic
+                });
+
+            return Task.CompletedTask;
+        };
+    }
+
+    public event EventHandler<PsMqttMessage>? MessageReceived;
+
+    public void ClearMessageHandlers()
+    {
+        // Remove all event subscribers
+        if (MessageReceived != null)
+        {
+            foreach (var handler in MessageReceived.GetInvocationList())
+            {
+                MessageReceived -= (EventHandler<PsMqttMessage>)handler;
+            }
+        }
+    }
+
+    public void Dispose()
+    {
+        _client.Dispose();
+    }
+
+    public IMqttClient GetClient()
+    {
+        return _client;
+    }
+}
@@ -0,0 +1,396 @@
+# MQTTnet PowerShell Module
+
+A PowerShell module for MQTTnet that provides cmdlets for MQTT communication in PowerShell.
+
+## Features
+
+- **Full MQTT Protocol Support**: Connect, subscribe, publish, and manage MQTT connections
+- **TCP and WebSocket Transports**: Support for both TCP and WebSocket connections
+- **TLS/SSL Support**: Secure connections with TLS encryption
+- **Async Message Handling**: Register PowerShell ScriptBlocks as message handlers
+- **Advanced MQTT Features**: 
+  - Quality of Service (QoS) levels 0, 1, and 2
+  - Retained messages
+  - Last Will and Testament (LWT)
+  - User properties
+  - Message expiry intervals
+  - Response topics
+
+## Installation
+
+1. Build the MQTTnet.PowerShell project:
+   ```powershell
+   dotnet build Source/MQTTnet.PowerShell/MQTTnet.PowerShell.csproj
+   ```
+
+2. Import the module:
+   ```powershell
+   Import-Module ./Source/MQTTnet.PowerShell/bin/Debug/net8.0/MQTTnet.PowerShell.dll
+   ```
+
+## Quick Start
+
+### Basic Connection and Publish
+
+```powershell
+# Create a new MQTT session
+$session = New-MqttSession
+
+# Connect to a broker
+Connect-MqttSession -Session $session -Host "broker.hivemq.com" -Port 1883
+
+# Publish a message
+Publish-MqttMessage -Session $session -Topic "test/topic" -Payload "Hello MQTT!"
+
+# Disconnect and cleanup
+Disconnect-MqttSession -Session $session
+Remove-MqttSession -Session $session
+```
+
+### Subscribe and Receive Messages
+
+```powershell
+$session = New-MqttSession
+Connect-MqttSession -Session $session -Host "broker.hivemq.com"
+
+# Subscribe to a topic
+Subscribe-MqttTopic -Session $session -Topic "test/demo"
+
+# Wait for a message (with timeout)
+$message = Receive-MqttMessage -Session $session -TimeoutSeconds 30
+Write-Host "Received: $($message.Payload)"
+
+Disconnect-MqttSession -Session $session
+Remove-MqttSession -Session $session
+```
+
+### Async Message Handler
+
+```powershell
+$session = New-MqttSession
+Connect-MqttSession -Session $session -Host "broker.hivemq.com"
+
+Subscribe-MqttTopic -Session $session -Topic "test/#"
+
+# Register a message handler
+Register-MqttMessageHandler -Session $session -Action {
+    param($topic, $payload, $message)
+    Write-Host "Message on $topic : $payload"
+    Write-Host "QoS: $($message.QoS), Retain: $($message.Retain)"
+}
+
+# Messages will be handled asynchronously
+Start-Sleep -Seconds 60
+
+Disconnect-MqttSession -Session $session
+Remove-MqttSession -Session $session
+```
+
+## Available Cmdlets
+
+### Help and Examples
+
+#### Show-MqttExamples
+Displays quick examples for common MQTT tasks.
+
+```powershell
+Show-MqttExamples
+```
+
+### Session Management
+
+#### New-MqttSession
+Creates a new MQTT session.
+
+```powershell
+$session = New-MqttSession
+```
+
+#### Connect-MqttSession
+Connects to an MQTT broker with various options.
+
+**TCP Connection:**
+```powershell
+Connect-MqttSession -Session $session -Host "broker.hivemq.com" -Port 1883
+```
+
+**TCP with TLS:**
+```powershell
+Connect-MqttSession -Session $session -Host "broker.hivemq.com" -Port 8883 `
+    -UseTls -AllowUntrustedCertificates
+```
+
+**WebSocket Connection:**
+```powershell
+Connect-MqttSession -Session $session -WebSocketUri "ws://broker.hivemq.com:8000/mqtt"
+```
+
+**With Authentication:**
+```powershell
+Connect-MqttSession -Session $session -Host "broker.hivemq.com" `
+    -Username "user" -Password "pass"
+```
+
+**With Last Will and Testament:**
+```powershell
+Connect-MqttSession -Session $session -Host "broker.hivemq.com" `
+    -WillTopic "status/client" -WillPayload "Offline" -WillQoS 1 -WillRetain
+```
+
+**Parameters:**
+- `Session`: The MQTT session (mandatory)
+- `Host`: Broker hostname (for TCP)
+- `Port`: Broker port (default: 1883)
+- `WebSocketUri`: WebSocket URI (for WebSocket connections)
+- `Username`: Username for authentication
+- `Password`: Password for authentication
+- `ClientId`: Client identifier (auto-generated if not specified)
+- `CleanSession`: Use clean session (default: true)
+- `UseTls`: Enable TLS encryption
+- `AllowUntrustedCertificates`: Allow untrusted certificates
+- `KeepAlivePeriod`: Keep-alive period in seconds (default: 15)
+- `Timeout`: Connection timeout in seconds (default: 10)
+- `WillTopic`: Last Will topic
+- `WillPayload`: Last Will payload
+- `WillQoS`: Last Will QoS level (0-2)
+- `WillRetain`: Retain Last Will message
+
+#### Get-MqttSessionStatus
+Gets the current status of the MQTT session.
+
+```powershell
+$status = Get-MqttSessionStatus -Session $session
+Write-Host "Connected: $($status.IsConnected)"
+```
+
+#### Disconnect-MqttSession
+Disconnects from the MQTT broker.
+
+```powershell
+Disconnect-MqttSession -Session $session
+```
+
+**Parameters:**
+- `Session`: The MQTT session (mandatory)
+- `Reason`: Disconnect reason code
+- `ReasonString`: Human-readable reason
+- `SessionExpiryInterval`: Session expiry interval
+
+#### Remove-MqttSession
+Disposes the MQTT session and releases resources.
+
+```powershell
+Remove-MqttSession -Session $session
+```
+
+#### Test-MqttConnection
+Tests if the MQTT connection is alive by sending a PING packet.
+
+```powershell
+$isAlive = Test-MqttConnection -Session $session -TimeoutSeconds 5
+Write-Host "Connection is alive: $isAlive"
+```
+
+**Parameters:**
+- `Session`: The MQTT session (mandatory)
+- `TimeoutSeconds`: Timeout for the ping operation (default: 5)
+
+### Publishing
+
+#### Publish-MqttMessage
+Publishes a message to a topic.
+
+**Basic:**
+```powershell
+Publish-MqttMessage -Session $session -Topic "test/topic" -Payload "Hello"
+```
+
+**With QoS and Retain:**
+```powershell
+Publish-MqttMessage -Session $session -Topic "test/topic" -Payload "Hello" `
+    -QoS 1 -Retain
+```
+
+**With User Properties:**
+```powershell
+$props = @{
+    "source" = "PowerShell"
+    "version" = "1.0"
+}
+Publish-MqttMessage -Session $session -Topic "test/topic" -Payload "Hello" `
+    -UserProperties $props
+```
+
+**Parameters:**
+- `Session`: The MQTT session (mandatory)
+- `Topic`: Topic to publish to (mandatory)
+- `Payload`: Message payload (mandatory)
+- `QoS`: Quality of Service level (0-2, default: 0)
+- `Retain`: Retain flag
+- `ContentType`: Content type of the payload
+- `ResponseTopic`: Response topic for request/response pattern
+- `UserProperties`: Hashtable of user properties
+- `TopicAlias`: Topic alias
+- `MessageExpiryInterval`: Message expiry interval in seconds
+
+### Subscribing
+
+#### Subscribe-MqttTopic
+Subscribes to a topic.
+
+```powershell
+Subscribe-MqttTopic -Session $session -Topic "test/demo" -QoS 1
+```
+
+**Parameters:**
+- `Session`: The MQTT session (mandatory)
+- `Topic`: Topic filter to subscribe to (mandatory)
+- `QoS`: Quality of Service level (0-2, default: 0)
+- `NoLocal`: No local flag
+- `RetainAsPublished`: Retain as published flag
+- `RetainHandling`: Retain handling option
+- `SubscriptionIdentifier`: Subscription identifier
+
+#### Unsubscribe-MqttTopic
+Unsubscribes from a topic.
+
+```powershell
+Unsubscribe-MqttTopic -Session $session -Topic "test/demo"
+```
+
+### Message Handling
+
+#### Receive-MqttMessage
+Waits for and receives a single message.
+
+```powershell
+# Wait indefinitely
+$message = Receive-MqttMessage -Session $session
+
+# Wait with timeout
+$message = Receive-MqttMessage -Session $session -TimeoutSeconds 30
+```
+
+**Parameters:**
+- `Session`: The MQTT session (mandatory)
+- `TimeoutSeconds`: Timeout in seconds (0 = no timeout)
+
+#### Register-MqttMessageHandler
+Registers an asynchronous message handler using a PowerShell ScriptBlock.
+
+```powershell
+Register-MqttMessageHandler -Session $session -Action {
+    param($topic, $payload, $message)
+    
+    Write-Host "Topic: $topic"
+    Write-Host "Payload: $payload"
+    Write-Host "QoS: $($message.QoS)"
+    
+    # Access full message properties
+    if ($message.UserProperties) {
+        foreach ($prop in $message.UserProperties) {
+            Write-Host "Property: $($prop.Name) = $($prop.Value)"
+        }
+    }
+}
+```
+
+The ScriptBlock receives three parameters:
+1. `$topic`: The message topic (string)
+2. `$payload`: The message payload as UTF-8 string
+3. `$message`: The full message object with properties:
+   - `Topic`: Message topic
+   - `Payload`: Payload as string
+   - `RawPayload`: Payload as byte array
+   - `QoS`: Quality of Service level
+   - `Retain`: Retain flag
+   - `ContentType`: Content type
+   - `ResponseTopic`: Response topic
+   - `UserProperties`: List of user properties
+
+**Parameters:**
+- `Session`: The MQTT session (mandatory)
+- `Action`: ScriptBlock to execute for each message (mandatory)
+
+#### Unregister-MqttMessageHandler
+Removes all registered message handlers.
+
+```powershell
+Unregister-MqttMessageHandler -Session $session
+```
+
+## Advanced Examples
+
+### Request-Response Pattern
+
+```powershell
+$session = New-MqttSession
+Connect-MqttSession -Session $session -Host "broker.hivemq.com"
+
+# Responder
+Subscribe-MqttTopic -Session $session -Topic "request/topic"
+Register-MqttMessageHandler -Session $session -Action {
+    param($topic, $payload, $message)
+    if ($message.ResponseTopic) {
+        $response = "Response to: $payload"
+        Publish-MqttMessage -Session $session -Topic $message.ResponseTopic `
+            -Payload $response
+    }
+}
+
+# Requestor (in another session)
+$responseSession = New-MqttSession
+Connect-MqttSession -Session $responseSession -Host "broker.hivemq.com"
+Subscribe-MqttTopic -Session $responseSession -Topic "response/topic"
+Publish-MqttMessage -Session $responseSession -Topic "request/topic" `
+    -Payload "Request data" -ResponseTopic "response/topic"
+
+# Wait for response
+$response = Receive-MqttMessage -Session $responseSession -TimeoutSeconds 10
+```
+
+### High QoS Publishing
+
+```powershell
+# Publish with QoS 2 (exactly once delivery)
+$result = Publish-MqttMessage -Session $session -Topic "critical/data" `
+    -Payload "Important data" -QoS 2
+
+Write-Host "Publish result: $($result.ReasonCode)"
+```
+
+### Error Handling in Message Handler
+
+```powershell
+Register-MqttMessageHandler -Session $session -Action {
+    param($topic, $payload, $message)
+    try {
+        # Process message
+        $data = ConvertFrom-Json $payload
+        # Do something with data
+    }
+    catch {
+        Write-Host "Error processing message: $_" -ForegroundColor Red
+    }
+}
+```
+
+## Tips and Best Practices
+
+1. **Always disconnect cleanly**: Use `Disconnect-MqttSession` before `Remove-MqttSession`
+2. **Use appropriate QoS levels**: QoS 0 for best performance, QoS 1 for reliability, QoS 2 for critical data
+3. **Handle errors in message handlers**: Wrap handler code in try-catch blocks
+4. **Use meaningful client IDs**: Set custom client IDs for debugging
+5. **Secure connections**: Use TLS for production environments
+6. **Topic design**: Use hierarchical topic structures like `device/sensor/temperature`
+7. **Clean session**: Use `-CleanSession:$false` to maintain subscriptions across reconnects
+
+## Requirements
+
+- .NET 8.0 or later
+- PowerShell 7.0 or later
+- MQTTnet library
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file in the repository root for details.
@@ -0,0 +1,25 @@
+# Quick smoke test for MQTTnet PowerShell Module
+Import-Module ./bin/Debug/net8.0/MQTTnet.PowerShell.dll -WarningAction SilentlyContinue
+
+Write-Host "Testing module load..." -ForegroundColor Yellow
+$commands = Get-Command -Module MQTTnet.PowerShell
+Write-Host "Found $($commands.Count) cmdlets:" -ForegroundColor Green
+$commands | ForEach-Object { Write-Host "  - $($_.Name)" -ForegroundColor Cyan }
+
+Write-Host "`nTesting session creation..." -ForegroundColor Yellow
+$session = New-MqttSession
+Write-Host "Session created successfully!" -ForegroundColor Green
+
+Write-Host "`nTesting Show-MqttExamples..." -ForegroundColor Yellow
+$examples = Show-MqttExamples
+if ($examples) {
+    Write-Host "Examples retrieved successfully!" -ForegroundColor Green
+} else {
+    Write-Host "Failed to retrieve examples!" -ForegroundColor Red
+}
+
+Write-Host "`nTesting session cleanup..." -ForegroundColor Yellow
+Remove-MqttSession -Session $session
+Write-Host "Session removed successfully!" -ForegroundColor Green
+
+Write-Host "`n✓ All smoke tests passed!" -ForegroundColor Green
@@ -0,0 +1,117 @@
+# MQTTnet PowerShell Module Test Script
+# This script demonstrates the usage of the MQTTnet PowerShell module
+
+Import-Module ./bin/Debug/net8.0/MQTTnet.PowerShell.dll
+
+Write-Host "=== MQTTnet PowerShell Module Test ===" -ForegroundColor Cyan
+
+# Example 1: Basic TCP connection
+Write-Host "`n1. Testing basic TCP connection..." -ForegroundColor Yellow
+$session = New-MqttSession
+
+try {
+    Connect-MqttSession -Session $session -Host "broker.hivemq.com" -Port 1883
+    Write-Host "Connected successfully!" -ForegroundColor Green
+    
+    # Get session status
+    Write-Host "`n2. Getting session status..." -ForegroundColor Yellow
+    $status = Get-MqttSessionStatus -Session $session
+    Write-Host "IsConnected: $($status.IsConnected)" -ForegroundColor Green
+    
+    # Example 2: Publish a simple message
+    Write-Host "`n3. Publishing a simple message..." -ForegroundColor Yellow
+    Publish-MqttMessage -Session $session -Topic "test/powershell" -Payload "Hello from PowerShell!"
+    Write-Host "Message published!" -ForegroundColor Green
+    
+    # Example 3: Publish with user properties
+    Write-Host "`n4. Publishing with user properties..." -ForegroundColor Yellow
+    $properties = @{
+        "source" = "PowerShell"
+        "version" = "1.0"
+    }
+    Publish-MqttMessage -Session $session -Topic "test/powershell/advanced" -Payload "Advanced message" -UserProperties $properties -QoS 1
+    Write-Host "Message with properties published!" -ForegroundColor Green
+    
+    # Example 4: Subscribe and receive messages
+    Write-Host "`n5. Subscribing to topics..." -ForegroundColor Yellow
+    Subscribe-MqttTopic -Session $session -Topic "test/demo"
+    Write-Host "Subscribed to test/demo" -ForegroundColor Green
+    
+    # Example 5: Register a message handler
+    Write-Host "`n6. Registering message handler..." -ForegroundColor Yellow
+    Register-MqttMessageHandler -Session $session -Action {
+        param($topic, $payload, $message)
+        Write-Host "Received message on topic: $topic" -ForegroundColor Cyan
+        Write-Host "Payload: $payload" -ForegroundColor White
+        Write-Host "QoS: $($message.QoS)" -ForegroundColor White
+    }
+    Write-Host "Handler registered!" -ForegroundColor Green
+    
+    # Publish a test message that the handler will receive
+    Write-Host "`n7. Publishing test message for handler..." -ForegroundColor Yellow
+    Publish-MqttMessage -Session $session -Topic "test/demo" -Payload "Test message for handler"
+    Start-Sleep -Seconds 2
+    
+    # Example 6: Unsubscribe
+    Write-Host "`n8. Unsubscribing from topic..." -ForegroundColor Yellow
+    Unsubscribe-MqttTopic -Session $session -Topic "test/demo"
+    Write-Host "Unsubscribed!" -ForegroundColor Green
+    
+    # Example 7: Clean disconnect
+    Write-Host "`n9. Disconnecting..." -ForegroundColor Yellow
+    Disconnect-MqttSession -Session $session
+    Write-Host "Disconnected!" -ForegroundColor Green
+}
+catch {
+    Write-Host "Error: $_" -ForegroundColor Red
+}
+finally {
+    # Cleanup
+    Remove-MqttSession -Session $session
+    Write-Host "`nSession cleaned up!" -ForegroundColor Green
+}
+
+Write-Host "`n=== WebSocket Connection Example ===" -ForegroundColor Cyan
+
+# Example 8: WebSocket connection
+Write-Host "`nTesting WebSocket connection..." -ForegroundColor Yellow
+$wsSession = New-MqttSession
+
+try {
+    Connect-MqttSession -Session $wsSession -WebSocketUri "ws://broker.hivemq.com:8000/mqtt"
+    Write-Host "Connected via WebSocket!" -ForegroundColor Green
+    
+    Publish-MqttMessage -Session $wsSession -Topic "test/websocket" -Payload "Hello via WebSocket!"
+    Write-Host "Message published via WebSocket!" -ForegroundColor Green
+    
+    Disconnect-MqttSession -Session $wsSession
+}
+catch {
+    Write-Host "WebSocket Error: $_" -ForegroundColor Red
+}
+finally {
+    Remove-MqttSession -Session $wsSession
+}
+
+Write-Host "`n=== Connection with Will Message Example ===" -ForegroundColor Cyan
+
+# Example 9: Connection with Last Will Testament
+Write-Host "`nTesting connection with Will message..." -ForegroundColor Yellow
+$willSession = New-MqttSession
+
+try {
+    Connect-MqttSession -Session $willSession -Host "broker.hivemq.com" `
+        -WillTopic "test/will" -WillPayload "Client disconnected unexpectedly" -WillQoS 1 -WillRetain
+    Write-Host "Connected with Will message configured!" -ForegroundColor Green
+    
+    Disconnect-MqttSession -Session $willSession
+}
+catch {
+    Write-Host "Will Error: $_" -ForegroundColor Red
+}
+finally {
+    Remove-MqttSession -Session $willSession
+}
+
+Write-Host "`n=== All tests completed ===" -ForegroundColor Cyan
+
@@ -8,9 +8,9 @@ namespace MQTTnet.Server.EnhancedAuthentication;

 public sealed class ExchangeEnhancedAuthenticationOptions
 {
-    public byte[]? AuthenticationData { get; set; }
+    public byte[] AuthenticationData { get; set; }

-    public string? ReasonString { get; set; }
+    public string ReasonString { get; set; }

-    public List<MqttUserProperty>? UserProperties { get; set; }
+    public List<MqttUserProperty> UserProperties { get; set; }
 }
@@ -53,10 +53,7 @@ public sealed class ExchangeEnhancedAuthenticationOptionsFactory

    public ExchangeEnhancedAuthenticationOptionsFactory WithUserProperty(string name, string value)
    {
-        if (name == null)
-        {
-            throw new ArgumentNullException(nameof(name));
-        }
+        ArgumentNullException.ThrowIfNull(name);

        if (_options.UserProperties == null)
        {
@@ -4,9 +4,9 @@ namespace MQTTnet.Server.EnhancedAuthentication;

 public sealed class ExchangeEnhancedAuthenticationResult
 {
-    public string? ReasonString { get; init; }
+    public string ReasonString { get; set; }

-    public List<MqttUserProperty>? UserProperties { get; init; }
+    public List<MqttUserProperty> UserProperties { get; set; }

-    public byte[]? AuthenticationData { get; init; }
+    public byte[] AuthenticationData { get; set; }
 }
@@ -22,15 +22,15 @@ public sealed class ClientConnectedEventArgs : EventArgs
        SessionItems = sessionItems ?? throw new ArgumentNullException(nameof(sessionItems));
    }

-    public byte[]? AuthenticationData => _connectPacket.AuthenticationData;
+    public byte[] AuthenticationData => _connectPacket.AuthenticationData;

-    public string? AuthenticationMethod => _connectPacket.AuthenticationMethod;
+    public string AuthenticationMethod => _connectPacket.AuthenticationMethod;

    /// <summary>
    ///     Gets the client identifier of the connected client.
    ///     Hint: This identifier needs to be unique over all used clients / devices on the broker to avoid connection issues.
    /// </summary>
-    public string ClientId => _connectPacket.ClientId!;
+    public string ClientId => _connectPacket.ClientId;

    /// <summary>
    ///     Gets the endpoint of the connected client.
@@ -38,7 +38,7 @@ public sealed class ClientConnectedEventArgs : EventArgs
    public EndPoint RemoteEndPoint { get; }

    [Obsolete("Use RemoteEndPoint instead.")]
-    public string? Endpoint => RemoteEndPoint?.ToString();
+    public string Endpoint => RemoteEndPoint?.ToString();

    /// <summary>
    ///     Gets the protocol version which is used by the connected client.
@@ -53,16 +53,16 @@ public sealed class ClientConnectedEventArgs : EventArgs
    /// <summary>
    ///     Gets the user name of the connected client.
    /// </summary>
-    public string? UserName => _connectPacket.Username;
+    public string UserName => _connectPacket.Username;

    /// <summary>
    ///     Gets the password of the connected client.
    /// </summary>
-    public string? Password => Encoding.UTF8.GetString(_connectPacket.Password.AsSpan());
+    public string Password => Encoding.UTF8.GetString(_connectPacket.Password.AsSpan());

    /// <summary>
    ///     Gets the user properties sent by the client.
    ///     <remarks>MQTT 5.0.0+ feature.</remarks>
    /// </summary>
-    public List<MqttUserProperty>? UserProperties => _connectPacket?.UserProperties;
+    public List<MqttUserProperty> UserProperties => _connectPacket?.UserProperties;
 }
@@ -35,24 +35,24 @@ public sealed class ClientDisconnectedEventArgs : EventArgs
    ///     Gets the client identifier.
    ///     Hint: This identifier needs to be unique over all used clients / devices on the broker to avoid connection issues.
    /// </summary>
-    public string ClientId => _connectPacket.ClientId!;
+    public string ClientId => _connectPacket.ClientId;

    /// <summary>
    ///     Gets the user name of the client.
    /// </summary>
-    public string? UserName => _connectPacket.Username;
+    public string UserName => _connectPacket.Username;

    /// <summary>
    ///     Gets the password of the client.
    /// </summary>
-    public string? Password => Encoding.UTF8.GetString(_connectPacket.Password.AsSpan());
+    public string Password => Encoding.UTF8.GetString(_connectPacket.Password.AsSpan());

    public MqttClientDisconnectType DisconnectType { get; }

    public EndPoint RemoteEndPoint { get; }

    [Obsolete("Use RemoteEndPoint instead.")]
-    public string? Endpoint => RemoteEndPoint?.ToString();
+    public string Endpoint => RemoteEndPoint?.ToString();

    /// <summary>
    ///     Gets the reason code sent by the client.
@@ -66,7 +66,7 @@ public sealed class ClientDisconnectedEventArgs : EventArgs
    ///     Only available for clean disconnects.
    ///     <remarks>MQTT 5.0.0+ feature.</remarks>
    /// </summary>
-    public string? ReasonString => _disconnectPacket?.ReasonString;
+    public string ReasonString => _disconnectPacket?.ReasonString;

    /// <summary>
    ///     Gets the session expiry interval sent by the client.
@@ -85,5 +85,5 @@ public sealed class ClientDisconnectedEventArgs : EventArgs
    ///     Only available for clean disconnects.
    ///     <remarks>MQTT 5.0.0+ feature.</remarks>
    /// </summary>
-    public List<MqttUserProperty>? UserProperties => _disconnectPacket?.UserProperties;
+    public List<MqttUserProperty> UserProperties => _disconnectPacket?.UserProperties;
 }
@@ -10,7 +10,7 @@ namespace MQTTnet.Server;

 public sealed class InterceptingPacketEventArgs : EventArgs
 {
-    public InterceptingPacketEventArgs(CancellationToken cancellationToken, string clientId, string userName, EndPoint remoteEndPoint, MqttPacket packet, IDictionary sessionItems)
+    public InterceptingPacketEventArgs(string clientId, string userName, EndPoint remoteEndPoint, MqttPacket packet, IDictionary sessionItems, CancellationToken cancellationToken)
    {
        CancellationToken = cancellationToken;
        ClientId = clientId ?? throw new ArgumentNullException(nameof(clientId));
@@ -8,7 +8,7 @@ namespace MQTTnet.Server;

 public sealed class InterceptingPublishEventArgs : EventArgs
 {
-    public InterceptingPublishEventArgs(MqttApplicationMessage applicationMessage, CancellationToken cancellationToken, string clientId, string userName, IDictionary sessionItems)
+    public InterceptingPublishEventArgs(MqttApplicationMessage applicationMessage, string clientId, string userName, IDictionary sessionItems, CancellationToken cancellationToken)
    {
        ApplicationMessage = applicationMessage ?? throw new ArgumentNullException(nameof(applicationMessage));
        CancellationToken = cancellationToken;
@@ -30,11 +30,6 @@ public sealed class InterceptingPublishEventArgs : EventArgs
    /// </summary>
    public string ClientId { get; }

-    /// <summary>
-    /// Gets the user name of the client.
-    /// </summary>
-    public string UserName { get; }
-
    public bool CloseConnection { get; set; }

    /// <summary>
@@ -45,10 +40,15 @@ public sealed class InterceptingPublishEventArgs : EventArgs
    /// <summary>
    ///     Gets the response which will be sent to the client via the PUBACK etc. packets.
    /// </summary>
-    public PublishResponse Response { get; } = new PublishResponse();
+    public PublishResponse Response { get; } = new();

    /// <summary>
    ///     Gets or sets a key/value collection that can be used to share data within the scope of this session.
    /// </summary>
    public IDictionary SessionItems { get; }
+
+    /// <summary>
+    ///     Gets the user name of the client.
+    /// </summary>
+    public string UserName { get; }
 }
@@ -10,12 +10,12 @@ namespace MQTTnet.Server;
 public sealed class InterceptingSubscriptionEventArgs : EventArgs
 {
    public InterceptingSubscriptionEventArgs(
-        CancellationToken cancellationToken,
        string clientId,
        string userName,
        MqttSessionStatus session,
        MqttTopicFilter topicFilter,
-        List<MqttUserProperty> userProperties)
+        List<MqttUserProperty> userProperties,
+        CancellationToken cancellationToken)
    {
        CancellationToken = cancellationToken;
        ClientId = clientId;
@@ -36,11 +36,6 @@ public sealed class InterceptingSubscriptionEventArgs : EventArgs
    /// </summary>
    public string ClientId { get; }

-    /// <summary>
-    /// Gets the user name of the client.
-    /// </summary>
-    public string UserName { get; }
-
    /// <summary>
    ///     Gets or sets whether the broker should close the client connection.
    /// </summary>
@@ -61,7 +56,7 @@ public sealed class InterceptingSubscriptionEventArgs : EventArgs
    /// <summary>
    ///     Gets the response which will be sent to the client via the SUBACK packet.
    /// </summary>
-    public SubscribeResponse Response { get; } = new SubscribeResponse();
+    public SubscribeResponse Response { get; } = new();

    /// <summary>
    ///     Gets the current client session.
@@ -79,6 +74,11 @@ public sealed class InterceptingSubscriptionEventArgs : EventArgs
    /// </summary>
    public MqttTopicFilter TopicFilter { get; set; }

+    /// <summary>
+    ///     Gets the user name of the client.
+    /// </summary>
+    public string UserName { get; }
+
    /// <summary>
    ///     Gets or sets the user properties.
    ///     <remarks>MQTT 5.0.0+ feature.</remarks>
@@ -9,7 +9,7 @@ namespace MQTTnet.Server;

 public sealed class InterceptingUnsubscriptionEventArgs : EventArgs
 {
-    public InterceptingUnsubscriptionEventArgs(CancellationToken cancellationToken, string clientId, string userName, IDictionary sessionItems, string topic, List<MqttUserProperty> userProperties)
+    public InterceptingUnsubscriptionEventArgs(string clientId, string userName, IDictionary sessionItems, string topic, List<MqttUserProperty> userProperties, CancellationToken cancellationToken)
    {
        CancellationToken = cancellationToken;
        ClientId = clientId;
@@ -12,7 +12,7 @@ namespace MQTTnet.Server.Internal.Adapter;

 public sealed class MqttTcpServerAdapter : IMqttServerAdapter
 {
-    readonly List<MqttTcpServerListener> _listeners = new();
+    readonly List<MqttTcpServerListener> _listeners = new List<MqttTcpServerListener>();

    CancellationTokenSource _cancellationTokenSource;

@@ -165,8 +165,8 @@ public sealed class MqttTcpServerListener : IDisposable

    async Task TryHandleClientConnectionAsync(CrossPlatformSocket clientSocket)
    {
-        Stream? stream = null;
-        EndPoint? remoteEndPoint = null;
+        Stream stream = null;
+        EndPoint remoteEndPoint = null;

        try
        {
@@ -211,7 +211,7 @@ public sealed class MqttTcpServerListener : IDisposable
            var clientHandler = ClientHandler;
            if (clientHandler != null)
            {
-                var tcpChannel = new MqttTcpChannel(stream, remoteEndPoint, clientCertificate);
+                var tcpChannel = new MqttTcpChannel(stream, _localEndPoint, remoteEndPoint, clientCertificate);
                var bufferWriter = new MqttBufferWriter(_serverOptions.WriterBufferSize, _serverOptions.WriterBufferSizeMax);
                var packetFormatterAdapter = new MqttPacketFormatterAdapter(bufferWriter);

@@ -131,7 +131,7 @@ public sealed class MqttClientSessionsManager : ISubscriptionChangedNotification
        // Allow the user to intercept application message...
        if (_eventContainer.InterceptingPublishEvent.HasHandlers)
        {
-            var interceptingPublishEventArgs = new InterceptingPublishEventArgs(applicationMessage, cancellationToken, senderId, senderUserName, senderSessionItems);
+            var interceptingPublishEventArgs = new InterceptingPublishEventArgs(applicationMessage, senderId, senderUserName, senderSessionItems, cancellationToken);
            if (string.IsNullOrEmpty(interceptingPublishEventArgs.ApplicationMessage.Topic))
            {
                // This can happen if a topic alias us used but the topic is
@@ -437,7 +437,7 @@ public sealed class MqttClientSessionsManager : ISubscriptionChangedNotification
        }
    }

-    public void OnSubscriptionsAdded(MqttSession clientSession, List<string> topics)
+    public void OnSubscriptionsAdded(MqttSession clientSession, List<string> subscriptionsTopics)
    {
        _sessionsManagementLock.EnterWriteLock();
        try
@@ -448,7 +448,7 @@ public sealed class MqttClientSessionsManager : ISubscriptionChangedNotification
                _subscriberSessions.Add(clientSession);
            }

-            foreach (var topic in topics)
+            foreach (var topic in subscriptionsTopics)
            {
                clientSession.AddSubscribedTopic(topic);
            }
@@ -667,7 +667,7 @@ public sealed class MqttClientSessionsManager : ISubscriptionChangedNotification
        }
    }

-    async Task<MqttConnectPacket?> ReceiveConnectPacket(IMqttChannelAdapter channelAdapter, CancellationToken cancellationToken)
+    async Task<MqttConnectPacket> ReceiveConnectPacket(IMqttChannelAdapter channelAdapter, CancellationToken cancellationToken)
    {
        try
        {
@@ -81,7 +81,7 @@ public sealed class MqttClientSubscriptionsManager : IDisposable
            return CheckSubscriptionsResult.NotSubscribed;
        }

-        var senderIsReceiver = string.Equals(senderId, _session.Id);
+        var senderIsReceiver = string.Equals(senderId, _session.Id, StringComparison.Ordinal);
        var maxQoSLevel = -1; // Not subscribed.

        HashSet<uint> subscriptionIdentifiers = null;
@@ -460,7 +460,7 @@ public sealed class MqttClientSubscriptionsManager : IDisposable
        List<MqttUserProperty> userProperties,
        CancellationToken cancellationToken)
    {
-        var eventArgs = new InterceptingSubscriptionEventArgs(cancellationToken, _session.Id, _session.UserName, new MqttSessionStatus(_session), topicFilter, userProperties);
+        var eventArgs = new InterceptingSubscriptionEventArgs(_session.Id, _session.UserName, new MqttSessionStatus(_session), topicFilter, userProperties, cancellationToken);

        if (topicFilter.QualityOfServiceLevel == MqttQualityOfServiceLevel.AtMostOnce)
        {
@@ -475,7 +475,7 @@ public sealed class MqttClientSubscriptionsManager : IDisposable
            eventArgs.Response.ReasonCode = MqttSubscribeReasonCode.GrantedQoS2;
        }

-        if (topicFilter.Topic.StartsWith("$share/"))
+        if (topicFilter.Topic.StartsWith("$share/", StringComparison.InvariantCulture))
        {
            eventArgs.Response.ReasonCode = MqttSubscribeReasonCode.SharedSubscriptionsNotSupported;
        }
@@ -493,7 +493,7 @@ public sealed class MqttClientSubscriptionsManager : IDisposable
        List<MqttUserProperty> userProperties,
        CancellationToken cancellationToken)
    {
-        var clientUnsubscribingTopicEventArgs = new InterceptingUnsubscriptionEventArgs(cancellationToken, _session.Id, _session.UserName, _session.Items, topicFilter, userProperties)
+        var clientUnsubscribingTopicEventArgs = new InterceptingUnsubscriptionEventArgs(_session.Id, _session.UserName, _session.Items, topicFilter, userProperties, cancellationToken)
        {
            Response =
            {
@@ -156,7 +156,7 @@ public sealed class MqttConnectedClient : IDisposable
                // TODO: Maybe adding a configuration option is requested in the future.
                if (disconnectOptions != null)
                {
-                    if (disconnectOptions.ReasonCode != MqttDisconnectReasonCode.NormalDisconnection || disconnectOptions.UserProperties?.Any() == true ||
+                    if (disconnectOptions.ReasonCode != MqttDisconnectReasonCode.NormalDisconnection || disconnectOptions.UserProperties?.Count > 0 ||
                        !string.IsNullOrEmpty(disconnectOptions.ReasonString) || !string.IsNullOrEmpty(disconnectOptions.ServerReference))
                    {
                        // It is very important to send the DISCONNECT packet here BEFORE cancelling the
@@ -349,7 +349,7 @@ public sealed class MqttConnectedClient : IDisposable
            return packet;
        }

-        var interceptingPacketEventArgs = new InterceptingPacketEventArgs(cancellationToken, Id, UserName, RemoteEndPoint, packet, Session.Items);
+        var interceptingPacketEventArgs = new InterceptingPacketEventArgs(Id, UserName, RemoteEndPoint, packet, Session.Items, cancellationToken);
        await _eventContainer.InterceptingOutboundPacketEvent.InvokeAsync(interceptingPacketEventArgs).ConfigureAwait(false);

        if (!interceptingPacketEventArgs.ProcessPacket || packet == null)
@@ -395,7 +395,7 @@ public sealed class MqttConnectedClient : IDisposable

                if (_eventContainer.InterceptingInboundPacketEvent.HasHandlers)
                {
-                    var interceptingPacketEventArgs = new InterceptingPacketEventArgs(cancellationToken, Id, UserName, RemoteEndPoint, currentPacket, Session.Items);
+                    var interceptingPacketEventArgs = new InterceptingPacketEventArgs(Id, UserName, RemoteEndPoint, currentPacket, Session.Items, cancellationToken);
                    await _eventContainer.InterceptingInboundPacketEvent.InvokeAsync(interceptingPacketEventArgs).ConfigureAwait(false);
                    currentPacket = interceptingPacketEventArgs.Packet;
                    processPacket = interceptingPacketEventArgs.ProcessPacket;
@@ -7,13 +7,12 @@ using MQTTnet.Internal;

 namespace MQTTnet.Server.Internal;

-public sealed class MqttRetainedMessagesManager
+public sealed class MqttRetainedMessagesManager : IDisposable
 {
-    readonly Dictionary<string, MqttApplicationMessage> _messages = new(4096);
-    readonly AsyncLock _storageAccessLock = new();
-
    readonly MqttServerEventContainer _eventContainer;
    readonly MqttNetSourceLogger _logger;
+    readonly Dictionary<string, MqttApplicationMessage> _messages = new(4096);
+    readonly AsyncLock _storageAccessLock = new();

    public MqttRetainedMessagesManager(MqttServerEventContainer eventContainer, IMqttNetLogger logger)
    {
@@ -24,6 +23,46 @@ public sealed class MqttRetainedMessagesManager
        _logger = logger.WithSource(nameof(MqttRetainedMessagesManager));
    }

+    public async Task ClearMessages()
+    {
+        lock (_messages)
+        {
+            _messages.Clear();
+        }
+
+        using (await _storageAccessLock.EnterAsync().ConfigureAwait(false))
+        {
+            await _eventContainer.RetainedMessagesClearedEvent.InvokeAsync(EventArgs.Empty).ConfigureAwait(false);
+        }
+    }
+
+    public void Dispose()
+    {
+        _storageAccessLock.Dispose();
+    }
+
+    public Task<MqttApplicationMessage> GetMessage(string topic)
+    {
+        lock (_messages)
+        {
+            if (_messages.TryGetValue(topic, out var message))
+            {
+                return Task.FromResult(message);
+            }
+        }
+
+        return Task.FromResult<MqttApplicationMessage>(null);
+    }
+
+    public Task<IList<MqttApplicationMessage>> GetMessages()
+    {
+        lock (_messages)
+        {
+            var result = new List<MqttApplicationMessage>(_messages.Values);
+            return Task.FromResult((IList<MqttApplicationMessage>)result);
+        }
+    }
+
    public async Task Start()
    {
        try
@@ -79,8 +118,7 @@ public sealed class MqttRetainedMessagesManager
                    }
                    else
                    {
-                        if (existingMessage.QualityOfServiceLevel != applicationMessage.QualityOfServiceLevel ||
-                            !MqttMemoryHelper.SequenceEqual(existingMessage.Payload, payload))
+                        if (existingMessage.QualityOfServiceLevel != applicationMessage.QualityOfServiceLevel || !MqttMemoryHelper.SequenceEqual(existingMessage.Payload, payload))
                        {
                            _messages[applicationMessage.Topic] = applicationMessage;
                            saveIsRequired = true;
@@ -113,39 +151,4 @@ public sealed class MqttRetainedMessagesManager
            _logger.Error(exception, "Unhandled exception while handling retained messages.");
        }
    }
-
-    public Task<IList<MqttApplicationMessage>> GetMessages()
-    {
-        lock (_messages)
-        {
-            var result = new List<MqttApplicationMessage>(_messages.Values);
-            return Task.FromResult((IList<MqttApplicationMessage>)result);
-        }
-    }
-
-    public Task<MqttApplicationMessage> GetMessage(string topic)
-    {
-        lock (_messages)
-        {
-            if (_messages.TryGetValue(topic, out var message))
-            {
-                return Task.FromResult(message);
-            }
-        }
-
-        return Task.FromResult<MqttApplicationMessage>(null);
-    }
-
-    public async Task ClearMessages()
-    {
-        lock (_messages)
-        {
-            _messages.Clear();
-        }
-
-        using (await _storageAccessLock.EnterAsync().ConfigureAwait(false))
-        {
-            await _eventContainer.RetainedMessagesClearedEvent.InvokeAsync(EventArgs.Empty).ConfigureAwait(false);
-        }
-    }
 }
@@ -1,57 +1,19 @@
 <Project Sdk="Microsoft.NET.Sdk">

    <PropertyGroup>
-        <TargetFramework>net8.0</TargetFramework>
        <AssemblyName>MQTTnet.Server</AssemblyName>
        <RootNamespace>MQTTnet.Server</RootNamespace>
+        <IsAotCompatible>true</IsAotCompatible>
+
        <GeneratePackageOnBuild>True</GeneratePackageOnBuild>
-        <Company>The contributors of MQTTnet</Company>
-        <Product>MQTTnet</Product>
        <GenerateDocumentationFile>true</GenerateDocumentationFile>
        <Description>This is the server implementation of MQTTnet.</Description>
-        <Authors>The contributors of MQTTnet</Authors>
        <PackageId>MQTTnet.Server</PackageId>
-        <DelaySign>false</DelaySign>
-        <SignAssembly>false</SignAssembly>
-        <PublishRepositoryUrl>true</PublishRepositoryUrl>
-        <IncludeSymbols>true</IncludeSymbols>
-        <SymbolPackageFormat>snupkg</SymbolPackageFormat>
-        <Copyright>Copyright (c) .NET Foundation and Contributors</Copyright>
-        <PackageProjectUrl>https://github.com/dotnet/MQTTnet</PackageProjectUrl>
-        <RepositoryUrl>https://github.com/dotnet/MQTTnet.git</RepositoryUrl>
-        <RepositoryType>git</RepositoryType>
        <PackageTags>MQTT Message Queue Telemetry Transport MQTTClient MQTTServer Server MQTTBroker Broker NETStandard IoT InternetOfThings Messaging Hardware Arduino Sensor Actuator M2M ESP Smart Home Cities Automation Xamarin Blazor</PackageTags>
-        <NeutralLanguage>en-US</NeutralLanguage>
-        <EnableNETAnalyzers>false</EnableNETAnalyzers>
-        <EnforceCodeStyleInBuild>false</EnforceCodeStyleInBuild>
-        <PackageIcon>nuget.png</PackageIcon>
-        <EmbedUntrackedSources>true</EmbedUntrackedSources>
-        <ContinuousIntegrationBuild>true</ContinuousIntegrationBuild>
-        <PackageLicenseFile>LICENSE</PackageLicenseFile>
-        <DisableImplicitAspNetCoreAnalyzers>true</DisableImplicitAspNetCoreAnalyzers>
-        <NoWarn>1591;NETSDK1138;NU1803;NU1901;NU1902</NoWarn>
-        <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
-        <NuGetAuditMode>all</NuGetAuditMode>
-        <NuGetAudit>true</NuGetAudit>
-        <NuGetAuditLevel>low</NuGetAuditLevel>
-        <ImplicitUsings>enable</ImplicitUsings>
-        <Nullable>enable</Nullable>
-        <AnalysisLevel>latest-Recommended</AnalysisLevel>
-        <IsAotCompatible>true</IsAotCompatible>
-        <LangVersion>default</LangVersion>
    </PropertyGroup>

    <ItemGroup>
        <ProjectReference Include="..\MQTTnet\MQTTnet.csproj"/>
    </ItemGroup>

-    <ItemGroup>
-        <None Include="..\..\Images\nuget.png" Pack="true" PackagePath="" />
-        <None Include="..\..\LICENSE" Pack="true" PackagePath="" />
-    </ItemGroup>
-
-    <ItemGroup>
-        <PackageReference Include="Microsoft.SourceLink.GitHub" Version="8.0.0" PrivateAssets="All"/>
-    </ItemGroup>
-
 </Project>
@@ -21,7 +21,7 @@ public static class MqttServerExtensions
    public static Task InjectApplicationMessage(
        this MqttServer server,
        string topic,
-        string? payload = null,
+        string payload = null,
        MqttQualityOfServiceLevel qualityOfServiceLevel = MqttQualityOfServiceLevel.AtMostOnce,
        bool retain = false)
    {
@@ -2,12 +2,14 @@
 // The .NET Foundation licenses this file to you under the MIT license.
 // See the LICENSE file in the project root for more information.

+using System.Diagnostics.CodeAnalysis;
 using MQTTnet.Diagnostics.Logger;
 using MQTTnet.Server.EnhancedAuthentication;
 using MQTTnet.Server.Internal.Adapter;

 namespace MQTTnet.Server;

+[SuppressMessage("Performance", "CA1822:Mark members as static")]
 public sealed class MqttServerFactory
 {
    public MqttServerFactory() : this(new MqttNetNullLogger())
@@ -5,8 +5,8 @@
 using System.Net;
 using System.Net.Security;
 using System.Security.Authentication;
-using MQTTnet.Certificates;
 using System.Security.Cryptography.X509Certificates;
+using MQTTnet.Certificates;

 // ReSharper disable UnusedMember.Global
 namespace MQTTnet.Server;
@@ -20,7 +20,7 @@ public class MqttServerOptionsBuilder
        return _options;
    }

-    public MqttServerOptionsBuilder WithClientCertificate(RemoteCertificateValidationCallback? validationCallback = null, bool checkCertificateRevocation = false)
+    public MqttServerOptionsBuilder WithClientCertificate(RemoteCertificateValidationCallback validationCallback = null, bool checkCertificateRevocation = false)
    {
        _options.TlsEndpointOptions.ClientCertificateRequired = true;
        _options.TlsEndpointOptions.CheckCertificateRevocation = checkCertificateRevocation;
@@ -47,12 +47,22 @@ public class MqttServerOptionsBuilder
        return this;
    }

+    /// <summary>
+    ///     Sets the IPv4 network address to bind.
+    ///     Defaults to any available IPv4 address of the machine.
+    ///     Set this to `IPAddress.None` to disable the IPv4 support entirely.
+    /// </summary>
    public MqttServerOptionsBuilder WithDefaultEndpointBoundIPAddress(IPAddress value)
    {
        _options.DefaultEndpointOptions.BoundInterNetworkAddress = value ?? IPAddress.Any;
        return this;
    }

+    /// <summary>
+    ///     Sets the IPv6 network address to bind.
+    ///     Defaults to any available IPv6 address of the machine.
+    ///     Set this to `IPAddress.None` to disable the IPv6 support entirely.
+    /// </summary>
    public MqttServerOptionsBuilder WithDefaultEndpointBoundIPV6Address(IPAddress value)
    {
        _options.DefaultEndpointOptions.BoundInterNetworkV6Address = value ?? IPAddress.Any;
@@ -77,12 +87,22 @@ public class MqttServerOptionsBuilder
        return this;
    }

+    /// <summary>
+    ///     Sets the IPv4 network address to bind.
+    ///     Defaults to any available IPv4 address of the machine.
+    ///     Set this to `IPAddress.None` to disable the IPv4 support entirely.
+    /// </summary>
    public MqttServerOptionsBuilder WithEncryptedEndpointBoundIPAddress(IPAddress value)
    {
        _options.TlsEndpointOptions.BoundInterNetworkAddress = value;
        return this;
    }

+    /// <summary>
+    ///     Sets the IPv6 network address to bind.
+    ///     Defaults to any available IPv6 address of the machine.
+    ///     Set this to `IPAddress.None` to disable the IPv6 support entirely.
+    /// </summary>
    public MqttServerOptionsBuilder WithEncryptedEndpointBoundIPV6Address(IPAddress value)
    {
        _options.TlsEndpointOptions.BoundInterNetworkV6Address = value;
@@ -95,6 +115,35 @@ public class MqttServerOptionsBuilder
        return this;
    }

+    public MqttServerOptionsBuilder WithEncryptionCertificate(byte[] value, IMqttServerCertificateCredentials credentials = null)
+    {
+        ArgumentNullException.ThrowIfNull(value);
+
+        _options.TlsEndpointOptions.CertificateProvider = new BlobCertificateProvider(value)
+        {
+            Password = credentials?.Password
+        };
+
+        return this;
+    }
+
+    public MqttServerOptionsBuilder WithEncryptionCertificate(X509Certificate2 certificate)
+    {
+        ArgumentNullException.ThrowIfNull(certificate);
+
+        _options.TlsEndpointOptions.CertificateProvider = new X509CertificateProvider(certificate);
+        return this;
+    }
+
+    public MqttServerOptionsBuilder WithEncryptionCertificate(ICertificateProvider certificateProvider)
+    {
+        ArgumentNullException.ThrowIfNull(certificateProvider);
+
+        _options.TlsEndpointOptions.CertificateProvider = certificateProvider;
+
+        return this;
+    }
+
    public MqttServerOptionsBuilder WithEncryptionSslProtocol(SslProtocols value)
    {
        _options.TlsEndpointOptions.SslProtocol = value;
@@ -114,12 +163,6 @@ public class MqttServerOptionsBuilder
        return this;
    }

-    public MqttServerOptionsBuilder WithPendingMessagesOverflowStrategy(MqttPendingMessagesOverflowStrategy value)
-    {
-        _options.PendingMessagesOverflowStrategy = value;
-        return this;
-    }
-
    public MqttServerOptionsBuilder WithoutDefaultEndpoint()
    {
        _options.DefaultEndpointOptions.IsEnabled = false;
@@ -144,6 +187,12 @@ public class MqttServerOptionsBuilder
        return this;
    }

+    public MqttServerOptionsBuilder WithPendingMessagesOverflowStrategy(MqttPendingMessagesOverflowStrategy value)
+    {
+        _options.PendingMessagesOverflowStrategy = value;
+        return this;
+    }
+
    public MqttServerOptionsBuilder WithPersistentSessions(bool value = true)
    {
        _options.EnablePersistentSessions = value;
@@ -182,33 +231,4 @@ public class MqttServerOptionsBuilder
        _options.TlsEndpointOptions.ReuseAddress = true;
        return this;
    }
-
-    public MqttServerOptionsBuilder WithEncryptionCertificate(byte[] value, IMqttServerCertificateCredentials? credentials = null)
-    {
-        ArgumentNullException.ThrowIfNull(value);
-
-        _options.TlsEndpointOptions.CertificateProvider = new BlobCertificateProvider(value)
-        {
-            Password = credentials?.Password
-        };
-
-        return this;
-    }
-
-    public MqttServerOptionsBuilder WithEncryptionCertificate(X509Certificate2 certificate)
-    {
-        ArgumentNullException.ThrowIfNull(certificate);
-
-        _options.TlsEndpointOptions.CertificateProvider = new X509CertificateProvider(certificate);
-        return this;
-    }
-
-    public MqttServerOptionsBuilder WithEncryptionCertificate(ICertificateProvider certificateProvider)
-    {
-        ArgumentNullException.ThrowIfNull(certificateProvider);
-
-        _options.TlsEndpointOptions.CertificateProvider = certificateProvider;
-
-        return this;
-    }
 }
@@ -9,13 +9,30 @@ namespace MQTTnet.Server;

 public abstract class MqttServerTcpEndpointBaseOptions
 {
-    public bool IsEnabled { get; set; }
+    /// <summary>
+    ///     Usually the MQTT packets can be sent partially. This is done by using multiple TCP packets
+    ///     or WebSocket frames etc. Unfortunately not all clients do support this feature and
+    ///     will close the connection when receiving such packets. If such clients are connecting to this
+    ///     server the flag must be set to _false_.
+    /// </summary>
+    public bool AllowPacketFragmentation { get; set; } = true;

-    public int Port { get; set; }
+    /// <summary>
+    ///     Gets or sets the IPv4 network address to bind.
+    ///     Defaults to any available IPv4 address of the machine.
+    ///     Set this to `IPAddress.None` to disable the IPv4 support entirely.
+    /// </summary>
+    public IPAddress BoundInterNetworkAddress { get; set; } = IPAddress.Any;
+
+    /// <summary>
+    ///     Gets or sets the IPv6 network address to bind.
+    ///     Defaults to any available IPv6 address of the machine.
+    ///     Set this to `IPAddress.None` to disable the IPv6 support entirely.
+    /// </summary>
+    public IPAddress BoundInterNetworkV6Address { get; set; } = IPAddress.IPv6Any;

    public int ConnectionBacklog { get; set; } = 100;
-
-    public bool NoDelay { get; set; } = true;
+    public bool IsEnabled { get; set; }

    /// <summary>
    ///     Gets or sets whether the sockets keep alive feature should be used.
@@ -23,13 +40,16 @@ public abstract class MqttServerTcpEndpointBaseOptions
    /// </summary>
    public bool? KeepAlive { get; set; }

+    public LingerOption LingerState { get; set; } = new(true, 0);
+
+    public bool NoDelay { get; set; } = true;
+
+    public int Port { get; set; }
+
    /// <summary>
-    ///     Usually the MQTT packets can be send partially. This is done by using multiple TCP packets
-    ///     or WebSocket frames etc. Unfortunately not all clients do support this feature and
-    ///     will close the connection when receiving such packets. If such clients are connecting to this
-    ///     server the flag must be set to _false_.
+    ///     This requires admin permissions on Linux.
    /// </summary>
-    public bool AllowPacketFragmentation { get; set; } = true;
+    public bool ReuseAddress { get; set; }

    /// <summary>
    ///     Gets or sets the TCP keep alive interval.
@@ -48,15 +68,4 @@ public abstract class MqttServerTcpEndpointBaseOptions
    ///     The value _null_ indicates that the OS and framework defaults should be used.
    /// </summary>
    public int? TcpKeepAliveTime { get; set; }
-
-    public LingerOption LingerState { get; set; } = new LingerOption(true, 0);
-
-    public IPAddress BoundInterNetworkAddress { get; set; } = IPAddress.Any;
-
-    public IPAddress BoundInterNetworkV6Address { get; set; } = IPAddress.IPv6Any;
-
-    /// <summary>
-    ///     This requires admin permissions on Linux.
-    /// </summary>
-    public bool ReuseAddress { get; set; }
 }
@@ -16,7 +16,7 @@ public sealed class SubscribeResponse
    /// </summary>
    public MqttSubscribeReasonCode ReasonCode { get; set; }

-    public string? ReasonString { get; set; }
+    public string ReasonString { get; set; }

-    public List<MqttUserProperty>? UserProperties { get; set; } = [];
+    public List<MqttUserProperty> UserProperties { get; } = [];
 }
@@ -15,7 +15,7 @@ public sealed class UnsubscribeResponse
    /// </summary>
    public MqttUnsubscribeReasonCode ReasonCode { get; set; }

-    public string? ReasonString { get; set; }
+    public string ReasonString { get; set; }

-    public List<MqttUserProperty>? UserProperties { get; } = [];
+    public List<MqttUserProperty> UserProperties { get; } = [];
 }
@@ -11,7 +11,7 @@ namespace MQTTnet.TestApp;

 public sealed class AsyncLockTest
 {
-    public async Task Run()
+    public static async Task Run()
    {
        try
        {
@@ -3,19 +3,7 @@
    <PropertyGroup>
        <OutputType>Exe</OutputType>
        <DebugType>Full</DebugType>
-        <TargetFramework>net8.0</TargetFramework>
        <IsPackable>false</IsPackable>
-        <EnableNETAnalyzers>false</EnableNETAnalyzers>
-        <EnforceCodeStyleInBuild>false</EnforceCodeStyleInBuild>
-        <DisableImplicitAspNetCoreAnalyzers>true</DisableImplicitAspNetCoreAnalyzers>
-        <NoWarn>1591;NETSDK1138;NU1803;NU1901;NU1902</NoWarn>
-        <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
-        <NuGetAuditMode>all</NuGetAuditMode>
-        <NuGetAudit>true</NuGetAudit>
-        <NuGetAuditLevel>low</NuGetAuditLevel>
-        <AnalysisLevel>latest-Recommended</AnalysisLevel>
-        <LangVersion>default</LangVersion>
-        <Nullable>enable</Nullable>
    </PropertyGroup>

    <ItemGroup>
@@ -14,7 +14,7 @@ namespace MQTTnet.TestApp;
 /// the number of messages per second that can be exchanged between publishers and subscriber.
 /// Measurements are performed for subscriptions containing no wildcard, a single wildcard or multiple wildcards.
 /// </summary>
-public class MessageThroughputTest
+public sealed class MessageThroughputTest : IDisposable
 {
    // Change these constants to suit
    const int NumPublishers = 5000;
@@ -55,9 +55,9 @@ public class MessageThroughputTest

            await Setup();

-            await Subscribe_to_No_Wildcard_Topics();
-            await Subscribe_to_Single_Wildcard_Topics();
-            await Subscribe_to_Multi_Wildcard_Topics();
+            await SubscribeToNoWildcardTopics();
+            await SubscribeToSingleWildcardTopics();
+            await SubscribeToMultiWildcardTopics();

            Console.WriteLine();
            Console.WriteLine("End message throughput test");
@@ -74,7 +74,7 @@ public class MessageThroughputTest

    public async Task Setup()
    {
-        new TopicGenerator().Generate(NumPublishers, NumTopicsPerPublisher, out _topicsByPublisher, out _singleWildcardTopicsByPublisher, out _multiWildcardTopicsByPublisher);
+        TopicGenerator.Generate(NumPublishers, NumTopicsPerPublisher, out _topicsByPublisher, out _singleWildcardTopicsByPublisher, out _multiWildcardTopicsByPublisher);

        var serverOptions = new MqttServerOptionsBuilder().WithDefaultEndpoint().Build();
        var mqttClientFactory = new MqttClientFactory();
@@ -152,7 +152,7 @@ public class MessageThroughputTest
    /// <summary>
    /// Measure no-wildcard topic subscription message exchange performance
    /// </summary>
-    public Task Subscribe_to_No_Wildcard_Topics()
+    public Task SubscribeToNoWildcardTopics()
    {
        return ProcessMessages(_topicsByPublisher, "no wildcards");
    }
@@ -160,7 +160,7 @@ public class MessageThroughputTest
    /// <summary>
    /// Measure single-wildcard topic subscription message exchange performance
    /// </summary>
-    public Task Subscribe_to_Single_Wildcard_Topics()
+    public Task SubscribeToSingleWildcardTopics()
    {
        return ProcessMessages(_singleWildcardTopicsByPublisher, "single wildcard");
    }
@@ -168,7 +168,7 @@ public class MessageThroughputTest
    /// <summary>
    /// Measure multi-wildcard topic subscription message exchange performance
    /// </summary>
-    public Task Subscribe_to_Multi_Wildcard_Topics()
+    public Task SubscribeToMultiWildcardTopics()
    {
        return ProcessMessages(_multiWildcardTopicsByPublisher, "multi wildcard");
    }
@@ -342,4 +342,8 @@ public class MessageThroughputTest
        Console.ResetColor();
    }

+    public void Dispose()
+    {
+        _cancellationTokenSource.Dispose();
+    }
 }
@@ -34,7 +34,9 @@ public static class MqttNetConsoleLogger
    static void PrintToConsole(object sender, MqttNetLogMessagePublishedEventArgs e)
    {
        var output = new StringBuilder();
+#pragma warning disable CA1305
        output.AppendLine($">> [{e.LogMessage.Timestamp:O}] [{e.LogMessage.ThreadId}] [{e.LogMessage.Source}] [{e.LogMessage.Level}]: {e.LogMessage.Message}");
+#pragma warning restore CA1305
        if (e.LogMessage.Exception != null)
        {
            output.AppendLine(e.LogMessage.Exception.ToString());
@@ -204,7 +204,7 @@ public static class PerformanceTest
        };
    }

-    static Task PublishSingleMessage(IMqttClient client, MqttApplicationMessage applicationMessage, ref int count)
+    static Task<MqttClientPublishResult> PublishSingleMessage(IMqttClient client, MqttApplicationMessage applicationMessage, ref int count)
    {
        Interlocked.Increment(ref count);
        return Task.Run(() => client.PublishAsync(applicationMessage));
@@ -85,7 +85,7 @@ public static class Program
        }
        else if (pressedKey.KeyChar == 'f')
        {
-            Task.Run(new AsyncLockTest().Run);
+            Task.Run(AsyncLockTest.Run);
        }

        Thread.Sleep(Timeout.Infinite);
@@ -157,7 +157,7 @@ public static class PublicBrokerTest

                if (receivedMessage?.Topic != topic || receivedMessage?.ConvertPayloadToString() != "Hello_World")
                {
-                    throw new Exception("Message invalid.");
+                    throw new InvalidOperationException("Message invalid.");
                }

                await client.UnsubscribeAsync(topic).ConfigureAwait(false);
@@ -129,12 +129,12 @@ public static class ServerTest

            mqttServer.InterceptingSubscriptionAsync += e =>
            {
-                if (e.TopicFilter.Topic.StartsWith("admin/foo/bar") && e.ClientId != "theAdmin")
+                if (e.TopicFilter.Topic.StartsWith("admin/foo/bar", StringComparison.InvariantCulture) && e.ClientId != "theAdmin")
                {
                    e.Response.ReasonCode = MqttSubscribeReasonCode.ImplementationSpecificError;
                }

-                if (e.TopicFilter.Topic.StartsWith("the/secret/stuff") && e.ClientId != "Imperator")
+                if (e.TopicFilter.Topic.StartsWith("the/secret/stuff", StringComparison.InvariantCulture) && e.ClientId != "Imperator")
                {
                    e.Response.ReasonCode = MqttSubscribeReasonCode.ImplementationSpecificError;
                    e.CloseConnection = true;
@@ -6,7 +6,7 @@ namespace MQTTnet.TestApp;

 public class TopicGenerator
 {
-    public void Generate(
+    public static void Generate(
        int numPublishers, int numTopicsPerPublisher,
        out Dictionary<string, List<string>> topicsByPublisher,
        out Dictionary<string, List<string>> singleWildcardTopicsByPublisher,
@@ -84,14 +84,14 @@ public class TopicGenerator
        }
    }

-    void AddPublisherTopic(string publisherName, string topic, Dictionary<string, List<string>> topicsByPublisher)
+    static void AddPublisherTopic(string publisherName, string topic, Dictionary<string, List<string>> topicsByPublisher)
    {
-        List<string> topicList;
-        if (!topicsByPublisher.TryGetValue(publisherName, out topicList))
+        if (!topicsByPublisher.TryGetValue(publisherName, out var topicList))
        {
            topicList = new List<string>();
            topicsByPublisher.Add(publisherName, topicList);
        }
+
        topicList.Add(topic);
    }
 }
@@ -119,9 +119,11 @@ public class MqttConnectionContextTest
        await Assert.ThrowsExactlyAsync<MqttCommunicationException>(() => ctx.ReceivePacketAsync(CancellationToken.None)).ConfigureAwait(false);
    }

-    class Startup
+    sealed class Startup
    {
+#pragma warning disable CA1822
        public void Configure(IApplicationBuilder app)
+#pragma warning restore CA1822
        {
        }
    }
@@ -20,12 +20,12 @@ public abstract class BaseTestClass
        return new TestEnvironment(TestContext, protocolVersion, trackUnobservedTaskException);
    }

-    protected Task LongTestDelay()
+    public static Task LongTestDelay()
    {
        return Task.Delay(TimeSpan.FromSeconds(1));
    }

-    protected Task MediumTestDelay()
+    public static Task MediumTestDelay()
    {
        return Task.Delay(TimeSpan.FromSeconds(0.5));
    }
@@ -188,7 +188,7 @@ public sealed class LowLevelMqttClient_Tests : BaseTestClass
        return await client.ReceiveAsync(CancellationToken.None) as MqttConnAckPacket;
    }

-    async Task<MqttSubAckPacket> Subscribe(ILowLevelMqttClient client, string topic)
+    static async Task<MqttSubAckPacket> Subscribe(ILowLevelMqttClient client, string topic)
    {
        await client.SendAsync(
                new MqttSubscribePacket
@@ -73,7 +73,7 @@ public sealed class MqttClient_Connection_Tests : BaseTestClass
        catch (Exception exception)
        {
            Assert.IsNotNull(exception);
-            Assert.IsInstanceOfType(exception, typeof(MqttCommunicationException));
+            Assert.IsInstanceOfType<MqttCommunicationException>(exception);
        }

        await LongTestDelay(); // disconnected handler is called async
@@ -161,7 +161,7 @@ public sealed class MqttClient_Connection_Tests : BaseTestClass
        Assert.AreEqual("test_value", eventArgs.UserProperties[0].Value);
    }

-    class TestClientKerberosAuthenticationHandler : IMqttEnhancedAuthenticationHandler
+    sealed class TestClientKerberosAuthenticationHandler : IMqttEnhancedAuthenticationHandler
    {
        public async Task HandleEnhancedAuthenticationAsync(MqttEnhancedAuthenticationEventArgs eventArgs)
        {
@@ -6,6 +6,7 @@ using System;
 using System.Buffers;
 using System.Collections.Generic;
 using System.Diagnostics;
+using System.Globalization;
 using System.Linq;
 using System.Net.Sockets;
 using System.Text;
@@ -122,8 +123,8 @@ public sealed class MqttClient_Tests : BaseTestClass
        await Task.Delay(500);

        Assert.IsNotNull(ex);
-        Assert.IsInstanceOfType(ex, typeof(MqttCommunicationException));
-        Assert.IsInstanceOfType(ex.InnerException, typeof(SocketException));
+        Assert.IsInstanceOfType<MqttCommunicationException>(ex);
+        Assert.IsInstanceOfType<SocketException>(ex.InnerException);
    }

    [TestMethod]
@@ -245,8 +246,8 @@ public sealed class MqttClient_Tests : BaseTestClass
        catch (Exception exception)
        {
            Assert.IsNotNull(exception);
-            Assert.IsInstanceOfType(exception, typeof(MqttCommunicationException));
-            Assert.IsInstanceOfType(exception.InnerException, typeof(SocketException));
+            Assert.IsInstanceOfType<MqttCommunicationException>(exception);
+            Assert.IsInstanceOfType<SocketException>(exception.InnerException);
        }
    }

@@ -355,7 +356,7 @@ public sealed class MqttClient_Tests : BaseTestClass

        async Task Handler1(MqttApplicationMessageReceivedEventArgs eventArgs)
        {
-            var value = int.Parse(eventArgs.ApplicationMessage.ConvertPayloadToString());
+            var value = int.Parse(eventArgs.ApplicationMessage.ConvertPayloadToString(), CultureInfo.InvariantCulture);
            await Task.Delay(value);

            lock (receivedValues)
@@ -369,7 +370,7 @@ public sealed class MqttClient_Tests : BaseTestClass
        var client2 = await testEnvironment.ConnectClient();
        for (var i = MessagesCount; i > 0; i--)
        {
-            await client2.PublishStringAsync("x", i.ToString());
+            await client2.PublishStringAsync("x", i.ToString(CultureInfo.InvariantCulture));
        }

        await Task.Delay(5000);
@@ -401,7 +402,7 @@ public sealed class MqttClient_Tests : BaseTestClass
        var client2 = await testEnvironment.ConnectClient();
        for (var i = MessagesCount; i > 0; i--)
        {
-            await client2.PublishStringAsync("x", i.ToString(), MqttQualityOfServiceLevel.ExactlyOnce);
+            await client2.PublishStringAsync("x", i.ToString(CultureInfo.InvariantCulture), MqttQualityOfServiceLevel.ExactlyOnce);
        }

        await Task.Delay(5000);
@@ -415,7 +416,7 @@ public sealed class MqttClient_Tests : BaseTestClass

        Task Handler1(MqttApplicationMessageReceivedEventArgs eventArgs)
        {
-            var value = int.Parse(eventArgs.ApplicationMessage.ConvertPayloadToString());
+            var value = int.Parse(eventArgs.ApplicationMessage.ConvertPayloadToString(), CultureInfo.InvariantCulture);
            eventArgs.AutoAcknowledge = false;
            Task.Delay(value).ContinueWith(_ => eventArgs.AcknowledgeAsync(CancellationToken.None));

@@ -0,0 +1,24 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+using Microsoft.VisualStudio.TestTools.UnitTesting;
+using MQTTnet.Exceptions;
+
+namespace MQTTnet.Tests.Exceptions;
+
+[TestClass]
+public class MqttProtocolViolationException_Tests
+{
+    [TestMethod]
+    public void No_For_Max_Large_Variable_Byte_Integer()
+    {
+        MqttProtocolViolationException.ThrowIfVariableByteIntegerExceedsLimit(MqttProtocolViolationException.VariableByteIntegerMaxValue);
+    }
+
+    [TestMethod]
+    public void Throw_Exception_For_Too_Large_Variable_Byte_Integer()
+    {
+        Assert.ThrowsExactly<MqttProtocolViolationException>(() => MqttProtocolViolationException.ThrowIfVariableByteIntegerExceedsLimit(1726790899));
+    }
+}
@@ -220,7 +220,7 @@ public sealed class Rpc_Tests : BaseTestClass
        Assert.AreEqual("pong", Encoding.UTF8.GetString(response));
    }

-    class TestTopicStrategy : IMqttRpcClientTopicGenerationStrategy
+    sealed class TestTopicStrategy : IMqttRpcClientTopicGenerationStrategy
    {
        public MqttRpcTopicPair CreateRpcTopics(TopicGenerationContext context)
        {
@@ -232,7 +232,7 @@ public sealed class Rpc_Tests : BaseTestClass
        }
    }

-    class TestParametersTopicGenerationStrategy : IMqttRpcClientTopicGenerationStrategy
+    sealed class TestParametersTopicGenerationStrategy : IMqttRpcClientTopicGenerationStrategy
    {
        internal const string ExpectedParamName = "test_param_name";

@@ -287,7 +287,7 @@ public sealed class MqttBufferReader_Tests


    // Helper class to build up a reference to elements of various types in a buffer
-    class ElementReference
+    sealed class ElementReference
    {
        public enum BufferElementType
        {
@@ -551,7 +551,7 @@ public sealed class MqttPacketSerialization_V3_Binary_Tests
    }


-    void DeserializeAndCompare(MqttPacket packet, string expectedBase64Value, MqttProtocolVersion protocolVersion = MqttProtocolVersion.V311)
+    static void DeserializeAndCompare(MqttPacket packet, string expectedBase64Value, MqttProtocolVersion protocolVersion = MqttProtocolVersion.V311)
    {
        var writer = WriterFactory();

@@ -35,15 +35,15 @@ public sealed class MqttPacketBus_Tests

        Assert.AreEqual(9, bus.TotalItemsCount);

-        Assert.IsInstanceOfType(bus.DequeueItemAsync(CancellationToken.None).Result.Packet, typeof(MqttPublishPacket));
-        Assert.IsInstanceOfType(bus.DequeueItemAsync(CancellationToken.None).Result.Packet, typeof(MqttSubAckPacket));
-        Assert.IsInstanceOfType(bus.DequeueItemAsync(CancellationToken.None).Result.Packet, typeof(MqttPingRespPacket));
-        Assert.IsInstanceOfType(bus.DequeueItemAsync(CancellationToken.None).Result.Packet, typeof(MqttPublishPacket));
-        Assert.IsInstanceOfType(bus.DequeueItemAsync(CancellationToken.None).Result.Packet, typeof(MqttSubAckPacket));
-        Assert.IsInstanceOfType(bus.DequeueItemAsync(CancellationToken.None).Result.Packet, typeof(MqttPingRespPacket));
-        Assert.IsInstanceOfType(bus.DequeueItemAsync(CancellationToken.None).Result.Packet, typeof(MqttPublishPacket));
-        Assert.IsInstanceOfType(bus.DequeueItemAsync(CancellationToken.None).Result.Packet, typeof(MqttSubAckPacket));
-        Assert.IsInstanceOfType(bus.DequeueItemAsync(CancellationToken.None).Result.Packet, typeof(MqttPingRespPacket));
+        Assert.IsInstanceOfType<MqttPublishPacket>(bus.DequeueItemAsync(CancellationToken.None).Result.Packet);
+        Assert.IsInstanceOfType<MqttSubAckPacket>(bus.DequeueItemAsync(CancellationToken.None).Result.Packet);
+        Assert.IsInstanceOfType<MqttPingRespPacket>(bus.DequeueItemAsync(CancellationToken.None).Result.Packet);
+        Assert.IsInstanceOfType<MqttPublishPacket>(bus.DequeueItemAsync(CancellationToken.None).Result.Packet);
+        Assert.IsInstanceOfType<MqttSubAckPacket>(bus.DequeueItemAsync(CancellationToken.None).Result.Packet);
+        Assert.IsInstanceOfType<MqttPingRespPacket>(bus.DequeueItemAsync(CancellationToken.None).Result.Packet);
+        Assert.IsInstanceOfType<MqttPublishPacket>(bus.DequeueItemAsync(CancellationToken.None).Result.Packet);
+        Assert.IsInstanceOfType<MqttSubAckPacket>(bus.DequeueItemAsync(CancellationToken.None).Result.Packet);
+        Assert.IsInstanceOfType<MqttPingRespPacket>(bus.DequeueItemAsync(CancellationToken.None).Result.Packet);

        Assert.AreEqual(0, bus.TotalItemsCount);
    }
@@ -3,19 +3,10 @@
    <PropertyGroup>

        <OutputType>Exe</OutputType>
-        <TargetFramework>net8.0</TargetFramework>
        <IsPackable>false</IsPackable>
-        <EnableNETAnalyzers>false</EnableNETAnalyzers>
-        <EnforceCodeStyleInBuild>false</EnforceCodeStyleInBuild>
-        <DisableImplicitAspNetCoreAnalyzers>true</DisableImplicitAspNetCoreAnalyzers>
-        <NoWarn>1591;NETSDK1138;NU1803;NU1901;NU1902</NoWarn>
-        <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
-        <NuGetAuditMode>all</NuGetAuditMode>
-        <NuGetAudit>true</NuGetAudit>
-        <NuGetAuditLevel>low</NuGetAuditLevel>
-        <AnalysisLevel>latest-Recommended</AnalysisLevel>
        <LangVersion>default</LangVersion>
-        <Nullable>enable</Nullable>
+        <Nullable>disable</Nullable>
+        <NoWarn>$(NoWarn);CA1707</NoWarn>
    </PropertyGroup>

    <ItemGroup>
@@ -23,7 +14,6 @@
        <PackageReference Include="Microsoft.NET.Test.Sdk" Version="18.0.0" />
        <PackageReference Include="MSTest" Version="4.0.1" />

-
        <FrameworkReference Include="Microsoft.AspNetCore.App" />
    </ItemGroup>

--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
copilot-swe-agent[bot]andchkr1011	06842366b8	Add implementation summary documentation Co-authored-by: chkr1011 <6939810+chkr1011@users.noreply.github.com>	2026-02-07 10:55:09 +00:00
copilot-swe-agent[bot]andchkr1011	9cf9a714cb	Fix WebSocket URI format and remove unnecessary null-forgiving operator Co-authored-by: chkr1011 <6939810+chkr1011@users.noreply.github.com>	2026-02-07 10:52:10 +00:00
copilot-swe-agent[bot]andchkr1011	16f8765562	Add Test-MqttConnection and Show-MqttExamples cmdlets, update documentation Co-authored-by: chkr1011 <6939810+chkr1011@users.noreply.github.com>	2026-02-07 10:50:42 +00:00
copilot-swe-agent[bot]andchkr1011	07b72e75ed	Add comprehensive documentation and smoke tests for PowerShell module Co-authored-by: chkr1011 <6939810+chkr1011@users.noreply.github.com>	2026-02-07 10:49:16 +00:00
copilot-swe-agent[bot]andchkr1011	419d7622d8	Implement enhanced PowerShell cmdlets with async handler, WebSocket, TLS, and more features Co-authored-by: chkr1011 <6939810+chkr1011@users.noreply.github.com>	2026-02-07 10:47:51 +00:00
copilot-swe-agent[bot]andchkr1011	71140d12c7	Remove binary files from git and clean up csproj Co-authored-by: chkr1011 <6939810+chkr1011@users.noreply.github.com>	2026-02-07 10:45:31 +00:00
copilot-swe-agent[bot]andchkr1011	a2957180fa	Initial plan for PowerShell module extension Co-authored-by: chkr1011 <6939810+chkr1011@users.noreply.github.com>	2026-02-07 10:45:13 +00:00
copilot-swe-agent[bot]	ffb455b5b4	Initial plan	2026-02-07 10:43:27 +00:00
christian	076039abc7	Add binary files to repo for testing purposes	2025-10-24 17:35:12 +02:00
christian	61cbaa06a8	Expose more properties	2025-10-20 21:41:20 +02:00
christian	1114fa041d	Add new PowerShell project	2025-10-20 20:52:31 +02:00
Christian	535a4e010c	Add validations of variable byte integers (#2214 ) * Add validations and add docs * Update release notes * Fix build	2025-10-20 14:33:50 +02:00
老九andchristian	37c1eecce5	Add Directory.Build.props. (#2120 ) * Add Directory.Build.props. * Adjust Analysis related properties and add conditional enablement for ContinuousIntegrationBuild. * Adopt new changes in master --------- Co-authored-by: christian <6939810+chkr1011@users.noreply.github.com>	2025-10-20 13:32:31 +02:00
Christian	e791d9aba4	Expose local endpoint in channel adapter (#2213 ) * Expose local endpoint * Update release notes	2025-10-19 23:06:36 +02:00