medplum

Woohoo, Medplum 3.0! 🎉

This is a major release due to breaking API changes. But do not fear, these changes are not as scary as they may sound. This major version bump is largely due to breaking changes in our dependencies.

1. Node.js 20! Version 20 is the current "Active" release, so it is now the Medplum default. We have run Node.js 20 in our staging and test environments for nearly 6 months, with only positive performance improvements.
2. Mantine 7! For UI components and the Medplum App, we now use Mantine 7 which drops Emotion in favor of native CSS. This yields performance benefits, better theming support, and better SSR support (for example, in Next.js applications).
3. Updated FHIR type definitions with required fields. In the past, all fields in the Medplum FHIR type definitions were marked as "optional". The original motivation was to make it easier for "builder pattern". We're now aligning with @types/fhir in using required field for required FHIR properties.
4. Updated default MedplumClient cacheTime logic. Before, the default cacheTime was 60 seconds. Now, the default cacheTime is 60 seconds in browser environments (typeof window !== 'undefined'), but the default in Node.js environments is 0.

Required fields in FHIR type definitions
Fixes #3724 - change MedplumClient default cache time
Mantine 7
Fixes #3117 - more details in CLI error messages (#3729)
Fixes #3548 - added ClientApplication.status (#3728)
Fixes #3453 - custom metrics for bot executions (#3727)
Document priority-order search parameter (#3721)
Fixes #3412 - cli command to update Parameter Store config (#3725)
bug: Prevent isRegisterEnabled optimization (#3723)
Server update CLI (#3087)
CodeSystem import operation (#3589)

New resource diff page (#3387)
Update team page (#3386)
Add exception handling for invalid /authorize url (#3352)
Fixes #3367 - health gorilla fixes (#3385)
Fixed id property type in ResourcePRopertyDisplay (#3384)
fix(types): export IExpoClientStorage (#3383)
Fixes #3368 - code sign agent and agent installer (#3381)

Fixes #3370 - revert .d.cts and .d.mts file extensions (#3377)

feat(config): expose db ssl config (#3354)
Fixes #3370 - add back explicit types in package.json (#3371)
Add links to docs (#3361)
Fixed - Project specific reset password (#3351)
default strict mode on super admin project (#3364)
Update vercel.json for docs and app (#3358)
Fix bug in deepIncludes (#3349)
Update package.json scripts (#3345)

Update all projects to use api-extractor for type definitions (#3347)

Dual build type definitions for CJS/ESM (#3342)

More Health Gorilla docs (#3333)
Tighter input validation on security endpoints (#3334)
Use react-jsx transform (#3338)
Create documentation for chained search (#3312)
Document performing insurance eligibility checks (#3280)
feat(expo): add ExpoClientStorage for persisted store in RN (#3307)
test(server): add test.config.json with port 8104 (#3329)
Make Postgres version configurable in CDK (#3327)
Configure agent service name and automatic start (#3321)
Link authentication methods to relevant Medplum Client functions (#3323)
server centralize request validation for co-location and reduced redundancy (#3228)
Fixed FHIR link (#3319)

Publishing version 2.1.13 failed due to Github Actions error. Publishing again as 2.1.14.

Fixes #3269 - use shawl for agent service admin (#3314)
fix request logging middleware status code reporting (#3316)
Docusaurus 3 (#3311)
Redirect to next from signin page if already authenticated (#3294)
Ensure trailing slash on external auth signin page (#3306)
Fix Admin Users doc page title (#3299)
Document setting up Google auth for Medplum App (#3302)
Update domain level idp docs (#3298)
Added separate scripts for 'build' and 'build:all' (#3303)
Dependency upgrades (#3285)
Make @medplum/core a module (#3263)
feat(client/fhircast): add fhircastGetContext (#3292)
Add some margin to ResourceArrayInput and make it flex-based (#3295)
Don't show copy button for ID if empty/missing (#3297)
Add link to Tasks guide for charting demo README (#3288)
Show language and text when nested (#3296)
Fixed projects guide link (#3281)
Fix highlighting of default tab (#3293)
Remove option for 1 AZ in AWS setup (#3283)

chore(actions): add console output for prettier-fmt Actions workflow (#3278)
feat(auth/external): make PKCE on external auth optional (#3279)
server/fhir/repo execute independent io concurrently (#3227)
MeasureReportDisplay (#3242)
Create documentation on creating test data using batches (#3247)
Clarify project admin vs. Super admin (#3267)
feat(fhircast): add FHIRcast OAuth 2.0 scopes (#3274)
Adding Health Gorilla setup documentation and samples (#3250)
fix-3238 gracefully shutdown server (#3239)

Self-hosting notes:

• https://github.com/medplum/medplum/pull/3243
  • This adds optional support for PKCE to the Medplum External Auth feature
  • To be able to use this feature, a super admin must rebuild structure definitions and rebuild value sets
• https://github.com/medplum/medplum/pull/3201
  • This fixes the :missing operator on reference search parameters and Reference.identifier values
  • All new data will be indexed automatically
  • To reindex old data, a super admin must reindex the resource type

fix(react-native-example): get login working on mobile (#2780)
Document "Security Best Practices" for Auth (#3249)
Updated Health Gorilla demo to use organization references (#3264)
Convert @medplum/react into a module (#3259)
Make request logging optional (#3261)
Update Health Gorilla demo bot to support multiple Coverages (#3262)
Document modeling why a communication was started with reasonCode (#3236)
Added example test of patients already being merged (#3260)
Added Health Gorilla ABN check (#3257)
Added redirects for common search landing pages (#3256)
Fix broken links identified by Ahrefs (#3255)
Fix :missing modifier for token search params (#3218)
Add VSCode setting to disable eslint fixAll on save (#3248)
fix(fhircast): lower -> mixed, eg. patient-open -> Patient-open (#3237)
Update generator step to run baseschema generator (#3245)
Move Coveralls to separate Github Action (#3246)
feat(fhircast): add context.priorVersionId to DiagnosticReport-update (#3232)
HMR app on react changes (#3229)
Log more details on external auth failure (#3244)
Fixes #2703 - document agent system requirements (#3241)
Make PKCE optional for external auth providers (#3243)
Fixes #2892 - Use Mantine components for field editor (#3234)
Added AOE QuestionnaireResponse to Health Gorilla example (#3230)
Fixed prettier errors (#3231)
Fixes #3215 - external auth fixes for Azure SSO (#3226)
Middleware to log necessary data for every request. (#3196)
Replace typedoc with api-documenter (#3172)
feat(client/fhircast): add DiagnosticReport-{update,select} events (#3212)
Typo (#3223)
Fixes 2890 (#3220)
Support custom creation paths (#3214)
Suppress warnings from system repo (#3208)
Fix "Id" capitolization issue in field selector (#3210)
Adjust limit for chained searches (#3206)
Fixes #3203 - check references on write with access policy (#3207)
Add documentation on resource history (#3182)
Fixed api-extractor warnings (#3205)
Add placeholder value for identifier references (#3201)
Implement search chaining (#3166)
Updated Health Gorilla example with Account, Coverage, RelatedPerson (#3202)
feat(server/fhircast): add versioning of DiagnosticReport-open (#3193)
Show display for empty answer selection (#3192)
feat(fhircast): add support for GetCurrentContext (#3181)
Update Next Example project to use App Router (#3197)
feat: Pass resource to Repository logEvent on error (#3195)
Add documentation for FHIR batch requests (#3175)
Fix NPE in reference validation logic (#3186)
Add example of how to use optional --base-url flag (#3187)
Add to folder structure (#3180)
Unique Names for Add Group Button (#3191)
Fixed warnings in publish action (#3165)
Clarify the Medplum Project Model (#3179)
Move to separate file (#3178)
Add support for reference type (#3167)
Markdown fixes for Docusaurus 3 (#3171)
Updating integrations page with refreshed content (#3173)
Index medplum-resource search params in example bots (#3164)
Add params to MultiSelect for display in modal (#3174)
test(client/fhircast): multiple of same key on diagnosticreport-open (#3168)
Blog Post: Digital Health Operations (#3156)
Fixed add-to-project version string (#3162)
Add sort-package-json tool (#3161)
Adding links from "User Admin Guide" to the '/invite' API (#3158)
docs(config): add docs for external secrets (#3157)
Adding links from "User Admin Guide" to the '/invite' API
Refactor QuestionnaireForm (#3109)
feat(client/fhircast): add support for STU3 events (#3143)
Health Gorilla diagnosis codes, specimen datetiem, and order notes (#3155)
Require hyphen after @param jsdoc (#3154)

Fixes #1593 - use api-extractor for type definitions (#3152)
Reference implementation of the unmerge operation (#3139)

Remove all references to Mantine from react-hooks (#3147)
Bump crypto-js from 4.1.1 to 4.2.0 (#3140)
Fixes #3129 Fixes #3130 - health gorilla connection test bot (#3136)
Fixes #3118 - better upload error UX (#3125)
Fix CLI tests (#3122)
feat(cdk): add initial support for external secrets (#3080)
Split out @medplum/react-hooks package (#3116)

Fixes #3063 Fixes #3106 - pushToAgent update and docs (#3111)
Fixes #3107 - Use correct CloudFormation region check (#3113)
Fixes #3108 - change default storage bucket name (#3112)
Fix app flash on token refresh (#3104)
Check required fields in questionnaire form (#3100)
Save Health Gorilla requisition and results PDFs (#3105)
Fixes #1271 - re-enable PDF preview (#3101)

MedplumClient updates for Health Gorilla (#3098)
Update README.md (#3094)
Fixed apps page when user does not have access to ClientApplication (#3095)
Fixes #3081 - always show 'Add' button in filter editor (#3093)
Fixes #3088 - undefined Reference.reference in graphql (#3091)
Fixes #3083 - use ETag weak validator prefix (#3092)
Agent push update (#3085)
Add documentation for advanced search parameters (#3030)
Added docs on update-bucket-policies tool (#3089)
New migration generator proof-of-concept (#3015)
Fixes #3071 - useSearch hooks (#3073)
Clarify authentication Docs (#3074)

Add documentation about resource profiles (#3068)
Use helper function for stringifying OutcomeError message (#3082)
Fixes #3077 - correct valueCoding in QuestionnaireForm (#3079)
Add expression (path) to OutcomeError message display (#3078)
Fixed Typo and Grammer (#3076)
fix(tesh.sh): add shebang for test.sh (#3075)
Add MedicationRequest and README Changes (#3064)
fix(build): put placeholder env vars in build step (#3070)
fix(client/auth): respect accessToken in constructor (#3066)
Fixes #3069 - docs import warning (#3072)
Added 'Diagnoses' and 'Billing' to Health Gorilla order form (#3062)
Updating document to 2023 version (#3067)
Updating test plan in relation to #2794 (#3061)
Fixes #3027 - added re operator for _filter (#3060)
Fixes #3057 - set Location header on create (#3059)
Updates to SOAP Note and tasks (#3053)
fix: update location of QuestionnaireForm.stories.tsx (#3056)
Update README.md (#3058)
Added DangerJS (#3043)
Reorganize auth docs (#3029)
Add valueset for allergies (#3052)
Fixes #3047 - fix _filter ne operator (#3054)
Fixes #3050 - project admins reading project-scoped users (#3051)
Fixed Typo and Grammar (#3042)
fix(websocket): handle invalid WS conns gracefully (#3049)
Fixes #3045 - expose require in VM context bots (#3046)
Fixes #2942 - handle observation cycles in DiagnosticReportDisplay (#3044)
Fix react fast refresh warnings (#3041)
Fixes #389 - rename validate to validateResource (#3039)
Dependency upgrades (#3040)

feat(client): add fhircast{Publish, Subscribe, Connect} (#3024)
Client Chart Example (#2999)
Fixes #3032 - send slack message on deploy and publish (#3034)
Fix primitive extensions on choice types (#3033)
Add documentation for representing prescriptions and medication orders (#2807)
Test against multiple Postgres versions (#3026)
Handle search on numeric array columns (#3022)
Health Gorilla order form update (#3023)
Updated compliance logos (#3021)
Merge schema/validation systems (#2859)
feat(server/bullmq): remove all finalized jobs by default (#3014)
Remove barrel files (#3016)
Fixes #2955 - aws lambda client retry policy (#2986)
Filter ClientApplication resources in Apps tab (#3013)
feat(fhircast-demo): add auth story to demo (#2997)
Fixes #2987 Fixes #2988 - use HumanName.text (#2989)
Fixes #2984 - handle invalid UUID in _id search param (#2985)
Update Health Gorilla demo to order multiple tests (#2980)
Fixes #1307 Fixes #2963 Fixes #2969 - binary data docs (#2982)
Gracefully error on invalid JWT in client assertion flow (#2983)
Refresh session profile if not present in client (#2978)
replacing bookmark name string #2979 (#2981)
Limit SQL subqueries for existence checking (#2976)
QuestionnaireForm style tweaks (#2975)
DiagnosticReportDisplay - only show specimen data if present (#2974)
Add FHIRcast client example (#2965)
Fixes #2971 - update Questionnaire reference inputs (#2973)

Initial FHIRCast setup (#2964)
Added setIdentifier helper (#2961)
Real world testing plan, fixes #2794 (#2962)
Evaluate X-Fhir-Query helper (#2950)
Updated Health Gorilla callback bot (#2960)
Fixes #2112 - custom password reset emails (#2954)

Ignore unrecognized references in convertToTransactionBundle (#2951)
CLI tools to send and receive HL7 messages (#2949)
Use --client-id and --client-secret in bot commands (#2948)

Fixes #2901 - cli command to update s3 bucket policies (#2924)
Bot cli fixes (#2935)
Dynamically move items in QuestionnaireBuilder (#2883)
publish changes (#2927)
Update contributing docs (#2897)
Fixes #2898 - export CDK types (#2905)
Update sweep.yaml (#2920)
Split tsquery handling by language config (#2885)
Add stack traces back to error logs (#2918)
Fixes #2899 - agent push (#2900)
Add request IDs to error responses (#2907)
Create documentation for the Apps Tab (#2873)
Clarify that paginated search requires a _sort for consistency (#2913)
Added docs on the "Communication Lifecycle" (#2912)
Bump graphql from 16.8.0 to 16.8.1 (#2903)
Fixes #2891k - ID capitalization (#2902)
Add Value Set Autocomplete to Kitchen Sink (#2896)
Added reference resolution to PATCH batch entries (#2884)
Fixes #2876 - CDK creates awsRegion parameter (#2879)
Bind async callbacks to context local storage (#2875)
Clarification on per-server vs. per-project users (#2881)
Fixes #2847 - Create new resources from JSON input (#2870)
Fixes ElementDefinition.contentReference in deep nested backbone element (#2868)
Bind AsyncLocalStorage to cursor callbacks (#2874)
Use getElementDefinitionTypeName (#2869)
Fix bug on page sequence input changes (#2865)
Updating SOC2 report link to 2023 version (#2872)
Update Patient Dedupe Docs (#2760)
Fix CLI docs headings (#2867)
Monitoring bots documentation (#2782)
Updating bots based on feedback and correcting for use of deprecated fields (#2866)
Remove unnecessary generics (#2864)
Create docs for promoting a user to admin (#2757)
Fixes #2792 - multiple patient compartments in resource (#2862)
Fix 'sign-in' vs 'sign in' in invite email (#2861)
Fixes #2796 - copy binary content in project clone (#2858)
Dependency upgrades (#2857)