node-opcua-address-space 2.185.0 → 2.186.1

package/impl/base_node_impl.ts

@@ -180,6 +180,10 @@ export interface InternalBaseNodeOptions {
     rolePermissions?: RolePermissionTypeOptions[];
     /** "Draft" or "Deprecated" as the nodeset declared it; see BaseNode.releaseStatus */
     releaseStatus?: "Draft" | "Deprecated";
+    /** the `<Documentation>` link as the nodeset declared it; see BaseNode.nodesetDocumentation */
+    nodesetDocumentation?: string;
+    /** the `<Category>` elements as the nodeset declared them; see BaseNode.nodesetCategory */
+    nodesetCategory?: string[];
     /** the AccessRestrictions as declared, whatever this loader applies; see BaseNode */
     declaredAccessRestrictions?: string;
 }
@@ -225,6 +229,10 @@ export abstract class BaseNodeImpl<T extends BaseNodeEvents & ListenerSignature<
     /** see BaseNode.releaseStatus; only set when the nodeset declared one, so that it costs
      * nothing on the overwhelming majority of nodes, which are Released */
     public releaseStatus?: "Draft" | "Deprecated";
+    /** see BaseNode.nodesetDocumentation; only set when the nodeset declared one */
+    public nodesetDocumentation?: string;
+    /** see BaseNode.nodesetCategory; only set when the nodeset declared at least one */
+    public nodesetCategory?: string[];
     /** see BaseNode.declaredAccessRestrictions */
     public declaredAccessRestrictions?: string;
     private _accessRestrictions?: AccessRestrictionsFlag;
@@ -445,6 +453,12 @@ export abstract class BaseNodeImpl<T extends BaseNodeEvents & ListenerSignature<
         if (options.releaseStatus) {
             this.releaseStatus = options.releaseStatus;
         }
+        if (options.nodesetDocumentation) {
+            this.nodesetDocumentation = options.nodesetDocumentation;
+        }
+        if (options.nodesetCategory && options.nodesetCategory.length > 0) {
+            this.nodesetCategory = [...options.nodesetCategory];
+        }
         if (options.parentNodeId) {
             _private._declaredParentNodeId =
                 options.parentNodeId instanceof NodeId

package/impl/event_data.ts

@@ -7,7 +7,7 @@ import { assert } from "node-opcua-assert";
 import { coerceExpandedNodeId, NodeId, sameNodeId } from "node-opcua-nodeid";
 import { StatusCodes } from "node-opcua-status-code";
 import { type BrowsePath, BrowsePathResult } from "node-opcua-types";
-import { lowerFirstLetter } from "node-opcua-utils";
+import { lowerFirstLetter, setOwnProperty } from "node-opcua-utils";
 import { Variant, type VariantLike } from "node-opcua-variant";
 import type { EventField } from "./event_layout.js";
 
@@ -49,7 +49,7 @@ export class EventData implements IEventData {
     /** the value of one field of the layout */
     public _setField(field: EventField, variant: VariantLike): void {
         const value = Variant.coerce(variant);
-        (this as Record<string, unknown>)[field.lowerName] = value;
+        setOwnProperty(this as Record<string, unknown>, field.lowerName, value);
         if (!this.#sharedPaths) {
             this.#pathToNodeId.set(field.fullBrowsePath, field.node.nodeId);
         }

package/impl/nodeid_manager.ts

@@ -3,6 +3,7 @@ import { assert } from "node-opcua-assert";
 import { NodeClass, type QualifiedName, type QualifiedNameOptions } from "node-opcua-data-model";
 import { make_debugLog, make_warningLog } from "node-opcua-debug";
 import { makeNodeId, NodeId, type NodeIdLike, NodeIdType, resolveNodeId, sameNodeId } from "node-opcua-nodeid";
+import { setOwnProperty } from "node-opcua-utils";
 import { BaseNodeImpl } from "./base_node_impl.js";
 import { type ReferenceImpl, resolveReferenceType } from "./reference_impl.js";
 
@@ -146,7 +147,7 @@ export class NodeIdManager {
             NodeClass
         ][];
         for (const [name, value, nodeClass] of symbols2) {
-            this._cacheSymbolicName[name] = [value, nodeClass];
+            setOwnProperty(this._cacheSymbolicName, name, [value, nodeClass]);
             this._cacheSymbolicNameRev.add(value);
         }
     }
@@ -209,7 +210,10 @@ export class NodeIdManager {
             }
             const nodeId = this._constructNodeId(options);
             if (nodeId.identifierType === NodeIdType.NUMERIC && !cached) {
-                this._cacheSymbolicName[fullName] = [nodeId.value as number, options.nodeClass || NodeClass.Unspecified];
+                setOwnProperty(this._cacheSymbolicName, fullName, [
+                    nodeId.value as number,
+                    options.nodeClass || NodeClass.Unspecified
+                ]);
                 this._cacheSymbolicNameRev.add(nodeId.value as number);
             }
             return nodeId;
@@ -228,7 +232,10 @@ export class NodeIdManager {
             }
             const fullName = compose(fullParentName, prepareName(options.browseName));
             if (!this._cacheSymbolicName[fullName]) {
-                this._cacheSymbolicName[fullName] = [nodeId.value as number, options.nodeClass || NodeClass.Unspecified];
+                setOwnProperty(this._cacheSymbolicName, fullName, [
+                    nodeId.value as number,
+                    options.nodeClass || NodeClass.Unspecified
+                ]);
                 this._cacheSymbolicNameRev.add(nodeId.value as number);
             }
         }

package/impl/nodeset_tools/nodeset_to_records.ts

@@ -45,7 +45,7 @@ import {
     type StructureDefinition,
     StructureType
 } from "node-opcua-types";
-import { isNullOrUndefined } from "node-opcua-utils";
+import { isNullOrUndefined, setOwnProperty } from "node-opcua-utils";
 import { DataType, Variant, VariantArrayType, type VariantOptions } from "node-opcua-variant";
 import XMLWriter from "xml-writer";
 import { makeDefinitionMap } from "../../api/loader/decode_xml_extension_object.js";
@@ -274,14 +274,14 @@ class RecordExporter {
             if (nodeV.dataType && nodeV.dataType.value !== 0) {
                 const dataTypeName = this.b(this.resolveDataTypeName(nodeV.dataType));
                 if (dataTypeName && !aliases[dataTypeName]) {
-                    aliases[dataTypeName] = this.t(nodeV.dataType);
+                    setOwnProperty(aliases, dataTypeName, this.t(nodeV.dataType));
                 }
             }
         }
         for (const reference of node.allReferences()) {
             const key = this.b(getReferenceType(reference).browseName);
             // the XML export overwrites a reference-type alias each time it meets it; same value every time
-            aliases[key] = this.t(reference.referenceType);
+            setOwnProperty(aliases, key, this.t(reference.referenceType));
         }
     }
 
