Expose operation

[elsaperelli]

Summary

This PR exposes the $approve operation as an endpoint on the server. This functionality is defined in the CRMI IG here.

New behavior

The user can now approve a Measure or Library artifact and any resources it is composed of regardless of status by sending a GET or POST request to Measure/$approve, Measure/:id/$approve, Library/$approve and Library/:id/$approve. This operation takes three optional parameters: approvalDate, artifactAssessmentType, and artifactAssessmentSummary. If artifactAssessmentType and artifactAssessmentSummary are both provided, then a cqf-artifactComment extension will be added to the artifact and any of its children. If approvalDate is provided, the approvalDate is set, if not, it is set to the system. The date is also set to the system date. Since this is only an operation supported in an Authoring Artifact Repository, the AUTHORING environment variable must be set to true.

Code changes

• service/README.md - add description of $approve
• service/src/config/capabilityStatementResources.json - add crmi-approve
• service/src/config/serverConfig.ts - add approve endpoints
• service/src/db/dbOperations.ts - add batchUpdate function
• service/src/requestSchemas - add id and type and summary checks and ApproveArgs for type checking
• service/src/services/LibraryService.ts / service/src/services/MeasureService.ts - add approve function
• service/src/util/inputUtils.ts - add valueCode to gatherParams
• service/test/services/LibraryService.test.ts / service/test/services/MeasureService.test.ts - added unit tests

Testing guidance

• npm run build:all
• npm run check:all
• In service, reset the database (npm run db:reset) and test with the nested child artifact bundle I made and may connectathon bundles (attached example Insomnia requests are for use with the created nested artifact bundle
• npm run start:all
• Go through example Insomnia requests. Make sure date and approvalDate are changed/added, extension is added if artifactAssessmentSummary AND artifactAssessmentType are included as input parameters, etc.

approve-testing.json

[lmd59]

Functionality looks pretty good! A couple of small change recommendations!

[lmd59]

nice updates!