com.wallstop-studios.dxmessaging 2.1.1 → 2.1.2

package/Editor/Testing/MessagingComponentEditorHarness.cs

@@ -0,0 +1,218 @@
+#if UNITY_EDITOR
+namespace DxMessaging.Editor.Testing
+{
+    using System;
+    using System.Collections.Generic;
+    using System.Linq;
+    using Core;
+    using Core.Diagnostics;
+    using Core.MessageBus;
+    using Unity;
+    using UnityEngine;
+
+    /// <summary>
+    /// Captures inspector-oriented diagnostics for <see cref="MessagingComponent"/> instances without relying on GUI APIs.
+    /// Intended for automated editor tests that need to validate inspector state transitions.
+    /// </summary>
+    internal static class MessagingComponentEditorHarness
+    {
+        private static readonly MessageEmissionData[] EmptyEmissions =
+            Array.Empty<MessageEmissionData>();
+
+        internal static MessagingComponentInspectorState Capture(MessagingComponent component)
+        {
+            if (component == null)
+            {
+                throw new ArgumentNullException(nameof(component));
+            }
+
+            bool globalDiagnosticsEnabled = false;
+            IReadOnlyList<MessageEmissionData> globalHistory = EmptyEmissions;
+
+            if (MessageHandler.MessageBus is MessageBus concreteBus)
+            {
+                globalDiagnosticsEnabled = concreteBus.DiagnosticsMode;
+                if (globalDiagnosticsEnabled && concreteBus._emissionBuffer.Count > 0)
+                {
+                    globalHistory = concreteBus._emissionBuffer.ToArray();
+                }
+            }
+
+            List<ListenerDiagnosticsView> listenerViews = component
+                ._registeredListeners.OrderBy(pair => pair.Key.GetInstanceID())
+                .Select(pair => CreateListenerView(pair.Key, pair.Value))
+                .ToList();
+
+            ProviderDiagnosticsView providerDiagnostics = CreateProviderDiagnostics(component);
+
+            return new MessagingComponentInspectorState(
+                globalDiagnosticsEnabled,
+                globalHistory,
+                listenerViews,
+                providerDiagnostics
+            );
+        }
+
+        private static ListenerDiagnosticsView CreateListenerView(
+            MonoBehaviour listener,
+            MessageRegistrationToken token
+        )
+        {
+            MessageRegistrationView[] registrations = token
+                ._metadata.OrderBy(pair => pair.Key)
+                .Select(pair => new MessageRegistrationView(
+                    pair.Key,
+                    pair.Value,
+                    token._callCounts.TryGetValue(pair.Key, out int callCount) ? callCount : 0
+                ))
+                .ToArray();
+
+            IReadOnlyList<MessageEmissionData> emissionHistory =
+                token._emissionBuffer.Count > 0 ? token._emissionBuffer.ToArray() : EmptyEmissions;
+
+            return new ListenerDiagnosticsView(
+                listener,
+                token.DiagnosticMode,
+                token.Enabled,
+                registrations,
+                emissionHistory
+            );
+        }
+
+        internal static ProviderDiagnosticsView CreateProviderDiagnostics(
+            MessagingComponent component
+        )
+        {
+            bool autoConfigure = component.AutoConfigureSerializedProviderOnAwake;
+            bool hasSerializedProvider =
+                component.SerializedProviderAsset != null || component.HasSerializedProvider;
+            bool hasRuntimeProvider = component.HasRuntimeProvider;
+            bool hasMessageBusOverride = component.HasMessageBusOverride;
+            bool serializedProviderMissingWarning = autoConfigure && !hasSerializedProvider;
+
+            bool serializedProviderNullBusWarning = false;
+            if (hasSerializedProvider)
+            {
+                IMessageBus resolvedBus = component.SerializedProviderHandle.ResolveBus();
+                serializedProviderNullBusWarning = resolvedBus == null;
+            }
+
+            return new ProviderDiagnosticsView(
+                autoConfigure,
+                hasSerializedProvider,
+                hasRuntimeProvider,
+                hasMessageBusOverride,
+                serializedProviderMissingWarning,
+                serializedProviderNullBusWarning
+            );
+        }
+    }
+
+    internal sealed class MessagingComponentInspectorState
+    {
+        internal MessagingComponentInspectorState(
+            bool globalDiagnosticsEnabled,
+            IReadOnlyList<MessageEmissionData> globalEmissionHistory,
+            IReadOnlyList<ListenerDiagnosticsView> listeners,
+            ProviderDiagnosticsView providerDiagnostics
+        )
+        {
+            GlobalDiagnosticsEnabled = globalDiagnosticsEnabled;
+            GlobalEmissionHistory =
+                globalEmissionHistory
+                ?? throw new ArgumentNullException(nameof(globalEmissionHistory));
+            Listeners = listeners ?? throw new ArgumentNullException(nameof(listeners));
+            ProviderDiagnostics = providerDiagnostics;
+        }
+
+        internal bool GlobalDiagnosticsEnabled { get; }
+
+        internal IReadOnlyList<MessageEmissionData> GlobalEmissionHistory { get; }
+
+        internal IReadOnlyList<ListenerDiagnosticsView> Listeners { get; }
+
+        internal ProviderDiagnosticsView ProviderDiagnostics { get; }
+    }
+
+    internal sealed class ListenerDiagnosticsView
+    {
+        internal ListenerDiagnosticsView(
+            MonoBehaviour listener,
+            bool diagnosticsEnabled,
+            bool tokenEnabled,
+            IReadOnlyList<MessageRegistrationView> registrations,
+            IReadOnlyList<MessageEmissionData> emissionHistory
+        )
+        {
+            Listener = listener;
+            DiagnosticsEnabled = diagnosticsEnabled;
+            TokenEnabled = tokenEnabled;
+            Registrations = registrations ?? throw new ArgumentNullException(nameof(registrations));
+            EmissionHistory =
+                emissionHistory ?? throw new ArgumentNullException(nameof(emissionHistory));
+        }
+
+        internal MonoBehaviour Listener { get; }
+
+        internal bool DiagnosticsEnabled { get; }
+
+        internal bool TokenEnabled { get; }
+
+        internal IReadOnlyList<MessageRegistrationView> Registrations { get; }
+
+        internal IReadOnlyList<MessageEmissionData> EmissionHistory { get; }
+    }
+
+    internal readonly struct MessageRegistrationView
+    {
+        internal MessageRegistrationView(
+            MessageRegistrationHandle handle,
+            MessageRegistrationMetadata metadata,
+            int callCount
+        )
+        {
+            Handle = handle;
+            Metadata = metadata;
+            CallCount = callCount;
+        }
+
+        internal MessageRegistrationHandle Handle { get; }
+
+        internal MessageRegistrationMetadata Metadata { get; }
+
+        internal int CallCount { get; }
+    }
+
+    internal readonly struct ProviderDiagnosticsView
+    {
+        internal ProviderDiagnosticsView(
+            bool autoConfigureSerializedProviderOnAwake,
+            bool hasSerializedProvider,
+            bool hasRuntimeProvider,
+            bool hasMessageBusOverride,
+            bool serializedProviderMissingWarning,
+            bool serializedProviderNullBusWarning
+        )
+        {
+            AutoConfigureSerializedProviderOnAwake = autoConfigureSerializedProviderOnAwake;
+            HasSerializedProvider = hasSerializedProvider;
+            HasRuntimeProvider = hasRuntimeProvider;
+            HasMessageBusOverride = hasMessageBusOverride;
+            SerializedProviderMissingWarning = serializedProviderMissingWarning;
+            SerializedProviderNullBusWarning = serializedProviderNullBusWarning;
+        }
+
+        internal bool AutoConfigureSerializedProviderOnAwake { get; }
+
+        internal bool HasSerializedProvider { get; }
+
+        internal bool HasRuntimeProvider { get; }
+
+        internal bool HasMessageBusOverride { get; }
+
+        internal bool SerializedProviderMissingWarning { get; }
+
+        internal bool SerializedProviderNullBusWarning { get; }
+    }
+}
+#endif

