@encharm/cws 4.4.1 → 4.5.2

package/src/headers/14/node_messaging.h

@@ -1,303 +0,0 @@
-#ifndef SRC_NODE_MESSAGING_H_
-#define SRC_NODE_MESSAGING_H_
-
-#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
-
-#include "env.h"
-#include "node_mutex.h"
-#include <list>
-
-namespace node {
-namespace worker {
-
-class MessagePortData;
-class MessagePort;
-
-typedef MaybeStackBuffer<v8::Local<v8::Value>, 8> TransferList;
-
-// Used to represent the in-flight structure of an object that is being
-// transfered or cloned using postMessage().
-class TransferData : public MemoryRetainer {
- public:
-  // Deserialize this object on the receiving end after a .postMessage() call.
-  // - `context` may not be the same as `env->context()`. This method should
-  //    not produce JS objects coming from Contexts other than `context`.
-  // - `self` is a unique_ptr for the object that this is being called on.
-  // - The return value is treated like a `Maybe`, i.e. if `nullptr` is
-  //   returned, any further deserialization of the message is stopped and
-  //   control is returned to the event loop or JS as soon as possible.
-  virtual BaseObjectPtr<BaseObject> Deserialize(
-      Environment* env,
-      v8::Local<v8::Context> context,
-      std::unique_ptr<TransferData> self) = 0;
-  // FinalizeTransferWrite() is the counterpart to
-  // BaseObject::FinalizeTransferRead(). It is called right after the transfer
-  // data was created, and defaults to doing nothing. After this function,
-  // this object should not hold any more Isolate-specific data.
-  virtual v8::Maybe<bool> FinalizeTransferWrite(
-      v8::Local<v8::Context> context, v8::ValueSerializer* serializer);
-};
-
-// Represents a single communication message.
-class Message : public MemoryRetainer {
- public:
-  // Create a Message with a specific underlying payload, in the format of the
-  // V8 ValueSerializer API. If `payload` is empty, this message indicates
-  // that the receiving message port should close itself.
-  explicit Message(MallocedBuffer<char>&& payload = MallocedBuffer<char>());
-
-  Message(Message&& other) = default;
-  Message& operator=(Message&& other) = default;
-  Message& operator=(const Message&) = delete;
-  Message(const Message&) = delete;
-
-  // Whether this is a message indicating that the port is to be closed.
-  // This is the last message to be received by a MessagePort.
-  bool IsCloseMessage() const;
-
-  // Deserialize the contained JS value. May only be called once, and only
-  // after Serialize() has been called (e.g. by another thread).
-  v8::MaybeLocal<v8::Value> Deserialize(Environment* env,
-                                        v8::Local<v8::Context> context);
-
-  // Serialize a JS value, and optionally transfer objects, into this message.
-  // The Message object retains ownership of all transferred objects until
-  // deserialization.
-  // The source_port parameter, if provided, will make Serialize() throw a
-  // "DataCloneError" DOMException if source_port is found in transfer_list.
-  v8::Maybe<bool> Serialize(Environment* env,
-                            v8::Local<v8::Context> context,
-                            v8::Local<v8::Value> input,
-                            const TransferList& transfer_list,
-                            v8::Local<v8::Object> source_port =
-                                v8::Local<v8::Object>());
-
-  // Internal method of Message that is called when a new SharedArrayBuffer
-  // object is encountered in the incoming value's structure.
-  void AddSharedArrayBuffer(std::shared_ptr<v8::BackingStore> backing_store);
-  // Internal method of Message that is called once serialization finishes
-  // and that transfers ownership of `data` to this message.
-  void AddTransferable(std::unique_ptr<TransferData>&& data);
-  // Internal method of Message that is called when a new WebAssembly.Module
-  // object is encountered in the incoming value's structure.
-  uint32_t AddWASMModule(v8::CompiledWasmModule&& mod);
-
-  // The host objects that will be transferred, as recorded by Serialize()
-  // (e.g. MessagePorts).
-  // Used for warning user about posting the target MessagePort to itself,
-  // which will as a side effect destroy the communication channel.
-  const std::vector<std::unique_ptr<TransferData>>& transferables() const {
-    return transferables_;
-  }
-
-  void MemoryInfo(MemoryTracker* tracker) const override;
-
-  SET_MEMORY_INFO_NAME(Message)
-  SET_SELF_SIZE(Message)
-
- private:
-  MallocedBuffer<char> main_message_buf_;
-  std::vector<std::shared_ptr<v8::BackingStore>> array_buffers_;
-  std::vector<std::shared_ptr<v8::BackingStore>> shared_array_buffers_;
-  std::vector<std::unique_ptr<TransferData>> transferables_;
-  std::vector<v8::CompiledWasmModule> wasm_modules_;
-
-  friend class MessagePort;
-};
-
-// This contains all data for a `MessagePort` instance that is not tied to
-// a specific Environment/Isolate/event loop, for easier transfer between those.
-class MessagePortData : public TransferData {
- public:
-  explicit MessagePortData(MessagePort* owner);
-  ~MessagePortData() override;
-
-  MessagePortData(MessagePortData&& other) = delete;
-  MessagePortData& operator=(MessagePortData&& other) = delete;
-  MessagePortData(const MessagePortData& other) = delete;
-  MessagePortData& operator=(const MessagePortData& other) = delete;
-
-  // Add a message to the incoming queue and notify the receiver.
-  // This may be called from any thread.
-  void AddToIncomingQueue(Message&& message);
-
-  // Turns `a` and `b` into siblings, i.e. connects the sending side of one
-  // to the receiving side of the other. This is not thread-safe.
-  static void Entangle(MessagePortData* a, MessagePortData* b);
-
-  // Removes any possible sibling. This is thread-safe (it acquires both
-  // `sibling_mutex_` and `mutex_`), and has to be because it is called once
-  // the corresponding JS handle handle wants to close
-  // which can happen on either side of a worker.
-  void Disentangle();
-
-  void MemoryInfo(MemoryTracker* tracker) const override;
-  BaseObjectPtr<BaseObject> Deserialize(
-      Environment* env,
-      v8::Local<v8::Context> context,
-      std::unique_ptr<TransferData> self) override;
-
-  SET_MEMORY_INFO_NAME(MessagePortData)
-  SET_SELF_SIZE(MessagePortData)
-
- private:
-  // This mutex protects all fields below it, with the exception of
-  // sibling_.
-  mutable Mutex mutex_;
-  std::list<Message> incoming_messages_;
-  MessagePort* owner_ = nullptr;
-  // This mutex protects the sibling_ field and is shared between two entangled
-  // MessagePorts. If both mutexes are acquired, this one needs to be
-  // acquired first.
-  std::shared_ptr<Mutex> sibling_mutex_ = std::make_shared<Mutex>();
-  MessagePortData* sibling_ = nullptr;
-
-  friend class MessagePort;
-};
-
-// A message port that receives messages from other threads, including
-// the uv_async_t handle that is used to notify the current event loop of
-// new incoming messages.
-class MessagePort : public HandleWrap {
- private:
-  // Create a new MessagePort. The `context` argument specifies the Context
-  // instance that is used for creating the values emitted from this port.
-  // This is called by MessagePort::New(), which is the public API used for
-  // creating MessagePort instances.
-  MessagePort(Environment* env,
-              v8::Local<v8::Context> context,
-              v8::Local<v8::Object> wrap);
-
- public:
-  ~MessagePort() override;
-
-  // Create a new message port instance, optionally over an existing
-  // `MessagePortData` object.
-  static MessagePort* New(Environment* env,
-                          v8::Local<v8::Context> context,
-                          std::unique_ptr<MessagePortData> data = nullptr);
-
-  // Send a message, i.e. deliver it into the sibling's incoming queue.
-  // If this port is closed, or if there is no sibling, this message is
-  // serialized with transfers, then silently discarded.
-  v8::Maybe<bool> PostMessage(Environment* env,
-                              v8::Local<v8::Value> message,
-                              const TransferList& transfer);
-
-  // Start processing messages on this port as a receiving end.
-  void Start();
-  // Stop processing messages on this port as a receiving end.
-  void Stop();
-
-  /* constructor */
-  static void New(const v8::FunctionCallbackInfo<v8::Value>& args);
-  /* prototype methods */
-  static void PostMessage(const v8::FunctionCallbackInfo<v8::Value>& args);
-  static void Start(const v8::FunctionCallbackInfo<v8::Value>& args);
-  static void Stop(const v8::FunctionCallbackInfo<v8::Value>& args);
-  static void Drain(const v8::FunctionCallbackInfo<v8::Value>& args);
-  static void ReceiveMessage(const v8::FunctionCallbackInfo<v8::Value>& args);
-
-  /* static */
-  static void MoveToContext(const v8::FunctionCallbackInfo<v8::Value>& args);
-
-  // Turns `a` and `b` into siblings, i.e. connects the sending side of one
-  // to the receiving side of the other. This is not thread-safe.
-  static void Entangle(MessagePort* a, MessagePort* b);
-  static void Entangle(MessagePort* a, MessagePortData* b);
-
-  // Detach this port's data for transferring. After this, the MessagePortData
-  // is no longer associated with this handle, although it can still receive
-  // messages.
-  std::unique_ptr<MessagePortData> Detach();
-
-  void Close(
-      v8::Local<v8::Value> close_callback = v8::Local<v8::Value>()) override;
-
-  // Returns true if either data_ has been freed, or if the handle is being
-  // closed. Equivalent to the [[Detached]] internal slot in the HTML Standard.
-  //
-  // If checking if a JavaScript MessagePort object is detached, this method
-  // alone is often not enough, since the backing C++ MessagePort object may
-  // have been deleted already. For all intents and purposes, an object with a
-  // NULL pointer to the C++ MessagePort object is also detached.
-  inline bool IsDetached() const;
-
-  TransferMode GetTransferMode() const override;
-  std::unique_ptr<TransferData> TransferForMessaging() override;
-
-  void MemoryInfo(MemoryTracker* tracker) const override;
-  SET_MEMORY_INFO_NAME(MessagePort)
-  SET_SELF_SIZE(MessagePort)
-
- private:
-  void OnClose() override;
-  void OnMessage();
-  void TriggerAsync();
-  v8::MaybeLocal<v8::Value> ReceiveMessage(v8::Local<v8::Context> context,
-                                           bool only_if_receiving);
-
-  std::unique_ptr<MessagePortData> data_ = nullptr;
-  bool receiving_messages_ = false;
-  uv_async_t async_;
-  v8::Global<v8::Function> emit_message_fn_;
-
-  friend class MessagePortData;
-};
-
-// Provide a base class from which JS classes that should be transferable or
-// cloneable by postMesssage() can inherit.
-// See e.g. FileHandle in internal/fs/promises.js for an example.
-class JSTransferable : public BaseObject {
- public:
-  JSTransferable(Environment* env, v8::Local<v8::Object> obj);
-  static void New(const v8::FunctionCallbackInfo<v8::Value>& args);
-
-  TransferMode GetTransferMode() const override;
-  std::unique_ptr<TransferData> TransferForMessaging() override;
-  std::unique_ptr<TransferData> CloneForMessaging() const override;
-  v8::Maybe<std::vector<BaseObjectPtr<BaseObject>>>
-      NestedTransferables() const override;
-  v8::Maybe<bool> FinalizeTransferRead(
-      v8::Local<v8::Context> context,
-      v8::ValueDeserializer* deserializer) override;
-
-  SET_NO_MEMORY_INFO()
-  SET_MEMORY_INFO_NAME(JSTransferable)
-  SET_SELF_SIZE(JSTransferable)
-
- private:
-  std::unique_ptr<TransferData> TransferOrClone(TransferMode mode) const;
-
-  class Data : public TransferData {
-   public:
-    Data(std::string&& deserialize_info, v8::Global<v8::Value>&& data);
-
-    BaseObjectPtr<BaseObject> Deserialize(
-        Environment* env,
-        v8::Local<v8::Context> context,
-        std::unique_ptr<TransferData> self) override;
-    v8::Maybe<bool> FinalizeTransferWrite(
-        v8::Local<v8::Context> context,
-        v8::ValueSerializer* serializer) override;
-
-    SET_NO_MEMORY_INFO()
-    SET_MEMORY_INFO_NAME(JSTransferableTransferData)
-    SET_SELF_SIZE(Data)
-
-   private:
-    std::string deserialize_info_;
-    v8::Global<v8::Value> data_;
-  };
-};
-
-v8::Local<v8::FunctionTemplate> GetMessagePortConstructorTemplate(
-    Environment* env);
-
-}  // namespace worker
-}  // namespace node
-
-#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
-
-
-#endif  // SRC_NODE_MESSAGING_H_