@@ -366,6 +366,12 @@ class RecordExporter {
         if (node.releaseStatus) {
             record.releaseStatus = node.releaseStatus;
         }
+        if (node.nodesetCategory && node.nodesetCategory.length > 0) {
+            record.category = [...node.nodesetCategory];
+        }
+        if (node.nodesetDocumentation) {
+            record.documentation = node.nodesetDocumentation;
+        }
         const parentNode = this.parentOf(node);
         if (parentNode && parentNode.nodeId.namespace <= node.nodeId.namespace) {
             record.parentNodeId = this.t(parentNode.nodeId);

package/impl/nodeset_tools/nodeset_to_xml.ts

@@ -88,6 +88,16 @@ function _dumpDescription(xw: XmlWriter, node: { description?: LocalizedText }):
         xw.startElement("Description").text(desc).endElement();
     }
 }
+// what the working group filed the node under and where the specification defines it: nothing
+// in the address space acts on either, but the document said them
+function _dumpCategoryAndDocumentation(xw: XmlWriter, node: BaseNode): void {
+    for (const category of node.nodesetCategory ?? []) {
+        xw.startElement("Category").text(category).endElement();
+    }
+    if (node.nodesetDocumentation) {
+        xw.startElement("Documentation").text(node.nodesetDocumentation).endElement();
+    }
+}
 
 function hasHigherPriorityThan(namespaceIndex1: number, namespaceIndex2: number, priorityTable: number[]) {
     const order1 = priorityTable[namespaceIndex1];
@@ -757,6 +767,7 @@ function _dumpRolePermissions(xw: XmlWriter, node: BaseNode) {
 function dumpCommonElements(xw: XmlWriter, node: BaseNode) {
     _dumpDisplayName(xw, node);
     _dumpDescription(xw, node);
+    _dumpCategoryAndDocumentation(xw, node);
     _dumpReferences(xw, node);
     _dumpRolePermissions(xw, node);
 }

package/impl/ua_data_type_impl.ts

@@ -21,6 +21,7 @@ import {
     type StructureFieldOptions,
     StructureType
 } from "node-opcua-types";
+import { setOwnProperty } from "node-opcua-utils";
 import { DataType } from "node-opcua-variant";
 import type { ExtensionObjectConstructorFuncWithSchema } from "../api/interfaces/extension_object_constructor.js";
 import { SessionContext } from "../api/session_context.js";
@@ -279,7 +280,7 @@ export class UADataTypeImpl extends BaseNodeImpl implements UADataType {
             valueIndex: {}
         };
         for (const e of definition) {
-            indexes.nameIndex[e.name] = e;
+            setOwnProperty(indexes.nameIndex, e.name, e);
             indexes.valueIndex[e.value] = e;
         }
         return indexes;

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "node-opcua-address-space",
     "type": "module",
-    "version": "2.185.0",
+    "version": "2.186.1",
     "description": "pure nodejs OPCUA SDK - module address-space",
     "main": "./dist/api/index.js",
     "types": "./dist/api/index.d.ts",
@@ -23,48 +23,48 @@
         "@types/semver": "7.8.0",
         "chalk": "4.1.2",
         "dequeue": "^1.0.5",
-        "node-opcua-address-space-base": "2.185.0",
+        "node-opcua-address-space-base": "2.186.1",
         "node-opcua-assert": "2.184.0",
-        "node-opcua-basic-types": "2.185.0",
-        "node-opcua-binary-stream": "2.184.1",
-        "node-opcua-client-dynamic-extension-object": "2.185.0",
+        "node-opcua-basic-types": "2.186.1",
+        "node-opcua-binary-stream": "2.186.1",
+        "node-opcua-client-dynamic-extension-object": "2.186.1",
         "node-opcua-constants": "2.185.0",
         "node-opcua-crypto": "6.0.0",
-        "node-opcua-data-access": "2.185.0",
-        "node-opcua-data-model": "2.185.0",
-        "node-opcua-data-value": "2.185.0",
-        "node-opcua-date-time": "2.184.1",
+        "node-opcua-data-access": "2.186.1",
+        "node-opcua-data-model": "2.186.1",
+        "node-opcua-data-value": "2.186.1",
+        "node-opcua-date-time": "2.186.1",
         "node-opcua-debug": "2.184.0",
-        "node-opcua-enum": "2.184.1",
-        "node-opcua-extension-object": "2.185.0",
-        "node-opcua-factory": "2.185.0",
-        "node-opcua-nodeid": "2.185.0",
-        "node-opcua-nodeset-ua": "2.185.0",
-        "node-opcua-numeric-range": "2.185.0",
+        "node-opcua-enum": "2.186.1",
+        "node-opcua-extension-object": "2.186.1",
+        "node-opcua-factory": "2.186.1",
+        "node-opcua-nodeid": "2.186.1",
+        "node-opcua-nodeset-ua": "2.186.1",
+        "node-opcua-numeric-range": "2.186.1",
         "node-opcua-object-registry": "2.184.0",
-        "node-opcua-pseudo-session": "2.185.0",
-        "node-opcua-service-browse": "2.185.0",
-        "node-opcua-service-call": "2.185.0",
-        "node-opcua-service-history": "2.185.0",
-        "node-opcua-service-translate-browse-path": "2.185.0",
-        "node-opcua-service-write": "2.185.0",
-        "node-opcua-status-code": "2.184.1",
-        "node-opcua-types": "2.185.0",
-        "node-opcua-utils": "2.184.1",
-        "node-opcua-variant": "2.185.0",
-        "node-opcua-xml2json": "2.184.1",
+        "node-opcua-pseudo-session": "2.186.1",
+        "node-opcua-service-browse": "2.186.1",
+        "node-opcua-service-call": "2.186.1",
+        "node-opcua-service-history": "2.186.1",
+        "node-opcua-service-translate-browse-path": "2.186.1",
+        "node-opcua-service-write": "2.186.1",
+        "node-opcua-status-code": "2.186.1",
+        "node-opcua-types": "2.186.1",
+        "node-opcua-utils": "2.186.1",
+        "node-opcua-variant": "2.186.1",
+        "node-opcua-xml2json": "2.186.1",
         "semver": "^7.8.5",
         "thenify-ex": "4.4.0",
         "xml-writer": "^1.7.0"
     },
     "devDependencies": {
         "humanize": "0.0.9",
-        "node-opcua-benchmarker": "2.184.1",
+        "node-opcua-benchmarker": "2.186.1",
         "node-opcua-leak-detector": "2.184.1",
         "node-opcua-nodesets": "2.185.0",
-        "node-opcua-packet-analyzer": "2.185.0",
-        "node-opcua-schemas": "2.185.0",
-        "node-opcua-service-filter": "2.185.0",
+        "node-opcua-packet-analyzer": "2.186.1",
+        "node-opcua-schemas": "2.186.1",
+        "node-opcua-service-filter": "2.186.1",
         "node-opcua-test-fixtures": "2.184.0",
         "node-opcua-test-helpers": "2.184.0"
     },
@@ -83,7 +83,7 @@
         "internet of things"
     ],
     "homepage": "http://node-opcua.github.io/",
-    "gitHead": "7869fea1a598282415d32535dc5d5da1347f0ba7",
+    "gitHead": "c4b15b4ca645101b2d656a75b2ea9a8a843d25b5",
     "files": [
         "dist",
         "distHelpers",