koffi 1.1.0-beta.1 → 1.1.0-beta.4

package/vendor/node-addon-api/doc/handle_scope.md

@@ -0,0 +1,63 @@
+# HandleScope
+
+The HandleScope class is used to manage the lifetime of object handles
+which are created through the use of node-addon-api. These handles
+keep an object alive in the heap in order to ensure that the objects
+are not collected while native code is using them.
+A handle may be created when any new node-addon-api Value or one
+of its subclasses is created or returned. For more details refer to
+the section titled [Object lifetime management](object_lifetime_management.md).
+
+## Methods
+
+### Constructor
+
+Creates a new handle scope on the stack.
+
+```cpp
+Napi::HandleScope::HandleScope(Napi::Env env);
+```
+
+- `[in] env`: The environment in which to construct the `Napi::HandleScope` object.
+
+Returns a new `Napi::HandleScope`
+
+### Constructor
+
+Creates a new handle scope on the stack.
+
+```cpp
+Napi::HandleScope::HandleScope(Napi::Env env, Napi::HandleScope scope);
+```
+
+- `[in] env`: `Napi::Env` in which the scope passed in was created.
+- `[in] scope`: pre-existing `Napi::HandleScope`.
+
+Returns a new `Napi::HandleScope` instance which wraps the `napi_handle_scope`
+handle passed in.  This can be used to mix usage of the C Node-API
+and node-addon-api.
+
+```cpp
+operator Napi::HandleScope::napi_handle_scope() const
+```
+
+Returns the Node-API `napi_handle_scope` wrapped by the `Napi::EscapableHandleScope` object.
+This can be used to mix usage of the C Node-API and node-addon-api by allowing
+the class to be used be converted to a `napi_handle_scope`.
+
+### Destructor
+```cpp
+Napi::HandleScope::~HandleScope();
+```
+
+Deletes the `Napi::HandleScope` instance and allows any objects/handles created
+in the scope to be collected by the garbage collector.  There is no
+guarantee as to when the garbage collector will do this.
+
+### Env
+
+```cpp
+Napi::Env Napi::HandleScope::Env() const;
+```
+
+Returns the `Napi::Env` associated with the `Napi::HandleScope`.

package/vendor/node-addon-api/doc/hierarchy.md

