Added project for example

UnityActionUpdaterService/Assets/Internal/Codebase/ActionUpdater/Dispatcher/ActionUpdateDispatcher.cs

@@ -0,0 +1,72 @@
+// Resharper disable all
+// **************************************************************** //
+//
+//   Copyright (c) RimuruDev. All rights reserved.
+//   Contact me: 
+//          - Gmail:    rimuru.dev@gmail.com
+//          - GitHub:   https://github.com/RimuruDev
+//          - LinkedIn: https://www.linkedin.com/in/rimuru/
+//          - GitHub Organizations: https://github.com/Rimuru-Dev
+//
+// **************************************************************** //
+
+using Zenject;
+using UnityEngine;
+using RimuruDev.Internal.Codebase.ActionUpdater.Service;
+
+namespace RimuruDev.Internal.Codebase.ActionUpdater.Dispatcher
+{
+    /// <summary>
+    /// The ActionUpdateDispatcher is responsible for dispatching update calls
+    /// to the IActionUpdaterService. It ensures that these updates continue
+    /// across different scenes, as it persists across scene loads.
+    /// </summary>
+    [DisallowMultipleComponent]
+    public sealed class ActionUpdateDispatcher : MonoBehaviour
+    {
+        private IActionUpdaterService actionUpdater;
+
+        /// <summary>
+        /// Injects the IActionUpdaterService dependency.
+        /// This method is called by Zenject to provide the service instance.
+        /// </summary>
+        /// <param name="actionUpdater">The action updater service to be used for dispatching update events.</param>
+        [Inject]
+        private void Constructor(IActionUpdaterService actionUpdater) =>
+            this.actionUpdater = actionUpdater;
+
+        /// <summary>
+        /// Called when the script instance is being loaded.
+        /// Ensures this object is not destroyed when loading a new scene.
+        /// </summary>
+        private void Awake()
+        {
+            transform.SetParent(null);
+            DontDestroyOnLoad(gameObject);
+        }
+
+        /// <summary>
+        /// Called every fixed framerate frame. Delegates the call to the action updater service.
+        /// </summary>
+        private void FixedUpdate() =>
+            actionUpdater?.FixedUpdate();
+
+        /// <summary>
+        /// Called every frame. Delegates the call to the action updater service.
+        /// </summary>
+        private void Update() =>
+            actionUpdater?.Update();
+
+        /// <summary>
+        /// Called every frame after Update. Delegates the call to the action updater service.
+        /// </summary>
+        private void LateUpdate() =>
+            actionUpdater?.LateUpdate();
+
+        /// <summary>
+        /// Called when the application is quitting. Disposes the action updater service.
+        /// </summary>
+        private void OnApplicationQuit() =>
+            actionUpdater?.Dispose();
+    }
+}

UnityActionUpdaterService/Assets/Internal/Codebase/ActionUpdater/Enum/UpdateType.cs

@@ -0,0 +1,40 @@
+// **************************************************************** //
+//
+//   Copyright (c) RimuruDev. All rights reserved.
+//   Contact me: 
+//          - Gmail:    rimuru.dev@gmail.com
+//          - GitHub:   https://github.com/RimuruDev
+//          - LinkedIn: https://www.linkedin.com/in/rimuru/
+//          - GitHub Organizations: https://github.com/Rimuru-Dev
+//
+// **************************************************************** //
+
+using System;
+
+namespace RimuruDev.Internal.Codebase.ActionUpdater.Enum
+{
+    /// <summary>
+    /// Specifies the type of update method to which an action can be subscribed.
+    /// </summary>
+    [Serializable]
+    public enum UpdateType : byte
+    {
+        /// <summary>
+        /// Subscribe to the FixedUpdate method, which is called every fixed framerate frame.
+        /// Suitable for updates in physics calculations.
+        /// </summary>
+        FixedUpdate = 0,
+
+        /// <summary>
+        /// Subscribe to the Update method, which is called once per frame.
+        /// Suitable for most game logic.
+        /// </summary>
+        Update = 1,
+
+        /// <summary>
+        /// Subscribe to the LateUpdate method, which is called once per frame after Update.
+        /// Suitable for actions that require objects to be updated first.
+        /// </summary>
+        LateUpdate = 2,
+    }
+}

