@olaboot/esm-form-engine-lib 4.1.0

package/dist/utils/common-utils.test.js

@@ -0,0 +1,134 @@
+import { clearSubmission, flattenObsList, gracefullySetSubmission, hasRendering, hasSubmission, parseToLocalDateTime } from "./common-utils.js";
+import { isEmpty } from "../validators/form-validator.js";
+import { obsList } from "__mocks__/forms";
+jest.mock('../validators/form-validator', ()=>({
+        isEmpty: jest.fn()
+    }));
+describe('utils functions', ()=>{
+    describe('flattenObsList', ()=>{
+        it('should flatten a nested obs list', ()=>{
+            const result = flattenObsList(obsList);
+            expect(result).toHaveLength(2);
+        });
+    });
+    describe('hasRendering', ()=>{
+        it('should return true if the field has the specified rendering', ()=>{
+            const field = {
+                label: 'Test Field',
+                type: 'obs',
+                questionOptions: {
+                    rendering: 'text'
+                },
+                id: 'testFieldId'
+            };
+            expect(hasRendering(field, 'text')).toBe(true);
+        });
+        it('should return false if the field does not have the specified rendering', ()=>{
+            const field = {
+                label: 'Test Field',
+                type: 'obs',
+                questionOptions: {
+                    rendering: 'textarea'
+                },
+                id: 'testFieldId'
+            };
+            expect(hasRendering(field, 'text')).toBe(false);
+        });
+    });
+    describe('clearSubmission', ()=>{
+        it('should initialize the submission object if not present and clear values', ()=>{
+            const field = {
+                label: 'Test Field',
+                type: 'obs',
+                questionOptions: {},
+                id: 'testFieldId',
+                meta: {}
+            };
+            clearSubmission(field);
+            expect(field.meta.submission).toEqual({
+                voidedValue: null,
+                newValue: null
+            });
+        });
+    });
+    describe('gracefullySetSubmission', ()=>{
+        it('should set the newValue and voidedValue correctly', ()=>{
+            const field = {
+                label: 'Test Field',
+                type: 'obs',
+                questionOptions: {},
+                id: 'testFieldId',
+                meta: {}
+            };
+            isEmpty.mockReturnValueOnce(false).mockReturnValueOnce(false);
+            const newValue = 'new value';
+            const voidedValue = 'voided value';
+            gracefullySetSubmission(field, newValue, voidedValue);
+            expect(field.meta.submission).toEqual({
+                voidedValue: 'voided value',
+                newValue: 'new value'
+            });
+        });
+        it('should not set values if they are empty', ()=>{
+            const field = {
+                label: 'Test Field',
+                type: 'obs',
+                questionOptions: {},
+                id: 'testFieldId',
+                meta: {}
+            };
+            isEmpty.mockReturnValueOnce(true).mockReturnValueOnce(true);
+            gracefullySetSubmission(field, '', '');
+            expect(field.meta.submission).toEqual({});
+        });
+    });
+    describe('hasSubmission', ()=>{
+        it('should return true if there is a newValue or voidedValue', ()=>{
+            const field = {
+                label: 'Test Field',
+                type: 'obs',
+                questionOptions: {},
+                id: 'testFieldId',
+                meta: {
+                    submission: {
+                        newValue: 'new value',
+                        voidedValue: 'voided value'
+                    }
+                }
+            };
+            expect(hasSubmission(field)).toBe(true);
+        });
+        it('should return false if there is no newValue or voidedValue', ()=>{
+            const field = {
+                label: 'Test Field',
+                type: 'obs',
+                questionOptions: {},
+                id: 'testFieldId',
+                meta: {}
+            };
+            expect(hasSubmission(field)).toBe(false);
+        });
+    });
+});
+describe('parseToLocalDateTime', ()=>{
+    it('should parse valid date string with time correctly', ()=>{
+        const dateString = '2023-06-27T14:30:00';
+        const expectedDate = new Date(2023, 5, 27, 14, 30, 0);
+        const parsedDate = parseToLocalDateTime(dateString);
+        expect(parsedDate).toEqual(expectedDate);
+    });
+    it('should parse valid date string without time correctly', ()=>{
+        const dateString = '2023-06-27';
+        const expectedDate = new Date(2023, 5, 27);
+        const parsedDate = parseToLocalDateTime(dateString);
+        // Set hours, minutes, and seconds to 0 since the input doesn't contain time
+        expectedDate.setHours(0, 0, 0, 0);
+        expect(parsedDate).toEqual(expectedDate);
+    });
+    it('should handle invalid date string format gracefully', ()=>{
+        const dateString = 'invalid-date-string';
+        const parsedDate = parseToLocalDateTime(dateString);
+        // Check if the parsedDate is an Invalid Date
+        expect(isNaN(parsedDate.getTime())).toBe(true);
+    });
+});

