@encharm/cws 4.4.1 → 4.5.1

package/src/headers/14/handle_wrap.h

@@ -1,117 +0,0 @@
-// 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_HANDLE_WRAP_H_
-#define SRC_HANDLE_WRAP_H_
-
-#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
-
-#include "async_wrap.h"
-#include "util.h"
-#include "uv.h"
-#include "v8.h"
-
-namespace node {
-
-class Environment;
-
-// Rules:
-//
-// - Do not throw from handle methods. Set errno.
-//
-// - MakeCallback may only be made directly off the event loop.
-//   That is there can be no JavaScript stack frames underneath it.
-//   (Is there any way to assert that?)
-//
-// - No use of v8::WeakReferenceCallback. The close callback signifies that
-//   we're done with a handle - external resources can be freed.
-//
-// - Reusable?
-//
-// - The uv_close_cb is used to free the c++ object. The close callback
-//   is not made into javascript land.
-//
-// - uv_ref, uv_unref counts are managed at this layer to avoid needless
-//   js/c++ boundary crossing. At the javascript layer that should all be
-//   taken care of.
-
-class HandleWrap : public AsyncWrap {
- public:
-  static void Close(const v8::FunctionCallbackInfo<v8::Value>& args);
-  static void Ref(const v8::FunctionCallbackInfo<v8::Value>& args);
-  static void Unref(const v8::FunctionCallbackInfo<v8::Value>& args);
-  static void HasRef(const v8::FunctionCallbackInfo<v8::Value>& args);
-
-  static inline bool IsAlive(const HandleWrap* wrap) {
-    return wrap != nullptr &&
-        wrap->IsDoneInitializing() &&
-        wrap->state_ != kClosed;
-  }
-
-  static inline bool HasRef(const HandleWrap* wrap) {
-    return IsAlive(wrap) && uv_has_ref(wrap->GetHandle());
-  }
-
-  inline uv_handle_t* GetHandle() const { return handle_; }
-
-  virtual void Close(
-      v8::Local<v8::Value> close_callback = v8::Local<v8::Value>());
-
-  static v8::Local<v8::FunctionTemplate> GetConstructorTemplate(
-      Environment* env);
-
- protected:
-  HandleWrap(Environment* env,
-             v8::Local<v8::Object> object,
-             uv_handle_t* handle,
-             AsyncWrap::ProviderType provider);
-  virtual void OnClose() {}
-  void OnGCCollect() final;
-
-  void MarkAsInitialized();
-  void MarkAsUninitialized();
-
-  inline bool IsHandleClosing() const {
-    return state_ == kClosing || state_ == kClosed;
-  }
-
- private:
-  friend class Environment;
-  friend void GetActiveHandles(const v8::FunctionCallbackInfo<v8::Value>&);
-  static void OnClose(uv_handle_t* handle);
-
-  // handle_wrap_queue_ needs to be at a fixed offset from the start of the
-  // class because it is used by src/node_postmortem_metadata.cc to calculate
-  // offsets and generate debug symbols for HandleWrap, which assumes that the
-  // position of members in memory are predictable. For more information please
-  // refer to `doc/guides/node-postmortem-support.md`
-  friend int GenDebugSymbols();
-  ListNode<HandleWrap> handle_wrap_queue_;
-  enum { kInitialized, kClosing, kClosed } state_;
-  uv_handle_t* const handle_;
-};
-
-
-}  // namespace node
-
-#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
-
-#endif  // SRC_HANDLE_WRAP_H_

package/src/headers/14/histogram-inl.h

