// Copyright Joyent, Inc. and other Node contributors.

//

// Permission is hereby granted, free of charge, to any person obtaining a

// copy of this software and associated documentation files (the

// "Software"), to deal in the Software without restriction, including

// without limitation the rights to use, copy, modify, merge, publish,

// distribute, sublicense, and/or sell copies of the Software, and to permit

// persons to whom the Software is furnished to do so, subject to the

// following conditions:

//

// The above copyright notice and this permission notice shall be included

// in all copies or substantial portions of the Software.

//

// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS

// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF

// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN

// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,

// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR

// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE

// USE OR OTHER DEALINGS IN THE SOFTWARE.

#ifndef SRC_ENV_H_

#define SRC_ENV_H_

#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS

#include "aliased_buffer.h"

#if HAVE_INSPECTOR

#include "inspector_agent.h"

#include "inspector_profiler.h"

#endif

#include "callback_queue.h"

#include "cleanup_queue-inl.h"

#include "debug_utils.h"

#include "env_properties.h"

#include "handle_wrap.h"

#include "node.h"

#include "node_binding.h"

#include "node_builtins.h"

#include "node_exit_code.h"

#include "node_main_instance.h"

#include "node_options.h"

#include "node_perf_common.h"

#include "node_realm.h"

#include "node_snapshotable.h"

#include "req_wrap.h"

#include "util.h"

#include "uv.h"

#include "v8.h"

#include <array>

#include <atomic>

#include <cstdint>

#include <functional>

#include <list>

#include <memory>

#include <ostream>

#include <set>

#include <string>

#include <unordered_map>

#include <unordered_set>

#include <vector>

namespace node {

namespace contextify {

class ContextifyScript;

class CompiledFnEntry;

}

namespace performance {

class PerformanceState;

}

namespace tracing {

class AgentWriterHandle;

}

#if HAVE_INSPECTOR

namespace profiler {

class V8CoverageConnection;

class V8CpuProfilerConnection;

class V8HeapProfilerConnection;

}  // namespace profiler

namespace inspector {

class ParentInspectorHandle;

}

#endif  // HAVE_INSPECTOR

namespace worker {

class Worker;

}

namespace loader {

class ModuleWrap;

}  // namespace loader

class Environment;

class Realm;

// Disables zero-filling for ArrayBuffer allocations in this scope. This is

// similar to how we implement Buffer.allocUnsafe() in JS land.

class NoArrayBufferZeroFillScope {

 public:

  inline explicit NoArrayBufferZeroFillScope(IsolateData* isolate_data);

  inline ~NoArrayBufferZeroFillScope();

 private:

  NodeArrayBufferAllocator* node_allocator_;

  friend class Environment;

};

struct IsolateDataSerializeInfo {

  std::vector<SnapshotIndex> primitive_values;

  std::vector<PropInfo> template_values;

  friend std::ostream& operator<<(std::ostream& o,

                                  const IsolateDataSerializeInfo& i);

};

class NODE_EXTERN_PRIVATE IsolateData : public MemoryRetainer {

 public:

  IsolateData(v8::Isolate* isolate,

              uv_loop_t* event_loop,

              MultiIsolatePlatform* platform = nullptr,

              ArrayBufferAllocator* node_allocator = nullptr,

              const IsolateDataSerializeInfo* isolate_data_info = nullptr);

  void MemoryInfo(MemoryTracker* tracker) const override;

  IsolateDataSerializeInfo Serialize(v8::SnapshotCreator* creator);

  inline uv_loop_t* event_loop() const;

  inline MultiIsolatePlatform* platform() const;

  inline std::shared_ptr<PerIsolateOptions> options();

  inline void set_options(std::shared_ptr<PerIsolateOptions> options);

  inline NodeArrayBufferAllocator* node_allocator() const;

  inline worker::Worker* worker_context() const;

  inline void set_worker_context(worker::Worker* context);

#define VP(PropertyName, StringValue) V(v8::Private, PropertyName)

#define VY(PropertyName, StringValue) V(v8::Symbol, PropertyName)

#define VS(PropertyName, StringValue) V(v8::String, PropertyName)

#define V(TypeName, PropertyName)                                             \

  inline v8::Local<TypeName> PropertyName() const;

  PER_ISOLATE_PRIVATE_SYMBOL_PROPERTIES(VP)

  PER_ISOLATE_SYMBOL_PROPERTIES(VY)

