#ifndef SRC_NODE_H_

#define SRC_NODE_H_

#ifdef _WIN32

# ifndef BUILDING_NODE_EXTENSION

# define NODE_EXTERN __declspec(dllexport)

# else

# define NODE_EXTERN __declspec(dllimport)

# endif

#else

# define NODE_EXTERN __attribute__((visibility("default")))

#endif

#ifdef NODE_SHARED_MODE

#define NODE_EXTERN_PRIVATE NODE_EXTERN

#else

#define NODE_EXTERN_PRIVATE

#endif

#ifdef BUILDING_NODE_EXTENSION

# undef BUILDING_V8_SHARED

# undef BUILDING_UV_SHARED

# define USING_V8_SHARED 1

# define USING_UV_SHARED 1

#endif

#if defined(__MINGW32__) || defined(_MSC_VER)

#ifndef _WIN32_WINNT

# define _WIN32_WINNT 0x0600 // Windows Server 2008

#endif

#ifndef NOMINMAX

# define NOMINMAX

#endif

#endif

#if defined(_MSC_VER)

#define PATH_MAX MAX_PATH

#endif

#ifdef _WIN32

#define SIGQUIT 3

#define SIGKILL 9

#endif

#include "v8.h" // NOLINT(build/include_order)

#include "v8-platform.h" // NOLINT(build/include_order)

#include "node_version.h" // NODE_MODULE_VERSION

#include "node_api_types.h" // napi_addon_register_func

#include <functional>

#include <memory>

#include <optional>

#include <ostream>

#ifndef _WIN32

#include <signal.h>

#endif // _WIN32

#define NODE_MAKE_VERSION(major, minor, patch) \

((major) * 0x1000 + (minor) * 0x100 + (patch))

#ifdef __clang__

# define NODE_CLANG_AT_LEAST(major, minor, patch) \

(NODE_MAKE_VERSION(major, minor, patch) <= \

NODE_MAKE_VERSION(__clang_major__, __clang_minor__, __clang_patchlevel__))

#else

# define NODE_CLANG_AT_LEAST(major, minor, patch) (0)

#endif

#ifdef __GNUC__

# define NODE_GNUC_AT_LEAST(major, minor, patch) \

(NODE_MAKE_VERSION(major, minor, patch) <= \

NODE_MAKE_VERSION(__GNUC__, __GNUC_MINOR__, __GNUC_PATCHLEVEL__))

#else

# define NODE_GNUC_AT_LEAST(major, minor, patch) (0)

#endif

#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS

# define NODE_DEPRECATED(message, declarator) declarator

#else // NODE_WANT_INTERNALS

# if NODE_CLANG_AT_LEAST(2, 9, 0) || NODE_GNUC_AT_LEAST(4, 5, 0)

# define NODE_DEPRECATED(message, declarator) \

__attribute__((deprecated(message))) declarator

# elif defined(_MSC_VER)

# define NODE_DEPRECATED(message, declarator) \

__declspec(deprecated) declarator

# else

# define NODE_DEPRECATED(message, declarator) declarator

# endif

#endif

struct uv_loop_s;

struct napi_module;

struct ssl_ctx_st; // Forward declaration of SSL_CTX for OpenSSL.

namespace node {

struct SnapshotData;

namespace tracing {

class TracingController;

}

NODE_EXTERN v8::Local<v8::Value> ErrnoException(v8::Isolate* isolate,

int errorno,

const char* syscall = nullptr,

const char* message = nullptr,

const char* path = nullptr);

NODE_EXTERN v8::Local<v8::Value> UVException(v8::Isolate* isolate,

int errorno,

const char* syscall = nullptr,

const char* message = nullptr,

const char* path = nullptr,

const char* dest = nullptr);

NODE_DEPRECATED("Use ErrnoException(isolate, ...)",

inline v8::Local<v8::Value> ErrnoException(

int errorno,

const char* syscall = nullptr,

const char* message = nullptr,

const char* path = nullptr) {

return ErrnoException(v8::Isolate::GetCurrent(),

errorno,

syscall,

message,

path);

})

NODE_DEPRECATED("Use UVException(isolate, ...)",

inline v8::Local<v8::Value> UVException(int errorno,

const char* syscall = nullptr,

const char* message = nullptr,

const char* path = nullptr) {

return UVException(v8::Isolate::GetCurrent(),

errorno,

syscall,

message,

path);

})

} // namespace node

