node-opcua-address-space 2.179.0 → 2.181.0

package/dist/impl/event_layout.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @module node-opcua-address-space.Private
+ *
+ * The layout of an event: which fields an event of a given type carries, where each one sits in the
+ * type hierarchy and under which name `raiseEvent`'s caller provides its value. Raising an event
+ * used to rediscover this by browsing the event type and its supertypes; the layout is now built
+ * once per event type and rebuilt only when one of the nodes it was read from changes.
+ */
+import type { BaseNode, IAddressSpace, UAObjectType } from "node-opcua-address-space-base";
+import { type NodeId } from "node-opcua-nodeid";
+export interface EventField {
+    /** the key under which the caller of raiseEvent gives the value: `"enabledState.id"` */
+    lowerName: string;
+    /** the browse path of the field from the event type: `"EnabledState.Id"` */
+    fullBrowsePath: string;
+    node: BaseNode;
+    /** `node.nodeId.toString()`, the key under which a select clause reads the value back */
+    nodeIdKey: string;
+    mandatory: boolean;
+}
+interface Dependency {
+    node: BaseNode;
+    /** the node's cache object when the layout was built; a change to the node replaces it */
+    cache: object;
+}
+export interface EventLayout {
+    fields: EventField[];
+    /** every `lowerName`, to tell a caller which of its keys name no field */
+    names: Set<string>;
+    /** browse path to field NodeId, shared by every event raised with this layout */
+    pathToNodeId: Map<string, NodeId>;
+    dependencies: Dependency[];
+}
+/**
+ * the layout of events of the given type, built on first use and after a change to the type hierarchy
+ */
+export declare function getEventLayout(addressSpace: IAddressSpace, eventType: UAObjectType, baseObjectType: UAObjectType): EventLayout;
+/** for tests: the cached layout of an event type, if any, without rebuilding it */
+export declare function peekEventLayout(eventType: UAObjectType): EventLayout | undefined;
+export {};