package/Editor/Testing/MessagingComponentEditorHarness.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: 2624c9e8eb5243ebb71545774f411c2c
+timeCreated: 1761880591

package/Editor/Testing.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: a61780c8ba084b29bb44fdefc9b7fcf2
+timeCreated: 1761880591

package/README.md

@@ -2,7 +2,7 @@
 
 [![Unity](https://img.shields.io/badge/Unity-2021.3+-black.svg)](https://unity.com/releases/editor)<br/>
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE.md)<br/>
-[![Version](https://img.shields.io/badge/version-2.0.0--rc27-green.svg)](package.json)<br/>
+[![Version](https://img.shields.io/npm/v/com.wallstop-studios.dxmessaging.svg)](https://www.npmjs.com/package/com.wallstop-studios.dxmessaging)<br/>
 [![Performance: OS-Specific Benchmarks](https://img.shields.io/badge/Performance-OS--specific-blueviolet.svg)](Docs/Performance.md)<br/>
 [![Markdown Link Validity](https://github.com/wallstop/DxMessaging/actions/workflows/markdown-link-validity.yml/badge.svg)](https://github.com/wallstop/DxMessaging/actions/workflows/markdown-link-validity.yml)<br/>
 [![Markdown Link Text Check](https://github.com/wallstop/DxMessaging/actions/workflows/markdown-link-text-check.yml/badge.svg)](https://github.com/wallstop/DxMessaging/actions/workflows/markdown-link-text-check.yml)
@@ -11,6 +11,8 @@
 
 Think of it as **the event system Unity should have built-in** — one that actually scales.
 
+Need install instructions for Git URLs, scoped registries, or tarballs? Jump to the [Install Guide](Docs/Install.md).
+
 ## Table of Contents
 
 - [30-Second Elevator Pitch](#30-second-elevator-pitch)
@@ -62,12 +64,15 @@ Think of it as **the event system Unity should have built-in** — one that actu
 
 ### 1. Install
 
-Via Unity Package Manager → Add package from git URL:
+Via Unity Package Manager → Add package from git URL (see the [Install Guide](Docs/Install.md) for scoped registry, tarball, and offline options):
 
-```text
+```bash
+# Unity Package Manager > Add package from git URL...
 https://github.com/wallstop/DxMessaging.git
 ```
 
+Prefer OpenUPM, scoped registries, or local tarballs? The [Install Guide](Docs/Install.md) covers every path in detail.
+
 ### 2. Define Your First Message
 
 ```csharp
@@ -632,6 +637,7 @@ See [full comparison](Docs/Comparisons.md) for detailed analysis with code examp
 
 ### 📖 Reference
 
+- [Install Guide](Docs/Install.md) — All install options (Git URL, scoped registry, tarball, manual copy)
 - [Glossary](Docs/Glossary.md) — All terms explained in plain English
 - [Quick Reference](Docs/QuickReference.md) — Cheat sheet
 - [API Reference](Docs/Reference.md) — Complete API

package/Runtime/AssemblyInfo.cs

@@ -9,3 +9,4 @@ using System.Runtime.CompilerServices;
 [assembly: InternalsVisibleTo("WallstopStudios.DxMessaging.Tests.Runtime.Reflex")]
 [assembly: InternalsVisibleTo("WallstopStudios.DxMessaging.Tests.Runtime.VContainer")]
 [assembly: InternalsVisibleTo("WallstopStudios.DxMessaging.Tests.Runtime.Zenject")]
+[assembly: InternalsVisibleTo("WallstopStudios.DxMessaging.Tests.Editor")]

package/Runtime/Core/Diagnostics/MessageEmissionData.cs

@@ -1,8 +1,11 @@
 namespace DxMessaging.Core.Diagnostics
 {
     using System;
-#if UNITY_2017_1_OR_NEWER
+    using System.Linq;
+#if UNITY_2021_3_OR_NEWER
     using UnityEngine;
+#else
+    using System.Diagnostics;
 #endif
 
     /// <summary>
@@ -45,7 +48,7 @@ namespace DxMessaging.Core.Diagnostics
         private static string GetAccurateStackTrace()
         {
             string fullStackTrace;
-#if UNITY_2017_1_OR_NEWER
+#if UNITY_2021_3_OR_NEWER
             fullStackTrace = StackTraceUtility.ExtractStackTrace();
 #else
             fullStackTrace = new StackTrace(true).ToString();
@@ -57,18 +60,30 @@ namespace DxMessaging.Core.Diagnostics
 
             string[] lines = fullStackTrace.Split(NewlineSeparators, StringSplitOptions.None);
 
-            int startIndex = 1;
-            while (
-                startIndex < lines.Length
-                && lines[startIndex].Contains("DxMessaging", StringComparison.OrdinalIgnoreCase)
-            )
+            string[] trimmedLines = lines
+                .Where(line => !string.IsNullOrWhiteSpace(line) && !IsInternalFrame(line))
+                .ToArray();
+
+            return trimmedLines.Length == 0
+                ? string.Empty
+                : string.Join(JoinSeparator, trimmedLines);
+        }
+
+        private static bool IsInternalFrame(string line)
+        {
+            if (string.IsNullOrWhiteSpace(line))
             {
-                ++startIndex;
+                return false;
             }
 
-            return lines.Length <= startIndex
-                ? string.Empty
-                : string.Join(JoinSeparator, lines, startIndex, lines.Length - startIndex);
+            if (!line.Contains("DxMessaging.", StringComparison.Ordinal))
+            {
+                return false;
+            }
+
+            return line.Contains("DxMessaging.Core.", StringComparison.Ordinal)
+                || line.Contains("DxMessaging.Unity.", StringComparison.Ordinal)
+                || line.Contains("DxMessaging.Editor.", StringComparison.Ordinal);
         }
     }
 }

package/Runtime/Core/Extensions/MessageBusExtensions.cs

@@ -4,7 +4,7 @@ namespace DxMessaging.Core.Extensions
     using DxMessaging.Core;
     using DxMessaging.Core.MessageBus;
     using DxMessaging.Core.Messages;
-#if UNITY_2017_1_OR_NEWER
+#if UNITY_2021_3_OR_NEWER
     using UnityEngine;
 #endif
 
@@ -98,7 +98,7 @@ namespace DxMessaging.Core.Extensions
             message.EmitBroadcast(source, messageBus);
         }
 
-#if UNITY_2017_1_OR_NEWER
+#if UNITY_2021_3_OR_NEWER
         public static void EmitGameObjectTargeted<TMessage>(
             this IMessageBus messageBus,
             GameObject target,

package/Runtime/Core/Extensions/MessageExtensions.cs

@@ -37,7 +37,7 @@ namespace DxMessaging.Core.Extensions
     /// </example>
     public static class MessageExtensions
     {
-#if UNITY_2017_1_OR_NEWER
+#if UNITY_2021_3_OR_NEWER
         /// <summary>
         /// Emits a TargetedMessage of the given type.
         /// </summary>
@@ -395,7 +395,7 @@ namespace DxMessaging.Core.Extensions
             resolvedBus.SourcedBroadcast(ref source, ref message);
         }
 
-#if UNITY_2017_1_OR_NEWER
+#if UNITY_2021_3_OR_NEWER
         /// <summary>
         /// Emits a BroadcastMessage of the given type.
         /// </summary>

package/Runtime/Core/InstanceId.cs

@@ -30,7 +30,7 @@ namespace DxMessaging.Core
 
         private readonly int _id;
 
-#if UNITY_2017_1_OR_NEWER
+#if UNITY_2021_3_OR_NEWER
         // ReSharper disable once InconsistentNaming
         public readonly UnityEngine.Object Object;
 #endif
@@ -38,10 +38,12 @@ namespace DxMessaging.Core
         public InstanceId(int id)
         {
             _id = id;
+#if UNITY_2021_3_OR_NEWER
             Object = null;
+#endif
         }
 
-#if UNITY_2017_1_OR_NEWER
+#if UNITY_2021_3_OR_NEWER
         private InstanceId(UnityEngine.Object unityObject)
         {
             _id = unityObject.GetInstanceID();
@@ -81,7 +83,7 @@ namespace DxMessaging.Core
 
         public override string ToString()
         {
-#if UNITY_2017_1_OR_NEWER
+#if UNITY_2021_3_OR_NEWER
             UnityEngine.Object instance = Object;
             string objectName = instance == null ? string.Empty : instance.name;
             return new { Id = _id, Name = objectName }.ToString();

package/Runtime/Core/MessageBus/MessageBus.cs

@@ -12,7 +12,7 @@ namespace DxMessaging.Core.MessageBus
     using Helper;
     using Messages;
     using static IMessageBus;
-#if UNITY_2017_1_OR_NEWER
+#if UNITY_2021_3_OR_NEWER
     using UnityEngine;
 #endif
 
@@ -167,7 +167,7 @@ namespace DxMessaging.Core.MessageBus
             Dictionary<MethodSignatureKey, Action<MonoBehaviour, object[]>>
         > _methodCache = new();
 
-#if UNITY_2017_1_OR_NEWER
+#if UNITY_2021_3_OR_NEWER
         private readonly HashSet<MonoBehaviour> _recipientCache = new();
         private readonly List<MonoBehaviour> _componentCache = new();
 #endif
@@ -1144,7 +1144,7 @@ namespace DxMessaging.Core.MessageBus
                         );
                     }
                 }
-#if UNITY_2017_1_OR_NEWER
+#if UNITY_2021_3_OR_NEWER
                 ref ReflexiveMessage reflexiveMessage = ref Unsafe.As<TMessage, ReflexiveMessage>(
                     ref typedMessage
                 );
@@ -4152,7 +4152,7 @@ namespace DxMessaging.Core.MessageBus
             }
         }
 
-#if UNITY_2017_1_OR_NEWER
+#if UNITY_2021_3_OR_NEWER
         private static Action<MonoBehaviour, object[]> CompileMethodAction(MethodInfo methodInfo)
         {
             ParameterExpression componentParameter = Expression.Parameter(

package/Runtime/Core/MessageBus/MessageRegistrationBuilder.cs

@@ -41,7 +41,7 @@ namespace DxMessaging.Core.MessageBus
         /// </summary>
         public InstanceId? Owner { get; set; }
 
-#if UNITY_2017_1_OR_NEWER
+#if UNITY_2021_3_OR_NEWER
         /// <summary>
         /// Unity object to treat as the owner. Overrides <see cref="Owner"/> when supplied.
         /// </summary>
@@ -314,7 +314,7 @@ namespace DxMessaging.Core.MessageBus
 
         private static InstanceId ResolveOwner(MessageRegistrationBuildOptions options)
         {
-#if UNITY_2017_1_OR_NEWER
+#if UNITY_2021_3_OR_NEWER
             if (options.UnityOwner != null)
             {
                 if (options.UnityOwner is UnityEngine.GameObject gameObject)

package/Runtime/Core/MessageBus/MessagingRegistration.cs

@@ -58,7 +58,7 @@ namespace DxMessaging.Core.MessageBus
         /// </summary>
         public readonly RegistrationMethod registrationMethod;
 
-#if UNITY_2017_1_OR_NEWER
+#if UNITY_2021_3_OR_NEWER
         /// <summary>
         /// Unity time of the registration
         /// </summary>
@@ -83,7 +83,7 @@ namespace DxMessaging.Core.MessageBus
             this.type = type;
             this.registrationType = registrationType;
             this.registrationMethod = registrationMethod;
-#if UNITY_2017_1_OR_NEWER
+#if UNITY_2021_3_OR_NEWER
             time = UnityEngine.Time.time;
 #endif
         }
@@ -92,7 +92,7 @@ namespace DxMessaging.Core.MessageBus
         {
             return new
             {
-#if UNITY_2017_1_OR_NEWER
+#if UNITY_2021_3_OR_NEWER
                 time,
 #endif
                 id,

package/Runtime/Core/MessageHandler.cs

@@ -502,7 +502,7 @@ namespace DxMessaging.Core
         /// <note>
         /// Ideally, this would be something like a Dictionary[T, Handler[T]], but that can't be done with C#s type system.
         /// </note>
-        private readonly List<MessageCache<object>> _handlersByTypeByMessageBus;
+        internal readonly List<MessageCache<object>> _handlersByTypeByMessageBus;
         private IMessageBus _defaultMessageBus;
 
         /// <summary>
@@ -1934,6 +1934,33 @@ namespace DxMessaging.Core
             return false;
         }
 
+        internal int GetUntargetedPostProcessingPrefreezeCount<T>(
+            IMessageBus messageBus,
+            int priority
+        )
+            where T : IMessage
+        {
+            if (
+                !GetHandlerForType(messageBus, out TypedHandler<T> handler)
+                || handler._untargetedPostProcessingFastHandlers == null
+            )
+            {
+                return 0;
+            }
+
+            if (
+                handler._untargetedPostProcessingFastHandlers.TryGetValue(
+                    priority,
+                    out HandlerActionCache<FastHandler<T>> cache
+                )
+            )
+            {
+                return cache.prefreezeInvocationCount;
+            }
+
+            return 0;
+        }
+
         private sealed class HandlerActionCache<T>
         {
             internal readonly struct Entry
@@ -3673,7 +3700,12 @@ namespace DxMessaging.Core
                     {
                         List<TU> list = actionCache.cache;
                         list.Clear();
-                        foreach (var kvp in actionCache.entries)
+                        foreach (
+                            KeyValuePair<
+                                TU,
+                                HandlerActionCache<TU>.Entry
+                            > kvp in actionCache.entries
+                        )
                         {
                             list.Add(kvp.Value.handler);
                         }

package/Runtime/Core/MessageRegistrationToken.cs

@@ -166,7 +166,7 @@ namespace DxMessaging.Core
             );
         }
 
-#if UNITY_2017_1_OR_NEWER
+#if UNITY_2021_3_OR_NEWER
         /// <summary>
         /// Stages a registration to accept targeted messages of type <typeparamref name="T"/> directed at the given GameObject.
         /// </summary>
@@ -1024,7 +1024,7 @@ namespace DxMessaging.Core
             );
         }
 
-#if UNITY_2017_1_OR_NEWER
+#if UNITY_2021_3_OR_NEWER
         /// <summary>
         /// Stages a registration to accept broadcast messages of type <typeparamref name="T"/> from a given source.
         /// </summary>

package/Runtime/Unity/CurrentGlobalMessageBusProvider.cs

@@ -1,3 +1,4 @@
+#if UNITY_2021_3_OR_NEWER
 namespace DxMessaging.Unity
 {
     using DxMessaging.Core;
@@ -29,3 +30,4 @@ namespace DxMessaging.Unity
         }
     }
 }
+#endif

package/Runtime/Unity/InitialGlobalMessageBusProvider.cs

@@ -1,3 +1,4 @@
+#if UNITY_2021_3_OR_NEWER
 namespace DxMessaging.Unity
 {
     using DxMessaging.Core;
@@ -36,3 +37,4 @@ namespace DxMessaging.Unity
         }
     }
 }
+#endif

package/Runtime/Unity/Integrations/Reflex/ReflexRegistrationInstaller.cs

@@ -1,3 +1,4 @@
+#if UNITY_2021_3_OR_NEWER
 namespace DxMessaging.Unity.Integrations.Reflex
 {
 #if REFLEX_PRESENT
@@ -71,3 +72,4 @@ namespace DxMessaging.Unity.Integrations.Reflex
     }
 #endif
 }
+#endif

package/Runtime/Unity/Integrations/VContainer/VContainerRegistrationExtensions.cs

@@ -1,3 +1,4 @@
+#if UNITY_2021_3_OR_NEWER
 namespace DxMessaging.Unity.Integrations.VContainer
 {
 #if VCONTAINER_PRESENT
@@ -44,3 +45,4 @@ namespace DxMessaging.Unity.Integrations.VContainer
     }
 #endif
 }
+#endif

package/Runtime/Unity/Integrations/Zenject/ZenjectRegistrationInstaller.cs

@@ -1,3 +1,4 @@
+#if UNITY_2021_3_OR_NEWER
 namespace DxMessaging.Unity.Integrations.Zenject
 {
 #if ZENJECT_PRESENT
@@ -53,3 +54,4 @@ namespace DxMessaging.Unity.Integrations.Zenject
     }
 #endif
 }
+#endif

package/Runtime/Unity/MessageAwareComponent.cs

@@ -1,3 +1,4 @@
+#if UNITY_2021_3_OR_NEWER
 namespace DxMessaging.Unity
 {
     using Core;
@@ -273,3 +274,4 @@ namespace DxMessaging.Unity
         }
     }
 }
+#endif

package/Runtime/Unity/MessageBusProviderHandle.cs

@@ -1,3 +1,4 @@
+#if UNITY_2021_3_OR_NEWER
 namespace DxMessaging.Unity
 {
     using System;
@@ -18,6 +19,8 @@ namespace DxMessaging.Unity
         [NonSerialized]
         private IMessageBusProvider _runtimeProvider;
 
+        internal ScriptableMessageBusProvider SerializedProvider => _provider;
+
         /// <summary>
         /// Initializes a new instance referencing the supplied provider asset.
         /// </summary>
@@ -95,3 +98,4 @@ namespace DxMessaging.Unity
         }
     }
 }
