node-opcua-address-space 2.98.0 → 2.98.2

package/dist/source/helpers/argument_list.js

@@ -0,0 +1,255 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.verifyArguments_ArgumentList = exports.isArgumentValid = exports.getMethodDeclaration_ArgumentList = exports.binaryStoreSize_ArgumentList = exports.decode_ArgumentList = exports.encode_ArgumentList = void 0;
+/* eslint-disable complexity */
+/**
+ * @module node-opcua-address-space
+ */
+const node_opcua_assert_1 = require("node-opcua-assert");
+const ec = require("node-opcua-basic-types");
+const node_opcua_binary_stream_1 = require("node-opcua-binary-stream");
+const node_opcua_debug_1 = require("node-opcua-debug");
+const factories = require("node-opcua-factory");
+const node_opcua_nodeid_1 = require("node-opcua-nodeid");
+const node_opcua_status_code_1 = require("node-opcua-status-code");
+const node_opcua_variant_1 = require("node-opcua-variant");
+const node_opcua_variant_2 = require("node-opcua-variant");
+const node_opcua_constants_1 = require("node-opcua-constants");
+const node_opcua_data_model_1 = require("node-opcua-data-model");
+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);
+function myfindBuiltInType(dataType) {
+    return factories.findBuiltInType(node_opcua_variant_1.DataType[dataType]);
+}
+function encode_ArgumentList(definition, args, stream) {
+    (0, node_opcua_assert_1.assert)(definition.length === args.length);
+    (0, node_opcua_assert_1.assert)(Array.isArray(definition));
+    (0, node_opcua_assert_1.assert)(Array.isArray(args));
+    (0, node_opcua_assert_1.assert)(definition.length === args.length);
+    (0, node_opcua_assert_1.assert)(definition.length >= 0);
+    // we only encode arguments by following the definition
+    for (let i = 0; i < definition.length; i++) {
+        const def = definition[i];
+        const value = args[i];
+        const encodeFunc = myfindBuiltInType(def.dataType).encode;
+        // assert((def.valueRank === -1) || (def.valueRank === 0));
+        // todo : handle -3 -2
+        const isArray = def.valueRank && (def.valueRank === 1 || def.valueRank !== -1);
+        if (isArray) {
+            ec.encodeArray(value, stream, encodeFunc);
+        }
+        else {
+            encodeFunc(value, stream);
+        }
+    }
+}
+exports.encode_ArgumentList = encode_ArgumentList;
+function decode_ArgumentList(definition, stream) {
+    // istanbul ignore next
+    if (!Array.isArray(definition)) {
+        throw new Error("This BaseDataType cannot be decoded because it has no definition.\n" +
+            "Please construct a BaseDataType({definition : [{dataType: DataType.UInt32 }]});");
+    }
+    const args = [];
+    let value;
+    for (const def of definition) {
+        const decodeFunc = myfindBuiltInType(def.dataType).decode;
+        // xx assert(def.valueRank === -1 || def.valueRank==0);
+        const isArray = def.valueRank === 1 || def.valueRank === -1;
+        if (isArray) {
+            value = ec.decodeArray(stream, decodeFunc);
+        }
+        else {
+            value = decodeFunc(stream);
+        }
+        args.push(value);
+    }
+    return args;
+}
+exports.decode_ArgumentList = decode_ArgumentList;
+function binaryStoreSize_ArgumentList(description, args) {
+    (0, node_opcua_assert_1.assert)(Array.isArray(description));
+    (0, node_opcua_assert_1.assert)(Array.isArray(args));
+    (0, node_opcua_assert_1.assert)(args.length === description.length);
+    const stream = new node_opcua_binary_stream_1.BinaryStreamSizeCalculator();
+    encode_ArgumentList(description, args, stream);
+    return stream.length;
+}
+exports.binaryStoreSize_ArgumentList = binaryStoreSize_ArgumentList;
+function getMethodDeclaration_ArgumentList(addressSpace, objectId, methodId) {
+    // find object in address space
+    const obj = addressSpace.findNode(objectId);
+    if (!obj) {
+        // istanbul ignore next
+        doDebug && debugLog("cannot find node ", objectId.toString());
+        return { statusCode: node_opcua_status_code_1.StatusCodes.BadNodeIdUnknown };
+    }
+    let objectMethod = obj.getMethodById(methodId);
+    if (!objectMethod) {
+        // the method doesn't belong to the object, nevertheless
+        // the method can be called
+        objectMethod = addressSpace.findNode(methodId);
+        if (!objectMethod || objectMethod.nodeClass !== node_opcua_data_model_1.NodeClass.Method) {
+            warningLog("cannot find method with id", methodId.toString(), "object Id = ", objectId.toString());
+            return { statusCode: node_opcua_status_code_1.StatusCodes.BadMethodInvalid };
+        }
+    }
+    const methodDeclarationId = objectMethod.methodDeclarationId;
+    const methodDeclaration = addressSpace.findNode(methodDeclarationId);
+    if (!methodDeclaration) {
+        //  return {statusCode: StatusCodes.BadMethodInvalid};
+        return { statusCode: node_opcua_status_code_1.StatusCodes.Good, methodDeclaration: objectMethod };
+    }
+    // istanbul ignore next
+    if (methodDeclaration.nodeClass !== node_opcua_data_model_1.NodeClass.Method) {
+        throw new Error("Expecting a Method here");
+    }
+    return { statusCode: node_opcua_status_code_1.StatusCodes.Good, methodDeclaration };
+}
+exports.getMethodDeclaration_ArgumentList = getMethodDeclaration_ArgumentList;
+function checkValueRank(argDefinition, arg) {
+    const isArray = arg.arrayType === node_opcua_variant_2.VariantArrayType.Array;
+    const isMatrix = arg.arrayType === node_opcua_variant_2.VariantArrayType.Matrix;
+    if (argDefinition.valueRank > 0) {
+        if (argDefinition.valueRank === 1) {
+            if (!isArray) {
+                return false;
+            }
+        }
+        else {
+            if (!isMatrix) {
+                return false;
+            }
+        }
+    }
+    else if (argDefinition.valueRank === -1) {
+        // SCALAR
+        if (isArray || isMatrix) {
+            return false;
+        }
+    }
+    else if (argDefinition.valueRank === -2) {
+        // ANY
+    }
+    else if (argDefinition.valueRank === -3) {
+        // Scalar or OneDim
+        if (isMatrix) {
+            return false;
+        }
+    }
+    else if (argDefinition.valueRank === 0) {
+        // array or matrix
+        if (!isArray && !isMatrix) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * @private
+ */
+function isArgumentValid(addressSpace, argDefinition, arg) {
+    (0, node_opcua_assert_1.assert)(Object.prototype.hasOwnProperty.call(argDefinition, "dataType"));
+    (0, node_opcua_assert_1.assert)(Object.prototype.hasOwnProperty.call(argDefinition, "valueRank"));
+    const argDefDataType = addressSpace.findDataType(argDefinition.dataType);
+    const argDataType = addressSpace.findDataType((0, node_opcua_nodeid_1.resolveNodeId)(arg.dataType));
+    // istanbul ignore next
+    if (!argDefDataType) {
+        debugLog("dataType ", argDefinition.dataType.toString(), "doesn't exist");
+        return false;
+    }
+    if (argDefinition.valueRank >= 0 && arg.dataType === node_opcua_variant_1.DataType.Null) {
+        // this is valid to receive an empty array ith DataType.Null;
+        return true;
+    }
+    if (!checkValueRank(argDefinition, arg)) {
+        return false;
+    }
+    // istanbul ignore next
+    if (!argDataType) {
+        doDebug && debugLog(" cannot find dataType ", arg.dataType, (0, node_opcua_nodeid_1.resolveNodeId)(arg.dataType));
+        doDebug && debugLog(" arg = ", arg.toString());
+        doDebug && debugLog(" def =", argDefinition.toString());
+        return false;
+    }
+    // istanbul ignore next
+    if (doDebug) {
+        doDebug && debugLog(" checking argDefDataType ", argDefDataType.toString());
+        doDebug && debugLog(" checking argDataType ", argDataType.toString());
+    }
+    if (argDataType.nodeId.value === argDefDataType.nodeId.value) {
+        return true;
+    }
+    // check that dataType is of the same type (derived )
+    if (argDefDataType.isSubtypeOf(argDataType)) {
+        // like argDefDataType IntegerId and argDataType Uint32
+        return true;
+    }
+    if (argDataType.isSubtypeOf(argDefDataType)) {
+        // like argDefDataType BaseDataType and argDataType any Type
+        return true;
+    }
+    // special case for Enumeration
+    if (arg.dataType === node_opcua_variant_1.DataType.Int32) {
+        const enumDataType = addressSpace.findDataType((0, node_opcua_nodeid_1.coerceNodeId)(node_opcua_constants_1.DataTypeIds.Enumeration));
+        if (argDefDataType.isSubtypeOf(enumDataType)) {
+            return true;
+        }
+    }
+    return false;
+}
+exports.isArgumentValid = isArgumentValid;
+/**
+ * @method verifyArguments_ArgumentList
+ * @param addressSpace
+ * @param methodInputArguments
+ * @param inputArguments
+ * @return statusCode,inputArgumentResults
+ */
+function verifyArguments_ArgumentList(addressSpace, methodInputArguments, inputArguments) {
+    const inputArgumentResults = methodInputArguments.map((methodInputArgument, index) => {
+        const argument = inputArguments[index];
+        if (!argument) {
+            return node_opcua_status_code_1.StatusCodes.BadNoData;
+        }
+        else if (!isArgumentValid(addressSpace, methodInputArgument, argument)) {
+            return node_opcua_status_code_1.StatusCodes.BadTypeMismatch;
+        }
+        else {
+            return node_opcua_status_code_1.StatusCodes.Good;
+        }
+    });
+    if (methodInputArguments.length > inputArguments.length) {
+        // istanbul ignore next
+        doDebug &&
+            debugLog("verifyArguments_ArgumentList " +
+                "\n       The client did  specify too many input arguments for the method.  " +
+                "\n        expected : " +
+                methodInputArguments.length +
+                "" +
+                "\n        actual   : " +
+                inputArguments.length);
+        return { inputArgumentResults, statusCode: node_opcua_status_code_1.StatusCodes.BadArgumentsMissing };
+    }
+    if (methodInputArguments.length < inputArguments.length) {
+        // istanbul ignore next
+        doDebug &&
+            debugLog(" verifyArguments_ArgumentList " +
+                "\n        The client did not specify all of the input arguments for the method. " +
+                "\n        expected : " +
+                methodInputArguments.length +
+                "" +
+                "\n        actual   : " +
+                inputArguments.length);
+        return { inputArgumentResults, statusCode: node_opcua_status_code_1.StatusCodes.BadTooManyArguments };
+    }
+    return {
+        inputArgumentResults,
+        statusCode: inputArgumentResults.includes(node_opcua_status_code_1.StatusCodes.BadTypeMismatch) || inputArgumentResults.includes(node_opcua_status_code_1.StatusCodes.BadOutOfRange)
+            ? node_opcua_status_code_1.StatusCodes.BadInvalidArgument
+            : node_opcua_status_code_1.StatusCodes.Good
+    };
+}
+exports.verifyArguments_ArgumentList = verifyArguments_ArgumentList;
+//# sourceMappingURL=argument_list.js.map

package/dist/source/helpers/argument_list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"argument_list.js","sourceRoot":"","sources":["../../../source/helpers/argument_list.ts"],"names":[],"mappings":";;;AAAA,+BAA+B;AAC/B;;GAEG;AACH,yDAA2C;AAC3C,6CAA6C;AAC7C,uEAAwG;AACxG,uDAAkF;AAClF,gDAAgD;AAChD,yDAAwE;AAExE,mEAAiE;AAEjE,2DAA8C;AAC9C,2DAAsD;AACtD,+DAAmD;AACnD,iEAAkD;AAGlD,MAAM,QAAQ,GAAG,IAAA,gCAAa,EAAC,UAAU,CAAC,CAAC;AAC3C,MAAM,UAAU,GAAG,IAAA,kCAAe,EAAC,UAAU,CAAC,CAAC;AAC/C,MAAM,OAAO,GAAG,IAAA,iCAAc,EAAC,UAAU,CAAC,CAAC;AAE3C,SAAS,iBAAiB,CAAC,QAAkB;IACzC,OAAO,SAAS,CAAC,eAAe,CAAC,6BAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC;AAKD,SAAgB,mBAAmB,CAAC,UAAyB,EAAE,IAAW,EAAE,MAA0B;IAClG,IAAA,0BAAM,EAAC,UAAU,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;IAE1C,IAAA,0BAAM,EAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAClC,IAAA,0BAAM,EAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5B,IAAA,0BAAM,EAAC,UAAU,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAA,0BAAM,EAAC,UAAU,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAE/B,uDAAuD;IAEvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QACxC,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEtB,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;QAC1D,2DAA2D;QAE3D,sBAAsB;QACtB,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,IAAI,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,IAAI,GAAG,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC;QAE/E,IAAI,OAAO,EAAE;YACT,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;SAC7C;aAAM;YACH,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;SAC7B;KACJ;AACL,CAAC;AA1BD,kDA0BC;AAED,SAAgB,mBAAmB,CAAC,UAAyB,EAAE,MAAoB;IAE/E,uBAAuB;IACvB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;QAC5B,MAAM,IAAI,KAAK,CACX,qEAAqE;YACrE,iFAAiF,CACpF,CAAC;KACL;IAED,MAAM,IAAI,GAAU,EAAE,CAAC;IACvB,IAAI,KAAK,CAAC;IAEV,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE;QAC1B,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;QAE1D,uDAAuD;QACvD,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,KAAK,CAAC,IAAI,GAAG,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC;QAE5D,IAAI,OAAO,EAAE;YACT,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;SAC9C;aAAM;YACH,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;SAC9B;QACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;KACpB;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AA3BD,kDA2BC;AAED,SAAgB,4BAA4B,CAAC,WAA0B,EAAE,IAAW;IAChF,IAAA,0BAAM,EAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IACnC,IAAA,0BAAM,EAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5B,IAAA,0BAAM,EAAC,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM,CAAC,CAAC;IAE3C,MAAM,MAAM,GAAG,IAAI,qDAA0B,EAAE,CAAC;IAChD,mBAAmB,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/C,OAAO,MAAM,CAAC,MAAM,CAAC;AACzB,CAAC;AARD,oEAQC;AAED,SAAgB,iCAAiC,CAC7C,YAA2B,EAC3B,QAAgB,EAChB,QAAgB;IAEhB,+BAA+B;IAC/B,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAa,CAAC;IACxD,IAAI,CAAC,GAAG,EAAE;QACN,uBAAuB;QACvB,OAAO,IAAI,QAAQ,CAAC,mBAAmB,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE9D,OAAO,EAAE,UAAU,EAAE,oCAAW,CAAC,gBAAgB,EAAE,CAAC;KACvD;IACD,IAAI,YAAY,GAAG,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAa,CAAC;IAC3D,IAAI,CAAC,YAAY,EAAE;QACf,wDAAwD;QACxD,2BAA2B;QAC3B,YAAY,GAAG,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAa,CAAC;QAC3D,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,SAAS,KAAK,iCAAS,CAAC,MAAM,EAAE;YAC9D,UAAU,CAAC,4BAA4B,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,cAAc,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;YACnG,OAAO,EAAE,UAAU,EAAE,oCAAW,CAAC,gBAAgB,EAAE,CAAC;SACvD;KACJ;IAED,MAAM,mBAAmB,GAAG,YAAY,CAAC,mBAAmB,CAAC;IAC7D,MAAM,iBAAiB,GAAG,YAAY,CAAC,QAAQ,CAAC,mBAAmB,CAAa,CAAC;IACjF,IAAI,CAAC,iBAAiB,EAAE;QACpB,sDAAsD;QACtD,OAAO,EAAE,UAAU,EAAE,oCAAW,CAAC,IAAI,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC;KAC5E;IACD,uBAAuB;IACvB,IAAI,iBAAiB,CAAC,SAAS,KAAK,iCAAS,CAAC,MAAM,EAAE;QAClD,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;KAC9C;IACD,OAAO,EAAE,UAAU,EAAE,oCAAW,CAAC,IAAI,EAAE,iBAAiB,EAAE,CAAC;AAC/D,CAAC;AAnCD,8EAmCC;AAED,SAAS,cAAc,CAAC,aAAuB,EAAE,GAAY;IACzD,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,KAAK,qCAAgB,CAAC,KAAK,CAAC;IACzD,MAAM,QAAQ,GAAG,GAAG,CAAC,SAAS,KAAK,qCAAgB,CAAC,MAAM,CAAC;IAE3D,IAAI,aAAa,CAAC,SAAS,GAAG,CAAC,EAAE;QAC7B,IAAI,aAAa,CAAC,SAAS,KAAK,CAAC,EAAE;YAC/B,IAAI,CAAC,OAAO,EAAE;gBACV,OAAO,KAAK,CAAC;aAChB;SACJ;aAAM;YACH,IAAI,CAAC,QAAQ,EAAE;gBACX,OAAO,KAAK,CAAC;aAChB;SACJ;KACJ;SAAM,IAAI,aAAa,CAAC,SAAS,KAAK,CAAC,CAAC,EAAE;QACvC,SAAS;QACT,IAAI,OAAO,IAAI,QAAQ,EAAE;YACrB,OAAO,KAAK,CAAC;SAChB;KACJ;SAAM,IAAI,aAAa,CAAC,SAAS,KAAK,CAAC,CAAC,EAAE;QACvC,MAAM;KACT;SAAM,IAAI,aAAa,CAAC,SAAS,KAAK,CAAC,CAAC,EAAE;QACvC,mBAAmB;QACnB,IAAI,QAAQ,EAAE;YACV,OAAO,KAAK,CAAC;SAChB;KACJ;SAAM,IAAI,aAAa,CAAC,SAAS,KAAK,CAAC,EAAE;QACtC,kBAAkB;QAClB,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,EAAE;YACvB,OAAO,KAAK,CAAC;SAChB;KACJ;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AACD;;GAEG;AACH,SAAgB,eAAe,CAAC,YAA2B,EAAE,aAAuB,EAAE,GAAY;IAC9F,IAAA,0BAAM,EAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC;IACxE,IAAA,0BAAM,EAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;IAEzE,MAAM,cAAc,GAAG,YAAY,CAAC,YAAY,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,YAAY,CAAC,YAAY,CAAC,IAAA,iCAAa,EAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE3E,uBAAuB;IACvB,IAAI,CAAC,cAAc,EAAE;QACjB,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,eAAe,CAAC,CAAC;QAC1E,OAAO,KAAK,CAAC;KAChB;IAED,IAAI,aAAa,CAAC,SAAS,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,KAAK,6BAAQ,CAAC,IAAI,EAAE;QAChE,6DAA6D;QAC7D,OAAO,IAAI,CAAC;KACf;IAED,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,GAAG,CAAC,EAAE;QACrC,OAAO,KAAK,CAAC;KAChB;IAED,uBAAuB;IACvB,IAAI,CAAC,WAAW,EAAE;QAEd,OAAO,IAAI,QAAQ,CAAC,wBAAwB,EAAE,GAAG,CAAC,QAAQ,EAAE,IAAA,iCAAa,EAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzF,OAAO,IAAI,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC/C,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxD,OAAO,KAAK,CAAC;KAChB;IAED,uBAAuB;IACvB,IAAI,OAAO,EAAE;QACT,OAAO,IAAI,QAAQ,CAAC,2BAA2B,EAAE,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5E,OAAO,IAAI,QAAQ,CAAC,wBAAwB,EAAE,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;KACzE;IAED,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,KAAK,cAAe,CAAC,MAAM,CAAC,KAAK,EAAE;QAC3D,OAAO,IAAI,CAAC;KACf;IAED,qDAAqD;IACrD,IAAI,cAAc,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE;QACzC,uDAAuD;QACvD,OAAO,IAAI,CAAC;KACf;IACD,IAAI,WAAW,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE;QACzC,4DAA4D;QAC5D,OAAO,IAAI,CAAC;KACf;IAED,+BAA+B;IAC/B,IAAI,GAAG,CAAC,QAAQ,KAAK,6BAAQ,CAAC,KAAK,EAAE;QACjC,MAAM,YAAY,GAAG,YAAY,CAAC,YAAY,CAAC,IAAA,gCAAY,EAAC,kCAAW,CAAC,WAAW,CAAC,CAAE,CAAC;QACvF,IAAI,cAAc,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE;YAC1C,OAAO,IAAI,CAAC;SACf;KACJ;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AA3DD,0CA2DC;AAED;;;;;;GAMG;AACH,SAAgB,4BAA4B,CACxC,YAA2B,EAC3B,oBAAgC,EAChC,cAAyB;IAKzB,MAAM,oBAAoB,GAAiB,oBAAoB,CAAC,GAAG,CAAC,CAAC,mBAAmB,EAAE,KAAK,EAAE,EAAE;QAC/F,MAAM,QAAQ,GAAG,cAAe,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,EAAE;YACX,OAAO,oCAAW,CAAC,SAAS,CAAC;SAChC;aAAM,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,mBAAmB,EAAE,QAAQ,CAAC,EAAE;YACtE,OAAO,oCAAW,CAAC,eAAe,CAAC;SACtC;aAAM;YACH,OAAO,oCAAW,CAAC,IAAI,CAAC;SAC3B;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,oBAAoB,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,EAAE;QACrD,uBAAuB;QACvB,OAAO;YACH,QAAQ,CACJ,+BAA+B;gBAC/B,6EAA6E;gBAC7E,uBAAuB;gBACvB,oBAAoB,CAAC,MAAM;gBAC3B,EAAE;gBACF,uBAAuB;gBACvB,cAAc,CAAC,MAAM,CACxB,CAAC;QAEN,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,oCAAW,CAAC,mBAAmB,EAAE,CAAC;KAChF;IAED,IAAI,oBAAoB,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,EAAE;QACrD,uBAAuB;QACvB,OAAO;YACH,QAAQ,CACJ,gCAAgC;gBAChC,kFAAkF;gBAClF,uBAAuB;gBACvB,oBAAoB,CAAC,MAAM;gBAC3B,EAAE;gBACF,uBAAuB;gBACvB,cAAc,CAAC,MAAM,CACxB,CAAC;QAEN,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,oCAAW,CAAC,mBAAmB,EAAE,CAAC;KAChF;IAED,OAAO;QACH,oBAAoB;QACpB,UAAU,EACN,oBAAoB,CAAC,QAAQ,CAAC,oCAAW,CAAC,eAAe,CAAC,IAAI,oBAAoB,CAAC,QAAQ,CAAC,oCAAW,CAAC,aAAa,CAAC;YAClH,CAAC,CAAC,oCAAW,CAAC,kBAAkB;YAChC,CAAC,CAAC,oCAAW,CAAC,IAAI;KAC7B,CAAC;AACN,CAAC;AA1DD,oEA0DC"}

package/dist/source/helpers/call_helpers.d.ts

@@ -0,0 +1,6 @@
+import { CallMethodRequest } from "node-opcua-service-call";
+import { CallMethodResultOptions } from "node-opcua-types";
+import { ISessionContext, IAddressSpace } from "node-opcua-address-space-base";
+type ResponseCallback<T> = (err: Error | null, result?: T) => void;
+export declare function callMethodHelper(context: ISessionContext, addressSpace: IAddressSpace, callMethodRequest: CallMethodRequest, callback: ResponseCallback<CallMethodResultOptions>): void;
+export {};

package/dist/source/helpers/call_helpers.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.callMethodHelper = void 0;
+/**
+ * @module node-opcua-address-space
+ */
+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 node_opcua_status_code_1 = require("node-opcua-status-code");
+const argument_list_1 = require("./argument_list");
+const resolve_opaque_on_address_space_1 = require("./resolve_opaque_on_address_space");
+function callMethodHelper(context, addressSpace, callMethodRequest, callback) {
+    const objectId = callMethodRequest.objectId;
+    const methodId = callMethodRequest.methodId;
+    const inputArguments = callMethodRequest.inputArguments || [];
+    (0, node_opcua_assert_1.assert)(objectId instanceof node_opcua_nodeid_1.NodeId);
+    (0, node_opcua_assert_1.assert)(methodId instanceof node_opcua_nodeid_1.NodeId);
+    const object = addressSpace.findNode(objectId);
+    if (!object) {
+        return callback(null, { statusCode: node_opcua_status_code_1.StatusCodes.BadNodeIdUnknown });
+    }
+    if (object.nodeClass !== node_opcua_data_model_1.NodeClass.Object && object.nodeClass !== node_opcua_data_model_1.NodeClass.ObjectType) {
+        return callback(null, { statusCode: node_opcua_status_code_1.StatusCodes.BadNodeIdInvalid });
+    }
+    const methodObj = addressSpace.findNode(methodId);
+    if (!methodObj) {
+        return callback(null, { statusCode: node_opcua_status_code_1.StatusCodes.BadNodeIdUnknown });
+    }
+    if (methodObj.nodeClass !== node_opcua_data_model_1.NodeClass.Method) {
+        return callback(null, { statusCode: node_opcua_status_code_1.StatusCodes.BadNodeIdInvalid });
+    }
+    const response1 = (0, argument_list_1.getMethodDeclaration_ArgumentList)(addressSpace, objectId, methodId);
+    if (response1.statusCode.isNotGood()) {
+        return callback(null, { statusCode: response1.statusCode });
+    }
+    const methodDeclaration = response1.methodDeclaration;
+    // verify input Parameters
+    const methodInputArguments = methodDeclaration.getInputArguments();
+    const response = (0, argument_list_1.verifyArguments_ArgumentList)(addressSpace, methodInputArguments, inputArguments);
+    if (response.statusCode.isNotGood()) {
+        return callback(null, response);
+    }
+    (0, resolve_opaque_on_address_space_1.resolveOpaqueOnAddressSpace)(addressSpace, inputArguments)
+        .then(() => {
+        methodObj.execute(object, inputArguments, context, (err, callMethodResponse) => {
+            var _a;
+            /* istanbul ignore next */
+            if (err) {
+                return callback(err);
+            }
+            if (!callMethodResponse) {
+                return callback(new Error("internal Error"));
+            }
+            callMethodResponse.inputArgumentResults =
+                callMethodResponse.inputArgumentResults || response.inputArgumentResults || [];
+            (0, node_opcua_assert_1.assert)(callMethodResponse.statusCode);
+            if ((_a = callMethodResponse.statusCode) === null || _a === void 0 ? void 0 : _a.isGood()) {
+                (0, node_opcua_assert_1.assert)(Array.isArray(callMethodResponse.outputArguments));
+            }
+            (0, node_opcua_assert_1.assert)(Array.isArray(callMethodResponse.inputArgumentResults));
+            (0, node_opcua_assert_1.assert)(callMethodResponse.inputArgumentResults.length === methodInputArguments.length);
+            const outputArguments = callMethodResponse.outputArguments || [];
+            (0, resolve_opaque_on_address_space_1.resolveOpaqueOnAddressSpace)(addressSpace, outputArguments)
+                .then(() => callback(null, callMethodResponse))
+                .catch(callback);
+        });
+    })
+        .catch((err) => callback(err));
+}
+exports.callMethodHelper = callMethodHelper;
+//# sourceMappingURL=call_helpers.js.map

package/dist/source/helpers/call_helpers.js.map

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

package/dist/source/helpers/coerce_enum_value.d.ts

@@ -0,0 +1,6 @@
+import { Int64 } from "node-opcua-basic-types";
+import { EnumValueType } from "node-opcua-types";
+import { EnumValueTypeOptionsLike } from "../address_space_ts";
+export declare function coerceEnumValues(enumValues: EnumValueTypeOptionsLike[] | {
+    [key: string]: number | Int64;
+}): EnumValueType[];

package/dist/source/helpers/coerce_enum_value.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.coerceEnumValues = void 0;
+/**
+ * @module node-opcua-address-space
+ */
+const node_opcua_assert_1 = require("node-opcua-assert");
+const node_opcua_data_model_1 = require("node-opcua-data-model");
+const node_opcua_types_1 = require("node-opcua-types");
+function coerceEnumValues(enumValues) {
+    if (Array.isArray(enumValues)) {
+        //
+        return enumValues.map((en) => {
+            (0, node_opcua_assert_1.assert)(Object.prototype.hasOwnProperty.call(en, "value"));
+            (0, node_opcua_assert_1.assert)(Object.prototype.hasOwnProperty.call(en, "displayName"));
+            return new node_opcua_types_1.EnumValueType({
+                displayName: (0, node_opcua_data_model_1.coerceLocalizedText)(en.displayName),
+                value: en.value
+            });
+        });
+    }
+    else {
+        return coerceEnumValues(Object.entries(enumValues).map((entrie) => {
+            const [key, value] = entrie;
+            return new node_opcua_types_1.EnumValueType({
+                description: (0, node_opcua_data_model_1.coerceLocalizedText)(key),
+                displayName: (0, node_opcua_data_model_1.coerceLocalizedText)(key),
+                value
+            });
+        }));
+    }
+}
+exports.coerceEnumValues = coerceEnumValues;
+//# sourceMappingURL=coerce_enum_value.js.map

package/dist/source/helpers/coerce_enum_value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerce_enum_value.js","sourceRoot":"","sources":["../../../source/helpers/coerce_enum_value.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,yDAA2C;AAE3C,iEAA4D;AAC5D,uDAAiD;AAGjD,SAAgB,gBAAgB,CAAC,UAA0E;IACvG,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;QAC3B,EAAE;QACF,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,EAAO,EAAE,EAAE;YAC9B,IAAA,0BAAM,EAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;YAC1D,IAAA,0BAAM,EAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;YAChE,OAAO,IAAI,gCAAa,CAAC;gBACrB,WAAW,EAAE,IAAA,2CAAmB,EAAC,EAAE,CAAC,WAAW,CAAC;gBAChD,KAAK,EAAE,EAAE,CAAC,KAAK;aAClB,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;KACN;SAAM;QACH,OAAO,gBAAgB,CACnB,MAAM,CAAC,OAAO,CAAC,UAAsC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAuB,EAAE,EAAE;YACnF,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC;YAC5B,OAAO,IAAI,gCAAa,CAAC;gBACrB,WAAW,EAAE,IAAA,2CAAmB,EAAC,GAAG,CAAC;gBACrC,WAAW,EAAE,IAAA,2CAAmB,EAAC,GAAG,CAAC;gBACrC,KAAK;aACR,CAAC,CAAC;QACP,CAAC,CAAC,CACL,CAAC;KACL;AACL,CAAC;AAvBD,4CAuBC"}

package/dist/source/helpers/dump_tools.d.ts

@@ -0,0 +1,14 @@
+import { NodeIdLike } from "node-opcua-nodeid";
+import { BrowseDescriptionOptions, ReferenceDescription } from "node-opcua-types";
+import { IAddressSpace, BaseNode, UAReference } from "node-opcua-address-space-base";
+export declare function referenceTypeToString(addressSpace: IAddressSpace, referenceTypeId: NodeIdLike | null): string;
+export declare function dumpReferenceDescription(addressSpace: IAddressSpace, referenceDescription: ReferenceDescription): void;
+export declare function dumpReferenceDescriptions(addressSpace: IAddressSpace, referenceDescriptions: ReferenceDescription[]): void;
+export declare function dumpBrowseDescription(node: BaseNode, _browseDescription: BrowseDescriptionOptions): void;
+/**
+ * @method dumpReferences
+ * @param addressSpace    {IAddressSpace}
+ * @param references  {Array<Reference>|null}
+ * @static
+ */
+export declare function dumpReferences(addressSpace: IAddressSpace, references: UAReference[]): void;

package/dist/source/helpers/dump_tools.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dumpReferences = exports.dumpBrowseDescription = exports.dumpReferenceDescriptions = exports.dumpReferenceDescription = exports.referenceTypeToString = void 0;
+/**
+ * @module node-opcua-address-space
+ */
+// tslint:disable:no-console
+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_types_1 = require("node-opcua-types");
+const reference_impl_1 = require("../../src/reference_impl");
+function referenceTypeToString(addressSpace, referenceTypeId) {
+    // istanbul ignore next
+    if (!referenceTypeId) {
+        return "<null> ";
+    }
+    else {
+        const referenceType = addressSpace.findNode(referenceTypeId);
+        return referenceTypeId.toString() + " " + referenceType.browseName.toString() + "/" + referenceType.inverseName.text;
+    }
+}
+exports.referenceTypeToString = referenceTypeToString;
+function nodeIdInfo(addressSpace, nodeId) {
+    const obj = addressSpace.findNode(nodeId);
+    const name = obj ? obj.browseName.toString() : " <????>";
+    return nodeId.toString() + " [ " + name + " ]";
+}
+function dumpReferenceDescription(addressSpace, referenceDescription) {
+    (0, node_opcua_assert_1.assert)(referenceDescription.referenceTypeId); // must be known;
+    console.log(chalk.red("referenceDescription"));
+    console.log("    referenceTypeId : ", referenceTypeToString(addressSpace, referenceDescription.referenceTypeId));
+    console.log("    isForward       : ", referenceDescription.isForward ? "true" : "false");
+    console.log("    nodeId          : ", nodeIdInfo(addressSpace, referenceDescription.nodeId));
+    console.log("    browseName      : ", referenceDescription.browseName.toString());
+    console.log("    nodeClass       : ", referenceDescription.nodeClass.toString());
+    console.log("    typeDefinition  : ", nodeIdInfo(addressSpace, referenceDescription.typeDefinition));
+}
+exports.dumpReferenceDescription = dumpReferenceDescription;
+function dumpReferenceDescriptions(addressSpace, referenceDescriptions) {
+    referenceDescriptions.forEach((r) => dumpReferenceDescription(addressSpace, r));
+}
+exports.dumpReferenceDescriptions = dumpReferenceDescriptions;
+function dumpBrowseDescription(node, _browseDescription) {
+    const browseDescription = new node_opcua_types_1.BrowseDescription(_browseDescription);
+    const addressSpace = node.addressSpace;
+    console.log(" Browse Node :");
+    if (browseDescription.nodeId) {
+        console.log(" nodeId : ", chalk.cyan(browseDescription.nodeId.toString()));
+    }
+    console.log(" nodeId : ", chalk.cyan(node.browseName.toString()), "(", node.nodeId.toString(), ")");
+    console.log("   referenceTypeId :", referenceTypeToString(addressSpace, browseDescription.referenceTypeId));
+    console.log("   browseDirection :", chalk.cyan(node_opcua_data_model_1.BrowseDirection[browseDescription.browseDirection]));
+    console.log("   includeSubType  :", browseDescription.includeSubtypes ? "true" : "false");
+    console.log("   nodeClassMask   :", browseDescription.nodeClassMask);
+    console.log("   resultMask      :", browseDescription.resultMask);
+}
+exports.dumpBrowseDescription = dumpBrowseDescription;
+/**
+ * @method dumpReferences
+ * @param addressSpace    {IAddressSpace}
+ * @param references  {Array<Reference>|null}
+ * @static
+ */
+function dumpReferences(addressSpace, references) {
+    (0, node_opcua_assert_1.assert)(addressSpace);
+    for (const reference of references) {
+        const referenceType = (0, reference_impl_1.resolveReferenceType)(addressSpace, reference);
+        if (!referenceType) {
+            // unknown type ... this may happen when the address space is not fully build
+            return;
+        }
+        const dir = reference.isForward ? "(=>)" : "(<-)";
+        const objectName = nodeIdInfo(addressSpace, reference.nodeId);
+        console.log(" referenceType : ", dir, referenceType ? referenceType.browseName.toString() : reference.referenceType.toString(), " ", objectName);
+    }
+}
+exports.dumpReferences = dumpReferences;
+//# sourceMappingURL=dump_tools.js.map

package/dist/source/helpers/dump_tools.js.map

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

package/dist/source/helpers/ensure_secure_access.d.ts

@@ -0,0 +1,9 @@
+import { BaseNode } from "node-opcua-address-space-base";
+/**
+ * this method install the access right restriction on the given node and its children
+ * values will only be available to user with role Administrator or supervisor and
+ * with a signed and encrypted channel.
+ *
+ * @param node the node which permissions are to be adjusted
+ */
+export declare function ensureObjectIsSecure(node: BaseNode): void;

package/dist/source/helpers/ensure_secure_access.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureObjectIsSecure = void 0;
+const node_opcua_data_model_1 = require("node-opcua-data-model");
+const node_opcua_types_1 = require("node-opcua-types");
+const session_context_1 = require("../session_context");
+function isChannelSecure(channel) {
+    if (channel.securityMode === node_opcua_types_1.MessageSecurityMode.SignAndEncrypt) {
+        return true;
+    }
+    return false;
+}
+function newIsUserReadable(context) {
+    if (context) {
+        if (!context.session) {
+            // console.log(" context has no session", context);
+            return false;
+        }
+        if (!context.session.channel) {
+            // console.log(" context has no channel", context);
+            return false;
+        }
+        if (!isChannelSecure(context.session.channel)) {
+            return false;
+        }
+        return true;
+    }
+    return false;
+}
+/**
+ * make sure that the given ia node can only be read
+ * by Administrator user on a encrypted channel
+ * @param node
+
+*/
+const restrictedPermissions = [
+    { roleId: session_context_1.WellKnownRoles.SecurityAdmin, permissions: node_opcua_data_model_1.allPermissions },
+    { roleId: session_context_1.WellKnownRoles.ConfigureAdmin, permissions: node_opcua_data_model_1.allPermissions },
+    { roleId: session_context_1.WellKnownRoles.Supervisor, permissions: node_opcua_data_model_1.allPermissions },
+    { roleId: session_context_1.WellKnownRoles.Operator, permissions: (0, node_opcua_data_model_1.makePermissionFlag)("Browse") },
+    { roleId: session_context_1.WellKnownRoles.Engineer, permissions: (0, node_opcua_data_model_1.makePermissionFlag)("Browse") },
+    { roleId: session_context_1.WellKnownRoles.Observer, permissions: (0, node_opcua_data_model_1.makePermissionFlag)("Browse") }
+    /*
+    { roleId: WellKnownRoles.Anonymous, permissions: makePermissionFlag("Browse") },
+    { roleId: WellKnownRoles.AuthenticatedUser, permissions: makePermissionFlag("Browse") },
+*/
+];
+const restrictedAccessFlag = (0, node_opcua_data_model_1.makeAccessRestrictionsFlag)("SigningRequired | EncryptionRequired");
+/**
+ * this method install the access right restriction on the given node and its children
+ * values will only be available to user with role Administrator or supervisor and
+ * with a signed and encrypted channel.
+ *
+ * @param node the node which permissions are to be adjusted
+ */
+function ensureObjectIsSecure(node) {
+    node.setAccessRestrictions(restrictedAccessFlag);
+    if (node.nodeClass === node_opcua_data_model_1.NodeClass.Variable) {
+        // replaceMethod(node, "isUserReadable", newIsUserReadable);
+        const variable = node;
+        variable.setRolePermissions(restrictedPermissions);
+    }
+    if (node.nodeClass === node_opcua_data_model_1.NodeClass.Method) {
+        const method = node;
+        method.setRolePermissions(restrictedPermissions);
+    }
+    if (node.nodeClass === node_opcua_data_model_1.NodeClass.Object) {
+        const object = node;
+        object.setRolePermissions(restrictedPermissions);
+    }
+    const children = node.findReferencesExAsObject("Aggregates", node_opcua_data_model_1.BrowseDirection.Forward);
+    for (const child of children) {
+        ensureObjectIsSecure(child);
+    }
+}
+exports.ensureObjectIsSecure = ensureObjectIsSecure;
+//# sourceMappingURL=ensure_secure_access.js.map

package/dist/source/helpers/ensure_secure_access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure_secure_access.js","sourceRoot":"","sources":["../../../source/helpers/ensure_secure_access.ts"],"names":[],"mappings":";;;AAAA,iEAAmI;AACnI,uDAAuD;AAEvD,wDAAoD;AAEpD,SAAS,eAAe,CAAC,OAAqB;IAC1C,IAAI,OAAO,CAAC,YAAY,KAAK,sCAAmB,CAAC,cAAc,EAAE;QAC7D,OAAO,IAAI,CAAC;KACf;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,SAAS,iBAAiB,CAAiB,OAAwB;IAC/D,IAAI,OAAO,EAAE;QACT,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;YAClB,mDAAmD;YACnD,OAAO,KAAK,CAAC;SAChB;QACD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE;YAC1B,mDAAmD;YACnD,OAAO,KAAK,CAAC;SAChB;QACD,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YAC3C,OAAO,KAAK,CAAC;SAChB;QACD,OAAO,IAAI,CAAC;KACf;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;;;;EAKE;AACF,MAAM,qBAAqB,GAAG;IAC1B,EAAE,MAAM,EAAE,gCAAc,CAAC,aAAa,EAAE,WAAW,EAAE,sCAAc,EAAE;IACrE,EAAE,MAAM,EAAE,gCAAc,CAAC,cAAc,EAAE,WAAW,EAAE,sCAAc,EAAE;IACtE,EAAE,MAAM,EAAE,gCAAc,CAAC,UAAU,EAAE,WAAW,EAAE,sCAAc,EAAE;IAClE,EAAE,MAAM,EAAE,gCAAc,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAA,0CAAkB,EAAC,QAAQ,CAAC,EAAE;IAC9E,EAAE,MAAM,EAAE,gCAAc,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAA,0CAAkB,EAAC,QAAQ,CAAC,EAAE;IAC9E,EAAE,MAAM,EAAE,gCAAc,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAA,0CAAkB,EAAC,QAAQ,CAAC,EAAE;IAC9E;;;EAGF;CACD,CAAC;AACF,MAAM,oBAAoB,GAAG,IAAA,kDAA0B,EAAC,sCAAsC,CAAC,CAAC;AAChG;;;;;;GAMG;AACH,SAAgB,oBAAoB,CAAC,IAAc;IAC/C,IAAI,CAAC,qBAAqB,CAAC,oBAAoB,CAAC,CAAC;IACjD,IAAI,IAAI,CAAC,SAAS,KAAK,iCAAS,CAAC,QAAQ,EAAE;QACvC,4DAA4D;QAC5D,MAAM,QAAQ,GAAG,IAAkB,CAAC;QACpC,QAAQ,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;KACtD;IACD,IAAI,IAAI,CAAC,SAAS,KAAK,iCAAS,CAAC,MAAM,EAAE;QACrC,MAAM,MAAM,GAAG,IAAgB,CAAC;QAChC,MAAM,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;KACpD;IACD,IAAI,IAAI,CAAC,SAAS,KAAK,iCAAS,CAAC,MAAM,EAAE;QACrC,MAAM,MAAM,GAAG,IAAgB,CAAC;QAChC,MAAM,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;KACpD;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,wBAAwB,CAAC,YAAY,EAAE,uCAAe,CAAC,OAAO,CAAC,CAAC;IACtF,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE;QAC1B,oBAAoB,CAAC,KAAK,CAAC,CAAC;KAC/B;AACL,CAAC;AAnBD,oDAmBC"}

package/dist/source/helpers/make_optionals_map.d.ts

@@ -0,0 +1,21 @@
+/**
+ * transform  optional into a map
+ *
+ * @example
+ * ```javascript
+ * const optionals = [ "A", "B", "C.D" ];
+ *
+ * const map = makeOptionalsMap(optionals);
+ * const map = {
+ *   A: {}
+ *   B: {}
+ *   C: {  D: {} }
+ * };
+ * ```
+ *
+ * @internal
+ */
+export interface OptionalMap {
+    [key: string]: OptionalMap;
+}
+export declare function makeOptionalsMap(optionals?: string[] | null): OptionalMap;