node-opcua-nodeid 2.51.0

package/.mocharc.yml

@@ -0,0 +1,4 @@
+recursive: true
+bail: true
+require:
+- ../../node_modules/source-map-support/register

package/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2014-2021 Etienne Rossignon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/expanded_nodeid.d.ts

@@ -0,0 +1,68 @@
+/// <reference types="node" />
+/**
+ * @module node-opcua-nodeid
+ */
+import { Guid } from "node-opcua-guid";
+import { NodeId, NodeIdType } from "./nodeid";
+/**
+ * An ExpandedNodeId extends the NodeId structure.
+ *
+ * An ExpandedNodeId extends the NodeId structure by allowing the NamespaceUri to be
+ * explicitly specified instead of using the NamespaceIndex. The NamespaceUri is optional. If it
+ * is specified then the NamespaceIndex inside the NodeId shall be ignored.
+ *
+ * The ExpandedNodeId is encoded by first encoding a NodeId as described in Clause 5 .2.2.9
+ * and then encoding NamespaceUri as a String.
+ *
+ * An instance of an ExpandedNodeId may still use the NamespaceIndex instead of the
+ * NamespaceUri. In this case, the NamespaceUri is not encoded in the stream. The presence of
+ * the NamespaceUri in the stream is indicated by setting the NamespaceUri flag in the encoding
+ * format byte for the NodeId.
+ *
+ * If the NamespaceUri is present then the encoder shall encode the NamespaceIndex as 0 in
+ * the stream when the NodeId portion is encoded. The unused NamespaceIndex is included in
+ * the stream for consistency,
+ *
+ * An ExpandedNodeId may also have a ServerIndex which is encoded as a UInt32 after the
+ * 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;
+    static fromNodeId(nodeId: NodeId, namespaceUri?: string, serverIndex?: number): ExpandedNodeId;
+    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}
+     */
+    toString(): string;
+    /**
+     * convert nodeId to a JSON string. same as {@link NodeId#toString }
+     * @method  toJSON
+     * @return {String}
+     */
+    toJSON(): any;
+}
+export declare function coerceExpandedNodeId(value: any): ExpandedNodeId;
+/**
+ * @method  makeExpandedNodeId
+ * @param  value
+ * @param [namespace=0] the namespace
+ * @return {ExpandedNodeId}
+ */
+export declare function makeExpandedNodeId(value: any, namespace?: number): ExpandedNodeId;

