@encharm/cws 4.1.0 → 4.2.0

package/src/headers/12/node_i18n.h

@@ -1,144 +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_NODE_I18N_H_
-#define SRC_NODE_I18N_H_
-
-#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
-
-#if defined(NODE_HAVE_I18N_SUPPORT)
-
-#include "base_object.h"
-#include "env.h"
-#include "util.h"
-#include "v8.h"
-
-#include <unicode/ucnv.h>
-
-#include <string>
-
-namespace node {
-
-namespace i18n {
-
-bool InitializeICUDirectory(const std::string& path);
-
-enum idna_mode {
-  // Default mode for maximum compatibility.
-  IDNA_DEFAULT,
-  // Ignore all errors in IDNA conversion, if possible.
-  IDNA_LENIENT,
-  // Enforce STD3 rules (UseSTD3ASCIIRules) and DNS length restrictions
-  // (VerifyDnsLength). Corresponds to `beStrict` flag in the "domain to ASCII"
-  // algorithm.
-  IDNA_STRICT
-};
-
-// Implements the WHATWG URL Standard "domain to ASCII" algorithm.
-// https://url.spec.whatwg.org/#concept-domain-to-ascii
-int32_t ToASCII(MaybeStackBuffer<char>* buf,
-                const char* input,
-                size_t length,
-                enum idna_mode mode = IDNA_DEFAULT);
-
-// Implements the WHATWG URL Standard "domain to Unicode" algorithm.
-// https://url.spec.whatwg.org/#concept-domain-to-unicode
-int32_t ToUnicode(MaybeStackBuffer<char>* buf,
-                  const char* input,
-                  size_t length);
-
-struct ConverterDeleter {
-  void operator()(UConverter* pointer) const { ucnv_close(pointer); }
-};
-using ConverterPointer = std::unique_ptr<UConverter, ConverterDeleter>;
-
-class Converter {
- public:
-  explicit Converter(const char* name, const char* sub = nullptr);
-  explicit Converter(UConverter* converter, const char* sub = nullptr);
-
-  UConverter* conv() const { return conv_.get(); }
-
-  size_t max_char_size() const;
-  size_t min_char_size() const;
-  void reset();
-  void set_subst_chars(const char* sub = nullptr);
-
- private:
-  ConverterPointer conv_;
-};
-
-class ConverterObject : public BaseObject, Converter {
- public:
-  enum ConverterFlags {
-    CONVERTER_FLAGS_FLUSH      = 0x1,
-    CONVERTER_FLAGS_FATAL      = 0x2,
-    CONVERTER_FLAGS_IGNORE_BOM = 0x4,
-    CONVERTER_FLAGS_UNICODE    = 0x8,
-    CONVERTER_FLAGS_BOM_SEEN   = 0x10,
-  };
-
-  static void Create(const v8::FunctionCallbackInfo<v8::Value>& args);
-  static void Decode(const v8::FunctionCallbackInfo<v8::Value>& args);
-  static void Has(const v8::FunctionCallbackInfo<v8::Value>& args);
-
-  SET_NO_MEMORY_INFO()
-  SET_MEMORY_INFO_NAME(ConverterObject)
-  SET_SELF_SIZE(ConverterObject)
-
- protected:
-  ConverterObject(Environment* env,
-                  v8::Local<v8::Object> wrap,
-                  UConverter* converter,
-                  int flags,
-                  const char* sub = nullptr);
-
-  void set_bom_seen(bool seen) {
-    if (seen)
-      flags_ |= CONVERTER_FLAGS_BOM_SEEN;
-    else
-      flags_ &= ~CONVERTER_FLAGS_BOM_SEEN;
-  }
-
-  bool bom_seen() const {
-    return (flags_ & CONVERTER_FLAGS_BOM_SEEN) == CONVERTER_FLAGS_BOM_SEEN;
-  }
-
-  bool unicode() const {
-    return (flags_ & CONVERTER_FLAGS_UNICODE) == CONVERTER_FLAGS_UNICODE;
-  }
-
-  bool ignore_bom() const {
-    return (flags_ & CONVERTER_FLAGS_IGNORE_BOM) == CONVERTER_FLAGS_IGNORE_BOM;
-  }
-
- private:
-  int flags_ = 0;
-};
-
-}  // namespace i18n
-}  // namespace node
-
-#endif  // NODE_HAVE_I18N_SUPPORT
-
-#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
-
-#endif  // SRC_NODE_I18N_H_

