@encharm/cws 4.4.1 → 4.5.2

package/src/headers/24/traced_value.h

@@ -0,0 +1,129 @@
+// Copyright 2016 the V8 project authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+#ifndef SRC_TRACING_TRACED_VALUE_H_
+#define SRC_TRACING_TRACED_VALUE_H_
+
+#include "v8-platform.h"
+
+#include <cstdint>
+#include <span>
+#include <string>
+
+namespace node {
+namespace tracing {
+
+template <typename T>
+std::unique_ptr<v8::ConvertableToTraceFormat> CastTracedValue(const T& value) {
+  return value.Cast();
+}
+
+class EnvironmentArgs {
+ public:
+  EnvironmentArgs(std::span<const std::string> args,
+                  std::span<const std::string> exec_args)
+      : args_(args), exec_args_(exec_args) {}
+
+  std::unique_ptr<v8::ConvertableToTraceFormat> Cast() const;
+
+ private:
+  std::span<const std::string> args_;
+  std::span<const std::string> exec_args_;
+};
+
+class AsyncWrapArgs {
+ public:
+  AsyncWrapArgs(int64_t execution_async_id, int64_t trigger_async_id)
+      : execution_async_id_(execution_async_id),
+        trigger_async_id_(trigger_async_id) {}
+
+  std::unique_ptr<v8::ConvertableToTraceFormat> Cast() const;
+
+ private:
+  int64_t execution_async_id_;
+  int64_t trigger_async_id_;
+};
+
+class ProcessMeta {
+ public:
+  std::unique_ptr<v8::ConvertableToTraceFormat> Cast() const;
+};
+
+// Do not use this class directly. Define a custom structured class to provide
+// a conversion method so that the class can be used with both V8 legacy
+// trace API and perfetto API.
+//
+// These classes provide a JSON-inspired way to write structed data into traces.
+//
+// To define how a custom class should be written into the trace, users should
+// define one of the two following functions:
+// - Foo::Cast(TracedValue) const
+//   (preferred for code which depends on perfetto directly)
+//
+// After defining a conversion method, the object can be used as a
+// TRACE_EVENT argument:
+//
+// Foo foo;
+// TRACE_EVENT("cat", "Event", "arg", CastTracedValue(foo));
+//
+// class Foo {
+//   std::unique_ptr<v8::ConvertableToTraceFormat> Cast() const {
+//     auto traced_value = tracing::TracedValue::Create();
+//     dict->SetInteger("key", 42);
+//     dict->SetString("foo", "bar");
+//     return traced_value;
+//   }
+// }
+class TracedValue : public v8::ConvertableToTraceFormat {
+ public:
+  ~TracedValue() override = default;
+
+  static std::unique_ptr<TracedValue> Create();
+  static std::unique_ptr<TracedValue> CreateArray();
+
+  void EndDictionary();
+  void EndArray();
+
+  // These methods assume that |name| is a long lived "quoted" string.
+  void SetInteger(const char* name, int value);
+  void SetDouble(const char* name, double value);
+  void SetBoolean(const char* name, bool value);
+  void SetNull(const char* name);
+  void SetString(const char* name, const char* value);
+  void SetString(const char* name, const std::string& value) {
+    SetString(name, value.c_str());
+  }
+  void BeginDictionary(const char* name);
+  void BeginArray(const char* name);
+
+  void AppendInteger(int);
+  void AppendDouble(double);
+  void AppendBoolean(bool);
+  void AppendNull();
+  void AppendString(const char*);
+  void AppendString(const std::string& value) { AppendString(value.c_str()); }
+  void BeginArray();
+  void BeginDictionary();
+
+  // ConvertableToTraceFormat implementation.
+  void AppendAsTraceFormat(std::string* out) const override;
+
+  TracedValue(const TracedValue&) = delete;
+  TracedValue& operator=(const TracedValue&) = delete;
+
+ private:
+  explicit TracedValue(bool root_is_array = false);
+
+  void WriteComma();
+  void WriteName(const char* name);
+
+  std::string data_;
+  bool first_item_;
+  bool root_is_array_;
+};
+
+}  // namespace tracing
+}  // namespace node
+
+#endif  // SRC_TRACING_TRACED_VALUE_H_

