XML: fixed memory leak when exception happens in node.addChild().

The issue was introduced in 3891f338e2c9.

Found by Coverity (CID 1521487).

Fixed attaching of a stack to an error object.

This problem is similar to previous commits.  When
njs_error_stack_attach() accepted the value as a pointer to vm->retval
that value might be changed as a side effert of njs_error_stack_new()
evaluation.  This may result in a garbage value for
njs_object(value) expression.

The workaround fix is to make a copy of vm->retval to ensure its
intergrity and to preserve it as a retval. The proper fix is to
eliminate vm->retval altogether.

This fixes #612, #613, #616 issues on Github.

WebCrypto: fixed compilation with --debug=YES.

The issue was introduced in 2e3bbe8743af (0.7.10).

Fixed a func instance dumping with "name" as getter.

After njs_value_property() call the value argument might be
overwritten.

This is similar to #615.

Fixed njs_object_property() with NJS_WHITEOUT properties.

Previosly, an error object dumping might result in invalid pointer
dereference when 'name' or 'message' property of accessor descriptor
type was added and removed before.

The fix is to properly handle NJS_WHITEOUT properties.

This fixes #617 issue on Github.

Fixed array instance with a getter property dumping.

This closes #618 issue on Github.

Fixed Error() instance dumping when "name" prop is not primitive.

Previously, njs_error_to_string2() might be invoked with error argument
pointing to vm->retval.  When "name" prop was not primitive vm->retval
might be overwritten.  As a result error pointer might be referencing a
primitive value.  In turn the second call of njs_object_property()
received an invalid object pointer because it expects only object value
types.

The fix is to ensure that error object pointer is never overwritten.

This closes #615 issue on Github.

Unit tests: replacing njs_vm_retval_string() with njs_vm_retval_dump().

The change allows to cover CLI behaviour more closely.

Parser: fixed the detection of await in arguments.

This fixes #619 issue on Github.

Stream: added missed linking with libxml2 for the dynamic module.

The issue was introduced in 99b9f83e4d4d (0.7.10).

XML: added XMLNode API to modify XML documents.

    - delete node.$attr$a is a shorthand syntax for
        node.removeAttribute('a')

    - node.removeAllAttributes() removes all attributes of the node.

    - node.removeAttribute(attr_name) removes attribute named
        attr_name.

    - node.setAttribute(attr_name, value || null) sets a value for an
    attr_name. When value is null attribute named attr_name is
    deleted.

    - node.$attr$a = 'xxx' is a shorthand syntax for
        node.setAttribute('a', 'xxx');

    - The methods and operations below make copy-on-write
        changes to the original XML parsed document.

        For example:
        var doc = xml.parse(<r><a><b/></a></r>);
        var b = doc.$root.a.b;
        doc.$root.removeAllChildren();

        console.log((new TextDecoder()).decode(xml.c14n(doc))); /* <r></r> */
        console.log(b); /* XMLNode {$name:'b'} */
        console.log(b.$parent); /* XMLNode {$name:'a',$tags:[XMLNode
                                  {$name:'b'}] */

        "b" is valid after removeAllChildren() call, but is not a part
        of the document tree anymore.

    - node.addChild(nd) adds XMLNode as a child to node.
      nd recursively copied before adding to the node.

    - node.removeChildren(tag_name?) removes all the children tags
        named tag_name. If tag_name is absent all children tags are
        removed.

    - node.removeText() removes the node's text value.

    - node.setText(string || null) sets a text value for the node.
        When value is null the node's text is deleted.

    - node.$tags = [node1, node2, ..] is a shorthand syntax for
        node.removeChildren();
        node.addChild(node1);
        node.addChild(node2)

    - node.$text = 'xxx' is a shorthand syntax for
        node.setText('xxx');

    In addition the following method were added:
    - xml.serialize() is the same as xml.c14n()

    - xml.serializeToString() is the same as xml.c14n()
        except it returns the result as string.

    Example:
        const xml = require("xml");
        let data = `<note><to b="bar" a="foo">Tove</to><from>Jani</from></note>`;
        let doc = xml.parse(data);

        doc.$root.to.$attr$b = 'bar2';
        doc.$root.to.setAttribute('c', 'baz');
        delete doc.$root.to.$attr$a;

        console.log(xml.serializeToString(doc.$root.to)) /* '<to b="bar2" c="baz">Tove</to>' */

        doc.$root.to.removeAllAttributes();
        doc.$root.from.$text = 'Jani2';

        console.log(xml.serializeToString(doc)) /* '<note><to>Tove</to><from>Jani2</from></note>' */

        doc.$root.to.$tags = [xml.parse(`<a/>`), xml.parse(`<b/>`)];
        doc.$root.to.addChild(xml.parse(`<a/>`));

        console.log(xml.serializeToString(doc.$root.to)) /* '<to><a></a><b></b><a></a></to>' */

        doc.$root.to.removeChildren('a');

        console.log(xml.serializeToString(doc.$root.to)) /* '<to><b></b></to>' */

Added njs_vm_value_to_c_string().

Types: updated Fetch API types.

Types: added forgotten r.rawHeadersIn and r.rawHeadersOut description.

Types: fixed Fetch API types.

Version bump.

Added tag 0.7.10 for changeset 3a1b46d51f04

Removed tag 0.7.10

Added tag 0.7.10 for changeset 60a3ffe734b6

Version 0.7.10.

Fetch: fixed compatibility with nginx-1.22 and below.

Previously, ngx_table_elt_t structure was used directly in njs fetch
code.  This prevents from building with nginx-1.22 as the structure
was changed after nginx-1.22.

The fix is to use njs defined structure instead of ngx_table_elt_t.

This fixes #610 issue on Github.

Added String.prototype.replaceAll().

Fixed RegExp.prototype[@@replace]().

Previously, when RegExpExec() returned a fast-array with gaps
String.prototype.replace() might return erroneous exception
TypeError: Cannot convert object to primitive value.

Properly fixed memory leak after 948b167202b2.

This prevents double-free introduced in 948b167202b2.

Types: added ts types for the xml API.

Fixed memory leak when exception happens at xml.exclusiveC14n().

Found by Coverity (CID 1520596).

Fixed typos introduced in 99b9f83e4d4d.

Found by Coverity (CID 1520597, 1520598, 1520599).

2023 year.

Report libxml2 used for build.

Added pkg-config-based libxml2 detection.

Added description for --no-libxml2 option.

Added "xml" module for working with XML documents.

    - xml.parse(string|buffer) returns an XMLDoc wrapper object around
        XML structure.
    - xml.c14n(root_node[, excluding_node]]) canonicalizes root_node and
        its children according to https://www.w3.org/TR/xml-c14n, optionally
        excluding_node allows to omit from the output a part of the
        document.
    - xml.exclusiveC14n(root_node[, excluding_node[, withComments [,
            prefix_list]]]) canonicalizes root_node and its children
        according to https://www.w3.org/TR/xml-exc-c14n/.  excluding_node
        allows to omit from the output a part of the document
        corresponding to the node and its children.  withComments
        is a boolean and is false by default. When withComments is true
        canonicalization corresponds to
        http://www.w3.org/2001/10/xml-exc-c14n#WithComments.  prefix_list is
        an optional string with a space separated namespace prefixes for
        namespaces that should also be included into the output.

    - XMLDoc an XMLDoc wrapper object around XML structure.
        doc.xxx returns the first root tag named "xxx" as XMLNode wrapper
        object.

    - XMLNode an XMLNode wrapper object around XML tag node.
        node.$tag$xxx returns the first child tag named "xxx" as XMLNode
        wrapper object.
        node.xxx a shorthand syntax for node.$tag$xxx.
        node.$tags$xxx? returns an array of all children tags named xxx.

        node.$attr$xxx returns an attribute value of xxx.
        node.$attrs returns an XMLAttr wrapper object.
        node.$name returns the tag name of the node.
        node.$ns returns the namespace of the node.
        node.$parent returns the parent of the node.
        node.$text returns the node's content.

    - XMLAttrs an XMLAttrs wrapper object around XML node attributes.
        attrs.xxx returns a value of the xxx attribute.

    - Example:
        const xml = require("xml");
        let data = `<note><to b="bar" a= "foo" >Tove</to><from>Jani</from></note>`;
        let doc = xml.parse(data);

        console.log(doc.note.to.$text) /* 'Tove' */
        console.log(doc.note.to.$attr$b) /* 'bar' */
        console.log(doc.note.$tags[1].$text) /* 'Jani' */

        let dec = new TextDecoder();
        let c14n = dec.decode(xml.exclusiveC14n(doc.note));
        console.log(c14n) /* '<note><to a="foo" b="bar">Tove</to><from>Jani</from></note>' */

        c14n = dec.decode(xml.exclusiveC14n(doc.note.to));
        console.log(c14n) /* '<to a="foo" b="bar">Tove</to>' */

        c14n = dec.decode(xml.exclusiveC14n(doc.note, doc.note.to /* excluding 'to' */));
        console.log(c14n) /* '<note><from>Jani</from></note>' */

