update frontend libraries based on those from upstream repo

.env

@@ -1,5 +1,5 @@
 PORT=8000
 REACT_APP_EPIC_SUPPORTED_QUERIES=false
 GENERATE_SOURCEMAP=false
-
 #REACT_APP_SYSTEM_TYPE=
+#REACT_APP_SITE_ID=

.eslintignore

@@ -1,4 +1,5 @@
 # /node_modules/* and /bower_components/* ignored by default
-
+node_modules
+dist/*
 build/*
 coverage/*

.eslintrc

@@ -3,9 +3,12 @@
     "react-app",
     "plugin:jsx-a11y/recommended"
   ],
+  "globals": {
+    "vi": true
+  },
   "rules": {
     "comma-dangle": 0,
-    "max-len": ["error", { "code": 120, "ignoreUrls": true , "ignoreTrailingComments": true, "ignoreRegExpLiterals": true }],
+    //"max-len": ["error", { "code": 120, "ignoreUrls": true , "ignoreTrailingComments": true, "ignoreRegExpLiterals": true }],
     "no-console": 0,
     "no-param-reassign": ["error", {"props": false}],
     "no-unused-vars": [ "error", { "args": "none" } ],

.github/workflows/test.yaml

@@ -12,7 +12,7 @@ jobs:
       - name: Install Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: 10.x
+          node-version: 20.x
 
       - name: Install dependencies
         run: yarn install

.gitignore

@@ -3,8 +3,10 @@
 /node_modules
 /src/cql/valueset-db.json.original
 /build
+/dist
 /coverage
 /tx_bundle_dump
 /test_patient_dump
 *.css
 .DS_Store
+yarn*

.node-version

@@ -1 +1,2 @@
-8.11.3
+20.17.0
+

.nvmrc

@@ -0,0 +1 @@
+20.17.0

.tool-versions

@@ -0,0 +1 @@
+nodejs 20.17.0

Dockerfile

@@ -1,4 +1,4 @@
-FROM node:10 as build-deps
+FROM node:20 as build-deps
 
 WORKDIR /opt/app
 
@@ -15,7 +15,7 @@ ARG REACT_APP_VERSION_STRING
 ENV REACT_APP_VERSION_STRING=$REACT_APP_VERSION_STRING
 
 COPY docker-entrypoint.sh /usr/bin/docker-entrypoint.sh
-COPY --from=build-deps /opt/app/build /usr/share/nginx/html
+COPY --from=build-deps /opt/app/dist /usr/share/nginx/html
 
 # write environment variables to config file and start
 ENTRYPOINT ["/usr/bin/docker-entrypoint.sh"]

README.md

@@ -10,7 +10,7 @@ The Pain Management Summary SMART on FHIR application was developed to support t
 
 The Pain Management Summary SMART on FHIR application was piloted during Summer 2018.  Local modifications and development were needed to fully support this application in the pilot environment.  For example, custom development was needed to expose pain assessments via the FHIR API. See the pilot reports for more information.
 
-This application was originally piloted with support for FHIR DSTU2.  The app has been updated since the pilot to also support FHIR R4, ~~although pilot R4 support has not been piloted in a clinical setting~~ and COSRI production implementations now user R4.
+This application was originally piloted with support for FHIR DSTU2.  The app has been updated since the pilot to also support FHIR R4.  In addition, value sets and standardized codes have been updated since the pilot.  See the comments in the bundled CQL for details.
 
 This prototype application is part of the [CDS Connect](https://cds.ahrq.gov/cdsconnect) project, sponsored by the [Agency for Healthcare Research and Quality](https://www.ahrq.gov/) (AHRQ), and developed under contract with AHRQ by [MITRE's CAMH](https://www.mitre.org/centers/cms-alliances-to-modernize-healthcare/who-we-are) FFRDC.
 
@@ -32,11 +32,6 @@ This CDS logic queries for several concepts that do not yet have standardized co
 
 | Code | System | Display |
 | --- | --- | --- |
-| PEGASSESSMENT | http://cds.ahrq.gov/cdsconnect/pms | Pain Enjoyment General Activity (PEG) Assessment |
-| PEGPAIN | http://cds.ahrq.gov/cdsconnect/pms | Pain |
-| PEGENJOYMENT | http://cds.ahrq.gov/cdsconnect/pms | Enjoyment of life |
-| PEGGENERALACTIVITY | http://cds.ahrq.gov/cdsconnect/pms | General activity |
-| STARTBACK | http://cds.ahrq.gov/cdsconnect/pms | STarT Back Screening Tool |
 | SQETOHUSE | http://cds.ahrq.gov/cdsconnect/pms | Single question r/t ETOH use |
 | SQDRUGUSE | http://cds.ahrq.gov/cdsconnect/pms | Single question r/t drug use |
 | MME | http://cds.ahrq.gov/cdsconnect/pms | Morphine Milligram Equivalent (MME) |
@@ -45,7 +40,7 @@ Systems integrating the Pain Management Summary will need to expose the correspo
 
 ### To build and run in development:
 
-1. Install [Node.js](https://nodejs.org/en/download/) (LTS edition, currently 8.x)
+1. Install [Node.js](https://nodejs.org/en/download/) (LTS edition, currently 20.x)
 2. Install [Yarn](https://yarnpkg.com/en/docs/install) (1.3.x or above)
 3. Install dependencies by executing `yarn` from the project's root directory
 4. If you have a SMART-on-FHIR client ID, edit `public/launch-context.json` to specify it
@@ -57,21 +52,49 @@ Systems integrating the Pain Management Summary will need to expose the correspo
 
 The Pain Management Summary can be deployed as static web resources on any HTTP server.  There are several customizations, however, that need to be made based on the site where it is deployed.
 
-1. Install [Node.js](https://nodejs.org/en/download/) (LTS edition, currently 8.x)
+1. Install [Node.js](https://nodejs.org/en/download/) (LTS edition, currently 20.x)
 2. Install [Yarn](https://yarnpkg.com/en/docs/install) (1.3.x or above)
 3. Install dependencies by executing `yarn` from the project's root directory
-4. Modify the `homepage` value in `package.json` to reflect the path (after the hostname) at which it will be deployed
-   a. For example, if deploying to https://my-server/pain-mgmt-summary/, the `homepage` value should be `"http://localhost:8000/pain-mgmt-summary"` (note that the hostname need not match)
-   b. If deploying to the root of the domain, you can leave `homepage` as `"."`
+4. Modify the `base` value in `vite.config.mjs` to reflect the path (after the hostname) at which it will be deployed
+   a. The path must start and end with a forward slash (`/`).
+   b. For example, if deploying to https://my-server/pain-mgmt-summary/, the `base` value should be `"/pain-mgmt-summary/"`.
+   c. If deploying to the root of the domain, set the `base` value to `"/"` or comment out the `base` property.
 5. Modify the `clientId` in `public/launch-context.json` to match the unique client ID you registered with the EHR from which this app will be launched
 6. NOTE: The launch context contains `"completeInTarget": true`. This is needed if you are running in an environment that initializes the app in a separate window (such as the public SMART sandbox).  It can be safely removed in other cases.
 7. If you've set up an analytics endpoint (see below), set the `analytics_endpoint` and `x_api_key` in `public/config.json`
 8. If you'll be launching the app from an Epic EHR, modify `.env` to set `REACT_APP_EPIC_SUPPORTED_QUERIES` to `true`
    a. This modifies some queries based on Epic-specific requirements
-9. Run `yarn build` to compile the code to static files in the `build` folder
-10. Deploy the output from the `build` folder to a standard web server
+9. Run `yarn build` to compile the code to static files in the `dist` folder
+10. Deploy the output from the `dist` folder to a standard web server
 
-Optionally to step 9, you can run the static build contents in a simple Node http-server via the command: `yarn start-static`.
+Optionally to step 9, you can run `yarn serve` to use Vite's built-in server to host the code in `dist`. This approach, however, should not be used in production.
+
+### To update the valueset-db.json file
+
+The value set content used by the CQL is cached in a file named `valueset-db.json`.  If the CQL has been modified to add or remove value sets, or if the value sets themselves have been updated, you may wish to update the valueset-db.json with the latest codes.  To do this, you will need a [UMLS Terminology Services account](https://uts.nlm.nih.gov//license.html).
+
+To update the `valueset-db.json` file:
+
+1. Run `node src/utils/updateValueSetDB.js UMLS_API_KEY` _(replacing UMLS\_API\_KEY with your actual UMLS API key)_
+
+To get you UMLS API Key:
+
+1. Sign into your UMLS account at [https://uts.nlm.nih.gov/uts.html](https://uts.nlm.nih.gov/uts.html)
+2. Click 'My Profile' in the orange banner at the top of the screen
+3. Your API key should be listed below your username in the table
+4. If no API key is listed:
+   1. Click 'Edit Profile'
+   2. Select the 'Generate new API Key' checkbox
+   3. Click 'Save Profile'
+   4. Your new API key should now be listed.
+
+### To update the test patients' date-based fields
+
+Testing this SMART App is more meaningful when we can supply test patients that exercise various aspects of the application.  Test patients are represented as FHIR bundles at `src/utils/dstu2_test_patients` and `r4_test_patients`.  Since the CDS uses lookbacks (for example, only show MME in the last 6 months), the patient data occasionally needs to be updated to fit within the lookback windows. To automatically update the data to fit within the lookback windows as of today's date:
+
+1. Run `yarn update-test-patients`
+
+This will update all of the entries in the patient bundles to be appropriate relative to today's date. In addition, it sets each bundle's `meta.lastUpdated` to the current date. This is essential for ensuring that future updates work correctly since it uses the `meta.lastUpdated` date to determine how far back each other date should be relative to today.
 
 ### To run the unit tests
 

default.env

@@ -2,7 +2,6 @@
 PORT=8000
 REACT_APP_EPIC_SUPPORTED_QUERIES=false
 
-
 # confidential backend API endpoint
 # NB: domain is required for cookies to be set
 REACT_APP_CONF_API_URL=http://localtest.me:5000
@@ -18,5 +17,3 @@ USE_DEMO=false
 
 #url for patient search
 REACT_APP_DASHBOARD_URL:http://localtest.me:5000
-
-

index.html

@@ -0,0 +1,21 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <!-- Use Internet Explorer Edge Standards mode -->
+    <meta http-equiv="x-ua-compatible" content="IE=edge" >
+    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+    <meta name="theme-color" content="#000000">
+    <link rel="manifest" href="/manifest.json">
+    <link rel="shortcut icon" href="/favicon.ico">
+    <title>Pain Management Summary</title>
+  </head>
+
+  <body>
+    <noscript>
+      You need to enable JavaScript to run this app.
+    </noscript>
+    <div id="root"></div>
+    <script type="module" src="/src/index.jsx"></script>
+  </body>
+</html>

launch.html

@@ -0,0 +1,22 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <!-- Use Internet Explorer Edge Standards mode -->
+    <meta http-equiv="x-ua-compatible" content="IE=edge" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1, shrink-to-fit=no"
+    />
+    <meta name="theme-color" content="#000000" />
+    <link rel="manifest" href="/manifest.json" />
+    <link rel="shortcut icon" href="/favicon.ico" />
+    <title>Pain Management Summary</title>
+  </head>
+
+  <body>
+    <noscript> You need to enable JavaScript to run this app. </noscript>
+    <div id="root"></div>
+    <script type="module" src="/src/launch.js"></script>
+  </body>
+</html>