  PER_ISOLATE_STRING_PROPERTIES(VS)

#undef V

#undef VY

#undef VS

#undef VP

#define V(PropertyName, TypeName)                                              \

  inline v8::Local<TypeName> PropertyName() const;                             \

  inline void set_##PropertyName(v8::Local<TypeName> value);

  PER_ISOLATE_TEMPLATE_PROPERTIES(V)

#undef V

  inline v8::Local<v8::String> async_wrap_provider(int index) const;

  size_t max_young_gen_size = 1;

  std::unordered_map<const char*, v8::Eternal<v8::String>> static_str_map;

  inline v8::Isolate* isolate() const;

  IsolateData(const IsolateData&) = delete;

  IsolateData& operator=(const IsolateData&) = delete;

  IsolateData(IsolateData&&) = delete;

  IsolateData& operator=(IsolateData&&) = delete;

 private:

  void DeserializeProperties(const IsolateDataSerializeInfo* isolate_data_info);

  void CreateProperties();

#define VP(PropertyName, StringValue) V(v8::Private, PropertyName)

#define VY(PropertyName, StringValue) V(v8::Symbol, PropertyName)

#define VS(PropertyName, StringValue) V(v8::String, PropertyName)

#define VT(PropertyName, TypeName) V(TypeName, PropertyName)

#define V(TypeName, PropertyName)                                             \

  v8::Eternal<TypeName> PropertyName ## _;

  PER_ISOLATE_PRIVATE_SYMBOL_PROPERTIES(VP)

  PER_ISOLATE_SYMBOL_PROPERTIES(VY)

  PER_ISOLATE_STRING_PROPERTIES(VS)

  PER_ISOLATE_TEMPLATE_PROPERTIES(VT)

#undef V

#undef V

#undef VT

#undef VS

#undef VY

#undef VP

  // Keep a list of all Persistent strings used for AsyncWrap Provider types.

  std::array<v8::Eternal<v8::String>, AsyncWrap::PROVIDERS_LENGTH>

      async_wrap_providers_;

  v8::Isolate* const isolate_;

  uv_loop_t* const event_loop_;

  NodeArrayBufferAllocator* const node_allocator_;

  MultiIsolatePlatform* platform_;

  std::shared_ptr<PerIsolateOptions> options_;

  worker::Worker* worker_context_ = nullptr;

};

struct ContextInfo {

  const std::string name;

  std::string origin;

  bool is_default = false;

};

class EnabledDebugList;

namespace per_process {

extern std::shared_ptr<KVStore> system_environment;

}

struct EnvSerializeInfo;

class AsyncHooks : public MemoryRetainer {

 public:

  void MemoryInfo(MemoryTracker* tracker) const override;

  // Reason for both UidFields and Fields are that one is stored as a double*

  // and the other as a uint32_t*.

  enum Fields {

    kInit,

    kBefore,

    kAfter,

    kDestroy,

    kPromiseResolve,

    kTotals,

    kCheck,

    kStackLength,

    kUsesExecutionAsyncResource,

    kFieldsCount,

  };

  enum UidFields {

    kExecutionAsyncId,

    kTriggerAsyncId,

    kAsyncIdCounter,

    kDefaultTriggerAsyncId,

    kUidFieldsCount,

  };

  inline AliasedUint32Array& fields();

  inline AliasedFloat64Array& async_id_fields();

  inline AliasedFloat64Array& async_ids_stack();

  inline v8::Local<v8::Array> js_execution_async_resources();

  // Returns the native executionAsyncResource value at stack index `index`.

  // Resources provided on the JS side are not stored on the native stack,

  // in which case an empty `Local<>` is returned.

  // The `js_execution_async_resources` array contains the value in that case.

  inline v8::Local<v8::Object> native_execution_async_resource(size_t index);

  void InstallPromiseHooks(v8::Local<v8::Context> ctx);

  void ResetPromiseHooks(v8::Local<v8::Function> init,

                         v8::Local<v8::Function> before,

                         v8::Local<v8::Function> after,

                         v8::Local<v8::Function> resolve);

  inline v8::Local<v8::String> provider_string(int idx);

  inline void no_force_checks();

  inline Environment* env();

  // NB: This call does not take (co-)ownership of `execution_async_resource`.

  // The lifetime of the `v8::Local<>` pointee must last until

  // `pop_async_context()` or `clear_async_id_stack()` are called.

  void push_async_context(double async_id,

                          double trigger_async_id,

                          v8::Local<v8::Object> execution_async_resource);

  bool pop_async_context(double async_id);

