node-opcua-address-space 2.184.8 → 2.186.0

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/data_access/semantics_changed.ts

@@ -104,7 +104,7 @@ export function notifySemanticsChangedIfNeeded(property: UAVariable): void {
 }
 
 /**
- * OPC 10000-5 6.4.31: besides the SemanticsChanged bit on the DataItem's next notification, the
+ * OPC 10000-5 v1.05.06 §6.4.33: besides the SemanticsChanged bit on the DataItem's next notification, the
  * Server reports a semantics change as a SemanticChangeEventType on the Server object, carrying
  * the affected Node and its TypeDefinition. A client subscribed to the Server's events learns of
  * the change without monitoring the DataItem itself.

package/impl/nodeset_tools/nodeset_to_records.ts

@@ -17,6 +17,7 @@ import type {
     UADataType,
     UAObject,
     UAReference,
+    UAReferenceType,
     UAVariable,
     UAVariableType
 } from "node-opcua-address-space-base";
@@ -76,6 +77,7 @@ import {
 import {
     _dumpVariantExtensionObjectValue_Body,
     coerceInt64ToInt32,
+    explicitInverseName,
     initXmlWriterEx,
     makeTypeXsd,
     sortByBrowseName
@@ -364,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);
@@ -430,7 +438,7 @@ class RecordExporter {
                 this.dumpDataType(node as UADataType);
                 break;
             case NodeClass.ReferenceType:
-                this.dumpReferenceType(node as BaseNode & { inverseName?: LocalizedText | null });
+                this.dumpReferenceType(node as UAReferenceType);
                 break;
             case NodeClass.View:
                 this.dumpView(node);
@@ -485,15 +493,12 @@ class RecordExporter {
         }
     }
 
-    private dumpReferenceType(node: BaseNode & { inverseName?: LocalizedText | null }): void {
+    private dumpReferenceType(node: UAReferenceType): void {
         this.markVisited(node);
         const record = this.common(node);
-        const isSymmetric = !node.inverseName || node.inverseName?.text === node.browseName?.name;
-        if (isSymmetric) {
-            record.symmetric = true;
-        } else {
-            record.inverseName = node.inverseName?.text || "";
-        }
+        if (node.symmetric) record.symmetric = true;
+        const inverseName = explicitInverseName(node);
+        if (inverseName !== undefined) record.inverseName = inverseName;
         this.records.push(record);
     }
 

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);
 }
@@ -1095,6 +1106,17 @@ function writeAliases(xw: XmlWriter, aliases: Record<string, NodeIdString>) {
     xw.endElement();
 }
 
+/**
+ * The InverseName the document gave, if any. A symmetric type has none, and the node stores a missing
+ * one as its browse name: writing that back would add an InverseName the source never had
+ * (machineVision's FromTransition is neither symmetric nor named the other way).
+ */
+export function explicitInverseName(referenceType: UAReferenceType): string | undefined {
+    if (referenceType.symmetric) return undefined;
+    const text = referenceType.inverseName?.text;
+    return text && text !== referenceType.browseName?.name ? text : undefined;
+}
+
 function dumpReferenceType(xw: XmlWriter, referenceType: UAReferenceType) {
     _markAsVisited(xw, referenceType);
 
@@ -1102,16 +1124,16 @@ function dumpReferenceType(xw: XmlWriter, referenceType: UAReferenceType) {
 
     dumpCommonAttributes(xw, referenceType);
 
-    const isSymmetric = !referenceType.inverseName || referenceType.inverseName?.text === referenceType.browseName?.name;
-    if (isSymmetric) {
+    if (referenceType.symmetric) {
         xw.writeAttribute("Symmetric", "true");
     }
 
     dumpCommonElements(xw, referenceType);
 
-    if (!isSymmetric) {
+    const inverseName = explicitInverseName(referenceType);
+    if (inverseName !== undefined) {
         xw.startElement("InverseName");
-        xw.text(referenceType.inverseName?.text || "");
+        xw.text(inverseName);
         xw.endElement();
     }
 

package/impl/ua_reference_type_impl.ts

@@ -120,7 +120,8 @@ export class UAReferenceTypeImpl extends BaseNodeImpl<BaseNodeEvents> implements
     constructor(options: UAReferenceTypeOptions) {
         super(options);
         this.isAbstract = options.isAbstract === undefined ? false : !!options.isAbstract;
-        this.symmetric = options.symmetric === undefined ? false : !!options.symmetric;
+        // without either, a type is symmetric: that is how it has always been exported
+        this.symmetric = options.symmetric === undefined ? !options.inverseName : !!options.symmetric;
         // Note: Inverse name is not required anymore in 1.0.4
         this.inverseName = new LocalizedText(options.inverseName || this.browseName.name);
 

package/impl/ua_variable_impl.ts

@@ -2002,7 +2002,7 @@ export class UAVariableImpl<T extends UAVariableEvents & ListenerSignature<T> =
         this.semantic_version = this.semantic_version + 1;
         (this as UAVariable).emit("semantic_changed");
         // the bit tells whoever monitors this DataItem; the event tells whoever monitors the
-        // Server object (OPC 10000-5 6.4.31). Both have to come from this one place.
+        // Server object (OPC 10000-5 v1.05.06 §6.4.33). Both have to come from this one place.
         raiseSemanticChangeEvent(this as UAVariable);
     }
 

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "node-opcua-address-space",
     "type": "module",
-    "version": "2.184.8",
+    "version": "2.186.0",
     "description": "pure nodejs OPCUA SDK - module address-space",
     "main": "./dist/api/index.js",
     "types": "./dist/api/index.d.ts",
@@ -23,35 +23,35 @@
         "@types/semver": "7.8.0",
         "chalk": "4.1.2",
         "dequeue": "^1.0.5",
-        "node-opcua-address-space-base": "2.184.8",
+        "node-opcua-address-space-base": "2.186.0",
         "node-opcua-assert": "2.184.0",
-        "node-opcua-basic-types": "2.184.1",
+        "node-opcua-basic-types": "2.185.0",
         "node-opcua-binary-stream": "2.184.1",
-        "node-opcua-client-dynamic-extension-object": "2.184.7",
-        "node-opcua-constants": "2.184.0",
-        "node-opcua-crypto": "5.10.1",
-        "node-opcua-data-access": "2.184.1",
-        "node-opcua-data-model": "2.184.1",
-        "node-opcua-data-value": "2.184.1",
+        "node-opcua-client-dynamic-extension-object": "2.185.0",
+        "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-debug": "2.184.0",
         "node-opcua-enum": "2.184.1",
-        "node-opcua-extension-object": "2.184.1",
-        "node-opcua-factory": "2.184.1",
-        "node-opcua-nodeid": "2.184.1",
-        "node-opcua-nodeset-ua": "2.184.8",
-        "node-opcua-numeric-range": "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.186.0",
+        "node-opcua-numeric-range": "2.185.0",
         "node-opcua-object-registry": "2.184.0",
-        "node-opcua-pseudo-session": "2.184.7",
-        "node-opcua-service-browse": "2.184.1",
-        "node-opcua-service-call": "2.184.1",
-        "node-opcua-service-history": "2.184.1",
-        "node-opcua-service-translate-browse-path": "2.184.1",
-        "node-opcua-service-write": "2.184.1",
+        "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.184.1",
+        "node-opcua-types": "2.185.0",
         "node-opcua-utils": "2.184.1",
-        "node-opcua-variant": "2.184.1",
+        "node-opcua-variant": "2.185.0",
         "node-opcua-xml2json": "2.184.1",
         "semver": "^7.8.5",
         "thenify-ex": "4.4.0",
@@ -61,10 +61,10 @@
         "humanize": "0.0.9",
         "node-opcua-benchmarker": "2.184.1",
         "node-opcua-leak-detector": "2.184.1",
-        "node-opcua-nodesets": "2.184.0",
-        "node-opcua-packet-analyzer": "2.184.1",
-        "node-opcua-schemas": "2.184.1",
-        "node-opcua-service-filter": "2.184.8",
+        "node-opcua-nodesets": "2.185.0",
+        "node-opcua-packet-analyzer": "2.185.0",
+        "node-opcua-schemas": "2.185.0",
+        "node-opcua-service-filter": "2.186.0",
         "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": "38de7c3000010c94c5c9755dded6a42d40bfe676",
+    "gitHead": "f39357ba4864bc83f210b40c7257e92afb0fa0ea",
     "files": [
         "dist",
         "distHelpers",