@openforis/arena-core 2.3.33 → 2.3.35

package/dist/esm/validation/validatorErrorKeys.js.map

@@ -1 +1 @@
-{"version":3,"file":"validatorErrorKeys.js","sourceRoot":"","sources":["../../../src/validation/validatorErrorKeys.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validatorErrorKeys.js","sourceRoot":"","sources":["../../../src/validation/validatorErrorKeys.ts"],"names":[],"mappings":"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","sourcesContent":["export const ValidatorErrorKeys = {\n  invalidNumber: 'validationErrors:invalidNumber',\n  invalidField: 'validationErrors:invalidField',\n  invalidDate: 'validationErrors:invalidDate',\n  nameDuplicate: 'validationErrors:nameDuplicate',\n  nameCannotBeKeyword: 'validationErrors:nameCannotBeKeyword',\n  nameRequired: 'validationErrors:nameRequired',\n\n  analysis: {\n    labelDefaultLangRequired: 'validationErrors:analysis.labelDefaultLangRequired',\n    chainNodeDefsRequired: 'validationErrors:analysis.processingChain.chainNodeDefsRequired',\n    processingStep: {\n      entityOrCategoryRequired: 'validationErrors:analysis.processingStep.entityOrCategoryRequired',\n      calculationsRequired: 'validationErrors:analysis.processingStep.calculationsRequired',\n      variablesPrevStep: {\n        aggregateFunctionNotSpecified:\n          'validationErrors:analysis.processingStep.variablesPrevStep.aggregateFunctionNotSpecified',\n      },\n    },\n    processingStepCalculation: {\n      attributeRequired: 'validationErrors:analysis.processingStepCalculation.attributeRequired',\n      invalid: 'validationErrors:analysis.processingStepCalculation.invalid',\n    },\n  },\n\n  categoryEdit: {\n    childrenEmpty: 'validationErrors:categoryEdit.childrenEmpty',\n    childrenInvalid: 'validationErrors:categoryEdit.childrenInvalid',\n    codeCannotBeKeyword: 'validationErrors:categoryEdit.codeCannotBeKeyword',\n    codeDuplicate: 'validationErrors:categoryEdit.codeDuplicate',\n    codeRequired: 'validationErrors:categoryEdit.codeRequired',\n    itemExtraPropInvalidNumber: 'validationErrors:categoryEdit.itemExtraPropInvalidNumber',\n    itemExtraPropInvalidGeometryPoint: 'validationErrors:categoryEdit.itemExtraPropInvalidGeometryPoint',\n    itemsInvalid: 'validationErrors:categoryEdit.itemsInvalid',\n    itemsEmpty: 'validationErrors:categoryEdit.itemsEmpty',\n    levelDuplicate: 'validationErrors:categoryEdit.levelDuplicate',\n    levelsInvalid: 'validationErrors:categoryEdit.levelsInvalid',\n  },\n\n  categoryImport: {\n    codeColumnMissing: 'validationErrors:categoryImport.codeColumnMissing',\n    codeDuplicate: 'validationErrors:categoryImport.codeDuplicate',\n    codeRequired: 'validationErrors:categoryImport.codeRequired',\n    columnMissing: 'validationErrors:categoryImport.columnMissing',\n    emptyHeaderFound: 'validationErrors:categoryImport.emptyHeaderFound',\n    emptyFile: 'validationErrors:categoryImport.emptyFile',\n  },\n\n  expressions: {\n    cannotGetChildOfAttribute: 'validationErrors:expressions.cannotGetChildOfAttribute',\n    cannotUseCurrentNode: 'validationErrors:expressions.cannotUseCurrentNode',\n    circularDependencyError: 'validationErrors:expressions.circularDependencyError',\n    expressionInvalid: 'validationErrors:expressions.expressionInvalid',\n    unableToFindNode: 'validationErrors:expressions.unableToFindNode',\n    unableToFindNodeChild: 'validationErrors:expressions.unableToFindNodeChild',\n    unableToFindNodeParent: 'validationErrors:expressions.unableToFindNodeParent',\n    unableToFindNodeSibling: 'validationErrors:expressions.unableToFindNodeSibling',\n  },\n\n  nodeDefEdit: {\n    applyIfDuplicate: 'validationErrors:nodeDefEdit.applyIfDuplicate',\n    applyIfInvalid: 'validationErrors:nodeDefEdit.applyIfInvalid',\n    countMaxMustBePositiveNumber: 'validationErrors:nodeDefEdit.countMaxMustBePositiveNumber',\n    countMinMustBePositiveNumber: 'validationErrors:nodeDefEdit.countMinMustBePositiveNumber',\n    defaultValuesInvalid: 'validationErrors:nodeDefEdit.defaultValuesInvalid',\n    defaultValuesNotSpecified: 'validationErrors:nodeDefEdit.defaultValuesNotSpecified',\n    categoryRequired: 'validationErrors:nodeDefEdit.categoryRequired',\n    childrenEmpty: 'validationErrors:nodeDefEdit.childrenEmpty',\n    entitySourceRequired: 'validationErrors:nodeDefEdit.entitySourceRequired',\n    expressionApplyIfOnlyLastOneCanBeEmpty: 'validationErrors:nodeDefEdit.expressionApplyIfOnlyLastOneCanBeEmpty',\n    expressionDuplicate: 'validationErrors:nodeDefEdit.expressionDuplicate',\n    expressionRequired: 'validationErrors:nodeDefEdit.expressionRequired',\n    formulaInvalid: 'validationErrors:nodeDefEdit.formulaInvalid',\n    keysEmpty: 'validationErrors:nodeDefEdit.keysEmpty',\n    keysExceedingMax: 'validationErrors:nodeDefEdit.keysExceedingMax',\n    nameInvalid: 'validationErrors:nodeDefEdit.nameInvalid',\n    taxonomyRequired: 'validationErrors:nodeDefEdit.taxonomyRequired',\n    validationsInvalid: 'validationErrors:nodeDefEdit.validationsInvalid',\n  },\n\n  record: {\n    keyDuplicate: 'validationErrors:record.keyDuplicate',\n    entityKeyDuplicate: 'validationErrors:record.entityKeyDuplicate',\n    nodesMaxCountExceeded: 'validationErrors:record.nodesMaxCountExceeded',\n    nodesMinCountNotReached: 'validationErrors:record.nodesMinCountNotReached',\n    oneOrMoreInvalidValues: 'validationErrors:record.oneOrMoreInvalidValues',\n    valueInvalid: 'validationErrors:record.valueInvalid',\n    valueRequired: 'validationErrors:record.valueRequired',\n  },\n\n  surveyInfoEdit: {\n    langRequired: 'validationErrors:surveyInfoEdit.langRequired',\n    srsRequired: 'validationErrors:surveyInfoEdit.srsRequired',\n    cyclesRequired: 'validationErrors:surveyInfoEdit.cyclesRequired',\n    cyclesExceedingMax: 'validationErrors:surveyInfoEdit.cyclesExceedingMax',\n    cycleDateStartMandatory: 'validationErrors:surveyInfoEdit.cycleDateStartMandatory',\n    cycleDateStartInvalid: 'validationErrors:surveyInfoEdit.cycleDateStartInvalid',\n    cycleDateStartBeforeDateEnd: 'validationErrors:surveyInfoEdit.cycleDateStartBeforeDateEnd',\n    cycleDateEndInvalid: 'validationErrors:surveyInfoEdit.cycleDateEndInvalid',\n    cycleDateEndMandatoryExceptForLastCycle: 'validationErrors:surveyInfoEdit.cycleDateEndMandatoryExceptForLastCycle',\n    cycleDateStartAfterPrevDateEnd: 'validationErrors:surveyInfoEdit.cycleDateStartAfterPrevDateEnd',\n  },\n\n  taxonomyEdit: {\n    codeDuplicate: 'validationErrors:taxonomyEdit.codeDuplicate',\n    codeRequired: 'validationErrors:taxonomyEdit.codeRequired',\n    familyRequired: 'validationErrors:taxonomyEdit.familyRequired',\n    genusRequired: 'validationErrors:taxonomyEdit.genusRequired',\n    scientificNameDuplicate: 'validationErrors:taxonomyEdit.scientificNameDuplicate',\n    scientificNameRequired: 'validationErrors:taxonomyEdit.scientificNameRequired',\n    taxaEmpty: 'validationErrors:taxonomyEdit.taxaEmpty',\n    vernacularNamesDuplicate: 'validationErrors:taxonomyEdit.vernacularNamesDuplicate',\n  },\n\n  taxonomyImportJob: {\n    missingRequiredColumns: 'validationErrors:taxonomyImportJob.missingRequiredColumns',\n  },\n\n  user: {\n    emailInvalid: 'validationErrors:user.emailInvalid',\n    emailRequired: 'validationErrors:user.emailRequired',\n    emailNotFound: 'validationErrors:user.emailNotFound',\n    groupRequired: 'validationErrors:user.groupRequired',\n    nameRequired: 'validationErrors:user.nameRequired',\n    titleRequired: 'validationErrors:user.titleRequired',\n    passwordRequired: 'validationErrors:user.passwordRequired',\n    passwordInvalid: 'validationErrors:user.passwordInvalid',\n    passwordUnsafe: 'validationErrors:user.passwordUnsafe',\n    passwordsDoNotMatch: 'validationErrors:user.passwordsDoNotMatch',\n\n    userNotFound: 'validationErrors:user.userNotFound',\n    passwordChangeRequired: 'validationErrors:user.passwordChangeRequired',\n  },\n}\n"]}

package/dist/expression/context.d.ts

@@ -3,6 +3,12 @@ export interface ExpressionContext {
     object?: any;
     evaluateToNode?: boolean;
     includeAnalysis?: boolean;
+    /**
+     * client timezone offset in minutes as returned by the Date.getTimezoneOffset function
+     */
     timezoneOffset?: number;
+    /**
+     * language selected in the client app, used by language-aware expression functions (e.g. numberToWords)
+     */
     lang?: LanguageCode;
 }

package/dist/expression/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/expression/context.ts"],"names":[],"mappings":""}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/expression/context.ts"],"names":[],"mappings":"","sourcesContent":["import { LanguageCode } from '../language'\n\nexport interface ExpressionContext {\n  object?: any\n  evaluateToNode?: boolean\n  includeAnalysis?: boolean\n  /**\n   * client timezone offset in minutes as returned by the Date.getTimezoneOffset function\n   */\n  timezoneOffset?: number\n  /**\n   * language selected in the client app, used by language-aware expression functions (e.g. numberToWords)\n   */\n  lang?: LanguageCode\n}\n"]}

