feat(media): support sku/code and attribute fields in media uploads

Author: navneetkumar-pim-webkul

src/Api/MediaFileApi.php

@@ -7,22 +7,38 @@
 class MediaFileApi extends AbstractApi
 {
     /**
-     * Upload a product media file and return the server response.
+     * Upload a product media file alongside the required UnoPim form fields.
      *
+     * @param string $filePath
+     * @param string $sku
+     * @param string $attribute
      * @return array<string, mixed>
      */
-    public function uploadProductMedia(string $filePath): array
+    public function uploadProductMedia(string $filePath, string $sku = '', string $attribute = ''): array
     {
-        return $this->client->uploadFile('/api/v1/rest/media-files/product', $filePath);
+        $fields = array_filter([
+            'sku'       => $sku,
+            'attribute' => $attribute,
+        ], static fn ($v) => $v !== '');
+
+        return $this->client->uploadFile('/api/v1/rest/media-files/product', $filePath, $fields);
     }
 
     /**
-     * Upload a category media file and return the server response.
+     * Upload a category media file alongside the required UnoPim form fields.
      *
+     * @param string $filePath
+     * @param string $code
+     * @param string $attribute
      * @return array<string, mixed>
      */
-    public function uploadCategoryMedia(string $filePath): array
+    public function uploadCategoryMedia(string $filePath, string $code = '', string $attribute = ''): array
     {
-        return $this->client->uploadFile('/api/v1/rest/media-files/category', $filePath);
+        $fields = array_filter([
+            'code'      => $code,
+            'attribute' => $attribute,
+        ], static fn ($v) => $v !== '');
+
+        return $this->client->uploadFile('/api/v1/rest/media-files/category', $filePath, $fields);
     }
 }

src/UnoPimClient.php

@@ -332,9 +332,12 @@ public function getBaseUrl(): string
      * directly to cURL's native CURLFile support, which is the most reliable
      * approach for binary uploads.
      *
+     * @param string $endpoint
+     * @param string $filePath
+     * @param array $fields
      * @return array<string, mixed>
      */
-    public function uploadFile(string $endpoint, string $filePath): array
+    public function uploadFile(string $endpoint, string $filePath, array $fields = []): array
     {
         if (! file_exists($filePath)) {
             throw new \InvalidArgumentException("File not found: {$filePath}");
@@ -343,12 +346,15 @@ public function uploadFile(string $endpoint, string $filePath): array
         $token = $this->getAccessToken();
         $url   = $this->baseUrl . $endpoint;
 
+        $postFields         = $fields;
+        $postFields['file'] = new \CURLFile($filePath);
+
         $ch = curl_init();
         curl_setopt_array($ch, [
             CURLOPT_URL            => $url,
             CURLOPT_RETURNTRANSFER => true,
             CURLOPT_POST           => true,
-            CURLOPT_POSTFIELDS     => ['file' => new \CURLFile($filePath)],
+            CURLOPT_POSTFIELDS     => $postFields,
             CURLOPT_HTTPHEADER     => [
                 'Accept: application/json',
                 'Authorization: Bearer ' . $token,