@openforis/arena-core 2.3.31 → 2.3.34

package/dist/record/recordExpressionEvaluator/recordExpressionEvaluator.js.map

@@ -1 +1 @@
-{"version":3,"file":"recordExpressionEvaluator.js","sourceRoot":"","sources":["../../../src/record/recordExpressionEvaluator/recordExpressionEvaluator.ts"],"names":[],"mappings":";;;;;;;;;;;;AAGA,iDAAoF;AAGpF,2CAA2D;AAC3D,yCAA8C;AAE9C,uCAAqC;AACrC,wCAAoC;AAEpC,2CAAuD;AACvD,kDAA6D;AAC7D,wDAA0D;AAW1D,MAAa,yBAA0B,SAAQ,0CAAsD;IACnG;QACE,KAAK,CAAC,qCAAyB,EAAE;YAC/B,CAAC,+BAAkB,CAAC,UAAU,CAAC,EAAE,sCAAyB;YAC1D,CAAC,+BAAkB,CAAC,IAAI,CAAC,EAAE,mCAAmB;SAC/C,CAAC,CAAA;IACJ,CAAC;IAEK,cAAc,CAClB,MAIC;;YAED,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAAA;YACpD,MAAM,OAAO,GAAG,gBAAO,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;YAC5E,MAAM,WAAW,GAAG,kBAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAA;YACvF,IAAI,CAAC,WAAW;gBAAE,OAAO,IAAI,CAAA;YAC7B,MAAM,OAAO,mCAAiC,MAAM,KAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,GAAE,CAAA;YACjH,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QACtC,CAAC;KAAA;IAEa,yBAAyB,CACrC,MAIC;;YAED,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,GAAG,KAAK,EAAE,GAAG,MAAM,CAAA;YACjE,MAAM,qBAAqB,GAAwB,EAAE,CAAA;YAErD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;gBACrC,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,CAAA;gBAEtC,IACE,eAAO,CAAC,OAAO,CAAC,WAAW,CAAC;oBAC5B,CAAC,MAAM,IAAI,CAAC,cAAc,iCAAM,MAAM,KAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,aAAX,WAAW,cAAX,WAAW,GAAI,EAAE,IAAG,CAAC,EACnF,CAAC;oBACD,qBAAqB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;oBAEtC,IAAI,gBAAgB,EAAE,CAAC;wBACrB,MAAK;oBACP,CAAC;gBACH,CAAC;YACH,CAAC;YACD,OAAO,qBAAqB,CAAA;QAC9B,CAAC;KAAA;IAEK,yBAAyB,CAC7B,MAIC;;YAED,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAA;YAC1B,MAAM,qBAAqB,GAAG,MAAM,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAA;YAE1E,OAAO,OAAO,CAAC,GAAG,CAChB,qBAAqB,CAAC,GAAG,CAAC,CAAO,UAAU,EAAE,EAAE;;gBAAC,OAAA,CAAC;oBAC/C,UAAU;oBACV,KAAK,EAAE,MAAM,IAAI,CAAC,cAAc,iCAAM,MAAM,KAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAA,UAAU,CAAC,UAAU,mCAAI,EAAE,IAAG;iBACnG,CAAC,CAAA;cAAA,CAAC,CACJ,CAAA;QACH,CAAC;KAAA;IAEK,wBAAwB,CAC5B,MAGC;;;YAED,MAAM,oBAAoB,GAAG,MAAM,IAAI,CAAC,yBAAyB,iCAAM,MAAM,KAAE,gBAAgB,EAAE,IAAI,IAAG,CAAA;YACxG,OAAO,MAAA,oBAAoB,CAAC,CAAC,CAAC,mCAAI,IAAI,CAAA;QACxC,CAAC;KAAA;CACF;AA7ED,8DA6EC"}
+{"version":3,"file":"recordExpressionEvaluator.js","sourceRoot":"","sources":["../../../src/record/recordExpressionEvaluator/recordExpressionEvaluator.ts"],"names":[],"mappings":";;;;;;;;;;;;AAGA,iDAAoF;AAGpF,2CAA2D;AAC3D,yCAA8C;AAE9C,uCAAqC;AACrC,wCAAoC;AAEpC,2CAAuD;AACvD,kDAA6D;AAC7D,wDAA0D;AAW1D,MAAa,yBAA0B,SAAQ,0CAAsD;IACnG;QACE,KAAK,CAAC,qCAAyB,EAAE;YAC/B,CAAC,+BAAkB,CAAC,UAAU,CAAC,EAAE,sCAAyB;YAC1D,CAAC,+BAAkB,CAAC,IAAI,CAAC,EAAE,mCAAmB;SAC/C,CAAC,CAAA;IACJ,CAAC;IAEK,cAAc,CAClB,MAIC;;YAED,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAAA;YACpD,MAAM,OAAO,GAAG,gBAAO,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;YAC5E,MAAM,WAAW,GAAG,kBAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAA;YACvF,IAAI,CAAC,WAAW;gBAAE,OAAO,IAAI,CAAA;YAC7B,MAAM,OAAO,mCAAiC,MAAM,KAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,GAAE,CAAA;YACjH,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QACtC,CAAC;KAAA;IAEa,yBAAyB,CACrC,MAIC;;YAED,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,GAAG,KAAK,EAAE,GAAG,MAAM,CAAA;YACjE,MAAM,qBAAqB,GAAwB,EAAE,CAAA;YAErD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;gBACrC,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,CAAA;gBAEtC,IACE,eAAO,CAAC,OAAO,CAAC,WAAW,CAAC;oBAC5B,CAAC,MAAM,IAAI,CAAC,cAAc,iCAAM,MAAM,KAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,aAAX,WAAW,cAAX,WAAW,GAAI,EAAE,IAAG,CAAC,EACnF,CAAC;oBACD,qBAAqB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;oBAEtC,IAAI,gBAAgB,EAAE,CAAC;wBACrB,MAAK;oBACP,CAAC;gBACH,CAAC;YACH,CAAC;YACD,OAAO,qBAAqB,CAAA;QAC9B,CAAC;KAAA;IAEK,yBAAyB,CAC7B,MAIC;;YAED,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAA;YAC1B,MAAM,qBAAqB,GAAG,MAAM,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAA;YAE1E,OAAO,OAAO,CAAC,GAAG,CAChB,qBAAqB,CAAC,GAAG,CAAC,CAAO,UAAU,EAAE,EAAE;;gBAAC,OAAA,CAAC;oBAC/C,UAAU;oBACV,KAAK,EAAE,MAAM,IAAI,CAAC,cAAc,iCAAM,MAAM,KAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAA,UAAU,CAAC,UAAU,mCAAI,EAAE,IAAG;iBACnG,CAAC,CAAA;cAAA,CAAC,CACJ,CAAA;QACH,CAAC;KAAA;IAEK,wBAAwB,CAC5B,MAGC;;;YAED,MAAM,oBAAoB,GAAG,MAAM,IAAI,CAAC,yBAAyB,iCAAM,MAAM,KAAE,gBAAgB,EAAE,IAAI,IAAG,CAAA;YACxG,OAAO,MAAA,oBAAoB,CAAC,CAAC,CAAC,mCAAI,IAAI,CAAA;QACxC,CAAC;KAAA;CACF;AA7ED,8DA6EC","sourcesContent":["import type { ArenaRecord } from '../record'\nimport { User } from '../../auth'\nimport { CategoryItem } from '../../category'\nimport { ExpressionNodeType, JavascriptExpressionEvaluator } from '../../expression'\nimport { LanguageCode } from '../../language'\nimport { Node } from '../../node'\nimport { NodeDefExpression, NodeDefs } from '../../nodeDef'\nimport { Survey, Surveys } from '../../survey'\nimport { Taxon } from '../../taxonomy'\nimport { Objects } from '../../utils'\nimport { Records } from '../records'\nimport { RecordExpressionContext } from './context'\nimport { recordExpressionFunctions } from './functions'\nimport { RecordIdentifierEvaluator } from './node/identifier'\nimport { RecordThisEvaluator } from './node/thisEvaluator'\n\ntype ExpressionEvaluateParams = {\n  user: User\n  survey: Survey\n  record: ArenaRecord\n  prevCycleRecord?: ArenaRecord\n  timezoneOffset?: number\n  lang?: LanguageCode\n}\n\nexport class RecordExpressionEvaluator extends JavascriptExpressionEvaluator<RecordExpressionContext> {\n  constructor() {\n    super(recordExpressionFunctions, {\n      [ExpressionNodeType.Identifier]: RecordIdentifierEvaluator,\n      [ExpressionNodeType.This]: RecordThisEvaluator,\n    })\n  }\n\n  async evalExpression(\n    params: ExpressionEvaluateParams & {\n      node: Node\n      query: string\n      item?: CategoryItem | Taxon\n    }\n  ): Promise<any> {\n    const { survey, record, node, query, item } = params\n    const nodeDef = Surveys.getNodeDefByUuid({ survey, uuid: node.nodeDefUuid })\n    const nodeContext = NodeDefs.isEntity(nodeDef) ? node : Records.getParent(node)(record)\n    if (!nodeContext) return null\n    const context: RecordExpressionContext = { ...params, nodeContext, nodeCurrent: node, object: nodeContext, item }\n    return this.evaluate(query, context)\n  }\n\n  private async _getApplicableExpressions(\n    params: ExpressionEvaluateParams & {\n      nodeCtx: Node\n      expressions: NodeDefExpression[]\n      stopAtFirstFound?: boolean\n    }\n  ): Promise<NodeDefExpression[]> {\n    const { nodeCtx, expressions, stopAtFirstFound = false } = params\n    const applicableExpressions: NodeDefExpression[] = []\n\n    for (const expression of expressions) {\n      const applyIfExpr = expression.applyIf\n\n      if (\n        Objects.isEmpty(applyIfExpr) ||\n        (await this.evalExpression({ ...params, node: nodeCtx, query: applyIfExpr ?? '' }))\n      ) {\n        applicableExpressions.push(expression)\n\n        if (stopAtFirstFound) {\n          break\n        }\n      }\n    }\n    return applicableExpressions\n  }\n\n  async evalApplicableExpressions(\n    params: ExpressionEvaluateParams & {\n      nodeCtx: Node\n      expressions: NodeDefExpression[]\n      stopAtFirstFound?: boolean\n    }\n  ): Promise<{ expression: NodeDefExpression; value: any }[]> {\n    const { nodeCtx } = params\n    const applicableExpressions = await this._getApplicableExpressions(params)\n\n    return Promise.all(\n      applicableExpressions.map(async (expression) => ({\n        expression,\n        value: await this.evalExpression({ ...params, node: nodeCtx, query: expression.expression ?? '' }),\n      }))\n    )\n  }\n\n  async evalApplicableExpression(\n    params: ExpressionEvaluateParams & {\n      nodeCtx: Node\n      expressions: NodeDefExpression[]\n    }\n  ): Promise<{ expression: NodeDefExpression; value: any } | null> {\n    const expressionsEvaluated = await this.evalApplicableExpressions({ ...params, stopAtFirstFound: true })\n    return expressionsEvaluated[0] ?? null\n  }\n}\n"]}

package/dist/record/recordFixer.js