UnityActionUpdaterService/Assets/Internal/Codebase/ActionUpdater/Service/ActionUpdaterService.cs

@@ -0,0 +1,149 @@
+// Resharper disable all
+// **************************************************************** //
+//
+//   Copyright (c) RimuruDev. All rights reserved.
+//   Contact me: 
+//          - Gmail:    rimuru.dev@gmail.com
+//          - GitHub:   https://github.com/RimuruDev
+//          - LinkedIn: https://www.linkedin.com/in/rimuru/
+//          - GitHub Organizations: https://github.com/Rimuru-Dev
+//
+// **************************************************************** //
+
+using System;
+using UnityEngine;
+using System.Linq;
+using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
+using RimuruDev.Internal.Codebase.ActionUpdater.Enum;
+
+namespace RimuruDev.Internal.Codebase.ActionUpdater.Service
+{
+    /// <summary>
+    /// Manages the subscription of actions to Unity's update methods (FixedUpdate, Update, LateUpdate).
+    /// Allows for centralized control of update logic, with the ability to pause all actions.
+    /// </summary>
+    public sealed class ActionUpdaterService : IActionUpdaterService
+    {
+        private readonly List<Action> fixedUpdateActionCache = new();
+        private readonly List<Action> updateActionCache = new();
+        private readonly List<Action> lateUpdateActionCache = new();
+
+        private event Action OnFixedUpdate;
+        private event Action OnUpdate;
+        private event Action OnLateUpdate;
+
+        private bool isPause;
+
+        /// <summary>
+        /// Subscribes an action to a specified update method.
+        /// </summary>
+        /// <param name="updateable">The action to subscribe.</param>
+        /// <param name="updateType">The type of update method to subscribe to (FixedUpdate, Update, or LateUpdate).</param>
+        public void Subscribe([NotNull] Action updateable, UpdateType updateType)
+        {
+            switch (updateType)
+            {
+                case UpdateType.FixedUpdate:
+                    OnFixedUpdate += updateable;
+                    fixedUpdateActionCache.Add(updateable);
+                    break;
+                case UpdateType.Update:
+                    OnUpdate += updateable;
+                    updateActionCache.Add(updateable);
+                    break;
+                case UpdateType.LateUpdate:
+                    OnLateUpdate += updateable;
+                    lateUpdateActionCache.Add(updateable);
+                    break;
+                default:
+                    Debug.LogError($"ArgumentOutOfRangeException: {nameof(updateType)}, {updateType}");
+                    break;
+            }
+        }
+
+        /// <summary>
+        /// Unsubscribes an action from a specified update method.
+        /// </summary>
+        /// <param name="updateable">The action to unsubscribe.</param>
+        /// <param name="updateType">The type of update method to unsubscribe from.</param>
+        public void Unsubscribe([NotNull] Action updateable, UpdateType updateType)
+        {
+            switch (updateType)
+            {
+                case UpdateType.FixedUpdate:
+                    OnFixedUpdate -= updateable;
+                    fixedUpdateActionCache.Remove(updateable);
+                    break;
+                case UpdateType.Update:
+                    OnUpdate -= updateable;
+                    updateActionCache.Remove(updateable);
+                    break;
+                case UpdateType.LateUpdate:
+                    OnLateUpdate -= updateable;
+                    lateUpdateActionCache.Remove(updateable);
+                    break;
+                default:
+                    Debug.LogError($"ArgumentOutOfRangeException: {nameof(updateType)}, {updateType}");
+                    break;
+            }
+        }
+
+        /// <summary>
+        /// Invokes all actions subscribed to FixedUpdate.
+        /// </summary>
+        public void FixedUpdate()
+        {
+            if (isPause)
+                return;
+
+            OnFixedUpdate?.Invoke();
+        }
+
+        /// <summary>
+        /// Invokes all actions subscribed to Update.
+        /// </summary>
+        public void Update()
+        {
+            if (isPause)
+                return;
+
+            OnUpdate?.Invoke();
+        }
+
+        /// <summary>
+        /// Invokes all actions subscribed to LateUpdate.
+        /// </summary>
+        public void LateUpdate()
+        {
+            if (isPause)
+                return;
+
+            OnLateUpdate?.Invoke();
+        }
+
+        /// <summary>
+        /// Sets or unsets the pause state of the update actions.
+        /// </summary>
+        /// <param name="pause">True to pause, false to resume.</param>
+        public void SetPause(bool pause) =>
+            isPause = pause;
+
+        /// <summary>
+        /// Unsubscribes all actions from their respective update methods.
+        /// </summary>
+        public void Dispose()
+        {
+            UnsubscribeAll(fixedUpdateActionCache, ref OnFixedUpdate);
+            UnsubscribeAll(updateActionCache, ref OnUpdate);
+            UnsubscribeAll(lateUpdateActionCache, ref OnLateUpdate);
+        }
+
+        private static void UnsubscribeAll(ICollection<Action> actionList, ref Action eventDelegate)
+        {
+            eventDelegate = actionList.Aggregate(eventDelegate, (current, action) => current - action);
+
+            actionList.Clear();
+        }
+    }
+}

