medusa-store/.changeset/dry-geckos-act.md at f764b3a36471a0ad9e9e05f125183464680e3a2d

0 Fork 0

Files

T

Carlos R. L. Rodrigues e413cfefc2 feat(utils): define file config (#13283 )

** What
 - Allow auto-loaded Medusa files to export a config object.
 - Currently supports isDisabled to control loading.
 - new instance `FeatureFlag` exported by `@medusajs/framework/utils`
 - `feature-flags` is now a supported folder for medusa projects, modules, providers and plugins. They will be loaded and added to `FeatureFlag`

** Why
 - Enables conditional loading of routes, migrations, jobs, subscribers, workflows, and other files based on feature flags.

```ts
// /src/feature-flags

import { FlagSettings } from "@medusajs/framework/feature-flags"

const CustomFeatureFlag: FlagSettings = {
  key: "custom_feature",
  default_val: false,
  env_key: "FF_MY_CUSTOM_FEATURE",
  description: "Enable xyz",
}

export default CustomFeatureFlag
```

```ts
// /src/modules/my-custom-module/migration/Migration20250822135845.ts

import { FeatureFlag } from "@medusajs/framework/utils"

export class Migration20250822135845 extends Migration {
  override async up(){ }
  override async down(){ }
}

defineFileConfig({
  isDisabled: () => !FeatureFlag.isFeatureEnabled("custom_feature")
})
```

2025-08-26 12:22:30 +00:00

290 B

Raw Blame History

@medusajs/modules-sdk, @medusajs/framework, @medusajs/types, @medusajs/utils, @medusajs/medusa, @medusajs/test-utils, @medusajs/workflows-sdk, @medusajs/cli

@medusajs/modules-sdk	@medusajs/framework	@medusajs/types	@medusajs/utils	@medusajs/medusa	@medusajs/test-utils	@medusajs/workflows-sdk	@medusajs/cli
patch	patch	patch	patch	patch	patch	patch	patch

feat: define file config and improved feature flag support

290 B Raw Blame History

290 B

Raw Blame History