  void clear_async_id_stack();  // Used in fatal exceptions.

  AsyncHooks(const AsyncHooks&) = delete;

  AsyncHooks& operator=(const AsyncHooks&) = delete;

  AsyncHooks(AsyncHooks&&) = delete;

  AsyncHooks& operator=(AsyncHooks&&) = delete;

  // Used to set the kDefaultTriggerAsyncId in a scope. This is instead of

  // passing the trigger_async_id along with other constructor arguments.

  class DefaultTriggerAsyncIdScope {

   public:

    DefaultTriggerAsyncIdScope() = delete;

    explicit DefaultTriggerAsyncIdScope(Environment* env,

                                        double init_trigger_async_id);

    explicit DefaultTriggerAsyncIdScope(AsyncWrap* async_wrap);

    ~DefaultTriggerAsyncIdScope();

    DefaultTriggerAsyncIdScope(const DefaultTriggerAsyncIdScope&) = delete;

    DefaultTriggerAsyncIdScope& operator=(const DefaultTriggerAsyncIdScope&) =

        delete;

    DefaultTriggerAsyncIdScope(DefaultTriggerAsyncIdScope&&) = delete;

    DefaultTriggerAsyncIdScope& operator=(DefaultTriggerAsyncIdScope&&) =

        delete;

   private:

    AsyncHooks* async_hooks_;

    double old_default_trigger_async_id_;

  };

  struct SerializeInfo {

    AliasedBufferIndex async_ids_stack;

    AliasedBufferIndex fields;

    AliasedBufferIndex async_id_fields;

    SnapshotIndex js_execution_async_resources;

    std::vector<SnapshotIndex> native_execution_async_resources;

  };

  SerializeInfo Serialize(v8::Local<v8::Context> context,

                          v8::SnapshotCreator* creator);

  void Deserialize(v8::Local<v8::Context> context);

 private:

  friend class Environment;  // So we can call the constructor.

  explicit AsyncHooks(v8::Isolate* isolate, const SerializeInfo* info);

  [[noreturn]] void FailWithCorruptedAsyncStack(double expected_async_id);

  // Stores the ids of the current execution context stack.

  AliasedFloat64Array async_ids_stack_;

  // Attached to a Uint32Array that tracks the number of active hooks for

  // each type.

  AliasedUint32Array fields_;

  // Attached to a Float64Array that tracks the state of async resources.

  AliasedFloat64Array async_id_fields_;

  void grow_async_ids_stack();

  v8::Global<v8::Array> js_execution_async_resources_;

  std::vector<v8::Local<v8::Object>> native_execution_async_resources_;

  // Non-empty during deserialization

  const SerializeInfo* info_ = nullptr;

  std::array<v8::Global<v8::Function>, 4> js_promise_hooks_;

};

class ImmediateInfo : public MemoryRetainer {

 public:

  inline AliasedUint32Array& fields();

  inline uint32_t count() const;

  inline uint32_t ref_count() const;

  inline bool has_outstanding() const;

  inline void ref_count_inc(uint32_t increment);

  inline void ref_count_dec(uint32_t decrement);

  ImmediateInfo(const ImmediateInfo&) = delete;

  ImmediateInfo& operator=(const ImmediateInfo&) = delete;

  ImmediateInfo(ImmediateInfo&&) = delete;

  ImmediateInfo& operator=(ImmediateInfo&&) = delete;

  void MemoryInfo(MemoryTracker* tracker) const override;

  struct SerializeInfo {

    AliasedBufferIndex fields;

  };

  SerializeInfo Serialize(v8::Local<v8::Context> context,

                          v8::SnapshotCreator* creator);

  void Deserialize(v8::Local<v8::Context> context);

 private:

  friend class Environment;  // So we can call the constructor.

  explicit ImmediateInfo(v8::Isolate* isolate, const SerializeInfo* info);

  enum Fields { kCount, kRefCount, kHasOutstanding, kFieldsCount };

  AliasedUint32Array fields_;

};

class TickInfo : public MemoryRetainer {

 public:

  inline AliasedUint8Array& fields();

  inline bool has_tick_scheduled() const;

  inline bool has_rejection_to_warn() const;

  void MemoryInfo(MemoryTracker* tracker) const override;

  TickInfo(const TickInfo&) = delete;

  TickInfo& operator=(const TickInfo&) = delete;

  TickInfo(TickInfo&&) = delete;

  TickInfo& operator=(TickInfo&&) = delete;

