@encharm/cws 4.5.1 → 4.5.3

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/24/tty_wrap.h

@@ -0,0 +1,65 @@
+// 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_TTY_WRAP_H_
+#define SRC_TTY_WRAP_H_
+
+#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
+
+#include "uv.h"
+#include "stream_wrap.h"
+
+namespace node {
+
+class Environment;
+class ExternalReferenceRegistry;
+
+class TTYWrap : public LibuvStreamWrap {
+ public:
+  static void Initialize(v8::Local<v8::Object> target,
+                         v8::Local<v8::Value> unused,
+                         v8::Local<v8::Context> context,
+                         void* priv);
+  static void RegisterExternalReferences(ExternalReferenceRegistry* registry);
+
+  SET_NO_MEMORY_INFO()
+  SET_MEMORY_INFO_NAME(TTYWrap)
+  SET_SELF_SIZE(TTYWrap)
+
+ private:
+  TTYWrap(Environment* env,
+          v8::Local<v8::Object> object,
+          int fd,
+          int* init_err);
+
+  static void IsTTY(const v8::FunctionCallbackInfo<v8::Value>& args);
+  static void GetWindowSize(const v8::FunctionCallbackInfo<v8::Value>& args);
+  static void SetRawMode(const v8::FunctionCallbackInfo<v8::Value>& args);
+  static void New(const v8::FunctionCallbackInfo<v8::Value>& args);
+
+  uv_tty_t handle_;
+};
+
+}  // namespace node
+
+#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
+
+#endif  // SRC_TTY_WRAP_H_

package/src/headers/24/udp_wrap.h