package/src/headers/24/tracing_agent.h

@@ -0,0 +1,43 @@
+#ifndef SRC_INSPECTOR_TRACING_AGENT_H_
+#define SRC_INSPECTOR_TRACING_AGENT_H_
+
+#include "node/inspector/protocol/NodeTracing.h"
+#include "tracing/agent.h"
+#include "v8.h"
+
+
+namespace node {
+class Environment;
+
+namespace inspector {
+class MainThreadHandle;
+
+namespace protocol {
+
+class TracingAgent : public NodeTracing::Backend {
+ public:
+  explicit TracingAgent(Environment*, std::shared_ptr<MainThreadHandle>);
+  ~TracingAgent() override;
+
+  void Wire(UberDispatcher* dispatcher);
+
+  DispatchResponse start(
+      std::unique_ptr<protocol::NodeTracing::TraceConfig> traceConfig) override;
+  DispatchResponse stop() override;
+  DispatchResponse getCategories(
+      std::unique_ptr<protocol::Array<String>>* categories) override;
+
+ private:
+  Environment* env_;
+  std::shared_ptr<MainThreadHandle> main_thread_;
+  tracing::AgentWriterHandle trace_writer_;
+  int frontend_object_id_ = 0;
+  std::shared_ptr<NodeTracing::Frontend> frontend_;
+};
+
+
+}  // namespace protocol
+}  // namespace inspector
+}  // namespace node
+
+#endif  // SRC_INSPECTOR_TRACING_AGENT_H_

package/src/headers/24/transportparams.h