package/src/headers/12/node_main_instance.h

@@ -1,97 +0,0 @@
-#ifndef SRC_NODE_MAIN_INSTANCE_H_
-#define SRC_NODE_MAIN_INSTANCE_H_
-
-#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
-
-#include <cstddef>
-#include <memory>
-
-#include "node.h"
-#include "util.h"
-#include "uv.h"
-#include "v8.h"
-
-namespace node {
-
-// TODO(joyeecheung): align this with the Worker/WorkerThreadData class.
-// We may be able to create an abstract class to reuse some of the routines.
-class NodeMainInstance {
- public:
-  // To create a main instance that does not own the isolate,
-  // The caller needs to do:
-  //
-  //   Isolate* isolate = Isolate::Allocate();
-  //   platform->RegisterIsolate(isolate, loop);
-  //   isolate->Initialize(...);
-  //   isolate->Enter();
-  //   std::unique_ptr<NodeMainInstance> main_instance =
-  //       NodeMainInstance::Create(isolate, loop, args, exec_args);
-  //
-  // When tearing it down:
-  //
-  //   main_instance->Cleanup();  // While the isolate is entered
-  //   isolate->Exit();
-  //   isolate->Dispose();
-  //   platform->UnregisterIsolate(isolate);
-  //
-  // After calling Dispose() the main_instance is no longer accessible.
-  static std::unique_ptr<NodeMainInstance> Create(
-      v8::Isolate* isolate,
-      uv_loop_t* event_loop,
-      MultiIsolatePlatform* platform,
-      const std::vector<std::string>& args,
-      const std::vector<std::string>& exec_args);
-
-  void Dispose();
-
-  // Create a main instance that owns the isolate
-  NodeMainInstance(
-      v8::Isolate::CreateParams* params,
-      uv_loop_t* event_loop,
-      MultiIsolatePlatform* platform,
-      const std::vector<std::string>& args,
-      const std::vector<std::string>& exec_args,
-      const std::vector<size_t>* per_isolate_data_indexes = nullptr);
-  ~NodeMainInstance();
-
-  // Start running the Node.js instances, return the exit code when finished.
-  int Run();
-
-  IsolateData* isolate_data() { return isolate_data_.get(); }
-
-  // TODO(joyeecheung): align this with the CreateEnvironment exposed in node.h
-  // and the environment creation routine in workers somehow.
-  std::unique_ptr<Environment> CreateMainEnvironment(int* exit_code);
-
-  // If nullptr is returned, the binary is not built with embedded
-  // snapshot.
-  static const std::vector<size_t>* GetIsolateDataIndexes();
-  static v8::StartupData* GetEmbeddedSnapshotBlob();
-
-  static const size_t kNodeContextIndex = 0;
-  NodeMainInstance(const NodeMainInstance&) = delete;
-  NodeMainInstance& operator=(const NodeMainInstance&) = delete;
-  NodeMainInstance(NodeMainInstance&&) = delete;
-  NodeMainInstance& operator=(NodeMainInstance&&) = delete;
-
- private:
-  NodeMainInstance(v8::Isolate* isolate,
-                   uv_loop_t* event_loop,
-                   MultiIsolatePlatform* platform,
-                   const std::vector<std::string>& args,
-                   const std::vector<std::string>& exec_args);
-
-  std::vector<std::string> args_;
-  std::vector<std::string> exec_args_;
-  std::unique_ptr<ArrayBufferAllocator> array_buffer_allocator_;
-  v8::Isolate* isolate_;
-  MultiIsolatePlatform* platform_;
-  std::unique_ptr<IsolateData> isolate_data_;
-  bool owns_isolate_ = false;
-  bool deserialize_mode_ = false;
-};
-
-}  // namespace node
-
-#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
-#endif  // SRC_NODE_MAIN_INSTANCE_H_

