v2.8.6

medusajs/medusav2.8.6Jun 30, 2025by olivermrbl

AI Summary

This release strengthens the workflow engine's data flow by compiling data from Redis and Postgres on resume and improves payment account holder compensation flows.

Key Highlights

  • Strengthen workflow engine by compiling workflow data from Redis and Postgres on resume.
  • Improve payment account holder flows to only delete holders created during the workflow.
  • Fix onScroll in Select.Content component.

New Features

  • Workflow engine data management improvements.
  • Compensation logic improvements for payment account holders.

Full Release Notes

<!-- 
![2-8-6](https://gh-release-images.s3.eu-north-1.amazonaws.com/v2-8-6.png)

# v2.8.6: Strengthened workflow engine and improved account holder management

This release improves the workflow engine's data management and payment account holder flows.

CMS_BREAK -->

## Highlights

### Strengthen the workflow engine

This release improves the workflow engine's data flow. When resuming workflows, we now compile workflow data (i.e. input and outputs of previous steps) from Redis and Postgres to ensure the most recent workflow execution and associated data are used.

### Improve payment account holder flows

This release improves how payment account holders are managed when creating payment sessions in the `createPaymentSessionWorkflow`. In this workflow, we create a new payment account holder for the customer on the cart if it doesn't already exist. When the workflow fails in a later step, the compensation flow is triggered, and we now ensure we are only deleting the account holder if it was created as part of the invoke, i.e. it didn't exist before running the workflow.

## Bugs
* fix: do not apply prefix when getting file contents as buffer or stream by @thetutlage in https://github.com/medusajs/medusa/pull/12831
* fix(core-flows,workflows-sdk): compensate account holders only when its created by @riqwan in https://github.com/medusajs/medusa/pull/12825
* fix(): test utils events + workflow storage by @adrien2p in https://github.com/medusajs/medusa/pull/12834
* fix: fix onScroll in Select.Content by @peterlgh7 in #12855

## Documentation
* docs: documentation changes for next release by @shahednasser in https://github.com/medusajs/medusa/pull/12773
* doc: Updated cloudflare R2 description by @scherddel in https://github.com/medusajs/medusa/pull/12598
* docs: added first-purchase promotion guide by @shahednasser in https://github.com/medusajs/medusa/pull/12828
* docs: update OAS for loyalty plugin by @shahednasser in https://github.com/medusajs/medusa/pull/12836
* docs: remove usages of ts-ignore in examples by @shahednasser in https://github.com/medusajs/medusa/pull/12839
* docs: fix step detection of useQueryGraphStep by @shahednasser in https://github.com/medusajs/medusa/pull/12842
* docs: small typo fix by @shahednasser in https://github.com/medusajs/medusa/pull/12843
* docs: documet withDeleted by @shahednasser in https://github.com/medusajs/medusa/pull/12841
* docs: design fixes to toc and related elements by @shahednasser in https://github.com/medusajs/medusa/pull/12747
* docs: added gift message guide by @shahednasser in https://github.com/medusajs/medusa/pull/12833
* docs: sort events in reference alphabetically by @shahednasser in https://github.com/medusajs/medusa/pull/12845
* docs-util: throw when schema parsing fails by @shahednasser in https://github.com/medusajs/medusa/pull/12846
* docs: remove empty storefront guides by @shahednasser in https://github.com/medusajs/medusa/pull/12844
* docs: add build with AI & LLMs doc by @shahednasser in https://github.com/medusajs/medusa/pull/12848
* docs: document tax-inclusive promotions concept by @shahednasser in https://github.com/medusajs/medusa/pull/12849

## Chores
* chore: add version and deprecated tags to import routes and methods by @shahednasser in https://github.com/medusajs/medusa/pull/12829
* chore: add missing types in TSDocs example by @shahednasser in https://github.com/medusajs/medusa/pull/12835
* chore: improve description of findOrCreateCustomerStep by @shahednasser in https://github.com/medusajs/medusa/pull/12840

## Other Changes
* feat: Admin translation update for czech language by @redeyecz in https://github.com/medusajs/medusa/pull/12837

## New Contributors
* @scherddel made their first contribution in https://github.com/medusajs/medusa/pull/12598
* @redeyecz made their first contribution in https://github.com/medusajs/medusa/pull/12837

**Full Changelog**: https://github.com/medusajs/medusa/compare/v2.8.5...v2.8.6