case-editor-tools 1.7.1 → 1.8.0

package/expression-utils/studyEngineExpressions.d.ts

@@ -14,6 +14,8 @@ export declare const NativeStudyEngineExpressions: {
     hasResponseKeyWithValue: (itemKey: string, responseKey: string, value: string) => Expression;
     countResponseItems: (itemKey: string, responseKey: string) => Expression;
     isStudyCodePresent: (listKey: string | Expression, code: string | Expression) => Expression;
+    getCurrentStudyCounterValue: (scopeKey: string | Expression) => Expression;
+    getNextStudyCounterValue: (scopeKey: string | Expression) => Expression;
     checkConditionForOldResponses: (condition: Expression, checkType?: number | 'all' | 'any', surveyKey?: string, querySince?: number | Expression, queryUntil?: number | Expression) => Expression;
     eventPayload: {
         hasEventPayload: () => Expression;
@@ -55,6 +57,13 @@ export declare const NativeStudyEngineExpressions: {
             getMessageNextTime: (messageType: string) => Expression;
         };
     };
+    getStudyVariable: {
+        boolean: (key: string | Expression) => Expression;
+        string: (key: string | Expression) => Expression;
+        int: (key: string | Expression) => Expression;
+        float: (key: string | Expression) => Expression;
+        date: (key: string | Expression) => Expression;
+    };
     eq: (val1: Expression | string | number, val2: Expression | string | number) => Expression;
     lt: (val1: Expression | string | number, val2: Expression | string | number) => Expression;
     lte: (val1: Expression | string | number, val2: Expression | string | number) => Expression;
@@ -66,9 +75,11 @@ export declare const NativeStudyEngineExpressions: {
     sum: (...values: (Expression | number)[]) => Expression;
     neg: (value: Expression | number) => Expression;
     timestampWithOffset: (delta: Duration, reference?: number | Expression) => Expression;
+    timestampDiff: (laterTimestamp: number | Expression, earlierTimestamp: number | Expression) => Expression;
     getISOWeekForTs: (ts: number | Expression) => Expression;
     getTsForNextStartOfMonth: (month: Month | Expression, reference?: number | Expression) => Expression;
     getTsForNextISOWeek: (ISOWeek: number | Expression, reference?: number | Expression) => Expression;
+    getTsForStartOfISOWeek: (reference?: number | Expression) => Expression;
     parseValueAsNum: (valueRef: Expression | string | number) => Expression;
     generateRandomNumber: (min: number, max: number) => Expression;
     externalEventEval: (serviceName: string, route?: string, expectFloat?: boolean) => Expression;
@@ -80,8 +91,9 @@ export declare const StudyEngineActions: {
     participantActions: {
         updateStudyStatus: (status: string) => Expression;
         startNewStudySession: () => Expression;
-        updateFlag: (key: string, newValue: string | number | Expression) => Expression;
-        removeFlag: (key: string) => Expression;
+        updateFlag: (key: string | Expression, newValue: string | number | Expression) => Expression;
+        removeFlag: (key: string | Expression) => Expression;
+        getNextStudyCounterAsFlag: (scopeKey: string | Expression, flagKey: string | Expression, prefix: string | Expression, padding: number | Expression) => Expression;
         assignedSurveys: {
             add: (surveyKey: string, category: 'immediate' | 'prio' | 'normal' | 'optional', activeFrom?: number | Expression, activeUntil?: number | Expression) => Expression;
             removeAll: () => Expression;
@@ -100,6 +112,7 @@ export declare const StudyEngineActions: {
             set: (forKey: string | Expression, value: string | Expression) => Expression;
             delete: (forKey?: string | Expression) => Expression;
             drawFromStudyCodeList: (listKey: string | Expression, forKey?: string | Expression) => Expression;
+            getNextStudyCounterAsLinkingCode: (scopeKey: string | Expression, linkingCodeKey: string | Expression, prefix: string | Expression, padding: number | Expression) => Expression;
         };
         messages: {
             add: (messageType: string, scheduledFor: number | Expression) => Expression;
@@ -115,7 +128,15 @@ export declare const StudyEngineActions: {
         stopParticipation: () => Expression;
         finishParticipation: () => Expression;
     };
+    updateStudyVariable: {
+        boolean: (key: string | Expression, value: Expression) => Expression;
+        string: (key: string | Expression, value: Expression | string) => Expression;
+        int: (key: string | Expression, value: number | Expression) => Expression;
+        float: (key: string | Expression, value: number | Expression) => Expression;
+        date: (key: string | Expression, value: number | Expression) => Expression;
+    };
     removeStudyCode: (listKey: string | Expression, code: string | Expression) => Expression;
+    resetStudyCounter: (scopeKey: string | Expression) => Expression;
     notifyResearcher: (messageType: string, ...payload: Expression[] | string[]) => Expression;
 };
 export declare const StudyEngine: {
@@ -153,8 +174,9 @@ export declare const StudyEngine: {
     participantActions: {
         updateStudyStatus: (status: string) => Expression;
         startNewStudySession: () => Expression;
-        updateFlag: (key: string, newValue: string | number | Expression) => Expression;
-        removeFlag: (key: string) => Expression;
+        updateFlag: (key: string | Expression, newValue: string | number | Expression) => Expression;
+        removeFlag: (key: string | Expression) => Expression;
+        getNextStudyCounterAsFlag: (scopeKey: string | Expression, flagKey: string | Expression, prefix: string | Expression, padding: number | Expression) => Expression;
         assignedSurveys: {
             add: (surveyKey: string, category: 'immediate' | 'prio' | 'normal' | 'optional', activeFrom?: number | Expression, activeUntil?: number | Expression) => Expression;
             removeAll: () => Expression;
@@ -173,6 +195,7 @@ export declare const StudyEngine: {
             set: (forKey: string | Expression, value: string | Expression) => Expression;
             delete: (forKey?: string | Expression) => Expression;
             drawFromStudyCodeList: (listKey: string | Expression, forKey?: string | Expression) => Expression;
+            getNextStudyCounterAsLinkingCode: (scopeKey: string | Expression, linkingCodeKey: string | Expression, prefix: string | Expression, padding: number | Expression) => Expression;
         };
         messages: {
             add: (messageType: string, scheduledFor: number | Expression) => Expression;
@@ -188,7 +211,15 @@ export declare const StudyEngine: {
         stopParticipation: () => Expression;
         finishParticipation: () => Expression;
     };
+    updateStudyVariable: {
+        boolean: (key: string | Expression, value: Expression) => Expression;
+        string: (key: string | Expression, value: Expression | string) => Expression;
+        int: (key: string | Expression, value: number | Expression) => Expression;
+        float: (key: string | Expression, value: number | Expression) => Expression;
+        date: (key: string | Expression, value: number | Expression) => Expression;
+    };
     removeStudyCode: (listKey: string | Expression, code: string | Expression) => Expression;
+    resetStudyCounter: (scopeKey: string | Expression) => Expression;
     notifyResearcher: (messageType: string, ...payload: Expression[] | string[]) => Expression;
     checkEventType: (equalsType: 'ENTER' | 'SUBMIT' | 'TIMER' | 'MERGE' | 'CUSTOM' | 'LEAVE') => Expression;
     checkEventKey: (equalsKey: string) => Expression;
@@ -202,6 +233,8 @@ export declare const StudyEngine: {
     hasResponseKeyWithValue: (itemKey: string, responseKey: string, value: string) => Expression;
     countResponseItems: (itemKey: string, responseKey: string) => Expression;
     isStudyCodePresent: (listKey: string | Expression, code: string | Expression) => Expression;
+    getCurrentStudyCounterValue: (scopeKey: string | Expression) => Expression;
+    getNextStudyCounterValue: (scopeKey: string | Expression) => Expression;
     checkConditionForOldResponses: (condition: Expression, checkType?: number | 'all' | 'any', surveyKey?: string, querySince?: number | Expression, queryUntil?: number | Expression) => Expression;
     eventPayload: {
         hasEventPayload: () => Expression;
@@ -243,6 +276,13 @@ export declare const StudyEngine: {
             getMessageNextTime: (messageType: string) => Expression;
         };
     };
+    getStudyVariable: {
+        boolean: (key: string | Expression) => Expression;
+        string: (key: string | Expression) => Expression;
+        int: (key: string | Expression) => Expression;
+        float: (key: string | Expression) => Expression;
+        date: (key: string | Expression) => Expression;
+    };
     eq: (val1: Expression | string | number, val2: Expression | string | number) => Expression;
     lt: (val1: Expression | string | number, val2: Expression | string | number) => Expression;
     lte: (val1: Expression | string | number, val2: Expression | string | number) => Expression;
@@ -254,9 +294,11 @@ export declare const StudyEngine: {
     sum: (...values: (Expression | number)[]) => Expression;
     neg: (value: Expression | number) => Expression;
     timestampWithOffset: (delta: Duration, reference?: number | Expression) => Expression;
+    timestampDiff: (laterTimestamp: number | Expression, earlierTimestamp: number | Expression) => Expression;
     getISOWeekForTs: (ts: number | Expression) => Expression;
     getTsForNextStartOfMonth: (month: Month | Expression, reference?: number | Expression) => Expression;
     getTsForNextISOWeek: (ISOWeek: number | Expression, reference?: number | Expression) => Expression;
+    getTsForStartOfISOWeek: (reference?: number | Expression) => Expression;
     parseValueAsNum: (valueRef: Expression | string | number) => Expression;
     generateRandomNumber: (min: number, max: number) => Expression;
     externalEventEval: (serviceName: string, route?: string, expectFloat?: boolean) => Expression;

package/expression-utils/studyEngineExpressions.js

@@ -91,6 +91,22 @@ const countResponseItems = (itemKey, responseKey) => {
 const isStudyCodePresent = (listKey, code) => {
     return expressionUtils_expressionGen.generateExpression('isStudyCodePresent', undefined, listKey, code);
 };
+/**
+ * Get the current study counter value for the given scope key (does not change the counter)
+ * @param scopeKey
+ * @returns
+ */
+const getCurrentStudyCounterValue = (scopeKey) => {
+    return expressionUtils_expressionGen.generateExpression('getCurrentStudyCounterValue', undefined, scopeKey);
+};
+/**
+ * Get the next study counter value for the given scope key (increases the counter by 1)
+ * @param scopeKey
+ * @returns
+ */
+const getNextStudyCounterValue = (scopeKey) => {
+    return expressionUtils_expressionGen.generateExpression('getNextStudyCounterValue', undefined, scopeKey);
+};
 /**
  * Method to run a check on previous responses of the participant.
  * @param condition expression that will be evaluated on each retrieved response
@@ -193,6 +209,16 @@ const getLastSubmissionDateForIncoming = (surveyKey) => expressionUtils_expressi
  */
 const lastSubmissionDateOlderThan = (reference, surveyKey) => expressionUtils_expressionGen.generateExpression('lastSubmissionDateOlderThan', undefined, reference, surveyKey);
 const lastSubmissionDateOlderThanForIncoming = (reference, surveyKey) => expressionUtils_expressionGen.generateExpression('incomingState:lastSubmissionDateOlderThan', undefined, reference, surveyKey);
+const getStudyVariableBoolean = (key) => expressionUtils_expressionGen.generateExpression('getStudyVariableBoolean', undefined, key);
+const getStudyVariableString = (key) => expressionUtils_expressionGen.generateExpression('getStudyVariableString', undefined, key);
+const getStudyVariableInt = (key) => expressionUtils_expressionGen.generateExpression('getStudyVariableInt', undefined, key);
+const getStudyVariableFloat = (key) => expressionUtils_expressionGen.generateExpression('getStudyVariableFloat', undefined, key);
+const getStudyVariableDate = (key) => expressionUtils_expressionGen.generateExpression('getStudyVariableDate', undefined, key);
+const UPDATE_STUDY_VARIABLE_BOOLEAN = (key, value) => expressionUtils_expressionGen.generateExpression('UPDATE_STUDY_VARIABLE_BOOLEAN', undefined, key, value);
+const UPDATE_STUDY_VARIABLE_STRING = (key, value) => expressionUtils_expressionGen.generateExpression('UPDATE_STUDY_VARIABLE_STRING', undefined, key, value);
+const UPDATE_STUDY_VARIABLE_INT = (key, value) => expressionUtils_expressionGen.generateExpression('UPDATE_STUDY_VARIABLE_INT', undefined, key, value);
+const UPDATE_STUDY_VARIABLE_FLOAT = (key, value) => expressionUtils_expressionGen.generateExpression('UPDATE_STUDY_VARIABLE_FLOAT', undefined, key, value);
+const UPDATE_STUDY_VARIABLE_DATE = (key, value) => expressionUtils_expressionGen.generateExpression('UPDATE_STUDY_VARIABLE_DATE', undefined, key, value);
 const eq = (val1, val2) => expressionUtils_expressionGen.generateExpression('eq', undefined, val1, val2);
 const lt = (val1, val2) => expressionUtils_expressionGen.generateExpression('lt', undefined, val1, val2);
 const lte = (val1, val2) => expressionUtils_expressionGen.generateExpression('lte', undefined, val1, val2);
@@ -213,6 +239,13 @@ const timestampWithOffset = (delta, reference) => expressionUtils_expressionGen.
  * @returns
  */
 const getISOWeekForTs = (ts) => expressionUtils_expressionGen.generateExpression('getISOWeekForTs', undefined, ts);
+/**
+ * Calculate the signed difference between two POSIX timestamps in seconds.
+ * @param laterTimestamp timestamp or expression returning a timestamp
+ * @param earlierTimestamp timestamp or expression returning a timestamp
+ * @returns laterTimestamp minus earlierTimestamp, which may be negative
+ */
+const timestampDiff = (laterTimestamp, earlierTimestamp) => expressionUtils_expressionGen.generateExpression('timestampDiff', 'float', laterTimestamp, earlierTimestamp);
 /**
  * Generate a timestamp value (POSIX timestamp) for the beginning of the month for the first time that is later than the reference
  * @param month which ISO week should be used for the timestamp generation
@@ -227,6 +260,12 @@ const getTsForNextStartOfMonth = (month, reference) => expressionUtils_expressio
  * @returns
  */
 const getTsForNextISOWeek = (ISOWeek, reference) => expressionUtils_expressionGen.generateExpression('getTsForNextISOWeek', undefined, ISOWeek, reference ? reference : undefined);
+/**
+ * Get the POSIX timestamp for Monday midnight of the ISO week containing the reference, using the backend's local timezone.
+ * @param reference optional timestamp or expression returning a timestamp; defaults to the current time
+ * @returns the start of the reference's ISO week in seconds
+ */
+const getTsForStartOfISOWeek = (reference) => expressionUtils_expressionGen.generateExpression('getTsForStartOfISOWeek', undefined, reference);
 /**
  * Attempt to parse the resolved argument's value as a number
  * @param valueRef resolve this argument, and try to parse this as number. Boolean value will result in error.
@@ -433,6 +472,36 @@ const DELETE_LINKING_CODE = (forKey) => {
 const DRAW_STUDY_CODE_AS_LINKING_CODE = (listKey, forKey) => {
     return expressionUtils_expressionGen.generateExpression('DRAW_STUDY_CODE_AS_LINKING_CODE', undefined, listKey, forKey);
 };
+/**
+ * Get the next study counter value for the given scope key (increases the counter by 1) and store it as a flag for the participant
+ * @param scopeKey
+ * @param flagKey
+ * @param prefix prefix to be added to the flag
+ * @param padding number of digits to pad the counter with
+ * @returns
+ */
+const GET_NEXT_STUDY_COUNTER_AS_FLAG = (scopeKey, flagKey, prefix, padding) => {
+    return expressionUtils_expressionGen.generateExpression('GET_NEXT_STUDY_COUNTER_AS_FLAG', undefined, scopeKey, flagKey, prefix, padding);
+};
+/**
+ * Get the next study counter value for the given scope key (increases the counter by 1) and store it as a linking code for the participant
+ * @param scopeKey
+ * @param linkingCodeKey
+ * @param prefix prefix to be added to the linking code
+ * @param padding number of digits to pad the counter with
+ * @returns
+ */
+const GET_NEXT_STUDY_COUNTER_AS_LINKING_CODE = (scopeKey, linkingCodeKey, prefix, padding) => {
+    return expressionUtils_expressionGen.generateExpression('GET_NEXT_STUDY_COUNTER_AS_LINKING_CODE', undefined, scopeKey, linkingCodeKey, prefix, padding);
+};
+/**
+ * Reset the study counter for the given scope key
+ * @param scopeKey
+ * @returns
+ */
+const RESET_STUDY_COUNTER = (scopeKey) => {
+    return expressionUtils_expressionGen.generateExpression('RESET_STUDY_COUNTER', undefined, scopeKey);
+};
 /**
  * Method to call external event handler
  * @param serviceName name of the external service endpoint that should be used (URL and API key are config of the service)
@@ -515,6 +584,8 @@ const NativeStudyEngineExpressions = {
     hasResponseKeyWithValue,
     countResponseItems,
     isStudyCodePresent,
+    getCurrentStudyCounterValue,
+    getNextStudyCounterValue,
     // Old responses
     checkConditionForOldResponses,
     // Event payload methods:
@@ -560,6 +631,13 @@ const NativeStudyEngineExpressions = {
             getMessageNextTime: getMessageNextTimeForIncoming,
         }
     },
+    getStudyVariable: {
+        boolean: getStudyVariableBoolean,
+        string: getStudyVariableString,
+        int: getStudyVariableInt,
+        float: getStudyVariableFloat,
+        date: getStudyVariableDate,
+    },
     // logical and comparision
     eq,
     lt,
@@ -573,9 +651,11 @@ const NativeStudyEngineExpressions = {
     neg,
     // Other
     timestampWithOffset,
+    timestampDiff,
     getISOWeekForTs,
     getTsForNextStartOfMonth,
     getTsForNextISOWeek,
+    getTsForStartOfISOWeek,
     parseValueAsNum,
     generateRandomNumber: (min, max) => expressionUtils_expressionGen.generateExpression('generateRandomNumber', undefined, min, max),
     externalEventEval,
@@ -589,6 +669,7 @@ const StudyEngineActions = {
         startNewStudySession: START_NEW_STUDY_SESSION,
         updateFlag: UPDATE_FLAG,
         removeFlag: REMOVE_FLAG,
+        getNextStudyCounterAsFlag: GET_NEXT_STUDY_COUNTER_AS_FLAG,
         assignedSurveys: {
             add: ADD_NEW_SURVEY,
             removeAll: REMOVE_ALL_SURVEYS,
@@ -608,6 +689,7 @@ const StudyEngineActions = {
             set: SET_LINKING_CODE,
             delete: DELETE_LINKING_CODE,
             drawFromStudyCodeList: DRAW_STUDY_CODE_AS_LINKING_CODE,
+            getNextStudyCounterAsLinkingCode: GET_NEXT_STUDY_COUNTER_AS_LINKING_CODE,
         },
         messages: {
             add: ADD_MESSAGE,
@@ -624,7 +706,15 @@ const StudyEngineActions = {
         stopParticipation,
         finishParticipation,
     },
+    updateStudyVariable: {
+        boolean: UPDATE_STUDY_VARIABLE_BOOLEAN,
+        string: UPDATE_STUDY_VARIABLE_STRING,
+        int: UPDATE_STUDY_VARIABLE_INT,
+        float: UPDATE_STUDY_VARIABLE_FLOAT,
+        date: UPDATE_STUDY_VARIABLE_DATE,
+    },
     removeStudyCode: REMOVE_STUDY_CODE,
+    resetStudyCounter: RESET_STUDY_COUNTER,
     notifyResearcher: NOTIFY_RESEARCHER,
 };
 const StudyEngine = Object.assign(Object.assign(Object.assign({}, NativeStudyEngineExpressions), StudyEngineActions), { singleChoice: {

package/expression-utils/studyEngineExpressions.js.map

@@ -1 +1 @@
-{"version":3,"file":"studyEngineExpressions.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"studyEngineExpressions.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "case-editor-tools",
   "description": "Javascript tools to simplify survey and study coding for CASE.",
-  "version": "1.7.1",
+  "version": "1.8.0",
   "main": "index.js",
   "license": "Apache-2.0",
   "repository": "github:case-framework/case-editor-tools",

package/surveys/survey-engine-expressions.d.ts

@@ -81,6 +81,14 @@ export declare const SurveyEngine: {
         hasKeyAndValue: (key: string, value: string | Expression) => Expression;
         getAsNum: (key: string) => Expression;
     };
+    studyVariables: {
+        hasKey: (key: string | Expression) => Expression;
+        getBoolean: (key: string | Expression) => Expression;
+        getString: (key: string | Expression) => Expression;
+        getInt: (key: string | Expression) => Expression;
+        getFloat: (key: string | Expression) => Expression;
+        getDate: (key: string | Expression) => Expression;
+    };
     isLoggedIn: () => Expression;
     getters: {
         getContext: () => Expression;

package/surveys/survey-engine-expressions.js

@@ -321,6 +321,54 @@ const hasParticipantFlagKey = (key) => {
 const hasParticipantFlagKeyAndValue = (key, value) => {
     return expressionUtils_expressionGen.generateExpression('hasParticipantFlagKeyAndValue', undefined, key, value);
 };
+/**
+ * Check if a study variable is present
+ * @param key look up this study variable
+ * @returns return true if key is present. If any of the two is different, or study variables is empty, it returns false.
+ */
+const hasStudyVariableKey = (key) => {
+    return expressionUtils_expressionGen.generateExpression('hasStudyVariableKey', undefined, key);
+};
+/**
+ * Get a study variable value as a boolean
+ * @param key look up this study variable
+ * @returns return the value of the study variable
+ */
+const getStudyVariableBoolean = (key) => {
+    return expressionUtils_expressionGen.generateExpression('getStudyVariableBoolean', undefined, key);
+};
+/**
+ * Get a study variable value as a string
+ * @param key look up this study variable
+ * @returns return the value of the study variable
+ */
+const getStudyVariableString = (key) => {
+    return expressionUtils_expressionGen.generateExpression('getStudyVariableString', undefined, key);
+};
+/**
+ * Get a study variable value as an integer
+ * @param key look up this study variable
+ * @returns return the value of the study variable
+ */
+const getStudyVariableInt = (key) => {
+    return expressionUtils_expressionGen.generateExpression('getStudyVariableInt', undefined, key);
+};
+/**
+ * Get a study variable value as a float
+ * @param key look up this study variable
+ * @returns return the value of the study variable
+ */
+const getStudyVariableFloat = (key) => {
+    return expressionUtils_expressionGen.generateExpression('getStudyVariableFloat', undefined, key);
+};
+/**
+ * Get a study variable value as a date
+ * @param key look up this study variable
+ * @returns return the value of the study variable in posix timestamp format (seconds since 1970-01-01 00:00:00 UTC)
+ */
+const getStudyVariableDate = (key) => {
+    return expressionUtils_expressionGen.generateExpression('getStudyVariableDate', undefined, key);
+};
 /**
  * Check if the participant is logged in currently.
  * @returns true if context variable isLoggedIn is set and true
@@ -443,6 +491,13 @@ const SurveyEngine = Object.assign(Object.assign({}, NativeSurveyEngineExpressio
         hasKey: hasParticipantFlagKey,
         hasKeyAndValue: hasParticipantFlagKeyAndValue,
         getAsNum: parseParticipantFlagAsNum,
+    }, studyVariables: {
+        hasKey: hasStudyVariableKey,
+        getBoolean: getStudyVariableBoolean,
+        getString: getStudyVariableString,
+        getInt: getStudyVariableInt,
+        getFloat: getStudyVariableFloat,
+        getDate: getStudyVariableDate,
     }, isLoggedIn });
 
 exports.NativeSurveyEngineExpressions = NativeSurveyEngineExpressions;

package/surveys/survey-engine-expressions.js.map

@@ -1 +1 @@
-{"version":3,"file":"survey-engine-expressions.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"survey-engine-expressions.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}