package/dist/expression/evaluator.js.map

@@ -1 +1 @@
-{"version":3,"file":"evaluator.js","sourceRoot":"","sources":["../../src/expression/evaluator.ts"],"names":[],"mappings":""}
+{"version":3,"file":"evaluator.js","sourceRoot":"","sources":["../../src/expression/evaluator.ts"],"names":[],"mappings":"","sourcesContent":["import { ExpressionContext } from './context'\nimport { ExpressionFunction } from './function'\nimport { ExpressionNode, ExpressionNodeType } from './node'\n\nexport interface ExpressionEvaluator<C extends ExpressionContext> {\n  functions: { [functionName: string]: ExpressionFunction<C> }\n  evaluate(expression: string, context?: C): Promise<any>\n  evaluateNode(expression: ExpressionNode<ExpressionNodeType>, context: C): Promise<any>\n}\n"]}

package/dist/expression/function.d.ts

@@ -2,8 +2,21 @@ import { ExpressionContext } from './context';
 export interface ExpressionFunction<C extends ExpressionContext> {
     minArity: number;
     maxArity?: number;
+    /**
+     * Returns the function implementation, bound to the specified context.
+     * The implementation can return either the result value or a Promise resolving to it.
+     */
     executor: (context: C) => (...args: any[]) => any;
+    /**
+     * True if the arguments of the function must be evaluated as nodes.
+     * @default false
+     */
     evaluateArgsToNodes?: boolean;
+    /**
+     * True if the result of the evaluation of the function must be a node,
+     * otherwise it will be the node value.
+     * @default false
+     */
     evaluateToNode?: boolean;
 }
 export interface ExpressionFunctions<C extends ExpressionContext> {

package/dist/expression/function.js.map

@@ -1 +1 @@
-{"version":3,"file":"function.js","sourceRoot":"","sources":["../../src/expression/function.ts"],"names":[],"mappings":""}
+{"version":3,"file":"function.js","sourceRoot":"","sources":["../../src/expression/function.ts"],"names":[],"mappings":"","sourcesContent":["import { ExpressionContext } from './context'\n\nexport interface ExpressionFunction<C extends ExpressionContext> {\n  minArity: number\n  maxArity?: number\n  /**\n   * Returns the function implementation, bound to the specified context.\n   * The implementation can return either the result value or a Promise resolving to it.\n   */\n  executor: (context: C) => (...args: any[]) => any\n  /**\n   * True if the arguments of the function must be evaluated as nodes.\n   * @default false\n   */\n  evaluateArgsToNodes?: boolean\n  /**\n   * True if the result of the evaluation of the function must be a node,\n   * otherwise it will be the node value.\n   * @default false\n   */\n  evaluateToNode?: boolean\n}\n\nexport interface ExpressionFunctions<C extends ExpressionContext> {\n  [name: string]: ExpressionFunction<C>\n}\n"]}

package/dist/expression/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/expression/index.ts"],"names":[],"mappings":";;;AAqBA,+BAAoE;AAA3D,0GAAA,kBAAkB,OAAA;AAAE,+GAAA,uBAAuB,OAAA;AAEpD,uCAA+C;AAAtC,8GAAA,kBAAkB,OAAA;AAE3B,oDAAsE;AAA7D,0HAAA,6BAA6B,OAAA;AACtC,qDAAuE;AAA9D,oHAAA,0BAA0B,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/expression/index.ts"],"names":[],"mappings":";;;AAqBA,+BAAoE;AAA3D,0GAAA,kBAAkB,OAAA;AAAE,+GAAA,uBAAuB,OAAA;AAEpD,uCAA+C;AAAtC,8GAAA,kBAAkB,OAAA;AAE3B,oDAAsE;AAA7D,0HAAA,6BAA6B,OAAA;AACtC,qDAAuE;AAA9D,oHAAA,0BAA0B,OAAA","sourcesContent":["export type { ExpressionContext } from './context'\n\nexport type { ExpressionEvaluator } from './evaluator'\n\nexport type { ExpressionFunction, ExpressionFunctions } from './function'\n\nexport type {\n  ExpressionNode,\n  ExpressionNodeEvaluatorConstructor,\n  ArrayExpression,\n  BinaryExpression,\n  CallExpression,\n  CompoundExpression,\n  ConditionalExpression,\n  IdentifierExpression,\n  LiteralExpression,\n  MemberExpression,\n  SequenceExpression,\n  ThisExpression,\n  UnaryExpression,\n} from './node'\nexport { ExpressionNodeType, ExpressionNodeEvaluator } from './node'\n\nexport { ExpressionVariable } from './variable'\n\nexport { JavascriptExpressionEvaluator } from './javascript/evaluator'\nexport { JavascriptExpressionParser } from './javascript/parser/parser'\n"]}

package/dist/expression/javascript/evaluator.d.ts

@@ -5,6 +5,7 @@ import { ExpressionNode, ExpressionNodeEvaluatorConstructor, ExpressionNodeType
 type Evaluators<C extends ExpressionContext> = {
     [nodeType in ExpressionNodeType]?: ExpressionNodeEvaluatorConstructor<C, ExpressionNode<ExpressionNodeType>>;
 };
+export declare const parseExpression: (expression: string) => ExpressionNode<ExpressionNodeType>;
 export declare class JavascriptExpressionEvaluator<C extends ExpressionContext> implements ExpressionEvaluator<C> {
     functions: ExpressionFunctions<C>;
     evaluators: Evaluators<C>;

package/dist/expression/javascript/evaluator.js

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.JavascriptExpressionEvaluator = void 0;
+exports.JavascriptExpressionEvaluator = exports.parseExpression = void 0;
 const node_1 = require("../node");
 const error_1 = require("../../error");
 const functionsDefault_1 = require("./functionsDefault");
@@ -38,6 +38,8 @@ const defaultEvaluators = {
     [node_1.ExpressionNodeType.This]: this_1.ThisEvaluator,
     [node_1.ExpressionNodeType.Unary]: unary_1.UnaryEvaluator,
 };
+// Parsed expressions cache: the same expressions are evaluated many times (e.g. for every node during a record update).
+// The cached expression nodes are shared, so evaluators must never modify them.
 const PARSED_EXPRESSIONS_CACHE_MAX_SIZE = 1000;
 const parsedExpressionsCache = new Map();
 const expressionParser = new parser_1.JavascriptExpressionParser();
@@ -46,6 +48,7 @@ const parseExpression = (expression) => {
     if (!expressionNode) {
         expressionNode = expressionParser.parse(expression);
         if (parsedExpressionsCache.size >= PARSED_EXPRESSIONS_CACHE_MAX_SIZE) {
+            // evict the oldest entry (Map keeps insertion order)
             const oldestExpression = parsedExpressionsCache.keys().next().value;
             if (oldestExpression !== undefined)
                 parsedExpressionsCache.delete(oldestExpression);
@@ -54,6 +57,7 @@ const parseExpression = (expression) => {
     }
     return expressionNode;
 };
+exports.parseExpression = parseExpression;
 class JavascriptExpressionEvaluator {
     constructor(functions = {}, evaluators = {}) {
         this.evaluators = Object.assign(Object.assign({}, defaultEvaluators), evaluators);
@@ -61,7 +65,7 @@ class JavascriptExpressionEvaluator {
     }
     evaluate(expression, context) {
         return __awaiter(this, void 0, void 0, function* () {
-            return this.evaluateNode(parseExpression(expression), context !== null && context !== void 0 ? context : {});
+            return this.evaluateNode((0, exports.parseExpression)(expression), context !== null && context !== void 0 ? context : {});
         });
     }
     evaluateNode(expressionNode, context) {

package/dist/expression/javascript/evaluator.js.map

@@ -1 +1 @@
-{"version":3,"file":"evaluator.js","sourceRoot":"","sources":["../../../src/expression/javascript/evaluator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"evaluator.js","sourceRoot":"","sources":["../../../src/expression/javascript/evaluator.ts"],"names":[],"mappings":"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","sourcesContent":["import { ExpressionContext } from '../context'\nimport { ExpressionEvaluator } from '../evaluator'\nimport { ExpressionFunctions } from '../function'\nimport { ExpressionNode, ExpressionNodeEvaluatorConstructor, ExpressionNodeType } from '../node'\nimport { SystemError } from '../../error'\n\nimport { functionsDefault } from './functionsDefault'\nimport { ArrayEvaluator } from './node/array'\nimport { BinaryEvaluator } from './node/binary'\nimport { CallEvaluator } from './node/call'\nimport { CompoundEvaluator } from './node/compound'\nimport { ConditionalEvaluator } from './node/conditional'\nimport { IdentifierEvaluator } from './node/identifier'\nimport { LiteralEvaluator } from './node/literal'\nimport { MemberEvaluator } from './node/member'\nimport { SequenceEvaluator } from './node/sequence'\nimport { ThisEvaluator } from './node/this'\nimport { UnaryEvaluator } from './node/unary'\nimport { JavascriptExpressionParser } from './parser/parser'\n\ntype Evaluators<C extends ExpressionContext> = {\n  [nodeType in ExpressionNodeType]?: ExpressionNodeEvaluatorConstructor<C, ExpressionNode<ExpressionNodeType>>\n}\n\nconst defaultEvaluators = {\n  [ExpressionNodeType.Array]: ArrayEvaluator,\n  [ExpressionNodeType.Binary]: BinaryEvaluator,\n  [ExpressionNodeType.Call]: CallEvaluator,\n  [ExpressionNodeType.Compound]: CompoundEvaluator,\n  [ExpressionNodeType.Conditional]: ConditionalEvaluator,\n  [ExpressionNodeType.Identifier]: IdentifierEvaluator,\n  [ExpressionNodeType.Literal]: LiteralEvaluator,\n  [ExpressionNodeType.Member]: MemberEvaluator,\n  [ExpressionNodeType.Sequence]: SequenceEvaluator,\n  [ExpressionNodeType.This]: ThisEvaluator,\n  [ExpressionNodeType.Unary]: UnaryEvaluator,\n}\n\n// Parsed expressions cache: the same expressions are evaluated many times (e.g. for every node during a record update).\n// The cached expression nodes are shared, so evaluators must never modify them.\nconst PARSED_EXPRESSIONS_CACHE_MAX_SIZE = 1000\nconst parsedExpressionsCache = new Map<string, ExpressionNode<ExpressionNodeType>>()\nconst expressionParser = new JavascriptExpressionParser()\n\nexport const parseExpression = (expression: string): ExpressionNode<ExpressionNodeType> => {\n  let expressionNode = parsedExpressionsCache.get(expression)\n  if (!expressionNode) {\n    expressionNode = expressionParser.parse(expression)\n    if (parsedExpressionsCache.size >= PARSED_EXPRESSIONS_CACHE_MAX_SIZE) {\n      // evict the oldest entry (Map keeps insertion order)\n      const oldestExpression = parsedExpressionsCache.keys().next().value\n      if (oldestExpression !== undefined) parsedExpressionsCache.delete(oldestExpression)\n    }\n    parsedExpressionsCache.set(expression, expressionNode)\n  }\n  return expressionNode\n}\n\nexport class JavascriptExpressionEvaluator<C extends ExpressionContext> implements ExpressionEvaluator<C> {\n  functions: ExpressionFunctions<C>\n  evaluators: Evaluators<C>\n\n  constructor(functions: ExpressionFunctions<C> = {}, evaluators: Evaluators<C> = {}) {\n    this.evaluators = { ...defaultEvaluators, ...evaluators }\n    this.functions = { ...functionsDefault, ...functions }\n  }\n\n  async evaluate(expression: string, context?: C): Promise<any> {\n    return this.evaluateNode(parseExpression(expression), context ?? ({} as C))\n  }\n\n  async evaluateNode(expressionNode: ExpressionNode<ExpressionNodeType>, context: C): Promise<any> {\n    const { type } = expressionNode\n\n    const NodeEvaluator = this.evaluators[type]\n    if (!NodeEvaluator) {\n      throw new SystemError('expression.unsupportedFunctionType', { type })\n    }\n    return new NodeEvaluator(this, context).evaluate(expressionNode)\n  }\n}\n"]}

package/dist/expression/javascript/functionsDefault.js.map

@@ -1 +1 @@
-{"version":3,"file":"functionsDefault.js","sourceRoot":"","sources":["../../../src/expression/javascript/functionsDefault.ts"],"names":[],"mappings":";;;AAAA,uCAA4C;AAK/B,QAAA,gBAAgB,GAA6D;IACxF,OAAO,EAAE;QACP,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,eAAO,CAAC,OAAO,CAAC,KAAK,CAAC;KACvD;IACD,UAAU,EAAE;QACV,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,eAAO,CAAC,UAAU,CAAC,KAAK,CAAC;KAC1D;IACD,IAAI,EAAE;QACJ,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,aAAK,CAAC,EAAE,EAAE;KACjC;CACF,CAAA"}
+{"version":3,"file":"functionsDefault.js","sourceRoot":"","sources":["../../../src/expression/javascript/functionsDefault.ts"],"names":[],"mappings":";;;AAAA,uCAA4C;AAK/B,QAAA,gBAAgB,GAA6D;IACxF,OAAO,EAAE;QACP,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,eAAO,CAAC,OAAO,CAAC,KAAK,CAAC;KACvD;IACD,UAAU,EAAE;QACV,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,eAAO,CAAC,UAAU,CAAC,KAAK,CAAC;KAC1D;IACD,IAAI,EAAE;QACJ,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,aAAK,CAAC,EAAE,EAAE;KACjC;CACF,CAAA","sourcesContent":["import { Objects, UUIDs } from '../../utils'\nimport { ExpressionContext } from '../context'\n\nimport { ExpressionFunction } from '../function'\n\nexport const functionsDefault: { [key: string]: ExpressionFunction<ExpressionContext> } = {\n  isEmpty: {\n    minArity: 1,\n    maxArity: 1,\n    executor: () => (value: any) => Objects.isEmpty(value),\n  },\n  isNotEmpty: {\n    minArity: 1,\n    maxArity: 1,\n    executor: () => (value: any) => Objects.isNotEmpty(value),\n  },\n  uuid: {\n    minArity: 0,\n    maxArity: 0,\n    executor: () => () => UUIDs.v4(),\n  },\n}\n"]}

package/dist/expression/javascript/global.js.map

@@ -1 +1 @@
-{"version":3,"file":"global.js","sourceRoot":"","sources":["../../../src/expression/javascript/global.ts"],"names":[],"mappings":";;;AACA,uCAAyC;AAEzC,MAAM,uBAAuB,GAAoB;IAC/C,KAAK;IACL,OAAO;IACP,IAAI;IACJ,IAAI;IACJ,MAAM;IACN,MAAM;CACP,CAAA;AACD,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAA;AAE1D,MAAM,uBAAuB,GAAG,CAAC,IAAY,EAAE,MAAW,EAAO,EAAE;IACxE,MAAM,YAAY,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAA;IAClD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,YAAY,CAAA;IACrB,CAAC;IACD,IAAI,MAAM,IAAI,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;QAE7B,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,mBAAW,CAAC,8BAA8B,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;QACjE,CAAC;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAdY,QAAA,uBAAuB,2BAcnC"}
+{"version":3,"file":"global.js","sourceRoot":"","sources":["../../../src/expression/javascript/global.ts"],"names":[],"mappings":";;;AACA,uCAAyC;AAEzC,MAAM,uBAAuB,GAAoB;IAC/C,KAAK;IACL,OAAO;IACP,IAAI;IACJ,IAAI;IACJ,MAAM;IACN,MAAM;CACP,CAAA;AACD,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAA;AAE1D,MAAM,uBAAuB,GAAG,CAAC,IAAY,EAAE,MAAW,EAAO,EAAE;IACxE,MAAM,YAAY,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAA;IAClD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,YAAY,CAAA;IACrB,CAAC;IACD,IAAI,MAAM,IAAI,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;QAE7B,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,mBAAW,CAAC,8BAA8B,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;QACjE,CAAC;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAdY,QAAA,uBAAuB,2BAcnC","sourcesContent":["import { Dictionary } from '../../common'\nimport { SystemError } from '../../error'\n\nconst globalObjectsDictionary: Dictionary<any> = {\n  Array,\n  Boolean,\n  Date,\n  Math,\n  Number,\n  String,\n}\nconst globalObjectsArray = Object.values(globalObjectsDictionary)\n\nexport const getGlobalObjectProperty = (name: string, object: any): any => {\n  const globalObject = globalObjectsDictionary[name]\n  if (globalObject) {\n    return globalObject\n  }\n  if (object && globalObjectsArray.includes(object)) {\n    const property = object[name]\n\n    if (!property) {\n      throw new SystemError('expression.undefinedFunction', { name })\n    }\n    return property\n  }\n  return null\n}\n"]}

package/dist/expression/javascript/node/array.js.map

@@ -1 +1 @@
-{"version":3,"file":"array.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/array.ts"],"names":[],"mappings":";;;AAAA,0CAA4C;AAE5C,qCAAqE;AAErE,MAAa,cAA4C,SAAQ,8BAA2C;IAC1G,QAAQ;QACN,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,mBAAW,CAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAA;IACtF,CAAC;CACF;AAJD,wCAIC"}
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/array.ts"],"names":[],"mappings":";;;AAAA,0CAA4C;AAE5C,qCAAqE;AAErE,MAAa,cAA4C,SAAQ,8BAA2C;IAC1G,QAAQ;QACN,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,mBAAW,CAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAA;IACtF,CAAC;CACF;AAJD,wCAIC","sourcesContent":["import { SystemError } from '../../../error'\nimport { ExpressionContext } from '../../context'\nimport { ArrayExpression, ExpressionNodeEvaluator } from '../../node'\n\nexport class ArrayEvaluator<C extends ExpressionContext> extends ExpressionNodeEvaluator<C, ArrayExpression> {\n  evaluate(): Promise<any> {\n    return Promise.reject(new SystemError('expression.notSupported', { type: 'array' }))\n  }\n}\n"]}

package/dist/expression/javascript/node/binary.js

@@ -14,14 +14,20 @@ const error_1 = require("../../../error");
 const utils_1 = require("../../../utils");
 const node_1 = require("../../node");
 const booleanOperators = {
+    // Short-circuiting operators (we coerce the output to bool)
     '||': (a, b) => Boolean(a || b),
     '&&': (a, b) => Boolean(a && b),
+    // Normal boolean operators:
     '==': (a, b) => a === b,
     '!=': (a, b) => a !== b,
     '<': (a, b) => a < b,
     '>': (a, b) => a > b,
     '<=': (a, b) => a <= b,
     '>=': (a, b) => a >= b,
+    // Only allow one kind of equalities.
+    // some hidden dependencies on === and !==...
+    // '===':  (a, b) => a === b,
+    // '!==':  (a, b) => a !== b,
 };
 const arithmeticOperators = {
     '+': (a, b) => a + b,
@@ -30,6 +36,14 @@ const arithmeticOperators = {
     '/': (a, b) => a / b,
     '%': (a, b) => a % b,
     '**': (a, b) => Math.pow(a, b),
+    // Don't allow bitwise operators:
+    // '|':   (a, b) => a | b,
+    // '^':   (a, b) => a ^ b,
+    // '&':   (a, b) => a & b,
+    // Don't allow shifts either:
+    // '<<':  (a, b) => a << b,
+    // '>>':  (a, b) => a >> b,
+    // '>>>': (a, b) => a >>> b,
 };
 const stringOperators = {
     '+': (a, b) => a + b,
@@ -47,15 +61,19 @@ class BinaryEvaluator extends node_1.ExpressionNodeEvaluator {
             }
             const leftResult = yield this.evaluator.evaluateNode(left, this.context);
             const rightResult = yield this.evaluator.evaluateNode(right, this.context);
+            // string operators
             if (operator in stringOperators) {
                 if (isString(leftResult) || isString(rightResult)) {
+                    // string concatenation with null or undefined gives null (like arithmetic operations with null)
                     if (utils_1.Objects.isNil(leftResult) || utils_1.Objects.isNil(rightResult)) {
                         return null;
                     }
                     const strFn = stringOperators[operator];
                     return strFn(leftResult, rightResult);
                 }
+                // operator can be in arithmeticOperators (+), do not return anything now
             }
+            // Arithmetic operators will always return nulls for any non-numeric inputs
             if (operator in arithmeticOperators) {
                 if (isNumber(leftResult) && isNumber(rightResult)) {
                     return fn(leftResult, rightResult);
@@ -63,6 +81,11 @@ class BinaryEvaluator extends node_1.ExpressionNodeEvaluator {
                 return null;
             }
             const nullCount = [leftResult, rightResult].filter((result) => result === null || result === undefined).length;
+            // Boolean operators:
+            // Like ternary logic, but logical OR has special handling.
+            // The expression is boolean if either value is not null.
+            // Otherwise the result is null.
+            // All other operators return null if either operand is null
             const isValid = (operator === '||' && nullCount < 2) || nullCount === 0;
             return isValid ? fn(leftResult, rightResult) : null;
         });

package/dist/expression/javascript/node/binary.js.map

@@ -1 +1 @@
-{"version":3,"file":"binary.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/binary.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"binary.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/binary.ts"],"names":[],"mappings":"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","sourcesContent":["import { SystemError } from '../../../error'\nimport { Objects } from '../../../utils'\nimport { ExpressionContext } from '../../context'\nimport { BinaryExpression, ExpressionNodeEvaluator } from '../../node'\n\nconst booleanOperators: { [operator: string]: (a: any, b: any) => boolean } = {\n  // Short-circuiting operators (we coerce the output to bool)\n  '||': (a, b) => Boolean(a || b),\n  '&&': (a, b) => Boolean(a && b),\n  // Normal boolean operators:\n  '==': (a, b) => a === b,\n  '!=': (a, b) => a !== b,\n  '<': (a, b) => a < b,\n  '>': (a, b) => a > b,\n  '<=': (a, b) => a <= b,\n  '>=': (a, b) => a >= b,\n  // Only allow one kind of equalities.\n  // some hidden dependencies on === and !==...\n  // '===':  (a, b) => a === b,\n  // '!==':  (a, b) => a !== b,\n}\n\nconst arithmeticOperators: { [operator: string]: (a: number, b: number) => number } = {\n  '+': (a, b) => a + b,\n  '-': (a, b) => a - b,\n  '*': (a, b) => a * b,\n  '/': (a, b) => a / b,\n  '%': (a, b) => a % b,\n  '**': (a, b) => a ** b,\n  // Don't allow bitwise operators:\n  // '|':   (a, b) => a | b,\n  // '^':   (a, b) => a ^ b,\n  // '&':   (a, b) => a & b,\n  // Don't allow shifts either:\n  // '<<':  (a, b) => a << b,\n  // '>>':  (a, b) => a >> b,\n  // '>>>': (a, b) => a >>> b,\n}\n\nconst stringOperators: { [operatos: string]: (a: string, b: string) => string } = {\n  '+': (a, b) => a + b,\n}\n\nconst binaryOperators = {\n  ...booleanOperators,\n  ...arithmeticOperators,\n}\n\nconst isNumber = (value: any) => !Objects.isNil(value) && value.constructor === Number\nconst isString = (value: any) => !Objects.isNil(value) && value.constructor === String\n\nexport class BinaryEvaluator<C extends ExpressionContext> extends ExpressionNodeEvaluator<C, BinaryExpression> {\n  async evaluate(expressionNode: BinaryExpression): Promise<any> {\n    const { left, right, operator } = expressionNode\n\n    const fn = binaryOperators[operator]\n    if (!fn) {\n      throw new SystemError('expression.booleanOperatorNotSupported', { operator })\n    }\n\n    const leftResult = await this.evaluator.evaluateNode(left, this.context)\n    const rightResult = await this.evaluator.evaluateNode(right, this.context)\n\n    // string operators\n    if (operator in stringOperators) {\n      if (isString(leftResult) || isString(rightResult)) {\n        // string concatenation with null or undefined gives null (like arithmetic operations with null)\n        if (Objects.isNil(leftResult) || Objects.isNil(rightResult)) {\n          return null\n        }\n        const strFn = stringOperators[operator]\n        return strFn(leftResult as string, rightResult as string)\n      }\n      // operator can be in arithmeticOperators (+), do not return anything now\n    }\n\n    // Arithmetic operators will always return nulls for any non-numeric inputs\n    if (operator in arithmeticOperators) {\n      if (isNumber(leftResult) && isNumber(rightResult)) {\n        return fn(leftResult as number, rightResult as number)\n      }\n      return null\n    }\n\n    const nullCount = [leftResult, rightResult].filter((result) => result === null || result === undefined).length\n\n    // Boolean operators:\n    // Like ternary logic, but logical OR has special handling.\n    // The expression is boolean if either value is not null.\n    // Otherwise the result is null.\n    // All other operators return null if either operand is null\n    const isValid = (operator === '||' && nullCount < 2) || nullCount === 0\n\n    return isValid ? fn(leftResult, rightResult) : null\n  }\n}\n"]}

package/dist/expression/javascript/node/call.js

@@ -23,12 +23,15 @@ class CallEvaluator extends node_1.ExpressionNodeEvaluator {
             else if (callee.type === node_1.ExpressionNodeType.Identifier) {
                 return this.evaluateIdentifier(expressionNode);
             }
+            // No complex expressions may be put in place of a function body.
+            // Only a plain identifier is allowed.
             throw new error_1.SystemError('expression.invalidCalleeType', { type: callee.type });
         });
     }
     evaluateMember(expressionNode) {
         return __awaiter(this, void 0, void 0, function* () {
             const { callee, arguments: exprArgs } = expressionNode;
+            // global function (e.g. Math.round(...))
             const fn = yield this.evaluator.evaluateNode(callee, this.context);
             if (fn) {
                 const { object: calleeObj } = callee;
@@ -42,15 +45,19 @@ class CallEvaluator extends node_1.ExpressionNodeEvaluator {
     }
     evaluateIdentifier(expressionNode) {
         return __awaiter(this, void 0, void 0, function* () {
+            // Arguments is a reserved word in strict mode
             const { callee, arguments: exprArgs } = expressionNode;
             const { object: contextObject } = this.context;
             const { name: fnName } = callee;
             const functionInfo = this.evaluator.functions[fnName];
             if (functionInfo) {
+                // The function is among the custom functions.
                 return this.evaluateCustomIdentifier(expressionNode);
             }
+            // identifier is a global object
             const globalFn = (0, global_1.getGlobalObjectProperty)(fnName, contextObject);
             if (globalFn !== null) {
+                // global functions like String, Number, must be invoked passing node value as argument, not the node itself
                 const contextArg = Object.assign(Object.assign({}, this.context), { evaluateToNode: false });
                 const args = yield Promise.all(exprArgs.map((arg) => this.evaluator.evaluateNode(arg, contextArg)));
                 return globalFn(...args);
@@ -60,6 +67,7 @@ class CallEvaluator extends node_1.ExpressionNodeEvaluator {
     }
     evaluateCustomIdentifier(expressionNode) {
         return __awaiter(this, void 0, void 0, function* () {
+            // Arguments is a reserved word in strict mode
             const { callee, arguments: exprArgs } = expressionNode;
             const { name: fnName } = callee;
             const numArgs = exprArgs.length;
@@ -69,8 +77,12 @@ class CallEvaluator extends node_1.ExpressionNodeEvaluator {
                 throw new error_1.SystemError('expression.functionHasTooFewArguments', { fnName, minArity, numArgs });
             if (maxArity !== undefined && maxArity >= 0 && numArgs > maxArity)
                 throw new error_1.SystemError('expression.functionHasTooManyArguments', { fnName, maxArity, numArgs });
+            // evaluate arguments
             const argsContext = Object.assign(Object.assign({}, this.context), { evaluateToNode: evaluateArgsToNodes });
             const args = yield Promise.all(exprArgs.map((arg) => this.evaluator.evaluateNode(arg, argsContext)));
+            // Currently there are no side effects from function evaluation so it's
+            // safe to call the function even when we're just parsing the expression
+            // to find all identifiers being used.
             return executor(this.context)(...args);
         });
     }

package/dist/expression/javascript/node/call.js.map

@@ -1 +1 @@
-{"version":3,"file":"call.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/call.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"call.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/call.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,0CAA4C;AAG5C,qCAAwF;AACxF,sCAAmD;AAEnD,MAAa,aAA2C,SAAQ,8BAA0C;IAClG,QAAQ,CAAC,cAA8B;;YAC3C,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,CAAA;YAEjC,IAAI,MAAM,CAAC,IAAI,KAAK,yBAAkB,CAAC,MAAM,EAAE,CAAC;gBAC9C,OAAO,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,CAAA;YAC5C,CAAC;iBAAM,IAAI,MAAM,CAAC,IAAI,KAAK,yBAAkB,CAAC,UAAU,EAAE,CAAC;gBACzD,OAAO,IAAI,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAA;YAChD,CAAC;YAED,iEAAiE;YACjE,sCAAsC;YACtC,MAAM,IAAI,mBAAW,CAAC,8BAA8B,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;QAC9E,CAAC;KAAA;IAEK,cAAc,CAAC,cAA8B;;YACjD,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAA;YAEtD,yCAAyC;YACzC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;YAClE,IAAI,EAAE,EAAE,CAAC;gBACP,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAA0B,CAAA;gBACxD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;gBAC3E,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;gBAC9G,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,CAAA;gBACjC,OAAO,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAA;YACnC,CAAC;YACD,OAAO,IAAI,CAAA;QACb,CAAC;KAAA;IAEK,kBAAkB,CAAC,cAA8B;;YACrD,8CAA8C;YAC9C,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAA;YACtD,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,OAAO,CAAA;YAE9C,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAA8B,CAAA;YAEvD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;YACrD,IAAI,YAAY,EAAE,CAAC;gBACjB,8CAA8C;gBAC9C,OAAO,IAAI,CAAC,wBAAwB,CAAC,cAAc,CAAC,CAAA;YACtD,CAAC;YACD,gCAAgC;YAChC,MAAM,QAAQ,GAAG,IAAA,gCAAuB,EAAC,MAAM,EAAE,aAAa,CAAC,CAAA;YAC/D,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACtB,4GAA4G;gBAC5G,MAAM,UAAU,mCAAQ,IAAI,CAAC,OAAO,KAAE,cAAc,EAAE,KAAK,GAAE,CAAA;gBAC7D,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;gBACnG,OAAO,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAA;YAC1B,CAAC;YAED,MAAM,IAAI,mBAAW,CAAC,8BAA8B,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;QACzE,CAAC;KAAA;IAEK,wBAAwB,CAAC,cAA8B;;YAC3D,8CAA8C;YAC9C,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAA;YAEtD,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAA8B,CAAA;YACvD,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAA;YAE/B,MAAM,kBAAkB,GAA0B,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;YAElF,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,mBAAmB,EAAE,QAAQ,EAAE,GAAG,kBAAkB,CAAA;YAEhF,IAAI,OAAO,GAAG,QAAQ;gBACpB,MAAM,IAAI,mBAAW,CAAC,uCAAuC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAA;YAC/F,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,IAAI,CAAC,IAAI,OAAO,GAAG,QAAQ;gBAC/D,MAAM,IAAI,mBAAW,CAAC,wCAAwC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAA;YAEhG,qBAAqB;YACrB,MAAM,WAAW,mCAAQ,IAAI,CAAC,OAAO,KAAE,cAAc,EAAE,mBAAmB,GAAE,CAAA;YAC5E,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;YAEpG,uEAAuE;YACvE,wEAAwE;YACxE,sCAAsC;YACtC,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;QACxC,CAAC;KAAA;CACF;AA/ED,sCA+EC","sourcesContent":["import { IdentifierExpression, MemberExpression } from '../..'\nimport { SystemError } from '../../../error'\nimport { ExpressionContext } from '../../context'\nimport { ExpressionFunction } from '../../function'\nimport { CallExpression, ExpressionNodeEvaluator, ExpressionNodeType } from '../../node'\nimport { getGlobalObjectProperty } from '../global'\n\nexport class CallEvaluator<C extends ExpressionContext> extends ExpressionNodeEvaluator<C, CallExpression> {\n  async evaluate(expressionNode: CallExpression): Promise<any> {\n    const { callee } = expressionNode\n\n    if (callee.type === ExpressionNodeType.Member) {\n      return this.evaluateMember(expressionNode)\n    } else if (callee.type === ExpressionNodeType.Identifier) {\n      return this.evaluateIdentifier(expressionNode)\n    }\n\n    // No complex expressions may be put in place of a function body.\n    // Only a plain identifier is allowed.\n    throw new SystemError('expression.invalidCalleeType', { type: callee.type })\n  }\n\n  async evaluateMember(expressionNode: CallExpression): Promise<any> {\n    const { callee, arguments: exprArgs } = expressionNode\n\n    // global function (e.g. Math.round(...))\n    const fn = await this.evaluator.evaluateNode(callee, this.context)\n    if (fn) {\n      const { object: calleeObj } = callee as MemberExpression\n      const fnObject = await this.evaluator.evaluateNode(calleeObj, this.context)\n      const argsEvaluated = await Promise.all(exprArgs.map((arg) => this.evaluator.evaluateNode(arg, this.context)))\n      const args = argsEvaluated.flat()\n      return fn.call(fnObject, ...args)\n    }\n    return null\n  }\n\n  async evaluateIdentifier(expressionNode: CallExpression): Promise<any> {\n    // Arguments is a reserved word in strict mode\n    const { callee, arguments: exprArgs } = expressionNode\n    const { object: contextObject } = this.context\n\n    const { name: fnName } = callee as IdentifierExpression\n\n    const functionInfo = this.evaluator.functions[fnName]\n    if (functionInfo) {\n      // The function is among the custom functions.\n      return this.evaluateCustomIdentifier(expressionNode)\n    }\n    // identifier is a global object\n    const globalFn = getGlobalObjectProperty(fnName, contextObject)\n    if (globalFn !== null) {\n      // global functions like String, Number, must be invoked passing node value as argument, not the node itself\n      const contextArg = { ...this.context, evaluateToNode: false }\n      const args = await Promise.all(exprArgs.map((arg) => this.evaluator.evaluateNode(arg, contextArg)))\n      return globalFn(...args)\n    }\n\n    throw new SystemError('expression.undefinedFunction', { name: fnName })\n  }\n\n  async evaluateCustomIdentifier(expressionNode: CallExpression): Promise<any> {\n    // Arguments is a reserved word in strict mode\n    const { callee, arguments: exprArgs } = expressionNode\n\n    const { name: fnName } = callee as IdentifierExpression\n    const numArgs = exprArgs.length\n\n    const expressionFunction: ExpressionFunction<C> = this.evaluator.functions[fnName]\n\n    const { minArity, maxArity, evaluateArgsToNodes, executor } = expressionFunction\n\n    if (numArgs < minArity)\n      throw new SystemError('expression.functionHasTooFewArguments', { fnName, minArity, numArgs })\n    if (maxArity !== undefined && maxArity >= 0 && numArgs > maxArity)\n      throw new SystemError('expression.functionHasTooManyArguments', { fnName, maxArity, numArgs })\n\n    // evaluate arguments\n    const argsContext = { ...this.context, evaluateToNode: evaluateArgsToNodes }\n    const args = await Promise.all(exprArgs.map((arg) => this.evaluator.evaluateNode(arg, argsContext)))\n\n    // Currently there are no side effects from function evaluation so it's\n    // safe to call the function even when we're just parsing the expression\n    // to find all identifiers being used.\n    return executor(this.context)(...args)\n  }\n}\n"]}

package/dist/expression/javascript/node/compound.js.map

@@ -1 +1 @@
-{"version":3,"file":"compound.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/compound.ts"],"names":[],"mappings":";;;AAAA,0CAA4C;AAE5C,qCAAwE;AAExE,MAAa,iBAA+C,SAAQ,8BAA8C;IAChH,QAAQ;QACN,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,mBAAW,CAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;IACzF,CAAC;CACF;AAJD,8CAIC"}
+{"version":3,"file":"compound.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/compound.ts"],"names":[],"mappings":";;;AAAA,0CAA4C;AAE5C,qCAAwE;AAExE,MAAa,iBAA+C,SAAQ,8BAA8C;IAChH,QAAQ;QACN,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,mBAAW,CAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;IACzF,CAAC;CACF;AAJD,8CAIC","sourcesContent":["import { SystemError } from '../../../error'\nimport { ExpressionContext } from '../../context'\nimport { CompoundExpression, ExpressionNodeEvaluator } from '../../node'\n\nexport class CompoundEvaluator<C extends ExpressionContext> extends ExpressionNodeEvaluator<C, CompoundExpression> {\n  evaluate(): Promise<any> {\n    return Promise.reject(new SystemError('expression.notSupported', { type: 'compound' }))\n  }\n}\n"]}

package/dist/expression/javascript/node/conditional.js.map

@@ -1 +1 @@
-{"version":3,"file":"conditional.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/conditional.ts"],"names":[],"mappings":";;;AAAA,0CAA4C;AAE5C,qCAA2E;AAE3E,MAAa,oBAAkD,SAAQ,8BAGtE;IACC,QAAQ;QACN,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,mBAAW,CAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,CAAA;IAC5F,CAAC;CACF;AAPD,oDAOC"}
+{"version":3,"file":"conditional.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/conditional.ts"],"names":[],"mappings":";;;AAAA,0CAA4C;AAE5C,qCAA2E;AAE3E,MAAa,oBAAkD,SAAQ,8BAGtE;IACC,QAAQ;QACN,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,mBAAW,CAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,CAAA;IAC5F,CAAC;CACF;AAPD,oDAOC","sourcesContent":["import { SystemError } from '../../../error'\nimport { ExpressionContext } from '../../context'\nimport { ConditionalExpression, ExpressionNodeEvaluator } from '../../node'\n\nexport class ConditionalEvaluator<C extends ExpressionContext> extends ExpressionNodeEvaluator<\n  C,\n  ConditionalExpression\n> {\n  evaluate(): Promise<any> {\n    return Promise.reject(new SystemError('expression.notSupported', { type: 'conditional' }))\n  }\n}\n"]}

package/dist/expression/javascript/node/identifier.d.ts

@@ -1,6 +1,13 @@
 import { ExpressionContext } from '../../context';
 import { ExpressionNodeEvaluator, IdentifierExpression } from '../../node';
 export declare class IdentifierEvaluator<C extends ExpressionContext> extends ExpressionNodeEvaluator<C, IdentifierExpression> {
+    /**
+     * Looks for the identifier among global or native properties, without throwing when it is not found
+     * (creating errors captures stack traces, which is expensive when it happens for every evaluated identifier).
+     *
+     * @param expressionNode - The identifier expression node.
+     * @returns The property value wrapped in an object, or null if the identifier has not been found.
+     */
     protected findGlobalOrNativeProperty(expressionNode: IdentifierExpression): {
         value: any;
     } | null;

package/dist/expression/javascript/node/identifier.js

@@ -12,6 +12,13 @@ const getNativeProperty = (name, object) => {
     return typeof prop === 'function' ? prop.bind(object) : prop;
 };
 class IdentifierEvaluator extends node_1.ExpressionNodeEvaluator {
+    /**
+     * Looks for the identifier among global or native properties, without throwing when it is not found
+     * (creating errors captures stack traces, which is expensive when it happens for every evaluated identifier).
+     *
+     * @param expressionNode - The identifier expression node.
+     * @returns The property value wrapped in an object, or null if the identifier has not been found.
+     */
     findGlobalOrNativeProperty(expressionNode) {
         const { name } = expressionNode;
         const { object: contextObject } = this.context;

package/dist/expression/javascript/node/identifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"identifier.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/identifier.ts"],"names":[],"mappings":";;;AAAA,0CAA4C;AAE5C,qCAA0E;AAC1E,sCAAmD;AAEnD,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAE,MAAW,EAAE,EAAE;IACtD,MAAM,IAAI,GAAG,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAG,IAAI,CAAC,CAAA;IAC3B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAC9D,CAAC,CAAA;AAED,MAAa,mBAAiD,SAAQ,8BAAgD;IAQ1G,0BAA0B,CAAC,cAAoC;QACvE,MAAM,EAAE,IAAI,EAAE,GAAG,cAAc,CAAA;QAC/B,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,OAAO,CAAA;QAE9C,MAAM,UAAU,GAAG,IAAA,gCAAuB,EAAC,IAAI,EAAE,aAAa,CAAC,CAAA;QAC/D,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAA;QAC9B,CAAC;QACD,MAAM,cAAc,GAAG,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;QAC7D,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,CAAA;QAClC,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,QAAQ,CAAC,cAAoC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,0BAA0B,CAAC,cAAc,CAAC,CAAA;QAChE,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QACxC,CAAC;QACD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,mBAAW,CAAC,+BAA+B,EAAE,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IACxG,CAAC;CACF;AA9BD,kDA8BC"}
+{"version":3,"file":"identifier.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/identifier.ts"],"names":[],"mappings":";;;AAAA,0CAA4C;AAE5C,qCAA0E;AAC1E,sCAAmD;AAEnD,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAE,MAAW,EAAE,EAAE;IACtD,MAAM,IAAI,GAAG,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAG,IAAI,CAAC,CAAA;IAC3B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAC9D,CAAC,CAAA;AAED,MAAa,mBAAiD,SAAQ,8BAAgD;IACpH;;;;;;OAMG;IACO,0BAA0B,CAAC,cAAoC;QACvE,MAAM,EAAE,IAAI,EAAE,GAAG,cAAc,CAAA;QAC/B,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,OAAO,CAAA;QAE9C,MAAM,UAAU,GAAG,IAAA,gCAAuB,EAAC,IAAI,EAAE,aAAa,CAAC,CAAA;QAC/D,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAA;QAC9B,CAAC;QACD,MAAM,cAAc,GAAG,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;QAC7D,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,CAAA;QAClC,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,QAAQ,CAAC,cAAoC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,0BAA0B,CAAC,cAAc,CAAC,CAAA;QAChE,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QACxC,CAAC;QACD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,mBAAW,CAAC,+BAA+B,EAAE,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IACxG,CAAC;CACF;AA9BD,kDA8BC","sourcesContent":["import { SystemError } from '../../../error'\nimport { ExpressionContext } from '../../context'\nimport { ExpressionNodeEvaluator, IdentifierExpression } from '../../node'\nimport { getGlobalObjectProperty } from '../global'\n\nconst getNativeProperty = (name: string, object: any) => {\n  const prop = object?.[name]\n  if (prop === undefined) {\n    return undefined\n  }\n  return typeof prop === 'function' ? prop.bind(object) : prop\n}\n\nexport class IdentifierEvaluator<C extends ExpressionContext> extends ExpressionNodeEvaluator<C, IdentifierExpression> {\n  /**\n   * Looks for the identifier among global or native properties, without throwing when it is not found\n   * (creating errors captures stack traces, which is expensive when it happens for every evaluated identifier).\n   *\n   * @param expressionNode - The identifier expression node.\n   * @returns The property value wrapped in an object, or null if the identifier has not been found.\n   */\n  protected findGlobalOrNativeProperty(expressionNode: IdentifierExpression): { value: any } | null {\n    const { name } = expressionNode\n    const { object: contextObject } = this.context\n\n    const globalProp = getGlobalObjectProperty(name, contextObject)\n    if (globalProp !== null) {\n      return { value: globalProp }\n    }\n    const nativeProperty = getNativeProperty(name, contextObject)\n    if (nativeProperty !== undefined) {\n      return { value: nativeProperty }\n    }\n    return null\n  }\n\n  evaluate(expressionNode: IdentifierExpression): Promise<any> {\n    const property = this.findGlobalOrNativeProperty(expressionNode)\n    if (property) {\n      return Promise.resolve(property.value)\n    }\n    return Promise.reject(new SystemError('expression.identifierNotFound', { name: expressionNode.name }))\n  }\n}\n"]}

package/dist/expression/javascript/node/literal.js.map

@@ -1 +1 @@
-{"version":3,"file":"literal.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/literal.ts"],"names":[],"mappings":";;;AACA,qCAAuE;AAEvE,MAAa,gBAA8C,SAAQ,8BAA6C;IAC9G,QAAQ,CAAC,cAAiC;QACxC,OAAO,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;IAC9C,CAAC;CACF;AAJD,4CAIC"}
+{"version":3,"file":"literal.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/literal.ts"],"names":[],"mappings":";;;AACA,qCAAuE;AAEvE,MAAa,gBAA8C,SAAQ,8BAA6C;IAC9G,QAAQ,CAAC,cAAiC;QACxC,OAAO,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;IAC9C,CAAC;CACF;AAJD,4CAIC","sourcesContent":["import { ExpressionContext } from '../../context'\nimport { ExpressionNodeEvaluator, LiteralExpression } from '../../node'\n\nexport class LiteralEvaluator<C extends ExpressionContext> extends ExpressionNodeEvaluator<C, LiteralExpression> {\n  evaluate(expressionNode: LiteralExpression): Promise<any> {\n    return Promise.resolve(expressionNode.value)\n  }\n}\n"]}

package/dist/expression/javascript/node/member.js

@@ -14,15 +14,19 @@ const node_1 = require("../../node");
 class MemberEvaluator extends node_1.ExpressionNodeEvaluator {
     evaluateComputedProperty(property, objectEval) {
         return __awaiter(this, void 0, void 0, function* () {
+            // expressions like plot[1] or plot[plot_id == 1]
             const propertyEval = yield this.evaluator.evaluateNode(property, Object.assign(Object.assign({}, this.context), { object: this.context.object }));
             if (typeof propertyEval === 'number') {
+                // expressions like plot[1]
                 return objectEval[propertyEval];
             }
             if (Array.isArray(objectEval)) {
+                // expressions where the member property is a filter function (e.g. plot[plot_id == 1])
                 const filtered = [];
                 for (const objectEvalItem of objectEval) {
                     const itemContext = Object.assign(Object.assign({}, this.context), { object: objectEvalItem, evaluateToNode: false });
-                    const itemMatches = yield this.evaluator.evaluateNode(property, itemContext);
+                    // evaluate items sequentially, to avoid concurrent category item / taxon lookups on large node sets
+                    const itemMatches = yield this.evaluator.evaluateNode(property, itemContext); // NOSONAR
                     if (itemMatches) {
                         filtered.push(objectEvalItem);
                     }

package/dist/expression/javascript/node/member.js.map

@@ -1 +1 @@
-{"version":3,"file":"member.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/member.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,qCAAsF;AAEtF,MAAa,eAA6C,SAAQ,8BAA4C;IACtG,wBAAwB,CAAC,QAA6B,EAAE,UAAe;;YAG3E,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,kCAC1D,IAAI,CAAC,OAAO,KACf,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,IAC3B,CAAA;YAEF,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;gBAErC,OAAO,UAAU,CAAC,YAAY,CAAC,CAAA;YACjC,CAAC;YAED,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBAG9B,MAAM,QAAQ,GAAG,EAAE,CAAA;gBACnB,KAAK,MAAM,cAAc,IAAI,UAAU,EAAE,CAAC;oBACxC,MAAM,WAAW,mCAAQ,IAAI,CAAC,OAAO,KAAE,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,GAAE,CAAA;oBAEtF,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;oBAC5E,IAAI,WAAW,EAAE,CAAC;wBAChB,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;oBAC/B,CAAC;gBACH,CAAC;gBACD,OAAO,QAAQ,CAAA;YACjB,CAAC;iBAAM,CAAC;gBACN,OAAO,YAAY,CAAA;YACrB,CAAC;QACH,CAAC;KAAA;IAEK,QAAQ,CAAC,cAAgC;;YAC7C,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAA;YAErD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,kCAAO,IAAI,CAAC,OAAO,KAAE,cAAc,EAAE,IAAI,IAAG,CAAA;YACvG,IAAI,CAAC,UAAU;gBAAE,OAAO,IAAI,CAAA;YAE5B,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,IAAI,CAAC,wBAAwB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;YAC5D,CAAC;YAED,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,kCAC1D,IAAI,CAAC,OAAO,KACf,MAAM,EAAE,UAAU,IAClB,CAAA;YAEF,OAAO,YAAY,CAAA;QACrB,CAAC;KAAA;CACF;AAjDD,0CAiDC"}
+{"version":3,"file":"member.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/member.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,qCAAsF;AAEtF,MAAa,eAA6C,SAAQ,8BAA4C;IACtG,wBAAwB,CAAC,QAA6B,EAAE,UAAe;;YAC3E,iDAAiD;YAEjD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,kCAC1D,IAAI,CAAC,OAAO,KACf,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,IAC3B,CAAA;YAEF,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;gBACrC,2BAA2B;gBAC3B,OAAO,UAAU,CAAC,YAAY,CAAC,CAAA;YACjC,CAAC;YAED,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9B,uFAAuF;gBAEvF,MAAM,QAAQ,GAAG,EAAE,CAAA;gBACnB,KAAK,MAAM,cAAc,IAAI,UAAU,EAAE,CAAC;oBACxC,MAAM,WAAW,mCAAQ,IAAI,CAAC,OAAO,KAAE,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,GAAE,CAAA;oBACtF,oGAAoG;oBACpG,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA,CAAC,UAAU;oBACvF,IAAI,WAAW,EAAE,CAAC;wBAChB,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;oBAC/B,CAAC;gBACH,CAAC;gBACD,OAAO,QAAQ,CAAA;YACjB,CAAC;iBAAM,CAAC;gBACN,OAAO,YAAY,CAAA;YACrB,CAAC;QACH,CAAC;KAAA;IAEK,QAAQ,CAAC,cAAgC;;YAC7C,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAA;YAErD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,kCAAO,IAAI,CAAC,OAAO,KAAE,cAAc,EAAE,IAAI,IAAG,CAAA;YACvG,IAAI,CAAC,UAAU;gBAAE,OAAO,IAAI,CAAA;YAE5B,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,IAAI,CAAC,wBAAwB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;YAC5D,CAAC;YAED,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,kCAC1D,IAAI,CAAC,OAAO,KACf,MAAM,EAAE,UAAU,IAClB,CAAA;YAEF,OAAO,YAAY,CAAA;QACrB,CAAC;KAAA;CACF;AAjDD,0CAiDC","sourcesContent":["import { ExpressionContext } from '../../context'\nimport { ExpressionNode, ExpressionNodeEvaluator, MemberExpression } from '../../node'\n\nexport class MemberEvaluator<C extends ExpressionContext> extends ExpressionNodeEvaluator<C, MemberExpression> {\n  async evaluateComputedProperty(property: ExpressionNode<any>, objectEval: any): Promise<any> {\n    // expressions like plot[1] or plot[plot_id == 1]\n\n    const propertyEval = await this.evaluator.evaluateNode(property, {\n      ...this.context,\n      object: this.context.object,\n    })\n\n    if (typeof propertyEval === 'number') {\n      // expressions like plot[1]\n      return objectEval[propertyEval]\n    }\n\n    if (Array.isArray(objectEval)) {\n      // expressions where the member property is a filter function (e.g. plot[plot_id == 1])\n\n      const filtered = []\n      for (const objectEvalItem of objectEval) {\n        const itemContext = { ...this.context, object: objectEvalItem, evaluateToNode: false }\n        // evaluate items sequentially, to avoid concurrent category item / taxon lookups on large node sets\n        const itemMatches = await this.evaluator.evaluateNode(property, itemContext) // NOSONAR\n        if (itemMatches) {\n          filtered.push(objectEvalItem)\n        }\n      }\n      return filtered\n    } else {\n      return propertyEval\n    }\n  }\n\n  async evaluate(expressionNode: MemberExpression): Promise<any> {\n    const { object, property, computed } = expressionNode\n\n    const objectEval = await this.evaluator.evaluateNode(object, { ...this.context, evaluateToNode: true })\n    if (!objectEval) return null\n\n    if (computed) {\n      return this.evaluateComputedProperty(property, objectEval)\n    }\n\n    const propertyEval = await this.evaluator.evaluateNode(property, {\n      ...this.context,\n      object: objectEval,\n    })\n\n    return propertyEval\n  }\n}\n"]}

package/dist/expression/javascript/node/sequence.js.map

@@ -1 +1 @@
-{"version":3,"file":"sequence.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/sequence.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,qCAAwE;AAExE,MAAa,iBAA+C,SAAQ,8BAA8C;IAC1G,QAAQ,CAAC,cAAkC;;YAC/C,MAAM,EAAE,UAAU,EAAE,GAAG,cAAc,CAAA;YACrC,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAC9D,CAAC;KAAA;CACF;AALD,8CAKC"}
+{"version":3,"file":"sequence.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/sequence.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,qCAAwE;AAExE,MAAa,iBAA+C,SAAQ,8BAA8C;IAC1G,QAAQ,CAAC,cAAkC;;YAC/C,MAAM,EAAE,UAAU,EAAE,GAAG,cAAc,CAAA;YACrC,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAC9D,CAAC;KAAA;CACF;AALD,8CAKC","sourcesContent":["import { ExpressionContext } from '../../context'\nimport { ExpressionNodeEvaluator, SequenceExpression } from '../../node'\n\nexport class SequenceEvaluator<C extends ExpressionContext> extends ExpressionNodeEvaluator<C, SequenceExpression> {\n  async evaluate(expressionNode: SequenceExpression): Promise<any> {\n    const { expression } = expressionNode\n    return this.evaluator.evaluateNode(expression, this.context)\n  }\n}\n"]}

package/dist/expression/javascript/node/this.js.map

@@ -1 +1 @@
-{"version":3,"file":"this.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/this.ts"],"names":[],"mappings":";;;AAAA,0CAA4C;AAE5C,qCAAoE;AAEpE,MAAa,aAA2C,SAAQ,8BAA0C;IACxG,QAAQ;QACN,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,mBAAW,CAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IACrF,CAAC;CACF;AAJD,sCAIC"}
+{"version":3,"file":"this.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/this.ts"],"names":[],"mappings":";;;AAAA,0CAA4C;AAE5C,qCAAoE;AAEpE,MAAa,aAA2C,SAAQ,8BAA0C;IACxG,QAAQ;QACN,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,mBAAW,CAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IACrF,CAAC;CACF;AAJD,sCAIC","sourcesContent":["import { SystemError } from '../../../error'\nimport { ExpressionContext } from '../../context'\nimport { ExpressionNodeEvaluator, ThisExpression } from '../../node'\n\nexport class ThisEvaluator<C extends ExpressionContext> extends ExpressionNodeEvaluator<C, ThisExpression> {\n  evaluate(): Promise<any> {\n    return Promise.reject(new SystemError('expression.notSupported', { type: 'this' }))\n  }\n}\n"]}

package/dist/expression/javascript/node/unary.js

@@ -13,8 +13,16 @@ exports.UnaryEvaluator = void 0;
 const error_1 = require("../../../error");
 const node_1 = require("../../node");
 const unaryOperators = {
+    // Only accept bools and nulls as input.
+    // Otherwise return null
     '!': (x) => (x === null || x === undefined || x.constructor === Boolean ? !x : null),
+    // Negation: Only accept normal finite numbers, otherwise return null
+    // NOTE: Under JS semantics, we would have -"123" -> -123
     '-': (x) => (Number.isFinite(x) ? -x : null),
+    // Don't allow the unary + operator now. Define semantics for it first.
+    // Under JS semantics, "+" coerces a string to a number.
+    // Maybe we should just have `parseNumber` in `stdlib`?
+    // '+': x => R.isNil(x) ? null : +x,
 };
 class UnaryEvaluator extends node_1.ExpressionNodeEvaluator {
     evaluate(expressionNode) {

package/dist/expression/javascript/node/unary.js.map

@@ -1 +1 @@
-{"version":3,"file":"unary.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/unary.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,0CAA4C;AAE5C,qCAAqE;AAErE,MAAM,cAAc,GAAuC;IAGzD,GAAG,EAAE,CAAC,CAAM,EAAkB,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAIzG,GAAG,EAAE,CAAC,CAAM,EAAiB,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;CAMjE,CAAA;AAED,MAAa,cAA4C,SAAQ,8BAA2C;IACpG,QAAQ,CAAC,cAA+B;;YAC5C,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAA;YAC7C,MAAM,EAAE,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;YAEnC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,MAAM,IAAI,mBAAW,CAAC,sCAAsC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAA;YAC7E,CAAC;YAED,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;YACrE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAA;QAChB,CAAC;KAAA;CACF;AAZD,wCAYC"}
+{"version":3,"file":"unary.js","sourceRoot":"","sources":["../../../../src/expression/javascript/node/unary.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,0CAA4C;AAE5C,qCAAqE;AAErE,MAAM,cAAc,GAAuC;IACzD,wCAAwC;IACxC,wBAAwB;IACxB,GAAG,EAAE,CAAC,CAAM,EAAkB,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEzG,qEAAqE;IACrE,yDAAyD;IACzD,GAAG,EAAE,CAAC,CAAM,EAAiB,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEhE,uEAAuE;IACvE,wDAAwD;IACxD,uDAAuD;IACvD,oCAAoC;CACrC,CAAA;AAED,MAAa,cAA4C,SAAQ,8BAA2C;IACpG,QAAQ,CAAC,cAA+B;;YAC5C,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAA;YAC7C,MAAM,EAAE,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;YAEnC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,MAAM,IAAI,mBAAW,CAAC,sCAAsC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAA;YAC7E,CAAC;YAED,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;YACrE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAA;QAChB,CAAC;KAAA;CACF;AAZD,wCAYC","sourcesContent":["import { SystemError } from '../../../error'\nimport { ExpressionContext } from '../../context'\nimport { ExpressionNodeEvaluator, UnaryExpression } from '../../node'\n\nconst unaryOperators: { [key: string]: (x: any) => any } = {\n  // Only accept bools and nulls as input.\n  // Otherwise return null\n  '!': (x: any): boolean | null => (x === null || x === undefined || x.constructor === Boolean ? !x : null),\n\n  // Negation: Only accept normal finite numbers, otherwise return null\n  // NOTE: Under JS semantics, we would have -\"123\" -> -123\n  '-': (x: any): number | null => (Number.isFinite(x) ? -x : null),\n\n  // Don't allow the unary + operator now. Define semantics for it first.\n  // Under JS semantics, \"+\" coerces a string to a number.\n  // Maybe we should just have `parseNumber` in `stdlib`?\n  // '+': x => R.isNil(x) ? null : +x,\n}\n\nexport class UnaryEvaluator<C extends ExpressionContext> extends ExpressionNodeEvaluator<C, UnaryExpression> {\n  async evaluate(expressionNode: UnaryExpression): Promise<any> {\n    const { argument, operator } = expressionNode\n    const fn = unaryOperators[operator]\n\n    if (!fn) {\n      throw new SystemError('expression.unaryOperatorNotSupported', { operator })\n    }\n\n    const res = await this.evaluator.evaluateNode(argument, this.context)\n    return fn(res)\n  }\n}\n"]}

package/dist/expression/javascript/parser/jsep.js

@@ -8,15 +8,19 @@ const jsep_1 = __importDefault(require("jsep"));
 exports.jsep = jsep_1.default;
 const regex_1 = __importDefault(require("@jsep-plugin/regex"));
 jsep_1.default.plugins.register(regex_1.default);
+// Add exponentiation operator (right-to-left)
 jsep_1.default.addBinaryOp('**', 11, true);
-const OPEN_PARENTHESIS_CODE = 40;
-const CLOSE_PARENTHESIS_CODE = 41;
+const OPEN_PARENTHESIS_CODE = 40; // (
+const CLOSE_PARENTHESIS_CODE = 41; // )
 const SEQUENCE_EXPRESSION = 'SequenceExpression';
+// keep sequence expressions in parsed expression, even when there is only one node inside of it
+// (by default the unnecessary enclosing parenthesis of a sequence expression are omitted, but this won't work in the basic expression editor)
 const sequenceExpressionPlugin = {
     name: 'the plugin',
     init(thisJsep) {
         thisJsep.hooks.add('gobble-token', (env) => {
             const { context } = env;
+            // token starts with
             if (!thisJsep.isIdentifierStart(context.code) && context.code === OPEN_PARENTHESIS_CODE) {
                 context.index += 1;
                 let nodes = context.gobbleExpressions(CLOSE_PARENTHESIS_CODE);

package/dist/expression/javascript/parser/jsep.js.map

@@ -1 +1 @@
-{"version":3,"file":"jsep.js","sourceRoot":"","sources":["../../../../src/expression/javascript/parser/jsep.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAuB;AA0Cd,eA1CF,cAAI,CA0CE;AAzCb,+DAA0C;AAE1C,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAoC,CAAC,CAAA;AAG3D,cAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAA;AAEhC,MAAM,qBAAqB,GAAG,EAAE,CAAA;AAChC,MAAM,sBAAsB,GAAG,EAAE,CAAA;AAEjC,MAAM,mBAAmB,GAAG,oBAAoB,CAAA;AAIhD,MAAM,wBAAwB,GAAG;IAC/B,IAAI,EAAE,YAAY;IAClB,IAAI,CAAC,QAAa;QAChB,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,GAAQ,EAAQ,EAAE;YACpD,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,CAAA;YAEvB,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;gBACxF,OAAO,CAAC,KAAK,IAAI,CAAC,CAAA;gBAClB,IAAI,KAAK,GAAG,OAAO,CAAC,iBAAiB,CAAC,sBAAsB,CAAC,CAAA;gBAC7D,IAAI,OAAO,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;oBAC5C,OAAO,CAAC,KAAK,IAAI,CAAC,CAAA;oBAClB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACrB,GAAG,CAAC,IAAI,GAAG;4BACT,IAAI,EAAE,mBAAmB;4BACzB,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;yBACrB,CAAA;oBACH,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAA;gBAClC,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AAED,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,wBAAwC,CAAC,CAAA"}
+{"version":3,"file":"jsep.js","sourceRoot":"","sources":["../../../../src/expression/javascript/parser/jsep.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAuB;AA0Cd,eA1CF,cAAI,CA0CE;AAzCb,+DAA0C;AAE1C,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAoC,CAAC,CAAA;AAE3D,8CAA8C;AAC9C,cAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAA;AAEhC,MAAM,qBAAqB,GAAG,EAAE,CAAA,CAAC,IAAI;AACrC,MAAM,sBAAsB,GAAG,EAAE,CAAA,CAAC,IAAI;AAEtC,MAAM,mBAAmB,GAAG,oBAAoB,CAAA;AAEhD,gGAAgG;AAChG,8IAA8I;AAC9I,MAAM,wBAAwB,GAAG;IAC/B,IAAI,EAAE,YAAY;IAClB,IAAI,CAAC,QAAa;QAChB,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,GAAQ,EAAQ,EAAE;YACpD,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,CAAA;YACvB,oBAAoB;YACpB,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;gBACxF,OAAO,CAAC,KAAK,IAAI,CAAC,CAAA;gBAClB,IAAI,KAAK,GAAG,OAAO,CAAC,iBAAiB,CAAC,sBAAsB,CAAC,CAAA;gBAC7D,IAAI,OAAO,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;oBAC5C,OAAO,CAAC,KAAK,IAAI,CAAC,CAAA;oBAClB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACrB,GAAG,CAAC,IAAI,GAAG;4BACT,IAAI,EAAE,mBAAmB;4BACzB,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;yBACrB,CAAA;oBACH,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAA;gBAClC,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AAED,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,wBAAwC,CAAC,CAAA","sourcesContent":["import jsep from 'jsep'\nimport jsepRegex from '@jsep-plugin/regex'\n\njsep.plugins.register(jsepRegex as unknown as jsep.IPlugin)\n\n// Add exponentiation operator (right-to-left)\njsep.addBinaryOp('**', 11, true)\n\nconst OPEN_PARENTHESIS_CODE = 40 // (\nconst CLOSE_PARENTHESIS_CODE = 41 // )\n\nconst SEQUENCE_EXPRESSION = 'SequenceExpression'\n\n// keep sequence expressions in parsed expression, even when there is only one node inside of it\n// (by default the unnecessary enclosing parenthesis of a sequence expression are omitted, but this won't work in the basic expression editor)\nconst sequenceExpressionPlugin = {\n  name: 'the plugin',\n  init(thisJsep: any) {\n    thisJsep.hooks.add('gobble-token', (env: any): void => {\n      const { context } = env\n      // token starts with\n      if (!thisJsep.isIdentifierStart(context.code) && context.code === OPEN_PARENTHESIS_CODE) {\n        context.index += 1\n        let nodes = context.gobbleExpressions(CLOSE_PARENTHESIS_CODE)\n        if (context.code === CLOSE_PARENTHESIS_CODE) {\n          context.index += 1\n          if (nodes.length > 0) {\n            env.node = {\n              type: SEQUENCE_EXPRESSION,\n              expression: nodes[0],\n            }\n          }\n        } else {\n          context.throwError('Unclosed (')\n        }\n      }\n    })\n  },\n}\n\njsep.plugins.register(sequenceExpressionPlugin as jsep.IPlugin)\n\nexport { jsep }\n"]}

package/dist/expression/javascript/parser/parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../../src/expression/javascript/parser/parser.ts"],"names":[],"mappings":";;;AAEA,iCAA6B;AAE7B,MAAa,0BAA0B;IACrC,KAAK,CAAC,UAAkB;QACtB,OAAO,IAAA,WAAI,EAAC,UAAU,CAAuC,CAAA;IAC/D,CAAC;CACF;AAJD,gEAIC"}
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../../src/expression/javascript/parser/parser.ts"],"names":[],"mappings":";;;AAEA,iCAA6B;AAE7B,MAAa,0BAA0B;IACrC,KAAK,CAAC,UAAkB;QACtB,OAAO,IAAA,WAAI,EAAC,UAAU,CAAuC,CAAA;IAC/D,CAAC;CACF;AAJD,gEAIC","sourcesContent":["import { ExpressionNode, ExpressionNodeType } from '../../node'\nimport { ExpressionParser } from '../../parser'\nimport { jsep } from './jsep'\n\nexport class JavascriptExpressionParser implements ExpressionParser {\n  parse(expression: string): ExpressionNode<ExpressionNodeType> {\n    return jsep(expression) as ExpressionNode<ExpressionNodeType>\n  }\n}\n"]}

package/dist/expression/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/expression/node.ts"],"names":[],"mappings":";;;AAGA,IAAY,kBAYX;AAZD,WAAY,kBAAkB;IAC5B,+CAAyB,CAAA;IACzB,iDAA2B,CAAA;IAC3B,6CAAuB,CAAA;IACvB,2CAAqB,CAAA;IACrB,2DAAqC,CAAA;IACrC,+CAAyB,CAAA;IACzB,yCAAmB,CAAA;IACnB,iDAA2B,CAAA;IAC3B,qDAA+B,CAAA;IAC/B,6CAAuB,CAAA;IACvB,+CAAyB,CAAA;AAC3B,CAAC,EAZW,kBAAkB,kCAAlB,kBAAkB,QAY7B;AAsDD,MAAsB,uBAAuB;IAO3C,YAAY,SAAiC,EAAE,OAAU;QACvD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;CAGF;AAbD,0DAaC"}
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/expression/node.ts"],"names":[],"mappings":";;;AAGA,IAAY,kBAYX;AAZD,WAAY,kBAAkB;IAC5B,+CAAyB,CAAA;IACzB,iDAA2B,CAAA;IAC3B,6CAAuB,CAAA;IACvB,2CAAqB,CAAA;IACrB,2DAAqC,CAAA;IACrC,+CAAyB,CAAA;IACzB,yCAAmB,CAAA;IACnB,iDAA2B,CAAA;IAC3B,qDAA+B,CAAA;IAC/B,6CAAuB,CAAA;IACvB,+CAAyB,CAAA;AAC3B,CAAC,EAZW,kBAAkB,kCAAlB,kBAAkB,QAY7B;AAsDD,MAAsB,uBAAuB;IAO3C,YAAY,SAAiC,EAAE,OAAU;QACvD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;CAGF;AAbD,0DAaC","sourcesContent":["import { ExpressionEvaluator } from './evaluator'\nimport { ExpressionContext } from './context'\n\nexport enum ExpressionNodeType {\n  Array = 'ArrayExpression',\n  Binary = 'BinaryExpression',\n  Call = 'CallExpression',\n  Compound = 'Compound',\n  Conditional = 'ConditionalExpression',\n  Identifier = 'Identifier',\n  Literal = 'Literal',\n  Member = 'MemberExpression',\n  Sequence = 'SequenceExpression',\n  This = 'ThisExpression',\n  Unary = 'UnaryExpression',\n}\n\nexport interface ExpressionNode<T extends ExpressionNodeType> {\n  type: T\n}\n\nexport interface ArrayExpression extends ExpressionNode<ExpressionNodeType.Array> {\n  elements: Array<ExpressionNode<ExpressionNodeType>>\n}\nexport interface BinaryExpression extends ExpressionNode<ExpressionNodeType.Binary> {\n  left: ExpressionNode<ExpressionNodeType>\n  right: ExpressionNode<ExpressionNodeType>\n  operator: string\n}\nexport interface CallExpression extends ExpressionNode<ExpressionNodeType.Call> {\n  arguments: Array<ExpressionNode<ExpressionNodeType>>\n  callee: ExpressionNode<ExpressionNodeType>\n}\nexport type CompoundExpression = ExpressionNode<ExpressionNodeType.Compound>\nexport interface ConditionalExpression extends ExpressionNode<ExpressionNodeType.Conditional> {\n  test: ExpressionNode<ExpressionNodeType>\n  consequent: ExpressionNode<ExpressionNodeType>\n  alternate: ExpressionNode<ExpressionNodeType>\n}\nexport interface IdentifierExpression extends ExpressionNode<ExpressionNodeType.Identifier> {\n  name: string\n}\nexport interface LiteralExpression extends ExpressionNode<ExpressionNodeType.Literal> {\n  raw: string\n  value: any\n}\nexport interface MemberExpression extends ExpressionNode<ExpressionNodeType.Member> {\n  computed: boolean\n  object: ExpressionNode<ExpressionNodeType>\n  property: ExpressionNode<ExpressionNodeType>\n  optional?: boolean\n}\nexport interface SequenceExpression extends ExpressionNode<ExpressionNodeType.Sequence> {\n  expression: ExpressionNode<ExpressionNodeType>\n}\nexport type ThisExpression = ExpressionNode<ExpressionNodeType.This>\nexport interface UnaryExpression extends ExpressionNode<ExpressionNodeType.Unary> {\n  argument: ExpressionNode<ExpressionNodeType>\n  operator: string\n  prefix: boolean\n}\n\nexport interface ExpressionNodeEvaluatorConstructor<\n  C extends ExpressionContext,\n  N extends ExpressionNode<ExpressionNodeType>,\n> {\n  new (evaluator: ExpressionEvaluator<C>, context: C): ExpressionNodeEvaluator<C, N>\n}\n\nexport abstract class ExpressionNodeEvaluator<\n  C extends ExpressionContext,\n  N extends ExpressionNode<ExpressionNodeType>,\n> {\n  readonly evaluator: ExpressionEvaluator<C>\n  readonly context: C\n\n  constructor(evaluator: ExpressionEvaluator<C>, context: C) {\n    this.evaluator = evaluator\n    this.context = context\n  }\n\n  abstract evaluate(expressionNode: N): Promise<any>\n}\n"]}

package/dist/expression/parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/expression/parser.ts"],"names":[],"mappings":""}
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/expression/parser.ts"],"names":[],"mappings":"","sourcesContent":["import { ExpressionNode, ExpressionNodeType } from './node'\n\nexport interface ExpressionParser {\n  parse(expression: string): ExpressionNode<ExpressionNodeType>\n}\n"]}

package/dist/expression/variable.js.map

@@ -1 +1 @@
-{"version":3,"file":"variable.js","sourceRoot":"","sources":["../../src/expression/variable.ts"],"names":[],"mappings":";;;AAAA,IAAY,kBAEX;AAFD,WAAY,kBAAkB;IAC5B,0CAAoB,CAAA;AACtB,CAAC,EAFW,kBAAkB,kCAAlB,kBAAkB,QAE7B"}
+{"version":3,"file":"variable.js","sourceRoot":"","sources":["../../src/expression/variable.ts"],"names":[],"mappings":";;;AAAA,IAAY,kBAEX;AAFD,WAAY,kBAAkB;IAC5B,0CAAoB,CAAA;AACtB,CAAC,EAFW,kBAAkB,kCAAlB,kBAAkB,QAE7B","sourcesContent":["export enum ExpressionVariable {\n  CONTEXT = '$context',\n}\n"]}