package/dist/utils/error-utils.d.ts

@@ -0,0 +1,11 @@
+export declare function reportError(error: Error, title: string): void;
+/**
+ * Extracts error messages from a given error response object.
+ * If fieldErrors are present, it extracts the error messages from each field.
+ * Otherwise, it returns the top-level error message.
+ *
+ * @param {object} errorObject - The error response object.
+ * @returns {string[]} An array of error messages.
+ */
+export declare function extractErrorMessagesFromResponse(errorObject: any): any;
+//# sourceMappingURL=error-utils.d.ts.map

package/dist/utils/error-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-utils.d.ts","sourceRoot":"","sources":["../../src/utils/error-utils.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAW7D;AAED;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAAC,WAAW,KAAA,OAa3D"}

package/dist/utils/error-utils.js

@@ -0,0 +1,34 @@
+import { showSnackbar } from "@openmrs/esm-framework";
+export function reportError(error, title) {
+    if (error) {
+        const errorMessage = extractErrorMessagesFromResponse(error).join(', ');
+        console.error(error);
+        showSnackbar({
+            subtitle: errorMessage,
+            title: title,
+            kind: 'error',
+            isLowContrast: false
+        });
+    }
+}
+/**
+ * Extracts error messages from a given error response object.
+ * If fieldErrors are present, it extracts the error messages from each field.
+ * Otherwise, it returns the top-level error message.
+ *
+ * @param {object} errorObject - The error response object.
+ * @returns {string[]} An array of error messages.
+ */ export function extractErrorMessagesFromResponse(errorObject) {
+    const fieldErrors = errorObject?.responseBody?.error?.fieldErrors;
+    const globalErrors = errorObject?.responseBody?.error?.globalErrors;
+    if ((!fieldErrors || Object.keys(fieldErrors).length === 0) && !globalErrors) {
+        return [
+            errorObject?.responseBody?.error?.message ?? errorObject?.message
+        ];
+    }
+    if (globalErrors?.length) {
+        return globalErrors.flatMap((error)=>error.message);
+    } else {
+        return Object.values(fieldErrors).flatMap((errors)=>errors.map((error)=>error.message));
+    }
+}

package/dist/utils/expression-runner.d.ts

@@ -0,0 +1,25 @@
+import { type OpenmrsEncounter, type FormField, type FormPage, type FormSection } from '../types';
+import { compile, type DefaultEvaluateReturnType, type Visit } from '@openmrs/esm-framework';
+export interface FormNode {
+    value: FormPage | FormSection | FormField;
+    type: 'field' | 'page' | 'section';
+}
+export interface ExpressionContext {
+    mode: 'enter' | 'edit' | 'view' | 'embedded-view';
+    myValue?: any;
+    patient: any;
+    previousEncounter?: OpenmrsEncounter;
+    visit?: Visit;
+}
+export type EvaluateReturnType = DefaultEvaluateReturnType | Record<string, any>;
+export declare const astCache: Map<any, any>;
+export declare function evaluateExpression(expression: string, node: FormNode, fields: Array<FormField>, fieldValues: Record<string, any>, context: ExpressionContext): any;
+export declare function evaluateAsyncExpression(expression: string, node: FormNode, fields: Array<FormField>, fieldValues: Record<string, any>, context: ExpressionContext): Promise<any>;
+/**
+ * Extracts all referenced fields in the expression and registers them as dependencies.
+ * @param expression - The expression to track dependencies for.
+ * @param fieldNode - The node representing the field.
+ * @param allFields - The list of all fields in the form.
+ */
+export declare function trackFieldDependencies(expression: ReturnType<typeof compile>, fieldNode: FormNode, allFields: FormField[]): void;
+//# sourceMappingURL=expression-runner.d.ts.map