@@ -0,0 +1,166 @@
+#pragma once
+
+#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
+#if HAVE_OPENSSL && NODE_OPENSSL_HAS_QUIC
+
+#include <env.h>
+#include <memory_tracker.h>
+#include <ngtcp2/ngtcp2.h>
+#include <node_sockaddr.h>
+#include <optional>
+#include "bindingdata.h"
+#include "cid.h"
+#include "data.h"
+#include "tokens.h"
+
+namespace node::quic {
+
+class Endpoint;
+class Session;
+
+// The Transport Params are the set of configuration options that are sent to
+// the remote peer. They communicate the protocol options the other peer
+// should use when communicating with this session.
+class TransportParams final {
+ public:
+  static void Initialize(Environment* env, v8::Local<v8::Object> target);
+
+  static constexpr int QUIC_TRANSPORT_PARAMS_V1 = NGTCP2_TRANSPORT_PARAMS_V1;
+  static constexpr int QUIC_TRANSPORT_PARAMS_VERSION =
+      NGTCP2_TRANSPORT_PARAMS_VERSION;
+  static constexpr uint64_t DEFAULT_MAX_STREAM_DATA = 256 * 1024;
+  static constexpr uint64_t DEFAULT_MAX_DATA = 1 * 1024 * 1024;
+  static constexpr uint64_t DEFAULT_MAX_IDLE_TIMEOUT = 10;  // seconds
+  static constexpr uint64_t DEFAULT_MAX_STREAMS_BIDI = 100;
+  static constexpr uint64_t DEFAULT_MAX_STREAMS_UNI = 3;
+  static constexpr uint64_t DEFAULT_ACTIVE_CONNECTION_ID_LIMIT = 2;
+
+  struct Config {
+    Side side;
+    const CID& ocid;
+    const CID& retry_scid;
+    Config(Side side,
+           const CID& ocid = CID::kInvalid,
+           const CID& retry_scid = CID::kInvalid);
+  };
+
+  struct Options : public MemoryRetainer {
+    int transportParamsVersion = QUIC_TRANSPORT_PARAMS_V1;
+
+    // Set only on server Sessions, the preferred address communicates the IP
+    // address and port that the server would prefer the client to use when
+    // communicating with it. See the QUIC specification for more detail on how
+    // the preferred address mechanism works.
+    std::optional<SocketAddress> preferred_address_ipv4{};
+    std::optional<SocketAddress> preferred_address_ipv6{};
+
+    // The initial size of the flow control window of locally initiated streams.
+    // This is the maximum number of bytes that the *remote* endpoint can send
+    // when the connection is started.
+    uint64_t initial_max_stream_data_bidi_local = DEFAULT_MAX_STREAM_DATA;
+
+    // The initial size of the flow control window of remotely initiated
+    // streams. This is the maximum number of bytes that the remote endpoint can
+    // send when the connection is started.
+    uint64_t initial_max_stream_data_bidi_remote = DEFAULT_MAX_STREAM_DATA;
+
+    // The initial size of the flow control window of remotely initiated
+    // unidirectional streams. This is the maximum number of bytes that the
+    // remote endpoint can send when the connection is started.
+    uint64_t initial_max_stream_data_uni = DEFAULT_MAX_STREAM_DATA;
+
+    // The initial size of the session-level flow control window.
+    uint64_t initial_max_data = DEFAULT_MAX_DATA;
+
+    // The initial maximum number of concurrent bidirectional streams the remote
+    // endpoint is permitted to open.
+    uint64_t initial_max_streams_bidi = DEFAULT_MAX_STREAMS_BIDI;
+
+    // The initial maximum number of concurrent unidirectional streams the
+    // remote endpoint is permitted to open.
+    uint64_t initial_max_streams_uni = DEFAULT_MAX_STREAMS_UNI;
+
+    // The maximum amount of time that a Session is permitted to remain idle
+    // before it is silently closed and state is discarded.
+    uint64_t max_idle_timeout = DEFAULT_MAX_IDLE_TIMEOUT;
+
+    // The maximum number of Connection IDs that the peer can store. A single
+    // Session may have several connection IDs over it's lifetime.
+    uint64_t active_connection_id_limit = DEFAULT_ACTIVE_CONNECTION_ID_LIMIT;
+
+    // Establishes the exponent used in ACK Delay field in the ACK frame. See
+    // the QUIC specification for details. This is an advanced option that
+    // should rarely be modified and only if there is really good reason.
+    uint64_t ack_delay_exponent = NGTCP2_DEFAULT_ACK_DELAY_EXPONENT;
+
+    // The maximum amount of time by which the endpoint will delay sending
+    // acknowledgements. This is an advanced option that should rarely be
+    // modified and only if there is a really good reason. It is used to
+    // determine how long a Session will wait to determine that a packet has
+    // been lost.
+    uint64_t max_ack_delay = NGTCP2_DEFAULT_MAX_ACK_DELAY;
+
+    // The maximum size of DATAGRAM frames that the endpoint will accept.
+    // Setting the value to 0 will disable DATAGRAM support.
+    uint64_t max_datagram_frame_size = kDefaultMaxPacketLength;
+
+    // When true, communicates that the Session does not support active
+    // connection migration. See the QUIC specification for more details on
+    // connection migration.
+    // TODO(@jasnell): We currently do not implementation active migration.
+    bool disable_active_migration = true;
+
+    static const Options kDefault;
+
+    void MemoryInfo(MemoryTracker* tracker) const override;
+    SET_MEMORY_INFO_NAME(TransportParams::Options)
+    SET_SELF_SIZE(Options)
+
+    static v8::Maybe<Options> From(Environment* env,
+                                   v8::Local<v8::Value> value);
+
+    std::string ToString() const;
+  };
+
+  explicit TransportParams();
+
+  // Creates an instance of TransportParams wrapping the existing const
+  // ngtcp2_transport_params pointer.
+  TransportParams(const ngtcp2_transport_params* ptr);
+
+  TransportParams(const Config& config, const Options& options);
+
+  // Creates an instance of TransportParams by decoding the given buffer.
+  // If the parameters cannot be successfully decoded, the error()
+  // property will be set with an appropriate QuicError and the bool()
+  // operator will return false.
+  TransportParams(const ngtcp2_vec& buf,
+                  int version = QUIC_TRANSPORT_PARAMS_V1);
+
+  void GenerateSessionTokens(Session* session);
+  void GenerateStatelessResetToken(const Endpoint& endpoint, const CID& cid);
+  void GeneratePreferredAddressToken(Session* session);
+  void SetPreferredAddress(const SocketAddress& address);
+
+  operator const ngtcp2_transport_params&() const;
+  operator const ngtcp2_transport_params*() const;
+
+  operator bool() const;
+
+  const QuicError& error() const;
+
+  // Returns an ArrayBuffer containing the encoded transport parameters.
+  // If an error occurs during encoding, an empty shared_ptr will be returned
+  // and the error() property will be set to an appropriate QuicError.
+  Store Encode(Environment* env, int version = QUIC_TRANSPORT_PARAMS_V1) const;
+
+ private:
+  ngtcp2_transport_params params_{};
+  const ngtcp2_transport_params* ptr_;
+  QuicError error_ = QuicError::TRANSPORT_NO_ERROR;
+};
+
+}  // namespace node::quic
+
+#endif  // HAVE_OPENSSL && NODE_OPENSSL_HAS_QUIC
+#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS

