@zowe/cli 8.37.0 → 8.38.0

package/node_modules/nan/README.md

@@ -1,15 +1,14 @@
 Native Abstractions for Node.js
 ===============================
 
-**A header file filled with macro and utility goodness for making add-on development for Node.js easier across versions 0.8, 0.10, 0.12, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19 and 20.**
+**A header file filled with macro and utility goodness for making add-on development for Node.js easier across versions 8, 10, 12, 14, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25 and 26.**
 
-***Current version: 2.18.0***
+***Current version: 2.29.0***
 
 *(See [CHANGELOG.md](https://github.com/nodejs/nan/blob/master/CHANGELOG.md) for complete ChangeLog)*
 
 [![NPM](https://nodei.co/npm/nan.png?downloads=true&downloadRank=true)](https://nodei.co/npm/nan/) [![NPM](https://nodei.co/npm-dl/nan.png?months=6&height=3)](https://nodei.co/npm/nan/)
 
-[![Build Status](https://api.travis-ci.com/nodejs/nan.svg?branch=master)](https://travis-ci.com/nodejs/nan)
 [![Build status](https://ci.appveyor.com/api/projects/status/kh73pbm9dsju7fgh)](https://ci.appveyor.com/project/RodVagg/nan)
 
 Thanks to the crazy changes in V8 (and some in Node core), keeping native addons compiling happily across versions, particularly 0.10 to 0.12 to 4.0, is a minor nightmare. The goal of this project is to store all logic necessary to develop native Node.js addons without having to inspect `NODE_MODULE_VERSION` and get yourself into a macro-tangle.
@@ -32,10 +31,10 @@ This project also contains some helper utilities that make addon development a b
 
 ## Usage
 
-Simply add **NAN** as a dependency in the *package.json* of your Node addon:
+Simply add **NAN** as a dependency using a package manager like npm, yarn, or bun:
 
 ``` bash
-$ npm install --save nan
+$ npm install nan
 ```
 
 Pull in the path to **NAN** in your *binding.gyp* so that you can use `#include <nan.h>` in your *.cpp* files:
@@ -273,6 +272,7 @@ Miscellaneous string & byte encoding and decoding functionality provided for com
 
  - <a href="doc/string_bytes.md#api_nan_encoding"><b><code>Nan::Encoding</code></b></a>
  - <a href="doc/string_bytes.md#api_nan_encode"><b><code>Nan::Encode()</code></b></a>
+ - <a href="doc/string_bytes.md#api_nan_try_encode"><b><code>Nan::TryEncode()</code></b></a>
  - <a href="doc/string_bytes.md#api_nan_decode_bytes"><b><code>Nan::DecodeBytes()</code></b></a>
  - <a href="doc/string_bytes.md#api_nan_decode_write"><b><code>Nan::DecodeWrite()</code></b></a>
 
@@ -297,12 +297,13 @@ The hooks to access V8 internals—including GC and statistics—are different a
  - <a href="doc/v8_internals.md#api_nan_set_counter_function"><b><code>Nan::SetCounterFunction()</code></b></a>
  - <a href="doc/v8_internals.md#api_nan_set_create_histogram_function"><b><code>Nan::SetCreateHistogramFunction()</code></b></a>
  - <a href="doc/v8_internals.md#api_nan_set_add_histogram_sample_function"><b><code>Nan::SetAddHistogramSampleFunction()</code></b></a>
- - <a href="doc/v8_internals.md#api_nan_idle_notification"><b><code>Nan::IdleNotification()</code></b></a>
+ - <a href="doc/v8_internals.md#api_nan_idle_notification"><del><b><code>Nan::IdleNotification()</code></b></del></a>
  - <a href="doc/v8_internals.md#api_nan_low_memory_notification"><b><code>Nan::LowMemoryNotification()</code></b></a>
  - <a href="doc/v8_internals.md#api_nan_context_disposed_notification"><b><code>Nan::ContextDisposedNotification()</code></b></a>
  - <a href="doc/v8_internals.md#api_nan_get_internal_field_pointer"><b><code>Nan::GetInternalFieldPointer()</code></b></a>
  - <a href="doc/v8_internals.md#api_nan_set_internal_field_pointer"><b><code>Nan::SetInternalFieldPointer()</code></b></a>
  - <a href="doc/v8_internals.md#api_nan_adjust_external_memory"><b><code>Nan::AdjustExternalMemory()</code></b></a>
+ - <a href="doc/v8_internals.md#api_nan_get_external_value"><b><code>Nan::GetExternalValue()</code></b></a>
 
 
 ### Miscellaneous V8 Helpers

package/node_modules/nan/doc/methods.md

@@ -505,6 +505,8 @@ void Nan::SetPrototypeMethod(v8::Local<v8::FunctionTemplate> recv,
 
 Sets getters and setters for a property with a given name on an `ObjectTemplate` or a plain `Object`. Accepts getters with the `Nan::GetterCallback` signature (see <a href="#api_nan_getter">Getter declaration</a>) and setters with the `Nan::SetterCallback` signature (see <a href="#api_nan_setter">Setter declaration</a>).
 
+**Note** `v8::AccessControl` was deprectaed in v8 14.2 and subsequently removed. To maintain backward compatibility new enum `enum AccessControl {DEFAULT = 0};` was added. Nan will determine v8 version used and switch to a correct signature.
+
 Signature:
 
 ```c++
@@ -531,6 +533,21 @@ bool SetAccessor(v8::Local<v8::Object> obj,
                  v8::Local<v8::Value> data = v8::Local<v8::Value>(),
                  v8::AccessControl settings = v8::DEFAULT,
                  v8::PropertyAttribute attribute = v8::None)
+// Starting from v8 14.2 new enum is used
+void SetAccessor(v8::Local<v8::ObjectTemplate> tpl,
+                 v8::Local<v8::String> name,
+                 Nan::GetterCallback getter,
+                 Nan::SetterCallback setter = 0,
+                 v8::Local<v8::Value> data = v8::Local<v8::Value>(),
+                 enum Nan::AccessControl settings = DEFAULT,
+                 v8::PropertyAttribute attribute = v8::None);
+bool SetAccessor(v8::Local<v8::Object> obj,
+                 v8::Local<v8::String> name,
+                 Nan::GetterCallback getter,
+                 Nan::SetterCallback setter = 0,
+                 v8::Local<v8::Value> data = v8::Local<v8::Value>(),
+                 enum Nan::AccessControl settings = DEFAULT,
+                 v8::PropertyAttribute attribute = v8::None)
 ```
 
 See the V8 [`ObjectTemplate#SetAccessor()`](https://v8docs.nodesource.com/node-8.16/db/d5f/classv8_1_1_object_template.html#aca0ed196f8a9adb1f68b1aadb6c9cd77) and [`Object#SetAccessor()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#ae91b3b56b357f285288c89fbddc46d1b) for further information about how to use `Nan::SetAccessor()`.

package/node_modules/nan/doc/string_bytes.md

@@ -4,6 +4,7 @@ Miscellaneous string & byte encoding and decoding functionality provided for com
 
  - <a href="#api_nan_encoding"><b><code>Nan::Encoding</code></b></a>
  - <a href="#api_nan_encode"><b><code>Nan::Encode()</code></b></a>
+ - <a href="#api_nan_try_encode"><b><code>Nan::TryEncode()</code></b></a>
  - <a href="#api_nan_decode_bytes"><b><code>Nan::DecodeBytes()</code></b></a>
  - <a href="#api_nan_decode_write"><b><code>Nan::DecodeWrite()</code></b></a>
 
@@ -25,6 +26,8 @@ enum Nan::Encoding { ASCII, UTF8, BASE64, UCS2, BINARY, HEX, BUFFER }
 
 A wrapper around `node::Encode()` that provides a consistent implementation across supported versions of Node.
 
+**Note** `node::Encode()` was deprecated in Node 24 but will remain to maintain backwards compatibility. For Node 24 and higher consider using [`Nan::TryEncode()`](#api_nan_try_encode).
+
 Signature:
 
 ```c++
@@ -34,6 +37,22 @@ v8::Local<v8::Value> Nan::Encode(const void *buf,
 ```
 
 
+<a name="api_nan_try_encode"></a>
+### Nan::TryEncode()
+
+A wrapper around `node::TryEncode()` that provides a consistent implementation across supported versions of Node.
+
+**Note** Only available in Node 24 and higher. For earlier versions use  [`Nan::Encode()`](#api_nan_encode).
+
+Signature:
+
+```c++
+Nan::MaybeLocal<v8::Value> Nan::TryEncode(const void *buf,
+                                 size_t len,
+                                 enum Nan::Encoding encoding = BINARY);
+```
+
+
 <a name="api_nan_decode_bytes"></a>
 ### Nan::DecodeBytes()
 

package/node_modules/nan/doc/v8_internals.md

@@ -11,12 +11,13 @@ The hooks to access V8 internals—including GC and statistics—are different a
  - <a href="#api_nan_set_counter_function"><b><code>Nan::SetCounterFunction()</code></b></a>
  - <a href="#api_nan_set_create_histogram_function"><b><code>Nan::SetCreateHistogramFunction()</code></b></a>
  - <a href="#api_nan_set_add_histogram_sample_function"><b><code>Nan::SetAddHistogramSampleFunction()</code></b></a>
- - <a href="#api_nan_idle_notification"><b><code>Nan::IdleNotification()</code></b></a>
+ - <a href="#api_nan_idle_notification"><del><b><code>Nan::IdleNotification()</code></b></del></a>
  - <a href="#api_nan_low_memory_notification"><b><code>Nan::LowMemoryNotification()</code></b></a>
  - <a href="#api_nan_context_disposed_notification"><b><code>Nan::ContextDisposedNotification()</code></b></a>
  - <a href="#api_nan_get_internal_field_pointer"><b><code>Nan::GetInternalFieldPointer()</code></b></a>
  - <a href="#api_nan_set_internal_field_pointer"><b><code>Nan::SetInternalFieldPointer()</code></b></a>
  - <a href="#api_nan_adjust_external_memory"><b><code>Nan::AdjustExternalMemory()</code></b></a>
+ - <a href="#api_nan_get_external_value"><b><code>Nan::GetExternalValue()</code></b></a>
 
 
 <a name="api_nan_gc_callback"></a>
@@ -128,15 +129,15 @@ void Nan::SetAddHistogramSampleFunction(v8::AddHistogramSampleCallback cb)
 Calls V8's [`SetAddHistogramSampleFunction()`](https://v8docs.nodesource.com/node-8.16/d5/dda/classv8_1_1_isolate.html#aeb420b690bc2c216882d6fdd00ddd3ea).
 
 <a name="api_nan_idle_notification"></a>
-### Nan::IdleNotification()
+### <del>Nan::IdleNotification()</del>
 
 Signature:
 
 ```c++
-bool Nan::IdleNotification(int idle_time_in_ms)
+NAN_DEPRECATED bool Nan::IdleNotification(int idle_time_in_ms)
 ```
 
-Calls V8's [`IdleNotification()` or `IdleNotificationDeadline()`](https://v8docs.nodesource.com/node-8.16/d5/dda/classv8_1_1_isolate.html#ad6a2a02657f5425ad460060652a5a118) depending on V8 version.
+Calls V8's [`IdleNotification()` or `IdleNotificationDeadline()`](https://v8docs.nodesource.com/node-8.16/d5/dda/classv8_1_1_isolate.html#ad6a2a02657f5425ad460060652a5a118) depending on V8 version. Removed in V8 12.7.41.
 
 <a name="api_nan_low_memory_notification"></a>
 ### Nan::LowMemoryNotification()
@@ -197,3 +198,14 @@ int Nan::AdjustExternalMemory(int bytesChange)
 
 Calls V8's [`AdjustAmountOfExternalAllocatedMemory()`](https://v8docs.nodesource.com/node-8.16/d5/dda/classv8_1_1_isolate.html#ae1a59cac60409d3922582c4af675473e).
 
+<a name="api_nan_get_external_value"></a>
+### Nan::GetExternalValue()
+
+Reads the pointer stored in a `v8::External`. On V8 versions that require an `ExternalPointerTypeTag` on `v8::External::Value()`, the default tag is applied (matching the tag used when the External is created via `Nan::New<v8::External>()`).
+
+Signature:
+
+```c++
+void* Nan::GetExternalValue(v8::Local<v8::External> ext)
+```
+