feat(core-flows,product,types): scoped variant images

[fPolic]

What

This PR introduces the ability to associate product images with specific product variants, enabling more granular image management for products with multiple variants.

Scoped Image Management: Images can now be associated with specific variants instead of being global to the product
Bulk Operations: Batch add/remove variant associations for efficient management

---

API Changes

• POST /admin/products/:id/variants/:variant_id/images/batch - Batch manage image associations for a variant
• POST /admin/products/:id/images/:image_id/variants/batch - Batch manage variant associations for an image

Product Module Changes

1. Data model:

• ProductVariant model now includes images many-to-many relationship
• ProductImage model now includes variants many-to-many relationship
• ProductVariantProductImage pivot entity for managing associations
• ProductVariant now has thumbnail

2. Service methods:

• addImageToVariant() - Associate images with specific variants
• removeImageFromVariant() - Remove image-variant associations
• getVariantImages() - Retrieve images for variants - (general product images + variant specific images)

Core Flows Changes

• variant thumbnail will be used for the line item thumbnail if exists

---

CLOSES CORE-1214
CLOSES CORE-1215
CLOSES CORE-1216

---

Related PRs:

• feat(dashboard): variant images management UI #13670
• feat(product): build variant images when retrieving product #13731

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
api-reference	Building	Preview	Comment	Oct 14, 2025 1:34pm

7 Skipped Deployments

Project	Deployment	Preview	Comments	Updated (UTC)
api-reference-v2	Ignored	Preview		Oct 14, 2025 1:34pm
cloud-docs	Ignored	Preview		Oct 14, 2025 1:34pm
docs-ui	Ignored	Preview		Oct 14, 2025 1:34pm
docs-v2	Ignored	Preview		Oct 14, 2025 1:34pm
medusa-docs	Ignored	Preview		Oct 14, 2025 1:34pm
resources-docs	Ignored	Preview		Oct 14, 2025 1:34pm
user-guide	Ignored	Preview		Oct 14, 2025 1:34pm

[changeset-bot]

⚠️ No Changeset found

Latest commit: 57fd253

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR