node-opcua-address-space 2.51.0

package/dist/src/ua_variable_impl.js

@@ -0,0 +1,1719 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UAVariableImplT = exports.UAVariableImpl = exports.verifyRankAndDimensions = exports.adjust_userAccessLevel = exports.adjust_accessLevel = void 0;
+/* eslint-disable max-statements */
+/* eslint-disable complexity */
+/**
+ * @module node-opcua-address-space
+ */
+// tslint:disable:no-bitwise
+// tslint:disable:no-console
+// tslint:disable:max-line-length
+const chalk = require("chalk");
+const node_opcua_assert_1 = require("node-opcua-assert");
+const node_opcua_data_model_1 = require("node-opcua-data-model");
+const node_opcua_data_value_1 = require("node-opcua-data-value");
+const node_opcua_date_time_1 = require("node-opcua-date-time");
+const node_opcua_debug_1 = require("node-opcua-debug");
+const node_opcua_nodeid_1 = require("node-opcua-nodeid");
+const node_opcua_numeric_range_1 = require("node-opcua-numeric-range");
+const node_opcua_service_write_1 = require("node-opcua-service-write");
+const node_opcua_status_code_1 = require("node-opcua-status-code");
+const node_opcua_types_1 = require("node-opcua-types");
+const utils = require("node-opcua-utils");
+const node_opcua_utils_1 = require("node-opcua-utils");
+const node_opcua_variant_1 = require("node-opcua-variant");
+const session_context_1 = require("../source/session_context");
+const base_node_impl_1 = require("./base_node_impl");
+const base_node_private_1 = require("./base_node_private");
+const ua_data_type_impl_1 = require("./ua_data_type_impl");
+const apply_condition_refresh_1 = require("./apply_condition_refresh");
+const debugLog = (0, node_opcua_debug_1.make_debugLog)(__filename);
+const warningLog = (0, node_opcua_debug_1.make_warningLog)(__filename);
+const doDebug = (0, node_opcua_debug_1.checkDebugFlag)(__filename);
+const errorLog = (0, node_opcua_debug_1.make_errorLog)(__filename);
+function isGoodish(statusCode) {
+    return statusCode.value < 0x10000000;
+}
+function adjust_accessLevel(accessLevel) {
+    accessLevel = utils.isNullOrUndefined(accessLevel) ? "CurrentRead | CurrentWrite" : accessLevel;
+    accessLevel = (0, node_opcua_data_model_1.makeAccessLevelFlag)(accessLevel);
+    (0, node_opcua_assert_1.assert)(isFinite(accessLevel));
+    return accessLevel;
+}
+exports.adjust_accessLevel = adjust_accessLevel;
+function adjust_userAccessLevel(userAccessLevel, accessLevel) {
+    if (userAccessLevel === undefined) {
+        return undefined;
+    }
+    userAccessLevel = adjust_accessLevel(userAccessLevel);
+    accessLevel = adjust_accessLevel(accessLevel);
+    return (0, node_opcua_data_model_1.makeAccessLevelFlag)(accessLevel & userAccessLevel);
+}
+exports.adjust_userAccessLevel = adjust_userAccessLevel;
+function adjust_samplingInterval(minimumSamplingInterval) {
+    (0, node_opcua_assert_1.assert)(isFinite(minimumSamplingInterval));
+    if (minimumSamplingInterval < 0) {
+        return -1; // only -1 is a valid negative value for samplingInterval and means "unspecified"
+    }
+    return minimumSamplingInterval;
+}
+function is_Variant(v) {
+    return v instanceof node_opcua_variant_1.Variant;
+}
+function is_StatusCode(v) {
+    return (v &&
+        v.constructor &&
+        (v.constructor.name === "ConstantStatusCode" ||
+            v.constructor.name === "StatusCode" ||
+            v.constructor.name === "ModifiableStatusCode"));
+}
+function is_Variant_or_StatusCode(v) {
+    if (is_Variant(v)) {
+        // /@@assert(v.isValid());
+    }
+    return is_Variant(v) || is_StatusCode(v);
+}
+function _dataType_toUADataType(addressSpace, dataType) {
+    (0, node_opcua_assert_1.assert)(addressSpace);
+    (0, node_opcua_assert_1.assert)(dataType !== node_opcua_variant_1.DataType.Null);
+    const dataTypeNode = addressSpace.findDataType(node_opcua_variant_1.DataType[dataType]);
+    /* istanbul ignore next */
+    if (!dataTypeNode) {
+        throw new Error(" Cannot find DataType " + node_opcua_variant_1.DataType[dataType] + " in address Space");
+    }
+    return dataTypeNode;
+}
+/*=
+ *
+ * @param addressSpace
+ * @param dataTypeNodeId : the nodeId matching the dataType of the destination variable.
+ * @param variantDataType: the dataType of the variant to write to the destination variable
+ * @param nodeId
+ * @return {boolean} true if the variant dataType is compatible with the Variable DataType
+ */
+function validateDataType(addressSpace, dataTypeNodeId, variantDataType, nodeId, allowNulls) {
+    if (variantDataType === node_opcua_variant_1.DataType.ExtensionObject) {
+        return true;
+    }
+    if (variantDataType === node_opcua_variant_1.DataType.Null && allowNulls) {
+        return true;
+    }
+    if (variantDataType === node_opcua_variant_1.DataType.Null && !allowNulls) {
+        return false;
+    }
+    let builtInType;
+    let builtInUADataType;
+    const destUADataType = addressSpace.findNode(dataTypeNodeId);
+    (0, node_opcua_assert_1.assert)(destUADataType instanceof ua_data_type_impl_1.UADataTypeImpl);
+    if (destUADataType.isAbstract || destUADataType.nodeId.namespace !== 0) {
+        builtInUADataType = destUADataType;
+    }
+    else {
+        builtInType = node_opcua_variant_1.DataType[addressSpace.findCorrespondingBasicDataType(destUADataType)];
+        builtInUADataType = addressSpace.findDataType(builtInType);
+    }
+    (0, node_opcua_assert_1.assert)(builtInUADataType instanceof ua_data_type_impl_1.UADataTypeImpl);
+    const enumerationUADataType = addressSpace.findDataType("Enumeration");
+    if (!enumerationUADataType) {
+        throw new Error("cannot find Enumeration DataType node in standard address space");
+    }
+    if (destUADataType.isSupertypeOf(enumerationUADataType)) {
+        // istanbul ignore next
+        if (doDebug) {
+            console.log("destUADataType.", destUADataType.browseName.toString(), destUADataType.nodeId.toString());
+            console.log("enumerationUADataType.", enumerationUADataType.browseName.toString(), enumerationUADataType.nodeId.toString());
+        }
+        return true;
+    }
+    // The value supplied for the attribute is not of the same type as the  value.
+    const variantUADataType = _dataType_toUADataType(addressSpace, variantDataType);
+    (0, node_opcua_assert_1.assert)(variantUADataType instanceof ua_data_type_impl_1.UADataTypeImpl);
+    const dest_isSuperTypeOf_variant = variantUADataType.isSupertypeOf(builtInUADataType);
+    /* istanbul ignore next */
+    if (doDebug) {
+        if (dest_isSuperTypeOf_variant) {
+            /* istanbul ignore next*/
+            console.log(chalk.green(" ---------- Type match !!! "), " on ", nodeId.toString());
+        }
+        else {
+            /* istanbul ignore next*/
+            console.log(chalk.red(" ---------- Type mismatch "), " on ", nodeId.toString());
+        }
+        console.log(chalk.cyan(" Variable data Type is    = "), destUADataType.browseName.toString());
+        console.log(chalk.cyan(" which matches basic Type = "), builtInUADataType.browseName.toString());
+        console.log(chalk.yellow("        Actual   dataType = "), variantUADataType.browseName.toString());
+    }
+    return dest_isSuperTypeOf_variant;
+}
+function verifyRankAndDimensions(options) {
+    // evaluate valueRank arrayDimensions is specified but valueRank is null
+    if (options.arrayDimensions && options.valueRank === undefined) {
+        options.valueRank = options.arrayDimensions.length;
+    }
+    options.valueRank = options.valueRank === undefined ? -1 : options.valueRank || 0; // UInt32
+    (0, node_opcua_assert_1.assert)(typeof options.valueRank === "number");
+    options.arrayDimensions = options.arrayDimensions || null;
+    (0, node_opcua_assert_1.assert)(options.arrayDimensions === null || Array.isArray(options.arrayDimensions));
+    if (options.arrayDimensions && options.valueRank <= 0) {
+        throw new Error("[CONFORMANCE] arrayDimensions must be null if valueRank <=0");
+    }
+    // specify default arrayDimension if not provided
+    if (options.valueRank > 0 && !options.arrayDimensions) {
+        options.arrayDimensions = new Array(options.valueRank).fill(0);
+    }
+    if (!options.arrayDimensions && options.valueRank > 0) {
+        throw new Error("[CONFORMANCE] arrayDimension must be specified  if valueRank >0 " + options.valueRank);
+    }
+    if (options.valueRank > 0 && options.arrayDimensions.length !== options.valueRank) {
+        throw new Error("[CONFORMANCE] when valueRank> 0, arrayDimensions must have valueRank elements, this.valueRank =" +
+            options.valueRank +
+            "  whereas arrayDimensions.length =" +
+            options.arrayDimensions.length);
+    }
+}
+exports.verifyRankAndDimensions = verifyRankAndDimensions;
+/**
+ * A OPCUA Variable Node
+ *
+ * @class UAVariable
+ * @constructor
+ * @extends  BaseNode
+ *  The AccessLevel Attribute is used to indicate how the Value of a Variable can be accessed (read/write) and if it
+ *  contains current and/or historic data. The AccessLevel does not take any user access rights into account,
+ *  i.e. although the Variable is writable this may be restricted to a certain user / user group.
+ *  The AccessLevel is an 8-bit unsigned integer with the structure defined in the following table:
+ *
+ *  Field            Bit    Description
+ *  CurrentRead      0      Indicates if the current value is readable
+ *                          (0 means not readable, 1 means readable).
+ *  CurrentWrite     1      Indicates if the current value is writable
+ *                          (0 means not writable, 1 means writable).
+ *  HistoryRead      2      Indicates if the history of the value is readable
+ *                          (0 means not readable, 1 means readable).
+ *  HistoryWrite     3      Indicates if the history of the value is writable (0 means not writable, 1 means writable).
+ *  SemanticChange   4      Indicates if the Variable used as Property generates SemanticChangeEvents (see 9.31).
+ *  Reserved         5:7    Reserved for future use. Shall always be zero.
+ *
+ *  The first two bits also indicate if a current value of this Variable is available and the second two bits
+ *  indicates if the history of the Variable is available via the OPC UA server.
+ *
+ */
+class UAVariableImpl extends base_node_impl_1.BaseNodeImpl {
+    constructor(options) {
+        super(options);
+        this.nodeClass = node_opcua_data_model_1.NodeClass.Variable;
+        verifyRankAndDimensions(options);
+        this.valueRank = options.valueRank;
+        this.arrayDimensions = options.arrayDimensions;
+        this.dataType = this.resolveNodeId(options.dataType); // DataType (NodeId)
+        this.accessLevel = adjust_accessLevel(options.accessLevel);
+        this.userAccessLevel = adjust_userAccessLevel(options.userAccessLevel, this.accessLevel);
+        this.minimumSamplingInterval = adjust_samplingInterval(options.minimumSamplingInterval || 0);
+        this.historizing = !!options.historizing; // coerced to boolean
+        this._dataValue = new node_opcua_data_value_1.DataValue({ statusCode: node_opcua_status_code_1.StatusCodes.UncertainInitialValue, value: {} });
+        // xx options.value = options.value || { dataType: DataType.Null };
+        if (options.value) {
+            this.bindVariable(options.value);
+        }
+        this.setMaxListeners(5000);
+        this.semantic_version = 0;
+    }
+    get typeDefinitionObj() {
+        return super.typeDefinitionObj;
+    }
+    get typeDefinition() {
+        return super.typeDefinition;
+    }
+    checkPermissionAndAccessLevelPrivate(context, permission, accessLevel) {
+        (0, node_opcua_assert_1.assert)(context instanceof session_context_1.SessionContext);
+        if (context.checkPermission) {
+            (0, node_opcua_assert_1.assert)(context.checkPermission instanceof Function);
+            if (!context.checkPermission(this, permission)) {
+                return false;
+            }
+        }
+        if (this.userAccessLevel === undefined) {
+            return true;
+        }
+        return (this.userAccessLevel & accessLevel) === accessLevel;
+    }
+    isReadable(context) {
+        return (this.accessLevel & node_opcua_data_model_1.AccessLevelFlag.CurrentRead) === node_opcua_data_model_1.AccessLevelFlag.CurrentRead;
+    }
+    isUserReadable(context) {
+        if (!this.isReadable(context)) {
+            return false;
+        }
+        return this.checkPermissionAndAccessLevelPrivate(context, node_opcua_types_1.PermissionType.Read, node_opcua_data_model_1.AccessLevelFlag.CurrentRead);
+    }
+    isWritable(context) {
+        return (this.accessLevel & node_opcua_data_model_1.AccessLevelFlag.CurrentWrite) === node_opcua_data_model_1.AccessLevelFlag.CurrentWrite;
+    }
+    isUserWritable(context) {
+        if (!this.isWritable(context)) {
+            return false;
+        }
+        return this.checkPermissionAndAccessLevelPrivate(context, node_opcua_types_1.PermissionType.Write, node_opcua_data_model_1.AccessLevelFlag.CurrentWrite);
+    }
+    /**
+     *
+     *
+     * from OPC.UA.Spec 1.02 part 4
+     *  5.10.2.4 StatusCodes
+     *  Table 51 defines values for the operation level statusCode contained in the DataValue structure of
+     *  each values element. Common StatusCodes are defined in Table 166.
+     *
+     * Table 51 Read Operation Level Result Codes
+     *
+     *  Symbolic Id                 Description
+     *
+     *  BadNodeIdInvalid            The syntax of the node id is not valid.
+     *  BadNodeIdUnknown            The node id refers to a node that does not exist in the server address space.
+     *  BadAttributeIdInvalid       BadAttributeIdInvalid The attribute is not supported for the specified node.
+     *  BadIndexRangeInvalid        The syntax of the index range parameter is invalid.
+     *  BadIndexRangeNoData         No data exists within the range of indexes specified.
+     *  BadDataEncodingInvalid      The data encoding is invalid.
+     *                              This result is used if no dataEncoding can be applied because an Attribute other
+     *                              than Value was requested or the DataType of the Value Attribute is not a subtype
+     *                              of the Structure DataType.
+     *  BadDataEncodingUnsupported  The server does not support the requested data encoding for the node.
+     *                              This result is used if a dataEncoding can be applied but the passed data encoding
+     *                              is not known to the Server.
+     *  BadNotReadable              The access level does not allow reading or subscribing to the Node.
+     *  BadUserAccessDenied         User does not have permission to perform the requested operation. (table 165)
+     */
+    readValue(context, indexRange, dataEncoding) {
+        if (!context) {
+            context = session_context_1.SessionContext.defaultContext;
+        }
+        if (context.isAccessRestricted(this)) {
+            return new node_opcua_data_value_1.DataValue({ statusCode: node_opcua_status_code_1.StatusCodes.BadSecurityModeInsufficient });
+        }
+        if (!this.isReadable(context)) {
+            return new node_opcua_data_value_1.DataValue({ statusCode: node_opcua_status_code_1.StatusCodes.BadNotReadable });
+        }
+        if (!this.isUserReadable(context)) {
+            return new node_opcua_data_value_1.DataValue({ statusCode: node_opcua_status_code_1.StatusCodes.BadUserAccessDenied });
+        }
+        if (!(0, node_opcua_data_model_1.isValidDataEncoding)(dataEncoding)) {
+            return new node_opcua_data_value_1.DataValue({ statusCode: node_opcua_status_code_1.StatusCodes.BadDataEncodingInvalid });
+        }
+        if (this._timestamped_get_func) {
+            if (this._timestamped_get_func.length === 0) {
+                this._dataValue = this._timestamped_get_func();
+            }
+        }
+        let dataValue = this._dataValue;
+        if (isGoodish(dataValue.statusCode)) {
+            // note : extractRange will clone the dataValue
+            dataValue = (0, node_opcua_data_value_1.extractRange)(dataValue, indexRange);
+        }
+        /* istanbul ignore next */
+        if (dataValue.statusCode.equals(node_opcua_status_code_1.StatusCodes.BadWaitingForInitialData) ||
+            dataValue.statusCode.equals(node_opcua_status_code_1.StatusCodes.UncertainInitialValue)) {
+            debugLog(chalk.red(" Warning:  UAVariable#readValue ") +
+                chalk.cyan(this.browseName.toString()) +
+                " (" +
+                chalk.yellow(this.nodeId.toString()) +
+                ") exists but dataValue has not been defined");
+        }
+        return dataValue;
+    }
+    isEnumeration() {
+        return this.addressSpacePrivate.isEnumeration(this.dataType);
+    }
+    isExtensionObject() {
+        // DataType must be one of Structure
+        const dataTypeNode = this.addressSpace.findDataType(this.dataType);
+        if (!dataTypeNode) {
+            throw new Error(" Cannot find  DataType  " + this.dataType.toString() + " in standard address Space");
+        }
+        const structureNode = this.addressSpace.findDataType("Structure");
+        if (!structureNode) {
+            throw new Error(" Cannot find 'Structure' DataType in standard address Space");
+        }
+        return dataTypeNode.isSupertypeOf(structureNode);
+    }
+    _getEnumerationInfo() {
+        // DataType must be one of Enumeration
+        (0, node_opcua_assert_1.assert)(this.isEnumeration(), "Variable is not an enumeration");
+        const dataTypeNode = this.addressSpace.findDataType(this.dataType);
+        return dataTypeNode._getEnumerationInfo();
+    }
+    asyncRefresh(...args) {
+        const oldestDate = args[0];
+        (0, node_opcua_assert_1.assert)(oldestDate instanceof Date);
+        const callback = args[1];
+        if (!this.refreshFunc) {
+            // no refresh func
+            const dataValue = this.readValue();
+            dataValue.serverTimestamp = oldestDate;
+            dataValue.serverPicoseconds = 0;
+            if (oldestDate.getTime() <= dataValue.serverTimestamp.getTime()) {
+                return callback(null, dataValue);
+            }
+            else {
+                // fake
+                return callback(null, dataValue);
+            }
+        }
+        if (this._dataValue.serverTimestamp && oldestDate.getTime() <= this._dataValue.serverTimestamp.getTime()) {
+            const dataValue = this.readValue();
+            dataValue.serverTimestamp = oldestDate;
+            dataValue.serverPicoseconds = 0;
+            return callback(null, dataValue);
+        }
+        this.refreshFunc.call(this, (err, dataValue) => {
+            if (err || !dataValue) {
+                dataValue = { statusCode: node_opcua_status_code_1.StatusCodes.BadNoDataAvailable };
+            }
+            if (dataValue !== this._dataValue) {
+                this._internal_set_dataValue(coerceDataValue(dataValue), null);
+            }
+            callback(err, this._dataValue);
+        });
+    }
+    readEnumValue() {
+        const value = this.readValue().value.value;
+        const enumInfo = this._getEnumerationInfo();
+        const enumV = enumInfo.valueIndex[value];
+        return { value, name: enumV ? enumV.name : "?????" };
+    }
+    writeEnumValue(value) {
+        const enumInfo = this._getEnumerationInfo();
+        if (typeof value === "string") {
+            if (!Object.prototype.hasOwnProperty.call(enumInfo.nameIndex, value)) {
+                const possibleValues = Object.keys(enumInfo.nameIndex).join(",");
+                throw new Error("UAVariable#writeEnumValue: cannot find value " + value + " in [" + possibleValues + "]");
+            }
+            const valueIndex = enumInfo.nameIndex[value].value;
+            value = valueIndex;
+        }
+        if (isFinite(value)) {
+            const possibleValues = Object.keys(enumInfo.nameIndex).join(",");
+            if (!enumInfo.valueIndex[value]) {
+                throw new Error("UAVariable#writeEnumValue : value out of range " + value + " in [" + possibleValues + "]");
+            }
+            this.setValueFromSource({
+                dataType: node_opcua_variant_1.DataType.Int32,
+                value
+            });
+        }
+        else {
+            throw new Error("UAVariable#writeEnumValue:  value type mismatch");
+        }
+    }
+    readAttribute(context, attributeId, indexRange, dataEncoding) {
+        context = context || session_context_1.SessionContext.defaultContext;
+        (0, node_opcua_assert_1.assert)(context instanceof session_context_1.SessionContext);
+        const options = {};
+        if (attributeId !== node_opcua_data_model_1.AttributeIds.Value) {
+            if (indexRange && indexRange.isDefined()) {
+                options.statusCode = node_opcua_status_code_1.StatusCodes.BadIndexRangeNoData;
+                return new node_opcua_data_value_1.DataValue(options);
+            }
+            if ((0, node_opcua_data_model_1.isDataEncoding)(dataEncoding)) {
+                options.statusCode = node_opcua_status_code_1.StatusCodes.BadDataEncodingInvalid;
+                return new node_opcua_data_value_1.DataValue(options);
+            }
+        }
+        switch (attributeId) {
+            case node_opcua_data_model_1.AttributeIds.Value:
+                return this.readValue(context, indexRange, dataEncoding);
+            case node_opcua_data_model_1.AttributeIds.DataType:
+                return this._readDataType();
+            case node_opcua_data_model_1.AttributeIds.ValueRank:
+                return this._readValueRank();
+            case node_opcua_data_model_1.AttributeIds.ArrayDimensions:
+                return this._readArrayDimensions();
+            case node_opcua_data_model_1.AttributeIds.AccessLevel:
+                return this._readAccessLevel(context);
+            case node_opcua_data_model_1.AttributeIds.UserAccessLevel:
+                return this._readUserAccessLevel(context);
+            case node_opcua_data_model_1.AttributeIds.MinimumSamplingInterval:
+                return this._readMinimumSamplingInterval();
+            case node_opcua_data_model_1.AttributeIds.Historizing:
+                return this._readHistorizing();
+            case node_opcua_data_model_1.AttributeIds.AccessLevelEx:
+                return this._readAccessLevelEx(context);
+            default:
+                return base_node_impl_1.BaseNodeImpl.prototype.readAttribute.call(this, context, attributeId);
+        }
+    }
+    adjustVariant(variant) {
+        const addressSpace = this.addressSpace;
+        const dataTypeNodeId = addressSpace.findCorrespondingBasicDataType(this.dataType);
+        return (0, node_opcua_variant_1.adjustVariant)(variant, this.valueRank, dataTypeNodeId);
+    }
+    /**
+     * setValueFromSource is used to let the device sets the variable values
+     * this method also records the current time as sourceTimestamp and serverTimestamp.
+.     *
+     * The method will raise an exception if the value is not compatible with the dataType and expected dimension
+     *
+     * @method setValueFromSource
+     * @param variant  {Variant}
+     * @param [statusCode  {StatusCode} = StatusCodes.Good]
+     * @param [sourceTimestamp= Now]
+     */
+    setValueFromSource(variant, statusCode, sourceTimestamp) {
+        statusCode = statusCode || node_opcua_status_code_1.StatusCodes.Good;
+        // istanbul ignore next
+        if (Object.prototype.hasOwnProperty.call(variant, "value")) {
+            if (variant.dataType === null || variant.dataType === undefined) {
+                throw new Error("Variant must provide a valid dataType" + variant.toString());
+            }
+            if (variant.dataType === node_opcua_variant_1.DataType.Boolean &&
+                (this.dataType.namespace !== 0 || this.dataType.value !== node_opcua_variant_1.DataType.Boolean)) {
+                throw new Error("Variant must provide a valid Boolean" + variant.toString());
+            }
+            if (this.dataType.namespace === 0 &&
+                this.dataType.value === node_opcua_variant_1.DataType.LocalizedText &&
+                variant.dataType !== node_opcua_variant_1.DataType.LocalizedText) {
+                throw new Error("Variant must provide a valid LocalizedText" + variant.toString());
+            }
+        }
+        const variant1 = node_opcua_variant_1.Variant.coerce(variant);
+        const now = (0, node_opcua_date_time_1.coerceClock)(sourceTimestamp, 0);
+        const dataValue = new node_opcua_data_value_1.DataValue(null);
+        dataValue.serverPicoseconds = now.picoseconds;
+        dataValue.serverTimestamp = now.timestamp;
+        dataValue.sourcePicoseconds = now.picoseconds;
+        dataValue.sourceTimestamp = now.timestamp;
+        dataValue.statusCode = statusCode;
+        dataValue.value = variant1;
+        this._internal_set_dataValue(dataValue);
+    }
+    writeValue(context, dataValue, ...args) {
+        context = context || session_context_1.SessionContext.defaultContext;
+        (0, node_opcua_assert_1.assert)(context instanceof session_context_1.SessionContext);
+        if (!dataValue.sourceTimestamp) {
+            // source timestamp was not specified by the caller
+            // we will set the timestamp ourself with the current clock
+            if (context.currentTime) {
+                dataValue.sourceTimestamp = context.currentTime.timestamp;
+                dataValue.sourcePicoseconds = context.currentTime.picoseconds;
+            }
+            else {
+                const { timestamp, picoseconds } = (0, node_opcua_date_time_1.getCurrentClock)();
+                dataValue.sourceTimestamp = timestamp;
+                dataValue.sourcePicoseconds = picoseconds;
+            }
+        }
+        if (context.currentTime && !dataValue.serverTimestamp) {
+            dataValue.serverTimestamp = context.currentTime.timestamp;
+            dataValue.serverPicoseconds = context.currentTime.picoseconds;
+        }
+        // adjust arguments if optional indexRange Parameter is not given
+        let indexRange = null;
+        let callback;
+        if (args.length === 1) {
+            indexRange = new node_opcua_numeric_range_1.NumericRange();
+            callback = args[0];
+        }
+        else if (args.length === 2) {
+            indexRange = args[0];
+            callback = args[1];
+        }
+        else {
+            throw new Error("Invalid Number of args");
+        }
+        (0, node_opcua_assert_1.assert)(typeof callback === "function");
+        (0, node_opcua_assert_1.assert)(dataValue instanceof node_opcua_data_value_1.DataValue);
+        // index range could be string
+        indexRange = node_opcua_numeric_range_1.NumericRange.coerce(indexRange);
+        // test write permission
+        if (!this.isWritable(context)) {
+            return callback(null, node_opcua_status_code_1.StatusCodes.BadNotWritable);
+        }
+        if (!this.isUserWritable(context)) {
+            return callback(null, node_opcua_status_code_1.StatusCodes.BadUserAccessDenied);
+        }
+        // adjust special case
+        const variant = adjustVariant2.call(this, dataValue.value);
+        const statusCode = this.checkVariantCompatibility(variant);
+        if (statusCode.isNot(node_opcua_status_code_1.StatusCodes.Good)) {
+            return callback(null, statusCode);
+        }
+        function default_func(dataValue1, indexRange1, callback1) {
+            // xx assert(!indexRange,"indexRange Not Implemented");
+            return _default_writable_timestamped_set_func.call(this, dataValue1, callback1);
+        }
+        const write_func = (this._timestamped_set_func || default_func);
+        if (!write_func) {
+            warningLog(" warning " + this.nodeId.toString() + " " + this.browseName.toString() + " has no setter. \n");
+            warningLog("Please make sure to bind the variable or to pass a valid value: new Variant({}) during construction time");
+            return callback(null, node_opcua_status_code_1.StatusCodes.BadNotWritable);
+        }
+        (0, node_opcua_assert_1.assert)(write_func);
+        write_func.call(this, dataValue, indexRange, (err, statusCode1, correctedDataValue) => {
+            if (!err) {
+                correctedDataValue = correctedDataValue || dataValue;
+                (0, node_opcua_assert_1.assert)(correctedDataValue instanceof node_opcua_data_value_1.DataValue);
+                // xx assert(correctedDataValue.serverTimestamp);
+                if (indexRange && !indexRange.isEmpty()) {
+                    if (!indexRange.isValid()) {
+                        return callback(null, node_opcua_status_code_1.StatusCodes.BadIndexRangeInvalid);
+                    }
+                    const newArrayOrMatrix = correctedDataValue.value.value;
+                    if (correctedDataValue.value.arrayType === node_opcua_variant_1.VariantArrayType.Array) {
+                        if (this._dataValue.value.arrayType !== node_opcua_variant_1.VariantArrayType.Array) {
+                            return callback(null, node_opcua_status_code_1.StatusCodes.BadTypeMismatch);
+                        }
+                        // check that destination data is also an array
+                        (0, node_opcua_assert_1.assert)(check_valid_array(this._dataValue.value.dataType, this._dataValue.value.value));
+                        const destArr = this._dataValue.value.value;
+                        const result = indexRange.set_values(destArr, newArrayOrMatrix);
+                        if (result.statusCode.isNot(node_opcua_status_code_1.StatusCodes.Good)) {
+                            return callback(null, result.statusCode);
+                        }
+                        correctedDataValue.value.value = result.array;
+                        // scrap original array so we detect range
+                        this._dataValue.value.value = null;
+                    }
+                    else if (correctedDataValue.value.arrayType === node_opcua_variant_1.VariantArrayType.Matrix) {
+                        const dimensions = this._dataValue.value.dimensions;
+                        if (this._dataValue.value.arrayType !== node_opcua_variant_1.VariantArrayType.Matrix || !dimensions) {
+                            // not a matrix !
+                            return callback(null, node_opcua_status_code_1.StatusCodes.BadTypeMismatch);
+                        }
+                        const matrix = this._dataValue.value.value;
+                        const result = indexRange.set_values_matrix({
+                            matrix,
+                            dimensions
+                        }, newArrayOrMatrix);
+                        if (result.statusCode.isNot(node_opcua_status_code_1.StatusCodes.Good)) {
+                            return callback(null, result.statusCode);
+                        }
+                        correctedDataValue.value.dimensions = this._dataValue.value.dimensions;
+                        correctedDataValue.value.value = result.matrix;
+                        // scrap original array so we detect range
+                        this._dataValue.value.value = null;
+                    }
+                    else {
+                        return callback(null, node_opcua_status_code_1.StatusCodes.BadTypeMismatch);
+                    }
+                }
+                try {
+                    this._internal_set_dataValue(correctedDataValue, indexRange);
+                }
+                catch (err) {
+                    if (err instanceof Error) {
+                        warningLog(err.message);
+                    }
+                    return callback(null, node_opcua_status_code_1.StatusCodes.BadInternalError);
+                }
+            }
+            callback(err, statusCode1);
+        });
+    }
+    writeAttribute(context, writeValueOptions, callback) {
+        // istanbul ignore next
+        if (!callback) {
+            throw new Error("Internal error");
+        }
+        const writeValue = writeValueOptions instanceof node_opcua_service_write_1.WriteValue ? writeValueOptions : new node_opcua_service_write_1.WriteValue(writeValueOptions);
+        context = context || session_context_1.SessionContext.defaultContext;
+        (0, node_opcua_assert_1.assert)(context instanceof session_context_1.SessionContext);
+        (0, node_opcua_assert_1.assert)(writeValue instanceof node_opcua_service_write_1.WriteValue);
+        (0, node_opcua_assert_1.assert)(writeValue.value instanceof node_opcua_data_value_1.DataValue);
+        (0, node_opcua_assert_1.assert)(writeValue.value.value instanceof node_opcua_variant_1.Variant);
+        (0, node_opcua_assert_1.assert)(typeof callback === "function");
+        // Spec 1.0.2 Part 4 page 58
+        // If the SourceTimestamp or the ServerTimestamp is specified, the Server shall
+        // use these values.
+        // xx _apply_default_timestamps(writeValue.value);
+        switch (writeValue.attributeId) {
+            case node_opcua_data_model_1.AttributeIds.Value:
+                this.writeValue(context, writeValue.value, writeValue.indexRange, callback);
+                break;
+            case node_opcua_data_model_1.AttributeIds.Historizing:
+                if (writeValue.value.value.dataType !== node_opcua_variant_1.DataType.Boolean) {
+                    return callback(null, node_opcua_status_code_1.StatusCodes.BadNotSupported);
+                }
+                // if the variable has no historizing in place reject
+                if (!this["hA Configuration"]) {
+                    return callback(null, node_opcua_status_code_1.StatusCodes.BadNotSupported);
+                }
+                // check if user is allowed to do that !
+                // TODO
+                this.historizing = !!writeValue.value.value.value; // yes ! indeed !
+                return callback(null, node_opcua_status_code_1.StatusCodes.Good);
+            default:
+                super.writeAttribute(context, writeValue, callback);
+                break;
+        }
+    }
+    /**
+     * @method checkVariantCompatibility
+     * note:
+     *     this method is overridden in address-space-data-access
+     * @return {StatusCode}
+     */
+    checkVariantCompatibility(value) {
+        // test dataType
+        if (!this._validate_DataType(value.dataType)) {
+            return node_opcua_status_code_1.StatusCodes.BadTypeMismatch;
+        }
+        return node_opcua_status_code_1.StatusCodes.Good;
+    }
+    /**
+     * @method touchValue
+     * touch the source timestamp of a Variable and cascade up the change
+     * to the parent variable if any.
+     *
+     * @param [optionalNow=null] {Object}
+     * @param optionalNow.timestamp    {Date}
+     * @param optionalNow.picoseconds  {Number}
+     */
+    touchValue(optionalNow) {
+        const now = optionalNow || (0, node_opcua_date_time_1.getCurrentClock)();
+        this._dataValue.sourceTimestamp = now.timestamp;
+        this._dataValue.sourcePicoseconds = now.picoseconds;
+        this._dataValue.serverTimestamp = now.timestamp;
+        this._dataValue.serverPicoseconds = now.picoseconds;
+        this._dataValue.statusCode = node_opcua_status_code_1.StatusCodes.Good;
+        if (this.minimumSamplingInterval === 0) {
+            if (this.listenerCount("value_changed") > 0) {
+                const clonedDataValue = this.readValue();
+                this.emit("value_changed", clonedDataValue);
+            }
+        }
+        if (this.parent && this.parent.nodeClass === node_opcua_data_model_1.NodeClass.Variable) {
+            this.parent.touchValue(now);
+        }
+    }
+    /**
+     * bind a variable with a get and set functions.
+     *
+     *  properties:
+     *    - value: a Variant or a status code
+     *    - sourceTimestamp
+     *    - sourcePicoseconds
+     * @param [options.timestamped_set]
+     * @param [options.refreshFunc]      the variable asynchronous getter function.
+     * @param [overwrite {Boolean} = false] set overwrite to true to overwrite existing binding
+     * @return void
+     *
+     *
+     * ### Providing read access to the underlying value
+     *
+     * #### Variation 1
+     *
+     * In this variation, the user provides a function that returns a Variant with the current value.
+     *
+     * The sourceTimestamp will be set automatically.
+     *
+     * The get function is called synchronously.
+     *
+     * @example
+     *
+     *
+     * ```javascript
+     *     ...
+     *     var options =  {
+     *       get : () => {
+     *          return new Variant({...});
+     *       },
+     *       set : function(variant) {
+     *          // store the variant somewhere
+     *          return StatusCodes.Good;
+     *       }
+     *    };
+     *    ...
+     *    engine.bindVariable(nodeId,options):
+     *    ...
+     * ```
+     *
+     *
+     * #### Variation 2:
+     *
+     * This variation can be used when the user wants to specify a specific '''sourceTimestamp''' associated
+     * with the current value of the UAVariable.
+     *
+     * The provided ```timestamped_get``` function should return an object with three properties:
+     * * value: containing the variant value or a error StatusCode,
+     * * sourceTimestamp
+     * * sourcePicoseconds
+     *
+     * ```javascript
+     * ...
+     * var myDataValue = new DataValue({
+     *   value: {dataType: DataType.Double , value: 10.0},
+     *   sourceTimestamp : new Date(),
+     *   sourcePicoseconds: 0
+     * });
+     * ...
+     * var options =  {
+     *   timestamped_get : () => { return myDataValue;  }
+     * };
+     * ...
+     * engine.bindVariable(nodeId,options):
+     * ...
+     * // record a new value
+     * myDataValue.value.value = 5.0;
+     * myDataValue.sourceTimestamp = new Date();
+     * ...
+     * ```
+     *
+     *
+     * #### Variation 3:
+     *
+     * This variation can be used when the value associated with the variables requires a asynchronous function call to be
+     * extracted. In this case, the user should provide an async method ```refreshFunc```.
+     *
+     *
+     * The ```refreshFunc``` shall do whatever is necessary to fetch the most up to date version of the variable value, and
+     * call the ```callback``` function when the data is ready.
+     *
+     *
+     * The ```callback``` function follow the standard callback function signature:
+     * * the first argument shall be **null** or **Error**, depending of the outcome of the fetch operation,
+     * * the second argument shall be a DataValue with the new UAVariable Value,  a StatusCode, and time stamps.
+     *
+     *
+     * Optionally, it is possible to pass a sourceTimestamp and a sourcePicoseconds value as a third and fourth arguments
+     * of the callback. When sourceTimestamp and sourcePicoseconds are missing, the system will set their default value
+     * to the current time..
+     *
+     *
+     * ```javascript
+     * ...
+     * var options =  {
+     *    refreshFunc : function(callback) {
+     *      ... do_some_async_stuff_to_get_the_new_variable_value
+     *      var dataValue = new DataValue({
+     *          value: new Variant({...}),
+     *          statusCode: StatusCodes.Good,
+     *          sourceTimestamp: new Date()
+     *      });
+     *      callback(null,dataValue);
+     *    }
+     * };
+     * ...
+     * variable.bindVariable(nodeId,options):
+     * ...
+     * ```
+     *
+     * ### Providing write access to the underlying value
+     *
+     * #### Variation1 - provide a simple synchronous set function
+     *
+     *
+     * #### Notes
+     *   to do : explain return StatusCodes.GoodCompletesAsynchronously;
+     *
+     */
+    bindVariable(options, overwrite) {
+        if (overwrite) {
+            this._timestamped_set_func = null;
+            this._timestamped_get_func = null;
+            this._get_func = null;
+            this._set_func = null;
+            this.refreshFunc = undefined;
+            this._historyRead = UAVariableImpl.prototype._historyRead;
+        }
+        options = options || {};
+        (0, node_opcua_assert_1.assert)(typeof this._timestamped_set_func !== "function", "UAVariable already bound");
+        (0, node_opcua_assert_1.assert)(typeof this._timestamped_get_func !== "function", "UAVariable already bound");
+        bind_getter.call(this, options);
+        bind_setter.call(this, options);
+        const _historyRead = options.historyRead;
+        if (_historyRead) {
+            (0, node_opcua_assert_1.assert)(typeof this._historyRead !== "function" || this._historyRead === UAVariableImpl.prototype._historyRead);
+            (0, node_opcua_assert_1.assert)(typeof _historyRead === "function");
+            this._historyRead = _historyRead;
+            (0, node_opcua_assert_1.assert)(this._historyRead.length === 6);
+        }
+        (0, node_opcua_assert_1.assert)(typeof this._timestamped_set_func === "function");
+        (0, node_opcua_assert_1.assert)(this._timestamped_set_func.length === 3);
+    }
+    readValueAsync(context, callback) {
+        if (!context) {
+            context = session_context_1.SessionContext.defaultContext;
+        }
+        (0, node_opcua_assert_1.assert)(callback instanceof Function);
+        this.__waiting_callbacks = this.__waiting_callbacks || [];
+        this.__waiting_callbacks.push(callback);
+        const _readValueAsync_in_progress = this.__waiting_callbacks.length >= 2;
+        if (_readValueAsync_in_progress) {
+            return;
+        }
+        const readImmediate = (innerCallback) => {
+            (0, node_opcua_assert_1.assert)(this._dataValue instanceof node_opcua_data_value_1.DataValue);
+            const dataValue = this.readValue();
+            innerCallback(null, dataValue);
+        };
+        let func;
+        if (!this.isReadable(context)) {
+            func = (innerCallback) => {
+                const dataValue = new node_opcua_data_value_1.DataValue({ statusCode: node_opcua_status_code_1.StatusCodes.BadNotReadable });
+                innerCallback(null, dataValue);
+            };
+        }
+        else if (!this.isUserReadable(context)) {
+            func = (innerCallback) => {
+                const dataValue = new node_opcua_data_value_1.DataValue({ statusCode: node_opcua_status_code_1.StatusCodes.BadUserAccessDenied });
+                innerCallback(null, dataValue);
+            };
+        }
+        else {
+            func = typeof this.refreshFunc === "function" ? this.asyncRefresh.bind(this, new Date()) : readImmediate;
+        }
+        const satisfy_callbacks = (err, dataValue) => {
+            // now call all pending callbacks
+            const callbacks = this.__waiting_callbacks || [];
+            this.__waiting_callbacks = [];
+            const n = callbacks.length;
+            for (const callback1 of callbacks) {
+                callback1.call(this, err, dataValue);
+            }
+        };
+        try {
+            func.call(this, satisfy_callbacks);
+        }
+        catch (err) {
+            // istanbul ignore next
+            if (doDebug) {
+                debugLog(chalk.red("func readValueAsync has failed "));
+                if (err instanceof Error) {
+                    debugLog(" stack", err.stack);
+                }
+            }
+            satisfy_callbacks(err);
+        }
+    }
+    getWriteMask() {
+        return super.getWriteMask();
+    }
+    getUserWriteMask() {
+        return super.getUserWriteMask();
+    }
+    clone(options, optionalFilter, extraInfo) {
+        options = Object.assign(Object.assign({}, options), { 
+            // check this eventNotifier: this.eventNotifier,
+            // check this symbolicName: this.symbolicName,
+            accessLevel: this.accessLevel, arrayDimensions: this.arrayDimensions, dataType: this.dataType, historizing: this.historizing, minimumSamplingInterval: this.minimumSamplingInterval, userAccessLevel: this.userAccessLevel, valueRank: this.valueRank });
+        const newVariable = base_node_private_1._clone.call(this, UAVariableImpl, options, optionalFilter, extraInfo);
+        newVariable.bindVariable();
+        (0, node_opcua_assert_1.assert)(typeof newVariable._timestamped_set_func === "function");
+        (0, node_opcua_assert_1.assert)(newVariable.dataType === this.dataType);
+        newVariable._dataValue = this._dataValue.clone();
+        return newVariable;
+    }
+    getDataTypeNode() {
+        const addressSpace = this.addressSpace;
+        const dt = addressSpace.findNode(this.dataType);
+        // istanbul ignore next
+        if (!dt) {
+            throw new Error("cannot find dataType " + this.dataType.toString());
+        }
+        return dt;
+    }
+    get dataTypeObj() {
+        return this.getDataTypeNode();
+    }
+    checkExtensionObjectIsCorrect(extObj) {
+        if (!extObj) {
+            return true;
+        }
+        const addressSpace = this.addressSpace;
+        if (!(extObj && extObj.constructor)) {
+            console.log(extObj);
+            throw new Error("expecting an valid extension object");
+        }
+        const dataType = addressSpace.findDataType(this.dataType);
+        if (!dataType) {
+            // may be we are in the process of loading a xml file and the corresponding dataType
+            // has not yet been loaded !
+            return true;
+        }
+        try {
+            const Constructor = addressSpace.getExtensionObjectConstructor(this.dataType);
+            if (extObj instanceof Array) {
+                for (const e of extObj) {
+                    if (!e) {
+                        continue;
+                    }
+                    if (e.constructor.name !== Constructor.name) {
+                        debugLog("extObj.constructor.name ", e.constructor.name, "expected", Constructor.name);
+                        return false;
+                    }
+                }
+                return true;
+            }
+            else {
+                return extObj.constructor.name === Constructor.name;
+            }
+        }
+        catch (err) {
+            console.log(err);
+            return false;
+        }
+    }
+    /**
+     * @method bindExtensionObject
+     * @return {ExtensionObject}
+     */
+    bindExtensionObject(optionalExtensionObject) {
+        var _a, _b, _c;
+        const addressSpace = this.addressSpace;
+        const structure = addressSpace.findDataType("Structure");
+        let extensionObject_;
+        if (!structure) {
+            // the addressSpace is limited and doesn't provide extension object
+            // bindExtensionObject cannot be performed and shall finish here.
+            return null;
+        }
+        // istanbul ignore next
+        if (doDebug) {
+            console.log(" ------------------------------ binding ", this.browseName.toString(), this.nodeId.toString());
+        }
+        (0, node_opcua_assert_1.assert)(structure && structure.browseName.toString() === "Structure", "expecting DataType Structure to be in IAddressSpace");
+        const dt = this.getDataTypeNode();
+        if (!dt.isSupertypeOf(structure)) {
+            return null;
+        }
+        // the namespace for the structure browse name elements
+        const structureNamespace = dt.nodeId.namespace;
+        // -------------------- make sure we do not bind a variable twice ....
+        if (this.$extensionObject) {
+            // istanbul ignore next
+            // if (!force && !utils.isNullOrUndefined(optionalExtensionObject)) {
+            //     throw new Error(
+            //         "bindExtensionObject: unsupported case : $extensionObject already exists on " +
+            //             this.browseName.toString() +
+            //             " " +
+            //             this.nodeId.toString()
+            //     );
+            // }
+            // istanbul ignore next
+            if (!this.checkExtensionObjectIsCorrect(this.$extensionObject)) {
+                console.log("on node : ", this.browseName.toString(), this.nodeId.toString(), "dataType=", this.dataType.toString({ addressSpace: this.addressSpace }));
+                console.log((_a = this.$extensionObject) === null || _a === void 0 ? void 0 : _a.toString());
+                throw new Error("bindExtensionObject: $extensionObject is incorrect: we are expecting a " +
+                    this.dataType.toString({ addressSpace: this.addressSpace }) +
+                    " but we got a " +
+                    ((_b = this.$extensionObject) === null || _b === void 0 ? void 0 : _b.constructor.name));
+            }
+            return this.$extensionObject;
+            // throw new Error("Variable already bound");
+        }
+        this.$extensionObject = optionalExtensionObject;
+        // ------------------------------------------------------------------
+        function prepareVariantValue(dataType, value) {
+            if (typeof dataType === "string") {
+                dataType = node_opcua_variant_1.DataType[dataType];
+            }
+            if ((dataType === node_opcua_variant_1.DataType.Int32 || dataType === node_opcua_variant_1.DataType.UInt32) && value && value.key) {
+                value = value.value;
+            }
+            return value;
+        }
+        const bindProperty = (propertyNode, name, extensionObject, dataTypeNodeId) => {
+            const dataTypeAsString = node_opcua_variant_1.DataType[dataTypeNodeId];
+            /*
+            property.setValueFromSource(new Variant({
+                dataType: dataType,
+                value: prepareVariantValue(dataType, this.$extensionObject[name])
+            }));
+             */
+            (0, node_opcua_assert_1.assert)(propertyNode.readValue().statusCode.equals(node_opcua_status_code_1.StatusCodes.Good));
+            // eslint-disable-next-line @typescript-eslint/no-this-alias
+            const self = this;
+            propertyNode.bindVariable({
+                timestamped_get: () => {
+                    const prop = self.$extensionObject[name];
+                    if (prop === undefined) {
+                        propertyNode._dataValue.value.dataType = node_opcua_variant_1.DataType.Null;
+                        propertyNode._dataValue.statusCode = node_opcua_status_code_1.StatusCodes.Good;
+                        propertyNode._dataValue.value.value = null;
+                        return new node_opcua_data_value_1.DataValue(propertyNode._dataValue);
+                    }
+                    const value = prepareVariantValue(dataTypeNodeId, prop);
+                    propertyNode._dataValue.statusCode = node_opcua_status_code_1.StatusCodes.Good;
+                    propertyNode._dataValue.value.value = value;
+                    return new node_opcua_data_value_1.DataValue(propertyNode._dataValue);
+                },
+                timestamped_set: (dataValue, callback) => {
+                    dataValue;
+                    callback(null, node_opcua_status_code_1.StatusCodes.BadNotWritable);
+                }
+            }, true);
+        };
+        const components = this.getComponents();
+        // ------------------------------------------------------
+        // make sure we have a structure
+        // ------------------------------------------------------
+        const s = this.readValue();
+        // istanbul ignore next
+        if (this.dataTypeObj.isAbstract) {
+            console.log("Warning the DataType associated with this Variable is abstract ", this.dataTypeObj.browseName.toString());
+            console.log("You need to provide a extension object yourself ");
+            throw new Error("bindExtensionObject requires a extensionObject as associated dataType is only abstract");
+        }
+        if (s.value && (s.value.dataType === node_opcua_variant_1.DataType.Null || (s.value.dataType === node_opcua_variant_1.DataType.ExtensionObject && !s.value.value))) {
+            // create a structure and bind it
+            extensionObject_ = this.$extensionObject || addressSpace.constructExtensionObject(this.dataType, {});
+            extensionObject_ = new Proxy(extensionObject_, makeHandler(this));
+            this.$extensionObject = extensionObject_;
+            const theValue = new node_opcua_variant_1.Variant({
+                dataType: node_opcua_variant_1.DataType.ExtensionObject,
+                value: this.$extensionObject
+            });
+            this.setValueFromSource(theValue, node_opcua_status_code_1.StatusCodes.Good);
+            // eslint-disable-next-line @typescript-eslint/no-this-alias
+            const self = this;
+            this.bindVariable({
+                timestamped_get() {
+                    self._dataValue.value.value = self.$extensionObject;
+                    const d = new node_opcua_data_value_1.DataValue(self._dataValue);
+                    d.value = new node_opcua_variant_1.Variant(d.value);
+                    return d;
+                },
+                timestamped_set(dataValue, callback) {
+                    const ext = dataValue.value.value;
+                    if (!self.checkExtensionObjectIsCorrect(ext)) {
+                        return callback(null, node_opcua_status_code_1.StatusCodes.BadInvalidArgument);
+                    }
+                    self.$extensionObject = new Proxy(ext, makeHandler(self));
+                    self.touchValue();
+                    callback(null, node_opcua_status_code_1.StatusCodes.Good);
+                }
+            }, true);
+        }
+        else {
+            // verify that variant has the correct type
+            (0, node_opcua_assert_1.assert)(s.value.dataType === node_opcua_variant_1.DataType.ExtensionObject);
+            this.$extensionObject = s.value.value;
+            (0, node_opcua_assert_1.assert)(this.checkExtensionObjectIsCorrect(this.$extensionObject));
+            (0, node_opcua_assert_1.assert)(s.statusCode.equals(node_opcua_status_code_1.StatusCodes.Good));
+        }
+        let property;
+        let camelCaseName;
+        // ------------------------------------------------------
+        // now bind each member
+        // ------------------------------------------------------
+        const definition = dt._getDefinition(false);
+        // istanbul ignore next
+        if (!definition) {
+            throw new Error("xx definition missing in " + dt.toString());
+        }
+        for (const field of definition.fields || []) {
+            camelCaseName = (0, node_opcua_utils_1.lowerFirstLetter)(field.name);
+            const component = components.filter((f) => f.browseName.name.toString() === field.name);
+            if (component.length === 1) {
+                property = component[0];
+                /* istanbul ignore next */
+            }
+            else {
+                // todo: Handle array appropriately...
+                (0, node_opcua_assert_1.assert)(component.length === 0);
+                // create a variable (Note we may use ns=1;s=parentName/0:PropertyName)
+                property = this.namespace.addVariable({
+                    browseName: { namespaceIndex: structureNamespace, name: field.name.toString() },
+                    componentOf: this,
+                    dataType: field.dataType,
+                    minimumSamplingInterval: this.minimumSamplingInterval
+                });
+                (0, node_opcua_assert_1.assert)(property.minimumSamplingInterval === this.minimumSamplingInterval);
+            }
+            property._dataValue.statusCode = node_opcua_status_code_1.StatusCodes.Good;
+            property.touchValue();
+            if (node_opcua_nodeid_1.NodeId.sameNodeId(node_opcua_nodeid_1.NodeId.nullNodeId, field.dataType)) {
+                debugLog("field.dataType is null ! " + field.name + " " + ((_c = field.description) === null || _c === void 0 ? void 0 : _c.text));
+                debugLog(" dataType replaced with BaseDataType ");
+                field.dataType = this.resolveNodeId("BaseDataType");
+            }
+            const dataTypeNodeId = addressSpace.findCorrespondingBasicDataType(field.dataType);
+            (0, node_opcua_assert_1.assert)(Object.prototype.hasOwnProperty.call(this.$extensionObject, camelCaseName));
+            // istanbul ignore next
+            if (doDebug) {
+                const x = addressSpace.findNode(field.dataType).browseName.toString();
+                const basicType = addressSpace.findCorrespondingBasicDataType(field.dataType);
+                debugLog(chalk.cyan("xxx"), " dataType", w(field.dataType.toString(), 8), w(field.name, 35), "valueRank", chalk.cyan(w((0, base_node_private_1.valueRankToString)(field.valueRank), 10)), chalk.green(w(x, 25)), "basicType = ", chalk.yellow(w(basicType.toString(), 20)), property.nodeId.toString(), property.readValue().statusCode.toString());
+            }
+            if (this.$extensionObject[camelCaseName] !== undefined && dataTypeNodeId === node_opcua_variant_1.DataType.ExtensionObject) {
+                (0, node_opcua_assert_1.assert)(this.$extensionObject[camelCaseName] instanceof Object);
+                this.$extensionObject[camelCaseName] = new Proxy(this.$extensionObject[camelCaseName], makeHandler(property));
+                property._dataValue.value = new node_opcua_variant_1.Variant({
+                    dataType: node_opcua_variant_1.DataType.ExtensionObject,
+                    value: this.$extensionObject[camelCaseName]
+                });
+                property.bindExtensionObject();
+                property.$extensionObject = this.$extensionObject[camelCaseName];
+            }
+            else {
+                const dataTypeAsString = node_opcua_variant_1.DataType[dataTypeNodeId];
+                (0, node_opcua_assert_1.assert)(typeof dataTypeAsString === "string");
+                const prop = this.$extensionObject[camelCaseName];
+                if (prop === undefined) {
+                    property._dataValue.value = new node_opcua_variant_1.Variant({
+                        dataType: node_opcua_variant_1.DataType.Null
+                    });
+                }
+                else {
+                    const preparedValue = prepareVariantValue(dataTypeNodeId, prop);
+                    property._dataValue.value = new node_opcua_variant_1.Variant({
+                        dataType: dataTypeAsString,
+                        value: preparedValue
+                    });
+                }
+                // eslint-disable-next-line @typescript-eslint/no-this-alias
+                const self = this;
+                property.camelCaseName = camelCaseName;
+                property.setValueFromSource = function (variant) {
+                    // eslint-disable-next-line @typescript-eslint/no-this-alias
+                    const inner_this = this;
+                    variant = node_opcua_variant_1.Variant.coerce(variant);
+                    // xx console.log("PropertySetValueFromSource this", inner_this.nodeId.toString(), inner_this.browseName.toString(), variant.toString(), inner_this.dataType.toString());
+                    // xx assert(variant.dataType === this.dataType);
+                    self.$extensionObject[inner_this.camelCaseName] = variant.value;
+                    self.touchValue();
+                };
+            }
+            (0, node_opcua_assert_1.assert)(property.readValue().statusCode.equals(node_opcua_status_code_1.StatusCodes.Good));
+            bindProperty(property, camelCaseName, this.$extensionObject, dataTypeNodeId);
+        }
+        (0, node_opcua_assert_1.assert)(this.$extensionObject instanceof Object);
+        return this.$extensionObject;
+    }
+    updateExtensionObjectPartial(partialExtensionObject) {
+        setExtensionObjectValue(this, partialExtensionObject);
+        return this.$extensionObject;
+    }
+    incrementExtensionObjectPartial(path) {
+        let name;
+        if (typeof path === "string") {
+            path = path.split(".");
+        }
+        (0, node_opcua_assert_1.assert)(path instanceof Array);
+        const extensionObject = this.constructExtensionObjectFromComponents();
+        let i;
+        // read partial value
+        const partialData = {};
+        let p = partialData;
+        for (i = 0; i < path.length - 1; i++) {
+            name = path[i];
+            p[name] = {};
+            p = p[name];
+        }
+        name = path[path.length - 1];
+        p[name] = 0;
+        let c1 = partialData;
+        let c2 = extensionObject;
+        for (i = 0; i < path.length - 1; i++) {
+            name = path[i];
+            c1 = partialData[name];
+            c2 = extensionObject[name];
+        }
+        name = path[path.length - 1];
+        c1[name] = c2[name];
+        c1[name] += 1;
+        // xx console.log(partialData);
+        setExtensionObjectValue(this, partialData);
+    }
+    constructExtensionObjectFromComponents() {
+        return this.readValue().value.value;
+    }
+    toString() {
+        const options = new base_node_private_1.ToStringBuilder();
+        base_node_private_1.UAVariable_toString.call(this, options);
+        return options.toString();
+    }
+    historyRead(context, historyReadDetails, indexRange, dataEncoding, continuationPoint, callback) {
+        if (!callback) {
+            callback = continuationPoint;
+            continuationPoint = undefined;
+        }
+        (0, node_opcua_assert_1.assert)(context instanceof session_context_1.SessionContext);
+        (0, node_opcua_assert_1.assert)(callback instanceof Function);
+        if (typeof this._historyRead !== "function") {
+            return callback(null, new node_opcua_types_1.HistoryReadResult({ statusCode: node_opcua_status_code_1.StatusCodes.BadNotReadable }));
+        }
+        this._historyRead(context, historyReadDetails, indexRange, dataEncoding, continuationPoint || null, callback);
+    }
+    _historyReadRaw(context, historyReadRawModifiedDetails, indexRange, dataEncoding, continuationPoint, callback) {
+        throw new Error("");
+    }
+    _historyReadRawModify(context, historyReadRawModifiedDetails, indexRange, dataEncoding, continuationPoint, callback) {
+        throw new Error("");
+    }
+    _historyRead(context, historyReadDetails, indexRange, dataEncoding, continuationPoint, callback) {
+        const result = new node_opcua_types_1.HistoryReadResult({
+            statusCode: node_opcua_status_code_1.StatusCodes.BadHistoryOperationUnsupported
+        });
+        callback(null, result);
+    }
+    _historyPush(newDataValue) {
+        throw new Error("");
+    }
+    _historyReadRawAsync(historyReadRawModifiedDetails, maxNumberToExtract, isReversed, reverseDataValue, callback) {
+        throw new Error("");
+    }
+    _historyReadModify(context, historyReadRawModifiedDetails, indexRange, dataEncoding, continuationPoint, callback) {
+        throw new Error("");
+    }
+    _update_startOfOnlineArchive(newDate) {
+        // please install
+        throw new Error("");
+    }
+    _update_startOfArchive(newDate) {
+        throw new Error("");
+    }
+    _validate_DataType(variantDataType) {
+        return validateDataType(this.addressSpace, this.dataType, variantDataType, this.nodeId, /* allow Nulls */ false);
+    }
+    _internal_set_dataValue(dataValue, indexRange) {
+        (0, node_opcua_assert_1.assert)(dataValue, "expecting a dataValue");
+        (0, node_opcua_assert_1.assert)(dataValue instanceof node_opcua_data_value_1.DataValue, "expecting dataValue to be a DataValue");
+        (0, node_opcua_assert_1.assert)(dataValue !== this._dataValue, "expecting dataValue to be different from previous DataValue instance");
+        if (dataValue.value.arrayType === node_opcua_variant_1.VariantArrayType.Matrix) {
+            if (!dataValue.value.dimensions) {
+                throw new Error("missing dimensions: a Matrix Variant needs a dimension");
+            }
+            const nbElements = dataValue.value.dimensions.reduce((acc, x) => acc * x, 1);
+            if (dataValue.value.value.length !== 0 && dataValue.value.value.length !== nbElements) {
+                throw new Error(`Internal Error: matrix dimension doesn't match the number of element in the array : ${dataValue.toString()} "\n expecting ${nbElements} elements but got ${dataValue.value.value.length}`);
+            }
+        }
+        if (dataValue.value.dataType === node_opcua_variant_1.DataType.ExtensionObject) {
+            if (!this.checkExtensionObjectIsCorrect(dataValue.value.value)) {
+                warningLog(dataValue.toString());
+                throw new Error("Invalid Extension Object on nodeId =" + this.nodeId.toString());
+            }
+        }
+        // istanbul ignore next
+        if (this.dataType.namespace === 0) {
+            if (this.dataType.value === node_opcua_variant_1.DataType.LocalizedText && dataValue.value.dataType !== node_opcua_variant_1.DataType.LocalizedText) {
+                throw new Error("Invalid dataValue provided (expecting a LocalizedText) but got " + dataValue.toString());
+            }
+        }
+        const old_dataValue = this._dataValue;
+        this._dataValue = dataValue;
+        this._dataValue.statusCode = this._dataValue.statusCode || node_opcua_status_code_1.StatusCodes.Good;
+        // repair missing timestamps
+        if (!dataValue.serverTimestamp) {
+            this._dataValue.serverTimestamp = old_dataValue.serverTimestamp;
+            this._dataValue.serverPicoseconds = old_dataValue.serverPicoseconds;
+        }
+        if (!dataValue.sourceTimestamp) {
+            this._dataValue.sourceTimestamp = old_dataValue.sourceTimestamp;
+            this._dataValue.sourcePicoseconds = old_dataValue.sourcePicoseconds;
+        }
+        if (!(0, node_opcua_data_value_1.sameDataValue)(old_dataValue, dataValue)) {
+            this.emit("value_changed", this._dataValue, indexRange);
+        }
+    }
+    _conditionRefresh(_cache) {
+        apply_condition_refresh_1.apply_condition_refresh.call(this, _cache);
+    }
+    handle_semantic_changed() {
+        this.semantic_version = this.semantic_version + 1;
+        this.emit("semantic_changed");
+    }
+    _readDataType() {
+        (0, node_opcua_assert_1.assert)(this.dataType instanceof node_opcua_nodeid_1.NodeId);
+        const options = {
+            statusCode: node_opcua_status_code_1.StatusCodes.Good,
+            value: {
+                dataType: node_opcua_variant_1.DataType.NodeId,
+                value: this.dataType
+            }
+        };
+        return new node_opcua_data_value_1.DataValue(options);
+    }
+    _readValueRank() {
+        (0, node_opcua_assert_1.assert)(typeof this.valueRank === "number");
+        const options = {
+            statusCode: node_opcua_status_code_1.StatusCodes.Good,
+            value: { dataType: node_opcua_variant_1.DataType.Int32, value: this.valueRank }
+        };
+        return new node_opcua_data_value_1.DataValue(options);
+    }
+    _readArrayDimensions() {
+        (0, node_opcua_assert_1.assert)(Array.isArray(this.arrayDimensions) || this.arrayDimensions === null);
+        (0, node_opcua_assert_1.assert)(!this.arrayDimensions || this.valueRank > 0, "arrayDimension must be null if valueRank <0");
+        const options = {
+            statusCode: node_opcua_status_code_1.StatusCodes.Good,
+            value: { dataType: node_opcua_variant_1.DataType.UInt32, arrayType: node_opcua_variant_1.VariantArrayType.Array, value: this.arrayDimensions }
+        };
+        return new node_opcua_data_value_1.DataValue(options);
+    }
+    _readAccessLevel(context) {
+        (0, node_opcua_assert_1.assert)(context instanceof session_context_1.SessionContext);
+        const options = {
+            statusCode: node_opcua_status_code_1.StatusCodes.Good,
+            value: { dataType: node_opcua_variant_1.DataType.Byte, value: (0, node_opcua_data_model_1.convertAccessLevelFlagToByte)(this.accessLevel) }
+        };
+        return new node_opcua_data_value_1.DataValue(options);
+    }
+    _readAccessLevelEx(context) {
+        (0, node_opcua_assert_1.assert)(context instanceof session_context_1.SessionContext);
+        const options = {
+            statusCode: node_opcua_status_code_1.StatusCodes.Good,
+            // Extra flags are not supported yet. to do:
+            value: { dataType: node_opcua_variant_1.DataType.UInt32, value: (0, node_opcua_data_model_1.convertAccessLevelFlagToByte)(this.accessLevel) }
+        };
+        return new node_opcua_data_value_1.DataValue(options);
+    }
+    _readUserAccessLevel(context) {
+        (0, node_opcua_assert_1.assert)(context instanceof session_context_1.SessionContext);
+        const effectiveUserAccessLevel = _calculateEffectiveUserAccessLevelFromPermission(this, context, this.userAccessLevel);
+        const options = {
+            value: {
+                dataType: node_opcua_variant_1.DataType.Byte,
+                statusCode: node_opcua_status_code_1.StatusCodes.Good,
+                value: (0, node_opcua_data_model_1.convertAccessLevelFlagToByte)(effectiveUserAccessLevel)
+            }
+        };
+        return new node_opcua_data_value_1.DataValue(options);
+    }
+    _readMinimumSamplingInterval() {
+        // expect a Duration => Double
+        const options = {};
+        if (this.minimumSamplingInterval === undefined) {
+            options.statusCode = node_opcua_status_code_1.StatusCodes.BadAttributeIdInvalid;
+        }
+        else {
+            options.value = { dataType: node_opcua_variant_1.DataType.Double, value: this.minimumSamplingInterval };
+            options.statusCode = node_opcua_status_code_1.StatusCodes.Good;
+        }
+        return new node_opcua_data_value_1.DataValue(options);
+    }
+    _readHistorizing() {
+        (0, node_opcua_assert_1.assert)(typeof this.historizing === "boolean");
+        const options = {
+            statusCode: node_opcua_status_code_1.StatusCodes.Good,
+            value: { dataType: node_opcua_variant_1.DataType.Boolean, value: !!this.historizing }
+        };
+        return new node_opcua_data_value_1.DataValue(options);
+    }
+}
+exports.UAVariableImpl = UAVariableImpl;
+// tslint:disable:no-var-requires
+const thenify = require("thenify");
+UAVariableImpl.prototype.asyncRefresh = thenify.withCallback(UAVariableImpl.prototype.asyncRefresh);
+UAVariableImpl.prototype.writeValue = thenify.withCallback(UAVariableImpl.prototype.writeValue);
+UAVariableImpl.prototype.writeAttribute = thenify.withCallback(UAVariableImpl.prototype.writeAttribute);
+UAVariableImpl.prototype.historyRead = thenify.withCallback(UAVariableImpl.prototype.historyRead);
+UAVariableImpl.prototype.readValueAsync = thenify.withCallback(UAVariableImpl.prototype.readValueAsync);
+function check_valid_array(dataType, array) {
+    if (Array.isArray(array)) {
+        return true;
+    }
+    switch (dataType) {
+        case node_opcua_variant_1.DataType.Double:
+            return array instanceof Float64Array;
+        case node_opcua_variant_1.DataType.Float:
+            return array instanceof Float32Array;
+        case node_opcua_variant_1.DataType.Int32:
+            return array instanceof Int32Array;
+        case node_opcua_variant_1.DataType.Int16:
+            return array instanceof Int16Array;
+        case node_opcua_variant_1.DataType.SByte:
+            return array instanceof Int8Array;
+        case node_opcua_variant_1.DataType.UInt32:
+            return array instanceof Uint32Array;
+        case node_opcua_variant_1.DataType.UInt16:
+            return array instanceof Uint16Array;
+        case node_opcua_variant_1.DataType.Byte:
+            return array instanceof Uint8Array || array instanceof Buffer;
+    }
+    return false;
+}
+function _apply_default_timestamps(dataValue) {
+    const now = (0, node_opcua_date_time_1.getCurrentClock)();
+    (0, node_opcua_assert_1.assert)(dataValue instanceof node_opcua_data_value_1.DataValue);
+    if (!dataValue.sourceTimestamp) {
+        dataValue.sourceTimestamp = now.timestamp;
+        dataValue.sourcePicoseconds = now.picoseconds;
+    }
+    if (!dataValue.serverTimestamp) {
+        dataValue.serverTimestamp = now.timestamp;
+        dataValue.serverPicoseconds = now.picoseconds;
+    }
+}
+function unsetFlag(flags, mask) {
+    return flags & ~mask;
+}
+function setFlag(flags, mask) {
+    return flags | mask;
+}
+function _calculateEffectiveUserAccessLevelFromPermission(node, context, userAccessLevel) {
+    function __adjustFlag(permissionType, access, userAccessLevel1) {
+        if ((node.accessLevel & access) === 0 || (userAccessLevel1 & access) === 0) {
+            userAccessLevel1 = unsetFlag(userAccessLevel1, access);
+        }
+        else {
+            if (!context.checkPermission(node, permissionType)) {
+                userAccessLevel1 = unsetFlag(userAccessLevel1, access);
+            }
+        }
+        return userAccessLevel1;
+    }
+    userAccessLevel = node.userAccessLevel === undefined ? node.accessLevel : node.userAccessLevel & node.accessLevel;
+    if (context.checkPermission) {
+        (0, node_opcua_assert_1.assert)(context.checkPermission instanceof Function);
+        userAccessLevel = __adjustFlag(node_opcua_types_1.PermissionType.Read, node_opcua_data_model_1.AccessLevelFlag.CurrentRead, userAccessLevel);
+        userAccessLevel = __adjustFlag(node_opcua_types_1.PermissionType.Write, node_opcua_data_model_1.AccessLevelFlag.CurrentWrite, userAccessLevel);
+        userAccessLevel = __adjustFlag(node_opcua_types_1.PermissionType.Write, node_opcua_data_model_1.AccessLevelFlag.StatusWrite, userAccessLevel);
+        userAccessLevel = __adjustFlag(node_opcua_types_1.PermissionType.Write, node_opcua_data_model_1.AccessLevelFlag.TimestampWrite, userAccessLevel);
+        userAccessLevel = __adjustFlag(node_opcua_types_1.PermissionType.ReadHistory, node_opcua_data_model_1.AccessLevelFlag.HistoryRead, userAccessLevel);
+        userAccessLevel = __adjustFlag(node_opcua_types_1.PermissionType.DeleteHistory, node_opcua_data_model_1.AccessLevelFlag.HistoryWrite, userAccessLevel);
+        return userAccessLevel;
+    }
+    else {
+        return userAccessLevel;
+    }
+}
+function adjustVariant2(variant) {
+    // convert Variant( Scalar|ByteString) =>  Variant(Array|ByteArray)
+    const addressSpace = this.addressSpace;
+    const basicType = addressSpace.findCorrespondingBasicDataType(this.dataType);
+    variant = (0, node_opcua_variant_1.adjustVariant)(variant, this.valueRank, basicType);
+    return variant;
+}
+function _not_writable_timestamped_set_func(dataValue, callback) {
+    (0, node_opcua_assert_1.assert)(dataValue instanceof node_opcua_data_value_1.DataValue);
+    callback(null, node_opcua_status_code_1.StatusCodes.BadNotWritable, null);
+}
+function _default_writable_timestamped_set_func(dataValue, callback) {
+    /* jshint validthis: true */
+    (0, node_opcua_assert_1.assert)(dataValue instanceof node_opcua_data_value_1.DataValue);
+    callback(null, node_opcua_status_code_1.StatusCodes.Good, dataValue);
+}
+function turn_sync_to_async(f, numberOfArgs) {
+    if (f.length <= numberOfArgs) {
+        return function (data, callback) {
+            const r = f.call(this, data);
+            setImmediate(() => {
+                return callback(null, r);
+            });
+        };
+    }
+    else {
+        (0, node_opcua_assert_1.assert)(f.length === numberOfArgs + 1);
+        return f;
+    }
+}
+const _default_minimumSamplingInterval = 1000;
+function coerceDataValue(dataValue) {
+    if (dataValue instanceof node_opcua_data_value_1.DataValue) {
+        return dataValue;
+    }
+    return new node_opcua_data_value_1.DataValue(dataValue);
+}
+// variation #3 :
+function _Variable_bind_with_async_refresh(options) {
+    /* jshint validthis: true */
+    (0, node_opcua_assert_1.assert)(this instanceof UAVariableImpl);
+    (0, node_opcua_assert_1.assert)(typeof options.refreshFunc === "function");
+    (0, node_opcua_assert_1.assert)(!options.get, "a getter shall not be specified when refreshFunc is set");
+    (0, node_opcua_assert_1.assert)(!options.timestamped_get, "a getter shall not be specified when refreshFunc is set");
+    (0, node_opcua_assert_1.assert)(!this.refreshFunc);
+    this.refreshFunc = options.refreshFunc;
+    // assert(this.readValue().statusCode === StatusCodes.BadNodeIdUnknown);
+    this._dataValue.statusCode = node_opcua_status_code_1.StatusCodes.UncertainInitialValue;
+    // TO DO : REVISIT THIS ASSUMPTION
+    if (false && this.minimumSamplingInterval === 0) {
+        // when a getter /timestamped_getter or async_getter is provided
+        // samplingInterval cannot be 0, as the item value must be scanned to be updated.
+        this.minimumSamplingInterval = _default_minimumSamplingInterval; // MonitoredItem.minimumSamplingInterval;
+        debugLog("adapting minimumSamplingInterval on " + this.browseName.toString() + " to " + this.minimumSamplingInterval);
+    }
+}
+// variation 2
+function _Variable_bind_with_timestamped_get(options) {
+    /* jshint validthis: true */
+    (0, node_opcua_assert_1.assert)(this instanceof UAVariableImpl);
+    (0, node_opcua_assert_1.assert)(typeof options.timestamped_get === "function");
+    (0, node_opcua_assert_1.assert)(!options.get, "should not specify 'get' when 'timestamped_get' exists ");
+    (0, node_opcua_assert_1.assert)(!this._timestamped_get_func);
+    const async_refresh_func = (callback) => {
+        Promise.resolve(this._timestamped_get_func.call(this))
+            .then((dataValue) => callback(null, dataValue))
+            .catch((err) => callback(err));
+    };
+    if (options.timestamped_get.length === 0) {
+        const timestamped_get = options.timestamped_get;
+        // sync version | Promise version
+        this._timestamped_get_func = timestamped_get;
+        const dataValue_verify = timestamped_get.call(this);
+        // dataValue_verify should be a DataValue or a Promise
+        /* istanbul ignore next */
+        if (!(dataValue_verify instanceof node_opcua_data_value_1.DataValue) && typeof dataValue_verify.then !== "function") {
+            errorLog(chalk.red(" Bind variable error: "), " the timestamped_get function must return a DataValue or a Promise<DataValue>" +
+                "\n value_check.constructor.name ", dataValue_verify ? dataValue_verify.constructor.name : "null");
+            throw new Error(" Bind variable error: " + " the timestamped_get function must return a DataValue");
+        }
+        _Variable_bind_with_async_refresh.call(this, { refreshFunc: async_refresh_func });
+    }
+    else if (options.timestamped_get.length === 1) {
+        _Variable_bind_with_async_refresh.call(this, { refreshFunc: options.timestamped_get });
+    }
+    else {
+        errorLog("timestamped_get has a invalid number of argument , should be 0 or 1  ");
+        throw new Error("timestamped_get has a invalid number of argument , should be 0 or 1  ");
+    }
+}
+// variation 1
+function _Variable_bind_with_simple_get(options) {
+    /* jshint validthis: true */
+    (0, node_opcua_assert_1.assert)(this instanceof UAVariableImpl);
+    (0, node_opcua_assert_1.assert)(typeof options.get === "function", "should specify get function");
+    (0, node_opcua_assert_1.assert)(options.get.length === 0, "get function should not have arguments");
+    (0, node_opcua_assert_1.assert)(!options.timestamped_get, "should not specify a timestamped_get function when get is specified");
+    (0, node_opcua_assert_1.assert)(!this._timestamped_get_func);
+    (0, node_opcua_assert_1.assert)(!this._get_func);
+    this._get_func = options.get;
+    const timestamped_get_func_from__Variable_bind_with_simple_get = () => {
+        const value = this._get_func();
+        /* istanbul ignore next */
+        if (!is_Variant_or_StatusCode(value)) {
+            errorLog(chalk.red(" Bind variable error: "), " : the getter must return a Variant or a StatusCode" + "\nvalue_check.constructor.name ", value ? value.constructor.name : "null");
+            throw new Error(" bindVariable : the value getter function returns a invalid result ( expecting a Variant or a StatusCode !!!");
+        }
+        if (is_StatusCode(value)) {
+            return new node_opcua_data_value_1.DataValue({ statusCode: value });
+        }
+        else {
+            if (!this._dataValue || !isGoodish(this._dataValue.statusCode) || !(0, node_opcua_variant_1.sameVariant)(this._dataValue.value, value)) {
+                this.setValueFromSource(value, node_opcua_status_code_1.StatusCodes.Good);
+            }
+            else {
+                // XX console.log("YYYYYYYYYYYYYYYYYYYYYYYYYY",this.browseName.toString());
+            }
+            return this._dataValue;
+        }
+    };
+    _Variable_bind_with_timestamped_get.call(this, {
+        timestamped_get: timestamped_get_func_from__Variable_bind_with_simple_get
+    });
+}
+function _Variable_bind_with_simple_set(options) {
+    (0, node_opcua_assert_1.assert)(this instanceof UAVariableImpl);
+    (0, node_opcua_assert_1.assert)(typeof options.set === "function", "should specify set function");
+    (0, node_opcua_assert_1.assert)(!options.timestamped_set, "should not specify a timestamped_set function");
+    (0, node_opcua_assert_1.assert)(!this._timestamped_set_func);
+    (0, node_opcua_assert_1.assert)(!this._set_func);
+    this._set_func = turn_sync_to_async(options.set, 1);
+    (0, node_opcua_assert_1.assert)(this._set_func.length === 2, " set function must have 2 arguments ( variant, callback)");
+    this._timestamped_set_func = (timestamped_value, indexRange, callback) => {
+        (0, node_opcua_assert_1.assert)(timestamped_value instanceof node_opcua_data_value_1.DataValue);
+        this._set_func(timestamped_value.value, (err, statusCode) => {
+            if (!err && !statusCode) {
+                console.log(chalk.red("UAVariable Binding Error _set_func must return a StatusCode, check the bindVariable parameters"));
+                console.log(chalk.yellow("StatusCode.Good is assumed"));
+                return callback(err, node_opcua_status_code_1.StatusCodes.Good, timestamped_value);
+            }
+            callback(err, statusCode, timestamped_value);
+        });
+    };
+}
+function _Variable_bind_with_timestamped_set(options) {
+    (0, node_opcua_assert_1.assert)(this instanceof UAVariableImpl);
+    (0, node_opcua_assert_1.assert)(typeof options.timestamped_set === "function");
+    (0, node_opcua_assert_1.assert)(options.timestamped_set.length === 2, "timestamped_set must have 2 parameters  timestamped_set: function(dataValue,callback){}");
+    (0, node_opcua_assert_1.assert)(!options.set, "should not specify set when timestamped_set_func exists ");
+    this._timestamped_set_func = (dataValue, indexRange, callback) => {
+        // xx assert(!indexRange,"indexRange Not Implemented");
+        return options.timestamped_set.call(this, dataValue, callback);
+    };
+}
+function bind_setter(options) {
+    if (typeof options.set === "function") {
+        // variation 1
+        _Variable_bind_with_simple_set.call(this, options);
+    }
+    else if (typeof options.timestamped_set === "function") {
+        // variation 2
+        (0, node_opcua_assert_1.assert)(typeof options.timestamped_get === "function", "timestamped_set must be used with timestamped_get ");
+        _Variable_bind_with_timestamped_set.call(this, options);
+    }
+    else if (typeof options.timestamped_get === "function") {
+        // timestamped_get is  specified but timestamped_set is not
+        // => Value is read-only
+        _Variable_bind_with_timestamped_set.call(this, {
+            timestamped_set: _not_writable_timestamped_set_func
+        });
+    }
+    else {
+        _Variable_bind_with_timestamped_set.call(this, {
+            timestamped_set: _default_writable_timestamped_set_func
+        });
+    }
+}
+function bind_getter(options) {
+    if (typeof options.get === "function") {
+        // variation 1
+        _Variable_bind_with_simple_get.call(this, options);
+    }
+    else if (typeof options.timestamped_get === "function") {
+        // variation 2
+        _Variable_bind_with_timestamped_get.call(this, options);
+    }
+    else if (typeof options.refreshFunc === "function") {
+        // variation 3
+        _Variable_bind_with_async_refresh.call(this, options);
+    }
+    else {
+        (0, node_opcua_assert_1.assert)(!Object.prototype.hasOwnProperty.call(options, "set"), "getter is missing : a getter must be provided if a setter is provided");
+        // xx bind_variant.call(this,options);
+        if (options.dataType !== undefined) {
+            // if (options.dataType !== DataType.ExtensionObject) {
+            this.setValueFromSource(options);
+            // }
+        }
+    }
+}
+function w(str, n) {
+    return (str + "                                                              ").substr(0, n);
+}
+function _getter(target, key /*, receiver*/) {
+    if (target[key] === undefined) {
+        return undefined;
+    }
+    return target[key];
+}
+function _setter(variable, target, key, value /*, receiver*/) {
+    target[key] = value;
+    const child = variable[key];
+    if (child && child.touchValue) {
+        child.touchValue();
+    }
+    return true; // true means the set operation has succeeded
+}
+function makeHandler(variable) {
+    const handler = {
+        get: _getter,
+        set: _setter.bind(null, variable)
+    };
+    return handler;
+}
+function setExtensionObjectValue(node, partialObject) {
+    const extensionObject = node.$extensionObject;
+    if (!extensionObject) {
+        throw new Error("setExtensionObjectValue node has no extension object " + node.browseName.toString());
+    }
+    function _update_extension_object(extObject, partialObject1) {
+        const keys = Object.keys(partialObject1);
+        for (const prop of keys) {
+            if (extObject[prop] instanceof Object) {
+                _update_extension_object(extObject[prop], partialObject1[prop]);
+            }
+            else {
+                extObject[prop] = partialObject1[prop];
+            }
+        }
+    }
+    _update_extension_object(extensionObject, partialObject);
+}
+class UAVariableImplT extends UAVariableImpl {
+}
+exports.UAVariableImplT = UAVariableImplT;
+// x TO DO
+// require("./data_access/ua_variable_data_access");
+// require("./historical_access/ua_variable_history");
+//# sourceMappingURL=ua_variable_impl.js.map