#include <cassert>

#include <cstdint>

#ifndef NODE_STRINGIFY

# define NODE_STRINGIFY(n) NODE_STRINGIFY_HELPER(n)

# define NODE_STRINGIFY_HELPER(n) #n

#endif

#ifdef _WIN32

#if !defined(_SSIZE_T_) && !defined(_SSIZE_T_DEFINED)

typedef intptr_t ssize_t;

# define _SSIZE_T_

# define _SSIZE_T_DEFINED

#endif

#else // !_WIN32

# include <sys/types.h> // size_t, ssize_t

#endif // _WIN32

namespace node {

class IsolateData;

class Environment;

class MultiIsolatePlatform;

class InitializationResultImpl;

namespace ProcessInitializationFlags {

enum Flags : uint32_t {

};

} // namespace ProcessInitializationFlags

namespace ProcessFlags = ProcessInitializationFlags; // Legacy alias.

namespace StopFlags {

enum Flags : uint32_t {

};

} // namespace StopFlags

class NODE_EXTERN InitializationResult {

public:

virtual ~InitializationResult() = default;

// Returns a suggested process exit code.

virtual int exit_code() const = 0;

// Returns 'true' if initialization was aborted early due to errors.

virtual bool early_return() const = 0;

// Returns the parsed list of non-Node.js arguments.

virtual const std::vector<std::string>& args() const = 0;

// Returns the parsed list of Node.js arguments.

virtual const std::vector<std::string>& exec_args() const = 0;

// Returns an array of errors. Note that these may be warnings

// whose existence does not imply a non-zero exit code.

virtual const std::vector<std::string>& errors() const = 0;

// If kNoInitializeNodeV8Platform was not specified, the global Node.js

// platform instance.

virtual MultiIsolatePlatform* platform() const = 0;

private:

InitializationResult() = default;

friend class InitializationResultImpl;

};

NODE_EXTERN int Start(int argc, char* argv[]);

NODE_EXTERN int Stop(Environment* env,

StopFlags::Flags flags = StopFlags::kNoFlags);

NODE_EXTERN std::shared_ptr<InitializationResult> InitializeOncePerProcess(

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

ProcessInitializationFlags::Flags flags =

ProcessInitializationFlags::kNoFlags);

NODE_EXTERN void TearDownOncePerProcess();

inline std::shared_ptr<InitializationResult> InitializeOncePerProcess(

}

enum OptionEnvvarSettings {

};

NODE_EXTERN int ProcessGlobalArgs(std::vector<std::string>* args,

std::vector<std::string>* exec_args,

std::vector<std::string>* errors,

OptionEnvvarSettings settings);

class NodeArrayBufferAllocator;

class NODE_EXTERN ArrayBufferAllocator : public v8::ArrayBuffer::Allocator {

public:

// If `always_debug` is true, create an ArrayBuffer::Allocator instance

// that performs additional integrity checks (e.g. make sure that only memory

// that was allocated by the it is also freed by it).

// This can also be set using the --debug-arraybuffer-allocations flag.

static std::unique_ptr<ArrayBufferAllocator> Create(

bool always_debug = false);

private:

virtual NodeArrayBufferAllocator* GetImpl() = 0;

friend class IsolateData;

};

NODE_EXTERN ArrayBufferAllocator* CreateArrayBufferAllocator();

NODE_EXTERN void FreeArrayBufferAllocator(ArrayBufferAllocator* allocator);

class NODE_EXTERN IsolatePlatformDelegate {

public:

virtual std::shared_ptr<v8::TaskRunner> GetForegroundTaskRunner() = 0;

virtual bool IdleTasksEnabled() = 0;

};

class NODE_EXTERN MultiIsolatePlatform : public v8::Platform {

public:

~MultiIsolatePlatform() override = default;

// Returns true if work was dispatched or executed. New tasks that are

// posted during flushing of the queue are postponed until the next

// flushing.

virtual bool FlushForegroundTasks(v8::Isolate* isolate) = 0;

virtual void DrainTasks(v8::Isolate* isolate) = 0;

// This needs to be called between the calls to `Isolate::Allocate()` and

// `Isolate::Initialize()`, so that initialization can already start

// using the platform.

// When using `NewIsolate()`, this is taken care of by that function.

// This function may only be called once per `Isolate`.

virtual void RegisterIsolate(v8::Isolate* isolate,

struct uv_loop_s* loop) = 0;

// This method can be used when an application handles task scheduling on its

// own through `IsolatePlatformDelegate`. Upon registering an isolate with

// this overload any other method in this class with the exception of

// `UnregisterIsolate` *must not* be used on that isolate.

virtual void RegisterIsolate(v8::Isolate* isolate,

IsolatePlatformDelegate* delegate) = 0;

// This function may only be called once per `Isolate`, and discard any

// pending delayed tasks scheduled for that isolate.

// This needs to be called right after calling `Isolate::Dispose()`.

virtual void UnregisterIsolate(v8::Isolate* isolate) = 0;

// This disposes, unregisters and frees up an isolate that's allocated using

// v8::Isolate::Allocate() in the correct order to prevent race conditions.

void DisposeIsolate(v8::Isolate* isolate);

// The platform should call the passed function once all state associated

// with the given isolate has been cleaned up. This can, but does not have to,

// happen asynchronously.

virtual void AddIsolateFinishedCallback(v8::Isolate* isolate,

void (*callback)(void*),

void* data) = 0;

static std::unique_ptr<MultiIsolatePlatform> Create(

int thread_pool_size,

v8::TracingController* tracing_controller = nullptr,

v8::PageAllocator* page_allocator = nullptr);

};

enum IsolateSettingsFlags {

};

struct IsolateSettings {

};

class EmbedderSnapshotData {

};

NODE_EXTERN void SetIsolateUpForNode(v8::Isolate* isolate,

const IsolateSettings& settings);

NODE_EXTERN void SetIsolateUpForNode(v8::Isolate* isolate);

NODE_EXTERN v8::Isolate* NewIsolate(

ArrayBufferAllocator* allocator,

struct uv_loop_s* event_loop,

MultiIsolatePlatform* platform,

const EmbedderSnapshotData* snapshot_data = nullptr,

const IsolateSettings& settings = {});

NODE_EXTERN v8::Isolate* NewIsolate(

std::shared_ptr<ArrayBufferAllocator> allocator,

struct uv_loop_s* event_loop,

MultiIsolatePlatform* platform,

const EmbedderSnapshotData* snapshot_data = nullptr,

const IsolateSettings& settings = {});

NODE_EXTERN v8::Local<v8::Context> NewContext(

v8::Isolate* isolate,

v8::Local<v8::ObjectTemplate> object_template =

v8::Local<v8::ObjectTemplate>());

NODE_EXTERN v8::Maybe<bool> InitializeContext(v8::Local<v8::Context> context);

NODE_EXTERN IsolateData* CreateIsolateData(

v8::Isolate* isolate,

struct uv_loop_s* loop,

MultiIsolatePlatform* platform = nullptr,

ArrayBufferAllocator* allocator = nullptr,

const EmbedderSnapshotData* snapshot_data = nullptr);

NODE_EXTERN void FreeIsolateData(IsolateData* isolate_data);

struct ThreadId {

uint64_t id = static_cast<uint64_t>(-1);

};

NODE_EXTERN ThreadId AllocateEnvironmentThreadId();

namespace EnvironmentFlags {

enum Flags : uint64_t {

};

} // namespace EnvironmentFlags

enum class SnapshotFlags : uint32_t {

};

struct SnapshotConfig {

};

struct InspectorParentHandle {

virtual ~InspectorParentHandle() = default;

};

NODE_EXTERN Environment* CreateEnvironment(

IsolateData* isolate_data,

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

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

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

EnvironmentFlags::Flags flags = EnvironmentFlags::kDefaultFlags,

ThreadId thread_id = {} /* allocates a thread id automatically */,

std::unique_ptr<InspectorParentHandle> inspector_parent_handle = {});

NODE_EXTERN Environment* CreateEnvironment(

IsolateData* isolate_data,

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

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

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

EnvironmentFlags::Flags flags,

ThreadId thread_id,

std::unique_ptr<InspectorParentHandle> inspector_parent_handle,

std::string_view thread_name);

NODE_EXTERN std::unique_ptr<InspectorParentHandle> GetInspectorParentHandle(

Environment* parent_env,

ThreadId child_thread_id,

const char* child_url);

NODE_EXTERN std::unique_ptr<InspectorParentHandle> GetInspectorParentHandle(

Environment* parent_env,

ThreadId child_thread_id,

const char* child_url,

const char* name);

NODE_EXTERN std::unique_ptr<InspectorParentHandle> GetInspectorParentHandle(

Environment* parent_env,

ThreadId child_thread_id,

std::string_view child_url,

std::string_view name);

struct StartExecutionCallbackInfo {

};

enum class ModuleFormat : uint8_t {

};

class NODE_EXTERN StartExecutionCallbackInfoWithModule {

public:

StartExecutionCallbackInfoWithModule();

~StartExecutionCallbackInfoWithModule();

StartExecutionCallbackInfoWithModule(

const StartExecutionCallbackInfoWithModule&) = delete;

StartExecutionCallbackInfoWithModule& operator=(

const StartExecutionCallbackInfoWithModule&) = delete;

StartExecutionCallbackInfoWithModule(StartExecutionCallbackInfoWithModule&&);

StartExecutionCallbackInfoWithModule& operator=(

StartExecutionCallbackInfoWithModule&&);

Environment* env() const;

v8::Local<v8::Object> process_object() const;

v8::Local<v8::Function> native_require() const;

v8::Local<v8::Function> run_module() const;

void set_env(Environment* env);

void set_process_object(v8::Local<v8::Object> process_object);

void set_native_require(v8::Local<v8::Function> native_require);

void set_run_module(v8::Local<v8::Function> run_module);

private:

struct Impl;

std::unique_ptr<Impl> impl_;

};

using StartExecutionCallback =

std::function<v8::MaybeLocal<v8::Value>(const StartExecutionCallbackInfo&)>;

using StartExecutionCallbackWithModule =

std::function<v8::MaybeLocal<v8::Value>(

const StartExecutionCallbackInfoWithModule&)>;

using EmbedderPreloadCallback =

std::function<void(Environment* env,

v8::Local<v8::Value> process,

v8::Local<v8::Value> require)>;

NODE_EXTERN v8::MaybeLocal<v8::Value> LoadEnvironment(

Environment* env,

StartExecutionCallback cb,

EmbedderPreloadCallback preload = nullptr);

NODE_EXTERN v8::MaybeLocal<v8::Value> LoadEnvironment(

Environment* env,

StartExecutionCallbackWithModule cb,

EmbedderPreloadCallback preload = nullptr);

NODE_EXTERN v8::MaybeLocal<v8::Value> LoadEnvironment(

Environment* env,

std::string_view main_script_source_utf8,

EmbedderPreloadCallback preload = nullptr);

class NODE_EXTERN ModuleData {

public:

ModuleData();

~ModuleData();

ModuleData(const ModuleData&) = delete;

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

ModuleData(ModuleData&&);

ModuleData& operator=(ModuleData&&);

void set_source(std::string_view source);

void set_format(ModuleFormat format);

void set_resource_name(std::string_view name);

std::string_view source() const;

ModuleFormat format() const;

std::string_view resource_name() const;

private:

struct Impl;

std::unique_ptr<Impl> impl_;

};

NODE_EXTERN v8::MaybeLocal<v8::Value> LoadEnvironment(

Environment* env,

const ModuleData* entry_point,

EmbedderPreloadCallback preload = nullptr);

NODE_EXTERN void FreeEnvironment(Environment* env);

NODE_EXTERN void SetProcessExitHandler(

Environment* env,

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

NODE_EXTERN void DefaultProcessExitHandler(Environment* env, int exit_code);

NODE_EXTERN Environment* GetCurrentEnvironment(v8::Local<v8::Context> context);

NODE_EXTERN IsolateData* GetEnvironmentIsolateData(Environment* env);

NODE_EXTERN ArrayBufferAllocator* GetArrayBufferAllocator(IsolateData* data);

NODE_EXTERN v8::Local<v8::Context> GetMainContext(Environment* env);

[[noreturn]] NODE_EXTERN void OnFatalError(const char* location,

const char* message);

NODE_EXTERN void PromiseRejectCallback(v8::PromiseRejectMessage message);

NODE_EXTERN bool AllowWasmCodeGenerationCallback(v8::Local<v8::Context> context,

v8::Local<v8::String>);

NODE_EXTERN bool ShouldAbortOnUncaughtException(v8::Isolate* isolate);

NODE_EXTERN v8::MaybeLocal<v8::Value> PrepareStackTraceCallback(

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

v8::Local<v8::Value> exception,

v8::Local<v8::Array> trace);

NODE_EXTERN std::string TriggerNodeReport(v8::Isolate* isolate,

std::string_view message,

std::string_view trigger,

std::string_view filename,

v8::Local<v8::Value> error);

NODE_EXTERN std::string TriggerNodeReport(Environment* env,

std::string_view message,

std::string_view trigger,

std::string_view filename,

v8::Local<v8::Value> error);

NODE_EXTERN void GetNodeReport(v8::Isolate* isolate,

std::string_view message,

std::string_view trigger,

v8::Local<v8::Value> error,

std::ostream& out);

NODE_EXTERN void GetNodeReport(Environment* env,

std::string_view message,

std::string_view trigger,

v8::Local<v8::Value> error,

std::ostream& out);

NODE_EXTERN MultiIsolatePlatform* GetMultiIsolatePlatform(Environment* env);

NODE_EXTERN MultiIsolatePlatform* GetMultiIsolatePlatform(IsolateData* env);

NODE_EXTERN v8::TracingController* GetTracingController();

NODE_EXTERN void SetTracingController(v8::TracingController* controller);

NODE_EXTERN v8::Maybe<bool> EmitProcessBeforeExit(Environment* env);

NODE_EXTERN v8::Maybe<int> EmitProcessExit(Environment* env);

NODE_EXTERN void RunAtExit(Environment* env);

NODE_EXTERN struct uv_loop_s* GetCurrentEventLoop(v8::Isolate* isolate);

NODE_EXTERN v8::Maybe<int> SpinEventLoop(Environment* env);

NODE_EXTERN std::string GetAnonymousMainPath();

class NODE_EXTERN CommonEnvironmentSetup {

public:

~CommonEnvironmentSetup();

// Create a new CommonEnvironmentSetup, that is, a group of objects that

// together form the typical setup for a single Node.js Environment instance.

// If any error occurs, `*errors` will be populated and the returned pointer

// will be empty.

// env_args will be passed through as arguments to CreateEnvironment(), after

// `isolate_data` and `context`.

template <typename... EnvironmentArgs>

static std::unique_ptr<CommonEnvironmentSetup> Create(

MultiIsolatePlatform* platform,

std::vector<std::string>* errors,

EnvironmentArgs&&... env_args);

template <typename... EnvironmentArgs>

static std::unique_ptr<CommonEnvironmentSetup> CreateFromSnapshot(

MultiIsolatePlatform* platform,

std::vector<std::string>* errors,

const EmbedderSnapshotData* snapshot_data,

EnvironmentArgs&&... env_args);

// Create an embedding setup which will be used for creating a snapshot

// using CreateSnapshot().

//

// This will create and attach a v8::SnapshotCreator to this instance,

// and the same restrictions apply to this instance that also apply to

// other V8 snapshotting environments.

// Not all Node.js APIs are supported in this case. Currently, there is

// no support for native/host objects other than Node.js builtins

// in the snapshot.

//

// If the embedder wants to use LoadEnvironment() later to run a snapshot

// builder script they should make sure args[1] contains the path of the

// snapshot script, which will be used to create __filename and __dirname

// in the context where the builder script is run. If they do not want to

// include the build-time paths into the snapshot, use the string returned

// by GetAnonymousMainPath() as args[1] to anonymize the script.

//

// Snapshots are an *experimental* feature. In particular, the embedder API

// exposed through this class is subject to change or removal between Node.js

// versions, including possible API and ABI breakage.

static std::unique_ptr<CommonEnvironmentSetup> CreateForSnapshotting(

MultiIsolatePlatform* platform,

std::vector<std::string>* errors,

const std::vector<std::string>& args = {},

const std::vector<std::string>& exec_args = {},

const SnapshotConfig& snapshot_config = {});

EmbedderSnapshotData::Pointer CreateSnapshot();

struct uv_loop_s* event_loop() const;

v8::SnapshotCreator* snapshot_creator();

// Empty for snapshotting environments.

std::shared_ptr<ArrayBufferAllocator> array_buffer_allocator() const;

v8::Isolate* isolate() const;

IsolateData* isolate_data() const;

Environment* env() const;

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

CommonEnvironmentSetup(const CommonEnvironmentSetup&) = delete;

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