package/dist/expanded_nodeid.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeExpandedNodeId = exports.coerceExpandedNodeId = exports.ExpandedNodeId = void 0;
+const nodeid_1 = require("./nodeid");
+/**
+ * An ExpandedNodeId extends the NodeId structure.
+ *
+ * An ExpandedNodeId extends the NodeId structure by allowing the NamespaceUri to be
+ * explicitly specified instead of using the NamespaceIndex. The NamespaceUri is optional. If it
+ * is specified then the NamespaceIndex inside the NodeId shall be ignored.
+ *
+ * The ExpandedNodeId is encoded by first encoding a NodeId as described in Clause 5 .2.2.9
+ * and then encoding NamespaceUri as a String.
+ *
+ * An instance of an ExpandedNodeId may still use the NamespaceIndex instead of the
+ * NamespaceUri. In this case, the NamespaceUri is not encoded in the stream. The presence of
+ * the NamespaceUri in the stream is indicated by setting the NamespaceUri flag in the encoding
+ * format byte for the NodeId.
+ *
+ * If the NamespaceUri is present then the encoder shall encode the NamespaceIndex as 0 in
+ * the stream when the NodeId portion is encoded. The unused NamespaceIndex is included in
+ * the stream for consistency,
+ *
+ * An ExpandedNodeId may also have a ServerIndex which is encoded as a UInt32 after the
+ * 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 {
+    constructor(identifierType, value, namespace, namespaceUri, serverIndex) {
+        super(identifierType, value, namespace);
+        this.namespaceUri = namespaceUri || null;
+        this.serverIndex = serverIndex || 0;
+    }
+    static fromNodeId(nodeId, namespaceUri, serverIndex) {
+        return new ExpandedNodeId(nodeId.identifierType, nodeId.value, nodeId.namespace, namespaceUri, serverIndex);
+    }
+    /**
+     * @method toString
+     * @return {string}
+     */
+    toString() {
+        let str = nodeid_1.NodeId.prototype.toString.call(this);
+        if (this.namespaceUri) {
+            str += ";namespaceUri:" + this.namespaceUri;
+        }
+        if (this.serverIndex) {
+            str += ";serverIndex:" + this.serverIndex;
+        }
+        return str;
+    }
+    /**
+     * convert nodeId to a JSON string. same as {@link NodeId#toString }
+     * @method  toJSON
+     * @return {String}
+     */
+    toJSON() {
+        return this.toString();
+    }
+}
+exports.ExpandedNodeId = ExpandedNodeId;
+ExpandedNodeId.nullExpandedNodeId = new ExpandedNodeId(nodeid_1.NodeIdType.NUMERIC, 0, 0);
+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}
+ */
+function makeExpandedNodeId(value, namespace) {
+    if (value === undefined && namespace === undefined) {
+        return new ExpandedNodeId(nodeid_1.NodeIdType.NUMERIC, 0, 0, null, 0);
+    }
+    const serverIndex = 0;
+    let n;
+    const namespaceUri = null;
+    if (value instanceof ExpandedNodeId) {
+        // construct from a ExpandedNodeId => copy
+        n = value;
+        return new ExpandedNodeId(n.identifierType, n.value, n.namespace, n.namespaceUri, n.serverIndex);
+    }
+    if (value instanceof nodeid_1.NodeId) {
+        // construct from a nodeId
+        n = value;
+        return new ExpandedNodeId(n.identifierType, n.value, n.namespace, namespaceUri, serverIndex);
+    }
+    const valueInt = parseInt(value, 10);
+    if (!isFinite(valueInt)) {
+        throw new Error(" cannot makeExpandedNodeId out of " + value);
+    }
+    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

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @module node-opcua-nodeid
+ */
+export * from "./nodeid";
+export * from "./expanded_nodeid";

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @module node-opcua-nodeid
+ */
+__exportStar(require("./nodeid"), exports);
+__exportStar(require("./expanded_nodeid"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA;;GAEG;AACH,2CAAyB;AACzB,oDAAkC"}

package/dist/nodeid.d.ts

@@ -0,0 +1,121 @@
+/// <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
+}
+/**
+ * Construct a node ID
+ *
+ * @class NodeId
+ * @example
+ *
+ *    ``` 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;
+    /**
+     * @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 )
+     */
+    constructor(identifierType?: NodeIdType | null, value?: any, 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());
+     *    ```
+     *
+     *    ```
+     *    >"ns=1;i=123"
+     *    ```
+     *
+     * @param [options.addressSpace] {AddressSpace}
+     * @return {String}
+     */
+    toString(options?: {
+        addressSpace?: any;
+    }): string;
+    /**
+     * convert nodeId to a JSON string. same as {@link NodeId#toString }
+     */
+    toJSON(): string;
+    displayText(): string;
+    /**
+     * returns true if the NodeId is null or empty
+     */
+    isEmpty(): boolean;
+}
+export declare type NodeIdLike = string | NodeId | 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 {@link NodeId} :  coerceNodeId returns value
+ * @param value
+ * @param namespace {number}
+ */
+export declare function coerceNodeId(value: any, namespace?: number): 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
+ * @return {NodeId}
+ */
+export declare function makeNodeId(value: string | Buffer | number, namespace?: number): NodeId;
+/**
+ * @class opcua
+ * @method resolveNodeId
+ * @static
+ * @param nodeIdOrString
+ * @return the nodeId
+ */
+export declare function resolveNodeId(nodeIdOrString: NodeIdLike): NodeId;
+export declare function sameNodeId(n1: NodeId, n2: NodeId): boolean;

package/dist/nodeid.js

@@ -0,0 +1,352 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sameNodeId = exports.resolveNodeId = exports.makeNodeId = exports.coerceNodeId = exports.NodeId = exports.NodeIdType = void 0;
+/**
+ * @module node-opcua-nodeid
+ */
+// tslint:disable:no-conditional-assignment
+const chalk = require("chalk");
+const lodash_1 = require("lodash");
+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");
+/**
+ * `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 || (exports.NodeIdType = {}));
+/**
+ * Construct a node ID
+ *
+ * @class NodeId
+ * @example
+ *
+ *    ``` javascript
+ *    const nodeId = new NodeId(NodeIdType.NUMERIC,123,1);
+ *    ```
+ * @constructor
+ */
+class 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 )
+     */
+    constructor(identifierType, value, namespace) {
+        if (identifierType === null || identifierType === undefined) {
+            this.identifierType = NodeIdType.NUMERIC;
+            this.value = 0;
+            this.namespace = 0;
+            return;
+        }
+        this.identifierType = identifierType;
+        this.value = value;
+        this.namespace = namespace || 0;
+        // namespace shall be a UInt16
+        (0, node_opcua_assert_1.assert)(this.namespace >= 0 && this.namespace <= 0xffff);
+        (0, node_opcua_assert_1.assert)(this.identifierType !== NodeIdType.NUMERIC || (this.value >= 0 && this.value <= 0xffffffff));
+        (0, node_opcua_assert_1.assert)(this.identifierType !== NodeIdType.GUID || (0, node_opcua_guid_1.isValidGuid)(this.value));
+        (0, node_opcua_assert_1.assert)(this.identifierType !== NodeIdType.STRING || typeof this.value === "string");
+    }
+    /**
+     * get the string representation of the nodeID.
+     *
+     * @method toString
+     * @example
+     *
+     *    ``` javascript
+     *    const nodeid = new NodeId(NodeIdType.NUMERIC, 123,1);
+     *    console.log(nodeid.toString());
+     *    ```
+     *
+     *    ```
+     *    >"ns=1;i=123"
+     *    ```
+     *
+     * @param [options.addressSpace] {AddressSpace}
+     * @return {String}
+     */
+    toString(options) {
+        const addressSpace = options ? options.addressSpace : null;
+        let str;
+        switch (this.identifierType) {
+            case NodeIdType.NUMERIC:
+                str = "ns=" + this.namespace + ";i=" + this.value;
+                break;
+            case NodeIdType.STRING:
+                str = "ns=" + this.namespace + ";s=" + this.value;
+                break;
+            case NodeIdType.GUID:
+                str = "ns=" + this.namespace + ";g=" + this.value;
+                break;
+            default:
+                (0, node_opcua_assert_1.assert)(this.identifierType === NodeIdType.BYTESTRING, "invalid identifierType in NodeId : " + this.identifierType);
+                if (this.value) {
+                    str = "ns=" + this.namespace + ";b=" + this.value.toString("base64");
+                }
+                else {
+                    str = "ns=" + this.namespace + ";b=<null>";
+                }
+                break;
+        }
+        if (addressSpace) {
+            if (this.namespace === 0 && this.identifierType === NodeIdType.NUMERIC) {
+                // find standard browse name
+                const name = reverse_map(this.value.toString()) || "<undefined>";
+                str += " " + chalk.green.bold(name);
+            }
+            else if (addressSpace.findNode) {
+                // let use the provided address space to figure out the browseNode of this node.
+                // to make the message a little bit more useful.
+                const n = addressSpace.findNode(this);
+                str += " " + (n ? n.browseName.toString() : " (????)");
+            }
+        }
+        return str;
+    }
+    /**
+     * convert nodeId to a JSON string. same as {@link NodeId#toString }
+     */
+    toJSON() {
+        return this.toString();
+    }
+    displayText() {
+        if (this.namespace === 0 && this.identifierType === NodeIdType.NUMERIC) {
+            const name = reverse_map(this.value.toString());
+            if (name) {
+                return name + " (" + this.toString() + ")";
+            }
+        }
+        return this.toString();
+    }
+    /**
+     * returns true if the NodeId is null or empty
+     */
+    isEmpty() {
+        switch (this.identifierType) {
+            case NodeIdType.NUMERIC:
+                return this.value === 0;
+            case NodeIdType.STRING:
+                return !this.value || this.value.length === 0;
+            case NodeIdType.GUID:
+                return !this.value || this.value === node_opcua_guid_1.emptyGuid;
+            default:
+                (0, node_opcua_assert_1.assert)(this.identifierType === NodeIdType.BYTESTRING, "invalid identifierType in NodeId : " + this.identifierType);
+                return !this.value || this.value.length === 0;
+        }
+    }
+}
+exports.NodeId = NodeId;
+NodeId.NodeIdType = NodeIdType;
+NodeId.nullNodeId = new NodeId();
+const regexNamespaceI = /ns=([0-9]+);i=([0-9]+)/;
+const regexNamespaceS = /ns=([0-9]+);s=(.*)/;
+const regexNamespaceB = /ns=([0-9]+);b=(.*)/;
+const regexNamespaceG = /ns=([0-9]+);g=(.*)/;
+/**
+ * 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 {@link NodeId} :  coerceNodeId returns value
+ * @param value
+ * @param namespace {number}
+ */
+function coerceNodeId(value, namespace) {
+    let matches;
+    let twoFirst;
+    if (value instanceof NodeId) {
+        return value;
+    }
+    value = value || 0;
+    namespace = namespace || 0;
+    let identifierType = NodeIdType.NUMERIC;
+    if (typeof value === "string") {
+        identifierType = NodeIdType.STRING;
+        twoFirst = value.substr(0, 2);
+        if (twoFirst === "i=") {
+            identifierType = NodeIdType.NUMERIC;
+            value = parseInt(value.substr(2), 10);
+        }
+        else if (twoFirst === "s=") {
+            identifierType = NodeIdType.STRING;
+            value = value.substr(2);
+        }
+        else if (twoFirst === "b=") {
+            identifierType = NodeIdType.BYTESTRING;
+            value = Buffer.from(value.substr(2), "base64");
+        }
+        else if (twoFirst === "g=") {
+            identifierType = NodeIdType.GUID;
+            value = value.substr(2);
+        }
+        else if ((0, node_opcua_guid_1.isValidGuid)(value)) {
+            identifierType = NodeIdType.GUID;
+        }
+        else if ((matches = regexNamespaceI.exec(value)) !== null) {
+            identifierType = NodeIdType.NUMERIC;
+            namespace = parseInt(matches[1], 10);
+            value = parseInt(matches[2], 10);
+        }
+        else if ((matches = regexNamespaceS.exec(value)) !== null) {
+            identifierType = NodeIdType.STRING;
+            namespace = parseInt(matches[1], 10);
+            value = matches[2];
+        }
+        else if ((matches = regexNamespaceB.exec(value)) !== null) {
+            identifierType = NodeIdType.BYTESTRING;
+            namespace = parseInt(matches[1], 10);
+            value = Buffer.from(matches[2], "base64");
+        }
+        else if ((matches = regexNamespaceG.exec(value)) !== null) {
+            identifierType = NodeIdType.GUID;
+            namespace = parseInt(matches[1], 10);
+            value = matches[2];
+        }
+        else {
+            throw new Error("String cannot be coerced to a nodeId : " + value);
+        }
+    }
+    else if (value instanceof Buffer) {
+        identifierType = NodeIdType.BYTESTRING;
+    }
+    else if (value instanceof Object) {
+        // it could be a Enum or a NodeId Like object
+        const tmp = value;
+        value = tmp.value;
+        namespace = namespace || tmp.namespace;
+        identifierType = tmp.identifierType || identifierType;
+        return new NodeId(identifierType, value, namespace);
+    }
+    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
+ * @return {NodeId}
+ */
+function makeNodeId(value, namespace) {
+    value = value || 0;
+    namespace = namespace || 0;
+    let identifierType = NodeIdType.NUMERIC;
+    if (typeof value === "string") {
+        if (value.match(regEx1)) {
+            throw new Error("please use coerce NodeId instead");
+        }
+        //            1         2         3
+        //  012345678901234567890123456789012345
+        // "72962B91-FA75-4AE6-8D28-B404DC7DAF63"
+        if ((0, node_opcua_guid_1.isValidGuid)(value)) {
+            identifierType = NodeIdType.GUID;
+        }
+        else {
+            identifierType = NodeIdType.STRING;
+        }
+    }
+    else if (value instanceof Buffer) {
+        identifierType = NodeIdType.BYTESTRING;
+    }
+    const nodeId = new NodeId(identifierType, value, namespace);
+    return nodeId;
+}
+exports.makeNodeId = makeNodeId;
+// reverse maps
+let _nodeIdToNameIndex = {};
+let _nameToNodeIdIndex = {};
+const regName = /[a-zA-Z_].*/;
+(function build_standard_nodeid_indexes() {
+    function expand_map(directIndex) {
+        for (const name in directIndex) {
+            if (directIndex.hasOwnProperty(name) && regName.exec(name) !== null) {
+                const value = directIndex[name];
+                _nodeIdToNameIndex[value] = name;
+                _nameToNodeIdIndex[name] = new NodeId(NodeIdType.NUMERIC, value, 0);
+            }
+        }
+    }
+    _nodeIdToNameIndex = {};
+    _nameToNodeIdIndex = {};
+    expand_map(node_opcua_constants_1.ObjectIds);
+    expand_map(node_opcua_constants_1.ObjectTypeIds);
+    expand_map(node_opcua_constants_1.VariableIds);
+    expand_map(node_opcua_constants_1.VariableTypeIds);
+    expand_map(node_opcua_constants_1.MethodIds);
+    expand_map(node_opcua_constants_1.ReferenceTypeIds);
+    expand_map(node_opcua_constants_1.DataTypeIds);
+})();
+function reverse_map(nodeId) {
+    return _nodeIdToNameIndex[nodeId];
+}
+/**
+ * @class opcua
+ * @method resolveNodeId
+ * @static
+ * @param nodeIdOrString
+ * @return the nodeId
+ */
+function resolveNodeId(nodeIdOrString) {
+    let nodeId;
+    const rawId = typeof nodeIdOrString === "string" ? _nameToNodeIdIndex[nodeIdOrString] : undefined;
+    if (rawId !== undefined) {
+        return rawId;
+    }
+    else {
+        nodeId = coerceNodeId(nodeIdOrString);
+    }
+    return nodeId;
+}
+exports.resolveNodeId = resolveNodeId;
+NodeId.resolveNodeId = resolveNodeId;
+function sameNodeId(n1, n2) {
+    if (n1.identifierType !== n2.identifierType) {
+        return false;
+    }
+    if (n1.namespace !== n2.namespace) {
+        return false;
+    }
+    switch (n1.identifierType) {
+        case NodeIdType.NUMERIC:
+        case NodeIdType.STRING:
+            return n1.value === n2.value;
+        default:
+            return (0, lodash_1.isEqual)(n1.value, n2.value);
+    }
+}
+exports.sameNodeId = sameNodeId;
+NodeId.sameNodeId = sameNodeId;
+//# sourceMappingURL=nodeid.js.map

package/dist/nodeid.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+    "name": "node-opcua-nodeid",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "version": "2.51.0",
+    "description": "pure nodejs OPCUA SDK - module -nodeid",
+    "scripts": {
+        "build": "tsc -b",
+        "lint": "tslint source/**/*.ts",
+        "clean": "node -e \"require('rimraf').sync('dist');\"",
+        "test": "mocha"
+    },
+    "dependencies": {
+        "@types/lodash": "4.14.172",
+        "chalk": "4.1.2",
+        "lodash": "4.17.21",
+        "node-opcua-assert": "2.51.0",
+        "node-opcua-constants": "2.51.0",
+        "node-opcua-enum": "2.51.0",
+        "node-opcua-guid": "2.51.0"
+    },
+    "devDependencies": {
+        "node-opcua-benchmarker": "2.51.0",
+        "node-opcua-debug": "2.51.0",
+        "should": "^13.2.3",
+        "source-map-support": "^0.5.19"
+    },
+    "author": "Etienne Rossignon",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git://github.com/node-opcua/node-opcua.git"
+    },
+    "keywords": [
+        "OPCUA",
+        "opcua",
+        "m2m",
+        "iot",
+        "opc ua",
+        "internet of things"
+    ],
+    "homepage": "http://node-opcua.github.io/",
+    "gitHead": "75feb111daf7ec65fa0111e4fa5beb8987fd4945"
+}