@@ -0,0 +1,230 @@
+// 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_UDP_WRAP_H_
+#define SRC_UDP_WRAP_H_
+
+#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
+
+#include "handle_wrap.h"
+#include "req_wrap.h"
+#include "node_sockaddr.h"
+#include "uv.h"
+#include "v8.h"
+
+namespace node {
+
+class ExternalReferenceRegistry;
+class UDPWrapBase;
+
+// A listener that can be attached to an `UDPWrapBase` object and generally
+// manages its I/O activity. This is similar to `StreamListener`.
+class UDPListener {
+ public:
+  virtual ~UDPListener();
+
+  // Called right before data is received from the socket. Must return a
+  // buffer suitable for reading data into, that is then passed to OnRecv.
+  virtual uv_buf_t OnAlloc(size_t suggested_size) = 0;
+
+  // Called right after data is received from the socket, and includes
+  // information about the source address. If `nread` is negative, an error
+  // has occurred, and it represents a libuv error code.
+  virtual void OnRecv(ssize_t nread,
+                      const uv_buf_t& buf,
+                      const sockaddr* addr,
+                      unsigned int flags) = 0;
+
+  // Called when an asynchronous request for writing data is created.
+  // The `msg_size` value contains the total size of the data to be sent,
+  // but may be ignored by the implementation of this Method.
+  // The return value is later passed to OnSendDone.
+  virtual ReqWrap<uv_udp_send_t>* CreateSendWrap(size_t msg_size) = 0;
+
+  // Called when an asynchronous request for writing data has finished.
+  // If status is negative, an error has occurred, and it represents a libuv
+  // error code.
+  virtual void OnSendDone(ReqWrap<uv_udp_send_t>* wrap, int status) = 0;
+
+  // Optional callback that is called after the socket has been bound.
+  virtual void OnAfterBind() {}
+
+  inline UDPWrapBase* udp() const { return wrap_; }
+
+ protected:
+  UDPWrapBase* wrap_ = nullptr;
+
+  friend class UDPWrapBase;
+};
+
+class UDPWrapBase {
+ public:
+  // While UDPWrapBase itself does not extend from HandleWrap, classes
+  // derived from it will (like UDPWrap)
+  enum InternalFields {
+    kUDPWrapBaseField = HandleWrap::kInternalFieldCount,
+    kInternalFieldCount
+  };
+  virtual ~UDPWrapBase();
+
+  // Start emitting OnAlloc() + OnRecv() events on the listener.
+  virtual int RecvStart() = 0;
+
+  // Stop emitting OnAlloc() + OnRecv() events on the listener.
+  virtual int RecvStop() = 0;
+
+  // Send a chunk of data over this socket. This may call CreateSendWrap()
+  // on the listener if an async transmission is necessary.
+  virtual ssize_t Send(uv_buf_t* bufs,
+                       size_t nbufs,
+                       const sockaddr* addr) = 0;
+
+  virtual SocketAddress GetPeerName() = 0;
+  virtual SocketAddress GetSockName() = 0;
+
+  // Returns an AsyncWrap object with the same lifetime as this object.
+  virtual AsyncWrap* GetAsyncWrap() = 0;
+
+  void set_listener(UDPListener* listener);
+  UDPListener* listener() const;
+
+  static UDPWrapBase* FromObject(v8::Local<v8::Object> obj);
+
+  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;
+};
+
+class UDPWrap final : public HandleWrap,
+                      public UDPWrapBase,
+                      public UDPListener {
+ public:
+  enum SocketType {
+    SOCKET
+  };
+  static void Initialize(v8::Local<v8::Object> target,
+                         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);
+  static void Bind(const v8::FunctionCallbackInfo<v8::Value>& args);
+  static void Connect(const v8::FunctionCallbackInfo<v8::Value>& args);
+  static void Send(const v8::FunctionCallbackInfo<v8::Value>& args);
+  static void Bind6(const v8::FunctionCallbackInfo<v8::Value>& args);
+  static void Connect6(const v8::FunctionCallbackInfo<v8::Value>& args);
+  static void Send6(const v8::FunctionCallbackInfo<v8::Value>& args);
+  static void Disconnect(const v8::FunctionCallbackInfo<v8::Value>& args);
+  static void AddMembership(const v8::FunctionCallbackInfo<v8::Value>& args);
+  static void DropMembership(const v8::FunctionCallbackInfo<v8::Value>& args);
+  static void AddSourceSpecificMembership(
+      const v8::FunctionCallbackInfo<v8::Value>& args);
+  static void DropSourceSpecificMembership(
+      const v8::FunctionCallbackInfo<v8::Value>& args);
+  static void SetMulticastInterface(
+      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;
+  void OnRecv(ssize_t nread,
+              const uv_buf_t& buf,
+              const sockaddr* addr,
+              unsigned int flags) override;
+  ReqWrap<uv_udp_send_t>* CreateSendWrap(size_t msg_size) override;
+  void OnSendDone(ReqWrap<uv_udp_send_t>* wrap, int status) override;
+
+  // UDPWrapBase implementation
+  int RecvStart() override;
+  int RecvStop() override;
+  ssize_t Send(uv_buf_t* bufs,
+               size_t nbufs,
+               const sockaddr* addr) override;
+
+  SocketAddress GetPeerName() override;
+  SocketAddress GetSockName() override;
+
+  AsyncWrap* GetAsyncWrap() override;
+
+  inline uv_udp_t* GetLibuvHandle() { return &handle_; }
+
+  static v8::MaybeLocal<v8::Object> Instantiate(Environment* env,
+                                                AsyncWrap* parent,
+                                                SocketType type);
+  SET_NO_MEMORY_INFO()
+  SET_MEMORY_INFO_NAME(UDPWrap)
+  SET_SELF_SIZE(UDPWrap)
+
+ private:
+  typedef uv_udp_t HandleType;
+
+  template <typename T,
+            int (*F)(const typename T::HandleType*, sockaddr*, int*)>
+  friend void GetSockOrPeerName(const v8::FunctionCallbackInfo<v8::Value>&);
+
+  UDPWrap(Environment* env, v8::Local<v8::Object> object);
+
+  static void DoBind(const v8::FunctionCallbackInfo<v8::Value>& args,
+                     int family);
+  static void DoConnect(const v8::FunctionCallbackInfo<v8::Value>& args,
+                     int family);
+  static void DoSend(const v8::FunctionCallbackInfo<v8::Value>& args,
+                     int family);
+  static void SetMembership(const v8::FunctionCallbackInfo<v8::Value>& args,
+                            uv_membership membership);
+  static void SetSourceMembership(
+      const v8::FunctionCallbackInfo<v8::Value>& args,
+      uv_membership membership);
+
+  static void OnAlloc(uv_handle_t* handle,
+                      size_t suggested_size,
+                      uv_buf_t* buf);
+  static void OnRecv(uv_udp_t* handle,
+                     ssize_t nread,
+                     const uv_buf_t* buf,
+                     const struct sockaddr* addr,
+                     unsigned int flags);
+
+  uv_udp_t handle_;
+
+  bool current_send_has_callback_;
+  v8::Local<v8::Object> current_send_req_wrap_;
+};
+
+int sockaddr_for_family(int address_family,
+                        const char* address,
+                        const unsigned short port,
+                        sockaddr_storage* addr);
+
+}  // namespace node
+
+#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
+
+#endif  // SRC_UDP_WRAP_H_

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_