node-opcua-address-space 2.180.0 → 2.181.0

package/dist/source/loader/load_nodeset2.js

@@ -1,1047 +0,0 @@
-"use strict";
-/**
- * @module node-opcua-address-space
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NodeSetLoader = void 0;
-const node_util_1 = require("node:util");
-const chalk_1 = __importDefault(require("chalk"));
-const node_opcua_assert_1 = require("node-opcua-assert");
-const node_opcua_basic_types_1 = require("node-opcua-basic-types");
-const node_opcua_constants_1 = require("node-opcua-constants");
-const node_opcua_data_model_1 = require("node-opcua-data-model");
-const node_opcua_debug_1 = require("node-opcua-debug");
-const node_opcua_factory_1 = require("node-opcua-factory");
-const node_opcua_nodeid_1 = require("node-opcua-nodeid");
-const node_opcua_variant_1 = require("node-opcua-variant");
-const node_opcua_xml2json_1 = require("node-opcua-xml2json");
-const semver_1 = __importDefault(require("semver"));
-const ensure_datatype_extracted_1 = require("./ensure_datatype_extracted");
-const make_semver_compatible_1 = require("./make_semver_compatible");
-const namespace_post_step_1 = require("./namespace_post_step");
-const variant_parser_1 = require("./parsers/variant_parser");
-const doDebug = (0, node_opcua_debug_1.checkDebugFlag)(__filename);
-const debugLog = (0, node_opcua_debug_1.make_debugLog)(__filename);
-const errorLog = (0, node_opcua_debug_1.make_errorLog)(__filename);
-function __make_back_references(namespace) {
-    const namespaceP = namespace;
-    for (const node of namespaceP.nodeIterator()) {
-        node.propagate_back_references();
-    }
-    for (const node of namespaceP.nodeIterator()) {
-        node.install_extra_properties();
-    }
-}
-function make_back_references(addressSpace) {
-    const addressSpacePrivate = addressSpace;
-    addressSpacePrivate.suspendBackReference = false;
-    addressSpace.getNamespaceArray().map(__make_back_references);
-}
-function stringToUInt32Array(str) {
-    const array = str ? str.split(",").map((value) => parseInt(value, 10)) : null;
-    return array;
-}
-function convertAccessLevel(accessLevel) {
-    const accessLevelN = parseInt(accessLevel || "1", 10); // CurrentRead if not specified
-    return (0, node_opcua_data_model_1.makeAccessLevelFlag)(accessLevelN);
-}
-/**
- * the XSD gives UserAccessLevel a default of 1, but a nodeset that raises AccessLevel and stays
- * silent on UserAccessLevel means "the user may do whatever the node allows", not "read only".
- * Falling back on accessLevel is what every other stack does and what node-opcua has always done;
- * what changes here is that an *explicit* UserAccessLevel is no longer dropped.
- */
-function convertUserAccessLevel(userAccessLevel, accessLevel) {
-    if (userAccessLevel === undefined || userAccessLevel === null || userAccessLevel === "") {
-        return accessLevel;
-    }
-    return convertAccessLevel(userAccessLevel);
-}
-function convertAccessRestrictions(accessRestrictions) {
-    if (accessRestrictions === undefined || accessRestrictions === null || accessRestrictions === "") {
-        // undefined is not None: it means "inherit the namespace default"
-        return undefined;
-    }
-    const value = parseInt(accessRestrictions, 10);
-    if (Number.isNaN(value)) {
-        errorLog("load_nodeset2: ignoring invalid AccessRestrictions attribute", accessRestrictions);
-        return undefined;
-    }
-    return (0, node_opcua_data_model_1.makeAccessRestrictionsFlag)(value);
-}
-function makeDefaultVariant(addressSpace, dataTypeNode, valueRank, arrayDimensions) {
-    let variant = { dataType: node_opcua_variant_1.DataType.Null };
-    const nodeDataType = addressSpace.findNode(dataTypeNode);
-    if (nodeDataType?.basicDataType) {
-        const basicDataType = nodeDataType.basicDataType;
-        if (basicDataType === node_opcua_variant_1.DataType.Variant) {
-            /// we don't now what is the variant
-            return undefined;
-        }
-        if (basicDataType === node_opcua_variant_1.DataType.ExtensionObject) {
-            return { dataType: node_opcua_variant_1.DataType.ExtensionObject, value: null };
-        }
-        const builtInType = (0, node_opcua_factory_1.getBuiltInType)(node_opcua_variant_1.DataType[basicDataType]);
-        if (builtInType === undefined || builtInType === null) {
-            errorLog("Cannot find builtInType for ", basicDataType);
-            return { dataType: node_opcua_variant_1.DataType.Null };
-        }
-        const dv = builtInType.defaultValue;
-        const value = typeof dv === "function" ? dv() : dv;
-        let arrayType;
-        /*
-         *  * n > 1                     : the Value is an array with the specified number of dimensions.
-         *  * OneDimension (1):           The value is an array with one dimension.
-         *  * OneOrMoreDimensions (0):    The value is an array with one or more dimensions.
-         *  * Scalar (-1):                The value is not an array.
-         *  * Any (-2):                   The value can be a scalar or an array with any number of dimensions.
-         *  * ScalarOrOneDimension (-3):  The value can be a scalar or a one dimensional array.
-         */
-        switch (valueRank) {
-            case -3: //  ScalarOrOneDimension (-3):
-            case -2: // any
-            case -1:
-                arrayType = node_opcua_variant_1.VariantArrayType.Scalar;
-                variant = { dataType: basicDataType, value, arrayType };
-                break;
-            case 0: // one or more dimension
-            case 1: // one dimension
-                arrayType = node_opcua_variant_1.VariantArrayType.Array;
-                variant = { dataType: basicDataType, value: [], arrayType };
-                break;
-            default:
-                arrayType = node_opcua_variant_1.VariantArrayType.Matrix;
-                variant = { dataType: basicDataType, value: [], arrayType, dimensions: arrayDimensions };
-                break;
-        }
-    }
-    return variant;
-}
-/**
- * a Matrix variant is "uninitialized" when it carries no element (value=[]) but declares
- * non-zero dimensions (e.g. ArrayDimensions="256,128"). Such a variant is internally inconsistent
- * (value.length !== product(dimensions)) and, if serialized, produces a spec-violating wire form.
- */
-function isUninitializedMatrix(value) {
-    if (value.arrayType !== node_opcua_variant_1.VariantArrayType.Matrix) {
-        return false;
-    }
-    const length = Array.isArray(value.value) ? value.value.length : 0;
-    if (length !== 0) {
-        return false;
-    }
-    const dimensions = value.dimensions;
-    if (!dimensions || dimensions.length === 0) {
-        return false;
-    }
-    const product = dimensions.reduce((n, p) => n * p, 1);
-    return product > 0;
-}
-function makeNodeSetParserEngine(addressSpace, options) {
-    const addressSpace1 = addressSpace;
-    addressSpace1.suspendBackReference = true;
-    options.loadDeprecatedNodes = options.loadDeprecatedNodes === undefined ? true : options.loadDeprecatedNodes;
-    options.loadDraftNodes = options.loadDraftNodes || false;
-    const postTasks = [];
-    const postTasks0_InitializeVariable = [];
-    const postTasks0_DecodePojoString = [];
-    const postTasks1_InitializeVariable = [];
-    const postTasks2_AssignedExtensionObjectToDataValue = [];
-    const aliasMap = new Map();
-    /**
-     * @param aliasName
-     */
-    function addAlias(aliasName, nodeIdInXmlContext) {
-        (0, node_opcua_assert_1.assert)(typeof nodeIdInXmlContext === "string");
-        const nodeId = _translateNodeId(nodeIdInXmlContext);
-        (0, node_opcua_assert_1.assert)(nodeId instanceof node_opcua_nodeid_1.NodeId);
-        aliasMap.set(aliasName, nodeId);
-        addressSpace1.getNamespace(nodeId.namespace).addAlias(aliasName, nodeId);
-    }
-    const namespaceUriTranslationMap = new Map();
-    let namespaceCounter = 0;
-    const foundNamespaceMap = new Map();
-    let models = [];
-    let performedCalled = false;
-    function _reset_namespace_translation() {
-        // c8 ignore next
-        doDebug && debugLog("_reset_namespace_translation");
-        namespaceUriTranslationMap.clear();
-        foundNamespaceMap.clear();
-        namespaceCounter = 0;
-        aliasMap.clear();
-        models = [];
-        performedCalled = false;
-    }
-    function _translateNamespaceIndex(innerIndex) {
-        const namespaceIndex = namespaceUriTranslationMap.get(innerIndex);
-        // c8 ignore next
-        if (namespaceIndex === undefined) {
-            errorLog("Error; namespace_uri_translation", namespaceUriTranslationMap.entries());
-            throw new Error(`_translateNamespaceIndex() ! Cannot find namespace definition for index ${innerIndex}`);
-        }
-        return namespaceIndex;
-    }
-    function _internal_addReferenceType(params) {
-        // c8 ignore next
-        if (!(params.nodeId instanceof node_opcua_nodeid_1.NodeId)) {
-            throw new Error("invalid param");
-        } // already translated
-        const namespace = addressSpace1.getNamespace(params.nodeId?.namespace);
-        namespace.addReferenceType(params);
-    }
-    function _internal_createNode(params) {
-        // c8 ignore next
-        if (!(params.nodeId instanceof node_opcua_nodeid_1.NodeId)) {
-            throw new Error("invalid param expecting a valid nodeId");
-        } // already translated
-        const namespace = addressSpace1.getNamespace(params.nodeId.namespace);
-        return namespace.internalCreateNode(params);
-    }
-    function _register_namespace_uri_in_translation_table(namespaceUri) {
-        if (foundNamespaceMap.has(namespaceUri)) {
-            return;
-        }
-        const namespace = addressSpace1.getNamespace(namespaceUri);
-        // c8 ignore next
-        if (!namespace) {
-            throw new Error("cannot find namespace for " +
-                namespaceUri +
-                "\nplease make sure to initialize your address space with the corresponding nodeset files");
-        }
-        foundNamespaceMap.set(namespaceUri, namespace);
-        const index_in_xml = namespaceCounter;
-        namespaceCounter++;
-        namespaceUriTranslationMap.set(index_in_xml, namespace.index);
-        doDebug &&
-            debugLog(" _register_namespace_uri = ", namespaceUri, "index in Xml=", index_in_xml, " index in addressSpace", namespace.index);
-    }
-    function _add_namespace(model) {
-        if (model.requiredModels.length > 0) {
-            // check that required models exist already in the address space
-            for (const requiredModel of model.requiredModels) {
-                const existingNamespace = addressSpace1.getNamespace(requiredModel.modelUri);
-                // c8 ignore next
-                if (!existingNamespace) {
-                    errorLog("Please ensure that the required namespace", requiredModel.modelUri, "is loaded first when loading", model.modelUri);
-                    throw new Error(`LoadNodeSet : Cannot find namespace for ${requiredModel.modelUri}`);
-                }
-                /**
-                 *  from https://reference.opcfoundation.org/Core/docs/Part6/F.2/
-                 *  The version of the model defined in the UANodeSet.
-                 *  This is a human-readable string and not intended for programmatic comparisons.
-                 */
-                const isLowerVersion = (existingVersion, requiredVersion) => {
-                    const existingSemver = (0, make_semver_compatible_1.makeSemverCompatible)(existingVersion);
-                    const requiredSemver = (0, make_semver_compatible_1.makeSemverCompatible)(requiredVersion);
-                    return semver_1.default.lt(existingSemver, requiredSemver);
-                };
-                if (isLowerVersion(existingNamespace.version, requiredModel.version)) {
-                    errorLog("Expecting ", requiredModel.modelUri, " with version to be at least", requiredModel.version, " but namespace version is ", existingNamespace.version);
-                }
-                if (existingNamespace.publicationDate.getTime() < requiredModel.publicationDate.getTime()) {
-                    errorLog("Expecting ", requiredModel.modelUri, " with publicationDate at least ", requiredModel.publicationDate.toUTCString(), " but namespace publicationDate is ", existingNamespace.publicationDate.toUTCString());
-                }
-            }
-        }
-        let namespace;
-        // Model must not be already registered
-        const existingNamespace = addressSpace1.getNamespace(model.modelUri);
-        if (existingNamespace) {
-            namespace = existingNamespace;
-        }
-        else {
-            namespace = addressSpace1.registerNamespace(model.modelUri);
-            namespace.setRequiredModels(model.requiredModels);
-        }
-        namespace.version = model.version;
-        namespace.publicationDate = model.publicationDate || namespace.publicationDate;
-        return namespace;
-    }
-    const reg = /ns=([0-9]+);(.*)/;
-    function _translateNodeId(nodeId) {
-        if (aliasMap.has(nodeId)) {
-            // note alias are already translated to the right namespaces
-            const aliasedNodeId = aliasMap.get(nodeId);
-            if (aliasedNodeId) {
-                return aliasedNodeId;
-            }
-        }
-        const m = nodeId.match(reg);
-        if (m) {
-            const namespaceIndex = _translateNamespaceIndex(parseInt(m[1], 10));
-            nodeId = `ns=${namespaceIndex};${m[2]}`;
-        }
-        return (0, node_opcua_nodeid_1.resolveNodeId)(nodeId);
-    }
-    function _translateReferenceType(refType) {
-        return _translateNodeId(refType);
-    }
-    /**
-     * convert a nodeId
-     *
-     *
-     * @example
-     *    convertToNodeId("String") => resolve alias
-     *    convertToNodeId("i=58")   => resolve to nodeId in namespace 0
-     *    convertToNodeId("ns=1;i=100") => convert namespace from xml namespace
-     *                                      table to corresponding namespace in addressSpace
-     */
-    function convertToNodeId(nodeIdLike) {
-        // treat alias
-        if (!nodeIdLike) {
-            return null;
-        }
-        const nodeId = _translateNodeId(nodeIdLike);
-        return addressSpace1.resolveNodeId(nodeId);
-    }
-    function convertQualifiedName(qualifiedName) {
-        const qn = (0, node_opcua_data_model_1.stringToQualifiedName)(qualifiedName);
-        // Xx if (qn.namespaceIndex > 0) {
-        qn.namespaceIndex = _translateNamespaceIndex(qn.namespaceIndex);
-        // Xx }
-        return qn;
-    }
-    const state_Alias = {
-        // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-        finish() {
-            addAlias(this.attrs.Alias, this.text);
-        }
-    };
-    const references_parser = {
-        // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-        init() {
-            this.parent.obj.references = [];
-            this.array = this.parent.obj.references;
-        },
-        parser: {
-            Reference: {
-                // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-                finish() {
-                    this.parent.array.push({
-                        isForward: this.attrs.IsForward === undefined ? true : this.attrs.IsForward !== "false",
-                        nodeId: convertToNodeId(this.text),
-                        referenceType: _translateReferenceType(this.attrs.ReferenceType)
-                    });
-                }
-            }
-        }
-    };
-    // #region access policy (AccessRestrictions / HasNoPermissions / RolePermissions)
-    // two independent switches: who may do what is a property of the model and applies by
-    // default, whereas how the channel must be secured is a property of the deployment and
-    // is opt-in. See NodeSetLoaderOptions.
-    const applyRolePermissions = (options.permissions ?? "apply") === "apply";
-    const applyAccessRestrictions = (options.accessRestrictions ?? "ignore") === "apply";
-    /**
-     * read the access policy carried by the attributes of any UANode.
-     * The `<RolePermissions>` element is handled separately by `role_permissions_parser`.
-     */
-    function convertNodePermissions(attrs) {
-        return {
-            accessRestrictions: applyAccessRestrictions ? convertAccessRestrictions(attrs.AccessRestrictions) : undefined,
-            // HasNoPermissions="true" is not the same as an absent <RolePermissions>: the former
-            // grants nothing at all, the latter inherits the namespace default. An empty array
-            // is how BaseNode distinguishes the two.
-            rolePermissions: applyRolePermissions && (0, node_opcua_basic_types_1.coerceBoolean)(attrs.HasNoPermissions) ? [] : undefined
-        };
-    }
-    const role_permissions_parser = {
-        // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-        init() {
-            this.array = [];
-            if (applyRolePermissions) {
-                this.parent.obj.rolePermissions = this.array;
-            }
-        },
-        parser: {
-            RolePermission: {
-                // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-                finish() {
-                    this.parent.array.push({
-                        roleId: _translateNodeId(this.text.trim()),
-                        permissions: parseInt(this.attrs.Permissions || "0", 10)
-                    });
-                }
-            }
-        }
-    };
-    // #endregion
-    // #region UAObject
-    const state_UAObject = {
-        // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-        init(_name, attrs) {
-            _perform();
-            this.obj = {
-                nodeClass: node_opcua_data_model_1.NodeClass.Object,
-                isAbstract: (0, node_opcua_basic_types_1.coerceBoolean)(attrs.IsAbstract),
-                nodeId: convertToNodeId(attrs.NodeId) || null,
-                browseName: convertQualifiedName(attrs.BrowseName),
-                eventNotifier: (0, node_opcua_basic_types_1.coerceByte)(attrs.EventNotifier) || 0,
-                symbolicName: attrs.SymbolicName || null,
-                ...convertNodePermissions(attrs)
-            };
-            this.isDraft = attrs.ReleaseStatus === "Draft";
-            this.isDeprecated = attrs.ReleaseStatus === "Deprecated";
-        },
-        // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-        finish() {
-            if (canIgnore({ isDraft: this.isDraft, isDeprecated: this.isDeprecated }, this.obj)) {
-                return;
-            }
-            _internal_createNode(this.obj);
-        },
-        parser: {
-            DisplayName: {
-                // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-                finish() {
-                    this.parent.obj.displayName = this.text;
-                }
-            },
-            Description: {
-                // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-                finish() {
-                    this.parent.obj.description = this.text;
-                }
-            },
-            References: references_parser,
-            RolePermissions: role_permissions_parser
-        }
-    };
-    // #endregion
-    // #region UAObjectType
-    const state_UAObjectType = {
-        // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-        init(_name, attrs) {
-            _perform();
-            this.obj = {
-                nodeClass: node_opcua_data_model_1.NodeClass.ObjectType,
-                isAbstract: (0, node_opcua_basic_types_1.coerceBoolean)(attrs.IsAbstract),
-                nodeId: convertToNodeId(attrs.NodeId) || null,
-                browseName: convertQualifiedName(attrs.BrowseName),
-                eventNotifier: (0, node_opcua_basic_types_1.coerceByte)(attrs.EventNotifier) || 0,
-                ...convertNodePermissions(attrs)
-            };
-        },
-        // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-        finish() {
-            _internal_createNode(this.obj);
-        },
-        parser: {
-            DisplayName: {
-                // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-                finish() {
-                    this.parent.obj.displayName = this.text;
-                }
-            },
-            Description: {
-                // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-                finish() {
-                    this.parent.obj.description = this.text;
-                }
-            },
-            References: references_parser,
-            RolePermissions: role_permissions_parser
-        }
-    };
-    // #endregion
-    // #region UAReferenceType
-    const state_UAReferenceType = {
-        // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-        init(_name, attrs) {
-            _perform();
-            this.obj = {
-                nodeClass: node_opcua_data_model_1.NodeClass.ReferenceType,
-                isAbstract: (0, node_opcua_basic_types_1.coerceBoolean)(attrs.IsAbstract),
-                nodeId: convertToNodeId(attrs.NodeId) || null,
-                browseName: convertQualifiedName(attrs.BrowseName),
-                ...convertNodePermissions(attrs)
-            };
-        },
-        // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-        finish() {
-            _internal_addReferenceType(this.obj);
-        },
-        parser: {
-            DisplayName: {
-                // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-                finish() {
-                    this.parent.obj.displayName = this.text;
-                }
-            },
-            Description: {
-                // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-                finish() {
-                    this.parent.obj.description = this.text;
-                }
-            },
-            InverseName: {
-                // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-                finish() {
-                    this.parent.obj.inverseName = this.text;
-                }
-            },
-            References: references_parser,
-            RolePermissions: role_permissions_parser
-        }
-    };
-    // #endregion
-    // #region UADataType
-    const pendingSimpleTypeToRegister = [];
-    const state_UADataType = {
-        init(_name, attrs) {
-            _perform();
-            this.obj = {
-                nodeClass: node_opcua_data_model_1.NodeClass.DataType,
-                isAbstract: (0, node_opcua_basic_types_1.coerceBoolean)(attrs.IsAbstract) || false,
-                nodeId: convertToNodeId(attrs.NodeId) || undefined,
-                browseName: convertQualifiedName(attrs.BrowseName),
-                displayName: "",
-                description: "",
-                symbolicName: attrs.SymbolicName,
-                partialDefinition: [],
-                ...convertNodePermissions(attrs)
-            };
-            this.isDraft = attrs.ReleaseStatus === "Draft";
-            this.isDeprecated = attrs.ReleaseStatus === "Deprecated";
-            this.definitionFields = [];
-        },
-        finish() {
-            if (canIgnore({ isDraft: this.isDraft, isDeprecated: this.isDeprecated }, this.obj)) {
-                return;
-            }
-            const definitionFields = this.definitionFields;
-            // replace DataType with nodeId, and description to LocalizedText
-            // biome-ignore lint/suspicious/noExplicitAny: fields transition from raw XML strings to typed objects
-            for (const x of definitionFields) {
-                if (x.description) {
-                    x.description = { text: x.description };
-                }
-                if (x.displayName) {
-                    x.displayName = { text: x.displayName };
-                }
-                if (x.dataType) {
-                    x.dataType = convertToNodeId(x.dataType);
-                }
-                else {
-                    x.dataType = (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.DataTypeIds.BaseDataType);
-                }
-                if (x.allowSubTypes) {
-                    x.allowSubTypes = (0, node_opcua_basic_types_1.coerceBoolean)(x.allowSubTypes);
-                }
-            }
-            this.obj.partialDefinition = definitionFields;
-            let capturedDataTypeNode = _internal_createNode(this.obj);
-            const processBasicDataType = async (_addressSpace2) => {
-                if (!capturedDataTypeNode)
-                    return;
-                const definitionName = capturedDataTypeNode.browseName.name || "";
-                const isStructure = capturedDataTypeNode.isStructure();
-                const isEnumeration = capturedDataTypeNode.isEnumeration();
-                if (!isEnumeration && !isStructure && capturedDataTypeNode.nodeId.namespace !== 0) {
-                    // add a custom basic type that is not a structure nor a enumeration
-                    pendingSimpleTypeToRegister.push({ name: definitionName, dataTypeNodeId: capturedDataTypeNode.nodeId });
-                }
-                capturedDataTypeNode = undefined;
-            };
-            postTasks.push(processBasicDataType);
-        },
-        parser: {
-            DisplayName: {
-                finish() {
-                    this.parent.obj.displayName = this.text;
-                }
-            },
-            Description: {
-                finish() {
-                    this.parent.obj.description = this.text;
-                }
-            },
-            References: references_parser,
-            RolePermissions: role_permissions_parser,
-            Definition: node_opcua_xml2json_1._definitionParser
-        }
-    };
-    // #endregion
-    const canIgnore = ({ isDraft, isDeprecated }, node) => {
-        if (isDraft && !options.loadDraftNodes) {
-            // c8 ignore next
-            doDebug && debugLog("Ignoring Draft            =", node_opcua_data_model_1.NodeClass[node.nodeClass], node.browseName.toString());
-            return true;
-        }
-        if (isDeprecated && !options.loadDeprecatedNodes) {
-            // c8 ignore next
-            doDebug && debugLog("Ignoring Deprecate        =", node_opcua_data_model_1.NodeClass[node.nodeClass], node.browseName.toString());
-            return true;
-        }
-        return false;
-    };
-    function fixExtensionObjectAndArray(obj, deferred) {
-        // let's create the mechanism that postpone the assignment of the extension object
-        const capturedNode = obj;
-        const task = async (addressSpace2) => {
-            const extensionObjOrArray = deferred();
-            const nodeId = capturedNode.nodeId;
-            (0, node_opcua_assert_1.assert)(nodeId, "expecting a nodeid");
-            const node = addressSpace2.findNode(nodeId);
-            if (!node)
-                return;
-            if (node.nodeClass === node_opcua_data_model_1.NodeClass.Variable) {
-                const v = node;
-                (0, node_opcua_assert_1.assert)(v.getBasicDataType() === node_opcua_variant_1.DataType.ExtensionObject, "expecting an extension object");
-                if (extensionObjOrArray != null) {
-                    v.bindExtensionObject(extensionObjOrArray, { createMissingProp: false });
-                }
-            }
-            else if (node.nodeClass === node_opcua_data_model_1.NodeClass.VariableType) {
-                const v = node;
-                v.value.value = extensionObjOrArray;
-            }
-        };
-        postTasks2_AssignedExtensionObjectToDataValue.push(task);
-    }
-    const state_UAVariable = {
-        init(_name, attrs) {
-            _perform();
-            const valueRank = attrs.ValueRank === undefined ? -1 : (0, node_opcua_basic_types_1.coerceInt32)(attrs.ValueRank);
-            const accessLevel = convertAccessLevel(attrs.AccessLevel);
-            const nodeId = convertToNodeId(attrs.NodeId);
-            this.obj = {
-                value: undefined, //  { dataType: DataType.Null },
-                nodeClass: node_opcua_data_model_1.NodeClass.Variable,
-                browseName: convertQualifiedName(attrs.BrowseName),
-                parentNodeId: convertToNodeId(attrs.ParentNodeId),
-                dataType: convertToNodeId(attrs.DataType),
-                //description: null,
-                // displayName: coerceLocalizedText(attrs.BrowseName)!,
-                valueRank,
-                arrayDimensions: valueRank <= 0 ? null : stringToUInt32Array(attrs.ArrayDimensions),
-                minimumSamplingInterval: attrs.MinimumSamplingInterval ? parseInt(attrs.MinimumSamplingInterval, 10) : 0,
-                historizing: (0, node_opcua_basic_types_1.coerceBoolean)(attrs.Historizing),
-                nodeId,
-                accessLevel: accessLevel,
-                userAccessLevel: convertUserAccessLevel(attrs.UserAccessLevel, accessLevel),
-                ...convertNodePermissions(attrs)
-            };
-            this.isDraft = attrs.ReleaseStatus === "Draft" || false;
-            this.isDeprecated = attrs.ReleaseStatus === "Deprecated" || false;
-        },
-        finish() {
-            if (canIgnore({ isDraft: this.isDraft, isDeprecated: this.isDeprecated }, this.obj)) {
-                return;
-            }
-            /*
-            // set default value based on obj data Type
-            if (this.obj.value === undefined) {
-                const dataTypeNode = this.obj.dataType;
-                const valueRank = this.obj.valueRank;
-                this.obj.value = makeDefaultVariant(addressSpace, dataTypeNode, valueRank);
-            }
-            */
-            let capturedVariable;
-            if (this.obj.value && this.obj.value.dataType !== node_opcua_variant_1.DataType.Null) {
-                let capturedValue = this.obj.value;
-                const task = async (_addressSpace2) => {
-                    if (!capturedVariable)
-                        return;
-                    const cv = capturedVariable;
-                    // biome-ignore lint/correctness/noConstantCondition: deliberate debug on/off toggle, not dead code
-                    if (false && doDebug) {
-                        // c8 ignore next
-                        doDebug && debugLog("1 setting value to ", cv.nodeId.toString(), new node_opcua_variant_1.Variant(capturedValue).toString());
-                    }
-                    cv.setValueFromSource(capturedValue);
-                    capturedValue = undefined;
-                    capturedVariable = undefined;
-                };
-                if (capturedValue.dataType !== node_opcua_variant_1.DataType.ExtensionObject) {
-                    postTasks0_InitializeVariable.push(task);
-                }
-                else {
-                    // do them later when every thing is created
-                    postTasks1_InitializeVariable.push(task);
-                }
-            }
-            else {
-                const task = async (_addressSpace2) => {
-                    if (!capturedVariable)
-                        return;
-                    const cv = capturedVariable;
-                    const dataTypeNode = cv.dataType;
-                    const valueRank = cv.valueRank;
-                    const arrayDimensions = cv.arrayDimensions;
-                    const value = makeDefaultVariant(addressSpace, dataTypeNode, valueRank, arrayDimensions);
-                    if (value) {
-                        // biome-ignore lint/correctness/noConstantCondition: deliberate debug on/off toggle, not dead code
-                        if (false && doDebug) {
-                            // c8 ignore next
-                            doDebug && debugLog("2 setting value to ", cv.nodeId.toString(), value);
-                        }
-                        // a Matrix variable declared with fixed ArrayDimensions but no <Value> is built with
-                        // an empty value (value=[]) yet non-zero declared dimensions. This is an *uninitialized*
-                        // and internally inconsistent matrix (value.length !== product(dimensions)). Advertising
-                        // it as Good would put a spec-violating matrix on the wire (ArraySize 0 + non-empty
-                        // ArrayDimensions), so flag it as BadWaitingForInitialData like any other missing value.
-                        if (value.dataType === node_opcua_variant_1.DataType.Null || isUninitializedMatrix(value)) {
-                            cv.setValueFromSource(value, node_opcua_basic_types_1.StatusCodes.BadWaitingForInitialData);
-                        }
-                        else {
-                            cv.setValueFromSource(value, node_opcua_basic_types_1.StatusCodes.Good);
-                        }
-                    }
-                    capturedVariable = undefined;
-                };
-                postTasks0_InitializeVariable.push(task);
-            }
-            this.obj.value = Object.create(null);
-            capturedVariable = _internal_createNode(this.obj);
-        },
-        parser: {
-            DisplayName: {
-                finish() {
-                    this.parent.obj.displayName = (0, node_opcua_data_model_1.coerceLocalizedText)(this.text) ?? undefined;
-                }
-            },
-            Description: {
-                finish() {
-                    this.parent.obj.description = (0, node_opcua_data_model_1.coerceLocalizedText)(this.text) ?? undefined;
-                }
-            },
-            References: references_parser,
-            RolePermissions: role_permissions_parser,
-            Value: (0, variant_parser_1.makeVariantReader)((self, data) => {
-                self.parent.obj.value = data;
-            }, (self, data, deferredTask) => {
-                self.parent.obj.value = data;
-                const capturedVariable = { nodeId: self.parent.obj.nodeId ?? node_opcua_nodeid_1.NodeId.nullNodeId };
-                fixExtensionObjectAndArray(capturedVariable, deferredTask);
-            }, (task) => {
-                postTasks0_DecodePojoString.push(task);
-            }, _translateNodeId)
-        }
-    };
-    const state_UAVariableType = {
-        init(_name, attrs) {
-            _perform();
-            const valueRank = (0, node_opcua_basic_types_1.coerceInt32)(attrs.ValueRank) || -1;
-            this.obj = {
-                value: undefined, // { dataType: DataType.Null },
-                isAbstract: (0, node_opcua_basic_types_1.coerceBoolean)(attrs.IsAbstract),
-                nodeClass: node_opcua_data_model_1.NodeClass.VariableType,
-                browseName: convertQualifiedName(attrs.BrowseName),
-                parentNodeId: convertToNodeId(attrs.ParentNodeId) || null,
-                dataType: convertToNodeId(attrs.DataType) || null,
-                valueRank,
-                arrayDimensions: valueRank <= 0 ? null : stringToUInt32Array(attrs.ArrayDimensions),
-                minimumSamplingInterval: attrs.MinimumSamplingInterval ? parseInt(attrs.MinimumSamplingInterval, 10) : 0,
-                // UAVariableType has no Historizing attribute in the XSD: keep it false
-                historizing: false,
-                nodeId: convertToNodeId(attrs.NodeId) || null,
-                ...convertNodePermissions(attrs)
-            };
-            this.isDraft = attrs.ReleaseStatus === "Draft";
-            this.isDeprecated = attrs.ReleaseStatus === "Deprecated";
-        },
-        finish() {
-            if (canIgnore({ isDraft: this.isDraft, isDeprecated: this.isDeprecated }, this.obj)) {
-                return;
-            }
-            _internal_createNode(this.obj);
-        },
-        parser: {
-            DisplayName: {
-                finish() {
-                    this.parent.obj.displayName = (0, node_opcua_data_model_1.coerceLocalizedText)(this.text || "") ?? undefined;
-                }
-            },
-            Description: {
-                finish() {
-                    this.parent.obj.description = (0, node_opcua_data_model_1.coerceLocalizedText)(this.text || "") ?? undefined;
-                }
-            },
-            References: references_parser,
-            RolePermissions: role_permissions_parser,
-            Value: (0, variant_parser_1.makeVariantReader)((self, data) => {
-                self.parent.obj.value = data;
-            }, (self, data, deferredTask) => {
-                self.parent.obj.value = data;
-                const capturedVariable = { nodeId: self.parent.obj.nodeId ?? node_opcua_nodeid_1.NodeId.nullNodeId };
-                fixExtensionObjectAndArray(capturedVariable, deferredTask);
-            }, (task) => {
-                postTasks0_DecodePojoString.push(task);
-            }, _translateNodeId)
-        }
-    };
-    // #endregion
-    // #region UAMethod
-    const state_UAMethod = {
-        // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-        init(_name, attrs) {
-            _perform();
-            this.obj = {
-                nodeClass: node_opcua_data_model_1.NodeClass.Method,
-                // MethodDeclarationId
-                // ParentNodeId
-                browseName: convertQualifiedName(attrs.BrowseName),
-                parentNodeId: attrs.ParentNodeId || null,
-                nodeId: convertToNodeId(attrs.NodeId) || null,
-                methodDeclarationId: attrs.MethodDeclarationId ? _translateNodeId(attrs.MethodDeclarationId) : null,
-                ...convertNodePermissions(attrs)
-            };
-            this.isDraft = attrs.ReleaseStatus === "Draft";
-            this.isDeprecated = attrs.ReleaseStatus === "Deprecated";
-        },
-        // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-        finish() {
-            if (canIgnore({ isDraft: this.isDraft, isDeprecated: this.isDeprecated }, this.obj)) {
-                return;
-            }
-            _internal_createNode(this.obj);
-        },
-        parser: {
-            DisplayName: {
-                // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-                finish() {
-                    this.parent.obj.displayName = this.text;
-                }
-            },
-            References: references_parser,
-            RolePermissions: role_permissions_parser
-        }
-    };
-    const state_ModelTableEntry = new node_opcua_xml2json_1.ReaderState({
-        // ModelTableEntry
-        // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-        init() {
-            this._requiredModels = [];
-        },
-        parser: {
-            RequiredModel: {
-                // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-                init(_name, attrs) {
-                    const modelUri = attrs.ModelUri;
-                    const version = attrs.Version;
-                    const publicationDate = new Date(Date.parse(attrs.PublicationDate));
-                    this.parent._requiredModels.push({ modelUri, version, publicationDate });
-                },
-                // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-                finish() {
-                    /** */
-                }
-            }
-        },
-        // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-        finish() {
-            const modelUri = this.attrs.ModelUri; // //"http://opcfoundation.org/UA/"
-            const version = this.attrs.Version; // 1.04
-            const publicationDate = this.attrs.PublicationDate ? new Date(Date.parse(this.attrs.PublicationDate)) : undefined; // "2018-05-15T00:00:00Z" "
-            // optional,
-            const symbolicName = this.attrs.SymbolicName;
-            const accessRestrictions = this.attrs.AccessRestrictions;
-            const model = {
-                accessRestrictions,
-                modelUri,
-                publicationDate,
-                requiredModels: this._requiredModels,
-                symbolicName,
-                version
-            };
-            const _namespace = _add_namespace(model);
-            models.push(model);
-        }
-    });
-    // #endregion
-    function _updateTranslationTable() {
-        _register_namespace_uri_in_translation_table("http://opcfoundation.org/UA/");
-        for (const namespaceUri of _namespaceUris) {
-            _register_namespace_uri_in_translation_table(namespaceUri);
-        }
-    }
-    function _perform() {
-        if (performedCalled)
-            return;
-        performedCalled = true;
-        /**special case for old nodeset file version 1.02 where no models exists */
-        if (models.length === 0) {
-            for (const namespaceuri of _namespaceUris) {
-                const existingNamespace = addressSpace1.getNamespace(namespaceuri);
-                if (existingNamespace) {
-                    continue;
-                }
-                _add_namespace({
-                    modelUri: namespaceuri,
-                    version: "1.0.0",
-                    requiredModels: []
-                });
-            }
-        }
-        _updateTranslationTable();
-    }
-    // state_ModelTableEntry.parser["RequiredModel"] = state_ModelTableEntry;
-    let _namespaceUris = [];
-    const state_0 = {
-        parser: {
-            Aliases: {
-                // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-                init() {
-                    _perform();
-                },
-                parser: { Alias: state_Alias }
-            },
-            NamespaceUris: {
-                // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-                init() {
-                    //
-                    _namespaceUris = [];
-                },
-                parser: {
-                    Uri: {
-                        // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-                        finish() {
-                            _namespaceUris.push(this.text);
-                        }
-                    }
-                },
-                // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-                finish() {
-                    // verify that requested namespaces are already loaded or abort with a message
-                }
-            },
-            Models: {
-                // ModelTable
-                // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-                init(_name, _attrs) {
-                    /* */
-                },
-                parser: {
-                    Model: state_ModelTableEntry
-                },
-                // biome-ignore lint/suspicious/noExplicitAny: xml2json parser callback with dynamic this binding
-                finish() {
-                    /** */
-                }
-            },
-            UADataType: state_UADataType,
-            UAMethod: state_UAMethod,
-            UAObject: state_UAObject,
-            UAObjectType: state_UAObjectType,
-            UAReferenceType: state_UAReferenceType,
-            UAVariable: state_UAVariable,
-            UAVariableType: state_UAVariableType
-        }
-    };
-    const parser = new node_opcua_xml2json_1.Xml2Json(state_0);
-    async function terminate() {
-        make_back_references(addressSpace1);
-        // setting up Server_NamespaceArray
-        if (addressSpace1.rootFolder?.objects?.server?.namespaceArray) {
-            addressSpace1.rootFolder.objects.server.namespaceArray.setValueFromSource({
-                arrayType: node_opcua_variant_1.VariantArrayType.Array,
-                dataType: node_opcua_variant_1.DataType.String,
-                value: addressSpace1.getNamespaceArray().map((ns) => ns.namespaceUri)
-            });
-            // c8 ignore next
-            if (doDebug) {
-                debugLog("addressSpace NS = ", addressSpace1.rootFolder.objects.server.namespaceArray.readValue().value.value.join(" "));
-            }
-        }
-        doDebug &&
-            debugLog(chalk_1.default.bgGreenBright("Performing post loading tasks -------------------------------------------") +
-                chalk_1.default.green("DONE"));
-        /**
-         * run every queued post-loading task.
-         *
-         * A task that throws (typically: a `<Value>` in a third-party nodeset that does not
-         * match the declared DataType) is logged and skipped — it must NOT abort the remaining
-         * tasks nor the remaining stages of finalSteps(). Previously the failing task was
-         * re-run inside the catch block, the second throw escaped the loop, finalSteps() was
-         * abandoned and `ensureDatatypeExtracted` was never called: the address space was
-         * left half-initialised (no DataTypeManager) and any later use of a structured
-         * DataType failed with an opaque
-         * "Cannot read properties of undefined (reading 'getExtensionObjectConstructorFromDataType')".
-         */
-        async function performPostLoadingTasks(stage, tasks) {
-            for (const task of tasks) {
-                try {
-                    await task(addressSpace1);
-                }
-                catch (err) {
-                    // c8 ignore next
-                    if (node_util_1.types.isNativeError(err)) {
-                        errorLog(`[NODE-OPCUA-W36] generateAddressSpace: post-loading task failed during "${stage}" and was skipped: ${err.message}`);
-                        doDebug && debugLog(err);
-                    }
-                }
-            }
-            tasks.splice(0);
-        }
-        async function finalSteps() {
-            /// ----------------------------------------------------------------------------------------
-            // perform post task
-            doDebug && debugLog(chalk_1.default.bgGreenBright("Performing post loading tasks -------------------------------------------"));
-            await performPostLoadingTasks("post tasks", postTasks);
-            doDebug &&
-                debugLog(chalk_1.default.bgGreenBright("Performing post loading task: Initializing Simple Variables ---------------------"));
-            await performPostLoadingTasks("initializing simple variables", postTasks0_InitializeVariable);
-            doDebug && debugLog(chalk_1.default.bgGreenBright("Performing DataType extraction -------------------------------------------"));
-            (0, node_opcua_assert_1.assert)(!addressSpace1.suspendBackReference);
-            await (0, ensure_datatype_extracted_1.ensureDatatypeExtracted)(addressSpace);
-            const dataTypeManager = addressSpace.getDataTypeManager();
-            /// ----------------------------------------------------------------------------------------
-            doDebug && debugLog(chalk_1.default.bgGreenBright("DataType extraction done ") + chalk_1.default.green("DONE"));
-            for (const { name: _name, dataTypeNodeId } of pendingSimpleTypeToRegister) {
-                if (dataTypeNodeId.namespace === 0) {
-                    continue;
-                }
-                dataTypeManager.getDataTypeFactoryForNamespace(dataTypeNodeId.namespace);
-            }
-            pendingSimpleTypeToRegister.splice(0);
-            doDebug && debugLog(chalk_1.default.bgGreenBright("Performing post loading task: Decoding Pojo String (parsing XML objects) -"));
-            await performPostLoadingTasks("decoding XML extension objects", postTasks0_DecodePojoString);
-            doDebug &&
-                debugLog(chalk_1.default.bgGreenBright("Performing post loading task: Initializing Complex Variables ---------------------"));
-            await performPostLoadingTasks("initializing complex variables", postTasks1_InitializeVariable);
-            doDebug && debugLog(chalk_1.default.bgGreenBright("Performing post loading tasks: (assigning Extension Object to Variables) -"));
-            await performPostLoadingTasks("assigning extension objects to variables", postTasks2_AssignedExtensionObjectToDataValue);
-            doDebug && debugLog(chalk_1.default.bgGreenBright("Performing post variable initialization ---------------------"));
-            (0, namespace_post_step_1.promoteObjectsAndVariables)(addressSpace);
-        }
-        try {
-            await finalSteps();
-        }
-        catch (err) {
-            // `renderError` was a no-op here, so a failure in the final steps (DataType extraction,
-            // promotion of objects/variables, ...) used to be silently swallowed and the caller was
-            // handed back a half-initialised address space. Surface it: log and re-throw so that
-            // generateAddressSpace() rejects.
-            const message = node_util_1.types.isNativeError(err) ? err.message : String(err);
-            errorLog(`[NODE-OPCUA-E30] generateAddressSpace: final post-loading steps failed: ${message}`);
-            throw err;
-        }
-    }
-    async function addNodeSet(xmlData) {
-        _reset_namespace_translation();
-        parser.parseString(xmlData);
-    }
-    return {
-        addNodeSet,
-        terminate
-    };
-}
-class NodeSetLoader {
-    _s;
-    constructor(addressSpace, options) {
-        this._s = makeNodeSetParserEngine(addressSpace, options || {});
-    }
-    async addNodeSetAsync(xmlData) {
-        return await this._s.addNodeSet(xmlData);
-    }
-    async terminate() {
-        await this._s.terminate();
-    }
-}
-exports.NodeSetLoader = NodeSetLoader;
-//# sourceMappingURL=load_nodeset2.js.map