com.wallstop-studios.dxmessaging 2.0.0-rc27.3.1 → 2.1.0

package/.github/workflows/format-on-demand.yml

@@ -68,7 +68,7 @@ jobs:
           fetch-depth: 0
 
       - name: Setup Node.js
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v6
         with:
           node-version: '20'
 
@@ -214,7 +214,7 @@ jobs:
           fetch-depth: 0
 
       - name: Setup Node.js
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v6
         with:
           node-version: '20'
 

package/.github/workflows/json-format-check.yml

@@ -16,7 +16,7 @@ jobs:
         uses: actions/checkout@v5
 
       - name: Setup Node
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v6
         with:
           node-version: "20"
           cache: 'npm'

package/.github/workflows/markdown-json.yml

@@ -17,7 +17,7 @@ jobs:
         uses: actions/checkout@v5
 
       - name: Setup Node.js
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v6
         with:
           node-version: '20'
           cache: 'npm'

package/.github/workflows/markdownlint.yml

@@ -13,7 +13,7 @@ jobs:
         uses: actions/checkout@v5
 
       - name: Setup Node.js
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v6
         with:
           node-version: '20'
           cache: 'npm'

package/.github/workflows/npm-publish.yml

@@ -19,7 +19,7 @@ jobs:
           fetch-depth: 0 # Ensure full commit history for version comparison
 
       - name: Set up Node.js
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v6
         with:
           node-version: 18
           registry-url: "https://registry.npmjs.org/"

package/.github/workflows/prettier-autofix.yml

@@ -21,7 +21,7 @@ jobs:
           fetch-depth: 0
 
       - name: Setup Node.js
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v6
         with:
           node-version: '20'
           cache: 'npm'
@@ -95,7 +95,7 @@ jobs:
           fetch-depth: 0
 
       - name: Setup Node.js
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v6
         with:
           node-version: '20'
           cache: 'npm'

package/.github/workflows/yaml-format-lint.yml

@@ -16,7 +16,7 @@ jobs:
         uses: actions/checkout@v5
 
       - name: Setup Node
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v6
         with:
           node-version: "20"
           cache: 'npm'

package/Docs/Advanced.md

@@ -133,11 +133,36 @@ using DxMessaging.Core;
 using DxMessaging.Core.MessageBus;
 
 var localBus  = new MessageBus();
-var handler   = new MessageHandler(new InstanceId(123)) { active = true };
+var handler   = new MessageHandler(new InstanceId(123), localBus) { active = true };
 var token     = MessageRegistrationToken.Create(handler, localBus);
 // stage registrations on token; emit to localBus in tests
+// optional: replace the global singleton so shorthands use your DI bus
+MessageHandler.SetGlobalMessageBus(localBus);
 ```
 
+## Temporarily override the global bus
+
+When legacy shorthands or static helpers must run against a scoped bus (for example inside an integration test), use `MessageHandler.OverrideGlobalMessageBus` to push a temporary override that restores automatically:
+
+```csharp
+using DxMessaging.Core.MessageBus;
+
+IMessageBus testBus = new MessageBus();
+
+using (MessageHandler.OverrideGlobalMessageBus(testBus))
+{
+    // All static helpers (Emit shorthands, GlobalMessageBusProvider, etc.) resolve testBus.
+    RunTestScenario();
+}
+// previous global bus restored here
+```
+
+The scope throws if you pass `null` and guarantees the prior bus returns even if the wrapped code throws. Pair this with `IMessageRegistrationBuilder` for clean test lifecycles.
+
+> **Editor note:** When the global bus is replaced with a decorated implementation, certain inspector diagnostics that rely on the concrete `MessageBus` type (e.g., registration graphs) are temporarily unavailable until the override scope ends.
+
+Need a stable reference to the original bus regardless of overrides? Use `InitialGlobalMessageBusProviderAsset` (Create Asset → “DxMessaging/Message Bus Providers/Initial Global Message Bus”) to expose the startup instance.
+
 Scoped interceptors (debug)
 
 ```csharp