node-opcua-nodeid 2.125.0 → 2.133.0

package/dist/expanded_nodeid.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 /**
  * @module node-opcua-nodeid
  */
@@ -27,17 +26,8 @@ import { NodeId, NodeIdType } from "./nodeid";
  * NamespaceUri. The ServerIndex flag in the NodeId encoding byte indicates whether the
  * ServerIndex is present in the stream. The ServerIndex is omitted if it is equal to zero.
  *
- * @class  ExpandedNodeId
- * @extends NodeId
  *
  *
- *
- * @param identifierType   - the nodeID type
- * @param value            - the node id value. The type of Value depends on identifierType.
- * @param namespace        - the index of the related namespace (optional , default value = 0 )
- * @param namespaceUri     - NamespaceUri
- * @param serverIndex      - the server Index
- * @constructor
  */
 export declare class ExpandedNodeId extends NodeId {
     static nullExpandedNodeId: ExpandedNodeId;
@@ -45,24 +35,22 @@ export declare class ExpandedNodeId extends NodeId {
     namespaceUri: null | string;
     serverIndex: number;
     constructor(forDeserialization: null);
-    constructor(identifierType: NodeIdType, value: number | string | Guid | Buffer, namespace: number, namespaceUri?: null | string, serverIndex?: number);
     /**
-     * @method toString
-     * @return {string}
+     * @param identifierType   - the nodeID type
+     * @param value            - the node id value. The type of Value depends on identifierType.
+     * @param namespace        - the index of the related namespace (optional , default value = 0 )
+     * @param namespaceUri     - NamespaceUri
+     * @param serverIndex      - the server Index
      */
+    constructor(identifierType: NodeIdType, value: number | string | Guid | Buffer, namespace: number, namespaceUri?: null | string, serverIndex?: number);
     toString(): string;
     /**
-     * convert nodeId to a JSON string. same as {@link NodeId#toString }
-     * @method  toJSON
-     * @return {String}
+     * convert nodeId to a JSON string. same as {@link toString }
      */
     toJSON(): any;
 }
 export declare function coerceExpandedNodeId(value: unknown): ExpandedNodeId;
 /**
- * @method  makeExpandedNodeId
- * @param  value
- * @param [namespace=0] the namespace
- * @return {ExpandedNodeId}
+ * create an expanded nodeId
  */
 export declare function makeExpandedNodeId(value: unknown, namespace?: number): ExpandedNodeId;

package/dist/expanded_nodeid.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.makeExpandedNodeId = exports.coerceExpandedNodeId = exports.ExpandedNodeId = void 0;
+exports.ExpandedNodeId = void 0;
+exports.coerceExpandedNodeId = coerceExpandedNodeId;
+exports.makeExpandedNodeId = makeExpandedNodeId;
 const nodeid_1 = require("./nodeid");
 /**
  * An ExpandedNodeId extends the NodeId structure.
@@ -25,17 +27,8 @@ const nodeid_1 = require("./nodeid");
  * NamespaceUri. The ServerIndex flag in the NodeId encoding byte indicates whether the
  * ServerIndex is present in the stream. The ServerIndex is omitted if it is equal to zero.
  *
- * @class  ExpandedNodeId
- * @extends NodeId
  *
  *
- *
- * @param identifierType   - the nodeID type
- * @param value            - the node id value. The type of Value depends on identifierType.
- * @param namespace        - the index of the related namespace (optional , default value = 0 )
- * @param namespaceUri     - NamespaceUri
- * @param serverIndex      - the server Index
- * @constructor
  */
 class ExpandedNodeId extends nodeid_1.NodeId {
     static fromNodeId(nodeId, namespaceUri, serverIndex) {
@@ -46,10 +39,6 @@ class ExpandedNodeId extends nodeid_1.NodeId {
         this.namespaceUri = namespaceUri || null;
         this.serverIndex = serverIndex || 0;
     }
-    /**
-     * @method toString
-     * @return {string}
-     */
     toString() {
         let str = nodeid_1.NodeId.prototype.toString.call(this);
         if (this.namespaceUri) {
@@ -61,9 +50,7 @@ class ExpandedNodeId extends nodeid_1.NodeId {
         return str;
     }
     /**
-     * convert nodeId to a JSON string. same as {@link NodeId#toString }
-     * @method  toJSON
-     * @return {String}
+     * convert nodeId to a JSON string. same as {@link toString }
      */
     toJSON() {
         return this.toString();
@@ -75,12 +62,8 @@ function coerceExpandedNodeId(value) {
     const n = (0, nodeid_1.coerceNodeId)(value);
     return new ExpandedNodeId(n.identifierType, n.value, n.namespace, /*namespaceUri*/ null, /*serverIndex*/ 0);
 }
-exports.coerceExpandedNodeId = coerceExpandedNodeId;
 /**
- * @method  makeExpandedNodeId
- * @param  value
- * @param [namespace=0] the namespace
- * @return {ExpandedNodeId}
+ * create an expanded nodeId
  */
 function makeExpandedNodeId(value, namespace) {
     if (value === undefined && namespace === undefined) {
@@ -106,5 +89,4 @@ function makeExpandedNodeId(value, namespace) {
     namespace = namespace || 0;
     return new ExpandedNodeId(nodeid_1.NodeIdType.NUMERIC, valueInt, namespace, namespaceUri, serverIndex);
 }
-exports.makeExpandedNodeId = makeExpandedNodeId;
 //# sourceMappingURL=expanded_nodeid.js.map

package/dist/expanded_nodeid.js.map

@@ -1 +1 @@
-{"version":3,"file":"expanded_nodeid.js","sourceRoot":"","sources":["../source/expanded_nodeid.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"expanded_nodeid.js","sourceRoot":"","sources":["../source/expanded_nodeid.ts"],"names":[],"mappings":"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"}

package/dist/nodeid.d.ts

@@ -1,90 +1,124 @@
-/// <reference types="node" />
 import { Guid } from "node-opcua-guid";
 /**
  * `NodeIdType` an enumeration that specifies the possible types of a `NodeId` value.
  */
 export declare enum NodeIdType {
-    /**
-     * @static
-     * @property NUMERIC
-     * @default 0x1
-     */
     NUMERIC = 1,
-    /**
-     * @static
-     * @property STRING
-     * @default 0x2
-     */
     STRING = 2,
-    /**
-     * @static
-     * @property GUID
-     * @default 0x3
-     */
     GUID = 3,
-    /**
-     * @static
-     * @property BYTESTRING
-     * @default 0x4
-     */
     BYTESTRING = 4
 }
+/**
+ * `NodeId` specialization for numeric nodeIds.
+ */
 export interface INodeIdNumeric extends NodeId {
     identifierType: NodeIdType.NUMERIC;
     value: number;
 }
+/**
+ * `NodeId` specialization for GUID  nodeIds.
+ */
 export interface INodeIdGuid extends NodeId {
     identifierType: NodeIdType.GUID;
     value: string;
 }
+/**
+ * `NodeId` specialization for ByteString  nodeIds (opaque).
+ */
 export interface INodeIdByteString extends NodeId {
     identifierType: NodeIdType.BYTESTRING;
     value: Buffer;
 }
+/**
+ * `NodeId` specialization for String  nodeId.
+ */
 export interface INodeIdString extends NodeId {
     identifierType: NodeIdType.STRING;
     value: string;
 }
+/**
+ * `NodeId` specialization for all possible types of NodeIds.
+ */
 export type INodeId = INodeIdNumeric | INodeIdGuid | INodeIdString | INodeIdByteString;
 /**
- * Construct a node ID
  *
- * @class NodeId
- * @example
+ * This class holds a OPC-UA node identifier.
+ *
+ * Nodes are unambiguously identified using a constructed
+ * identifier called the NodeId. Some Servers may accept
+ * alternative NodeIds in addition to the canonical NodeId
+ * represented in this Attribute.
+ *
+ * A Server shall persist the NodeId of a Node, that is,
+ * it shall not generate new
+ * NodeIds when rebooting.
  *
- * ``` javascript
- *    const nodeId = new NodeId(NodeIdType.NUMERIC,123,1);
- *    ```
- * @constructor
  */
 export declare class NodeId {
     static NodeIdType: typeof NodeIdType;
     static nullNodeId: NodeId;
     static resolveNodeId: (a: string | NodeId) => NodeId;
+    /**
+     */
     static sameNodeId: (n1: NodeId, n2: NodeId) => boolean;
     identifierType: NodeIdType;
     value: number | string | Buffer | Guid;
     namespace: number;
     /**
+     * construct a node Id from a type, a value and a namespace index.
+     *
      * @param identifierType   - the nodeID type
      * @param value            - the node id value. The type of Value depends on identifierType.
      * @param namespace        - the index of the related namespace (optional , default value = 0 )
+     *
+     * @example
+     *
+     * ```javascript
+     * const nodeId = new NodeId(NodeIdType.NUMERIC,123,1);
+     * ```
      */
     constructor(identifierType?: NodeIdType | null, value?: number | string | Buffer | Guid, namespace?: number);
     /**
      * get the string representation of the nodeID.
      *
-     * @method toString
      * @example
      *
-     *    ``` javascript
-     *    const nodeid = new NodeId(NodeIdType.NUMERIC, 123,1);
-     *    console.log(nodeid.toString());
-     *    ```
+     * by default, toString will return the "ns=" representation
+     *
+     * ```javascript
+     * const nodeid = new NodeId(NodeIdType.NUMERIC, 123,1);
+     * console.log(nodeid.toString());
+     * ```
+     *
+     *  ```
+     *  >"ns=1;i=123"
+     *  ```
+     * @example
+     *
+     *  toString can also be used to make the nsu= version of the nodeid.
+     *
+     *  ```javascript
+     *  const namespaceArray = ["http://opcfoundation.com/UA/","http://mynamespace2"];
+     *  const nodeid = new NodeId(NodeIdType.STRING, "Hello",1);
+     *  console.log(nodeid.toString({namespaceArray}));
+     *  ```
+     *  ```
+     *  >"nsu=http://mynamespace;i=123"
+     *  ```
+     * @example
+     *
+     *  passing an addressSpace to the toString options will decorate the nodeId
+     *  with the BrowseName of the node.
+     *
+     *  ```javascript
+     * const addressSpace = getAddressSpace();
+     * const nodeid = new NodeId(NodeIdType.NUMERIC, 123,1);
+     * console.log(nodeid.toString({addressSpace}));
+     * ```
+     * ```
+     * >"nsu=http://mynamespace;i=123 (MyBrowseName)"
+     * ```
      *
-     *    ```
-     *    >"ns=1;i=123"
-     *    ```
      *
      * @param [options.addressSpace] {AddressSpace}
      * @return {String}
@@ -94,7 +128,7 @@ export declare class NodeId {
         namespaceArray?: string[];
     }): string;
     /**
-     * convert nodeId to a JSON string. same as {@link NodeId#toString }
+     * convert nodeId to a JSON string. same as {@link NodeId.toString }
      */
     toJSON(options?: {
         namespaceArray?: string[];
@@ -105,45 +139,84 @@ export declare class NodeId {
      */
     isEmpty(): boolean;
 }
+/**
+ * anything that could be turned into a nodeId
+ */
 export type NodeIdLike = string | NodeId | number;
+/**
+ *
+ */
 export interface ResolveNodeIdOptions {
     namespaceArray?: string[];
     defaultNamespaceIndex?: number;
 }
 /**
  * Convert a value into a nodeId:
- * @class opcua
- * @method coerceNodeId
- * @static
  *
  * @description:
  *    - if nodeId is a string of form : "i=1234"  => nodeId({value=1234, identifierType: NodeIdType.NUMERIC})
  *    - if nodeId is a string of form : "s=foo"   => nodeId({value="foo", identifierType: NodeIdType.STRING})
  *    - if nodeId is a string of form : "b=ABCD=" => nodeId({value=decodeBase64("ABCD="), identifierType: NodeIdType.BYTESTRING})
  *    - if nodeId is a {@link NodeId} :  coerceNodeId returns value
- * @param value
- * @param namespaceOptions {number}
- * @param namespaceOptions.namespace {number}
- * @param namespaceOptions.namespaceArray {number}
  *
  */
 export declare function coerceNodeId(value: unknown, namespaceOptions?: number | ResolveNodeIdOptions): NodeId;
 /**
  * construct a node Id from a value and a namespace.
- * @class opcua
- * @method makeNodeId
- * @static
+ *
  * @param {String|Buffer} value
- * @param [namespace]=0 {Number} the node id namespace
+ * @param [namespace]=0 {Number} optional (default=0), the node id namespace
  * @return {NodeId}
  */
 export declare function makeNodeId(value: string | Buffer | number, namespace?: number): NodeId;
 /**
- * @class opcua
- * @method resolveNodeId
- * @static
- * @param nodeIdOrString
- * @return the nodeId
+ * resolveNodeId can be helpful to convert a wellknown Node Name to a nodeid
+ * if a wellknown node name cannot be detected, the function falls back to
+ * calling coerceNodeId {@link coerceNodeId}.
+ *
+ * @example
+ * ```javascript
+ * const nodeId = resolveNodeId("ObjectsFolder");
+ * console.log(nodeId.toString());
+ * ```
+ * ```text
+ * >ns=0;i=85
+ * ```
+ *
+ * ```javascript
+ * const nodeId = resolveNodeId("HasComponent");
+ * console.log(nodeId.toString());
+ * ```
+ * ```text
+ * >ns=0;i=33
+ * ```
+ *
+ * ```javascript
+ * const nodeId = resolveNodeId("ns=1;i=4444");
+ * console.log(nodeId.toString());
+ * ```
+ * ```text
+ * >ns=1;i=4444
+ * ```
+ *
  */
 export declare function resolveNodeId(nodeIdOrString: NodeIdLike, options?: ResolveNodeIdOptions): NodeId;
+/**
+ *
+ * The sameNodeId function is used to compare two NodeId objects to
+ * determine if they are identical. This comparison is based on the
+ * identifier type, namespace, and value of the NodeId objects.
+ *
+
+ *
+ * @return {boolean} Returns true if the two NodeId objects are
+ * identical, otherwise returns false.
+ *
+ * @example
+ * ```javascript
+ * const nodeId1: NodeId = new NodeId(NodeIdType.STRING, "example", 1);
+ * const nodeId2: NodeId = coerceNodeId("ns=1;s=example");
+ * const areSame = sameNodeId(nodeId1, nodeId2); // returns true
+ * ```
+ */
 export declare function sameNodeId(n1: NodeId, n2: NodeId): boolean;

package/dist/nodeid.js

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sameNodeId = exports.resolveNodeId = exports.makeNodeId = exports.coerceNodeId = exports.NodeId = exports.NodeIdType = void 0;
+exports.NodeId = exports.NodeIdType = void 0;
+exports.coerceNodeId = coerceNodeId;
+exports.makeNodeId = makeNodeId;
+exports.resolveNodeId = resolveNodeId;
+exports.sameNodeId = sameNodeId;
 /* eslint-disable complexity */
 /**
  * @module node-opcua-nodeid
@@ -8,67 +12,58 @@ exports.sameNodeId = exports.resolveNodeId = exports.makeNodeId = exports.coerce
 const node_opcua_assert_1 = require("node-opcua-assert");
 const node_opcua_constants_1 = require("node-opcua-constants");
 const node_opcua_guid_1 = require("node-opcua-guid");
+const doDebug = false;
 /**
  * `NodeIdType` an enumeration that specifies the possible types of a `NodeId` value.
  */
 var NodeIdType;
 (function (NodeIdType) {
-    /**
-     * @static
-     * @property NUMERIC
-     * @default 0x1
-     */
     NodeIdType[NodeIdType["NUMERIC"] = 1] = "NUMERIC";
-    /**
-     * @static
-     * @property STRING
-     * @default 0x2
-     */
     NodeIdType[NodeIdType["STRING"] = 2] = "STRING";
-    /**
-     * @static
-     * @property GUID
-     * @default 0x3
-     */
     NodeIdType[NodeIdType["GUID"] = 3] = "GUID";
-    /**
-     * @static
-     * @property BYTESTRING
-     * @default 0x4
-     */
     NodeIdType[NodeIdType["BYTESTRING"] = 4] = "BYTESTRING";
 })(NodeIdType || (exports.NodeIdType = NodeIdType = {}));
-/*function defaultValue(identifierType: NodeIdType.BYTESTRING): null;
-function defaultValue(identifierType: NodeIdType.STRING): null;
-function defaultValue(identifierType: NodeIdType.NUMERIC): 0;
-function defaultValue(identifierType: NodeIdType.GUID): null;
-*/
+// function defaultValue(identifierType: NodeIdType.BYTESTRING): null;
+// function defaultValue(identifierType: NodeIdType.STRING): "";
+// function defaultValue(identifierType: NodeIdType.NUMERIC): 0;
+// function defaultValue(identifierType: NodeIdType.GUID): string;
 function defaultValue(identifierType) {
     switch (identifierType) {
         case NodeIdType.GUID: return node_opcua_guid_1.emptyGuid;
         case NodeIdType.BYTESTRING: return null; // Buffer.alloc(0);
         case NodeIdType.STRING: return "";
         case NodeIdType.NUMERIC: return 0;
+        default:
+            throw new Error("invalid identifierType");
     }
 }
-const doDebug = false;
 /**
- * Construct a node ID
  *
- * @class NodeId
- * @example
+ * This class holds a OPC-UA node identifier.
+ *
+ * Nodes are unambiguously identified using a constructed
+ * identifier called the NodeId. Some Servers may accept
+ * alternative NodeIds in addition to the canonical NodeId
+ * represented in this Attribute.
+ *
+ * A Server shall persist the NodeId of a Node, that is,
+ * it shall not generate new
+ * NodeIds when rebooting.
  *
- * ``` javascript
- *    const nodeId = new NodeId(NodeIdType.NUMERIC,123,1);
- *    ```
- * @constructor
  */
 class NodeId {
-    ;
     /**
+     * construct a node Id from a type, a value and a namespace index.
+     *
      * @param identifierType   - the nodeID type
      * @param value            - the node id value. The type of Value depends on identifierType.
      * @param namespace        - the index of the related namespace (optional , default value = 0 )
+     *
+     * @example
+     *
+     * ```javascript
+     * const nodeId = new NodeId(NodeIdType.NUMERIC,123,1);
+     * ```
      */
     constructor(identifierType, value, namespace) {
         if (identifierType === null || identifierType === undefined) {
@@ -82,7 +77,8 @@ class NodeId {
         this.namespace = namespace || 0;
         // namespace shall be a UInt16
         (0, node_opcua_assert_1.assert)(this.namespace >= 0 && this.namespace <= 0xffff, "NodeId: invalid namespace value");
-        (0, node_opcua_assert_1.assert)(this.identifierType !== NodeIdType.NUMERIC || (this.value !== null && this.value >= 0 && this.value <= 0xffffffff));
+        (0, node_opcua_assert_1.assert)(this.identifierType !== NodeIdType.NUMERIC ||
+            (this.value !== null && this.value >= 0 && this.value <= 0xffffffff));
         (0, node_opcua_assert_1.assert)(this.identifierType !== NodeIdType.GUID || (0, node_opcua_guid_1.isValidGuid)(this.value), "NodeId: Guid is invalid");
         (0, node_opcua_assert_1.assert)(this.identifierType !== NodeIdType.STRING || typeof this.value === "string", "cannot  empty string");
         if (this.identifierType === NodeIdType.GUID) {
@@ -92,25 +88,54 @@ class NodeId {
     /**
      * get the string representation of the nodeID.
      *
-     * @method toString
      * @example
      *
-     *    ``` javascript
-     *    const nodeid = new NodeId(NodeIdType.NUMERIC, 123,1);
-     *    console.log(nodeid.toString());
-     *    ```
+     * by default, toString will return the "ns=" representation
+     *
+     * ```javascript
+     * const nodeid = new NodeId(NodeIdType.NUMERIC, 123,1);
+     * console.log(nodeid.toString());
+     * ```
+     *
+     *  ```
+     *  >"ns=1;i=123"
+     *  ```
+     * @example
+     *
+     *  toString can also be used to make the nsu= version of the nodeid.
+     *
+     *  ```javascript
+     *  const namespaceArray = ["http://opcfoundation.com/UA/","http://mynamespace2"];
+     *  const nodeid = new NodeId(NodeIdType.STRING, "Hello",1);
+     *  console.log(nodeid.toString({namespaceArray}));
+     *  ```
+     *  ```
+     *  >"nsu=http://mynamespace;i=123"
+     *  ```
+     * @example
+     *
+     *  passing an addressSpace to the toString options will decorate the nodeId
+     *  with the BrowseName of the node.
+     *
+     *  ```javascript
+     * const addressSpace = getAddressSpace();
+     * const nodeid = new NodeId(NodeIdType.NUMERIC, 123,1);
+     * console.log(nodeid.toString({addressSpace}));
+     * ```
+     * ```
+     * >"nsu=http://mynamespace;i=123 (MyBrowseName)"
+     * ```
      *
-     *    ```
-     *    >"ns=1;i=123"
-     *    ```
      *
      * @param [options.addressSpace] {AddressSpace}
      * @return {String}
      */
     toString(options) {
         const addressSpace = options ? options.addressSpace : null;
-        const namespacePart = options?.namespaceArray ?
-            (this.namespace == 0 ? "" : `nsu=${options.namespaceArray[this.namespace] || `<unknown namespace with index ${this.namespace}>`};`)
+        const namespacePart = options?.namespaceArray
+            ? this.namespace == 0
+                ? ""
+                : `nsu=${options.namespaceArray[this.namespace] || `<unknown namespace with index ${this.namespace}>`};`
             : `ns=${this.namespace};`;
         let str;
         const _this = this;
@@ -150,7 +175,7 @@ class NodeId {
         return str;
     }
     /**
-     * convert nodeId to a JSON string. same as {@link NodeId#toString }
+     * convert nodeId to a JSON string. same as {@link NodeId.toString }
      */
     toJSON(options) {
         return this.toString(options);
@@ -183,6 +208,9 @@ class NodeId {
 }
 exports.NodeId = NodeId;
 NodeId.NodeIdType = NodeIdType;
+/**
+ * a fixed instance of a null NodeId
+ */
 NodeId.nullNodeId = new Proxy(new NodeId(NodeIdType.NUMERIC, 0, 0), {
     get: (target, prop) => {
         return target[prop];
@@ -191,6 +219,9 @@ NodeId.nullNodeId = new Proxy(new NodeId(NodeIdType.NUMERIC, 0, 0), {
         throw new Error("Cannot assign a value to constant NodeId.nullNodeId");
     }
 });
+/**
+ * @private
+ */
 const regexNamespaceI = /ns=([0-9]+);i=([0-9]+)/;
 const regexNamespaceS = /ns=([0-9]+);s=(.*)/;
 const regexNamespaceB = /ns=([0-9]+);b=(.*)/;
@@ -202,22 +233,14 @@ const regexNamespaceNSU_B = /nsu=(.+);b=(.*)/;
 const regexNamespaceNSU_G = /nsu=(.+);g=([0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12})/;
 /**
  * Convert a value into a nodeId:
- * @class opcua
- * @method coerceNodeId
- * @static
  *
  * @description:
  *    - if nodeId is a string of form : "i=1234"  => nodeId({value=1234, identifierType: NodeIdType.NUMERIC})
  *    - if nodeId is a string of form : "s=foo"   => nodeId({value="foo", identifierType: NodeIdType.STRING})
  *    - if nodeId is a string of form : "b=ABCD=" => nodeId({value=decodeBase64("ABCD="), identifierType: NodeIdType.BYTESTRING})
  *    - if nodeId is a {@link NodeId} :  coerceNodeId returns value
- * @param value
- * @param namespaceOptions {number}
- * @param namespaceOptions.namespace {number}
- * @param namespaceOptions.namespaceArray {number}
  *
  */
-// eslint-disable-next-line max-statements
 function coerceNodeId(value, namespaceOptions) {
     let matches;
     let twoFirst;
@@ -301,15 +324,12 @@ function coerceNodeId(value, namespaceOptions) {
     }
     return new NodeId(identifierType, value, namespace);
 }
-exports.coerceNodeId = coerceNodeId;
 const regEx1 = /^(s|g|b|i|ns)=/;
 /**
  * construct a node Id from a value and a namespace.
- * @class opcua
- * @method makeNodeId
- * @static
+ *
  * @param {String|Buffer} value
- * @param [namespace]=0 {Number} the node id namespace
+ * @param [namespace]=0 {Number} optional (default=0), the node id namespace
  * @return {NodeId}
  */
 function makeNodeId(value, namespace) {
@@ -337,7 +357,6 @@ function makeNodeId(value, namespace) {
     const nodeId = new NodeId(identifierType, value, namespace);
     return nodeId;
 }
-exports.makeNodeId = makeNodeId;
 // reverse maps
 let _nodeIdToNameIndex = {};
 let _nameToNodeIdIndex = {};
@@ -366,11 +385,35 @@ function reverse_map(nodeId) {
     return _nodeIdToNameIndex[nodeId];
 }
 /**
- * @class opcua
- * @method resolveNodeId
- * @static
- * @param nodeIdOrString
- * @return the nodeId
+ * resolveNodeId can be helpful to convert a wellknown Node Name to a nodeid
+ * if a wellknown node name cannot be detected, the function falls back to
+ * calling coerceNodeId {@link coerceNodeId}.
+ *
+ * @example
+ * ```javascript
+ * const nodeId = resolveNodeId("ObjectsFolder");
+ * console.log(nodeId.toString());
+ * ```
+ * ```text
+ * >ns=0;i=85
+ * ```
+ *
+ * ```javascript
+ * const nodeId = resolveNodeId("HasComponent");
+ * console.log(nodeId.toString());
+ * ```
+ * ```text
+ * >ns=0;i=33
+ * ```
+ *
+ * ```javascript
+ * const nodeId = resolveNodeId("ns=1;i=4444");
+ * console.log(nodeId.toString());
+ * ```
+ * ```text
+ * >ns=1;i=4444
+ * ```
+ *
  */
 function resolveNodeId(nodeIdOrString, options) {
     let nodeId;
@@ -383,8 +426,25 @@ function resolveNodeId(nodeIdOrString, options) {
     }
     return nodeId;
 }
-exports.resolveNodeId = resolveNodeId;
 NodeId.resolveNodeId = resolveNodeId;
+/**
+ *
+ * The sameNodeId function is used to compare two NodeId objects to
+ * determine if they are identical. This comparison is based on the
+ * identifier type, namespace, and value of the NodeId objects.
+ *
+
+ *
+ * @return {boolean} Returns true if the two NodeId objects are
+ * identical, otherwise returns false.
+ *
+ * @example
+ * ```javascript
+ * const nodeId1: NodeId = new NodeId(NodeIdType.STRING, "example", 1);
+ * const nodeId2: NodeId = coerceNodeId("ns=1;s=example");
+ * const areSame = sameNodeId(nodeId1, nodeId2); // returns true
+ * ```
+ */
 function sameNodeId(n1, n2) {
     if (n1.identifierType !== n2.identifierType) {
         return false;
@@ -403,6 +463,5 @@ function sameNodeId(n1, n2) {
             throw new Error("Invalid identifier type");
     }
 }
-exports.sameNodeId = sameNodeId;
 NodeId.sameNodeId = sameNodeId;
 //# sourceMappingURL=nodeid.js.map

package/dist/nodeid.js.map

@@ -1 +1 @@
-{"version":3,"file":"nodeid.js","sourceRoot":"","sources":["../source/nodeid.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"nodeid.js","sourceRoot":"","sources":["../source/nodeid.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -2,7 +2,7 @@
     "name": "node-opcua-nodeid",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
-    "version": "2.125.0",
+    "version": "2.133.0",
     "description": "pure nodejs OPCUA SDK - module nodeid",
     "scripts": {
         "build": "tsc -b",
@@ -13,12 +13,11 @@
     "dependencies": {
         "node-opcua-assert": "2.120.0",
         "node-opcua-constants": "2.125.0",
-        "node-opcua-guid": "2.120.0"
+        "node-opcua-guid": "2.133.0"
     },
     "devDependencies": {
-        "node-opcua-benchmarker": "2.125.0",
-        "node-opcua-debug": "2.125.0",
-        "should": "^13.2.3"
+        "node-opcua-benchmarker": "2.133.0",
+        "node-opcua-debug": "2.133.0"
     },
     "author": "Etienne Rossignon",
     "license": "MIT",
@@ -35,7 +34,7 @@
         "internet of things"
     ],
     "homepage": "http://node-opcua.github.io/",
-    "gitHead": "a0e0a2f1045e6e402dd4619c625c90008f0617ed",
+    "gitHead": "921bb04f2e7ce3109dd051ff27a2210edf700344",
     "files": [
         "dist",
         "source"

package/source/expanded_nodeid.ts

@@ -27,17 +27,8 @@ import { coerceNodeId, NodeId, NodeIdType } from "./nodeid";
  * NamespaceUri. The ServerIndex flag in the NodeId encoding byte indicates whether the
  * ServerIndex is present in the stream. The ServerIndex is omitted if it is equal to zero.
  *
- * @class  ExpandedNodeId
- * @extends NodeId
  *
  *
- *
- * @param identifierType   - the nodeID type
- * @param value            - the node id value. The type of Value depends on identifierType.
- * @param namespace        - the index of the related namespace (optional , default value = 0 )
- * @param namespaceUri     - NamespaceUri
- * @param serverIndex      - the server Index
- * @constructor
  */
 export class ExpandedNodeId extends NodeId {
     public static nullExpandedNodeId = new ExpandedNodeId(NodeIdType.NUMERIC, 0, 0);
@@ -50,6 +41,13 @@ export class ExpandedNodeId extends NodeId {
     public serverIndex: number;
 
     public constructor(forDeserialization: null);
+    /**
+     * @param identifierType   - the nodeID type
+     * @param value            - the node id value. The type of Value depends on identifierType.
+     * @param namespace        - the index of the related namespace (optional , default value = 0 )
+     * @param namespaceUri     - NamespaceUri
+     * @param serverIndex      - the server Index
+     */
     public constructor(
         identifierType: NodeIdType,
         value: number | string | Guid | Buffer,
@@ -68,11 +66,6 @@ export class ExpandedNodeId extends NodeId {
         this.namespaceUri = namespaceUri || null;
         this.serverIndex = serverIndex || 0;
     }
-
-    /**
-     * @method toString
-     * @return {string}
-     */
     public toString(): string {
         let str = NodeId.prototype.toString.call(this);
         if (this.namespaceUri) {
@@ -85,9 +78,7 @@ export class ExpandedNodeId extends NodeId {
     }
 
     /**
-     * convert nodeId to a JSON string. same as {@link NodeId#toString }
-     * @method  toJSON
-     * @return {String}
+     * convert nodeId to a JSON string. same as {@link toString }
      */
     public toJSON(): any {
         return this.toString();
@@ -98,12 +89,8 @@ export function coerceExpandedNodeId(value: unknown): ExpandedNodeId {
     const n = coerceNodeId(value);
     return new ExpandedNodeId(n.identifierType, n.value, n.namespace, /*namespaceUri*/ null, /*serverIndex*/ 0);
 }
-
 /**
- * @method  makeExpandedNodeId
- * @param  value
- * @param [namespace=0] the namespace
- * @return {ExpandedNodeId}
+ * create an expanded nodeId
  */
 export function makeExpandedNodeId(value: unknown, namespace?: number): ExpandedNodeId {
     if (value === undefined && namespace === undefined) {

package/source/nodeid.ts

@@ -13,99 +13,108 @@ import {
     VariableTypeIds
 } from "node-opcua-constants";
 import { emptyGuid, Guid, isValidGuid, normalizeGuid } from "node-opcua-guid";
-
+const doDebug = false;
 /**
  * `NodeIdType` an enumeration that specifies the possible types of a `NodeId` value.
  */
 export enum NodeIdType {
-    /**
-     * @static
-     * @property NUMERIC
-     * @default 0x1
-     */
     NUMERIC = 0x01,
-    /**
-     * @static
-     * @property STRING
-     * @default 0x2
-     */
     STRING = 0x02,
-    /**
-     * @static
-     * @property GUID
-     * @default 0x3
-     */
     GUID = 0x03,
-    /**
-     * @static
-     * @property BYTESTRING
-     * @default 0x4
-     */
     BYTESTRING = 0x04
 }
-/*function defaultValue(identifierType: NodeIdType.BYTESTRING): null;
-function defaultValue(identifierType: NodeIdType.STRING): null;
-function defaultValue(identifierType: NodeIdType.NUMERIC): 0;
-function defaultValue(identifierType: NodeIdType.GUID): null;
-*/
-function defaultValue(identifierType: NodeIdType): string | number | Buffer {
+
+// function defaultValue(identifierType: NodeIdType.BYTESTRING): null;
+// function defaultValue(identifierType: NodeIdType.STRING): "";
+// function defaultValue(identifierType: NodeIdType.NUMERIC): 0;
+// function defaultValue(identifierType: NodeIdType.GUID): string;
+function defaultValue(identifierType: NodeIdType): string | 0 | Buffer  {
     switch (identifierType) {
         case NodeIdType.GUID: return emptyGuid;
         case NodeIdType.BYTESTRING: return null as any as Buffer;// Buffer.alloc(0);
         case NodeIdType.STRING: return "";
         case NodeIdType.NUMERIC: return 0;
+        default:
+            throw new Error("invalid identifierType");
     }
 }
-
+/**
+ * `NodeId` specialization for numeric nodeIds.
+ */
 export interface INodeIdNumeric extends NodeId {
     identifierType: NodeIdType.NUMERIC;
     value: number;
 }
+/**
+ * `NodeId` specialization for GUID  nodeIds.
+ */
 export interface INodeIdGuid extends NodeId {
     identifierType: NodeIdType.GUID;
     value: string;
 }
+/**
+ * `NodeId` specialization for ByteString  nodeIds (opaque).
+ */
 export interface INodeIdByteString extends NodeId {
     identifierType: NodeIdType.BYTESTRING;
     value: Buffer;
 }
+
+/**
+ * `NodeId` specialization for String  nodeId.
+ */
 export interface INodeIdString extends NodeId {
     identifierType: NodeIdType.STRING;
     value: string;
 }
+/**
+ * `NodeId` specialization for all possible types of NodeIds.
+ */
 export type INodeId = INodeIdNumeric | INodeIdGuid | INodeIdString | INodeIdByteString;
 
 
-const doDebug = false;
+
 /**
- * Construct a node ID
- *
- * @class NodeId
- * @example
+ * 
+ * This class holds a OPC-UA node identifier.
+ * 
+ * Nodes are unambiguously identified using a constructed
+ * identifier called the NodeId. Some Servers may accept
+ * alternative NodeIds in addition to the canonical NodeId
+ * represented in this Attribute. 
+ * 
+ * A Server shall persist the NodeId of a Node, that is,
+ * it shall not generate new
+ * NodeIds when rebooting. 
  *
- * ``` javascript
- *    const nodeId = new NodeId(NodeIdType.NUMERIC,123,1);
- *    ```
- * @constructor
  */
 export class NodeId {
     public static NodeIdType = NodeIdType;
     public static nullNodeId: NodeId;
     public static resolveNodeId: (a: string | NodeId) => NodeId;
+
+    /**
+     */
     public static sameNodeId: (n1: NodeId, n2: NodeId) => boolean;
 
     public identifierType: NodeIdType;
-    public value: number | string | Buffer | Guid;;
+    public value: number | string | Buffer | Guid;
     public namespace: number;
 
     /**
+     * construct a node Id from a type, a value and a namespace index.
+     *
      * @param identifierType   - the nodeID type
      * @param value            - the node id value. The type of Value depends on identifierType.
      * @param namespace        - the index of the related namespace (optional , default value = 0 )
+     *  
+     * @example
+     *
+     * ```javascript
+     * const nodeId = new NodeId(NodeIdType.NUMERIC,123,1);
+     * ```
      */
     constructor(identifierType?: NodeIdType | null, value?: number | string | Buffer | Guid, namespace?: number) {
-
-
         if (identifierType === null || identifierType === undefined) {
             this.identifierType = NodeIdType.NUMERIC;
             this.value = 0;
@@ -114,12 +123,15 @@ export class NodeId {
         }
 
         this.identifierType = identifierType;
-        this.value = value || defaultValue(identifierType);
+        this.value = value || defaultValue(identifierType as NodeIdType);
         this.namespace = namespace || 0;
 
         // namespace shall be a UInt16
         assert(this.namespace >= 0 && this.namespace <= 0xffff, "NodeId: invalid namespace value");
-        assert(this.identifierType !== NodeIdType.NUMERIC || (this.value !== null && this.value as number >= 0 && this.value as number <= 0xffffffff));
+        assert(
+            this.identifierType !== NodeIdType.NUMERIC ||
+                (this.value !== null && (this.value as number) >= 0 && (this.value as number) <= 0xffffffff)
+        );
         assert(this.identifierType !== NodeIdType.GUID || isValidGuid(this.value as string), "NodeId: Guid is invalid");
         assert(this.identifierType !== NodeIdType.STRING || typeof this.value === "string", "cannot  empty string");
         if (this.identifierType === NodeIdType.GUID) {
@@ -130,26 +142,55 @@ export class NodeId {
     /**
      * get the string representation of the nodeID.
      *
-     * @method toString
      * @example
      *
-     *    ``` javascript
-     *    const nodeid = new NodeId(NodeIdType.NUMERIC, 123,1);
-     *    console.log(nodeid.toString());
-     *    ```
+     * by default, toString will return the "ns=" representation
+     *
+     * ```javascript
+     * const nodeid = new NodeId(NodeIdType.NUMERIC, 123,1);
+     * console.log(nodeid.toString());
+     * ```
+     *
+     *  ```
+     *  >"ns=1;i=123"
+     *  ```
+     * @example
+     *
+     *  toString can also be used to make the nsu= version of the nodeid.
+     *
+     *  ```javascript
+     *  const namespaceArray = ["http://opcfoundation.com/UA/","http://mynamespace2"];
+     *  const nodeid = new NodeId(NodeIdType.STRING, "Hello",1);
+     *  console.log(nodeid.toString({namespaceArray}));
+     *  ```
+     *  ```
+     *  >"nsu=http://mynamespace;i=123"
+     *  ```
+     * @example
+     *
+     *  passing an addressSpace to the toString options will decorate the nodeId
+     *  with the BrowseName of the node.
+     *
+     *  ```javascript
+     * const addressSpace = getAddressSpace();
+     * const nodeid = new NodeId(NodeIdType.NUMERIC, 123,1);
+     * console.log(nodeid.toString({addressSpace}));
+     * ```
+     * ```
+     * >"nsu=http://mynamespace;i=123 (MyBrowseName)"
+     * ```
      *
-     *    ```
-     *    >"ns=1;i=123"
-     *    ```
      *
      * @param [options.addressSpace] {AddressSpace}
      * @return {String}
      */
-    public toString(options?: { addressSpace?: any , namespaceArray?: string[]}): string {
+    public toString(options?: { addressSpace?: any; namespaceArray?: string[] }): string {
         const addressSpace = options ? options.addressSpace : null;
 
-        const namespacePart: string = options?.namespaceArray ?
-            (this.namespace == 0 ? ""  : `nsu=${options.namespaceArray[this.namespace] || `<unknown namespace with index ${this.namespace}>`};`)
+        const namespacePart: string = options?.namespaceArray
+            ? this.namespace == 0
+                ? ""
+                : `nsu=${options.namespaceArray[this.namespace] || `<unknown namespace with index ${this.namespace}>`};`
             : `ns=${this.namespace};`;
 
         let str;
@@ -169,7 +210,7 @@ export class NodeId {
                 if (this.value) {
                     str = `${namespacePart}b=${(this.value as Buffer).toString("base64")}`;
                 } else {
-                    str = `${ namespacePart}b=<null>`;
+                    str = `${namespacePart}b=<null>`;
                 }
                 break;
         }
@@ -190,9 +231,9 @@ export class NodeId {
     }
 
     /**
-     * convert nodeId to a JSON string. same as {@link NodeId#toString }
+     * convert nodeId to a JSON string. same as {@link NodeId.toString }
      */
-    public toJSON(options?: {namespaceArray?: string[]}): string {
+    public toJSON(options?: { namespaceArray?: string[] }): string {
         return this.toString(options);
     }
 
@@ -224,6 +265,9 @@ export class NodeId {
     }
 }
 
+/**
+ * a fixed instance of a null NodeId 
+ */
 NodeId.nullNodeId = new Proxy(
     new NodeId(NodeIdType.NUMERIC, 0, 0),
     {
@@ -236,8 +280,14 @@ NodeId.nullNodeId = new Proxy(
     });
 
 
+/**
+ * anything that could be turned into a nodeId
+ */
 export type NodeIdLike = string | NodeId | number;
 
+/**
+ * @private
+ */
 const regexNamespaceI = /ns=([0-9]+);i=([0-9]+)/;
 const regexNamespaceS = /ns=([0-9]+);s=(.*)/;
 const regexNamespaceB = /ns=([0-9]+);b=(.*)/;
@@ -250,28 +300,23 @@ const regexNamespaceNSU_B = /nsu=(.+);b=(.*)/;
 const regexNamespaceNSU_G = /nsu=(.+);g=([0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12})/;
 
 
+/**
+ * 
+ */
 export interface ResolveNodeIdOptions {
     namespaceArray?: string[];
     defaultNamespaceIndex?: number ; 
 }
 /**
  * Convert a value into a nodeId:
- * @class opcua
- * @method coerceNodeId
- * @static
  *
  * @description:
  *    - if nodeId is a string of form : "i=1234"  => nodeId({value=1234, identifierType: NodeIdType.NUMERIC})
  *    - if nodeId is a string of form : "s=foo"   => nodeId({value="foo", identifierType: NodeIdType.STRING})
  *    - if nodeId is a string of form : "b=ABCD=" => nodeId({value=decodeBase64("ABCD="), identifierType: NodeIdType.BYTESTRING})
  *    - if nodeId is a {@link NodeId} :  coerceNodeId returns value
- * @param value
- * @param namespaceOptions {number} 
- * @param namespaceOptions.namespace {number} 
- * @param namespaceOptions.namespaceArray {number} 
  * 
  */
-// eslint-disable-next-line max-statements
 export function coerceNodeId(value: unknown, namespaceOptions?: number | ResolveNodeIdOptions): NodeId {
     let matches;
     let twoFirst;
@@ -354,11 +399,9 @@ export function coerceNodeId(value: unknown, namespaceOptions?: number | Resolve
 const regEx1 = /^(s|g|b|i|ns)=/;
 /**
  * construct a node Id from a value and a namespace.
- * @class opcua
- * @method makeNodeId
- * @static
+ *
  * @param {String|Buffer} value
- * @param [namespace]=0 {Number} the node id namespace
+ * @param [namespace]=0 {Number} optional (default=0), the node id namespace
  * @return {NodeId}
  */
 export function makeNodeId(value: string | Buffer | number, namespace?: number): NodeId {
@@ -420,11 +463,35 @@ function reverse_map(nodeId: string) {
 }
 
 /**
- * @class opcua
- * @method resolveNodeId
- * @static
- * @param nodeIdOrString
- * @return the nodeId
+ * resolveNodeId can be helpful to convert a wellknown Node Name to a nodeid
+ * if a wellknown node name cannot be detected, the function falls back to
+ * calling coerceNodeId {@link coerceNodeId}.
+ * 
+ * @example
+ * ```javascript
+ * const nodeId = resolveNodeId("ObjectsFolder");
+ * console.log(nodeId.toString());
+ * ```
+ * ```text
+ * >ns=0;i=85
+ * ```
+ * 
+ * ```javascript
+ * const nodeId = resolveNodeId("HasComponent");
+ * console.log(nodeId.toString());
+ * ```
+ * ```text
+ * >ns=0;i=33
+ * ```
+ * 
+ * ```javascript
+ * const nodeId = resolveNodeId("ns=1;i=4444");
+ * console.log(nodeId.toString());
+ * ```
+ * ```text
+ * >ns=1;i=4444
+ * ```
+ * 
  */
 export function resolveNodeId(nodeIdOrString: NodeIdLike, options?: ResolveNodeIdOptions): NodeId {
     let nodeId;
@@ -440,6 +507,24 @@ export function resolveNodeId(nodeIdOrString: NodeIdLike, options?: ResolveNodeI
 
 NodeId.resolveNodeId = resolveNodeId;
 
+/**
+ * 
+ * The sameNodeId function is used to compare two NodeId objects to
+ * determine if they are identical. This comparison is based on the
+ * identifier type, namespace, and value of the NodeId objects.
+ *
+
+ *
+ * @return {boolean} Returns true if the two NodeId objects are
+ * identical, otherwise returns false.
+ * 
+ * @example
+ * ```javascript
+ * const nodeId1: NodeId = new NodeId(NodeIdType.STRING, "example", 1);
+ * const nodeId2: NodeId = coerceNodeId("ns=1;s=example");
+ * const areSame = sameNodeId(nodeId1, nodeId2); // returns true
+ * ```
+ */
 export function sameNodeId(n1: NodeId, n2: NodeId): boolean {
     if (n1.identifierType !== n2.identifierType) {
         return false;