@smile-cdr/fhirts 2.0.6 → 2.1.0

package/src/library/BundleUtils/BundleUtils.spec.ts

@@ -0,0 +1,65 @@
+import { BundleUtils } from "./BundleUtils";
+
+const inputPayload = require("./../../test-resources/Bundle-R4.json");
+describe("BundleUtils", () => {
+
+  let bundleUtils = new BundleUtils();
+  
+  describe("#getResources()", () => {
+    it("should return empty array if null is passed as bundle entries", () => {
+      // execute
+      const actual = bundleUtils.getResources(null, "Patient");
+      // validate
+      expect(actual.length).toEqual(0);
+    });
+
+    it("should return empty array if invalid resourceType is passed", () => {
+      // execute
+      const actual = bundleUtils.getResources(
+        inputPayload.entry,
+        "patient"
+      );
+      // validate
+      expect(actual.length).toEqual(0);
+    });
+
+    it("should return all matches array", () => {
+      // execute
+      const actual = bundleUtils.getResources(
+        inputPayload.entry,
+        "Claim"
+      );
+      // validate
+      expect(actual.length).toEqual(27);
+    });
+  });
+
+  describe("#getResource()", () => {
+    it("should return null if null is passed as bundle entries", () => {
+      // execute
+      const actual = bundleUtils.getResource(null, "123");
+      // validate
+      expect(actual).toBeNull();
+    });
+
+    it("should return undefined if resourceId is not found", () => {
+      // execute
+      const actual = bundleUtils.getResource(
+        inputPayload.entry,
+        "123"
+      );
+      // validate
+      expect(actual).toBeUndefined();
+    });
+
+    it("should return resource if resource is found", () => {
+      // execute
+      const actual = bundleUtils.getResource(
+        inputPayload.entry,
+        "ec0bb1b3-b229-36cf-7e34-3f5fec9d3afe"
+      );
+      // validate
+      expect(actual).not.toBeNull();
+    });
+  });
+});

package/src/library/BundleUtils/BundleUtils.ts

@@ -0,0 +1,26 @@
+export class BundleUtils {
+
+    /**
+     * 
+     * @param bundleEntry Bundle.entry[] i.e. the bundle entries to filter
+     * @param resourceTypeToFilter ResourceType to filter from bundle entries
+     * @returns array of resources
+     */
+    getResources(bundleEntry: any[], resourceTypeToFilter: string): any[] {
+        return bundleEntry?.length ? bundleEntry.filter(x => x['resource']['resourceType'] === resourceTypeToFilter) : [];
+    }
+
+    /**
+     * 
+     * @param bundleEntry Bundle.entry[] i.e. the bundle entries to filter
+     * @param resourceId Resource ID to filter from bundle entries
+     * @returns single resource
+     */
+    getResource(bundleEntry: any[], resourceId: string): any {
+        return bundleEntry?.length ? bundleEntry.find(x => x['resource']['id'] === resourceId) : null;
+    }
+
+}
+
+
+

package/src/library/{ResourceUtilities/ResourceUtilities.spec.ts → ResourceUtils/ResourceUtils.spec.ts}

@@ -1,29 +1,40 @@
-import { Patient } from "../../FHIR-R4/classes/patient";
-import { ResourceUtilities } from "./ResourceUtilities";
+import { ResourceUtils } from "./ResourceUtils";
 