package/dist/impl/event_layout.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEventLayout = getEventLayout;
+exports.peekEventLayout = peekEventLayout;
+const node_opcua_data_model_1 = require("node-opcua-data-model");
+const node_opcua_nodeid_1 = require("node-opcua-nodeid");
+const node_opcua_utils_1 = require("node-opcua-utils");
+const base_node_private_js_1 = require("./base_node_private.js");
+const layouts = new WeakMap();
+/**
+ * a layout stays valid while none of the nodes it was read from (the event type, its supertypes
+ * below BaseObjectType, and their direct children) gained or lost a reference: each of those
+ * clears its cache object, and the layout remembers the ones it saw
+ */
+function isValid(layout) {
+    for (const dependency of layout.dependencies) {
+        if ((0, base_node_private_js_1.BaseNode_getCache)(dependency.node) !== dependency.cache) {
+            return false;
+        }
+    }
+    return true;
+}
+function buildEventLayout(addressSpace, eventType, baseObjectType) {
+    // supertypes first, as before: when two types declare the same name the base one wins
+    const chain = [];
+    let type = eventType;
+    while (type && !(0, node_opcua_nodeid_1.sameNodeId)(type.nodeId, baseObjectType.nodeId)) {
+        chain.push(type);
+        const baseTypeNodeId = type.subtypeOf;
+        /* c8 ignore next */
+        if (!baseTypeNodeId) {
+            throw new Error(`Object ${type.browseName.toString()} with nodeId ${type.nodeId} has no Type`);
+        }
+        const baseType = addressSpace.findNode(baseTypeNodeId);
+        /* c8 ignore next */
+        if (!baseType) {
+            throw new Error(`Cannot find object with nodeId ${baseTypeNodeId}`);
+        }
+        type = baseType;
+    }
+    chain.reverse();
+    const layout = {
+        fields: [],
+        names: new Set(),
+        pathToNodeId: new Map(),
+        dependencies: []
+    };
+    const depend = (node) => layout.dependencies.push({ node, cache: (0, base_node_private_js_1.BaseNode_getCache)(node) });
+    const addField = (prefixLower, prefixStandard, node) => {
+        const lowerName = prefixLower + (0, node_opcua_utils_1.lowerFirstLetter)(node.browseName?.name || "");
+        if (layout.names.has(lowerName)) {
+            return;
+        }
+        const fullBrowsePath = prefixStandard + node.browseName.toString();
+        layout.names.add(lowerName);
+        layout.pathToNodeId.set(fullBrowsePath, node.nodeId);
+        layout.fields.push({
+            lowerName,
+            fullBrowsePath,
+            node,
+            nodeIdKey: node.nodeId.toString(),
+            mandatory: node.modellingRule === "Mandatory"
+        });
+    };
+    for (const self of chain) {
+        depend(self);
+        const children = [].concat(self.getProperties(), self.getComponents());
+        for (const node of children) {
+            // a child without a modelling rule may gain one later: watch it too
+            depend(node);
+            if (!node.modellingRule || node.nodeClass === node_opcua_data_model_1.NodeClass.Method) {
+                continue;
+            }
+            addField("", "", node);
+            const aggregates = node.getAggregates();
+            if (aggregates.length > 0) {
+                const lowerName = (0, node_opcua_utils_1.lowerFirstLetter)(node.browseName.name || "");
+                const standardName = node.browseName.toString();
+                for (const child of aggregates) {
+                    addField(`${lowerName}.`, `${standardName}.`, child);
+                }
+            }
+        }
+    }
+    return layout;
+}
+/**
+ * the layout of events of the given type, built on first use and after a change to the type hierarchy
+ */
+function getEventLayout(addressSpace, eventType, baseObjectType) {
+    const cached = layouts.get(eventType);
+    if (cached && isValid(cached)) {
+        return cached;
+    }
+    const layout = buildEventLayout(addressSpace, eventType, baseObjectType);
+    layouts.set(eventType, layout);
+    return layout;
+}
+/** for tests: the cached layout of an event type, if any, without rebuilding it */
+function peekEventLayout(eventType) {
+    return layouts.get(eventType);
+}
+//# sourceMappingURL=event_layout.js.map

package/dist/impl/event_layout.js.map

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

package/dist/impl/extension_object_array_node.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @module node-opcua-address-space.Private
+ */
+import type { UADynamicVariableArray, UAObject, UAVariable } from "node-opcua-address-space-base";
+import { type QualifiedNameLike } from "node-opcua-data-model";
+import { ExtensionObject } from "node-opcua-extension-object";
+import type { NodeId } from "node-opcua-nodeid";
+export interface CreateExtObjArrayNodeOptions {
+    browseName: QualifiedNameLike;
+    complexVariableType: string | NodeId;
+    variableType: string | NodeId;
+    indexPropertyName: string;
+    minimumSamplingInterval?: number;
+}
+/**
+ *
+ * create a node Variable that contains a array of ExtensionObject of a given type
+ */
+export declare function createExtObjArrayNode<T extends ExtensionObject>(parentFolder: UAObject, options: CreateExtObjArrayNodeOptions): UADynamicVariableArray<T>;
+export declare function bindExtObjArrayNode<T extends ExtensionObject>(uaArrayVariableNode: UADynamicVariableArray<T>, variableTypeNodeId: string | NodeId, indexPropertyName: string): UAVariable;
+/**
+
+ * add a new element in a ExtensionObject Array variable
+ * @param options {Object}   data used to construct the underlying ExtensionObject
+ * @param uaArrayVariableNode {UAVariable}
+ * @return {UAVariable}
+ *
+ */
+/**
+ * Takes the published UAVariable rather than UAVariableImpl.
+ *
+ * This function is exported from the package entry while UAVariableImpl is not, so naming the
+ * implementation class here made the first overload uncallable from outside - and from the
+ * package's own tests, which hold public types. The `instanceof UAVariableImpl` below still
+ * narrows it at run time; that check is what decides the branch, not the declared type.
+ */
+export declare function addElement<T extends ExtensionObject>(options: UAVariable | ExtensionObject | Record<string, unknown>, uaArrayVariableNode: UADynamicVariableArray<T>): UAVariable;
+/**
+ *
+ */
+export declare function removeElement<T extends ExtensionObject>(uaArrayVariableNode: UADynamicVariableArray<T>, element: number | UAVariable | ((a: T) => boolean)): void;