@@ -1,83 +0,0 @@
-#ifndef SRC_HISTOGRAM_INL_H_
-#define SRC_HISTOGRAM_INL_H_
-
-#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
-
-#include "histogram.h"
-#include "base_object-inl.h"
-#include "node_internals.h"
-
-namespace node {
-
-void Histogram::Reset() {
-  hdr_reset(histogram_.get());
-}
-
-bool Histogram::Record(int64_t value) {
-  return hdr_record_value(histogram_.get(), value);
-}
-
-int64_t Histogram::Min() {
-  return hdr_min(histogram_.get());
-}
-
-int64_t Histogram::Max() {
-  return hdr_max(histogram_.get());
-}
-
-double Histogram::Mean() {
-  return hdr_mean(histogram_.get());
-}
-
-double Histogram::Stddev() {
-  return hdr_stddev(histogram_.get());
-}
-
-double Histogram::Percentile(double percentile) {
-  CHECK_GT(percentile, 0);
-  CHECK_LE(percentile, 100);
-  return static_cast<double>(
-      hdr_value_at_percentile(histogram_.get(), percentile));
-}
-
-template <typename Iterator>
-void Histogram::Percentiles(Iterator&& fn) {
-  hdr_iter iter;
-  hdr_iter_percentile_init(&iter, histogram_.get(), 1);
-  while (hdr_iter_next(&iter)) {
-    double key = iter.specifics.percentiles.percentile;
-    double value = static_cast<double>(iter.value);
-    fn(key, value);
-  }
-}
-
-bool HistogramBase::RecordDelta() {
-  uint64_t time = uv_hrtime();
-  bool ret = true;
-  if (prev_ > 0) {
-    int64_t delta = time - prev_;
-    if (delta > 0) {
-      ret = Record(delta);
-      TraceDelta(delta);
-      if (!ret) {
-        if (exceeds_ < 0xFFFFFFFF)
-          exceeds_++;
-        TraceExceeds(delta);
-      }
-    }
-  }
-  prev_ = time;
-  return ret;
-}
-
-void HistogramBase::ResetState() {
-  Reset();
-  exceeds_ = 0;
-  prev_ = 0;
-}
-
-}  // namespace node
-
-#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
-
-#endif  // SRC_HISTOGRAM_INL_H_

package/src/headers/14/histogram.h

@@ -1,98 +0,0 @@
-#ifndef SRC_HISTOGRAM_H_
-#define SRC_HISTOGRAM_H_
-
-#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
-
-#include "hdr_histogram.h"
-#include "base_object.h"
-#include "util.h"
-
-#include <functional>
-#include <limits>
-#include <map>
-
-namespace node {
-
-constexpr int kDefaultHistogramFigures = 3;
-
-class Histogram {
- public:
-  Histogram(
-      int64_t lowest = std::numeric_limits<int64_t>::min(),
-      int64_t highest = std::numeric_limits<int64_t>::max(),
-      int figures = kDefaultHistogramFigures);
-  virtual ~Histogram() = default;
-
-  inline bool Record(int64_t value);
-  inline void Reset();
-  inline int64_t Min();
-  inline int64_t Max();
-  inline double Mean();
-  inline double Stddev();
-  inline double Percentile(double percentile);
-
-  // Iterator is a function type that takes two doubles as argument, one for
-  // percentile and one for the value at that percentile.
-  template <typename Iterator>
-  inline void Percentiles(Iterator&& fn);
-
-  size_t GetMemorySize() const {
-    return hdr_get_memory_size(histogram_.get());
-  }
-
- private:
-  using HistogramPointer = DeleteFnPtr<hdr_histogram, hdr_close>;
-  HistogramPointer histogram_;
-};
-
-class HistogramBase : public BaseObject, public Histogram {
- public:
-  virtual ~HistogramBase() = default;
-
-  virtual void TraceDelta(int64_t delta) {}
-  virtual void TraceExceeds(int64_t delta) {}
-
-  inline bool RecordDelta();
-  inline void ResetState();
-
-  int64_t Exceeds() const { return exceeds_; }
-
-  void MemoryInfo(MemoryTracker* tracker) const override;
-  SET_MEMORY_INFO_NAME(HistogramBase)
-  SET_SELF_SIZE(HistogramBase)
-
-  static void GetMin(const v8::FunctionCallbackInfo<v8::Value>& args);
-  static void GetMax(const v8::FunctionCallbackInfo<v8::Value>& args);
-  static void GetMean(const v8::FunctionCallbackInfo<v8::Value>& args);
-  static void GetExceeds(const v8::FunctionCallbackInfo<v8::Value>& args);
-  static void GetStddev(const v8::FunctionCallbackInfo<v8::Value>& args);
-  static void GetPercentile(
-      const v8::FunctionCallbackInfo<v8::Value>& args);
-  static void GetPercentiles(
-      const v8::FunctionCallbackInfo<v8::Value>& args);
-  static void DoReset(const v8::FunctionCallbackInfo<v8::Value>& args);
-  static void Initialize(Environment* env);
-
-  static BaseObjectPtr<HistogramBase> New(
-      Environment* env,
-      int64_t lowest = std::numeric_limits<int64_t>::min(),
-      int64_t highest = std::numeric_limits<int64_t>::max(),
-      int figures = kDefaultHistogramFigures);
-
-  HistogramBase(
-      Environment* env,
-      v8::Local<v8::Object> wrap,
-      int64_t lowest = std::numeric_limits<int64_t>::min(),
-      int64_t highest = std::numeric_limits<int64_t>::max(),
-      int figures = kDefaultHistogramFigures);
-
- private:
-  int64_t exceeds_ = 0;
-  uint64_t prev_ = 0;
-};
-
-}  // namespace node
-
-#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
-
-#endif  // SRC_HISTOGRAM_H_