UnityActionUpdaterService/Assets/Internal/Codebase/ActionUpdater/Service/IActionUpdaterService.cs

@@ -0,0 +1,59 @@
+// Resharper disable all
+// **************************************************************** //
+//
+//   Copyright (c) RimuruDev. All rights reserved.
+//   Contact me: 
+//          - Gmail:    rimuru.dev@gmail.com
+//          - GitHub:   https://github.com/RimuruDev
+//          - LinkedIn: https://www.linkedin.com/in/rimuru/
+//          - GitHub Organizations: https://github.com/Rimuru-Dev
+//
+// **************************************************************** //
+
+using System;
+using System.Diagnostics.CodeAnalysis;
+using RimuruDev.Internal.Codebase.ActionUpdater.Enum;
+
+namespace RimuruDev.Internal.Codebase.ActionUpdater.Service
+{
+    /// <summary>
+    /// Provides a service for subscribing actions to Unity's lifecycle methods.
+    /// </summary>
+    public interface IActionUpdaterService : IDisposable
+    {
+        /// <summary>
+        /// Subscribes an action to a specified update type.
+        /// </summary>
+        /// <param name="updateable">The action to subscribe.</param>
+        /// <param name="updateType">The type of update to subscribe to (FixedUpdate, Update, or LateUpdate).</param>
+        public void Subscribe([NotNull] Action updateable, UpdateType updateType);
+
+        /// <summary>
+        /// Unsubscribes an action from a specified update type.
+        /// </summary>
+        /// <param name="updateable">The action to unsubscribe.</param>
+        /// <param name="updateType">The type of update to unsubscribe from.</param>
+        public void Unsubscribe([NotNull] Action updateable, UpdateType updateType);
+
+        /// <summary>
+        /// Invokes actions subscribed to FixedUpdate.
+        /// </summary>
+        public void FixedUpdate();
+
+        /// <summary>
+        /// Invokes actions subscribed to Update.
+        /// </summary>
+        public void Update();
+
+        /// <summary>
+        /// Invokes actions subscribed to LateUpdate.
+        /// </summary>
+        public void LateUpdate();
+
+        /// <summary>
+        /// Pauses or resumes the execution of subscribed actions.
+        /// </summary>
+        /// <param name="pause">True to pause actions, false to resume.</param>
+        public void SetPause(bool pause);
+    }
+}