package/dist/impl/extension_object_array_node.js

@@ -0,0 +1,274 @@
+"use strict";
+/**
+ * @module node-opcua-address-space.Private
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createExtObjArrayNode = createExtObjArrayNode;
+exports.bindExtObjArrayNode = bindExtObjArrayNode;
+exports.addElement = addElement;
+exports.removeElement = removeElement;
+const node_opcua_assert_1 = require("node-opcua-assert");
+const node_opcua_data_model_1 = require("node-opcua-data-model");
+const node_opcua_debug_1 = require("node-opcua-debug");
+const node_opcua_extension_object_1 = require("node-opcua-extension-object");
+const node_opcua_variant_1 = require("node-opcua-variant");
+const ua_variable_impl_js_1 = require("./ua_variable_impl.js");
+const _doDebug = (0, node_opcua_debug_1.checkDebugFlag)("extension_object_array_node");
+const _debugLog = (0, node_opcua_debug_1.make_debugLog)("extension_object_array_node");
+const errorLog = (0, node_opcua_debug_1.make_errorLog)("extension_object_array_node");
+const warningLog = (0, node_opcua_debug_1.make_warningLog)("extension_object_array_node");
+/*
+ * define a complex Variable containing a array of extension objects
+ * each element of the array is also accessible as a component variable.
+ *
+ */
+function getExtObjArrayNodeValue() {
+    return new node_opcua_variant_1.Variant({
+        arrayType: node_opcua_variant_1.VariantArrayType.Array,
+        dataType: node_opcua_variant_1.DataType.ExtensionObject,
+        value: this.$$extensionObjectArray
+    });
+}
+function removeElementByIndex(uaArrayVariableNode, elementIndex) {
+    const _array = uaArrayVariableNode.$$extensionObjectArray;
+    (0, node_opcua_assert_1.assert)(typeof elementIndex === "number");
+    const addressSpace = uaArrayVariableNode.addressSpace;
+    const extObj = _array[elementIndex];
+    const browseName = uaArrayVariableNode.$$getElementBrowseName(extObj, elementIndex);
+    // remove element from global array (inefficient)
+    uaArrayVariableNode.$$extensionObjectArray.splice(elementIndex, 1);
+    if (uaArrayVariableNode.$$extensionObjectArray !== uaArrayVariableNode.$dataValue.value.value) {
+        //    throw new Error("internal error");
+    }
+    uaArrayVariableNode.touchValue();
+    // remove matching component
+    const node = uaArrayVariableNode.getComponentByName(browseName);
+    if (!node) {
+        throw new Error(" cannot find component ");
+    }
+    const hasComponent = uaArrayVariableNode.addressSpace.findReferenceType("HasComponent");
+    // c8 ignore next
+    if (!hasComponent) {
+        throw new Error("cannot find HasComponent reference type: please check your nodeset file");
+    }
+    // remove the hasComponent reference toward node
+    uaArrayVariableNode.removeReference({
+        isForward: true,
+        nodeId: node.nodeId,
+        referenceType: hasComponent.nodeId
+    });
+    // now check if node has still some parent
+    const parents = node.findReferencesEx("HasChild", node_opcua_data_model_1.BrowseDirection.Inverse);
+    if (parents.length === 0) {
+        addressSpace.deleteNode(node.nodeId);
+    }
+}
+/**
+ *
+ * create a node Variable that contains a array of ExtensionObject of a given type
+ */
+function createExtObjArrayNode(parentFolder, options) {
+    (0, node_opcua_assert_1.assert)(typeof options.variableType === "string");
+    (0, node_opcua_assert_1.assert)(typeof options.indexPropertyName === "string");
+    const addressSpace = parentFolder.addressSpace;
+    const namespace = parentFolder.namespace;
+    const complexVariableType = addressSpace.findVariableType(options.complexVariableType);
+    // c8 ignore next
+    if (!complexVariableType) {
+        throw new Error("cannot find complex variable type");
+    }
+    (0, node_opcua_assert_1.assert)(!complexVariableType.nodeId.isEmpty());
+    const variableType = addressSpace.findVariableType(options.variableType);
+    if (!variableType) {
+        throw new Error("cannot find variable Type");
+    }
+    (0, node_opcua_assert_1.assert)(!variableType.nodeId.isEmpty());
+    const structure = addressSpace.findDataType("Structure");
+    // c8 ignore next
+    if (!structure) {
+        throw new Error("Structure Type not found: please check your nodeset file");
+    }
+    const dataType = addressSpace.findDataType(variableType.dataType);
+    // c8 ignore next
+    if (!dataType) {
+        errorLog(variableType.toString());
+        throw new Error("cannot find Data Type");
+    }
+    (0, node_opcua_assert_1.assert)(dataType.isSubtypeOf(structure), "expecting a structure (= ExtensionObject) here ");
+    const inner_options = {
+        componentOf: parentFolder,
+        browseName: options.browseName,
+        dataType: dataType.nodeId,
+        typeDefinition: complexVariableType.nodeId,
+        value: { dataType: node_opcua_variant_1.DataType.ExtensionObject, value: [], arrayType: node_opcua_variant_1.VariantArrayType.Array },
+        valueRank: 1
+    };
+    const uaArrayVariableNode = namespace.addVariable(inner_options);
+    if (options.minimumSamplingInterval !== undefined) {
+        uaArrayVariableNode.minimumSamplingInterval = options.minimumSamplingInterval;
+    }
+    bindExtObjArrayNode(uaArrayVariableNode, options.variableType, options.indexPropertyName);
+    return uaArrayVariableNode;
+}
+function _getElementBrowseName(extObj, _index) {
+    const indexPropertyName1 = this.$$indexPropertyName;
+    if (!Object.hasOwn(extObj, indexPropertyName1)) {
+        warningLog(" extension object does not have ", indexPropertyName1, extObj);
+    }
+    // assert(extObj.constructor === addressSpace.constructExtensionObject(dataType));
+    (0, node_opcua_assert_1.assert)(Object.hasOwn(extObj, indexPropertyName1));
+    const browseName = extObj[indexPropertyName1].toString();
+    return browseName;
+}
+function bindExtObjArrayNode(uaArrayVariableNode, variableTypeNodeId, indexPropertyName) {
+    (0, node_opcua_assert_1.assert)(uaArrayVariableNode.valueRank === 1, "expecting a one dimension array");
+    const addressSpace = uaArrayVariableNode.addressSpace;
+    const variableType = addressSpace.findVariableType(variableTypeNodeId);
+    // c8 ignore next
+    if (!variableType || variableType.nodeId.isEmpty()) {
+        throw new Error(`Cannot find VariableType ${variableTypeNodeId.toString()}`);
+    }
+    const structure = addressSpace.findDataType("Structure");
+    // c8 ignore next
+    if (!structure) {
+        throw new Error("Structure Type not found: please check your nodeset file");
+    }
+    let dataType = addressSpace.findDataType(variableType.dataType);
+    // c8 ignore next
+    if (!dataType) {
+        throw new Error(`Cannot find DataType ${variableType.dataType.toString()}`);
+    }
+    (0, node_opcua_assert_1.assert)(dataType.isSubtypeOf(structure), "expecting a structure (= ExtensionObject) here ");
+    (0, node_opcua_assert_1.assert)(!uaArrayVariableNode.$$variableType, "uaArrayVariableNode has already been bound !");
+    uaArrayVariableNode.$$variableType = variableType;
+    // verify that an object with same doesn't already exist
+    dataType = addressSpace.findDataType(variableType.dataType);
+    // c8 ignore next
+    if (!dataType) {
+        throw new Error(`Cannot find DataType ${variableType.dataType.toString()}`);
+    }
+    (0, node_opcua_assert_1.assert)(dataType.isSubtypeOf(structure), "expecting a structure (= ExtensionObject) here ");
+    (0, node_opcua_assert_1.assert)(!uaArrayVariableNode.$$extensionObjectArray, "UAVariable ExtensionObject array already bounded");
+    uaArrayVariableNode.$$dataType = dataType;
+    uaArrayVariableNode.$$extensionObjectArray = [];
+    uaArrayVariableNode.$$indexPropertyName = indexPropertyName;
+    // _getElementBrowseName actually returns a plain string (used opaquely via .toString() by every
+    // caller), while the base interface declares QualifiedName — cast to preserve exact prior runtime behavior.
+    uaArrayVariableNode.$$getElementBrowseName = _getElementBrowseName;
+    uaArrayVariableNode.$dataValue.value.value = uaArrayVariableNode.$$extensionObjectArray;
+    uaArrayVariableNode.$dataValue.value.arrayType = node_opcua_variant_1.VariantArrayType.Array;
+    const bindOptions = {
+        // getExtObjArrayNodeValue is generic over `this: UADynamicVariableArray<T>`, narrower than GetFunc's `this: UAVariable`
+        get: getExtObjArrayNodeValue,
+        set: undefined // readonly
+    };
+    // bind the readonly
+    uaArrayVariableNode.bindVariable(bindOptions, true);
+    return uaArrayVariableNode;
+}
+/**
+
+ * add a new element in a ExtensionObject Array variable
+ * @param options {Object}   data used to construct the underlying ExtensionObject
+ * @param uaArrayVariableNode {UAVariable}
+ * @return {UAVariable}
+ *
+ */
+/**
+ * Takes the published UAVariable rather than UAVariableImpl.
+ *
+ * This function is exported from the package entry while UAVariableImpl is not, so naming the
+ * implementation class here made the first overload uncallable from outside - and from the
+ * package's own tests, which hold public types. The `instanceof UAVariableImpl` below still
+ * narrows it at run time; that check is what decides the branch, not the declared type.
+ */
+function addElement(options, uaArrayVariableNode) {
+    (0, node_opcua_assert_1.assert)(uaArrayVariableNode, " must provide an UAVariable containing the array");
+    // verify that arr has been created correctly
+    (0, node_opcua_assert_1.assert)(!!uaArrayVariableNode.$$variableType && !!uaArrayVariableNode.$$dataType, "did you create the array Node with createExtObjArrayNode ?");
+    (0, node_opcua_assert_1.assert)(uaArrayVariableNode.$$dataType.nodeClass === node_opcua_data_model_1.NodeClass.DataType);
+    const addressSpace = uaArrayVariableNode.addressSpace;
+    const Constructor = addressSpace.getExtensionObjectConstructor(uaArrayVariableNode.$$dataType);
+    (0, node_opcua_assert_1.assert)(Constructor instanceof Function);
+    let extensionObject;
+    let elVar = null;
+    let browseName;
+    if (options instanceof ua_variable_impl_js_1.UAVariableImpl) {
+        elVar = options;
+        extensionObject = elVar.$extensionObject; // get shared extension object
+        (0, node_opcua_assert_1.assert)(extensionObject instanceof Constructor, "the provided variable must expose a Extension Object of the expected type ");
+        // add a reference
+        uaArrayVariableNode.addReference({
+            isForward: true,
+            nodeId: elVar.nodeId,
+            referenceType: "HasComponent"
+        });
+        // xx elVar.bindExtensionObject();
+    }
+    else {
+        if (options instanceof node_opcua_extension_object_1.ExtensionObject) {
+            // extension object has already been created
+            extensionObject = options;
+        }
+        else {
+            // `instanceof UAVariableImpl` above narrows the class out of the union but not the
+            // UAVariable interface, since a UAVariable need not be that class. Whatever is left
+            // here is the plain options record that constructExtensionObject takes.
+            const optionsRecord = options;
+            extensionObject = addressSpace.constructExtensionObject(uaArrayVariableNode.$$dataType, optionsRecord);
+        }
+        const index = uaArrayVariableNode.$$extensionObjectArray?.length || 0;
+        browseName = uaArrayVariableNode.$$getElementBrowseName(extensionObject, index);
+        elVar = uaArrayVariableNode.$$variableType.instantiate({
+            browseName,
+            componentOf: uaArrayVariableNode.nodeId,
+            value: { dataType: node_opcua_variant_1.DataType.ExtensionObject, value: extensionObject }
+        });
+        elVar.bindExtensionObject(extensionObject, { force: true });
+    }
+    if (uaArrayVariableNode.$$extensionObjectArray !== uaArrayVariableNode.$dataValue.value.value) {
+        //    throw new Error("internal error");
+    }
+    // also add the value inside
+    uaArrayVariableNode.$$extensionObjectArray.push(elVar.$extensionObject);
+    uaArrayVariableNode.touchValue();
+    return elVar;
+}
+/**
+ *
+ */
+function removeElement(uaArrayVariableNode, element) {
+    (0, node_opcua_assert_1.assert)(element, "removeElement: element must exist");
+    const _array = uaArrayVariableNode.$$extensionObjectArray;
+    // c8 ignore next
+    if (_array.length === 0) {
+        throw new Error(" cannot remove an element from an empty array ");
+    }
+    let elementIndex = -1;
+    if (typeof element === "number") {
+        // find element by index
+        elementIndex = element;
+        (0, node_opcua_assert_1.assert)(elementIndex >= 0 && elementIndex < _array.length);
+    }
+    else if (typeof element === "function") {
+        // find element by functor
+        elementIndex = _array.findIndex(element);
+    }
+    else if (element?.nodeClass) {
+        // find element by name
+        const browseNameToFind = element.browseName.name?.toString();
+        elementIndex = _array.findIndex((obj, _i) => {
+            const browseName = uaArrayVariableNode.$$getElementBrowseName(obj, elementIndex).toString();
+            return browseName === browseNameToFind;
+        });
+    }
+    else {
+        throw new Error("Unsupported anymore!!! please use a functor instead");
+    }
+    // c8 ignore next
+    if (elementIndex < 0) {
+        throw new Error(`removeElement: cannot find element matching ${element.toString()}`);
+    }
+    removeElementByIndex(uaArrayVariableNode, elementIndex);
+}
+//# sourceMappingURL=extension_object_array_node.js.map