-const inputPayload = require("./../../test-resources/Patient-R4.json");
-describe("ResourceUtilities", () => {
+const patientPayload = require("./../../test-resources/Patient-R4.json");
+const careTeamPayload = require("./../../test-resources/CareTeam-R4.json");
+describe("ResourceUtils", () => {
+
+  let resourceUtils = new ResourceUtils();
 
   describe("#getResourceProperty()", () => {
-    it('should return property if property exists in valid inputJson', () => {
+    it("should return property if property exists in valid inputJson", () => {
       // execute
-      const actual = ResourceUtilities.getResourceProperty(inputPayload, 'deceasedBoolean');
+      const actual = resourceUtils.getResourceProperty(
+        patientPayload,
+        "deceasedBoolean"
+      );
       // validate
       expect(actual).toBeFalse();
     });
 
-    it('should return null if property exists in valid inputJson', () => {
+    it("should return null if property exists in valid inputJson", () => {
       // execute
-      const actual = ResourceUtilities.getResourceProperty(inputPayload, 'abcd');
+      const actual = resourceUtils.getResourceProperty(
+        patientPayload,
+        "abcd"
+      );
       // validate
       expect(actual).toBeNull();
     });
 
-    it('should return null if invalid inputJson is passed', () => {
+    it("should return null if invalid inputJson is passed", () => {
       // setup
-      const inputPayload = [1,2];
+      const inputPayload = [1, 2];
       // execute
-      const actual = ResourceUtilities.getResourceProperty(inputPayload, 'deceasedBoolean');
+      const actual = resourceUtils.getResourceProperty(
+        inputPayload,
+        "deceasedBoolean"
+      );
       // validate
       expect(actual).toBeNull();
     });
@@ -47,7 +58,11 @@ describe("ResourceUtilities", () => {
       // setup
       const value = "abc";
       // execute
-      const actual = ResourceUtilities.getIdentifiersByProperty(null, "abc", value);
+      const actual = resourceUtils.getIdentifiersByProperty(
+        null,
+        "abc",
+        value
+      );
       // validate
       expect(actual.length).toEqual(0);
     });
@@ -56,7 +71,7 @@ describe("ResourceUtilities", () => {
       // setup
       const value = "abc";
       // execute
-      const actual = ResourceUtilities.getIdentifiersByProperty(
+      const actual = resourceUtils.getIdentifiersByProperty(
         identifierList,
         "abc",
         value
@@ -69,7 +84,7 @@ describe("ResourceUtilities", () => {
       // setup
       const systemUrl = "http://somesystem.com";
       // execute
-      const actual = ResourceUtilities.getIdentifiersByProperty(
+      const actual = resourceUtils.getIdentifiersByProperty(
         identifierList,
         "system",
         systemUrl
@@ -82,7 +97,7 @@ describe("ResourceUtilities", () => {
       // setup
       const value = "abc";
       // execute
-      const actual = ResourceUtilities.getIdentifiersByProperty(
+      const actual = resourceUtils.getIdentifiersByProperty(
         identifierList,
         "value",
         value
@@ -106,7 +121,7 @@ describe("ResourceUtilities", () => {
 
     it("should return empty array if null is passed as extension list", () => {
       // execute
-      const actual = ResourceUtilities.getExtensionsByUrl(null, "url");
+      const actual = resourceUtils.getExtensionsByUrl(null, "url");
       // validate
       expect(actual.length).toEqual(0);
     });
@@ -122,7 +137,7 @@ describe("ResourceUtilities", () => {
       ];
       const url = "http://ns.electronichealth.net.au/id/hi/ihi/1.0";
       // execute
-      const actual = ResourceUtilities.getExtensionsByUrl(
+      const actual = resourceUtils.getExtensionsByUrl(
         extensionListInvalid,
         url
       );
@@ -134,7 +149,7 @@ describe("ResourceUtilities", () => {
       // setup
       const url = "http://somesystem.com";
       // execute
-      const actual = ResourceUtilities.getExtensionsByUrl(extensionList, url);
+      const actual = resourceUtils.getExtensionsByUrl(extensionList, url);
       // validate
       expect(actual.length).toEqual(0);
     });
@@ -143,7 +158,7 @@ describe("ResourceUtilities", () => {
       // setup
       const url = "http://ns.electronichealth.net.au/id/hi/ihi/1.0";
       // execute
-      const actual = ResourceUtilities.getExtensionsByUrl(extensionList, url);
+      const actual = resourceUtils.getExtensionsByUrl(extensionList, url);
       // validate
       expect(actual.length).toEqual(1);
     });
@@ -170,7 +185,7 @@ describe("ResourceUtilities", () => {
       // setup
       const value = "abc";
       // execute
-      const actual = ResourceUtilities.getCodingsByProperty(null, "abc", value);
+      const actual = resourceUtils.getCodingsByProperty(null, "abc", value);
       // validate
       expect(actual.length).toEqual(0);
     });
@@ -179,7 +194,7 @@ describe("ResourceUtilities", () => {
       // setup
       const value = "abc";
       // execute
-      const actual = ResourceUtilities.getCodingsByProperty(
+      const actual = resourceUtils.getCodingsByProperty(
         codingList,
         "abc",
         value
@@ -192,7 +207,7 @@ describe("ResourceUtilities", () => {
       // setup
       const systemUrl = "http://somesystem.com";
       // execute
-      const actual = ResourceUtilities.getCodingsByProperty(
+      const actual = resourceUtils.getCodingsByProperty(
         codingList,
         "system",
         systemUrl
@@ -205,7 +220,7 @@ describe("ResourceUtilities", () => {
       // setup
       const value = "abc";
       // execute
-      const actual = ResourceUtilities.getCodingsByProperty(
+      const actual = resourceUtils.getCodingsByProperty(
         codingList,
         "code",
         value
@@ -218,7 +233,7 @@ describe("ResourceUtilities", () => {
       // setup
       const value = false;
       // execute
-      const actual = ResourceUtilities.getCodingsByProperty(
+      const actual = resourceUtils.getCodingsByProperty(
         codingList,
         "userSelected",
         value
@@ -227,4 +242,61 @@ describe("ResourceUtilities", () => {
       expect(actual.length).toEqual(1);
     });
   });
+
+  describe("#getValuesAtResourcePath()", () => {
+    
+    it("should return array with values if path exists for a top level element", () => {
+      // execute
+      const pathValues = resourceUtils.getValuesAtResourcePath(patientPayload, "Patient.gender");
+      // validate
+      expect(pathValues.length).toEqual(1);
+      expect(pathValues[0]).toEqual("male");
+    });
+
+    it("should return array with values if path exists for a deep array element", () => {
+      // execute
+      const pathValues = resourceUtils.getValuesAtResourcePath(patientPayload, "Patient.contact.relationship.coding.system");
+      // validate
+      expect(pathValues.length).toEqual(2);
+      expect(pathValues[0]).toEqual("http://terminology.hl7.org/CodeSystem/v2-0131");
+      expect(pathValues[1]).toEqual("http://terminology.hl7.org/CodeSystem/v2-0132");
+    });
+
+    it("should return array with values if path exists for a deep json element", () => {
+      // execute
+      const pathValues = resourceUtils.getValuesAtResourcePath(patientPayload, "Patient.maritalStatus.coding.system");
+      // validate
+      expect(pathValues.length).toEqual(1);
+      expect(pathValues[0]).toEqual("http://terminology.hl7.org/CodeSystem/v3-MaritalStatus");
+    });
+
+    it("should return empty array if path does not exist", () => {
+      // execute
+      const pathValues = resourceUtils.getValuesAtResourcePath(patientPayload, "Patient.contact.relationship.coding.abcd");
+      // validate
+      expect(pathValues.length).toEqual(0);
+    });
+  });
+
+  describe("#getAllResourceReferences()", () => {
+
+    it("should return array of all references in a resource when references found", () => {
+      // execute
+      const actual = resourceUtils.getAllReferencesFromResource(careTeamPayload);
+      // validate
+      expect(actual.length).toEqual(6);
+    });
+
+    it("should return empty array if references in a resource not found", () => {
+      // setup
+      const input = {
+        "resourceType": "Patient"
+      };
+      // execute
+      const actual = resourceUtils.getAllReferencesFromResource(input);
+      // validate
+      expect(actual.length).toEqual(0);
+    });
+
+  });
 });

package/src/library/ResourceUtils/ResourceUtils.ts

@@ -0,0 +1,124 @@
+export class ResourceUtils {
+  /**
+   *
+   * @param inputJson - valid json
+   * @param propertyName - top level property for resource
+   * @returns json property if it exists
+   * @limitation currently just supports get for top level property on resource
+   */
+  getResourceProperty(inputJson: object, propertyName: string) {
+    let resourcePropertyValue = null;
+    if (inputJson.hasOwnProperty(propertyName)) {
+      resourcePropertyValue = inputJson[propertyName];
+    }
+    return resourcePropertyValue;
+  }
+
+  /**
+   *
+   * @param identifierList list of identifiers
+   * @param propertyToCompare identifier property to compare
+   * @param propertyValue value we want to compare against
+   * @returns array of matches
+   * @limitations currently does not work with identifier.type, identifier.period & identifier.assigner
+   */
+  getIdentifiersByProperty(
+    identifierList: any[],
+    propertyToCompare: string,
+    propertyValue: string
+  ): any[] {
+    return identifierList?.length
+      ? identifierList.filter((x) => x[propertyToCompare] === propertyValue)
+      : [];
+  }
+
+  /**
+   *
+   * @param extensionList list of extensions
+   * @param extensionUrl Extension.url to compare
+   * @returns array of matches
+   */
+  getExtensionsByUrl(extensionList: any[], extensionUrl: string): any[] {
+    return extensionList?.length
+      ? extensionList.filter((x) => x["url"] === extensionUrl)
+      : [];
+  }
+
+  /**
+   *
+   * @param codingList list of codings
+   * @param propertyToCompare coding property to compare
+   * @param propertyValue value we want to compare against string or boolean
+   * @returns array of matches
+   */
+  getCodingsByProperty(
+    codingList: any[],
+    propertyToCompare: string,
+    propertyValue: string | boolean
+  ): any[] {
+    return codingList?.length
+      ? codingList.filter((x) => x[propertyToCompare] === propertyValue)
+      : [];
+  }
+
+  /**
+   *
+   * @param resource resource for which path needs to be validated
+   * @param elementPath path to validate in resource
+   * @returns array of elements found at the provided path
+   */
+  getValuesAtResourcePath(resource: any, elementPath: string): any[] {
+    const pathSections = elementPath.split(".");
+    let resourcePathValue;
+    for (let index = 1; index < pathSections.length; index++) {
+      const subPaths = pathSections[index];
+      resourcePathValue = resourcePathValue ? resourcePathValue[subPaths] : resource[subPaths];
+      if (resourcePathValue) {
+        if (this.isPrimitive(resourcePathValue)) {
+          return [resourcePathValue];
+        } else if (Array.isArray(resourcePathValue) && resourcePathValue.length > 0) {
+           let resultSet = [];
+           for (let subPathIndex = 0; subPathIndex < resourcePathValue.length; subPathIndex++) {
+              const subPathValue = resourcePathValue[subPathIndex];
+              resultSet.push(...this.getValuesAtResourcePath(subPathValue,
+                 pathSections.slice(index).join(".")));
+           }
+           return resultSet;
+        } else if (typeof(resourcePathValue) === 'object') {
+          return this.getValuesAtResourcePath(resourcePathValue,
+            pathSections.slice(index).join("."));
+        }
+      } else {
+        break;
+      }
+    }
+    return [];
+  }
+
+  private isPrimitive(value: any) {
+    return typeof(value) === "boolean" || typeof(value) === "string";
+  }
+
+  /**
+   * @param resource resource to pull out references from
+   * @returns array of references inside a resource
+   */
+  getAllReferencesFromResource(resource: any): string[] {
+    const stringifiedResource = JSON.stringify(resource);
+    const referenceJsonString = '"reference":';
+    let references = [];
+    let cursor = stringifiedResource.indexOf(referenceJsonString, 0);
+    while (cursor > -1) {
+      const referenceStart = stringifiedResource.indexOf(referenceJsonString, cursor) + referenceJsonString.length;
+      const referenceEnd = stringifiedResource.indexOf('"', referenceStart + 1);
+      const reference = stringifiedResource.substring(referenceStart, referenceEnd);
+      // this means the reference ends started reading from start again
+      if(referenceEnd < cursor) {
+        break;
+      }
+      references.push(reference);
+      cursor = referenceEnd;
+    }
+    return references;
+  }
+}

package/src/test-resources/CareTeam-R4.json

@@ -0,0 +1,85 @@
+{
+    "resourceType": "CareTeam",
+    "id": "example",
+    "text": {
+      "status": "generated",
+      "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Care Team</div>"
+    },
+    "contained": [
+      {
+        "resourceType": "Practitioner",
+        "id": "pr1",
+        "name": [
+          {
+            "family": "Dietician",
+            "given": [
+              "Dorothy"
+            ]
+          }
+        ]
+      }
+    ],
+    "identifier": [
+      {
+        "value": "12345"
+      }
+    ],
+    "status": "active",
+    "category": [
+      {
+        "coding": [
+          {
+            "system": "http://loinc.org",
+            "code": "LA27976-2",
+            "display": "Encounter-focused care team"
+          }
+        ]
+      }
+    ],
+    "name": "Peter James Charlmers Care Plan for Inpatient Encounter",
+    "subject": {
+      "reference": "Patient/example",
+      "display": "Peter James Chalmers"
+    },
+    "encounter": {
+      "reference": "Encounter/example"
+    },
+    "period": {
+      "end": "2013-01-01"
+    },
+    "participant": [
+      {
+        "role": [
+          {
+            "text": "responsiblePerson"
+          }
+        ],
+        "member": {
+          "reference": "Patient/example",
+          "display": "Peter James Chalmers"
+        }
+      },
+      {
+        "role": [
+          {
+            "text": "adviser"
+          }
+        ],
+        "member": {
+          "reference": "#pr1",
+          "display": "Dorothy Dietition"
+        },
+        "onBehalfOf": {
+          "reference": "Organization/f001"
+        },
+        "period": {
+          "end": "2013-01-01"
+        }
+      }
+    ],
+    "managingOrganization": [
+      {
+        "reference": "Organization/f001"
+      }
+    ]
+  }

package/src/test-resources/Patient-R4.json

@@ -83,6 +83,10 @@
               {
                 "system": "http://terminology.hl7.org/CodeSystem/v2-0131",
                 "code": "C"
+              },
+              {
+                "system": "http://terminology.hl7.org/CodeSystem/v2-0132",
+                "code": "D"
               }
             ]
           }

package/dist/library/BundleUtilities/BundleUtilities.d.ts

@@ -1,10 +0,0 @@
-export declare class BundleUtility {
-    /**
-     *
-     * @param bundleEntry Bundle.entry[] i.e. the bundle entries to filter
-     * @param resourceTypeToFilter ResourceType to filter from bundle entries
-     * @returns array of resources
-     */
-    getResourcesFromBundle(bundleEntry: any[], resourceTypeToFilter: string): any[];
-}
-export declare const BundleUtilities: BundleUtility;

package/dist/library/BundleUtilities/BundleUtilities.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BundleUtilities = exports.BundleUtility = void 0;
-class BundleUtility {
-    /**
-     *
-     * @param bundleEntry Bundle.entry[] i.e. the bundle entries to filter
-     * @param resourceTypeToFilter ResourceType to filter from bundle entries
-     * @returns array of resources
-     */
-    getResourcesFromBundle(bundleEntry, resourceTypeToFilter) {
-        return (bundleEntry === null || bundleEntry === void 0 ? void 0 : bundleEntry.length) ? bundleEntry.filter(x => x['resource']['resourceType'] === resourceTypeToFilter) : [];
-    }
-}
-exports.BundleUtility = BundleUtility;
-exports.BundleUtilities = new BundleUtility();

package/dist/library/BundleUtilities/BundleUtilities.spec.js

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const BundleUtilities_1 = require("./BundleUtilities");
-const inputPayload = require("./../../test-resources/Bundle-R4.json");
-describe("BundleUtilities", () => {
-    describe("#getResourcesFromBundle()", () => {
-        it('should return empty array if null is passed as bundle entries', () => {
-            // execute
-            const actual = BundleUtilities_1.BundleUtilities.getResourcesFromBundle(null, 'Patient');
-            // validate
-            expect(actual.length).toEqual(0);
-        });
-        it('should return empty array if invalid resourceType is passed', () => {
-            // execute
-            const actual = BundleUtilities_1.BundleUtilities.getResourcesFromBundle(inputPayload.entry, 'patient');
-            // validate
-            expect(actual.length).toEqual(0);
-        });
-        it('should return all matches array', () => {
-            // execute
-            const actual = BundleUtilities_1.BundleUtilities.getResourcesFromBundle(inputPayload.entry, 'Claim');
-            // validate
-            expect(actual.length).toEqual(27);
-        });
-    });
-});

package/dist/library/ResourceUtilities/ResourceUtilities.js

@@ -1,51 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ResourceUtilities = exports.ResourceUtility = void 0;
-class ResourceUtility {
-    /**
-     *
-     * @param inputJson - valid json
-     * @param propertyName - top level property for resource
-     * @returns json property if it exists
-     * @limitation currently just supports get for top level property on resource
-     */
-    getResourceProperty(inputJson, propertyName) {
-        let resourcePropertyValue = null;
-        if (inputJson.hasOwnProperty(propertyName)) {
-            resourcePropertyValue = inputJson[propertyName];
-        }
-        return resourcePropertyValue;
-    }
-    /**
-     *
-     * @param identifierList list of identifiers
-     * @param propertyToCompare identifier property to compare
-     * @param propertyValue value we want to compare against
-     * @returns array of matches
-     * @limitations currently does not work with identifier.type, identifier.period & identifier.assigner
-     */
-    getIdentifiersByProperty(identifierList, propertyToCompare, propertyValue) {
-        return (identifierList === null || identifierList === void 0 ? void 0 : identifierList.length) ? identifierList.filter(x => x[propertyToCompare] === propertyValue) : [];
-    }
-    /**
-     *
-     * @param extensionList list of extensions
-     * @param extensionUrl Extension.url to compare
-     * @returns array of matches
-     */
-    getExtensionsByUrl(extensionList, extensionUrl) {
-        return (extensionList === null || extensionList === void 0 ? void 0 : extensionList.length) ? extensionList.filter(x => x['url'] === extensionUrl) : [];
-    }
-    /**
-     *
-     * @param codingList list of codings
-     * @param propertyToCompare coding property to compare
-     * @param propertyValue value we want to compare against string or boolean
-     * @returns array of matches
-     */
-    getCodingsByProperty(codingList, propertyToCompare, propertyValue) {
-        return (codingList === null || codingList === void 0 ? void 0 : codingList.length) ? codingList.filter(x => x[propertyToCompare] === propertyValue) : [];
-    }
-}
-exports.ResourceUtility = ResourceUtility;
-exports.ResourceUtilities = new ResourceUtility();

package/src/library/BundleUtilities/BundleUtilities.spec.ts

@@ -1,28 +0,0 @@
-import { BundleUtilities } from "./BundleUtilities";
-
-const inputPayload = require("./../../test-resources/Bundle-R4.json");
-describe("BundleUtilities", () => {
-
-    describe("#getResourcesFromBundle()", () => {
-        it('should return empty array if null is passed as bundle entries', () => {
-            // execute
-            const actual = BundleUtilities.getResourcesFromBundle(null, 'Patient');
-            // validate
-            expect(actual.length).toEqual(0);
-        });
-
-        it('should return empty array if invalid resourceType is passed', () => {
-            // execute
-            const actual = BundleUtilities.getResourcesFromBundle(inputPayload.entry, 'patient');
-            // validate
-            expect(actual.length).toEqual(0);
-        });
-
-        it('should return all matches array', () => {
-            // execute
-            const actual = BundleUtilities.getResourcesFromBundle(inputPayload.entry, 'Claim');
-            // validate
-            expect(actual.length).toEqual(27);
-        });
-    });
-});