@@ -0,0 +1,91 @@
+# Full Class Hierarchy
+
+| Class | Parent Class(es) |
+|---|---|
+| [`Napi::Addon`][] | [`Napi::InstanceWrap`][] |
+| [`Napi::Array`][] | [`Napi::Object`][] |
+| [`Napi::ArrayBuffer`][] | [`Napi::Object`][] |
+| [`Napi::AsyncContext`][] |  |
+| [`Napi::AsyncProgressQueueWorker`][] | `Napi::AsyncProgressWorkerBase` |
+| [`Napi::AsyncProgressWorker`][] | `Napi::AsyncProgressWorkerBase` |
+| [`Napi::AsyncWorker`][] |  |
+| [`Napi::BigInt`][] | [`Napi::Value`][] |
+| [`Napi::Boolean`][] | [`Napi::Value`][] |
+| [`Napi::Buffer`][] | [`Napi::Uint8Array`][] |
+| [`Napi::CallbackInfo`][] |  |
+| [`Napi::CallbackScope`][] |  |
+| [`Napi::ClassPropertyDescriptor`][] |  |
+| [`Napi::DataView`][] | [`Napi::Object`][] |
+| [`Napi::Date`][] | [`Napi::Value`][] |
+| [`Napi::Env`][] |  |
+| [`Napi::Error`][] | [`Napi::ObjectReference`][], [`std::exception`][] |
+| [`Napi::EscapableHandleScope`][] |  |
+| [`Napi::External`][] | [`Napi::Value`][] |
+| [`Napi::Function`][] | [`Napi::Object`][] |
+| [`Napi::FunctionReference`][] | [`Napi::Reference<Napi::Function>`][] |
+| [`Napi::HandleScope`][] |  |
+| [`Napi::InstanceWrap`][] |  |
+| [`Napi::MemoryManagement`][] |  |
+| [`Napi::Name`][] | [`Napi::Value`][] |
+| [`Napi::Number`][] | [`Napi::Value`][] |
+| [`Napi::Object`][] | [`Napi::Value`][] |
+| [`Napi::ObjectReference`][] | [`Napi::Reference<Napi::Object>`][] |
+| [`Napi::ObjectWrap`][] | [`Napi::InstanceWrap`][], [`Napi::Reference<Napi::Object>`][] |
+| [`Napi::Promise`][] | [`Napi::Object`][] |
+| [`Napi::PropertyDescriptor`][] |  |
+| [`Napi::RangeError`][] | [`Napi::Error`][] |
+| [`Napi::Reference`] |  |
+| [`Napi::String`][] | [`Napi::Name`][] |
+| [`Napi::Symbol`][] | [`Napi::Name`][] |
+| [`Napi::ThreadSafeFunction`][] |  |
+| [`Napi::TypeError`][] | [`Napi::Error`][] |
+| [`Napi::TypedArray`][] | [`Napi::Object`][] |
+| [`Napi::TypedArrayOf`][] | [`Napi::TypedArray`][] |
+| [`Napi::Value`][] |  |
+| [`Napi::VersionManagement`][] |  |
+
+[`Napi::Addon`]: ./addon.md
+[`Napi::Array`]: ./array.md
+[`Napi::ArrayBuffer`]: ./array_buffer.md
+[`Napi::AsyncContext`]: ./async_context.md
+[`Napi::AsyncProgressQueueWorker`]: ./async_worker_variants.md#asyncprogressqueueworker
+[`Napi::AsyncProgressWorker`]: ./async_worker_variants.md#asyncprogressworker
+[`Napi::AsyncWorker`]: ./async_worker.md
+[`Napi::BigInt`]: ./bigint.md
+[`Napi::Boolean`]: ./boolean.md
+[`Napi::Buffer`]: ./buffer.md
+[`Napi::CallbackInfo`]: ./callbackinfo.md
+[`Napi::CallbackScope`]: ./callback_scope.md
+[`Napi::ClassPropertyDescriptor`]: ./class_property_descriptor.md
+[`Napi::DataView`]: ./dataview.md
+[`Napi::Date`]: ./date.md
+[`Napi::Env`]: ./env.md
+[`Napi::Error`]: ./error.md
+[`Napi::EscapableHandleScope`]: ./escapable_handle_scope.md
+[`Napi::External`]: ./external.md
+[`Napi::Function`]: ./function.md
+[`Napi::FunctionReference`]: ./function_reference.md
+[`Napi::HandleScope`]: ./handle_scope.md
+[`Napi::InstanceWrap`]: ./instance_wrap.md
+[`Napi::MemoryManagement`]: ./memory_management.md
+[`Napi::Name`]: ./name.md
+[`Napi::Number`]: ./number.md
+[`Napi::Object`]: ./object.md
+[`Napi::ObjectReference`]: ./object_reference.md
+[`Napi::ObjectWrap`]: ./object_wrap.md
+[`Napi::Promise`]: ./promise.md
+[`Napi::PropertyDescriptor`]: ./property_descriptor.md
+[`Napi::RangeError`]: ./range_error.md
+[`Napi::Reference`]: ./reference.md
+[`Napi::Reference<Napi::Function>`]: ./reference.md
+[`Napi::Reference<Napi::Object>`]: ./reference.md
+[`Napi::String`]: ./string.md
+[`Napi::Symbol`]: ./symbol.md
+[`Napi::ThreadSafeFunction`]: ./thread_safe_function.md
+[`Napi::TypeError`]: ./type_error.md
+[`Napi::TypedArray`]: ./typed_array.md
+[`Napi::TypedArrayOf`]: ./typed_array_of.md
+[`Napi::Uint8Array`]: ./typed_array_of.md
+[`Napi::Value`]: ./value.md
+[`Napi::VersionManagement`]: ./version_management.md
+[`std::exception`]: https://cplusplus.com/reference/exception/exception/

package/vendor/node-addon-api/doc/instance_wrap.md