package/dist/impl/extension_object_array_node.js.map

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

package/dist/impl/get_basic_datatype.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_basic_datatype.js","sourceRoot":"","sources":["../../impl/get_basic_datatype.ts"],"names":[],"mappings":";;AAYA,kFAaC;AAED,8CAeC;AAzCD,mEAAkD;AAWlD,SAAgB,mCAAmC,CAC/C,YAA2B,EAC3B,cAAmD;IAEnD,MAAM,eAAe,GACjB,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,KAAK,IAAI,IAAI,QAAQ,IAAI,cAAc;QACvF,CAAC,CAAC,cAAc,CAAC,MAAM;QACvB,CAAC,CAAC,cAAc,CAAC;IACzB,MAAM,YAAY,GAAG,YAAY,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAChE,IAAI,CAAC,YAAY,EAAE,CAAC;QAChB,OAAO,iCAAQ,CAAC,IAAI,CAAC;IACzB,CAAC;IACD,OAAO,YAAY,CAAC,gBAAgB,EAAE,CAAC;AAC3C,CAAC;AAED,SAAgB,iBAAiB,CAAC,MAAuC;IACrE,MAAM,OAAO,GAAG,MAA2C,CAAC;IAC5D,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,cAAc,CAAC;IAClC,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,KAAK,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;QACnE,OAAO,iCAAQ,CAAC,IAAI,CAAC;IACzB,CAAC;IACD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC1C,IAAI,CAAC,YAAY,EAAE,CAAC;QAChB,uCAAuC;QACvC,OAAO,iCAAQ,CAAC,IAAI,CAAC;IACzB,CAAC;IACD,OAAO,CAAC,cAAc,GAAG,mCAAmC,CAAC,YAAY,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7F,OAAO,OAAO,CAAC,cAAc,CAAC;AAClC,CAAC"}