  struct SerializeInfo {

    AliasedBufferIndex fields;

  };

  SerializeInfo Serialize(v8::Local<v8::Context> context,

                          v8::SnapshotCreator* creator);

  void Deserialize(v8::Local<v8::Context> context);

 private:

  friend class Environment;  // So we can call the constructor.

  explicit TickInfo(v8::Isolate* isolate, const SerializeInfo* info);

  enum Fields { kHasTickScheduled = 0, kHasRejectionToWarn, kFieldsCount };

  AliasedUint8Array fields_;

};

class TrackingTraceStateObserver :

    public v8::TracingController::TraceStateObserver {

 public:

 private:

  void UpdateTraceCategoryState();

  Environment* env_;

};

class ShouldNotAbortOnUncaughtScope {

 public:

  explicit inline ShouldNotAbortOnUncaughtScope(Environment* env);

  inline void Close();

  inline ~ShouldNotAbortOnUncaughtScope();

  ShouldNotAbortOnUncaughtScope(const ShouldNotAbortOnUncaughtScope&) = delete;

  ShouldNotAbortOnUncaughtScope& operator=(

      const ShouldNotAbortOnUncaughtScope&) = delete;

  ShouldNotAbortOnUncaughtScope(ShouldNotAbortOnUncaughtScope&&) = delete;

  ShouldNotAbortOnUncaughtScope& operator=(ShouldNotAbortOnUncaughtScope&&) =

      delete;

 private:

  Environment* env_;

};

typedef void (*DeserializeRequestCallback)(v8::Local<v8::Context> context,

                                           v8::Local<v8::Object> holder,

                                           int index,

                                           InternalFieldInfoBase* info);

struct DeserializeRequest {

  DeserializeRequestCallback cb;

  v8::Global<v8::Object> holder;

  int index;

  InternalFieldInfoBase* info = nullptr;  // Owned by the request

};

struct EnvSerializeInfo {

  std::vector<std::string> builtins;

  AsyncHooks::SerializeInfo async_hooks;

  TickInfo::SerializeInfo tick_info;

  ImmediateInfo::SerializeInfo immediate_info;

  performance::PerformanceState::SerializeInfo performance_state;

  AliasedBufferIndex exit_info;

  AliasedBufferIndex stream_base_state;

  AliasedBufferIndex should_abort_on_uncaught_toggle;

  RealmSerializeInfo principal_realm;

  friend std::ostream& operator<<(std::ostream& o, const EnvSerializeInfo& i);

};

struct SnapshotMetadata {

  // For now kFullyCustomized is only built with the --build-snapshot CLI flag.

  // We might want to add more types of snapshots in the future.

  enum class Type : uint8_t { kDefault, kFullyCustomized };

  Type type;

  std::string node_version;

  std::string node_arch;

  std::string node_platform;

  // Result of v8::ScriptCompiler::CachedDataVersionTag().

  uint32_t v8_cache_version_tag;

};

struct SnapshotData {

  enum class DataOwnership { kOwned, kNotOwned };

  static const uint32_t kMagic = 0x143da19;

  static const SnapshotIndex kNodeVMContextIndex = 0;

  static const SnapshotIndex kNodeBaseContextIndex = kNodeVMContextIndex + 1;

  static const SnapshotIndex kNodeMainContextIndex = kNodeBaseContextIndex + 1;

  DataOwnership data_ownership = DataOwnership::kOwned;

  SnapshotMetadata metadata;

  // The result of v8::SnapshotCreator::CreateBlob() during the snapshot

  // building process.

  v8::StartupData v8_snapshot_blob_data{nullptr, 0};

  IsolateDataSerializeInfo isolate_data_info;

  // TODO(joyeecheung): there should be a vector of env_info once we snapshot

  // the worker environments.

  EnvSerializeInfo env_info;

  // A vector of built-in ids and v8::ScriptCompiler::CachedData, this can be

  // shared across Node.js instances because they are supposed to share the

  // read only space. We use builtins::CodeCacheInfo because

  // v8::ScriptCompiler::CachedData is not copyable.

  std::vector<builtins::CodeCacheInfo> code_cache;

  void ToBlob(FILE* out) const;

  // If returns false, the metadata doesn't match the current Node.js binary,

  // and the caller should not consume the snapshot data.

  bool Check() const;

  static bool FromBlob(SnapshotData* out, FILE* in);

