@aehrc/smart-forms-renderer 0.44.2 → 0.44.4

package/lib/src/utils/extractObservation.js

@@ -0,0 +1,179 @@
+import { readQuestionnaireResponse, transverseQuestionnaire } from './genericRecursive';
+import { getQrItemsIndex, mapQItemsIndex } from './mapItem';
+/**
+ * Extract an array of Observations from a QuestionnaireResponse and its source Questionnaire.
+ * @see https://build.fhir.org/ig/HL7/sdc/extraction.html#observation-based-extraction
+ *
+ * @author Riza Nafis
+ */
+export function extractObservationBased(questionnaire, questionnaireResponse) {
+    const observations = [];
+    if (!questionnaire.item ||
+        questionnaire.item.length === 0 ||
+        !questionnaireResponse.item ||
+        questionnaireResponse.item.length === 0) {
+        return observations;
+    }
+    if (!questionnaireResponse.id) {
+        questionnaireResponse.id = generateUniqueId((questionnaireResponse.identifier && questionnaireResponse.identifier.value) || 'QR');
+    }
+    const qItemExtractableMap = mapQItemsExtractable(questionnaire);
+    return readQuestionnaireResponse(questionnaire, questionnaireResponse, extractObservationBasedRecursive, { qr: questionnaireResponse, qItemMap: qItemExtractableMap });
+}
+const FHIR_OBSERVATION_EXTRACT_EXTENSION = 'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observationExtract';
+const FHIR_OBSERVATION_EXTRACT_CATEGORY_EXTENSION = 'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observation-extract-category';
+function extractObservationBasedRecursive(qItem, qrItemOrItems, extraData) {
+    var _a;
+    // Process items with child items
+    const observations = [];
+    if (!(extraData === null || extraData === void 0 ? void 0 : extraData.qr) || !(extraData === null || extraData === void 0 ? void 0 : extraData.qItemMap))
+        return observations;
+    // Map qrItemOrItems into an array of qrItems
+    let qrItems = [];
+    if (qrItemOrItems) {
+        if (Array.isArray(qrItemOrItems)) {
+            qrItems = qrItemOrItems;
+        }
+        else {
+            qrItems = [qrItemOrItems];
+        }
+    }
+    for (const responseItem of qrItems) {
+        // Check if the response item has any values or nested items
+        if (responseItem.answer && responseItem.answer.length > 0) {
+            for (const answer of responseItem.answer) {
+                const currentQItemExtractable = extraData.qItemMap[qItem.linkId];
+                if (currentQItemExtractable.extractable) {
+                    const observation = createObservation(qItem, extraData.qr, answer, currentQItemExtractable.extractCategories);
+                    observations.push(observation);
+                }
+            }
+        }
+    }
+    const childQItems = qItem.item;
+    if (!childQItems || childQItems.length === 0)
+        return observations;
+    // Map qrItemOrItems into an array of qrItems
+    let childQrItems = [];
+    if (qrItemOrItems) {
+        if (Array.isArray(qrItemOrItems)) {
+            childQrItems = qrItemOrItems;
+        }
+        else {
+            childQrItems = (_a = qrItemOrItems.item) !== null && _a !== void 0 ? _a : [];
+        }
+    }
+    const indexMap = mapQItemsIndex(qItem);
+    const qrItemsByIndex = getQrItemsIndex(childQItems, childQrItems, indexMap);
+    for (const [index, childQItem] of childQItems.entries()) {
+        const childQRItemOrItems = qrItemsByIndex[index];
+        const childObservations = extractObservationBasedRecursive(childQItem, childQRItemOrItems !== null && childQRItemOrItems !== void 0 ? childQRItemOrItems : null, extraData);
+        if (childObservations) {
+            observations.push(...childObservations);
+        }
+    }
+    return observations;
+}
+export function mapQItemsExtractable(questionnaire) {
+    var _a, _b, _c, _d, _e;
+    if (!questionnaire.item || questionnaire.item.length === 0) {
+        return {};
+    }
+    const initialExtension = (_a = questionnaire.extension) === null || _a === void 0 ? void 0 : _a.find((e) => e.url === FHIR_OBSERVATION_EXTRACT_EXTENSION);
+    const extractCategoryExts = (_c = (_b = questionnaire.extension) === null || _b === void 0 ? void 0 : _b.filter((e) => e.url === FHIR_OBSERVATION_EXTRACT_CATEGORY_EXTENSION && e.valueCodeableConcept)) === null || _c === void 0 ? void 0 : _c.map((e) => e.valueCodeableConcept);
+    const initialExtractMap = {
+        [(_d = questionnaire.id) !== null && _d !== void 0 ? _d : 'root']: {
+            extractable: (_e = initialExtension === null || initialExtension === void 0 ? void 0 : initialExtension.valueBoolean) !== null && _e !== void 0 ? _e : false,
+            extractCategories: extractCategoryExts !== null && extractCategoryExts !== void 0 ? extractCategoryExts : []
+        }
+    };
+    transverseQuestionnaire(questionnaire, mapQItemsExtractableRecursive, initialExtractMap);
+    return initialExtractMap;
+}
+function mapQItemsExtractableRecursive(qItem, root, parent, qItemExtrableMap) {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    if (!qItemExtrableMap)
+        return;
+    if (!qItemExtrableMap[qItem.linkId]) {
+        qItemExtrableMap[qItem.linkId] = { extractable: false, extractCategories: [] };
+    }
+    // Check if questionnaire extractable
+    const extension = (_a = qItem.extension) === null || _a === void 0 ? void 0 : _a.find((e) => e.url === FHIR_OBSERVATION_EXTRACT_EXTENSION);
+    if ((extension === null || extension === void 0 ? void 0 : extension.valueBoolean) || (extension === null || extension === void 0 ? void 0 : extension.valueBoolean) === false) {
+        qItemExtrableMap[qItem.linkId].extractable = (_b = extension === null || extension === void 0 ? void 0 : extension.valueBoolean) !== null && _b !== void 0 ? _b : false;
+    }
+    else if (parent && qItemExtrableMap[parent.linkId]) {
+        qItemExtrableMap[qItem.linkId].extractable = qItemExtrableMap[parent.linkId].extractable;
+    }
+    else if (root && qItemExtrableMap[(_c = root.id) !== null && _c !== void 0 ? _c : 'root']) {
+        qItemExtrableMap[qItem.linkId].extractable = qItemExtrableMap[(_d = root === null || root === void 0 ? void 0 : root.id) !== null && _d !== void 0 ? _d : 'root'].extractable;
+    }
+    else {
+        qItemExtrableMap[qItem.linkId].extractable = false;
+    }
+    // if questionnaire extractable, check for extract category
+    if (qItemExtrableMap[qItem.linkId].extractable) {
+        const extractCategoryExts = (_f = (_e = qItem.extension) === null || _e === void 0 ? void 0 : _e.filter((e) => e.url === FHIR_OBSERVATION_EXTRACT_CATEGORY_EXTENSION && e.valueCodeableConcept)) === null || _f === void 0 ? void 0 : _f.map((e) => e.valueCodeableConcept);
+        if (extractCategoryExts) {
+            qItemExtrableMap[qItem.linkId].extractCategories = extractCategoryExts;
+        }
+        else if (parent && qItemExtrableMap[parent.linkId].extractCategories.length) {
+            qItemExtrableMap[qItem.linkId].extractCategories =
+                qItemExtrableMap[parent.linkId].extractCategories;
+        }
+        else if (root && qItemExtrableMap[(_g = root.id) !== null && _g !== void 0 ? _g : 'root'].extractCategories.length) {
+            qItemExtrableMap[qItem.linkId].extractCategories =
+                qItemExtrableMap[(_h = root === null || root === void 0 ? void 0 : root.id) !== null && _h !== void 0 ? _h : 'root'].extractCategories;
+        }
+        else {
+            qItemExtrableMap[qItem.linkId].extractCategories = [];
+        }
+    }
+    if (qItem.item && qItem.item.length !== 0) {
+        for (const qChildItem of qItem.item) {
+            mapQItemsExtractableRecursive(qChildItem, root, qItem, qItemExtrableMap);
+        }
+    }
+}
+export function createObservation(questionnaireItem, questionnaireResponse, answer, categories) {
+    var _a, _b;
+    const qrRef = `QuestionnaireResponse/${questionnaireResponse.id}`;
+    const observation = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ resourceType: 'Observation', status: 'final' }, removeIfNull('id', questionnaireItem.linkId, `obs-${questionnaireItem.linkId}`)), { code: {
+            coding: (_b = (_a = questionnaireItem.code) === null || _a === void 0 ? void 0 : _a.map((c) => (Object.assign(Object.assign(Object.assign({}, removeIfNull('system', c.system)), removeIfNull('code', c.code)), removeIfNull('display', c.display))))) !== null && _b !== void 0 ? _b : []
+        } }), removeIfNull('basedOn', questionnaireResponse.basedOn)), removeIfNull('partOf', questionnaireResponse.partOf)), removeIfNull('subject', questionnaireResponse.subject)), removeIfNull('encounter', questionnaireResponse.encounter)), { derivedFrom: [{ reference: qrRef }] }), removeIfNull('effectiveDateTime', questionnaireResponse.authored)), removeIfNull('issued', questionnaireResponse.authored)), removeIfNull('author', questionnaireResponse.author));
+    // Set the value of the Observation based on the answer type
+    if (answer.valueQuantity) {
+        observation.valueQuantity = answer.valueQuantity;
+    }
+    else if (answer.valueString) {
+        observation.valueString = answer.valueString;
+    }
+    else if (answer.valueBoolean) {
+        observation.valueBoolean = answer.valueBoolean;
+    }
+    else if (answer.valueInteger) {
+        observation.valueInteger = answer.valueInteger;
+    }
+    else if (answer.valueCoding) {
+        observation.valueCodeableConcept = { coding: [answer.valueCoding] };
+    }
+    if (categories.length) {
+        observation.category = categories;
+    }
+    return observation;
+}
+let ID_COUNTER = 0;
+export function generateUniqueId(prefix) {
+    if (ID_COUNTER) {
+        ID_COUNTER = 0;
+    }
+    return (prefix + '-' + Date.now() + '-' + ++ID_COUNTER + '-' + Math.random().toString(16).substring(2));
+}
+function removeIfNull(key, value, expectedValue) {
+    if (!value)
+        return {};
+    if (expectedValue)
+        return { [key]: expectedValue };
+    return { [key]: value };
+}
+//# sourceMappingURL=extractObservation.js.map