package/src/headers/12/node_messaging.h

@@ -1,227 +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 "sharedarraybuffer_metadata.h"
-#include <list>
-
-namespace node {
-namespace worker {
-
-class MessagePortData;
-class MessagePort;
-
-typedef MaybeStackBuffer<v8::Local<v8::Value>, 8> TransferList;
-
-// 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(const SharedArrayBufferMetadataReference& ref);
-  // Internal method of Message that is called once serialization finishes
-  // and that transfers ownership of `data` to this message.
-  void AddMessagePort(std::unique_ptr<MessagePortData>&& 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::WasmModuleObject::TransferrableModule&& mod);
-
-  // The MessagePorts that will be transferred, as recorded by Serialize().
-  // 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<MessagePortData>>& message_ports() const {
-    return message_ports_;
-  }
-
-  void MemoryInfo(MemoryTracker* tracker) const override;
-
-  SET_MEMORY_INFO_NAME(Message)
-  SET_SELF_SIZE(Message)
-
- private:
-  MallocedBuffer<char> main_message_buf_;
-  std::vector<MallocedBuffer<char>> array_buffer_contents_;
-  std::vector<SharedArrayBufferMetadataReference> shared_array_buffers_;
-  std::vector<std::unique_ptr<MessagePortData>> message_ports_;
-  std::vector<v8::WasmModuleObject::TransferrableModule> 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 MemoryRetainer {
- 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;
-
-  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;
-
-  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;
-};
-
-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/12/node_native_module_env.h

@@ -1,65 +0,0 @@
-#ifndef SRC_NODE_NATIVE_MODULE_ENV_H_
-#define SRC_NODE_NATIVE_MODULE_ENV_H_
-
-#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
-
-#include "node_native_module.h"
-
-namespace node {
-class Environment;
-
-namespace native_module {
-
-extern const bool has_code_cache;
-
-class NativeModuleEnv {
- public:
-  static void Initialize(v8::Local<v8::Object> target,
-                         v8::Local<v8::Value> unused,
-                         v8::Local<v8::Context> context,
-                         void* priv);
-
-  static v8::MaybeLocal<v8::Function> LookupAndCompile(
-      v8::Local<v8::Context> context,
-      const char* id,
-      std::vector<v8::Local<v8::String>>* parameters,
-      Environment* optional_env);
-
-  static v8::Local<v8::Object> GetSourceObject(v8::Local<v8::Context> context);
-  // Returns config.gypi as a JSON string
-  static v8::Local<v8::String> GetConfigString(v8::Isolate* isolate);
-  static bool Exists(const char* id);
-
-  // Loads data into NativeModuleLoader::.instance.code_cache_
-  // Generated by mkcodecache as node_code_cache.cc when
-  // the build is configured with --code-cache-path=.... They are noops
-  // in node_code_cache_stub.cc
-  static void InitializeCodeCache();
-
- private:
-  static void RecordResult(const char* id,
-                           NativeModuleLoader::Result result,
-                           Environment* env);
-  static void GetModuleCategories(
-      v8::Local<v8::Name> property,
-      const v8::PropertyCallbackInfo<v8::Value>& info);
-  static void GetCacheUsage(const v8::FunctionCallbackInfo<v8::Value>& args);
-  // Passing ids of builtin module source code into JS land as
-  // internalBinding('native_module').moduleIds
-  static void ModuleIdsGetter(v8::Local<v8::Name> property,
-                              const v8::PropertyCallbackInfo<v8::Value>& info);
-  // Passing config.gypi into JS land as internalBinding('native_module').config
-  static void ConfigStringGetter(
-      v8::Local<v8::Name> property,
-      const v8::PropertyCallbackInfo<v8::Value>& info);
-  // Compile a specific native module as a function
-  static void CompileFunction(const v8::FunctionCallbackInfo<v8::Value>& args);
-};
-
-}  // namespace native_module
-
-}  // namespace node
-
-#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
-
-#endif  // SRC_NODE_NATIVE_MODULE_ENV_H_