chore: add missing since and featureFlag tags (#13926)

packages/cli/oas/medusa-oas-cli/redocly/redocly-config.yaml

@@ -149,6 +149,9 @@ decorators:
         - StoreGiftCardInvitation
       StoreTransactionGroup:
         - StoreStoreCreditAccount
+      AdminProductImage:
+        - AdminProduct
+        - AdminProductVariant
 theme:
   openapi:
     theme:

packages/core/core-flows/src/product/steps/add-image-to-variants.ts

@@ -7,6 +7,8 @@ export const addImageToVariantsStepId = "add-image-to-variants"
 /**
  * This step adds an image to one or more product variants.
  * 
+ * @since 2.11.2
+ *
  * @example
  * const data = addImageToVariantsStep({
  *   image_id: "img_123",

packages/core/core-flows/src/product/steps/add-images-to-variant.ts

@@ -7,6 +7,8 @@ export const addImagesToVariantStepId = "add-images-to-variant"
 /**
  * This step adds one or more images to a product variant.
  * 
+ * @since 2.11.2
+ *
  * @example
  * const data = addImagesToVariantStep({
  *   variant_id: "variant_123",

packages/core/core-flows/src/product/steps/remove-image-from-variants.ts

@@ -7,6 +7,8 @@ export const removeImageFromVariantsStepId = "remove-image-from-variants"
 /**
  * This step removes an image from one or more product variants.
  *
+ * @since 2.11.2
+ *
  * @example
  * const data = removeImageFromVariantsStep({
  *   image_id: "img_123",

packages/core/core-flows/src/product/steps/remove-images-from-variant.ts

@@ -7,6 +7,8 @@ export const removeImagesFromVariantStepId = "remove-images-from-variant"
 /**
  * This step removes one or more images from a product variant.
  *
+ * @since 2.11.2
+ *
  * @example
  * const data = removeImagesFromVariantStep({
  *   variant_id: "variant_123",

packages/core/core-flows/src/product/workflows/batch-image-variants.ts

@@ -55,6 +55,8 @@ export const batchImageVariantsWorkflowId = "batch-image-variants"
  * You can use this workflow within your own customizations or custom workflows to manage image-variant associations in bulk.
  * This is also useful when writing a [seed script](https://docs.medusajs.com/learn/fundamentals/custom-cli-scripts/seed-data) or a custom import script.
  *
+ * @since 2.11.2
+ *
  * @example
  * const { result } = await batchImageVariantsWorkflow(container)
  * .run({

packages/core/core-flows/src/product/workflows/batch-variant-images.ts

@@ -55,6 +55,8 @@ export const batchVariantImagesWorkflowId = "batch-variant-images"
  * You can use this workflow within your own customizations or custom workflows to manage variant-image associations in bulk.
  * This is also useful when writing a [seed script](https://docs.medusajs.com/learn/fundamentals/custom-cli-scripts/seed-data) or a custom import script.
  *
+ * @since 2.11.2
+ *
  * @example
  * const { result } = await batchVariantImagesWorkflow(container)
  * .run({

packages/core/js-sdk/src/admin/product.ts

@@ -1081,6 +1081,8 @@ export class Product {
    * [Batch Image Variants](https://docs.medusajs.com/api/admin#products_postproductsidimagesimage_idvariantsbatch)
    * API route.
    * 
+   * @since 2.11.2
+   *
    * @param productId - The product's ID.
    * @param imageId - The image's ID.
    * @param body - The variants to add or remove from the image.
@@ -1117,6 +1119,8 @@ export class Product {
    * [Batch Variant Images](https://docs.medusajs.com/api/admin#products_postproductsidvariantsvariant_idimagesbatch)
    * API route.
    * 
+   * @since 2.11.2
+   *
    * @param productId - The product's ID.
    * @param variantId - The variant's ID.
    * @param body - The images to add or remove from the variant.

packages/medusa/src/api/admin/index/details/route.ts

@@ -4,8 +4,9 @@ import { Modules } from "@medusajs/framework/utils"
 
 /**
  * Get the index information for all entities that are indexed and their sync state
- * @param req
+ * 
- * @param res
+ * @since 2.11.2
+ * @featureFlag index
  */
 export const GET = async (
   req: AuthenticatedMedusaRequest<void>,

packages/medusa/src/api/admin/index/sync/route.ts

@@ -2,6 +2,10 @@ import { AuthenticatedMedusaRequest, MedusaResponse } from "@medusajs/framework"
 import { HttpTypes } from "@medusajs/framework/types"
 import { Modules } from "@medusajs/framework/utils"
 
+/**
+ * @since 2.11.2
+ * @featureFlag index
+ */
 export const POST = async (
   req: AuthenticatedMedusaRequest<HttpTypes.AdminIndexSyncPayload>,
   res: MedusaResponse

packages/medusa/src/api/admin/products/[id]/images/[image_id]/variants/batch/route.ts

@@ -5,6 +5,9 @@ import {
 } from "@medusajs/framework/http"
 import { HttpTypes } from "@medusajs/framework/types"
 
+/**
+ * @since 2.11.2
+ */
 export const POST = async (
   req: AuthenticatedMedusaRequest<HttpTypes.AdminBatchImageVariantRequest>,
   res: MedusaResponse<HttpTypes.AdminBatchImageVariantResponse>

packages/medusa/src/api/admin/products/[id]/variants/[variant_id]/images/batch/route.ts

@@ -5,6 +5,9 @@ import {
 } from "@medusajs/framework/http"
 import { HttpTypes } from "@medusajs/framework/types"
 
+/**
+ * @since 2.11.2
+ */
 export const POST = async (
   req: AuthenticatedMedusaRequest<HttpTypes.AdminBatchVariantImagesRequest>,
   res: MedusaResponse<HttpTypes.AdminBatchVariantImagesResponse>

packages/medusa/src/api/store/product-variants/[id]/route.ts

@@ -17,6 +17,9 @@ type StoreVariantRetrieveRequest =
   StoreRequestWithContext<HttpTypes.StoreProductVariantParams> &
     AuthenticatedMedusaRequest<StoreProductVariantParamsType>
 
+/**
+ * @since 2.11.2
+ */
 export const GET = async (
   req: StoreVariantRetrieveRequest,
   res: MedusaResponse<HttpTypes.StoreProductVariantResponse>

packages/medusa/src/api/store/product-variants/route.ts

@@ -15,6 +15,9 @@ type StoreVariantListRequest =
   StoreRequestWithContext<HttpTypes.StoreProductVariantParams> &
     AuthenticatedMedusaRequest<HttpTypes.StoreProductVariantParams>
 
+/**
+ * @since 2.11.2
+ */
 export const GET = async (
   req: StoreVariantListRequest,
   res: MedusaResponse<HttpTypes.StoreProductVariantListResponse>

packages/modules/product/src/models/product-image.ts

@@ -14,6 +14,9 @@ const ProductImage = model
       product: model.belongsTo(() => Product, {
         mappedBy: "images",
       }),
+      /**
+       * @since 2.11.2
+       */
       variants: model.manyToMany(() => ProductVariant, {
         mappedBy: "images",
         pivotEntity: () => ProductVariantProductImage,

packages/modules/product/src/models/product-variant-product-image.ts

@@ -2,6 +2,9 @@ import { model } from "@medusajs/framework/utils"
 import ProductVariant from "./product-variant"
 import ProductImage from "./product-image"
 
+/**
+ * @since 2.11.2
+ */
 const ProductVariantProductImage = model.define("ProductVariantProductImage", {
   id: model.id({ prefix: "pvpi" }).primaryKey(),
   variant: model.belongsTo(() => ProductVariant, {

packages/modules/product/src/models/product-variant.ts

@@ -22,6 +22,9 @@ const ProductVariant = model
     width: model.number().nullable(),
     metadata: model.json().nullable(),
     variant_rank: model.number().default(0).nullable(),
+    /**
+     * @since 2.11.2
+     */
     thumbnail: model.text().nullable(),
     product: model
       .belongsTo(() => Product, {
@@ -29,6 +32,9 @@ const ProductVariant = model
       })
       .searchable()
       .nullable(),
+    /**
+     * @since 2.11.2
+     */
     images: model.manyToMany(() => ProductImage, {
       mappedBy: "variants",
       pivotEntity: () => ProductVariantProductImage,