/*
 * Copyright (c) Meta Platforms, Inc. and affiliates.
 *
 * This source code is licensed under the MIT license found in the
 * LICENSE file in the root directory of this source tree.
 */

#pragma once

#include "PageTarget.h"
#include "SessionState.h"

#include <jsinspector-modern/InspectorInterfaces.h>
#include <jsinspector-modern/InstanceAgent.h>
#include <jsinspector-modern/Parsing.h>

#include <functional>
#include <string_view>

namespace facebook::react::jsinspector_modern {

class PageTarget;
class InstanceAgent;
class InstanceTarget;

/**
 * An Agent that handles requests from the Chrome DevTools Protocol for the
 * given page.
 * The constructor, destructor and all public methods must be called on the
 * same thread, which is also the thread where the associated PageTarget is
 * constructed and managed.
 */
class PageAgent final {
 public:
  /**
   * \param frontendChannel A channel used to send responses and events to the
   * frontend.
   * \param targetController An interface to the PageTarget that this agent is
   * attached to. The caller is responsible for ensuring that the
   * PageTargetDelegate and underlying PageTarget both outlive the agent.
   * \param sessionMetadata Metadata about the session that created this agent.
   * \param sessionState The state of the session that created this agent.
   */
  PageAgent(
      FrontendChannel frontendChannel,
      PageTargetController& targetController,
      PageTarget::SessionMetadata sessionMetadata,
      SessionState& sessionState);

  /**
   * Handle a CDP request. The response will be sent over the provided
   * \c FrontendChannel synchronously or asynchronously.
   * \param req The parsed request.
   */
  void handleRequest(const cdp::PreparsedRequest& req);

  /**
   * Replace the current InstanceAgent with the given one and notify the
   * frontend about the new instance.
   * \param agent The new InstanceAgent. May be null to signify that there is
   * currently no active instance.
   */
  void setCurrentInstanceAgent(std::shared_ptr<InstanceAgent> agent);

 private:
  /**
   * Send a simple Log.entryAdded notification with the given
   * \param text. You must ensure that the frontend has enabled Log
   * notifications (using Log.enable) prior to calling this function. In Chrome
   * DevTools, the message will appear in the Console tab along with regular
   * console messages. The difference between Log.entryAdded and
   * Runtime.consoleAPICalled is that the latter requires an execution context
   * ID, which does not exist at the Page level.
   */
  void sendInfoLogEntry(std::string_view text);

  FrontendChannel frontendChannel_;
  PageTargetController& targetController_;
  const PageTarget::SessionMetadata sessionMetadata_;
  std::shared_ptr<InstanceAgent> instanceAgent_;

  /**
   * A shared reference to the session's state. This is only safe to access
   * during handleRequest and other method calls on the same thread.
   */
  SessionState& sessionState_;
};

} // namespace facebook::react::jsinspector_modern