package/dist/utils/expression-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-runner.d.ts","sourceRoot":"","sources":["../../src/utils/expression-runner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAGlG,OAAO,EACL,OAAO,EACP,KAAK,yBAAyB,EAK9B,KAAK,KAAK,EACX,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;IAC1C,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,eAAe,CAAC;IAClD,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,OAAO,EAAE,GAAG,CAAC;IACb,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;IACrC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,MAAM,kBAAkB,GAAG,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAEjF,eAAO,MAAM,QAAQ,eAAY,CAAC;AAclC,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,EACxB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChC,OAAO,EAAE,iBAAiB,GACzB,GAAG,CAaL;AAED,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,EACxB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,GAAG,CAAC,CAkBd;AA+DD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,EACtC,SAAS,EAAE,QAAQ,EACnB,SAAS,EAAE,SAAS,EAAE,QAUvB"}

package/dist/utils/expression-runner.js

@@ -0,0 +1,104 @@
+import { getRegisteredExpressionHelpers } from "../registry/registry.js";
+import { isEmpty } from "lodash-es";
+import { CommonExpressionHelpers, registerDependency, simpleHash } from "./common-expression-helpers.js";
+import { HistoricalDataSourceService } from "../datasources/historical-data-source.js";
+import { compile, evaluateAsType, evaluateAsTypeAsync, extractVariableNames } from "@openmrs/esm-framework";
+export const astCache = new Map();
+function typePredicate(result) {
+    return typeof result === 'string' || typeof result === 'number' || typeof result === 'boolean' || typeof result === 'undefined' || typeof result === 'object' || // Support for arbitrary objects
+    result === null || result === undefined;
+}
+export function evaluateExpression(expression, node, fields, fieldValues, context) {
+    if (!expression?.trim()) {
+        return null;
+    }
+    const compiledExpression = getExpressionAst(expression);
+    // track dependencies
+    trackFieldDependencies(compiledExpression, node, fields);
+    try {
+        return evaluateAsType(compiledExpression, getEvaluationContext(node, fields, fieldValues, context), typePredicate);
+    } catch (error) {
+        console.error(`Error: ${error} \n\n failing expression: ${expression}`);
+    }
+    return null;
+}
+export async function evaluateAsyncExpression(expression, node, fields, fieldValues, context) {
+    if (!expression?.trim()) {
+        return null;
+    }
+    const compiledExpression = getExpressionAst(expression);
+    // track dependencies
+    trackFieldDependencies(compiledExpression, node, fields);
+    try {
+        return evaluateAsTypeAsync(compiledExpression, getEvaluationContext(node, fields, fieldValues, context), typePredicate);
+    } catch (error) {
+        console.error(`Error: ${error} \n\n failing expression: ${expression}`);
+    }
+    return null;
+}
+function getEvaluationContext(node, formFields, fieldValues, context) {
+    let { myValue, patient } = context;
+    const { sex, age } = patient ?? {};
+    if (node.type === 'field' && myValue === undefined && node.value) {
+        myValue = fieldValues[node.value['id']];
+    }
+    const HD = new HistoricalDataSourceService();
+    HD.putObject('prevEnc', {
+        value: context.previousEncounter || {
+            obs: []
+        },
+        getValue (concept) {
+            return this.value.obs.find((obs)=>obs.concept.uuid == concept);
+        }
+    });
+    const visit = context?.visit ?? {};
+    const visitType = visit?.visitType || {
+        uuid: ''
+    };
+    const visitTypeUuid = visitType.uuid ?? '';
+    const _ = {
+        isEmpty
+    };
+    return {
+        ...new CommonExpressionHelpers(node, patient, formFields, fieldValues),
+        ...getRegisteredExpressionHelpers(),
+        ...context,
+        ...fieldValues,
+        patient,
+        myValue,
+        sex,
+        age,
+        HD,
+        visit,
+        visitType,
+        visitTypeUuid,
+        _
+    };
+}
+/**
+ * Compiles an expression into an abstract syntax tree (AST) and caches the result.
+ * @param expression - The expression to compile.
+ * @returns The abstract syntax tree (AST) of the compiled expression.
+ */ function getExpressionAst(expression) {
+    const hash = simpleHash(expression);
+    if (astCache.has(hash)) {
+        return astCache.get(hash);
+    }
+    const ast = compile(expression);
+    astCache.set(hash, ast);
+    return ast;
+}
+/**
+ * Extracts all referenced fields in the expression and registers them as dependencies.
+ * @param expression - The expression to track dependencies for.
+ * @param fieldNode - The node representing the field.
+ * @param allFields - The list of all fields in the form.
+ */ export function trackFieldDependencies(expression, fieldNode, allFields) {
+    const variables = extractVariableNames(expression);
+    for (const variable of variables){
+        const field = allFields.find((field)=>field.id === variable);
+        if (field) {
+            registerDependency(fieldNode, field);
+        }
+    }
+}