package/source/expanded_nodeid.ts

@@ -0,0 +1,133 @@
+/**
+ * @module node-opcua-nodeid
+ */
+import { Guid } from "node-opcua-guid";
+import { coerceNodeId, NodeId, NodeIdType } from "./nodeid";
+
+/**
+ * An ExpandedNodeId extends the NodeId structure.
+ *
+ * An ExpandedNodeId extends the NodeId structure by allowing the NamespaceUri to be
+ * explicitly specified instead of using the NamespaceIndex. The NamespaceUri is optional. If it
+ * is specified then the NamespaceIndex inside the NodeId shall be ignored.
+ *
+ * The ExpandedNodeId is encoded by first encoding a NodeId as described in Clause 5 .2.2.9
+ * and then encoding NamespaceUri as a String.
+ *
+ * An instance of an ExpandedNodeId may still use the NamespaceIndex instead of the
+ * NamespaceUri. In this case, the NamespaceUri is not encoded in the stream. The presence of
+ * the NamespaceUri in the stream is indicated by setting the NamespaceUri flag in the encoding
+ * format byte for the NodeId.
+ *
+ * If the NamespaceUri is present then the encoder shall encode the NamespaceIndex as 0 in
+ * the stream when the NodeId portion is encoded. The unused NamespaceIndex is included in
+ * the stream for consistency,
+ *
+ * An ExpandedNodeId may also have a ServerIndex which is encoded as a UInt32 after the
+ * 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);
+
+    public static fromNodeId(nodeId: NodeId, namespaceUri?: string, serverIndex?: number): ExpandedNodeId {
+        return new ExpandedNodeId(nodeId.identifierType, nodeId.value, nodeId.namespace, namespaceUri, serverIndex);
+    }
+
+    public namespaceUri: null | string;
+    public serverIndex: number;
+
+    public constructor(forDeserialization: null);
+    public constructor(
+        identifierType: NodeIdType,
+        value: number | string | Guid | Buffer,
+        namespace: number,
+        namespaceUri?: null | string,
+        serverIndex?: number
+    );
+    public constructor(
+        identifierType?: NodeIdType | null,
+        value?: number | string | Guid | Buffer,
+        namespace?: number,
+        namespaceUri?: null | string,
+        serverIndex?: number
+    ) {
+        super(identifierType, value, namespace);
+        this.namespaceUri = namespaceUri || null;
+        this.serverIndex = serverIndex || 0;
+    }
+
+    /**
+     * @method toString
+     * @return {string}
+     */
+    public toString() {
+        let str = NodeId.prototype.toString.call(this);
+        if (this.namespaceUri) {
+            str += ";namespaceUri:" + this.namespaceUri;
+        }
+        if (this.serverIndex) {
+            str += ";serverIndex:" + this.serverIndex;
+        }
+        return str;
+    }
+
+    /**
+     * convert nodeId to a JSON string. same as {@link NodeId#toString }
+     * @method  toJSON
+     * @return {String}
+     */
+    public toJSON(): any {
+        return this.toString();
+    }
+}
+
+export function coerceExpandedNodeId(value: any): 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}
+ */
+export function makeExpandedNodeId(value: any, namespace?: number) {
+    if (value === undefined && namespace === undefined) {
+        return new ExpandedNodeId(NodeIdType.NUMERIC, 0, 0, null, 0);
+    }
+    const serverIndex = 0;
+    let n;
+    const namespaceUri = null;
+
+    if (value instanceof ExpandedNodeId) {
+        // construct from a ExpandedNodeId => copy
+        n = value;
+        return new ExpandedNodeId(n.identifierType, n.value, n.namespace, n.namespaceUri, n.serverIndex);
+    }
+    if (value instanceof NodeId) {
+        // construct from a nodeId
+        n = value;
+        return new ExpandedNodeId(n.identifierType, n.value, n.namespace, namespaceUri, serverIndex);
+    }
+
+    const valueInt = parseInt(value, 10);
+    if (!isFinite(valueInt)) {
+        throw new Error(" cannot makeExpandedNodeId out of " + value);
+    }
+    namespace = namespace || 0;
+    return new ExpandedNodeId(NodeIdType.NUMERIC, valueInt, namespace, namespaceUri, serverIndex);
+}