  ~SnapshotData();

};

void DefaultProcessExitHandlerInternal(Environment* env, ExitCode exit_code);

v8::Maybe<ExitCode> SpinEventLoopInternal(Environment* env);

v8::Maybe<ExitCode> EmitProcessExitInternal(Environment* env);

/**

 * Environment is a per-isolate data structure that represents an execution

 * environment. Each environment has a principal realm. An environment can

 * create multiple subsidiary synthetic realms.

 */

class Environment : public MemoryRetainer {

 public:

  Environment(const Environment&) = delete;

  Environment& operator=(const Environment&) = delete;

  Environment(Environment&&) = delete;

  Environment& operator=(Environment&&) = delete;

  inline size_t SelfSize() const override;

  void MemoryInfo(MemoryTracker* tracker) const override;

  EnvSerializeInfo Serialize(v8::SnapshotCreator* creator);

  void DeserializeProperties(const EnvSerializeInfo* info);

  void PrintInfoForSnapshotIfDebug();

  void EnqueueDeserializeRequest(DeserializeRequestCallback cb,

                                 v8::Local<v8::Object> holder,

                                 int index,

                                 InternalFieldInfoBase* info);

  void RunDeserializeRequests();

  // Should be called before InitializeInspector()

  void InitializeDiagnostics();

  std::string GetCwd();

#if HAVE_INSPECTOR

  // If the environment is created for a worker, pass parent_handle and

  // the ownership if transferred into the Environment.

  void InitializeInspector(

      std::unique_ptr<inspector::ParentInspectorHandle> parent_handle);

#endif

  inline size_t async_callback_scope_depth() const;

  inline void PushAsyncCallbackScope();

  inline void PopAsyncCallbackScope();

  static inline Environment* GetCurrent(v8::Isolate* isolate);

  static inline Environment* GetCurrent(v8::Local<v8::Context> context);

  static inline Environment* GetCurrent(

      const v8::FunctionCallbackInfo<v8::Value>& info);

  template <typename T>

  static inline Environment* GetCurrent(

      const v8::PropertyCallbackInfo<T>& info);

  // Methods created using SetMethod(), SetPrototypeMethod(), etc. inside

  // this scope can access the created T* object using

  // GetBindingData<T>(args) later.

  template <typename T>

  T* AddBindingData(v8::Local<v8::Context> context,

                    v8::Local<v8::Object> target);

  template <typename T, typename U>

  static inline T* GetBindingData(const v8::PropertyCallbackInfo<U>& info);

  template <typename T>

  static inline T* GetBindingData(

      const v8::FunctionCallbackInfo<v8::Value>& info);

  template <typename T>

  static inline T* GetBindingData(v8::Local<v8::Context> context);

  typedef std::unordered_map<

      FastStringKey,

      BaseObjectPtr<BaseObject>,

      FastStringKey::Hash> BindingDataStore;

  // Create an Environment without initializing a main Context. Use

  // InitializeMainContext() to initialize a main context for it.

  Environment(IsolateData* isolate_data,

              v8::Isolate* isolate,

              const std::vector<std::string>& args,

              const std::vector<std::string>& exec_args,

              const EnvSerializeInfo* env_info,

              EnvironmentFlags::Flags flags,

              ThreadId thread_id);

  void InitializeMainContext(v8::Local<v8::Context> context,

                             const EnvSerializeInfo* env_info);

  // Create an Environment and initialize the provided principal context for it.

  Environment(IsolateData* isolate_data,

              v8::Local<v8::Context> context,

              const std::vector<std::string>& args,

              const std::vector<std::string>& exec_args,

              const EnvSerializeInfo* env_info,

              EnvironmentFlags::Flags flags,

              ThreadId thread_id);

  ~Environment() override;

  void InitializeLibuv();

  inline const std::vector<std::string>& exec_argv();

  inline const std::vector<std::string>& argv();

  const std::string& exec_path() const;

  typedef void (*HandleCleanupCb)(Environment* env,

                                  uv_handle_t* handle,

                                  void* arg);

  struct HandleCleanup {

    uv_handle_t* handle_;

    HandleCleanupCb cb_;

    void* arg_;

  };

  void RegisterHandleCleanups();

  void CleanupHandles();

  void Exit(ExitCode code);

  void ExitEnv();

  // Register clean-up cb to be called on environment destruction.

  inline void RegisterHandleCleanup(uv_handle_t* handle,

                                    HandleCleanupCb cb,

                                    void* arg);

  template <typename T, typename OnCloseCallback>

  inline void CloseHandle(T* handle, OnCloseCallback callback);

