Add test cmdlet for diagnosing threading issues (v2025.04.15.1714)

src/PSOPNSenseAPI/Cmdlets/TestThreadingCmdlet.cs

@@ -0,0 +1,129 @@
+using System;
+using System.Management.Automation;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace PSOPNSenseAPI.Cmdlets
+{
+    /// <summary>
+    /// <para type="synopsis">Tests threading issues in PowerShell cmdlets.</para>
+    /// <para type="description">The Test-OPNSenseThreading cmdlet tests threading issues in PowerShell cmdlets.</para>
+    /// </summary>
+    [Cmdlet(VerbsDiagnostic.Test, "OPNSenseThreading")]
+    [OutputType(typeof(string))]
+    public class TestThreadingCmdlet : OPNSenseBaseCmdlet
+    {
+        /// <summary>
+        /// <para type="description">The test mode to run.</para>
+        /// </summary>
+        [Parameter(Mandatory = false, Position = 0)]
+        [ValidateSet("Direct", "ConfigureAwait", "SynchronizationContext", "TaskRun")]
+        public string Mode { get; set; } = "Direct";
+
+        /// <summary>
+        /// <para type="description">The delay in milliseconds.</para>
+        /// </summary>
+        [Parameter(Mandatory = false)]
+        public int Delay { get; set; } = 1000;
+
+        /// <summary>
+        /// Processes the cmdlet
+        /// </summary>
+        protected override void ProcessRecordInternal()
+        {
+            WriteVerbose($"Starting test in mode: {Mode}");
+            WriteVerbose($"Current thread ID: {Thread.CurrentThread.ManagedThreadId}");
+            WriteVerbose($"Current synchronization context: {SynchronizationContext.Current != null}");
+
+            switch (Mode)
+            {
+                case "Direct":
+                    TestDirect();
+                    break;
+                case "ConfigureAwait":
+                    TestConfigureAwait();
+                    break;
+                case "SynchronizationContext":
+                    TestSynchronizationContext();
+                    break;
+                case "TaskRun":
+                    TestTaskRun();
+                    break;
+            }
+
+            WriteVerbose("Test completed");
+        }
+
+        private void TestDirect()
+        {
+            WriteVerbose("Testing direct method call");
+            WriteVerbose($"Before delay - Thread ID: {Thread.CurrentThread.ManagedThreadId}");
+            
+            Task.Delay(Delay).Wait();
+            
+            WriteVerbose($"After delay - Thread ID: {Thread.CurrentThread.ManagedThreadId}");
+            WriteObject("Direct test completed");
+        }
+
+        private void TestConfigureAwait()
+        {
+            WriteVerbose("Testing ConfigureAwait(false)");
+            WriteVerbose($"Before async call - Thread ID: {Thread.CurrentThread.ManagedThreadId}");
+            
+            var result = ExecuteAsyncTask(() => Task.Delay(Delay).ContinueWith(t => 
+            {
+                WriteVerbose($"Inside async task - Thread ID: {Thread.CurrentThread.ManagedThreadId}");
+                return "ConfigureAwait test completed";
+            }));
+            
+            WriteVerbose($"After async call - Thread ID: {Thread.CurrentThread.ManagedThreadId}");
+            WriteObject(result);
+        }
+
+        private void TestSynchronizationContext()
+        {
+            WriteVerbose("Testing SynchronizationContext");
+            WriteVerbose($"Before async call - Thread ID: {Thread.CurrentThread.ManagedThreadId}");
+            WriteVerbose($"SynchronizationContext: {SynchronizationContext.Current != null}");
+            
+            var syncContext = SynchronizationContext.Current;
+            var result = ExecuteAsyncTask(() => Task.Delay(Delay).ContinueWith(t => 
+            {
+                var taskThreadId = Thread.CurrentThread.ManagedThreadId;
+                WriteVerbose($"Inside async task - Thread ID: {taskThreadId}");
+                
+                if (syncContext != null)
+                {
+                    syncContext.Post(_ => 
+                    {
+                        WriteVerbose($"Inside SynchronizationContext.Post - Thread ID: {Thread.CurrentThread.ManagedThreadId}");
+                    }, null);
+                }
+                
+                return "SynchronizationContext test completed";
+            }));
+            
+            WriteVerbose($"After async call - Thread ID: {Thread.CurrentThread.ManagedThreadId}");
+            WriteObject(result);
+        }
+
+        private void TestTaskRun()
+        {
+            WriteVerbose("Testing Task.Run");
+            WriteVerbose($"Before Task.Run - Thread ID: {Thread.CurrentThread.ManagedThreadId}");
+            
+            var task = Task.Run(() => 
+            {
+                WriteVerbose($"Inside Task.Run - Thread ID: {Thread.CurrentThread.ManagedThreadId}");
+                Thread.Sleep(Delay);
+                WriteVerbose($"After delay in Task.Run - Thread ID: {Thread.CurrentThread.ManagedThreadId}");
+                return "TaskRun test completed";
+            });
+            
+            var result = task.GetAwaiter().GetResult();
+            
+            WriteVerbose($"After Task.Run - Thread ID: {Thread.CurrentThread.ManagedThreadId}");
+            WriteObject(result);
+        }
+    }
+}

src/PSOPNSenseAPI/PSOPNSenseAPI.psd1

@@ -3,7 +3,7 @@
     RootModule = 'lib\PSOPNSenseAPI.dll'
 
     # Version number of this module.
-    ModuleVersion = '2025.04.15.1543'
+    ModuleVersion = '2025.04.15.1714'
 
     # Supported PSEditions
     CompatiblePSEditions = @('Desktop', 'Core')