@@ -0,0 +1,408 @@
+# InstanceWrap<T>
+
+This class serves as the base class for [`Napi::ObjectWrap<T>`][] and
+[`Napi::Addon<T>`][].
+
+In the case of [`Napi::Addon<T>`][] it provides the
+methods for exposing functions to JavaScript on instances of an add-on.
+
+As a base class for [`Napi::ObjectWrap<T>`][] it provides the methods for
+exposing instance methods of JavaScript objects instantiated from the JavaScript
+class corresponding to the subclass of [`Napi::ObjectWrap<T>`][].
+
+## Methods
+
+### InstanceMethod
+
+Creates a property descriptor that represents a method exposed on JavaScript
+instances of this class.
+
+```cpp
+template <typename T>
+static Napi::ClassPropertyDescriptor<T>
+Napi::InstanceWrap<T>::InstanceMethod(const char* utf8name,
+                             InstanceVoidMethodCallback method,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
+```
+
+- `[in] utf8name`: Null-terminated string that represents the name of the method
+provided by instances of the class.
+- `[in] method`: The native function that represents a method provided by the
+add-on.
+- `[in] attributes`: The attributes associated with the property. One or more of
+`napi_property_attributes`.
+- `[in] data`: User-provided data passed into the method when it is invoked.
+
+Returns a `Napi::ClassPropertyDescriptor<T>` object that represents a method
+provided by instances of the class. The method must be of the form
+
+```cpp
+void MethodName(const Napi::CallbackInfo& info);
+```
+
+### InstanceMethod
+
+Creates a property descriptor that represents a method exposed on JavaScript
+instances of this class.
+
+```cpp
+template <typename T>
+static Napi::ClassPropertyDescriptor<T>
+Napi::InstanceWrap<T>::InstanceMethod(const char* utf8name,
+                             InstanceMethodCallback method,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
+```
+
+- `[in] utf8name`: Null-terminated string that represents the name of the method
+provided by instances of the class.
+- `[in] method`: The native function that represents a method provided by the
+add-on.
+- `[in] attributes`: The attributes associated with the property. One or more of
+`napi_property_attributes`.
+- `[in] data`: User-provided data passed into the method when it is invoked.
+
+Returns a `Napi::ClassPropertyDescriptor<T>` object that represents a method
+provided by instances of the class. The method must be of the form
+
+```cpp
+Napi::Value MethodName(const Napi::CallbackInfo& info);
+```
+
+### InstanceMethod
+
+Creates a property descriptor that represents a method exposed on JavaScript
+instances of this class.
+
+```cpp
+template <typename T>
+static Napi::ClassPropertyDescriptor<T>
+Napi::InstanceWrap<T>::InstanceMethod(Napi::Symbol name,
+                             InstanceVoidMethodCallback method,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
+```
+
+- `[in] name`: JavaScript symbol that represents the name of the method provided
+by instances of the class.
+- `[in] method`: The native function that represents a method provided by the
+add-on.
+- `[in] attributes`: The attributes associated with the property. One or more of
+`napi_property_attributes`.
+- `[in] data`: User-provided data passed into the method when it is invoked.
+
+Returns a `Napi::ClassPropertyDescriptor<T>` object that represents a method
+provided by instances of the class. The method must be of the form
+
+```cpp
+void MethodName(const Napi::CallbackInfo& info);
+```
+
+### InstanceMethod
+
+Creates a property descriptor that represents a method exposed on JavaScript
+instances of this class.
+
+```cpp
+template <typename T>
+static Napi::ClassPropertyDescriptor<T>
+Napi::InstanceWrap<T>::InstanceMethod(Napi::Symbol name,
+                             InstanceMethodCallback method,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
+```
+
+- `[in] name`: JavaScript symbol that represents the name of the method provided
+by instances of the class.
+- `[in] method`: The native function that represents a method provided by the
+add-on.
+- `[in] attributes`: The attributes associated with the property. One or more of
+`napi_property_attributes`.
+- `[in] data`: User-provided data passed into the method when it is invoked.
+
+Returns a `Napi::ClassPropertyDescriptor<T>` object that represents a method
+provided by instances of the class. The method must be of the form
+
+```cpp
+Napi::Value MethodName(const Napi::CallbackInfo& info);
+```
+
+### InstanceMethod
+
+Creates a property descriptor that represents a method exposed on JavaScript
+instances of this class.
+
+```cpp
+<template typename T>
+template <typename InstanceWrap<T>::InstanceVoidMethodCallback method>
+static Napi::ClassPropertyDescriptor<T>
+Napi::InstanceWrap::InstanceMethod(const char* utf8name,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
+```
+
+- `[in] method`: The native function that represents a method provided by the
+add-on.
+- `[in] utf8name`: Null-terminated string that represents the name of the method
+provided by instances of the class.
+- `[in] attributes`: The attributes associated with the property. One or more of
+`napi_property_attributes`.
+- `[in] data`: User-provided data passed into the method when it is invoked.
+
+Returns a `Napi::ClassPropertyDescriptor<T>` object that represents a method
+provided by instances of the class. The method must be of the form
+
+```cpp
+void MethodName(const Napi::CallbackInfo& info);
+```
+
+### InstanceMethod
+
+Creates a property descriptor that represents a method exposed on JavaScript
+instances of this class.
+
+```cpp
+template <typename T>
+template <typename InstanceWrap<T>::InstanceMethodCallback method>
+static Napi::ClassPropertyDescriptor<T>
+Napi::InstanceWrap<T>::InstanceMethod(const char* utf8name,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
+```
+
+- `[in] method`: The native function that represents a method provided by the
+add-on.
+- `[in] utf8name`: Null-terminated string that represents the name of the method
+provided by instances of the class.
+- `[in] attributes`: The attributes associated with the property. One or more of
+`napi_property_attributes`.
+- `[in] data`: User-provided data passed into the method when it is invoked.
+
+Returns a `Napi::ClassPropertyDescriptor<T>` object that represents a method
+provided by instances of the class. The method must be of the form
+
+```cpp
+Napi::Value MethodName(const Napi::CallbackInfo& info);
+```
+
+### InstanceMethod
+
+Creates a property descriptor that represents a method exposed on JavaScript
+instances of this class.
+
+```cpp
+template <typename T>
+template <typename InstanceWrap<T>::InstanceVoidMethodCallback method>
+static Napi::ClassPropertyDescriptor<T>
+Napi::InstanceWrap<T>::InstanceMethod(Napi::Symbol name,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
+```
+
+- `[in] method`: The native function that represents a method provided by the
+add-on.
+- `[in] name`: The `Napi::Symbol` object whose value is used to identify the
+instance method for the class.
+- `[in] attributes`: The attributes associated with the property. One or more of
+`napi_property_attributes`.
+- `[in] data`: User-provided data passed into the method when it is invoked.
+
+Returns a `Napi::ClassPropertyDescriptor<T>` object that represents a method
+provided by instances of the class. The method must be of the form
+
+```cpp
+void MethodName(const Napi::CallbackInfo& info);
+```
+
+### InstanceMethod
+
+Creates a property descriptor that represents a method exposed on JavaScript
+instances of this class.
+
+```cpp
+template <typename T>
+template <InstanceWrap<T>::InstanceMethodCallback method>
+static Napi::ClassPropertyDescriptor<T>
+Napi::InstanceWrap<T>::InstanceMethod(Napi::Symbol name,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
+```
+
+- `[in] method`: The native function that represents a method provided by the
+add-on.
+- `[in] name`: The `Napi::Symbol` object whose value is used to identify the
+instance method for the class.
+- `[in] attributes`: The attributes associated with the property. One or more of
+`napi_property_attributes`.
+- `[in] data`: User-provided data passed into the method when it is invoked.
+
+Returns a `Napi::ClassPropertyDescriptor<T>` object that represents a method
+provided by instances of the class. The method must be of the form
+
+```cpp
+Napi::Value MethodName(const Napi::CallbackInfo& info);
+```
+
+### InstanceAccessor
+
+Creates a property descriptor that represents a property exposed on JavaScript
+instances of this class.
+
+```cpp
+template <typename T>
+static Napi::ClassPropertyDescriptor<T>
+Napi::InstanceWrap<T>::InstanceAccessor(const char* utf8name,
+                             InstanceGetterCallback getter,
+                             InstanceSetterCallback setter,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
+```
+
+- `[in] utf8name`: Null-terminated string that represents the name of the method
+provided by instances of the class.
+- `[in] getter`: The native function to call when a get access to the property
+is performed.
+- `[in] setter`: The native function to call when a set access to the property
+is performed.
+- `[in] attributes`: The attributes associated with the property. One or more of
+`napi_property_attributes`.
+- `[in] data`: User-provided data passed into the getter or the setter when it
+is invoked.
+
+Returns a `Napi::ClassPropertyDescriptor<T>` object that represents an instance
+accessor property provided by instances of the class.
+
+### InstanceAccessor
+
+Creates a property descriptor that represents a property exposed on JavaScript
+instances of this class.
+
+```cpp
+template <typename T>
+static Napi::ClassPropertyDescriptor<T>
+Napi::InstanceWrap<T>::InstanceAccessor(Symbol name,
+                             InstanceGetterCallback getter,
+                             InstanceSetterCallback setter,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
+```
+
+- `[in] name`: The `Napi::Symbol` object whose value is used to identify the
+instance accessor.
+- `[in] getter`: The native function to call when a get access to the property of
+a JavaScript class is performed.
+- `[in] setter`: The native function to call when a set access to the property of
+a JavaScript class is performed.
+- `[in] attributes`: The attributes associated with the property. One or more of
+`napi_property_attributes`.
+- `[in] data`: User-provided data passed into the getter or the setter when it
+is invoked.
+
+Returns a `Napi::ClassPropertyDescriptor<T>` object that represents an instance
+accessor property provided instances of the class.
+
+### InstanceAccessor
+
+Creates a property descriptor that represents a property exposed on JavaScript
+instances of this class.
+
+```cpp
+template <typename T>
+template <typename InstanceWrap<T>::InstanceGetterCallback getter,
+          typename InstanceWrap<T>::InstanceSetterCallback setter=nullptr>
+static Napi::ClassPropertyDescriptor<T>
+Napi::InstanceWrap<T>::InstanceAccessor(const char* utf8name,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
+```
+
+- `[in] getter`: The native function to call when a get access to the property of
+a JavaScript class is performed.
+- `[in] setter`: The native function to call when a set access to the property of
+a JavaScript class is performed.
+- `[in] utf8name`: Null-terminated string that represents the name of the method
+provided by instances of the class.
+- `[in] attributes`: The attributes associated with the property. One or more of
+`napi_property_attributes`.
+- `[in] data`: User-provided data passed into the getter or the setter when it
+is invoked.
+
+Returns a `Napi::ClassPropertyDescriptor<T>` object that represents an instance
+accessor property provided by instances of the class.
+
+### InstanceAccessor
+
+Creates a property descriptor that represents a property exposed on JavaScript
+instances of this class.
+
+```cpp
+template <typename T>
+template <typename InstanceWrap<T>::InstanceGetterCallback getter,
+          typename InstanceWrap<T>::InstanceSetterCallback setter=nullptr>
+static Napi::ClassPropertyDescriptor<T>
+Napi::InstanceWrap<T>::InstanceAccessor(Symbol name,
+                             napi_property_attributes attributes = napi_default,
+                             void* data = nullptr);
+```
+
+- `[in] getter`: The native function to call when a get access to the property of
+a JavaScript class is performed.
+- `[in] setter`: The native function to call when a set access to the property of
+a JavaScript class is performed.
+- `[in] name`: The `Napi::Symbol` object whose value is used to identify the
+instance accessor.
+- `[in] attributes`: The attributes associated with the property. One or more of
+`napi_property_attributes`.
+- `[in] data`: User-provided data passed into the getter or the setter when it
+is invoked.
+
+Returns a `Napi::ClassPropertyDescriptor<T>` object that represents an instance
+accessor property provided by instances of the class.
+
+### InstanceValue
+
+Creates property descriptor that represents a value exposed on JavaScript
+instances of this class.
+
+```cpp
+template <typename T>
+static Napi::ClassPropertyDescriptor<T>
+Napi::InstanceWrap<T>::InstanceValue(const char* utf8name,
+                            Napi::Value value,
+                            napi_property_attributes attributes = napi_default);
+```
+
+- `[in] utf8name`: Null-terminated string that represents the name of the
+property.
+- `[in] value`: The value that's retrieved by a get access of the property.
+- `[in] attributes`: The attributes associated with the property. One or more of
+`napi_property_attributes`.
+
+Returns a `Napi::ClassPropertyDescriptor<T>` object that represents an instance
+value property of an add-on.
+
+### InstanceValue
+
+Creates property descriptor that represents a value exposed on JavaScript
+instances of this class.
+
+```cpp
+template <typename T>
+static Napi::ClassPropertyDescriptor<T>
+Napi::InstanceWrap<T>::InstanceValue(Symbol name,
+                            Napi::Value value,
+                            napi_property_attributes attributes = napi_default);
+```
+
+- `[in] name`: The `Napi::Symbol` object whose value is used to identify the
+name of the property.
+- `[in] value`: The value that's retrieved by a get access of the property.
+- `[in] attributes`: The attributes associated with the property. One or more of
+`napi_property_attributes`.
+
+Returns a `Napi::ClassPropertyDescriptor<T>` object that represents an instance
+value property of an add-on.
+
+[`Napi::Addon<T>`]: ./addon.md
+[`Napi::ObjectWrap<T>`]: ./object_wrap.md