package/lib/src/utils/extractObservation.js.map

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

package/lib/src/utils/fhirpath.d.ts

@@ -0,0 +1,22 @@
+import type { Expression, QuestionnaireResponse, QuestionnaireResponseItem } from 'fhir/r4';
+import type { CalculatedExpression } from '../interfaces/calculatedExpression.interface';
+import type { EnableWhenExpressions } from '../interfaces/enableWhen.interface';
+interface EvaluateUpdatedExpressionsParams {
+    updatedResponse: QuestionnaireResponse;
+    updatedResponseItemMap: Record<string, QuestionnaireResponseItem[]>;
+    calculatedExpressions: Record<string, CalculatedExpression[]>;
+    enableWhenExpressions: EnableWhenExpressions;
+    variablesFhirPath: Record<string, Expression[]>;
+    existingFhirPathContext: Record<string, any>;
+}
+export declare function evaluateUpdatedExpressions(params: EvaluateUpdatedExpressionsParams): {
+    isUpdated: boolean;
+    updatedEnableWhenExpressions: EnableWhenExpressions;
+    updatedCalculatedExpressions: Record<string, CalculatedExpression[]>;
+    updatedFhirPathContext: Record<string, any>;
+};
+export declare function createFhirPathContext(questionnaireResponse: QuestionnaireResponse, questionnaireResponseItemMap: Record<string, QuestionnaireResponseItem[]>, variablesFhirPath: Record<string, Expression[]>, existingFhirPathContext: Record<string, any>): Record<string, any>;
+export declare function evaluateLinkIdVariables(item: QuestionnaireResponseItem, variablesFhirPath: Record<string, Expression[]>, fhirPathContext: Record<string, any>): Record<string, any>;
+export declare function addEmptyLinkIdVariables(linkId: string, variablesFhirPath: Record<string, Expression[]>, fhirPathContext: Record<string, any>): Record<string, any>;
+export declare function evaluateQuestionnaireLevelVariables(resource: QuestionnaireResponse, variablesFhirPath: Record<string, Expression[]>, fhirPathContext: Record<string, any>): Record<string, any>;
+export {};

