src/node_config_file.h

#ifndef SRC_NODE_CONFIG_FILE_H_
#define SRC_NODE_CONFIG_FILE_H_

#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS

#include <map>
#include <string>
#include <unordered_map>
#include <unordered_set>
#include <variant>
#include <vector>
#include "node_internals.h"
#include "simdjson.h"
#include "util-inl.h"

namespace node {

// When trying to parse the configuration file, we can have three possible
// results:
//  - Valid: The file was successfully parsed and the content is valid.
//  - FileError: There was an error reading the file.
//  - InvalidContent: The file was read, but the content is invalid.
enum ParseResult { Valid, FileError, InvalidContent };

// ConfigReader is the class that parses the configuration JSON file.
// It reads the file provided by --experimental-config-file and
// extracts the flags.
class ConfigReader {
 public:
  ParseResult ParseConfig(const std::string_view& config_path);

  std::optional<std::string_view> GetDataFromArgs(
      const std::vector<std::string>& args);

  std::string GetNodeOptions();
  const std::vector<std::string>& GetNamespaceFlags() const;

  size_t GetFlagsSize();

 private:
  // Parse options for a specific namespace (including nodeOptions for backward
  // compatibility)
  ParseResult ParseOptions(simdjson::ondemand::object* options_object,
                           std::unordered_set<std::string>* unique_options,
                           const std::string& namespace_name);

  // Process a single option value based on its type
  ParseResult ProcessOptionValue(
      const std::pair<std::string, options_parser::OptionType>& option_info,
      simdjson::ondemand::value* option_value,
      std::vector<std::string>* output);

  std::vector<std::string> node_options_;
  std::vector<std::string> namespace_options_;

  // Cache for fast lookup of environment options
  std::unordered_map<std::string, options_parser::OptionType> env_options_map_;
  bool env_options_initialized_ = false;
};

}  // namespace node

#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS

#endif  // SRC_NODE_CONFIG_FILE_H_