package/src/headers/14/inspector_agent.h

@@ -1,149 +0,0 @@
-#pragma once
-
-#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
-
-#if !HAVE_INSPECTOR
-#error("This header can only be used when inspector is enabled")
-#endif
-
-#include "node_options.h"
-#include "v8.h"
-
-#include <cstddef>
-#include <memory>
-
-namespace v8_inspector {
-class StringView;
-}  // namespace v8_inspector
-
-namespace node {
-// Forward declaration to break recursive dependency chain with src/env.h.
-class Environment;
-struct ContextInfo;
-
-namespace inspector {
-class InspectorIo;
-class ParentInspectorHandle;
-class NodeInspectorClient;
-class WorkerManager;
-
-class InspectorSession {
- public:
-  virtual ~InspectorSession() = default;
-  virtual void Dispatch(const v8_inspector::StringView& message) = 0;
-};
-
-class InspectorSessionDelegate {
- public:
-  virtual ~InspectorSessionDelegate() = default;
-  virtual void SendMessageToFrontend(const v8_inspector::StringView& message)
-                                     = 0;
-};
-
-class Agent {
- public:
-  explicit Agent(node::Environment* env);
-  ~Agent();
-
-  // Create client_, may create io_ if option enabled
-  bool Start(const std::string& path,
-             const DebugOptions& options,
-             std::shared_ptr<ExclusiveAccess<HostPort>> host_port,
-             bool is_main);
-  // Stop and destroy io_
-  void Stop();
-
-  bool IsListening() { return io_ != nullptr; }
-  // Returns true if the Node inspector is actually in use. It will be true
-  // if either the user explicitly opted into inspector (e.g. with the
-  // --inspect command line flag) or if inspector JS API had been used.
-  bool IsActive();
-
-  // Option is set to wait for session connection
-  bool WillWaitForConnect();
-  // Blocks till frontend connects and sends "runIfWaitingForDebugger"
-  void WaitForConnect();
-  // Blocks till all the sessions with "WaitForDisconnectOnShutdown" disconnect
-  void WaitForDisconnect();
-  void ReportUncaughtException(v8::Local<v8::Value> error,
-                               v8::Local<v8::Message> message);
-
-  // Async stack traces instrumentation.
-  void AsyncTaskScheduled(const v8_inspector::StringView& taskName, void* task,
-                          bool recurring);
-  void AsyncTaskCanceled(void* task);
-  void AsyncTaskStarted(void* task);
-  void AsyncTaskFinished(void* task);
-  void AllAsyncTasksCanceled();
-
-  void RegisterAsyncHook(v8::Isolate* isolate,
-    v8::Local<v8::Function> enable_function,
-    v8::Local<v8::Function> disable_function);
-  void EnableAsyncHook();
-  void DisableAsyncHook();
-
-  void SetParentHandle(std::unique_ptr<ParentInspectorHandle> parent_handle);
-  std::unique_ptr<ParentInspectorHandle> GetParentHandle(
-      int thread_id, const std::string& url);
-
-  // Called to create inspector sessions that can be used from the same thread.
-  // The inspector responds by using the delegate to send messages back.
-  std::unique_ptr<InspectorSession> Connect(
-      std::unique_ptr<InspectorSessionDelegate> delegate,
-      bool prevent_shutdown);
-
-  // Called from the worker to create inspector sessions that is connected
-  // to the main thread.
-  // The inspector responds by using the delegate to send messages back.
-  std::unique_ptr<InspectorSession> ConnectToMainThread(
-      std::unique_ptr<InspectorSessionDelegate> delegate,
-      bool prevent_shutdown);
-
-  void PauseOnNextJavascriptStatement(const std::string& reason);
-
-  std::string GetWsUrl() const;
-
-  // Can only be called from the main thread.
-  bool StartIoThread();
-
-  // Calls StartIoThread() from off the main thread.
-  void RequestIoThreadStart();
-
-  const DebugOptions& options() { return debug_options_; }
-  std::shared_ptr<ExclusiveAccess<HostPort>> host_port() { return host_port_; }
-  void ContextCreated(v8::Local<v8::Context> context, const ContextInfo& info);
-
-  // Interface for interacting with inspectors in worker threads
-  std::shared_ptr<WorkerManager> GetWorkerManager();
-
-  inline Environment* env() const { return parent_env_; }
-
- private:
-  void ToggleAsyncHook(v8::Isolate* isolate,
-                       const v8::Global<v8::Function>& fn);
-
-  node::Environment* parent_env_;
-  // Encapsulates majority of the Inspector functionality
-  std::shared_ptr<NodeInspectorClient> client_;
-  // Interface for transports, e.g. WebSocket server
-  std::unique_ptr<InspectorIo> io_;
-  std::unique_ptr<ParentInspectorHandle> parent_handle_;
-  std::string path_;
-
-  // This is a copy of the debug options parsed from CLI in the Environment.
-  // Do not use the host_port in that, instead manipulate the shared host_port_
-  // pointer which is meant to store the actual host and port of the inspector
-  // server.
-  DebugOptions debug_options_;
-  std::shared_ptr<ExclusiveAccess<HostPort>> host_port_;
-
-  bool pending_enable_async_hook_ = false;
-  bool pending_disable_async_hook_ = false;
-  v8::Global<v8::Function> enable_async_hook_function_;
-  v8::Global<v8::Function> disable_async_hook_function_;
-};
-
-}  // namespace inspector
-}  // namespace node
-
-#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS

package/src/headers/14/inspector_profiler.h

@@ -1,137 +0,0 @@
-#ifndef SRC_INSPECTOR_PROFILER_H_
-#define SRC_INSPECTOR_PROFILER_H_
-
-#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
-
-#if !HAVE_INSPECTOR
-#error("This header can only be used when inspector is enabled")
-#endif
-
-#include "inspector_agent.h"
-
-namespace node {
-// Forward declaration to break recursive dependency chain with src/env.h.
-class Environment;
-
-namespace profiler {
-
-class V8ProfilerConnection {
- public:
-  class V8ProfilerSessionDelegate : public inspector::InspectorSessionDelegate {
-   public:
-    explicit V8ProfilerSessionDelegate(V8ProfilerConnection* connection)
-        : connection_(connection) {}
-
-    void SendMessageToFrontend(
-        const v8_inspector::StringView& message) override;
-
-   private:
-    V8ProfilerConnection* connection_;
-  };
-
-  explicit V8ProfilerConnection(Environment* env);
-  virtual ~V8ProfilerConnection() = default;
-
-  Environment* env() const { return env_; }
-
-  // Dispatch a protocol message, and returns the id of the message.
-  // `method` does not need to be surrounded by quotes.
-  // The optional `params` should be formatted in JSON.
-  // The strings should be in one byte characters - which is enough for
-  // the commands we use here.
-  size_t DispatchMessage(const char* method, const char* params = nullptr);
-
-  // Use DispatchMessage() to dispatch necessary inspector messages
-  // to start and end the profiling.
-  virtual void Start() = 0;
-  virtual void End() = 0;
-
-  // Return a descriptive name of the profile for debugging.
-  virtual const char* type() const = 0;
-  // Return if the profile is ending and the response can be parsed.
-  virtual bool ending() const = 0;
-  // Return the directory where the profile should be placed.
-  virtual std::string GetDirectory() const = 0;
-  // Return the filename the profile should be written as.
-  virtual std::string GetFilename() const = 0;
-  // Return the profile object parsed from `message.result`,
-  // which will be then written as a JSON.
-  virtual v8::MaybeLocal<v8::Object> GetProfile(
-      v8::Local<v8::Object> result) = 0;
-  virtual void WriteProfile(v8::Local<v8::String> message);
-
- private:
-  size_t next_id() { return id_++; }
-  std::unique_ptr<inspector::InspectorSession> session_;
-  size_t id_ = 1;
-
- protected:
-  Environment* env_ = nullptr;
-};
-
-class V8CoverageConnection : public V8ProfilerConnection {
- public:
-  explicit V8CoverageConnection(Environment* env) : V8ProfilerConnection(env) {}
-
-  void Start() override;
-  void End() override;
-
-  const char* type() const override { return "coverage"; }
-  bool ending() const override { return ending_; }
-
-  std::string GetDirectory() const override;
-  std::string GetFilename() const override;
-  v8::MaybeLocal<v8::Object> GetProfile(v8::Local<v8::Object> result) override;
-  void WriteProfile(v8::Local<v8::String> message) override;
-  void WriteSourceMapCache();
-
- private:
-  std::unique_ptr<inspector::InspectorSession> session_;
-  bool ending_ = false;
-};
-
-class V8CpuProfilerConnection : public V8ProfilerConnection {
- public:
-  explicit V8CpuProfilerConnection(Environment* env)
-      : V8ProfilerConnection(env) {}
-
-  void Start() override;
-  void End() override;
-
-  const char* type() const override { return "CPU"; }
-  bool ending() const override { return ending_; }
-
-  std::string GetDirectory() const override;
-  std::string GetFilename() const override;
-  v8::MaybeLocal<v8::Object> GetProfile(v8::Local<v8::Object> result) override;
-
- private:
-  std::unique_ptr<inspector::InspectorSession> session_;
-  bool ending_ = false;
-};
-
-class V8HeapProfilerConnection : public V8ProfilerConnection {
- public:
-  explicit V8HeapProfilerConnection(Environment* env)
-      : V8ProfilerConnection(env) {}
-
-  void Start() override;
-  void End() override;
-
-  const char* type() const override { return "heap"; }
-  bool ending() const override { return ending_; }
-
-  std::string GetDirectory() const override;
-  std::string GetFilename() const override;
-  v8::MaybeLocal<v8::Object> GetProfile(v8::Local<v8::Object> result) override;
-
- private:
-  std::unique_ptr<inspector::InspectorSession> session_;
-  bool ending_ = false;
-};
-
-}  // namespace profiler
-}  // namespace node
-
-#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
-#endif  // SRC_INSPECTOR_PROFILER_H_