package/vendor/node-addon-api/doc/maybe.md

@@ -0,0 +1,76 @@
+# Maybe (template)
+
+Class `Napi::Maybe<T>` represents a value that may be empty: every `Maybe` is
+either `Just` and contains a value, or `Nothing`, and does not. `Maybe` types
+are very common in node-addon-api code, as they represent that the function may
+throw a JavaScript exception and cause the program to be unable to evaluate any
+JavaScript code until the exception has been handled.
+
+Typically, the value wrapped in `Napi::Maybe<T>` is [`Napi::Value`] and its
+subclasses.
+
+## Methods
+
+### IsNothing
+
+```cpp
+template <typename T>
+bool Napi::Maybe::IsNothing() const;
+```
+
+Returns `true` if the `Maybe` is `Nothing` and does not contain a value, and
+`false` otherwise.
+
+### IsJust
+
+```cpp
+template <typename T>
+bool Napi::Maybe::IsJust() const;
+```
+
+Returns `true` if the `Maybe` is `Just` and contains a value, and `false`
+otherwise.
+
+### Check
+
+```cpp
+template <typename T>
+void Napi::Maybe::Check() const;
+```
+
+Short-hand for `Maybe::Unwrap()`, which doesn't return a value. Could be used
+where the actual value of the Maybe is not needed like `Object::Set`.
+If this Maybe is nothing (empty), node-addon-api will crash the
+process.
+
+### Unwrap
+
+```cpp
+template <typename T>
+T Napi::Maybe::Unwrap() const;
+```
+
+Return the value of type `T` contained in the Maybe. If this Maybe is
+nothing (empty), node-addon-api will crash the process.
+
+### UnwrapOr
+
+```cpp
+template <typename T>
+T Napi::Maybe::UnwrapOr(const T& default_value) const;
+```
+
+Return the value of type T contained in the Maybe, or use a default
+value if this Maybe is nothing (empty).
+
+### UnwrapTo
+
+```cpp
+template <typename T>
+bool Napi::Maybe::UnwrapTo(T* result) const;
+```
+
+Converts this Maybe to a value of type `T` in the `out`. If this Maybe is
+nothing (empty), `false` is returned and `out` is left untouched.
+
+[`Napi::Value`]: ./value.md

