chore: throw custom notfound exception

Author: ChiragAgg5k

src/Storage/Device/Local.php

@@ -4,6 +4,7 @@
 
 use Exception;
 use Utopia\Storage\Device;
+use Utopia\Storage\Exception\NotFoundException;
 use Utopia\Storage\Storage;
 
 class Local extends Device
@@ -272,7 +273,7 @@ public function abort(string $path, string $extra = ''): bool
     public function read(string $path, int $offset = 0, int $length = null): string
     {
         if (! $this->exists($path)) {
-            throw new Exception('File Not Found');
+            throw new NotFoundException('File not found');
         }
 
         return \file_get_contents($path, use_include_path: false, context: null, offset: $offset, length: $length);

src/Storage/Device/S3.php

@@ -4,6 +4,7 @@
 
 use Exception;
 use Utopia\Storage\Device;
+use Utopia\Storage\Exception\NotFoundException;
 use Utopia\Storage\Storage;
 
 class S3 extends Device
@@ -284,7 +285,7 @@ public function transfer(string $path, string $destination, Device $device): boo
         try {
             $response = $this->getInfo($path);
         } catch (\Throwable $e) {
-            throw new Exception('File not found');
+            throw new NotFoundException('File not found');
         }
         $size = (int) ($response['content-length'] ?? 0);
         $contentType = $response['content-type'] ?? '';
@@ -903,7 +904,7 @@ protected function call(string $operation, string $method, string $uri, string $
             }
 
             if ($response->code >= 400) {
-                throw new Exception($response->body, $response->code);
+                $this->parseAndThrowS3Error($response->body, $response->code);
             }
 
             // Parse body into XML
@@ -927,6 +928,35 @@ protected function call(string $operation, string $method, string $uri, string $
         }
     }
 
+    /**
+     * Parse S3 XML error response and throw appropriate exception
+     *
+     * @param string $errorBody The error response body
+     * @param int $statusCode The HTTP status code
+     * @throws NotFoundException When the error is NoSuchKey
+     * @throws Exception For other S3 errors
+     */
+    private function parseAndThrowS3Error(string $errorBody, int $statusCode): void
+    {
+        if (str_starts_with($errorBody, '<?xml')) {
+            try {
+                $xml = \simplexml_load_string($errorBody);
+                $errorCode = (string) ($xml->Code ?? '');
+                $errorMessage = (string) ($xml->Message ?? '');
+
+                if ($errorCode === 'NoSuchKey') {
+                    throw new NotFoundException($errorMessage ?: 'File not found', $statusCode);
+                }
+            } catch (NotFoundException $e) {
+                throw $e;
+            } catch (\Throwable $e) {
+                // If XML parsing fails, fall through to original error
+            }
+        }
+
+        throw new Exception($errorBody, $statusCode);
+    }
+
     /**
      * Sort compare for meta headers
      *

src/Storage/Exception/NotFoundException.php

@@ -0,0 +1,9 @@
+<?php
+
+namespace Utopia\Storage\Exception;
+
+use Exception;
+
+class NotFoundException extends Exception
+{
+}