node-opcua-address-space 2.180.0 → 2.181.0

package/dist/api/loader/nodeset_record_applier.js

@@ -0,0 +1,731 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodesetRecordApplier = void 0;
+exports.makeLoaderTaskQueues = makeLoaderTaskQueues;
+const node_opcua_assert_1 = require("node-opcua-assert");
+const node_opcua_basic_types_1 = require("node-opcua-basic-types");
+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_types_1 = require("node-opcua-types");
+const node_opcua_variant_1 = require("node-opcua-variant");
+const semver_1 = __importDefault(require("semver"));
+const reference_impl_js_1 = require("../../impl/reference_impl.js");
+const make_semver_compatible_js_1 = require("./make_semver_compatible.js");
+const nodeset_record_js_1 = require("./nodeset_record.js");
+const extension_object_parser_js_1 = require("./parsers/extension_object_parser.js");
+const doDebug = (0, node_opcua_debug_1.checkDebugFlag)("load_nodeset2");
+const debugLog = (0, node_opcua_debug_1.make_debugLog)("load_nodeset2");
+const errorLog = (0, node_opcua_debug_1.make_errorLog)("load_nodeset2");
+function makeLoaderTaskQueues() {
+    return {
+        postTasks: [],
+        postTasks0_InitializeVariable: [],
+        postTasks0_DecodePojoString: [],
+        postTasks1_InitializeVariable: [],
+        postTasks2_AssignedExtensionObjectToDataValue: [],
+        pendingSimpleTypeToRegister: []
+    };
+}
+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;
+}
+const UA_NAMESPACE_URI = "http://opcfoundation.org/UA/";
+const reg = /ns=([0-9]+);(.*)/;
+class NodesetRecordApplier {
+    options;
+    queues;
+    /** the back references the load owes, and the nodes it owes nothing else for; see takePendingBackReferences */
+    pending = { settled: new Set(), references: [] };
+    addressSpace;
+    applyRolePermissions;
+    applyAccessRestrictions;
+    // per document: the file's namespace table to the address space's, and what was translated
+    table = [];
+    aliasMap = new Map();
+    translatedStrings = new Map();
+    translatedIds = new Map();
+    headerSeen = false;
+    constructor(addressSpace, options, queues) {
+        this.options = options;
+        this.queues = queues;
+        this.addressSpace = addressSpace;
+        // 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.
+        this.applyRolePermissions = (options.permissions ?? "apply") === "apply";
+        this.applyAccessRestrictions = (options.accessRestrictions ?? "ignore") === "apply";
+    }
+    apply(record) {
+        if (record.kind === "header") {
+            this.applyHeader(record);
+            return;
+        }
+        if (!this.headerSeen) {
+            throw new Error("NodesetRecordApplier: a node record came before the header record");
+        }
+        this.applyNode(record);
+    }
+    // #region header: namespaces, translation table, aliases
+    applyHeader(header) {
+        this.table = [];
+        this.aliasMap.clear();
+        this.translatedStrings.clear();
+        this.translatedIds.clear();
+        this.headerSeen = true;
+        for (const model of header.models) {
+            this.addNamespace(model);
+        }
+        if (header.models.length === 0) {
+            // special case for old nodeset file version 1.02 where no models exists
+            for (const namespaceUri of header.namespaceUris) {
+                if (this.addressSpace.getNamespace(namespaceUri)) {
+                    continue;
+                }
+                this.addNamespace({ modelUri: namespaceUri, version: "1.0.0", requiredModels: [] });
+            }
+        }
+        // the file's table: the UA namespace, then the declared URIs in order. A URI that repeats
+        // (the UA namespace listed again) takes no slot, as it never did.
+        const found = new Set();
+        for (const namespaceUri of [UA_NAMESPACE_URI, ...header.namespaceUris]) {
+            if (found.has(namespaceUri)) {
+                continue;
+            }
+            found.add(namespaceUri);
+            const namespace = this.addressSpace.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`);
+            }
+            doDebug &&
+                debugLog(" _register_namespace_uri = ", namespaceUri, "index in Xml=", this.table.length, " index in addressSpace", namespace.index);
+            this.table.push(namespace.index);
+        }
+        for (const [aliasName, fileLocal] of Object.entries(header.aliases)) {
+            const nodeId = this.translate(fileLocal);
+            this.aliasMap.set(aliasName, nodeId);
+            this.addressSpace.getNamespace(nodeId.namespace).addAlias(aliasName, nodeId);
+        }
+    }
+    addNamespace(model) {
+        const addressSpace = this.addressSpace;
+        if (model.requiredModels.length > 0) {
+            // check that required models exist already in the address space
+            for (const requiredModel of model.requiredModels) {
+                const existingNamespace = addressSpace.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_js_1.makeSemverCompatible)(existingVersion);
+                    const requiredSemver = (0, make_semver_compatible_js_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 = addressSpace.getNamespace(model.modelUri);
+        if (existingNamespace) {
+            namespace = existingNamespace;
+        }
+        else {
+            namespace = addressSpace.registerNamespace(model.modelUri);
+            namespace.setRequiredModels(model.requiredModels);
+        }
+        namespace.version = model.version;
+        namespace.publicationDate = model.publicationDate || namespace.publicationDate;
+        return namespace;
+    }
+    // #endregion
+    // #region translation
+    translateNamespaceIndex(fileIndex) {
+        const namespaceIndex = this.table[fileIndex];
+        // c8 ignore next
+        if (namespaceIndex === undefined) {
+            errorLog("Error; namespace_uri_translation", this.table);
+            throw new Error(`_translateNamespaceIndex() ! Cannot find namespace definition for index ${fileIndex}`);
+        }
+        return namespaceIndex;
+    }
+    /** a file-local id to the address space's, built once per distinct id */
+    translate(fileLocal) {
+        const value = fileLocal.value;
+        const key = typeof value === "number"
+            ? fileLocal.namespace * 4294967296 + value
+            : `${fileLocal.namespace}|${fileLocal.identifierType}|${String(value)}`;
+        let nodeId = this.translatedIds.get(key);
+        if (!nodeId) {
+            const namespace = this.translateNamespaceIndex(fileLocal.namespace);
+            nodeId = namespace === fileLocal.namespace ? fileLocal : new node_opcua_nodeid_1.NodeId(fileLocal.identifierType, value, namespace);
+            this.translatedIds.set(key, nodeId);
+        }
+        return nodeId;
+    }
+    translateOrNull(fileLocal) {
+        return fileLocal ? this.translate(fileLocal) : null;
+    }
+    translateQualifiedName(fileLocal) {
+        return new node_opcua_data_model_1.QualifiedName({ namespaceIndex: this.translateNamespaceIndex(fileLocal.namespaceIndex), name: fileLocal.name });
+    }
+    /**
+     * an id given as text, the way the XML body of a deferred extension object carries them:
+     * an alias, or `ns=<file index>;...`
+     */
+    translateString = (text) => {
+        const aliased = this.aliasMap.get(text);
+        if (aliased) {
+            return aliased;
+        }
+        const translated = this.translatedStrings.get(text);
+        if (translated) {
+            return translated;
+        }
+        let nodeIdString = text;
+        const m = text.match(reg);
+        if (m) {
+            nodeIdString = `ns=${this.translateNamespaceIndex(parseInt(m[1], 10))};${m[2]}`;
+        }
+        const result = (0, node_opcua_nodeid_1.resolveNodeId)(nodeIdString);
+        this.translatedStrings.set(text, result);
+        return result;
+    };
+    /**
+     * the ids a value may hold, by data type; everything else passes through. A record is not
+     * the applier's to change: another consumer may read it after this one, so what is
+     * translated is a copy
+     */
+    translateValue(value) {
+        const mapValue = (fix) => ({
+            ...value,
+            value: Array.isArray(value.value) ? value.value.map(fix) : fix(value.value)
+        });
+        switch (value.dataType) {
+            case node_opcua_variant_1.DataType.NodeId:
+            case node_opcua_variant_1.DataType.ExpandedNodeId:
+                return mapValue((e) => (e instanceof node_opcua_nodeid_1.NodeId ? this.translate(e) : e));
+            case node_opcua_variant_1.DataType.QualifiedName:
+                return mapValue((q) => {
+                    if (q && typeof q === "object" && typeof q.namespaceIndex === "number") {
+                        return new node_opcua_data_model_1.QualifiedName({
+                            namespaceIndex: this.translateNamespaceIndex(q.namespaceIndex),
+                            name: q.name
+                        });
+                    }
+                    return q;
+                });
+            case node_opcua_variant_1.DataType.ExtensionObject:
+                return mapValue((e) => {
+                    if (e instanceof node_opcua_types_1.Argument && e.dataType instanceof node_opcua_nodeid_1.NodeId) {
+                        const argument = new node_opcua_types_1.Argument({});
+                        argument.name = e.name;
+                        argument.dataType = this.translate(e.dataType);
+                        argument.valueRank = e.valueRank;
+                        argument.arrayDimensions = e.arrayDimensions;
+                        argument.description = e.description;
+                        return argument;
+                    }
+                    return e;
+                });
+            default:
+                return value;
+        }
+    }
+    // #endregion
+    // #region nodes
+    canIgnore(record) {
+        if (record.releaseStatus === "Draft" && !this.options.loadDraftNodes) {
+            // c8 ignore next
+            doDebug && debugLog("Ignoring Draft            =", node_opcua_data_model_1.NodeClass[record.nodeClass], record.browseName.toString());
+            return true;
+        }
+        if (record.releaseStatus === "Deprecated" && !this.options.loadDeprecatedNodes) {
+            // c8 ignore next
+            doDebug && debugLog("Ignoring Deprecate        =", node_opcua_data_model_1.NodeClass[record.nodeClass], record.browseName.toString());
+            return true;
+        }
+        return false;
+    }
+    permissions(record) {
+        let rolePermissions;
+        if (this.applyRolePermissions) {
+            if (record.rolePermissions) {
+                rolePermissions = record.rolePermissions.map((r) => ({
+                    roleId: this.translate(r.roleId),
+                    permissions: r.permissions
+                }));
+            }
+            else if (record.hasNoPermissions) {
+                // 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 = [];
+            }
+        }
+        return {
+            accessRestrictions: this.applyAccessRestrictions ? convertAccessRestrictions(record.accessRestrictions) : undefined,
+            rolePermissions
+        };
+    }
+    common(record) {
+        return {
+            nodeClass: record.nodeClass,
+            nodeId: record.nodeId.isEmpty() ? null : this.translate(record.nodeId),
+            browseName: this.translateQualifiedName(record.browseName),
+            references: this.references(record),
+            ...this.permissions(record)
+        };
+    }
+    /** the node's references as the node will hold them, one per reference of the record, in its order */
+    references(record) {
+        return record.references.map((r) => new reference_impl_js_1.ReferenceImpl({
+            isForward: r.isForward,
+            nodeId: this.translate(r.nodeId),
+            referenceType: this.translate(r.referenceType)
+        }));
+    }
+    /**
+     * what the end of the load must do about the inverses of a node's references: a reference the
+     * document marks as not declared from the other end is kept for one propagation, and the node
+     * is settled; a node whose references carry no such information is left to the end-of-load
+     * sweep, which propagates it whole. `references` are those built by {@link references} from
+     * the same record, in the same order.
+     */
+    settle(node, record, references) {
+        const pending = [];
+        for (let i = 0; i < references.length; i++) {
+            const declared = record.references[i].inverseDeclared;
+            if (declared === undefined) {
+                return;
+            }
+            if (!declared && !(0, reference_impl_js_1.isMassivelyUsedReferenceType)(references[i].referenceType)) {
+                pending.push(references[i]);
+            }
+        }
+        this.pending.settled.add(node);
+        for (const reference of pending) {
+            this.pending.references.push([node, reference]);
+        }
+    }
+    /**
+     * what the end of the load must do about back references: the one-sided references of the
+     * settled nodes, to propagate one by one, and the settled nodes themselves, which the sweep
+     * over every node skips. Taken once by the loader's terminate step and dropped after it: the
+     * set lives for the load, not on the nodes
+     */
+    takePendingBackReferences() {
+        const pending = this.pending;
+        this.pending = { settled: new Set(), references: [] };
+        return pending;
+    }
+    createNode(params, record) {
+        // 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 = this.addressSpace.getNamespace(params.nodeId.namespace);
+        const node = namespace.internalCreateNode(params);
+        this.settle(node, record, params.references);
+        return node;
+    }
+    applyNode(record) {
+        if (this.canIgnore(record)) {
+            return;
+        }
+        switch (record.nodeClass) {
+            case node_opcua_data_model_1.NodeClass.Object:
+                this.createNode({
+                    ...this.common(record),
+                    isAbstract: record.isAbstract,
+                    eventNotifier: record.eventNotifier,
+                    symbolicName: record.symbolicName ?? null,
+                    displayName: record.displayName,
+                    description: record.description
+                }, record);
+                return;
+            case node_opcua_data_model_1.NodeClass.ObjectType:
+                this.createNode({
+                    ...this.common(record),
+                    isAbstract: record.isAbstract,
+                    eventNotifier: record.eventNotifier,
+                    displayName: record.displayName,
+                    description: record.description
+                }, record);
+                return;
+            case node_opcua_data_model_1.NodeClass.ReferenceType: {
+                const params = {
+                    ...this.common(record),
+                    isAbstract: record.isAbstract,
+                    displayName: record.displayName,
+                    description: record.description,
+                    inverseName: record.inverseName
+                };
+                // c8 ignore next
+                if (!(params.nodeId instanceof node_opcua_nodeid_1.NodeId)) {
+                    throw new Error("invalid param");
+                } // already translated
+                const node = this.addressSpace.getNamespace(params.nodeId.namespace).addReferenceType(params);
+                this.settle(node, record, params.references);
+                return;
+            }
+            case node_opcua_data_model_1.NodeClass.DataType:
+                this.applyDataType(record);
+                return;
+            case node_opcua_data_model_1.NodeClass.Variable:
+                this.applyVariable(record);
+                return;
+            case node_opcua_data_model_1.NodeClass.VariableType:
+                this.applyVariableType(record);
+                return;
+            case node_opcua_data_model_1.NodeClass.Method:
+                this.createNode({
+                    ...this.common(record),
+                    parentNodeId: this.translateOrNull(record.parentNodeId),
+                    methodDeclarationId: this.translateOrNull(record.methodDeclarationId),
+                    displayName: record.displayName
+                }, record);
+                return;
+            case node_opcua_data_model_1.NodeClass.View:
+                this.createNode({
+                    ...this.common(record),
+                    containsNoLoops: record.containsNoLoops,
+                    eventNotifier: record.eventNotifier,
+                    displayName: record.displayName,
+                    description: record.description
+                }, record);
+                return;
+            default:
+                throw new Error(`NodesetRecordApplier: unexpected node class ${record.nodeClass}`);
+        }
+    }
+    applyDataType(record) {
+        const fields = (record.definition?.fields ?? []).map((field) => ({
+            ...field,
+            dataType: field.dataType ? this.translate(field.dataType) : null
+        }));
+        const params = {
+            ...this.common(record),
+            nodeId: record.nodeId.isEmpty() ? undefined : this.translate(record.nodeId),
+            isAbstract: record.isAbstract || false,
+            displayName: record.displayName ?? "",
+            description: record.description ?? "",
+            symbolicName: record.symbolicName,
+            partialDefinition: fields
+        };
+        let capturedDataTypeNode = this.createNode(params, record);
+        const queues = this.queues;
+        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
+                queues.pendingSimpleTypeToRegister.push({ name: definitionName, dataTypeNodeId: capturedDataTypeNode.nodeId });
+            }
+            capturedDataTypeNode = undefined;
+        };
+        queues.postTasks.push(processBasicDataType);
+    }
+    /**
+     * the value of a record, translated, with the extension objects still waiting as XML replaced
+     * by null and their decode queued; the deferred getter yields them once decoded
+     */
+    prepareValue(record, value) {
+        value = this.translateValue(value);
+        if (value.dataType !== node_opcua_variant_1.DataType.ExtensionObject) {
+            return value;
+        }
+        const nodeId = record.nodeId.isEmpty() ? node_opcua_nodeid_1.NodeId.nullNodeId : this.translate(record.nodeId);
+        const translateString = this.translateString;
+        if (value.value instanceof nodeset_record_js_1.XmlExtensionObjectFragment) {
+            const fragment = value.value;
+            let captured = null;
+            this.queues.postTasks0_DecodePojoString.push((0, extension_object_parser_js_1.createXMLExtensionObjectDecodingTask)(translateString, this.translate(fragment.typeId), fragment.bodyXML, (extensionObject) => {
+                captured = extensionObject;
+            }));
+            this.assignExtensionObjectLater(nodeId, () => captured);
+            return { dataType: node_opcua_variant_1.DataType.ExtensionObject, arrayType: node_opcua_variant_1.VariantArrayType.Scalar, value: null };
+        }
+        if (Array.isArray(value.value) && value.value.some((e) => e instanceof nodeset_record_js_1.XmlExtensionObjectFragment)) {
+            const list = value.value.map((e) => (e instanceof nodeset_record_js_1.XmlExtensionObjectFragment ? null : e));
+            value.value.forEach((e, index) => {
+                if (!(e instanceof nodeset_record_js_1.XmlExtensionObjectFragment))
+                    return;
+                this.queues.postTasks0_DecodePojoString.push((0, extension_object_parser_js_1.createXMLExtensionObjectDecodingTask)(translateString, this.translate(e.typeId), e.bodyXML, (extensionObject) => {
+                    list[index] = extensionObject;
+                }));
+            });
+            this.assignExtensionObjectLater(nodeId, () => list);
+            return { dataType: node_opcua_variant_1.DataType.ExtensionObject, arrayType: node_opcua_variant_1.VariantArrayType.Array, value: null };
+        }
+        return value;
+    }
+    assignExtensionObjectLater(nodeId, deferred) {
+        // let's create the mechanism that postpone the assignment of the extension object
+        const task = async (addressSpace2) => {
+            const extensionObjOrArray = deferred();
+            (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;
+            }
+        };
+        this.queues.postTasks2_AssignedExtensionObjectToDataValue.push(task);
+    }
+    variableCommon(record) {
+        return {
+            ...this.common(record),
+            parentNodeId: this.translateOrNull(record.parentNodeId),
+            dataType: this.translateOrNull(record.dataType),
+            valueRank: record.valueRank ?? -1,
+            arrayDimensions: record.arrayDimensions ?? null,
+            minimumSamplingInterval: record.minimumSamplingInterval ?? 0,
+            displayName: record.displayName !== undefined ? ((0, node_opcua_data_model_1.coerceLocalizedText)(record.displayName) ?? undefined) : undefined,
+            description: record.description !== undefined ? ((0, node_opcua_data_model_1.coerceLocalizedText)(record.description) ?? undefined) : undefined
+        };
+    }
+    applyVariable(record) {
+        const accessLevel = convertAccessLevel(record.accessLevel);
+        const value = record.value ? this.prepareValue(record, record.value) : undefined;
+        const params = {
+            ...this.variableCommon(record),
+            historizing: record.historizing ?? false,
+            accessLevel,
+            userAccessLevel: convertUserAccessLevel(record.userAccessLevel, accessLevel)
+            // no value here: an empty one made the constructor bind a getter and a setter on every
+            // variable, five closures each; an unbound variable reads and writes through the
+            // defaults, and the value is set below or by a post task once its data type is known
+        };
+        const addressSpace = this.addressSpace;
+        let capturedVariable;
+        // the value can be set now when its data type is already in the address space: nothing
+        // else in the post-load steps runs before it; only an extension object waits for the
+        // data types to be extracted
+        const dataType = this.translateOrNull(record.dataType);
+        const dataTypeReady = dataType !== null && value?.dataType !== node_opcua_variant_1.DataType.ExtensionObject && this.isDataTypeReady(dataType);
+        if (dataTypeReady) {
+            const variable = this.createNode(params, record);
+            this.setInitialValueNow(variable, value);
+            return;
+        }
+        if (value && value.dataType !== node_opcua_variant_1.DataType.Null) {
+            let capturedValue = value;
+            const task = async (_addressSpace2) => {
+                if (!capturedVariable)
+                    return;
+                const cv = capturedVariable;
+                cv._setInitialDataValue(capturedValue);
+                capturedValue = undefined;
+                capturedVariable = undefined;
+            };
+            if (capturedValue.dataType !== node_opcua_variant_1.DataType.ExtensionObject) {
+                this.queues.postTasks0_InitializeVariable.push(task);
+            }
+            else {
+                // do them later when every thing is created
+                this.queues.postTasks1_InitializeVariable.push(task);
+            }
+        }
+        else {
+            const task = async (_addressSpace2) => {
+                if (!capturedVariable)
+                    return;
+                const cv = capturedVariable;
+                const defaultValue = makeDefaultVariant(addressSpace, cv.dataType, cv.valueRank, cv.arrayDimensions);
+                if (defaultValue) {
+                    // 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 (defaultValue.dataType === node_opcua_variant_1.DataType.Null || isUninitializedMatrix(defaultValue)) {
+                        cv._setInitialDataValue(defaultValue, node_opcua_basic_types_1.StatusCodes.BadWaitingForInitialData);
+                    }
+                    else {
+                        cv._setInitialDataValue(defaultValue, node_opcua_basic_types_1.StatusCodes.Good);
+                    }
+                }
+                capturedVariable = undefined;
+            };
+            this.queues.postTasks0_InitializeVariable.push(task);
+        }
+        capturedVariable = this.createNode(params, record);
+    }
+    /** a data type node whose basic type resolves: what an initial value needs to be checked against */
+    isDataTypeReady(dataType) {
+        const node = this.addressSpace.findNode(dataType);
+        if (!node || node.nodeClass !== node_opcua_data_model_1.NodeClass.DataType) {
+            return false;
+        }
+        try {
+            return node.basicDataType !== undefined;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * what the "initializing simple variables" post task does, done at creation; a value the
+     * variable refuses is logged and skipped, as the post task would
+     */
+    setInitialValueNow(variable, value) {
+        try {
+            if (value && value.dataType !== node_opcua_variant_1.DataType.Null) {
+                variable._setInitialDataValue(value);
+                return;
+            }
+            const defaultValue = makeDefaultVariant(this.addressSpace, variable.dataType, variable.valueRank, variable.arrayDimensions);
+            if (defaultValue) {
+                if (defaultValue.dataType === node_opcua_variant_1.DataType.Null || isUninitializedMatrix(defaultValue)) {
+                    variable._setInitialDataValue(defaultValue, node_opcua_basic_types_1.StatusCodes.BadWaitingForInitialData);
+                }
+                else {
+                    variable._setInitialDataValue(defaultValue, node_opcua_basic_types_1.StatusCodes.Good);
+                }
+            }
+        }
+        catch (err) {
+            errorLog(`[NODE-OPCUA-W36] generateAddressSpace: post-loading task failed during "initializing simple variables" and was skipped: ${err.message}`);
+        }
+    }
+    applyVariableType(record) {
+        const value = record.value ? this.prepareValue(record, record.value) : undefined;
+        const params = {
+            ...this.variableCommon(record),
+            // a ValueRank of 0 has always been read as Scalar on a variable type; kept
+            valueRank: record.valueRank || -1,
+            // UAVariableType has no Historizing attribute in the XSD: keep it false
+            historizing: false,
+            isAbstract: record.isAbstract,
+            displayName: record.displayName !== undefined ? ((0, node_opcua_data_model_1.coerceLocalizedText)(record.displayName || "") ?? undefined) : undefined,
+            description: record.description !== undefined ? ((0, node_opcua_data_model_1.coerceLocalizedText)(record.description || "") ?? undefined) : undefined,
+            value
+        };
+        this.createNode(params, record);
+    }
+}
+exports.NodesetRecordApplier = NodesetRecordApplier;
+//# sourceMappingURL=nodeset_record_applier.js.map