package/src/headers/14/node_metadata.h

@@ -1,109 +0,0 @@
-#ifndef SRC_NODE_METADATA_H_
-#define SRC_NODE_METADATA_H_
-
-#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
-
-#include <string>
-#include "node_version.h"
-
-namespace node {
-
-// if this is a release build and no explicit base has been set
-// substitute the standard release download URL
-#ifndef NODE_RELEASE_URLBASE
-#if NODE_VERSION_IS_RELEASE
-#define NODE_RELEASE_URLBASE "https://nodejs.org/download/release/"
-#endif  // NODE_VERSION_IS_RELEASE
-#endif  // NODE_RELEASE_URLBASE
-
-#if defined(NODE_RELEASE_URLBASE)
-#define NODE_HAS_RELEASE_URLS
-#endif
-
-#define NODE_VERSIONS_KEYS_BASE(V)                                             \
-  V(node)                                                                      \
-  V(v8)                                                                        \
-  V(uv)                                                                        \
-  V(zlib)                                                                      \
-  V(brotli)                                                                    \
-  V(ares)                                                                      \
-  V(modules)                                                                   \
-  V(nghttp2)                                                                   \
-  V(napi)                                                                      \
-  V(llhttp)                                                                    \
-
-#if HAVE_OPENSSL
-#define NODE_VERSIONS_KEY_CRYPTO(V) V(openssl)
-#else
-#define NODE_VERSIONS_KEY_CRYPTO(V)
-#endif
-
-#ifdef NODE_HAVE_I18N_SUPPORT
-#define NODE_VERSIONS_KEY_INTL(V)                                              \
-  V(cldr)                                                                      \
-  V(icu)                                                                       \
-  V(tz)                                                                        \
-  V(unicode)
-#else
-#define NODE_VERSIONS_KEY_INTL(V)
-#endif  // NODE_HAVE_I18N_SUPPORT
-
-#define NODE_VERSIONS_KEYS(V)                                                  \
-  NODE_VERSIONS_KEYS_BASE(V)                                                   \
-  NODE_VERSIONS_KEY_CRYPTO(V)                                                  \
-  NODE_VERSIONS_KEY_INTL(V)
-
-class Metadata {
- public:
-  Metadata();
-  Metadata(Metadata&) = delete;
-  Metadata(Metadata&&) = delete;
-  Metadata operator=(Metadata&) = delete;
-  Metadata operator=(Metadata&&) = delete;
-
-  struct Versions {
-    Versions();
-
-#ifdef NODE_HAVE_I18N_SUPPORT
-    // Must be called on the main thread after
-    // i18n::InitializeICUDirectory()
-    void InitializeIntlVersions();
-#endif  // NODE_HAVE_I18N_SUPPORT
-
-#define V(key) std::string key;
-    NODE_VERSIONS_KEYS(V)
-#undef V
-  };
-
-  struct Release {
-    Release();
-
-    std::string name;
-#if NODE_VERSION_IS_LTS
-    std::string lts;
-#endif  // NODE_VERSION_IS_LTS
-
-#ifdef NODE_HAS_RELEASE_URLS
-    std::string source_url;
-    std::string headers_url;
-#ifdef _WIN32
-    std::string lib_url;
-#endif  // _WIN32
-#endif  // NODE_HAS_RELEASE_URLS
-  };
-
-  Versions versions;
-  const Release release;
-  const std::string arch;
-  const std::string platform;
-};
-
-// Per-process global
-namespace per_process {
-extern Metadata metadata;
-}
-
-}  // namespace node
-
-#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
-#endif  // SRC_NODE_METADATA_H_