  void ResetPromiseHooks(v8::Local<v8::Function> init,

                         v8::Local<v8::Function> before,

                         v8::Local<v8::Function> after,

                         v8::Local<v8::Function> resolve);

  void AssignToContext(v8::Local<v8::Context> context,

                       Realm* realm,

                       const ContextInfo& info);

  void TrackContext(v8::Local<v8::Context> context);

  void UntrackContext(v8::Local<v8::Context> context);

  void StartProfilerIdleNotifier();

  inline v8::Isolate* isolate() const;

  inline uv_loop_t* event_loop() const;

  void TryLoadAddon(const char* filename,

                    int flags,

                    const std::function<bool(binding::DLib*)>& was_loaded);

  static inline Environment* from_timer_handle(uv_timer_t* handle);

  inline uv_timer_t* timer_handle();

  static inline Environment* from_immediate_check_handle(uv_check_t* handle);

  inline uv_check_t* immediate_check_handle();

  inline uv_idle_t* immediate_idle_handle();

  inline void IncreaseWaitingRequestCounter();

  inline void DecreaseWaitingRequestCounter();

  inline AsyncHooks* async_hooks();

  inline ImmediateInfo* immediate_info();

  inline TickInfo* tick_info();

  inline uint64_t timer_base() const;

  inline std::shared_ptr<KVStore> env_vars();

  inline void set_env_vars(std::shared_ptr<KVStore> env_vars);

  inline IsolateData* isolate_data() const;

  inline bool printed_error() const;

  inline void set_printed_error(bool value);

  void PrintSyncTrace() const;

  inline void set_trace_sync_io(bool value);

  inline void set_force_context_aware(bool value);

  inline bool force_context_aware() const;

  // This contains fields that are a pseudo-boolean that keeps track of whether

  // the process is exiting, an integer representing the process exit code, and

  // a pseudo-boolean to indicate whether the exit code is undefined.

  inline AliasedInt32Array& exit_info();

  inline void set_exiting(bool value);

  inline ExitCode exit_code(const ExitCode default_code) const;

  // This stores whether the --abort-on-uncaught-exception flag was passed

  // to Node.

  inline bool abort_on_uncaught_exception() const;

  inline void set_abort_on_uncaught_exception(bool value);

  // This is a pseudo-boolean that keeps track of whether an uncaught exception

  // should abort the process or not if --abort-on-uncaught-exception was

  // passed to Node. If the flag was not passed, it is ignored.

  inline AliasedUint32Array& should_abort_on_uncaught_toggle();

  inline AliasedInt32Array& stream_base_state();

  // The necessary API for async_hooks.

  inline double new_async_id();

  inline double execution_async_id();

  inline double trigger_async_id();

  inline double get_default_trigger_async_id();

  // List of id's that have been destroyed and need the destroy() cb called.

  inline std::vector<double>* destroy_async_id_list();

  std::set<struct node_module*> internal_bindings;

  std::set<std::string> builtins_with_cache;

  std::set<std::string> builtins_without_cache;

  // This is only filled during deserialization. We use a vector since

  // it's only used for tests.

  std::vector<std::string> builtins_in_snapshot;

  std::unordered_multimap<int, loader::ModuleWrap*> hash_to_module_map;

  std::unordered_map<uint32_t, loader::ModuleWrap*> id_to_module_map;

  std::unordered_map<uint32_t, contextify::ContextifyScript*>

      id_to_script_map;

  std::unordered_map<uint32_t, contextify::CompiledFnEntry*> id_to_function_map;

  inline uint32_t get_next_module_id();

  inline uint32_t get_next_script_id();

  inline uint32_t get_next_function_id();

  inline performance::PerformanceState* performance_state();

  void CollectUVExceptionInfo(v8::Local<v8::Value> context,

                              int errorno,

                              const char* syscall = nullptr,

                              const char* message = nullptr,

                              const char* path = nullptr,

                              const char* dest = nullptr);

  // If this flag is set, calls into JS (if they would be observable

  // from userland) must be avoided.  This flag does not indicate whether

  // calling into JS is allowed from a VM perspective at this point.

  inline bool can_call_into_js() const;

  inline void set_can_call_into_js(bool can_call_into_js);

  // Increase or decrease a counter that manages whether this Environment

  // keeps the event loop alive on its own or not. The counter starts out at 0,

  // meaning it does not, and any positive value will make it keep the event

  // loop alive.

  // This is used by Workers to manage their own .ref()/.unref() implementation,