package/dist/impl/handle_hierarchy_parent.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @module node-opcua-address-space
+ *
+ * Extracted from namespace_impl.ts to break an import cycle.
+ *
+ * namespace_impl builds `_constructors_map` at module scope, which references
+ * UAMethodImpl and seven sibling constructors. ua_method_impl imported
+ * _handle_hierarchy_parent back from namespace_impl, closing the loop.
+ *
+ * Under CommonJS that is harmless: whichever module loads second sees a partially
+ * populated exports object, and nothing touches the missing half until a function runs.
+ * Under ESM the class declarations are in the temporal dead zone while the cycle is being
+ * evaluated, so building a map of constructors at module scope throws a ReferenceError.
+ *
+ * This module depends only on base_node_impl and leaf packages, so nothing points back
+ * into namespace_impl and the cycle is gone rather than moved.
+ */
+import type { AddReferenceOpts, BaseNode } from "node-opcua-address-space-base";
+import { NodeId, type NodeIdLike } from "node-opcua-nodeid";
+import type { AddressSpacePrivate } from "./address_space_private.js";
+/**
+ * convert a 'string', NodeId or Object into a valid and existing object
+ * @private
+ */
+export declare function _coerce_parent(addressSpace: AddressSpacePrivate, value: null | string | BaseNode | undefined | NodeIdLike, coerceFunc: (data: string | NodeId | BaseNode) => BaseNode | null): BaseNode | null;
+export interface HandleHierarchyParentOptions {
+    addInOf?: NodeIdLike | BaseNode | null | undefined;
+    componentOf?: NodeIdLike | BaseNode | null | undefined;
+    propertyOf?: NodeIdLike | BaseNode | null | undefined;
+    organizedBy?: NodeIdLike | BaseNode | null | undefined;
+    encodingOf?: NodeIdLike | BaseNode | null | undefined;
+}
+export declare function _handle_hierarchy_parent(addressSpace: AddressSpacePrivate, references: AddReferenceOpts[], options: HandleHierarchyParentOptions): void;