@@ -10,12 +10,15 @@ const records_1 = require("./records");
 const fixCodeAttribute = (params) => {
     const { survey, nodeDef, record, node, sideEffect } = params;
     if (!nodeDef_1.NodeDefs.getParentCodeDefUuid(nodeDef) || utils_1.Objects.isNotEmpty(node_1.Nodes.getHierarchyCode(node))) {
+        // nodeDef is not a code attribute or meta.hCode already populated: do nothing
         return node;
     }
     const parentNode = records_1.Records.getParent(node)(record);
     if (!parentNode) {
+        // missing parent node; node parentUuid could be invalid
         return node;
     }
+    // populate meta.hCode with ancestor code attribute node uuids
     const hCode = [];
     let currentCodeDef = nodeDef;
     let currentParentCodeAttribute = records_1.Records.getParentCodeAttribute({ parentNode, nodeDef: currentCodeDef })(record);
@@ -31,13 +34,16 @@ const fixCodeAttribute = (params) => {
 const insertMissingSingleNode = (params) => {
     const { survey, nodeDef, record, parentNode, sideEffect } = params;
     if (!nodeDef_1.NodeDefs.isSingle(nodeDef)) {
+        // multiple node: don't insert it
         return null;
     }
     const nodeDefUuid = nodeDef.uuid;
     const children = records_1.Records.getChildren(parentNode, nodeDef.uuid)(record);
     if (!utils_1.Objects.isEmpty(children)) {
+        // single node already inserted
         return null;
     }
+    // insert missing single node
     const recordUuid = record.uuid;
     let node = node_1.NodeFactory.createInstance({ nodeDefUuid, recordUuid, parentNode });
     if (nodeDef.type === nodeDef_1.NodeDefType.code) {
@@ -78,6 +84,7 @@ const deleteNodesByDefUuid = (params) => {
     const recordUpdateOptions = { sideEffect };
     const nodesToDelete = records_1.Records.getNodesByDefUuid(nodeDefUuid)(updateResult.record);
     for (const nodeToDelete of nodesToDelete) {
+        // cleanup child applicability
         const parentNode = records_1.Records.getParent(nodeToDelete)(updateResult.record);
         if (parentNode && !node_1.Nodes.isChildApplicable(parentNode, nodeDefUuid)) {
             const parentNodeUpdated = node_1.Nodes.dissocChildApplicability(parentNode, nodeDefUuid);
@@ -90,9 +97,16 @@ const deleteNodesByDefUuid = (params) => {
     updateResult.merge(nodesDeleteUpdateResult);
     return updateResult;
 };
+/**
+ * Fix a record by:
+ * - inserting missing single nodes
+ * - deleting nodes with non existing node defs
+ * - removing status flags (created, deleted, updated) from all nodes
+ */
 const fixRecord = (params) => {
     const { survey, record, sideEffect = false } = params;
     const result = new recordNodesUpdater_1.RecordUpdateResult({ record });
+    // 1. delete nodes with non existing node defs (and their descendants), once per missing node def
     const missingNodeDefUuids = new Set();
     for (const { nodeDefUuid } of records_1.Records.getNodesArray(record)) {
         if (!survey_1.Surveys.findNodeDefByUuid({ survey, uuid: nodeDefUuid })) {
@@ -102,9 +116,11 @@ const fixRecord = (params) => {
     for (const nodeDefUuid of missingNodeDefUuids) {
         result.merge(deleteNodesByDefUuid({ record: result.record, nodeDefUuid, sideEffect }));
     }
+    // 2. fix the remaining nodes (read from the updated record, without the deleted nodes); add them all at once
     const nodesUpdated = {};
     for (const node of records_1.Records.getNodesArray(result.record)) {
         const nodeDef = survey_1.Surveys.getNodeDefByUuid({ survey, uuid: node.nodeDefUuid });
+        // remove status flags
         let nodeUpdated = node_1.Nodes.removeStatusFlags({ node, sideEffect });
         if (nodeDef.type === nodeDef_1.NodeDefType.code) {
             nodeUpdated = fixCodeAttribute({

package/dist/record/recordFixer.js.map

@@ -1 +1 @@
-{"version":3,"file":"recordFixer.js","sourceRoot":"","sources":["../../src/record/recordFixer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"recordFixer.js","sourceRoot":"","sources":["../../src/record/recordFixer.ts"],"names":[],"mappings":"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","sourcesContent":["import { NodeFactory, Nodes } from '../node'\nimport { NodeDef, NodeDefCode, NodeDefs, NodeDefType } from '../nodeDef'\nimport { Survey, Surveys } from '../survey'\nimport { Objects } from '../utils'\nimport type { ArenaRecord, ArenaRecordNode } from './record'\nimport { RecordUpdateResult } from './recordNodesUpdater'\nimport { Records } from './records'\n\nconst fixCodeAttribute = (params: {\n  survey: Survey\n  nodeDef: NodeDefCode\n  record: ArenaRecord\n  node: ArenaRecordNode\n  sideEffect: boolean\n}): ArenaRecordNode => {\n  const { survey, nodeDef, record, node, sideEffect } = params\n  if (!NodeDefs.getParentCodeDefUuid(nodeDef) || Objects.isNotEmpty(Nodes.getHierarchyCode(node))) {\n    // nodeDef is not a code attribute or meta.hCode already populated: do nothing\n    return node\n  }\n  const parentNode = Records.getParent(node)(record)\n  if (!parentNode) {\n    // missing parent node; node parentUuid could be invalid\n    return node\n  }\n  // populate meta.hCode with ancestor code attribute node uuids\n  const hCode: string[] = []\n  let currentCodeDef: NodeDefCode = nodeDef\n  let currentParentCodeAttribute = Records.getParentCodeAttribute({ parentNode, nodeDef: currentCodeDef })(record)\n  while (currentParentCodeAttribute) {\n    hCode.unshift(currentParentCodeAttribute.uuid)\n    currentCodeDef = Surveys.getNodeDefByUuid({ survey, uuid: currentParentCodeAttribute.nodeDefUuid }) as NodeDefCode\n    currentParentCodeAttribute = Records.getParentCodeAttribute({ parentNode, nodeDef: currentCodeDef })(record)\n  }\n  const nodeUpdated = sideEffect ? node : { ...node }\n  nodeUpdated.meta = { ...nodeUpdated.meta, hCode }\n  return nodeUpdated\n}\n\nconst insertMissingSingleNode = (params: {\n  survey: Survey\n  nodeDef: NodeDef<any>\n  record: ArenaRecord\n  parentNode: ArenaRecordNode\n  sideEffect: boolean\n}): RecordUpdateResult | null => {\n  const { survey, nodeDef, record, parentNode, sideEffect } = params\n  if (!NodeDefs.isSingle(nodeDef)) {\n    // multiple node: don't insert it\n    return null\n  }\n  const nodeDefUuid = nodeDef.uuid\n  const children = Records.getChildren(parentNode, nodeDef.uuid)(record)\n  if (!Objects.isEmpty(children)) {\n    // single node already inserted\n    return null\n  }\n  // insert missing single node\n  const recordUuid = record.uuid\n  let node = NodeFactory.createInstance({ nodeDefUuid, recordUuid, parentNode })\n\n  if (nodeDef.type === NodeDefType.code) {\n    node = fixCodeAttribute({ survey, nodeDef: nodeDef as NodeDefCode, record, node, sideEffect })\n  }\n\n  const recordUpdated = Records.addNode(node, { sideEffect })(record)\n  return new RecordUpdateResult({ record: recordUpdated, nodes: { [node.uuid]: node } })\n}\n\nconst insertMissingSingleNodes = (params: {\n  survey: Survey\n  record: ArenaRecord\n  sideEffect: boolean\n}): RecordUpdateResult => {\n  const { survey, record, sideEffect } = params\n  const updateResult = new RecordUpdateResult({ record })\n  Surveys.visitNodeDefs({\n    survey,\n    visitor: (nodeDef) => {\n      const parentDefUuid = nodeDef.parentUuid\n      if (parentDefUuid) {\n        const parentNodes = Records.getNodesByDefUuid(parentDefUuid)(updateResult.record)\n        for (const parentNode of parentNodes) {\n          const partialUpdateResult = insertMissingSingleNode({\n            survey,\n            nodeDef,\n            record: updateResult.record,\n            parentNode,\n            sideEffect,\n          })\n          if (partialUpdateResult) {\n            updateResult.merge(partialUpdateResult)\n          }\n        }\n      }\n    },\n  })\n  return updateResult\n}\n\nconst deleteNodesByDefUuid = (params: { record: ArenaRecord; nodeDefUuid: string; sideEffect: boolean }) => {\n  const { record, nodeDefUuid, sideEffect } = params\n  const updateResult = new RecordUpdateResult({ record })\n\n  const recordUpdateOptions = { sideEffect }\n\n  const nodesToDelete = Records.getNodesByDefUuid(nodeDefUuid)(updateResult.record)\n  for (const nodeToDelete of nodesToDelete) {\n    // cleanup child applicability\n    const parentNode = Records.getParent(nodeToDelete)(updateResult.record)\n    if (parentNode && !Nodes.isChildApplicable(parentNode, nodeDefUuid)) {\n      const parentNodeUpdated = Nodes.dissocChildApplicability(parentNode, nodeDefUuid)\n      const recordWithParentNodeUpdated = Records.addNode(parentNodeUpdated, recordUpdateOptions)(updateResult.record)\n      updateResult.merge(new RecordUpdateResult({ record: recordWithParentNodeUpdated }))\n    }\n  }\n  const nodeUuidsToDelete = nodesToDelete.map((node) => node.uuid)\n  const nodesDeleteUpdateResult = Records.deleteNodes(nodeUuidsToDelete, recordUpdateOptions)(updateResult.record)\n  updateResult.merge(nodesDeleteUpdateResult)\n\n  return updateResult\n}\n\n/**\n * Fix a record by:\n * - inserting missing single nodes\n * - deleting nodes with non existing node defs\n * - removing status flags (created, deleted, updated) from all nodes\n */\nconst fixRecord = (params: { survey: Survey; record: ArenaRecord; sideEffect?: boolean }): RecordUpdateResult => {\n  const { survey, record, sideEffect = false } = params\n  const result = new RecordUpdateResult({ record })\n\n  // 1. delete nodes with non existing node defs (and their descendants), once per missing node def\n  const missingNodeDefUuids = new Set<string>()\n  for (const { nodeDefUuid } of Records.getNodesArray(record)) {\n    if (!Surveys.findNodeDefByUuid({ survey, uuid: nodeDefUuid })) {\n      missingNodeDefUuids.add(nodeDefUuid)\n    }\n  }\n  for (const nodeDefUuid of missingNodeDefUuids) {\n    result.merge(deleteNodesByDefUuid({ record: result.record, nodeDefUuid, sideEffect }))\n  }\n\n  // 2. fix the remaining nodes (read from the updated record, without the deleted nodes); add them all at once\n  const nodesUpdated: { [key: string]: ArenaRecordNode } = {}\n  for (const node of Records.getNodesArray(result.record)) {\n    const nodeDef = Surveys.getNodeDefByUuid({ survey, uuid: node.nodeDefUuid })\n    // remove status flags\n    let nodeUpdated = Nodes.removeStatusFlags({ node, sideEffect })\n\n    if (nodeDef.type === NodeDefType.code) {\n      nodeUpdated = fixCodeAttribute({\n        survey,\n        nodeDef: nodeDef as NodeDefCode,\n        record: result.record,\n        node: nodeUpdated,\n        sideEffect,\n      })\n    }\n    nodesUpdated[nodeUpdated.uuid] = nodeUpdated\n  }\n  const recordWithNodesUpdated = Records.addNodes(nodesUpdated, { sideEffect })(result.record)\n  result.merge(new RecordUpdateResult({ record: recordWithNodesUpdated, nodes: nodesUpdated }))\n\n  const missingNodesUpdateResult = insertMissingSingleNodes({ survey, record: result.record, sideEffect })\n  result.merge(missingNodesUpdateResult)\n  return result\n}\n\nexport const RecordFixer = {\n  fixRecord,\n  insertMissingSingleNodes,\n}\n"]}

package/dist/record/recordNodesUpdater/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/record/recordNodesUpdater/index.ts"],"names":[],"mappings":";;;AAAA,6DAAkF;AAClF,6DAA4D;AAC5D,6DAA8D;AAE9D,2DAAyD;AAAhD,wHAAA,kBAAkB,OAAA;AAId,QAAA,kBAAkB,GAAG;IAChC,iBAAiB,EAAjB,sCAAiB;IACjB,wBAAwB,EAAxB,6CAAwB;IACxB,qBAAqB,EAArB,0CAAqB;IACrB,UAAU,EAAV,+BAAU;IACV,WAAW,EAAX,gCAAW;CACZ,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/record/recordNodesUpdater/index.ts"],"names":[],"mappings":";;;AAAA,6DAAkF;AAClF,6DAA4D;AAC5D,6DAA8D;AAE9D,2DAAyD;AAAhD,wHAAA,kBAAkB,OAAA;AAId,QAAA,kBAAkB,GAAG;IAChC,iBAAiB,EAAjB,sCAAiB;IACjB,wBAAwB,EAAxB,6CAAwB;IACxB,qBAAqB,EAArB,0CAAqB;IACrB,UAAU,EAAV,+BAAU;IACV,WAAW,EAAX,gCAAW;CACZ,CAAA","sourcesContent":["import { createDescendants, createNodeAndDescendants } from './recordNodesCreator'\nimport { updateNodesDependents } from './recordNodesUpdater'\nimport { deleteNode, deleteNodes } from './recordNodesDeleter'\n\nexport { RecordUpdateResult } from './recordUpdateResult'\nexport type { RecordExpressionEvaluationContext } from './recordExpressionEvaluationContext'\nexport type { NodeCreateParams, NodesUpdateParams } from './recordNodesCreator'\n\nexport const RecordNodesUpdater = {\n  createDescendants,\n  createNodeAndDescendants,\n  updateNodesDependents,\n  deleteNode,\n  deleteNodes,\n}\n"]}

package/dist/record/recordNodesUpdater/recordEnumeratingItemsExpressionEvaluator.d.ts

@@ -3,6 +3,12 @@ import { Node } from '../../node';
 import { NodeDefEntity } from '../../nodeDef';
 import { Survey } from '../../survey';
 import { Record } from '../record';
+/**
+ * Evaluates the entity's enumeratingItemsExpression and returns the allowed category item codes.
+ *
+ * @param params - Evaluation context parameters.
+ * @returns Allowed category item codes, or undefined when no expression is configured.
+ */
 export declare const getEnumeratingItemsAllowedCodes: (params: {
     survey: Survey;
     user: User;

package/dist/record/recordNodesUpdater/recordEnumeratingItemsExpressionEvaluator.js

@@ -13,6 +13,12 @@ exports.getEnumeratingItemsAllowedCodes = void 0;
 const nodeDef_1 = require("../../nodeDef");
 const recordExpressionEvaluator_1 = require("../recordExpressionEvaluator");
 const expressionEvaluator = new recordExpressionEvaluator_1.RecordExpressionEvaluator();
+/**
+ * Evaluates the entity's enumeratingItemsExpression and returns the allowed category item codes.
+ *
+ * @param params - Evaluation context parameters.
+ * @returns Allowed category item codes, or undefined when no expression is configured.
+ */
 const getEnumeratingItemsAllowedCodes = (params) => __awaiter(void 0, void 0, void 0, function* () {
     const { survey, user, record, entityDef, parentNode } = params;
     const expression = nodeDef_1.NodeDefs.getEnumeratingItemsExpression(entityDef);

package/dist/record/recordNodesUpdater/recordEnumeratingItemsExpressionEvaluator.js.map

@@ -1 +1 @@
-{"version":3,"file":"recordEnumeratingItemsExpressionEvaluator.js","sourceRoot":"","sources":["../../../src/record/recordNodesUpdater/recordEnumeratingItemsExpressionEvaluator.ts"],"names":[],"mappings":";;;;;;;;;;;;AAEA,2CAAuD;AAGvD,4EAAwE;AAExE,MAAM,mBAAmB,GAAG,IAAI,qDAAyB,EAAE,CAAA;AAQpD,MAAM,+BAA+B,GAAG,CAAO,MAMrD,EAAoC,EAAE;IACrC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,MAAM,CAAA;IAC9D,MAAM,UAAU,GAAG,kBAAQ,CAAC,6BAA6B,CAAC,SAAS,CAAC,CAAA;IACpE,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAA;IAEjC,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,cAAc,CAAC;QACtD,IAAI;QACJ,MAAM;QACN,MAAM;QACN,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;KAClB,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,GAAG,EAAU,CAAA;IAC/D,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;AAC7G,CAAC,CAAA,CAAA;AArBY,QAAA,+BAA+B,mCAqB3C"}
+{"version":3,"file":"recordEnumeratingItemsExpressionEvaluator.js","sourceRoot":"","sources":["../../../src/record/recordNodesUpdater/recordEnumeratingItemsExpressionEvaluator.ts"],"names":[],"mappings":";;;;;;;;;;;;AAEA,2CAAuD;AAGvD,4EAAwE;AAExE,MAAM,mBAAmB,GAAG,IAAI,qDAAyB,EAAE,CAAA;AAE3D;;;;;GAKG;AACI,MAAM,+BAA+B,GAAG,CAAO,MAMrD,EAAoC,EAAE;IACrC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,MAAM,CAAA;IAC9D,MAAM,UAAU,GAAG,kBAAQ,CAAC,6BAA6B,CAAC,SAAS,CAAC,CAAA;IACpE,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAA;IAEjC,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,cAAc,CAAC;QACtD,IAAI;QACJ,MAAM;QACN,MAAM;QACN,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;KAClB,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,GAAG,EAAU,CAAA;IAC/D,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;AAC7G,CAAC,CAAA,CAAA;AArBY,QAAA,+BAA+B,mCAqB3C","sourcesContent":["import { User } from '../../auth'\nimport { Node } from '../../node'\nimport { NodeDefEntity, NodeDefs } from '../../nodeDef'\nimport { Survey } from '../../survey'\nimport { Record } from '../record'\nimport { RecordExpressionEvaluator } from '../recordExpressionEvaluator'\n\nconst expressionEvaluator = new RecordExpressionEvaluator()\n\n/**\n * Evaluates the entity's enumeratingItemsExpression and returns the allowed category item codes.\n *\n * @param params - Evaluation context parameters.\n * @returns Allowed category item codes, or undefined when no expression is configured.\n */\nexport const getEnumeratingItemsAllowedCodes = async (params: {\n  survey: Survey\n  user: User\n  record: Record\n  entityDef: NodeDefEntity\n  parentNode: Node\n}): Promise<Set<string> | undefined> => {\n  const { survey, user, record, entityDef, parentNode } = params\n  const expression = NodeDefs.getEnumeratingItemsExpression(entityDef)\n  if (!expression) return undefined\n\n  const result = await expressionEvaluator.evalExpression({\n    user,\n    survey,\n    record,\n    node: parentNode,\n    query: expression,\n  })\n\n  if (!result || !Array.isArray(result)) return new Set<string>()\n  return new Set(result.filter((value) => value !== null && value !== undefined && value !== '').map(String))\n}\n"]}

package/dist/record/recordNodesUpdater/recordExpressionEvaluationContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"recordExpressionEvaluationContext.js","sourceRoot":"","sources":["../../../src/record/recordNodesUpdater/recordExpressionEvaluationContext.ts"],"names":[],"mappings":""}
+{"version":3,"file":"recordExpressionEvaluationContext.js","sourceRoot":"","sources":["../../../src/record/recordNodesUpdater/recordExpressionEvaluationContext.ts"],"names":[],"mappings":"","sourcesContent":["import { User } from '../../auth'\nimport { LanguageCode } from '../../language'\nimport { CategoryItemProvider } from '../../nodeDefExpressionEvaluator/categoryItemProvider'\nimport { TaxonProvider } from '../../nodeDefExpressionEvaluator/taxonProvider'\nimport { Survey } from '../../survey'\nimport type { ArenaRecord } from '../record'\n\nexport interface RecordExpressionEvaluationContext {\n  user: User\n  survey: Survey\n  record: ArenaRecord\n  prevCycleRecord?: ArenaRecord\n  timezoneOffset?: number\n  lang?: LanguageCode\n  categoryItemProvider?: CategoryItemProvider\n  taxonProvider?: TaxonProvider\n  sideEffect?: boolean\n}\n"]}

package/dist/record/recordNodesUpdater/recordExpressionValueConverter.js

@@ -51,6 +51,7 @@ const _toCode = (params) => __awaiter(void 0, void 0, void 0, function* () {
     const { survey, record, nodeDef, nodeParent, valueExpr, categoryItemProvider } = params;
     if (!nodeParent)
         return null;
+    // ValueExpr is the code of a category item
     const code = String(valueExpr);
     const categoryItemUuid = yield _findCategoryItemUuidByCode({
         survey,
@@ -74,6 +75,9 @@ const _toDateTime = (params) => {
     const date = utils_1.Dates.parse(valueExpr, formatFrom);
     if (!date)
         return null;
+    // `date` encodes the parsed digits as if they were UTC (see Dates.parse/parseZone), so shift by the
+    // client's offset (if any) and read the result back out in UTC - never in this machine's local time zone,
+    // which would otherwise silently reintroduce the server's own timezone into the result.
     const dateWithTimezoneOffset = timezoneOffset ? new Date(date.getTime() - timezoneOffset * 60000) : date;
     return utils_1.Dates.formatUTC(dateWithTimezoneOffset, format);
 };
@@ -89,6 +93,7 @@ const findTaxonByCode = (params) => __awaiter(void 0, void 0, void 0, function*
 });
 const _toTaxon = (params) => __awaiter(void 0, void 0, void 0, function* () {
     const { survey, record, nodeDef, valueExpr, taxonProvider } = params;
+    // ValueExpr is the code of a taxon
     const taxonCode = String(valueExpr);
     const taxonNodeDef = nodeDef;
     const draft = !!record.preview;

package/dist/record/recordNodesUpdater/recordExpressionValueConverter.js.map

@@ -1 +1 @@
-{"version":3,"file":"recordExpressionValueConverter.js","sourceRoot":"","sources":["../../../src/record/recordNodesUpdater/recordExpressionValueConverter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"recordExpressionValueConverter.js","sourceRoot":"","sources":["../../../src/record/recordNodesUpdater/recordExpressionValueConverter.ts"],"names":[],"mappings":"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","sourcesContent":["import { Point, Points } from '../../geo'\nimport { Node, NodeValueCode, NodeValueTaxon } from '../../node'\nimport { Survey, Surveys } from '../../survey'\nimport { Record } from '../record'\nimport { Records } from '../records'\nimport { NodeDef, NodeDefType, NodeDefs, NodeDefCodeProps, NodeDefTaxon, NodeDefCode } from '../../nodeDef'\nimport { Dates, DateFormats, Objects } from '../../utils'\nimport { CategoryItemProvider } from '../../nodeDefExpressionEvaluator/categoryItemProvider'\nimport { TaxonProvider } from '../../nodeDefExpressionEvaluator/taxonProvider'\n\ninterface ToNodeValueParams {\n  survey: Survey\n  record: Record\n  nodeParent: Node\n  nodeDef: NodeDef<any>\n  valueExpr: string\n  timezoneOffset?: number\n  categoryItemProvider?: CategoryItemProvider\n  taxonProvider?: TaxonProvider\n}\n\nconst _toPrimitive = (TypeTo: any) => (params: ToNodeValueParams) => {\n  const { valueExpr: val } = params\n  return TypeTo(val)\n}\n\nconst _toBoolean = (params: ToNodeValueParams) => {\n  const { valueExpr } = params\n  if (['true', 'false'].includes(String(valueExpr))) return String(valueExpr)\n  return null\n}\n\nconst _findCategoryItemUuidByCode = async (params: {\n  survey: Survey\n  record: Record\n  nodeDef: NodeDefCode\n  nodeParent: Node\n  code: string\n  categoryItemProvider?: CategoryItemProvider\n}): Promise<string | undefined> => {\n  const { survey, record, nodeDef, nodeParent, code, categoryItemProvider } = params\n  const codeNodeDef = nodeDef as NodeDef<NodeDefType.code, NodeDefCodeProps>\n\n  const categoryItemUuid = Records.getCategoryItemUuid({\n    survey,\n    record,\n    nodeDef: codeNodeDef,\n    parentNode: nodeParent,\n    code,\n  })\n  if (categoryItemUuid) return categoryItemUuid\n  if (!categoryItemProvider) return undefined\n\n  const categoryUuid = NodeDefs.getCategoryUuid(nodeDef)\n  if (!categoryUuid) return undefined\n  const codePaths = [...Records.getAncestorCodePath({ survey, record, parentNode: nodeParent, nodeDef }), code]\n  const draft = !!record.preview\n  const item = await categoryItemProvider.getItemByCodePaths({ survey, categoryUuid, codePaths, draft })\n  return item?.uuid\n}\n\nconst _toCode = async (params: ToNodeValueParams): Promise<NodeValueCode | null> => {\n  const { survey, record, nodeDef, nodeParent, valueExpr, categoryItemProvider } = params\n\n  if (!nodeParent) return null\n\n  // ValueExpr is the code of a category item\n  const code = String(valueExpr)\n\n  const categoryItemUuid = await _findCategoryItemUuidByCode({\n    survey,\n    record,\n    nodeDef: nodeDef as NodeDefCode,\n    nodeParent,\n    code,\n    categoryItemProvider,\n  })\n\n  return categoryItemUuid ? { itemUuid: categoryItemUuid } : null\n}\n\nconst _toCoordinate = (params: ToNodeValueParams): Point | null => {\n  const { valueExpr } = params\n  return Points.parse(valueExpr)\n}\n\nconst _toDateTime = (params: {\n  valueExpr: any\n  format: DateFormats\n  formatsFrom: DateFormats[]\n  timezoneOffset?: number\n}): string | null => {\n  const { valueExpr, format, formatsFrom = [DateFormats.datetimeDefault], timezoneOffset } = params\n  const formatFrom = formatsFrom.find((formt) => Dates.isValidDateInFormat(valueExpr, formt))\n  if (!formatFrom) return null\n\n  const date = Dates.parse(valueExpr, formatFrom)\n  if (!date) return null\n\n  // `date` encodes the parsed digits as if they were UTC (see Dates.parse/parseZone), so shift by the\n  // client's offset (if any) and read the result back out in UTC - never in this machine's local time zone,\n  // which would otherwise silently reintroduce the server's own timezone into the result.\n  const dateWithTimezoneOffset = timezoneOffset ? new Date(date.getTime() - timezoneOffset * 60000) : date\n  return Dates.formatUTC(dateWithTimezoneOffset, format)\n}\n\nconst findTaxonByCode = async (params: {\n  survey: Survey\n  nodeDef: NodeDefTaxon\n  taxonCode: string\n  draft: boolean\n  taxonProvider?: TaxonProvider\n}) => {\n  const { survey, nodeDef, taxonCode, taxonProvider, draft } = params\n  const taxonomyUuid = NodeDefs.getTaxonomyUuid(nodeDef)!\n  const taxon = Surveys.getTaxonByCode({ survey, taxonomyUuid, taxonCode })\n  if (taxon) return taxon\n  if (!taxonProvider) return null\n  return taxonProvider.getTaxonByCode({ survey, taxonomyUuid, taxonCode, draft })\n}\n\nconst _toTaxon = async (params: ToNodeValueParams): Promise<NodeValueTaxon | null> => {\n  const { survey, record, nodeDef, valueExpr, taxonProvider } = params\n\n  // ValueExpr is the code of a taxon\n  const taxonCode = String(valueExpr)\n\n  const taxonNodeDef = nodeDef as NodeDefTaxon\n  const draft = !!record.preview\n  const taxon = await findTaxonByCode({ survey, nodeDef: taxonNodeDef, taxonCode, taxonProvider, draft })\n  return taxon ? { taxonUuid: taxon.uuid } : null\n}\n\nconst _valueExprToValueNodeFns: { [key in NodeDefType]?: (params: ToNodeValueParams) => any } = {\n  [NodeDefType.boolean]: _toBoolean,\n  [NodeDefType.code]: _toCode,\n  [NodeDefType.coordinate]: _toCoordinate,\n  [NodeDefType.date]: (params: { valueExpr: any; timezoneOffset?: number }) => {\n    const { valueExpr, timezoneOffset } = params\n    return _toDateTime({\n      valueExpr,\n      format: DateFormats.dateStorage,\n      formatsFrom: [DateFormats.datetimeStorage, DateFormats.datetimeDefault, DateFormats.dateStorage],\n      timezoneOffset,\n    })\n  },\n  [NodeDefType.decimal]: _toPrimitive(Number),\n  [NodeDefType.geo]: (params: { valueExpr: any }) => {\n    const { valueExpr } = params\n    return typeof valueExpr === 'string' ? JSON.parse(valueExpr) : valueExpr\n  },\n  [NodeDefType.integer]: _toPrimitive(Number),\n  [NodeDefType.taxon]: _toTaxon,\n  [NodeDefType.text]: _toPrimitive(String),\n  [NodeDefType.time]: (params: { nodeDef: NodeDef<any>; valueExpr: any; timezoneOffset?: number }) => {\n    const { nodeDef, valueExpr, timezoneOffset } = params\n    return _toDateTime({\n      valueExpr,\n      format: NodeDefs.isSecondsIncluded(nodeDef) ? DateFormats.timeWithSeconds : DateFormats.timeStorage,\n      formatsFrom: [\n        DateFormats.datetimeStorage,\n        DateFormats.datetimeDefault,\n        DateFormats.timeWithSeconds,\n        DateFormats.timeStorage,\n      ],\n      timezoneOffset,\n    })\n  },\n}\n\nconst toNodeValue = (params: ToNodeValueParams): Promise<any> => {\n  const { nodeDef, valueExpr } = params\n  if (Objects.isEmpty(valueExpr)) return Promise.resolve(null)\n\n  const fn = _valueExprToValueNodeFns[NodeDefs.getType(nodeDef)]\n  return Promise.resolve(fn?.(params))\n}\n\nexport const RecordExpressionValueConverter = {\n  toNodeValue,\n}\n"]}

package/dist/record/recordNodesUpdater/recordNodeDependentsApplicableUpdater.js

@@ -42,27 +42,35 @@ const calculateApplicableNext = (_a) => __awaiter(void 0, [_a], void 0, function
     const expressionsToEvaluate = nodeDef_1.NodeDefs.getApplicable(nodeDefNodePointer);
     if (expressionsToEvaluate.length === 0) {
         if (applicablePrev) {
+            // skip nodes that were already applicable and have no applicable expression, as they will remain applicable
             return undefined;
         }
         else {
+            // used during survey publishing: node def could have had applicable expression(s) that were removed,
+            // and node could have been not applicable, but now it should be applicable, as there are no more applicable expressions
             return true;
         }
     }
     else {
+        // 3. evaluate applicable expression
         const exprEval = yield expressionEvaluator.evalApplicableExpression(Object.assign(Object.assign({}, params), { record: updateResult.record, nodeCtx, expressions: expressionsToEvaluate }));
         return (exprEval === null || exprEval === void 0 ? void 0 : exprEval.value) || false;
     }
 });
 const updateDescendantsApplicability = ({ updateResult, nodeCtxChild, applicable, params, recordUpdateOptions, }) => {
     const { survey, sideEffect = false, clearNonApplicableValues = false } = params;
+    // only values entered by the user are reported as cleared (they need a confirmation)
     let userValuesCleared = false;
     records_1.Records.visitDescendantsAndSelf({
         record: updateResult.record,
         node: nodeCtxChild,
         visitor: (nodeDescendant) => {
             const nodeDescendantCleared = clearNonApplicableValues && !applicable && node_1.Nodes.isValueNotBlank(nodeDescendant);
+            // values set by expressions (default values, read only attributes) are applied again when applicable: not reported
+            // (evaluated before clearing the value: with sideEffect the node is modified in place)
             const nodeDescendantDef = survey_1.Surveys.getNodeDefByUuid({ survey, uuid: nodeDescendant.nodeDefUuid });
             const userValueCleared = nodeDescendantCleared && !nodeDef_1.NodeDefs.isReadOnly(nodeDescendantDef) && node_1.Nodes.hasUserInputValue(nodeDescendant);
+            // Clear value if becoming non-applicable and parameter is enabled
             const nodeDescendantUpdated = nodeDescendantCleared
                 ? node_1.Nodes.assocValue(nodeDescendant, null, sideEffect)
                 : nodeDescendant;
@@ -74,6 +82,7 @@ const updateDescendantsApplicability = ({ updateResult, nodeCtxChild, applicable
             return false;
         },
     });
+    // if a multiple entity became not applicable and it's empty, delete it instead of just marking descendants as not applicable
     if (!applicable && clearNonApplicableValues) {
         const { uuid: nodeCtxChildUuid, nodeDefUuid: nodeCtxChildDefUuid } = nodeCtxChild;
         const nodeCtxChildDef = survey_1.Surveys.getNodeDefByUuid({ survey, uuid: nodeCtxChildDefUuid });
@@ -96,7 +105,8 @@ const createMissingApplicableMultipleEntities = (_a) => __awaiter(void 0, [_a],
     const missingCount = Math.max(0, minCount - existingChildren.length);
     for (let index = 0; index < missingCount; index++) {
         const createParams = Object.assign(Object.assign({}, params), { record: updateResult.record, parentNode, nodeDef });
-        const childUpdateResult = yield (0, recordNodesCreator_1.createNodeAndDescendants)(createParams);
+        // create nodes sequentially: every iteration works on the record updated by the previous one
+        const childUpdateResult = yield (0, recordNodesCreator_1.createNodeAndDescendants)(createParams); // NOSONAR
         updateResult.merge(childUpdateResult);
     }
 });
@@ -105,6 +115,7 @@ const updateNodePointerApplicability = (_a) => __awaiter(void 0, [_a], void 0, f
     const { nodeCtx: nodeCtxNodePointer, nodeDef: nodeDefNodePointer } = nodePointer;
     const nodeCtxUuid = nodeCtxNodePointer.uuid;
     const nodeDefUuid = nodeDefNodePointer.uuid;
+    // nodeCtx could have been updated in a previous iteration
     const nodeCtx = (_b = updateResult.getNodeByUuid(nodeCtxUuid)) !== null && _b !== void 0 ? _b : nodeCtxNodePointer;
     const applicablePrev = node_1.Nodes.isChildApplicable(nodeCtx, nodeDefUuid);
     const applicable = yield calculateApplicableNext({
@@ -124,9 +135,12 @@ const updateNodePointerApplicability = (_a) => __awaiter(void 0, [_a], void 0, f
             nodeDef: nodeDefNodePointer,
         });
     }
+    // 4. persist updated applicability if changed, and return updated nodes
     if (applicablePrev === applicable) {
         return;
     }
+    // Applicability changed
+    // update node and add it to nodes updated
     const nodeCtxUpdated = node_1.Nodes.assocChildApplicability(nodeCtx, nodeDefUuid, applicable);
     updateResult.addNode(nodeCtxUpdated, recordUpdateOptions);
     let nodeCtxChildren = records_1.Records.getChildren(nodeCtx, nodeDefUuid)(updateResult.record);
@@ -143,6 +157,7 @@ const updateNodePointerApplicability = (_a) => __awaiter(void 0, [_a], void 0, f
         nodeCtxChildren = records_1.Records.getChildren(nodeCtx, nodeDefUuid)(updateResult.record);
     }
     for (const nodeCtxChild of nodeCtxChildren) {
+        // add nodeCtxChild and its descendants to nodesUpdated
         updateDescendantsApplicability({
             updateResult,
             nodeCtxChild,
@@ -156,9 +171,12 @@ const updateSelfAndDependentsApplicable = (params) => __awaiter(void 0, void 0,
     const { survey, record, node, sideEffect = false } = params;
     const updateResult = new recordUpdateResult_1.RecordUpdateResult({ record });
     const recordUpdateOptions = { sideEffect };
+    // 1. fetch dependent nodes
     const nodePointersToUpdate = extractNodePointersToUpdate({ survey, record, node });
+    // 2. update expr to node and dependent nodes
+    // NOTE: don't do it in parallel, same nodeCtx metadata could be overwritten
     for (const nodePointer of nodePointersToUpdate) {
-        yield updateNodePointerApplicability({ params, updateResult, nodePointer, recordUpdateOptions });
+        yield updateNodePointerApplicability({ params, updateResult, nodePointer, recordUpdateOptions }); // NOSONAR
     }
     return updateResult;
 });

package/dist/record/recordNodesUpdater/recordNodeDependentsApplicableUpdater.js.map

@@ -1 +1 @@
-{"version":3,"file":"recordNodeDependentsApplicableUpdater.js","sourceRoot":"","sources":["../../../src/record/recordNodesUpdater/recordNodeDependentsApplicableUpdater.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"recordNodeDependentsApplicableUpdater.js","sourceRoot":"","sources":["../../../src/record/recordNodesUpdater/recordNodeDependentsApplicableUpdater.ts"],"names":[],"mappings":"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","sourcesContent":["import { Node, NodePointer, Nodes } from '../../node'\nimport { NodeDefEntity, NodeDefs } from '../../nodeDef'\nimport { Surveys } from '../../survey'\nimport { Survey, SurveyDependencyType } from '../../survey/survey'\nimport { Record } from '../record'\nimport { RecordExpressionEvaluator } from '../recordExpressionEvaluator'\nimport { Records, RecordUpdateOptions } from '../records'\nimport { createOrDeleteEnumeratedEntities } from './recordNodeDependentsEnumeratedEntitiesUpdater'\nimport { syncEnumeratingItemsEntities } from './recordNodeDependentsEnumeratingItemsUpdater'\nimport { createNodeAndDescendants } from './recordNodesCreator'\nimport { deleteNodes } from './recordNodesDeleter'\nimport { getDependentNodePointersByType } from './recordNodesDependentsUpdaterCommons'\nimport { RecordNodeDependentsUpdateParams } from './recordNodeDependentsUpdateParams'\nimport { RecordUpdateResult } from './recordUpdateResult'\n\nconst expressionEvaluator = new RecordExpressionEvaluator()\n\nconst extractNodePointersToUpdate = (params: { survey: Survey; record: Record; node: Node }) => {\n  const { survey, record, node } = params\n\n  const nodePointersToUpdate = getDependentNodePointersByType({\n    survey,\n    record,\n    node,\n    dependencyType: SurveyDependencyType.applicable,\n    includeSelfWhenSourceIsAttribute: true,\n    includeNewEntityChildPointers: true,\n  })\n  return nodePointersToUpdate\n}\n\nconst calculateApplicableNext = async ({\n  params,\n  updateResult,\n  nodePointer,\n  nodeCtx,\n}: {\n  params: RecordNodeDependentsUpdateParams\n  updateResult: RecordUpdateResult\n  nodePointer: NodePointer\n  nodeCtx: Node\n}): Promise<boolean | undefined> => {\n  const { nodeDef: nodeDefNodePointer } = nodePointer\n\n  const { uuid: nodeDefUuid } = nodeDefNodePointer\n\n  const applicablePrev = Nodes.isChildApplicable(nodeCtx, nodeDefUuid)\n  const expressionsToEvaluate = NodeDefs.getApplicable(nodeDefNodePointer)\n  if (expressionsToEvaluate.length === 0) {\n    if (applicablePrev) {\n      // skip nodes that were already applicable and have no applicable expression, as they will remain applicable\n      return undefined\n    } else {\n      // used during survey publishing: node def could have had applicable expression(s) that were removed,\n      // and node could have been not applicable, but now it should be applicable, as there are no more applicable expressions\n      return true\n    }\n  } else {\n    // 3. evaluate applicable expression\n    const exprEval = await expressionEvaluator.evalApplicableExpression({\n      ...params,\n      record: updateResult.record,\n      nodeCtx,\n      expressions: expressionsToEvaluate,\n    })\n    return exprEval?.value || false\n  }\n}\n\nconst updateDescendantsApplicability = ({\n  updateResult,\n  nodeCtxChild,\n  applicable,\n  params,\n  recordUpdateOptions,\n}: {\n  updateResult: RecordUpdateResult\n  nodeCtxChild: Node\n  applicable: boolean\n  params: RecordNodeDependentsUpdateParams\n  recordUpdateOptions: RecordUpdateOptions\n}): void => {\n  const { survey, sideEffect = false, clearNonApplicableValues = false } = params\n\n  // only values entered by the user are reported as cleared (they need a confirmation)\n  let userValuesCleared = false\n\n  Records.visitDescendantsAndSelf({\n    record: updateResult.record,\n    node: nodeCtxChild,\n    visitor: (nodeDescendant): boolean => {\n      const nodeDescendantCleared = clearNonApplicableValues && !applicable && Nodes.isValueNotBlank(nodeDescendant)\n      // values set by expressions (default values, read only attributes) are applied again when applicable: not reported\n      // (evaluated before clearing the value: with sideEffect the node is modified in place)\n      const nodeDescendantDef = Surveys.getNodeDefByUuid({ survey, uuid: nodeDescendant.nodeDefUuid })\n      const userValueCleared =\n        nodeDescendantCleared && !NodeDefs.isReadOnly(nodeDescendantDef) && Nodes.hasUserInputValue(nodeDescendant)\n      // Clear value if becoming non-applicable and parameter is enabled\n      const nodeDescendantUpdated = nodeDescendantCleared\n        ? Nodes.assocValue(nodeDescendant, null, sideEffect)\n        : nodeDescendant\n      updateResult.addNode(nodeDescendantUpdated, recordUpdateOptions)\n      if (userValueCleared) {\n        updateResult.addClearedDefUuid(nodeDescendant.nodeDefUuid)\n        userValuesCleared = true\n      }\n      return false\n    },\n  })\n\n  // if a multiple entity became not applicable and it's empty, delete it instead of just marking descendants as not applicable\n  if (!applicable && clearNonApplicableValues) {\n    const { uuid: nodeCtxChildUuid, nodeDefUuid: nodeCtxChildDefUuid } = nodeCtxChild\n    const nodeCtxChildDef = Surveys.getNodeDefByUuid({ survey, uuid: nodeCtxChildDefUuid })\n    if (NodeDefs.isMultipleEntity(nodeCtxChildDef) && Records.isNodeEmpty(nodeCtxChild)(updateResult.record)) {\n      const deleteResult = deleteNodes([nodeCtxChildUuid], recordUpdateOptions)(updateResult.record)\n      updateResult.merge(deleteResult)\n      if (userValuesCleared) {\n        updateResult.addClearedDefUuid(nodeCtxChildDefUuid)\n      }\n    }\n  }\n}\n\nconst createMissingApplicableMultipleEntities = async ({\n  params,\n  updateResult,\n  parentNode,\n  nodeDef,\n}: {\n  params: RecordNodeDependentsUpdateParams\n  updateResult: RecordUpdateResult\n  parentNode: Node\n  nodeDef: NodeDefEntity\n}): Promise<void> => {\n  if (!NodeDefs.isAutoCreateMinCountItems(nodeDef)) return\n\n  const minCount = Nodes.getChildrenMinCount({ parentNode, nodeDef })\n  if (Number.isNaN(minCount) || minCount <= 0) return\n\n  const existingChildren = Records.getChildren(parentNode, nodeDef.uuid)(updateResult.record)\n  const missingCount = Math.max(0, minCount - existingChildren.length)\n\n  for (let index = 0; index < missingCount; index++) {\n    const createParams = { ...params, record: updateResult.record, parentNode, nodeDef }\n    // create nodes sequentially: every iteration works on the record updated by the previous one\n    const childUpdateResult = await createNodeAndDescendants(createParams) // NOSONAR\n    updateResult.merge(childUpdateResult)\n  }\n}\n\nconst updateNodePointerApplicability = async ({\n  params,\n  updateResult,\n  nodePointer,\n  recordUpdateOptions,\n}: {\n  params: RecordNodeDependentsUpdateParams\n  updateResult: RecordUpdateResult\n  nodePointer: NodePointer\n  recordUpdateOptions: RecordUpdateOptions\n}): Promise<void> => {\n  const { nodeCtx: nodeCtxNodePointer, nodeDef: nodeDefNodePointer } = nodePointer\n\n  const nodeCtxUuid = nodeCtxNodePointer.uuid\n  const nodeDefUuid = nodeDefNodePointer.uuid\n\n  // nodeCtx could have been updated in a previous iteration\n  const nodeCtx = updateResult.getNodeByUuid(nodeCtxUuid) ?? nodeCtxNodePointer\n\n  const applicablePrev = Nodes.isChildApplicable(nodeCtx, nodeDefUuid)\n  const applicable = await calculateApplicableNext({\n    params,\n    updateResult,\n    nodePointer,\n    nodeCtx,\n  })\n  if (applicable === undefined) {\n    return\n  }\n\n  if (applicable && NodeDefs.isMultipleEntity(nodeDefNodePointer)) {\n    await createMissingApplicableMultipleEntities({\n      params,\n      updateResult,\n      parentNode: nodeCtx,\n      nodeDef: nodeDefNodePointer as NodeDefEntity,\n    })\n  }\n\n  // 4. persist updated applicability if changed, and return updated nodes\n  if (applicablePrev === applicable) {\n    return\n  }\n  // Applicability changed\n\n  // update node and add it to nodes updated\n  const nodeCtxUpdated = Nodes.assocChildApplicability(nodeCtx, nodeDefUuid, applicable)\n  updateResult.addNode(nodeCtxUpdated, recordUpdateOptions)\n\n  let nodeCtxChildren = Records.getChildren(nodeCtx, nodeDefUuid)(updateResult.record)\n\n  if (NodeDefs.isMultipleEntity(nodeDefNodePointer) && NodeDefs.isEnumerate(nodeDefNodePointer as NodeDefEntity)) {\n    const entityDef = nodeDefNodePointer as NodeDefEntity\n    if (NodeDefs.getEnumeratingItemsExpression(entityDef)) {\n      await syncEnumeratingItemsEntities({\n        ...params,\n        parentNode: nodeCtxUpdated,\n        entityDef,\n        updateResult,\n      })\n    } else {\n      await createOrDeleteEnumeratedEntities({\n        ...params,\n        parentNode: nodeCtxUpdated,\n        entityDef,\n        updateResult,\n      })\n    }\n    nodeCtxChildren = Records.getChildren(nodeCtx, nodeDefUuid)(updateResult.record)\n  }\n  for (const nodeCtxChild of nodeCtxChildren) {\n    // add nodeCtxChild and its descendants to nodesUpdated\n    updateDescendantsApplicability({\n      updateResult,\n      nodeCtxChild,\n      applicable,\n      params,\n      recordUpdateOptions,\n    })\n  }\n}\n\nexport const updateSelfAndDependentsApplicable = async (\n  params: RecordNodeDependentsUpdateParams\n): Promise<RecordUpdateResult> => {\n  const { survey, record, node, sideEffect = false } = params\n\n  const updateResult = new RecordUpdateResult({ record })\n\n  const recordUpdateOptions: RecordUpdateOptions = { sideEffect }\n\n  // 1. fetch dependent nodes\n  const nodePointersToUpdate = extractNodePointersToUpdate({ survey, record, node })\n\n  // 2. update expr to node and dependent nodes\n  // NOTE: don't do it in parallel, same nodeCtx metadata could be overwritten\n  for (const nodePointer of nodePointersToUpdate) {\n    await updateNodePointerApplicability({ params, updateResult, nodePointer, recordUpdateOptions }) // NOSONAR\n  }\n  return updateResult\n}\n"]}

package/dist/record/recordNodesUpdater/recordNodeDependentsBooleanUpdater.js

@@ -41,6 +41,7 @@ const updateSelfAndDependentsBoolean = (_a) => __awaiter(void 0, [_a], void 0, f
         includeNewEntitySelf,
         includeNewEntityChildPointers: true,
     });
+    // NOTE: don't do it in parallel, same nodeCtx metadata could be overwritten
     for (const nodePointer of nodePointersToUpdate) {
         const { nodeCtx: nodeCtxNodePointer, nodeDef: nodeDefNodePointer } = nodePointer;
         const nodeCtxUuid = nodeCtxNodePointer.uuid;
@@ -48,7 +49,7 @@ const updateSelfAndDependentsBoolean = (_a) => __awaiter(void 0, [_a], void 0, f
         const nodeCtx = (_b = updateResult.getNodeByUuid(nodeCtxUuid)) !== null && _b !== void 0 ? _b : nodeCtxNodePointer;
         const valuePrev = getValuePrev(nodeCtx, nodeDefUuid);
         const calculateParams = { params, updateResult, nodePointer, nodeCtx, getExpressions, getValuePrev };
-        const value = yield calculateBooleanValueNext(calculateParams);
+        const value = yield calculateBooleanValueNext(calculateParams); // NOSONAR
         if (value === undefined || valuePrev === value) {
             continue;
         }

package/dist/record/recordNodesUpdater/recordNodeDependentsBooleanUpdater.js.map

@@ -1 +1 @@
-{"version":3,"file":"recordNodeDependentsBooleanUpdater.js","sourceRoot":"","sources":["../../../src/record/recordNodesUpdater/recordNodeDependentsBooleanUpdater.ts"],"names":[],"mappings":";;;;;;;;;;;;AAGA,4EAAwE;AACxE,+FAAsF;AAEtF,6DAAyD;AAEzD,MAAM,mBAAmB,GAAG,IAAI,qDAAyB,EAAE,CAAA;AAW3D,MAAM,yBAAyB,GAAG,KAcD,EAAE,4CAdM,EACvC,MAAM,EACN,YAAY,EACZ,WAAW,EACX,OAAO,EACP,cAAc,EACd,YAAY,GAQb;IACC,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,WAAW,CAAA;IACnD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,kBAAkB,CAAA;IAEhD,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;IACpD,MAAM,qBAAqB,GAAG,cAAc,CAAC,WAAW,CAAC,CAAA;IACzD,IAAI,qBAAqB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,wBAAwB,iCAC9D,MAAM,KACT,MAAM,EAAE,YAAY,CAAC,MAAM,EAC3B,OAAO,EACP,WAAW,EAAE,qBAAqB,IAClC,CAAA;IACF,OAAO,CAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,KAAK,KAAI,KAAK,CAAA;AACjC,CAAC,CAAA,CAAA;AAEM,MAAM,8BAA8B,GAAG,KAOwB,EAAE,4CAPnB,EACnD,MAAM,EACN,cAAc,EACd,cAAc,EACd,YAAY,EACZ,UAAU,EACV,oBAAoB,GAAG,IAAI,GACU;;IACrC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,KAAK,EAAE,GAAG,MAAM,CAAA;IAC3D,MAAM,YAAY,GAAG,IAAI,uCAAkB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IAEvD,MAAM,oBAAoB,GAAG,IAAA,oEAA8B,EAAC;QAC1D,MAAM;QACN,MAAM;QACN,IAAI;QACJ,cAAc;QACd,gCAAgC,EAAE,IAAI;QACtC,oBAAoB;QACpB,6BAA6B,EAAE,IAAI;KACpC,CAAC,CAAA;IAGF,KAAK,MAAM,WAAW,IAAI,oBAAoB,EAAE,CAAC;QAC/C,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,WAAW,CAAA;QAEhF,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAA;QAC3C,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAA;QAE3C,MAAM,OAAO,GAAG,MAAA,YAAY,CAAC,aAAa,CAAC,WAAW,CAAC,mCAAI,kBAAkB,CAAA;QAE7E,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;QACpD,MAAM,eAAe,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,CAAA;QACpG,MAAM,KAAK,GAAG,MAAM,yBAAyB,CAAC,eAAe,CAAC,CAAA;QAE9D,IAAI,KAAK,KAAK,SAAS,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;YAC/C,SAAQ;QACV,CAAC;QAED,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,CAAC,CAAA;QAC1E,YAAY,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,UAAU,EAAE,CAAC,CAAA;IACtD,CAAC;IAED,OAAO,YAAY,CAAA;AACrB,CAAC,CAAA,CAAA;AA3CY,QAAA,8BAA8B,kCA2C1C"}
+{"version":3,"file":"recordNodeDependentsBooleanUpdater.js","sourceRoot":"","sources":["../../../src/record/recordNodesUpdater/recordNodeDependentsBooleanUpdater.ts"],"names":[],"mappings":";;;;;;;;;;;;AAGA,4EAAwE;AACxE,+FAAsF;AAEtF,6DAAyD;AAEzD,MAAM,mBAAmB,GAAG,IAAI,qDAAyB,EAAE,CAAA;AAW3D,MAAM,yBAAyB,GAAG,KAcD,EAAE,4CAdM,EACvC,MAAM,EACN,YAAY,EACZ,WAAW,EACX,OAAO,EACP,cAAc,EACd,YAAY,GAQb;IACC,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,WAAW,CAAA;IACnD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,kBAAkB,CAAA;IAEhD,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;IACpD,MAAM,qBAAqB,GAAG,cAAc,CAAC,WAAW,CAAC,CAAA;IACzD,IAAI,qBAAqB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,wBAAwB,iCAC9D,MAAM,KACT,MAAM,EAAE,YAAY,CAAC,MAAM,EAC3B,OAAO,EACP,WAAW,EAAE,qBAAqB,IAClC,CAAA;IACF,OAAO,CAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,KAAK,KAAI,KAAK,CAAA;AACjC,CAAC,CAAA,CAAA;AAEM,MAAM,8BAA8B,GAAG,KAOwB,EAAE,4CAPnB,EACnD,MAAM,EACN,cAAc,EACd,cAAc,EACd,YAAY,EACZ,UAAU,EACV,oBAAoB,GAAG,IAAI,GACU;;IACrC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,KAAK,EAAE,GAAG,MAAM,CAAA;IAC3D,MAAM,YAAY,GAAG,IAAI,uCAAkB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IAEvD,MAAM,oBAAoB,GAAG,IAAA,oEAA8B,EAAC;QAC1D,MAAM;QACN,MAAM;QACN,IAAI;QACJ,cAAc;QACd,gCAAgC,EAAE,IAAI;QACtC,oBAAoB;QACpB,6BAA6B,EAAE,IAAI;KACpC,CAAC,CAAA;IAEF,4EAA4E;IAC5E,KAAK,MAAM,WAAW,IAAI,oBAAoB,EAAE,CAAC;QAC/C,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,WAAW,CAAA;QAEhF,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAA;QAC3C,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAA;QAE3C,MAAM,OAAO,GAAG,MAAA,YAAY,CAAC,aAAa,CAAC,WAAW,CAAC,mCAAI,kBAAkB,CAAA;QAE7E,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;QACpD,MAAM,eAAe,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,CAAA;QACpG,MAAM,KAAK,GAAG,MAAM,yBAAyB,CAAC,eAAe,CAAC,CAAA,CAAC,UAAU;QAEzE,IAAI,KAAK,KAAK,SAAS,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;YAC/C,SAAQ;QACV,CAAC;QAED,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,CAAC,CAAA;QAC1E,YAAY,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,UAAU,EAAE,CAAC,CAAA;IACtD,CAAC;IAED,OAAO,YAAY,CAAA;AACrB,CAAC,CAAA,CAAA;AA3CY,QAAA,8BAA8B,kCA2C1C","sourcesContent":["import { Node, NodePointer } from '../../node'\nimport { NodeDefExpression } from '../../nodeDef'\nimport { SurveyDependencyType } from '../../survey/survey'\nimport { RecordExpressionEvaluator } from '../recordExpressionEvaluator'\nimport { getDependentNodePointersByType } from './recordNodesDependentsUpdaterCommons'\nimport { RecordNodeDependentsUpdateParams } from './recordNodeDependentsUpdateParams'\nimport { RecordUpdateResult } from './recordUpdateResult'\n\nconst expressionEvaluator = new RecordExpressionEvaluator()\n\ntype UpdateSelfAndDependentsBooleanParams = {\n  params: RecordNodeDependentsUpdateParams\n  dependencyType: SurveyDependencyType\n  getExpressions: (nodePointer: NodePointer) => NodeDefExpression[]\n  getValuePrev: (nodeCtx: Node, nodeDefUuid: string) => boolean\n  assocValue: (nodeCtx: Node, nodeDefUuid: string, value: boolean, sideEffect: boolean) => Node\n  includeNewEntitySelf?: boolean\n}\n\nconst calculateBooleanValueNext = async ({\n  params,\n  updateResult,\n  nodePointer,\n  nodeCtx,\n  getExpressions,\n  getValuePrev,\n}: {\n  params: RecordNodeDependentsUpdateParams\n  updateResult: RecordUpdateResult\n  nodePointer: NodePointer\n  nodeCtx: Node\n  getExpressions: (nodePointer: NodePointer) => NodeDefExpression[]\n  getValuePrev: (nodeCtx: Node, nodeDefUuid: string) => boolean\n}): Promise<boolean | undefined> => {\n  const { nodeDef: nodeDefNodePointer } = nodePointer\n  const { uuid: nodeDefUuid } = nodeDefNodePointer\n\n  const valuePrev = getValuePrev(nodeCtx, nodeDefUuid)\n  const expressionsToEvaluate = getExpressions(nodePointer)\n  if (expressionsToEvaluate.length === 0) {\n    if (valuePrev) {\n      return undefined\n    }\n    return true\n  }\n\n  const exprEval = await expressionEvaluator.evalApplicableExpression({\n    ...params,\n    record: updateResult.record,\n    nodeCtx,\n    expressions: expressionsToEvaluate,\n  })\n  return exprEval?.value || false\n}\n\nexport const updateSelfAndDependentsBoolean = async ({\n  params,\n  dependencyType,\n  getExpressions,\n  getValuePrev,\n  assocValue,\n  includeNewEntitySelf = true,\n}: UpdateSelfAndDependentsBooleanParams): Promise<RecordUpdateResult> => {\n  const { survey, record, node, sideEffect = false } = params\n  const updateResult = new RecordUpdateResult({ record })\n\n  const nodePointersToUpdate = getDependentNodePointersByType({\n    survey,\n    record,\n    node,\n    dependencyType,\n    includeSelfWhenSourceIsAttribute: true,\n    includeNewEntitySelf,\n    includeNewEntityChildPointers: true,\n  })\n\n  // NOTE: don't do it in parallel, same nodeCtx metadata could be overwritten\n  for (const nodePointer of nodePointersToUpdate) {\n    const { nodeCtx: nodeCtxNodePointer, nodeDef: nodeDefNodePointer } = nodePointer\n\n    const nodeCtxUuid = nodeCtxNodePointer.uuid\n    const nodeDefUuid = nodeDefNodePointer.uuid\n\n    const nodeCtx = updateResult.getNodeByUuid(nodeCtxUuid) ?? nodeCtxNodePointer\n\n    const valuePrev = getValuePrev(nodeCtx, nodeDefUuid)\n    const calculateParams = { params, updateResult, nodePointer, nodeCtx, getExpressions, getValuePrev }\n    const value = await calculateBooleanValueNext(calculateParams) // NOSONAR\n\n    if (value === undefined || valuePrev === value) {\n      continue\n    }\n\n    const nodeCtxUpdated = assocValue(nodeCtx, nodeDefUuid, value, sideEffect)\n    updateResult.addNode(nodeCtxUpdated, { sideEffect })\n  }\n\n  return updateResult\n}\n"]}

package/dist/record/recordNodesUpdater/recordNodeDependentsCodeAttributesUpdater.js

@@ -16,6 +16,15 @@ const survey_1 = require("../../survey");
 const utils_1 = require("../../utils");
 const records_1 = require("../records");
 const recordUpdateResult_1 = require("./recordUpdateResult");
+// A dependent code attribute's stored item is still valid as long as its category item's parent is the
+// (possibly unchanged) item currently selected on the parent code attribute node - so this single check
+// covers both "did the parent's value change" and "is the dependent's value still valid": if the parent's
+// item didn't change, the dependent's item still has the same parent and is left alone.
+//
+// The dependent's item may belong to a "big" category whose items aren't loaded into the survey's
+// in-memory ref data index (e.g. an externally-referenced category) - Surveys.getCategoryItemByUuid only
+// ever looks there, so it falls back to the async categoryItemProvider (same pattern as attribute value
+// validation) before concluding the item doesn't exist.
 const isDependentCodeAttributeValueStillValid = (params) => __awaiter(void 0, void 0, void 0, function* () {
     const { survey, parentItemUuid, dependentCodeAttribute, dependentCodeAttributeDef, record, categoryItemProvider } = params;
     if (!parentItemUuid)
@@ -42,10 +51,12 @@ const updateDependentCodeAttributes = (params) => __awaiter(void 0, void 0, void
     const { survey, record, node, categoryItemProvider, sideEffect = false } = params;
     const updateResult = new recordUpdateResult_1.RecordUpdateResult({ record });
     const recordUpdateOptions = { sideEffect };
+    // 1. get dependent code attributes
     const dependentCodeAttributes = records_1.Records.getDependentCodeAttributes(node)(record);
     if (dependentCodeAttributes.length === 0)
         return updateResult;
     const parentItemUuid = node_1.NodeValues.getItemUuid(node);
+    // 2. clear dependent code attributes' values that are no longer valid children of the parent's current item
     for (const dependentCodeAttribute of dependentCodeAttributes) {
         const dependentCodeAttributeDef = survey_1.Surveys.getNodeDefByUuid({
             survey,
@@ -61,7 +72,8 @@ const updateDependentCodeAttributes = (params) => __awaiter(void 0, void 0, void
             record,
             categoryItemProvider,
         };
-        const stillValid = yield isDependentCodeAttributeValueStillValid(validityCheckParams);
+        // check attributes sequentially: invalid values are cleared in the record at every iteration
+        const stillValid = yield isDependentCodeAttributeValueStillValid(validityCheckParams); // NOSONAR
         if (stillValid)
             continue;
         const nodeUpdated = Object.assign(Object.assign({}, dependentCodeAttribute), { value: null, updated: true, dateModified: utils_1.Dates.nowFormattedForStorage() });

package/dist/record/recordNodesUpdater/recordNodeDependentsCodeAttributesUpdater.js.map

@@ -1 +1 @@
-{"version":3,"file":"recordNodeDependentsCodeAttributesUpdater.js","sourceRoot":"","sources":["../../../src/record/recordNodesUpdater/recordNodeDependentsCodeAttributesUpdater.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"recordNodeDependentsCodeAttributesUpdater.js","sourceRoot":"","sources":["../../../src/record/recordNodesUpdater/recordNodeDependentsCodeAttributesUpdater.ts"],"names":[],"mappings":"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","sourcesContent":["import { Node, NodeValues, Nodes } from '../../node'\nimport { NodeDefCode, NodeDefs } from '../../nodeDef'\nimport { Surveys } from '../../survey'\nimport { Dates } from '../../utils'\nimport { Records } from '../records'\nimport type { ArenaRecord } from '../record'\nimport { RecordNodeDependentsUpdateParams } from './recordNodeDependentsUpdateParams'\nimport { RecordUpdateResult } from './recordUpdateResult'\n\n// A dependent code attribute's stored item is still valid as long as its category item's parent is the\n// (possibly unchanged) item currently selected on the parent code attribute node - so this single check\n// covers both \"did the parent's value change\" and \"is the dependent's value still valid\": if the parent's\n// item didn't change, the dependent's item still has the same parent and is left alone.\n//\n// The dependent's item may belong to a \"big\" category whose items aren't loaded into the survey's\n// in-memory ref data index (e.g. an externally-referenced category) - Surveys.getCategoryItemByUuid only\n// ever looks there, so it falls back to the async categoryItemProvider (same pattern as attribute value\n// validation) before concluding the item doesn't exist.\nconst isDependentCodeAttributeValueStillValid = async (\n  params: Pick<RecordNodeDependentsUpdateParams, 'survey' | 'categoryItemProvider'> & {\n    parentItemUuid?: string\n    dependentCodeAttribute: Node\n    dependentCodeAttributeDef: NodeDefCode\n    record: ArenaRecord\n  }\n): Promise<boolean> => {\n  const { survey, parentItemUuid, dependentCodeAttribute, dependentCodeAttributeDef, record, categoryItemProvider } =\n    params\n  if (!parentItemUuid) return false\n\n  const dependentItemUuid = NodeValues.getItemUuid(dependentCodeAttribute)\n  if (!dependentItemUuid) return false\n\n  let dependentItem = Surveys.getCategoryItemByUuid({ survey, itemUuid: dependentItemUuid })\n  if (!dependentItem && categoryItemProvider) {\n    const categoryUuid = NodeDefs.getCategoryUuid(dependentCodeAttributeDef)\n    if (categoryUuid) {\n      const draft = !!record.preview\n      dependentItem = await categoryItemProvider.getItemByUuid({\n        survey,\n        categoryUuid,\n        itemUuid: dependentItemUuid,\n        draft,\n      })\n    }\n  }\n  return dependentItem?.parentUuid === parentItemUuid\n}\n\nexport const updateDependentCodeAttributes = async (params: RecordNodeDependentsUpdateParams) => {\n  const { survey, record, node, categoryItemProvider, sideEffect = false } = params\n\n  const updateResult = new RecordUpdateResult({ record })\n\n  const recordUpdateOptions = { sideEffect }\n\n  // 1. get dependent code attributes\n  const dependentCodeAttributes = Records.getDependentCodeAttributes(node)(record)\n  if (dependentCodeAttributes.length === 0) return updateResult\n\n  const parentItemUuid = NodeValues.getItemUuid(node)\n\n  // 2. clear dependent code attributes' values that are no longer valid children of the parent's current item\n  for (const dependentCodeAttribute of dependentCodeAttributes) {\n    const dependentCodeAttributeDef = Surveys.getNodeDefByUuid({\n      survey,\n      uuid: dependentCodeAttribute.nodeDefUuid,\n    }) as NodeDefCode\n    if (NodeDefs.isReadOnly(dependentCodeAttributeDef) || !Nodes.hasUserInputValue(dependentCodeAttribute)) continue\n\n    const validityCheckParams = {\n      survey,\n      parentItemUuid,\n      dependentCodeAttribute,\n      dependentCodeAttributeDef,\n      record,\n      categoryItemProvider,\n    }\n    // check attributes sequentially: invalid values are cleared in the record at every iteration\n    const stillValid = await isDependentCodeAttributeValueStillValid(validityCheckParams) // NOSONAR\n    if (stillValid) continue\n\n    const nodeUpdated: Node = {\n      ...dependentCodeAttribute,\n      value: null,\n      updated: true,\n      dateModified: Dates.nowFormattedForStorage(),\n    }\n    updateResult.addNode(nodeUpdated, recordUpdateOptions)\n    updateResult.addClearedDefUuid(nodeUpdated.nodeDefUuid)\n  }\n\n  return updateResult\n}\n"]}

package/dist/record/recordNodesUpdater/recordNodeDependentsCountUpdater.js

@@ -23,6 +23,7 @@ const updateDependentsCount = (params) => __awaiter(void 0, void 0, void 0, func
     const { survey, record, node, countType, sideEffect = false } = params;
     const updateResult = new recordUpdateResult_1.RecordUpdateResult({ record });
     const recordUpdateOptions = { sideEffect };
+    // 1. fetch dependent nodes
     const dependencyType = countType === nodeDef_1.NodeDefCountType.max ? survey_1.SurveyDependencyType.maxCount : survey_1.SurveyDependencyType.minCount;
     const nodePointersToUpdate = records_1.Records.getDependentNodePointers({
         survey,
@@ -30,18 +31,25 @@ const updateDependentsCount = (params) => __awaiter(void 0, void 0, void 0, func
         node,
         dependencyType,
     });
+    // 2. update expr to node and dependent nodes
+    // NOTE: don't do it in parallel, same nodeCtx metadata could be overwritten
     for (const nodePointer of nodePointersToUpdate) {
         const { nodeCtx: nodeCtxNodePointer, nodeDef: nodeDefNodePointer } = nodePointer;
         const expressionsToEvaluate = nodeDef_1.NodeDefs.getCount(nodeDefNodePointer, countType);
         if (utils_1.Objects.isEmpty(expressionsToEvaluate) || !Array.isArray(expressionsToEvaluate))
             continue;
+        // 3. evaluate applicable expression
         const nodeCtxUuid = nodeCtxNodePointer.uuid;
+        // nodeCtx could have been updated in a previous iteration
         const nodeCtx = (_a = updateResult.getNodeByUuid(nodeCtxUuid)) !== null && _a !== void 0 ? _a : nodeCtxNodePointer;
         const evaluateParams = Object.assign(Object.assign({}, params), { record: updateResult.record, nodeCtx, expressions: expressionsToEvaluate });
-        const countResult = yield expressionEvaluator.evalApplicableExpression(evaluateParams);
+        const countResult = yield expressionEvaluator.evalApplicableExpression(evaluateParams); // NOSONAR
         const count = Number(countResult === null || countResult === void 0 ? void 0 : countResult.value);
+        // 4. persist updated count if changed, and return updated nodes
         const nodeDefUuid = nodeDefNodePointer.uuid;
         if (node_1.Nodes.getChildrenMinOrMaxCount({ parentNode: nodeCtx, nodeDef: nodeDefNodePointer, countType }) !== count) {
+            // count changed
+            // 5. update node and add it to nodes updated
             const nodeCtxUpdated = node_1.Nodes.assocChildrenCount({ node: nodeCtx, nodeDefUuid, count, countType });
             updateResult.addNode(nodeCtxUpdated, recordUpdateOptions);
         }

package/dist/record/recordNodesUpdater/recordNodeDependentsCountUpdater.js.map

@@ -1 +1 @@
-{"version":3,"file":"recordNodeDependentsCountUpdater.js","sourceRoot":"","sources":["../../../src/record/recordNodesUpdater/recordNodeDependentsCountUpdater.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qCAAkC;AAClC,2CAA0D;AAC1D,yCAAmD;AACnD,uCAAqC;AACrC,4EAAwE;AACxE,wCAAoC;AAEpC,6DAAyD;AAEzD,MAAM,mBAAmB,GAAG,IAAI,qDAAyB,EAAE,CAAA;AAEpD,MAAM,qBAAqB,GAAG,CACnC,MAEC,EAC4B,EAAE;;IAC/B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,GAAG,KAAK,EAAE,GAAG,MAAM,CAAA;IAEtE,MAAM,YAAY,GAAG,IAAI,uCAAkB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IAEvD,MAAM,mBAAmB,GAAG,EAAE,UAAU,EAAE,CAAA;IAG1C,MAAM,cAAc,GAClB,SAAS,KAAK,0BAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,6BAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC,6BAAoB,CAAC,QAAQ,CAAA;IAEpG,MAAM,oBAAoB,GAAG,iBAAO,CAAC,wBAAwB,CAAC;QAC5D,MAAM;QACN,MAAM;QACN,IAAI;QACJ,cAAc;KACf,CAAC,CAAA;IAIF,KAAK,MAAM,WAAW,IAAI,oBAAoB,EAAE,CAAC;QAC/C,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,WAAW,CAAA;QAEhF,MAAM,qBAAqB,GAAG,kBAAQ,CAAC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAA;QAC9E,IAAI,eAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,qBAAqB,CAAC;YAAE,SAAQ;QAG7F,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAA;QAE3C,MAAM,OAAO,GAAG,MAAA,YAAY,CAAC,aAAa,CAAC,WAAW,CAAC,mCAAI,kBAAkB,CAAA;QAE7E,MAAM,cAAc,mCAAQ,MAAM,KAAE,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,qBAAqB,GAAE,CAAA;QAC9G,MAAM,WAAW,GAAG,MAAM,mBAAmB,CAAC,wBAAwB,CAAC,cAAc,CAAC,CAAA;QAEtF,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,KAAK,CAAC,CAAA;QAGxC,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAA;QAE3C,IAAI,YAAK,CAAC,wBAAwB,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC;YAI9G,MAAM,cAAc,GAAG,YAAK,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;YACjG,YAAY,CAAC,OAAO,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAA;QAC3D,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAA;AACrB,CAAC,CAAA,CAAA;AApDY,QAAA,qBAAqB,yBAoDjC"}
+{"version":3,"file":"recordNodeDependentsCountUpdater.js","sourceRoot":"","sources":["../../../src/record/recordNodesUpdater/recordNodeDependentsCountUpdater.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qCAAkC;AAClC,2CAA0D;AAC1D,yCAAmD;AACnD,uCAAqC;AACrC,4EAAwE;AACxE,wCAAoC;AAEpC,6DAAyD;AAEzD,MAAM,mBAAmB,GAAG,IAAI,qDAAyB,EAAE,CAAA;AAEpD,MAAM,qBAAqB,GAAG,CACnC,MAEC,EAC4B,EAAE;;IAC/B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,GAAG,KAAK,EAAE,GAAG,MAAM,CAAA;IAEtE,MAAM,YAAY,GAAG,IAAI,uCAAkB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IAEvD,MAAM,mBAAmB,GAAG,EAAE,UAAU,EAAE,CAAA;IAE1C,2BAA2B;IAC3B,MAAM,cAAc,GAClB,SAAS,KAAK,0BAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,6BAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC,6BAAoB,CAAC,QAAQ,CAAA;IAEpG,MAAM,oBAAoB,GAAG,iBAAO,CAAC,wBAAwB,CAAC;QAC5D,MAAM;QACN,MAAM;QACN,IAAI;QACJ,cAAc;KACf,CAAC,CAAA;IAEF,6CAA6C;IAC7C,4EAA4E;IAC5E,KAAK,MAAM,WAAW,IAAI,oBAAoB,EAAE,CAAC;QAC/C,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,WAAW,CAAA;QAEhF,MAAM,qBAAqB,GAAG,kBAAQ,CAAC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAA;QAC9E,IAAI,eAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,qBAAqB,CAAC;YAAE,SAAQ;QAE7F,oCAAoC;QACpC,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAA;QAC3C,0DAA0D;QAC1D,MAAM,OAAO,GAAG,MAAA,YAAY,CAAC,aAAa,CAAC,WAAW,CAAC,mCAAI,kBAAkB,CAAA;QAE7E,MAAM,cAAc,mCAAQ,MAAM,KAAE,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,qBAAqB,GAAE,CAAA;QAC9G,MAAM,WAAW,GAAG,MAAM,mBAAmB,CAAC,wBAAwB,CAAC,cAAc,CAAC,CAAA,CAAC,UAAU;QAEjG,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,KAAK,CAAC,CAAA;QAExC,gEAAgE;QAChE,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAA;QAE3C,IAAI,YAAK,CAAC,wBAAwB,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC;YAC9G,gBAAgB;YAEhB,6CAA6C;YAC7C,MAAM,cAAc,GAAG,YAAK,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;YACjG,YAAY,CAAC,OAAO,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAA;QAC3D,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAA;AACrB,CAAC,CAAA,CAAA;AApDY,QAAA,qBAAqB,yBAoDjC","sourcesContent":["import { Nodes } from '../../node'\nimport { NodeDefCountType, NodeDefs } from '../../nodeDef'\nimport { SurveyDependencyType } from '../../survey'\nimport { Objects } from '../../utils'\nimport { RecordExpressionEvaluator } from '../recordExpressionEvaluator'\nimport { Records } from '../records'\nimport { RecordNodeDependentsUpdateParams } from './recordNodeDependentsUpdateParams'\nimport { RecordUpdateResult } from './recordUpdateResult'\n\nconst expressionEvaluator = new RecordExpressionEvaluator()\n\nexport const updateDependentsCount = async (\n  params: RecordNodeDependentsUpdateParams & {\n    countType: NodeDefCountType\n  }\n): Promise<RecordUpdateResult> => {\n  const { survey, record, node, countType, sideEffect = false } = params\n\n  const updateResult = new RecordUpdateResult({ record })\n\n  const recordUpdateOptions = { sideEffect }\n\n  // 1. fetch dependent nodes\n  const dependencyType =\n    countType === NodeDefCountType.max ? SurveyDependencyType.maxCount : SurveyDependencyType.minCount\n\n  const nodePointersToUpdate = Records.getDependentNodePointers({\n    survey,\n    record,\n    node,\n    dependencyType,\n  })\n\n  // 2. update expr to node and dependent nodes\n  // NOTE: don't do it in parallel, same nodeCtx metadata could be overwritten\n  for (const nodePointer of nodePointersToUpdate) {\n    const { nodeCtx: nodeCtxNodePointer, nodeDef: nodeDefNodePointer } = nodePointer\n\n    const expressionsToEvaluate = NodeDefs.getCount(nodeDefNodePointer, countType)\n    if (Objects.isEmpty(expressionsToEvaluate) || !Array.isArray(expressionsToEvaluate)) continue\n\n    // 3. evaluate applicable expression\n    const nodeCtxUuid = nodeCtxNodePointer.uuid\n    // nodeCtx could have been updated in a previous iteration\n    const nodeCtx = updateResult.getNodeByUuid(nodeCtxUuid) ?? nodeCtxNodePointer\n\n    const evaluateParams = { ...params, record: updateResult.record, nodeCtx, expressions: expressionsToEvaluate }\n    const countResult = await expressionEvaluator.evalApplicableExpression(evaluateParams) // NOSONAR\n\n    const count = Number(countResult?.value)\n\n    // 4. persist updated count if changed, and return updated nodes\n    const nodeDefUuid = nodeDefNodePointer.uuid\n\n    if (Nodes.getChildrenMinOrMaxCount({ parentNode: nodeCtx, nodeDef: nodeDefNodePointer, countType }) !== count) {\n      // count changed\n\n      // 5. update node and add it to nodes updated\n      const nodeCtxUpdated = Nodes.assocChildrenCount({ node: nodeCtx, nodeDefUuid, count, countType })\n      updateResult.addNode(nodeCtxUpdated, recordUpdateOptions)\n    }\n  }\n  return updateResult\n}\n"]}