  // as Workers aren't directly associated with their own libuv handles.

  void add_refs(int64_t diff);

  // Convenient getter of the principal realm's has_run_bootstrapping_code().

  inline bool has_run_bootstrapping_code() const;

  inline bool has_serialized_options() const;

  inline void set_has_serialized_options(bool has_serialized_options);

  inline bool is_main_thread() const;

  inline bool no_native_addons() const;

  inline bool should_not_register_esm_loader() const;

  inline bool should_create_inspector() const;

  inline bool owns_process_state() const;

  inline bool owns_inspector() const;

  inline bool tracks_unmanaged_fds() const;

  inline bool hide_console_windows() const;

  inline bool no_global_search_paths() const;

  inline bool no_browser_globals() const;

  inline uint64_t thread_id() const;

  inline worker::Worker* worker_context() const;

  Environment* worker_parent_env() const;

  inline void add_sub_worker_context(worker::Worker* context);

  inline void remove_sub_worker_context(worker::Worker* context);

  void stop_sub_worker_contexts();

  template <typename Fn>

  inline void ForEachWorker(Fn&& iterator);

  inline bool is_stopping() const;

  inline void set_stopping(bool value);

  inline std::list<node_module>* extra_linked_bindings();

  inline node_module* extra_linked_bindings_head();

  inline node_module* extra_linked_bindings_tail();

  inline const Mutex& extra_linked_bindings_mutex() const;

  inline bool filehandle_close_warning() const;

  inline void set_filehandle_close_warning(bool on);

  inline void set_source_maps_enabled(bool on);

  inline bool source_maps_enabled() const;

  inline void ThrowError(const char* errmsg);

  inline void ThrowTypeError(const char* errmsg);

  inline void ThrowRangeError(const char* errmsg);

  inline void ThrowErrnoException(int errorno,

                                  const char* syscall = nullptr,

                                  const char* message = nullptr,

                                  const char* path = nullptr);

  inline void ThrowUVException(int errorno,

                               const char* syscall = nullptr,

                               const char* message = nullptr,

                               const char* path = nullptr,

                               const char* dest = nullptr);

  void AtExit(void (*cb)(void* arg), void* arg);

  void RunAtExitCallbacks();

  void RunWeakRefCleanup();

  v8::MaybeLocal<v8::Value> RunSnapshotSerializeCallback() const;

  v8::MaybeLocal<v8::Value> RunSnapshotDeserializeCallback() const;

  v8::MaybeLocal<v8::Value> RunSnapshotDeserializeMain() const;

  // Primitive values are shared across realms.

  // The getters simply proxy to the per-isolate primitive.

#define VP(PropertyName, StringValue) V(v8::Private, PropertyName)

#define VY(PropertyName, StringValue) V(v8::Symbol, PropertyName)

#define VS(PropertyName, StringValue) V(v8::String, PropertyName)

#define V(TypeName, PropertyName)                                             \

  inline v8::Local<TypeName> PropertyName() const;

  PER_ISOLATE_PRIVATE_SYMBOL_PROPERTIES(VP)

  PER_ISOLATE_SYMBOL_PROPERTIES(VY)

  PER_ISOLATE_STRING_PROPERTIES(VS)

#undef V

#undef VS

#undef VY

#undef VP

#define V(PropertyName, TypeName)                                             \

  inline v8::Local<TypeName> PropertyName() const;                            \

  inline void set_ ## PropertyName(v8::Local<TypeName> value);

  PER_ISOLATE_TEMPLATE_PROPERTIES(V)

  // Per-realm strong persistent values of the principal realm.

  // Get/set the value with an explicit realm instead when possible.

  // Deprecate soon.

  PER_REALM_STRONG_PERSISTENT_VALUES(V)

#undef V

  // Return the context of the principal realm.

  // Get the context with an explicit realm instead when possible.

  // Deprecate soon.

  inline v8::Local<v8::Context> context() const;

  inline Realm* principal_realm() const;

#if HAVE_INSPECTOR

  }

  inline bool is_in_inspector_console_call() const;

  inline void set_is_in_inspector_console_call(bool value);

#endif

  typedef ListHead<HandleWrap, &HandleWrap::handle_wrap_queue_> HandleWrapQueue;