package/vendor/node-addon-api/doc/memory_management.md

@@ -0,0 +1,27 @@
+# MemoryManagement
+
+The `Napi::MemoryManagement` class contains functions that give the JavaScript engine
+an indication of the amount of externally allocated memory that is kept alive by
+JavaScript objects.
+
+## Methods
+
+### AdjustExternalMemory
+
+The function `AdjustExternalMemory` adjusts the amount of registered external
+memory used to give the JavaScript engine an indication of the amount of externally
+allocated memory that is kept alive by JavaScript objects.
+The JavaScript engine uses this to decide when to perform global garbage collections.
+Registering externally allocated memory will trigger global garbage collections
+more often than it would otherwise in an attempt to garbage collect the JavaScript
+objects that keep the externally allocated memory alive.
+
+```cpp
+static int64_t Napi::MemoryManagement::AdjustExternalMemory(Napi::Env env, int64_t change_in_bytes);
+```
+
+- `[in] env`: The environment in which the API is invoked under.
+- `[in] change_in_bytes`: The change in externally allocated memory that is kept
+alive by JavaScript objects expressed in bytes.
+
+Returns the adjusted memory value.

package/vendor/node-addon-api/doc/name.md

@@ -0,0 +1,29 @@
+# Name
+
+Class `Napi::Name` inherits from class [`Napi::Value`][].
+
+Names are JavaScript values that can be used as a property name. There are two
+specialized types of names supported in Node.js Addon API [`Napi::String`](string.md)
+and [`Napi::Symbol`](symbol.md).
+
+## Methods
+
+### Constructor
+```cpp
+Napi::Name::Name();
+```
+
+Returns an empty `Napi::Name`.
+
+```cpp
+Napi::Name::Name(napi_env env, napi_value value);
+```
+- `[in] env` - The environment in which to create the array.
+- `[in] value` - The primitive to wrap.
+
+Returns a `Napi::Name` created from the JavaScript primitive.
+
+Note:
+The value is not coerced to a string.
+
+[`Napi::Value`]: ./value.md