add batch api v2 register batch file

Author: vsolovei-smartling

src/Batch/BatchApiV2.php

@@ -14,6 +14,7 @@ class BatchApiV2 extends BaseApiAbstract
     public const ENDPOINT_URL = 'https://api.smartling.com/job-batches-api/v2/projects';
 
     private const ACTION_CANCEL_FILE = 'CANCEL_FILE';
+    private const ACTION_REGISTER_FILE = 'REGISTER_FILE';
 
     public function __construct(
         AuthApiInterface $authProvider,
@@ -87,4 +88,22 @@ function array_is_list(array $array): bool
             self::HTTP_METHOD_POST,
         )['batchUid'];
     }
+
+    /**
+     * @throws SmartlingApiException
+     */
+    public function registerBatchFile(string $batchUid, string $fileUri): void
+    {
+        if ($batchUid === '') {
+            throw new \UnexpectedValueException('BatchUid cannot be empty.');
+        }
+        $this->sendRequest(
+            "batches/$batchUid",
+            $this->getDefaultRequestData('json', [
+                'action' => self::ACTION_REGISTER_FILE,
+                'fileUri' => $fileUri,
+            ]),
+            self::HTTP_METHOD_PUT,
+        );
+    }
 }

tests/unit/BatchApiV2Test.php

@@ -94,4 +94,42 @@ public function testBatchNotCreatedFileUrisNotList()
             1 => 'fileUri',
         ]);
     }
+
+    public function testRegisterBatchFile()
+    {
+        $batchUid = 'test_batch_uid';
+        $fileUri = '/test/file.xml';
+
+        $this->client
+            ->expects($this->once())
+            ->method('request')
+            ->with('put', BatchApiV2::ENDPOINT_URL . "/$this->projectId/batches/$batchUid", [
+                'headers' => [
+                    'Accept' => 'application/json',
+                    'Authorization' => \vsprintf('%s %s', [
+                        $this->authProvider->getTokenType(),
+                        $this->authProvider->getAccessToken(),
+                    ]),
+                ],
+                'exceptions' => false,
+                'json' => [
+                    'action' => 'REGISTER_FILE',
+                    'fileUri' => $fileUri,
+                ],
+            ])
+            ->willReturn($this->responseMock);
+
+        $this->throwPreviousException(function () use ($batchUid, $fileUri) {
+            (new BatchApiV2($this->authProvider, $this->projectId, null, $this->client))
+                ->registerBatchFile($batchUid, $fileUri);
+        });
+    }
+
+    public function testRegisterBatchFileEmptyBatchUid()
+    {
+        $this->expectException(\UnexpectedValueException::class);
+        $this->expectExceptionMessage('BatchUid cannot be empty.');
+        (new BatchApiV2($this->authProvider, $this->projectId, null, $this->client))
+            ->registerBatchFile('', '/test/file.xml');
+    }
 }