  typedef ListHead<ReqWrapBase, &ReqWrapBase::req_wrap_queue_> ReqWrapQueue;

  }

  }

  }

  }

  // cb will be called as cb(env) on the next event loop iteration.

  // Unlike the JS setImmediate() function, nested SetImmediate() calls will

  // be run without returning control to the event loop, similar to nextTick().

  template <typename Fn>

  inline void SetImmediate(

      Fn&& cb, CallbackFlags::Flags flags = CallbackFlags::kRefed);

  template <typename Fn>

  // This behaves like SetImmediate() but can be called from any thread.

  inline void SetImmediateThreadsafe(

      Fn&& cb, CallbackFlags::Flags flags = CallbackFlags::kRefed);

  // This behaves like V8's Isolate::RequestInterrupt(), but also accounts for

  // the event loop (i.e. combines the V8 function with SetImmediate()).

  // The passed callback may not throw exceptions.

  // This function can be called from any thread.

  template <typename Fn>

  inline void RequestInterrupt(Fn&& cb);

  // This needs to be available for the JS-land setImmediate().

  void ToggleImmediateRef(bool ref);

  inline void PushShouldNotAbortOnUncaughtScope();

  inline void PopShouldNotAbortOnUncaughtScope();

  inline bool inside_should_not_abort_on_uncaught_scope() const;

  static inline Environment* ForAsyncHooks(AsyncHooks* hooks);

  v8::Local<v8::Value> GetNow();

  void ScheduleTimer(int64_t duration);

  void ToggleTimerRef(bool ref);

  inline void AddCleanupHook(CleanupQueue::Callback cb, void* arg);

  inline void RemoveCleanupHook(CleanupQueue::Callback cb, void* arg);

  void RunCleanup();

  static size_t NearHeapLimitCallback(void* data,

                                      size_t current_heap_limit,

                                      size_t initial_heap_limit);

  static void BuildEmbedderGraph(v8::Isolate* isolate,

                                 v8::EmbedderGraph* graph,

                                 void* data);

  inline std::shared_ptr<EnvironmentOptions> options();

  inline std::shared_ptr<ExclusiveAccess<HostPort>> inspector_host_port();

#if HAVE_INSPECTOR

  void set_coverage_connection(

      std::unique_ptr<profiler::V8CoverageConnection> connection);

  profiler::V8CoverageConnection* coverage_connection();

  inline void set_coverage_directory(const char* directory);

  inline const std::string& coverage_directory() const;

  void set_cpu_profiler_connection(

      std::unique_ptr<profiler::V8CpuProfilerConnection> connection);

  profiler::V8CpuProfilerConnection* cpu_profiler_connection();

  inline void set_cpu_prof_name(const std::string& name);

  inline const std::string& cpu_prof_name() const;

  inline void set_cpu_prof_interval(uint64_t interval);

  inline uint64_t cpu_prof_interval() const;

  inline void set_cpu_prof_dir(const std::string& dir);

  inline const std::string& cpu_prof_dir() const;

  void set_heap_profiler_connection(

      std::unique_ptr<profiler::V8HeapProfilerConnection> connection);

  profiler::V8HeapProfilerConnection* heap_profiler_connection();

  inline void set_heap_prof_name(const std::string& name);

  inline const std::string& heap_prof_name() const;

  inline void set_heap_prof_dir(const std::string& dir);

  inline const std::string& heap_prof_dir() const;

  inline void set_heap_prof_interval(uint64_t interval);

  inline uint64_t heap_prof_interval() const;

#endif  // HAVE_INSPECTOR

  inline void set_main_utf16(std::unique_ptr<v8::String::Value>);

  inline void set_process_exit_handler(

      std::function<void(Environment*, ExitCode)>&& handler);

  void RunAndClearNativeImmediates(bool only_refed = false);

  void RunAndClearInterrupts();

  uv_buf_t allocate_managed_buffer(const size_t suggested_size);

  std::unique_ptr<v8::BackingStore> release_managed_buffer(const uv_buf_t& buf);

  void AddUnmanagedFd(int fd);

  void RemoveUnmanagedFd(int fd);

  template <typename T>

  void ForEachRealm(T&& iterator) const;

  inline void set_heap_snapshot_near_heap_limit(uint32_t limit);

  inline bool is_in_heapsnapshot_heap_limit_callback() const;

  inline void AddHeapSnapshotNearHeapLimitCallback();

  inline void RemoveHeapSnapshotNearHeapLimitCallback(size_t heap_limit);

  // Field identifiers for exit_info_

  enum ExitInfoField {

    kExiting = 0,

    kExitCode,

    kHasExitCode,

    kExitInfoFieldCount

  };