package/dist/utils/expression-runner.test.js

@@ -0,0 +1,362 @@
+import { registerExpressionHelper } from "../index.js";
+import { evaluateAsyncExpression, evaluateExpression } from "./expression-runner.js";
+export const testFields = [
+    {
+        label: 'Was the client linked to care and treatment in this facility?',
+        type: 'obs',
+        questionOptions: {
+            rendering: 'radio',
+            concept: 'e8e8fe71-adbb-48e7-b531-589985094d30',
+            answers: [
+                {
+                    concept: 'cf82933b-3f3f-45e7-a5ab-5d31aaee3da3',
+                    label: 'Yes'
+                },
+                {
+                    concept: '488b58ff-64f5-4f8a-8979-fa79940b1594',
+                    label: 'No'
+                }
+            ]
+        },
+        id: 'linkedToCare'
+    },
+    {
+        label: 'What Identification Number was issued to the client?',
+        type: 'obs',
+        questionOptions: {
+            rendering: 'text',
+            concept: '162576AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'
+        },
+        id: 'patientIdentificationNumber'
+    },
+    {
+        label: 'Which of the following prevention services was the client referred to?',
+        type: 'obs',
+        questionOptions: {
+            rendering: 'checkbox',
+            concept: '5f394708-ca7d-4558-8d23-a73de181b02d',
+            answers: [
+                {
+                    concept: '88cdde2b-753b-48ac-a51a-ae5e1ab24846',
+                    label: 'Pre Exposure Prophylaxis (PEP)'
+                },
+                {
+                    concept: '46da10c7-49e3-45e5-8e82-7c529d52a1a8',
+                    label: 'STI Testing and Treatment'
+                },
+                {
+                    concept: '1691AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
+                    label: 'Post-exposure prophylaxis'
+                },
+                {
+                    concept: '162223AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
+                    label: 'Voluntary male circumcision clinic'
+                }
+            ]
+        },
+        id: 'referredToPreventionServices'
+    },
+    {
+        label: 'What were the HTS provider’s remarks?',
+        type: 'obs',
+        questionOptions: {
+            rendering: 'textarea',
+            concept: '437d1e25-e7ab-481c-aabc-01f21c6cdef1'
+        },
+        id: 'htsProviderRemarks'
+    },
+    {
+        label: 'Body Temperature',
+        type: 'obs',
+        questionOptions: {
+            rendering: 'number',
+            concept: '537d1e25-e7av-481c-aabc-01f21c6cdefo'
+        },
+        id: 'bodyTemperature'
+    },
+    {
+        label: 'Date of Birth',
+        type: 'obs',
+        questionOptions: {
+            rendering: 'date',
+            concept: 'date_of_birth_concept'
+        },
+        id: 'dateOfBirth'
+    },
+    {
+        label: 'Age in Days',
+        type: 'obs',
+        questionOptions: {
+            rendering: 'number',
+            concept: 'age_in_days_concept'
+        },
+        id: 'ageInDays'
+    }
+];
+export const fields = [
+    {
+        label: 'No Interest',
+        type: 'obs',
+        questionOptions: {
+            rendering: 'radio',
+            concept: 'no_interest_concept',
+            answers: []
+        },
+        id: 'no_interest'
+    },
+    {
+        label: 'Depressed',
+        type: 'obs',
+        questionOptions: {
+            rendering: 'radio',
+            concept: 'depressed_concept',
+            answers: []
+        },
+        id: 'depressed'
+    },
+    {
+        label: 'Bad Sleep',
+        type: 'obs',
+        questionOptions: {
+            rendering: 'radio',
+            concept: 'bad_sleep_concept',
+            answers: []
+        },
+        id: 'bad_sleep'
+    },
+    {
+        label: 'Feeling Tired',
+        type: 'obs',
+        questionOptions: {
+            rendering: 'radio',
+            concept: 'feeling_tired_concept',
+            answers: []
+        },
+        id: 'feeling_tired'
+    },
+    {
+        label: 'Poor Appetite',
+        type: 'obs',
+        questionOptions: {
+            rendering: 'radio',
+            concept: 'poor_appetite_concept',
+            answers: []
+        },
+        id: 'poor_appetite'
+    },
+    {
+        label: 'Troubled',
+        type: 'obs',
+        questionOptions: {
+            rendering: 'radio',
+            concept: 'troubled_concept',
+            answers: []
+        },
+        id: 'troubled'
+    },
+    {
+        label: 'Feeling Bad',
+        type: 'obs',
+        questionOptions: {
+            rendering: 'radio',
+            concept: 'feeling_bad_concept',
+            answers: []
+        },
+        id: 'feeling_bad'
+    },
+    {
+        label: 'Speaking Slowly',
+        type: 'obs',
+        questionOptions: {
+            rendering: 'radio',
+            concept: 'speaking_slowly_concept',
+            answers: []
+        },
+        id: 'speaking_slowly'
+    },
+    {
+        label: 'Better Off Dead',
+        type: 'obs',
+        questionOptions: {
+            rendering: 'radio',
+            concept: 'better_dead_concept',
+            answers: []
+        },
+        id: 'better_dead'
+    }
+];
+describe('Expression runner', ()=>{
+    const context = {
+        mode: 'enter',
+        patient: {}
+    };
+    const allFields = JSON.parse(JSON.stringify(testFields));
+    let valuesMap = {
+        linkedToCare: '',
+        patientIdentificationNumber: '',
+        htsProviderRemarks: '',
+        referredToPreventionServices: [],
+        bodyTemperature: 0,
+        dateOfBirth: '',
+        ageInDays: 0,
+        no_interest: '',
+        depressed: '',
+        bad_sleep: '',
+        feeling_tired: '',
+        poor_appetite: '',
+        troubled: '',
+        feeling_bad: '',
+        speaking_slowly: '',
+        better_dead: ''
+    };
+    afterEach(()=>{
+        // teardown
+        valuesMap = {
+            linkedToCare: '',
+            patientIdentificationNumber: '',
+            htsProviderRemarks: '',
+            referredToPreventionServices: [],
+            bodyTemperature: 0,
+            dateOfBirth: '',
+            ageInDays: 0,
+            no_interest: '',
+            depressed: '',
+            bad_sleep: '',
+            feeling_tired: '',
+            poor_appetite: '',
+            troubled: '',
+            feeling_bad: '',
+            speaking_slowly: '',
+            better_dead: ''
+        };
+        allFields.forEach((field)=>{
+            field.fieldDependents = undefined;
+        });
+    });
+    it('should support unary expressions', ()=>{
+        // replay and verify
+        expect(evaluateExpression('true', {
+            value: allFields[0],
+            type: 'field'
+        }, allFields, valuesMap, context)).toBeTruthy();
+        // replay and verify
+        expect(evaluateExpression('!true', {
+            value: allFields[0],
+            type: 'field'
+        }, allFields, valuesMap, context)).toBeFalsy();
+        // replay and verify
+        expect(evaluateExpression('!false', {
+            value: allFields[0],
+            type: 'field'
+        }, allFields, valuesMap, context)).toBeTruthy();
+    });
+    it('should support binary expressions', ()=>{
+        // replay and verify
+        expect(evaluateExpression("linkedToCare == '488b58ff-64f5-4f8a-8979-fa79940b1594'", {
+            value: allFields[1],
+            type: 'field'
+        }, allFields, valuesMap, context)).toBeFalsy();
+        // provide some values
+        valuesMap['linkedToCare'] = '488b58ff-64f5-4f8a-8979-fa79940b1594';
+        // replay and verify
+        expect(evaluateExpression("linkedToCare == '488b58ff-64f5-4f8a-8979-fa79940b1594'", {
+            value: allFields[1],
+            type: 'field'
+        }, allFields, valuesMap, context)).toBeTruthy();
+    });
+    it('should support complex expressions', ()=>{
+        // setup
+        valuesMap.bad_sleep = 'a53f32bc-6904-4692-8a4c-fb7403cf0306';
+        valuesMap.better_dead = '296b39ec-06c5-4310-8f30-d2c9f083fb71';
+        valuesMap.depressed = '5eb5852d-3d29-41f9-b2ff-d194e062003d';
+        valuesMap.feeling_bad = '349260db-8e0f-4c06-be92-5120b3708d1e';
+        valuesMap.feeling_tired = '0ea1378d-04eb-4e7e-908b-26d8c27d37e1';
+        valuesMap.troubled = '57766c65-6548-486b-9dad-0fedf531ed7d';
+        const expression = "(no_interest === 'b631d160-8d40-4cf7-92cd-67f628c889e8' ? 1 : isEmpty(no_interest) ? 2 : no_interest === '8ff1f85c-4f04-4f5b-936a-5aa9320cb66e' ? 3 : 0) + (depressed === 'b631d160-8d40-4cf7-92cd-67f628c889e8' ? 1 : depressed === '5eb5852d-3d29-41f9-b2ff-d194e062003d' ? 2 :  depressed==='8ff1f85c-4f04-4f5b-936a-5aa9320cb66e' ? 3 : 0) + (bad_sleep === 'a53f32bc-6904-4692-8a4c-fb7403cf0306' ? 1 : bad_sleep === '234259ec-5368-4488-8482-4f261cc76714' ? 2 : bad_sleep === '8ff1f85c-4f04-4f5b-936a-5aa9320cb66e' ? 3 : 0) + (feeling_tired === 'b631d160-8d40-4cf7-92cd-67f628c889e8' ? 1 : feeling_tired === '234259ec-5368-4488-8482-4f261cc76714' ? 2 : feeling_tired === '0ea1378d-04eb-4e7e-908b-26d8c27d37e1' ? 3 : 0) +(poor_appetite === 'b631d160-8d40-4cf7-92cd-67f628c889e8' ? 1 : poor_appetite === '234259ec-5368-4488-8482-4f261cc76714' ? 2 : poor_appetite === '8ff1f85c-4f04-4f5b-936a-5aa9320cb66e' ? 3 : 0) + (troubled === '57766c65-6548-486b-9dad-0fedf531ed7d' ? 1 : troubled === '234259ec-5368-4488-8482-4f261cc76714' ? 2 : troubled === '8ff1f85c-4f04-4f5b-936a-5aa9320cb66e' ? 3 : 0) + (feeling_bad === 'b631d160-8d40-4cf7-92cd-67f628c889e8' ? 1 : feeling_bad === '234259ec-5368-4488-8482-4f261cc76714' ? 2 : feeling_bad === '349260db-8e0f-4c06-be92-5120b3708d1e' ? 3 : 0) + (speaking_slowly === 'b631d160-8d40-4cf7-92cd-67f628c889e8' ? 1 : speaking_slowly === '234259ec-5368-4488-8482-4f261cc76714' ? 2 : speaking_slowly === '8ff1f85c-4f04-4f5b-936a-5aa9320cb66e' ? 3 : 0) + (better_dead === 'b631d160-8d40-4cf7-92cd-67f628c889e8' ? 1 : better_dead === '296b39ec-06c5-4310-8f30-d2c9f083fb71' ? 2 : better_dead === '8ff1f85c-4f04-4f5b-936a-5aa9320cb66e' ? 3 : 0)";
+        expect(evaluateExpression(expression, {
+            value: allFields[9],
+            type: 'field'
+        }, allFields, valuesMap, context)).toBe(14);
+    });
+    it('should support async expressions', async ()=>{
+        // setup
+        valuesMap.bad_sleep = 'a53f32bc-6904-4692-8a4c-fb7403cf0306';
+        registerExpressionHelper('getAsyncValue', ()=>{
+            return new Promise((resolve)=>{
+                setTimeout(()=>{
+                    resolve(18);
+                }, 10);
+            });
+        });
+        const result = await evaluateAsyncExpression('getAsyncValue().then(value => !isEmpty(bad_sleep) ? value + 3 : value)', {
+            value: allFields[9],
+            type: 'field'
+        }, allFields, valuesMap, context);
+        expect(result).toBe(21);
+    });
+    it('should support includes(question, value) runtime helper function', ()=>{
+        // setup
+        valuesMap['referredToPreventionServices'] = [
+            '88cdde2b-753b-48ac-a51a-ae5e1ab24846',
+            '162223AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'
+        ];
+        // replay and verify
+        expect(evaluateExpression("includes(referredToPreventionServices, '88cdde2b-753b-48ac-a51a-ae5e1ab24846') && !includes(referredToPreventionServices, '1691AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA')", {
+            value: allFields[1],
+            type: 'field'
+        }, allFields, valuesMap, context)).toBeTruthy();
+    });
+    it('should support session mode as a runtime', ()=>{
+        expect(evaluateExpression("mode == 'enter' && isEmpty(htsProviderRemarks)", {
+            value: allFields[2],
+            type: 'field'
+        }, allFields, valuesMap, context)).toBeTruthy();
+    });
+    it("should register dependency of the current node to it's determinant", ()=>{
+        // setup
+        const referredToPreventionServices = allFields[2];
+        const htsProviderRemarks = allFields[3];
+        // verify
+        expect(referredToPreventionServices.fieldDependents).toBeFalsy();
+        expect(htsProviderRemarks.fieldDependents).toBeFalsy();
+        // replay
+        expect(evaluateExpression("!includes(referredToPreventionServices, '88cdde2b-753b-48ac-a51a-ae5e1ab24846') && isEmpty(htsProviderRemarks)", {
+            value: allFields[4],
+            type: 'field'
+        }, allFields, valuesMap, context)).toBeTruthy();
+        expect(Array.from(referredToPreventionServices.fieldDependents)).toStrictEqual([
+            'bodyTemperature'
+        ]);
+        expect(Array.from(htsProviderRemarks.fieldDependents)).toStrictEqual([
+            'bodyTemperature'
+        ]);
+    });
+    it('should support registered custom helper functions', ()=>{
+        // setup
+        function customHelper(a, b) {
+            return a + b;
+        }
+        registerExpressionHelper('customAdd', customHelper);
+        // verify
+        const result = evaluateExpression('customAdd(2, 3)', {
+            value: allFields[1],
+            type: 'field'
+        }, allFields, {}, context);
+        expect(result).toEqual(5);
+    });
+    it('should calculate age in days using dayjs diff expression', ()=>{
+        // setup - use a known date 30 days ago
+        const thirtyDaysAgo = new Date();
+        thirtyDaysAgo.setDate(thirtyDaysAgo.getDate() - 30);
+        const dateOfBirthString = thirtyDaysAgo.toLocaleDateString('en-CA'); // en-CA produces YYYY-MM-DD in local time
+        valuesMap['dateOfBirth'] = dateOfBirthString;
+        // Calculate days difference
+        const result = evaluateExpression("dayjs().diff(dayjs(dateOfBirth), 'day')", {
+            value: allFields[6],
+            type: 'field'
+        }, allFields, valuesMap, context);
+        // Should be approximately 30 days (allowing for time-of-day variations)
+        expect(result).toBeGreaterThanOrEqual(29);
+        expect(result).toBeLessThanOrEqual(31);
+    });
+});