Impact Score: 5/10
Medusa: v2.12.5: Fix build-process regression
Source available β automated, not human-reviewed
Component: medusajs Β· Channel: stable. Automated analysis, not a compatibility certification. How this works.
Analysis updated: 2026-11-01.
β‘ Executive Summary (TL;DR)
Medusa v2.12.5. Source highlight: Fixes regression with link migrations
Who Does This Impact? (Role-Based Analysis)
π» Software Engineers & Devs
Check the source notes against the package and APIs you use before upgrading.
π Product & Engineering Leads
Use the documented changes to assess relevance to your product; release frequency alone is not a quality measure.
βοΈ DevOps & Security
Verify the target version, runtime requirements and rollback procedure in the official documentation.
β¨ New Features & Capabilities (2)
- feat(rbac): role-based access control module
- feat(): Add modules options autocomplete to medusa config
π§ Bug Fixes & Patches (2)
- feat(medusa-app): Link initialization should respect migrationOnly flag
- docs: fix locale option passed to query
π View Raw Release Notes (Original Developer Log)
<!--

# v2.12.5: Fix regression in build-process
This release fixes a regression in the build-process introduced as part of improving the developer experience around Medusa's autogenerated types.
CMS_BREAK -->
## Highlights
### Fixes regression with link migrations
This release fixes a regression in type generation during builds that could cause build failures under certain conditions. In [PR #14493](https://github.com/medusajs/medusa/pull/14493), we updated the build process to generate Medusaβs autogenerated types at build time, ensuring they are available both during development and in production.
This change introduced an unintended issue in the build process. Generating types during the build requires bootstrapping the application. During bootstrap, several core internal loaders are executed, including those responsible for establishing database connections. These loaders depend on specific environment variables, and when those variables are not present, the build fails.
This release changes the types generation to rely on a βlightweightβ bootstrap mode , which allows the application to start without executing these core internal loaders, avoiding the dependency on environment variables during the build phase.
## Features
* feat(rbac): role-based access control module by @carlos-r-l-rodrigues in https://github.com/medusajs/medusa/pull/14310
* feat(): Add modules options autocomplete to medusa config by @adrien2p in https://github.com/medusajs/medusa/pull/14465
## Bugs
* feat(medusa-app): Link initialization should respect migrationOnly flag by @adrien2p in https://github.com/medusajs/medusa/pull/14493
## Documentation
* docs: docs for next release by @shahednasser in https://github.com/medusajs/medusa/pull/14456
* chore(docs): Updated UI Reference (automated) by @github-actions[bot] in https://github.com/medusajs/medusa/pull/14469
* docs: fix locale option passed to query by @shahednasser in https://github.com/medusajs/medusa/pull/14472
* chore(docs): Updated API Reference (automated) by @github-actions[bot] in https://github.com/medusajs/medusa/pull/14470
* chore(docs): Generated References (automated) by @github-actions[bot] in https://github.com/medusajs/medusa/pull/14471
* docs: auth in cloud + restructure deployment guides by @shahednasser in https://github.com/medusajs/medusa/pull/14457
* chore(rbac): user link and utils by @carlos-r-l-rodrigues in https://github.com/medusajs/medusa/pull/14320
* docs: updates for storefront in cloud by @shahednasser in https://github.com/medusajs/medusa/pull/14491
## Chores
* chore(docs): Generated DML JSON files (automated) by @github-actions[bot] in https://github.com/medusajs/medusa/pull/14467
* chore(docs): Update version in documentation (automated) by @github-actions[bot] in https://github.com/medusajs/medusa/pull/14468
**Full Changelog**: https://github.com/medusajs/medusa/compare/v2.12.4...v2.12.5