v2.12.1

medusajs/medusav2.12.1Dec 3, 2025by olivermrbl

AI Summary

This release addresses a critical regression in the events system where server instances were incorrectly skipping event emission. It also includes a database migration to add a composite unique index on order items.

Key Highlights

Fixes regression in events system for server mode instances
Adds composite unique index on order_item version and item_id
Requires running npx medusa db:migrate after upgrade

Full Release Notes

## Highlights

This release fixes a regression in the events system introduced in https://github.com/medusajs/medusa/pull/14084. That PR added an optimization to emit events only when at least one subscriber is registered for the event.

However, this unintentionally broke instances running in `server` mode. Historically, server instances have not registered subscribers, only worker instances have. With the new optimization, these instances incorrectly determined that no subscribers existed for all emitted events and therefore skipped emission entirely.

**As a result, applications running version 2.12.0 in server mode have effectively emitted no events.**

If you have already upgraded to 2.12.0 and are using server instances, we strongly recommend validating whether any critical events have been missed since the upgrade and, if necessary, processing them manually.

This release also contains a migration, so you need to run the migration script after upgrading:
```
npx medusa db:migrate
```

## Bugs
* fix(order): Add composite unique index on order_item version:item_id by @NicolasGorga in https://github.com/medusajs/medusa/pull/14164
* fix(): event emitting by @adrien2p in https://github.com/medusajs/medusa/pull/14196

## Documentation
* docs: docs for next release by @shahednasser in https://github.com/medusajs/medusa/pull/14110
* chore(docs): Generated DML JSON files (automated) by @github-actions[bot] in https://github.com/medusajs/medusa/pull/14180
* chore(docs): Updated UI Reference (automated) by @github-actions[bot] in https://github.com/medusajs/medusa/pull/14181
* chore(docs): Generated References (automated) by @github-actions[bot] in https://github.com/medusajs/medusa/pull/14182
* docs: generate API reference for 2.12.0 by @shahednasser in https://github.com/medusajs/medusa/pull/14185
* docs: strapi integration guide by @shahednasser in https://github.com/medusajs/medusa/pull/14075
* docs: track code copy + AI assistant event by @shahednasser in https://github.com/medusajs/medusa/pull/14193
* docs: improve CORS troubleshooting guide by @shahednasser in https://github.com/medusajs/medusa/pull/14194

## Chores
* chore(docs): Update version in documentation (automated) by @github-actions[bot] in https://github.com/medusajs/medusa/pull/14179
* chore: fixes to TSDocs by @shahednasser in https://github.com/medusajs/medusa/pull/14186


**Full Changelog**: https://github.com/medusajs/medusa/compare/v2.12.0...v2.12.1