package/lib/src/utils/fhirpath.js

@@ -0,0 +1,119 @@
+/*
+ * Copyright 2024 Commonwealth Scientific and Industrial Research
+ * Organisation (CSIRO) ABN 41 687 119 230.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import fhirpath from 'fhirpath';
+import fhirpath_r4_model from 'fhirpath/fhir-context/r4';
+import { evaluateEnableWhenExpressions } from './enableWhenExpression';
+import { evaluateCalculatedExpressions } from './calculatedExpression';
+export function evaluateUpdatedExpressions(params) {
+    const { updatedResponse, updatedResponseItemMap, enableWhenExpressions, calculatedExpressions, variablesFhirPath, existingFhirPathContext } = params;
+    const noExpressionsToBeUpdated = Object.keys(enableWhenExpressions).length === 0 &&
+        Object.keys(calculatedExpressions).length === 0;
+    if (noExpressionsToBeUpdated || !updatedResponse.item) {
+        return {
+            isUpdated: false,
+            updatedEnableWhenExpressions: enableWhenExpressions,
+            updatedCalculatedExpressions: calculatedExpressions,
+            updatedFhirPathContext: existingFhirPathContext
+        };
+    }
+    const updatedFhirPathContext = createFhirPathContext(updatedResponse, updatedResponseItemMap, variablesFhirPath, existingFhirPathContext);
+    // Update enableWhenExpressions
+    const { enableWhenExpsIsUpdated, updatedEnableWhenExpressions } = evaluateEnableWhenExpressions(updatedFhirPathContext, enableWhenExpressions);
+    // Update calculatedExpressions
+    const { calculatedExpsIsUpdated, updatedCalculatedExpressions } = evaluateCalculatedExpressions(updatedFhirPathContext, calculatedExpressions);
+    const isUpdated = enableWhenExpsIsUpdated || calculatedExpsIsUpdated;
+    return {
+        isUpdated,
+        updatedEnableWhenExpressions,
+        updatedCalculatedExpressions,
+        updatedFhirPathContext
+    };
+}
+export function createFhirPathContext(questionnaireResponse, questionnaireResponseItemMap, variablesFhirPath, existingFhirPathContext) {
+    // Add latest resource to fhirPathContext
+    let fhirPathContext = Object.assign(Object.assign({}, existingFhirPathContext), { resource: questionnaireResponse, rootResource: questionnaireResponse });
+    // Evaluate resource-level variables
+    fhirPathContext = evaluateQuestionnaireLevelVariables(questionnaireResponse, variablesFhirPath, fhirPathContext);
+    // Add variables of items that exist in questionnaireResponseItemMap into fhirPathContext
+    for (const linkId in questionnaireResponseItemMap) {
+        // For non-repeat groups, the same linkId will have only one item
+        // For repeat groups, the same linkId will have multiple items
+        for (const qrItem of questionnaireResponseItemMap[linkId]) {
+            fhirPathContext = evaluateLinkIdVariables(qrItem, variablesFhirPath, fhirPathContext);
+        }
+    }
+    // Items don't exist in questionnaireResponseItemMap, but we still have to add them into the fhirPathContext as empty arrays
+    for (const linkId in variablesFhirPath) {
+        fhirPathContext = addEmptyLinkIdVariables(linkId, variablesFhirPath, fhirPathContext);
+    }
+    return fhirPathContext;
+}
+export function evaluateLinkIdVariables(item, variablesFhirPath, fhirPathContext) {
+    const linkIdVariables = variablesFhirPath[item.linkId];
+    if (!linkIdVariables || linkIdVariables.length === 0) {
+        return fhirPathContext;
+    }
+    for (const variable of linkIdVariables) {
+        if (variable.expression && variable.name) {
+            try {
+                fhirPathContext[`${variable.name}`] = fhirpath.evaluate(item, {
+                    base: 'QuestionnaireResponse.item',
+                    expression: variable.expression
+                }, fhirPathContext, fhirpath_r4_model);
+            }
+            catch (e) {
+                console.warn(e.message, `LinkId: ${item.linkId}\nExpression: ${variable.expression}`);
+            }
+        }
+    }
+    return fhirPathContext;
+}
+export function addEmptyLinkIdVariables(linkId, variablesFhirPath, fhirPathContext) {
+    const linkIdVariables = variablesFhirPath[linkId];
+    if (!linkIdVariables || linkIdVariables.length === 0) {
+        return fhirPathContext;
+    }
+    for (const variable of linkIdVariables) {
+        if (variable.expression && variable.name) {
+            if (fhirPathContext[`${variable.name}`] === undefined) {
+                fhirPathContext[`${variable.name}`] = [];
+            }
+        }
+    }
+    return fhirPathContext;
+}
+export function evaluateQuestionnaireLevelVariables(resource, variablesFhirPath, fhirPathContext) {
+    const questionnaireLevelVariables = variablesFhirPath['QuestionnaireLevel'];
+    if (!questionnaireLevelVariables || questionnaireLevelVariables.length === 0) {
+        return fhirPathContext;
+    }
+    for (const variable of questionnaireLevelVariables) {
+        if (variable.expression) {
+            try {
+                fhirPathContext[`${variable.name}`] = fhirpath.evaluate(resource, {
+                    base: 'QuestionnaireResponse',
+                    expression: variable.expression
+                }, fhirPathContext, fhirpath_r4_model);
+            }
+            catch (e) {
+                console.warn(e.message, `Questionnaire-level\nExpression: ${variable.expression}`);
+            }
+        }
+    }
+    return fhirPathContext;
+}
+//# sourceMappingURL=fhirpath.js.map

package/lib/src/utils/fhirpath.js.map

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

package/lib/src/utils/fileUtils.d.ts

@@ -0,0 +1,3 @@
+import type { Attachment } from 'fhir/r4';
+export declare function getFileSize(fileSizeString: string): string;
+export declare function createAttachmentAnswer(file: File | null, url: string, fileName: string): Promise<Attachment | null>;

package/lib/src/utils/fileUtils.js

@@ -0,0 +1,64 @@
+/*
+ * Copyright 2024 Commonwealth Scientific and Industrial Research
+ * Organisation (CSIRO) ABN 41 687 119 230.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+export function getFileSize(fileSizeString) {
+    if (fileSizeString.length < 7) {
+        return `${Math.round(+fileSizeString / 1024)}kb`;
+    }
+    return `${Math.round(+fileSizeString / 1024) / 1000}MB`;
+}
+const fileToBase64 = (file) => new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.readAsDataURL(file);
+    reader.onload = () => resolve(reader.result);
+    reader.onerror = reject;
+});
+export function createAttachmentAnswer(file, url, fileName) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!file || url === '') {
+            return null;
+        }
+        try {
+            const base64Data = (yield fileToBase64(file));
+            const attachment = {
+                contentType: file.type,
+                data: base64Data,
+                size: file.size
+            };
+            if (url) {
+                attachment.url = url;
+            }
+            if (fileName) {
+                attachment.title = fileName;
+            }
+            return attachment;
+        }
+        catch (error) {
+            console.error(error);
+            return null;
+        }
+    });
+}
+//# sourceMappingURL=fileUtils.js.map

package/lib/src/utils/fileUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileUtils.js","sourceRoot":"","sources":["../../../src/utils/fileUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;;;;;;;;;;AAIH,MAAM,UAAU,WAAW,CAAC,cAAsB;IAChD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC;IACnD,CAAC;IAED,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC;AAC1D,CAAC;AAED,MAAM,YAAY,GAAG,CAAC,IAAU,EAAE,EAAE,CAClC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IAC9B,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;IAChC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC;AAC1B,CAAC,CAAC,CAAC;AAEL,MAAM,UAAgB,sBAAsB,CAC1C,IAAiB,EACjB,GAAW,EACX,QAAgB;;QAEhB,IAAI,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,CAAW,CAAC;YACxD,MAAM,UAAU,GAAe;gBAC7B,WAAW,EAAE,IAAI,CAAC,IAAI;gBACtB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC;YAEF,IAAI,GAAG,EAAE,CAAC;gBACR,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC;YACvB,CAAC;YAED,IAAI,QAAQ,EAAE,CAAC;gBACb,UAAU,CAAC,KAAK,GAAG,QAAQ,CAAC;YAC9B,CAAC;YAED,OAAO,UAAU,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CAAA"}

package/lib/src/utils/formChanges.d.ts

@@ -0,0 +1,18 @@
+import type { QuestionnaireResponseItemAnswer } from 'fhir/r4';
+type JsonDiffOperator = '+' | '-' | '~' | ' ';
+type QuestionnaireResponseItemDiffArray = [JsonDiffOperator, QuestionnaireResponseDiffItem];
+type QuestionnaireResponseItemAnswerDiffArray = [JsonDiffOperator, QuestionnaireResponseItemAnswer];
+interface QuestionnaireResponseDiffItem {
+    linkId: string;
+    item: QuestionnaireResponseItemDiffArray[] | undefined;
+    answer: QuestionnaireResponseItemAnswer[] | QuestionnaireResponseItemAnswerDiffArray[] | undefined;
+}
+interface ItemChange {
+    linkId: string;
+    itemType: string;
+    operation: 'add' | 'remove' | 'update';
+    value: QuestionnaireResponseItemAnswer;
+}
+export declare function readFormChanges(formChanges: object, itemTypes: Record<string, string>): Record<string, ItemChange | null>;
+export declare function readItemChangesRecursive(diffArray: QuestionnaireResponseItemDiffArray, itemTypes: Record<string, string>, changedItems: Record<string, ItemChange | null>): Record<string, ItemChange | null>;
+export {};

package/lib/src/utils/formChanges.js

@@ -0,0 +1,91 @@
+/*
+ * Copyright 2024 Commonwealth Scientific and Industrial Research
+ * Organisation (CSIRO) ABN 41 687 119 230.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export function readFormChanges(formChanges, itemTypes) {
+    if (!('item' in formChanges)) {
+        return {};
+    }
+    const changedItems = {};
+    const diffArrays = formChanges.item;
+    for (const diffArray of diffArrays) {
+        readItemChangesRecursive(diffArray, itemTypes, changedItems);
+    }
+    return changedItems;
+}
+export function readItemChangesRecursive(diffArray, itemTypes, changedItems) {
+    const operator = diffArray[0];
+    const diffItem = diffArray[1];
+    if (!operator || !diffItem) {
+        return changedItems;
+    }
+    changedItems[diffItem.linkId] = null;
+    const childDiffArrays = diffItem.item;
+    if (childDiffArrays && childDiffArrays.length > 0) {
+        for (const childDiffArray of childDiffArrays) {
+            readItemChangesRecursive(childDiffArray, itemTypes, changedItems);
+        }
+    }
+    // if (operator !== ' ') {
+    //   console.log(operator, diffItem);
+    // }
+    // explore answer diff arrays
+    // exmaple: [["+", {"valueString": "test"}], ["-", {"valueString": "test"}]]
+    // or it could be a regular answer array
+    // exmaple: [{"valueString": "test"}, {"valueString": "test"}]
+    const answerDiffArrays = diffItem.answer;
+    if (answerDiffArrays && isAnswerDiffArray(answerDiffArrays)) {
+        for (const answerDiffArray of answerDiffArrays) {
+            getItemChange(diffItem, answerDiffArray, itemTypes, changedItems);
+        }
+    }
+    return changedItems;
+}
+function getItemChange(diffItem, answerDiffArray, itemTypes, changedItems) {
+    const operator = answerDiffArray[0];
+    const answer = answerDiffArray[1];
+    if (operator === ' ') {
+        return;
+    }
+    const itemType = itemTypes[diffItem.linkId];
+    const operation = answerDiffOperationSwitcher(operator);
+    if (operation) {
+        changedItems[diffItem.linkId] = {
+            linkId: diffItem.linkId,
+            itemType: itemType,
+            operation: operation,
+            value: answer
+        };
+    }
+}
+function answerDiffOperationSwitcher(operator) {
+    switch (operator) {
+        case '+':
+            return 'add';
+        case '-':
+            return 'remove';
+        case '~':
+            return 'update';
+        default:
+            return null;
+    }
+}
+// type predicates
+function isAnswerDiffArray(answer) {
+    return answer.every((answerItem) => Array.isArray(answerItem) &&
+        typeof answerItem[0] === 'string' &&
+        typeof answerItem[1] === 'object');
+}
+//# sourceMappingURL=formChanges.js.map

package/lib/src/utils/formChanges.js.map

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

package/lib/src/utils/genericRecursive.d.ts

@@ -0,0 +1,20 @@
+import type { Questionnaire, QuestionnaireItem, QuestionnaireResponse, QuestionnaireResponseItem } from 'fhir/r4';
+export type RecursiveUpdateFunction<T> = (qItem: QuestionnaireItem, qrItemOrItems: QuestionnaireResponseItem | QuestionnaireResponseItem[] | null, extraData: T) => QuestionnaireResponseItem | QuestionnaireResponseItem[] | null;
+/**
+ * A generic (and safe) way to update a QuestionnaireResponse given a recursive function and a set of data i.e. Record<linkId, calculated expression values>, Record<linkId, re-populated values>
+ * This function relies heavily on mapQItemsIndex() and getQrItemsIndex() to accurately pinpoint the locations of QR items based on their positions in the Q, taking into account repeating group answers, non-filled questions, etc
+ *
+ * @author Sean Fong
+ */
+export declare function updateQuestionnaireResponse<T>(questionnaire: Questionnaire, questionnaireResponse: QuestionnaireResponse, recursiveUpdateFunction: RecursiveUpdateFunction<T>, extraData: T): QuestionnaireResponse;
+export type RecursiveReadArrayFunction<T, U> = (qItem: QuestionnaireItem, qrItemOrItems: QuestionnaireResponseItem | QuestionnaireResponseItem[] | null, extraData?: U) => T[] | null;
+/**
+ * A generic (and safe) way to read an array of element(s) i.e. QuestionnaireResponseItem[], extracted Observation[] from a QuestionnaireResponse given a recursive function.
+ * It also provides an optional extraData (generic U) parameter for additional data that the recursive function may need.
+ * This function relies heavily on mapQItemsIndex() and getQrItemsIndex() to accurately pinpoint the locations of QR items based on their positions in the Q, taking into account repeating group answers, non-filled questions, etc
+ *
+ * @author Sean Fong
+ */
+export declare function readQuestionnaireResponse<T, U>(questionnaire: Questionnaire, questionnaireResponse: QuestionnaireResponse, recursiveReadFunction: RecursiveReadArrayFunction<T, U>, extraData?: U): T[];
+export type RecursiveTranverseFunction<U> = (qItem: QuestionnaireItem, root?: Questionnaire, parent?: QuestionnaireItem, extraData?: U) => void;
+export declare function transverseQuestionnaire<U>(questionnaire: Questionnaire, recursiveTranverseFunction: RecursiveTranverseFunction<U>, extraData?: U): void;