package/source/index.ts

@@ -0,0 +1,5 @@
+/**
+ * @module node-opcua-nodeid
+ */
+export * from "./nodeid";
+export * from "./expanded_nodeid";

package/source/nodeid.ts

@@ -0,0 +1,373 @@
+/**
+ * @module node-opcua-nodeid
+ */
+// tslint:disable:no-conditional-assignment
+import * as chalk from "chalk";
+import { isEqual } from "lodash";
+import { assert } from "node-opcua-assert";
+import {
+    DataTypeIds,
+    MethodIds,
+    ObjectIds,
+    ObjectTypeIds,
+    ReferenceTypeIds,
+    VariableIds,
+    VariableTypeIds
+} from "node-opcua-constants";
+import { emptyGuid, Guid, isValidGuid } from "node-opcua-guid";
+
+/**
+ * `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
+}
+
+/**
+ * Construct a node ID
+ *
+ * @class NodeId
+ * @example
+ *
+ *    ``` 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 namespace: number;
+
+    /**
+     * @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 )
+     */
+    constructor(identifierType?: NodeIdType | null, value?: any, namespace?: number) {
+        if (identifierType === null || identifierType === undefined) {
+            this.identifierType = NodeIdType.NUMERIC;
+            this.value = 0;
+            this.namespace = 0;
+            return;
+        }
+        this.identifierType = identifierType;
+        this.value = value;
+        this.namespace = namespace || 0;
+
+        // namespace shall be a UInt16
+        assert(this.namespace >= 0 && this.namespace <= 0xffff);
+
+        assert(this.identifierType !== NodeIdType.NUMERIC || (this.value >= 0 && this.value <= 0xffffffff));
+        assert(this.identifierType !== NodeIdType.GUID || isValidGuid(this.value as string));
+        assert(this.identifierType !== NodeIdType.STRING || typeof this.value === "string");
+    }
+
+    /**
+     * get the string representation of the nodeID.
+     *
+     * @method toString
+     * @example
+     *
+     *    ``` javascript
+     *    const nodeid = new NodeId(NodeIdType.NUMERIC, 123,1);
+     *    console.log(nodeid.toString());
+     *    ```
+     *
+     *    ```
+     *    >"ns=1;i=123"
+     *    ```
+     *
+     * @param [options.addressSpace] {AddressSpace}
+     * @return {String}
+     */
+    public toString(options?: { addressSpace?: any }): string {
+        const addressSpace = options ? options.addressSpace : null;
+        let str;
+        switch (this.identifierType) {
+            case NodeIdType.NUMERIC:
+                str = "ns=" + this.namespace + ";i=" + this.value;
+                break;
+            case NodeIdType.STRING:
+                str = "ns=" + this.namespace + ";s=" + this.value;
+                break;
+            case NodeIdType.GUID:
+                str = "ns=" + this.namespace + ";g=" + this.value;
+                break;
+            default:
+                assert(this.identifierType === NodeIdType.BYTESTRING, "invalid identifierType in NodeId : " + this.identifierType);
+                if (this.value) {
+                    str = "ns=" + this.namespace + ";b=" + (this.value as Buffer).toString("base64");
+                } else {
+                    str = "ns=" + this.namespace + ";b=<null>";
+                }
+                break;
+        }
+
+        if (addressSpace) {
+            if (this.namespace === 0 && this.identifierType === NodeIdType.NUMERIC) {
+                // find standard browse name
+                const name = reverse_map(this.value.toString()) || "<undefined>";
+                str += " " + chalk.green.bold(name);
+            } else if (addressSpace.findNode) {
+                // let use the provided address space to figure out the browseNode of this node.
+                // to make the message a little bit more useful.
+                const n = addressSpace.findNode(this);
+                str += " " + (n ? n.browseName.toString() : " (????)");
+            }
+        }
+        return str;
+    }
+
+    /**
+     * convert nodeId to a JSON string. same as {@link NodeId#toString }
+     */
+    public toJSON(): string {
+        return this.toString();
+    }
+
+    public displayText(): string {
+        if (this.namespace === 0 && this.identifierType === NodeIdType.NUMERIC) {
+            const name = reverse_map(this.value.toString());
+            if (name) {
+                return name + " (" + this.toString() + ")";
+            }
+        }
+        return this.toString();
+    }
+
+    /**
+     * returns true if the NodeId is null or empty
+     */
+    public isEmpty(): boolean {
+        switch (this.identifierType) {
+            case NodeIdType.NUMERIC:
+                return this.value === 0;
+            case NodeIdType.STRING:
+                return !this.value || (this.value as string).length === 0;
+            case NodeIdType.GUID:
+                return !this.value || this.value === emptyGuid;
+            default:
+                assert(this.identifierType === NodeIdType.BYTESTRING, "invalid identifierType in NodeId : " + this.identifierType);
+                return !this.value || (this.value as Buffer).length === 0;
+        }
+    }
+}
+
+NodeId.nullNodeId = new NodeId();
+
+export type NodeIdLike = string | NodeId | number;
+
+const regexNamespaceI = /ns=([0-9]+);i=([0-9]+)/;
+const regexNamespaceS = /ns=([0-9]+);s=(.*)/;
+const regexNamespaceB = /ns=([0-9]+);b=(.*)/;
+const regexNamespaceG = /ns=([0-9]+);g=(.*)/;
+
+/**
+ * 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 {@link NodeId} :  coerceNodeId returns value
+ * @param value
+ * @param namespace {number}
+ */
+export function coerceNodeId(value: any, namespace?: number): NodeId {
+    let matches;
+    let twoFirst;
+    if (value instanceof NodeId) {
+        return value;
+    }
+
+    value = value || 0;
+    namespace = namespace || 0;
+
+    let identifierType = NodeIdType.NUMERIC;
+
+    if (typeof value === "string") {
+        identifierType = NodeIdType.STRING;
+
+        twoFirst = value.substr(0, 2);
+        if (twoFirst === "i=") {
+            identifierType = NodeIdType.NUMERIC;
+            value = parseInt(value.substr(2), 10);
+        } else if (twoFirst === "s=") {
+            identifierType = NodeIdType.STRING;
+            value = value.substr(2);
+        } else if (twoFirst === "b=") {
+            identifierType = NodeIdType.BYTESTRING;
+            value = Buffer.from(value.substr(2), "base64");
+        } else if (twoFirst === "g=") {
+            identifierType = NodeIdType.GUID;
+            value = value.substr(2);
+        } else if (isValidGuid(value)) {
+            identifierType = NodeIdType.GUID;
+        } else if ((matches = regexNamespaceI.exec(value)) !== null) {
+            identifierType = NodeIdType.NUMERIC;
+            namespace = parseInt(matches[1], 10);
+            value = parseInt(matches[2], 10);
+        } else if ((matches = regexNamespaceS.exec(value)) !== null) {
+            identifierType = NodeIdType.STRING;
+            namespace = parseInt(matches[1], 10);
+            value = matches[2];
+        } else if ((matches = regexNamespaceB.exec(value)) !== null) {
+            identifierType = NodeIdType.BYTESTRING;
+            namespace = parseInt(matches[1], 10);
+            value = Buffer.from(matches[2], "base64");
+        } else if ((matches = regexNamespaceG.exec(value)) !== null) {
+            identifierType = NodeIdType.GUID;
+            namespace = parseInt(matches[1], 10);
+            value = matches[2];
+        } else {
+            throw new Error("String cannot be coerced to a nodeId : " + value);
+        }
+    } else if (value instanceof Buffer) {
+        identifierType = NodeIdType.BYTESTRING;
+    } else if (value instanceof Object) {
+        // it could be a Enum or a NodeId Like object
+        const tmp = value;
+        value = tmp.value;
+        namespace = namespace || tmp.namespace;
+        identifierType = tmp.identifierType || identifierType;
+        return new NodeId(identifierType, value, namespace);
+    }
+    return new NodeId(identifierType, value, namespace);
+}
+
+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
+ * @return {NodeId}
+ */
+export function makeNodeId(value: string | Buffer | number, namespace?: number) {
+    value = value || 0;
+    namespace = namespace || 0;
+
+    let identifierType = NodeIdType.NUMERIC;
+    if (typeof value === "string") {
+        if (value.match(regEx1)) {
+            throw new Error("please use coerce NodeId instead");
+        }
+        //            1         2         3
+        //  012345678901234567890123456789012345
+        // "72962B91-FA75-4AE6-8D28-B404DC7DAF63"
+        if (isValidGuid(value)) {
+            identifierType = NodeIdType.GUID;
+        } else {
+            identifierType = NodeIdType.STRING;
+        }
+    } else if (value instanceof Buffer) {
+        identifierType = NodeIdType.BYTESTRING;
+    }
+
+    const nodeId = new NodeId(identifierType, value, namespace);
+    return nodeId;
+}
+
+// reverse maps
+let _nodeIdToNameIndex: any = {};
+let _nameToNodeIdIndex: any = {};
+
+const regName = /[a-zA-Z_].*/;
+
+(function build_standard_nodeid_indexes() {
+    function expand_map(directIndex: any) {
+        for (const name in directIndex) {
+            if (directIndex.hasOwnProperty(name) && regName.exec(name) !== null) {
+                const value = directIndex[name];
+                _nodeIdToNameIndex[value] = name;
+                _nameToNodeIdIndex[name] = new NodeId(NodeIdType.NUMERIC, value, 0);
+            }
+        }
+    }
+
+    _nodeIdToNameIndex = {};
+    _nameToNodeIdIndex = {};
+    expand_map(ObjectIds);
+    expand_map(ObjectTypeIds);
+    expand_map(VariableIds);
+    expand_map(VariableTypeIds);
+    expand_map(MethodIds);
+    expand_map(ReferenceTypeIds);
+    expand_map(DataTypeIds);
+})();
+
+function reverse_map(nodeId: string) {
+    return _nodeIdToNameIndex[nodeId];
+}
+
+/**
+ * @class opcua
+ * @method resolveNodeId
+ * @static
+ * @param nodeIdOrString
+ * @return the nodeId
+ */
+export function resolveNodeId(nodeIdOrString: NodeIdLike): NodeId {
+    let nodeId;
+
+    const rawId = typeof nodeIdOrString === "string" ? _nameToNodeIdIndex[nodeIdOrString] : undefined;
+    if (rawId !== undefined) {
+        return rawId;
+    } else {
+        nodeId = coerceNodeId(nodeIdOrString);
+    }
+    return nodeId;
+}
+
+NodeId.resolveNodeId = resolveNodeId;
+
+export function sameNodeId(n1: NodeId, n2: NodeId): boolean {
+    if (n1.identifierType !== n2.identifierType) {
+        return false;
+    }
+    if (n1.namespace !== n2.namespace) {
+        return false;
+    }
+    switch (n1.identifierType) {
+        case NodeIdType.NUMERIC:
+        case NodeIdType.STRING:
+            return n1.value === n2.value;
+        default:
+            return isEqual(n1.value, n2.value);
+    }
+}
+
+NodeId.sameNodeId = sameNodeId;