package/src/headers/{16 → 24}/tty_wrap.h

@@ -48,7 +48,6 @@ class TTYWrap : public LibuvStreamWrap {
   TTYWrap(Environment* env,
           v8::Local<v8::Object> object,
           int fd,
-          bool readable,
           int* init_err);
 
   static void IsTTY(const v8::FunctionCallbackInfo<v8::Value>& args);

package/src/headers/{18 → 24}/udp_wrap.h

@@ -32,6 +32,7 @@
 
 namespace node {
 
+class ExternalReferenceRegistry;
 class UDPWrapBase;
 
 // A listener that can be attached to an `UDPWrapBase` object and generally
@@ -110,6 +111,7 @@ class UDPWrapBase {
   static void RecvStart(const v8::FunctionCallbackInfo<v8::Value>& args);
   static void RecvStop(const v8::FunctionCallbackInfo<v8::Value>& args);
   static void AddMethods(Environment* env, v8::Local<v8::FunctionTemplate> t);
+  static void RegisterExternalReferences(ExternalReferenceRegistry* registry);
 
  private:
   UDPListener* listener_ = nullptr;
@@ -126,6 +128,7 @@ class UDPWrap final : public HandleWrap,
                          v8::Local<v8::Value> unused,
                          v8::Local<v8::Context> context,
                          void* priv);
+  static void RegisterExternalReferences(ExternalReferenceRegistry* registry);
   static void GetFD(const v8::FunctionCallbackInfo<v8::Value>& args);
   static void New(const v8::FunctionCallbackInfo<v8::Value>& args);
   static void Open(const v8::FunctionCallbackInfo<v8::Value>& args);
@@ -144,12 +147,10 @@ class UDPWrap final : public HandleWrap,
       const v8::FunctionCallbackInfo<v8::Value>& args);
   static void SetMulticastInterface(
       const v8::FunctionCallbackInfo<v8::Value>& args);
-  static void SetMulticastTTL(const v8::FunctionCallbackInfo<v8::Value>& args);
-  static void SetMulticastLoopback(
-      const v8::FunctionCallbackInfo<v8::Value>& args);
-  static void SetBroadcast(const v8::FunctionCallbackInfo<v8::Value>& args);
-  static void SetTTL(const v8::FunctionCallbackInfo<v8::Value>& args);
   static void BufferSize(const v8::FunctionCallbackInfo<v8::Value>& args);
+  static void GetSendQueueSize(const v8::FunctionCallbackInfo<v8::Value>& args);
+  static void GetSendQueueCount(
+      const v8::FunctionCallbackInfo<v8::Value>& args);
 
   // UDPListener implementation
   uv_buf_t OnAlloc(size_t suggested_size) override;
@@ -172,6 +173,8 @@ class UDPWrap final : public HandleWrap,
 
   AsyncWrap* GetAsyncWrap() override;
 
+  inline uv_udp_t* GetLibuvHandle() { return &handle_; }
+
   static v8::MaybeLocal<v8::Object> Instantiate(Environment* env,
                                                 AsyncWrap* parent,
                                                 SocketType type);

package/src/headers/24/undici_version.h

@@ -0,0 +1,6 @@
+// This is an auto generated file, please do not edit.
+// Refer to tools/dep_updaters/update-undici.sh
+#ifndef SRC_UNDICI_VERSION_H_
+#define SRC_UNDICI_VERSION_H_
+#define UNDICI_VERSION "7.14.0"
+#endif  // SRC_UNDICI_VERSION_H_