When the Assets sessions expires in AssetsClient::downloadFileToPath(), re-authenticate instead of throwing an exception.

Author: tistre

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Change Log
 
+## 9.3.0 - 2025-08-18
+
+When the Assets sessions expires in AssetsClient::downloadFileToPath(), re-authenticate instead of 
+throwing an exception. 
+
 ## 9.2.0 - 2025-08-13
 
 Update to PHPUnit 12 and php-timer 8.

src/AssetsClient.php

@@ -238,14 +238,16 @@ public function serviceRequest(
                     return $this->serviceRequest($method, $service, $data, $multipart);
                 default:
                     // something went wrong
-                    $this->logger->error(sprintf(
-                        '%s: %s request to <%s> failed: <%d> "%s"',
-                        __METHOD__,
-                        $method,
-                        $url,
-                        $e->getCode(),
-                        $e->getMessage()
-                    ));
+                    $this->logger->error(
+                        sprintf(
+                            '%s: %s request to <%s> failed: <%d> "%s"',
+                            __METHOD__,
+                            $method,
+                            $url,
+                            $e->getCode(),
+                            $e->getMessage()
+                        )
+                    );
                     throw $e;
             }
         }
@@ -293,14 +295,16 @@ public function apiRequest(string $method, string $urlPath, array $data = []): a
                     return $this->apiRequest($method, $urlPath, $data);
                 default:
                     // something went wrong
-                    $this->logger->error(sprintf(
-                        '%s: %s request to <%s> failed: <%d> "%s"',
-                        __METHOD__,
-                        $method,
-                        $url,
-                        $e->getCode(),
-                        $e->getMessage()
-                    ));
+                    $this->logger->error(
+                        sprintf(
+                            '%s: %s request to <%s> failed: <%d> "%s"',
+                            __METHOD__,
+                            $method,
+                            $url,
+                            $e->getCode(),
+                            $e->getMessage()
+                        )
+                    );
                     throw $e;
             }
         }
@@ -625,7 +629,36 @@ public function logout(bool $cleanUpToken = true): LogoutResponse
      */
     public function downloadFileToPath(string $url, string $targetPath): void
     {
-        $httpResponse = $this->request('GET', $url, ['forceDownload' => 'true'], false);
+        try {
+            $httpResponse = $this->request('GET', $url, ['forceDownload' => 'true'], false);
+        } catch (GuzzleException $e) {
+            switch ($e->getCode()) {
+                case 401: // Unauthorized
+                    // TODO: prevent a possible loop here?
+
+                    // re-login
+                    if (!$this->reLogin()) {
+                        throw $e;
+                    }
+
+                    // try again
+                    $this->downloadFileToPath($url, $targetPath);
+                    return;
+                default:
+                    // something went wrong
+                    $this->logger->error(
+                        sprintf(
+                            '%s: GET request to <%s> failed: <%d> "%s"',
+                            __METHOD__,
+                            $url,
+                            $e->getCode(),
+                            $e->getMessage()
+                        )
+                    );
+                    throw $e;
+            }
+        }
+
         $this->writeResponseBodyToPath($httpResponse, $targetPath);
     }