package/dist/impl/handle_hierarchy_parent.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * @module node-opcua-address-space
+ *
+ * Extracted from namespace_impl.ts to break an import cycle.
+ *
+ * namespace_impl builds `_constructors_map` at module scope, which references
+ * UAMethodImpl and seven sibling constructors. ua_method_impl imported
+ * _handle_hierarchy_parent back from namespace_impl, closing the loop.
+ *
+ * Under CommonJS that is harmless: whichever module loads second sees a partially
+ * populated exports object, and nothing touches the missing half until a function runs.
+ * Under ESM the class declarations are in the temporal dead zone while the cycle is being
+ * evaluated, so building a map of constructors at module scope throws a ReferenceError.
+ *
+ * This module depends only on base_node_impl and leaf packages, so nothing points back
+ * into namespace_impl and the cycle is gone rather than moved.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._coerce_parent = _coerce_parent;
+exports._handle_hierarchy_parent = _handle_hierarchy_parent;
+const node_opcua_assert_1 = require("node-opcua-assert");
+const node_opcua_data_model_1 = require("node-opcua-data-model");
+const node_opcua_nodeid_1 = require("node-opcua-nodeid");
+const base_node_impl_js_1 = require("./base_node_impl.js");
+/**
+ * convert a 'string', NodeId or Object into a valid and existing object
+ * @private
+ */
+function _coerce_parent(addressSpace, value, coerceFunc) {
+    (0, node_opcua_assert_1.assert)(typeof coerceFunc === "function");
+    if (value) {
+        if (typeof value === "string") {
+            value = coerceFunc.call(addressSpace, value);
+        }
+        if (value instanceof node_opcua_nodeid_1.NodeId) {
+            value = addressSpace.findNode(value);
+        }
+    }
+    (0, node_opcua_assert_1.assert)(!value || value instanceof base_node_impl_js_1.BaseNodeImpl);
+    return value;
+}
+function _handle_hierarchy_parent(addressSpace, references, options) {
+    options.addInOf = _coerce_parent(addressSpace, options.addInOf, addressSpace._coerceNode);
+    options.componentOf = _coerce_parent(addressSpace, options.componentOf, addressSpace._coerceNode);
+    options.propertyOf = _coerce_parent(addressSpace, options.propertyOf, addressSpace._coerceNode);
+    options.organizedBy = _coerce_parent(addressSpace, options.organizedBy, addressSpace._coerceFolder);
+    options.encodingOf = _coerce_parent(addressSpace, options.encodingOf, addressSpace._coerceNode);
+    if (options.addInOf) {
+        (0, node_opcua_assert_1.assert)(!options.componentOf);
+        (0, node_opcua_assert_1.assert)(!options.propertyOf);
+        (0, node_opcua_assert_1.assert)(!options.organizedBy);
+        (0, node_opcua_assert_1.assert)(options.addInOf.nodeClass === node_opcua_data_model_1.NodeClass.Object || options.addInOf.nodeClass === node_opcua_data_model_1.NodeClass.ObjectType, "addInOf must be of nodeClass Object or ObjectType");
+        references.push({
+            isForward: false,
+            nodeId: options.addInOf.nodeId,
+            referenceType: "HasAddIn"
+        });
+    }
+    if (options.componentOf) {
+        (0, node_opcua_assert_1.assert)(!options.addInOf);
+        (0, node_opcua_assert_1.assert)(!options.propertyOf);
+        (0, node_opcua_assert_1.assert)(!options.organizedBy);
+        (0, node_opcua_assert_1.assert)(addressSpace.rootFolder.objects, "addressSpace must have a rootFolder.objects folder");
+        (0, node_opcua_assert_1.assert)(options.componentOf.nodeId !== addressSpace.rootFolder.objects.nodeId, "Only Organizes References are used to relate Objects to the 'Objects' standard Object.");
+        references.push({
+            isForward: false,
+            nodeId: options.componentOf.nodeId,
+            referenceType: "HasComponent"
+        });
+    }
+    if (options.propertyOf) {
+        (0, node_opcua_assert_1.assert)(!options.addInOf);
+        (0, node_opcua_assert_1.assert)(!options.componentOf);
+        (0, node_opcua_assert_1.assert)(!options.organizedBy);
+        (0, node_opcua_assert_1.assert)(options.propertyOf.nodeId !== addressSpace.rootFolder.objects.nodeId, "Only Organizes References are used to relate Objects to the 'Objects' standard Object.");
+        references.push({
+            isForward: false,
+            nodeId: options.propertyOf.nodeId,
+            referenceType: "HasProperty"
+        });
+    }
+    if (options.organizedBy) {
+        (0, node_opcua_assert_1.assert)(!options.addInOf);
+        (0, node_opcua_assert_1.assert)(!options.propertyOf);
+        (0, node_opcua_assert_1.assert)(!options.componentOf);
+        references.push({
+            isForward: false,
+            nodeId: options.organizedBy.nodeId,
+            referenceType: "Organizes"
+        });
+    }
+    if (options.encodingOf) {
+        // parent must be a DataType
+        (0, node_opcua_assert_1.assert)(options.encodingOf.nodeClass === node_opcua_data_model_1.NodeClass.DataType, "encodingOf must be toward a DataType");
+        references.push({
+            isForward: false,
+            nodeId: options.encodingOf.nodeId,
+            referenceType: "HasEncoding"
+        });
+    }
+}
+//# sourceMappingURL=handle_hierarchy_parent.js.map

package/dist/impl/handle_hierarchy_parent.js.map

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