Added njs_vm_value_string_create() and njs_vm_value_string_create_chb().

Unlike njs_vm_value_string_set() the new functions always check the
input string for a valid UTF8 and calculate UTF8 character length by
themselves.

Shell: increased max output size for console.log() to 32768.

Added njs_vm_add_module().

The new API does not require for njs_mod_t structure to be disclosed.

Fixed Object.values() and Object.entries() with external objects.

This closes #606 issue on Github.

Fixed unitialized value usage warning.

Found by Coverity (CID 1518908).

WebCrypto: improved njs_bn_bn2binpad() for OpenSSL < 1.1.0.

The patch makes njs_bn_bn2binpad() more similar to BN_bn2binpad().

WebCrypto: extended support for symmetric keys.

The following functionality for HMAC and AES-* keys were added:
    importKey() supporting 'jwk' format,
    exportKey() supporting 'jwk' and 'raw' formats,
    generateKey().

WebCrypto: extended support for asymmetric keys.

The following functionality for RSA and EC keys were added:
    importKey() supporting 'jwk' format,
                also 'raw' format for EC public keys.
    exportKey() supporting 'pksc8', 'spki', 'jwk' format,
                also 'raw' format for EC public keys.
    generateKey().

WebCrypto: improved exception wording for invalid key formats.

WebCrypto: added missed support for AES-* keys of size 192.

WebCrypto: fixed importKey() for AES-* keys.

Previously, key of of any length were accepted, whereas according to the
spec only 128, 192 and 256 bits are allowed.

Fixed typos.

Modules: added Request, Response and Headers ctors in Fetch API.

    Added Headers method and properties: append(), delete(), get(),
        forEach(), has(), set().
    Added Request method and properties: arrayBuffer(), bodyUsed,
        cache, credentials, json(), method, mode, text(), url.
    Added Headers, Request, Response constructors.

    This closes #425 issue on Github.

Modules: fixed nginx logger callback for calls in master.

Added njs_vm_string_compare().

Added njs_vm_external_ptr().

Extended njs_vm_function_alloc().

Added njs_value_function_set().

Allowing to declare exotic slot for the external objects.

Improved performance of conditional jumps.

