Collect data

[lmd59]

Summary

Adds support for a basic $collect-data according to the STU5 definition

New behavior

Supports $collect-data parameters periodStart, periodEnd, measureId, and subject. Does not support all STU5 parameters or alternative parameters/requirements in the latestBuild

Code changes

• Update premadeBundle upload default
• Add routes to app.js
• Add main collectData endpoint handling and validation to export service
• Create collectDataUtils for utilities: patient bundle and measure report creation, finding patient resources, creating typeFilters based on effective data requirements
• Small update to exportToNDJson.js to increase robustness
• Small updates to serviceUtils to handle gathering parameter input
• Testing: Add and update fixtures and unit testing of $collect-data operation in export.service.test.js

Testing guidance

• npm run check
• Add ecqm-content-qicore-2025 bundles to your bulk-export-server directory (will be used instead of 2021 bundles)
• npm run upload-bundles (should load new default 2025 bundles)
• npm run start
• Run POST (or GET w/ URL parameters) to http://localhost:3000/Measure/$collect-data with

{
  "resourceType": "Parameters",
  "parameter": [
    {"name": "periodStart",
		 "valueDate": "2025-01-01"
		},
    {"name": "periodEnd",
		 "valueDate": "2025-12-31"
		},
		{
      "name": "measureId",
			"valueId": "CMS125FHIRBreastCancerScreening"
    },
		{
      "name": "measureId",
			"valueId": "CMS133FHIRCataracts2040BCVAwithin90Days"
    },
    {
      "name": "subject",
      "valueString": "Patient/62ea0c3d-46da-48a1-87dd-d1927ed2df75"
    }
  ]
}

• Experiment with other inputs, but see CollectDataBrainstorming document for caveats and potential follow-up actions (bottom of document) that would make this implementation more complete

[github-actions]

Coverage report

St.❔	Category	Percentage	Covered / Total
🟡	Statements	76.7% (+2.75% 🔼)	701/914
🟡	Branches	67.34% (+4.47% 🔼)	268/398
🟡	Functions	75.64% (+4.65% 🔼)	118/156
🟡	Lines	77.02% (+2.71% 🔼)	687/892

Show new covered files 🐣

St.❔	File	Statements	Branches	Functions	Lines
🟢	... / collectDataUtils.js	89.66%	77.78%	100%	90.38%

Test suite run success

103 tests passing in 8 suites.

Report generated by 🧪jest coverage report action from e0adbca

[elsaperelli]

Functionality is looking great!!! Some VERY minor comments :)

[elsaperelli]

One last comment about adding ecqm-content-qicore-2025 to some .ignore files but otherwise it's looking good!!!

[elsaperelli]

Lgtm!!