From e43ec501995a1ef9272a0535655256f7ed98f50f Mon Sep 17 00:00:00 2001
From: Andres Campanario <andres.campanario@cakedc.com>
Date: Thu, 12 Mar 2026 11:25:40 +0100
Subject: [PATCH] #add-list-functions add listFiles and listFilesWithUrls to
 S3Trait

---
 src/Util/S3Trait.php | 67 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)

diff --git a/src/Util/S3Trait.php b/src/Util/S3Trait.php
index 4f17036..4e9904e 100644
--- a/src/Util/S3Trait.php
+++ b/src/Util/S3Trait.php
@@ -238,4 +238,71 @@ public function setPublicPermissions(string $key): void
             'ACL'    => 'public-read',
         ]);
     }
+
+    /**
+     * List files in the S3 bucket and generate a presigned URL for each one.
+     *
+     * @param string $prefix Optional folder path or prefix to filter files.
+     * @param int $maxKeys Optional maximum number of files to return (default 1000).
+     * @return array List of objects including 'Key', 'Size', and 'presigned_url'.
+     */
+    public function listFilesWithUrls(string $prefix = '', int $maxKeys = 1000): array
+    {
+        $s3Client = new \Aws\S3\S3Client(Configure::read('Uppy.S3.config'));
+
+        $options = [
+            'Bucket' => Configure::read('Uppy.S3.bucket'),
+            'MaxKeys' => $maxKeys,
+        ];
+
+        if (!empty($prefix)) {
+            $options['Prefix'] = $prefix;
+        }
+
+        try {
+            $result = $s3Client->listObjectsV2($options);
+            $objects = $result->get('Contents') ?? [];
+
+            return array_map(function ($object) {
+                $object['presigned_url'] = $this->presignedUrl(
+                    $object['Key'],
+                    basename($object['Key'])
+                );
+
+                return $object;
+            }, $objects);
+
+        } catch (\Aws\Exception\AwsException $e) {
+            throw new \Exception('Error listing files with URLs from S3: ' . $e->getMessage());
+        }
+    }
+
+    /**
+     * List files in the S3 bucket, optionally filtered by a prefix (folder).
+     *
+     * @param string $prefix Optional folder path or prefix to filter files.
+     * @param int $maxKeys Optional maximum number of files to return (default 1000).
+     * @return array List of objects containing 'Key', 'LastModified', 'Size', etc.
+     */
+    public function listFiles(string $prefix = '', int $maxKeys = 1000): array
+    {
+        $s3Client = new \Aws\S3\S3Client(Configure::read('Uppy.S3.config'));
+
+        $options = [
+            'Bucket' => Configure::read('Uppy.S3.bucket'),
+            'MaxKeys' => $maxKeys,
+        ];
+
+        if (!empty($prefix)) {
+            $options['Prefix'] = $prefix;
+        }
+
+        try {
+            $result = $s3Client->listObjectsV2($options);
+
+            return $result->get('Contents') ?? [];
+        } catch (\Aws\Exception\AwsException $e) {
+            throw new \Exception('Error listing files from S3: ' . $e->getMessage());
+        }
+    }
 }