Fixed for(expr1; conditional syntax error handling.

Shell: added signal support in CLI.

Version bump.

Added tag 0.7.9 for changeset 5f705230a62c

Version 0.7.9.

Added a target to generate pkg-config file.

Fixed for-in unwanted detection of arrow function.

Fixed for-in rhs expression parsing error handling.

This fixes https://bugs.chromium.org/p/oss-fuzz/issues/detail?id=53426.

Modules: fixed Fetch Response prototype reinitialization.

Previously, since 446a1cb64a6a (0.7.7), when at least one js_import directive
was declared in both HTTP and Stream, ngx.fetch() returned inapproriate
response in Stream.

The prototype for Response object was created two times for HTTP and STREAM,
but the second initialization of global variable with the index of the
Response() prototype overwrites the first value with a different value.  This
caused a problem in Stream code which manifested itself as a `Stream flags`
object returned as a result of ngx.fetch() call instead of a Response instance.

The fix is to ensure that shared prototypes like a Response prototype
have indentical index value in all the modules.

This fixes #596 issue on Github.

Masks definition corrected and made regularized.

Fixed for-in loop with left and right hand side expressions.

This fixes #351 issue on Github.

Fixed Array.prototype.splice(s,d) when d resizes "this" during eval.

This closes #592 and #595 issues on Github.

Improved njs_value_property_i64_delete() for fast-arrays.

Improved njs_object_prop_define() for fast-arrays.

Previously, any Object.defineProperty() for fast-arrays converted them
to slow ones. Now, it is only done when it is necessary.

Change: the default JS stack size is reduced to 64k.

After 86784a68e8c8 (Computed goto) the size of a stack frame
njs_vmcode_interpreter() when -O0 is specified during compilation
increased significantly.  This might cause system stack overflow for very
deep recursive calls because system stack is exausted faster than JS
stack.

It is possible now to specify JS stack size for CLI.

Fixed %TypedArray%.prototype.set(s) when s element changes "this".

This closes #590 issue on Github.

Types: fixed description for fs.mkdir() and fs.rmdir() methods.

This closes #600 issue on Github.

Fixed default module loader.

Previously, njs_mp_free() was called with invalid pointer because
njs_vm_compile_module() shifts start argument to the last reading
position.

This closes #601 issue on Github.

Fixed Array.prototype.fill() when start object changes "this".

This fixed #589, #599 issues on Github.

Fixed String.prototype.replace(re) if re.exec() returns non-flat array.

This fixes #587 issue on Github.

Fixed static analyzer issues.

Refactored working with an object properties.

1) njs_object_prop_t is compacted from 72 to 40 bytes on 64bit
platforms.
2) njs_object_prop_define() is revorked to accomodate fast
property creation using njs_value_create_data_prop()
which corresponds to CreateDataProperty() from the specs.

Version bump.

Computed goto support added to vmcode.

Added tag 0.7.8 for changeset 3308415d7de8

Version 0.7.8.

Fixed labeled empty statement.

This fixes #593 issue on Github.

Added njs.memoryStats object.

njs.memoryStats.size is a number of bytes a VM claimed from the OS.

Fixed shell tests after changes in backtraces and function names.

Fixed break label for if statement.

This fixes #591 issue on Github.

Enabled successful tests which were skipped previously.

Refactored bound function calls according to the spec.

This fixes #533, #546, #579 issues on Github.

Fixed double declaration detection in modules.

Parser: simplified njs_parser_string_create() using existing API.

Improved population of process.env object.

1) Keys are always casted to upper case.
2) Keys and values are converted to safe Unicode strings.

Fixed parsing of environ variables when duplicate keys are present.

This closes #581 issue on Github.

Fixed njs_assert() macro.

Previously, the argument was always evaluated, even if
NJS_DEBUG was undefined.

Introduced njs_object_proto_lookup() where appropriate.

Removed aligned values which are not required since 0.6.0.

Style.

Fixed handling of unhandled promise rejection.

Previously, a direct pointer to the first element of an array of
rejected promise values was used to convert that element to a string.
This is not correct because that pointer may become invalid if rejected
promise values array is resized between invocation of "toString" and
"valueOf" methods which are called while converting the element to a
string.

The fix is to ensure that the rejected promise value is never changed.

This closes #580 issue on Github.

Fetch: added support for HEAD method.

This closes #577 issue on Github.

Modules: js_merge_conf is moved to shared library.

Modules: common code is moved to shared library.

Stream: introduced s.sendUpstream() and s.sendDownstream().

Stream: improved async callback support for s.send().

Previously, the "from_upstream" flag (introduced in b33aae5e8dc6) was
ignored for s.send() calls invoked directly from a body filter.
This makes the s.send() behaviour context dependent.

The fix is to always take "from_upstream" flag into account when it is
provided.

This fixed #552 issue on Github.

HTTP: adding a warning for ignored outgoing header assignments.

Introduced "name" instance property for a function object.

This closes #360 issue on Github.