docs: add TSDocs for 67499a8 (#15081)

Co-authored-by: shahednasser <[email protected]>

Author: shahednasser

packages/core/core-flows/src/product/helpers/normalize-for-import.ts

@@ -2,7 +2,29 @@ import type { ProductTypes } from "@medusajs/framework/types"
 import type { HttpTypes, RegionTypes } from "@medusajs/framework/types"
 import { MedusaError, lowerCaseFirst, normalizeCurrencyCode } from "@medusajs/framework/utils"
 
-// We want to convert the csv data format to a standard DTO format.
+/**
+ * Normalizes raw CSV product data into standardized AdminCreateProduct DTOs.
+ * 
+ * This function converts product data from CSV import format to the standard DTO format
+ * expected by the product creation API. It handles product grouping by handle,
+ * variant aggregation, option extraction, and validation against existing regions and tags.
+ * 
+ * @param rawProducts - Array of raw product objects from CSV import
+ * @param additional - Additional context data needed for normalization
+ * @param additional.regions - Available regions for price validation
+ * @param additional.tags - Available product tags for validation
+ * @returns Array of normalized AdminCreateProduct DTOs ready for import
+ * 
+ * @throws {MedusaError} When referenced tags or regions are not found
+ * 
+ * @example
+ * ```typescript
+ * const products = normalizeForImport(csvData, {
+ *   regions: existingRegions,
+ *   tags: existingTags
+ * })
+ * ```
+ */
 export const normalizeForImport = (
   rawProducts: object[],
   additional: {