chore: update download apis to use path

packages/amplify_core/lib/src/category/amplify_storage_category.dart

@@ -91,43 +91,43 @@ class StorageCategory extends AmplifyCategory<StoragePluginInterface> {
   }
 
   /// {@template amplify_core.amplify_storage_category.download_data}
-  /// Downloads bytes of object specified by [key] into memory with optional
+  /// Downloads bytes of object specified by [path] into memory with optional
   /// [onProgress] and [StorageDownloadDataOptions], and returns a
   /// [StorageDownloadDataOperation].
   ///
   /// Ensure you are managing the data in memory properly to avoid unexpected
   /// memory leaks.
   /// {@endtemplate}
   StorageDownloadDataOperation downloadData({
-    required String key,
+    required StoragePath path,
     void Function(StorageTransferProgress)? onProgress,
     StorageDownloadDataOptions? options,
   }) {
     return identifyCall(
       StorageCategoryMethod.downloadData,
       () => defaultPlugin.downloadData(
-        key: key,
+        path: path,
         onProgress: onProgress,
         options: options,
       ),
     );
   }
 
   /// {@template amplify_core.amplify_storage_category.download_file}
-  /// Downloads the object specified by [key] to [localFile] with optional
+  /// Downloads the object specified by [path] to [localFile] with optional
   /// [onProgress] and [StorageDownloadFileOptions], and returns a
   /// [StorageDownloadFileOperation].
   /// {@endtemplate}
   StorageDownloadFileOperation downloadFile({
-    required String key,
+    required StoragePath path,
     required AWSFile localFile,
     void Function(StorageTransferProgress)? onProgress,
     StorageDownloadFileOptions? options,
   }) {
     return identifyCall(
       StorageCategoryMethod.downloadFile,
       () => defaultPlugin.downloadFile(
-        key: key,
+        path: path,
         localFile: localFile,
         onProgress: onProgress,
         options: options,

packages/amplify_core/lib/src/plugin/amplify_storage_plugin_interface.dart

@@ -40,7 +40,7 @@ abstract class StoragePluginInterface extends AmplifyPluginInterface {
 
   /// {@macro amplify_core.amplify_storage_category.download_data}
   StorageDownloadDataOperation downloadData({
-    required String key,
+    required StoragePath path,
     void Function(StorageTransferProgress)? onProgress,
     StorageDownloadDataOptions? options,
   }) {
@@ -49,7 +49,7 @@ abstract class StoragePluginInterface extends AmplifyPluginInterface {
 
   /// {@macro amplify_core.amplify_storage_category.download_file}
   StorageDownloadFileOperation downloadFile({
-    required String key,
+    required StoragePath path,
     required AWSFile localFile,
     void Function(StorageTransferProgress)? onProgress,
     StorageDownloadFileOptions? options,

packages/amplify_core/lib/src/types/storage/download_data_request.dart

@@ -9,12 +9,12 @@ import 'package:amplify_core/amplify_core.dart';
 class StorageDownloadDataRequest {
   /// {@macro amplify_core.storage.download_data_request}
   const StorageDownloadDataRequest({
-    required this.key,
+    required this.path,
     this.options,
   });
 
-  /// Key of the object to download.
-  final String key;
+  /// Path of the object to download.
+  final StoragePath path;
 
   /// Configurable options of the [StorageDownloadDataRequest].
   final StorageDownloadDataOptions? options;

packages/amplify_core/lib/src/types/storage/download_file_options.dart

@@ -14,22 +14,20 @@ class StorageDownloadFileOptions extends StorageOperationOptions
         AWSDebuggable {
   /// {@macro amplify_core.storage.download_file_options}
   const StorageDownloadFileOptions({
-    super.accessLevel,
     this.pluginOptions,
   });
 
   /// {@macro amplify_core.storage.download_file_plugin_options}
   final StorageDownloadFilePluginOptions? pluginOptions;
 
   @override
-  List<Object?> get props => [accessLevel, pluginOptions];
+  List<Object?> get props => [pluginOptions];
 
   @override
   String get runtimeTypeName => 'StorageDownloadFileOptions';
 
   @override
   Map<String, Object?> toJson() => {
-        'accessLevel': accessLevel?.name,
         'pluginOptions': pluginOptions?.toJson(),
       };
 }

packages/amplify_core/lib/src/types/storage/download_file_request.dart

@@ -9,13 +9,13 @@ import 'package:amplify_core/amplify_core.dart';
 class StorageDownloadFileRequest {
   /// {@macro amplify_core.storage.download_file_request}
   const StorageDownloadFileRequest({
-    required this.key,
+    required this.path,
     required this.localFile,
     this.options,
   });
 
-  /// Key of the object to download.
-  final String key;
+  /// Path of the object to download.
+  final StoragePath path;
 
   /// Reference to the local file that download the object to.
   final AWSFile localFile;

packages/storage/amplify_storage_s3/example/integration_test/transfer_acceleration/transfer_acceleration.dart

@@ -72,10 +72,11 @@ void testTransferAcceleration({
             test('S3DataPayload ${entry.key}', () async {
               final dataPayload = entry.value;
               final result = await Amplify.Storage.downloadData(
-                key: dataPayload.targetKey,
-                options: StorageDownloadDataOptions(
-                  accessLevel: dataPayload.targetAccessLevel,
-                  pluginOptions: const S3DownloadDataPluginOptions(
+                path: StoragePath.fromString(
+                  '/${dataPayload.targetAccessLevel}/${dataPayload.targetKey}',
+                ),
+                options: const StorageDownloadDataOptions(
+                  pluginOptions: S3DownloadDataPluginOptions(
                     useAccelerateEndpoint: true,
                   ),
                 ),
@@ -156,9 +157,10 @@ void testTransferAcceleration({
               const end = 5 * 1024 + 12;
               final awsFile = entry.value;
               final result = await Amplify.Storage.downloadData(
-                key: awsFile.targetKey,
+                path: StoragePath.fromString(
+                  '${awsFile.targetAccessLevel}/${awsFile.targetKey}',
+                ),
                 options: StorageDownloadDataOptions(
-                  accessLevel: awsFile.targetAccessLevel,
                   pluginOptions: S3DownloadDataPluginOptions(
                     useAccelerateEndpoint: true,
                     bytesRange: S3DataBytesRange(start: start, end: end),

packages/storage/amplify_storage_s3/example/integration_test/use_case_test.dart

@@ -64,11 +64,10 @@ void main() {
   const testObjectFileName2 = 'user1Protected.jpg';
   const testObjectFileName3 = 'user1Private.large';
 
-  for (final entry in amplifyEnvironments.entries) {
-    group(
-        // TODO(Jordan-Nelson): enable dots-in-name, remove custom-prefix
-        skip: entry.key != 'main',
-        '[Environment ${entry.key}]', () {
+  // TODO(Jordan-Nelson): enable dots-in-name, remove custom-prefix
+  for (final entry in amplifyEnvironments.entries
+      .where((element) => element.key == 'main')) {
+    group('[Environment ${entry.key}]', () {
       S3PrefixResolver? prefixResolver;
       late String user1IdentityId;
       late String object1Etag;
@@ -320,13 +319,13 @@ void main() {
         });
 
         testWidgets(
-            skip: true,
             'download object as bytes data in memory with access level private'
             ' for the currently signed in user', (WidgetTester tester) async {
           final result = await Amplify.Storage.downloadData(
-            key: testObjectKey3,
+            path: StoragePath.withIdentityId(
+              (identityId) => '/private/$identityId/$testObjectKey3',
+            ),
             options: const StorageDownloadDataOptions(
-              accessLevel: StorageAccessLevel.private,
               pluginOptions: S3DownloadDataPluginOptions(
                 getProperties: true,
               ),
@@ -338,15 +337,15 @@ void main() {
         });
 
         testWidgets(
-            skip: true,
             'download a range of bytes of an object with access level private'
             ' for the currently signed in user', (WidgetTester tester) async {
           const start = 5 * 1024;
           const end = 5 * 1024 + 12;
           final result = await Amplify.Storage.downloadData(
-            key: testObjectKey3,
+            path: StoragePath.withIdentityId(
+              (identityId) => '/private/$identityId/$testObjectKey3',
+            ),
             options: StorageDownloadDataOptions(
-              accessLevel: StorageAccessLevel.private,
               pluginOptions: S3DownloadDataPluginOptions(
                 getProperties: true,
                 bytesRange: S3DataBytesRange(
@@ -366,7 +365,6 @@ void main() {
         });
 
         testWidgets(
-          skip: true,
           'download file with access level private for the currently signed in user',
           (WidgetTester tester) async {
             final s3Plugin =
@@ -377,10 +375,11 @@ void main() {
 
             final result = await s3Plugin
                 .downloadFile(
-                  key: testObjectKey3,
+                  path: StoragePath.withIdentityId(
+                    (identityId) => '/private/$identityId/$testObjectKey3',
+                  ),
                   localFile: localFile,
                   options: const StorageDownloadFileOptions(
-                    accessLevel: StorageAccessLevel.private,
                     pluginOptions: S3DownloadFilePluginOptions(
                       getProperties: true,
                     ),
@@ -396,8 +395,7 @@ void main() {
           },
           // Web download relies on getUrl which has been covered in the getUrl
           // integration test run.
-          // TODO(khatruong2009): Re-enable this test after download apis completed.
-          // skip: zIsWeb,
+          skip: zIsWeb,
         );
 
         testWidgets(
@@ -618,16 +616,15 @@ void main() {
           });
 
           testWidgets(
-              skip: true,
               'download data of object with access level protected and a target'
               ' identity id for the currently signed user',
               (WidgetTester tester) async {
             final result = await Amplify.Storage.downloadData(
-              key: testObjectKey2,
-              options: StorageDownloadDataOptions(
-                accessLevel: StorageAccessLevel.protected,
-                pluginOptions: S3DownloadDataPluginOptions.forIdentity(
-                  user1IdentityId,
+              path: StoragePath.fromString(
+                '/protected/$user1IdentityId/$testObjectKey2',
+              ),
+              options: const StorageDownloadDataOptions(
+                pluginOptions: S3DownloadDataPluginOptions(
                   getProperties: true,
                 ),
               ),
@@ -637,14 +634,14 @@ void main() {
           });
 
           testWidgets(
-              skip: true,
               'download data of object (belongs to other user) with access level'
               ' private for the currently signed user',
               (WidgetTester tester) async {
             final operation = Amplify.Storage.downloadData(
-              key: testObjectKey3,
+              path: StoragePath.withIdentityId(
+                (identityId) => '/private/$identityId/$testObjectKey3',
+              ),
               options: const StorageDownloadDataOptions(
-                accessLevel: StorageAccessLevel.private,
                 pluginOptions: S3DownloadDataPluginOptions(
                   getProperties: true,
                 ),

packages/storage/amplify_storage_s3/example/lib/main.dart

@@ -181,7 +181,7 @@ class _HomeScreenState extends State<HomeScreen> {
     final filepath = '${documentsDir.path}/$key';
     try {
       await Amplify.Storage.downloadFile(
-        key: key,
+        path: StoragePath.fromString(key),
         localFile: AWSFile.fromPath(filepath),
         onProgress: (p0) => _logger
             .debug('Progress: ${(p0.transferredBytes / p0.totalBytes) * 100}%'),
@@ -196,7 +196,7 @@ class _HomeScreenState extends State<HomeScreen> {
   Future<void> downloadFileWeb(String key) async {
     try {
       await Amplify.Storage.downloadFile(
-        key: key,
+        path: StoragePath.fromString(key),
         localFile: AWSFile.fromPath(key),
         onProgress: (p0) => _logger
             .debug('Progress: ${(p0.transferredBytes / p0.totalBytes) * 100}%'),

packages/storage/amplify_storage_s3_dart/example/bin/example.dart

@@ -207,7 +207,7 @@ Future<void> downloadDataOperation() async {
 
   final s3Plugin = Amplify.Storage.getPlugin(AmplifyStorageS3Dart.pluginKey);
   final downloadDataOperation = s3Plugin.downloadData(
-    key: key,
+    path: StoragePath.fromString(key),
     options: StorageDownloadDataOptions(
       accessLevel: accessLevel,
       pluginOptions: const S3DownloadDataPluginOptions(
@@ -239,9 +239,6 @@ Future<void> downloadDataOperation() async {
 
 Future<void> downloadFileOperation() async {
   final key = prompt('Enter the key of the object to download: ');
-  final accessLevel = promptStorageAccessLevel(
-    'Choose the storage access level associated with the object: ',
-  );
   final destinationPath = prompt(
     'Enter the destination file path (ensure the file path is writable): ',
   );
@@ -251,10 +248,9 @@ Future<void> downloadFileOperation() async {
 
   final s3Plugin = Amplify.Storage.getPlugin(AmplifyStorageS3Dart.pluginKey);
   final downloadFileOperation = s3Plugin.downloadFile(
-    key: key,
+    path: StoragePath.fromString(key),
     localFile: localFile,
     options: StorageDownloadFileOptions(
-      accessLevel: accessLevel,
       pluginOptions: S3DownloadFilePluginOptions(
         getProperties: true,
         useAccelerateEndpoint: useAccelerateEndpoint,

packages/storage/amplify_storage_s3_dart/lib/src/amplify_storage_s3_dart_impl.dart

@@ -222,7 +222,7 @@ class AmplifyStorageS3Dart extends StoragePluginInterface
 
   @override
   S3DownloadDataOperation downloadData({
-    required String key,
+    required StoragePath path,
     StorageDownloadDataOptions? options,
     void Function(S3TransferProgress)? onProgress,
   }) {
@@ -232,21 +232,20 @@ class AmplifyStorageS3Dart extends StoragePluginInterface
     );
 
     final s3Options = StorageDownloadDataOptions(
-      accessLevel: options?.accessLevel,
       pluginOptions: s3PluginOptions,
     );
 
     final bytes = BytesBuilder();
     final downloadTask = storageS3Service.downloadData(
-      key: key,
+      path: path,
       options: s3Options,
       onProgress: onProgress,
       onData: bytes.add,
     );
 
     return S3DownloadDataOperation(
       request: StorageDownloadDataRequest(
-        key: key,
+        path: path,
         options: options,
       ),
       result: downloadTask.result.then(
@@ -263,7 +262,7 @@ class AmplifyStorageS3Dart extends StoragePluginInterface
 
   @override
   S3DownloadFileOperation downloadFile({
-    required String key,
+    required StoragePath path,
     required AWSFile localFile,
     void Function(S3TransferProgress)? onProgress,
     StorageDownloadFileOptions? options,
@@ -273,11 +272,10 @@ class AmplifyStorageS3Dart extends StoragePluginInterface
       defaultPluginOptions: const S3DownloadFilePluginOptions(),
     );
     options = StorageDownloadFileOptions(
-      accessLevel: options?.accessLevel,
       pluginOptions: s3PluginOptions,
     );
     return download_file_impl.downloadFile(
-      key: key,
+      path: path,
       localFile: localFile,
       options: options,
       s3pluginConfig: s3pluginConfig,