+#endif

package/Runtime/Unity/MessagingComponent.cs

@@ -1,3 +1,4 @@
+#if UNITY_2021_3_OR_NEWER
 namespace DxMessaging.Unity
 {
     using System;
@@ -44,6 +45,20 @@ namespace DxMessaging.Unity
         internal readonly Dictionary<MonoBehaviour, MessageRegistrationToken> _registeredListeners =
             new();
 
+        internal bool AutoConfigureSerializedProviderOnAwake =>
+            autoConfigureSerializedProviderOnAwake;
+
+        internal bool HasRuntimeProvider => _messageBusProvider != null;
+
+        internal bool HasMessageBusOverride => _messageBusOverride != null;
+
+        internal bool HasSerializedProvider => _serializedProviderHandle.TryGetProvider(out _);
+
+        internal MessageBusProviderHandle SerializedProviderHandle => _serializedProviderHandle;
+
+        internal ScriptableMessageBusProvider SerializedProviderAsset =>
+            _serializedProviderHandle.SerializedProvider;
+
         /// <summary>
         /// Creates a <see cref="IMessageRegistrationBuilder"/> aligned with this component's configured bus or provider.
         /// </summary>
@@ -313,3 +328,4 @@ namespace DxMessaging.Unity
         }
     }
 }
+#endif