SHADE_Y3/SHADE_Engine/src/Events/SHEventManager.h

/******************************************************************************
 * \file    SHEventManager.h
 * \author  Loh Xiao Qi
 * \brief   Class declaration for event manager.
 * 
 * \copyright Copyright (c) 2022 Digipen Institute of Technology. Reproduction
 * or disclosure of this file or its contents without the prior written consent
 * of Digipen Institute of Technology is prohibited.
******************************************************************************/
#pragma once

#include "SHEvent.h"
#include "SHEventReceiver.h"
#include <unordered_map>
#include <functional>

/******************************************************************************
	INSTRUCTIONS FOR USE:
	On broadcaster side:
		1. 
******************************************************************************/

namespace SHADE
{
	using ResponseFunction = std::function<SHEventHandle(SHEvent)>;
	using ReceiverPtr = std::shared_ptr<SHEventReceiver>;
	using ResponseVec = std::vector<ReceiverPtr>;
	using StaticResponseVec = std::vector<ResponseFunction>;

	using EventManagerListener = std::function<void(SHEvent)>;

	class SHEventManager
	{
	public:
				/****************************************************************************
		 * \brief   Returns function pointer to entry point for events.
		****************************************************************************/
		static EventManagerListener GetListenerFunction();

		/****************************************************************************
		 * \param   ListenerConstPtr - Const pointer to listener that sent event.
		 * \param   EventType - Templated type for every type of event

		 * \brief		Receives event from the listeners.
		****************************************************************************/
		static void CatchEvent(SHEvent);

		/****************************************************************************
		 * \param   ResponseFunction - function pointer from receiver to be passed
		 *					into event manager to be called when events are broadcasted.
		 * \param   SHPackageType - package type that corresponding subscriber is
		 *					subscribing to.
		
		 * \brief   Links a function pointer from a subscriber to a particular
		 *					package type
		****************************************************************************/
		static void SubscribeTo(SHEventIdentifier, ReceiverPtr);

		template<typename T>
		static T* BroadcastEvent(T data, SHEventIdentifier eventType);

	private:

		// Registry for broadcasters and subscribers
		static std::unordered_map<SHEventIdentifier,	ResponseVec> packageReceiverRegistry;
		static std::unordered_map<SHEventHandle, SHEventDataPtr> dataEventMap;

		static SHEventHandle handleCounter;

		/****************************************************************************
		 * \param   ListenerConstPtr - Const pointer to listener that sent event.
		 * \param   EventType - Event data

		 * \brief		Broadcast event to all receivers that are subscribed to this
		 *					listener.
		****************************************************************************/
		static void Broadcast(SHEvent const&);

		/****************************************************************************
		 * \param   ReceiverPtr - Pointer to receiver
		 * \param   ListenerConstPtr - Const pointer to listener that receiver is
		 *					subscribing to.

		 * \brief   Registers receiver as a subscriber to listener in the registry.
		****************************************************************************/
		static void RegisterReceiverToType(SHEventIdentifier, ReceiverPtr);

	};
}