package/src/headers/14/node_mutex.h

@@ -1,247 +0,0 @@
-#ifndef SRC_NODE_MUTEX_H_
-#define SRC_NODE_MUTEX_H_
-
-#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
-
-#include "util.h"
-#include "uv.h"
-
-#include <memory>  // std::shared_ptr<T>
-#include <utility>  // std::forward<T>
-
-namespace node {
-
-template <typename Traits> class ConditionVariableBase;
-template <typename Traits> class MutexBase;
-struct LibuvMutexTraits;
-
-using ConditionVariable = ConditionVariableBase<LibuvMutexTraits>;
-using Mutex = MutexBase<LibuvMutexTraits>;
-
-template <typename T, typename MutexT = Mutex>
-class ExclusiveAccess {
- public:
-  ExclusiveAccess() = default;
-
-  template <typename... Args>
-  explicit ExclusiveAccess(Args&&... args)
-      : item_(std::forward<Args>(args)...) {}
-
-  ExclusiveAccess(const ExclusiveAccess&) = delete;
-  ExclusiveAccess& operator=(const ExclusiveAccess&) = delete;
-
-  class Scoped {
-   public:
-    // ExclusiveAccess will commonly be used in conjuction with std::shared_ptr
-    // and without this constructor it's too easy to forget to keep a reference
-    // around to the shared_ptr while operating on the ExclusiveAccess object.
-    explicit Scoped(const std::shared_ptr<ExclusiveAccess>& shared)
-        : shared_(shared)
-        , scoped_lock_(shared->mutex_)
-        , pointer_(&shared->item_) {}
-
-    explicit Scoped(ExclusiveAccess* exclusive_access)
-        : shared_()
-        , scoped_lock_(exclusive_access->mutex_)
-        , pointer_(&exclusive_access->item_) {}
-
-    T& operator*() const { return *pointer_; }
-    T* operator->() const { return pointer_; }
-
-    Scoped(const Scoped&) = delete;
-    Scoped& operator=(const Scoped&) = delete;
-
-   private:
-    std::shared_ptr<ExclusiveAccess> shared_;
-    typename MutexT::ScopedLock scoped_lock_;
-    T* const pointer_;
-  };
-
- private:
-  friend class ScopedLock;
-  MutexT mutex_;
-  T item_;
-};
-
-template <typename Traits>
-class MutexBase {
- public:
-  inline MutexBase();
-  inline ~MutexBase();
-  inline void Lock();
-  inline void Unlock();
-
-  MutexBase(const MutexBase&) = delete;
-  MutexBase& operator=(const MutexBase&) = delete;
-
-  class ScopedLock;
-  class ScopedUnlock;
-
-  class ScopedLock {
-   public:
-    inline explicit ScopedLock(const MutexBase& mutex);
-    inline explicit ScopedLock(const ScopedUnlock& scoped_unlock);
-    inline ~ScopedLock();
-
-    ScopedLock(const ScopedLock&) = delete;
-    ScopedLock& operator=(const ScopedLock&) = delete;
-
-   private:
-    template <typename> friend class ConditionVariableBase;
-    friend class ScopedUnlock;
-    const MutexBase& mutex_;
-  };
-
-  class ScopedUnlock {
-   public:
-    inline explicit ScopedUnlock(const ScopedLock& scoped_lock);
-    inline ~ScopedUnlock();
-
-    ScopedUnlock(const ScopedUnlock&) = delete;
-    ScopedUnlock& operator=(const ScopedUnlock&) = delete;
-
-   private:
-    friend class ScopedLock;
-    const MutexBase& mutex_;
-  };
-
- private:
-  template <typename> friend class ConditionVariableBase;
-  mutable typename Traits::MutexT mutex_;
-};
-
-template <typename Traits>
-class ConditionVariableBase {
- public:
-  using ScopedLock = typename MutexBase<Traits>::ScopedLock;
-
-  inline ConditionVariableBase();
-  inline ~ConditionVariableBase();
-  inline void Broadcast(const ScopedLock&);
-  inline void Signal(const ScopedLock&);
-  inline void Wait(const ScopedLock& scoped_lock);
-
-  ConditionVariableBase(const ConditionVariableBase&) = delete;
-  ConditionVariableBase& operator=(const ConditionVariableBase&) = delete;
-
- private:
-  typename Traits::CondT cond_;
-};
-
-struct LibuvMutexTraits {
-  using CondT = uv_cond_t;
-  using MutexT = uv_mutex_t;
-
-  static inline int cond_init(CondT* cond) {
-    return uv_cond_init(cond);
-  }
-
-  static inline int mutex_init(MutexT* mutex) {
-    return uv_mutex_init(mutex);
-  }
-
-  static inline void cond_broadcast(CondT* cond) {
-    uv_cond_broadcast(cond);
-  }
-
-  static inline void cond_destroy(CondT* cond) {
-    uv_cond_destroy(cond);
-  }
-
-  static inline void cond_signal(CondT* cond) {
-    uv_cond_signal(cond);
-  }
-
-  static inline void cond_wait(CondT* cond, MutexT* mutex) {
-    uv_cond_wait(cond, mutex);
-  }
-
-  static inline void mutex_destroy(MutexT* mutex) {
-    uv_mutex_destroy(mutex);
-  }
-
-  static inline void mutex_lock(MutexT* mutex) {
-    uv_mutex_lock(mutex);
-  }
-
-  static inline void mutex_unlock(MutexT* mutex) {
-    uv_mutex_unlock(mutex);
-  }
-};
-
-template <typename Traits>
-ConditionVariableBase<Traits>::ConditionVariableBase() {
-  CHECK_EQ(0, Traits::cond_init(&cond_));
-}
-
-template <typename Traits>
-ConditionVariableBase<Traits>::~ConditionVariableBase() {
-  Traits::cond_destroy(&cond_);
-}
-
-template <typename Traits>
-void ConditionVariableBase<Traits>::Broadcast(const ScopedLock&) {
-  Traits::cond_broadcast(&cond_);
-}
-
-template <typename Traits>
-void ConditionVariableBase<Traits>::Signal(const ScopedLock&) {
-  Traits::cond_signal(&cond_);
-}
-
-template <typename Traits>
-void ConditionVariableBase<Traits>::Wait(const ScopedLock& scoped_lock) {
-  Traits::cond_wait(&cond_, &scoped_lock.mutex_.mutex_);
-}
-
-template <typename Traits>
-MutexBase<Traits>::MutexBase() {
-  CHECK_EQ(0, Traits::mutex_init(&mutex_));
-}
-
-template <typename Traits>
-MutexBase<Traits>::~MutexBase() {
-  Traits::mutex_destroy(&mutex_);
-}
-
-template <typename Traits>
-void MutexBase<Traits>::Lock() {
-  Traits::mutex_lock(&mutex_);
-}
-
-template <typename Traits>
-void MutexBase<Traits>::Unlock() {
-  Traits::mutex_unlock(&mutex_);
-}
-
-template <typename Traits>
-MutexBase<Traits>::ScopedLock::ScopedLock(const MutexBase& mutex)
-    : mutex_(mutex) {
-  Traits::mutex_lock(&mutex_.mutex_);
-}
-
-template <typename Traits>
-MutexBase<Traits>::ScopedLock::ScopedLock(const ScopedUnlock& scoped_unlock)
-    : MutexBase(scoped_unlock.mutex_) {}
-
-template <typename Traits>
-MutexBase<Traits>::ScopedLock::~ScopedLock() {
-  Traits::mutex_unlock(&mutex_.mutex_);
-}
-
-template <typename Traits>
-MutexBase<Traits>::ScopedUnlock::ScopedUnlock(const ScopedLock& scoped_lock)
-    : mutex_(scoped_lock.mutex_) {
-  Traits::mutex_unlock(&mutex_.mutex_);
-}
-
-template <typename Traits>
-MutexBase<Traits>::ScopedUnlock::~ScopedUnlock() {
-  Traits::mutex_lock(&mutex_.mutex_);
-}
-
-}  // namespace node
-
-#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
-
-#endif  // SRC_NODE_MUTEX_H_